@astragenie/astramemory-local 0.7.2

package/dist/pipeline/mock-providers.js

@@ -0,0 +1,175 @@
+/**
+ * Mock providers for CI / integration testing.
+ *
+ * Used when ASTRA_MEMORY_MOCK_PROVIDERS=1 is set (or injected directly in tests).
+ *
+ * - MockLLMProvider: compaction returns the input text unchanged;
+ *   extraction checks a small deterministic keyword table (see below) and
+ *   returns one atom per matched keyword, or an empty atoms list if none match.
+ * - MockEmbedProvider: deterministic vector (dim defaults to
+ *   DEFAULT_EMBED_DIM = 1024, configurable) seeded from text hash. No
+ *   network, no Ollama required.
+ *
+ * These mocks satisfy the LLMProvider / EmbedProvider contracts and make
+ * the full 8-stage distillation pipeline runnable in CI.
+ *
+ * TEST-ONLY deterministic extraction vocabulary (SLICE-SMOKE-1 orchestrator
+ * decision, 2026-07-04: extending this file additively was approved as a
+ * relaxation of "no product-code changes" for test-double code specifically
+ * — see the smoke-suite run brief. Exclusively consumed by
+ * tests/smoke/_fixtures/session-canonical.json; fixture and this table must
+ * stay in lockstep, and this file is never reachable outside
+ * ASTRA_MEMORY_MOCK_PROVIDERS=1 (CI/test only — real serving never sets it).
+ * Each row is an independent case-insensitive substring match against the
+ * full extraction input; matching keywords each append one fixed atom (no
+ * parsing, no branching beyond the match itself):
+ *
+ *   trigger keyword              -> atom type -> entity emitted
+ *   ---------------------------------------------------------------------
+ *   "sqlite-vec" / "sqlite_vec"  -> decision   -> none (ORIGINAL, unchanged
+ *                                                 byte-for-byte since before
+ *                                                 SLICE-SMOKE-1)
+ *   "priya nair"                 -> fact       -> person: "Priya Nair"
+ *   "astramemory-local"          -> fact       -> repo: "astramemory-local"
+ *   "typescript"                 -> fact       -> tech: "TypeScript"
+ *   "todo:"                      -> todo       -> none
+ *   "prefers markdown summaries" -> note       -> none (closest valid
+ *                                                 MemoryType — the schema
+ *                                                 has no 'preference' type)
+ */
+import { createHash } from 'node:crypto';
+import { DEFAULT_EMBED_DIM } from '../contracts/embed.js';
+// ── Mock LLM ─────────────────────────────────────────────────────────────────
+class MockLLMProvider {
+    name = 'ollama';
+    model = 'mock-llm';
+    async chat(messages, opts) {
+        const userContent = messages.find(m => m.role === 'user')?.content ?? '';
+        // Detect extraction calls (json mode or system prompt contains "atoms")
+        const systemContent = messages.find(m => m.role === 'system')?.content ?? '';
+        const isExtraction = opts?.json === true || systemContent.includes('atoms');
+        if (isExtraction) {
+            // Return a valid ExtractionSchema JSON that the Zod validator will accept.
+            // See the file-header keyword table — each check below is independent
+            // and additive; the sqlite-vec case is byte-identical to the original.
+            const lower = userContent.toLowerCase();
+            const atoms = [];
+            // ORIGINAL — unchanged since before SLICE-SMOKE-1.
+            if (lower.includes('sqlite-vec') || lower.includes('sqlite_vec')) {
+                atoms.push({
+                    type: 'decision',
+                    text: 'use sqlite-vec for v1 vector storage',
+                    importance: 0.9,
+                    confidence: 0.9,
+                    evidence: 'OK let\'s go with sqlite-vec',
+                });
+            }
+            if (lower.includes('priya nair')) {
+                atoms.push({
+                    type: 'fact',
+                    text: 'Priya Nair is the designated reviewer for this work',
+                    importance: 0.5,
+                    confidence: 0.8,
+                    entities: [{ name: 'Priya Nair', kind: 'person' }],
+                });
+            }
+            if (lower.includes('astramemory-local')) {
+                atoms.push({
+                    type: 'fact',
+                    text: 'This work belongs to the astramemory-local repo',
+                    importance: 0.5,
+                    confidence: 0.8,
+                    entities: [{ name: 'astramemory-local', kind: 'repo' }],
+                });
+            }
+            if (lower.includes('typescript')) {
+                atoms.push({
+                    type: 'fact',
+                    text: 'This project is written in TypeScript',
+                    importance: 0.5,
+                    confidence: 0.8,
+                    entities: [{ name: 'TypeScript', kind: 'tech' }],
+                });
+            }
+            if (lower.includes('todo:')) {
+                atoms.push({
+                    type: 'todo',
+                    text: 'Write a migration guide before shipping',
+                    importance: 0.6,
+                    confidence: 0.8,
+                });
+            }
+            if (lower.includes('prefers markdown summaries')) {
+                atoms.push({
+                    type: 'note',
+                    text: 'Prefers markdown-formatted memory summaries',
+                    importance: 0.4,
+                    confidence: 0.7,
+                });
+            }
+            return {
+                text: JSON.stringify({ atoms }),
+                usage: { in: 10, out: 10, usd: 0 }
+            };
+        }
+        // Compaction: return user content unchanged (preserves all decisions for extraction)
+        return {
+            text: userContent,
+            usage: { in: 10, out: 10, usd: 0 }
+        };
+    }
+    async health() {
+        return { ok: true, model: this.model, latency_ms: 0 };
+    }
+}
+// ── Mock Embed ────────────────────────────────────────────────────────────────
+class MockEmbedProvider {
+    name = 'ollama';
+    model = 'mock-embed';
+    dim;
+    constructor(dim = DEFAULT_EMBED_DIM) {
+        this.dim = dim;
+    }
+    async embed(texts) {
+        return texts.map(t => makeDeterministicVec(t, this.dim));
+    }
+    async health() {
+        return { ok: true, model: this.model, dim: this.dim };
+    }
+}
+/**
+ * Deterministic vector seeded by text content hash, dim defaults to
+ * DEFAULT_EMBED_DIM (1024) — pass `dim` for a non-default schema (FEAT-409
+ * AC-2). Matches the approach used in search.ts makeFakeVec but uses
+ * SHA-256 for better distribution across similar texts.
+ */
+function makeDeterministicVec(text, dim = DEFAULT_EMBED_DIM) {
+    const hash = createHash('sha256').update(text, 'utf8').digest();
+    const v = new Float32Array(dim);
+    // Seed each float from hash bytes cycling
+    for (let i = 0; i < dim; i++) {
+        const b0 = hash[i % 32] ?? 0;
+        const b1 = hash[(i + 1) % 32] ?? 0;
+        // Normalize to [-1, 1]
+        v[i] = ((b0 * 256 + b1) / 32767.5) - 1.0;
+    }
+    return v;
+}
+/**
+ * Returns a ProviderSet backed entirely by mock providers.
+ * Safe to call multiple times — each call returns fresh instances.
+ * `dim` defaults to DEFAULT_EMBED_DIM (1024); pass e.g. cfg.embedding.dim
+ * to exercise a non-default dim under ASTRA_MEMORY_MOCK_PROVIDERS=1
+ * (FEAT-409 AC-2).
+ */
+export function makeMockProviders(dim = DEFAULT_EMBED_DIM) {
+    const llm = new MockLLMProvider();
+    return {
+        llm: {
+            compaction: llm,
+            extraction: llm,
+        },
+        embed: new MockEmbedProvider(dim),
+    };
+}
+//# sourceMappingURL=mock-providers.js.map

package/dist/pipeline/mock-providers.js.map

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

package/dist/pipeline/registry.d.ts

@@ -0,0 +1,15 @@
+import type { JobKind } from '../contracts/index.js';
+import type { JobHandler } from './handler.js';
+/**
+ * Registry of job handlers keyed by JobKind.
+ * register() is idempotent — re-registering the same kind overwrites.
+ */
+export declare class HandlerRegistry {
+    private readonly map;
+    /** Register a handler for its declared kind. */
+    register(handler: JobHandler): void;
+    /** Look up a handler by kind. Returns undefined if none registered. */
+    get(kind: JobKind): JobHandler | undefined;
+    /** All registered kinds (for diagnostics). */
+    registeredKinds(): JobKind[];
+}

package/dist/pipeline/registry.js

@@ -0,0 +1,20 @@
+/**
+ * Registry of job handlers keyed by JobKind.
+ * register() is idempotent — re-registering the same kind overwrites.
+ */
+export class HandlerRegistry {
+    map = new Map();
+    /** Register a handler for its declared kind. */
+    register(handler) {
+        this.map.set(handler.kind, handler);
+    }
+    /** Look up a handler by kind. Returns undefined if none registered. */
+    get(kind) {
+        return this.map.get(kind);
+    }
+    /** All registered kinds (for diagnostics). */
+    registeredKinds() {
+        return [...this.map.keys()];
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/pipeline/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/pipeline/registry.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,OAAO,eAAe;IACT,GAAG,GAAG,IAAI,GAAG,EAAuB,CAAC;IAEtD,gDAAgD;IAChD,QAAQ,CAAC,OAAmB;QAC1B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,uEAAuE;IACvE,GAAG,CAAC,IAAa;QACf,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED,8CAA8C;IAC9C,eAAe;QACb,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IAC9B,CAAC;CACF"}

package/dist/pipeline/worker.d.ts

@@ -0,0 +1,41 @@
+import type { DB } from '../storage/db.js';
+import type { Config } from '../config/config.js';
+import type { HandlerCtx } from './handler.js';
+import type { HandlerRegistry } from './registry.js';
+export interface WorkerOpts {
+    pollMs: number;
+    registry: HandlerRegistry;
+    db: DB;
+    config: Config;
+    /** Optional pre-built HandlerCtx (or ExtendedHandlerCtx) to pass to handlers.
+     *  When omitted, a minimal {db, config} context is constructed. */
+    ctx?: HandlerCtx;
+    /** Optional liveness sink — the worker stamps lastTickAt each tick so
+     *  /health can report worker.alive. */
+    healthState?: {
+        worker: {
+            lastTickAt: number | null;
+        };
+    };
+}
+export interface WorkerHandle {
+    /**
+     * Stop the worker. Resolves AFTER the currently in-flight tick completes
+     * (if any). Callers MUST await this before closing the DB — otherwise
+     * better-sqlite3 may throw SQLITE_MISUSE if a handler is still writing.
+     */
+    stop(): Promise<void>;
+}
+/**
+ * Start the worker poll loop in-process.
+ *
+ * Each tick:
+ *   1. Claim the oldest pending job (atomic state transition pending→running).
+ *   2. Dispatch to the registered handler.
+ *   3. On success → complete.
+ *   4. On throw → fail + attempts++. If attempts >= MAX_ATTEMPTS → poison.
+ *   5. Repeat immediately if a job was found; otherwise sleep pollMs.
+ *
+ * Returns a handle with stop() that terminates the loop after the current tick.
+ */
+export declare function startWorker(opts: WorkerOpts): WorkerHandle;

package/dist/pipeline/worker.js

@@ -0,0 +1,167 @@
+import { JobRepo } from './job-repo.js';
+import { DistillBudgetPausedError } from './handlers/distill.js';
+import { classifyError } from './failure-classifier.js';
+import { logger, childLogger } from '../log/logger.js';
+const MAX_ATTEMPTS = 3;
+/**
+ * Start the worker poll loop in-process.
+ *
+ * Each tick:
+ *   1. Claim the oldest pending job (atomic state transition pending→running).
+ *   2. Dispatch to the registered handler.
+ *   3. On success → complete.
+ *   4. On throw → fail + attempts++. If attempts >= MAX_ATTEMPTS → poison.
+ *   5. Repeat immediately if a job was found; otherwise sleep pollMs.
+ *
+ * Returns a handle with stop() that terminates the loop after the current tick.
+ */
+export function startWorker(opts) {
+    const { pollMs, registry, db, config } = opts;
+    const repo = new JobRepo(db);
+    const ctx = opts.ctx ?? { db, config };
+    let stopped = false;
+    let timer = null;
+    let inFlight = null;
+    async function tick() {
+        if (stopped)
+            return;
+        if (opts.healthState)
+            opts.healthState.worker.lastTickAt = Date.now();
+        const job = repo.claimPending();
+        if (!job) {
+            // Nothing to do — schedule next poll
+            if (!stopped) {
+                timer = setTimeout(() => { launchTick(); }, pollMs);
+            }
+            return;
+        }
+        // Build a per-job child logger; binds job_id + job_kind + attempt on every log line
+        const jobLog = childLogger({ job_id: job.id, job_kind: job.kind, attempt: job.attempts + 1 });
+        jobLog.info('job claimed');
+        const handler = registry.get(job.kind);
+        if (!handler) {
+            // No handler registered — treat as a permanent failure
+            const errMsg = `No handler registered for job kind '${job.kind}'`;
+            repo.fail(job.id, errMsg);
+            const updated = repo.get(job.id);
+            if (updated) {
+                if (updated.attempts >= MAX_ATTEMPTS) {
+                    repo.markPoison(job.id);
+                    jobLog.warn({ error_message: errMsg, error_kind: 'NoHandler' }, 'job poisoned — no handler');
+                }
+                else {
+                    repo.requeueForRetry(job.id);
+                    jobLog.warn({ error_message: errMsg, error_kind: 'NoHandler' }, 'job requeued — no handler');
+                }
+            }
+            scheduleNext();
+            return;
+        }
+        let payload;
+        try {
+            payload = JSON.parse(job.payload_json);
+        }
+        catch (e) {
+            const errMsg = `Failed to parse payload_json: ${String(e)}`;
+            repo.fail(job.id, errMsg);
+            const updated = repo.get(job.id);
+            if (updated) {
+                if (updated.attempts >= MAX_ATTEMPTS) {
+                    repo.markPoison(job.id);
+                    jobLog.warn({ error_message: errMsg, error_kind: 'PayloadParseError' }, 'job poisoned — bad payload');
+                }
+                else {
+                    repo.requeueForRetry(job.id);
+                    jobLog.warn({ error_message: errMsg, error_kind: 'PayloadParseError' }, 'job requeued — bad payload');
+                }
+            }
+            scheduleNext();
+            return;
+        }
+        try {
+            await handler.handle(payload, ctx);
+            repo.complete(job.id);
+            jobLog.info('job completed');
+        }
+        catch (err) {
+            // Budget exceeded → pause the job (not a failure, not retried).
+            // Do NOT call fail() — that would increment attempts and eventually
+            // poison the job after repeated daily cap hits, preventing recovery
+            // when the user runs `astra-memory budget --reset`.
+            if (DistillBudgetPausedError.is(err)) {
+                const errMsg = err instanceof Error ? err.message : String(err);
+                repo.setLastError(job.id, errMsg);
+                repo.pause(job.id);
+                jobLog.warn({ error_message: errMsg, error_kind: 'BudgetPaused' }, 'job paused — budget exceeded');
+                scheduleNext();
+                return;
+            }
+            const kind = classifyError(err);
+            const errMsg = err instanceof Error ? err.message : String(err);
+            if (kind === 'deterministic') {
+                // Schema / parse failures will not self-heal with another LLM call.
+                // Poison immediately to avoid burning budget on retries.
+                repo.fail(job.id, errMsg);
+                repo.markPoison(job.id);
+                jobLog.warn({ error_message: errMsg.slice(0, 200), error_kind: 'DeterministicFailure' }, 'job poisoned — deterministic failure');
+            }
+            else {
+                // Transient failure — retry with exponential backoff up to MAX_ATTEMPTS.
+                repo.fail(job.id, errMsg);
+                const updated = repo.get(job.id);
+                if (updated && updated.attempts >= MAX_ATTEMPTS) {
+                    repo.markPoison(job.id);
+                    jobLog.warn({ error_message: errMsg.slice(0, 200), error_kind: 'TransientFailure', attempts: updated.attempts }, 'job poisoned — retries exhausted');
+                }
+                else {
+                    // Exponential backoff: 1s, 2s, 4s, … capped at 60s
+                    const attemptsSoFar = updated?.attempts ?? 1;
+                    const delay = Math.min(1000 * Math.pow(2, attemptsSoFar - 1), 60_000);
+                    jobLog.info({ error_message: errMsg.slice(0, 200), delay_ms: delay }, 'job requeued for retry');
+                    setTimeout(() => { repo.requeueForRetry(job.id); }, delay);
+                }
+            }
+        }
+        scheduleNext();
+    }
+    function scheduleNext() {
+        if (!stopped) {
+            timer = setTimeout(() => { launchTick(); }, 0);
+        }
+    }
+    function onUncaught(err) {
+        // Worker must not crash the process — log and keep polling
+        const errMsg = err instanceof Error ? err.message : String(err);
+        logger.error({ error_message: errMsg.slice(0, 200), error_kind: err instanceof Error ? err.name : 'Unknown' }, '[worker] uncaught error in tick');
+        if (!stopped) {
+            timer = setTimeout(() => { launchTick(); }, pollMs);
+        }
+    }
+    /**
+     * Wraps tick() so the resulting promise is tracked in `inFlight`.
+     * stop() awaits this promise to ensure no handler is mid-DB-write when
+     * the caller subsequently closes the database.
+     */
+    function launchTick() {
+        inFlight = tick().catch(onUncaught).finally(() => { inFlight = null; });
+    }
+    // Kick off the first tick
+    timer = setTimeout(() => { launchTick(); }, 0);
+    return {
+        async stop() {
+            stopped = true;
+            if (timer !== null) {
+                clearTimeout(timer);
+                timer = null;
+            }
+            // Drain any in-flight tick before returning — handler may be mid-write.
+            if (inFlight) {
+                try {
+                    await inFlight;
+                }
+                catch { /* already logged via onUncaught */ }
+            }
+        }
+    };
+}
+//# sourceMappingURL=worker.js.map

package/dist/pipeline/worker.js.map

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

package/dist/providers/embed/azure-openai.d.ts

@@ -0,0 +1,25 @@
+import type { EmbedHealth, EmbedProvider } from '../../contracts/embed.js';
+export interface AzureOpenAIEmbedConfig {
+    endpoint: string;
+    deployment: string;
+    apiKey: string;
+    apiVersion?: string;
+    model?: string;
+    /** FEAT-409: expected/requested output dim — defaults to
+     * DEFAULT_EMBED_DIM (1024). Set from config.embedding.dim by
+     * providers/index.ts. Sent as the Azure `dimensions` request param. */
+    dim?: number;
+}
+export declare class AzureOpenAIEmbedProvider implements EmbedProvider {
+    readonly name: "azure-openai";
+    readonly model: string;
+    readonly dim: number;
+    private readonly endpoint;
+    private readonly deployment;
+    private readonly apiKey;
+    private readonly apiVersion;
+    constructor(config: AzureOpenAIEmbedConfig);
+    private get embedUrl();
+    embed(texts: string[]): Promise<Float32Array[]>;
+    health(): Promise<EmbedHealth>;
+}

package/dist/providers/embed/azure-openai.js

@@ -0,0 +1,138 @@
+import { DEFAULT_EMBED_DIM } from '../../contracts/embed.js';
+import { TransientError, DeterministicError } from '../../pipeline/errors.js';
+const EMBED_TIMEOUT_MS = 15_000;
+const HEALTH_TIMEOUT_MS = 15_000;
+const DEFAULT_MODEL = 'text-embedding-3-small';
+async function fetchWithRetry(url, init, timeoutMs) {
+    let lastError;
+    for (let i = 0; i < 2; i++) {
+        try {
+            const res = await fetch(url, { ...init, signal: AbortSignal.timeout(timeoutMs) });
+            if (res.status >= 400 && res.status < 500)
+                return res;
+            if (res.status >= 500 && i === 0) {
+                lastError = new Error(`HTTP ${res.status} from Azure embed`);
+                continue;
+            }
+            return res;
+        }
+        catch (err) {
+            if (i === 0) {
+                lastError = err;
+                continue;
+            }
+            throw err;
+        }
+    }
+    throw lastError;
+}
+export class AzureOpenAIEmbedProvider {
+    name = 'azure-openai';
+    model;
+    dim;
+    endpoint;
+    deployment;
+    apiKey;
+    apiVersion;
+    constructor(config) {
+        this.endpoint = config.endpoint.replace(/\/$/, '');
+        this.deployment = config.deployment;
+        this.apiKey = config.apiKey;
+        this.apiVersion = config.apiVersion ?? '2024-10-21';
+        this.model = config.model ?? DEFAULT_MODEL;
+        this.dim = config.dim ?? DEFAULT_EMBED_DIM;
+    }
+    get embedUrl() {
+        return `${this.endpoint}/openai/deployments/${this.deployment}/embeddings?api-version=${this.apiVersion}`;
+    }
+    async embed(texts) {
+        const body = {
+            input: texts,
+            dimensions: this.dim,
+        };
+        const res = await fetchWithRetry(this.embedUrl, {
+            method: 'POST',
+            headers: {
+                'content-type': 'application/json',
+                'api-key': this.apiKey,
+            },
+            body: JSON.stringify(body),
+        }, EMBED_TIMEOUT_MS);
+        if (!res.ok) {
+            const raw = await res.text().catch(() => '');
+            let detail = raw;
+            try {
+                const parsed = JSON.parse(raw);
+                detail = parsed.error?.message ?? raw;
+            }
+            catch {
+                // leave as raw text
+            }
+            const snippet = detail.slice(0, 200);
+            if (res.status >= 500) {
+                throw new TransientError(`Azure OpenAI embed failed: HTTP ${res.status} — ${snippet}`);
+            }
+            if (res.status === 429) {
+                throw new TransientError(`Azure OpenAI embed rate-limited (429): ${snippet}`);
+            }
+            throw new DeterministicError(`Azure OpenAI embed failed: HTTP ${res.status} — ${snippet}`);
+        }
+        const data = (await res.json());
+        if (!data.data || data.data.length === 0) {
+            throw new Error(`Azure embed response missing 'data' array`);
+        }
+        // Sort by index to preserve input order
+        const sorted = [...data.data].sort((a, b) => (a.index ?? 0) - (b.index ?? 0));
+        const results = [];
+        for (const item of sorted) {
+            const embedding = item.embedding;
+            if (!embedding) {
+                throw new Error(`Azure embed response item missing 'embedding' field`);
+            }
+            if (embedding.length !== this.dim) {
+                throw new Error(`Azure embed dimension mismatch: expected ${this.dim}, got ${embedding.length}. ` +
+                    `Model: ${this.model}. Check that 'dimensions: ${this.dim}' is supported.`);
+            }
+            results.push(new Float32Array(embedding));
+        }
+        if (results.length !== texts.length) {
+            throw new Error(`Azure embed count mismatch: sent ${texts.length} texts, got ${results.length} embeddings`);
+        }
+        return results;
+    }
+    async health() {
+        // Ping with a 1-item embed request
+        const body = {
+            input: ['ping'],
+            dimensions: this.dim,
+        };
+        try {
+            const t0 = Date.now();
+            const res = await fetch(this.embedUrl, {
+                method: 'POST',
+                headers: {
+                    'content-type': 'application/json',
+                    'api-key': this.apiKey,
+                },
+                body: JSON.stringify(body),
+                signal: AbortSignal.timeout(HEALTH_TIMEOUT_MS),
+            });
+            void (Date.now() - t0); // latency not part of EmbedHealth interface
+            return {
+                ok: res.ok,
+                model: this.model,
+                dim: this.dim,
+                ...(res.ok ? {} : { error: `HTTP ${res.status}` }),
+            };
+        }
+        catch (err) {
+            return {
+                ok: false,
+                model: this.model,
+                dim: this.dim,
+                error: err instanceof Error ? err.message : String(err),
+            };
+        }
+    }
+}
+//# sourceMappingURL=azure-openai.js.map

package/dist/providers/embed/azure-openai.js.map

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

package/dist/providers/embed/ollama.d.ts

@@ -0,0 +1,17 @@
+import type { EmbedHealth, EmbedProvider } from '../../contracts/embed.js';
+export interface OllamaEmbedConfig {
+    baseUrl?: string;
+    model?: string;
+    /** FEAT-409: expected output dim — defaults to DEFAULT_EMBED_DIM (1024).
+     * Set from config.embedding.dim by providers/index.ts. */
+    dim?: number;
+}
+export declare class OllamaEmbedProvider implements EmbedProvider {
+    readonly name: "ollama";
+    readonly model: string;
+    readonly dim: number;
+    private readonly baseUrl;
+    constructor(config?: OllamaEmbedConfig);
+    embed(texts: string[]): Promise<Float32Array[]>;
+    health(): Promise<EmbedHealth>;
+}