@theronap/agnoclast-mcp 0.9.234 → 0.9.236

package/lib/grep_cli.mjs

@@ -54,8 +54,12 @@ export function formatGrepHits(payload, query) {
     : `${hits.length} match${hits.length === 1 ? '' : 'es'} for "${query}":`
   const lines = [header, '']
   for (const h of hits) {
+    // Records (server 2026-10-15, ADR-0081) arrive in the same list, already labelled in the title.
+    const isRecord = h.kind === 'record'
     const head = h.heading ? ` > ${h.heading}` : ''
-    lines.push(`- ${h.title}${head} [${h.tier}]`)
+    lines.push(isRecord
+      ? `- ${h.title}${h.brain && h.brain.name ? `  · ${h.brain.name}` : ''}\n    read_record ${(h.record && h.record.id) || h.documentId}`
+      : `- [page] ${h.title}${head} [${h.tier}]`)
     if (h.snippet) lines.push(`    ${String(h.snippet).replace(/\s+/g, ' ').trim()}`)
     // Cap the link list per hit. Median is 2 but the tail reaches 32, and at ~126 chars/hit the
     // link lists were the second-largest cost in the payload after snippets. The count is kept so
@@ -63,7 +67,7 @@ export function formatGrepHits(payload, query) {
     if (h.links && h.links.length) {
       const shown = h.links.slice(0, LINKS_PER_HIT)
       const more = h.links.length - shown.length
-      lines.push(`    -> ${shown.map((l) => `[[${l}]]`).join(' ')}${more > 0 ? ` (+${more} more)` : ''}`)
+      lines.push(`    ${isRecord ? 'filed on' : '->'} ${shown.map((l) => `[[${l}]]`).join(' ')}${more > 0 ? ` (+${more} more)` : ''}`)
     }
   }
   return lines.join('\n')

package/lib/record_render.mjs

@@ -50,7 +50,7 @@ export function renderRecord(rec, maxChars = READ_RECORD_DEFAULT_CHARS, part = '
     out.push('')
   }
   if (notes && want === 'notes') {
-    out.push(`Full transcript: ${content.length.toLocaleString('en-US')} characters, not shown. Call read_record with part: "transcript" when you need the exact words; grep and search already cover it.`)
+    out.push(`Full transcript: ${content.length.toLocaleString('en-US')} characters, not shown. Call read_record with part: "transcript" when you need the exact words; grep and search find a meeting by its title and notes, not its raw transcript.`)
   } else if (!content.trim()) {
     out.push('(No content was captured for this record.)')
   } else if (content.length > cap) {

package/lib/server.mjs

@@ -1198,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
@@ -1221,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] : [])])]
@@ -1238,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) {
@@ -1996,9 +1998,9 @@ function renderNudge(payload) {
   server.registerTool(
     'grep',
     {
-      title: 'Grep the brain wiki',
+      title: 'Grep pages and records',
       description:
-        'Ranked keyword search across your visible brain wiki pages. Multi-word natural-language queries work (results are ranked by relevance). Pass mode:"substring" for an exact literal match of symbols, identifiers, or [[links]] — and for an English STOPWORD ("own", "not"), which ranked search drops. Returns matching sections with a context snippet and their outbound [[links]]. A broad query fans out across every brain you can see, so pass `max` when you only need to locate a page; the header always says how many matched in total, so a capped list is never mistaken for the whole answer.',
+        'Ranked keyword search across your visible brain wiki pages AND the records filed in your brains (meeting/lecture transcripts and their notes, emails, sessions, messages) — one list, each hit labelled [page] or [record · type · date] with its id and the pages it is filed on. An empty result means neither a page nor a record mentions it. Multi-word natural-language queries work (results are ranked by relevance). Pass mode:"substring" for an exact literal match of symbols, identifiers, or [[links]] — and for an English STOPWORD ("own", "not"), which ranked search drops. Returns matching sections with a context snippet and their outbound [[links]]. A broad query fans out across every brain you can see, so pass `max` when you only need to locate a page; the header always says how many matched in total, so a capped list is never mistaken for the whole answer.',
       inputSchema: {
         query: z.string().describe('search terms (natural language is fine)'),
         mode: z.enum(['substring', 'fts']).optional().describe("'fts' (default, ranked keyword) or 'substring' (exact literal — for identifiers / [[links]] / code)"),
@@ -4767,8 +4769,8 @@ function renderNudge(payload) {
         'that does not exist. ' +
         'A meeting or lecture transcript has TWO LAYERS: notes (the gist, decisions, action items) and the full ' +
         'transcript. By default you get the NOTES and the transcript\'s length; read the notes first, and ask for ' +
-        'part: "transcript" only when you need the exact words. To FIND something said in a meeting, grep and ' +
-        'search already cover the transcript.',
+        'part: "transcript" only when you need the exact words. To FIND a meeting, grep and search ' +
+        'cover its title and notes (not the raw transcript words).',
       inputSchema: {
         id: z.string().describe('the record id, from list_records, my_day, timeline_pull or another read_record'),
         max_chars: z.number().optional().describe(`cap on the content shown (default ${READ_RECORD_DEFAULT_CHARS}); the reply says how much was left out`),

package/package.json

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