agentfootprint 1.22.0 → 2.0.1

package/dist/esm/patterns/ToT.js

@@ -0,0 +1,98 @@
+/**
+ * ToT — Tree of Thoughts: breadth-first iterative expansion + pruning.
+ *
+ * Paper: "Tree of Thoughts: Deliberate Problem Solving with Large
+ *        Language Models" — Yao et al., 2023
+ *        (https://arxiv.org/abs/2305.10601).
+ *
+ * Pattern: Factory → produces a `Runner` built from `Loop(depth times,
+ *          Parallel(K thought branches) + prune-to-top-M)`.
+ * Role:    patterns/ layer. Pure composition over existing primitives.
+ *          Build-time-fixed depth + branching factor; runtime frontier
+ *          is pruned to `beamWidth` per level via a consumer-supplied
+ *          scorer.
+ *
+ * Tradeoff vs. full DFS: this shipped variant is BFS with constant
+ * width. True DFS with backtracking or adaptive branching factor would
+ * need runtime-variable Parallel (DynamicParallel) or recursion.
+ */
+import { LLMCall } from '../core/LLMCall.js';
+import { Loop } from '../core-flow/Loop.js';
+import { Parallel } from '../core-flow/Parallel.js';
+/**
+ * Build a ToT Runner. At run time:
+ *   1. Seed — treat the input message as the initial frontier of 1 thought.
+ *   2. For each of `depth` iterations:
+ *      a. Parallel fan-out: generate `branchingFactor` new thoughts.
+ *      b. Score all new thoughts, keep top `beamWidth`, pass to next iteration.
+ *   3. Return the single best-scoring thought from the final frontier.
+ */
+export function tot(opts) {
+    if (opts.depth < 1)
+        throw new Error('ToT: depth must be >= 1');
+    if (opts.branchingFactor < 2) {
+        throw new Error('ToT: branchingFactor must be >= 2 (use Reflection for depth-only)');
+    }
+    const beamWidth = opts.beamWidth ?? 1;
+    if (beamWidth < 1)
+        throw new Error('ToT: beamWidth must be >= 1');
+    // Each iteration's body is a Parallel fan-out of `branchingFactor`
+    // identical LLMCalls, followed by a scoring-and-pruning pass. The
+    // Parallel branches all receive the same parent-frontier message;
+    // since temperature drives diversity, they produce distinct thoughts.
+    let par = Parallel.create({ id: 'thoughts' });
+    for (let i = 0; i < opts.branchingFactor; i++) {
+        const thoughtLLM = LLMCall.create({
+            provider: opts.provider,
+            model: opts.model,
+            temperature: opts.temperature ?? 0.7,
+            ...(opts.maxTokens !== undefined && { maxTokens: opts.maxTokens }),
+        })
+            .system(opts.thoughtPrompt)
+            .build();
+        par = par.branch(`thought-${i}`, thoughtLLM);
+    }
+    // Merge: score all branch outputs, keep top `beamWidth`, concatenate
+    // them as the body's output. Next iteration's LLMCalls will see this
+    // combined survivor text as their input.
+    const parallelStage = par
+        .mergeWithFn((results) => {
+        const ordered = Object.entries(results)
+            .map(([id, thought]) => ({ id, thought, score: opts.score(thought) }))
+            .sort((a, b) => b.score - a.score);
+        const survivors = ordered.slice(0, beamWidth);
+        // Join survivors with a delimiter so the next iteration's LLM can
+        // see the full surviving frontier context. When beamWidth=1 this
+        // is just the winning thought.
+        return survivors.map((s) => s.thought).join('\n\n---\n\n');
+    })
+        .build();
+    // Loop body: the Parallel fan-out + merge. `times(depth)` bounds the
+    // iteration count. Each iteration's output becomes the next
+    // iteration's input automatically (Loop.current = body output).
+    const loop = Loop.create({
+        id: opts.id ?? 'tot',
+        name: opts.name ?? 'ToT',
+    })
+        .repeat(parallelStage)
+        .times(opts.depth)
+        .build();
+    // Return loop directly — its final output is the best surviving thought
+    // after `depth` iterations. Wrapping in Sequence would just add an
+    // identity step. For single-thought selection at the end, consumers
+    // can wrap in their own Sequence step.
+    return wrapAsRunner(loop, opts.name ?? 'ToT', opts.id ?? 'tot');
+}
+/**
+ * Identity wrapper so the ToT runner surface stays consistent with
+ * other patterns (factory returns Runner, not Loop directly). Loop is
+ * already a Runner — this is a stable identity passthrough that also
+ * lets us stamp the composition id/name for topology clarity.
+ */
+function wrapAsRunner(inner, _name, _id) {
+    // Loop already IS a Runner — return directly. The identity wrapper
+    // would only be needed if we wanted to layer extra events. The
+    // underscore params are future-proofing for adding a seed step.
+    return inner;
+}
+//# sourceMappingURL=ToT.js.map

package/dist/esm/patterns/ToT.js.map

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

package/dist/esm/patterns/index.js

@@ -1,18 +1,23 @@
 /**
- * agentfootprint/patterns — canonical agent composition patterns.
+ * patterns/ — factory functions that compose primitives + core-flow
+ * into well-known agent patterns from the research literature.
  *
- * Each pattern is a thin factory over the existing concepts (`FlowChart`,
- * `Parallel`, `Conditional`, `Agent`, `LLMCall`, `RAG`, `Swarm`). No new
- * primitives. The source of each file shows the composition — read it to
- * learn how to build your own.
+ * Each pattern is:
+ *   - A factory function returning a `Runner` — drops into any
+ *     `Sequence.step()`, `Parallel.branch()`, etc.
+ *   - Purely composed — no new primitives, no state machinery beyond
+ *     what the underlying compositions provide.
+ *   - Documented with the canonical paper reference.
  *
- * @example
- * ```ts
- * import { treeOfThoughts, reflexion, planExecute, mapReduce } from 'agentfootprint/patterns';
- * ```
+ * Build-time-fixed cardinality: all patterns take a FIXED
+ * shard/branch/agent count at build time. Run-time-variable branching
+ * is a separate (not-yet-shipped) feature and would need a
+ * `DynamicParallel` primitive.
  */
-export { planExecute } from './planExecute';
-export { mapReduce } from './mapReduce';
-export { treeOfThoughts } from './treeOfThoughts';
-export { reflexion } from './reflexion';
+export { selfConsistency } from './SelfConsistency.js';
+export { reflection } from './Reflection.js';
+export { debate } from './Debate.js';
+export { mapReduce } from './MapReduce.js';
+export { tot } from './ToT.js';
+export { swarm } from './Swarm.js';
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/patterns/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/patterns/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,eAAe,EAA+B,MAAM,sBAAsB,CAAC;AACpF,OAAO,EAAE,UAAU,EAA0B,MAAM,iBAAiB,CAAC;AACrE,OAAO,EAAE,MAAM,EAAsB,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,SAAS,EAAyB,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAE,GAAG,EAAmB,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,KAAK,EAAsC,MAAM,YAAY,CAAC"}

package/dist/esm/providers.js

@@ -0,0 +1,27 @@
+/**
+ * agentfootprint/providers — LLM provider adapters.
+ *
+ * Pattern: Adapter (GoF) — concrete `LLMProvider` implementations that
+ *          translate the agentfootprint port to a specific vendor SDK.
+ * Role:    Outer ring (Hexagonal). Swappable at runtime; the Agent
+ *          knows nothing about vendor specifics.
+ *
+ * What's here today:
+ *   • `mock` / `MockProvider` — deterministic + realistic-mode mock
+ *   • `anthropic` / `AnthropicProvider` — real provider (Claude)
+ *   • `openai` / `OpenAIProvider` — real provider (GPT)
+ *
+ * Bring your own (BYO):
+ *   For Bedrock / Ollama / Cohere / on-prem / fine-tuned models,
+ *   implement the `LLMProvider` interface (see `LLMProvider` exported
+ *   from the main barrel) — `complete()` is required, `stream()` is
+ *   optional. The `MockProvider` source is the canonical reference.
+ */
+export { MockProvider, mock, } from './adapters/llm/MockProvider.js';
+export { anthropic, AnthropicProvider, } from './adapters/llm/AnthropicProvider.js';
+export { openai, OpenAIProvider, ollama, } from './adapters/llm/OpenAIProvider.js';
+export { bedrock, BedrockProvider, } from './adapters/llm/BedrockProvider.js';
+export { browserAnthropic, BrowserAnthropicProvider, } from './adapters/llm/BrowserAnthropicProvider.js';
+export { browserOpenai, BrowserOpenAIProvider, } from './adapters/llm/BrowserOpenAIProvider.js';
+export { createProvider, } from './adapters/llm/createProvider.js';
+//# sourceMappingURL=providers.js.map

package/dist/esm/providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.js","sourceRoot":"","sources":["../../src/providers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EACL,YAAY,EACZ,IAAI,GAGL,MAAM,gCAAgC,CAAC;AAExC,OAAO,EACL,SAAS,EACT,iBAAiB,GAElB,MAAM,qCAAqC,CAAC;AAE7C,OAAO,EACL,MAAM,EACN,cAAc,EACd,MAAM,GAEP,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EACL,OAAO,EACP,eAAe,GAEhB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EACL,gBAAgB,EAChB,wBAAwB,GAEzB,MAAM,4CAA4C,CAAC;AAEpD,OAAO,EACL,aAAa,EACb,qBAAqB,GAEtB,MAAM,yCAAyC,CAAC;AAEjD,OAAO,EACL,cAAc,GAGf,MAAM,kCAAkC,CAAC"}

package/dist/esm/recorders/core/AgentRecorder.js

@@ -0,0 +1,20 @@
+/**
+ * AgentRecorder — forwards `agentfootprint.agent.*` emits to the dispatcher.
+ *
+ * Pattern: Factory (GoF) returning an EmitBridge instance.
+ * Role:    Convenience constructor for the agent-lifecycle bridge recorder.
+ *          Same mechanics as StreamRecorder, scoped to agent.* events
+ *          (turns + iterations + route decisions + handoffs).
+ * Emits:   agentfootprint.agent.turn_start / turn_end / iteration_start /
+ *          iteration_end / route_decided / handoff
+ */
+import { EmitBridge } from './EmitBridge.js';
+export function agentRecorder(options) {
+    return new EmitBridge({
+        id: options.id ?? 'agentfootprint.agent-recorder',
+        prefix: 'agentfootprint.agent.',
+        dispatcher: options.dispatcher,
+        getRunContext: options.getRunContext,
+    });
+}
+//# sourceMappingURL=AgentRecorder.js.map

package/dist/esm/recorders/core/AgentRecorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentRecorder.js","sourceRoot":"","sources":["../../../../src/recorders/core/AgentRecorder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAA0B,MAAM,iBAAiB,CAAC;AAMrE,MAAM,UAAU,aAAa,CAAC,OAA6B;IACzD,OAAO,IAAI,UAAU,CAAC;QACpB,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,+BAA+B;QACjD,MAAM,EAAE,uBAAuB;QAC/B,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,aAAa,EAAE,OAAO,CAAC,aAAa;KACrC,CAAC,CAAC;AACL,CAAC"}

package/dist/esm/recorders/core/CompositionRecorder.js

@@ -0,0 +1,22 @@
+/**
+ * CompositionRecorder — forwards `agentfootprint.composition.*` emits to the dispatcher.
+ *
+ * Pattern: Factory (GoF) returning an EmitBridge instance.
+ * Role:    Convenience constructor for the composition-domain bridge recorder.
+ *          Compositions (Sequence, Parallel, Conditional, Loop) typedEmit
+ *          composition.enter/exit/fork_start/branch_complete/merge_end/
+ *          route_decided/iteration_start/iteration_exit from their internal
+ *          stages; this recorder observes via footprintjs's EmitRecorder
+ *          channel and re-dispatches with typed payloads + meta.
+ * Emits:   agentfootprint.composition.*
+ */
+import { EmitBridge } from './EmitBridge.js';
+export function compositionRecorder(options) {
+    return new EmitBridge({
+        id: options.id ?? 'agentfootprint.composition-recorder',
+        prefix: 'agentfootprint.composition.',
+        dispatcher: options.dispatcher,
+        getRunContext: options.getRunContext,
+    });
+}
+//# sourceMappingURL=CompositionRecorder.js.map

package/dist/esm/recorders/core/CompositionRecorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompositionRecorder.js","sourceRoot":"","sources":["../../../../src/recorders/core/CompositionRecorder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,UAAU,EAA0B,MAAM,iBAAiB,CAAC;AAMrE,MAAM,UAAU,mBAAmB,CAAC,OAAmC;IACrE,OAAO,IAAI,UAAU,CAAC;QACpB,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,qCAAqC;QACvD,MAAM,EAAE,6BAA6B;QACrC,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,aAAa,EAAE,OAAO,CAAC,aAAa;KACrC,CAAC,CAAC;AACL,CAAC"}

package/dist/esm/recorders/core/ContextRecorder.js

@@ -0,0 +1,218 @@
+/**
+ * ContextRecorder — observes footprintjs subflow + scope events, emits
+ * grouped `context.*` domain events via the EventDispatcher.
+ *
+ * Pattern: Observer (GoF) + Pipes & Filters (Hohpe & Woolf, 2003).
+ * Role:    Core semantic grouping layer for the 3-slot model. Watches
+ *          slot subflows (sf-system-prompt / sf-messages / sf-tools) and
+ *          translates raw writes into context.injected / evicted /
+ *          slot_composed / budget_pressure events.
+ * Emits:   agentfootprint.context.injected
+ *          agentfootprint.context.evicted
+ *          agentfootprint.context.slot_composed
+ *          agentfootprint.context.budget_pressure
+ */
+import { INJECTION_KEYS, slotFromSubflowId } from '../../conventions.js';
+import { buildEventMeta } from '../../bridge/eventMeta.js';
+import { COMPOSITION_KEYS } from './types.js';
+export class ContextRecorder {
+    id;
+    dispatcher;
+    getRunContext;
+    // Active slot stack — stacked because a slot subflow CAN nest another
+    // (rare but possible if a custom source is a subflow itself).
+    slotStack = [];
+    // Previously seen injections per slot, by scope key. We diff old-vs-new
+    // on each write to identify NEW injections (the builder may write the
+    // whole array multiple times; we only emit events for the additions).
+    seenInjections = new Map();
+    constructor(options) {
+        this.dispatcher = options.dispatcher;
+        this.id = options.id ?? 'agentfootprint.context-recorder';
+        this.getRunContext = options.getRunContext;
+    }
+    // ─── Subflow boundaries ────────────────────────────────────────
+    onSubflowEntry(event) {
+        const slot = event.subflowId ? slotFromSubflowId(event.subflowId) : undefined;
+        if (!slot)
+            return;
+        this.slotStack.push(slot);
+        // Reset the seen-set for this slot — new iteration.
+        this.seenInjections.set(slot, new Set());
+    }
+    onSubflowExit(event) {
+        if (!event.subflowId)
+            return;
+        const slot = slotFromSubflowId(event.subflowId);
+        if (!slot)
+            return;
+        // Pop only if this is the active top (defensive against mis-ordering).
+        if (this.slotStack[this.slotStack.length - 1] === slot) {
+            this.slotStack.pop();
+        }
+        this.seenInjections.delete(slot);
+    }
+    // ─── Scope writes — the injection / eviction / pressure signals ──
+    onWrite(event) {
+        const activeSlot = this.currentSlot();
+        if (!activeSlot)
+            return;
+        const key = event.key;
+        // Injection signals (INJECTION_KEYS) — per-slot arrays of InjectionRecord.
+        if (key === INJECTION_KEYS.SYSTEM_PROMPT && activeSlot === 'system-prompt') {
+            this.handleInjectionsWrite(activeSlot, event);
+            return;
+        }
+        if (key === INJECTION_KEYS.MESSAGES && activeSlot === 'messages') {
+            this.handleInjectionsWrite(activeSlot, event);
+            return;
+        }
+        if (key === INJECTION_KEYS.TOOLS && activeSlot === 'tools') {
+            this.handleInjectionsWrite(activeSlot, event);
+            return;
+        }
+        // Composition summary — ONE record per slot exit, written just before exit.
+        if (key === COMPOSITION_KEYS.SLOT_COMPOSED) {
+            this.handleSlotComposedWrite(event);
+            return;
+        }
+        // Evictions — per-piece removals under budget pressure.
+        if (key === COMPOSITION_KEYS.EVICTED) {
+            this.handleEvictionsWrite(event);
+            return;
+        }
+        // Budget-pressure warnings — fired BEFORE evictions.
+        if (key === COMPOSITION_KEYS.BUDGET_PRESSURE) {
+            this.handleBudgetPressureWrite(event);
+            return;
+        }
+    }
+    // ─── Internals ─────────────────────────────────────────────────
+    currentSlot() {
+        return this.slotStack[this.slotStack.length - 1];
+    }
+    handleInjectionsWrite(slot, event) {
+        const records = this.asInjectionArray(event.value);
+        if (!records)
+            return;
+        const seen = this.seenInjections.get(slot) ?? new Set();
+        for (const rec of records) {
+            if (seen.has(rec.contentHash))
+                continue;
+            seen.add(rec.contentHash);
+            this.emitInjected(rec, event);
+        }
+        this.seenInjections.set(slot, seen);
+    }
+    handleSlotComposedWrite(event) {
+        const rec = this.asSlotComposition(event.value);
+        if (!rec)
+            return;
+        this.dispatch('agentfootprint.context.slot_composed', rec, event);
+    }
+    handleEvictionsWrite(event) {
+        const records = this.asEvictionArray(event.value);
+        if (!records)
+            return;
+        for (const rec of records) {
+            this.dispatch('agentfootprint.context.evicted', rec, event);
+        }
+    }
+    handleBudgetPressureWrite(event) {
+        const records = this.asPressureArray(event.value);
+        if (!records)
+            return;
+        for (const rec of records) {
+            this.dispatch('agentfootprint.context.budget_pressure', rec, event);
+        }
+    }
+    emitInjected(rec, event) {
+        // Payload is a structural subset of InjectionRecord — InjectionRecord is
+        // designed to carry exactly what ContextInjectedPayload needs, so we
+        // copy through directly.
+        //
+        // Redaction: footprintjs's scope layer sets `event.redacted = true` if
+        // its RedactionPolicy matched the scope key. We trust that flag —
+        // `rec.rawContent` arrives already-redacted if it was going to be. We
+        // do NOT re-implement redaction here (single source of truth in
+        // footprintjs's RedactionPolicy).
+        this.dispatch('agentfootprint.context.injected', rec, event);
+    }
+    dispatch(type, payload, source) {
+        if (!this.dispatcher.hasListenersFor(type))
+            return;
+        // FlowSubflowEvent nests traversal info under .traversalContext.
+        // WriteEvent flattens runtimeStageId + stageId at the top level via
+        // RecorderContext. buildEventMeta accepts either shape.
+        const origin = 'traversalContext' in source && source.traversalContext
+            ? source.traversalContext
+            : source;
+        const meta = buildEventMeta(origin, this.getRunContext());
+        this.dispatcher.dispatch({ type, payload, meta });
+    }
+    // ─── Type-narrowing helpers ────────────────────────────────────
+    asInjectionArray(value) {
+        if (!Array.isArray(value))
+            return undefined;
+        // Duck-type — require at least `contentHash` + `slot` + `source`.
+        for (const r of value) {
+            if (!r || typeof r !== 'object')
+                return undefined;
+            const rec = r;
+            if (typeof rec.contentHash !== 'string')
+                return undefined;
+            if (typeof rec.slot !== 'string')
+                return undefined;
+            if (typeof rec.source !== 'string')
+                return undefined;
+        }
+        return value;
+    }
+    asSlotComposition(value) {
+        if (!value || typeof value !== 'object')
+            return undefined;
+        const rec = value;
+        if (typeof rec.slot !== 'string')
+            return undefined;
+        if (typeof rec.iteration !== 'number')
+            return undefined;
+        if (!rec.budget || typeof rec.budget !== 'object')
+            return undefined;
+        if (!rec.sourceBreakdown || typeof rec.sourceBreakdown !== 'object')
+            return undefined;
+        if (typeof rec.droppedCount !== 'number')
+            return undefined;
+        if (!Array.isArray(rec.droppedSummaries))
+            return undefined;
+        return value;
+    }
+    asEvictionArray(value) {
+        if (!Array.isArray(value))
+            return undefined;
+        for (const r of value) {
+            if (!r || typeof r !== 'object')
+                return undefined;
+            const rec = r;
+            if (typeof rec.slot !== 'string')
+                return undefined;
+            if (typeof rec.contentHash !== 'string')
+                return undefined;
+        }
+        return value;
+    }
+    asPressureArray(value) {
+        if (!Array.isArray(value))
+            return undefined;
+        for (const r of value) {
+            if (!r || typeof r !== 'object')
+                return undefined;
+            const rec = r;
+            if (typeof rec.slot !== 'string')
+                return undefined;
+            if (typeof rec.capTokens !== 'number')
+                return undefined;
+        }
+        return value;
+    }
+}
+//# sourceMappingURL=ContextRecorder.js.map

package/dist/esm/recorders/core/ContextRecorder.js.map

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

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

@@ -0,0 +1,19 @@
+/**
+ * CostRecorder — forwards `agentfootprint.cost.*` emits to the dispatcher.
+ *
+ * Pattern: Factory (GoF) returning an EmitBridge instance.
+ * Role:    Bridges `cost.tick` + `cost.limit_hit` emits from LLMCall / Agent
+ *          stages (via `emitCostTick`) to the EventDispatcher so typed
+ *          consumer listeners fire.
+ * Emits:   agentfootprint.cost.tick / cost.limit_hit
+ */
+import { EmitBridge } from './EmitBridge.js';
+export function costRecorder(options) {
+    return new EmitBridge({
+        id: options.id ?? 'agentfootprint.cost-recorder',
+        prefix: 'agentfootprint.cost.',
+        dispatcher: options.dispatcher,
+        getRunContext: options.getRunContext,
+    });
+}
+//# sourceMappingURL=CostRecorder.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CostRecorder.js","sourceRoot":"","sources":["../../../../src/recorders/core/CostRecorder.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAA0B,MAAM,iBAAiB,CAAC;AAMrE,MAAM,UAAU,YAAY,CAAC,OAA4B;IACvD,OAAO,IAAI,UAAU,CAAC;QACpB,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,8BAA8B;QAChD,MAAM,EAAE,sBAAsB;QAC9B,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,aAAa,EAAE,OAAO,CAAC,aAAa;KACrC,CAAC,CAAC;AACL,CAAC"}

package/dist/esm/recorders/core/EmitBridge.js

@@ -0,0 +1,41 @@
+/**
+ * EmitBridge — forwards footprintjs emits whose name starts with a given
+ * prefix to the EventDispatcher, enriched with EventMeta.
+ *
+ * Pattern: Adapter (GoF) + Pipes & Filters (Hohpe & Woolf, 2003).
+ * Role:    Single reusable translation layer for every "pass-through"
+ *          prefix recorder (StreamRecorder, AgentRecorder, and any
+ *          future domain whose events are emitted via typedEmit()).
+ * Emits:   Any event whose name matches `prefix` — type derived from the
+ *          emit name and validated by the consumer's EventMap subscription.
+ */
+import { buildEventMeta } from '../../bridge/eventMeta.js';
+export class EmitBridge {
+    id;
+    dispatcher;
+    prefix;
+    getRunContext;
+    constructor(options) {
+        this.dispatcher = options.dispatcher;
+        this.id = options.id;
+        this.prefix = options.prefix;
+        this.getRunContext = options.getRunContext;
+    }
+    onEmit(event) {
+        if (typeof event.name !== 'string')
+            return;
+        if (!event.name.startsWith(this.prefix))
+            return;
+        const type = event.name;
+        if (!this.dispatcher.hasListenersFor(type))
+            return;
+        const payload = event.payload;
+        const meta = buildEventMeta({ runtimeStageId: event.runtimeStageId, subflowPath: event.subflowPath }, this.getRunContext());
+        this.dispatcher.dispatch({
+            type,
+            payload,
+            meta,
+        });
+    }
+}
+//# sourceMappingURL=EmitBridge.js.map

package/dist/esm/recorders/core/EmitBridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmitBridge.js","sourceRoot":"","sources":["../../../../src/recorders/core/EmitBridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,EAAE,cAAc,EAAmB,MAAM,2BAA2B,CAAC;AAW5E,MAAM,OAAO,UAAU;IACZ,EAAE,CAAS;IACH,UAAU,CAAkB;IAC5B,MAAM,CAAS;IACf,aAAa,CAAmB;IAEjD,YAAY,OAA0B;QACpC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAC7C,CAAC;IAED,MAAM,CAAC,KAAgB;QACrB,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO;QAC3C,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC;YAAE,OAAO;QAChD,MAAM,IAAI,GAAG,KAAK,CAAC,IAA+B,CAAC;QACnD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,IAAI,CAAC;YAAE,OAAO;QAEnD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAqE,CAAC;QAC5F,MAAM,IAAI,GAAG,cAAc,CACzB,EAAE,cAAc,EAAE,KAAK,CAAC,cAAc,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,EACxE,IAAI,CAAC,aAAa,EAAE,CACrB,CAAC;QAEF,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;YACvB,IAAI;YACJ,OAAO;YACP,IAAI;SAC8C,CAAC,CAAC;IACxD,CAAC;CACF"}

package/dist/esm/recorders/core/EvalRecorder.js

@@ -0,0 +1,21 @@
+/**
+ * EvalRecorder — forwards `agentfootprint.eval.*` emits to the dispatcher.
+ *
+ * Pattern: Factory over EmitBridge.
+ * Role:    Bridges consumer-emitted `eval.score` + `eval.threshold_crossed`
+ *          events to typed listeners. Evaluation is a consumer concern
+ *          (LLM-based grading, heuristic checks, reference-output diffs),
+ *          so the library only provides transport — not any built-in
+ *          evaluators.
+ * Emits:   agentfootprint.eval.score / eval.threshold_crossed
+ */
+import { EmitBridge } from './EmitBridge.js';
+export function evalRecorder(options) {
+    return new EmitBridge({
+        id: options.id ?? 'agentfootprint.eval-recorder',
+        prefix: 'agentfootprint.eval.',
+        dispatcher: options.dispatcher,
+        getRunContext: options.getRunContext,
+    });
+}
+//# sourceMappingURL=EvalRecorder.js.map

package/dist/esm/recorders/core/EvalRecorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EvalRecorder.js","sourceRoot":"","sources":["../../../../src/recorders/core/EvalRecorder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,UAAU,EAA0B,MAAM,iBAAiB,CAAC;AAMrE,MAAM,UAAU,YAAY,CAAC,OAA4B;IACvD,OAAO,IAAI,UAAU,CAAC;QACpB,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,8BAA8B;QAChD,MAAM,EAAE,sBAAsB;QAC9B,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,aAAa,EAAE,OAAO,CAAC,aAAa;KACrC,CAAC,CAAC;AACL,CAAC"}

package/dist/esm/recorders/core/MemoryRecorder.js

@@ -0,0 +1,22 @@
+/**
+ * MemoryRecorder — forwards `agentfootprint.memory.*` emits to the dispatcher.
+ *
+ * Pattern: Factory over EmitBridge.
+ * Role:    Bridges memory-layer events (strategy_applied, attached,
+ *          detached, written) emitted by consumer memory adapters.
+ *          The library does not ship a memory implementation; consumers
+ *          plug in their own store and emit these events where relevant
+ *          (e.g., before/after sliding-window summarization).
+ * Emits:   agentfootprint.memory.strategy_applied / attached /
+ *          detached / written
+ */
+import { EmitBridge } from './EmitBridge.js';
+export function memoryRecorder(options) {
+    return new EmitBridge({
+        id: options.id ?? 'agentfootprint.memory-recorder',
+        prefix: 'agentfootprint.memory.',
+        dispatcher: options.dispatcher,
+        getRunContext: options.getRunContext,
+    });
+}
+//# sourceMappingURL=MemoryRecorder.js.map

package/dist/esm/recorders/core/MemoryRecorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryRecorder.js","sourceRoot":"","sources":["../../../../src/recorders/core/MemoryRecorder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,UAAU,EAA0B,MAAM,iBAAiB,CAAC;AAMrE,MAAM,UAAU,cAAc,CAAC,OAA8B;IAC3D,OAAO,IAAI,UAAU,CAAC;QACpB,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,gCAAgC;QAClD,MAAM,EAAE,wBAAwB;QAChC,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,aAAa,EAAE,OAAO,CAAC,aAAa;KACrC,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,21 @@
+/**
+ * PermissionRecorder — forwards `agentfootprint.permission.*` emits
+ * to the dispatcher.
+ *
+ * Pattern: Factory over EmitBridge.
+ * Role:    Bridges permission.check, permission.gate_opened, and
+ *          permission.gate_closed emits into the typed dispatcher so
+ *          consumer `.on('agentfootprint.permission.check', ...)`
+ *          listeners fire.
+ * Emits:   agentfootprint.permission.check / gate_opened / gate_closed
+ */
+import { EmitBridge } from './EmitBridge.js';
+export function permissionRecorder(options) {
+    return new EmitBridge({
+        id: options.id ?? 'agentfootprint.permission-recorder',
+        prefix: 'agentfootprint.permission.',
+        dispatcher: options.dispatcher,
+        getRunContext: options.getRunContext,
+    });
+}
+//# sourceMappingURL=PermissionRecorder.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PermissionRecorder.js","sourceRoot":"","sources":["../../../../src/recorders/core/PermissionRecorder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,UAAU,EAA0B,MAAM,iBAAiB,CAAC;AAMrE,MAAM,UAAU,kBAAkB,CAAC,OAAkC;IACnE,OAAO,IAAI,UAAU,CAAC;QACpB,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,oCAAoC;QACtD,MAAM,EAAE,4BAA4B;QACpC,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,aAAa,EAAE,OAAO,CAAC,aAAa;KACrC,CAAC,CAAC;AACL,CAAC"}

package/dist/esm/recorders/core/SkillRecorder.js

@@ -0,0 +1,19 @@
+/**
+ * SkillRecorder — forwards `agentfootprint.skill.*` emits to the dispatcher.
+ *
+ * Pattern: Factory over EmitBridge.
+ * Role:    Bridges skill lifecycle events (activated, deactivated) emitted
+ *          by consumer skill-management code. Skills are a consumer-owned
+ *          context-engineering concern; the library only provides transport.
+ * Emits:   agentfootprint.skill.activated / skill.deactivated
+ */
+import { EmitBridge } from './EmitBridge.js';
+export function skillRecorder(options) {
+    return new EmitBridge({
+        id: options.id ?? 'agentfootprint.skill-recorder',
+        prefix: 'agentfootprint.skill.',
+        dispatcher: options.dispatcher,
+        getRunContext: options.getRunContext,
+    });
+}
+//# sourceMappingURL=SkillRecorder.js.map

package/dist/esm/recorders/core/SkillRecorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkillRecorder.js","sourceRoot":"","sources":["../../../../src/recorders/core/SkillRecorder.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAA0B,MAAM,iBAAiB,CAAC;AAMrE,MAAM,UAAU,aAAa,CAAC,OAA6B;IACzD,OAAO,IAAI,UAAU,CAAC;QACpB,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,+BAA+B;QACjD,MAAM,EAAE,uBAAuB;QAC/B,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,aAAa,EAAE,OAAO,CAAC,aAAa;KACrC,CAAC,CAAC;AACL,CAAC"}