codeam-cli 2.32.10 → 2.34.0

package/dist/index.js

@@ -498,7 +498,7 @@ var import_qrcode_terminal = __toESM(require("qrcode-terminal"));
 // package.json
 var package_default = {
   name: "codeam-cli",
-  version: "2.32.10",
+  version: "2.34.0",
   description: "Workflow-continuity bridge for AI coding agents. Wrap Claude Code or Codex in a PTY and supervise, approve, and redirect the session from any device \u2014 async. The terminal companion for CodeAgent Mobile.",
   type: "commonjs",
   main: "dist/index.js",
@@ -569,6 +569,7 @@ var package_default = {
   },
   dependencies: {
     "@agentclientprotocol/claude-agent-acp": "^0.42.0",
+    "@beads/bd": "1.0.5",
     "@agentclientprotocol/codex-acp": "^0.0.45",
     "@agentclientprotocol/sdk": "^0.25.0",
     "@clack/prompts": "^1.2.0",
@@ -707,8 +708,8 @@ async function requestCode(pluginId) {
     });
     let timer;
     const timeoutSentinel = /* @__PURE__ */ Symbol("request-code-timeout");
-    const timeoutPromise = new Promise((resolve6) => {
-      timer = setTimeout(() => resolve6(timeoutSentinel), REQUEST_CODE_TIMEOUT_MS);
+    const timeoutPromise = new Promise((resolve7) => {
+      timer = setTimeout(() => resolve7(timeoutSentinel), REQUEST_CODE_TIMEOUT_MS);
     });
     const result = await Promise.race([post2, timeoutPromise]);
     clearTimeout(timer);
@@ -851,8 +852,30 @@ async function postPreviewEvent(input) {
     };
   }
 }
+async function postBeadsProvisioning(input) {
+  try {
+    await _transport.postJsonAuthed(
+      `${API_BASE}/api/beads/provisioning`,
+      {
+        sessionId: input.sessionId,
+        pluginId: input.pluginId,
+        status: input.status,
+        ...input.projectKey ? { projectKey: input.projectKey } : {}
+      },
+      input.pluginAuthToken
+    );
+    return { ok: true };
+  } catch (err) {
+    const e = err;
+    return {
+      ok: false,
+      status: typeof e.statusCode === "number" ? e.statusCode : 0,
+      message: e.message || "unknown"
+    };
+  }
+}
 async function _postJsonAuthed(url, body, pluginAuthToken) {
-  return new Promise((resolve6, reject) => {
+  return new Promise((resolve7, reject) => {
     const data = JSON.stringify(body);
     const u2 = new URL(url);
     const transport = u2.protocol === "https:" ? https : http;
@@ -884,9 +907,9 @@ async function _postJsonAuthed(url, body, pluginAuthToken) {
             return;
           }
           try {
-            resolve6(JSON.parse(responseBody));
+            resolve7(JSON.parse(responseBody));
           } catch {
-            resolve6(null);
+            resolve7(null);
           }
         });
       }
@@ -911,7 +934,7 @@ function makeHttpError(statusCode, retryAfterHeader, responseBody) {
   return err;
 }
 async function _postJson(url, body) {
-  return new Promise((resolve6, reject) => {
+  return new Promise((resolve7, reject) => {
     const data = JSON.stringify(body);
     const u2 = new URL(url);
     const transport = u2.protocol === "https:" ? https : http;
@@ -940,9 +963,9 @@ async function _postJson(url, body) {
             return;
           }
           try {
-            resolve6(JSON.parse(body2));
+            resolve7(JSON.parse(body2));
           } catch {
-            resolve6(null);
+            resolve7(null);
           }
         });
       }
@@ -957,7 +980,7 @@ async function _postJson(url, body) {
   });
 }
 async function _getJson(url) {
-  return new Promise((resolve6, reject) => {
+  return new Promise((resolve7, reject) => {
     const u2 = new URL(url);
     const transport = u2.protocol === "https:" ? https : http;
     const req = transport.request(
@@ -981,9 +1004,9 @@ async function _getJson(url) {
             return;
           }
           try {
-            resolve6(JSON.parse(body));
+            resolve7(JSON.parse(body));
           } catch {
-            resolve6(null);
+            resolve7(null);
           }
         });
       }
@@ -1161,8 +1184,8 @@ function createGetModuleFromFilename(basePath = process.argv[1] ? (0, import_pat
     return decodedFile;
   };
 }
-function normalizeWindowsPath(path46) {
-  return path46.replace(/^[A-Z]:/, "").replace(/\\/g, "/");
+function normalizeWindowsPath(path50) {
+  return path50.replace(/^[A-Z]:/, "").replace(/\\/g, "/");
 }
 
 // ../../node_modules/@posthog/core/dist/featureFlagUtils.mjs
@@ -3642,15 +3665,15 @@ async function addSourceContext(frames) {
   LRU_FILE_CONTENTS_CACHE.reduce();
   return frames;
 }
-function getContextLinesFromFile(path46, ranges, output) {
-  return new Promise((resolve6) => {
-    const stream = (0, import_node_fs.createReadStream)(path46);
+function getContextLinesFromFile(path50, ranges, output) {
+  return new Promise((resolve7) => {
+    const stream = (0, import_node_fs.createReadStream)(path50);
     const lineReaded = (0, import_node_readline.createInterface)({
       input: stream
     });
     function destroyStreamAndResolve() {
       stream.destroy();
-      resolve6();
+      resolve7();
     }
     let lineNumber = 0;
     let currentRangeIndex = 0;
@@ -3659,7 +3682,7 @@ function getContextLinesFromFile(path46, ranges, output) {
     let rangeStart = range[0];
     let rangeEnd = range[1];
     function onStreamError() {
-      LRU_FILE_CONTENTS_FS_READ_FAILED.set(path46, 1);
+      LRU_FILE_CONTENTS_FS_READ_FAILED.set(path50, 1);
       lineReaded.close();
       lineReaded.removeAllListeners();
       destroyStreamAndResolve();
@@ -3720,8 +3743,8 @@ function clearLineContext(frame) {
   delete frame.context_line;
   delete frame.post_context;
 }
-function shouldSkipContextLinesForFile(path46) {
-  return path46.startsWith("node:") || path46.endsWith(".min.js") || path46.endsWith(".min.cjs") || path46.endsWith(".min.mjs") || path46.startsWith("data:");
+function shouldSkipContextLinesForFile(path50) {
+  return path50.startsWith("node:") || path50.endsWith(".min.js") || path50.endsWith(".min.cjs") || path50.endsWith(".min.mjs") || path50.startsWith("data:");
 }
 function shouldSkipContextLinesForFrame(frame) {
   if (void 0 !== frame.lineno && frame.lineno > MAX_CONTEXTLINES_LINENO) return true;
@@ -4937,9 +4960,9 @@ var PostHogBackendClient = class extends PostHogCoreStateless {
     if (!waitUntil) return;
     if (this.disabled || this.optedOut) return;
     if (!this._waitUntilCycle) {
-      let resolve6;
+      let resolve7;
       const promise = new Promise((r) => {
-        resolve6 = r;
+        resolve7 = r;
       });
       try {
         waitUntil(promise);
@@ -4947,7 +4970,7 @@ var PostHogBackendClient = class extends PostHogCoreStateless {
         return;
       }
       this._waitUntilCycle = {
-        resolve: resolve6,
+        resolve: resolve7,
         startedAt: Date.now(),
         timer: void 0
       };
@@ -4971,12 +4994,12 @@ var PostHogBackendClient = class extends PostHogCoreStateless {
     return cycle?.resolve;
   }
   async resolveWaitUntilFlush() {
-    const resolve6 = this._consumeWaitUntilCycle();
+    const resolve7 = this._consumeWaitUntilCycle();
     try {
       await super.flush();
     } catch {
     } finally {
-      resolve6?.();
+      resolve7?.();
     }
   }
   getPersistedProperty(key) {
@@ -5068,15 +5091,15 @@ var PostHogBackendClient = class extends PostHogCoreStateless {
   async waitForLocalEvaluationReady(timeoutMs = THIRTY_SECONDS) {
     if (this.isLocalEvaluationReady()) return true;
     if (void 0 === this.featureFlagsPoller) return false;
-    return new Promise((resolve6) => {
+    return new Promise((resolve7) => {
       const timeout = setTimeout(() => {
         cleanup();
-        resolve6(false);
+        resolve7(false);
       }, timeoutMs);
       const cleanup = this._events.on("localEvaluationFlagsLoaded", (count) => {
         clearTimeout(timeout);
         cleanup();
-        resolve6(count > 0);
+        resolve7(count > 0);
       });
     });
   }
@@ -5513,13 +5536,13 @@ var PostHogBackendClient = class extends PostHogCoreStateless {
     this.context?.enter(data, options);
   }
   async _shutdown(shutdownTimeoutMs) {
-    const resolve6 = this._consumeWaitUntilCycle();
+    const resolve7 = this._consumeWaitUntilCycle();
     await this.featureFlagsPoller?.stopPoller(shutdownTimeoutMs);
     this.errorTracking.shutdown();
     try {
       return await super._shutdown(shutdownTimeoutMs);
     } finally {
-      resolve6?.();
+      resolve7?.();
     }
   }
   async _requestRemoteConfigPayload(flagKey) {
@@ -5875,7 +5898,7 @@ function readAnonId() {
 }
 function superProperties() {
   return {
-    cliVersion: true ? "2.32.10" : "0.0.0-dev",
+    cliVersion: true ? "2.34.0" : "0.0.0-dev",
     nodeVersion: process.version,
     platform: process.platform,
     arch: process.arch,
@@ -7217,10 +7240,10 @@ function buildForPlatform(platform2) {
 var import_node_crypto4 = require("crypto");
 
 // src/agents/claude/resolver.ts
-function buildClaudeLaunch(extraArgs = [], os29 = createOsStrategy()) {
-  const found = os29.findInPath("claude") ?? os29.findInPath("claude-code");
+function buildClaudeLaunch(extraArgs = [], os30 = createOsStrategy()) {
+  const found = os30.findInPath("claude") ?? os30.findInPath("claude-code");
   if (!found) return null;
-  return os29.buildLaunch(found, extraArgs);
+  return os30.buildLaunch(found, extraArgs);
 }
 
 // src/agents/claude/installer.ts
@@ -9176,15 +9199,15 @@ function runInstaller() {
     "-Command",
     "irm https://claude.ai/install.ps1 | iex"
   ] : ["-c", "curl -fsSL https://claude.ai/install.sh | bash"];
-  return new Promise((resolve6) => {
+  return new Promise((resolve7) => {
     const proc = (0, import_child_process4.spawn)(cmd, args2, { stdio: "inherit" });
     proc.on("error", (err) => {
       console.error(`
   \u2717 Installer failed to launch: ${err.message}`);
-      resolve6(false);
+      resolve7(false);
     });
     proc.on("exit", (code) => {
-      resolve6(code === 0);
+      resolve7(code === 0);
     });
   });
 }
@@ -9361,17 +9384,17 @@ function parseUsageOutput(raw) {
   return { percent, resetAt };
 }
 async function fetchClaudeQuota() {
-  return new Promise((resolve6) => {
+  return new Promise((resolve7) => {
     const claudeCmd = findInPath("claude") ? "claude" : "claude-code";
     if (!claudeCmd) {
-      resolve6(null);
+      resolve7(null);
       return;
     }
     const helperPath = path11.join(os10.tmpdir(), "codeam-quota-helper.py");
     fs8.writeFileSync(helperPath, HELPER_SCRIPT, { mode: 420 });
     const python = findInPath("python3") ?? findInPath("python");
     if (!python) {
-      resolve6(null);
+      resolve7(null);
       return;
     }
     const proc = (0, import_child_process5.spawn)(python, [helperPath, claudeCmd, "--tools", ""], {
@@ -9398,13 +9421,13 @@ async function fetchClaudeQuota() {
           fs8.unlinkSync(helperPath);
         } catch {
         }
-        resolve6(result);
+        resolve7(result);
       }, 5e3);
     }, 8e3);
     setTimeout(() => {
       if (!resolved) {
         resolved = true;
-        resolve6(null);
+        resolve7(null);
       }
       try {
         proc.kill();
@@ -9435,12 +9458,12 @@ function killActiveSpawnAndCaptureChildren() {
 }
 async function spawnAndCapture(cmd, args2, opts = {}) {
   const timeoutMs = opts.timeoutMs ?? 6e4;
-  return new Promise((resolve6) => {
+  return new Promise((resolve7) => {
     let settled = false;
     const settle = (value) => {
       if (settled) return;
       settled = true;
-      resolve6(value);
+      resolve7(value);
     };
     let child;
     try {
@@ -9947,13 +9970,13 @@ function detectStartupBanner(lines) {
   while (artStart > 0 && BANNER_ART_RE.test(lines[artStart - 1])) artStart--;
   if (metaIdx - artStart < 2) return null;
   const pathLine = (lines[metaIdx + 1] ?? "").trim();
-  const path46 = pathLine && !BANNER_ART_RE.test(pathLine) ? pathLine : "";
+  const path50 = pathLine && !BANNER_ART_RE.test(pathLine) ? pathLine : "";
   return {
     title: "",
     subtitle: lines[metaIdx].trim(),
-    path: path46,
+    path: path50,
     startIdx: artStart,
-    endIdx: metaIdx + (path46 ? 1 : 0)
+    endIdx: metaIdx + (path50 ? 1 : 0)
   };
 }
 
@@ -9963,8 +9986,8 @@ var ClaudeRuntimeStrategy = class {
   meta = getAgent("claude");
   mode = "interactive";
   os;
-  constructor(os29) {
-    this.os = os29;
+  constructor(os30) {
+    this.os = os30;
   }
   /**
    * Claude Code's react-ink TUI enables bracketed-paste mode at
@@ -10972,8 +10995,8 @@ function codexCredentialLocator() {
 function codexLoginLauncher() {
   return {
     async ensureInstalled() {
-      const os29 = createOsStrategy();
-      return os29.findInPath("codex") !== null;
+      const os30 = createOsStrategy();
+      return os30.findInPath("codex") !== null;
     },
     launch() {
       return (0, import_node_child_process3.spawn)("codex", ["login"], { stdio: "inherit" });
@@ -10996,8 +11019,8 @@ var CodexRuntimeStrategy = class {
   meta = getAgent("codex");
   mode = "interactive";
   os;
-  constructor(os29) {
-    this.os = os29;
+  constructor(os30) {
+    this.os = os30;
   }
   async prepareLaunch() {
     let binary = this.os.findInPath("codex");
@@ -11103,16 +11126,16 @@ var CodexRuntimeStrategy = class {
     });
   }
 };
-function resolveNpm(os29) {
-  return os29.id === "win32" ? "npm.cmd" : "npm";
+function resolveNpm(os30) {
+  return os30.id === "win32" ? "npm.cmd" : "npm";
 }
-async function installCodexViaNpm(os29) {
-  return new Promise((resolve6, reject) => {
-    const proc = (0, import_node_child_process4.spawn)(resolveNpm(os29), ["install", "-g", "@openai/codex"], {
+async function installCodexViaNpm(os30) {
+  return new Promise((resolve7, reject) => {
+    const proc = (0, import_node_child_process4.spawn)(resolveNpm(os30), ["install", "-g", "@openai/codex"], {
       stdio: "inherit"
     });
     proc.on("close", (code) => {
-      if (code === 0) resolve6();
+      if (code === 0) resolve7();
       else reject(new Error(`npm install -g @openai/codex exited ${code}`));
     });
     proc.on("error", (err) => {
@@ -11125,16 +11148,16 @@ async function installCodexViaNpm(os29) {
     });
   });
 }
-function augmentNpmGlobalBin(os29) {
+function augmentNpmGlobalBin(os30) {
   try {
-    const result = (0, import_node_child_process4.spawnSync)(resolveNpm(os29), ["prefix", "-g"], {
+    const result = (0, import_node_child_process4.spawnSync)(resolveNpm(os30), ["prefix", "-g"], {
       stdio: ["ignore", "pipe", "ignore"]
     });
     if (result.status !== 0) return;
     const prefix = result.stdout.toString().trim();
     if (!prefix) return;
-    const binDir = os29.id === "win32" ? prefix : path17.join(prefix, "bin");
-    os29.augmentPath([binDir]);
+    const binDir = os30.id === "win32" ? prefix : path17.join(prefix, "bin");
+    os30.augmentPath([binDir]);
   } catch {
   }
 }
@@ -11218,25 +11241,25 @@ var import_node_child_process7 = require("child_process");
 // src/agents/coderabbit/installer.ts
 var import_node_child_process5 = require("child_process");
 var INSTALL_URL = "https://cli.coderabbit.ai/install.sh";
-async function ensureCoderabbitInstalled(os29) {
-  if (os29.findInPath("coderabbit")) return true;
-  if (os29.id === "win32") {
+async function ensureCoderabbitInstalled(os30) {
+  if (os30.findInPath("coderabbit")) return true;
+  if (os30.id === "win32") {
     console.error(
       "\n  \u2717 CodeRabbit on Windows requires WSL.\n    Install the CLI inside your WSL distribution\n    (curl -fsSL https://cli.coderabbit.ai/install.sh | sh)\n    then re-run `codeam link coderabbit` from WSL.\n"
     );
     return false;
   }
   console.log("\n  CodeRabbit CLI not found \u2014 installing via the official script\u2026\n");
-  const ok = await new Promise((resolve6) => {
+  const ok = await new Promise((resolve7) => {
     const proc = (0, import_node_child_process5.spawn)("sh", ["-c", `curl -fsSL ${INSTALL_URL} | sh`], {
       stdio: "inherit"
     });
-    proc.on("close", (code) => resolve6(code === 0));
-    proc.on("error", () => resolve6(false));
+    proc.on("close", (code) => resolve7(code === 0));
+    proc.on("error", () => resolve7(false));
   });
   if (!ok) return false;
-  os29.augmentPath([`${os29.homeDir()}/.local/bin`, "/opt/homebrew/bin"]);
-  return os29.findInPath("coderabbit") !== null;
+  os30.augmentPath([`${os30.homeDir()}/.local/bin`, "/opt/homebrew/bin"]);
+  return os30.findInPath("coderabbit") !== null;
 }
 
 // src/agents/coderabbit/link.ts
@@ -11263,10 +11286,10 @@ function coderabbitCredentialLocator() {
     extract: extractLocalCoderabbitToken
   };
 }
-function coderabbitLoginLauncher(os29) {
+function coderabbitLoginLauncher(os30) {
   return {
     async ensureInstalled() {
-      return ensureCoderabbitInstalled(os29);
+      return ensureCoderabbitInstalled(os30);
     },
     launch() {
       return (0, import_node_child_process6.spawn)("coderabbit", ["login"], { stdio: "inherit" });
@@ -11289,11 +11312,11 @@ function parseReview(stdout) {
   for (const line of lines) {
     const m = line.match(HUNK_LINE_RE);
     if (!m) continue;
-    const [, path46, lineNo, sevToken, message] = m;
-    if (!path46 || !lineNo || !message) continue;
+    const [, path50, lineNo, sevToken, message] = m;
+    if (!path50 || !lineNo || !message) continue;
     const cleanedMessage = message.trim().replace(/^[*-]\s+/, "");
     hunks.push({
-      path: path46.trim(),
+      path: path50.trim(),
       line: Number(lineNo),
       severity: sevToken ? SEVERITY_MAP[sevToken.toLowerCase()] : void 0,
       message: cleanedMessage
@@ -11312,8 +11335,8 @@ var CoderabbitRuntimeStrategy = class {
   meta = getAgent("coderabbit");
   mode = "batch";
   os;
-  constructor(os29) {
-    this.os = os29;
+  constructor(os30) {
+    this.os = os30;
   }
   getDefaultArgs() {
     return ["review"];
@@ -11351,7 +11374,7 @@ var CoderabbitRuntimeStrategy = class {
   }
   async runOneShot(input) {
     const launch = await this.prepareInvocation(input);
-    return new Promise((resolve6, reject) => {
+    return new Promise((resolve7, reject) => {
       const stdoutBuf = [];
       const stderrBuf = [];
       const proc = (0, import_node_child_process7.spawn)(launch.cmd, launch.args, {
@@ -11362,7 +11385,7 @@ var CoderabbitRuntimeStrategy = class {
       proc.stderr?.on("data", (b) => stderrBuf.push(b));
       proc.on("error", (err) => reject(err));
       proc.on("close", (code) => {
-        resolve6(
+        resolve7(
           this.parseOutput({
             exitCode: code ?? 0,
             stdout: Buffer.concat(stdoutBuf).toString("utf8"),
@@ -11428,10 +11451,10 @@ function cursorCredentialLocator() {
     extract: extractLocalCursorToken
   };
 }
-function cursorLoginLauncher(os29) {
+function cursorLoginLauncher(os30) {
   return {
     async ensureInstalled() {
-      if (os29.findInPath("cursor-agent")) return true;
+      if (os30.findInPath("cursor-agent")) return true;
       console.error(
         "\n  \u2717 cursor-agent binary not on PATH.\n    Install Cursor (https://cursor.com/) and ensure the CLI\n    plugin is enabled, then re-run `codeam link cursor`.\n"
       );
@@ -11493,8 +11516,8 @@ var CursorRuntimeStrategy = class {
   meta = getAgent("cursor");
   mode = "interactive";
   os;
-  constructor(os29) {
-    this.os = os29;
+  constructor(os30) {
+    this.os = os30;
   }
   async prepareLaunch() {
     const binary = this.os.findInPath("cursor-agent");
@@ -11614,10 +11637,10 @@ function aiderCredentialLocator() {
     extract: extractLocalAiderToken
   };
 }
-function aiderLoginLauncher(os29) {
+function aiderLoginLauncher(os30) {
   return {
     async ensureInstalled() {
-      if (os29.findInPath("aider")) return true;
+      if (os30.findInPath("aider")) return true;
       console.error(
         "\n  \u2717 aider binary not on PATH.\n    Install Aider:\n      pip install aider-chat\n    then re-run `codeam link aider`.\n"
       );
@@ -11627,7 +11650,7 @@ function aiderLoginLauncher(os29) {
       console.error(
         "\n  Aider has no interactive login flow.\n    Set ANTHROPIC_API_KEY or OPENAI_API_KEY in your shell,\n    or re-run `codeam link aider --api-key=<your-key>`.\n"
       );
-      return (0, import_node_child_process9.spawn)(os29.id === "win32" ? "cmd.exe" : "sh", os29.id === "win32" ? ["/c", "exit", "0"] : ["-c", "exit 0"], {
+      return (0, import_node_child_process9.spawn)(os30.id === "win32" ? "cmd.exe" : "sh", os30.id === "win32" ? ["/c", "exit", "0"] : ["-c", "exit 0"], {
         stdio: "ignore"
       });
     }
@@ -11699,8 +11722,8 @@ var AiderRuntimeStrategy = class {
   meta = getAgent("aider");
   mode = "interactive";
   os;
-  constructor(os29) {
-    this.os = os29;
+  constructor(os30) {
+    this.os = os30;
   }
   async prepareLaunch() {
     const binary = this.os.findInPath("aider");
@@ -11829,8 +11852,8 @@ function geminiCredentialLocator() {
 function geminiLoginLauncher() {
   return {
     async ensureInstalled() {
-      const os29 = createOsStrategy();
-      return os29.findInPath("gemini") !== null;
+      const os30 = createOsStrategy();
+      return os30.findInPath("gemini") !== null;
     },
     launch() {
       return (0, import_node_child_process10.spawn)("gemini", ["auth", "login"], { stdio: "inherit" });
@@ -11863,8 +11886,8 @@ var GeminiRuntimeStrategy = class {
   meta = getAgent("gemini");
   mode = "interactive";
   os;
-  constructor(os29) {
-    this.os = os29;
+  constructor(os30) {
+    this.os = os30;
   }
   async prepareLaunch() {
     const binary = this.os.findInPath("gemini");
@@ -11964,18 +11987,18 @@ var GeminiRuntimeStrategy = class {
 
 // src/agents/registry.ts
 var runtimeBuilders = {
-  claude: (os29) => new ClaudeRuntimeStrategy(os29),
-  codex: (os29) => new CodexRuntimeStrategy(os29),
-  coderabbit: (os29) => new CoderabbitRuntimeStrategy(os29),
-  cursor: (os29) => new CursorRuntimeStrategy(os29),
-  aider: (os29) => new AiderRuntimeStrategy(os29),
-  gemini: (os29) => new GeminiRuntimeStrategy(os29)
+  claude: (os30) => new ClaudeRuntimeStrategy(os30),
+  codex: (os30) => new CodexRuntimeStrategy(os30),
+  coderabbit: (os30) => new CoderabbitRuntimeStrategy(os30),
+  cursor: (os30) => new CursorRuntimeStrategy(os30),
+  aider: (os30) => new AiderRuntimeStrategy(os30),
+  gemini: (os30) => new GeminiRuntimeStrategy(os30)
 };
 var deployBuilders = {
   claude: () => new ClaudeDeployStrategy(),
   codex: () => new CodexDeployStrategy()
 };
-function createAgentStrategy(agent, os29 = createOsStrategy()) {
+function createAgentStrategy(agent, os30 = createOsStrategy()) {
   if (!AGENT_REGISTRY[agent]?.enabled) {
     throw new Error(
       `Agent "${agent}" is not supported in this codeam-cli version. Upgrade with 'npm i -g codeam-cli@latest'.`
@@ -11985,10 +12008,10 @@ function createAgentStrategy(agent, os29 = createOsStrategy()) {
   if (!build) {
     throw new Error(`No runtime strategy registered for agent "${agent}"`);
   }
-  return build(os29);
+  return build(os30);
 }
-function createInteractiveAgentStrategy(agent, os29 = createOsStrategy()) {
-  const s = createAgentStrategy(agent, os29);
+function createInteractiveAgentStrategy(agent, os30 = createOsStrategy()) {
+  const s = createAgentStrategy(agent, os30);
   if (s.mode !== "interactive") {
     throw new Error(
       `Agent "${agent}" is a batch agent; use createAgentStrategy + .runOneShot for one-shot reviews.`
@@ -14268,8 +14291,8 @@ var Connection = class {
     this.requestHandler = requestHandler;
     this.notificationHandler = notificationHandler;
     this.stream = stream;
-    this.closedPromise = new Promise((resolve6) => {
-      this.abortController.signal.addEventListener("abort", () => resolve6());
+    this.closedPromise = new Promise((resolve7) => {
+      this.abortController.signal.addEventListener("abort", () => resolve7());
     });
     void this.receive();
   }
@@ -14439,11 +14462,11 @@ var Connection = class {
       return rejectedPromise(this.closedReason());
     }
     const id = this.nextRequestId++;
-    const responsePromise = new Promise((resolve6, reject) => {
+    const responsePromise = new Promise((resolve7, reject) => {
       this.pendingResponses.set(id, {
         resolve: (response) => {
           try {
-            resolve6(mapResponse ? mapResponse(response) : response);
+            resolve7(mapResponse ? mapResponse(response) : response);
           } catch (error) {
             reject(error);
           }
@@ -14764,17 +14787,17 @@ var AcpClient = class {
     this.sessionId = null;
     try {
       child.kill("SIGTERM");
-      const grace = new Promise((resolve6) => {
+      const grace = new Promise((resolve7) => {
         const t2 = setTimeout(() => {
           try {
             child.kill("SIGKILL");
           } catch {
           }
-          resolve6();
+          resolve7();
         }, 2e3);
         child.once("exit", () => {
           clearTimeout(t2);
-          resolve6();
+          resolve7();
         });
       });
       await grace;
@@ -14912,7 +14935,7 @@ var _transport2 = {
   get: _get
 };
 function _post(url, headers, payload) {
-  return new Promise((resolve6, reject) => {
+  return new Promise((resolve7, reject) => {
     let settled = false;
     const u2 = new URL(url);
     const lib = u2.protocol === "https:" ? https3 : http3;
@@ -14937,7 +14960,7 @@ function _post(url, headers, payload) {
         res.on("end", () => {
           if (settled) return;
           settled = true;
-          resolve6({ statusCode: res.statusCode ?? 0, body });
+          resolve7({ statusCode: res.statusCode ?? 0, body });
         });
       }
     );
@@ -14954,7 +14977,7 @@ function _post(url, headers, payload) {
   });
 }
 function _get(url, headers) {
-  return new Promise((resolve6, reject) => {
+  return new Promise((resolve7, reject) => {
     let settled = false;
     const u2 = new URL(url);
     const lib = u2.protocol === "https:" ? https3 : http3;
@@ -14978,7 +15001,7 @@ function _get(url, headers) {
         res.on("end", () => {
           if (settled) return;
           settled = true;
-          resolve6({ statusCode: res.statusCode ?? 0, body });
+          resolve7({ statusCode: res.statusCode ?? 0, body });
         });
       }
     );
@@ -15687,11 +15710,11 @@ function extractSelectPrompt(text) {
 }
 
 // src/commands/start/handlers.ts
-var fs29 = __toESM(require("fs"));
-var os24 = __toESM(require("os"));
-var path35 = __toESM(require("path"));
+var fs32 = __toESM(require("fs"));
+var os25 = __toESM(require("os"));
+var path39 = __toESM(require("path"));
 var import_crypto3 = require("crypto");
-var import_child_process12 = require("child_process");
+var import_child_process15 = require("child_process");
 
 // src/lib/payload.ts
 var import_zod = require("zod");
@@ -16344,12 +16367,12 @@ async function applyFileReview(workingDir, filePath, action) {
   return { ok: true, action, filePath, repoRoot };
 }
 function runGit(cwd, args2) {
-  return new Promise((resolve6) => {
+  return new Promise((resolve7) => {
     let proc;
     try {
       proc = (0, import_child_process10.spawn)("git", args2, { cwd, env: process.env });
     } catch (err) {
-      resolve6({ ok: false, code: -1, stdout: "", stderr: err.message });
+      resolve7({ ok: false, code: -1, stdout: "", stderr: err.message });
       return;
     }
     let stdout = "";
@@ -16362,11 +16385,11 @@ function runGit(cwd, args2) {
     });
     proc.on(
       "error",
-      (err) => resolve6({ ok: false, code: -1, stdout, stderr: stderr + err.message })
+      (err) => resolve7({ ok: false, code: -1, stdout, stderr: stderr + err.message })
     );
     proc.on(
       "close",
-      (code) => resolve6({ ok: code === 0, code: code ?? -1, stdout, stderr })
+      (code) => resolve7({ ok: code === 0, code: code ?? -1, stdout, stderr })
     );
   });
 }
@@ -16625,7 +16648,7 @@ async function link(args2 = []) {
   waitSpin.start(waitMsg());
   const countdown = setInterval(() => waitSpin.message(waitMsg()), 1e3);
   countdown.unref?.();
-  const paired = await new Promise((resolve6, reject) => {
+  const paired = await new Promise((resolve7, reject) => {
     let stopPoll = null;
     const sigint = () => {
       clearInterval(countdown);
@@ -16638,7 +16661,7 @@ async function link(args2 = []) {
         process.removeListener("SIGINT", sigint);
         clearInterval(countdown);
         waitSpin.stop("Paired");
-        resolve6(info);
+        resolve7(info);
       },
       () => {
         clearInterval(countdown);
@@ -16773,14 +16796,14 @@ async function captureFreshCredentials(ctx) {
     }
   };
   try {
-    const token = await new Promise((resolve6, reject) => {
+    const token = await new Promise((resolve7, reject) => {
       let settled = false;
       const tryExtract = async () => {
         if (settled) return;
         const t2 = await ctx.locator.extract();
         if (t2 && !settled) {
           settled = true;
-          resolve6(t2);
+          resolve7(t2);
         }
       };
       watcher.on("add", () => void tryExtract());
@@ -17178,167 +17201,938 @@ function activePreviewSessionIds() {
   return Array.from(activePreviews.keys());
 }
 
-// src/commands/start/handlers.ts
-var pendingAttachmentFiles = /* @__PURE__ */ new Set();
-function cleanupAttachmentTempFiles() {
-  for (const p2 of pendingAttachmentFiles) {
-    try {
-      fs29.unlinkSync(p2);
-    } catch {
-    }
-  }
-  pendingAttachmentFiles.clear();
+// src/beads/bd-adapter.ts
+var import_child_process12 = require("child_process");
+var fs29 = __toESM(require("fs"));
+var os24 = __toESM(require("os"));
+var path35 = __toESM(require("path"));
+var BD_PACKAGE = "@beads/bd";
+function resolveBundledBdBinary() {
+  return _resolveSeam.resolveBundled();
 }
-function saveFilesTemp(files) {
-  return files.filter(({ base64 }) => base64 && base64.length > 0).map(({ filename, base64 }) => {
-    const safeName = filename.replace(/[^a-zA-Z0-9._-]/g, "_").slice(0, 80);
-    const tmpPath = path35.join(os24.tmpdir(), `codeam-${(0, import_crypto3.randomUUID)()}-${safeName}`);
-    fs29.writeFileSync(tmpPath, Buffer.from(base64, "base64"));
-    pendingAttachmentFiles.add(tmpPath);
-    return tmpPath;
-  });
+function _defaultResolveBundled() {
+  let pkgJsonPath;
+  try {
+    pkgJsonPath = require.resolve(`${BD_PACKAGE}/package.json`);
+  } catch {
+    return null;
+  }
+  const binDir = path35.join(path35.dirname(pkgJsonPath), "bin");
+  const binaryName = process.platform === "win32" ? "bd.exe" : "bd";
+  const binaryPath = path35.join(binDir, binaryName);
+  try {
+    fs29.accessSync(binaryPath, fs29.constants.F_OK);
+    return binaryPath;
+  } catch {
+    return null;
+  }
 }
-function dispatchPrompt(ctx, prompt) {
-  ctx.outputSvc.newTurn();
-  ctx.agent.sendCommand(prompt);
+function resolveBdOnPath() {
+  return _resolveSeam.resolveOnPath();
 }
-var startTask = (ctx, _cmd, parsed) => {
-  const { prompt, files } = parsed;
-  const effectivePrompt = prompt ?? "";
-  if (files && files.length > 0) {
-    const paths = saveFilesTemp(files);
-    const atRefs = paths.map((p2) => `@${p2}`).join(" ");
-    ctx.outputSvc.newTurn();
-    ctx.agent.sendCommand(`${atRefs} ${effectivePrompt}`.trim());
-    setTimeout(() => {
-      for (const p2 of paths) {
-        try {
-          fs29.unlinkSync(p2);
-        } catch {
-        }
-        pendingAttachmentFiles.delete(p2);
+function _defaultResolveOnPath() {
+  const dirs = (process.env.PATH ?? "").split(path35.delimiter).filter(Boolean);
+  const candidates = process.platform === "win32" ? ["bd.exe", "bd.cmd", "bd"] : ["bd"];
+  for (const dir of dirs) {
+    for (const candidate of candidates) {
+      const full = path35.join(dir, candidate);
+      try {
+        fs29.accessSync(full, fs29.constants.F_OK);
+        return full;
+      } catch {
       }
-    }, 12e4);
-  } else if (effectivePrompt) {
-    dispatchPrompt(ctx, effectivePrompt);
+    }
   }
+  return null;
+}
+var _resolveSeam = {
+  resolveBundled: _defaultResolveBundled,
+  resolveOnPath: _defaultResolveOnPath
 };
-var provideInput = (ctx, _cmd, parsed) => {
-  if (parsed.input) dispatchPrompt(ctx, parsed.input);
-};
-var selectOption = (ctx, _cmd, parsed) => {
-  const index = parsed.index ?? 0;
-  const from = parsed.from ?? 0;
-  ctx.outputSvc.newTurn();
-  ctx.agent.selectOption(index, from);
-};
-var escapeKey = (ctx) => {
-  ctx.outputSvc.newTurn();
-  ctx.agent.sendEscape();
-};
-var stopTask = (ctx) => {
-  ctx.agent.interrupt();
-};
-var resumeSession = async (ctx, _cmd, parsed) => {
-  const { id, auto } = parsed;
-  if (!id) return;
-  ctx.historySvc.setCurrentConversationId(id);
-  await ctx.historySvc.loadConversation(id);
-  await ctx.outputSvc.newTurnResume(id);
-  ctx.agent.restart(id, auto ?? false);
-};
-var getContext = async (ctx, cmd) => {
-  const usage = ctx.historySvc.getCurrentUsage();
-  const monthlyCost = ctx.historySvc.getMonthlyEstimatedCost();
-  const rateLimitReset = ctx.historySvc.getRateLimitReset();
-  const quotaPercent = ctx.historySvc.getQuotaPercent();
-  const base = usage ? { ...usage, monthlyCost } : { used: 0, total: 2e5, percent: 0, model: null, outputTokens: 0, cacheReadTokens: 0, monthlyCost, error: "No usage data found" };
-  const result = {
-    ...base,
-    ...rateLimitReset ? { rateLimitReset } : {},
-    ...quotaPercent !== null ? { quotaPercent } : {}
-  };
-  await ctx.relay.sendResult(cmd.id, "completed", result);
+var _spawnSeam = {
+  run: _defaultSpawn
 };
-var getConversation = async (ctx, cmd) => {
-  let currentId = ctx.historySvc.getCurrentConversationId();
-  if (!currentId) {
-    ctx.historySvc.detectCurrentConversation();
-    currentId = ctx.historySvc.getCurrentConversationId();
+function _defaultSpawn(binaryPath, args2, opts) {
+  return new Promise((resolve7) => {
+    let proc;
+    try {
+      proc = (0, import_child_process12.spawn)(binaryPath, args2, { cwd: opts.cwd, env: opts.env });
+    } catch (err) {
+      resolve7({ code: -1, stdout: "", stderr: err.message });
+      return;
+    }
+    let stdout = "";
+    let stderr = "";
+    proc.stdout?.on("data", (c2) => {
+      stdout += c2.toString();
+    });
+    proc.stderr?.on("data", (c2) => {
+      stderr += c2.toString();
+    });
+    proc.on("error", (err) => resolve7({ code: -1, stdout, stderr: err.message }));
+    proc.on("close", (code) => resolve7({ code: code ?? -1, stdout, stderr }));
+  });
+}
+var BdAdapter = class {
+  constructor(opts = {}) {
+    this.opts = opts;
+    this.resolved = opts.binaryPath ?? null;
   }
-  if (!currentId) {
-    await ctx.relay.sendResult(cmd.id, "completed", { conversationId: null });
-    return;
+  opts;
+  resolved;
+  /**
+   * Resolve the bd binary lazily, caching the result. Order:
+   * bundled @beads/bd → PATH. Returns null when neither is available — the
+   * caller offers the consented installer (`install-bd.ts`).
+   */
+  resolveBinary() {
+    if (this.resolved) return this.resolved;
+    const bundled = resolveBundledBdBinary();
+    if (bundled) {
+      this.resolved = bundled;
+      return bundled;
+    }
+    const onPath = resolveBdOnPath();
+    if (onPath) {
+      this.resolved = onPath;
+      return onPath;
+    }
+    return null;
   }
-  try {
-    await ctx.historySvc.loadConversation(currentId);
-    await ctx.relay.sendResult(cmd.id, "completed", { conversationId: currentId });
-  } catch {
-    await ctx.relay.sendResult(cmd.id, "failed", {});
+  /** True when a bd binary is resolvable without installing. */
+  isAvailable() {
+    return this.resolveBinary() !== null;
   }
-};
-var listModels = async (ctx, cmd) => {
-  const models = await ctx.runtime.listModels();
-  await ctx.relay.sendResult(cmd.id, "completed", { models });
-};
-var changeModel = async (ctx, cmd) => {
-  const params = cmd.payload;
-  if (typeof params.modelId !== "string" || !params.modelId) {
-    await ctx.relay.sendResult(cmd.id, "failed", { error: "modelId required" });
-    return;
+  /**
+   * Run an arbitrary bd subcommand against the home brain. `BEADS_DIR` is set
+   * to the configured `beadsDir` (tests) or `~/.beads` (the verified embedded
+   * home brain) so every command resolves to the same single graph regardless
+   * of the process cwd. Returns the raw result; callers decide how to interpret
+   * exit codes — note bd exits 0 even for some error states (e.g. "no beads
+   * database found"), so JSON-parsing callers must also inspect the payload.
+   */
+  async run(args2) {
+    const binary = this.resolveBinary();
+    if (!binary) {
+      return { code: -1, stdout: "", stderr: "bd binary not resolved" };
+    }
+    const env = { ...process.env };
+    env.BEADS_DIR = this.opts.beadsDir ?? defaultBeadsHomeDir();
+    log.trace("beads", `bd ${args2.join(" ")} (BEADS_DIR=${env.BEADS_DIR})`);
+    return _spawnSeam.run(binary, args2, { cwd: this.opts.cwd, env });
   }
-  const instr = ctx.runtime.changeModelInstruction(params.modelId);
-  if (instr.type === "pty") {
-    if (!instr.ptyInput) {
-      await ctx.relay.sendResult(cmd.id, "failed", { error: "no pty input for this agent" });
-      return;
+  /**
+   * `bd ready --json` → typed issue array. `bd list --json` shares the shape,
+   * so `listIssues` reuses the same parser. Bad JSON / non-zero exit → [].
+   */
+  async readyIssues(projectKey) {
+    const res = await this.run(["ready", "--json"]);
+    return parseIssues(res, projectKey);
+  }
+  async listIssues(projectKey) {
+    const res = await this.run(["list", "--json"]);
+    return parseIssues(res, projectKey);
+  }
+  /** `bd status --json` → summary block, or null on failure. */
+  async statusSummary() {
+    const res = await this.run(["status", "--json"]);
+    if (res.code !== 0) return null;
+    try {
+      const parsed = JSON.parse(res.stdout);
+      return parsed.summary ?? null;
+    } catch {
+      return null;
     }
-    ctx.agent.sendRawPtyInput(instr.ptyInput);
-  } else if (instr.type === "restart") {
-    await ctx.relay.sendResult(cmd.id, "failed", { error: "restart-mode change_model not supported in Phase 1" });
-    return;
   }
-  await ctx.relay.sendResult(cmd.id, "completed", {});
-};
-var summarize = async (ctx, cmd) => {
-  const params = cmd.payload;
-  const mode = params.mode === "auto" ? "auto" : "normal";
-  const instr = ctx.runtime.summarizeInstruction(mode);
-  ctx.agent.sendRawPtyInput(instr.ptyInput);
-  await ctx.relay.sendResult(cmd.id, "completed", {});
 };
-var setKeepAlive = async (ctx, cmd) => {
-  const enabled = !!cmd.payload.enabled;
-  ctx.setKeepAlive(enabled);
+var VALID_STATUS = /* @__PURE__ */ new Set([
+  "open",
+  "in_progress",
+  "blocked",
+  "closed"
+]);
+function parseIssues(res, projectKey) {
+  if (res.code !== 0) return [];
+  let parsed;
   try {
-    await ctx.relay.sendResult(
-      cmd.id,
-      "success",
-      {
-        enabled,
-        applied: enabled && ctx.keepAliveCtx.inCodespace,
-        runtime: ctx.keepAliveCtx.inCodespace ? "github-codespaces" : "local"
-      }
-    );
+    parsed = JSON.parse(res.stdout);
   } catch {
+    return [];
   }
-};
-var sessionTerminated = async (ctx, cmd) => {
-  showInfo("Session was deleted from the app \u2014 exiting.");
-  try {
-    await ctx.relay.sendResult(cmd.id, "success", { ok: true });
-  } catch {
+  if (!Array.isArray(parsed)) return [];
+  const out2 = [];
+  for (const row of parsed) {
+    const issue = coerceIssue(row, projectKey);
+    if (issue) out2.push(issue);
   }
-  try {
-    removeSession(ctx.sessionId);
-  } catch {
+  return out2;
+}
+function coerceIssue(row, projectKey) {
+  if (typeof row !== "object" || row === null) return null;
+  const r = row;
+  if (typeof r.id !== "string" || typeof r.title !== "string") return null;
+  const status2 = typeof r.status === "string" && VALID_STATUS.has(r.status) ? r.status : "open";
+  return {
+    id: r.id,
+    title: r.title,
+    status: status2,
+    priority: typeof r.priority === "number" ? r.priority : null,
+    issue_type: typeof r.issue_type === "string" ? r.issue_type : "task",
+    owner: typeof r.owner === "string" && r.owner.length > 0 ? r.owner : null,
+    created_at: typeof r.created_at === "string" ? r.created_at : "",
+    updated_at: typeof r.updated_at === "string" ? r.updated_at : "",
+    dependency_count: typeof r.dependency_count === "number" ? r.dependency_count : void 0,
+    dependent_count: typeof r.dependent_count === "number" ? r.dependent_count : void 0,
+    comment_count: typeof r.comment_count === "number" ? r.comment_count : void 0,
+    projectKey
+  };
+}
+function defaultBeadsHomeDir() {
+  return path35.join(os24.homedir(), ".beads");
+}
+
+// src/beads/provisioner.ts
+var fs30 = __toESM(require("fs"));
+var path36 = __toESM(require("path"));
+
+// src/beads/install-bd.ts
+var import_child_process13 = require("child_process");
+var INSTALL_SH_URL = "https://raw.githubusercontent.com/gastownhall/beads/main/scripts/install.sh";
+var INSTALL_PS1_URL = "https://raw.githubusercontent.com/gastownhall/beads/main/install.ps1";
+function resolveInstallStrategy(platform2) {
+  if (platform2 === "win32") {
+    return {
+      command: "powershell.exe",
+      args: [
+        "-NoProfile",
+        "-NonInteractive",
+        "-ExecutionPolicy",
+        "Bypass",
+        "-Command",
+        `irm ${INSTALL_PS1_URL} | iex`
+      ],
+      description: `PowerShell: irm ${INSTALL_PS1_URL} | iex (requires Go 1.24+ and Git for Windows on PATH)`
+    };
+  }
+  return {
+    command: "bash",
+    args: ["-c", `curl -fsSL ${INSTALL_SH_URL} | bash`],
+    description: `curl -fsSL ${INSTALL_SH_URL} | bash`
+  };
+}
+var _installSpawnSeam = {
+  run: _defaultInstallSpawn
+};
+function _defaultInstallSpawn(strategy) {
+  return new Promise((resolve7) => {
+    let proc;
+    try {
+      proc = (0, import_child_process13.spawn)(strategy.command, strategy.args, { env: process.env });
+    } catch (err) {
+      resolve7({ ok: false, code: -1, stderr: err.message });
+      return;
+    }
+    let stderr = "";
+    proc.stderr?.on("data", (c2) => {
+      stderr += c2.toString();
+    });
+    proc.on("error", (err) => resolve7({ ok: false, code: -1, stderr: err.message }));
+    proc.on(
+      "close",
+      (code) => resolve7({ ok: code === 0, code: code ?? -1, stderr })
+    );
+  });
+}
+async function installBd(platform2 = process.platform) {
+  const strategy = resolveInstallStrategy(platform2);
+  log.info("beads", `installing bd via ${strategy.description}`);
+  const result = await _installSpawnSeam.run(strategy);
+  if (!result.ok) {
+    log.warn(
+      "beads",
+      `bd install failed (code=${result.code}): ${result.stderr.slice(0, 200)}`
+    );
   }
+  return result;
+}
+
+// src/beads/provisioner.ts
+var AGENT_SETUP_RECIPE = {
+  claude: "claude",
+  codex: "codex",
+  copilot: "copilot",
+  cursor: "cursor",
+  aider: "aider",
+  gemini: "gemini",
+  coderabbit: null
+};
+var _provisionSeam = {
+  install: installBd,
+  homeBrainInitialized
+};
+function homeBrainInitialized(beadsDir) {
   try {
-    ctx.agent.kill();
+    return fs30.statSync(path36.join(beadsDir, "embeddeddolt")).isDirectory();
   } catch {
+    return false;
   }
-  try {
-    const proc = (0, import_child_process12.spawn)("bash", ["-lc", "pm2 delete codeam-pair >/dev/null 2>&1 || true"], {
+}
+async function provisionBeads(opts = {}) {
+  const bd = opts.adapter ?? new BdAdapter({ cwd: opts.cwd, beadsDir: opts.beadsDir });
+  const beadsDir = opts.beadsDir ?? defaultBeadsHomeDir();
+  const result = {
+    bdAvailable: false,
+    initialized: false,
+    exportEnabled: false,
+    agentsWired: []
+  };
+  if (!bd.isAvailable()) {
+    log.info("beads", "bd binary missing \u2014 running OS installer fallback");
+    const install = await _provisionSeam.install();
+    if (!install.ok) {
+      log.warn("beads", `bd install failed (code=${install.code}) \u2014 beads disabled this run`);
+      return result;
+    }
+  }
+  if (!bd.isAvailable()) {
+    log.warn("beads", "bd still unavailable after install \u2014 beads disabled this run");
+    return result;
+  }
+  result.bdAvailable = true;
+  if (_provisionSeam.homeBrainInitialized(beadsDir)) {
+    log.trace("beads", `home brain already initialized at ${beadsDir}`);
+    result.initialized = true;
+  } else {
+    log.info("beads", `initializing home brain at ${beadsDir}`);
+    const init = await bd.run(["init", "--skip-agents", "--skip-hooks", "--non-interactive"]);
+    if (init.code !== 0) {
+      log.warn("beads", `bd init failed (code=${init.code}): ${init.stderr.slice(0, 200)}`);
+      return result;
+    }
+    result.initialized = true;
+  }
+  const exp = await bd.run(["config", "set", "export.auto", "true"]);
+  result.exportEnabled = exp.code === 0;
+  result.agentsWired = await setupAgents(bd, opts.agents ?? []);
+  log.info(
+    "beads",
+    `provision done initialized=${result.initialized} export=${result.exportEnabled} agentsWired=[${result.agentsWired.join(",")}]`
+  );
+  return result;
+}
+async function setupAgents(bd, agents) {
+  const wired = [];
+  for (const recipe of dedupeRecipes(agents)) {
+    try {
+      const check = await bd.run(["setup", recipe, "--global", "--check"]);
+      if (check.code === 0) {
+        log.trace("beads", `bd setup ${recipe} --global already installed \u2014 skipping`);
+        wired.push(recipe);
+        continue;
+      }
+      log.info("beads", `wiring agent natively: bd setup ${recipe} --global`);
+      const setup = await bd.run(["setup", recipe, "--global"]);
+      if (setup.code === 0) {
+        wired.push(recipe);
+      } else {
+        log.warn(
+          "beads",
+          `bd setup ${recipe} --global failed (code=${setup.code}): ${setup.stderr.slice(0, 200)} \u2014 non-fatal, agent runs without native bd wiring`
+        );
+      }
+    } catch (err) {
+      log.warn("beads", `bd setup ${recipe} --global threw (non-fatal)`, err);
+    }
+  }
+  return wired;
+}
+function dedupeRecipes(agents) {
+  const seen = /* @__PURE__ */ new Set();
+  for (const agent of agents) {
+    const recipe = AGENT_SETUP_RECIPE[agent];
+    if (recipe) seen.add(recipe);
+  }
+  return [...seen];
+}
+
+// src/beads/watcher.ts
+var crypto3 = __toESM(require("crypto"));
+var path38 = __toESM(require("path"));
+
+// src/beads/project-key.ts
+var import_child_process14 = require("child_process");
+var crypto2 = __toESM(require("crypto"));
+var fs31 = __toESM(require("fs"));
+var path37 = __toESM(require("path"));
+function normalizeOrigin(raw) {
+  const trimmed = raw.trim();
+  if (!trimmed) return null;
+  let host;
+  let pathPart;
+  const scpLike = /^[^/@]+@([^:]+):(.+)$/.exec(trimmed);
+  if (scpLike && !trimmed.includes("://")) {
+    host = scpLike[1];
+    pathPart = scpLike[2];
+  } else {
+    let url;
+    try {
+      url = new URL(trimmed);
+    } catch {
+      return null;
+    }
+    host = url.hostname;
+    pathPart = url.pathname;
+  }
+  host = host.toLowerCase();
+  pathPart = pathPart.replace(/^\/+/, "").replace(/\.git$/i, "").replace(/\/+$/, "");
+  if (!host || !pathPart) return null;
+  return `${host}/${pathPart}`;
+}
+function findRepoRoot(cwd) {
+  let dir = path37.resolve(cwd);
+  const seen = /* @__PURE__ */ new Set();
+  for (let i = 0; i < 256; i++) {
+    if (seen.has(dir)) return null;
+    seen.add(dir);
+    try {
+      const stat3 = fs31.statSync(path37.join(dir, ".git"), { throwIfNoEntry: false });
+      if (stat3 && (stat3.isDirectory() || stat3.isFile())) return dir;
+    } catch {
+    }
+    const parent = path37.dirname(dir);
+    if (parent === dir) return null;
+    dir = parent;
+  }
+  return null;
+}
+var _execSeam2 = {
+  exec: (file, args2, opts) => {
+    const out2 = (0, import_child_process14.execFileSync)(file, args2, opts);
+    return typeof out2 === "string" ? out2 : out2.toString("utf8");
+  },
+  realpath: (p2) => fs31.realpathSync(p2)
+};
+function readOrigin(cwd) {
+  try {
+    const raw = _execSeam2.exec("git", ["remote", "get-url", "origin"], {
+      cwd,
+      timeout: 1e3,
+      stdio: ["ignore", "pipe", "ignore"],
+      encoding: "utf8"
+    });
+    return raw.trim() || null;
+  } catch {
+    return null;
+  }
+}
+function deriveProjectIdentity(cwd = process.cwd()) {
+  const repoRoot = findRepoRoot(cwd) ?? cwd;
+  const origin = readOrigin(repoRoot);
+  const normalized = origin ? normalizeOrigin(origin) : null;
+  if (normalized) {
+    const label = normalized.split("/").pop() || normalized;
+    return { projectKey: normalized, projectLabel: label };
+  }
+  let real = repoRoot;
+  try {
+    real = _execSeam2.realpath(repoRoot);
+  } catch {
+  }
+  const hash = crypto2.createHash("sha256").update(real).digest("hex");
+  return { projectKey: `path:${hash}`, projectLabel: path37.basename(real) || "project" };
+}
+
+// src/services/file-watcher/transport.ts
+var http5 = __toESM(require("http"));
+var https5 = __toESM(require("https"));
+var _transport3 = {
+  post: _post2
+};
+function _post2(url, headers, payload) {
+  return new Promise((resolve7, reject) => {
+    let settled = false;
+    const u2 = new URL(url);
+    const lib = u2.protocol === "https:" ? https5 : http5;
+    const req = lib.request(
+      {
+        hostname: u2.hostname,
+        port: u2.port || (u2.protocol === "https:" ? 443 : 80),
+        path: u2.pathname + u2.search,
+        method: "POST",
+        headers: {
+          ...headers,
+          ...vercelBypassHeader(),
+          "Content-Length": Buffer.byteLength(payload)
+        },
+        timeout: 8e3
+      },
+      (res) => {
+        let body = "";
+        res.on("data", (c2) => {
+          body += c2.toString();
+        });
+        res.on("end", () => {
+          if (settled) return;
+          settled = true;
+          resolve7({ statusCode: res.statusCode ?? 0, body });
+        });
+      }
+    );
+    req.on("error", (err) => {
+      if (settled) return;
+      settled = true;
+      reject(err);
+    });
+    req.on("timeout", () => {
+      req.destroy();
+    });
+    req.write(payload);
+    req.end();
+  });
+}
+
+// src/beads/watcher.ts
+var API_BASE4 = resolveApiBaseUrl();
+var DEBOUNCE_MS = 400;
+var _chokidarSeam = {
+  load: () => {
+    try {
+      return require("chokidar");
+    } catch {
+      return null;
+    }
+  }
+};
+var BeadsWatcher = class {
+  constructor(opts) {
+    this.opts = opts;
+    this.bd = opts.adapter ?? new BdAdapter({ cwd: opts.cwd, beadsDir: opts.beadsDir });
+    this.feedPath = opts.feedPath ?? path38.join(defaultBeadsHomeDir(), "issues.jsonl");
+    this.apiBase = opts.apiBaseUrl ?? API_BASE4;
+  }
+  opts;
+  watcher = null;
+  debounceTimer = null;
+  stopped = false;
+  lastPushedHash = null;
+  bd;
+  feedPath;
+  apiBase;
+  /** Start tailing the change feed. Idempotent (second call is a no-op). */
+  start() {
+    if (this.watcher || this.stopped) return;
+    const chokidar2 = _chokidarSeam.load();
+    if (!chokidar2) {
+      log.warn("beads", "chokidar unavailable \u2014 beads watcher disabled");
+      return;
+    }
+    const watcher = chokidar2.watch(this.feedPath, {
+      ignoreInitial: false,
+      // push the current state once on start
+      persistent: true,
+      awaitWriteFinish: { stabilityThreshold: 200, pollInterval: 100 }
+    });
+    watcher.on("add", () => this.scheduleSync());
+    watcher.on("change", () => this.scheduleSync());
+    watcher.on(
+      "error",
+      (err) => log.warn("beads", `feed watcher error \u2014 continuing: ${err}`)
+    );
+    this.watcher = watcher;
+    log.info("beads", `watching ${this.feedPath} for session=${this.opts.sessionId.slice(0, 8)}`);
+  }
+  async stop() {
+    if (this.stopped) return;
+    this.stopped = true;
+    if (this.debounceTimer) {
+      clearTimeout(this.debounceTimer);
+      this.debounceTimer = null;
+    }
+    if (this.watcher) {
+      try {
+        await this.watcher.close();
+      } catch (err) {
+        log.warn("beads", "error closing feed watcher", err);
+      }
+      this.watcher = null;
+    }
+  }
+  /**
+   * Debounce the filesystem event. Each fresh write resets the timer so a
+   * burst of bd mutations coalesces into one snapshot push. NOT polling — the
+   * timer only fires off the back of a real fs event.
+   */
+  scheduleSync() {
+    if (this.stopped) return;
+    if (this.debounceTimer) clearTimeout(this.debounceTimer);
+    this.debounceTimer = setTimeout(() => {
+      this.debounceTimer = null;
+      void this.syncNow();
+    }, DEBOUNCE_MS);
+  }
+  /** Visible for tests — pump a synthetic feed event through debounce → push. */
+  /* @internal */
+  _emitForTest() {
+    this.scheduleSync();
+  }
+  /**
+   * Build the full snapshot from bd and push it. Diffs against the last
+   * pushed content hash so an identical rewrite is a no-op.
+   */
+  async syncNow() {
+    if (this.stopped) return;
+    const { projectKey, projectLabel } = deriveProjectIdentity(this.opts.cwd);
+    const [issues, summary] = await Promise.all([
+      this.bd.listIssues(projectKey),
+      this.bd.statusSummary()
+    ]);
+    const payload = {
+      sessionId: this.opts.sessionId,
+      pluginId: this.opts.pluginId,
+      projectKey,
+      projectLabel,
+      fullSnapshot: true,
+      issues,
+      memories: [],
+      ...summary ? { summary } : {}
+    };
+    const body = JSON.stringify(payload);
+    const hash = crypto3.createHash("sha256").update(body).digest("hex");
+    if (hash === this.lastPushedHash) {
+      log.trace("beads", "snapshot unchanged \u2014 skipping push");
+      return;
+    }
+    try {
+      const res = await _transport3.post(`${this.apiBase}/api/beads/ingest`, this.headers(), body);
+      if (res.statusCode >= 200 && res.statusCode < 300) {
+        this.lastPushedHash = hash;
+        log.trace("beads", `pushed ${issues.length} issue(s) project=${projectLabel}`);
+      } else if (res.statusCode === 404 || res.statusCode === 410) {
+        log.warn("beads", `session dead (status=${res.statusCode}) \u2014 stopping watcher`);
+        this.stopped = true;
+      } else {
+        log.warn("beads", `ingest failed status=${res.statusCode} body=${res.body.slice(0, 200)}`);
+      }
+    } catch (err) {
+      log.warn("beads", "ingest POST error", err);
+    }
+  }
+  headers() {
+    return {
+      "Content-Type": "application/json",
+      "X-Codeam-Protocol-Version": "2.0.0",
+      "X-Plugin-Auth-Token": this.opts.pluginAuthToken
+    };
+  }
+};
+
+// src/beads/apply-actions.ts
+function buildBdArgs(action) {
+  switch (action.kind) {
+    case "claim": {
+      if (!action.issueId) return null;
+      const args2 = ["update", action.issueId, "--claim"];
+      if (action.owner) args2.push("--owner", action.owner);
+      return args2;
+    }
+    case "close": {
+      if (!action.issueId) return null;
+      const args2 = ["close", action.issueId];
+      if (action.reason) args2.push("--reason", action.reason);
+      return args2;
+    }
+    case "create": {
+      const title = action.text?.trim();
+      if (!title) return null;
+      return ["create", title];
+    }
+    case "remember": {
+      const body = action.text?.trim();
+      if (!body) return null;
+      return ["remember", body];
+    }
+    default:
+      return null;
+  }
+}
+async function applyBeadsAction(action, deps) {
+  const args2 = buildBdArgs(action);
+  if (!args2) {
+    log.warn("beads", `malformed beads action: kind=${action.kind}`);
+    return { ok: false, action: action.kind, code: -1, error: "malformed action" };
+  }
+  if (!deps.adapter.isAvailable()) {
+    return { ok: false, action: action.kind, code: -1, error: "bd unavailable" };
+  }
+  const res = await deps.adapter.run(args2);
+  if (res.code !== 0) {
+    log.warn("beads", `bd ${args2.join(" ")} failed (code=${res.code}): ${res.stderr.slice(0, 200)}`);
+    return { ok: false, action: action.kind, code: res.code, error: res.stderr };
+  }
+  log.info("beads", `applied action ${action.kind}${action.issueId ? ` (${action.issueId})` : ""}`);
+  try {
+    await deps.onApplied();
+  } catch (err) {
+    log.warn("beads", "post-action push failed (state still applied locally)", err);
+  }
+  return { ok: true, action: action.kind, code: 0 };
+}
+
+// src/beads/index.ts
+async function startBeads(opts) {
+  const adapter = new BdAdapter({ cwd: opts.cwd });
+  const provision = await provisionBeads({ cwd: opts.cwd, adapter, agents: opts.agents });
+  if (!provision.bdAvailable || !provision.initialized) {
+    log.warn("beads", "home brain not provisioned \u2014 watcher not started this run");
+    return null;
+  }
+  const watcher = new BeadsWatcher({
+    sessionId: opts.sessionId,
+    pluginId: opts.pluginId,
+    pluginAuthToken: opts.pluginAuthToken,
+    cwd: opts.cwd,
+    adapter
+  });
+  watcher.start();
+  void watcher.syncNow();
+  return { watcher, adapter };
+}
+async function handleBeadsActionCommand(action, started) {
+  await applyBeadsAction(action, {
+    adapter: started.adapter,
+    onApplied: () => started.watcher.syncNow()
+  });
+}
+
+// src/beads/wiring.ts
+function beadsKilled() {
+  const v = process.env.CODEAM_BEADS_DISABLED;
+  return !!v && v !== "0" && v.toLowerCase() !== "false";
+}
+async function provisionBeadsForStart(ctx) {
+  if (beadsKilled()) {
+    log.trace("beads", "CODEAM_BEADS_DISABLED set \u2014 beads off this run");
+    return null;
+  }
+  if (!ctx.pluginAuthToken) {
+    log.trace("beads", "no pluginAuthToken \u2014 beads off");
+    return null;
+  }
+  const pluginAuthToken = ctx.pluginAuthToken;
+  let started = null;
+  try {
+    started = await startBeads({
+      sessionId: ctx.sessionId,
+      pluginId: ctx.pluginId,
+      pluginAuthToken,
+      cwd: ctx.cwd,
+      agents: ctx.agents
+    });
+  } catch (err) {
+    log.warn("beads", "provisionBeadsForStart failed (non-fatal)", err);
+    started = null;
+  }
+  const { projectKey } = deriveProjectIdentity(ctx.cwd);
+  void postBeadsProvisioning({
+    sessionId: ctx.sessionId,
+    pluginId: ctx.pluginId,
+    pluginAuthToken,
+    status: started ? "ready" : "failed",
+    projectKey
+  }).then((res) => {
+    if (!res.ok) {
+      log.trace("beads", `provisioning signal POST non-ok (status=${res.status}) \u2014 ignoring`);
+    }
+  });
+  return started;
+}
+var ACTION_KINDS = /* @__PURE__ */ new Set([
+  "claim",
+  "close",
+  "create",
+  "remember"
+]);
+function isBeadsActionKind(v) {
+  return typeof v === "string" && ACTION_KINDS.has(v);
+}
+function strOrUndefined(v) {
+  return typeof v === "string" ? v : void 0;
+}
+function beadsActionFromPayload(payload) {
+  const { action, args: args2 } = payload;
+  if (!isBeadsActionKind(action)) return null;
+  const a = args2 && typeof args2 === "object" ? args2 : {};
+  return {
+    kind: action,
+    issueId: strOrUndefined(a.issueId),
+    text: strOrUndefined(a.text),
+    reason: strOrUndefined(a.reason),
+    owner: strOrUndefined(a.owner),
+    projectKey: strOrUndefined(a.projectKey)
+  };
+}
+
+// src/commands/start/handlers.ts
+var pendingAttachmentFiles = /* @__PURE__ */ new Set();
+function cleanupAttachmentTempFiles() {
+  for (const p2 of pendingAttachmentFiles) {
+    try {
+      fs32.unlinkSync(p2);
+    } catch {
+    }
+  }
+  pendingAttachmentFiles.clear();
+}
+function saveFilesTemp(files) {
+  return files.filter(({ base64 }) => base64 && base64.length > 0).map(({ filename, base64 }) => {
+    const safeName = filename.replace(/[^a-zA-Z0-9._-]/g, "_").slice(0, 80);
+    const tmpPath = path39.join(os25.tmpdir(), `codeam-${(0, import_crypto3.randomUUID)()}-${safeName}`);
+    fs32.writeFileSync(tmpPath, Buffer.from(base64, "base64"));
+    pendingAttachmentFiles.add(tmpPath);
+    return tmpPath;
+  });
+}
+function dispatchPrompt(ctx, prompt) {
+  ctx.outputSvc.newTurn();
+  ctx.agent.sendCommand(prompt);
+}
+var startTask = (ctx, _cmd, parsed) => {
+  const { prompt, files } = parsed;
+  const effectivePrompt = prompt ?? "";
+  if (files && files.length > 0) {
+    const paths = saveFilesTemp(files);
+    const atRefs = paths.map((p2) => `@${p2}`).join(" ");
+    ctx.outputSvc.newTurn();
+    ctx.agent.sendCommand(`${atRefs} ${effectivePrompt}`.trim());
+    setTimeout(() => {
+      for (const p2 of paths) {
+        try {
+          fs32.unlinkSync(p2);
+        } catch {
+        }
+        pendingAttachmentFiles.delete(p2);
+      }
+    }, 12e4);
+  } else if (effectivePrompt) {
+    dispatchPrompt(ctx, effectivePrompt);
+  }
+};
+var provideInput = (ctx, _cmd, parsed) => {
+  if (parsed.input) dispatchPrompt(ctx, parsed.input);
+};
+var selectOption = (ctx, _cmd, parsed) => {
+  const index = parsed.index ?? 0;
+  const from = parsed.from ?? 0;
+  ctx.outputSvc.newTurn();
+  ctx.agent.selectOption(index, from);
+};
+var escapeKey = (ctx) => {
+  ctx.outputSvc.newTurn();
+  ctx.agent.sendEscape();
+};
+var stopTask = (ctx) => {
+  ctx.agent.interrupt();
+};
+var resumeSession = async (ctx, _cmd, parsed) => {
+  const { id, auto } = parsed;
+  if (!id) return;
+  ctx.historySvc.setCurrentConversationId(id);
+  await ctx.historySvc.loadConversation(id);
+  await ctx.outputSvc.newTurnResume(id);
+  ctx.agent.restart(id, auto ?? false);
+};
+var getContext = async (ctx, cmd) => {
+  const usage = ctx.historySvc.getCurrentUsage();
+  const monthlyCost = ctx.historySvc.getMonthlyEstimatedCost();
+  const rateLimitReset = ctx.historySvc.getRateLimitReset();
+  const quotaPercent = ctx.historySvc.getQuotaPercent();
+  const base = usage ? { ...usage, monthlyCost } : { used: 0, total: 2e5, percent: 0, model: null, outputTokens: 0, cacheReadTokens: 0, monthlyCost, error: "No usage data found" };
+  const result = {
+    ...base,
+    ...rateLimitReset ? { rateLimitReset } : {},
+    ...quotaPercent !== null ? { quotaPercent } : {}
+  };
+  await ctx.relay.sendResult(cmd.id, "completed", result);
+};
+var getConversation = async (ctx, cmd) => {
+  let currentId = ctx.historySvc.getCurrentConversationId();
+  if (!currentId) {
+    ctx.historySvc.detectCurrentConversation();
+    currentId = ctx.historySvc.getCurrentConversationId();
+  }
+  if (!currentId) {
+    await ctx.relay.sendResult(cmd.id, "completed", { conversationId: null });
+    return;
+  }
+  try {
+    await ctx.historySvc.loadConversation(currentId);
+    await ctx.relay.sendResult(cmd.id, "completed", { conversationId: currentId });
+  } catch {
+    await ctx.relay.sendResult(cmd.id, "failed", {});
+  }
+};
+var listModels = async (ctx, cmd) => {
+  const models = await ctx.runtime.listModels();
+  await ctx.relay.sendResult(cmd.id, "completed", { models });
+};
+var changeModel = async (ctx, cmd) => {
+  const params = cmd.payload;
+  if (typeof params.modelId !== "string" || !params.modelId) {
+    await ctx.relay.sendResult(cmd.id, "failed", { error: "modelId required" });
+    return;
+  }
+  const instr = ctx.runtime.changeModelInstruction(params.modelId);
+  if (instr.type === "pty") {
+    if (!instr.ptyInput) {
+      await ctx.relay.sendResult(cmd.id, "failed", { error: "no pty input for this agent" });
+      return;
+    }
+    ctx.agent.sendRawPtyInput(instr.ptyInput);
+  } else if (instr.type === "restart") {
+    await ctx.relay.sendResult(cmd.id, "failed", { error: "restart-mode change_model not supported in Phase 1" });
+    return;
+  }
+  await ctx.relay.sendResult(cmd.id, "completed", {});
+};
+var summarize = async (ctx, cmd) => {
+  const params = cmd.payload;
+  const mode = params.mode === "auto" ? "auto" : "normal";
+  const instr = ctx.runtime.summarizeInstruction(mode);
+  ctx.agent.sendRawPtyInput(instr.ptyInput);
+  await ctx.relay.sendResult(cmd.id, "completed", {});
+};
+var setKeepAlive = async (ctx, cmd) => {
+  const enabled = !!cmd.payload.enabled;
+  ctx.setKeepAlive(enabled);
+  try {
+    await ctx.relay.sendResult(
+      cmd.id,
+      "success",
+      {
+        enabled,
+        applied: enabled && ctx.keepAliveCtx.inCodespace,
+        runtime: ctx.keepAliveCtx.inCodespace ? "github-codespaces" : "local"
+      }
+    );
+  } catch {
+  }
+};
+var sessionTerminated = async (ctx, cmd) => {
+  showInfo("Session was deleted from the app \u2014 exiting.");
+  try {
+    await ctx.relay.sendResult(cmd.id, "success", { ok: true });
+  } catch {
+  }
+  try {
+    removeSession(ctx.sessionId);
+  } catch {
+  }
+  try {
+    ctx.agent.kill();
+  } catch {
+  }
+  try {
+    const proc = (0, import_child_process15.spawn)("bash", ["-lc", "pm2 delete codeam-pair >/dev/null 2>&1 || true"], {
       detached: true,
       stdio: "ignore"
     });
@@ -17360,7 +18154,7 @@ var shutdownSession = async (ctx, cmd) => {
   }
   if (ctx.keepAliveCtx.inCodespace && ctx.keepAliveCtx.codespaceName) {
     try {
-      const stopProc = (0, import_child_process12.spawn)(
+      const stopProc = (0, import_child_process15.spawn)(
         "bash",
         ["-lc", `sleep 1; gh codespace stop -c ${JSON.stringify(ctx.keepAliveCtx.codespaceName)} >/dev/null 2>&1 || true`],
         { detached: true, stdio: "ignore" }
@@ -17370,7 +18164,7 @@ var shutdownSession = async (ctx, cmd) => {
     }
   }
   try {
-    const proc = (0, import_child_process12.spawn)("bash", ["-lc", "pm2 delete codeam-pair >/dev/null 2>&1 || true"], {
+    const proc = (0, import_child_process15.spawn)("bash", ["-lc", "pm2 delete codeam-pair >/dev/null 2>&1 || true"], {
       detached: true,
       stdio: "ignore"
     });
@@ -17786,8 +18580,8 @@ function normalizeDetectionForSpawn(detection, cwd) {
   if (args2.length === 0) return detection;
   const binName = args2[0];
   if (binName.startsWith("-")) return detection;
-  const binPath = path35.join(cwd, "node_modules", ".bin", binName);
-  if (!fs29.existsSync(binPath)) return detection;
+  const binPath = path39.join(cwd, "node_modules", ".bin", binName);
+  if (!fs32.existsSync(binPath)) return detection;
   return {
     ...detection,
     command: binPath,
@@ -17877,7 +18671,7 @@ var previewStartH = (ctx, _cmd, parsed) => {
       "BOOT_SEQUENCE",
       `${spawnable.command} ${spawnable.args.join(" ")}`
     );
-    const devServer = (0, import_child_process12.spawn)(spawnable.command, spawnable.args, {
+    const devServer = (0, import_child_process15.spawn)(spawnable.command, spawnable.args, {
       cwd: process.cwd(),
       env: { ...process.env, ...spawnable.env ?? {} },
       stdio: ["ignore", "pipe", "pipe"]
@@ -18003,7 +18797,7 @@ var previewStartH = (ctx, _cmd, parsed) => {
         });
         return;
       }
-      tunnel = (0, import_child_process12.spawn)(bin, ["tunnel", "--url", `http://localhost:${detection.port}`], {
+      tunnel = (0, import_child_process15.spawn)(bin, ["tunnel", "--url", `http://localhost:${detection.port}`], {
         stdio: ["ignore", "pipe", "pipe"]
       });
       let parsedUrl = null;
@@ -18100,8 +18894,8 @@ var previewStopH = (ctx) => {
   })();
 };
 function runOnce(cmd, args2, cwd, env) {
-  return new Promise((resolve6) => {
-    const child = (0, import_child_process12.spawn)(cmd, args2, {
+  return new Promise((resolve7) => {
+    const child = (0, import_child_process15.spawn)(cmd, args2, {
       cwd,
       env: { ...process.env, ...env ?? {} },
       stdio: ["ignore", "pipe", "pipe"]
@@ -18114,8 +18908,8 @@ function runOnce(cmd, args2, cwd, env) {
     };
     child.stdout?.on("data", onChunk);
     child.stderr?.on("data", onChunk);
-    child.once("exit", (code) => resolve6(code));
-    child.once("error", () => resolve6(-1));
+    child.once("exit", (code) => resolve7(code));
+    child.once("error", () => resolve7(-1));
   });
 }
 var savePreviewConfigH = (_ctx, _cmd, parsed) => {
@@ -18169,6 +18963,23 @@ var handlers = {
   save_preview_config: savePreviewConfigH
 };
 async function dispatchCommand(ctx, cmd) {
+  if (cmd.type === "beads_action") {
+    if (!ctx.beads) {
+      log.trace("beads", "beads_action received but beads not running this session \u2014 dropping");
+      return;
+    }
+    const action = beadsActionFromPayload(cmd.payload);
+    if (!action) {
+      log.warn("beads", "malformed beads_action payload \u2014 dropping");
+      return;
+    }
+    try {
+      await handleBeadsActionCommand(action, ctx.beads);
+    } catch (err) {
+      log.warn("beads", "handleBeadsActionCommand failed (non-fatal)", err);
+    }
+    return;
+  }
   const parsed = parsePayload2(startCommandSchema, cmd.payload);
   if (!parsed) {
     showInfo(`Ignoring malformed ${cmd.type} payload.`);
@@ -18180,10 +18991,10 @@ async function dispatchCommand(ctx, cmd) {
 }
 
 // src/services/file-watcher.service.ts
-var import_child_process13 = require("child_process");
-var fs30 = __toESM(require("fs"));
-var os25 = __toESM(require("os"));
-var path36 = __toESM(require("path"));
+var import_child_process16 = require("child_process");
+var fs33 = __toESM(require("fs"));
+var os26 = __toESM(require("os"));
+var path40 = __toESM(require("path"));
 var import_ignore = __toESM(require("ignore"));
 
 // src/services/file-watcher/diff-parser.ts
@@ -18272,58 +19083,9 @@ function isIgnoredFilePath(filePath) {
   return IGNORED_PATH_PATTERN.test(filePath);
 }
 
-// src/services/file-watcher/transport.ts
-var http5 = __toESM(require("http"));
-var https5 = __toESM(require("https"));
-var _transport3 = {
-  post: _post2
-};
-function _post2(url, headers, payload) {
-  return new Promise((resolve6, reject) => {
-    let settled = false;
-    const u2 = new URL(url);
-    const lib = u2.protocol === "https:" ? https5 : http5;
-    const req = lib.request(
-      {
-        hostname: u2.hostname,
-        port: u2.port || (u2.protocol === "https:" ? 443 : 80),
-        path: u2.pathname + u2.search,
-        method: "POST",
-        headers: {
-          ...headers,
-          ...vercelBypassHeader(),
-          "Content-Length": Buffer.byteLength(payload)
-        },
-        timeout: 8e3
-      },
-      (res) => {
-        let body = "";
-        res.on("data", (c2) => {
-          body += c2.toString();
-        });
-        res.on("end", () => {
-          if (settled) return;
-          settled = true;
-          resolve6({ statusCode: res.statusCode ?? 0, body });
-        });
-      }
-    );
-    req.on("error", (err) => {
-      if (settled) return;
-      settled = true;
-      reject(err);
-    });
-    req.on("timeout", () => {
-      req.destroy();
-    });
-    req.write(payload);
-    req.end();
-  });
-}
-
 // src/services/file-watcher.service.ts
-var API_BASE4 = resolveApiBaseUrl();
-var DEBOUNCE_MS = 250;
+var API_BASE5 = resolveApiBaseUrl();
+var DEBOUNCE_MS2 = 250;
 var COALESCE_WINDOW_MS = 250;
 var COALESCE_MAX_HOLD_MS = 2e3;
 var MAX_RETRIES = 2;
@@ -18342,10 +19104,10 @@ var WINDOWS_LEGACY_JUNCTIONS = [
   /[\\/]Start Menu([\\/]|$)/i,
   /[\\/]Templates([\\/]|$)/i
 ];
-function isUnsafeWindowsWatchRoot(dir, homedir21) {
+function isUnsafeWindowsWatchRoot(dir, homedir22) {
   const norm = (p2) => p2.replace(/\//g, "\\").replace(/\\+$/, "").toLowerCase();
   const cwd = norm(dir);
-  const home = norm(homedir21);
+  const home = norm(homedir22);
   if (cwd === home) return true;
   if (/^[a-z]:$/.test(cwd)) return true;
   const sysRoots = [
@@ -18359,7 +19121,7 @@ function isUnsafeWindowsWatchRoot(dir, homedir21) {
   }
   return false;
 }
-var _chokidarSeam = {
+var _chokidarSeam2 = {
   load: () => {
     try {
       return require("chokidar");
@@ -18375,18 +19137,18 @@ var _findGitRootSeam = {
   resolve: _defaultFindGitRoot
 };
 function _defaultFindGitRoot(startDir) {
-  let dir = path36.resolve(startDir);
+  let dir = path40.resolve(startDir);
   const seen = /* @__PURE__ */ new Set();
   for (let i = 0; i < 256; i++) {
     if (seen.has(dir)) return null;
     seen.add(dir);
     try {
-      const gitPath = path36.join(dir, ".git");
-      const stat3 = fs30.statSync(gitPath, { throwIfNoEntry: false });
+      const gitPath = path40.join(dir, ".git");
+      const stat3 = fs33.statSync(gitPath, { throwIfNoEntry: false });
       if (stat3 && (stat3.isDirectory() || stat3.isFile())) return dir;
     } catch {
     }
-    const parent = path36.dirname(dir);
+    const parent = path40.dirname(dir);
     if (parent === dir) return null;
     dir = parent;
   }
@@ -18395,7 +19157,7 @@ function _defaultFindGitRoot(startDir) {
 var FileWatcherService = class {
   constructor(opts) {
     this.opts = opts;
-    this.apiBase = opts.apiBaseUrl ?? API_BASE4;
+    this.apiBase = opts.apiBaseUrl ?? API_BASE5;
   }
   opts;
   watcher = null;
@@ -18444,14 +19206,14 @@ var FileWatcherService = class {
       throw new Error("FileWatcherService has already been stopped \u2014 re-instantiate to restart.");
     }
     const isWin = process.platform === "win32";
-    if (isWin && isUnsafeWindowsWatchRoot(this.opts.workingDir, os25.homedir())) {
+    if (isWin && isUnsafeWindowsWatchRoot(this.opts.workingDir, os26.homedir())) {
       log.warn(
         "fileWatcher",
         `refusing to watch ${this.opts.workingDir} \u2014 looks like a Windows user-profile or system path. Run codeam from your project folder to enable file change emission.`
       );
       return;
     }
-    const chokidar2 = _chokidarSeam.load();
+    const chokidar2 = _chokidarSeam2.load();
     if (!chokidar2) {
       log.warn(
         "fileWatcher",
@@ -18570,7 +19332,7 @@ var FileWatcherService = class {
     const timer = setTimeout(() => {
       this.pending.delete(absPath);
       this.enqueueForCoalesce(absPath, changeType);
-    }, DEBOUNCE_MS);
+    }, DEBOUNCE_MS2);
     this.pending.set(absPath, {
       lastEventAt: Date.now(),
       timer,
@@ -18631,7 +19393,7 @@ var FileWatcherService = class {
   }
   async emitForFile(absPath, changeType) {
     if (this.stopped) return;
-    const fileDir = path36.dirname(absPath);
+    const fileDir = path40.dirname(absPath);
     let gitRoot = this.gitRootByDir.get(fileDir);
     if (gitRoot === void 0) {
       gitRoot = findGitRoot2(fileDir);
@@ -18644,19 +19406,19 @@ var FileWatcherService = class {
       );
       return;
     }
-    const relPathInRepo = path36.relative(gitRoot, absPath);
+    const relPathInRepo = path40.relative(gitRoot, absPath);
     if (!relPathInRepo || relPathInRepo.startsWith("..")) return;
     const matcher = this.getGitIgnoreMatcher(gitRoot);
     if (matcher && matcher.ignores(relPathInRepo)) {
       log.trace(
         "fileWatcher",
-        `${relPathInRepo} ignored by ${path36.basename(gitRoot)}/.gitignore \u2014 suppressing emit`
+        `${relPathInRepo} ignored by ${path40.basename(gitRoot)}/.gitignore \u2014 suppressing emit`
       );
       return;
     }
     this.opts.onRepoDirty?.(gitRoot);
-    const repoPath = path36.relative(this.opts.workingDir, gitRoot);
-    const repoName = path36.basename(gitRoot);
+    const repoPath = path40.relative(this.opts.workingDir, gitRoot);
+    const repoName = path40.basename(gitRoot);
     let diffText = "";
     let fileStatus = "modified";
     if (changeType === "unlink") {
@@ -18831,7 +19593,7 @@ var FileWatcherService = class {
   collectGitignoreFiles(repoRoot, dir, matcher) {
     let entries;
     try {
-      entries = fs30.readdirSync(dir, { withFileTypes: true });
+      entries = fs33.readdirSync(dir, { withFileTypes: true });
     } catch {
       return;
     }
@@ -18840,16 +19602,16 @@ var FileWatcherService = class {
     );
     if (gitignoreEntry) {
       try {
-        const body = fs30.readFileSync(path36.join(dir, ".gitignore"), "utf8");
-        const rel = path36.relative(repoRoot, dir).replace(/\\/g, "/");
+        const body = fs33.readFileSync(path40.join(dir, ".gitignore"), "utf8");
+        const rel = path40.relative(repoRoot, dir).replace(/\\/g, "/");
         const prefixed = body.split(/\r?\n/).map((line) => {
           const trimmed = line.trim();
           if (!trimmed || trimmed.startsWith("#")) return line;
           if (!rel) return line;
           if (trimmed.startsWith("!")) {
-            return "!" + path36.posix.join(rel, trimmed.slice(1));
+            return "!" + path40.posix.join(rel, trimmed.slice(1));
           }
-          return path36.posix.join(rel, trimmed);
+          return path40.posix.join(rel, trimmed);
         }).join("\n");
         matcher.add(prefixed);
       } catch {
@@ -18858,7 +19620,7 @@ var FileWatcherService = class {
     for (const entry of entries) {
       if (!entry.isDirectory()) continue;
       if (entry.name === ".git") continue;
-      const childAbs = path36.join(dir, entry.name);
+      const childAbs = path40.join(dir, entry.name);
       if (isIgnoredFilePath(childAbs)) continue;
       this.collectGitignoreFiles(repoRoot, childAbs, matcher);
     }
@@ -18992,12 +19754,12 @@ var _gitSeam = {
   run: _runGitImpl
 };
 async function _runGitImpl(cwd, args2, opts = {}) {
-  return new Promise((resolve6) => {
+  return new Promise((resolve7) => {
     let proc;
     try {
-      proc = (0, import_child_process13.spawn)("git", args2, { cwd, env: process.env });
+      proc = (0, import_child_process16.spawn)("git", args2, { cwd, env: process.env });
     } catch {
-      resolve6(null);
+      resolve7(null);
       return;
     }
     let stdout = "";
@@ -19008,13 +19770,13 @@ async function _runGitImpl(cwd, args2, opts = {}) {
     proc.stderr?.on("data", (c2) => {
       stderr += c2.toString();
     });
-    proc.on("error", () => resolve6(null));
+    proc.on("error", () => resolve7(null));
     proc.on("close", (code) => {
       if (code === 0 || opts.allowNonZeroExit) {
-        resolve6(stdout);
+        resolve7(stdout);
       } else {
         log.trace("fileWatcher", `git ${args2.join(" ")} exited ${code} stderr=${stderr.slice(0, 200)}`);
-        resolve6(null);
+        resolve7(null);
       }
     });
   });
@@ -19027,8 +19789,8 @@ function _runGit(cwd, args2, opts = {}) {
 var import_crypto4 = require("crypto");
 
 // src/services/turn-files/git-changeset.ts
-var import_child_process14 = require("child_process");
-var path37 = __toESM(require("path"));
+var import_child_process17 = require("child_process");
+var path41 = __toESM(require("path"));
 async function collectRepoChangeset(opts) {
   const status2 = await runGit3(opts.repoRoot, ["status", "--porcelain=v1", "-z"]);
   if (status2 === null) return null;
@@ -19108,12 +19870,12 @@ function runGit3(cwd, args2) {
   return _runGitImpl2.run(cwd, args2);
 }
 function defaultRunGit(cwd, args2) {
-  return new Promise((resolve6) => {
+  return new Promise((resolve7) => {
     let proc;
     try {
-      proc = (0, import_child_process14.spawn)("git", args2, { cwd, env: process.env });
+      proc = (0, import_child_process17.spawn)("git", args2, { cwd, env: process.env });
     } catch {
-      resolve6(null);
+      resolve7(null);
       return;
     }
     let stdout = "";
@@ -19124,22 +19886,22 @@ function defaultRunGit(cwd, args2) {
     proc.stderr?.on("data", (c2) => {
       stderr += c2.toString();
     });
-    proc.on("error", () => resolve6(null));
+    proc.on("error", () => resolve7(null));
     proc.on("close", (code) => {
       if (code === 0) {
-        resolve6(stdout);
+        resolve7(stdout);
       } else {
         log.trace(
           "turnFiles",
           `git ${args2.join(" ")} exited ${code} stderr=${stderr.slice(0, 200)}`
         );
-        resolve6(null);
+        resolve7(null);
       }
     });
   });
 }
 async function discoverRepos(workingDir, maxDepth = 4) {
-  const fs36 = await import("fs/promises");
+  const fs39 = await import("fs/promises");
   const out2 = [];
   await walk(workingDir, 0);
   return out2;
@@ -19147,7 +19909,7 @@ async function discoverRepos(workingDir, maxDepth = 4) {
     if (depth > maxDepth) return;
     let entries = [];
     try {
-      const dirents = await fs36.readdir(dir, { withFileTypes: true });
+      const dirents = await fs39.readdir(dir, { withFileTypes: true });
       entries = dirents.filter((d3) => !d3.name.startsWith(".") || d3.name === ".git").map((d3) => ({ name: d3.name, isDirectory: d3.isDirectory() }));
     } catch {
       return;
@@ -19158,8 +19920,8 @@ async function discoverRepos(workingDir, maxDepth = 4) {
     if (hasGit) {
       out2.push({
         repoRoot: dir,
-        repoPath: path37.relative(workingDir, dir),
-        repoName: path37.basename(dir)
+        repoPath: path41.relative(workingDir, dir),
+        repoName: path41.basename(dir)
       });
       return;
     }
@@ -19167,14 +19929,14 @@ async function discoverRepos(workingDir, maxDepth = 4) {
       if (!entry.isDirectory) continue;
       if (entry.name === "node_modules") continue;
       if (entry.name === "dist" || entry.name === "build") continue;
-      await walk(path37.join(dir, entry.name), depth + 1);
+      await walk(path41.join(dir, entry.name), depth + 1);
     }
   }
 }
 
 // src/services/turn-files/files-outbox.ts
-var fs31 = __toESM(require("fs/promises"));
-var path38 = __toESM(require("path"));
+var fs34 = __toESM(require("fs/promises"));
+var path42 = __toESM(require("path"));
 var import_os7 = require("os");
 var HOME_OUTBOX_DIR = ".codeam/outbox";
 var MAX_AGE_MS = 24 * 60 * 60 * 1e3;
@@ -19207,16 +19969,16 @@ var FilesOutbox = class {
   backoffIndex = 0;
   stopped = false;
   constructor(opts) {
-    const base = opts.baseDir ?? path38.join(homeDir(), HOME_OUTBOX_DIR);
-    this.filePath = path38.join(base, `${opts.sessionId}.jsonl`);
+    const base = opts.baseDir ?? path42.join(homeDir(), HOME_OUTBOX_DIR);
+    this.filePath = path42.join(base, `${opts.sessionId}.jsonl`);
     this.post = opts.post;
     this.autoSchedule = opts.autoSchedule !== false;
   }
   /** Persist the entry to disk and trigger a flush. Returns once the
    *  line is durable on disk (not once the POST succeeds). */
   async enqueue(entry) {
-    await fs31.mkdir(path38.dirname(this.filePath), { recursive: true });
-    await fs31.appendFile(this.filePath, JSON.stringify(entry) + "\n", "utf8");
+    await fs34.mkdir(path42.dirname(this.filePath), { recursive: true });
+    await fs34.appendFile(this.filePath, JSON.stringify(entry) + "\n", "utf8");
     this.backoffIndex = 0;
     if (this.autoSchedule) this.scheduleFlush(0);
   }
@@ -19305,7 +20067,7 @@ var FilesOutbox = class {
   async readAll() {
     let raw = "";
     try {
-      raw = await fs31.readFile(this.filePath, "utf8");
+      raw = await fs34.readFile(this.filePath, "utf8");
     } catch {
       return [];
     }
@@ -19329,12 +20091,12 @@ var FilesOutbox = class {
   async rewrite(entries) {
     const tmpPath = `${this.filePath}.${process.pid}.tmp`;
     if (entries.length === 0) {
-      await fs31.unlink(this.filePath).catch(() => void 0);
+      await fs34.unlink(this.filePath).catch(() => void 0);
       return;
     }
     const payload = entries.map((e) => JSON.stringify(e)).join("\n") + "\n";
-    await fs31.writeFile(tmpPath, payload, "utf8");
-    await fs31.rename(tmpPath, this.filePath);
+    await fs34.writeFile(tmpPath, payload, "utf8");
+    await fs34.rename(tmpPath, this.filePath);
   }
 };
 function applyJitter(ms) {
@@ -19346,13 +20108,13 @@ function homeDir() {
 }
 
 // src/services/turn-files/turn-file-aggregator.ts
-var API_BASE5 = resolveApiBaseUrl();
+var API_BASE6 = resolveApiBaseUrl();
 var ENDPOINT = "/api/files/batch";
 var MAX_BATCH_SIZE = 1e3;
 var TurnFileAggregator = class {
   constructor(opts) {
     this.opts = opts;
-    this.apiBase = opts.apiBaseUrl ?? API_BASE5;
+    this.apiBase = opts.apiBaseUrl ?? API_BASE6;
     this.outbox = new FilesOutbox({
       sessionId: opts.sessionId,
       baseDir: opts.outboxDir,
@@ -19544,7 +20306,7 @@ var StreamingState = class {
    * default-reject. Caller is the SDK's `onRequestPermission`.
    */
   registerPermission(args2) {
-    return new Promise((resolve6) => {
+    return new Promise((resolve7) => {
       const timeoutTimer = setTimeout(() => {
         if (this.pending?.kind === "permission" && this.pending.questionId === args2.questionId) {
           log.warn(
@@ -19552,7 +20314,7 @@ var StreamingState = class {
             `permission ${args2.questionId.slice(0, 8)} TTL expired \u2014 auto-cancel`
           );
           this.pending = null;
-          resolve6({ outcome: { outcome: "cancelled" } });
+          resolve7({ outcome: { outcome: "cancelled" } });
         }
       }, PERMISSION_TIMEOUT_MS);
       this.pending = {
@@ -19560,7 +20322,7 @@ var StreamingState = class {
         questionId: args2.questionId,
         labels: args2.labels,
         optionIdByLabel: args2.optionIdByLabel,
-        resolve: resolve6,
+        resolve: resolve7,
         timeoutTimer
       };
     });
@@ -19592,14 +20354,14 @@ var StreamingState = class {
       const label = this.pending.labels[index];
       const optionId = label ? this.pending.optionIdByLabel[label] : void 0;
       clearTimeout(this.pending.timeoutTimer);
-      const resolve6 = this.pending.resolve;
+      const resolve7 = this.pending.resolve;
       this.pending = null;
       if (!optionId) {
         log.warn("acpRunner", `select_option index=${index} out of bounds \u2014 cancel`);
-        resolve6({ outcome: { outcome: "cancelled" } });
+        resolve7({ outcome: { outcome: "cancelled" } });
         return { kind: "resolved" };
       }
-      resolve6({ outcome: { outcome: "selected", optionId } });
+      resolve7({ outcome: { outcome: "selected", optionId } });
       return { kind: "resolved" };
     }
     const text = this.pending.options[index];
@@ -19955,6 +20717,7 @@ async function runAcpSession(opts) {
   }).catch((err) => {
     log.warn("acpRunner", `fileWatcher.start failed: ${describeError(err)}`);
   });
+  const getBeads = opts.getBeads ?? (() => null);
   const relay = new CommandRelayService(
     opts.pluginId,
     async (cmd) => {
@@ -19968,7 +20731,8 @@ async function runAcpSession(opts) {
         opts,
         history,
         initialize.agentCapabilities,
-        turnFiles
+        turnFiles,
+        getBeads
       );
     },
     { id: opts.agent, name: opts.agent, displayName: opts.agent }
@@ -19989,8 +20753,24 @@ async function runAcpSession(opts) {
   await new Promise(() => {
   });
 }
-async function handleCommand(cmd, client2, relay, acpSessionId, models, streaming, opts, history, agentCaps, turnFiles) {
+async function handleCommand(cmd, client2, relay, acpSessionId, models, streaming, opts, history, agentCaps, turnFiles, getBeads) {
   switch (cmd.type) {
+    case "beads_action": {
+      const beads = getBeads();
+      const action = beadsActionFromPayload(cmd.payload);
+      if (!beads || !action) {
+        await relay.sendResult(cmd.id, "completed", { applied: false });
+        return;
+      }
+      try {
+        await handleBeadsActionCommand(action, beads);
+        await relay.sendResult(cmd.id, "completed", { applied: true });
+      } catch (err) {
+        log.warn("acpRunner", `beads_action failed (non-fatal): ${describeError(err)}`);
+        await relay.sendResult(cmd.id, "failed", { error: describeError(err) });
+      }
+      return;
+    }
     case "start_task": {
       const payload = cmd.payload;
       const blocks = buildAcpPromptBlocks(payload ?? {});
@@ -20349,11 +21129,11 @@ var ChromeStepTracker = class {
 // src/services/output/chunk-emitter.ts
 var https6 = __toESM(require("https"));
 var http6 = __toESM(require("http"));
-var API_BASE6 = resolveApiBaseUrl();
+var API_BASE7 = resolveApiBaseUrl();
 async function refreshAuthToken(sessionId, pluginId) {
   try {
     const { statusCode, body } = await _transport4.post(
-      `${API_BASE6}/api/pairing/reconnect`,
+      `${API_BASE7}/api/pairing/reconnect`,
       {
         "Content-Type": "application/json",
         "X-Codeam-Protocol-Version": PROTOCOL_VERSION,
@@ -20394,7 +21174,7 @@ var ChunkEmitter = class {
     }
   }
   opts;
-  url = `${API_BASE6}/api/commands/output`;
+  url = `${API_BASE7}/api/commands/output`;
   headers;
   /**
    * Send a chunk. `body` is the chunk fields minus `sessionId` /
@@ -20415,14 +21195,14 @@ var ChunkEmitter = class {
       "chunkEmitter",
       `send type=${body.type ?? "(clear)"} bytes=${payload.length} done=${body.done === true}`
     );
-    return new Promise((resolve6) => {
+    return new Promise((resolve7) => {
       const attempt = (attemptsLeft) => {
         _transport4.post(this.url, this.headers, payload).then(({ statusCode, body: resBody }) => {
           const tookMs = Date.now() - t0;
           if (statusCode === 410 || statusCode === 404 && /SESSION_NOT_FOUND|SESSION_GONE/.test(resBody)) {
             process.stderr.write("[codeam] session was deleted/disconnected \u2014 stopping output stream.\n");
             log.info("chunkEmitter", `dead status=${statusCode} took=${tookMs}ms`);
-            resolve6({ dead: true });
+            resolve7({ dead: true });
             return;
           }
           if (statusCode === 401) {
@@ -20438,7 +21218,7 @@ var ChunkEmitter = class {
                   return;
                 }
               }
-              resolve6({ dead: false });
+              resolve7({ dead: false });
             })();
             return;
           }
@@ -20449,7 +21229,7 @@ var ChunkEmitter = class {
           } else {
             log.info("chunkEmitter", `ok status=${statusCode} took=${tookMs}ms`);
           }
-          resolve6({ dead: false });
+          resolve7({ dead: false });
         }).catch((err) => {
           log.warn(
             "chunkEmitter",
@@ -20460,7 +21240,7 @@ var ChunkEmitter = class {
             const delay = 200 * (maxRetries - attemptsLeft + 1);
             setTimeout(() => attempt(attemptsLeft - 1), delay);
           } else {
-            resolve6({ dead: false });
+            resolve7({ dead: false });
           }
         });
       };
@@ -20472,7 +21252,7 @@ var _transport4 = {
   post: _post3
 };
 function _post3(url, headers, payload) {
-  return new Promise((resolve6, reject) => {
+  return new Promise((resolve7, reject) => {
     let settled = false;
     const u2 = new URL(url);
     const transport = u2.protocol === "https:" ? https6 : http6;
@@ -20496,7 +21276,7 @@ function _post3(url, headers, payload) {
         res.on("end", () => {
           if (settled) return;
           settled = true;
-          resolve6({ statusCode: res.statusCode ?? 0, body: resData });
+          resolve7({ statusCode: res.statusCode ?? 0, body: resData });
         });
       }
     );
@@ -21070,9 +21850,9 @@ var OutputService = class _OutputService {
 };
 
 // src/services/history.service.ts
-var fs32 = __toESM(require("fs"));
-var path39 = __toESM(require("path"));
-var os26 = __toESM(require("os"));
+var fs35 = __toESM(require("fs"));
+var path43 = __toESM(require("path"));
+var os27 = __toESM(require("os"));
 var https7 = __toESM(require("https"));
 var http7 = __toESM(require("http"));
 var import_zod2 = require("zod");
@@ -21086,7 +21866,7 @@ var historyRecordSchema = import_zod2.z.object({
     content: import_zod2.z.union([import_zod2.z.string(), import_zod2.z.array(import_zod2.z.unknown())]).optional()
   }).passthrough().optional()
 }).passthrough();
-var API_BASE7 = resolveApiBaseUrl();
+var API_BASE8 = resolveApiBaseUrl();
 function extractText3(content) {
   if (typeof content === "string") return content;
   if (Array.isArray(content)) {
@@ -21099,7 +21879,7 @@ function parseJsonl(filePath) {
   const messages = [];
   let raw;
   try {
-    raw = fs32.readFileSync(filePath, "utf8");
+    raw = fs35.readFileSync(filePath, "utf8");
   } catch (err) {
     if (err.code !== "ENOENT") {
       log.warn("history:parseJsonl", `read failed for ${filePath}`, err);
@@ -21136,9 +21916,9 @@ function parseJsonl(filePath) {
   return messages;
 }
 function post(endpoint, body) {
-  return new Promise((resolve6) => {
+  return new Promise((resolve7) => {
     const payload = JSON.stringify(body);
-    const u2 = new URL(`${API_BASE7}${endpoint}`);
+    const u2 = new URL(`${API_BASE8}${endpoint}`);
     const transport = u2.protocol === "https:" ? https7 : http7;
     const req = transport.request(
       {
@@ -21157,17 +21937,17 @@ function post(endpoint, body) {
         res.resume();
         const ok = res.statusCode !== void 0 && res.statusCode >= 200 && res.statusCode < 300;
         if (!ok) log.warn("history:post", `${endpoint} \u2192 HTTP ${res.statusCode}`);
-        resolve6(ok);
+        resolve7(ok);
       }
     );
     req.on("error", (err) => {
       log.warn("history:post", `${endpoint} network error`, err);
-      resolve6(false);
+      resolve7(false);
     });
     req.on("timeout", () => {
       log.warn("history:post", `${endpoint} timeout after 15s`);
       req.destroy();
-      resolve6(false);
+      resolve7(false);
     });
     req.write(payload);
     req.end();
@@ -21234,7 +22014,7 @@ var HistoryService = class _HistoryService {
     return this._quotaPercent === null || Date.now() - this._quotaFetchedAt > ttlMs;
   }
   get projectDir() {
-    return this.runtime.resolveHistoryDir(this.cwd) ?? path39.join(os26.homedir(), ".claude", "projects", encodeCwd(this.cwd));
+    return this.runtime.resolveHistoryDir(this.cwd) ?? path43.join(os27.homedir(), ".claude", "projects", encodeCwd(this.cwd));
   }
   /** Set the current Claude conversation ID (extracted from /cost command or session start) */
   setCurrentConversationId(id) {
@@ -21246,7 +22026,7 @@ var HistoryService = class _HistoryService {
   /** Return the current message count in the active conversation. */
   getCurrentMessageCount() {
     if (!this.currentConversationId) return 0;
-    const filePath = path39.join(this.projectDir, `${this.currentConversationId}.jsonl`);
+    const filePath = path43.join(this.projectDir, `${this.currentConversationId}.jsonl`);
     return parseJsonl(filePath).length;
   }
   /**
@@ -21257,7 +22037,7 @@ var HistoryService = class _HistoryService {
     const deadline = Date.now() + timeoutMs;
     while (Date.now() < deadline) {
       if (!this.currentConversationId) return null;
-      const filePath = path39.join(this.projectDir, `${this.currentConversationId}.jsonl`);
+      const filePath = path43.join(this.projectDir, `${this.currentConversationId}.jsonl`);
       const messages = parseJsonl(filePath);
       if (messages.length > previousCount) {
         for (let i = messages.length - 1; i >= previousCount; i--) {
@@ -21283,16 +22063,16 @@ var HistoryService = class _HistoryService {
     const dir = this.projectDir;
     const cutoff = this.bootTimeMs - _HistoryService.BIRTHTIME_GRACE_MS;
     try {
-      const files = fs32.readdirSync(dir, { withFileTypes: true }).filter((e) => e.isFile() && e.name.endsWith(".jsonl")).map((e) => {
+      const files = fs35.readdirSync(dir, { withFileTypes: true }).filter((e) => e.isFile() && e.name.endsWith(".jsonl")).map((e) => {
         try {
-          const stat3 = fs32.statSync(path39.join(dir, e.name));
+          const stat3 = fs35.statSync(path43.join(dir, e.name));
           return { name: e.name, mtime: stat3.mtimeMs, birthtime: stat3.birthtimeMs };
         } catch {
           return { name: e.name, mtime: 0, birthtime: 0 };
         }
       }).filter((f) => f.birthtime >= cutoff).sort((a, b) => b.mtime - a.mtime);
       if (files.length > 0) {
-        this.currentConversationId = path39.basename(files[0].name, ".jsonl");
+        this.currentConversationId = path43.basename(files[0].name, ".jsonl");
       }
     } catch {
     }
@@ -21326,13 +22106,13 @@ var HistoryService = class _HistoryService {
     const cutoff = this.bootTimeMs - _HistoryService.BIRTHTIME_GRACE_MS;
     let entries;
     try {
-      entries = fs32.readdirSync(dir, { withFileTypes: true });
+      entries = fs35.readdirSync(dir, { withFileTypes: true });
     } catch {
       return null;
     }
     const files = entries.filter((e) => e.isFile() && e.name.endsWith(".jsonl")).map((e) => {
       try {
-        const stat3 = fs32.statSync(path39.join(dir, e.name));
+        const stat3 = fs35.statSync(path43.join(dir, e.name));
         return { name: e.name, mtime: stat3.mtimeMs, birthtime: stat3.birthtimeMs };
       } catch {
         return { name: e.name, mtime: 0, birthtime: 0 };
@@ -21341,12 +22121,12 @@ var HistoryService = class _HistoryService {
     if (files.length === 0) return null;
     const targetFile = this.currentConversationId ? `${this.currentConversationId}.jsonl` : files[0].name;
     if (!files.some((f) => f.name === targetFile)) return null;
-    return this.extractUsageFromFile(path39.join(dir, targetFile));
+    return this.extractUsageFromFile(path43.join(dir, targetFile));
   }
   extractUsageFromFile(filePath) {
     let raw;
     try {
-      raw = fs32.readFileSync(filePath, "utf8");
+      raw = fs35.readFileSync(filePath, "utf8");
     } catch {
       return null;
     }
@@ -21391,9 +22171,9 @@ var HistoryService = class _HistoryService {
     let totalCost = 0;
     let files;
     try {
-      files = fs32.readdirSync(projectDir).filter((f) => f.endsWith(".jsonl")).filter((f) => {
+      files = fs35.readdirSync(projectDir).filter((f) => f.endsWith(".jsonl")).filter((f) => {
         try {
-          return fs32.statSync(path39.join(projectDir, f)).mtimeMs >= monthStartMs;
+          return fs35.statSync(path43.join(projectDir, f)).mtimeMs >= monthStartMs;
         } catch {
           return false;
         }
@@ -21404,7 +22184,7 @@ var HistoryService = class _HistoryService {
     for (const file of files) {
       let raw;
       try {
-        raw = fs32.readFileSync(path39.join(projectDir, file), "utf8");
+        raw = fs35.readFileSync(path43.join(projectDir, file), "utf8");
       } catch {
         continue;
       }
@@ -21468,7 +22248,7 @@ var HistoryService = class _HistoryService {
    * showing an empty conversation.
    */
   async loadConversation(sessionId) {
-    const filePath = path39.join(this.projectDir, `${sessionId}.jsonl`);
+    const filePath = path43.join(this.projectDir, `${sessionId}.jsonl`);
     const messages = parseJsonl(filePath);
     if (messages.length === 0) return;
     const totalBatches = Math.ceil(messages.length / CONVERSATION_BATCH_SIZE);
@@ -21522,7 +22302,7 @@ var HistoryService = class _HistoryService {
       if (!this.currentConversationId) return 0;
     }
     const sessionId = this.currentConversationId;
-    const filePath = path39.join(this.projectDir, `${sessionId}.jsonl`);
+    const filePath = path43.join(this.projectDir, `${sessionId}.jsonl`);
     const messages = parseJsonl(filePath);
     if (messages.length === 0) return 0;
     const marker = this.lastUploadedUuid.get(sessionId);
@@ -21587,7 +22367,7 @@ var RepoDirtyTracker = class {
 
 // src/services/streaming-emitter.service.ts
 var import_crypto5 = require("crypto");
-var API_BASE8 = resolveApiBaseUrl();
+var API_BASE9 = resolveApiBaseUrl();
 var TICK_MS = 50;
 var ANSWER_POLL_MS = 1500;
 var SELECTOR_STABLE_MS = 800;
@@ -21598,7 +22378,7 @@ var TAIL_KEEP_BYTES2 = 1.5 * 1024 * 1024;
 var StreamingEmitterService = class {
   constructor(opts) {
     this.opts = opts;
-    this.apiBase = opts.apiBaseUrl ?? API_BASE8;
+    this.apiBase = opts.apiBaseUrl ?? API_BASE9;
     this.headers = {
       "Content-Type": "application/json",
       "X-Codeam-Protocol-Version": "2.0.0",
@@ -21948,13 +22728,13 @@ function fetchQuotaUsage(runtime, historySvc) {
 }
 
 // src/commands/start/keep-alive.ts
-var import_child_process15 = require("child_process");
+var import_child_process18 = require("child_process");
 function buildKeepAlive(ctx) {
   let timer = null;
   async function setIdleTimeout(minutes) {
     if (!ctx.inCodespace || !ctx.codespaceName) return;
-    await new Promise((resolve6) => {
-      const proc = (0, import_child_process15.spawn)(
+    await new Promise((resolve7) => {
+      const proc = (0, import_child_process18.spawn)(
         "gh",
         [
           "api",
@@ -21967,8 +22747,8 @@ function buildKeepAlive(ctx) {
         { stdio: "ignore", detached: true }
       );
       proc.unref();
-      proc.on("exit", () => resolve6());
-      proc.on("error", () => resolve6());
+      proc.on("exit", () => resolve7());
+      proc.on("error", () => resolve7());
     });
   }
   return {
@@ -22044,6 +22824,20 @@ async function start(requestedAgent) {
     "pluginAuth",
     `boot triple sessionId=${session.id} pluginId=${pluginId} tokenLen=${tokenForLog.length} tokenHead=${tokenForLog.slice(0, 12)} tokenTail=${tokenForLog.slice(-8)} mintedEqualsCached=${refreshed === session.pluginAuthToken}`
   );
+  let beads = null;
+  const getBeads = () => beads;
+  const beadsReady = provisionBeadsForStart({
+    sessionId: session.id,
+    pluginId,
+    pluginAuthToken: session.pluginAuthToken ?? void 0,
+    cwd,
+    // Wire this session's agent natively via `bd setup <recipe> --global` so
+    // the agent actually uses bd (D12 — REVISED). Covers BOTH ACP and PTY.
+    agents: [session.agent]
+  }).then((started) => {
+    beads = started;
+    return started;
+  });
   const acpDisabled = process.env.CODEAM_ACP_DISABLED === "1";
   if (!acpDisabled && session.pluginAuthToken) {
     const adapter = getAcpAdapter(session.agent);
@@ -22054,7 +22848,8 @@ async function start(requestedAgent) {
         pluginId,
         pluginAuthToken: session.pluginAuthToken,
         adapter,
-        cwd
+        cwd,
+        getBeads
       });
       return;
     }
@@ -22132,6 +22927,7 @@ async function start(requestedAgent) {
         relay.stop();
         void fileWatcher?.stop();
         turnFiles?.stop();
+        void beads?.watcher.stop();
         void streamingEmitter?.stop();
         closeAllTerminals();
         cleanupAttachmentTempFiles();
@@ -22165,6 +22961,9 @@ async function start(requestedAgent) {
     await dispatchCommand(ctx, cmd);
   }, runtime.meta);
   ctx.relay = relay;
+  void beadsReady.then((started) => {
+    ctx.beads = started;
+  });
   registerTerminalHandlers({
     onData: ({ sessionId, data }) => {
       void outputSvc.sendTerminalChunk(sessionId, data);
@@ -22181,6 +22980,7 @@ async function start(requestedAgent) {
     outputSvc.dispose();
     relay.stop();
     void fileWatcher?.stop();
+    void beads?.watcher.stop();
     void streamingEmitter?.stop();
     closeAllTerminals();
     cleanupAttachmentTempFiles();
@@ -22319,7 +23119,7 @@ async function pair(args2 = []) {
     waitSpin.message(waitMessage());
   }, 1e3);
   countdownInterval.unref?.();
-  await new Promise((resolve6) => {
+  await new Promise((resolve7) => {
     let stopPolling = null;
     function sigintHandler() {
       clearInterval(countdownInterval);
@@ -22367,7 +23167,7 @@ async function pair(args2 = []) {
             pluginAuthToken: info.pluginAuthToken
           });
         }
-        resolve6();
+        resolve7();
       },
       () => {
         clearInterval(countdownInterval);
@@ -22419,8 +23219,8 @@ async function autoLinkAfterPair(opts) {
 }
 
 // src/commands/pair-auto.ts
-var fs33 = __toESM(require("fs"));
-var os27 = __toESM(require("os"));
+var fs36 = __toESM(require("fs"));
+var os28 = __toESM(require("os"));
 var import_crypto7 = require("crypto");
 
 // src/commands/start-infra-only.ts
@@ -22480,6 +23280,15 @@ async function startInfraOnly(agentId) {
     pluginId,
     pluginAuthToken: session.pluginAuthToken
   }) : null;
+  let beads = null;
+  void provisionBeadsForStart({
+    sessionId: session.id,
+    pluginId,
+    pluginAuthToken: session.pluginAuthToken ?? void 0,
+    cwd
+  }).then((started) => {
+    beads = started;
+  });
   let relayRef = null;
   const ctx = {
     // Agent-touching fields are not used by any of the commands
@@ -22501,6 +23310,23 @@ async function startInfraOnly(agentId) {
   const relay = new CommandRelayService(
     pluginId,
     async (cmd) => {
+      if (cmd.type === "beads_action") {
+        if (!beads) {
+          log.trace("infra-only", "beads_action received but beads not running \u2014 dropping");
+          return;
+        }
+        const action = beadsActionFromPayload(cmd.payload);
+        if (!action) {
+          log.warn("infra-only", "malformed beads_action payload \u2014 dropping");
+          return;
+        }
+        try {
+          await handleBeadsActionCommand(action, beads);
+        } catch (err) {
+          log.warn("infra-only", "handleBeadsActionCommand failed (non-fatal)", err);
+        }
+        return;
+      }
       if (!INFRA_ONLY_COMMAND_TYPES.has(cmd.type)) {
         log.trace("infra-only", `dropping agent-only command type=${cmd.type}`);
         return;
@@ -22561,6 +23387,7 @@ async function startInfraOnly(agentId) {
     } catch {
     }
     void fileWatcher?.stop();
+    void beads?.watcher.stop();
     closeAllTerminals();
     cleanupAttachmentTempFiles();
     process.exit(0);
@@ -22573,7 +23400,7 @@ async function startInfraOnly(agentId) {
 }
 
 // src/commands/pair-auto.ts
-var API_BASE9 = resolveApiBaseUrl();
+var API_BASE10 = resolveApiBaseUrl();
 function fail(msg) {
   console.error(`
   ${msg}
@@ -22588,12 +23415,12 @@ function readTokenFromArgs(args2) {
   }
   const fileFlag = args2.find((a) => a.startsWith("--token-file="));
   if (fileFlag) {
-    const path46 = fileFlag.slice("--token-file=".length);
+    const path50 = fileFlag.slice("--token-file=".length);
     try {
-      const content = fs33.readFileSync(path46, "utf8").trim();
-      if (content.length === 0) fail(`--token-file ${path46} is empty`);
+      const content = fs36.readFileSync(path50, "utf8").trim();
+      if (content.length === 0) fail(`--token-file ${path50} is empty`);
       try {
-        fs33.unlinkSync(path46);
+        fs36.unlinkSync(path50);
       } catch {
       }
       return content;
@@ -22613,13 +23440,13 @@ function networkError(msg, cause) {
   return err;
 }
 async function claimOnce(token, pluginId) {
-  const url = `${API_BASE9}/api/pairing/claim-auto-token`;
+  const url = `${API_BASE10}/api/pairing/claim-auto-token`;
   const body = {
     token,
     pluginId,
     ideName: "codeam-cli (codespace)",
     ideVersion: process.env.npm_package_version ?? "unknown",
-    hostname: os27.hostname(),
+    hostname: os28.hostname(),
     codespaceName: process.env.CODESPACE_NAME ?? "",
     // Current git branch of the codespace's working directory, so the
     // backend can populate `PairedSession.branch` for the codespace pair.
@@ -22816,7 +23643,7 @@ function status() {
 
 // src/commands/logout.ts
 var import_picocolors7 = __toESM(require("picocolors"));
-var API_BASE10 = resolveApiBaseUrl();
+var API_BASE11 = resolveApiBaseUrl();
 async function notifyBackendOffline() {
   const cfg = loadCliConfig();
   const pluginIds = /* @__PURE__ */ new Set([
@@ -22828,7 +23655,7 @@ async function notifyBackendOffline() {
   try {
     await Promise.all(
       Array.from(pluginIds).map(
-        (pluginId) => _postJson(`${API_BASE10}/api/plugin/heartbeat`, {
+        (pluginId) => _postJson(`${API_BASE11}/api/plugin/heartbeat`, {
           pluginId,
           online: false
         }).catch((err) => {
@@ -22856,11 +23683,11 @@ async function logout() {
 var import_picocolors10 = __toESM(require("picocolors"));
 
 // src/services/providers/github-codespaces.ts
-var import_child_process16 = require("child_process");
+var import_child_process19 = require("child_process");
 var import_util4 = require("util");
 var import_picocolors8 = __toESM(require("picocolors"));
-var path40 = __toESM(require("path"));
-var execFileP5 = (0, import_util4.promisify)(import_child_process16.execFile);
+var path44 = __toESM(require("path"));
+var execFileP5 = (0, import_util4.promisify)(import_child_process19.execFile);
 var MAX_BUFFER = 8 * 1024 * 1024;
 function resetStdinForChild() {
   if (process.stdin.isTTY) {
@@ -22903,12 +23730,12 @@ var GitHubCodespacesProvider = class {
     }
     if (!isAuthed) {
       resetStdinForChild();
-      await new Promise((resolve6, reject) => {
-        const proc = (0, import_child_process16.spawn)("gh", ["auth", "login", "-s", "codespace,repo,read:user"], {
+      await new Promise((resolve7, reject) => {
+        const proc = (0, import_child_process19.spawn)("gh", ["auth", "login", "-s", "codespace,repo,read:user"], {
           stdio: "inherit"
         });
         proc.on("exit", (code) => {
-          if (code === 0) resolve6();
+          if (code === 0) resolve7();
           else reject(new Error("gh auth login failed."));
         });
         proc.on("error", reject);
@@ -22937,13 +23764,13 @@ var GitHubCodespacesProvider = class {
       }
       wt(noteLines.join("\n"), "One more permission needed");
       resetStdinForChild();
-      const refreshCode = await new Promise((resolve6, reject) => {
-        const proc = (0, import_child_process16.spawn)(
+      const refreshCode = await new Promise((resolve7, reject) => {
+        const proc = (0, import_child_process19.spawn)(
           "gh",
           ["auth", "refresh", "-h", "github.com", "-s", "codespace"],
           { stdio: "inherit" }
         );
-        proc.on("exit", (code) => resolve6(code ?? 1));
+        proc.on("exit", (code) => resolve7(code ?? 1));
         proc.on("error", reject);
       });
       if (refreshCode !== 0) {
@@ -23087,10 +23914,10 @@ var GitHubCodespacesProvider = class {
     if (q(proceed) || !proceed) return;
     O2.step(`Installing gh via ${installCmd.describe}\u2026`);
     resetStdinForChild();
-    const ok = await new Promise((resolve6) => {
-      const proc = (0, import_child_process16.spawn)(installCmd.exe, installCmd.args, { stdio: "inherit" });
-      proc.on("exit", (code) => resolve6(code === 0));
-      proc.on("error", () => resolve6(false));
+    const ok = await new Promise((resolve7) => {
+      const proc = (0, import_child_process19.spawn)(installCmd.exe, installCmd.args, { stdio: "inherit" });
+      proc.on("exit", (code) => resolve7(code === 0));
+      proc.on("error", () => resolve7(false));
     });
     if (ok) O2.success("gh installed");
     else O2.error("gh install failed");
@@ -23114,14 +23941,14 @@ var GitHubCodespacesProvider = class {
       "Expanding GitHub scopes"
     );
     resetStdinForChild();
-    await new Promise((resolve6, reject) => {
-      const proc = (0, import_child_process16.spawn)(
+    await new Promise((resolve7, reject) => {
+      const proc = (0, import_child_process19.spawn)(
         "gh",
         ["auth", "refresh", "-h", "github.com", "-s", "repo,read:org"],
         { stdio: "inherit" }
       );
       proc.on("exit", (code) => {
-        if (code === 0) resolve6();
+        if (code === 0) resolve7();
         else reject(new Error(
           "gh auth refresh failed. Re-run `gh auth refresh -h github.com -s repo,read:org` manually."
         ));
@@ -23292,13 +24119,13 @@ var GitHubCodespacesProvider = class {
   }
   async streamCommand(workspaceId, command2) {
     resetStdinForChild();
-    return new Promise((resolve6, reject) => {
-      const proc = (0, import_child_process16.spawn)(
+    return new Promise((resolve7, reject) => {
+      const proc = (0, import_child_process19.spawn)(
         "gh",
         ["codespace", "ssh", "-c", workspaceId, "--", "-tt", command2],
         { stdio: "inherit" }
       );
-      proc.on("exit", (code) => resolve6({ code: code ?? 0 }));
+      proc.on("exit", (code) => resolve7({ code: code ?? 0 }));
       proc.on("error", reject);
     });
   }
@@ -23319,12 +24146,12 @@ var GitHubCodespacesProvider = class {
       "--",
       `mkdir -p ${shellQuote(remoteDir)} && tar -xzf - -C ${shellQuote(remoteDir)}`
     ];
-    await new Promise((resolve6, reject) => {
-      const tar = (0, import_child_process16.spawn)("tar", tarArgs, {
+    await new Promise((resolve7, reject) => {
+      const tar = (0, import_child_process19.spawn)("tar", tarArgs, {
         stdio: ["ignore", "pipe", "pipe"],
         env: tarEnv
       });
-      const ssh = (0, import_child_process16.spawn)("gh", sshArgs, {
+      const ssh = (0, import_child_process19.spawn)("gh", sshArgs, {
         stdio: [tar.stdout, "pipe", "pipe"]
       });
       let tarErr = "";
@@ -23339,7 +24166,7 @@ var GitHubCodespacesProvider = class {
       ssh.on("error", reject);
       ssh.on("exit", (code) => {
         if (code === 0) {
-          resolve6();
+          resolve7();
         } else {
           const reason = (sshErr || tarErr || `exit ${code}`).trim().slice(0, 500);
           reject(new Error(`Remote tar failed: ${reason}`));
@@ -23348,7 +24175,7 @@ var GitHubCodespacesProvider = class {
     });
   }
   async uploadFile(workspaceId, remotePath, contents, options = {}) {
-    const remoteDir = path40.posix.dirname(remotePath);
+    const remoteDir = path44.posix.dirname(remotePath);
     const parts = [
       `mkdir -p ${shellQuote(remoteDir)}`,
       `cat > ${shellQuote(remotePath)}`
@@ -23357,8 +24184,8 @@ var GitHubCodespacesProvider = class {
       parts.push(`chmod ${options.mode.toString(8)} ${shellQuote(remotePath)}`);
     }
     const cmd = parts.join(" && ");
-    await new Promise((resolve6, reject) => {
-      const proc = (0, import_child_process16.spawn)(
+    await new Promise((resolve7, reject) => {
+      const proc = (0, import_child_process19.spawn)(
         "gh",
         ["codespace", "ssh", "-c", workspaceId, "--", cmd],
         { stdio: ["pipe", "pipe", "pipe"] }
@@ -23369,7 +24196,7 @@ var GitHubCodespacesProvider = class {
       });
       proc.on("error", reject);
       proc.on("exit", (code) => {
-        if (code === 0) resolve6();
+        if (code === 0) resolve7();
         else reject(new Error(`Remote write failed: ${(stderr || `exit ${code}`).trim().slice(0, 500)}`));
       });
       proc.stdin?.write(contents);
@@ -23416,11 +24243,11 @@ function shellQuote(s) {
 }
 
 // src/services/providers/gitpod.ts
-var import_child_process17 = require("child_process");
+var import_child_process20 = require("child_process");
 var import_util5 = require("util");
-var path41 = __toESM(require("path"));
+var path45 = __toESM(require("path"));
 var import_picocolors9 = __toESM(require("picocolors"));
-var execFileP6 = (0, import_util5.promisify)(import_child_process17.execFile);
+var execFileP6 = (0, import_util5.promisify)(import_child_process20.execFile);
 var MAX_BUFFER2 = 8 * 1024 * 1024;
 function resetStdinForChild2() {
   if (process.stdin.isTTY) {
@@ -23459,10 +24286,10 @@ var GitpodProvider = class {
       "Authenticating Gitpod"
     );
     resetStdinForChild2();
-    await new Promise((resolve6, reject) => {
-      const proc = (0, import_child_process17.spawn)("gitpod", ["login"], { stdio: "inherit" });
+    await new Promise((resolve7, reject) => {
+      const proc = (0, import_child_process20.spawn)("gitpod", ["login"], { stdio: "inherit" });
       proc.on("exit", (code) => {
-        if (code === 0) resolve6();
+        if (code === 0) resolve7();
         else reject(new Error("gitpod login failed."));
       });
       proc.on("error", reject);
@@ -23611,13 +24438,13 @@ var GitpodProvider = class {
   }
   async streamCommand(workspaceId, command2) {
     resetStdinForChild2();
-    return new Promise((resolve6, reject) => {
-      const proc = (0, import_child_process17.spawn)(
+    return new Promise((resolve7, reject) => {
+      const proc = (0, import_child_process20.spawn)(
         "gitpod",
         ["workspace", "ssh", workspaceId, "--", "-tt", command2],
         { stdio: "inherit" }
       );
-      proc.on("exit", (code) => resolve6({ code: code ?? 0 }));
+      proc.on("exit", (code) => resolve7({ code: code ?? 0 }));
       proc.on("error", reject);
     });
   }
@@ -23631,12 +24458,12 @@ var GitpodProvider = class {
     tarArgs.push(".");
     const tarEnv = { ...process.env, COPYFILE_DISABLE: "1" };
     const remoteCmd = `mkdir -p ${shellQuote2(remoteDir)} && tar -xzf - -C ${shellQuote2(remoteDir)}`;
-    await new Promise((resolve6, reject) => {
-      const tar = (0, import_child_process17.spawn)("tar", tarArgs, {
+    await new Promise((resolve7, reject) => {
+      const tar = (0, import_child_process20.spawn)("tar", tarArgs, {
         stdio: ["ignore", "pipe", "pipe"],
         env: tarEnv
       });
-      const ssh = (0, import_child_process17.spawn)(
+      const ssh = (0, import_child_process20.spawn)(
         "gitpod",
         ["workspace", "ssh", workspaceId, "--", remoteCmd],
         { stdio: [tar.stdout, "pipe", "pipe"] }
@@ -23652,13 +24479,13 @@ var GitpodProvider = class {
       tar.on("error", reject);
       ssh.on("error", reject);
       ssh.on("exit", (code) => {
-        if (code === 0) resolve6();
+        if (code === 0) resolve7();
         else reject(new Error(`Remote tar failed: ${(sshErr || tarErr || `exit ${code}`).trim().slice(0, 500)}`));
       });
     });
   }
   async uploadFile(workspaceId, remotePath, contents, options = {}) {
-    const remoteDir = path41.posix.dirname(remotePath);
+    const remoteDir = path45.posix.dirname(remotePath);
     const parts = [
       `mkdir -p ${shellQuote2(remoteDir)}`,
       `cat > ${shellQuote2(remotePath)}`
@@ -23667,8 +24494,8 @@ var GitpodProvider = class {
       parts.push(`chmod ${options.mode.toString(8)} ${shellQuote2(remotePath)}`);
     }
     const cmd = parts.join(" && ");
-    await new Promise((resolve6, reject) => {
-      const proc = (0, import_child_process17.spawn)(
+    await new Promise((resolve7, reject) => {
+      const proc = (0, import_child_process20.spawn)(
         "gitpod",
         ["workspace", "ssh", workspaceId, "--", cmd],
         { stdio: ["pipe", "pipe", "pipe"] }
@@ -23679,7 +24506,7 @@ var GitpodProvider = class {
       });
       proc.on("error", reject);
       proc.on("exit", (code) => {
-        if (code === 0) resolve6();
+        if (code === 0) resolve7();
         else reject(new Error(`Remote write failed: ${(stderr || `exit ${code}`).trim().slice(0, 500)}`));
       });
       proc.stdin?.write(contents);
@@ -23692,10 +24519,10 @@ function shellQuote2(s) {
 }
 
 // src/services/providers/gitlab-workspaces.ts
-var import_child_process18 = require("child_process");
+var import_child_process21 = require("child_process");
 var import_util6 = require("util");
-var path42 = __toESM(require("path"));
-var execFileP7 = (0, import_util6.promisify)(import_child_process18.execFile);
+var path46 = __toESM(require("path"));
+var execFileP7 = (0, import_util6.promisify)(import_child_process21.execFile);
 var MAX_BUFFER3 = 8 * 1024 * 1024;
 var GITLAB_API_BASE = process.env.CODEAM_GITLAB_API_URL ?? "https://gitlab.com/api/v4";
 function resetStdinForChild3() {
@@ -23736,14 +24563,14 @@ var GitLabWorkspacesProvider = class {
       "Authenticating GitLab"
     );
     resetStdinForChild3();
-    await new Promise((resolve6, reject) => {
-      const proc = (0, import_child_process18.spawn)(
+    await new Promise((resolve7, reject) => {
+      const proc = (0, import_child_process21.spawn)(
         "glab",
         ["auth", "login", "--scopes", "api,read_user,read_repository"],
         { stdio: "inherit" }
       );
       proc.on("exit", (code) => {
-        if (code === 0) resolve6();
+        if (code === 0) resolve7();
         else reject(new Error("glab auth login failed."));
       });
       proc.on("error", reject);
@@ -23908,13 +24735,13 @@ Docs: https://docs.gitlab.com/ee/user/workspace/configuration.html`
   async streamCommand(workspaceId, command2) {
     const sshHost = process.env.CODEAM_GITLAB_SSH_HOST ?? "workspaces.gitlab.com";
     resetStdinForChild3();
-    return new Promise((resolve6, reject) => {
-      const proc = (0, import_child_process18.spawn)(
+    return new Promise((resolve7, reject) => {
+      const proc = (0, import_child_process21.spawn)(
         "ssh",
         ["-tt", "-o", "StrictHostKeyChecking=accept-new", `${workspaceId}@${sshHost}`, command2],
         { stdio: "inherit" }
       );
-      proc.on("exit", (code) => resolve6({ code: code ?? 0 }));
+      proc.on("exit", (code) => resolve7({ code: code ?? 0 }));
       proc.on("error", reject);
     });
   }
@@ -23929,9 +24756,9 @@ Docs: https://docs.gitlab.com/ee/user/workspace/configuration.html`
     tarArgs.push(".");
     const tarEnv = { ...process.env, COPYFILE_DISABLE: "1" };
     const remoteCmd = `mkdir -p ${shellQuote3(remoteDir)} && tar -xzf - -C ${shellQuote3(remoteDir)}`;
-    await new Promise((resolve6, reject) => {
-      const tar = (0, import_child_process18.spawn)("tar", tarArgs, { stdio: ["ignore", "pipe", "pipe"], env: tarEnv });
-      const ssh = (0, import_child_process18.spawn)(
+    await new Promise((resolve7, reject) => {
+      const tar = (0, import_child_process21.spawn)("tar", tarArgs, { stdio: ["ignore", "pipe", "pipe"], env: tarEnv });
+      const ssh = (0, import_child_process21.spawn)(
         "ssh",
         ["-o", "StrictHostKeyChecking=accept-new", `${workspaceId}@${sshHost}`, remoteCmd],
         { stdio: [tar.stdout, "pipe", "pipe"] }
@@ -23947,21 +24774,21 @@ Docs: https://docs.gitlab.com/ee/user/workspace/configuration.html`
       tar.on("error", reject);
       ssh.on("error", reject);
       ssh.on("exit", (code) => {
-        if (code === 0) resolve6();
+        if (code === 0) resolve7();
         else reject(new Error(`Remote tar failed: ${(sshErr || tarErr || `exit ${code}`).trim().slice(0, 500)}`));
       });
     });
   }
   async uploadFile(workspaceId, remotePath, contents, options = {}) {
     const sshHost = process.env.CODEAM_GITLAB_SSH_HOST ?? "workspaces.gitlab.com";
-    const remoteDir = path42.posix.dirname(remotePath);
+    const remoteDir = path46.posix.dirname(remotePath);
     const parts = [`mkdir -p ${shellQuote3(remoteDir)}`, `cat > ${shellQuote3(remotePath)}`];
     if (options.mode != null) {
       parts.push(`chmod ${options.mode.toString(8)} ${shellQuote3(remotePath)}`);
     }
     const cmd = parts.join(" && ");
-    await new Promise((resolve6, reject) => {
-      const proc = (0, import_child_process18.spawn)(
+    await new Promise((resolve7, reject) => {
+      const proc = (0, import_child_process21.spawn)(
         "ssh",
         ["-o", "StrictHostKeyChecking=accept-new", `${workspaceId}@${sshHost}`, cmd],
         { stdio: ["pipe", "pipe", "pipe"] }
@@ -23972,7 +24799,7 @@ Docs: https://docs.gitlab.com/ee/user/workspace/configuration.html`
       });
       proc.on("error", reject);
       proc.on("exit", (code) => {
-        if (code === 0) resolve6();
+        if (code === 0) resolve7();
         else reject(new Error(`Remote write failed: ${(stderr || `exit ${code}`).trim().slice(0, 500)}`));
       });
       proc.stdin?.write(contents);
@@ -24020,10 +24847,10 @@ function shellQuote3(s) {
 }
 
 // src/services/providers/railway.ts
-var import_child_process19 = require("child_process");
+var import_child_process22 = require("child_process");
 var import_util7 = require("util");
-var path43 = __toESM(require("path"));
-var execFileP8 = (0, import_util7.promisify)(import_child_process19.execFile);
+var path47 = __toESM(require("path"));
+var execFileP8 = (0, import_util7.promisify)(import_child_process22.execFile);
 var MAX_BUFFER4 = 8 * 1024 * 1024;
 function resetStdinForChild4() {
   if (process.stdin.isTTY) {
@@ -24063,10 +24890,10 @@ var RailwayProvider = class {
       "Authenticating Railway"
     );
     resetStdinForChild4();
-    await new Promise((resolve6, reject) => {
-      const proc = (0, import_child_process19.spawn)("railway", ["login"], { stdio: "inherit" });
+    await new Promise((resolve7, reject) => {
+      const proc = (0, import_child_process22.spawn)("railway", ["login"], { stdio: "inherit" });
       proc.on("exit", (code) => {
-        if (code === 0) resolve6();
+        if (code === 0) resolve7();
         else reject(new Error("railway login failed."));
       });
       proc.on("error", reject);
@@ -24206,13 +25033,13 @@ var RailwayProvider = class {
       throw new Error("Invalid Railway workspace id (expected projectId/serviceId).");
     }
     resetStdinForChild4();
-    return new Promise((resolve6, reject) => {
-      const proc = (0, import_child_process19.spawn)(
+    return new Promise((resolve7, reject) => {
+      const proc = (0, import_child_process22.spawn)(
         "railway",
         ["shell", "--project", projectId, "--service", serviceId, "--command", command2],
         { stdio: "inherit" }
       );
-      proc.on("exit", (code) => resolve6({ code: code ?? 0 }));
+      proc.on("exit", (code) => resolve7({ code: code ?? 0 }));
       proc.on("error", reject);
     });
   }
@@ -24230,9 +25057,9 @@ var RailwayProvider = class {
     tarArgs.push(".");
     const tarEnv = { ...process.env, COPYFILE_DISABLE: "1" };
     const remoteCmd = `mkdir -p ${shellQuote4(remoteDir)} && tar -xzf - -C ${shellQuote4(remoteDir)}`;
-    await new Promise((resolve6, reject) => {
-      const tar = (0, import_child_process19.spawn)("tar", tarArgs, { stdio: ["ignore", "pipe", "pipe"], env: tarEnv });
-      const sh = (0, import_child_process19.spawn)(
+    await new Promise((resolve7, reject) => {
+      const tar = (0, import_child_process22.spawn)("tar", tarArgs, { stdio: ["ignore", "pipe", "pipe"], env: tarEnv });
+      const sh = (0, import_child_process22.spawn)(
         "railway",
         ["shell", "--project", projectId, "--service", serviceId, "--command", remoteCmd],
         { stdio: [tar.stdout, "pipe", "pipe"] }
@@ -24248,7 +25075,7 @@ var RailwayProvider = class {
       tar.on("error", reject);
       sh.on("error", reject);
       sh.on("exit", (code) => {
-        if (code === 0) resolve6();
+        if (code === 0) resolve7();
         else reject(new Error(`Remote tar failed: ${(shErr || tarErr || `exit ${code}`).trim().slice(0, 500)}`));
       });
     });
@@ -24258,14 +25085,14 @@ var RailwayProvider = class {
     if (!projectId || !serviceId) {
       throw new Error("Invalid Railway workspace id (expected projectId/serviceId).");
     }
-    const remoteDir = path43.posix.dirname(remotePath);
+    const remoteDir = path47.posix.dirname(remotePath);
     const parts = [`mkdir -p ${shellQuote4(remoteDir)}`, `cat > ${shellQuote4(remotePath)}`];
     if (options.mode != null) {
       parts.push(`chmod ${options.mode.toString(8)} ${shellQuote4(remotePath)}`);
     }
     const cmd = parts.join(" && ");
-    await new Promise((resolve6, reject) => {
-      const proc = (0, import_child_process19.spawn)(
+    await new Promise((resolve7, reject) => {
+      const proc = (0, import_child_process22.spawn)(
         "railway",
         ["shell", "--project", projectId, "--service", serviceId, "--command", cmd],
         { stdio: ["pipe", "pipe", "pipe"] }
@@ -24276,7 +25103,7 @@ var RailwayProvider = class {
       });
       proc.on("error", reject);
       proc.on("exit", (code) => {
-        if (code === 0) resolve6();
+        if (code === 0) resolve7();
         else reject(new Error(`Remote write failed: ${(stderr || `exit ${code}`).trim().slice(0, 500)}`));
       });
       proc.stdin?.write(contents);
@@ -24801,8 +25628,8 @@ async function stopWorkspaceFromLocal(target) {
 var import_node_dns = require("dns");
 var import_node_util4 = require("util");
 var import_node_crypto8 = require("crypto");
-var fs34 = __toESM(require("fs"));
-var path44 = __toESM(require("path"));
+var fs37 = __toESM(require("fs"));
+var path48 = __toESM(require("path"));
 var import_picocolors12 = __toESM(require("picocolors"));
 var dnsResolveP = (0, import_node_util4.promisify)(import_node_dns.resolve);
 async function checkDns(apiBase) {
@@ -24858,13 +25685,13 @@ async function checkHealth(apiBase) {
   }
 }
 function checkConfigDir() {
-  const dir = path44.join(require("os").homedir(), ".codeam");
+  const dir = path48.join(require("os").homedir(), ".codeam");
   try {
-    fs34.mkdirSync(dir, { recursive: true, mode: 448 });
-    const probe = path44.join(dir, ".doctor-probe");
-    fs34.writeFileSync(probe, "ok", { mode: 384 });
-    const read = fs34.readFileSync(probe, "utf8");
-    fs34.unlinkSync(probe);
+    fs37.mkdirSync(dir, { recursive: true, mode: 448 });
+    const probe = path48.join(dir, ".doctor-probe");
+    fs37.writeFileSync(probe, "ok", { mode: 384 });
+    const read = fs37.readFileSync(probe, "utf8");
+    fs37.unlinkSync(probe);
     if (read !== "ok") throw new Error("write/read round-trip mismatch");
     return {
       id: "config-dir",
@@ -24904,9 +25731,9 @@ function checkSessions() {
   }
 }
 function checkAgentBinaries() {
-  const os29 = createOsStrategy();
+  const os30 = createOsStrategy();
   return getEnabledAgents().map((meta) => {
-    const found = os29.findInPath(meta.binaryName);
+    const found = os30.findInPath(meta.binaryName);
     return {
       id: `agent-${meta.id}`,
       label: `Agent binary: ${meta.displayName} (${meta.binaryName})`,
@@ -24928,7 +25755,7 @@ function checkNodePty() {
       detail: "not required on this platform"
     };
   }
-  const vendoredPath = path44.join(__dirname, "vendor", "node-pty");
+  const vendoredPath = path48.join(__dirname, "vendor", "node-pty");
   for (const target of [vendoredPath, "node-pty"]) {
     try {
       require(target);
@@ -24970,7 +25797,7 @@ function checkChokidar() {
 }
 async function doctor(args2 = []) {
   const json = args2.includes("--json");
-  const cliVersion = true ? "2.32.10" : "0.0.0-dev";
+  const cliVersion = true ? "2.34.0" : "0.0.0-dev";
   const apiBase = resolveApiBaseUrl();
   const diagnosticId = (0, import_node_crypto8.randomUUID)();
   log.info("doctor", `run id=${diagnosticId} cli=${cliVersion}`);
@@ -25169,7 +25996,7 @@ async function completion(args2) {
 // src/commands/version.ts
 var import_picocolors13 = __toESM(require("picocolors"));
 function version2() {
-  const v = true ? "2.32.10" : "unknown";
+  const v = true ? "2.34.0" : "unknown";
   console.log(`${import_picocolors13.default.bold("codeam-cli")} ${import_picocolors13.default.cyan(v)}`);
 }
 
@@ -25297,9 +26124,9 @@ function tryShowSubcommandHelp(cmd, args2) {
 var _subcommandHelpKeys = Object.keys(HELPS);
 
 // src/lib/updateNotifier.ts
-var fs35 = __toESM(require("fs"));
-var os28 = __toESM(require("os"));
-var path45 = __toESM(require("path"));
+var fs38 = __toESM(require("fs"));
+var os29 = __toESM(require("os"));
+var path49 = __toESM(require("path"));
 var https8 = __toESM(require("https"));
 var import_node_child_process12 = require("child_process");
 var import_picocolors16 = __toESM(require("picocolors"));
@@ -25308,12 +26135,12 @@ var REGISTRY_URL = `https://registry.npmjs.org/${PKG_NAME}/latest`;
 var TTL_MS = 24 * 60 * 60 * 1e3;
 var REQUEST_TIMEOUT_MS = 1500;
 function cachePath() {
-  const dir = path45.join(os28.homedir(), ".codeam");
-  return path45.join(dir, "update-check.json");
+  const dir = path49.join(os29.homedir(), ".codeam");
+  return path49.join(dir, "update-check.json");
 }
 function readCache() {
   try {
-    const raw = fs35.readFileSync(cachePath(), "utf8");
+    const raw = fs38.readFileSync(cachePath(), "utf8");
     const parsed = JSON.parse(raw);
     if (typeof parsed.fetchedAt !== "number" || typeof parsed.latest !== "string") return null;
     return parsed;
@@ -25324,10 +26151,10 @@ function readCache() {
 function writeCache(cache) {
   try {
     const file = cachePath();
-    fs35.mkdirSync(path45.dirname(file), { recursive: true });
+    fs38.mkdirSync(path49.dirname(file), { recursive: true });
     const tmp = `${file}.${process.pid}.tmp`;
-    fs35.writeFileSync(tmp, JSON.stringify(cache));
-    fs35.renameSync(tmp, file);
+    fs38.writeFileSync(tmp, JSON.stringify(cache));
+    fs38.renameSync(tmp, file);
   } catch {
   }
 }
@@ -25345,14 +26172,14 @@ function compareSemver(a, b) {
   return 0;
 }
 function fetchLatest() {
-  return new Promise((resolve6) => {
+  return new Promise((resolve7) => {
     const req = https8.get(
       REGISTRY_URL,
       { headers: { Accept: "application/json" }, timeout: REQUEST_TIMEOUT_MS },
       (res) => {
         if (res.statusCode !== 200) {
           res.resume();
-          resolve6(null);
+          resolve7(null);
           return;
         }
         let buf = "";
@@ -25364,21 +26191,21 @@ function fetchLatest() {
           try {
             const json = JSON.parse(buf);
             if (typeof json.version === "string") {
-              resolve6(json.version);
+              resolve7(json.version);
             } else {
-              resolve6(null);
+              resolve7(null);
             }
           } catch {
-            resolve6(null);
+            resolve7(null);
           }
         });
       }
     );
     req.on("timeout", () => {
       req.destroy();
-      resolve6(null);
+      resolve7(null);
     });
-    req.on("error", () => resolve6(null));
+    req.on("error", () => resolve7(null));
   });
 }
 function notifyIfStale(currentVersion, latest) {
@@ -25401,8 +26228,8 @@ function isLinkedInstall() {
       timeout: 2e3
     }).trim();
     if (!root) return false;
-    const pkgPath = path45.join(root, PKG_NAME);
-    return fs35.lstatSync(pkgPath).isSymbolicLink();
+    const pkgPath = path49.join(root, PKG_NAME);
+    return fs38.lstatSync(pkgPath).isSymbolicLink();
   } catch {
     return false;
   }
@@ -25438,7 +26265,7 @@ function maybeAutoUpdate(currentVersion, latest) {
     return;
   }
   try {
-    fs35.unlinkSync(cachePath());
+    fs38.unlinkSync(cachePath());
   } catch {
   }
   process.stderr.write(`  ${import_picocolors16.default.green("\u2713")} Updated. Resuming session...
@@ -25455,7 +26282,7 @@ function checkForUpdates() {
   if (process.env.CODEAM_DISABLE_UPDATE_CHECK === "1") return;
   if (process.env.CI) return;
   if (!process.stdout.isTTY) return;
-  const current = true ? "2.32.10" : null;
+  const current = true ? "2.34.0" : null;
   if (!current) return;
   const cache = readCache();
   const fresh = cache && Date.now() - cache.fetchedAt < TTL_MS;