@raysonmeng/agentbridge 0.1.18 → 0.1.20

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@raysonmeng/agentbridge",
-  "version": "0.1.18",
+  "version": "0.1.20",
   "description": "Bridge between Claude Code and Codex — bidirectional agent communication via MCP Channel + JSON-RPC",
   "type": "module",
   "packageManager": "bun@1.3.11",

package/plugins/agentbridge/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "agentbridge",
-  "version": "0.1.18",
+  "version": "0.1.20",
   "description": "Bridge Claude Code and Codex with a shared daemon, push channel delivery, and bidirectional reply tooling.",
   "author": {
     "name": "AgentBridge Contributors",

package/plugins/agentbridge/server/bridge-server.js

@@ -13858,6 +13858,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");
   }
@@ -14099,6 +14102,8 @@ function renderBudgetSnapshot(snapshot, options = {}) {
     } else {
       lines.push(`\u6682\u505C\uFF1A\u53CC\u4FA7\u8054\u5408\u6682\u505C\uFF08\u95F8\u95E8\u5173\u95ED\uFF09 \u2014 ${reason}${resume}`);
     }
+  } else if (snapshot.gateState === "admission-closed") {
+    lines.push("\u6682\u505C\uFF1A\u5426 \xB7 \u6536\u5C3E\u4FDD\u62A4\uFF1Aadmission-closed\uFF08Codex \u4FA7\u4EC5\u653E\u884C wrap-up/steer\uFF0C\u65B0\u4EFB\u52A1\u4F1A\u88AB\u62D2 budget_admission\uFF09");
   } else {
     lines.push("\u6682\u505C\uFF1A\u5426");
   }
@@ -14156,7 +14161,8 @@ var CLAUDE_INSTRUCTIONS = [
   "",
   "## Budget awareness",
   "- Use the get_budget tool to check both agents' subscription quota (5h/weekly windows, drift, pause state).",
-  "- If the reply tool returns a budget-pause error, do NOT retry; checkpoint your work and wait for the resume notice."
+  "- If the reply tool returns a budget-pause error (code budget_paused), do NOT retry; checkpoint your work and wait for the resume notice.",
+  "- If the reply tool returns a budget_admission error, the 5h window is in finishing-protection: new tasks are declined, but you may bring the CURRENT collaboration to a checkpoint by resending with wrap_up=true (a small per-window quota). Do NOT start new work; once the quota is used or you are done, write a checkpoint and wait for the 5h window to refresh."
 ].join(`
 `);
 
@@ -14400,6 +14406,10 @@ chat_id: ${this.sessionId}`);
               idempotency_key: {
                 type: "string",
                 description: "Optional client-generated key (non-empty, max 128 chars) that makes this reply idempotent: a retry carrying the same key is NOT re-injected \u2014 the bridge answers duplicate_in_flight / duplicate_terminal instead. Use a fresh key per logical message."
+              },
+              wrap_up: {
+                type: "boolean",
+                description: "Set true ONLY to declare a finishing turn when the budget gate is in 5h finishing-protection (you got a budget_admission error or a system_budget_admission notice). A wrap-up reply is let through the admission gate up to a small per-5h-window quota so you can bring the current collaboration to a checkpoint; do NOT use it to start new work. Leave false/unset for normal replies."
               }
             },
             required: ["text"]
@@ -14552,7 +14562,8 @@ chat_id: ${this.sessionId}`);
         isError: true
       };
     }
-    const result = await this.replySender(bridgeMsg, requireReply, onBusy, idempotencyKey);
+    const wrapUp = args?.wrap_up === true;
+    const result = await this.replySender(bridgeMsg, requireReply, onBusy, idempotencyKey, wrapUp);
     if (!result.success) {
       this.log(`Reply delivery failed: ${result.error}${result.code ? ` (code=${result.code})` : ""}`);
       const codePrefix = result.code ? ` [${result.code}]` : "";
@@ -14622,11 +14633,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.20", "0.0.0-source"),
+  commit: defineString("d6034c6", "source"),
   bundle: defineBundle("plugin"),
   contractVersion: defineNumber(1, CONTRACT_VERSION),
-  codeHash: defineString("46a6407023f0", "source")
+  codeHash: defineString("d2425ba159fe", "source")
 });
 function sameRuntimeContract(a, b) {
   if (!a || !b)
@@ -14873,7 +14884,7 @@ class DaemonClient extends EventEmitter2 {
     this.ws = null;
     this.rejectPendingReplies("Daemon connection closed");
   }
-  async sendReply(message, requireReply, onBusy, idempotencyKey) {
+  async sendReply(message, requireReply, onBusy, idempotencyKey, wrapUp) {
     if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
       return { success: false, error: "AgentBridge daemon is not connected." };
     }
@@ -14888,7 +14899,8 @@ class DaemonClient extends EventEmitter2 {
       message,
       ...requireReply ? { requireReply: true } : {},
       ...onBusy && onBusy !== "reject" ? { onBusy } : {},
-      ...idempotencyKey ? { idempotencyKey } : {}
+      ...idempotencyKey ? { idempotencyKey } : {},
+      ...wrapUp ? { wrapUp: true } : {}
     });
     return pending;
   }
@@ -15666,7 +15678,9 @@ var DEFAULT_BUDGET_CONFIG = {
     reserveSlopePctPerHour: 0.4,
     reserveMaxPct: 7,
     finishingHorizonMinutes: 30,
-    resumeHysteresisPct: 5
+    resumeHysteresisPct: 5,
+    admissionAt: 85,
+    wrapUpQuota: 2
   },
   allocation: {
     minRunwayRatio: 50,
@@ -15734,7 +15748,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`;
@@ -15759,7 +15775,7 @@ function hasCustomDecisionValues(config2) {
   const d = DEFAULT_CONFIG;
   const b = config2.budget;
   const db = d.budget;
-  return config2.idleShutdownSeconds !== d.idleShutdownSeconds || config2.turnCoordination.attentionWindowSeconds !== d.turnCoordination.attentionWindowSeconds || config2.codex.appPort !== d.codex.appPort || config2.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 config2.idleShutdownSeconds !== d.idleShutdownSeconds || config2.turnCoordination.attentionWindowSeconds !== d.turnCoordination.attentionWindowSeconds || config2.codex.appPort !== d.codex.appPort || config2.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))
@@ -15799,9 +15815,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;
@@ -16383,7 +16401,7 @@ if (process.env.AGENTBRIDGE_TRACE === "1") {
     });
   } catch {}
 }
-claude.setReplySender(async (msg, requireReply, onBusy, idempotencyKey) => {
+claude.setReplySender(async (msg, requireReply, onBusy, idempotencyKey, wrapUp) => {
   if (msg.source !== "claude") {
     return { success: false, error: "Invalid message source" };
   }
@@ -16393,7 +16411,7 @@ claude.setReplySender(async (msg, requireReply, onBusy, idempotencyKey) => {
       error: disabledReplyError(daemonDisabledReason ?? "killed")
     };
   }
-  return daemonClient.sendReply(msg, requireReply, onBusy, idempotencyKey);
+  return daemonClient.sendReply(msg, requireReply, onBusy, idempotencyKey, wrapUp);
 });
 claude.setResumeAckHandler((resumeId, status) => {
   if (daemonDisabled) {