@maadb/core 0.7.17 → 0.8.0

package/dist/engine/semantic/indexer.d.ts

@@ -0,0 +1,21 @@
+import type { EmbeddingProvider, SemanticIndex } from './types.js';
+export declare class SemanticIndexer {
+    private readonly index;
+    private readonly provider;
+    private readonly batchSize;
+    private currentDrain;
+    private rerun;
+    private stopped;
+    constructor(index: SemanticIndex, provider: EmbeddingProvider, batchSize?: number);
+    /** Crash-resume: drain whatever a prior process left pending. Fire-and-forget. */
+    start(): void;
+    /** Signal that new work may be queued. Non-blocking. */
+    kick(): void;
+    /** Awaitable drain to completion (reindex --embeddings, tests). */
+    flush(): Promise<void>;
+    /** Stop accepting work; lets an in-flight drain finish. */
+    stop(): Promise<void>;
+    private ensureDraining;
+    private drain;
+}
+//# sourceMappingURL=indexer.d.ts.map

package/dist/engine/semantic/indexer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexer.d.ts","sourceRoot":"","sources":["../../../src/engine/semantic/indexer.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAkB,MAAM,YAAY,CAAC;AAInF,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoB;IAC7C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,YAAY,CAA8B;IAClD,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,OAAO,CAAS;gBAEZ,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,iBAAiB,EAAE,SAAS,SAAgB;IAMxF,kFAAkF;IAClF,KAAK,IAAI,IAAI;IAIb,wDAAwD;IACxD,IAAI,IAAI,IAAI;IAKZ,mEAAmE;IAC7D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B,2DAA2D;IACrD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAO3B,OAAO,CAAC,cAAc;YASR,KAAK;CA0BpB"}

package/dist/engine/semantic/indexer.js

@@ -0,0 +1,91 @@
+// ============================================================================
+// Semantic indexer (0.8.0) — the async embed worker. Drains the persisted
+// embed_queue: pull a batch of pending blocks, embed them (kind='document'),
+// upsert vectors, clear the queue rows. Runs OUTSIDE the engine write mutex —
+// model/network latency must never block the write FIFO. The DB writes it does
+// (putBlockEmbeddings) are fast and synchronous; only the embed() call awaits.
+//
+// Lifecycle: start() does a crash-resume drain of whatever the queue holds from
+// a prior process; kick() is fired (fire-and-forget) after each durable write;
+// flush() is the awaitable form used by reindex --embeddings and tests.
+// Single-flight: one drain at a time; a kick during a drain schedules a rerun.
+// Fail-soft: an embed error tallies failures and leaves the queue rows for a
+// later retry rather than dropping them or hot-looping.
+// ============================================================================
+import { logger } from '../logger.js';
+const DEFAULT_BATCH = 32;
+export class SemanticIndexer {
+    index;
+    provider;
+    batchSize;
+    currentDrain = null;
+    rerun = false;
+    stopped = false;
+    constructor(index, provider, batchSize = DEFAULT_BATCH) {
+        this.index = index;
+        this.provider = provider;
+        this.batchSize = batchSize > 0 ? batchSize : DEFAULT_BATCH;
+    }
+    /** Crash-resume: drain whatever a prior process left pending. Fire-and-forget. */
+    start() {
+        this.kick();
+    }
+    /** Signal that new work may be queued. Non-blocking. */
+    kick() {
+        if (this.stopped)
+            return;
+        void this.ensureDraining();
+    }
+    /** Awaitable drain to completion (reindex --embeddings, tests). */
+    async flush() {
+        if (this.stopped)
+            return;
+        await this.ensureDraining();
+    }
+    /** Stop accepting work; lets an in-flight drain finish. */
+    async stop() {
+        this.stopped = true;
+        if (this.currentDrain) {
+            try {
+                await this.currentDrain;
+            }
+            catch { /* already logged */ }
+        }
+    }
+    ensureDraining() {
+        if (this.currentDrain) {
+            this.rerun = true; // fold this request into the running drain
+            return this.currentDrain;
+        }
+        this.currentDrain = this.drain().finally(() => { this.currentDrain = null; });
+        return this.currentDrain;
+    }
+    async drain() {
+        do {
+            this.rerun = false;
+            while (!this.stopped) {
+                const batch = this.index.takeEmbedBatch(this.batchSize);
+                if (batch.length === 0)
+                    break;
+                try {
+                    const vectors = await this.provider.embed(batch.map(b => b.text), 'document');
+                    if (vectors.length !== batch.length) {
+                        throw new Error(`provider returned ${vectors.length} vectors for ${batch.length} inputs`);
+                    }
+                    const rows = batch.map((b, i) => ({
+                        qid: b.qid, docId: b.docId, blockOrd: b.blockOrd, vector: vectors[i],
+                    }));
+                    this.index.putBlockEmbeddings(rows);
+                }
+                catch (e) {
+                    // Leave the queue rows in place for a later retry; break to avoid a
+                    // hot loop on a persistent failure (next kick/flush retries).
+                    this.index.recordFailure(batch.length);
+                    logger.bestEffort('engine', 'embed_batch_failed', `embedding batch failed (${batch.length} blocks); left queued for retry: ${e.message}`);
+                    return;
+                }
+            }
+        } while (this.rerun && !this.stopped);
+    }
+}
+//# sourceMappingURL=indexer.js.map

package/dist/engine/semantic/indexer.js.map

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

package/dist/engine/semantic/provider.d.ts

@@ -0,0 +1,10 @@
+import type { EmbeddingProvider } from './types.js';
+import { type SemanticEnv } from './config.js';
+export interface ProviderResolveOptions {
+    /** Host-injected provider (DI). Wins over env when present. */
+    injected?: EmbeddingProvider | undefined;
+    /** Override env (tests); defaults to readSemanticEnv(). */
+    env?: SemanticEnv | undefined;
+}
+export declare function resolveEmbeddingProvider(opts?: ProviderResolveOptions): EmbeddingProvider | null;
+//# sourceMappingURL=provider.d.ts.map

package/dist/engine/semantic/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/engine/semantic/provider.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAmB,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAOhE,MAAM,WAAW,sBAAsB;IACrC,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACzC,2DAA2D;IAC3D,GAAG,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CAC/B;AAED,wBAAgB,wBAAwB,CAAC,IAAI,GAAE,sBAA2B,GAAG,iBAAiB,GAAG,IAAI,CAoCpG"}

package/dist/engine/semantic/provider.js

@@ -0,0 +1,52 @@
+// ============================================================================
+// Embedding provider resolution (0.8.0)
+// Two construction paths, in priority order:
+//   1. Injected — the host app passes an EmbeddingProvider; the engine holds no
+//      API keys. This is how an embedding host reuses its existing client.
+//   2. Env-constructed — for standalone `maad serve`: MAAD_EMBED_PROVIDER picks
+//      openai | fake | local, sized via MAAD_EMBED_MODEL / MAAD_EMBED_DIM.
+// Returns null when no vector provider is configured — semantic stays in
+// lexical-only mode (exact/FTS work; semantic/hybrid degrade to lexical).
+// ============================================================================
+import { logger } from '../logger.js';
+import { readSemanticEnv } from './config.js';
+import { OpenAiEmbeddingProvider } from './providers/openai.js';
+import { FakeEmbeddingProvider } from './providers/fake.js';
+const DEFAULT_OPENAI_MODEL = 'text-embedding-3-small';
+const DEFAULT_FAKE_DIM = 64;
+export function resolveEmbeddingProvider(opts = {}) {
+    if (opts.injected)
+        return opts.injected;
+    const env = opts.env ?? readSemanticEnv();
+    switch (env.provider) {
+        case 'openai': {
+            if (env.openaiApiKey === undefined) {
+                logger.degraded('engine', 'semantic_provider_unconfigured', 'MAAD_EMBED_PROVIDER=openai but MAAD_OPENAI_API_KEY is unset; running lexical-only (no vectors)');
+                return null;
+            }
+            try {
+                return new OpenAiEmbeddingProvider({
+                    apiKey: env.openaiApiKey,
+                    model: env.model ?? DEFAULT_OPENAI_MODEL,
+                    dim: env.dim,
+                    baseUrl: env.openaiBaseUrl,
+                });
+            }
+            catch (e) {
+                logger.degraded('engine', 'semantic_provider_error', `failed to construct OpenAI embedding provider; lexical-only: ${e.message}`);
+                return null;
+            }
+        }
+        case 'fake':
+            return new FakeEmbeddingProvider(env.dim ?? DEFAULT_FAKE_DIM);
+        case 'local':
+            // Phase 2 — local transformers.js provider (optional dep). Not in this build.
+            logger.degraded('engine', 'semantic_provider_unavailable', 'MAAD_EMBED_PROVIDER=local is not available in this build; ' +
+                'inject a provider or use MAAD_EMBED_PROVIDER=openai. Running lexical-only.');
+            return null;
+        case 'none':
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=provider.js.map

package/dist/engine/semantic/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../../src/engine/semantic/provider.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,wCAAwC;AACxC,6CAA6C;AAC7C,gFAAgF;AAChF,2EAA2E;AAC3E,gFAAgF;AAChF,2EAA2E;AAC3E,yEAAyE;AACzE,0EAA0E;AAC1E,+EAA+E;AAE/E,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,OAAO,EAAE,eAAe,EAAoB,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,MAAM,oBAAoB,GAAG,wBAAwB,CAAC;AACtD,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAS5B,MAAM,UAAU,wBAAwB,CAAC,OAA+B,EAAE;IACxE,IAAI,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC,QAAQ,CAAC;IACxC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,eAAe,EAAE,CAAC;IAE1C,QAAQ,GAAG,CAAC,QAAQ,EAAE,CAAC;QACrB,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,IAAI,GAAG,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;gBACnC,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,gCAAgC,EACxD,gGAAgG,CAAC,CAAC;gBACpG,OAAO,IAAI,CAAC;YACd,CAAC;YACD,IAAI,CAAC;gBACH,OAAO,IAAI,uBAAuB,CAAC;oBACjC,MAAM,EAAE,GAAG,CAAC,YAAY;oBACxB,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,oBAAoB;oBACxC,GAAG,EAAE,GAAG,CAAC,GAAG;oBACZ,OAAO,EAAE,GAAG,CAAC,aAAa;iBAC3B,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,yBAAyB,EACjD,gEAAiE,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;gBAC1F,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QACD,KAAK,MAAM;YACT,OAAO,IAAI,qBAAqB,CAAC,GAAG,CAAC,GAAG,IAAI,gBAAgB,CAAC,CAAC;QAChE,KAAK,OAAO;YACV,8EAA8E;YAC9E,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,+BAA+B,EACvD,4DAA4D;gBAC5D,4EAA4E,CAAC,CAAC;YAChF,OAAO,IAAI,CAAC;QACd,KAAK,MAAM,CAAC;QACZ;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC"}

package/dist/engine/semantic/providers/fake.d.ts

@@ -0,0 +1,9 @@
+import type { EmbeddingProvider, EmbedKind } from '../types.js';
+export declare class FakeEmbeddingProvider implements EmbeddingProvider {
+    readonly id = "fake";
+    readonly model = "fake-hash";
+    readonly dim: number;
+    constructor(dim?: number);
+    embed(texts: string[], _kind: EmbedKind): Promise<Float32Array[]>;
+}
+//# sourceMappingURL=fake.d.ts.map

package/dist/engine/semantic/providers/fake.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake.d.ts","sourceRoot":"","sources":["../../../../src/engine/semantic/providers/fake.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAiChE,qBAAa,qBAAsB,YAAW,iBAAiB;IAC7D,QAAQ,CAAC,EAAE,UAAU;IACrB,QAAQ,CAAC,KAAK,eAAe;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;gBAET,GAAG,GAAE,MAAoB;IAI/B,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CAGxE"}

package/dist/engine/semantic/providers/fake.js

@@ -0,0 +1,54 @@
+// ============================================================================
+// Fake embedding provider (0.8.0) — a deterministic, offline, no-key provider
+// for tests and local development. It is a real hashing vectorizer (the
+// "hashing trick"): tokens map to fixed buckets, so identical text yields an
+// identical vector (self-retrieval distance 0) and texts sharing words are
+// closer. Not semantic in the learned sense, but deterministic and dependency-
+// free — the injected provider tests use to exercise the full embed→vec→search
+// loop without network or model weights.
+// ============================================================================
+const DEFAULT_DIM = 64;
+// FNV-1a 32-bit — stable across runs/platforms, no crypto dep.
+function fnv1a(s) {
+    let h = 0x811c9dc5;
+    for (let i = 0; i < s.length; i++) {
+        h ^= s.charCodeAt(i);
+        h = Math.imul(h, 0x01000193);
+    }
+    return h >>> 0;
+}
+function embedOne(text, dim) {
+    const v = new Float32Array(dim);
+    const tokens = text.toLowerCase().match(/[\p{L}\p{N}]+/gu) ?? [];
+    for (const tok of tokens) {
+        const h = fnv1a(tok);
+        const bucket = h % dim;
+        // signed update keeps the space from collapsing to all-positive
+        v[bucket] += (h & 1) === 0 ? 1 : -1;
+    }
+    // L2-normalize so cosine ranking via vec0's L2 distance is well-behaved;
+    // an empty/whitespace block maps to a stable nonzero unit vector.
+    let norm = 0;
+    for (let i = 0; i < dim; i++)
+        norm += v[i] * v[i];
+    norm = Math.sqrt(norm);
+    if (norm === 0) {
+        v[0] = 1;
+        return v;
+    }
+    for (let i = 0; i < dim; i++)
+        v[i] /= norm;
+    return v;
+}
+export class FakeEmbeddingProvider {
+    id = 'fake';
+    model = 'fake-hash';
+    dim;
+    constructor(dim = DEFAULT_DIM) {
+        this.dim = dim;
+    }
+    async embed(texts, _kind) {
+        return texts.map(t => embedOne(t, this.dim));
+    }
+}
+//# sourceMappingURL=fake.js.map

package/dist/engine/semantic/providers/fake.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake.js","sourceRoot":"","sources":["../../../../src/engine/semantic/providers/fake.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,8EAA8E;AAC9E,wEAAwE;AACxE,6EAA6E;AAC7E,2EAA2E;AAC3E,+EAA+E;AAC/E,+EAA+E;AAC/E,yCAAyC;AACzC,+EAA+E;AAI/E,MAAM,WAAW,GAAG,EAAE,CAAC;AAEvB,+DAA+D;AAC/D,SAAS,KAAK,CAAC,CAAS;IACtB,IAAI,CAAC,GAAG,UAAU,CAAC;IACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACrB,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,CAAC;AACjB,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY,EAAE,GAAW;IACzC,MAAM,CAAC,GAAG,IAAI,YAAY,CAAC,GAAG,CAAC,CAAC;IAChC,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,CAAC;IACjE,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QACrB,MAAM,MAAM,GAAG,CAAC,GAAG,GAAG,CAAC;QACvB,gEAAgE;QAChE,CAAC,CAAC,MAAM,CAAE,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvC,CAAC;IACD,yEAAyE;IACzE,kEAAkE;IAClE,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE;QAAE,IAAI,IAAI,CAAC,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;IACpD,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;QAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAAC,OAAO,CAAC,CAAC;IAAC,CAAC;IACvC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE;QAAE,CAAC,CAAC,CAAC,CAAE,IAAI,IAAI,CAAC;IAC5C,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,OAAO,qBAAqB;IACvB,EAAE,GAAG,MAAM,CAAC;IACZ,KAAK,GAAG,WAAW,CAAC;IACpB,GAAG,CAAS;IAErB,YAAY,MAAc,WAAW;QACnC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,KAAe,EAAE,KAAgB;QAC3C,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/C,CAAC;CACF"}

package/dist/engine/semantic/providers/openai.d.ts

@@ -0,0 +1,23 @@
+import type { EmbeddingProvider, EmbedKind } from '../types.js';
+export interface OpenAiProviderOptions {
+    apiKey: string;
+    model: string;
+    /** Explicit output dim. For 3-* models this is sent as `dimensions` (truncation). */
+    dim?: number | undefined;
+    /** API root (default https://api.openai.com); '/v1/embeddings' is appended. */
+    baseUrl?: string | undefined;
+    /** Injectable for tests; defaults to global fetch. */
+    fetchImpl?: typeof fetch | undefined;
+}
+export declare class OpenAiEmbeddingProvider implements EmbeddingProvider {
+    readonly id = "openai";
+    readonly model: string;
+    readonly dim: number;
+    private readonly apiKey;
+    private readonly url;
+    private readonly sendDimensions;
+    private readonly fetchImpl;
+    constructor(opts: OpenAiProviderOptions);
+    embed(texts: string[], _kind: EmbedKind): Promise<Float32Array[]>;
+}
+//# sourceMappingURL=openai.d.ts.map

package/dist/engine/semantic/providers/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../../../src/engine/semantic/providers/openai.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAYhE,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,qFAAqF;IACrF,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,sDAAsD;IACtD,SAAS,CAAC,EAAE,OAAO,KAAK,GAAG,SAAS,CAAC;CACtC;AAMD,qBAAa,uBAAwB,YAAW,iBAAiB;IAC/D,QAAQ,CAAC,EAAE,YAAY;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAU;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;gBAE7B,IAAI,EAAE,qBAAqB;IAgCjC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CAkDxE"}

package/dist/engine/semantic/providers/openai.js

@@ -0,0 +1,103 @@
+// ============================================================================
+// OpenAI embedding provider (0.8.0) — a thin POST /v1/embeddings client over the
+// built-in fetch (no SDK dep). Marginal-cost provider: if a deployment already
+// has an OpenAI key wired, embeddings reuse the same key/base. The engine never
+// stores the key beyond this provider closure.
+// ============================================================================
+const DEFAULT_BASE_URL = 'https://api.openai.com';
+// Native output dims for the common models — used when no explicit dim is set.
+// text-embedding-3-* additionally support server-side truncation via `dimensions`.
+const MODEL_DIMS = {
+    'text-embedding-3-small': 1536,
+    'text-embedding-3-large': 3072,
+    'text-embedding-ada-002': 1536,
+};
+export class OpenAiEmbeddingProvider {
+    id = 'openai';
+    model;
+    dim;
+    apiKey;
+    url;
+    sendDimensions;
+    fetchImpl;
+    constructor(opts) {
+        if (!opts.apiKey)
+            throw new Error('OpenAI embedding provider requires an API key (MAAD_OPENAI_API_KEY)');
+        this.apiKey = opts.apiKey;
+        this.model = opts.model;
+        const native = MODEL_DIMS[opts.model];
+        const resolved = opts.dim ?? native;
+        if (resolved === undefined) {
+            throw new Error(`Cannot determine embedding dim for OpenAI model "${opts.model}". ` +
+                `Set MAAD_EMBED_DIM explicitly.`);
+        }
+        // Only text-embedding-3-* support server-side dimension truncation.
+        const supportsTruncation = /^text-embedding-3-/.test(opts.model);
+        if (opts.dim !== undefined && native !== undefined) {
+            if (opts.dim > native) {
+                throw new Error(`MAAD_EMBED_DIM=${opts.dim} exceeds the native dim ${native} for "${opts.model}"; ` +
+                    `OpenAI embeddings can be truncated below native but never expanded.`);
+            }
+            if (opts.dim < native && !supportsTruncation) {
+                throw new Error(`Model "${opts.model}" does not support dimension truncation; ` +
+                    `set MAAD_EMBED_DIM=${native} or omit it (only text-embedding-3-* can truncate).`);
+            }
+        }
+        this.dim = resolved;
+        this.sendDimensions = supportsTruncation && opts.dim !== undefined && native !== undefined && opts.dim < native;
+        const base = (opts.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, '');
+        this.url = `${base}/v1/embeddings`;
+        this.fetchImpl = opts.fetchImpl ?? fetch;
+    }
+    async embed(texts, _kind) {
+        if (texts.length === 0)
+            return [];
+        const body = {
+            model: this.model,
+            input: texts,
+            encoding_format: 'float',
+        };
+        if (this.sendDimensions)
+            body['dimensions'] = this.dim;
+        const res = await this.fetchImpl(this.url, {
+            method: 'POST',
+            headers: {
+                'authorization': `Bearer ${this.apiKey}`,
+                'content-type': 'application/json',
+            },
+            body: JSON.stringify(body),
+        });
+        if (!res.ok) {
+            const detail = await res.text().catch(() => '');
+            throw new Error(`OpenAI embeddings request failed (${res.status}): ${detail.slice(0, 300)}`);
+        }
+        const json = (await res.json());
+        if (!json.data || json.data.length !== texts.length) {
+            throw new Error(`OpenAI embeddings returned ${json.data?.length ?? 0} vectors for ${texts.length} inputs`);
+        }
+        // Preserve input order regardless of response ordering. Validate each index
+        // (integer, in range, unique) and the vector width before use: an
+        // OpenAI-compatible endpoint (custom base URL) returning out-of-range or
+        // duplicate indices would otherwise leave holes in `out` that the worker's
+        // vectors[i]! trips over — failing and retrying the batch forever. A width
+        // mismatch would otherwise only surface as a sqlite-vec insert failure.
+        const out = new Array(texts.length);
+        const seen = new Set();
+        for (const item of json.data) {
+            if (!Number.isInteger(item.index) || item.index < 0 || item.index >= texts.length) {
+                throw new Error(`OpenAI embeddings returned an out-of-range index ${item.index} for ${texts.length} inputs.`);
+            }
+            if (seen.has(item.index)) {
+                throw new Error(`OpenAI embeddings returned a duplicate index ${item.index}.`);
+            }
+            seen.add(item.index);
+            if (item.embedding.length !== this.dim) {
+                throw new Error(`OpenAI returned a ${item.embedding.length}-dim vector but the provider is configured for ${this.dim} ` +
+                    `(model "${this.model}"). Check MAAD_EMBED_DIM / MAAD_EMBED_MODEL.`);
+            }
+            out[item.index] = Float32Array.from(item.embedding);
+        }
+        return out;
+    }
+}
+//# sourceMappingURL=openai.js.map

package/dist/engine/semantic/providers/openai.js.map

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

package/dist/engine/semantic/rrf.d.ts

@@ -0,0 +1,9 @@
+/** Default RRF constant. 60 is the value from the original RRF paper; larger K
+ *  flattens the contribution of top ranks (less aggressive). */
+export declare const DEFAULT_RRF_K = 60;
+/**
+ * Fuse ranked lists of opaque string keys. Input lists are in rank order (index
+ * 0 = best). Returns a key→score map; higher score = more relevant.
+ */
+export declare function rrfFuse(lists: string[][], k?: number): Map<string, number>;
+//# sourceMappingURL=rrf.d.ts.map

package/dist/engine/semantic/rrf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rrf.d.ts","sourceRoot":"","sources":["../../../src/engine/semantic/rrf.ts"],"names":[],"mappings":"AAWA;gEACgE;AAChE,eAAO,MAAM,aAAa,KAAK,CAAC;AAEhC;;;GAGG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,GAAE,MAAsB,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAUzF"}

package/dist/engine/semantic/rrf.js

@@ -0,0 +1,29 @@
+// ============================================================================
+// Reciprocal Rank Fusion (0.8.0)
+// Merge N independently-ranked lists into one score map. RRF is rank-based and
+// scale-free — exactly why the engine fuses here rather than handing the agent
+// two incomparable score columns (BM25 vs cosine distance). Each item's score
+// is Σ over the lists it appears in of 1/(K + rank), rank 1-based.
+//
+// Used for hybrid (two legs). Called with a single list it degrades to a clean
+// rank-based score, so exact/semantic single-leg paths reuse the same merge.
+// ============================================================================
+/** Default RRF constant. 60 is the value from the original RRF paper; larger K
+ *  flattens the contribution of top ranks (less aggressive). */
+export const DEFAULT_RRF_K = 60;
+/**
+ * Fuse ranked lists of opaque string keys. Input lists are in rank order (index
+ * 0 = best). Returns a key→score map; higher score = more relevant.
+ */
+export function rrfFuse(lists, k = DEFAULT_RRF_K) {
+    const scores = new Map();
+    for (const list of lists) {
+        for (let i = 0; i < list.length; i++) {
+            const key = list[i];
+            const contribution = 1 / (k + i + 1);
+            scores.set(key, (scores.get(key) ?? 0) + contribution);
+        }
+    }
+    return scores;
+}
+//# sourceMappingURL=rrf.js.map

package/dist/engine/semantic/rrf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rrf.js","sourceRoot":"","sources":["../../../src/engine/semantic/rrf.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,iCAAiC;AACjC,+EAA+E;AAC/E,+EAA+E;AAC/E,8EAA8E;AAC9E,mEAAmE;AACnE,EAAE;AACF,+EAA+E;AAC/E,6EAA6E;AAC7E,+EAA+E;AAE/E;gEACgE;AAChE,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,CAAC;AAEhC;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,KAAiB,EAAE,IAAY,aAAa;IAClE,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC;YACrB,MAAM,YAAY,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;YACrC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/engine/semantic/search.d.ts

@@ -0,0 +1,6 @@
+import { type Result } from '../../errors.js';
+import type { EngineContext } from '../context.js';
+import type { SemanticSearchQuery, SemanticSearchResult, SearchMode } from './types.js';
+export declare function isValidMode(mode: string): mode is SearchMode;
+export declare function semanticSearch(ctx: EngineContext, query: SemanticSearchQuery): Promise<Result<SemanticSearchResult>>;
+//# sourceMappingURL=search.d.ts.map

package/dist/engine/semantic/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/engine/semantic/search.ts"],"names":[],"mappings":"AAUA,OAAO,EAAiB,KAAK,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAInD,OAAO,KAAK,EACV,mBAAmB,EACnB,oBAAoB,EAEpB,UAAU,EACX,MAAM,YAAY,CAAC;AAapB,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,UAAU,CAE5D;AAcD,wBAAsB,cAAc,CAClC,GAAG,EAAE,aAAa,EAClB,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC,CAmKvC"}