@agentclientprotocol/claude-agent-acp 0.98.1-preview.3 → 0.98.1-preview.4

package/dist/v2/agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/v2/agent.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,MAAM,mDAAmD,CAAC;AACxE,OAAO,EAAE,cAAc,EAAkB,KAAK,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAoB9E;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,OAAO,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,GACvC,EAAE,CAAC,QAAQ,CAqFb"}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/v2/agent.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,MAAM,mDAAmD,CAAC;AACxE,OAAO,EAAE,cAAc,EAAkB,KAAK,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAqB9E;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,OAAO,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,GACvC,EAAE,CAAC,QAAQ,CA8Fb"}

package/dist/v2/agent.js

@@ -7,6 +7,7 @@ import { v1ForkSessionRequest, v1NewSessionRequest, v1RestoreSessionRequest, v1S
 import { v2ChildStateUpdate, v2SessionUpdate } from "./session-update.js";
 import { V2Terminals } from "./terminal.js";
 import { V2ToolCallMeta } from "./tool-call-meta.js";
+import { v2RestartedToolCall } from "./tool-call.js";
 /**
  * The ACP v2 surface, for one connection.
  *
@@ -81,7 +82,16 @@ export function v2AgentApp(logger, onAgent) {
         .onRequest(v2.methods.agent.session.delete, ({ params }) => agent.deleteSession(params))
         .onRequest(v2.methods.agent.session.setConfigOption, async ({ params }) => {
         const { configOptions, ...response } = await agent.setSessionConfigOption(v1SetSessionConfigOptionRequest(params));
-        return { ...response, configOptions: v2ConfigOptions(configOptions) };
+        // v2 asks for a `config_option_update` on every config change, also one
+        // that a client requested, so other attached clients see it. It goes
+        // before the response, as v2 asks of this duplicate. The agent sends v1
+        // clients none: they read the change from the response only.
+        const options = v2ConfigOptions(configOptions);
+        void client.send({
+            sessionId: params.sessionId,
+            update: { sessionUpdate: "config_option_update", configOptions: options },
+        });
+        return { ...response, configOptions: options };
     })
         .onRequest(v2.methods.agent.session.prompt, ({ params }) => v2Prompt(agent, params, (update) => {
         void client.send({ sessionId: params.sessionId, update });
@@ -239,8 +249,14 @@ class V2ClientConnection {
         if (!report)
             return terminal;
         const starts = report.sessionUpdate === "tool_call";
-        const [reported, metaPatch] = this.toolCallMeta.apply(sessionId, report, starts, this.replays.has(sessionId));
-        const reportUpdate = v2SessionUpdate(reported);
+        const replaying = this.replays.has(sessionId);
+        // A v1 `tool_call` starts the tool call afresh, but v2 only has updates,
+        // which keep each field they leave out. The client may already hold this
+        // id: from an earlier report on this connection, or, during a replay, from
+        // before it (a client that resumes a session it showed before).
+        const restarts = starts && (replaying || this.toolCallMeta.reported(sessionId, report.toolCallId));
+        const [reported, metaPatch] = this.toolCallMeta.apply(sessionId, report, starts, replaying);
+        const reportUpdate = restarts ? v2RestartedToolCall(reported) : v2SessionUpdate(reported);
         const metaUpdate = metaPatch
             ? v2SessionUpdate({ sessionUpdate: "tool_call_update", ...metaPatch })
             : undefined;

package/dist/v2/prompt.d.ts

@@ -45,9 +45,11 @@ export declare function v2Prompt(agent: ClaudeAcpAgent, params: v2.PromptRequest
  */
 export declare function v2Foreground(send: (update: v2.SessionUpdate) => void): ForegroundEvents;
 /**
- * A v2 prompt may hold content blocks that v1 cannot express: a custom one,
- * or one from a newer ACP version. Clients send only the kinds the agent
- * advertised, so such a block is rejected rather than silently dropped.
+ * A v2 prompt may hold content blocks that the agent does not take: audio,
+ * which it does not advertise and Claude cannot read, a custom one, or one
+ * from a newer ACP version. Clients send only the kinds the agent advertised,
+ * so such a block fails the request with invalid params (-32602) rather than
+ * being dropped from the prompt.
  */
 export declare function v1PromptRequest({ prompt, ...request }: v2.PromptRequest): PromptRequest;
 export declare function v1ContentBlock(block: v2.ContentBlock): ContentBlock;

package/dist/v2/prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/v2/prompt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,aAAa,EAEnB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAE,MAAM,mDAAmD,CAAC;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAuC,MAAM,mBAAmB,CAAC;AAE/F;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,EAAE,CAAC,aAAa,EACxB,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,aAAa,KAAK,IAAI,GACvC,OAAO,CAAC,EAAE,CAAC,cAAc,CAAC,CAiC5B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,aAAa,KAAK,IAAI,GAAG,gBAAgB,CAoBvF;AAgCD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,EAAE,EAAE,CAAC,aAAa,GAAG,aAAa,CAEvF;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,GAAG,YAAY,CAenE"}
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/v2/prompt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,aAAa,EAEnB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAE,MAAM,mDAAmD,CAAC;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAuC,MAAM,mBAAmB,CAAC;AAE/F;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,EAAE,CAAC,aAAa,EACxB,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,aAAa,KAAK,IAAI,GACvC,OAAO,CAAC,EAAE,CAAC,cAAc,CAAC,CAiC5B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,aAAa,KAAK,IAAI,GAAG,gBAAgB,CAoBvF;AAgCD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,EAAE,EAAE,CAAC,aAAa,GAAG,aAAa,CAEvF;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,GAAG,YAAY,CAcnE"}

package/dist/v2/prompt.js

@@ -122,9 +122,11 @@ function idle({ stopReason, usage, _meta }) {
     return { sessionUpdate: "state_update", state: "idle", ...state };
 }
 /**
- * A v2 prompt may hold content blocks that v1 cannot express: a custom one,
- * or one from a newer ACP version. Clients send only the kinds the agent
- * advertised, so such a block is rejected rather than silently dropped.
+ * A v2 prompt may hold content blocks that the agent does not take: audio,
+ * which it does not advertise and Claude cannot read, a custom one, or one
+ * from a newer ACP version. Clients send only the kinds the agent advertised,
+ * so such a block fails the request with invalid params (-32602) rather than
+ * being dropped from the prompt.
  */
 export function v1PromptRequest({ prompt, ...request }) {
     return { ...request, prompt: prompt.map(v1ContentBlock) };
@@ -132,7 +134,6 @@ export function v1PromptRequest({ prompt, ...request }) {
 export function v1ContentBlock(block) {
     if (v2.ContentBlock.isText(block) ||
         v2.ContentBlock.isImage(block) ||
-        v2.ContentBlock.isAudio(block) ||
         v2.ContentBlock.isResourceLink(block) ||
         v2.ContentBlock.isResource(block)) {
         const { annotations, ...rest } = block;

package/dist/v2/session.js

@@ -123,8 +123,10 @@ function v2ConfigOptionsField(options) {
 /**
  * v2 requires a `type` on every transport and makes the empty lists optional.
  * The agent recognizes a v1 stdio server by its missing `type`, so the v2 tag
- * is dropped. A transport that v1 cannot express is rejected rather than
- * silently left out of the session.
+ * is dropped. Any other transport, such as `acp` or a custom `_` type, fails
+ * the request with invalid params (-32602): the agent advertises only stdio
+ * and HTTP, and the v1 session setup would otherwise drop the server without
+ * telling the client.
  */
 function v1McpServer(server) {
     if (v2.McpServer.isStdio(server)) {
@@ -134,8 +136,5 @@ function v1McpServer(server) {
     if (v2.McpServer.isHttp(server)) {
         return { ...server, headers: server.headers ?? [] };
     }
-    if (v2.McpServer.isAcp(server)) {
-        return server;
-    }
     throw RequestError.invalidParams({ type: server.type }, `MCP servers of type ${server.type} are not supported`);
 }

package/dist/v2/tool-call-meta.d.ts

@@ -45,6 +45,8 @@ export declare class V2ToolCallMeta {
      * a client can show the request from the request alone.
      */
     subject<Report extends ToolCall | ToolCallUpdate>(sessionId: string, toolCall: Report): Report;
+    /** Whether this connection reported the tool call, so the client holds it. */
+    reported(sessionId: string, toolCallId: string): boolean;
     /** Forgets the tool calls of a session, when it closes. */
     forget(sessionId: string): void;
     /** Stores the entry as the most recent one, and forgets the oldest one past the limit. */

package/dist/v2/tool-call-meta.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-call-meta.d.ts","sourceRoot":"","sources":["../../src/v2/tool-call-meta.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAOlF,qBAAa,cAAc;IACzB,oFAAoF;IACpF,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqD;IAE3E;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,MAAM,SAAS,QAAQ,GAAG,cAAc,EAC5C,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,OAAO,EACf,SAAS,UAAQ,GAChB,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC;IA6CtC;;;;OAIG;IACH,OAAO,CAAC,MAAM,SAAS,QAAQ,GAAG,cAAc,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAO9F,2DAA2D;IAC3D,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAM/B,0FAA0F;IAC1F,OAAO,CAAC,QAAQ;CAQjB"}
+{"version":3,"file":"tool-call-meta.d.ts","sourceRoot":"","sources":["../../src/v2/tool-call-meta.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAOlF,qBAAa,cAAc;IACzB,oFAAoF;IACpF,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqD;IAE3E;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,MAAM,SAAS,QAAQ,GAAG,cAAc,EAC5C,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,OAAO,EACf,SAAS,UAAQ,GAChB,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC;IA6CtC;;;;OAIG;IACH,OAAO,CAAC,MAAM,SAAS,QAAQ,GAAG,cAAc,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAO9F,8EAA8E;IAC9E,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO;IAIxD,2DAA2D;IAC3D,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAM/B,0FAA0F;IAC1F,OAAO,CAAC,QAAQ;CAQjB"}

package/dist/v2/tool-call-meta.js

@@ -77,6 +77,10 @@ export class V2ToolCallMeta {
             result._meta = { ...result._meta, ...stored };
         return result;
     }
+    /** Whether this connection reported the tool call, so the client holds it. */
+    reported(sessionId, toolCallId) {
+        return this.calls.has(`${sessionId} ${toolCallId}`);
+    }
     /** Forgets the tool calls of a session, when it closes. */
     forget(sessionId) {
         for (const key of this.calls.keys()) {

package/dist/v2/tool-call.d.ts

@@ -29,6 +29,17 @@ type V2ToolCallUpdate = v2.ToolCallUpdate & {
  * (see `terminal.ts`).
  */
 export declare function v2ToolCallUpdate(report: V1ToolCallReport): V2ToolCallUpdate;
+/**
+ * The v2 form of a v1 `tool_call`, for a client that may already hold a tool
+ * call with the same id. Each field that the `tool_call` leaves out is `null`,
+ * so the client resets it to its default instead of keeping the old value. For
+ * example, a replayed Bash call that the client holds with the `rawOutput` of
+ * the live run gets `rawOutput: null`, which removes it.
+ *
+ * `V2ToolCallMeta` decides what `_meta` clears. Its `_meta: null` is a v2
+ * clear, so it stays, where {@link v2ToolCallUpdate} drops a v1 `null`.
+ */
+export declare function v2RestartedToolCall(report: V1ToolCallReport): V2ToolCallUpdate;
 /**
  * The v2 form of the fields of a v1 tool call report, which a session update
  * and the subject of a permission request carry. See {@link v2ToolCallUpdate}.

package/dist/v2/tool-call.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-call.d.ts","sourceRoot":"","sources":["../../src/v2/tool-call.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAmB,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACnG,OAAO,KAAK,KAAK,EAAE,MAAM,mDAAmD,CAAC;AAE7E,KAAK,gBAAgB,GACjB,CAAC,QAAQ,GAAG;IAAE,aAAa,EAAE,WAAW,CAAA;CAAE,CAAC,GAC3C,CAAC,cAAc,GAAG;IAAE,aAAa,EAAE,kBAAkB,CAAA;CAAE,CAAC,CAAC;AAE7D,KAAK,gBAAgB,GAAG,EAAE,CAAC,cAAc,GAAG;IAAE,aAAa,EAAE,kBAAkB,CAAA;CAAE,CAAC;AAElF;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,gBAAgB,CAE3E;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,QAAQ,GAAG,cAAc,GAAG,EAAE,CAAC,cAAc,CAUtF"}
+{"version":3,"file":"tool-call.d.ts","sourceRoot":"","sources":["../../src/v2/tool-call.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAmB,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACnG,OAAO,KAAK,KAAK,EAAE,MAAM,mDAAmD,CAAC;AAE7E,KAAK,gBAAgB,GACjB,CAAC,QAAQ,GAAG;IAAE,aAAa,EAAE,WAAW,CAAA;CAAE,CAAC,GAC3C,CAAC,cAAc,GAAG;IAAE,aAAa,EAAE,kBAAkB,CAAA;CAAE,CAAC,CAAC;AAE7D,KAAK,gBAAgB,GAAG,EAAE,CAAC,cAAc,GAAG;IAAE,aAAa,EAAE,kBAAkB,CAAA;CAAE,CAAC;AAElF;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,gBAAgB,CAE3E;AAcD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,GAAG,gBAAgB,CAM9E;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,QAAQ,GAAG,cAAc,GAAG,EAAE,CAAC,cAAc,CAUtF"}

package/dist/v2/tool-call.js

@@ -17,6 +17,32 @@
 export function v2ToolCallUpdate(report) {
     return { ...v2ToolCallPatch(report), sessionUpdate: "tool_call_update" };
 }
+/** The fields of a v2 tool call besides `toolCallId` and `_meta`. */
+const TOOL_CALL_FIELDS = [
+    "name",
+    "title",
+    "kind",
+    "status",
+    "content",
+    "locations",
+    "rawInput",
+    "rawOutput",
+];
+/**
+ * The v2 form of a v1 `tool_call`, for a client that may already hold a tool
+ * call with the same id. Each field that the `tool_call` leaves out is `null`,
+ * so the client resets it to its default instead of keeping the old value. For
+ * example, a replayed Bash call that the client holds with the `rawOutput` of
+ * the live run gets `rawOutput: null`, which removes it.
+ *
+ * `V2ToolCallMeta` decides what `_meta` clears. Its `_meta: null` is a v2
+ * clear, so it stays, where {@link v2ToolCallUpdate} drops a v1 `null`.
+ */
+export function v2RestartedToolCall(report) {
+    const update = v2ToolCallUpdate(report);
+    const reset = Object.fromEntries(TOOL_CALL_FIELDS.filter((field) => !(field in update)).map((field) => [field, null]));
+    return { ...reset, ...update, ...(report._meta === null ? { _meta: null } : {}) };
+}
 /**
  * The v2 form of the fields of a v1 tool call report, which a session update
  * and the subject of a permission request carry. See {@link v2ToolCallUpdate}.

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.98.1-preview.3",
+  "version": "0.98.1-preview.4",
   "description": "An ACP-compatible coding agent powered by the Claude Agent SDK (TypeScript)",
   "main": "dist/lib.js",
   "types": "dist/lib.d.ts",