@theronap/agnoclast-mcp 0.9.221 → 0.9.223

package/lib/arrivals_notice.mjs

@@ -101,6 +101,20 @@ export function formatPressing(pressing) {
       const more = count > names.length ? ` … and ${count - names.length} more` : ''
       lines.push(`⏰ Due today (${count}): ${names.join(' · ')}${more}`)
     }
+    // 2026-10-08 — WHAT TO BE WORKING ON: obligations whose work window is open, soonest deadline first.
+    // Theron: "that is the thing that they should be working on in the time frame in advance of that
+    // thing." Once a day. A window that opened in the last day is marked so the start is not missed.
+    else if (p?.kind === 'work_now') {
+      const count = Number(p.count) || 0
+      if (!count) continue
+      const names = (Array.isArray(p.names) ? p.names : []).map((n) => {
+        const due = String(n?.due ?? '').replace(/\s+/g, ' ').trim().slice(0, 40)
+        const done = n?.maybeDone ? ' — may ALREADY BE DONE; ask' : ''
+        return `${named(n?.text)} (${n?.opened ? 'starts today — ' : ''}${due ? `due ${due}` : 'due soon'})${done}`
+      })
+      const more = count > names.length ? ` … and ${count - names.length} more` : ''
+      lines.push(`🧭 Work on now (${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') {
@@ -140,7 +154,8 @@ export function pressingAcks(pressing) {
   for (const p of Array.isArray(pressing) ? pressing : []) {
     if (typeof p?.subject !== 'string' || typeof p?.bucket !== 'string') continue
     const handoff = p.kind === 'asked' || p.kind === 'given' || p.kind === 'declined' || p.kind === 'lapsed'
-    if (p.kind === 'event' || p.kind === 'due_soon' || handoff || (p.kind === 'due_today' && Number(p.count) > 0)) {
+    const rollup = (p.kind === 'due_today' || p.kind === 'work_now') && Number(p.count) > 0
+    if (p.kind === 'event' || p.kind === 'due_soon' || handoff || rollup) {
       out.push({ subject: p.subject, bucket: p.bucket })
     }
   }

package/lib/obligations_render.mjs

@@ -152,5 +152,11 @@ function describeDue(o, now) {
   const what = o.dueAllDay ? `${day} (all day)` : `${day} ${o.dueAt.slice(11, 16)}`
   if (after <= now) return `OVERDUE ${what}`
   if (o.dueAllDay && at <= now) return `DUE TODAY ${what}`
-  return `due ${what}`
+  return `due ${what}${windowNote(o.workFrom, now)}`
+}
+
+// 2026-10-08 — when work should start. Absent on a server older than work windows: nothing is said.
+function windowNote(workFrom, now) {
+  if (!workFrom) return ''
+  return new Date(workFrom).getTime() <= now ? ` · IN ITS WORK WINDOW since ${String(workFrom).slice(0, 10)}` : ` · work from ${String(workFrom).slice(0, 10)}`
 }

package/lib/server.mjs

@@ -2985,25 +2985,26 @@ 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. 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 — 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.",
       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.'),
+        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'),
         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, for: giveTo, note: giveNote }) => {
+    async ({ subject, pages, due_at, work_from, 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, 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 }),
         })
       } catch (e) { return toolError(`Could not reach obligations: ${e.message}`) }
       const out = await res.json().catch(() => null)
@@ -3011,7 +3012,8 @@ function renderNudge(payload) {
       // What will actually happen, stated per case: a promise of a nudge that never comes is worse
       // than no promise, and so is "nothing will nudge you" over something that now will.
       const nudge = due_at
-        ? '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.' : '.')
+        ? (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}`
@@ -3029,6 +3031,38 @@ function renderNudge(payload) {
     },
   )
 
+  server.registerTool(
+    'set_obligation_window',
+    {
+      title: 'Set when work on an obligation should start',
+      description: "Open, move or remove an obligation's WORK WINDOW — when work on it should start, not when it is due (2026-10-08). From that moment until it is late, it is named once a day in the person's sessions as \"work on now\", soonest deadline first, and announced once on the desktop when the window opens. Use it when you learn what the work involves after it was recorded: \"it needs ten consecutive days of observation\" opens the window ten days before the deadline, whatever was guessed at capture; \"study for the final\" might open five days ahead. A bare date opens it at the start of that day in the owner's zone. It needs a due date and must come before it. Pass work_from null to remove the window. Only the owner can set it, and only while the obligation is open. A proposal (unconfirmed) is never raised by its window.",
+      inputSchema: {
+        obligation_id: z.string().describe('from my_obligations'),
+        work_from: z.string().nullable().describe('ISO 8601 date or date-time when work should start; null removes the window'),
+      },
+    },
+    async ({ obligation_id, work_from }) => {
+      let res
+      try {
+        res = await fetchCortex(`${BASE}/api/obligations/window`, {
+          method: 'POST',
+          headers: { Authorization: `Bearer ${TOKEN}`, 'Content-Type': 'application/json' },
+          body: JSON.stringify({ obligationId: obligation_id, workFrom: work_from ?? null }),
+        })
+      } 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 the window: ${out?.detail ?? out?.error ?? res.status}`)
+      return {
+        content: [{
+          type: 'text',
+          text: out.workFrom
+            ? `Window set: work on it from ${out.workFrom}. From then until it is due it is named daily as "work on now".`
+            : 'Window removed: it is raised only on the day it is due.',
+        }],
+      }
+    },
+  )
+
   server.registerTool(
     'give_obligation',
     {
@@ -4826,7 +4860,7 @@ function renderNudge(payload) {
         shape: z.enum(['message', 'event', 'document', 'record']).describe('message = emails, chats, replies · event = ticket changes, alerts, CRM updates · document = notes, transcripts, reports · record = rows, metrics, anything else'),
         purpose: z.enum(['communication', 'work', 'reference', 'metrics']).describe('sets defaults only'),
         sample: z.record(z.string(), z.any()).optional().describe('ONE real item, exactly as the system will send it (a JSON object)'),
-        mapping: z.record(z.string(), z.any()).optional().describe('which field plays which role, as dot paths into one item: { id, time, title, body, group, url, people: [..] }. Omit to have it suggested from the sample'),
+        mapping: z.record(z.string(), z.any()).optional().describe('which field plays which role, as dot paths into one item: { id, time, title, body, group, url, people: [..] } — plus, for items with deadlines, due, work_from (when to start) and done: then each item keeps one obligation that the source updates and closes. Omit to have it suggested from the sample'),
         mode: z.enum(['channel', 'ingest']).optional().describe('channel (default) = every item files onto one page as it arrives · ingest = each item waits in the pile to be sorted'),
         ...homeArgs,
         dry_run: z.boolean().optional().describe('true = show the mapping, the sample preview and the home (or the candidate pages) and create NOTHING. Do this first'),
@@ -4857,6 +4891,48 @@ function renderNudge(payload) {
     },
   )
 
+  server.registerTool(
+    'set_custom_source_mapping',
+    {
+      title: 'Change a custom source\'s field mapping',
+      description: 'Change which field of a custom source\'s pushed items plays which role — for a sender that learned to send more after it was set up. Pass the WHOLE mapping (read the current one with list_custom_sources first): { id, time, title, body, group, url, people: [..], due, work_from, done }. DEADLINES (2026-10-08): map `due` (when the item must be done) and, if the item says so, `work_from` (when work should start) and `done` (a field that is truthy once it is). Then each item with a deadline keeps ONE obligation for you on the source\'s home page — created on the next push, kept current on every push after, and discharged by the source itself when the item reports done; a machine proposal for the same work is folded into it. Nothing already late is created. The `id` field cannot change here: it decides what counts as the same item, and changing it would re-file everything as new — set up a new source instead.',
+      inputSchema: {
+        source: z.string().describe('the source — its id or its name, as list_custom_sources shows'),
+        mapping: z.record(z.string(), z.any()).describe('the whole mapping, role → dot path into one item'),
+      },
+    },
+    async (a) => {
+      let list
+      try {
+        const res = await fetchCortex(`${BASE}/api/custom-connectors`, { headers: { Authorization: `Bearer ${TOKEN}` } })
+        if (!res.ok) return cannot('Could not read your custom sources', res)
+        list = (await res.json()).connectors
+      } catch (e) {
+        return toolError(`Could not read your custom sources: ${e.message}`)
+      }
+      const picked = pickSource(list, a.source)
+      if (!picked.ok) return toolError(picked.message)
+      const src = picked.source
+      let res
+      try {
+        res = await fetchCortex(`${BASE}/api/custom-connectors/${encodeURIComponent(src.id)}/mapping`, {
+          method: 'PUT',
+          headers: { Authorization: `Bearer ${TOKEN}`, 'Content-Type': 'application/json' },
+          body: JSON.stringify({ mapping: a.mapping }),
+        })
+      } catch (e) {
+        return toolError(`Not changed: ${e.message}`)
+      }
+      if (!res.ok) return cannot('Not changed', res)
+      const j = await res.json()
+      const roles = Object.entries(j.mapping ?? {}).map(([k, v]) => `${k} ← ${Array.isArray(v) ? v.join(', ') : v}`).join(' · ')
+      const keeps = j.mapping?.due
+        ? '\nItems with a deadline now keep an obligation each — created on the next push, closed when the item reports done.'
+        : ''
+      return { content: [{ type: 'text', text: `${src.name} mapping: ${roles}${keeps}` }] }
+    },
+  )
+
   server.registerTool(
     'set_custom_source_home',
     {

package/package.json

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