@theronap/agnoclast-mcp 0.9.249 → 0.9.251

package/lib/calendar_events.mjs

@@ -214,6 +214,26 @@ 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. `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
+  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
@@ -235,6 +255,40 @@ export function renderSeriesCreated(title, when, tz, body) {
   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.`)
+  lines.push('Meetings that already happened keep their time. A meeting cancelled on its own with update_event stays cancelled.')
+  return lines.join('\n')
+}
+
 export function renderEventUpdated(b) {
   const changed = (b?.changed ?? []).filter((c) => ['title', 'start', 'end', 'location'].includes(c))
   const where = b?.location ? `, at ${oneLine(b.location, 120)}` : ''
@@ -273,5 +327,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
@@ -1951,7 +1952,7 @@ function renderNudge(payload) {
     {
       title: 'Ask to send an email from the user\'s mailbox (Gmail or Outlook)',
       description:
-        'Send an email from the USER\'S OWN connected mailbox, Gmail or Outlook. By default this does NOT send immediately: it creates a request that WAITS for the user to approve it in Agnoclast, and it goes out at once only if their own send rule allows it. The message is frozen when the request is made, so write the final wording. Always show the user what you are about to send and get their agreement first. Returns either an approval link to relay to them, or confirmation that it already went. ⚠ NEVER call this twice for the same email — it is not idempotent, and a retry can send twice.',
+        'Send an email from the USER\'S OWN connected mailbox, Gmail or Outlook. By default this does NOT send immediately: it creates a request that WAITS for the user to approve it in Agnoclast, and it goes out at once only if their own send rule allows it. The message is frozen when the request is made, so write the final wording. Always show the user what you are about to send and get their agreement first. Returns either an approval link to relay to them, or confirmation that it already went. ⚠ NEVER call this twice for the same email — it is not idempotent, and a retry can send twice. IF YOU ARE AN AI AGENT WITH YOUR OWN IDENTITY (a member agent): you send from YOUR OWN address, labelled as an AI agent of your owner, and one of your overseers approves unless their rule for you allows it; a line saying an AI wrote it is added for you. Pass from: \'overseer\' only if an overseer has opened their mailbox to you.',
       inputSchema: {
         to: z.array(z.string()).min(1).describe('recipient email addresses'),
         subject: z.string().min(1).describe('the subject line'),
@@ -1961,9 +1962,11 @@ function renderNudge(payload) {
         replyToRecordId: z.string().optional().describe('reply in the thread of this Agnoclast email record'),
         replyToMessageId: z.string().optional().describe('reply in the thread of this message id (Gmail or Outlook)'),
         account: z.string().email().optional().describe('which connected mailbox (Gmail or Outlook) to send from, when the user has more than one'),
+        from: z.enum(['own', 'overseer']).optional().describe("AI member agents only: 'own' (default) = your own address; 'overseer' = the mailbox an overseer opened to you"),
+        brain: z.string().optional().describe('AI member agents only: which brain this email is for, when you are in more than one'),
       },
     },
-    async ({ to, subject, text, cc, bcc, replyToRecordId, replyToMessageId, account }) => {
+    async ({ to, subject, text, cc, bcc, replyToRecordId, replyToMessageId, account, from, brain }) => {
       let res
       try {
         res = await fetchCortex(`${BASE}/api/gmail/send-requests`, {
@@ -1975,6 +1978,8 @@ function renderNudge(payload) {
             ...(replyToRecordId ? { replyToRecordId } : {}),
             ...(replyToMessageId ? { replyToMessageId } : {}),
             ...(account ? { account } : {}),
+            ...(from ? { from } : {}),
+            ...(brain ? { brain } : {}),
           }),
         }, { idempotent: false, retries: 0 })
       } catch (e) {
@@ -1991,6 +1996,12 @@ function renderNudge(payload) {
       const reviewUrl = body?.reviewUrl
       const acct = body?.request?.account ?? 'your mailbox'
       const n = body?.request?.recipientCount ?? to.length
+      // ADR-0092: a member agent's request waits for one of its OVERSEERS, not for "you".
+      if (reviewUrl && body?.waitingFor) {
+        return { content: [{ type: 'text', text:
+          `Email request created from ${acct} to ${n} recipient${n === 1 ? '' : 's'}. It is NOT sent yet: it waits for ` +
+          `${body.waitingFor} to approve it in Agnoclast (${reviewUrl}). Do not send it again.` }] }
+      }
       if (reviewUrl) {
         // Relayed VERBATIM — this exact sentence is the contract the create route records.
         return { content: [{ type: 'text', text:
@@ -5499,33 +5510,48 @@ 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'),
       },
     },
-    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 — 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.' }] }
     },
   )
 
@@ -5683,7 +5709,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'),
@@ -5691,12 +5717,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`, {
@@ -5709,6 +5736,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.249",
+  "version": "0.9.251",
   "description": "Connect your AI assistant to Cortex — your org's projects, activity, gaps, and directives, scoped to you.",
   "type": "module",
   "bin": {