@agentproto/adapter-claude-sdk 0.2.0

package/dist/index.mjs

@@ -0,0 +1,190 @@
+import { DEFAULT_MODEL } from './chunk-DW2G2NIH.mjs';
+export { ClaudeSdkAcpAgent, DEFAULT_MODEL, assistantMessageUpdates, buildQueryOptions, mapAcpMcpServers, promptText, resultUsageUpdate, runAcpOverStdio, sdkMessageToUpdates, systemInitSessionId, toolCallTitle, toolKindForClaudeTool, userMessageUpdates } from './chunk-DW2G2NIH.mjs';
+import { fileURLToPath } from 'url';
+import { defineAgentCli, createAgentCliRuntime } from '@agentproto/driver-agent-cli';
+import { ANTHROPIC_GATEWAY_PRESETS } from '@agentproto/provider-presets';
+
+/**
+ * @agentproto/adapter-claude-sdk v0.1.0-alpha
+ * First-party agentproto adapter: Claude Agent SDK headless query() -> ACP server.
+ */
+var cliEntry = fileURLToPath(new URL("./cli.mjs", import.meta.url));
+var claudeSdk = defineAgentCli({
+  name: "claude-sdk",
+  id: "claude-sdk",
+  description: "First-party agentproto adapter \u2014 Claude Code's agent harness run as a library via the Claude Agent SDK's headless query(), behind an AIP-44 ACP server. 100% Anthropic-native I/O: clean model pinning (options.model), native per-turn usage (tokens + cost), and a custom base_url (ANTHROPIC_BASE_URL) to front real Anthropic, Bedrock/Vertex/Azure, or an Anthropic-compatible gateway. Spawned as `node cli.mjs acp` over stdio JSON-RPC, or launched standalone via `agentproto-claude-sdk acp`.",
+  version: "0.1.0",
+  bin: "node",
+  bin_args: [cliEntry, "acp"],
+  install: [
+    {
+      method: "npm",
+      package: "@agentproto/adapter-claude-sdk",
+      global: true
+    }
+  ],
+  // No external runtime to probe — the SDK's harness runs in the spawned node
+  // process. A node version gate is enough to mark the arm ready.
+  version_check: {
+    cmd: "node --version",
+    parse: "(\\d+\\.\\d+\\.\\d+)",
+    range: ">=20.9.0",
+    timeout_ms: 5e3
+  },
+  auth: {
+    ref: "./claude-sdk.ACP.md",
+    // Auth is read from the spawn env by the SDK. Either an Anthropic key/token
+    // (direct or via an Anthropic-compatible gateway), or the cloud-provider
+    // toggles below.
+    state: {
+      env: [
+        "ANTHROPIC_API_KEY",
+        "ANTHROPIC_AUTH_TOKEN",
+        "CLAUDE_CODE_USE_BEDROCK",
+        "CLAUDE_CODE_USE_VERTEX",
+        "CLAUDE_CODE_USE_FOUNDRY"
+      ]
+    }
+  },
+  sandbox: "In-process: the SDK harness runs inside the spawned node process, scoped to the daemon's cwd. Tool-permission handling defaults to bypassPermissions (override via CLAUDE_SDK_PERMISSION_MODE); the daemon owns the surrounding sandbox.",
+  protocol: "acp",
+  acp: "./claude-sdk.ACP.md",
+  session: {
+    mode: "persistent",
+    idle_timeout_ms: 18e5,
+    context_carryover: true
+  },
+  models: {
+    // A cheap Claude by default — this is the budget first-party arm.
+    default: DEFAULT_MODEL,
+    // Native Anthropic models work out of the box (mode: default). The gateway
+    // models below only route when the matching mode is selected
+    // (mode: moonshot / openrouter) — that mode pre-wires ANTHROPIC_BASE_URL.
+    // The `model` option stays free-form, so any gateway id works even if it
+    // isn't listed here.
+    allowed: [
+      // Native Anthropic — mode: default
+      "claude-haiku-4-5-20251001",
+      "claude-sonnet-5",
+      "claude-opus-4-8",
+      "claude-fable-5",
+      // Moonshot (Kimi) — mode: moonshot
+      "kimi-k2.7-code",
+      // OpenRouter — mode: openrouter
+      "z-ai/glm-5.2",
+      "deepseek/deepseek-v4-pro",
+      "moonshotai/kimi-k2"
+    ],
+    env: {
+      anthropic: "ANTHROPIC_API_KEY"
+    }
+  },
+  capabilities: {
+    streaming: true,
+    // Claude Code's built-in tools (Read/Edit/Bash/…) and any injected MCP
+    // tools run inside the harness and are relayed to the host as ACP
+    // tool_call / tool_call_update updates (see acp-host.ts + message-map.ts).
+    tool_calls: true,
+    sub_agents: true,
+    file_io: true,
+    multimodal: false,
+    // Turns resume via the SDK session store (options.resume), keyed by the
+    // pinned session id.
+    resumable: true,
+    bidirectional: true
+  },
+  // Gateway presets. The base_url/auth_token/thinking options already let a
+  // caller front any Anthropic-compatible gateway by hand; these modes just
+  // pre-wire the endpoint (and, for Moonshot, the model + --thinking) so the
+  // caller only has to supply the key. The `model` option still overrides.
+  modes: [
+    {
+      id: "default",
+      description: "Native Anthropic \u2014 the real Anthropic API (or whatever ANTHROPIC_BASE_URL / cloud toggles the environment already sets). Uses the native Claude models in `allowed`."
+    },
+    {
+      id: ANTHROPIC_GATEWAY_PRESETS.moonshot.id,
+      description: "Moonshot (Kimi) gateway. Pre-wires ANTHROPIC_BASE_URL to Moonshot's Anthropic-compatible endpoint, defaults the model to kimi-k2.7-code, and enables --thinking (Kimi rejects a request without it). Supply the Moonshot key via the `auth_token` option (or ANTHROPIC_AUTH_TOKEN); override `model` for another Moonshot model.",
+      env: {
+        ANTHROPIC_BASE_URL: ANTHROPIC_GATEWAY_PRESETS.moonshot.baseUrl,
+        // cli.ts reads CLAUDE_SDK_MODEL as the model fallback (a `--model`
+        // option still wins), so the mode ships a working default model.
+        CLAUDE_SDK_MODEL: ANTHROPIC_GATEWAY_PRESETS.moonshot.defaultModel,
+        // Declares this gateway's conventional credential source.
+        // buildQueryOptions resolves the bearer from this env when no explicit
+        // auth_token / ANTHROPIC_AUTH_TOKEN is set, and always scrubs the
+        // ambient ANTHROPIC_API_KEY so it never reaches a non-Anthropic host.
+        CLAUDE_SDK_GATEWAY_KEY_ENV: ANTHROPIC_GATEWAY_PRESETS.moonshot.keyEnv
+      },
+      bin_args_append: ["--thinking"]
+    },
+    {
+      id: ANTHROPIC_GATEWAY_PRESETS.openrouter.id,
+      description: "OpenRouter gateway. Pre-wires ANTHROPIC_BASE_URL to OpenRouter's Anthropic-compatible endpoint. Pick a model via the `model` option (e.g. 'z-ai/glm-5.2', 'deepseek/deepseek-v4-pro', 'moonshotai/kimi-k2') and supply the OpenRouter key via `auth_token` (or ANTHROPIC_AUTH_TOKEN).",
+      env: {
+        ANTHROPIC_BASE_URL: ANTHROPIC_GATEWAY_PRESETS.openrouter.baseUrl,
+        // Conventional credential source for this gateway (see moonshot above).
+        CLAUDE_SDK_GATEWAY_KEY_ENV: ANTHROPIC_GATEWAY_PRESETS.openrouter.keyEnv
+      }
+    },
+    {
+      id: ANTHROPIC_GATEWAY_PRESETS.deepseek.id,
+      description: "DeepSeek gateway. Pre-wires ANTHROPIC_BASE_URL to DeepSeek's Anthropic-compatible endpoint and defaults the model to deepseek-v4-pro. Supply the DeepSeek key via the `auth_token` option (or ANTHROPIC_AUTH_TOKEN); override `model` for deepseek-v4-flash. Thinking is opt-in (DeepSeek accepts requests without it, unlike Kimi).",
+      env: {
+        ANTHROPIC_BASE_URL: ANTHROPIC_GATEWAY_PRESETS.deepseek.baseUrl,
+        // cli.ts reads CLAUDE_SDK_MODEL as the model fallback (a `--model`
+        // option still wins), so the mode ships a working default model.
+        CLAUDE_SDK_MODEL: ANTHROPIC_GATEWAY_PRESETS.deepseek.defaultModel,
+        // Conventional credential source for this gateway (see moonshot above).
+        CLAUDE_SDK_GATEWAY_KEY_ENV: ANTHROPIC_GATEWAY_PRESETS.deepseek.keyEnv
+      }
+    }
+  ],
+  options: [
+    {
+      id: "model",
+      // string (not enum) so any model id works without a code change — native
+      // Claude ids, or a gateway id when a gateway mode is selected. Applied as
+      // a `--model <id>` spawn arg → SDK options.model.
+      type: "string",
+      description: "Model id \u2192 SDK options.model, applied as a `--model` arg at spawn. Native Claude (e.g. 'claude-opus-4-8', 'claude-sonnet-5') in the default mode, or a gateway id when mode is moonshot/openrouter (e.g. 'kimi-k2.7-code', 'z-ai/glm-5.2'). Omit for the mode's default.",
+      bin_args_template: ["--model", "{value}"]
+    },
+    {
+      id: "base_url",
+      // Injected into the child env as ANTHROPIC_BASE_URL — keeps the harness
+      // Anthropic-native while fronting real Anthropic, a cloud provider, or an
+      // Anthropic-compatible gateway (LiteLLM / claude-code-router). When set,
+      // buildQueryOptions also pins every model tier to `model` (gateway mode).
+      type: "string",
+      description: "Custom Anthropic base URL. Injected as ANTHROPIC_BASE_URL in the child env \u2014 front real Anthropic, Bedrock/Vertex/Azure, or an Anthropic-compatible gateway. When set, every internal model tier (opus/sonnet/haiku/small-fast) is pinned to `model` so a single-model gateway never gets an unservable tier. Omit to use the default endpoint.",
+      env: { ANTHROPIC_BASE_URL: "{value}" }
+    },
+    {
+      id: "auth_token",
+      // Injected into the child env as ANTHROPIC_AUTH_TOKEN — the SDK sends it
+      // as `Authorization: Bearer <token>`, which Anthropic-compatible gateways
+      // (Moonshot, OpenRouter) accept. Pair with base_url for a per-spawn key.
+      type: "string",
+      description: "Bearer token for the Anthropic API or a compatible gateway. Injected as ANTHROPIC_AUTH_TOKEN in the child env (sent as `Authorization: Bearer`). Pair with base_url to target a gateway (e.g. Moonshot, OpenRouter) with a per-spawn key instead of the ambient ANTHROPIC_API_KEY. Omit to use ANTHROPIC_API_KEY from the environment.",
+      env: { ANTHROPIC_AUTH_TOKEN: "{value}" }
+    },
+    {
+      id: "thinking",
+      // Bare flag → cli.ts parses `--thinking` → SDK options.thinking =
+      // { type: "enabled" }. Needed by thinking-gated gateway models such as
+      // kimi-k2.7-code, which reject a request that omits `thinking`.
+      type: "boolean",
+      description: "Enable extended thinking (SDK options.thinking = { type: 'enabled' }). Required by thinking-gated gateway models such as Moonshot's kimi-k2.7-code, which reject a request without it. Off by default \u2014 native Claude models choose their own thinking behaviour.",
+      bin_args_append_when_true: ["--thinking"]
+    }
+  ],
+  tags: ["anthropic", "claude", "claude-agent-sdk", "agentproto", "acp", "first-party"]
+});
+function claudeSdkRuntime() {
+  return createAgentCliRuntime(claudeSdk);
+}
+
+export { claudeSdk, claudeSdkRuntime };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;AAiCA,IAAM,WAAW,aAAA,CAAc,IAAI,IAAI,WAAA,EAAa,MAAA,CAAA,IAAA,CAAY,GAAG,CAAC,CAAA;AAE7D,IAAM,YAA4B,cAAA,CAAe;AAAA,EACtD,IAAA,EAAM,YAAA;AAAA,EACN,EAAA,EAAI,YAAA;AAAA,EACJ,WAAA,EACE,8eAAA;AAAA,EAOF,OAAA,EAAS,OAAA;AAAA,EACT,GAAA,EAAK,MAAA;AAAA,EACL,QAAA,EAAU,CAAC,QAAA,EAAU,KAAK,CAAA;AAAA,EAC1B,OAAA,EAAS;AAAA,IACP;AAAA,MACE,MAAA,EAAQ,KAAA;AAAA,MACR,OAAA,EAAS,gCAAA;AAAA,MACT,MAAA,EAAQ;AAAA;AACV,GACF;AAAA;AAAA;AAAA,EAGA,aAAA,EAAe;AAAA,IACb,GAAA,EAAK,gBAAA;AAAA,IACL,KAAA,EAAO,sBAAA;AAAA,IACP,KAAA,EAAO,UAAA;AAAA,IACP,UAAA,EAAY;AAAA,GACd;AAAA,EACA,IAAA,EAAM;AAAA,IACJ,GAAA,EAAK,qBAAA;AAAA;AAAA;AAAA;AAAA,IAIL,KAAA,EAAO;AAAA,MACL,GAAA,EAAK;AAAA,QACH,mBAAA;AAAA,QACA,sBAAA;AAAA,QACA,yBAAA;AAAA,QACA,wBAAA;AAAA,QACA;AAAA;AACF;AACF,GACF;AAAA,EACA,OAAA,EACE,0OAAA;AAAA,EAIF,QAAA,EAAU,KAAA;AAAA,EACV,GAAA,EAAK,qBAAA;AAAA,EACL,OAAA,EAAS;AAAA,IACP,IAAA,EAAM,YAAA;AAAA,IACN,eAAA,EAAiB,IAAA;AAAA,IACjB,iBAAA,EAAmB;AAAA,GACrB;AAAA,EACA,MAAA,EAAQ;AAAA;AAAA,IAEN,OAAA,EAAS,aAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAMT,OAAA,EAAS;AAAA;AAAA,MAEP,2BAAA;AAAA,MACA,iBAAA;AAAA,MACA,iBAAA;AAAA,MACA,gBAAA;AAAA;AAAA,MAEA,gBAAA;AAAA;AAAA,MAEA,cAAA;AAAA,MACA,0BAAA;AAAA,MACA;AAAA,KACF;AAAA,IACA,GAAA,EAAK;AAAA,MACH,SAAA,EAAW;AAAA;AACb,GACF;AAAA,EACA,YAAA,EAAc;AAAA,IACZ,SAAA,EAAW,IAAA;AAAA;AAAA;AAAA;AAAA,IAIX,UAAA,EAAY,IAAA;AAAA,IACZ,UAAA,EAAY,IAAA;AAAA,IACZ,OAAA,EAAS,IAAA;AAAA,IACT,UAAA,EAAY,KAAA;AAAA;AAAA;AAAA,IAGZ,SAAA,EAAW,IAAA;AAAA,IACX,aAAA,EAAe;AAAA,GACjB;AAAA;AAAA;AAAA;AAAA;AAAA,EAKA,KAAA,EAAO;AAAA,IACL;AAAA,MACE,EAAA,EAAI,SAAA;AAAA,MACJ,WAAA,EACE;AAAA,KAGJ;AAAA,IACA;AAAA,MACE,EAAA,EAAI,0BAA0B,QAAA,CAAS,EAAA;AAAA,MACvC,WAAA,EACE,kUAAA;AAAA,MAKF,GAAA,EAAK;AAAA,QACH,kBAAA,EAAoB,0BAA0B,QAAA,CAAS,OAAA;AAAA;AAAA;AAAA,QAGvD,gBAAA,EAAkB,0BAA0B,QAAA,CAAS,YAAA;AAAA;AAAA;AAAA;AAAA;AAAA,QAKrD,0BAAA,EAA4B,0BAA0B,QAAA,CAAS;AAAA,OACjE;AAAA,MACA,eAAA,EAAiB,CAAC,YAAY;AAAA,KAChC;AAAA,IACA;AAAA,MACE,EAAA,EAAI,0BAA0B,UAAA,CAAW,EAAA;AAAA,MACzC,WAAA,EACE,uRAAA;AAAA,MAIF,GAAA,EAAK;AAAA,QACH,kBAAA,EAAoB,0BAA0B,UAAA,CAAW,OAAA;AAAA;AAAA,QAEzD,0BAAA,EAA4B,0BAA0B,UAAA,CAAW;AAAA;AACnE,KACF;AAAA,IACA;AAAA,MACE,EAAA,EAAI,0BAA0B,QAAA,CAAS,EAAA;AAAA,MACvC,WAAA,EACE,sUAAA;AAAA,MAKF,GAAA,EAAK;AAAA,QACH,kBAAA,EAAoB,0BAA0B,QAAA,CAAS,OAAA;AAAA;AAAA;AAAA,QAGvD,gBAAA,EAAkB,0BAA0B,QAAA,CAAS,YAAA;AAAA;AAAA,QAErD,0BAAA,EAA4B,0BAA0B,QAAA,CAAS;AAAA;AACjE;AACF,GACF;AAAA,EACA,OAAA,EAAS;AAAA,IACP;AAAA,MACE,EAAA,EAAI,OAAA;AAAA;AAAA;AAAA;AAAA,MAIJ,IAAA,EAAM,QAAA;AAAA,MACN,WAAA,EACE,+QAAA;AAAA,MAIF,iBAAA,EAAmB,CAAC,SAAA,EAAW,SAAS;AAAA,KAC1C;AAAA,IACA;AAAA,MACE,EAAA,EAAI,UAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAKJ,IAAA,EAAM,QAAA;AAAA,MACN,WAAA,EACE,sVAAA;AAAA,MAKF,GAAA,EAAK,EAAE,kBAAA,EAAoB,SAAA;AAAU,KACvC;AAAA,IACA;AAAA,MACE,EAAA,EAAI,YAAA;AAAA;AAAA;AAAA;AAAA,MAIJ,IAAA,EAAM,QAAA;AAAA,MACN,WAAA,EACE,wUAAA;AAAA,MAKF,GAAA,EAAK,EAAE,oBAAA,EAAsB,SAAA;AAAU,KACzC;AAAA,IACA;AAAA,MACE,EAAA,EAAI,UAAA;AAAA;AAAA;AAAA;AAAA,MAIJ,IAAA,EAAM,SAAA;AAAA,MACN,WAAA,EACE,wQAAA;AAAA,MAIF,yBAAA,EAA2B,CAAC,YAAY;AAAA;AAC1C,GACF;AAAA,EACA,MAAM,CAAC,WAAA,EAAa,UAAU,kBAAA,EAAoB,YAAA,EAAc,OAAO,aAAa;AACtF,CAAC;AAEM,SAAS,gBAAA,GAAoC;AAClD,EAAA,OAAO,sBAAsB,SAAS,CAAA;AACxC","file":"index.mjs","sourcesContent":["/**\n * @agentproto/adapter-claude-sdk — first-party adapter that runs Claude Code's\n * agent harness as a LIBRARY.\n *\n * Unlike `@agentproto/adapter-claude-code` (which wraps the third-party\n * `@agentclientprotocol/claude-agent-acp` bridge), this adapter drives the\n * Claude Agent SDK's headless `query()` directly behind an AIP-44 ACP server\n * (see ./acp-host.ts), shipped as a CLI bin (`agentproto-claude-sdk acp`). The\n * daemon spawns it like any other arm; a user can launch it standalone.\n *\n * Driving the SDK directly buys us clean model pinning (`options.model`, no\n * spawn-arg rejection — issue #186), native usage telemetry (a `usage_update`\n * per turn — #186 P3), and a custom `base_url` (`ANTHROPIC_BASE_URL`) that\n * points the same Anthropic-native harness at real Anthropic, Bedrock/Vertex/\n * Azure, or an Anthropic-compatible gateway.\n *\n *   import { claudeSdk, claudeSdkRuntime } from \"@agentproto/adapter-claude-sdk\"\n */\n\nimport { fileURLToPath } from \"node:url\"\nimport {\n  createAgentCliRuntime,\n  defineAgentCli,\n  type AgentCliHandle,\n  type AgentCliRuntime,\n} from \"@agentproto/driver-agent-cli\"\nimport { ANTHROPIC_GATEWAY_PRESETS } from \"@agentproto/provider-presets\"\nimport { DEFAULT_MODEL } from \"./options.js\"\n\n// Self-locating: the built handle spawns `node <this-dist>/cli.mjs acp`.\n// import.meta.url resolves into dist/ at runtime, where cli.mjs sits next to\n// index.mjs — so the same build works whether the daemon spawns it (resolved\n// from node_modules) or a user runs the published bin.\nconst cliEntry = fileURLToPath(new URL(\"./cli.mjs\", import.meta.url))\n\nexport const claudeSdk: AgentCliHandle = defineAgentCli({\n  name: \"claude-sdk\",\n  id: \"claude-sdk\",\n  description:\n    \"First-party agentproto adapter — Claude Code's agent harness run as a \" +\n    \"library via the Claude Agent SDK's headless query(), behind an AIP-44 ACP \" +\n    \"server. 100% Anthropic-native I/O: clean model pinning (options.model), \" +\n    \"native per-turn usage (tokens + cost), and a custom base_url \" +\n    \"(ANTHROPIC_BASE_URL) to front real Anthropic, Bedrock/Vertex/Azure, or an \" +\n    \"Anthropic-compatible gateway. Spawned as `node cli.mjs acp` over stdio \" +\n    \"JSON-RPC, or launched standalone via `agentproto-claude-sdk acp`.\",\n  version: \"0.1.0\",\n  bin: \"node\",\n  bin_args: [cliEntry, \"acp\"],\n  install: [\n    {\n      method: \"npm\",\n      package: \"@agentproto/adapter-claude-sdk\",\n      global: true,\n    },\n  ],\n  // No external runtime to probe — the SDK's harness runs in the spawned node\n  // process. A node version gate is enough to mark the arm ready.\n  version_check: {\n    cmd: \"node --version\",\n    parse: \"(\\\\d+\\\\.\\\\d+\\\\.\\\\d+)\",\n    range: \">=20.9.0\",\n    timeout_ms: 5000,\n  },\n  auth: {\n    ref: \"./claude-sdk.ACP.md\",\n    // Auth is read from the spawn env by the SDK. Either an Anthropic key/token\n    // (direct or via an Anthropic-compatible gateway), or the cloud-provider\n    // toggles below.\n    state: {\n      env: [\n        \"ANTHROPIC_API_KEY\",\n        \"ANTHROPIC_AUTH_TOKEN\",\n        \"CLAUDE_CODE_USE_BEDROCK\",\n        \"CLAUDE_CODE_USE_VERTEX\",\n        \"CLAUDE_CODE_USE_FOUNDRY\",\n      ],\n    },\n  },\n  sandbox:\n    \"In-process: the SDK harness runs inside the spawned node process, scoped \" +\n    \"to the daemon's cwd. Tool-permission handling defaults to \" +\n    \"bypassPermissions (override via CLAUDE_SDK_PERMISSION_MODE); the daemon \" +\n    \"owns the surrounding sandbox.\",\n  protocol: \"acp\",\n  acp: \"./claude-sdk.ACP.md\",\n  session: {\n    mode: \"persistent\",\n    idle_timeout_ms: 1_800_000,\n    context_carryover: true,\n  },\n  models: {\n    // A cheap Claude by default — this is the budget first-party arm.\n    default: DEFAULT_MODEL,\n    // Native Anthropic models work out of the box (mode: default). The gateway\n    // models below only route when the matching mode is selected\n    // (mode: moonshot / openrouter) — that mode pre-wires ANTHROPIC_BASE_URL.\n    // The `model` option stays free-form, so any gateway id works even if it\n    // isn't listed here.\n    allowed: [\n      // Native Anthropic — mode: default\n      \"claude-haiku-4-5-20251001\",\n      \"claude-sonnet-5\",\n      \"claude-opus-4-8\",\n      \"claude-fable-5\",\n      // Moonshot (Kimi) — mode: moonshot\n      \"kimi-k2.7-code\",\n      // OpenRouter — mode: openrouter\n      \"z-ai/glm-5.2\",\n      \"deepseek/deepseek-v4-pro\",\n      \"moonshotai/kimi-k2\",\n    ],\n    env: {\n      anthropic: \"ANTHROPIC_API_KEY\",\n    },\n  },\n  capabilities: {\n    streaming: true,\n    // Claude Code's built-in tools (Read/Edit/Bash/…) and any injected MCP\n    // tools run inside the harness and are relayed to the host as ACP\n    // tool_call / tool_call_update updates (see acp-host.ts + message-map.ts).\n    tool_calls: true,\n    sub_agents: true,\n    file_io: true,\n    multimodal: false,\n    // Turns resume via the SDK session store (options.resume), keyed by the\n    // pinned session id.\n    resumable: true,\n    bidirectional: true,\n  },\n  // Gateway presets. The base_url/auth_token/thinking options already let a\n  // caller front any Anthropic-compatible gateway by hand; these modes just\n  // pre-wire the endpoint (and, for Moonshot, the model + --thinking) so the\n  // caller only has to supply the key. The `model` option still overrides.\n  modes: [\n    {\n      id: \"default\",\n      description:\n        \"Native Anthropic — the real Anthropic API (or whatever \" +\n        \"ANTHROPIC_BASE_URL / cloud toggles the environment already sets). \" +\n        \"Uses the native Claude models in `allowed`.\",\n    },\n    {\n      id: ANTHROPIC_GATEWAY_PRESETS.moonshot.id,\n      description:\n        \"Moonshot (Kimi) gateway. Pre-wires ANTHROPIC_BASE_URL to Moonshot's \" +\n        \"Anthropic-compatible endpoint, defaults the model to kimi-k2.7-code, \" +\n        \"and enables --thinking (Kimi rejects a request without it). Supply the \" +\n        \"Moonshot key via the `auth_token` option (or ANTHROPIC_AUTH_TOKEN); \" +\n        \"override `model` for another Moonshot model.\",\n      env: {\n        ANTHROPIC_BASE_URL: ANTHROPIC_GATEWAY_PRESETS.moonshot.baseUrl,\n        // cli.ts reads CLAUDE_SDK_MODEL as the model fallback (a `--model`\n        // option still wins), so the mode ships a working default model.\n        CLAUDE_SDK_MODEL: ANTHROPIC_GATEWAY_PRESETS.moonshot.defaultModel,\n        // Declares this gateway's conventional credential source.\n        // buildQueryOptions resolves the bearer from this env when no explicit\n        // auth_token / ANTHROPIC_AUTH_TOKEN is set, and always scrubs the\n        // ambient ANTHROPIC_API_KEY so it never reaches a non-Anthropic host.\n        CLAUDE_SDK_GATEWAY_KEY_ENV: ANTHROPIC_GATEWAY_PRESETS.moonshot.keyEnv,\n      },\n      bin_args_append: [\"--thinking\"],\n    },\n    {\n      id: ANTHROPIC_GATEWAY_PRESETS.openrouter.id,\n      description:\n        \"OpenRouter gateway. Pre-wires ANTHROPIC_BASE_URL to OpenRouter's \" +\n        \"Anthropic-compatible endpoint. Pick a model via the `model` option \" +\n        \"(e.g. 'z-ai/glm-5.2', 'deepseek/deepseek-v4-pro', 'moonshotai/kimi-k2') \" +\n        \"and supply the OpenRouter key via `auth_token` (or ANTHROPIC_AUTH_TOKEN).\",\n      env: {\n        ANTHROPIC_BASE_URL: ANTHROPIC_GATEWAY_PRESETS.openrouter.baseUrl,\n        // Conventional credential source for this gateway (see moonshot above).\n        CLAUDE_SDK_GATEWAY_KEY_ENV: ANTHROPIC_GATEWAY_PRESETS.openrouter.keyEnv,\n      },\n    },\n    {\n      id: ANTHROPIC_GATEWAY_PRESETS.deepseek.id,\n      description:\n        \"DeepSeek gateway. Pre-wires ANTHROPIC_BASE_URL to DeepSeek's \" +\n        \"Anthropic-compatible endpoint and defaults the model to \" +\n        \"deepseek-v4-pro. Supply the DeepSeek key via the `auth_token` option \" +\n        \"(or ANTHROPIC_AUTH_TOKEN); override `model` for deepseek-v4-flash. \" +\n        \"Thinking is opt-in (DeepSeek accepts requests without it, unlike Kimi).\",\n      env: {\n        ANTHROPIC_BASE_URL: ANTHROPIC_GATEWAY_PRESETS.deepseek.baseUrl,\n        // cli.ts reads CLAUDE_SDK_MODEL as the model fallback (a `--model`\n        // option still wins), so the mode ships a working default model.\n        CLAUDE_SDK_MODEL: ANTHROPIC_GATEWAY_PRESETS.deepseek.defaultModel,\n        // Conventional credential source for this gateway (see moonshot above).\n        CLAUDE_SDK_GATEWAY_KEY_ENV: ANTHROPIC_GATEWAY_PRESETS.deepseek.keyEnv,\n      },\n    },\n  ],\n  options: [\n    {\n      id: \"model\",\n      // string (not enum) so any model id works without a code change — native\n      // Claude ids, or a gateway id when a gateway mode is selected. Applied as\n      // a `--model <id>` spawn arg → SDK options.model.\n      type: \"string\" as const,\n      description:\n        \"Model id → SDK options.model, applied as a `--model` arg at spawn. \" +\n        \"Native Claude (e.g. 'claude-opus-4-8', 'claude-sonnet-5') in the \" +\n        \"default mode, or a gateway id when mode is moonshot/openrouter \" +\n        \"(e.g. 'kimi-k2.7-code', 'z-ai/glm-5.2'). Omit for the mode's default.\",\n      bin_args_template: [\"--model\", \"{value}\"],\n    },\n    {\n      id: \"base_url\",\n      // Injected into the child env as ANTHROPIC_BASE_URL — keeps the harness\n      // Anthropic-native while fronting real Anthropic, a cloud provider, or an\n      // Anthropic-compatible gateway (LiteLLM / claude-code-router). When set,\n      // buildQueryOptions also pins every model tier to `model` (gateway mode).\n      type: \"string\" as const,\n      description:\n        \"Custom Anthropic base URL. Injected as ANTHROPIC_BASE_URL in the \" +\n        \"child env — front real Anthropic, Bedrock/Vertex/Azure, or an \" +\n        \"Anthropic-compatible gateway. When set, every internal model tier \" +\n        \"(opus/sonnet/haiku/small-fast) is pinned to `model` so a single-model \" +\n        \"gateway never gets an unservable tier. Omit to use the default endpoint.\",\n      env: { ANTHROPIC_BASE_URL: \"{value}\" },\n    },\n    {\n      id: \"auth_token\",\n      // Injected into the child env as ANTHROPIC_AUTH_TOKEN — the SDK sends it\n      // as `Authorization: Bearer <token>`, which Anthropic-compatible gateways\n      // (Moonshot, OpenRouter) accept. Pair with base_url for a per-spawn key.\n      type: \"string\" as const,\n      description:\n        \"Bearer token for the Anthropic API or a compatible gateway. Injected \" +\n        \"as ANTHROPIC_AUTH_TOKEN in the child env (sent as `Authorization: \" +\n        \"Bearer`). Pair with base_url to target a gateway (e.g. Moonshot, \" +\n        \"OpenRouter) with a per-spawn key instead of the ambient \" +\n        \"ANTHROPIC_API_KEY. Omit to use ANTHROPIC_API_KEY from the environment.\",\n      env: { ANTHROPIC_AUTH_TOKEN: \"{value}\" },\n    },\n    {\n      id: \"thinking\",\n      // Bare flag → cli.ts parses `--thinking` → SDK options.thinking =\n      // { type: \"enabled\" }. Needed by thinking-gated gateway models such as\n      // kimi-k2.7-code, which reject a request that omits `thinking`.\n      type: \"boolean\" as const,\n      description:\n        \"Enable extended thinking (SDK options.thinking = { type: 'enabled' }). \" +\n        \"Required by thinking-gated gateway models such as Moonshot's \" +\n        \"kimi-k2.7-code, which reject a request without it. Off by default — \" +\n        \"native Claude models choose their own thinking behaviour.\",\n      bin_args_append_when_true: [\"--thinking\"],\n    },\n  ],\n  tags: [\"anthropic\", \"claude\", \"claude-agent-sdk\", \"agentproto\", \"acp\", \"first-party\"],\n})\n\nexport function claudeSdkRuntime(): AgentCliRuntime {\n  return createAgentCliRuntime(claudeSdk)\n}\n\nexport {\n  ClaudeSdkAcpAgent,\n  promptText,\n  type QueryFn,\n} from \"./acp-host.js\"\nexport {\n  buildQueryOptions,\n  mapAcpMcpServers,\n  DEFAULT_MODEL,\n  type ClaudeSdkConfig,\n} from \"./options.js\"\nexport {\n  sdkMessageToUpdates,\n  assistantMessageUpdates,\n  userMessageUpdates,\n  resultUsageUpdate,\n  systemInitSessionId,\n  toolKindForClaudeTool,\n  toolCallTitle,\n  type UsageSessionUpdate,\n} from \"./message-map.js\"\nexport { runAcpOverStdio } from \"./run.js\"\nexport type { AgentCliHandle, AgentCliRuntime }\n"]}

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@agentproto/adapter-claude-sdk",
+  "version": "0.2.0",
+  "description": "@agentproto/adapter-claude-sdk — first-party agentproto adapter that runs Claude Code's agent harness as a library via the Claude Agent SDK headless query(), behind an AIP-44 ACP server. 100% Anthropic-native I/O; clean model pinning + base_url; native usage telemetry.",
+  "keywords": [
+    "agentproto",
+    "aip-42",
+    "aip-44",
+    "aip-45",
+    "anthropic",
+    "claude",
+    "claude-agent-sdk",
+    "acp",
+    "agent-cli",
+    "adapter"
+  ],
+  "homepage": "https://agentproto.sh/docs/aip-45",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/agentproto/ts",
+    "directory": "adapters/claude-sdk"
+  },
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.mjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "agentproto-claude-sdk": "dist/cli.mjs"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "default": "./dist/index.mjs"
+    },
+    "./claude-sdk.ACP.md": "./claude-sdk.ACP.md",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "claude-sdk.ACP.md",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@agentclientprotocol/sdk": "^0.21.0",
+    "@anthropic-ai/claude-agent-sdk": "^0.3.200",
+    "@agentproto/driver-agent-cli": "0.4.0",
+    "@agentproto/provider-presets": "0.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.2",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4",
+    "@agentproto/tooling": "0.1.0-alpha.0"
+  },
+  "scripts": {
+    "dev": "tsup --watch",
+    "build": "tsup",
+    "clean": "rm -rf dist",
+    "check-types": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest"
+  }
+}