@theronap/agnoclast-mcp 0.9.215 → 0.9.216

package/lib/editors/claude.mjs

@@ -30,7 +30,7 @@ export function mergeClaudeMcp(existing, spec, token) {
 export const ALLOWED_TOOL_NAMES = [
   // read surface
   'grep', 'read_page', 'my_context', 'project_status', 'session_context', 'search_org',
-  'list_records', 'page_history', 'page_diff', 'timeline_pull', 'my_brains', 'my_sessions', 'writing_style',
+  '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',
   // live authoring core
   'authoring_context', 'author', 'log_session',

package/lib/record_render.mjs

@@ -0,0 +1,53 @@
+// read_record — ONE record in full (Theron, 2026-10-07: "there's really no way to see what's inside a
+// container like a class for the transcript or any other associated records").
+//
+// list_records gives a title and a summary per row. That is the right shape for a list and the wrong one
+// for "what did the professor say": the transcript itself was not on the record at all until 2026-10-07,
+// and even now it lives in the record's content, which only GET /api/records/:id returns. This renders
+// that response — content, the pages it is filed on, the container around it, and, for a container, what
+// is inside — so an agent can walk a class session the way a person does on /record.
+
+/** Default cap on the content shown. A lecture runs ~50,000 characters; the client's reply budget is finite. */
+export const READ_RECORD_DEFAULT_CHARS = 40_000
+
+const SOURCE_LABEL = {
+  github: 'GitHub', email: 'Email', 'email-in': 'Email', gmail: 'Email', 'claude-code': 'Claude Code session',
+  imessage: 'Text messages', 'google-calendar': 'Calendar', 'agnoclast-calendar': 'Calendar',
+  handoff: 'Transcript or document', meeting: 'Meeting',
+}
+
+const label = (source) => SOURCE_LABEL[source] ?? source
+const line = (e) => `  · ${e.title || '(untitled)'} — ${label(e.source)} · ${e.occurredAt} — id ${e.id}`
+
+/** PURE. The tool's reply for one record. `maxChars` caps the content and says how much was left out. */
+export function renderRecord(rec, maxChars = READ_RECORD_DEFAULT_CHARS) {
+  if (!rec || typeof rec !== 'object') return 'No record came back.'
+  const cap = Number.isFinite(maxChars) && maxChars > 0 ? Math.trunc(maxChars) : READ_RECORD_DEFAULT_CHARS
+  const out = []
+  out.push(`# ${rec.title || '(untitled record)'}`)
+  out.push(`${label(rec.source)} · ${rec.occurredAt} · brain ${rec.brain?.name ?? rec.brain ?? '?'}${rec.superseded ? ' · ⚠ superseded by a newer version' : ''}`)
+  out.push(`id: ${rec.id}`)
+  out.push('')
+  const content = typeof rec.content === 'string' ? rec.content : ''
+  if (!content.trim()) {
+    out.push('(No content was captured for this record.)')
+  } else if (content.length > cap) {
+    out.push(content.slice(0, cap))
+    out.push(`\n… ${content.length - cap} more characters. Call read_record again with max_chars: ${content.length} to read all of it.`)
+  } else {
+    out.push(content)
+  }
+  out.push('')
+  const pages = Array.isArray(rec.pages) ? rec.pages : []
+  out.push(pages.length
+    ? `Filed on: ${pages.map((p) => `“${p.title}” (ref ${p.ref})`).join(' · ')}`
+    : 'Filed on: no page you can see.')
+  const inside = Array.isArray(rec.containedIn) ? rec.containedIn : []
+  if (inside.length) out.push(`Inside:\n${inside.map(line).join('\n')}`)
+  if (Array.isArray(rec.contains)) {
+    out.push(rec.contains.length
+      ? `Contains (${rec.contains.length}) — read any with read_record:\n${rec.contains.map(line).join('\n')}`
+      : 'Contains: nothing has been filed inside this container yet.')
+  }
+  return out.join('\n')
+}

package/lib/server.mjs

@@ -26,6 +26,7 @@ import { renderRemovalQuestion, renderRemoved } from './member_remove_render.mjs
 import { renderSettings } from './settings_render.mjs'
 import { renderConversationOffer, renderMaterializeBatch } from './intake_batch_render.mjs'
 import { obligationsForUnits, renderFilingObligations, filingObligationsBrief, OBLIGATIONS_UNANSWERED_TEXT } from './filing_obligations.mjs'
+import { renderRecord, READ_RECORD_DEFAULT_CHARS } from './record_render.mjs'
 import { formatCreated, formatDryRun, formatSources, homeFromArgs, pickSource, renderHomeProblem } from './custom_sources.mjs'
 
 // PAGE tiers (ADR-0071). Six for a PAGE; a RECORD keeps three (`privacy` on log_session and
@@ -4522,10 +4523,12 @@ function renderNudge(payload) {
         order: z.enum(['newest', 'oldest']).optional().describe('newest first (default), or oldest first to read a series in sequence'),
         offset: z.number().optional().describe('skip this many records — page through more than 50 by calling again with offset 50, 100…'),
         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'),
       },
     },
-    async ({ type, project, since_days, limit, session, page, source, order, offset, match }) => {
+    async ({ type, project, since_days, limit, session, page, source, order, offset, match, container }) => {
       const qs = new URLSearchParams()
+      if (container) qs.set('container', container)
       if (page) qs.set('page', page)
       if (match) qs.set('match', match)
       if (source) qs.set('source', source)
@@ -4551,6 +4554,41 @@ function renderNudge(payload) {
     },
   )
 
+  // read_record — ONE record in full, with what it sits inside and what sits inside it (Theron,
+  // 2026-10-07: "there's really no way to see what's inside a container"). Rendering: record_render.mjs.
+  server.registerTool(
+    'read_record',
+    {
+      title: 'Read one record in full',
+      description:
+        'Read ONE record by id: its full content as captured (a lecture or meeting transcript, a text thread, ' +
+        'an email\'s headers, a commit), the pages it is filed on, the container it sits inside (a class ' +
+        'session, a meeting), and, when it IS a container, every record inside it. Use it to open what ' +
+        'list_records, my_day or timeline_pull only summarize, and to walk a class session: read the session, ' +
+        'then read_record each id it lists. A record you may not read answers "not found", exactly like one ' +
+        'that does not exist.',
+      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`),
+      },
+    },
+    async ({ id, max_chars }) => {
+      let res
+      try {
+        res = await fetchCortex(`${BASE}/api/records/${encodeURIComponent(id)}`, { headers: { Authorization: `Bearer ${TOKEN}` } })
+      } catch (e) {
+        return toolError(`Could not read the record: ${e.message}`)
+      }
+      if (res.status === 404 || res.status === 400) return toolError(`No record ${id} that you can read.`)
+      if (!res.ok) {
+        const d = classify(res.status, res.headers.get('content-type'), await res.text(), res.headers.get('x-vercel-id'))
+        return toolError(`Could not read the record: ${d.message}`)
+      }
+      const body = await res.json().catch(() => null)
+      return { content: [{ type: 'text', text: withAskNotice(renderRecord(body?.record, max_chars)) }] }
+    },
+  )
+
   // ── custom sources: set up, list, re-home (Theron, 2026-09-29) ─────────────────────────────────
   // "I don't think it's that good of an idea to let the user do the whole setup without having an agent
   // involved." The agent can read the system being connected, describe what its data is ABOUT, and judge

package/package.json

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