agentfootprint 1.22.0 → 2.0.1

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

@@ -0,0 +1,284 @@
+/**
+ * Memory subsystem — public type surface.
+ *
+ * THE 2D mental model the library teaches:
+ *
+ *     MEMORY = TYPE × STRATEGY × STORE
+ *
+ *     TYPE       — what shape of memory you're keeping
+ *                  (Episodic messages / Semantic facts / Narrative beats /
+ *                   Causal footprintjs snapshots)
+ *     STRATEGY   — how to fit content into the next LLM call
+ *                  (Window / Budget / Summarize / TopK / Extract / Decay / Hybrid)
+ *     STORE      — where the bytes live
+ *                  (InMemoryStore / Redis / Postgres / DynamoDB / Vector ...)
+ *
+ * Strategy is universal — same Window works for Episodic and for Causal.
+ * That's why examples are organized by strategy (the discipline) not by
+ * type (the shape).
+ *
+ * Pattern: Single-Source-of-Truth const objects + discriminated union.
+ *          Mirrors `src/conventions.ts` (SUBFLOW_IDS, INJECTION_KEYS).
+ *          NEVER enums (TS enums emit runtime objects + opacity).
+ *          Const-as-const erases at compile time, accepts string literals,
+ *          and gives consumers IDE autocomplete + refactor safety.
+ *
+ * Role:    Layer-1 contract for the memory subsystem. Step 2's
+ *          `defineMemory()` factory consumes these to build pipelines;
+ *          Step 4's `Agent.memory()` builder mounts the resulting
+ *          definitions; Step 5's Causal machinery extends them.
+ *
+ * Emits:   Indirectly — every memory pipeline emits the unified
+ *          `agentfootprint.context.injected` event with `source: 'memory'`
+ *          when its read subflow places content into the messages slot.
+ *
+ * 8-panel review (2026-04-28):
+ * - LLM Systems   ✅  asRole knob added so memories can land as user/system/assistant
+ * - Architect     ✅  per-id scope keys (`memoryInjection_${id}`) — multi-memory layering safe
+ * - API Designer  ✅  ONE factory for all four types incl. Causal (no separate `snapshotMemory`)
+ * - Performance   ✅  default `MEMORY_TIMING.TURN_START` (was per-iteration — perf trap)
+ * - Privacy       ✅  `redact?` API hook reserved
+ * - ML / IR       ✅  causal snapshots tagged with original query for retrieval embedding
+ * - SoftEng       ✅  discriminated union with `kind` discriminator → full TS narrowing
+ * - TS Engineer   ✅  generic over `MemoryEntry<T>` payload preserves type-safety
+ *
+ * @see ./define.ts          for the `defineMemory()` factory itself
+ * @see ../../docs-site      for guides + the 7 strategy examples
+ * @see MEMORY.md            for the load-bearing design memory
+ */
+import type { LLMProvider } from '../adapters/types.js';
+import type { ContextRole } from '../events/types.js';
+import type { Embedder } from './embedding/index.js';
+import type { MemoryStore } from './store/index.js';
+/**
+ * What shape of memory you're keeping.
+ *
+ * - `EPISODIC`  — raw conversation messages, replayed on next turn
+ * - `SEMANTIC`  — extracted structured facts, deduped on key
+ * - `NARRATIVE` — beats / summaries of prior runs (append-only)
+ * - `CAUSAL`    — footprintjs execution snapshots, the differentiator
+ *                 (zero-hallucination follow-ups via decision-evidence replay)
+ */
+export declare const MEMORY_TYPES: {
+    readonly EPISODIC: "episodic";
+    readonly SEMANTIC: "semantic";
+    readonly NARRATIVE: "narrative";
+    readonly CAUSAL: "causal";
+};
+export type MemoryType = (typeof MEMORY_TYPES)[keyof typeof MEMORY_TYPES];
+/**
+ * How content is selected / compressed for the next LLM call.
+ *
+ * Universal across types. A `WINDOW` strategy on an Episodic store keeps
+ * the last N messages; on a Causal store it keeps the last N snapshots.
+ * Mix and match.
+ */
+export declare const MEMORY_STRATEGIES: {
+    readonly WINDOW: "window";
+    readonly BUDGET: "budget";
+    readonly SUMMARIZE: "summarize";
+    readonly TOP_K: "topK";
+    readonly EXTRACT: "extract";
+    readonly DECAY: "decay";
+    readonly HYBRID: "hybrid";
+};
+export type MemoryStrategyKind = (typeof MEMORY_STRATEGIES)[keyof typeof MEMORY_STRATEGIES];
+/**
+ * When the memory's READ subflow runs.
+ *
+ * Default `TURN_START` reads memory once per `agent.run()`. Use
+ * `EVERY_ITERATION` only when the strategy is sensitive to in-loop tool
+ * results — every-iteration multiplies store-latency by iteration-count.
+ */
+export declare const MEMORY_TIMING: {
+    readonly EVERY_ITERATION: "every-iteration";
+    readonly TURN_START: "turn-start";
+};
+export type MemoryTiming = (typeof MEMORY_TIMING)[keyof typeof MEMORY_TIMING];
+/**
+ * For Causal memory only — which slice of a footprintjs snapshot to
+ * inject. Snapshots can run 100KB+; projecting prevents context blowup.
+ *
+ * - `DECISIONS` — `decide()`/`select()` evidence only (the "why" chain)
+ * - `COMMITS`   — commitLog only (every state write, ordered)
+ * - `NARRATIVE` — narrative entries only (human-readable trace)
+ * - `FULL`      — entire snapshot (use sparingly)
+ */
+export declare const SNAPSHOT_PROJECTIONS: {
+    readonly DECISIONS: "decisions";
+    readonly COMMITS: "commits";
+    readonly NARRATIVE: "narrative";
+    readonly FULL: "full";
+};
+export type SnapshotProjection = (typeof SNAPSHOT_PROJECTIONS)[keyof typeof SNAPSHOT_PROJECTIONS];
+/** Window — keep the last `size` entries. Pure rule, no LLM, no embedder. */
+export interface WindowStrategy {
+    readonly kind: typeof MEMORY_STRATEGIES.WINDOW;
+    readonly size: number;
+}
+/**
+ * Budget — pick entries that fit within a token budget. Used as a
+ * decider stage: skip-if-empty | skip-if-no-budget | pick-by-tokens.
+ */
+export interface BudgetStrategy {
+    readonly kind: typeof MEMORY_STRATEGIES.BUDGET;
+    /** Reserve N tokens for prompt headers / new user message. Default 256. */
+    readonly reserveTokens?: number;
+    /** Skip injection below this token floor. Default 100. */
+    readonly minimumTokens?: number;
+    /** Hard cap on entries to inject — guards against "lost-in-the-middle". */
+    readonly maxEntries?: number;
+}
+/**
+ * Summarize — when the conversation grows long, an LLM compresses older
+ * turns into a paragraph; recent N turns stay raw. The standard answer
+ * to "long conversations blow context."
+ */
+export interface SummarizeStrategy {
+    readonly kind: typeof MEMORY_STRATEGIES.SUMMARIZE;
+    /** Keep this many most-recent turns uncompressed. */
+    readonly recent: number;
+    /** LLM that does the compression — recommend a cheap model (haiku). */
+    readonly llm: LLMProvider;
+}
+/**
+ * Top-K — embed the user's query, retrieve top-K by cosine similarity.
+ * STRICT threshold: when no entry meets the threshold, return EMPTY.
+ * No fallback — garbage in context is worse than no memory.
+ */
+export interface TopKStrategy {
+    readonly kind: typeof MEMORY_STRATEGIES.TOP_K;
+    readonly topK: number;
+    /** Min cosine similarity. Strict — no fallback below this. Default 0.7. */
+    readonly threshold?: number;
+    readonly embedder: Embedder;
+}
+/**
+ * Extract — on WRITE, an LLM (or pattern matcher) distills entries from
+ * raw messages into structured shapes (facts/beats). Usually paired with
+ * a load-side strategy like TopK or Window for the read direction.
+ */
+export interface ExtractStrategy {
+    readonly kind: typeof MEMORY_STRATEGIES.EXTRACT;
+    /** Pattern-based (regex heuristics, free) or LLM-based (paid). */
+    readonly extractor: 'pattern' | 'llm';
+    /** Required when `extractor: 'llm'`. */
+    readonly llm?: LLMProvider;
+    /** Discard extractions below this confidence. Default 0.7. */
+    readonly minConfidence?: number;
+    /** Cap entries extracted per turn. Default 5. */
+    readonly maxPerTurn?: number;
+}
+/**
+ * Decay — score entries by `recency × accessCount`, drop below floor.
+ * For long-running agents where unused memory should fade.
+ */
+export interface DecayStrategy {
+    readonly kind: typeof MEMORY_STRATEGIES.DECAY;
+    /** Half-life in milliseconds for the recency component. */
+    readonly halfLifeMs: number;
+    /** Drop entries scoring below this. Default 0.1. */
+    readonly minScore?: number;
+}
+/**
+ * Hybrid — compose multiple strategies. Each sub-strategy runs as its
+ * own selector branch; results are merged in the order listed.
+ */
+export interface HybridStrategy {
+    readonly kind: typeof MEMORY_STRATEGIES.HYBRID;
+    readonly strategies: ReadonlyArray<Exclude<Strategy, HybridStrategy>>;
+}
+/** The full strategy union — discriminated by `kind`. */
+export type Strategy = WindowStrategy | BudgetStrategy | SummarizeStrategy | TopKStrategy | ExtractStrategy | DecayStrategy | HybridStrategy;
+/**
+ * Reserved API surface for content redaction before memory writes.
+ * Impl is deferred; the field exists now so adding redaction later
+ * is non-breaking. Privacy panel review: snapshot/episodic writes may
+ * carry PII — this is the integration point.
+ */
+export interface MemoryRedactionPolicy {
+    /** Patterns to mask in stored content. */
+    readonly patterns?: readonly RegExp[];
+    /** Replacement string. Default `'[REDACTED]'`. */
+    readonly replacement?: string;
+}
+/**
+ * The opaque value `defineMemory()` returns. `Agent.memory()` consumes
+ * one of these per memory the consumer registers; multiple definitions
+ * layer cleanly via per-id scope keys (`memoryInjection_${id}`).
+ *
+ * Generic `T` is the payload shape stored — `Message` for episodic,
+ * `Fact` for semantic, `NarrativeBeat` for narrative, `RunSnapshot` for
+ * causal. The factory infers `T` from `type`.
+ */
+export interface MemoryDefinition<T = unknown> {
+    /** Stable identifier. Becomes the scope-key suffix and the Lens label. */
+    readonly id: string;
+    /** Surfaces in narrative / Lens hover. */
+    readonly description?: string;
+    /** Which TYPE shape — gates legal STRATEGY combinations. */
+    readonly type: MemoryType;
+    /** Compiled read subflow (built by the factory from type × strategy). */
+    readonly read: ReadonlyMemoryFlowChart<T>;
+    /** Compiled write subflow. Optional — `EPHEMERAL`-style configs omit. */
+    readonly write?: ReadonlyMemoryFlowChart<T>;
+    /** When `read` runs. Default `TURN_START`. */
+    readonly timing: MemoryTiming;
+    /** Role to use when injecting formatted content into the messages slot. */
+    readonly asRole: ContextRole;
+    /** Reserved for a future release — patterns to redact before write. */
+    readonly redact?: MemoryRedactionPolicy;
+    /** Snapshot projection — only meaningful when `type === CAUSAL`. */
+    readonly projection?: SnapshotProjection;
+}
+/**
+ * Opaque tag for the compiled flowchart the factory hands back.
+ * The actual type is `FlowChart<MemoryState>` from footprintjs but we
+ * keep it nominal here so consumers can't reach in.
+ */
+export type ReadonlyMemoryFlowChart<_T> = {
+    readonly __brand: 'ReadonlyMemoryFlowChart';
+};
+/**
+ * Common options for every memory type. Type-specific options layer on
+ * top via discriminated `type` field in the next overload set (Step 2).
+ */
+export interface DefineMemoryOptionsBase {
+    readonly id: string;
+    readonly description?: string;
+    readonly store: MemoryStore;
+    readonly strategy: Strategy;
+    readonly timing?: MemoryTiming;
+    readonly asRole?: ContextRole;
+    readonly redact?: MemoryRedactionPolicy;
+}
+export interface DefineEpisodicOptions extends DefineMemoryOptionsBase {
+    readonly type: typeof MEMORY_TYPES.EPISODIC;
+}
+export interface DefineSemanticOptions extends DefineMemoryOptionsBase {
+    readonly type: typeof MEMORY_TYPES.SEMANTIC;
+}
+export interface DefineNarrativeOptions extends DefineMemoryOptionsBase {
+    readonly type: typeof MEMORY_TYPES.NARRATIVE;
+}
+export interface DefineCausalOptions extends DefineMemoryOptionsBase {
+    readonly type: typeof MEMORY_TYPES.CAUSAL;
+    /** Slice of the snapshot to inject. Default `DECISIONS`. */
+    readonly projection?: SnapshotProjection;
+}
+/** Discriminated by `type`. The factory uses this to pick the pipeline. */
+export type DefineMemoryOptions = DefineEpisodicOptions | DefineSemanticOptions | DefineNarrativeOptions | DefineCausalOptions;
+export declare function isMemoryType(value: string): value is MemoryType;
+export declare function isMemoryStrategyKind(value: string): value is MemoryStrategyKind;
+export declare function isMemoryTiming(value: string): value is MemoryTiming;
+export declare function isSnapshotProjection(value: string): value is SnapshotProjection;
+/**
+ * Scope-key prefix used when mounting multiple `.memory()` definitions
+ * on the same Agent. Each memory writes to `memoryInjection_${id}` so
+ * registrations never collide. Formatter merges all keys with this
+ * prefix in registration order.
+ */
+export declare const MEMORY_INJECTION_KEY_PREFIX: "memoryInjection_";
+export declare function memoryInjectionKey(id: string): string;
+export declare function isMemoryInjectionKey(key: string): boolean;
+//# sourceMappingURL=define.types.d.ts.map

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

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

package/dist/types/memory/embedding/embedMessages.d.ts

@@ -20,7 +20,7 @@
  */
 import type { TypedScope } from 'footprintjs';
 import type { Embedder } from './types';
-import type { Message } from '../../types/messages';
+import type { LLMMessage as Message } from '../../adapters/types';
 import type { MemoryState } from '../stages';
 /** Extend MemoryState to carry per-message embeddings for writeMessages. */
 export interface EmbedMessagesState extends MemoryState {

package/dist/types/memory/embedding/embedMessages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"embedMessages.d.ts","sourceRoot":"","sources":["../../../../src/memory/embedding/embedMessages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7C,4EAA4E;AAC5E,MAAM,WAAW,kBAAmB,SAAQ,WAAW;IACrD;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,CAAC;IAEtD,mFAAmF;IACnF,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,mBAAmB;IAClC,yEAAyE;IACzE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAE5B;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAE7B;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,CAAC;CAClD;AAmBD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,mBAAmB,WAIlC,WAAW,kBAAkB,CAAC,KAAG,QAAQ,IAAI,CAAC,CA6BpE"}
+{"version":3,"file":"embedMessages.d.ts","sourceRoot":"","sources":["../../../../src/memory/embedding/embedMessages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7C,4EAA4E;AAC5E,MAAM,WAAW,kBAAmB,SAAQ,WAAW;IACrD;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,CAAC;IAEtD,mFAAmF;IACnF,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,mBAAmB;IAClC,yEAAyE;IACzE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAE5B;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAE7B;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,CAAC;CAClD;AAOD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,mBAAmB,WAIlC,WAAW,kBAAkB,CAAC,KAAG,QAAQ,IAAI,CAAC,CA6BpE"}

package/dist/types/memory/embedding/loadRelevant.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loadRelevant.d.ts","sourceRoot":"","sources":["../../../../src/memory/embedding/loadRelevant.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,MAAM,WAAW,kBAAkB;IACjC,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAE5B,0DAA0D;IAC1D,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAE5B;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAE7B,4EAA4E;IAC5E,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC;IAEpB,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAE3B,8BAA8B;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC;IAExD;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC,KAAK,MAAM,CAAC;CACjE;AAkCD,wBAAgB,YAAY,CAAC,MAAM,EAAE,kBAAkB,WAWhC,WAAW,WAAW,CAAC,KAAG,QAAQ,IAAI,CAAC,CAyB7D"}
+{"version":3,"file":"loadRelevant.d.ts","sourceRoot":"","sources":["../../../../src/memory/embedding/loadRelevant.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,MAAM,WAAW,kBAAkB;IACjC,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAE5B,0DAA0D;IAC1D,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAE5B;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAE7B,4EAA4E;IAC5E,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC;IAEpB,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAE3B,8BAA8B;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC;IAExD;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC,KAAK,MAAM,CAAC;CACjE;AAwBD,wBAAgB,YAAY,CAAC,MAAM,EAAE,kBAAkB,WAWhC,WAAW,WAAW,CAAC,KAAG,QAAQ,IAAI,CAAC,CAyB7D"}

package/dist/types/memory/facts/extractor.d.ts

@@ -12,7 +12,7 @@
  *   - `llmFactExtractor({ provider })` — one LLM call per turn for
  *     open-ended extraction. Opt-in.
  */
-import type { Message } from '../../types/messages';
+import type { LLMMessage as Message } from '../../adapters/types';
 import type { Fact } from './types';
 export interface FactExtractArgs {
     /** New-turn messages. */

package/dist/types/memory/facts/extractor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extractor.d.ts","sourceRoot":"","sources":["../../../../src/memory/facts/extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAEpC,MAAM,WAAW,eAAe;IAC9B,yBAAyB;IACzB,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;IAEtC,+EAA+E;IAC/E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,IAAI,EAAE,CAAC;IAEpC,sDAAsD;IACtD,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;CAC1D"}
+{"version":3,"file":"extractor.d.ts","sourceRoot":"","sources":["../../../../src/memory/facts/extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,UAAU,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAEpC,MAAM,WAAW,eAAe;IAC9B,yBAAyB;IACzB,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;IAEtC,+EAA+E;IAC/E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,IAAI,EAAE,CAAC;IAEpC,sDAAsD;IACtD,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;CAC1D"}

package/dist/types/memory/facts/llmFactExtractor.d.ts

@@ -34,11 +34,11 @@
  *
  * const pipeline = factPipeline({
  *   store: new InMemoryStore(),
- *   extractor: llmFactExtractor({ provider: anthropic('claude-haiku-4-5') }),
+ *   extractor: llmFactExtractor({ provider: yourLLMProvider }),
  * });
  * ```
  */
-import type { LLMProvider } from '../../types';
+import type { LLMProvider } from '../../adapters/types';
 import type { FactExtractor } from './extractor';
 export interface LLMFactExtractorConfig {
     /** The provider used for extraction. Typically a cheap/fast model. */

package/dist/types/memory/facts/llmFactExtractor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"llmFactExtractor.d.ts","sourceRoot":"","sources":["../../../../src/memory/facts/llmFactExtractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,OAAO,KAAK,EAAE,WAAW,EAAW,MAAM,aAAa,CAAC;AACxD,OAAO,KAAK,EAAmB,aAAa,EAAE,MAAM,aAAa,CAAC;AAIlE,MAAM,WAAW,sBAAsB;IACrC,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAE/B;;;OAGG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAE/B;;;;OAIG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IAErE;;;;OAIG;IACH,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;CACxC;AAiHD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,GAAG,aAAa,CA+B9E"}
+{"version":3,"file":"llmFactExtractor.d.ts","sourceRoot":"","sources":["../../../../src/memory/facts/llmFactExtractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,OAAO,KAAK,EAAE,WAAW,EAAyB,MAAM,sBAAsB,CAAC;AAC/E,OAAO,KAAK,EAAmB,aAAa,EAAE,MAAM,aAAa,CAAC;AAIlE,MAAM,WAAW,sBAAsB;IACrC,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAE/B;;;OAGG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAE/B;;;;OAIG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IAErE;;;;OAIG;IACH,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;CACxC;AAkGD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,GAAG,aAAa,CA8B9E"}

package/dist/types/memory/facts/patternFactExtractor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"patternFactExtractor.d.ts","sourceRoot":"","sources":["../../../../src/memory/facts/patternFactExtractor.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAmB,aAAa,EAAE,MAAM,aAAa,CAAC;AAuFlE,wBAAgB,oBAAoB,IAAI,aAAa,CAmCpD"}
+{"version":3,"file":"patternFactExtractor.d.ts","sourceRoot":"","sources":["../../../../src/memory/facts/patternFactExtractor.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAmB,aAAa,EAAE,MAAM,aAAa,CAAC;AA2ElE,wBAAgB,oBAAoB,IAAI,aAAa,CAmCpD"}

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

@@ -1,2 +1,20 @@
-export { appendMessage, lastMessage, lastAssistantMessage, lastMessageHasToolCalls, createToolResults, } from './conversationHelpers';
+/**
+ * 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.
+ */
+export * from './beats/index.js';
+export * from './causal/index.js';
+export * from './embedding/index.js';
+export * from './entry/index.js';
+export * from './facts/index.js';
+export * from './identity/index.js';
+export * from './pipeline/index.js';
+export * from './stages/index.js';
+export * from './store/index.js';
+export * from './wire/index.js';
+export { MEMORY_TYPES, MEMORY_STRATEGIES, MEMORY_TIMING, SNAPSHOT_PROJECTIONS, MEMORY_INJECTION_KEY_PREFIX, isMemoryType, isMemoryStrategyKind, isMemoryTiming, isSnapshotProjection, memoryInjectionKey, isMemoryInjectionKey, type MemoryType, type MemoryStrategyKind, type MemoryTiming, type SnapshotProjection, type Strategy, type WindowStrategy, type BudgetStrategy, type SummarizeStrategy, type TopKStrategy, type ExtractStrategy, type DecayStrategy, type HybridStrategy, type MemoryDefinition, type DefineMemoryOptions, type DefineEpisodicOptions, type DefineSemanticOptions, type DefineNarrativeOptions, type DefineCausalOptions, type MemoryRedactionPolicy, } from './define.types.js';
+export { defineMemory } from './define.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,WAAW,EACX,oBAAoB,EACpB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/memory/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAGhC,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,oBAAoB,EACpB,2BAA2B,EAC3B,YAAY,EACZ,oBAAoB,EACpB,cAAc,EACd,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EACpB,KAAK,UAAU,EACf,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,QAAQ,EACb,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,GAC3B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

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

@@ -1,4 +1,4 @@
-import type { LLMProvider } from '../../types';
+import type { LLMProvider } from '../../adapters/types';
 import type { MemoryStore } from '../store';
 import type { MemoryEntry } from '../entry';
 import type { MemoryPipeline } from './types';

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

@@ -1 +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"}
+{"version":3,"file":"auto.d.ts","sourceRoot":"","sources":["../../../../src/memory/pipeline/auto.ts"],"names":[],"mappings":"AAqDA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,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/default.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"default.d.ts","sourceRoot":"","sources":["../../../../src/memory/pipeline/default.ts"],"names":[],"mappings":"AAkDA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,MAAM,WAAW,qBAAqB;IACpC,qCAAqC;IACrC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAE5B,6EAA6E;IAC7E,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAE5B;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAEhC,kFAAkF;IAClF,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAEhC;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAE7B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC;IAExD;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;IAE7C;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAE7B;;;OAGG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAE/B,gEAAgE;IAChE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,qBAAqB,GAAG,cAAc,CAqD7E"}
+{"version":3,"file":"default.d.ts","sourceRoot":"","sources":["../../../../src/memory/pipeline/default.ts"],"names":[],"mappings":"AAwDA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,MAAM,WAAW,qBAAqB;IACpC,qCAAqC;IACrC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAE5B,6EAA6E;IAC7E,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAE5B;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAEhC,kFAAkF;IAClF,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAEhC;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAE7B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC;IAExD;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;IAE7C;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAE7B;;;OAGG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAE/B,gEAAgE;IAChE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,qBAAqB,GAAG,cAAc,CAqD7E"}

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

@@ -1 +1 @@
-{"version":3,"file":"fact.d.ts","sourceRoot":"","sources":["../../../../src/memory/pipeline/fact.ts"],"names":[],"mappings":"AAkDA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAW9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,MAAM,WAAW,kBAAkB;IACjC,qCAAqC;IACrC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAE5B;;;;OAIG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,aAAa,CAAC;IAEnC,kEAAkE;IAClE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAE5B,6CAA6C;IAC7C,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC;IAExD,sCAAsC;IACtC,QAAQ,CAAC,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;IAE7C,2DAA2D;IAC3D,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAE7B,kCAAkC;IAClC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC;CACzC;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,CA8DvE"}
+{"version":3,"file":"fact.d.ts","sourceRoot":"","sources":["../../../../src/memory/pipeline/fact.ts"],"names":[],"mappings":"AAgDA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAW9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,MAAM,WAAW,kBAAkB;IACjC,qCAAqC;IACrC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAE5B;;;;OAIG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,aAAa,CAAC;IAEnC,kEAAkE;IAClE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAE5B,6CAA6C;IAC7C,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC;IAExD,sCAAsC;IACtC,QAAQ,CAAC,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;IAE7C,2DAA2D;IAC3D,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAE7B,kCAAkC;IAClC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC;CACzC;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,CA8DvE"}

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

@@ -30,7 +30,7 @@ export interface NarrativePipelineConfig {
 }
 /**
  * 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`).
  */
 export declare function narrativePipeline(config: NarrativePipelineConfig): MemoryPipeline;
 //# sourceMappingURL=narrative.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"narrative.d.ts","sourceRoot":"","sources":["../../../../src/memory/pipeline/narrative.ts"],"names":[],"mappings":"AAmDA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAU9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,MAAM,WAAW,uBAAuB;IACtC,qCAAqC;IACrC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAE5B;;;;OAIG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,aAAa,CAAC;IAEnC,uEAAuE;IACvE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAE5B,mCAAmC;IACnC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAE7B,6CAA6C;IAC7C,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC;IAExD,sCAAsC;IACtC,QAAQ,CAAC,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;IAE7C,2DAA2D;IAC3D,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAE7B,wCAAwC;IACxC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,uBAAuB,GAAG,cAAc,CA4DjF"}
+{"version":3,"file":"narrative.d.ts","sourceRoot":"","sources":["../../../../src/memory/pipeline/narrative.ts"],"names":[],"mappings":"AAkDA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAU9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,MAAM,WAAW,uBAAuB;IACtC,qCAAqC;IACrC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAE5B;;;;OAIG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,aAAa,CAAC;IAEnC,uEAAuE;IACvE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAE5B,mCAAmC;IACnC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAE7B,6CAA6C;IAC7C,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC;IAExD,sCAAsC;IACtC,QAAQ,CAAC,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;IAE7C,2DAA2D;IAC3D,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAE7B,wCAAwC;IACxC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,uBAAuB,GAAG,cAAc,CA4DjF"}

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

@@ -32,7 +32,7 @@ export interface SemanticPipelineConfig {
 }
 /**
  * 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`).
  */
 export declare function semanticPipeline(config: SemanticPipelineConfig): MemoryPipeline;
 //# sourceMappingURL=semantic.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"semantic.d.ts","sourceRoot":"","sources":["../../../../src/memory/pipeline/semantic.ts"],"names":[],"mappings":"AAgDA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAQ9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,MAAM,WAAW,sBAAsB;IACrC,uDAAuD;IACvD,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAE5B,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAE5B;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAE7B,8EAA8E;IAC9E,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC;IAEpB,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAE3B,iCAAiC;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC;IAExD,+BAA+B;IAC/B,QAAQ,CAAC,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;IAE7C,oDAAoD;IACpD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAE7B,mCAAmC;IACnC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAE7B,oCAAoC;IACpC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,GAAG,cAAc,CAsE/E"}
+{"version":3,"file":"semantic.d.ts","sourceRoot":"","sources":["../../../../src/memory/pipeline/semantic.ts"],"names":[],"mappings":"AA2CA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAQ9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,MAAM,WAAW,sBAAsB;IACrC,uDAAuD;IACvD,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAE5B,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAE5B;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAE7B,8EAA8E;IAC9E,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC;IAEpB,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAE3B,iCAAiC;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC;IAExD,+BAA+B;IAC/B,QAAQ,CAAC,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;IAE7C,oDAAoD;IACpD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAE7B,mCAAmC;IACnC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAE7B,oCAAoC;IACpC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,GAAG,cAAc,CAsE/E"}

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

@@ -8,7 +8,7 @@
  *
  * Having BOTH returned as a bundle keeps the two sides coupled to a
  * single store/config choice: you can't accidentally use
- * `.memoryPipeline(preset1.read)` with `preset2.write` and end up
+ * `.memory(definition)` with `preset2.write` and end up
  * writing to a different store than you read from.
  */
 import type { FlowChart } from 'footprintjs';

package/dist/types/memory/stages/formatDefault.d.ts

@@ -32,7 +32,7 @@
  */
 import type { TypedScope } from 'footprintjs';
 import type { MemoryEntry } from '../entry';
-import type { Message } from '../../types/messages';
+import type { LLMMessage as Message } from '../../adapters/types';
 import type { MemoryState } from './types';
 export interface FormatDefaultConfig {
     /**

package/dist/types/memory/stages/formatDefault.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"formatDefault.d.ts","sourceRoot":"","sources":["../../../../src/memory/stages/formatDefault.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,KAAK,MAAM,CAAC;IAC/D;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;CAClC;AA6CD,wBAAgB,aAAa,CAAC,MAAM,GAAE,mBAAwB,WAMvC,WAAW,WAAW,CAAC,KAAG,QAAQ,IAAI,CAAC,CAkC7D"}
+{"version":3,"file":"formatDefault.d.ts","sourceRoot":"","sources":["../../../../src/memory/stages/formatDefault.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,UAAU,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,KAAK,MAAM,CAAC;IAC/D;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;CAClC;AA8BD,wBAAgB,aAAa,CAAC,MAAM,GAAE,mBAAwB,WAMvC,WAAW,WAAW,CAAC,KAAG,QAAQ,IAAI,CAAC,CAkC7D"}

package/dist/types/memory/stages/summarize.d.ts

@@ -54,7 +54,7 @@
  *   - `source.identity`: carried over from the summarized range's first entry
  */
 import type { TypedScope } from 'footprintjs';
-import type { Message } from '../../types/messages';
+import type { LLMMessage as Message } from '../../adapters/types';
 import type { MemoryState } from './types';
 export interface SummarizeConfig {
     /**

package/dist/types/memory/stages/summarize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"summarize.d.ts","sourceRoot":"","sources":["../../../../src/memory/stages/summarize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,QAAQ,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAEhE;;;OAGG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAEpC;;;;;OAKG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAEjC;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AASD,wBAAgB,SAAS,CAAC,MAAM,EAAE,eAAe,WAK1B,WAAW,WAAW,CAAC,KAAG,QAAQ,IAAI,CAAC,CA+C7D"}
+{"version":3,"file":"summarize.d.ts","sourceRoot":"","sources":["../../../../src/memory/stages/summarize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,KAAK,EAAE,UAAU,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,QAAQ,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAEhE;;;OAGG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAEpC;;;;;OAKG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAEjC;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AASD,wBAAgB,SAAS,CAAC,MAAM,EAAE,eAAe,WAK1B,WAAW,WAAW,CAAC,KAAG,QAAQ,IAAI,CAAC,CA+C7D"}

package/dist/types/memory/stages/tokenize.d.ts

@@ -18,7 +18,7 @@
  * the pipeline config. When that lands (Phase 2), this default stays as
  * the dependency-free baseline.
  */
-import type { Message } from '../../types/messages';
+import type { LLMMessage as Message } from '../../adapters/types';
 /** A function that returns the token count of a string. */
 export type TokenCounter = (text: string) => number;
 /**

package/dist/types/memory/stages/tokenize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tokenize.d.ts","sourceRoot":"","sources":["../../../../src/memory/stages/tokenize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEpD,2DAA2D;AAC3D,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;AAEpD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,uBAAuB,EAAE,YAErC,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,YAAsC,GAC9C,MAAM,CAqBR"}
+{"version":3,"file":"tokenize.d.ts","sourceRoot":"","sources":["../../../../src/memory/stages/tokenize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,UAAU,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAElE,2DAA2D;AAC3D,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;AAEpD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,uBAAuB,EAAE,YAErC,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,YAAsC,GAC9C,MAAM,CAER"}

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

@@ -16,7 +16,7 @@
  */
 import type { MemoryIdentity } from '../identity';
 import type { MemoryEntry } from '../entry';
-import type { Message } from '../../types/messages';
+import type { LLMMessage as Message } from '../../adapters/types';
 export interface MemoryState {
     /**
      * Scoping for every storage call this pipeline makes. Wire layer

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/memory/stages/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEpD,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAElC;;;;OAIG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B;;;;;;;OAOG;IACH,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;IAExC;;;;OAIG;IACH,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;IAE/B;;;;;OAKG;IACH,QAAQ,EAAE,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;IAEjC;;;;OAIG;IACH,SAAS,EAAE,OAAO,EAAE,CAAC;IAErB;;;;OAIG;IACH,WAAW,EAAE,OAAO,EAAE,CAAC;IAEvB,+EAA+E;IAC/E,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/memory/stages/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,UAAU,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAElE,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAElC;;;;OAIG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B;;;;;;;OAOG;IACH,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;IAExC;;;;OAIG;IACH,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;IAE/B;;;;;OAKG;IACH,QAAQ,EAAE,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;IAEjC;;;;OAIG;IACH,SAAS,EAAE,OAAO,EAAE,CAAC;IAErB;;;;OAIG;IACH,WAAW,EAAE,OAAO,EAAE,CAAC;IAEvB,+EAA+E;IAC/E,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB"}

package/dist/types/memory/stages/writeMessages.d.ts

@@ -33,7 +33,7 @@
  */
 import type { TypedScope } from 'footprintjs';
 import type { MemoryStore } from '../store';
-import type { Message } from '../../types/messages';
+import type { LLMMessage as Message } from '../../adapters/types';
 import type { MemoryState } from './types';
 export interface WriteMessagesConfig {
     /** The store to persist to. */

package/dist/types/memory/stages/writeMessages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"writeMessages.d.ts","sourceRoot":"","sources":["../../../../src/memory/stages/writeMessages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,MAAM,WAAW,mBAAmB;IAClC,+BAA+B;IAC/B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,MAAM,CAAC;IAC5E;;;;;OAKG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,CAAC;IACtD;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;;;OAOG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;CACzC;AAID,wBAAgB,aAAa,CAAC,MAAM,EAAE,mBAAmB,WAGlC,WAAW,WAAW,CAAC,KAAG,QAAQ,IAAI,CAAC,CA2D7D"}
+{"version":3,"file":"writeMessages.d.ts","sourceRoot":"","sources":["../../../../src/memory/stages/writeMessages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,UAAU,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,MAAM,WAAW,mBAAmB;IAClC,+BAA+B;IAC/B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,MAAM,CAAC;IAC5E;;;;;OAKG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,CAAC;IACtD;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;;;OAOG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;CACzC;AAID,wBAAgB,aAAa,CAAC,MAAM,EAAE,mBAAmB,WAGlC,WAAW,WAAW,CAAC,KAAG,QAAQ,IAAI,CAAC,CA2D7D"}

package/dist/types/observe.d.ts

@@ -0,0 +1,47 @@
+/**
+ * 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.
+ */
+export { ContextRecorder, type ContextRecorderOptions } from './recorders/core/ContextRecorder.js';
+export { streamRecorder, type StreamRecorderOptions } from './recorders/core/StreamRecorder.js';
+export { compositionRecorder, type CompositionRecorderOptions, } from './recorders/core/CompositionRecorder.js';
+export { agentRecorder, type AgentRecorderOptions } from './recorders/core/AgentRecorder.js';
+export { boundaryRecorder, BoundaryRecorder, type DomainEvent, type DomainLLMEndEvent, type DomainLLMStartEvent, type DomainToolStartEvent, type DomainToolEndEvent, type DomainSubflowEvent, type DomainLoopIterationEvent, } from './recorders/observability/BoundaryRecorder.js';
+export { attachFlowchart, buildStepGraph, type StepGraph, type StepNode, type StepEdge, type SlotBoundary, type ContextInjection, type FlowchartOptions, type FlowchartHandle, } from './recorders/observability/FlowchartRecorder.js';
+export { costRecorder, type CostRecorderOptions } from './recorders/core/CostRecorder.js';
+export { evalRecorder, type EvalRecorderOptions } from './recorders/core/EvalRecorder.js';
+export { memoryRecorder, type MemoryRecorderOptions } from './recorders/core/MemoryRecorder.js';
+export { permissionRecorder, type PermissionRecorderOptions, } from './recorders/core/PermissionRecorder.js';
+export { skillRecorder, type SkillRecorderOptions } from './recorders/core/SkillRecorder.js';
+export { attachLogging, LoggingDomains, type LoggingLogger, type LoggingDomain, type LoggingOptions, } from './recorders/observability/LoggingRecorder.js';
+export { attachThinking, type ThinkingEvent, type ThinkingOptions, } from './recorders/observability/ThinkingRecorder.js';
+export { typedEmit } from './recorders/core/typedEmit.js';
+//# sourceMappingURL=observe.d.ts.map

package/dist/types/observe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observe.d.ts","sourceRoot":"","sources":["../../src/observe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAGH,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AACnG,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAGhG,OAAO,EACL,mBAAmB,EACnB,KAAK,0BAA0B,GAChC,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAC7F,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,wBAAwB,GAC9B,MAAM,+CAA+C,CAAC;AACvD,OAAO,EACL,eAAe,EACf,cAAc,EACd,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,gDAAgD,CAAC;AAGxD,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC1F,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC1F,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAChG,OAAO,EACL,kBAAkB,EAClB,KAAK,yBAAyB,GAC/B,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAC7F,OAAO,EACL,aAAa,EACb,cAAc,EACd,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,cAAc,GACpB,MAAM,8CAA8C,CAAC;AACtD,OAAO,EACL,cAAc,EACd,KAAK,aAAa,EAClB,KAAK,eAAe,GACrB,MAAM,+CAA+C,CAAC;AAGvD,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC"}