agentfootprint 1.23.0 → 2.0.1

package/dist/esm/recorders/observability/FlowchartRecorder.js

@@ -0,0 +1,495 @@
+/**
+ * FlowchartRecorder — StepGraph projection over `BoundaryRecorder`.
+ *
+ * Pattern: Pure projection. `attachFlowchart` wires a `BoundaryRecorder`
+ *          to the executor + dispatcher; `buildStepGraph` is a fold over
+ *          `boundary.getEvents()` that produces the renderer-friendly
+ *          `StepGraph` shape Lens (and any other consumer) renders.
+ *
+ *          ZERO state machine in this file. ZERO event subscription.
+ *          ZERO name-based filters. Everything that decides "what's a
+ *          step" lives in BoundaryRecorder via capture-time tags
+ *          (`actorArrow`, `slotKind`, `primitiveKind`, `isAgentInternal`).
+ *
+ * Role:    Tier 3 observability. Enabled via
+ *          `runner.enable.flowchart({ onUpdate })`. The handle exposes:
+ *
+ *            handle.getSnapshot()  → derived StepGraph (back-compat)
+ *            handle.boundary       → the underlying BoundaryRecorder
+ *                                     (Lens reads it directly for richer
+ *                                     queries: getSlotBoundaries(),
+ *                                     getEventsByType, etc.)
+ *
+ * Event → StepNode mapping (the entire policy):
+ *
+ *   run.entry            → StepNode kind='subflow', primitiveKind='Run'
+ *   subflow.entry        → StepNode kind='subflow' (skipped if isAgentInternal
+ *                                                    or slotKind set —
+ *                                                    those are sub-components
+ *                                                    of the actor arrows)
+ *   fork.branch          → StepNode kind='fork-branch'
+ *   decision.branch      → StepNode kind='decision-branch'
+ *   llm.start            → StepNode kind=actorArrow ('user→llm' | 'tool→llm')
+ *   tool.start           → StepNode kind='llm->tool'
+ *   llm.end terminal     → StepNode kind='llm->user' (delivery marker)
+ *   loop.iteration       → loop-iteration StepEdge
+ *   context.injected     → attached to NEXT user→llm / tool→llm StepNode
+ *
+ * Result: a one-to-one correspondence between visible scrubbable steps
+ * and DomainEvents. Adding a new event type adds one mapping line here
+ * (or in the pure projection); no state machine, no merging.
+ */
+import { boundaryRecorder } from './BoundaryRecorder.js';
+// ─── Attach entry point ──────────────────────────────────────────────
+/**
+ * Attach a live FlowchartRecorder to a runner.
+ *
+ *   1. Creates a `BoundaryRecorder` (the unified domain event log).
+ *   2. Attaches it to the executor's FlowRecorder channel via
+ *      `runnerAttach` — captures run / subflow / fork / decision / loop.
+ *   3. Subscribes it to the dispatcher — captures llm.* / tool.* /
+ *      context.injected.
+ *   4. Wires `onUpdate` so the consumer sees a fresh derived StepGraph
+ *      on every event.
+ *
+ * @internal Called from `RunnerBase.enable.flowchart`.
+ */
+export function attachFlowchart(runnerAttach, dispatcher, options = {}) {
+    const boundary = boundaryRecorder();
+    const onUpdate = options.onUpdate;
+    // Wrap the recorder to also re-emit StepGraph after each FlowRecorder
+    // event. Without this, consumers see updates only on dispatcher events
+    // (which fire less often than subflow boundaries).
+    const wrapped = onUpdate
+        ? wrapWithEmit(boundary, () => onUpdate(buildStepGraph(boundary)))
+        : boundary;
+    const offAttach = runnerAttach(wrapped);
+    // Subscribe to typed events. The boundary recorder emits a domain
+    // event per llm/tool/context event and we re-derive the StepGraph.
+    const offDispatcher = dispatcher.on('*', (event) => {
+        // Boundary recorder ingests directly via its own subscribe — but
+        // since we own the lifecycle here, route through it explicitly so
+        // we control the onUpdate timing.
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        boundary.ingestTypedEvent?.(event);
+        onUpdate?.(buildStepGraph(boundary));
+    });
+    return {
+        getSnapshot: () => buildStepGraph(boundary),
+        boundary,
+        unsubscribe: () => {
+            offAttach();
+            offDispatcher();
+        },
+    };
+}
+/**
+ * Wrap a recorder so each FlowRecorder hook also calls `afterEach` with
+ * a fresh snapshot. `afterEach` runs AFTER the wrapped hook returns so
+ * the snapshot reflects the just-applied event.
+ */
+function wrapWithEmit(boundary, afterEach) {
+    return {
+        id: boundary.id,
+        onRunStart: (e) => {
+            boundary.onRunStart(e);
+            afterEach();
+        },
+        onRunEnd: (e) => {
+            boundary.onRunEnd(e);
+            afterEach();
+        },
+        onSubflowEntry: (e) => {
+            boundary.onSubflowEntry(e);
+            afterEach();
+        },
+        onSubflowExit: (e) => {
+            boundary.onSubflowExit(e);
+            afterEach();
+        },
+        onFork: (e) => {
+            boundary.onFork(e);
+            afterEach();
+        },
+        onDecision: (e) => {
+            boundary.onDecision(e);
+            afterEach();
+        },
+        onLoop: (e) => {
+            boundary.onLoop(e);
+            afterEach();
+        },
+    };
+}
+// ─── Pure projection: events → StepGraph ─────────────────────────────
+/**
+ * Closed set of primitives Lens treats as drill-in containers.
+ * Adding a new primitive: ship its `'Kind:'` description prefix at the
+ * builder's `flowChart('...', ..., 'Kind: …')` call site AND add the
+ * name here. Both sides are required.
+ */
+const KNOWN_PRIMITIVES = new Set([
+    'Agent',
+    'LLMCall',
+    'Sequence',
+    'Parallel',
+    'Conditional',
+    'Loop',
+]);
+/**
+ * Project a `BoundaryRecorder`'s event stream into a `StepGraph`.
+ *
+ * Pure function — no side effects, no recorder mutation, deterministic.
+ * Called on every snapshot request and on every `onUpdate` fire. O(N)
+ * over the event stream; consumer-side memoization (e.g., React's
+ * `useMemo`) is straightforward when needed.
+ *
+ * The mapping is local to each event type: see the mapping table in
+ * the file header. State carried across the fold:
+ *   - `iter`: 1-based ReAct iteration counter, incremented on each
+ *     `llm.start`. ReAct nodes inherit the current value.
+ *   - `pendingInjections`: context.injected events buffered between
+ *     LLM calls; flushed onto the next user→llm or tool→llm StepNode.
+ *   - `prevReActId`: id of the previous ReAct StepNode for `next`-edge
+ *     wiring within an iteration.
+ *   - `runStartTs`: wall-clock at run start, for relative offsets.
+ */
+export function buildStepGraph(boundary) {
+    const events = boundary.getEvents();
+    const nodes = [];
+    const edges = [];
+    let iter = 0;
+    let pendingInjections = [];
+    let prevReActId;
+    let runStartTs;
+    let activeNodeId;
+    /**
+     * Slot boundaries that fired since the LAST llm boundary; flushed
+     * onto the next user→llm or tool→llm StepNode at its `llm.start`
+     * event. Mirrors how `pendingInjections` works — same "buffer until
+     * the next LLM call consumes it" pattern.
+     *
+     * Cleared on each llm.start (after attribution) AND on llm.end with
+     * actorArrow='llm→tool' (the slots assembled BEFORE the next iteration
+     * may still fire after this point — keep buffering).
+     */
+    let pendingSlotBoundaries = {};
+    // Track open "subflow" nodes so we can close them on subflow.exit
+    // (set endOffsetMs, exitPayload). Keyed by runtimeStageId — same key
+    // the entry event carries; pause/in-progress subflows simply never
+    // close their entry.
+    const openSubflowsByRuntimeId = new Map();
+    for (const e of events) {
+        if (runStartTs === undefined)
+            runStartTs = e.ts;
+        const t = e.ts - runStartTs;
+        switch (e.type) {
+            case 'run.entry': {
+                const node = {
+                    id: e.runtimeStageId,
+                    kind: 'subflow',
+                    label: 'Run',
+                    startOffsetMs: t,
+                    subflowPath: e.subflowPath,
+                    primitiveKind: 'Run',
+                    isPrimitiveBoundary: false,
+                    ...(e.payload !== undefined ? { entryPayload: e.payload } : {}),
+                    runtimeStageId: e.runtimeStageId,
+                };
+                nodes.push(node);
+                openSubflowsByRuntimeId.set(e.runtimeStageId, node);
+                activeNodeId = node.id;
+                break;
+            }
+            case 'run.exit': {
+                const open = openSubflowsByRuntimeId.get(e.runtimeStageId);
+                if (open) {
+                    open.endOffsetMs = t;
+                    if (e.payload !== undefined) {
+                        open.exitPayload = e.payload;
+                    }
+                    openSubflowsByRuntimeId.delete(e.runtimeStageId);
+                }
+                activeNodeId = undefined;
+                break;
+            }
+            case 'subflow.entry': {
+                // Slot subflows: NOT separate timeline steps — buffer their
+                // entry payload to attach to the next LLM call's StepNode.
+                if (e.slotKind) {
+                    pendingSlotBoundaries[slotPropName(e.slotKind)] = {
+                        runtimeStageId: e.runtimeStageId,
+                        ...(e.payload !== undefined ? { entryPayload: e.payload } : {}),
+                    };
+                    break;
+                }
+                // Agent-internal routing: pure plumbing, not a step.
+                if (e.isAgentInternal)
+                    break;
+                const node = subflowToStepNode(e, t);
+                nodes.push(node);
+                connectAdjacent(nodes, edges);
+                openSubflowsByRuntimeId.set(e.runtimeStageId, node);
+                activeNodeId = node.id;
+                break;
+            }
+            case 'subflow.exit': {
+                // Slot subflow exit: enrich the buffered slot boundary with
+                // its rendered output (the actual slot content the LLM saw).
+                if (e.slotKind) {
+                    const key = slotPropName(e.slotKind);
+                    const existing = pendingSlotBoundaries[key];
+                    if (existing) {
+                        pendingSlotBoundaries[key] = {
+                            ...existing,
+                            ...(e.payload !== undefined ? { exitPayload: e.payload } : {}),
+                        };
+                    }
+                    break;
+                }
+                if (e.isAgentInternal)
+                    break;
+                const open = openSubflowsByRuntimeId.get(e.runtimeStageId);
+                if (open) {
+                    open.endOffsetMs = t;
+                    if (e.payload !== undefined) {
+                        open.exitPayload = e.payload;
+                    }
+                    openSubflowsByRuntimeId.delete(e.runtimeStageId);
+                }
+                break;
+            }
+            case 'fork.branch': {
+                const id = `fork-${e.runtimeStageId}-${e.childName}`;
+                nodes.push({
+                    id,
+                    kind: 'fork-branch',
+                    label: e.childName,
+                    startOffsetMs: t,
+                    subflowPath: e.subflowPath,
+                });
+                break;
+            }
+            case 'decision.branch': {
+                // Agent-internal Route decisions (tool-calls / final) are
+                // wiring, not steps — the actor arrows that follow already
+                // encode the routing observably. Filter them out of the
+                // timeline; the rationale is still in the event log for the
+                // right-pane / commentary to read.
+                if (e.isAgentInternal)
+                    break;
+                const id = `decision-${e.runtimeStageId}-${e.chosen}`;
+                nodes.push({
+                    id,
+                    kind: 'decision-branch',
+                    label: e.chosen,
+                    startOffsetMs: t,
+                    subflowPath: e.subflowPath,
+                });
+                break;
+            }
+            case 'loop.iteration': {
+                // Self-edge on the currently active subflow node. If no active
+                // subflow node, drop the edge (edge with no `from` is invalid).
+                if (activeNodeId) {
+                    edges.push({
+                        id: `loop-${activeNodeId}-${e.iteration}`,
+                        from: activeNodeId,
+                        to: activeNodeId,
+                        kind: 'loop-iteration',
+                        iteration: e.iteration,
+                    });
+                }
+                break;
+            }
+            case 'context.injected': {
+                pendingInjections.push({
+                    slot: e.slot,
+                    source: e.source,
+                    ...(e.sourceId ? { sourceId: e.sourceId } : {}),
+                    ...(e.asRole ? { asRole: e.asRole } : {}),
+                    ...(e.contentSummary ? { contentSummary: e.contentSummary } : {}),
+                    ...(e.reason ? { reason: e.reason } : {}),
+                    ...(e.sectionTag ? { sectionTag: e.sectionTag } : {}),
+                    ...(e.upstreamRef ? { upstreamRef: e.upstreamRef } : {}),
+                    ...(e.retrievalScore !== undefined ? { retrievalScore: e.retrievalScore } : {}),
+                    ...(e.rankPosition !== undefined ? { rankPosition: e.rankPosition } : {}),
+                    ...(e.budgetTokens !== undefined ? { budgetTokens: e.budgetTokens } : {}),
+                    ...(e.budgetFraction !== undefined ? { budgetFraction: e.budgetFraction } : {}),
+                });
+                break;
+            }
+            case 'llm.start': {
+                iter += 1;
+                const id = `step-llm-start-${e.runtimeStageId}-${iter}`;
+                const injections = pendingInjections;
+                pendingInjections = [];
+                // Flush buffered slot boundaries onto this LLM step. Slot
+                // subflows that fired since the previous LLM end (or run start)
+                // are attributed to THIS call.
+                const slotBoundaries = Object.keys(pendingSlotBoundaries).length > 0 ? pendingSlotBoundaries : undefined;
+                pendingSlotBoundaries = {};
+                // BoundaryRecorder uses the unicode arrow `→` for the typed
+                // `actorArrow` field; StepNode.kind uses ASCII `->` for legacy
+                // compatibility. Map between them.
+                const stepKind = e.actorArrow === 'tool→llm' ? 'tool->llm' : 'user->llm';
+                const node = {
+                    id,
+                    kind: stepKind,
+                    label: stepKind === 'tool->llm' ? 'tool → llm' : 'user → llm',
+                    startOffsetMs: t,
+                    llmModel: e.model,
+                    subflowPath: e.subflowPath,
+                    injections,
+                    iterationIndex: iter,
+                    slotUpdated: 'messages',
+                    // Bind to the underlying boundary event's runtimeStageId so
+                    // consumers (Lens commentary, custom dashboards) can look up
+                    // every event that belongs to this LLM call by id.
+                    runtimeStageId: e.runtimeStageId,
+                    ...(slotBoundaries ? { slotBoundaries } : {}),
+                };
+                nodes.push(node);
+                if (prevReActId) {
+                    edges.push({
+                        id: `${prevReActId}->${id}`,
+                        from: prevReActId,
+                        to: id,
+                        kind: 'next',
+                    });
+                }
+                prevReActId = id;
+                break;
+            }
+            case 'llm.end': {
+                // The just-prior llm.start's StepNode gets tokens added.
+                // For terminal calls (actorArrow='llm→user') we ALSO append a
+                // separate llm→user delivery marker so the slider has a
+                // distinct "answer delivered" position.
+                const lastStart = findLastByKind(nodes, ['user->llm', 'tool->llm']);
+                if (lastStart) {
+                    lastStart.tokens = {
+                        in: e.usage.input,
+                        out: e.usage.output,
+                    };
+                    lastStart.endOffsetMs = t;
+                }
+                if (e.actorArrow === 'llm→user') {
+                    const id = `step-llm-end-${e.runtimeStageId}-${iter}`;
+                    const node = {
+                        id,
+                        kind: 'llm->user',
+                        label: 'llm → user',
+                        startOffsetMs: t,
+                        endOffsetMs: t,
+                        subflowPath: e.subflowPath,
+                        iterationIndex: iter,
+                        runtimeStageId: e.runtimeStageId,
+                    };
+                    nodes.push(node);
+                    if (prevReActId) {
+                        edges.push({
+                            id: `${prevReActId}->${id}`,
+                            from: prevReActId,
+                            to: id,
+                            kind: 'next',
+                        });
+                    }
+                    prevReActId = id;
+                }
+                break;
+            }
+            case 'tool.start': {
+                const id = `step-tool-start-${e.runtimeStageId}-${e.toolCallId}`;
+                const node = {
+                    id,
+                    kind: 'llm->tool',
+                    label: `llm → tool (${e.toolName})`,
+                    startOffsetMs: t,
+                    toolName: e.toolName,
+                    subflowPath: e.subflowPath,
+                    iterationIndex: iter,
+                    slotUpdated: 'tools',
+                    runtimeStageId: e.runtimeStageId,
+                };
+                nodes.push(node);
+                if (prevReActId) {
+                    edges.push({
+                        id: `${prevReActId}->${id}`,
+                        from: prevReActId,
+                        to: id,
+                        kind: 'next',
+                    });
+                }
+                prevReActId = id;
+                break;
+            }
+            case 'tool.end': {
+                const lastTool = findLastByKind(nodes, ['llm->tool']);
+                if (lastTool) {
+                    lastTool.endOffsetMs = t;
+                }
+                break;
+            }
+        }
+    }
+    return { nodes, edges, activeNodeId };
+}
+// ─── Helpers ─────────────────────────────────────────────────────────
+function subflowToStepNode(e, t) {
+    const isAgentBoundary = e.primitiveKind === 'Agent';
+    const isPrimitiveBoundary = e.primitiveKind !== undefined && KNOWN_PRIMITIVES.has(e.primitiveKind);
+    return {
+        id: e.runtimeStageId,
+        kind: 'subflow',
+        label: e.subflowName,
+        startOffsetMs: t,
+        subflowPath: e.subflowPath,
+        isAgentBoundary,
+        isPrimitiveBoundary,
+        ...(e.primitiveKind ? { primitiveKind: e.primitiveKind } : {}),
+        ...(e.payload !== undefined ? { entryPayload: e.payload } : {}),
+        runtimeStageId: e.runtimeStageId,
+    };
+}
+/** Append a `next` edge between the previous and current node IF both
+ *  are ReAct steps (we don't auto-wire subflow-to-subflow edges; those
+ *  come from explicit fork/decision events). */
+function connectAdjacent(nodes, edges) {
+    if (nodes.length < 2)
+        return;
+    const prev = nodes[nodes.length - 2];
+    const curr = nodes[nodes.length - 1];
+    if (!isReActKind(prev.kind) || !isReActKind(curr.kind))
+        return;
+    edges.push({
+        id: `${prev.id}->${curr.id}`,
+        from: prev.id,
+        to: curr.id,
+        kind: 'next',
+    });
+}
+function isReActKind(kind) {
+    return (kind === 'user->llm' || kind === 'llm->tool' || kind === 'tool->llm' || kind === 'llm->user');
+}
+function findLastByKind(nodes, kinds) {
+    for (let i = nodes.length - 1; i >= 0; i--) {
+        if (kinds.includes(nodes[i].kind))
+            return nodes[i];
+    }
+    return undefined;
+}
+/** Map a `slotKind` (kebab-case) to the camelCase property name on
+ *  `StepNode.slotBoundaries`. Single source — change here if either
+ *  side ever renames. */
+function slotPropName(slotKind) {
+    switch (slotKind) {
+        case 'system-prompt':
+            return 'systemPrompt';
+        case 'messages':
+            return 'messages';
+        case 'tools':
+            return 'tools';
+    }
+}
+//# sourceMappingURL=FlowchartRecorder.js.map

package/dist/esm/recorders/observability/FlowchartRecorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FlowchartRecorder.js","sourceRoot":"","sources":["../../../../src/recorders/observability/FlowchartRecorder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAKH,OAAO,EAAoB,gBAAgB,EAA2B,MAAM,uBAAuB,CAAC;AA8IpG,wEAAwE;AAExE;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,eAAe,CAC7B,YAAwD,EACxD,UAA2B,EAC3B,UAA4B,EAAE;IAE9B,MAAM,QAAQ,GAAG,gBAAgB,EAAE,CAAC;IACpC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAElC,sEAAsE;IACtE,uEAAuE;IACvE,mDAAmD;IACnD,MAAM,OAAO,GAAqB,QAAQ;QACxC,CAAC,CAAC,YAAY,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC;QAClE,CAAC,CAAC,QAAQ,CAAC;IAEb,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IAExC,kEAAkE;IAClE,mEAAmE;IACnE,MAAM,aAAa,GAAG,UAAU,CAAC,EAAE,CACjC,GAAyC,EACzC,CAAC,KAA0B,EAAE,EAAE;QAC7B,iEAAiE;QACjE,kEAAkE;QAClE,kCAAkC;QAClC,8DAA8D;QAC7D,QAAgB,CAAC,gBAAgB,EAAE,CAAC,KAAK,CAAC,CAAC;QAC5C,QAAQ,EAAE,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC;IACvC,CAAC,CACF,CAAC;IAEF,OAAO;QACL,WAAW,EAAE,GAAG,EAAE,CAAC,cAAc,CAAC,QAAQ,CAAC;QAC3C,QAAQ;QACR,WAAW,EAAE,GAAG,EAAE;YAChB,SAAS,EAAE,CAAC;YACZ,aAAa,EAAE,CAAC;QAClB,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAS,YAAY,CAAC,QAA0B,EAAE,SAAqB;IACrE,OAAO;QACL,EAAE,EAAE,QAAQ,CAAC,EAAE;QACf,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE;YAChB,QAAQ,CAAC,UAAW,CAAC,CAAC,CAAC,CAAC;YACxB,SAAS,EAAE,CAAC;QACd,CAAC;QACD,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE;YACd,QAAQ,CAAC,QAAS,CAAC,CAAC,CAAC,CAAC;YACtB,SAAS,EAAE,CAAC;QACd,CAAC;QACD,cAAc,EAAE,CAAC,CAAC,EAAE,EAAE;YACpB,QAAQ,CAAC,cAAe,CAAC,CAAC,CAAC,CAAC;YAC5B,SAAS,EAAE,CAAC;QACd,CAAC;QACD,aAAa,EAAE,CAAC,CAAC,EAAE,EAAE;YACnB,QAAQ,CAAC,aAAc,CAAC,CAAC,CAAC,CAAC;YAC3B,SAAS,EAAE,CAAC;QACd,CAAC;QACD,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE;YACZ,QAAQ,CAAC,MAAO,CAAC,CAAC,CAAC,CAAC;YACpB,SAAS,EAAE,CAAC;QACd,CAAC;QACD,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE;YAChB,QAAQ,CAAC,UAAW,CAAC,CAAC,CAAC,CAAC;YACxB,SAAS,EAAE,CAAC;QACd,CAAC;QACD,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE;YACZ,QAAQ,CAAC,MAAO,CAAC,CAAC,CAAC,CAAC;YACpB,SAAS,EAAE,CAAC;QACd,CAAC;KACF,CAAC;AACJ,CAAC;AAED,wEAAwE;AAExE;;;;;GAKG;AACH,MAAM,gBAAgB,GAAwB,IAAI,GAAG,CAAC;IACpD,OAAO;IACP,SAAS;IACT,UAAU;IACV,UAAU;IACV,aAAa;IACb,MAAM;CACP,CAAC,CAAC;AAEH;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,cAAc,CAAC,QAA0B;IACvD,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,EAAE,CAAC;IACpC,MAAM,KAAK,GAAe,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAe,EAAE,CAAC;IAE7B,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,iBAAiB,GAAuB,EAAE,CAAC;IAC/C,IAAI,WAA+B,CAAC;IACpC,IAAI,UAA8B,CAAC;IACnC,IAAI,YAAgC,CAAC;IAErC;;;;;;;;;OASG;IACH,IAAI,qBAAqB,GAIrB,EAAE,CAAC;IAEP,kEAAkE;IAClE,qEAAqE;IACrE,mEAAmE;IACnE,qBAAqB;IACrB,MAAM,uBAAuB,GAAG,IAAI,GAAG,EAAoB,CAAC;IAE5D,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,IAAI,UAAU,KAAK,SAAS;YAAE,UAAU,GAAG,CAAC,CAAC,EAAE,CAAC;QAChD,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,UAAU,CAAC;QAE5B,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;YACf,KAAK,WAAW,CAAC,CAAC,CAAC;gBACjB,MAAM,IAAI,GAAa;oBACrB,EAAE,EAAE,CAAC,CAAC,cAAc;oBACpB,IAAI,EAAE,SAAS;oBACf,KAAK,EAAE,KAAK;oBACZ,aAAa,EAAE,CAAC;oBAChB,WAAW,EAAE,CAAC,CAAC,WAAW;oBAC1B,aAAa,EAAE,KAAK;oBACpB,mBAAmB,EAAE,KAAK;oBAC1B,GAAG,CAAC,CAAC,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC/D,cAAc,EAAE,CAAC,CAAC,cAAc;iBACjC,CAAC;gBACF,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACjB,uBAAuB,CAAC,GAAG,CAAC,CAAC,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;gBACpD,YAAY,GAAG,IAAI,CAAC,EAAE,CAAC;gBACvB,MAAM;YACR,CAAC;YACD,KAAK,UAAU,CAAC,CAAC,CAAC;gBAChB,MAAM,IAAI,GAAG,uBAAuB,CAAC,GAAG,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC;gBAC3D,IAAI,IAAI,EAAE,CAAC;oBACR,IAAiC,CAAC,WAAW,GAAG,CAAC,CAAC;oBACnD,IAAI,CAAC,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;wBAC3B,IAAkC,CAAC,WAAW,GAAG,CAAC,CAAC,OAAO,CAAC;oBAC9D,CAAC;oBACD,uBAAuB,CAAC,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC;gBACnD,CAAC;gBACD,YAAY,GAAG,SAAS,CAAC;gBACzB,MAAM;YACR,CAAC;YACD,KAAK,eAAe,CAAC,CAAC,CAAC;gBACrB,4DAA4D;gBAC5D,2DAA2D;gBAC3D,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;oBACf,qBAAqB,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,GAAG;wBAChD,cAAc,EAAE,CAAC,CAAC,cAAc;wBAChC,GAAG,CAAC,CAAC,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;qBAChE,CAAC;oBACF,MAAM;gBACR,CAAC;gBACD,qDAAqD;gBACrD,IAAI,CAAC,CAAC,eAAe;oBAAE,MAAM;gBAC7B,MAAM,IAAI,GAAG,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBACrC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACjB,eAAe,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;gBAC9B,uBAAuB,CAAC,GAAG,CAAC,CAAC,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;gBACpD,YAAY,GAAG,IAAI,CAAC,EAAE,CAAC;gBACvB,MAAM;YACR,CAAC;YACD,KAAK,cAAc,CAAC,CAAC,CAAC;gBACpB,4DAA4D;gBAC5D,6DAA6D;gBAC7D,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;oBACf,MAAM,GAAG,GAAG,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;oBACrC,MAAM,QAAQ,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAC;oBAC5C,IAAI,QAAQ,EAAE,CAAC;wBACb,qBAAqB,CAAC,GAAG,CAAC,GAAG;4BAC3B,GAAG,QAAQ;4BACX,GAAG,CAAC,CAAC,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;yBAC/D,CAAC;oBACJ,CAAC;oBACD,MAAM;gBACR,CAAC;gBACD,IAAI,CAAC,CAAC,eAAe;oBAAE,MAAM;gBAC7B,MAAM,IAAI,GAAG,uBAAuB,CAAC,GAAG,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC;gBAC3D,IAAI,IAAI,EAAE,CAAC;oBACR,IAAiC,CAAC,WAAW,GAAG,CAAC,CAAC;oBACnD,IAAI,CAAC,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;wBAC3B,IAAkC,CAAC,WAAW,GAAG,CAAC,CAAC,OAAO,CAAC;oBAC9D,CAAC;oBACD,uBAAuB,CAAC,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC;gBACnD,CAAC;gBACD,MAAM;YACR,CAAC;YACD,KAAK,aAAa,CAAC,CAAC,CAAC;gBACnB,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC,cAAc,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;gBACrD,KAAK,CAAC,IAAI,CAAC;oBACT,EAAE;oBACF,IAAI,EAAE,aAAa;oBACnB,KAAK,EAAE,CAAC,CAAC,SAAS;oBAClB,aAAa,EAAE,CAAC;oBAChB,WAAW,EAAE,CAAC,CAAC,WAAW;iBAC3B,CAAC,CAAC;gBACH,MAAM;YACR,CAAC;YACD,KAAK,iBAAiB,CAAC,CAAC,CAAC;gBACvB,0DAA0D;gBAC1D,2DAA2D;gBAC3D,wDAAwD;gBACxD,4DAA4D;gBAC5D,mCAAmC;gBACnC,IAAI,CAAC,CAAC,eAAe;oBAAE,MAAM;gBAC7B,MAAM,EAAE,GAAG,YAAY,CAAC,CAAC,cAAc,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;gBACtD,KAAK,CAAC,IAAI,CAAC;oBACT,EAAE;oBACF,IAAI,EAAE,iBAAiB;oBACvB,KAAK,EAAE,CAAC,CAAC,MAAM;oBACf,aAAa,EAAE,CAAC;oBAChB,WAAW,EAAE,CAAC,CAAC,WAAW;iBAC3B,CAAC,CAAC;gBACH,MAAM;YACR,CAAC;YACD,KAAK,gBAAgB,CAAC,CAAC,CAAC;gBACtB,+DAA+D;gBAC/D,gEAAgE;gBAChE,IAAI,YAAY,EAAE,CAAC;oBACjB,KAAK,CAAC,IAAI,CAAC;wBACT,EAAE,EAAE,QAAQ,YAAY,IAAI,CAAC,CAAC,SAAS,EAAE;wBACzC,IAAI,EAAE,YAAY;wBAClB,EAAE,EAAE,YAAY;wBAChB,IAAI,EAAE,gBAAgB;wBACtB,SAAS,EAAE,CAAC,CAAC,SAAS;qBACvB,CAAC,CAAC;gBACL,CAAC;gBACD,MAAM;YACR,CAAC;YACD,KAAK,kBAAkB,CAAC,CAAC,CAAC;gBACxB,iBAAiB,CAAC,IAAI,CAAC;oBACrB,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,MAAM,EAAE,CAAC,CAAC,MAAM;oBAChB,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC/C,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACzC,GAAG,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACjE,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACzC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACrD,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACxD,GAAG,CAAC,CAAC,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC/E,GAAG,CAAC,CAAC,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACzE,GAAG,CAAC,CAAC,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACzE,GAAG,CAAC,CAAC,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAChF,CAAC,CAAC;gBACH,MAAM;YACR,CAAC;YACD,KAAK,WAAW,CAAC,CAAC,CAAC;gBACjB,IAAI,IAAI,CAAC,CAAC;gBACV,MAAM,EAAE,GAAG,kBAAkB,CAAC,CAAC,cAAc,IAAI,IAAI,EAAE,CAAC;gBACxD,MAAM,UAAU,GAAG,iBAAiB,CAAC;gBACrC,iBAAiB,GAAG,EAAE,CAAC;gBACvB,0DAA0D;gBAC1D,gEAAgE;gBAChE,+BAA+B;gBAC/B,MAAM,cAAc,GAClB,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,SAAS,CAAC;gBACpF,qBAAqB,GAAG,EAAE,CAAC;gBAC3B,4DAA4D;gBAC5D,+DAA+D;gBAC/D,mCAAmC;gBACnC,MAAM,QAAQ,GAAqB,CAAC,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC;gBAC3F,MAAM,IAAI,GAAa;oBACrB,EAAE;oBACF,IAAI,EAAE,QAAQ;oBACd,KAAK,EAAE,QAAQ,KAAK,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY;oBAC7D,aAAa,EAAE,CAAC;oBAChB,QAAQ,EAAE,CAAC,CAAC,KAAK;oBACjB,WAAW,EAAE,CAAC,CAAC,WAAW;oBAC1B,UAAU;oBACV,cAAc,EAAE,IAAI;oBACpB,WAAW,EAAE,UAAU;oBACvB,4DAA4D;oBAC5D,6DAA6D;oBAC7D,mDAAmD;oBACnD,cAAc,EAAE,CAAC,CAAC,cAAc;oBAChC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC9C,CAAC;gBACF,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACjB,IAAI,WAAW,EAAE,CAAC;oBAChB,KAAK,CAAC,IAAI,CAAC;wBACT,EAAE,EAAE,GAAG,WAAW,KAAK,EAAE,EAAE;wBAC3B,IAAI,EAAE,WAAW;wBACjB,EAAE,EAAE,EAAE;wBACN,IAAI,EAAE,MAAM;qBACb,CAAC,CAAC;gBACL,CAAC;gBACD,WAAW,GAAG,EAAE,CAAC;gBACjB,MAAM;YACR,CAAC;YACD,KAAK,SAAS,CAAC,CAAC,CAAC;gBACf,yDAAyD;gBACzD,8DAA8D;gBAC9D,wDAAwD;gBACxD,wCAAwC;gBACxC,MAAM,SAAS,GAAG,cAAc,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC;gBACpE,IAAI,SAAS,EAAE,CAAC;oBACb,SAA6C,CAAC,MAAM,GAAG;wBACtD,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK;wBACjB,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM;qBACpB,CAAC;oBACD,SAAsC,CAAC,WAAW,GAAG,CAAC,CAAC;gBAC1D,CAAC;gBACD,IAAI,CAAC,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;oBAChC,MAAM,EAAE,GAAG,gBAAgB,CAAC,CAAC,cAAc,IAAI,IAAI,EAAE,CAAC;oBACtD,MAAM,IAAI,GAAa;wBACrB,EAAE;wBACF,IAAI,EAAE,WAAW;wBACjB,KAAK,EAAE,YAAY;wBACnB,aAAa,EAAE,CAAC;wBAChB,WAAW,EAAE,CAAC;wBACd,WAAW,EAAE,CAAC,CAAC,WAAW;wBAC1B,cAAc,EAAE,IAAI;wBACpB,cAAc,EAAE,CAAC,CAAC,cAAc;qBACjC,CAAC;oBACF,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBACjB,IAAI,WAAW,EAAE,CAAC;wBAChB,KAAK,CAAC,IAAI,CAAC;4BACT,EAAE,EAAE,GAAG,WAAW,KAAK,EAAE,EAAE;4BAC3B,IAAI,EAAE,WAAW;4BACjB,EAAE,EAAE,EAAE;4BACN,IAAI,EAAE,MAAM;yBACb,CAAC,CAAC;oBACL,CAAC;oBACD,WAAW,GAAG,EAAE,CAAC;gBACnB,CAAC;gBACD,MAAM;YACR,CAAC;YACD,KAAK,YAAY,CAAC,CAAC,CAAC;gBAClB,MAAM,EAAE,GAAG,mBAAmB,CAAC,CAAC,cAAc,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;gBACjE,MAAM,IAAI,GAAa;oBACrB,EAAE;oBACF,IAAI,EAAE,WAAW;oBACjB,KAAK,EAAE,eAAe,CAAC,CAAC,QAAQ,GAAG;oBACnC,aAAa,EAAE,CAAC;oBAChB,QAAQ,EAAE,CAAC,CAAC,QAAQ;oBACpB,WAAW,EAAE,CAAC,CAAC,WAAW;oBAC1B,cAAc,EAAE,IAAI;oBACpB,WAAW,EAAE,OAAO;oBACpB,cAAc,EAAE,CAAC,CAAC,cAAc;iBACjC,CAAC;gBACF,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACjB,IAAI,WAAW,EAAE,CAAC;oBAChB,KAAK,CAAC,IAAI,CAAC;wBACT,EAAE,EAAE,GAAG,WAAW,KAAK,EAAE,EAAE;wBAC3B,IAAI,EAAE,WAAW;wBACjB,EAAE,EAAE,EAAE;wBACN,IAAI,EAAE,MAAM;qBACb,CAAC,CAAC;gBACL,CAAC;gBACD,WAAW,GAAG,EAAE,CAAC;gBACjB,MAAM;YACR,CAAC;YACD,KAAK,UAAU,CAAC,CAAC,CAAC;gBAChB,MAAM,QAAQ,GAAG,cAAc,CAAC,KAAK,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;gBACtD,IAAI,QAAQ,EAAE,CAAC;oBACZ,QAAqC,CAAC,WAAW,GAAG,CAAC,CAAC;gBACzD,CAAC;gBACD,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;AACxC,CAAC;AAED,wEAAwE;AAExE,SAAS,iBAAiB,CAAC,CAAqB,EAAE,CAAS;IACzD,MAAM,eAAe,GAAG,CAAC,CAAC,aAAa,KAAK,OAAO,CAAC;IACpD,MAAM,mBAAmB,GACvB,CAAC,CAAC,aAAa,KAAK,SAAS,IAAI,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;IACzE,OAAO;QACL,EAAE,EAAE,CAAC,CAAC,cAAc;QACpB,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,CAAC,CAAC,WAAW;QACpB,aAAa,EAAE,CAAC;QAChB,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,eAAe;QACf,mBAAmB;QACnB,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9D,GAAG,CAAC,CAAC,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,cAAc,EAAE,CAAC,CAAC,cAAc;KACjC,CAAC;AACJ,CAAC;AAED;;gDAEgD;AAChD,SAAS,eAAe,CAAC,KAAiB,EAAE,KAAiB;IAC3D,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO;IAC7B,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACrC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO;IAC/D,KAAK,CAAC,IAAI,CAAC;QACT,EAAE,EAAE,GAAG,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,EAAE;QAC5B,IAAI,EAAE,IAAI,CAAC,EAAE;QACb,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,IAAI,EAAE,MAAM;KACb,CAAC,CAAC;AACL,CAAC;AAED,SAAS,WAAW,CAAC,IAAsB;IACzC,OAAO,CACL,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,WAAW,CAC7F,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CACrB,KAA0B,EAC1B,KAAkC;IAElC,KAAK,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3C,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;yBAEyB;AACzB,SAAS,YAAY,CACnB,QAAgD;IAEhD,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,eAAe;YAClB,OAAO,cAAc,CAAC;QACxB,KAAK,UAAU;YACb,OAAO,UAAU,CAAC;QACpB,KAAK,OAAO;YACV,OAAO,OAAO,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/esm/recorders/observability/LoggingRecorder.js

@@ -0,0 +1,98 @@
+/**
+ * LoggingRecorder — firehose-style structured logging of every event.
+ *
+ * Pattern: Facade over EventDispatcher's wildcard subscription.
+ * Role:    Tier 3 observability — enabled via `agent.enable.logging({...})`.
+ *          Developer debugging tool; production typically uses an OTEL
+ *          recorder instead.
+ * Emits:   Does NOT emit; READS the dispatcher and writes to the logger.
+ *
+ * Filtering: consumer picks DOMAINS by name — the same domain segment that
+ * appears in event types (`agentfootprint.<domain>.<action>`). No internal
+ * tier jargon leaks into the public API.
+ */
+/**
+ * Domain constants — one per event-registry domain. Use these instead of
+ * raw strings for autocomplete, typo protection, and rename safety.
+ *
+ * Raw strings still work (backed by the same literal union type below).
+ *
+ * @example
+ *   agent.enable.logging({ domains: [LoggingDomains.CONTEXT, LoggingDomains.STREAM] });
+ *   agent.enable.logging({ domains: ['context', 'stream'] }); // equivalent
+ */
+export const LoggingDomains = {
+    /** Context-engineering events (the 3-slot model). THE DEBUG CORE. */
+    CONTEXT: 'context',
+    /** LLM + tool request/response stream. */
+    STREAM: 'stream',
+    /** Composition control flow (Sequence / Parallel / Conditional / Loop). */
+    COMPOSITION: 'composition',
+    /** Agent lifecycle (turn · iteration · route_decided · handoff). */
+    AGENT: 'agent',
+    /** Memory strategy + store operations. */
+    MEMORY: 'memory',
+    /** Tool offered / activated / deactivated. */
+    TOOLS: 'tools',
+    /** Skill activation + deactivation. */
+    SKILL: 'skill',
+    /** Permission checks + gates. */
+    PERMISSION: 'permission',
+    /** Risk / guardrail detections. */
+    RISK: 'risk',
+    /** Provider / tool / skill fallback triggers. */
+    FALLBACK: 'fallback',
+    /** Cost + budget tracking. */
+    COST: 'cost',
+    /** Eval scores + threshold crossings. */
+    EVAL: 'eval',
+    /** Error retries + recoveries. */
+    ERROR: 'error',
+    /** Pause / resume requests. */
+    PAUSE: 'pause',
+    /** Embedding generation. */
+    EMBEDDING: 'embedding',
+};
+/**
+ * Attach a logging subscription to the event dispatcher.
+ * Returns an Unsubscribe — call to detach.
+ */
+export function attachLogging(dispatcher, options = {}) {
+    const logger = options.logger ?? defaultLogger();
+    const domains = options.domains ?? ['context', 'stream'];
+    const logAll = domains === 'all';
+    const prefixes = logAll
+        ? []
+        : domains.map((d) => `agentfootprint.${d}.`);
+    const format = options.format ?? defaultFormat;
+    return dispatcher.on('*', (event) => {
+        if (!shouldLog(event.type, logAll, prefixes))
+            return;
+        logger.log(format(event), event.payload);
+    });
+}
+function shouldLog(name, logAll, prefixes) {
+    if (logAll)
+        return true;
+    for (const p of prefixes)
+        if (name.startsWith(p))
+            return true;
+    return false;
+}
+function defaultFormat(event) {
+    const short = event.type.replace(/^agentfootprint\./, '');
+    return `[${short}]`;
+}
+function defaultLogger() {
+    return {
+        log: (msg, data) => {
+            // eslint-disable-next-line no-console
+            if (data === undefined)
+                console.log(msg);
+            // eslint-disable-next-line no-console
+            else
+                console.log(msg, data);
+        },
+    };
+}
+//# sourceMappingURL=LoggingRecorder.js.map

package/dist/esm/recorders/observability/LoggingRecorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LoggingRecorder.js","sourceRoot":"","sources":["../../../../src/recorders/observability/LoggingRecorder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAaH;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,qEAAqE;IACrE,OAAO,EAAE,SAAS;IAClB,0CAA0C;IAC1C,MAAM,EAAE,QAAQ;IAChB,2EAA2E;IAC3E,WAAW,EAAE,aAAa;IAC1B,oEAAoE;IACpE,KAAK,EAAE,OAAO;IACd,0CAA0C;IAC1C,MAAM,EAAE,QAAQ;IAChB,8CAA8C;IAC9C,KAAK,EAAE,OAAO;IACd,uCAAuC;IACvC,KAAK,EAAE,OAAO;IACd,iCAAiC;IACjC,UAAU,EAAE,YAAY;IACxB,mCAAmC;IACnC,IAAI,EAAE,MAAM;IACZ,iDAAiD;IACjD,QAAQ,EAAE,UAAU;IACpB,8BAA8B;IAC9B,IAAI,EAAE,MAAM;IACZ,yCAAyC;IACzC,IAAI,EAAE,MAAM;IACZ,kCAAkC;IAClC,KAAK,EAAE,OAAO;IACd,+BAA+B;IAC/B,KAAK,EAAE,OAAO;IACd,4BAA4B;IAC5B,SAAS,EAAE,WAAW;CACd,CAAC;AAuBX;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,UAA2B,EAC3B,UAA0B,EAAE;IAE5B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,aAAa,EAAE,CAAC;IACjD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,OAAO,KAAK,KAAK,CAAC;IACjC,MAAM,QAAQ,GAAsB,MAAM;QACxC,CAAC,CAAC,EAAE;QACJ,CAAC,CAAE,OAAoC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAC7E,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,aAAa,CAAC;IAE/C,OAAO,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,KAA0B,EAAE,EAAE;QACvD,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC;YAAE,OAAO;QACrD,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,SAAS,CAAC,IAAY,EAAE,MAAe,EAAE,QAA2B;IAC3E,IAAI,MAAM;QAAE,OAAO,IAAI,CAAC;IACxB,KAAK,MAAM,CAAC,IAAI,QAAQ;QAAE,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;IAC9D,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,aAAa,CAAC,KAA0B;IAC/C,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC;IAC1D,OAAO,IAAI,KAAK,GAAG,CAAC;AACtB,CAAC;AAED,SAAS,aAAa;IACpB,OAAO;QACL,GAAG,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;YACjB,sCAAsC;YACtC,IAAI,IAAI,KAAK,SAAS;gBAAE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACzC,sCAAsC;;gBACjC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC9B,CAAC;KACF,CAAC;AACJ,CAAC"}