agentfootprint 1.23.0 → 2.0.1

package/dist/memory/pipeline/semantic.js

@@ -24,23 +24,18 @@ exports.semanticPipeline = void 0;
  * `mockEmbedder()` for tests — bring your own for production
  * (OpenAI, Voyage, Cohere, Sentence Transformers, custom).
  *
- * @example
+ * Most consumers reach for `semanticPipeline` indirectly through
+ * `defineMemory({ type: MEMORY_TYPES.SEMANTIC, strategy: { kind:
+ * MEMORY_STRATEGIES.TOP_K, topK, threshold, embedder }, store })`.
+ *
+ * @example Direct usage (low-level — custom flowchart composition):
  * ```ts
- * import { Agent, anthropic } from 'agentfootprint';
- * import {
- *   semanticPipeline,
- *   InMemoryStore,
- *   mockEmbedder,
- * } from 'agentfootprint/memory';
+ * import { semanticPipeline, mockEmbedder, InMemoryStore } from 'agentfootprint/memory';
  *
  * const pipeline = semanticPipeline({
  *   store: new InMemoryStore(),
- *   embedder: mockEmbedder(),  // swap for openaiEmbedder() etc.
+ *   embedder: mockEmbedder(),  // swap for openaiEmbedder() etc. in production
  * });
- *
- * const agent = Agent.create({ provider: anthropic('claude-sonnet-4-5') })
- *   .memoryPipeline(pipeline)
- *   .build();
  * ```
  */
 const footprintjs_1 = require("footprintjs");
@@ -51,7 +46,7 @@ const loadRelevant_1 = require("../embedding/loadRelevant");
 const embedMessages_1 = require("../embedding/embedMessages");
 /**
  * Build the semantic read + write pipelines sharing a single store.
- * Returns `{ read, write }` ready to pass to `.memoryPipeline()`.
+ * Returns `{ read, write }` ready to pass to `Agent.memory()` via the appropriate `defineMemory` config (or used directly via `mountMemoryRead`/`mountMemoryWrite`).
  */
 function semanticPipeline(config) {
     if (!config.store.search) {

package/dist/memory/pipeline/semantic.js.map

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

package/dist/memory/stages/formatDefault.js

@@ -18,25 +18,7 @@ function defaultRenderEntry(entry) {
     const msg = entry.value;
     const turnAttr = entry.source?.turn !== undefined ? ` turn="${entry.source.turn}"` : '';
     const updatedAttr = entry.updatedAt !== undefined ? ` updated="${new Date(entry.updatedAt).toISOString()}"` : '';
-    // Content extraction — handle both string and content-block variants.
-    let text;
-    if (typeof msg.content === 'string') {
-        text = msg.content;
-    }
-    else if (Array.isArray(msg.content)) {
-        const parts = [];
-        for (const block of msg.content) {
-            if (typeof block === 'object' && block !== null) {
-                const b = block;
-                if (b.type === 'text' && typeof b.text === 'string')
-                    parts.push(b.text);
-            }
-        }
-        text = parts.join(' ');
-    }
-    else {
-        text = '';
-    }
+    const text = msg.content ?? '';
     const role = msg.role ?? 'unknown';
     return `<memory role="${role}"${turnAttr}${updatedAttr}>\n${escapeMemoryTag(text)}\n</memory>`;
 }

package/dist/memory/stages/formatDefault.js.map

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

package/dist/memory/stages/tokenize.js

@@ -44,27 +44,7 @@ exports.approximateTokenCounter = approximateTokenCounter;
  * reflect their structural cost.
  */
 function countMessageTokens(message, counter = exports.approximateTokenCounter) {
-    if (typeof message.content === 'string') {
-        return counter(message.content);
-    }
-    if (Array.isArray(message.content)) {
-        let total = 0;
-        for (const block of message.content) {
-            if (typeof block === 'object' && block !== null) {
-                const b = block;
-                if (b.type === 'text' && typeof b.text === 'string') {
-                    total += counter(b.text);
-                }
-                else {
-                    // Tool calls, images, etc. Conservative fixed cost so budget
-                    // stays bounded even when block shapes are unknown.
-                    total += 10;
-                }
-            }
-        }
-        return total;
-    }
-    return 0;
+    return counter(message.content ?? '');
 }
 exports.countMessageTokens = countMessageTokens;
 //# sourceMappingURL=tokenize.js.map

package/dist/memory/stages/tokenize.js.map

@@ -1 +1 @@
-{"version":3,"file":"tokenize.js","sourceRoot":"","sources":["../../../src/memory/stages/tokenize.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;GAmBG;;;AAOH;;;;;;;;;;;GAWG;AACI,MAAM,uBAAuB,GAAiB,CAAC,IAAY,EAAU,EAAE;IAC5E,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACpC,CAAC,CAAC;AAFW,QAAA,uBAAuB,2BAElC;AAEF;;;;;GAKG;AACH,SAAgB,kBAAkB,CAChC,OAAgB,EAChB,UAAwB,+BAAuB;IAE/C,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACnC,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBAChD,MAAM,CAAC,GAAG,KAAyC,CAAC;gBACpD,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBACpD,KAAK,IAAI,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBAC3B,CAAC;qBAAM,CAAC;oBACN,6DAA6D;oBAC7D,oDAAoD;oBACpD,KAAK,IAAI,EAAE,CAAC;gBACd,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAxBD,gDAwBC"}
+{"version":3,"file":"tokenize.js","sourceRoot":"","sources":["../../../src/memory/stages/tokenize.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;GAmBG;;;AAOH;;;;;;;;;;;GAWG;AACI,MAAM,uBAAuB,GAAiB,CAAC,IAAY,EAAU,EAAE;IAC5E,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACpC,CAAC,CAAC;AAFW,QAAA,uBAAuB,2BAElC;AAEF;;;;;GAKG;AACH,SAAgB,kBAAkB,CAChC,OAAgB,EAChB,UAAwB,+BAAuB;IAE/C,OAAO,OAAO,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;AACxC,CAAC;AALD,gDAKC"}

package/dist/observe.js

@@ -0,0 +1,71 @@
+"use strict";
+/**
+ * agentfootprint/observe — observability recorders.
+ *
+ * Pattern: Observer (GoF) — pluggable, fire-and-forget event listeners
+ *          for the agent's typed event stream.
+ * Role:    Outer ring (Hexagonal). Attach via `runner.attachRecorder()`;
+ *          the runner emits events, recorders accumulate state.
+ *
+ * Three tiers (progressive disclosure):
+ *
+ *   Tier 1 — context + stream                                (the core)
+ *     • ContextRecorder      — every slot composition
+ *     • StreamRecorder       — token-level LLM streaming
+ *
+ *   Tier 2 — composition + agent                       (structural nav)
+ *     • CompositionRecorder  — Sequence/Parallel/Conditional/Loop entries
+ *     • AgentRecorder        — agent-loop iterations, tool calls
+ *     • BoundaryRecorder     — domain-tagged subflow entry/exit
+ *     • FlowchartRecorder    — StepGraph projection (Lens-friendly)
+ *
+ *   Tier 3 — domain dashboards                              (attach on demand)
+ *     • CostRecorder         — token/USD spend
+ *     • EvalRecorder         — eval scores from `runner.emit('eval.*', ...)`
+ *     • MemoryRecorder       — memory injections + writes
+ *     • PermissionRecorder   — permission decisions + denials
+ *     • SkillRecorder        — skill activations
+ *     • LoggingRecorder      — structured log lines per event
+ *     • ThinkingRecorder     — chat-bubble first-person status
+ *
+ * Domain-flavored consumers (Lens, Grafana, Datadog) compose Tier 1+2
+ * directly; Tier 3 dashboards are opt-in.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.typedEmit = exports.attachThinking = exports.LoggingDomains = exports.attachLogging = exports.skillRecorder = exports.permissionRecorder = exports.memoryRecorder = exports.evalRecorder = exports.costRecorder = exports.buildStepGraph = exports.attachFlowchart = exports.BoundaryRecorder = exports.boundaryRecorder = exports.agentRecorder = exports.compositionRecorder = exports.streamRecorder = exports.ContextRecorder = void 0;
+// Tier 1 — context + stream
+var ContextRecorder_js_1 = require("./recorders/core/ContextRecorder.js");
+Object.defineProperty(exports, "ContextRecorder", { enumerable: true, get: function () { return ContextRecorder_js_1.ContextRecorder; } });
+var StreamRecorder_js_1 = require("./recorders/core/StreamRecorder.js");
+Object.defineProperty(exports, "streamRecorder", { enumerable: true, get: function () { return StreamRecorder_js_1.streamRecorder; } });
+// Tier 2 — composition + agent
+var CompositionRecorder_js_1 = require("./recorders/core/CompositionRecorder.js");
+Object.defineProperty(exports, "compositionRecorder", { enumerable: true, get: function () { return CompositionRecorder_js_1.compositionRecorder; } });
+var AgentRecorder_js_1 = require("./recorders/core/AgentRecorder.js");
+Object.defineProperty(exports, "agentRecorder", { enumerable: true, get: function () { return AgentRecorder_js_1.agentRecorder; } });
+var BoundaryRecorder_js_1 = require("./recorders/observability/BoundaryRecorder.js");
+Object.defineProperty(exports, "boundaryRecorder", { enumerable: true, get: function () { return BoundaryRecorder_js_1.boundaryRecorder; } });
+Object.defineProperty(exports, "BoundaryRecorder", { enumerable: true, get: function () { return BoundaryRecorder_js_1.BoundaryRecorder; } });
+var FlowchartRecorder_js_1 = require("./recorders/observability/FlowchartRecorder.js");
+Object.defineProperty(exports, "attachFlowchart", { enumerable: true, get: function () { return FlowchartRecorder_js_1.attachFlowchart; } });
+Object.defineProperty(exports, "buildStepGraph", { enumerable: true, get: function () { return FlowchartRecorder_js_1.buildStepGraph; } });
+// Tier 3 — domain dashboards
+var CostRecorder_js_1 = require("./recorders/core/CostRecorder.js");
+Object.defineProperty(exports, "costRecorder", { enumerable: true, get: function () { return CostRecorder_js_1.costRecorder; } });
+var EvalRecorder_js_1 = require("./recorders/core/EvalRecorder.js");
+Object.defineProperty(exports, "evalRecorder", { enumerable: true, get: function () { return EvalRecorder_js_1.evalRecorder; } });
+var MemoryRecorder_js_1 = require("./recorders/core/MemoryRecorder.js");
+Object.defineProperty(exports, "memoryRecorder", { enumerable: true, get: function () { return MemoryRecorder_js_1.memoryRecorder; } });
+var PermissionRecorder_js_1 = require("./recorders/core/PermissionRecorder.js");
+Object.defineProperty(exports, "permissionRecorder", { enumerable: true, get: function () { return PermissionRecorder_js_1.permissionRecorder; } });
+var SkillRecorder_js_1 = require("./recorders/core/SkillRecorder.js");
+Object.defineProperty(exports, "skillRecorder", { enumerable: true, get: function () { return SkillRecorder_js_1.skillRecorder; } });
+var LoggingRecorder_js_1 = require("./recorders/observability/LoggingRecorder.js");
+Object.defineProperty(exports, "attachLogging", { enumerable: true, get: function () { return LoggingRecorder_js_1.attachLogging; } });
+Object.defineProperty(exports, "LoggingDomains", { enumerable: true, get: function () { return LoggingRecorder_js_1.LoggingDomains; } });
+var ThinkingRecorder_js_1 = require("./recorders/observability/ThinkingRecorder.js");
+Object.defineProperty(exports, "attachThinking", { enumerable: true, get: function () { return ThinkingRecorder_js_1.attachThinking; } });
+// Emit primitive — used by every Tier-3 source-domain.
+var typedEmit_js_1 = require("./recorders/core/typedEmit.js");
+Object.defineProperty(exports, "typedEmit", { enumerable: true, get: function () { return typedEmit_js_1.typedEmit; } });
+//# sourceMappingURL=observe.js.map

package/dist/observe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observe.js","sourceRoot":"","sources":["../src/observe.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;;;AAEH,4BAA4B;AAC5B,0EAAmG;AAA1F,qHAAA,eAAe,OAAA;AACxB,wEAAgG;AAAvF,mHAAA,cAAc,OAAA;AAEvB,+BAA+B;AAC/B,kFAGiD;AAF/C,6HAAA,mBAAmB,OAAA;AAGrB,sEAA6F;AAApF,iHAAA,aAAa,OAAA;AACtB,qFAUuD;AATrD,uHAAA,gBAAgB,OAAA;AAChB,uHAAA,gBAAgB,OAAA;AASlB,uFAUwD;AATtD,uHAAA,eAAe,OAAA;AACf,sHAAA,cAAc,OAAA;AAUhB,6BAA6B;AAC7B,oEAA0F;AAAjF,+GAAA,YAAY,OAAA;AACrB,oEAA0F;AAAjF,+GAAA,YAAY,OAAA;AACrB,wEAAgG;AAAvF,mHAAA,cAAc,OAAA;AACvB,gFAGgD;AAF9C,2HAAA,kBAAkB,OAAA;AAGpB,sEAA6F;AAApF,iHAAA,aAAa,OAAA;AACtB,mFAMsD;AALpD,mHAAA,aAAa,OAAA;AACb,oHAAA,cAAc,OAAA;AAKhB,qFAIuD;AAHrD,qHAAA,cAAc,OAAA;AAKhB,uDAAuD;AACvD,8DAA0D;AAAjD,yGAAA,SAAS,OAAA"}

package/dist/patterns/Debate.js

@@ -0,0 +1,65 @@
+"use strict";
+/**
+ * Debate — two agents alternate proposing + critiquing, a judge decides.
+ *
+ * Paper: "Improving Factuality and Reasoning in Language Models through
+ *        Multiagent Debate" — Du et al., 2023
+ *        (https://arxiv.org/abs/2305.14325).
+ *
+ * Pattern: Factory → produces a `Runner` built from
+ *          `Sequence(Proposer → Critic → Judge)` by default, or an
+ *          iterated `Loop(Sequence(…))` when `rounds > 1`.
+ * Role:    patterns/ layer.
+ * Emits:   Everything Sequence + Loop + LLMCall emit.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.debate = void 0;
+const LLMCall_js_1 = require("../core/LLMCall.js");
+const Loop_js_1 = require("../core-flow/Loop.js");
+const Sequence_js_1 = require("../core-flow/Sequence.js");
+/**
+ * Build a Debate Runner. One debate "round" = Proposer → Critic. After
+ * N rounds, the Judge sees the final exchange and renders the verdict.
+ * The Judge's output is the Runner's return value.
+ */
+function debate(opts) {
+    const rounds = opts.rounds ?? 1;
+    if (rounds < 1) {
+        throw new Error('Debate: rounds must be >= 1');
+    }
+    const makeCall = (systemPrompt) => LLMCall_js_1.LLMCall.create({
+        provider: opts.provider,
+        model: opts.model,
+        ...(opts.temperature !== undefined && { temperature: opts.temperature }),
+        ...(opts.maxTokens !== undefined && { maxTokens: opts.maxTokens }),
+    })
+        .system(systemPrompt)
+        .build();
+    // A debate round: Proposer → pipeVia(transcript-to-critic) → Critic.
+    // The round's output is the critic's response; the next layer (Loop
+    // or the outer Sequence) decides how to frame it for the next
+    // consumer (another round or the Judge).
+    const buildRound = () => Sequence_js_1.Sequence.create({ id: 'debate-round' })
+        .step('proposer', makeCall(opts.proposerPrompt))
+        .pipeVia((proposalMsg) => ({
+        message: `A proposer argued:\n\n${proposalMsg}\n\nCritique this argument.`,
+    }))
+        .step('critic', makeCall(opts.criticPrompt))
+        .build();
+    // A full debate is: N rounds (via Loop) → Judge.
+    const roundsRunner = rounds === 1
+        ? buildRound()
+        : Loop_js_1.Loop.create({ id: 'debate-rounds' }).repeat(buildRound()).times(rounds).build();
+    return Sequence_js_1.Sequence.create({
+        name: opts.name ?? 'Debate',
+        id: opts.id ?? 'debate',
+    })
+        .step('rounds', roundsRunner)
+        .pipeVia((transcript) => ({
+        message: `Full debate transcript:\n\n${transcript}\n\nGive your verdict.`,
+    }))
+        .step('judge', makeCall(opts.judgePrompt))
+        .build();
+}
+exports.debate = debate;
+//# sourceMappingURL=Debate.js.map

package/dist/patterns/Debate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Debate.js","sourceRoot":"","sources":["../../src/patterns/Debate.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;AAGH,mDAA6C;AAE7C,kDAA4C;AAC5C,0DAAoD;AAmBpD;;;;GAIG;AACH,SAAgB,MAAM,CAAC,IAAmB;IACxC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;IAChC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACjD,CAAC;IAED,MAAM,QAAQ,GAAG,CAAC,YAAoB,EAAE,EAAE,CACxC,oBAAO,CAAC,MAAM,CAAC;QACb,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,GAAG,CAAC,IAAI,CAAC,WAAW,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC;QACxE,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;KACnE,CAAC;SACC,MAAM,CAAC,YAAY,CAAC;SACpB,KAAK,EAAE,CAAC;IAEb,qEAAqE;IACrE,oEAAoE;IACpE,8DAA8D;IAC9D,yCAAyC;IACzC,MAAM,UAAU,GAAG,GAAG,EAAE,CACtB,sBAAQ,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,cAAc,EAAE,CAAC;SACpC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;SAC/C,OAAO,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QACzB,OAAO,EAAE,yBAAyB,WAAW,6BAA6B;KAC3E,CAAC,CAAC;SACF,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;SAC3C,KAAK,EAAE,CAAC;IAEb,iDAAiD;IACjD,MAAM,YAAY,GAChB,MAAM,KAAK,CAAC;QACV,CAAC,CAAC,UAAU,EAAE;QACd,CAAC,CAAC,cAAI,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,eAAe,EAAE,CAAC,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC;IAEtF,OAAO,sBAAQ,CAAC,MAAM,CAAC;QACrB,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,QAAQ;QAC3B,EAAE,EAAE,IAAI,CAAC,EAAE,IAAI,QAAQ;KACxB,CAAC;SACC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC;SAC5B,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QACxB,OAAO,EAAE,8BAA8B,UAAU,wBAAwB;KAC1E,CAAC,CAAC;SACF,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;SACzC,KAAK,EAAE,CAAC;AACb,CAAC;AA7CD,wBA6CC"}

package/dist/patterns/MapReduce.js

@@ -0,0 +1,166 @@
+"use strict";
+/**
+ * MapReduce — fan-out N LLMCalls over deterministic input shards, reduce.
+ *
+ * Origin: classic map-reduce (Dean & Ghemawat, 2004) applied to
+ *         LLM context-window constraints. Seen in long-document
+ *         summarization: split → summarize each → combine.
+ *
+ * Pattern: Factory → produces a Runner composing `Parallel` of N
+ *          shard-aware branches. Each branch is an LLMCall wrapped so it
+ *          extracts its shard index from the input by position.
+ * Role:    patterns/ layer. Pure composition over existing primitives.
+ *
+ * Shard count is fixed at build time — consumer supplies `shardCount`
+ * and a `split(input, shardCount)` function that MUST return exactly
+ * `shardCount` strings. The extracted strings are packed into one
+ * `message` at run time (delimiter `\u001F`) so each branch can pick
+ * its own index. For run-time-variable shard counts, factor MapReduce
+ * inside a wrapping Runner that rebuilds the Parallel per call.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapReduce = void 0;
+const footprintjs_1 = require("footprintjs");
+const LLMCall_js_1 = require("../core/LLMCall.js");
+const RunnerBase_js_1 = require("../core/RunnerBase.js");
+const Parallel_js_1 = require("../core-flow/Parallel.js");
+const Sequence_js_1 = require("../core-flow/Sequence.js");
+const SHARD_DELIMITER = '\u001F'; // ASCII Unit Separator — unlikely in real text.
+/**
+ * Build a MapReduce Runner. At run time:
+ *   1. The splitter runs the consumer's `split(input, shardCount)` and
+ *      packs the resulting N shards into a delimited string.
+ *   2. Parallel fans out to N branches. Each branch's wrapper extracts
+ *      its own shard from the packed input and feeds it to the shared
+ *      LLMCall.
+ *   3. The reducer combines the N branch outputs into the final string.
+ */
+function mapReduce(opts) {
+    if (opts.shardCount < 2) {
+        throw new Error('MapReduce: shardCount must be >= 2 (use LLMCall for 1 shard)');
+    }
+    const shardCount = opts.shardCount;
+    // Step 1: split stage — takes the original input, runs split(), packs
+    // the shards into a delimited string. Exposed as a Runner so it can
+    // be the first step of a Sequence.
+    const splitRunner = new ShardSplitRunner(opts.split, shardCount);
+    // Step 2: per-branch wrappers + Parallel. Each branch's wrapper reads
+    // the packed message, splits on the delimiter, picks index i, and
+    // runs the shared LLMCall with just that shard.
+    let par = Parallel_js_1.Parallel.create({
+        id: opts.id ? `${opts.id}-map` : 'mapreduce-map',
+        name: `${opts.name ?? 'MapReduce'}-Map`,
+    });
+    for (let i = 0; i < shardCount; i++) {
+        const branchRunner = new ShardBranchRunner(i, LLMCall_js_1.LLMCall.create({
+            provider: opts.provider,
+            model: opts.model,
+            ...(opts.temperature !== undefined && { temperature: opts.temperature }),
+            ...(opts.maxTokens !== undefined && { maxTokens: opts.maxTokens }),
+        })
+            .system(opts.mapPrompt)
+            .build());
+        par = par.branch(`shard-${i}`, branchRunner);
+    }
+    const mapRunner = opts.reduce.kind === 'fn'
+        ? par.mergeWithFn(opts.reduce.fn).build()
+        : par.mergeWithLLM(opts.reduce.opts).build();
+    // Step 3: full pipeline — Sequence(split → Parallel+reduce).
+    return Sequence_js_1.Sequence.create({
+        id: opts.id ?? 'mapreduce',
+        name: opts.name ?? 'MapReduce',
+    })
+        .step('split', splitRunner)
+        .step('map-reduce', mapRunner)
+        .build();
+}
+exports.mapReduce = mapReduce;
+/**
+ * Runner that runs the consumer's `split()` and returns a packed string.
+ * Implemented as a thin Runner (rather than inline Sequence step) so it
+ * plugs into the existing Sequence.step API.
+ */
+class ShardSplitRunner extends RunnerBase_js_1.RunnerBase {
+    name = 'ShardSplit';
+    id = 'shard-split';
+    splitFn;
+    shardCount;
+    constructor(splitFn, shardCount) {
+        super();
+        this.splitFn = splitFn;
+        this.shardCount = shardCount;
+    }
+    toFlowChart() {
+        const splitFn = this.splitFn;
+        const shardCount = this.shardCount;
+        return (0, footprintjs_1.flowChart)('Split', (scope) => {
+            const args = scope.$getArgs();
+            const shards = splitFn(args.message, shardCount);
+            const normalized = [];
+            for (let i = 0; i < shardCount; i++)
+                normalized.push(shards[i] ?? '');
+            scope.packed = normalized.join(SHARD_DELIMITER);
+        }, 'split')
+            .addFunction('Return', (scope) => scope.packed, 'return')
+            .build();
+    }
+    async run(input) {
+        const executor = new footprintjs_1.FlowChartExecutor(this.toFlowChart());
+        const result = await executor.run({ input: { message: input.message } });
+        if (typeof result === 'string')
+            return result;
+        throw new Error('ShardSplit: unexpected result shape');
+    }
+    async resume() {
+        throw new Error('ShardSplit does not support pause/resume');
+    }
+}
+/**
+ * Runner that extracts shard `i` from the packed message and runs the
+ * wrapped LLMCall with just that shard.
+ */
+class ShardBranchRunner extends RunnerBase_js_1.RunnerBase {
+    name;
+    id;
+    shardIndex;
+    inner;
+    constructor(shardIndex, inner) {
+        super();
+        this.shardIndex = shardIndex;
+        this.inner = inner;
+        this.id = `shard-branch-${shardIndex}`;
+        this.name = `Shard ${shardIndex}`;
+    }
+    toFlowChart() {
+        // Build a wrapper chart that unpacks the shard and invokes the
+        // inner chart. The inner LLMCall's chart runs as a subflow whose
+        // input is the extracted shard.
+        const shardIndex = this.shardIndex;
+        const innerChart = this.inner.toFlowChart();
+        return (0, footprintjs_1.flowChart)('Unpack', (scope) => {
+            const args = scope.$getArgs();
+            const parts = (args.message ?? '').split(SHARD_DELIMITER);
+            scope.shard = parts[shardIndex] ?? '';
+            scope.result = '';
+        }, 'unpack')
+            .addSubFlowChartNext('inner', innerChart, 'InnerCall', {
+            inputMapper: (parent) => ({ message: parent.shard ?? '' }),
+            outputMapper: (sfOutput) => ({
+                result: typeof sfOutput === 'string' ? sfOutput : '',
+            }),
+        })
+            .addFunction('Return', (scope) => scope.result, 'return')
+            .build();
+    }
+    async run(input) {
+        const executor = new footprintjs_1.FlowChartExecutor(this.toFlowChart());
+        const result = await executor.run({ input: { message: input.message } });
+        if (typeof result === 'string')
+            return result;
+        throw new Error('ShardBranch: unexpected result shape');
+    }
+    async resume() {
+        throw new Error('ShardBranch does not support pause/resume');
+    }
+}
+//# sourceMappingURL=MapReduce.js.map

package/dist/patterns/MapReduce.js.map

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

package/dist/patterns/Reflection.js

@@ -0,0 +1,68 @@
+"use strict";
+/**
+ * Reflection — iterative self-refinement via critic + revise.
+ *
+ * Paper: "Self-Refine: Iterative Refinement with Self-Feedback" —
+ *        Madaan et al., 2023 (https://arxiv.org/abs/2303.17651).
+ *
+ * Pattern: Factory (GoF) → produces a `Runner` built from a `Loop`
+ *          whose body is `Sequence(Propose → Critique → Revise)`.
+ * Role:    patterns/ layer. Pure composition — no new abstractions.
+ * Emits:   Loop's composition.iteration_start / iteration_exit plus
+ *          every inner LLMCall's stream.llm_start/end.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reflection = void 0;
+const LLMCall_js_1 = require("../core/LLMCall.js");
+const Loop_js_1 = require("../core-flow/Loop.js");
+const Sequence_js_1 = require("../core-flow/Sequence.js");
+/**
+ * Build a Reflection Runner. Each iteration:
+ *   1. Propose — LLMCall writes a candidate answer based on the input
+ *   2. Critique — LLMCall judges the candidate; exit marker stops loop
+ *   3. Revise — next iteration's propose sees the previous critique
+ *
+ * Each iteration's output (the candidate proposal) becomes the next
+ * iteration's input. The final iteration's proposal is returned.
+ */
+function reflection(opts) {
+    const stopMarker = opts.untilCritiqueContains ?? 'DONE';
+    const maxIterations = opts.maxIterations ?? 3;
+    // Each iteration body: Propose → Critique → Revise. The Sequence's
+    // `current` carries whatever the final step returned.
+    const body = Sequence_js_1.Sequence.create({ id: 'refine-body' })
+        .step('propose', LLMCall_js_1.LLMCall.create({
+        provider: opts.provider,
+        model: opts.model,
+        ...(opts.temperature !== undefined && { temperature: opts.temperature }),
+        ...(opts.maxTokens !== undefined && { maxTokens: opts.maxTokens }),
+    })
+        .system(opts.proposerPrompt)
+        .build())
+        .pipeVia((proposal) => ({
+        message: `Proposal to critique:\n${proposal}\n\nRespond with critique. When the proposal is good enough, include the marker "${stopMarker}".`,
+    }))
+        .step('critique', LLMCall_js_1.LLMCall.create({
+        provider: opts.provider,
+        model: opts.model,
+        ...(opts.temperature !== undefined && { temperature: opts.temperature }),
+        ...(opts.maxTokens !== undefined && { maxTokens: opts.maxTokens }),
+    })
+        .system(opts.criticPrompt)
+        .build())
+        .build();
+    // Loop body returns the critic's output; we wrap it so the next
+    // iteration's input gets the ORIGINAL proposal + critique combined,
+    // asking the revisor to improve. The Loop until-guard inspects the
+    // critic response for the stop marker.
+    return Loop_js_1.Loop.create({
+        name: opts.name ?? 'Reflection',
+        id: opts.id ?? 'reflection',
+    })
+        .repeat(body)
+        .times(maxIterations)
+        .until(({ latestOutput }) => latestOutput.includes(stopMarker))
+        .build();
+}
+exports.reflection = reflection;
+//# sourceMappingURL=Reflection.js.map

package/dist/patterns/Reflection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Reflection.js","sourceRoot":"","sources":["../../src/patterns/Reflection.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;AAGH,mDAA6C;AAE7C,kDAA4C;AAC5C,0DAAoD;AA4BpD;;;;;;;;GAQG;AACH,SAAgB,UAAU,CAAC,IAAuB;IAChD,MAAM,UAAU,GAAG,IAAI,CAAC,qBAAqB,IAAI,MAAM,CAAC;IACxD,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,IAAI,CAAC,CAAC;IAE9C,mEAAmE;IACnE,sDAAsD;IACtD,MAAM,IAAI,GAAG,sBAAQ,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,aAAa,EAAE,CAAC;SAChD,IAAI,CACH,SAAS,EACT,oBAAO,CAAC,MAAM,CAAC;QACb,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,GAAG,CAAC,IAAI,CAAC,WAAW,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC;QACxE,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;KACnE,CAAC;SACC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC;SAC3B,KAAK,EAAE,CACX;SACA,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QACtB,OAAO,EAAE,0BAA0B,QAAQ,oFAAoF,UAAU,IAAI;KAC9I,CAAC,CAAC;SACF,IAAI,CACH,UAAU,EACV,oBAAO,CAAC,MAAM,CAAC;QACb,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,GAAG,CAAC,IAAI,CAAC,WAAW,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC;QACxE,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;KACnE,CAAC;SACC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC;SACzB,KAAK,EAAE,CACX;SACA,KAAK,EAAE,CAAC;IAEX,gEAAgE;IAChE,oEAAoE;IACpE,mEAAmE;IACnE,uCAAuC;IACvC,OAAO,cAAI,CAAC,MAAM,CAAC;QACjB,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,YAAY;QAC/B,EAAE,EAAE,IAAI,CAAC,EAAE,IAAI,YAAY;KAC5B,CAAC;SACC,MAAM,CAAC,IAAI,CAAC;SACZ,KAAK,CAAC,aAAa,CAAC;SACpB,KAAK,CAAC,CAAC,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;SAC9D,KAAK,EAAE,CAAC;AACb,CAAC;AA9CD,gCA8CC"}

package/dist/patterns/SelfConsistency.js

@@ -0,0 +1,75 @@
+"use strict";
+/**
+ * SelfConsistency — sample N answers, pick the majority.
+ *
+ * Paper: "Self-Consistency Improves Chain of Thought Reasoning in
+ * Language Models" — Wang et al., 2022 (https://arxiv.org/abs/2203.11171).
+ *
+ * Pattern: Factory (GoF) → produces a `Runner` that composes `Parallel`
+ *          of N `LLMCall` branches with a majority-vote merge function.
+ * Role:    patterns/ layer. Pure composition of core primitives +
+ *          core-flow compositions — no new abstractions.
+ * Emits:   Everything `Parallel` + `LLMCall` emit (stream / composition /
+ *          context). No pattern-specific event domain needed; consumers
+ *          observe via the standard typed listeners.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.selfConsistency = void 0;
+const LLMCall_js_1 = require("../core/LLMCall.js");
+const Parallel_js_1 = require("../core-flow/Parallel.js");
+/**
+ * Build a SelfConsistency Runner. Given a system prompt, the Runner
+ * runs `samples` parallel LLMCalls with the same input, extracts each
+ * response's vote token, then returns the most-frequent token. Ties
+ * are broken by the first response's extract.
+ */
+function selfConsistency(opts) {
+    if (opts.samples < 1) {
+        throw new Error('SelfConsistency: samples must be >= 1');
+    }
+    if (opts.samples < 2) {
+        throw new Error('SelfConsistency: samples must be >= 2 to have anything to vote on (use LLMCall for 1 sample)');
+    }
+    const extract = opts.extract ?? ((s) => s.trim());
+    let builder = Parallel_js_1.Parallel.create({
+        name: opts.name ?? 'SelfConsistency',
+        id: opts.id ?? 'self-consistency',
+    });
+    for (let i = 0; i < opts.samples; i++) {
+        const branch = LLMCall_js_1.LLMCall.create({
+            provider: opts.provider,
+            model: opts.model,
+            // Higher default temperature for sampling diversity — the whole
+            // point of SelfConsistency is to get DIFFERENT samples.
+            temperature: opts.temperature ?? 0.7,
+            ...(opts.maxTokens !== undefined && { maxTokens: opts.maxTokens }),
+        })
+            .system(opts.systemPrompt)
+            .build();
+        builder = builder.branch(`sample-${i}`, branch);
+    }
+    return builder
+        .mergeWithFn((results) => {
+        const tallies = new Map();
+        const order = [];
+        for (const id of Object.keys(results).sort()) {
+            const vote = extract(results[id]);
+            if (!tallies.has(vote))
+                order.push(vote);
+            tallies.set(vote, (tallies.get(vote) ?? 0) + 1);
+        }
+        let best = order[0];
+        let bestCount = tallies.get(best);
+        for (const vote of order) {
+            const count = tallies.get(vote);
+            if (count > bestCount) {
+                best = vote;
+                bestCount = count;
+            }
+        }
+        return best;
+    })
+        .build();
+}
+exports.selfConsistency = selfConsistency;
+//# sourceMappingURL=SelfConsistency.js.map

package/dist/patterns/SelfConsistency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SelfConsistency.js","sourceRoot":"","sources":["../../src/patterns/SelfConsistency.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;;AAGH,mDAA6C;AAE7C,0DAAoD;AAqBpD;;;;;GAKG;AACH,SAAgB,eAAe,CAAC,IAA4B;IAC1D,IAAI,IAAI,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IACD,IAAI,IAAI,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CACb,8FAA8F,CAC/F,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAE1D,IAAI,OAAO,GAAG,sBAAQ,CAAC,MAAM,CAAC;QAC5B,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,iBAAiB;QACpC,EAAE,EAAE,IAAI,CAAC,EAAE,IAAI,kBAAkB;KAClC,CAAC,CAAC;IAEH,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,oBAAO,CAAC,MAAM,CAAC;YAC5B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,gEAAgE;YAChE,wDAAwD;YACxD,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,GAAG;YACpC,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;SACnE,CAAC;aACC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC;aACzB,KAAK,EAAE,CAAC;QACX,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IAClD,CAAC;IAED,OAAO,OAAO;SACX,WAAW,CAAC,CAAC,OAAO,EAAE,EAAE;QACvB,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;QAC1C,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,MAAM,EAAE,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;YAC7C,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,EAAE,CAAE,CAAC,CAAC;YACnC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACzC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAClD,CAAC;QACD,IAAI,IAAI,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QACrB,IAAI,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC;QACnC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC;YACjC,IAAI,KAAK,GAAG,SAAS,EAAE,CAAC;gBACtB,IAAI,GAAG,IAAI,CAAC;gBACZ,SAAS,GAAG,KAAK,CAAC;YACpB,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;SACD,KAAK,EAAE,CAAC;AACb,CAAC;AApDD,0CAoDC"}