@theronap/agnoclast-mcp 0.9.173 → 0.9.175

package/lib/diagnose.mjs

@@ -542,6 +542,26 @@ export function outageReport(outcome, { tool, requestId = null, version = CLIENT
   return null
 }
 
+// ⚠ "COULD NOT CONNECT" IS ALSO WHAT A LAPTOP WITH NO NETWORK LOOKS LIKE. The first real report (2026-09-25)
+// was ×12 `connect` outages from one Mac between 09:34 and 11:39 — hooks running during DarkWake /
+// Maintenance Sleep with the network half up, while production was healthy. So a thrown connect/timeout
+// is only filed when the INTERNET is reachable and Agnoclast is not. The probe hits a neutral anycast host
+// with its own short budget; if that fails too, the fault is local and nothing is filed. A response of any
+// kind (infra 4xx/5xx, 503) proves the network worked, so those paths never probe.
+const REACHABILITY_URL = 'https://1.1.1.1/cdn-cgi/trace'
+const REACHABILITY_TIMEOUT_MS = 2500
+let reachabilityProbe = async () => {
+  try {
+    const r = await fetch(REACHABILITY_URL, { method: 'GET', signal: AbortSignal.timeout(REACHABILITY_TIMEOUT_MS) })
+    try { await r.body?.cancel() } catch { /* nothing to drain */ }
+    return true
+  } catch {
+    return false
+  }
+}
+/** Tests: replace the internet-reachability probe. Returns the previous one. */
+export function setReachabilityProbe(fn) { const prev = reachabilityProbe; reachabilityProbe = fn; return prev }
+
 /** Auto-filing is off under `bun test` unless the test points the spool somewhere (never the real home). */
 function autofileEnabled(env = process.env) {
   if (env.CORTEX_AUTOFILE === '0') return false
@@ -601,7 +621,9 @@ export async function fetchCortex(url, opts = {}, policy = {}) {
   } catch (e) {
     if (hook && e?.retryClass) {
       const r = outageReport({ thrownClass: e.retryClass }, { tool: toolForUrl(url) })
-      if (r) spoolReport(r)
+      // Awaited, not fire-and-forget: hook processes are short-lived and would exit before a detached
+      // probe answered. Bounded by REACHABILITY_TIMEOUT_MS, and only on a path that is already failing.
+      try { if (r && await reachabilityProbe()) spoolReport(r) } catch { /* filing must never change the error */ }
     }
     throw e
   }

package/lib/server.mjs

@@ -231,8 +231,25 @@ export async function runServer(version) {
       const body = await res.text()
       throw new Error(classify(res.status, res.headers.get('content-type'), body, res.headers.get('x-vercel-id')).message)
     }
-    const { context, brainRefs } = await res.json()
+    const { context, brainRefs, settling } = await res.json()
+    // ⭐ THE SETTLING FEED, APPENDED TO THE SESSION-START BLOCK — the thing it has never carried.
+    //
+    // Everything else in that block is PERSON-scoped, so /api/mcp-context never needed to know which
+    // session was asking and never read the `x-cortex-session-key` header it has been receiving on
+    // every request since fetchCortex started sending it. The settling feed is the only inherently
+    // SESSION-scoped signal in the block, which is why it was structurally excluded rather than
+    // forgotten — and why a NEW SESSION has never once been told which arrivals are asking it a
+    // question. That is the resume case: start a session, and the offers are waiting.
+    //
+    // ⚠ NOT CACHED, and the distinction matters. The block is cached for 5 minutes; an OFFER is
+    // live state that another session can claim out from under this one. Baking it into the cached
+    // string would serve an offer already taken, or hide one that just arrived — and a feed whose
+    // whole contract is "this persists until you answer it" cannot afford to be five minutes wrong.
+    // So the cache keeps the person-scoped context exactly as before, and the session-scoped feed is
+    // appended only on a FRESH fetch. Session start and resume are always fresh fetches, which is
+    // the case this exists for; mid-session cache hits are covered by the tools.
     cache = { text: context, ts: now, repo }
+    const withSettling = (context ?? '') + renderSettling({ settling })
     // T11: stash the digest node refs surfaced this fetch so capture.mjs can forward them as
     // hydrated_from at the session's ingest (feedback-loop guard). Keyed by cwd so the matching
     // session picks them up. Best-effort + inert when brainRefs is empty (digest flag off).
@@ -244,7 +261,8 @@ export async function runServer(version) {
         writeFileSync(join(dir, `${key}.json`), JSON.stringify({ refs: brainRefs, ts: now }))
       }
     } catch { /* best-effort — never break context serving */ }
-    return context
+    // The fresh block carries the offers; the cached one deliberately does not (see above).
+    return withSettling
   }
 
   const server = new McpServer({ name: 'cortex', version })
@@ -373,7 +391,7 @@ function renderNudge(payload) {
       // so a session doing pipeline work never saw it — measured 2026-09-24, eighteen hours with a
       // stale watermark while three arrivals landed unannounced. This is the tool an agent calls at
       // session start and on every topic shift, which is when "mail arrived" is worth knowing.
-      return { content: [{ type: 'text', text: (ctx?.context ?? '') + renderArrival(ctx) }] }
+      return { content: [{ type: 'text', text: (ctx?.context ?? '') + renderArrival(ctx) + renderSettling(ctx) }] }
     },
   )
 
@@ -870,7 +888,7 @@ function renderNudge(payload) {
       // so a session doing pipeline work never saw it — measured 2026-09-24, eighteen hours with a
       // stale watermark while three arrivals landed unannounced. This is the tool an agent calls at
       // session start and on every topic shift, which is when "mail arrived" is worth knowing.
-      return { content: [{ type: 'text', text: (ctx?.context ?? '') + renderArrival(ctx) }] }
+      return { content: [{ type: 'text', text: (ctx?.context ?? '') + renderArrival(ctx) + renderSettling(ctx) }] }
     },
   )
 
@@ -2170,7 +2188,7 @@ function renderNudge(payload) {
       if (!out) return toolError('The server returned no body.')
 
       if (!out.total) {
-        return { content: [{ type: 'text', text: 'Nothing staged — every arrival has reached a brain.' }] }
+        return { content: [{ type: 'text', text: 'Nothing staged — every arrival has reached a brain.' + renderSettling(out) }] }
       }
       const lines = [`${out.total} staged arrival(s) — in NO brain yet:`, '']
       for (const a of out.arrivals ?? []) {
@@ -2219,7 +2237,7 @@ function renderNudge(payload) {
       lines.push('', 'Place one with place_staged_record (staged_id + pages). The pages decide the brain, which decides who can read it.')
       lines.push('No page fits? `author` the page it needs, then place onto it. Junk? `discard_staged` (reversible, dry-run by default).')
       lines.push('A default brain is NOT the answer for content — one standing rule cannot decide disclosure for mail nobody has read.')
-      return { content: [{ type: 'text', text: withAskNotice(lines.join('\n')) }] }
+      return { content: [{ type: 'text', text: withAskNotice(lines.join('\n')) + renderSettling(out) }] }
     },
   )
 
@@ -4276,7 +4294,7 @@ function renderNudge(payload) {
         // ⚠ THE DELTA STILL SHIPS ON THE EMPTY PATH. "Nothing waiting for a home" and "nothing has
         // arrived" are different facts, and an empty digest is exactly when a silent counter reads
         // as all-clear.
-        return { content: [{ type: 'text', text: 'Nothing waiting for a home.' + renderArrival(out) }] }
+        return { content: [{ type: 'text', text: 'Nothing waiting for a home.' + renderArrival(out) + renderSettling(out) }] }
       }
       const lines = records.map((r) => {
         const homes = r.currentHomes?.length ? r.currentHomes.join(', ') : 'nothing'
@@ -4286,7 +4304,7 @@ function renderNudge(payload) {
       return {
         content: [{
           type: 'text',
-          text: `${records.length} record(s) waiting for a home:\n\n${lines.join('\n\n')}\n\nRecognize any as your own work? claim_record it now, then route_record once you know where it belongs.` + renderArrival(out),
+          text: `${records.length} record(s) waiting for a home:\n\n${lines.join('\n\n')}\n\nRecognize any as your own work? claim_record it now, then route_record once you know where it belongs.` + renderArrival(out) + renderSettling(out),
         }],
       }
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theronap/agnoclast-mcp",
-  "version": "0.9.173",
+  "version": "0.9.175",
   "description": "Connect your AI assistant to Cortex — your org's projects, activity, gaps, and directives, scoped to you.",
   "type": "module",
   "bin": {