@theronap/cortex-mcp 0.9.125 → 0.9.126

package/lib/server.mjs

@@ -1940,6 +1940,59 @@ function renderNudge(payload) {
     },
   )
 
+  server.registerTool(
+    'discard_staged',
+    {
+      title: 'Discard staged arrivals in bulk — reversibly',
+      description: "Mark staged arrivals as discarded, addressed BY IDENTIFIER (every arrival that address is holding) or by explicit staged ids. The counterpart to `place_staged_record`, which takes one row at a time and needs pages — right for an arrival worth keeping, wrong for a queue where one unclaimed address holds 68-199 arrivals and most of them are simply not wanted. ⚠ REVERSIBLE, unlike `intake_discard`: this sets a state and destroys NOTHING (the row keeps its raw_body and the message is still in the source mailbox), so pass `restore: true` to undo. That is what makes a bulk verb safe here — classifying thousands of correspondents guarantees being wrong about some. ⚠ DRY-RUN BY DEFAULT: it reports what it WOULD change and changes nothing until you pass `apply: true`, and the dry-run count is the same set the apply writes. Use `staged_records` first to see the ranking.",
+      inputSchema: {
+        identifiers: z.array(z.string()).optional().describe('discard every pending arrival blocked on any of these, e.g. ["email:venmo@venmo.com"]'),
+        staged_ids: z.array(z.string()).optional().describe('discard these specific arrivals'),
+        apply: z.boolean().optional().describe('false/absent = dry run (default). true actually writes.'),
+        restore: z.boolean().optional().describe('true = put previously discarded arrivals back in the queue'),
+      },
+    },
+    async ({ identifiers, staged_ids, apply, restore }) => {
+      if (!identifiers?.length && !staged_ids?.length) {
+        return toolError('Pass `identifiers` or `staged_ids` — an empty call is refused rather than treated as "everything".')
+      }
+      let res
+      try {
+        res = await fetchCortex(`${BASE}/api/staged/discard`, {
+          method: 'POST',
+          headers: { Authorization: `Bearer ${TOKEN}`, 'Content-Type': 'application/json' },
+          body: JSON.stringify({ identifiers, stagedIds: staged_ids, apply: apply === true, restore: restore === true }),
+        })
+      } catch (e) {
+        return toolError(`Could not reach the staged queue: ${e.message}`)
+      }
+      const out = await res.json().catch(() => null)
+      if (!res.ok) return toolError(`Could not ${restore ? 'restore' : 'discard'}: ${out?.hint ?? out?.error ?? res.status}`)
+      if (!out) return toolError('The server returned no body.')
+
+      const verb = out.restore ? 'restore' : 'discard'
+      const lines = []
+      if (out.mode === 'dry-run') {
+        lines.push(`DRY RUN — nothing changed. Would ${verb} ${out.matched} arrival(s).`)
+        lines.push('Re-run with apply: true to do it.')
+      } else {
+        lines.push(`${out.changed} arrival(s) ${out.restore ? 'restored to the queue' : 'discarded'}.`)
+        if (!out.restore) lines.push('Reversible — discard_staged with restore: true puts them back.')
+      }
+      if (out.unmatchedIdentifiers?.length) {
+        lines.push('', `⚠ matched NOTHING (already drained, or a typo): ${out.unmatchedIdentifiers.join(', ')}`)
+      }
+      if (out.sample?.length) {
+        lines.push('', 'Sample:')
+        for (const r of out.sample.slice(0, 10)) {
+          lines.push(`  ${r.occurredAt?.slice(0, 10) ?? ''}  ${r.title ?? '(no subject)'}`)
+        }
+        if (out.matched > out.sample.length) lines.push(`  … and ${out.matched - out.sample.length} more`)
+      }
+      return { content: [{ type: 'text', text: lines.join('\n') }] }
+    },
+  )
+
   server.registerTool(
     'place_staged_record',
     {

package/package.json

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