@atrib/trace 0.5.3 → 0.5.5

package/README.md

@@ -30,7 +30,10 @@ mcp__atrib-trace__trace_forward({  // FORWARD — what was informed by this?
       event_type, context_id, creator_key, timestamp,
       next_informed_by, next_resolved, next_dangling,
       informed_by?, tool_name?, args_hash?, result_hash?,
-      sidecar_summary?: { tool_name?, topics?, what?, importance?, producer? },
+      sidecar_summary?: {
+        tool_name?, topics?, what?, importance?, producer?,
+        span_kind?, span_name?, model_name?, prompt_version?
+      },
       local_content?, local_producer? // only when include_content=true
     }
   ],
@@ -51,7 +54,7 @@ Every `*.jsonl` mirror under `~/.atrib/records/` (override via `ATRIB_RECORDS_DI
 - Bare `AtribRecord` per line (legacy / wrapper convention pre-sidecar)
 - `{ record, _local?, written_at }` envelope (current shape)
 
-When the envelope carries an optional `_local` sidecar (per the local-mirror sidecar pattern shipped in `@atrib/mcp` v0.2.x), trace surfaces a compact `sidecar_summary` per record: `tool_name`, `topics`, first ~200 chars of `what`/`summary`, and `importance` for annotations. When `include_content=true`, trace also returns the full [D062](../../DECISIONS.md#d062-local-mirror-sidecar--two-tier-private-local--public-canonical-persistence) local mirror body as `local_content` plus `local_producer`; this is intended for harness-mediated causal replay where the agent needs rich expected/actual outcome context. Without the sidecar (legacy entries), the per-record output still includes the cryptographic evidence (event_type, hashes, creator_key, timestamp), just without semantic context.
+When the envelope carries an optional `_local` sidecar (per the local-mirror sidecar pattern shipped in `@atrib/mcp` v0.2.x), trace surfaces a compact `sidecar_summary` per record: `tool_name`, `topics`, first ~200 chars of `what`/`summary`, `importance` for annotations, and OpenInference fields such as `span_kind`, `span_name`, `model_name`, and `prompt_version` when present. Trace reads `_local.content` first, then derives the same content shape from legacy wrapper or OpenInference sidecar fields when needed. When `include_content=true`, trace also returns the full [D062](../../DECISIONS.md#d062-local-mirror-sidecar--two-tier-private-local--public-canonical-persistence) local mirror body as `local_content` plus `local_producer`; this is intended for harness-mediated causal replay where the agent needs rich expected/actual outcome context. Without the sidecar (legacy entries), the per-record output still includes the cryptographic evidence (event_type, hashes, creator_key, timestamp), just without semantic context.
 
 ## Behaviors
 

package/dist/index.d.ts

@@ -37,6 +37,10 @@ interface CompactVisited {
      */
     sidecar_summary?: {
         tool_name?: string;
+        span_kind?: string;
+        span_name?: string;
+        model_name?: string;
+        prompt_version?: string;
         topics?: string[];
         /**
          * First 200 chars of the record's human-readable content, derived

package/dist/index.js

@@ -54,6 +54,17 @@ export function summarizeSidecar(loadedRecord) {
     if (sc.producer)
         out.producer = sc.producer;
     const c = sc.content;
+    if (!out.tool_name && c && typeof c['tool_name'] === 'string') {
+        out.tool_name = c['tool_name'];
+    }
+    if (c && typeof c['span_kind'] === 'string')
+        out.span_kind = c['span_kind'];
+    if (c && typeof c['span_name'] === 'string')
+        out.span_name = c['span_name'];
+    if (c && typeof c['model_name'] === 'string')
+        out.model_name = c['model_name'];
+    if (c && typeof c['prompt_version'] === 'string')
+        out.prompt_version = c['prompt_version'];
     if (c && Array.isArray(c['topics'])) {
         out.topics = c['topics'].filter((t) => typeof t === 'string').slice(0, 6);
     }
@@ -63,7 +74,7 @@ export function summarizeSidecar(loadedRecord) {
     // an explicit final fallback to `summary` for legacy records.
     //   observation: content.what
     //   annotation:  content.summary
-    //   revision:    content.new_position (D086-normative) — surface this
+    //   revision:    content.new_position (D086-normative). Surface this
     //                so trace consumers can read the agent's stance shift
     //                without a separate recall call
     //   legacy:      content.summary (catches pre-D086 extractor records)
@@ -78,6 +89,12 @@ export function summarizeSidecar(loadedRecord) {
         else if (typeof c['summary'] === 'string') {
             primary = c['summary'];
         }
+        else if (typeof c['prompt'] === 'string') {
+            primary = c['prompt'];
+        }
+        else if (typeof c['output'] === 'string') {
+            primary = c['output'];
+        }
         if (primary) {
             out.what = primary.length > 200 ? primary.slice(0, 197) + '…' : primary;
         }

package/dist/storage.d.ts

@@ -19,7 +19,7 @@ export interface IndexedRecord {
  * (mcp-wrap writes toolName/args/result; atrib-emit writes content).
  */
 export interface SidecarPayload extends OnRecordSidecar {
-    content?: Record<string, unknown>;
+    content?: unknown;
     producer?: string;
 }
 /**

package/dist/storage.js

@@ -13,7 +13,7 @@
 import { existsSync, readFileSync, readdirSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { basename, join } from 'node:path';
-import { canonicalRecord, hexEncode, sha256 } from '@atrib/mcp';
+import { canonicalRecord, hexEncode, sha256, withDerivedLocalContent, } from '@atrib/mcp';
 const RECORDS_FILE = process.env.ATRIB_RECORD_FILE;
 const RECORDS_DIR = process.env.ATRIB_RECORDS_DIR ?? join(homedir(), '.atrib', 'records');
 /**
@@ -73,7 +73,7 @@ export function loadAllRecords(dir = RECORDS_DIR) {
                     if (isEnvelope) {
                         const sidecar = parsed._local;
                         if (sidecar)
-                            indexed.local = sidecar;
+                            indexed.local = withDerivedLocalContent(rec.event_type, sidecar);
                     }
                     byHash.set(indexed.record_hash, indexed);
                     all.push(indexed);

package/package.json

@@ -1,7 +1,21 @@
 {
   "name": "@atrib/trace",
-  "version": "0.5.3",
+  "version": "0.5.5",
   "description": "MCP server for atrib. Walks informed_by chains backward from a record_hash to surface the reasoning chain that produced it.",
+  "author": "atrib <hello@atrib.dev>",
+  "keywords": [
+    "atrib",
+    "mcp",
+    "model-context-protocol",
+    "attribution",
+    "verifiable",
+    "agent",
+    "cognitive-primitive",
+    "trace",
+    "provenance",
+    "causal-chain"
+  ],
+  "homepage": "https://atrib.dev",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./dist/index.js",
@@ -11,7 +25,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
     "zod": "^3.25.76",
-    "@atrib/mcp": "0.14.0"
+    "@atrib/mcp": "0.15.0"
   },
   "devDependencies": {
     "@types/node": "^25.9.1",