@theronap/agnoclast-mcp 0.9.208 → 0.9.209

package/lib/server.mjs

@@ -5515,9 +5515,10 @@ function renderNudge(payload) {
         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 addresses exactly one page and never needs a brain to disambiguate it.'),
         to: z.string().describe('who becomes the owner — an org member\'s email, or their user id. Must be an ACTIVE member of the same brain as the page. Pass your own address to take ownership yourself.'),
         confirm_audience: z.string().optional().describe('ONLY after a refusal that lists who would start reading the page. A reports / peers / down page is addressed to its OWNER\'s team, so a new owner means a new audience; the first call is refused with the names and a confirm token. Pass that token here once the person asking has seen the list and means it. The token covers exactly that list — if the page or the org chart changed since, it is refused again with the new one. Never guess it and never send it on a first call.'),
+        tier_decision: z.enum(['keep', 'delegate', 'accessible', 'down', 'reports', 'peers', 'scoped', 'confidential']).optional().describe('REQUIRED for a reports / peers / down page (Theron, 2026-10-03: whoever hands one over re-evaluates its tier then and there). "keep" = same tier, re-aimed at the new owner\'s team; a tier = owner and tier change together; "delegate" = the new owner decides, and until they do NOTHING about the page changes — same owner, same readers — while they may read it to decide. Ask the person which they want; never pick one for them. Omit it for any other tier (it transfers as before).'),
       },
     },
-    async ({ kind, name, ref, to, confirm_audience }) => {
+    async ({ kind, name, ref, to, confirm_audience, tier_decision }) => {
       let res
       try {
         res = await fetchCortex(`${BASE}/api/brain/node-policy`, {
@@ -5525,7 +5526,7 @@ function renderNudge(payload) {
           headers: { Authorization: `Bearer ${TOKEN}`, 'Content-Type': 'application/json' },
           // No `tier`: a node has exactly one page (ADR-0064 §4), and the route resolves it. Sending a
           // guessed tier is how this used to 404 on precisely the scoped/confidential pages it matters for.
-          body: JSON.stringify({ kind, ...(name ? { name } : {}), ...(ref ? { ref } : {}), transfer_to: to, ...(confirm_audience ? { confirm_audience } : {}) }),
+          body: JSON.stringify({ kind, ...(name ? { name } : {}), ...(ref ? { ref } : {}), transfer_to: to, ...(confirm_audience ? { confirm_audience } : {}), ...(tier_decision ? { tier_decision } : {}) }),
         })
       } catch (e) {
         return toolError(`Could not transfer ownership: ${e.message}`)
@@ -5538,10 +5539,21 @@ function renderNudge(payload) {
         const d = classify(res.status, res.headers.get('content-type'), '', res.headers.get('x-vercel-id'))
         return toolError(`Could not transfer ownership: ${d.message}`)
       }
+      if (out?.pending_for) {
+        return {
+          content: [{
+            type: 'text',
+            text: `Handed over for re-evaluation — ${to} decides this page's tier. Nothing about the page has changed: it is still ${out.tier}, owned and read exactly as before, until they choose.${out.reader_granted ? ' They were given read access so they can decide.' : ''} They see it at their next session start and complete it with confirm_page_ownership.`,
+          }],
+        }
+      }
+      const retier = out?.retiered
+        ? ` It moved from ${out.retiered.from} to ${out.retiered.to} in the same step${out.retiered.cascaded_records ? `; ${out.retiered.cascaded_records} record(s) filed under it followed the narrowing` : ''}.`
+        : ` The page is still ${out.tier}${tier_decision === 'keep' ? ', now addressed to its new owner\'s team' : '; transferring at this tier does not re-tier, so check that its audience is still right'}.`
       return {
         content: [{
           type: 'text',
-          text: `Done — ${name ?? out.ref} now belongs to ${to}. The page is still ${out.tier}; transferring never re-tiers, so check that its audience is still right.${renderAudienceChange(out.audience_change)}`,
+          text: `Done — ${name ?? out.ref} now belongs to ${to}.${retier}${renderAudienceChange(out.audience_change)}`,
         }],
       }
     },
@@ -5555,13 +5567,39 @@ function renderNudge(payload) {
     'confirm_page_ownership',
     {
       title: 'Confirm pages handed to you',
-      description: 'When someone hands you a page — a colleague using transfer_page_ownership, or a steward rehoming a departed member\'s page — your session start lists it under "Pages handed to you" until you confirm it. Pass the page `refs` (as listed there) to confirm those, or `all: true` for every open one. Confirming only clears the notice: the page is already yours. To pass one on instead, use transfer_page_ownership.',
+      description: 'When someone hands you a page — a colleague using transfer_page_ownership, or a steward rehoming a departed member\'s page — your session start lists it under "Pages handed to you" until you confirm it. Pass the page `refs` (as listed there) to confirm those, or `all: true` for every open one. Confirming only clears the notice: the page is already yours. To pass one on instead, use transfer_page_ownership. A page listed under "Pages waiting on your tier decision" is DIFFERENT: it is not yours yet, and stays exactly as it was until you choose. Take it with `ref` + `tier_decision` ("keep" its tier, re-aimed at your team, or a tier); `all` never takes those.',
       inputSchema: {
         refs: z.array(z.string()).optional().describe('page refs, as listed under "Pages handed to you"'),
-        all: z.boolean().optional().describe('true = confirm every open notice'),
+        all: z.boolean().optional().describe('true = confirm every open notice (never takes a page waiting on your tier decision)'),
+        ref: z.string().optional().describe('ONE page waiting on your tier decision, as listed under "Pages waiting on your tier decision"'),
+        tier_decision: z.enum(['keep', 'accessible', 'down', 'reports', 'peers', 'scoped', 'confidential']).optional().describe('with `ref`: "keep" its tier (re-aimed at your team) or the tier it should have. Ask the person; never choose for them.'),
+        confirm_audience: z.string().optional().describe('ONLY after a refusal listing who would start reading the page — the token from it, once the person has seen the list and means it.'),
       },
     },
-    async ({ refs, all }) => {
+    async ({ refs, all, ref, tier_decision, confirm_audience }) => {
+      if (ref || tier_decision) {
+        if (!ref || !tier_decision) return toolError('To take a page waiting on your tier decision, pass both `ref` and `tier_decision`.')
+        let res
+        try {
+          res = await fetchCortex(`${BASE}/api/brain/ownership-notices`, {
+            method: 'POST',
+            headers: { Authorization: `Bearer ${TOKEN}`, 'Content-Type': 'application/json' },
+            body: JSON.stringify({ ref, tier_decision, ...(confirm_audience ? { confirm_audience } : {}) }),
+          })
+        } catch (e) {
+          return toolError(`Could not take the page: ${e.message}`)
+        }
+        const out = await res.json().catch(() => null)
+        if (!res.ok) {
+          if (out?.error) return toolError(`Could not take the page: ${out.error}`)
+          const d = classify(res.status, res.headers.get('content-type'), '', res.headers.get('x-vercel-id'))
+          return toolError(`Could not take the page: ${d.message}`)
+        }
+        const moved = out?.from_tier && out.from_tier !== out.tier
+          ? ` It moved from ${out.from_tier} to ${out.tier}${out.cascaded_records ? `; ${out.cascaded_records} record(s) filed under it followed the narrowing` : ''}.`
+          : ` It stays ${out?.tier}, now addressed to your team.`
+        return { content: [{ type: 'text', text: `Done — the page is yours.${moved}${renderAudienceChange(out?.audience_change)}` }] }
+      }
       if (!all && !(refs && refs.length)) return toolError('Pass `refs` (the pages to confirm) or `all: true`.')
       let res
       try {

package/package.json

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