@theronap/agnoclast-mcp 0.9.233 → 0.9.235

package/lib/server.mjs

@@ -31,6 +31,7 @@ import { formatCreated, formatDryRun, formatSources, homeFromArgs, pickSource, r
 import { formatSeriesRefusal, formatSeriesUpdated } from './series_render.mjs'
 import { formatSends } from './sends_render.mjs'
 import { applyLock, fetchLockState, lockedAnswerFor, lockStateWithin } from './locked_tools.mjs'
+import { filterUnshownSettling } from './settling_shown.mjs'
 
 // PAGE tiers (ADR-0071). Six for a PAGE; a RECORD keeps three (`privacy` on log_session and
 // set_record_privacy below) — an owner-relative tier is applied to a page's records when they are read
@@ -450,9 +451,18 @@ function renderArrival(payload) {
     ` — \`staged_records\` lists them. Not offered to you, just counted; \`ignore_arrivals\` if this is noise right now.`
 }
 
+// ASK ONCE, THEN ONLY WHAT IS NEW (Theron, 2026-10-14). This block rode on EVERY tool reply, unchanged,
+// and an offer that can be ignored on every call is ignored on every call — measured that day: 869
+// pending, 0 claimed, while the block was printed to every session. Now a unit is shown to this process
+// (one MCP server = one session) the first time only, framed as a decision owed before other work.
+// Units every session passes on are escalated to the PERSON at the next session start
+// (web/lib/engine/orphan_escalation.ts), so a unit dropped here is never lost — it changes audience.
+const settlingShown = new Set()
+
 function renderSettling(payload) {
   const feed = payload?.settling
-  const offers = Array.isArray(feed?.offers) ? feed.offers : []
+  const firstSight = settlingShown.size === 0
+  const offers = filterUnshownSettling(Array.isArray(feed?.offers) ? feed.offers : [], settlingShown)
   if (!offers.length) return ''
   const total = Number(feed?.total ?? offers.length)
 
@@ -483,7 +493,10 @@ function renderSettling(payload) {
     ? `\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.`
     : ''
 
-  return `\n\n⚡ ARRIVALS SETTLING — yours alone, and no one else can see these yet:\n${lines.join('\n')}\n` +
+  const head = firstSight
+    ? `\n\n⚡ ARRIVALS SETTLING — DECIDE EACH LINE BEFORE CONTINUING: \`intake_claim\` it if it belongs to this session's work, otherwise \`not_mine\`. You are asked once; when every session has passed, the person is told at the next session start.\n`
+    : `\n\n⚡ NEW ARRIVALS SETTLING — decide each: \`intake_claim\` or \`not_mine\`:\n`
+  return `${head}${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 {intakeItemIds: ["<id>"]}\` to take a lease on THAT unit (the array is required; without an id you claim the head of the queue instead), then \`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.\n` +
@@ -1185,6 +1198,7 @@ function renderNudge(payload) {
       inputSchema: {
         claimKind: z.enum(['relevance', 'cleanup']).optional().describe('default relevance'),
         limit: z.number().optional().describe('max items (default 10). Ignored when intakeItemIds is given.'),
+        source: z.string().optional().describe('claim only the oldest units of ONE source — e.g. "imessage", "meeting", "email", "github", "claude-code". Reaches texts without first claiming every older GitHub/session unit ahead of them. Ignored when intakeItemIds is given.'),
         leaseMinutes: z.number().optional().describe('lease length in minutes, 5-60 (default 30). Prefer intake_look for read-only inspection — a short lease is only for briefly exclusive work.'),
         // 🔴 SINGULAR ACCEPTED, AND NOT AS A CONVENIENCE. Every sibling verb takes `intakeItemId`:
         // intake_look, intake_materialize, intake_release, intake_defer, intake_discard. This one
@@ -1208,7 +1222,7 @@ function renderNudge(payload) {
         ),
       },
     },
-    async ({ claimKind, limit, intakeItemId, intakeItemIds, leaseMinutes }) => {
+    async ({ claimKind, limit, source, intakeItemId, intakeItemIds, leaseMinutes }) => {
       // Merge the two spellings before anything else looks at them. Passing both is not an error —
       // the union is what the caller plainly meant.
       const ids = [...new Set([...(intakeItemIds ?? []), ...(intakeItemId ? [intakeItemId] : [])])]
@@ -1225,6 +1239,7 @@ function renderNudge(payload) {
           // survive as one; sending `[]` where the caller sent nothing would silently switch a FIFO
           // claim into a no-op.
           ...(intakeItemIds ? { intakeItemIds } : {}),
+          ...(source ? { source } : {}),
         }),
       })
       if (!res.ok) {

package/lib/settling_shown.mjs

@@ -0,0 +1,9 @@
+// Ask-once filter for the ⚡ ARRIVALS SETTLING block (2026-10-14). Pure, so it is testable without
+// importing server.mjs. An offer is fresh if ANY id it stands for has not been shown to this session;
+// a text conversation counts as one offer carrying many ids, so one new text re-raises its chat.
+export function filterUnshownSettling(offers, shown) {
+  const idsOf = (x) => (x.conversation?.ids?.length ? x.conversation.ids : [x.intakeItemId])
+  const fresh = offers.filter((x) => idsOf(x).some((id) => !shown.has(id)))
+  for (const x of fresh) for (const id of idsOf(x)) shown.add(id)
+  return fresh
+}

package/package.json

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