@agentclientprotocol/claude-agent-acp 0.81.2 → 0.81.3-preview.2

package/dist/permissions/presentation.js

@@ -1,4 +1,6 @@
-import { toolInfoFromToolUse } from "../tools.js";
+import { AIR_PERMISSION_KEY, withAirMeta } from "../air-extension.js";
+import { ClientCapabilities } from "../tool-calls/client-capabilities.js";
+import { AcpToolCallRenderer } from "../tool-calls/renderer.js";
 function humanText(value, maxLength, singleLine = false) {
     if (typeof value !== "string")
         return undefined;
@@ -20,36 +22,27 @@ function humanText(value, maxLength, singleLine = false) {
 function compactText(value) {
     return humanText(value, 160, true);
 }
-function withBlockedPath(locations, blockedPath) {
-    const path = humanText(blockedPath, 4_096, true);
-    if (!path)
-        return locations;
-    const result = [...(locations ?? [])];
-    if (!result.some((location) => location.path === path))
-        result.push({ path });
-    return result;
-}
+/**
+ * The permission request presentation.
+ *
+ * The request `toolCall` carries `toolCallId`, `title`, and `rawInput`. The
+ * adapter emits the `tool_call` before the request, so the client already
+ * holds the rest. The request adds only what it shows new: the exact preview
+ * patch, and the blocked path when the tool call has no such location.
+ */
 export function buildClaudePermissionPresentation(value) {
-    const info = toolInfoFromToolUse({ id: value.toolUseID, name: value.toolName, input: value.input }, value.supportsTerminalOutput ?? false, value.cwd);
+    const capabilities = value.capabilities ?? new ClientCapabilities();
+    const renderer = new AcpToolCallRenderer(capabilities);
+    const toolUse = { id: value.toolUseID, name: value.toolName, input: value.input };
+    const facts = renderer.facts(toolUse, value.cwd);
     const host = value.toolName === "SandboxNetworkAccess" ? compactText(value.input.host) : undefined;
     const isComputerUse = value.toolName.startsWith("mcp__computer-use__");
     const subjectTitle = host ?? (isComputerUse ? compactText(value.displayName) : undefined);
-    const subjectContent = (host || isComputerUse) && info.content.length === 0
-        ? [
-            {
-                type: "content",
-                content: {
-                    type: "text",
-                    text: `\`\`\`json\n${JSON.stringify(value.input, null, 2)}\n\`\`\``,
-                },
-            },
-        ]
-        : info.content;
     // Reuse the exact standard tool-call heading as the permission heading so
     // the approval never maintains a second, divergent name for the operation.
     // decisionReason is temporarily exposed as the permission description so
     // its actual SDK values can be inspected; it remains diagnostic policy text.
-    const toolCallTitle = subjectTitle ?? info.title;
+    const toolCallTitle = subjectTitle ?? facts.title;
     const permissionTitle = value.toolName === "ExitPlanMode" ? "Ready to code?" : toolCallTitle;
     // Shell titles are executable input: compacting whitespace changes quoted
     // arguments and comment boundaries, and length limits can hide the command.
@@ -58,30 +51,42 @@ export function buildClaudePermissionPresentation(value) {
         : (humanText(permissionTitle, 4_000, true) ?? "Use tool?");
     const decisionReason = humanText(value.decisionReason, 4_000);
     const description = decisionReason ? `Reason: ${decisionReason}` : undefined;
+    const blockedPath = humanText(value.blockedPath, 4_096, true);
+    const extraLocations = blockedPath && !(facts.locations ?? []).some((location) => location.path === blockedPath)
+        ? [{ path: blockedPath }]
+        : undefined;
     return {
-        toolCall: {
-            toolCallId: value.toolUseID,
-            name: value.toolName,
-            status: "pending",
-            rawInput: value.input,
-            ...info,
+        toolCall: renderer.permissionToolCall(toolUse, {
+            cwd: value.cwd,
             title: toolCallTitle,
-            content: subjectContent,
-            locations: withBlockedPath(info.locations, value.blockedPath),
-        },
-        ...(title
-            ? {
-                _meta: {
-                    permission: {
-                        version: 1,
-                        title,
-                        ...(description ? { description } : {}),
-                        // The CLI's own hint, forwarded so a client that can pre-select
-                        // an option keeps the decline focused; the option order already
-                        // leads with the reject options when this is set.
-                        ...(value.defaultToNo === true ? { defaultToNo: true } : {}),
+            previewContent: value.previewContent,
+            extraLocations,
+            // The upstream request shows the input of a network or computer-use
+            // request that has no content of its own.
+            fallbackContent: host || isComputerUse
+                ? [
+                    {
+                        type: "content",
+                        content: {
+                            type: "text",
+                            text: `\`\`\`json\n${JSON.stringify(value.input, null, 2)}\n\`\`\``,
+                        },
                     },
-                },
+                ]
+                : undefined,
+        }),
+        // Only AIR gets the permission presentation.
+        ...(title && capabilities.air.client
+            ? {
+                _meta: withAirMeta(undefined, AIR_PERMISSION_KEY, {
+                    version: 1,
+                    title,
+                    ...(description ? { description } : {}),
+                    // The CLI's own hint, forwarded so a client that can pre-select
+                    // an option keeps the decline focused; the option order already
+                    // leads with the reject options when this is set.
+                    ...(value.defaultToNo === true ? { defaultToNo: true } : {}),
+                }),
             }
             : {}),
     };

package/dist/resumed-session.d.ts

@@ -15,5 +15,16 @@ export declare function resumedModelFromTranscript(messages: SessionMessage[]):
 /** Read the resume model from the local transcript without starting a Claude
  * control request. This is intentionally on the load critical path. */
 export declare function readResumedSession(sessionId: string, logger?: ResumeLogger): Promise<ResumedSessionSnapshot>;
+/**
+ * Read the resume model of a session from the end of its local transcript.
+ *
+ * A resume needs only the model, not the messages. The transcript file is
+ * read backwards until the last real assistant record of the main thread, so
+ * the cost does not grow with the length of the session. A session without a
+ * local transcript file falls back to {@link readResumedSession}.
+ */
+export declare function readResumedModel(sessionId: string, logger?: ResumeLogger): Promise<string | undefined>;
+/** The local transcript of a session in any project directory, as the SDK looks it up. */
+export declare function findTranscript(sessionId: string): Promise<string | undefined>;
 export {};
 //# sourceMappingURL=resumed-session.d.ts.map

package/dist/resumed-session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resumed-session.d.ts","sourceRoot":"","sources":["../src/resumed-session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAGzF,KAAK,YAAY,GAAG;IAClB,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IAClC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;iDAGiD;AACjD,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,MAAM,GAAG,SAAS,CAkBzF;AAED;uEACuE;AACvE,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,YAAY,GACpB,OAAO,CAAC,sBAAsB,CAAC,CAejC"}
+{"version":3,"file":"resumed-session.d.ts","sourceRoot":"","sources":["../src/resumed-session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,gCAAgC,CAAC;AASzF,KAAK,YAAY,GAAG;IAClB,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IAClC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;iDAGiD;AACjD,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,MAAM,GAAG,SAAS,CAgBzF;AASD;uEACuE;AACvE,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,YAAY,GACpB,OAAO,CAAC,sBAAsB,CAAC,CAejC;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,YAAY,GACpB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAc7B;AAED,0FAA0F;AAC1F,wBAAsB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAkBnF"}

package/dist/resumed-session.js

@@ -1,5 +1,10 @@
 import { getSessionMessages } from "@anthropic-ai/claude-agent-sdk";
+import { access, open, readdir } from "node:fs/promises";
+import path from "node:path";
+import { claudeConfigDir } from "./paths.js";
 import { SessionTiming } from "./session-timing.js";
+/** The size of one backward read of a transcript. */
+const TAIL_CHUNK_BYTES = 64 * 1024;
 /** Return the concrete model recorded by the last real assistant response.
  * Claude Code restores a resumed query from this same transcript field.
  * Synthetic assistant records use angle-bracket placeholders and do not
@@ -14,13 +19,19 @@ export function resumedModelFromTranscript(messages) {
             typeof entry.message !== "object") {
             continue;
         }
-        const model = entry.message.model;
-        if (typeof model === "string" && model.trim().length > 0 && !/^<[^>]+>$/.test(model.trim())) {
-            return model.trim();
-        }
+        const model = concreteModel(entry.message.model);
+        if (model)
+            return model;
     }
     return undefined;
 }
+/** The model name, or undefined for a missing or a synthetic `<…>` model. */
+function concreteModel(model) {
+    if (typeof model !== "string")
+        return undefined;
+    const name = model.trim();
+    return name.length > 0 && !/^<[^>]+>$/.test(name) ? name : undefined;
+}
 /** Read the resume model from the local transcript without starting a Claude
  * control request. This is intentionally on the load critical path. */
 export async function readResumedSession(sessionId, logger) {
@@ -40,3 +51,94 @@ export async function readResumedSession(sessionId, logger) {
         return {};
     }
 }
+/**
+ * Read the resume model of a session from the end of its local transcript.
+ *
+ * A resume needs only the model, not the messages. The transcript file is
+ * read backwards until the last real assistant record of the main thread, so
+ * the cost does not grow with the length of the session. A session without a
+ * local transcript file falls back to {@link readResumedSession}.
+ */
+export async function readResumedModel(sessionId, logger) {
+    const timing = new SessionTiming(logger, "models", sessionId);
+    try {
+        const filePath = await findTranscript(sessionId);
+        if (filePath) {
+            const model = await lastAssistantModel(filePath);
+            timing.phase("read-transcript-tail", ` model=${model ?? "unknown"}`);
+            return model;
+        }
+    }
+    catch (error) {
+        timing.phase("read-transcript-tail", " outcome=error");
+        logger?.error(`Failed to read the transcript tail of resumed session ${sessionId}:`, error);
+    }
+    return (await readResumedSession(sessionId, logger)).model;
+}
+/** The local transcript of a session in any project directory, as the SDK looks it up. */
+export async function findTranscript(sessionId) {
+    const projects = path.join(claudeConfigDir(), "projects");
+    let directories;
+    try {
+        directories = await readdir(projects);
+    }
+    catch {
+        return undefined;
+    }
+    for (const directory of directories) {
+        const candidate = path.join(projects, directory, `${sessionId}.jsonl`);
+        try {
+            await access(candidate);
+            return candidate;
+        }
+        catch {
+            // Not in this project directory.
+        }
+    }
+    return undefined;
+}
+/** The model of the last real assistant record of the main thread in a JSONL transcript. */
+async function lastAssistantModel(filePath) {
+    const handle = await open(filePath, "r");
+    try {
+        let end = (await handle.stat()).size;
+        // The bytes of the line whose start is not read yet, in file order.
+        let pending = [];
+        while (end > 0) {
+            const start = Math.max(0, end - TAIL_CHUNK_BYTES);
+            let chunk = Buffer.alloc(end - start);
+            await handle.read(chunk, 0, chunk.length, start);
+            for (let at = chunk.lastIndexOf(0x0a); at >= 0; at = chunk.lastIndexOf(0x0a)) {
+                const model = assistantModelOfLine(Buffer.concat([chunk.subarray(at + 1), ...pending]));
+                if (model)
+                    return model;
+                pending = [];
+                chunk = chunk.subarray(0, at);
+            }
+            pending.unshift(chunk);
+            end = start;
+        }
+        return assistantModelOfLine(Buffer.concat(pending));
+    }
+    finally {
+        await handle.close();
+    }
+}
+function assistantModelOfLine(line) {
+    // Most lines are not assistant records. The check skips their JSON parse.
+    if (line.indexOf('"assistant"') < 0)
+        return undefined;
+    let entry;
+    try {
+        entry = JSON.parse(line.toString("utf8"));
+    }
+    catch {
+        return undefined;
+    }
+    if (!entry || typeof entry !== "object")
+        return undefined;
+    const record = entry;
+    if (record.type !== "assistant" || record.isSidechain === true)
+        return undefined;
+    return concreteModel(record.message?.model);
+}

package/dist/session-failure-extension.js

@@ -17,7 +17,7 @@ const AIR_FAILURE_POLICY = {
     // credentials must be refreshed outside Claude. No `login` action, and not
     // sticky like `auth_required` (nothing clears at `auth_status`).
     access_denied: {
-        category: "access",
+        category: "service",
         actions: ["retry"],
         fallbackTitle: "Claude could not access the account or provider credentials.",
     },

package/dist/session-mode.d.ts

@@ -27,6 +27,8 @@ export type SessionModeManagerOptions<S extends SessionMode> = {
      *  known after `initialize`. */
     supportsNotices?(): boolean;
     logError(...args: unknown[]): void;
+    /** Whether the client is AIR. Only AIR gets the mode kind, under `_meta.jetbrains.air`. */
+    airClient?(): boolean;
 };
 type ModeConfigSession = SessionMode & {
     configOptions: SessionConfigOption[];

package/dist/session-mode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-mode.d.ts","sourceRoot":"","sources":["../src/session-mode.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"session-mode.d.ts","sourceRoot":"","sources":["../src/session-mode.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC5B,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EACV,SAAS,EACT,cAAc,EACd,gBAAgB,EAChB,KAAK,EACN,MAAM,gCAAgC,CAAC;AASxC,eAAO,MAAM,cAAc,SAAS,CAAC;AACrC,eAAO,MAAM,kBAAkB,EAAE,cAA8B,CAAC;AAYhE,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAAC;IACxC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,gBAAgB,CAAC;IACxB,MAAM,EAAE;QAAE,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC;IACnC,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,8EAA8E;IAC9E,4BAA4B,CAAC,EAAE,OAAO,CAAC;IACvC,gFAAgF;IAChF,8BAA8B,CAAC,EAAE,OAAO,CAAC;IACzC,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,yBAAyB,CAAC,CAAC,SAAS,WAAW,IAAI;IAC7D,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IAC7C,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtF,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D;;oCAEgC;IAChC,eAAe,CAAC,IAAI,OAAO,CAAC;IAC5B,QAAQ,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACnC,2FAA2F;IAC3F,SAAS,CAAC,IAAI,OAAO,CAAC;CACvB,CAAC;AAEF,KAAK,iBAAiB,GAAG,WAAW,GAAG;IACrC,aAAa,EAAE,mBAAmB,EAAE,CAAC;CACtC,CAAC;AAEF,KAAK,2BAA2B,GAAG;IACjC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAAC;IACxC,aAAa,EAAE,cAAc,CAAC;IAC9B,gBAAgB,CAAC,EAAE,SAAS,CAAC;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,sEAAsE;IACtE,WAAW,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,4EAA4E;AAC5E,qBAAa,kBAAkB,CAAC,CAAC,SAAS,WAAW;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,yBAAyB,CAAC,CAAC,CAAC;IAE5D,UAAU,CAAC,EACf,KAAK,EACL,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,WAAW,GACZ,EAAE,2BAA2B,GAAG,OAAO,CAAC;QACvC,KAAK,EAAE,gBAAgB,CAAC;QACxB,8BAA8B,EAAE,OAAO,CAAC;KACzC,CAAC;IAgCF,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,gBAAgB,GAAG,mBAAmB;IAiBjE,UAAU,CAAC,OAAO,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAe1D,gBAAgB,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,EAAE;IAInD,aAAa,CAAC,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,cAAc,GAAG,cAAc;IAMlF,uBAAuB,CACrB,OAAO,EAAE,WAAW,EACpB,gBAAgB,EAAE,gBAAgB,GACjC;QAAE,gBAAgB,EAAE,gBAAgB,CAAC;QAAC,eAAe,EAAE,OAAO,CAAA;KAAE;IAwBnE;sDACkD;IAC5C,iBAAiB,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,GAAG,SAAS;IAqBpE,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAyBtE,cAAc,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAS9E,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO9D,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAuB9E,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlF,OAAO,CAAC,kBAAkB;IAS1B,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,SAAS;IAcjB,OAAO,CAAC,mBAAmB;YA4Cb,WAAW;CAW1B"}

package/dist/session-mode.js

@@ -1,4 +1,5 @@
 import { RequestError, } from "@agentclientprotocol/sdk";
+import { AIR_KIND_KEY, airOnlyMeta } from "./air-extension.js";
 import { noticeOrTranscriptUpdate, noticeTranscriptText, sentenceCase, } from "./session-notices.js";
 export const MODE_CONFIG_ID = "mode";
 export const AUTO_MODE_FALLBACK = "acceptEdits";
@@ -201,30 +202,36 @@ export class SessionModeManager {
         }
     }
     buildAvailableModes(allowBypass) {
+        // Only AIR gets the mode kind.
+        const air = this.options.airClient?.() ?? false;
+        const kind = (value) => {
+            const meta = airOnlyMeta(air, AIR_KIND_KEY, value);
+            return meta ? { _meta: meta } : {};
+        };
         const modes = [
             {
                 id: "default",
                 name: "Manual",
                 description: "Always ask before making changes",
-                _meta: { kind: "standard" },
+                ...kind("standard"),
             },
             {
                 id: "acceptEdits",
                 name: "Accept edits",
                 description: "Automatically accept all file edits",
-                _meta: { kind: "standard" },
+                ...kind("standard"),
             },
             {
                 id: "plan",
                 name: "Plan",
                 description: "Create a plan before making changes",
-                _meta: { kind: "plan" },
+                ...kind("plan"),
             },
             {
                 id: "auto",
                 name: "Auto",
                 description: "Claude handles permission decisions",
-                _meta: { kind: "auto_review" },
+                ...kind("auto_review"),
             },
         ];
         if (allowBypass) {
@@ -232,7 +239,7 @@ export class SessionModeManager {
                 id: "bypassPermissions",
                 name: "Bypass permissions",
                 description: "Accepts all permissions",
-                _meta: { kind: "full_access" },
+                ...kind("full_access"),
             });
         }
         return modes;

package/dist/settings.js

@@ -3,7 +3,7 @@ import * as path from "node:path";
 // resolveSettings and filterEscalatingDefaultMode are marked @alpha in the
 // SDK; API may shift in a future release.
 import { filterEscalatingDefaultMode, resolveSettings, } from "@anthropic-ai/claude-agent-sdk";
-import { CLAUDE_CONFIG_DIR } from "./acp-agent.js";
+import { claudeConfigDir } from "./paths.js";
 /**
  * Permission rule format examples:
  * - "Read" - matches all Read tool calls
@@ -75,7 +75,7 @@ export class SettingsManager {
      */
     getWatchedPaths() {
         return [
-            path.join(CLAUDE_CONFIG_DIR, "settings.json"),
+            path.join(claudeConfigDir(), "settings.json"),
             path.join(this.cwd, ".claude", "settings.json"),
             path.join(this.cwd, ".claude", "settings.local.json"),
             getManagedSettingsPath(),

package/dist/subagent-history.d.ts

@@ -0,0 +1,20 @@
+/** Where the subagent transcripts of a session are. */
+export interface SubagentHistory {
+    /** The subagent id of each Agent or Task tool use that launched a subagent. */
+    ids: Map<string, string>;
+    /**
+     * The project directory of the session, as the SDK takes it in `dir`. With
+     * it, the SDK reads a subagent transcript without a search of every project.
+     */
+    dir?: string;
+}
+/**
+ * Finds the subagent transcripts of a session.
+ *
+ * Claude keeps the history of a subagent in its own transcript,
+ * `<session>/subagents/agent-<id>.jsonl`, next to the session transcript.
+ * The `agent-<id>.meta.json` file beside it names the launching tool use.
+ * The ids are empty for a session without a local transcript.
+ */
+export declare function subagentHistory(sessionId: string): Promise<SubagentHistory>;
+//# sourceMappingURL=subagent-history.d.ts.map

package/dist/subagent-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-history.d.ts","sourceRoot":"","sources":["../src/subagent-history.ts"],"names":[],"mappings":"AAKA,uDAAuD;AACvD,MAAM,WAAW,eAAe;IAC9B,+EAA+E;IAC/E,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzB;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CA6BjF"}

package/dist/subagent-history.js

@@ -0,0 +1,46 @@
+import { getSessionInfo } from "@anthropic-ai/claude-agent-sdk";
+import { readdir, readFile } from "node:fs/promises";
+import path from "node:path";
+import { findTranscript } from "./resumed-session.js";
+/**
+ * Finds the subagent transcripts of a session.
+ *
+ * Claude keeps the history of a subagent in its own transcript,
+ * `<session>/subagents/agent-<id>.jsonl`, next to the session transcript.
+ * The `agent-<id>.meta.json` file beside it names the launching tool use.
+ * The ids are empty for a session without a local transcript.
+ */
+export async function subagentHistory(sessionId) {
+    const ids = new Map();
+    const transcript = await findTranscript(sessionId);
+    if (!transcript)
+        return { ids };
+    const directory = path.join(path.dirname(transcript), sessionId, "subagents");
+    let names;
+    try {
+        names = await readdir(directory);
+    }
+    catch {
+        return { ids };
+    }
+    await Promise.all(names.map(async (name) => {
+        const match = /^agent-(.+)\.meta\.json$/.exec(name);
+        if (!match)
+            return;
+        try {
+            const meta = JSON.parse(await readFile(path.join(directory, name), "utf8"));
+            const toolUseId = meta?.toolUseId;
+            if (typeof toolUseId === "string")
+                ids.set(toolUseId, match[1]);
+        }
+        catch {
+            // A damaged meta file leaves its subagent without history.
+        }
+    }));
+    if (ids.size === 0)
+        return { ids };
+    // The folder name encodes the project directory, and the encoding loses
+    // characters. The session info reads it back from the transcript.
+    const dir = (await getSessionInfo(sessionId).catch(() => undefined))?.cwd;
+    return dir ? { ids, dir } : { ids };
+}

package/dist/tool-calls/background.d.ts

@@ -0,0 +1,20 @@
+import type { SessionNotification } from "@agentclientprotocol/sdk";
+import type { AsyncTaskStarted } from "../async-tasks.js";
+/**
+ * Marks the Bash `tool_call_update` whose command detached into the background.
+ *
+ * A backgrounded Bash call returns as soon as the command is handed off, so the
+ * card reaches `completed` while the command itself runs on for minutes. ACP has
+ * no tool-call status for "still running elsewhere", so this marker is what lets
+ * a client render the card as backgrounded work instead of finished work. It
+ * rides the update the tool result already emits, so it costs no extra
+ * notification and cannot arrive out of order.
+ *
+ * The command's own lifecycle -- progress, completion, the stop control -- is
+ * published separately as an async task; this says only that the card has one.
+ * Hence the AIR namespace rather than `claudeCode`: to a client without the
+ * `asyncTasks` capability, which is never sent that lifecycle, the marker would
+ * promise a card state it has no way to ever resolve.
+ */
+export declare function backgroundedBashToolCall(notification: SessionNotification, task: AsyncTaskStarted | undefined, asyncTasksSupported: boolean): SessionNotification;
+//# sourceMappingURL=background.d.ts.map

package/dist/tool-calls/background.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"background.d.ts","sourceRoot":"","sources":["../../src/tool-calls/background.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1D;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,mBAAmB,EACjC,IAAI,EAAE,gBAAgB,GAAG,SAAS,EAClC,mBAAmB,EAAE,OAAO,GAC3B,mBAAmB,CAkBrB"}

package/dist/tool-calls/background.js

@@ -0,0 +1,41 @@
+import { AIR_ASYNC_TASKS_CAPABILITY, withAirMeta } from "../air-extension.js";
+/**
+ * Marks the Bash `tool_call_update` whose command detached into the background.
+ *
+ * A backgrounded Bash call returns as soon as the command is handed off, so the
+ * card reaches `completed` while the command itself runs on for minutes. ACP has
+ * no tool-call status for "still running elsewhere", so this marker is what lets
+ * a client render the card as backgrounded work instead of finished work. It
+ * rides the update the tool result already emits, so it costs no extra
+ * notification and cannot arrive out of order.
+ *
+ * The command's own lifecycle -- progress, completion, the stop control -- is
+ * published separately as an async task; this says only that the card has one.
+ * Hence the AIR namespace rather than `claudeCode`: to a client without the
+ * `asyncTasks` capability, which is never sent that lifecycle, the marker would
+ * promise a card state it has no way to ever resolve.
+ */
+export function backgroundedBashToolCall(notification, task, asyncTasksSupported) {
+    const update = notification.update;
+    const toolCallId = task ? nonBlankTaskField(task.toolCallId ?? task.tool_use_id) : undefined;
+    if (!asyncTasksSupported ||
+        !toolCallId ||
+        update.sessionUpdate !== "tool_call_update" ||
+        update.toolCallId !== toolCallId) {
+        return notification;
+    }
+    return {
+        ...notification,
+        update: {
+            ...update,
+            _meta: withAirMeta(update._meta, AIR_ASYNC_TASKS_CAPABILITY, { backgrounded: true }),
+        },
+    };
+}
+/** The task fields arrive as `unknown` off the wire; only non-blank strings carry a link. */
+function nonBlankTaskField(value) {
+    if (typeof value !== "string")
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed ? trimmed : undefined;
+}

package/dist/tool-calls/changed-meta-filter.d.ts

@@ -0,0 +1,27 @@
+import type { SessionNotification } from "@agentclientprotocol/sdk";
+type SessionUpdate = SessionNotification["update"];
+/**
+ * Removes the `_meta` keys of a `tool_call_update` that an earlier report of
+ * the same tool call already sent with the same value.
+ *
+ * Only an AIR client gets the filtered updates, because AIR merges these
+ * `_meta` keys. ACP does not define a merge for `_meta` keys, so another
+ * client gets every key on every update.
+ *
+ * It runs on the final notification, after the native subagent routing,
+ * because the routing reads `claudeCode.toolName` and
+ * `claudeCode.parentToolUseId` on every update. It compares the keys of
+ * `claudeCode`, of `jetbrains.air`, and the flags `is_mcp_tool_call` and
+ * `terminal_info`. It never compares `terminal_output`,
+ * `terminal_output_delta`, `terminal_exit`, or `mcp_output_delta`: a client
+ * appends their data. An update with nothing left is dropped.
+ */
+export declare class ChangedMetaFilter {
+    private readonly sent;
+    /** Returns the update without the unchanged keys, or null when nothing is left. */
+    apply(update: SessionUpdate): SessionUpdate | null;
+    /** Stores the entry as the most recent one, and forgets the oldest one past the limit. */
+    private remember;
+}
+export {};
+//# sourceMappingURL=changed-meta-filter.d.ts.map

package/dist/tool-calls/changed-meta-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changed-meta-filter.d.ts","sourceRoot":"","sources":["../../src/tool-calls/changed-meta-filter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEpE,KAAK,aAAa,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;AAWnD;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA0C;IAE/D,mFAAmF;IACnF,KAAK,CAAC,MAAM,EAAE,aAAa,GAAG,aAAa,GAAG,IAAI;IAuBlD,0FAA0F;IAC1F,OAAO,CAAC,QAAQ;CAQjB"}