crewly 1.8.9 → 1.8.12

package/dist/cli/backend/src/services/knowledge/learnings-index.service.js.map

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

package/dist/cli/backend/src/services/knowledge/wiki-compiler.service.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Wiki Compiler Service
+ *
+ * Reads Markdown files with YAML frontmatter from the `.crewly/knowledge/`
+ * directory and indexes them into the FTS5 full-text search database.
+ * Provides reindexing, single-file indexing, and search capabilities.
+ *
+ * @module services/knowledge/wiki-compiler.service
+ */
+import { Fts5IndexService, type FtsSearchResult } from './fts5-index.service.js';
+/**
+ * Parsed frontmatter result containing extracted metadata and the body text.
+ */
+interface ParsedFrontmatter {
+    /** Key-value pairs extracted from YAML frontmatter */
+    frontmatter: Record<string, string>;
+    /** The markdown body after the frontmatter block */
+    body: string;
+}
+/**
+ * Parse YAML frontmatter from a Markdown file content string.
+ * Handles simple key: value pairs and bracket-delimited arrays.
+ * Does not require an external YAML parsing dependency.
+ *
+ * @param content - Raw file content including frontmatter
+ * @returns Parsed frontmatter object and body text
+ */
+export declare function parseFrontmatter(content: string): ParsedFrontmatter;
+/**
+ * WikiCompilerService scans `.md` files in a knowledge directory, parses
+ * their YAML frontmatter, and indexes the content into an FTS5 database
+ * for fast full-text search.
+ *
+ * @example
+ * ```typescript
+ * const compiler = new WikiCompilerService('/Users/me/.crewly/knowledge');
+ * const { indexed, errors } = await compiler.reindex();
+ * const results = compiler.search('deployment guide');
+ * ```
+ */
+export declare class WikiCompilerService {
+    private readonly fts5;
+    private readonly knowledgePath;
+    private readonly logger;
+    /**
+     * Create a WikiCompilerService.
+     *
+     * @param knowledgePath - Directory containing `.md` knowledge files
+     */
+    constructor(knowledgePath: string);
+    /**
+     * Get the path to the knowledge directory.
+     *
+     * @returns The absolute path to the knowledge directory
+     */
+    getKnowledgePath(): string;
+    /**
+     * Recursively find all `.md` files under the knowledge directory.
+     *
+     * @returns Array of absolute file paths
+     */
+    getMarkdownFiles(): Promise<string[]>;
+    /**
+     * Scan all `.md` files in the knowledge directory (recursively), parse
+     * their frontmatter, and rebuild the FTS5 index from scratch.
+     *
+     * @returns An object with the count of indexed documents and any errors encountered
+     */
+    reindex(): Promise<{
+        indexed: number;
+        errors: string[];
+    }>;
+    /**
+     * Index a single markdown file into the FTS5 database.
+     *
+     * @param filePath - Absolute path to the markdown file
+     */
+    indexFile(filePath: string): Promise<void>;
+    /**
+     * Search the knowledge base using FTS5 full-text search.
+     *
+     * @param query - The search query string
+     * @param options - Optional search parameters (category filter, result limit)
+     * @returns Array of matching documents sorted by BM25 relevance
+     */
+    search(query: string, options?: {
+        category?: string;
+        limit?: number;
+    }): FtsSearchResult[];
+    /**
+     * Get direct access to the underlying FTS5 index service.
+     *
+     * @returns The Fts5IndexService instance
+     */
+    getFts5(): Fts5IndexService;
+    /**
+     * Close the underlying FTS5 database connection.
+     */
+    close(): void;
+    /**
+     * Recursively find all `.md` files under the knowledge directory.
+     *
+     * @returns Array of absolute file paths
+     */
+    private globMarkdownFiles;
+    /**
+     * Read and parse a single markdown file into an FTS5 document shape.
+     *
+     * @param filePath - Absolute path to the markdown file
+     * @returns Parsed document ready for FTS5 indexing
+     */
+    private parseFile;
+}
+export {};
+//# sourceMappingURL=wiki-compiler.service.d.ts.map

package/dist/cli/backend/src/services/knowledge/wiki-compiler.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki-compiler.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/knowledge/wiki-compiler.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,EAAE,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAMjF;;GAEG;AACH,UAAU,iBAAiB;IACzB,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CA4BnE;AAkBD;;;;;;;;;;;GAWG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAmB;IACxC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IAEzC;;;;OAIG;gBACS,aAAa,EAAE,MAAM;IAMjC;;;;OAIG;IACH,gBAAgB,IAAI,MAAM;IAI1B;;;;OAIG;IACG,gBAAgB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAI3C;;;;;OAKG;IACG,OAAO,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IA4B/D;;;;OAIG;IACG,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMhD;;;;;;OAMG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,eAAe,EAAE;IAIzF;;;;OAIG;IACH,OAAO,IAAI,gBAAgB;IAI3B;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb;;;;OAIG;YACW,iBAAiB;IAyB/B;;;;;OAKG;YACW,SAAS;CAcxB"}

package/dist/cli/backend/src/services/knowledge/wiki-compiler.service.js

@@ -0,0 +1,215 @@
+/**
+ * Wiki Compiler Service
+ *
+ * Reads Markdown files with YAML frontmatter from the `.crewly/knowledge/`
+ * directory and indexes them into the FTS5 full-text search database.
+ * Provides reindexing, single-file indexing, and search capabilities.
+ *
+ * @module services/knowledge/wiki-compiler.service
+ */
+import * as path from 'path';
+import { promises as fs } from 'fs';
+import { LoggerService } from '../core/logger.service.js';
+import { Fts5IndexService } from './fts5-index.service.js';
+/**
+ * Parse YAML frontmatter from a Markdown file content string.
+ * Handles simple key: value pairs and bracket-delimited arrays.
+ * Does not require an external YAML parsing dependency.
+ *
+ * @param content - Raw file content including frontmatter
+ * @returns Parsed frontmatter object and body text
+ */
+export function parseFrontmatter(content) {
+    const match = content.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+    if (!match) {
+        return { frontmatter: {}, body: content };
+    }
+    const fm = {};
+    for (const line of match[1].split('\n')) {
+        const colonIdx = line.indexOf(':');
+        if (colonIdx === -1)
+            continue;
+        const key = line.slice(0, colonIdx).trim();
+        let value = line.slice(colonIdx + 1).trim();
+        // Handle arrays: ["tag1", "tag2"] -> "tag1, tag2"
+        if (value.startsWith('[') && value.endsWith(']')) {
+            value = value
+                .slice(1, -1)
+                .split(',')
+                .map((s) => s.trim().replace(/^["']|["']$/g, ''))
+                .join(', ');
+        }
+        // Strip surrounding quotes
+        value = value.replace(/^["']|["']$/g, '');
+        fm[key] = value;
+    }
+    return { frontmatter: fm, body: match[2] };
+}
+/**
+ * Derive a stable document ID from a file path.
+ * Uses the filename without extension, lowercased, with spaces replaced by hyphens.
+ *
+ * @param filePath - Absolute or relative path to the markdown file
+ * @returns A URL-safe identifier string
+ */
+function idFromFilename(filePath) {
+    const basename = path.basename(filePath, '.md');
+    return basename.toLowerCase().replace(/\s+/g, '-');
+}
+// ---------------------------------------------------------------------------
+// Service
+// ---------------------------------------------------------------------------
+/**
+ * WikiCompilerService scans `.md` files in a knowledge directory, parses
+ * their YAML frontmatter, and indexes the content into an FTS5 database
+ * for fast full-text search.
+ *
+ * @example
+ * ```typescript
+ * const compiler = new WikiCompilerService('/Users/me/.crewly/knowledge');
+ * const { indexed, errors } = await compiler.reindex();
+ * const results = compiler.search('deployment guide');
+ * ```
+ */
+export class WikiCompilerService {
+    fts5;
+    knowledgePath;
+    logger;
+    /**
+     * Create a WikiCompilerService.
+     *
+     * @param knowledgePath - Directory containing `.md` knowledge files
+     */
+    constructor(knowledgePath) {
+        this.knowledgePath = knowledgePath;
+        this.fts5 = new Fts5IndexService(knowledgePath);
+        this.logger = LoggerService.getInstance().createComponentLogger('WikiCompilerService');
+    }
+    /**
+     * Get the path to the knowledge directory.
+     *
+     * @returns The absolute path to the knowledge directory
+     */
+    getKnowledgePath() {
+        return this.knowledgePath;
+    }
+    /**
+     * Recursively find all `.md` files under the knowledge directory.
+     *
+     * @returns Array of absolute file paths
+     */
+    async getMarkdownFiles() {
+        return this.globMarkdownFiles();
+    }
+    /**
+     * Scan all `.md` files in the knowledge directory (recursively), parse
+     * their frontmatter, and rebuild the FTS5 index from scratch.
+     *
+     * @returns An object with the count of indexed documents and any errors encountered
+     */
+    async reindex() {
+        const errors = [];
+        const files = await this.globMarkdownFiles();
+        if (files.length === 0) {
+            this.logger.info('No markdown files found for indexing', { path: this.knowledgePath });
+            return { indexed: 0, errors };
+        }
+        const documents = [];
+        for (const filePath of files) {
+            try {
+                const doc = await this.parseFile(filePath);
+                documents.push(doc);
+            }
+            catch (err) {
+                const msg = `Failed to parse ${filePath}: ${err instanceof Error ? err.message : String(err)}`;
+                errors.push(msg);
+                this.logger.warn('Failed to parse markdown file during reindex', { filePath, error: msg });
+            }
+        }
+        this.fts5.rebuildIndex(documents);
+        this.logger.info('Wiki reindex complete', { indexed: documents.length, errors: errors.length });
+        return { indexed: documents.length, errors };
+    }
+    /**
+     * Index a single markdown file into the FTS5 database.
+     *
+     * @param filePath - Absolute path to the markdown file
+     */
+    async indexFile(filePath) {
+        const doc = await this.parseFile(filePath);
+        this.fts5.upsertDocument(doc);
+        this.logger.debug('Indexed single file', { filePath, id: doc.id });
+    }
+    /**
+     * Search the knowledge base using FTS5 full-text search.
+     *
+     * @param query - The search query string
+     * @param options - Optional search parameters (category filter, result limit)
+     * @returns Array of matching documents sorted by BM25 relevance
+     */
+    search(query, options) {
+        return this.fts5.search(query, options);
+    }
+    /**
+     * Get direct access to the underlying FTS5 index service.
+     *
+     * @returns The Fts5IndexService instance
+     */
+    getFts5() {
+        return this.fts5;
+    }
+    /**
+     * Close the underlying FTS5 database connection.
+     */
+    close() {
+        this.fts5.close();
+    }
+    // ---------------------------------------------------------------------------
+    // Private helpers
+    // ---------------------------------------------------------------------------
+    /**
+     * Recursively find all `.md` files under the knowledge directory.
+     *
+     * @returns Array of absolute file paths
+     */
+    async globMarkdownFiles() {
+        const results = [];
+        const walkDir = async (dir) => {
+            let entries;
+            try {
+                entries = await fs.readdir(dir, { withFileTypes: true });
+            }
+            catch {
+                return;
+            }
+            for (const entry of entries) {
+                const fullPath = path.join(dir, entry.name);
+                if (entry.isDirectory()) {
+                    await walkDir(fullPath);
+                }
+                else if (entry.isFile() && entry.name.endsWith('.md')) {
+                    results.push(fullPath);
+                }
+            }
+        };
+        await walkDir(this.knowledgePath);
+        return results;
+    }
+    /**
+     * Read and parse a single markdown file into an FTS5 document shape.
+     *
+     * @param filePath - Absolute path to the markdown file
+     * @returns Parsed document ready for FTS5 indexing
+     */
+    async parseFile(filePath) {
+        const raw = await fs.readFile(filePath, 'utf-8');
+        const { frontmatter, body } = parseFrontmatter(raw);
+        const id = frontmatter.id || idFromFilename(filePath);
+        const title = frontmatter.title || path.basename(filePath, '.md');
+        const tags = frontmatter.tags || '';
+        const category = frontmatter.category || 'General';
+        const content = body.trim();
+        return { id, title, tags, content, category };
+    }
+}
+//# sourceMappingURL=wiki-compiler.service.js.map

package/dist/cli/backend/src/services/knowledge/wiki-compiler.service.js.map

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

package/dist/cli/backend/src/services/memory/embedding-provider.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Embedding Provider Abstraction (#155)
+ *
+ * Decouples embedding logic from specific APIs. Supports:
+ * - Cloud: Gemini (default), OpenAI, Voyage
+ * - Local: Ollama (for air-gapped/high-security environments)
+ *
+ * Provider selection via environment variables:
+ * - GEMINI_API_KEY → GeminiEmbeddingProvider
+ * - OPENAI_API_KEY → OpenAIEmbeddingProvider
+ * - OLLAMA_HOST → OllamaEmbeddingProvider
+ *
+ * @see https://github.com/stevehuang0115/crewly/issues/155
+ * @module services/memory/embedding-provider
+ */
+/**
+ * Abstract interface for embedding providers.
+ * All providers must implement the embed() method.
+ */
+export interface EmbeddingProvider {
+    /** Provider name for logging */
+    readonly name: string;
+    /** Embedding vector dimensions */
+    readonly dimensions: number;
+    /**
+     * Generate an embedding vector for the given text.
+     *
+     * @param text - Text to embed
+     * @returns Embedding vector, or null on failure
+     */
+    embed(text: string): Promise<number[] | null>;
+}
+/**
+ * Gemini embedding provider (default cloud provider).
+ */
+export declare class GeminiEmbeddingProvider implements EmbeddingProvider {
+    readonly name = "gemini";
+    readonly dimensions = 768;
+    private readonly apiKey;
+    private readonly logger;
+    constructor(apiKey: string);
+    embed(text: string): Promise<number[] | null>;
+}
+/**
+ * OpenAI embedding provider.
+ * Uses the text-embedding-3-small model by default.
+ */
+export declare class OpenAIEmbeddingProvider implements EmbeddingProvider {
+    readonly name = "openai";
+    readonly dimensions = 1536;
+    private readonly apiKey;
+    private readonly model;
+    private readonly logger;
+    constructor(apiKey: string, model?: string);
+    embed(text: string): Promise<number[] | null>;
+}
+/**
+ * Ollama local embedding provider.
+ * Runs entirely on-device for air-gapped environments.
+ */
+export declare class OllamaEmbeddingProvider implements EmbeddingProvider {
+    readonly name = "ollama";
+    readonly dimensions = 768;
+    private readonly host;
+    private readonly model;
+    private readonly logger;
+    constructor(host?: string, model?: string);
+    embed(text: string): Promise<number[] | null>;
+}
+/**
+ * Create the best available embedding provider based on environment config.
+ *
+ * Priority: GEMINI_API_KEY > OPENAI_API_KEY > OLLAMA_HOST > null
+ *
+ * @returns EmbeddingProvider instance, or null if none configured
+ */
+export declare function createEmbeddingProvider(): EmbeddingProvider | null;
+//# sourceMappingURL=embedding-provider.d.ts.map

package/dist/cli/backend/src/services/memory/embedding-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-provider.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/memory/embedding-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IACjC,gCAAgC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kCAAkC;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B;;;;;OAKG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC;CAC9C;AAED;;GAEG;AACH,qBAAa,uBAAwB,YAAW,iBAAiB;IAChE,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,UAAU,OAAO;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;gBAE7B,MAAM,EAAE,MAAM;IAKpB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC;CA2CnD;AAED;;;GAGG;AACH,qBAAa,uBAAwB,YAAW,iBAAiB;IAChE,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,UAAU,QAAQ;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;gBAE7B,MAAM,EAAE,MAAM,EAAE,KAAK,SAA2B;IAMtD,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC;CA0BnD;AAED;;;GAGG;AACH,qBAAa,uBAAwB,YAAW,iBAAiB;IAChE,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,UAAU,OAAO;IAC1B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;gBAE7B,IAAI,SAA2B,EAAE,KAAK,SAAqB;IAMjE,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC;CAuBnD;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,IAAI,iBAAiB,GAAG,IAAI,CAiBlE"}

package/dist/cli/backend/src/services/memory/embedding-provider.js

@@ -0,0 +1,179 @@
+/**
+ * Embedding Provider Abstraction (#155)
+ *
+ * Decouples embedding logic from specific APIs. Supports:
+ * - Cloud: Gemini (default), OpenAI, Voyage
+ * - Local: Ollama (for air-gapped/high-security environments)
+ *
+ * Provider selection via environment variables:
+ * - GEMINI_API_KEY → GeminiEmbeddingProvider
+ * - OPENAI_API_KEY → OpenAIEmbeddingProvider
+ * - OLLAMA_HOST → OllamaEmbeddingProvider
+ *
+ * @see https://github.com/stevehuang0115/crewly/issues/155
+ * @module services/memory/embedding-provider
+ */
+import { LoggerService } from '../core/logger.service.js';
+import { EMBEDDING_CONSTANTS } from '../../constants.js';
+/**
+ * Gemini embedding provider (default cloud provider).
+ */
+export class GeminiEmbeddingProvider {
+    name = 'gemini';
+    dimensions = 768;
+    apiKey;
+    logger;
+    constructor(apiKey) {
+        this.apiKey = apiKey;
+        this.logger = LoggerService.getInstance().createComponentLogger('GeminiEmbedding');
+    }
+    async embed(text) {
+        try {
+            const url = `${EMBEDDING_CONSTANTS.GEMINI_ENDPOINT}/${EMBEDDING_CONSTANTS.GEMINI_MODEL}:embedContent?key=${this.apiKey}`;
+            const controller = new AbortController();
+            const timeout = setTimeout(() => controller.abort(), EMBEDDING_CONSTANTS.TIMEOUT_MS);
+            try {
+                const response = await fetch(url, {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/json' },
+                    body: JSON.stringify({
+                        model: `models/${EMBEDDING_CONSTANTS.GEMINI_MODEL}`,
+                        content: { parts: [{ text }] },
+                    }),
+                    signal: controller.signal,
+                });
+                if (!response.ok) {
+                    // #214: Log specific guidance for common error codes
+                    const hint = response.status === 404
+                        ? 'Model may be deprecated — check Gemini embedding model availability'
+                        : response.status === 401 || response.status === 403
+                            ? 'Check your GEMINI_API_KEY — it may be invalid or lack permissions'
+                            : '';
+                    this.logger.warn('Gemini embedding API error, falling back to keyword search', {
+                        status: response.status,
+                        model: EMBEDDING_CONSTANTS.GEMINI_MODEL,
+                        hint,
+                    });
+                    return null;
+                }
+                const data = (await response.json());
+                return data.embedding?.values ?? null;
+            }
+            finally {
+                clearTimeout(timeout);
+            }
+        }
+        catch (error) {
+            this.logger.warn('Gemini embedding API call failed, falling back to keyword search', {
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return null;
+        }
+    }
+}
+/**
+ * OpenAI embedding provider.
+ * Uses the text-embedding-3-small model by default.
+ */
+export class OpenAIEmbeddingProvider {
+    name = 'openai';
+    dimensions = 1536;
+    apiKey;
+    model;
+    logger;
+    constructor(apiKey, model = 'text-embedding-3-small') {
+        this.apiKey = apiKey;
+        this.model = model;
+        this.logger = LoggerService.getInstance().createComponentLogger('OpenAIEmbedding');
+    }
+    async embed(text) {
+        try {
+            const controller = new AbortController();
+            const timeout = setTimeout(() => controller.abort(), 30000);
+            try {
+                const response = await fetch('https://api.openai.com/v1/embeddings', {
+                    method: 'POST',
+                    headers: {
+                        'Content-Type': 'application/json',
+                        'Authorization': `Bearer ${this.apiKey}`,
+                    },
+                    body: JSON.stringify({ input: text, model: this.model }),
+                    signal: controller.signal,
+                });
+                if (!response.ok)
+                    return null;
+                const data = (await response.json());
+                return data.data?.[0]?.embedding ?? null;
+            }
+            finally {
+                clearTimeout(timeout);
+            }
+        }
+        catch {
+            return null;
+        }
+    }
+}
+/**
+ * Ollama local embedding provider.
+ * Runs entirely on-device for air-gapped environments.
+ */
+export class OllamaEmbeddingProvider {
+    name = 'ollama';
+    dimensions = 768; // depends on model
+    host;
+    model;
+    logger;
+    constructor(host = 'http://localhost:11434', model = 'nomic-embed-text') {
+        this.host = host;
+        this.model = model;
+        this.logger = LoggerService.getInstance().createComponentLogger('OllamaEmbedding');
+    }
+    async embed(text) {
+        try {
+            const controller = new AbortController();
+            const timeout = setTimeout(() => controller.abort(), 30000);
+            try {
+                const response = await fetch(`${this.host}/api/embeddings`, {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/json' },
+                    body: JSON.stringify({ model: this.model, prompt: text }),
+                    signal: controller.signal,
+                });
+                if (!response.ok)
+                    return null;
+                const data = (await response.json());
+                return data.embedding ?? null;
+            }
+            finally {
+                clearTimeout(timeout);
+            }
+        }
+        catch {
+            return null;
+        }
+    }
+}
+/**
+ * Create the best available embedding provider based on environment config.
+ *
+ * Priority: GEMINI_API_KEY > OPENAI_API_KEY > OLLAMA_HOST > null
+ *
+ * @returns EmbeddingProvider instance, or null if none configured
+ */
+export function createEmbeddingProvider() {
+    const geminiKey = process.env.GEMINI_API_KEY;
+    if (geminiKey) {
+        return new GeminiEmbeddingProvider(geminiKey);
+    }
+    const openaiKey = process.env.OPENAI_API_KEY;
+    if (openaiKey) {
+        return new OpenAIEmbeddingProvider(openaiKey);
+    }
+    const ollamaHost = process.env.OLLAMA_HOST;
+    if (ollamaHost) {
+        return new OllamaEmbeddingProvider(ollamaHost);
+    }
+    return null;
+}
+//# sourceMappingURL=embedding-provider.js.map

package/dist/cli/backend/src/services/memory/embedding-provider.js.map

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