@adhd/sox-embedding-provider 0.1.0

package/dist/fastembed.js.map

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

package/dist/fastembedProcessHost.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Child-PROCESS host for fastembed (onnxruntime-node@1.21.0) ONNX inference —
+ * BL-238/BL-171.
+ *
+ * ── Why a PROCESS, not a worker thread ──────────────────────────────────────
+ *
+ * `embedWorker.ts` (a `worker_threads.Worker`) hosts the cross-encoder rerank
+ * and NLI verify workloads, both driven by `@huggingface/transformers`'
+ * onnxruntime-node@1.24.3. Two independent, empirically-proven native hazards
+ * rule out ALSO hosting fastembed's onnxruntime-node@1.21.0 in that same
+ * worker (or any second worker thread):
+ *
+ *   1. **Cross-isolate hazard (whole-process fatal).** 2+ *separate*
+ *      `worker_threads.Worker` instances, each holding an active
+ *      onnxruntime-node `InferenceSession` and running inference
+ *      concurrently, fatally crash the ENTIRE process with:
+ *        `FATAL ERROR: HandleScope::HandleScope Entering the V8 API without
+ *        proper locking in place` (inside `InferenceSessionWrap::Run`).
+ *      Reproduced even with TWO workers on the exact SAME onnxruntime-node
+ *      version (fastembed's 1.21.0, twice) — not an ABI/version-mismatch bug,
+ *      a real thread-safety limitation of the addon whenever 2+ instances are
+ *      concurrently active in one process. (See `sharedOnnxWorker.ts`.)
+ *
+ *   2. **Same-thread native timing hazard (std::bad_alloc), proven even with
+ *      strict JS-level serialization.** Loading fastembed's
+ *      onnxruntime-node@1.21.0 in the SAME worker thread immediately after
+ *      `@huggingface/transformers`' onnxruntime-node@1.24.3 finishes loading
+ *      — even when every JS `await` is fully resolved and the two `init`
+ *      calls are proven (via instrumented tracing) to run strictly one after
+ *      the other with zero JS-level overlap — still deterministically threw
+ *      `std::bad_alloc` on the second (fastembed) init. This means the two
+ *      onnxruntime-node major versions leave lingering native state (e.g.
+ *      background thread-pool teardown) that is not synchronized by the JS
+ *      Promise resolving, so no amount of JS-side queuing/mutexing can make
+ *      sharing one thread safe — the hazard is at the native addon level,
+ *      below what JS scheduling can observe or serialize.
+ *
+ * Because (2) cannot be fixed by better JS scheduling, fastembed is hosted in
+ * its OWN **child process** (`node:child_process.fork()`), never a
+ * `worker_threads.Worker` and never sharing a thread or address space with
+ * `embedWorker.ts`. Separate OS processes cannot share native TLS/global
+ * allocator state or V8 isolates by construction — both hazard classes above
+ * are structurally impossible across a process boundary, not merely
+ * statistically less likely. This mirrors the exact isolation
+ * `tools/e2e/child-embed.mjs` already validated as a test-harness-side
+ * mitigation; this file makes it the real, package-level fix instead of a
+ * test-only workaround (BL-238's option (c)).
+ *
+ * ── Protocol (IPC via `process.send`/`process.on('message')`) ──────────────
+ *   request:  { id, type: 'init',       model: string, cacheDir: string }
+ *   request:  { id, type: 'embed',      text: string }
+ *   request:  { id, type: 'embedBatch', texts: string[] }
+ *   response: { id, initOk: true, dim }
+ *   response: { id, embedding: number[] }
+ *   response: { id, embeddings: number[][] }
+ *   response: { id, error: string }
+ *   internal: { __shutdown: true }
+ */
+export {};
+//# sourceMappingURL=fastembedProcessHost.d.ts.map

package/dist/fastembedProcessHost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fastembedProcessHost.d.ts","sourceRoot":"","sources":["../src/fastembedProcessHost.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDG"}

package/dist/fastembedProcessHost.js

@@ -0,0 +1,166 @@
+/**
+ * Child-PROCESS host for fastembed (onnxruntime-node@1.21.0) ONNX inference —
+ * BL-238/BL-171.
+ *
+ * ── Why a PROCESS, not a worker thread ──────────────────────────────────────
+ *
+ * `embedWorker.ts` (a `worker_threads.Worker`) hosts the cross-encoder rerank
+ * and NLI verify workloads, both driven by `@huggingface/transformers`'
+ * onnxruntime-node@1.24.3. Two independent, empirically-proven native hazards
+ * rule out ALSO hosting fastembed's onnxruntime-node@1.21.0 in that same
+ * worker (or any second worker thread):
+ *
+ *   1. **Cross-isolate hazard (whole-process fatal).** 2+ *separate*
+ *      `worker_threads.Worker` instances, each holding an active
+ *      onnxruntime-node `InferenceSession` and running inference
+ *      concurrently, fatally crash the ENTIRE process with:
+ *        `FATAL ERROR: HandleScope::HandleScope Entering the V8 API without
+ *        proper locking in place` (inside `InferenceSessionWrap::Run`).
+ *      Reproduced even with TWO workers on the exact SAME onnxruntime-node
+ *      version (fastembed's 1.21.0, twice) — not an ABI/version-mismatch bug,
+ *      a real thread-safety limitation of the addon whenever 2+ instances are
+ *      concurrently active in one process. (See `sharedOnnxWorker.ts`.)
+ *
+ *   2. **Same-thread native timing hazard (std::bad_alloc), proven even with
+ *      strict JS-level serialization.** Loading fastembed's
+ *      onnxruntime-node@1.21.0 in the SAME worker thread immediately after
+ *      `@huggingface/transformers`' onnxruntime-node@1.24.3 finishes loading
+ *      — even when every JS `await` is fully resolved and the two `init`
+ *      calls are proven (via instrumented tracing) to run strictly one after
+ *      the other with zero JS-level overlap — still deterministically threw
+ *      `std::bad_alloc` on the second (fastembed) init. This means the two
+ *      onnxruntime-node major versions leave lingering native state (e.g.
+ *      background thread-pool teardown) that is not synchronized by the JS
+ *      Promise resolving, so no amount of JS-side queuing/mutexing can make
+ *      sharing one thread safe — the hazard is at the native addon level,
+ *      below what JS scheduling can observe or serialize.
+ *
+ * Because (2) cannot be fixed by better JS scheduling, fastembed is hosted in
+ * its OWN **child process** (`node:child_process.fork()`), never a
+ * `worker_threads.Worker` and never sharing a thread or address space with
+ * `embedWorker.ts`. Separate OS processes cannot share native TLS/global
+ * allocator state or V8 isolates by construction — both hazard classes above
+ * are structurally impossible across a process boundary, not merely
+ * statistically less likely. This mirrors the exact isolation
+ * `tools/e2e/child-embed.mjs` already validated as a test-harness-side
+ * mitigation; this file makes it the real, package-level fix instead of a
+ * test-only workaround (BL-238's option (c)).
+ *
+ * ── Protocol (IPC via `process.send`/`process.on('message')`) ──────────────
+ *   request:  { id, type: 'init',       model: string, cacheDir: string }
+ *   request:  { id, type: 'embed',      text: string }
+ *   request:  { id, type: 'embedBatch', texts: string[] }
+ *   response: { id, initOk: true, dim }
+ *   response: { id, embedding: number[] }
+ *   response: { id, embeddings: number[][] }
+ *   response: { id, error: string }
+ *   internal: { __shutdown: true }
+ */
+import * as fs from 'node:fs';
+// ── Model management ──────────────────────────────────────────────────────────
+const MODEL_MAP = {
+    'bge-small-en-v1.5': 'fast-bge-small-en-v1.5',
+    'bge-base-en-v1.5': 'fast-bge-base-en-v1.5',
+    'multilingual-e5-large': 'fast-multilingual-e5-large',
+    'bge-m3': 'BAAI/bge-m3',
+    'codexembed-400m': 'CodeXEmbed-400M',
+};
+let _embedder = null;
+let _currentModel = '';
+let _currentCacheDir = '';
+async function loadModel(model, cacheDir) {
+    if (_embedder && _currentModel === model && _currentCacheDir === cacheDir) {
+        const models = _embedder.listSupportedModels();
+        const info = models.find((m) => m.model === model);
+        return { dim: info?.dim ?? 0 };
+    }
+    const { FlagEmbedding, EmbeddingModel: EM } = await import('fastembed');
+    const fastModel = MODEL_MAP[model] ?? model;
+    const modelKeys = Object.keys(EM);
+    const foundKey = modelKeys.find((k) => EM[k] === fastModel);
+    const modelEnum = foundKey ? EM[foundKey] : fastModel;
+    fs.mkdirSync(cacheDir, { recursive: true });
+    _embedder = (await FlagEmbedding.init({
+        model: modelEnum,
+        cacheDir,
+        showDownloadProgress: false,
+    }));
+    _currentModel = model;
+    _currentCacheDir = cacheDir;
+    const models = _embedder.listSupportedModels();
+    const info = models.find((m) => m.model === model);
+    return { dim: info?.dim ?? 0 };
+}
+async function collectEmbeddings(embedder, texts) {
+    const results = [];
+    for await (const batch of embedder.embed(texts, 256)) {
+        for (const vec of batch) {
+            results.push(vec);
+        }
+    }
+    return results;
+}
+// ── Serialized request queue ────────────────────────────────────────────────
+//
+// Defense in depth: also serialize requests within this process (init vs.
+// embed/embedBatch racing against each other has no known hazard today since
+// only ONE onnxruntime-node version ever loads in this process, but there is
+// no benefit to concurrent native calls here either — correctness first).
+let _queue = Promise.resolve();
+function enqueue(task) {
+    _queue = _queue.then(task, task);
+}
+function send(msg) {
+    process.send?.(msg);
+}
+async function handleRequest(msg) {
+    if (msg.type === 'init') {
+        try {
+            const { dim } = await loadModel(msg.model, msg.cacheDir);
+            send({ id: msg.id, initOk: true, dim });
+        }
+        catch (e) {
+            send({ id: msg.id, error: String(e instanceof Error ? e.message : e) });
+        }
+        return;
+    }
+    if (msg.type === 'embed') {
+        if (!_embedder) {
+            send({ id: msg.id, error: 'Model not initialized' });
+            return;
+        }
+        try {
+            const vec = await _embedder.queryEmbed(msg.text);
+            send({ id: msg.id, embedding: Array.from(vec) });
+        }
+        catch (e) {
+            send({ id: msg.id, error: String(e instanceof Error ? e.message : e) });
+        }
+        return;
+    }
+    if (msg.type === 'embedBatch') {
+        if (!_embedder) {
+            send({ id: msg.id, error: 'Model not initialized' });
+            return;
+        }
+        try {
+            const embeddings = await collectEmbeddings(_embedder, msg.texts);
+            send({ id: msg.id, embeddings });
+        }
+        catch (e) {
+            send({ id: msg.id, error: String(e instanceof Error ? e.message : e) });
+        }
+        return;
+    }
+}
+process.on('message', (msg) => {
+    if ('__shutdown' in msg) {
+        process.exit(0);
+        return;
+    }
+    enqueue(() => handleRequest(msg));
+});
+// Let the parent decide the process lifecycle (it never calls `.ref()`/relies
+// on this process staying alive beyond its own `disconnect`/`kill`); nothing
+// else to keep this process alive once IPC is torn down.
+//# sourceMappingURL=fastembedProcessHost.js.map

package/dist/fastembedProcessHost.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,145 @@
+export type EmbedRole = 'document' | 'query';
+export interface EmbeddingProviderMetadata {
+    modelId: string;
+    dimensions: number;
+    maxTokens: number;
+    isRemote: boolean;
+    isDeterministic: boolean;
+    providerUri?: string;
+}
+export interface EmbeddingHealth {
+    configured: string;
+    active: string | null;
+    state: 'uninitialized' | 'warming' | 'real' | 'error';
+    dimensions: number | null;
+    last_error: string | null;
+}
+export interface EmbeddingProvider {
+    readonly metadata: EmbeddingProviderMetadata;
+    embedSingle(text: string, role?: EmbedRole): Promise<Float32Array>;
+    embedBatch(texts: string[], opts?: {
+        role?: EmbedRole;
+        batchSize?: number;
+    }): AsyncIterable<Float32Array>;
+    warmUp(texts: string[]): Promise<void>;
+    /** Return the current embedding health per CONTRACTS §E. */
+    health(): EmbeddingHealth;
+}
+export interface EmbeddingProviderConfig {
+    type: string;
+    model: string;
+    options?: Record<string, unknown>;
+}
+export declare class TransientEmbeddingError extends Error {
+    readonly retryAfterMs: number | undefined;
+    constructor(message: string, retryAfterMs?: number);
+}
+export declare class PermanentEmbeddingError extends Error {
+    constructor(message: string);
+}
+export declare class ResolutionError extends Error {
+    constructor(message: string);
+}
+/**
+ * Static registration for a fastembed ONNX model.
+ * Each model has a known HF repo, dimension, context window, and description.
+ */
+export interface FastEmbedModelConfig {
+    modelId: string;
+    hfRepoId: string;
+    dim: number;
+    maxTokens: number;
+    description: string;
+}
+/**
+ * Worker thread pool configuration for fastembed ONNX inference.
+ *
+ * SOX-DOC-004: not currently consumed by `createEmbeddingProvider()` /
+ * `createFastembedProvider()` — no code constructs or reads a
+ * `FastEmbedPoolConfig` today. Kept as a forward-declared shape for a future
+ * multi-worker pool; do not assume it has any runtime effect yet.
+ */
+export interface FastEmbedPoolConfig {
+    /** Maximum number of ONNX inference workers. Default: os.cpus().length / 2, minimum 1. */
+    maxWorkers?: number;
+    /** Models to preload at pool init. Lazy-load on first use if omitted. */
+    preloadModels?: string[];
+    /** Per-model batch size hint. Overrides the default 256 (`DEFAULT_BATCH_SIZE` in fastembed.ts). */
+    batchSizes?: Record<string, number>;
+}
+/**
+ * Policy for migrating vectors from one embedding model to another.
+ */
+export interface ReembedPolicy {
+    sourceModel: string;
+    targetModel: string;
+    batchSize: number;
+    dryRun: boolean;
+}
+/**
+ * Local model cache: download, verify SHA-256, and manage model binaries.
+ * Binaries are stored at <dataRoot>/models/<modelId>/<version>/ with a sidecar .sha256 file.
+ *
+ * @deprecated SOX-BUG-002: dead API. `createEmbeddingProvider()` /
+ * `FastembedProvider` never accept or use a `ModelCache` — fastembed resolves
+ * a plain `cacheDir` STRING and `FlagEmbedding.init({ model, cacheDir })`
+ * downloads and caches the model for itself. That string is resolved as
+ * `config.options.cacheDir` → `SOX_EMBED_CACHE_DIR` → `$XDG_CACHE_HOME/sox/models`
+ * → `~/.cache/sox/models`. This interface (and `FileSystemModelCache` below)
+ * is kept only for external consumers who may already depend on it; do not
+ * wire it into the factory expecting it to have any effect.
+ */
+export interface ModelCache {
+    /** Download and verify model binary. Returns once the model is ready. Throws ResolutionError on SHA-256 mismatch. */
+    ensure(modelId: string): Promise<void>;
+    /** Check whether the model binary is already in local cache. */
+    cached(modelId: string): boolean;
+    /** Remove a single model from cache. Does not affect other models. */
+    clear(modelId: string): Promise<void>;
+    /** Streaming download with progress. Yields byte-level progress updates. */
+    ensureStream(modelId: string): AsyncIterable<{
+        bytesDownloaded: number;
+        totalBytes: number;
+    }>;
+}
+/**
+ * @deprecated SOX-BUG-002: dead API, not used by `createEmbeddingProvider` or
+ * `FastembedProvider`. Fastembed manages its own model cache internally via
+ * the `cacheDir` string (see `ModelCache` JSDoc above for the resolution
+ * order). Kept only for external consumers; do not wire it into the factory.
+ */
+export { FileSystemModelCache } from './cache.js';
+/**
+ * BL-238/BL-171 fix: the single shared ONNX worker singleton for rerank +
+ * verify. `@adhd/sox-hybrid-search`'s cross-encoder and
+ * `@adhd/sox-claim-verification`'s NLI verifier MUST route ONNX inference
+ * through this one process-wide `worker_threads.Worker` instead of
+ * constructing their own — see `sharedOnnxWorker.ts` for the full
+ * root-cause writeup and rationale.
+ */
+export { getSharedOnnxWorker, SharedOnnxWorkerClient } from './sharedOnnxWorker.js';
+/**
+ * BL-238/BL-171 fix: the single shared fastembed CHILD PROCESS singleton.
+ * This package's own `FastembedProvider` routes ONNX inference through this
+ * one process-wide child process instead of constructing its own
+ * `worker_threads.Worker` or process — fastembed's onnxruntime-node@1.21.0
+ * cannot safely share a thread with `getSharedOnnxWorker()`'s
+ * onnxruntime-node@1.24.3, even sequentially — see
+ * `sharedFastembedProcess.ts` / `fastembedProcessHost.ts` for the full
+ * root-cause writeup and rationale.
+ */
+export { getSharedFastembedProcess, SharedFastembedProcessClient, } from './sharedFastembedProcess.js';
+export declare function createEmbeddingProvider(config: EmbeddingProviderConfig): Promise<EmbeddingProvider>;
+/**
+ * Single source of truth for the fastembed warmup/init timeout budget.
+ *
+ * Shared by TWO call sites that were previously two disagreeing copies
+ * (SOX-BUG-001): the outer `createFastembedProvider()` factory wrapper
+ * (below) that bounds the initial `embedSingle('warmup')` call, AND the
+ * inner `FastembedProvider`'s worker-init `readyPromise` timeout
+ * (fastembed.ts) that bounds the actual ONNX model load inside the worker
+ * thread. Both now read this one function/env var so a cold ONNX model
+ * download is bounded consistently end-to-end.
+ */
+export declare function warmupTimeoutMs(): number;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,138 @@
+// @adhd/sox-embedding-provider — pluggable text→vector embedding
+// Authoritative interface spec: docs/plan/memory-refactor/COMPILED_INTERFACES.md
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+// ── Error taxonomy — three tiers, no silent degradation ──────────────────────
+export class TransientEmbeddingError extends Error {
+    retryAfterMs;
+    constructor(message, retryAfterMs) {
+        super(message);
+        this.name = 'TransientEmbeddingError';
+        this.retryAfterMs = retryAfterMs;
+    }
+}
+export class PermanentEmbeddingError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'PermanentEmbeddingError';
+    }
+}
+export class ResolutionError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ResolutionError';
+    }
+}
+// ── Re-exports ────────────────────────────────────────────────────────────────
+/**
+ * @deprecated SOX-BUG-002: dead API, not used by `createEmbeddingProvider` or
+ * `FastembedProvider`. Fastembed manages its own model cache internally via
+ * the `cacheDir` string (see `ModelCache` JSDoc above for the resolution
+ * order). Kept only for external consumers; do not wire it into the factory.
+ */
+export { FileSystemModelCache } from './cache.js';
+/**
+ * BL-238/BL-171 fix: the single shared ONNX worker singleton for rerank +
+ * verify. `@adhd/sox-hybrid-search`'s cross-encoder and
+ * `@adhd/sox-claim-verification`'s NLI verifier MUST route ONNX inference
+ * through this one process-wide `worker_threads.Worker` instead of
+ * constructing their own — see `sharedOnnxWorker.ts` for the full
+ * root-cause writeup and rationale.
+ */
+export { getSharedOnnxWorker, SharedOnnxWorkerClient } from './sharedOnnxWorker.js';
+/**
+ * BL-238/BL-171 fix: the single shared fastembed CHILD PROCESS singleton.
+ * This package's own `FastembedProvider` routes ONNX inference through this
+ * one process-wide child process instead of constructing its own
+ * `worker_threads.Worker` or process — fastembed's onnxruntime-node@1.21.0
+ * cannot safely share a thread with `getSharedOnnxWorker()`'s
+ * onnxruntime-node@1.24.3, even sequentially — see
+ * `sharedFastembedProcess.ts` / `fastembedProcessHost.ts` for the full
+ * root-cause writeup and rationale.
+ */
+export { getSharedFastembedProcess, SharedFastembedProcessClient, } from './sharedFastembedProcess.js';
+// ── Factory ───────────────────────────────────────────────────────────────────
+export async function createEmbeddingProvider(config) {
+    if (!config.type || typeof config.type !== 'string') {
+        throw new ResolutionError(`Invalid provider type: ${String(config.type)}`);
+    }
+    switch (config.type) {
+        case 'fastembed':
+            return createFastembedProvider(config);
+        case 'remote':
+            return createRemoteProvider(config);
+        default:
+            throw new ResolutionError(`Unknown embedding provider type: "${config.type}" (expected 'fastembed' or 'remote')`);
+    }
+}
+// ── Provider factories ────────────────────────────────────────────────────────
+async function createFastembedProvider(config) {
+    const { FastembedProvider, MODEL_CONFIGS, DEFAULT_MODEL } = await import('./fastembed.js');
+    const modelId = config.model || DEFAULT_MODEL;
+    const cfg = MODEL_CONFIGS[modelId];
+    if (!cfg) {
+        throw new ResolutionError(`Unknown fastembed model: "${modelId}". Supported: ${Object.keys(MODEL_CONFIGS).join(', ')}`);
+    }
+    const cacheDir = config.options?.['cacheDir'] ??
+        process.env['SOX_EMBED_CACHE_DIR'] ??
+        joinDefaultCacheDir();
+    try {
+        const provider = new FastembedProvider(modelId, cfg.dim, cacheDir);
+        await withTimeout(provider.embedSingle('warmup'), warmupTimeoutMs(), 'fastembed warmup');
+        return provider;
+    }
+    catch (err) {
+        if (err instanceof ResolutionError)
+            throw err;
+        const message = err instanceof Error ? err.message : String(err);
+        throw new ResolutionError(`Fastembed provider "${modelId}" failed to initialise: ${message}`);
+    }
+}
+async function createRemoteProvider(config) {
+    const { RemoteProvider } = await import('./remote.js');
+    const modelId = config.model || 'remote-768';
+    const dimensions = config.options?.['dimensions'] ?? 768;
+    const endpoint = config.options?.['endpoint'] ?? '';
+    const apiKey = config.options?.['apiKey'];
+    if (!endpoint) {
+        throw new ResolutionError('Remote provider requires an endpoint URL in config.options.endpoint');
+    }
+    return new RemoteProvider(modelId, dimensions, endpoint, apiKey);
+}
+// ── Helpers ───────────────────────────────────────────────────────────────────
+/**
+ * Single source of truth for the fastembed warmup/init timeout budget.
+ *
+ * Shared by TWO call sites that were previously two disagreeing copies
+ * (SOX-BUG-001): the outer `createFastembedProvider()` factory wrapper
+ * (below) that bounds the initial `embedSingle('warmup')` call, AND the
+ * inner `FastembedProvider`'s worker-init `readyPromise` timeout
+ * (fastembed.ts) that bounds the actual ONNX model load inside the worker
+ * thread. Both now read this one function/env var so a cold ONNX model
+ * download is bounded consistently end-to-end.
+ */
+export function warmupTimeoutMs() {
+    const raw = Number(process.env['SOX_EMBED_WARMUP_TIMEOUT_MS']);
+    return Number.isFinite(raw) && raw > 0 ? raw : 180_000;
+}
+function withTimeout(p, ms, label) {
+    return new Promise((resolve, reject) => {
+        const to = setTimeout(() => {
+            reject(new Error(`${label} timed out after ${ms}ms`));
+        }, ms);
+        if (typeof to.unref === 'function')
+            to.unref();
+        p.then((v) => {
+            clearTimeout(to);
+            resolve(v);
+        }, (e) => {
+            clearTimeout(to);
+            reject(e instanceof Error ? e : new Error(String(e)));
+        });
+    });
+}
+function joinDefaultCacheDir() {
+    const xdg = process.env['XDG_CACHE_HOME'];
+    return join(xdg ?? join(homedir(), '.cache'), 'sox', 'models');
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@adhd/sox-embedding-provider",
+  "version": "0.1.0",
+  "description": "Pluggable text→vector embedding provider — generic EmbeddingProvider interface, config-driven model resolution, async batch-first API (AsyncIterable). Default: fastembed (local ONNX, >=3 model dims proven). Loud-fail: createEmbeddingProvider() throws ResolutionError if config is invalid or model cannot load — no silent downgrade.",
+  "license": "MIT",
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@huggingface/transformers": "^4.2.0",
+    "fastembed": "^2.1.0"
+  },
+  "sox": {
+    "area": "data",
+    "group": "embed",
+    "concerns": [
+      "text→vector (EmbeddingProvider interface)",
+      "config-driven model resolution (createEmbeddingProvider factory)",
+      "async batch embed (AsyncIterable<Float32Array>)",
+      "EmbedRole param (document | query) accepted on embedSingle/embedBatch for interface compatibility — currently ignored (not yet applied) by the fastembed provider",
+      "loud-fail ResolutionError at factory time (never mid-call)",
+      "three-tier error taxonomy (Transient / Permanent / Resolution)"
+    ],
+    "invariants": [
+      "createEmbeddingProvider() THROWS ResolutionError synchronously or as a rejection if the config is invalid or the model/runtime cannot load — never silently downgrades",
+      "every provider advertises { modelId, dimensions, isRemote, isDeterministic, providerUri? } via metadata — callers never hardcode dims",
+      "embedBatch() returns AsyncIterable<Float32Array> — callers receive first result before last batch finishes (critical for sequential local inference)",
+      "warmUp() is a no-op when isDeterministic === false — currently ALWAYS true, since every shipped provider (fastembed, remote) hard-codes isDeterministic: false, so warmUp() is a no-op on every path today",
+      "TransientEmbeddingError → caller may retry; PermanentEmbeddingError → caller must not retry; ResolutionError → factory-time only, never thrown mid-call"
+    ],
+    "entrypoints": [
+      "dist/index.js"
+    ]
+  },
+  "module": "./index.js"
+}

package/dist/remote.d.ts

@@ -0,0 +1,23 @@
+import type { EmbeddingHealth, EmbeddingProvider, EmbeddingProviderMetadata, EmbedRole } from './index.js';
+/**
+ * Remote provider adapter — typed reference implementation.
+ *
+ * Implements EmbeddingProvider against the same async+batch-first contract.
+ * NOT wired to a live/paid endpoint — proves context-agnosticism without spend.
+ */
+export declare class RemoteProvider implements EmbeddingProvider {
+    readonly metadata: EmbeddingProviderMetadata;
+    private endpoint;
+    private apiKey;
+    constructor(modelId: string, dimensions: number, endpoint: string, apiKey?: string);
+    embedSingle(text: string, role?: EmbedRole): Promise<Float32Array>;
+    embedBatch(texts: string[], opts?: {
+        role?: EmbedRole;
+        batchSize?: number;
+    }): AsyncIterable<Float32Array>;
+    health(): EmbeddingHealth;
+    warmUp(_texts: string[]): Promise<void>;
+    private validateEndpoint;
+    private simulatedRemoteEmbed;
+}
+//# sourceMappingURL=remote.d.ts.map

package/dist/remote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote.d.ts","sourceRoot":"","sources":["../src/remote.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAG3G;;;;;GAKG;AACH,qBAAa,cAAe,YAAW,iBAAiB;IACtD,QAAQ,CAAC,QAAQ,EAAE,yBAAyB,CAAC;IAC7C,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAqB;gBAEvB,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;IAa5E,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,YAAY,CAAC;IAgBjE,UAAU,CACf,KAAK,EAAE,MAAM,EAAE,EACf,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,SAAS,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAC9C,aAAa,CAAC,YAAY,CAAC;IAqB9B,MAAM,IAAI,eAAe;IAUnB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C,OAAO,CAAC,gBAAgB;YAaV,oBAAoB;CAgBnC"}