@theronap/agnoclast-mcp 0.9.252 → 0.9.253

package/lib/obligations_render.mjs

@@ -122,6 +122,8 @@ export function renderObligations(obs, now = Date.now(), extras = null) {
     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')
+    // ADR-0093: who is waiting on it. Absent on an older server: nothing is said.
+    if (o.owedTo?.title) lines.push(`  → owed to “${String(o.owedTo.title).replace(/\s+/g, ' ').trim().slice(0, 60)}” (ref ${o.owedTo.ref}) — read their page for context`)
     // Only when it is wider than the default: who else can see this when they look at its page.
     if (tierReads(o.tier)) lines.push(`  visible to: ${tierReads(o.tier)} — they can see it; nobody but you is told about it`)
     // Whose idea it was, and whether it is on its way to someone else. Both change what to DO with it.

package/lib/release_gate.mjs

@@ -5,7 +5,7 @@
 // that web/lib/engine/release.test.ts pins to the server's registry.
 
 /** Tools any release flag gates — hidden when the server cannot be asked. Mirror of allGatedTools(). */
-export const GATED_FALLBACK = ['my_messages', 'read_conversation', 'send_message']
+export const GATED_FALLBACK = ['my_messages', 'read_conversation', 'send_message', 'set_obligation_owed_to']
 
 export const RELEASE_FETCH_TIMEOUT_MS = 2500
 

package/lib/server.mjs

@@ -3095,9 +3095,10 @@ function renderNudge(payload) {
         closed: z.boolean().optional().describe('true = also show discharged/cancelled ones'),
         limit: z.number().optional().describe('default 50'),
         page: z.string().optional().describe("a page's `ref:` as read_page prints it. Lists EVERYONE's open obligations on that page that the person may see — theirs first, then other people's under each owner's name. Use it when a page read says other people have obligations there and the person asks to see them; seeing one does not make it theirs."),
+        owed_to: z.string().optional().describe("a person's page `ref:` — only what the person owes THEM (\"what do I owe Tanner?\"), across every page"),
       },
     },
-    async ({ closed, limit, page }) => {
+    async ({ closed, limit, page, owed_to }) => {
       let res
       if (page) {
         try {
@@ -3111,6 +3112,7 @@ function renderNudge(payload) {
         const qs = new URLSearchParams()
         if (closed) qs.set('closed', 'true')
         if (limit) qs.set('limit', String(limit))
+        if (owed_to) qs.set('owedTo', owed_to.trim())
         res = await fetchCortex(`${BASE}/api/obligations?${qs}`, { headers: { Authorization: `Bearer ${TOKEN}` } })
       } catch (e) { return toolError(`Could not reach obligations: ${e.message}`) }
       const out = await res.json().catch(() => null)
@@ -3124,7 +3126,7 @@ function renderNudge(payload) {
     'track_obligation',
     {
       title: 'Record something you owe',
-      description: "Record something you owe: a subject, the page or pages it is about, optionally when it comes due, optionally whose reply would discharge it. ⚠ EVERY OBLIGATION LIVES ON A PAGE, CHOSEN NOW. `pages` is required: READ the page this is about first (read_page prints its `ref:`), then pass that ref — several when it genuinely belongs on several. Never guess a page to get past the check, and never default to the person's own page: if you cannot tell where it belongs, ask them. A page says where the obligation is FOUND, not who can see it: it is visible to its owner only unless the person later widens it (`set_obligation_tier`). ⚠ ONLY A DATE MAKES IT COME BACK. A DATED obligation is raised to the person's sessions by time, unasked, BEFORE it lapses: counted on the day it is due, and named when a stated clock time is within the hour. ⚠ A DEADLINE IS NOT WHEN TO START: pass `work_from` when the work needs lead time (a 10-day project opens 10 days ahead; an exam, days of study). From then it is named daily as \"work on now\", and once on the desktop when it opens. Once late it is never raised again, and an UNDATED one is never raised by anything — it surfaces only when someone asks with my_obligations. ⚠ NEVER INVENT A DUE DATE — and that matters more now, because an invented date will interrupt someone. Omit due_at when there genuinely is no deadline (a standing obligation); a guessed date is indistinguishable from a real one the moment it is stored, and it is the direct route to nagging about something that was never actually late. `anchor_identifier` is the useful part: give it the counterparty's address as `email:someone@example.com` and any record arriving from them is automatically offered as evidence that this may be done — computed when the record lands, not by a scanner.",
+      description: "Record something you owe: a subject, the page or pages it is about, optionally when it comes due, optionally whose reply would discharge it. ⚠ EVERY OBLIGATION LIVES ON A PAGE, CHOSEN NOW. `pages` is required: READ the page this is about first (read_page prints its `ref:`), then pass that ref — several when it genuinely belongs on several. Never guess a page to get past the check, and never default to the person's OWN page: if you cannot tell where it belongs, ask them. A page says where the obligation is FOUND, not who can see it: it is visible to its owner only unless the person later widens it (`set_obligation_tier`). ⚠ ONLY A DATE MAKES IT COME BACK. A DATED obligation is raised to the person's sessions by time, unasked, BEFORE it lapses: counted on the day it is due, and named when a stated clock time is within the hour. ⚠ A DEADLINE IS NOT WHEN TO START: pass `work_from` when the work needs lead time (a 10-day project opens 10 days ahead; an exam, days of study). From then it is named daily as \"work on now\", and once on the desktop when it opens. Once late it is never raised again, and an UNDATED one is never raised by anything — it surfaces only when someone asks with my_obligations. ⚠ NEVER INVENT A DUE DATE: an invented date will interrupt someone. Omit due_at when there is no real deadline (a standing obligation); a guessed date is indistinguishable from a real one once stored, and leads straight to nagging about something that was never late. ⚠ OWED TO SOMEONE? Pass `owed_to`: the ref of their page (\"I owe Tanner a text\" → Tanner's page). It is attached, so a later agent reads it instead of asking who, and records from their email or phone count as evidence this may be done. `owed_to` is who WAITS; `for` is who OWES. `anchor_identifier` (e.g. `repo:owner/name`) covers evidence that is not a person.",
       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.'),
@@ -3132,18 +3134,19 @@ function renderNudge(payload) {
         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.'),
         work_from: z.string().optional().describe('ISO 8601: when work should START — the window opens (a bare date = the start of that day). Needs due_at, and must come before it. Estimate it from what the work involves; omit for things needing no lead time.'),
-        anchor_identifier: z.string().optional().describe('e.g. "email:ben@example.com" — records from them become evidence this may be done'),
+        owed_to: z.string().optional().describe("the `ref:` of the page of the person (or org) this is owed TO — who is waiting on it. Read their page first. Omit when it is owed to nobody in particular."),
+        anchor_identifier: z.string().optional().describe('e.g. "repo:owner/name" — records carrying it become evidence this may be done. For a person, prefer owed_to.'),
         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'),
+        brain: z.string().optional().describe('the brain\'s name or id — required only if you belong to more than one'),
       },
     },
-    async ({ subject, pages, due_at, work_from, anchor_identifier, source_record_id, brain, for: giveTo, note: giveNote }) => {
+    async ({ subject, pages, due_at, work_from, anchor_identifier, source_record_id, brain, for: giveTo, note: giveNote, owed_to }) => {
       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, workFrom: work_from, anchorIdentifier: anchor_identifier, sourceRecordId: source_record_id, brain, for: giveTo, note: giveNote }),
+          body: JSON.stringify({ subject, pages, dueAt: due_at, workFrom: work_from, anchorIdentifier: anchor_identifier, sourceRecordId: source_record_id, brain, for: giveTo, note: giveNote, owedTo: owed_to }),
         })
       } catch (e) { return toolError(`Could not reach obligations: ${e.message}`) }
       const out = await res.json().catch(() => null)
@@ -3154,9 +3157,9 @@ function renderNudge(payload) {
         ? (work_from ? `From ${work_from.slice(0, 10)} it is named daily as "work on now" (and once on the desktop). ` : '')
           + 'It will be raised to your sessions on the day it is due' + (/T\d{2}:\d{2}/.test(due_at) ? ', and again when it is within the hour.' : '.')
         : 'It has no date, so nothing will raise it \u2014 ask with my_obligations.'
-      const note = anchor_identifier
-        ? `\nRecords carrying ${anchor_identifier} will be offered as evidence this is done. ${nudge}`
-        : `\n${nudge}`
+      const note = (owed_to ? '\nOwed to that person: their page is attached, and records from them will be offered as evidence this is done.' : '')
+        + (anchor_identifier ? `\nRecords carrying ${anchor_identifier} will be offered as evidence this is done.` : '')
+        + `\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.
@@ -3446,6 +3449,32 @@ function renderNudge(payload) {
     },
   )
 
+  server.registerTool(
+    'set_obligation_owed_to',
+    {
+      title: 'Say who an obligation is owed to',
+      description: "Say who an existing obligation is owed TO — the person waiting on it (ADR-0093) — or clear it. Pass the `ref:` of their page (person or org), read first. Their page is attached to the obligation, my_obligations shows \"→ owed to …\", and records from any email, thread or phone claimed on that page become evidence it may be done. Pass an empty string to clear it; clearing does not take the obligation off their page (use set_obligation_pages for that). Owner only.",
+      inputSchema: {
+        obligation_id: z.string().describe('from my_obligations'),
+        owed_to: z.string().describe("the person's page `ref:` as read_page prints it, or \"\" to clear"),
+      },
+    },
+    async ({ obligation_id, owed_to }) => {
+      let res
+      try {
+        res = await fetchCortex(`${BASE}/api/obligations/owed-to`, {
+          method: 'POST',
+          headers: { Authorization: `Bearer ${TOKEN}`, 'Content-Type': 'application/json' },
+          body: JSON.stringify({ obligationId: obligation_id, owedTo: owed_to }),
+        })
+      } catch (e) { return toolError(`Could not reach obligations: ${e.message}`) }
+      const out = await res.json().catch(() => null)
+      if (!res.ok) return toolError(`Could not set it: ${out?.detail ?? out?.error ?? res.status}`)
+      const t = out?.owedTo?.title
+      return { content: [{ type: 'text', text: t ? `Owed to “${String(t).replace(/\s+/g, ' ').trim().slice(0, 60)}” — their page is attached.` : 'No longer marked as owed to anyone. Its pages are unchanged.' }] }
+    },
+  )
+
   server.registerTool(
     'propose_obligation',
     {

package/package.json

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