@theronap/agnoclast-mcp 0.9.198 → 0.9.199

package/lib/arrivals_notice.mjs

@@ -64,6 +64,8 @@ const MAX_YOURS = 25
 // session's context. One line, bounded, and quoted so it reads as the name of a thing.
 const named = (s) => `“${String(s ?? '').replace(/\s+/g, ' ').trim().slice(0, 120) || '(untitled)'}”`
 const mins = (n) => `${n} min`
+// A person's name, as someone else typed it into a profile: one line, bounded, never quoted as a title.
+const who = (s) => String(s ?? '').replace(/\s+/g, ' ').trim().slice(0, 60) || 'Someone'
 
 /**
  * ⏰ PRESSING — what is about to start or come due (2026-10-02).
@@ -99,6 +101,15 @@ export function formatPressing(pressing) {
       const more = count > names.length ? ` … and ${count - names.length} more` : ''
       lines.push(`⏰ Due today (${count}): ${names.join(' · ')}${more}`)
     }
+    // ADR-0073 §2.7 — a hand-off, said once to the one person it concerns. Names and notes are other
+    // people's text: quoted and bounded like every title above.
+    else if (p?.kind === 'asked') {
+      lines.push(`📥 ${who(p.from)} asks you to take: ${named(p.text)}${p.note ? ` — their note: ${named(p.note)}` : ''}. NOT yours until you accept — \`answer_obligation_request\` (${p.obligationId})`)
+    } else if (p?.kind === 'given') {
+      lines.push(`📥 ${who(p.from)} gave you: ${named(p.text)} — it is yours now. (${p.obligationId})`)
+    } else if (p?.kind === 'declined') {
+      lines.push(`↩ ${who(p.by)} DECLINED ${named(p.text)}: ${named(p.reason)}. It is still yours. (${p.obligationId})`)
+    }
     // ⚠ NO OVERDUE LINE, DELIBERATELY. Everything dated is raised once BEFORE it lapses; a daily
     // "Overdue (14)" could only repeat, and repeating finished work is how a reader learns to skip
     // the line that carries the meeting. The overdue pile is `my_obligations`, when someone asks.
@@ -118,7 +129,8 @@ export function pressingAcks(pressing) {
   const out = []
   for (const p of Array.isArray(pressing) ? pressing : []) {
     if (typeof p?.subject !== 'string' || typeof p?.bucket !== 'string') continue
-    if (p.kind === 'event' || p.kind === 'due_soon' || (p.kind === 'due_today' && Number(p.count) > 0)) {
+    const handoff = p.kind === 'asked' || p.kind === 'given' || p.kind === 'declined'
+    if (p.kind === 'event' || p.kind === 'due_soon' || handoff || (p.kind === 'due_today' && Number(p.count) > 0)) {
       out.push({ subject: p.subject, bucket: p.bucket })
     }
   }

package/lib/obligations_render.mjs

@@ -16,8 +16,47 @@
 // only at `overdueAfter` (the next local midnight). Without `overdueAfter`, the old rule — overdue at
 // dueAt — would call an all-day deadline OVERDUE from the first minute of its own day. A server older
 // than these fields sends neither, and gets exactly the old output.
-export function renderObligations(obs, now = Date.now()) {
-  if (!obs?.length) return 'Nothing open.'
+// ADR-0073 §2.7 — TWO THINGS THAT ARE NOT "WHAT I OWE" AND MUST NOT READ AS IF THEY WERE.
+//   requests  asked of this person, waiting for their answer. Not theirs until they accept.
+//   asked     what this person asked of others: still waiting, declined (with the reason), or taken.
+// They get their own sections, after the list, so "N open" stays the count of what is actually owed.
+// A server older than hand-offs sends neither key, and the output is exactly what it was.
+const quoted = (s) => `“${String(s ?? '').replace(/\s+/g, ' ').trim().slice(0, 140)}”`
+// A person's name is text someone typed into their own profile. One line, bounded — the same treatment
+// as a subject, without the quotes. Exported: every obligation tool that prints a name uses it.
+export const who = (s) => String(s ?? '').replace(/\s+/g, ' ').trim().slice(0, 60) || 'someone'
+
+export function renderHandoffs(extras) {
+  const requests = Array.isArray(extras?.requests) ? extras.requests : []
+  const asked = Array.isArray(extras?.asked) ? extras.asked : []
+  const lines = []
+  if (requests.length) {
+    lines.push(`ASKED OF YOU — ${requests.length} waiting for your answer. Not yours until you accept:`)
+    for (const r of requests) {
+      lines.push(`${r.obligationId}`)
+      lines.push(`  ${who(r.from)} asks you to take: ${quoted(r.subject)}${r.dueAt ? `  — due ${String(r.dueAt).slice(0, 10)}` : ''}`)
+      if (r.note) lines.push(`  their note: ${quoted(r.note)}`)
+    }
+    lines.push('  → answer_obligation_request (accept: true, or accept: false with a reason). Ask the person; do not answer for them.')
+    lines.push('')
+  }
+  const waiting = asked.filter((a) => a.state === 'pending')
+  const declined = asked.filter((a) => a.state === 'declined')
+  const taken = asked.filter((a) => a.state === 'accepted' || a.state === 'assigned')
+  if (waiting.length || declined.length || taken.length) {
+    lines.push('YOU ASKED:')
+    for (const a of declined) lines.push(`  ✗ ${who(a.to)} DECLINED ${quoted(a.subject)} — ${quoted(a.response)}. It is still yours.  (${a.obligationId})`)
+    for (const a of waiting) lines.push(`  … waiting on ${who(a.to)}: ${quoted(a.subject)} — still yours until they accept.  (${a.obligationId})`)
+    for (const a of taken.slice(0, 8)) lines.push(`  ✓ ${who(a.to)} now owes ${quoted(a.subject)}  (${a.obligationId})`)
+    if (taken.length > 8) lines.push(`  … and ${taken.length - 8} more taken`)
+    lines.push('')
+  }
+  return lines
+}
+
+export function renderObligations(obs, now = Date.now(), extras = null) {
+  const handoffs = renderHandoffs(extras)
+  if (!obs?.length) return handoffs.length ? ['Nothing open of your own.', '', ...handoffs].join('\n') : 'Nothing open.'
   const proposed = obs.filter((o) => o.state === 'proposed').length
   // ADR-0073: every obligation lives on a page. `needsPage` is sent only by a server that knows the
   // rule, so against an older one this count is zero and the output is exactly what it was.
@@ -39,6 +78,9 @@ export function renderObligations(obs, now = Date.now()) {
     const pages = Array.isArray(o.pages) ? o.pages.filter((p) => p?.origin !== 'fallback') : []
     if (pages.length) lines.push(`  on: ${pages.slice(0, 4).map((p) => `“${String(p.title ?? '').replace(/\s+/g, ' ').trim().slice(0, 60)}”`).join(' · ')}${pages.length > 4 ? ` … and ${pages.length - 4} more` : ''}`)
     if (o.needsPage === true) lines.push('  ⚠ on no page anyone chose — set_obligation_pages')
+    // Whose idea it was, and whether it is on its way to someone else. Both change what to DO with it.
+    if (o.askedBy) lines.push(`  asked for by ${who(o.askedBy)}`)
+    if (o.offeredTo) lines.push(`  offered to ${who(o.offeredTo)} — waiting for their answer; still yours until they accept`)
     // ⚠ EVIDENCE IS RENDERED AS A QUESTION, NEVER AS A VERDICT. The phrasing is the feature:
     // "is this done?" costs the reader a second, "you still owe this" about finished work costs
     // the channel its credibility.
@@ -50,6 +92,7 @@ export function renderObligations(obs, now = Date.now()) {
     }
     lines.push('')
   }
+  lines.push(...handoffs)
   return lines.join('\n')
 }
 

package/lib/server.mjs

@@ -19,7 +19,7 @@ import { runCodeGraphQuery } from './code_graph_cli.mjs'
 import { repoFullNameFrom, workingFilesFrom } from './capture.mjs'
 import { findTranscript, createWorkedFilesTracker } from './working_files.mjs'
 import { spawnObligationWorker } from './obligations_worker.mjs'
-import { renderObligations } from './obligations_render.mjs'
+import { renderObligations, who } from './obligations_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
@@ -2910,7 +2910,7 @@ function renderNudge(payload) {
       const out = await res.json().catch(() => null)
       if (!res.ok) return toolError(`Could not list: ${out?.error ?? res.status}`)
       const obs = out?.obligations ?? []
-      return { content: [{ type: 'text', text: renderObligations(obs) }] }
+      return { content: [{ type: 'text', text: renderObligations(obs, Date.now(), { requests: out?.requests, asked: out?.asked }) }] }
     },
   )
 
@@ -2922,19 +2922,21 @@ function renderNudge(payload) {
       inputSchema: {
         subject: z.string().describe('what is owed, in your own words'),
         pages: z.array(z.string()).min(1).describe('REQUIRED. The `ref:` of each page this obligation is about, exactly as read_page prints it. Read the page first; do not guess.'),
+        for: z.string().optional().describe('ONLY when it is someone ELSE who should owe this: their email address, or their name as it appears in this brain. Omit for something the person owes themselves. You do not choose whether it is assigned or requested — the reporting line does.'),
+        note: z.string().optional().describe('with `for`: a short note to the person it is given to'),
         due_at: z.string().optional().describe('ISO 8601. OMIT when there is no real deadline — never guess one.'),
         anchor_identifier: z.string().optional().describe('e.g. "email:ben@example.com" — records from them become evidence this may be done'),
         source_record_id: z.string().optional().describe('the record this came from, if any'),
         brain: z.string().optional().describe('required only if you belong to more than one brain'),
       },
     },
-    async ({ subject, pages, due_at, anchor_identifier, source_record_id, brain }) => {
+    async ({ subject, pages, due_at, anchor_identifier, source_record_id, brain, for: giveTo, note: giveNote }) => {
       let res
       try {
         res = await fetchCortex(`${BASE}/api/obligations`, {
           method: 'POST',
           headers: { Authorization: `Bearer ${TOKEN}`, 'Content-Type': 'application/json' },
-          body: JSON.stringify({ subject, pages, dueAt: due_at, anchorIdentifier: anchor_identifier, sourceRecordId: source_record_id, brain }),
+          body: JSON.stringify({ subject, pages, dueAt: due_at, anchorIdentifier: anchor_identifier, sourceRecordId: source_record_id, brain, for: giveTo, note: giveNote }),
         })
       } catch (e) { return toolError(`Could not reach obligations: ${e.message}`) }
       const out = await res.json().catch(() => null)
@@ -2948,10 +2950,76 @@ function renderNudge(payload) {
         ? `\nRecords carrying ${anchor_identifier} will be offered as evidence this is done. ${nudge}`
         : `\n${nudge}`
       const on = Number(out.pages) > 0 ? ` — on ${out.pages} page${out.pages === 1 ? '' : 's'}` : ''
+      // Given to someone else: say plainly which of the two things happened. "Assigned" and "asked"
+      // leave the obligation with different people, and the agent must not report one as the other.
+      if (out.given) {
+        const what = out.given.outcome === 'assigned'
+          ? `It is now ${who(out.given.to)}'s — they are below you in your chain of command, so it was assigned outright. They are told once.`
+          : `${who(out.given.to)} has been ASKED to take it. It stays YOURS until they accept; you are told if they decline.`
+        return { content: [{ type: 'text', text: `Recorded: ${subject}${due_at ? ` (due ${due_at.slice(0, 10)})` : ' (no deadline)'}${on}\n${out.id}\n${what}` }] }
+      }
       return { content: [{ type: 'text', text: `Recorded: ${subject}${due_at ? ` (due ${due_at.slice(0, 10)})` : ' (no deadline)'}${on}\n${out.id}${note}` }] }
     },
   )
 
+  server.registerTool(
+    'give_obligation',
+    {
+      title: 'Give an obligation to someone',
+      description: "Hand an existing obligation to another person in the same brain (ADR-0073). YOU DO NOT CHOOSE THE OUTCOME, and neither does the person asking: the reporting line does. Someone BELOW the giver in the giver's own chain of command gets it at once (assigned). Anyone else — above, a peer, or lower down on another team — is ASKED, and it stays with its current owner until they accept; if they decline it simply stays where it was. Report which of the two happened exactly as the result states it. Only its owner, or someone above its owner, can give it. Giving it to the caller themselves is taking it over, allowed only from above. Use the person's email address when a name could match two people.",
+      inputSchema: {
+        obligation_id: z.string().describe('from my_obligations'),
+        to: z.string().describe("who should owe it: their email address, or their name as it appears in this brain"),
+        note: z.string().optional().describe('a short note to them'),
+      },
+    },
+    async ({ obligation_id, to, note }) => {
+      let res
+      try {
+        res = await fetchCortex(`${BASE}/api/obligations/give`, {
+          method: 'POST',
+          headers: { Authorization: `Bearer ${TOKEN}`, 'Content-Type': 'application/json' },
+          body: JSON.stringify({ obligationId: obligation_id, to, note }),
+        })
+      } catch (e) { return toolError(`Could not reach obligations: ${e.message}`) }
+      const out = await res.json().catch(() => null)
+      if (!res.ok) return toolError(`Could not give it: ${out?.detail ?? out?.error ?? res.status}`)
+      const text = out.outcome === 'assigned'
+        ? `ASSIGNED: it is now ${who(out.to)}'s. They are below the giver in the chain of command, so it moved at once; they are told once.`
+        : `ASKED: ${who(out.to)} has been asked to take it. It has NOT moved — it stays with its current owner until they accept, and the asker is told if they decline.`
+      return { content: [{ type: 'text', text }] }
+    },
+  )
+
+  server.registerTool(
+    'answer_obligation_request',
+    {
+      title: 'Accept or decline an obligation someone asked you to take',
+      description: "Answer a request listed under ASKED OF YOU in my_obligations (ADR-0073). Accepting makes the person its owner. Declining REQUIRES a reason — the person who asked is told it — and changes nothing else: the obligation stays with whoever had it. ⚠ This is the PERSON's decision. Ask them; never accept or decline on their behalf because it seems reasonable.",
+      inputSchema: {
+        obligation_id: z.string().describe('from the ASKED OF YOU section of my_obligations'),
+        accept: z.boolean().describe('true = take it; false = decline'),
+        reason: z.string().optional().describe("REQUIRED when declining — in the person's own words"),
+      },
+    },
+    async ({ obligation_id, accept, reason }) => {
+      let res
+      try {
+        res = await fetchCortex(`${BASE}/api/obligations/answer`, {
+          method: 'POST',
+          headers: { Authorization: `Bearer ${TOKEN}`, 'Content-Type': 'application/json' },
+          body: JSON.stringify({ obligationId: obligation_id, accept, reason }),
+        })
+      } catch (e) { return toolError(`Could not reach obligations: ${e.message}`) }
+      const out = await res.json().catch(() => null)
+      if (!res.ok) return toolError(`Could not answer: ${out?.detail ?? out?.error ?? res.status}`)
+      const asker = out.from ? who(out.from) : 'the person who asked'
+      return { content: [{ type: 'text', text: out.outcome === 'accepted'
+        ? `Accepted: it is yours now. ${asker} is not told separately — they see it under YOU ASKED.`
+        : `Declined. Nothing moved: it stays with ${asker}, who is told your reason once.` }] }
+    },
+  )
+
   server.registerTool(
     'set_obligation_pages',
     {

package/package.json

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