@theronap/agnoclast-mcp 0.9.200 → 0.9.202

package/lib/server.mjs

@@ -20,6 +20,7 @@ import { repoFullNameFrom, workingFilesFrom } from './capture.mjs'
 import { findTranscript, createWorkedFilesTracker } from './working_files.mjs'
 import { spawnObligationWorker } from './obligations_worker.mjs'
 import { renderObligations, renderPageObligations, tierReads, who } from './obligations_render.mjs'
+import { renderSettings } from './settings_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
@@ -2837,57 +2838,8 @@ function renderNudge(payload) {
     },
   )
 
-  server.registerTool(
-    'obligations_from_calendar',
-    {
-      title: 'Meetings that ended and were never written up',
-      description: 'Turn meetings that have already ENDED into "capture what came out of this" obligations. ⚠ THE OBLIGATION IS NOT "ATTEND" — your calendar already does that, and putting every scheduled meeting into your obligations list would bury it (90 of 120 calendar records are recurring birthdays). The gap this fills is real and documented: meeting substance lands wherever the session that heard about it happened to be working, and a walkthrough with no note at all is the normal outcome. ⚠ DRY-RUN BY DEFAULT — it reports what it WOULD create, including every meeting it skipped and why, and writes nothing until apply: true. Excluded on purpose: meetings with no attendee but you (a birthday or a solo hold owes nobody anything), all-day markers, cancelled events, anything with no recorded end, and anything outside the lookback window — no backfill, because obligations nobody will ever action are how a list stops being read. Each one is discharged by a captured transcript ARRIVING, never by one being absent.',
-      inputSchema: {
-        lookback_days: z.number().optional().describe('how far back to sweep (default 14, max 90)'),
-        apply: z.boolean().optional().describe('false/absent = dry run (default). true actually creates them.'),
-      },
-    },
-    async ({ lookback_days, apply }) => {
-      let res
-      try {
-        res = await fetchCortex(`${BASE}/api/obligations/from-calendar`, {
-          method: 'POST',
-          headers: { Authorization: `Bearer ${TOKEN}`, 'Content-Type': 'application/json' },
-          body: JSON.stringify({ lookbackDays: lookback_days, apply: apply === true }),
-        })
-      } catch (e) { return toolError(`Could not reach the producer: ${e.message}`) }
-      const out = await res.json().catch(() => null)
-      if (!res.ok) return toolError(`Could not run: ${out?.error ?? res.status}`)
-
-      const cands = out?.candidates ?? []
-      const eligible = cands.filter((c) => !c.skipped)
-      const lines = []
-      if (out.mode === 'dry-run') {
-        lines.push(`DRY RUN \u2014 nothing written. ${out.scanned} meeting(s) scanned, ${eligible.length} would become obligations.`)
-      } else {
-        lines.push(`${out.created} obligation(s) created from ${out.scanned} meeting(s) scanned.`)
-      }
-      if (eligible.length) {
-        lines.push('', 'Would track:')
-        for (const c of eligible.slice(0, 15)) {
-          lines.push(`  ${c.endedAt.slice(0, 10)}  ${c.title ?? '(untitled)'}  \u2014 ${c.attendees.length} attendee(s)`)
-        }
-      }
-      // \u26a0 THE SKIPS ARE PRINTED, NOT SUMMARISED AWAY. A producer that silently drops most of its
-      // input reads as "there was nothing to do", which is indistinguishable from a broken filter.
-      const skipped = cands.filter((c) => c.skipped)
-      if (skipped.length) {
-        const byReason = {}
-        for (const c of skipped) byReason[c.skipped] = (byReason[c.skipped] ?? 0) + 1
-        lines.push('', `Skipped ${skipped.length}:`)
-        for (const [reason, n] of Object.entries(byReason).sort((a, b) => b[1] - a[1])) {
-          lines.push(`  ${n}  ${reason}`)
-        }
-      }
-      if (out.mode === 'dry-run' && eligible.length) lines.push('', 'Re-run with apply: true to create them.')
-      return { content: [{ type: 'text', text: lines.join('\n') }] }
-    },
-  )
+  // `obligations_from_calendar` was removed in 0.9.201 (2026-10-02): meetings no longer create
+  // obligations by themselves. The server answers 410 to older clients that still offer it.
 
   server.registerTool(
     'my_obligations',
@@ -3029,6 +2981,58 @@ function renderNudge(payload) {
     },
   )
 
+  // ADR-0074 — a person's own settings. The August 2026 ruling is "notices are on by default, and you
+  // turn one off by telling the assistant"; these two tools are how the assistant does that.
+  server.registerTool(
+    'my_settings',
+    {
+      title: 'My settings',
+      description: "The person's own Agnoclast settings: which notices they get without asking (meetings about to start, deadlines within the hour, what is due today, hand-offs, lapses) and their timezone. The same settings as the Settings page in the console. Read this before answering \"why am I (not) being told about X\".",
+      inputSchema: {},
+    },
+    async () => {
+      let res
+      try {
+        res = await fetchCortex(`${BASE}/api/settings`, { headers: { Authorization: `Bearer ${TOKEN}` } })
+      } catch (e) { return toolError(`Could not reach settings: ${e.message}`) }
+      const out = await res.json().catch(() => null)
+      if (!res.ok) return toolError(`Could not read settings: ${out?.detail ?? out?.error ?? res.status}`)
+      return { content: [{ type: 'text', text: renderSettings(out) }] }
+    },
+  )
+
+  server.registerTool(
+    'set_setting',
+    {
+      title: 'Change one of my settings',
+      description: "Change one of the person's own settings — ONLY when they asked you to (\"stop telling me what's due today\", \"set my timezone to Denver\"). Never on your own initiative, and never to quiet something you find noisy: a notice the person did not turn off is one they rely on. Pass `key` and `value` for a notice (keys from my_settings, e.g. notices.due_today = false), or `timezone` alone with an IANA name such as America/Denver. Say what you changed, and that they can change it back in Settings.",
+      inputSchema: {
+        key: z.string().optional().describe('the setting, exactly as my_settings lists it, e.g. notices.due_today'),
+        value: z.boolean().optional().describe('true = on, false = off'),
+        timezone: z.string().optional().describe('instead of key/value: an IANA timezone, e.g. America/Denver'),
+      },
+    },
+    async ({ key, value, timezone }) => {
+      const body = timezone ? { timezone } : { key, value }
+      let res
+      try {
+        res = await fetchCortex(`${BASE}/api/settings`, {
+          method: 'POST',
+          headers: { Authorization: `Bearer ${TOKEN}`, 'Content-Type': 'application/json' },
+          body: JSON.stringify(body),
+        })
+      } catch (e) { return toolError(`Could not reach settings: ${e.message}`) }
+      const out = await res.json().catch(() => null)
+      if (!res.ok) return toolError(`Not changed: ${out?.detail ?? out?.error ?? res.status}`)
+      const text = timezone
+        ? `Timezone set to ${out.timezone} on ${out.memberships} brain${out.memberships === 1 ? '' : 's'}. They can change it in Settings.`
+        : !out.changed
+          ? `${out.key} was already ${out.value ? 'on' : 'off'} — nothing changed.`
+          : `${out.key} is now ${out.value ? 'ON' : 'OFF'}. They can turn it back ${out.value ? 'off' : 'on'} in Settings (or ask you).`
+      return { content: [{ type: 'text', text }] }
+    },
+  )
+
   server.registerTool(
     'set_obligation_tier',
     {

package/lib/settings_render.mjs

@@ -0,0 +1,21 @@
+// PURE: what my_settings prints (ADR-0074). Out of server.mjs so a test can reach it.
+//
+// Says ON/OFF per notice with the person's own words for it, and names the default when a setting has
+// been changed from it — "off (default on)" is the line that answers "why am I not hearing about X?".
+const one = (s) => String(s ?? '').replace(/\s+/g, ' ').trim().slice(0, 160)
+
+export function renderSettings(view) {
+  const settings = Array.isArray(view?.settings) ? view.settings : []
+  const lines = ['NOTICES — what Agnoclast tells this person without being asked (sessions and desktop):']
+  for (const s of settings) {
+    const state = s.value ? 'ON ' : 'OFF'
+    const changed = s.value !== s.default ? `  (changed — default ${s.default ? 'on' : 'off'})` : ''
+    lines.push(`  ${state}  ${one(s.key)} — ${one(s.label)}${changed}`)
+  }
+  if (!settings.length) lines.push('  (none returned — the server may predate settings)')
+  lines.push('')
+  lines.push(`TIMEZONE: ${view?.timezone ? one(view.timezone) : 'not set'}`)
+  lines.push('')
+  lines.push('Change one only when the person asks: set_setting. They can also change these in Settings (console avatar menu, or ⌘, in the desktop app).')
+  return lines.join('\n')
+}

package/package.json

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