@apnex/network-adapter 0.1.2 → 0.1.6

package/dist/prompt-format.js

@@ -41,6 +41,10 @@ export function getActionText(event, data) {
             return `Read with get_review(taskId="${data.taskId}")`;
         case "proposal_decided":
             return "Review decision and act if needed";
+        case "work_claimable_digest":
+            return "Claimable work available — list_ready_work then claim_work";
+        case "work_lease_stall":
+            return `Held work ${data.workId ?? ""} nearing lease expiry — renew_lease / block_work / abandon_work`;
         default:
             return "Review and act as needed";
     }
@@ -49,16 +53,39 @@ export function getActionText(event, data) {
 function renderThreadMessage(data, cfg) {
     // calibration #20 retire (mission-63 W3): surface the body inline so the
     // LLM has the actual message content, not just the envelope-shell. The
-    // Hub-side dispatch payload pre-truncates to 200 chars (thread-policy.ts);
-    // adapter renders that preview verbatim. Full body still requires get_thread.
+    // Hub-side dispatch payload pre-truncates to THREAD_MESSAGE_PREVIEW_CHARS
+    // chars (thread-policy.ts; mission-66 commit 6 ratified at 200 chars);
+    // adapter renders that preview + truncation marker (mission-66 #26).
+    // Full body still requires get_thread.
+    //
+    // mission-66 commit 6 (#26 marker-protocol; closes calibration #26):
+    // Hub-side envelope-builder surfaces `truncated: true` + `fullBytes: <n>`
+    // on dispatchPayload when body exceeds preview threshold. Adapter
+    // render-template appends marker per Design §2.1.2 architect-lean (b):
+    // `[…<N> bytes truncated; query thread for full content]`.
+    //
+    // M-SSE-Peek-Line-Cleanup Phase 1 (Design v1.1 §0.5.3): when Hub has
+    // rendered the canonical peek-line via `payload.body` (auto-derived
+    // from event-name + data at emit-time per `deriveRenderContext`),
+    // prefer it as the summary line. Falls back to the legacy author-label
+    // composition when payload.body is absent (cutover window).
     const p = cfg.toolPrefix;
-    const authorLabel = data.author === "architect" ? "Architect"
-        : data.author === "engineer" ? "Engineer peer"
-            : "Peer";
+    const hubBody = typeof data.body === "string" && data.body.length > 0 ? data.body : null;
     const title = data.title || data.threadId || "(unknown)";
     const body = data.message || "";
-    const bodyLine = body ? `\n\nMessage preview: ${body}` : "";
-    return (`[${authorLabel}] Replied to thread "${title}".${bodyLine} ` +
+    const truncated = data.truncated === true;
+    const fullBytes = typeof data.fullBytes === "number" ? data.fullBytes : undefined;
+    const truncationMarker = truncated && fullBytes !== undefined
+        ? ` […${fullBytes} bytes truncated; query thread for full content]`
+        : "";
+    const bodyLine = body ? `\n\nMessage preview: ${body}${truncationMarker}` : "";
+    const summaryLine = hubBody ?? (() => {
+        const authorLabel = data.author === "architect" ? "Architect"
+            : data.author === "engineer" ? "Engineer peer"
+                : "Peer";
+        return `[${authorLabel}] Replied to thread "${title}".`;
+    })();
+    return (`${summaryLine}${bodyLine} ` +
         `\n\nIt is your turn. Call ${p}get_thread with threadId="${data.threadId}" ` +
         `to read the full thread, then reply using ${p}create_thread_reply. ` +
         `Threads 2.0 discipline: when you signal converged=true you MUST also populate ` +
@@ -147,9 +174,19 @@ function renderMessageArrived(data, cfg) {
         const pMissionId = payload.missionId || "?";
         const pMessage = payload.message || "(empty pulse message)";
         const pResponseShape = payload.responseShape || "short_status";
+        // mission-66 W1+W2 commit 5b-final (architect-portion; canonical shape per
+        // hub/src/policy/note-schema.ts ratified at thread-428 round 3; landed in
+        // commit 5 at 8193061). Canonical kind=note payload shape: { body: string
+        // (REQUIRED, non-empty), ...optional metadata }. Hub-side reject-mode at
+        // canonical repository write-path (messageRepository.createMessage) throws
+        // NoteSchemaValidationError on invalid payload; LLM-callers see error nack
+        // via MCP entry-point — caller-side feedback restores bilateral-blind class
+        // closure (#41 STRUCTURAL ANCHOR). Per anti-goal #8 coordinated-upgrade
+        // discipline + Calibration #48 (Director ratification 2026-04-29).
         return (`[Hub] Pulse fired (${payload.pulseKind}) for mission ${pMissionId}. ${pMessage} ` +
             `Respond with shape "${pResponseShape}" via the appropriate channel ` +
-            `(typically ${p}create_message kind=note OR a short status reply on the active coord-thread). ` +
+            `(typically ${p}create_message kind=note with payload {body: "<your status text>"}, ` +
+            `OR a short status reply on the active coord-thread). ` +
             `Message ID: ${msgId}.`);
     }
     if (payload.event && typeof payload.event === "string") {
@@ -164,12 +201,42 @@ function renderMessageArrived(data, cfg) {
             "(empty note body)";
         const sender = msg.authorAgentId || "unknown";
         const senderRole = msg.authorRole || "agent";
+        // mission-66 W1+W2 commit 5b-final (architect-portion; canonical shape per
+        // hub/src/policy/note-schema.ts; see pulse-template comment above for context).
         return (`[${senderRole}/${sender}] Note: ${body} ` +
-            `(Message ID: ${msgId}; respond via ${p}create_message kind=note targeting the sender.)`);
+            `(Message ID: ${msgId}; respond via ${p}create_message kind=note ` +
+            `with payload {body: "<your reply text>"} targeting the sender.)`);
     }
     return (`[Hub] Message ${msgId} (kind=${kind}) arrived. ` +
         `Use ${p}list_messages or ${p}claim_message to fetch full content + ack.`);
 }
+function renderWorkClaimableDigest(data, cfg) {
+    // idea-353 W1 — inbound idle-wake digest. Surfaced ONLY on an upward edge
+    // (0→N or a new claimable item) WHILE the agent is idle; the level-trigger
+    // de-dup means a steady N>0 / re-tick / Hub-restart does not re-fire.
+    const p = cfg.toolPrefix;
+    const role = data.role || "your";
+    const count = typeof data.count === "number" ? data.count : 0;
+    const newCount = typeof data.newCount === "number" ? data.newCount : count;
+    const noun = count === 1 ? "item" : "items";
+    const newClause = newCount > 0 && newCount < count ? ` (${newCount} new)` : "";
+    return (`[Hub] ${count} ${noun} now claimable for the ${role} role${newClause}. ` +
+        `Call ${p}list_ready_work to view, then ${p}claim_work to pick one up. ` +
+        `(Idle-wake digest: surfaced because you are idle and newly-claimable work appeared.)`);
+}
+function renderWorkLeaseStall(data, cfg) {
+    // idea-353 W2 — outbound stall-prompt: the gentle first rung below the
+    // lease-TTL → sweeper → poison → thrash ladder. Fires once per lease window
+    // when a held lease crosses ~60% of its life without a renew; renewing
+    // reopens the window + clears this prompt.
+    const p = cfg.toolPrefix;
+    const workId = data.workId || "(unknown)";
+    const msUntilExpiry = typeof data.msUntilExpiry === "number" ? data.msUntilExpiry : 0;
+    const mins = Math.max(0, Math.round(msUntilExpiry / 60000));
+    return (`[Hub] Your held work ${workId} is approaching lease expiry (~${mins}m left) without a recent renew. ` +
+        `Before the sweeper reaps it: ${p}renew_lease (still working), ${p}block_work (blocked on something), ` +
+        `or ${p}abandon_work (giving it up). Renewing clears this prompt.`);
+}
 // ── Registry ────────────────────────────────────────────────────────────
 const RENDER_REGISTRY = new Map([
     ["thread_message", renderThreadMessage],
@@ -181,6 +248,8 @@ const RENDER_REGISTRY = new Map([
     ["review_completed", renderReviewCompleted],
     ["revision_required", renderRevisionRequired],
     ["proposal_decided", renderProposalDecided],
+    ["work_claimable_digest", renderWorkClaimableDigest],
+    ["work_lease_stall", renderWorkLeaseStall],
 ]);
 function defaultTemplate(event, _data, _cfg) {
     return `[Hub] Notification: ${event}.`;
@@ -213,6 +282,10 @@ export function buildToastMessage(event, data) {
             const cause = data.cause || "unknown";
             return `Agent ${id} state-changed (${cause})`;
         }
+        case "work_claimable_digest":
+            return `${data.count ?? 0} work item(s) claimable for ${data.role ?? "your role"}`;
+        case "work_lease_stall":
+            return `Lease expiring: ${data.workId ?? "held work"}`;
         default:
             return `Hub: ${event}`;
     }

package/dist/prompt-format.js.map

@@ -1 +1 @@
-{"version":3,"file":"prompt-format.js","sourceRoot":"","sources":["../src/prompt-format.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"prompt-format.js","sourceRoot":"","sources":["../src/prompt-format.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,MAAM,UAAU,aAAa,CAC3B,KAAa,EACb,IAA6B;IAE7B,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,aAAa;YAChB,OAAO,uBAAuB,CAAC;QACjC,KAAK,mBAAmB;YACtB,OAAO,wCAAwC,CAAC;QAClD,KAAK,gBAAgB;YACnB,OAAO,kCAAkC,IAAI,CAAC,QAAQ,yCAAyC,CAAC;QAClG,KAAK,8BAA8B;YACjC,OAAO,0DAA0D,CAAC;QACpE,KAAK,wBAAwB;YAC3B,OAAO,uCAAuC,IAAI,CAAC,MAAM,sBAAsB,CAAC;QAClF,KAAK,kBAAkB;YACrB,OAAO,gCAAgC,IAAI,CAAC,MAAM,IAAI,CAAC;QACzD,KAAK,kBAAkB;YACrB,OAAO,mCAAmC,CAAC;QAC7C,KAAK,uBAAuB;YAC1B,OAAO,4DAA4D,CAAC;QACtE,KAAK,kBAAkB;YACrB,OAAO,aAAa,IAAI,CAAC,MAAM,IAAI,EAAE,iEAAiE,CAAC;QACzG;YACE,OAAO,0BAA0B,CAAC;IACtC,CAAC;AACH,CAAC;AAmBD,0EAA0E;AAE1E,SAAS,mBAAmB,CAAC,IAA6B,EAAE,GAAuB;IACjF,yEAAyE;IACzE,uEAAuE;IACvE,0EAA0E;IAC1E,uEAAuE;IACvE,qEAAqE;IACrE,uCAAuC;IACvC,EAAE;IACF,qEAAqE;IACrE,0EAA0E;IAC1E,kEAAkE;IAClE,uEAAuE;IACvE,2DAA2D;IAC3D,EAAE;IACF,qEAAqE;IACrE,oEAAoE;IACpE,kEAAkE;IAClE,uEAAuE;IACvE,4DAA4D;IAC5D,MAAM,CAAC,GAAG,GAAG,CAAC,UAAU,CAAC;IACzB,MAAM,OAAO,GAAG,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IACzF,MAAM,KAAK,GAAI,IAAI,CAAC,KAAgB,IAAK,IAAI,CAAC,QAAmB,IAAI,WAAW,CAAC;IACjF,MAAM,IAAI,GAAI,IAAI,CAAC,OAAkB,IAAI,EAAE,CAAC;IAC5C,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC;IAC1C,MAAM,SAAS,GAAG,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;IAClF,MAAM,gBAAgB,GAAG,SAAS,IAAI,SAAS,KAAK,SAAS;QAC3D,CAAC,CAAC,MAAM,SAAS,kDAAkD;QACnE,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,wBAAwB,IAAI,GAAG,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAE/E,MAAM,WAAW,GAAG,OAAO,IAAI,CAAC,GAAG,EAAE;QACnC,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW;YAC3D,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,eAAe;gBAC9C,CAAC,CAAC,MAAM,CAAC;QACX,OAAO,IAAI,WAAW,wBAAwB,KAAK,IAAI,CAAC;IAC1D,CAAC,CAAC,EAAE,CAAC;IAEL,OAAO,CACL,GAAG,WAAW,GAAG,QAAQ,GAAG;QAC5B,6BAA6B,CAAC,6BAA6B,IAAI,CAAC,QAAQ,IAAI;QAC5E,6CAA6C,CAAC,uBAAuB;QACrE,gFAAgF;QAChF,mDAAmD;QACnD,gFAAgF;QAChF,4DAA4D;QAC5D,uHAAuH,CACxH,CAAC;AACJ,CAAC;AAED,SAAS,gCAAgC,CAAC,IAA6B,EAAE,IAAwB;IAC/F,4EAA4E;IAC5E,4EAA4E;IAC5E,2EAA2E;IAC3E,2DAA2D;IAC3D,MAAM,KAAK,GAAI,IAAI,CAAC,KAAgB,IAAK,IAAI,CAAC,QAAmB,IAAI,WAAW,CAAC;IACjF,MAAM,MAAM,GAAI,IAAI,CAAC,MAAiB,IAAI,MAAM,CAAC;IACjD,MAAM,OAAO,GAAI,IAAI,CAAC,OAAkB,IAAI,QAAQ,CAAC;IACrD,MAAM,SAAS,GAAI,IAAI,CAAC,oBAA+B,IAAI,CAAC,CAAC;IAC7D,MAAM,QAAQ,GAAI,IAAI,CAAC,aAAwB,IAAI,CAAC,CAAC;IACrD,MAAM,MAAM,GAAI,IAAI,CAAC,WAAsB,IAAI,CAAC,CAAC;IACjD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;IAChD,OAAO,CACL,iBAAiB,KAAK,4BAA4B,MAAM,IAAI;QAC5D,YAAY,OAAO,IAAI;QACvB,sBAAsB,SAAS,cAAc,QAAQ,YAAY,MAAM,GAAG,OAAO,KAAK;QACtF,kFAAkF,CACnF,CAAC;AACJ,CAAC;AAED,SAAS,uBAAuB,CAAC,IAA6B,EAAE,IAAwB;IACtF,0EAA0E;IAC1E,yEAAyE;IACzE,0EAA0E;IAC1E,iEAAiE;IACjE,2BAA2B;IAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,KAA4C,CAAC;IAChE,MAAM,QAAQ,GAAI,IAAI,CAAC,QAAgD,IAAI,EAAE,CAAC;IAC9E,MAAM,KAAK,GAAI,IAAI,CAAC,KAAgB,IAAI,SAAS,CAAC;IAClD,MAAM,EAAE,GAAI,KAAK,EAAE,EAAa,IAAI,SAAS,CAAC;IAC9C,MAAM,IAAI,GAAI,KAAK,EAAE,IAAe,IAAI,EAAE,CAAC;IAC3C,MAAM,IAAI,GAAI,KAAK,EAAE,IAAe,IAAI,OAAO,CAAC;IAChD,MAAM,WAAW,GAAI,KAAK,EAAE,aAAwB,IAAI,SAAS,CAAC;IAClE,MAAM,WAAW,GAAI,KAAK,EAAE,aAAwB,IAAI,SAAS,CAAC;IAClE,MAAM,kBAAkB,GACtB,eAAe,IAAI,QAAQ;QACzB,CAAC,CAAC,iBAAiB,QAAQ,CAAC,aAAuB,MAAM,WAAW,EAAE;QACtE,CAAC,CAAC,IAAI,CAAC;IACX,MAAM,kBAAkB,GACtB,eAAe,IAAI,QAAQ;QACzB,CAAC,CAAC,iBAAiB,QAAQ,CAAC,aAAuB,MAAM,WAAW,EAAE;QACtE,CAAC,CAAC,IAAI,CAAC;IACX,MAAM,WAAW,GAAG,CAAC,kBAAkB,EAAE,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;IACpG,MAAM,cAAc,GAAG,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAAC;IAC9F,OAAO,CACL,eAAe,IAAI,IAAI,IAAI,KAAK,EAAE,oBAAoB,cAAc,WAAW,KAAK,IAAI,CACzF,CAAC;AACJ,CAAC;AAED,SAAS,2BAA2B,CAAC,IAA6B,EAAE,GAAuB;IACzF,MAAM,CAAC,GAAG,GAAG,CAAC,UAAU,CAAC;IACzB,OAAO,CACL,uDAAuD,IAAI,CAAC,MAAM,IAAI;QACtE,QAAQ,CAAC,kCAAkC,IAAI,CAAC,MAAM,IAAI;QAC1D,0CAA0C,CAC3C,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,IAA6B,EAAE,GAAuB;IAC9E,MAAM,CAAC,GAAG,GAAG,CAAC,UAAU,CAAC;IACzB,OAAO,CACL,uCAAuC,IAAI,CAAC,MAAM,IAAI,SAAS,KAAK;QACpE,QAAQ,CAAC,wCAAwC,CAClD,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAAC,IAA6B,EAAE,GAAuB;IACnF,MAAM,CAAC,GAAG,GAAG,CAAC,UAAU,CAAC;IACzB,OAAO,CACL,wBAAwB,IAAI,CAAC,MAAM,IAAI,aAAa,IAAI;QACxD,gBAAgB,CAAC,2BAA2B,IAAI,CAAC,MAAM,IAAI,CAC5D,CAAC;AACJ,CAAC;AAED,SAAS,sBAAsB,CAAC,IAA6B,EAAE,GAAuB;IACpF,MAAM,CAAC,GAAG,GAAG,CAAC,UAAU,CAAC;IACzB,OAAO,CACL,+BAA+B,IAAI,CAAC,MAAM,IAAI,MAAM,iBAAiB;QACrE,aAAa,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,UAAU,IAAI,qBAAqB,IAAI;QAC1E,oBAAoB,IAAI,CAAC,iBAAiB,IAAI,SAAS,IAAI;QAC3D,YAAY,IAAI,CAAC,aAAa,IAAI,GAAG,sCAAsC,CAAC,gBAAgB,CAC7F,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAAC,IAA6B,EAAE,IAAwB;IACpF,OAAO,wBAAwB,IAAI,CAAC,UAAU,IAAI,EAAE,KAAK,IAAI,CAAC,QAAQ,IAAI,SAAS,GAAG,CAAC;AACzF,CAAC;AAED,SAAS,oBAAoB,CAAC,IAA6B,EAAE,GAAuB;IAClF,qEAAqE;IACrE,oEAAoE;IACpE,8DAA8D;IAC9D,MAAM,CAAC,GAAG,GAAG,CAAC,UAAU,CAAC;IACzB,MAAM,GAAG,GAAI,IAAI,CAAC,OAAmC,IAAI,EAAE,CAAC;IAC5D,MAAM,OAAO,GAAI,GAAG,CAAC,OAAmC,IAAI,EAAE,CAAC;IAC/D,MAAM,KAAK,GAAI,GAAG,CAAC,EAAa,IAAI,GAAG,CAAC;IACxC,MAAM,IAAI,GAAI,GAAG,CAAC,IAAe,IAAI,SAAS,CAAC;IAE/C,IAAI,OAAO,CAAC,SAAS,IAAI,OAAO,OAAO,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;QAC/D,MAAM,UAAU,GAAI,OAAO,CAAC,SAAoB,IAAI,GAAG,CAAC;QACxD,MAAM,QAAQ,GAAI,OAAO,CAAC,OAAkB,IAAI,uBAAuB,CAAC;QACxE,MAAM,cAAc,GAAI,OAAO,CAAC,aAAwB,IAAI,cAAc,CAAC;QAC3E,2EAA2E;QAC3E,0EAA0E;QAC1E,0EAA0E;QAC1E,yEAAyE;QACzE,2EAA2E;QAC3E,2EAA2E;QAC3E,4EAA4E;QAC5E,wEAAwE;QACxE,mEAAmE;QACnE,OAAO,CACL,sBAAsB,OAAO,CAAC,SAAS,iBAAiB,UAAU,KAAK,QAAQ,GAAG;YAClF,uBAAuB,cAAc,gCAAgC;YACrE,cAAc,CAAC,sEAAsE;YACrF,uDAAuD;YACvD,eAAe,KAAK,GAAG,CACxB,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,KAAK,IAAI,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvD,OAAO,CACL,6BAA6B,OAAO,CAAC,KAAK,IAAI;YAC9C,GAAG,aAAa,CAAC,OAAO,CAAC,KAAK,EAAG,OAAO,CAAC,IAAgC,IAAI,EAAE,CAAC,IAAI;YACpF,eAAe,KAAK,GAAG,CACxB,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACpB,MAAM,IAAI,GACP,OAAO,CAAC,IAAe;YACvB,OAAO,CAAC,IAAe;YACvB,OAAO,CAAC,OAAkB;YAC3B,mBAAmB,CAAC;QACtB,MAAM,MAAM,GAAI,GAAG,CAAC,aAAwB,IAAI,SAAS,CAAC;QAC1D,MAAM,UAAU,GAAI,GAAG,CAAC,UAAqB,IAAI,OAAO,CAAC;QACzD,2EAA2E;QAC3E,gFAAgF;QAChF,OAAO,CACL,IAAI,UAAU,IAAI,MAAM,WAAW,IAAI,GAAG;YAC1C,gBAAgB,KAAK,iBAAiB,CAAC,2BAA2B;YAClE,iEAAiE,CAClE,CAAC;IACJ,CAAC;IAED,OAAO,CACL,iBAAiB,KAAK,UAAU,IAAI,aAAa;QACjD,OAAO,CAAC,oBAAoB,CAAC,4CAA4C,CAC1E,CAAC;AACJ,CAAC;AAED,SAAS,yBAAyB,CAAC,IAA6B,EAAE,GAAuB;IACvF,0EAA0E;IAC1E,2EAA2E;IAC3E,sEAAsE;IACtE,MAAM,CAAC,GAAG,GAAG,CAAC,UAAU,CAAC;IACzB,MAAM,IAAI,GAAI,IAAI,CAAC,IAAe,IAAI,MAAM,CAAC;IAC7C,MAAM,KAAK,GAAG,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9D,MAAM,QAAQ,GAAG,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC;IAC3E,MAAM,IAAI,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;IAC5C,MAAM,SAAS,GAAG,QAAQ,GAAG,CAAC,IAAI,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,QAAQ,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/E,OAAO,CACL,SAAS,KAAK,IAAI,IAAI,0BAA0B,IAAI,QAAQ,SAAS,IAAI;QACzE,QAAQ,CAAC,iCAAiC,CAAC,6BAA6B;QACxE,sFAAsF,CACvF,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAAC,IAA6B,EAAE,GAAuB;IAClF,uEAAuE;IACvE,4EAA4E;IAC5E,uEAAuE;IACvE,2CAA2C;IAC3C,MAAM,CAAC,GAAG,GAAG,CAAC,UAAU,CAAC;IACzB,MAAM,MAAM,GAAI,IAAI,CAAC,MAAiB,IAAI,WAAW,CAAC;IACtD,MAAM,aAAa,GAAG,OAAO,IAAI,CAAC,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IACtF,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,KAAK,CAAC,CAAC,CAAC;IAC5D,OAAO,CACL,wBAAwB,MAAM,kCAAkC,IAAI,kCAAkC;QACtG,gCAAgC,CAAC,gCAAgC,CAAC,qCAAqC;QACvG,MAAM,CAAC,2DAA2D,CACnE,CAAC;AACJ,CAAC;AAED,2EAA2E;AAE3E,MAAM,eAAe,GAAgC,IAAI,GAAG,CAAC;IAC3D,CAAC,gBAAgB,EAAE,mBAAmB,CAAC;IACvC,CAAC,8BAA8B,EAAE,gCAAgC,CAAC;IAClE,CAAC,qBAAqB,EAAE,uBAAuB,CAAC;IAChD,CAAC,iBAAiB,EAAE,oBAAoB,CAAC;IACzC,CAAC,wBAAwB,EAAE,2BAA2B,CAAC;IACvD,CAAC,aAAa,EAAE,gBAAgB,CAAC;IACjC,CAAC,kBAAkB,EAAE,qBAAqB,CAAC;IAC3C,CAAC,mBAAmB,EAAE,sBAAsB,CAAC;IAC7C,CAAC,kBAAkB,EAAE,qBAAqB,CAAC;IAC3C,CAAC,uBAAuB,EAAE,yBAAyB,CAAC;IACpD,CAAC,kBAAkB,EAAE,oBAAoB,CAAC;CAC3C,CAAC,CAAC;AAEH,SAAS,eAAe,CAAC,KAAa,EAAE,KAA8B,EAAE,IAAwB;IAC9F,OAAO,uBAAuB,KAAK,GAAG,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,KAAa,EACb,IAA6B,EAC7B,GAAuB;IAEvB,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC5C,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACzC,OAAO,eAAe,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,KAAa,EACb,IAA6B;IAE7B,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,aAAa;YAChB,OAAO,kBAAkB,IAAI,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;QACtD,KAAK,kBAAkB;YACrB,OAAO,oBAAoB,IAAI,CAAC,MAAM,IAAI,MAAM,EAAE,CAAC;QACrD,KAAK,mBAAmB;YACtB,OAAO,sBAAsB,IAAI,CAAC,MAAM,IAAI,MAAM,oBAAoB,CAAC;QACzE,KAAK,kBAAkB;YACrB,OAAO,YAAY,IAAI,CAAC,UAAU,IAAI,EAAE,KAAK,IAAI,CAAC,QAAQ,IAAI,SAAS,EAAE,CAAC;QAC5E,KAAK,wBAAwB;YAC3B,OAAO,2BAA2B,IAAI,CAAC,MAAM,IAAI,MAAM,EAAE,CAAC;QAC5D,KAAK,gBAAgB;YACnB,OAAO,kBAAkB,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,QAAQ,IAAI,QAAQ,GAAG,CAAC;QACtE,KAAK,8BAA8B;YACjC,OAAO,sBAAsB,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,QAAQ,MAAM,IAAI,CAAC,MAAM,IAAI,WAAW,KAAK,IAAI,CAAC,aAAa,IAAI,CAAC,IAAI,IAAI,CAAC,oBAAoB,IAAI,CAAC,YAAY,CAAC;QACrK,KAAK,qBAAqB,CAAC,CAAC,CAAC;YAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,KAA4C,CAAC;YAChE,MAAM,EAAE,GAAI,KAAK,EAAE,EAAa,IAAI,SAAS,CAAC;YAC9C,MAAM,KAAK,GAAI,IAAI,CAAC,KAAgB,IAAI,SAAS,CAAC;YAClD,OAAO,SAAS,EAAE,mBAAmB,KAAK,GAAG,CAAC;QAChD,CAAC;QACD,KAAK,uBAAuB;YAC1B,OAAO,GAAG,IAAI,CAAC,KAAK,IAAI,CAAC,+BAA+B,IAAI,CAAC,IAAI,IAAI,WAAW,EAAE,CAAC;QACrF,KAAK,kBAAkB;YACrB,OAAO,mBAAmB,IAAI,CAAC,MAAM,IAAI,WAAW,EAAE,CAAC;QACzD;YACE,OAAO,QAAQ,KAAK,EAAE,CAAC;IAC3B,CAAC;AACH,CAAC"}

package/dist/tool-manager/catalog/health-revision.d.ts

@@ -0,0 +1,43 @@
+/**
+ * health-revision.ts — the Hub /health `toolSurfaceRevision` fetcher,
+ * hoisted to the kernel (idea-355 SLICE-1T).
+ *
+ * This is the network mechanism the bug-180 `ToolSurfaceReconciler` injects as
+ * its `fetchLiveRevision` dependency: resolve the Hub's live tool-surface
+ * revision (an opaque ETag served on /health since bug-114) over plain HTTP,
+ * independent of the MCP transport.
+ *
+ * Previously this lived inline in each shim (the claude shim's
+ * `fetchLiveToolSurfaceRevision`). Hoisting it single-homes the network
+ * mechanism so both shims share ONE implementation. The factory is PURE — it
+ * holds no module state and carries NO cache side-effect: callers that want a
+ * cached-revision marker (the claude shim's `cachedToolSurfaceRevision`) wrap
+ * the returned function and apply the side-effect on a non-null result.
+ *
+ * Contract:
+ *   - derive `healthUrl` by replacing a trailing `/mcp` (optionally with a
+ *     further path) on `hubUrl` with `/health`;
+ *   - fetch it (global `fetch` only — opencode bundles via esbuild with no
+ *     node_modules, so no node-fetch/undici);
+ *   - return `json.toolSurfaceRevision` when it is a non-empty string;
+ *   - return null on `!res.ok`, a missing/empty/non-string field, or any throw
+ *     (never reject — the reconciler treats null as "unknown, trust the cache"
+ *     and never emits a spurious list_changed).
+ */
+export interface FetchLiveToolSurfaceRevisionOptions {
+    /** The Hub MCP URL (…/mcp). The /health URL is derived from it. */
+    hubUrl: string;
+    /**
+     * Fetch implementation. Defaults to the global `fetch`. Injectable so the
+     * factory is unit-testable without a live Hub.
+     */
+    fetch?: typeof globalThis.fetch;
+    /** Diagnostic logger. No-op default. */
+    log?: (msg: string) => void;
+}
+/**
+ * Build a pure `fetchLiveRevision` function for the bug-180
+ * `ToolSurfaceReconciler`. Resolves the Hub's live /health
+ * `toolSurfaceRevision`, or null on any failure (never rejects).
+ */
+export declare function makeFetchLiveToolSurfaceRevision(opts: FetchLiveToolSurfaceRevisionOptions): () => Promise<string | null>;

package/dist/tool-manager/catalog/health-revision.js

@@ -0,0 +1,61 @@
+/**
+ * health-revision.ts — the Hub /health `toolSurfaceRevision` fetcher,
+ * hoisted to the kernel (idea-355 SLICE-1T).
+ *
+ * This is the network mechanism the bug-180 `ToolSurfaceReconciler` injects as
+ * its `fetchLiveRevision` dependency: resolve the Hub's live tool-surface
+ * revision (an opaque ETag served on /health since bug-114) over plain HTTP,
+ * independent of the MCP transport.
+ *
+ * Previously this lived inline in each shim (the claude shim's
+ * `fetchLiveToolSurfaceRevision`). Hoisting it single-homes the network
+ * mechanism so both shims share ONE implementation. The factory is PURE — it
+ * holds no module state and carries NO cache side-effect: callers that want a
+ * cached-revision marker (the claude shim's `cachedToolSurfaceRevision`) wrap
+ * the returned function and apply the side-effect on a non-null result.
+ *
+ * Contract:
+ *   - derive `healthUrl` by replacing a trailing `/mcp` (optionally with a
+ *     further path) on `hubUrl` with `/health`;
+ *   - fetch it (global `fetch` only — opencode bundles via esbuild with no
+ *     node_modules, so no node-fetch/undici);
+ *   - return `json.toolSurfaceRevision` when it is a non-empty string;
+ *   - return null on `!res.ok`, a missing/empty/non-string field, or any throw
+ *     (never reject — the reconciler treats null as "unknown, trust the cache"
+ *     and never emits a spurious list_changed).
+ */
+/**
+ * Build a pure `fetchLiveRevision` function for the bug-180
+ * `ToolSurfaceReconciler`. Resolves the Hub's live /health
+ * `toolSurfaceRevision`, or null on any failure (never rejects).
+ */
+export function makeFetchLiveToolSurfaceRevision(opts) {
+    const log = opts.log ?? (() => { });
+    const doFetch = opts.fetch ?? globalThis.fetch;
+    const healthUrl = opts.hubUrl.replace(/\/mcp(\/.*)?$/, "/health");
+    return async () => {
+        try {
+            const res = await doFetch(healthUrl);
+            if (!res.ok) {
+                log(`[Cache] /health fetch returned status ${res.status} — cache invalidation will trust existing cache`);
+                return null;
+            }
+            const json = (await res.json());
+            if (typeof json.version === "string") {
+                log(`[Cache] Hub version: ${json.version}`);
+            }
+            if (typeof json.toolSurfaceRevision === "string" &&
+                json.toolSurfaceRevision !== "") {
+                log(`[Cache] Tool-surface revision resolved: ${json.toolSurfaceRevision}`);
+                return json.toolSurfaceRevision;
+            }
+            log(`[Cache] /health returned no toolSurfaceRevision field — cache invalidation will trust existing cache`);
+            return null;
+        }
+        catch (err) {
+            log(`[Cache] /health fetch failed (non-fatal): ${err?.message ?? String(err)}`);
+            return null;
+        }
+    };
+}
+//# sourceMappingURL=health-revision.js.map

package/dist/tool-manager/catalog/health-revision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-revision.js","sourceRoot":"","sources":["../../../src/tool-manager/catalog/health-revision.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAcH;;;;GAIG;AACH,MAAM,UAAU,gCAAgC,CAC9C,IAAyC;IAEzC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACnC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC;IAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC;IAElE,OAAO,KAAK,IAA4B,EAAE;QACxC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,CAAC;YACrC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;gBACZ,GAAG,CACD,yCAAyC,GAAG,CAAC,MAAM,iDAAiD,CACrG,CAAC;gBACF,OAAO,IAAI,CAAC;YACd,CAAC;YACD,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAG7B,CAAC;YACF,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;gBACrC,GAAG,CAAC,wBAAwB,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;YAC9C,CAAC;YACD,IACE,OAAO,IAAI,CAAC,mBAAmB,KAAK,QAAQ;gBAC5C,IAAI,CAAC,mBAAmB,KAAK,EAAE,EAC/B,CAAC;gBACD,GAAG,CAAC,2CAA2C,IAAI,CAAC,mBAAmB,EAAE,CAAC,CAAC;gBAC3E,OAAO,IAAI,CAAC,mBAAmB,CAAC;YAClC,CAAC;YACD,GAAG,CACD,sGAAsG,CACvG,CAAC;YACF,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,GAAG,CAAC,6CAA8C,GAAa,EAAE,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC3F,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/tool-manager/{tool-catalog-cache.d.ts → catalog/tool-catalog-cache.d.ts}

@@ -10,16 +10,20 @@
  *
  * Storage: $WORK_DIR/.ois/tool-catalog.json
  *   {
- *     schemaVersion: 1,
- *     hubVersion: "1.0.0",
+ *     schemaVersion: 2,
+ *     toolSurfaceRevision: "a1b2c3d4e5f6a7b8",
  *     fetchedAt: "2026-04-22T...Z",
  *     catalog: [...]
  *   }
  *
- * Invalidation: Hub-version mismatch only. No TTL — the catalog is
- * static between Hub deploys; TTL would add noise without correctness
- * value. Schema-version mismatch on read returns null (cache treated
- * as invalid; future schema evolution bumps CATALOG_SCHEMA_VERSION).
+ * Invalidation: tool-surface-revision mismatch (bug-114). The cache is
+ * keyed off a Hub-owned ETag (`/health` `toolSurfaceRevision`) that
+ * tracks the actual tool surface — added/removed tools, description or
+ * schema changes — rather than `hubVersion`, which was a hardcoded
+ * `"1.0.0"` literal that never changed (so the cache never invalidated).
+ * No TTL — the revision detects drift directly. Schema-version mismatch
+ * on read returns null (cache treated as invalid; schema evolution bumps
+ * CATALOG_SCHEMA_VERSION).
  *
  * Atomicity: writeCache uses tmp-file + rename so partial writes on
  * crash don't corrupt the cache. Parse errors on read also return
@@ -29,7 +33,10 @@
  * the primary flow):
  *   - missing file:           readCache returns null
  *   - parse error:            readCache returns null + logs
- *   - schema-version mismatch: readCache returns null
+ *   - schema-version mismatch: readCache returns null + logs +
+ *                              unlinks the stale file (bug-114
+ *                              fallback-gap hardening — forces clean
+ *                              rebuild on next bootstrap)
  *   - $WORK_DIR readonly:     writeCache logs + no-ops
  *   - disk full:              writeCache logs + no-ops
  */
@@ -37,8 +44,14 @@
  * Bumping CATALOG_SCHEMA_VERSION forces all existing cache files to
  * be treated as invalid + re-bootstrapped. Use when changing the
  * cache file shape.
+ *
+ * 1 → 2 (bug-114): `hubVersion` field replaced by `toolSurfaceRevision`.
+ * The bump is the state-migration step — every on-disk cache written in
+ * the v1 (`hubVersion`) shape fails the read-time schema check, returns
+ * null, and re-bootstraps. Free retroactive cleanup of the whole fleet's
+ * stale caches.
  */
-export declare const CATALOG_SCHEMA_VERSION = 1;
+export declare const CATALOG_SCHEMA_VERSION = 2;
 /**
  * MCP tool catalog entry shape. Kept loose (`unknown[]`) since the
  * cache is opaque storage; the dispatcher hands the catalog back to
@@ -47,7 +60,12 @@ export declare const CATALOG_SCHEMA_VERSION = 1;
 export type ToolCatalog = unknown[];
 export interface CachedCatalog {
     schemaVersion: number;
-    hubVersion: string;
+    /**
+     * bug-114 — the Hub-owned tool-surface ETag seen at fetch-time
+     * (`/health` `toolSurfaceRevision`). The cache is valid while this
+     * matches the live revision; treated as opaque (record-then-compare).
+     */
+    toolSurfaceRevision: string;
     fetchedAt: string;
     catalog: ToolCatalog;
 }
@@ -66,20 +84,22 @@ export declare function readCache(workDir: string, log?: (msg: string) => void):
  * intact OR the new cache fully landed. Best-effort: failures log
  * and return; the caller's primary flow continues.
  */
-export declare function writeCache(workDir: string, catalog: ToolCatalog, hubVersion: string, log?: (msg: string) => void): void;
+export declare function writeCache(workDir: string, catalog: ToolCatalog, toolSurfaceRevision: string, log?: (msg: string) => void): void;
 /**
- * Check cache validity against the current Hub version.
+ * Check cache validity against the current Hub tool-surface revision.
  *
  * Two semantics:
- *   - currentHubVersion is a non-empty string: strict equality vs
- *     cached.hubVersion. Mismatch → invalid → caller re-bootstraps.
- *   - currentHubVersion is null/undefined/empty: caller doesn't know
- *     the current Hub version yet (e.g. /health fetch in flight at
- *     startup). Trust the cache (probe-friendly default) — worst
- *     case is serving a stale catalog ONCE until the next /health
- *     fetch completes and a real session refreshes the cache.
+ *   - currentRevision is a non-empty string: strict equality vs
+ *     cached.toolSurfaceRevision. Mismatch → invalid → caller
+ *     re-bootstraps.
+ *   - currentRevision is null/undefined/empty: caller doesn't know the
+ *     current revision yet (e.g. /health fetch in flight at startup, or
+ *     an old Hub that doesn't return the field). Trust the cache
+ *     (probe-friendly default) — worst case is serving a stale catalog
+ *     ONCE until the next /health fetch completes and a real session
+ *     refreshes the cache.
  *
  * Schema-version check is enforced inside readCache, so isCacheValid
  * never sees a wrong-schema cached object.
  */
-export declare function isCacheValid(cached: CachedCatalog, currentHubVersion: string | null | undefined): boolean;
+export declare function isCacheValid(cached: CachedCatalog, currentRevision: string | null | undefined): boolean;

package/dist/tool-manager/{tool-catalog-cache.js → catalog/tool-catalog-cache.js}

@@ -10,16 +10,20 @@
  *
  * Storage: $WORK_DIR/.ois/tool-catalog.json
  *   {
- *     schemaVersion: 1,
- *     hubVersion: "1.0.0",
+ *     schemaVersion: 2,
+ *     toolSurfaceRevision: "a1b2c3d4e5f6a7b8",
  *     fetchedAt: "2026-04-22T...Z",
  *     catalog: [...]
  *   }
  *
- * Invalidation: Hub-version mismatch only. No TTL — the catalog is
- * static between Hub deploys; TTL would add noise without correctness
- * value. Schema-version mismatch on read returns null (cache treated
- * as invalid; future schema evolution bumps CATALOG_SCHEMA_VERSION).
+ * Invalidation: tool-surface-revision mismatch (bug-114). The cache is
+ * keyed off a Hub-owned ETag (`/health` `toolSurfaceRevision`) that
+ * tracks the actual tool surface — added/removed tools, description or
+ * schema changes — rather than `hubVersion`, which was a hardcoded
+ * `"1.0.0"` literal that never changed (so the cache never invalidated).
+ * No TTL — the revision detects drift directly. Schema-version mismatch
+ * on read returns null (cache treated as invalid; schema evolution bumps
+ * CATALOG_SCHEMA_VERSION).
  *
  * Atomicity: writeCache uses tmp-file + rename so partial writes on
  * crash don't corrupt the cache. Parse errors on read also return
@@ -29,7 +33,10 @@
  * the primary flow):
  *   - missing file:           readCache returns null
  *   - parse error:            readCache returns null + logs
- *   - schema-version mismatch: readCache returns null
+ *   - schema-version mismatch: readCache returns null + logs +
+ *                              unlinks the stale file (bug-114
+ *                              fallback-gap hardening — forces clean
+ *                              rebuild on next bootstrap)
  *   - $WORK_DIR readonly:     writeCache logs + no-ops
  *   - disk full:              writeCache logs + no-ops
  */
@@ -39,8 +46,14 @@ import { join, dirname } from "node:path";
  * Bumping CATALOG_SCHEMA_VERSION forces all existing cache files to
  * be treated as invalid + re-bootstrapped. Use when changing the
  * cache file shape.
+ *
+ * 1 → 2 (bug-114): `hubVersion` field replaced by `toolSurfaceRevision`.
+ * The bump is the state-migration step — every on-disk cache written in
+ * the v1 (`hubVersion`) shape fails the read-time schema check, returns
+ * null, and re-bootstraps. Free retroactive cleanup of the whole fleet's
+ * stale caches.
  */
-export const CATALOG_SCHEMA_VERSION = 1;
+export const CATALOG_SCHEMA_VERSION = 2;
 /** Compute the canonical cache path for a given WORK_DIR. */
 export function cachePathFor(workDir) {
     return join(workDir, ".ois", "tool-catalog.json");
@@ -60,15 +73,27 @@ export function readCache(workDir, log) {
         const parsed = JSON.parse(raw);
         if (typeof parsed.schemaVersion !== "number" ||
             parsed.schemaVersion !== CATALOG_SCHEMA_VERSION ||
-            typeof parsed.hubVersion !== "string" ||
+            typeof parsed.toolSurfaceRevision !== "string" ||
             typeof parsed.fetchedAt !== "string" ||
             !Array.isArray(parsed.catalog)) {
-            log?.(`[tool-catalog-cache] readCache: cache invalid (schema/shape mismatch) at ${path}`);
+            log?.(`[tool-catalog-cache] readCache: cache invalid (schema/shape mismatch) at ${path} — unlinking to force clean rebuild`);
+            // bug-114 fallback-gap hardening (2026-05-26): unlink the stale
+            // file so the next bootstrap doesn't repeatedly read-then-discard
+            // it. Without this, every cold-start after a
+            // CATALOG_SCHEMA_VERSION bump re-encounters the same stale file
+            // until operator intervention. Best-effort; primary flow tolerates
+            // unlink failures.
+            try {
+                unlinkSync(path);
+            }
+            catch (unlinkErr) {
+                log?.(`[tool-catalog-cache] readCache: unlink failed (non-fatal): ${unlinkErr.message ?? unlinkErr}`);
+            }
             return null;
         }
         return {
             schemaVersion: parsed.schemaVersion,
-            hubVersion: parsed.hubVersion,
+            toolSurfaceRevision: parsed.toolSurfaceRevision,
             fetchedAt: parsed.fetchedAt,
             catalog: parsed.catalog,
         };
@@ -84,12 +109,12 @@ export function readCache(workDir, log) {
  * intact OR the new cache fully landed. Best-effort: failures log
  * and return; the caller's primary flow continues.
  */
-export function writeCache(workDir, catalog, hubVersion, log) {
+export function writeCache(workDir, catalog, toolSurfaceRevision, log) {
     const path = cachePathFor(workDir);
     const tmpPath = `${path}.tmp.${process.pid}`;
     const body = {
         schemaVersion: CATALOG_SCHEMA_VERSION,
-        hubVersion,
+        toolSurfaceRevision,
         fetchedAt: new Date().toISOString(),
         catalog,
     };
@@ -112,26 +137,28 @@ export function writeCache(workDir, catalog, hubVersion, log) {
     }
 }
 /**
- * Check cache validity against the current Hub version.
+ * Check cache validity against the current Hub tool-surface revision.
  *
  * Two semantics:
- *   - currentHubVersion is a non-empty string: strict equality vs
- *     cached.hubVersion. Mismatch → invalid → caller re-bootstraps.
- *   - currentHubVersion is null/undefined/empty: caller doesn't know
- *     the current Hub version yet (e.g. /health fetch in flight at
- *     startup). Trust the cache (probe-friendly default) — worst
- *     case is serving a stale catalog ONCE until the next /health
- *     fetch completes and a real session refreshes the cache.
+ *   - currentRevision is a non-empty string: strict equality vs
+ *     cached.toolSurfaceRevision. Mismatch → invalid → caller
+ *     re-bootstraps.
+ *   - currentRevision is null/undefined/empty: caller doesn't know the
+ *     current revision yet (e.g. /health fetch in flight at startup, or
+ *     an old Hub that doesn't return the field). Trust the cache
+ *     (probe-friendly default) — worst case is serving a stale catalog
+ *     ONCE until the next /health fetch completes and a real session
+ *     refreshes the cache.
  *
  * Schema-version check is enforced inside readCache, so isCacheValid
  * never sees a wrong-schema cached object.
  */
-export function isCacheValid(cached, currentHubVersion) {
-    if (currentHubVersion === null ||
-        currentHubVersion === undefined ||
-        currentHubVersion === "") {
+export function isCacheValid(cached, currentRevision) {
+    if (currentRevision === null ||
+        currentRevision === undefined ||
+        currentRevision === "") {
         return true;
     }
-    return cached.hubVersion === currentHubVersion;
+    return cached.toolSurfaceRevision === currentRevision;
 }
 //# sourceMappingURL=tool-catalog-cache.js.map

package/dist/tool-manager/catalog/tool-catalog-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-catalog-cache.js","sourceRoot":"","sources":["../../../src/tool-manager/catalog/tool-catalog-cache.ts"],"names":[],"mappings":"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"}

package/dist/tool-manager/catalog/tool-surface-reconciler.d.ts

@@ -0,0 +1,93 @@
+/**
+ * tool-surface-reconciler.ts — declared-vs-applied reconcile for the Hub
+ * MCP tool surface (bug-180 / FR-21).
+ *
+ * Problem this closes: the host (e.g. Claude Code) enumerates `tools/list`
+ * ONCE at startup. On the pre-identity probe path the dispatcher serves the
+ * persisted on-disk catalog (tool-catalog-cache). When a Hub redeploy changes
+ * the tool surface, the in-memory catalog the host holds goes stale and
+ * nothing re-enumerates it — neither a client hard-reset nor /reload-plugins,
+ * because the long-lived proxy process never re-fetches and the redeploy emits
+ * no in-life `notifications/tools/list_changed` to already-connected hosts.
+ *
+ * The fix treats tool-surface delivery as a reconcile, mirroring the storage
+ * substrate's SchemaDef-reconciler:
+ *   - desired-state  = the Hub's tool surface, versioned by `toolSurfaceRevision`
+ *                      (a deterministic hash of the registered tool set, served
+ *                      on /health; Hub-side since bug-114).
+ *   - applied-state  = the revision the host most recently enumerated.
+ *   - watch/notify   = MCP `notifications/tools/list_changed` (the Hub already
+ *                      advertises `tools.listChanged: true`).
+ *
+ * On drift between applied and desired, emit `list_changed`; the host re-calls
+ * `tools/list` and — identity now resolved — the dispatcher serves the live
+ * surface (it skips the probe-cache path once identityReady is true).
+ *
+ * This class owns ONLY the reconcile decision + the applied-revision marker.
+ * All I/O is injected so it is unit-testable without a live Hub:
+ *   - fetchLiveRevision: resolve the Hub's current /health `toolSurfaceRevision`
+ *     (null on fetch failure / a Hub that doesn't return the field).
+ *   - readServedRevision: the revision the host's startup enumeration was
+ *     served from — the on-disk cache's `toolSurfaceRevision` (null when no
+ *     cache exists, i.e. a fresh install that bootstrapped live).
+ *   - emitListChanged: emit `notifications/tools/list_changed` to the host.
+ *
+ * Two trigger points share one `reconcile()`:
+ *   - L1 (primary): on the shim's `identityReady` event — catches the
+ *     redeploy-then-reconnect case that caused bug-180.
+ *   - L2 (backstop): on the existing PollBackstop heartbeat cadence — catches
+ *     a redeploy WHILE a session stays connected (no reconnect, so no fresh
+ *     identityReady).
+ *
+ * The applied-revision baseline is established on the first successful
+ * reconcile (whichever trigger fires first), seeded from the on-disk cache so
+ * a stale-cache-vs-live delta is detected even if L2 races ahead of L1.
+ */
+export interface ToolSurfaceReconcilerDeps {
+    /**
+     * Resolve the Hub's live tool-surface revision (the /health
+     * `toolSurfaceRevision` ETag). Returns null when the fetch fails or the Hub
+     * doesn't return the field — the reconcile then no-ops (fail-safe: never
+     * emit a spurious `list_changed` on an unknown live state).
+     */
+    fetchLiveRevision: () => Promise<string | null>;
+    /**
+     * The revision the host's current tool view was enumerated from — the
+     * on-disk cache's `toolSurfaceRevision`. Used to seed the applied-state
+     * baseline on the first reconcile (the pre-identity probe served this).
+     * null when no cache exists (fresh install bootstrapped live → no drift).
+     */
+    readServedRevision: () => string | null;
+    /** Emit `notifications/tools/list_changed` to the host. */
+    emitListChanged: () => void;
+    /** Diagnostic logger. No-op default. */
+    log?: (msg: string) => void;
+}
+export interface ReconcileOutcome {
+    /** True iff a drift was detected and `list_changed` was emitted this pass. */
+    emitted: boolean;
+    /** The live revision resolved this pass (null on fetch failure). */
+    live: string | null;
+}
+export declare class ToolSurfaceReconciler {
+    private readonly deps;
+    /**
+     * The revision the host is believed to currently have applied. null until
+     * the first successful reconcile establishes the baseline.
+     */
+    private appliedRevision;
+    private readonly log;
+    constructor(deps: ToolSurfaceReconcilerDeps);
+    /** Test/diagnostic accessor for the current applied-state marker. */
+    getAppliedRevision(): string | null;
+    /**
+     * One reconcile pass. Idempotent and safe to call from either trigger:
+     *   1. Resolve the live revision; no-op on unknown (fetch failed).
+     *   2. On first pass, seed the applied baseline from the on-disk cache
+     *      (what the host's startup probe served) — or from live if no cache.
+     *   3. On applied-vs-live drift, emit `list_changed` + advance the baseline.
+     *
+     * @param reason short label for logs (e.g. "identityReady", "heartbeat").
+     */
+    reconcile(reason?: string): Promise<ReconcileOutcome>;
+}