agentfootprint 1.14.0 → 1.15.0

package/dist/esm/memory/pipeline/auto.js

@@ -0,0 +1,177 @@
+/**
+ * autoPipeline — opinionated preset combining facts + beats on one store.
+ *
+ * The one-line default for "I want memory — just make it good."
+ *
+ *   READ  :  LoadAll → split by payload shape → FormatAuto
+ *            (one system msg with facts block + narrative paragraph)
+ *
+ *   WRITE :  LoadFacts → ExtractFacts → WriteFacts
+ *            → ExtractBeats → WriteBeats
+ *
+ * Facts carry "what's currently true" (identity, preferences,
+ * commitments — dedup on key). Beats carry "what happened" (traceable
+ * summaries — append-only). Together they cover the two memory shapes
+ * that matter for long-running agents without forcing the consumer to
+ * compose three presets by hand.
+ *
+ * **Default extractors**: zero-LLM-cost defaults so `autoPipeline({ store })`
+ * works out of the box:
+ *   - facts:  `patternFactExtractor()` (regex heuristics, free)
+ *   - beats:  `heuristicExtractor()`    (keyword heuristics, free)
+ *
+ * Pass `provider` to upgrade BOTH to LLM-backed extractors in one
+ * knob — `llmFactExtractor({ provider })` and `llmExtractor({ provider })`.
+ * The same cheap model (e.g. `claude-haiku-4-5`) handles both extraction
+ * calls per turn.
+ *
+ * **Why not include raw messages?** Raw messages come from the agent's
+ * ongoing conversation state — they don't need a memory strategy. This
+ * preset focuses on the two *compressed / deduplicated* shapes. Layer on
+ * `defaultPipeline` or `semanticPipeline` manually if you want raw recall.
+ *
+ * @example
+ * ```ts
+ * import { Agent, anthropic } from 'agentfootprint';
+ * import { autoPipeline, InMemoryStore } from 'agentfootprint/memory';
+ *
+ * // Free defaults — regex + heuristics, no LLM cost.
+ * const pipeline = autoPipeline({ store: new InMemoryStore() });
+ *
+ * // Or upgrade both extractors in one knob:
+ * const hq = autoPipeline({
+ *   store: new InMemoryStore(),
+ *   provider: anthropic('claude-haiku-4-5'),
+ * });
+ *
+ * const agent = Agent.create({ provider: anthropic('claude-sonnet-4-5') })
+ *   .system('You remember the user across turns.')
+ *   .memoryPipeline(pipeline)
+ *   .build();
+ * ```
+ */
+import { flowChart } from 'footprintjs';
+import { extractFacts, writeFacts, loadFacts, patternFactExtractor, llmFactExtractor, isFactId, } from '../facts';
+import { extractBeats, writeBeats, heuristicExtractor, llmExtractor, isNarrativeBeat, } from '../beats';
+const DEFAULT_FACTS_HEADER = 'Known facts about the user:';
+const DEFAULT_LEAD_IN = 'From earlier: ';
+const DEFAULT_LOAD_LIMIT = 200;
+/** Escape `</memory>` in user-controlled text to prevent tag-escape injection. */
+function escapeMemoryTag(text) {
+    return text.replace(/<\/memory>/gi, '</m\u200Demory>');
+}
+function renderValue(v) {
+    if (typeof v === 'string')
+        return v;
+    try {
+        return JSON.stringify(v);
+    }
+    catch {
+        return String(v);
+    }
+}
+/**
+ * Emit a single system message combining facts (key/value block) and
+ * beats (narrative paragraph). Empty sections are skipped; when BOTH
+ * are empty, `formatted = []` (no injection).
+ */
+function renderAutoMessage(facts, beats, opts) {
+    const sections = [];
+    if (facts.length > 0) {
+        const lines = facts.map((entry) => {
+            const f = entry.value;
+            const value = escapeMemoryTag(renderValue(f.value));
+            const conf = opts.showConfidence && typeof f.confidence === 'number'
+                ? ` (conf ${f.confidence.toFixed(2)})`
+                : '';
+            return `- ${f.key}: ${value}${conf}`;
+        });
+        sections.push(`${opts.factsHeader}\n\n${lines.join('\n')}`);
+    }
+    if (beats.length > 0) {
+        const sentences = beats.map((entry) => {
+            const beat = entry.value;
+            const text = escapeMemoryTag(beat.summary.trim());
+            const withRefs = opts.showRefs && beat.refs.length > 0 ? `${text} (refs: ${beat.refs.join(', ')})` : text;
+            return /[.!?]$/.test(withRefs) ? withRefs : `${withRefs}.`;
+        });
+        sections.push(`${opts.leadIn}${sentences.join(' ')}`);
+    }
+    if (sections.length === 0)
+        return [];
+    return [{ role: 'system', content: sections.join('\n\n') }];
+}
+export function autoPipeline(config) {
+    const factExtractor = config.factExtractor ??
+        (config.provider ? llmFactExtractor({ provider: config.provider }) : patternFactExtractor());
+    const beatExtractor = config.beatExtractor ??
+        (config.provider ? llmExtractor({ provider: config.provider }) : heuristicExtractor());
+    const loadLimit = config.loadLimit ?? DEFAULT_LOAD_LIMIT;
+    const factsHeader = config.factsHeader ?? DEFAULT_FACTS_HEADER;
+    const leadIn = config.narrativeLeadIn ?? DEFAULT_LEAD_IN;
+    const showConfidence = config.showConfidence ?? false;
+    const showRefs = config.showRefs ?? false;
+    // ── READ subflow ────────────────────────────────────────────
+    // One combined load + split stage. Keeps the subflow short and
+    // avoids pulling `loadRecent` + `pickByBudget` (which were designed
+    // for single-payload pipelines) into a mixed-payload context.
+    const read = flowChart('LoadAll', async (scope) => {
+        const listOpts = {
+            limit: loadLimit,
+            ...(config.tiers && { tiers: config.tiers }),
+        };
+        const { entries } = await config.store.list(scope.identity, listOpts);
+        const loadedFacts = [];
+        const loadedBeats = [];
+        for (const entry of entries) {
+            if (isFactId(entry.id)) {
+                loadedFacts.push(entry);
+            }
+            else if (isNarrativeBeat(entry.value)) {
+                loadedBeats.push(entry);
+            }
+            // Other payloads (raw messages) are intentionally ignored —
+            // auto() is the "compressed + deduped" preset.
+        }
+        // Stores typically return most-recently-updated first. Beats are
+        // more readable oldest-first (chronological narrative), so
+        // reverse before injection. Facts render as a list, order-agnostic.
+        scope.loadedFacts = loadedFacts;
+        scope.loadedBeats = [...loadedBeats].reverse();
+    }, 'load-all', undefined, 'Load facts + beats from the shared store; split by payload shape')
+        .addFunction('FormatAuto', async (scope) => {
+        const facts = (scope.loadedFacts ?? []);
+        const beats = (scope.loadedBeats ?? []);
+        scope.formatted = renderAutoMessage(facts, beats, {
+            factsHeader,
+            leadIn,
+            showConfidence,
+            showRefs,
+        });
+    }, 'format-auto', 'Emit one system message with facts block + narrative paragraph')
+        .build();
+    // ── WRITE subflow ───────────────────────────────────────────
+    // LoadFacts first so the (possibly LLM-backed) fact extractor sees
+    // existing facts via scope.loadedFacts and can update rather than
+    // duplicate. Then extract+write facts, then extract+write beats.
+    const write = flowChart('LoadFacts', loadFacts({
+        store: config.store,
+        limit: loadLimit,
+        ...(config.tiers && { tiers: config.tiers }),
+    }), 'load-facts', undefined, 'Surface existing facts for update-awareness')
+        .addFunction('ExtractFacts', extractFacts({
+        extractor: factExtractor,
+        ...(config.writeTier && { tier: config.writeTier }),
+        ...(config.writeTtlMs !== undefined && { ttlMs: config.writeTtlMs }),
+    }), 'extract-facts', 'Distill scope.newMessages into stable Fact entries')
+        .addFunction('WriteFacts', writeFacts({ store: config.store }), 'write-facts', 'Persist facts via store.putMany (overwrite on key collision)')
+        .addFunction('ExtractBeats', extractBeats({
+        extractor: beatExtractor,
+        ...(config.writeTier && { tier: config.writeTier }),
+        ...(config.writeTtlMs !== undefined && { ttlMs: config.writeTtlMs }),
+    }), 'extract-beats', 'Compress scope.newMessages into NarrativeBeat entries')
+        .addFunction('WriteBeats', writeBeats({ store: config.store }), 'write-beats', 'Persist beats via store.putMany')
+        .build();
+    return { read, write };
+}
+//# sourceMappingURL=auto.js.map

package/dist/esm/memory/pipeline/auto.js.map

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

package/dist/esm/memory/pipeline/index.js

@@ -3,4 +3,5 @@ export { ephemeralPipeline } from './ephemeral';
 export { narrativePipeline } from './narrative';
 export { semanticPipeline } from './semantic';
 export { factPipeline } from './fact';
+export { autoPipeline } from './auto';
 //# sourceMappingURL=index.js.map

package/dist/esm/memory/pipeline/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/memory/pipeline/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/memory/pipeline/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC"}

package/dist/esm/memory.barrel.js

@@ -38,6 +38,7 @@ export { ephemeralPipeline } from './memory/pipeline';
 export { narrativePipeline } from './memory/pipeline';
 export { semanticPipeline } from './memory/pipeline';
 export { factPipeline } from './memory/pipeline';
+export { autoPipeline } from './memory/pipeline';
 export { cosineSimilarity, mockEmbedder } from './memory/embedding';
 export { embedMessages, loadRelevant } from './memory/embedding';
 export { asImportance, isNarrativeBeat, heuristicExtractor, llmExtractor, extractBeats, writeBeats, formatAsNarrative, } from './memory/beats';

package/dist/esm/memory.barrel.js.map

@@ -1 +1 @@
-{"version":3,"file":"memory.barrel.js","sourceRoot":"","sources":["../../src/memory.barrel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAIH,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAItD,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAUzE,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAI/C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAK9E,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAKjD,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEpE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAYjE,OAAO,EACL,YAAY,EACZ,eAAe,EACf,kBAAkB,EAClB,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AAWxB,OAAO,EACL,MAAM,EACN,QAAQ,EACR,MAAM,EACN,YAAY,EACZ,oBAAoB,EACpB,gBAAgB,EAChB,YAAY,EACZ,UAAU,EACV,SAAS,EACT,WAAW,GACZ,MAAM,gBAAgB,CAAC;AAUxB,+DAA+D;AAC/D,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"memory.barrel.js","sourceRoot":"","sources":["../../src/memory.barrel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAIH,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAItD,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAUzE,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAI/C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAK9E,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAKjD,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEpE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAYjE,OAAO,EACL,YAAY,EACZ,eAAe,EACf,kBAAkB,EAClB,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AAWxB,OAAO,EACL,MAAM,EACN,QAAQ,EACR,MAAM,EACN,YAAY,EACZ,oBAAoB,EACpB,gBAAgB,EAChB,YAAY,EACZ,UAAU,EACV,SAAS,EACT,WAAW,GACZ,MAAM,gBAAgB,CAAC;AAUxB,+DAA+D;AAC/D,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC"}

package/dist/memory/pipeline/auto.js

@@ -0,0 +1,181 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.autoPipeline = void 0;
+/**
+ * autoPipeline — opinionated preset combining facts + beats on one store.
+ *
+ * The one-line default for "I want memory — just make it good."
+ *
+ *   READ  :  LoadAll → split by payload shape → FormatAuto
+ *            (one system msg with facts block + narrative paragraph)
+ *
+ *   WRITE :  LoadFacts → ExtractFacts → WriteFacts
+ *            → ExtractBeats → WriteBeats
+ *
+ * Facts carry "what's currently true" (identity, preferences,
+ * commitments — dedup on key). Beats carry "what happened" (traceable
+ * summaries — append-only). Together they cover the two memory shapes
+ * that matter for long-running agents without forcing the consumer to
+ * compose three presets by hand.
+ *
+ * **Default extractors**: zero-LLM-cost defaults so `autoPipeline({ store })`
+ * works out of the box:
+ *   - facts:  `patternFactExtractor()` (regex heuristics, free)
+ *   - beats:  `heuristicExtractor()`    (keyword heuristics, free)
+ *
+ * Pass `provider` to upgrade BOTH to LLM-backed extractors in one
+ * knob — `llmFactExtractor({ provider })` and `llmExtractor({ provider })`.
+ * The same cheap model (e.g. `claude-haiku-4-5`) handles both extraction
+ * calls per turn.
+ *
+ * **Why not include raw messages?** Raw messages come from the agent's
+ * ongoing conversation state — they don't need a memory strategy. This
+ * preset focuses on the two *compressed / deduplicated* shapes. Layer on
+ * `defaultPipeline` or `semanticPipeline` manually if you want raw recall.
+ *
+ * @example
+ * ```ts
+ * import { Agent, anthropic } from 'agentfootprint';
+ * import { autoPipeline, InMemoryStore } from 'agentfootprint/memory';
+ *
+ * // Free defaults — regex + heuristics, no LLM cost.
+ * const pipeline = autoPipeline({ store: new InMemoryStore() });
+ *
+ * // Or upgrade both extractors in one knob:
+ * const hq = autoPipeline({
+ *   store: new InMemoryStore(),
+ *   provider: anthropic('claude-haiku-4-5'),
+ * });
+ *
+ * const agent = Agent.create({ provider: anthropic('claude-sonnet-4-5') })
+ *   .system('You remember the user across turns.')
+ *   .memoryPipeline(pipeline)
+ *   .build();
+ * ```
+ */
+const footprintjs_1 = require("footprintjs");
+const facts_1 = require("../facts");
+const beats_1 = require("../beats");
+const DEFAULT_FACTS_HEADER = 'Known facts about the user:';
+const DEFAULT_LEAD_IN = 'From earlier: ';
+const DEFAULT_LOAD_LIMIT = 200;
+/** Escape `</memory>` in user-controlled text to prevent tag-escape injection. */
+function escapeMemoryTag(text) {
+    return text.replace(/<\/memory>/gi, '</m\u200Demory>');
+}
+function renderValue(v) {
+    if (typeof v === 'string')
+        return v;
+    try {
+        return JSON.stringify(v);
+    }
+    catch {
+        return String(v);
+    }
+}
+/**
+ * Emit a single system message combining facts (key/value block) and
+ * beats (narrative paragraph). Empty sections are skipped; when BOTH
+ * are empty, `formatted = []` (no injection).
+ */
+function renderAutoMessage(facts, beats, opts) {
+    const sections = [];
+    if (facts.length > 0) {
+        const lines = facts.map((entry) => {
+            const f = entry.value;
+            const value = escapeMemoryTag(renderValue(f.value));
+            const conf = opts.showConfidence && typeof f.confidence === 'number'
+                ? ` (conf ${f.confidence.toFixed(2)})`
+                : '';
+            return `- ${f.key}: ${value}${conf}`;
+        });
+        sections.push(`${opts.factsHeader}\n\n${lines.join('\n')}`);
+    }
+    if (beats.length > 0) {
+        const sentences = beats.map((entry) => {
+            const beat = entry.value;
+            const text = escapeMemoryTag(beat.summary.trim());
+            const withRefs = opts.showRefs && beat.refs.length > 0 ? `${text} (refs: ${beat.refs.join(', ')})` : text;
+            return /[.!?]$/.test(withRefs) ? withRefs : `${withRefs}.`;
+        });
+        sections.push(`${opts.leadIn}${sentences.join(' ')}`);
+    }
+    if (sections.length === 0)
+        return [];
+    return [{ role: 'system', content: sections.join('\n\n') }];
+}
+function autoPipeline(config) {
+    const factExtractor = config.factExtractor ??
+        (config.provider ? (0, facts_1.llmFactExtractor)({ provider: config.provider }) : (0, facts_1.patternFactExtractor)());
+    const beatExtractor = config.beatExtractor ??
+        (config.provider ? (0, beats_1.llmExtractor)({ provider: config.provider }) : (0, beats_1.heuristicExtractor)());
+    const loadLimit = config.loadLimit ?? DEFAULT_LOAD_LIMIT;
+    const factsHeader = config.factsHeader ?? DEFAULT_FACTS_HEADER;
+    const leadIn = config.narrativeLeadIn ?? DEFAULT_LEAD_IN;
+    const showConfidence = config.showConfidence ?? false;
+    const showRefs = config.showRefs ?? false;
+    // ── READ subflow ────────────────────────────────────────────
+    // One combined load + split stage. Keeps the subflow short and
+    // avoids pulling `loadRecent` + `pickByBudget` (which were designed
+    // for single-payload pipelines) into a mixed-payload context.
+    const read = (0, footprintjs_1.flowChart)('LoadAll', async (scope) => {
+        const listOpts = {
+            limit: loadLimit,
+            ...(config.tiers && { tiers: config.tiers }),
+        };
+        const { entries } = await config.store.list(scope.identity, listOpts);
+        const loadedFacts = [];
+        const loadedBeats = [];
+        for (const entry of entries) {
+            if ((0, facts_1.isFactId)(entry.id)) {
+                loadedFacts.push(entry);
+            }
+            else if ((0, beats_1.isNarrativeBeat)(entry.value)) {
+                loadedBeats.push(entry);
+            }
+            // Other payloads (raw messages) are intentionally ignored —
+            // auto() is the "compressed + deduped" preset.
+        }
+        // Stores typically return most-recently-updated first. Beats are
+        // more readable oldest-first (chronological narrative), so
+        // reverse before injection. Facts render as a list, order-agnostic.
+        scope.loadedFacts = loadedFacts;
+        scope.loadedBeats = [...loadedBeats].reverse();
+    }, 'load-all', undefined, 'Load facts + beats from the shared store; split by payload shape')
+        .addFunction('FormatAuto', async (scope) => {
+        const facts = (scope.loadedFacts ?? []);
+        const beats = (scope.loadedBeats ?? []);
+        scope.formatted = renderAutoMessage(facts, beats, {
+            factsHeader,
+            leadIn,
+            showConfidence,
+            showRefs,
+        });
+    }, 'format-auto', 'Emit one system message with facts block + narrative paragraph')
+        .build();
+    // ── WRITE subflow ───────────────────────────────────────────
+    // LoadFacts first so the (possibly LLM-backed) fact extractor sees
+    // existing facts via scope.loadedFacts and can update rather than
+    // duplicate. Then extract+write facts, then extract+write beats.
+    const write = (0, footprintjs_1.flowChart)('LoadFacts', (0, facts_1.loadFacts)({
+        store: config.store,
+        limit: loadLimit,
+        ...(config.tiers && { tiers: config.tiers }),
+    }), 'load-facts', undefined, 'Surface existing facts for update-awareness')
+        .addFunction('ExtractFacts', (0, facts_1.extractFacts)({
+        extractor: factExtractor,
+        ...(config.writeTier && { tier: config.writeTier }),
+        ...(config.writeTtlMs !== undefined && { ttlMs: config.writeTtlMs }),
+    }), 'extract-facts', 'Distill scope.newMessages into stable Fact entries')
+        .addFunction('WriteFacts', (0, facts_1.writeFacts)({ store: config.store }), 'write-facts', 'Persist facts via store.putMany (overwrite on key collision)')
+        .addFunction('ExtractBeats', (0, beats_1.extractBeats)({
+        extractor: beatExtractor,
+        ...(config.writeTier && { tier: config.writeTier }),
+        ...(config.writeTtlMs !== undefined && { ttlMs: config.writeTtlMs }),
+    }), 'extract-beats', 'Compress scope.newMessages into NarrativeBeat entries')
+        .addFunction('WriteBeats', (0, beats_1.writeBeats)({ store: config.store }), 'write-beats', 'Persist beats via store.putMany')
+        .build();
+    return { read, write };
+}
+exports.autoPipeline = autoPipeline;
+//# sourceMappingURL=auto.js.map

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

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

package/dist/memory/pipeline/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.factPipeline = exports.semanticPipeline = exports.narrativePipeline = exports.ephemeralPipeline = exports.defaultPipeline = void 0;
+exports.autoPipeline = exports.factPipeline = exports.semanticPipeline = exports.narrativePipeline = exports.ephemeralPipeline = exports.defaultPipeline = void 0;
 var default_1 = require("./default");
 Object.defineProperty(exports, "defaultPipeline", { enumerable: true, get: function () { return default_1.defaultPipeline; } });
 var ephemeral_1 = require("./ephemeral");
@@ -11,4 +11,6 @@ var semantic_1 = require("./semantic");
 Object.defineProperty(exports, "semanticPipeline", { enumerable: true, get: function () { return semantic_1.semanticPipeline; } });
 var fact_1 = require("./fact");
 Object.defineProperty(exports, "factPipeline", { enumerable: true, get: function () { return fact_1.factPipeline; } });
+var auto_1 = require("./auto");
+Object.defineProperty(exports, "autoPipeline", { enumerable: true, get: function () { return auto_1.autoPipeline; } });
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/memory/pipeline/index.ts"],"names":[],"mappings":";;;AACA,qCAA4C;AAAnC,0GAAA,eAAe,OAAA;AAExB,yCAAgD;AAAvC,8GAAA,iBAAiB,OAAA;AAE1B,yCAAgD;AAAvC,8GAAA,iBAAiB,OAAA;AAE1B,uCAA8C;AAArC,4GAAA,gBAAgB,OAAA;AAEzB,+BAAsC;AAA7B,oGAAA,YAAY,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/memory/pipeline/index.ts"],"names":[],"mappings":";;;AACA,qCAA4C;AAAnC,0GAAA,eAAe,OAAA;AAExB,yCAAgD;AAAvC,8GAAA,iBAAiB,OAAA;AAE1B,yCAAgD;AAAvC,8GAAA,iBAAiB,OAAA;AAE1B,uCAA8C;AAArC,4GAAA,gBAAgB,OAAA;AAEzB,+BAAsC;AAA7B,oGAAA,YAAY,OAAA;AAErB,+BAAsC;AAA7B,oGAAA,YAAY,OAAA"}

package/dist/memory.barrel.js

@@ -26,7 +26,7 @@
  *   });
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.mountMemoryPipeline = exports.mountMemoryWrite = exports.mountMemoryRead = exports.formatFacts = exports.loadFacts = exports.writeFacts = exports.extractFacts = exports.llmFactExtractor = exports.patternFactExtractor = exports.asConfidence = exports.isFact = exports.isFactId = exports.factId = exports.formatAsNarrative = exports.writeBeats = exports.extractBeats = exports.llmExtractor = exports.heuristicExtractor = exports.isNarrativeBeat = exports.asImportance = exports.loadRelevant = exports.embedMessages = exports.mockEmbedder = exports.cosineSimilarity = exports.factPipeline = exports.semanticPipeline = exports.narrativePipeline = exports.ephemeralPipeline = exports.defaultPipeline = exports.countMessageTokens = exports.approximateTokenCounter = exports.summarize = exports.formatDefault = exports.pickByBudget = exports.writeMessages = exports.loadRecent = exports.InMemoryStore = exports.computeDecayFactors = exports.computeDecayFactor = exports.identityNamespace = void 0;
+exports.mountMemoryPipeline = exports.mountMemoryWrite = exports.mountMemoryRead = exports.formatFacts = exports.loadFacts = exports.writeFacts = exports.extractFacts = exports.llmFactExtractor = exports.patternFactExtractor = exports.asConfidence = exports.isFact = exports.isFactId = exports.factId = exports.formatAsNarrative = exports.writeBeats = exports.extractBeats = exports.llmExtractor = exports.heuristicExtractor = exports.isNarrativeBeat = exports.asImportance = exports.loadRelevant = exports.embedMessages = exports.mockEmbedder = exports.cosineSimilarity = exports.autoPipeline = exports.factPipeline = exports.semanticPipeline = exports.narrativePipeline = exports.ephemeralPipeline = exports.defaultPipeline = exports.countMessageTokens = exports.approximateTokenCounter = exports.summarize = exports.formatDefault = exports.pickByBudget = exports.writeMessages = exports.loadRecent = exports.InMemoryStore = exports.computeDecayFactors = exports.computeDecayFactor = exports.identityNamespace = void 0;
 var identity_1 = require("./memory/identity");
 Object.defineProperty(exports, "identityNamespace", { enumerable: true, get: function () { return identity_1.identityNamespace; } });
 var entry_1 = require("./memory/entry");
@@ -57,6 +57,8 @@ var pipeline_4 = require("./memory/pipeline");
 Object.defineProperty(exports, "semanticPipeline", { enumerable: true, get: function () { return pipeline_4.semanticPipeline; } });
 var pipeline_5 = require("./memory/pipeline");
 Object.defineProperty(exports, "factPipeline", { enumerable: true, get: function () { return pipeline_5.factPipeline; } });
+var pipeline_6 = require("./memory/pipeline");
+Object.defineProperty(exports, "autoPipeline", { enumerable: true, get: function () { return pipeline_6.autoPipeline; } });
 var embedding_1 = require("./memory/embedding");
 Object.defineProperty(exports, "cosineSimilarity", { enumerable: true, get: function () { return embedding_1.cosineSimilarity; } });
 Object.defineProperty(exports, "mockEmbedder", { enumerable: true, get: function () { return embedding_1.mockEmbedder; } });

package/dist/memory.barrel.js.map

@@ -1 +1 @@
-{"version":3,"file":"memory.barrel.js","sourceRoot":"","sources":["../src/memory.barrel.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;;;AAIH,8CAAsD;AAA7C,6GAAA,iBAAiB,OAAA;AAI1B,wCAAyE;AAAhE,2GAAA,kBAAkB,OAAA;AAAE,4GAAA,mBAAmB,OAAA;AAUhD,wCAA+C;AAAtC,sGAAA,aAAa,OAAA;AAItB,0CAA6C;AAApC,oGAAA,UAAU,OAAA;AAEnB,0CAAgD;AAAvC,uGAAA,aAAa,OAAA;AAEtB,0CAA+C;AAAtC,sGAAA,YAAY,OAAA;AAErB,0CAAgD;AAAvC,uGAAA,aAAa,OAAA;AAEtB,0CAA4C;AAAnC,mGAAA,SAAS,OAAA;AAElB,0CAA8E;AAArE,iHAAA,uBAAuB,OAAA;AAAE,4GAAA,kBAAkB,OAAA;AAKpD,8CAAoD;AAA3C,2GAAA,eAAe,OAAA;AAExB,8CAAsD;AAA7C,6GAAA,iBAAiB,OAAA;AAE1B,8CAAsD;AAA7C,6GAAA,iBAAiB,OAAA;AAE1B,8CAAqD;AAA5C,4GAAA,gBAAgB,OAAA;AAEzB,8CAAiD;AAAxC,wGAAA,YAAY,OAAA;AAKrB,gDAAoE;AAA3D,6GAAA,gBAAgB,OAAA;AAAE,yGAAA,YAAY,OAAA;AAEvC,gDAAiE;AAAxD,0GAAA,aAAa,OAAA;AAAE,yGAAA,YAAY,OAAA;AAYpC,wCAQwB;AAPtB,qGAAA,YAAY,OAAA;AACZ,wGAAA,eAAe,OAAA;AACf,2GAAA,kBAAkB,OAAA;AAClB,qGAAA,YAAY,OAAA;AACZ,qGAAA,YAAY,OAAA;AACZ,mGAAA,UAAU,OAAA;AACV,0GAAA,iBAAiB,OAAA;AAYnB,wCAWwB;AAVtB,+FAAA,MAAM,OAAA;AACN,iGAAA,QAAQ,OAAA;AACR,+FAAA,MAAM,OAAA;AACN,qGAAA,YAAY,OAAA;AACZ,6GAAA,oBAAoB,OAAA;AACpB,yGAAA,gBAAgB,OAAA;AAChB,qGAAA,YAAY,OAAA;AACZ,mGAAA,UAAU,OAAA;AACV,kGAAA,SAAS,OAAA;AACT,oGAAA,WAAW,OAAA;AAWb,+DAA+D;AAC/D,sCAAuF;AAA9E,uGAAA,eAAe,OAAA;AAAE,wGAAA,gBAAgB,OAAA;AAAE,2GAAA,mBAAmB,OAAA"}
+{"version":3,"file":"memory.barrel.js","sourceRoot":"","sources":["../src/memory.barrel.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;;;AAIH,8CAAsD;AAA7C,6GAAA,iBAAiB,OAAA;AAI1B,wCAAyE;AAAhE,2GAAA,kBAAkB,OAAA;AAAE,4GAAA,mBAAmB,OAAA;AAUhD,wCAA+C;AAAtC,sGAAA,aAAa,OAAA;AAItB,0CAA6C;AAApC,oGAAA,UAAU,OAAA;AAEnB,0CAAgD;AAAvC,uGAAA,aAAa,OAAA;AAEtB,0CAA+C;AAAtC,sGAAA,YAAY,OAAA;AAErB,0CAAgD;AAAvC,uGAAA,aAAa,OAAA;AAEtB,0CAA4C;AAAnC,mGAAA,SAAS,OAAA;AAElB,0CAA8E;AAArE,iHAAA,uBAAuB,OAAA;AAAE,4GAAA,kBAAkB,OAAA;AAKpD,8CAAoD;AAA3C,2GAAA,eAAe,OAAA;AAExB,8CAAsD;AAA7C,6GAAA,iBAAiB,OAAA;AAE1B,8CAAsD;AAA7C,6GAAA,iBAAiB,OAAA;AAE1B,8CAAqD;AAA5C,4GAAA,gBAAgB,OAAA;AAEzB,8CAAiD;AAAxC,wGAAA,YAAY,OAAA;AAErB,8CAAiD;AAAxC,wGAAA,YAAY,OAAA;AAKrB,gDAAoE;AAA3D,6GAAA,gBAAgB,OAAA;AAAE,yGAAA,YAAY,OAAA;AAEvC,gDAAiE;AAAxD,0GAAA,aAAa,OAAA;AAAE,yGAAA,YAAY,OAAA;AAYpC,wCAQwB;AAPtB,qGAAA,YAAY,OAAA;AACZ,wGAAA,eAAe,OAAA;AACf,2GAAA,kBAAkB,OAAA;AAClB,qGAAA,YAAY,OAAA;AACZ,qGAAA,YAAY,OAAA;AACZ,mGAAA,UAAU,OAAA;AACV,0GAAA,iBAAiB,OAAA;AAYnB,wCAWwB;AAVtB,+FAAA,MAAM,OAAA;AACN,iGAAA,QAAQ,OAAA;AACR,+FAAA,MAAM,OAAA;AACN,qGAAA,YAAY,OAAA;AACZ,6GAAA,oBAAoB,OAAA;AACpB,yGAAA,gBAAgB,OAAA;AAChB,qGAAA,YAAY,OAAA;AACZ,mGAAA,UAAU,OAAA;AACV,kGAAA,SAAS,OAAA;AACT,oGAAA,WAAW,OAAA;AAWb,+DAA+D;AAC/D,sCAAuF;AAA9E,uGAAA,eAAe,OAAA;AAAE,wGAAA,gBAAgB,OAAA;AAAE,2GAAA,mBAAmB,OAAA"}

package/dist/types/memory/pipeline/auto.d.ts

@@ -0,0 +1,60 @@
+import type { LLMProvider } from '../../types';
+import type { MemoryStore } from '../store';
+import type { MemoryEntry } from '../entry';
+import type { MemoryPipeline } from './types';
+import { type FactPipelineState, type FactExtractor } from '../facts';
+import { type NarrativeBeat, type BeatExtractor, type ExtractBeatsState } from '../beats';
+export interface AutoPipelineConfig {
+    /** The store both extractors share. */
+    readonly store: MemoryStore;
+    /**
+     * When present, upgrades both fact AND beat extraction to LLM-backed
+     * variants. Typically a cheap/fast model like Claude Haiku. Omit to
+     * use the free heuristic + regex defaults.
+     */
+    readonly provider?: LLMProvider;
+    /**
+     * Override the fact extractor explicitly. Takes precedence over
+     * `provider`. Use when you want facts via LLM but beats via heuristic,
+     * or vice-versa.
+     */
+    readonly factExtractor?: FactExtractor;
+    /**
+     * Override the beat extractor explicitly. Takes precedence over
+     * `provider`.
+     */
+    readonly beatExtractor?: BeatExtractor;
+    /**
+     * Upper bound on the `store.list` page size during read. Large enough
+     * to fit typical identity+history; raise for long-lived agents with
+     * dozens of fact categories and hundreds of beats. Default `200`.
+     */
+    readonly loadLimit?: number;
+    /** Tier filter for read. */
+    readonly tiers?: ReadonlyArray<'hot' | 'warm' | 'cold'>;
+    /** Tier to tag newly written entries (both facts and beats). */
+    readonly writeTier?: 'hot' | 'warm' | 'cold';
+    /** TTL in ms applied to newly written entries. */
+    readonly writeTtlMs?: number;
+    /** Header for the facts block in the injected system message. */
+    readonly factsHeader?: string;
+    /** Lead-in phrase for the narrative paragraph. Default `"From earlier: "`. */
+    readonly narrativeLeadIn?: string;
+    /**
+     * When `true`, appends `(conf 0.xx)` after each fact. Off by default
+     * — confidence is noise for the LLM in typical flows.
+     */
+    readonly showConfidence?: boolean;
+    /**
+     * When `true`, appends `(refs: msg-x-y, ...)` after each beat line.
+     * Off by default.
+     */
+    readonly showRefs?: boolean;
+}
+/** State used by the auto pipeline's subflows. */
+export interface AutoPipelineState extends FactPipelineState, ExtractBeatsState {
+    /** Beats loaded from the store during auto-READ. */
+    loadedBeats?: readonly MemoryEntry<NarrativeBeat>[];
+}
+export declare function autoPipeline(config: AutoPipelineConfig): MemoryPipeline;
+//# sourceMappingURL=auto.d.ts.map

package/dist/types/memory/pipeline/auto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto.d.ts","sourceRoot":"","sources":["../../../../src/memory/pipeline/auto.ts"],"names":[],"mappings":"AAsDA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,OAAO,EAQL,KAAK,iBAAiB,EACtB,KAAK,aAAa,EACnB,MAAM,UAAU,CAAC;AAClB,OAAO,EAML,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACvB,MAAM,UAAU,CAAC;AAElB,MAAM,WAAW,kBAAkB;IACjC,uCAAuC;IACvC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAE5B;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAC;IAEhC;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC;IAEvC;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC;IAEvC;;;;OAIG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAE5B,4BAA4B;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC;IAExD,gEAAgE;IAChE,QAAQ,CAAC,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;IAE7C,kDAAkD;IAClD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAE7B,iEAAiE;IACjE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAE9B,8EAA8E;IAC9E,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAElC;;;OAGG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAElC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,kDAAkD;AAClD,MAAM,WAAW,iBAAkB,SAAQ,iBAAiB,EAAE,iBAAiB;IAC7E,oDAAoD;IACpD,WAAW,CAAC,EAAE,SAAS,WAAW,CAAC,aAAa,CAAC,EAAE,CAAC;CACrD;AAiED,wBAAgB,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,CAoHvE"}

package/dist/types/memory/pipeline/index.d.ts

@@ -9,4 +9,6 @@ export { semanticPipeline } from './semantic';
 export type { SemanticPipelineConfig } from './semantic';
 export { factPipeline } from './fact';
 export type { FactPipelineConfig } from './fact';
+export { autoPipeline } from './auto';
+export type { AutoPipelineConfig, AutoPipelineState } from './auto';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/memory/pipeline/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/memory/pipeline/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,YAAY,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,YAAY,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,YAAY,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,YAAY,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,YAAY,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/memory/pipeline/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,YAAY,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,YAAY,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,YAAY,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,YAAY,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,YAAY,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC"}

package/dist/types/memory.barrel.d.ts

@@ -54,6 +54,8 @@ export { semanticPipeline } from './memory/pipeline';
 export type { SemanticPipelineConfig } from './memory/pipeline';
 export { factPipeline } from './memory/pipeline';
 export type { FactPipelineConfig } from './memory/pipeline';
+export { autoPipeline } from './memory/pipeline';
+export type { AutoPipelineConfig, AutoPipelineState } from './memory/pipeline';
 export type { Embedder, EmbedArgs, EmbedBatchArgs } from './memory/embedding';
 export { cosineSimilarity, mockEmbedder } from './memory/embedding';
 export type { MockEmbedderOptions } from './memory/embedding';

package/dist/types/memory.barrel.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentfootprint",
-  "version": "1.14.0",
+  "version": "1.15.0",
   "description": "The explainable agent framework — build AI agents you can explain, audit, and trust. Built on footprintjs.",
   "license": "MIT",
   "author": "Sanjay Krishna Anbalagan",