agentfootprint-lens 0.23.10 → 0.26.0

package/README.md

@@ -1,5 +1,7 @@
 # agentfootprint-lens
 
+_Part of the **[footprintjs ecosystem](https://footprintjs.github.io/)** — the self-explaining stack._
+
 > **See the context engineering as it happens.**
 >
 > React components for watching agents built on [`agentfootprint`](https://www.npmjs.com/package/agentfootprint). Every injection into the Agent's slots (RAG, Memory, Skills, Instructions, Tools) is tagged inline — students and engineers see exactly what was put into the prompt, by whom, on which iteration. No hidden abstractions.
@@ -296,6 +298,20 @@ This is the observer pattern, applied consistently across every agentfootprint r
 
 ---
 
+## The footprintjs ecosystem
+
+The self-explaining stack — from backend pipelines to AI agents. → **[overview](https://footprintjs.github.io/)**
+
+| Project | Role |
+|---|---|
+| [footprintjs](https://footprintjs.github.io/footPrint/) | the flowchart pattern (core engine) |
+| [agentfootprint](https://footprintjs.github.io/agentfootprint/) | build self-explaining AI agents |
+| [Explainable UI](https://footprintjs.github.io/explainable-ui/) | visualize a footprintjs run |
+| **Lens** ← you are here | debug an agentfootprint run |
+| [Thinking UI](https://footprintjs.github.io/agentThinkingUI/) | replay an agent run for non-devs |
+
+---
+
 ## License
 
 MIT

package/dist/{chunk-ZJKD43L7.js → chunk-GIYBC66K.js}

@@ -5,9 +5,7 @@ import {
 // src/core/LensRecorder.ts
 import { isDevMode } from "footprintjs";
 import { SequenceStore } from "footprintjs/trace";
-import {
-  ALL_EVENT_TYPES
-} from "agentfootprint";
+import { ALL_EVENT_TYPES } from "agentfootprint/events";
 import { LiveStateRecorder, BoundaryRecorder } from "agentfootprint/observe";
 import {
   createTraceRuntimeOverlay
@@ -2135,10 +2133,10 @@ function slotKindForLocalId(localId) {
   if (localId === "sf-tools") return "tools";
   return void 0;
 }
-function structureGraphFromRunner(runner) {
-  return structureGraphFromSpec(runner.getSpec().buildTimeStructure);
+function structureGraphFromRunner(runner, opts) {
+  return structureGraphFromSpec(runner.getSpec().buildTimeStructure, opts);
 }
-function structureGraphFromSpec(buildTimeStructure) {
+function structureGraphFromSpec(buildTimeStructure, opts) {
   const trace = createTraceStructureRecorder();
   const recorder = trace.recorder;
   const spec = buildTimeStructure;
@@ -2197,22 +2195,24 @@ function structureGraphFromSpec(buildTimeStructure) {
     ...baseGraph.edges,
     ...internal.edges.filter((e) => !seenEdges.has(e.id))
   ];
-  for (const node of nodes) {
-    const role = stageRole(node.id);
-    const data = node.data;
-    const { localStageId } = splitStageId(node.id);
-    const emphasis = emphasisForRole(role);
-    if (emphasis !== void 0) data.emphasis = emphasis;
-    if (data.icon === void 0) {
-      const icon = iconForRole(localStageId, role);
-      if (icon !== void 0) data.icon = icon;
-    }
-    const size = sizeForRole(role);
-    if (size !== void 0) data.size = size;
-    if (role === "hero-slot") {
-      node.type = "slotPill";
-      const slotKind = slotKindForLocalId(localStageId);
-      if (slotKind !== void 0) data.slotKind = slotKind;
+  if (opts?.decorate !== false) {
+    for (const node of nodes) {
+      const role = stageRole(node.id);
+      const data = node.data;
+      const { localStageId } = splitStageId(node.id);
+      const emphasis = emphasisForRole(role);
+      if (emphasis !== void 0) data.emphasis = emphasis;
+      if (data.icon === void 0) {
+        const icon = iconForRole(localStageId, role);
+        if (icon !== void 0) data.icon = icon;
+      }
+      const size = sizeForRole(role);
+      if (size !== void 0) data.size = size;
+      if (role === "hero-slot") {
+        node.type = "slotPill";
+        const slotKind = slotKindForLocalId(localStageId);
+        if (slotKind !== void 0) data.slotKind = slotKind;
+      }
     }
   }
   return { ...baseGraph, nodes, edges };
@@ -2282,6 +2282,16 @@ function expandSubflowInternals(subflows) {
   return { nodes, edges };
 }
 
+// src/core/explainableShellProps.ts
+function explainableShellPropsFromRunner(agent, recorder) {
+  return {
+    runtimeSnapshot: agent.getLastSnapshot() ?? null,
+    narrativeEntries: [...agent.getLastNarrativeEntries()],
+    traceGraph: structureGraphFromRunner(agent),
+    runtimeOverlay: recorder.runtime.getOverlay()
+  };
+}
+
 // src/core/render/toReactFlow.ts
 var DEFAULT_STAGE_SIZE = { width: 180, height: 56 };
 var DEFAULT_GROUP_SIZE = { width: 260, height: 120 };
@@ -2514,8 +2524,9 @@ export {
   lensGroupTranslator,
   structureGraphFromRunner,
   structureGraphFromSpec,
+  explainableShellPropsFromRunner,
   toReactFlow,
   defaultSize,
   layoutLensGraph
 };
-//# sourceMappingURL=chunk-ZJKD43L7.js.map
+//# sourceMappingURL=chunk-GIYBC66K.js.map