agentfootprint 1.22.0 → 2.0.1

package/dist/patterns/Swarm.js

@@ -0,0 +1,92 @@
+"use strict";
+/**
+ * Swarm — multi-agent handoff. At each step, an LLM-driven routing
+ * decision picks which agent handles the next turn.
+ *
+ * Origin: OpenAI Swarm experiment (2024). Useful for specialist
+ *         routing — each agent has a narrow role + its own tools.
+ *
+ * Pattern: Factory → produces a `Runner` built from
+ *          `Loop(Conditional(route-to-agent))`.
+ * Role:    patterns/ layer. Pure composition over existing primitives.
+ *          Agent roster is FIXED at build time; the routing decision
+ *          is made at runtime by a consumer-supplied `route(input)`
+ *          function (sync — pure over `{ message }`).
+ *
+ * For LLM-driven routing (the classic Swarm style), the consumer
+ * composes a "router" LLMCall as the first step of each iteration and
+ * parses its response in their `route()` function.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.swarm = void 0;
+const footprintjs_1 = require("footprintjs");
+const RunnerBase_js_1 = require("../core/RunnerBase.js");
+const Conditional_js_1 = require("../core-flow/Conditional.js");
+const Loop_js_1 = require("../core-flow/Loop.js");
+/**
+ * Build a Swarm Runner. Each iteration:
+ *   1. Router evaluates `route(input)` to pick an agent id.
+ *   2. Conditional dispatches to that agent's runner.
+ *   3. Agent's output becomes the next iteration's input.
+ * Loop halts when `route` returns a halt-sentinel id (or unknown id
+ * falling to the `done` branch) OR when `maxHandoffs` is reached.
+ */
+function swarm(opts) {
+    if (opts.agents.length < 2) {
+        throw new Error('Swarm: must have >= 2 agents (use Agent for 1)');
+    }
+    const routeFn = opts.route;
+    const ids = new Set(opts.agents.map((a) => a.id));
+    if (ids.has('done')) {
+        throw new Error('Swarm: agent id "done" is reserved for the halt branch — rename to avoid collision');
+    }
+    const maxHandoffs = opts.maxHandoffs ?? 10;
+    // Build the routing conditional. One `.when(id, ...)` per agent; the
+    // routing function's return-value drives branch selection.
+    let conditional = Conditional_js_1.Conditional.create({ id: 'route' });
+    for (const agent of opts.agents) {
+        conditional = conditional.when(agent.id, (input) => routeFn(input) === agent.id, agent.runner, agent.name ?? agent.id);
+    }
+    const routing = conditional.otherwise('done', new IdentityRunner()).build();
+    // Wrap in Loop so handoffs iterate. Exit guard: when `route` returns
+    // a halt sentinel, the next `Conditional.when` evaluation fires the
+    // `done` fallback; the body returns the identity output. To stop the
+    // loop at that point we use the `until` guard inspecting whether the
+    // current message was produced by the identity path — heuristically,
+    // we halt when `route(latestOutput)` returns undefined or 'done'.
+    return Loop_js_1.Loop.create({
+        id: opts.id ?? 'swarm',
+        name: opts.name ?? 'Swarm',
+    })
+        .repeat(routing)
+        .times(maxHandoffs)
+        .until(({ latestOutput }) => {
+        const next = routeFn({ message: latestOutput });
+        return next === undefined || next === 'done' || !ids.has(next);
+    })
+        .build();
+}
+exports.swarm = swarm;
+/**
+ * Identity runner — echoes its input message unchanged. Used as the
+ * Swarm's `otherwise` fallback so the loop can exit cleanly when the
+ * router returns a halt sentinel. Not exported (internal-only).
+ */
+class IdentityRunner extends RunnerBase_js_1.RunnerBase {
+    id = 'done';
+    name = 'Done';
+    toFlowChart() {
+        return (0, footprintjs_1.flowChart)('Done', (scope) => {
+            scope.echoedMessage = scope.$getArgs().message;
+        }, 'done-seed')
+            .addFunction('Return', (scope) => scope.echoedMessage, 'done-return')
+            .build();
+    }
+    async run(input) {
+        return input.message;
+    }
+    async resume() {
+        throw new Error('Swarm IdentityRunner does not support pause/resume');
+    }
+}
+//# sourceMappingURL=Swarm.js.map

package/dist/patterns/Swarm.js.map

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

package/dist/patterns/ToT.js

@@ -0,0 +1,102 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tot = void 0;
+const LLMCall_js_1 = require("../core/LLMCall.js");
+const Loop_js_1 = require("../core-flow/Loop.js");
+const Parallel_js_1 = require("../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.
+ */
+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_js_1.Parallel.create({ id: 'thoughts' });
+    for (let i = 0; i < opts.branchingFactor; i++) {
+        const thoughtLLM = LLMCall_js_1.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_js_1.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');
+}
+exports.tot = 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/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/patterns/index.js

@@ -1,25 +1,32 @@
 "use strict";
 /**
- * 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.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.reflexion = exports.treeOfThoughts = exports.mapReduce = exports.planExecute = void 0;
-var planExecute_1 = require("./planExecute");
-Object.defineProperty(exports, "planExecute", { enumerable: true, get: function () { return planExecute_1.planExecute; } });
-var mapReduce_1 = require("./mapReduce");
-Object.defineProperty(exports, "mapReduce", { enumerable: true, get: function () { return mapReduce_1.mapReduce; } });
-var treeOfThoughts_1 = require("./treeOfThoughts");
-Object.defineProperty(exports, "treeOfThoughts", { enumerable: true, get: function () { return treeOfThoughts_1.treeOfThoughts; } });
-var reflexion_1 = require("./reflexion");
-Object.defineProperty(exports, "reflexion", { enumerable: true, get: function () { return reflexion_1.reflexion; } });
+exports.swarm = exports.tot = exports.mapReduce = exports.debate = exports.reflection = exports.selfConsistency = void 0;
+var SelfConsistency_js_1 = require("./SelfConsistency.js");
+Object.defineProperty(exports, "selfConsistency", { enumerable: true, get: function () { return SelfConsistency_js_1.selfConsistency; } });
+var Reflection_js_1 = require("./Reflection.js");
+Object.defineProperty(exports, "reflection", { enumerable: true, get: function () { return Reflection_js_1.reflection; } });
+var Debate_js_1 = require("./Debate.js");
+Object.defineProperty(exports, "debate", { enumerable: true, get: function () { return Debate_js_1.debate; } });
+var MapReduce_js_1 = require("./MapReduce.js");
+Object.defineProperty(exports, "mapReduce", { enumerable: true, get: function () { return MapReduce_js_1.mapReduce; } });
+var ToT_js_1 = require("./ToT.js");
+Object.defineProperty(exports, "tot", { enumerable: true, get: function () { return ToT_js_1.tot; } });
+var Swarm_js_1 = require("./Swarm.js");
+Object.defineProperty(exports, "swarm", { enumerable: true, get: function () { return Swarm_js_1.swarm; } });
 //# sourceMappingURL=index.js.map

package/dist/patterns/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/patterns/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;AAEH,6CAA4C;AAAnC,0GAAA,WAAW,OAAA;AAGpB,yCAAwC;AAA/B,sGAAA,SAAS,OAAA;AAGlB,mDAAkD;AAAzC,gHAAA,cAAc,OAAA;AAGvB,yCAAwC;AAA/B,sGAAA,SAAS,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/patterns/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG;;;AAEH,2DAAoF;AAA3E,qHAAA,eAAe,OAAA;AACxB,iDAAqE;AAA5D,2GAAA,UAAU,OAAA;AACnB,yCAAyD;AAAhD,mGAAA,MAAM,OAAA;AACf,+CAAkE;AAAzD,yGAAA,SAAS,OAAA;AAClB,mCAAgD;AAAvC,6FAAA,GAAG,OAAA;AACZ,uCAAuE;AAA9D,iGAAA,KAAK,OAAA"}

package/dist/providers.js

@@ -0,0 +1,44 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createProvider = exports.BrowserOpenAIProvider = exports.browserOpenai = exports.BrowserAnthropicProvider = exports.browserAnthropic = exports.BedrockProvider = exports.bedrock = exports.ollama = exports.OpenAIProvider = exports.openai = exports.AnthropicProvider = exports.anthropic = exports.mock = exports.MockProvider = void 0;
+var MockProvider_js_1 = require("./adapters/llm/MockProvider.js");
+Object.defineProperty(exports, "MockProvider", { enumerable: true, get: function () { return MockProvider_js_1.MockProvider; } });
+Object.defineProperty(exports, "mock", { enumerable: true, get: function () { return MockProvider_js_1.mock; } });
+var AnthropicProvider_js_1 = require("./adapters/llm/AnthropicProvider.js");
+Object.defineProperty(exports, "anthropic", { enumerable: true, get: function () { return AnthropicProvider_js_1.anthropic; } });
+Object.defineProperty(exports, "AnthropicProvider", { enumerable: true, get: function () { return AnthropicProvider_js_1.AnthropicProvider; } });
+var OpenAIProvider_js_1 = require("./adapters/llm/OpenAIProvider.js");
+Object.defineProperty(exports, "openai", { enumerable: true, get: function () { return OpenAIProvider_js_1.openai; } });
+Object.defineProperty(exports, "OpenAIProvider", { enumerable: true, get: function () { return OpenAIProvider_js_1.OpenAIProvider; } });
+Object.defineProperty(exports, "ollama", { enumerable: true, get: function () { return OpenAIProvider_js_1.ollama; } });
+var BedrockProvider_js_1 = require("./adapters/llm/BedrockProvider.js");
+Object.defineProperty(exports, "bedrock", { enumerable: true, get: function () { return BedrockProvider_js_1.bedrock; } });
+Object.defineProperty(exports, "BedrockProvider", { enumerable: true, get: function () { return BedrockProvider_js_1.BedrockProvider; } });
+var BrowserAnthropicProvider_js_1 = require("./adapters/llm/BrowserAnthropicProvider.js");
+Object.defineProperty(exports, "browserAnthropic", { enumerable: true, get: function () { return BrowserAnthropicProvider_js_1.browserAnthropic; } });
+Object.defineProperty(exports, "BrowserAnthropicProvider", { enumerable: true, get: function () { return BrowserAnthropicProvider_js_1.BrowserAnthropicProvider; } });
+var BrowserOpenAIProvider_js_1 = require("./adapters/llm/BrowserOpenAIProvider.js");
+Object.defineProperty(exports, "browserOpenai", { enumerable: true, get: function () { return BrowserOpenAIProvider_js_1.browserOpenai; } });
+Object.defineProperty(exports, "BrowserOpenAIProvider", { enumerable: true, get: function () { return BrowserOpenAIProvider_js_1.BrowserOpenAIProvider; } });
+var createProvider_js_1 = require("./adapters/llm/createProvider.js");
+Object.defineProperty(exports, "createProvider", { enumerable: true, get: function () { return createProvider_js_1.createProvider; } });
+//# sourceMappingURL=providers.js.map

package/dist/providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.js","sourceRoot":"","sources":["../src/providers.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;GAkBG;;;AAEH,kEAKwC;AAJtC,+GAAA,YAAY,OAAA;AACZ,uGAAA,IAAI,OAAA;AAKN,4EAI6C;AAH3C,iHAAA,SAAS,OAAA;AACT,yHAAA,iBAAiB,OAAA;AAInB,sEAK0C;AAJxC,2GAAA,MAAM,OAAA;AACN,mHAAA,cAAc,OAAA;AACd,2GAAA,MAAM,OAAA;AAIR,wEAI2C;AAHzC,6GAAA,OAAO,OAAA;AACP,qHAAA,eAAe,OAAA;AAIjB,0FAIoD;AAHlD,+HAAA,gBAAgB,OAAA;AAChB,uIAAA,wBAAwB,OAAA;AAI1B,oFAIiD;AAH/C,yHAAA,aAAa,OAAA;AACb,iIAAA,qBAAqB,OAAA;AAIvB,sEAI0C;AAHxC,mHAAA,cAAc,OAAA"}

package/dist/recorders/core/AgentRecorder.js

@@ -0,0 +1,24 @@
+"use strict";
+/**
+ * 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.agentRecorder = void 0;
+const EmitBridge_js_1 = require("./EmitBridge.js");
+function agentRecorder(options) {
+    return new EmitBridge_js_1.EmitBridge({
+        id: options.id ?? 'agentfootprint.agent-recorder',
+        prefix: 'agentfootprint.agent.',
+        dispatcher: options.dispatcher,
+        getRunContext: options.getRunContext,
+    });
+}
+exports.agentRecorder = agentRecorder;
+//# sourceMappingURL=AgentRecorder.js.map

package/dist/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,mDAAqE;AAMrE,SAAgB,aAAa,CAAC,OAA6B;IACzD,OAAO,IAAI,0BAAU,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;AAPD,sCAOC"}

package/dist/recorders/core/CompositionRecorder.js

@@ -0,0 +1,26 @@
+"use strict";
+/**
+ * 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.*
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compositionRecorder = void 0;
+const EmitBridge_js_1 = require("./EmitBridge.js");
+function compositionRecorder(options) {
+    return new EmitBridge_js_1.EmitBridge({
+        id: options.id ?? 'agentfootprint.composition-recorder',
+        prefix: 'agentfootprint.composition.',
+        dispatcher: options.dispatcher,
+        getRunContext: options.getRunContext,
+    });
+}
+exports.compositionRecorder = compositionRecorder;
+//# sourceMappingURL=CompositionRecorder.js.map

package/dist/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,mDAAqE;AAMrE,SAAgB,mBAAmB,CAAC,OAAmC;IACrE,OAAO,IAAI,0BAAU,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;AAPD,kDAOC"}

package/dist/recorders/core/ContextRecorder.js

@@ -0,0 +1,222 @@
+"use strict";
+/**
+ * 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContextRecorder = void 0;
+const conventions_js_1 = require("../../conventions.js");
+const eventMeta_js_1 = require("../../bridge/eventMeta.js");
+const types_js_1 = require("./types.js");
+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 ? (0, conventions_js_1.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 = (0, conventions_js_1.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 === conventions_js_1.INJECTION_KEYS.SYSTEM_PROMPT && activeSlot === 'system-prompt') {
+            this.handleInjectionsWrite(activeSlot, event);
+            return;
+        }
+        if (key === conventions_js_1.INJECTION_KEYS.MESSAGES && activeSlot === 'messages') {
+            this.handleInjectionsWrite(activeSlot, event);
+            return;
+        }
+        if (key === conventions_js_1.INJECTION_KEYS.TOOLS && activeSlot === 'tools') {
+            this.handleInjectionsWrite(activeSlot, event);
+            return;
+        }
+        // Composition summary — ONE record per slot exit, written just before exit.
+        if (key === types_js_1.COMPOSITION_KEYS.SLOT_COMPOSED) {
+            this.handleSlotComposedWrite(event);
+            return;
+        }
+        // Evictions — per-piece removals under budget pressure.
+        if (key === types_js_1.COMPOSITION_KEYS.EVICTED) {
+            this.handleEvictionsWrite(event);
+            return;
+        }
+        // Budget-pressure warnings — fired BEFORE evictions.
+        if (key === types_js_1.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 = (0, eventMeta_js_1.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;
+    }
+}
+exports.ContextRecorder = ContextRecorder;
+//# sourceMappingURL=ContextRecorder.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ContextRecorder.js","sourceRoot":"","sources":["../../../src/recorders/core/ContextRecorder.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;;AAMH,yDAAyE;AACzE,4DAA4E;AAO5E,yCAA8C;AAa9C,MAAa,eAAe;IACjB,EAAE,CAAS;IACH,UAAU,CAAkB;IAC5B,aAAa,CAAmB;IAEjD,sEAAsE;IACtE,8DAA8D;IAC7C,SAAS,GAAkB,EAAE,CAAC;IAC/C,wEAAwE;IACxE,sEAAsE;IACtE,sEAAsE;IACrD,cAAc,GAAG,IAAI,GAAG,EAAuB,CAAC;IAEjE,YAAY,OAA+B;QACzC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,EAAE,IAAI,iCAAiC,CAAC;QAC1D,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAC7C,CAAC;IAED,kEAAkE;IAElE,cAAc,CAAC,KAAuB;QACpC,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,IAAA,kCAAiB,EAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC9E,IAAI,CAAC,IAAI;YAAE,OAAO;QAClB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,oDAAoD;QACpD,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,aAAa,CAAC,KAAuB;QACnC,IAAI,CAAC,KAAK,CAAC,SAAS;YAAE,OAAO;QAC7B,MAAM,IAAI,GAAG,IAAA,kCAAiB,EAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI;YAAE,OAAO;QAClB,uEAAuE;QACvE,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACvD,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC;QACvB,CAAC;QACD,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IAED,oEAAoE;IAEpE,OAAO,CAAC,KAAiB;QACvB,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QACtC,IAAI,CAAC,UAAU;YAAE,OAAO;QAExB,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;QAEtB,2EAA2E;QAC3E,IAAI,GAAG,KAAK,+BAAc,CAAC,aAAa,IAAI,UAAU,KAAK,eAAe,EAAE,CAAC;YAC3E,IAAI,CAAC,qBAAqB,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;YAC9C,OAAO;QACT,CAAC;QACD,IAAI,GAAG,KAAK,+BAAc,CAAC,QAAQ,IAAI,UAAU,KAAK,UAAU,EAAE,CAAC;YACjE,IAAI,CAAC,qBAAqB,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;YAC9C,OAAO;QACT,CAAC;QACD,IAAI,GAAG,KAAK,+BAAc,CAAC,KAAK,IAAI,UAAU,KAAK,OAAO,EAAE,CAAC;YAC3D,IAAI,CAAC,qBAAqB,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;YAC9C,OAAO;QACT,CAAC;QAED,4EAA4E;QAC5E,IAAI,GAAG,KAAK,2BAAgB,CAAC,aAAa,EAAE,CAAC;YAC3C,IAAI,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAC;YACpC,OAAO;QACT,CAAC;QAED,wDAAwD;QACxD,IAAI,GAAG,KAAK,2BAAgB,CAAC,OAAO,EAAE,CAAC;YACrC,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;YACjC,OAAO;QACT,CAAC;QAED,qDAAqD;QACrD,IAAI,GAAG,KAAK,2BAAgB,CAAC,eAAe,EAAE,CAAC;YAC7C,IAAI,CAAC,yBAAyB,CAAC,KAAK,CAAC,CAAC;YACtC,OAAO;QACT,CAAC;IACH,CAAC;IAED,kEAAkE;IAE1D,WAAW;QACjB,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACnD,CAAC;IAEO,qBAAqB,CAAC,IAAiB,EAAE,KAAiB;QAChE,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACnD,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,EAAU,CAAC;QAChE,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;YAC1B,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC;gBAAE,SAAS;YACxC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;YAC1B,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAChC,CAAC;QACD,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;IAEO,uBAAuB,CAAC,KAAiB;QAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAChD,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,IAAI,CAAC,QAAQ,CAAC,sCAAsC,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;IACpE,CAAC;IAEO,oBAAoB,CAAC,KAAiB;QAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAClD,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;YAC1B,IAAI,CAAC,QAAQ,CAAC,gCAAgC,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IAEO,yBAAyB,CAAC,KAAiB;QACjD,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAClD,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;YAC1B,IAAI,CAAC,QAAQ,CAAC,wCAAwC,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;IAEO,YAAY,CAAC,GAAoB,EAAE,KAAiB;QAC1D,yEAAyE;QACzE,qEAAqE;QACrE,yBAAyB;QACzB,EAAE;QACF,uEAAuE;QACvE,kEAAkE;QAClE,sEAAsE;QACtE,gEAAgE;QAChE,kCAAkC;QAClC,IAAI,CAAC,QAAQ,CAAC,iCAAiC,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;IAC/D,CAAC;IAEO,QAAQ,CACd,IAAO,EACP,OAA6C,EAC7C,MAAqC;QAErC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,IAAI,CAAC;YAAE,OAAO;QACnD,iEAAiE;QACjE,oEAAoE;QACpE,wDAAwD;QACxD,MAAM,MAAM,GACV,kBAAkB,IAAI,MAAM,IAAI,MAAM,CAAC,gBAAgB;YACrD,CAAC,CAAC,MAAM,CAAC,gBAAgB;YACzB,CAAC,CAAE,MAAsC,CAAC;QAC9C,MAAM,IAAI,GAAG,IAAA,6BAAc,EAAC,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC;QAC1D,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAA+B,CAAC,CAAC;IACjF,CAAC;IAED,kEAAkE;IAE1D,gBAAgB,CAAC,KAAc;QACrC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QAC5C,kEAAkE;QAClE,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ;gBAAE,OAAO,SAAS,CAAC;YAClD,MAAM,GAAG,GAAG,CAA6B,CAAC;YAC1C,IAAI,OAAO,GAAG,CAAC,WAAW,KAAK,QAAQ;gBAAE,OAAO,SAAS,CAAC;YAC1D,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO,SAAS,CAAC;YACnD,IAAI,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ;gBAAE,OAAO,SAAS,CAAC;QACvD,CAAC;QACD,OAAO,KAAmC,CAAC;IAC7C,CAAC;IAEO,iBAAiB,CAAC,KAAc;QACtC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC;QAC1D,MAAM,GAAG,GAAG,KAAiC,CAAC;QAC9C,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC;QACnD,IAAI,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC;QACxD,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC;QACpE,IAAI,CAAC,GAAG,CAAC,eAAe,IAAI,OAAO,GAAG,CAAC,eAAe,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC;QACtF,IAAI,OAAO,GAAG,CAAC,YAAY,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC;QAC3D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;YAAE,OAAO,SAAS,CAAC;QAC3D,OAAO,KAAwB,CAAC;IAClC,CAAC;IAEO,eAAe,CAAC,KAAc;QACpC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QAC5C,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ;gBAAE,OAAO,SAAS,CAAC;YAClD,MAAM,GAAG,GAAG,CAA4B,CAAC;YACzC,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO,SAAS,CAAC;YACnD,IAAI,OAAO,GAAG,CAAC,WAAW,KAAK,QAAQ;gBAAE,OAAO,SAAS,CAAC;QAC5D,CAAC;QACD,OAAO,KAAkC,CAAC;IAC5C,CAAC;IAEO,eAAe,CAAC,KAAc;QACpC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QAC5C,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ;gBAAE,OAAO,SAAS,CAAC;YAClD,MAAM,GAAG,GAAG,CAAkC,CAAC;YAC/C,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO,SAAS,CAAC;YACnD,IAAI,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ;gBAAE,OAAO,SAAS,CAAC;QAC1D,CAAC;QACD,OAAO,KAAwC,CAAC;IAClD,CAAC;CACF;AAvMD,0CAuMC"}

package/dist/recorders/core/CostRecorder.js

@@ -0,0 +1,23 @@
+"use strict";
+/**
+ * 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.costRecorder = void 0;
+const EmitBridge_js_1 = require("./EmitBridge.js");
+function costRecorder(options) {
+    return new EmitBridge_js_1.EmitBridge({
+        id: options.id ?? 'agentfootprint.cost-recorder',
+        prefix: 'agentfootprint.cost.',
+        dispatcher: options.dispatcher,
+        getRunContext: options.getRunContext,
+    });
+}
+exports.costRecorder = costRecorder;
+//# sourceMappingURL=CostRecorder.js.map

package/dist/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,mDAAqE;AAMrE,SAAgB,YAAY,CAAC,OAA4B;IACvD,OAAO,IAAI,0BAAU,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;AAPD,oCAOC"}