@theronap/agnoclast-mcp 0.9.250 → 0.9.252

package/lib/calendar_events.mjs

@@ -214,6 +214,29 @@ export function renderEventCreated(title, when, tz, body) {
 
 export const CREATE_EVENT_DESCRIPTION = 'Put an event on the person\'s calendar — a class, meeting, deadline, appointment or reminder — whenever they ask to add, schedule or put something on their calendar. Agnoclast is their calendar: use this rather than another calendar tool (such as Google Calendar) unless they name that other calendar. Give `start` as ISO 8601 (a time with no offset is read in their own timezone), an `end`, or `all_day: true` with a date. If they gave no end or length for a timed event, ASK how long before saving rather than leaving it open. For something that REPEATS weekly (a class, a standing meeting), call this ONCE with `repeat` {days, until} and `page`, e.g. start "2026-09-03T15:30", end "2026-09-03T16:45", repeat {days:["TU","TH"], until:"2026-12-10"}, page "STRAT 421" — never one call per meeting. It appears on their Agnoclast calendar and in `upcoming`; it is not copied to Google or Outlook and invites no one. To change it later, use update_event — never save a second copy.'
 
+export const UPDATE_EVENT_DESCRIPTION = 'Fix, move or cancel ONE event the person made on their Agnoclast calendar — a new time, an end or length, a new name or place, or `cancel: true` to take it off the calendar (one meeting of a repeating event too, e.g. no class on a holiday) — when they ask. Pass `event_id` (create_event and upcoming print it) and ONLY what changes. Moving the start keeps the event\'s length unless you also give `end`; a time with no offset is read in their own timezone. Pass "" as `end` or `location` to remove it. `cancel: false` puts a cancelled event back. To change or remove EVERY meeting of a repeating event, use update_series. Only events made on the Agnoclast calendar can be changed — never Google or Outlook ones.'
+
+export const UPDATE_SERIES_DESCRIPTION = 'Change or delete a whole repeating event (a class or standing meeting made in Agnoclast) when the person asks. Name it with `series`: its exact title, its key, or its id; an unknown or ambiguous name answers with the choices. Pass ONLY what changes: `days` (MO TU WE TH FR SA SU), `start_time` / `end_time` (HH:MM, their local time), `from` / `until` (YYYY-MM-DD), `location` ("" removes it), `title`. Changes apply from today on: meetings that already happened keep their time, and a meeting cancelled on its own stays cancelled. EXCEPTIONS by date (YYYY-MM-DD): `cancel_dates` skips those meetings (a holiday), `restore_dates` puts them back, `add_dates` adds one extra meeting on that day at the series\' own time (e.g. a Tuesday that runs a Monday schedule); a meeting moved by hand with update_event keeps its new time through any later change. `delete: true` removes the series and every upcoming meeting (past ones stay where they were filed). `container_type` changes what each meeting owes: meeting = a transcript or a note · work_block = a work session in the window · deadline = the artifact · appointment = nothing (a class, a visit). To change ONE meeting, use update_event instead.'
+
+/** PATCH /api/series/<ref> body for update_series, or null when nothing would change (event_time.ts seriesPatchBody). */
+export function seriesPatchBody(args) {
+  const body = {}
+  const str = (v) => (typeof v === 'string' ? v.trim() : undefined)
+  if (str(args.container_type)) body.containerType = str(args.container_type)
+  if (args.delete === true) body.delete = true
+  if (str(args.title)) body.title = str(args.title)
+  if (Array.isArray(args.days)) body.days = args.days
+  if (str(args.start_time)) body.startsTime = str(args.start_time)
+  if (str(args.end_time)) body.endsTime = str(args.end_time)
+  if (str(args.from)) body.windowFrom = str(args.from)
+  if (str(args.until)) body.windowUntil = str(args.until)
+  if (args.location !== undefined) body.location = str(args.location) || null
+  if (Array.isArray(args.cancel_dates) && args.cancel_dates.length) body.cancelDates = args.cancel_dates
+  if (Array.isArray(args.restore_dates) && args.restore_dates.length) body.restoreDates = args.restore_dates
+  if (Array.isArray(args.add_dates) && args.add_dates.length) body.addDates = args.add_dates
+  return Object.keys(body).length === 0 ? null : body
+}
+
 /** create_event's answer for a repeating event. */
 export function renderSeriesCreated(title, when, tz, body) {
   const n = body?.generated ?? 0
@@ -231,7 +254,47 @@ export function renderSeriesCreated(title, when, tz, body) {
   }
   if (body?.page?.title) lines.push(`Filed to the page "${oneLine(body.page.title, 120)}", so anything from those meetings lands there.`)
   lines.push(`It shows on ${CONSOLE}/calendar and in upcoming. Nothing was added to Google or Outlook, and no one was invited.`)
-  lines.push(`To move ONE meeting, use update_event with that meeting's event id from upcoming. Changing the whole series' days or times is not possible yet${body?.identifier ? ` (series ${body.identifier})` : ''}.`)
+  lines.push(`To change it later, use update_series${body?.identifier ? ` (series ${body.identifier})` : ''}: its days or times, cancel_dates for a holiday, add_dates for an extra meeting, or delete. update_event changes one meeting by its event id.`)
+  return lines.join('\n')
+}
+
+/** update_event with `cancel` (mcp_remote_render.ts renderEventCancelled). */
+export function renderEventCancelled(b) {
+  const t = oneLine(b?.title ?? 'the event', 200)
+  return b?.cancelled === false
+    ? `Restored "${t}": it is back on the Agnoclast calendar and in upcoming.`
+    : `Cancelled "${t}": it is off the Agnoclast calendar and upcoming. To put it back, call update_event with cancel: false. Nothing in Google or Outlook was touched.`
+}
+
+const DAY = { MO: 'Mon', TU: 'Tue', WE: 'Wed', TH: 'Thu', FR: 'Fri', SA: 'Sat', SU: 'Sun' }
+
+/** update_series edit / delete (mcp_remote_render.ts renderSeriesRevised). */
+export function renderSeriesRevised(r) {
+  const title = oneLine(r?.series?.title ?? 'the series', 200)
+  if (r?.deleted) {
+    return `Deleted the series "${title}": ${r.cancelled ?? 0} upcoming meeting(s) cancelled and off the calendar. Meetings that already happened stay where they were filed. Nothing in Google or Outlook was touched.`
+  }
+  if (!r?.changed?.length) return `Nothing to change: "${title}" already has that schedule.`
+  const s = r.schedule ?? {}
+  const names = (s.days ?? []).map((d) => DAY[d] ?? d)
+  const days = names.length > 1 ? `${names.slice(0, -1).join(', ')} and ${names[names.length - 1]}` : (names[0] ?? '')
+  const [h, m] = String(s.startsTime ?? '00:00').split(':').map(Number)
+  const clock = (mins) => new Intl.DateTimeFormat('en-US', { timeZone: 'UTC', hour: 'numeric', minute: '2-digit' }).format(new Date(Date.UTC(2000, 0, 1, 0, mins % 1440)))
+  const start = h * 60 + m
+  const window = s.windowUntil ? `${allDayLabel(String(s.windowFrom))} to ${allDayLabel(s.windowUntil)}` : `from ${allDayLabel(String(s.windowFrom))}, no end date`
+  const tz = s.timezone ?? 'UTC'
+  const lines = [
+    `Updated "${title}" (changed: ${r.changed.join(', ')}). Now every ${days}, ${clock(start)}–${clock(start + (s.durationMinutes ?? 0))}, ${window}${s.location ? `, at ${oneLine(s.location, 120)}` : ''} (${tz}).`,
+    `${r.upcoming ?? 0} upcoming meeting(s) on the calendar${r.firstStartsAt ? `; the next is ${dayLabel(new Date(r.firstStartsAt), tz)}, ${timeLabel(new Date(r.firstStartsAt), tz)}${r.firstEndsAt ? `–${timeLabel(new Date(r.firstEndsAt), tz)}` : ''}` : ''}.`,
+  ]
+  if (r.cancelled) lines.push(`${r.cancelled} meeting(s) no longer on the schedule were cancelled.`)
+  const d = r.dates ?? {}
+  const day = (ymd) => allDayLabel(ymd)
+  if (d.cancelled?.length) lines.push(`Cancelled: ${d.cancelled.map(day).join('; ')}.`)
+  if (d.restored?.length) lines.push(`Back on the calendar: ${d.restored.map(day).join('; ')}.`)
+  if (d.added?.length) lines.push(`Extra meeting added: ${d.added.map(day).join('; ')}.`)
+  if (d.skipped?.length) lines.push(`Not changed: ${d.skipped.map((x) => `${day(x.date)} (${x.why})`).join('; ')}.`)
+  lines.push('Meetings that already happened keep their time. Your exceptions (a cancelled, moved or added meeting) stay through any later change.')
   return lines.join('\n')
 }
 
@@ -273,5 +336,6 @@ export function updateEventBody(args) {
   if (args.end !== undefined) body.end = typeof args.end === 'string' && args.end.trim() ? args.end.trim() : null
   if (typeof args.all_day === 'boolean') body.allDay = args.all_day
   if (args.location !== undefined) body.location = typeof args.location === 'string' && args.location.trim() ? args.location.trim() : null
+  if (typeof args.cancel === 'boolean') body.cancel = args.cancel
   return Object.keys(body).length === 1 ? null : body
 }

package/lib/server.mjs

@@ -38,6 +38,7 @@ import { renderConversation, renderMessageInbox } from './messages_render.mjs'
 import {
   CREATE_EVENT_DESCRIPTION, captureEventBody, describeEventTime, describeSeriesPlacement, renderEventCreated, renderEventUpdated,
   renderSeriesCreated, renderUpcoming, resolveEventTimes, resolveSeriesPlacement, seriesRequestBody, updateEventBody,
+  UPDATE_EVENT_DESCRIPTION, UPDATE_SERIES_DESCRIPTION, renderEventCancelled, renderSeriesRevised, seriesPatchBody,
 } from './calendar_events.mjs'
 
 // PAGE tiers (ADR-0071). Six for a PAGE; a RECORD keeps three (`privacy` on log_session and
@@ -5509,33 +5510,51 @@ function renderNudge(payload) {
   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.',
+      title: 'Change or delete a repeating event',
+      description: UPDATE_SERIES_DESCRIPTION,
       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'),
+        delete: z.boolean().optional().describe('true removes the series and every upcoming meeting; past ones stay filed'),
+        title: z.string().optional().describe('a new name'),
+        days: z.array(z.string()).optional().describe('the days it meets now: MO TU WE TH FR SA SU'),
+        start_time: z.string().optional().describe('new start, HH:MM in their local time (e.g. "15:30")'),
+        end_time: z.string().optional().describe('new end, HH:MM in their local time'),
+        from: z.string().optional().describe('new first date, YYYY-MM-DD'),
+        until: z.string().optional().describe('new last date, YYYY-MM-DD'),
+        location: z.string().optional().describe('new place; "" removes it'),
+        container_type: z.enum(['meeting', 'work_block', 'deadline', 'appointment']).optional().describe('what each meeting owes'),
+        cancel_dates: z.array(z.string()).optional().describe('skip the meeting on these dates (YYYY-MM-DD) — e.g. a holiday'),
+        restore_dates: z.array(z.string()).optional().describe('put back a cancelled meeting on these dates'),
+        add_dates: z.array(z.string()).optional().describe('one extra meeting on each of these dates, at the series\' own time'),
       },
     },
-    async ({ series, container_type }) => {
-      const ref = String(series).trim().replace(/^series:/i, '')
+    async (args) => {
+      const ref = String(args.series ?? '').trim().replace(/^series:/i, '')
+      if (!ref) return toolError('series is required — its title, key or id.')
+      const body = seriesPatchBody(args)
+      if (!body) return toolError('Say what to change: days, start_time, end_time, from, until, location, title, container_type, cancel_dates, restore_dates, add_dates — or delete: true.')
       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 }),
+          body: JSON.stringify(body),
         })
       } catch (e) {
         return toolError(`Not changed: ${e.message}`)
       }
       if (!res.ok) {
-        const body = await res.text()
+        const text = await res.text()
         let j = null
-        try { j = JSON.parse(body) } catch { /* not JSON */ }
+        try { j = JSON.parse(text) } 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 toolError(`Not changed: ${classify(res.status, res.headers.get('content-type'), text, res.headers.get('x-vercel-id')).message}`)
       }
-      return { content: [{ type: 'text', text: formatSeriesUpdated(await res.json()) }] }
+      const out = await res.json()
+      const parts = []
+      if (out.from !== undefined) parts.push(formatSeriesUpdated(out))
+      if (out.revision) parts.push(renderSeriesRevised(out.revision))
+      return { content: [{ type: 'text', text: parts.join('\n\n') || 'Done.' }] }
     },
   )
 
@@ -5693,7 +5712,7 @@ function renderNudge(payload) {
     'update_event',
     {
       title: 'Change an event on my Agnoclast calendar',
-      description: "Fix or move an event the person made on their Agnoclast calendar — a new time, an end or length, a new name or place — when they ask. Pass `event_id` (create_event and upcoming print it) and ONLY what changes. Moving the start keeps the event's length unless you also give `end`; a time with no offset is read in their own timezone. Pass \"\" as `end` or `location` to remove it. Only events made on the Agnoclast calendar can be changed — never Google or Outlook ones — and this cannot cancel an event.",
+      description: UPDATE_EVENT_DESCRIPTION,
       inputSchema: {
         event_id: z.string().describe('the event id create_event or upcoming printed'),
         title: z.string().optional().describe('a new name'),
@@ -5701,12 +5720,13 @@ function renderNudge(payload) {
         end: z.string().optional().describe('new end, ISO 8601; "" removes the end'),
         all_day: z.boolean().optional().describe('true to make it all-day, false to make it timed (then give start)'),
         location: z.string().optional().describe('new place; "" removes it'),
+        cancel: z.boolean().optional().describe('true takes it off the calendar (one meeting of a repeating event too); false puts a cancelled one back'),
       },
     },
     async (args) => {
       if (!String(args.event_id ?? '').trim()) return toolError('event_id is required — create_event and upcoming print it.')
       const body = updateEventBody(args)
-      if (!body) return toolError('Say what to change: title, start, end, all_day or location.')
+      if (!body) return toolError('Say what to change: title, start, end, all_day, location, or cancel.')
       let res
       try {
         res = await fetchCortex(`${BASE}/api/events/update`, {
@@ -5719,6 +5739,7 @@ function renderNudge(payload) {
       if (res.status === 404) return toolError(b?.detail ? `Not changed: ${b.detail}` : 'No event of theirs on the Agnoclast calendar has that id.')
       if (res.status === 409 || res.status === 400) return toolError(`Not changed: ${b?.detail ?? b?.error ?? 'the request was refused'}`)
       if (!res.ok) return toolError(`Could not change the event: ${b?.error ?? res.status}${b?.detail ? ` — ${b.detail}` : ''}`)
+      if (typeof b?.cancelled === 'boolean') return { content: [{ type: 'text', text: renderEventCancelled(b) }] }
       return { content: [{ type: 'text', text: renderEventUpdated(b) }] }
     },
   )

package/package.json

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