nodedex 0.1.0

package/dist/engine/embeddings.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Canonical text for a STORED block's embedding vector (Tier 2 cleanup, 2026-06-15).
+ *
+ * ONE recipe so every stored vector is built the same way. Vectors compared
+ * stored-vs-stored (semantic dedup, Stage-D resolve, Pass-4 semantic-delta) MUST
+ * share a recipe or the cosine is noise — before this, ~5 call sites embedded the
+ * same population of blocks with different recipes (essence+concepts vs
+ * label+essence+concepts vs label+essence+type+unique vs a neighbor-context header).
+ *
+ * Recipe = essence + concepts — pure semantic CONTENT. The essence carries the
+ * meaning, concepts the named entities. Deliberately EXCLUDES:
+ *   - label  — a slug whose project prefix repeats across the project → would cluster
+ *              by project, not meaning.
+ *   - type   — a category word → would cluster by category, not content.
+ *   - unique{} — identity is confirmed DOWNSTREAM by the structured unique{} compare;
+ *              the embedding is the recall net, not the identity key.
+ * `concepts` is read from the first-class blocks.concepts column (authoritative since
+ * the 2026 migration out of content JSON), tolerating both the array form (pre-save
+ * pass output) and the JSON-string form (a stored block).
+ *
+ * Query embeds (user message, search query, in-pass dedup) stay free-form — vs a
+ * query, heterogeneity is inherent to semantic search. This canonicalizes the STORED
+ * side only.
+ */
+export declare function blockEmbeddingText(input: {
+    essence?: string | null;
+    concepts?: string[] | string | null;
+}): string;
+export declare class EmbeddingEngine {
+    private provider;
+    constructor();
+    isAvailable(): boolean;
+    /**
+     * Embed a single text. Instrumented per debt-4 Stage A:
+     *   - records wall-time + call count + input chars to embeddingStats
+     *     so the turn-log can surface the previously-hidden embedding tax
+     *   - bounds wall-time with EMBEDDING_TIMEOUT_MS so provider hangs
+     *     don't stall the pipeline
+     *
+     * On timeout: returns null (matches existing error semantics — most call
+     * sites already do .catch(() => null) since embeddings are non-critical).
+     */
+    embed(text: string): Promise<number[] | null>;
+    /** Embed a STORED block through the canonical recipe (essence + concepts).
+     *  `concepts` accepts the first-class column's JSON-string form or an array. */
+    embedForBlock(block: {
+        essence: string;
+        concepts?: string[] | string | null;
+    }): Promise<number[] | null>;
+}
+//# sourceMappingURL=embeddings.d.ts.map

package/dist/engine/embeddings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings.d.ts","sourceRoot":"","sources":["../../src/engine/embeddings.ts"],"names":[],"mappings":"AAaA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IACxC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAAC;CACrC,GAAG,MAAM,CAQT;AAGD,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAoB;;IAMpC,WAAW,IAAI,OAAO;IAItB;;;;;;;;;OASG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC;IAanD;oFACgF;IAC1E,aAAa,CAAC,KAAK,EAAE;QACzB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAAC;KACrC,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC;CAG7B"}

package/dist/engine/embeddings.js

@@ -0,0 +1,89 @@
+import { getEmbeddingProvider } from "./providers/index.js";
+import { withTimeout } from "./providers/failure-policy.js";
+import { embeddingStats } from "../middleware/reflect/context.js";
+// debt-4 Stage A — bound embedding calls so a hung provider can't stall the
+// pipeline indefinitely. 30s is generous (typical embed call 100-500ms);
+// caps the worst case without rejecting healthy calls. Promise.race based —
+// the underlying request continues in background on timeout but the pipeline
+// unblocks. A future SDK-level AbortController would also CANCEL the request,
+// but Promise.race is enough for the bounded-time goal here.
+const EMBEDDING_TIMEOUT_MS = 30_000;
+/**
+ * Canonical text for a STORED block's embedding vector (Tier 2 cleanup, 2026-06-15).
+ *
+ * ONE recipe so every stored vector is built the same way. Vectors compared
+ * stored-vs-stored (semantic dedup, Stage-D resolve, Pass-4 semantic-delta) MUST
+ * share a recipe or the cosine is noise — before this, ~5 call sites embedded the
+ * same population of blocks with different recipes (essence+concepts vs
+ * label+essence+concepts vs label+essence+type+unique vs a neighbor-context header).
+ *
+ * Recipe = essence + concepts — pure semantic CONTENT. The essence carries the
+ * meaning, concepts the named entities. Deliberately EXCLUDES:
+ *   - label  — a slug whose project prefix repeats across the project → would cluster
+ *              by project, not meaning.
+ *   - type   — a category word → would cluster by category, not content.
+ *   - unique{} — identity is confirmed DOWNSTREAM by the structured unique{} compare;
+ *              the embedding is the recall net, not the identity key.
+ * `concepts` is read from the first-class blocks.concepts column (authoritative since
+ * the 2026 migration out of content JSON), tolerating both the array form (pre-save
+ * pass output) and the JSON-string form (a stored block).
+ *
+ * Query embeds (user message, search query, in-pass dedup) stay free-form — vs a
+ * query, heterogeneity is inherent to semantic search. This canonicalizes the STORED
+ * side only.
+ */
+export function blockEmbeddingText(input) {
+    let concepts = [];
+    if (Array.isArray(input.concepts)) {
+        concepts = input.concepts;
+    }
+    else if (typeof input.concepts === "string") {
+        try {
+            concepts = JSON.parse(input.concepts || "[]");
+        }
+        catch {
+            concepts = [];
+        }
+    }
+    return [input.essence, ...concepts].filter(Boolean).join(" ");
+}
+// ─── Embedding Engine ─────────────────────────────────────────────────────────
+export class EmbeddingEngine {
+    provider;
+    constructor() {
+        this.provider = getEmbeddingProvider();
+    }
+    isAvailable() {
+        return this.provider.isAvailable();
+    }
+    /**
+     * Embed a single text. Instrumented per debt-4 Stage A:
+     *   - records wall-time + call count + input chars to embeddingStats
+     *     so the turn-log can surface the previously-hidden embedding tax
+     *   - bounds wall-time with EMBEDDING_TIMEOUT_MS so provider hangs
+     *     don't stall the pipeline
+     *
+     * On timeout: returns null (matches existing error semantics — most call
+     * sites already do .catch(() => null) since embeddings are non-critical).
+     */
+    async embed(text) {
+        const t0 = Date.now();
+        embeddingStats.calls++;
+        embeddingStats.input_chars += (text ?? "").length;
+        try {
+            return await withTimeout(this.provider.embed(text), EMBEDDING_TIMEOUT_MS, "embed");
+        }
+        catch {
+            return null;
+        }
+        finally {
+            embeddingStats.ms_total += Date.now() - t0;
+        }
+    }
+    /** Embed a STORED block through the canonical recipe (essence + concepts).
+     *  `concepts` accepts the first-class column's JSON-string form or an array. */
+    async embedForBlock(block) {
+        return this.embed(blockEmbeddingText({ essence: block.essence, concepts: block.concepts }));
+    }
+}
+//# sourceMappingURL=embeddings.js.map

package/dist/engine/embeddings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings.js","sourceRoot":"","sources":["../../src/engine/embeddings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAE5D,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAElE,4EAA4E;AAC5E,yEAAyE;AACzE,4EAA4E;AAC5E,6EAA6E;AAC7E,8EAA8E;AAC9E,6DAA6D;AAC7D,MAAM,oBAAoB,GAAG,MAAM,CAAC;AAEpC;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAGlC;IACC,IAAI,QAAQ,GAAa,EAAE,CAAC;IAC5B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QAClC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;IAC5B,CAAC;SAAM,IAAI,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC9C,IAAI,CAAC;YAAC,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,IAAI,IAAI,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,QAAQ,GAAG,EAAE,CAAC;QAAC,CAAC;IACjF,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAChE,CAAC;AAED,iFAAiF;AACjF,MAAM,OAAO,eAAe;IAClB,QAAQ,CAAoB;IAEpC;QACE,IAAI,CAAC,QAAQ,GAAG,oBAAoB,EAAE,CAAC;IACzC,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;IACrC,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,KAAK,CAAC,IAAY;QACtB,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACtB,cAAc,CAAC,KAAK,EAAE,CAAC;QACvB,cAAc,CAAC,WAAW,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;QAClD,IAAI,CAAC;YACH,OAAO,MAAM,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,oBAAoB,EAAE,OAAO,CAAC,CAAC;QACrF,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;gBAAS,CAAC;YACT,cAAc,CAAC,QAAQ,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC;QAC7C,CAAC;IACH,CAAC;IAED;oFACgF;IAChF,KAAK,CAAC,aAAa,CAAC,KAGnB;QACC,OAAO,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IAC9F,CAAC;CACF"}

package/dist/engine/providers/__tests__/failure-policy.test.d.ts

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

package/dist/engine/providers/__tests__/failure-policy.test.d.ts.map

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

package/dist/engine/providers/__tests__/failure-policy.test.js

@@ -0,0 +1,134 @@
+// Unit tests for the shared provider failure-policy (classification, empty-detection,
+// timeout). This is the provider-agnostic policy all three providers consume so the
+// retry behavior is identical on every real-world provider path.
+import { test, describe, afterEach } from "node:test";
+import assert from "node:assert/strict";
+import { EmptyResponseError, classifyGenError, isEmptyResult, withTimeout, llmTimeoutMs, decideEmptyOrTimeoutAction, isInsufficientCreditError, } from "../failure-policy.js";
+describe("classifyGenError (provider-agnostic failure routing)", () => {
+    test("EmptyResponseError → empty (wins over the SyntaxError an empty body would throw)", () => {
+        assert.equal(classifyGenError(new EmptyResponseError("any/model")), "empty");
+    });
+    test("429 / 503 / 529 / quota / RESOURCE_EXHAUSTED → rate_limited", () => {
+        assert.equal(classifyGenError({ status: 429 }), "rate_limited");
+        assert.equal(classifyGenError({ status: 503 }), "rate_limited");
+        assert.equal(classifyGenError({ status: 529 }), "rate_limited"); // Anthropic overloaded
+        assert.equal(classifyGenError(new Error("RESOURCE_EXHAUSTED: quota")), "rate_limited");
+        assert.equal(classifyGenError(new Error("model is experiencing high demand")), "rate_limited");
+    });
+    test("APIConnectionTimeoutError / withTimeout message → timeout", () => {
+        const e = new Error("Request timed out.");
+        e.name = "APIConnectionTimeoutError";
+        assert.equal(classifyGenError(e), "timeout");
+        assert.equal(classifyGenError(new Error("generateStructured(x) timeout after 180000ms")), "timeout");
+    });
+    test("SyntaxError on a non-empty body → truncated (the determinism-trap case)", () => {
+        let parseErr;
+        try {
+            JSON.parse('{"a":1');
+        }
+        catch (pe) {
+            parseErr = pe;
+        }
+        assert.equal(classifyGenError(parseErr), "truncated");
+        assert.equal(classifyGenError(new Error("Unterminated string in JSON")), "truncated");
+    });
+    test("a 400/other provider error → mechanism_or_other (prompt-JSON floor / degrade)", () => {
+        assert.equal(classifyGenError({ status: 400, message: "Bad Request" }), "mechanism_or_other");
+        assert.equal(classifyGenError(new Error("something unexpected")), "mechanism_or_other");
+    });
+});
+describe("isInsufficientCreditError (out-of-credit, distinct from rate-limit)", () => {
+    test("HTTP 402 (status or code, number or string) → true", () => {
+        assert.equal(isInsufficientCreditError({ status: 402 }), true);
+        assert.equal(isInsufficientCreditError({ code: 402 }), true);
+        assert.equal(isInsufficientCreditError({ status: "402" }), true);
+    });
+    test("OpenRouter / OpenAI billing message bodies → true", () => {
+        assert.equal(isInsufficientCreditError(new Error("402 Insufficient credits. Add more to continue.")), true);
+        assert.equal(isInsufficientCreditError(new Error("Payment Required")), true);
+        assert.equal(isInsufficientCreditError(new Error("You exceeded your current quota — insufficient_quota")), true);
+        assert.equal(isInsufficientCreditError("insufficient_credit"), true); // the swallowed-null reason string
+        assert.equal(isInsufficientCreditError(new Error("negative credit balance")), true);
+    });
+    test("provider SPEND-CAP (OpenRouter 403 'Key limit exceeded') → true (same class as 402 → pause+alert)", () => {
+        assert.equal(isInsufficientCreditError(new Error("403 Key limit exceeded (total limit).")), true);
+        assert.equal(isInsufficientCreditError({ status: 403, message: "Key limit exceeded (total limit)" }), true);
+        assert.equal(isInsufficientCreditError(new Error("Your credit limit has been reached")), true);
+    });
+    test("a transient rate-limit is NOT credit-out (must not pause-the-spend on a 429)", () => {
+        assert.equal(isInsufficientCreditError({ status: 429 }), false);
+        assert.equal(isInsufficientCreditError(new Error("RESOURCE_EXHAUSTED: rate limit")), false);
+        assert.equal(isInsufficientCreditError(new Error("429 Rate limit exceeded")), false); // 'limit exceeded' but a RATE limit, not a spend-cap
+        assert.equal(isInsufficientCreditError(new Error("503 Service Unavailable")), false);
+    });
+    test("null / generic errors → false", () => {
+        assert.equal(isInsufficientCreditError(null), false);
+        assert.equal(isInsufficientCreditError(undefined), false);
+        assert.equal(isInsufficientCreditError(new Error("comprehend_failed")), false);
+        assert.equal(isInsufficientCreditError({ status: 400, message: "Bad Request" }), false);
+        assert.equal(isInsufficientCreditError({ status: 403, message: "Forbidden" }), false); // bare 403 (auth) ≠ spend-cap
+    });
+});
+describe("isEmptyResult", () => {
+    test("empty / whitespace / null / undefined → true", () => {
+        assert.equal(isEmptyResult(""), true);
+        assert.equal(isEmptyResult("   \n\t "), true);
+        assert.equal(isEmptyResult(null), true);
+        assert.equal(isEmptyResult(undefined), true);
+    });
+    test("any real content → false", () => {
+        assert.equal(isEmptyResult("{}"), false);
+        assert.equal(isEmptyResult('  {"a":1} '), false);
+    });
+});
+describe("llmTimeoutMs", () => {
+    const saved = process.env.NODEDEX_LLM_TIMEOUT_MS;
+    afterEach(() => {
+        if (saved === undefined)
+            delete process.env.NODEDEX_LLM_TIMEOUT_MS;
+        else
+            process.env.NODEDEX_LLM_TIMEOUT_MS = saved;
+    });
+    test("defaults to 180000 when unset", () => {
+        delete process.env.NODEDEX_LLM_TIMEOUT_MS;
+        assert.equal(llmTimeoutMs(), 180000);
+    });
+    test("honors the env override (incl. 0 = disabled)", () => {
+        process.env.NODEDEX_LLM_TIMEOUT_MS = "5000";
+        assert.equal(llmTimeoutMs(), 5000);
+        process.env.NODEDEX_LLM_TIMEOUT_MS = "0";
+        assert.equal(llmTimeoutMs(), 0);
+    });
+    test("falls back to 180000 on a non-numeric value", () => {
+        process.env.NODEDEX_LLM_TIMEOUT_MS = "not-a-number";
+        assert.equal(llmTimeoutMs(), 180000);
+    });
+});
+describe("decideEmptyOrTimeoutAction (escalate-first-when-fallback policy)", () => {
+    test("empty WITH a fallback model → escalate (skip the slow same-model draw)", () => {
+        assert.equal(decideEmptyOrTimeoutAction({ kind: "empty", hasNextModel: true, emptyRetried: false }), "escalate");
+    });
+    test("empty with NO fallback, not yet retried → retry_same (single-key user's only recovery)", () => {
+        assert.equal(decideEmptyOrTimeoutAction({ kind: "empty", hasNextModel: false, emptyRetried: false }), "retry_same");
+    });
+    test("empty with NO fallback, already retried → degrade", () => {
+        assert.equal(decideEmptyOrTimeoutAction({ kind: "empty", hasNextModel: false, emptyRetried: true }), "degrade");
+    });
+    test("timeout WITH a fallback → escalate", () => {
+        assert.equal(decideEmptyOrTimeoutAction({ kind: "timeout", hasNextModel: true, emptyRetried: false }), "escalate");
+    });
+    test("timeout with NO fallback → degrade (never re-pay the timeout on the same model)", () => {
+        assert.equal(decideEmptyOrTimeoutAction({ kind: "timeout", hasNextModel: false, emptyRetried: false }), "degrade");
+    });
+});
+describe("withTimeout", () => {
+    test("resolves a fast promise before the bound", async () => {
+        const v = await withTimeout(Promise.resolve(42), 1000, "fast");
+        assert.equal(v, 42);
+    });
+    test("rejects with a 'timeout after' message when the bound fires first", async () => {
+        const slow = new Promise((res) => setTimeout(() => res("late"), 50));
+        await assert.rejects(withTimeout(slow, 5, "slow"), /timeout after 5ms/);
+    });
+});
+//# sourceMappingURL=failure-policy.test.js.map

package/dist/engine/providers/__tests__/failure-policy.test.js.map

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

package/dist/engine/providers/__tests__/model-caps.test.d.ts

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

package/dist/engine/providers/__tests__/model-caps.test.d.ts.map

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

package/dist/engine/providers/__tests__/model-caps.test.js

@@ -0,0 +1,38 @@
+/**
+ * model-caps — per-model output ceiling resolution.
+ *
+ * Gates the token budget on every LLM call: the request (maxOut + thinking) must stay
+ * under the model's hard output cap or the provider returns a broken response that
+ * masquerades as a truncation (2026-06-16 Pass 3 glitch). This pins the resolution
+ * order: NODEDEX_MODEL_CAPS override → KNOWN_CAPS → conservative default.
+ */
+import { test, describe, afterEach } from "node:test";
+import assert from "node:assert/strict";
+import { modelOutputCeiling, DEFAULT_CEILING } from "../model-caps.js";
+describe("modelOutputCeiling", () => {
+    afterEach(() => { delete process.env.NODEDEX_MODEL_CAPS; });
+    test("known prefixed model → its real cap", () => {
+        assert.equal(modelOutputCeiling("google/gemini-2.5-flash"), 65535);
+        assert.equal(modelOutputCeiling("openai/gpt-4o"), 16384);
+    });
+    test("known bare model id (AI_MODEL without vendor prefix) → its cap", () => {
+        assert.equal(modelOutputCeiling("gemini-2.5-flash"), 65535);
+        assert.equal(modelOutputCeiling("gpt-4o"), 16384);
+    });
+    test("unknown or missing model → conservative default", () => {
+        assert.equal(modelOutputCeiling("some/never-seen-model"), DEFAULT_CEILING);
+        assert.equal(modelOutputCeiling(undefined), DEFAULT_CEILING);
+    });
+    test("NODEDEX_MODEL_CAPS override wins over the known map (web-UI live cap)", () => {
+        process.env.NODEDEX_MODEL_CAPS = JSON.stringify({ "google/gemini-2.5-flash": 12345, "vendor/new": 200000 });
+        assert.equal(modelOutputCeiling("google/gemini-2.5-flash"), 12345); // override beats KNOWN_CAPS
+        assert.equal(modelOutputCeiling("vendor/new"), 200000); // override supplies an unknown
+        assert.equal(modelOutputCeiling("openai/gpt-4o"), 16384); // untouched models keep known cap
+    });
+    test("malformed NODEDEX_MODEL_CAPS is ignored (falls back to known/default)", () => {
+        process.env.NODEDEX_MODEL_CAPS = "{not json";
+        assert.equal(modelOutputCeiling("google/gemini-2.5-flash"), 65535);
+        assert.equal(modelOutputCeiling("x/y"), DEFAULT_CEILING);
+    });
+});
+//# sourceMappingURL=model-caps.test.js.map

package/dist/engine/providers/__tests__/model-caps.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-caps.test.js","sourceRoot":"","sources":["../../../../src/engine/providers/__tests__/model-caps.test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEvE,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,SAAS,CAAC,GAAG,EAAE,GAAG,OAAO,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC;IAE5D,IAAI,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC/C,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,yBAAyB,CAAC,EAAE,KAAK,CAAC,CAAC;QACnE,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,eAAe,CAAC,EAAE,KAAK,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,gEAAgE,EAAE,GAAG,EAAE;QAC1E,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,kBAAkB,CAAC,EAAE,KAAK,CAAC,CAAC;QAC5D,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,iDAAiD,EAAE,GAAG,EAAE;QAC3D,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,uBAAuB,CAAC,EAAE,eAAe,CAAC,CAAC;QAC3E,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,SAAS,CAAC,EAAE,eAAe,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,uEAAuE,EAAE,GAAG,EAAE;QACjF,OAAO,CAAC,GAAG,CAAC,kBAAkB,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,yBAAyB,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC;QAC5G,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,yBAAyB,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,4BAA4B;QAChG,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,CAAC,CAAa,+BAA+B;QACnG,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,eAAe,CAAC,EAAE,KAAK,CAAC,CAAC,CAAW,kCAAkC;IACxG,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,uEAAuE,EAAE,GAAG,EAAE;QACjF,OAAO,CAAC,GAAG,CAAC,kBAAkB,GAAG,WAAW,CAAC;QAC7C,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,yBAAyB,CAAC,EAAE,KAAK,CAAC,CAAC;QACnE,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,KAAK,CAAC,EAAE,eAAe,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/engine/providers/__tests__/openai-structured.test.d.ts

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

package/dist/engine/providers/__tests__/openai-structured.test.d.ts.map

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

package/dist/engine/providers/__tests__/openai-structured.test.js

@@ -0,0 +1,73 @@
+// Unit tests for the structured-output portability helpers (openai.ts).
+// The mechanism-selection + prompt-JSON fallback make the pipeline model-portable
+// (Anthropic→tool-use, default→response_format, unknown/400→prompt-JSON floor).
+import { test, describe } from "node:test";
+import assert from "node:assert/strict";
+import { primaryMechanism, stripJsonFences, classifyGenError, EmptyResponseError } from "../openai.js";
+describe("primaryMechanism (mechanism-by-model)", () => {
+    test("Anthropic models → tool_use (they reject response_format)", () => {
+        assert.equal(primaryMechanism("anthropic/claude-haiku-4.5"), "tool_use");
+        assert.equal(primaryMechanism("anthropic/claude-opus-4.1"), "tool_use");
+        assert.equal(primaryMechanism("claude-3-5-sonnet"), "tool_use");
+    });
+    test("OpenAI / Gemini / others → response_format (the default, unchanged path)", () => {
+        assert.equal(primaryMechanism("google/gemini-2.5-flash"), "response_format");
+        assert.equal(primaryMechanism("openai/gpt-4o"), "response_format");
+        assert.equal(primaryMechanism("gpt-4o"), "response_format");
+        assert.equal(primaryMechanism("x-ai/grok-2"), "response_format");
+        assert.equal(primaryMechanism("deepseek/deepseek-chat"), "response_format");
+    });
+    test("empty/garbage → response_format (safe default)", () => {
+        assert.equal(primaryMechanism(""), "response_format");
+        assert.equal(primaryMechanism(undefined), "response_format");
+    });
+});
+describe("stripJsonFences (prompt-JSON robustness)", () => {
+    test("strips ```json fences", () => {
+        assert.equal(stripJsonFences('```json\n{"a":1}\n```'), '{"a":1}');
+    });
+    test("strips bare ``` fences", () => {
+        assert.equal(stripJsonFences('```\n{"a":1}\n```'), '{"a":1}');
+    });
+    test("leaves un-fenced JSON untouched", () => {
+        assert.equal(stripJsonFences('{"a":1}'), '{"a":1}');
+    });
+    test("trims surrounding whitespace", () => {
+        assert.equal(stripJsonFences('   {"a":1}   '), '{"a":1}');
+    });
+});
+describe("classifyGenError (failure-mode routing)", () => {
+    test("EmptyResponseError → empty (escalates to fallback model, not a bump)", () => {
+        assert.equal(classifyGenError(new EmptyResponseError("google/gemini-2.5-flash")), "empty");
+    });
+    test("empty is NOT misclassified as truncated (the Run-12 bug)", () => {
+        // The old code let JSON.parse('') throw a SyntaxError → 'truncated'. The
+        // explicit EmptyResponseError must win so empties escalate instead of bumping.
+        assert.notEqual(classifyGenError(new EmptyResponseError("x")), "truncated");
+    });
+    test("429 → rate_limited (by status or message)", () => {
+        assert.equal(classifyGenError({ status: 429 }), "rate_limited");
+        assert.equal(classifyGenError(new Error("Request failed: 429 Too Many Requests")), "rate_limited");
+    });
+    test("APIConnectionTimeoutError / 'timed out' → timeout", () => {
+        const e = new Error("Request timed out.");
+        e.name = "APIConnectionTimeoutError";
+        assert.equal(classifyGenError(e), "timeout");
+        assert.equal(classifyGenError(new Error("the request timed out")), "timeout");
+    });
+    test("SyntaxError on a non-empty body → truncated (the determinism-trap case)", () => {
+        let parseErr;
+        try {
+            JSON.parse('{"a":1');
+        }
+        catch (pe) {
+            parseErr = pe;
+        }
+        assert.equal(classifyGenError(parseErr), "truncated");
+        assert.equal(classifyGenError(new Error("Unterminated string in JSON")), "truncated");
+    });
+    test("a 400/other provider error → mechanism_or_other (prompt-JSON floor)", () => {
+        assert.equal(classifyGenError({ status: 400, message: "Bad Request" }), "mechanism_or_other");
+    });
+});
+//# sourceMappingURL=openai-structured.test.js.map

package/dist/engine/providers/__tests__/openai-structured.test.js.map

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

package/dist/engine/providers/__tests__/usage-ledger.test.d.ts

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

package/dist/engine/providers/__tests__/usage-ledger.test.d.ts.map

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

package/dist/engine/providers/__tests__/usage-ledger.test.js

@@ -0,0 +1,108 @@
+import { describe, it, beforeEach, afterEach } from "node:test";
+import assert from "node:assert/strict";
+import { existsSync, rmSync, mkdtempSync } from "fs";
+import { tmpdir } from "os";
+import path from "path";
+import { wrapWithUsageLedger, getUsageSummary } from "../usage-ledger.js";
+/** Minimal fake provider. `model: null` simulates the no-API-key early return. */
+function fakeProvider(usage, model = "gemini-2.5-flash") {
+    return {
+        getName: () => "test",
+        isAvailable: () => true,
+        ping: async () => true,
+        generate: async () => "ok",
+        async generateStructured() {
+            const res = { result: {}, rateLimited: false, usage };
+            if (model !== null)
+                res.model = model;
+            return res;
+        },
+    };
+}
+describe("usage-ledger", () => {
+    let dir;
+    let ledger;
+    const savedEnabled = process.env.NODEDEX_USAGE_LEDGER;
+    beforeEach(() => {
+        dir = mkdtempSync(path.join(tmpdir(), "nodedex-usage-"));
+        ledger = path.join(dir, "api-usage.jsonl");
+        process.env.NODEDEX_USAGE_LEDGER_PATH = ledger;
+        delete process.env.NODEDEX_USAGE_LEDGER; // default on
+    });
+    afterEach(() => {
+        delete process.env.NODEDEX_USAGE_LEDGER_PATH;
+        if (savedEnabled === undefined)
+            delete process.env.NODEDEX_USAGE_LEDGER;
+        else
+            process.env.NODEDEX_USAGE_LEDGER = savedEnabled;
+        try {
+            rmSync(dir, { recursive: true, force: true });
+        }
+        catch { /* ignore */ }
+    });
+    it("records a priced call with computed (estimated) cost", async () => {
+        const p = wrapWithUsageLedger(fakeProvider({ input: 1000, output: 2000, thinking: 500 }));
+        const r = await p.generateStructured("sys", "user", {});
+        assert.equal(r.rateLimited, false); // result passes through untouched
+        const s = getUsageSummary();
+        assert.equal(s.total.calls, 1);
+        assert.equal(s.total.input, 1000);
+        assert.equal(s.total.output, 2000);
+        assert.equal(s.total.thinking, 500);
+        // gemini-2.5-flash: (1000*0.30 + 2000*2.50 + 500*2.50) / 1e6  (thinking billed as output)
+        const expected = (1000 * 0.3 + 2000 * 2.5 + 500 * 2.5) / 1_000_000;
+        assert.ok(Math.abs(s.total.cost_usd - expected) < 1e-9, `cost ${s.total.cost_usd} ~ ${expected}`);
+        assert.equal(s.cost_sources.estimated, 1);
+        assert.equal(s.recent[0].cost_source, "estimated");
+        assert.ok(s.since && s.latest);
+        assert.equal(s.by_model["gemini-2.5-flash"].calls, 1);
+    });
+    it("uses the provider's ACTUAL cost when present (openrouter_actual, not the estimate)", async () => {
+        // costUsd deliberately != the table estimate → must win.
+        const p = wrapWithUsageLedger(fakeProvider({ input: 1000, output: 2000, thinking: 0, costUsd: 0.123 }));
+        await p.generateStructured("s", "u", {});
+        const s = getUsageSummary();
+        assert.equal(s.total.cost_usd, 0.123);
+        assert.equal(s.cost_sources.openrouter_actual, 1);
+        assert.equal(s.cost_sources.estimated, 0);
+        assert.equal(s.recent[0].cost_source, "openrouter_actual");
+    });
+    it("accumulates across calls and breaks down by model", async () => {
+        const flash = wrapWithUsageLedger(fakeProvider({ input: 100, output: 100, thinking: 0 }, "gemini-2.5-flash"));
+        const pro = wrapWithUsageLedger(fakeProvider({ input: 200, output: 200, thinking: 0 }, "gemini-2.5-pro"));
+        await flash.generateStructured("s", "u", {});
+        await flash.generateStructured("s", "u", {});
+        await pro.generateStructured("s", "u", {});
+        const s = getUsageSummary();
+        assert.equal(s.total.calls, 3);
+        assert.equal(s.by_model["gemini-2.5-flash"].calls, 2);
+        assert.equal(s.by_model["gemini-2.5-pro"].calls, 1);
+        assert.equal(s.total.input, 400);
+    });
+    it("marks an unpriced model as unknown (cost null, never fabricated)", async () => {
+        const p = wrapWithUsageLedger(fakeProvider({ input: 10, output: 10, thinking: 0 }, "some/unknown-model"));
+        await p.generateStructured("s", "u", {});
+        const s = getUsageSummary();
+        assert.equal(s.total.calls, 1);
+        assert.equal(s.total.unpriced_calls, 1);
+        assert.equal(s.total.cost_usd, 0); // unknown excluded from the $ total, not counted as 0-cost
+        assert.equal(s.cost_sources.unknown, 1);
+    });
+    it("writes nothing when disabled", async () => {
+        process.env.NODEDEX_USAGE_LEDGER = "off";
+        const p = wrapWithUsageLedger(fakeProvider({ input: 10, output: 10, thinking: 0 }));
+        const r = await p.generateStructured("s", "u", {});
+        assert.equal(r.rateLimited, false); // generation still works
+        assert.equal(existsSync(ledger), false);
+        const s = getUsageSummary();
+        assert.equal(s.enabled, false);
+        assert.equal(s.total.calls, 0);
+    });
+    it("does NOT record a no-API-key call (no model set)", async () => {
+        const p = wrapWithUsageLedger(fakeProvider(undefined, null)); // model null → not a real key call
+        await p.generateStructured("s", "u", {});
+        const s = getUsageSummary();
+        assert.equal(s.total.calls, 0);
+    });
+});
+//# sourceMappingURL=usage-ledger.test.js.map

package/dist/engine/providers/__tests__/usage-ledger.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-ledger.test.js","sourceRoot":"","sources":["../../../../src/engine/providers/__tests__/usage-ledger.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAChE,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,IAAI,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC;AAC5B,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAI1E,kFAAkF;AAClF,SAAS,YAAY,CAAC,KAAwB,EAAE,QAAuB,kBAAkB;IACvF,OAAO;QACL,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM;QACrB,WAAW,EAAE,GAAG,EAAE,CAAC,IAAI;QACvB,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,IAAI;QACtB,QAAQ,EAAE,KAAK,IAAI,EAAE,CAAC,IAAI;QAC1B,KAAK,CAAC,kBAAkB;YACtB,MAAM,GAAG,GAAsB,EAAE,MAAM,EAAE,EAAO,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;YAC9E,IAAI,KAAK,KAAK,IAAI;gBAAE,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC;YACtC,OAAO,GAAG,CAAC;QACb,CAAC;KACF,CAAC;AACJ,CAAC;AAED,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,IAAI,GAAW,CAAC;IAChB,IAAI,MAAc,CAAC;IACnB,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;IAEtD,UAAU,CAAC,GAAG,EAAE;QACd,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,gBAAgB,CAAC,CAAC,CAAC;QACzD,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAAC;QAC3C,OAAO,CAAC,GAAG,CAAC,yBAAyB,GAAG,MAAM,CAAC;QAC/C,OAAO,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC,aAAa;IACxD,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC;QAC7C,IAAI,YAAY,KAAK,SAAS;YAAE,OAAO,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;;YACnE,OAAO,CAAC,GAAG,CAAC,oBAAoB,GAAG,YAAY,CAAC;QACrD,IAAI,CAAC;YAAC,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;IAC/E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;QACpE,MAAM,CAAC,GAAG,mBAAmB,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;QAC1F,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;QACxD,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC,kCAAkC;QAEtE,MAAM,CAAC,GAAG,eAAe,EAAE,CAAC;QAC5B,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAC/B,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAClC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACnC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QACpC,0FAA0F;QAC1F,MAAM,QAAQ,GAAG,CAAC,IAAI,GAAG,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC,GAAG,SAAS,CAAC;QACnE,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,GAAG,QAAQ,CAAC,GAAG,IAAI,EAAE,QAAQ,CAAC,CAAC,KAAK,CAAC,QAAQ,MAAM,QAAQ,EAAE,CAAC,CAAC;QAClG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;QAC1C,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;QACnD,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC;QAC/B,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oFAAoF,EAAE,KAAK,IAAI,EAAE;QAClG,yDAAyD;QACzD,MAAM,CAAC,GAAG,mBAAmB,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QACxG,MAAM,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;QACzC,MAAM,CAAC,GAAG,eAAe,EAAE,CAAC;QAC5B,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QACtC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC;QAClD,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;QAC1C,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,mBAAmB,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,KAAK,IAAI,EAAE;QACjE,MAAM,KAAK,GAAG,mBAAmB,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,kBAAkB,CAAC,CAAC,CAAC;QAC9G,MAAM,GAAG,GAAG,mBAAmB,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,gBAAgB,CAAC,CAAC,CAAC;QAC1G,MAAM,KAAK,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;QAC7C,MAAM,KAAK,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;QAC7C,MAAM,GAAG,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;QAE3C,MAAM,CAAC,GAAG,eAAe,EAAE,CAAC;QAC5B,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAC/B,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QACtD,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QACpD,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kEAAkE,EAAE,KAAK,IAAI,EAAE;QAChF,MAAM,CAAC,GAAG,mBAAmB,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,oBAAoB,CAAC,CAAC,CAAC;QAC1G,MAAM,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;QACzC,MAAM,CAAC,GAAG,eAAe,EAAE,CAAC;QAC5B,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAC/B,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC;QACxC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,2DAA2D;QAC9F,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,KAAK,IAAI,EAAE;QAC5C,OAAO,CAAC,GAAG,CAAC,oBAAoB,GAAG,KAAK,CAAC;QACzC,MAAM,CAAC,GAAG,mBAAmB,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACpF,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;QACnD,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC,yBAAyB;QAC7D,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC,CAAC;QACxC,MAAM,CAAC,GAAG,eAAe,EAAE,CAAC;QAC5B,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAC/B,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,KAAK,IAAI,EAAE;QAChE,MAAM,CAAC,GAAG,mBAAmB,CAAC,YAAY,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,mCAAmC;QACjG,MAAM,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;QACzC,MAAM,CAAC,GAAG,eAAe,EAAE,CAAC;QAC5B,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/engine/providers/anthropic.d.ts

@@ -0,0 +1,17 @@
+import type { LLMProvider, GenerateResult } from "../ai-provider.js";
+export declare class AnthropicProvider implements LLMProvider {
+    private client;
+    private model;
+    private fallbackModel;
+    constructor(apiKey: string);
+    isAvailable(): boolean;
+    getName(): string;
+    generateStructured<T>(systemPrompt: string, userInput: string, schema: object, options?: {
+        thinkingBudget?: number;
+        maxOutputTokens?: number;
+        modelOverride?: string;
+    }): Promise<GenerateResult<T>>;
+    generate(prompt: string): Promise<string | null>;
+    ping(): Promise<boolean>;
+}
+//# sourceMappingURL=anthropic.d.ts.map

package/dist/engine/providers/anthropic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../../src/engine/providers/anthropic.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGrE,qBAAa,iBAAkB,YAAW,WAAW;IACnD,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,aAAa,CAAgB;gBAEzB,MAAM,EAAE,MAAM;IAO1B,WAAW,IAAI,OAAO;IACtB,OAAO,IAAI,MAAM;IAEX,kBAAkB,CAAC,CAAC,EACxB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,GACtF,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IA6FvB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAiBhD,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;CAG/B"}