@theronap/agnoclast-mcp 0.9.164 → 0.9.165

package/lib/server.mjs

@@ -285,6 +285,43 @@ function renderArrival(payload) {
     ` — \`staged_records\` lists them. Not offered to you, just counted; \`ignore_arrivals\` if this is noise right now.`
 }
 
+function renderSettling(payload) {
+  const feed = payload?.settling
+  const offers = Array.isArray(feed?.offers) ? feed.offers : []
+  if (!offers.length) return ''
+  const total = Number(feed?.total ?? offers.length)
+
+  const lines = offers.map((x) => {
+    const why = x.via?.length ? ` — matches ${x.via.map((v) => `\`${v}\``).join(', ')}` : ''
+    // Looks without claims is evidence about the UNIT, not about the sessions that walked away.
+    const looked = x.looks > 0 ? `  [looked at ${x.looks}x, still unclaimed]` : ''
+    return `    - ${x.source} · ${x.hoursAgo}h ago · ${x.intakeItemId}${why}${looked}`
+  })
+
+  // ⚠ SAY THE TRUE TOTAL, NOT THE PAGE SIZE. Measured 2026-09-22: one identifier matched 113 settling
+  // units against a cap of 12. A block that says "here are 12" when there are 113 is claiming
+  // certainty it does not have — and renders identically every turn, which teaches the reader that
+  // it never changes and can be skipped.
+  const more = total > offers.length
+    ? `\n— Showing ${offers.length} of ${total}. \`intake_changes\` lists the rest; this is a sample, not the queue.`
+    : ''
+
+  // ⚠ CONTENTION IS STATED, exactly as the record nudge states `k`. Measured the same day: THREE live
+  // sessions each matched the SAME 113 units on one identifier. Silent about that, each would claim
+  // the same units and learn about the race from a failed lease.
+  const maxHolders = offers.reduce((m, x) => Math.max(m, Number(x.holders ?? 1)), 1)
+  const who = maxHolders > 1
+    ? `\n— ⚠ ${maxHolders} live sessions of yours hold a matching identifier, so these are offered to all of them. \`intake_claim\` takes a lease — claim before you work, not after, or two sessions judge the same arrival.`
+    : `\n— No other live session of yours holds a matching identifier, so nobody else is looking at these.`
+
+  return `\n\n⚡ ARRIVALS SETTLING — yours alone, and no one else can see these yet:\n${lines.join('\n')}\n` +
+    `— These are unjudged ARRIVALS, not records. Since automatic materialization was deleted, nothing files them for you.\n` +
+    `— \`intake_look <id>\` reads the full body without claiming it — looking is free, non-exclusive and logged, so look rather than guess from the headline.\n` +
+    `— Then \`intake_claim\` and \`intake_materialize\` into the brain and pages it belongs to, or \`intake_discard\`, or \`intake_defer\` with a question when only the owner can decide.` +
+    more + who +
+    `\n— If none are yours, leave them: they stay settling for your other sessions, and become everyone's business once the window closes.`
+}
+
 function renderNudge(payload) {
   const n = Array.isArray(payload?.nudge) ? payload.nudge : []
   if (!n.length) return ''
@@ -1389,7 +1426,7 @@ function renderNudge(payload) {
         throw new Error(classify(res.status, res.headers.get('content-type'), body, res.headers.get('x-vercel-id')).message)
       }
       const payload = await res.json()
-      return { content: [{ type: 'text', text: formatGrepHits(payload, query) + renderArrival(payload) + renderNudge(payload) }] }
+      return { content: [{ type: 'text', text: formatGrepHits(payload, query) + renderArrival(payload) + renderNudge(payload) + renderSettling(payload) }] }
     },
   )
 
@@ -1698,7 +1735,7 @@ function renderNudge(payload) {
       // `k` is stated rather than hidden. "Only you" and "you and two others" call for different
       // behaviour, and a nudge that claimed certainty it did not have is how an agent learns to stop
       // reading them.
-      const nudgeBlock = renderArrival(page) + renderNudge(page)
+      const nudgeBlock = renderArrival(page) + renderNudge(page) + renderSettling(page)
 
       if (matches.length === 1) {
         return { content: [{ type: 'text', text: renderMatch(matches[0], false) + nudgeBlock }] }
@@ -3449,7 +3486,7 @@ function renderNudge(payload) {
         return toolError(`Could not list records: ${d.message}`)
       }
       const payload = await res.json()
-      return { content: [{ type: 'text', text: (payload?.text ?? '') + renderArrival(payload) + renderNudge(payload) }] }
+      return { content: [{ type: 'text', text: (payload?.text ?? '') + renderArrival(payload) + renderNudge(payload) + renderSettling(payload) }] }
     },
   )
 

package/package.json

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