agentfootprint 1.23.0 → 2.1.0

package/dist/memory/facts/patternFactExtractor.js

@@ -4,21 +4,7 @@ exports.patternFactExtractor = void 0;
 const types_1 = require("./types");
 /** Extract plaintext from any Message content shape. */
 function textOf(message) {
-    const c = message.content;
-    if (typeof c === 'string')
-        return c;
-    if (Array.isArray(c)) {
-        const parts = [];
-        for (const block of c) {
-            if (block && typeof block === 'object') {
-                const b = block;
-                if (b.type === 'text' && typeof b.text === 'string')
-                    parts.push(b.text);
-            }
-        }
-        return parts.join(' ');
-    }
-    return '';
+    return message.content ?? '';
 }
 const RULES = [
     {

package/dist/memory/facts/patternFactExtractor.js.map

@@ -1 +1 @@
-{"version":3,"file":"patternFactExtractor.js","sourceRoot":"","sources":["../../../src/memory/facts/patternFactExtractor.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"patternFactExtractor.js","sourceRoot":"","sources":["../../../src/memory/facts/patternFactExtractor.ts"],"names":[],"mappings":";;;AAuBA,mCAAuC;AAEvC,wDAAwD;AACxD,SAAS,MAAM,CAAC,OAAgB;IAC9B,OAAO,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;AAC/B,CAAC;AAkBD,MAAM,KAAK,GAAoB;IAC7B;QACE,GAAG,EAAE,WAAW;QAChB,QAAQ,EAAE,UAAU;QACpB,UAAU,EAAE,GAAG;QACf,QAAQ,EAAE;YACR,2EAA2E;YAC3E,6EAA6E;YAC7E,6EAA6E;YAC7E,0DAA0D;YAC1D,iFAAiF;YACjF,kDAAkD;SACnD;KACF;IACD;QACE,GAAG,EAAE,YAAY;QACjB,QAAQ,EAAE,SAAS;QACnB,UAAU,EAAE,IAAI;QAChB,QAAQ,EAAE;YACR,wEAAwE;YACxE,sDAAsD;SACvD;KACF;IACD;QACE,GAAG,EAAE,eAAe;QACpB,QAAQ,EAAE,SAAS;QACnB,UAAU,EAAE,GAAG;QACf,QAAQ,EAAE;YACR,uEAAuE;YACvE,mEAAmE;YACnE,4EAA4E;SAC7E;KACF;IACD;QACE,GAAG,EAAE,kBAAkB;QACvB,QAAQ,EAAE,YAAY;QACtB,UAAU,EAAE,GAAG;QACf,QAAQ,EAAE;YACR,gEAAgE;YAChE,6DAA6D;YAC7D,iFAAiF;SAClF;KACF;CACF,CAAC;AAEF,sEAAsE;AACtE,SAAS,UAAU,CAAC,CAAS;IAC3B,OAAO,CAAC,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AAC9C,CAAC;AAED,SAAgB,oBAAoB;IAClC,OAAO;QACL,KAAK,CAAC,OAAO,CAAC,IAAqB;YACjC,+DAA+D;YAC/D,kEAAkE;YAClE,2BAA2B;YAC3B,MAAM,KAAK,GAAG,IAAI,GAAG,EAAgB,CAAC;YAEtC,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAChC,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM;oBAAE,SAAS;gBAClC,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;gBACzB,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;oBAAE,SAAS;gBAEhC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBACzB,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;wBACpC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;wBAClC,IAAI,CAAC,KAAK;4BAAE,SAAS;wBACrB,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;wBACrB,IAAI,CAAC,GAAG;4BAAE,SAAS;wBACnB,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;wBAC9B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;4BAAE,SAAS;wBACjC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE;4BAClB,GAAG,EAAE,IAAI,CAAC,GAAG;4BACb,KAAK;4BACL,UAAU,EAAE,IAAA,oBAAY,EAAC,IAAI,CAAC,UAAU,CAAC;4BACzC,QAAQ,EAAE,IAAI,CAAC,QAAQ;yBACxB,CAAC,CAAC;wBACH,MAAM,CAAC,qDAAqD;oBAC9D,CAAC;gBACH,CAAC;YACH,CAAC;YAED,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QACpC,CAAC;KACF,CAAC;AACJ,CAAC;AAnCD,oDAmCC"}

package/dist/memory/index.js

@@ -1,10 +1,50 @@
 "use strict";
+/**
+ * Memory subsystem — narrative beats, fact extraction, embedding-based
+ * retrieval, and pipelines that compose them.
+ *
+ * Re-exported from agentfootprint's main entry. See individual module
+ * READMEs for usage.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createToolResults = exports.lastMessageHasToolCalls = exports.lastAssistantMessage = exports.lastMessage = exports.appendMessage = void 0;
-var conversationHelpers_1 = require("./conversationHelpers");
-Object.defineProperty(exports, "appendMessage", { enumerable: true, get: function () { return conversationHelpers_1.appendMessage; } });
-Object.defineProperty(exports, "lastMessage", { enumerable: true, get: function () { return conversationHelpers_1.lastMessage; } });
-Object.defineProperty(exports, "lastAssistantMessage", { enumerable: true, get: function () { return conversationHelpers_1.lastAssistantMessage; } });
-Object.defineProperty(exports, "lastMessageHasToolCalls", { enumerable: true, get: function () { return conversationHelpers_1.lastMessageHasToolCalls; } });
-Object.defineProperty(exports, "createToolResults", { enumerable: true, get: function () { return conversationHelpers_1.createToolResults; } });
+exports.defineMemory = exports.isMemoryInjectionKey = exports.memoryInjectionKey = exports.isSnapshotProjection = exports.isMemoryTiming = exports.isMemoryStrategyKind = exports.isMemoryType = exports.MEMORY_INJECTION_KEY_PREFIX = exports.SNAPSHOT_PROJECTIONS = exports.MEMORY_TIMING = exports.MEMORY_STRATEGIES = exports.MEMORY_TYPES = void 0;
+__exportStar(require("./beats/index.js"), exports);
+__exportStar(require("./causal/index.js"), exports);
+__exportStar(require("./embedding/index.js"), exports);
+__exportStar(require("./entry/index.js"), exports);
+__exportStar(require("./facts/index.js"), exports);
+__exportStar(require("./identity/index.js"), exports);
+__exportStar(require("./pipeline/index.js"), exports);
+__exportStar(require("./stages/index.js"), exports);
+__exportStar(require("./store/index.js"), exports);
+__exportStar(require("./wire/index.js"), exports);
+// Consumer-facing factory + const-objects for memory configuration.
+var define_types_js_1 = require("./define.types.js");
+Object.defineProperty(exports, "MEMORY_TYPES", { enumerable: true, get: function () { return define_types_js_1.MEMORY_TYPES; } });
+Object.defineProperty(exports, "MEMORY_STRATEGIES", { enumerable: true, get: function () { return define_types_js_1.MEMORY_STRATEGIES; } });
+Object.defineProperty(exports, "MEMORY_TIMING", { enumerable: true, get: function () { return define_types_js_1.MEMORY_TIMING; } });
+Object.defineProperty(exports, "SNAPSHOT_PROJECTIONS", { enumerable: true, get: function () { return define_types_js_1.SNAPSHOT_PROJECTIONS; } });
+Object.defineProperty(exports, "MEMORY_INJECTION_KEY_PREFIX", { enumerable: true, get: function () { return define_types_js_1.MEMORY_INJECTION_KEY_PREFIX; } });
+Object.defineProperty(exports, "isMemoryType", { enumerable: true, get: function () { return define_types_js_1.isMemoryType; } });
+Object.defineProperty(exports, "isMemoryStrategyKind", { enumerable: true, get: function () { return define_types_js_1.isMemoryStrategyKind; } });
+Object.defineProperty(exports, "isMemoryTiming", { enumerable: true, get: function () { return define_types_js_1.isMemoryTiming; } });
+Object.defineProperty(exports, "isSnapshotProjection", { enumerable: true, get: function () { return define_types_js_1.isSnapshotProjection; } });
+Object.defineProperty(exports, "memoryInjectionKey", { enumerable: true, get: function () { return define_types_js_1.memoryInjectionKey; } });
+Object.defineProperty(exports, "isMemoryInjectionKey", { enumerable: true, get: function () { return define_types_js_1.isMemoryInjectionKey; } });
+var define_js_1 = require("./define.js");
+Object.defineProperty(exports, "defineMemory", { enumerable: true, get: function () { return define_js_1.defineMemory; } });
 //# sourceMappingURL=index.js.map

package/dist/memory/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":";;;AAAA,6DAM+B;AAL7B,oHAAA,aAAa,OAAA;AACb,kHAAA,WAAW,OAAA;AACX,2HAAA,oBAAoB,OAAA;AACpB,8HAAA,uBAAuB,OAAA;AACvB,wHAAA,iBAAiB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;;;;;;;;;;;;;;AAEH,mDAAiC;AACjC,oDAAkC;AAClC,uDAAqC;AACrC,mDAAiC;AACjC,mDAAiC;AACjC,sDAAoC;AACpC,sDAAoC;AACpC,oDAAkC;AAClC,mDAAiC;AACjC,kDAAgC;AAEhC,oEAAoE;AACpE,qDA+B2B;AA9BzB,+GAAA,YAAY,OAAA;AACZ,oHAAA,iBAAiB,OAAA;AACjB,gHAAA,aAAa,OAAA;AACb,uHAAA,oBAAoB,OAAA;AACpB,8HAAA,2BAA2B,OAAA;AAC3B,+GAAA,YAAY,OAAA;AACZ,uHAAA,oBAAoB,OAAA;AACpB,iHAAA,cAAc,OAAA;AACd,uHAAA,oBAAoB,OAAA;AACpB,qHAAA,kBAAkB,OAAA;AAClB,uHAAA,oBAAoB,OAAA;AAqBtB,yCAA2C;AAAlC,yGAAA,YAAY,OAAA"}

package/dist/memory/pipeline/auto.js

@@ -33,24 +33,23 @@ exports.autoPipeline = void 0;
  * preset focuses on the two *compressed / deduplicated* shapes. Layer on
  * `defaultPipeline` or `semanticPipeline` manually if you want raw recall.
  *
- * @example
+ * Most consumers reach for `autoPipeline` indirectly through
+ * `defineMemory({ type: MEMORY_TYPES.SEMANTIC, strategy: { kind:
+ * MEMORY_STRATEGIES.HYBRID, ... }, store })`, which dispatches here
+ * for hybrid-style composition.
+ *
+ * @example Direct usage (low-level — custom flowchart composition):
  * ```ts
- * import { Agent, anthropic } from 'agentfootprint';
- * import { autoPipeline, InMemoryStore } from 'agentfootprint/memory';
+ * import { autoPipeline, mountMemoryRead, mountMemoryWrite, InMemoryStore } from 'agentfootprint/memory';
  *
  * // Free defaults — regex + heuristics, no LLM cost.
  * const pipeline = autoPipeline({ store: new InMemoryStore() });
  *
- * // Or upgrade both extractors in one knob:
+ * // Or upgrade both extractors in one knob (pass any LLMProvider):
  * const hq = autoPipeline({
  *   store: new InMemoryStore(),
- *   provider: anthropic('claude-haiku-4-5'),
+ *   provider: yourLLMProvider,
  * });
- *
- * 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");

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

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

package/dist/memory/pipeline/default.js

@@ -18,7 +18,7 @@ exports.defaultPipeline = void 0;
  *
  * This preset is intentionally opinionated. Users who need more
  * control should compose their own FlowChart and pass it to
- * `.memoryPipeline()` directly — the preset is teaching code, not a
+ * `.memory()` directly — the preset is teaching code, not a
  * one-size-fits-all.
  *
  * **Build once, mount many.** Call `defaultPipeline(config)` at application
@@ -27,10 +27,17 @@ exports.defaultPipeline = void 0;
  * agent builds and many `.run()` calls. Rebuilding per-turn is wasteful —
  * the stages capture their config at build time and don't read it later.
  *
- * @example
+ * Most consumers should use `defineMemory({ type: MEMORY_TYPES.EPISODIC,
+ * strategy: { kind: MEMORY_STRATEGIES.WINDOW, ... }, store })` instead
+ * of calling `defaultPipeline()` directly — the factory dispatches
+ * onto this pipeline under the hood. Use `defaultPipeline()` directly
+ * only when composing memory subflows into a non-Agent flowchart via
+ * `mountMemoryRead`/`mountMemoryWrite`.
+ *
+ * @example Direct usage (low-level — custom flowchart composition):
  * ```ts
- * import { Agent, anthropic } from 'agentfootprint';
- * import { defaultPipeline, InMemoryStore } from 'agentfootprint/memory';
+ * import { defaultPipeline, mountMemoryRead, InMemoryStore } from 'agentfootprint/memory';
+ * import { flowChart } from 'footprintjs';
  *
  * const pipeline = defaultPipeline({
  *   store: new InMemoryStore(),
@@ -38,10 +45,9 @@ exports.defaultPipeline = void 0;
  *   reserveTokens: 512,
  * });
  *
- * const agent = Agent.create({ provider: anthropic('claude-sonnet-4') })
- *   .system('You are a helpful assistant.')
- *   .memoryPipeline(pipeline)
- *   .build();
+ * let builder = flowChart('Seed', seedFn, 'seed');
+ * builder = mountMemoryRead(builder, { pipeline });
+ * // ... continue building your custom flowchart
  * ```
  */
 const footprintjs_1 = require("footprintjs");

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

@@ -1 +1 @@
-{"version":3,"file":"default.js","sourceRoot":"","sources":["../../../src/memory/pipeline/default.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,6CAAwC;AAExC,qDAAyE;AACzE,yDAA+E;AAC/E,2DAAkF;AAClF,2DAAkF;AAyDlF;;;GAGG;AACH,SAAgB,eAAe,CAAC,MAA6B;IAC3D,uEAAuE;IACvE,iEAAiE;IACjE,MAAM,UAAU,GAAqB;QACnC,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,GAAG,CAAC,MAAM,CAAC,SAAS,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC;QAClE,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;KAC7C,CAAC;IACF,MAAM,UAAU,GAAuB;QACrC,GAAG,CAAC,MAAM,CAAC,aAAa,KAAK,SAAS,IAAI,EAAE,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,CAAC;QAClF,GAAG,CAAC,MAAM,CAAC,aAAa,KAAK,SAAS,IAAI,EAAE,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,CAAC;QAClF,GAAG,CAAC,MAAM,CAAC,UAAU,KAAK,SAAS,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC;KAC1E,CAAC;IACF,MAAM,YAAY,GAAwB;QACxC,GAAG,CAAC,MAAM,CAAC,YAAY,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC;QACzE,GAAG,CAAC,MAAM,CAAC,YAAY,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC;KAC1E,CAAC;IACF,MAAM,WAAW,GAAwB;QACvC,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,GAAG,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC;QACnD,GAAG,CAAC,MAAM,CAAC,UAAU,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC;KACrE,CAAC;IAEF,oFAAoF;IACpF,iEAAiE;IACjE,sEAAsE;IACtE,yEAAyE;IACzE,IAAI,WAAW,GAAG,IAAA,uBAAS,EACzB,YAAY,EACZ,IAAA,uBAAU,EAAC,UAAU,CAAC,EACtB,aAAa,EACb,SAAS,EACT,2DAA2D,CAC5D,CAAC;IACF,WAAW,GAAG,IAAA,2BAAY,EAAC,UAAU,CAAC,CAAC,WAAW,CAAC,CAAC;IACpD,MAAM,IAAI,GAAG,WAAW;SACrB,WAAW,CACV,QAAQ,EACR,IAAA,6BAAa,EAAC,YAAY,CAAC,EAC3B,gBAAgB,EAChB,qEAAqE,CACtE;SACA,KAAK,EAAE,CAAC;IAEX,MAAM,KAAK,GAAG,IAAA,uBAAS,EACrB,eAAe,EACf,IAAA,6BAAa,EAAC,WAAW,CAAC,EAC1B,gBAAgB,EAChB,SAAS,EACT,sCAAsC,CACvC,CAAC,KAAK,EAAE,CAAC;IAEV,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AACzB,CAAC;AArDD,0CAqDC"}
+{"version":3,"file":"default.js","sourceRoot":"","sources":["../../../src/memory/pipeline/default.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,6CAAwC;AAExC,qDAAyE;AACzE,yDAA+E;AAC/E,2DAAkF;AAClF,2DAAkF;AAyDlF;;;GAGG;AACH,SAAgB,eAAe,CAAC,MAA6B;IAC3D,uEAAuE;IACvE,iEAAiE;IACjE,MAAM,UAAU,GAAqB;QACnC,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,GAAG,CAAC,MAAM,CAAC,SAAS,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC;QAClE,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;KAC7C,CAAC;IACF,MAAM,UAAU,GAAuB;QACrC,GAAG,CAAC,MAAM,CAAC,aAAa,KAAK,SAAS,IAAI,EAAE,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,CAAC;QAClF,GAAG,CAAC,MAAM,CAAC,aAAa,KAAK,SAAS,IAAI,EAAE,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,CAAC;QAClF,GAAG,CAAC,MAAM,CAAC,UAAU,KAAK,SAAS,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC;KAC1E,CAAC;IACF,MAAM,YAAY,GAAwB;QACxC,GAAG,CAAC,MAAM,CAAC,YAAY,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC;QACzE,GAAG,CAAC,MAAM,CAAC,YAAY,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC;KAC1E,CAAC;IACF,MAAM,WAAW,GAAwB;QACvC,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,GAAG,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC;QACnD,GAAG,CAAC,MAAM,CAAC,UAAU,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC;KACrE,CAAC;IAEF,oFAAoF;IACpF,iEAAiE;IACjE,sEAAsE;IACtE,yEAAyE;IACzE,IAAI,WAAW,GAAG,IAAA,uBAAS,EACzB,YAAY,EACZ,IAAA,uBAAU,EAAC,UAAU,CAAC,EACtB,aAAa,EACb,SAAS,EACT,2DAA2D,CAC5D,CAAC;IACF,WAAW,GAAG,IAAA,2BAAY,EAAC,UAAU,CAAC,CAAC,WAAW,CAAC,CAAC;IACpD,MAAM,IAAI,GAAG,WAAW;SACrB,WAAW,CACV,QAAQ,EACR,IAAA,6BAAa,EAAC,YAAY,CAAC,EAC3B,gBAAgB,EAChB,qEAAqE,CACtE;SACA,KAAK,EAAE,CAAC;IAEX,MAAM,KAAK,GAAG,IAAA,uBAAS,EACrB,eAAe,EACf,IAAA,6BAAa,EAAC,WAAW,CAAC,EAC1B,gBAAgB,EAChB,SAAS,EACT,sCAAsC,CACvC,CAAC,KAAK,EAAE,CAAC;IAEV,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AACzB,CAAC;AArDD,0CAqDC"}

package/dist/memory/pipeline/fact.js

@@ -29,24 +29,22 @@ exports.factPipeline = void 0;
  * accumulation, no "fact history" by default. Consumers who need fact
  * history should run `narrativePipeline` alongside.
  *
- * @example
+ * Most consumers reach for `factPipeline` indirectly through
+ * `defineMemory({ type: MEMORY_TYPES.SEMANTIC, strategy: { kind:
+ * MEMORY_STRATEGIES.EXTRACT, extractor: 'pattern' | 'llm' }, store })`.
+ *
+ * @example Direct usage (low-level — custom flowchart composition):
  * ```ts
- * import { Agent, anthropic } from 'agentfootprint';
- * import { factPipeline, InMemoryStore, llmFactExtractor } from 'agentfootprint/memory';
+ * import { factPipeline, llmFactExtractor, InMemoryStore } from 'agentfootprint/memory';
  *
  * // Cheap default — regex heuristics, no LLM cost.
  * const pipeline = factPipeline({ store: new InMemoryStore() });
  *
- * // Or opt into LLM-backed extraction:
+ * // Or opt into LLM-backed extraction (pass any LLMProvider):
  * const hqPipeline = factPipeline({
  *   store: new InMemoryStore(),
- *   extractor: llmFactExtractor({ provider: anthropic('claude-haiku-4-5') }),
+ *   extractor: llmFactExtractor({ provider: yourLLMProvider }),
  * });
- *
- * const agent = Agent.create({ provider: anthropic('claude-sonnet-4-5') })
- *   .system('You remember facts about the user across turns.')
- *   .memoryPipeline(pipeline)
- *   .build();
  * ```
  */
 const footprintjs_1 = require("footprintjs");

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

@@ -1 +1 @@
-{"version":3,"file":"fact.js","sourceRoot":"","sources":["../../../src/memory/pipeline/fact.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,6CAAwC;AAKxC,wDAI+B;AAC/B,oDAAiD;AACjD,kDAAqE;AACrE,sDAA2E;AAC3E,wEAAqE;AAgCrE,SAAgB,YAAY,CAAC,MAA0B;IACrD,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,IAAA,2CAAoB,GAAE,CAAC;IAE7D,MAAM,UAAU,GAAoB;QAClC,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,GAAG,CAAC,MAAM,CAAC,SAAS,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC;QAClE,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;KAC7C,CAAC;IACF,MAAM,YAAY,GAAsB;QACtC,GAAG,CAAC,MAAM,CAAC,YAAY,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC;QACzE,GAAG,CAAC,MAAM,CAAC,YAAY,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC;QACzE,GAAG,CAAC,MAAM,CAAC,oBAAoB,KAAK,SAAS,IAAI;YAC/C,cAAc,EAAE,MAAM,CAAC,oBAAoB;SAC5C,CAAC;KACH,CAAC;IACF,MAAM,aAAa,GAAuB;QACxC,SAAS;QACT,GAAG,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC;QACnD,GAAG,CAAC,MAAM,CAAC,UAAU,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC;KACrE,CAAC;IAEF,2CAA2C;IAC3C,MAAM,IAAI,GAAG,IAAA,uBAAS,EACpB,WAAW,EACX,IAAA,qBAAS,EAAC,UAAU,CAAC,EACrB,YAAY,EACZ,SAAS,EACT,6EAA6E,CAC9E;SACE,WAAW,CACV,aAAa,EACb,IAAA,yBAAW,EAAC,YAAY,CAAC,EACzB,cAAc,EACd,mEAAmE,CACpE;SACA,KAAK,EAAE,CAAC;IAEX,0DAA0D;IAC1D,iEAAiE;IACjE,gCAAgC;IAChC,MAAM,KAAK,GAAG,IAAA,uBAAS,EACrB,WAAW,EACX,IAAA,qBAAS,EAAC,UAAU,CAAC,EACrB,wBAAwB,EACxB,SAAS,EACT,8DAA8D,CAC/D;SACE,WAAW,CACV,cAAc,EACd,IAAA,2BAAY,EAAC,aAAa,CAAC,EAC3B,eAAe,EACf,6CAA6C,CAC9C;SACA,WAAW,CACV,YAAY,EACZ,IAAA,uBAAU,EAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,EACnC,aAAa,EACb,8EAA8E,CAC/E;SACA,KAAK,EAAE,CAAC;IAEX,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AACzB,CAAC;AA9DD,oCA8DC"}
+{"version":3,"file":"fact.js","sourceRoot":"","sources":["../../../src/memory/pipeline/fact.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,6CAAwC;AAKxC,wDAI+B;AAC/B,oDAAiD;AACjD,kDAAqE;AACrE,sDAA2E;AAC3E,wEAAqE;AAgCrE,SAAgB,YAAY,CAAC,MAA0B;IACrD,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,IAAA,2CAAoB,GAAE,CAAC;IAE7D,MAAM,UAAU,GAAoB;QAClC,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,GAAG,CAAC,MAAM,CAAC,SAAS,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC;QAClE,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;KAC7C,CAAC;IACF,MAAM,YAAY,GAAsB;QACtC,GAAG,CAAC,MAAM,CAAC,YAAY,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC;QACzE,GAAG,CAAC,MAAM,CAAC,YAAY,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC;QACzE,GAAG,CAAC,MAAM,CAAC,oBAAoB,KAAK,SAAS,IAAI;YAC/C,cAAc,EAAE,MAAM,CAAC,oBAAoB;SAC5C,CAAC;KACH,CAAC;IACF,MAAM,aAAa,GAAuB;QACxC,SAAS;QACT,GAAG,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC;QACnD,GAAG,CAAC,MAAM,CAAC,UAAU,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC;KACrE,CAAC;IAEF,2CAA2C;IAC3C,MAAM,IAAI,GAAG,IAAA,uBAAS,EACpB,WAAW,EACX,IAAA,qBAAS,EAAC,UAAU,CAAC,EACrB,YAAY,EACZ,SAAS,EACT,6EAA6E,CAC9E;SACE,WAAW,CACV,aAAa,EACb,IAAA,yBAAW,EAAC,YAAY,CAAC,EACzB,cAAc,EACd,mEAAmE,CACpE;SACA,KAAK,EAAE,CAAC;IAEX,0DAA0D;IAC1D,iEAAiE;IACjE,gCAAgC;IAChC,MAAM,KAAK,GAAG,IAAA,uBAAS,EACrB,WAAW,EACX,IAAA,qBAAS,EAAC,UAAU,CAAC,EACrB,wBAAwB,EACxB,SAAS,EACT,8DAA8D,CAC/D;SACE,WAAW,CACV,cAAc,EACd,IAAA,2BAAY,EAAC,aAAa,CAAC,EAC3B,eAAe,EACf,6CAA6C,CAC9C;SACA,WAAW,CACV,YAAY,EACZ,IAAA,uBAAU,EAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,EACnC,aAAa,EACb,8EAA8E,CAC/E;SACA,KAAK,EAAE,CAAC;IAEX,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AACzB,CAAC;AA9DD,oCA8DC"}

package/dist/memory/pipeline/narrative.js

@@ -28,23 +28,22 @@ exports.narrativePipeline = void 0;
  * when you want semantic quality.
  *
  * @example
+ * Most consumers reach for `narrativePipeline` indirectly through
+ * `defineMemory({ type: MEMORY_TYPES.NARRATIVE, strategy: { kind:
+ * MEMORY_STRATEGIES.EXTRACT, extractor: 'pattern' | 'llm' }, store })`.
+ *
+ * @example Direct usage (low-level — custom flowchart composition):
  * ```ts
- * import { Agent, anthropic } from 'agentfootprint';
- * import { narrativePipeline, InMemoryStore, llmExtractor } from 'agentfootprint/memory';
+ * import { narrativePipeline, llmExtractor, InMemoryStore } from 'agentfootprint/memory';
  *
  * // Cheap default — heuristic beats, no LLM cost.
  * const pipeline = narrativePipeline({ store: new InMemoryStore() });
  *
- * // Or opt into LLM-backed beats:
+ * // Or opt into LLM-backed beats (pass any LLMProvider):
  * const pipelineHQ = narrativePipeline({
  *   store: new InMemoryStore(),
- *   extractor: llmExtractor({ provider: anthropic('claude-haiku-4-5') }),
+ *   extractor: llmExtractor({ provider: yourLLMProvider }),
  * });
- *
- * 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");
@@ -56,7 +55,7 @@ const formatAsNarrative_1 = require("../beats/formatAsNarrative");
 const heuristicExtractor_1 = require("../beats/heuristicExtractor");
 /**
  * Build the narrative read + write pipelines sharing a single store.
- * Returns `{ read, write }` ready to be passed to `.memoryPipeline()`.
+ * Returns `{ read, write }` ready to be passed to `Agent.memory()` via the appropriate `defineMemory` config (or used directly via `mountMemoryRead`/`mountMemoryWrite`).
  */
 function narrativePipeline(config) {
     const extractor = config.extractor ?? (0, heuristicExtractor_1.heuristicExtractor)();

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

@@ -1 +1 @@
-{"version":3,"file":"narrative.js","sourceRoot":"","sources":["../../../src/memory/pipeline/narrative.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,6CAAwC;AAExC,qDAAyE;AACzE,yDAA+E;AAK/E,wDAI+B;AAC/B,oDAAiD;AACjD,kEAA6F;AAC7F,oEAAiE;AAsCjE;;;GAGG;AACH,SAAgB,iBAAiB,CAAC,MAA+B;IAC/D,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,IAAA,uCAAkB,GAAE,CAAC;IAE3D,MAAM,UAAU,GAAqB;QACnC,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,GAAG,CAAC,MAAM,CAAC,SAAS,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC;QAClE,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;KAC7C,CAAC;IACF,MAAM,UAAU,GAAuB;QACrC,GAAG,CAAC,MAAM,CAAC,aAAa,KAAK,SAAS,IAAI,EAAE,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,CAAC;QAClF,GAAG,CAAC,MAAM,CAAC,aAAa,KAAK,SAAS,IAAI,EAAE,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,CAAC;QAClF,GAAG,CAAC,MAAM,CAAC,UAAU,KAAK,SAAS,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC;KAC1E,CAAC;IACF,MAAM,YAAY,GAA4B;QAC5C,GAAG,CAAC,MAAM,CAAC,YAAY,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC;QACzE,GAAG,CAAC,MAAM,CAAC,YAAY,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC;QACzE,GAAG,CAAC,MAAM,CAAC,cAAc,KAAK,SAAS,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,cAAc,EAAE,CAAC;QAC/E,GAAG,CAAC,MAAM,CAAC,YAAY,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC;KAC1E,CAAC;IACF,MAAM,aAAa,GAAuB;QACxC,SAAS;QACT,GAAG,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC;QACnD,GAAG,CAAC,MAAM,CAAC,UAAU,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC;KACrE,CAAC;IAEF,wFAAwF;IACxF,IAAI,WAAW,GAAG,IAAA,uBAAS,EACzB,YAAY,EACZ,IAAA,uBAAU,EAAC,UAAU,CAAC,EACtB,aAAa,EACb,SAAS,EACT,yDAAyD,CAC1D,CAAC;IACF,WAAW,GAAG,IAAA,2BAAY,EAAC,UAAU,CAAC,CAAC,WAAW,CAAC,CAAC;IACpD,MAAM,IAAI,GAAG,WAAW;SACrB,WAAW,CACV,QAAQ,EACR,IAAA,qCAAiB,EAAC,YAAY,CAAC,EAC/B,qBAAqB,EACrB,uEAAuE,CACxE;SACA,KAAK,EAAE,CAAC;IAEX,8CAA8C;IAC9C,MAAM,KAAK,GAAG,IAAA,uBAAS,EACrB,cAAc,EACd,IAAA,2BAAY,EAAC,aAAa,CAAC,EAC3B,eAAe,EACf,SAAS,EACT,uDAAuD,CACxD;SACE,WAAW,CACV,YAAY,EACZ,IAAA,uBAAU,EAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,EACnC,aAAa,EACb,iDAAiD,CAClD;SACA,KAAK,EAAE,CAAC;IAEX,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AACzB,CAAC;AA5DD,8CA4DC"}
+{"version":3,"file":"narrative.js","sourceRoot":"","sources":["../../../src/memory/pipeline/narrative.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,6CAAwC;AAExC,qDAAyE;AACzE,yDAA+E;AAK/E,wDAI+B;AAC/B,oDAAiD;AACjD,kEAA6F;AAC7F,oEAAiE;AAsCjE;;;GAGG;AACH,SAAgB,iBAAiB,CAAC,MAA+B;IAC/D,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,IAAA,uCAAkB,GAAE,CAAC;IAE3D,MAAM,UAAU,GAAqB;QACnC,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,GAAG,CAAC,MAAM,CAAC,SAAS,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC;QAClE,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;KAC7C,CAAC;IACF,MAAM,UAAU,GAAuB;QACrC,GAAG,CAAC,MAAM,CAAC,aAAa,KAAK,SAAS,IAAI,EAAE,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,CAAC;QAClF,GAAG,CAAC,MAAM,CAAC,aAAa,KAAK,SAAS,IAAI,EAAE,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,CAAC;QAClF,GAAG,CAAC,MAAM,CAAC,UAAU,KAAK,SAAS,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC;KAC1E,CAAC;IACF,MAAM,YAAY,GAA4B;QAC5C,GAAG,CAAC,MAAM,CAAC,YAAY,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC;QACzE,GAAG,CAAC,MAAM,CAAC,YAAY,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC;QACzE,GAAG,CAAC,MAAM,CAAC,cAAc,KAAK,SAAS,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,cAAc,EAAE,CAAC;QAC/E,GAAG,CAAC,MAAM,CAAC,YAAY,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC;KAC1E,CAAC;IACF,MAAM,aAAa,GAAuB;QACxC,SAAS;QACT,GAAG,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC;QACnD,GAAG,CAAC,MAAM,CAAC,UAAU,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC;KACrE,CAAC;IAEF,wFAAwF;IACxF,IAAI,WAAW,GAAG,IAAA,uBAAS,EACzB,YAAY,EACZ,IAAA,uBAAU,EAAC,UAAU,CAAC,EACtB,aAAa,EACb,SAAS,EACT,yDAAyD,CAC1D,CAAC;IACF,WAAW,GAAG,IAAA,2BAAY,EAAC,UAAU,CAAC,CAAC,WAAW,CAAC,CAAC;IACpD,MAAM,IAAI,GAAG,WAAW;SACrB,WAAW,CACV,QAAQ,EACR,IAAA,qCAAiB,EAAC,YAAY,CAAC,EAC/B,qBAAqB,EACrB,uEAAuE,CACxE;SACA,KAAK,EAAE,CAAC;IAEX,8CAA8C;IAC9C,MAAM,KAAK,GAAG,IAAA,uBAAS,EACrB,cAAc,EACd,IAAA,2BAAY,EAAC,aAAa,CAAC,EAC3B,eAAe,EACf,SAAS,EACT,uDAAuD,CACxD;SACE,WAAW,CACV,YAAY,EACZ,IAAA,uBAAU,EAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,EACnC,aAAa,EACb,iDAAiD,CAClD;SACA,KAAK,EAAE,CAAC;IAEX,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AACzB,CAAC;AA5DD,8CA4DC"}

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":";;;AAiEA,MAAM,cAAc,GAClB,uFAAuF,CAAC;AAE1F;;;;;;;;GAQG;AACH,SAAS,eAAe,CAAC,IAAY;IACnC,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,iBAAiB,CAAC,CAAC;AACzD,CAAC;AAED,SAAS,kBAAkB,CAAC,KAA2B;IACrD,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC;IACxB,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,KAAK,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACxF,MAAM,WAAW,GACf,KAAK,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,aAAa,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAE/F,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC;IAE/B,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,IAAI,SAAS,CAAC;IACnC,OAAO,iBAAiB,IAAI,IAAI,QAAQ,GAAG,WAAW,MAAM,eAAe,CAAC,IAAI,CAAC,aAAa,CAAC;AACjG,CAAC;AAED,SAAgB,aAAa,CAAC,SAA8B,EAAE;IAC5D,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,cAAc,CAAC;IAC/C,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC;IACnC,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,kBAAkB,CAAC;IAC7D,MAAM,aAAa,GAAG,MAAM,CAAC,aAAa,IAAI,KAAK,CAAC;IAEpD,OAAO,KAAK,EAAE,KAA8B,EAAiB,EAAE;QAC7D,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC;QAEtC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YAC5C,KAAK,CAAC,SAAS,GAAG,EAAE,CAAC;YACrB,OAAO;QACT,CAAC;QAED,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACtD,MAAM,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAE3F,KAAK,CAAC,SAAS,GAAG,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QAEhD,8DAA8D;QAC9D,iEAAiE;QACjE,+DAA+D;QAC/D,gEAAgE;QAChE,yBAAyB;QACzB,IAAI,OAAQ,KAAwC,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;YAC1E,KAAK,CAAC,KAAK,CAAC,wCAAwC,EAAE;gBACpD,IAAI,EAAE,UAAU;gBAChB,mEAAmE;gBACnE,gEAAgE;gBAChE,gEAAgE;gBAChE,yCAAyC;gBACzC,IAAI,EAAE,QAAiB;gBACvB,UAAU,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE;gBACzB,KAAK,EAAE,QAAQ,CAAC,MAAM;gBACtB,0EAA0E;gBAC1E,iDAAiD;gBACjD,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;aACxE,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAxCD,sCAwCC"}

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"}