agentfootprint 1.23.0 → 2.0.1

package/dist/types/recorders/ContextEngineeringRecorder.d.ts

@@ -1,105 +0,0 @@
-/**
- * ContextEngineeringRecorder — captures every `agentfootprint.context.*`
- * emit and exposes a structured per-injection record + per-iteration
- * accumulated ledger.
- *
- * THE ABSTRACTION (parallels footprintjs CombinedNarrativeRecorder):
- * The library emits structured context-engineering events at every
- * injection point (RAG augmentPrompt, Memory formatDefault, Skill
- * activation, Instructions firing). This recorder is the one place
- * any UI / observability tool can consume that stream — Lens uses it,
- * a custom React dashboard uses it, a CLI logger uses it, a Datadog
- * exporter uses it. One recorder, one shape, every consumer.
- *
- * Mental model (from the user's library mission):
- *   `agentfootprint = context engineering, visible.`
- *   The library emits → ContextEngineeringRecorder collects → UI consumes.
- *
- * @example
- * ```ts
- * import { Agent, contextEngineering, anthropic } from 'agentfootprint';
- *
- * const ctx = contextEngineering();
- * const agent = Agent.create({ provider: anthropic('claude-sonnet-4') })
- *   .recorder(ctx)
- *   .build();
- *
- * await agent.run('Find the answer in our docs');
- *
- * ctx.injections();      // [{ source: 'rag', slot: 'messages', role: 'system', ... }]
- * ctx.ledger();          // { system: 1, systemPromptChars: 1200, tools: 3 }
- * ctx.bySource();        // { rag: [...], skill: [...] }
- * ctx.bySlot();          // { 'messages': [...], 'system-prompt': [...] }
- * ```
- *
- * Implements footprintjs's `EmitRecorder` interface so it attaches via
- * the same `.recorder()` chain as every other recorder. Idempotent on
- * re-attach (same id → replaces; different id → coexists).
- */
-import type { EmitRecorder } from 'footprintjs';
-/** A single context-engineering injection captured during a run.
- *  Mirrors the emit-payload shape — extra fields in `payload` flow
- *  through for advanced consumers that want the raw signal. */
-export interface ContextInjectionRecord {
-    /** Source name — `rag` / `memory` / `skill` / `instructions` / etc. */
-    readonly source: string;
-    /** Which Agent slot this injection targets. */
-    readonly slot: 'system-prompt' | 'messages' | 'tools';
-    /** Wire-level LLM role when the slot is `messages`. Undefined for
-     *  system-prompt / tools (those mutate the slot directly). */
-    readonly role?: 'system' | 'user' | 'assistant' | 'tool';
-    /** Position in `messages[]` where the injected message landed. */
-    readonly targetIndex?: number;
-    /** Per-slot count deltas — sums into the ledger. Open keys: numeric
-     *  counters add, booleans OR. */
-    readonly deltaCount?: Readonly<Record<string, number | boolean>>;
-    /** Original emit-channel event name (e.g. `agentfootprint.context.rag.chunks`).
-     *  Lets consumers route on the SPECIFIC source variant when the
-     *  generic `source` isn't fine-grained enough. */
-    readonly eventName: string;
-    /** Raw payload from the emit event — full fidelity for advanced UIs. */
-    readonly payload: Readonly<Record<string, unknown>>;
-    /** Stage that fired the emit, from footprintjs's emit-event metadata.
-     *  Links the injection back to the exact stage in the execution tree. */
-    readonly runtimeStageId?: string;
-    /** Iteration number this injection landed in. Best-effort — derived
-     *  from how many `agentfootprint.stream.llm_start` events have fired
-     *  before this injection. Undefined when no LLM call yet. */
-    readonly iteration?: number;
-}
-/** Open-keyed ledger — sum of every injection's `deltaCount`. Numbers
- *  add, booleans OR. Standard keys: `system` / `user` / `assistant` /
- *  `tool` (message-role counters), `systemPromptChars`, `tools`,
- *  `toolsFromSkill`. New keys flow through unchanged. */
-export type ContextLedger = Readonly<Record<string, number | boolean>>;
-export interface ContextEngineeringRecorder extends EmitRecorder {
-    /** All injections in emit order. */
-    injections(): readonly ContextInjectionRecord[];
-    /** Cumulative ledger across the whole run. */
-    ledger(): ContextLedger;
-    /** Per-iteration ledger (1-based iteration → ledger). Iteration
-     *  derived from preceding `agentfootprint.stream.llm_start` events. */
-    ledgerByIteration(): ReadonlyMap<number, ContextLedger>;
-    /** Injections grouped by source name. */
-    bySource(): Readonly<Record<string, readonly ContextInjectionRecord[]>>;
-    /** Injections grouped by Agent slot. */
-    bySlot(): Readonly<Record<string, readonly ContextInjectionRecord[]>>;
-    /** Reset to empty — called by runners between independent runs.
-     *  No-op when the recorder hasn't been attached yet. */
-    clear(): void;
-}
-export interface ContextEngineeringRecorderOptions {
-    /** Recorder id — defaults to `'context-engineering'`. Override only
-     *  when running multiple instances side-by-side (different filters,
-     *  different sinks). */
-    readonly id?: string;
-}
-/**
- * Build a fresh ContextEngineeringRecorder.
- *
- * Function-factory style mirrors `agentObservability()` and footprintjs's
- * `narrative()` — keeps the construction site short and consumers don't
- * need to remember the class name.
- */
-export declare function contextEngineering(options?: ContextEngineeringRecorderOptions): ContextEngineeringRecorder;
-//# sourceMappingURL=ContextEngineeringRecorder.d.ts.map

package/dist/types/recorders/ContextEngineeringRecorder.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ContextEngineeringRecorder.d.ts","sourceRoot":"","sources":["../../../src/recorders/ContextEngineeringRecorder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAa,MAAM,aAAa,CAAC;AAE3D;;+DAE+D;AAC/D,MAAM,WAAW,sBAAsB;IACrC,uEAAuE;IACvE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,UAAU,GAAG,OAAO,CAAC;IACtD;kEAC8D;IAC9D,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IACzD,kEAAkE;IAClE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B;qCACiC;IACjC,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IACjE;;sDAEkD;IAClD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,wEAAwE;IACxE,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACpD;6EACyE;IACzE,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC;;iEAE6D;IAC7D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;yDAGyD;AACzD,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;AAEvE,MAAM,WAAW,0BAA2B,SAAQ,YAAY;IAC9D,oCAAoC;IACpC,UAAU,IAAI,SAAS,sBAAsB,EAAE,CAAC;IAChD,8CAA8C;IAC9C,MAAM,IAAI,aAAa,CAAC;IACxB;2EACuE;IACvE,iBAAiB,IAAI,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACxD,yCAAyC;IACzC,QAAQ,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,sBAAsB,EAAE,CAAC,CAAC,CAAC;IACxE,wCAAwC;IACxC,MAAM,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,sBAAsB,EAAE,CAAC,CAAC,CAAC;IACtE;4DACwD;IACxD,KAAK,IAAI,IAAI,CAAC;CACf;AAKD,MAAM,WAAW,iCAAiC;IAChD;;4BAEwB;IACxB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,CAAC,EAAE,iCAAiC,GAC1C,0BAA0B,CAsF5B"}

package/dist/types/recorders/CostRecorder.d.ts

@@ -1,43 +0,0 @@
-/**
- * CostRecorder — calculates USD cost from AgentRecorder LLM call events.
- *
- * Extends KeyedRecorder<CostEntry> — Map keyed by runtimeStageId.
- */
-import { KeyedRecorder } from 'footprintjs/trace';
-import type { AgentRecorder, LLMCallEvent } from '../core';
-import type { ModelPricing } from '../models/types';
-export type { ModelPricing } from '../models/types';
-export interface CostEntry {
-    readonly model: string;
-    readonly inputTokens: number;
-    readonly outputTokens: number;
-    readonly inputCost: number;
-    readonly outputCost: number;
-    readonly totalCost: number;
-    readonly runtimeStageId: string;
-}
-export interface CostRecorderOptions {
-    readonly id?: string;
-    readonly pricingTable?: Record<string, ModelPricing>;
-}
-export declare class CostRecorder extends KeyedRecorder<CostEntry> implements AgentRecorder {
-    readonly id: string;
-    private pricingTable;
-    constructor(options?: CostRecorderOptions);
-    onLLMCall(event: LLMCallEvent): void;
-    getTotalCost(): number;
-    getEntries(): CostEntry[];
-    toSnapshot(): {
-        name: string;
-        description: string;
-        preferredOperation: "accumulate";
-        data: {
-            numericField: string;
-            grandTotal: number;
-            steps: {
-                [k: string]: CostEntry;
-            };
-        };
-    };
-}
-//# sourceMappingURL=CostRecorder.d.ts.map

package/dist/types/recorders/CostRecorder.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"CostRecorder.d.ts","sourceRoot":"","sources":["../../../src/recorders/CostRecorder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CACtD;AAED,qBAAa,YAAa,SAAQ,aAAa,CAAC,SAAS,CAAE,YAAW,aAAa;IACjF,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,YAAY,CAA+B;gBAEvC,OAAO,GAAE,mBAAwB;IAM7C,SAAS,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAoBpC,YAAY,IAAI,MAAM;IAItB,UAAU,IAAI,SAAS,EAAE;IAIzB,UAAU;;;;;;;;;;;;CAYX"}

package/dist/types/recorders/ExplainRecorder.d.ts

@@ -1,117 +0,0 @@
-/**
- * ExplainRecorder — collects grounding evidence + evaluation context during traversal.
- *
- * Data is structured per-iteration for evaluation:
- *   iterations[0] = { context (what LLM had), decisions (tools chosen), sources (results), claim? }
- *   iterations[1] = { context (updated with tool results), decisions, sources, claim (final answer) }
- *
- * An evaluator walks iterations: for each one that has a claim, check if it's
- * grounded in that iteration's sources + all prior sources.
- *
- * Usage:
- *   const explain = new ExplainRecorder();
- *   agent.recorder(explain);
- *   await agent.run('Check order');
- *
- *   const report = explain.explain();
- *   report.iterations;  // per-iteration evaluation units
- *   report.sources;     // flat convenience (all sources)
- *   report.claims;      // flat convenience (all claims)
- *   report.context;     // last context snapshot
- */
-import type { AgentRecorder, LLMCallEvent, ToolCallEvent, TurnStartEvent, TurnCompleteEvent } from '../core';
-/** A source of truth — data returned by a tool. */
-export interface ToolSource {
-    readonly toolName: string;
-    readonly args: Record<string, unknown>;
-    readonly result: string;
-    readonly turnNumber?: number;
-}
-/** A claim made by the LLM in its response. */
-export interface LLMClaim {
-    readonly content: string;
-    readonly model?: string;
-    readonly iteration: number;
-}
-/** A decision the LLM made (tool call). */
-export interface AgentDecision {
-    readonly toolName: string;
-    readonly args: Record<string, unknown>;
-    readonly latencyMs: number;
-}
-/** The context the LLM had when making decisions — for evaluation. */
-export interface LLMContext {
-    /** The user's original question/input. */
-    readonly input?: string;
-    /** System prompt the LLM received. */
-    readonly systemPrompt?: string;
-    /** Tool descriptions sent to the LLM (what tools were available). */
-    readonly availableTools?: ReadonlyArray<{
-        name: string;
-        description: string;
-    }>;
-    /** Messages sent to the LLM (conversation context). */
-    readonly messages?: ReadonlyArray<{
-        role: string;
-        content: unknown;
-    }>;
-    /** Model used. */
-    readonly model?: string;
-}
-/** One iteration of the agent loop — a self-contained evaluation unit. */
-export interface EvalIteration {
-    /** Loop iteration number (0-based). */
-    readonly iteration: number;
-    /** Unique execution step identifier for this LLM call. */
-    readonly runtimeStageId?: string;
-    /** What the LLM had THIS iteration (context changes each loop — messages grow). */
-    readonly context: LLMContext;
-    /** Tool calls the LLM chose to make (empty if final response). */
-    readonly decisions: readonly AgentDecision[];
-    /** Tool results returned (empty if no tools called). */
-    readonly sources: readonly ToolSource[];
-    /** LLM's response — null for tool-calling iterations, string for final answer. */
-    readonly claim: LLMClaim | null;
-}
-/** Structured explanation — everything needed for evaluation. */
-export interface Explanation {
-    /** Per-iteration evaluation units — the connected data shape. */
-    readonly iterations: readonly EvalIteration[];
-    /** Flat convenience: all sources across all iterations. */
-    readonly sources: readonly ToolSource[];
-    /** Flat convenience: all claims across all iterations. */
-    readonly claims: readonly LLMClaim[];
-    /** Flat convenience: all decisions across all iterations. */
-    readonly decisions: readonly AgentDecision[];
-    /** Last context snapshot (same as iterations[last].context). */
-    readonly context: LLMContext;
-    readonly summary: string;
-}
-export declare class ExplainRecorder implements AgentRecorder {
-    readonly id: string;
-    private iterations;
-    private currentIterationDecisions;
-    private currentIterationSources;
-    private currentTurn;
-    private input?;
-    private currentIteration;
-    private currentRuntimeStageId?;
-    private currentContext;
-    constructor(id?: string);
-    onTurnStart(event: TurnStartEvent): void;
-    onLLMCall(event: LLMCallEvent): void;
-    onToolCall(event: ToolCallEvent): void;
-    onTurnComplete(event: TurnCompleteEvent): void;
-    /** Flush current iteration data into the iterations array. */
-    private flushIteration;
-    getSources(): readonly ToolSource[];
-    getClaims(): readonly LLMClaim[];
-    getDecisions(): readonly AgentDecision[];
-    getContext(): LLMContext;
-    /** Per-iteration evaluation units. */
-    getIterations(): readonly EvalIteration[];
-    /** Structured explanation — flat + per-iteration, everything for evaluation. */
-    explain(): Explanation;
-    clear(): void;
-}
-//# sourceMappingURL=ExplainRecorder.d.ts.map

package/dist/types/recorders/ExplainRecorder.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ExplainRecorder.d.ts","sourceRoot":"","sources":["../../../src/recorders/ExplainRecorder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,aAAa,EACb,cAAc,EACd,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAEjB,mDAAmD;AACnD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,+CAA+C;AAC/C,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,2CAA2C;AAC3C,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,sEAAsE;AACtE,MAAM,WAAW,UAAU;IACzB,0CAA0C;IAC1C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,sCAAsC;IACtC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,qEAAqE;IACrE,QAAQ,CAAC,cAAc,CAAC,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/E,uDAAuD;IACvD,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACtE,kBAAkB;IAClB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,0EAA0E;AAC1E,MAAM,WAAW,aAAa;IAC5B,uCAAuC;IACvC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,0DAA0D;IAC1D,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,mFAAmF;IACnF,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,kEAAkE;IAClE,QAAQ,CAAC,SAAS,EAAE,SAAS,aAAa,EAAE,CAAC;IAC7C,wDAAwD;IACxD,QAAQ,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,CAAC;IACxC,kFAAkF;IAClF,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC;CACjC;AAED,iEAAiE;AACjE,MAAM,WAAW,WAAW;IAC1B,iEAAiE;IACjE,QAAQ,CAAC,UAAU,EAAE,SAAS,aAAa,EAAE,CAAC;IAC9C,2DAA2D;IAC3D,QAAQ,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,CAAC;IACxC,0DAA0D;IAC1D,QAAQ,CAAC,MAAM,EAAE,SAAS,QAAQ,EAAE,CAAC;IACrC,6DAA6D;IAC7D,QAAQ,CAAC,SAAS,EAAE,SAAS,aAAa,EAAE,CAAC;IAC7C,gEAAgE;IAChE,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,eAAgB,YAAW,aAAa;IACnD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAGpB,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,yBAAyB,CAAuB;IACxD,OAAO,CAAC,uBAAuB,CAAoB;IAGnD,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,KAAK,CAAC,CAAS;IACvB,OAAO,CAAC,gBAAgB,CAAM;IAC9B,OAAO,CAAC,qBAAqB,CAAC,CAAS;IACvC,OAAO,CAAC,cAAc,CAAkB;gBAE5B,EAAE,SAAqB;IAInC,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAKxC,SAAS,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAqBpC,UAAU,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAiBtC,cAAc,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI;IAW9C,8DAA8D;IAC9D,OAAO,CAAC,cAAc;IAetB,UAAU,IAAI,SAAS,UAAU,EAAE;IAInC,SAAS,IAAI,SAAS,QAAQ,EAAE;IAIhC,YAAY,IAAI,SAAS,aAAa,EAAE;IAMxC,UAAU,IAAI,UAAU;IAIxB,sCAAsC;IACtC,aAAa,IAAI,SAAS,aAAa,EAAE;IASzC,gFAAgF;IAChF,OAAO,IAAI,WAAW;IAqBtB,KAAK,IAAI,IAAI;CAUd"}

package/dist/types/recorders/GuardrailRecorder.d.ts

@@ -1,45 +0,0 @@
-/**
- * GuardrailRecorder — checks safety/policy constraints during execution.
- *
- * Calls a check function on each turn completion. If the check returns
- * a violation, it is recorded. Violations can be reviewed after execution
- * or used to trigger alerts.
- *
- * The check function receives the turn completion event and returns
- * either null (no violation) or a Violation object.
- *
- * Usage:
- *   const guardrail = new GuardrailRecorder(async (event) => {
- *     if (event.content.includes('CONFIDENTIAL')) {
- *       return { rule: 'pii-leak', message: 'Output contains confidential data' };
- *     }
- *     return null;
- *   });
- *   agent.recorder(guardrail);
- *   await agent.run(...);
- *   if (guardrail.hasViolations()) { ... }
- */
-import type { AgentRecorder, TurnCompleteEvent } from '../core';
-export interface Violation {
-    /** Rule or policy that was violated. */
-    readonly rule: string;
-    /** Human-readable description. */
-    readonly message: string;
-    /** Severity level. Defaults to 'warning'. */
-    readonly severity?: 'info' | 'warning' | 'error';
-    /** Which turn triggered the violation. */
-    readonly turnNumber: number;
-}
-export type GuardrailCheck = (event: TurnCompleteEvent) => Violation | null | Promise<Violation | null>;
-export declare class GuardrailRecorder implements AgentRecorder {
-    readonly id: string;
-    private readonly check;
-    private violations;
-    constructor(check: GuardrailCheck, id?: string);
-    onTurnComplete(event: TurnCompleteEvent): void;
-    getViolations(): Violation[];
-    hasViolations(): boolean;
-    getViolationsByRule(rule: string): Violation[];
-    clear(): void;
-}
-//# sourceMappingURL=GuardrailRecorder.d.ts.map

package/dist/types/recorders/GuardrailRecorder.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"GuardrailRecorder.d.ts","sourceRoot":"","sources":["../../../src/recorders/GuardrailRecorder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAIhE,MAAM,WAAW,SAAS;IACxB,wCAAwC;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kCAAkC;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,6CAA6C;IAC7C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IACjD,0CAA0C;IAC1C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,MAAM,cAAc,GAAG,CAC3B,KAAK,EAAE,iBAAiB,KACrB,SAAS,GAAG,IAAI,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;AAIlD,qBAAa,iBAAkB,YAAW,aAAa;IACrD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiB;IACvC,OAAO,CAAC,UAAU,CAAmB;gBAEzB,KAAK,EAAE,cAAc,EAAE,EAAE,SAAuB;IAK5D,cAAc,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI;IAa9C,aAAa,IAAI,SAAS,EAAE;IAI5B,aAAa,IAAI,OAAO;IAIxB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE;IAI9C,KAAK,IAAI,IAAI;CAGd"}

package/dist/types/recorders/OTelRecorder.d.ts

@@ -1,50 +0,0 @@
-/**
- * OTelRecorder — exports agent events as OpenTelemetry spans.
- *
- * Takes a duck-typed Tracer from the consumer — zero @opentelemetry dependency in core.
- * Follows OpenTelemetry Semantic Conventions for GenAI where applicable.
- *
- * Usage:
- *   import { trace } from '@opentelemetry/api';
- *   import { OTelRecorder } from 'agentfootprint/observe';
- *
- *   const recorder = new OTelRecorder(trace.getTracer('agentfootprint'));
- *   agent.recorder(recorder);
- */
-import type { AgentRecorder, TurnStartEvent, LLMCallEvent, ToolCallEvent, TurnCompleteEvent, AgentErrorEvent } from '../core';
-/** Duck-typed OpenTelemetry Span — no @opentelemetry/api dependency. */
-interface OTelSpan {
-    setAttribute(key: string, value: string | number | boolean): void;
-    setStatus?(status: {
-        code: number;
-        message?: string;
-    }): void;
-    end(): void;
-}
-/** Duck-typed OpenTelemetry Tracer — consumer provides their own. */
-export interface OTelTracer {
-    startSpan(name: string, options?: {
-        attributes?: Record<string, string | number | boolean>;
-    }): OTelSpan;
-}
-export interface OTelRecorderOptions {
-    /** Recorder ID. Default: 'otel-recorder'. */
-    id?: string;
-    /** Service name for span attributes. Default: 'agentfootprint'. */
-    serviceName?: string;
-}
-export declare class OTelRecorder implements AgentRecorder {
-    readonly id: string;
-    private readonly tracer;
-    private readonly serviceName;
-    private turnSpan?;
-    constructor(tracer: OTelTracer, options?: OTelRecorderOptions);
-    onTurnStart(event: TurnStartEvent): void;
-    onLLMCall(event: LLMCallEvent): void;
-    onToolCall(event: ToolCallEvent): void;
-    onTurnComplete(event: TurnCompleteEvent): void;
-    onError(event: AgentErrorEvent): void;
-    clear(): void;
-}
-export {};
-//# sourceMappingURL=OTelRecorder.d.ts.map

package/dist/types/recorders/OTelRecorder.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"OTelRecorder.d.ts","sourceRoot":"","sources":["../../../src/recorders/OTelRecorder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,eAAe,EAChB,MAAM,SAAS,CAAC;AAEjB,wEAAwE;AACxE,UAAU,QAAQ;IAChB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;IAClE,SAAS,CAAC,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC7D,GAAG,IAAI,IAAI,CAAC;CACb;AAED,qEAAqE;AACrE,MAAM,WAAW,UAAU;IACzB,SAAS,CACP,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAA;KAAE,GACnE,QAAQ,CAAC;CACb;AAED,MAAM,WAAW,mBAAmB;IAClC,6CAA6C;IAC7C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,mEAAmE;IACnE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,YAAa,YAAW,aAAa;IAChD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,CAAW;gBAEhB,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,mBAAmB;IAM7D,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IASxC,SAAS,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAepC,UAAU,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAWtC,cAAc,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI;IAS9C,OAAO,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAerC,KAAK,IAAI,IAAI;CAGd"}

package/dist/types/recorders/PermissionRecorder.d.ts

@@ -1,66 +0,0 @@
-/**
- * PermissionRecorder — AgentRecorder that captures permission gate events.
- *
- * Tracks both layers of gatedTools defense-in-depth:
- *   1. resolve: tools filtered out (LLM never saw them)
- *   2. execute: tool calls rejected (hallucinated/injected tool name)
- *
- * Integrates with gatedTools via the onBlocked callback — events
- * are captured DURING traversal (not post-processing).
- *
- * Also captures successful tool calls via onToolCall to give a
- * complete picture: what was allowed, what was blocked, what was denied.
- *
- * Usage:
- *   const permRecorder = new PermissionRecorder();
- *
- *   const gated = gatedTools(inner, checker, {
- *     onBlocked: permRecorder.onBlocked,  // Wire the bridge
- *   });
- *
- *   const agent = Agent.create({ provider })
- *     .toolProvider(gated)
- *     .recorder(permRecorder)
- *     .build();
- *
- *   // After execution:
- *   permRecorder.getEvents();     // all permission events
- *   permRecorder.getBlocked();    // just blocked tools
- *   permRecorder.getDenied();     // execute-time rejections
- *   permRecorder.getSummary();    // { allowed: [...], blocked: [...], denied: [...] }
- */
-import type { AgentRecorder, ToolCallEvent } from '../core/recorders';
-import type { ToolContext } from '../core';
-export interface PermissionEvent {
-    readonly type: 'blocked' | 'denied' | 'allowed';
-    readonly toolId: string;
-    readonly phase: 'resolve' | 'execute';
-    readonly timestamp: number;
-}
-export declare class PermissionRecorder implements AgentRecorder {
-    readonly id = "permission-recorder";
-    private events;
-    /**
-     * Wire this to gatedTools({ onBlocked: recorder.onBlocked }).
-     * Arrow function — safe to pass as callback directly.
-     */
-    readonly onBlocked: (toolId: string, phase: 'resolve' | 'execute', _context?: ToolContext) => void;
-    /** AgentRecorder hook — captures successful tool calls. */
-    onToolCall(event: ToolCallEvent): void;
-    /** All permission events in order. */
-    getEvents(): readonly PermissionEvent[];
-    /** Tools blocked at resolve time (LLM never saw them). */
-    getBlocked(): string[];
-    /** Tool calls denied at execute time (hallucinated/injected). */
-    getDenied(): string[];
-    /** Tools that were allowed and executed successfully. */
-    getAllowed(): string[];
-    /** Summary for audit logging. */
-    getSummary(): {
-        allowed: string[];
-        blocked: string[];
-        denied: string[];
-    };
-    clear(): void;
-}
-//# sourceMappingURL=PermissionRecorder.d.ts.map

package/dist/types/recorders/PermissionRecorder.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"PermissionRecorder.d.ts","sourceRoot":"","sources":["../../../src/recorders/PermissionRecorder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;IAChD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,qBAAa,kBAAmB,YAAW,aAAa;IACtD,QAAQ,CAAC,EAAE,yBAAyB;IACpC,OAAO,CAAC,MAAM,CAAyB;IAEvC;;;OAGG;IACH,QAAQ,CAAC,SAAS,WACR,MAAM,SACP,SAAS,GAAG,SAAS,aACjB,WAAW,KACrB,IAAI,CAOL;IAEF,2DAA2D;IAC3D,UAAU,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAWtC,sCAAsC;IACtC,SAAS,IAAI,SAAS,eAAe,EAAE;IAIvC,0DAA0D;IAC1D,UAAU,IAAI,MAAM,EAAE;IAItB,iEAAiE;IACjE,SAAS,IAAI,MAAM,EAAE;IAIrB,yDAAyD;IACzD,UAAU,IAAI,MAAM,EAAE;IAItB,iCAAiC;IACjC,UAAU,IAAI;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IAQxE,KAAK,IAAI,IAAI;CAGd"}

package/dist/types/recorders/QualityRecorder.d.ts

@@ -1,37 +0,0 @@
-/**
- * QualityRecorder — evaluates output quality during execution.
- *
- * Calls a judge function on each turn completion and collects scores.
- * The judge can be LLM-powered, rule-based, or any scoring function.
- * Scores are collected during traversal (never post-processed).
- *
- * Usage:
- *   const quality = new QualityRecorder(async (event) => {
- *     const score = await llm.judge(event.content);
- *     return { score, label: score > 0.8 ? 'good' : 'poor' };
- *   });
- *   agent.recorder(quality);
- *   await agent.run(...);
- *   console.log(quality.getScores());
- */
-import type { AgentRecorder, TurnCompleteEvent } from '../core';
-export interface QualityScore {
-    /** Numeric score (0-1 recommended, but not enforced). */
-    readonly score: number;
-    /** Optional human-readable label. */
-    readonly label?: string;
-    /** Which turn this score belongs to. */
-    readonly turnNumber: number;
-}
-export type QualityJudge = (event: TurnCompleteEvent) => QualityScore | Promise<QualityScore>;
-export declare class QualityRecorder implements AgentRecorder {
-    readonly id: string;
-    private readonly judge;
-    private scores;
-    constructor(judge: QualityJudge, id?: string);
-    onTurnComplete(event: TurnCompleteEvent): void;
-    getScores(): QualityScore[];
-    getAverageScore(): number;
-    clear(): void;
-}
-//# sourceMappingURL=QualityRecorder.d.ts.map

package/dist/types/recorders/QualityRecorder.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"QualityRecorder.d.ts","sourceRoot":"","sources":["../../../src/recorders/QualityRecorder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAIhE,MAAM,WAAW,YAAY;IAC3B,yDAAyD;IACzD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,qCAAqC;IACrC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,wCAAwC;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,iBAAiB,KAAK,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;AAI9F,qBAAa,eAAgB,YAAW,aAAa;IACnD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,MAAM,CAAsB;gBAExB,KAAK,EAAE,YAAY,EAAE,EAAE,SAAqB;IAKxD,cAAc,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI;IAU9C,SAAS,IAAI,YAAY,EAAE;IAI3B,eAAe,IAAI,MAAM;IAKzB,KAAK,IAAI,IAAI;CAGd"}

package/dist/types/recorders/RecorderBridge.d.ts

@@ -1,52 +0,0 @@
-/**
- * RecorderBridge — dispatches AgentRecorder events from runner execution data.
- *
- * Runners call bridge methods at the right points:
- *   - dispatchTurnStart() before execution
- *   - dispatchLLMCall() after extracting LLM response from snapshot
- *   - dispatchTurnComplete() after successful execution
- *   - dispatchError() on failure
- */
-import type { AgentRecorder } from '../core';
-import type { LLMResponse } from '../types';
-import type { AgentStreamEvent } from '../streaming';
-export declare class RecorderBridge {
-    private readonly recorders;
-    private turnNumber;
-    private loopIteration;
-    private _toolRuntimeStageId;
-    /** Set by the LLM capture recorder's onStageStart — tracks current stage's runtimeStageId. */
-    setToolRuntimeStageId(id: string): void;
-    constructor(recorders: AgentRecorder[]);
-    /** Dispatch turn start event. */
-    dispatchTurnStart(message: string): void;
-    /** Dispatch LLM call event from the adapter response stored in scope. */
-    dispatchLLMCall(response: LLMResponse, latencyMs: number, context: {
-        runtimeStageId: string;
-        systemPrompt?: string;
-        toolDescriptions?: Array<{
-            name: string;
-            description: string;
-        }>;
-        messages?: Array<{
-            role: string;
-            content: unknown;
-        }>;
-    }): void;
-    /** Dispatch turn complete event. */
-    dispatchTurnComplete(content: string, messageCount: number, totalLoopIterations?: number): void;
-    /** Dispatch tool call event. */
-    dispatchToolCall(toolName: string, args: Record<string, unknown>, result: {
-        content: string;
-        error?: boolean;
-    }, latencyMs: number, runtimeStageId: string): void;
-    /**
-     * Create an onStreamEvent handler that bridges tool events to recorders.
-     * Attach this alongside the consumer's onEvent handler in AgentRunner.
-     */
-    createStreamEventBridge(): (event: AgentStreamEvent) => void;
-    /** Dispatch error event. */
-    dispatchError(phase: 'prompt' | 'llm' | 'tool' | 'message', error: unknown): void;
-    private dispatch;
-}
-//# sourceMappingURL=RecorderBridge.d.ts.map

package/dist/types/recorders/RecorderBridge.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"RecorderBridge.d.ts","sourceRoot":"","sources":["../../../src/recorders/RecorderBridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAgB,MAAM,SAAS,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAC5C,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,mBAAmB,CAAM;IAEjC,8FAA8F;IAC9F,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;gBAI3B,SAAS,EAAE,aAAa,EAAE;IAItC,iCAAiC;IACjC,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIxC,yEAAyE;IACzE,eAAe,CACb,QAAQ,EAAE,WAAW,EACrB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE;QACP,cAAc,EAAE,MAAM,CAAC;QACvB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,gBAAgB,CAAC,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAChE,QAAQ,CAAC,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,OAAO,CAAA;SAAE,CAAC,CAAC;KACtD,GACA,IAAI;IAiBP,oCAAoC;IACpC,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,mBAAmB,SAAI,GAAG,IAAI;IAW1F,gCAAgC;IAChC,gBAAgB,CACd,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,EAC5C,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,GACrB,IAAI;IAIP;;;OAGG;IACH,uBAAuB,IAAI,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI;IA6B5D,4BAA4B;IAC5B,aAAa,CAAC,KAAK,EAAE,QAAQ,GAAG,KAAK,GAAG,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAIjF,OAAO,CAAC,QAAQ;CAYjB"}

package/dist/types/recorders/TokenRecorder.d.ts

@@ -1,53 +0,0 @@
-/**
- * TokenRecorder — tracks token usage and cost across LLM calls.
- *
- * Extends KeyedRecorder<LLMCallEntry> — Map keyed by runtimeStageId.
- * No fallbacks. runtimeStageId is always provided by footprintjs.
- */
-import { KeyedRecorder } from 'footprintjs/trace';
-import type { AgentRecorder, LLMCallEvent } from '../core';
-import type { ModelPricing } from '../models/types';
-export interface TokenRecorderOptions {
-    id?: string;
-    pricing?: Record<string, ModelPricing>;
-}
-export interface TokenStats {
-    readonly totalCalls: number;
-    readonly totalInputTokens: number;
-    readonly totalOutputTokens: number;
-    readonly totalLatencyMs: number;
-    readonly averageLatencyMs: number;
-    readonly totalCost: number;
-    readonly calls: LLMCallEntry[];
-}
-export interface LLMCallEntry {
-    readonly model: string;
-    readonly inputTokens: number;
-    readonly outputTokens: number;
-    readonly latencyMs: number;
-    readonly turnNumber: number;
-    readonly loopIteration: number;
-    readonly cost: number;
-    readonly runtimeStageId: string;
-}
-export declare class TokenRecorder extends KeyedRecorder<LLMCallEntry> implements AgentRecorder {
-    readonly id: string;
-    private readonly pricing;
-    constructor(options?: TokenRecorderOptions | string);
-    onLLMCall(event: LLMCallEvent): void;
-    getStats(): TokenStats;
-    getTotalTokens(): number;
-    toSnapshot(): {
-        name: string;
-        description: string;
-        preferredOperation: "aggregate";
-        data: {
-            numericField: string;
-            grandTotal: number;
-            steps: {
-                [k: string]: LLMCallEntry;
-            };
-        };
-    };
-}
-//# sourceMappingURL=TokenRecorder.d.ts.map

package/dist/types/recorders/TokenRecorder.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"TokenRecorder.d.ts","sourceRoot":"","sources":["../../../src/recorders/TokenRecorder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,MAAM,WAAW,oBAAoB;IACnC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,YAAY,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,qBAAa,aAAc,SAAQ,aAAa,CAAC,YAAY,CAAE,YAAW,aAAa;IACrF,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+B;gBAE3C,OAAO,CAAC,EAAE,oBAAoB,GAAG,MAAM;IAWnD,SAAS,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAqBpC,QAAQ,IAAI,UAAU;IAmBtB,cAAc,IAAI,MAAM;IAIxB,UAAU;;;;;;;;;;;;CAYX"}

package/dist/types/recorders/ToolUsageRecorder.d.ts

@@ -1,38 +0,0 @@
-/**
- * ToolUsageRecorder — tracks which tools are called, how often, and latency.
- *
- * Extends KeyedRecorder<ToolCallEvent> — Map keyed by runtimeStageId.
- */
-import { KeyedRecorder } from 'footprintjs/trace';
-import type { AgentRecorder, ToolCallEvent } from '../core';
-export interface ToolUsageStats {
-    readonly totalCalls: number;
-    readonly totalErrors: number;
-    readonly byTool: Record<string, ToolStats>;
-}
-export interface ToolStats {
-    readonly calls: number;
-    readonly errors: number;
-    readonly totalLatencyMs: number;
-    readonly averageLatencyMs: number;
-}
-export declare class ToolUsageRecorder extends KeyedRecorder<ToolCallEvent> implements AgentRecorder {
-    readonly id: string;
-    constructor(id?: string);
-    onToolCall(event: ToolCallEvent): void;
-    getStats(): ToolUsageStats;
-    getToolNames(): string[];
-    toSnapshot(): {
-        name: string;
-        description: string;
-        preferredOperation: "translate";
-        data: {
-            numericField: string;
-            grandTotal: number;
-            steps: {
-                [k: string]: ToolCallEvent;
-            };
-        };
-    };
-}
-//# sourceMappingURL=ToolUsageRecorder.d.ts.map