agentfootprint-lens 0.28.0 → 0.29.0

package/README.md

@@ -279,6 +279,18 @@ stop();
 
 The standard agentfootprint introspection methods. `<Lens for={...}>` reads these automatically. You only call them yourself if you're building a custom UI.
 
+### `<WhereFrom>` — walk any value's causes on the one cursor
+
+In the engineer view's detail panel, the cursor stage's written keys render
+as chips; picking one shows the backward slice that produced its value
+(footprintjs `sliceForKey` — the same query the `backtrack` LLM tool runs).
+**◀ Walk the causes** freezes that slice as reverse-time stops and steps the
+ONE cursor through them ("◀ earlier cause / toward result ▶") — both parents
+of a fork are always visited, the chart cone follows the walk, and
+**[Copy story]** emits the exact `formatSlice` text the LLM tool returns.
+Honest absence stays honest: "never written — initial state / args / a
+closure", and reads-off runs say "unknowable, not absent".
+
 ### `useLiveTimeline()` (escape hatch)
 
 Returns `{ timeline, ingest, startTurn, reset, builder }`. Use when you want to feed Lens from a non-runner source (replayed logs, server-sent events, etc.).

package/dist/{chunk-UBBSNJXC.js → chunk-2XM65URD.js}

@@ -2283,7 +2283,7 @@ function expandSubflowInternals(subflows) {
 }
 
 // src/core/cursorProvenance.ts
-import { flattenCausalDAG, keysReadFromExecutionTree, sliceForKey } from "footprintjs/trace";
+import { flattenCausalDAG, formatSlice, keysReadFromExecutionTree, sliceForKey } from "footprintjs/trace";
 function getSnapshotOf(runner) {
   const fn = runner?.getLastSnapshot;
   if (typeof fn !== "function") return void 0;
@@ -2304,13 +2304,16 @@ function cursorProvenance(runner, cursorRuntimeStageId) {
   const reads = keysReadFromExecutionTree(
     snapshot?.executionTree ?? { id: "__none__", logs: {}, errors: {}, metrics: {}, evals: {} }
   );
+  const lastCommitIdxOf = /* @__PURE__ */ new Map();
+  for (let i = 0; i <= lastIdx; i++) lastCommitIdxOf.set(log[i].runtimeStageId, i);
   const sliceFor = (key) => {
     const slice = sliceForKey(log, key, reads, {
       before: lastIdx + 1
     });
     const readsWarning = slice.readsCoverage !== void 0 && slice.readsCoverage.steps > 1 && slice.readsCoverage.stepsWithReads === 0;
+    const story = formatSlice(slice);
     if (!slice.root) {
-      return { key, frames: [], readsWarning, ...slice.missing !== void 0 && { missing: slice.missing } };
+      return { key, frames: [], readsWarning, story, ...slice.missing !== void 0 && { missing: slice.missing } };
     }
     const frames = flattenCausalDAG(slice.root).map((n) => ({
       runtimeStageId: n.runtimeStageId,
@@ -2318,9 +2321,10 @@ function cursorProvenance(runner, cursorRuntimeStageId) {
       stageId: n.stageId,
       keysWritten: n.keysWritten,
       linkedBy: n.linkedBy,
-      depth: n.depth
+      depth: n.depth,
+      commitIdx: lastCommitIdxOf.get(n.runtimeStageId) ?? -1
     }));
-    return { key, frames, readsWarning };
+    return { key, frames, readsWarning, story };
   };
   return { writtenKeys: [...written], sliceFor };
 }
@@ -2573,4 +2577,4 @@ export {
   defaultSize,
   layoutLensGraph
 };
-//# sourceMappingURL=chunk-UBBSNJXC.js.map
+//# sourceMappingURL=chunk-2XM65URD.js.map