codeam-cli 2.49.5 → 2.51.0

package/dist/index.js

@@ -522,9 +522,9 @@ var _default = makeConfig();
 var { getConfig, ensurePluginId, addSession, removeSession, setActiveSession, getActiveSession, getActiveSessionForAgent, setDisable1mContext, clearAll, saveCliConfig, loadCliConfig } = _default;
 
 // src/commands/pair-auto.ts
-var fs41 = __toESM(require("fs"));
-var os34 = __toESM(require("os"));
-var path47 = __toESM(require("path"));
+var fs42 = __toESM(require("fs"));
+var os35 = __toESM(require("os"));
+var path48 = __toESM(require("path"));
 var import_crypto4 = require("crypto");
 
 // src/services/telemetry.service.ts
@@ -560,8 +560,8 @@ function createGetModuleFromFilename(basePath = process.argv[1] ? (0, import_pat
     return decodedFile;
   };
 }
-function normalizeWindowsPath(path60) {
-  return path60.replace(/^[A-Z]:/, "").replace(/\\/g, "/");
+function normalizeWindowsPath(path61) {
+  return path61.replace(/^[A-Z]:/, "").replace(/\\/g, "/");
 }
 
 // ../../node_modules/@posthog/core/dist/featureFlagUtils.mjs
@@ -3041,9 +3041,9 @@ async function addSourceContext(frames) {
   LRU_FILE_CONTENTS_CACHE.reduce();
   return frames;
 }
-function getContextLinesFromFile(path60, ranges, output) {
+function getContextLinesFromFile(path61, ranges, output) {
   return new Promise((resolve7) => {
-    const stream = (0, import_node_fs.createReadStream)(path60);
+    const stream = (0, import_node_fs.createReadStream)(path61);
     const lineReaded = (0, import_node_readline.createInterface)({
       input: stream
     });
@@ -3058,7 +3058,7 @@ function getContextLinesFromFile(path60, ranges, output) {
     let rangeStart = range[0];
     let rangeEnd = range[1];
     function onStreamError() {
-      LRU_FILE_CONTENTS_FS_READ_FAILED.set(path60, 1);
+      LRU_FILE_CONTENTS_FS_READ_FAILED.set(path61, 1);
       lineReaded.close();
       lineReaded.removeAllListeners();
       destroyStreamAndResolve();
@@ -3119,8 +3119,8 @@ function clearLineContext(frame) {
   delete frame.context_line;
   delete frame.post_context;
 }
-function shouldSkipContextLinesForFile(path60) {
-  return path60.startsWith("node:") || path60.endsWith(".min.js") || path60.endsWith(".min.cjs") || path60.endsWith(".min.mjs") || path60.startsWith("data:");
+function shouldSkipContextLinesForFile(path61) {
+  return path61.startsWith("node:") || path61.endsWith(".min.js") || path61.endsWith(".min.cjs") || path61.endsWith(".min.mjs") || path61.startsWith("data:");
 }
 function shouldSkipContextLinesForFrame(frame) {
   if (void 0 !== frame.lineno && frame.lineno > MAX_CONTEXTLINES_LINENO) return true;
@@ -5397,7 +5397,7 @@ function readAnonId() {
 }
 function superProperties() {
   return {
-    cliVersion: true ? "2.49.5" : "0.0.0-dev",
+    cliVersion: true ? "2.51.0" : "0.0.0-dev",
     nodeVersion: process.version,
     platform: process.platform,
     arch: process.arch,
@@ -5578,7 +5578,7 @@ var os4 = __toESM(require("os"));
 // package.json
 var package_default = {
   name: "codeam-cli",
-  version: "2.49.5",
+  version: "2.51.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",
@@ -5871,6 +5871,28 @@ async function postHeadroomEvent(input) {
     };
   }
 }
+async function postBeadsEvent(input) {
+  try {
+    await _transport.postJsonAuthed(
+      `${API_BASE}/api/beads/events`,
+      {
+        sessionId: input.sessionId,
+        pluginId: input.pluginId,
+        type: input.type,
+        payload: input.payload ?? {}
+      },
+      input.pluginAuthToken
+    );
+    return { ok: true };
+  } catch (err) {
+    const e = err;
+    return {
+      ok: false,
+      status: typeof e.statusCode === "number" ? e.statusCode : 0,
+      message: e.message || "unknown"
+    };
+  }
+}
 async function postBeadsProvisioning(input) {
   try {
     await _transport.postJsonAuthed(
@@ -7706,9 +7728,9 @@ function closeAllTerminals() {
 }
 
 // src/commands/start/handlers.ts
-var fs40 = __toESM(require("fs"));
-var os33 = __toESM(require("os"));
-var path46 = __toESM(require("path"));
+var fs41 = __toESM(require("fs"));
+var os34 = __toESM(require("os"));
+var path47 = __toESM(require("path"));
 var import_crypto3 = require("crypto");
 var import_child_process20 = require("child_process");
 var import_which2 = __toESM(require("which"));
@@ -11142,10 +11164,10 @@ function buildForPlatform(platform3) {
 var import_node_crypto4 = require("crypto");
 
 // src/agents/claude/resolver.ts
-function buildClaudeLaunch(extraArgs = [], os40 = createOsStrategy()) {
-  const found = os40.findInPath("claude") ?? os40.findInPath("claude-code");
+function buildClaudeLaunch(extraArgs = [], os41 = createOsStrategy()) {
+  const found = os41.findInPath("claude") ?? os41.findInPath("claude-code");
   if (!found) return null;
-  return os40.buildLaunch(found, extraArgs);
+  return os41.buildLaunch(found, extraArgs);
 }
 
 // src/agents/claude/installer.ts
@@ -11738,8 +11760,8 @@ var ClaudeRuntimeStrategy = class {
   meta = getAgent("claude");
   mode = "interactive";
   os;
-  constructor(os40) {
-    this.os = os40;
+  constructor(os41) {
+    this.os = os41;
   }
   /**
    * Claude Code's react-ink TUI enables bracketed-paste mode at
@@ -12416,8 +12438,8 @@ function codexCredentialLocator() {
 function codexLoginLauncher() {
   return {
     async ensureInstalled() {
-      const os40 = createOsStrategy();
-      return os40.findInPath("codex") !== null;
+      const os41 = createOsStrategy();
+      return os41.findInPath("codex") !== null;
     },
     launch() {
       return (0, import_node_child_process3.spawn)("codex", ["login"], { stdio: "inherit" });
@@ -12440,8 +12462,8 @@ var CodexRuntimeStrategy = class {
   meta = getAgent("codex");
   mode = "interactive";
   os;
-  constructor(os40) {
-    this.os = os40;
+  constructor(os41) {
+    this.os = os41;
   }
   async prepareLaunch() {
     let binary = this.os.findInPath("codex");
@@ -12540,12 +12562,12 @@ var CodexRuntimeStrategy = class {
     });
   }
 };
-function resolveNpm(os40) {
-  return os40.id === "win32" ? "npm.cmd" : "npm";
+function resolveNpm(os41) {
+  return os41.id === "win32" ? "npm.cmd" : "npm";
 }
-async function installCodexViaNpm(os40) {
+async function installCodexViaNpm(os41) {
   return new Promise((resolve7, reject) => {
-    const proc = (0, import_node_child_process4.spawn)(resolveNpm(os40), ["install", "-g", "@openai/codex"], {
+    const proc = (0, import_node_child_process4.spawn)(resolveNpm(os41), ["install", "-g", "@openai/codex"], {
       stdio: "inherit"
     });
     proc.on("close", (code) => {
@@ -12562,16 +12584,16 @@ async function installCodexViaNpm(os40) {
     });
   });
 }
-function augmentNpmGlobalBin(os40) {
+function augmentNpmGlobalBin(os41) {
   try {
-    const result = (0, import_node_child_process4.spawnSync)(resolveNpm(os40), ["prefix", "-g"], {
+    const result = (0, import_node_child_process4.spawnSync)(resolveNpm(os41), ["prefix", "-g"], {
       stdio: ["ignore", "pipe", "ignore"]
     });
     if (result.status !== 0) return;
     const prefix = result.stdout.toString().trim();
     if (!prefix) return;
-    const binDir = os40.id === "win32" ? prefix : path22.join(prefix, "bin");
-    os40.augmentPath([binDir]);
+    const binDir = os41.id === "win32" ? prefix : path22.join(prefix, "bin");
+    os41.augmentPath([binDir]);
   } catch {
   }
 }
@@ -12655,9 +12677,9 @@ 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(os40) {
-  if (os40.findInPath("coderabbit")) return true;
-  if (os40.id === "win32") {
+async function ensureCoderabbitInstalled(os41) {
+  if (os41.findInPath("coderabbit")) return true;
+  if (os41.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"
     );
@@ -12672,8 +12694,8 @@ async function ensureCoderabbitInstalled(os40) {
     proc.on("error", () => resolve7(false));
   });
   if (!ok) return false;
-  os40.augmentPath([`${os40.homeDir()}/.local/bin`, "/opt/homebrew/bin"]);
-  return os40.findInPath("coderabbit") !== null;
+  os41.augmentPath([`${os41.homeDir()}/.local/bin`, "/opt/homebrew/bin"]);
+  return os41.findInPath("coderabbit") !== null;
 }
 
 // src/agents/coderabbit/link.ts
@@ -12708,10 +12730,10 @@ function coderabbitCredentialLocator() {
     validate: validateNonEmptyCredential
   };
 }
-function coderabbitLoginLauncher(os40) {
+function coderabbitLoginLauncher(os41) {
   return {
     async ensureInstalled() {
-      return ensureCoderabbitInstalled(os40);
+      return ensureCoderabbitInstalled(os41);
     },
     launch() {
       return (0, import_node_child_process6.spawn)("coderabbit", ["login"], { stdio: "inherit" });
@@ -12734,11 +12756,11 @@ function parseReview(stdout) {
   for (const line of lines) {
     const m = line.match(HUNK_LINE_RE);
     if (!m) continue;
-    const [, path60, lineNo, sevToken, message] = m;
-    if (!path60 || !lineNo || !message) continue;
+    const [, path61, lineNo, sevToken, message] = m;
+    if (!path61 || !lineNo || !message) continue;
     const cleanedMessage = message.trim().replace(/^[*-]\s+/, "");
     hunks.push({
-      path: path60.trim(),
+      path: path61.trim(),
       line: Number(lineNo),
       severity: sevToken ? SEVERITY_MAP[sevToken.toLowerCase()] : void 0,
       message: cleanedMessage
@@ -12757,8 +12779,8 @@ var CoderabbitRuntimeStrategy = class {
   meta = getAgent("coderabbit");
   mode = "batch";
   os;
-  constructor(os40) {
-    this.os = os40;
+  constructor(os41) {
+    this.os = os41;
   }
   getDefaultArgs() {
     return ["review"];
@@ -12874,10 +12896,10 @@ function cursorCredentialLocator() {
     validate: validateNonEmptyCredential
   };
 }
-function cursorLoginLauncher(os40) {
+function cursorLoginLauncher(os41) {
   return {
     async ensureInstalled() {
-      if (os40.findInPath("cursor-agent")) return true;
+      if (os41.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"
       );
@@ -12939,8 +12961,8 @@ var CursorRuntimeStrategy = class {
   meta = getAgent("cursor");
   mode = "interactive";
   os;
-  constructor(os40) {
-    this.os = os40;
+  constructor(os41) {
+    this.os = os41;
   }
   async prepareLaunch() {
     const binary = this.os.findInPath("cursor-agent");
@@ -13079,10 +13101,10 @@ function aiderCredentialLocator() {
     validate: validateNonEmptyCredential
   };
 }
-function aiderLoginLauncher(os40) {
+function aiderLoginLauncher(os41) {
   return {
     async ensureInstalled() {
-      if (os40.findInPath("aider")) return true;
+      if (os41.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"
       );
@@ -13092,7 +13114,7 @@ function aiderLoginLauncher(os40) {
       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)(os40.id === "win32" ? "cmd.exe" : "sh", os40.id === "win32" ? ["/c", "exit", "0"] : ["-c", "exit 0"], {
+      return (0, import_node_child_process9.spawn)(os41.id === "win32" ? "cmd.exe" : "sh", os41.id === "win32" ? ["/c", "exit", "0"] : ["-c", "exit 0"], {
         stdio: "ignore"
       });
     }
@@ -13164,8 +13186,8 @@ var AiderRuntimeStrategy = class {
   meta = getAgent("aider");
   mode = "interactive";
   os;
-  constructor(os40) {
-    this.os = os40;
+  constructor(os41) {
+    this.os = os41;
   }
   async prepareLaunch() {
     const binary = this.os.findInPath("aider");
@@ -13294,8 +13316,8 @@ function geminiCredentialLocator() {
 function geminiLoginLauncher() {
   return {
     async ensureInstalled() {
-      const os40 = createOsStrategy();
-      return os40.findInPath("gemini") !== null;
+      const os41 = createOsStrategy();
+      return os41.findInPath("gemini") !== null;
     },
     launch() {
       return (0, import_node_child_process10.spawn)("gemini", ["auth", "login"], { stdio: "inherit" });
@@ -13328,8 +13350,8 @@ var GeminiRuntimeStrategy = class {
   meta = getAgent("gemini");
   mode = "interactive";
   os;
-  constructor(os40) {
-    this.os = os40;
+  constructor(os41) {
+    this.os = os41;
   }
   async prepareLaunch() {
     const binary = this.os.findInPath("gemini");
@@ -13428,18 +13450,18 @@ var GeminiRuntimeStrategy = class {
 
 // src/agents/registry.ts
 var runtimeBuilders = {
-  claude: (os40) => new ClaudeRuntimeStrategy(os40),
-  codex: (os40) => new CodexRuntimeStrategy(os40),
-  coderabbit: (os40) => new CoderabbitRuntimeStrategy(os40),
-  cursor: (os40) => new CursorRuntimeStrategy(os40),
-  aider: (os40) => new AiderRuntimeStrategy(os40),
-  gemini: (os40) => new GeminiRuntimeStrategy(os40)
+  claude: (os41) => new ClaudeRuntimeStrategy(os41),
+  codex: (os41) => new CodexRuntimeStrategy(os41),
+  coderabbit: (os41) => new CoderabbitRuntimeStrategy(os41),
+  cursor: (os41) => new CursorRuntimeStrategy(os41),
+  aider: (os41) => new AiderRuntimeStrategy(os41),
+  gemini: (os41) => new GeminiRuntimeStrategy(os41)
 };
 var deployBuilders = {
   claude: () => new ClaudeDeployStrategy(),
   codex: () => new CodexDeployStrategy()
 };
-function createAgentStrategy(agent, os40 = createOsStrategy()) {
+function createAgentStrategy(agent, os41 = 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'.`
@@ -13449,10 +13471,10 @@ function createAgentStrategy(agent, os40 = createOsStrategy()) {
   if (!build) {
     throw new Error(`No runtime strategy registered for agent "${agent}"`);
   }
-  return build(os40);
+  return build(os41);
 }
-function createInteractiveAgentStrategy(agent, os40 = createOsStrategy()) {
-  const s = createAgentStrategy(agent, os40);
+function createInteractiveAgentStrategy(agent, os41 = createOsStrategy()) {
+  const s = createAgentStrategy(agent, os41);
   if (s.mode !== "interactive") {
     throw new Error(
       `Agent "${agent}" is a batch agent; use createAgentStrategy + .runOneShot for one-shot reviews.`
@@ -14556,6 +14578,14 @@ function mapStatsToSavings(stats, prev, inputPricePerMillion = DEFAULT_INPUT_PRI
   };
   return { next, delta };
 }
+function defaultGetBudgetEnv() {
+  const raw = process.env["HEADROOM_BUDGET"];
+  if (!raw) return null;
+  const budgetUsd = Number(raw);
+  if (!isFinite(budgetUsd) || budgetUsd <= 0) return null;
+  const budgetPeriod = process.env["HEADROOM_BUDGET_PERIOD"] ?? "daily";
+  return { budgetUsd, budgetPeriod };
+}
 var HeadroomStatsReporter = class {
   constructor(deps) {
     this.deps = deps;
@@ -14569,14 +14599,22 @@ var HeadroomStatsReporter = class {
   }
   async tick() {
     try {
+      const stats = await this.deps.fetchStats();
       const { next, delta } = mapStatsToSavings(
-        await this.deps.fetchStats(),
+        stats,
         this.prev,
         this.deps.inputPricePerMillionUsd ?? DEFAULT_INPUT_PRICE_PER_MILLION
       );
       this.prev = next;
       if (delta.compressionTokens > 0 || delta.compressionSavingsUsd > 0 || delta.rawTokensEst > 0 || delta.cacheReadTokens > 0 || delta.cacheSavingsUsd > 0) {
-        await this.deps.postSavings(delta);
+        const getBudgetEnv = this.deps.getBudgetEnv ?? defaultGetBudgetEnv;
+        const budgetEnv = getBudgetEnv();
+        const budget = budgetEnv ? {
+          periodSpendUsd: stats.cost?.cost_with_headroom_usd ?? 0,
+          budgetUsd: budgetEnv.budgetUsd,
+          budgetPeriod: budgetEnv.budgetPeriod
+        } : void 0;
+        await this.deps.postSavings(delta, budget);
       }
     } catch {
     }
@@ -14589,6 +14627,14 @@ var HeadroomStatsReporter = class {
   }
 };
 
+// src/services/headroom/budget-args.ts
+function buildBudgetProxyArgs(env) {
+  const budget = env["HEADROOM_BUDGET"];
+  if (!budget) return [];
+  const period = env["HEADROOM_BUDGET_PERIOD"] ?? "daily";
+  return ["--budget", budget, "--budget-period", period];
+}
+
 // src/lib/updateNotifier.ts
 var fs30 = __toESM(require("fs"));
 var os27 = __toESM(require("os"));
@@ -14747,7 +14793,7 @@ async function autoUpgradeBeforeCriticalCommand() {
   if (process.env.NODE_ENV === "test") return;
   if (process.env.CODEAM_DISABLE_UPDATE_CHECK === "1") return;
   if (process.env.CI) return;
-  const current = true ? "2.49.5" : null;
+  const current = true ? "2.51.0" : null;
   if (!current) return;
   const cache = readCache();
   const fresh = cache && Date.now() - cache.fetchedAt < TTL_MS;
@@ -14764,7 +14810,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.49.5" : null;
+  const current = true ? "2.51.0" : null;
   if (!current) return;
   const cache = readCache();
   const fresh = cache && Date.now() - cache.fetchedAt < TTL_MS;
@@ -14801,7 +14847,7 @@ function maybeStartHeadroomReporter(ctx) {
         const res = await fetch("http://localhost:8787/stats");
         return res.json();
       },
-      postSavings: async (delta) => {
+      postSavings: async (delta, budget) => {
         await fetch(ingestUrl, {
           method: "POST",
           headers: {
@@ -14812,7 +14858,12 @@ function maybeStartHeadroomReporter(ctx) {
             sessionId: ctx.sessionId,
             pluginId: ctx.pluginId,
             agentId: process.env["HEADROOM_AGENT"] ?? "claude",
-            savings: delta
+            savings: delta,
+            ...budget ? {
+              periodSpendUsd: budget.periodSpendUsd,
+              budgetUsd: budget.budgetUsd,
+              budgetPeriod: budget.budgetPeriod
+            } : {}
           })
         });
       }
@@ -14845,7 +14896,7 @@ function maybeResumeLocalHeadroomReporter(ctx) {
       // Body MUST match HeadroomSavingsDto + PluginAuthGuard (sessionId +
       // pluginId in the body) — same shape as the codespace reporter above and
       // the on-demand `startReporter` in handlers.ts.
-      postSavings: async (delta) => {
+      postSavings: async (delta, budget) => {
         await fetch(ingestUrl, {
           method: "POST",
           headers: {
@@ -14856,7 +14907,12 @@ function maybeResumeLocalHeadroomReporter(ctx) {
             sessionId: ctx.sessionId,
             pluginId: ctx.pluginId,
             agentId: agent,
-            savings: delta
+            savings: delta,
+            ...budget ? {
+              periodSpendUsd: budget.periodSpendUsd,
+              budgetUsd: budget.budgetUsd,
+              budgetPeriod: budget.budgetPeriod
+            } : {}
           })
         });
       }
@@ -15157,11 +15213,16 @@ function readHeadroomChildEnv() {
     if (typeof parsed !== "object" || parsed === null) return {};
     const o = parsed;
     if (o.enabled === true && typeof o.agent === "string" && o.agent.length > 0 && typeof o.ingestUrl === "string" && o.ingestUrl.length > 0) {
-      return {
+      const env = {
         HEADROOM_ENABLED: "1",
         HEADROOM_AGENT: o.agent,
         HEADROOM_SAVINGS_INGEST_URL: o.ingestUrl
       };
+      if (o.budgetEnabled === true && typeof o.budgetUsd === "number") {
+        env["HEADROOM_BUDGET"] = String(o.budgetUsd);
+        env["HEADROOM_BUDGET_PERIOD"] = typeof o.budgetPeriod === "string" ? o.budgetPeriod : "daily";
+      }
+      return env;
     }
     return {};
   } catch {
@@ -15417,11 +15478,16 @@ async function setupHeadroomForSelfHosted(agent, runner = defaultHeadroomRunner,
   }
   onProgress("proxy");
   try {
-    const proxy = (0, import_node_child_process14.spawn)("headroom", ["proxy", "--port", "8787"], {
-      stdio: "ignore",
-      detached: true,
-      env: { ...process.env, HEADROOM_KOMPRESS_BACKEND: "onnx_cpu" }
-    });
+    const proxyEnv = { ...process.env, HEADROOM_KOMPRESS_BACKEND: "onnx_cpu" };
+    const proxy = (0, import_node_child_process14.spawn)(
+      "headroom",
+      ["proxy", "--port", "8787", ...buildBudgetProxyArgs(proxyEnv)],
+      {
+        stdio: "ignore",
+        detached: true,
+        env: proxyEnv
+      }
+    );
     proxy.once("error", (e) => {
       log.warn(
         "host-agent",
@@ -15445,7 +15511,7 @@ var defaultSpawner = (env, cwd, args2 = []) => (0, import_node_child_process14.s
   detached: false
 });
 function currentCliVersion() {
-  return true ? "2.49.5" : null;
+  return true ? "2.51.0" : null;
 }
 function runCmd(cmd, args2, timeoutMs) {
   return new Promise((resolve7) => {
@@ -17126,11 +17192,11 @@ function resolveDoltInstallStrategy(platform3) {
 }
 var DOLT_RELEASE_BASE = "https://github.com/dolthub/dolt/releases/latest/download";
 function doltPlatformTuple(platform3, arch2) {
-  const os40 = platform3 === "win32" ? "windows" : platform3 === "darwin" ? "darwin" : "linux";
+  const os41 = platform3 === "win32" ? "windows" : platform3 === "darwin" ? "darwin" : "linux";
   const a = arch2 === "x64" ? "amd64" : arch2 === "arm64" ? "arm64" : null;
   if (!a) return null;
-  if (os40 === "windows" && a !== "amd64") return null;
-  return `${os40}-${a}`;
+  if (os41 === "windows" && a !== "amd64") return null;
+  return `${os41}-${a}`;
 }
 function resolveDoltTarballStrategy(targetDir, platform3, arch2) {
   const tuple = doltPlatformTuple(platform3, arch2);
@@ -18009,6 +18075,30 @@ async function handleBeadsActionCommand(action, started) {
   });
 }
 
+// src/beads/config-store.ts
+var import_node_fs5 = __toESM(require("fs"));
+var import_node_os3 = __toESM(require("os"));
+var import_node_path4 = __toESM(require("path"));
+function beadsConfigPath() {
+  return import_node_path4.default.join(import_node_os3.default.homedir(), ".codeam", "beads-config.json");
+}
+function readBeadsEnabled() {
+  try {
+    const raw = import_node_fs5.default.readFileSync(beadsConfigPath(), "utf8");
+    const cfg = JSON.parse(raw);
+    return cfg.enabled !== false;
+  } catch {
+    return true;
+  }
+}
+function persistBeadsConfig(cfg) {
+  const file = beadsConfigPath();
+  import_node_fs5.default.mkdirSync(import_node_path4.default.dirname(file), { recursive: true });
+  const tmp = `${file}.tmp`;
+  import_node_fs5.default.writeFileSync(tmp, JSON.stringify(cfg), { mode: 384 });
+  import_node_fs5.default.renameSync(tmp, file);
+}
+
 // src/beads/wiring.ts
 function beadsKilled() {
   const v = process.env.CODEAM_BEADS_DISABLED;
@@ -18019,6 +18109,10 @@ async function provisionBeadsForStart(ctx) {
     log.trace("beads", "CODEAM_BEADS_DISABLED set \u2014 beads off this run");
     return null;
   }
+  if (readBeadsEnabled() === false) {
+    log.trace("beads", "beads disabled by persisted config \u2014 beads off this run");
+    return null;
+  }
   delete process.env.BEADS_DIR;
   process.env.BEADS_DOLT_SHARED_SERVER = "1";
   if (!ctx.pluginAuthToken) {
@@ -18079,12 +18173,69 @@ function beadsActionFromPayload(payload) {
   };
 }
 
+// src/beads/configure.ts
+var _probeSeam = {
+  resolveBd: (cwd) => new BdAdapter({ cwd }).isAvailable(),
+  doltOnPath: () => ensureDoltResolvable(),
+  ping: async (cwd) => {
+    const adapter = new BdAdapter({ cwd });
+    if (!adapter.isAvailable()) return false;
+    const r = await adapter.run(["ping"]);
+    return r.code === 0;
+  },
+  derivePrefix: (cwd) => {
+    try {
+      const { projectKey } = deriveProjectIdentity(cwd);
+      return prefixForProjectKey(projectKey);
+    } catch {
+      return null;
+    }
+  }
+};
+async function probeBeadsStatus(cwd = process.cwd()) {
+  const bdAvailable = _probeSeam.resolveBd(cwd);
+  const doltAvailable = _probeSeam.doltOnPath();
+  const serverUp = bdAvailable && doltAvailable ? await _probeSeam.ping(cwd) : false;
+  const prefix = _probeSeam.derivePrefix(cwd);
+  return { bdAvailable, doltAvailable, serverUp, prefix };
+}
+async function configureBeads(action, ctx, deps) {
+  if (action === "status") {
+    if (deps.readEnabled() === false) {
+      deps.emit({ type: "beads_status", state: "disabled", running: false });
+      return { enabled: false, running: false };
+    }
+    const p3 = await deps.probe();
+    const running2 = p3.serverUp && p3.bdAvailable;
+    deps.emit({ type: "beads_status", state: running2 ? "enabled" : "disabled", running: running2, ...p3 });
+    return { enabled: running2, running: running2, ...p3 };
+  }
+  if (action === "disable") {
+    deps.persist({ enabled: false });
+    await deps.stopWatcher().catch(() => void 0);
+    await deps.revertAgentHook(ctx.agent).catch(() => void 0);
+    deps.emit({ type: "beads_status", state: "disabled" });
+    return { enabled: false };
+  }
+  deps.persist({ enabled: true });
+  deps.emit({ type: "beads_status", state: "provisioning" });
+  const p2 = await deps.provision();
+  if (!p2.serverUp || !p2.bdAvailable) {
+    deps.emit({ type: "beads_status", state: "error", error: "Beads provisioning failed", ...p2 });
+    return { enabled: false, ...p2 };
+  }
+  await deps.startWatcher().catch(() => void 0);
+  const running = true;
+  deps.emit({ type: "beads_status", state: "enabled", running, ...p2 });
+  return { enabled: true, running, ...p2 };
+}
+
 // src/commands/start/handlers.ts
 var pendingAttachmentFiles = /* @__PURE__ */ new Set();
 function cleanupAttachmentTempFiles() {
   for (const p2 of pendingAttachmentFiles) {
     try {
-      fs40.unlinkSync(p2);
+      fs41.unlinkSync(p2);
     } catch {
     }
   }
@@ -18093,8 +18244,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 = path46.join(os33.tmpdir(), `codeam-${(0, import_crypto3.randomUUID)()}-${safeName}`);
-    fs40.writeFileSync(tmpPath, Buffer.from(base64, "base64"));
+    const tmpPath = path47.join(os34.tmpdir(), `codeam-${(0, import_crypto3.randomUUID)()}-${safeName}`);
+    fs41.writeFileSync(tmpPath, Buffer.from(base64, "base64"));
     pendingAttachmentFiles.add(tmpPath);
     return tmpPath;
   });
@@ -18114,7 +18265,7 @@ var startTask = (ctx, _cmd, parsed) => {
     setTimeout(() => {
       for (const p2 of paths) {
         try {
-          fs40.unlinkSync(p2);
+          fs41.unlinkSync(p2);
         } catch {
         }
         pendingAttachmentFiles.delete(p2);
@@ -18315,9 +18466,9 @@ var listFiles = async (ctx, cmd, parsed) => {
   await ctx.relay.sendResult(cmd.id, "completed", result);
 };
 var envReadH = async (ctx, cmd) => {
-  const envPath = path46.join(process.cwd(), ".env");
+  const envPath = path47.join(process.cwd(), ".env");
   try {
-    const raw = await fs40.promises.readFile(envPath, "utf8");
+    const raw = await fs41.promises.readFile(envPath, "utf8");
     await ctx.relay.sendResult(cmd.id, "completed", {
       exists: true,
       vars: parseDotenv(raw)
@@ -18348,14 +18499,14 @@ var envWriteH = async (ctx, cmd, parsed) => {
     }
     seen.add(v.key);
   }
-  const envPath = path46.join(process.cwd(), ".env");
-  const tmpPath = path46.join(process.cwd(), ".env.codeam.tmp");
+  const envPath = path47.join(process.cwd(), ".env");
+  const tmpPath = path47.join(process.cwd(), ".env.codeam.tmp");
   try {
-    await fs40.promises.writeFile(tmpPath, serializeDotenv(vars), "utf8");
-    await fs40.promises.rename(tmpPath, envPath);
+    await fs41.promises.writeFile(tmpPath, serializeDotenv(vars), "utf8");
+    await fs41.promises.rename(tmpPath, envPath);
     await ctx.relay.sendResult(cmd.id, "completed", { ok: true, count: vars.length });
   } catch (err) {
-    await fs40.promises.rm(tmpPath, { force: true }).catch(() => void 0);
+    await fs41.promises.rm(tmpPath, { force: true }).catch(() => void 0);
     await ctx.relay.sendResult(cmd.id, "failed", { error: err.message });
   }
 };
@@ -18373,7 +18524,7 @@ var headroomConfigureH = async (ctx, cmd, parsed) => {
   let configuredAgent = rawAgentId;
   if (!configuredAgent) {
     try {
-      const raw = JSON.parse(fs40.readFileSync(headroomConfigPath(), "utf8"));
+      const raw = JSON.parse(fs41.readFileSync(headroomConfigPath(), "utf8"));
       configuredAgent = raw.agent ?? "";
     } catch {
     }
@@ -18407,7 +18558,7 @@ var headroomConfigureH = async (ctx, cmd, parsed) => {
     persist: persistHeadroomConfig,
     readEnabled: () => {
       try {
-        const raw = JSON.parse(fs40.readFileSync(headroomConfigPath(), "utf8"));
+        const raw = JSON.parse(fs41.readFileSync(headroomConfigPath(), "utf8"));
         return raw.enabled === true;
       } catch {
         return false;
@@ -18420,7 +18571,7 @@ var headroomConfigureH = async (ctx, cmd, parsed) => {
           const res = await fetch("http://localhost:8787/stats");
           return res.json();
         },
-        postSavings: async (delta) => {
+        postSavings: async (delta, budget) => {
           if (!opts.ingestUrl) return;
           await fetch(opts.ingestUrl, {
             method: "POST",
@@ -18439,7 +18590,12 @@ var headroomConfigureH = async (ctx, cmd, parsed) => {
               sessionId: ctx.sessionId,
               pluginId: ctx.pluginId,
               agentId: opts.agent,
-              savings: delta
+              savings: delta,
+              ...budget ? {
+                periodSpendUsd: budget.periodSpendUsd,
+                budgetUsd: budget.budgetUsd,
+                budgetPeriod: budget.budgetPeriod
+              } : {}
             })
           });
         }
@@ -18480,6 +18636,148 @@ var headroomConfigureH = async (ctx, cmd, parsed) => {
   });
   await ctx.relay.sendResult(cmd.id, "completed", result);
 };
+var headroomBudgetH = async (ctx, cmd) => {
+  const payload = cmd.payload;
+  let rawAgentId = ctx.agentId || (typeof payload.agentId === "string" ? payload.agentId : "");
+  if (rawAgentId === "claude_code") rawAgentId = "claude";
+  let payloadAgentId = typeof payload.agentId === "string" ? payload.agentId : "";
+  if (payloadAgentId === "claude_code") payloadAgentId = "claude";
+  if (!rawAgentId || !isHeadroomSupportedAgent(rawAgentId)) {
+    await ctx.relay.sendResult(cmd.id, "completed", { applied: false });
+    return;
+  }
+  if (!payloadAgentId || payloadAgentId !== rawAgentId) {
+    await ctx.relay.sendResult(cmd.id, "completed", { applied: false });
+    return;
+  }
+  let headroomActive = false;
+  try {
+    const raw = JSON.parse(fs41.readFileSync(headroomConfigPath(), "utf8"));
+    headroomActive = raw.enabled === true;
+  } catch {
+  }
+  if (!headroomActive) {
+    await ctx.relay.sendResult(cmd.id, "completed", { applied: false });
+    return;
+  }
+  let existingConfig = { enabled: true };
+  try {
+    existingConfig = JSON.parse(fs41.readFileSync(headroomConfigPath(), "utf8"));
+  } catch {
+  }
+  if (payload.budgetEnabled && payload.budgetUsd != null) {
+    persistHeadroomConfig({
+      ...existingConfig,
+      enabled: existingConfig.enabled ?? true,
+      budgetEnabled: true,
+      budgetUsd: payload.budgetUsd,
+      budgetPeriod: payload.budgetPeriod ?? "daily"
+    });
+    process.env["HEADROOM_BUDGET"] = String(payload.budgetUsd);
+    process.env["HEADROOM_BUDGET_PERIOD"] = payload.budgetPeriod ?? "daily";
+  } else {
+    persistHeadroomConfig({
+      ...existingConfig,
+      enabled: existingConfig.enabled ?? true,
+      budgetEnabled: false,
+      budgetUsd: void 0,
+      budgetPeriod: void 0
+    });
+    delete process.env["HEADROOM_BUDGET"];
+    delete process.env["HEADROOM_BUDGET_PERIOD"];
+  }
+  try {
+    const killer = (0, import_child_process20.spawn)("pkill", ["-TERM", "-f", "headroom.*proxy"], {
+      detached: true,
+      stdio: "ignore"
+    });
+    killer.once("error", () => {
+    });
+    killer.unref();
+  } catch {
+  }
+  try {
+    const proxyEnv = { ...process.env, HEADROOM_KOMPRESS_BACKEND: "onnx_cpu" };
+    const proxy = (0, import_child_process20.spawn)(
+      "headroom",
+      ["proxy", "--port", "8787", ...buildBudgetProxyArgs(proxyEnv)],
+      {
+        stdio: "ignore",
+        detached: true,
+        env: proxyEnv
+      }
+    );
+    proxy.once("error", (e) => {
+      log.warn("headroom-budget", `proxy relaunch error (best-effort): ${e.message}`);
+    });
+    proxy.unref();
+  } catch (e) {
+    log.warn(
+      "headroom-budget",
+      `proxy relaunch failed (best-effort): ${e instanceof Error ? e.message : String(e)}`
+    );
+  }
+  await ctx.relay.sendResult(cmd.id, "completed", { applied: true });
+};
+var _beadsEmitChain = Promise.resolve();
+var beadsConfigureH = async (ctx, cmd, parsed) => {
+  const action = parsed.action;
+  if (action !== "enable" && action !== "disable" && action !== "status") {
+    await ctx.relay.sendResult(cmd.id, "failed", { error: "action must be enable|disable|status" });
+    return;
+  }
+  let rawAgentId = ctx.agentId || (typeof parsed.agentId === "string" ? parsed.agentId : "");
+  if (rawAgentId === "claude_code") rawAgentId = "claude";
+  const agentIds = rawAgentId && isKnownAgentId(rawAgentId) ? [rawAgentId] : [];
+  const deps = {
+    provision: async () => {
+      const r = await provisionBeads({ cwd: process.cwd(), agents: agentIds });
+      return { bdAvailable: r.bdAvailable, doltAvailable: r.doltAvailable, serverUp: r.serverUp, prefix: r.prefix };
+    },
+    probe: async () => probeBeadsStatus(process.cwd()),
+    startWatcher: async () => {
+      if (!ctx.pluginAuthToken) return;
+      const started = await startBeads({
+        sessionId: ctx.sessionId,
+        pluginId: ctx.pluginId,
+        pluginAuthToken: ctx.pluginAuthToken,
+        cwd: process.cwd(),
+        agents: agentIds
+      });
+      if (started) {
+        ctx.beads = started;
+      }
+    },
+    stopWatcher: async () => {
+      if (ctx.beads) {
+        await ctx.beads.watcher.stop();
+        ctx.beads = null;
+      }
+    },
+    revertAgentHook: async (agent) => {
+      log.info("beads", `revertAgentHook: bd has no --remove flag \u2014 leaving ${agent} hook in place (no-op disable path)`);
+    },
+    persist: (cfg) => persistBeadsConfig(cfg),
+    readEnabled: () => readBeadsEnabled(),
+    emit: (event) => {
+      const token = ctx.pluginAuthToken;
+      if (!token) return;
+      _beadsEmitChain = _beadsEmitChain.then(
+        () => postBeadsEvent({
+          sessionId: ctx.sessionId,
+          pluginId: ctx.pluginId,
+          pluginAuthToken: token,
+          type: "beads_status",
+          payload: Object.fromEntries(
+            Object.entries(event).filter(([k2]) => k2 !== "type")
+          )
+        })
+      );
+    }
+  };
+  const result = await configureBeads(action, { agent: rawAgentId, cwd: process.cwd(), pluginAuthToken: ctx.pluginAuthToken }, deps);
+  await ctx.relay.sendResult(cmd.id, "completed", result);
+};
 var terminalOpenH = async (ctx, cmd, parsed) => {
   const r = openTerminal({
     cols: typeof parsed.cols === "number" ? parsed.cols : void 0,
@@ -18916,8 +19214,8 @@ function normalizeDetectionForSpawn(detection, cwd) {
   if (args2.length === 0) return detection;
   const binName = args2[0];
   if (binName.startsWith("-")) return detection;
-  const binPath = path46.join(cwd, "node_modules", ".bin", binName);
-  if (!fs40.existsSync(binPath)) return detection;
+  const binPath = path47.join(cwd, "node_modules", ".bin", binName);
+  if (!fs41.existsSync(binPath)) return detection;
   return {
     ...detection,
     command: binPath,
@@ -19465,7 +19763,9 @@ var handlers = {
   save_preview_config: savePreviewConfigH,
   env_read: envReadH,
   env_write: envWriteH,
-  headroom_configure: headroomConfigureH
+  headroom_configure: headroomConfigureH,
+  headroom_budget: headroomBudgetH,
+  beads_configure: beadsConfigureH
 };
 async function dispatchCommand(ctx, cmd) {
   if (cmd.type === "beads_action") {
@@ -19733,12 +20033,12 @@ function readTokenFromArgs(args2) {
   }
   const fileFlag = args2.find((a) => a.startsWith("--token-file="));
   if (fileFlag) {
-    const path60 = fileFlag.slice("--token-file=".length);
+    const path61 = fileFlag.slice("--token-file=".length);
     try {
-      const content = fs41.readFileSync(path60, "utf8").trim();
-      if (content.length === 0) fail(`--token-file ${path60} is empty`);
+      const content = fs42.readFileSync(path61, "utf8").trim();
+      if (content.length === 0) fail(`--token-file ${path61} is empty`);
       try {
-        fs41.unlinkSync(path60);
+        fs42.unlinkSync(path61);
       } catch {
       }
       return content;
@@ -19764,7 +20064,7 @@ async function claimOnce(token, pluginId, pluginSecretHash) {
     pluginId,
     ideName: "codeam-cli (codespace)",
     ideVersion: process.env.npm_package_version ?? "unknown",
-    hostname: os34.hostname(),
+    hostname: os35.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.
@@ -19825,7 +20125,7 @@ async function claim(token, pluginId, pluginSecretHash) {
   }
 }
 function pairAutoLockPath() {
-  return path47.join(os34.homedir(), ".codeam", "pair-auto.lock");
+  return path48.join(os35.homedir(), ".codeam", "pair-auto.lock");
 }
 function isLivePairAuto(pid) {
   if (!Number.isInteger(pid) || pid <= 0 || pid === process.pid) return false;
@@ -19835,7 +20135,7 @@ function isLivePairAuto(pid) {
     if (e.code !== "EPERM") return false;
   }
   try {
-    return fs41.readFileSync(`/proc/${pid}/cmdline`, "utf8").includes("codeam");
+    return fs42.readFileSync(`/proc/${pid}/cmdline`, "utf8").includes("codeam");
   } catch {
     return true;
   }
@@ -19845,24 +20145,24 @@ function isLiveCodeam(pid) {
 }
 function daemonLockPath(sessionId) {
   const safe = sessionId.replace(/[^a-zA-Z0-9_-]/g, "_");
-  return path47.join(os34.homedir(), ".codeam", `daemon-${safe}.lock`);
+  return path48.join(os35.homedir(), ".codeam", `daemon-${safe}.lock`);
 }
 function acquireDaemonLock(sessionId) {
   const lockPath = daemonLockPath(sessionId);
   try {
-    fs41.mkdirSync(path47.dirname(lockPath), { recursive: true });
+    fs42.mkdirSync(path48.dirname(lockPath), { recursive: true });
     try {
-      fs41.writeFileSync(lockPath, String(process.pid), { flag: "wx" });
+      fs42.writeFileSync(lockPath, String(process.pid), { flag: "wx" });
     } catch (e) {
       if (e.code !== "EEXIST") throw e;
-      const holder = Number(fs41.readFileSync(lockPath, "utf8").trim());
+      const holder = Number(fs42.readFileSync(lockPath, "utf8").trim());
       if (holder && holder !== process.pid && isLiveCodeam(holder)) return false;
-      fs41.writeFileSync(lockPath, String(process.pid));
+      fs42.writeFileSync(lockPath, String(process.pid));
     }
     const release3 = () => {
       try {
-        if (fs41.existsSync(lockPath) && Number(fs41.readFileSync(lockPath, "utf8").trim()) === process.pid) {
-          fs41.unlinkSync(lockPath);
+        if (fs42.existsSync(lockPath) && Number(fs42.readFileSync(lockPath, "utf8").trim()) === process.pid) {
+          fs42.unlinkSync(lockPath);
         }
       } catch {
       }
@@ -19884,19 +20184,19 @@ function acquireDaemonLock(sessionId) {
 function acquireSingletonLock() {
   const lockPath = pairAutoLockPath();
   try {
-    fs41.mkdirSync(path47.dirname(lockPath), { recursive: true });
+    fs42.mkdirSync(path48.dirname(lockPath), { recursive: true });
     try {
-      fs41.writeFileSync(lockPath, String(process.pid), { flag: "wx" });
+      fs42.writeFileSync(lockPath, String(process.pid), { flag: "wx" });
     } catch (e) {
       if (e.code !== "EEXIST") throw e;
-      const holder = Number(fs41.readFileSync(lockPath, "utf8").trim());
+      const holder = Number(fs42.readFileSync(lockPath, "utf8").trim());
       if (isLivePairAuto(holder)) return false;
-      fs41.writeFileSync(lockPath, String(process.pid));
+      fs42.writeFileSync(lockPath, String(process.pid));
     }
     process.once("exit", () => {
       try {
-        if (fs41.existsSync(lockPath) && Number(fs41.readFileSync(lockPath, "utf8").trim()) === process.pid) {
-          fs41.unlinkSync(lockPath);
+        if (fs42.existsSync(lockPath) && Number(fs42.readFileSync(lockPath, "utf8").trim()) === process.pid) {
+          fs42.unlinkSync(lockPath);
         }
       } catch {
       }
@@ -20341,19 +20641,19 @@ var AgentService = class _AgentService {
 };
 
 // src/agents/acp/adapters.ts
-var path48 = __toESM(require("path"));
+var path49 = __toESM(require("path"));
 var require_ = require;
 function resolveBin(pkgName, binName) {
   try {
     const manifestPath = require_.resolve(`${pkgName}/package.json`);
     const manifest = require_(`${pkgName}/package.json`);
-    const pkgDir = path48.dirname(manifestPath);
+    const pkgDir = path49.dirname(manifestPath);
     const bin = manifest.bin;
     if (!bin) return null;
-    if (typeof bin === "string") return path48.resolve(pkgDir, bin);
+    if (typeof bin === "string") return path49.resolve(pkgDir, bin);
     const target = binName ?? Object.keys(bin)[0];
     if (!target || !bin[target]) return null;
-    return path48.resolve(pkgDir, bin[target]);
+    return path49.resolve(pkgDir, bin[target]);
   } catch {
     return null;
   }
@@ -20423,9 +20723,9 @@ function requiresAcp(agent) {
 var import_node_crypto7 = require("crypto");
 
 // src/services/history.service.ts
-var fs42 = __toESM(require("fs"));
-var path49 = __toESM(require("path"));
-var os35 = __toESM(require("os"));
+var fs43 = __toESM(require("fs"));
+var path50 = __toESM(require("path"));
+var os36 = __toESM(require("os"));
 var https7 = __toESM(require("https"));
 var http6 = __toESM(require("http"));
 var import_zod2 = require("zod");
@@ -20452,7 +20752,7 @@ function parseJsonl(filePath) {
   const messages = [];
   let raw;
   try {
-    raw = fs42.readFileSync(filePath, "utf8");
+    raw = fs43.readFileSync(filePath, "utf8");
   } catch (err) {
     if (err.code !== "ENOENT") {
       log.warn("history:parseJsonl", `read failed for ${filePath}`, err);
@@ -20593,7 +20893,7 @@ var HistoryService = class _HistoryService {
     return this._quotaPercent === null || Date.now() - this._quotaFetchedAt > ttlMs;
   }
   get projectDir() {
-    return this.runtime.resolveHistoryDir(this.cwd) ?? path49.join(os35.homedir(), ".claude", "projects", encodeCwd(this.cwd));
+    return this.runtime.resolveHistoryDir(this.cwd) ?? path50.join(os36.homedir(), ".claude", "projects", encodeCwd(this.cwd));
   }
   /** Set the current Claude conversation ID (extracted from /cost command or session start) */
   setCurrentConversationId(id) {
@@ -20605,7 +20905,7 @@ var HistoryService = class _HistoryService {
   /** Return the current message count in the active conversation. */
   getCurrentMessageCount() {
     if (!this.currentConversationId) return 0;
-    const filePath = path49.join(this.projectDir, `${this.currentConversationId}.jsonl`);
+    const filePath = path50.join(this.projectDir, `${this.currentConversationId}.jsonl`);
     return parseJsonl(filePath).length;
   }
   /**
@@ -20616,7 +20916,7 @@ var HistoryService = class _HistoryService {
     const deadline = Date.now() + timeoutMs;
     while (Date.now() < deadline) {
       if (!this.currentConversationId) return null;
-      const filePath = path49.join(this.projectDir, `${this.currentConversationId}.jsonl`);
+      const filePath = path50.join(this.projectDir, `${this.currentConversationId}.jsonl`);
       const messages = parseJsonl(filePath);
       if (messages.length > previousCount) {
         for (let i = messages.length - 1; i >= previousCount; i--) {
@@ -20642,16 +20942,16 @@ var HistoryService = class _HistoryService {
     const dir = this.projectDir;
     const cutoff = this.bootTimeMs - _HistoryService.BIRTHTIME_GRACE_MS;
     try {
-      const files = fs42.readdirSync(dir, { withFileTypes: true }).filter((e) => e.isFile() && e.name.endsWith(".jsonl")).map((e) => {
+      const files = fs43.readdirSync(dir, { withFileTypes: true }).filter((e) => e.isFile() && e.name.endsWith(".jsonl")).map((e) => {
         try {
-          const stat3 = fs42.statSync(path49.join(dir, e.name));
+          const stat3 = fs43.statSync(path50.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 = path49.basename(files[0].name, ".jsonl");
+        this.currentConversationId = path50.basename(files[0].name, ".jsonl");
       }
     } catch {
     }
@@ -20685,13 +20985,13 @@ var HistoryService = class _HistoryService {
     const cutoff = this.bootTimeMs - _HistoryService.BIRTHTIME_GRACE_MS;
     let entries;
     try {
-      entries = fs42.readdirSync(dir, { withFileTypes: true });
+      entries = fs43.readdirSync(dir, { withFileTypes: true });
     } catch {
       return null;
     }
     const files = entries.filter((e) => e.isFile() && e.name.endsWith(".jsonl")).map((e) => {
       try {
-        const stat3 = fs42.statSync(path49.join(dir, e.name));
+        const stat3 = fs43.statSync(path50.join(dir, e.name));
         return { name: e.name, mtime: stat3.mtimeMs, birthtime: stat3.birthtimeMs };
       } catch {
         return { name: e.name, mtime: 0, birthtime: 0 };
@@ -20700,12 +21000,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(path49.join(dir, targetFile));
+    return this.extractUsageFromFile(path50.join(dir, targetFile));
   }
   extractUsageFromFile(filePath) {
     let raw;
     try {
-      raw = fs42.readFileSync(filePath, "utf8");
+      raw = fs43.readFileSync(filePath, "utf8");
     } catch {
       return null;
     }
@@ -20750,9 +21050,9 @@ var HistoryService = class _HistoryService {
     let totalCost = 0;
     let files;
     try {
-      files = fs42.readdirSync(projectDir).filter((f) => f.endsWith(".jsonl")).filter((f) => {
+      files = fs43.readdirSync(projectDir).filter((f) => f.endsWith(".jsonl")).filter((f) => {
         try {
-          return fs42.statSync(path49.join(projectDir, f)).mtimeMs >= monthStartMs;
+          return fs43.statSync(path50.join(projectDir, f)).mtimeMs >= monthStartMs;
         } catch {
           return false;
         }
@@ -20763,7 +21063,7 @@ var HistoryService = class _HistoryService {
     for (const file of files) {
       let raw;
       try {
-        raw = fs42.readFileSync(path49.join(projectDir, file), "utf8");
+        raw = fs43.readFileSync(path50.join(projectDir, file), "utf8");
       } catch {
         continue;
       }
@@ -20842,7 +21142,7 @@ var HistoryService = class _HistoryService {
     if (this.runtime.resolveHistoryFile) {
       return this.runtime.resolveHistoryFile(this.cwd, sessionId);
     }
-    return path49.join(this.projectDir, `${sessionId}.jsonl`);
+    return path50.join(this.projectDir, `${sessionId}.jsonl`);
   }
   /**
    * Parse a conversation's messages from disk, agent-aware. Claude uses the
@@ -20876,7 +21176,7 @@ var HistoryService = class _HistoryService {
         };
       });
     }
-    return parseJsonl(path49.join(this.projectDir, `${sessionId}.jsonl`));
+    return parseJsonl(path50.join(this.projectDir, `${sessionId}.jsonl`));
   }
   async loadConversation(sessionId) {
     const messages = this.readConversation(sessionId);
@@ -20932,7 +21232,7 @@ var HistoryService = class _HistoryService {
     if (!filePath) return false;
     let mtimeMs;
     try {
-      mtimeMs = fs42.statSync(filePath).mtimeMs;
+      mtimeMs = fs43.statSync(filePath).mtimeMs;
     } catch {
       return false;
     }
@@ -21001,10 +21301,10 @@ var HistoryService = class _HistoryService {
 
 // src/agents/acp/client.ts
 var import_node_child_process16 = require("child_process");
-var fs43 = __toESM(require("fs/promises"));
+var fs44 = __toESM(require("fs/promises"));
 var fsSync = __toESM(require("fs"));
-var os36 = __toESM(require("os"));
-var path50 = __toESM(require("path"));
+var os37 = __toESM(require("os"));
+var path51 = __toESM(require("path"));
 var import_node_stream = require("stream");
 
 // ../../node_modules/@agentclientprotocol/sdk/dist/acp.js
@@ -23837,7 +24137,7 @@ var AcpClient = class {
       },
       readTextFile: async (params) => {
         try {
-          const content = await fs43.readFile(params.path, "utf8");
+          const content = await fs44.readFile(params.path, "utf8");
           return applyLineRange(content, params.line ?? null, params.limit ?? null);
         } catch (err) {
           const code = err.code;
@@ -23857,7 +24157,7 @@ var AcpClient = class {
       },
       writeTextFile: async (params) => {
         try {
-          await fs43.writeFile(params.path, params.content, "utf8");
+          await fs44.writeFile(params.path, params.content, "utf8");
           return {};
         } catch (err) {
           const code = err.code;
@@ -23906,25 +24206,25 @@ function applyLineRange(content, line, limit) {
   return { content: lines.slice(start2, end).join("\n") };
 }
 function knownAgentBinaryDirs() {
-  const home = os36.homedir();
+  const home = os37.homedir();
   const out2 = [];
   out2.push("/tmp/codeam-node20/bin");
   for (const root of [
     "/usr/local/share/nvm/versions/node",
-    path50.join(home, ".nvm/versions/node")
+    path51.join(home, ".nvm/versions/node")
   ]) {
     try {
       for (const child of fsSync.readdirSync(root)) {
-        out2.push(path50.join(root, child, "bin"));
+        out2.push(path51.join(root, child, "bin"));
       }
     } catch {
     }
   }
-  out2.push(path50.join(home, ".volta/bin"));
+  out2.push(path51.join(home, ".volta/bin"));
   out2.push("/usr/local/bin");
   out2.push("/usr/bin");
-  out2.push(path50.join(home, ".local/bin"));
-  out2.push(path50.join(home, "bin"));
+  out2.push(path51.join(home, ".local/bin"));
+  out2.push(path51.join(home, "bin"));
   return out2.filter((p2) => {
     try {
       return fsSync.statSync(p2).isDirectory();
@@ -23935,7 +24235,7 @@ function knownAgentBinaryDirs() {
 }
 function expandPathForAgentBinaries(existingPath) {
   const existing = new Set(
-    existingPath.split(path50.delimiter).filter((p2) => p2.length > 0)
+    existingPath.split(path51.delimiter).filter((p2) => p2.length > 0)
   );
   const additions = [];
   for (const dir of knownAgentBinaryDirs()) {
@@ -23945,7 +24245,7 @@ function expandPathForAgentBinaries(existingPath) {
     }
   }
   if (additions.length === 0) return existingPath;
-  return [...additions, existingPath].filter((p2) => p2.length > 0).join(path50.delimiter);
+  return [...additions, existingPath].filter((p2) => p2.length > 0).join(path51.delimiter);
 }
 
 // src/services/streaming/transport.ts
@@ -24337,6 +24637,79 @@ function createOneMRecovery(deps) {
   };
 }
 
+// src/agents/acp/budgetRecovery.ts
+var BUDGET_EXCEEDED_RE = /budget exceeded for (\w+) period/i;
+function looksLikeBudgetExceeded(text) {
+  return BUDGET_EXCEEDED_RE.test(text);
+}
+function extractBudgetPeriod(text) {
+  const m = BUDGET_EXCEEDED_RE.exec(text);
+  return m ? m[1] ?? "current" : "current";
+}
+var BUDGET_PAUSE_OPTION = "Pause budget this session";
+var BUDGET_RAISE_OPTION = "Raise budget";
+function createBudgetRecovery(deps) {
+  let pending = null;
+  const buildQuestion = (period) => `\u{1F4B8} **Headroom budget reached for the ${period} period.**
+
+You have two options:
+\u2022 **Pause budget this session** \u2014 removes the spending cap for this session only (the proxy restarts without a budget limit).
+\u2022 **Raise budget** \u2014 open your agent budget settings to increase the cap.`;
+  return {
+    offer: async (commandId, blocks, detail) => {
+      const period = extractBudgetPeriod(detail);
+      pending = { blocks, period };
+      const question = buildQuestion(period);
+      const options = [BUDGET_PAUSE_OPTION, BUDGET_RAISE_OPTION];
+      await deps.publishText(question);
+      await deps.publishSelectPrompt(question, options);
+      await deps.publishAwaitingAnswer(question, options);
+      deps.appendAgentReply(question);
+      deps.flushHistory();
+      deps.log?.(`budget-exceeded recovery offered period=${period} id=${commandId.slice(0, 8)}`);
+      await deps.sendResult(commandId, "failed", {
+        error: `Headroom budget exceeded (${period}) \u2014 recovery offered`
+      });
+    },
+    tryRecover: async (commandId, optionIndex) => {
+      if (!pending) return false;
+      const { blocks, period } = pending;
+      pending = null;
+      if (optionIndex === 0) {
+        deps.log?.("budget recovery \u2192 pause: relaunching proxy without budget");
+        try {
+          await deps.relaunchProxyWithoutBudget();
+        } catch (err) {
+          deps.log?.(`budget recovery \u2192 relaunch failed (best-effort): ${String(err)}`);
+        }
+        await deps.sendResult(commandId, "completed", {
+          action: "pause",
+          period,
+          note: "Headroom proxy relaunched without budget limit for this session. Send your message again."
+        });
+        const note = "\u2705 **Budget paused for this session.** The proxy is running without a spending cap \u2014 send your message again.";
+        await deps.publishText(note);
+        deps.appendAgentReply(note);
+        deps.flushHistory();
+        deps.log?.(`budget recovery \u2192 pause complete id=${commandId.slice(0, 8)}`);
+      } else {
+        deps.log?.(`budget recovery \u2192 raise: emitting deep-link for agent=${deps.agentId}`);
+        await deps.publishRawChunk({
+          type: "open_agent_budget_settings",
+          agentId: deps.agentId,
+          done: true
+        });
+        await deps.sendResult(commandId, "completed", {
+          action: "raise",
+          agentId: deps.agentId
+        });
+        deps.log?.(`budget recovery \u2192 raise emitted id=${commandId.slice(0, 8)}`);
+      }
+      return true;
+    }
+  };
+}
+
 // src/agents/acp/reconcileDelta.ts
 function reconcileCumulative(existing, incoming) {
   if (incoming.length === 0) return existing;
@@ -24357,15 +24730,15 @@ function commonPrefixLength(a, b) {
 
 // src/agents/acp/onboarding.ts
 var import_child_process22 = require("child_process");
-var fs44 = __toESM(require("fs"));
-var os37 = __toESM(require("os"));
-var path51 = __toESM(require("path"));
+var fs45 = __toESM(require("fs"));
+var os38 = __toESM(require("os"));
+var path52 = __toESM(require("path"));
 var _onboardingSeam = {
-  markerPath: (sessionId) => path51.join(os37.homedir(), ".codeam", "welcomed", `${sessionId}.done`),
-  exists: (p2) => fs44.existsSync(p2),
+  markerPath: (sessionId) => path52.join(os38.homedir(), ".codeam", "welcomed", `${sessionId}.done`),
+  exists: (p2) => fs45.existsSync(p2),
   write: (p2) => {
-    fs44.mkdirSync(path51.dirname(p2), { recursive: true });
-    fs44.writeFileSync(p2, "");
+    fs45.mkdirSync(path52.dirname(p2), { recursive: true });
+    fs45.writeFileSync(p2, "");
   },
   disabled: () => {
     const v = process.env.CODEAM_ONBOARDING_DISABLED;
@@ -24402,7 +24775,7 @@ function resolveRepoName(cwd) {
       if (name) return name;
     }
   }
-  const base = path51.basename(cwd || "");
+  const base = path52.basename(cwd || "");
   if (base && !isUuid(base)) return base;
   return "this project";
 }
@@ -24675,13 +25048,28 @@ function extractSelectPrompt(text) {
   };
 }
 
+// src/agents/acp/inputSuggestion.ts
+var MIN_LEN = 8;
+var MAX_LEN = 200;
+function deriveInputSuggestion(finalText) {
+  if (finalText.length === 0) return null;
+  const lines = finalText.split("\n");
+  let i = lines.length - 1;
+  while (i >= 0 && lines[i].trim() === "") i--;
+  if (i < 0) return null;
+  const lastLine = lines[i].trim();
+  if (!lastLine.endsWith("?")) return null;
+  if (lastLine.length < MIN_LEN || lastLine.length > MAX_LEN) return null;
+  return lastLine;
+}
+
 // src/services/turn-files/turn-file-aggregator.ts
 var import_crypto5 = require("crypto");
 
 // src/services/turn-files/git-changeset.ts
 var import_child_process23 = require("child_process");
-var fs45 = __toESM(require("fs/promises"));
-var path52 = __toESM(require("path"));
+var fs46 = __toESM(require("fs/promises"));
+var path53 = __toESM(require("path"));
 async function collectRepoChangeset(opts) {
   const status2 = await runGit3(opts.repoRoot, ["status", "--porcelain=v1", "-z"]);
   if (status2 === null) return null;
@@ -24699,7 +25087,7 @@ async function collectRepoChangeset(opts) {
     let stats;
     if (row.fileStatus === "added" && numstatEntry === void 0) {
       const lineCount = await readUntrackedLineCount(
-        path52.join(opts.repoRoot, row.filePath)
+        path53.join(opts.repoRoot, row.filePath)
       );
       stats = { added: lineCount, removed: 0 };
     } else {
@@ -24730,7 +25118,7 @@ function readUntrackedLineCount(absPath) {
 }
 async function defaultReadUntrackedLineCount(absPath) {
   try {
-    const content = await fs45.readFile(absPath, "utf8");
+    const content = await fs46.readFile(absPath, "utf8");
     let count = 0;
     let pos = -1;
     while ((pos = content.indexOf("\n", pos + 1)) !== -1) {
@@ -24822,7 +25210,7 @@ function defaultRunGit(cwd, args2) {
   });
 }
 async function discoverRepos(workingDir, maxDepth = 4) {
-  const fs49 = await import("fs/promises");
+  const fs50 = await import("fs/promises");
   const out2 = [];
   await walk(workingDir, 0);
   return out2;
@@ -24830,7 +25218,7 @@ async function discoverRepos(workingDir, maxDepth = 4) {
     if (depth > maxDepth) return;
     let entries = [];
     try {
-      const dirents = await fs49.readdir(dir, { withFileTypes: true });
+      const dirents = await fs50.readdir(dir, { withFileTypes: true });
       entries = dirents.filter((d3) => !d3.name.startsWith(".") || d3.name === ".git").map((d3) => ({ name: d3.name, isDirectory: d3.isDirectory() }));
     } catch {
       return;
@@ -24841,8 +25229,8 @@ async function discoverRepos(workingDir, maxDepth = 4) {
     if (hasGit) {
       out2.push({
         repoRoot: dir,
-        repoPath: path52.relative(workingDir, dir),
-        repoName: path52.basename(dir)
+        repoPath: path53.relative(workingDir, dir),
+        repoName: path53.basename(dir)
       });
       return;
     }
@@ -24850,14 +25238,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(path52.join(dir, entry.name), depth + 1);
+      await walk(path53.join(dir, entry.name), depth + 1);
     }
   }
 }
 
 // src/services/turn-files/files-outbox.ts
-var fs46 = __toESM(require("fs/promises"));
-var path53 = __toESM(require("path"));
+var fs47 = __toESM(require("fs/promises"));
+var path54 = __toESM(require("path"));
 var import_os7 = require("os");
 var HOME_OUTBOX_DIR = ".codeam/outbox";
 var MAX_AGE_MS = 24 * 60 * 60 * 1e3;
@@ -24890,16 +25278,16 @@ var FilesOutbox = class {
   backoffIndex = 0;
   stopped = false;
   constructor(opts) {
-    const base = opts.baseDir ?? path53.join(homeDir(), HOME_OUTBOX_DIR);
-    this.filePath = path53.join(base, `${opts.sessionId}.jsonl`);
+    const base = opts.baseDir ?? path54.join(homeDir(), HOME_OUTBOX_DIR);
+    this.filePath = path54.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 fs46.mkdir(path53.dirname(this.filePath), { recursive: true });
-    await fs46.appendFile(this.filePath, JSON.stringify(entry) + "\n", "utf8");
+    await fs47.mkdir(path54.dirname(this.filePath), { recursive: true });
+    await fs47.appendFile(this.filePath, JSON.stringify(entry) + "\n", "utf8");
     this.backoffIndex = 0;
     if (this.autoSchedule) this.scheduleFlush(0);
   }
@@ -24988,7 +25376,7 @@ var FilesOutbox = class {
   async readAll() {
     let raw = "";
     try {
-      raw = await fs46.readFile(this.filePath, "utf8");
+      raw = await fs47.readFile(this.filePath, "utf8");
     } catch {
       return [];
     }
@@ -25012,12 +25400,12 @@ var FilesOutbox = class {
   async rewrite(entries) {
     const tmpPath = `${this.filePath}.${process.pid}.tmp`;
     if (entries.length === 0) {
-      await fs46.unlink(this.filePath).catch(() => void 0);
+      await fs47.unlink(this.filePath).catch(() => void 0);
       return;
     }
     const payload = entries.map((e) => JSON.stringify(e)).join("\n") + "\n";
-    await fs46.writeFile(tmpPath, payload, "utf8");
-    await fs46.rename(tmpPath, this.filePath);
+    await fs47.writeFile(tmpPath, payload, "utf8");
+    await fs47.rename(tmpPath, this.filePath);
   }
 };
 function applyJitter(ms) {
@@ -25546,7 +25934,7 @@ var StreamingState = class {
         this.publisher.publishOutput({ type: "text", content: finalText, done: true }),
         flushSc
       ]);
-      return;
+      return false;
     }
     log.info(
       "acpRunner",
@@ -25573,6 +25961,7 @@ var StreamingState = class {
       done: true
     });
     await flushSc;
+    return true;
   }
 };
 var PERMISSION_TIMEOUT_MS = 5 * 60 * 1e3;
@@ -25755,10 +26144,26 @@ async function surfaceStartupFailure(opts) {
   );
   errRelay.start();
 }
+function budgetBubbleMessage(agent, period) {
+  return `\u{1F4B8} **Headroom budget reached for the ${period} period.**
+
+The local Headroom proxy rejected the ${agent} request because the configured spending cap was hit. Choose an option below to continue.`;
+}
+function buildRelaunchProxyEnv(baseEnv) {
+  const env = { ...baseEnv, HEADROOM_KOMPRESS_BACKEND: "onnx_cpu" };
+  delete env["HEADROOM_BUDGET"];
+  delete env["HEADROOM_BUDGET_PERIOD"];
+  return env;
+}
 function failureBubble(opts) {
   if (looksLikeAuthFailure(opts.detail) || looksLikeAuthFailure(opts.recentStderr)) {
     return AUTH_FAILURE_MESSAGE;
   }
+  const budgetHaystack = `${opts.detail}
+${opts.recentStderr}`;
+  if (looksLikeBudgetExceeded(budgetHaystack)) {
+    return budgetBubbleMessage(opts.agent, extractBudgetPeriod(budgetHaystack));
+  }
   if (looksLikeProviderOutage(opts.detail) || looksLikeProviderOutage(opts.recentStderr)) {
     return providerOutageMessage(opts.agent);
   }
@@ -25791,6 +26196,25 @@ async function reportCredentialInvalid(opts, fetchImpl = fetch) {
   } catch {
   }
 }
+async function postBudgetReached(opts, fetchImpl = fetch) {
+  const url = `${resolveApiBaseUrl()}/api/sessions/${encodeURIComponent(opts.sessionId)}/headroom-budget-reached`;
+  try {
+    await fetchImpl(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "X-Plugin-Auth-Token": opts.pluginAuthToken
+      },
+      body: JSON.stringify({
+        sessionId: opts.sessionId,
+        pluginId: opts.pluginId,
+        agent: opts.agent,
+        period: opts.period
+      })
+    });
+  } catch {
+  }
+}
 async function handleGetConversation(args2) {
   const { relay, commandId, jsonlHistory, acpSessionId } = args2;
   try {
@@ -25946,7 +26370,9 @@ async function runAcpSession(opts) {
     flushHistory: () => void history.flush(),
     beginTurn: () => streaming.beginTurn(),
     getCurrentText: () => streaming.getCurrentText(),
-    closeTurn: () => streaming.closeTurnWithInteractiveDetection(),
+    closeTurn: async () => {
+      await streaming.closeTurnWithInteractiveDetection();
+    },
     recoverFromFailedTurn: () => recoverFromFailedTurn(client2, streaming),
     reconnectWith1mDisabled,
     promptAgent: (blocks) => client2.prompt(blocks),
@@ -25954,6 +26380,58 @@ async function runAcpSession(opts) {
     describeError,
     log: (msg) => log.info("acpRunner", msg)
   });
+  let _budgetReachedPosted = false;
+  const relaunchProxyWithoutBudget = async () => {
+    const { spawn: spawn32 } = await import("child_process");
+    try {
+      const killer = spawn32("pkill", ["-TERM", "-f", "headroom.*proxy"], {
+        detached: true,
+        stdio: "ignore"
+      });
+      killer.once("error", () => {
+      });
+      killer.unref();
+    } catch {
+    }
+    await new Promise((r) => setTimeout(r, 500));
+    const proxyEnv = buildRelaunchProxyEnv(process.env);
+    try {
+      const proxy = spawn32(
+        "headroom",
+        ["proxy", "--port", "8787"],
+        { stdio: "ignore", detached: true, env: proxyEnv }
+      );
+      proxy.once("error", (e) => {
+        log.warn("acpRunner", `budget recovery proxy relaunch error (best-effort): ${e.message}`);
+      });
+      proxy.unref();
+    } catch (e) {
+      log.warn(
+        "acpRunner",
+        `budget recovery proxy relaunch failed (best-effort): ${e instanceof Error ? e.message : String(e)}`
+      );
+    }
+    await new Promise((r) => setTimeout(r, 3e3));
+  };
+  const budgetRecovery = createBudgetRecovery({
+    publishText: (text) => publisher.publishOutput({ type: "text", content: text, done: true }),
+    publishSelectPrompt: (question, options) => publisher.publishOutput({
+      type: "select_prompt",
+      content: question,
+      options,
+      optionDescriptions: options.map(() => ""),
+      currentIndex: 0,
+      done: true
+    }),
+    publishAwaitingAnswer: (prompt, options) => publisher.publishAwaitingAnswer({ questionId: (0, import_node_crypto7.randomUUID)(), prompt, options }),
+    publishRawChunk: (chunk) => publisher.publishOutput(chunk),
+    sendResult: (commandId, status2, result) => relay.sendResult(commandId, status2, result),
+    appendAgentReply: (text) => history.appendAgentReply(text),
+    flushHistory: () => void history.flush(),
+    relaunchProxyWithoutBudget,
+    agentId: opts.agent,
+    log: (msg) => log.info("acpRunner", msg)
+  });
   showInfo(`Starting ${opts.agent} via ACP adapter (${opts.adapter.requiresAgentBinary})\u2026`);
   let handshake;
   try {
@@ -26063,7 +26541,11 @@ async function runAcpSession(opts) {
         getBeads,
         publisher,
         recentStderr,
-        oneMRecovery
+        oneMRecovery,
+        budgetRecovery,
+        { get: () => _budgetReachedPosted, set: (v) => {
+          _budgetReachedPosted = v;
+        } }
       );
     },
     { id: opts.agent, name: opts.agent, displayName: opts.agent }
@@ -26087,7 +26569,7 @@ async function runAcpSession(opts) {
   await new Promise(() => {
   });
 }
-async function handleCommand(cmd, client2, relay, acpSessionId, models, streaming, opts, history, jsonlHistory, agentCaps, turnFiles, getBeads, publisher, recentStderr, oneMRecovery) {
+async function handleCommand(cmd, client2, relay, acpSessionId, models, streaming, opts, history, jsonlHistory, agentCaps, turnFiles, getBeads, publisher, recentStderr, oneMRecovery, budgetRecovery, budgetReachedFlag) {
   switch (cmd.type) {
     case "beads_action": {
       const beads = getBeads();
@@ -26147,13 +26629,19 @@ async function handleCommand(cmd, client2, relay, acpSessionId, models, streamin
         } else if (shouldOfferOneMRecovery({ detail: "", recentStderr: recentStderr.join("\n"), finalText })) {
           await oneMRecovery.offer(cmd.id, blocks);
         } else {
-          await streaming.closeTurnWithInteractiveDetection();
+          const emittedSelectPrompt = await streaming.closeTurnWithInteractiveDetection();
           const replyLine = formatAgentReplyLine(finalText);
           if (replyLine.length > 0) {
             showInfo(replyLine);
           }
           history.appendAgentReply(finalText);
           void history.flush();
+          if (!emittedSelectPrompt) {
+            const suggestion = deriveInputSuggestion(finalText);
+            if (suggestion !== null) {
+              void publisher.publishOutput({ type: "input_suggestion", content: suggestion, done: true });
+            }
+          }
           turnFiles.flushTurn().catch((err) => {
             log.warn("acpRunner", `turnFiles.flushTurn failed: ${describeError(err)}`);
           });
@@ -26165,6 +26653,24 @@ async function handleCommand(cmd, client2, relay, acpSessionId, models, streamin
         const detail = describeError(err);
         log.warn("acpRunner", `prompt failed: ${detail}`);
         await cancelStuckTurn(client2);
+        if (looksLikeBudgetExceeded(`${detail}
+${recentStderr.join("\n")}`)) {
+          await streaming.closeAll();
+          if (!budgetReachedFlag.get()) {
+            budgetReachedFlag.set(true);
+            void postBudgetReached({
+              sessionId: opts.sessionId,
+              pluginId: opts.pluginId,
+              pluginAuthToken: opts.pluginAuthToken,
+              agent: opts.agent,
+              period: extractBudgetPeriod(`${detail}
+${recentStderr.join("\n")}`)
+            });
+          }
+          await budgetRecovery.offer(cmd.id, blocks, `${detail}
+${recentStderr.join("\n")}`);
+          return;
+        }
         if (shouldOfferOneMRecovery({ detail, recentStderr: recentStderr.join("\n"), finalText: "" })) {
           await streaming.closeAll();
           await oneMRecovery.offer(cmd.id, blocks);
@@ -26271,6 +26777,7 @@ async function handleCommand(cmd, client2, relay, acpSessionId, models, streamin
       const index = typeof payload?.index === "number" ? payload.index : 0;
       const offset = typeof payload?.from === "number" ? payload.from : 0;
       const absoluteIndex = index + offset;
+      if (await budgetRecovery.tryRecover(cmd.id, absoluteIndex)) return;
       const result = streaming.resolveSelection(absoluteIndex);
       switch (result.kind) {
         case "resolved":
@@ -27527,15 +28034,15 @@ function fetchQuotaUsage(runtime, historySvc) {
 }
 
 // src/agents/claude/onboarding.ts
-var fs47 = __toESM(require("fs"));
-var os38 = __toESM(require("os"));
-var path54 = __toESM(require("path"));
+var fs48 = __toESM(require("fs"));
+var os39 = __toESM(require("os"));
+var path55 = __toESM(require("path"));
 function ensureClaudeOnboarded() {
   try {
-    const file = path54.join(os38.homedir(), ".claude.json");
+    const file = path55.join(os39.homedir(), ".claude.json");
     let config = {};
     try {
-      config = JSON.parse(fs47.readFileSync(file, "utf8"));
+      config = JSON.parse(fs48.readFileSync(file, "utf8"));
     } catch {
     }
     if (config.hasCompletedOnboarding === true && typeof config.theme === "string") {
@@ -27546,8 +28053,8 @@ function ensureClaudeOnboarded() {
     if (typeof config.lastOnboardingVersion !== "string") {
       config.lastOnboardingVersion = "2.1.177";
     }
-    fs47.mkdirSync(path54.dirname(file), { recursive: true });
-    fs47.writeFileSync(file, JSON.stringify(config, null, 2));
+    fs48.mkdirSync(path55.dirname(file), { recursive: true });
+    fs48.writeFileSync(file, JSON.stringify(config, null, 2));
     log.info("claude", "pre-completed Claude onboarding (skip first-run theme picker)");
   } catch (err) {
     log.warn("claude", `ensureClaudeOnboarded failed (non-fatal): ${err.message}`);
@@ -28197,7 +28704,7 @@ var import_picocolors11 = __toESM(require("picocolors"));
 var import_child_process24 = require("child_process");
 var import_util4 = require("util");
 var import_picocolors9 = __toESM(require("picocolors"));
-var path55 = __toESM(require("path"));
+var path56 = __toESM(require("path"));
 var execFileP6 = (0, import_util4.promisify)(import_child_process24.execFile);
 var MAX_BUFFER = 8 * 1024 * 1024;
 function resetStdinForChild() {
@@ -28686,7 +29193,7 @@ var GitHubCodespacesProvider = class {
     });
   }
   async uploadFile(workspaceId, remotePath, contents, options = {}) {
-    const remoteDir = path55.posix.dirname(remotePath);
+    const remoteDir = path56.posix.dirname(remotePath);
     const parts = [
       `mkdir -p ${shellQuote(remoteDir)}`,
       `cat > ${shellQuote(remotePath)}`
@@ -28756,7 +29263,7 @@ function shellQuote(s) {
 // src/services/providers/gitpod.ts
 var import_child_process25 = require("child_process");
 var import_util5 = require("util");
-var path56 = __toESM(require("path"));
+var path57 = __toESM(require("path"));
 var import_picocolors10 = __toESM(require("picocolors"));
 var execFileP7 = (0, import_util5.promisify)(import_child_process25.execFile);
 var MAX_BUFFER2 = 8 * 1024 * 1024;
@@ -28996,7 +29503,7 @@ var GitpodProvider = class {
     });
   }
   async uploadFile(workspaceId, remotePath, contents, options = {}) {
-    const remoteDir = path56.posix.dirname(remotePath);
+    const remoteDir = path57.posix.dirname(remotePath);
     const parts = [
       `mkdir -p ${shellQuote2(remoteDir)}`,
       `cat > ${shellQuote2(remotePath)}`
@@ -29032,7 +29539,7 @@ function shellQuote2(s) {
 // src/services/providers/gitlab-workspaces.ts
 var import_child_process26 = require("child_process");
 var import_util6 = require("util");
-var path57 = __toESM(require("path"));
+var path58 = __toESM(require("path"));
 var execFileP8 = (0, import_util6.promisify)(import_child_process26.execFile);
 var MAX_BUFFER3 = 8 * 1024 * 1024;
 var GITLAB_API_BASE = process.env.CODEAM_GITLAB_API_URL ?? "https://gitlab.com/api/v4";
@@ -29292,7 +29799,7 @@ Docs: https://docs.gitlab.com/ee/user/workspace/configuration.html`
   }
   async uploadFile(workspaceId, remotePath, contents, options = {}) {
     const sshHost = process.env.CODEAM_GITLAB_SSH_HOST ?? "workspaces.gitlab.com";
-    const remoteDir = path57.posix.dirname(remotePath);
+    const remoteDir = path58.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)}`);
@@ -29360,7 +29867,7 @@ function shellQuote3(s) {
 // src/services/providers/railway.ts
 var import_child_process27 = require("child_process");
 var import_util7 = require("util");
-var path58 = __toESM(require("path"));
+var path59 = __toESM(require("path"));
 var execFileP9 = (0, import_util7.promisify)(import_child_process27.execFile);
 var MAX_BUFFER4 = 8 * 1024 * 1024;
 function resetStdinForChild4() {
@@ -29596,7 +30103,7 @@ var RailwayProvider = class {
     if (!projectId || !serviceId) {
       throw new Error("Invalid Railway workspace id (expected projectId/serviceId).");
     }
-    const remoteDir = path58.posix.dirname(remotePath);
+    const remoteDir = path59.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)}`);
@@ -30242,8 +30749,8 @@ async function invite() {
 var import_node_dns = require("dns");
 var import_node_util5 = require("util");
 var import_node_crypto8 = require("crypto");
-var fs48 = __toESM(require("fs"));
-var path59 = __toESM(require("path"));
+var fs49 = __toESM(require("fs"));
+var path60 = __toESM(require("path"));
 var import_picocolors14 = __toESM(require("picocolors"));
 var dnsResolveP = (0, import_node_util5.promisify)(import_node_dns.resolve);
 async function checkDns(apiBase2) {
@@ -30299,13 +30806,13 @@ async function checkHealth(apiBase2) {
   }
 }
 function checkConfigDir() {
-  const dir = path59.join(require("os").homedir(), ".codeam");
+  const dir = path60.join(require("os").homedir(), ".codeam");
   try {
-    fs48.mkdirSync(dir, { recursive: true, mode: 448 });
-    const probe = path59.join(dir, ".doctor-probe");
-    fs48.writeFileSync(probe, "ok", { mode: 384 });
-    const read2 = fs48.readFileSync(probe, "utf8");
-    fs48.unlinkSync(probe);
+    fs49.mkdirSync(dir, { recursive: true, mode: 448 });
+    const probe = path60.join(dir, ".doctor-probe");
+    fs49.writeFileSync(probe, "ok", { mode: 384 });
+    const read2 = fs49.readFileSync(probe, "utf8");
+    fs49.unlinkSync(probe);
     if (read2 !== "ok") throw new Error("write/read round-trip mismatch");
     return {
       id: "config-dir",
@@ -30345,9 +30852,9 @@ function checkSessions() {
   }
 }
 function checkAgentBinaries() {
-  const os40 = createOsStrategy();
+  const os41 = createOsStrategy();
   return getEnabledAgents().map((meta) => {
-    const found = os40.findInPath(meta.binaryName);
+    const found = os41.findInPath(meta.binaryName);
     return {
       id: `agent-${meta.id}`,
       label: `Agent binary: ${meta.displayName} (${meta.binaryName})`,
@@ -30369,7 +30876,7 @@ function checkNodePty() {
       detail: "not required on this platform"
     };
   }
-  const vendoredPath = path59.join(__dirname, "vendor", "node-pty");
+  const vendoredPath = path60.join(__dirname, "vendor", "node-pty");
   for (const target of [vendoredPath, "node-pty"]) {
     try {
       require(target);
@@ -30411,7 +30918,7 @@ function checkChokidar() {
 }
 async function doctor(args2 = []) {
   const json = args2.includes("--json");
-  const cliVersion = true ? "2.49.5" : "0.0.0-dev";
+  const cliVersion = true ? "2.51.0" : "0.0.0-dev";
   const apiBase2 = resolveApiBaseUrl();
   const diagnosticId = (0, import_node_crypto8.randomUUID)();
   log.info("doctor", `run id=${diagnosticId} cli=${cliVersion}`);
@@ -30610,7 +31117,7 @@ async function completion(args2) {
 // src/commands/version.ts
 var import_picocolors15 = __toESM(require("picocolors"));
 function version2() {
-  const v = true ? "2.49.5" : "unknown";
+  const v = true ? "2.51.0" : "unknown";
   console.log(`${import_picocolors15.default.bold("codeam-cli")} ${import_picocolors15.default.cyan(v)}`);
 }
 
@@ -30759,10 +31266,10 @@ var EXIT_CODE_NAMES = {
 };
 
 // src/index.ts
-var os39 = __toESM(require("os"));
+var os40 = __toESM(require("os"));
 if (!process.env.HOME) {
   try {
-    const home = os39.homedir();
+    const home = os40.homedir();
     if (home) process.env.HOME = home;
   } catch {
   }