@memtensor/memos-local-openclaw-plugin 0.1.0

package/.env.example

@@ -0,0 +1,11 @@
+# Embedding API
+# Use any OpenAI-compatible embedding service, or leave blank for local offline model
+EMBEDDING_API_KEY=your-embedding-api-key
+EMBEDDING_ENDPOINT=https://api.openai.com/v1
+EMBEDDING_MODEL=text-embedding-3-small
+
+# Summarizer API (OpenAI-compatible)
+# Leave blank to use rule-based fallback (no LLM needed)
+SUMMARIZER_API_KEY=your-summarizer-api-key
+SUMMARIZER_ENDPOINT=https://api.openai.com/v1
+SUMMARIZER_MODEL=gpt-4o-mini

package/README.md

@@ -0,0 +1,251 @@
+# 🦞 MemOS Local — OpenClaw Memory Plugin
+
+Persistent local conversation memory for [OpenClaw](https://github.com/nicepkg/openclaw) AI Agents. Every conversation is automatically captured, semantically indexed, and instantly recallable.
+
+**Full-write | Hybrid Search (FTS5 + Vector) | RRF Fusion | MMR Diversity | Recency Decay**
+
+## Features
+
+- **Auto-capture** — Stores user, assistant, and tool messages after each agent turn
+- **Semantic chunking** — Preserves complete code blocks, function bodies, and paragraph boundaries
+- **Hybrid retrieval** — FTS5 keyword + vector semantic dual-channel search with RRF fusion
+- **LLM summarization** — One-sentence summary per chunk for fast browsing
+- **Multi-provider** — OpenAI, Anthropic, Gemini, Cohere, Voyage, Mistral, Bedrock, or local offline
+- **Web viewer** — Built-in dashboard at `http://127.0.0.1:18799` with CRUD, search, filters, pagination
+- **Privacy first** — All data in local SQLite, no cloud uploads, password-protected viewer
+
+## Quick Start
+
+### 1. Install
+
+```bash
+openclaw plugins install memos-local
+```
+
+Or from source:
+
+```bash
+git clone https://github.com/MemTensor/MemOS.git
+cd MemOS/apps/memos-local-openclaw-plugin
+npm install && npm run build
+openclaw plugins install .
+```
+
+### 2. Configure
+
+Add the plugin config to `~/.openclaw/openclaw.json`:
+
+```jsonc
+{
+  "plugins": {
+    "slots": {
+      "memory": "memos-local"
+    },
+    "entries": {
+      "memos-local": {
+        "enabled": true,
+        "config": {
+          "embedding": {
+            "provider": "openai_compatible",
+            "endpoint": "https://your-embedding-api.com/v1",
+            "apiKey": "your-embedding-key",
+            "model": "bge-m3"
+          },
+          "summarizer": {
+            "provider": "openai_compatible",
+            "endpoint": "https://api.openai.com/v1",
+            "apiKey": "sk-xxx",
+            "model": "gpt-4o-mini",
+            "temperature": 0
+          }
+        }
+      }
+    }
+  }
+}
+```
+
+#### Embedding Provider Options
+
+| Provider | `provider` value | Example `model` | Notes |
+|---|---|---|---|
+| OpenAI / compatible | `openai_compatible` | `bge-m3`, `text-embedding-3-small` | Any OpenAI-compatible API |
+| Gemini | `gemini` | `text-embedding-004` | Requires `apiKey` |
+| Cohere | `cohere` | `embed-english-v3.0` | Separates document/query embedding |
+| Voyage | `voyage` | `voyage-2` | |
+| Mistral | `mistral` | `mistral-embed` | |
+| Local (offline) | `local` | — | Uses `Xenova/all-MiniLM-L6-v2`, no API needed |
+
+> **No embedding config?** The plugin falls back to the local model automatically. You can start with zero configuration and add a cloud provider later for better quality.
+
+#### Summarizer Provider Options
+
+| Provider | `provider` value | Example `model` |
+|---|---|---|
+| OpenAI / compatible | `openai_compatible` | `gpt-4o-mini` |
+| Anthropic | `anthropic` | `claude-3-haiku-20240307` |
+| Gemini | `gemini` | `gemini-1.5-flash` |
+| AWS Bedrock | `bedrock` | `anthropic.claude-3-haiku-20240307-v1:0` |
+
+> **No summarizer config?** A rule-based fallback generates summaries from the first sentence + key entities. Good enough to start.
+
+#### Environment Variable Support
+
+Use `${ENV_VAR}` placeholders in config to avoid hardcoding keys:
+
+```jsonc
+{
+  "apiKey": "${OPENAI_API_KEY}"
+}
+```
+
+### 3. Restart Gateway
+
+```bash
+openclaw gateway stop
+openclaw gateway install
+openclaw gateway start
+```
+
+### 4. Verify Installation
+
+```bash
+# Check the gateway log
+tail -20 ~/.openclaw/logs/gateway.log
+```
+
+You should see:
+
+```
+memos-local: initialized (db: ~/.openclaw/memos-local/memos.db)
+memos-local: started (embedding: openai_compatible)
+╔══════════════════════════════════════════╗
+║  MemOS Memory Viewer                     ║
+║  → http://127.0.0.1:18799               ║
+║  Open in browser to manage memories       ║
+╚══════════════════════════════════════════╝
+```
+
+### 5. Verify Memory is Working
+
+**Step A** — Have a conversation with your OpenClaw agent about anything.
+
+**Step B** — Open the Memory Viewer at `http://127.0.0.1:18799` and check that the conversation appears.
+
+**Step C** — In a new conversation, ask the agent to recall what you discussed:
+
+```
+You: Do you remember what we talked about?
+Agent: (calls memory_search) Yes, we discussed...
+```
+
+**Step D** — Check the gateway log for ingest activity:
+
+```bash
+grep -E "Stored chunk|Chunked turn|Dedup" ~/.openclaw/logs/gateway.log | tail -10
+```
+
+You should see lines like:
+
+```
+Chunked turn=1772459198930-839rr3 into 3 chunks
+Stored chunk=667f289e kind=paragraph len=392 hasVec=true
+Stored chunk=107d7f32 kind=tool_result role=tool len=210 hasVec=true
+```
+
+### 6. Run the Smoke Test (Optional)
+
+For a comprehensive end-to-end test with your actual API:
+
+```bash
+# Create a .env file with your keys
+cp .env.example .env
+# Edit .env with your actual API keys
+
+# Run the smoke test
+npx tsx scripts/smoke-test.ts
+```
+
+The smoke test writes test conversations, searches for them, verifies timeline and get operations, and checks anti-writeback protection.
+
+## Agent Tools
+
+The plugin registers 4 tools that your agent can use:
+
+| Tool | Purpose |
+|---|---|
+| `memory_search` | Search memories by natural language query |
+| `memory_timeline` | Get surrounding context for a search hit |
+| `memory_get` | Get full original text of a memory chunk |
+| `memory_viewer` | Get the URL of the web dashboard |
+
+The agent uses these automatically via the SKILL.md prompt guide.
+
+## Memory Viewer
+
+Open `http://127.0.0.1:18799` in your browser:
+
+- First visit: set a password (min 4 chars)
+- Browse, search, create, edit, delete memories
+- Filter by role (user/assistant/tool), type, time range (down to seconds)
+- Pagination (30 per page)
+
+**Forgot password?** Click "Forgot password?" on the login page and use the reset token from the gateway log:
+
+```bash
+grep "reset token" ~/.openclaw/logs/gateway.log | tail -1
+```
+
+## Advanced Configuration
+
+All optional — shown with defaults:
+
+```jsonc
+{
+  "config": {
+    "recall": {
+      "maxResultsDefault": 6,     // Default search results
+      "maxResultsMax": 20,        // Max search results
+      "minScoreDefault": 0.45,    // Default min score threshold
+      "minScoreFloor": 0.35,      // Lowest allowed min score
+      "rrfK": 60,                 // RRF fusion constant
+      "mmrLambda": 0.7,           // MMR relevance vs diversity (0-1)
+      "recencyHalfLifeDays": 14   // Time decay half-life
+    },
+    "dedup": {
+      "similarityThreshold": 0.93 // Cosine similarity for dedup
+    },
+    "viewerPort": 18799           // Memory Viewer port
+  }
+}
+```
+
+## How It Works
+
+**Write path** (automatic on every agent turn):
+
+```
+Conversation → Capture (filter roles) → Semantic Chunk → LLM Summarize
+→ Embed → Dedup Check → Store (SQLite + FTS5 + Vector)
+```
+
+**Read path** (when agent calls `memory_search`):
+
+```
+Query → FTS5 + Vector dual recall → RRF Fusion → MMR Rerank
+→ Recency Decay → Score Filter → Top-K Results
+```
+
+See [full documentation](www/docs/) for detailed architecture and algorithm explanations.
+
+## Data Location
+
+| File | Path |
+|---|---|
+| Database | `~/.openclaw/memos-local/memos.db` |
+| Viewer auth | `~/.openclaw/memos-local/viewer-auth.json` |
+| Gateway log | `~/.openclaw/logs/gateway.log` |
+
+## License
+
+MIT

package/SKILL.md

@@ -0,0 +1,43 @@
+# Memory Recall Skill — memos-local
+
+You have access to long-term conversation memory through three tools:
+`memory_search`, `memory_timeline`, `memory_get`.
+
+## When to Search
+
+- **DO search** when the user asks about a previous conversation, a specific detail (command, error, parameter, decision) you don't have in the current context, or when the topic clearly references past interactions.
+- **DO NOT search** when the current context already contains enough information to answer accurately.
+
+## Progressive Recall Chain
+
+Follow this 3-step chain. Stop as soon as you have sufficient evidence.
+
+### Step 1 — `memory_search`
+
+Start with the default call (no extra parameters → top 6 results, minScore 0.45).
+
+- If results are insufficient, **refine the query first** (add entity names, exact commands, error keywords).
+- If still insufficient, increase `maxResults` to 12, then 20.
+- As a last resort, lower `minScore` to 0.35.
+- **Never repeat the exact same query with the same parameters** — vary query wording or adjust parameters.
+
+### Step 2 — `memory_timeline`
+
+When a search hit looks relevant but the `original_excerpt` is too short to confirm, call `memory_timeline` with the hit's `ref` to get surrounding context (±2 turns by default).
+
+### Step 3 — `memory_get`
+
+When you need the exact original text (to verify a command, a code snippet, an error stack), call `memory_get` with the `ref` and request up to 2000 characters (max 8000).
+
+## How to Answer
+
+1. **Evidence-based**: Only state facts backed by `original_excerpt`, timeline entries, or `memory_get` content. Do not fabricate details.
+2. **Cite sources**: When referencing a memory, mention the approximate time and context (e.g., "In our conversation about deploying the API…").
+3. **Acknowledge gaps**: If memory search returns no relevant results, say so honestly rather than guessing.
+
+## Anti-Patterns to Avoid
+
+- Searching on every single turn (only search when needed).
+- Repeating the same failed query without modification.
+- Ignoring `original_excerpt` and only using `summary` — the excerpt is the primary evidence.
+- Making claims based solely on `summary` without checking the original text when details matter.

package/dist/capture/index.d.ts

@@ -0,0 +1,16 @@
+import type { ConversationMessage, Logger } from "../types";
+/**
+ * Filter and extract writable messages from a conversation turn.
+ *
+ * - Keep user, assistant, and tool messages
+ * - Skip system prompts
+ * - Skip tool results from our own memory tools (prevents memory loop)
+ * - Truncate long tool results to avoid storage bloat
+ * - Strip injected evidence blocks wrapped in [STORED_MEMORY]...[/STORED_MEMORY]
+ */
+export declare function captureMessages(messages: Array<{
+    role: string;
+    content: string;
+    toolName?: string;
+}>, sessionKey: string, turnId: string, evidenceTag: string, log: Logger): ConversationMessage[];
+//# sourceMappingURL=index.d.ts.map

package/dist/capture/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/capture/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAQ,MAAM,EAAE,MAAM,UAAU,CAAC;AAYlE;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,EACrE,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,MAAM,GACV,mBAAmB,EAAE,CA+CvB"}

package/dist/capture/index.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.captureMessages = captureMessages;
+const types_1 = require("../types");
+const SKIP_ROLES = new Set(["system"]);
+const SELF_TOOLS = new Set([
+    "memory_search",
+    "memory_timeline",
+    "memory_get",
+    "memory_viewer",
+]);
+/**
+ * Filter and extract writable messages from a conversation turn.
+ *
+ * - Keep user, assistant, and tool messages
+ * - Skip system prompts
+ * - Skip tool results from our own memory tools (prevents memory loop)
+ * - Truncate long tool results to avoid storage bloat
+ * - Strip injected evidence blocks wrapped in [STORED_MEMORY]...[/STORED_MEMORY]
+ */
+function captureMessages(messages, sessionKey, turnId, evidenceTag, log) {
+    const now = Date.now();
+    const result = [];
+    for (const msg of messages) {
+        const role = msg.role;
+        if (SKIP_ROLES.has(role))
+            continue;
+        if (!msg.content || msg.content.trim().length === 0)
+            continue;
+        if (role === "tool") {
+            if (msg.toolName && SELF_TOOLS.has(msg.toolName)) {
+                log.debug(`Skipping self-tool result: ${msg.toolName}`);
+                continue;
+            }
+            let content = msg.content.trim();
+            const maxChars = types_1.DEFAULTS.toolResultMaxChars;
+            if (content.length > maxChars) {
+                content = content.slice(0, maxChars) + `\n\n[truncated — original ${content.length} chars]`;
+            }
+            const toolLabel = msg.toolName ? `[tool:${msg.toolName}] ` : "[tool] ";
+            result.push({
+                role: "tool",
+                content: toolLabel + content,
+                timestamp: now,
+                turnId,
+                sessionKey,
+                toolName: msg.toolName,
+            });
+            continue;
+        }
+        const cleaned = stripEvidenceBlocks(msg.content, evidenceTag);
+        if (cleaned.trim().length === 0)
+            continue;
+        result.push({
+            role,
+            content: cleaned,
+            timestamp: now,
+            turnId,
+            sessionKey,
+        });
+    }
+    log.debug(`Captured ${result.length}/${messages.length} messages for session=${sessionKey} turn=${turnId}`);
+    return result;
+}
+function stripEvidenceBlocks(text, tag) {
+    const openTag = `[${tag}]`;
+    const closeTag = `[/${tag}]`;
+    let result = text;
+    let safety = 0;
+    while (result.includes(openTag) && result.includes(closeTag) && safety < 50) {
+        const start = result.indexOf(openTag);
+        const end = result.indexOf(closeTag, start);
+        if (end === -1)
+            break;
+        result = result.slice(0, start) + result.slice(end + closeTag.length);
+        safety++;
+    }
+    return result;
+}
+//# sourceMappingURL=index.js.map

package/dist/capture/index.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,4 @@
+import { type MemosLocalConfig, type PluginContext, type Logger } from "./types";
+export declare function resolveConfig(raw: Partial<MemosLocalConfig> | undefined, stateDir: string): MemosLocalConfig;
+export declare function buildContext(stateDir: string, workspaceDir: string, rawConfig: Partial<MemosLocalConfig> | undefined, log?: Logger): PluginContext;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,KAAK,gBAAgB,EAAE,KAAK,aAAa,EAAE,KAAK,MAAM,EAAE,MAAM,SAAS,CAAC;AAqB3F,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAuB5G;AAED,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,SAAS,EAChD,GAAG,CAAC,EAAE,MAAM,GACX,aAAa,CAcf"}

package/dist/config.js

@@ -0,0 +1,96 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveConfig = resolveConfig;
+exports.buildContext = buildContext;
+const path = __importStar(require("path"));
+const types_1 = require("./types");
+const ENV_RE = /\$\{([A-Z_][A-Z0-9_]*)\}/g;
+function resolveEnvVars(value) {
+    return value.replace(ENV_RE, (_, name) => process.env[name] ?? "");
+}
+function deepResolveEnv(obj) {
+    if (typeof obj === "string")
+        return resolveEnvVars(obj);
+    if (Array.isArray(obj))
+        return obj.map(deepResolveEnv);
+    if (obj && typeof obj === "object") {
+        const out = {};
+        for (const [k, v] of Object.entries(obj)) {
+            out[k] = deepResolveEnv(v);
+        }
+        return out;
+    }
+    return obj;
+}
+function resolveConfig(raw, stateDir) {
+    const cfg = deepResolveEnv(raw ?? {});
+    return {
+        ...cfg,
+        storage: {
+            dbPath: cfg.storage?.dbPath ?? path.join(stateDir, "memos-local", "memos.db"),
+        },
+        recall: {
+            maxResultsDefault: cfg.recall?.maxResultsDefault ?? types_1.DEFAULTS.maxResultsDefault,
+            maxResultsMax: cfg.recall?.maxResultsMax ?? types_1.DEFAULTS.maxResultsMax,
+            minScoreDefault: cfg.recall?.minScoreDefault ?? types_1.DEFAULTS.minScoreDefault,
+            minScoreFloor: cfg.recall?.minScoreFloor ?? types_1.DEFAULTS.minScoreFloor,
+            rrfK: cfg.recall?.rrfK ?? types_1.DEFAULTS.rrfK,
+            mmrLambda: cfg.recall?.mmrLambda ?? types_1.DEFAULTS.mmrLambda,
+            recencyHalfLifeDays: cfg.recall?.recencyHalfLifeDays ?? types_1.DEFAULTS.recencyHalfLifeDays,
+        },
+        dedup: {
+            similarityThreshold: cfg.dedup?.similarityThreshold ?? types_1.DEFAULTS.dedupSimilarityThreshold,
+        },
+        capture: {
+            evidenceWrapperTag: cfg.capture?.evidenceWrapperTag ?? types_1.DEFAULTS.evidenceWrapperTag,
+        },
+    };
+}
+function buildContext(stateDir, workspaceDir, rawConfig, log) {
+    const defaultLog = {
+        debug: (...args) => console.debug("[memos-local]", ...args),
+        info: (...args) => console.info("[memos-local]", ...args),
+        warn: (...args) => console.warn("[memos-local]", ...args),
+        error: (...args) => console.error("[memos-local]", ...args),
+    };
+    return {
+        stateDir,
+        workspaceDir,
+        config: resolveConfig(rawConfig, stateDir),
+        log: log ?? defaultLog,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/embedding/index.d.ts

@@ -0,0 +1,12 @@
+import type { EmbeddingConfig, Logger } from "../types";
+export declare class Embedder {
+    private cfg;
+    private log;
+    constructor(cfg: EmbeddingConfig | undefined, log: Logger);
+    get provider(): string;
+    get dimensions(): number;
+    embed(texts: string[]): Promise<number[][]>;
+    embedQuery(text: string): Promise<number[]>;
+    private embedBatch;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/embedding/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAQxD,qBAAa,QAAQ;IAEjB,OAAO,CAAC,GAAG;IACX,OAAO,CAAC,GAAG;gBADH,GAAG,EAAE,eAAe,GAAG,SAAS,EAChC,GAAG,EAAE,MAAM;IAGrB,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,IAAI,UAAU,IAAI,MAAM,CAGvB;IAEK,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;IAa3C,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;YAQnC,UAAU;CA+BzB"}

package/dist/embedding/index.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Embedder = void 0;
+const openai_1 = require("./providers/openai");
+const gemini_1 = require("./providers/gemini");
+const cohere_1 = require("./providers/cohere");
+const voyage_1 = require("./providers/voyage");
+const mistral_1 = require("./providers/mistral");
+const local_1 = require("./local");
+class Embedder {
+    cfg;
+    log;
+    constructor(cfg, log) {
+        this.cfg = cfg;
+        this.log = log;
+    }
+    get provider() {
+        return this.cfg?.provider ?? "local";
+    }
+    get dimensions() {
+        if (this.provider === "local")
+            return 384;
+        return this.cfg?.dimensions ?? 1536;
+    }
+    async embed(texts) {
+        const batchSize = this.cfg?.batchSize ?? 32;
+        const results = [];
+        for (let i = 0; i < texts.length; i += batchSize) {
+            const batch = texts.slice(i, i + batchSize);
+            const vecs = await this.embedBatch(batch);
+            results.push(...vecs);
+        }
+        return results;
+    }
+    async embedQuery(text) {
+        if (this.provider === "cohere" && this.cfg) {
+            return (0, cohere_1.embedCohereQuery)(text, this.cfg, this.log);
+        }
+        const vecs = await this.embedBatch([text]);
+        return vecs[0];
+    }
+    async embedBatch(texts) {
+        const provider = this.provider;
+        const cfg = this.cfg;
+        try {
+            switch (provider) {
+                case "openai":
+                case "openai_compatible":
+                    return await (0, openai_1.embedOpenAI)(texts, cfg, this.log);
+                case "gemini":
+                    return await (0, gemini_1.embedGemini)(texts, cfg, this.log);
+                case "azure_openai":
+                    return await (0, openai_1.embedOpenAI)(texts, cfg, this.log);
+                case "cohere":
+                    return await (0, cohere_1.embedCohere)(texts, cfg, this.log);
+                case "mistral":
+                    return await (0, mistral_1.embedMistral)(texts, cfg, this.log);
+                case "voyage":
+                    return await (0, voyage_1.embedVoyage)(texts, cfg, this.log);
+                case "local":
+                default:
+                    return await (0, local_1.embedLocal)(texts, this.log);
+            }
+        }
+        catch (err) {
+            if (provider !== "local") {
+                this.log.warn(`Embedding provider '${provider}' failed, falling back to local: ${err}`);
+                return await (0, local_1.embedLocal)(texts, this.log);
+            }
+            throw err;
+        }
+    }
+}
+exports.Embedder = Embedder;
+//# sourceMappingURL=index.js.map

package/dist/embedding/index.js.map

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

package/dist/embedding/local.d.ts

@@ -0,0 +1,3 @@
+import type { Logger } from "../types";
+export declare function embedLocal(texts: string[], log: Logger): Promise<number[][]>;
+//# sourceMappingURL=local.d.ts.map

package/dist/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,MAAM,EAAE,MAAM,UAAU,CAAC;AAwBvC,wBAAsB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAUlF"}