octoflow-core 1.0.0

package/dist/adapters/agents/backends/acp-cli.js

@@ -0,0 +1,299 @@
+import { spawn } from "node:child_process";
+import crypto from "node:crypto";
+import { Readable, Writable } from "node:stream";
+import {
+  ClientSideConnection,
+  ndJsonStream,
+  PROTOCOL_VERSION
+} from "@agentclientprotocol/sdk";
+import { APPROVAL_POSTURE_ACP_CLI } from "../approval-posture.js";
+import {
+  buildElicitationCapabilities,
+  dispatchElicitation
+} from "./acp-cli-elicitation.js";
+import {
+  ACP_AGENT_REGISTRY,
+  assertAcpProtocolCompatible,
+  closeAcpSessionIfSupported,
+  filterMcpServersByCapabilities,
+  HANDSHAKE_TIMEOUT_MS,
+  listAcpSessionsViaConnection,
+  mapAcpSessionUpdate,
+  parseAcpConfigOptions,
+  readAcpMcpServers,
+  resolveAcpAgentCapabilities,
+  resolveAcpAgentCommand,
+  setAcpConfigOptionViaConnection,
+  toAcpToolLocations,
+  withAcpTimeout
+} from "./acp-cli-helpers.js";
+import {
+  BACKEND_METADATA,
+  createCliBackendBase,
+  isCliInstalledAsync
+} from "./shared.js";
+import { forkAcpSessionViaConnection, listAcpSessions, probeAcpCapabilities } from "./acp-cli-probe.js";
+const AGENT_MODELS = {
+  claude: ["opus", "sonnet", "haiku"],
+  codex: ["gpt-5-codex", "o3", "o4-mini"],
+  gemini: ["gemini-2.5-pro", "gemini-2.5-flash"],
+  cursor: ["auto", "sonnet-4.6", "gpt-5.3-codex"]
+};
+function wrapAcpAgentError(err, agentCommand) {
+  const msg = err instanceof Error ? err.message : String(err);
+  const isRawJsError = msg.startsWith("Cannot read properties") || msg.startsWith("TypeError:") || msg.includes("is not a function") || msg.includes("is not defined");
+  if (isRawJsError) {
+    return new Error(
+      `ACP agent crashed during initialization (${agentCommand}): ${msg}`
+    );
+  }
+  return err instanceof Error ? err : new Error(msg);
+}
+async function* runAcpSession(command, spawnArgs, request, options, onElicitation) {
+  const sessionCwd = options.cwd ?? process.cwd();
+  const mcpServers = readAcpMcpServers(request.mcpConfigPath, sessionCwd);
+  const child = spawn(command, spawnArgs, {
+    stdio: ["pipe", "pipe", "inherit"],
+    env: { ...process.env, ...options.env },
+    cwd: options.cwd
+  });
+  const stream = ndJsonStream(
+    Writable.toWeb(child.stdin),
+    Readable.toWeb(child.stdout)
+  );
+  const pending = [];
+  let waiter = null;
+  let sessionDone = false;
+  let sessionError = null;
+  let currentSessionId = "";
+  let canCloseSession = false;
+  const push = (event) => {
+    pending.push(event);
+    waiter?.();
+    waiter = null;
+  };
+  const waitForNext = () => new Promise((resolve) => {
+    waiter = resolve;
+  });
+  const client = {
+    sessionUpdate({ update }) {
+      mapAcpSessionUpdate(update, push);
+      return Promise.resolve();
+    },
+    requestPermission(params) {
+      const first = params.options[0];
+      if (!first) {
+        return Promise.resolve({ outcome: { outcome: "cancelled" } });
+      }
+      push({ type: "tool", name: params.toolCall.title ?? "permission" });
+      return Promise.resolve({ outcome: { outcome: "selected", optionId: first.optionId } });
+    },
+    unstable_createElicitation: (params) => dispatchElicitation(params, onElicitation, push)
+  };
+  const connection = new ClientSideConnection(() => client, stream);
+  const onAbort = () => {
+    if (currentSessionId) {
+      void connection.cancel({ sessionId: currentSessionId }).catch(() => void 0);
+    }
+    sessionDone = true;
+    waiter?.();
+    waiter = null;
+    if (!child.killed) child.kill();
+  };
+  options.signal?.addEventListener("abort", onAbort, { once: true });
+  const sessionTimeoutMs = request.timeoutMs ?? HANDSHAKE_TIMEOUT_MS;
+  const sessionPromise = (async () => {
+    const elicitationCaps = buildElicitationCapabilities(!!onElicitation);
+    let initializeResult;
+    try {
+      initializeResult = await withAcpTimeout(
+        connection.initialize({
+          protocolVersion: PROTOCOL_VERSION,
+          clientCapabilities: {
+            fs: { readTextFile: true, writeTextFile: true },
+            ...elicitationCaps ? { elicitation: elicitationCaps } : {}
+          },
+          clientInfo: {
+            name: "octoflow-core",
+            title: "OctoFlow",
+            version: "1.0.0"
+          }
+        }),
+        sessionTimeoutMs
+      );
+    } catch (err) {
+      throw wrapAcpAgentError(err, command);
+    }
+    const capabilities = resolveAcpAgentCapabilities(initializeResult);
+    canCloseSession = capabilities.canCloseSession;
+    const effectiveMcpServers = filterMcpServersByCapabilities(
+      mcpServers,
+      capabilities
+    );
+    assertAcpProtocolCompatible(capabilities, PROTOCOL_VERSION);
+    let sessionId;
+    if (request.isResume && request.sessionId) {
+      if (capabilities.canResumeSession) {
+        await withAcpTimeout(
+          connection.resumeSession({
+            sessionId: request.sessionId,
+            cwd: sessionCwd,
+            mcpServers: effectiveMcpServers
+          }),
+          sessionTimeoutMs
+        );
+        sessionId = request.sessionId;
+      } else if (capabilities.canLoadSession) {
+        const maybeLoad = connection.loadSession;
+        if (!maybeLoad) {
+          throw new Error("ACP agent advertises loadSession but SDK client has no loadSession method");
+        }
+        await withAcpTimeout(
+          maybeLoad({
+            sessionId: request.sessionId,
+            cwd: sessionCwd,
+            mcpServers: effectiveMcpServers
+          }),
+          sessionTimeoutMs
+        );
+        sessionId = request.sessionId;
+      } else {
+        throw new Error(
+          "ACP agent does not advertise resume/load session capabilities; cannot resume session."
+        );
+      }
+    } else {
+      const resp = await withAcpTimeout(
+        connection.newSession({ cwd: sessionCwd, mcpServers: effectiveMcpServers }),
+        sessionTimeoutMs
+      );
+      ({ sessionId } = resp);
+    }
+    currentSessionId = sessionId;
+    push({ type: "init", sessionId });
+    if (request.model && request.model !== "default" && !request.isResume && !(request.model in ACP_AGENT_REGISTRY)) {
+      void connection.unstable_setSessionModel?.({ sessionId, modelId: request.model });
+    }
+    const promptParts = [
+      ...request.systemPrompt && !request.isResume ? [{ type: "text", text: `[System]: ${request.systemPrompt}
+
+` }] : [],
+      { type: "text", text: request.prompt }
+    ];
+    const promptResult = await withAcpTimeout(
+      connection.prompt({
+        sessionId,
+        prompt: promptParts,
+        _meta: request.isOrchestration ? { mode: "steer" } : void 0
+      }),
+      sessionTimeoutMs
+    );
+    push({ type: "result", stopReason: promptResult.stopReason });
+  })().catch((err) => {
+    sessionError = err;
+  }).finally(() => {
+    sessionDone = true;
+    waiter?.();
+    waiter = null;
+  });
+  try {
+    while (!sessionDone || pending.length > 0) {
+      if (pending.length > 0) {
+        yield pending.shift();
+      } else if (!sessionDone) {
+        await waitForNext();
+      }
+    }
+    await sessionPromise;
+    if (sessionError) throw sessionError;
+  } finally {
+    await withAcpTimeout(
+      closeAcpSessionIfSupported(connection, currentSessionId, canCloseSession),
+      2e3
+    );
+    options.signal?.removeEventListener("abort", onAbort);
+    if (!child.killed) child.kill();
+  }
+}
+const META = BACKEND_METADATA["acp-cli"];
+const CAPABILITIES = {
+  streaming: true,
+  sessionPersistence: true,
+  workingDirectory: true,
+  forceMode: false,
+  systemPrompt: true,
+  planning: false,
+  tools: true,
+  mcp: false,
+  approvalCallback: APPROVAL_POSTURE_ACP_CLI
+};
+function createAcpCliBackend(config = {}) {
+  let resolvedCommand;
+  let resolvedArgs;
+  if (config.command) {
+    resolvedCommand = config.command;
+    resolvedArgs = config.args ?? [];
+  } else {
+    const agent = config.agent ?? process.env.ACP_AGENT ?? "claude";
+    ({ command: resolvedCommand, args: resolvedArgs } = resolveAcpAgentCommand(
+      agent,
+      config.agentOverrides
+    ));
+  }
+  const agentName = config.command ? null : config.agent ?? process.env.ACP_AGENT ?? "claude";
+  const effectiveModels = config.models ?? (agentName ? AGENT_MODELS[agentName] : null) ?? META.models;
+  const effectiveMeta = {
+    ...META,
+    models: effectiveModels,
+    defaultModel: effectiveModels[0] ?? META.defaultModel
+  };
+  const base = createCliBackendBase(effectiveMeta, CAPABILITIES, "acp", {
+    resolveInstalled: () => isCliInstalledAsync(resolvedCommand),
+    resolveVersion: () => null
+  });
+  return {
+    ...base,
+    validateModel(model) {
+      return effectiveModels.includes(model) || model === "default" || model in ACP_AGENT_REGISTRY;
+    },
+    generateSessionId() {
+      return crypto.randomUUID();
+    },
+    buildExecutionPlan(request) {
+      let cmd = resolvedCommand;
+      let cmdArgs = resolvedArgs;
+      if (!config.command && request.model && request.model in ACP_AGENT_REGISTRY) {
+        ({ command: cmd, args: cmdArgs } = resolveAcpAgentCommand(
+          request.model,
+          config.agentOverrides
+        ));
+      }
+      return {
+        env: request.env ?? {},
+        stdin: "",
+        cwd: request.cwd ?? void 0,
+        parser: "acp",
+        timeoutMs: request.timeoutMs,
+        sessionId: request.sessionId ?? void 0,
+        execute: (execOptions) => runAcpSession(cmd, cmdArgs, request, execOptions, config.onElicitation)
+      };
+    },
+    extractSessionId(_output) {
+      return null;
+    }
+  };
+}
+export {
+  ACP_AGENT_REGISTRY,
+  createAcpCliBackend,
+  forkAcpSessionViaConnection,
+  listAcpSessions,
+  listAcpSessionsViaConnection,
+  mapAcpSessionUpdate,
+  parseAcpConfigOptions,
+  probeAcpCapabilities,
+  resolveAcpAgentCommand,
+  setAcpConfigOptionViaConnection,
+  toAcpToolLocations
+};
+//# sourceMappingURL=acp-cli.js.map

package/dist/adapters/agents/backends/acp-cli.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/adapters/agents/backends/acp-cli.ts"],
+  "sourcesContent": ["import { spawn } from 'node:child_process';\nimport crypto from 'node:crypto';\nimport { Readable, Writable } from 'node:stream';\n\nimport {\n  type Client,\n  ClientSideConnection,\n  type CreateElicitationRequest,\n  type CreateElicitationResponse,\n  ndJsonStream,\n  type NewSessionResponse,\n  type PromptResponse,\n  PROTOCOL_VERSION,\n  type RequestPermissionRequest,\n  type RequestPermissionResponse,\n  type SessionNotification,\n} from '@agentclientprotocol/sdk';\n\nimport type {\n  Backend,\n  BackendCapabilities,\n  BackendExecuteOptions,\n  BackendExecutionPlan,\n  BackendRunRequest,\n} from '../../../domain/contracts/backends.js';\nimport type { ParsedEvent } from '../../../domain/contracts/messages.js';\nimport { APPROVAL_POSTURE_ACP_CLI } from '../approval-posture.js';\nimport {\n  type AcpElicitationRequest,\n  type AcpElicitationResponse,\n  buildElicitationCapabilities,\n  dispatchElicitation,\n} from './acp-cli-elicitation.js';\nimport {\n  ACP_AGENT_REGISTRY,\n  type AcpCliBackendConfig,\n  type AcpConfigOption,\n  type AcpMcpServerSpec,\n  type AcpSessionInfo,\n  assertAcpProtocolCompatible,\n  closeAcpSessionIfSupported,\n  filterMcpServersByCapabilities,\n  HANDSHAKE_TIMEOUT_MS,\n  listAcpSessionsViaConnection,\n  mapAcpSessionUpdate,\n  parseAcpConfigOptions,\n  readAcpMcpServers,\n  resolveAcpAgentCapabilities,\n  resolveAcpAgentCommand,\n  setAcpConfigOptionViaConnection,\n  toAcpToolLocations,\n  withAcpTimeout,\n} from './acp-cli-helpers.js';\nimport {\n  BACKEND_METADATA,\n  createCliBackendBase,\n  isCliInstalledAsync,\n} from './shared.js';\n\nexport type { AcpElicitationField, AcpElicitationRequest, AcpElicitationResponse } from './acp-cli-elicitation.js';\nexport type { AcpCapabilityMatrix, AcpForkedSession } from './acp-cli-probe.js';\nexport type { AcpCliBackendConfig, AcpConfigOption, AcpSessionInfo };\nexport {\n  ACP_AGENT_REGISTRY,\n  listAcpSessionsViaConnection,\n  mapAcpSessionUpdate,\n  parseAcpConfigOptions,\n  resolveAcpAgentCommand,\n  setAcpConfigOptionViaConnection,\n  toAcpToolLocations,\n};\nexport { forkAcpSessionViaConnection, listAcpSessions, probeAcpCapabilities } from './acp-cli-probe.js';\n\nconst AGENT_MODELS: Record<string, string[]> = {\n  claude: ['opus', 'sonnet', 'haiku'],\n  codex: ['gpt-5-codex', 'o3', 'o4-mini'],\n  gemini: ['gemini-2.5-pro', 'gemini-2.5-flash'],\n  cursor: ['auto', 'sonnet-4.6', 'gpt-5.3-codex'],\n};\n\n/**\n * Re-wraps errors returned by an ACP agent binary that look like raw internal\n * JS crashes (e.g. \"Cannot read properties of undefined (reading 'connection')\").\n * These come back as JSON-RPC error messages from the agent process and would\n * otherwise surface as confusing implementation details to callers.\n */\nfunction wrapAcpAgentError(err: unknown, agentCommand: string): Error {\n  const msg = err instanceof Error ? err.message : String(err);\n  const isRawJsError =\n    msg.startsWith('Cannot read properties') ||\n    msg.startsWith('TypeError:') ||\n    msg.includes('is not a function') ||\n    msg.includes('is not defined');\n  if (isRawJsError) {\n    return new Error(\n      `ACP agent crashed during initialization (${agentCommand}): ${msg}`\n    );\n  }\n  return err instanceof Error ? err : new Error(msg);\n}\n\nasync function* runAcpSession(\n  command: string,\n  spawnArgs: string[],\n  request: BackendRunRequest,\n  options: BackendExecuteOptions,\n  onElicitation?: (req: AcpElicitationRequest) => Promise<AcpElicitationResponse>\n): AsyncGenerator<ParsedEvent> {\n  const sessionCwd = options.cwd ?? process.cwd();\n  const mcpServers = readAcpMcpServers(request.mcpConfigPath, sessionCwd);\n  const child = spawn(command, spawnArgs, {\n    stdio: ['pipe', 'pipe', 'inherit'],\n    env: { ...process.env, ...options.env },\n    cwd: options.cwd,\n  });\n\n  const stream = ndJsonStream(\n    Writable.toWeb(child.stdin) as WritableStream<Uint8Array>,\n    Readable.toWeb(child.stdout) as ReadableStream<Uint8Array>\n  );\n\n  const pending: ParsedEvent[] = [];\n  let waiter: (() => void) | null = null;\n  let sessionDone = false;\n  let sessionError: unknown = null;\n  let currentSessionId = '';\n  let canCloseSession = false;\n\n  const push = (event: ParsedEvent): void => {\n    pending.push(event);\n    waiter?.();\n    waiter = null;\n  };\n\n  const waitForNext = (): Promise<void> =>\n    new Promise<void>((resolve) => { waiter = resolve; });\n\n  const client: Client & {\n    unstable_createElicitation?: (params: CreateElicitationRequest) => Promise<CreateElicitationResponse>;\n  } = {\n    sessionUpdate({ update }: SessionNotification): Promise<void> {\n      mapAcpSessionUpdate(update, push);\n      return Promise.resolve();\n    },\n    requestPermission(params: RequestPermissionRequest): Promise<RequestPermissionResponse> {\n      const first = params.options[0];\n      if (!first) {\n        return Promise.resolve({ outcome: { outcome: 'cancelled' } });\n      }\n      push({ type: 'tool', name: params.toolCall.title ?? 'permission' });\n      return Promise.resolve({ outcome: { outcome: 'selected', optionId: first.optionId } });\n    },\n    unstable_createElicitation: (params: CreateElicitationRequest) =>\n      dispatchElicitation(params, onElicitation, push),\n  };\n\n  const connection = new ClientSideConnection(() => client, stream);\n\n  const onAbort = (): void => {\n    if (currentSessionId) {\n      void connection.cancel({ sessionId: currentSessionId }).catch(() => undefined);\n    }\n    sessionDone = true;\n    waiter?.();\n    waiter = null;\n    if (!child.killed) child.kill();\n  };\n  options.signal?.addEventListener('abort', onAbort, { once: true });\n\n  const sessionTimeoutMs = request.timeoutMs ?? HANDSHAKE_TIMEOUT_MS;\n\n  const sessionPromise = (async () => {\n    const elicitationCaps = buildElicitationCapabilities(!!onElicitation);\n    let initializeResult: unknown;\n    try {\n      initializeResult = await withAcpTimeout<unknown>(\n        connection.initialize({\n          protocolVersion: PROTOCOL_VERSION,\n          clientCapabilities: {\n            fs: { readTextFile: true, writeTextFile: true },\n            ...(elicitationCaps ? { elicitation: elicitationCaps } : {}),\n          },\n          clientInfo: {\n            name: 'octoflow-core',\n            title: 'OctoFlow',\n            version: '1.0.0',\n          },\n        }),\n        sessionTimeoutMs\n      );\n    } catch (err) {\n      throw wrapAcpAgentError(err, command);\n    }\n    const capabilities = resolveAcpAgentCapabilities(initializeResult);\n    canCloseSession = capabilities.canCloseSession;\n    const effectiveMcpServers = filterMcpServersByCapabilities(\n      mcpServers,\n      capabilities\n    );\n    assertAcpProtocolCompatible(capabilities, PROTOCOL_VERSION);\n\n    let sessionId: string;\n    if (request.isResume && request.sessionId) {\n      if (capabilities.canResumeSession) {\n        await withAcpTimeout(\n          connection.resumeSession({\n            sessionId: request.sessionId,\n            cwd: sessionCwd,\n            mcpServers: effectiveMcpServers,\n          }),\n          sessionTimeoutMs\n        );\n        sessionId = request.sessionId;\n      } else if (capabilities.canLoadSession) {\n        type MaybeLoadSession = ClientSideConnection & {\n          loadSession?: (params: {\n            sessionId: string;\n            cwd: string;\n            mcpServers: AcpMcpServerSpec[];\n          }) => Promise<unknown>;\n        };\n        const maybeLoad = (connection as MaybeLoadSession).loadSession;\n        if (!maybeLoad) {\n          throw new Error('ACP agent advertises loadSession but SDK client has no loadSession method');\n        }\n        await withAcpTimeout(\n          maybeLoad({\n            sessionId: request.sessionId,\n            cwd: sessionCwd,\n            mcpServers: effectiveMcpServers,\n          }),\n          sessionTimeoutMs\n        );\n        sessionId = request.sessionId;\n      } else {\n        throw new Error(\n          'ACP agent does not advertise resume/load session capabilities; cannot resume session.'\n        );\n      }\n    } else {\n      const resp = (await withAcpTimeout(\n        connection.newSession({ cwd: sessionCwd, mcpServers: effectiveMcpServers }),\n        sessionTimeoutMs\n      )) as NewSessionResponse;\n      ({ sessionId } = resp);\n    }\n\n    currentSessionId = sessionId;\n    push({ type: 'init', sessionId });\n\n    if (request.model && request.model !== 'default' && !request.isResume && !(request.model in ACP_AGENT_REGISTRY)) {\n      void connection.unstable_setSessionModel?.({ sessionId, modelId: request.model });\n    }\n\n    const promptParts = [\n      ...(request.systemPrompt && !request.isResume\n        ? [{ type: 'text' as const, text: `[System]: ${request.systemPrompt}\\n\\n` }]\n        : []),\n      { type: 'text' as const, text: request.prompt },\n    ];\n\n    const promptResult = (await withAcpTimeout(\n      connection.prompt({\n        sessionId,\n        prompt: promptParts,\n        _meta: request.isOrchestration ? { mode: 'steer' } : undefined,\n      }),\n      sessionTimeoutMs\n    )) as PromptResponse;\n\n    push({ type: 'result', stopReason: promptResult.stopReason });\n  })()\n    .catch((err: unknown) => { sessionError = err; })\n    .finally(() => {\n      sessionDone = true;\n      waiter?.();\n      waiter = null;\n    });\n\n  try {\n    while (!sessionDone || pending.length > 0) {\n      if (pending.length > 0) {\n        yield pending.shift() as ParsedEvent;\n      } else if (!sessionDone) {\n        await waitForNext();\n      }\n    }\n    await sessionPromise;\n    if (sessionError) throw sessionError as Error;\n  } finally {\n    await withAcpTimeout(\n      closeAcpSessionIfSupported(connection, currentSessionId, canCloseSession),\n      2_000\n    );\n    options.signal?.removeEventListener('abort', onAbort);\n    if (!child.killed) child.kill();\n  }\n}\n\nconst META = BACKEND_METADATA['acp-cli'];\n\nconst CAPABILITIES: BackendCapabilities = {\n  streaming: true,\n  sessionPersistence: true,\n  workingDirectory: true,\n  forceMode: false,\n  systemPrompt: true,\n  planning: false,\n  tools: true,\n  mcp: false,\n  approvalCallback: APPROVAL_POSTURE_ACP_CLI,\n};\n\nexport function createAcpCliBackend(config: AcpCliBackendConfig = {}): Backend {\n  let resolvedCommand: string;\n  let resolvedArgs: string[];\n\n  if (config.command) {\n    resolvedCommand = config.command;\n    resolvedArgs = config.args ?? [];\n  } else {\n    const agent = config.agent ?? process.env.ACP_AGENT ?? 'claude';\n    ({ command: resolvedCommand, args: resolvedArgs } = resolveAcpAgentCommand(\n      agent,\n      config.agentOverrides\n    ));\n  }\n\n  const agentName = config.command ? null : (config.agent ?? process.env.ACP_AGENT ?? 'claude');\n  const effectiveModels = config.models ?? (agentName ? AGENT_MODELS[agentName] : null) ?? META.models;\n  const effectiveMeta = {\n    ...META,\n    models: effectiveModels,\n    defaultModel: effectiveModels[0] ?? META.defaultModel,\n  };\n\n  const base = createCliBackendBase(effectiveMeta, CAPABILITIES, 'acp', {\n    resolveInstalled: () => isCliInstalledAsync(resolvedCommand),\n    resolveVersion: () => null,\n  });\n\n  return {\n    ...base,\n\n    validateModel(model: string): boolean {\n      return effectiveModels.includes(model) || model === 'default' || model in ACP_AGENT_REGISTRY;\n    },\n\n    generateSessionId(): string {\n      return crypto.randomUUID();\n    },\n\n    buildExecutionPlan(request: BackendRunRequest): BackendExecutionPlan {\n      let cmd = resolvedCommand;\n      let cmdArgs = resolvedArgs;\n      if (!config.command && request.model && request.model in ACP_AGENT_REGISTRY) {\n        ({ command: cmd, args: cmdArgs } = resolveAcpAgentCommand(\n          request.model,\n          config.agentOverrides\n        ));\n      }\n\n      return {\n        env: request.env ?? {},\n        stdin: '',\n        cwd: request.cwd ?? undefined,\n        parser: 'acp',\n        timeoutMs: request.timeoutMs,\n        sessionId: request.sessionId ?? undefined,\n        execute: (execOptions: BackendExecuteOptions) =>\n          runAcpSession(cmd, cmdArgs, request, execOptions, config.onElicitation),\n      };\n    },\n\n    extractSessionId(_output: string): string | null {\n      return null;\n    },\n  };\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/adapters/agents/backends/anthropic-api-usage.d.ts

@@ -0,0 +1,13 @@
+export interface AnthropicUsage {
+    input_tokens?: number;
+    output_tokens?: number;
+    cache_creation_input_tokens?: number;
+    cache_read_input_tokens?: number;
+    cache_creation?: {
+        ephemeral_5m_input_tokens?: number;
+        ephemeral_1h_input_tokens?: number;
+    };
+}
+export declare function hasAnthropicCacheUsage(usage: AnthropicUsage): boolean;
+export declare function anthropicCacheUsage(usage: AnthropicUsage): import("../../../domain/prompt-cache.js").PromptCacheUsage;
+//# sourceMappingURL=anthropic-api-usage.d.ts.map

package/dist/adapters/agents/backends/anthropic-api-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic-api-usage.d.ts","sourceRoot":"","sources":["../../../../src/adapters/agents/backends/anthropic-api-usage.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,cAAc;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,cAAc,CAAC,EAAE;QACf,yBAAyB,CAAC,EAAE,MAAM,CAAC;QACnC,yBAAyB,CAAC,EAAE,MAAM,CAAC;KACpC,CAAC;CACH;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAMrE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,cAAc,8DA+BxD"}

package/dist/adapters/agents/backends/anthropic-api-usage.js

@@ -0,0 +1,28 @@
+import { createPromptCacheUsage } from "../../../domain/prompt-cache.js";
+function hasAnthropicCacheUsage(usage) {
+  return usage.cache_read_input_tokens != null || usage.cache_creation_input_tokens != null || usage.cache_creation != null;
+}
+function anthropicCacheUsage(usage) {
+  const cacheWriteTokensByTtl = usage.cache_creation ? {
+    ...usage.cache_creation.ephemeral_5m_input_tokens != null ? {
+      ephemeral5mInputTokens: usage.cache_creation.ephemeral_5m_input_tokens
+    } : {},
+    ...usage.cache_creation.ephemeral_1h_input_tokens != null ? {
+      ephemeral1hInputTokens: usage.cache_creation.ephemeral_1h_input_tokens
+    } : {}
+  } : void 0;
+  return createPromptCacheUsage({
+    source: "anthropic",
+    inputTokenMode: "uncached",
+    inputTokens: usage.input_tokens ?? 0,
+    outputTokens: usage.output_tokens ?? 0,
+    ...usage.cache_read_input_tokens != null ? { cachedInputTokens: usage.cache_read_input_tokens } : {},
+    ...usage.cache_creation_input_tokens != null ? { cacheWriteTokens: usage.cache_creation_input_tokens } : {},
+    ...cacheWriteTokensByTtl ? { cacheWriteTokensByTtl } : {}
+  });
+}
+export {
+  anthropicCacheUsage,
+  hasAnthropicCacheUsage
+};
+//# sourceMappingURL=anthropic-api-usage.js.map

package/dist/adapters/agents/backends/anthropic-api-usage.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/adapters/agents/backends/anthropic-api-usage.ts"],
+  "sourcesContent": ["import { createPromptCacheUsage } from '../../../domain/prompt-cache.js';\n\nexport interface AnthropicUsage {\n  input_tokens?: number;\n  output_tokens?: number;\n  cache_creation_input_tokens?: number;\n  cache_read_input_tokens?: number;\n  cache_creation?: {\n    ephemeral_5m_input_tokens?: number;\n    ephemeral_1h_input_tokens?: number;\n  };\n}\n\nexport function hasAnthropicCacheUsage(usage: AnthropicUsage): boolean {\n  return (\n    usage.cache_read_input_tokens != null ||\n    usage.cache_creation_input_tokens != null ||\n    usage.cache_creation != null\n  );\n}\n\nexport function anthropicCacheUsage(usage: AnthropicUsage) {\n  const cacheWriteTokensByTtl = usage.cache_creation\n    ? {\n        ...(usage.cache_creation.ephemeral_5m_input_tokens != null\n          ? {\n              ephemeral5mInputTokens:\n                usage.cache_creation.ephemeral_5m_input_tokens,\n            }\n          : {}),\n        ...(usage.cache_creation.ephemeral_1h_input_tokens != null\n          ? {\n              ephemeral1hInputTokens:\n                usage.cache_creation.ephemeral_1h_input_tokens,\n            }\n          : {}),\n      }\n    : undefined;\n\n  return createPromptCacheUsage({\n    source: 'anthropic',\n    inputTokenMode: 'uncached',\n    inputTokens: usage.input_tokens ?? 0,\n    outputTokens: usage.output_tokens ?? 0,\n    ...(usage.cache_read_input_tokens != null\n      ? { cachedInputTokens: usage.cache_read_input_tokens }\n      : {}),\n    ...(usage.cache_creation_input_tokens != null\n      ? { cacheWriteTokens: usage.cache_creation_input_tokens }\n      : {}),\n    ...(cacheWriteTokensByTtl ? { cacheWriteTokensByTtl } : {}),\n  });\n}\n"],
+  "mappings": "AAAA,SAAS,8BAA8B;AAahC,SAAS,uBAAuB,OAAgC;AACrE,SACE,MAAM,2BAA2B,QACjC,MAAM,+BAA+B,QACrC,MAAM,kBAAkB;AAE5B;AAEO,SAAS,oBAAoB,OAAuB;AACzD,QAAM,wBAAwB,MAAM,iBAChC;AAAA,IACE,GAAI,MAAM,eAAe,6BAA6B,OAClD;AAAA,MACE,wBACE,MAAM,eAAe;AAAA,IACzB,IACA,CAAC;AAAA,IACL,GAAI,MAAM,eAAe,6BAA6B,OAClD;AAAA,MACE,wBACE,MAAM,eAAe;AAAA,IACzB,IACA,CAAC;AAAA,EACP,IACA;AAEJ,SAAO,uBAAuB;AAAA,IAC5B,QAAQ;AAAA,IACR,gBAAgB;AAAA,IAChB,aAAa,MAAM,gBAAgB;AAAA,IACnC,cAAc,MAAM,iBAAiB;AAAA,IACrC,GAAI,MAAM,2BAA2B,OACjC,EAAE,mBAAmB,MAAM,wBAAwB,IACnD,CAAC;AAAA,IACL,GAAI,MAAM,+BAA+B,OACrC,EAAE,kBAAkB,MAAM,4BAA4B,IACtD,CAAC;AAAA,IACL,GAAI,wBAAwB,EAAE,sBAAsB,IAAI,CAAC;AAAA,EAC3D,CAAC;AACH;",
+  "names": []
+}

package/dist/adapters/agents/backends/anthropic-api.d.ts

@@ -0,0 +1,11 @@
+import type { AnthropicApiBackendConfig, ApiJsonObject, Backend, BackendToolDef } from '../../../domain/contracts/backends.js';
+interface AnthropicToolDef {
+    type: 'custom';
+    name: string;
+    description?: string;
+    input_schema: ApiJsonObject;
+}
+export declare function toAnthropicTools(tools: BackendToolDef[]): AnthropicToolDef[];
+export declare function createAnthropicApiBackend(config?: AnthropicApiBackendConfig): Backend;
+export {};
+//# sourceMappingURL=anthropic-api.d.ts.map

package/dist/adapters/agents/backends/anthropic-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic-api.d.ts","sourceRoot":"","sources":["../../../../src/adapters/agents/backends/anthropic-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,yBAAyB,EACzB,aAAa,EACb,OAAO,EAIP,cAAc,EACf,MAAM,uCAAuC,CAAC;AAiF/C,UAAU,gBAAgB;IACxB,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,aAAa,CAAC;CAC7B;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,gBAAgB,EAAE,CAO5E;AACD,wBAAgB,yBAAyB,CACvC,MAAM,GAAE,yBAA8B,GACrC,OAAO,CAsTT"}