@molroo-io/sdk 0.5.2

package/dist/esm/llm/schema.js

@@ -0,0 +1,69 @@
+import { z } from 'zod';
+/** Clamp a number to [lo, hi]. */
+const clamp = (v, lo, hi) => Math.max(lo, Math.min(hi, v));
+/**
+ * AppraisalVector Schema — Scherer CPM 9-dimensional emotion appraisal.
+ * LLM evaluates user input from persona's perspective.
+ *
+ * Each field accepts any number from LLM output, then clamps to the valid
+ * range via .transform(). This tolerates LLM outputs outside the intended
+ * range (e.g. -3.0) without failing Zod parsing.
+ */
+export const AppraisalVectorSchema = z.object({
+    goal_relevance: z
+        .number()
+        .describe("How relevant is this message to the persona's goals, including relational goals (caring about the speaker)? -1: completely irrelevant, 0: slightly relevant, 1: central to goals. Casual greetings: 0~0.2")
+        .transform((v) => clamp(v, -1, 1)),
+    goal_congruence: z
+        .number()
+        .describe("Does this event help or hinder the persona's goals? -1: harmful/threatening, 0: neutral, 1: helpful. User's suffering → negative (through relational concern). Insults → negative.")
+        .transform((v) => clamp(v, -1, 1)),
+    expectedness: z
+        .number()
+        .describe('How predictable was this event? 0: shocking/impossible, 0.5: normal, 1: routine. First meeting: ~0.5. Use 0-1 range.')
+        .transform((v) => clamp(v, 0, 1)),
+    controllability: z
+        .number()
+        .describe('Can the persona influence or respond to this situation? 0: helpless, 0.5: can comfort/support, 1: can directly resolve. For other-events: rate how much the persona can help, not whether the situation was avoidable. Use 0-1 range.')
+        .transform((v) => clamp(v, 0, 1)),
+    agency: z
+        .number()
+        .describe('Who caused the situation being discussed? -1: fate/accident, 0: shared/ambiguous, 1: deliberate by speaker. For other-events (user sharing their experience): rate the cause of what happened to them.')
+        .transform((v) => clamp(v, -1, 1)),
+    norm_compatibility: z
+        .number()
+        .describe("Does the described situation align with the persona's values and social norms? -1: serious violation (cruelty/injustice/insult), 0: neutral, 1: kind/virtuous. Evaluate the situation content, not the act of sharing it.")
+        .transform((v) => clamp(v, -1, 1)),
+    internal_standards: z
+        .number()
+        .describe("Does this situation involve violating or upholding the persona's own standards/values? -1: serious self-standard violation (shame, guilt), 0: not self-relevant, 1: lived up to own ideals (pride). Rate from the persona's self-evaluation perspective.")
+        .transform((v) => clamp(v, -1, 1)),
+    adjustment_potential: z
+        .number()
+        .describe('Can the persona (or the person involved) cope with or adapt to this situation? 0: devastating/no way to cope, 0.5: moderate coping, 1: fully adaptable/accepted. For loss/grief: high (accepted). For active threat: low. Use 0-1 range.')
+        .transform((v) => clamp(v, 0, 1)),
+    urgency: z
+        .number()
+        .describe('How much time pressure or immediate action is needed? 0: settled/past event/no rush, 0.5: moderate, 1: immediate action required/acute emergency. For past losses: low. For active threats: high. Use 0-1 range.')
+        .transform((v) => clamp(v, 0, 1)),
+});
+/**
+ * Full LLM response schema — response text + appraisal vector.
+ */
+export const LLMResponseSchema = z.object({
+    response: z.string().describe('Response message from persona to user'),
+    appraisal: AppraisalVectorSchema.describe("Scherer 9-dimensional emotion appraisal of user input from persona's perspective"),
+});
+/**
+ * Tool-use aware LLM response schema.
+ * The LLM can either produce a normal response or request a memory search.
+ * When search_memory is set, the SDK executes the search and re-invokes the LLM.
+ */
+export const LLMResponseWithToolsSchema = z.object({
+    response: z.string().describe('Response message from persona to user. Set to empty string "" if you need to search memory first.'),
+    appraisal: AppraisalVectorSchema.describe("Scherer 9-dimensional emotion appraisal of user input from persona's perspective"),
+    search_memory: z
+        .string()
+        .optional()
+        .describe('If you need to recall a specific memory before responding, set this to your search query. Leave empty/omit when you can respond without searching.'),
+});

package/dist/esm/llm/types.d.ts

@@ -0,0 +1,24 @@
+export interface LLMPrompt {
+    system: string;
+    context?: string;
+    instruction?: string;
+    history?: ChatMessage[];
+}
+export interface ChatMessage {
+    role: 'user' | 'assistant' | 'system';
+    content: string;
+}
+export interface LLMResponse {
+    text: string;
+    response?: string;
+    appraisal?: AppraisalVector;
+}
+export interface AppraisalVector {
+    goal_relevance: number;
+    goal_congruence: number;
+    expectedness: number;
+    controllability: number;
+    agency: number;
+    norm_compatibility: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/llm/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/llm/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,eAAe,CAAC;CAC7B;AAED,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB,EAAE,MAAM,CAAC;CAC5B"}

package/dist/esm/llm/types.js

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,29 @@
+import type { LLMAdapter, GenerateTextOptions, GenerateObjectOptions } from '../adapter';
+import type { VercelAIConfig } from './config';
+/**
+ * Vercel AI SDK adapter for molroo.
+ * Supports OpenAI, Anthropic, Vertex AI, and OpenRouter providers.
+ */
+export declare class VercelAIAdapter implements LLMAdapter {
+    private config;
+    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.
+ */
+export declare function createVercelAIAdapter(config: VercelAIConfig): VercelAIAdapter;
+//# sourceMappingURL=adapter.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,196 @@
+import { generateText as generateTextAI, generateObject, jsonSchema } from 'ai';
+/**
+ * Sanitize a plain JSON Schema for OpenAI strict structured output.
+ * - Adds `additionalProperties: false` to all object types
+ * - Strips unsupported keywords (minimum, maximum, default, pattern, etc.)
+ */
+const ALLOWED_KEYS = new Set([
+    'type', 'description', 'enum', 'const', 'anyOf', 'oneOf',
+    'properties', 'required', 'additionalProperties',
+    'items',
+]);
+function strictifySchema(schema) {
+    if (!schema || typeof schema !== 'object')
+        return schema;
+    const result = {};
+    for (const key of Object.keys(schema)) {
+        if (ALLOWED_KEYS.has(key)) {
+            result[key] = schema[key];
+        }
+    }
+    if (result.type === 'object') {
+        result.additionalProperties = false;
+        if (result.properties) {
+            result.properties = Object.fromEntries(Object.entries(result.properties).map(([k, v]) => [k, strictifySchema(v)]));
+        }
+    }
+    if (result.items) {
+        result.items = strictifySchema(result.items);
+    }
+    if (result.anyOf) {
+        result.anyOf = result.anyOf.map(strictifySchema);
+    }
+    if (result.oneOf) {
+        result.oneOf = result.oneOf.map(strictifySchema);
+    }
+    return result;
+}
+/** Check if a value is a Zod schema (has _def property). */
+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.
+ */
+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);
+    }
+    async generateText(options) {
+        const modelName = this.config.model || this.getDefaultModel();
+        const model = await this.getModel(modelName);
+        const result = await generateTextAI({
+            model,
+            system: options.system,
+            messages: options.messages,
+            ...(options.temperature !== undefined && { temperature: options.temperature }),
+            ...(options.maxTokens !== undefined && { maxTokens: options.maxTokens }),
+        });
+        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,
+            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.
+ */
+export function createVercelAIAdapter(config) {
+    return new VercelAIAdapter(config);
+}

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

@@ -0,0 +1,9 @@
+export interface VercelAIConfig {
+    provider: 'openai' | 'anthropic' | 'vertex' | 'openrouter';
+    apiKey: string;
+    model?: string;
+    baseUrl?: string;
+    projectId?: string;
+    location?: string;
+}
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,9 @@
+export { VercelAIAdapter } from './adapter';
+export type { VercelAIConfig } from './config';
+import { VercelAIAdapter } from './adapter';
+import type { VercelAIConfig } from './config';
+/**
+ * Create a Vercel AI SDK adapter from config.
+ */
+export declare function createVercelAIAdapter(config: VercelAIConfig): VercelAIAdapter;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/llm/vercel-ai/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,YAAY,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,cAAc,GAAG,eAAe,CAE7E"}

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

@@ -0,0 +1,8 @@
+export { VercelAIAdapter } from './adapter';
+import { VercelAIAdapter } from './adapter';
+/**
+ * Create a Vercel AI SDK adapter from config.
+ */
+export function createVercelAIAdapter(config) {
+    return new VercelAIAdapter(config);
+}

package/dist/esm/memory/cloudflare/index.d.ts

@@ -0,0 +1,3 @@
+export { CloudflareVectorizeMemory } from './vectorize';
+export type { CloudflareVectorizeMemoryOptions, VectorizeIndex } from './vectorize';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/memory/cloudflare/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/memory/cloudflare/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AACxD,YAAY,EAAE,gCAAgC,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

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

@@ -0,0 +1 @@
+export { CloudflareVectorizeMemory } from './vectorize';

package/dist/esm/memory/cloudflare/vectorize.d.ts

@@ -0,0 +1,62 @@
+import type { EmbeddingAdapter } from '../types';
+import type { SemanticMemory, SearchOptions, SearchResult } from '../semantic';
+/**
+ * Minimal Cloudflare Vectorize binding types.
+ * Avoids requiring @cloudflare/workers-types at compile time.
+ */
+export interface VectorizeIndex {
+    upsert(vectors: VectorizeVector[]): Promise<{
+        count: number;
+    }>;
+    query(vector: number[], options: {
+        topK: number;
+        returnMetadata?: 'all' | 'indexed' | 'none';
+        filter?: Record<string, unknown>;
+    }): Promise<{
+        matches: VectorizeMatch[];
+    }>;
+    deleteByIds(ids: string[]): Promise<{
+        count: number;
+    }>;
+}
+export interface VectorizeVector {
+    id: string;
+    values: number[];
+    metadata?: Record<string, unknown>;
+}
+export interface VectorizeMatch {
+    id: string;
+    score: number;
+    metadata?: Record<string, unknown>;
+}
+export interface CloudflareVectorizeMemoryOptions {
+    /** Cloudflare Vectorize index binding. */
+    index: VectorizeIndex;
+    /** Embedding provider (embed function + dimension). */
+    embedding: EmbeddingAdapter;
+}
+/**
+ * Cloudflare Vectorize-backed SemanticMemory.
+ *
+ * Stores original text in Vectorize metadata (10KB limit per vector,
+ * more than enough for chat messages).
+ *
+ * @example
+ * ```typescript
+ * const memory = new CloudflareVectorizeMemory({
+ *   index: env.VECTORIZE_INDEX,
+ *   embedding: cloudflareAIEmbedding({ ai: env.AI }),
+ * });
+ * await memory.store('The user likes coffee', { userId: '123' });
+ * const results = await memory.search('beverage preferences');
+ * ```
+ */
+export declare class CloudflareVectorizeMemory implements SemanticMemory {
+    private index;
+    private embedding;
+    constructor(options: CloudflareVectorizeMemoryOptions);
+    store(text: string, metadata?: Record<string, unknown>): Promise<string>;
+    search(query: string, options?: SearchOptions): Promise<SearchResult[]>;
+    delete(ids: string[]): Promise<void>;
+}
+//# sourceMappingURL=vectorize.d.ts.map

package/dist/esm/memory/cloudflare/vectorize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vectorize.d.ts","sourceRoot":"","sources":["../../../../src/memory/cloudflare/vectorize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE/E;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/D,KAAK,CACH,MAAM,EAAE,MAAM,EAAE,EAChB,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,cAAc,CAAC,EAAE,KAAK,GAAG,SAAS,GAAG,MAAM,CAAC;QAC5C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAClC,GACA,OAAO,CAAC;QAAE,OAAO,EAAE,cAAc,EAAE,CAAA;KAAE,CAAC,CAAC;IAC1C,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACxD;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,gCAAgC;IAC/C,0CAA0C;IAC1C,KAAK,EAAE,cAAc,CAAC;IACtB,uDAAuD;IACvD,SAAS,EAAE,gBAAgB,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,yBAA0B,YAAW,cAAc;IAC9D,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,SAAS,CAAmB;gBAExB,OAAO,EAAE,gCAAgC;IAK/C,KAAK,CACT,IAAI,EAAE,MAAM,EACZ,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACrC,OAAO,CAAC,MAAM,CAAC;IAOZ,MAAM,CACV,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,YAAY,EAAE,CAAC;IAqBpB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAK3C"}

package/dist/esm/memory/cloudflare/vectorize.js

@@ -0,0 +1,51 @@
+/**
+ * Cloudflare Vectorize-backed SemanticMemory.
+ *
+ * Stores original text in Vectorize metadata (10KB limit per vector,
+ * more than enough for chat messages).
+ *
+ * @example
+ * ```typescript
+ * const memory = new CloudflareVectorizeMemory({
+ *   index: env.VECTORIZE_INDEX,
+ *   embedding: cloudflareAIEmbedding({ ai: env.AI }),
+ * });
+ * await memory.store('The user likes coffee', { userId: '123' });
+ * const results = await memory.search('beverage preferences');
+ * ```
+ */
+export class CloudflareVectorizeMemory {
+    constructor(options) {
+        this.index = options.index;
+        this.embedding = options.embedding;
+    }
+    async store(text, metadata = {}) {
+        const id = crypto.randomUUID();
+        const values = await this.embedding.embed(text);
+        await this.index.upsert([{ id, values, metadata: { text, ...metadata } }]);
+        return id;
+    }
+    async search(query, options = {}) {
+        const topK = options.topK ?? 5;
+        const threshold = options.scoreThreshold ?? 0;
+        const vector = await this.embedding.embed(query);
+        const { matches } = await this.index.query(vector, {
+            topK,
+            returnMetadata: 'all',
+            filter: options.filter,
+        });
+        return matches
+            .filter((m) => m.score >= threshold)
+            .map((m) => ({
+            id: m.id,
+            text: m.metadata?.text ?? '',
+            score: m.score,
+            metadata: m.metadata ?? {},
+        }));
+    }
+    async delete(ids) {
+        if (ids.length > 0) {
+            await this.index.deleteByIds(ids);
+        }
+    }
+}

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

@@ -0,0 +1,16 @@
+import type { EmbeddingAdapter } from './types';
+import type { SemanticMemory, SearchOptions, SearchResult } from './semantic';
+/**
+ * In-memory SemanticMemory for local development and testing.
+ * Stores embeddings in a Map and performs brute-force cosine similarity search.
+ */
+export declare class InMemorySemanticMemory implements SemanticMemory {
+    private embedding;
+    private entries;
+    private counter;
+    constructor(embedding: EmbeddingAdapter);
+    store(text: string, metadata?: Record<string, unknown>): Promise<string>;
+    search(query: string, options?: SearchOptions): Promise<SearchResult[]>;
+    delete(ids: string[]): Promise<void>;
+}
+//# sourceMappingURL=in-memory-semantic.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-semantic.d.ts","sourceRoot":"","sources":["../../../src/memory/in-memory-semantic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAsB9E;;;GAGG;AACH,qBAAa,sBAAuB,YAAW,cAAc;IAI/C,OAAO,CAAC,SAAS;IAH7B,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,OAAO,CAAK;gBAEA,SAAS,EAAE,gBAAgB;IAEzC,KAAK,CACT,IAAI,EAAE,MAAM,EACZ,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACrC,OAAO,CAAC,MAAM,CAAC;IAOZ,MAAM,CACV,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,YAAY,EAAE,CAAC;IAsBpB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAK3C"}

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

@@ -0,0 +1,53 @@
+function cosineSimilarity(a, b) {
+    let dot = 0;
+    let normA = 0;
+    let normB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dot += a[i] * b[i];
+        normA += a[i] * a[i];
+        normB += b[i] * b[i];
+    }
+    const denom = Math.sqrt(normA) * Math.sqrt(normB);
+    return denom === 0 ? 0 : dot / denom;
+}
+/**
+ * In-memory SemanticMemory for local development and testing.
+ * Stores embeddings in a Map and performs brute-force cosine similarity search.
+ */
+export class InMemorySemanticMemory {
+    constructor(embedding) {
+        this.embedding = embedding;
+        this.entries = new Map();
+        this.counter = 0;
+    }
+    async store(text, metadata = {}) {
+        const id = `mem_${++this.counter}`;
+        const vector = await this.embedding.embed(text);
+        this.entries.set(id, { id, text, embedding: vector, metadata });
+        return id;
+    }
+    async search(query, options = {}) {
+        const topK = options.topK ?? 5;
+        const threshold = options.scoreThreshold ?? 0;
+        const queryVec = await this.embedding.embed(query);
+        const scored = [];
+        for (const entry of this.entries.values()) {
+            const score = cosineSimilarity(queryVec, entry.embedding);
+            if (score >= threshold) {
+                scored.push({
+                    id: entry.id,
+                    text: entry.text,
+                    score,
+                    metadata: entry.metadata,
+                });
+            }
+        }
+        scored.sort((a, b) => b.score - a.score);
+        return scored.slice(0, topK);
+    }
+    async delete(ids) {
+        for (const id of ids) {
+            this.entries.delete(id);
+        }
+    }
+}

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

@@ -0,0 +1,46 @@
+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)
+ */
+export declare class InMemoryEpisodeAdapter implements EpisodeAdapter, 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[]>;
+    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. */
+    clear(): void;
+}
+/** @deprecated Use InMemoryEpisodeAdapter */
+export declare const InMemoryEpisodeStore: typeof InMemoryEpisodeAdapter;
+/** @deprecated Use InMemoryEpisodeAdapter */
+export type InMemoryEpisodeStore = InMemoryEpisodeAdapter;
+//# sourceMappingURL=in-memory.d.ts.map

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

@@ -0,0 +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"}