agentfootprint-lens 0.6.1 → 0.7.0

package/dist/core.d.cts

@@ -1,161 +1,36 @@
+import { AgentTimeline as AgentTimeline$1 } from 'agentfootprint';
+export { AgentIteration, AgentMessage, AgentToolCallStub, AgentToolInvocation, AgentTurn } from 'agentfootprint';
+
 /**
- * Agent-shaped view of a run, derived from an agentfootprint runtime
- * snapshot. Lens panels render against this — NOT against the raw
- * snapshot — so internal agentfootprint representation can evolve
- * without breaking the UI contract.
- */
-interface AgentMessage {
-    readonly role: "system" | "user" | "assistant" | "tool";
-    readonly content: string;
-    readonly toolCalls?: readonly AgentToolCallStub[];
-    readonly toolCallId?: string;
-}
-/** A tool call as it appears on an assistant message (reference only). */
-interface AgentToolCallStub {
-    readonly id: string;
-    readonly name: string;
-    readonly arguments: Record<string, unknown>;
-}
-/** A resolved tool invocation with args + result + timing. */
-interface AgentToolInvocation {
-    readonly id: string;
-    readonly name: string;
-    readonly arguments: Record<string, unknown>;
-    readonly result: string;
-    readonly error?: boolean;
-    readonly decisionUpdate?: Record<string, unknown>;
-    /** Iteration within the turn this invocation belongs to. 1-based. */
-    readonly iterationIndex: number;
-    /** Turn index (0-based). */
-    readonly turnIndex: number;
-    /** Duration in ms, or undefined if the recorder didn't capture it. */
-    readonly durationMs?: number;
-}
-/**
- * A single context injection captured on this iteration — e.g. RAG
- * adding chunks to Messages, a Skill activating a prompt, Memory
- * re-injecting prior turns, Instructions firing per-tool guidance.
+ * Lens type surface — re-exports the canonical agent-shaped types from
+ * agentfootprint so Lens and any other UI consumer share one source of
+ * truth.
+ *
+ * Why not define these in Lens:
  *
- * Rendered as a tag inside the Agent card's slot
- * (system-prompt / messages / tools). The library emits these
- * via `agentfootprint.context.*` events; Lens keeps the ones that
- * fire between an iteration's `llm_start` and the same iteration's
- * `llm_end`, plus any that fire BEFORE the first `llm_start` (those
- * apply to iteration 1's context — same mental model).
+ *   The agent-shaped narrative (turns → iterations → tool calls +
+ *   context injections + ledger) is the DATA CONTRACT, not a UI
+ *   concept. Defining it in Lens would mean every other UI library
+ *   (Grafana panels, CLI debuggers, replay viewers) re-implements the
+ *   same translation from emit events. Mirrors how footprintjs owns
+ *   `NarrativeEntry` and every shell consumes it.
  *
- * This is the library's teaching surface — each injection says
- * WHO (source) and WHERE (slot) it flowed into, so students can see
- * that "RAG isn't magic — it just added N chunks into Messages".
+ *   Lens only adds UI-leaning types that don't belong in the data
+ *   library:
+ *     • `LensSkill` — UI skill detail card with raw-JSON escape hatch
+ *     • `AgentTimeline` — extends the agentfootprint base with an
+ *       optional `rawSnapshot` field the snapshot-import adapter uses
  */
-interface AgentContextInjection {
-    /** Short source name — `rag`, `skill`, `memory`, `instructions`, etc. */
-    readonly source: string;
-    /** Which Agent slot this injection targets. */
-    readonly slot: "system-prompt" | "messages" | "tools";
-    /** Short human label for the Lens tag — e.g. "3 chunks · top 0.95". */
-    readonly label: string;
-    /**
-     * Wire-level LLM role of the injected content when it lands in the
-     * `messages` slot. `system` for classical RAG, `tool` for agentic
-     * RAG tool results, `user` for rare pre-pend patterns, undefined for
-     * system-prompt / tools slot targets (those have no role — they
-     * mutate the slot directly).
-     */
-    readonly role?: "system" | "user" | "assistant" | "tool";
-    /**
-     * Index in `messages[]` where the injected message landed — lets the
-     * "Inspect messages" drill-down jump straight to the row. Only set
-     * for messages-slot injections.
-     */
-    readonly targetIndex?: number;
-    /**
-     * Per-slot count deltas this injection contributed. Drives the
-     * per-iteration ledger shown on the Agent card ("system +2,
-     * tools +3"). Keys are intentionally open — new injection sources
-     * can introduce new counters without a schema change.
-     */
-    readonly deltaCount?: Record<string, number | boolean>;
-    /** Raw payload from the emit event — available in the expand-drawer. */
-    readonly payload: Record<string, unknown>;
-}
+
 /**
- * Per-iteration accumulated ledger — sums every injection's deltaCount
- * so the Agent card can show "system +2 · tools +3 · systemPromptChars +1200"
- * without re-walking the injection list every render. Computed lazily
- * in `getTimeline()` from the iteration's `contextInjections`.
- *
- * Keys are open-ended (match deltaCount shape); standard keys the UI
- * knows about today: `system` | `user` | `assistant` | `tool`
- * (message-role counters), `systemPromptChars` (char growth),
- * `tools` (tool-slot additions).
+ * Lens-flavored AgentTimeline. Adds the optional `rawSnapshot` escape
+ * hatch used by the snapshot-import adapter (`fromAgentSnapshot`) —
+ * consumers who already have a runtime snapshot pass it through for
+ * advanced panels (custom extensions reading `sharedState` directly).
+ * The live-recorder path leaves this undefined; no cost when unused.
  */
-type AgentContextLedger = Record<string, number | boolean>;
-/** One LLM call + its tool loop. */
-interface AgentIteration {
-    readonly index: number;
-    readonly inputTokens?: number;
-    readonly outputTokens?: number;
-    readonly model?: string;
-    readonly durationMs?: number;
-    readonly stopReason?: string;
-    /** Raw assistant text (may be empty when tool calls are present). */
-    readonly assistantContent: string;
-    /** Tool calls the LLM requested in this iteration. */
-    readonly toolCalls: readonly AgentToolInvocation[];
-    /** Decision scope observed at the start of this iteration. */
-    readonly decisionAtStart: Record<string, unknown>;
-    /** Instruction ids that matched on this iteration (if captured). */
-    readonly matchedInstructions?: readonly string[];
-    /** Tool names visible to the LLM on this iteration. */
-    readonly visibleTools: readonly string[];
-    /**
-     * Context injections that shaped this iteration's prompt —
-     * RAG chunks, skill activations, memory writes, instructions fired.
-     * Empty when the iteration ran with just the static base context.
-     */
-    readonly contextInjections: readonly AgentContextInjection[];
-    /**
-     * Accumulated ledger for this iteration — sum of every injection's
-     * `deltaCount`. Drives the per-slot counter badges on the Agent card
-     * (e.g. "system +2" on the Messages slot, "+1200 chars" on System
-     * Prompt). Empty object when the iteration had no injections.
-     */
-    readonly contextLedger: AgentContextLedger;
-    /**
-     * Number of messages in the conversation at the moment `llm_start`
-     * fired. `timeline.messages.slice(0, messagesSentCount)` yields
-     * exactly what the LLM saw on this iteration (minus system prompt +
-     * tool list — those come from a future richer llm_start event).
-     * Enables the "What Neo saw" expander in MessagesPanel.
-     */
-    readonly messagesSentCount: number;
-}
-/** One `.run()` call. Multi-turn conversations stack these. */
-interface AgentTurn {
-    readonly index: number;
-    readonly userPrompt: string;
-    readonly iterations: readonly AgentIteration[];
-    /** Final assistant content after the last iteration. */
-    readonly finalContent: string;
-    readonly totalInputTokens: number;
-    readonly totalOutputTokens: number;
-    readonly totalDurationMs: number;
-    /**
-     * All context injections that fired during this turn, in emission
-     * order — flat union of every iteration's `contextInjections`.
-     * Surfaces "what context engineering happened this turn" without
-     * requiring the user to scrub to a specific iteration. AskCard reads
-     * this when the focused stage isn't bound to an iter (e.g. the
-     * initial User → Agent edge before iter 1 fires).
-     */
-    readonly contextInjections: readonly AgentContextInjection[];
-    /**
-     * Turn-level accumulated ledger — sum of every iteration's
-     * `contextLedger`. Drives the turn-summary chips on the StageFlow
-     * Agent card when no iter is active, so users always see the
-     * cumulative context-engineering picture for the current turn.
-     */
-    readonly contextLedger: AgentContextLedger;
+interface AgentTimeline extends AgentTimeline$1 {
+    readonly rawSnapshot?: any;
 }
 /**
  * A skill as it reaches Lens. Consumers pass these in from their
@@ -163,6 +38,9 @@ interface AgentTurn {
  * required — everything else is best-effort, and extra fields pass
  * through via the index signature so the raw-JSON view is useful for
  * debugging even when skills carry custom metadata.
+ *
+ * Lens-only (no agentfootprint equivalent) because "a skill with a
+ * raw-JSON debug view" is specifically a UI concern.
  */
 interface LensSkill {
     readonly id: string;
@@ -177,18 +55,6 @@ interface LensSkill {
     /** Everything else on the skill object passes through for raw-JSON view. */
     readonly [key: string]: unknown;
 }
-/** The full picture: every turn stitched together. */
-interface AgentTimeline {
-    readonly turns: readonly AgentTurn[];
-    /** Full message array, flat — convenient for the Messages panel. */
-    readonly messages: readonly AgentMessage[];
-    /** Flat tool invocation list across all turns — for the Inspector. */
-    readonly tools: readonly AgentToolInvocation[];
-    /** Final decision scope at end of run. */
-    readonly finalDecision: Record<string, unknown>;
-    /** The raw runtime snapshot — escape hatch for advanced panels. */
-    readonly rawSnapshot: any;
-}
 
 /**
  * LiveTimelineBuilder — ingests agentfootprint emit events AS THEY HAPPEN
@@ -481,4 +347,4 @@ interface Stage {
 }
 declare function deriveStages(timeline: AgentTimeline): Stage[];
 
-export { type AgentIteration, type AgentMessage, type AgentTimeline, type AgentToolCallStub, type AgentToolInvocation, type AgentTurn, type LensSkill, LiveTimelineBuilder, type Stage, type StageMutations, type StageNodeId, type StagePrimitive, deriveStages, fromAgentSnapshot };
+export { type AgentTimeline, type LensSkill, LiveTimelineBuilder, type Stage, type StageMutations, type StageNodeId, type StagePrimitive, deriveStages, fromAgentSnapshot };

package/dist/core.d.ts

@@ -1,161 +1,36 @@
+import { AgentTimeline as AgentTimeline$1 } from 'agentfootprint';
+export { AgentIteration, AgentMessage, AgentToolCallStub, AgentToolInvocation, AgentTurn } from 'agentfootprint';
+
 /**
- * Agent-shaped view of a run, derived from an agentfootprint runtime
- * snapshot. Lens panels render against this — NOT against the raw
- * snapshot — so internal agentfootprint representation can evolve
- * without breaking the UI contract.
- */
-interface AgentMessage {
-    readonly role: "system" | "user" | "assistant" | "tool";
-    readonly content: string;
-    readonly toolCalls?: readonly AgentToolCallStub[];
-    readonly toolCallId?: string;
-}
-/** A tool call as it appears on an assistant message (reference only). */
-interface AgentToolCallStub {
-    readonly id: string;
-    readonly name: string;
-    readonly arguments: Record<string, unknown>;
-}
-/** A resolved tool invocation with args + result + timing. */
-interface AgentToolInvocation {
-    readonly id: string;
-    readonly name: string;
-    readonly arguments: Record<string, unknown>;
-    readonly result: string;
-    readonly error?: boolean;
-    readonly decisionUpdate?: Record<string, unknown>;
-    /** Iteration within the turn this invocation belongs to. 1-based. */
-    readonly iterationIndex: number;
-    /** Turn index (0-based). */
-    readonly turnIndex: number;
-    /** Duration in ms, or undefined if the recorder didn't capture it. */
-    readonly durationMs?: number;
-}
-/**
- * A single context injection captured on this iteration — e.g. RAG
- * adding chunks to Messages, a Skill activating a prompt, Memory
- * re-injecting prior turns, Instructions firing per-tool guidance.
+ * Lens type surface — re-exports the canonical agent-shaped types from
+ * agentfootprint so Lens and any other UI consumer share one source of
+ * truth.
+ *
+ * Why not define these in Lens:
  *
- * Rendered as a tag inside the Agent card's slot
- * (system-prompt / messages / tools). The library emits these
- * via `agentfootprint.context.*` events; Lens keeps the ones that
- * fire between an iteration's `llm_start` and the same iteration's
- * `llm_end`, plus any that fire BEFORE the first `llm_start` (those
- * apply to iteration 1's context — same mental model).
+ *   The agent-shaped narrative (turns → iterations → tool calls +
+ *   context injections + ledger) is the DATA CONTRACT, not a UI
+ *   concept. Defining it in Lens would mean every other UI library
+ *   (Grafana panels, CLI debuggers, replay viewers) re-implements the
+ *   same translation from emit events. Mirrors how footprintjs owns
+ *   `NarrativeEntry` and every shell consumes it.
  *
- * This is the library's teaching surface — each injection says
- * WHO (source) and WHERE (slot) it flowed into, so students can see
- * that "RAG isn't magic — it just added N chunks into Messages".
+ *   Lens only adds UI-leaning types that don't belong in the data
+ *   library:
+ *     • `LensSkill` — UI skill detail card with raw-JSON escape hatch
+ *     • `AgentTimeline` — extends the agentfootprint base with an
+ *       optional `rawSnapshot` field the snapshot-import adapter uses
  */
-interface AgentContextInjection {
-    /** Short source name — `rag`, `skill`, `memory`, `instructions`, etc. */
-    readonly source: string;
-    /** Which Agent slot this injection targets. */
-    readonly slot: "system-prompt" | "messages" | "tools";
-    /** Short human label for the Lens tag — e.g. "3 chunks · top 0.95". */
-    readonly label: string;
-    /**
-     * Wire-level LLM role of the injected content when it lands in the
-     * `messages` slot. `system` for classical RAG, `tool` for agentic
-     * RAG tool results, `user` for rare pre-pend patterns, undefined for
-     * system-prompt / tools slot targets (those have no role — they
-     * mutate the slot directly).
-     */
-    readonly role?: "system" | "user" | "assistant" | "tool";
-    /**
-     * Index in `messages[]` where the injected message landed — lets the
-     * "Inspect messages" drill-down jump straight to the row. Only set
-     * for messages-slot injections.
-     */
-    readonly targetIndex?: number;
-    /**
-     * Per-slot count deltas this injection contributed. Drives the
-     * per-iteration ledger shown on the Agent card ("system +2,
-     * tools +3"). Keys are intentionally open — new injection sources
-     * can introduce new counters without a schema change.
-     */
-    readonly deltaCount?: Record<string, number | boolean>;
-    /** Raw payload from the emit event — available in the expand-drawer. */
-    readonly payload: Record<string, unknown>;
-}
+
 /**
- * Per-iteration accumulated ledger — sums every injection's deltaCount
- * so the Agent card can show "system +2 · tools +3 · systemPromptChars +1200"
- * without re-walking the injection list every render. Computed lazily
- * in `getTimeline()` from the iteration's `contextInjections`.
- *
- * Keys are open-ended (match deltaCount shape); standard keys the UI
- * knows about today: `system` | `user` | `assistant` | `tool`
- * (message-role counters), `systemPromptChars` (char growth),
- * `tools` (tool-slot additions).
+ * Lens-flavored AgentTimeline. Adds the optional `rawSnapshot` escape
+ * hatch used by the snapshot-import adapter (`fromAgentSnapshot`) —
+ * consumers who already have a runtime snapshot pass it through for
+ * advanced panels (custom extensions reading `sharedState` directly).
+ * The live-recorder path leaves this undefined; no cost when unused.
  */
-type AgentContextLedger = Record<string, number | boolean>;
-/** One LLM call + its tool loop. */
-interface AgentIteration {
-    readonly index: number;
-    readonly inputTokens?: number;
-    readonly outputTokens?: number;
-    readonly model?: string;
-    readonly durationMs?: number;
-    readonly stopReason?: string;
-    /** Raw assistant text (may be empty when tool calls are present). */
-    readonly assistantContent: string;
-    /** Tool calls the LLM requested in this iteration. */
-    readonly toolCalls: readonly AgentToolInvocation[];
-    /** Decision scope observed at the start of this iteration. */
-    readonly decisionAtStart: Record<string, unknown>;
-    /** Instruction ids that matched on this iteration (if captured). */
-    readonly matchedInstructions?: readonly string[];
-    /** Tool names visible to the LLM on this iteration. */
-    readonly visibleTools: readonly string[];
-    /**
-     * Context injections that shaped this iteration's prompt —
-     * RAG chunks, skill activations, memory writes, instructions fired.
-     * Empty when the iteration ran with just the static base context.
-     */
-    readonly contextInjections: readonly AgentContextInjection[];
-    /**
-     * Accumulated ledger for this iteration — sum of every injection's
-     * `deltaCount`. Drives the per-slot counter badges on the Agent card
-     * (e.g. "system +2" on the Messages slot, "+1200 chars" on System
-     * Prompt). Empty object when the iteration had no injections.
-     */
-    readonly contextLedger: AgentContextLedger;
-    /**
-     * Number of messages in the conversation at the moment `llm_start`
-     * fired. `timeline.messages.slice(0, messagesSentCount)` yields
-     * exactly what the LLM saw on this iteration (minus system prompt +
-     * tool list — those come from a future richer llm_start event).
-     * Enables the "What Neo saw" expander in MessagesPanel.
-     */
-    readonly messagesSentCount: number;
-}
-/** One `.run()` call. Multi-turn conversations stack these. */
-interface AgentTurn {
-    readonly index: number;
-    readonly userPrompt: string;
-    readonly iterations: readonly AgentIteration[];
-    /** Final assistant content after the last iteration. */
-    readonly finalContent: string;
-    readonly totalInputTokens: number;
-    readonly totalOutputTokens: number;
-    readonly totalDurationMs: number;
-    /**
-     * All context injections that fired during this turn, in emission
-     * order — flat union of every iteration's `contextInjections`.
-     * Surfaces "what context engineering happened this turn" without
-     * requiring the user to scrub to a specific iteration. AskCard reads
-     * this when the focused stage isn't bound to an iter (e.g. the
-     * initial User → Agent edge before iter 1 fires).
-     */
-    readonly contextInjections: readonly AgentContextInjection[];
-    /**
-     * Turn-level accumulated ledger — sum of every iteration's
-     * `contextLedger`. Drives the turn-summary chips on the StageFlow
-     * Agent card when no iter is active, so users always see the
-     * cumulative context-engineering picture for the current turn.
-     */
-    readonly contextLedger: AgentContextLedger;
+interface AgentTimeline extends AgentTimeline$1 {
+    readonly rawSnapshot?: any;
 }
 /**
  * A skill as it reaches Lens. Consumers pass these in from their
@@ -163,6 +38,9 @@ interface AgentTurn {
  * required — everything else is best-effort, and extra fields pass
  * through via the index signature so the raw-JSON view is useful for
  * debugging even when skills carry custom metadata.
+ *
+ * Lens-only (no agentfootprint equivalent) because "a skill with a
+ * raw-JSON debug view" is specifically a UI concern.
  */
 interface LensSkill {
     readonly id: string;
@@ -177,18 +55,6 @@ interface LensSkill {
     /** Everything else on the skill object passes through for raw-JSON view. */
     readonly [key: string]: unknown;
 }
-/** The full picture: every turn stitched together. */
-interface AgentTimeline {
-    readonly turns: readonly AgentTurn[];
-    /** Full message array, flat — convenient for the Messages panel. */
-    readonly messages: readonly AgentMessage[];
-    /** Flat tool invocation list across all turns — for the Inspector. */
-    readonly tools: readonly AgentToolInvocation[];
-    /** Final decision scope at end of run. */
-    readonly finalDecision: Record<string, unknown>;
-    /** The raw runtime snapshot — escape hatch for advanced panels. */
-    readonly rawSnapshot: any;
-}
 
 /**
  * LiveTimelineBuilder — ingests agentfootprint emit events AS THEY HAPPEN
@@ -481,4 +347,4 @@ interface Stage {
 }
 declare function deriveStages(timeline: AgentTimeline): Stage[];
 
-export { type AgentIteration, type AgentMessage, type AgentTimeline, type AgentToolCallStub, type AgentToolInvocation, type AgentTurn, type LensSkill, LiveTimelineBuilder, type Stage, type StageMutations, type StageNodeId, type StagePrimitive, deriveStages, fromAgentSnapshot };
+export { type AgentTimeline, type LensSkill, LiveTimelineBuilder, type Stage, type StageMutations, type StageNodeId, type StagePrimitive, deriveStages, fromAgentSnapshot };

package/dist/index.d.cts

@@ -1,5 +1,6 @@
-export { AgentIteration, AgentMessage, AgentTimeline, AgentToolCallStub, AgentToolInvocation, AgentTurn, LensSkill, LiveTimelineBuilder, Stage, StageMutations, StageNodeId, StagePrimitive, deriveStages, fromAgentSnapshot } from './core.cjs';
+export { AgentTimeline, LensSkill, LiveTimelineBuilder, Stage, StageMutations, StageNodeId, StagePrimitive, deriveStages, fromAgentSnapshot } from './core.cjs';
 export { AgentLens, AgentLensProps, AskCard, AskCardProps, FillParent, FillParentProps, FocusRegion, FocusRegionProps, FocusState, IterationStrip, IterationStripProps, Lens, LensProps, LensRunner, LensTheme, MessagesPanel, MessagesPanelProps, RunSummary, RunSummaryProps, Scroller, ScrollerProps, SelfSizingRoot, SelfSizingRootProps, SkillsPanel, SkillsPanelProps, Stack, StackProps, StageFlow, StageFlowProps, Surface, SurfacePalette, SurfaceProps, SurfaceVariant, TabDef, Table, TableColumn, TableProps, Tabs, TabsProps, TimeTravel, TimeTravelProps, ToolCallInspector, ToolCallInspectorProps, UseLiveTimelineResult, resolveLensTheme, useFocusTracking, useLens, useLensTheme, useLiveTimeline } from './react.cjs';
+export { AgentIteration, AgentMessage, AgentToolCallStub, AgentToolInvocation, AgentTurn } from 'agentfootprint';
 import 'react/jsx-runtime';
 import 'react';
 import 'footprint-explainable-ui';

package/dist/index.d.ts

@@ -1,5 +1,6 @@
-export { AgentIteration, AgentMessage, AgentTimeline, AgentToolCallStub, AgentToolInvocation, AgentTurn, LensSkill, LiveTimelineBuilder, Stage, StageMutations, StageNodeId, StagePrimitive, deriveStages, fromAgentSnapshot } from './core.js';
+export { AgentTimeline, LensSkill, LiveTimelineBuilder, Stage, StageMutations, StageNodeId, StagePrimitive, deriveStages, fromAgentSnapshot } from './core.js';
 export { AgentLens, AgentLensProps, AskCard, AskCardProps, FillParent, FillParentProps, FocusRegion, FocusRegionProps, FocusState, IterationStrip, IterationStripProps, Lens, LensProps, LensRunner, LensTheme, MessagesPanel, MessagesPanelProps, RunSummary, RunSummaryProps, Scroller, ScrollerProps, SelfSizingRoot, SelfSizingRootProps, SkillsPanel, SkillsPanelProps, Stack, StackProps, StageFlow, StageFlowProps, Surface, SurfacePalette, SurfaceProps, SurfaceVariant, TabDef, Table, TableColumn, TableProps, Tabs, TabsProps, TimeTravel, TimeTravelProps, ToolCallInspector, ToolCallInspectorProps, UseLiveTimelineResult, resolveLensTheme, useFocusTracking, useLens, useLensTheme, useLiveTimeline } from './react.js';
+export { AgentIteration, AgentMessage, AgentToolCallStub, AgentToolInvocation, AgentTurn } from 'agentfootprint';
 import 'react/jsx-runtime';
 import 'react';
 import 'footprint-explainable-ui';

package/dist/react.d.cts

@@ -1,5 +1,7 @@
-import { AgentTimeline, AgentToolInvocation, LensSkill, Stage, LiveTimelineBuilder } from './core.cjs';
-export { AgentIteration, AgentMessage, AgentToolCallStub, AgentTurn, StageMutations, StageNodeId, StagePrimitive, deriveStages, fromAgentSnapshot } from './core.cjs';
+import { AgentTimeline, LensSkill, Stage, LiveTimelineBuilder } from './core.cjs';
+export { StageMutations, StageNodeId, StagePrimitive, deriveStages, fromAgentSnapshot } from './core.cjs';
+import { AgentToolInvocation } from 'agentfootprint';
+export { AgentIteration, AgentMessage, AgentToolCallStub, AgentToolInvocation, AgentTurn } from 'agentfootprint';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode, CSSProperties, RefObject } from 'react';
 import { NarrativeEntry, ThemeTokens } from 'footprint-explainable-ui';
@@ -600,4 +602,4 @@ declare function useLensTheme(): LensTheme;
 /** Pure mapping — exported for unit tests + non-hook call sites. */
 declare function resolve(tokens: ThemeTokens | undefined): LensTheme;
 
-export { AgentLens, type AgentLensProps, AgentTimeline, AgentToolInvocation, AskCard, type AskCardProps, FillParent, type FillParentProps, FocusRegion, type FocusRegionProps, type FocusState, IterationStrip, type IterationStripProps, Lens, type LensProps, type LensRunner, LensSkill, type LensTheme, LiveTimelineBuilder, MessagesPanel, type MessagesPanelProps, RunSummary, type RunSummaryProps, Scroller, type ScrollerProps, SelfSizingRoot, type SelfSizingRootProps, SkillsPanel, type SkillsPanelProps, Stack, type StackProps, Stage, StageFlow, type StageFlowProps, Surface, type SurfacePalette, type SurfaceProps, type SurfaceVariant, type TabDef, Table, type TableColumn, type TableProps, Tabs, type TabsProps, TimeTravel, type TimeTravelProps, ToolCallInspector, type ToolCallInspectorProps, type UseLiveTimelineResult, resolve as resolveLensTheme, useFocusTracking, useLens, useLensTheme, useLiveTimeline };
+export { AgentLens, type AgentLensProps, AgentTimeline, AskCard, type AskCardProps, FillParent, type FillParentProps, FocusRegion, type FocusRegionProps, type FocusState, IterationStrip, type IterationStripProps, Lens, type LensProps, type LensRunner, LensSkill, type LensTheme, LiveTimelineBuilder, MessagesPanel, type MessagesPanelProps, RunSummary, type RunSummaryProps, Scroller, type ScrollerProps, SelfSizingRoot, type SelfSizingRootProps, SkillsPanel, type SkillsPanelProps, Stack, type StackProps, Stage, StageFlow, type StageFlowProps, Surface, type SurfacePalette, type SurfaceProps, type SurfaceVariant, type TabDef, Table, type TableColumn, type TableProps, Tabs, type TabsProps, TimeTravel, type TimeTravelProps, ToolCallInspector, type ToolCallInspectorProps, type UseLiveTimelineResult, resolve as resolveLensTheme, useFocusTracking, useLens, useLensTheme, useLiveTimeline };

package/dist/react.d.ts

@@ -1,5 +1,7 @@
-import { AgentTimeline, AgentToolInvocation, LensSkill, Stage, LiveTimelineBuilder } from './core.js';
-export { AgentIteration, AgentMessage, AgentToolCallStub, AgentTurn, StageMutations, StageNodeId, StagePrimitive, deriveStages, fromAgentSnapshot } from './core.js';
+import { AgentTimeline, LensSkill, Stage, LiveTimelineBuilder } from './core.js';
+export { StageMutations, StageNodeId, StagePrimitive, deriveStages, fromAgentSnapshot } from './core.js';
+import { AgentToolInvocation } from 'agentfootprint';
+export { AgentIteration, AgentMessage, AgentToolCallStub, AgentToolInvocation, AgentTurn } from 'agentfootprint';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode, CSSProperties, RefObject } from 'react';
 import { NarrativeEntry, ThemeTokens } from 'footprint-explainable-ui';
@@ -600,4 +602,4 @@ declare function useLensTheme(): LensTheme;
 /** Pure mapping — exported for unit tests + non-hook call sites. */
 declare function resolve(tokens: ThemeTokens | undefined): LensTheme;
 
-export { AgentLens, type AgentLensProps, AgentTimeline, AgentToolInvocation, AskCard, type AskCardProps, FillParent, type FillParentProps, FocusRegion, type FocusRegionProps, type FocusState, IterationStrip, type IterationStripProps, Lens, type LensProps, type LensRunner, LensSkill, type LensTheme, LiveTimelineBuilder, MessagesPanel, type MessagesPanelProps, RunSummary, type RunSummaryProps, Scroller, type ScrollerProps, SelfSizingRoot, type SelfSizingRootProps, SkillsPanel, type SkillsPanelProps, Stack, type StackProps, Stage, StageFlow, type StageFlowProps, Surface, type SurfacePalette, type SurfaceProps, type SurfaceVariant, type TabDef, Table, type TableColumn, type TableProps, Tabs, type TabsProps, TimeTravel, type TimeTravelProps, ToolCallInspector, type ToolCallInspectorProps, type UseLiveTimelineResult, resolve as resolveLensTheme, useFocusTracking, useLens, useLensTheme, useLiveTimeline };
+export { AgentLens, type AgentLensProps, AgentTimeline, AskCard, type AskCardProps, FillParent, type FillParentProps, FocusRegion, type FocusRegionProps, type FocusState, IterationStrip, type IterationStripProps, Lens, type LensProps, type LensRunner, LensSkill, type LensTheme, LiveTimelineBuilder, MessagesPanel, type MessagesPanelProps, RunSummary, type RunSummaryProps, Scroller, type ScrollerProps, SelfSizingRoot, type SelfSizingRootProps, SkillsPanel, type SkillsPanelProps, Stack, type StackProps, Stage, StageFlow, type StageFlowProps, Surface, type SurfacePalette, type SurfaceProps, type SurfaceVariant, type TabDef, Table, type TableColumn, type TableProps, Tabs, type TabsProps, TimeTravel, type TimeTravelProps, ToolCallInspector, type ToolCallInspectorProps, type UseLiveTimelineResult, resolve as resolveLensTheme, useFocusTracking, useLens, useLensTheme, useLiveTimeline };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentfootprint-lens",
-  "version": "0.6.1",
+  "version": "0.7.0",
   "description": "See through your agent's decisions. React components for debugging agentfootprint runs — messages, prompts, tool calls, decision scope, cost.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -58,7 +58,9 @@
   },
   "peerDependencies": {
     "@xyflow/react": "^12.0.0",
+    "agentfootprint": ">=1.19.0",
     "footprint-explainable-ui": "^0.18.1",
+    "footprintjs": ">=4.14.0",
     "react": "^18.0.0 || ^19.0.0",
     "react-dom": "^18.0.0 || ^19.0.0"
   },
@@ -72,6 +74,8 @@
     "@xyflow/react": "^12.10.2",
     "footprint-explainable-ui": "^0.18.0",
     "jsdom": "^29.0.2",
+    "agentfootprint": "^1.19.0",
+    "footprintjs": "^4.14.0",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
     "tsup": "^8.0.0",