@agentproto/adapter-claude-code-cloud 0.0.0-stage → 0.1.0

package/dist/index.mjs

@@ -0,0 +1,114 @@
+export { CLAUDE_CODE_GATEWAY_ENV_UNSET, ClaudeCloudAcpAgent, POLL_INITIAL_MS, POLL_MAX_MS, SessionsApi, cloudChildEnv, defaultCloudCliRunner, defaultGitRunner, envCredentialSource, keychainCredentialSource, normalizeSessionId, parseAuthStatus, parseCloudStartOutput, preflightAuth, resultEventUpdates, resultStopReason, runAcpOverStdio, sendPrompt, startCloudSession, toCliSessionId, validateRepoSource } from './chunk-KA4G4O2X.mjs';
+import { fileURLToPath } from 'url';
+import { defineAgentCli, createAgentCliRuntime } from '@agentproto/driver-agent-cli';
+
+/**
+ * @agentproto/adapter-claude-code-cloud v0.1.0
+ * AIP-66 managed cloud agent adapter: Claude Code cloud sessions behind ACP.
+ */
+var acpBin = fileURLToPath(
+  new URL("../bin/claude-code-cloud-acp.mjs", import.meta.url)
+);
+var CLOUD_REFUSED_SPAWN_FIELDS = [
+  "sandbox",
+  "worktree",
+  "commandSandbox",
+  "mcpServers",
+  "daemonMount",
+  "bundles",
+  "browser",
+  "appServe",
+  "inference"
+];
+var claudeCodeCloud = defineAgentCli({
+  name: "claude-code-cloud",
+  id: "claude-code-cloud",
+  description: "AIP-66 managed cloud agent adapter for Anthropic Claude Code cloud sessions. The vendor owns the machine and the harness: starts via `claude --cloud` (TTY), prompts via `claude -p --cloud <id>`, observes via the Claude Code sessions API, projected onto stdio ACP. Refuses the AIP-66 \xA74 spawn fields (sandbox, worktree, commandSandbox, mcpServers, daemonMount, bundles, browser, appServe, inference) \u2014 the vendor can never apply them. Requires a claude.ai sign-in (API-key auth is refused) and a clean, pushed git checkout.",
+  version: "0.1.0",
+  bin: "node",
+  bin_args: [acpBin],
+  install: [
+    {
+      method: "npm",
+      package: "@agentproto/adapter-claude-code-cloud",
+      global: true
+    }
+  ],
+  // Presence probe against the vendor client this adapter relays to — the
+  // pinned floor is the oldest CLI observed to support `--cloud` / the
+  // sessions API (AIP-66 Appendix A: 2.1.296–2.1.299).
+  version_check: {
+    cmd: "claude --version",
+    parse: "(\\d+\\.\\d+\\.\\d+)",
+    range: ">=2.1.296",
+    timeout_ms: 15e3
+  },
+  // Auth is the user's OWN claude.ai login inside the claude CLI (keychain
+  // on macOS) — never an injected env credential (AIP-66 §8). No `state.env`
+  // because an API-key env would be scrubbed, not consumed; the preflight
+  // refuses an api_key-authenticated CLI outright.
+  auth: {
+    ref: "./CLAUDE-CODE-CLOUD.md",
+    login: {
+      cmd: "claude auth login",
+      interactive: true
+    }
+  },
+  // The machine is the vendor's; there is no host-side sandbox to describe.
+  sandbox: "Managed cloud (AIP-66): the vendor boots the machine and runs Claude Code on it. No agentproto daemon runs inside; the session URL is surfaced so the user can inspect what ran.",
+  protocol: "acp",
+  acp: "./CLAUDE-CODE-CLOUD.md",
+  session: {
+    // One agentproto session = one vendor cloud session (AIP-66 §5);
+    // follow-up turns send to the same vendor session.
+    mode: "persistent",
+    idle_timeout_ms: 18e5,
+    context_carryover: true
+  },
+  // NO `models` menu: the vendor picks and bills the model inside its own
+  // harness; the host has no model to select or route (AIP-66 §4 — `model`
+  // is only meaningful when the vendor client accepts it, and this CLI's
+  // cloud path exposes no model flag).
+  capabilities: {
+    // Turns stream back as ACP updates while the vendor runs them.
+    streaming: true,
+    // The vendor harness's own tools (Read/Edit/Bash/…) surface as ACP
+    // tool_call / tool_call_update updates from the session's events.
+    tool_calls: true,
+    sub_agents: false,
+    file_io: true,
+    multimodal: false,
+    // Re-attach is via the persisted vendor session id (AIP-66 §5), not an
+    // ACP session/load replay.
+    resumable: true,
+    // Send-only prompting: the CLI never returns the reply on the prompt
+    // path; the reply is observed via the sessions API.
+    bidirectional: false
+  },
+  tags: [
+    "claude-code",
+    "anthropic",
+    "cloud",
+    "aip-66",
+    "acp",
+    "agent-runtime",
+    "coding"
+  ],
+  metadata: {
+    aip: 66,
+    // The harness the vendor runs (AIP-66 §2 CloudVendor.harnesses).
+    harness: "claude-code",
+    cloud: {
+      vendor: "anthropic"
+    },
+    // AIP-66 §4 refused spawn fields, machine-readable for the host gate.
+    refusedSpawnFields: [...CLOUD_REFUSED_SPAWN_FIELDS]
+  }
+});
+function claudeCodeCloudRuntime() {
+  return createAgentCliRuntime(claudeCodeCloud);
+}
+
+export { CLOUD_REFUSED_SPAWN_FIELDS, claudeCodeCloud, claudeCodeCloudRuntime };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;AA4BA,IAAM,MAAA,GAAS,aAAA;AAAA,EACb,IAAI,GAAA,CAAI,kCAAA,EAAoC,MAAA,CAAA,IAAA,CAAY,GAAG;AAC7D,CAAA;AAMO,IAAM,0BAAA,GAA6B;AAAA,EACxC,SAAA;AAAA,EACA,UAAA;AAAA,EACA,gBAAA;AAAA,EACA,YAAA;AAAA,EACA,aAAA;AAAA,EACA,SAAA;AAAA,EACA,SAAA;AAAA,EACA,UAAA;AAAA,EACA;AACF;AAEO,IAAM,kBAAkC,cAAA,CAAe;AAAA,EAC5D,IAAA,EAAM,mBAAA;AAAA,EACN,EAAA,EAAI,mBAAA;AAAA,EACJ,WAAA,EACE,ohBAAA;AAAA,EAQF,OAAA,EAAS,OAAA;AAAA,EACT,GAAA,EAAK,MAAA;AAAA,EACL,QAAA,EAAU,CAAC,MAAM,CAAA;AAAA,EACjB,OAAA,EAAS;AAAA,IACP;AAAA,MACE,MAAA,EAAQ,KAAA;AAAA,MACR,OAAA,EAAS,uCAAA;AAAA,MACT,MAAA,EAAQ;AAAA;AACV,GACF;AAAA;AAAA;AAAA;AAAA,EAIA,aAAA,EAAe;AAAA,IACb,GAAA,EAAK,kBAAA;AAAA,IACL,KAAA,EAAO,sBAAA;AAAA,IACP,KAAA,EAAO,WAAA;AAAA,IACP,UAAA,EAAY;AAAA,GACd;AAAA;AAAA;AAAA;AAAA;AAAA,EAKA,IAAA,EAAM;AAAA,IACJ,GAAA,EAAK,wBAAA;AAAA,IACL,KAAA,EAAO;AAAA,MACL,GAAA,EAAK,mBAAA;AAAA,MACL,WAAA,EAAa;AAAA;AACf,GACF;AAAA;AAAA,EAEA,OAAA,EACE,kLAAA;AAAA,EAGF,QAAA,EAAU,KAAA;AAAA,EACV,GAAA,EAAK,wBAAA;AAAA,EACL,OAAA,EAAS;AAAA;AAAA;AAAA,IAGP,IAAA,EAAM,YAAA;AAAA,IACN,eAAA,EAAiB,IAAA;AAAA,IACjB,iBAAA,EAAmB;AAAA,GACrB;AAAA;AAAA;AAAA;AAAA;AAAA,EAKA,YAAA,EAAc;AAAA;AAAA,IAEZ,SAAA,EAAW,IAAA;AAAA;AAAA;AAAA,IAGX,UAAA,EAAY,IAAA;AAAA,IACZ,UAAA,EAAY,KAAA;AAAA,IACZ,OAAA,EAAS,IAAA;AAAA,IACT,UAAA,EAAY,KAAA;AAAA;AAAA;AAAA,IAGZ,SAAA,EAAW,IAAA;AAAA;AAAA;AAAA,IAGX,aAAA,EAAe;AAAA,GACjB;AAAA,EACA,IAAA,EAAM;AAAA,IACJ,aAAA;AAAA,IACA,WAAA;AAAA,IACA,OAAA;AAAA,IACA,QAAA;AAAA,IACA,KAAA;AAAA,IACA,eAAA;AAAA,IACA;AAAA,GACF;AAAA,EACA,QAAA,EAAU;AAAA,IACR,GAAA,EAAK,EAAA;AAAA;AAAA,IAEL,OAAA,EAAS,aAAA;AAAA,IACT,KAAA,EAAO;AAAA,MACL,MAAA,EAAQ;AAAA,KACV;AAAA;AAAA,IAEA,kBAAA,EAAoB,CAAC,GAAG,0BAA0B;AAAA;AAEtD,CAAC;AAEM,SAAS,sBAAA,GAA0C;AACxD,EAAA,OAAO,sBAAsB,eAAe,CAAA;AAC9C","file":"index.mjs","sourcesContent":["/**\n * @agentproto/adapter-claude-code-cloud — AIP-66 managed cloud agent adapter\n * for Anthropic Claude Code cloud sessions.\n *\n * Unlike `@agentproto/adapter-claude-code` (local harness, host machine),\n * this adapter relays a session the VENDOR hosts end to end: the vendor\n * boots the machine, runs Claude Code in it, and exposes the session\n * through `claude --cloud` / `claude -p --cloud` plus the undocumented\n * Claude Code sessions API. No agentproto daemon runs inside; the host\n * controls neither the machine nor the harness — so this manifest is\n * deliberately smaller and refuses the spawn fields that could never take\n * effect (AIP-66 §4).\n *\n *   import { claudeCodeCloud } from \"@agentproto/adapter-claude-code-cloud\"\n */\n\nimport { fileURLToPath } from \"node:url\"\nimport {\n  createAgentCliRuntime,\n  defineAgentCli,\n  type AgentCliHandle,\n  type AgentCliRuntime,\n} from \"@agentproto/driver-agent-cli\"\n\n// Self-locating: the built handle spawns `node <this-pkg>/bin/…\n// claude-code-cloud-acp.mjs`. From dist/index.mjs the bin sits one level up,\n// so the same build works whether the daemon resolves this package from\n// node_modules or a user runs the published bin directly.\nconst acpBin = fileURLToPath(\n  new URL(\"../bin/claude-code-cloud-acp.mjs\", import.meta.url),\n)\n\n// AIP-66 §4 refused spawn fields — no meaning for a vendor-owned harness, so\n// the host MUST refuse a cloud spawn that sets any of them rather than\n// ignore them. Documented here (and in CLAUDE-CODE-CLOUD.md) so the runtime\n// gate and users share one list.\nexport const CLOUD_REFUSED_SPAWN_FIELDS = [\n  \"sandbox\",\n  \"worktree\",\n  \"commandSandbox\",\n  \"mcpServers\",\n  \"daemonMount\",\n  \"bundles\",\n  \"browser\",\n  \"appServe\",\n  \"inference\",\n] as const\n\nexport const claudeCodeCloud: AgentCliHandle = defineAgentCli({\n  name: \"claude-code-cloud\",\n  id: \"claude-code-cloud\",\n  description:\n    \"AIP-66 managed cloud agent adapter for Anthropic Claude Code cloud \" +\n    \"sessions. The vendor owns the machine and the harness: starts via \" +\n    \"`claude --cloud` (TTY), prompts via `claude -p --cloud <id>`, observes \" +\n    \"via the Claude Code sessions API, projected onto stdio ACP. Refuses \" +\n    \"the AIP-66 §4 spawn fields (sandbox, worktree, commandSandbox, \" +\n    \"mcpServers, daemonMount, bundles, browser, appServe, inference) — the \" +\n    \"vendor can never apply them. Requires a claude.ai sign-in (API-key \" +\n    \"auth is refused) and a clean, pushed git checkout.\",\n  version: \"0.1.0\",\n  bin: \"node\",\n  bin_args: [acpBin],\n  install: [\n    {\n      method: \"npm\",\n      package: \"@agentproto/adapter-claude-code-cloud\",\n      global: true,\n    },\n  ],\n  // Presence probe against the vendor client this adapter relays to — the\n  // pinned floor is the oldest CLI observed to support `--cloud` / the\n  // sessions API (AIP-66 Appendix A: 2.1.296–2.1.299).\n  version_check: {\n    cmd: \"claude --version\",\n    parse: \"(\\\\d+\\\\.\\\\d+\\\\.\\\\d+)\",\n    range: \">=2.1.296\",\n    timeout_ms: 15_000,\n  },\n  // Auth is the user's OWN claude.ai login inside the claude CLI (keychain\n  // on macOS) — never an injected env credential (AIP-66 §8). No `state.env`\n  // because an API-key env would be scrubbed, not consumed; the preflight\n  // refuses an api_key-authenticated CLI outright.\n  auth: {\n    ref: \"./CLAUDE-CODE-CLOUD.md\",\n    login: {\n      cmd: \"claude auth login\",\n      interactive: true,\n    },\n  },\n  // The machine is the vendor's; there is no host-side sandbox to describe.\n  sandbox:\n    \"Managed cloud (AIP-66): the vendor boots the machine and runs Claude \" +\n    \"Code on it. No agentproto daemon runs inside; the session URL is \" +\n    \"surfaced so the user can inspect what ran.\",\n  protocol: \"acp\",\n  acp: \"./CLAUDE-CODE-CLOUD.md\",\n  session: {\n    // One agentproto session = one vendor cloud session (AIP-66 §5);\n    // follow-up turns send to the same vendor session.\n    mode: \"persistent\",\n    idle_timeout_ms: 1_800_000,\n    context_carryover: true,\n  },\n  // NO `models` menu: the vendor picks and bills the model inside its own\n  // harness; the host has no model to select or route (AIP-66 §4 — `model`\n  // is only meaningful when the vendor client accepts it, and this CLI's\n  // cloud path exposes no model flag).\n  capabilities: {\n    // Turns stream back as ACP updates while the vendor runs them.\n    streaming: true,\n    // The vendor harness's own tools (Read/Edit/Bash/…) surface as ACP\n    // tool_call / tool_call_update updates from the session's events.\n    tool_calls: true,\n    sub_agents: false,\n    file_io: true,\n    multimodal: false,\n    // Re-attach is via the persisted vendor session id (AIP-66 §5), not an\n    // ACP session/load replay.\n    resumable: true,\n    // Send-only prompting: the CLI never returns the reply on the prompt\n    // path; the reply is observed via the sessions API.\n    bidirectional: false,\n  },\n  tags: [\n    \"claude-code\",\n    \"anthropic\",\n    \"cloud\",\n    \"aip-66\",\n    \"acp\",\n    \"agent-runtime\",\n    \"coding\",\n  ],\n  metadata: {\n    aip: 66,\n    // The harness the vendor runs (AIP-66 §2 CloudVendor.harnesses).\n    harness: \"claude-code\",\n    cloud: {\n      vendor: \"anthropic\",\n    },\n    // AIP-66 §4 refused spawn fields, machine-readable for the host gate.\n    refusedSpawnFields: [...CLOUD_REFUSED_SPAWN_FIELDS],\n  },\n})\n\nexport function claudeCodeCloudRuntime(): AgentCliRuntime {\n  return createAgentCliRuntime(claudeCodeCloud)\n}\n\nexport {\n  ClaudeCloudAcpAgent,\n  runAcpOverStdio,\n  resultEventUpdates,\n  resultStopReason,\n  POLL_INITIAL_MS,\n  POLL_MAX_MS,\n  type ClaudeCloudAcpDeps,\n  type CloudCliDeps,\n  type CloudEventsClient,\n} from \"./acp-server.js\"\nexport {\n  cloudChildEnv,\n  defaultCloudCliRunner,\n  parseAuthStatus,\n  parseCloudStartOutput,\n  preflightAuth,\n  sendPrompt,\n  startCloudSession,\n  CLAUDE_CODE_GATEWAY_ENV_UNSET,\n  type AuthStatus,\n  type CloudCliRunner,\n  type RunOpts,\n  type RunResult,\n  type StartedCloudSession,\n} from \"./cli.js\"\nexport {\n  SessionsApi,\n  envCredentialSource,\n  keychainCredentialSource,\n  normalizeSessionId,\n  toCliSessionId,\n  type CloudCredential,\n  type CloudEventsPage,\n  type CloudGetSessionResponse,\n  type CloudSessionEvent,\n  type CloudSessionState,\n  type CloudSessionSummary,\n  type CredentialSource,\n  type SessionsApiOptions,\n} from \"./sessions-api.js\"\nexport {\n  validateRepoSource,\n  defaultGitRunner,\n  type GitRunner,\n} from \"./repo-source.js\"\nexport type { AgentCliHandle, AgentCliRuntime }\n"]}

package/package.json

@@ -1,6 +1,74 @@
 {
   "name": "@agentproto/adapter-claude-code-cloud",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "@agentproto/adapter-claude-code-cloud — AIP-66 managed-cloud-agent adapter for Anthropic Claude Code cloud sessions. Relays `claude --cloud` / `claude -p --cloud` and the undocumented Claude Code sessions API behind an AIP-44 ACP server; the vendor owns the machine and the harness, no agentproto daemon runs inside.",
+  "keywords": [
+    "agentproto",
+    "aip-44",
+    "aip-45",
+    "aip-66",
+    "claude-code",
+    "anthropic",
+    "cloud",
+    "acp",
+    "agent-cli",
+    "adapter"
+  ],
+  "homepage": "https://agentproto.sh/docs/aip-45",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/agentproto/ts",
+    "directory": "adapters/claude-code-cloud"
+  },
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "dist/index.mjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "agentproto-claude-code-cloud-acp": "./bin/claude-code-cloud-acp.mjs"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "default": "./dist/index.mjs"
+    },
+    "./CLAUDE-CODE-CLOUD.md": "./CLAUDE-CODE-CLOUD.md",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "CLAUDE-CODE-CLOUD.md",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@agentclientprotocol/sdk": "^0.21.1",
+    "@agentproto/adapter-claude-sdk": "0.7.24",
+    "@agentproto/driver-agent-cli": "2.13.0",
+    "@agentproto/provider-presets": "0.7.0"
+  },
+  "optionalDependencies": {
+    "node-pty": "^1.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.5",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.7",
+    "@agentproto/tooling": "0.1.0"
+  },
+  "scripts": {
+    "dev": "tsup --watch",
+    "build": "tsup",
+    "clean": "rm -rf dist",
+    "check-types": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest"
+  }
 }