@theronap/agnoclast-mcp 0.9.173 → 0.9.174

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.174",
   "description": "Connect your AI assistant to Cortex — your org's projects, activity, gaps, and directives, scoped to you.",
   "type": "module",
   "bin": {