codeam-cli 2.32.9 → 2.33.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.9",
+  version: "2.33.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",
@@ -614,6 +615,12 @@ function showError(msg) {
 function showInfo(msg) {
   out(`  ${import_picocolors.default.dim("\xB7")} ${msg}`);
 }
+function showRelayNotice() {
+  out("");
+  out(`  ${import_picocolors.default.bold(import_picocolors.default.yellow("\u26A0  This terminal is a relay \u2014 do not type here."))}`);
+  out(`  ${import_picocolors.default.dim("Send your prompts from the CodeAgent Mobile app; replies stream in below.")}`);
+  out("");
+}
 var BOX_INTERIOR = 30;
 var BOX_BORDER_TOP = `  \u250C${"\u2500".repeat(BOX_INTERIOR)}\u2510`;
 var BOX_BORDER_BOT = `  \u2514${"\u2500".repeat(BOX_INTERIOR)}\u2518`;
@@ -701,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);
@@ -846,7 +853,7 @@ async function postPreviewEvent(input) {
   }
 }
 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;
@@ -878,9 +885,9 @@ async function _postJsonAuthed(url, body, pluginAuthToken) {
             return;
           }
           try {
-            resolve6(JSON.parse(responseBody));
+            resolve7(JSON.parse(responseBody));
           } catch {
-            resolve6(null);
+            resolve7(null);
           }
         });
       }
@@ -905,7 +912,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;
@@ -934,9 +941,9 @@ async function _postJson(url, body) {
             return;
           }
           try {
-            resolve6(JSON.parse(body2));
+            resolve7(JSON.parse(body2));
           } catch {
-            resolve6(null);
+            resolve7(null);
           }
         });
       }
@@ -951,7 +958,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(
@@ -975,9 +982,9 @@ async function _getJson(url) {
             return;
           }
           try {
-            resolve6(JSON.parse(body));
+            resolve7(JSON.parse(body));
           } catch {
-            resolve6(null);
+            resolve7(null);
           }
         });
       }
@@ -1155,8 +1162,8 @@ function createGetModuleFromFilename(basePath = process.argv[1] ? (0, import_pat
     return decodedFile;
   };
 }
-function normalizeWindowsPath(path46) {
-  return path46.replace(/^[A-Z]:/, "").replace(/\\/g, "/");
+function normalizeWindowsPath(path49) {
+  return path49.replace(/^[A-Z]:/, "").replace(/\\/g, "/");
 }
 
 // ../../node_modules/@posthog/core/dist/featureFlagUtils.mjs
@@ -3636,15 +3643,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(path49, ranges, output) {
+  return new Promise((resolve7) => {
+    const stream = (0, import_node_fs.createReadStream)(path49);
     const lineReaded = (0, import_node_readline.createInterface)({
       input: stream
     });
     function destroyStreamAndResolve() {
       stream.destroy();
-      resolve6();
+      resolve7();
     }
     let lineNumber = 0;
     let currentRangeIndex = 0;
@@ -3653,7 +3660,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(path49, 1);
       lineReaded.close();
       lineReaded.removeAllListeners();
       destroyStreamAndResolve();
@@ -3714,8 +3721,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(path49) {
+  return path49.startsWith("node:") || path49.endsWith(".min.js") || path49.endsWith(".min.cjs") || path49.endsWith(".min.mjs") || path49.startsWith("data:");
 }
 function shouldSkipContextLinesForFrame(frame) {
   if (void 0 !== frame.lineno && frame.lineno > MAX_CONTEXTLINES_LINENO) return true;
@@ -4931,9 +4938,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);
@@ -4941,7 +4948,7 @@ var PostHogBackendClient = class extends PostHogCoreStateless {
         return;
       }
       this._waitUntilCycle = {
-        resolve: resolve6,
+        resolve: resolve7,
         startedAt: Date.now(),
         timer: void 0
       };
@@ -4965,12 +4972,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) {
@@ -5062,15 +5069,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);
       });
     });
   }
@@ -5507,13 +5514,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) {
@@ -5869,7 +5876,7 @@ function readAnonId() {
 }
 function superProperties() {
   return {
-    cliVersion: true ? "2.32.9" : "0.0.0-dev",
+    cliVersion: true ? "2.33.0" : "0.0.0-dev",
     nodeVersion: process.version,
     platform: process.platform,
     arch: process.arch,
@@ -7211,10 +7218,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
@@ -9170,15 +9177,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);
     });
   });
 }
@@ -9355,17 +9362,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", ""], {
@@ -9392,13 +9399,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();
@@ -9429,12 +9436,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 {
@@ -9941,13 +9948,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 path49 = pathLine && !BANNER_ART_RE.test(pathLine) ? pathLine : "";
   return {
     title: "",
     subtitle: lines[metaIdx].trim(),
-    path: path46,
+    path: path49,
     startIdx: artStart,
-    endIdx: metaIdx + (path46 ? 1 : 0)
+    endIdx: metaIdx + (path49 ? 1 : 0)
   };
 }
 
@@ -9957,8 +9964,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
@@ -10966,8 +10973,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" });
@@ -10990,8 +10997,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");
@@ -11097,16 +11104,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) => {
@@ -11119,16 +11126,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 {
   }
 }
@@ -11212,25 +11219,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
@@ -11257,10 +11264,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" });
@@ -11283,11 +11290,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 [, path49, lineNo, sevToken, message] = m;
+    if (!path49 || !lineNo || !message) continue;
     const cleanedMessage = message.trim().replace(/^[*-]\s+/, "");
     hunks.push({
-      path: path46.trim(),
+      path: path49.trim(),
       line: Number(lineNo),
       severity: sevToken ? SEVERITY_MAP[sevToken.toLowerCase()] : void 0,
       message: cleanedMessage
@@ -11306,8 +11313,8 @@ var CoderabbitRuntimeStrategy = class {
   meta = getAgent("coderabbit");
   mode = "batch";
   os;
-  constructor(os29) {
-    this.os = os29;
+  constructor(os30) {
+    this.os = os30;
   }
   getDefaultArgs() {
     return ["review"];
@@ -11345,7 +11352,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, {
@@ -11356,7 +11363,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"),
@@ -11422,10 +11429,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"
       );
@@ -11487,8 +11494,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");
@@ -11608,10 +11615,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"
       );
@@ -11621,7 +11628,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"
       });
     }
@@ -11693,8 +11700,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");
@@ -11823,8 +11830,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" });
@@ -11857,8 +11864,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");
@@ -11958,18 +11965,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'.`
@@ -11979,10 +11986,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.`
@@ -14262,8 +14269,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();
   }
@@ -14433,11 +14440,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);
           }
@@ -14758,17 +14765,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;
@@ -14906,7 +14913,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;
@@ -14931,7 +14938,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 });
         });
       }
     );
@@ -14948,7 +14955,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;
@@ -14972,7 +14979,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 });
         });
       }
     );
@@ -15681,11 +15688,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 fs31 = __toESM(require("fs"));
+var os25 = __toESM(require("os"));
+var path38 = __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");
@@ -16338,12 +16345,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 = "";
@@ -16356,11 +16363,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 })
     );
   });
 }
@@ -16619,7 +16626,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);
@@ -16632,7 +16639,7 @@ async function link(args2 = []) {
         process.removeListener("SIGINT", sigint);
         clearInterval(countdown);
         waitSpin.stop("Paired");
-        resolve6(info);
+        resolve7(info);
       },
       () => {
         clearInterval(countdown);
@@ -16767,14 +16774,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());
@@ -17172,12 +17179,758 @@ function activePreviewSessionIds() {
   return Array.from(activePreviews.keys());
 }
 
+// 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 _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 resolveBdOnPath() {
+  return _resolveSeam.resolveOnPath();
+}
+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 {
+      }
+    }
+  }
+  return null;
+}
+var _resolveSeam = {
+  resolveBundled: _defaultResolveBundled,
+  resolveOnPath: _defaultResolveOnPath
+};
+var _spawnSeam = {
+  run: _defaultSpawn
+};
+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;
+  }
+  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;
+  }
+  /** True when a bd binary is resolvable without installing. */
+  isAvailable() {
+    return this.resolveBinary() !== null;
+  }
+  /**
+   * Run an arbitrary bd subcommand. Always injects `--global` (the home brain)
+   * unless a `beadsDir` override is set, in which case `BEADS_DIR` redirects bd
+   * to that dir instead (tests). Returns the raw result; callers decide how to
+   * interpret exit codes (e.g. `bd setup --check` uses 0/nonzero).
+   */
+  async run(args2) {
+    const binary = this.resolveBinary();
+    if (!binary) {
+      return { code: -1, stdout: "", stderr: "bd binary not resolved" };
+    }
+    const env = { ...process.env };
+    const finalArgs = [...args2];
+    if (this.opts.beadsDir) {
+      env.BEADS_DIR = this.opts.beadsDir;
+    } else if (!finalArgs.includes("--global")) {
+      finalArgs.push("--global");
+    }
+    log.trace("beads", `bd ${finalArgs.join(" ")}`);
+    return _spawnSeam.run(binary, finalArgs, { cwd: this.opts.cwd, env });
+  }
+  /**
+   * `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;
+    }
+  }
+};
+var VALID_STATUS = /* @__PURE__ */ new Set([
+  "open",
+  "in_progress",
+  "blocked",
+  "closed"
+]);
+function parseIssues(res, projectKey) {
+  if (res.code !== 0) return [];
+  let parsed;
+  try {
+    parsed = JSON.parse(res.stdout);
+  } catch {
+    return [];
+  }
+  if (!Array.isArray(parsed)) return [];
+  const out2 = [];
+  for (const row of parsed) {
+    const issue = coerceIssue(row, projectKey);
+    if (issue) out2.push(issue);
+  }
+  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/bootstrap.ts
+var SETUP_RECIPE = {
+  claude: "claude",
+  codex: "codex",
+  cursor: "cursor",
+  gemini: "gemini",
+  aider: "aider",
+  copilot: "copilot"
+};
+async function bootstrapBeads(opts) {
+  const bd = opts.adapter ?? new BdAdapter({ cwd: opts.cwd, beadsDir: opts.beadsDir });
+  const result = {
+    bdAvailable: false,
+    serverUp: false,
+    agentsConfigured: [],
+    exportEnabled: false
+  };
+  if (!bd.isAvailable()) {
+    log.warn("beads", "bd binary unavailable \u2014 skipping bootstrap");
+    return result;
+  }
+  result.bdAvailable = true;
+  result.serverUp = await ensureServer(bd);
+  if (!result.serverUp) {
+    log.warn("beads", "dolt sql-server not up after start \u2014 skipping wiring this run");
+    return result;
+  }
+  for (const agent of opts.agents) {
+    const recipe = SETUP_RECIPE[agent];
+    if (!recipe) {
+      log.trace("beads", `no bd setup recipe for agent ${agent} \u2014 skipping`);
+      continue;
+    }
+    const applied = await ensureRecipe(bd, recipe);
+    if (applied) result.agentsConfigured.push(agent);
+  }
+  result.exportEnabled = await ensureAutoExport(bd);
+  log.info(
+    "beads",
+    `bootstrap done server=${result.serverUp} agents=[${result.agentsConfigured.join(",")}] export=${result.exportEnabled}`
+  );
+  return result;
+}
+async function ensureServer(bd) {
+  const status2 = await bd.run(["dolt", "status"]);
+  if (status2.code === 0) {
+    log.trace("beads", "dolt sql-server already running");
+    return true;
+  }
+  log.info("beads", "dolt sql-server down \u2014 starting detached");
+  const start2 = await bd.run(["dolt", "start"]);
+  if (start2.code !== 0) {
+    log.warn("beads", `bd dolt start failed (code=${start2.code}): ${start2.stderr.slice(0, 200)}`);
+    return false;
+  }
+  const recheck = await bd.run(["dolt", "status"]);
+  return recheck.code === 0;
+}
+async function ensureRecipe(bd, recipe) {
+  const check = await bd.run(["setup", recipe, "--check"]);
+  if (check.code === 0) {
+    log.trace("beads", `recipe ${recipe} already configured`);
+    return false;
+  }
+  const setup = await bd.run(["setup", recipe]);
+  if (setup.code !== 0) {
+    log.warn("beads", `bd setup ${recipe} failed (code=${setup.code})`);
+    return false;
+  }
+  log.info("beads", `configured agent recipe: ${recipe}`);
+  return true;
+}
+async function ensureAutoExport(bd) {
+  const res = await bd.run(["config", "set", "export.jsonl", "true"]);
+  return res.code === 0;
+}
+
+// src/beads/watcher.ts
+var crypto3 = __toESM(require("crypto"));
+var path37 = __toESM(require("path"));
+
+// src/beads/project-key.ts
+var import_child_process13 = require("child_process");
+var crypto2 = __toESM(require("crypto"));
+var fs30 = __toESM(require("fs"));
+var path36 = __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 = path36.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 = fs30.statSync(path36.join(dir, ".git"), { throwIfNoEntry: false });
+      if (stat3 && (stat3.isDirectory() || stat3.isFile())) return dir;
+    } catch {
+    }
+    const parent = path36.dirname(dir);
+    if (parent === dir) return null;
+    dir = parent;
+  }
+  return null;
+}
+var _execSeam2 = {
+  exec: (file, args2, opts) => {
+    const out2 = (0, import_child_process13.execFileSync)(file, args2, opts);
+    return typeof out2 === "string" ? out2 : out2.toString("utf8");
+  },
+  realpath: (p2) => fs30.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: path36.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 ?? path37.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/install-bd.ts
+var import_child_process14 = 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_process14.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/index.ts
+async function maybeStartBeads(opts) {
+  if (!opts.enabled) {
+    log.trace("beads", "beads flag off \u2014 skipping");
+    return null;
+  }
+  const adapter = new BdAdapter({ cwd: opts.cwd });
+  if (!adapter.isAvailable() && opts.allowInstall) {
+    log.info("beads", "bd not found \u2014 running OS installer");
+    await installBd();
+  }
+  if (!adapter.isAvailable()) {
+    log.warn("beads", "bd unavailable \u2014 beads disabled for this session");
+    return null;
+  }
+  const boot = await bootstrapBeads({ cwd: opts.cwd, agents: opts.agents, adapter });
+  if (!boot.serverUp) {
+    log.warn("beads", "beads server not up \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 startBeadsForSession(ctx) {
+  if (beadsKilled()) {
+    log.trace("beads", "CODEAM_BEADS_DISABLED set \u2014 beads off for this session");
+    return null;
+  }
+  if (!ctx.pluginAuthToken) {
+    log.trace("beads", "no pluginAuthToken on session \u2014 beads off");
+    return null;
+  }
+  try {
+    return await maybeStartBeads({
+      enabled: true,
+      sessionId: ctx.sessionId,
+      pluginId: ctx.pluginId,
+      pluginAuthToken: ctx.pluginAuthToken,
+      agents: ctx.agents,
+      cwd: ctx.cwd
+    });
+  } catch (err) {
+    log.warn("beads", "startBeadsForSession failed (non-fatal)", err);
+    return null;
+  }
+}
+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 {
-      fs29.unlinkSync(p2);
+      fs31.unlinkSync(p2);
     } catch {
     }
   }
@@ -17186,8 +17939,8 @@ function cleanupAttachmentTempFiles() {
 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"));
+    const tmpPath = path38.join(os25.tmpdir(), `codeam-${(0, import_crypto3.randomUUID)()}-${safeName}`);
+    fs31.writeFileSync(tmpPath, Buffer.from(base64, "base64"));
     pendingAttachmentFiles.add(tmpPath);
     return tmpPath;
   });
@@ -17207,7 +17960,7 @@ var startTask = (ctx, _cmd, parsed) => {
     setTimeout(() => {
       for (const p2 of paths) {
         try {
-          fs29.unlinkSync(p2);
+          fs31.unlinkSync(p2);
         } catch {
         }
         pendingAttachmentFiles.delete(p2);
@@ -17332,7 +18085,7 @@ var sessionTerminated = async (ctx, cmd) => {
   } catch {
   }
   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"
     });
@@ -17354,7 +18107,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" }
@@ -17364,7 +18117,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"
     });
@@ -17780,8 +18533,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 = path38.join(cwd, "node_modules", ".bin", binName);
+  if (!fs31.existsSync(binPath)) return detection;
   return {
     ...detection,
     command: binPath,
@@ -17871,7 +18624,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"]
@@ -17997,7 +18750,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;
@@ -18094,8 +18847,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"]
@@ -18108,8 +18861,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) => {
@@ -18163,6 +18916,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.`);
@@ -18174,10 +18944,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 fs32 = __toESM(require("fs"));
+var os26 = __toESM(require("os"));
+var path39 = __toESM(require("path"));
 var import_ignore = __toESM(require("ignore"));
 
 // src/services/file-watcher/diff-parser.ts
@@ -18266,58 +19036,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;
@@ -18336,10 +19057,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 = [
@@ -18353,7 +19074,7 @@ function isUnsafeWindowsWatchRoot(dir, homedir21) {
   }
   return false;
 }
-var _chokidarSeam = {
+var _chokidarSeam2 = {
   load: () => {
     try {
       return require("chokidar");
@@ -18369,18 +19090,18 @@ var _findGitRootSeam = {
   resolve: _defaultFindGitRoot
 };
 function _defaultFindGitRoot(startDir) {
-  let dir = path36.resolve(startDir);
+  let dir = path39.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 = path39.join(dir, ".git");
+      const stat3 = fs32.statSync(gitPath, { throwIfNoEntry: false });
       if (stat3 && (stat3.isDirectory() || stat3.isFile())) return dir;
     } catch {
     }
-    const parent = path36.dirname(dir);
+    const parent = path39.dirname(dir);
     if (parent === dir) return null;
     dir = parent;
   }
@@ -18389,7 +19110,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;
@@ -18438,14 +19159,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",
@@ -18564,7 +19285,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,
@@ -18625,7 +19346,7 @@ var FileWatcherService = class {
   }
   async emitForFile(absPath, changeType) {
     if (this.stopped) return;
-    const fileDir = path36.dirname(absPath);
+    const fileDir = path39.dirname(absPath);
     let gitRoot = this.gitRootByDir.get(fileDir);
     if (gitRoot === void 0) {
       gitRoot = findGitRoot2(fileDir);
@@ -18638,19 +19359,19 @@ var FileWatcherService = class {
       );
       return;
     }
-    const relPathInRepo = path36.relative(gitRoot, absPath);
+    const relPathInRepo = path39.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 ${path39.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 = path39.relative(this.opts.workingDir, gitRoot);
+    const repoName = path39.basename(gitRoot);
     let diffText = "";
     let fileStatus = "modified";
     if (changeType === "unlink") {
@@ -18825,7 +19546,7 @@ var FileWatcherService = class {
   collectGitignoreFiles(repoRoot, dir, matcher) {
     let entries;
     try {
-      entries = fs30.readdirSync(dir, { withFileTypes: true });
+      entries = fs32.readdirSync(dir, { withFileTypes: true });
     } catch {
       return;
     }
@@ -18834,16 +19555,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 = fs32.readFileSync(path39.join(dir, ".gitignore"), "utf8");
+        const rel = path39.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 "!" + path39.posix.join(rel, trimmed.slice(1));
           }
-          return path36.posix.join(rel, trimmed);
+          return path39.posix.join(rel, trimmed);
         }).join("\n");
         matcher.add(prefixed);
       } catch {
@@ -18852,7 +19573,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 = path39.join(dir, entry.name);
       if (isIgnoredFilePath(childAbs)) continue;
       this.collectGitignoreFiles(repoRoot, childAbs, matcher);
     }
@@ -18986,12 +19707,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 = "";
@@ -19002,13 +19723,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);
       }
     });
   });
@@ -19021,8 +19742,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 path40 = __toESM(require("path"));
 async function collectRepoChangeset(opts) {
   const status2 = await runGit3(opts.repoRoot, ["status", "--porcelain=v1", "-z"]);
   if (status2 === null) return null;
@@ -19102,12 +19823,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 = "";
@@ -19118,22 +19839,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 fs38 = await import("fs/promises");
   const out2 = [];
   await walk(workingDir, 0);
   return out2;
@@ -19141,7 +19862,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 fs38.readdir(dir, { withFileTypes: true });
       entries = dirents.filter((d3) => !d3.name.startsWith(".") || d3.name === ".git").map((d3) => ({ name: d3.name, isDirectory: d3.isDirectory() }));
     } catch {
       return;
@@ -19152,8 +19873,8 @@ async function discoverRepos(workingDir, maxDepth = 4) {
     if (hasGit) {
       out2.push({
         repoRoot: dir,
-        repoPath: path37.relative(workingDir, dir),
-        repoName: path37.basename(dir)
+        repoPath: path40.relative(workingDir, dir),
+        repoName: path40.basename(dir)
       });
       return;
     }
@@ -19161,14 +19882,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(path40.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 fs33 = __toESM(require("fs/promises"));
+var path41 = __toESM(require("path"));
 var import_os7 = require("os");
 var HOME_OUTBOX_DIR = ".codeam/outbox";
 var MAX_AGE_MS = 24 * 60 * 60 * 1e3;
@@ -19201,16 +19922,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 ?? path41.join(homeDir(), HOME_OUTBOX_DIR);
+    this.filePath = path41.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 fs33.mkdir(path41.dirname(this.filePath), { recursive: true });
+    await fs33.appendFile(this.filePath, JSON.stringify(entry) + "\n", "utf8");
     this.backoffIndex = 0;
     if (this.autoSchedule) this.scheduleFlush(0);
   }
@@ -19299,7 +20020,7 @@ var FilesOutbox = class {
   async readAll() {
     let raw = "";
     try {
-      raw = await fs31.readFile(this.filePath, "utf8");
+      raw = await fs33.readFile(this.filePath, "utf8");
     } catch {
       return [];
     }
@@ -19323,12 +20044,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 fs33.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 fs33.writeFile(tmpPath, payload, "utf8");
+    await fs33.rename(tmpPath, this.filePath);
   }
 };
 function applyJitter(ms) {
@@ -19340,13 +20061,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,
@@ -19538,7 +20259,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(
@@ -19546,7 +20267,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 = {
@@ -19554,7 +20275,7 @@ var StreamingState = class {
         questionId: args2.questionId,
         labels: args2.labels,
         optionIdByLabel: args2.optionIdByLabel,
-        resolve: resolve6,
+        resolve: resolve7,
         timeoutTimer
       };
     });
@@ -19586,14 +20307,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];
@@ -19895,6 +20616,7 @@ async function runAcpSession(opts) {
     `adapter handshake ok protocolVersion=${initialize.protocolVersion} sessionId=${acpSessionId.slice(0, 8)}`
   );
   showSuccess(`${opts.agent} online (ACP) \u2014 awaiting prompts from mobile.`);
+  showRelayNotice();
   void publisher.publishOutput({
     type: "agent_banner",
     agentId: opts.agent,
@@ -19948,6 +20670,16 @@ async function runAcpSession(opts) {
   }).catch((err) => {
     log.warn("acpRunner", `fileWatcher.start failed: ${describeError(err)}`);
   });
+  let beads = null;
+  void startBeadsForSession({
+    sessionId: opts.sessionId,
+    pluginId: opts.pluginId,
+    pluginAuthToken: opts.pluginAuthToken,
+    agents: [opts.agent],
+    cwd: opts.cwd
+  }).then((started) => {
+    beads = started;
+  });
   const relay = new CommandRelayService(
     opts.pluginId,
     async (cmd) => {
@@ -19961,7 +20693,8 @@ async function runAcpSession(opts) {
         opts,
         history,
         initialize.agentCapabilities,
-        turnFiles
+        turnFiles,
+        () => beads
       );
     },
     { id: opts.agent, name: opts.agent, displayName: opts.agent }
@@ -19972,6 +20705,7 @@ async function runAcpSession(opts) {
     relay.stop();
     void fileWatcher.stop();
     turnFiles.stop();
+    void beads?.watcher.stop();
     closeAllTerminals();
     await client2.stop();
     process.exit(0);
@@ -19982,8 +20716,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 ?? {});
@@ -20342,11 +21092,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,
@@ -20387,7 +21137,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` /
@@ -20408,14 +21158,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) {
@@ -20431,7 +21181,7 @@ var ChunkEmitter = class {
                   return;
                 }
               }
-              resolve6({ dead: false });
+              resolve7({ dead: false });
             })();
             return;
           }
@@ -20442,7 +21192,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",
@@ -20453,7 +21203,7 @@ var ChunkEmitter = class {
             const delay = 200 * (maxRetries - attemptsLeft + 1);
             setTimeout(() => attempt(attemptsLeft - 1), delay);
           } else {
-            resolve6({ dead: false });
+            resolve7({ dead: false });
           }
         });
       };
@@ -20465,7 +21215,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;
@@ -20489,7 +21239,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 });
         });
       }
     );
@@ -21063,9 +21813,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 fs34 = __toESM(require("fs"));
+var path42 = __toESM(require("path"));
+var os27 = __toESM(require("os"));
 var https7 = __toESM(require("https"));
 var http7 = __toESM(require("http"));
 var import_zod2 = require("zod");
@@ -21079,7 +21829,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)) {
@@ -21092,7 +21842,7 @@ function parseJsonl(filePath) {
   const messages = [];
   let raw;
   try {
-    raw = fs32.readFileSync(filePath, "utf8");
+    raw = fs34.readFileSync(filePath, "utf8");
   } catch (err) {
     if (err.code !== "ENOENT") {
       log.warn("history:parseJsonl", `read failed for ${filePath}`, err);
@@ -21129,9 +21879,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(
       {
@@ -21150,17 +21900,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();
@@ -21227,7 +21977,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) ?? path42.join(os27.homedir(), ".claude", "projects", encodeCwd(this.cwd));
   }
   /** Set the current Claude conversation ID (extracted from /cost command or session start) */
   setCurrentConversationId(id) {
@@ -21239,7 +21989,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 = path42.join(this.projectDir, `${this.currentConversationId}.jsonl`);
     return parseJsonl(filePath).length;
   }
   /**
@@ -21250,7 +22000,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 = path42.join(this.projectDir, `${this.currentConversationId}.jsonl`);
       const messages = parseJsonl(filePath);
       if (messages.length > previousCount) {
         for (let i = messages.length - 1; i >= previousCount; i--) {
@@ -21276,16 +22026,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 = fs34.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 = fs34.statSync(path42.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 = path42.basename(files[0].name, ".jsonl");
       }
     } catch {
     }
@@ -21319,13 +22069,13 @@ var HistoryService = class _HistoryService {
     const cutoff = this.bootTimeMs - _HistoryService.BIRTHTIME_GRACE_MS;
     let entries;
     try {
-      entries = fs32.readdirSync(dir, { withFileTypes: true });
+      entries = fs34.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 = fs34.statSync(path42.join(dir, e.name));
         return { name: e.name, mtime: stat3.mtimeMs, birthtime: stat3.birthtimeMs };
       } catch {
         return { name: e.name, mtime: 0, birthtime: 0 };
@@ -21334,12 +22084,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(path42.join(dir, targetFile));
   }
   extractUsageFromFile(filePath) {
     let raw;
     try {
-      raw = fs32.readFileSync(filePath, "utf8");
+      raw = fs34.readFileSync(filePath, "utf8");
     } catch {
       return null;
     }
@@ -21384,9 +22134,9 @@ var HistoryService = class _HistoryService {
     let totalCost = 0;
     let files;
     try {
-      files = fs32.readdirSync(projectDir).filter((f) => f.endsWith(".jsonl")).filter((f) => {
+      files = fs34.readdirSync(projectDir).filter((f) => f.endsWith(".jsonl")).filter((f) => {
         try {
-          return fs32.statSync(path39.join(projectDir, f)).mtimeMs >= monthStartMs;
+          return fs34.statSync(path42.join(projectDir, f)).mtimeMs >= monthStartMs;
         } catch {
           return false;
         }
@@ -21397,7 +22147,7 @@ var HistoryService = class _HistoryService {
     for (const file of files) {
       let raw;
       try {
-        raw = fs32.readFileSync(path39.join(projectDir, file), "utf8");
+        raw = fs34.readFileSync(path42.join(projectDir, file), "utf8");
       } catch {
         continue;
       }
@@ -21461,7 +22211,7 @@ var HistoryService = class _HistoryService {
    * showing an empty conversation.
    */
   async loadConversation(sessionId) {
-    const filePath = path39.join(this.projectDir, `${sessionId}.jsonl`);
+    const filePath = path42.join(this.projectDir, `${sessionId}.jsonl`);
     const messages = parseJsonl(filePath);
     if (messages.length === 0) return;
     const totalBatches = Math.ceil(messages.length / CONVERSATION_BATCH_SIZE);
@@ -21515,7 +22265,7 @@ var HistoryService = class _HistoryService {
       if (!this.currentConversationId) return 0;
     }
     const sessionId = this.currentConversationId;
-    const filePath = path39.join(this.projectDir, `${sessionId}.jsonl`);
+    const filePath = path42.join(this.projectDir, `${sessionId}.jsonl`);
     const messages = parseJsonl(filePath);
     if (messages.length === 0) return 0;
     const marker = this.lastUploadedUuid.get(sessionId);
@@ -21580,7 +22330,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;
@@ -21591,7 +22341,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",
@@ -21941,13 +22691,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",
@@ -21960,8 +22710,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 {
@@ -22109,6 +22859,7 @@ async function start(requestedAgent) {
     dirtyTracker: dirtyTracker ?? void 0
   }) : null;
   let streamingEmitter = null;
+  let beads = null;
   const agent = new AgentService(
     runtime,
     {
@@ -22125,6 +22876,7 @@ async function start(requestedAgent) {
         relay.stop();
         void fileWatcher?.stop();
         turnFiles?.stop();
+        void beads?.watcher.stop();
         void streamingEmitter?.stop();
         closeAllTerminals();
         cleanupAttachmentTempFiles();
@@ -22158,6 +22910,16 @@ async function start(requestedAgent) {
     await dispatchCommand(ctx, cmd);
   }, runtime.meta);
   ctx.relay = relay;
+  void startBeadsForSession({
+    sessionId: session.id,
+    pluginId,
+    pluginAuthToken: session.pluginAuthToken ?? void 0,
+    agents: [session.agent],
+    cwd
+  }).then((started) => {
+    beads = started;
+    ctx.beads = started;
+  });
   registerTerminalHandlers({
     onData: ({ sessionId, data }) => {
       void outputSvc.sendTerminalChunk(sessionId, data);
@@ -22174,6 +22936,7 @@ async function start(requestedAgent) {
     outputSvc.dispose();
     relay.stop();
     void fileWatcher?.stop();
+    void beads?.watcher.stop();
     void streamingEmitter?.stop();
     closeAllTerminals();
     cleanupAttachmentTempFiles();
@@ -22312,7 +23075,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);
@@ -22360,7 +23123,7 @@ async function pair(args2 = []) {
             pluginAuthToken: info.pluginAuthToken
           });
         }
-        resolve6();
+        resolve7();
       },
       () => {
         clearInterval(countdownInterval);
@@ -22412,8 +23175,8 @@ async function autoLinkAfterPair(opts) {
 }
 
 // src/commands/pair-auto.ts
-var fs33 = __toESM(require("fs"));
-var os27 = __toESM(require("os"));
+var fs35 = __toESM(require("fs"));
+var os28 = __toESM(require("os"));
 var import_crypto7 = require("crypto");
 
 // src/commands/start-infra-only.ts
@@ -22566,7 +23329,7 @@ async function startInfraOnly(agentId) {
 }
 
 // src/commands/pair-auto.ts
-var API_BASE9 = resolveApiBaseUrl();
+var API_BASE10 = resolveApiBaseUrl();
 function fail(msg) {
   console.error(`
   ${msg}
@@ -22581,12 +23344,12 @@ function readTokenFromArgs(args2) {
   }
   const fileFlag = args2.find((a) => a.startsWith("--token-file="));
   if (fileFlag) {
-    const path46 = fileFlag.slice("--token-file=".length);
+    const path49 = 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 = fs35.readFileSync(path49, "utf8").trim();
+      if (content.length === 0) fail(`--token-file ${path49} is empty`);
       try {
-        fs33.unlinkSync(path46);
+        fs35.unlinkSync(path49);
       } catch {
       }
       return content;
@@ -22606,13 +23369,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.
@@ -22809,7 +23572,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([
@@ -22821,7 +23584,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) => {
@@ -22849,11 +23612,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 path43 = __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) {
@@ -22896,12 +23659,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);
@@ -22930,13 +23693,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) {
@@ -23080,10 +23843,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");
@@ -23107,14 +23870,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."
         ));
@@ -23285,13 +24048,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);
     });
   }
@@ -23312,12 +24075,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 = "";
@@ -23332,7 +24095,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}`));
@@ -23341,7 +24104,7 @@ var GitHubCodespacesProvider = class {
     });
   }
   async uploadFile(workspaceId, remotePath, contents, options = {}) {
-    const remoteDir = path40.posix.dirname(remotePath);
+    const remoteDir = path43.posix.dirname(remotePath);
     const parts = [
       `mkdir -p ${shellQuote(remoteDir)}`,
       `cat > ${shellQuote(remotePath)}`
@@ -23350,8 +24113,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"] }
@@ -23362,7 +24125,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);
@@ -23409,11 +24172,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 path44 = __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) {
@@ -23452,10 +24215,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);
@@ -23604,13 +24367,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);
     });
   }
@@ -23624,12 +24387,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"] }
@@ -23645,13 +24408,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 = path44.posix.dirname(remotePath);
     const parts = [
       `mkdir -p ${shellQuote2(remoteDir)}`,
       `cat > ${shellQuote2(remotePath)}`
@@ -23660,8 +24423,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"] }
@@ -23672,7 +24435,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);
@@ -23685,10 +24448,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 path45 = __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() {
@@ -23729,14 +24492,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);
@@ -23901,13 +24664,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);
     });
   }
@@ -23922,9 +24685,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"] }
@@ -23940,21 +24703,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 = path45.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"] }
@@ -23965,7 +24728,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);
@@ -24013,10 +24776,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 path46 = __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) {
@@ -24056,10 +24819,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);
@@ -24199,13 +24962,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);
     });
   }
@@ -24223,9 +24986,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"] }
@@ -24241,7 +25004,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)}`));
       });
     });
@@ -24251,14 +25014,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 = path46.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"] }
@@ -24269,7 +25032,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);
@@ -24794,8 +25557,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 fs36 = __toESM(require("fs"));
+var path47 = __toESM(require("path"));
 var import_picocolors12 = __toESM(require("picocolors"));
 var dnsResolveP = (0, import_node_util4.promisify)(import_node_dns.resolve);
 async function checkDns(apiBase) {
@@ -24851,13 +25614,13 @@ async function checkHealth(apiBase) {
   }
 }
 function checkConfigDir() {
-  const dir = path44.join(require("os").homedir(), ".codeam");
+  const dir = path47.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);
+    fs36.mkdirSync(dir, { recursive: true, mode: 448 });
+    const probe = path47.join(dir, ".doctor-probe");
+    fs36.writeFileSync(probe, "ok", { mode: 384 });
+    const read = fs36.readFileSync(probe, "utf8");
+    fs36.unlinkSync(probe);
     if (read !== "ok") throw new Error("write/read round-trip mismatch");
     return {
       id: "config-dir",
@@ -24897,9 +25660,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})`,
@@ -24921,7 +25684,7 @@ function checkNodePty() {
       detail: "not required on this platform"
     };
   }
-  const vendoredPath = path44.join(__dirname, "vendor", "node-pty");
+  const vendoredPath = path47.join(__dirname, "vendor", "node-pty");
   for (const target of [vendoredPath, "node-pty"]) {
     try {
       require(target);
@@ -24963,7 +25726,7 @@ function checkChokidar() {
 }
 async function doctor(args2 = []) {
   const json = args2.includes("--json");
-  const cliVersion = true ? "2.32.9" : "0.0.0-dev";
+  const cliVersion = true ? "2.33.0" : "0.0.0-dev";
   const apiBase = resolveApiBaseUrl();
   const diagnosticId = (0, import_node_crypto8.randomUUID)();
   log.info("doctor", `run id=${diagnosticId} cli=${cliVersion}`);
@@ -25162,7 +25925,7 @@ async function completion(args2) {
 // src/commands/version.ts
 var import_picocolors13 = __toESM(require("picocolors"));
 function version2() {
-  const v = true ? "2.32.9" : "unknown";
+  const v = true ? "2.33.0" : "unknown";
   console.log(`${import_picocolors13.default.bold("codeam-cli")} ${import_picocolors13.default.cyan(v)}`);
 }
 
@@ -25290,9 +26053,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 fs37 = __toESM(require("fs"));
+var os29 = __toESM(require("os"));
+var path48 = __toESM(require("path"));
 var https8 = __toESM(require("https"));
 var import_node_child_process12 = require("child_process");
 var import_picocolors16 = __toESM(require("picocolors"));
@@ -25301,12 +26064,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 = path48.join(os29.homedir(), ".codeam");
+  return path48.join(dir, "update-check.json");
 }
 function readCache() {
   try {
-    const raw = fs35.readFileSync(cachePath(), "utf8");
+    const raw = fs37.readFileSync(cachePath(), "utf8");
     const parsed = JSON.parse(raw);
     if (typeof parsed.fetchedAt !== "number" || typeof parsed.latest !== "string") return null;
     return parsed;
@@ -25317,10 +26080,10 @@ function readCache() {
 function writeCache(cache) {
   try {
     const file = cachePath();
-    fs35.mkdirSync(path45.dirname(file), { recursive: true });
+    fs37.mkdirSync(path48.dirname(file), { recursive: true });
     const tmp = `${file}.${process.pid}.tmp`;
-    fs35.writeFileSync(tmp, JSON.stringify(cache));
-    fs35.renameSync(tmp, file);
+    fs37.writeFileSync(tmp, JSON.stringify(cache));
+    fs37.renameSync(tmp, file);
   } catch {
   }
 }
@@ -25338,14 +26101,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 = "";
@@ -25357,21 +26120,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) {
@@ -25394,8 +26157,8 @@ function isLinkedInstall() {
       timeout: 2e3
     }).trim();
     if (!root) return false;
-    const pkgPath = path45.join(root, PKG_NAME);
-    return fs35.lstatSync(pkgPath).isSymbolicLink();
+    const pkgPath = path48.join(root, PKG_NAME);
+    return fs37.lstatSync(pkgPath).isSymbolicLink();
   } catch {
     return false;
   }
@@ -25431,7 +26194,7 @@ function maybeAutoUpdate(currentVersion, latest) {
     return;
   }
   try {
-    fs35.unlinkSync(cachePath());
+    fs37.unlinkSync(cachePath());
   } catch {
   }
   process.stderr.write(`  ${import_picocolors16.default.green("\u2713")} Updated. Resuming session...
@@ -25448,7 +26211,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.9" : null;
+  const current = true ? "2.33.0" : null;
   if (!current) return;
   const cache = readCache();
   const fresh = cache && Date.now() - cache.fetchedAt < TTL_MS;