@raysonmeng/agentbridge 0.1.18 → 0.1.19

package/dist/daemon.js

@@ -29,11 +29,11 @@ function defineNumber(value, fallback) {
   return typeof value === "number" && Number.isFinite(value) ? value : fallback;
 }
 var BUILD_INFO = Object.freeze({
-  version: defineString("0.1.18", "0.0.0-source"),
-  commit: defineString("9db0aa3", "source"),
+  version: defineString("0.1.19", "0.0.0-source"),
+  commit: defineString("dee06ce", "source"),
   bundle: defineBundle("dist"),
   contractVersion: defineNumber(1, CONTRACT_VERSION),
-  codeHash: defineString("46a6407023f0", "source")
+  codeHash: defineString("9ddee00c61f9", "source")
 });
 function daemonStatusBuildInfo() {
   return { ...BUILD_INFO };
@@ -290,6 +290,9 @@ class StateDirResolver {
   get killedFile() {
     return join(this.stateDir, "killed");
   }
+  get admissionQuotaFile() {
+    return join(this.stateDir, "admission-quota.json");
+  }
   get updateCheckFile() {
     return join(this.stateDir, "update-check.json");
   }
@@ -1014,6 +1017,9 @@ class CodexAdapter extends EventEmitter {
   get activeThreadId() {
     return this.threadId;
   }
+  canInject() {
+    return !!this.threadId && this.appServerWs?.readyState === WebSocket.OPEN && !this.turnInProgress;
+  }
   get capturedAppServerInfo() {
     return this.appServerInfo;
   }
@@ -3386,6 +3392,86 @@ async function fetchWithTimeout(url, timeoutMs = HEALTH_FETCH_TIMEOUT_MS) {
   }
 }
 
+// src/budget/admission-quota.ts
+function nodeFs() {
+  return __require("fs");
+}
+function freshState(fiveHourResetEpoch) {
+  return { version: 1, fiveHourResetEpoch, wrapUpUsed: 0, checkpointBatonUsed: false };
+}
+function parseAdmissionQuota(value) {
+  if (typeof value !== "object" || value === null || Array.isArray(value))
+    return null;
+  const record = value;
+  if (record.version !== 1)
+    return null;
+  const epoch = record.fiveHourResetEpoch;
+  const used = record.wrapUpUsed;
+  if (typeof epoch !== "number" || !Number.isFinite(epoch))
+    return null;
+  if (typeof used !== "number" || !Number.isFinite(used) || used < 0)
+    return null;
+  return {
+    version: 1,
+    fiveHourResetEpoch: epoch,
+    wrapUpUsed: Math.floor(used),
+    checkpointBatonUsed: record.checkpointBatonUsed === true
+  };
+}
+function currentWindowState(path, fiveHourResetEpoch, log = () => {}) {
+  let raw;
+  try {
+    raw = nodeFs().readFileSync(path, "utf-8");
+  } catch {
+    return freshState(fiveHourResetEpoch);
+  }
+  const text = String(raw).trim();
+  if (text === "")
+    return freshState(fiveHourResetEpoch);
+  let parsed;
+  try {
+    parsed = JSON.parse(text);
+  } catch {
+    log(`admission-quota: skip malformed JSON ${path}`);
+    return freshState(fiveHourResetEpoch);
+  }
+  const state = parseAdmissionQuota(parsed);
+  if (!state || state.fiveHourResetEpoch !== fiveHourResetEpoch) {
+    return freshState(fiveHourResetEpoch);
+  }
+  return state;
+}
+function persist(path, state, log) {
+  try {
+    atomicWriteJson(path, state);
+    return true;
+  } catch (error) {
+    log(`admission-quota: write failed ${path}: ${error instanceof Error ? error.message : String(error)}`);
+    return false;
+  }
+}
+function consumeWrapUp(path, fiveHourResetEpoch, limit, log = () => {}) {
+  if (!Number.isFinite(fiveHourResetEpoch))
+    return { allowed: false, used: 0, remaining: 0 };
+  const state = currentWindowState(path, fiveHourResetEpoch, log);
+  if (state.wrapUpUsed >= limit) {
+    return { allowed: false, used: state.wrapUpUsed, remaining: Math.max(0, limit - state.wrapUpUsed) };
+  }
+  const next = { ...state, wrapUpUsed: state.wrapUpUsed + 1 };
+  if (!persist(path, next, log)) {
+    return { allowed: false, used: state.wrapUpUsed, remaining: Math.max(0, limit - state.wrapUpUsed) };
+  }
+  return { allowed: true, used: next.wrapUpUsed, remaining: Math.max(0, limit - next.wrapUpUsed) };
+}
+function consumeCheckpointBaton(path, fiveHourResetEpoch, log = () => {}) {
+  if (!Number.isFinite(fiveHourResetEpoch))
+    return false;
+  const state = currentWindowState(path, fiveHourResetEpoch, log);
+  if (state.checkpointBatonUsed)
+    return false;
+  return persist(path, { ...state, checkpointBatonUsed: true }, log);
+}
+
 // src/config-service.ts
 import { readFileSync as readFileSync4, mkdirSync as mkdirSync4, existsSync as existsSync4 } from "fs";
 import { join as join4 } from "path";
@@ -3410,7 +3496,9 @@ var DEFAULT_BUDGET_CONFIG = {
     reserveSlopePctPerHour: 0.4,
     reserveMaxPct: 7,
     finishingHorizonMinutes: 30,
-    resumeHysteresisPct: 5
+    resumeHysteresisPct: 5,
+    admissionAt: 85,
+    wrapUpQuota: 2
   },
   allocation: {
     minRunwayRatio: 50,
@@ -3478,7 +3566,9 @@ function findShapeViolation(raw) {
         "reserveSlopePctPerHour",
         "reserveMaxPct",
         "finishingHorizonMinutes",
-        "resumeHysteresisPct"
+        "resumeHysteresisPct",
+        "admissionAt",
+        "wrapUpQuota"
       ]) {
         if (key in maximize && !isCoercibleNumber(maximize[key])) {
           return `budget.maximize.${key} is present but not a number`;
@@ -3503,7 +3593,7 @@ function hasCustomDecisionValues(config) {
   const d = DEFAULT_CONFIG;
   const b = config.budget;
   const db = d.budget;
-  return config.idleShutdownSeconds !== d.idleShutdownSeconds || config.turnCoordination.attentionWindowSeconds !== d.turnCoordination.attentionWindowSeconds || config.codex.appPort !== d.codex.appPort || config.codex.proxyPort !== d.codex.proxyPort || b.enabled !== db.enabled || b.pollSeconds !== db.pollSeconds || b.pauseAt !== db.pauseAt || b.resumeBelow !== db.resumeBelow || b.syncDriftPct !== db.syncDriftPct || b.parallel.minRemainingPct !== db.parallel.minRemainingPct || b.parallel.timeWindowSec !== db.parallel.timeWindowSec || b.codexTierControl !== db.codexTierControl || b.maximize.targetUtil !== db.maximize.targetUtil || b.maximize.reserveSlopePctPerHour !== db.maximize.reserveSlopePctPerHour || b.maximize.reserveMaxPct !== db.maximize.reserveMaxPct || b.maximize.finishingHorizonMinutes !== db.maximize.finishingHorizonMinutes || b.maximize.resumeHysteresisPct !== db.maximize.resumeHysteresisPct || b.allocation.minRunwayRatio !== db.allocation.minRunwayRatio || b.allocation.minRunwayGapHours !== db.allocation.minRunwayGapHours;
+  return config.idleShutdownSeconds !== d.idleShutdownSeconds || config.turnCoordination.attentionWindowSeconds !== d.turnCoordination.attentionWindowSeconds || config.codex.appPort !== d.codex.appPort || config.codex.proxyPort !== d.codex.proxyPort || b.enabled !== db.enabled || b.pollSeconds !== db.pollSeconds || b.pauseAt !== db.pauseAt || b.resumeBelow !== db.resumeBelow || b.syncDriftPct !== db.syncDriftPct || b.parallel.minRemainingPct !== db.parallel.minRemainingPct || b.parallel.timeWindowSec !== db.parallel.timeWindowSec || b.codexTierControl !== db.codexTierControl || b.maximize.targetUtil !== db.maximize.targetUtil || b.maximize.reserveSlopePctPerHour !== db.maximize.reserveSlopePctPerHour || b.maximize.reserveMaxPct !== db.maximize.reserveMaxPct || b.maximize.finishingHorizonMinutes !== db.maximize.finishingHorizonMinutes || b.maximize.resumeHysteresisPct !== db.maximize.resumeHysteresisPct || b.maximize.admissionAt !== db.maximize.admissionAt || b.maximize.wrapUpQuota !== db.maximize.wrapUpQuota || b.allocation.minRunwayRatio !== db.allocation.minRunwayRatio || b.allocation.minRunwayGapHours !== db.allocation.minRunwayGapHours;
 }
 function normalizeInteger(value, fallback) {
   if (typeof value === "number" && Number.isFinite(value))
@@ -3543,9 +3633,11 @@ function normalizeMaximizeConfig(raw, pauseAt, fallback = DEFAULT_BUDGET_CONFIG.
     reserveSlopePctPerHour: normalizeBoundedNumber(m.reserveSlopePctPerHour, fallback.reserveSlopePctPerHour, 0, 5),
     reserveMaxPct: normalizeBoundedInteger(m.reserveMaxPct, fallback.reserveMaxPct, 0, 30),
     finishingHorizonMinutes: normalizeBoundedInteger(m.finishingHorizonMinutes, fallback.finishingHorizonMinutes, 5, 180),
-    resumeHysteresisPct: normalizeBoundedInteger(m.resumeHysteresisPct, fallback.resumeHysteresisPct, 1, 30)
+    resumeHysteresisPct: normalizeBoundedInteger(m.resumeHysteresisPct, fallback.resumeHysteresisPct, 1, 30),
+    admissionAt: normalizeBoundedInteger(m.admissionAt, fallback.admissionAt, 50, 99),
+    wrapUpQuota: Math.floor(normalizeBoundedInteger(m.wrapUpQuota, fallback.wrapUpQuota, 0, 10))
   };
-  if (normalized.targetUtil <= pauseAt) {
+  if (normalized.targetUtil <= pauseAt || normalized.admissionAt >= normalized.targetUtil) {
     return { ...DEFAULT_BUDGET_CONFIG.maximize };
   }
   return normalized;
@@ -3628,7 +3720,9 @@ function applyBudgetEnvOverrides(budget, env = process.env) {
       reserveSlopePctPerHour: env.AGENTBRIDGE_BUDGET_RESERVE_SLOPE_PCT_PER_HOUR ?? budget.maximize.reserveSlopePctPerHour,
       reserveMaxPct: env.AGENTBRIDGE_BUDGET_RESERVE_MAX_PCT ?? budget.maximize.reserveMaxPct,
       finishingHorizonMinutes: env.AGENTBRIDGE_BUDGET_FINISHING_HORIZON_MINUTES ?? budget.maximize.finishingHorizonMinutes,
-      resumeHysteresisPct: env.AGENTBRIDGE_BUDGET_RESUME_HYSTERESIS_PCT ?? budget.maximize.resumeHysteresisPct
+      resumeHysteresisPct: env.AGENTBRIDGE_BUDGET_RESUME_HYSTERESIS_PCT ?? budget.maximize.resumeHysteresisPct,
+      admissionAt: env.AGENTBRIDGE_BUDGET_ADMISSION_AT ?? budget.maximize.admissionAt,
+      wrapUpQuota: env.AGENTBRIDGE_BUDGET_WRAP_UP_QUOTA ?? budget.maximize.wrapUpQuota
     },
     allocation: {
       minRunwayRatio: env.AGENTBRIDGE_BUDGET_MIN_RUNWAY_RATIO ?? budget.allocation.minRunwayRatio,
@@ -3967,6 +4061,79 @@ function resumeBlockingEpochFor(usage, cfg, now) {
     return 0;
   return Math.min(...blockingResets);
 }
+var ADMISSION_WEEKLY_RUNWAY_ENTER_MULT = 2;
+var ADMISSION_WEEKLY_RUNWAY_EXIT_MULT = 3;
+function weeklyRunwayFloorSec(cfg, mult) {
+  return cfg.maximize.finishingHorizonMinutes * 60 * mult;
+}
+function weeklyRunwayShort(usage, cfg, now, floorSec) {
+  const weekly = usage.weekly;
+  if (!weekly || weekly.resetEpoch <= now)
+    return false;
+  if (dynamicWindowVerdict(weekly, cfg, now).kind !== "will-fill")
+    return false;
+  const runway = weekly.runwaySeconds;
+  if (typeof runway !== "number" || !Number.isFinite(runway))
+    return false;
+  return runway < floorSec;
+}
+function hardCapWindow(usage, cfg, now) {
+  for (const { key, window } of freshWindows(usage, now)) {
+    const rate = confidentRate(window);
+    if (rate === null)
+      continue;
+    if (dynamicPauseAt(window, rate, cfg, now) === "admission-closed")
+      return key;
+  }
+  return null;
+}
+var NO_ADMIT_CLOSE = { admitClose: false, window: null, reason: "" };
+function agentShouldAdmitClose(agent, usage, cfg, now) {
+  if (!usage)
+    return NO_ADMIT_CLOSE;
+  if (!isDecisionGrade(usage, now))
+    return NO_ADMIT_CLOSE;
+  const fiveHour = usage.fiveHour;
+  if (fiveHour && fiveHour.resetEpoch > now && fiveHour.util >= cfg.maximize.admissionAt) {
+    return {
+      admitClose: true,
+      window: "fiveHour",
+      reason: `${AGENT_LABEL[agent]} 5h\u7A97\u53E3 util ${pct(fiveHour.util)} \u2265 admissionAt ${pct(cfg.maximize.admissionAt)}\uFF08\u6536\u5C3E\u4FDD\u62A4\uFF1A\u62D2\u65B0\u4EFB\u52A1\u3001\u653E\u6536\u5C3E\uFF09`
+    };
+  }
+  const hard = hardCapWindow(usage, cfg, now);
+  if (hard !== null) {
+    return {
+      admitClose: true,
+      window: hard,
+      reason: `${AGENT_LABEL[agent]} ${WINDOW_LABEL[hard]}\u7A97\u53E3\u89E6\u53D1\u6536\u5C3E\u4FDD\u62A4\u786C\u7EBF\uFF08util \u5DF2\u8FBE targetUtil \u6216\u4E34\u8FD1\u91CD\u7F6E\u6536\u5C3E\u5E26\uFF09`
+    };
+  }
+  if (weeklyRunwayShort(usage, cfg, now, weeklyRunwayFloorSec(cfg, ADMISSION_WEEKLY_RUNWAY_ENTER_MULT))) {
+    return {
+      admitClose: true,
+      window: "weekly",
+      reason: `${AGENT_LABEL[agent]} \u5468\u7A97\u53E3 runway \u4F4E\u4E8E ${ADMISSION_WEEKLY_RUNWAY_ENTER_MULT}\xD7\u6536\u5C3E\u89C6\u91CE\uFF08\u9632\u65B0\u957F\u4EFB\u52A1\u649E\u7A7F\u5468\u989D\u5EA6\uFF09`
+    };
+  }
+  return NO_ADMIT_CLOSE;
+}
+function agentCanAdmitOpen(usage, cfg, now) {
+  if (!isDecisionGrade(usage, now))
+    return false;
+  if (usage.rateLimitedUntil > now)
+    return false;
+  const fiveHour = usage.fiveHour;
+  if (fiveHour && fiveHour.resetEpoch > now) {
+    if (fiveHour.util >= cfg.maximize.admissionAt - cfg.maximize.resumeHysteresisPct)
+      return false;
+  }
+  if (hardCapWindow(usage, cfg, now) !== null)
+    return false;
+  if (weeklyRunwayShort(usage, cfg, now, weeklyRunwayFloorSec(cfg, ADMISSION_WEEKLY_RUNWAY_EXIT_MULT)))
+    return false;
+  return true;
+}
 
 // src/budget/budget-state.ts
 var NO_RUNWAY = { claude: null, codex: null };
@@ -4112,6 +4279,18 @@ function renderBudgetInterventionDirective(claude, codex, side, reason, resumeEp
   ].join(`
 `);
 }
+function renderBudgetAdmissionDirective(claude, codex, side, reason, resetEpoch, cfg) {
+  const resetText = `\u5BF9\u5E94\u7A97\u53E3\u7EA6 ${formatEpoch(resetEpoch)} \u5237\u65B0\uFF08\u4EE5\u5B9E\u6D4B\u4E3A\u51C6\uFF1B\u63D0\u524D\u5237\u65B0\u4F1A\u66F4\u65E9\u89E3\u9664\uFF09`;
+  const head = side === "both" ? "\u3010\u9884\u7B97\u534F\u8C03 \xB7 \u8D26\u53F7\u7EA7\u3011\u53CC\u65B9\u8FDB\u5165\u6536\u5C3E\u4FDD\u62A4\uFF08admission-closed\uFF09\u3002" : "\u3010\u9884\u7B97\u534F\u8C03 \xB7 \u8D26\u53F7\u7EA7\u3011Codex \u4FA7\u8FDB\u5165\u6536\u5C3E\u4FDD\u62A4\uFF08admission-closed\uFF09\u3002";
+  return [
+    head,
+    `\u89E6\u53D1\u539F\u56E0\uFF1A${reason}\u3002`,
+    `${usageSummary("claude", claude)}\uFF1B${usageSummary("codex", codex)}\u3002`,
+    `\u95F8\u95E8\u5DF2\u6536\u7D27\uFF1A\u65B0\u7684 Codex \u4EFB\u52A1\u4F1A\u88AB\u62D2\uFF08budget_admission\uFF09\uFF0C\u4F46\u4ECD\u53EF\u7528 reply \u5E26 wrap_up=true \u628A\u5F53\u524D\u534F\u4F5C\u6536\u5C3E\u5230 checkpoint` + `\uFF08\u6BCF\u7A97\u53E3\u81F3\u591A ${cfg.maximize.wrapUpQuota} \u4E2A\uFF09\uFF0Csteer \u4FEE\u6B63\u4E0D\u53D7\u9650\uFF1B${resetText}\u3002`,
+    "\u5EFA\u8BAE\uFF1A\u4E0D\u8981\u518D\u5411 Codex \u6D3E\u65B0\u4EFB\u52A1\uFF1B\u628A\u5F53\u524D Codex \u534F\u4F5C\u6536\u5C3E\u3001\u5199 checkpoint\uFF0C\u53EF\u72EC\u7ACB\u63A8\u8FDB\u7684\u90E8\u5206 Claude \u53EF solo \u7EE7\u7EED\u3002"
+  ].join(`
+`);
+}
 function balanceDirective(claude, codex, drift, basis, runway) {
   const heavier = drift.heavier ? AGENT_LABEL2[drift.heavier] : "\u672A\u77E5";
   const lighter = drift.lighter ? AGENT_LABEL2[drift.lighter] : "\u672A\u77E5";
@@ -4154,7 +4333,7 @@ function computeBudgetState(claude, codex, cfg, now, runway = NO_RUNWAY) {
   const paused = triggers.length > 0;
   const { drift, basis } = allocationDrift(claude, codex, runway, cfg);
   const parallel = { recommended: false, reason: null };
-  const adviceEligible = !paused && claude !== null && codex !== null && claude.rateLimitedUntil <= now && codex.rateLimitedUntil <= now && isDecisionGrade(claude, now) && isDecisionGrade(codex, now);
+  const adviceEligible = !paused && claude !== null && codex !== null && claude.rateLimitedUntil <= now && codex.rateLimitedUntil <= now && isDecisionGrade(claude, now) && isDecisionGrade(codex, now) && !agentShouldAdmitClose("claude", claude, cfg, now).admitClose && !agentShouldAdmitClose("codex", codex, cfg, now).admitClose;
   const balanceActive = adviceEligible && drift.heavier !== null && drift.lighter !== null;
   const underutilization = adviceEligible && !balanceActive ? underutilizationState(claude, codex, cfg, now) : { recommended: false, reason: null };
   const resetEpochs = {
@@ -4445,6 +4624,58 @@ function computeResumeCandidate(sides, state, cfg, signals) {
     candidate.detail = detail;
   return candidate;
 }
+var INITIAL_ADMISSION_STATE = { side: null, fingerprint: null, reason: null };
+function nextAdmissionSide(prevSide, state, cfg) {
+  const active = new Set(sideToAgents(prevSide));
+  for (const agent of ["claude", "codex"]) {
+    const usage = state.perAgent[agent];
+    if (agentShouldAdmitClose(agent, usage, cfg, state.now).admitClose) {
+      active.add(agent);
+    } else if (active.has(agent) && agentCanAdmitOpen(usage, cfg, state.now)) {
+      active.delete(agent);
+    }
+  }
+  return agentsToSide(active);
+}
+function admissionReason(side, state, cfg) {
+  return sideToAgents(side).map((agent) => {
+    const usage = state.perAgent[agent];
+    if (!usage)
+      return `${AGENT_LABEL3[agent]} \u63A2\u6D4B\u6682\u65F6\u4E0D\u53EF\u7528\uFF0C\u4FDD\u6301\u4E0A\u4E00\u8F6E\u6536\u5C3E\u4FDD\u62A4`;
+    if (usage.rateLimitedUntil > state.now) {
+      return `${AGENT_LABEL3[agent]} \u63A2\u9488\u88AB\u9650\u6D41\u81F3 ${formatEpoch2(usage.rateLimitedUntil)}\uFF0C\u4FDD\u6301\u6536\u5C3E\u4FDD\u62A4`;
+    }
+    const decision = agentShouldAdmitClose(agent, usage, cfg, state.now);
+    if (decision.admitClose)
+      return decision.reason;
+    return `${AGENT_LABEL3[agent]} \u6536\u5C3E\u4FDD\u62A4\u51FA\u95F8\u6EDE\u56DE\u5E26\uFF0C\u5C1A\u672A\u6EE1\u8DB3\u5F00\u95F8\u6761\u4EF6`;
+  }).join("\uFF1B");
+}
+function admissionFingerprint(state, side) {
+  let reset = 0;
+  for (const agent of sideToAgents(side)) {
+    reset = Math.max(reset, state.pause.resetEpochs[agent] ?? 0);
+  }
+  return ["admission", side, Math.round(reset / RESET_FINGERPRINT_BUCKET_SEC)].join("|");
+}
+function classifyAdmission(prev, state, cfg) {
+  const previousSide = prev.side;
+  const currentSide = nextAdmissionSide(previousSide, state, cfg);
+  if (currentSide) {
+    const reason = admissionReason(currentSide, state, cfg);
+    const uncertain = previousSide === currentSide && activeSideProbeUncertain(currentSide, state) && prev.fingerprint;
+    const fingerprint = uncertain ? prev.fingerprint : admissionFingerprint(state, currentSide);
+    const emit = !previousSide || previousSide !== currentSide || fingerprint !== prev.fingerprint;
+    return {
+      next: { side: currentSide, fingerprint, reason },
+      effect: { kind: uncertain ? "hold-uncertain" : "enter", side: currentSide, reason, emit }
+    };
+  }
+  if (previousSide) {
+    return { next: INITIAL_ADMISSION_STATE, effect: { kind: "exit", previousSide } };
+  }
+  return { next: INITIAL_ADMISSION_STATE, effect: { kind: "none" } };
+}
 
 // src/budget/burn-view.ts
 function windowBurnRate(window) {
@@ -4586,9 +4817,13 @@ class BudgetCoordinator {
   onResume;
   resumeSignals;
   adviceCooldown;
+  isCodexTurnActive;
   timer = null;
   running = false;
   fpState = INITIAL_FINGERPRINT_STATE;
+  admissionState = INITIAL_ADMISSION_STATE;
+  pendingAdmissionDirective = null;
+  lastEmittedAdmissionFingerprint = null;
   resumeCandidate = {};
   latestSnapshot = null;
   pendingOverrideTier = null;
@@ -4612,6 +4847,7 @@ class BudgetCoordinator {
       cooldownSec: resolveAdviceCooldownSec(),
       log: this.log
     });
+    this.isCodexTurnActive = options.isCodexTurnActive ?? (() => false);
   }
   async start() {
     if (this.running || !this.config.enabled)
@@ -4634,6 +4870,13 @@ class BudgetCoordinator {
   isGateClosed() {
     return this.fpState.side === "codex" || this.fpState.side === "both";
   }
+  gateState() {
+    if (this.fpState.side === "codex" || this.fpState.side === "both")
+      return "closed";
+    if (this.admissionState.side === "codex" || this.admissionState.side === "both")
+      return "admission-closed";
+    return "open";
+  }
   getSnapshot() {
     return this.latestSnapshot;
   }
@@ -4722,8 +4965,14 @@ class BudgetCoordinator {
   applyState(state) {
     const { next, effect } = classifyPoll(this.fpState, state, this.config);
     this.fpState = next;
+    this.admissionState = classifyAdmission(this.admissionState, state, this.config).next;
+    this.applyAdmissionDirective(state);
     this.resumeCandidate = this.resumeSignals ? computeResumeCandidate(resumeCandidateSides(effect), state, this.config, this.resumeSignals()) : {};
     for (const side of effect.recoveredSides) {
+      if (side === "codex" && (this.admissionState.side === "codex" || this.admissionState.side === "both")) {
+        this.log(`Budget recovery for Codex held: pause cleared but still admission-closed`);
+        continue;
+      }
       const { id, directive } = this.emitRecovery(side, state);
       this.onResume(side, directive, id);
     }
@@ -4742,6 +4991,10 @@ class BudgetCoordinator {
         return;
       }
       case "advise": {
+        if (this.gateState() !== "open") {
+          this.fpState = { ...this.fpState, fingerprint: null };
+          return;
+        }
         if (effect.phase === "underutilized") {
           if (!this.adviceCooldown.tryAcquire("underutilization", state.now))
             return;
@@ -4755,6 +5008,51 @@ class BudgetCoordinator {
         return;
     }
   }
+  applyAdmissionDirective(state) {
+    const side = this.admissionState.side;
+    if (side !== "codex" && side !== "both") {
+      this.pendingAdmissionDirective = null;
+      this.lastEmittedAdmissionFingerprint = null;
+      return;
+    }
+    const fingerprint = this.admissionState.fingerprint;
+    if (fingerprint === null || fingerprint === this.lastEmittedAdmissionFingerprint) {
+      this.pendingAdmissionDirective = null;
+      return;
+    }
+    if (this.isPaused()) {
+      this.pendingAdmissionDirective = null;
+      return;
+    }
+    const content = renderBudgetAdmissionDirective(state.perAgent.claude, state.perAgent.codex, side, this.admissionState.reason ?? "\u989D\u5EA6\u7A97\u53E3\u6536\u5C3E\u4FDD\u62A4", this.admissionResetEpoch(state), this.config);
+    if (this.isCodexTurnActive()) {
+      this.pendingAdmissionDirective = { content, fingerprint };
+      return;
+    }
+    this.emitAdmission(content, fingerprint);
+  }
+  emitAdmission(content, fingerprint) {
+    this.emitDirective("system_budget_admission", content);
+    this.lastEmittedAdmissionFingerprint = fingerprint;
+    this.pendingAdmissionDirective = null;
+  }
+  admissionResetEpoch(state) {
+    const usage = state.perAgent.codex;
+    const now = state.now;
+    const fiveHour = usage?.fiveHour?.resetEpoch ?? 0;
+    const weekly = usage?.weekly?.resetEpoch ?? 0;
+    const fresh = fiveHour > now ? fiveHour : weekly > now ? weekly : 0;
+    return fresh > 0 ? fresh : null;
+  }
+  onCodexTurnIdle() {
+    const pending = this.pendingAdmissionDirective;
+    if (!pending)
+      return;
+    this.pendingAdmissionDirective = null;
+    if (this.isPaused() || this.gateState() !== "admission-closed")
+      return;
+    this.emitAdmission(pending.content, pending.fingerprint);
+  }
   tierControlEnabled() {
     if (!this.config.codexTierControl)
       return false;
@@ -4836,6 +5134,7 @@ class BudgetCoordinator {
       driftPct: state.drift.pct,
       paused,
       gateClosed: this.isGateClosed(),
+      gateState: this.gateState(),
       pauseSide: this.fpState.side,
       pauseReason: paused ? this.fpState.reason ?? state.pause.reason : null,
       resumeAfterEpoch: paused ? this.fpState.resumeEpoch ?? state.pause.resumeAfterEpoch : null,
@@ -5258,14 +5557,14 @@ function createQuotaSource(options) {
 // src/budget/pending-reader.ts
 import { createHash } from "crypto";
 import { join as join7 } from "path";
-function nodeFs() {
+function nodeFs2() {
   return __require("fs");
 }
 function cwdMatches(entryCwd, optsCwd) {
   if (entryCwd === optsCwd)
     return true;
   try {
-    const fs2 = nodeFs();
+    const fs2 = nodeFs2();
     return fs2.realpathSync(entryCwd) === fs2.realpathSync(optsCwd);
   } catch {
     return false;
@@ -5303,7 +5602,7 @@ function resolveStateDir2(homeDir) {
 function readPendingFile(path, log) {
   let raw;
   try {
-    raw = nodeFs().readFileSync(path, "utf-8");
+    raw = nodeFs2().readFileSync(path, "utf-8");
   } catch (error) {
     log(`pending reader: skip unreadable ${path}: ${error instanceof Error ? error.message : String(error)}`);
     return null;
@@ -5327,7 +5626,7 @@ function listScopeFiles(stateDir, agent, log) {
   const pendingDir = join7(stateDir, "pending");
   let names;
   try {
-    names = nodeFs().readdirSync(pendingDir);
+    names = nodeFs2().readdirSync(pendingDir);
   } catch {
     return [];
   }
@@ -6451,7 +6750,10 @@ function ensureBudgetCoordinatorStarted() {
       onPauseChange: (paused) => {
         log(`Budget intervention ${paused ? "ACTIVE" : "CLEARED"} ` + `(gate ${budgetCoordinator?.isGateClosed() ? "CLOSED" : "OPEN"})`);
       },
-      onSnapshot: () => broadcastStatus(),
+      onSnapshot: () => {
+        broadcastStatus();
+        maybeFireCheckpointBaton("snapshot");
+      },
       log,
       onResume: (side, _directive, resumeId) => {
         if (side === "claude") {
@@ -6462,7 +6764,8 @@ function ensureBudgetCoordinatorStarted() {
           enqueueCodex: enqueueCodexBudgetResume
         });
       },
-      resumeSignals: readResumeSignals
+      resumeSignals: readResumeSignals,
+      isCodexTurnActive: () => codex.turnInProgress
     });
   }
   budgetCoordinator.start();
@@ -6478,6 +6781,79 @@ function budgetPauseGateError() {
   const reopenText = `Codex \u4FA7\u5404\u7A97\u53E3 util \u56DE\u843D\u81F3\u52A8\u6001\u6682\u505C\u7EBF \u2212 ${BUDGET_CONFIG.maximize.resumeHysteresisPct}% \u4EE5\u4E0B\u6216\u5BF9\u5E94\u7A97\u53E3\u5237\u65B0\u540E\u95F8\u95E8\u81EA\u52A8\u653E\u5F00`;
   return `\u9884\u7B97\u6682\u505C\uFF08\u95F8\u95E8\u5173\u95ED\uFF09\uFF0C\u5DF2\u62D2\u7EDD\u8F6C\u53D1\uFF1A${reason}\u3002` + reopenText + (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`;
 }
+function budgetAdmissionGateError(windowResetEpoch, wrapUpLeft, quotaExhausted) {
+  const resetAt = windowResetEpoch > 0 ? new Date(windowResetEpoch * 1000).toISOString().replace("T", " ").replace(/\.\d+Z$/, "Z") : "\u672A\u77E5";
+  const quota = BUDGET_CONFIG.maximize.wrapUpQuota;
+  if (quotaExhausted) {
+    return `\u989D\u5EA6\u7A97\u53E3\u6536\u5C3E\u4FDD\u62A4\u4E2D\uFF08admission-closed\uFF09\uFF1A\u672C\u7A97\u53E3 wrap-up \u914D\u989D\uFF08\u6BCF\u7A97\u53E3 ${quota} \u4E2A\uFF09\u5DF2\u7528\u5C3D\uFF0C\u5DF2\u62D2\u7EDD\u8F6C\u53D1\u3002` + `\u8BF7\u52FF\u518D\u6D3E\u65B0\u4EFB\u52A1\uFF1B\u5199 checkpoint\uFF0C\u7B49\u989D\u5EA6\u7A97\u53E3\u5237\u65B0\uFF08\u7EA6 ${resetAt}\uFF09\u540E\u518D\u7EE7\u7EED\u3002`;
+  }
+  return `\u989D\u5EA6\u7A97\u53E3\u6536\u5C3E\u4FDD\u62A4\u4E2D\uFF08admission-closed\uFF09\uFF1A\u4EC5\u63A5\u6536\u6536\u5C3E\u7C7B\u6CE8\u5165\uFF0C\u5DF2\u62D2\u7EDD\u8BE5\u65B0\u4EFB\u52A1\u3002` + `\u5982\u9700\u628A\u5F53\u524D\u534F\u4F5C\u6536\u5C3E\u5230 checkpoint\uFF0C\u53EF\u7528 reply \u5E26 wrap_up=true \u91CD\u53D1\uFF08\u672C\u7A97\u53E3\u8FD8\u5269 ${wrapUpLeft} \u4E2A\u6536\u5C3E\u914D\u989D\uFF09\uFF1Bsteer \u4FEE\u6B63\u4E0D\u53D7\u9650\u3002` + `\u65B0\u4EFB\u52A1\u8BF7\u7B49\u989D\u5EA6\u7A97\u53E3\u5237\u65B0\uFF08\u7EA6 ${resetAt}\uFF09\u540E\u518D\u6D3E\u3002`;
+}
+function evaluateInjectionBudgetGate(message, willInject, isSteer) {
+  const gateState = budgetCoordinator?.gateState() ?? "open";
+  if (gateState === "closed") {
+    log(`Injection rejected by budget pause gate`);
+    const resumeAfterEpoch3 = budgetCoordinator?.getSnapshot()?.resumeAfterEpoch ?? null;
+    const retryAfterMs = retryAfterMsForResume(resumeAfterEpoch3, Date.now());
+    return {
+      allow: false,
+      code: "budget_paused",
+      error: budgetPauseGateError(),
+      ...retryAfterMs !== undefined ? { retryAfterMs } : {}
+    };
+  }
+  if (gateState === "admission-closed" && !isSteer) {
+    const nowSec = Math.floor(Date.now() / 1000);
+    const admSnap = budgetCoordinator?.getSnapshot()?.codex;
+    const admFiveHour = admSnap?.fiveHour?.resetEpoch ?? 0;
+    const admWeekly = admSnap?.weekly?.resetEpoch ?? 0;
+    const admissionWindowReset = admFiveHour > nowSec ? admFiveHour : admWeekly > nowSec ? admWeekly : 0;
+    if (admissionWindowReset <= 0) {
+      log(`Injection rejected by admission gate: no fresh quota window (probe stale / snapshot lost)`);
+      return { allow: false, code: "budget_admission", error: budgetAdmissionGateError(0, 0, true) };
+    }
+    if (message.wrapUp === true && willInject) {
+      const peek = currentWindowState(stateDir.admissionQuotaFile, admissionWindowReset, log);
+      if (peek.wrapUpUsed >= BUDGET_CONFIG.maximize.wrapUpQuota) {
+        log(`Injection rejected by admission gate: wrap-up quota exhausted`);
+        return { allow: false, code: "budget_admission", error: budgetAdmissionGateError(admissionWindowReset, 0, true) };
+      }
+      log(`Admission-closed: wrap-up permitted (${peek.wrapUpUsed}/${BUDGET_CONFIG.maximize.wrapUpQuota} used; slot committed on inject)`);
+      return { allow: true, pendingWrapUpReset: admissionWindowReset };
+    }
+    if (message.wrapUp === true && !willInject) {
+      return { allow: true, pendingWrapUpReset: null };
+    }
+    const left = Math.max(0, BUDGET_CONFIG.maximize.wrapUpQuota - currentWindowState(stateDir.admissionQuotaFile, admissionWindowReset, log).wrapUpUsed);
+    log(`Injection rejected by admission gate: new task (set wrap_up to finish the current work)`);
+    return { allow: false, code: "budget_admission", error: budgetAdmissionGateError(admissionWindowReset, left, false) };
+  }
+  return { allow: true, pendingWrapUpReset: null };
+}
+var CHECKPOINT_BATON_PROMPT = "\u3010\u9884\u7B97\u534F\u8C03 \xB7 \u7CFB\u7EDF\u53D1\u8D77\u3011\u8D26\u53F7\u7EA7\u989D\u5EA6\u5373\u5C06\u8017\u5C3D\uFF0C\u95F8\u95E8\u5DF2\u5173\u95ED\u3002\u8FD9\u662F\u672C\u989D\u5EA6\u7A97\u53E3\u552F\u4E00\u4E00\u6B21\u7CFB\u7EDF\u63D0\u9192\uFF1A" + "\u8BF7\u7ACB\u5373\u628A\u5F53\u524D\u8FDB\u5EA6\u5199\u5165 checkpoint\uFF08.agent/checkpoint.md\uFF1A\u4EFB\u52A1 / \u5DF2\u5B8C\u6210 / \u8FDB\u884C\u4E2D\u65AD\u70B9 / \u4E0B\u4E00\u6B65 / \u5173\u952E\u51B3\u7B56\u4E0E\u7EA6\u675F\uFF09\uFF0C" + "\u7136\u540E\u505C\u624B\u7B49\u5F85\u989D\u5EA6\u7A97\u53E3\u5237\u65B0\uFF1B\u5237\u65B0\u524D\u4E0D\u8981\u518D\u5F00\u65B0\u4EFB\u52A1\u3002\u6B64\u4E3A\u7CFB\u7EDF\u63D0\u9192\uFF0C\u65E0\u9700\u56DE\u590D Claude\u3002";
+function maybeFireCheckpointBaton(trigger) {
+  if (!budgetCoordinator)
+    return;
+  if (budgetCoordinator.gateState() !== "closed")
+    return;
+  if (!codex.canInject())
+    return;
+  const nowSec = Math.floor(Date.now() / 1000);
+  const snap = budgetCoordinator.getSnapshot()?.codex;
+  const fiveHour = snap?.fiveHour?.resetEpoch ?? 0;
+  const weekly = snap?.weekly?.resetEpoch ?? 0;
+  const windowReset = fiveHour > nowSec ? fiveHour : weekly > nowSec ? weekly : 0;
+  if (windowReset <= 0)
+    return;
+  if (!consumeCheckpointBaton(stateDir.admissionQuotaFile, windowReset, log))
+    return;
+  const injectionId = codex.injectMessage(CHECKPOINT_BATON_PROMPT);
+  if (injectionId === null) {
+    log(`Checkpoint baton (${trigger}): inject failed after consume \u2014 baton lost this window (reset ${windowReset})`);
+    return;
+  }
+  log(`Checkpoint baton fired (${trigger}, window reset ${windowReset})`);
+}
 var tuiConnectionState = new TuiConnectionState({
   disconnectGraceMs: TUI_DISCONNECT_GRACE_MS,
   log,
@@ -6499,6 +6875,10 @@ function tryWriteStatusFile(reason) {
 codex.on("turnPhaseChanged", ({ phase, previous }) => {
   log(`Codex turn phase: ${previous} \u2192 ${phase}`);
   tryWriteStatusFile(`turnPhase:${phase}`);
+  if (phase === "idle" || phase === "aborted") {
+    budgetCoordinator?.onCodexTurnIdle();
+    maybeFireCheckpointBaton("turnIdle");
+  }
   broadcastStatus();
 });
 codex.on("steerFailed", ({ requestId, reason }) => {
@@ -6903,18 +7283,21 @@ async function handleClaudeToCodex(ws, message) {
     });
     return;
   }
-  if (budgetCoordinator?.isGateClosed()) {
-    const reason = budgetPauseGateError();
-    log(`Injection rejected by budget pause gate`);
-    const resumeAfterEpoch3 = budgetCoordinator?.getSnapshot()?.resumeAfterEpoch ?? null;
-    const retryAfterMs = retryAfterMsForResume(resumeAfterEpoch3, Date.now());
-    sendClaudeToCodexResult(ws, message.requestId, {
-      success: false,
-      code: "budget_paused",
-      error: reason,
-      ...retryAfterMs !== undefined ? { retryAfterMs } : {}
-    });
-    return;
+  let pendingWrapUpReset = null;
+  {
+    const isSteer = codex.turnInProgress && message.onBusy === "steer";
+    const willInject = !codex.turnInProgress || message.onBusy === "interrupt";
+    const gate = evaluateInjectionBudgetGate(message, willInject, isSteer);
+    if (!gate.allow) {
+      sendClaudeToCodexResult(ws, message.requestId, {
+        success: false,
+        code: gate.code,
+        error: gate.error,
+        ...gate.retryAfterMs !== undefined ? { retryAfterMs: gate.retryAfterMs } : {}
+      });
+      return;
+    }
+    pendingWrapUpReset = gate.pendingWrapUpReset;
   }
   const requireReply = !!message.requireReply;
   let contentToSend = message.message.content;
@@ -7003,8 +7386,36 @@ async function handleClaudeToCodex(ws, message) {
     if (interruptThreadId && codex.activeThreadId !== interruptThreadId) {
       releaseInterruptKey();
     }
+    {
+      const gate = evaluateInjectionBudgetGate(message, true, false);
+      if (!gate.allow) {
+        releaseInterruptKey();
+        log(`Interrupt-path injection rejected by budget gate after await (${gate.code})`);
+        sendClaudeToCodexResult(ws, message.requestId, {
+          success: false,
+          code: gate.code,
+          error: gate.error,
+          ...gate.retryAfterMs !== undefined ? { retryAfterMs: gate.retryAfterMs } : {}
+        });
+        return;
+      }
+      pendingWrapUpReset = gate.pendingWrapUpReset;
+    }
   }
   const injectThreadId = codex.activeThreadId;
+  if (pendingWrapUpReset !== null) {
+    const committed = consumeWrapUp(stateDir.admissionQuotaFile, pendingWrapUpReset, BUDGET_CONFIG.maximize.wrapUpQuota, log);
+    if (!committed.allowed) {
+      log(`Injection rejected by admission gate: wrap-up slot not durably recorded (write failure or raced to cap)`);
+      sendClaudeToCodexResult(ws, message.requestId, {
+        success: false,
+        code: "budget_admission",
+        error: budgetAdmissionGateError(pendingWrapUpReset, 0, true)
+      });
+      return;
+    }
+    log(`Admission wrap-up slot committed (${committed.used}/${BUDGET_CONFIG.maximize.wrapUpQuota})`);
+  }
   const injectionId = codex.injectMessage(contentToSend, tierOverrides);
   if (injectionId === null) {
     if (idempotencyKey && injectThreadId) {