agentfootprint-lens 0.26.2 → 0.27.0

package/dist/{chunk-JGB5GEQK.js → chunk-UBBSNJXC.js}

@@ -2282,6 +2282,49 @@ function expandSubflowInternals(subflows) {
   return { nodes, edges };
 }
 
+// src/core/cursorProvenance.ts
+import { flattenCausalDAG, keysReadFromExecutionTree, sliceForKey } from "footprintjs/trace";
+function getSnapshotOf(runner) {
+  const fn = runner?.getLastSnapshot;
+  if (typeof fn !== "function") return void 0;
+  return fn.call(runner);
+}
+function cursorProvenance(runner, cursorRuntimeStageId) {
+  const snapshot = getSnapshotOf(runner);
+  const log = snapshot?.commitLog;
+  if (!log?.length || !cursorRuntimeStageId) return void 0;
+  let lastIdx = -1;
+  const written = /* @__PURE__ */ new Set();
+  for (let i = 0; i < log.length; i++) {
+    if (log[i].runtimeStageId !== cursorRuntimeStageId) continue;
+    lastIdx = i;
+    for (const t of log[i].trace) written.add(t.path);
+  }
+  if (lastIdx < 0 || written.size === 0) return void 0;
+  const reads = keysReadFromExecutionTree(
+    snapshot?.executionTree ?? { id: "__none__", logs: {}, errors: {}, metrics: {}, evals: {} }
+  );
+  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;
+    if (!slice.root) {
+      return { key, frames: [], readsWarning, ...slice.missing !== void 0 && { missing: slice.missing } };
+    }
+    const frames = flattenCausalDAG(slice.root).map((n) => ({
+      runtimeStageId: n.runtimeStageId,
+      stageName: n.stageName,
+      stageId: n.stageId,
+      keysWritten: n.keysWritten,
+      linkedBy: n.linkedBy,
+      depth: n.depth
+    }));
+    return { key, frames, readsWarning };
+  };
+  return { writtenKeys: [...written], sliceFor };
+}
+
 // src/core/explainableShellProps.ts
 function explainableShellPropsFromRunner(agent, recorder) {
   return {
@@ -2524,9 +2567,10 @@ export {
   lensGroupTranslator,
   structureGraphFromRunner,
   structureGraphFromSpec,
+  cursorProvenance,
   explainableShellPropsFromRunner,
   toReactFlow,
   defaultSize,
   layoutLensGraph
 };
-//# sourceMappingURL=chunk-JGB5GEQK.js.map
+//# sourceMappingURL=chunk-UBBSNJXC.js.map