npm - @mneme-ai/embeddings - Versions diffs - 0.21.1 → 0.22.1 - Mend

@mneme-ai/embeddings 0.21.1 → 0.22.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (9) hide show

package/dist/enrich.d.ts CHANGED Viewed

@@ -63,10 +63,112 @@ export declare class OpenAIEnricher implements EnricherProvider {
     enrich(input: EnrichInput): Promise<EnrichResult>;
 }
 export interface ResolveEnricherOptions {
-    provider?: "auto" | "ollama" | "openai";
+    provider?: "auto" | "ollama" | "openai" | "groq" | "together" | "openrouter";
     model?: string;
     apiKey?: string;
     baseUrl?: string;
 }
+/**
+ * Provider catalog — every entry uses an OpenAI-compatible /chat/completions
+ * endpoint, so they all share `OpenAIEnricher`. New providers = one row here.
+ *
+ * Ordered by free-tier-friendliness:
+ *   ollama (local, totally free)
+ *   groq         — generous free tier, fast (500 tok/s), signup required
+ *   together     — modest free tier
+ *   openrouter   — pay-per-token but exposes free models too
+ *   openai       — paid, premium quality
+ */
+export interface ProviderEntry {
+    id: "groq" | "together" | "openrouter" | "openai";
+    envKey: string;
+    baseUrl: string;
+    defaultModel: string;
+    /** Other free models the user can opt into (Qwen / Gemma / Llama family). */
+    freeModels: string[];
+    freeTier: boolean;
+    signupUrl: string;
+}
+declare const PROVIDERS: ProviderEntry[];
+/**
+ * Recommended local Ollama models for the chat path. Order: balance of
+ * size / quality / speed. User picks one in the setup wizard or just runs
+ * `ollama pull <name>` manually.
+ */
+export declare const OLLAMA_FREE_CHAT_MODELS: Array<{
+    name: string;
+    size: string;
+    note: string;
+}>;
 export declare function resolveEnricher(opts?: ResolveEnricherOptions): Promise<EnricherProvider>;
+/**
+ * Sentinel error for the "no LLM available" case. The CLI catches this
+ * specifically and switches `ask` to retrieval-only mode instead of
+ * showing a hard error.
+ */
+export declare class NoEnricherAvailableError extends Error {
+    constructor();
+}
+/** Catalog exposed for `mneme setup-free` and CLI hints. */
+export declare function listProviders(): typeof PROVIDERS;
+/**
+ * Classify a thrown error into a category that determines retry behavior.
+ * Used by ResilientEnricher to set per-provider cooldown durations: a 429
+ * (quota exhausted) merits a longer cooldown than a transient 503.
+ */
+export type FailureKind = "timeout" | "network" | "rate-limit" | "server" | "auth" | "model-missing" | "empty" | "unknown";
+export declare function classifyFailure(err: unknown): FailureKind;
+interface ProviderHealth {
+    lastFailure?: {
+        kind: FailureKind;
+        at: number;
+        reason: string;
+    };
+    lastSuccess?: number;
+    cooldownUntil?: number;
+}
+/**
+ * Self-healing enricher. Wraps an ordered list of providers and:
+ *
+ *   1. Tracks per-provider health state (lastSuccess / lastFailure / cooldownUntil)
+ *   2. Skips providers in cooldown — different durations per failure type
+ *   3. On call: tries providers in order, returns first success
+ *   4. On every failure: classifies + sets cooldown so the next call avoids
+ *      the bad provider without thrashing
+ *   5. Surfaces switches via onSwitch() so the CLI can show "Ollama timed
+ *      out (cooldown 30s), trying Groq..."
+ *
+ * The key UX win: a flaky cloud call NEVER kills `mneme ask`. The user
+ * always gets an answer (or a final extractive fallback) — Mneme silently
+ * adapts.
+ */
+export declare class ResilientEnricher implements EnricherProvider {
+    readonly name: string;
+    private readonly chain;
+    private readonly health;
+    private readonly onSwitch?;
+    constructor(chain: EnricherProvider[], onSwitch?: (event: {
+        from: string;
+        to: string;
+        reason: string;
+        kind: FailureKind;
+    }) => void);
+    /** Inspect health for testing / debugging. */
+    inspectHealth(): Record<string, ProviderHealth>;
+    enrich(input: EnrichInput): Promise<EnrichResult>;
+}
+export declare class AllProvidersFailedError extends Error {
+    constructor(msg: string);
+}
+/**
+ * Build the FULL ladder of enrichers available to this user, in
+ * preference order. Used by callers that want runtime fallback (e.g.
+ * `mneme ask`) — try Ollama first, fall back to Groq, fall back to
+ * OpenRouter, etc., on EVERY call rather than just at startup.
+ *
+ * Returns [] if the user has nothing configured. Caller decides what
+ * to do (typically: degrade to extractive answer).
+ */
+export declare function resolveAllEnrichers(opts?: ResolveEnricherOptions): Promise<EnricherProvider[]>;
+export {};
 //# sourceMappingURL=enrich.d.ts.map

package/dist/enrich.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"enrich.d.ts","sourceRoot":"","sources":["../src/enrich.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,WAAW;IAC1B,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,KAAK,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9D;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CACnD;AAID,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAOD,qBAAa,cAAe,YAAW,gBAAgB;IACrD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,IAAI,GAAE,qBAA0B;IAStC,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IA0CjD,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;CAQ/B;AAID,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAKD,qBAAa,cAAe,YAAW,gBAAgB;IACrD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,IAAI,EAAE,qBAAqB;IAQjC,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;CAwCxD;AAID,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;~~IACxC~~,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,eAAe,CACnC,IAAI,GAAE,sBAA2B,GAChC,OAAO,CAAC,gBAAgB,CAAC,~~CAgB3B~~"}
1	+ {"version":3,"file":"enrich.d.ts","sourceRoot":"","sources":["../src/enrich.ts"],"names":[],"mappings":"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"}

package/dist/enrich.js CHANGED Viewed

@@ -128,20 +128,310 @@ export class OpenAIEnricher {
         }
     }
 }
+const PROVIDERS = [
+    {
+        id: "groq",
+        envKey: "GROQ_API_KEY",
+        baseUrl: "https://api.groq.com/openai/v1",
+        defaultModel: "llama-3.3-70b-versatile",
+        freeModels: [
+            "llama-3.3-70b-versatile",
+            "qwen-qwq-32b",
+            "gemma2-9b-it",
+            "llama-3.1-8b-instant",
+        ],
+        freeTier: true,
+        signupUrl: "https://console.groq.com/keys",
+    },
+    {
+        id: "together",
+        envKey: "TOGETHER_API_KEY",
+        baseUrl: "https://api.together.xyz/v1",
+        defaultModel: "meta-llama/Llama-3.3-70B-Instruct-Turbo",
+        freeModels: [
+            "meta-llama/Llama-3.3-70B-Instruct-Turbo",
+            "Qwen/Qwen2.5-72B-Instruct-Turbo",
+            "google/gemma-2-9b-it",
+        ],
+        freeTier: true,
+        signupUrl: "https://api.together.xyz/settings/api-keys",
+    },
+    {
+        id: "openrouter",
+        envKey: "OPENROUTER_API_KEY",
+        baseUrl: "https://openrouter.ai/api/v1",
+        defaultModel: "meta-llama/llama-3.3-70b-instruct:free",
+        freeModels: [
+            "meta-llama/llama-3.3-70b-instruct:free",
+            "qwen/qwen-2.5-72b-instruct:free",
+            "google/gemma-2-9b-it:free",
+            "qwen/qwq-32b:free",
+        ],
+        freeTier: true,
+        signupUrl: "https://openrouter.ai/keys",
+    },
+    {
+        id: "openai",
+        envKey: "OPENAI_API_KEY",
+        baseUrl: "https://api.openai.com/v1",
+        defaultModel: "gpt-4o-mini",
+        freeModels: [], // no free models on OpenAI
+        freeTier: false,
+        signupUrl: "https://platform.openai.com/api-keys",
+    },
+];
+/**
+ * Recommended local Ollama models for the chat path. Order: balance of
+ * size / quality / speed. User picks one in the setup wizard or just runs
+ * `ollama pull <name>` manually.
+ */
+export const OLLAMA_FREE_CHAT_MODELS = [
+    { name: "qwen2.5:3b", size: "1.9GB", note: "best small/quality balance — recommended default" },
+    { name: "gemma2:2b", size: "1.6GB", note: "Google Gemma 2 — fastest tiny" },
+    { name: "llama3.2:1b", size: "1.3GB", note: "smallest, decent for short answers" },
+    { name: "qwen2.5:7b", size: "4.7GB", note: "much smarter — needs ~6GB free RAM" },
+    { name: "gemma2:9b", size: "5.4GB", note: "Gemma 2 mid — strong reasoning" },
+];
 export async function resolveEnricher(opts = {}) {
     const provider = opts.provider ?? "auto";
-    if (provider === "ollama" || provider === "auto") {
+    // Explicit picks
+    if (provider === "ollama") {
         const ollama = new OllamaEnricher({ model: opts.model, baseUrl: opts.baseUrl });
         if (await ollama.ping())
             return ollama;
-        if (provider === "ollama") {
-            throw new Error("Ollama not reachable. Start it: ollama serve");
+        throw new Error("Ollama not reachable at " +
+            (opts.baseUrl ?? "http://127.0.0.1:11434") +
+            ". Start it:  ollama serve\nThen pull a chat model:  ollama pull llama3.2:1b");
+    }
+    if (provider === "openai" || provider === "groq" || provider === "together" || provider === "openrouter") {
+        const cfg = PROVIDERS.find((p) => p.id === provider);
+        const key = opts.apiKey ?? process.env[cfg.envKey];
+        if (!key) {
+            throw new Error(`No ${provider} key found. Set ${cfg.envKey} or pass --api-key.\n` +
+                `Sign up (free tier): ${cfg.signupUrl}`);
+        }
+        return new OpenAIEnricher({
+            apiKey: key,
+            model: opts.model ?? cfg.defaultModel,
+            baseUrl: opts.baseUrl ?? cfg.baseUrl,
+        });
+    }
+    // auto: privacy-first ladder. Ollama local first (free + private), then any
+    // free-tier cloud provider whose key is in the env, then OpenAI as last resort.
+    const ollama = new OllamaEnricher({ model: opts.model, baseUrl: opts.baseUrl });
+    if (await ollama.ping())
+        return ollama;
+    // Try env-var providers in order
+    for (const cfg of PROVIDERS) {
+        const key = process.env[cfg.envKey];
+        if (key) {
+            return new OpenAIEnricher({
+                apiKey: key,
+                model: opts.model ?? cfg.defaultModel,
+                baseUrl: opts.baseUrl ?? cfg.baseUrl,
+            });
+        }
+    }
+    throw new NoEnricherAvailableError();
+}
+/**
+ * Sentinel error for the "no LLM available" case. The CLI catches this
+ * specifically and switches `ask` to retrieval-only mode instead of
+ * showing a hard error.
+ */
+export class NoEnricherAvailableError extends Error {
+    constructor() {
+        super("No LLM available — set up the free path:\n" +
+            "  Local + private (recommended):  ollama pull llama3.2:1b\n" +
+            "  Free cloud (fastest):           Get a free Groq key at https://console.groq.com/keys, then export GROQ_API_KEY=...\n" +
+            "  Or run 'mneme setup-free' for a guided 30-second setup.");
+        this.name = "NoEnricherAvailableError";
+    }
+}
+/** Catalog exposed for `mneme setup-free` and CLI hints. */
+export function listProviders() {
+    return PROVIDERS;
+}
+export function classifyFailure(err) {
+    const msg = err?.message ?? String(err);
+    if (/no\s+such\s+model|model.+(not\s+found|not\s+pulled)|404/i.test(msg))
+        return "model-missing";
+    if (/401|403|invalid.*key|unauthor|forbidden/i.test(msg))
+        return "auth";
+    if (/429|rate.?limit|quota|too\s+many/i.test(msg))
+        return "rate-limit";
+    if (/5\d\d|server\s+error|unavailable|bad\s+gateway/i.test(msg))
+        return "server";
+    if (/timeout|aborted|ETIMEDOUT/i.test(msg))
+        return "timeout";
+    if (/ECONNREFUSED|ENOTFOUND|EAI_AGAIN|fetch\s+failed|socket\s+hang/i.test(msg))
+        return "network";
+    return "unknown";
+}
+/** Cooldown in ms per failure kind. Tuned so a flaky provider self-heals
+ *  without thrashing, but a permanently-broken one is skipped for hours. */
+const COOLDOWN_MS = {
+    timeout: 30_000,
+    network: 30_000,
+    "rate-limit": 5 * 60_000,
+    server: 60_000,
+    auth: 60 * 60_000, // 1 hr — auth issues require user fix
+    "model-missing": 60 * 60_000,
+    empty: 5_000,
+    unknown: 30_000,
+};
+/**
+ * Self-healing enricher. Wraps an ordered list of providers and:
+ *
+ *   1. Tracks per-provider health state (lastSuccess / lastFailure / cooldownUntil)
+ *   2. Skips providers in cooldown — different durations per failure type
+ *   3. On call: tries providers in order, returns first success
+ *   4. On every failure: classifies + sets cooldown so the next call avoids
+ *      the bad provider without thrashing
+ *   5. Surfaces switches via onSwitch() so the CLI can show "Ollama timed
+ *      out (cooldown 30s), trying Groq..."
+ *
+ * The key UX win: a flaky cloud call NEVER kills `mneme ask`. The user
+ * always gets an answer (or a final extractive fallback) — Mneme silently
+ * adapts.
+ */
+export class ResilientEnricher {
+    name;
+    chain;
+    health = new Map();
+    onSwitch;
+    constructor(chain, onSwitch) {
+        if (chain.length === 0)
+            throw new Error("ResilientEnricher requires at least one provider");
+        this.chain = chain;
+        this.onSwitch = onSwitch;
+        this.name = `resilient:[${chain.map((p) => p.name).join(", ")}]`;
+    }
+    /** Inspect health for testing / debugging. */
+    inspectHealth() {
+        return Object.fromEntries(this.health);
+    }
+    async enrich(input) {
+        const now = Date.now();
+        const errors = [];
+        let lastTried = -1;
+        for (let i = 0; i < this.chain.length; i++) {
+            const p = this.chain[i];
+            const h = this.health.get(p.name) ?? {};
+            // Skip if in cooldown
+            if (h.cooldownUntil && h.cooldownUntil > now) {
+                errors.push({
+                    name: p.name,
+                    kind: h.lastFailure?.kind ?? "unknown",
+                    reason: `in cooldown for ${Math.ceil((h.cooldownUntil - now) / 1000)}s (${h.lastFailure?.reason ?? "?"})`,
+                });
+                continue;
+            }
+            // Notify CLI if we're switching
+            if (lastTried >= 0 && this.onSwitch) {
+                const prev = errors[errors.length - 1];
+                this.onSwitch({ from: this.chain[lastTried].name, to: p.name, reason: prev.reason, kind: prev.kind });
+            }
+            lastTried = i;
+            try {
+                const result = await p.enrich(input);
+                if (!result.text || result.text.trim().length === 0) {
+                    // Empty answer = soft failure → short cooldown, try next
+                    this.health.set(p.name, {
+                        ...h,
+                        lastFailure: { kind: "empty", at: now, reason: "empty answer" },
+                        cooldownUntil: now + COOLDOWN_MS.empty,
+                    });
+                    errors.push({ name: p.name, kind: "empty", reason: "empty answer" });
+                    continue;
+                }
+                // Success — clear cooldown, record timestamp
+                this.health.set(p.name, { ...h, lastSuccess: now, cooldownUntil: undefined });
+                return result;
+            }
+            catch (err) {
+                const kind = classifyFailure(err);
+                const msg = err.message ?? String(err);
+                this.health.set(p.name, {
+                    ...h,
+                    lastFailure: { kind, at: now, reason: msg.slice(0, 200) },
+                    cooldownUntil: now + COOLDOWN_MS[kind],
+                });
+                errors.push({ name: p.name, kind, reason: msg.slice(0, 120) });
+            }
+        }
+        // Every provider failed (or all in cooldown). Throw a descriptive error
+        // so the caller can fall back to extractive synthesis.
+        const summary = errors
+            .map((e) => `  • ${e.name} (${e.kind}): ${e.reason}`)
+            .join("\n");
+        throw new AllProvidersFailedError(`All ${this.chain.length} provider(s) failed or in cooldown:\n${summary}\n` +
+            `→ Run \`mneme setup-free\` if no providers are configured.`);
+    }
+}
+export class AllProvidersFailedError extends Error {
+    constructor(msg) {
+        super(msg);
+        this.name = "AllProvidersFailedError";
+    }
+}
+/**
+ * Build the FULL ladder of enrichers available to this user, in
+ * preference order. Used by callers that want runtime fallback (e.g.
+ * `mneme ask`) — try Ollama first, fall back to Groq, fall back to
+ * OpenRouter, etc., on EVERY call rather than just at startup.
+ *
+ * Returns [] if the user has nothing configured. Caller decides what
+ * to do (typically: degrade to extractive answer).
+ */
+export async function resolveAllEnrichers(opts = {}) {
+    const out = [];
+    // 1. Local Ollama — only add if reachable, AND auto-pick the first
+    //    available chat model so we don't pass a wrong/embedder name.
+    const ollama = new OllamaEnricher({ model: opts.model, baseUrl: opts.baseUrl });
+    if (await ollama.ping()) {
+        const chatModel = opts.model ?? (await pickOllamaChatModel(ollama));
+        if (chatModel) {
+            out.push(new OllamaEnricher({ model: chatModel, baseUrl: opts.baseUrl }));
+        }
+    }
+    // 2. Free-tier cloud providers (env-var detection)
+    for (const cfg of PROVIDERS) {
+        const key = process.env[cfg.envKey];
+        if (key) {
+            out.push(new OpenAIEnricher({
+                apiKey: key,
+                model: opts.model ?? cfg.defaultModel,
+                baseUrl: opts.baseUrl ?? cfg.baseUrl,
+            }));
+        }
+    }
+    return out;
+}
+/** Probe Ollama's installed models and pick the first viable chat model.
+ *  Skips embedders (nomic-embed-*, bge-*, e5-*, minilm-*). */
+async function pickOllamaChatModel(probe) {
+    try {
+        const res = await fetch(`${probe.baseUrl}/api/tags`, {
+            signal: AbortSignal.timeout(2000),
+        });
+        if (!res.ok)
+            return undefined;
+        const data = (await res.json());
+        const names = (data.models ?? []).map((m) => m.name);
+        // Filter out embedding-only models that would crash chat API
+        const chatModels = names.filter((n) => !/^(nomic-embed|bge-|e5-|all-minilm|paraphrase-|gte-|jina-)/i.test(n));
+        // Prefer modern small models in this order
+        const preferred = ["qwen2.5:3b", "gemma2:2b", "llama3.2:1b", "llama3.2:3b", "qwen2.5:7b"];
+        for (const want of preferred) {
+            const hit = chatModels.find((n) => n === want || n.startsWith(want.split(":")[0] + ":"));
+            if (hit)
+                return hit;
         }
+        return chatModels[0];
     }
-    const apiKey = opts.apiKey ?? process.env["OPENAI_API_KEY"];
-    if ((provider === "openai" || provider === "auto") && apiKey) {
-        return new OpenAIEnricher({ apiKey, model: opts.model, baseUrl: opts.baseUrl });
+    catch {
+        return undefined;
     }
-    throw new Error("No enricher available. Install Ollama (recommended) or set OPENAI_API_KEY.");
 }
 //# sourceMappingURL=enrich.js.map

package/dist/enrich.js.map CHANGED Viewed

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

package/dist/enrich.test.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ export {};
2	+ //# sourceMappingURL=enrich.test.d.ts.map

package/dist/enrich.test.d.ts.map ADDED Viewed

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

package/dist/enrich.test.js ADDED Viewed

@@ -0,0 +1,120 @@
+/**
+ * Tests for ResilientEnricher's self-healing fallback chain.
+ *
+ * Strategy: mock providers that throw classified errors and verify:
+ *   - chain order is honored
+ *   - successful provider returns immediately
+ *   - failures cool the provider down for the right duration
+ *   - subsequent calls skip cooled-down providers
+ *   - all-fail throws AllProvidersFailedError (so caller can degrade)
+ *   - empty answers count as soft failures + try the next provider
+ */
+import { describe, it, expect, vi } from "vitest";
+import { ResilientEnricher, AllProvidersFailedError, classifyFailure, } from "./enrich.js";
+function mockProvider(name, responses) {
+    let i = 0;
+    return {
+        name,
+        enrich: vi.fn().mockImplementation(async () => {
+            const r = responses[Math.min(i++, responses.length - 1)];
+            if (r instanceof Error)
+                throw r;
+            return { text: r, source: name };
+        }),
+    };
+}
+const INPUT = { system: "s", user: "u" };
+describe("classifyFailure — error category detection", () => {
+    it("recognizes rate-limit phrases as rate-limit (long cooldown)", () => {
+        expect(classifyFailure(new Error("HTTP 429: too many requests"))).toBe("rate-limit");
+        expect(classifyFailure(new Error("daily quota exhausted"))).toBe("rate-limit");
+    });
+    it("recognizes 5xx as server (medium cooldown)", () => {
+        expect(classifyFailure(new Error("503 service unavailable"))).toBe("server");
+        expect(classifyFailure(new Error("Internal server error"))).toBe("server");
+    });
+    it("recognizes auth failures (long cooldown — needs user fix)", () => {
+        expect(classifyFailure(new Error("401 invalid API key"))).toBe("auth");
+        expect(classifyFailure(new Error("Forbidden"))).toBe("auth");
+    });
+    it("recognizes model-missing (skip until next env change)", () => {
+        expect(classifyFailure(new Error("model not found"))).toBe("model-missing");
+        expect(classifyFailure(new Error("no such model: qwen2.5"))).toBe("model-missing");
+    });
+    it("recognizes timeout / network errors", () => {
+        expect(classifyFailure(new Error("aborted"))).toBe("timeout");
+        expect(classifyFailure(new Error("ECONNREFUSED"))).toBe("network");
+        expect(classifyFailure(new Error("fetch failed"))).toBe("network");
+    });
+});
+describe("ResilientEnricher — fallback chain behavior", () => {
+    it("returns immediately when first provider succeeds", async () => {
+        const a = mockProvider("a", ["A answer"]);
+        const b = mockProvider("b", ["B answer"]);
+        const r = new ResilientEnricher([a, b]);
+        const out = await r.enrich(INPUT);
+        expect(out.text).toBe("A answer");
+        expect(b.enrich).not.toHaveBeenCalled();
+    });
+    it("falls back to next provider on hard failure", async () => {
+        const a = mockProvider("a", [new Error("503 unavailable")]);
+        const b = mockProvider("b", ["B answer"]);
+        const r = new ResilientEnricher([a, b]);
+        const out = await r.enrich(INPUT);
+        expect(out.text).toBe("B answer");
+    });
+    it("treats empty answer as soft failure → tries next provider", async () => {
+        const a = mockProvider("a", ["   "]); // whitespace-only = empty
+        const b = mockProvider("b", ["B answer"]);
+        const r = new ResilientEnricher([a, b]);
+        const out = await r.enrich(INPUT);
+        expect(out.text).toBe("B answer");
+    });
+    it("throws AllProvidersFailedError when every provider fails", async () => {
+        const a = mockProvider("a", [new Error("503 unavailable")]);
+        const b = mockProvider("b", [new Error("ECONNREFUSED")]);
+        const r = new ResilientEnricher([a, b]);
+        await expect(r.enrich(INPUT)).rejects.toThrow(AllProvidersFailedError);
+    });
+    it("skips a provider while it's in cooldown (5xx → 60s default)", async () => {
+        // First call: a fails, b answers. a now in cooldown for 60s.
+        // Second call: a should be SKIPPED (still in cooldown), b answers again.
+        const a = mockProvider("a", [new Error("503"), "A would-recover"]);
+        const b = mockProvider("b", ["B1", "B2"]);
+        const r = new ResilientEnricher([a, b]);
+        const r1 = await r.enrich(INPUT);
+        expect(r1.text).toBe("B1");
+        expect(a.enrich).toHaveBeenCalledTimes(1);
+        const r2 = await r.enrich(INPUT);
+        expect(r2.text).toBe("B2");
+        // Critically, a should NOT have been retried — it's in cooldown
+        expect(a.enrich).toHaveBeenCalledTimes(1);
+    });
+    it("emits onSwitch event with reason when falling back", async () => {
+        const a = mockProvider("a", [new Error("aborted (timeout)")]);
+        const b = mockProvider("b", ["B answer"]);
+        const events = [];
+        const r = new ResilientEnricher([a, b], (ev) => events.push(ev));
+        await r.enrich(INPUT);
+        expect(events).toHaveLength(1);
+        expect(events[0].from).toBe("a");
+        expect(events[0].to).toBe("b");
+        expect(events[0].kind).toBe("timeout");
+    });
+    it("rate-limit failure cools down longer than server failure", async () => {
+        const aRate = mockProvider("aRate", [new Error("429 rate limit")]);
+        const aServer = mockProvider("aServer", [new Error("503")]);
+        const b = mockProvider("b", ["B"]);
+        const r1 = new ResilientEnricher([aRate, b]);
+        const r2 = new ResilientEnricher([aServer, b]);
+        await r1.enrich(INPUT);
+        await r2.enrich(INPUT);
+        const h1 = r1.inspectHealth().aRate?.cooldownUntil ?? 0;
+        const h2 = r2.inspectHealth().aServer?.cooldownUntil ?? 0;
+        expect(h1).toBeGreaterThan(h2); // rate-limit cooldown > server cooldown
+    });
+    it("constructor rejects empty chain (you must give SOMETHING)", () => {
+        expect(() => new ResilientEnricher([])).toThrow();
+    });
+});
+//# sourceMappingURL=enrich.test.js.map

package/dist/enrich.test.js.map ADDED Viewed

@@ -0,0 +1 @@

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

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@mneme-ai/embeddings",
-  "version": "0.21.1",
+  "version": "0.22.1",
   "description": "Embedding providers (OpenAI, Ollama, bundled-WASM, hash-fallback) for Mneme",
   "type": "module",
   "main": "./dist/index.js",
@@ -30,7 +30,7 @@
     "clean": "tsc -b --clean"
   },
   "dependencies": {
-    "@mneme-ai/core": "0.21.1",
+    "@mneme-ai/core": "0.22.1",
     "@xenova/transformers": "^2.17.2"
   }
 }