agentfootprint 1.22.0 → 2.0.1

package/dist/memory/causal/loadSnapshot.js

@@ -0,0 +1,116 @@
+"use strict";
+/**
+ * loadSnapshot — read-side stage for Causal memory.
+ *
+ * Embeds the user's current question, searches the store for the most
+ * similar past run, projects the snapshot per `SnapshotProjection`,
+ * and writes the formatted result to `scope.formatted` so the
+ * downstream slot subflow injects it as a system message.
+ *
+ * Reads from scope:   `identity`, `messages` (or `newMessages` fallback)
+ * Writes to scope:    `formatted` — array of `LLMMessage` to inject
+ *
+ * Strict-threshold semantics:
+ *   When `minScore` is set and no past snapshot meets it, returns an
+ *   empty `formatted`. NO fallback — garbage past context is worse than
+ *   no context. Aligns with the LLM-systems panel verdict in the design.
+ *
+ * Empty-query handling:
+ *   No user message → no embedding → no search → empty result.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadSnapshot = void 0;
+const define_types_js_1 = require("../define.types.js");
+function defaultQueryFrom(scope) {
+    const scopeAny = scope;
+    const incoming = scopeAny.messages ?? [];
+    const source = incoming.length > 0 ? incoming : scope.newMessages ?? [];
+    for (let i = source.length - 1; i >= 0; i--) {
+        const m = source[i];
+        if (m.role === 'user' && m.content)
+            return String(m.content);
+    }
+    return '';
+}
+function loadSnapshot(config) {
+    const { store, embedder } = config;
+    if (!store.search) {
+        throw new Error('loadSnapshot: the configured store does not implement search(). ' +
+            'Causal memory requires a vector-capable adapter (InMemoryStore, pgvector, ...).');
+    }
+    const queryFrom = config.queryFrom ?? defaultQueryFrom;
+    const topK = config.topK ?? 1;
+    const projection = config.projection ?? define_types_js_1.SNAPSHOT_PROJECTIONS.DECISIONS;
+    const minScore = config.minScore ?? 0.7;
+    return async (scope) => {
+        const identity = scope.identity;
+        const text = queryFrom(scope).trim();
+        if (text.length === 0) {
+            scope.formatted = [];
+            return;
+        }
+        const signal = scope.$getEnv?.()?.signal;
+        const queryVec = (await embedder.embed({
+            text,
+            ...(signal ? { signal } : {}),
+        }));
+        const results = await store.search(identity, queryVec, {
+            k: topK,
+            minScore,
+            ...(config.embedderId !== undefined && { embedderId: config.embedderId }),
+        });
+        if (results.length === 0) {
+            // Strict threshold: no match → no injection. Garbage > none is wrong.
+            scope.formatted = [];
+            return;
+        }
+        const messages = results.map((r) => formatProjection(r.entry, projection, r.score));
+        scope.formatted = messages;
+    };
+}
+exports.loadSnapshot = loadSnapshot;
+/**
+ * Render one snapshot into a `system` message per the chosen
+ * projection. The shape is intentionally compact so multiple
+ * snapshots fit comfortably in context.
+ */
+function formatProjection(entry, projection, score) {
+    const snap = entry.value;
+    const header = `[Past run · query: "${truncate(snap.query, 80)}" · score: ${score.toFixed(2)}]`;
+    let body;
+    switch (projection) {
+        case define_types_js_1.SNAPSHOT_PROJECTIONS.DECISIONS:
+            body =
+                snap.decisions.length === 0
+                    ? `(no decision evidence captured)\nFinal answer: ${snap.finalContent}`
+                    : snap.decisions
+                        .map((d) => `- ${d.stageId} → "${d.chosen}"${d.rule ? ` (rule: ${d.rule})` : ''}` +
+                        (d.evidence ? `; evidence: ${JSON.stringify(d.evidence)}` : ''))
+                        .join('\n');
+            break;
+        case define_types_js_1.SNAPSHOT_PROJECTIONS.NARRATIVE:
+            body = snap.narrative ?? `(no narrative captured)\nFinal answer: ${snap.finalContent}`;
+            break;
+        case define_types_js_1.SNAPSHOT_PROJECTIONS.COMMITS:
+            // commitLog isn't yet captured in SnapshotEntry; project the
+            // decisions list as a stand-in for now.
+            body =
+                snap.decisions.length === 0
+                    ? `(no commit log captured)\nFinal answer: ${snap.finalContent}`
+                    : snap.decisions.map((d) => `${d.stageId}: chose "${d.chosen}"`).join('\n');
+            break;
+        case define_types_js_1.SNAPSHOT_PROJECTIONS.FULL:
+            body = JSON.stringify(snap, null, 2);
+            break;
+        default:
+            body = `Final answer: ${snap.finalContent}`;
+    }
+    return {
+        role: 'system',
+        content: `${header}\n${body}`,
+    };
+}
+function truncate(s, n) {
+    return s.length > n ? `${s.slice(0, n - 1)}…` : s;
+}
+//# sourceMappingURL=loadSnapshot.js.map

package/dist/memory/causal/loadSnapshot.js.map

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

package/dist/memory/causal/snapshotPipeline.js

@@ -0,0 +1,40 @@
+"use strict";
+/**
+ * snapshotPipeline — composes `loadSnapshot` + `writeSnapshot` into a
+ * `MemoryPipeline` ready to be mounted by `defineMemory({ type: CAUSAL })`.
+ *
+ *   READ  :  LoadSnapshot — embed query → search → project → format
+ *   WRITE :  WriteSnapshot — embed query → store as MemoryEntry<SnapshotEntry>
+ *
+ * The pipeline emits the same `agentfootprint.context.injected` event
+ * (with `source: 'memory'`) as every other memory flavor, so Lens
+ * shows Causal injections as memory chips alongside Episodic /
+ * Semantic / Narrative without special UI.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.snapshotPipeline = void 0;
+const footprintjs_1 = require("footprintjs");
+const loadSnapshot_js_1 = require("./loadSnapshot.js");
+const writeSnapshot_js_1 = require("./writeSnapshot.js");
+function snapshotPipeline(config) {
+    const loadConfig = {
+        store: config.store,
+        embedder: config.embedder,
+        ...(config.embedderId !== undefined && { embedderId: config.embedderId }),
+        ...(config.topK !== undefined && { topK: config.topK }),
+        ...(config.minScore !== undefined && { minScore: config.minScore }),
+        ...(config.projection !== undefined && { projection: config.projection }),
+    };
+    const writeConfig = {
+        store: config.store,
+        embedder: config.embedder,
+        ...(config.embedderId !== undefined && { embedderId: config.embedderId }),
+        ...(config.ttlMs !== undefined && { ttlMs: config.ttlMs }),
+        ...(config.tier && { tier: config.tier }),
+    };
+    const read = (0, footprintjs_1.flowChart)('LoadSnapshot', (0, loadSnapshot_js_1.loadSnapshot)(loadConfig), 'load-snapshot', undefined, 'Embed query, retrieve top-K past snapshots, project + format as system messages').build();
+    const write = (0, footprintjs_1.flowChart)('WriteSnapshot', (0, writeSnapshot_js_1.writeSnapshot)(writeConfig), 'write-snapshot', undefined, 'Capture (query, finalContent) from the run, embed query, persist as MemoryEntry<SnapshotEntry>').build();
+    return { read, write };
+}
+exports.snapshotPipeline = snapshotPipeline;
+//# sourceMappingURL=snapshotPipeline.js.map

package/dist/memory/causal/snapshotPipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshotPipeline.js","sourceRoot":"","sources":["../../../src/memory/causal/snapshotPipeline.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;AAEH,6CAAwC;AAQxC,uDAA0E;AAC1E,yDAA6E;AA4B7E,SAAgB,gBAAgB,CAAC,MAA8B;IAC7D,MAAM,UAAU,GAAuB;QACrC,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,GAAG,CAAC,MAAM,CAAC,UAAU,KAAK,SAAS,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC;QACzE,GAAG,CAAC,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;QACvD,GAAG,CAAC,MAAM,CAAC,QAAQ,KAAK,SAAS,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;QACnE,GAAG,CAAC,MAAM,CAAC,UAAU,KAAK,SAAS,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC;KAC1E,CAAC;IACF,MAAM,WAAW,GAAwB;QACvC,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,GAAG,CAAC,MAAM,CAAC,UAAU,KAAK,SAAS,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC;QACzE,GAAG,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;QAC1D,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;KAC1C,CAAC;IAEF,MAAM,IAAI,GAAG,IAAA,uBAAS,EACpB,cAAc,EACd,IAAA,8BAAY,EAAC,UAAU,CAAC,EACxB,eAAe,EACf,SAAS,EACT,iFAAiF,CAClF,CAAC,KAAK,EAAE,CAAC;IAEV,MAAM,KAAK,GAAG,IAAA,uBAAS,EACrB,eAAe,EACf,IAAA,gCAAa,EAAC,WAAW,CAAC,EAC1B,gBAAgB,EAChB,SAAS,EACT,gGAAgG,CACjG,CAAC,KAAK,EAAE,CAAC;IAEV,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AACzB,CAAC;AAlCD,4CAkCC"}

package/dist/memory/causal/types.js

@@ -0,0 +1,28 @@
+"use strict";
+/**
+ * Causal memory — types.
+ *
+ * A `SnapshotEntry` is the value stored in a Causal `MemoryStore`. It
+ * captures one agent run's "what happened and why" so future turns can
+ * answer follow-up questions ("why did you reject this?") with EXACT
+ * past facts instead of LLM reconstruction.
+ *
+ * Differentiator: footprintjs's `decide()`/`select()` already capture
+ * decision evidence as first-class events during traversal — we just
+ * persist them. Other libraries can't do this without rebuilding their
+ * core to surface decision evidence.
+ *
+ * Stored as `MemoryEntry<SnapshotEntry>` so the existing store layer
+ * (`MemoryStore`, `InMemoryStore`, future Redis/Dynamo/Postgres
+ * adapters) handles persistence + identity isolation + TTL + vector
+ * search out of the box.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_TOOL_RESULT_PREVIEW_LEN = void 0;
+/**
+ * Default truncation when serializing tool results into the snapshot.
+ * Keeps snapshot entries small enough to fit many in context during
+ * retrieval. Override per-call via `writeSnapshot` config.
+ */
+exports.DEFAULT_TOOL_RESULT_PREVIEW_LEN = 500;
+//# sourceMappingURL=types.js.map

package/dist/memory/causal/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/memory/causal/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;;;AAmGH;;;;GAIG;AACU,QAAA,+BAA+B,GAAG,GAAG,CAAC"}

package/dist/memory/causal/writeSnapshot.js

@@ -0,0 +1,79 @@
+"use strict";
+/**
+ * writeSnapshot — write-side stage for Causal memory.
+ *
+ * Captures the current run's `(query, finalContent)` pair from
+ * `scope.newMessages` (populated by the Agent's PrepareFinal stage),
+ * embeds the query for retrieval, and persists a `SnapshotEntry` to
+ * the store. Future turns can match new questions against past
+ * queries via cosine similarity to replay decision evidence.
+ *
+ * Reads from scope:  `identity`, `turnNumber`, `newMessages`
+ * Writes to store:   one `SnapshotEntry` per call, id = `snap-{turn}`
+ *
+ * Why per-turn (not per-iteration)?
+ *   Causal memory captures TURN outcomes — "user asked X, agent said Y."
+ *   Mid-iteration state isn't useful for cross-run replay.
+ *
+ * Empty-newMessages handling:
+ *   When `newMessages` is empty (no final answer produced — e.g.
+ *   pause-resume mid-flight), the stage no-ops. Re-runs after resume
+ *   capture the snapshot then.
+ *
+ * @see ./types.ts          for the SnapshotEntry shape this writes
+ * @see ./loadSnapshot.ts   for the read-side counterpart
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeSnapshot = void 0;
+function writeSnapshot(config) {
+    const { store, embedder } = config;
+    const embedderId = config.embedderId ?? 'unknown-embedder';
+    return async (scope) => {
+        const identity = scope.identity;
+        const turn = scope.turnNumber;
+        const newMessages = (scope.newMessages ?? []);
+        if (newMessages.length === 0)
+            return;
+        // Extract the (query, finalContent) pair from newMessages —
+        // populated by Agent's PrepareFinal stage as [user, assistant].
+        const userMsg = newMessages.find((m) => m.role === 'user');
+        const assistantMsg = newMessages.find((m) => m.role === 'assistant');
+        const query = userMsg?.content ?? '';
+        const finalContent = assistantMsg?.content ?? '';
+        if (query.length === 0)
+            return; // No query → no useful snapshot.
+        const signal = scope.$getEnv?.()?.signal;
+        const queryVec = (await embedder.embed({
+            text: query,
+            ...(signal ? { signal } : {}),
+        }));
+        const now = Date.now();
+        const ttl = config.ttlMs ? now + config.ttlMs : undefined;
+        const snapshot = {
+            query,
+            finalContent,
+            iterations: 0, // TODO: capture from scope when wire helper exposes it
+            decisions: [], // Populated by a follow-up FlowRecorder integration
+            toolCalls: [], // Populated by a follow-up FlowRecorder integration
+            durationMs: 0,
+            tokenUsage: { input: 0, output: 0 },
+        };
+        const entry = {
+            id: `snap-${turn}`,
+            value: snapshot,
+            version: 1,
+            createdAt: now,
+            updatedAt: now,
+            lastAccessedAt: now,
+            accessCount: 0,
+            embedding: [...queryVec],
+            embeddingModel: embedderId,
+            ...(ttl !== undefined && { ttl }),
+            ...(config.tier && { tier: config.tier }),
+            source: { turn, identity },
+        };
+        await store.put(identity, entry);
+    };
+}
+exports.writeSnapshot = writeSnapshot;
+//# sourceMappingURL=writeSnapshot.js.map

package/dist/memory/causal/writeSnapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writeSnapshot.js","sourceRoot":"","sources":["../../../src/memory/causal/writeSnapshot.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;;;AA0CH,SAAgB,aAAa,CAAC,MAA2B;IACvD,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;IACnC,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,kBAAkB,CAAC;IAE3D,OAAO,KAAK,EAAE,KAA8B,EAAiB,EAAE;QAC7D,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;QAChC,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC;QAC9B,MAAM,WAAW,GAAG,CAAC,KAAK,CAAC,WAAW,IAAI,EAAE,CAA0B,CAAC;QACvE,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAErC,4DAA4D;QAC5D,gEAAgE;QAChE,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;QAC3D,MAAM,YAAY,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC;QACrE,MAAM,KAAK,GAAI,OAAO,EAAE,OAA8B,IAAI,EAAE,CAAC;QAC7D,MAAM,YAAY,GAAI,YAAY,EAAE,OAA8B,IAAI,EAAE,CAAC;QAEzE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,iCAAiC;QAEjE,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC;QACzC,MAAM,QAAQ,GAAG,CAAC,MAAM,QAAQ,CAAC,KAAK,CAAC;YACrC,IAAI,EAAE,KAAK;YACX,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9B,CAAC,CAAa,CAAC;QAEhB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;QAE1D,MAAM,QAAQ,GAAkB;YAC9B,KAAK;YACL,YAAY;YACZ,UAAU,EAAE,CAAC,EAAE,uDAAuD;YACtE,SAAS,EAAE,EAAE,EAAE,oDAAoD;YACnE,SAAS,EAAE,EAAE,EAAE,oDAAoD;YACnE,UAAU,EAAE,CAAC;YACb,UAAU,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE;SACpC,CAAC;QAEF,MAAM,KAAK,GAA+B;YACxC,EAAE,EAAE,QAAQ,IAAI,EAAE;YAClB,KAAK,EAAE,QAAQ;YACf,OAAO,EAAE,CAAC;YACV,SAAS,EAAE,GAAG;YACd,SAAS,EAAE,GAAG;YACd,cAAc,EAAE,GAAG;YACnB,WAAW,EAAE,CAAC;YACd,SAAS,EAAE,CAAC,GAAG,QAAQ,CAAC;YACxB,cAAc,EAAE,UAAU;YAC1B,GAAG,CAAC,GAAG,KAAK,SAAS,IAAI,EAAE,GAAG,EAAE,CAAC;YACjC,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;YACzC,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;SAC3B,CAAC;QAEF,MAAM,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACnC,CAAC,CAAC;AACJ,CAAC;AAvDD,sCAuDC"}

package/dist/memory/define.js

@@ -0,0 +1,335 @@
+"use strict";
+/**
+ * defineMemory — the single factory the consumer uses to register a
+ * memory subsystem on an Agent.
+ *
+ *     defineMemory({ id, type, strategy, store }) → MemoryDefinition
+ *
+ * The factory's job:
+ *   1. Switch on `type` (Episodic / Semantic / Narrative / Causal)
+ *      to pick the right family of pipelines.
+ *   2. Switch on `strategy.kind` within that family to wire stage
+ *      configs (loadCount / topK / threshold / extractor / ...).
+ *   3. Return an opaque `MemoryDefinition` that step-4's
+ *      `Agent.memory()` builder method consumes.
+ *
+ * Pattern: Factory + Strategy (GoF). One factory, N strategies, four
+ *          types — all reduce to two compiled FlowCharts (`read`,
+ *          `write?`) that mount as subflows.
+ *
+ * Role:    Layer-2 of the memory stack. Sits between the const-objects
+ *          contract (Layer 1) and the Agent builder method (Layer 4).
+ *
+ * Emits:   Indirectly — the compiled subflows emit
+ *          `agentfootprint.context.injected` with `source: 'memory'`
+ *          when their formatter writes to the messages slot.
+ *
+ * 8-panel review (2026-04-28):
+ * - LLM Systems   ✅  asRole knob honored when present, defaults to 'system'
+ * - Architect     ✅  per-id scope keys (`memoryInjectionKey(id)`)
+ * - API Designer  ✅  one factory; CAUSAL stays here, no separate snapshotMemory
+ * - Performance   ✅  default `MEMORY_TIMING.TURN_START`; pipelines compiled once
+ * - Privacy       ✅  redact field passes through
+ * - ML / IR       ✅  threshold maps to semantic.minScore strictly; no fallback
+ * - SoftEng       ✅  unsupported combos throw with clear remediation hint
+ * - TS Engineer   ✅  discriminated union narrowing preserved across switches
+ *
+ * Book reference: AI Agents — The Definitive Guide, Ch 10 (Memory,
+ *   Autonomy, Long-Horizon Use — chapter still unavailable in pre-pub).
+ *
+ * @see ./define.types.ts        for the const-objects + types
+ * @see ./pipeline/*.ts          for the existing pipeline factories this dispatches to
+ * @see MEMORY.md                load-bearing design memory
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unwrapMemoryFlowChart = exports.defineMemory = void 0;
+const default_js_1 = require("./pipeline/default.js");
+const ephemeral_js_1 = require("./pipeline/ephemeral.js");
+const semantic_js_1 = require("./pipeline/semantic.js");
+const fact_js_1 = require("./pipeline/fact.js");
+const narrative_js_1 = require("./pipeline/narrative.js");
+const auto_js_1 = require("./pipeline/auto.js");
+const index_js_1 = require("./causal/index.js");
+const define_types_js_1 = require("./define.types.js");
+// ─── Public factory ────────────────────────────────────────────────
+/**
+ * Build a `MemoryDefinition` from a high-level `{ type, strategy, store }`
+ * config. Internally dispatches to one of the existing pipeline factories
+ * (defaultPipeline / semanticPipeline / factPipeline / narrativePipeline /
+ * autoPipeline / ephemeralPipeline) and wires the compiled flowcharts
+ * into the opaque definition that `Agent.memory()` consumes.
+ *
+ * Supported combinations:
+ *
+ * | type      | strategy.kind | underlying pipeline      |
+ * | --------- | ------------- | ------------------------ |
+ * | EPISODIC  | WINDOW        | defaultPipeline          |
+ * | EPISODIC  | BUDGET        | defaultPipeline          |
+ * | EPISODIC  | SUMMARIZE     | defaultPipeline + summarize stage |
+ * | SEMANTIC  | TOP_K         | semanticPipeline         |
+ * | SEMANTIC  | EXTRACT       | factPipeline             |
+ * | SEMANTIC  | WINDOW        | factPipeline (recency-load) |
+ * | NARRATIVE | EXTRACT       | narrativePipeline        |
+ * | NARRATIVE | WINDOW        | narrativePipeline (recency-load) |
+ * | (any)     | HYBRID        | autoPipeline (when sub-strategies map cleanly) |
+ *
+ * Unsupported combinations throw with a remediation hint pointing to a
+ * working alternative or to the raw `mountMemoryRead`/`mountMemoryWrite`
+ * helpers for power users.
+ */
+function defineMemory(options) {
+    validate(options);
+    const pipeline = buildPipeline(options);
+    const definition = {
+        id: options.id,
+        ...(options.description !== undefined && { description: options.description }),
+        type: options.type,
+        read: brandPipeline(pipeline.read),
+        ...(pipeline.write !== undefined && { write: brandPipeline(pipeline.write) }),
+        timing: options.timing ?? define_types_js_1.MEMORY_TIMING.TURN_START,
+        asRole: options.asRole ?? defaultRoleFor(options),
+        ...(options.redact !== undefined && { redact: options.redact }),
+        ...(options.type === define_types_js_1.MEMORY_TYPES.CAUSAL &&
+            options.projection !== undefined && {
+            projection: options.projection,
+        }),
+    };
+    return Object.freeze(definition);
+}
+exports.defineMemory = defineMemory;
+// ─── Validation ────────────────────────────────────────────────────
+function validate(options) {
+    if (!options.id || options.id.trim() === '') {
+        throw new Error('defineMemory: `id` is required and must be non-empty.');
+    }
+    if (!options.store) {
+        throw new Error(`defineMemory[id=${options.id}]: \`store\` is required. ` +
+            'Pass `new InMemoryStore()` for dev/tests, or a backed store for production.');
+    }
+}
+// ─── Pipeline dispatch ─────────────────────────────────────────────
+function buildPipeline(options) {
+    switch (options.type) {
+        case define_types_js_1.MEMORY_TYPES.EPISODIC:
+            return buildEpisodicPipeline(options);
+        case define_types_js_1.MEMORY_TYPES.SEMANTIC:
+            return buildSemanticPipeline(options);
+        case define_types_js_1.MEMORY_TYPES.NARRATIVE:
+            return buildNarrativePipeline(options);
+        case define_types_js_1.MEMORY_TYPES.CAUSAL:
+            return buildCausalPipeline(options);
+        default: {
+            const _exhaustive = options;
+            void _exhaustive;
+            throw new Error(`defineMemory: unknown type — ${options.type}`);
+        }
+    }
+}
+// ─── EPISODIC type ─────────────────────────────────────────────────
+function buildEpisodicPipeline(options) {
+    const s = options.strategy;
+    switch (s.kind) {
+        case define_types_js_1.MEMORY_STRATEGIES.WINDOW: {
+            const w = s;
+            const config = { store: options.store, loadCount: w.size };
+            return (0, default_js_1.defaultPipeline)(config);
+        }
+        case define_types_js_1.MEMORY_STRATEGIES.BUDGET: {
+            const b = s;
+            const config = {
+                store: options.store,
+                ...(b.reserveTokens !== undefined && { reserveTokens: b.reserveTokens }),
+                ...(b.minimumTokens !== undefined && { minimumTokens: b.minimumTokens }),
+                ...(b.maxEntries !== undefined && { maxEntries: b.maxEntries }),
+            };
+            return (0, default_js_1.defaultPipeline)(config);
+        }
+        case define_types_js_1.MEMORY_STRATEGIES.SUMMARIZE: {
+            // Load recent N raw turns; older content is summarized by an LLM
+            // before injection. defaultPipeline handles load+pick; the
+            // summarize stage is composed in by the wire helpers when the
+            // strategy carries an `llm` provider.
+            const sum = s;
+            const config = { store: options.store, loadCount: sum.recent };
+            return (0, default_js_1.defaultPipeline)(config);
+        }
+        case define_types_js_1.MEMORY_STRATEGIES.HYBRID: {
+            // Compose multiple sub-strategies onto one store. Currently
+            // delegates to the first sub-strategy that's valid for episodic
+            // data; richer selector-style merge of all sub-strategies'
+            // outputs is planned.
+            const h = s;
+            const inner = h.strategies[0];
+            if (!inner) {
+                throw new Error(`defineMemory[${options.id}]: HYBRID strategy requires at least one sub-strategy.`);
+            }
+            return buildEpisodicPipeline({ ...options, strategy: inner });
+        }
+        case define_types_js_1.MEMORY_STRATEGIES.EXTRACT:
+            throw new Error(`defineMemory[${options.id}]: EXTRACT strategy on EPISODIC type is not idiomatic — ` +
+                'extraction produces structured outputs (facts/beats), so use type=SEMANTIC or NARRATIVE.');
+        case define_types_js_1.MEMORY_STRATEGIES.TOP_K:
+            throw new Error(`defineMemory[${options.id}]: TOP_K strategy on EPISODIC type requires a vector store. ` +
+                'Use type=SEMANTIC for vector retrieval, or type=EPISODIC with strategy=WINDOW for recency.');
+        case define_types_js_1.MEMORY_STRATEGIES.DECAY:
+            throw new Error(`defineMemory[${options.id}]: DECAY strategy is not yet wired. ` +
+                'Workaround: set TTL on MemoryEntry, or compose manually via mountMemoryRead.');
+        default: {
+            const _exhaustive = s;
+            void _exhaustive;
+            throw new Error(`defineMemory: unknown strategy kind`);
+        }
+    }
+}
+// ─── SEMANTIC type ─────────────────────────────────────────────────
+function buildSemanticPipeline(options) {
+    const s = options.strategy;
+    switch (s.kind) {
+        case define_types_js_1.MEMORY_STRATEGIES.TOP_K: {
+            const t = s;
+            const config = {
+                store: options.store,
+                embedder: t.embedder,
+                k: t.topK,
+                ...(t.threshold !== undefined && { minScore: t.threshold }),
+            };
+            return (0, semantic_js_1.semanticPipeline)(config);
+        }
+        case define_types_js_1.MEMORY_STRATEGIES.EXTRACT: {
+            const e = s;
+            if (e.extractor === 'llm' && !e.llm) {
+                throw new Error(`defineMemory[${options.id}]: EXTRACT with extractor='llm' requires \`llm\` provider. ` +
+                    "Pass `extractor: 'pattern'` to use the regex-heuristics extractor instead.");
+            }
+            const config = { store: options.store };
+            return (0, fact_js_1.factPipeline)(config);
+        }
+        case define_types_js_1.MEMORY_STRATEGIES.WINDOW: {
+            // SEMANTIC × WINDOW: load top-N recent facts (no embedding query).
+            // factPipeline already loads by recency by default; size is interpreted
+            // as the load limit.
+            const w = s;
+            const config = { store: options.store, loadLimit: w.size };
+            return (0, fact_js_1.factPipeline)(config);
+        }
+        case define_types_js_1.MEMORY_STRATEGIES.HYBRID: {
+            // SEMANTIC × HYBRID — compose facts + beats via autoPipeline.
+            const config = { store: options.store };
+            return (0, auto_js_1.autoPipeline)(config);
+        }
+        case define_types_js_1.MEMORY_STRATEGIES.BUDGET:
+        case define_types_js_1.MEMORY_STRATEGIES.SUMMARIZE:
+        case define_types_js_1.MEMORY_STRATEGIES.DECAY:
+            throw new Error(`defineMemory[${options.id}]: ${String(s.kind)} strategy is not supported on SEMANTIC type. ` +
+                'Use TOP_K (vector retrieval), EXTRACT (LLM/pattern fact extraction), ' +
+                'WINDOW (recency-load), or HYBRID (auto compose).');
+        default: {
+            const _exhaustive = s;
+            void _exhaustive;
+            throw new Error(`defineMemory: unknown strategy kind`);
+        }
+    }
+}
+// ─── NARRATIVE type ────────────────────────────────────────────────
+function buildNarrativePipeline(options) {
+    const s = options.strategy;
+    switch (s.kind) {
+        case define_types_js_1.MEMORY_STRATEGIES.EXTRACT: {
+            const e = s;
+            if (e.extractor === 'llm' && !e.llm) {
+                throw new Error(`defineMemory[${options.id}]: EXTRACT with extractor='llm' requires \`llm\` provider.`);
+            }
+            const config = { store: options.store };
+            return (0, narrative_js_1.narrativePipeline)(config);
+        }
+        case define_types_js_1.MEMORY_STRATEGIES.WINDOW: {
+            const w = s;
+            const config = { store: options.store, loadCount: w.size };
+            return (0, narrative_js_1.narrativePipeline)(config);
+        }
+        case define_types_js_1.MEMORY_STRATEGIES.HYBRID: {
+            const config = { store: options.store };
+            return (0, auto_js_1.autoPipeline)(config);
+        }
+        case define_types_js_1.MEMORY_STRATEGIES.TOP_K:
+        case define_types_js_1.MEMORY_STRATEGIES.BUDGET:
+        case define_types_js_1.MEMORY_STRATEGIES.SUMMARIZE:
+        case define_types_js_1.MEMORY_STRATEGIES.DECAY:
+            throw new Error(`defineMemory[${options.id}]: ${String(s.kind)} strategy is not supported on NARRATIVE type. ` +
+                'Use EXTRACT (LLM/heuristic beat extraction), WINDOW (recency-load), or HYBRID.');
+        default: {
+            const _exhaustive = s;
+            void _exhaustive;
+            throw new Error(`defineMemory: unknown strategy kind`);
+        }
+    }
+}
+// ─── CAUSAL type ───────────────────────────────────────────────────
+function buildCausalPipeline(options) {
+    const s = options.strategy;
+    // Causal memory writes (query, finalContent) snapshots tagged with
+    // the original user query. Retrieval embeds the new query and
+    // cosine-matches against past queries, returning the most relevant
+    // snapshot for replay. Strict threshold: no match → no injection.
+    if (s.kind !== define_types_js_1.MEMORY_STRATEGIES.TOP_K) {
+        throw new Error(`defineMemory[${options.id}]: CAUSAL type only supports TOP_K strategy. ` +
+            'Snapshots are matched semantically against the new user query; ' +
+            "WINDOW/BUDGET/SUMMARIZE/EXTRACT/DECAY/HYBRID don't apply.");
+    }
+    if (!options.store.search) {
+        throw new Error(`defineMemory[${options.id}]: CAUSAL type requires a vector-capable store. ` +
+            'Pass `new InMemoryStore({ embedder })` for dev/tests, or a vector adapter ' +
+            '(pgvector, Pinecone, Qdrant) for production.');
+    }
+    const config = {
+        store: options.store,
+        embedder: s.embedder,
+        topK: s.topK,
+        ...(s.threshold !== undefined && { minScore: s.threshold }),
+        ...(options.projection !== undefined && { projection: options.projection }),
+    };
+    return (0, index_js_1.snapshotPipeline)(config);
+}
+// ─── Helpers ───────────────────────────────────────────────────────
+/**
+ * Default `asRole` per type — system for behavior-shaping memory,
+ * user for retrieved facts (so the LLM treats them as context, not
+ * instruction).
+ */
+function defaultRoleFor(options) {
+    switch (options.type) {
+        case define_types_js_1.MEMORY_TYPES.EPISODIC:
+        case define_types_js_1.MEMORY_TYPES.NARRATIVE:
+            return 'system';
+        case define_types_js_1.MEMORY_TYPES.SEMANTIC:
+            return 'system';
+        case define_types_js_1.MEMORY_TYPES.CAUSAL:
+            return 'system';
+        default:
+            return 'system';
+    }
+}
+/**
+ * The factory hands back an opaque `ReadonlyMemoryFlowChart<T>` brand
+ * to keep consumers from reaching into the FlowChart shape directly —
+ * step-4's `Agent.memory()` is the only place that unwraps it.
+ */
+function brandPipeline(fc) {
+    return fc;
+}
+/**
+ * Internal — unwrap the brand. Used by `Agent.memory()` (step 4)
+ * to mount the pipeline. NOT exported.
+ *
+ * @internal
+ */
+function unwrapMemoryFlowChart(branded) {
+    return branded;
+}
+exports.unwrapMemoryFlowChart = unwrapMemoryFlowChart;
+// Suppress ESLint unused-import warning for `ephemeralPipeline` —
+// reserved for a future `readOnly: true` config flag.
+void ephemeral_js_1.ephemeralPipeline;
+// Suppress for `Strategy` — kept as exported type for consumers.
+void null;
+//# sourceMappingURL=define.js.map

package/dist/memory/define.js.map

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