agentfootprint 1.23.0 → 2.1.0

package/dist/esm/recorders/OTelRecorder.js

@@ -1,82 +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);
- */
-export class OTelRecorder {
-    id;
-    tracer;
-    serviceName;
-    turnSpan;
-    constructor(tracer, options) {
-        this.tracer = tracer;
-        this.id = options?.id ?? 'otel-recorder';
-        this.serviceName = options?.serviceName ?? 'agentfootprint';
-    }
-    onTurnStart(event) {
-        this.turnSpan = this.tracer.startSpan('agent.turn', {
-            attributes: {
-                'gen_ai.system': this.serviceName,
-                'agent.turn_number': event.turnNumber,
-            },
-        });
-    }
-    onLLMCall(event) {
-        const span = this.tracer.startSpan('gen_ai.chat', {
-            attributes: {
-                'gen_ai.system': this.serviceName,
-                'gen_ai.request.model': event.model ?? 'unknown',
-                'gen_ai.response.finish_reason': event.finishReason ?? 'unknown',
-                'gen_ai.usage.input_tokens': event.usage?.inputTokens ?? 0,
-                'gen_ai.usage.output_tokens': event.usage?.outputTokens ?? 0,
-                'gen_ai.response.latency_ms': event.latencyMs,
-                'agent.loop_iteration': event.loopIteration,
-            },
-        });
-        span.end();
-    }
-    onToolCall(event) {
-        const span = this.tracer.startSpan(`tool.${event.toolName}`, {
-            attributes: {
-                'tool.name': event.toolName,
-                'tool.latency_ms': event.latencyMs,
-                'tool.error': Boolean(event.result.error),
-            },
-        });
-        span.end();
-    }
-    onTurnComplete(event) {
-        if (this.turnSpan) {
-            this.turnSpan.setAttribute('agent.iterations', event.totalLoopIterations);
-            this.turnSpan.setAttribute('agent.message_count', event.messageCount);
-            this.turnSpan.end();
-            this.turnSpan = undefined;
-        }
-    }
-    onError(event) {
-        const span = this.tracer.startSpan('agent.error', {
-            attributes: {
-                'error.phase': event.phase,
-                'error.type': event.error instanceof Error ? event.error.name : 'unknown',
-            },
-        });
-        // OTel StatusCode.ERROR = 2
-        span.setStatus?.({
-            code: 2,
-            message: event.error instanceof Error ? event.error.message : String(event.error),
-        });
-        span.end();
-    }
-    clear() {
-        this.turnSpan = undefined;
-    }
-}
-//# sourceMappingURL=OTelRecorder.js.map

package/dist/esm/recorders/OTelRecorder.js.map

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

package/dist/esm/recorders/PermissionRecorder.js

@@ -1,86 +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: [...] }
- */
-export class PermissionRecorder {
-    id = 'permission-recorder';
-    events = [];
-    /**
-     * Wire this to gatedTools({ onBlocked: recorder.onBlocked }).
-     * Arrow function — safe to pass as callback directly.
-     */
-    onBlocked = (toolId, phase, _context) => {
-        this.events.push({
-            type: phase === 'resolve' ? 'blocked' : 'denied',
-            toolId,
-            phase,
-            timestamp: Date.now(),
-        });
-    };
-    /** AgentRecorder hook — captures successful tool calls. */
-    onToolCall(event) {
-        if (!event.result.error) {
-            this.events.push({
-                type: 'allowed',
-                toolId: event.toolName,
-                phase: 'execute',
-                timestamp: Date.now(),
-            });
-        }
-    }
-    /** All permission events in order. */
-    getEvents() {
-        return this.events;
-    }
-    /** Tools blocked at resolve time (LLM never saw them). */
-    getBlocked() {
-        return [...new Set(this.events.filter((e) => e.type === 'blocked').map((e) => e.toolId))];
-    }
-    /** Tool calls denied at execute time (hallucinated/injected). */
-    getDenied() {
-        return [...new Set(this.events.filter((e) => e.type === 'denied').map((e) => e.toolId))];
-    }
-    /** Tools that were allowed and executed successfully. */
-    getAllowed() {
-        return [...new Set(this.events.filter((e) => e.type === 'allowed').map((e) => e.toolId))];
-    }
-    /** Summary for audit logging. */
-    getSummary() {
-        return {
-            allowed: this.getAllowed(),
-            blocked: this.getBlocked(),
-            denied: this.getDenied(),
-        };
-    }
-    clear() {
-        this.events = [];
-    }
-}
-//# sourceMappingURL=PermissionRecorder.js.map

package/dist/esm/recorders/PermissionRecorder.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"PermissionRecorder.js","sourceRoot":"","sources":["../../../src/recorders/PermissionRecorder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAYH,MAAM,OAAO,kBAAkB;IACpB,EAAE,GAAG,qBAAqB,CAAC;IAC5B,MAAM,GAAsB,EAAE,CAAC;IAEvC;;;OAGG;IACM,SAAS,GAAG,CACnB,MAAc,EACd,KAA4B,EAC5B,QAAsB,EAChB,EAAE;QACR,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;YACf,IAAI,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ;YAChD,MAAM;YACN,KAAK;YACL,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,2DAA2D;IAC3D,UAAU,CAAC,KAAoB;QAC7B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YACxB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;gBACf,IAAI,EAAE,SAAS;gBACf,MAAM,EAAE,KAAK,CAAC,QAAQ;gBACtB,KAAK,EAAE,SAAS;gBAChB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACtB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,sCAAsC;IACtC,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,0DAA0D;IAC1D,UAAU;QACR,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC5F,CAAC;IAED,iEAAiE;IACjE,SAAS;QACP,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC3F,CAAC;IAED,yDAAyD;IACzD,UAAU;QACR,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC5F,CAAC;IAED,iCAAiC;IACjC,UAAU;QACR,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE;YAC1B,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE;YAC1B,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE;SACzB,CAAC;IACJ,CAAC;IAED,KAAK;QACH,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;IACnB,CAAC;CACF"}

package/dist/esm/recorders/QualityRecorder.js

@@ -1,48 +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());
- */
-// ── Recorder ─────────────────────────────────────────────────
-export class QualityRecorder {
-    id;
-    judge;
-    scores = [];
-    constructor(judge, id = 'quality-recorder') {
-        this.judge = judge;
-        this.id = id;
-    }
-    onTurnComplete(event) {
-        // Fire-and-forget — eval must not block execution
-        const result = this.judge(event);
-        if (result instanceof Promise) {
-            result.then((s) => this.scores.push(s)).catch(() => { });
-        }
-        else {
-            this.scores.push(result);
-        }
-    }
-    getScores() {
-        return [...this.scores];
-    }
-    getAverageScore() {
-        if (this.scores.length === 0)
-            return 0;
-        return this.scores.reduce((sum, s) => sum + s.score, 0) / this.scores.length;
-    }
-    clear() {
-        this.scores = [];
-    }
-}
-//# sourceMappingURL=QualityRecorder.js.map

package/dist/esm/recorders/QualityRecorder.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"QualityRecorder.js","sourceRoot":"","sources":["../../../src/recorders/QualityRecorder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAiBH,gEAAgE;AAEhE,MAAM,OAAO,eAAe;IACjB,EAAE,CAAS;IACH,KAAK,CAAe;IAC7B,MAAM,GAAmB,EAAE,CAAC;IAEpC,YAAY,KAAmB,EAAE,EAAE,GAAG,kBAAkB;QACtD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;IACf,CAAC;IAED,cAAc,CAAC,KAAwB;QACrC,kDAAkD;QAClD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;YAC9B,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAC1D,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,SAAS;QACP,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;IAED,eAAe;QACb,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC;QACvC,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;IAC/E,CAAC;IAED,KAAK;QACH,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;IACnB,CAAC;CACF"}

package/dist/esm/recorders/RecorderBridge.js

@@ -1,99 +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
- */
-export class RecorderBridge {
-    recorders;
-    turnNumber = 1;
-    loopIteration = 0;
-    _toolRuntimeStageId = '';
-    /** Set by the LLM capture recorder's onStageStart — tracks current stage's runtimeStageId. */
-    setToolRuntimeStageId(id) {
-        this._toolRuntimeStageId = id;
-    }
-    constructor(recorders) {
-        this.recorders = recorders;
-    }
-    /** Dispatch turn start event. */
-    dispatchTurnStart(message) {
-        this.dispatch('onTurnStart', { turnNumber: this.turnNumber, message });
-    }
-    /** Dispatch LLM call event from the adapter response stored in scope. */
-    dispatchLLMCall(response, latencyMs, context) {
-        const event = {
-            model: response.model,
-            usage: response.usage,
-            latencyMs,
-            turnNumber: this.turnNumber,
-            loopIteration: this.loopIteration,
-            finishReason: response.finishReason,
-            runtimeStageId: context.runtimeStageId,
-            systemPrompt: context?.systemPrompt,
-            toolDescriptions: context?.toolDescriptions,
-            messages: context?.messages,
-        };
-        this.dispatch('onLLMCall', event);
-        this.loopIteration++;
-    }
-    /** Dispatch turn complete event. */
-    dispatchTurnComplete(content, messageCount, totalLoopIterations = 0) {
-        this.dispatch('onTurnComplete', {
-            turnNumber: this.turnNumber,
-            messageCount,
-            totalLoopIterations,
-            content,
-        });
-        this.turnNumber++;
-        this.loopIteration = 0;
-    }
-    /** Dispatch tool call event. */
-    dispatchToolCall(toolName, args, result, latencyMs, runtimeStageId) {
-        this.dispatch('onToolCall', { toolName, args, result, latencyMs, runtimeStageId });
-    }
-    /**
-     * Create an onStreamEvent handler that bridges tool events to recorders.
-     * Attach this alongside the consumer's onEvent handler in AgentRunner.
-     */
-    createStreamEventBridge() {
-        const pendingTools = new Map();
-        return (event) => {
-            if (event.type === 'tool_start') {
-                pendingTools.set(event.toolCallId, {
-                    name: event.toolName,
-                    args: event.args,
-                    startMs: Date.now(),
-                });
-            }
-            else if (event.type === 'tool_end') {
-                const pending = pendingTools.get(event.toolCallId);
-                if (pending) {
-                    this.dispatchToolCall(pending.name, pending.args, { content: event.result, error: event.error }, event.latencyMs, this._toolRuntimeStageId);
-                    pendingTools.delete(event.toolCallId);
-                }
-            }
-        };
-    }
-    /** Dispatch error event. */
-    dispatchError(phase, error) {
-        this.dispatch('onError', { phase, error, turnNumber: this.turnNumber });
-    }
-    dispatch(hook, event) {
-        for (const recorder of this.recorders) {
-            try {
-                const fn = recorder[hook];
-                if (typeof fn === 'function') {
-                    fn.call(recorder, event);
-                }
-            }
-            catch {
-                // Error isolation
-            }
-        }
-    }
-}
-//# sourceMappingURL=RecorderBridge.js.map

package/dist/esm/recorders/RecorderBridge.js.map

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

package/dist/esm/recorders/TokenRecorder.js

@@ -1,74 +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';
-export class TokenRecorder extends KeyedRecorder {
-    id;
-    pricing;
-    constructor(options) {
-        super();
-        if (typeof options === 'string') {
-            this.id = options;
-            this.pricing = {};
-        }
-        else {
-            this.id = options?.id ?? 'token-recorder';
-            this.pricing = options?.pricing ?? {};
-        }
-    }
-    onLLMCall(event) {
-        const model = event.model ?? 'unknown';
-        const inputTokens = event.usage?.inputTokens ?? 0;
-        const outputTokens = event.usage?.outputTokens ?? 0;
-        const p = this.pricing[model];
-        const cost = p
-            ? (inputTokens / 1_000_000) * p.input + (outputTokens / 1_000_000) * p.output
-            : 0;
-        this.store(event.runtimeStageId, {
-            model,
-            inputTokens,
-            outputTokens,
-            latencyMs: event.latencyMs,
-            turnNumber: event.turnNumber,
-            loopIteration: event.loopIteration,
-            cost,
-            runtimeStageId: event.runtimeStageId,
-        });
-    }
-    getStats() {
-        const calls = this.values();
-        const totalCalls = calls.length;
-        const totalInputTokens = this.aggregate((s, c) => s + c.inputTokens, 0);
-        const totalOutputTokens = this.aggregate((s, c) => s + c.outputTokens, 0);
-        const totalLatencyMs = this.aggregate((s, c) => s + c.latencyMs, 0);
-        const totalCost = this.aggregate((s, c) => s + c.cost, 0);
-        return {
-            totalCalls,
-            totalInputTokens,
-            totalOutputTokens,
-            totalLatencyMs,
-            averageLatencyMs: totalCalls > 0 ? Math.round(totalLatencyMs / totalCalls) : 0,
-            totalCost,
-            calls,
-        };
-    }
-    getTotalTokens() {
-        return this.aggregate((sum, c) => sum + c.inputTokens + c.outputTokens, 0);
-    }
-    toSnapshot() {
-        return {
-            name: 'Tokens',
-            description: 'Aggregator (KeyedRecorder) — per-call LLM token usage',
-            preferredOperation: 'aggregate',
-            data: {
-                numericField: 'inputTokens',
-                grandTotal: this.getTotalTokens(),
-                steps: Object.fromEntries(this.getMap()),
-            },
-        };
-    }
-}
-//# sourceMappingURL=TokenRecorder.js.map

package/dist/esm/recorders/TokenRecorder.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"TokenRecorder.js","sourceRoot":"","sources":["../../../src/recorders/TokenRecorder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AA8BlD,MAAM,OAAO,aAAc,SAAQ,aAA2B;IACnD,EAAE,CAAS;IACH,OAAO,CAA+B;IAEvD,YAAY,OAAuC;QACjD,KAAK,EAAE,CAAC;QACR,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAChC,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC;YAClB,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;QACpB,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,EAAE,GAAG,OAAO,EAAE,EAAE,IAAI,gBAAgB,CAAC;YAC1C,IAAI,CAAC,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,EAAE,CAAC;QACxC,CAAC;IACH,CAAC;IAED,SAAS,CAAC,KAAmB;QAC3B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,SAAS,CAAC;QACvC,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,EAAE,WAAW,IAAI,CAAC,CAAC;QAClD,MAAM,YAAY,GAAG,KAAK,CAAC,KAAK,EAAE,YAAY,IAAI,CAAC,CAAC;QACpD,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC9B,MAAM,IAAI,GAAG,CAAC;YACZ,CAAC,CAAC,CAAC,WAAW,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC,YAAY,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,MAAM;YAC7E,CAAC,CAAC,CAAC,CAAC;QAEN,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,cAAc,EAAE;YAC/B,KAAK;YACL,WAAW;YACX,YAAY;YACZ,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,aAAa,EAAE,KAAK,CAAC,aAAa;YAClC,IAAI;YACJ,cAAc,EAAE,KAAK,CAAC,cAAc;SACrC,CAAC,CAAC;IACL,CAAC;IAED,QAAQ;QACN,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC5B,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC;QAChC,MAAM,gBAAgB,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QACxE,MAAM,iBAAiB,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;QAC1E,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;QACpE,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAE1D,OAAO;YACL,UAAU;YACV,gBAAgB;YAChB,iBAAiB;YACjB,cAAc;YACd,gBAAgB,EAAE,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9E,SAAS;YACT,KAAK;SACN,CAAC;IACJ,CAAC;IAED,cAAc;QACZ,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;IAC7E,CAAC;IAED,UAAU;QACR,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,uDAAuD;YACpE,kBAAkB,EAAE,WAAoB;YACxC,IAAI,EAAE;gBACJ,YAAY,EAAE,aAAa;gBAC3B,UAAU,EAAE,IAAI,CAAC,cAAc,EAAE;gBACjC,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;aACzC;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/esm/recorders/ToolUsageRecorder.js

@@ -1,58 +0,0 @@
-/**
- * ToolUsageRecorder — tracks which tools are called, how often, and latency.
- *
- * Extends KeyedRecorder<ToolCallEvent> — Map keyed by runtimeStageId.
- */
-import { KeyedRecorder } from 'footprintjs/trace';
-export class ToolUsageRecorder extends KeyedRecorder {
-    id;
-    constructor(id = 'tool-usage-recorder') {
-        super();
-        this.id = id;
-    }
-    onToolCall(event) {
-        this.store(event.runtimeStageId, event);
-    }
-    getStats() {
-        const calls = this.values();
-        const byTool = {};
-        for (const call of calls) {
-            if (!byTool[call.toolName]) {
-                byTool[call.toolName] = { calls: 0, errors: 0, totalLatencyMs: 0 };
-            }
-            byTool[call.toolName].calls++;
-            byTool[call.toolName].totalLatencyMs += call.latencyMs;
-            if (call.result.error) {
-                byTool[call.toolName].errors++;
-            }
-        }
-        const result = {};
-        for (const [name, stats] of Object.entries(byTool)) {
-            result[name] = {
-                ...stats,
-                averageLatencyMs: stats.calls > 0 ? Math.round(stats.totalLatencyMs / stats.calls) : 0,
-            };
-        }
-        return {
-            totalCalls: calls.length,
-            totalErrors: calls.filter((c) => c.result.error).length,
-            byTool: result,
-        };
-    }
-    getToolNames() {
-        return [...new Set(this.values().map((c) => c.toolName))];
-    }
-    toSnapshot() {
-        return {
-            name: 'Tools',
-            description: 'Translator (KeyedRecorder) — per-call tool usage and latency',
-            preferredOperation: 'translate',
-            data: {
-                numericField: 'latencyMs',
-                grandTotal: this.aggregate((sum, e) => sum + e.latencyMs, 0),
-                steps: Object.fromEntries(this.getMap()),
-            },
-        };
-    }
-}
-//# sourceMappingURL=ToolUsageRecorder.js.map

package/dist/esm/recorders/ToolUsageRecorder.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ToolUsageRecorder.js","sourceRoot":"","sources":["../../../src/recorders/ToolUsageRecorder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAgBlD,MAAM,OAAO,iBAAkB,SAAQ,aAA4B;IACxD,EAAE,CAAS;IAEpB,YAAY,EAAE,GAAG,qBAAqB;QACpC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;IACf,CAAC;IAED,UAAU,CAAC,KAAoB;QAC7B,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IAC1C,CAAC;IAED,QAAQ;QACN,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC5B,MAAM,MAAM,GAA8E,EAAE,CAAC;QAE7F,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC3B,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,CAAC;YACrE,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAE,CAAC;YAC9B,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,cAAc,IAAI,IAAI,CAAC,SAAS,CAAC;YACvD,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;gBACtB,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,CAAC;YACjC,CAAC;QACH,CAAC;QAED,MAAM,MAAM,GAA8B,EAAE,CAAC;QAC7C,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACnD,MAAM,CAAC,IAAI,CAAC,GAAG;gBACb,GAAG,KAAK;gBACR,gBAAgB,EAAE,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,cAAc,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;aACvF,CAAC;QACJ,CAAC;QAED,OAAO;YACL,UAAU,EAAE,KAAK,CAAC,MAAM;YACxB,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM;YACvD,MAAM,EAAE,MAAM;SACf,CAAC;IACJ,CAAC;IAED,YAAY;QACV,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED,UAAU;QACR,OAAO;YACL,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,8DAA8D;YAC3E,kBAAkB,EAAE,WAAoB;YACxC,IAAI,EAAE;gBACJ,YAAY,EAAE,WAAW;gBACzB,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;gBAC5D,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;aACzC;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/esm/recorders/TurnRecorder.js

@@ -1,83 +0,0 @@
-/**
- * TurnRecorder — tracks turn-level lifecycle events.
- *
- * Records when turns start and complete, including message counts and
- * loop iterations. Useful for debugging multi-turn conversations and
- * understanding agent behavior over time.
- *
- * Usage:
- *   const turns = new TurnRecorder();
- *   agent.recorder(turns);
- *   await agent.run(...);
- *   console.log(turns.getTurns());
- */
-export class TurnRecorder {
-    id;
-    turns = [];
-    constructor(id = 'turn-recorder') {
-        this.id = id;
-    }
-    onTurnStart(event) {
-        this.turns.push({
-            turnNumber: event.turnNumber,
-            message: event.message,
-            status: 'started',
-        });
-    }
-    onTurnComplete(event) {
-        // Update the matching started entry, or add a new one
-        const idx = this.turns.findIndex((t) => t.turnNumber === event.turnNumber && t.status === 'started');
-        if (idx >= 0) {
-            this.turns[idx] = {
-                ...this.turns[idx],
-                content: event.content,
-                messageCount: event.messageCount,
-                totalLoopIterations: event.totalLoopIterations,
-                status: 'completed',
-            };
-        }
-        else {
-            this.turns.push({
-                turnNumber: event.turnNumber,
-                message: '',
-                content: event.content,
-                messageCount: event.messageCount,
-                totalLoopIterations: event.totalLoopIterations,
-                status: 'completed',
-            });
-        }
-    }
-    onError(event) {
-        const idx = this.turns.findIndex((t) => t.turnNumber === event.turnNumber && t.status === 'started');
-        if (idx >= 0) {
-            this.turns[idx] = {
-                ...this.turns[idx],
-                error: event.error,
-                status: 'error',
-            };
-        }
-        else {
-            // Error fired before onTurnStart (e.g. prompt resolution failure).
-            // Record it anyway — never silently drop errors.
-            this.turns.push({
-                turnNumber: event.turnNumber,
-                message: '',
-                error: event.error,
-                status: 'error',
-            });
-        }
-    }
-    getTurns() {
-        return [...this.turns];
-    }
-    getCompletedCount() {
-        return this.turns.filter((t) => t.status === 'completed').length;
-    }
-    getErrorCount() {
-        return this.turns.filter((t) => t.status === 'error').length;
-    }
-    clear() {
-        this.turns = [];
-    }
-}
-//# sourceMappingURL=TurnRecorder.js.map

package/dist/esm/recorders/TurnRecorder.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"TurnRecorder.js","sourceRoot":"","sources":["../../../src/recorders/TurnRecorder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAcH,MAAM,OAAO,YAAY;IACd,EAAE,CAAS;IACZ,KAAK,GAAgB,EAAE,CAAC;IAEhC,YAAY,EAAE,GAAG,eAAe;QAC9B,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;IACf,CAAC;IAED,WAAW,CAAC,KAAqB;QAC/B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;YACd,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,MAAM,EAAE,SAAS;SAClB,CAAC,CAAC;IACL,CAAC;IAED,cAAc,CAAC,KAAwB;QACrC,sDAAsD;QACtD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAC9B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,CACnE,CAAC;QACF,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;YACb,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG;gBAChB,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC;gBAClB,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,YAAY,EAAE,KAAK,CAAC,YAAY;gBAChC,mBAAmB,EAAE,KAAK,CAAC,mBAAmB;gBAC9C,MAAM,EAAE,WAAW;aACpB,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;gBACd,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,OAAO,EAAE,EAAE;gBACX,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,YAAY,EAAE,KAAK,CAAC,YAAY;gBAChC,mBAAmB,EAAE,KAAK,CAAC,mBAAmB;gBAC9C,MAAM,EAAE,WAAW;aACpB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,CAAC,KAAsB;QAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAC9B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,CACnE,CAAC;QACF,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;YACb,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG;gBAChB,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC;gBAClB,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,MAAM,EAAE,OAAO;aAChB,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,mEAAmE;YACnE,iDAAiD;YACjD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;gBACd,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,OAAO,EAAE,EAAE;gBACX,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,MAAM,EAAE,OAAO;aAChB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,QAAQ;QACN,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IAED,iBAAiB;QACf,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,MAAM,CAAC;IACnE,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,MAAM,CAAC;IAC/D,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;IAClB,CAAC;CACF"}

package/dist/esm/recorders/agentObservability.js

@@ -1,53 +0,0 @@
-/**
- * agentObservability() — one-call preset for full agent observability.
- *
- * Bundles TokenRecorder, ToolUsageRecorder, CostRecorder, and ExplainRecorder
- * into a single CompositeRecorder. One `.recorder()` call gives you token tracking,
- * tool usage, cost estimation, and grounding analysis (sources vs claims).
- *
- * Stage-level timing is auto-attached by the runners (MetricRecorder on the
- * executor) — this preset covers the agent-level concerns only.
- *
- * @example
- * ```typescript
- * import { Agent, agentObservability } from 'agentfootprint';
- *
- * const obs = agentObservability();
- * const agent = Agent.create({ provider })
- *   .recorder(obs)
- *   .build();
- *
- * await agent.run('hello');
- *
- * obs.tokens();   // { totalCalls: 2, totalInputTokens: 150, ... }
- * obs.tools();    // { totalCalls: 1, byTool: { search: { calls: 1, ... } } }
- * obs.cost();     // 0.0042
- * obs.explain();  // { sources, claims, decisions, summary }
- * ```
- */
-import { CompositeRecorder } from './CompositeRecorder';
-import { CostRecorder } from './CostRecorder';
-import { ExplainRecorder } from './ExplainRecorder';
-import { TokenRecorder } from './TokenRecorder';
-import { ToolUsageRecorder } from './ToolUsageRecorder';
-/**
- * Create a bundled agent observability recorder.
- *
- * Tracks tokens, tool usage, cost, and grounding in a single `.recorder()` call.
- * Stage timing is handled separately by MetricRecorder (auto-attached by runners).
- */
-export function agentObservability(options) {
-    const tokenRec = new TokenRecorder();
-    const toolRec = new ToolUsageRecorder();
-    const costRec = new CostRecorder(options?.pricing ? { pricingTable: options.pricing } : undefined);
-    const explainRec = new ExplainRecorder();
-    const composite = new CompositeRecorder([tokenRec, toolRec, costRec, explainRec], options?.id ?? 'agent-observability');
-    // Convenience accessors — no need to dig into children
-    composite.tokens = () => tokenRec.getStats();
-    composite.tools = () => toolRec.getStats();
-    composite.cost = () => costRec.getTotalCost();
-    composite.costEntries = () => costRec.getEntries();
-    composite.explain = () => explainRec.explain();
-    return composite;
-}
-//# sourceMappingURL=agentObservability.js.map

package/dist/esm/recorders/agentObservability.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"agentObservability.js","sourceRoot":"","sources":["../../../src/recorders/agentObservability.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAMH,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAuBxD;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAmC;IAEnC,MAAM,QAAQ,GAAG,IAAI,aAAa,EAAE,CAAC;IACrC,MAAM,OAAO,GAAG,IAAI,iBAAiB,EAAE,CAAC;IACxC,MAAM,OAAO,GAAG,IAAI,YAAY,CAC9B,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,SAAS,CACjE,CAAC;IACF,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IAEzC,MAAM,SAAS,GAAG,IAAI,iBAAiB,CACrC,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,EACxC,OAAO,EAAE,EAAE,IAAI,qBAAqB,CACP,CAAC;IAEhC,uDAAuD;IACvD,SAAS,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;IAC7C,SAAS,CAAC,KAAK,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;IAC3C,SAAS,CAAC,IAAI,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;IAC9C,SAAS,CAAC,WAAW,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;IACnD,SAAS,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;IAE/C,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/esm/recorders/attachRecorderHelper.js

@@ -1,30 +0,0 @@
-/**
- * Shared helper for the `attachRecorder()` method that AgentRunner +
- * FlowChartRunner + ConditionalRunner + ParallelRunner + SwarmRunner
- * all expose. Same contract: idempotent on recorder id, returns detach.
- *
- * Lives here (not duplicated per runner) so any future *Runner class
- * gets the same behavior with one line of glue.
- */
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function attachRecorderToList(recorders, recorder) {
-    const id = recorder?.id;
-    if (typeof id === 'string') {
-        const existing = recorders.findIndex((r) => r.id === id);
-        if (existing >= 0) {
-            recorders[existing] = recorder;
-        }
-        else {
-            recorders.push(recorder);
-        }
-    }
-    else {
-        recorders.push(recorder);
-    }
-    return () => {
-        const idx = recorders.indexOf(recorder);
-        if (idx >= 0)
-            recorders.splice(idx, 1);
-    };
-}
-//# sourceMappingURL=attachRecorderHelper.js.map