@raysonmeng/agentbridge 0.1.6 → 0.1.8

package/plugins/agentbridge/server/daemon.js

@@ -1,14 +1,50 @@
 #!/usr/bin/env bun
 // @bun
 
-// src/daemon.ts
-import { appendFileSync as appendFileSync2 } from "fs";
+// src/contract-version.ts
+var CONTRACT_VERSION = 1;
+
+// src/build-info.ts
+function defineString(value, fallback) {
+  return typeof value === "string" && value.length > 0 ? value : fallback;
+}
+function defineBundle(value) {
+  if (value === "source" || value === "dist" || value === "plugin")
+    return value;
+  return import.meta.url.endsWith(".ts") ? "source" : "dist";
+}
+function defineNumber(value, fallback) {
+  return typeof value === "number" && Number.isFinite(value) ? value : fallback;
+}
+var BUILD_INFO = Object.freeze({
+  version: defineString("0.1.8", "0.0.0-source"),
+  commit: defineString("c80a7fd", "source"),
+  bundle: defineBundle("plugin"),
+  contractVersion: defineNumber(1, CONTRACT_VERSION)
+});
+function daemonStatusBuildInfo() {
+  return { ...BUILD_INFO };
+}
+function sameRuntimeContract(a, b) {
+  if (!a || !b)
+    return false;
+  return a.version === b.version && a.commit === b.commit && a.contractVersion === b.contractVersion;
+}
+function compatibleContractVersion(a, b) {
+  if (!a || !b)
+    return false;
+  return a.contractVersion === b.contractVersion;
+}
+function formatBuildInfo(build) {
+  if (!build)
+    return "<unknown>";
+  return `${build.version}/${build.commit}/${build.bundle}/contract-v${build.contractVersion}`;
+}
 
 // src/codex-adapter.ts
-import { spawn, execSync } from "child_process";
+import { spawn, execFileSync } from "child_process";
 import { createInterface } from "readline";
 import { EventEmitter } from "events";
-import { appendFileSync } from "fs";
 
 // src/state-dir.ts
 import { mkdirSync, existsSync } from "fs";
@@ -17,16 +53,16 @@ import { homedir, platform } from "os";
 
 class StateDirResolver {
   stateDir;
+  static platformBaseDir() {
+    if (platform() === "darwin") {
+      return join(homedir(), "Library", "Application Support", "AgentBridge");
+    }
+    const xdgState = process.env.XDG_STATE_HOME ?? join(homedir(), ".local", "state");
+    return join(xdgState, "agentbridge");
+  }
   constructor(envOverride) {
     const override = envOverride ?? process.env.AGENTBRIDGE_STATE_DIR;
-    if (override) {
-      this.stateDir = override;
-    } else if (platform() === "darwin") {
-      this.stateDir = join(homedir(), "Library", "Application Support", "AgentBridge");
-    } else {
-      const xdgState = process.env.XDG_STATE_HOME ?? join(homedir(), ".local", "state");
-      this.stateDir = join(xdgState, "agentbridge");
-    }
+    this.stateDir = override && override.length > 0 ? override : StateDirResolver.platformBaseDir();
   }
   ensure() {
     if (!existsSync(this.stateDir)) {
@@ -51,6 +87,9 @@ class StateDirResolver {
   get portsFile() {
     return join(this.stateDir, "ports.json");
   }
+  get currentThreadFile() {
+    return join(this.stateDir, "current-thread.json");
+  }
   get logFile() {
     return join(this.stateDir, "agentbridge.log");
   }
@@ -60,6 +99,224 @@ class StateDirResolver {
   get killedFile() {
     return join(this.stateDir, "killed");
   }
+  get updateCheckFile() {
+    return join(this.stateDir, "update-check.json");
+  }
+}
+
+// src/port-cleanup.ts
+function portPidsCommand(port, platform2 = process.platform) {
+  if (platform2 === "win32") {
+    return {
+      cmd: "powershell.exe",
+      args: [
+        "-NoProfile",
+        "-Command",
+        `Get-NetTCPConnection -LocalPort ${port} -State Listen -ErrorAction SilentlyContinue | Select-Object -ExpandProperty OwningProcess -Unique`
+      ]
+    };
+  }
+  return { cmd: "lsof", args: ["-ti", `tcp:${port}`, "-sTCP:LISTEN"] };
+}
+function processCommandLineCommand(pid, platform2 = process.platform) {
+  if (platform2 === "win32") {
+    return {
+      cmd: "powershell.exe",
+      args: [
+        "-NoProfile",
+        "-Command",
+        `$p = Get-CimInstance Win32_Process -Filter "ProcessId = ${pid}" -ErrorAction SilentlyContinue; if ($p -and $p.CommandLine) { $p.CommandLine }`
+      ]
+    };
+  }
+  return { cmd: "ps", args: ["-p", pid, "-o", "args="] };
+}
+function killPidCommand(pid, platform2 = process.platform) {
+  if (platform2 === "win32") {
+    return {
+      cmd: "powershell.exe",
+      args: ["-NoProfile", "-Command", `Stop-Process -Id ${pid} -Force -ErrorAction Stop`]
+    };
+  }
+  return { cmd: "kill", args: [pid] };
+}
+function parsePids(output) {
+  const seen = new Set;
+  const pids = [];
+  for (const line of output.split(/\r?\n/)) {
+    const pid = line.trim();
+    if (!/^\d+$/.test(pid))
+      continue;
+    if (pid === "0")
+      continue;
+    if (seen.has(pid))
+      continue;
+    seen.add(pid);
+    pids.push(pid);
+  }
+  return pids;
+}
+function isCodexAppServerCommandLine(cmdline, platform2 = process.platform) {
+  const s = platform2 === "win32" ? cmdline.toLowerCase() : cmdline;
+  return s.includes("codex") && s.includes("app-server");
+}
+async function cleanupPorts(options) {
+  const platform2 = options.platform ?? process.platform;
+  const listPids = (port) => {
+    try {
+      return parsePids(options.run(portPidsCommand(port, platform2)));
+    } catch {
+      return [];
+    }
+  };
+  for (const { port, envVar } of options.ports) {
+    const pidList = listPids(port);
+    if (pidList.length === 0)
+      continue;
+    const staleCodexPids = [];
+    const foreignPids = [];
+    for (const pid of pidList) {
+      try {
+        const cmdline = options.run(processCommandLineCommand(pid, platform2)).trim();
+        if (isCodexAppServerCommandLine(cmdline, platform2)) {
+          staleCodexPids.push(pid);
+        } else {
+          foreignPids.push(pid);
+        }
+      } catch {}
+    }
+    if (staleCodexPids.length > 0) {
+      options.log(`Cleaning up stale codex app-server on port ${port}: PID(s) ${staleCodexPids.join(", ")}`);
+      for (const pid of staleCodexPids) {
+        try {
+          options.run(killPidCommand(pid, platform2));
+        } catch {}
+      }
+      await options.sleep(500);
+    }
+    if (foreignPids.length > 0) {
+      throw new Error(`Port ${port} is already in use by non-Codex process(es): PID(s) ${foreignPids.join(", ")}. ` + `Please stop the process or set a different port via ${envVar} env var.`);
+    }
+    const remaining = listPids(port);
+    if (remaining.length > 0) {
+      throw new Error(`Port ${port} is still occupied (PID(s): ${remaining.join(", ")}) after cleanup. ` + `Please stop the process or set a different port via ${envVar} env var.`);
+    }
+  }
+}
+
+// src/rotating-log.ts
+import { appendFileSync, existsSync as existsSync2, renameSync, statSync, unlinkSync } from "fs";
+import { dirname } from "path";
+var DEFAULT_MAX_BYTES = 5 * 1024 * 1024;
+var DEFAULT_KEEP = 3;
+function appendRotatingLog(path, content, options = {}) {
+  const maxBytes = options.maxBytes ?? positiveIntFromEnv("AGENTBRIDGE_LOG_MAX_BYTES", DEFAULT_MAX_BYTES);
+  const keep = options.keep ?? positiveIntFromEnv("AGENTBRIDGE_LOG_ROTATE_KEEP", DEFAULT_KEEP);
+  if (!existsSync2(dirname(path)))
+    return;
+  rotateIfNeeded(path, Buffer.byteLength(content), maxBytes, keep);
+  appendFileSync(path, content, "utf-8");
+}
+function positiveIntFromEnv(name, fallback) {
+  const value = process.env[name];
+  if (!value)
+    return fallback;
+  const parsed = Number(value);
+  return Number.isFinite(parsed) && parsed > 0 ? Math.floor(parsed) : fallback;
+}
+function rotateIfNeeded(path, incomingBytes, maxBytes, keep) {
+  if (!Number.isFinite(maxBytes) || maxBytes <= 0 || keep <= 0)
+    return;
+  if (!existsSync2(path))
+    return;
+  const size = statSync(path).size;
+  if (size + incomingBytes <= maxBytes)
+    return;
+  for (let index = keep;index >= 1; index--) {
+    const current = `${path}.${index}`;
+    const next = `${path}.${index + 1}`;
+    if (!existsSync2(current))
+      continue;
+    if (index === keep) {
+      unlinkSync(current);
+    } else {
+      renameSync(current, next);
+    }
+  }
+  renameSync(path, `${path}.1`);
+}
+
+// src/process-log.ts
+var stderrStates = new WeakMap;
+function createProcessLogger(options) {
+  let fatalInProgress = false;
+  const stderr = options.stderr ?? process.stderr;
+  const stderrState = stateForStderr(stderr);
+  const write = (message) => {
+    const line = `[${new Date().toISOString()}] [${options.component}] ${message}
+`;
+    if (options.logFile) {
+      try {
+        appendRotatingLog(options.logFile, line);
+      } catch {}
+    }
+    if (!stderrState.enabled)
+      return;
+    try {
+      stderr.write(line);
+    } catch (error) {
+      if (error?.code === "EPIPE")
+        stderrState.enabled = false;
+    }
+  };
+  return {
+    log: write,
+    fatal(label, error) {
+      if (fatalInProgress)
+        return;
+      fatalInProgress = true;
+      try {
+        write(`${label}: ${safeFormatError(error)}`);
+      } finally {
+        fatalInProgress = false;
+      }
+    }
+  };
+}
+function stateForStderr(stderr) {
+  const key = stderr;
+  let state = stderrStates.get(key);
+  if (state)
+    return state;
+  state = { enabled: true };
+  stderrStates.set(key, state);
+  if (typeof stderr.on === "function") {
+    stderr.on("error", (error) => {
+      if (error?.code === "EPIPE") {
+        state.enabled = false;
+        return;
+      }
+      setTimeout(() => {
+        throw error;
+      }, 0);
+    });
+  }
+  return state;
+}
+function safeFormatError(error) {
+  try {
+    return formatError(error);
+  } catch {
+    return "<failed to format error>";
+  }
+}
+function formatError(error) {
+  if (error instanceof Error)
+    return error.stack ?? error.message;
+  if (typeof error === "object" && error !== null && "stack" in error) {
+    return String(error.stack);
+  }
+  return String(error);
 }
 
 // src/app-server-protocol.ts
@@ -105,18 +362,263 @@ function isAppServerResponseMessage(value) {
   return (typeof value.id === "number" || typeof value.id === "string") && value.method === undefined && (("result" in value) || ("error" in value));
 }
 
+// src/codex-transport.ts
+import { createServer, connect } from "net";
+import { spawnSync } from "child_process";
+import { mkdirSync as mkdirSync2, rmSync, chmodSync } from "fs";
+import { join as join2 } from "path";
+import { tmpdir } from "os";
+var CODEX_TRANSPORT_ENV = "AGENTBRIDGE_CODEX_TRANSPORT";
+var HEADER_SEP = `\r
+\r
+`;
+var EXTENSIONS_HEADER_RE = /^sec-websocket-extensions:/i;
+var MAX_UPGRADE_HEADER_BYTES = 64 * 1024;
+function parseTransportMode(raw) {
+  switch ((raw ?? "").trim().toLowerCase()) {
+    case "ws":
+      return "ws";
+    case "unix":
+      return "unix";
+    case "auto":
+    case "":
+      return "auto";
+    default:
+      return "auto";
+  }
+}
+function probeCodexWsSupport(runHelp = defaultRunCodexAppServerHelp) {
+  const help = runHelp();
+  if (help === null)
+    return true;
+  return help.includes("ws://");
+}
+function defaultRunCodexAppServerHelp() {
+  try {
+    const res = spawnSync("codex", ["app-server", "--help"], {
+      encoding: "utf-8",
+      timeout: 5000
+    });
+    if (res.error || typeof res.stdout !== "string")
+      return null;
+    return res.stdout + (res.stderr ?? "");
+  } catch {
+    return null;
+  }
+}
+function resolveCodexTransport(mode, runHelp = defaultRunCodexAppServerHelp) {
+  if (mode === "ws")
+    return "ws";
+  if (mode === "unix")
+    return "unix";
+  return probeCodexWsSupport(runHelp) ? "ws" : "unix";
+}
+function codexSocketPath(appPort, baseTmpDir = tmpdir()) {
+  const uid = typeof process.getuid === "function" ? process.getuid() : 0;
+  const dir = join2(baseTmpDir, `agentbridge-${uid}`);
+  const path = join2(dir, `codex-${appPort}.sock`);
+  if (path.length >= 104) {
+    throw new Error(`Codex unix socket path is too long for the platform (${path.length} >= 104): ${path}. ` + `Set a shorter TMPDIR or use ${CODEX_TRANSPORT_ENV}=ws.`);
+  }
+  return path;
+}
+function ensureSocketDir(socketPath) {
+  const dir = socketPath.slice(0, socketPath.lastIndexOf("/"));
+  if (!dir)
+    return;
+  mkdirSync2(dir, { recursive: true, mode: 448 });
+  try {
+    chmodSync(dir, 448);
+  } catch (err) {
+    throw new Error(`Refusing to use Codex socket dir ${dir}: cannot enforce 0700 perms ` + `(${err.message}). Remove it or set a private TMPDIR.`);
+  }
+}
+function removeSocketFile(socketPath) {
+  try {
+    rmSync(socketPath, { force: true });
+  } catch {}
+}
+function codexListenArg(transport, appPort, socketPath) {
+  return transport === "unix" ? `unix://${socketPath}` : `ws://127.0.0.1:${appPort}`;
+}
+function stripWebSocketExtensions(headerBlock) {
+  return headerBlock.split(`\r
+`).filter((line) => !EXTENSIONS_HEADER_RE.test(line)).join(`\r
+`);
+}
+
+class TcpToUnixRelay {
+  tcpHost;
+  tcpPort;
+  unixPath;
+  log;
+  server = null;
+  pairs = new Set;
+  constructor(tcpHost, tcpPort, unixPath, log = () => {}) {
+    this.tcpHost = tcpHost;
+    this.tcpPort = tcpPort;
+    this.unixPath = unixPath;
+    this.log = log;
+  }
+  start() {
+    return new Promise((resolve, reject) => {
+      const server = createServer((tcp) => this.handleConnection(tcp));
+      const onListenError = (err) => {
+        server.removeListener("listening", onListening);
+        reject(err);
+      };
+      const onListening = () => {
+        server.removeListener("error", onListenError);
+        server.on("error", (err) => this.log(`relay server error: ${err.message}`));
+        this.server = server;
+        resolve();
+      };
+      server.once("error", onListenError);
+      server.once("listening", onListening);
+      server.listen(this.tcpPort, this.tcpHost);
+    });
+  }
+  handleConnection(tcp) {
+    const unix = connect(this.unixPath);
+    const pair = { tcp, unix };
+    this.pairs.add(pair);
+    let closed = false;
+    const teardown = () => {
+      if (closed)
+        return;
+      closed = true;
+      this.pairs.delete(pair);
+      tcp.destroy();
+      unix.destroy();
+    };
+    let head = Buffer.alloc(0);
+    const onData = (chunk) => {
+      head = Buffer.concat([head, chunk]);
+      const sep = head.indexOf(HEADER_SEP);
+      if (sep === -1) {
+        if (head.length > MAX_UPGRADE_HEADER_BYTES) {
+          tcp.removeListener("data", onData);
+          unix.write(head);
+          head = Buffer.alloc(0);
+          tcp.pipe(unix);
+        }
+        return;
+      }
+      tcp.removeListener("data", onData);
+      const headers = head.subarray(0, sep).toString("utf8");
+      const rest = head.subarray(sep + HEADER_SEP.length);
+      unix.write(stripWebSocketExtensions(headers) + HEADER_SEP);
+      head = Buffer.alloc(0);
+      if (rest.length)
+        tcp.unshift(rest);
+      tcp.pipe(unix);
+    };
+    tcp.on("data", onData);
+    unix.pipe(tcp);
+    tcp.on("error", (e) => {
+      this.log(`relay tcp error: ${e.message}`);
+      teardown();
+    });
+    unix.on("error", (e) => {
+      this.log(`relay unix error: ${e.message}`);
+      teardown();
+    });
+    tcp.on("close", teardown);
+    unix.on("close", teardown);
+  }
+  get connectionCount() {
+    return this.pairs.size;
+  }
+  get port() {
+    const addr = this.server?.address();
+    return addr && typeof addr === "object" ? addr.port : this.tcpPort;
+  }
+  stop() {
+    if (this.server) {
+      this.server.close();
+      this.server = null;
+    }
+    for (const { tcp, unix } of this.pairs) {
+      tcp.destroy();
+      unix.destroy();
+    }
+    this.pairs.clear();
+  }
+}
+async function waitForUnixWsReady(socketPath, maxRetries = 40, delayMs = 250) {
+  for (let i = 0;i < maxRetries; i++) {
+    if (await attemptUnixWsUpgrade(socketPath))
+      return;
+    await new Promise((r) => setTimeout(r, delayMs));
+  }
+  throw new Error(`Codex unix app-server at ${socketPath} did not become ready`);
+}
+function attemptUnixWsUpgrade(socketPath) {
+  return new Promise((resolve) => {
+    let settled = false;
+    const done = (ok) => {
+      if (settled)
+        return;
+      settled = true;
+      try {
+        socket.destroy();
+      } catch {}
+      resolve(ok);
+    };
+    const socket = connect(socketPath, () => {
+      socket.write(`GET / HTTP/1.1\r
+Host: localhost\r
+Upgrade: websocket\r
+Connection: Upgrade\r
+` + `Sec-WebSocket-Key: dGhlIHNhbXBsZSBub25jZQ==\r
+Sec-WebSocket-Version: 13\r
+\r
+`);
+    });
+    let buf = "";
+    socket.on("data", (d) => {
+      buf += d.toString("utf8");
+      if (buf.includes(`\r
+`))
+        done(buf.startsWith("HTTP/1.1 101"));
+    });
+    socket.on("error", () => done(false));
+    socket.on("close", () => done(false));
+    setTimeout(() => done(false), 1500);
+  });
+}
+
+// src/turn-notices.ts
+var ADAPTER_DISCONNECT_REASON = "adapter disconnect";
+var APP_SERVER_RECONNECT_NEW_TUI_REASON = "app-server reconnect for new TUI session";
+var SILENT_ABORT_REASONS = new Set([
+  ADAPTER_DISCONNECT_REASON,
+  APP_SERVER_RECONNECT_NEW_TUI_REASON
+]);
+function buildTurnAbortedNotice(reason, replyWasRequired) {
+  if (SILENT_ABORT_REASONS.has(reason))
+    return null;
+  const tail = replyWasRequired ? " A reply you were waiting on will NOT arrive \u2014 retry your last message, or wait for the Codex TUI to reconnect." : " If you were waiting on a reply it will not arrive; retry, or wait for the Codex TUI to reconnect.";
+  return `\u26A0\uFE0F Codex's current turn ended without completing (${reason}). ` + "This usually means Codex hit an error (e.g. a rate limit / 429), the app-server connection dropped, or the turn was interrupted." + tail;
+}
+
 // src/codex-adapter.ts
 class CodexAdapter extends EventEmitter {
   static RESPONSE_TRACKING_TTL_MS = 30000;
   proc = null;
+  appServerPid = null;
   appServerWs = null;
   tuiWs = null;
   proxyServer = null;
+  transport = "ws";
+  socketPath = null;
+  relay = null;
   threadId = null;
   nextInjectionId = -1;
   appPort;
   proxyPort;
   logFile;
+  logger;
   tuiConnId = 0;
   connIdCounter = 0;
   secondaryConnections = new Map;
@@ -124,6 +626,12 @@ class CodexAdapter extends EventEmitter {
   pendingRequests = new Map;
   activeTurnIds = new Set;
   turnInProgress = false;
+  turnWatchdogs = new Map;
+  stalledTurnIds = new Set;
+  currentlyStalledTurnIds = new Set;
+  lastTurnEndedAbnormally = false;
+  lastEmittedPhase = "idle";
+  threadSwitchSeq = 0;
   nextProxyId = 1e5;
   upstreamToClient = new Map;
   serverRequestToProxy = new Map;
@@ -131,6 +639,7 @@ class CodexAdapter extends EventEmitter {
   pendingServerResponses = new Map;
   staleProxyIds = new Map;
   bridgeRequestIds = new Map;
+  bridgeRequestKinds = new Map;
   intentionalDisconnect = false;
   pendingTuiMessages = [];
   reconnectingForNewSession = false;
@@ -139,7 +648,7 @@ class CodexAdapter extends EventEmitter {
   outageQueue = [];
   outageTimer = null;
   static OUTAGE_QUEUE_MAX = 64;
-  static OUTAGE_TIMEOUT_MS = 5000;
+  static OUTAGE_TIMEOUT_MS = 1e4;
   lastInitializeRaw = null;
   lastInitializedRaw = null;
   sessionRestoreInProgress = false;
@@ -150,6 +659,7 @@ class CodexAdapter extends EventEmitter {
     this.appPort = appPort;
     this.proxyPort = proxyPort;
     this.logFile = logFile;
+    this.logger = createProcessLogger({ component: "CodexAdapter", logFile: this.logFile });
   }
   get appServerUrl() {
     return `ws://127.0.0.1:${this.appPort}`;
@@ -163,21 +673,44 @@ class CodexAdapter extends EventEmitter {
   async start() {
     this.intentionalDisconnect = false;
     await this.checkPorts();
-    this.log(`Spawning codex app-server on ${this.appServerUrl}`);
-    this.proc = spawn("codex", ["app-server", "--listen", this.appServerUrl], {
+    this.resolveTransport();
+    const listen = codexListenArg(this.transport, this.appPort, this.socketPath ?? "");
+    if (this.transport === "unix" && this.socketPath) {
+      ensureSocketDir(this.socketPath);
+      removeSocketFile(this.socketPath);
+    }
+    this.log(`Spawning codex app-server (transport=${this.transport}) --listen ${listen}`);
+    this.proc = spawn("codex", ["app-server", "--listen", listen], {
       stdio: ["pipe", "pipe", "pipe"]
     });
+    this.appServerPid = this.proc.pid ?? null;
     this.proc.on("error", (err) => this.emit("error", err));
-    this.proc.on("exit", (code) => this.emit("exit", code));
+    this.proc.on("exit", (code) => {
+      this.appServerPid = null;
+      this.emit("exit", code);
+    });
     const stderrRl = createInterface({ input: this.proc.stderr });
     stderrRl.on("line", (l) => this.log(`[codex-server] ${l}`));
     const stdoutRl = createInterface({ input: this.proc.stdout });
     stdoutRl.on("line", (l) => this.log(`[codex-stdout] ${l}`));
-    await this.waitForHealthy();
+    if (this.transport === "unix" && this.socketPath) {
+      await waitForUnixWsReady(this.socketPath);
+      this.relay = new TcpToUnixRelay("127.0.0.1", this.appPort, this.socketPath, (m) => this.log(`[relay] ${m}`));
+      await this.relay.start();
+      this.log(`Transport relay ready: ws://127.0.0.1:${this.appPort} \u2192 unix://${this.socketPath}`);
+    } else {
+      await this.waitForHealthy();
+    }
     await this.connectToAppServer();
     this.startProxy();
     this.log(`Proxy ready on ${this.proxyUrl}`);
   }
+  resolveTransport() {
+    const mode = parseTransportMode(process.env[CODEX_TRANSPORT_ENV]);
+    this.transport = resolveCodexTransport(mode);
+    this.socketPath = this.transport === "unix" ? codexSocketPath(this.appPort) : null;
+    this.log(`Codex transport mode=${mode} resolved=${this.transport}`);
+  }
   disconnect() {
     this.intentionalDisconnect = true;
     if (this.reconnectTimer) {
@@ -196,7 +729,14 @@ class CodexAdapter extends EventEmitter {
     }
     this.proxyServer?.stop();
     this.proxyServer = null;
+    if (this.relay) {
+      this.relay.stop();
+      this.relay = null;
+    }
+    if (this.socketPath)
+      removeSocketFile(this.socketPath);
     this.clearResponseTrackingState();
+    this.resetTurnState(ADAPTER_DISCONNECT_REASON);
   }
   stop() {
     this.intentionalDisconnect = true;
@@ -213,7 +753,15 @@ class CodexAdapter extends EventEmitter {
       proc.on("exit", () => clearTimeout(killTimer));
     }
   }
-  injectMessage(text) {
+  forceKillAppServerSync() {
+    const pid = this.appServerPid;
+    if (pid === null)
+      return;
+    try {
+      process.kill(pid, "SIGKILL");
+    } catch {}
+  }
+  injectMessage(text, overrides) {
     if (!this.threadId) {
       this.log("Cannot inject: no active thread");
       return false;
@@ -229,11 +777,19 @@ class CodexAdapter extends EventEmitter {
     this.log(`Injecting message into Codex (${text.length} chars)`);
     const requestId = this.nextInjectionId--;
     this.trackBridgeRequestId(requestId);
+    const params = { threadId: this.threadId, input: [{ type: "text", text }] };
+    if (overrides?.model)
+      params.model = overrides.model;
+    if (overrides?.effort)
+      params.effort = overrides.effort;
+    if (overrides?.model || overrides?.effort) {
+      this.log(`Budget tier override on turn/start (model=${overrides.model ?? "unchanged"}, effort=${overrides.effort ?? "unchanged"}) \u2014 sticky for subsequent turns; transport-accepted unless a JSON-RPC error follows`);
+    }
     try {
       this.appServerWs.send(JSON.stringify({
         method: "turn/start",
         id: requestId,
-        params: { threadId: this.threadId, input: [{ type: "text", text }] }
+        params
       }));
       return true;
     } catch (err) {
@@ -242,6 +798,36 @@ class CodexAdapter extends EventEmitter {
       return false;
     }
   }
+  steerMessage(text) {
+    if (!this.threadId) {
+      this.log("Cannot steer: no active thread");
+      return false;
+    }
+    if (!this.appServerWs || this.appServerWs.readyState !== WebSocket.OPEN) {
+      this.log("Cannot steer: app-server WebSocket not connected");
+      return false;
+    }
+    if (!this.turnInProgress) {
+      this.log("Cannot steer: no turn in progress (use injectMessage)");
+      return false;
+    }
+    this.log(`Steering message into active Codex turn (${text.length} chars)`);
+    const requestId = this.nextInjectionId--;
+    this.trackBridgeRequestId(requestId, "steer");
+    const params = { threadId: this.threadId, input: [{ type: "text", text }] };
+    try {
+      this.appServerWs.send(JSON.stringify({
+        method: "turn/steer",
+        id: requestId,
+        params
+      }));
+      return true;
+    } catch (err) {
+      this.untrackBridgeRequestId(requestId);
+      this.log(`Steer send failed: ${err.message}`);
+      return false;
+    }
+  }
   async waitForHealthy(maxRetries = 20, delayMs = 500) {
     for (let i = 0;i < maxRetries; i++) {
       try {
@@ -323,8 +909,7 @@ class CodexAdapter extends EventEmitter {
       } catch {}
     }
     this.clearResponseTrackingStateForAppServerReconnect();
-    this.activeTurnIds.clear();
-    this.turnInProgress = false;
+    this.resetTurnState(APP_SERVER_RECONNECT_NEW_TUI_REASON);
     try {
       await this.connectToAppServer(false);
       this.log("App-server reconnected for new TUI session \u2014 replaying buffered messages");
@@ -378,8 +963,7 @@ class CodexAdapter extends EventEmitter {
     this.log(`App-server connection closed (intentional=${intentional}, tuiConnected=${tuiConnected}, turnInProgress=${this.turnInProgress})`);
     this.appServerWs = null;
     this.clearResponseTrackingState();
-    this.activeTurnIds.clear();
-    this.turnInProgress = false;
+    this.resetTurnState("app-server connection closed");
     if (!intentional) {
       this.scheduleReconnect();
     }
@@ -552,6 +1136,10 @@ class CodexAdapter extends EventEmitter {
         const isUpgrade = req.headers.get("upgrade")?.toLowerCase() === "websocket";
         self.log(`HTTP ${req.method} ${url.pathname} (upgrade=${isUpgrade})`);
         if (url.pathname === "/healthz" || url.pathname === "/readyz") {
+          if (self.transport === "unix") {
+            const up = self.appServerWs?.readyState === WebSocket.OPEN;
+            return new Response(up ? "ok" : "upstream not connected", { status: up ? 200 : 503 });
+          }
           return fetch(`http://127.0.0.1:${self.appPort}${url.pathname}`);
         }
         if (server.upgrade(req, { data: { connId: 0 } }))
@@ -589,7 +1177,13 @@ class CodexAdapter extends EventEmitter {
   }
   setupSecondaryConnection(ws, connId) {
     const appWs = new WebSocket(this.appServerUrl);
-    const entry = { tuiWs: ws, appServerWs: appWs, buffer: [] };
+    const entry = {
+      tuiWs: ws,
+      appServerWs: appWs,
+      buffer: [],
+      initialized: false,
+      initializationReplayed: false
+    };
     this.secondaryConnections.set(connId, entry);
     appWs.onopen = () => {
       if (!this.secondaryConnections.has(connId)) {
@@ -711,13 +1305,13 @@ class CodexAdapter extends EventEmitter {
     const connId = ws.data.connId;
     const secondary = this.secondaryConnections.get(connId);
     if (secondary) {
-      if (secondary.appServerWs && secondary.appServerWs.readyState === WebSocket.OPEN) {
-        try {
-          secondary.appServerWs.send(data);
-        } catch {}
-      } else {
-        secondary.buffer.push(data);
+      const method = this.detectJsonMethod(data);
+      if (method === "initialize" || method === "initialized") {
+        secondary.initialized = true;
+      } else if (!secondary.initialized) {
+        this.ensureSecondaryInitialized(secondary, connId);
       }
+      this.sendOrBufferSecondary(secondary, data);
       return;
     }
     if (connId !== this.tuiConnId) {
@@ -808,9 +1402,44 @@ class CodexAdapter extends EventEmitter {
       this.log(`WARNING: app-server closed between OPEN check and send \u2014 message lost (connId=${ws.data.connId})`);
     }
   }
+  detectJsonMethod(raw) {
+    try {
+      const parsed = JSON.parse(raw);
+      return typeof parsed?.method === "string" ? parsed.method : undefined;
+    } catch {
+      return;
+    }
+  }
+  ensureSecondaryInitialized(secondary, connId) {
+    if (secondary.initializationReplayed)
+      return;
+    secondary.initializationReplayed = true;
+    if (!this.lastInitializeRaw) {
+      this.log(`Secondary conn #${connId}: no cached initialize available before first non-initialize request`);
+      return;
+    }
+    this.log(`Secondary conn #${connId}: replaying cached initialize before picker request`);
+    this.sendOrBufferSecondary(secondary, this.lastInitializeRaw);
+    if (this.lastInitializedRaw) {
+      this.sendOrBufferSecondary(secondary, this.lastInitializedRaw);
+    }
+    secondary.initialized = true;
+  }
+  sendOrBufferSecondary(secondary, raw) {
+    if (secondary.appServerWs && secondary.appServerWs.readyState === WebSocket.OPEN) {
+      try {
+        secondary.appServerWs.send(raw);
+      } catch {}
+    } else {
+      secondary.buffer.push(raw);
+    }
+  }
   handleAppServerPayload(raw) {
     try {
       const parsed = JSON.parse(raw);
+      if (typeof parsed === "object" && parsed !== null) {
+        this.refreshTurnWatchdogs();
+      }
       if (typeof parsed === "object" && parsed !== null && "id" in parsed) {
         if (this.tryConsumeReplayResponse(parsed)) {
           return null;
@@ -889,7 +1518,7 @@ class CodexAdapter extends EventEmitter {
       timestamp: Date.now()
     });
     this.serverRequestToProxy.delete(proxyId);
-    this.log(`Buffered approval response until app-server reconnect (${reason}) (proxy id=${proxyId} \u2192 server id=${pending.serverId})`);
+    this.log(`Approval response could not reach the app-server (${reason}) \u2014 buffered best-effort, but it is ` + `likely lost (session-scoped id; reconnects clear this buffer). The TUI may need to re-approve. ` + `(proxy id=${proxyId} \u2192 server id=${pending.serverId})`);
   }
   flushPendingServerResponses() {
     if (!this.appServerWs || this.appServerWs.readyState !== WebSocket.OPEN)
@@ -921,11 +1550,22 @@ class CodexAdapter extends EventEmitter {
       this.interceptServerMessage(parsed, mapping.connId);
       return forwarded;
     }
-    if (!isNaN(numericId) && this.consumeBridgeRequestId(numericId)) {
+    const bridgeKind = !isNaN(numericId) ? this.consumeBridgeRequestId(numericId) : null;
+    if (bridgeKind) {
       if (parsed.error) {
-        this.log(`Bridge-originated request failed (id ${responseId}): ${parsed.error.message ?? "unknown error"}`);
+        this.log(`Bridge-originated ${bridgeKind} request failed (id ${responseId}): ${parsed.error.message ?? "unknown error"}`);
+        if (bridgeKind === "steer") {
+          this.emit("steerFailed", parsed.error.message ?? "unknown error");
+        } else {
+          this.lastTurnEndedAbnormally = true;
+          this.emit("turnAborted", `injected turn/start rejected: ${parsed.error.message ?? "unknown error"}`);
+          this.notifyPhaseIfChanged();
+        }
       } else {
-        this.log(`Bridge-originated request completed (id ${responseId})`);
+        this.log(`Bridge-originated ${bridgeKind} request completed (id ${responseId})`);
+        if (bridgeKind === "steer") {
+          this.emit("steerAccepted");
+        }
       }
       return null;
     }
@@ -1039,6 +1679,9 @@ class CodexAdapter extends EventEmitter {
         pending.threadId = threadId;
       }
     }
+    if (method === "thread/start" || method === "thread/resume") {
+      pending.threadSwitchSeq = ++this.threadSwitchSeq;
+    }
     if (this.pendingRequests.has(key)) {
       this.log(`WARNING: overwriting pending request for key ${key}`);
     }
@@ -1062,6 +1705,10 @@ class CodexAdapter extends EventEmitter {
     }
     switch (pending.method) {
       case "thread/start": {
+        if (!this.isLatestThreadSwitch(pending)) {
+          this.log(`Ignoring stale thread/start response ${key} (seq=${pending.threadSwitchSeq} < latest=${this.threadSwitchSeq})`);
+          break;
+        }
         const threadId = message?.result?.thread?.id;
         if (typeof threadId === "string" && threadId.length > 0) {
           this.setActiveThreadId(threadId, `thread/start response ${key}`);
@@ -1070,6 +1717,10 @@ class CodexAdapter extends EventEmitter {
         break;
       }
       case "thread/resume": {
+        if (!this.isLatestThreadSwitch(pending)) {
+          this.log(`Ignoring stale thread/resume response ${key} (seq=${pending.threadSwitchSeq} < latest=${this.threadSwitchSeq})`);
+          break;
+        }
         const threadId = message?.result?.thread?.id;
         if (typeof threadId === "string" && threadId.length > 0) {
           this.setActiveThreadId(threadId, `thread/resume response ${key}`);
@@ -1082,16 +1733,24 @@ class CodexAdapter extends EventEmitter {
       }
       case "turn/start":
         if (pending.threadId) {
-          this.setActiveThreadId(pending.threadId, `turn/start response ${key}`);
+          if (this.threadId === null || this.threadId === pending.threadId) {
+            this.setActiveThreadId(pending.threadId, `turn/start response ${key}`);
+          } else {
+            this.log(`Ignoring turn/start response ${key} threadId=${pending.threadId} (active thread is ${this.threadId})`);
+          }
         }
         break;
     }
   }
+  isLatestThreadSwitch(pending) {
+    return pending.threadSwitchSeq === this.threadSwitchSeq;
+  }
   setActiveThreadId(threadId, reason) {
     if (this.threadId === threadId)
       return;
     const previousThreadId = this.threadId;
     this.threadId = threadId;
+    this.emit("threadChanged", { threadId, previousThreadId, reason });
     if (previousThreadId) {
       this.log(`Active thread changed: ${previousThreadId} \u2192 ${threadId} (${reason})`);
       return;
@@ -1099,25 +1758,118 @@ class CodexAdapter extends EventEmitter {
     this.log(`Thread detected: ${threadId} (${reason})`);
     this.emit("ready", threadId);
   }
+  get turnPhase() {
+    if (this.activeTurnIds.size > 0) {
+      const allStalled = [...this.activeTurnIds].every((id) => this.currentlyStalledTurnIds.has(id));
+      return allStalled ? "stalled" : "running";
+    }
+    return this.lastTurnEndedAbnormally ? "aborted" : "idle";
+  }
+  notifyPhaseIfChanged() {
+    const phase = this.turnPhase;
+    if (phase === this.lastEmittedPhase)
+      return;
+    const previous = this.lastEmittedPhase;
+    this.lastEmittedPhase = phase;
+    this.emit("turnPhaseChanged", { phase, previous });
+  }
   markTurnStarted(turnId) {
     const wasInProgress = this.turnInProgress;
-    if (typeof turnId === "string" && turnId.length > 0) {
-      this.activeTurnIds.add(turnId);
-    } else {
-      this.activeTurnIds.add(`unknown:${Date.now()}`);
-    }
+    const turnKey = typeof turnId === "string" && turnId.length > 0 ? turnId : `unknown:${Date.now()}`;
+    this.activeTurnIds.add(turnKey);
+    this.stalledTurnIds.delete(turnKey);
+    this.currentlyStalledTurnIds.delete(turnKey);
+    this.lastTurnEndedAbnormally = false;
+    this.scheduleTurnWatchdog(turnKey);
     this.turnInProgress = this.activeTurnIds.size > 0;
     if (!wasInProgress && this.turnInProgress) {
       this.emit("turnStarted");
     }
+    this.notifyPhaseIfChanged();
   }
   markTurnCompleted(turnId) {
     if (typeof turnId === "string" && turnId.length > 0) {
       this.activeTurnIds.delete(turnId);
+      this.clearTurnWatchdog(turnId);
+      this.stalledTurnIds.delete(turnId);
+      this.currentlyStalledTurnIds.delete(turnId);
     } else {
       this.activeTurnIds.clear();
+      this.clearAllTurnWatchdogs();
+      this.stalledTurnIds.clear();
+      this.currentlyStalledTurnIds.clear();
     }
+    this.lastTurnEndedAbnormally = false;
     this.turnInProgress = this.activeTurnIds.size > 0;
+    this.notifyPhaseIfChanged();
+  }
+  turnWatchdogMs() {
+    const v = Number(process.env.AGENTBRIDGE_TURN_WATCHDOG_MS);
+    return Number.isFinite(v) && v > 0 ? v : 300000;
+  }
+  scheduleTurnWatchdog(turnKey) {
+    this.clearTurnWatchdog(turnKey);
+    const timer = setTimeout(() => {
+      if (!this.activeTurnIds.has(turnKey))
+        return;
+      this.log(`WARNING: turn ${turnKey} watchdog fired after ${this.turnWatchdogMs()}ms of inactivity \u2014 ` + `marking stalled but keeping Codex busy until a real completion or reconnect`);
+      this.markTurnStalled(turnKey);
+    }, this.turnWatchdogMs());
+    timer.unref?.();
+    this.turnWatchdogs.set(turnKey, timer);
+  }
+  clearTurnWatchdog(turnKey) {
+    const timer = this.turnWatchdogs.get(turnKey);
+    if (timer) {
+      clearTimeout(timer);
+      this.turnWatchdogs.delete(turnKey);
+    }
+  }
+  clearAllTurnWatchdogs() {
+    for (const timer of this.turnWatchdogs.values())
+      clearTimeout(timer);
+    this.turnWatchdogs.clear();
+  }
+  refreshTurnWatchdogs() {
+    if (this.turnWatchdogs.size === 0)
+      return;
+    for (const turnKey of [...this.turnWatchdogs.keys()]) {
+      this.scheduleTurnWatchdog(turnKey);
+    }
+    this.currentlyStalledTurnIds.clear();
+    this.notifyPhaseIfChanged();
+  }
+  markTurnStalled(turnKey) {
+    if (!this.activeTurnIds.has(turnKey))
+      return;
+    this.turnInProgress = true;
+    this.currentlyStalledTurnIds.add(turnKey);
+    this.notifyPhaseIfChanged();
+    if (this.stalledTurnIds.has(turnKey))
+      return;
+    this.stalledTurnIds.add(turnKey);
+    this.emit("turnStalled", {
+      turnId: turnKey,
+      inactivityMs: this.turnWatchdogMs()
+    });
+  }
+  resetTurnState(reason, emitCompleted = false) {
+    const wasInProgress = this.turnInProgress;
+    this.activeTurnIds.clear();
+    this.clearAllTurnWatchdogs();
+    this.stalledTurnIds.clear();
+    this.currentlyStalledTurnIds.clear();
+    this.turnInProgress = false;
+    if (wasInProgress) {
+      this.lastTurnEndedAbnormally = !emitCompleted;
+      if (emitCompleted) {
+        this.emit("turnCompleted");
+      } else {
+        this.emit("turnAborted", reason);
+      }
+      this.log(`Turn state reset (${reason})`);
+    }
+    this.notifyPhaseIfChanged();
   }
   requestKey(id) {
     if (typeof id === "number" || typeof id === "string")
@@ -1164,18 +1916,23 @@ class CodexAdapter extends EventEmitter {
   consumeStaleProxyId(proxyId) {
     return this.clearTrackedId(this.staleProxyIds, proxyId);
   }
-  trackBridgeRequestId(requestId) {
+  trackBridgeRequestId(requestId, kind = "turn-start") {
     this.clearTrackedId(this.bridgeRequestIds, requestId);
     const timer = setTimeout(() => {
       this.bridgeRequestIds.delete(requestId);
+      this.bridgeRequestKinds.delete(requestId);
     }, CodexAdapter.RESPONSE_TRACKING_TTL_MS);
     timer.unref?.();
     this.bridgeRequestIds.set(requestId, timer);
+    this.bridgeRequestKinds.set(requestId, kind);
   }
   consumeBridgeRequestId(requestId) {
-    return this.clearTrackedId(this.bridgeRequestIds, requestId);
+    const kind = this.bridgeRequestKinds.get(requestId) ?? "turn-start";
+    this.bridgeRequestKinds.delete(requestId);
+    return this.clearTrackedId(this.bridgeRequestIds, requestId) ? kind : null;
   }
   untrackBridgeRequestId(requestId) {
+    this.bridgeRequestKinds.delete(requestId);
     this.clearTrackedId(this.bridgeRequestIds, requestId);
   }
   clearTrackedId(store, id) {
@@ -1197,6 +1954,7 @@ class CodexAdapter extends EventEmitter {
       clearTimeout(timer);
     }
     this.bridgeRequestIds.clear();
+    this.bridgeRequestKinds.clear();
   }
   clearResponseTrackingState() {
     this.clearTransientResponseTrackingState();
@@ -1219,69 +1977,55 @@ class CodexAdapter extends EventEmitter {
     this.pendingServerResponses.clear();
   }
   static buildPortListenLsofCommand(port) {
-    return `lsof -ti tcp:${port} -sTCP:LISTEN`;
+    const { cmd, args } = portPidsCommand(port, "linux");
+    return [cmd, ...args].join(" ");
   }
   async checkPorts() {
-    for (const port of [this.appPort, this.proxyPort]) {
-      try {
-        const pids = execSync(CodexAdapter.buildPortListenLsofCommand(port), {
-          encoding: "utf-8"
-        }).trim();
-        if (!pids)
-          continue;
-        const pidList = pids.split(`
-`).map((p) => p.trim()).filter(Boolean);
-        const staleCodexPids = [];
-        const foreignPids = [];
-        for (const pid of pidList) {
-          try {
-            const cmdline = execSync(`ps -p ${pid} -o args=`, { encoding: "utf-8" }).trim();
-            if (cmdline.includes("codex") && cmdline.includes("app-server")) {
-              staleCodexPids.push(pid);
-            } else {
-              foreignPids.push(pid);
-            }
-          } catch {}
-        }
-        if (staleCodexPids.length > 0) {
-          this.log(`Cleaning up stale codex app-server on port ${port}: PID(s) ${staleCodexPids.join(", ")}`);
-          for (const pid of staleCodexPids) {
-            try {
-              execSync(`kill ${pid}`, { encoding: "utf-8" });
-            } catch {}
-          }
-          await new Promise((r) => setTimeout(r, 500));
-        }
-        if (foreignPids.length > 0) {
-          throw new Error(`Port ${port} is already in use by non-Codex process(es): PID(s) ${foreignPids.join(", ")}. ` + `Please stop the process or set a different port via ${port === this.appPort ? "CODEX_WS_PORT" : "CODEX_PROXY_PORT"} env var.`);
-        }
-        try {
-          const remaining = execSync(CodexAdapter.buildPortListenLsofCommand(port), {
-            encoding: "utf-8"
-          }).trim();
-          if (remaining) {
-            throw new Error(`Port ${port} is still occupied (PID(s): ${remaining.replace(/\n/g, ", ")}) after cleanup. ` + `Please stop the process or set a different port via ${port === this.appPort ? "CODEX_WS_PORT" : "CODEX_PROXY_PORT"} env var.`);
-          }
-        } catch (err) {
-          if (err.message?.includes("Port"))
-            throw err;
-        }
-      } catch (err) {
-        if (err.message?.includes("Port") || err.message?.includes("non-Codex"))
-          throw err;
-      }
-    }
+    await cleanupPorts({
+      ports: [
+        { port: this.appPort, envVar: "CODEX_WS_PORT" },
+        { port: this.proxyPort, envVar: "CODEX_PROXY_PORT" }
+      ],
+      run: ({ cmd, args }) => execFileSync(cmd, args, { encoding: "utf-8" }),
+      log: (message) => this.log(message),
+      sleep: (ms) => new Promise((r) => setTimeout(r, ms))
+    });
   }
   log(msg) {
-    const line = `[${new Date().toISOString()}] [CodexAdapter] ${msg}
-`;
-    process.stderr.write(line);
-    try {
-      appendFileSync(this.logFile, line);
-    } catch {}
+    this.logger.log(msg);
   }
 }
 
+// src/control-protocol.ts
+var CLOSE_CODE_REPLACED = 4001;
+var CLOSE_CODE_EVICTED_STALE = 4002;
+var CLOSE_CODE_PROBE_IN_PROGRESS = 4003;
+var CLOSE_CODE_PAIR_MISMATCH = 4004;
+
+// src/daemon-identity.ts
+function validateClaudeClientIdentity(input) {
+  if (!input.expectedPairId)
+    return { ok: true };
+  if (!input.identity) {
+    return input.allowIdentityless ? { ok: true } : { ok: false, closeCode: CLOSE_CODE_PAIR_MISMATCH, reason: "missing client identity" };
+  }
+  if (input.identity.pairId !== input.expectedPairId) {
+    return {
+      ok: false,
+      closeCode: CLOSE_CODE_PAIR_MISMATCH,
+      reason: `pair mismatch: expected ${input.expectedPairId}, got ${input.identity.pairId ?? "<none>"}`
+    };
+  }
+  if (!input.identity.cwd || input.identity.cwd !== input.daemonCwd) {
+    return {
+      ok: false,
+      closeCode: CLOSE_CODE_PAIR_MISMATCH,
+      reason: `cwd mismatch: expected ${input.daemonCwd}, got ${input.identity.cwd ?? "<none>"}`
+    };
+  }
+  return { ok: true };
+}
+
 // src/message-filter.ts
 var MARKER_REGEX = /^\s*\[(IMPORTANT|STATUS|FYI)\]\s*/i;
 function parseMarker(content) {
@@ -1308,27 +2052,6 @@ function classifyMessage(content, mode) {
       return { action: "forward", marker };
   }
 }
-var BRIDGE_CONTRACT_REMINDER = `[Bridge Contract] When sending agentMessage, put the marker at the very start of the message:
-- [IMPORTANT] for decisions, reviews, completions, blockers
-- [STATUS] for progress updates
-- [FYI] for background context
-The marker MUST be the first text in the message (e.g. "[IMPORTANT] Task done", not "Task done [IMPORTANT]").
-Keep agentMessage for high-value communication only.
-
-[Git Operations \u2014 FORBIDDEN]
-You MUST NOT execute any git write commands. This includes but is not limited to:
-git commit, git push, git pull, git fetch, git checkout -b, git branch, git merge, git rebase, git cherry-pick, git tag, git stash.
-These commands write to the .git directory, which is blocked by your sandbox. Attempting them will cause your session to hang indefinitely.
-Read-only git commands (git status, git log, git diff, git show, git rev-parse) are allowed.
-All git write operations must be delegated to Claude Code via agentMessage. Report what you changed and let Claude handle branching, committing, and pushing.
-
-[Role Guidance for Codex]
-- Your default role: Implementer, Executor, Verifier
-- Analytical/review tasks: Independent Analysis & Convergence
-- Implementation tasks: Architect -> Builder -> Critic
-- Debugging tasks: Hypothesis -> Experiment -> Interpretation
-- Do not blindly follow Claude - challenge with evidence when you disagree
-- Use explicit collaboration phrases: "My independent view is:", "I agree on:", "I disagree on:", "Current consensus:"`;
 var REPLY_REQUIRED_INSTRUCTION = `
 
 [\u26A0\uFE0F REPLY REQUIRED] Claude has explicitly requested a reply. You MUST send an agentMessage with [IMPORTANT] marker containing your response. This is a mandatory requirement \u2014 do not skip or use [STATUS]/[FYI] markers for this reply.`;
@@ -1484,11 +2207,31 @@ class TuiConnectionState {
 }
 
 // src/daemon-lifecycle.ts
-import { spawn as spawn2, execFileSync } from "child_process";
-import { existsSync as existsSync2, readFileSync, unlinkSync, writeFileSync, openSync, closeSync, constants } from "fs";
+import { spawn as spawn2, execFileSync as execFileSync2 } from "child_process";
+import { existsSync as existsSync3, readFileSync, statSync as statSync2, unlinkSync as unlinkSync2, writeFileSync, openSync, closeSync, constants } from "fs";
 import { fileURLToPath } from "url";
-var DAEMON_ENTRY = process.env.AGENTBRIDGE_DAEMON_ENTRY ?? "./daemon.ts";
+
+// src/env-utils.ts
+function parsePositiveIntEnv(name, fallback, log = () => {}, env = process.env) {
+  const raw = env[name];
+  if (raw == null || raw === "")
+    return fallback;
+  const parsed = Number(raw);
+  if (!Number.isInteger(parsed) || parsed <= 0 || parsed > Number.MAX_SAFE_INTEGER) {
+    log(`Invalid ${name}=${JSON.stringify(raw)} (must be a positive integer within ` + `Number.MAX_SAFE_INTEGER); falling back to ${fallback}`);
+    return fallback;
+  }
+  return parsed;
+}
+
+// src/daemon-lifecycle.ts
+var DEFAULT_DAEMON_ENTRY = import.meta.url.endsWith(".ts") ? "./daemon.ts" : "./daemon.js";
+var DAEMON_ENTRY = process.env.AGENTBRIDGE_DAEMON_ENTRY || DEFAULT_DAEMON_ENTRY;
 var DAEMON_PATH = fileURLToPath(new URL(DAEMON_ENTRY, import.meta.url));
+var REUSE_READY_RETRIES = parsePositiveIntEnv("AGENTBRIDGE_REUSE_READY_RETRIES", 12);
+var REUSE_READY_DELAY_MS = 250;
+var HEALTH_FETCH_TIMEOUT_MS = 500;
+var LOCK_IDENTITY_GRACE_MS = parsePositiveIntEnv("AGENTBRIDGE_LOCK_IDENTITY_GRACE_MS", 120000);
 
 class DaemonLifecycle {
   stateDir;
@@ -1508,42 +2251,120 @@ class DaemonLifecycle {
   get controlWsUrl() {
     return `ws://127.0.0.1:${this.controlPort}/ws`;
   }
+  get expectedPairId() {
+    return process.env.AGENTBRIDGE_PAIR_ID || null;
+  }
+  async fetchStatus() {
+    try {
+      const response = await fetchWithTimeout(this.healthUrl);
+      if (!response.ok)
+        return null;
+      return await response.json();
+    } catch {
+      return null;
+    }
+  }
+  isForeignDaemon(status) {
+    const expected = this.expectedPairId;
+    if (!expected)
+      return false;
+    if (!status)
+      return false;
+    const reported = status.pairId;
+    if (reported == null)
+      return true;
+    return reported !== expected;
+  }
+  isRegisteredPairDaemonInManualMode(status) {
+    return !this.expectedPairId && status?.pairId != null;
+  }
+  isBuildDrifted(status) {
+    if (process.env.AGENTBRIDGE_ALLOW_BUILD_DRIFT === "1")
+      return false;
+    const runtime = status?.build;
+    if (!runtime)
+      return true;
+    return !sameRuntimeContract(runtime, BUILD_INFO);
+  }
+  canReuseDespiteDrift(status) {
+    if (!compatibleContractVersion(status?.build, BUILD_INFO))
+      return false;
+    return status?.tuiConnected === true;
+  }
   async ensureRunning() {
     if (await this.isHealthy()) {
-      await this.waitForReady();
-      return;
+      const status = await this.fetchStatus();
+      if (this.isRegisteredPairDaemonInManualMode(status)) {
+        throw new Error(`Control port ${this.controlPort} is owned by registered pair ${status?.pairId}. ` + `This session has no pair identity (manual mode) and will not reuse or replace it \u2014 ` + `start with \`agentbridge claude\` from that pair's directory, or set AGENTBRIDGE_CONTROL_PORT to a free port.`);
+      }
+      if (this.isForeignDaemon(status)) {
+        this.log(`Control port ${this.controlPort} held by a daemon for pair ${status?.pairId ?? "<none>"}, ` + `but this pair is ${this.expectedPairId} \u2014 replacing foreign daemon`);
+        await this.replaceUnhealthyDaemon(status?.pid);
+        return;
+      }
+      if (this.isBuildDrifted(status)) {
+        if (this.canReuseDespiteDrift(status)) {
+          this.log(`Daemon on control port ${this.controlPort} is running build ${formatBuildInfo(status?.build)} ` + `(launcher ${formatBuildInfo(BUILD_INFO)}) but a live Codex TUI is attached \u2014 reusing instead of ` + `replacing; the new build is picked up at the next restart (abg kill, then relaunch)`);
+        } else {
+          this.log(`Daemon on control port ${this.controlPort} is running build ${formatBuildInfo(status?.build)} ` + `but launcher is ${formatBuildInfo(BUILD_INFO)} \u2014 replacing drifted daemon`);
+          await this.replaceUnhealthyDaemon(status?.pid);
+          return;
+        }
+      }
+      try {
+        await this.waitForReady(REUSE_READY_RETRIES, REUSE_READY_DELAY_MS);
+        return;
+      } catch {
+        this.log(`Daemon on control port ${this.controlPort} is healthy but not ready within reuse window \u2014 replacing`);
+        await this.replaceUnhealthyDaemon(status?.pid);
+        return;
+      }
     }
     const existingPid = this.readPid();
     if (existingPid) {
       if (isProcessAlive(existingPid)) {
         if (this.isDaemonProcess(existingPid)) {
           try {
-            await this.waitForReady(12, 250);
+            await this.waitForReady(REUSE_READY_RETRIES, REUSE_READY_DELAY_MS);
             return;
           } catch {
-            throw new Error(`Found existing daemon process ${existingPid}, but control port ${this.controlPort} never became ready.`);
+            this.log(`Existing daemon process ${existingPid} never became ready \u2014 replacing`);
+            await this.replaceUnhealthyDaemon(existingPid);
+            return;
           }
         }
         this.log(`Pid ${existingPid} is alive but not an AgentBridge daemon, removing stale pid file`);
       }
       this.removeStalePidFile();
     }
-    const lockAcquired = this.acquireLock();
-    if (!lockAcquired) {
-      this.log("Another process is starting the daemon, waiting for readiness...");
-      await this.waitForReady();
-      return;
-    }
-    try {
+    await this.withStartupLockStrict(async (locked) => {
+      if (!locked) {
+        this.log("Another process holds the startup lock, waiting for readiness+identity...");
+        await this.waitForReadyAndOurs();
+        return;
+      }
+      if (await this.isHealthy()) {
+        const status = await this.fetchStatus();
+        if (this.isForeignDaemon(status) || this.isBuildDrifted(status) && !this.canReuseDespiteDrift(status)) {
+          this.log(`Daemon on control port ${this.controlPort} is not reusable under startup lock ` + `(pair=${status?.pairId ?? "<none>"}, build=${formatBuildInfo(status?.build)}) \u2014 replacing`);
+          await this.kill(3000, status?.pid);
+        } else {
+          try {
+            await this.waitForReady(REUSE_READY_RETRIES, REUSE_READY_DELAY_MS);
+            return;
+          } catch {
+            this.log(`Daemon on control port ${this.controlPort} is healthy but not ready under startup lock \u2014 replacing`);
+            await this.kill(3000, status?.pid);
+          }
+        }
+      }
       this.launch();
       await this.waitForReady();
-    } finally {
-      this.releaseLock();
-    }
+    });
   }
   async isHealthy() {
     try {
-      const response = await fetch(this.healthUrl);
+      const response = await fetchWithTimeout(this.healthUrl);
       return response.ok;
     } catch {
       return false;
@@ -1559,7 +2380,7 @@ class DaemonLifecycle {
   }
   async isReady() {
     try {
-      const response = await fetch(this.readyUrl);
+      const response = await fetchWithTimeout(this.readyUrl);
       return response.ok;
     } catch {
       return false;
@@ -1573,6 +2394,18 @@ class DaemonLifecycle {
     }
     throw new Error(`Timed out waiting for AgentBridge daemon readiness on ${this.readyUrl}`);
   }
+  async waitForReadyAndOurs(maxRetries = 40, delayMs = 250) {
+    for (let attempt = 0;attempt < maxRetries; attempt++) {
+      if (await this.isReady()) {
+        const status = await this.fetchStatus();
+        if (!this.isForeignDaemon(status) && (!this.isBuildDrifted(status) || this.canReuseDespiteDrift(status))) {
+          return;
+        }
+      }
+      await new Promise((resolve) => setTimeout(resolve, delayMs));
+    }
+    throw new Error(`Timed out waiting for AgentBridge daemon readiness+identity on ${this.readyUrl} (control port ${this.controlPort})`);
+  }
   readStatus() {
     try {
       const raw = readFileSync(this.stateDir.statusFile, "utf-8");
@@ -1604,12 +2437,12 @@ class DaemonLifecycle {
   }
   removePidFile() {
     try {
-      unlinkSync(this.stateDir.pidFile);
+      unlinkSync2(this.stateDir.pidFile);
     } catch {}
   }
   removeStatusFile() {
     try {
-      unlinkSync(this.stateDir.statusFile);
+      unlinkSync2(this.stateDir.statusFile);
     } catch {}
   }
   markKilled() {
@@ -1619,11 +2452,11 @@ class DaemonLifecycle {
   }
   clearKilled() {
     try {
-      unlinkSync(this.stateDir.killedFile);
+      unlinkSync2(this.stateDir.killedFile);
     } catch {}
   }
   wasKilled() {
-    return existsSync2(this.stateDir.killedFile);
+    return existsSync3(this.stateDir.killedFile);
   }
   launch() {
     this.stateDir.ensure();
@@ -1644,45 +2477,99 @@ class DaemonLifecycle {
     this.log("Removing stale pid file");
     this.removePidFile();
   }
-  acquireLock(depth = 0) {
-    if (depth > 1) {
-      this.log("Lock acquisition failed after retry, proceeding without lock");
-      return true;
+  async replaceUnhealthyDaemon(statusPid) {
+    await this.withStartupLockStrict(async (locked) => {
+      if (!locked) {
+        this.log("Another process holds the startup lock, waiting for readiness+identity...");
+        await this.waitForReadyAndOurs();
+        return;
+      }
+      if (await this.isHealthy()) {
+        const status = await this.fetchStatus();
+        if (!this.isForeignDaemon(status) && (!this.isBuildDrifted(status) || this.canReuseDespiteDrift(status))) {
+          try {
+            await this.waitForReady(REUSE_READY_RETRIES, REUSE_READY_DELAY_MS);
+            return;
+          } catch {}
+        }
+      }
+      this.log(`Killing unhealthy daemon on control port ${this.controlPort} and relaunching`);
+      await this.kill(3000, statusPid);
+      this.launch();
+      await this.waitForReady();
+    });
+  }
+  async withStartupLockStrict(fn) {
+    const locked = this.acquireLockStrict();
+    try {
+      return await fn(locked);
+    } finally {
+      if (locked)
+        this.releaseLock();
     }
+  }
+  acquireLockStrict(reclaimed = false) {
     this.stateDir.ensure();
+    let fd = null;
     try {
-      const fd = openSync(this.stateDir.lockFile, constants.O_CREAT | constants.O_EXCL | constants.O_WRONLY);
+      fd = openSync(this.stateDir.lockFile, constants.O_CREAT | constants.O_EXCL | constants.O_WRONLY);
       writeFileSync(fd, `${process.pid}
 `);
       closeSync(fd);
       return true;
     } catch (err) {
+      if (fd !== null && err.code !== "EEXIST") {
+        try {
+          closeSync(fd);
+        } catch {}
+        this.releaseLock();
+      }
       if (err.code === "EEXIST") {
+        if (reclaimed)
+          return false;
         try {
           const holderPid = Number.parseInt(readFileSync(this.stateDir.lockFile, "utf-8").trim(), 10);
           if (Number.isFinite(holderPid) && !isProcessAlive(holderPid)) {
-            this.log(`Stale lock file from dead process ${holderPid}, removing`);
+            this.log(`Stale startup lock from dead process ${holderPid}, reclaiming`);
+            this.releaseLock();
+            return this.acquireLockStrict(true);
+          }
+          if (Number.isFinite(holderPid) && this.lockAgeMs() > LOCK_IDENTITY_GRACE_MS && !this.isAgentBridgeProcess(holderPid)) {
+            this.log(`Startup lock is ${Math.round(this.lockAgeMs() / 1000)}s old and holder pid ${holderPid} ` + `is an unrelated process (pid recycled), reclaiming`);
             this.releaseLock();
-            return this.acquireLock(depth + 1);
+            return this.acquireLockStrict(true);
           }
         } catch {
-          this.log("Cannot read lock file, removing stale lock");
-          this.releaseLock();
-          return this.acquireLock(depth + 1);
+          return false;
         }
         return false;
       }
-      this.log(`Warning: could not acquire startup lock: ${err.message}`);
-      return true;
+      this.log(`Could not acquire strict startup lock: ${err.message}`);
+      return false;
+    }
+  }
+  lockAgeMs() {
+    try {
+      return Date.now() - statSync2(this.stateDir.lockFile).mtimeMs;
+    } catch {
+      return 0;
+    }
+  }
+  isAgentBridgeProcess(pid) {
+    try {
+      const cmd = execFileSync2("ps", ["-p", String(pid), "-o", "command="], { encoding: "utf-8" }).trim();
+      return cmd.includes("agentbridge") || cmd.includes("agent_bridge");
+    } catch {
+      return false;
     }
   }
   releaseLock() {
     try {
-      unlinkSync(this.stateDir.lockFile);
+      unlinkSync2(this.stateDir.lockFile);
     } catch {}
   }
-  async kill(gracefulTimeoutMs = 3000) {
-    const pid = this.readPid();
+  async kill(gracefulTimeoutMs = 3000, pidOverride) {
+    const pid = pidOverride ?? this.readPid();
     if (!pid) {
       this.log("No daemon pid file found");
       this.cleanup();
@@ -1723,8 +2610,10 @@ class DaemonLifecycle {
   }
   isDaemonProcess(pid) {
     try {
-      const cmd = execFileSync("ps", ["-p", String(pid), "-o", "command="], { encoding: "utf-8" }).trim();
-      return cmd.includes("daemon") && (cmd.includes("agentbridge") || cmd.includes("agent_bridge"));
+      const cmd = execFileSync2("ps", ["-p", String(pid), "-o", "command="], { encoding: "utf-8" }).trim();
+      const hasDaemonEntry = /(?:^|[\s/\\])[\w.-]*-?daemon\.(?:ts|js)(?:\s|$)/.test(cmd);
+      const hasAgentbridge = cmd.includes("agentbridge") || cmd.includes("agent_bridge");
+      return hasDaemonEntry && hasAgentbridge;
     } catch {
       return false;
     }
@@ -1732,7 +2621,15 @@ class DaemonLifecycle {
   cleanup() {
     this.removePidFile();
     this.removeStatusFile();
-    this.releaseLock();
+  }
+}
+async function fetchWithTimeout(url, timeoutMs = HEALTH_FETCH_TIMEOUT_MS) {
+  const controller = new AbortController;
+  const timer = setTimeout(() => controller.abort(), timeoutMs);
+  try {
+    return await fetch(url, { signal: controller.signal });
+  } finally {
+    clearTimeout(timer);
   }
 }
 function isProcessAlive(pid) {
@@ -1745,8 +2642,25 @@ function isProcessAlive(pid) {
 }
 
 // src/config-service.ts
-import { readFileSync as readFileSync2, writeFileSync as writeFileSync2, mkdirSync as mkdirSync2, existsSync as existsSync3 } from "fs";
-import { join as join2 } from "path";
+import { readFileSync as readFileSync2, writeFileSync as writeFileSync2, mkdirSync as mkdirSync3, existsSync as existsSync4 } from "fs";
+import { join as join3 } from "path";
+var DEFAULT_BUDGET_CONFIG = {
+  enabled: true,
+  pollSeconds: 60,
+  pauseAt: 90,
+  resumeBelow: 30,
+  syncDriftPct: 10,
+  parallel: {
+    minRemainingPct: 60,
+    timeWindowSec: 3600
+  },
+  codexTierControl: false,
+  codexTiers: {
+    full: null,
+    balanced: { effort: "medium" },
+    eco: { effort: "low" }
+  }
+};
 var DEFAULT_CONFIG = {
   version: "1.0",
   codex: {
@@ -1756,7 +2670,8 @@ var DEFAULT_CONFIG = {
   turnCoordination: {
     attentionWindowSeconds: 15
   },
-  idleShutdownSeconds: 30
+  idleShutdownSeconds: 30,
+  budget: DEFAULT_BUDGET_CONFIG
 };
 var CONFIG_DIR = ".agentbridge";
 var CONFIG_FILE = "config.json";
@@ -1773,6 +2688,79 @@ function normalizeInteger(value, fallback) {
   }
   return fallback;
 }
+function normalizeBoundedInteger(value, fallback, min, max) {
+  const parsed = normalizeInteger(value, fallback);
+  if (parsed < min || parsed > max)
+    return fallback;
+  return parsed;
+}
+function normalizeBoolean(value, fallback) {
+  if (typeof value === "boolean")
+    return value;
+  if (value === "true" || value === "1")
+    return true;
+  if (value === "false" || value === "0")
+    return false;
+  return fallback;
+}
+function normalizeCodexOverride(raw) {
+  if (!isRecord(raw))
+    return null;
+  const override = {};
+  if (typeof raw.model === "string" && raw.model.trim() !== "")
+    override.model = raw.model.trim();
+  if (typeof raw.effort === "string" && raw.effort.trim() !== "")
+    override.effort = raw.effort.trim();
+  return Object.keys(override).length > 0 ? override : null;
+}
+function normalizeCodexTiers(raw) {
+  const tiers = isRecord(raw) ? raw : {};
+  return {
+    full: normalizeCodexOverride(tiers.full),
+    balanced: normalizeCodexOverride(tiers.balanced) ?? DEFAULT_BUDGET_CONFIG.codexTiers.balanced,
+    eco: normalizeCodexOverride(tiers.eco) ?? DEFAULT_BUDGET_CONFIG.codexTiers.eco
+  };
+}
+function normalizeBudgetConfig(raw) {
+  const budget = isRecord(raw) ? raw : {};
+  const parallel = isRecord(budget.parallel) ? budget.parallel : {};
+  const codexTiers = normalizeCodexTiers(budget.codexTiers);
+  let pauseAt = normalizeBoundedInteger(budget.pauseAt, DEFAULT_BUDGET_CONFIG.pauseAt, 1, 100);
+  let resumeBelow = normalizeBoundedInteger(budget.resumeBelow, DEFAULT_BUDGET_CONFIG.resumeBelow, 0, 99);
+  if (pauseAt <= resumeBelow) {
+    pauseAt = DEFAULT_BUDGET_CONFIG.pauseAt;
+    resumeBelow = DEFAULT_BUDGET_CONFIG.resumeBelow;
+  }
+  return {
+    enabled: normalizeBoolean(budget.enabled, DEFAULT_BUDGET_CONFIG.enabled),
+    pollSeconds: normalizeBoundedInteger(budget.pollSeconds, DEFAULT_BUDGET_CONFIG.pollSeconds, 5, 3600),
+    pauseAt,
+    resumeBelow,
+    syncDriftPct: normalizeBoundedInteger(budget.syncDriftPct, DEFAULT_BUDGET_CONFIG.syncDriftPct, 1, 100),
+    parallel: {
+      minRemainingPct: normalizeBoundedInteger(parallel.minRemainingPct, DEFAULT_BUDGET_CONFIG.parallel.minRemainingPct, 1, 100),
+      timeWindowSec: normalizeBoundedInteger(parallel.timeWindowSec, DEFAULT_BUDGET_CONFIG.parallel.timeWindowSec, 60, 604800)
+    },
+    codexTierControl: normalizeBoolean(budget.codexTierControl, DEFAULT_BUDGET_CONFIG.codexTierControl) && codexTiers.full !== null,
+    codexTiers
+  };
+}
+function applyBudgetEnvOverrides(budget, env = process.env) {
+  const overlay = {
+    enabled: env.AGENTBRIDGE_BUDGET_ENABLED ?? budget.enabled,
+    pollSeconds: env.AGENTBRIDGE_BUDGET_POLL_SECONDS ?? budget.pollSeconds,
+    pauseAt: env.AGENTBRIDGE_BUDGET_PAUSE_AT ?? budget.pauseAt,
+    resumeBelow: env.AGENTBRIDGE_BUDGET_RESUME_BELOW ?? budget.resumeBelow,
+    syncDriftPct: env.AGENTBRIDGE_BUDGET_SYNC_DRIFT_PCT ?? budget.syncDriftPct,
+    parallel: {
+      minRemainingPct: env.AGENTBRIDGE_BUDGET_PARALLEL_MIN_REMAINING_PCT ?? budget.parallel.minRemainingPct,
+      timeWindowSec: env.AGENTBRIDGE_BUDGET_PARALLEL_TIME_WINDOW_SEC ?? budget.parallel.timeWindowSec
+    },
+    codexTierControl: env.AGENTBRIDGE_BUDGET_CODEX_TIER_CONTROL ?? budget.codexTierControl,
+    codexTiers: budget.codexTiers
+  };
+  return normalizeBudgetConfig(overlay);
+}
 function normalizeConfig(raw) {
   if (!isRecord(raw))
     return null;
@@ -1789,7 +2777,8 @@ function normalizeConfig(raw) {
     turnCoordination: {
       attentionWindowSeconds: normalizeInteger(turnCoordination.attentionWindowSeconds, DEFAULT_CONFIG.turnCoordination.attentionWindowSeconds)
     },
-    idleShutdownSeconds: normalizeInteger(config.idleShutdownSeconds, DEFAULT_CONFIG.idleShutdownSeconds)
+    idleShutdownSeconds: normalizeInteger(config.idleShutdownSeconds, DEFAULT_CONFIG.idleShutdownSeconds),
+    budget: normalizeBudgetConfig(config.budget)
   };
 }
 
@@ -1798,11 +2787,11 @@ class ConfigService {
   configPath;
   constructor(projectRoot) {
     const root = projectRoot ?? process.cwd();
-    this.configDir = join2(root, CONFIG_DIR);
-    this.configPath = join2(this.configDir, CONFIG_FILE);
+    this.configDir = join3(root, CONFIG_DIR);
+    this.configPath = join3(this.configDir, CONFIG_FILE);
   }
   hasConfig() {
-    return existsSync3(this.configPath);
+    return existsSync4(this.configPath);
   }
   load() {
     try {
@@ -1823,7 +2812,7 @@ class ConfigService {
   initDefaults() {
     this.ensureConfigDir();
     const created = [];
-    if (!existsSync3(this.configPath)) {
+    if (!existsSync4(this.configPath)) {
       this.save(DEFAULT_CONFIG);
       created.push(this.configPath);
     }
@@ -1833,125 +2822,1269 @@ class ConfigService {
     return this.configPath;
   }
   ensureConfigDir() {
-    if (!existsSync3(this.configDir)) {
-      mkdirSync2(this.configDir, { recursive: true });
+    if (!existsSync4(this.configDir)) {
+      mkdirSync3(this.configDir, { recursive: true });
     }
   }
 }
 
-// src/control-protocol.ts
-var CLOSE_CODE_REPLACED = 4001;
+// src/budget/types.ts
+var STALE_MAX_AGE_SEC = 600;
 
-// src/daemon.ts
-var stateDir = new StateDirResolver;
-stateDir.ensure();
-var configService = new ConfigService;
-var config = configService.loadOrDefault();
-var CODEX_APP_PORT = parseInt(process.env.CODEX_WS_PORT ?? String(config.codex.appPort), 10);
-var CODEX_PROXY_PORT = parseInt(process.env.CODEX_PROXY_PORT ?? String(config.codex.proxyPort), 10);
-var CONTROL_PORT = parseInt(process.env.AGENTBRIDGE_CONTROL_PORT ?? "4502", 10);
-var TUI_DISCONNECT_GRACE_MS = parseInt(process.env.TUI_DISCONNECT_GRACE_MS ?? "2500", 10);
-var CLAUDE_DISCONNECT_GRACE_MS = 5000;
-var MAX_BUFFERED_MESSAGES = parseInt(process.env.AGENTBRIDGE_MAX_BUFFERED_MESSAGES ?? "100", 10);
-var FILTER_MODE = process.env.AGENTBRIDGE_FILTER_MODE === "full" ? "full" : "filtered";
-var IDLE_SHUTDOWN_MS = parseInt(process.env.AGENTBRIDGE_IDLE_SHUTDOWN_MS ?? String(config.idleShutdownSeconds * 1000), 10);
-var ATTENTION_WINDOW_MS = parseInt(process.env.AGENTBRIDGE_ATTENTION_WINDOW_MS ?? String(config.turnCoordination.attentionWindowSeconds * 1000), 10);
-var daemonLifecycle = new DaemonLifecycle({ stateDir, controlPort: CONTROL_PORT, log });
-var codex = new CodexAdapter(CODEX_APP_PORT, CODEX_PROXY_PORT, stateDir.logFile);
-var attachCmd = `codex --enable tui_app_server --remote ${codex.proxyUrl}`;
-var controlServer = null;
-var attachedClaude = null;
-var nextControlClientId = 0;
-var nextSystemMessageId = 0;
-var codexBootstrapped = false;
-var attentionWindowTimer = null;
-var inAttentionWindow = false;
-var replyRequired = false;
-var replyReceivedDuringTurn = false;
-var shuttingDown = false;
-var idleShutdownTimer = null;
-var claudeDisconnectTimer = null;
-var claudeOnlineNoticeSent = false;
-var claudeOfflineNoticeShown = false;
-var codexCollaborationKickoffSent = false;
-var lastAttachStatusSentTs = 0;
-var ATTACH_STATUS_COOLDOWN_MS = 30000;
-var bufferedMessages = [];
-var tuiConnectionState = new TuiConnectionState({
-  disconnectGraceMs: TUI_DISCONNECT_GRACE_MS,
-  log,
-  onDisconnectPersisted: (connId) => {
-    emitToClaude(systemMessage("system_tui_disconnected", `\u26A0\uFE0F Codex TUI disconnected (conn #${connId}). Codex is still running in the background \u2014 reconnect the TUI to resume.`));
-  },
-  onReconnectAfterNotice: (connId) => {
-    emitToClaude(systemMessage("system_tui_reconnected", `\u2705 Codex TUI reconnected (conn #${connId}). Bridge restored, communication can continue.`));
-    codex.injectMessage("\u2705 Claude Code is still online, bridge restored. Bidirectional communication can continue.");
-  }
-});
-var statusBuffer = new StatusBuffer((summary) => emitToClaude(summary));
-codex.on("turnStarted", () => {
-  log("Codex turn started");
-  emitToClaude(systemMessage("system_turn_started", "\u23F3 Codex is working on the current task. Wait for completion before sending a reply."));
-});
-codex.on("agentMessage", (msg) => {
-  if (msg.source !== "codex")
-    return;
-  const result = classifyMessage(msg.content, FILTER_MODE);
-  if (replyRequired) {
-    log(`Codex \u2192 Claude [${result.marker}/force-forward-reply-required] (${msg.content.length} chars)`);
-    replyReceivedDuringTurn = true;
-    if (statusBuffer.size > 0) {
-      statusBuffer.flush("reply-required message arrived");
-    }
-    emitToClaude(msg);
-    return;
+// src/budget/budget-state.ts
+var AGENT_LABEL = {
+  claude: "Claude",
+  codex: "Codex"
+};
+var CODEX_BALANCED_WARN_UTIL = 60;
+var CODEX_ECO_WARN_UTIL = 80;
+var CLAUDE_ADVICE_WARN_UTIL = 80;
+function pct(value) {
+  return `${Math.round(value * 10) / 10}%`;
+}
+function formatEpoch(epoch) {
+  if (!epoch || epoch <= 0)
+    return "\u672A\u77E5";
+  return new Date(epoch * 1000).toISOString().replace("T", " ").replace(/\.\d+Z$/, "Z");
+}
+function usageSummary(name, usage) {
+  if (!usage)
+    return `${AGENT_LABEL[name]} \u672A\u77E5`;
+  return `${AGENT_LABEL[name]} gate=${pct(usage.gateUtil)} warn=${pct(usage.warnUtil)} 5h\u91CD\u7F6E=${formatEpoch(usage.fiveHour?.resetEpoch ?? 0)}`;
+}
+function matchingGateReset(usage) {
+  if (!usage)
+    return 0;
+  const windows = [usage.fiveHour, usage.weekly].filter((window) => !!window && window.resetEpoch > 0);
+  const matching = windows.filter((window) => Math.abs(window.util - usage.gateUtil) < 0.0001);
+  const candidates = matching.length > 0 ? matching : windows;
+  if (candidates.length === 0)
+    return 0;
+  return Math.min(...candidates.map((window) => window.resetEpoch));
+}
+function resumeBlockingEpoch(usage, cfg, now) {
+  if (!usage)
+    return 0;
+  if (usage.rateLimitedUntil > now)
+    return usage.rateLimitedUntil;
+  if (usage.gateUtil >= cfg.resumeBelow)
+    return matchingGateReset(usage);
+  return 0;
+}
+function resumeAfterEpoch(claude, codex, cfg, now) {
+  const epochs = [
+    resumeBlockingEpoch(claude, cfg, now),
+    resumeBlockingEpoch(codex, cfg, now)
+  ].filter((epoch) => epoch > 0);
+  if (epochs.length === 0)
+    return null;
+  return Math.max(...epochs);
+}
+function isDecisionGrade(usage, now) {
+  if (!usage)
+    return false;
+  const freshWindow = usage.fiveHour !== null && usage.fiveHour.resetEpoch > now || usage.weekly !== null && usage.weekly.resetEpoch > now;
+  if (!freshWindow)
+    return false;
+  if (usage.fetchedAt > 0 && now - usage.fetchedAt > STALE_MAX_AGE_SEC)
+    return false;
+  return true;
+}
+function pauseTrigger(agent, usage, cfg, now) {
+  if (!usage)
+    return null;
+  if (!isDecisionGrade(usage, now))
+    return null;
+  if (usage.gateUtil >= cfg.pauseAt) {
+    return {
+      agent,
+      reason: `${AGENT_LABEL[agent]} gateUtil ${pct(usage.gateUtil)} \u2265 pauseAt ${pct(cfg.pauseAt)}`
+    };
   }
-  if (inAttentionWindow && result.marker === "status") {
-    log(`Codex \u2192 Claude [${result.marker}/buffer-attention] (${msg.content.length} chars)`);
-    statusBuffer.add(msg);
-    return;
+  return null;
+}
+function driftFor(claude, codex, cfg) {
+  if (!claude || !codex)
+    return { pct: 0, heavier: null, lighter: null };
+  const drift = Math.round((claude.warnUtil - codex.warnUtil) * 10) / 10;
+  if (Math.abs(drift) <= cfg.syncDriftPct) {
+    return { pct: drift, heavier: null, lighter: null };
   }
-  log(`Codex \u2192 Claude [${result.marker}/${result.action}] (${msg.content.length} chars)`);
-  switch (result.action) {
-    case "forward":
-      if (result.marker === "important" && statusBuffer.size > 0) {
-        statusBuffer.flush("important message arrived");
-      }
-      emitToClaude(msg);
-      if (result.marker === "important") {
-        startAttentionWindow();
-      }
-      break;
-    case "buffer":
-      statusBuffer.add(msg);
-      break;
-    case "drop":
-      break;
+  return {
+    pct: drift,
+    heavier: drift > 0 ? "claude" : "codex",
+    lighter: drift > 0 ? "codex" : "claude"
+  };
+}
+function parallelState(claude, codex, cfg, now) {
+  if (!claude || !codex)
+    return { recommended: false, reason: null };
+  if (claude.remaining <= cfg.parallel.minRemainingPct || codex.remaining <= cfg.parallel.minRemainingPct) {
+    return { recommended: false, reason: null };
+  }
+  const claudeReset = claude.fiveHour?.resetEpoch ?? 0;
+  const codexReset = codex.fiveHour?.resetEpoch ?? 0;
+  if (claudeReset <= now || codexReset <= now)
+    return { recommended: false, reason: null };
+  const nearestResetSec = Math.min(claudeReset - now, codexReset - now);
+  if (nearestResetSec >= cfg.parallel.timeWindowSec)
+    return { recommended: false, reason: null };
+  const minutes = Math.ceil(nearestResetSec / 60);
+  return {
+    recommended: true,
+    reason: `\u53CC\u65B9\u5269\u4F59\u989D\u5EA6\u5747\u9AD8\u4E8E ${pct(cfg.parallel.minRemainingPct)}\uFF0C\u6700\u8FD1 5h \u6876\u7EA6 ${minutes} \u5206\u949F\u540E\u91CD\u7F6E`
+  };
+}
+function renderBudgetInterventionDirective(claude, codex, side, reason, resumeEpoch, cfg) {
+  const resumeText = `\u9884\u8BA1\u6062\u590D\u65F6\u95F4\uFF08\u4EE5\u5B9E\u6D4B\u4E3A\u51C6\uFF1B\u63D0\u524D\u5237\u65B0\u4F1A\u66F4\u65E9\u89E3\u9664\uFF09\uFF1A${formatEpoch(resumeEpoch)}\u3002`;
+  if (side === "claude") {
+    return [
+      "\u3010\u9884\u7B97\u534F\u8C03 \xB7 \u8D26\u53F7\u7EA7\u3011Claude \u4FA7\u989D\u5EA6\u7D27\u5F20\uFF0C\u8FDB\u5165\u63A5\u529B\u6A21\u5F0F\u3002",
+      `\u89E6\u53D1\u65B9\uFF1AClaude\uFF1B\u539F\u56E0\uFF1A${reason}\u3002`,
+      `${usageSummary("claude", claude)}\uFF1B${usageSummary("codex", codex)}\u3002`,
+      `\u6062\u590D\u53C2\u8003\uFF1AClaude gateUtil \u4F4E\u4E8E ${pct(cfg.resumeBelow)} \u4E14\u6CA1\u6709\u6709\u6548 rate_limit\uFF1B${resumeText}`,
+      "\u8BF7\u7ACB\u5373\u4EA4\u63A5\uFF1A\u628A\u5269\u4F59\u4EFB\u52A1\u6E05\u5355\u3001\u5173\u952E\u4E0A\u4E0B\u6587\u3001\u4EA7\u51FA\u4F4D\u7F6E\u3001\u9A8C\u6536\u6807\u51C6\u6253\u5305\u6210\u4E00\u6761 reply \u53D1\u7ED9 Codex\u3002",
+      "\u4EA4\u63A5\u540E Claude \u505C\u624B\uFF1B\u8981\u6C42 Codex \u5728\u5355 turn \u5185\u5C3D\u91CF\u5B8C\u6210\uFF0C\u5C3E\u5DF4\u5199 checkpoint\uFF0C\u6682\u505C\u671F\u4E0D\u8981\u671F\u5F85 Claude \u56DE\u590D\u3002"
+    ].join(`
+`);
   }
-});
-codex.on("turnCompleted", () => {
-  log("Codex turn completed");
-  statusBuffer.flush("turn completed");
-  if (replyRequired && !replyReceivedDuringTurn) {
-    log("\u26A0\uFE0F Reply was required but Codex did not send any agentMessage");
-    emitToClaude(systemMessage("system_reply_missing", "\u26A0\uFE0F Codex completed the turn without sending a reply (require_reply was set). Codex may not have generated an agentMessage. You may want to retry or rephrase."));
+  if (side === "codex") {
+    return [
+      "\u3010\u9884\u7B97\u534F\u8C03 \xB7 \u8D26\u53F7\u7EA7\u3011Codex \u4FA7\u989D\u5EA6\u7D27\u5F20\uFF0C\u6682\u505C\u59D4\u6D3E\u3002",
+      `\u89E6\u53D1\u65B9\uFF1ACodex\uFF1B\u539F\u56E0\uFF1A${reason}\u3002`,
+      `${usageSummary("claude", claude)}\uFF1B${usageSummary("codex", codex)}\u3002`,
+      `\u6062\u590D\u53C2\u8003\uFF1ACodex gateUtil \u4F4E\u4E8E ${pct(cfg.resumeBelow)} \u4E14\u6CA1\u6709\u6709\u6548 rate_limit\uFF1B${resumeText}`,
+      "\u8BF7 Claude \u5199 checkpoint\uFF0C\u5E76\u53EF solo \u63A8\u8FDB\u4E0D\u4F9D\u8D56 Codex \u7684\u72EC\u7ACB\u90E8\u5206\uFF1B\u4E0D\u8981\u7EE7\u7EED\u5411 Codex \u59D4\u6D3E\uFF0C\u6807\u6CE8\u6E05\u695A\u5206\u5DE5\u65AD\u70B9\u3002"
+    ].join(`
+`);
+  }
+  return [
+    "\u3010\u9884\u7B97\u534F\u8C03 \xB7 \u8D26\u53F7\u7EA7\u3011\u8FDB\u5165\u8054\u5408\u6682\u505C\u3002",
+    `\u89E6\u53D1\u65B9\uFF1A\u53CC\u65B9\uFF1B\u539F\u56E0\uFF1A${reason}\u3002`,
+    `${usageSummary("claude", claude)}\uFF1B${usageSummary("codex", codex)}\u3002`,
+    `\u6062\u590D\u6761\u4EF6\uFF1AClaude \u4E0E Codex \u7684 gateUtil \u90FD\u4F4E\u4E8E ${pct(cfg.resumeBelow)}\uFF0C\u4E14\u6CA1\u6709\u6709\u6548 rate_limit\uFF1B${resumeText}`,
+    "\u8BF7\u6536\u5C3E\u5F53\u524D\u6B65\u3001\u5199 checkpoint\u3001\u505C\u6B62\u7EE7\u7EED\u59D4\u6D3E\uFF1Bpause \u671F\u95F4\u4E0D\u8981\u91CD\u8BD5\u5411 Codex \u53D1\u9001 reply\u3002"
+  ].join(`
+`);
+}
+function balanceDirective(claude, codex, drift, parallel) {
+  const heavier = drift.heavier ? AGENT_LABEL[drift.heavier] : "\u672A\u77E5";
+  const lighter = drift.lighter ? AGENT_LABEL[drift.lighter] : "\u672A\u77E5";
+  const lines = [
+    "\u3010\u9884\u7B97\u534F\u8C03 \xB7 \u8D26\u53F7\u7EA7\u3011\u68C0\u6D4B\u5230\u53CC\u65B9\u7528\u91CF\u6BD4\u4F8B\u6F02\u79FB\u3002",
+    `${usageSummary("claude", claude)}\uFF1B${usageSummary("codex", codex)}\u3002`,
+    `${heavier} \u6BD4 ${lighter} \u9AD8 ${pct(Math.abs(drift.pct))}\uFF0C\u8BF7\u4F18\u5148\u628A\u540E\u7EED\u53EF\u62C6\u5206\u4EFB\u52A1\u5206\u7ED9 ${lighter}\uFF0C\u76F4\u5230 warnUtil \u63A5\u8FD1\u3002`
+  ];
+  if (parallel.recommended && parallel.reason) {
+    lines.push(`${parallel.reason}\uFF1B\u53EF\u8BA9 ${lighter} \u627F\u62C5\u66F4\u591A\u5E76\u884C\u5B50\u4EFB\u52A1\uFF0C\u517C\u987E\u5747\u8861\u4E0E\u63D0\u901F\u3002`);
+  }
+  return lines.join(`
+`);
+}
+function parallelDirective(claude, codex, parallel) {
+  return [
+    "\u3010\u9884\u7B97\u534F\u8C03 \xB7 \u8D26\u53F7\u7EA7\u3011\u5F53\u524D\u989D\u5EA6\u5BCC\u4F59\u4E14\u4E34\u8FD1 5h \u7ED3\u7B97\uFF0C\u5EFA\u8BAE\u52A8\u6001\u5E76\u884C\u3002",
+    `${usageSummary("claude", claude)}\uFF1B${usageSummary("codex", codex)}\u3002`,
+    `${parallel.reason}\uFF1B\u53EF\u4EE5\u62C6\u66F4\u591A\u72EC\u7ACB\u5B50\u4EFB\u52A1\u5E76\u884C\u63A8\u8FDB\u3002`
+  ].join(`
+`);
+}
+function codexTierFor(codex, now) {
+  if (!codex || !isDecisionGrade(codex, now))
+    return "full";
+  if (codex.warnUtil >= CODEX_ECO_WARN_UTIL)
+    return "eco";
+  if (codex.warnUtil >= CODEX_BALANCED_WARN_UTIL)
+    return "balanced";
+  return "full";
+}
+function claudeAdviceFor(claude, now) {
+  if (!claude || !isDecisionGrade(claude, now))
+    return null;
+  if (claude.warnUtil < CLAUDE_ADVICE_WARN_UTIL)
+    return null;
+  return `Claude warnUtil ${pct(claude.warnUtil)} \u5DF2\u504F\u9AD8\uFF1B\u540E\u7EED\u53EF\u62C6\u5206 subagent \u5EFA\u8BAE\u964D\u6863\u5230 haiku/sonnet\uFF0C\u5E76\u4FDD\u7559\u9AD8\u96BE\u5EA6\u4E3B\u7EBF\u7ED9\u5F53\u524D\u4F1A\u8BDD\u3002`;
+}
+function computeBudgetState(claude, codex, cfg, now) {
+  const triggers = [
+    pauseTrigger("claude", claude, cfg, now),
+    pauseTrigger("codex", codex, cfg, now)
+  ].filter((trigger) => trigger !== null);
+  const paused = triggers.length > 0;
+  const drift = driftFor(claude, codex, cfg);
+  const parallel = paused ? { recommended: false, reason: null } : parallelState(claude, codex, cfg, now);
+  const resetEpochs = {
+    claude: matchingGateReset(claude),
+    codex: matchingGateReset(codex)
+  };
+  const filteredResumeAfterEpoch = paused ? resumeAfterEpoch(claude, codex, cfg, now) : null;
+  let phase = "normal";
+  if (paused)
+    phase = "paused";
+  else if (drift.heavier && drift.lighter)
+    phase = "balance";
+  else if (parallel.recommended)
+    phase = "parallel";
+  const pauseSide = !paused ? null : triggers.length > 1 ? "both" : triggers[0].agent;
+  let directiveToClaude = null;
+  if (phase === "paused") {
+    directiveToClaude = renderBudgetInterventionDirective(claude, codex, pauseSide ?? "both", triggers.map((trigger) => trigger.reason).join("\uFF1B"), filteredResumeAfterEpoch, cfg);
+  } else if (phase === "balance" && claude && codex) {
+    directiveToClaude = balanceDirective(claude, codex, drift, parallel);
+  } else if (phase === "parallel" && claude && codex) {
+    directiveToClaude = parallelDirective(claude, codex, parallel);
+  }
+  return {
+    phase,
+    now,
+    perAgent: { claude, codex },
+    drift,
+    pause: {
+      active: paused,
+      side: pauseSide,
+      reason: paused ? triggers.map((trigger) => trigger.reason).join("\uFF1B") : null,
+      resumeBelow: cfg.resumeBelow,
+      resumeAfterEpoch: filteredResumeAfterEpoch,
+      resetEpochs
+    },
+    parallel,
+    effort: { claudeAdvice: claudeAdviceFor(claude, now), codexTier: codexTierFor(codex, now) },
+    directiveToClaude
+  };
+}
+
+// src/budget/budget-coordinator.ts
+var RESET_FINGERPRINT_BUCKET_SEC = 600;
+var AGENT_LABEL2 = {
+  claude: "Claude",
+  codex: "Codex"
+};
+function pct2(value) {
+  return `${Math.round(value * 10) / 10}%`;
+}
+function usageLine(agent, usage) {
+  if (!usage)
+    return `${AGENT_LABEL2[agent]} \u672A\u77E5`;
+  return `${AGENT_LABEL2[agent]} gate=${pct2(usage.gateUtil)} warn=${pct2(usage.warnUtil)}`;
+}
+function matchingGateReset2(usage) {
+  if (!usage)
+    return 0;
+  const windows = [usage.fiveHour, usage.weekly].filter((window) => !!window && window.resetEpoch > 0);
+  const matching = windows.filter((window) => Math.abs(window.util - usage.gateUtil) < 0.0001);
+  const candidates = matching.length > 0 ? matching : windows;
+  if (candidates.length === 0)
+    return 0;
+  return Math.min(...candidates.map((window) => window.resetEpoch));
+}
+
+class BudgetCoordinator {
+  source;
+  config;
+  emit;
+  onPauseChange;
+  now;
+  log;
+  timer = null;
+  running = false;
+  activeSides = new Set;
+  lastDirectiveFingerprint = null;
+  latestSnapshot = null;
+  pauseReason = null;
+  pauseResumeAfterEpoch = null;
+  pendingOverrideTier = null;
+  pendingOverrides = null;
+  lastAppliedTier = "full";
+  missingFullMappingLogged = false;
+  sequence = 0;
+  constructor(options) {
+    this.source = options.source;
+    this.config = options.config;
+    this.emit = options.emit;
+    this.onPauseChange = options.onPauseChange;
+    this.now = options.now ?? (() => Math.floor(Date.now() / 1000));
+    this.log = options.log ?? (() => {});
+  }
+  async start() {
+    if (this.running || !this.config.enabled)
+      return;
+    this.running = true;
+    await this.pollOnce();
+    if (this.running)
+      this.scheduleNext();
+  }
+  stop() {
+    this.running = false;
+    if (this.timer) {
+      clearTimeout(this.timer);
+      this.timer = null;
+    }
+  }
+  isPaused() {
+    return this.activeSides.size > 0;
+  }
+  isGateClosed() {
+    return this.activeSides.has("codex");
+  }
+  getSnapshot() {
+    return this.latestSnapshot;
+  }
+  getCodexTurnOverrides() {
+    if (!this.tierControlEnabled())
+      return null;
+    return this.pendingOverrides ? { ...this.pendingOverrides } : null;
+  }
+  notifyOverridesDelivered() {
+    if (!this.pendingOverrideTier)
+      return;
+    this.lastAppliedTier = this.pendingOverrideTier;
+    this.pendingOverrideTier = null;
+    this.pendingOverrides = null;
+  }
+  resetAppliedTier() {
+    this.lastAppliedTier = "full";
+    this.pendingOverrideTier = null;
+    this.pendingOverrides = null;
+  }
+  scheduleNext() {
+    if (!this.running)
+      return;
+    if (this.timer)
+      clearTimeout(this.timer);
+    const delayMs = Math.max(0, this.config.pollSeconds * 1000);
+    this.timer = setTimeout(() => {
+      this.timer = null;
+      this.pollAndReschedule();
+    }, delayMs);
+  }
+  async pollAndReschedule() {
+    await this.pollOnce();
+    if (this.running)
+      this.scheduleNext();
+  }
+  async pollOnce() {
+    let usage;
+    try {
+      usage = await this.source.fetchBoth();
+    } catch (error) {
+      this.log(`budget coordinator poll failed: ${error instanceof Error ? error.message : String(error)}`);
+      return;
+    }
+    if (!usage) {
+      if (!this.isPaused())
+        this.latestSnapshot = null;
+      return;
+    }
+    if (!this.running) {
+      return;
+    }
+    const state = computeBudgetState(usage.claude, usage.codex, this.config, this.now());
+    this.updatePendingOverrides(state.effort.codexTier);
+    this.applyState(state);
+    this.latestSnapshot = this.toSnapshot(state);
+  }
+  applyState(state) {
+    const previousSide = this.pauseSide();
+    this.updateActiveSides(state);
+    const currentSide = this.pauseSide();
+    if (currentSide) {
+      this.pauseReason = this.interventionReason(state);
+      const nextResumeAfterEpoch = this.resumeAfterEpoch(state);
+      this.pauseResumeAfterEpoch = previousSide === currentSide ? nextResumeAfterEpoch ?? this.pauseResumeAfterEpoch : nextResumeAfterEpoch;
+      const fingerprint2 = previousSide === currentSide && this.activeSideProbeUncertain(state) && this.lastDirectiveFingerprint ? this.lastDirectiveFingerprint : this.directiveFingerprint(state, currentSide);
+      if (!previousSide) {
+        this.onPauseChange(true);
+      }
+      if (!previousSide || previousSide !== currentSide || fingerprint2 !== this.lastDirectiveFingerprint) {
+        this.emitDirective(this.interventionPrefix(currentSide), this.interventionDirective(state, currentSide));
+      }
+      this.lastDirectiveFingerprint = fingerprint2;
+      return;
+    }
+    if (previousSide) {
+      this.pauseReason = null;
+      this.pauseResumeAfterEpoch = null;
+      this.lastDirectiveFingerprint = null;
+      this.onPauseChange(false);
+      this.emitDirective(this.recoveryPrefix(previousSide), this.recoveryDirective(state, previousSide));
+      return;
+    }
+    if (!isDecisionGrade(state.perAgent.claude, state.now) || !isDecisionGrade(state.perAgent.codex, state.now)) {
+      return;
+    }
+    if (!state.directiveToClaude) {
+      this.lastDirectiveFingerprint = null;
+      return;
+    }
+    const fingerprint = this.directiveFingerprint(state);
+    if (fingerprint !== this.lastDirectiveFingerprint) {
+      const prefix = state.phase === "balance" ? "system_budget_balance" : "system_budget_parallel";
+      this.emitDirective(prefix, state.directiveToClaude);
+      this.lastDirectiveFingerprint = fingerprint;
+    }
+  }
+  updateActiveSides(state) {
+    for (const agent of ["claude", "codex"]) {
+      const usage = state.perAgent[agent];
+      if (this.shouldEnter(usage, state.now)) {
+        this.activeSides.add(agent);
+      } else if (this.activeSides.has(agent) && this.canAgentResume(usage, state.now)) {
+        this.activeSides.delete(agent);
+      }
+    }
+  }
+  shouldEnter(usage, now) {
+    if (!isDecisionGrade(usage, now))
+      return false;
+    return usage.gateUtil >= this.config.pauseAt;
+  }
+  canAgentResume(usage, now) {
+    if (!isDecisionGrade(usage, now))
+      return false;
+    if (usage.rateLimitedUntil > now)
+      return false;
+    return usage.gateUtil < this.config.resumeBelow;
+  }
+  resumeAfterEpoch(state) {
+    const epochs = ["claude", "codex"].filter((agent) => this.activeSides.has(agent)).map((agent) => this.resumeBlockingEpoch(state.perAgent[agent], state.now)).filter((epoch) => epoch > 0);
+    if (epochs.length === 0)
+      return null;
+    return Math.max(...epochs);
+  }
+  resumeBlockingEpoch(usage, now) {
+    if (!usage)
+      return 0;
+    if (usage.rateLimitedUntil > now)
+      return usage.rateLimitedUntil;
+    if (usage.gateUtil >= this.config.resumeBelow)
+      return matchingGateReset2(usage);
+    return 0;
+  }
+  tierControlEnabled() {
+    if (!this.config.codexTierControl)
+      return false;
+    if (this.config.codexTiers.full)
+      return true;
+    if (!this.missingFullMappingLogged) {
+      this.missingFullMappingLogged = true;
+      this.log("Codex tier control disabled: budget.codexTiers.full restore mapping is missing");
+    }
+    return false;
+  }
+  updatePendingOverrides(tier) {
+    if (!this.tierControlEnabled()) {
+      this.pendingOverrideTier = null;
+      this.pendingOverrides = null;
+      return;
+    }
+    if (this.lastAppliedTier === tier) {
+      this.pendingOverrideTier = null;
+      this.pendingOverrides = null;
+      return;
+    }
+    if (this.pendingOverrideTier === tier)
+      return;
+    const overrides = this.config.codexTiers[tier];
+    if (!overrides) {
+      this.pendingOverrideTier = null;
+      this.pendingOverrides = null;
+      return;
+    }
+    this.pendingOverrideTier = tier;
+    this.pendingOverrides = { ...overrides };
+  }
+  directiveFingerprint(state, activeSide) {
+    const side = activeSide ?? (state.phase === "balance" ? state.drift.lighter ?? "none" : state.pause.side ?? "none");
+    let reset = 0;
+    if (activeSide === "claude") {
+      reset = state.pause.resetEpochs.claude;
+    } else if (activeSide === "codex") {
+      reset = state.pause.resetEpochs.codex;
+    } else if (activeSide === "both") {
+      reset = Math.max(state.pause.resetEpochs.claude, state.pause.resetEpochs.codex);
+    } else if (state.phase === "balance" && state.drift.lighter) {
+      reset = state.perAgent[state.drift.lighter]?.fiveHour?.resetEpoch ?? 0;
+    } else if (side === "claude") {
+      reset = state.pause.resetEpochs.claude;
+    } else if (side === "codex") {
+      reset = state.pause.resetEpochs.codex;
+    } else if (side === "both") {
+      reset = Math.max(state.pause.resetEpochs.claude, state.pause.resetEpochs.codex);
+    }
+    return [
+      activeSide ? "paused" : state.phase,
+      state.drift.heavier ?? "none",
+      side,
+      Math.round(reset / RESET_FINGERPRINT_BUCKET_SEC)
+    ].join("|");
+  }
+  emitDirective(prefix, content) {
+    this.emit(`${prefix}_${this.sequence++}`, content);
+  }
+  pauseSide() {
+    const claude = this.activeSides.has("claude");
+    const codex = this.activeSides.has("codex");
+    if (claude && codex)
+      return "both";
+    if (claude)
+      return "claude";
+    if (codex)
+      return "codex";
+    return null;
+  }
+  interventionPrefix(side) {
+    return side === "claude" ? "system_budget_handoff" : "system_budget_pause";
+  }
+  recoveryPrefix(previousSide) {
+    return previousSide === "claude" ? "system_budget_claude_recovered" : "system_budget_resume";
+  }
+  interventionDirective(state, side) {
+    return renderBudgetInterventionDirective(state.perAgent.claude, state.perAgent.codex, side, this.pauseReason ?? "\u9884\u7B97\u63A5\u8FD1\u8017\u5C3D", this.pauseResumeAfterEpoch, this.config);
+  }
+  interventionReason(state) {
+    return ["claude", "codex"].filter((agent) => this.activeSides.has(agent)).map((agent) => this.activeSideReason(agent, state.perAgent[agent], state.now)).join("\uFF1B");
+  }
+  activeSideProbeUncertain(state) {
+    return ["claude", "codex"].some((agent) => {
+      if (!this.activeSides.has(agent))
+        return false;
+      const usage = state.perAgent[agent];
+      return usage === null || usage.rateLimitedUntil > state.now || !isDecisionGrade(usage, state.now);
+    });
+  }
+  activeSideReason(agent, usage, now) {
+    if (!usage)
+      return `${AGENT_LABEL2[agent]} \u63A2\u6D4B\u6682\u65F6\u4E0D\u53EF\u7528\uFF0C\u4FDD\u6301\u4E0A\u4E00\u8F6E\u9884\u7B97\u5E72\u9884`;
+    if (usage.rateLimitedUntil > now) {
+      return `${AGENT_LABEL2[agent]} \u63A2\u9488\u88AB\u9650\u6D41\u81F3 ${this.formatEpoch(usage.rateLimitedUntil)}`;
+    }
+    if (usage.gateUtil >= this.config.pauseAt) {
+      return `${AGENT_LABEL2[agent]} gateUtil ${pct2(usage.gateUtil)} \u2265 pauseAt ${pct2(this.config.pauseAt)}`;
+    }
+    return `${AGENT_LABEL2[agent]} gateUtil ${pct2(usage.gateUtil)} \u5C1A\u672A\u4F4E\u4E8E resumeBelow ${pct2(this.config.resumeBelow)}`;
+  }
+  recoveryDirective(state, previousSide) {
+    if (previousSide === "claude") {
+      return [
+        "\u3010\u9884\u7B97\u534F\u8C03 \xB7 \u8D26\u53F7\u7EA7\u3011Claude \u4FA7\u9884\u7B97\u5DF2\u6062\u590D\u3002",
+        `${usageLine("claude", state.perAgent.claude)}\uFF1B${usageLine("codex", state.perAgent.codex)}\u3002`,
+        `Claude gateUtil \u5DF2\u4F4E\u4E8E ${pct2(this.config.resumeBelow)}\uFF0C\u4E14\u6CA1\u6709\u6709\u6548 rate_limit\u3002`,
+        "Claude \u53EF\u6062\u590D orchestrator \u89D2\u8272\uFF1B\u540E\u7EED\u5206\u914D\u524D\u8BF7\u91CD\u65B0\u67E5\u8BE2\u5B9E\u65F6\u989D\u5EA6\uFF0C\u4E0D\u8981\u4F9D\u8D56\u65E7\u6570\u5B57\u3002"
+      ].join(`
+`);
+    }
+    if (previousSide === "codex") {
+      return [
+        "\u3010\u9884\u7B97\u534F\u8C03 \xB7 \u8D26\u53F7\u7EA7\u3011Codex \u4FA7\u9884\u7B97\u95F8\u95E8\u89E3\u9664\u3002",
+        `${usageLine("claude", state.perAgent.claude)}\uFF1B${usageLine("codex", state.perAgent.codex)}\u3002`,
+        `\u95F8\u95E8\u5DF2\u653E\u5F00\uFF1ACodex gateUtil \u4F4E\u4E8E ${pct2(this.config.resumeBelow)}\uFF0C\u4E14\u6CA1\u6709\u6709\u6548 rate_limit\u3002`,
+        "\u5EFA\u8BAE Claude \u7528 reply \u5E26\u4E0A\u5F53\u524D\u76EE\u6807\u3001checkpoint \u548C\u4E0B\u4E00\u6B65\uFF0C\u5524\u9192 Codex \u63A5\u7EED\u6267\u884C\u3002"
+      ].join(`
+`);
+    }
+    return [
+      "\u3010\u9884\u7B97\u534F\u8C03 \xB7 \u8D26\u53F7\u7EA7\u3011\u8054\u5408\u6682\u505C\u89E3\u9664\u3002",
+      `${usageLine("claude", state.perAgent.claude)}\uFF1B${usageLine("codex", state.perAgent.codex)}\u3002`,
+      `\u95F8\u95E8\u5DF2\u653E\u5F00\uFF1A\u53CC\u65B9 gateUtil \u5747\u4F4E\u4E8E ${pct2(this.config.resumeBelow)}\uFF0C\u4E14\u6CA1\u6709\u6709\u6548 rate_limit\u3002`,
+      "\u5EFA\u8BAE Claude \u7528 reply \u5E26\u4E0A\u5F53\u524D\u76EE\u6807\u3001checkpoint \u548C\u4E0B\u4E00\u6B65\uFF0C\u5524\u9192 Codex \u63A5\u7EED\u6267\u884C\u3002"
+    ].join(`
+`);
+  }
+  formatEpoch(epoch) {
+    return new Date(epoch * 1000).toISOString().replace("T", " ").replace(/\.\d+Z$/, "Z");
+  }
+  toSnapshot(state) {
+    const paused = this.isPaused();
+    return {
+      phase: paused ? "paused" : state.phase,
+      updatedAt: state.now,
+      claude: state.perAgent.claude,
+      codex: state.perAgent.codex,
+      driftPct: state.drift.pct,
+      paused,
+      gateClosed: this.isGateClosed(),
+      pauseSide: this.pauseSide(),
+      pauseReason: paused ? this.pauseReason ?? state.pause.reason : null,
+      resumeAfterEpoch: paused ? this.pauseResumeAfterEpoch ?? state.pause.resumeAfterEpoch : null,
+      parallelRecommended: paused ? false : state.parallel.recommended,
+      codexTier: state.effort.codexTier,
+      claudeAdvice: state.effort.claudeAdvice
+    };
+  }
+}
+
+// src/budget/quota-source.ts
+import { execFile } from "child_process";
+import { existsSync as existsSync5 } from "fs";
+import { homedir as homedir2 } from "os";
+import { basename, join as join4 } from "path";
+var DEFAULT_TIMEOUT_MS = 1e4;
+var MAX_BUFFER = 1024 * 1024;
+function defaultRunner(command, args, options) {
+  return new Promise((resolve, reject) => {
+    execFile(command, args, {
+      env: options.env,
+      timeout: options.timeoutMs,
+      maxBuffer: MAX_BUFFER
+    }, (error, stdout) => {
+      if (error && !stdout) {
+        reject(error);
+        return;
+      }
+      resolve({ stdout });
+    });
+  });
+}
+function commandKind(command) {
+  return basename(command) === "probe.mjs" ? "probe-mjs" : "budget-probe";
+}
+function argsFor(candidate, agent) {
+  if (candidate.kind === "probe-mjs")
+    return [agent, "probe"];
+  return ["--agent", agent];
+}
+function asFiniteNumber(value) {
+  if (typeof value === "number" && Number.isFinite(value))
+    return value;
+  if (typeof value === "string" && value.trim() !== "") {
+    const parsed = Number(value);
+    if (Number.isFinite(parsed))
+      return parsed;
+  }
+  return null;
+}
+function numberOr(value, fallback) {
+  return asFiniteNumber(value) ?? fallback;
+}
+function clamp(value, min, max) {
+  return Math.min(max, Math.max(min, value));
+}
+function asRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value) ? value : null;
+}
+function normalizeBucket(value, fetchedAt) {
+  const bucket = asRecord(value);
+  if (!bucket)
+    return null;
+  const id = typeof bucket.id === "string" ? bucket.id : "";
+  const util = asFiniteNumber(bucket.util);
+  if (util === null)
+    return null;
+  const resetAfter = asFiniteNumber(bucket.reset_after_seconds ?? bucket.resetAfterSeconds);
+  let resetEpoch = numberOr(bucket.reset_epoch ?? bucket.resetEpoch, 0);
+  if (resetEpoch <= 0 && resetAfter !== null && fetchedAt > 0) {
+    resetEpoch = fetchedAt + resetAfter;
+  }
+  return {
+    id,
+    util: clamp(util, 0, 100),
+    resetEpoch: Math.max(0, resetEpoch),
+    resetAfterSeconds: resetAfter === null ? null : Math.max(0, resetAfter)
+  };
+}
+function normalizeTopLevelBucket(record, util, fetchedAt) {
+  const resetAfter = asFiniteNumber(record.reset_after_seconds ?? record.resetAfterSeconds);
+  let resetEpoch = numberOr(record.reset_epoch ?? record.resetEpoch, 0);
+  if (resetEpoch <= 0 && resetAfter !== null && fetchedAt > 0) {
+    resetEpoch = fetchedAt + resetAfter;
+  }
+  return {
+    id: "top_level",
+    util: clamp(util, 0, 100),
+    resetEpoch: Math.max(0, resetEpoch),
+    resetAfterSeconds: resetAfter === null ? null : Math.max(0, resetAfter)
+  };
+}
+function toWindow(bucket) {
+  if (!bucket)
+    return null;
+  return { util: bucket.util, resetEpoch: bucket.resetEpoch };
+}
+function bucketSortKey(bucket) {
+  if (bucket.resetAfterSeconds !== null)
+    return bucket.resetAfterSeconds;
+  if (bucket.resetEpoch > 0)
+    return bucket.resetEpoch;
+  return Number.POSITIVE_INFINITY;
+}
+function sameBucketWindow(bucket, window) {
+  return !!window && bucket.util === window.util && bucket.resetEpoch === window.resetEpoch;
+}
+function pickHighestUtil(buckets) {
+  if (buckets.length === 0)
+    return null;
+  return buckets.reduce((best, current) => {
+    if (current.util > best.util)
+      return current;
+    if (current.util === best.util && bucketSortKey(current) < bucketSortKey(best))
+      return current;
+    return best;
+  });
+}
+function identifyWindows(buckets) {
+  const fiveHourMatches = buckets.filter((bucket) => bucket.id.includes("five_hour") || bucket.id.includes("primary_window"));
+  const weeklyMatches = buckets.filter((bucket) => bucket.id.includes("seven_day") || bucket.id.includes("secondary_window"));
+  let fiveHour = toWindow(pickHighestUtil(fiveHourMatches));
+  let weekly = toWindow(pickHighestUtil(weeklyMatches));
+  const sorted = [...buckets].sort((a, b) => bucketSortKey(a) - bucketSortKey(b));
+  if (!fiveHour && sorted.length > 0) {
+    fiveHour = toWindow(sorted[0]);
+  }
+  if (!weekly && sorted.length > 1) {
+    const latestDistinct = [...sorted].reverse().find((bucket) => !sameBucketWindow(bucket, fiveHour));
+    weekly = toWindow(latestDistinct);
+  }
+  return { fiveHour, weekly };
+}
+function normalizeProbeResult(raw) {
+  const record = asRecord(raw);
+  if (!record)
+    return null;
+  const fetchedAt = numberOr(record.fetched_at ?? record.fetchedAt ?? record.now_epoch ?? record.nowEpoch, 0);
+  const hasFiniteUtil = asFiniteNumber(record.util ?? record.hard_util ?? record.hardUtil) !== null || asFiniteNumber(record.warn_util ?? record.warnUtil) !== null;
+  const gateUtil = clamp(numberOr(record.util ?? record.hard_util ?? record.hardUtil, 0), 0, 100);
+  const warnUtil = clamp(numberOr(record.warn_util ?? record.warnUtil, gateUtil), 0, 100);
+  const rawBuckets = Array.isArray(record.buckets) ? record.buckets : [];
+  const buckets = rawBuckets.map((bucket) => normalizeBucket(bucket, fetchedAt)).filter((bucket) => bucket !== null);
+  if (buckets.length === 0 && hasFiniteUtil) {
+    const topLevelBucket = normalizeTopLevelBucket(record, gateUtil, fetchedAt);
+    if (topLevelBucket)
+      buckets.push(topLevelBucket);
+  }
+  const rateLimitedUntil = Math.max(0, numberOr(record.rate_limited_until ?? record.rateLimitedUntil, 0));
+  const ok = record.ok === true;
+  if (!ok && rateLimitedUntil <= 0 && buckets.length === 0)
+    return null;
+  const { fiveHour, weekly } = identifyWindows(buckets);
+  if (!fiveHour && !weekly && rateLimitedUntil === 0 && !hasFiniteUtil)
+    return null;
+  return {
+    ok,
+    stale: record.stale === true,
+    gateUtil,
+    warnUtil,
+    fiveHour,
+    weekly,
+    remaining: clamp(100 - gateUtil, 0, 100),
+    rateLimitedUntil,
+    fetchedAt
+  };
+}
+function withTimeout(promise, timeoutMs) {
+  let timer = null;
+  const timeout = new Promise((_, reject) => {
+    timer = setTimeout(() => reject(new Error(`budget probe timed out after ${timeoutMs}ms`)), timeoutMs);
+  });
+  return Promise.race([promise, timeout]).finally(() => {
+    if (timer)
+      clearTimeout(timer);
+  });
+}
+function isDegradedUsage(usage, now = Math.floor(Date.now() / 1000)) {
+  if (usage.stale || !usage.ok)
+    return true;
+  const hasFreshWindow = usage.fiveHour !== null && usage.fiveHour.resetEpoch > now || usage.weekly !== null && usage.weekly.resetEpoch > now;
+  return !hasFreshWindow;
+}
+
+class QuotaSource {
+  env;
+  homeDir;
+  timeoutMs;
+  runner;
+  log;
+  now;
+  degradedLogged = new Map;
+  constructor(options = {}) {
+    this.env = options.env ?? process.env;
+    this.homeDir = options.homeDir ?? homedir2();
+    this.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    this.runner = options.runner ?? defaultRunner;
+    this.log = options.log ?? (() => {});
+    this.now = options.now ?? (() => Math.floor(Date.now() / 1000));
+  }
+  async fetchBoth() {
+    const candidates = this.findProbeCandidates();
+    if (candidates.length === 0)
+      return null;
+    const [claude, codex] = await Promise.all([
+      this.fetchAgent(candidates, "claude"),
+      this.fetchAgent(candidates, "codex")
+    ]);
+    return { claude, codex };
+  }
+  findProbeCandidates() {
+    const candidates = [];
+    const seen = new Set;
+    const add = (command, kind) => {
+      const key = `${kind}:${command}`;
+      if (seen.has(key))
+        return;
+      seen.add(key);
+      candidates.push({ command, kind });
+    };
+    const explicit = this.env.AGENTBRIDGE_QUOTA_PROBE || this.env.BUDGET_PROBE;
+    if (explicit && explicit.trim() !== "") {
+      const command = explicit.trim();
+      add(command, commandKind(command));
+      return candidates;
+    }
+    const binDir = join4(this.homeDir, ".budget-guard/bin");
+    const installedBudgetProbe = join4(binDir, "budget-probe");
+    if (existsSync5(installedBudgetProbe))
+      add(installedBudgetProbe, "budget-probe");
+    const installedProbeMjs = join4(binDir, "probe.mjs");
+    if (existsSync5(installedProbeMjs))
+      add(installedProbeMjs, "probe-mjs");
+    return candidates;
+  }
+  async fetchAgent(candidates, agent) {
+    for (const candidate of candidates) {
+      try {
+        const result = await withTimeout(this.runner(candidate.command, argsFor(candidate, agent), {
+          env: this.env,
+          timeoutMs: this.timeoutMs,
+          agent
+        }), this.timeoutMs);
+        const text = String(result.stdout).trim();
+        if (!text)
+          continue;
+        let parsed;
+        try {
+          parsed = JSON.parse(text);
+        } catch {
+          this.log(`budget probe output unparseable for ${agent}: ${candidate.command} \u2014 raw: ${text.slice(0, 200)}`);
+          continue;
+        }
+        const usage = normalizeProbeResult(parsed);
+        if (usage) {
+          this.noteDegradation(agent, usage);
+          return usage;
+        }
+        this.log(`budget probe returned no usable data for ${agent}: ${candidate.command} \u2014 raw: ${text.slice(0, 200)}`);
+      } catch (error) {
+        this.log(`budget probe failed for ${agent}: ${error instanceof Error ? error.message : String(error)}`);
+      }
+    }
+    return null;
+  }
+  noteDegradation(agent, usage) {
+    const degraded = isDegradedUsage(usage, this.now());
+    const wasDegraded = this.degradedLogged.get(agent) === true;
+    if (degraded && !wasDegraded) {
+      const gate = usage.rateLimitedUntil > 0 ? `, rate-limit gated until ${usage.rateLimitedUntil}` : "";
+      this.log(`budget probe degraded data accepted for ${agent} (stale=${usage.stale}, ok=${usage.ok}${gate}) \u2014 display only, decisions hold`);
+    } else if (!degraded && wasDegraded) {
+      this.log(`budget probe recovered to fresh data for ${agent}`);
+    }
+    this.degradedLogged.set(agent, degraded);
+  }
+}
+function createQuotaSource(options) {
+  return new QuotaSource(options);
+}
+
+// src/reply-required-tracker.ts
+class ReplyRequiredTracker {
+  armed = false;
+  forwardedDuringTurn = false;
+  get isArmed() {
+    return this.armed;
+  }
+  arm() {
+    this.armed = true;
+    this.forwardedDuringTurn = false;
+  }
+  noteForwarded() {
+    if (this.armed)
+      this.forwardedDuringTurn = true;
+  }
+  consumeOnTurnComplete() {
+    const warnReplyMissing = this.armed && !this.forwardedDuringTurn;
+    this.reset();
+    return { warnReplyMissing };
+  }
+  reset() {
+    this.armed = false;
+    this.forwardedDuringTurn = false;
+  }
+}
+
+// src/thread-state.ts
+import {
+  existsSync as existsSync6,
+  mkdirSync as mkdirSync4,
+  readdirSync,
+  readFileSync as readFileSync3,
+  renameSync as renameSync2,
+  writeFileSync as writeFileSync3
+} from "fs";
+import { homedir as homedir3 } from "os";
+import { basename as basename2, dirname as dirname2, join as join5 } from "path";
+function nowIso() {
+  return new Date().toISOString();
+}
+function threadTag(identity) {
+  const name = identity.pairName ?? identity.pairId ?? "manual";
+  return `abg:${name}:${identity.cwd}`;
+}
+function codexHome(env = process.env) {
+  return env.CODEX_HOME && env.CODEX_HOME.length > 0 ? env.CODEX_HOME : join5(homedir3(), ".codex");
+}
+function atomicWriteJson(path, value) {
+  mkdirSync4(dirname2(path), { recursive: true });
+  const tmp = `${path}.tmp.${process.pid}.${Date.now()}`;
+  writeFileSync3(tmp, JSON.stringify(value, null, 2) + `
+`, "utf-8");
+  renameSync2(tmp, path);
+}
+function readRawCurrentThread(stateDir) {
+  try {
+    const parsed = JSON.parse(readFileSync3(stateDir.currentThreadFile, "utf-8"));
+    if (parsed?.version === 1 && typeof parsed.threadId === "string" && parsed.threadId.length > 0 && (parsed.status === "pending" || parsed.status === "current") && typeof parsed.cwd === "string") {
+      return parsed;
+    }
+  } catch {}
+  return null;
+}
+function findCodexRolloutFile(threadId, env = process.env, maxEntries = 20000) {
+  const sessionsDir = join5(codexHome(env), "sessions");
+  if (!threadId || !existsSync6(sessionsDir))
+    return null;
+  const exactName = `rollout-${threadId}.jsonl`;
+  const stack = [sessionsDir];
+  let visited = 0;
+  while (stack.length > 0 && visited < maxEntries) {
+    const dir = stack.pop();
+    let entries;
+    try {
+      entries = readdirSync(dir, { withFileTypes: true });
+    } catch {
+      continue;
+    }
+    for (const entry of entries) {
+      visited++;
+      const path = join5(dir, entry.name);
+      if (entry.isDirectory()) {
+        stack.push(path);
+        continue;
+      }
+      if (!entry.isFile())
+        continue;
+      const name = basename2(entry.name);
+      if (name === exactName || name.startsWith("rollout-") && name.endsWith(".jsonl") && name.includes(threadId)) {
+        return path;
+      }
+    }
+  }
+  return null;
+}
+function writePendingCurrentThread(identity, threadId, reason) {
+  const state = {
+    version: 1,
+    status: "pending",
+    pairId: identity.pairId,
+    pairName: identity.pairName,
+    cwd: identity.cwd,
+    threadId,
+    updatedAt: nowIso(),
+    reason,
+    tag: threadTag(identity)
+  };
+  atomicWriteJson(identity.stateDir.currentThreadFile, state);
+  return state;
+}
+function promoteCurrentThreadIfRolloutExists(identity, threadId, reason, env = process.env) {
+  const rolloutPath = findCodexRolloutFile(threadId, env);
+  const state = {
+    version: 1,
+    status: rolloutPath ? "current" : "pending",
+    pairId: identity.pairId,
+    pairName: identity.pairName,
+    cwd: identity.cwd,
+    threadId,
+    updatedAt: nowIso(),
+    reason,
+    tag: threadTag(identity),
+    ...rolloutPath ? { rolloutPath, rolloutVerifiedAt: nowIso() } : {}
+  };
+  atomicWriteJson(identity.stateDir.currentThreadFile, state);
+  return state;
+}
+async function persistCurrentThreadWithRolloutRetry(identity, threadId, reason, options = {}) {
+  const env = options.env ?? process.env;
+  const attempts = options.attempts ?? 20;
+  const delayMs = options.delayMs ?? 250;
+  const shouldContinue = options.shouldContinue ?? (() => true);
+  if (!shouldContinue())
+    return null;
+  writePendingCurrentThread(identity, threadId, reason);
+  for (let attempt = 1;attempt <= attempts; attempt++) {
+    if (!shouldContinue()) {
+      options.log?.(`Abandoned current-thread persistence for ${threadId}: a newer thread became active`);
+      return null;
+    }
+    const state = promoteCurrentThreadIfRolloutExists(identity, threadId, reason, env);
+    if (state.status === "current") {
+      options.log?.(`Current Codex thread persisted: ${threadId} (${state.rolloutPath})`);
+      return state;
+    }
+    if (attempt < attempts) {
+      await new Promise((resolve) => setTimeout(resolve, delayMs));
+    }
+  }
+  if (!shouldContinue())
+    return null;
+  options.log?.(`Current Codex thread left pending because no rollout file was found: ${threadId}`);
+  return readRawCurrentThread(identity.stateDir) ?? writePendingCurrentThread(identity, threadId, reason);
+}
+
+// src/waiting-message.ts
+function formatWaitingForCodexTuiMessage(options) {
+  const pairName = options.pairName ?? "unknown";
+  const pairId = options.pairId ?? "manual";
+  const slot = options.slot === null || options.slot === undefined ? "manual" : String(options.slot);
+  return [
+    "\u23F3 Waiting for Codex TUI to connect.",
+    `Current pair: cwd=${options.cwd} pair=${pairName} pairId=${pairId} slot=${slot} proxy=${options.proxyUrl}`,
+    "If Codex was started from a different cwd, it belongs to another pair and will not attach here.",
+    "Run in another terminal:",
+    options.attachCmd,
+    "For diagnostics: abg doctor"
+  ].join(`
+`);
+}
+
+// src/pair-registry.ts
+var PAIR_BASE_PORT = 4500;
+var PAIR_SLOT_STRIDE = 10;
+var MAX_PAIR_SLOT = Math.floor((65535 - 2 - PAIR_BASE_PORT) / PAIR_SLOT_STRIDE);
+
+// src/liveness-probe.ts
+var OPEN = 1;
+async function probeLiveness(target, options) {
+  const {
+    timeoutMs,
+    pollMs = 50,
+    now = Date.now,
+    sleep = (ms) => new Promise((r) => setTimeout(r, ms))
+  } = options;
+  if (target.readyState !== OPEN)
+    return false;
+  const baseline = target.pongCount;
+  try {
+    target.ping();
+  } catch {
+    return false;
+  }
+  const deadline = now() + timeoutMs;
+  while (now() < deadline) {
+    if (target.pongCount > baseline)
+      return true;
+    if (target.readyState !== OPEN)
+      return false;
+    await sleep(pollMs);
+  }
+  return target.pongCount > baseline;
+}
+
+// src/daemon.ts
+var stateDir = new StateDirResolver;
+stateDir.ensure();
+var configService = new ConfigService;
+var config = configService.loadOrDefault();
+var processLogger = createProcessLogger({ component: "AgentBridgeDaemon", logFile: stateDir.logFile });
+var CODEX_APP_PORT = parseInt(process.env.CODEX_WS_PORT ?? String(config.codex.appPort), 10);
+var CODEX_PROXY_PORT = parseInt(process.env.CODEX_PROXY_PORT ?? String(config.codex.proxyPort), 10);
+var CONTROL_PORT = parseInt(process.env.AGENTBRIDGE_CONTROL_PORT ?? "4502", 10);
+var TUI_DISCONNECT_GRACE_MS = parseInt(process.env.TUI_DISCONNECT_GRACE_MS ?? "2500", 10);
+var CLAUDE_DISCONNECT_GRACE_MS = 5000;
+var MAX_BUFFERED_MESSAGES = parseInt(process.env.AGENTBRIDGE_MAX_BUFFERED_MESSAGES ?? "100", 10);
+var FILTER_MODE = process.env.AGENTBRIDGE_FILTER_MODE === "full" ? "full" : "filtered";
+var IDLE_SHUTDOWN_MS = parseInt(process.env.AGENTBRIDGE_IDLE_SHUTDOWN_MS ?? String(config.idleShutdownSeconds * 1000), 10);
+var ATTENTION_WINDOW_MS = parseInt(process.env.AGENTBRIDGE_ATTENTION_WINDOW_MS ?? String(config.turnCoordination.attentionWindowSeconds * 1000), 10);
+var BOOTSTRAP_TIMEOUT_MS = parsePositiveIntEnv("AGENTBRIDGE_BOOTSTRAP_TIMEOUT_MS", 45000);
+var CODEX_BOOT_RETRIES = parsePositiveIntEnv("AGENTBRIDGE_CODEX_BOOT_RETRIES", 2);
+var ALLOW_IDENTITYLESS_CLIENT = process.env.AGENTBRIDGE_COMPAT_IDENTITYLESS === "1";
+var BUDGET_CONFIG = applyBudgetEnvOverrides(config.budget);
+var daemonLifecycle = new DaemonLifecycle({ stateDir, controlPort: CONTROL_PORT, log });
+var codex = new CodexAdapter(CODEX_APP_PORT, CODEX_PROXY_PORT, stateDir.logFile);
+var attachCmd = `codex --enable tui_app_server --remote ${codex.proxyUrl}`;
+var controlServer = null;
+var attachedClaude = null;
+var nextControlClientId = 0;
+var nextSystemMessageId = 0;
+var codexBootstrapped = false;
+var attentionWindowTimer = null;
+var inAttentionWindow = false;
+var replyTracker = new ReplyRequiredTracker;
+var shuttingDown = false;
+var bootDeadlineTimer = null;
+var idleShutdownTimer = null;
+var claudeDisconnectTimer = null;
+var lastAttachStatusSentTs = 0;
+var ATTACH_STATUS_COOLDOWN_MS = 30000;
+var LIVENESS_PROBE_TIMEOUT_MS = parsePositiveIntEnv("AGENTBRIDGE_LIVENESS_PROBE_TIMEOUT_MS", 3000, log);
+var LIVENESS_PROBE_POLL_MS = 50;
+var challengeInProgress = false;
+var bufferedMessages = [];
+var budgetCoordinator = null;
+var budgetStatusTimer = null;
+function ensureBudgetCoordinatorStarted() {
+  if (!BUDGET_CONFIG.enabled)
+    return;
+  if (!budgetCoordinator) {
+    log(`Budget coordinator config: pollSeconds=${BUDGET_CONFIG.pollSeconds} pauseAt=${BUDGET_CONFIG.pauseAt} ` + `resumeBelow=${BUDGET_CONFIG.resumeBelow} syncDriftPct=${BUDGET_CONFIG.syncDriftPct} ` + `parallel=${BUDGET_CONFIG.parallel.minRemainingPct}%/${BUDGET_CONFIG.parallel.timeWindowSec}s ` + `codexTierControl=${BUDGET_CONFIG.codexTierControl} ` + `codexTiersFull=${BUDGET_CONFIG.codexTiers.full ? "configured" : "missing"}`);
+    budgetCoordinator = new BudgetCoordinator({
+      source: createQuotaSource({ log }),
+      config: BUDGET_CONFIG,
+      emit: (id, content) => {
+        emitToClaude(systemMessage(id, content));
+        queueMicrotask(() => broadcastStatus());
+      },
+      onPauseChange: (paused) => {
+        log(`Budget intervention ${paused ? "ACTIVE" : "CLEARED"} ` + `(gate ${budgetCoordinator?.isGateClosed() ? "CLOSED" : "OPEN"})`);
+        queueMicrotask(() => broadcastStatus());
+      },
+      log
+    });
+  }
+  budgetCoordinator.start();
+  if (!budgetStatusTimer) {
+    budgetStatusTimer = setInterval(() => broadcastStatus(), BUDGET_CONFIG.pollSeconds * 1000);
+    budgetStatusTimer.unref?.();
+  }
+}
+function stopBudgetCoordinator() {
+  budgetCoordinator?.stop();
+  if (budgetStatusTimer) {
+    clearInterval(budgetStatusTimer);
+    budgetStatusTimer = null;
+  }
+}
+function budgetPauseGateError() {
+  const snapshot = budgetCoordinator?.getSnapshot() ?? null;
+  const reason = snapshot?.pauseReason ?? "Codex \u4FA7\u989D\u5EA6\u63A5\u8FD1\u8017\u5C3D";
+  const resumeAt = snapshot?.resumeAfterEpoch ? new Date(snapshot.resumeAfterEpoch * 1000).toISOString().replace("T", " ").replace(/\.\d+Z$/, "Z") : null;
+  const sideHint = snapshot?.pauseSide === "both" ? "\u53CC\u4FA7\u989D\u5EA6\u5747\u5DF2\u8017\u5C3D\uFF0C\u8BF7\u5199 checkpoint \u7B49\u5F85\u5237\u65B0" : "\u4F60\u53EF\u7EE7\u7EED solo \u63A8\u8FDB\u53EF\u72EC\u7ACB\u90E8\u5206\uFF0C\u5E76\u5199 checkpoint \u6807\u6CE8\u5206\u5DE5\u65AD\u70B9";
+  return `\u9884\u7B97\u6682\u505C\uFF08\u95F8\u95E8\u5173\u95ED\uFF09\uFF0C\u5DF2\u62D2\u7EDD\u8F6C\u53D1\uFF1A${reason}\u3002` + `Codex \u4FA7 gateUtil \u4F4E\u4E8E ${BUDGET_CONFIG.resumeBelow}% \u540E\u95F8\u95E8\u81EA\u52A8\u653E\u5F00` + (resumeAt ? `\uFF08\u9884\u8BA1\u6062\u590D ${resumeAt}\uFF0C\u4EE5\u5B9E\u6D4B\u4E3A\u51C6\uFF1B\u63D0\u524D\u5237\u65B0\u4F1A\u66F4\u65E9\u89E3\u9664\uFF09` : "") + `\u3002\u6536\u5230 RESUME \u901A\u77E5\u524D\u8BF7\u52FF\u91CD\u8BD5\u5411 Codex \u53D1\u9001 reply\uFF1B${sideHint}\u3002`;
+}
+var tuiConnectionState = new TuiConnectionState({
+  disconnectGraceMs: TUI_DISCONNECT_GRACE_MS,
+  log,
+  onDisconnectPersisted: (connId) => {
+    emitToClaude(systemMessage("system_tui_disconnected", `\u26A0\uFE0F Codex TUI disconnected (conn #${connId}). Codex is still running in the background \u2014 reconnect the TUI to resume.`));
+  },
+  onReconnectAfterNotice: (connId) => {
+    emitToClaude(systemMessage("system_tui_reconnected", `\u2705 Codex TUI reconnected (conn #${connId}). Bridge restored, communication can continue.`));
+  }
+});
+var statusBuffer = new StatusBuffer((summary) => emitToClaude(summary));
+function tryWriteStatusFile(reason) {
+  try {
+    writeStatusFile();
+  } catch (err) {
+    log(`status file write failed (${reason}): ${err?.message ?? err}`);
+  }
+}
+codex.on("turnPhaseChanged", ({ phase, previous }) => {
+  log(`Codex turn phase: ${previous} \u2192 ${phase}`);
+  tryWriteStatusFile(`turnPhase:${phase}`);
+  broadcastStatus();
+});
+codex.on("steerFailed", (reason) => {
+  log(`Steer rejected by app-server: ${reason}`);
+  emitToClaude(systemMessage("system_steer_failed", `\u26A0\uFE0F Your steer message did NOT reach Codex (${reason}). The original turn continues unaffected \u2014 wait for it to finish, or resend as a normal reply.`));
+});
+codex.on("steerAccepted", () => {
+  log("Steer accepted by app-server");
+});
+codex.on("turnStarted", () => {
+  log("Codex turn started");
+  emitToClaude(systemMessage("system_turn_started", "\u23F3 Codex is working on the current task. Wait for completion before sending a reply."));
+});
+codex.on("agentMessage", (msg) => {
+  if (msg.source !== "codex")
+    return;
+  const result = classifyMessage(msg.content, FILTER_MODE);
+  if (replyTracker.isArmed) {
+    log(`Codex \u2192 Claude [${result.marker}/force-forward-reply-required] (${msg.content.length} chars)`);
+    replyTracker.noteForwarded();
+    if (statusBuffer.size > 0) {
+      statusBuffer.flush("reply-required message arrived");
+    }
+    emitToClaude(msg);
+    return;
+  }
+  if (inAttentionWindow && result.marker === "status") {
+    log(`Codex \u2192 Claude [${result.marker}/buffer-attention] (${msg.content.length} chars)`);
+    statusBuffer.add(msg);
+    return;
+  }
+  log(`Codex \u2192 Claude [${result.marker}/${result.action}] (${msg.content.length} chars)`);
+  switch (result.action) {
+    case "forward":
+      if (result.marker === "important" && statusBuffer.size > 0) {
+        statusBuffer.flush("important message arrived");
+      }
+      emitToClaude(msg);
+      if (result.marker === "important") {
+        startAttentionWindow();
+      }
+      break;
+    case "buffer":
+      statusBuffer.add(msg);
+      break;
+    case "drop":
+      break;
+  }
+});
+codex.on("turnCompleted", () => {
+  log("Codex turn completed");
+  statusBuffer.flush("turn completed");
+  const { warnReplyMissing } = replyTracker.consumeOnTurnComplete();
+  if (warnReplyMissing) {
+    log("\u26A0\uFE0F Reply was required but Codex did not send any agentMessage");
+    emitToClaude(systemMessage("system_reply_missing", "\u26A0\uFE0F Codex completed the turn without sending a reply (require_reply was set). Codex may not have generated an agentMessage. You may want to retry or rephrase."));
   }
-  replyRequired = false;
-  replyReceivedDuringTurn = false;
   emitToClaude(systemMessage("system_turn_completed", "\u2705 Codex finished the current turn. You can reply now if needed."));
   startAttentionWindow();
-  if (attachedClaude && shouldNotifyCodexClaudeOnline()) {
-    notifyCodexClaudeOnline();
+});
+codex.on("turnAborted", (reason) => {
+  log(`Codex turn aborted (${reason}) \u2014 clearing reply-required state`);
+  const replyWasRequired = replyTracker.isArmed;
+  replyTracker.reset();
+  const notice = buildTurnAbortedNotice(reason, replyWasRequired);
+  if (notice) {
+    emitToClaude(systemMessage("system_turn_aborted", notice));
   }
 });
+codex.on("turnStalled", (event) => {
+  log(`Codex turn stalled (${event.turnId}, inactivity ${event.inactivityMs}ms)`);
+  emitToClaude(systemMessage("system_turn_stalled", `\u26A0\uFE0F Codex has been silent for ${event.inactivityMs}ms while a turn is still in progress. AgentBridge is keeping the turn busy and will not send a fake completion; wait for Codex to finish or reconnect the TUI if it is stuck.`));
+});
 codex.on("ready", (threadId) => {
   tuiConnectionState.markBridgeReady();
   log(`Codex ready \u2014 thread ${threadId}`);
   log("Bridge fully operational");
   emitToClaude(systemMessage("system_ready", currentReadyMessage()));
-  if (attachedClaude && shouldNotifyCodexClaudeOnline()) {
-    notifyCodexClaudeOnline();
-  }
+  budgetCoordinator?.resetAppliedTier();
+  ensureBudgetCoordinatorStarted();
+});
+codex.on("threadChanged", (event) => {
+  budgetCoordinator?.resetAppliedTier();
+  broadcastStatus();
+  persistCurrentThreadWithRolloutRetry({
+    stateDir,
+    pairId: process.env.AGENTBRIDGE_PAIR_ID ?? null,
+    pairName: process.env.AGENTBRIDGE_PAIR_NAME,
+    cwd: process.cwd()
+  }, event.threadId, event.reason, {
+    log,
+    shouldContinue: () => codex.activeThreadId === event.threadId
+  }).catch((err) => {
+    log(`Failed to persist current thread ${event.threadId}: ${err?.message ?? err}`);
+  });
 });
 codex.on("tuiConnected", (connId) => {
   tuiConnectionState.handleTuiConnected(connId);
@@ -1971,13 +4104,13 @@ codex.on("error", (err) => {
 codex.on("exit", (code) => {
   log(`Codex process exited (code ${code})`);
   codexBootstrapped = false;
+  replyTracker.reset();
   statusBuffer.flush("codex exited");
   tuiConnectionState.handleCodexExit();
   clearPendingClaudeDisconnect("Codex process exited");
-  claudeOnlineNoticeSent = false;
-  claudeOfflineNoticeShown = false;
-  emitToClaude(systemMessage("system_codex_exit", `\u26A0\uFE0F Codex app-server exited (code ${code ?? "unknown"}). AgentBridge daemon is still running, but the Codex side needs to be restarted.`));
+  emitToClaude(systemMessage("system_codex_exit", `\u26A0\uFE0F Codex app-server exited (code ${code ?? "unknown"}). AgentBridge daemon is still running. ` + `Restart the Codex side (\`agentbridge codex\`); if it does not come back within ` + `${Math.round(BOOTSTRAP_TIMEOUT_MS / 1000)}s the daemon will self-replace so the next launch starts clean.`));
   broadcastStatus();
+  armBootDeadline();
 });
 function startControlServer() {
   controlServer = Bun.serve({
@@ -1991,7 +4124,7 @@ function startControlServer() {
       if (url.pathname === "/readyz") {
         return Response.json(currentStatus(), { status: codexBootstrapped ? 200 : 503 });
       }
-      if (url.pathname === "/ws" && server.upgrade(req, { data: { clientId: 0, attached: false } })) {
+      if (url.pathname === "/ws" && server.upgrade(req, { data: { clientId: 0, attached: false, lastPongAt: Date.now(), pongCount: 0, pendingBackpressure: [] } })) {
         return;
       }
       return new Response("AgentBridge daemon");
@@ -2001,6 +4134,8 @@ function startControlServer() {
       sendPings: true,
       open: (ws) => {
         ws.data.clientId = ++nextControlClientId;
+        ws.data.lastPongAt = Date.now();
+        ws.data.pendingBackpressure = [];
         log(`Frontend socket opened (#${ws.data.clientId})`);
       },
       close: (ws, code, reason) => {
@@ -2011,6 +4146,18 @@ function startControlServer() {
       },
       message: (ws, raw) => {
         handleControlMessage(ws, raw);
+      },
+      pong: (ws) => {
+        ws.data.lastPongAt = Date.now();
+        ws.data.pongCount++;
+      },
+      drain: (ws) => {
+        if (ws.data.pendingBackpressure.length > 0 && ws.getBufferedAmount() === 0) {
+          ws.data.pendingBackpressure = [];
+        }
+        if (ws === attachedClaude && bufferedMessages.length > 0) {
+          flushBufferedMessages(ws);
+        }
       }
     }
   });
@@ -2026,7 +4173,20 @@ function handleControlMessage(ws, raw) {
   }
   switch (message.type) {
     case "claude_connect":
-      attachClaude(ws);
+      const admission = validateClaudeClientIdentity({
+        expectedPairId: process.env.AGENTBRIDGE_PAIR_ID ?? null,
+        daemonCwd: process.cwd(),
+        identity: message.identity,
+        allowIdentityless: ALLOW_IDENTITYLESS_CLIENT
+      });
+      if (!admission.ok) {
+        log(`Rejecting Claude frontend #${ws.data.clientId}: ${admission.reason}`);
+        ws.close(admission.closeCode, admission.reason);
+        return;
+      }
+      attachClaude(ws, message.identity).catch((err) => {
+        log(`attachClaude threw for #${ws.data.clientId}: ${err?.message ?? err}`);
+      });
       return;
     case "claude_disconnect":
       detachClaude(ws, "frontend requested disconnect");
@@ -2034,6 +4194,11 @@ function handleControlMessage(ws, raw) {
     case "status":
       sendStatus(ws);
       return;
+    case "probe_incumbent":
+      handleProbeIncumbent(ws).catch((err) => {
+        log(`handleProbeIncumbent threw for #${ws.data.clientId}: ${err?.message ?? err}`);
+      });
+      return;
     case "claude_to_codex": {
       if (message.message.source !== "claude") {
         sendProtocolMessage(ws, {
@@ -2053,20 +4218,54 @@ function handleControlMessage(ws, raw) {
         });
         return;
       }
+      if (budgetCoordinator?.isGateClosed()) {
+        const reason = budgetPauseGateError();
+        log(`Injection rejected by budget pause gate`);
+        sendProtocolMessage(ws, {
+          type: "claude_to_codex_result",
+          requestId: message.requestId,
+          success: false,
+          error: reason
+        });
+        return;
+      }
       const requireReply = !!message.requireReply;
-      let contentWithReminder = message.message.content + `
-
-` + BRIDGE_CONTRACT_REMINDER;
+      let contentToSend = message.message.content;
       if (requireReply) {
-        contentWithReminder += REPLY_REQUIRED_INSTRUCTION;
-        replyRequired = true;
-        replyReceivedDuringTurn = false;
-        log(`Reply required flag set for this message`);
+        contentToSend += REPLY_REQUIRED_INSTRUCTION;
       }
       log(`Forwarding Claude \u2192 Codex (${message.message.content.length} chars, requireReply=${requireReply})`);
-      const injected = codex.injectMessage(contentWithReminder);
+      const tierOverrides = BUDGET_CONFIG.codexTierControl ? budgetCoordinator?.getCodexTurnOverrides() ?? undefined : undefined;
+      if (codex.turnInProgress && message.onBusy === "steer") {
+        if (requireReply) {
+          sendProtocolMessage(ws, {
+            type: "claude_to_codex_result",
+            requestId: message.requestId,
+            success: false,
+            error: 'require_reply is not supported together with on_busy="steer" yet. Send the steer without require_reply, or wait for the turn to finish.'
+          });
+          return;
+        }
+        const steerContent = `[STEER from Claude]
+` + `Mid-turn update for the current Codex turn. Integrate if relevant; do not restart work unless explicitly requested.
+
+` + message.message.content;
+        const steered = codex.steerMessage(steerContent);
+        log(`Steer ${steered ? "transport-accepted" : "failed"} (${message.message.content.length} chars)`);
+        if (steered) {
+          clearAttentionWindow();
+        }
+        sendProtocolMessage(ws, {
+          type: "claude_to_codex_result",
+          requestId: message.requestId,
+          success: steered,
+          error: steered ? undefined : "Steer failed: the turn may have just ended or the connection dropped \u2014 retry as a normal reply."
+        });
+        return;
+      }
+      const injected = codex.injectMessage(contentToSend, tierOverrides);
       if (!injected) {
-        const reason = codex.turnInProgress ? "Codex is busy executing a turn. Wait for it to finish before sending another message." : "Injection failed: no active thread or WebSocket not connected.";
+        const reason = codex.turnInProgress ? 'Codex is busy executing a turn. Options: wait for it to finish, or retry with on_busy="steer" to feed this message into the running turn without interrupting it.' : "Injection failed: no active thread or WebSocket not connected.";
         log(`Injection rejected: ${reason}`);
         sendProtocolMessage(ws, {
           type: "claude_to_codex_result",
@@ -2076,6 +4275,13 @@ function handleControlMessage(ws, raw) {
         });
         return;
       }
+      if (tierOverrides) {
+        budgetCoordinator?.notifyOverridesDelivered();
+      }
+      if (requireReply) {
+        replyTracker.arm();
+        log(`Reply required flag set for this message`);
+      }
       clearAttentionWindow();
       sendProtocolMessage(ws, {
         type: "claude_to_codex_result",
@@ -2086,24 +4292,57 @@ function handleControlMessage(ws, raw) {
     }
   }
 }
-function attachClaude(ws) {
+async function attachClaude(ws, identity) {
+  const occupant = attachedClaude;
+  if (occupant && occupant !== ws && occupant.readyState !== WebSocket.CLOSED) {
+    const msSincePong = Date.now() - occupant.data.lastPongAt;
+    log(`Claude frontend contest: new=#${ws.data.clientId}, incumbent=#${occupant.data.clientId} ` + `(readyState=${occupant.readyState}, msSincePong=${msSincePong})`);
+    if (challengeInProgress) {
+      log(`Rejecting Claude frontend #${ws.data.clientId} \u2014 another liveness probe already in flight`);
+      ws.close(CLOSE_CODE_PROBE_IN_PROGRESS, "liveness probe in progress, retry shortly");
+      return;
+    }
+    challengeInProgress = true;
+    let incumbentAlive = false;
+    try {
+      incumbentAlive = await probeLiveness2(occupant, LIVENESS_PROBE_TIMEOUT_MS);
+    } finally {
+      challengeInProgress = false;
+    }
+    if (ws.readyState === WebSocket.CLOSED || ws.readyState === WebSocket.CLOSING) {
+      log(`Contestant #${ws.data.clientId} disappeared during probe \u2014 aborting`);
+      if (!incumbentAlive) {
+        evictStale(occupant, "contestant gone but probe still failed");
+      }
+      return;
+    }
+    if (incumbentAlive) {
+      log(`Rejecting Claude frontend #${ws.data.clientId} \u2014 incumbent #${occupant.data.clientId} responded to liveness probe`);
+      ws.close(CLOSE_CODE_REPLACED, "another Claude session is already connected");
+      return;
+    }
+    evictStale(occupant, `liveness probe timed out after ${LIVENESS_PROBE_TIMEOUT_MS}ms`);
+  }
   if (attachedClaude && attachedClaude !== ws && attachedClaude.readyState !== WebSocket.CLOSED) {
-    log(`Rejecting Claude frontend #${ws.data.clientId} \u2014 another session (#${attachedClaude.data.clientId}) is already attached (readyState=${attachedClaude.readyState})`);
+    log(`Rejecting Claude frontend #${ws.data.clientId} \u2014 slot re-acquired by #${attachedClaude.data.clientId} after probe`);
     ws.close(CLOSE_CODE_REPLACED, "another Claude session is already connected");
     return;
   }
   clearPendingClaudeDisconnect("Claude frontend attached");
+  ws.data.identity = identity;
   attachedClaude = ws;
   ws.data.attached = true;
   cancelIdleShutdown();
-  log(`Claude frontend attached (#${ws.data.clientId})`);
+  log(`Claude frontend attached (#${ws.data.clientId}, pair=${identity?.pairId ?? "<none>"}, cwd=${identity?.cwd ?? "<unknown>"})`);
+  const hadBacklog = bufferedMessages.length > 0;
+  if (hadBacklog) {
+    flushBufferedMessages(ws);
+  }
   statusBuffer.flush("claude reconnected");
   sendStatus(ws);
   const now = Date.now();
   const isRapidReattach = now - lastAttachStatusSentTs < ATTACH_STATUS_COOLDOWN_MS;
-  if (bufferedMessages.length > 0) {
-    flushBufferedMessages(ws);
-  } else if (!isRapidReattach) {
+  if (!hadBacklog && !isRapidReattach) {
     if (tuiConnectionState.canReply()) {
       sendBridgeMessage(ws, systemMessage("system_ready", currentReadyMessage()));
     } else if (codexBootstrapped) {
@@ -2111,9 +4350,6 @@ function attachClaude(ws) {
     }
   }
   lastAttachStatusSentTs = now;
-  if (tuiConnectionState.canReply() && shouldNotifyCodexClaudeOnline()) {
-    notifyCodexClaudeOnline();
-  }
 }
 function detachClaude(ws, reason) {
   if (attachedClaude !== ws)
@@ -2121,19 +4357,75 @@ function detachClaude(ws, reason) {
   attachedClaude = null;
   ws.data.attached = false;
   log(`Claude frontend detached (#${ws.data.clientId}, ${reason})`);
+  if (ws.data.pendingBackpressure.length > 0) {
+    bufferedMessages.unshift(...ws.data.pendingBackpressure);
+    log(`Re-buffered ${ws.data.pendingBackpressure.length} backpressured message(s) for redelivery on reconnect`);
+    ws.data.pendingBackpressure = [];
+    if (bufferedMessages.length > MAX_BUFFERED_MESSAGES) {
+      const dropped = bufferedMessages.length - MAX_BUFFERED_MESSAGES;
+      bufferedMessages.splice(0, dropped);
+      log(`Message buffer overflow: dropped ${dropped} oldest message(s), ${MAX_BUFFERED_MESSAGES} remaining`);
+    }
+  }
   scheduleClaudeDisconnectNotification(ws.data.clientId);
   scheduleIdleShutdown();
 }
+async function handleProbeIncumbent(ws) {
+  const occupant = attachedClaude;
+  log(`probe_incumbent from #${ws.data.clientId}: occupant=${occupant ? "#" + occupant.data.clientId : "none"} readyState=${occupant?.readyState}`);
+  if (!occupant || occupant === ws || occupant.readyState !== WebSocket.OPEN) {
+    sendProtocolMessage(ws, { type: "incumbent_status", connected: false, alive: false });
+    return;
+  }
+  if (challengeInProgress) {
+    sendProtocolMessage(ws, { type: "incumbent_status", connected: true, alive: true });
+    return;
+  }
+  const alive = await probeLiveness2(occupant, LIVENESS_PROBE_TIMEOUT_MS);
+  const stillConnected = attachedClaude === occupant && occupant.readyState === WebSocket.OPEN;
+  log(`probe_incumbent reply to #${ws.data.clientId}: connected=${stillConnected} alive=${stillConnected && alive}`);
+  sendProtocolMessage(ws, {
+    type: "incumbent_status",
+    connected: stillConnected,
+    alive: stillConnected && alive
+  });
+}
+async function probeLiveness2(ws, timeoutMs) {
+  return probeLiveness({
+    get readyState() {
+      return ws.readyState;
+    },
+    get pongCount() {
+      return ws.data.pongCount;
+    },
+    ping: () => {
+      ws.ping();
+    }
+  }, { timeoutMs, pollMs: LIVENESS_PROBE_POLL_MS });
+}
+function evictStale(ws, reason) {
+  log(`Evicting stale Claude frontend #${ws.data.clientId}: ${reason}`);
+  if (attachedClaude === ws) {
+    detachClaude(ws, `evicted: ${reason}`);
+  }
+  try {
+    ws.close(CLOSE_CODE_EVICTED_STALE, "stale frontend evicted by newer session");
+  } catch (err) {
+    log(`Evict close threw on #${ws.data.clientId}: ${err.message}`);
+  }
+}
 function startAttentionWindow() {
   clearAttentionWindow();
   inAttentionWindow = true;
   statusBuffer.pause();
   log(`Attention window started (${ATTENTION_WINDOW_MS}ms)`);
+  tryWriteStatusFile("attentionWindowStarted");
   attentionWindowTimer = setTimeout(() => {
     attentionWindowTimer = null;
     inAttentionWindow = false;
     statusBuffer.resume();
     log("Attention window ended");
+    tryWriteStatusFile("attentionWindowEnded");
   }, ATTENTION_WINDOW_MS);
 }
 function clearAttentionWindow() {
@@ -2143,8 +4435,9 @@ function clearAttentionWindow() {
   }
   if (inAttentionWindow) {
     statusBuffer.resume();
+    inAttentionWindow = false;
+    tryWriteStatusFile("attentionWindowCleared");
   }
-  inAttentionWindow = false;
 }
 function scheduleIdleShutdown() {
   cancelIdleShutdown();
@@ -2185,17 +4478,6 @@ function scheduleClaudeDisconnectNotification(clientId) {
       log(`Skipping Claude disconnect notification for client #${clientId} because Claude already reconnected`);
       return;
     }
-    if (!tuiConnectionState.canReply()) {
-      log(`Suppressing Claude disconnect notification for client #${clientId} because Codex cannot reply`);
-      return;
-    }
-    if (!claudeOnlineNoticeSent) {
-      log(`Suppressing Claude disconnect notification for client #${clientId} because Claude was never announced online`);
-      return;
-    }
-    codex.injectMessage("\u26A0\uFE0F Claude Code went offline. AgentBridge is still running in the background; it will reconnect automatically when Claude reopens.");
-    claudeOnlineNoticeSent = false;
-    claudeOfflineNoticeShown = true;
     log(`Claude disconnect persisted past grace window (client #${clientId})`);
   }, CLAUDE_DISCONNECT_GRACE_MS);
 }
@@ -2215,10 +4497,18 @@ function emitToClaude(message) {
 function trySendBridgeMessage(ws, message) {
   try {
     const result = ws.send(JSON.stringify({ type: "codex_to_claude", message }));
-    if (typeof result === "number" && result <= 0) {
-      log(`Bridge message send returned ${result} (0=dropped, -1=backpressure)`);
+    if (typeof result === "number" && result === 0) {
+      log("Bridge message send returned 0 (dropped)");
       return false;
     }
+    if (typeof result === "number" && result === -1) {
+      ws.data.pendingBackpressure.push(message);
+      if (ws.data.pendingBackpressure.length > MAX_BUFFERED_MESSAGES) {
+        const dropped = ws.data.pendingBackpressure.length - MAX_BUFFERED_MESSAGES;
+        ws.data.pendingBackpressure.splice(0, dropped);
+        log(`Backpressure overflow: dropped ${dropped} oldest tracked message(s), ${MAX_BUFFERED_MESSAGES} remaining`);
+      }
+    }
     return true;
   } catch (err) {
     log(`Failed to send bridge message: ${err.message}`);
@@ -2227,10 +4517,9 @@ function trySendBridgeMessage(ws, message) {
 }
 function flushBufferedMessages(ws) {
   const messages = bufferedMessages.splice(0, bufferedMessages.length);
-  for (const message of messages) {
-    if (!trySendBridgeMessage(ws, message)) {
-      const failedIndex = messages.indexOf(message);
-      const remaining = messages.slice(failedIndex);
+  for (let i = 0;i < messages.length; i++) {
+    if (!trySendBridgeMessage(ws, messages[i])) {
+      const remaining = messages.slice(i);
       bufferedMessages.unshift(...remaining);
       log(`Flush interrupted: re-buffered ${remaining.length} message(s) after send failure`);
       return;
@@ -2250,7 +4539,10 @@ function broadcastStatus() {
 }
 function sendProtocolMessage(ws, message) {
   try {
-    ws.send(JSON.stringify(message));
+    const result = ws.send(JSON.stringify(message));
+    if (typeof result === "number" && result === 0) {
+      log(`Control message dropped (socket closed): type=${message.type}`);
+    }
   } catch (err) {
     log(`Failed to send control message: ${err.message}`);
   }
@@ -2261,41 +4553,36 @@ function currentStatus() {
     bridgeReady: tuiConnectionState.canReply(),
     tuiConnected: snapshot.tuiConnected,
     threadId: codex.activeThreadId,
-    queuedMessageCount: bufferedMessages.length + statusBuffer.size,
+    queuedMessageCount: bufferedMessages.length + statusBuffer.size + (attachedClaude?.data.pendingBackpressure.length ?? 0),
     proxyUrl: codex.proxyUrl,
     appServerUrl: codex.appServerUrl,
-    pid: process.pid
+    pid: process.pid,
+    pairId: process.env.AGENTBRIDGE_PAIR_ID ?? null,
+    cwd: process.cwd(),
+    stateDir: stateDir.dir,
+    build: daemonStatusBuildInfo(),
+    budget: budgetCoordinator?.getSnapshot() ?? undefined,
+    turnInProgress: codex.turnInProgress,
+    turnPhase: codex.turnPhase,
+    attentionWindowActive: inAttentionWindow
   };
 }
 function currentWaitingMessage() {
-  return `\u23F3 Waiting for Codex TUI to connect. Run in another terminal:
-${attachCmd}`;
+  const pairId = process.env.AGENTBRIDGE_PAIR_ID ?? null;
+  const offset = CODEX_PROXY_PORT - PAIR_BASE_PORT - 1;
+  const slot = pairId !== null && offset >= 0 && offset % PAIR_SLOT_STRIDE === 0 ? offset / PAIR_SLOT_STRIDE : null;
+  return formatWaitingForCodexTuiMessage({
+    attachCmd,
+    cwd: process.cwd(),
+    pairId,
+    pairName: process.env.AGENTBRIDGE_PAIR_NAME ?? null,
+    slot,
+    proxyUrl: codex.proxyUrl
+  });
 }
 function currentReadyMessage() {
   return `\u2705 Codex TUI connected (${codex.activeThreadId}). Bridge ready.`;
 }
-function notifyCodexClaudeOnline() {
-  const message = !codexCollaborationKickoffSent ? [
-    "\uD83E\uDD1D Claude Code has connected via AgentBridge.",
-    "You are now in a multi-agent collaboration session.",
-    "When you receive a complex task, propose a division of labor to Claude.",
-    "Claude can send you messages \u2014 they will appear as injected user messages.",
-    "Respond naturally and Claude will receive your output via AgentBridge."
-  ].join(`
-`) : "\u2705 AgentBridge connected to Claude Code.";
-  const delivered = codex.injectMessage(message);
-  if (!delivered) {
-    log("Deferred Claude-online notice to Codex \u2014 will retry after current turn completes");
-    return false;
-  }
-  claudeOnlineNoticeSent = true;
-  claudeOfflineNoticeShown = false;
-  codexCollaborationKickoffSent = true;
-  return true;
-}
-function shouldNotifyCodexClaudeOnline() {
-  return !claudeOnlineNoticeSent || claudeOfflineNoticeShown;
-}
 function systemMessage(idPrefix, content) {
   return {
     id: `${idPrefix}_${++nextSystemMessageId}`,
@@ -2315,34 +4602,82 @@ function writeStatusFile() {
     proxyUrl: codex.proxyUrl,
     appServerUrl: codex.appServerUrl,
     controlPort: CONTROL_PORT,
-    pid: process.pid
+    pid: process.pid,
+    pairId: process.env.AGENTBRIDGE_PAIR_ID ?? null,
+    cwd: process.cwd(),
+    stateDir: stateDir.dir,
+    build: daemonStatusBuildInfo(),
+    turnInProgress: codex.turnInProgress,
+    turnPhase: codex.turnPhase,
+    attentionWindowActive: inAttentionWindow
   });
 }
 function removeStatusFile() {
   daemonLifecycle.removeStatusFile();
 }
+function armBootDeadline() {
+  if (bootDeadlineTimer)
+    return;
+  bootDeadlineTimer = setTimeout(() => {
+    bootDeadlineTimer = null;
+    if (codexBootstrapped)
+      return;
+    if (tuiConnectionState.snapshot().tuiConnected)
+      return;
+    log(`Codex not ready within bootstrap deadline (${BOOTSTRAP_TIMEOUT_MS}ms) \u2014 self-exiting to release control port`);
+    if (attachedClaude) {
+      emitToClaude(systemMessage("system_daemon_self_replace", "\u26A0\uFE0F Codex did not become ready within the bootstrap deadline \u2014 the AgentBridge daemon is restarting itself to release a clean slot. The bridge will reconnect automatically."));
+    }
+    shutdown("codex not ready within bootstrap deadline", 1);
+  }, BOOTSTRAP_TIMEOUT_MS);
+  bootDeadlineTimer.unref?.();
+}
+function clearBootDeadline() {
+  if (bootDeadlineTimer) {
+    clearTimeout(bootDeadlineTimer);
+    bootDeadlineTimer = null;
+  }
+}
 async function bootCodex() {
   log("Starting AgentBridge daemon...");
   log(`Codex app-server: ${codex.appServerUrl}`);
   log(`Codex proxy: ${codex.proxyUrl}`);
   log(`Control server: ws://127.0.0.1:${CONTROL_PORT}/ws`);
-  try {
-    await codex.start();
-    codexBootstrapped = true;
-    writeStatusFile();
-    emitToClaude(systemMessage("system_waiting", currentWaitingMessage()));
-    broadcastStatus();
-  } catch (err) {
-    log(`Failed to start Codex: ${err.message}`);
-    emitToClaude(systemMessage("system_codex_start_failed", `\u274C AgentBridge failed to start Codex app-server: ${err.message}`));
-    broadcastStatus();
+  for (let attempt = 0;attempt <= CODEX_BOOT_RETRIES; attempt++) {
+    try {
+      await codex.start();
+      codexBootstrapped = true;
+      clearBootDeadline();
+      writeStatusFile();
+      emitToClaude(systemMessage("system_waiting", currentWaitingMessage()));
+      broadcastStatus();
+      scheduleIdleShutdown();
+      return;
+    } catch (err) {
+      const attemptsLeft = CODEX_BOOT_RETRIES - attempt;
+      log(`Failed to start Codex (attempt ${attempt + 1}/${CODEX_BOOT_RETRIES + 1}): ${err.message}`);
+      if (attemptsLeft > 0) {
+        const backoffMs = 1000 * (attempt + 1);
+        log(`Retrying Codex bootstrap in ${backoffMs}ms (${attemptsLeft} attempt(s) left)...`);
+        await new Promise((r) => setTimeout(r, backoffMs));
+        if (shuttingDown)
+          return;
+        continue;
+      }
+      emitToClaude(systemMessage("system_codex_start_failed", `\u274C AgentBridge failed to start Codex app-server after ${CODEX_BOOT_RETRIES + 1} attempts: ${err.message}`));
+      broadcastStatus();
+      shutdown("codex bootstrap failed", 1);
+      return;
+    }
   }
 }
-function shutdown(reason) {
+function shutdown(reason, exitCode = 0) {
   if (shuttingDown)
     return;
   shuttingDown = true;
   log(`Shutting down daemon (${reason})...`);
+  clearBootDeadline();
+  stopBudgetCoordinator();
   tuiConnectionState.dispose(`daemon shutdown (${reason})`);
   clearPendingClaudeDisconnect(`daemon shutdown (${reason})`);
   controlServer?.stop();
@@ -2350,27 +4685,23 @@ function shutdown(reason) {
   codex.stop();
   removePidFile();
   removeStatusFile();
-  process.exit(0);
+  process.exit(exitCode);
 }
 process.on("SIGINT", () => shutdown("SIGINT"));
 process.on("SIGTERM", () => shutdown("SIGTERM"));
 process.on("exit", () => {
+  codex.forceKillAppServerSync();
   removePidFile();
   removeStatusFile();
 });
 process.on("uncaughtException", (err) => {
-  log(`UNCAUGHT EXCEPTION: ${err.stack ?? err.message}`);
+  processLogger.fatal("UNCAUGHT EXCEPTION", err);
 });
 process.on("unhandledRejection", (reason) => {
-  log(`UNHANDLED REJECTION: ${reason?.stack ?? reason}`);
+  processLogger.fatal("UNHANDLED REJECTION", reason);
 });
 function log(msg) {
-  const line = `[${new Date().toISOString()}] [AgentBridgeDaemon] ${msg}
-`;
-  process.stderr.write(line);
-  try {
-    appendFileSync2(stateDir.logFile, line);
-  } catch {}
+  processLogger.log(msg);
 }
 if (daemonLifecycle.wasKilled()) {
   log("Killed sentinel found \u2014 daemon was intentionally stopped. Exiting immediately.");
@@ -2378,4 +4709,5 @@ if (daemonLifecycle.wasKilled()) {
 }
 writePidFile();
 startControlServer();
+armBootDeadline();
 bootCodex();