@theronap/agnoclast-mcp 0.9.165 → 0.9.166

package/lib/server.mjs

@@ -317,7 +317,12 @@ function renderSettling(payload) {
   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.` +
+    // ⚠ NAME THE EXACT CALL, INCLUDING THE ARRAY. This line used to read "Then `intake_claim` and
+    // `intake_materialize`" straight after a list of ids, which reads as `intake_claim <id>`. It is not:
+    // the parameter is `intakeItemIds`, an ARRAY, and on 2026-09-22 following this very sentence took a
+    // lease on ten unrelated units. The singular is accepted now, but an offer must still state the call
+    // that acts on the thing being offered — a reader should not have to consult a schema to use a nudge.
+    `— 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.` +
     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.`
 }
@@ -982,6 +987,17 @@ function renderNudge(payload) {
         claimKind: z.enum(['relevance', 'cleanup']).optional().describe('default relevance'),
         limit: z.number().optional().describe('max items (default 10). 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
+        // alone was plural, so the natural singular was NOT IN THE SCHEMA and was silently dropped
+        // — and the fallback is not an error, it is claiming the head of the queue. On 2026-09-22 a
+        // session offered one unit by the settling block called `intake_claim {intakeItemId}` and
+        // took a 30-minute lease on TEN unrelated units belonging to other sessions' work. A typo
+        // that becomes a side effect is worse than a typo that fails.
+        intakeItemId: z.string().optional().describe(
+          'a single unit to claim — the same thing as intakeItemIds with one element. Accepted because ' +
+          'every other intake verb spells it this way.',
+        ),
         intakeItemIds: z.array(z.string()).optional().describe(
           'claim these specific units instead of the head of the queue (max 50). Without it you get FIFO, ' +
           'so reaching one known unit means claiming everything ahead of it. Ids come from intake_changes ' +
@@ -993,7 +1009,11 @@ function renderNudge(payload) {
         ),
       },
     },
-    async ({ claimKind, limit, intakeItemIds, leaseMinutes }) => {
+    async ({ claimKind, limit, 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] : [])])]
+      intakeItemIds = ids.length ? ids : undefined
       const res = await fetchCortex(`${BASE}/api/intake/claim`, {
         method: 'POST',
         headers: { Authorization: `Bearer ${TOKEN}`, 'Content-Type': 'application/json' },

package/package.json

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