@molroo-io/sdk 0.5.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-present molroo-io
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,251 @@
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/molroo-io/sdk/main/assets/logo-dark.png">
+    <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/molroo-io/sdk/main/assets/logo-light.png">
+    <img alt="molroo" src="https://raw.githubusercontent.com/molroo-io/sdk/main/assets/logo-light.png" width="180" />
+  </picture>
+</p>
+
+# @molroo-io/sdk
+
+[![version](https://img.shields.io/badge/version-0.4.0-e94560)](package.json)
+[![license](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.9-3178C6)](tsconfig.json)
+[![tests](https://img.shields.io/badge/tests-148-brightgreen)](src/__tests__)
+
+Thin client SDK for the [molroo](https://molroo.io) emotion engine API. Handles prompt assembly, LLM orchestration, and memory recall — so your app just calls `chat()`.
+
+## Install
+
+```bash
+npm install @molroo-io/sdk
+```
+
+## Quick Start
+
+```ts
+import { MolrooPersona } from '@molroo-io/sdk';
+import { createVercelAIAdapter } from '@molroo-io/sdk';
+
+const llm = createVercelAIAdapter({
+  provider: 'openai',
+  apiKey: process.env.OPENAI_API_KEY!,
+});
+
+const persona = await MolrooPersona.create({
+  baseUrl: 'https://api.molroo.io',
+  apiKey: 'mol_sk_your_api_key',
+  llm,
+}, {
+  identity: { name: 'Sera', coreValues: ['honesty', 'warmth'] },
+  personality: { O: 0.7, C: 0.6, E: 0.8, A: 0.5, N: 0.3, H: 0.6 },
+});
+
+const result = await persona.chat('Hello!');
+console.log(result.text);            // "Hey! It's great to meet you..."
+console.log(result.response.emotion); // { V: 0.4, A: 0.5, D: 0.2 }
+```
+
+## How It Works
+
+```
+   Your App                    SDK                          API (PersonaDO)
+      |                         |                               |
+      |  persona.chat(msg)      |                               |
+      |------------------------>|                               |
+      |                         |  POST /personas/:id/prompt-context
+      |                         |------------------------------>|
+      |                         |  { systemPrompt, tools }      |
+      |                         |<------------------------------|
+      |                         |                               |
+      |                         |  LLM call (your API key)      |
+      |                         |  system: systemPrompt         |
+      |                         |  -> { response, appraisal }   |
+      |                         |                               |
+      |                         |  POST /personas/:id/perceive  |
+      |                         |  { appraisal }                |
+      |                         |------------------------------>|
+      |                         |  { emotion, state }           |
+      |                         |<------------------------------|
+      |                         |                               |
+      |  { text, response }     |                               |
+      |<------------------------|                               |
+```
+
+1. **Get prompt context** — API builds system prompt from live emotional state (identity + personality + mood + somatic + narrative + memory)
+2. **LLM call** — SDK calls your LLM with assembled prompt. Returns response text + appraisal vector.
+3. **Perceive** — SDK sends appraisal to API. Engine processes emotion pipeline -> new VAD state.
+4. **Post-chat** — Episode saved, reflection triggered if needed, events emitted.
+
+The API does all emotion computation. The SDK just connects it to your LLM.
+
+## Two LLM Modes
+
+### Combined Mode (default)
+
+Single LLM call returns both response text and appraisal in one `generateObject()` call:
+
+```ts
+const persona = await MolrooPersona.create({
+  baseUrl, apiKey,
+  llm,  // one LLM handles everything
+}, personaConfig);
+```
+
+### Split Mode
+
+Separate LLM for appraisal (cheap/fast model) and response (quality model). Appraisal runs first -> engine updates emotion -> response generated with updated emotional state:
+
+```ts
+const persona = await MolrooPersona.create({
+  baseUrl, apiKey,
+  llm: responseModel,      // quality model for response text
+  engineLlm: appraisalModel, // cheap model for appraisal vector
+}, personaConfig);
+```
+
+## MolrooPersona API
+
+### Static Methods
+
+| Method | Description |
+|--------|-------------|
+| `MolrooPersona.create(config, personaConfig)` | Create a new persona |
+| `MolrooPersona.connect(config, personaId)` | Connect to an existing persona |
+| `MolrooPersona.listPersonas(config)` | List all personas |
+
+### Instance Methods
+
+| Method | Description |
+|--------|-------------|
+| `chat(message, options?)` | Full LLM orchestration: prompt -> LLM -> perceive -> result |
+| `perceive(message, options?)` | Send event to emotion engine (no LLM call) |
+| `tick(seconds)` | Advance time (mood decay, body recovery) |
+| `getState()` | Get current emotional state |
+| `setEmotion(vad)` | Direct VAD override |
+| `getPromptContext(suffix?, source?)` | Get server-assembled system prompt |
+| `searchMemory(query, options?)` | Search episodic memory |
+| `getSnapshot()` | Get full persona snapshot |
+| `putSnapshot(snapshot)` | Load persona snapshot |
+| `patch(config)` | Update persona config |
+| `destroy()` | Soft-delete the persona |
+| `restore()` | Restore a soft-deleted persona |
+
+### Config
+
+```ts
+interface MolrooPersonaConfig {
+  baseUrl: string;                      // API URL (e.g. 'https://api.molroo.io')
+  apiKey: string;                       // API key
+  llm?: LLMAdapter;                     // LLM for chat (optional - emotion-only without)
+  engineLlm?: LLMAdapter;              // Separate LLM for appraisal (split mode)
+  memory?: MemoryAdapter | MemoryConfig; // Single adapter or split config (optional)
+  recall?: RecallLimits;               // Recall limits for single adapter mode
+  events?: EventAdapter;               // Event emission (optional)
+}
+```
+
+## Adapters
+
+### LLM Adapter
+
+Required for `chat()`. Built into `@molroo-io/sdk`:
+
+```ts
+import { createVercelAIAdapter } from '@molroo-io/sdk';
+
+const llm = createVercelAIAdapter({
+  provider: 'openai',        // or 'anthropic', 'google'
+  apiKey: process.env.OPENAI_API_KEY!,
+  model: 'gpt-4o-mini',      // optional
+});
+```
+
+### Memory
+
+Client-side memory for episodic recall and semantic search. Optional — when not provided, memory recall is skipped.
+
+**Single adapter (recommended)** — pass one `MemoryAdapter` that handles everything:
+
+```ts
+import { SqliteMemoryAdapter } from '@molroo-io/sdk/memory/sqlite';
+
+const persona = await MolrooPersona.create({
+  baseUrl, apiKey, llm,
+  memory: new SqliteMemoryAdapter({ dbPath: './memory.db' }),
+  recall: { episodicLimit: 5, semanticLimit: 3 },  // optional limits
+}, personaConfig);
+```
+
+Built-in `InMemoryEpisodeAdapter` also works as a single adapter (for demos/testing):
+
+```ts
+import { InMemoryEpisodeAdapter } from '@molroo-io/sdk';
+
+const persona = await MolrooPersona.create({
+  baseUrl, apiKey, llm,
+  memory: new InMemoryEpisodeAdapter(),
+}, personaConfig);
+```
+
+**Split adapters (advanced)** — assemble episode store + vector search separately:
+
+```ts
+const persona = await MolrooPersona.create({
+  baseUrl, apiKey, llm,
+  memory: {
+    episodes: episodeStore,
+    semantic: vectorStore,
+    embedding: embeddingProvider,
+    recall: { episodicLimit: 5, semanticLimit: 3 },
+  },
+}, personaConfig);
+```
+
+### Events
+
+Optional event emission for logging, webhooks, or custom integrations:
+
+```ts
+import { ConsoleEventAdapter, WebhookEventAdapter } from '@molroo-io/sdk';
+
+// Console logging
+const events = new ConsoleEventAdapter();
+
+// Webhook
+const events = new WebhookEventAdapter({ url: 'https://...', secret: '...' });
+```
+
+## Persona Generation
+
+Generate a complete persona config from a description using LLM:
+
+```ts
+import { generatePersona } from '@molroo-io/sdk';
+
+const result = await generatePersona(llm, {
+  name: 'Sera',
+  description: 'A cheerful companion who loves music',
+});
+// result.config -> full PersonaConfigData
+```
+
+## Build & Test
+
+```bash
+npm run build      # tsc -> dist/cjs + dist/esm
+npm run test       # Vitest (148 tests)
+npm run lint       # ESLint
+npm run gen:types  # openapi-typescript -> src/generated/api.d.ts
+npm run docs       # TypeDoc -> SDK API reference
+```
+
+## Links
+
+- [Documentation](https://docs.molroo.io)
+- [Dashboard](https://molroo.io/dashboard)
+- [API Reference](https://api.molroo.io/docs)
+
+## License
+
+MIT

package/dist/cjs/api-client.d.ts

@@ -0,0 +1,23 @@
+import type { paths } from './generated/api';
+/**
+ * Create a typed openapi-fetch client for the molroo API.
+ *
+ * @param baseUrl - API base URL (e.g., 'https://api.molroo.io').
+ * @param apiKey - API key for authentication.
+ * @returns A fully-typed openapi-fetch client instance.
+ */
+export declare function createApiClient(baseUrl: string, apiKey: string): import("openapi-fetch").Client<paths, `${string}/${string}`>;
+export type ApiClient = ReturnType<typeof createApiClient>;
+/**
+ * Unwrap the `{ result: T }` envelope from API responses.
+ *
+ * Many API endpoints return `ResultWrapper` (typed as `{ result?: unknown }`)
+ * in the OpenAPI spec. This helper extracts the `result` field and casts it
+ * to the expected type.
+ *
+ * For endpoints with properly-typed response schemas, use `data.result` directly.
+ */
+export declare function unwrap<T>(data: {
+    result?: unknown;
+} | undefined): T;
+//# sourceMappingURL=api-client.d.ts.map

package/dist/cjs/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../../src/api-client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAwB7C;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,gEAU9D;AAED,MAAM,MAAM,SAAS,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;AAE3D;;;;;;;;GAQG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,GAAG,CAAC,CAEnE"}

package/dist/cjs/api-client.js

@@ -0,0 +1,55 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createApiClient = createApiClient;
+exports.unwrap = unwrap;
+const openapi_fetch_1 = __importDefault(require("openapi-fetch"));
+const errors_1 = require("./errors");
+/**
+ * Middleware: throw MolrooApiError on non-OK responses.
+ *
+ * Reads the error body `{ error: { code, message } }` and converts it
+ * into a typed MolrooApiError before openapi-fetch processes the response.
+ */
+const errorMiddleware = {
+    async onResponse({ response }) {
+        if (!response.ok) {
+            const body = await response.clone().json().catch(() => ({}));
+            const err = body;
+            throw new errors_1.MolrooApiError(err.error?.message ?? `API error ${response.status}`, err.error?.code ?? 'UNKNOWN', response.status);
+        }
+        // Return undefined to let openapi-fetch handle the response unchanged
+    },
+};
+/**
+ * Create a typed openapi-fetch client for the molroo API.
+ *
+ * @param baseUrl - API base URL (e.g., 'https://api.molroo.io').
+ * @param apiKey - API key for authentication.
+ * @returns A fully-typed openapi-fetch client instance.
+ */
+function createApiClient(baseUrl, apiKey) {
+    const client = (0, openapi_fetch_1.default)({
+        baseUrl: baseUrl.replace(/\/$/, ''),
+        headers: {
+            'Content-Type': 'application/json',
+            'X-API-Key': apiKey,
+        },
+    });
+    client.use(errorMiddleware);
+    return client;
+}
+/**
+ * Unwrap the `{ result: T }` envelope from API responses.
+ *
+ * Many API endpoints return `ResultWrapper` (typed as `{ result?: unknown }`)
+ * in the OpenAPI spec. This helper extracts the `result` field and casts it
+ * to the expected type.
+ *
+ * For endpoints with properly-typed response schemas, use `data.result` directly.
+ */
+function unwrap(data) {
+    return (data?.result ?? {});
+}

package/dist/cjs/defaults/index.d.ts

@@ -0,0 +1,8 @@
+import type { PersonaConfigData } from '../types.js';
+export declare const DEFAULT_PERSONA: PersonaConfigData;
+/**
+ * Merge user-provided persona config with defaults.
+ * User values take precedence; defaults fill missing fields.
+ */
+export declare function withDefaults(config?: Partial<PersonaConfigData>): PersonaConfigData;
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/defaults/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/defaults/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,eAAO,MAAM,eAAe,EAAE,iBAAkC,CAAC;AAEjE;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,iBAAiB,CAenF"}

package/dist/cjs/defaults/index.js

@@ -0,0 +1,30 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_PERSONA = void 0;
+exports.withDefaults = withDefaults;
+const persona_json_1 = __importDefault(require("./persona.json"));
+exports.DEFAULT_PERSONA = persona_json_1.default;
+/**
+ * Merge user-provided persona config with defaults.
+ * User values take precedence; defaults fill missing fields.
+ */
+function withDefaults(config) {
+    if (!config)
+        return { ...exports.DEFAULT_PERSONA };
+    return {
+        ...exports.DEFAULT_PERSONA,
+        ...config,
+        personality: {
+            ...exports.DEFAULT_PERSONA.personality,
+            ...config.personality,
+        },
+        identity: {
+            ...exports.DEFAULT_PERSONA.identity,
+            ...config.identity,
+        },
+        goals: config.goals ?? exports.DEFAULT_PERSONA.goals,
+    };
+}

package/dist/cjs/defaults/persona.json

@@ -0,0 +1,17 @@
+{
+    "personality": {
+        "O": 0.5,
+        "C": 0.5,
+        "E": 0.5,
+        "A": 0.5,
+        "N": 0.5,
+        "H": 0.5
+    },
+    "identity": {
+        "name": "Persona",
+        "role": "A person with a neutral, balanced personality.",
+        "speakingStyle": "Natural, conversational tone.",
+        "coreValues": ["honesty", "kindness"]
+    },
+    "goals": []
+}

package/dist/cjs/embedding/cloudflare.d.ts

@@ -0,0 +1,15 @@
+import type { EmbeddingAdapter } from '../memory/types';
+export interface AiBinding {
+    run(model: string, input: {
+        text: string[];
+    }): Promise<{
+        data: number[][];
+    }>;
+}
+export interface CloudflareAIEmbeddingOptions {
+    ai: AiBinding;
+    model?: string;
+    dimension?: number;
+}
+export declare function cloudflareAIEmbedding(options: CloudflareAIEmbeddingOptions): EmbeddingAdapter;
+//# sourceMappingURL=cloudflare.d.ts.map

package/dist/cjs/embedding/cloudflare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudflare.d.ts","sourceRoot":"","sources":["../../../src/embedding/cloudflare.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,MAAM,WAAW,SAAS;IACxB,GAAG,CACD,KAAK,EAAE,MAAM,EACb,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,GACxB,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAA;KAAE,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,4BAA4B;IAC3C,EAAE,EAAE,SAAS,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAKD,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,4BAA4B,GACpC,gBAAgB,CAWlB"}

package/dist/cjs/embedding/cloudflare.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cloudflareAIEmbedding = cloudflareAIEmbedding;
+const DEFAULT_MODEL = '@cf/baai/bge-base-en-v1.5';
+const DEFAULT_DIMENSION = 768;
+function cloudflareAIEmbedding(options) {
+    const model = options.model ?? DEFAULT_MODEL;
+    const dimension = options.dimension ?? DEFAULT_DIMENSION;
+    return {
+        dimension,
+        async embed(text) {
+            const result = await options.ai.run(model, { text: [text] });
+            return result.data[0];
+        },
+    };
+}

package/dist/cjs/embedding/cohere.d.ts

@@ -0,0 +1,8 @@
+import type { EmbeddingAdapter } from '../memory/types';
+export interface CohereEmbeddingOptions {
+    apiKey: string;
+    model?: string;
+    inputType?: 'search_document' | 'search_query';
+}
+export declare function cohereEmbedding(options: CohereEmbeddingOptions): EmbeddingAdapter;
+//# sourceMappingURL=cohere.d.ts.map

package/dist/cjs/embedding/cohere.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cohere.d.ts","sourceRoot":"","sources":["../../../src/embedding/cohere.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,iBAAiB,GAAG,cAAc,CAAC;CAChD;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,gBAAgB,CA4BjF"}

package/dist/cjs/embedding/cohere.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cohereEmbedding = cohereEmbedding;
+function cohereEmbedding(options) {
+    const model = options.model ?? 'embed-english-v3.0';
+    const inputType = options.inputType ?? 'search_document';
+    const dimension = model.includes('v3') ? 1024 : 768;
+    return {
+        dimension,
+        embed: async (text) => {
+            const res = await fetch('https://api.cohere.com/v2/embed', {
+                method: 'POST',
+                headers: {
+                    'Authorization': `Bearer ${options.apiKey}`,
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({
+                    model,
+                    texts: [text],
+                    input_type: inputType,
+                    embedding_types: ['float'],
+                }),
+            });
+            if (!res.ok) {
+                throw new Error(`Cohere embedding failed: ${res.status} ${res.statusText}`);
+            }
+            const json = await res.json();
+            return json.embeddings.float[0];
+        },
+    };
+}

package/dist/cjs/embedding/index.d.ts

@@ -0,0 +1,9 @@
+export { openaiEmbedding } from './openai';
+export { cohereEmbedding } from './cohere';
+export { createLocalEmbedder } from './local';
+export { cloudflareAIEmbedding } from './cloudflare';
+export type { OpenAIEmbeddingOptions } from './openai';
+export type { CohereEmbeddingOptions } from './cohere';
+export type { LocalEmbedderOptions } from './local';
+export type { CloudflareAIEmbeddingOptions, AiBinding } from './cloudflare';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/embedding/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/embedding/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,YAAY,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AACvD,YAAY,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AACvD,YAAY,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AACpD,YAAY,EAAE,4BAA4B,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC"}

package/dist/cjs/embedding/index.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cloudflareAIEmbedding = exports.createLocalEmbedder = exports.cohereEmbedding = exports.openaiEmbedding = void 0;
+var openai_1 = require("./openai");
+Object.defineProperty(exports, "openaiEmbedding", { enumerable: true, get: function () { return openai_1.openaiEmbedding; } });
+var cohere_1 = require("./cohere");
+Object.defineProperty(exports, "cohereEmbedding", { enumerable: true, get: function () { return cohere_1.cohereEmbedding; } });
+var local_1 = require("./local");
+Object.defineProperty(exports, "createLocalEmbedder", { enumerable: true, get: function () { return local_1.createLocalEmbedder; } });
+var cloudflare_1 = require("./cloudflare");
+Object.defineProperty(exports, "cloudflareAIEmbedding", { enumerable: true, get: function () { return cloudflare_1.cloudflareAIEmbedding; } });

package/dist/cjs/embedding/local.d.ts

@@ -0,0 +1,6 @@
+import type { EmbeddingAdapter } from '../memory/types';
+export interface LocalEmbedderOptions {
+    model?: string;
+}
+export declare function createLocalEmbedder(options?: LocalEmbedderOptions): Promise<EmbeddingAdapter>;
+//# sourceMappingURL=local.d.ts.map

package/dist/cjs/embedding/local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../../src/embedding/local.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,mBAAmB,CACvC,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,gBAAgB,CAAC,CA4B3B"}

package/dist/cjs/embedding/local.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createLocalEmbedder = createLocalEmbedder;
+async function createLocalEmbedder(options) {
+    const modelId = options?.model ?? 'Xenova/all-MiniLM-L6-v2';
+    let pipeline;
+    try {
+        const transformers = await Function('return import("@huggingface/transformers")')();
+        pipeline = transformers.pipeline;
+    }
+    catch {
+        throw new Error('@huggingface/transformers is required for local embeddings. ' +
+            'Install it: npm install @huggingface/transformers');
+    }
+    const extractor = await pipeline('feature-extraction', modelId);
+    const probe = await extractor('test', { pooling: 'mean', normalize: true });
+    const dimension = probe.data.length;
+    return {
+        dimension,
+        embed: async (text) => {
+            const output = await extractor(text, {
+                pooling: 'mean',
+                normalize: true,
+            });
+            return Array.from(output.data);
+        },
+    };
+}

package/dist/cjs/embedding/openai.d.ts

@@ -0,0 +1,9 @@
+import type { EmbeddingAdapter } from '../memory/types';
+export interface OpenAIEmbeddingOptions {
+    apiKey: string;
+    model?: string;
+    dimension?: number;
+    baseUrl?: string;
+}
+export declare function openaiEmbedding(options: OpenAIEmbeddingOptions): EmbeddingAdapter;
+//# sourceMappingURL=openai.d.ts.map

package/dist/cjs/embedding/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../../src/embedding/openai.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,gBAAgB,CAuBjF"}

package/dist/cjs/embedding/openai.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.openaiEmbedding = openaiEmbedding;
+function openaiEmbedding(options) {
+    const model = options.model ?? 'text-embedding-3-small';
+    const dimension = options.dimension ?? 1536;
+    const baseUrl = options.baseUrl ?? 'https://api.openai.com';
+    return {
+        dimension,
+        embed: async (text) => {
+            const res = await fetch(`${baseUrl}/v1/embeddings`, {
+                method: 'POST',
+                headers: {
+                    'Authorization': `Bearer ${options.apiKey}`,
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({ model, input: text, dimensions: dimension }),
+            });
+            if (!res.ok) {
+                throw new Error(`OpenAI embedding failed: ${res.status} ${res.statusText}`);
+            }
+            const json = await res.json();
+            return json.data[0].embedding;
+        },
+    };
+}

package/dist/cjs/errors.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Error thrown when the molroo API returns a non-OK response.
+ *
+ * Contains the API error code and HTTP status for programmatic handling.
+ */
+export declare class MolrooApiError extends Error {
+    /** Machine-readable error code (e.g., 'ENTITY_NOT_FOUND', 'UNAUTHORIZED'). */
+    code: string;
+    /** HTTP status code. */
+    status: number;
+    constructor(message: string, 
+    /** Machine-readable error code (e.g., 'ENTITY_NOT_FOUND', 'UNAUTHORIZED'). */
+    code: string, 
+    /** HTTP status code. */
+    status: number);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/cjs/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,cAAe,SAAQ,KAAK;IAGrC,8EAA8E;IACvE,IAAI,EAAE,MAAM;IACnB,wBAAwB;IACjB,MAAM,EAAE,MAAM;gBAJrB,OAAO,EAAE,MAAM;IACf,8EAA8E;IACvE,IAAI,EAAE,MAAM;IACnB,wBAAwB;IACjB,MAAM,EAAE,MAAM;CAKxB"}

package/dist/cjs/errors.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MolrooApiError = void 0;
+/**
+ * Error thrown when the molroo API returns a non-OK response.
+ *
+ * Contains the API error code and HTTP status for programmatic handling.
+ */
+class MolrooApiError extends Error {
+    constructor(message, 
+    /** Machine-readable error code (e.g., 'ENTITY_NOT_FOUND', 'UNAUTHORIZED'). */
+    code, 
+    /** HTTP status code. */
+    status) {
+        super(message);
+        this.code = code;
+        this.status = status;
+        this.name = 'MolrooApiError';
+    }
+}
+exports.MolrooApiError = MolrooApiError;