agentfootprint 2.14.1 → 2.14.3

package/dist/types/recorders/observability/BoundaryRecorder.d.ts

@@ -218,6 +218,51 @@ export interface DomainContextInjectedEvent extends DomainEventBase {
 }
 /** Discriminated union covering every observable moment in a run. */
 export type DomainEvent = DomainRunEvent | DomainSubflowEvent | DomainForkBranchEvent | DomainDecisionBranchEvent | DomainLoopIterationEvent | DomainLLMStartEvent | DomainLLMEndEvent | DomainToolStartEvent | DomainToolEndEvent | DomainContextInjectedEvent;
+/**
+ * Per-boundary rollup returned by
+ * `BoundaryRecorder.aggregateForBoundary` and
+ * `BoundaryRecorder.aggregateAllBoundaries`. Same shape regardless of
+ * primitive kind — UIs render the same chip set for every Agent /
+ * LLMCall / Sequence / Parallel / Conditional / Loop.
+ *
+ * Events count toward this rollup when their `subflowPath` is a
+ * prefix-match of the boundary's `subflowPath`. Nested boundaries
+ * (e.g., LLMCall inside an Agent) contribute to BOTH rollups.
+ *
+ * In-flight boundaries (no `subflow.exit` yet) get partial values;
+ * `endedAtMs` and `durationMs` are undefined until close.
+ */
+export interface BoundaryAggregate {
+    readonly runtimeStageId: string;
+    readonly subflowId: string;
+    readonly subflowPath: readonly string[];
+    /** `'Agent'` / `'LLMCall'` / `'Sequence'` / `'Parallel'` /
+     *  `'Conditional'` / `'Loop'`. Always set on rollups returned by
+     *  `aggregateAllBoundaries` (which filters to primitive boundaries).
+     *  Optional on `aggregateForBoundary` results because the caller may
+     *  request rollup for a non-primitive subflow (rare). */
+    readonly primitiveKind?: string;
+    /** Subflow display name (e.g., 'Triage', 'Billing'). */
+    readonly label: string;
+    /** Token usage summed across every `llm.end` inside this boundary. */
+    readonly tokens: {
+        readonly input: number;
+        readonly output: number;
+    };
+    /** Count of `llm.start` events inside this boundary. */
+    readonly llmCalls: number;
+    /** Count of `tool.start` events inside this boundary. */
+    readonly toolCalls: number;
+    /** Count of `agent.iteration_start` events scoped to this boundary —
+     *  ReAct-loop iterations. Always `0` for non-Agent primitives. */
+    readonly iterations: number;
+    /** Wall-clock ms of `subflow.entry`. */
+    readonly startedAtMs: number;
+    /** Wall-clock ms of `subflow.exit`. Undefined while in flight. */
+    readonly endedAtMs?: number;
+    /** `endedAtMs - startedAtMs`. Undefined while in flight. */
+    readonly durationMs?: number;
+}
 export interface BoundaryRecorderOptions {
     readonly id?: string;
 }
@@ -288,6 +333,45 @@ export declare class BoundaryRecorder extends SequenceRecorder<DomainEvent> impl
         messages: DomainSubflowEvent[];
         tools: DomainSubflowEvent[];
     };
+    /**
+     * Roll up the event stream for ONE primitive boundary (Agent /
+     * LLMCall / Sequence / Parallel / Conditional / Loop) into per-
+     * boundary totals — tokens, llm calls, tool calls, iterations,
+     * cache hits, duration.
+     *
+     * Pure projection over `getEvents()`. Events are attributed to a
+     * boundary when their `subflowPath` is a **prefix-match** of the
+     * boundary's path — so a nested `LLMCall` inside an `Agent` rolls
+     * up into BOTH (LLMCall total + Agent total).
+     *
+     * Works mid-run (the boundary's `subflow.exit` may not have fired
+     * yet — `endedAtMs` / `durationMs` are undefined in that case).
+     * Works post-run.
+     *
+     * Multi-consumer story: this is the single source of rollup truth
+     * for Lens, CLI live monitors, Sentry breadcrumbs, OTel exporters,
+     * dashboards. Domain math (what counts as an "iteration"? does
+     * cache hit count separately from llmCalls?) lives HERE — every
+     * consumer hooks up; nobody re-implements.
+     *
+     * @param runtimeStageId The boundary's runtimeStageId (the same id
+     *   carried by `StepNode.runtimeStageId` for primitive subflows).
+     * @returns The rollup, or `undefined` if no `subflow.entry` event
+     *   matches `runtimeStageId`.
+     */
+    aggregateForBoundary(runtimeStageId: string): BoundaryAggregate | undefined;
+    /**
+     * Roll up every primitive boundary in the run into one rollup each,
+     * in the order their `subflow.entry` events fired. Top-level multi-
+     * agent UIs call this once per render to populate per-agent chips.
+     *
+     * Filters to `primitiveKind`-tagged subflows ONLY (Agent / LLMCall /
+     * Sequence / Parallel / Conditional / Loop). Slot subflows
+     * (`sf-system-prompt` / `sf-messages` / `sf-tools`) are NOT
+     * boundaries in this sense — they're context-engineering machinery,
+     * not user-facing rollup units.
+     */
+    aggregateAllBoundaries(): readonly BoundaryAggregate[];
     /** Snapshot bundle — included in `executor.getSnapshot()` if the
      *  executor implements the snapshot extension protocol. */
     toSnapshot(): {

package/dist/types/recorders/observability/BoundaryRecorder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BoundaryRecorder.d.ts","sourceRoot":"","sources":["../../../../src/recorders/observability/BoundaryRecorder.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"BoundaryRecorder.d.ts","sourceRoot":"","sources":["../../../../src/recorders/observability/BoundaryRecorder.ts"],"names":[],"mappings":"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"}

package/dist/types/recorders/observability/LiveStateRecorder.d.ts

@@ -0,0 +1,215 @@
+/**
+ * LiveStateRecorder — domain trackers built on the footprintjs
+ * `BoundaryStateTracker<TState>` storage primitive (v4.17.2+).
+ *
+ * **What this answers:** "Right now, mid-run, what's happening?"
+ *
+ *   - Is an LLM call in flight? What's the partial answer so far?
+ *   - Is a tool executing? Which tool? What args?
+ *   - Is the agent in a turn? Which turn index?
+ *
+ * All reads are O(1) — the trackers maintain incremental state via
+ * the framework's bracket-scoped storage primitive. No event-log fold,
+ * no walking arrays per render.
+ *
+ * **Mental model — observers vs. bookkeepers:**
+ *
+ *   `BoundaryStateTracker<TState>` (footprintjs) = STORAGE shelf.
+ *   `EventDispatcher.on(...)` (agentfootprint)  = OBSERVER source.
+ *
+ *   Each domain tracker (`LiveLLMTracker`, `LiveToolTracker`,
+ *   `LiveAgentTurnTracker`) extends the storage shelf AND subscribes
+ *   to the dispatcher. The composition `LiveStateRecorder` bundles
+ *   all three so a consumer only attaches once.
+ *
+ * **Tier 1 (live) only.** Past states are not stored — when a boundary
+ * closes, its transient state clears. For time-travel queries, snapshot
+ * to a `SequenceRecorder<TState>` instead. See the BoundaryStateTracker
+ * JSDoc for the rationale.
+ *
+ * @example Use the bundled façade — one attach, three live views:
+ *
+ * ```typescript
+ * import { LiveStateRecorder } from 'agentfootprint';
+ *
+ * const liveState = new LiveStateRecorder();
+ * liveState.subscribe(runner);
+ *
+ * await runner.run({ input });
+ *
+ * // Read at any moment during the run (e.g., from another async task):
+ * liveState.isLLMInFlight();          // true between llm_start ↔ llm_end
+ * liveState.getPartialLLM();          // accumulated tokens so far
+ * liveState.isToolExecuting();        // true between tool_start ↔ tool_end
+ * liveState.isAgentInTurn();          // true between turn_start ↔ turn_end
+ *
+ * liveState.unsubscribe();
+ * ```
+ *
+ * @example Use a single tracker directly when you only need one slice:
+ *
+ * ```typescript
+ * import { LiveLLMTracker } from 'agentfootprint';
+ *
+ * const llm = new LiveLLMTracker();
+ * llm.subscribe(runner);
+ * await runner.run({ input });
+ *
+ * llm.isInFlight();                   // O(1)
+ * llm.getLatestPartial();             // most recent active call's partial
+ * llm.getActive(rid)?.tokens;         // tokens accumulated for one call
+ * ```
+ */
+import { BoundaryStateTracker } from 'footprintjs/trace';
+import type { Unsubscribe } from '../../events/dispatcher.js';
+import type { AgentfootprintEvent, AgentfootprintEventType } from '../../events/registry.js';
+/** Minimal Runner shape this recorder needs — only the public `on(...)`
+ *  subscription method, so the same trackers can attach to a real Runner
+ *  (Agent, etc.) OR to a test mock without exposing the protected
+ *  internal dispatcher. */
+export interface LiveStateRunnerLike {
+    on<K extends AgentfootprintEventType>(type: K, listener: (event: Extract<AgentfootprintEvent, {
+        type: K;
+    }>) => void): Unsubscribe;
+}
+/** Live transient state of one in-flight LLM call. */
+export interface LLMLiveState {
+    /** Accumulated content from `stream.token` events since `llm_start`. */
+    readonly partial: string;
+    /** Number of tokens received so far. */
+    readonly tokens: number;
+    /** Iteration index (from the LLMStartPayload). */
+    readonly iteration: number;
+    /** Provider name (e.g., 'anthropic', 'openai'). */
+    readonly provider: string;
+    /** Model id. */
+    readonly model: string;
+    /** Wall-clock ms when llm_start fired. */
+    readonly startedAtMs: number;
+}
+/** Live transient state of one in-flight tool call. */
+export interface ToolLiveState {
+    readonly toolName: string;
+    readonly args: Readonly<Record<string, unknown>>;
+    readonly toolCallId: string;
+    readonly startedAtMs: number;
+}
+/** Live transient state of one in-flight agent turn. */
+export interface AgentTurnLiveState {
+    readonly turnIndex: number;
+    readonly userPrompt: string;
+    readonly startedAtMs: number;
+}
+/**
+ * Tracks the in-flight state of LLM calls. Subscribes to:
+ *   - `agentfootprint.stream.llm_start`  → opens a boundary
+ *   - `agentfootprint.stream.token`      → appends to partial
+ *   - `agentfootprint.stream.llm_end`    → closes the boundary
+ *
+ * Boundary key: `runtimeStageId` of the call-llm stage. Parallel LLM
+ * calls (Parallel composition with multiple branches) get distinct
+ * keys and are tracked independently.
+ */
+export declare class LiveLLMTracker extends BoundaryStateTracker<LLMLiveState> {
+    readonly id = "live-llm";
+    /** Subscribe to a runner's dispatcher. Returns an Unsubscribe. */
+    subscribe(runner: LiveStateRunnerLike): Unsubscribe;
+    /** True if any LLM call is currently in flight. Same as `hasActive`. */
+    isInFlight(): boolean;
+    /** Accumulated partial content of the MOST RECENTLY started active
+     *  LLM call. Empty string when no call is active. Useful for the
+     *  classic "Chatbot is responding: …" live commentary line. */
+    getLatestPartial(): string;
+}
+/**
+ * Tracks in-flight tool calls. Subscribes to:
+ *   - `agentfootprint.stream.tool_start` → opens a boundary
+ *   - `agentfootprint.stream.tool_end`   → closes the boundary
+ *
+ * Boundary key: `toolCallId` (more granular than `runtimeStageId` —
+ * parallel tools share one calling stage but have distinct toolCallIds).
+ */
+export declare class LiveToolTracker extends BoundaryStateTracker<ToolLiveState> {
+    readonly id = "live-tool";
+    subscribe(runner: LiveStateRunnerLike): Unsubscribe;
+    /** True if any tool is currently executing. */
+    isExecuting(): boolean;
+    /** Names of tools currently executing. Empty when none. */
+    getExecutingToolNames(): readonly string[];
+}
+/**
+ * Tracks in-flight agent turns. Subscribes to:
+ *   - `agentfootprint.agent.turn_start` → opens a boundary
+ *   - `agentfootprint.agent.turn_end`   → closes the boundary
+ *
+ * Boundary key: stringified `turnIndex` from the payload — survives
+ * across runner instances because turnIndex resets per-session.
+ */
+export declare class LiveAgentTurnTracker extends BoundaryStateTracker<AgentTurnLiveState> {
+    readonly id = "live-agent-turn";
+    subscribe(runner: LiveStateRunnerLike): Unsubscribe;
+    /** True if the agent is currently inside a turn. */
+    isInTurn(): boolean;
+    /** Index of the most-recently started active turn (-1 if none). */
+    getCurrentTurnIndex(): number;
+}
+/**
+ * One-stop façade bundling `LiveLLMTracker` + `LiveToolTracker` +
+ * `LiveAgentTurnTracker`. Consumers attach this once and get O(1)
+ * reads across all three live-state slices.
+ *
+ * Use the bundled façade unless you ONLY need one slice — using a
+ * single tracker directly avoids subscribing to events you don't read.
+ *
+ * **Lifecycle**: call `subscribe(runner)` to wire all three trackers,
+ * then `unsubscribe()` to detach. `clear()` resets all transient state
+ * across the three (called automatically by consumers like Lens between
+ * runs).
+ *
+ * **What this is NOT for:**
+ *   - Time-travel queries (Tier 1 only — live state)
+ *   - Aggregations (use SequenceRecorder.aggregate)
+ *   - Stage-level observation (use Recorder.onStageStart/End)
+ *
+ * **Composition over inheritance:** the façade does NOT extend
+ * `BoundaryStateTracker` itself — different boundary kinds need
+ * separate active maps to avoid key collisions between LLM and tool
+ * boundaries. Each sub-tracker keeps its own state.
+ */
+export declare class LiveStateRecorder {
+    readonly id = "live-state";
+    /** LLM call live state. */
+    readonly llm: LiveLLMTracker;
+    /** Tool execution live state. */
+    readonly tool: LiveToolTracker;
+    /** Agent turn live state. */
+    readonly turn: LiveAgentTurnTracker;
+    /** Active subscription disposer, if `subscribe()` is called. */
+    private active;
+    constructor();
+    /** Subscribe all three trackers to one runner. Idempotent — calling
+     *  twice on the same recorder unsubscribes the prior subscription
+     *  first to avoid double-counting. */
+    subscribe(runner: LiveStateRunnerLike): Unsubscribe;
+    /** Detach all three trackers from the current runner. Idempotent. */
+    unsubscribe(): void;
+    /** Reset transient state across all three trackers. Called by the
+     *  executor / consumer between runs. */
+    clear(): void;
+    /** True if any LLM call is currently in flight. */
+    isLLMInFlight(): boolean;
+    /** Accumulated partial content of the most-recently started LLM call. */
+    getPartialLLM(): string;
+    /** True if any tool is currently executing. */
+    isToolExecuting(): boolean;
+    /** Names of tools currently executing. */
+    getExecutingToolNames(): readonly string[];
+    /** True if the agent is currently inside a turn. */
+    isAgentInTurn(): boolean;
+    /** Current turn index (-1 if not in a turn). */
+    getCurrentTurnIndex(): number;
+}
+/** Convenience factory — same shape as `boundaryRecorder()` /
+ *  `topologyRecorder()` / `inOutRecorder()` in footprintjs. */
+export declare function liveStateRecorder(): LiveStateRecorder;
+//# sourceMappingURL=LiveStateRecorder.d.ts.map

package/dist/types/recorders/observability/LiveStateRecorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LiveStateRecorder.d.ts","sourceRoot":"","sources":["../../../../src/recorders/observability/LiveStateRecorder.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentfootprint",
-  "version": "2.14.1",
+  "version": "2.14.3",
   "description": "The explainable agent framework — build AI agents you can explain, audit, and trust. Built on footprintjs.",
   "license": "MIT",
   "author": "Sanjay Krishna Anbalagan",
@@ -184,7 +184,7 @@
     "@aws-sdk/client-xray": "*",
     "@modelcontextprotocol/sdk": "*",
     "@opentelemetry/api": "*",
-    "footprintjs": ">=4.17.1",
+    "footprintjs": ">=4.17.2",
     "ioredis": "*",
     "openai": "*",
     "zod": "*"
@@ -228,7 +228,7 @@
     "@vitest/coverage-v8": "^4.1.5",
     "eslint": "^8.44.0",
     "eslint-config-prettier": "^6.15.0",
-    "footprintjs": "^4.17.1",
+    "footprintjs": "^4.17.2",
     "prettier": "^2.8.1",
     "typedoc": "^0.28.19",
     "typedoc-plugin-markdown": "^4.11.0",