@molroo-io/sdk 0.6.2 → 0.7.1

package/dist/esm/llm/vercel-ai/adapter.d.ts

@@ -2,28 +2,22 @@ import type { LLMAdapter, GenerateTextOptions, GenerateObjectOptions } from '../
 import type { VercelAIConfig } from './config';
 /**
  * Vercel AI SDK adapter for molroo.
- * Supports OpenAI, Anthropic, Vertex AI, and OpenRouter providers.
+ * Wraps a pre-configured Vercel AI SDK provider instance.
  */
 export declare class VercelAIAdapter implements LLMAdapter {
-    private config;
+    private provider;
+    private model?;
     constructor(config: VercelAIConfig);
-    private getProvider;
-    /**
-     * Create a language model instance.
-     * For OpenAI-compatible APIs with custom baseUrl, uses .chat() to force
-     * Chat Completions API instead of the default Responses API.
-     */
-    private getModel;
     generateText(options: GenerateTextOptions): Promise<{
         text: string;
     }>;
     generateObject<T>(options: GenerateObjectOptions<T>): Promise<{
         object: T;
     }>;
-    private getDefaultModel;
 }
 /**
  * Factory function to create a VercelAIAdapter instance.
+ * @deprecated Create adapter directly: `new VercelAIAdapter({ provider })`
  */
 export declare function createVercelAIAdapter(config: VercelAIConfig): VercelAIAdapter;
 //# sourceMappingURL=adapter.d.ts.map

package/dist/esm/llm/vercel-ai/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../src/llm/vercel-ai/adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACzF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAgG/C;;;GAGG;AACH,qBAAa,eAAgB,YAAW,UAAU;IAChD,OAAO,CAAC,MAAM,CAAiB;gBAEnB,MAAM,EAAE,cAAc;YAIpB,WAAW;IAoCzB;;;;OAIG;YACW,QAAQ;IAQhB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAerE,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,CAAC,CAAA;KAAE,CAAC;IA2BlF,OAAO,CAAC,eAAe;CASxB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,cAAc,GAAG,eAAe,CAE7E"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../src/llm/vercel-ai/adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACzF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAiD/C;;;GAGG;AACH,qBAAa,eAAgB,YAAW,UAAU;IAChD,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,KAAK,CAAC,CAAS;gBAEX,MAAM,EAAE,cAAc;IAK5B,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAYrE,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,CAAC,CAAA;KAAE,CAAC;CAiBnF;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,cAAc,GAAG,eAAe,CAE7E"}

package/dist/esm/llm/vercel-ai/adapter.js

@@ -39,116 +39,18 @@ function strictifySchema(schema) {
 function isZodSchema(schema) {
     return schema && typeof schema === 'object' && '_def' in schema;
 }
-/**
- * Recursively strip `$schema` keys from any object.
- * AI SDK's Zod->JSON Schema converter adds `$schema` which some
- * OpenAI-compatible APIs (e.g. Kimi/Moonshot) reject.
- */
-function stripDollarSchema(obj) {
-    if (!obj || typeof obj !== 'object')
-        return obj;
-    if (Array.isArray(obj))
-        return obj.map(stripDollarSchema);
-    const result = {};
-    for (const [k, v] of Object.entries(obj)) {
-        if (k === '$schema')
-            continue;
-        result[k] = stripDollarSchema(v);
-    }
-    return result;
-}
-/**
- * Create a fetch wrapper that strips `$schema` from JSON request bodies.
- * Used for OpenAI-compatible APIs that reject non-standard schema keywords.
- */
-function createSchemaStrippingFetch() {
-    return async (input, init) => {
-        if (init?.body && typeof init.body === 'string') {
-            try {
-                const parsed = JSON.parse(init.body);
-                if (parsed.response_format?.json_schema?.schema) {
-                    parsed.response_format.json_schema.schema =
-                        stripDollarSchema(parsed.response_format.json_schema.schema);
-                    init = { ...init, body: JSON.stringify(parsed) };
-                }
-            }
-            catch {
-                // Not JSON, pass through
-            }
-        }
-        const response = await globalThis.fetch(input, init);
-        // Debug: log error responses from provider
-        if (!response.ok && process.env.DEBUG_LLM) {
-            const cloned = response.clone();
-            try {
-                const body = await cloned.text();
-                console.error(`[adapter-llm] ${response.status} ${response.statusText}: ${body.slice(0, 500)}`);
-            }
-            catch { /* ignore */ }
-        }
-        return response;
-    };
-}
 /**
  * Vercel AI SDK adapter for molroo.
- * Supports OpenAI, Anthropic, Vertex AI, and OpenRouter providers.
+ * Wraps a pre-configured Vercel AI SDK provider instance.
  */
 export class VercelAIAdapter {
     constructor(config) {
-        this.config = config;
-    }
-    async getProvider() {
-        switch (this.config.provider) {
-            case 'openai': {
-                const { createOpenAI } = await import('@ai-sdk/openai');
-                return createOpenAI({
-                    apiKey: this.config.apiKey,
-                    ...(this.config.baseUrl ? {
-                        baseURL: this.config.baseUrl,
-                        fetch: createSchemaStrippingFetch(),
-                    } : {}),
-                });
-            }
-            case 'anthropic': {
-                const { createAnthropic } = await import('@ai-sdk/anthropic');
-                return createAnthropic({ apiKey: this.config.apiKey });
-            }
-            case 'openrouter': {
-                const { createOpenAI } = await import('@ai-sdk/openai');
-                return createOpenAI({
-                    apiKey: this.config.apiKey,
-                    baseURL: 'https://openrouter.ai/api/v1',
-                    fetch: createSchemaStrippingFetch(),
-                });
-            }
-            case 'vertex': {
-                const { createVertex } = await import('@ai-sdk/google-vertex');
-                return createVertex({
-                    project: this.config.projectId,
-                    location: this.config.location || 'us-central1'
-                });
-            }
-            default:
-                throw new Error(`Unknown provider: ${this.config.provider}`);
-        }
-    }
-    /**
-     * Create a language model instance.
-     * For OpenAI-compatible APIs with custom baseUrl, uses .chat() to force
-     * Chat Completions API instead of the default Responses API.
-     */
-    async getModel(modelName) {
-        const provider = await this.getProvider();
-        if (this.config.provider === 'openrouter' || (this.config.provider === 'openai' && this.config.baseUrl)) {
-            return provider.chat(modelName);
-        }
-        return provider(modelName);
+        this.provider = config.provider;
+        this.model = config.model;
     }
     async generateText(options) {
-        const modelName = this.config.model || this.getDefaultModel();
-        const model = await this.getModel(modelName);
         const result = await generateTextAI({
-            model,
+            model: this.provider,
             system: options.system,
             messages: options.messages,
             ...(options.temperature !== undefined && { temperature: options.temperature }),
@@ -157,39 +59,24 @@ export class VercelAIAdapter {
         return { text: result.text };
     }
     async generateObject(options) {
-        const modelName = this.config.model || this.getDefaultModel();
-        const model = await this.getModel(modelName);
         // Zod schemas can be passed directly to AI SDK.
         // Plain JSON schemas need strictification for OpenAI compatibility.
         const resolvedSchema = isZodSchema(options.schema)
             ? options.schema
             : jsonSchema(strictifySchema(options.schema));
-        // OpenRouter and custom baseUrl providers often don't support strict
-        // json_schema mode. Use tool calling mode which is more widely supported.
-        const isProxied = this.config.provider === 'openrouter' ||
-            (this.config.provider === 'openai' && !!this.config.baseUrl);
         const result = await generateObject({
-            model,
+            model: this.provider,
             schema: resolvedSchema,
             system: options.system,
             messages: options.messages,
-            ...(isProxied && { mode: 'tool' }),
             ...(options.temperature !== undefined && { temperature: options.temperature }),
         });
         return { object: result.object };
     }
-    getDefaultModel() {
-        switch (this.config.provider) {
-            case 'openai': return 'gpt-4o';
-            case 'anthropic': return 'claude-sonnet-4-5-20250929';
-            case 'openrouter': return 'anthropic/claude-sonnet-4-5';
-            case 'vertex': return 'gemini-2.0-flash';
-            default: return 'gpt-4o';
-        }
-    }
 }
 /**
  * Factory function to create a VercelAIAdapter instance.
+ * @deprecated Create adapter directly: `new VercelAIAdapter({ provider })`
  */
 export function createVercelAIAdapter(config) {
     return new VercelAIAdapter(config);

package/dist/esm/llm/vercel-ai/config.d.ts

@@ -1,9 +1,12 @@
+import type { LanguageModel } from 'ai';
+/**
+ * Configuration for VercelAIAdapter.
+ * Accepts a pre-configured Vercel AI SDK provider instance.
+ */
 export interface VercelAIConfig {
-    provider: 'openai' | 'anthropic' | 'vertex' | 'openrouter';
-    apiKey: string;
+    /** Pre-configured Vercel AI SDK provider instance (e.g., from createOpenAI()) */
+    provider: LanguageModel;
+    /** Default model name. If not provided, uses provider's default */
     model?: string;
-    baseUrl?: string;
-    projectId?: string;
-    location?: string;
 }
 //# sourceMappingURL=config.d.ts.map

package/dist/esm/llm/vercel-ai/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../src/llm/vercel-ai/config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,YAAY,CAAC;IAC3D,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../src/llm/vercel-ai/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAExC;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,iFAAiF;IACjF,QAAQ,EAAE,aAAa,CAAC;IACxB,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/esm/memory/in-memory.d.ts

@@ -1,46 +1,23 @@
-import type { Episode } from '../types';
-import type { EpisodeAdapter, EpisodeQuery, MemoryAdapter, RecallQuery, Reflection } from './types';
 /**
- * In-memory implementation of both EpisodeAdapter and MemoryAdapter.
- *
- * Useful for demos, testing, and prototyping. Data is lost on process exit
- * unless explicitly serialized via `toJSON()` / `fromJSON()`.
- *
- * Can be used as:
- * - `memory: { episodes: new InMemoryEpisodeAdapter() }` (split config)
- * - `memory: new InMemoryEpisodeAdapter()` (single adapter)
+ * In-memory adapter for testing purposes.
+ * Not recommended for production use (data is lost on restart).
  */
-export declare class InMemoryEpisodeAdapter implements EpisodeAdapter, MemoryAdapter {
+import type { Episode, Reflection } from './types';
+import type { MemoryAdapter, RecallQuery } from './types';
+/**
+ * Simple in-memory adapter for testing.
+ * Stores episodes in memory only.
+ */
+export declare class InMemoryAdapter implements MemoryAdapter {
     private episodes;
     private reflections;
     saveEpisode(episode: Episode): Promise<void>;
-    /**
-     * Recall episodes by query.
-     * Accepts both `EpisodeQuery` (with `contextContains`) and `RecallQuery` (with `context`).
-     */
-    recall(query: EpisodeQuery | RecallQuery): Promise<Episode[]>;
-    getByIds(ids: string[]): Promise<Episode[]>;
+    recall(query: RecallQuery): Promise<Episode[]>;
     saveReflection(reflection: Reflection): Promise<void>;
-    getReflections(sourceEntity?: string, limit?: number): Promise<Reflection[]>;
-    /** Export all data for persistence (save slots, etc.). */
-    toJSON(): {
-        episodes: Episode[];
-        reflections: Reflection[];
-    };
-    /** Restore data from a previous export. */
-    fromJSON(data: {
-        episodes?: Episode[];
-        reflections?: Reflection[];
-    }): void;
-    /** Number of stored episodes. */
-    get episodeCount(): number;
-    /** Number of stored reflections. */
-    get reflectionCount(): number;
-    /** Clear all data. */
+    getReflections(sourceEntity?: string): Promise<Reflection[]>;
+    /** Clear all stored data (for testing). */
     clear(): void;
 }
-/** @deprecated Use InMemoryEpisodeAdapter */
-export declare const InMemoryEpisodeStore: typeof InMemoryEpisodeAdapter;
-/** @deprecated Use InMemoryEpisodeAdapter */
-export type InMemoryEpisodeStore = InMemoryEpisodeAdapter;
+/** @deprecated Use InMemoryAdapter */
+export declare const InMemoryEpisodeAdapter: typeof InMemoryAdapter;
 //# sourceMappingURL=in-memory.d.ts.map

package/dist/esm/memory/in-memory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"in-memory.d.ts","sourceRoot":"","sources":["../../../src/memory/in-memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEpG;;;;;;;;;GASG;AACH,qBAAa,sBAAuB,YAAW,cAAc,EAAE,aAAa;IAC1E,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,WAAW,CAAoB;IAEjC,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IASlD;;;OAGG;IACG,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,WAAW,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IA0C7D,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAK3C,cAAc,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IASrD,cAAc,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAelF,0DAA0D;IAC1D,MAAM,IAAI;QAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;QAAC,WAAW,EAAE,UAAU,EAAE,CAAA;KAAE;IAO5D,2CAA2C;IAC3C,QAAQ,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;QAAC,WAAW,CAAC,EAAE,UAAU,EAAE,CAAA;KAAE,GAAG,IAAI;IAK1E,iCAAiC;IACjC,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,oCAAoC;IACpC,IAAI,eAAe,IAAI,MAAM,CAE5B;IAED,sBAAsB;IACtB,KAAK,IAAI,IAAI;CAId;AAED,6CAA6C;AAC7C,eAAO,MAAM,oBAAoB,+BAAyB,CAAC;AAC3D,6CAA6C;AAC7C,MAAM,MAAM,oBAAoB,GAAG,sBAAsB,CAAC"}
+{"version":3,"file":"in-memory.d.ts","sourceRoot":"","sources":["../../../src/memory/in-memory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE1D;;;GAGG;AACH,qBAAa,eAAgB,YAAW,aAAa;IACnD,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,WAAW,CAAoB;IAEjC,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5C,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAwB9C,cAAc,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrD,cAAc,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAOlE,2CAA2C;IAC3C,KAAK,IAAI,IAAI;CAId;AAED,sCAAsC;AACtC,eAAO,MAAM,sBAAsB,wBAAkB,CAAC"}

package/dist/esm/memory/in-memory.js

@@ -1,111 +1,48 @@
 /**
- * In-memory implementation of both EpisodeAdapter and MemoryAdapter.
- *
- * Useful for demos, testing, and prototyping. Data is lost on process exit
- * unless explicitly serialized via `toJSON()` / `fromJSON()`.
- *
- * Can be used as:
- * - `memory: { episodes: new InMemoryEpisodeAdapter() }` (split config)
- * - `memory: new InMemoryEpisodeAdapter()` (single adapter)
+ * Simple in-memory adapter for testing.
+ * Stores episodes in memory only.
  */
-export class InMemoryEpisodeAdapter {
+export class InMemoryAdapter {
     constructor() {
         this.episodes = [];
         this.reflections = [];
     }
     async saveEpisode(episode) {
-        const idx = this.episodes.findIndex(e => e.id === episode.id);
-        if (idx >= 0) {
-            this.episodes[idx] = episode;
-        }
-        else {
-            this.episodes.push(episode);
-        }
+        this.episodes.push(episode);
     }
-    /**
-     * Recall episodes by query.
-     * Accepts both `EpisodeQuery` (with `contextContains`) and `RecallQuery` (with `context`).
-     */
     async recall(query) {
         let results = [...this.episodes];
         if (query.sourceEntity) {
-            results = results.filter(e => e.sourceEntity === query.sourceEntity);
+            results = results.filter(ep => ep.sourceEntity === query.sourceEntity);
         }
-        // Support both EpisodeQuery.contextContains and RecallQuery.context
-        const contextSearch = ('contextContains' in query ? query.contextContains : undefined)
-            ?? ('context' in query ? query.context : undefined);
-        if (contextSearch) {
-            const lower = contextSearch.toLowerCase();
-            results = results.filter(e => e.context?.toLowerCase().includes(lower));
-        }
-        if (query.type !== undefined) {
+        if (query.type) {
             const types = Array.isArray(query.type) ? query.type : [query.type];
-            results = results.filter(e => e.type !== undefined && types.includes(e.type));
+            results = results.filter(ep => ep.type && types.includes(ep.type));
         }
         if (query.minImportance !== undefined) {
-            results = results.filter(e => e.importance >= query.minImportance);
-        }
-        if (query.timeRange) {
-            const [from, to] = query.timeRange;
-            results = results.filter(e => e.timestamp >= from && e.timestamp <= to);
+            results = results.filter(ep => ep.importance >= query.minImportance);
         }
-        if ('valenceRange' in query && query.valenceRange) {
-            const [min, max] = query.valenceRange;
-            results = results.filter(e => e.emotionSnapshot.V >= min && e.emotionSnapshot.V <= max);
-        }
-        // Sort by timestamp descending (most recent first)
+        // Sort by timestamp desc
         results.sort((a, b) => b.timestamp - a.timestamp);
-        const limit = query.limit ?? 10;
-        return results.slice(0, limit);
-    }
-    async getByIds(ids) {
-        const idSet = new Set(ids);
-        return this.episodes.filter(e => idSet.has(e.id));
+        if (query.limit) {
+            results = results.slice(0, query.limit);
+        }
+        return results;
     }
     async saveReflection(reflection) {
-        const idx = this.reflections.findIndex(r => r.id === reflection.id);
-        if (idx >= 0) {
-            this.reflections[idx] = reflection;
-        }
-        else {
-            this.reflections.push(reflection);
-        }
+        this.reflections.push(reflection);
     }
-    async getReflections(sourceEntity, limit) {
-        let results = [...this.reflections];
+    async getReflections(sourceEntity) {
         if (sourceEntity) {
-            results = results.filter(r => r.sourceEntity === sourceEntity);
+            return this.reflections.filter(r => r.sourceEntity === sourceEntity);
         }
-        // Sort by timestamp descending
-        results.sort((a, b) => b.timestamp - a.timestamp);
-        return results.slice(0, limit ?? 10);
-    }
-    // ── Serialization helpers ──
-    /** Export all data for persistence (save slots, etc.). */
-    toJSON() {
-        return {
-            episodes: [...this.episodes],
-            reflections: [...this.reflections],
-        };
-    }
-    /** Restore data from a previous export. */
-    fromJSON(data) {
-        this.episodes = data.episodes ? [...data.episodes] : [];
-        this.reflections = data.reflections ? [...data.reflections] : [];
-    }
-    /** Number of stored episodes. */
-    get episodeCount() {
-        return this.episodes.length;
-    }
-    /** Number of stored reflections. */
-    get reflectionCount() {
-        return this.reflections.length;
+        return [...this.reflections];
     }
-    /** Clear all data. */
+    /** Clear all stored data (for testing). */
     clear() {
         this.episodes = [];
         this.reflections = [];
     }
 }
-/** @deprecated Use InMemoryEpisodeAdapter */
-export const InMemoryEpisodeStore = InMemoryEpisodeAdapter;
+/** @deprecated Use InMemoryAdapter */
+export const InMemoryEpisodeAdapter = InMemoryAdapter;

package/dist/esm/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/esm/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/esm/memory/recall.js

@@ -1,10 +1,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.
  */
 /**
  * Strip leading `[...]` metadata tags from text before embedding.
@@ -15,10 +13,16 @@ export 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) {
+export async function recallMemories(message, adapter, config = {}, sourceEntity, reflectionEntity) {
     const episodicLimit = config.episodicLimit ?? 5;
     const semanticLimit = config.semanticLimit ?? 3;
     const reflectionLimit = config.reflectionLimit ?? 3;
@@ -48,7 +52,7 @@ async function recallFromAdapter(message, adapter, config, sourceEntity, reflect
         ? adapter
             .semanticRecall(stripMetaTags(message), {
             topK: semanticLimit,
-            filter: { minImportance },
+            minImportance,
         })
             .catch(() => [])
         : Promise.resolve([]);
@@ -78,89 +82,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.
- */
-export 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;