@theronap/agnoclast-mcp 0.9.229 → 0.9.231

package/lib/member_remove_render.mjs

@@ -27,3 +27,24 @@ export function renderRemoved(out, person) {
   for (const w of Array.isArray(out?.warnings) ? out.warnings : []) lines.push(`- ${one(w, 400)}`)
   return lines.join('\n')
 }
+
+// ── leave_brain (2026-10-12): the same two-call contract, said to the person who is leaving ──
+export function renderLeaveQuestion(out) {
+  const p = out?.preview ?? {}
+  const lines = [
+    `NOT LEFT — this needs the person's yes.${out?.stale ? ' (The picture changed since the last confirmation; this is the current one.)' : ''}`,
+    `Leave the brain "${one(p.brain, 80)}"? You lose your role there (${one(p.role, 40)}) and can no longer open anything in it.`,
+    'Your login, your other brains and everything you wrote stay. Nothing is deleted; someone in the brain can invite you back.',
+  ]
+  for (const s of Array.isArray(p.summary) ? p.summary : []) lines.push(one(s, 400).replace(/^Their /, 'Your '))
+  lines.push(`Tell the person exactly this and ask. Only if they say yes: leave_brain again with the same brain and confirm: "${one(out?.confirm_token, 40)}".`)
+  return lines.join('\n')
+}
+
+export function renderLeft(out) {
+  const lines = [out?.alreadyInactive
+    ? 'You had already left this brain — nothing more to do.'
+    : `You left "${one(out?.orgName, 80)}". You can no longer open anything in it.`]
+  for (const w of Array.isArray(out?.warnings) ? out.warnings : []) lines.push(`- ${one(w, 400)}`)
+  return lines.join('\n')
+}

package/lib/server.mjs

@@ -22,7 +22,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 { renderRemovalQuestion, renderRemoved } from './member_remove_render.mjs'
+import { renderLeaveQuestion, renderLeft, renderRemovalQuestion, renderRemoved } from './member_remove_render.mjs'
 import { renderSettings } from './settings_render.mjs'
 import { renderConversationOffer, renderMaterializeBatch } from './intake_batch_render.mjs'
 import { obligationsForUnits, renderFilingObligations, filingObligationsBrief, OBLIGATIONS_UNANSWERED_TEXT } from './filing_obligations.mjs'
@@ -3221,6 +3221,40 @@ function renderNudge(payload) {
     },
   )
 
+  // 2026-10-12. A member leaves a brain THEMSELVES — the remove_member path with the caller as the target.
+  server.registerTool(
+    'leave_brain',
+    {
+      title: 'Leave a brain',
+      description: "Take the person OUT of one of their own brains — ONLY when the person asked you to leave it. Never suggest or do it on your own. The FIRST call changes nothing: it answers with which brain, the role they would lose, and where every one of their pages would go (to a steward — usually their manager), plus a confirm token. Tell the person exactly that and ask. Only if they say yes, call again with the same `brain` and `confirm` set to that token. Never pass a confirm token the person has not just approved. Leaving is soft and per brain: their login, their other brains and everything they wrote stay; nothing is deleted. The last active owner of a brain cannot leave it — they must make another member an owner first.",
+      inputSchema: {
+        brain: z.string().optional().describe("which brain to leave — its name or org id (from my_brains). Required if the person belongs to more than one brain; if two of their brains share that name, pass the org id"),
+        confirm: z.string().optional().describe('ONLY after the person has seen what leaving does and said yes: the confirm token from the first call'),
+      },
+    },
+    async ({ brain, confirm }) => {
+      let res
+      try {
+        res = await fetchCortex(`${BASE}/api/members/leave`, {
+          method: 'POST',
+          headers: { Authorization: `Bearer ${TOKEN}`, 'Content-Type': 'application/json' },
+          body: JSON.stringify({ brain, confirm }),
+        })
+      } catch (e) { return toolError(`Could not reach Agnoclast: ${e.message}`) }
+      const out = await res.json().catch(() => null)
+      if (res.status === 409 && out?.error === 'confirm_leave') {
+        return { content: [{ type: 'text', text: renderLeaveQuestion(out) }] }
+      }
+      if (!res.ok) {
+        const cands = Array.isArray(out?.candidates) && out.candidates.length
+          ? ` Candidates: ${out.candidates.map((c) => `"${c.brain}" (org id ${c.orgId})`).join(', ')}.`
+          : ''
+        return toolError(`Not left: ${out?.detail ?? out?.error ?? res.status}${cands}`)
+      }
+      return { content: [{ type: 'text', text: renderLeft(out) }] }
+    },
+  )
+
   server.registerTool(
     'set_obligation_tier',
     {
@@ -5177,19 +5211,22 @@ function renderNudge(payload) {
       description: 'Set the CURRENCY of one of YOUR OWN authored pages so the brain can filter out stale info: "current" (reflects reality now — the default), "superseded" (replaced by a newer page — pass superseded_by with that page\'s name), or "historical" (kept for the record, no longer current). Optionally set modality: "reality" (as-built), "plan" (intended, not yet real), or "construction" (being built now). Call this the moment your understanding changes that a page is no longer the live truth — e.g. right after you author the new reality, mark the old page superseded. Owner-only.',
       inputSchema: {
         kind: z.enum(['project', 'person', 'org', 'user']).describe('the page kind'),
-        name: z.string().describe('the exact page name'),
+        name: z.string().optional().describe('the exact page name (or pass `ref` instead — one of the two is required)'),
+        ref: z.string().optional().describe('the page\'s stable id, printed as `ref:` by read_page. PREFER THIS over name when you have it: a ref is unique across brains, so it never hits ambiguous_page_name.'),
+        brain: z.string().optional().describe('optional: which brain the named page lives in, when the same name exists in several'),
         validity: z.enum(['current', 'superseded', 'historical']).describe('the currency state'),
         modality: z.enum(['reality', 'plan', 'construction']).optional().describe('what the page describes (optional)'),
         superseded_by: z.string().optional().describe('for superseded: the name of the page that replaced it'),
       },
     },
-    async ({ kind, name, validity, modality, superseded_by }) => {
+    async ({ kind, name, ref, brain, validity, modality, superseded_by }) => {
+      if (!name && !ref) return toolError('Could not set validity: pass `name` or `ref` (read_page prints the ref).')
       let res
       try {
         res = await fetchCortex(`${BASE}/api/brain/validity`, {
           method: 'POST',
           headers: { Authorization: `Bearer ${TOKEN}`, 'Content-Type': 'application/json' },
-          body: JSON.stringify({ kind, name, validity, modality, superseded_by }),
+          body: JSON.stringify({ kind, name, ref, brain, validity, modality, superseded_by }),
         })
       } catch (e) {
         return toolError(`Could not set validity: ${e.message}`)
@@ -5199,7 +5236,7 @@ function renderNudge(payload) {
         return toolError(`Could not set validity: ${d.message}`)
       }
       const out = await res.json()
-      return { content: [{ type: 'text', text: `Done — "${out.name}" is now ${out.validity}${out.modality ? ` / ${out.modality}` : ''} (${out.docs_updated} tier-doc(s) updated).` }] }
+      return { content: [{ type: 'text', text: `Done — "${out.name ?? out.ref}" (${out.brain ?? 'brain ?'}) is now ${out.validity}${out.modality ? ` / ${out.modality}` : ''} (${out.docs_updated} tier-doc(s) updated).` }] }
     },
   )
 

package/package.json

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