@agentproto/cli 0.1.0-alpha.0

package/LICENSE

@@ -0,0 +1 @@
+MIT License — Copyright (c) 2026 agentproto contributors

package/README.md

@@ -0,0 +1,61 @@
+# @agentproto/cli
+
+The `agentproto` binary — install, run, and serve [AIP-45 agent CLIs](https://agentproto.sh/docs/aip-45).
+
+```bash
+npm install -g @agentproto/cli
+```
+
+This installs the `agentproto` executable on your `PATH`.
+
+## Verbs
+
+```text
+agentproto install <slug>            install an adapter's underlying CLI
+agentproto run     <slug> [opts]     spawn the adapter, dispatch a turn, stream events
+agentproto serve   --connect <url>   long-running daemon (relays spawns over a tunnel)
+```
+
+### `run`
+
+```bash
+# install an adapter package once
+npm i -g @agentproto/adapter-claude-code
+
+# run a one-shot turn against the current directory
+agentproto run claude-code --cwd . --prompt "what does this repo do?"
+
+# pipe a prompt over stdin
+echo "summarise CHANGELOG.md" | agentproto run claude-code
+
+# resume an existing protocol session
+agentproto run claude-code --resume <session-id>
+```
+
+Output is human-readable by default; pass `--json` for one-event-per-line NDJSON.
+
+### `install`
+
+```bash
+agentproto install claude-code              # idempotent, skips if version_check passes
+agentproto install claude-code --force      # reinstall regardless
+agentproto install claude-code --dry-run    # print steps, don't execute
+```
+
+v0.1 implements the `npm` install method; other package managers print a clear "not yet" message and exit non-zero.
+
+### `serve` *(coming soon)*
+
+Long-running daemon that exposes locally-installed adapters to a remote host over a WebSocket tunnel. Wire protocol still being designed; the verb is parsed but currently exits 64 with a tracking message.
+
+## Adapter resolution
+
+`<slug>` resolves to the npm package `@agentproto/adapter-<slug>`. Install adapters globally so `agentproto` can find them on its `NODE_PATH`. Built-in adapters as of v0.1:
+
+- `@agentproto/adapter-claude-code` — Anthropic Claude Code via [@agentclientprotocol/claude-agent-acp](https://www.npmjs.com/package/@agentclientprotocol/claude-agent-acp)
+- `@agentproto/adapter-hermes` — generic Hermes-flavoured agents
+- `@agentproto/adapter-mastra` — Mastra agents
+
+## License
+
+MIT — see [LICENSE](./LICENSE).

package/dist/cli.mjs

@@ -0,0 +1,371 @@
+#!/usr/bin/env node
+import { parseArgs } from 'util';
+import { spawn } from 'child_process';
+import { resolve } from 'path';
+import { createAgentCliRuntime } from '@agentproto/driver-agent-cli';
+
+/**
+ * @agentproto/cli v0.1.0-alpha
+ * The `agentproto` binary — install / run / serve AIP-45 agent CLIs.
+ */
+
+
+// src/registry/resolve.ts
+var slugToCamel = (slug) => slug.replace(/-([a-z0-9])/g, (_, c) => c.toUpperCase());
+async function resolveAdapter(slug) {
+  if (!/^[a-z][a-z0-9-]*$/.test(slug)) {
+    throw new Error(
+      `agentproto: invalid adapter slug '${slug}'. Slugs are lower-kebab.`
+    );
+  }
+  const packageName = `@agentproto/adapter-${slug}`;
+  let mod;
+  try {
+    mod = await import(packageName);
+  } catch (err) {
+    const cause = err instanceof Error ? err.message : String(err);
+    throw new Error(
+      `agentproto: could not load adapter '${slug}'. Tried '${packageName}'. Install it with: npm i -g ${packageName}
+  cause: ${cause}`
+    );
+  }
+  const camel = slugToCamel(slug);
+  const candidate = mod[camel] ?? mod.default ?? mod.handle;
+  if (!candidate || typeof candidate !== "object" || !("name" in candidate)) {
+    throw new Error(
+      `agentproto: adapter '${packageName}' does not export an AgentCliHandle (looked for export '${camel}', 'default', or 'handle').`
+    );
+  }
+  return { slug, handle: candidate, source: "npm", packageName };
+}
+
+// src/commands/install.ts
+async function runInstall(args) {
+  const { values, positionals } = parseArgs({
+    args: [...args],
+    allowPositionals: true,
+    strict: true,
+    options: {
+      force: { type: "boolean", short: "f" },
+      "dry-run": { type: "boolean" }
+    }
+  });
+  const slug = positionals[0];
+  if (!slug) {
+    process.stderr.write(
+      "agentproto install: missing adapter slug. Try: agentproto install claude-code\n"
+    );
+    return 2;
+  }
+  const adapter = await resolveAdapter(slug);
+  const installSteps = adapter.handle.install ?? [];
+  if (installSteps.length === 0) {
+    process.stderr.write(
+      `agentproto install: adapter '${slug}' declares no install steps.
+`
+    );
+    return 0;
+  }
+  if (!values.force) {
+    const checked = await runVersionCheck(adapter.handle.version_check);
+    if (checked.ok) {
+      process.stdout.write(
+        `agentproto: '${slug}' already installed (${checked.message}). Pass --force to reinstall.
+`
+      );
+      return 0;
+    }
+  }
+  for (const [i, step] of installSteps.entries()) {
+    process.stdout.write(
+      `agentproto install [${i + 1}/${installSteps.length}] ${describeStep(step)}
+`
+    );
+    if (values["dry-run"]) continue;
+    const code = await runStep(step);
+    if (code !== 0) {
+      process.stderr.write(
+        `agentproto install: step ${i + 1} failed with exit ${code}.
+`
+      );
+      return code;
+    }
+  }
+  process.stdout.write(`agentproto: '${slug}' installed.
+`);
+  return 0;
+}
+function describeStep(step) {
+  switch (step.method) {
+    case "npm":
+      return `npm install ${step.global ? "-g " : ""}${step.package ?? "(?)"}`;
+    case "brew":
+      return `brew install ${step.package ?? "(?)"}`;
+    case "pip":
+      return `pip install ${step.package ?? "(?)"}`;
+    case "cargo":
+      return `cargo install ${step.package ?? "(?)"}`;
+    case "go":
+      return `go install ${step.package ?? "(?)"}`;
+    case "curl":
+    case "download":
+      return `${step.method} ${step.url ?? "(?)"} \u2192 ${step.path ?? "(default)"}`;
+    default:
+      return `${step.method} ${step.package ?? step.url ?? "(?)"}`;
+  }
+}
+async function runStep(step) {
+  switch (step.method) {
+    case "npm": {
+      if (!step.package) {
+        process.stderr.write("agentproto install: npm step missing package.\n");
+        return 2;
+      }
+      const argv = ["install"];
+      if (step.global) argv.push("-g");
+      argv.push(step.package);
+      return spawnInherit("npm", argv);
+    }
+    default:
+      process.stderr.write(
+        `agentproto install: method '${step.method}' not yet implemented in this CLI version. Run it manually for now (see the adapter's INSTALL.md).
+`
+      );
+      return 1;
+  }
+}
+function spawnInherit(cmd, argv) {
+  return new Promise((resolve, reject) => {
+    const child = spawn(cmd, argv, { stdio: "inherit" });
+    child.once("error", reject);
+    child.once("exit", (code) => resolve(code ?? 0));
+  });
+}
+async function runVersionCheck(check) {
+  if (!check) return { ok: false, message: "no version_check declared" };
+  return new Promise((resolve) => {
+    const child = spawn("bash", ["-lc", check.cmd], {
+      stdio: ["ignore", "pipe", "ignore"]
+    });
+    let buf = "";
+    child.stdout.on("data", (c) => {
+      buf += c.toString("utf8");
+    });
+    child.once("error", () => resolve({ ok: false, message: "check failed" }));
+    child.once("exit", (code) => {
+      if (code !== 0) {
+        resolve({ ok: false, message: `check exited ${code}` });
+        return;
+      }
+      const re = new RegExp(check.parse);
+      const m = buf.match(re);
+      if (!m || !m[1]) {
+        resolve({ ok: false, message: "could not parse version" });
+        return;
+      }
+      resolve({ ok: true, message: `version ${m[1]}` });
+    });
+  });
+}
+
+// src/util/stdin.ts
+async function readStdinIfPiped() {
+  if (process.stdin.isTTY) return null;
+  const chunks = [];
+  for await (const chunk of process.stdin) {
+    chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+  }
+  const text = Buffer.concat(chunks).toString("utf8").trim();
+  return text.length > 0 ? text : null;
+}
+
+// src/commands/run.ts
+async function runRun(args) {
+  const { values, positionals } = parseArgs({
+    args: [...args],
+    allowPositionals: true,
+    strict: true,
+    options: {
+      cwd: { type: "string" },
+      prompt: { type: "string", short: "p" },
+      resume: { type: "string" },
+      json: { type: "boolean" }
+    }
+  });
+  const slug = positionals[0];
+  if (!slug) {
+    process.stderr.write(
+      "agentproto run: missing adapter slug. Try: agentproto run claude-code\n"
+    );
+    return 2;
+  }
+  const cwd = values.cwd ? resolve(values.cwd) : process.cwd();
+  const promptArg = values.prompt ?? await readStdinIfPiped();
+  if (!promptArg) {
+    process.stderr.write(
+      "agentproto run: no prompt provided. Pass --prompt or pipe one over stdin.\n"
+    );
+    return 2;
+  }
+  const adapter = await resolveAdapter(slug);
+  const runtime = createAgentCliRuntime(adapter.handle);
+  const controller = new AbortController();
+  const onSignal = (sig) => {
+    process.stderr.write(`
+agentproto: received ${sig}, cancelling\u2026
+`);
+    controller.abort();
+  };
+  process.once("SIGINT", onSignal);
+  process.once("SIGTERM", onSignal);
+  let session = null;
+  try {
+    session = await runtime.start({
+      cwd,
+      signal: controller.signal,
+      resumeSessionId: values.resume
+    });
+    const printer = values.json ? printJson : printPretty;
+    let exit = 0;
+    for await (const ev of session.send(promptArg)) {
+      printer(ev);
+      if (ev.kind === "turn-end" && ev.reason !== "completed") exit = 1;
+      if (ev.kind === "error") exit = 1;
+    }
+    return exit;
+  } finally {
+    process.off("SIGINT", onSignal);
+    process.off("SIGTERM", onSignal);
+    if (session) await session.close().catch(() => {
+    });
+  }
+}
+function printJson(ev) {
+  process.stdout.write(`${JSON.stringify(ev)}
+`);
+}
+function printPretty(ev) {
+  switch (ev.kind) {
+    case "text-delta":
+      process.stdout.write(ev.text);
+      break;
+    case "thought":
+      process.stderr.write(`\x1B[2m[thought] ${ev.text}\x1B[0m
+`);
+      break;
+    case "tool-call":
+      process.stderr.write(`\x1B[36m[tool] ${ev.toolName}\x1B[0m
+`);
+      break;
+    case "tool-result":
+      if (ev.isError)
+        process.stderr.write(`\x1B[31m[tool-error]\x1B[0m
+`);
+      break;
+    case "agent-prompt":
+      process.stderr.write(`\x1B[33m[agent-prompt: needs input]\x1B[0m
+`);
+      break;
+    case "turn-end":
+      process.stdout.write(`
+\x1B[2m[turn-end: ${ev.reason}]\x1B[0m
+`);
+      break;
+    case "error":
+      process.stderr.write(`\x1B[31m[error] ${ev.error.message}\x1B[0m
+`);
+      break;
+  }
+}
+async function runServe(args) {
+  const { values } = parseArgs({
+    args: [...args],
+    allowPositionals: false,
+    strict: true,
+    options: {
+      connect: { type: "string", short: "c" },
+      token: { type: "string", short: "t" },
+      label: { type: "string", short: "l" }
+    }
+  });
+  if (!values.connect) {
+    process.stderr.write(
+      "agentproto serve: --connect <url> is required.\n  example: agentproto serve --connect wss://guilde.work/api/v1/agentproto/tunnel --token $TOKEN\n"
+    );
+    return 2;
+  }
+  process.stderr.write(
+    `agentproto serve: tunnel daemon is not yet implemented in this release.
+  Tracking: tunnel frame protocol is landing in @agentproto/acp next.
+  Wanted endpoint: ${values.connect}
+  Label:           ${values.label ?? "(none)"}
+`
+  );
+  return 64;
+}
+
+// src/cli.ts
+var USAGE = `agentproto \u2014 AIP-45 agent CLI host
+
+Usage:
+  agentproto install <slug> [--registry <path>]
+  agentproto run     <slug> [--cwd <dir>] [--prompt <text>] [--resume <session-id>]
+  agentproto serve   --connect <url> [--token <jwt>] [--label <name>]
+  agentproto --help
+  agentproto --version
+
+Examples:
+  agentproto install claude-code
+  agentproto run claude-code --cwd . --prompt "summarise this repo"
+  agentproto serve --connect wss://guilde.work/api/v1/agentproto/tunnel --token $AGENTPROTO_TOKEN
+`;
+async function main(argv) {
+  const { values, positionals } = parseArgs({
+    args: [...argv],
+    allowPositionals: true,
+    strict: false,
+    options: {
+      help: { type: "boolean", short: "h" },
+      version: { type: "boolean", short: "v" }
+    }
+  });
+  if (values.help) {
+    process.stdout.write(USAGE);
+    return 0;
+  }
+  if (values.version) {
+    process.stdout.write("agentproto 0.1.0-alpha\n");
+    return 0;
+  }
+  const [verb, ...rest] = positionals;
+  if (!verb) {
+    process.stdout.write(USAGE);
+    return 0;
+  }
+  switch (verb) {
+    case "install":
+      return runInstall(rest);
+    case "run":
+      return runRun(rest);
+    case "serve":
+      return runServe(rest);
+    default:
+      process.stderr.write(`agentproto: unknown verb '${verb}'
+
+${USAGE}`);
+      return 2;
+  }
+}
+main(process.argv.slice(2)).then(
+  (code) => {
+    process.exitCode = code;
+  },
+  (err) => {
+    const msg = err instanceof Error ? err.stack ?? err.message : String(err);
+    process.stderr.write(`agentproto: ${msg}
+`);
+    process.exitCode = 1;
+  }
+);
+//# sourceMappingURL=cli.mjs.map
+//# sourceMappingURL=cli.mjs.map

package/dist/cli.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/registry/resolve.ts","../src/commands/install.ts","../src/util/stdin.ts","../src/commands/run.ts","../src/commands/serve.ts","../src/cli.ts"],"names":["parseArgs","resolvePath"],"mappings":"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","file":"cli.mjs","sourcesContent":["/**\n * Resolve a slug like \"claude-code\" to a runnable `AgentCliHandle`.\n *\n * Resolution order:\n *   1. `@agentproto/adapter-<slug>` from npm (must default-export or\n *      named-export an `AgentCliHandle` — convention is the camelCased\n *      slug, e.g. `claudeCode`).\n *   2. (TODO) `~/.agentproto/adapters/<slug>/AGENT-CLI.md` on disk.\n *   3. (TODO) bundled fallbacks for the canonical adapters.\n *\n * Step 1 covers 100% of v0 usage. The on-disk path is only there for\n * users authoring their own adapters; we'll add it once `defineAgentCli`\n * supports MD-source authoring end to end.\n */\n\nimport type { AgentCliHandle } from \"@agentproto/driver-agent-cli\"\n\nexport interface ResolvedAdapter {\n  readonly slug: string\n  readonly handle: AgentCliHandle\n  readonly source: \"npm\" | \"file\" | \"bundled\"\n  readonly packageName?: string\n}\n\nconst slugToCamel = (slug: string): string =>\n  slug.replace(/-([a-z0-9])/g, (_, c: string) => c.toUpperCase())\n\nexport async function resolveAdapter(slug: string): Promise<ResolvedAdapter> {\n  if (!/^[a-z][a-z0-9-]*$/.test(slug)) {\n    throw new Error(\n      `agentproto: invalid adapter slug '${slug}'. Slugs are lower-kebab.`\n    )\n  }\n\n  const packageName = `@agentproto/adapter-${slug}`\n  let mod: Record<string, unknown>\n  try {\n    mod = (await import(packageName)) as Record<string, unknown>\n  } catch (err) {\n    const cause = err instanceof Error ? err.message : String(err)\n    throw new Error(\n      `agentproto: could not load adapter '${slug}'. ` +\n        `Tried '${packageName}'. Install it with: npm i -g ${packageName}\\n  cause: ${cause}`\n    )\n  }\n\n  const camel = slugToCamel(slug)\n  const candidate =\n    (mod[camel] as AgentCliHandle | undefined) ??\n    (mod.default as AgentCliHandle | undefined) ??\n    (mod.handle as AgentCliHandle | undefined)\n\n  if (!candidate || typeof candidate !== \"object\" || !(\"name\" in candidate)) {\n    throw new Error(\n      `agentproto: adapter '${packageName}' does not export an AgentCliHandle ` +\n        `(looked for export '${camel}', 'default', or 'handle').`\n    )\n  }\n\n  return { slug, handle: candidate, source: \"npm\", packageName }\n}\n","/**\n * `agentproto install <slug>`\n *\n * Reads the adapter manifest's `install` block and shells out to the\n * declared package manager. Idempotent: if `version_check` passes, we\n * skip and report \"already installed\" (override with --force).\n *\n * The adapter package itself must already be in node_modules (we resolve\n * it before reading its manifest). Bootstrapping the adapter package is\n * a separate concern — `npm i -g @agentproto/adapter-<slug>` first.\n *\n * v0 implements `npm` only. Other methods (brew/pip/cargo/go/curl/\n * download) report a clear \"not yet implemented\" message — they're a\n * shellout exercise but each needs its own checksum / chmod handling.\n */\n\nimport { spawn } from \"node:child_process\"\nimport { parseArgs } from \"node:util\"\nimport type { AgentCliInstallMethod } from \"@agentproto/driver-agent-cli\"\nimport { resolveAdapter } from \"../registry/resolve.js\"\n\nexport async function runInstall(args: readonly string[]): Promise<number> {\n  const { values, positionals } = parseArgs({\n    args: [...args],\n    allowPositionals: true,\n    strict: true,\n    options: {\n      force: { type: \"boolean\", short: \"f\" },\n      \"dry-run\": { type: \"boolean\" },\n    },\n  })\n\n  const slug = positionals[0]\n  if (!slug) {\n    process.stderr.write(\n      \"agentproto install: missing adapter slug. Try: agentproto install claude-code\\n\"\n    )\n    return 2\n  }\n\n  const adapter = await resolveAdapter(slug)\n  const installSteps: AgentCliInstallMethod[] = adapter.handle.install ?? []\n  if (installSteps.length === 0) {\n    process.stderr.write(\n      `agentproto install: adapter '${slug}' declares no install steps.\\n`\n    )\n    return 0\n  }\n\n  if (!values.force) {\n    const checked = await runVersionCheck(adapter.handle.version_check)\n    if (checked.ok) {\n      process.stdout.write(\n        `agentproto: '${slug}' already installed (${checked.message}). Pass --force to reinstall.\\n`\n      )\n      return 0\n    }\n  }\n\n  for (const [i, step] of installSteps.entries()) {\n    process.stdout.write(\n      `agentproto install [${i + 1}/${installSteps.length}] ${describeStep(step)}\\n`\n    )\n    if (values[\"dry-run\"]) continue\n    const code = await runStep(step)\n    if (code !== 0) {\n      process.stderr.write(\n        `agentproto install: step ${i + 1} failed with exit ${code}.\\n`\n      )\n      return code\n    }\n  }\n\n  process.stdout.write(`agentproto: '${slug}' installed.\\n`)\n  return 0\n}\n\nfunction describeStep(step: AgentCliInstallMethod): string {\n  switch (step.method) {\n    case \"npm\":\n      return `npm install ${step.global ? \"-g \" : \"\"}${step.package ?? \"(?)\"}`\n    case \"brew\":\n      return `brew install ${step.package ?? \"(?)\"}`\n    case \"pip\":\n      return `pip install ${step.package ?? \"(?)\"}`\n    case \"cargo\":\n      return `cargo install ${step.package ?? \"(?)\"}`\n    case \"go\":\n      return `go install ${step.package ?? \"(?)\"}`\n    case \"curl\":\n    case \"download\":\n      return `${step.method} ${step.url ?? \"(?)\"} → ${step.path ?? \"(default)\"}`\n    default:\n      return `${step.method} ${step.package ?? step.url ?? \"(?)\"}`\n  }\n}\n\nasync function runStep(step: AgentCliInstallMethod): Promise<number> {\n  switch (step.method) {\n    case \"npm\": {\n      if (!step.package) {\n        process.stderr.write(\"agentproto install: npm step missing package.\\n\")\n        return 2\n      }\n      const argv = [\"install\"]\n      if (step.global) argv.push(\"-g\")\n      argv.push(step.package)\n      return spawnInherit(\"npm\", argv)\n    }\n    default:\n      process.stderr.write(\n        `agentproto install: method '${step.method}' not yet implemented in this CLI version. ` +\n          `Run it manually for now (see the adapter's INSTALL.md).\\n`\n      )\n      return 1\n  }\n}\n\nfunction spawnInherit(cmd: string, argv: string[]): Promise<number> {\n  return new Promise((resolve, reject) => {\n    const child = spawn(cmd, argv, { stdio: \"inherit\" })\n    child.once(\"error\", reject)\n    child.once(\"exit\", (code) => resolve(code ?? 0))\n  })\n}\n\nasync function runVersionCheck(\n  check: Awaited<\n    ReturnType<typeof resolveAdapter>\n  >[\"handle\"][\"version_check\"]\n): Promise<{ ok: boolean; message: string }> {\n  if (!check) return { ok: false, message: \"no version_check declared\" }\n  return new Promise((resolve) => {\n    const child = spawn(\"bash\", [\"-lc\", check.cmd], {\n      stdio: [\"ignore\", \"pipe\", \"ignore\"],\n    })\n    let buf = \"\"\n    child.stdout.on(\"data\", (c: Buffer) => {\n      buf += c.toString(\"utf8\")\n    })\n    child.once(\"error\", () => resolve({ ok: false, message: \"check failed\" }))\n    child.once(\"exit\", (code) => {\n      if (code !== 0) {\n        resolve({ ok: false, message: `check exited ${code}` })\n        return\n      }\n      const re = new RegExp(check.parse)\n      const m = buf.match(re)\n      if (!m || !m[1]) {\n        resolve({ ok: false, message: \"could not parse version\" })\n        return\n      }\n      // semver-range matching is left to a future helper; we report\n      // the captured version and trust it. --force remains the\n      // escape hatch when range gating actually matters.\n      resolve({ ok: true, message: `version ${m[1]}` })\n    })\n  })\n}\n","/**\n * Read piped stdin to a string. Returns null if stdin is a TTY (no pipe).\n * Used by `agentproto run` to accept prompts via:\n *   echo \"summarise this repo\" | agentproto run claude-code\n */\n\nexport async function readStdinIfPiped(): Promise<string | null> {\n  if (process.stdin.isTTY) return null\n  const chunks: Buffer[] = []\n  for await (const chunk of process.stdin) {\n    chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk))\n  }\n  const text = Buffer.concat(chunks).toString(\"utf8\").trim()\n  return text.length > 0 ? text : null\n}\n","/**\n * `agentproto run <slug> [--cwd <dir>] [--prompt <text>] [--resume <id>]`\n *\n * Boots the named adapter, dispatches a single user turn, streams events\n * to stdout, then exits. Designed for two use-cases:\n *   - one-shot scripting (pipe a prompt in, get stream back)\n *   - quick smoke-test from a fresh checkout (\"does claude even spawn?\")\n *\n * Long-lived multiplexing belongs to `agentproto serve`, not here.\n */\n\nimport { resolve as resolvePath } from \"node:path\"\nimport { parseArgs } from \"node:util\"\nimport {\n  createAgentCliRuntime,\n  type AgentCliRuntimeSession,\n  type StreamEvent,\n} from \"@agentproto/driver-agent-cli\"\nimport { resolveAdapter } from \"../registry/resolve.js\"\nimport { readStdinIfPiped } from \"../util/stdin.js\"\n\nexport async function runRun(args: readonly string[]): Promise<number> {\n  const { values, positionals } = parseArgs({\n    args: [...args],\n    allowPositionals: true,\n    strict: true,\n    options: {\n      cwd: { type: \"string\" },\n      prompt: { type: \"string\", short: \"p\" },\n      resume: { type: \"string\" },\n      json: { type: \"boolean\" },\n    },\n  })\n\n  const slug = positionals[0]\n  if (!slug) {\n    process.stderr.write(\n      \"agentproto run: missing adapter slug. Try: agentproto run claude-code\\n\"\n    )\n    return 2\n  }\n\n  const cwd = values.cwd ? resolvePath(values.cwd) : process.cwd()\n  const promptArg = values.prompt ?? (await readStdinIfPiped())\n  if (!promptArg) {\n    process.stderr.write(\n      \"agentproto run: no prompt provided. Pass --prompt or pipe one over stdin.\\n\"\n    )\n    return 2\n  }\n\n  const adapter = await resolveAdapter(slug)\n  const runtime = createAgentCliRuntime(adapter.handle)\n\n  const controller = new AbortController()\n  const onSignal = (sig: NodeJS.Signals) => {\n    process.stderr.write(`\\nagentproto: received ${sig}, cancelling…\\n`)\n    controller.abort()\n  }\n  process.once(\"SIGINT\", onSignal)\n  process.once(\"SIGTERM\", onSignal)\n\n  let session: AgentCliRuntimeSession | null = null\n  try {\n    session = await runtime.start({\n      cwd,\n      signal: controller.signal,\n      resumeSessionId: values.resume,\n    })\n\n    const printer = values.json ? printJson : printPretty\n    let exit = 0\n    for await (const ev of session.send(promptArg)) {\n      printer(ev)\n      if (ev.kind === \"turn-end\" && ev.reason !== \"completed\") exit = 1\n      if (ev.kind === \"error\") exit = 1\n    }\n    return exit\n  } finally {\n    process.off(\"SIGINT\", onSignal)\n    process.off(\"SIGTERM\", onSignal)\n    if (session) await session.close().catch(() => {})\n  }\n}\n\nfunction printJson(ev: StreamEvent): void {\n  process.stdout.write(`${JSON.stringify(ev)}\\n`)\n}\n\nfunction printPretty(ev: StreamEvent): void {\n  switch (ev.kind) {\n    case \"text-delta\":\n      process.stdout.write(ev.text)\n      break\n    case \"thought\":\n      process.stderr.write(`\\x1b[2m[thought] ${ev.text}\\x1b[0m\\n`)\n      break\n    case \"tool-call\":\n      process.stderr.write(`\\x1b[36m[tool] ${ev.toolName}\\x1b[0m\\n`)\n      break\n    case \"tool-result\":\n      if (ev.isError)\n        process.stderr.write(`\\x1b[31m[tool-error]\\x1b[0m\\n`)\n      break\n    case \"agent-prompt\":\n      process.stderr.write(`\\x1b[33m[agent-prompt: needs input]\\x1b[0m\\n`)\n      break\n    case \"turn-end\":\n      process.stdout.write(`\\n\\x1b[2m[turn-end: ${ev.reason}]\\x1b[0m\\n`)\n      break\n    case \"error\":\n      process.stderr.write(`\\x1b[31m[error] ${ev.error.message}\\x1b[0m\\n`)\n      break\n  }\n}\n","/**\n * `agentproto serve --connect <url>`\n *\n * Long-running daemon. Opens a WebSocket to a host (Guilde-shaped API),\n * authenticates with a token, then accepts spawn / stdin / stdout /\n * stderr / kill / exit frames over that channel — multiplexing many\n * ACP sessions through one process. The daemon owns local resources\n * (PTYs, child processes, JSONL session stores) so a host running in\n * the cloud can drive a CLI living on the user's laptop.\n *\n * v0.1 stub: argument parsing + connection scaffolding only. The wire\n * protocol is still being designed (tunnel frames need to land in\n * @agentproto/acp first); shipping a half-baked daemon would lock us\n * into the wrong shape. For now this verb prints a clear \"not yet\"\n * and exits non-zero so CI pipelines don't accidentally rely on it.\n */\n\nimport { parseArgs } from \"node:util\"\n\nexport async function runServe(args: readonly string[]): Promise<number> {\n  const { values } = parseArgs({\n    args: [...args],\n    allowPositionals: false,\n    strict: true,\n    options: {\n      connect: { type: \"string\", short: \"c\" },\n      token: { type: \"string\", short: \"t\" },\n      label: { type: \"string\", short: \"l\" },\n    },\n  })\n\n  if (!values.connect) {\n    process.stderr.write(\n      \"agentproto serve: --connect <url> is required.\\n\" +\n        \"  example: agentproto serve --connect wss://guilde.work/api/v1/agentproto/tunnel --token $TOKEN\\n\"\n    )\n    return 2\n  }\n\n  process.stderr.write(\n    \"agentproto serve: tunnel daemon is not yet implemented in this release.\\n\" +\n      \"  Tracking: tunnel frame protocol is landing in @agentproto/acp next.\\n\" +\n      `  Wanted endpoint: ${values.connect}\\n` +\n      `  Label:           ${values.label ?? \"(none)\"}\\n`\n  )\n  return 64\n}\n","#!/usr/bin/env node\n/**\n * `agentproto` — the binary entry. Three verbs:\n *\n *   agentproto install <slug>            install an adapter's underlying CLI\n *   agentproto run <slug> [--cwd <dir>]  spawn the adapter and stream a turn\n *   agentproto serve --connect <url>     daemon — relay spawns over WS\n *\n * Adapter slugs resolve through the registry (see ./registry/resolve.ts).\n * Out of the box we ship `claude-code`, `hermes` etc. via npm-installed\n * `@agentproto/adapter-<slug>` packages.\n */\n\nimport { parseArgs } from \"node:util\"\nimport { runInstall } from \"./commands/install.js\"\nimport { runRun } from \"./commands/run.js\"\nimport { runServe } from \"./commands/serve.js\"\n\nconst USAGE = `agentproto — AIP-45 agent CLI host\n\nUsage:\n  agentproto install <slug> [--registry <path>]\n  agentproto run     <slug> [--cwd <dir>] [--prompt <text>] [--resume <session-id>]\n  agentproto serve   --connect <url> [--token <jwt>] [--label <name>]\n  agentproto --help\n  agentproto --version\n\nExamples:\n  agentproto install claude-code\n  agentproto run claude-code --cwd . --prompt \"summarise this repo\"\n  agentproto serve --connect wss://guilde.work/api/v1/agentproto/tunnel --token \\$AGENTPROTO_TOKEN\n`\n\nasync function main(argv: readonly string[]): Promise<number> {\n  const { values, positionals } = parseArgs({\n    args: [...argv],\n    allowPositionals: true,\n    strict: false,\n    options: {\n      help: { type: \"boolean\", short: \"h\" },\n      version: { type: \"boolean\", short: \"v\" },\n    },\n  })\n\n  if (values.help) {\n    process.stdout.write(USAGE)\n    return 0\n  }\n  if (values.version) {\n    process.stdout.write(\"agentproto 0.1.0-alpha\\n\")\n    return 0\n  }\n\n  const [verb, ...rest] = positionals\n  if (!verb) {\n    process.stdout.write(USAGE)\n    return 0\n  }\n\n  switch (verb) {\n    case \"install\":\n      return runInstall(rest)\n    case \"run\":\n      return runRun(rest)\n    case \"serve\":\n      return runServe(rest)\n    default:\n      process.stderr.write(`agentproto: unknown verb '${verb}'\\n\\n${USAGE}`)\n      return 2\n  }\n}\n\nmain(process.argv.slice(2)).then(\n  (code) => {\n    process.exitCode = code\n  },\n  (err: unknown) => {\n    const msg = err instanceof Error ? err.stack ?? err.message : String(err)\n    process.stderr.write(`agentproto: ${msg}\\n`)\n    process.exitCode = 1\n  }\n)\n"]}

package/dist/index.d.ts

@@ -0,0 +1,73 @@
+import { AgentCliHandle } from '@agentproto/driver-agent-cli';
+
+/**
+ * `agentproto install <slug>`
+ *
+ * Reads the adapter manifest's `install` block and shells out to the
+ * declared package manager. Idempotent: if `version_check` passes, we
+ * skip and report "already installed" (override with --force).
+ *
+ * The adapter package itself must already be in node_modules (we resolve
+ * it before reading its manifest). Bootstrapping the adapter package is
+ * a separate concern — `npm i -g @agentproto/adapter-<slug>` first.
+ *
+ * v0 implements `npm` only. Other methods (brew/pip/cargo/go/curl/
+ * download) report a clear "not yet implemented" message — they're a
+ * shellout exercise but each needs its own checksum / chmod handling.
+ */
+declare function runInstall(args: readonly string[]): Promise<number>;
+
+/**
+ * `agentproto run <slug> [--cwd <dir>] [--prompt <text>] [--resume <id>]`
+ *
+ * Boots the named adapter, dispatches a single user turn, streams events
+ * to stdout, then exits. Designed for two use-cases:
+ *   - one-shot scripting (pipe a prompt in, get stream back)
+ *   - quick smoke-test from a fresh checkout ("does claude even spawn?")
+ *
+ * Long-lived multiplexing belongs to `agentproto serve`, not here.
+ */
+declare function runRun(args: readonly string[]): Promise<number>;
+
+/**
+ * `agentproto serve --connect <url>`
+ *
+ * Long-running daemon. Opens a WebSocket to a host (Guilde-shaped API),
+ * authenticates with a token, then accepts spawn / stdin / stdout /
+ * stderr / kill / exit frames over that channel — multiplexing many
+ * ACP sessions through one process. The daemon owns local resources
+ * (PTYs, child processes, JSONL session stores) so a host running in
+ * the cloud can drive a CLI living on the user's laptop.
+ *
+ * v0.1 stub: argument parsing + connection scaffolding only. The wire
+ * protocol is still being designed (tunnel frames need to land in
+ * @agentproto/acp first); shipping a half-baked daemon would lock us
+ * into the wrong shape. For now this verb prints a clear "not yet"
+ * and exits non-zero so CI pipelines don't accidentally rely on it.
+ */
+declare function runServe(args: readonly string[]): Promise<number>;
+
+/**
+ * Resolve a slug like "claude-code" to a runnable `AgentCliHandle`.
+ *
+ * Resolution order:
+ *   1. `@agentproto/adapter-<slug>` from npm (must default-export or
+ *      named-export an `AgentCliHandle` — convention is the camelCased
+ *      slug, e.g. `claudeCode`).
+ *   2. (TODO) `~/.agentproto/adapters/<slug>/AGENT-CLI.md` on disk.
+ *   3. (TODO) bundled fallbacks for the canonical adapters.
+ *
+ * Step 1 covers 100% of v0 usage. The on-disk path is only there for
+ * users authoring their own adapters; we'll add it once `defineAgentCli`
+ * supports MD-source authoring end to end.
+ */
+
+interface ResolvedAdapter {
+    readonly slug: string;
+    readonly handle: AgentCliHandle;
+    readonly source: "npm" | "file" | "bundled";
+    readonly packageName?: string;
+}
+declare function resolveAdapter(slug: string): Promise<ResolvedAdapter>;
+
+export { type ResolvedAdapter, resolveAdapter, runInstall, runRun, runServe };

package/dist/index.mjs

@@ -0,0 +1,308 @@
+import { spawn } from 'child_process';
+import { parseArgs } from 'util';
+import { resolve } from 'path';
+import { createAgentCliRuntime } from '@agentproto/driver-agent-cli';
+
+/**
+ * @agentproto/cli v0.1.0-alpha
+ * The `agentproto` binary — install / run / serve AIP-45 agent CLIs.
+ */
+
+
+// src/registry/resolve.ts
+var slugToCamel = (slug) => slug.replace(/-([a-z0-9])/g, (_, c) => c.toUpperCase());
+async function resolveAdapter(slug) {
+  if (!/^[a-z][a-z0-9-]*$/.test(slug)) {
+    throw new Error(
+      `agentproto: invalid adapter slug '${slug}'. Slugs are lower-kebab.`
+    );
+  }
+  const packageName = `@agentproto/adapter-${slug}`;
+  let mod;
+  try {
+    mod = await import(packageName);
+  } catch (err) {
+    const cause = err instanceof Error ? err.message : String(err);
+    throw new Error(
+      `agentproto: could not load adapter '${slug}'. Tried '${packageName}'. Install it with: npm i -g ${packageName}
+  cause: ${cause}`
+    );
+  }
+  const camel = slugToCamel(slug);
+  const candidate = mod[camel] ?? mod.default ?? mod.handle;
+  if (!candidate || typeof candidate !== "object" || !("name" in candidate)) {
+    throw new Error(
+      `agentproto: adapter '${packageName}' does not export an AgentCliHandle (looked for export '${camel}', 'default', or 'handle').`
+    );
+  }
+  return { slug, handle: candidate, source: "npm", packageName };
+}
+
+// src/commands/install.ts
+async function runInstall(args) {
+  const { values, positionals } = parseArgs({
+    args: [...args],
+    allowPositionals: true,
+    strict: true,
+    options: {
+      force: { type: "boolean", short: "f" },
+      "dry-run": { type: "boolean" }
+    }
+  });
+  const slug = positionals[0];
+  if (!slug) {
+    process.stderr.write(
+      "agentproto install: missing adapter slug. Try: agentproto install claude-code\n"
+    );
+    return 2;
+  }
+  const adapter = await resolveAdapter(slug);
+  const installSteps = adapter.handle.install ?? [];
+  if (installSteps.length === 0) {
+    process.stderr.write(
+      `agentproto install: adapter '${slug}' declares no install steps.
+`
+    );
+    return 0;
+  }
+  if (!values.force) {
+    const checked = await runVersionCheck(adapter.handle.version_check);
+    if (checked.ok) {
+      process.stdout.write(
+        `agentproto: '${slug}' already installed (${checked.message}). Pass --force to reinstall.
+`
+      );
+      return 0;
+    }
+  }
+  for (const [i, step] of installSteps.entries()) {
+    process.stdout.write(
+      `agentproto install [${i + 1}/${installSteps.length}] ${describeStep(step)}
+`
+    );
+    if (values["dry-run"]) continue;
+    const code = await runStep(step);
+    if (code !== 0) {
+      process.stderr.write(
+        `agentproto install: step ${i + 1} failed with exit ${code}.
+`
+      );
+      return code;
+    }
+  }
+  process.stdout.write(`agentproto: '${slug}' installed.
+`);
+  return 0;
+}
+function describeStep(step) {
+  switch (step.method) {
+    case "npm":
+      return `npm install ${step.global ? "-g " : ""}${step.package ?? "(?)"}`;
+    case "brew":
+      return `brew install ${step.package ?? "(?)"}`;
+    case "pip":
+      return `pip install ${step.package ?? "(?)"}`;
+    case "cargo":
+      return `cargo install ${step.package ?? "(?)"}`;
+    case "go":
+      return `go install ${step.package ?? "(?)"}`;
+    case "curl":
+    case "download":
+      return `${step.method} ${step.url ?? "(?)"} \u2192 ${step.path ?? "(default)"}`;
+    default:
+      return `${step.method} ${step.package ?? step.url ?? "(?)"}`;
+  }
+}
+async function runStep(step) {
+  switch (step.method) {
+    case "npm": {
+      if (!step.package) {
+        process.stderr.write("agentproto install: npm step missing package.\n");
+        return 2;
+      }
+      const argv = ["install"];
+      if (step.global) argv.push("-g");
+      argv.push(step.package);
+      return spawnInherit("npm", argv);
+    }
+    default:
+      process.stderr.write(
+        `agentproto install: method '${step.method}' not yet implemented in this CLI version. Run it manually for now (see the adapter's INSTALL.md).
+`
+      );
+      return 1;
+  }
+}
+function spawnInherit(cmd, argv) {
+  return new Promise((resolve, reject) => {
+    const child = spawn(cmd, argv, { stdio: "inherit" });
+    child.once("error", reject);
+    child.once("exit", (code) => resolve(code ?? 0));
+  });
+}
+async function runVersionCheck(check) {
+  if (!check) return { ok: false, message: "no version_check declared" };
+  return new Promise((resolve) => {
+    const child = spawn("bash", ["-lc", check.cmd], {
+      stdio: ["ignore", "pipe", "ignore"]
+    });
+    let buf = "";
+    child.stdout.on("data", (c) => {
+      buf += c.toString("utf8");
+    });
+    child.once("error", () => resolve({ ok: false, message: "check failed" }));
+    child.once("exit", (code) => {
+      if (code !== 0) {
+        resolve({ ok: false, message: `check exited ${code}` });
+        return;
+      }
+      const re = new RegExp(check.parse);
+      const m = buf.match(re);
+      if (!m || !m[1]) {
+        resolve({ ok: false, message: "could not parse version" });
+        return;
+      }
+      resolve({ ok: true, message: `version ${m[1]}` });
+    });
+  });
+}
+
+// src/util/stdin.ts
+async function readStdinIfPiped() {
+  if (process.stdin.isTTY) return null;
+  const chunks = [];
+  for await (const chunk of process.stdin) {
+    chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+  }
+  const text = Buffer.concat(chunks).toString("utf8").trim();
+  return text.length > 0 ? text : null;
+}
+
+// src/commands/run.ts
+async function runRun(args) {
+  const { values, positionals } = parseArgs({
+    args: [...args],
+    allowPositionals: true,
+    strict: true,
+    options: {
+      cwd: { type: "string" },
+      prompt: { type: "string", short: "p" },
+      resume: { type: "string" },
+      json: { type: "boolean" }
+    }
+  });
+  const slug = positionals[0];
+  if (!slug) {
+    process.stderr.write(
+      "agentproto run: missing adapter slug. Try: agentproto run claude-code\n"
+    );
+    return 2;
+  }
+  const cwd = values.cwd ? resolve(values.cwd) : process.cwd();
+  const promptArg = values.prompt ?? await readStdinIfPiped();
+  if (!promptArg) {
+    process.stderr.write(
+      "agentproto run: no prompt provided. Pass --prompt or pipe one over stdin.\n"
+    );
+    return 2;
+  }
+  const adapter = await resolveAdapter(slug);
+  const runtime = createAgentCliRuntime(adapter.handle);
+  const controller = new AbortController();
+  const onSignal = (sig) => {
+    process.stderr.write(`
+agentproto: received ${sig}, cancelling\u2026
+`);
+    controller.abort();
+  };
+  process.once("SIGINT", onSignal);
+  process.once("SIGTERM", onSignal);
+  let session = null;
+  try {
+    session = await runtime.start({
+      cwd,
+      signal: controller.signal,
+      resumeSessionId: values.resume
+    });
+    const printer = values.json ? printJson : printPretty;
+    let exit = 0;
+    for await (const ev of session.send(promptArg)) {
+      printer(ev);
+      if (ev.kind === "turn-end" && ev.reason !== "completed") exit = 1;
+      if (ev.kind === "error") exit = 1;
+    }
+    return exit;
+  } finally {
+    process.off("SIGINT", onSignal);
+    process.off("SIGTERM", onSignal);
+    if (session) await session.close().catch(() => {
+    });
+  }
+}
+function printJson(ev) {
+  process.stdout.write(`${JSON.stringify(ev)}
+`);
+}
+function printPretty(ev) {
+  switch (ev.kind) {
+    case "text-delta":
+      process.stdout.write(ev.text);
+      break;
+    case "thought":
+      process.stderr.write(`\x1B[2m[thought] ${ev.text}\x1B[0m
+`);
+      break;
+    case "tool-call":
+      process.stderr.write(`\x1B[36m[tool] ${ev.toolName}\x1B[0m
+`);
+      break;
+    case "tool-result":
+      if (ev.isError)
+        process.stderr.write(`\x1B[31m[tool-error]\x1B[0m
+`);
+      break;
+    case "agent-prompt":
+      process.stderr.write(`\x1B[33m[agent-prompt: needs input]\x1B[0m
+`);
+      break;
+    case "turn-end":
+      process.stdout.write(`
+\x1B[2m[turn-end: ${ev.reason}]\x1B[0m
+`);
+      break;
+    case "error":
+      process.stderr.write(`\x1B[31m[error] ${ev.error.message}\x1B[0m
+`);
+      break;
+  }
+}
+async function runServe(args) {
+  const { values } = parseArgs({
+    args: [...args],
+    allowPositionals: false,
+    strict: true,
+    options: {
+      connect: { type: "string", short: "c" },
+      token: { type: "string", short: "t" },
+      label: { type: "string", short: "l" }
+    }
+  });
+  if (!values.connect) {
+    process.stderr.write(
+      "agentproto serve: --connect <url> is required.\n  example: agentproto serve --connect wss://guilde.work/api/v1/agentproto/tunnel --token $TOKEN\n"
+    );
+    return 2;
+  }
+  process.stderr.write(
+    `agentproto serve: tunnel daemon is not yet implemented in this release.
+  Tracking: tunnel frame protocol is landing in @agentproto/acp next.
+  Wanted endpoint: ${values.connect}
+  Label:           ${values.label ?? "(none)"}
+`
+  );
+  return 64;
+}
+
+export { resolveAdapter, runInstall, runRun, runServe };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/registry/resolve.ts","../src/commands/install.ts","../src/util/stdin.ts","../src/commands/run.ts","../src/commands/serve.ts"],"names":["parseArgs","resolvePath"],"mappings":";;;;;;;;;;;;AAwBA,IAAM,WAAA,GAAc,CAAC,IAAA,KACnB,IAAA,CAAK,OAAA,CAAQ,cAAA,EAAgB,CAAC,CAAA,EAAG,CAAA,KAAc,CAAA,CAAE,WAAA,EAAa,CAAA;AAEhE,eAAsB,eAAe,IAAA,EAAwC;AAC3E,EAAA,IAAI,CAAC,mBAAA,CAAoB,IAAA,CAAK,IAAI,CAAA,EAAG;AACnC,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,qCAAqC,IAAI,CAAA,yBAAA;AAAA,KAC3C;AAAA,EACF;AAEA,EAAA,MAAM,WAAA,GAAc,uBAAuB,IAAI,CAAA,CAAA;AAC/C,EAAA,IAAI,GAAA;AACJ,EAAA,IAAI;AACF,IAAA,GAAA,GAAO,MAAM,OAAO,WAAA,CAAA;AAAA,EACtB,SAAS,GAAA,EAAK;AACZ,IAAA,MAAM,QAAQ,GAAA,YAAe,KAAA,GAAQ,GAAA,CAAI,OAAA,GAAU,OAAO,GAAG,CAAA;AAC7D,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,CAAA,oCAAA,EAAuC,IAAI,CAAA,UAAA,EAC/B,WAAW,gCAAgC,WAAW;AAAA,SAAA,EAAc,KAAK,CAAA;AAAA,KACvF;AAAA,EACF;AAEA,EAAA,MAAM,KAAA,GAAQ,YAAY,IAAI,CAAA;AAC9B,EAAA,MAAM,YACH,GAAA,CAAI,KAAK,CAAA,IACT,GAAA,CAAI,WACJ,GAAA,CAAI,MAAA;AAEP,EAAA,IAAI,CAAC,SAAA,IAAa,OAAO,cAAc,QAAA,IAAY,EAAE,UAAU,SAAA,CAAA,EAAY;AACzE,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,CAAA,qBAAA,EAAwB,WAAW,CAAA,wDAAA,EACV,KAAK,CAAA,2BAAA;AAAA,KAChC;AAAA,EACF;AAEA,EAAA,OAAO,EAAE,IAAA,EAAM,MAAA,EAAQ,SAAA,EAAW,MAAA,EAAQ,OAAO,WAAA,EAAY;AAC/D;;;ACvCA,eAAsB,WAAW,IAAA,EAA0C;AACzE,EAAA,MAAM,EAAE,MAAA,EAAQ,WAAA,EAAY,GAAI,SAAA,CAAU;AAAA,IACxC,IAAA,EAAM,CAAC,GAAG,IAAI,CAAA;AAAA,IACd,gBAAA,EAAkB,IAAA;AAAA,IAClB,MAAA,EAAQ,IAAA;AAAA,IACR,OAAA,EAAS;AAAA,MACP,KAAA,EAAO,EAAE,IAAA,EAAM,SAAA,EAAW,OAAO,GAAA,EAAI;AAAA,MACrC,SAAA,EAAW,EAAE,IAAA,EAAM,SAAA;AAAU;AAC/B,GACD,CAAA;AAED,EAAA,MAAM,IAAA,GAAO,YAAY,CAAC,CAAA;AAC1B,EAAA,IAAI,CAAC,IAAA,EAAM;AACT,IAAA,OAAA,CAAQ,MAAA,CAAO,KAAA;AAAA,MACb;AAAA,KACF;AACA,IAAA,OAAO,CAAA;AAAA,EACT;AAEA,EAAA,MAAM,OAAA,GAAU,MAAM,cAAA,CAAe,IAAI,CAAA;AACzC,EAAA,MAAM,YAAA,GAAwC,OAAA,CAAQ,MAAA,CAAO,OAAA,IAAW,EAAC;AACzE,EAAA,IAAI,YAAA,CAAa,WAAW,CAAA,EAAG;AAC7B,IAAA,OAAA,CAAQ,MAAA,CAAO,KAAA;AAAA,MACb,gCAAgC,IAAI,CAAA;AAAA;AAAA,KACtC;AACA,IAAA,OAAO,CAAA;AAAA,EACT;AAEA,EAAA,IAAI,CAAC,OAAO,KAAA,EAAO;AACjB,IAAA,MAAM,OAAA,GAAU,MAAM,eAAA,CAAgB,OAAA,CAAQ,OAAO,aAAa,CAAA;AAClE,IAAA,IAAI,QAAQ,EAAA,EAAI;AACd,MAAA,OAAA,CAAQ,MAAA,CAAO,KAAA;AAAA,QACb,CAAA,aAAA,EAAgB,IAAI,CAAA,qBAAA,EAAwB,OAAA,CAAQ,OAAO,CAAA;AAAA;AAAA,OAC7D;AACA,MAAA,OAAO,CAAA;AAAA,IACT;AAAA,EACF;AAEA,EAAA,KAAA,MAAW,CAAC,CAAA,EAAG,IAAI,CAAA,IAAK,YAAA,CAAa,SAAQ,EAAG;AAC9C,IAAA,OAAA,CAAQ,MAAA,CAAO,KAAA;AAAA,MACb,CAAA,oBAAA,EAAuB,IAAI,CAAC,CAAA,CAAA,EAAI,aAAa,MAAM,CAAA,EAAA,EAAK,YAAA,CAAa,IAAI,CAAC;AAAA;AAAA,KAC5E;AACA,IAAA,IAAI,MAAA,CAAO,SAAS,CAAA,EAAG;AACvB,IAAA,MAAM,IAAA,GAAO,MAAM,OAAA,CAAQ,IAAI,CAAA;AAC/B,IAAA,IAAI,SAAS,CAAA,EAAG;AACd,MAAA,OAAA,CAAQ,MAAA,CAAO,KAAA;AAAA,QACb,CAAA,yBAAA,EAA4B,CAAA,GAAI,CAAC,CAAA,kBAAA,EAAqB,IAAI,CAAA;AAAA;AAAA,OAC5D;AACA,MAAA,OAAO,IAAA;AAAA,IACT;AAAA,EACF;AAEA,EAAA,OAAA,CAAQ,MAAA,CAAO,KAAA,CAAM,CAAA,aAAA,EAAgB,IAAI,CAAA;AAAA,CAAgB,CAAA;AACzD,EAAA,OAAO,CAAA;AACT;AAEA,SAAS,aAAa,IAAA,EAAqC;AACzD,EAAA,QAAQ,KAAK,MAAA;AAAQ,IACnB,KAAK,KAAA;AACH,MAAA,OAAO,CAAA,YAAA,EAAe,KAAK,MAAA,GAAS,KAAA,GAAQ,EAAE,CAAA,EAAG,IAAA,CAAK,WAAW,KAAK,CAAA,CAAA;AAAA,IACxE,KAAK,MAAA;AACH,MAAA,OAAO,CAAA,aAAA,EAAgB,IAAA,CAAK,OAAA,IAAW,KAAK,CAAA,CAAA;AAAA,IAC9C,KAAK,KAAA;AACH,MAAA,OAAO,CAAA,YAAA,EAAe,IAAA,CAAK,OAAA,IAAW,KAAK,CAAA,CAAA;AAAA,IAC7C,KAAK,OAAA;AACH,MAAA,OAAO,CAAA,cAAA,EAAiB,IAAA,CAAK,OAAA,IAAW,KAAK,CAAA,CAAA;AAAA,IAC/C,KAAK,IAAA;AACH,MAAA,OAAO,CAAA,WAAA,EAAc,IAAA,CAAK,OAAA,IAAW,KAAK,CAAA,CAAA;AAAA,IAC5C,KAAK,MAAA;AAAA,IACL,KAAK,UAAA;AACH,MAAA,OAAO,CAAA,EAAG,IAAA,CAAK,MAAM,CAAA,CAAA,EAAI,IAAA,CAAK,OAAO,KAAK,CAAA,QAAA,EAAM,IAAA,CAAK,IAAA,IAAQ,WAAW,CAAA,CAAA;AAAA,IAC1E;AACE,MAAA,OAAO,CAAA,EAAG,KAAK,MAAM,CAAA,CAAA,EAAI,KAAK,OAAA,IAAW,IAAA,CAAK,OAAO,KAAK,CAAA,CAAA;AAAA;AAEhE;AAEA,eAAe,QAAQ,IAAA,EAA8C;AACnE,EAAA,QAAQ,KAAK,MAAA;AAAQ,IACnB,KAAK,KAAA,EAAO;AACV,MAAA,IAAI,CAAC,KAAK,OAAA,EAAS;AACjB,QAAA,OAAA,CAAQ,MAAA,CAAO,MAAM,iDAAiD,CAAA;AACtE,QAAA,OAAO,CAAA;AAAA,MACT;AACA,MAAA,MAAM,IAAA,GAAO,CAAC,SAAS,CAAA;AACvB,MAAA,IAAI,IAAA,CAAK,MAAA,EAAQ,IAAA,CAAK,IAAA,CAAK,IAAI,CAAA;AAC/B,MAAA,IAAA,CAAK,IAAA,CAAK,KAAK,OAAO,CAAA;AACtB,MAAA,OAAO,YAAA,CAAa,OAAO,IAAI,CAAA;AAAA,IACjC;AAAA,IACA;AACE,MAAA,OAAA,CAAQ,MAAA,CAAO,KAAA;AAAA,QACb,CAAA,4BAAA,EAA+B,KAAK,MAAM,CAAA;AAAA;AAAA,OAE5C;AACA,MAAA,OAAO,CAAA;AAAA;AAEb;AAEA,SAAS,YAAA,CAAa,KAAa,IAAA,EAAiC;AAClE,EAAA,OAAO,IAAI,OAAA,CAAQ,CAAC,OAAA,EAAS,MAAA,KAAW;AACtC,IAAA,MAAM,QAAQ,KAAA,CAAM,GAAA,EAAK,MAAM,EAAE,KAAA,EAAO,WAAW,CAAA;AACnD,IAAA,KAAA,CAAM,IAAA,CAAK,SAAS,MAAM,CAAA;AAC1B,IAAA,KAAA,CAAM,KAAK,MAAA,EAAQ,CAAC,SAAS,OAAA,CAAQ,IAAA,IAAQ,CAAC,CAAC,CAAA;AAAA,EACjD,CAAC,CAAA;AACH;AAEA,eAAe,gBACb,KAAA,EAG2C;AAC3C,EAAA,IAAI,CAAC,KAAA,EAAO,OAAO,EAAE,EAAA,EAAI,KAAA,EAAO,SAAS,2BAAA,EAA4B;AACrE,EAAA,OAAO,IAAI,OAAA,CAAQ,CAAC,OAAA,KAAY;AAC9B,IAAA,MAAM,QAAQ,KAAA,CAAM,MAAA,EAAQ,CAAC,KAAA,EAAO,KAAA,CAAM,GAAG,CAAA,EAAG;AAAA,MAC9C,KAAA,EAAO,CAAC,QAAA,EAAU,MAAA,EAAQ,QAAQ;AAAA,KACnC,CAAA;AACD,IAAA,IAAI,GAAA,GAAM,EAAA;AACV,IAAA,KAAA,CAAM,MAAA,CAAO,EAAA,CAAG,MAAA,EAAQ,CAAC,CAAA,KAAc;AACrC,MAAA,GAAA,IAAO,CAAA,CAAE,SAAS,MAAM,CAAA;AAAA,IAC1B,CAAC,CAAA;AACD,IAAA,KAAA,CAAM,IAAA,CAAK,OAAA,EAAS,MAAM,OAAA,CAAQ,EAAE,IAAI,KAAA,EAAO,OAAA,EAAS,cAAA,EAAgB,CAAC,CAAA;AACzE,IAAA,KAAA,CAAM,IAAA,CAAK,MAAA,EAAQ,CAAC,IAAA,KAAS;AAC3B,MAAA,IAAI,SAAS,CAAA,EAAG;AACd,QAAA,OAAA,CAAQ,EAAE,EAAA,EAAI,KAAA,EAAO,SAAS,CAAA,aAAA,EAAgB,IAAI,IAAI,CAAA;AACtD,QAAA;AAAA,MACF;AACA,MAAA,MAAM,EAAA,GAAK,IAAI,MAAA,CAAO,KAAA,CAAM,KAAK,CAAA;AACjC,MAAA,MAAM,CAAA,GAAI,GAAA,CAAI,KAAA,CAAM,EAAE,CAAA;AACtB,MAAA,IAAI,CAAC,CAAA,IAAK,CAAC,CAAA,CAAE,CAAC,CAAA,EAAG;AACf,QAAA,OAAA,CAAQ,EAAE,EAAA,EAAI,KAAA,EAAO,OAAA,EAAS,2BAA2B,CAAA;AACzD,QAAA;AAAA,MACF;AAIA,MAAA,OAAA,CAAQ,EAAE,IAAI,IAAA,EAAM,OAAA,EAAS,WAAW,CAAA,CAAE,CAAC,CAAC,CAAA,CAAA,EAAI,CAAA;AAAA,IAClD,CAAC,CAAA;AAAA,EACH,CAAC,CAAA;AACH;;;ACxJA,eAAsB,gBAAA,GAA2C;AAC/D,EAAA,IAAI,OAAA,CAAQ,KAAA,CAAM,KAAA,EAAO,OAAO,IAAA;AAChC,EAAA,MAAM,SAAmB,EAAC;AAC1B,EAAA,WAAA,MAAiB,KAAA,IAAS,QAAQ,KAAA,EAAO;AACvC,IAAA,MAAA,CAAO,IAAA,CAAK,OAAO,QAAA,CAAS,KAAK,IAAI,KAAA,GAAQ,MAAA,CAAO,IAAA,CAAK,KAAK,CAAC,CAAA;AAAA,EACjE;AACA,EAAA,MAAM,IAAA,GAAO,OAAO,MAAA,CAAO,MAAM,EAAE,QAAA,CAAS,MAAM,EAAE,IAAA,EAAK;AACzD,EAAA,OAAO,IAAA,CAAK,MAAA,GAAS,CAAA,GAAI,IAAA,GAAO,IAAA;AAClC;;;ACOA,eAAsB,OAAO,IAAA,EAA0C;AACrE,EAAA,MAAM,EAAE,MAAA,EAAQ,WAAA,EAAY,GAAIA,SAAAA,CAAU;AAAA,IACxC,IAAA,EAAM,CAAC,GAAG,IAAI,CAAA;AAAA,IACd,gBAAA,EAAkB,IAAA;AAAA,IAClB,MAAA,EAAQ,IAAA;AAAA,IACR,OAAA,EAAS;AAAA,MACP,GAAA,EAAK,EAAE,IAAA,EAAM,QAAA,EAAS;AAAA,MACtB,MAAA,EAAQ,EAAE,IAAA,EAAM,QAAA,EAAU,OAAO,GAAA,EAAI;AAAA,MACrC,MAAA,EAAQ,EAAE,IAAA,EAAM,QAAA,EAAS;AAAA,MACzB,IAAA,EAAM,EAAE,IAAA,EAAM,SAAA;AAAU;AAC1B,GACD,CAAA;AAED,EAAA,MAAM,IAAA,GAAO,YAAY,CAAC,CAAA;AAC1B,EAAA,IAAI,CAAC,IAAA,EAAM;AACT,IAAA,OAAA,CAAQ,MAAA,CAAO,KAAA;AAAA,MACb;AAAA,KACF;AACA,IAAA,OAAO,CAAA;AAAA,EACT;AAEA,EAAA,MAAM,GAAA,GAAM,OAAO,GAAA,GAAMC,OAAA,CAAY,OAAO,GAAG,CAAA,GAAI,QAAQ,GAAA,EAAI;AAC/D,EAAA,MAAM,SAAA,GAAY,MAAA,CAAO,MAAA,IAAW,MAAM,gBAAA,EAAiB;AAC3D,EAAA,IAAI,CAAC,SAAA,EAAW;AACd,IAAA,OAAA,CAAQ,MAAA,CAAO,KAAA;AAAA,MACb;AAAA,KACF;AACA,IAAA,OAAO,CAAA;AAAA,EACT;AAEA,EAAA,MAAM,OAAA,GAAU,MAAM,cAAA,CAAe,IAAI,CAAA;AACzC,EAAA,MAAM,OAAA,GAAU,qBAAA,CAAsB,OAAA,CAAQ,MAAM,CAAA;AAEpD,EAAA,MAAM,UAAA,GAAa,IAAI,eAAA,EAAgB;AACvC,EAAA,MAAM,QAAA,GAAW,CAAC,GAAA,KAAwB;AACxC,IAAA,OAAA,CAAQ,OAAO,KAAA,CAAM;AAAA,qBAAA,EAA0B,GAAG,CAAA;AAAA,CAAiB,CAAA;AACnE,IAAA,UAAA,CAAW,KAAA,EAAM;AAAA,EACnB,CAAA;AACA,EAAA,OAAA,CAAQ,IAAA,CAAK,UAAU,QAAQ,CAAA;AAC/B,EAAA,OAAA,CAAQ,IAAA,CAAK,WAAW,QAAQ,CAAA;AAEhC,EAAA,IAAI,OAAA,GAAyC,IAAA;AAC7C,EAAA,IAAI;AACF,IAAA,OAAA,GAAU,MAAM,QAAQ,KAAA,CAAM;AAAA,MAC5B,GAAA;AAAA,MACA,QAAQ,UAAA,CAAW,MAAA;AAAA,MACnB,iBAAiB,MAAA,CAAO;AAAA,KACzB,CAAA;AAED,IAAA,MAAM,OAAA,GAAU,MAAA,CAAO,IAAA,GAAO,SAAA,GAAY,WAAA;AAC1C,IAAA,IAAI,IAAA,GAAO,CAAA;AACX,IAAA,WAAA,MAAiB,EAAA,IAAM,OAAA,CAAQ,IAAA,CAAK,SAAS,CAAA,EAAG;AAC9C,MAAA,OAAA,CAAQ,EAAE,CAAA;AACV,MAAA,IAAI,GAAG,IAAA,KAAS,UAAA,IAAc,EAAA,CAAG,MAAA,KAAW,aAAa,IAAA,GAAO,CAAA;AAChE,MAAA,IAAI,EAAA,CAAG,IAAA,KAAS,OAAA,EAAS,IAAA,GAAO,CAAA;AAAA,IAClC;AACA,IAAA,OAAO,IAAA;AAAA,EACT,CAAA,SAAE;AACA,IAAA,OAAA,CAAQ,GAAA,CAAI,UAAU,QAAQ,CAAA;AAC9B,IAAA,OAAA,CAAQ,GAAA,CAAI,WAAW,QAAQ,CAAA;AAC/B,IAAA,IAAI,SAAS,MAAM,OAAA,CAAQ,KAAA,EAAM,CAAE,MAAM,MAAM;AAAA,IAAC,CAAC,CAAA;AAAA,EACnD;AACF;AAEA,SAAS,UAAU,EAAA,EAAuB;AACxC,EAAA,OAAA,CAAQ,OAAO,KAAA,CAAM,CAAA,EAAG,IAAA,CAAK,SAAA,CAAU,EAAE,CAAC;AAAA,CAAI,CAAA;AAChD;AAEA,SAAS,YAAY,EAAA,EAAuB;AAC1C,EAAA,QAAQ,GAAG,IAAA;AAAM,IACf,KAAK,YAAA;AACH,MAAA,OAAA,CAAQ,MAAA,CAAO,KAAA,CAAM,EAAA,CAAG,IAAI,CAAA;AAC5B,MAAA;AAAA,IACF,KAAK,SAAA;AACH,MAAA,OAAA,CAAQ,MAAA,CAAO,KAAA,CAAM,CAAA,iBAAA,EAAoB,EAAA,CAAG,IAAI,CAAA;AAAA,CAAW,CAAA;AAC3D,MAAA;AAAA,IACF,KAAK,WAAA;AACH,MAAA,OAAA,CAAQ,MAAA,CAAO,KAAA,CAAM,CAAA,eAAA,EAAkB,EAAA,CAAG,QAAQ,CAAA;AAAA,CAAW,CAAA;AAC7D,MAAA;AAAA,IACF,KAAK,aAAA;AACH,MAAA,IAAI,EAAA,CAAG,OAAA;AACL,QAAA,OAAA,CAAQ,OAAO,KAAA,CAAM,CAAA;AAAA,CAA+B,CAAA;AACtD,MAAA;AAAA,IACF,KAAK,cAAA;AACH,MAAA,OAAA,CAAQ,OAAO,KAAA,CAAM,CAAA;AAAA,CAA8C,CAAA;AACnE,MAAA;AAAA,IACF,KAAK,UAAA;AACH,MAAA,OAAA,CAAQ,OAAO,KAAA,CAAM;AAAA,kBAAA,EAAuB,GAAG,MAAM,CAAA;AAAA,CAAY,CAAA;AACjE,MAAA;AAAA,IACF,KAAK,OAAA;AACH,MAAA,OAAA,CAAQ,MAAA,CAAO,KAAA,CAAM,CAAA,gBAAA,EAAmB,EAAA,CAAG,MAAM,OAAO,CAAA;AAAA,CAAW,CAAA;AACnE,MAAA;AAAA;AAEN;AC/FA,eAAsB,SAAS,IAAA,EAA0C;AACvE,EAAA,MAAM,EAAE,MAAA,EAAO,GAAID,SAAAA,CAAU;AAAA,IAC3B,IAAA,EAAM,CAAC,GAAG,IAAI,CAAA;AAAA,IACd,gBAAA,EAAkB,KAAA;AAAA,IAClB,MAAA,EAAQ,IAAA;AAAA,IACR,OAAA,EAAS;AAAA,MACP,OAAA,EAAS,EAAE,IAAA,EAAM,QAAA,EAAU,OAAO,GAAA,EAAI;AAAA,MACtC,KAAA,EAAO,EAAE,IAAA,EAAM,QAAA,EAAU,OAAO,GAAA,EAAI;AAAA,MACpC,KAAA,EAAO,EAAE,IAAA,EAAM,QAAA,EAAU,OAAO,GAAA;AAAI;AACtC,GACD,CAAA;AAED,EAAA,IAAI,CAAC,OAAO,OAAA,EAAS;AACnB,IAAA,OAAA,CAAQ,MAAA,CAAO,KAAA;AAAA,MACb;AAAA,KAEF;AACA,IAAA,OAAO,CAAA;AAAA,EACT;AAEA,EAAA,OAAA,CAAQ,MAAA,CAAO,KAAA;AAAA,IACb,CAAA;AAAA;AAAA,mBAAA,EAEwB,OAAO,OAAO;AAAA,mBAAA,EACd,MAAA,CAAO,SAAS,QAAQ;AAAA;AAAA,GAClD;AACA,EAAA,OAAO,EAAA;AACT","file":"index.mjs","sourcesContent":["/**\n * Resolve a slug like \"claude-code\" to a runnable `AgentCliHandle`.\n *\n * Resolution order:\n *   1. `@agentproto/adapter-<slug>` from npm (must default-export or\n *      named-export an `AgentCliHandle` — convention is the camelCased\n *      slug, e.g. `claudeCode`).\n *   2. (TODO) `~/.agentproto/adapters/<slug>/AGENT-CLI.md` on disk.\n *   3. (TODO) bundled fallbacks for the canonical adapters.\n *\n * Step 1 covers 100% of v0 usage. The on-disk path is only there for\n * users authoring their own adapters; we'll add it once `defineAgentCli`\n * supports MD-source authoring end to end.\n */\n\nimport type { AgentCliHandle } from \"@agentproto/driver-agent-cli\"\n\nexport interface ResolvedAdapter {\n  readonly slug: string\n  readonly handle: AgentCliHandle\n  readonly source: \"npm\" | \"file\" | \"bundled\"\n  readonly packageName?: string\n}\n\nconst slugToCamel = (slug: string): string =>\n  slug.replace(/-([a-z0-9])/g, (_, c: string) => c.toUpperCase())\n\nexport async function resolveAdapter(slug: string): Promise<ResolvedAdapter> {\n  if (!/^[a-z][a-z0-9-]*$/.test(slug)) {\n    throw new Error(\n      `agentproto: invalid adapter slug '${slug}'. Slugs are lower-kebab.`\n    )\n  }\n\n  const packageName = `@agentproto/adapter-${slug}`\n  let mod: Record<string, unknown>\n  try {\n    mod = (await import(packageName)) as Record<string, unknown>\n  } catch (err) {\n    const cause = err instanceof Error ? err.message : String(err)\n    throw new Error(\n      `agentproto: could not load adapter '${slug}'. ` +\n        `Tried '${packageName}'. Install it with: npm i -g ${packageName}\\n  cause: ${cause}`\n    )\n  }\n\n  const camel = slugToCamel(slug)\n  const candidate =\n    (mod[camel] as AgentCliHandle | undefined) ??\n    (mod.default as AgentCliHandle | undefined) ??\n    (mod.handle as AgentCliHandle | undefined)\n\n  if (!candidate || typeof candidate !== \"object\" || !(\"name\" in candidate)) {\n    throw new Error(\n      `agentproto: adapter '${packageName}' does not export an AgentCliHandle ` +\n        `(looked for export '${camel}', 'default', or 'handle').`\n    )\n  }\n\n  return { slug, handle: candidate, source: \"npm\", packageName }\n}\n","/**\n * `agentproto install <slug>`\n *\n * Reads the adapter manifest's `install` block and shells out to the\n * declared package manager. Idempotent: if `version_check` passes, we\n * skip and report \"already installed\" (override with --force).\n *\n * The adapter package itself must already be in node_modules (we resolve\n * it before reading its manifest). Bootstrapping the adapter package is\n * a separate concern — `npm i -g @agentproto/adapter-<slug>` first.\n *\n * v0 implements `npm` only. Other methods (brew/pip/cargo/go/curl/\n * download) report a clear \"not yet implemented\" message — they're a\n * shellout exercise but each needs its own checksum / chmod handling.\n */\n\nimport { spawn } from \"node:child_process\"\nimport { parseArgs } from \"node:util\"\nimport type { AgentCliInstallMethod } from \"@agentproto/driver-agent-cli\"\nimport { resolveAdapter } from \"../registry/resolve.js\"\n\nexport async function runInstall(args: readonly string[]): Promise<number> {\n  const { values, positionals } = parseArgs({\n    args: [...args],\n    allowPositionals: true,\n    strict: true,\n    options: {\n      force: { type: \"boolean\", short: \"f\" },\n      \"dry-run\": { type: \"boolean\" },\n    },\n  })\n\n  const slug = positionals[0]\n  if (!slug) {\n    process.stderr.write(\n      \"agentproto install: missing adapter slug. Try: agentproto install claude-code\\n\"\n    )\n    return 2\n  }\n\n  const adapter = await resolveAdapter(slug)\n  const installSteps: AgentCliInstallMethod[] = adapter.handle.install ?? []\n  if (installSteps.length === 0) {\n    process.stderr.write(\n      `agentproto install: adapter '${slug}' declares no install steps.\\n`\n    )\n    return 0\n  }\n\n  if (!values.force) {\n    const checked = await runVersionCheck(adapter.handle.version_check)\n    if (checked.ok) {\n      process.stdout.write(\n        `agentproto: '${slug}' already installed (${checked.message}). Pass --force to reinstall.\\n`\n      )\n      return 0\n    }\n  }\n\n  for (const [i, step] of installSteps.entries()) {\n    process.stdout.write(\n      `agentproto install [${i + 1}/${installSteps.length}] ${describeStep(step)}\\n`\n    )\n    if (values[\"dry-run\"]) continue\n    const code = await runStep(step)\n    if (code !== 0) {\n      process.stderr.write(\n        `agentproto install: step ${i + 1} failed with exit ${code}.\\n`\n      )\n      return code\n    }\n  }\n\n  process.stdout.write(`agentproto: '${slug}' installed.\\n`)\n  return 0\n}\n\nfunction describeStep(step: AgentCliInstallMethod): string {\n  switch (step.method) {\n    case \"npm\":\n      return `npm install ${step.global ? \"-g \" : \"\"}${step.package ?? \"(?)\"}`\n    case \"brew\":\n      return `brew install ${step.package ?? \"(?)\"}`\n    case \"pip\":\n      return `pip install ${step.package ?? \"(?)\"}`\n    case \"cargo\":\n      return `cargo install ${step.package ?? \"(?)\"}`\n    case \"go\":\n      return `go install ${step.package ?? \"(?)\"}`\n    case \"curl\":\n    case \"download\":\n      return `${step.method} ${step.url ?? \"(?)\"} → ${step.path ?? \"(default)\"}`\n    default:\n      return `${step.method} ${step.package ?? step.url ?? \"(?)\"}`\n  }\n}\n\nasync function runStep(step: AgentCliInstallMethod): Promise<number> {\n  switch (step.method) {\n    case \"npm\": {\n      if (!step.package) {\n        process.stderr.write(\"agentproto install: npm step missing package.\\n\")\n        return 2\n      }\n      const argv = [\"install\"]\n      if (step.global) argv.push(\"-g\")\n      argv.push(step.package)\n      return spawnInherit(\"npm\", argv)\n    }\n    default:\n      process.stderr.write(\n        `agentproto install: method '${step.method}' not yet implemented in this CLI version. ` +\n          `Run it manually for now (see the adapter's INSTALL.md).\\n`\n      )\n      return 1\n  }\n}\n\nfunction spawnInherit(cmd: string, argv: string[]): Promise<number> {\n  return new Promise((resolve, reject) => {\n    const child = spawn(cmd, argv, { stdio: \"inherit\" })\n    child.once(\"error\", reject)\n    child.once(\"exit\", (code) => resolve(code ?? 0))\n  })\n}\n\nasync function runVersionCheck(\n  check: Awaited<\n    ReturnType<typeof resolveAdapter>\n  >[\"handle\"][\"version_check\"]\n): Promise<{ ok: boolean; message: string }> {\n  if (!check) return { ok: false, message: \"no version_check declared\" }\n  return new Promise((resolve) => {\n    const child = spawn(\"bash\", [\"-lc\", check.cmd], {\n      stdio: [\"ignore\", \"pipe\", \"ignore\"],\n    })\n    let buf = \"\"\n    child.stdout.on(\"data\", (c: Buffer) => {\n      buf += c.toString(\"utf8\")\n    })\n    child.once(\"error\", () => resolve({ ok: false, message: \"check failed\" }))\n    child.once(\"exit\", (code) => {\n      if (code !== 0) {\n        resolve({ ok: false, message: `check exited ${code}` })\n        return\n      }\n      const re = new RegExp(check.parse)\n      const m = buf.match(re)\n      if (!m || !m[1]) {\n        resolve({ ok: false, message: \"could not parse version\" })\n        return\n      }\n      // semver-range matching is left to a future helper; we report\n      // the captured version and trust it. --force remains the\n      // escape hatch when range gating actually matters.\n      resolve({ ok: true, message: `version ${m[1]}` })\n    })\n  })\n}\n","/**\n * Read piped stdin to a string. Returns null if stdin is a TTY (no pipe).\n * Used by `agentproto run` to accept prompts via:\n *   echo \"summarise this repo\" | agentproto run claude-code\n */\n\nexport async function readStdinIfPiped(): Promise<string | null> {\n  if (process.stdin.isTTY) return null\n  const chunks: Buffer[] = []\n  for await (const chunk of process.stdin) {\n    chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk))\n  }\n  const text = Buffer.concat(chunks).toString(\"utf8\").trim()\n  return text.length > 0 ? text : null\n}\n","/**\n * `agentproto run <slug> [--cwd <dir>] [--prompt <text>] [--resume <id>]`\n *\n * Boots the named adapter, dispatches a single user turn, streams events\n * to stdout, then exits. Designed for two use-cases:\n *   - one-shot scripting (pipe a prompt in, get stream back)\n *   - quick smoke-test from a fresh checkout (\"does claude even spawn?\")\n *\n * Long-lived multiplexing belongs to `agentproto serve`, not here.\n */\n\nimport { resolve as resolvePath } from \"node:path\"\nimport { parseArgs } from \"node:util\"\nimport {\n  createAgentCliRuntime,\n  type AgentCliRuntimeSession,\n  type StreamEvent,\n} from \"@agentproto/driver-agent-cli\"\nimport { resolveAdapter } from \"../registry/resolve.js\"\nimport { readStdinIfPiped } from \"../util/stdin.js\"\n\nexport async function runRun(args: readonly string[]): Promise<number> {\n  const { values, positionals } = parseArgs({\n    args: [...args],\n    allowPositionals: true,\n    strict: true,\n    options: {\n      cwd: { type: \"string\" },\n      prompt: { type: \"string\", short: \"p\" },\n      resume: { type: \"string\" },\n      json: { type: \"boolean\" },\n    },\n  })\n\n  const slug = positionals[0]\n  if (!slug) {\n    process.stderr.write(\n      \"agentproto run: missing adapter slug. Try: agentproto run claude-code\\n\"\n    )\n    return 2\n  }\n\n  const cwd = values.cwd ? resolvePath(values.cwd) : process.cwd()\n  const promptArg = values.prompt ?? (await readStdinIfPiped())\n  if (!promptArg) {\n    process.stderr.write(\n      \"agentproto run: no prompt provided. Pass --prompt or pipe one over stdin.\\n\"\n    )\n    return 2\n  }\n\n  const adapter = await resolveAdapter(slug)\n  const runtime = createAgentCliRuntime(adapter.handle)\n\n  const controller = new AbortController()\n  const onSignal = (sig: NodeJS.Signals) => {\n    process.stderr.write(`\\nagentproto: received ${sig}, cancelling…\\n`)\n    controller.abort()\n  }\n  process.once(\"SIGINT\", onSignal)\n  process.once(\"SIGTERM\", onSignal)\n\n  let session: AgentCliRuntimeSession | null = null\n  try {\n    session = await runtime.start({\n      cwd,\n      signal: controller.signal,\n      resumeSessionId: values.resume,\n    })\n\n    const printer = values.json ? printJson : printPretty\n    let exit = 0\n    for await (const ev of session.send(promptArg)) {\n      printer(ev)\n      if (ev.kind === \"turn-end\" && ev.reason !== \"completed\") exit = 1\n      if (ev.kind === \"error\") exit = 1\n    }\n    return exit\n  } finally {\n    process.off(\"SIGINT\", onSignal)\n    process.off(\"SIGTERM\", onSignal)\n    if (session) await session.close().catch(() => {})\n  }\n}\n\nfunction printJson(ev: StreamEvent): void {\n  process.stdout.write(`${JSON.stringify(ev)}\\n`)\n}\n\nfunction printPretty(ev: StreamEvent): void {\n  switch (ev.kind) {\n    case \"text-delta\":\n      process.stdout.write(ev.text)\n      break\n    case \"thought\":\n      process.stderr.write(`\\x1b[2m[thought] ${ev.text}\\x1b[0m\\n`)\n      break\n    case \"tool-call\":\n      process.stderr.write(`\\x1b[36m[tool] ${ev.toolName}\\x1b[0m\\n`)\n      break\n    case \"tool-result\":\n      if (ev.isError)\n        process.stderr.write(`\\x1b[31m[tool-error]\\x1b[0m\\n`)\n      break\n    case \"agent-prompt\":\n      process.stderr.write(`\\x1b[33m[agent-prompt: needs input]\\x1b[0m\\n`)\n      break\n    case \"turn-end\":\n      process.stdout.write(`\\n\\x1b[2m[turn-end: ${ev.reason}]\\x1b[0m\\n`)\n      break\n    case \"error\":\n      process.stderr.write(`\\x1b[31m[error] ${ev.error.message}\\x1b[0m\\n`)\n      break\n  }\n}\n","/**\n * `agentproto serve --connect <url>`\n *\n * Long-running daemon. Opens a WebSocket to a host (Guilde-shaped API),\n * authenticates with a token, then accepts spawn / stdin / stdout /\n * stderr / kill / exit frames over that channel — multiplexing many\n * ACP sessions through one process. The daemon owns local resources\n * (PTYs, child processes, JSONL session stores) so a host running in\n * the cloud can drive a CLI living on the user's laptop.\n *\n * v0.1 stub: argument parsing + connection scaffolding only. The wire\n * protocol is still being designed (tunnel frames need to land in\n * @agentproto/acp first); shipping a half-baked daemon would lock us\n * into the wrong shape. For now this verb prints a clear \"not yet\"\n * and exits non-zero so CI pipelines don't accidentally rely on it.\n */\n\nimport { parseArgs } from \"node:util\"\n\nexport async function runServe(args: readonly string[]): Promise<number> {\n  const { values } = parseArgs({\n    args: [...args],\n    allowPositionals: false,\n    strict: true,\n    options: {\n      connect: { type: \"string\", short: \"c\" },\n      token: { type: \"string\", short: \"t\" },\n      label: { type: \"string\", short: \"l\" },\n    },\n  })\n\n  if (!values.connect) {\n    process.stderr.write(\n      \"agentproto serve: --connect <url> is required.\\n\" +\n        \"  example: agentproto serve --connect wss://guilde.work/api/v1/agentproto/tunnel --token $TOKEN\\n\"\n    )\n    return 2\n  }\n\n  process.stderr.write(\n    \"agentproto serve: tunnel daemon is not yet implemented in this release.\\n\" +\n      \"  Tracking: tunnel frame protocol is landing in @agentproto/acp next.\\n\" +\n      `  Wanted endpoint: ${values.connect}\\n` +\n      `  Label:           ${values.label ?? \"(none)\"}\\n`\n  )\n  return 64\n}\n"]}

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@agentproto/cli",
+  "version": "0.1.0-alpha.0",
+  "description": "@agentproto/cli — the `agentproto` binary. Install AIP-45 agent CLI adapters, run them locally, or expose them over a tunnel as a long-running daemon. Reference host for hermes / claude-code / opencode / gemini-cli / goose, all driven through @agentproto/driver-agent-cli.",
+  "keywords": [
+    "agentproto",
+    "aip-45",
+    "agent-cli",
+    "cli",
+    "daemon",
+    "claude-code",
+    "hermes",
+    "opencode",
+    "goose",
+    "gemini-cli"
+  ],
+  "homepage": "https://agentproto.sh",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/agentproto/ts",
+    "directory": "packages/cli"
+  },
+  "bugs": {
+    "url": "https://github.com/agentproto/ts/issues"
+  },
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.mjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "agentproto": "./dist/cli.mjs"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "default": "./dist/index.mjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@agentproto/driver-agent-cli": "0.1.0-alpha.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.1.0",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4",
+    "@agentproto/adapter-hermes": "0.1.0-alpha.0",
+    "@agentproto/adapter-claude-code": "0.1.0-alpha.0",
+    "@agentproto/tooling": "0.1.0-alpha.0"
+  },
+  "engines": {
+    "node": ">=20.9.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "clean": "rm -rf dist",
+    "check-types": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest"
+  }
+}