@agentproto/acp 0.3.0 → 0.4.0

package/dist/client/index.d.ts

@@ -1,5 +1,5 @@
 import { ClientSideConnection, Client } from '@agentclientprotocol/sdk';
-import { S as StreamEvent } from '../types-DC2phPNG.js';
+import { S as StreamEvent } from '../types-Sxd1kKk2.js';
 
 /**
  * AIP-44 ACP client — drives a subprocess agent via stdio JSON-RPC.
@@ -12,14 +12,14 @@ import { S as StreamEvent } from '../types-DC2phPNG.js';
  */
 
 /**
- * Map our internal `AcpMcpServer` (`{ name, transport, ref }`) onto the
- * `@agentclientprotocol/sdk` wire shape expected by
+ * Map our internal `AcpMcpServer` (`{ name, transport, ref, headers, credentialRef }`)
+ * onto the `@agentclientprotocol/sdk` wire shape expected by
  * `session/new.mcpServers` (and `session/load.mcpServers`).
  *
  * The ACP `McpServer` union is transport-tagged and field-named
  * differently from our compact internal form:
- *   - http → `{ type: "http", name, url, headers: [] }`
- *   - sse  → `{ type: "sse",  name, url, headers: [] }`
+ *   - http → `{ type: "http", name, url, headers: [{ name, value }, …] }`
+ *   - sse  → `{ type: "sse",  name, url, headers: [{ name, value }, …] }`
  *   - stdio → `{ name, command, args: [], env: [] }` (untagged variant)
  *
  * Without this mapping the raw `{ transport, ref }` entry reaches the
@@ -97,6 +97,11 @@ interface AcpClient {
          * Model to select via `session/set_config_option` immediately after
          * `newSession`. The claude-agent-acp wrapper supports this as
          * `configId:"model"`. Omit to keep the agent's own default.
+         *
+         * Best-effort: a value the agent can't resolve (a stale/gated/typo'd id)
+         * is warned about and dropped — the session still starts on the agent's
+         * default model rather than crashing the spawn. See the reject handler
+         * in `newSession` for the reasoning (agentproto#186).
          */
         model?: string;
         /**
@@ -106,6 +111,15 @@ interface AcpClient {
          * Omit to keep the model's own default.
          */
         effort?: string;
+        /**
+         * Mode to select via `session/set_config_option` after `newSession`,
+         * for ACP servers that model mode selection as a session config
+         * option (`configId:"mode"`) instead of a CLI flag — e.g. opencode.
+         * Best-effort, same as `model`/`effort`: a rejection is warned about
+         * and dropped rather than failing the spawn. Omit to keep the
+         * agent's own default mode.
+         */
+        mode?: string;
     }): Promise<AcpClientSession>;
     /**
      * Reattach to an existing session by id. Available only when the

package/dist/client/index.mjs

@@ -15,18 +15,27 @@ function toAcpMcpServer(server) {
   if ("type" in entry || "url" in entry || "command" in entry) return entry;
   const transport = entry.transport;
   if (typeof transport !== "string") return entry;
-  const { name, ref } = entry;
+  const name = entry.name;
+  const ref = entry.ref;
+  const headers = entry.headers;
   switch (transport) {
     case "http":
-      return { type: "http", name, url: ref ?? "", headers: [] };
+      return { type: "http", name, url: ref ?? "", headers: toAcpHeaders(headers) };
     case "sse":
-      return { type: "sse", name, url: ref ?? "", headers: [] };
+      return { type: "sse", name, url: ref ?? "", headers: toAcpHeaders(headers) };
     case "stdio":
       return { name, command: ref ?? "", args: [], env: [] };
     default:
       return entry;
   }
 }
+function toAcpHeaders(headers) {
+  if (!headers || typeof headers !== "object") return [];
+  return Object.entries(headers).map(([name, value]) => ({
+    name,
+    value: typeof value === "string" ? value : String(value)
+  }));
+}
 async function createAcpClient(options) {
   const sessions = /* @__PURE__ */ new Map();
   const stream = ndJsonStream(options.output, options.input);
@@ -61,12 +70,18 @@ async function createAcpClient(options) {
       };
       sessions.set(sessionId, state);
       if (params.model) {
-        await connection.setSessionConfigOption({
-          configId: "model",
-          value: params.model,
-          sessionId
-        });
-        options.onActivity?.();
+        try {
+          await connection.setSessionConfigOption({
+            configId: "model",
+            value: params.model,
+            sessionId
+          });
+          options.onActivity?.();
+        } catch (err) {
+          console.warn(
+            `[acp] set_config_option model="${params.model}" rejected by server \u2014 keeping the agent's default model. Reason: ${configOptionErrorDetail(err)}`
+          );
+        }
       }
       if (params.effort) {
         try {
@@ -78,8 +93,21 @@ async function createAcpClient(options) {
           options.onActivity?.();
         } catch (err) {
           console.warn(
-            `[acp] set_config_option effort="${params.effort}" rejected by server (best-effort):`,
-            err instanceof Error ? err.message : err
+            `[acp] set_config_option effort="${params.effort}" rejected by server (best-effort): ${configOptionErrorDetail(err)}`
+          );
+        }
+      }
+      if (params.mode) {
+        try {
+          await connection.setSessionConfigOption({
+            configId: "mode",
+            value: params.mode,
+            sessionId
+          });
+          options.onActivity?.();
+        } catch (err) {
+          console.warn(
+            `[acp] set_config_option mode="${params.mode}" rejected by server (best-effort): ${configOptionErrorDetail(err)}`
           );
         }
       }
@@ -349,12 +377,23 @@ function translateSessionUpdate(sessionId, update) {
     }
     case "usage_update": {
       const cost = update.cost;
+      const numeric = (...keys) => {
+        for (const key of keys) {
+          const v = update[key];
+          if (typeof v === "number") return v;
+        }
+        return void 0;
+      };
+      const tokensIn = numeric("tokensIn", "input_tokens", "inputTokens");
+      const tokensOut = numeric("tokensOut", "output_tokens", "outputTokens");
       return {
         kind: "usage_update",
         sessionId,
         size: update.size ?? 0,
         used: update.used ?? 0,
-        ...cost ? { cost } : {}
+        ...cost ? { cost } : {},
+        ...tokensIn !== void 0 ? { tokensIn } : {},
+        ...tokensOut !== void 0 ? { tokensOut } : {}
       };
     }
     case "user_message_chunk":
@@ -363,6 +402,20 @@ function translateSessionUpdate(sessionId, update) {
       return null;
   }
 }
+function configOptionErrorDetail(err) {
+  if (typeof err === "object" && err !== null) {
+    if ("data" in err && typeof err.data === "object" && err.data !== null) {
+      const data = err.data;
+      if ("details" in data && typeof data.details === "string" && data.details.length > 0) {
+        return data.details;
+      }
+    }
+    if ("message" in err && typeof err.message === "string" && err.message.length > 0) {
+      return err.message;
+    }
+  }
+  return String(err);
+}
 function extractText(content) {
   if (!content) return "";
   if (typeof content === "string") return content;

package/dist/client/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/client/index.ts"],"names":["value"],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * AIP-44 ACP client — drives a subprocess agent via stdio JSON-RPC.\n *\n * Wraps `@agentclientprotocol/sdk`'s `ClientSideConnection`. Owns the\n * connection lifecycle, runs `initialize` on construction, and exposes\n * a session API where each `prompt()` call returns an\n * `AsyncIterable<StreamEvent>` fed by the SDK's `session/update`\n * notification handler.\n */\n\nimport {\n  ClientSideConnection,\n  ndJsonStream,\n  type Client as AcpClientHandlers,\n  type Stream,\n} from \"@agentclientprotocol/sdk\"\nimport type { AcpMcpServer, StreamEvent } from \"../types.js\"\n\nconst PROTOCOL_VERSION_DEFAULT = 1\n\n/**\n * Map our internal `AcpMcpServer` (`{ name, transport, ref }`) onto the\n * `@agentclientprotocol/sdk` wire shape expected by\n * `session/new.mcpServers` (and `session/load.mcpServers`).\n *\n * The ACP `McpServer` union is transport-tagged and field-named\n * differently from our compact internal form:\n *   - http → `{ type: \"http\", name, url, headers: [] }`\n *   - sse  → `{ type: \"sse\",  name, url, headers: [] }`\n *   - stdio → `{ name, command, args: [], env: [] }` (untagged variant)\n *\n * Without this mapping the raw `{ transport, ref }` entry reaches the\n * agent verbatim and `session/new` rejects with `Invalid params` — the\n * symptom that broke orchestrator spawns (the auto-injected scoped\n * gateway is an `http` entry).\n *\n * Retro-compat: an entry that already carries an ACP-native discriminator\n * (`type`/`url`/`command`) is passed through untouched, so callers that\n * pre-shape their entries keep working.\n */\nexport function toAcpMcpServers(servers: readonly unknown[]): unknown[] {\n  return servers.map(toAcpMcpServer)\n}\n\nfunction toAcpMcpServer(server: unknown): unknown {\n  if (!server || typeof server !== \"object\") return server\n  const entry = server as Record<string, unknown>\n\n  // Already ACP-native (has a wire discriminator) → leave as-is.\n  if (\"type\" in entry || \"url\" in entry || \"command\" in entry) return entry\n\n  const transport = entry.transport\n  // Not our `{ name, transport, ref }` shape → nothing to map.\n  if (typeof transport !== \"string\") return entry\n\n  const { name, ref } = entry as Pick<AcpMcpServer, \"name\" | \"ref\"> & {\n    transport: string\n  }\n\n  switch (transport) {\n    case \"http\":\n      return { type: \"http\", name, url: ref ?? \"\", headers: [] }\n    case \"sse\":\n      return { type: \"sse\", name, url: ref ?? \"\", headers: [] }\n    case \"stdio\":\n      return { name, command: ref ?? \"\", args: [], env: [] }\n    default:\n      return entry\n  }\n}\n\nexport interface AcpClientOptions {\n  /** Output bytes go here (subprocess stdin). */\n  output: WritableStream<Uint8Array>\n  /** Input bytes come from here (subprocess stdout). */\n  input: ReadableStream<Uint8Array>\n  /** Client identity advertised during `initialize`. */\n  clientInfo?: {\n    name: string\n    title?: string\n    version?: string\n  }\n  /** Client capabilities advertised during `initialize`. */\n  capabilities?: {\n    fs?: { readTextFile?: boolean; writeTextFile?: boolean }\n    terminal?: boolean\n  }\n  /** Optional handlers for agent-initiated requests beyond fs / terminal. */\n  handlers?: Partial<AcpClientHandlers>\n  /** Protocol version to negotiate. Defaults to the SDK's current. */\n  protocolVersion?: number\n  /**\n   * Called on ANY JSON-RPC traffic with the child agent process — every\n   * incoming `session/update` notification (even ones that\n   * `translateSessionUpdate` maps to `null`, e.g. a `tool_call_update`\n   * still in progress) and every outbound RPC call this client makes\n   * (`newSession`, `loadSession`, `setSessionConfigOption`, `prompt`,\n   * `cancel`). Distinct from the `StreamEvent` stream: fires even\n   * during gaps where no event is produced, so a host can track\n   * liveness independent of what the agent actually says.\n   */\n  onActivity?: () => void\n  /**\n   * Turn-idle watchdog: if a `prompt()` call goes this many ms with NO\n   * activity signal (see `onActivity` above — incoming `session/update`\n   * notifications, outbound RPCs) and the underlying `connection.prompt()`\n   * promise still hasn't resolved, synthesize a `turn-end` event with\n   * `reason: \"watchdog-timeout\"` so the caller's async iterator completes\n   * instead of hanging forever. The timer resets on every activity signal\n   * observed DURING that turn, so a legitimately long tool-call chain\n   * (still producing activity, just no user-visible output) never\n   * false-positives — this is \"N ms of true silence,\" not \"N ms since the\n   * turn started.\"\n   *\n   * Undefined (the default) disables the watchdog entirely — existing\n   * callers see no behavior change. If the real `connection.prompt()`\n   * eventually settles after the synthetic turn-end was already emitted,\n   * the late result is logged and discarded (no crash, no duplicate\n   * turn-end for the same logical turn).\n   */\n  turnIdleTimeoutMs?: number\n}\n\nexport interface AcpClient {\n  readonly connection: ClientSideConnection\n  /** Negotiated agent capabilities returned from `initialize`. */\n  readonly agentCapabilities: Record<string, unknown> | undefined\n  newSession(params: {\n    cwd: string\n    mcpServers?: unknown[]\n    /**\n     * Model to select via `session/set_config_option` immediately after\n     * `newSession`. The claude-agent-acp wrapper supports this as\n     * `configId:\"model\"`. Omit to keep the agent's own default.\n     */\n    model?: string\n    /**\n     * Effort level to select via `session/set_config_option` after\n     * `newSession`. Effort is model-dependent — same label ≠ same\n     * budget across models; defaults differ too (see AgentCliConnectOptions).\n     * Omit to keep the model's own default.\n     */\n    effort?: string\n  }): Promise<AcpClientSession>\n  /**\n   * Reattach to an existing session by id. Available only when the\n   * agent advertised `loadSession: true` in its capabilities (callers\n   * should check `agentCapabilities` first; we forward the SDK error\n   * verbatim if they don't).\n   *\n   * Drives the AIP-45 native-resume continuation strategy: the host\n   * persists the `sessionId` returned by `newSession`, then on a\n   * cold start (process restart, fresh sandbox, different machine)\n   * spawns a new subprocess and calls `loadSession` to pick up\n   * the conversation from the stored history.\n   */\n  loadSession(params: {\n    sessionId: string\n    cwd: string\n    mcpServers?: unknown[]\n  }): Promise<AcpClientSession>\n  close(): Promise<void>\n}\n\nexport interface AcpClientSession {\n  readonly sessionId: string\n  prompt(input: {\n    messages: unknown[]\n    signal?: AbortSignal\n  }): AsyncIterable<StreamEvent>\n  cancel(): Promise<void>\n  close(): Promise<void>\n}\n\ninterface SessionState {\n  events: StreamEvent[]\n  resolveNext: ((evt: StreamEvent | undefined) => void) | null\n  done: boolean\n  active: boolean\n  /**\n   * Set by `buildSession.prompt()` for the duration of an in-flight turn\n   * when a watchdog timer is armed; cleared once that turn settles. Lets\n   * the `sessionUpdate` handler (which only has a `sessionId`, not a\n   * closure over the turn's timer) bump the SAME timer an incoming\n   * notification is liveness evidence for.\n   */\n  resetWatchdogTimer?: () => void\n}\n\nexport async function createAcpClient(\n  options: AcpClientOptions,\n): Promise<AcpClient> {\n  const sessions = new Map<string, SessionState>()\n\n  const stream: Stream = ndJsonStream(options.output, options.input)\n\n  const connection: ClientSideConnection = new ClientSideConnection(\n    () => buildClientHandlers(options.handlers ?? {}, sessions, options.onActivity),\n    stream,\n  )\n\n  const initResponse = await connection.initialize({\n    protocolVersion: options.protocolVersion ?? PROTOCOL_VERSION_DEFAULT,\n    clientCapabilities: clientCapabilitiesFromOptions(options),\n    clientInfo: options.clientInfo\n      ? {\n          name: options.clientInfo.name,\n          title: options.clientInfo.title ?? options.clientInfo.name,\n          version: options.clientInfo.version ?? \"0.0.0\",\n        }\n      : undefined,\n  } as never)\n\n  return {\n    connection,\n    agentCapabilities: (initResponse as { agentCapabilities?: Record<string, unknown> })\n      .agentCapabilities,\n    async newSession(params) {\n      const response = await connection.newSession({\n        cwd: params.cwd,\n        mcpServers: toAcpMcpServers(params.mcpServers ?? []) as never,\n      } as never)\n      options.onActivity?.()\n      const sessionId = (response as { sessionId: string }).sessionId\n      const state: SessionState = {\n        events: [],\n        resolveNext: null,\n        done: false,\n        active: false,\n      }\n      sessions.set(sessionId, state)\n      // Apply model + effort via session/set_config_option immediately\n      // after newSession. The claude-agent-acp wrapper handles these as\n      // configId:\"model\" and configId:\"effort\". Both are optional — when\n      // omitted the agent keeps its own defaults (which vary by model).\n      // We call these sequentially so a model switch (which rebuilds the\n      // effort options) always precedes the effort set.\n      if (params.model) {\n        await connection.setSessionConfigOption({\n          configId: \"model\",\n          value: params.model,\n          sessionId,\n        } as never)\n        options.onActivity?.()\n      }\n      if (params.effort) {\n        try {\n          await connection.setSessionConfigOption({\n            configId: \"effort\",\n            value: params.effort,\n            sessionId,\n          } as never)\n          options.onActivity?.()\n        } catch (err) {\n          // Best-effort: this ACP server does not support the \"effort\" config\n          // option (e.g. claude-agent-acp ignores unknown config keys and\n          // some versions reject them outright). A rejected set_config_option\n          // must never kill the spawn — effort is silently ignored instead.\n          console.warn(\n            `[acp] set_config_option effort=\"${params.effort}\" rejected by server (best-effort):`,\n            err instanceof Error ? err.message : err,\n          )\n        }\n      }\n      return buildSession(\n        connection,\n        sessionId,\n        state,\n        sessions,\n        options.onActivity,\n        options.turnIdleTimeoutMs,\n      )\n    },\n    async loadSession(params) {\n      // SDK returns `LoadSessionResponse` (no body fields we need); the\n      // sessionId is what the caller already provided. We register a\n      // fresh `SessionState` so subsequent `prompt` calls have a slot\n      // to flush events into — same lifecycle shape as a brand-new\n      // session.\n      await connection.loadSession({\n        sessionId: params.sessionId,\n        cwd: params.cwd,\n        mcpServers: toAcpMcpServers(params.mcpServers ?? []) as never,\n      } as never)\n      options.onActivity?.()\n      const state: SessionState = {\n        events: [],\n        resolveNext: null,\n        done: false,\n        active: false,\n      }\n      sessions.set(params.sessionId, state)\n      return buildSession(\n        connection,\n        params.sessionId,\n        state,\n        sessions,\n        options.onActivity,\n        options.turnIdleTimeoutMs,\n      )\n    },\n    async close() {\n      sessions.clear()\n    },\n  }\n}\n\nfunction clientCapabilitiesFromOptions(\n  options: AcpClientOptions,\n): Record<string, unknown> {\n  const caps = options.capabilities ?? {}\n  return {\n    fs: {\n      readTextFile: caps.fs?.readTextFile ?? false,\n      writeTextFile: caps.fs?.writeTextFile ?? false,\n    },\n    terminal: caps.terminal ?? false,\n  }\n}\n\nfunction buildSession(\n  connection: ClientSideConnection,\n  sessionId: string,\n  state: SessionState,\n  sessions: Map<string, SessionState>,\n  onActivity?: () => void,\n  turnIdleTimeoutMs?: number,\n): AcpClientSession {\n  return {\n    sessionId,\n    prompt(input) {\n      if (state.active) {\n        throw new Error(\n          `AcpClientSession.prompt: session ${sessionId} already has an in-flight prompt`,\n        )\n      }\n      state.active = true\n      state.done = false\n      state.events.length = 0\n\n      const iter = makeIterator(state)\n\n      // Turn-idle watchdog — undefined turnIdleTimeoutMs disables it\n      // entirely (existing callers see no behavior change). Armed below\n      // and re-armed on every activity signal observed during this turn\n      // (outbound send, resolve, and incoming session/update via\n      // `state.resetWatchdogTimer`); cleared once the turn settles.\n      let watchdogTimer: ReturnType<typeof setTimeout> | undefined\n      let watchdogFired = false\n      const clearWatchdogTimer = () => {\n        if (watchdogTimer) clearTimeout(watchdogTimer)\n        watchdogTimer = undefined\n      }\n      const armWatchdogTimer = () => {\n        if (turnIdleTimeoutMs === undefined) return\n        clearWatchdogTimer()\n        watchdogTimer = setTimeout(() => {\n          watchdogFired = true\n          state.done = true\n          enqueue(state, { kind: \"turn-end\", sessionId, reason: \"watchdog-timeout\" })\n        }, turnIdleTimeoutMs)\n      }\n      state.resetWatchdogTimer = armWatchdogTimer\n\n      // Outbound send — proves the daemon is still driving this turn,\n      // independent of whatever StreamEvents come back. Also the initial\n      // arm of the watchdog timer, so the timeout is measured from \"we\n      // just sent this\" rather than some earlier idle point.\n      armWatchdogTimer()\n      onActivity?.()\n      const promise = connection\n        .prompt({\n          sessionId,\n          prompt: input.messages as never,\n        } as never)\n        .then((response) => {\n          clearWatchdogTimer()\n          onActivity?.()\n          if (watchdogFired) {\n            console.warn(\n              `[acp] session ${sessionId}: connection.prompt() resolved after the ` +\n                `turn-idle watchdog already synthesized a turn-end — ignoring late response.`,\n            )\n            return\n          }\n          enqueue(state, {\n            kind: \"turn-end\",\n            sessionId,\n            reason:\n              ((response as { stopReason?: string }).stopReason ===\n                \"cancelled\" && \"cancelled\") ||\n              ((response as { stopReason?: string }).stopReason ===\n                \"max_turns\" && \"max_turns\") ||\n              \"completed\",\n          })\n        })\n        .catch((err: unknown) => {\n          clearWatchdogTimer()\n          if (watchdogFired) {\n            console.warn(\n              `[acp] session ${sessionId}: connection.prompt() rejected after the ` +\n                `turn-idle watchdog already synthesized a turn-end — ignoring late error:`,\n              err instanceof Error ? err.message : err,\n            )\n            return\n          }\n          const message =\n            err instanceof Error ? err.message : String(err)\n          enqueue(state, {\n            kind: \"error\",\n            sessionId,\n            error: { message },\n          })\n        })\n        .finally(() => {\n          state.active = false\n          state.done = true\n          state.resetWatchdogTimer = undefined\n          clearWatchdogTimer()\n          flush(state)\n        })\n\n      if (input.signal) {\n        input.signal.addEventListener(\n          \"abort\",\n          () => {\n            void connection.cancel({ sessionId } as never)\n          },\n          { once: true },\n        )\n      }\n\n      void promise\n      return iter\n    },\n    async cancel() {\n      if (!state.active) return\n      await connection.cancel({ sessionId } as never)\n      onActivity?.()\n    },\n    async close() {\n      sessions.delete(sessionId)\n    },\n  }\n}\n\nfunction makeIterator(state: SessionState): AsyncIterable<StreamEvent> {\n  return {\n    [Symbol.asyncIterator]() {\n      return {\n        async next() {\n          if (state.events.length > 0) {\n            const value = state.events.shift() as StreamEvent\n            return { value, done: false }\n          }\n          if (state.done) return { value: undefined, done: true }\n          const value = await new Promise<StreamEvent | undefined>(\n            (resolve) => {\n              state.resolveNext = resolve\n            },\n          )\n          if (value === undefined) return { value: undefined, done: true }\n          return { value, done: false }\n        },\n      }\n    },\n  }\n}\n\nfunction enqueue(state: SessionState, event: StreamEvent) {\n  if (state.resolveNext) {\n    const r = state.resolveNext\n    state.resolveNext = null\n    r(event)\n    return\n  }\n  state.events.push(event)\n}\n\nfunction flush(state: SessionState) {\n  if (state.resolveNext) {\n    const r = state.resolveNext\n    state.resolveNext = null\n    r(undefined)\n  }\n}\n\nfunction buildClientHandlers(\n  partial: Partial<AcpClientHandlers>,\n  sessions: Map<string, SessionState>,\n  onActivity?: () => void,\n): AcpClientHandlers {\n  return {\n    async sessionUpdate(params) {\n      // Every notification is a liveness signal, even ones that don't\n      // translate into a StreamEvent below (e.g. an in-progress\n      // tool_call_update) — this is the gap that leaves lastOutputAt\n      // stale during a long internal tool-call chain.\n      onActivity?.()\n\n      const sid = (params as { sessionId?: string }).sessionId\n      if (!sid) return\n      const state = sessions.get(sid)\n      if (!state) return\n\n      // Reset this session's in-flight turn watchdog (if any) — an\n      // incoming notification is exactly the \"not silent\" signal the\n      // watchdog exists to detect the absence of.\n      state.resetWatchdogTimer?.()\n\n      const update = (params as { update?: Record<string, unknown> }).update\n      if (!update) return\n      const event = translateSessionUpdate(sid, update)\n      if (event) enqueue(state, event)\n\n      if (partial.sessionUpdate) await partial.sessionUpdate(params)\n    },\n    async requestPermission(params) {\n      if (partial.requestPermission) return partial.requestPermission(params)\n      throw new Error(\"AcpClient.requestPermission: no handler configured\")\n    },\n    async readTextFile(params) {\n      if (partial.readTextFile) return partial.readTextFile(params)\n      throw new Error(\"AcpClient.readTextFile: capability not advertised\")\n    },\n    async writeTextFile(params) {\n      if (partial.writeTextFile) return partial.writeTextFile(params)\n      throw new Error(\"AcpClient.writeTextFile: capability not advertised\")\n    },\n    ...(partial as object),\n  } as AcpClientHandlers\n}\n\nfunction translateSessionUpdate(\n  sessionId: string,\n  update: Record<string, unknown>,\n): StreamEvent | null {\n  switch (update.sessionUpdate) {\n    case \"agent_message_chunk\":\n      return {\n        kind: \"text-delta\",\n        sessionId,\n        text: extractText(update.content),\n      }\n    case \"agent_thought_chunk\":\n      return {\n        kind: \"thought\",\n        sessionId,\n        text: extractText(update.content),\n      }\n    case \"tool_call\": {\n      const toolCallId = (update.toolCallId as string) ?? \"\"\n      // `title` is the descriptive label an agent gives a tool call\n      // (\"Reading src/foo.ts\") — prefer it over the coarse `kind`\n      // bucket (read/edit/search/execute/…) so rendered lines are\n      // informative instead of generic.\n      const toolName =\n        (update.title as string) ?? (update.kind as string) ?? \"tool\"\n      const locations = update.locations as\n        | Array<{ path: string; line?: number | null }>\n        | undefined\n      let args: unknown = update.rawInput ?? update.content ?? {}\n      // Some tool calls (e.g. a bare \"read\" with no structured input)\n      // carry only `locations` — fold the file paths into `arguments`\n      // so they survive downstream instead of being dropped.\n      if (update.rawInput == null && locations && locations.length > 0) {\n        args =\n          locations.length === 1\n            ? {\n                path: locations[0]!.path,\n                ...(locations[0]!.line != null\n                  ? { line: locations[0]!.line }\n                  : {}),\n              }\n            : { paths: locations.map((location) => location.path) }\n      }\n      return {\n        kind: \"tool-call\",\n        sessionId,\n        toolCallId,\n        toolName,\n        arguments: args,\n      }\n    }\n    case \"tool_call_update\": {\n      const status = update.status as string | undefined\n      if (status === \"completed\" || status === \"failed\") {\n        return {\n          kind: \"tool-result\",\n          sessionId,\n          toolCallId: (update.toolCallId as string) ?? \"\",\n          result: update.rawOutput ?? update.content ?? null,\n          isError: status === \"failed\",\n        }\n      }\n      return null\n    }\n    case \"plan\": {\n      const entries = (update.entries as Array<Record<string, unknown>>) ?? []\n      return {\n        kind: \"plan\",\n        sessionId,\n        entries: entries.map((entry) => ({\n          content: (entry.content as string) ?? \"\",\n          priority: (entry.priority as \"high\" | \"medium\" | \"low\") ?? \"medium\",\n          status:\n            (entry.status as \"pending\" | \"in_progress\" | \"completed\") ??\n            \"pending\",\n        })),\n      }\n    }\n    case \"usage_update\": {\n      const cost = update.cost as { amount: number; currency: string } | null | undefined\n      return {\n        kind: \"usage_update\",\n        sessionId,\n        size: (update.size as number) ?? 0,\n        used: (update.used as number) ?? 0,\n        ...(cost ? { cost } : {}),\n      }\n    }\n    case \"user_message_chunk\":\n      return null\n    default:\n      return null\n  }\n}\n\nfunction extractText(content: unknown): string {\n  if (!content) return \"\"\n  if (typeof content === \"string\") return content\n  if (typeof content === \"object\" && content !== null) {\n    const c = content as { type?: string; text?: string }\n    if (c.type === \"text\" && typeof c.text === \"string\") return c.text\n  }\n  return \"\"\n}\n"]}
+{"version":3,"sources":["../../src/client/index.ts"],"names":["value"],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * AIP-44 ACP client — drives a subprocess agent via stdio JSON-RPC.\n *\n * Wraps `@agentclientprotocol/sdk`'s `ClientSideConnection`. Owns the\n * connection lifecycle, runs `initialize` on construction, and exposes\n * a session API where each `prompt()` call returns an\n * `AsyncIterable<StreamEvent>` fed by the SDK's `session/update`\n * notification handler.\n */\n\nimport {\n  ClientSideConnection,\n  ndJsonStream,\n  type Client as AcpClientHandlers,\n  type Stream,\n} from \"@agentclientprotocol/sdk\"\nimport type { AcpMcpServer, StreamEvent } from \"../types.js\"\n\nconst PROTOCOL_VERSION_DEFAULT = 1\n\n/**\n * Map our internal `AcpMcpServer` (`{ name, transport, ref, headers, credentialRef }`)\n * onto the `@agentclientprotocol/sdk` wire shape expected by\n * `session/new.mcpServers` (and `session/load.mcpServers`).\n *\n * The ACP `McpServer` union is transport-tagged and field-named\n * differently from our compact internal form:\n *   - http → `{ type: \"http\", name, url, headers: [{ name, value }, …] }`\n *   - sse  → `{ type: \"sse\",  name, url, headers: [{ name, value }, …] }`\n *   - stdio → `{ name, command, args: [], env: [] }` (untagged variant)\n *\n * Without this mapping the raw `{ transport, ref }` entry reaches the\n * agent verbatim and `session/new` rejects with `Invalid params` — the\n * symptom that broke orchestrator spawns (the auto-injected scoped\n * gateway is an `http` entry).\n *\n * Retro-compat: an entry that already carries an ACP-native discriminator\n * (`type`/`url`/`command`) is passed through untouched, so callers that\n * pre-shape their entries keep working.\n */\nexport function toAcpMcpServers(servers: readonly unknown[]): unknown[] {\n  return servers.map(toAcpMcpServer)\n}\n\nfunction toAcpMcpServer(server: unknown): unknown {\n  if (!server || typeof server !== \"object\") return server\n  const entry = server as Record<string, unknown>\n\n  // Already ACP-native (has a wire discriminator) → leave as-is.\n  if (\"type\" in entry || \"url\" in entry || \"command\" in entry) return entry\n\n  const transport = entry.transport\n  // Not our `{ name, transport, ref }` shape → nothing to map.\n  if (typeof transport !== \"string\") return entry\n\n  const name = entry.name\n  const ref = entry.ref\n  const headers = entry.headers\n\n  switch (transport) {\n    case \"http\":\n      return { type: \"http\", name, url: ref ?? \"\", headers: toAcpHeaders(headers) }\n    case \"sse\":\n      return { type: \"sse\", name, url: ref ?? \"\", headers: toAcpHeaders(headers) }\n    case \"stdio\":\n      return { name, command: ref ?? \"\", args: [], env: [] }\n    default:\n      return entry\n  }\n}\n\nfunction toAcpHeaders(headers: unknown): Array<{ name: string; value: string }> {\n  if (!headers || typeof headers !== \"object\") return []\n  return Object.entries(headers).map(([name, value]) => ({\n    name,\n    value: typeof value === \"string\" ? value : String(value),\n  }))\n}\n\nexport interface AcpClientOptions {\n  /** Output bytes go here (subprocess stdin). */\n  output: WritableStream<Uint8Array>\n  /** Input bytes come from here (subprocess stdout). */\n  input: ReadableStream<Uint8Array>\n  /** Client identity advertised during `initialize`. */\n  clientInfo?: {\n    name: string\n    title?: string\n    version?: string\n  }\n  /** Client capabilities advertised during `initialize`. */\n  capabilities?: {\n    fs?: { readTextFile?: boolean; writeTextFile?: boolean }\n    terminal?: boolean\n  }\n  /** Optional handlers for agent-initiated requests beyond fs / terminal. */\n  handlers?: Partial<AcpClientHandlers>\n  /** Protocol version to negotiate. Defaults to the SDK's current. */\n  protocolVersion?: number\n  /**\n   * Called on ANY JSON-RPC traffic with the child agent process — every\n   * incoming `session/update` notification (even ones that\n   * `translateSessionUpdate` maps to `null`, e.g. a `tool_call_update`\n   * still in progress) and every outbound RPC call this client makes\n   * (`newSession`, `loadSession`, `setSessionConfigOption`, `prompt`,\n   * `cancel`). Distinct from the `StreamEvent` stream: fires even\n   * during gaps where no event is produced, so a host can track\n   * liveness independent of what the agent actually says.\n   */\n  onActivity?: () => void\n  /**\n   * Turn-idle watchdog: if a `prompt()` call goes this many ms with NO\n   * activity signal (see `onActivity` above — incoming `session/update`\n   * notifications, outbound RPCs) and the underlying `connection.prompt()`\n   * promise still hasn't resolved, synthesize a `turn-end` event with\n   * `reason: \"watchdog-timeout\"` so the caller's async iterator completes\n   * instead of hanging forever. The timer resets on every activity signal\n   * observed DURING that turn, so a legitimately long tool-call chain\n   * (still producing activity, just no user-visible output) never\n   * false-positives — this is \"N ms of true silence,\" not \"N ms since the\n   * turn started.\"\n   *\n   * Undefined (the default) disables the watchdog entirely — existing\n   * callers see no behavior change. If the real `connection.prompt()`\n   * eventually settles after the synthetic turn-end was already emitted,\n   * the late result is logged and discarded (no crash, no duplicate\n   * turn-end for the same logical turn).\n   */\n  turnIdleTimeoutMs?: number\n}\n\nexport interface AcpClient {\n  readonly connection: ClientSideConnection\n  /** Negotiated agent capabilities returned from `initialize`. */\n  readonly agentCapabilities: Record<string, unknown> | undefined\n  newSession(params: {\n    cwd: string\n    mcpServers?: unknown[]\n    /**\n     * Model to select via `session/set_config_option` immediately after\n     * `newSession`. The claude-agent-acp wrapper supports this as\n     * `configId:\"model\"`. Omit to keep the agent's own default.\n     *\n     * Best-effort: a value the agent can't resolve (a stale/gated/typo'd id)\n     * is warned about and dropped — the session still starts on the agent's\n     * default model rather than crashing the spawn. See the reject handler\n     * in `newSession` for the reasoning (agentproto#186).\n     */\n    model?: string\n    /**\n     * Effort level to select via `session/set_config_option` after\n     * `newSession`. Effort is model-dependent — same label ≠ same\n     * budget across models; defaults differ too (see AgentCliConnectOptions).\n     * Omit to keep the model's own default.\n     */\n    effort?: string\n    /**\n     * Mode to select via `session/set_config_option` after `newSession`,\n     * for ACP servers that model mode selection as a session config\n     * option (`configId:\"mode\"`) instead of a CLI flag — e.g. opencode.\n     * Best-effort, same as `model`/`effort`: a rejection is warned about\n     * and dropped rather than failing the spawn. Omit to keep the\n     * agent's own default mode.\n     */\n    mode?: string\n  }): Promise<AcpClientSession>\n  /**\n   * Reattach to an existing session by id. Available only when the\n   * agent advertised `loadSession: true` in its capabilities (callers\n   * should check `agentCapabilities` first; we forward the SDK error\n   * verbatim if they don't).\n   *\n   * Drives the AIP-45 native-resume continuation strategy: the host\n   * persists the `sessionId` returned by `newSession`, then on a\n   * cold start (process restart, fresh sandbox, different machine)\n   * spawns a new subprocess and calls `loadSession` to pick up\n   * the conversation from the stored history.\n   */\n  loadSession(params: {\n    sessionId: string\n    cwd: string\n    mcpServers?: unknown[]\n  }): Promise<AcpClientSession>\n  close(): Promise<void>\n}\n\nexport interface AcpClientSession {\n  readonly sessionId: string\n  prompt(input: {\n    messages: unknown[]\n    signal?: AbortSignal\n  }): AsyncIterable<StreamEvent>\n  cancel(): Promise<void>\n  close(): Promise<void>\n}\n\ninterface SessionState {\n  events: StreamEvent[]\n  resolveNext: ((evt: StreamEvent | undefined) => void) | null\n  done: boolean\n  active: boolean\n  /**\n   * Set by `buildSession.prompt()` for the duration of an in-flight turn\n   * when a watchdog timer is armed; cleared once that turn settles. Lets\n   * the `sessionUpdate` handler (which only has a `sessionId`, not a\n   * closure over the turn's timer) bump the SAME timer an incoming\n   * notification is liveness evidence for.\n   */\n  resetWatchdogTimer?: () => void\n}\n\nexport async function createAcpClient(\n  options: AcpClientOptions,\n): Promise<AcpClient> {\n  const sessions = new Map<string, SessionState>()\n\n  const stream: Stream = ndJsonStream(options.output, options.input)\n\n  const connection: ClientSideConnection = new ClientSideConnection(\n    () => buildClientHandlers(options.handlers ?? {}, sessions, options.onActivity),\n    stream,\n  )\n\n  const initResponse = await connection.initialize({\n    protocolVersion: options.protocolVersion ?? PROTOCOL_VERSION_DEFAULT,\n    clientCapabilities: clientCapabilitiesFromOptions(options),\n    clientInfo: options.clientInfo\n      ? {\n          name: options.clientInfo.name,\n          title: options.clientInfo.title ?? options.clientInfo.name,\n          version: options.clientInfo.version ?? \"0.0.0\",\n        }\n      : undefined,\n  } as never)\n\n  return {\n    connection,\n    agentCapabilities: (initResponse as { agentCapabilities?: Record<string, unknown> })\n      .agentCapabilities,\n    async newSession(params) {\n      const response = await connection.newSession({\n        cwd: params.cwd,\n        mcpServers: toAcpMcpServers(params.mcpServers ?? []) as never,\n      } as never)\n      options.onActivity?.()\n      const sessionId = (response as { sessionId: string }).sessionId\n      const state: SessionState = {\n        events: [],\n        resolveNext: null,\n        done: false,\n        active: false,\n      }\n      sessions.set(sessionId, state)\n      // Apply model + effort via session/set_config_option immediately\n      // after newSession. The claude-agent-acp wrapper handles these as\n      // configId:\"model\" and configId:\"effort\". Both are optional — when\n      // omitted the agent keeps its own defaults (which vary by model).\n      // We call these sequentially so a model switch (which rebuilds the\n      // effort options) always precedes the effort set.\n      if (params.model) {\n        try {\n          await connection.setSessionConfigOption({\n            configId: \"model\",\n            value: params.model,\n            sessionId,\n          } as never)\n          options.onActivity?.()\n        } catch (err) {\n          // Non-fatal by design. claude-agent-acp validates the requested\n          // model against the concrete option ids it advertises for THIS\n          // session (e.g. \"default\", \"opus[1m]\", \"sonnet\", \"claude-sonnet-5\",\n          // \"haiku\") and rejects anything it can't resolve — including stale\n          // or gated ids like \"claude-sonnet-4-6\" — with a JSON-RPC -32603\n          // whose only useful text is buried in `error.data.details`\n          // (\"Invalid value for config option model: <id>\"). Letting that\n          // reject `newSession` turned a bad model id into an opaque\n          // \"spawn failed — Internal error\" that killed the whole session\n          // (agentproto#186). The accepted vocabulary is dynamic (it varies\n          // by wrapper version and account entitlements), so there is no\n          // version-stable way to know it before the call — a rejected model\n          // must therefore never be fatal. This is NOT a silent drop: the\n          // requested id AND the server's own reason are logged, and the\n          // session continues on the agent's default model.\n          console.warn(\n            `[acp] set_config_option model=\"${params.model}\" rejected by server ` +\n              `— keeping the agent's default model. Reason: ${configOptionErrorDetail(err)}`,\n          )\n        }\n      }\n      if (params.effort) {\n        try {\n          await connection.setSessionConfigOption({\n            configId: \"effort\",\n            value: params.effort,\n            sessionId,\n          } as never)\n          options.onActivity?.()\n        } catch (err) {\n          // Best-effort: this ACP server does not support the \"effort\" config\n          // option (e.g. claude-agent-acp ignores unknown config keys and\n          // some versions reject them outright). A rejected set_config_option\n          // must never kill the spawn — effort is silently ignored instead.\n          console.warn(\n            `[acp] set_config_option effort=\"${params.effort}\" rejected by server ` +\n              `(best-effort): ${configOptionErrorDetail(err)}`,\n          )\n        }\n      }\n      if (params.mode) {\n        try {\n          await connection.setSessionConfigOption({\n            configId: \"mode\",\n            value: params.mode,\n            sessionId,\n          } as never)\n          options.onActivity?.()\n        } catch (err) {\n          // Best-effort: this ACP server does not support the \"mode\" config\n          // option, or doesn't recognize the requested mode id. A rejected\n          // set_config_option must never kill the spawn — mode is silently\n          // ignored (the session keeps whatever mode the agent defaults to).\n          console.warn(\n            `[acp] set_config_option mode=\"${params.mode}\" rejected by server ` +\n              `(best-effort): ${configOptionErrorDetail(err)}`,\n          )\n        }\n      }\n      return buildSession(\n        connection,\n        sessionId,\n        state,\n        sessions,\n        options.onActivity,\n        options.turnIdleTimeoutMs,\n      )\n    },\n    async loadSession(params) {\n      // SDK returns `LoadSessionResponse` (no body fields we need); the\n      // sessionId is what the caller already provided. We register a\n      // fresh `SessionState` so subsequent `prompt` calls have a slot\n      // to flush events into — same lifecycle shape as a brand-new\n      // session.\n      await connection.loadSession({\n        sessionId: params.sessionId,\n        cwd: params.cwd,\n        mcpServers: toAcpMcpServers(params.mcpServers ?? []) as never,\n      } as never)\n      options.onActivity?.()\n      const state: SessionState = {\n        events: [],\n        resolveNext: null,\n        done: false,\n        active: false,\n      }\n      sessions.set(params.sessionId, state)\n      return buildSession(\n        connection,\n        params.sessionId,\n        state,\n        sessions,\n        options.onActivity,\n        options.turnIdleTimeoutMs,\n      )\n    },\n    async close() {\n      sessions.clear()\n    },\n  }\n}\n\nfunction clientCapabilitiesFromOptions(\n  options: AcpClientOptions,\n): Record<string, unknown> {\n  const caps = options.capabilities ?? {}\n  return {\n    fs: {\n      readTextFile: caps.fs?.readTextFile ?? false,\n      writeTextFile: caps.fs?.writeTextFile ?? false,\n    },\n    terminal: caps.terminal ?? false,\n  }\n}\n\nfunction buildSession(\n  connection: ClientSideConnection,\n  sessionId: string,\n  state: SessionState,\n  sessions: Map<string, SessionState>,\n  onActivity?: () => void,\n  turnIdleTimeoutMs?: number,\n): AcpClientSession {\n  return {\n    sessionId,\n    prompt(input) {\n      if (state.active) {\n        throw new Error(\n          `AcpClientSession.prompt: session ${sessionId} already has an in-flight prompt`,\n        )\n      }\n      state.active = true\n      state.done = false\n      state.events.length = 0\n\n      const iter = makeIterator(state)\n\n      // Turn-idle watchdog — undefined turnIdleTimeoutMs disables it\n      // entirely (existing callers see no behavior change). Armed below\n      // and re-armed on every activity signal observed during this turn\n      // (outbound send, resolve, and incoming session/update via\n      // `state.resetWatchdogTimer`); cleared once the turn settles.\n      let watchdogTimer: ReturnType<typeof setTimeout> | undefined\n      let watchdogFired = false\n      const clearWatchdogTimer = () => {\n        if (watchdogTimer) clearTimeout(watchdogTimer)\n        watchdogTimer = undefined\n      }\n      const armWatchdogTimer = () => {\n        if (turnIdleTimeoutMs === undefined) return\n        clearWatchdogTimer()\n        watchdogTimer = setTimeout(() => {\n          watchdogFired = true\n          state.done = true\n          enqueue(state, { kind: \"turn-end\", sessionId, reason: \"watchdog-timeout\" })\n        }, turnIdleTimeoutMs)\n      }\n      state.resetWatchdogTimer = armWatchdogTimer\n\n      // Outbound send — proves the daemon is still driving this turn,\n      // independent of whatever StreamEvents come back. Also the initial\n      // arm of the watchdog timer, so the timeout is measured from \"we\n      // just sent this\" rather than some earlier idle point.\n      armWatchdogTimer()\n      onActivity?.()\n      const promise = connection\n        .prompt({\n          sessionId,\n          prompt: input.messages as never,\n        } as never)\n        .then((response) => {\n          clearWatchdogTimer()\n          onActivity?.()\n          if (watchdogFired) {\n            console.warn(\n              `[acp] session ${sessionId}: connection.prompt() resolved after the ` +\n                `turn-idle watchdog already synthesized a turn-end — ignoring late response.`,\n            )\n            return\n          }\n          enqueue(state, {\n            kind: \"turn-end\",\n            sessionId,\n            reason:\n              ((response as { stopReason?: string }).stopReason ===\n                \"cancelled\" && \"cancelled\") ||\n              ((response as { stopReason?: string }).stopReason ===\n                \"max_turns\" && \"max_turns\") ||\n              \"completed\",\n          })\n        })\n        .catch((err: unknown) => {\n          clearWatchdogTimer()\n          if (watchdogFired) {\n            console.warn(\n              `[acp] session ${sessionId}: connection.prompt() rejected after the ` +\n                `turn-idle watchdog already synthesized a turn-end — ignoring late error:`,\n              err instanceof Error ? err.message : err,\n            )\n            return\n          }\n          const message =\n            err instanceof Error ? err.message : String(err)\n          enqueue(state, {\n            kind: \"error\",\n            sessionId,\n            error: { message },\n          })\n        })\n        .finally(() => {\n          state.active = false\n          state.done = true\n          state.resetWatchdogTimer = undefined\n          clearWatchdogTimer()\n          flush(state)\n        })\n\n      if (input.signal) {\n        input.signal.addEventListener(\n          \"abort\",\n          () => {\n            void connection.cancel({ sessionId } as never)\n          },\n          { once: true },\n        )\n      }\n\n      void promise\n      return iter\n    },\n    async cancel() {\n      if (!state.active) return\n      await connection.cancel({ sessionId } as never)\n      onActivity?.()\n    },\n    async close() {\n      sessions.delete(sessionId)\n    },\n  }\n}\n\nfunction makeIterator(state: SessionState): AsyncIterable<StreamEvent> {\n  return {\n    [Symbol.asyncIterator]() {\n      return {\n        async next() {\n          if (state.events.length > 0) {\n            const value = state.events.shift() as StreamEvent\n            return { value, done: false }\n          }\n          if (state.done) return { value: undefined, done: true }\n          const value = await new Promise<StreamEvent | undefined>(\n            (resolve) => {\n              state.resolveNext = resolve\n            },\n          )\n          if (value === undefined) return { value: undefined, done: true }\n          return { value, done: false }\n        },\n      }\n    },\n  }\n}\n\nfunction enqueue(state: SessionState, event: StreamEvent) {\n  if (state.resolveNext) {\n    const r = state.resolveNext\n    state.resolveNext = null\n    r(event)\n    return\n  }\n  state.events.push(event)\n}\n\nfunction flush(state: SessionState) {\n  if (state.resolveNext) {\n    const r = state.resolveNext\n    state.resolveNext = null\n    r(undefined)\n  }\n}\n\nfunction buildClientHandlers(\n  partial: Partial<AcpClientHandlers>,\n  sessions: Map<string, SessionState>,\n  onActivity?: () => void,\n): AcpClientHandlers {\n  return {\n    async sessionUpdate(params) {\n      // Every notification is a liveness signal, even ones that don't\n      // translate into a StreamEvent below (e.g. an in-progress\n      // tool_call_update) — this is the gap that leaves lastOutputAt\n      // stale during a long internal tool-call chain.\n      onActivity?.()\n\n      const sid = (params as { sessionId?: string }).sessionId\n      if (!sid) return\n      const state = sessions.get(sid)\n      if (!state) return\n\n      // Reset this session's in-flight turn watchdog (if any) — an\n      // incoming notification is exactly the \"not silent\" signal the\n      // watchdog exists to detect the absence of.\n      state.resetWatchdogTimer?.()\n\n      const update = (params as { update?: Record<string, unknown> }).update\n      if (!update) return\n      const event = translateSessionUpdate(sid, update)\n      if (event) enqueue(state, event)\n\n      if (partial.sessionUpdate) await partial.sessionUpdate(params)\n    },\n    async requestPermission(params) {\n      if (partial.requestPermission) return partial.requestPermission(params)\n      throw new Error(\"AcpClient.requestPermission: no handler configured\")\n    },\n    async readTextFile(params) {\n      if (partial.readTextFile) return partial.readTextFile(params)\n      throw new Error(\"AcpClient.readTextFile: capability not advertised\")\n    },\n    async writeTextFile(params) {\n      if (partial.writeTextFile) return partial.writeTextFile(params)\n      throw new Error(\"AcpClient.writeTextFile: capability not advertised\")\n    },\n    ...(partial as object),\n  } as AcpClientHandlers\n}\n\nfunction translateSessionUpdate(\n  sessionId: string,\n  update: Record<string, unknown>,\n): StreamEvent | null {\n  switch (update.sessionUpdate) {\n    case \"agent_message_chunk\":\n      return {\n        kind: \"text-delta\",\n        sessionId,\n        text: extractText(update.content),\n      }\n    case \"agent_thought_chunk\":\n      return {\n        kind: \"thought\",\n        sessionId,\n        text: extractText(update.content),\n      }\n    case \"tool_call\": {\n      const toolCallId = (update.toolCallId as string) ?? \"\"\n      // `title` is the descriptive label an agent gives a tool call\n      // (\"Reading src/foo.ts\") — prefer it over the coarse `kind`\n      // bucket (read/edit/search/execute/…) so rendered lines are\n      // informative instead of generic.\n      const toolName =\n        (update.title as string) ?? (update.kind as string) ?? \"tool\"\n      const locations = update.locations as\n        | Array<{ path: string; line?: number | null }>\n        | undefined\n      let args: unknown = update.rawInput ?? update.content ?? {}\n      // Some tool calls (e.g. a bare \"read\" with no structured input)\n      // carry only `locations` — fold the file paths into `arguments`\n      // so they survive downstream instead of being dropped.\n      if (update.rawInput == null && locations && locations.length > 0) {\n        args =\n          locations.length === 1\n            ? {\n                path: locations[0]!.path,\n                ...(locations[0]!.line != null\n                  ? { line: locations[0]!.line }\n                  : {}),\n              }\n            : { paths: locations.map((location) => location.path) }\n      }\n      return {\n        kind: \"tool-call\",\n        sessionId,\n        toolCallId,\n        toolName,\n        arguments: args,\n      }\n    }\n    case \"tool_call_update\": {\n      const status = update.status as string | undefined\n      if (status === \"completed\" || status === \"failed\") {\n        return {\n          kind: \"tool-result\",\n          sessionId,\n          toolCallId: (update.toolCallId as string) ?? \"\",\n          result: update.rawOutput ?? update.content ?? null,\n          isError: status === \"failed\",\n        }\n      }\n      return null\n    }\n    case \"plan\": {\n      const entries = (update.entries as Array<Record<string, unknown>>) ?? []\n      return {\n        kind: \"plan\",\n        sessionId,\n        entries: entries.map((entry) => ({\n          content: (entry.content as string) ?? \"\",\n          priority: (entry.priority as \"high\" | \"medium\" | \"low\") ?? \"medium\",\n          status:\n            (entry.status as \"pending\" | \"in_progress\" | \"completed\") ??\n            \"pending\",\n        })),\n      }\n    }\n    case \"usage_update\": {\n      const cost = update.cost as { amount: number; currency: string } | null | undefined\n      // Accept both camelCase and snake_case token fields — agents differ on\n      // the convention and this update kind is non-standard ACP.\n      const numeric = (...keys: string[]): number | undefined => {\n        for (const key of keys) {\n          const v = update[key]\n          if (typeof v === \"number\") return v\n        }\n        return undefined\n      }\n      const tokensIn = numeric(\"tokensIn\", \"input_tokens\", \"inputTokens\")\n      const tokensOut = numeric(\"tokensOut\", \"output_tokens\", \"outputTokens\")\n      return {\n        kind: \"usage_update\",\n        sessionId,\n        size: (update.size as number) ?? 0,\n        used: (update.used as number) ?? 0,\n        ...(cost ? { cost } : {}),\n        ...(tokensIn !== undefined ? { tokensIn } : {}),\n        ...(tokensOut !== undefined ? { tokensOut } : {}),\n      }\n    }\n    case \"user_message_chunk\":\n      return null\n    default:\n      return null\n  }\n}\n\n/**\n * Best human-readable reason from a failed `session/set_config_option`.\n *\n * The ACP SDK surfaces a server-side rejection as a JSON-RPC `RequestError`\n * whose generic `message` is just \"Internal error\" (code -32603) — the useful\n * text lives in `error.data.details` (e.g. claude-agent-acp's\n * \"Invalid value for config option model: claude-sonnet-4-6\"). Prefer that\n * detail, falling back to the error's own message, then a stringified form.\n * Narrows `unknown` with `in`/`typeof` guards — no casts.\n */\nfunction configOptionErrorDetail(err: unknown): string {\n  if (typeof err === \"object\" && err !== null) {\n    if (\"data\" in err && typeof err.data === \"object\" && err.data !== null) {\n      const data = err.data\n      if (\n        \"details\" in data &&\n        typeof data.details === \"string\" &&\n        data.details.length > 0\n      ) {\n        return data.details\n      }\n    }\n    if (\n      \"message\" in err &&\n      typeof err.message === \"string\" &&\n      err.message.length > 0\n    ) {\n      return err.message\n    }\n  }\n  return String(err)\n}\n\nfunction extractText(content: unknown): string {\n  if (!content) return \"\"\n  if (typeof content === \"string\") return content\n  if (typeof content === \"object\" && content !== null) {\n    const c = content as { type?: string; text?: string }\n    if (c.type === \"text\" && typeof c.text === \"string\") return c.text\n  }\n  return \"\"\n}\n"]}

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { A as AcpDefinition } from './types-DC2phPNG.js';
-export { a as AcpAuditConfig, b as AcpCapabilities, c as AcpHandle, d as AcpMcpServer, e as AcpRole, f as AcpTier, g as AcpTransport, h as Aip44Extensions, S as StreamEvent } from './types-DC2phPNG.js';
+import { A as AcpDefinition } from './types-Sxd1kKk2.js';
+export { a as AcpAuditConfig, b as AcpCapabilities, c as AcpHandle, d as AcpMcpServer, e as AcpRole, f as AcpTier, g as AcpTransport, h as Aip44Extensions, S as StreamEvent } from './types-Sxd1kKk2.js';
 export { A as AcpFrontmatter, a as Aip44ExtensionsSchema, b as acpFrontmatterSchema } from './schema-CxWMGVy0.js';
 import 'zod';
 

package/dist/manifest/index.d.ts

@@ -1,6 +1,6 @@
 import { A as AcpFrontmatter } from '../schema-CxWMGVy0.js';
 export { b as acpFrontmatterSchema } from '../schema-CxWMGVy0.js';
-import { c as AcpHandle } from '../types-DC2phPNG.js';
+import { c as AcpHandle } from '../types-Sxd1kKk2.js';
 import 'zod';
 
 /**

package/dist/server/index.d.ts

@@ -1,5 +1,5 @@
 import { AgentSideConnection } from '@agentclientprotocol/sdk';
-import { c as AcpHandle } from '../types-DC2phPNG.js';
+import { c as AcpHandle } from '../types-Sxd1kKk2.js';
 
 /**
  * AIP-44 ACP server — exposes an AIP-9 operator to ACP-speaking clients.

package/dist/{types-DC2phPNG.d.ts → types-Sxd1kKk2.d.ts}

@@ -42,6 +42,16 @@ interface AcpMcpServer {
     name: string;
     transport: "stdio" | "http" | "sse";
     ref?: string;
+    /** Static HTTP headers sent with every request to an `http` or `sse`
+     *  MCP server. Useful for fixed auth tokens or content-negotiation
+     *  headers that are safe to embed in config. */
+    headers?: Record<string, string>;
+    /** Brokered credential path resolved at spawn time into additional
+     *  `headers` (typically an `Authorization` header). The path is passed
+     *  to the daemon's credential broker, so the actual secret never lives
+     *  in env or config. Mutually usable with `headers`; brokered headers
+     *  win on collision. */
+    credentialRef?: string;
 }
 /** AIP-44 extensions on the agentskills.io baseline. Lives under `metadata.aip44`. */
 interface Aip44Extensions {
@@ -160,6 +170,12 @@ type StreamEvent = {
         amount: number;
         currency: string;
     };
+    /** Cumulative input/output token counts, when the agent reports them
+     *  (some ACP agents send per-token usage alongside the context-window
+     *  `size`/`used`). Lets the daemon price a session that has tokens but
+     *  no adapter-reported `cost`. */
+    tokensIn?: number;
+    tokensOut?: number;
 };
 
 export type { AcpDefinition as A, StreamEvent as S, AcpAuditConfig as a, AcpCapabilities as b, AcpHandle as c, AcpMcpServer as d, AcpRole as e, AcpTier as f, AcpTransport as g, Aip44Extensions as h };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentproto/acp",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "@agentproto/acp — AIP-44 ACP.md reference implementation. An agentproto profile of the Agent Client Protocol (agentclientprotocol.com). Wraps @agentclientprotocol/sdk with createAcpClient (drives subprocess agents) and createAcpServer (exposes AIP-9 operators to ACP-speaking IDEs).",
   "keywords": [
     "agentproto",