agentfootprint 1.22.0 → 2.0.1

package/dist/recorders/observability/BoundaryRecorder.js

@@ -0,0 +1,471 @@
+"use strict";
+/**
+ * BoundaryRecorder — unified domain event log for an agentfootprint run.
+ *
+ * The single source of truth Lens (and any other consumer) reads to
+ * render a run. Every observable moment in a run is captured as one
+ * `DomainEvent` in a single ordered stream:
+ *
+ *   - `run.entry` / `run.exit`              — top-level executor.run()
+ *   - `subflow.entry` / `subflow.exit`      — every subflow boundary
+ *   - `fork.branch`                         — one per parallel child
+ *   - `decision.branch`                     — chosen branch of a Conditional
+ *   - `loop.iteration`                      — one per back-edge traversal
+ *   - `llm.start` / `llm.end`               — LLM provider call lifecycle
+ *   - `tool.start` / `tool.end`             — tool execution lifecycle
+ *   - `context.injected`                    — anything injected into a slot
+ *
+ * All events carry `runtimeStageId` (binds with footprintjs Trace view +
+ * with each other), `subflowPath`, `depth`, and `ts` (wall-clock ms).
+ * Subflow events are domain-tagged (`slotKind` / `primitiveKind` /
+ * `isAgentInternal`) so consumers dispatch on tag without re-parsing.
+ *
+ * Architecture:
+ *
+ *   ┌──── footprintjs (domain-agnostic) ────┐
+ *   │  FlowRecorder events (run/subflow/    │  ──┐
+ *   │  fork/decision/loop)                  │    │
+ *   └───────────────────────────────────────┘    │
+ *                                                │
+ *   ┌──── agentfootprint dispatcher ─────────┐   │  consumed by
+ *   │  Typed events (llm/tool/context)       │  ──┤
+ *   └────────────────────────────────────────┘   │
+ *                                                ▼
+ *                                  ┌─── BoundaryRecorder ───┐
+ *                                  │  one tagged stream of  │
+ *                                  │  DomainEvent           │
+ *                                  └────────────────────────┘
+ *                                                │
+ *                                                ▼  consumed by
+ *                                  ┌────── Lens (UI) ──────┐
+ *                                  │  Slider / RunFlow /   │
+ *                                  │  NodeDetail / etc.    │
+ *                                  └───────────────────────┘
+ *
+ * Why ONE recorder: Lens scrub axis, run-flow graph, slot rows inside
+ * the LLM card, right-pane detail panel, commentary panel — every UI
+ * surface reads from the SAME stream. Adding a new domain event = one
+ * tagged emit + one render shape. No state machines spread across
+ * renderers, no merging of multiple sources, no name-based filter lists.
+ *
+ * Naming: `runtimeStageId` is footprintjs's primitive (path-prefixed +
+ * `#executionIndex`). `subflowPath` is rooted under the synthetic
+ * `'__root__'`. `slotKind` / `primitiveKind` are agent-domain. The
+ * design follows the React Fiber + OpenTelemetry pattern:
+ * **producers self-describe; consumers dispatch on type**.
+ *
+ * @example
+ * ```typescript
+ * import { boundaryRecorder } from 'agentfootprint';
+ *
+ * const boundary = boundaryRecorder();
+ * executor.attachCombinedRecorder(boundary);   // wires FlowRecorder side
+ * boundary.subscribe(runner.dispatcher);        // wires typed-event side
+ *
+ * await executor.run({ input });
+ *
+ * for (const e of boundary.getEvents()) {
+ *   switch (e.type) {
+ *     case 'run.entry':       renderRoot(e); break;
+ *     case 'subflow.entry':   if (e.slotKind) renderSlotRow(e);
+ *                              else if (e.primitiveKind) renderPrimitive(e);
+ *                              break;
+ *     case 'llm.start':       renderLLMCall(e); break;
+ *     // ...
+ *   }
+ * }
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BoundaryRecorder = exports.boundaryRecorder = void 0;
+const trace_1 = require("footprintjs/trace");
+const conventions_js_1 = require("../../conventions.js");
+/** Closed set of routing/wrapper subflow IDs that are pure plumbing.
+ *  Slot subflows (`sf-system-prompt` / `sf-messages` / `sf-tools`) are
+ *  NOT in this set — they're real context-engineering moments. */
+const AGENT_INTERNAL_LOCAL_IDS = new Set([
+    conventions_js_1.SUBFLOW_IDS.ROUTE,
+    conventions_js_1.SUBFLOW_IDS.TOOL_CALLS,
+    conventions_js_1.SUBFLOW_IDS.FINAL,
+    conventions_js_1.SUBFLOW_IDS.MERGE,
+]);
+let _counter = 0;
+/** Factory — matches the `inOutRecorder()` / `topologyRecorder()` style. */
+function boundaryRecorder(options = {}) {
+    return new BoundaryRecorder(options);
+}
+exports.boundaryRecorder = boundaryRecorder;
+/**
+ * Unified domain event recorder. Implements `CombinedRecorder` so it can
+ * attach to the executor's FlowRecorder channel; exposes `subscribe()`
+ * to wire to the agentfootprint typed-event dispatcher.
+ *
+ * Internally stores events in a `SequenceRecorder<DomainEvent>` so the
+ * usual time-travel utilities (`getEntryRanges`, `accumulate`) work
+ * out of the box.
+ */
+class BoundaryRecorder extends trace_1.SequenceRecorder {
+    id;
+    /**
+     * Tracks whether the most recent `llm.end` had toolCalls. Used to
+     * classify the NEXT `llm.start` as `'tool→llm'` (vs `'user→llm'` if
+     * there's no pending tool result). Reset on `clear()` and on every
+     * `llm.start` event after the classification is applied.
+     */
+    prevLLMEndHadTools = false;
+    constructor(options = {}) {
+        super();
+        this.id = options.id ?? `boundary-${++_counter}`;
+    }
+    clear() {
+        super.clear();
+        this.prevLLMEndHadTools = false;
+    }
+    // ── FlowRecorder hooks (footprintjs side) ───────────────────────────
+    onRunStart(event) {
+        this.emit(buildRunEvent('run.entry', event.payload));
+    }
+    onRunEnd(event) {
+        this.emit(buildRunEvent('run.exit', event.payload));
+    }
+    onSubflowEntry(event) {
+        const e = buildSubflowEvent(event, 'subflow.entry');
+        if (e)
+            this.emit(e);
+    }
+    onSubflowExit(event) {
+        const e = buildSubflowEvent(event, 'subflow.exit');
+        if (e)
+            this.emit(e);
+    }
+    onFork(event) {
+        const ts = Date.now();
+        const ctx = event.traversalContext;
+        const runtimeStageId = ctx?.runtimeStageId ?? '';
+        const segments = ctx?.subflowPath ? ctx.subflowPath.split('/').filter(Boolean) : [];
+        const subflowPath = [trace_1.ROOT_SUBFLOW_ID, ...segments];
+        for (const childName of event.children) {
+            this.emit({
+                type: 'fork.branch',
+                runtimeStageId,
+                subflowPath,
+                depth: subflowPath.length - 1,
+                ts,
+                parentSubflowId: event.parent,
+                childName,
+            });
+        }
+    }
+    onDecision(event) {
+        const ctx = event.traversalContext;
+        // Agent-internal decisions (Route picking tool-calls / final) are
+        // identified by the deciding stage's stableId matching one of the
+        // known Agent-internal subflow ids. The actor arrows that follow
+        // (`llm→tool` / `llm→user`) already encode the routing observably,
+        // so the timeline filters these out — but we still capture them in
+        // the event log so the right-pane / commentary can read the
+        // rationale when present.
+        const stageId = ctx?.stageId ?? '';
+        const localStageId = stageId.includes('/')
+            ? stageId.slice(stageId.lastIndexOf('/') + 1)
+            : stageId;
+        const isAgentInternal = AGENT_INTERNAL_LOCAL_IDS.has(localStageId);
+        this.emit({
+            type: 'decision.branch',
+            runtimeStageId: ctx?.runtimeStageId ?? '',
+            subflowPath: pathFromCtx(ctx?.subflowPath),
+            depth: ctxDepth(ctx?.subflowPath),
+            ts: Date.now(),
+            decider: event.decider,
+            chosen: event.chosen,
+            ...(event.rationale ? { rationale: event.rationale } : {}),
+            isAgentInternal,
+        });
+    }
+    onLoop(event) {
+        const ctx = event.traversalContext;
+        this.emit({
+            type: 'loop.iteration',
+            runtimeStageId: ctx?.runtimeStageId ?? '',
+            subflowPath: pathFromCtx(ctx?.subflowPath),
+            depth: ctxDepth(ctx?.subflowPath),
+            ts: Date.now(),
+            target: event.target,
+            iteration: event.iteration,
+        });
+    }
+    // ── Typed-event subscription (agentfootprint dispatcher side) ───────
+    /**
+     * Subscribe to the runner's typed-event dispatcher and emit a domain
+     * event for each `llm.*` / `tool.*` / `context.injected` event.
+     *
+     * Returns an unsubscribe function; safe to call multiple times (each
+     * call adds a new subscription). Most consumers call this once at
+     * recorder construction and dispose with the returned function.
+     */
+    subscribe(dispatcher) {
+        return dispatcher.on('*', (event) => this.ingestTypedEvent(event));
+    }
+    ingestTypedEvent(event) {
+        const meta = event.meta;
+        const runtimeStageId = meta.runtimeStageId ?? '';
+        const subflowPath = [trace_1.ROOT_SUBFLOW_ID, ...(meta.subflowPath ?? [])];
+        const depth = subflowPath.length - 1;
+        const ts = meta.wallClockMs;
+        switch (event.type) {
+            case 'agentfootprint.stream.llm_start': {
+                const p = event.payload;
+                // Classify the actor arrow at capture time. State is local to
+                // THIS recorder and consumed-then-reset on each llm.start. No
+                // state machine spread across renderers; consumers just read
+                // `event.actorArrow`.
+                const actorArrow = this.prevLLMEndHadTools
+                    ? 'tool→llm'
+                    : 'user→llm';
+                this.prevLLMEndHadTools = false;
+                this.emit({
+                    type: 'llm.start',
+                    runtimeStageId,
+                    subflowPath,
+                    depth,
+                    ts,
+                    model: p.model,
+                    provider: p.provider,
+                    ...(p.systemPromptChars !== undefined ? { systemPromptChars: p.systemPromptChars } : {}),
+                    ...(p.messagesCount !== undefined ? { messagesCount: p.messagesCount } : {}),
+                    ...(p.toolsCount !== undefined ? { toolsCount: p.toolsCount } : {}),
+                    actorArrow,
+                });
+                break;
+            }
+            case 'agentfootprint.stream.llm_end': {
+                const p = event.payload;
+                const actorArrow = p.toolCallCount > 0 ? 'llm→tool' : 'llm→user';
+                // Set the pending flag for the NEXT llm.start (if any). A
+                // terminal call (toolCallCount === 0) leaves the flag false so
+                // a hypothetical follow-up call would correctly be 'user→llm'.
+                this.prevLLMEndHadTools = p.toolCallCount > 0;
+                this.emit({
+                    type: 'llm.end',
+                    runtimeStageId,
+                    subflowPath,
+                    depth,
+                    ts,
+                    content: p.content,
+                    toolCallCount: p.toolCallCount,
+                    usage: { input: p.usage.input, output: p.usage.output },
+                    ...(p.stopReason ? { stopReason: p.stopReason } : {}),
+                    actorArrow,
+                });
+                break;
+            }
+            case 'agentfootprint.stream.tool_start': {
+                const p = event.payload;
+                this.emit({
+                    type: 'tool.start',
+                    runtimeStageId,
+                    subflowPath,
+                    depth,
+                    ts,
+                    toolName: p.toolName,
+                    toolCallId: p.toolCallId,
+                    ...(p.args !== undefined ? { args: p.args } : {}),
+                });
+                break;
+            }
+            case 'agentfootprint.stream.tool_end': {
+                const p = event.payload;
+                this.emit({
+                    type: 'tool.end',
+                    runtimeStageId,
+                    subflowPath,
+                    depth,
+                    ts,
+                    toolCallId: p.toolCallId,
+                    ...(p.result !== undefined ? { result: p.result } : {}),
+                    ...(p.durationMs !== undefined ? { durationMs: p.durationMs } : {}),
+                    ...(p.error !== undefined ? { error: p.error } : {}),
+                });
+                break;
+            }
+            case 'agentfootprint.context.injected': {
+                const p = event.payload;
+                this.emit({
+                    type: 'context.injected',
+                    runtimeStageId,
+                    subflowPath,
+                    depth,
+                    ts,
+                    slot: p.slot,
+                    source: p.source ?? 'unknown',
+                    ...(p.sourceId ? { sourceId: p.sourceId } : {}),
+                    ...(p.asRole ? { asRole: p.asRole } : {}),
+                    ...(p.contentSummary ? { contentSummary: p.contentSummary } : {}),
+                    ...(p.reason ? { reason: p.reason } : {}),
+                    ...(p.sectionTag ? { sectionTag: p.sectionTag } : {}),
+                    ...(p.upstreamRef ? { upstreamRef: p.upstreamRef } : {}),
+                    ...(p.retrievalScore !== undefined ? { retrievalScore: p.retrievalScore } : {}),
+                    ...(p.rankPosition !== undefined ? { rankPosition: p.rankPosition } : {}),
+                    ...(p.budgetSpent?.tokens !== undefined ? { budgetTokens: p.budgetSpent.tokens } : {}),
+                    ...(p.budgetSpent?.fractionOfCap !== undefined
+                        ? { budgetFraction: p.budgetSpent.fractionOfCap }
+                        : {}),
+                });
+                break;
+            }
+            default:
+                // Other typed events (composition.*, agent.*, etc.) are not
+                // mapped to DomainEvent for now — they're either implied by
+                // FlowRecorder events (composition) or higher-level summaries
+                // (agent.turn_*) that downstream selectors derive on demand.
+                break;
+        }
+    }
+    // ── Read API ────────────────────────────────────────────────────────
+    /** All events in capture order (the canonical projection). */
+    getEvents() {
+        return this.getEntries();
+    }
+    /** Type-narrowed lookup: all events of one kind. */
+    getEventsByType(type) {
+        const out = [];
+        for (const e of this.getEntries()) {
+            if (e.type === type)
+                out.push(e);
+        }
+        return out;
+    }
+    // ── Back-compat / convenience query helpers ─────────────────────────
+    /** All boundary events (run + subflow, entry + exit interleaved). */
+    getBoundaries() {
+        const out = [];
+        for (const e of this.getEntries()) {
+            if (e.type === 'run.entry' ||
+                e.type === 'run.exit' ||
+                e.type === 'subflow.entry' ||
+                e.type === 'subflow.exit') {
+                out.push(e);
+            }
+        }
+        return out;
+    }
+    /** Just the entry-phase boundary events — the "step list" timeline. */
+    getSteps() {
+        return this.getBoundaries().filter((b) => b.type === 'run.entry' || b.type === 'subflow.entry');
+    }
+    /** Subset of `getSteps()` excluding agent-internal routing subflows. */
+    getVisibleSteps() {
+        return this.getSteps().filter((s) => s.type !== 'subflow.entry' || !s.isAgentInternal);
+    }
+    /** Entry/exit pair for one chart execution by `runtimeStageId`. */
+    getBoundary(runtimeStageId) {
+        const matches = this.getEntriesForStep(runtimeStageId);
+        let entry;
+        let exit;
+        for (const e of matches) {
+            if (e.type === 'run.entry' || e.type === 'subflow.entry')
+                entry = e;
+            else if (e.type === 'run.exit' || e.type === 'subflow.exit')
+                exit = e;
+        }
+        return {
+            ...(entry ? { entry } : {}),
+            ...(exit ? { exit } : {}),
+        };
+    }
+    /** Convenience for the outermost `__root__` pair. */
+    getRootBoundary() {
+        const pair = this.getBoundary(trace_1.ROOT_RUNTIME_STAGE_ID);
+        return {
+            ...(pair.entry?.type === 'run.entry' ? { entry: pair.entry } : {}),
+            ...(pair.exit?.type === 'run.exit' ? { exit: pair.exit } : {}),
+        };
+    }
+    /** Subflow events grouped by the 3 input slots — for slot-row rendering. */
+    getSlotBoundaries() {
+        const systemPrompt = [];
+        const messages = [];
+        const tools = [];
+        for (const e of this.getEntries()) {
+            if (e.type !== 'subflow.entry' && e.type !== 'subflow.exit')
+                continue;
+            if (e.slotKind === 'system-prompt')
+                systemPrompt.push(e);
+            else if (e.slotKind === 'messages')
+                messages.push(e);
+            else if (e.slotKind === 'tools')
+                tools.push(e);
+        }
+        return { systemPrompt, messages, tools };
+    }
+    /** Snapshot bundle — included in `executor.getSnapshot()` if the
+     *  executor implements the snapshot extension protocol. */
+    toSnapshot() {
+        return {
+            name: 'BoundaryEvents',
+            description: 'Unified domain event log — run/subflow boundaries + LLM/tool/context events',
+            preferredOperation: 'translate',
+            data: this.getEvents(),
+        };
+    }
+}
+exports.BoundaryRecorder = BoundaryRecorder;
+// ── Internal helpers ─────────────────────────────────────────────────
+function buildRunEvent(type, payload) {
+    return {
+        type,
+        runtimeStageId: trace_1.ROOT_RUNTIME_STAGE_ID,
+        subflowPath: [trace_1.ROOT_SUBFLOW_ID],
+        depth: 0,
+        ts: Date.now(),
+        payload,
+        isRoot: true,
+    };
+}
+function buildSubflowEvent(event, type) {
+    const subflowId = event.subflowId;
+    if (!subflowId)
+        return undefined;
+    const ctx = event.traversalContext;
+    const runtimeStageId = ctx?.runtimeStageId ?? '';
+    const segments = subflowId.split('/').filter(Boolean);
+    const subflowPath = [trace_1.ROOT_SUBFLOW_ID, ...segments];
+    const depth = subflowPath.length - 1;
+    const localSubflowId = segments[segments.length - 1] ?? subflowId;
+    const description = event.description;
+    const primitiveKind = description ? parsePrimitiveKindFromDescription(description) : undefined;
+    const slotKind = (0, conventions_js_1.slotFromSubflowId)(subflowId);
+    const isAgentInternal = AGENT_INTERNAL_LOCAL_IDS.has(localSubflowId);
+    const payload = type === 'subflow.entry' ? event.mappedInput : event.outputState;
+    return {
+        type,
+        runtimeStageId,
+        subflowPath,
+        depth,
+        ts: Date.now(),
+        subflowId,
+        localSubflowId,
+        subflowName: event.name,
+        ...(description ? { description } : {}),
+        ...(primitiveKind ? { primitiveKind } : {}),
+        ...(slotKind ? { slotKind } : {}),
+        isAgentInternal,
+        ...(payload !== undefined ? { payload } : {}),
+    };
+}
+function pathFromCtx(subflowPath) {
+    if (!subflowPath)
+        return [trace_1.ROOT_SUBFLOW_ID];
+    return [trace_1.ROOT_SUBFLOW_ID, ...subflowPath.split('/').filter(Boolean)];
+}
+function ctxDepth(subflowPath) {
+    return pathFromCtx(subflowPath).length - 1;
+}
+function parsePrimitiveKindFromDescription(description) {
+    const colonIdx = description.indexOf(':');
+    if (colonIdx <= 0)
+        return undefined;
+    const kind = description.slice(0, colonIdx).trim();
+    return kind || undefined;
+}
+//# sourceMappingURL=BoundaryRecorder.js.map

package/dist/recorders/observability/BoundaryRecorder.js.map

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