@atrib/summarize 0.4.16 → 0.4.17

package/README.md

@@ -2,7 +2,7 @@
 
 MCP server exposing the `summarize` tool, synthesizes a narrative across N records using an OpenAI-compatible LLM.
 
-Closes the consumer-side cognitive-loop primitive companion to `atrib-trace`: trace returns the causal chain (structural); summarize returns the synthesized meaning across the chain (semantic). Both read the same local mirror including the optional `_local` sidecar.
+Closes the consumer-side cognitive-loop primitive companion to `atrib-trace`: trace returns the declared-relationship path; summarize returns the synthesized meaning across the selected records. Both read the same local mirror including the optional `_local` sidecar.
 
 ## Tool
 

package/dist/index.d.ts

@@ -4,8 +4,8 @@
  * an OpenAI-compatible LLM to synthesize a narrative across them.
  *
  * Closes the consumer-side cognitive-loop primitive companion to trace:
- * trace returns the causal chain (structural); summarize returns the
- * synthesized meaning across that chain (semantic). Both read the same
+ * trace returns the declared-relationship path; summarize returns the
+ * synthesized meaning across the selected records. Both read the same
  * local mirror including the optional _local sidecar.
  *
  * LLM access via OpenAI-compatible HTTP. Defaults to NVIDIA NIM with the

package/dist/index.js

@@ -5,8 +5,8 @@
  * an OpenAI-compatible LLM to synthesize a narrative across them.
  *
  * Closes the consumer-side cognitive-loop primitive companion to trace:
- * trace returns the causal chain (structural); summarize returns the
- * synthesized meaning across that chain (semantic). Both read the same
+ * trace returns the declared-relationship path; summarize returns the
+ * synthesized meaning across the selected records. Both read the same
  * local mirror including the optional _local sidecar.
  *
  * LLM access via OpenAI-compatible HTTP. Defaults to NVIDIA NIM with the
@@ -23,18 +23,41 @@ import { buildSystemPrompt, buildUserMessage } from './prompt.js';
 const SHA256_REF_PATTERN = /^sha256:[0-9a-f]{64}$/;
 const HEX_32_PATTERN = /^[0-9a-f]{32}$/;
 const SummarizeInput = z.object({
-    context_id: z.string().regex(HEX_32_PATTERN).optional().describe("When supplied, summarize every record sharing this 32-hex trace identifier. " +
-        "Mutually composable with record_hashes: if both, the union of records is used."),
-    record_hashes: z.array(z.string().regex(SHA256_REF_PATTERN)).optional().describe("Explicit list of 'sha256:<64-hex>' record hashes to summarize. Records not " +
-        "in the local mirror are silently skipped (use trace to inspect dangling)."),
-    focus: z.string().min(1).max(2000).optional().describe('Optional steering for the synthesis (e.g. "what decisions did I make", ' +
+    context_id: z
+        .string()
+        .regex(HEX_32_PATTERN)
+        .optional()
+        .describe('When supplied, summarize every record sharing this 32-hex trace identifier. ' +
+        'Mutually composable with record_hashes: if both, the union of records is used.'),
+    record_hashes: z
+        .array(z.string().regex(SHA256_REF_PATTERN))
+        .optional()
+        .describe("Explicit list of 'sha256:<64-hex>' record hashes to summarize. Records not " +
+        'in the local mirror are silently skipped (use trace to inspect dangling).'),
+    focus: z
+        .string()
+        .min(1)
+        .max(2000)
+        .optional()
+        .describe('Optional steering for the synthesis (e.g. "what decisions did I make", ' +
         '"why did I revise X", "which claims shaped the outcome"). Defaults to a ' +
         'general "summarize what the agent did and why" focus.'),
-    max_records: z.number().int().min(1).max(200).optional().describe('Cap on records fed to the LLM, default 50. Records beyond the cap (after ' +
+    max_records: z
+        .number()
+        .int()
+        .min(1)
+        .max(200)
+        .optional()
+        .describe('Cap on records fed to the LLM, default 50. Records beyond the cap (after ' +
         'sorting by timestamp ascending) are skipped and counted in records_skipped. ' +
         'Increase carefully, large prompts run slower + cost more + risk model ' +
         'context limits.'),
-    model: z.string().min(1).max(200).optional().describe('Override the configured model for this call. Format depends on provider ' +
+    model: z
+        .string()
+        .min(1)
+        .max(200)
+        .optional()
+        .describe('Override the configured model for this call. Format depends on provider ' +
         '(NVIDIA NIM uses e.g. "qwen/qwen3.5-397b-a17b"). Defaults to env ' +
         'ATRIB_SUMMARIZE_MODEL or the package default.'),
 });

package/dist/prompt.js

@@ -3,12 +3,12 @@ const SYSTEM_PROMPT = `You synthesize narratives across signed agent activity re
 
 Each record has:
 - A cryptographic identity (signature, hash, creator_key)
-- A causal position (chain_root, informed_by)
+- A graph position (chain_root, informed_by)
 - A semantic payload, EITHER carried in a local sidecar (rich) OR absent (impoverished, only event_type and metadata)
 
 Your job: produce a coherent narrative across the records that surfaces:
 - What the agent was doing (decisions, observations, revisions)
-- What informed what (causal chains via informed_by)
+- What the signer claimed informed what (via informed_by)
 - What shaped the outcome vs what was incidental
 - Honest gaps (when records are impoverished, say so; do not invent semantics)
 
@@ -38,7 +38,7 @@ export function buildUserMessage(records, focus) {
     }
     else {
         lines.push(`# Default focus`);
-        lines.push('Summarize what the agent did and why, surfacing the decisions that shaped the work and the causal chain.');
+        lines.push('Summarize what the agent did and why, surfacing the decisions and signed relationship path that shaped the work.');
     }
     return lines.join('\n');
 }
@@ -80,6 +80,10 @@ function renderRecord(r) {
                 out.push(`what: ${c['what']}`);
             if (typeof c['why_noted'] === 'string')
                 out.push(`why_noted: ${c['why_noted']}`);
+            if (typeof c['intent'] === 'string')
+                out.push(`intent: ${c['intent']}`);
+            if (typeof c['rationale'] === 'string')
+                out.push(`rationale: ${c['rationale']}`);
             if (typeof c['summary'] === 'string')
                 out.push(`summary: ${c['summary']}`);
             if (typeof c['importance'] === 'string')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atrib/summarize",
-  "version": "0.4.16",
+  "version": "0.4.17",
   "description": "MCP server for atrib. Synthesizes a narrative across N records via an OpenAI-compatible LLM so agents read context, not raw record bytes.",
   "author": "atrib <hello@atrib.dev>",
   "keywords": [
@@ -25,7 +25,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
     "zod": "^3.25.76",
-    "@atrib/mcp": "0.17.5"
+    "@atrib/mcp": "0.17.6"
   },
   "devDependencies": {
     "@types/node": "^25.9.2",