@theronap/agnoclast-mcp 0.9.217 → 0.9.219

package/lib/editors/claude.mjs

@@ -33,7 +33,7 @@ export const ALLOWED_TOOL_NAMES = [
   'list_records', 'read_record', 'page_history', 'page_diff', 'timeline_pull', 'my_brains', 'my_sessions', 'writing_style',
   'code_graph_query', 'my_retier_notices', 'list_page_grants', 'list_project_members', 'file_requests',
   // the questions agents used to answer with SQL (2026-10-07) — read-only, the caller's own view
-  'record_status', 'my_connectors', 'brain_stats', 'my_sends',
+  'record_status', 'my_connectors', 'brain_stats', 'my_sends', 'find_arrivals',
   // live authoring core
   'authoring_context', 'author', 'log_session',
   // routine, reversible maintenance

package/lib/server.mjs

@@ -4512,7 +4512,7 @@ function renderNudge(payload) {
     'list_records',
     {
       title: 'List activity records (filtered)',
-      description: 'List recent activity records you can see, filtered by type, project, page, source and recency. RLS-scoped. Use to enumerate "what happened on project X this week", "recent meetings", or EVERYTHING FILED ON A PAGE — pass `page` (its name or ref) to read a channel\'s items or a project page\'s records, with order:"oldest" to read a series in sequence, `offset` to page past 50, and `match` to narrow to records mentioning something. A long result holds whole records back and tells you the offset to resume from. Returns each record\'s FULL summary + id — never a truncated preview, so what you get back is the whole record you are permitted to read (use an id with request_file to ask its owner for the original file).',
+      description: 'List recent activity records you can see, filtered by type, project, page, source and recency. RLS-scoped. Use to enumerate "what happened on project X this week", "recent meetings", or EVERYTHING FILED ON A PAGE — pass `page` (its name or ref) to read a channel\'s items or a project page\'s records, with order:"oldest" to read a series in sequence, `offset` to page past 50, and `match` to narrow to records mentioning something. A long result holds whole records back and tells you the offset to resume from. Returns each record\'s FULL summary + id — never a truncated preview, so what you get back is the whole record you are permitted to read (use an id with request_file to ask its owner for the original file). For HOW MANY rather than which, pass `group_by` ("emails per week", "which pages get the most", "who logged the most sessions"): counts over exactly the records the same filters would list.',
       inputSchema: {
         type: z.string().optional().describe("record type, e.g. 'meeting', 'comm', 'activity', 'ai_session', 'doc', 'note'"),
         project: z.string().optional().describe('project key to filter to (e.g. "cortex")'),
@@ -4526,10 +4526,12 @@ function renderNudge(payload) {
         match: z.string().optional().describe('only records whose title or text contains this (case-insensitive, literal) — e.g. one book on a channel that carries several, one ticket in a queue'),
         container: z.string().optional().describe('a container\'s record id (a class session, a meeting) — lists the records INSIDE it. read_record on the container shows the same list with its own content'),
         person: z.string().optional().describe('a member\'s exact display name or email — only the records they created (within what you can see)'),
+        group_by: z.enum(['day', 'week', 'month', 'source', 'type', 'project', 'person', 'page']).optional().describe('return COUNTS instead of records, grouped by this — every other filter still applies (not container). Days and weeks are in your timezone (my_settings). Under "page" a record filed on several pages counts once per page, and a page you cannot read is never named'),
       },
     },
-    async ({ type, project, since_days, limit, session, page, source, order, offset, match, container, person }) => {
+    async ({ type, project, since_days, limit, session, page, source, order, offset, match, container, person, group_by }) => {
       const qs = new URLSearchParams()
+      if (group_by) qs.set('group_by', group_by)
       if (container) qs.set('container', container)
       if (person) qs.set('person', person)
       if (page) qs.set('page', page)
@@ -4660,6 +4662,34 @@ function renderNudge(payload) {
     },
   )
 
+  server.registerTool(
+    'find_arrivals',
+    {
+      title: 'Ask the arrival pile a question',
+      description: 'Search YOUR arrivals that are in no brain yet — both piles: STAGED (held because nothing could place them) and SEALED (private intake units waiting to be judged) — by identifier prefix, source and age. Use it for "which arrivals carry the files my PR touched?" (identifier: "file:owner/repo:path/" or "repo:owner/name"), "what email from dave@x.com is waiting?" (identifier: "email:dave@x.com"), "what has sat unfiled for 2+ days?" (older_than_hours: 48). Returns ids you can open with staged_look / intake_look and file with place_staged_record / intake_claim → intake_materialize. Plaintext metadata only: a sealed unit\'s content is never opened here. ⚠ A staged arrival matches only on the identifiers HOLDING it (the unclaimed ones).',
+      inputSchema: {
+        identifier: z.string().optional().describe('an identifier or the start of one, matched literally: "file:theronap/cortex:web/lib/", "repo:theronap/cortex", "email:someone@x.com"'),
+        source: z.string().optional().describe("one source: 'email', 'email-in', 'github', 'claude-code', 'imessage', 'meeting'…"),
+        older_than_hours: z.number().optional().describe('only arrivals waiting longer than this'),
+        newer_than_hours: z.number().optional().describe('only arrivals from the last N hours'),
+        pile: z.enum(['staged', 'sealed', 'both']).optional().describe('default both'),
+        limit: z.number().optional().describe('default 30, max 100'),
+      },
+    },
+    async ({ identifier, source, older_than_hours, newer_than_hours, pile, limit }) => {
+      const qs = new URLSearchParams()
+      if (identifier) qs.set('identifier', identifier)
+      if (source) qs.set('source', source)
+      if (older_than_hours != null) qs.set('older_than_hours', String(older_than_hours))
+      if (newer_than_hours != null) qs.set('newer_than_hours', String(newer_than_hours))
+      if (pile) qs.set('pile', pile)
+      if (limit != null) qs.set('limit', String(limit))
+      const r = await readText('search your arrivals', `${BASE}/api/arrivals?${qs}`)
+      if (r.error) return r.error
+      return { content: [{ type: 'text', text: r.json?.text ?? '' }] }
+    },
+  )
+
   server.registerTool(
     'my_sends',
     {

package/package.json

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