@barry-rocks/sdk/acp
Barry’s side of the Agent Client Protocol (ACP): acpHosted and the types
for serving a session to an editor that speaks ACP. The
<identity> acp command uses it.
import { … } from "@barry-rocks/sdk/acp";Interfaces
Section titled “Interfaces”AcpHarness
Section titled “AcpHarness”Extends
Section titled “Extends”Properties
Section titled “Properties”| Property | Type | Description | Inherited from |
|---|---|---|---|
approvalContinuation? |
ApprovalContinuation |
Conversation resume alone never establishes approval continuation. | Mode.approvalContinuation |
attachesTo? |
"hosted" |
Set on a launch mode whose TUI renders the hosted session rather than running its own: it attaches to the engine Barry already holds, so it may declare guarantees up to the hosted mode’s. | Mode.attachesTo |
authMethod? |
string |
An auth method id to use, when the harness advertises it. | - |
build? |
"binary" | "bundled" |
What this mode runs: the binary requirements.binary names (the default), or a build the adapter carries itself, such as an SDK’s bundled CLI or a library run in-process. The binary on PATH says nothing about a bundled build, so a launch checks its version only for binary. |
Mode.build |
egressSandbox |
boolean |
Whether Barry’s egress proxy holds in this mode. | Mode.egressSandbox |
evidence |
object |
The runnable check that showed them — a claim with no check is not declared. | Mode.evidence |
evidence.check |
string |
- | - |
evidence.proves |
string |
- | - |
guarantees |
Guarantees |
- | Mode.guarantees |
identifyTool? |
(call) => AcpToolIdentity | undefined |
How the harness’s tool calls are named in Barry’s policy. | - |
native? |
NativeControl |
- | Mode.native |
platforms? |
Platform[] |
Where they were shown. Other platforms are unverified, not broken. | Mode.platforms |
structuredOutput |
"native" | "prompted" |
- | - |
verifiedOn |
string |
The harness build these guarantees were shown on. A session that observes another build records its guarantees as unverified rather than as fact. | Mode.verifiedOn |
Methods
Section titled “Methods”command()
Section titled “command()”command(
config):Command
How to start the harness speaking ACP on stdio.
Parameters
Section titled “Parameters”| Parameter | Type |
|---|---|
config |
SessionConfig |
Returns
Section titled “Returns”AcpToolCall
Section titled “AcpToolCall”What a harness has said about one tool call so far, across its updates.
Properties
Section titled “Properties”| Property | Type |
|---|---|
kind? |
string | null |
rawInput? |
unknown |
title? |
string | null |
toolCallId? |
string |
AcpToolIdentity
Section titled “AcpToolIdentity”A tool call as Barry’s policy knows it. Harnesses title calls for display, and a title is not a name a denial list or a server scope can match.
Properties
Section titled “Properties”| Property | Type |
|---|---|
input |
unknown |
name |
string |
Functions
Section titled “Functions”acpHosted()
Section titled “acpHosted()”acpHosted(
harness):SessionMode
Parameters
Section titled “Parameters”| Parameter | Type |
|---|---|
harness |
AcpHarness |