agentfootprint 1.22.0 → 2.0.1

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":"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"}

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"attachRecorderHelper.js","sourceRoot":"","sources":["../../../src/recorders/attachRecorderHelper.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,8DAA8D;AAC9D,MAAM,UAAU,oBAAoB,CAAC,SAAgB,EAAE,QAAa;IAClE,MAAM,EAAE,GAAI,QAA4B,EAAE,EAAE,CAAC;IAC7C,IAAI,OAAO,EAAE,KAAK,QAAQ,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAE,CAAqB,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAC9E,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;YAClB,SAAS,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC;QACjC,CAAC;aAAM,CAAC;YACN,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;SAAM,CAAC;QACN,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,GAAG,EAAE;QACV,MAAM,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACxC,IAAI,GAAG,IAAI,CAAC;YAAE,SAAS,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IACzC,CAAC,CAAC;AACJ,CAAC"}

package/dist/esm/recorders/forwardEmitRecorders.js

@@ -1,29 +0,0 @@
-/**
- * forwardEmitRecorders — runner-side helper that attaches any
- * EmitRecorder-shaped consumer to the executor's emit channel.
- *
- * Why this exists: `runner.recorder(rec)` accepts both `AgentRecorder`
- * (semantic events via RecorderBridge) and `EmitRecorder` (raw emit
- * events). The runner's stored array is typed loosely; this helper
- * does the shape detection in ONE place so every runner's `run()`
- * can route by calling a single line.
- *
- * Without this, `contextEngineering()` (and any other consumer that
- * implements `onEmit`) silently drops events because RecorderBridge
- * doesn't know about the emit channel.
- *
- * Usage inside a runner's `.run()`, after the executor is created:
- *
- *   forwardEmitRecorders(executor, this.recorders);
- */
-export function forwardEmitRecorders(
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-executor, recorders) {
-    for (const rec of recorders) {
-        if (rec && typeof rec.onEmit === 'function') {
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            executor.attachEmitRecorder(rec);
-        }
-    }
-}
-//# sourceMappingURL=forwardEmitRecorders.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"forwardEmitRecorders.js","sourceRoot":"","sources":["../../../src/recorders/forwardEmitRecorders.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,oBAAoB;AAClC,8DAA8D;AAC9D,QAA8C,EAC9C,SAAiC;IAEjC,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC5B,IAAI,GAAG,IAAI,OAAQ,GAA4B,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;YACtE,8DAA8D;YAC9D,QAAQ,CAAC,kBAAkB,CAAC,GAAU,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/esm/recorders/index.js

@@ -1,15 +0,0 @@
-/**
- * recorders/ — AgentRecorder implementations.
- */
-export { TokenRecorder } from './TokenRecorder';
-export { CostRecorder } from './CostRecorder';
-export { ToolUsageRecorder } from './ToolUsageRecorder';
-export { TurnRecorder } from './TurnRecorder';
-export { QualityRecorder } from './QualityRecorder';
-export { GuardrailRecorder } from './GuardrailRecorder';
-export { CompositeRecorder } from './CompositeRecorder';
-export { PermissionRecorder } from './PermissionRecorder';
-export { agentObservability } from './agentObservability';
-export { contextEngineering } from './ContextEngineeringRecorder';
-export { agentTimeline, AgentTimelineRecorder } from './AgentTimelineRecorder';
-//# sourceMappingURL=index.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/recorders/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAOlE,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/esm/resilience.barrel.js

@@ -1,17 +0,0 @@
-/**
- * agentfootprint/resilience — Make agents reliable.
- *
- * Retry, fallback, circuit breaker, cross-family provider failover.
- *
- * @example
- * ```typescript
- * import { withRetry, resilientProvider } from 'agentfootprint/resilience';
- *
- * const reliable = withRetry(agent, { maxRetries: 3 });
- * const provider = resilientProvider([anthropicAdapter, openaiAdapter]);
- * ```
- */
-export { withRetry, withFallback, withCircuitBreaker, CircuitBreaker } from './compositions';
-export { resilientProvider, fallbackProvider } from './adapters';
-export { classifyStatusCode, wrapSDKError } from './types';
-//# sourceMappingURL=resilience.barrel.js.map

package/dist/esm/resilience.barrel.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"resilience.barrel.js","sourceRoot":"","sources":["../../src/resilience.barrel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAO7F,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEjE,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC"}

package/dist/esm/scope/AgentScope.js

@@ -1,135 +0,0 @@
-/**
- * AgentScope — typed wrapper over ScopeFacade for agent state.
- *
- * Instead of raw scope.getValue('messages'), use scope.getMessages().
- * All paths come from AGENT_PATHS constants (single source of truth).
- */
-/**
- * Well-known scope paths for memory subflow state.
- * Single key: `memory_preparedMessages` is the Messages-slot output.
- */
-export const MEMORY_PATHS = {
-    /** Prepared messages after strategy applied (Messages slot output). */
-    PREPARED_MESSAGES: 'memory_preparedMessages',
-};
-/** Well-known scope paths for agent state. */
-export const AGENT_PATHS = {
-    MESSAGES: 'messages',
-    SYSTEM_PROMPT: 'systemPrompt',
-    TOOL_DESCRIPTIONS: 'toolDescriptions',
-    ADAPTER_RESULT: 'adapterResult',
-    PARSED_RESPONSE: 'parsedResponse',
-    LOOP_COUNT: 'loopCount',
-    MAX_ITERATIONS: 'maxIterations',
-    RESULT: 'result',
-};
-/** Well-known scope paths for multi-agent pipeline state. */
-export const MULTI_AGENT_PATHS = {
-    PIPELINE_INPUT: 'pipelineInput',
-    AGENT_RESULTS: 'agentResults',
-    RESULT: 'result',
-    SIGNAL: '_signal',
-    TIMEOUT_MS: '_timeoutMs',
-};
-/** Well-known scope paths for RAG state. */
-export const RAG_PATHS = {
-    RETRIEVAL_QUERY: 'retrievalQuery',
-    RETRIEVAL_RESULT: 'retrievalResult',
-    CONTEXT_WINDOW: 'contextWindow',
-};
-/**
- * Typed accessors for agent state in scope.
- * These are pure functions — no class inheritance needed.
- */
-export const AgentScope = {
-    // ── Reads ──────────────────────────────────────────────
-    getMessages(scope) {
-        const msgs = scope.getValue(AGENT_PATHS.MESSAGES);
-        return msgs ? [...msgs] : [];
-    },
-    getSystemPrompt(scope) {
-        return scope.getValue(AGENT_PATHS.SYSTEM_PROMPT);
-    },
-    getToolDescriptions(scope) {
-        return scope.getValue(AGENT_PATHS.TOOL_DESCRIPTIONS) ?? [];
-    },
-    getAdapterResult(scope) {
-        return scope.getValue(AGENT_PATHS.ADAPTER_RESULT);
-    },
-    getParsedResponse(scope) {
-        return scope.getValue(AGENT_PATHS.PARSED_RESPONSE);
-    },
-    getLoopCount(scope) {
-        return scope.getValue(AGENT_PATHS.LOOP_COUNT) ?? 0;
-    },
-    getMaxIterations(scope) {
-        return scope.getValue(AGENT_PATHS.MAX_ITERATIONS) ?? 10;
-    },
-    getResult(scope) {
-        return scope.getValue(AGENT_PATHS.RESULT);
-    },
-    // ── Writes ─────────────────────────────────────────────
-    setMessages(scope, messages) {
-        scope.setValue(AGENT_PATHS.MESSAGES, messages);
-    },
-    setSystemPrompt(scope, prompt) {
-        scope.setValue(AGENT_PATHS.SYSTEM_PROMPT, prompt);
-    },
-    setToolDescriptions(scope, tools) {
-        scope.setValue(AGENT_PATHS.TOOL_DESCRIPTIONS, tools);
-    },
-    setAdapterResult(scope, result) {
-        scope.setValue(AGENT_PATHS.ADAPTER_RESULT, result);
-    },
-    setParsedResponse(scope, parsed) {
-        scope.setValue(AGENT_PATHS.PARSED_RESPONSE, parsed);
-    },
-    setLoopCount(scope, count) {
-        scope.setValue(AGENT_PATHS.LOOP_COUNT, count);
-    },
-    setMaxIterations(scope, max) {
-        scope.setValue(AGENT_PATHS.MAX_ITERATIONS, max);
-    },
-    setResult(scope, result) {
-        scope.setValue(AGENT_PATHS.RESULT, result);
-    },
-    // ── RAG Reads ───────────────────────────────────────────
-    getRetrievalQuery(scope) {
-        return scope.getValue(RAG_PATHS.RETRIEVAL_QUERY);
-    },
-    getRetrievalResult(scope) {
-        return scope.getValue(RAG_PATHS.RETRIEVAL_RESULT);
-    },
-    getContextWindow(scope) {
-        return scope.getValue(RAG_PATHS.CONTEXT_WINDOW);
-    },
-    // ── RAG Writes ──────────────────────────────────────────
-    setRetrievalQuery(scope, query) {
-        scope.setValue(RAG_PATHS.RETRIEVAL_QUERY, query);
-    },
-    setRetrievalResult(scope, result) {
-        scope.setValue(RAG_PATHS.RETRIEVAL_RESULT, result);
-    },
-    setContextWindow(scope, context) {
-        scope.setValue(RAG_PATHS.CONTEXT_WINDOW, context);
-    },
-    // ── Multi-Agent Reads ──────────────────────────────────────
-    getPipelineInput(scope) {
-        return scope.getValue(MULTI_AGENT_PATHS.PIPELINE_INPUT);
-    },
-    getAgentResults(scope) {
-        return scope.getValue(MULTI_AGENT_PATHS.AGENT_RESULTS) ?? [];
-    },
-    // ── Multi-Agent Writes ─────────────────────────────────────
-    setPipelineInput(scope, input) {
-        scope.setValue(MULTI_AGENT_PATHS.PIPELINE_INPUT, input);
-    },
-    setAgentResults(scope, results) {
-        scope.setValue(MULTI_AGENT_PATHS.AGENT_RESULTS, results);
-    },
-    // ── Memory Reads ───────────────────────────────────────────
-    getPreparedMessages(scope) {
-        return scope.getValue(MEMORY_PATHS.PREPARED_MESSAGES) ?? [];
-    },
-};
-//# sourceMappingURL=AgentScope.js.map