@agentclientprotocol/claude-agent-acp 0.94.1-preview.8 → 0.95.0

package/dist/subagent-replay.js

@@ -1,4 +1,4 @@
-import { isNativeSubagentControlTool, nativeSubagentState, rfdEndState, rfdLabels, } from "./native-subagents.js";
+import { HANDBACK_TOOL, handbackMessage, isNativeSubagentControlTool, launchReply, linkedSessionMessages, nativeSubagentState, rfdEndState, rfdLabels, } from "./native-subagents.js";
 import { noticeUpdate } from "./session-notices.js";
 export class RfdSubagentReplay {
     history;
@@ -11,6 +11,8 @@ export class RfdSubagentReplay {
     omitted = new Set();
     /** Children whose transcript could not be read: only their association is replayed. */
     withoutHistory = 0;
+    /** The SubagentHandback calls, with their report and whether their result failed. */
+    handbacks = new Map();
     constructor(history, publish) {
         this.history = history;
         this.publish = publish;
@@ -26,6 +28,11 @@ export class RfdSubagentReplay {
                     if (isNativeSubagentControlTool(block.name)) {
                         this.registerLaunch(block.id, inputOf(block), ownerSessionId);
                     }
+                    else if (block.name === HANDBACK_TOOL) {
+                        const message = handbackMessage(block.input);
+                        if (message)
+                            this.handbacks.set(block.id, { message, failed: false, sent: false });
+                    }
                     else if (block.name === "SendMessage") {
                         const input = inputOf(block);
                         if (typeof input.to === "string" && typeof input.message === "string") {
@@ -40,6 +47,9 @@ export class RfdSubagentReplay {
                     }
                 }
                 else if (block.type === "tool_result" && typeof block.tool_use_id === "string") {
+                    const handback = this.handbacks.get(block.tool_use_id);
+                    if (handback && block.is_error === true)
+                        handback.failed = true;
                     const child = this.children.get(block.tool_use_id);
                     // A background launch answers at once; its result is not the end.
                     if (child && !child.record.background) {
@@ -106,6 +116,42 @@ export class RfdSubagentReplay {
             await this.sendPrompt(child, child.input.prompt);
         }
     }
+    /**
+     * Takes a replayed update of a tool call, from the transcript of `owner`
+     * when it is a child's. Returns whether the client is not shown it: an
+     * update of the launch of a child that the replay shows, or of a successful
+     * SubagentHandback call of `owner`. A foreground launch's completed result
+     * goes out as the child's reply, and a hand-back as the child's message to
+     * its parent.
+     */
+    async toolCallUpdate(update, owner) {
+        if (update.sessionUpdate !== "tool_call" && update.sessionUpdate !== "tool_call_update") {
+            return false;
+        }
+        const handback = owner ? this.handbacks.get(update.toolCallId) : undefined;
+        if (owner && handback && !handback.failed) {
+            if (!handback.sent) {
+                handback.sent = true;
+                owner.handedBack = true;
+                for (const view of linkedSessionMessages(update.toolCallId, owner.sessionId, owner.parentSessionId, handback.message)) {
+                    await this.publish(view);
+                }
+            }
+            return true;
+        }
+        const child = this.children.get(update.toolCallId);
+        if (!child)
+            return false;
+        if (update.status === "completed" &&
+            child.announced &&
+            !child.record.background &&
+            !child.handedBack) {
+            const reply = launchReply(child.launchId, child.sessionId, child.parentSessionId, update);
+            if (reply)
+                await this.publish(reply);
+        }
+        return true;
+    }
     /**
      * Takes a persisted task notification. Returns whether it was a child's:
      * its task id is the agent id.
@@ -168,10 +214,12 @@ export class RfdSubagentReplay {
         this.children.set(toolUseId, child);
         this.byAgentId.set(record.agentId, child);
     }
-    /** The prompt of the launch, with the launch's id, as live. */
+    /** The prompt of the launch, with the launch's id, to the parent and the child, as live. */
     async sendPrompt(child, text) {
         child.promptSent = true;
-        await this.sendMessage(child, child.launchId, text, child.parentSessionId);
+        for (const view of linkedSessionMessages(child.launchId, child.parentSessionId, child.sessionId, text)) {
+            await this.publish(view);
+        }
     }
     /**
      * A message that a SendMessage call delivered. Claude Code frames it for the

package/dist/tools.js

@@ -294,7 +294,7 @@ export function clearHookCallbacks(ownerId) {
 export const createPostToolUseHook = (options) => async (input, toolUseID) => {
     if (input.hook_event_name === "PostToolUse") {
         // Handle EnterPlanMode tool - notify client of mode change after successful execution
-        if (input.tool_name === "EnterPlanMode" && options?.onEnterPlanMode) {
+        if (input.tool_name === "EnterPlanMode" && !input.agent_id && options?.onEnterPlanMode) {
             await options.onEnterPlanMode();
         }
         if (toolUseID) {

package/dist/usage-markdown.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usage-markdown.d.ts","sourceRoot":"","sources":["../src/usage-markdown.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AA8DjF,sEAAsE;AACtE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,0BAA0B,GAAG,IAAI,CAMpF;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExD;AASD,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpD;AA+DD,iEAAiE;AACjE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,0BAA0B,GAAG,MAAM,CAiE7E"}
+{"version":3,"file":"usage-markdown.d.ts","sourceRoot":"","sources":["../src/usage-markdown.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AAsEjF,sEAAsE;AACtE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,0BAA0B,GAAG,IAAI,CAMpF;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExD;AASD,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpD;AA0ED,iEAAiE;AACjE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,0BAA0B,GAAG,MAAM,CAiE7E"}

package/dist/usage-markdown.js

@@ -6,10 +6,18 @@ const usageWindowSchema = z
     .nullable()
     .optional();
 const contributionSchema = z.object({ name: z.string(), pct: percentSchema });
+// Claude Code 2.1.305+ suggests one change per notable source, largest share first.
+const recommendationSchema = z.object({
+    key: z.string(),
+    pct: percentSchema,
+    title: z.string(),
+    detail: z.string().optional(),
+});
 const behaviorPeriodSchema = z.object({
     request_count: countSchema,
     session_count: countSchema,
     mcp_servers: z.array(contributionSchema),
+    recommendations: z.array(recommendationSchema).optional(),
 });
 const modelUsageSchema = z.object({
     inputTokens: countSchema,
@@ -107,6 +115,16 @@ function appendLimit(lines, label, window) {
 }
 function appendContributions(lines, label, period) {
     lines.push("", `**${label}** · ${period.request_count} requests · ${period.session_count} sessions`);
+    // Rendered in the order Claude Code sends them, as its own `/usage` does. The
+    // window's `fix` is left out: its messages must be queued at priority "later"
+    // with `client_composed` set, which an ACP prompt cannot express.
+    if (period.recommendations?.length) {
+        lines.push("");
+        for (const recommendation of period.recommendations) {
+            const detail = recommendation.detail ? ` · ${escapeMarkdown(recommendation.detail)}` : "";
+            lines.push(`- **${recommendation.pct}%** ${escapeMarkdown(recommendation.title)}${detail}`);
+        }
+    }
     if (period.mcp_servers.length === 0)
         return;
     lines.push("", "| MCP server | Usage |", "|:--|--:|");

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.94.1-preview.8",
+  "version": "0.95.0",
   "description": "An ACP-compatible coding agent powered by the Claude Agent SDK (TypeScript)",
   "main": "dist/lib.js",
   "types": "dist/lib.d.ts",
@@ -65,25 +65,24 @@
     "node": ">=22"
   },
   "dependencies": {
-    "@agentclientprotocol/sdk": "2.0.0",
-    "@anthropic-ai/claude-agent-sdk": "0.3.303",
+    "@agentclientprotocol/sdk": "2.0.1",
+    "@anthropic-ai/claude-agent-sdk": "0.3.309",
     "diff": "9.0.0",
     "zod": "4.6.7"
   },
   "devDependencies": {
-    "@anthropic-ai/sdk": "0.135.0",
+    "@anthropic-ai/sdk": "1.1.0",
     "@eslint/js": "10.0.1",
     "@tsconfig/node22": "22.0.6",
     "@types/node": "26.6.5",
-    "@typescript-eslint/eslint-plugin": "8.71.2",
-    "@typescript-eslint/parser": "8.71.2",
+    "@typescript-eslint/eslint-plugin": "8.72.0",
+    "@typescript-eslint/parser": "8.72.0",
     "ajv": "8.20.0",
     "ajv-formats": "3.0.1",
     "eslint": "10.13.0",
     "eslint-config-prettier": "10.1.8",
     "globals": "17.13.0",
     "prettier": "3.9.10",
-    "ts-node": "10.9.2",
     "typescript": "6.0.3",
     "vitest": "5.0.5"
   }