@theronap/agnoclast-mcp 0.9.223 → 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
@@ -4986,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.223",
+  "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": {