agentfootprint 1.22.0 → 2.0.1

package/dist/esm/recorders/ContextEngineeringRecorder.js

@@ -1,155 +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).
- */
-const CONTEXT_PREFIX = 'agentfootprint.context.';
-const STREAM_LLM_START = 'agentfootprint.stream.llm_start';
-/**
- * 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 function contextEngineering(options) {
-    const id = options?.id ?? 'context-engineering';
-    let injections = [];
-    let currentIteration = 0;
-    const recorder = {
-        id,
-        onEmit(event) {
-            // Track iteration from the surrounding stream events. Each
-            // `llm_start` increments — injections that follow are tagged
-            // with the in-progress iteration so consumers can group by it.
-            if (event.name === STREAM_LLM_START) {
-                const payload = event.payload;
-                currentIteration = payload?.iteration ?? currentIteration + 1;
-                return;
-            }
-            if (!event.name.startsWith(CONTEXT_PREFIX))
-                return;
-            const payload = (event.payload ?? {});
-            // Slot is required — events without one are too underspecified to
-            // be useful. Drop silently rather than recording garbage.
-            const slot = payload.slot;
-            if (slot !== 'system-prompt' && slot !== 'messages' && slot !== 'tools')
-                return;
-            // Source name — strip the prefix + take first segment of the
-            // remaining suffix (e.g. `agentfootprint.context.rag.chunks` → `rag`).
-            const suffix = event.name.slice(CONTEXT_PREFIX.length);
-            const source = suffix.split('.')[0] || 'context';
-            const record = {
-                source,
-                slot,
-                eventName: event.name,
-                payload,
-                ...(typeof payload.role === 'string'
-                    ? { role: payload.role }
-                    : {}),
-                ...(typeof payload.targetIndex === 'number'
-                    ? { targetIndex: payload.targetIndex }
-                    : {}),
-                ...(payload.deltaCount && typeof payload.deltaCount === 'object'
-                    ? { deltaCount: payload.deltaCount }
-                    : {}),
-                ...(event.runtimeStageId ? { runtimeStageId: event.runtimeStageId } : {}),
-                ...(currentIteration > 0 ? { iteration: currentIteration } : {}),
-            };
-            injections.push(record);
-        },
-        injections() {
-            return injections;
-        },
-        ledger() {
-            return foldLedger(injections);
-        },
-        ledgerByIteration() {
-            const buckets = new Map();
-            for (const inj of injections) {
-                const k = inj.iteration ?? 0;
-                const bucket = buckets.get(k) ?? [];
-                bucket.push(inj);
-                buckets.set(k, bucket);
-            }
-            const result = new Map();
-            for (const [iter, list] of buckets)
-                result.set(iter, foldLedger(list));
-            return result;
-        },
-        bySource() {
-            const out = {};
-            for (const inj of injections) {
-                (out[inj.source] ??= []).push(inj);
-            }
-            return out;
-        },
-        bySlot() {
-            const out = {};
-            for (const inj of injections) {
-                (out[inj.slot] ??= []).push(inj);
-            }
-            return out;
-        },
-        clear() {
-            injections = [];
-            currentIteration = 0;
-        },
-    };
-    return recorder;
-}
-/** Fold a list of injections into a single ledger — numbers add,
- *  booleans OR. Pure function so it's safe to call from any read-side
- *  query without mutating the underlying record list. */
-function foldLedger(list) {
-    const ledger = {};
-    for (const inj of list) {
-        const d = inj.deltaCount;
-        if (!d)
-            continue;
-        for (const [key, val] of Object.entries(d)) {
-            if (typeof val === 'number') {
-                const prev = typeof ledger[key] === 'number' ? ledger[key] : 0;
-                ledger[key] = prev + val;
-            }
-            else if (typeof val === 'boolean') {
-                ledger[key] = ledger[key] === true || val;
-            }
-        }
-    }
-    return ledger;
-}
-//# sourceMappingURL=ContextEngineeringRecorder.js.map

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

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

package/dist/esm/recorders/CostRecorder.js

@@ -1,51 +0,0 @@
-/**
- * CostRecorder — calculates USD cost from AgentRecorder LLM call events.
- *
- * Extends KeyedRecorder<CostEntry> — Map keyed by runtimeStageId.
- */
-import { KeyedRecorder } from 'footprintjs/trace';
-export class CostRecorder extends KeyedRecorder {
-    id;
-    pricingTable;
-    constructor(options = {}) {
-        super();
-        this.id = options.id ?? 'cost-recorder';
-        this.pricingTable = options.pricingTable ?? {};
-    }
-    onLLMCall(event) {
-        const model = event.model ?? 'unknown';
-        const inputTokens = event.usage?.inputTokens ?? 0;
-        const outputTokens = event.usage?.outputTokens ?? 0;
-        const pricing = this.pricingTable[model];
-        const inputCost = pricing ? (inputTokens / 1_000_000) * pricing.input : 0;
-        const outputCost = pricing ? (outputTokens / 1_000_000) * pricing.output : 0;
-        this.store(event.runtimeStageId, {
-            model,
-            inputTokens,
-            outputTokens,
-            inputCost,
-            outputCost,
-            totalCost: inputCost + outputCost,
-            runtimeStageId: event.runtimeStageId,
-        });
-    }
-    getTotalCost() {
-        return this.aggregate((sum, e) => sum + e.totalCost, 0);
-    }
-    getEntries() {
-        return this.values();
-    }
-    toSnapshot() {
-        return {
-            name: 'Cost',
-            description: 'Accumulator (KeyedRecorder) — per-call LLM cost tracking',
-            preferredOperation: 'accumulate',
-            data: {
-                numericField: 'totalCost',
-                grandTotal: this.getTotalCost(),
-                steps: Object.fromEntries(this.getMap()),
-            },
-        };
-    }
-}
-//# sourceMappingURL=CostRecorder.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"CostRecorder.js","sourceRoot":"","sources":["../../../src/recorders/CostRecorder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAoBlD,MAAM,OAAO,YAAa,SAAQ,aAAwB;IAC/C,EAAE,CAAS;IACZ,YAAY,CAA+B;IAEnD,YAAY,UAA+B,EAAE;QAC3C,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,EAAE,IAAI,eAAe,CAAC;QACxC,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC;IACjD,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;QAEpD,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QACzC,MAAM,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,WAAW,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1E,MAAM,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,YAAY,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAE7E,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,cAAc,EAAE;YAC/B,KAAK;YACL,WAAW;YACX,YAAY;YACZ,SAAS;YACT,UAAU;YACV,SAAS,EAAE,SAAS,GAAG,UAAU;YACjC,cAAc,EAAE,KAAK,CAAC,cAAc;SACrC,CAAC,CAAC;IACL,CAAC;IAED,YAAY;QACV,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;IACvB,CAAC;IAED,UAAU;QACR,OAAO;YACL,IAAI,EAAE,MAAM;YACZ,WAAW,EAAE,0DAA0D;YACvE,kBAAkB,EAAE,YAAqB;YACzC,IAAI,EAAE;gBACJ,YAAY,EAAE,WAAW;gBACzB,UAAU,EAAE,IAAI,CAAC,YAAY,EAAE;gBAC/B,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;aACzC;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/esm/recorders/ExplainRecorder.js

@@ -1,148 +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
- */
-export class ExplainRecorder {
-    id;
-    // Per-iteration accumulation
-    iterations = [];
-    currentIterationDecisions = [];
-    currentIterationSources = [];
-    // Tracking state
-    currentTurn = 0;
-    input;
-    currentIteration = -1;
-    currentRuntimeStageId;
-    currentContext = {};
-    constructor(id = 'explain-recorder') {
-        this.id = id;
-    }
-    onTurnStart(event) {
-        this.currentTurn = event.turnNumber;
-        this.input = event.message;
-    }
-    onLLMCall(event) {
-        // Flush previous iteration (if any) — it had no claim (tool-calling response)
-        if (this.currentIteration >= 0) {
-            this.flushIteration(null);
-        }
-        this.currentIteration = event.loopIteration;
-        this.currentRuntimeStageId = event.runtimeStageId;
-        // Snapshot context for THIS iteration
-        this.currentContext = {
-            input: this.input,
-            systemPrompt: event.systemPrompt ?? this.currentContext.systemPrompt,
-            availableTools: event.toolDescriptions
-                ? [...event.toolDescriptions]
-                : this.currentContext.availableTools,
-            messages: event.messages ? [...event.messages] : this.currentContext.messages,
-            model: event.model,
-        };
-    }
-    onToolCall(event) {
-        const source = {
-            toolName: event.toolName,
-            args: { ...event.args },
-            result: String(event.result.content),
-            turnNumber: this.currentTurn,
-        };
-        this.currentIterationSources.push(source);
-        const decision = {
-            toolName: event.toolName,
-            args: { ...event.args },
-            latencyMs: event.latencyMs,
-        };
-        this.currentIterationDecisions.push(decision);
-    }
-    onTurnComplete(event) {
-        // Guard: if no onLLMCall fired (e.g., cached response), use iteration 0
-        if (this.currentIteration < 0)
-            this.currentIteration = 0;
-        const claim = {
-            content: event.content,
-            model: this.currentContext.model,
-            iteration: this.currentIteration,
-        };
-        this.flushIteration(claim);
-    }
-    /** Flush current iteration data into the iterations array. */
-    flushIteration(claim) {
-        this.iterations.push({
-            iteration: this.currentIteration,
-            runtimeStageId: this.currentRuntimeStageId,
-            context: { ...this.currentContext },
-            decisions: this.currentIterationDecisions.map((d) => ({ ...d, args: { ...d.args } })),
-            sources: [...this.currentIterationSources],
-            claim,
-        });
-        this.currentIterationDecisions = [];
-        this.currentIterationSources = [];
-    }
-    // ── Flat convenience accessors (backward compatible) ────
-    getSources() {
-        return this.iterations.flatMap((it) => it.sources);
-    }
-    getClaims() {
-        return this.iterations.filter((it) => it.claim).map((it) => it.claim);
-    }
-    getDecisions() {
-        return this.iterations.flatMap((it) => it.decisions.map((d) => ({ ...d, args: { ...d.args } })));
-    }
-    getContext() {
-        return { ...this.currentContext };
-    }
-    /** Per-iteration evaluation units. */
-    getIterations() {
-        return this.iterations.map((it) => ({
-            ...it,
-            context: { ...it.context },
-            decisions: it.decisions.map((d) => ({ ...d, args: { ...d.args } })),
-            sources: [...it.sources],
-        }));
-    }
-    /** Structured explanation — flat + per-iteration, everything for evaluation. */
-    explain() {
-        const allDecisions = this.getDecisions();
-        const toolNames = [...new Set(allDecisions.map((d) => d.toolName))];
-        const allSources = this.getSources();
-        const summary = allSources.length === 0
-            ? `Agent responded directly without calling tools.`
-            : `Agent called ${toolNames.join(', ')} (${allSources.length} call${allSources.length > 1 ? 's' : ''}), then responded based on the results.`;
-        return {
-            iterations: this.getIterations(),
-            sources: allSources,
-            claims: this.getClaims(),
-            decisions: allDecisions,
-            context: this.getContext(),
-            summary,
-        };
-    }
-    clear() {
-        this.iterations = [];
-        this.currentIterationDecisions = [];
-        this.currentIterationSources = [];
-        this.currentTurn = 0;
-        this.input = undefined;
-        this.currentIteration = -1;
-        this.currentRuntimeStageId = undefined;
-        this.currentContext = {};
-    }
-}
-//# sourceMappingURL=ExplainRecorder.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"ExplainRecorder.js","sourceRoot":"","sources":["../../../src/recorders/ExplainRecorder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AA6EH,MAAM,OAAO,eAAe;IACjB,EAAE,CAAS;IAEpB,6BAA6B;IACrB,UAAU,GAAoB,EAAE,CAAC;IACjC,yBAAyB,GAAoB,EAAE,CAAC;IAChD,uBAAuB,GAAiB,EAAE,CAAC;IAEnD,iBAAiB;IACT,WAAW,GAAG,CAAC,CAAC;IAChB,KAAK,CAAU;IACf,gBAAgB,GAAG,CAAC,CAAC,CAAC;IACtB,qBAAqB,CAAU;IAC/B,cAAc,GAAe,EAAE,CAAC;IAExC,YAAY,EAAE,GAAG,kBAAkB;QACjC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;IACf,CAAC;IAED,WAAW,CAAC,KAAqB;QAC/B,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,UAAU,CAAC;QACpC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC;IAC7B,CAAC;IAED,SAAS,CAAC,KAAmB;QAC3B,8EAA8E;QAC9E,IAAI,IAAI,CAAC,gBAAgB,IAAI,CAAC,EAAE,CAAC;YAC/B,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;QAED,IAAI,CAAC,gBAAgB,GAAG,KAAK,CAAC,aAAa,CAAC;QAC5C,IAAI,CAAC,qBAAqB,GAAG,KAAK,CAAC,cAAc,CAAC;QAElD,sCAAsC;QACtC,IAAI,CAAC,cAAc,GAAG;YACpB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,YAAY,EAAE,KAAK,CAAC,YAAY,IAAI,IAAI,CAAC,cAAc,CAAC,YAAY;YACpE,cAAc,EAAE,KAAK,CAAC,gBAAgB;gBACpC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,gBAAgB,CAAC;gBAC7B,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,cAAc;YACtC,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,QAAQ;YAC7E,KAAK,EAAE,KAAK,CAAC,KAAK;SACnB,CAAC;IACJ,CAAC;IAED,UAAU,CAAC,KAAoB;QAC7B,MAAM,MAAM,GAAe;YACzB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,IAAI,EAAE,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE;YACvB,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC;YACpC,UAAU,EAAE,IAAI,CAAC,WAAW;SAC7B,CAAC;QACF,IAAI,CAAC,uBAAuB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAE1C,MAAM,QAAQ,GAAkB;YAC9B,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,IAAI,EAAE,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE;YACvB,SAAS,EAAE,KAAK,CAAC,SAAS;SAC3B,CAAC;QACF,IAAI,CAAC,yBAAyB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAChD,CAAC;IAED,cAAc,CAAC,KAAwB;QACrC,wEAAwE;QACxE,IAAI,IAAI,CAAC,gBAAgB,GAAG,CAAC;YAAE,IAAI,CAAC,gBAAgB,GAAG,CAAC,CAAC;QACzD,MAAM,KAAK,GAAa;YACtB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,KAAK,EAAE,IAAI,CAAC,cAAc,CAAC,KAAK;YAChC,SAAS,EAAE,IAAI,CAAC,gBAAgB;SACjC,CAAC;QACF,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED,8DAA8D;IACtD,cAAc,CAAC,KAAsB;QAC3C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YACnB,SAAS,EAAE,IAAI,CAAC,gBAAgB;YAChC,cAAc,EAAE,IAAI,CAAC,qBAAqB;YAC1C,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,cAAc,EAAE;YACnC,SAAS,EAAE,IAAI,CAAC,yBAAyB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACrF,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,uBAAuB,CAAC;YAC1C,KAAK;SACN,CAAC,CAAC;QACH,IAAI,CAAC,yBAAyB,GAAG,EAAE,CAAC;QACpC,IAAI,CAAC,uBAAuB,GAAG,EAAE,CAAC;IACpC,CAAC;IAED,2DAA2D;IAE3D,UAAU;QACR,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC;IACrD,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,KAAM,CAAC,CAAC;IACzE,CAAC;IAED,YAAY;QACV,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CACpC,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CACzD,CAAC;IACJ,CAAC;IAED,UAAU;QACR,OAAO,EAAE,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;IACpC,CAAC;IAED,sCAAsC;IACtC,aAAa;QACX,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;YAClC,GAAG,EAAE;YACL,OAAO,EAAE,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE;YAC1B,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACnE,OAAO,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC;SACzB,CAAC,CAAC,CAAC;IACN,CAAC;IAED,gFAAgF;IAChF,OAAO;QACL,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QACzC,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QACpE,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QACrC,MAAM,OAAO,GACX,UAAU,CAAC,MAAM,KAAK,CAAC;YACrB,CAAC,CAAC,iDAAiD;YACnD,CAAC,CAAC,gBAAgB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,UAAU,CAAC,MAAM,QACxD,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAChC,yCAAyC,CAAC;QAEhD,OAAO;YACL,UAAU,EAAE,IAAI,CAAC,aAAa,EAAE;YAChC,OAAO,EAAE,UAAU;YACnB,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE;YACxB,SAAS,EAAE,YAAY;YACvB,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE;YAC1B,OAAO;SACR,CAAC;IACJ,CAAC;IAED,KAAK;QACH,IAAI,CAAC,UAAU,GAAG,EAAE,CAAC;QACrB,IAAI,CAAC,yBAAyB,GAAG,EAAE,CAAC;QACpC,IAAI,CAAC,uBAAuB,GAAG,EAAE,CAAC;QAClC,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;QACvB,IAAI,CAAC,gBAAgB,GAAG,CAAC,CAAC,CAAC;QAC3B,IAAI,CAAC,qBAAqB,GAAG,SAAS,CAAC;QACvC,IAAI,CAAC,cAAc,GAAG,EAAE,CAAC;IAC3B,CAAC;CACF"}

package/dist/esm/recorders/GuardrailRecorder.js

@@ -1,58 +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()) { ... }
- */
-// ── Recorder ─────────────────────────────────────────────────
-export class GuardrailRecorder {
-    id;
-    check;
-    violations = [];
-    constructor(check, id = 'guardrail-recorder') {
-        this.check = check;
-        this.id = id;
-    }
-    onTurnComplete(event) {
-        const result = this.check(event);
-        if (result instanceof Promise) {
-            result
-                .then((v) => {
-                if (v)
-                    this.violations.push(v);
-            })
-                .catch(() => { });
-        }
-        else if (result) {
-            this.violations.push(result);
-        }
-    }
-    getViolations() {
-        return [...this.violations];
-    }
-    hasViolations() {
-        return this.violations.length > 0;
-    }
-    getViolationsByRule(rule) {
-        return this.violations.filter((v) => v.rule === rule);
-    }
-    clear() {
-        this.violations = [];
-    }
-}
-//# sourceMappingURL=GuardrailRecorder.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"GuardrailRecorder.js","sourceRoot":"","sources":["../../../src/recorders/GuardrailRecorder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAqBH,gEAAgE;AAEhE,MAAM,OAAO,iBAAiB;IACnB,EAAE,CAAS;IACH,KAAK,CAAiB;IAC/B,UAAU,GAAgB,EAAE,CAAC;IAErC,YAAY,KAAqB,EAAE,EAAE,GAAG,oBAAoB;QAC1D,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;IACf,CAAC;IAED,cAAc,CAAC,KAAwB;QACrC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;YAC9B,MAAM;iBACH,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;gBACV,IAAI,CAAC;oBAAE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACjC,CAAC,CAAC;iBACD,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACrB,CAAC;aAAM,IAAI,MAAM,EAAE,CAAC;YAClB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,aAAa;QACX,OAAO,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;IAC9B,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;IACpC,CAAC;IAED,mBAAmB,CAAC,IAAY;QAC9B,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IACxD,CAAC;IAED,KAAK;QACH,IAAI,CAAC,UAAU,GAAG,EAAE,CAAC;IACvB,CAAC;CACF"}

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":"AAAA;;;;;;;;;;;;GAYG;AAiCH,MAAM,OAAO,YAAY;IACd,EAAE,CAAS;IACH,MAAM,CAAa;IACnB,WAAW,CAAS;IAC7B,QAAQ,CAAY;IAE5B,YAAY,MAAkB,EAAE,OAA6B;QAC3D,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,GAAG,OAAO,EAAE,EAAE,IAAI,eAAe,CAAC;QACzC,IAAI,CAAC,WAAW,GAAG,OAAO,EAAE,WAAW,IAAI,gBAAgB,CAAC;IAC9D,CAAC;IAED,WAAW,CAAC,KAAqB;QAC/B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,YAAY,EAAE;YAClD,UAAU,EAAE;gBACV,eAAe,EAAE,IAAI,CAAC,WAAW;gBACjC,mBAAmB,EAAE,KAAK,CAAC,UAAU;aACtC;SACF,CAAC,CAAC;IACL,CAAC;IAED,SAAS,CAAC,KAAmB;QAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,aAAa,EAAE;YAChD,UAAU,EAAE;gBACV,eAAe,EAAE,IAAI,CAAC,WAAW;gBACjC,sBAAsB,EAAE,KAAK,CAAC,KAAK,IAAI,SAAS;gBAChD,+BAA+B,EAAE,KAAK,CAAC,YAAY,IAAI,SAAS;gBAChE,2BAA2B,EAAE,KAAK,CAAC,KAAK,EAAE,WAAW,IAAI,CAAC;gBAC1D,4BAA4B,EAAE,KAAK,CAAC,KAAK,EAAE,YAAY,IAAI,CAAC;gBAC5D,4BAA4B,EAAE,KAAK,CAAC,SAAS;gBAC7C,sBAAsB,EAAE,KAAK,CAAC,aAAa;aAC5C;SACF,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,EAAE,CAAC;IACb,CAAC;IAED,UAAU,CAAC,KAAoB;QAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,KAAK,CAAC,QAAQ,EAAE,EAAE;YAC3D,UAAU,EAAE;gBACV,WAAW,EAAE,KAAK,CAAC,QAAQ;gBAC3B,iBAAiB,EAAE,KAAK,CAAC,SAAS;gBAClC,YAAY,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC;aAC1C;SACF,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,EAAE,CAAC;IACb,CAAC;IAED,cAAc,CAAC,KAAwB;QACrC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,kBAAkB,EAAE,KAAK,CAAC,mBAAmB,CAAC,CAAC;YAC1E,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,qBAAqB,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;YACtE,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;YACpB,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,OAAO,CAAC,KAAsB;QAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,aAAa,EAAE;YAChD,UAAU,EAAE;gBACV,aAAa,EAAE,KAAK,CAAC,KAAK;gBAC1B,YAAY,EAAE,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;aAC1E;SACF,CAAC,CAAC;QACH,4BAA4B;QAC5B,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,IAAI,EAAE,CAAC;YACP,OAAO,EAAE,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC;SAClF,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,EAAE,CAAC;IACb,CAAC;IAED,KAAK;QACH,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC;IAC5B,CAAC;CACF"}

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