brainbank 0.7.0 → 0.8.0

package/dist/chunk-7EZR47JV.js

@@ -1,232 +0,0 @@
-import {
-  normalizeBM25,
-  reciprocalRankFusion,
-  sanitizeFTS
-} from "./chunk-YOLKSYWK.js";
-import {
-  vecToBuffer
-} from "./chunk-U2Q2XGPZ.js";
-import {
-  __name
-} from "./chunk-7QVYU63E.js";
-
-// src/indexers/notes/note-store.ts
-var NoteStore = class {
-  static {
-    __name(this, "NoteStore");
-  }
-  _db;
-  _embedding;
-  _hnsw;
-  _vecs;
-  constructor(db, embedding, hnsw, vecs) {
-    this._db = db;
-    this._embedding = embedding;
-    this._hnsw = hnsw;
-    this._vecs = vecs;
-  }
-  /**
-   * Store a note digest.
-   * Embeds title + summary for vector search, auto-indexed in FTS5.
-   */
-  async remember(digest) {
-    const { title, summary, decisions = [], filesChanged = [], patterns = [], openQuestions = [], tags = [] } = digest;
-    const result = this._db.prepare(`
-            INSERT INTO note_memories (title, summary, decisions_json, files_json, patterns_json, open_json, tags_json)
-            VALUES (?, ?, ?, ?, ?, ?, ?)
-        `).run(
-      title,
-      summary,
-      JSON.stringify(decisions),
-      JSON.stringify(filesChanged),
-      JSON.stringify(patterns),
-      JSON.stringify(openQuestions),
-      JSON.stringify(tags)
-    );
-    const id = Number(result.lastInsertRowid);
-    const text = `${title}
-${summary}
-${decisions.join(". ")}
-${patterns.join(". ")}`;
-    const vec = await this._embedding.embed(text);
-    this._db.prepare("INSERT INTO note_vectors (note_id, embedding) VALUES (?, ?)").run(
-      id,
-      vecToBuffer(vec)
-    );
-    this._hnsw.add(vec, id);
-    this._vecs.set(id, vec);
-    return id;
-  }
-  /**
-   * Recall relevant notes.
-   * Supports vector, keyword, or hybrid (default) retrieval.
-   */
-  async recall(query, options = {}) {
-    const { k = 5, mode = "hybrid", minScore = 0.15, tier } = options;
-    let results;
-    if (mode === "keyword") {
-      results = this._searchBM25(query, k);
-    } else if (mode === "vector") {
-      results = await this._searchVector(query, k);
-    } else {
-      const [vectorHits, bm25Hits] = await Promise.all([
-        this._searchVector(query, k),
-        Promise.resolve(this._searchBM25(query, k))
-      ]);
-      const fusedResults = reciprocalRankFusion(
-        [
-          vectorHits.map((m) => ({ type: "collection", score: m.score ?? 0, content: m.summary, metadata: { id: m.id } })),
-          bm25Hits.map((m) => ({ type: "collection", score: m.score ?? 0, content: m.summary, metadata: { id: m.id } }))
-        ]
-      );
-      const allById = /* @__PURE__ */ new Map();
-      for (const m of [...vectorHits, ...bm25Hits]) allById.set(m.id, m);
-      results = fusedResults.map((r) => {
-        const mem = allById.get(r.metadata.id);
-        if (!mem) return null;
-        return { ...mem, score: r.score };
-      }).filter(Boolean);
-    }
-    return results.filter((m) => (m.score ?? 0) >= minScore).filter((m) => !tier || m.tier === tier).slice(0, k);
-  }
-  /**
-   * List recent notes.
-   */
-  list(limit = 20, tier) {
-    const sql = tier ? "SELECT * FROM note_memories WHERE tier = ? ORDER BY id DESC LIMIT ?" : "SELECT * FROM note_memories ORDER BY id DESC LIMIT ?";
-    const rows = tier ? this._db.prepare(sql).all(tier, limit) : this._db.prepare(sql).all(limit);
-    return rows.map((r) => this._rowToNote(r));
-  }
-  /**
-   * Get total count of notes.
-   */
-  count() {
-    const total = this._db.prepare("SELECT COUNT(*) as n FROM note_memories").get().n;
-    const short = this._db.prepare("SELECT COUNT(*) as n FROM note_memories WHERE tier = 'short'").get().n;
-    const long = this._db.prepare("SELECT COUNT(*) as n FROM note_memories WHERE tier = 'long'").get().n;
-    return { total, short, long };
-  }
-  /**
-   * Consolidate old short-term notes into long-term.
-   * Keeps the most recent `keepRecent` as short-term, compresses the rest.
-   */
-  consolidate(keepRecent = 20) {
-    const old = this._db.prepare(`
-            SELECT id FROM note_memories 
-            WHERE tier = 'short' 
-            ORDER BY created_at DESC 
-            LIMIT -1 OFFSET ?
-        `).all(keepRecent);
-    if (old.length === 0) return { promoted: 0 };
-    const ids = old.map((r) => r.id);
-    const placeholders = ids.map(() => "?").join(",");
-    this._db.prepare(`
-            UPDATE note_memories 
-            SET tier = 'long',
-                open_json = '[]',
-                files_json = '[]'
-            WHERE id IN (${placeholders})
-        `).run(...ids);
-    return { promoted: ids.length };
-  }
-  // ── Private helpers ────────────────────────────
-  async _searchVector(query, k) {
-    if (this._hnsw.size === 0) return [];
-    const queryVec = await this._embedding.embed(query);
-    const hits = this._hnsw.search(queryVec, k);
-    if (hits.length === 0) return [];
-    const ids = hits.map((h) => h.id);
-    const scoreMap = new Map(hits.map((h) => [h.id, h.score]));
-    const placeholders = ids.map(() => "?").join(",");
-    const rows = this._db.prepare(
-      `SELECT * FROM note_memories WHERE id IN (${placeholders})`
-    ).all(...ids);
-    return rows.map((r) => ({
-      ...this._rowToNote(r),
-      score: scoreMap.get(r.id) ?? 0
-    }));
-  }
-  _searchBM25(query, k) {
-    const ftsQuery = sanitizeFTS(query);
-    if (!ftsQuery) return [];
-    try {
-      const rows = this._db.prepare(`
-                SELECT m.*, bm25(fts_notes, 5.0, 3.0, 2.0, 2.0, 1.0) AS score
-                FROM fts_notes f
-                JOIN note_memories m ON m.id = f.rowid
-                WHERE fts_notes MATCH ?
-                ORDER BY score ASC
-                LIMIT ?
-            `).all(ftsQuery, k);
-      return rows.map((r) => ({
-        ...this._rowToNote(r),
-        score: normalizeBM25(r.score)
-      }));
-    } catch {
-      return [];
-    }
-  }
-  _rowToNote(r) {
-    return {
-      id: r.id,
-      title: r.title,
-      summary: r.summary,
-      decisions: JSON.parse(r.decisions_json || "[]"),
-      filesChanged: JSON.parse(r.files_json || "[]"),
-      patterns: JSON.parse(r.patterns_json || "[]"),
-      openQuestions: JSON.parse(r.open_json || "[]"),
-      tags: JSON.parse(r.tags_json || "[]"),
-      tier: r.tier,
-      createdAt: r.created_at
-    };
-  }
-};
-
-// src/indexers/notes/notes-plugin.ts
-var NotesPlugin = class {
-  static {
-    __name(this, "NotesPlugin");
-  }
-  name = "notes";
-  hnsw;
-  store;
-  vecCache = /* @__PURE__ */ new Map();
-  async initialize(ctx) {
-    this.hnsw = await ctx.createHnsw(1e5);
-    ctx.loadVectors("note_vectors", "note_id", this.hnsw, this.vecCache);
-    this.store = new NoteStore(ctx.db, ctx.embedding, this.hnsw, this.vecCache);
-  }
-  /** Store a note digest. */
-  async remember(digest) {
-    return this.store.remember(digest);
-  }
-  /** Recall relevant notes (hybrid search). */
-  async recall(query, options) {
-    return this.store.recall(query, options);
-  }
-  /** List recent notes. */
-  list(limit, tier) {
-    return this.store.list(limit, tier);
-  }
-  /** Consolidate old short-term → long-term. */
-  consolidate(keepRecent) {
-    return this.store.consolidate(keepRecent);
-  }
-  /** Count notes by tier. */
-  count() {
-    return this.store.count();
-  }
-  stats() {
-    return this.store.count();
-  }
-};
-function notes() {
-  return new NotesPlugin();
-}
-__name(notes, "notes");
-
-export {
-  NoteStore,
-  notes
-};
-//# sourceMappingURL=chunk-7EZR47JV.js.map

package/dist/chunk-7EZR47JV.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/indexers/notes/note-store.ts","../src/indexers/notes/notes-plugin.ts"],"sourcesContent":["/**\n * BrainBank — Note Memory Store\n * \n * Stores structured note digests for long-term agent memory.\n * Each digest captures decisions, files changed, patterns, and open questions.\n * Supports vector + BM25 hybrid retrieval via HNSW + FTS5.\n * \n * Memory tiers:\n *   - \"short\" (default): Full digest, last ~20 notes\n *   - \"long\":  Compressed to patterns + decisions only\n */\n\nimport type { Database } from '@/db/database.ts';\nimport { vecToBuffer } from '@/lib/math.ts';\nimport type { EmbeddingProvider, SearchResult } from '@/types.ts';\nimport type { HNSWIndex } from '@/providers/vector/hnsw-index.ts';\nimport { reciprocalRankFusion } from '@/lib/rrf.ts';\nimport { sanitizeFTS, normalizeBM25 } from '@/lib/fts.ts';\n\nexport interface NoteDigest {\n    title: string;\n    summary: string;\n    decisions?: string[];\n    filesChanged?: string[];\n    patterns?: string[];\n    openQuestions?: string[];\n    tags?: string[];\n}\n\nexport interface StoredNote extends NoteDigest {\n    id: number;\n    tier: 'short' | 'long';\n    createdAt: number;\n    score?: number;\n}\n\nexport interface RecallOptions {\n    /** Max results. Default: 5 */\n    k?: number;\n    /** Search mode. Default: 'hybrid' */\n    mode?: 'hybrid' | 'vector' | 'keyword';\n    /** Minimum score threshold. Default: 0.15 */\n    minScore?: number;\n    /** Filter by tier. Default: all */\n    tier?: 'short' | 'long';\n}\n\nexport class NoteStore {\n    private _db: Database;\n    private _embedding: EmbeddingProvider;\n    private _hnsw: HNSWIndex;\n    private _vecs: Map<number, Float32Array>;\n\n    constructor(\n        db: Database,\n        embedding: EmbeddingProvider,\n        hnsw: HNSWIndex,\n        vecs: Map<number, Float32Array>,\n    ) {\n        this._db = db;\n        this._embedding = embedding;\n        this._hnsw = hnsw;\n        this._vecs = vecs;\n    }\n\n    /**\n     * Store a note digest.\n     * Embeds title + summary for vector search, auto-indexed in FTS5.\n     */\n    async remember(digest: NoteDigest): Promise<number> {\n        const { title, summary, decisions = [], filesChanged = [], patterns = [], openQuestions = [], tags = [] } = digest;\n\n        // Store in SQLite\n        const result = this._db.prepare(`\n            INSERT INTO note_memories (title, summary, decisions_json, files_json, patterns_json, open_json, tags_json)\n            VALUES (?, ?, ?, ?, ?, ?, ?)\n        `).run(\n            title,\n            summary,\n            JSON.stringify(decisions),\n            JSON.stringify(filesChanged),\n            JSON.stringify(patterns),\n            JSON.stringify(openQuestions),\n            JSON.stringify(tags),\n        );\n\n        const id = Number(result.lastInsertRowid);\n\n        // Embed and index\n        const text = `${title}\\n${summary}\\n${decisions.join('. ')}\\n${patterns.join('. ')}`;\n        const vec = await this._embedding.embed(text);\n\n        this._db.prepare('INSERT INTO note_vectors (note_id, embedding) VALUES (?, ?)').run(\n            id, vecToBuffer(vec),\n        );\n\n        this._hnsw.add(vec, id);\n        this._vecs.set(id, vec);\n\n        return id;\n    }\n\n    /**\n     * Recall relevant notes.\n     * Supports vector, keyword, or hybrid (default) retrieval.\n     */\n    async recall(query: string, options: RecallOptions = {}): Promise<StoredNote[]> {\n        const { k = 5, mode = 'hybrid', minScore = 0.15, tier } = options;\n\n        let results: StoredNote[];\n\n        if (mode === 'keyword') {\n            results = this._searchBM25(query, k);\n        } else if (mode === 'vector') {\n            results = await this._searchVector(query, k);\n        } else {\n            // Hybrid: vector + BM25 → RRF\n            const [vectorHits, bm25Hits] = await Promise.all([\n                this._searchVector(query, k),\n                Promise.resolve(this._searchBM25(query, k)),\n            ]);\n\n            const fusedResults = reciprocalRankFusion(\n                [\n                    vectorHits.map(m => ({ type: 'collection' as const, score: m.score ?? 0, content: m.summary, metadata: { id: m.id } })),\n                    bm25Hits.map(m => ({ type: 'collection' as const, score: m.score ?? 0, content: m.summary, metadata: { id: m.id } })),\n                ],\n            );\n\n            // Map back to full StoredNote objects\n            const allById = new Map<number, StoredNote>();\n            for (const m of [...vectorHits, ...bm25Hits]) allById.set(m.id, m);\n\n            results = fusedResults\n                .map(r => {\n                    const mem = allById.get((r.metadata as any).id);\n                    if (!mem) return null;\n                    return { ...mem, score: r.score };\n                })\n                .filter(Boolean) as StoredNote[];\n        }\n\n        // Apply filters\n        return results\n            .filter(m => (m.score ?? 0) >= minScore)\n            .filter(m => !tier || m.tier === tier)\n            .slice(0, k);\n    }\n\n    /**\n     * List recent notes.\n     */\n    list(limit: number = 20, tier?: 'short' | 'long'): StoredNote[] {\n        const sql = tier\n            ? 'SELECT * FROM note_memories WHERE tier = ? ORDER BY id DESC LIMIT ?'\n            : 'SELECT * FROM note_memories ORDER BY id DESC LIMIT ?';\n\n        const rows = tier\n            ? this._db.prepare(sql).all(tier, limit) as any[]\n            : this._db.prepare(sql).all(limit) as any[];\n\n        return rows.map(r => this._rowToNote(r));\n    }\n\n    /**\n     * Get total count of notes.\n     */\n    count(): { total: number; short: number; long: number } {\n        const total = (this._db.prepare('SELECT COUNT(*) as n FROM note_memories').get() as any).n;\n        const short = (this._db.prepare(\"SELECT COUNT(*) as n FROM note_memories WHERE tier = 'short'\").get() as any).n;\n        const long = (this._db.prepare(\"SELECT COUNT(*) as n FROM note_memories WHERE tier = 'long'\").get() as any).n;\n        return { total, short, long };\n    }\n\n    /**\n     * Consolidate old short-term notes into long-term.\n     * Keeps the most recent `keepRecent` as short-term, compresses the rest.\n     */\n    consolidate(keepRecent: number = 20): { promoted: number } {\n        // Find short-term notes beyond the keep window\n        const old = this._db.prepare(`\n            SELECT id FROM note_memories \n            WHERE tier = 'short' \n            ORDER BY created_at DESC \n            LIMIT -1 OFFSET ?\n        `).all(keepRecent) as any[];\n\n        if (old.length === 0) return { promoted: 0 };\n\n        const ids = old.map((r: any) => r.id);\n        const placeholders = ids.map(() => '?').join(',');\n\n        // Promote to long-term: clear verbose fields, keep patterns + decisions\n        this._db.prepare(`\n            UPDATE note_memories \n            SET tier = 'long',\n                open_json = '[]',\n                files_json = '[]'\n            WHERE id IN (${placeholders})\n        `).run(...ids);\n\n        return { promoted: ids.length };\n    }\n\n    // ── Private helpers ────────────────────────────\n\n    private async _searchVector(query: string, k: number): Promise<StoredNote[]> {\n        if (this._hnsw.size === 0) return [];\n\n        const queryVec = await this._embedding.embed(query);\n        const hits = this._hnsw.search(queryVec, k);\n\n        if (hits.length === 0) return [];\n\n        const ids = hits.map(h => h.id);\n        const scoreMap = new Map(hits.map(h => [h.id, h.score]));\n        const placeholders = ids.map(() => '?').join(',');\n\n        const rows = this._db.prepare(\n            `SELECT * FROM note_memories WHERE id IN (${placeholders})`\n        ).all(...ids) as any[];\n\n        return rows.map(r => ({\n            ...this._rowToNote(r),\n            score: scoreMap.get(r.id) ?? 0,\n        }));\n    }\n\n    private _searchBM25(query: string, k: number): StoredNote[] {\n        const ftsQuery = sanitizeFTS(query);\n        if (!ftsQuery) return [];\n\n        try {\n            const rows = this._db.prepare(`\n                SELECT m.*, bm25(fts_notes, 5.0, 3.0, 2.0, 2.0, 1.0) AS score\n                FROM fts_notes f\n                JOIN note_memories m ON m.id = f.rowid\n                WHERE fts_notes MATCH ?\n                ORDER BY score ASC\n                LIMIT ?\n            `).all(ftsQuery, k) as any[];\n\n            return rows.map(r => ({\n                ...this._rowToNote(r),\n                score: normalizeBM25(r.score),\n            }));\n        } catch {\n            return [];\n        }\n    }\n\n    private _rowToNote(r: any): StoredNote {\n        return {\n            id: r.id,\n            title: r.title,\n            summary: r.summary,\n            decisions: JSON.parse(r.decisions_json || '[]'),\n            filesChanged: JSON.parse(r.files_json || '[]'),\n            patterns: JSON.parse(r.patterns_json || '[]'),\n            openQuestions: JSON.parse(r.open_json || '[]'),\n            tags: JSON.parse(r.tags_json || '[]'),\n            tier: r.tier,\n            createdAt: r.created_at,\n        };\n    }\n}\n","/**\n * BrainBank — Notes Module\n * \n * Store structured conversation digests so the agent\n * remembers past discussions.\n * \n *   import { notes } from 'brainbank/notes';\n *   brain.use(notes());\n */\n\nimport type { Plugin, PluginContext } from '@/indexers/base.ts';\nimport type { HNSWIndex } from '@/providers/vector/hnsw-index.ts';\nimport { NoteStore } from './note-store.ts';\nimport type { NoteDigest, StoredNote, RecallOptions } from './note-store.ts';\n\nclass NotesPlugin implements Plugin {\n    readonly name = 'notes';\n    hnsw!: HNSWIndex;\n    store!: NoteStore;\n    vecCache = new Map<number, Float32Array>();\n\n    async initialize(ctx: PluginContext): Promise<void> {\n        this.hnsw = await ctx.createHnsw(100_000);\n        ctx.loadVectors('note_vectors', 'note_id', this.hnsw, this.vecCache);\n        this.store = new NoteStore(ctx.db, ctx.embedding, this.hnsw, this.vecCache);\n    }\n\n    /** Store a note digest. */\n    async remember(digest: NoteDigest): Promise<number> {\n        return this.store.remember(digest);\n    }\n\n    /** Recall relevant notes (hybrid search). */\n    async recall(query: string, options?: RecallOptions): Promise<StoredNote[]> {\n        return this.store.recall(query, options);\n    }\n\n    /** List recent notes. */\n    list(limit?: number, tier?: 'short' | 'long'): StoredNote[] {\n        return this.store.list(limit, tier);\n    }\n\n    /** Consolidate old short-term → long-term. */\n    consolidate(keepRecent?: number): { promoted: number } {\n        return this.store.consolidate(keepRecent);\n    }\n\n    /** Count notes by tier. */\n    count(): { total: number; short: number; long: number } {\n        return this.store.count();\n    }\n\n    stats(): Record<string, any> {\n        return this.store.count();\n    }\n}\n\n/** Create a notes plugin. */\nexport function notes(): Plugin {\n    return new NotesPlugin();\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-B77KABWH.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/providers/embeddings/resolve.ts"],"sourcesContent":["/**\n * BrainBank — Embedding Provider Resolver\n *\n * Resolves an EmbeddingProvider from a stored key string.\n * Used by the Initializer to auto-resolve from DB config.\n */\n\nimport type { EmbeddingProvider } from '@/types.ts';\n\n/** Known embedding provider keys. */\nexport type EmbeddingKey = 'local' | 'openai' | 'perplexity' | 'perplexity-context';\n\n/** Resolve an EmbeddingProvider from a key string. Lazy-loads the provider module. */\nexport async function resolveEmbedding(key: string): Promise<EmbeddingProvider> {\n    switch (key) {\n        case 'openai': {\n            const { OpenAIEmbedding } = await import('./openai-embedding.ts');\n            return new OpenAIEmbedding();\n        }\n        case 'perplexity': {\n            const { PerplexityEmbedding } = await import('./perplexity-embedding.ts');\n            return new PerplexityEmbedding();\n        }\n        case 'perplexity-context': {\n            const { PerplexityContextEmbedding } = await import('./perplexity-context-embedding.ts');\n            return new PerplexityContextEmbedding();\n        }\n        case 'local':\n        default: {\n            const { LocalEmbedding } = await import('./local-embedding.ts');\n            return new LocalEmbedding();\n        }\n    }\n}\n\n/** Infer a stable key from an existing provider instance. */\nexport function providerKey(p: EmbeddingProvider): EmbeddingKey {\n    const name = p.constructor?.name ?? '';\n    if (name === 'OpenAIEmbedding') return 'openai';\n    if (name === 'PerplexityEmbedding') return 'perplexity';\n    if (name === 'PerplexityContextEmbedding') return 'perplexity-context';\n    return 'local';\n}\n"],"mappings":";;;;;AAaA,eAAsB,iBAAiB,KAAyC;AAC5E,UAAQ,KAAK;AAAA,IACT,KAAK,UAAU;AACX,YAAM,EAAE,gBAAgB,IAAI,MAAM,OAAO,gCAAuB;AAChE,aAAO,IAAI,gBAAgB;AAAA,IAC/B;AAAA,IACA,KAAK,cAAc;AACf,YAAM,EAAE,oBAAoB,IAAI,MAAM,OAAO,oCAA2B;AACxE,aAAO,IAAI,oBAAoB;AAAA,IACnC;AAAA,IACA,KAAK,sBAAsB;AACvB,YAAM,EAAE,2BAA2B,IAAI,MAAM,OAAO,4CAAmC;AACvF,aAAO,IAAI,2BAA2B;AAAA,IAC1C;AAAA,IACA,KAAK;AAAA,IACL,SAAS;AACL,YAAM,EAAE,eAAe,IAAI,MAAM,OAAO,+BAAsB;AAC9D,aAAO,IAAI,eAAe;AAAA,IAC9B;AAAA,EACJ;AACJ;AApBsB;AAuBf,SAAS,YAAY,GAAoC;AAC5D,QAAM,OAAO,EAAE,aAAa,QAAQ;AACpC,MAAI,SAAS,kBAAmB,QAAO;AACvC,MAAI,SAAS,sBAAuB,QAAO;AAC3C,MAAI,SAAS,6BAA8B,QAAO;AAClD,SAAO;AACX;AANgB;","names":[]}

package/dist/chunk-CCXVL56V.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/providers/embeddings/openai-embedding.ts"],"sourcesContent":["/**\n * BrainBank — OpenAI Embedding Provider\n * \n * Uses OpenAI's embedding API via fetch (no SDK dependency).\n * Supports text-embedding-3-small, text-embedding-3-large, and ada-002.\n * \n * Usage:\n *   const brain = new BrainBank({\n *     embeddingProvider: new OpenAIEmbedding({ model: 'text-embedding-3-small' }),\n *   });\n */\n\nimport type { EmbeddingProvider } from '@/types.ts';\n\nconst DEFAULT_MODEL = 'text-embedding-3-small';\nconst DEFAULT_DIMS: Record<string, number> = {\n    'text-embedding-3-small': 1536,\n    'text-embedding-3-large': 3072,\n    'text-embedding-ada-002': 1536,\n};\nconst API_URL = 'https://api.openai.com/v1/embeddings';\nconst MAX_BATCH = 100;\nconst REQUEST_TIMEOUT_MS = 30_000;\nconst BATCH_DELAY_MS = 100;\n\nexport interface OpenAIEmbeddingOptions {\n    /** OpenAI API key. Falls back to OPENAI_API_KEY env var. */\n    apiKey?: string;\n    /** Model name. Default: 'text-embedding-3-small' */\n    model?: string;\n    /** Vector dimensions. If omitted, uses model default. text-embedding-3-* supports custom dims. */\n    dims?: number;\n    /** Base URL override (for Azure, proxies, etc.) */\n    baseUrl?: string;\n    /** Request timeout in ms. Default: 30000 */\n    timeout?: number;\n}\n\nexport class OpenAIEmbedding implements EmbeddingProvider {\n    readonly dims: number;\n\n    private _apiKey: string;\n    private _model: string;\n    private _baseUrl: string;\n    private _requestDims: number | undefined;\n    private _timeout: number;\n\n    constructor(options: OpenAIEmbeddingOptions = {}) {\n        this._apiKey = options.apiKey ?? process.env.OPENAI_API_KEY ?? '';\n        this._model = options.model ?? DEFAULT_MODEL;\n        this._baseUrl = options.baseUrl ?? API_URL;\n        this._timeout = options.timeout ?? REQUEST_TIMEOUT_MS;\n\n        // Custom dims only supported by text-embedding-3-*\n        if (options.dims && this._model.startsWith('text-embedding-3')) {\n            this._requestDims = options.dims;\n            this.dims = options.dims;\n        } else {\n            this.dims = options.dims ?? DEFAULT_DIMS[this._model] ?? 1536;\n        }\n    }\n\n    async embed(text: string): Promise<Float32Array> {\n        const results = await this._request([text]);\n        return results[0];\n    }\n\n    async embedBatch(texts: string[]): Promise<Float32Array[]> {\n        if (texts.length === 0) return [];\n\n        const results: Float32Array[] = [];\n\n        for (let i = 0; i < texts.length; i += MAX_BATCH) {\n            if (i > 0) await sleep(BATCH_DELAY_MS);\n            const batch = texts.slice(i, i + MAX_BATCH);\n            const embeddings = await this._request(batch);\n            results.push(...embeddings);\n        }\n\n        return results;\n    }\n\n    async close(): Promise<void> {\n        // No resources to release\n    }\n\n    private _isTokenLimitError(errText: string): boolean {\n        return errText.includes('maximum input length') ||\n               errText.includes('maximum context length') ||\n               errText.includes('too many tokens');\n    }\n\n    private async _request(input: string[], retryDepth: number = 0): Promise<Float32Array[]> {\n        if (!this._apiKey) {\n            throw new Error('OpenAI API key required. Set OPENAI_API_KEY env var or pass apiKey option.');\n        }\n\n        const MAX_CHARS = 24_000;\n        const safeInput = input.map(t => t.length > MAX_CHARS ? t.slice(0, MAX_CHARS) : t);\n\n        const body: Record<string, any> = { model: this._model, input: safeInput };\n        if (this._requestDims) body.dimensions = this._requestDims;\n\n        const controller = new AbortController();\n        const timer = setTimeout(() => controller.abort(), this._timeout);\n\n        let res: Response;\n        try {\n            res = await fetch(this._baseUrl, {\n                method: 'POST',\n                headers: {\n                    'Content-Type': 'application/json',\n                    'Authorization': `Bearer ${this._apiKey}`,\n                },\n                body: JSON.stringify(body),\n                signal: controller.signal,\n            });\n        } catch (err: any) {\n            clearTimeout(timer);\n            if (err.name === 'AbortError') {\n                throw new Error(`OpenAI embedding request timed out after ${this._timeout}ms.`);\n            }\n            throw err;\n        } finally {\n            clearTimeout(timer);\n        }\n\n        if (!res.ok) {\n            return this._handleApiError(res, safeInput, retryDepth);\n        }\n\n        const json = await res.json() as {\n            data: Array<{ embedding: number[]; index: number }>;\n        };\n        return json.data.sort((a, b) => a.index - b.index).map(d => new Float32Array(d.embedding));\n    }\n\n    /** Handle API errors with token-limit retry logic. */\n    private async _handleApiError(\n        res: Response, safeInput: string[], retryDepth: number,\n    ): Promise<Float32Array[]> {\n        const err = await res.text();\n        const isTokenLimit = res.status === 400 && this._isTokenLimitError(err);\n\n        // Batch token limit → retry each item individually with aggressive truncation\n        if (isTokenLimit && safeInput.length > 1) {\n            const results: Float32Array[] = [];\n            for (const text of safeInput) {\n                const r = await this._request([text.slice(0, 8_000)]);\n                results.push(r[0]);\n            }\n            return results;\n        }\n        // Single item still failing → truncate to ~2k tokens (max 1 retry)\n        if (isTokenLimit && safeInput.length === 1 && retryDepth < 1) {\n            return this._request([safeInput[0].slice(0, 6_000)], retryDepth + 1);\n        }\n        throw new Error(`OpenAI embedding API error (${res.status}): ${err}`);\n    }\n}\n\n/** Simple delay helper. */\nfunction sleep(ms: number): Promise<void> {\n    return new Promise(resolve => setTimeout(resolve, ms));\n}\n"],"mappings":";;;;;AAcA,IAAM,gBAAgB;AACtB,IAAM,eAAuC;AAAA,EACzC,0BAA0B;AAAA,EAC1B,0BAA0B;AAAA,EAC1B,0BAA0B;AAC9B;AACA,IAAM,UAAU;AAChB,IAAM,YAAY;AAClB,IAAM,qBAAqB;AAC3B,IAAM,iBAAiB;AAehB,IAAM,kBAAN,MAAmD;AAAA,EAtC1D,OAsC0D;AAAA;AAAA;AAAA,EAC7C;AAAA,EAED;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAER,YAAY,UAAkC,CAAC,GAAG;AAC9C,SAAK,UAAU,QAAQ,UAAU,QAAQ,IAAI,kBAAkB;AAC/D,SAAK,SAAS,QAAQ,SAAS;AAC/B,SAAK,WAAW,QAAQ,WAAW;AACnC,SAAK,WAAW,QAAQ,WAAW;AAGnC,QAAI,QAAQ,QAAQ,KAAK,OAAO,WAAW,kBAAkB,GAAG;AAC5D,WAAK,eAAe,QAAQ;AAC5B,WAAK,OAAO,QAAQ;AAAA,IACxB,OAAO;AACH,WAAK,OAAO,QAAQ,QAAQ,aAAa,KAAK,MAAM,KAAK;AAAA,IAC7D;AAAA,EACJ;AAAA,EAEA,MAAM,MAAM,MAAqC;AAC7C,UAAM,UAAU,MAAM,KAAK,SAAS,CAAC,IAAI,CAAC;AAC1C,WAAO,QAAQ,CAAC;AAAA,EACpB;AAAA,EAEA,MAAM,WAAW,OAA0C;AACvD,QAAI,MAAM,WAAW,EAAG,QAAO,CAAC;AAEhC,UAAM,UAA0B,CAAC;AAEjC,aAAS,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK,WAAW;AAC9C,UAAI,IAAI,EAAG,OAAM,MAAM,cAAc;AACrC,YAAM,QAAQ,MAAM,MAAM,GAAG,IAAI,SAAS;AAC1C,YAAM,aAAa,MAAM,KAAK,SAAS,KAAK;AAC5C,cAAQ,KAAK,GAAG,UAAU;AAAA,IAC9B;AAEA,WAAO;AAAA,EACX;AAAA,EAEA,MAAM,QAAuB;AAAA,EAE7B;AAAA,EAEQ,mBAAmB,SAA0B;AACjD,WAAO,QAAQ,SAAS,sBAAsB,KACvC,QAAQ,SAAS,wBAAwB,KACzC,QAAQ,SAAS,iBAAiB;AAAA,EAC7C;AAAA,EAEA,MAAc,SAAS,OAAiB,aAAqB,GAA4B;AACrF,QAAI,CAAC,KAAK,SAAS;AACf,YAAM,IAAI,MAAM,4EAA4E;AAAA,IAChG;AAEA,UAAM,YAAY;AAClB,UAAM,YAAY,MAAM,IAAI,OAAK,EAAE,SAAS,YAAY,EAAE,MAAM,GAAG,SAAS,IAAI,CAAC;AAEjF,UAAM,OAA4B,EAAE,OAAO,KAAK,QAAQ,OAAO,UAAU;AACzE,QAAI,KAAK,aAAc,MAAK,aAAa,KAAK;AAE9C,UAAM,aAAa,IAAI,gBAAgB;AACvC,UAAM,QAAQ,WAAW,MAAM,WAAW,MAAM,GAAG,KAAK,QAAQ;AAEhE,QAAI;AACJ,QAAI;AACA,YAAM,MAAM,MAAM,KAAK,UAAU;AAAA,QAC7B,QAAQ;AAAA,QACR,SAAS;AAAA,UACL,gBAAgB;AAAA,UAChB,iBAAiB,UAAU,KAAK,OAAO;AAAA,QAC3C;AAAA,QACA,MAAM,KAAK,UAAU,IAAI;AAAA,QACzB,QAAQ,WAAW;AAAA,MACvB,CAAC;AAAA,IACL,SAAS,KAAU;AACf,mBAAa,KAAK;AAClB,UAAI,IAAI,SAAS,cAAc;AAC3B,cAAM,IAAI,MAAM,4CAA4C,KAAK,QAAQ,KAAK;AAAA,MAClF;AACA,YAAM;AAAA,IACV,UAAE;AACE,mBAAa,KAAK;AAAA,IACtB;AAEA,QAAI,CAAC,IAAI,IAAI;AACT,aAAO,KAAK,gBAAgB,KAAK,WAAW,UAAU;AAAA,IAC1D;AAEA,UAAM,OAAO,MAAM,IAAI,KAAK;AAG5B,WAAO,KAAK,KAAK,KAAK,CAAC,GAAG,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,OAAK,IAAI,aAAa,EAAE,SAAS,CAAC;AAAA,EAC7F;AAAA;AAAA,EAGA,MAAc,gBACV,KAAe,WAAqB,YACb;AACvB,UAAM,MAAM,MAAM,IAAI,KAAK;AAC3B,UAAM,eAAe,IAAI,WAAW,OAAO,KAAK,mBAAmB,GAAG;AAGtE,QAAI,gBAAgB,UAAU,SAAS,GAAG;AACtC,YAAM,UAA0B,CAAC;AACjC,iBAAW,QAAQ,WAAW;AAC1B,cAAM,IAAI,MAAM,KAAK,SAAS,CAAC,KAAK,MAAM,GAAG,GAAK,CAAC,CAAC;AACpD,gBAAQ,KAAK,EAAE,CAAC,CAAC;AAAA,MACrB;AACA,aAAO;AAAA,IACX;AAEA,QAAI,gBAAgB,UAAU,WAAW,KAAK,aAAa,GAAG;AAC1D,aAAO,KAAK,SAAS,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,GAAK,CAAC,GAAG,aAAa,CAAC;AAAA,IACvE;AACA,UAAM,IAAI,MAAM,+BAA+B,IAAI,MAAM,MAAM,GAAG,EAAE;AAAA,EACxE;AACJ;AAGA,SAAS,MAAM,IAA2B;AACtC,SAAO,IAAI,QAAQ,aAAW,WAAW,SAAS,EAAE,CAAC;AACzD;AAFS;","names":[]}