@theronap/agnoclast-mcp 0.9.224 → 0.9.226

package/lib/server.mjs

@@ -4685,6 +4685,49 @@ function renderNudge(payload) {
     },
   )
 
+  // relabel_record_people — put a real name where a text record names its person by a bare phone number
+  // (records filed before desktop 0.1.40 could not read Contacts). Owner-only; labels, never identifiers or
+  // message bodies; dry run unless apply: true; the server keeps each before-state in record history.
+  server.registerTool(
+    'relabel_record_people',
+    {
+      title: 'Put a name on texts that show a bare phone number',
+      description:
+        'On YOUR OWN text-message records, replace a bare phone number standing as a person\'s name ("1 message with ' +
+        '+18015550100") with the name you give: the summary, the thread label and the "who:" speaker prefix of each ' +
+        'message. Never changes the number itself as an identifier, message wording, or who can see the record. ' +
+        'Dry run by default (reports how many records would change); pass apply: true to write. Safe to repeat.',
+      inputSchema: {
+        mappings: z.array(z.object({
+          phone: z.string().describe('E.164, e.g. +18015550100 (a "phone:" prefix is fine)'),
+          name: z.string().describe('the display name to show instead'),
+        })).min(1).max(50).describe('one or more number → name pairs'),
+        apply: z.boolean().optional().describe('true = write; omitted/false = dry run'),
+      },
+    },
+    async ({ mappings, apply }) => {
+      let res
+      try {
+        res = await fetchCortex(`${BASE}/api/records/relabel-people`, {
+          method: 'POST',
+          headers: { Authorization: `Bearer ${TOKEN}`, 'Content-Type': 'application/json' },
+          body: JSON.stringify({ mappings, dry_run: apply !== true }),
+        })
+      } catch (e) {
+        return toolError(`Could not reach Agnoclast: ${e.message}`)
+      }
+      const body = await res.json().catch(() => ({}))
+      if (res.status === 404 && !body?.error) return toolError('This server does not relabel records yet. Nothing was written.')
+      if (res.status === 422) return toolError(`Not done: ${body?.detail ?? 'the mappings were refused'}.`)
+      if (!res.ok || !body?.ok) return toolError(`Could not relabel: HTTP ${res.status} ${JSON.stringify(body)}`)
+      const ids = (body.recordIds ?? []).join(', ')
+      const text = body.dryRun
+        ? `Dry run: ${body.changed} of your text records would be relabelled (${body.matched} mention the number${body.matched === 1 ? '' : 's'}).${ids ? ` Records: ${ids}.` : ''} Nothing was written; pass apply: true to write.`
+        : `Relabelled ${body.changed} of your text records.${ids ? ` Records: ${ids}.` : ''} Each before-state is kept in record history.`
+      return { content: [{ type: 'text', text }] }
+    },
+  )
+
   // ── the questions agents used to answer with SQL (Agnoclast page "Agent SQL gap", 2026-10-07) ──────
   // Theron, 2026-10-07: "any information that I have felt the need to get about my own brains, but was
   // not able to do it with Agnoclast tools … we either need to make tools for that, or …". Measured the
@@ -5270,13 +5313,14 @@ function renderNudge(payload) {
     'set_routing_identifier',
     {
       title: 'Claim a routing identifier on a page',
-      description: 'Declare that a page is a Gate 4 attach HOME for an identifier (repo:owner/name or file:owner/name:path). Body [[repo:…]] stamps are navigation only and do NOT drive attach — use this instead. Prefer the narrowest id: mother pages own repo:; feature pages own file: paths. Do not copy every body mention into a routing claim.',
+      description: 'Declare that a page is a Gate 4 attach HOME for an identifier (repo:owner/name or file:owner/name:path). Body [[repo:…]] stamps are navigation only and do NOT drive attach — use this instead. Prefer the narrowest id: mother pages own repo:; feature pages own file: paths. Do not copy every body mention into a routing claim. ' +
+        'PRIVATE CONTACT CLAIMS (ADR-0079): on a PERSON page you may claim `phone:<number>` (normalized to E.164, US default — `phone:(801) 636-7505` stores `phone:+18016367505`) or `email:<address>` (lowercased). These are visible ONLY to you — never in the page body, grep, or to other brain members — and they make your captured texts / mail from that contact propose that person page. This is the right place for a contact\'s number; never put it in page text.',
       inputSchema: {
         kind: z.enum(['project', 'person', 'org', 'user']).describe('the page kind'),
         name: z.string().optional().describe('page title (or pass ref)'),
         ref: z.string().optional().describe('node ref from read_page — prefer over name when available'),
         brain: z.string().optional().describe('brain label when the title is ambiguous across brains'),
-        identifier: z.string().describe('canonical identifier, e.g. repo:theronap/cortex or file:theronap/cortex:web/lib/engine/github_intake.ts'),
+        identifier: z.string().describe('canonical identifier, e.g. repo:theronap/cortex, file:theronap/cortex:web/lib/engine/github_intake.ts, or on a person page phone:+18015550123 / email:someone@example.com (private to you)'),
       },
     },
     async ({ kind, name, ref, brain, identifier }) => {
@@ -5292,7 +5336,12 @@ function renderNudge(payload) {
         return toolError(`Could not set routing identifier: ${e.message}`)
       }
       const out = await res.json().catch(() => null)
-      if (!res.ok) return toolError(`Could not set routing identifier: ${out?.error ?? res.status}`)
+      if (!res.ok) {
+        // A per-identifier refusal arrives in `errors[]` with a top-level 400 — name it, not just the status.
+        const why = out?.error ?? out?.errors?.map((e) => e.error).join(', ') ?? res.status
+        const hint = /phone_claims_person_pages_only/.test(String(why)) ? ' A phone: claim goes on the PERSON page for that contact (kind: person).' : ''
+        return toolError(`Could not set routing identifier: ${why}.${hint}`)
+      }
       const set = out?.set?.join(', ') ?? identifier
       // ⚠ SAY WHAT ALREADY HAPPENED, NOT ONLY WHAT WILL. The claim heals history in the same
       // statement, so by the time this renders, existing records are ALREADY attached. The previous
@@ -5306,7 +5355,11 @@ function renderNudge(payload) {
         : healed > 0
           ? ` ${healed} existing record(s) ALREADY attached to this page as a result.`
           : ' 0 existing records attached — either nothing carries this identifier yet, or records do but belong to another owner (an identity claim only attaches your own).'
-      return { content: [{ type: 'text', text: `Routing identifier set on document ${out?.documentId ?? '?'}: ${set}.${healedLine} Future matching events will attach here too (body mentions alone will not).` }] }
+      const isContact = /^(phone|email):/.test(String(out?.set?.[0] ?? identifier).toLowerCase())
+      const privacyLine = isContact
+        ? ' This contact claim is PRIVATE to you: no other brain member can see it, and it is never rendered in the page. Your captured texts/mail from this contact will now propose this page.'
+        : ''
+      return { content: [{ type: 'text', text: `Routing identifier set on document ${out?.documentId ?? '?'}: ${set}.${healedLine} Future matching events will attach here too (body mentions alone will not).${privacyLine}` }] }
     },
   )
 

package/package.json

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