@molroo-io/sdk 0.6.2 → 0.7.1

package/dist/cjs/memory/recall.d.ts

@@ -1,20 +1,18 @@
 /**
  * Shared memory recall and prompt-building utilities.
  *
- * Used by MolrooPersona to recall episodic/semantic memories and
- * format them for LLM system prompts. Supports both:
- * - Single MemoryAdapter (new, preferred)
- * - Split EpisodeAdapter + SemanticAdapter + EmbeddingAdapter (backward compat)
+ * Used by Molroo to recall episodic/semantic memories and
+ * format them for LLM system prompts.
  */
 import type { Episode } from '../types';
-import type { EpisodeAdapter, SemanticAdapter, EmbeddingAdapter, MemoryAdapter, Reflection } from './types';
+import type { MemoryAdapter, Reflection } from './types';
 /**
  * Strip leading `[...]` metadata tags from text before embedding.
  * These tags (channel info, scene hints, timestamps) add noise to
  * semantic similarity and should not influence vector search.
  */
 export declare function stripMetaTags(text: string): string;
-/** Recall tuning parameters. */
+/** Recall configuration. */
 export interface RecallConfig {
     episodicLimit?: number;
     semanticLimit?: number;
@@ -30,25 +28,16 @@ export interface RecallResult {
     reflections: Reflection[];
 }
 /**
- * Recall episodic + semantic + reflection memories in parallel.
- *
- * Supports two paths:
- * 1. Single MemoryAdapter (`memoryAdapter` param) — adapter handles everything
- * 2. Split stores (`episodeStore` + `semanticStore` + `embeddingProvider`) — legacy
+ * Recall episodic + semantic + reflection memories from a MemoryAdapter.
  *
  * @param message - Current user message (used for semantic embedding).
- * @param opts - Stores, provider, config, and entity filter.
+ * @param adapter - MemoryAdapter instance.
+ * @param config - Recall configuration.
+ * @param sourceEntity - Filter episodes by source entity.
+ * @param reflectionEntity - Filter reflections by entity.
  * @returns Recalled memories grouped by type.
  */
-export declare function recallMemories(message: string, opts: {
-    memoryAdapter?: MemoryAdapter | null;
-    episodeStore: EpisodeAdapter | null;
-    semanticStore: SemanticAdapter | null;
-    embeddingProvider: EmbeddingAdapter | null;
-    config?: RecallConfig;
-    sourceEntity?: string;
-    reflectionEntity?: string;
-}): Promise<RecallResult>;
+export declare function recallMemories(message: string, adapter: MemoryAdapter, config?: RecallConfig, sourceEntity?: string, reflectionEntity?: string): Promise<RecallResult>;
 /**
  * Format recalled memories into a text block for LLM system prompt injection.
  * Groups episodic memories by type: conversations vs events.

package/dist/cjs/memory/recall.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recall.d.ts","sourceRoot":"","sources":["../../../src/memory/recall.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,UAAU,EAEX,MAAM,SAAS,CAAC;AAEjB;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,gCAAgC;AAChC,MAAM,WAAW,YAAY;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4EAA4E;IAC5E,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,2CAA2C;AAC3C,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,WAAW,EAAE,UAAU,EAAE,CAAC;CAC3B;AAgFD;;;;;;;;;;GAUG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE;IACJ,aAAa,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IACrC,YAAY,EAAE,cAAc,GAAG,IAAI,CAAC;IACpC,aAAa,EAAE,eAAe,GAAG,IAAI,CAAC;IACtC,iBAAiB,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC3C,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,GACA,OAAO,CAAC,YAAY,CAAC,CA2FvB;AAcD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,gBAAgB,CAAC,EAAE,OAAO,EAAE,EAC5B,gBAAgB,CAAC,EAAE,OAAO,EAAE,EAC5B,WAAW,CAAC,EAAE,UAAU,EAAE,GACzB,MAAM,CAwCR"}
+{"version":3,"file":"recall.d.ts","sourceRoot":"","sources":["../../../src/memory/recall.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAgB,MAAM,SAAS,CAAC;AAEvE;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,4BAA4B;AAC5B,MAAM,WAAW,YAAY;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4EAA4E;IAC5E,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,2CAA2C;AAC3C,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,WAAW,EAAE,UAAU,EAAE,CAAC;CAC3B;AAED;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,aAAa,EACtB,MAAM,GAAE,YAAiB,EACzB,YAAY,CAAC,EAAE,MAAM,EACrB,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,YAAY,CAAC,CAkEvB;AAcD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,gBAAgB,CAAC,EAAE,OAAO,EAAE,EAC5B,gBAAgB,CAAC,EAAE,OAAO,EAAE,EAC5B,WAAW,CAAC,EAAE,UAAU,EAAE,GACzB,MAAM,CAwCR"}

package/dist/cjs/memory/recall.js

@@ -2,10 +2,8 @@
 /**
  * Shared memory recall and prompt-building utilities.
  *
- * Used by MolrooPersona to recall episodic/semantic memories and
- * format them for LLM system prompts. Supports both:
- * - Single MemoryAdapter (new, preferred)
- * - Split EpisodeAdapter + SemanticAdapter + EmbeddingAdapter (backward compat)
+ * Used by Molroo to recall episodic/semantic memories and
+ * format them for LLM system prompts.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.stripMetaTags = stripMetaTags;
@@ -20,10 +18,16 @@ function stripMetaTags(text) {
     return text.replace(/^\s*(\[.*?\]\s*)+/s, '').trim();
 }
 /**
- * Recall from a single MemoryAdapter. The adapter handles all storage
- * and vector search internally.
+ * Recall episodic + semantic + reflection memories from a MemoryAdapter.
+ *
+ * @param message - Current user message (used for semantic embedding).
+ * @param adapter - MemoryAdapter instance.
+ * @param config - Recall configuration.
+ * @param sourceEntity - Filter episodes by source entity.
+ * @param reflectionEntity - Filter reflections by entity.
+ * @returns Recalled memories grouped by type.
  */
-async function recallFromAdapter(message, adapter, config, sourceEntity, reflectionEntity) {
+async function recallMemories(message, adapter, config = {}, sourceEntity, reflectionEntity) {
     const episodicLimit = config.episodicLimit ?? 5;
     const semanticLimit = config.semanticLimit ?? 3;
     const reflectionLimit = config.reflectionLimit ?? 3;
@@ -53,7 +57,7 @@ async function recallFromAdapter(message, adapter, config, sourceEntity, reflect
         ? adapter
             .semanticRecall(stripMetaTags(message), {
             topK: semanticLimit,
-            filter: { minImportance },
+            minImportance,
         })
             .catch(() => [])
         : Promise.resolve([]);
@@ -83,89 +87,6 @@ async function recallFromAdapter(message, adapter, config, sourceEntity, reflect
     episodic.splice(episodicLimit);
     return { episodic, semantic, reflections };
 }
-/**
- * Recall episodic + semantic + reflection memories in parallel.
- *
- * Supports two paths:
- * 1. Single MemoryAdapter (`memoryAdapter` param) — adapter handles everything
- * 2. Split stores (`episodeStore` + `semanticStore` + `embeddingProvider`) — legacy
- *
- * @param message - Current user message (used for semantic embedding).
- * @param opts - Stores, provider, config, and entity filter.
- * @returns Recalled memories grouped by type.
- */
-async function recallMemories(message, opts) {
-    const config = opts.config ?? {};
-    // Path 1: Single MemoryAdapter
-    if (opts.memoryAdapter) {
-        return recallFromAdapter(message, opts.memoryAdapter, config, opts.sourceEntity, opts.reflectionEntity);
-    }
-    // Path 2: Split stores (backward compat)
-    const { episodeStore, semanticStore, embeddingProvider } = opts;
-    const episodicLimit = config.episodicLimit ?? 5;
-    const semanticLimit = config.semanticLimit ?? 3;
-    const reflectionLimit = config.reflectionLimit ?? 3;
-    const minImportance = config.minImportance ?? 0;
-    // Episodic recall — conversations (filtered by sourceEntity)
-    const conversationP = episodeStore
-        ? episodeStore
-            .recall({
-            sourceEntity: opts.sourceEntity,
-            limit: episodicLimit,
-            minImportance,
-            ...(config.types ? { type: config.types } : {}),
-        })
-            .catch(() => [])
-        : Promise.resolve([]);
-    // Episodic recall — non-chat events (no sourceEntity filter).
-    // Events like attacks/gifts come from various entities and must be
-    // recalled regardless of who the persona is currently talking to.
-    const hasTypeFilter = config.types && config.types.length > 0;
-    const eventP = (episodeStore && !hasTypeFilter)
-        ? episodeStore
-            .recall({
-            // No sourceEntity — recall events from all sources
-            limit: episodicLimit,
-            minImportance,
-        })
-            .then((all) => all.filter((ep) => ep.type && ep.type !== 'chat_message'))
-            .catch(() => [])
-        : Promise.resolve([]);
-    // Semantic recall (vector)
-    const semanticP = semanticStore && embeddingProvider && episodeStore?.getByIds
-        ? embeddingProvider
-            .embed(stripMetaTags(message))
-            .then((embedding) => semanticStore.search({ embedding, topK: semanticLimit, filter: { minImportance } }))
-            .then((results) => results.length > 0
-            ? episodeStore.getByIds(results.map((r) => r.id))
-            : [])
-            .catch(() => [])
-        : Promise.resolve([]);
-    // Reflection recall (RDB)
-    const reflectionP = episodeStore
-        ? episodeStore
-            .getReflections(opts.reflectionEntity, reflectionLimit)
-            .catch(() => [])
-        : Promise.resolve([]);
-    const [conversations, events, semantic, reflections] = await Promise.all([
-        conversationP,
-        eventP,
-        semanticP,
-        reflectionP,
-    ]);
-    // Merge conversations + events, deduplicate, and re-sort by recency
-    const seenIds = new Set();
-    const episodic = [];
-    for (const ep of [...conversations, ...events]) {
-        if (!seenIds.has(ep.id)) {
-            seenIds.add(ep.id);
-            episodic.push(ep);
-        }
-    }
-    episodic.sort((a, b) => b.timestamp - a.timestamp);
-    episodic.splice(episodicLimit);
-    return { episodic, semantic, reflections };
-}
 /** Format a single episode into a display line. */
 function formatEpisodeLine(ep) {
     const v = ep.emotionSnapshot;

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

@@ -1,209 +1,74 @@
 import type { Episode, VAD } from '../types';
 export type { Episode, VAD };
 /**
- * Single-interface memory adapter for the SDK.
+ * Memory adapter for advanced memory features.
  *
- * Duck-type compatible with `@molroo-io/persona`'s `MemoryAdapter`.
- * Implementations (SqliteMemoryAdapter, SupabaseMemoryAdapter, etc.) provide
- * a single object that handles episode storage, recall, and optionally
- * semantic/vector search internally.
+ * For simple use cases, manage conversation history externally using
+ * the `updatedHistory` returned from `chat()`.
+ *
+ * For advanced features (semantic search, reflections, emotion-aware storage),
+ * implement this interface.
  *
  * @example
  * ```typescript
- * import { MolrooPersona } from '@molroo-io/sdk';
+ * class MyPostgresAdapter implements MemoryAdapter {
+ *   async saveEpisode(episode: Episode): Promise<void> {
+ *     await db.query('INSERT INTO episodes ...', [episode]);
+ *   }
+ *
+ *   async recall(query: RecallQuery): Promise<Episode[]> {
+ *     return db.query('SELECT * FROM episodes WHERE ...', [query.sourceEntity]);
+ *   }
  *
- * const persona = await MolrooPersona.create({
- *   baseUrl: 'https://api.molroo.io',
- *   apiKey: 'key',
- *   llm,
- *   memory: myMemoryAdapter,
- * });
+ *   // Optional: semantic search with vector DB
+ *   async semanticRecall(query: string, options?: SemanticRecallOptions): Promise<Episode[]> {
+ *     const embedding = await openai.embed(query);
+ *     return vectorDB.search(embedding, options?.topK ?? 5);
+ *   }
+ * }
  * ```
  */
 export interface MemoryAdapter {
-    /** Save an episode returned by the API's AgentResponse. */
+    /** Save an episode with emotion metadata. */
     saveEpisode(episode: Episode): Promise<void>;
-    /**
-     * Recall relevant episodes by structured query.
-     * Accepts both SDK `RecallQuery` and `EpisodeQuery` shapes.
-     */
+    /** Recall episodes by structured query (filters). */
     recall(query: RecallQuery): Promise<Episode[]>;
-    /** Save a reflection generated by LLM. Optional — omit for episode-only storage. */
+    /** Semantic similarity search (optional). Requires vector DB. */
+    semanticRecall?(query: string, options?: SemanticRecallOptions): Promise<Episode[]>;
+    /** Save a reflection (optional). */
     saveReflection?(reflection: Reflection): Promise<void>;
-    /** Retrieve reflections for a source entity. Optional. */
+    /** Get reflections for a source (optional). */
     getReflections?(sourceEntity?: string): Promise<Reflection[]>;
-    /**
-     * Vector/semantic similarity search. Optional.
-     * When provided, the adapter handles embedding internally — no separate
-     * EmbeddingAdapter needed.
-     */
-    semanticRecall?(query: string, options?: SemanticRecallOptions): Promise<Episode[]>;
-    /** Retrieve episodes by IDs. Optional — used for hydrating search results. */
+    /** Retrieve episodes by IDs (optional). */
     getByIds?(ids: string[]): Promise<Episode[]>;
 }
-/**
- * Query for recalling episodes from a MemoryAdapter.
- *
- * Compatible with both persona engine's `RecallQuery` (`context` field)
- * and the SDK's `EpisodeQuery` (`contextContains` field).
- */
+/** Query for recalling episodes. */
 export interface RecallQuery {
     /** Filter by source entity name. */
     sourceEntity?: string;
-    /** Search keyword or vector query text (persona engine compatibility). */
+    /** Search keyword or context text. */
     context?: string;
-    /** Max episodes to return. Default: implementation-specific. */
+    /** Max episodes to return. */
     limit?: number;
-    /** Minimum importance score to include. */
+    /** Minimum importance score (0-1). */
     minImportance?: number;
     /** Epoch ms range [from, to]. */
     timeRange?: [number, number];
-    /** Filter by episode type. Single string or array (OR match). */
+    /** Filter by episode type. */
     type?: string | string[];
     /** Valence range [min, max]. */
     valenceRange?: [number, number];
 }
 /** Options for semantic/vector recall. */
 export interface SemanticRecallOptions {
-    /** Number of results to return. Default: 5. */
+    /** Number of results. Default: 5. */
     topK?: number;
-    /** Minimum similarity score to include. */
+    /** Minimum similarity score (0-1). */
     minScore?: number;
-    /** Additional structured filters. */
-    filter?: Partial<RecallQuery>;
-}
-/** Recall limit configuration, extracted for reuse. */
-export interface RecallLimits {
-    /** Max episodic memories per recall. Default: 5. */
-    episodicLimit?: number;
-    /** Max semantic results per recall. Default: 3. */
-    semanticLimit?: number;
-    /** Max reflections per recall. Default: 3. */
-    reflectionLimit?: number;
-    /** Minimum importance threshold. Default: 0. */
+    /** Minimum importance threshold. */
     minImportance?: number;
 }
-/**
- * Type guard: returns true if the memory config is a `MemoryConfig` (split adapters),
- * false if it's a `MemoryAdapter` (single adapter).
- *
- * Discriminates by checking for `saveEpisode` — present on MemoryAdapter, absent on MemoryConfig.
- */
-export declare function isMemoryConfig(m: MemoryAdapter | MemoryConfig): m is MemoryConfig;
-/**
- * EpisodeAdapter — RDB-backed structured episode storage.
- *
- * Required adapter for the split `MemoryConfig` approach. Handles saving and
- * recalling episodic memories (conversation episodes + reflections).
- *
- * Implementations: InMemoryEpisodeAdapter (built-in), or consumer-provided
- * (SQLite, PostgreSQL, Supabase, etc.).
- */
-export interface EpisodeAdapter {
-    /** Save an episode returned by the API's AgentResponse. */
-    saveEpisode(episode: Episode): Promise<void>;
-    /** Recall relevant episodes by structured query (time-ordered). */
-    recall(query: EpisodeQuery): Promise<Episode[]>;
-    /** Retrieve episodes by IDs — used for hydrating SemanticStore results. */
-    getByIds?(ids: string[]): Promise<Episode[]>;
-    /** Save a reflection generated by LLM. */
-    saveReflection(reflection: Reflection): Promise<void>;
-    /** Retrieve reflections for a source entity. */
-    getReflections(sourceEntity?: string, limit?: number): Promise<Reflection[]>;
-}
-/** Structured query for episodic recall (RDB-style filtering). */
-export interface EpisodeQuery {
-    /** Filter by source entity name. */
-    sourceEntity?: string;
-    /** LIKE search on episode context (not semantic). */
-    contextContains?: string;
-    /** Filter by episode type. Single string or array (OR match). */
-    type?: string | string[];
-    /** Max episodes to return. Default: 10. */
-    limit?: number;
-    /** Minimum importance score to include. */
-    minImportance?: number;
-    /** Epoch ms range [from, to]. */
-    timeRange?: [number, number];
-    /** Valence range [min, max]. */
-    valenceRange?: [number, number];
-}
-/**
- * SemanticAdapter — Vector DB-backed semantic search.
- *
- * Optional adapter for similarity-based memory recall.
- * Requires an EmbeddingAdapter to be configured alongside.
- *
- * Implementations: consumer-provided (Pinecone, pgvector, ChromaDB, etc.).
- */
-export interface SemanticAdapter {
-    /** Index a semantic entry (episode or reflection embedding). */
-    index(entry: SemanticEntry): Promise<void>;
-    /** Search for semantically similar entries. */
-    search(query: SemanticQuery): Promise<SemanticResult[]>;
-}
-/** Entry to index in the vector store. */
-export interface SemanticEntry {
-    id: string;
-    embedding: number[];
-    metadata: {
-        type: 'episode' | 'reflection';
-        sourceEntity?: string;
-        timestamp: number;
-        importance?: number;
-        /** Episode type tag (e.g. 'chat_message', 'attack', 'gift'). */
-        episodeType?: string;
-    };
-}
-/** Query for semantic similarity search. */
-export interface SemanticQuery {
-    embedding: number[];
-    /** Number of results to return. Default: 5. */
-    topK?: number;
-    filter?: {
-        type?: 'episode' | 'reflection';
-        sourceEntity?: string;
-        minImportance?: number;
-        /** Filter by episode type tag. */
-        episodeType?: string;
-    };
-}
-/** Result from semantic similarity search. */
-export interface SemanticResult {
-    id: string;
-    score: number;
-    metadata: SemanticEntry['metadata'];
-}
-/**
- * EmbeddingAdapter — generates vector embeddings from text.
- *
- * Required when using SemanticAdapter. Consumer provides their own
- * embedding model (OpenAI, Cohere, local, etc.).
- */
-export interface EmbeddingAdapter {
-    /** Generate an embedding vector from text. */
-    embed(text: string): Promise<number[]>;
-    /** Dimensionality of the embedding vectors. */
-    readonly dimension: number;
-}
-/**
- * MemoryConfig — split-adapter configuration for the SDK memory system.
- *
- * At minimum, provide an `episodes` adapter. Optionally add `semantic`
- * + `embedding` for similarity-based recall.
- *
- * For simpler setup, pass a single `MemoryAdapter` instead of `MemoryConfig`.
- */
-export interface MemoryConfig {
-    /** Required: structured episode storage (RDB-backed). */
-    episodes: EpisodeAdapter;
-    /** Optional: vector similarity search. Requires `embedding` to be set. */
-    semantic?: SemanticAdapter;
-    /** Optional: embedding adapter. Required when `semantic` is set. */
-    embedding?: EmbeddingAdapter;
-    /** Optional: recall tuning parameters. */
-    recall?: RecallLimits;
-}
+/** Reflection data structure. */
 export interface Reflection {
     id: string;
     timestamp: number;
@@ -212,20 +77,15 @@ export interface Reflection {
     trigger: string;
     emotionSnapshot: VAD;
 }
-/** @deprecated Use EpisodeAdapter */
-export type EpisodeStore = EpisodeAdapter;
-/** @deprecated Use SemanticAdapter */
-export type SemanticStore = SemanticAdapter;
-/** @deprecated Use EmbeddingAdapter */
-export type EmbeddingProvider = EmbeddingAdapter;
-export interface EpisodePatch {
-    importance?: number;
-    intensity?: number;
-    emotionSnapshot?: VAD;
-}
-export interface CountQuery {
-    sourceEntity?: string;
-    context?: string;
-    timeRange?: [number, number];
+/** Recall limit configuration. */
+export interface RecallLimits {
+    /** Max episodic memories. Default: 5. */
+    episodicLimit?: number;
+    /** Max semantic results. Default: 3. */
+    semanticLimit?: number;
+    /** Max reflections. Default: 3. */
+    reflectionLimit?: number;
+    /** Minimum importance threshold. Default: 0. */
+    minImportance?: number;
 }
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/memory/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/memory/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE7C,YAAY,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;AAE7B;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,WAAW,aAAa;IAC5B,6CAA6C;IAC7C,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7C,qDAAqD;IACrD,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAE/C,iEAAiE;IACjE,cAAc,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAEpF,oCAAoC;IACpC,cAAc,CAAC,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvD,+CAA+C;IAC/C,cAAc,CAAC,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAE9D,2CAA2C;IAC3C,QAAQ,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;CAC9C;AAED,oCAAoC;AACpC,MAAM,WAAW,WAAW;IAC1B,oCAAoC;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iCAAiC;IACjC,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACzB,gCAAgC;IAChC,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED,0CAA0C;AAC1C,MAAM,WAAW,qBAAqB;IACpC,qCAAqC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,iCAAiC;AACjC,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,GAAG,CAAC;CACtB;AAED,kCAAkC;AAClC,MAAM,WAAW,YAAY;IAC3B,yCAAyC;IACzC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wCAAwC;IACxC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mCAAmC;IACnC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gDAAgD;IAChD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB"}

package/dist/cjs/memory/types.js

@@ -1,12 +1,2 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isMemoryConfig = isMemoryConfig;
-/**
- * Type guard: returns true if the memory config is a `MemoryConfig` (split adapters),
- * false if it's a `MemoryAdapter` (single adapter).
- *
- * Discriminates by checking for `saveEpisode` — present on MemoryAdapter, absent on MemoryConfig.
- */
-function isMemoryConfig(m) {
-    return !('saveEpisode' in m);
-}

package/dist/cjs/persona/chat-orchestrator.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Chat orchestration: 3 modes (combined / split / tool-use).
+ *
+ * Extracted from MolrooPersona to reduce god-object complexity.
+ * All external dependencies are injected via ChatOrchestratorDeps.
+ */
+import type { LLMAdapter, Message } from '../llm/adapter';
+import type { AgentResponse, InterlocutorContext, PerceiveOptions } from '../types';
+import type { RecallLimits } from '../memory/types';
+import type { MemoryAdapter } from '../memory/types';
+import type { EventAdapter } from '../events/types';
+type PromptContextResult = {
+    systemPrompt: string;
+    personaPrompt: Record<string, unknown>;
+    tools?: Array<Record<string, unknown>>;
+};
+export interface ChatOrchestratorDeps {
+    personaId: string;
+    llm: LLMAdapter;
+    engineLlm: LLMAdapter | null;
+    memoryAdapter: MemoryAdapter | null;
+    memoryRecallConfig: RecallLimits | undefined;
+    events: EventAdapter | null;
+    getPromptContext: (consumerSuffix?: string, sourceEntity?: string) => Promise<PromptContextResult>;
+    perceive: (message: string, options?: PerceiveOptions) => Promise<AgentResponse>;
+    searchMemory: (query: string) => Promise<Array<Record<string, unknown>>>;
+}
+export interface ChatOptions {
+    from?: string | InterlocutorContext;
+    history?: Message[];
+    consumerSuffix?: string;
+    onToolCall?: (call: {
+        name: string;
+        args: Record<string, unknown>;
+        result: unknown;
+    }) => void;
+}
+export interface ChatResult {
+    text: string;
+    response: AgentResponse;
+    /** Updated conversation history including this turn. Manage externally for simple mode. */
+    updatedHistory: Message[];
+}
+export declare function chat(deps: ChatOrchestratorDeps, message: string, options?: ChatOptions): Promise<ChatResult>;
+export {};
+//# sourceMappingURL=chat-orchestrator.d.ts.map

package/dist/cjs/persona/chat-orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-orchestrator.d.ts","sourceRoot":"","sources":["../../../src/persona/chat-orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,KAAK,EACV,aAAa,EAGb,mBAAmB,EACnB,eAAe,EAChB,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAIpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AA+BpD,KAAK,mBAAmB,GAAG;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,KAAK,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACxC,CAAC;AAEF,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,UAAU,CAAC;IAChB,SAAS,EAAE,UAAU,GAAG,IAAI,CAAC;IAC7B,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;IACpC,kBAAkB,EAAE,YAAY,GAAG,SAAS,CAAC;IAC7C,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5B,gBAAgB,EAAE,CAAC,cAAc,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACnG,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;IACjF,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;CAC1E;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,GAAG,mBAAmB,CAAC;IACpC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;CAC/F;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,aAAa,CAAC;IACxB,2FAA2F;IAC3F,cAAc,EAAE,OAAO,EAAE,CAAC;CAC3B;AAED,wBAAsB,IAAI,CAAC,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAmJlH"}