@theronap/agnoclast-mcp 0.9.222 → 0.9.224

package/lib/series_render.mjs

@@ -0,0 +1,30 @@
+// update_series replies — pure, so every rendering has a test. The tool and its engine
+// (web/lib/engine/series_update.ts) exist because a series' container type could only be changed with
+// SQL until 2026-10-08 (Agnoclast page "Agent SQL gap").
+
+const OWES = {
+  meeting: 'owes a transcript or a note; closes 15 minutes after it ends',
+  work_block: 'owes a session in the window; closes when it ends',
+  deadline: 'owes the artifact; closes when it is due',
+  appointment: 'owes nothing (a class, a visit); admits a transcript or a note',
+}
+
+const line = (s) => `• ${s.title}  [${s.seriesKey}]  ${s.containerType ?? 'no container (a marker)'}${s.brain ? ` · ${s.brain}` : ''}`
+
+/** PATCH /api/series/<ref> 200 → text. */
+export function formatSeriesUpdated(r) {
+  if (r.from === r.to) return `${r.series.title} is already ${r.to} — nothing changed.`
+  return [
+    `${r.series.title} is now ${r.to} (was ${r.from}): ${OWES[r.to] ?? ''}.`,
+    `${r.containersRetyped} instance container(s) retyped${r.openContainersRetimed ? `, ${r.openContainersRetimed} still open with their close time recomputed` : ''}; instances made later open as ${r.to}.`,
+    'Containers that already closed keep the time they closed at.',
+  ].join('\n')
+}
+
+/** A refusal body (404 / 409 / 400) → text that lets the agent pick again. */
+export function formatSeriesRefusal(j) {
+  const L = [j?.message ?? j?.error ?? 'Not changed.']
+  if (j?.candidates?.length) L.push(j.error === 'ambiguous' ? 'Which one? Pass its key:' : 'Your series:', ...j.candidates.map(line))
+  else if (j?.error === 'not_found') L.push('You own no series. (A series is a recurring class or meeting made in Agnoclast.)')
+  return L.join('\n')
+}

package/lib/server.mjs

@@ -28,6 +28,7 @@ import { renderConversationOffer, renderMaterializeBatch } from './intake_batch_
 import { obligationsForUnits, renderFilingObligations, filingObligationsBrief, OBLIGATIONS_UNANSWERED_TEXT } from './filing_obligations.mjs'
 import { renderRecord, READ_RECORD_DEFAULT_CHARS, READ_RECORD_PARTS } from './record_render.mjs'
 import { formatCreated, formatDryRun, formatSources, homeFromArgs, pickSource, renderHomeProblem } from './custom_sources.mjs'
+import { formatSeriesRefusal, formatSeriesUpdated } from './series_render.mjs'
 import { formatSends } from './sends_render.mjs'
 
 // PAGE tiers (ADR-0071). Six for a PAGE; a RECORD keeps three (`privacy` on log_session and
@@ -4860,7 +4861,7 @@ function renderNudge(payload) {
         shape: z.enum(['message', 'event', 'document', 'record']).describe('message = emails, chats, replies · event = ticket changes, alerts, CRM updates · document = notes, transcripts, reports · record = rows, metrics, anything else'),
         purpose: z.enum(['communication', 'work', 'reference', 'metrics']).describe('sets defaults only'),
         sample: z.record(z.string(), z.any()).optional().describe('ONE real item, exactly as the system will send it (a JSON object)'),
-        mapping: z.record(z.string(), z.any()).optional().describe('which field plays which role, as dot paths into one item: { id, time, title, body, group, url, people: [..] }. Omit to have it suggested from the sample'),
+        mapping: z.record(z.string(), z.any()).optional().describe('which field plays which role, as dot paths into one item: { id, time, title, body, group, url, people: [..] } — plus, for items with deadlines, due, work_from (when to start) and done: then each item keeps one obligation that the source updates and closes. Omit to have it suggested from the sample'),
         mode: z.enum(['channel', 'ingest']).optional().describe('channel (default) = every item files onto one page as it arrives · ingest = each item waits in the pile to be sorted'),
         ...homeArgs,
         dry_run: z.boolean().optional().describe('true = show the mapping, the sample preview and the home (or the candidate pages) and create NOTHING. Do this first'),
@@ -4891,6 +4892,48 @@ function renderNudge(payload) {
     },
   )
 
+  server.registerTool(
+    'set_custom_source_mapping',
+    {
+      title: 'Change a custom source\'s field mapping',
+      description: 'Change which field of a custom source\'s pushed items plays which role — for a sender that learned to send more after it was set up. Pass the WHOLE mapping (read the current one with list_custom_sources first): { id, time, title, body, group, url, people: [..], due, work_from, done }. DEADLINES (2026-10-08): map `due` (when the item must be done) and, if the item says so, `work_from` (when work should start) and `done` (a field that is truthy once it is). Then each item with a deadline keeps ONE obligation for you on the source\'s home page — created on the next push, kept current on every push after, and discharged by the source itself when the item reports done; a machine proposal for the same work is folded into it. Nothing already late is created. The `id` field cannot change here: it decides what counts as the same item, and changing it would re-file everything as new — set up a new source instead.',
+      inputSchema: {
+        source: z.string().describe('the source — its id or its name, as list_custom_sources shows'),
+        mapping: z.record(z.string(), z.any()).describe('the whole mapping, role → dot path into one item'),
+      },
+    },
+    async (a) => {
+      let list
+      try {
+        const res = await fetchCortex(`${BASE}/api/custom-connectors`, { headers: { Authorization: `Bearer ${TOKEN}` } })
+        if (!res.ok) return cannot('Could not read your custom sources', res)
+        list = (await res.json()).connectors
+      } catch (e) {
+        return toolError(`Could not read your custom sources: ${e.message}`)
+      }
+      const picked = pickSource(list, a.source)
+      if (!picked.ok) return toolError(picked.message)
+      const src = picked.source
+      let res
+      try {
+        res = await fetchCortex(`${BASE}/api/custom-connectors/${encodeURIComponent(src.id)}/mapping`, {
+          method: 'PUT',
+          headers: { Authorization: `Bearer ${TOKEN}`, 'Content-Type': 'application/json' },
+          body: JSON.stringify({ mapping: a.mapping }),
+        })
+      } catch (e) {
+        return toolError(`Not changed: ${e.message}`)
+      }
+      if (!res.ok) return cannot('Not changed', res)
+      const j = await res.json()
+      const roles = Object.entries(j.mapping ?? {}).map(([k, v]) => `${k} ← ${Array.isArray(v) ? v.join(', ') : v}`).join(' · ')
+      const keeps = j.mapping?.due
+        ? '\nItems with a deadline now keep an obligation each — created on the next push, closed when the item reports done.'
+        : ''
+      return { content: [{ type: 'text', text: `${src.name} mapping: ${roles}${keeps}` }] }
+    },
+  )
+
   server.registerTool(
     'set_custom_source_home',
     {
@@ -4944,6 +4987,44 @@ function renderNudge(payload) {
     },
   )
 
+  // update_series — the user-parity sweep, 2026-10-08 (Theron: "things I think are totally working …
+  // that regular users can't do because all of my agents are querying the SQL directly"). A series'
+  // container type could only be changed with owner-connection SQL (2026-09-03, ENT 425). The sweep's
+  // other gap, editing a custom source's mapping, shipped in parallel as set_custom_source_mapping (#1438).
+  // Agnoclast page "Agent SQL gap".
+  server.registerTool(
+    'update_series',
+    {
+      title: 'Change a recurring series\' container type',
+      description: 'Change what a recurring class or meeting series (one made in Agnoclast) COLLECTS and OWES — its container type — for the whole series: the series itself and the container of every instance already made. meeting = owes a transcript or a note · work_block = owes a work session in the window · deadline = owes the artifact · appointment = owes nothing (a class, a visit) and still admits a transcript or a note. Use it when a series was typed wrong, e.g. a 3-hour lecture typed work_block, which flags every class as "nothing happened". Containers that already closed keep their close time. Name the series by its exact title, its key, or its id; an unknown or ambiguous name answers with your series to choose from.',
+      inputSchema: {
+        series: z.string().describe('the series — its exact title ("ENT 425"), its key (with or without "series:"), or its id'),
+        container_type: z.enum(['meeting', 'work_block', 'deadline', 'appointment']).describe('what it should collect and owe'),
+      },
+    },
+    async ({ series, container_type }) => {
+      const ref = String(series).trim().replace(/^series:/i, '')
+      let res
+      try {
+        res = await fetchCortex(`${BASE}/api/series/${encodeURIComponent(ref)}`, {
+          method: 'PATCH',
+          headers: { Authorization: `Bearer ${TOKEN}`, 'Content-Type': 'application/json' },
+          body: JSON.stringify({ containerType: container_type }),
+        })
+      } catch (e) {
+        return toolError(`Not changed: ${e.message}`)
+      }
+      if (!res.ok) {
+        const body = await res.text()
+        let j = null
+        try { j = JSON.parse(body) } catch { /* not JSON */ }
+        if (j && [400, 404, 409].includes(res.status)) return toolError(formatSeriesRefusal(j))
+        return toolError(`Not changed: ${classify(res.status, res.headers.get('content-type'), body, res.headers.get('x-vercel-id')).message}`)
+      }
+      return { content: [{ type: 'text', text: formatSeriesUpdated(await res.json()) }] }
+    },
+  )
+
   server.registerTool(
     'my_day',
     {

package/package.json

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