codeam-cli 2.63.0 → 2.64.0

package/dist/index.js

@@ -2789,6 +2789,17 @@ function resolveApiBaseUrl() {
   return DEFAULT_API_BASE_URL;
 }
 
+// ../../packages/shared/src/types/agent-squad.ts
+var HANDOFF_FENCE_TAG = "codeam-handoff";
+var SQUAD_SPECIALTIES = {
+  claude: "deep reasoning, refactors, and multi-step architecture work",
+  codex: "fast, focused implementation and test fixing",
+  cursor: "multi-file edits and codebase-wide changes",
+  gemini: "large-context analysis across big files and logs",
+  kimi: "long-context code reading and summarization",
+  opencode: "general implementation tasks"
+};
+
 // ../../packages/shared/src/headroom/manifest.ts
 var HEADROOM_PROXY_PORT = 8787;
 var HEADROOM_PIP_COMPANIONS = [
@@ -2921,6 +2932,9 @@ var USER_EVENTS = {
   // the backend re-publishes them on the per-user SSE bus (mirrored in repo A).
   SWITCH_AGENT_PROGRESS: "switch_agent_progress",
   SWITCH_AGENT_STATUS: "switch_agent_status",
+  // Agent Squad — the CLI posts these to /api/agent-switch/events; PRO-gated.
+  HANDOFF_PROPOSED: "handoff_proposed",
+  HANDOFF_RESOLVED: "handoff_resolved",
   // VCS / PR Command Center — the backend publishes this after an agent finishes
   // reviewing a PR (verdict + comment count + findings), driving the mobile
   // completion screen + push. Mirrored in repo A's app-shared events.ts.
@@ -3125,11 +3139,11 @@ function quiet(fn) {
     log.debug(TAG, "ignored sync error", err);
   }
 }
-function rmIfExistsQuiet(path90) {
+function rmIfExistsQuiet(path91) {
   try {
-    fs2.rmSync(path90, { force: true });
+    fs2.rmSync(path91, { force: true });
   } catch (err) {
-    log.debug(TAG, `rmIfExists failed for ${path90}`, err);
+    log.debug(TAG, `rmIfExists failed for ${path91}`, err);
   }
 }
 function killQuiet(target, signal = "SIGTERM") {
@@ -3320,8 +3334,8 @@ function createGetModuleFromFilename(basePath = process.argv[1] ? (0, import_pat
     return decodedFile;
   };
 }
-function normalizeWindowsPath(path90) {
-  return path90.replace(/^[A-Z]:/, "").replace(/\\/g, "/");
+function normalizeWindowsPath(path91) {
+  return path91.replace(/^[A-Z]:/, "").replace(/\\/g, "/");
 }
 
 // ../../node_modules/@posthog/core/dist/featureFlagUtils.mjs
@@ -5801,9 +5815,9 @@ async function addSourceContext(frames) {
   LRU_FILE_CONTENTS_CACHE.reduce();
   return frames;
 }
-function getContextLinesFromFile(path90, ranges, output) {
+function getContextLinesFromFile(path91, ranges, output) {
   return new Promise((resolve9) => {
-    const stream = (0, import_node_fs.createReadStream)(path90);
+    const stream = (0, import_node_fs.createReadStream)(path91);
     const lineReaded = (0, import_node_readline.createInterface)({
       input: stream
     });
@@ -5818,7 +5832,7 @@ function getContextLinesFromFile(path90, ranges, output) {
     let rangeStart = range[0];
     let rangeEnd = range[1];
     function onStreamError() {
-      LRU_FILE_CONTENTS_FS_READ_FAILED.set(path90, 1);
+      LRU_FILE_CONTENTS_FS_READ_FAILED.set(path91, 1);
       lineReaded.close();
       lineReaded.removeAllListeners();
       destroyStreamAndResolve();
@@ -5879,8 +5893,8 @@ function clearLineContext(frame) {
   delete frame.context_line;
   delete frame.post_context;
 }
-function shouldSkipContextLinesForFile(path90) {
-  return path90.startsWith("node:") || path90.endsWith(".min.js") || path90.endsWith(".min.cjs") || path90.endsWith(".min.mjs") || path90.startsWith("data:");
+function shouldSkipContextLinesForFile(path91) {
+  return path91.startsWith("node:") || path91.endsWith(".min.js") || path91.endsWith(".min.cjs") || path91.endsWith(".min.mjs") || path91.startsWith("data:");
 }
 function shouldSkipContextLinesForFrame(frame) {
   if (void 0 !== frame.lineno && frame.lineno > MAX_CONTEXTLINES_LINENO) return true;
@@ -8034,7 +8048,7 @@ function readAnonId() {
 }
 function superProperties() {
   return {
-    cliVersion: true ? "2.63.0" : "0.0.0-dev",
+    cliVersion: true ? "2.64.0" : "0.0.0-dev",
     nodeVersion: process.version,
     platform: process.platform,
     arch: process.arch,
@@ -8215,7 +8229,7 @@ var os4 = __toESM(require("os"));
 // package.json
 var package_default = {
   name: "codeam-cli",
-  version: "2.63.0",
+  version: "2.64.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",
@@ -8611,6 +8625,20 @@ async function fetchProvisionCredential(input) {
     return null;
   }
 }
+async function fetchSquadRoster(input) {
+  try {
+    const res = await _transport.postJsonAuthed(
+      `${API_BASE}/api/plugin/agents/roster`,
+      { sessionId: input.sessionId, pluginId: input.pluginId },
+      input.pluginAuthToken
+    );
+    const data = res?.data;
+    if (!data || !Array.isArray(data.agents)) return null;
+    return { agents: data.agents, handoffsEnabled: data.handoffsEnabled === true };
+  } catch {
+    return null;
+  }
+}
 async function postAgentSwitchEvent(input) {
   try {
     await _transport.postJsonAuthed(
@@ -8773,9 +8801,7 @@ async function _postJsonAuthed(url2, body, pluginAuthToken) {
         });
         res.on("end", () => {
           if (res.statusCode && res.statusCode >= 400) {
-            reject(
-              makeHttpError(res.statusCode, res.headers["retry-after"], responseBody)
-            );
+            reject(makeHttpError(res.statusCode, res.headers["retry-after"], responseBody));
             return;
           }
           try {
@@ -9655,7 +9681,7 @@ var CommandRelayService = class _CommandRelayService {
       // fresh + clear the "CLI update available" banner after a self-update
       // (a codespace that reinstalls @latest reconnects via heartbeat, not
       // pair/reconnect). Older backends ignore the extra field.
-      ..."2.63.0" ? { ideVersion: "2.63.0" } : {}
+      ..."2.64.0" ? { ideVersion: "2.64.0" } : {}
     }).then(() => log.trace("relay", `heartbeat ok online=${online}`)).catch((err) => log.trace("relay", `heartbeat failed online=${online}`, err));
   }
   /**
@@ -9680,7 +9706,8 @@ var CommandRelayService = class _CommandRelayService {
     ];
     _postJson(`${API_BASE2}/api/plugin/agents`, {
       pluginId: this.pluginId,
-      agents
+      agents,
+      capabilities: { squad: true }
     }).then(() => {
       this.agentsRegistered = true;
     }).catch(() => {
@@ -9899,10 +9926,10 @@ var WINDOWS_LEGACY_JUNCTIONS = [
   /[\\/]Start Menu([\\/]|$)/i,
   /[\\/]Templates([\\/]|$)/i
 ];
-function isUnsafeWindowsWatchRoot(dir, homedir52) {
+function isUnsafeWindowsWatchRoot(dir, homedir53) {
   const norm = (p2) => p2.replace(/\//g, "\\").replace(/\\+$/, "").toLowerCase();
   const cwd = norm(dir);
-  const home = norm(homedir52);
+  const home = norm(homedir53);
   if (cwd === home) return true;
   if (/^[a-z]:$/.test(cwd)) return true;
   const sysRoots = [
@@ -14558,10 +14585,10 @@ function buildForPlatform(platform3) {
 var import_node_crypto4 = require("crypto");
 
 // src/agents/claude/resolver.ts
-function buildClaudeLaunch(extraArgs = [], os65 = createOsStrategy()) {
-  const found = os65.findInPath("claude") ?? os65.findInPath("claude-code");
+function buildClaudeLaunch(extraArgs = [], os66 = createOsStrategy()) {
+  const found = os66.findInPath("claude") ?? os66.findInPath("claude-code");
   if (!found) return null;
-  return os65.buildLaunch(found, extraArgs);
+  return os66.buildLaunch(found, extraArgs);
 }
 
 // src/agents/claude/installer.ts
@@ -15151,8 +15178,8 @@ var ClaudeRuntimeStrategy = class {
   meta = getAgent("claude");
   mode = "interactive";
   os;
-  constructor(os65) {
-    this.os = os65;
+  constructor(os66) {
+    this.os = os66;
   }
   /**
    * Claude Code's react-ink TUI enables bracketed-paste mode at
@@ -15932,8 +15959,8 @@ function codexCredentialLocator() {
 function codexLoginLauncher() {
   return {
     async ensureInstalled() {
-      const os65 = createOsStrategy();
-      return os65.findInPath("codex") !== null;
+      const os66 = createOsStrategy();
+      return os66.findInPath("codex") !== null;
     },
     launch() {
       return (0, import_node_child_process4.spawn)("codex", ["login"], { stdio: "inherit" });
@@ -15956,8 +15983,8 @@ var CodexRuntimeStrategy = class {
   meta = getAgent("codex");
   mode = "interactive";
   os;
-  constructor(os65) {
-    this.os = os65;
+  constructor(os66) {
+    this.os = os66;
   }
   async prepareLaunch() {
     let binary = this.os.findInPath("codex");
@@ -16066,12 +16093,12 @@ var CodexRuntimeStrategy = class {
     });
   }
 };
-function resolveNpm(os65) {
-  return os65.id === "win32" ? "npm.cmd" : "npm";
+function resolveNpm(os66) {
+  return os66.id === "win32" ? "npm.cmd" : "npm";
 }
-async function installCodexViaNpm(os65) {
+async function installCodexViaNpm(os66) {
   return new Promise((resolve9, reject) => {
-    const proc = (0, import_node_child_process5.spawn)(resolveNpm(os65), ["install", "-g", "@openai/codex"], {
+    const proc = (0, import_node_child_process5.spawn)(resolveNpm(os66), ["install", "-g", "@openai/codex"], {
       stdio: "inherit"
     });
     proc.on("close", (code) => {
@@ -16088,16 +16115,16 @@ async function installCodexViaNpm(os65) {
     });
   });
 }
-function augmentNpmGlobalBin(os65) {
+function augmentNpmGlobalBin(os66) {
   try {
-    const result = (0, import_node_child_process5.spawnSync)(resolveNpm(os65), ["prefix", "-g"], {
+    const result = (0, import_node_child_process5.spawnSync)(resolveNpm(os66), ["prefix", "-g"], {
       stdio: ["ignore", "pipe", "ignore"]
     });
     if (result.status !== 0) return;
     const prefix = result.stdout.toString().trim();
     if (!prefix) return;
-    const binDir = os65.id === "win32" ? prefix : path25.join(prefix, "bin");
-    os65.augmentPath([binDir]);
+    const binDir = os66.id === "win32" ? prefix : path25.join(prefix, "bin");
+    os66.augmentPath([binDir]);
   } catch {
   }
 }
@@ -16496,10 +16523,10 @@ function manualInstallHint(runner, tools) {
   const argv = osPackageInstallArgv(detectPackageManager(runner), [...tools]);
   return argv ? `\`sudo ${argv.join(" ")}\`` : `your package manager (e.g. \`${pkgs}\`)`;
 }
-function writeUnzipShim(os65, runner) {
+function writeUnzipShim(os66, runner) {
   const python = ["python3", "python"].find((p2) => runner.which(p2));
   if (!python) return null;
-  const dir = os65.scratchPath("codeam-cr-prereq");
+  const dir = os66.scratchPath("codeam-cr-prereq");
   const shim = path27.join(dir, "unzip");
   const script = `#!/bin/sh
 set -e
@@ -16521,9 +16548,9 @@ exec ${python} -m zipfile -e "$archive" "$dest"
   (0, import_node_fs5.chmodSync)(shim, 448);
   return dir;
 }
-async function ensureInstallPrerequisites(os65, deps = {}) {
+async function ensureInstallPrerequisites(os66, deps = {}) {
   const runner = deps.runner ?? defaultHeadroomRunner;
-  const missing = REQUIRED_TOOLS.filter((t2) => os65.findInPath(t2) === null);
+  const missing = REQUIRED_TOOLS.filter((t2) => os66.findInPath(t2) === null);
   if (missing.length === 0) return { ok: true, extraPath: [] };
   log.info(
     "coderabbit",
@@ -16542,10 +16569,10 @@ async function ensureInstallPrerequisites(os65, deps = {}) {
       );
     }
   }
-  const stillMissing = REQUIRED_TOOLS.filter((t2) => os65.findInPath(t2) === null);
+  const stillMissing = REQUIRED_TOOLS.filter((t2) => os66.findInPath(t2) === null);
   if (stillMissing.length === 0) return { ok: true, extraPath: [] };
   if (stillMissing.length === 1 && stillMissing[0] === "unzip") {
-    const shimDir = writeUnzipShim(os65, runner);
+    const shimDir = writeUnzipShim(os66, runner);
     if (shimDir) {
       log.info("coderabbit", "unzip is unavailable \u2014 using a scoped python zipfile shim");
       return { ok: true, extraPath: [shimDir] };
@@ -16608,15 +16635,15 @@ function summarizeInstallFailure(output) {
   }
   return lines.length > 0 ? lines[lines.length - 1] : null;
 }
-async function ensureCoderabbitInstalled(os65, deps = {}) {
-  if (os65.findInPath("coderabbit")) return { ok: true };
-  if (os65.id === "win32") {
+async function ensureCoderabbitInstalled(os66, deps = {}) {
+  if (os66.findInPath("coderabbit")) return { ok: true };
+  if (os66.id === "win32") {
     return {
       ok: false,
       error: "CodeRabbit on Windows requires WSL. Install the CLI inside your WSL distribution (curl -fsSL https://cli.coderabbit.ai/install.sh | sh), then try again."
     };
   }
-  const prereq = await ensureInstallPrerequisites(os65, deps);
+  const prereq = await ensureInstallPrerequisites(os66, deps);
   if (!prereq.ok) return { ok: false, error: prereq.error };
   const env = { ...process.env };
   if (prereq.extraPath.length > 0) {
@@ -16632,8 +16659,8 @@ async function ensureCoderabbitInstalled(os65, deps = {}) {
       error: detail ? `CodeRabbit CLI install failed: ${detail}` : "CodeRabbit CLI install failed \u2014 check this machine's network egress and try again."
     };
   }
-  os65.augmentPath([`${os65.homeDir()}/.local/bin`, "/opt/homebrew/bin"]);
-  if (os65.findInPath("coderabbit") === null) {
+  os66.augmentPath([`${os66.homeDir()}/.local/bin`, "/opt/homebrew/bin"]);
+  if (os66.findInPath("coderabbit") === null) {
     const detail = summarizeInstallFailure(output);
     return {
       ok: false,
@@ -16675,10 +16702,10 @@ function coderabbitCredentialLocator() {
     validate: validateNonEmptyCredential
   };
 }
-function coderabbitLoginLauncher(os65) {
+function coderabbitLoginLauncher(os66) {
   return {
     async ensureInstalled() {
-      const result = await ensureCoderabbitInstalled(os65);
+      const result = await ensureCoderabbitInstalled(os66);
       if (!result.ok && result.error) console.error(`
   \u2717 ${result.error}
 `);
@@ -16738,8 +16765,8 @@ function pickLine(obj) {
 function toHunk(raw, groupSeverity) {
   if (!raw || typeof raw !== "object") return null;
   const o = raw;
-  const path90 = asString(pick(o, ["file_path", "filePath", "file", "path", "filename", "fileName"])) ?? asString(pick(o, ["location"])?.path);
-  if (!path90) return null;
+  const path91 = asString(pick(o, ["file_path", "filePath", "file", "path", "filename", "fileName"])) ?? asString(pick(o, ["location"])?.path);
+  if (!path91) return null;
   const message = asString(
     pick(o, [
       "comment",
@@ -16756,7 +16783,7 @@ function toHunk(raw, groupSeverity) {
   const severity = normSeverity(pick(o, ["severity", "level", "priority", "impact"])) ?? normSeverity(groupSeverity);
   const locObj = pick(o, ["location"]) ?? o;
   return {
-    path: path90.trim(),
+    path: path91.trim(),
     line: pickLine(o) ?? pickLine(locObj),
     severity,
     message: (title && message ? `${title}: ${message}` : title || message).trim() || "(no message)"
@@ -16839,10 +16866,10 @@ function parsePlain(stdout) {
   for (const line of stdout.split(/\r?\n/)) {
     const m = line.match(HUNK_LINE_RE);
     if (!m) continue;
-    const [, path90, lineNo, sevToken, message] = m;
-    if (!path90 || !lineNo || !message) continue;
+    const [, path91, lineNo, sevToken, message] = m;
+    if (!path91 || !lineNo || !message) continue;
     hunks.push({
-      path: path90.trim(),
+      path: path91.trim(),
       line: Number(lineNo),
       severity: sevToken ? SEVERITY_MAP[sevToken.toLowerCase()] : void 0,
       message: message.trim().replace(/^[*-]\s+/, "")
@@ -16902,8 +16929,8 @@ var CoderabbitRuntimeStrategy = class {
   meta = getAgent("coderabbit");
   mode = "batch";
   os;
-  constructor(os65) {
-    this.os = os65;
+  constructor(os66) {
+    this.os = os66;
   }
   getDefaultArgs() {
     return ["review", "--agent"];
@@ -17174,10 +17201,10 @@ function cursorCredentialLocator() {
     validate: validateNonEmptyCredential
   };
 }
-function cursorLoginLauncher(os65) {
+function cursorLoginLauncher(os66) {
   return {
     async ensureInstalled() {
-      if (os65.findInPath("cursor-agent")) return true;
+      if (os66.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"
       );
@@ -17241,8 +17268,8 @@ var CursorRuntimeStrategy = class {
   meta = getAgent("cursor");
   mode = "interactive";
   os;
-  constructor(os65) {
-    this.os = os65;
+  constructor(os66) {
+    this.os = os66;
   }
   async prepareLaunch() {
     const binary = this.os.findInPath("cursor-agent");
@@ -17458,10 +17485,10 @@ function aiderCredentialLocator() {
     validate: validateNonEmptyCredential
   };
 }
-function aiderLoginLauncher(os65) {
+function aiderLoginLauncher(os66) {
   return {
     async ensureInstalled() {
-      if (os65.findInPath("aider")) return true;
+      if (os66.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"
       );
@@ -17471,7 +17498,7 @@ function aiderLoginLauncher(os65) {
       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_process12.spawn)(os65.id === "win32" ? "cmd.exe" : "sh", os65.id === "win32" ? ["/c", "exit", "0"] : ["-c", "exit 0"], {
+      return (0, import_node_child_process12.spawn)(os66.id === "win32" ? "cmd.exe" : "sh", os66.id === "win32" ? ["/c", "exit", "0"] : ["-c", "exit 0"], {
         stdio: "ignore"
       });
     }
@@ -17543,8 +17570,8 @@ var AiderRuntimeStrategy = class {
   meta = getAgent("aider");
   mode = "interactive";
   os;
-  constructor(os65) {
-    this.os = os65;
+  constructor(os66) {
+    this.os = os66;
   }
   async prepareLaunch() {
     const binary = this.os.findInPath("aider");
@@ -17676,8 +17703,8 @@ function geminiCredentialLocator() {
 function geminiLoginLauncher() {
   return {
     async ensureInstalled() {
-      const os65 = createOsStrategy();
-      return os65.findInPath("gemini") !== null;
+      const os66 = createOsStrategy();
+      return os66.findInPath("gemini") !== null;
     },
     launch() {
       return (0, import_node_child_process13.spawn)("gemini", ["auth", "login"], { stdio: "inherit" });
@@ -17867,8 +17894,8 @@ var GeminiRuntimeStrategy = class {
   meta = getAgent("gemini");
   mode = "interactive";
   os;
-  constructor(os65) {
-    this.os = os65;
+  constructor(os66) {
+    this.os = os66;
   }
   async prepareLaunch() {
     const binary = this.os.findInPath("gemini");
@@ -18159,8 +18186,8 @@ var KimiRuntimeStrategy = class {
   meta = getAgent("kimi");
   mode = "interactive";
   os;
-  constructor(os65) {
-    this.os = os65;
+  constructor(os66) {
+    this.os = os66;
   }
   async prepareLaunch() {
     const binary = this.os.findInPath("kimi");
@@ -18302,8 +18329,8 @@ var OpencodeRuntimeStrategy = class {
   meta = getAgent("opencode");
   mode = "interactive";
   os;
-  constructor(os65) {
-    this.os = os65;
+  constructor(os66) {
+    this.os = os66;
   }
   async prepareLaunch() {
     const binary = this.os.findInPath("opencode");
@@ -18387,20 +18414,20 @@ var OpencodeRuntimeStrategy = class {
 
 // src/agents/registry.ts
 var runtimeBuilders = {
-  claude: (os65) => new ClaudeRuntimeStrategy(os65),
-  codex: (os65) => new CodexRuntimeStrategy(os65),
-  coderabbit: (os65) => new CoderabbitRuntimeStrategy(os65),
-  cursor: (os65) => new CursorRuntimeStrategy(os65),
-  aider: (os65) => new AiderRuntimeStrategy(os65),
-  gemini: (os65) => new GeminiRuntimeStrategy(os65),
-  kimi: (os65) => new KimiRuntimeStrategy(os65),
-  opencode: (os65) => new OpencodeRuntimeStrategy(os65)
+  claude: (os66) => new ClaudeRuntimeStrategy(os66),
+  codex: (os66) => new CodexRuntimeStrategy(os66),
+  coderabbit: (os66) => new CoderabbitRuntimeStrategy(os66),
+  cursor: (os66) => new CursorRuntimeStrategy(os66),
+  aider: (os66) => new AiderRuntimeStrategy(os66),
+  gemini: (os66) => new GeminiRuntimeStrategy(os66),
+  kimi: (os66) => new KimiRuntimeStrategy(os66),
+  opencode: (os66) => new OpencodeRuntimeStrategy(os66)
 };
 var deployBuilders = {
   claude: () => new ClaudeDeployStrategy(),
   codex: () => new CodexDeployStrategy()
 };
-function createAgentStrategy(agent, os65 = createOsStrategy()) {
+function createAgentStrategy(agent, os66 = 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'.`
@@ -18410,10 +18437,10 @@ function createAgentStrategy(agent, os65 = createOsStrategy()) {
   if (!build) {
     throw new Error(`No runtime strategy registered for agent "${agent}"`);
   }
-  return build(os65);
+  return build(os66);
 }
-function createInteractiveAgentStrategy(agent, os65 = createOsStrategy()) {
-  const s = createAgentStrategy(agent, os65);
+function createInteractiveAgentStrategy(agent, os66 = createOsStrategy()) {
+  const s = createAgentStrategy(agent, os66);
   if (s.mode !== "interactive") {
     throw new Error(
       `Agent "${agent}" is a batch agent; use createAgentStrategy + .runOneShot for one-shot reviews.`
@@ -19091,8 +19118,8 @@ function collectChangedFiles(cwd) {
   }
   return [...byPath.values()];
 }
-function restoreCoderabbitOauthBlob(os65, value) {
-  const dir = path38.join(os65.homeDir(), ".coderabbit");
+function restoreCoderabbitOauthBlob(os66, value) {
+  const dir = path38.join(os66.homeDir(), ".coderabbit");
   (0, import_node_fs6.mkdirSync)(dir, { recursive: true });
   let file = "auth.json";
   let contents = value.trim();
@@ -19112,26 +19139,26 @@ function installFailureMessage(result) {
   return result.error ?? "CodeRabbit CLI could not be installed";
 }
 async function configureCoderabbit(input, deps = {}) {
-  const os65 = deps.os ?? createOsStrategy();
+  const os66 = deps.os ?? createOsStrategy();
   const ensureInstalled = deps.ensureInstalled ?? ensureCoderabbitInstalled;
   const isLoggedIn = deps.isLoggedIn ?? defaultIsLoggedIn;
   const runOAuth = deps.runOAuthLogin ?? runCoderabbitOAuthLogin;
   const snapshot = deps.snapshotDir ?? (() => snapshotCredentialDir());
   const capture2 = deps.captureCredential ?? ((b) => diffCapturedCredential(b));
   const loginWithApiKey = deps.loginWithApiKey ?? defaultLoginWithApiKey;
-  const home = os65.homeDir();
-  os65.augmentPath(
-    os65.id === "win32" ? [
+  const home = os66.homeDir();
+  os66.augmentPath(
+    os66.id === "win32" ? [
       path38.join(home, ".local", "bin"),
       path38.join(process.env.APPDATA ?? path38.join(home, "AppData", "Roaming"), "npm"),
       path38.join(home, "scoop", "shims")
     ] : [path38.join(home, ".local", "bin"), "/opt/homebrew/bin", "/usr/local/bin"]
   );
-  const installed2 = os65.findInPath("coderabbit") !== null;
+  const installed2 = os66.findInPath("coderabbit") !== null;
   const base = () => ({
     action: input.action,
     supported: true,
-    installed: os65.findInPath("coderabbit") !== null,
+    installed: os66.findInPath("coderabbit") !== null,
     loggedIn: false
   });
   if (input.action === "status") {
@@ -19145,7 +19172,7 @@ async function configureCoderabbit(input, deps = {}) {
     const key = (input.apiKey ?? "").trim();
     if (!key) return { ...res2, error: "No API key provided" };
     if (!res2.installed) {
-      const inst = await ensureInstalled(os65);
+      const inst = await ensureInstalled(os66);
       res2.installed = inst.ok;
       if (!inst.ok) return { ...res2, error: installFailureMessage(inst) };
     }
@@ -19169,7 +19196,7 @@ async function configureCoderabbit(input, deps = {}) {
     }
     if (!res2.installed) {
       deps.onEvent?.({ kind: "installing" });
-      const inst = await ensureInstalled(os65);
+      const inst = await ensureInstalled(os66);
       res2.installed = inst.ok;
       if (!inst.ok) return { ...res2, error: installFailureMessage(inst) };
     }
@@ -19186,7 +19213,7 @@ async function configureCoderabbit(input, deps = {}) {
       return { ...res2, loggedIn: true, linked: true };
     }
     try {
-      restoreCoderabbitOauthBlob(os65, cred.credential);
+      restoreCoderabbitOauthBlob(os66, cred.credential);
     } catch (err) {
       return {
         ...res2,
@@ -19210,7 +19237,7 @@ async function configureCoderabbit(input, deps = {}) {
     const res2 = base();
     if (!installed2) {
       deps.onEvent?.({ kind: "installing" });
-      const inst = await ensureInstalled(os65);
+      const inst = await ensureInstalled(os66);
       res2.installed = inst.ok;
       if (!inst.ok) return { ...res2, error: installFailureMessage(inst) };
     }
@@ -19250,7 +19277,7 @@ async function configureCoderabbit(input, deps = {}) {
   }
   const res = base();
   if (!res.installed) {
-    const inst = await ensureInstalled(os65);
+    const inst = await ensureInstalled(os66);
     res.installed = inst.ok;
     if (!inst.ok) return { ...res, error: installFailureMessage(inst) };
   }
@@ -21073,7 +21100,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 current2 = true ? "2.63.0" : null;
+  const current2 = true ? "2.64.0" : null;
   if (!current2) return;
   const cache = readCache();
   const fresh = cache && Date.now() - cache.fetchedAt < TTL_MS;
@@ -21090,7 +21117,7 @@ function checkForUpdates() {
   if (process.env.CODEAM_DISABLE_UPDATE_CHECK === "1") return;
   if (process.env.CI) return;
   if (!process.stdout.isTTY) return;
-  const current2 = true ? "2.63.0" : null;
+  const current2 = true ? "2.64.0" : null;
   if (!current2) return;
   const cache = readCache();
   const fresh = cache && Date.now() - cache.fetchedAt < TTL_MS;
@@ -21110,7 +21137,7 @@ var SELF_UPDATE_INTERVAL_MS = 60 * 60 * 1e3;
 var SELF_UPDATE_VIEW_TIMEOUT_MS = 3e4;
 var SELF_UPDATE_INSTALL_TIMEOUT_MS = 18e4;
 function currentCliVersion() {
-  return true ? "2.63.0" : null;
+  return true ? "2.64.0" : null;
 }
 function runCmd(cmd, args2, timeoutMs) {
   return new Promise((resolve9) => {
@@ -22779,7 +22806,7 @@ async function defaultFetchJson(url2) {
 async function readUsageReport(deps = {}) {
   const port = deps.port ?? HEADROOM_PROXY_PORT;
   const base = `http://127.0.0.1:${port}`;
-  const get2 = deps.fetchJson ?? ((path90) => defaultFetchJson(`${base}${path90}`));
+  const get2 = deps.fetchJson ?? ((path91) => defaultFetchJson(`${base}${path91}`));
   let history;
   try {
     history = await get2("/stats-history");
@@ -24696,11 +24723,11 @@ function resolveDoltInstallStrategy(platform3) {
 }
 var DOLT_RELEASE_BASE = "https://github.com/dolthub/dolt/releases/latest/download";
 function doltPlatformTuple(platform3, arch2) {
-  const os65 = platform3 === "win32" ? "windows" : platform3 === "darwin" ? "darwin" : "linux";
+  const os66 = platform3 === "win32" ? "windows" : platform3 === "darwin" ? "darwin" : "linux";
   const a = arch2 === "x64" ? "amd64" : arch2 === "arm64" ? "arm64" : null;
   if (!a) return null;
-  if (os65 === "windows" && a !== "amd64") return null;
-  return `${os65}-${a}`;
+  if (os66 === "windows" && a !== "amd64") return null;
+  return `${os66}-${a}`;
 }
 function resolveDoltTarballStrategy(targetDir, platform3, arch2) {
   const tuple = doltPlatformTuple(platform3, arch2);
@@ -25761,8 +25788,14 @@ function dispatchPrompt(ctx, prompt) {
   ctx.outputSvc.newTurn();
   ctx.agent.sendCommand(prompt);
 }
-var startTask = (ctx, _cmd, parsed) => {
+var startTask = async (ctx, cmd, parsed) => {
   const { prompt, files } = parsed;
+  if (parsed.agentId && parsed.agentId !== ctx.agentId) {
+    await ctx.relay.sendResult(cmd.id, "failed", {
+      error: "Switching agents isn't supported on this session."
+    });
+    return;
+  }
   const effectivePrompt = prompt ?? "";
   if (files && files.length > 0) {
     const paths = saveFilesTemp(files);
@@ -26346,7 +26379,7 @@ var vcsAgentReviewH = async (ctx, cmd, parsed) => {
   });
   const token = ctx.pluginAuthToken;
   void (async () => {
-    const os65 = createOsStrategy();
+    const os66 = createOsStrategy();
     try {
       const report = await reviewPullRequest(
         {
@@ -26355,7 +26388,7 @@ var vcsAgentReviewH = async (ctx, cmd, parsed) => {
           baseBranch: parsed.baseBranch
         },
         {
-          runReview: (input) => new CoderabbitRuntimeStrategy(os65).runOneShot(input),
+          runReview: (input) => new CoderabbitRuntimeStrategy(os66).runOneShot(input),
           runGh: (args2) => defaultRunGh(args2),
           postReport: async (r) => {
             if (!token) return;
@@ -27458,11 +27491,11 @@ function resolveTokenValue(args2) {
   }
   const fileFlag = args2.find((a) => a.startsWith("--token-file="));
   if (fileFlag) {
-    const path90 = fileFlag.slice("--token-file=".length);
+    const path91 = fileFlag.slice("--token-file=".length);
     try {
-      const content = fs63.readFileSync(path90, "utf8").trim();
-      if (content.length === 0) fail(`--token-file ${path90} is empty`);
-      rmIfExistsQuiet(path90);
+      const content = fs63.readFileSync(path91, "utf8").trim();
+      if (content.length === 0) fail(`--token-file ${path91} is empty`);
+      rmIfExistsQuiet(path91);
       return content;
     } catch (err) {
       fail(`Could not read --token-file: ${err.message}`);
@@ -28261,11 +28294,12 @@ function kimiRuns() {
   const r = (0, import_node_child_process27.spawnSync)("kimi", ["--version"], { stdio: "ignore", timeout: 15e3 });
   return !r.error && r.status === 0;
 }
-function augmentPath2() {
+function augmentKimiPath() {
   const dir = kimiBinDir();
   const parts = (process.env.PATH ?? "").split(":");
   if (!parts.includes(dir)) process.env.PATH = `${dir}:${process.env.PATH ?? ""}`;
 }
+var augmentPath2 = augmentKimiPath;
 async function runInstaller2() {
   return new Promise((resolve9) => {
     const proc = (0, import_node_child_process27.spawn)("sh", ["-c", `curl -fsSL ${INSTALL_URL2} | bash`], { stdio: "inherit" });
@@ -28313,11 +28347,12 @@ function opencodeRuns() {
   const r = (0, import_node_child_process28.spawnSync)("opencode", ["--version"], { stdio: "ignore", timeout: 15e3 });
   return !r.error && r.status === 0;
 }
-function augmentPath3() {
+function augmentOpencodePath() {
   const dir = opencodeBinDir();
   const parts = (process.env.PATH ?? "").split(":");
   if (!parts.includes(dir)) process.env.PATH = `${dir}:${process.env.PATH ?? ""}`;
 }
+var augmentPath3 = augmentOpencodePath;
 async function runInstaller3() {
   return new Promise((resolve9) => {
     const proc = (0, import_node_child_process28.spawn)("sh", ["-c", `curl -fsSL ${INSTALL_URL3} | bash`], { stdio: "inherit" });
@@ -28459,6 +28494,7 @@ var REGISTRY = {
     // provisions it, so there we just wait for the binary to appear.
     waitForBinary: async (o) => {
       if (isLocalSession()) await ensureKimiInstalled();
+      augmentKimiPath();
       return waitForCommandOnPath("kimi", o);
     }
   }),
@@ -28474,6 +28510,7 @@ var REGISTRY = {
     requiresAgentBinary: "opencode",
     waitForBinary: async (o) => {
       if (isLocalSession()) await ensureOpencodeInstalled();
+      augmentOpencodePath();
       return waitForCommandOnPath("opencode", o);
     }
   })
@@ -34366,7 +34403,7 @@ function makeSerializedSwitchEmitter(post2) {
     return chain;
   };
 }
-async function performAgentSwitch(deps, rawAgentId) {
+async function performAgentSwitch(deps, rawAgentId, fastPath = {}) {
   const from = deps.currentAgent();
   const target = resolveSwitchTarget(rawAgentId, from);
   if (!target.ok) {
@@ -34376,27 +34413,34 @@ async function performAgentSwitch(deps, rawAgentId) {
   const emitStatus = (status2) => deps.postEvent("switch_agent_status", { ...status2 });
   const emitStep = (step) => deps.postEvent("switch_agent_progress", { step, agentId });
   const fail2 = (error) => {
+    log.warn("switchAgent", `switch ${from} \u2192 ${agentId} failed: ${error}`);
     void emitStatus({ state: "error", agentId, fromAgentId: from, error });
     return { ok: false, agentId, error };
   };
   log.info("switchAgent", `switch requested ${from} \u2192 ${agentId}`);
   void emitStatus({ state: "switching", agentId, fromAgentId: from });
-  void emitStep("credential");
-  const cred = await deps.fetchCredential(agentId);
-  if (!cred) {
-    return fail2(
-      `No linked credential for ${displayName(agentId)}. Link it in Profile \u203A Agents first.`
-    );
+  let installScript;
+  if (!fastPath.skipProvision) {
+    void emitStep("credential");
+    const cred = await deps.fetchCredential(agentId);
+    if (!cred) {
+      return fail2(
+        `No linked credential for ${displayName(agentId)}. Link it in Profile \u203A Agents first.`
+      );
+    }
+    try {
+      deps.provisionCredential(agentId, toAgentAuth(cred.method, cred.credential));
+    } catch (err) {
+      log.warn("switchAgent", `credential provisioning failed: ${err.message}`);
+      return fail2(`Couldn't write the ${displayName(agentId)} credential on this machine.`);
+    }
+    installScript = cred.installScript;
   }
-  try {
-    deps.provisionCredential(agentId, toAgentAuth(cred.method, cred.credential));
-  } catch (err) {
-    log.warn("switchAgent", `credential provisioning failed: ${err.message}`);
-    return fail2(`Couldn't write the ${displayName(agentId)} credential on this machine.`);
+  if (!fastPath.skipInstall) {
+    void emitStep("install");
+    const bin = await deps.ensureBinary(agentId, installScript);
+    if (!bin.ok) return fail2(bin.error);
   }
-  void emitStep("install");
-  const bin = await deps.ensureBinary(agentId, cred.installScript);
-  if (!bin.ok) return fail2(bin.error);
   void emitStep("restart");
   try {
     await deps.swapRuntime(agentId);
@@ -34423,6 +34467,121 @@ async function performAgentSwitch(deps, rawAgentId) {
   return { ok: true, agentId };
 }
 
+// src/agents/acp/squad-roster.ts
+var fs67 = __toESM(require("fs"));
+var os58 = __toESM(require("os"));
+var path74 = __toESM(require("path"));
+var PROMPT_MAX = 500;
+var REPLY_SUMMARY_MAX = 1e3;
+var PREAMBLE_MAX = 2e3;
+var BRIEFING_DEFAULT_MAX = 8e3;
+var GENERIC_SPECIALTY = "general implementation tasks";
+function clip(s, max) {
+  return s.length > max ? s.slice(0, max) : s;
+}
+function defaultMember() {
+  return { acpSessionId: null, provisioned: false, binaryVerified: false, lastTurnIndex: 0 };
+}
+function journalPathFor(homeDir2, sessionId) {
+  return path74.join(homeDir2, ".codeam", `squad-journal-${sessionId}.json`);
+}
+function loadJournal(journalPath) {
+  try {
+    const raw = JSON.parse(fs67.readFileSync(journalPath, "utf-8"));
+    return Array.isArray(raw.turns) ? raw.turns : [];
+  } catch {
+    return [];
+  }
+}
+var SquadState = class {
+  /** Set by the caller after fetchSquadRoster; null until then. */
+  roster = null;
+  journalPath;
+  turns;
+  members = /* @__PURE__ */ new Map();
+  constructor(opts) {
+    this.journalPath = journalPathFor(opts.homeDir ?? os58.homedir(), opts.sessionId);
+    this.turns = loadJournal(this.journalPath);
+  }
+  /** Returns (creating on first access) the mutable per-agent state. */
+  member(agentId) {
+    let m = this.members.get(agentId);
+    if (!m) {
+      m = defaultMember();
+      this.members.set(agentId, m);
+    }
+    return m;
+  }
+  /** Appends a journal entry and persists (fire-and-forget durability). */
+  recordTurn(entry) {
+    const turn = {
+      turn: this.turns.length + 1,
+      agentId: entry.agentId,
+      prompt: clip(entry.prompt, PROMPT_MAX),
+      replySummary: clip(entry.replySummary, REPLY_SUMMARY_MAX),
+      filesTouched: entry.filesTouched
+    };
+    this.turns.push(turn);
+    this.persist();
+  }
+  turnCount() {
+    return this.turns.length;
+  }
+  entriesSince(turnIndex) {
+    return this.turns.filter((t2) => t2.turn > turnIndex);
+  }
+  persist() {
+    try {
+      fs67.mkdirSync(path74.dirname(this.journalPath), { recursive: true, mode: 448 });
+      fs67.writeFileSync(this.journalPath, JSON.stringify({ turns: this.turns }), { mode: 384 });
+    } catch {
+    }
+  }
+};
+function specialtyFor(agentId) {
+  return SQUAD_SPECIALTIES[agentId] ?? GENERIC_SPECIALTY;
+}
+function buildTeamPreamble(roster, currentAgent, opts) {
+  const others = roster.agents.filter((a) => a.agentId !== currentAgent);
+  if (others.length === 0) return null;
+  const lines = [
+    "[Team context] You are the active agent in a CodeAgent Mobile session where the user",
+    "has a squad of agents and can pass work between them. Your available teammates:",
+    ...others.map((a) => `- ${a.displayName} \u2014 best at: ${specialtyFor(a.agentId)}`)
+  ];
+  if (opts.handoffInstructions) {
+    lines.push(
+      "If a task clearly fits a teammate better than you, you MAY propose a handoff by ending",
+      `your reply with a fenced code block tagged ${HANDOFF_FENCE_TAG} containing ONE JSON object:`,
+      '{"to":"<teammate id>","reason":"<one sentence>","prompt":"<the prompt they should run>"}',
+      "Propose at most one handoff per reply, only when genuinely better, and never announce",
+      "the block in prose \u2014 the app renders it as a card the user can accept."
+    );
+  }
+  return clip(lines.join("\n"), PREAMBLE_MAX);
+}
+function renderJournalEntry(e) {
+  const filesClause = e.filesTouched.length > 0 ? ` (files: ${e.filesTouched.join(", ")})` : "";
+  return `- turn ${e.turn} (${e.agentId}): ${e.prompt} \u2192 ${e.replySummary}${filesClause}`;
+}
+function buildDeltaBriefing(entries, maxChars = BRIEFING_DEFAULT_MAX) {
+  if (entries.length === 0) return null;
+  const header = "[Team update] While you were away, other agents worked on this session:";
+  const footer = "Continue from the CURRENT state of the working tree.";
+  const envelope = header.length + 1 + footer.length + 1;
+  const sorted = [...entries].sort((a, b) => a.turn - b.turn);
+  const lines = [];
+  let bodyLen = 0;
+  for (let i = sorted.length - 1; i >= 0; i--) {
+    const line = renderJournalEntry(sorted[i]);
+    const addedLen = line.length + (lines.length > 0 ? 1 : 0);
+    if (lines.length > 0 && envelope + bodyLen + addedLen > maxChars) break;
+    lines.unshift(line);
+    bodyLen += addedLen;
+  }
+  return [header, lines.join("\n"), footer].join("\n");
+}
+
 // src/services/streaming/transport.ts
 var http7 = __toESM(require("http"));
 var https8 = __toESM(require("https"));
@@ -34868,17 +35027,95 @@ function commonPrefixLength(a, b) {
   return i;
 }
 
+// src/agents/acp/handoff-protocol.ts
+var REASON_MAX = 1e3;
+var PROMPT_MAX2 = 8e3;
+var FENCE_OPEN = "```" + HANDOFF_FENCE_TAG;
+var FENCE_RE = new RegExp("```" + HANDOFF_FENCE_TAG + "\\s*\\n([\\s\\S]*?)\\n?```", "g");
+var OUTER_FENCE_RE = /(`{4,})[\s\S]*?\1/g;
+var outerFencePlaceholder = (i) => `@@HANDOFF_MASK_${i}@@`;
+function maskOuterFences(text) {
+  const spans = [];
+  const masked = text.replace(OUTER_FENCE_RE, (m) => {
+    const token = outerFencePlaceholder(spans.length);
+    spans.push(m);
+    return token;
+  });
+  const restore = (s) => spans.reduce((acc, span, i) => acc.split(outerFencePlaceholder(i)).join(span), s);
+  return { masked, restore };
+}
+function parseProposal(raw, currentAgent, validTargets) {
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    log.debug("handoffProtocol", "dropped proposal: malformed JSON");
+    return null;
+  }
+  if (typeof parsed !== "object" || parsed === null) {
+    log.debug("handoffProtocol", "dropped proposal: not a JSON object");
+    return null;
+  }
+  const { to, reason, prompt } = parsed;
+  if (typeof to !== "string" || to.length === 0) {
+    log.debug("handoffProtocol", 'dropped proposal: missing/invalid "to"');
+    return null;
+  }
+  if (!validTargets.has(to)) {
+    log.debug("handoffProtocol", `dropped proposal: unknown target "${to}"`);
+    return null;
+  }
+  if (to === currentAgent) {
+    log.debug("handoffProtocol", "dropped proposal: target is the current agent");
+    return null;
+  }
+  if (typeof reason !== "string" || reason.length === 0 || reason.length > REASON_MAX) {
+    log.debug("handoffProtocol", 'dropped proposal: invalid "reason"');
+    return null;
+  }
+  if (typeof prompt !== "string" || prompt.length === 0 || prompt.length > PROMPT_MAX2) {
+    log.debug("handoffProtocol", 'dropped proposal: invalid "prompt"');
+    return null;
+  }
+  return { to, reason, prompt };
+}
+function stripFences(masked) {
+  const stripped = masked.replace(FENCE_RE, "");
+  return stripped.replace(/(?:\r?\n){3,}/g, "\n\n").trim();
+}
+function extractHandoffProposal(text, currentAgent, validTargets) {
+  const { masked, restore } = maskOuterFences(text);
+  const matches = [...masked.matchAll(FENCE_RE)];
+  if (matches.length === 0) {
+    return { cleanText: text, proposal: null };
+  }
+  const last = matches[matches.length - 1];
+  const proposal = parseProposal(last[1].trim(), currentAgent, validTargets);
+  const cleanText = restore(stripFences(masked));
+  return { cleanText, proposal };
+}
+function stripHandoffFences(text) {
+  const { masked, restore } = maskOuterFences(text);
+  if (masked.search(FENCE_RE) === -1) {
+    return text;
+  }
+  return restore(stripFences(masked));
+}
+function handoffFenceStart(text) {
+  return text.indexOf(FENCE_OPEN);
+}
+
 // src/agents/acp/onboarding.ts
 var import_child_process28 = require("child_process");
-var fs67 = __toESM(require("fs"));
-var os58 = __toESM(require("os"));
-var path74 = __toESM(require("path"));
+var fs68 = __toESM(require("fs"));
+var os59 = __toESM(require("os"));
+var path75 = __toESM(require("path"));
 var _onboardingSeam = {
-  markerPath: (sessionId) => path74.join(os58.homedir(), ".codeam", "welcomed", `${sessionId}.done`),
-  exists: (p2) => fs67.existsSync(p2),
+  markerPath: (sessionId) => path75.join(os59.homedir(), ".codeam", "welcomed", `${sessionId}.done`),
+  exists: (p2) => fs68.existsSync(p2),
   write: (p2) => {
-    fs67.mkdirSync(path74.dirname(p2), { recursive: true });
-    fs67.writeFileSync(p2, "");
+    fs68.mkdirSync(path75.dirname(p2), { recursive: true });
+    fs68.writeFileSync(p2, "");
   },
   disabled: () => {
     const v = process.env.CODEAM_ONBOARDING_DISABLED;
@@ -34915,7 +35152,7 @@ function resolveRepoName(cwd) {
       if (name) return name;
     }
   }
-  const base = path74.basename(cwd || "");
+  const base = path75.basename(cwd || "");
   if (base && !isUuid(base)) return base;
   return "this project";
 }
@@ -35173,13 +35410,13 @@ var import_crypto5 = require("crypto");
 
 // src/services/turn-files/git-changeset.ts
 var import_child_process29 = require("child_process");
-var fs69 = __toESM(require("fs/promises"));
-var path76 = __toESM(require("path"));
+var fs70 = __toESM(require("fs/promises"));
+var path77 = __toESM(require("path"));
 
 // src/services/turn-files/review-ignore.ts
 var import_ignore2 = __toESM(require("ignore"));
-var fs68 = __toESM(require("fs"));
-var path75 = __toESM(require("path"));
+var fs69 = __toESM(require("fs"));
+var path76 = __toESM(require("path"));
 var CURATED_REVIEW_IGNORE = [
   // Google Cloud SDK (the incident) — installs a huge python tree.
   "google-cloud-sdk/",
@@ -35218,7 +35455,7 @@ var CURATED_REVIEW_IGNORE = [
 function makeReviewIgnore(repoRoot) {
   const ig = (0, import_ignore2.default)().add(CURATED_REVIEW_IGNORE);
   try {
-    const custom = fs68.readFileSync(path75.join(repoRoot, ".codeam", "reviewignore"), "utf8");
+    const custom = fs69.readFileSync(path76.join(repoRoot, ".codeam", "reviewignore"), "utf8");
     ig.add(custom);
   } catch {
   }
@@ -35263,7 +35500,7 @@ async function collectRepoChangeset(opts) {
     let stats;
     if (!truncated && row.fileStatus === "added" && numstatEntry === void 0) {
       const lineCount = await readUntrackedLineCount(
-        path76.join(opts.repoRoot, row.filePath)
+        path77.join(opts.repoRoot, row.filePath)
       );
       stats = { added: lineCount, removed: 0 };
     } else {
@@ -35294,7 +35531,7 @@ function readUntrackedLineCount(absPath) {
 }
 async function defaultReadUntrackedLineCount(absPath) {
   try {
-    const content = await fs69.readFile(absPath, "utf8");
+    const content = await fs70.readFile(absPath, "utf8");
     let count = 0;
     let pos = -1;
     while ((pos = content.indexOf("\n", pos + 1)) !== -1) {
@@ -35386,7 +35623,7 @@ function defaultRunGit(cwd, args2) {
   });
 }
 async function discoverRepos(workingDir, maxDepth = 4) {
-  const fs79 = await import("fs/promises");
+  const fs80 = await import("fs/promises");
   const out2 = [];
   await walk(workingDir, 0);
   return out2;
@@ -35394,7 +35631,7 @@ async function discoverRepos(workingDir, maxDepth = 4) {
     if (depth > maxDepth) return;
     let entries = [];
     try {
-      const dirents = await fs79.readdir(dir, { withFileTypes: true });
+      const dirents = await fs80.readdir(dir, { withFileTypes: true });
       entries = dirents.filter((d3) => !d3.name.startsWith(".") || d3.name === ".git").map((d3) => ({ name: d3.name, isDirectory: d3.isDirectory() }));
     } catch {
       return;
@@ -35405,8 +35642,8 @@ async function discoverRepos(workingDir, maxDepth = 4) {
     if (hasGit) {
       out2.push({
         repoRoot: dir,
-        repoPath: path76.relative(workingDir, dir),
-        repoName: path76.basename(dir)
+        repoPath: path77.relative(workingDir, dir),
+        repoName: path77.basename(dir)
       });
       return;
     }
@@ -35414,14 +35651,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(path76.join(dir, entry.name), depth + 1);
+      await walk(path77.join(dir, entry.name), depth + 1);
     }
   }
 }
 
 // src/services/turn-files/files-outbox.ts
-var fs70 = __toESM(require("fs/promises"));
-var path77 = __toESM(require("path"));
+var fs71 = __toESM(require("fs/promises"));
+var path78 = __toESM(require("path"));
 var import_os12 = require("os");
 var HOME_OUTBOX_DIR = ".codeam/outbox";
 var MAX_AGE_MS = 24 * 60 * 60 * 1e3;
@@ -35454,16 +35691,16 @@ var FilesOutbox = class {
   backoffIndex = 0;
   stopped = false;
   constructor(opts) {
-    const base = opts.baseDir ?? path77.join(homeDir(), HOME_OUTBOX_DIR);
-    this.filePath = path77.join(base, `${opts.sessionId}.jsonl`);
+    const base = opts.baseDir ?? path78.join(homeDir(), HOME_OUTBOX_DIR);
+    this.filePath = path78.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 fs70.mkdir(path77.dirname(this.filePath), { recursive: true });
-    await fs70.appendFile(this.filePath, JSON.stringify(entry) + "\n", "utf8");
+    await fs71.mkdir(path78.dirname(this.filePath), { recursive: true });
+    await fs71.appendFile(this.filePath, JSON.stringify(entry) + "\n", "utf8");
     this.backoffIndex = 0;
     if (this.autoSchedule) this.scheduleFlush(0);
   }
@@ -35554,7 +35791,7 @@ var FilesOutbox = class {
   async readAll() {
     let raw = "";
     try {
-      raw = await fs70.readFile(this.filePath, "utf8");
+      raw = await fs71.readFile(this.filePath, "utf8");
     } catch {
       return [];
     }
@@ -35578,12 +35815,12 @@ var FilesOutbox = class {
   async rewrite(entries) {
     const tmpPath = `${this.filePath}.${process.pid}.tmp`;
     if (entries.length === 0) {
-      await fs70.unlink(this.filePath).catch(() => void 0);
+      await fs71.unlink(this.filePath).catch(() => void 0);
       return;
     }
     const payload = entries.map((e) => JSON.stringify(e)).join("\n") + "\n";
-    await fs70.writeFile(tmpPath, payload, "utf8");
-    await fs70.rename(tmpPath, this.filePath);
+    await fs71.writeFile(tmpPath, payload, "utf8");
+    await fs71.rename(tmpPath, this.filePath);
   }
 };
 function applyJitter(ms) {
@@ -36039,8 +36276,8 @@ async function postBudgetReached(opts, fetchImpl = fetch) {
 
 // src/packs/gates.ts
 var import_node_child_process30 = require("child_process");
-var fs71 = __toESM(require("fs"));
-var path78 = __toESM(require("path"));
+var fs72 = __toESM(require("fs"));
+var path79 = __toESM(require("path"));
 var defaultCommandRunner = (file, args2, cwd, timeoutMs) => new Promise((resolve9) => {
   (0, import_node_child_process30.execFile)(
     file,
@@ -36077,14 +36314,14 @@ var NO_TEST_PLACEHOLDER = 'echo "Error: no test specified"';
 var CHECKS_TIMEOUT_MS = 5 * 6e4;
 function detectChecksCommand(cwd) {
   try {
-    const cfg = JSON.parse(fs71.readFileSync(path78.join(cwd, ".codeam", "pack.json"), "utf8"));
+    const cfg = JSON.parse(fs72.readFileSync(path79.join(cwd, ".codeam", "pack.json"), "utf8"));
     if (typeof cfg.checksCommand === "string" && cfg.checksCommand.trim().length > 0) {
       return cfg.checksCommand.trim();
     }
   } catch {
   }
   try {
-    const pkg = JSON.parse(fs71.readFileSync(path78.join(cwd, "package.json"), "utf8"));
+    const pkg = JSON.parse(fs72.readFileSync(path79.join(cwd, "package.json"), "utf8"));
     const test = pkg.scripts?.test;
     if (typeof test === "string" && test.trim().length > 0 && !test.includes(NO_TEST_PLACEHOLDER)) {
       return "npm test";
@@ -36102,39 +36339,39 @@ ${res.stderr}`.trim();
 }
 
 // src/packs/run-store.ts
-var fs72 = __toESM(require("fs"));
-var path79 = __toESM(require("path"));
+var fs73 = __toESM(require("fs"));
+var path80 = __toESM(require("path"));
 var crypto5 = __toESM(require("crypto"));
 function packsDir(cwd) {
-  return path79.join(cwd, ".codeam", "packs");
+  return path80.join(cwd, ".codeam", "packs");
 }
 function runDir(cwd, runId) {
-  return path79.join(packsDir(cwd), runId);
+  return path80.join(packsDir(cwd), runId);
 }
 function newRunId() {
   return `pk_${Date.now().toString(36)}_${crypto5.randomBytes(4).toString("hex")}`;
 }
 function writeJsonAtomic(file, value) {
-  fs72.mkdirSync(path79.dirname(file), { recursive: true });
+  fs73.mkdirSync(path80.dirname(file), { recursive: true });
   const tmp = `${file}.tmp`;
-  fs72.writeFileSync(tmp, JSON.stringify(value, null, 2));
-  fs72.renameSync(tmp, file);
+  fs73.writeFileSync(tmp, JSON.stringify(value, null, 2));
+  fs73.renameSync(tmp, file);
 }
 function saveRun(cwd, state) {
-  writeJsonAtomic(path79.join(runDir(cwd, state.runId), "run.json"), state);
+  writeJsonAtomic(path80.join(runDir(cwd, state.runId), "run.json"), state);
 }
 function saveStageHandoff(cwd, runId, stageIndex, role, handoff) {
   const name = `${String(stageIndex + 1).padStart(2, "0")}-${role}.json`;
-  writeJsonAtomic(path79.join(runDir(cwd, runId), name), handoff);
+  writeJsonAtomic(path80.join(runDir(cwd, runId), name), handoff);
 }
 function loadLatestRun(cwd) {
   try {
     const dir = packsDir(cwd);
-    const entries = fs72.readdirSync(dir, { withFileTypes: true }).filter((e) => e.isDirectory()).map((e) => e.name).sort();
+    const entries = fs73.readdirSync(dir, { withFileTypes: true }).filter((e) => e.isDirectory()).map((e) => e.name).sort();
     for (let i = entries.length - 1; i >= 0; i--) {
-      const file = path79.join(dir, entries[i], "run.json");
+      const file = path80.join(dir, entries[i], "run.json");
       try {
-        const parsed = JSON.parse(fs72.readFileSync(file, "utf8"));
+        const parsed = JSON.parse(fs73.readFileSync(file, "utf8"));
         if (parsed && typeof parsed.runId === "string") return parsed;
       } catch {
       }
@@ -36145,17 +36382,17 @@ function loadLatestRun(cwd) {
 }
 function ensureLedgerIgnored(cwd) {
   try {
-    const gitDir = path79.join(cwd, ".git");
-    if (!fs72.existsSync(gitDir)) return;
-    const exclude = path79.join(gitDir, "info", "exclude");
+    const gitDir = path80.join(cwd, ".git");
+    if (!fs73.existsSync(gitDir)) return;
+    const exclude = path80.join(gitDir, "info", "exclude");
     let existing = "";
     try {
-      existing = fs72.readFileSync(exclude, "utf8");
+      existing = fs73.readFileSync(exclude, "utf8");
     } catch {
     }
     if (existing.includes(".codeam/packs/")) return;
-    fs72.mkdirSync(path79.dirname(exclude), { recursive: true });
-    fs72.writeFileSync(exclude, `${existing.trimEnd()}
+    fs73.mkdirSync(path80.dirname(exclude), { recursive: true });
+    fs73.writeFileSync(exclude, `${existing.trimEnd()}
 .codeam/packs/
 `.trimStart());
   } catch {
@@ -36746,35 +36983,35 @@ function buildAcpPromptBlocks(payload) {
 }
 
 // src/agents/agent-standard.ts
-var fs74 = __toESM(require("fs"));
-var path81 = __toESM(require("path"));
-var os59 = __toESM(require("os"));
-function ensureAgentStandard(homeDir2 = os59.homedir()) {
+var fs75 = __toESM(require("fs"));
+var path82 = __toESM(require("path"));
+var os60 = __toESM(require("os"));
+function ensureAgentStandard(homeDir2 = os60.homedir()) {
   try {
-    const file = path81.join(homeDir2, ".claude", "CLAUDE.md");
+    const file = path82.join(homeDir2, ".claude", "CLAUDE.md");
     let existing = "";
     try {
-      existing = fs74.readFileSync(file, "utf8");
+      existing = fs75.readFileSync(file, "utf8");
     } catch {
     }
     if (existing.includes(AGENT_STANDARD_MARKER)) return;
-    fs74.mkdirSync(path81.dirname(file), { recursive: true });
+    fs75.mkdirSync(path82.dirname(file), { recursive: true });
     const next = existing.trim() ? `${existing.trimEnd()}
 
 ${AGENT_STANDARD_BLOCK}
 ` : `${AGENT_STANDARD_BLOCK}
 `;
-    fs74.writeFileSync(file, next);
+    fs75.writeFileSync(file, next);
   } catch {
   }
 }
 var _agentStandardSeam = {
   isLocalSession: () => isLocalSession(),
-  markerPath: (sessionId) => path81.join(os59.homedir(), ".codeam", "agent-standard", `${sessionId}.done`),
-  exists: (p2) => fs74.existsSync(p2),
+  markerPath: (sessionId) => path82.join(os60.homedir(), ".codeam", "agent-standard", `${sessionId}.done`),
+  exists: (p2) => fs75.existsSync(p2),
   write: (p2) => {
-    fs74.mkdirSync(path81.dirname(p2), { recursive: true });
-    fs74.writeFileSync(p2, "");
+    fs75.mkdirSync(path82.dirname(p2), { recursive: true });
+    fs75.writeFileSync(p2, "");
   }
 };
 function isClaude(agent) {
@@ -36878,20 +37115,111 @@ async function beadsActionH(ctx) {
   }
   return;
 }
+function rebindSessionHandles(ctx, outcome) {
+  Object.assign(ctx, outcome.handles);
+  return outcome;
+}
+async function routeSquadTask(ctx, target) {
+  const { squad, routeToAgent } = ctx;
+  if (!routeToAgent) {
+    return { ok: false, error: "Routing to another agent is not supported on this session." };
+  }
+  const roster = squad?.roster;
+  if (roster && !roster.agents.some((a) => a.agentId === target)) {
+    return { ok: false, error: `Unknown agent '${target}' \u2014 not in your squad.` };
+  }
+  const member = squad?.member(target);
+  const fastPathArmed = Boolean(member && (member.provisioned || member.binaryVerified));
+  let { result } = rebindSessionHandles(ctx, await routeToAgent(target));
+  if (!result.ok && fastPathArmed) {
+    log.warn(
+      "acpRunner",
+      `squad: fast-path route to ${target} failed (${result.error}) \u2014 retrying full path`
+    );
+    ({ result } = rebindSessionHandles(ctx, await routeToAgent(target, { skipFastPath: true })));
+  }
+  if (!result.ok) {
+    return { ok: false, error: result.error ?? `Couldn't switch to ${target}.` };
+  }
+  return { ok: true };
+}
+function prefixSquadContext(ctx, blocks) {
+  if (ctx.pendingHandoff?.current) {
+    blocks.unshift({ type: "text", text: ctx.pendingHandoff.current });
+    ctx.pendingHandoff.current = null;
+  }
+  const { squad, opts } = ctx;
+  if (!squad) return;
+  const member = squad.member(opts.agent);
+  if (squad.turnCount() > member.lastTurnIndex) {
+    const otherEntries = squad.entriesSince(member.lastTurnIndex).filter((e) => e.agentId !== opts.agent);
+    const briefing = buildDeltaBriefing(otherEntries);
+    if (briefing) blocks.unshift({ type: "text", text: briefing });
+  }
+  const roster = squad.roster;
+  if (roster && member.lastTurnIndex === 0) {
+    const preamble = buildTeamPreamble(roster, opts.agent, {
+      handoffInstructions: roster.handoffsEnabled === true
+    });
+    if (preamble) blocks.unshift({ type: "text", text: preamble });
+  }
+}
+function recordSquadTurn(ctx, prompt, replySummary) {
+  const { squad, opts } = ctx;
+  if (!squad) return;
+  squad.recordTurn({
+    agentId: opts.agent,
+    prompt,
+    replySummary,
+    // TurnFileAggregator owns per-turn file changesets end-to-end (git diff →
+    // outbox POST) and exposes no path list, and its flush is fire-and-forget,
+    // so there is nothing accurate to attribute synchronously here. The
+    // briefing simply omits the files clause rather than guessing.
+    filesTouched: []
+  });
+  squad.member(opts.agent).lastTurnIndex = squad.turnCount();
+}
+function handoffTargets(ctx) {
+  const roster = ctx.squad?.roster;
+  if (!roster) return /* @__PURE__ */ new Set();
+  return new Set(roster.agents.map((a) => a.agentId).filter((id) => id !== ctx.opts.agent));
+}
+function resolvePendingProposal(ctx, requestedAgentId) {
+  const slot = ctx.pendingProposal;
+  const pending = slot?.current;
+  if (!slot || !pending) return;
+  slot.current = null;
+  const accepted = requestedAgentId === pending.toAgentId;
+  log.info(
+    "acpRunner",
+    `squad: handoff ${pending.proposalId} ${accepted ? "accepted" : "declined"}`
+  );
+  void ctx.postSquadEvent?.("handoff_resolved", {
+    proposalId: pending.proposalId,
+    accepted
+  });
+}
+function emitHandoffProposal(ctx, proposal) {
+  const { squad, pendingProposal, postSquadEvent, opts, cmd } = ctx;
+  if (!proposal || !pendingProposal || !postSquadEvent) return;
+  if (squad?.roster?.handoffsEnabled !== true) return;
+  if (pendingProposal.current) {
+    log.info("acpRunner", "squad: dropping handoff proposal \u2014 one is already pending");
+    return;
+  }
+  const record2 = {
+    proposalId: `hp-${cmd.id}`,
+    fromAgentId: opts.agent,
+    toAgentId: proposal.to,
+    reason: proposal.reason,
+    prompt: proposal.prompt
+  };
+  pendingProposal.current = record2;
+  log.info("acpRunner", `squad: handoff proposed ${opts.agent} \u2192 ${record2.toAgentId}`);
+  void postSquadEvent("handoff_proposed", { ...record2 });
+}
 async function startTaskH(ctx) {
-  const {
-    cmd,
-    client: client3,
-    relay,
-    streaming,
-    opts,
-    history,
-    turnFiles,
-    publisher,
-    recentStderr,
-    budgetRecovery,
-    budgetReachedFlag
-  } = ctx;
+  const { cmd, relay, streaming, opts, turnFiles, publisher, recentStderr, budgetReachedFlag } = ctx;
   const payload = cmd.payload;
   const blocks = buildAcpPromptBlocks(payload ?? {});
   if (blocks.length === 0) {
@@ -36899,6 +37227,17 @@ async function startTaskH(ctx) {
     await relay.sendResult(cmd.id, "failed", { error: "empty prompt" });
     return;
   }
+  const requestedAgentId = typeof payload?.agentId === "string" ? payload.agentId.trim() : "";
+  resolvePendingProposal(ctx, requestedAgentId);
+  if (requestedAgentId.length > 0 && requestedAgentId !== opts.agent) {
+    const routed = await routeSquadTask(ctx, requestedAgentId);
+    if (!routed.ok) {
+      log.warn("acpRunner", `start_task routing to ${requestedAgentId} failed: ${routed.error}`);
+      await relay.sendResult(cmd.id, "failed", { error: routed.error });
+      return;
+    }
+  }
+  const { client: client3, history, budgetRecovery } = ctx;
   const promptText = blocks.filter((b) => b.type === "text").map((b) => b.text).join("\n");
   const imageCount = blocks.filter((b) => b.type === "image").length;
   log.info(
@@ -36912,10 +37251,7 @@ async function startTaskH(ctx) {
   await streaming.beginTurn();
   history.appendUserPrompt(promptText);
   maybePrefaceAgentStandard(blocks, opts.agent, opts.sessionId);
-  if (ctx.pendingHandoff?.current) {
-    blocks.unshift({ type: "text", text: ctx.pendingHandoff.current });
-    ctx.pendingHandoff.current = null;
-  }
+  prefixSquadContext(ctx, blocks);
   let turnClosed = false;
   try {
     const reply = await client3.prompt(blocks);
@@ -36967,12 +37303,19 @@ async function startTaskH(ctx) {
     } else {
       await streaming.closeTurnWithInteractiveDetection();
       turnClosed = true;
-      const replyLine = formatAgentReplyLine(finalText);
+      const { cleanText, proposal } = extractHandoffProposal(
+        finalText,
+        opts.agent,
+        handoffTargets(ctx)
+      );
+      const replyLine = formatAgentReplyLine(cleanText);
       if (replyLine.length > 0) {
         showInfo(replyLine);
       }
-      history.appendAgentReply(finalText);
+      history.appendAgentReply(cleanText);
       void history.flush();
+      recordSquadTurn(ctx, promptText, cleanText);
+      emitHandoffProposal(ctx, proposal);
       void publisher.publishOutput({
         type: "input_suggestion",
         content: ACP_QUICK_REPLIES,
@@ -37771,14 +38114,18 @@ var StreamingState = class {
     }
     const cumulativeContent = reconcileCumulative(existing?.content ?? "", delta.delta);
     this.streamingChunks.set(chunkId, { kind: delta.kind, content: cumulativeContent });
+    let fenceCut = -1;
     if (delta.kind === "text") {
       this.recomputeText();
-      void this.publisher.publishOutput({ type: "text", content: this.text, done: false });
+      fenceCut = handoffFenceStart(this.text);
+      const visibleText = fenceCut === -1 ? this.text : this.text.slice(0, fenceCut).trimEnd();
+      void this.publisher.publishOutput({ type: "text", content: visibleText, done: false });
     }
+    const visibleChunkContent = delta.kind === "text" && fenceCut !== -1 ? cumulativeContent.slice(0, fenceCut).trimEnd() : cumulativeContent;
     void this.publisher.publishStreamingChunk({
       chunkId,
       kind: delta.kind,
-      content: cumulativeContent,
+      content: visibleChunkContent,
       isFinal: false
     });
   }
@@ -37808,8 +38155,27 @@ var StreamingState = class {
    * spuriously and strand the runner with a free-form pending state
    * the user can't see / answer.
    */
+  /**
+   * Presentation-only view of a text buffer: everything BEFORE a
+   * ```codeam-handoff fence. The fence is protocol litter the app renders as
+   * a proposal card (see `handoff-protocol.ts`) — it must never reach the
+   * user, and the TERMINAL frames (`done:true` / `isFinal:true`) are the ones
+   * that persist, so suppressing it only while streaming would still leave it
+   * pinned on the finished bubble. Internal state is untouched:
+   * {@link getCurrentText} keeps returning the RAW text so the turn-close
+   * extraction can parse the proposal out of it.
+   *
+   * Masked-aware (`stripHandoffFences`), unlike the live-stream `append()`
+   * cut (`handoffFenceStart`, unmasked): a TERMINAL frame is the one that
+   * PERSISTS, so cutting on a fence quoted as an example inside a
+   * 4+-backtick block here would permanently truncate the bubble. The live
+   * cut stays unmasked/cheap — a mid-stream example is never terminal.
+   */
+  visible(text) {
+    return stripHandoffFences(text);
+  }
   async closeAll() {
-    const finalText = this.text;
+    const finalText = this.visible(this.text);
     this.text = "";
     await Promise.all([
       this.publisher.publishOutput({ type: "text", content: finalText, done: true }),
@@ -37853,7 +38219,9 @@ var StreamingState = class {
         ([chunkId, { kind, content }]) => this.publisher.publishStreamingChunk({
           chunkId,
           kind,
-          content,
+          // Terminal frame — same fence suppression the live deltas apply, so
+          // a proposal fence never survives on the finalised bubble.
+          content: kind === "text" ? this.visible(content) : content,
           isFinal: true
         })
       )
@@ -37880,7 +38248,7 @@ var StreamingState = class {
    * text done:true chunk with the full cumulative).
    */
   async closeTurnWithInteractiveDetection() {
-    const finalText = this.text;
+    const finalText = this.visible(this.text);
     this.text = "";
     const flushSc = this.flushStreamingChunks();
     const extracted = extractSelectPrompt(finalText);
@@ -38383,13 +38751,32 @@ async function runAcpSession(opts) {
           acpSessionId = id;
         },
         switchAgentForSession,
-        pendingHandoff
+        pendingHandoff,
+        // Agent Squad: roster/journal state, the @-mention route, the
+        // single-slot proposal, and the SAME serialized event chain the
+        // switch uses (so proposal events can't overtake switch events).
+        squad,
+        routeToAgent,
+        pendingProposal,
+        emitSwitchEvent
       );
     },
     { id: opts.agent, name: opts.agent, displayName: opts.agent }
   );
   const HANDOFF_MAX_CHARS = 16e3;
   const pendingHandoff = { current: null };
+  const squad = new SquadState({ sessionId: opts.sessionId });
+  const refreshSquadRoster = () => {
+    void fetchSquadRoster({
+      sessionId: opts.sessionId,
+      pluginId: opts.pluginId,
+      pluginAuthToken: opts.pluginAuthToken
+    }).then((roster) => {
+      if (roster) squad.roster = roster;
+    });
+  };
+  refreshSquadRoster();
+  const pendingProposal = { current: null };
   let switchCredentialEnv = {};
   const relaunchWith = async (nextAgent) => {
     try {
@@ -38399,6 +38786,7 @@ async function runAcpSession(opts) {
     await streaming.closeAll();
     const prevAgent = opts.agent;
     const transcript = history.recentTranscript(HANDOFF_MAX_CHARS);
+    squad.member(prevAgent).acpSessionId = acpSessionId;
     await client3.stop();
     const adapter = await resolveAcpAdapterWithRetry(nextAgent);
     if (!adapter) throw new Error(`no ACP adapter available for ${nextAgent}`);
@@ -38448,31 +38836,74 @@ async function runAcpSession(opts) {
       payload
     })
   );
-  const switchAgentForSession = (rawAgentId) => performAgentSwitch(
-    {
-      currentAgent: () => opts.agent,
-      postEvent: emitSwitchEvent,
-      fetchCredential: (agentId) => fetchProvisionCredential({
-        agentId,
-        sessionId: opts.sessionId,
-        pluginId: opts.pluginId,
-        pluginAuthToken: opts.pluginAuthToken,
-        includeInstallScript: true
-      }),
-      provisionCredential: (agentId, auth) => {
-        switchCredentialEnv = provisionAgentCredentials(agentId, auth);
-      },
-      ensureBinary: (agentId, installScript) => ensureAgentBinaryForSwitch(agentId, installScript),
-      swapRuntime: relaunchWith,
-      revertRuntime: relaunchWith,
-      persistAgent: (agentId) => setSessionAgent(opts.pluginId, agentId),
-      reannounce: (agentId) => {
-        relay.setAgentMeta({ id: agentId, name: agentId, displayName: agentId });
-        relay.reannounceAgents();
-      }
+  const switchDeps = {
+    currentAgent: () => opts.agent,
+    postEvent: emitSwitchEvent,
+    fetchCredential: (agentId) => fetchProvisionCredential({
+      agentId,
+      sessionId: opts.sessionId,
+      pluginId: opts.pluginId,
+      pluginAuthToken: opts.pluginAuthToken,
+      includeInstallScript: true
+    }),
+    provisionCredential: (agentId, auth) => {
+      switchCredentialEnv = provisionAgentCredentials(agentId, auth);
     },
-    rawAgentId
-  );
+    ensureBinary: (agentId, installScript) => ensureAgentBinaryForSwitch(agentId, installScript),
+    swapRuntime: relaunchWith,
+    revertRuntime: relaunchWith,
+    persistAgent: (agentId) => setSessionAgent(opts.pluginId, agentId),
+    reannounce: (agentId) => {
+      relay.setAgentMeta({ id: agentId, name: agentId, displayName: agentId });
+      relay.reannounceAgents();
+    }
+  };
+  const switchAgentForSession = async (rawAgentId) => {
+    const result = await performAgentSwitch(switchDeps, rawAgentId);
+    if (result.ok) refreshSquadRoster();
+    return result;
+  };
+  const sessionHandles = () => ({
+    client: client3,
+    acpSessionId,
+    history,
+    jsonlHistory,
+    agentCaps,
+    budgetRecovery
+  });
+  const routeToAgent = async (target, routeOpts = {}) => {
+    const m = squad.member(target);
+    const fast = routeOpts.skipFastPath !== true;
+    const result = await performAgentSwitch(switchDeps, target, {
+      skipProvision: fast && m.provisioned,
+      skipInstall: fast && m.binaryVerified
+    });
+    if (!result.ok) {
+      if (fast) {
+        m.provisioned = false;
+        m.binaryVerified = false;
+      }
+      return { result, handles: sessionHandles() };
+    }
+    m.provisioned = true;
+    m.binaryVerified = true;
+    if (m.acpSessionId && agentCaps?.loadSession) {
+      try {
+        await client3.loadSession(m.acpSessionId);
+        acpSessionId = m.acpSessionId;
+        history.switchActiveSession(m.acpSessionId);
+        pendingHandoff.current = null;
+        log.info(
+          "acpRunner",
+          `squad: resumed ${target}'s conversation ${m.acpSessionId.slice(0, 8)}`
+        );
+      } catch (err) {
+        log.warn("acpRunner", `squad: resume for ${target} failed: ${describeError(err)}`);
+      }
+    }
+    refreshSquadRoster();
+    return { result, handles: sessionHandles() };
+  };
   await onboardingWelcomeDone;
   relay.start();
   void createWakeCredentialProbe({
@@ -38503,7 +38934,7 @@ async function runAcpSession(opts) {
   await new Promise(() => {
   });
 }
-async function handleCommand(cmd, client3, relay, acpSessionId, streaming, opts, history, jsonlHistory, agentCaps, turnFiles, getBeads, publisher, recentStderr, budgetRecovery, budgetReachedFlag, onActiveSessionChanged, switchAgent, pendingHandoff) {
+async function handleCommand(cmd, client3, relay, acpSessionId, streaming, opts, history, jsonlHistory, agentCaps, turnFiles, getBeads, publisher, recentStderr, budgetRecovery, budgetReachedFlag, onActiveSessionChanged, switchAgent, pendingHandoff, squad, routeToAgent, pendingProposal, postSquadEvent) {
   const session = {
     client: client3,
     relay,
@@ -38521,7 +38952,11 @@ async function handleCommand(cmd, client3, relay, acpSessionId, streaming, opts,
     budgetReachedFlag,
     onActiveSessionChanged,
     switchAgent,
-    pendingHandoff
+    pendingHandoff,
+    squad,
+    routeToAgent,
+    pendingProposal,
+    postSquadEvent
   };
   await dispatchAcpCommand(assembleAcpCommandContext(session, cmd));
 }
@@ -39581,9 +40016,9 @@ function startClaudeCredentialSync(opts) {
 }
 
 // src/beads/workflow-hint.ts
-var fs75 = __toESM(require("fs"));
-var path82 = __toESM(require("path"));
-var os60 = __toESM(require("os"));
+var fs76 = __toESM(require("fs"));
+var path83 = __toESM(require("path"));
+var os61 = __toESM(require("os"));
 var BEADS_HINT_MARKER = "<!-- codeam:beads-workflow -->";
 var BEADS_HINT = `${BEADS_HINT_MARKER}
 # Beads (bd) \u2014 task tracking + persistent memory (ALWAYS use it)
@@ -39597,22 +40032,22 @@ This environment uses **bd (beads)** for issue/task tracking and persistent memo
 - \`bd ready\` (available work) \xB7 \`bd show <id>\` \xB7 \`bd update <id> --claim\` \xB7 \`bd close <id>\`.
 - Use \`bd remember "..."\` for persistent knowledge \u2014 do NOT use MEMORY.md files.
 ${BEADS_HINT_MARKER}`;
-function ensureBeadsWorkflowHint(homeDir2 = os60.homedir()) {
+function ensureBeadsWorkflowHint(homeDir2 = os61.homedir()) {
   try {
-    const file = path82.join(homeDir2, ".claude", "CLAUDE.md");
+    const file = path83.join(homeDir2, ".claude", "CLAUDE.md");
     let existing = "";
     try {
-      existing = fs75.readFileSync(file, "utf8");
+      existing = fs76.readFileSync(file, "utf8");
     } catch {
     }
     if (existing.includes(BEADS_HINT_MARKER)) return;
-    fs75.mkdirSync(path82.dirname(file), { recursive: true });
+    fs76.mkdirSync(path83.dirname(file), { recursive: true });
     const next = existing.trim() ? `${existing.trimEnd()}
 
 ${BEADS_HINT}
 ` : `${BEADS_HINT}
 `;
-    fs75.writeFileSync(file, next);
+    fs76.writeFileSync(file, next);
   } catch {
   }
 }
@@ -39984,7 +40419,7 @@ var AcpDriver = class {
 };
 
 // src/baton/transcript-mirror.ts
-var fs76 = __toESM(require("fs"));
+var fs77 = __toESM(require("fs"));
 var TranscriptMirror = class {
   constructor(deps) {
     this.deps = deps;
@@ -40051,7 +40486,7 @@ var TranscriptMirror = class {
   }
 };
 function defaultWatch(file, onChange) {
-  const w3 = fs76.watch(file, { persistent: false }, () => onChange());
+  const w3 = fs77.watch(file, { persistent: false }, () => onChange());
   return () => w3.close();
 }
 
@@ -40349,16 +40784,16 @@ function keepDeviceAwake(deps = {}) {
 }
 
 // src/agents/claude/onboarding.ts
-var fs77 = __toESM(require("fs"));
-var os62 = __toESM(require("os"));
-var path83 = __toESM(require("path"));
+var fs78 = __toESM(require("fs"));
+var os63 = __toESM(require("os"));
+var path84 = __toESM(require("path"));
 var ONBOARDING_VERSION_SENTINEL = "9999.0.0";
 function ensureClaudeOnboarded(cwd) {
   try {
-    const file = path83.join(os62.homedir(), ".claude.json");
+    const file = path84.join(os63.homedir(), ".claude.json");
     let config = {};
     try {
-      config = JSON.parse(fs77.readFileSync(file, "utf8"));
+      config = JSON.parse(fs78.readFileSync(file, "utf8"));
     } catch {
     }
     let changed = false;
@@ -40383,8 +40818,8 @@ function ensureClaudeOnboarded(cwd) {
       }
     }
     if (!changed) return;
-    fs77.mkdirSync(path83.dirname(file), { recursive: true });
-    fs77.writeFileSync(file, JSON.stringify(config, null, 2));
+    fs78.mkdirSync(path84.dirname(file), { recursive: true });
+    fs78.writeFileSync(file, JSON.stringify(config, null, 2));
     log.info(
       "claude",
       `pre-completed Claude onboarding${cwd ? ` + trusted workspace ${cwd}` : ""}`
@@ -41116,7 +41551,7 @@ var import_picocolors11 = __toESM(require("picocolors"));
 var import_child_process30 = require("child_process");
 var import_util4 = require("util");
 var import_picocolors9 = __toESM(require("picocolors"));
-var path84 = __toESM(require("path"));
+var path85 = __toESM(require("path"));
 var execFileP6 = (0, import_util4.promisify)(import_child_process30.execFile);
 var MAX_BUFFER = 8 * 1024 * 1024;
 function resetStdinForChild() {
@@ -41605,7 +42040,7 @@ var GitHubCodespacesProvider = class {
     });
   }
   async uploadFile(workspaceId, remotePath, contents, options = {}) {
-    const remoteDir = path84.posix.dirname(remotePath);
+    const remoteDir = path85.posix.dirname(remotePath);
     const parts = [
       `mkdir -p ${shellQuote(remoteDir)}`,
       `cat > ${shellQuote(remotePath)}`
@@ -41675,7 +42110,7 @@ function shellQuote(s) {
 // src/services/providers/gitpod.ts
 var import_child_process31 = require("child_process");
 var import_util5 = require("util");
-var path85 = __toESM(require("path"));
+var path86 = __toESM(require("path"));
 var import_picocolors10 = __toESM(require("picocolors"));
 var execFileP7 = (0, import_util5.promisify)(import_child_process31.execFile);
 var MAX_BUFFER2 = 8 * 1024 * 1024;
@@ -41915,7 +42350,7 @@ var GitpodProvider = class {
     });
   }
   async uploadFile(workspaceId, remotePath, contents, options = {}) {
-    const remoteDir = path85.posix.dirname(remotePath);
+    const remoteDir = path86.posix.dirname(remotePath);
     const parts = [
       `mkdir -p ${shellQuote2(remoteDir)}`,
       `cat > ${shellQuote2(remotePath)}`
@@ -41951,7 +42386,7 @@ function shellQuote2(s) {
 // src/services/providers/gitlab-workspaces.ts
 var import_child_process32 = require("child_process");
 var import_util6 = require("util");
-var path86 = __toESM(require("path"));
+var path87 = __toESM(require("path"));
 var execFileP8 = (0, import_util6.promisify)(import_child_process32.execFile);
 var MAX_BUFFER3 = 8 * 1024 * 1024;
 var GITLAB_API_BASE = process.env.CODEAM_GITLAB_API_URL ?? "https://gitlab.com/api/v4";
@@ -42211,7 +42646,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 = path86.posix.dirname(remotePath);
+    const remoteDir = path87.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)}`);
@@ -42279,7 +42714,7 @@ function shellQuote3(s) {
 // src/services/providers/railway.ts
 var import_child_process33 = require("child_process");
 var import_util7 = require("util");
-var path87 = __toESM(require("path"));
+var path88 = __toESM(require("path"));
 var execFileP9 = (0, import_util7.promisify)(import_child_process33.execFile);
 var MAX_BUFFER4 = 8 * 1024 * 1024;
 function resetStdinForChild4() {
@@ -42515,7 +42950,7 @@ var RailwayProvider = class {
     if (!projectId || !serviceId) {
       throw new Error("Invalid Railway workspace id (expected projectId/serviceId).");
     }
-    const remoteDir = path87.posix.dirname(remotePath);
+    const remoteDir = path88.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)}`);
@@ -43161,8 +43596,8 @@ async function invite() {
 var import_node_dns = require("dns");
 var import_node_util5 = require("util");
 var import_node_crypto13 = require("crypto");
-var fs78 = __toESM(require("fs"));
-var path88 = __toESM(require("path"));
+var fs79 = __toESM(require("fs"));
+var path89 = __toESM(require("path"));
 var import_picocolors14 = __toESM(require("picocolors"));
 var dnsResolveP = (0, import_node_util5.promisify)(import_node_dns.resolve);
 async function checkDns(apiBase2) {
@@ -43218,13 +43653,13 @@ async function checkHealth(apiBase2) {
   }
 }
 function checkConfigDir() {
-  const dir = path88.join(require("os").homedir(), ".codeam");
+  const dir = path89.join(require("os").homedir(), ".codeam");
   try {
-    fs78.mkdirSync(dir, { recursive: true, mode: 448 });
-    const probe = path88.join(dir, ".doctor-probe");
-    fs78.writeFileSync(probe, "ok", { mode: 384 });
-    const read2 = fs78.readFileSync(probe, "utf8");
-    fs78.unlinkSync(probe);
+    fs79.mkdirSync(dir, { recursive: true, mode: 448 });
+    const probe = path89.join(dir, ".doctor-probe");
+    fs79.writeFileSync(probe, "ok", { mode: 384 });
+    const read2 = fs79.readFileSync(probe, "utf8");
+    fs79.unlinkSync(probe);
     if (read2 !== "ok") throw new Error("write/read round-trip mismatch");
     return {
       id: "config-dir",
@@ -43264,9 +43699,9 @@ function checkSessions() {
   }
 }
 function checkAgentBinaries() {
-  const os65 = createOsStrategy();
+  const os66 = createOsStrategy();
   return getEnabledAgents().map((meta) => {
-    const found = os65.findInPath(meta.binaryName);
+    const found = os66.findInPath(meta.binaryName);
     return {
       id: `agent-${meta.id}`,
       label: `Agent binary: ${meta.displayName} (${meta.binaryName})`,
@@ -43288,7 +43723,7 @@ function checkNodePty() {
       detail: "not required on this platform"
     };
   }
-  const vendoredPath = path88.join(__dirname, "vendor", "node-pty");
+  const vendoredPath = path89.join(__dirname, "vendor", "node-pty");
   for (const target of [vendoredPath, "node-pty"]) {
     try {
       require(target);
@@ -43330,7 +43765,7 @@ function checkChokidar() {
 }
 async function doctor(args2 = []) {
   const json = args2.includes("--json");
-  const cliVersion = true ? "2.63.0" : "0.0.0-dev";
+  const cliVersion = true ? "2.64.0" : "0.0.0-dev";
   const apiBase2 = resolveApiBaseUrl();
   const diagnosticId = (0, import_node_crypto13.randomUUID)();
   log.info("doctor", `run id=${diagnosticId} cli=${cliVersion}`);
@@ -43721,7 +44156,7 @@ async function mcpRun(args2) {
 // src/commands/version.ts
 var import_picocolors15 = __toESM(require("picocolors"));
 function version2() {
-  const v = true ? "2.63.0" : "unknown";
+  const v = true ? "2.64.0" : "unknown";
   console.log(`${import_picocolors15.default.bold("codeam-cli")} ${import_picocolors15.default.cyan(v)}`);
 }
 
@@ -43870,10 +44305,10 @@ var EXIT_CODE_NAMES = {
 };
 
 // src/index.ts
-var os64 = __toESM(require("os"));
+var os65 = __toESM(require("os"));
 if (!process.env.HOME) {
   try {
-    const home = os64.homedir();
+    const home = os65.homedir();
     if (home) process.env.HOME = home;
   } catch {
   }