@polpo-ai/core 0.15.133 → 0.15.135

package/dist/model-runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"model-runtime.js","sourceRoot":"","sources":["../src/model-runtime.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,UAAU,EAAE,SAAS,CAAU,CAAC;AAoIpE,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,mBAAyC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACjG,CAAC"}
+{"version":3,"file":"model-runtime.js","sourceRoot":"","sources":["../src/model-runtime.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,UAAU,EAAE,SAAS,CAAU,CAAC;AAqIpE,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,mBAAyC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACjG,CAAC"}

package/dist/semantic-retrieval-quality.test.d.ts

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

package/dist/semantic-retrieval-quality.test.d.ts.map

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

package/dist/semantic-retrieval-quality.test.js

@@ -0,0 +1,319 @@
+import { describe, expect, it } from "vitest";
+import { evaluateSemanticRetrievalQualityGate, rerankTextCandidates, runSemanticRetrievalEval, } from "./semantic-retrieval.js";
+const cases = [
+    {
+        id: "exact",
+        query: "invoice INV-2048",
+        relevantIds: ["invoice-2048"],
+        tags: ["exact_identifier"],
+    },
+    {
+        id: "paraphrase",
+        query: "get my money back",
+        relevantIds: ["refund-policy", "refund-faq"],
+        tags: ["paraphrase"],
+    },
+    {
+        id: "abstain",
+        query: "founder's favorite constellation",
+        relevantIds: [],
+        tags: ["abstention"],
+    },
+    {
+        id: "isolation",
+        query: "quarterly plan",
+        relevantIds: ["public-plan"],
+        forbiddenIds: ["other-tenant-plan"],
+        tags: ["cross_scope"],
+    },
+];
+describe("semantic retrieval quality evaluation", () => {
+    it("computes ranking, exact-id, abstention, isolation, and latency metrics", async () => {
+        const report = await runSemanticRetrievalEval(cases, async ({ id }) => {
+            switch (id) {
+                case "exact":
+                    return { resultIds: ["noise", "invoice-2048"], durationMs: 10 };
+                case "paraphrase":
+                    return {
+                        resultIds: ["refund-policy", "noise", "refund-faq"],
+                        durationMs: 20,
+                    };
+                case "abstain":
+                    return { resultIds: [], durationMs: 30 };
+                default:
+                    return {
+                        resultIds: ["public-plan", "other-tenant-plan"],
+                        durationMs: 40,
+                    };
+            }
+        });
+        expect(report).toMatchObject({
+            cases: 4,
+            retrievalCases: 3,
+            hits: 3,
+            recallAtK: 1,
+            mrr: (0.5 + 1 + 1) / 3,
+            abstentionCases: 1,
+            abstentionFalsePositives: 0,
+            forbiddenResultCount: 1,
+            failedCaseIds: [],
+            failureRate: 0,
+            exactIdentifier: { cases: 1, hits: 1, recallAtK: 1 },
+            latencyMs: { p50: 20, p95: 40, max: 40 },
+        });
+        expect(report.ndcgAtK).toBeCloseTo(((1 / Math.log2(3))
+            + ((1 + (1 / Math.log2(4))) / (1 + (1 / Math.log2(3))))
+            + 1) / 3);
+        expect(report.caseReports.find(({ id }) => id === "isolation"))
+            .toMatchObject({ forbiddenResultIds: ["other-tenant-plan"] });
+        expect(JSON.stringify(report)).not.toContain("quarterly plan");
+    });
+    it("preserves the simple retriever contract and old top-level metrics", async () => {
+        const report = await runSemanticRetrievalEval([
+            { id: "hit", query: "refund", relevantIds: ["refund"] },
+            { id: "miss", query: "shipping", relevantIds: ["delivery"] },
+        ], async ({ id }) => id === "hit" ? ["refund"] : ["other"]);
+        expect(report).toMatchObject({
+            cases: 2,
+            hits: 1,
+            recallAtK: 0.5,
+            missedCaseIds: ["miss"],
+        });
+    });
+    it("classifies retriever failures per case but never converts abort into a report", async () => {
+        const report = await runSemanticRetrievalEval([
+            { id: "failed", query: "refund", relevantIds: ["refund"] },
+        ], async () => {
+            throw new Error("provider leaked source content here");
+        });
+        expect(report).toMatchObject({
+            failures: 1,
+            failedCaseIds: ["failed"],
+            failureRate: 1,
+        });
+        expect(JSON.stringify(report)).not.toContain("provider leaked");
+        await expect(runSemanticRetrievalEval([
+            { id: "aborted", query: "refund", relevantIds: ["refund"] },
+        ], async () => {
+            throw Object.assign(new Error("cancelled"), { name: "AbortError" });
+        })).rejects.toMatchObject({ name: "AbortError" });
+    });
+    it.each([
+        [[
+                { id: "duplicate", query: "a", relevantIds: ["one"] },
+                { id: "duplicate", query: "b", relevantIds: ["two"] },
+            ], "duplicate"],
+        [[
+                { id: "overlap", query: "a", relevantIds: ["same"], forbiddenIds: ["same"] },
+            ], "both relevant and forbidden"],
+        [[
+                { id: "empty", query: "a", relevantIds: [] },
+            ], "abstention"],
+        [[
+                { id: "bad-abstain", query: "a", relevantIds: ["one"], tags: ["abstention"] },
+            ], "must not define relevant"],
+    ])("rejects malformed case manifests %#", async (manifest, message) => {
+        await expect(runSemanticRetrievalEval(manifest, async () => [])).rejects.toThrow(message);
+    });
+    it("rejects duplicate, unknown, over-limit, and non-canonical result identities", async () => {
+        const oneCase = [{ id: "case", query: "q", relevantIds: ["one"] }];
+        await expect(runSemanticRetrievalEval(oneCase, async () => ["one", "one"]))
+            .rejects.toThrow("duplicate");
+        await expect(runSemanticRetrievalEval([{ ...oneCase[0], limit: 1 }], async () => ["one", "two"])).rejects.toThrow("limit");
+        await expect(runSemanticRetrievalEval(oneCase, async () => ["e\u0301"]))
+            .rejects.toThrow("Unicode-normalized");
+        await expect(runSemanticRetrievalEval(oneCase, async () => ({
+            resultIds: ["one"],
+            fallbackReason: "provider returned its raw error",
+        }))).rejects.toThrow("sanitized reason code");
+    });
+});
+describe("semantic retrieval quality gates", () => {
+    it("blocks exact-id regression and forbidden output despite aggregate uplift", async () => {
+        const baseline = await runSemanticRetrievalEval(cases, async ({ id }) => ({
+            resultIds: id === "abstain"
+                ? []
+                : id === "exact"
+                    ? ["invoice-2048"]
+                    : id === "paraphrase"
+                        ? ["noise"]
+                        : ["public-plan"],
+            durationMs: 10,
+        }));
+        const candidate = await runSemanticRetrievalEval(cases, async ({ id }) => ({
+            resultIds: id === "abstain"
+                ? []
+                : id === "exact"
+                    ? ["noise"]
+                    : id === "paraphrase"
+                        ? ["refund-policy"]
+                        : ["public-plan", "other-tenant-plan"],
+            durationMs: 12,
+        }));
+        const gate = evaluateSemanticRetrievalQualityGate({
+            baseline,
+            candidate,
+            policy: {
+                minimumRecallAtK: 0.5,
+                maximumRecallAtKRegression: 0,
+                maximumExactIdentifierRecallRegression: 0,
+                maximumForbiddenResults: 0,
+            },
+        });
+        expect(gate.passed).toBe(false);
+        expect(gate.failures.map(({ code }) => code)).toEqual(expect.arrayContaining([
+            "exact_identifier_regression",
+            "forbidden_results",
+        ]));
+    });
+    it("passes a non-regressing candidate and rejects invalid policy", async () => {
+        const report = await runSemanticRetrievalEval(cases, async ({ id }) => ({
+            resultIds: id === "abstain"
+                ? []
+                : id === "exact"
+                    ? ["invoice-2048"]
+                    : id === "paraphrase"
+                        ? ["refund-policy", "refund-faq"]
+                        : ["public-plan"],
+            durationMs: 8,
+        }));
+        expect(evaluateSemanticRetrievalQualityGate({
+            baseline: report,
+            candidate: report,
+            policy: {
+                minimumRecallAtK: 1,
+                minimumMrr: 1,
+                minimumNdcgAtK: 1,
+                maximumP95LatencyMs: 10,
+            },
+        })).toMatchObject({ passed: true, failures: [] });
+        expect(() => evaluateSemanticRetrievalQualityGate({
+            baseline: report,
+            candidate: report,
+            policy: { minimumMrr: 1.1 },
+        })).toThrow("minimumMrr");
+    });
+    it("refuses to compare reports from different case manifests", async () => {
+        const baseline = await runSemanticRetrievalEval([
+            { id: "one", query: "one", relevantIds: ["one"] },
+        ], async () => ["one"]);
+        const candidate = await runSemanticRetrievalEval([
+            { id: "two", query: "two", relevantIds: ["two"] },
+        ], async () => ["two"]);
+        expect(() => evaluateSemanticRetrievalQualityGate({ baseline, candidate }))
+            .toThrow("same case manifest");
+        const changedJudgement = await runSemanticRetrievalEval([
+            { id: "one", query: "one", relevantIds: ["different"] },
+        ], async () => ["different"]);
+        expect(() => evaluateSemanticRetrievalQualityGate({
+            baseline,
+            candidate: changedJudgement,
+        })).toThrow("same case manifest");
+        expect(() => evaluateSemanticRetrievalQualityGate({
+            baseline,
+            candidate: { ...baseline, recallAtK: Number.NaN },
+        })).toThrow("candidate.recallAtK");
+    });
+});
+describe("shared text reranker", () => {
+    const candidates = [
+        { id: "a", text: "Alpha" },
+        { id: "b", text: "Beta" },
+        { id: "c", text: "Gamma" },
+    ];
+    it("returns a bounded immutable ranking with usage", async () => {
+        const reranker = {
+            rerank: async () => ({
+                ranking: [{ id: "b", score: 0.9 }, { id: "a", score: 0.8 }],
+                usage: { tokens: 3 },
+            }),
+        };
+        const outcome = await rerankTextCandidates({
+            query: "beta first",
+            candidates,
+            limit: 2,
+            failureMode: "strict",
+        }, reranker);
+        expect(outcome.ranking).toEqual([
+            { candidate: candidates[1], score: 0.9 },
+            { candidate: candidates[0], score: 0.8 },
+        ]);
+        expect(outcome.usage).toEqual({ tokens: 3 });
+        expect(Object.isFrozen(outcome.ranking)).toBe(true);
+    });
+    it.each([
+        [[{ id: "unknown", score: 1 }, { id: "a", score: 0 }], "unknown"],
+        [[{ id: "a", score: 1 }, { id: "a", score: 0 }], "duplicate"],
+        [[{ id: "a", score: Number.NaN }, { id: "b", score: 0 }], "finite"],
+        [[{ id: "a", score: 1 }], "exactly 2"],
+    ])("falls back on malformed provider output %#", async (ranking, reason) => {
+        const reranker = {
+            rerank: async () => ({ ranking }),
+        };
+        const outcome = await rerankTextCandidates({
+            query: "test",
+            candidates,
+            limit: 2,
+            failureMode: "fallback",
+        }, reranker);
+        expect(outcome.fallbackReason).toBe("reranker_invalid_output");
+        expect(outcome.ranking.map(({ candidate }) => candidate.id)).toEqual(["a", "b"]);
+        await expect(rerankTextCandidates({
+            query: "test",
+            candidates,
+            limit: 2,
+            failureMode: "strict",
+        }, reranker)).rejects.toThrow(reason);
+    });
+    it("propagates cancellation instead of silently falling back", async () => {
+        const reranker = {
+            rerank: async () => {
+                throw Object.assign(new Error("cancelled"), { name: "AbortError" });
+            },
+        };
+        await expect(rerankTextCandidates({
+            query: "test",
+            candidates,
+            limit: 2,
+            failureMode: "fallback",
+        }, reranker)).rejects.toMatchObject({ name: "AbortError" });
+    });
+    it("bounds a provider that ignores cancellation and classifies timeout", async () => {
+        const reranker = {
+            rerank: async () => new Promise(() => undefined),
+        };
+        const outcome = await rerankTextCandidates({
+            query: "test",
+            candidates,
+            limit: 2,
+            timeoutMs: 1,
+            failureMode: "fallback",
+        }, reranker);
+        expect(outcome.fallbackReason).toBe("reranker_timeout");
+        const controller = new AbortController();
+        const pending = rerankTextCandidates({
+            query: "test",
+            candidates,
+            limit: 2,
+            timeoutMs: 10_000,
+            failureMode: "fallback",
+            signal: controller.signal,
+        }, reranker);
+        controller.abort();
+        await expect(pending).rejects.toMatchObject({ name: "AbortError" });
+    });
+    it("does not classify a provider TypeError as malformed output", async () => {
+        const outcome = await rerankTextCandidates({
+            query: "test",
+            candidates,
+            limit: 2,
+            failureMode: "fallback",
+        }, {
+            rerank: async () => {
+                throw new TypeError("network library failed");
+            },
+        });
+        expect(outcome.fallbackReason).toBe("reranker_unavailable");
+    });
+});
+//# sourceMappingURL=semantic-retrieval-quality.test.js.map

package/dist/semantic-retrieval-quality.test.js.map

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

package/dist/semantic-retrieval.d.ts

@@ -81,6 +81,7 @@ export interface HybridRankingResult {
     readonly scores: {
         readonly lexical?: number;
         readonly semantic?: number;
+        readonly rerank?: number;
     };
 }
 export interface HybridRetrievalPolicy {
@@ -103,15 +104,131 @@ export interface SemanticRetrievalEvalCase {
     readonly id: string;
     readonly query: string;
     readonly relevantIds: readonly string[];
+    readonly forbiddenIds?: readonly string[];
+    readonly tags?: readonly SemanticRetrievalEvalTag[];
+    readonly limit?: number;
+}
+export declare const SEMANTIC_RETRIEVAL_EVAL_TAGS: readonly ["exact_identifier", "paraphrase", "multilingual", "abstention", "stale", "revoked", "cross_scope"];
+export type SemanticRetrievalEvalTag = (typeof SEMANTIC_RETRIEVAL_EVAL_TAGS)[number];
+export interface SemanticRetrievalEvalObservationInput {
+    readonly resultIds: readonly string[];
+    readonly durationMs?: number;
+    readonly fallbackReason?: string;
+}
+export interface SemanticRetrievalEvalCaseReport {
+    readonly id: string;
+    readonly tags: readonly SemanticRetrievalEvalTag[];
+    readonly relevantIds: readonly string[];
+    readonly forbiddenIds: readonly string[];
+    readonly limit?: number;
+    readonly resultIds: readonly string[];
+    readonly hit: boolean;
+    readonly firstRelevantRank?: number;
+    readonly reciprocalRank: number;
+    readonly ndcgAtK: number;
+    readonly forbiddenResultIds: readonly string[];
+    readonly abstentionFalsePositive: boolean;
+    readonly durationMs: number;
+    readonly fallbackReason?: string;
+    readonly failure?: "retriever_error";
 }
 export interface SemanticRetrievalEvalReport {
     readonly cases: number;
+    readonly retrievalCases: number;
     readonly hits: number;
     readonly recallAtK: number;
+    readonly mrr: number;
+    readonly ndcgAtK: number;
     readonly missedCaseIds: readonly string[];
+    readonly abstentionCases: number;
+    readonly abstentionFalsePositives: number;
+    readonly abstentionFalsePositiveRate: number;
+    readonly forbiddenResultCount: number;
+    readonly failures: number;
+    readonly failedCaseIds: readonly string[];
+    readonly failureRate: number;
+    readonly exactIdentifier: {
+        readonly cases: number;
+        readonly hits: number;
+        readonly recallAtK: number;
+    };
+    readonly latencyMs: {
+        readonly p50: number;
+        readonly p95: number;
+        readonly max: number;
+    };
+    readonly caseReports: readonly SemanticRetrievalEvalCaseReport[];
+}
+export interface SemanticRetrievalQualityGatePolicy {
+    readonly minimumRecallAtK?: number;
+    readonly minimumMrr?: number;
+    readonly minimumNdcgAtK?: number;
+    readonly minimumExactIdentifierRecall?: number;
+    readonly maximumAbstentionFalsePositiveRate?: number;
+    readonly maximumForbiddenResults?: number;
+    readonly maximumFailureRate?: number;
+    readonly maximumP95LatencyMs?: number;
+    readonly maximumRecallAtKRegression?: number;
+    readonly maximumMrrRegression?: number;
+    readonly maximumNdcgAtKRegression?: number;
+    readonly maximumExactIdentifierRecallRegression?: number;
+}
+export type SemanticRetrievalQualityGateFailureCode = "minimum_recall_at_k" | "minimum_mrr" | "minimum_ndcg_at_k" | "minimum_exact_identifier_recall" | "abstention_false_positive_rate" | "forbidden_results" | "failure_rate" | "p95_latency" | "recall_at_k_regression" | "mrr_regression" | "ndcg_at_k_regression" | "exact_identifier_regression";
+export interface SemanticRetrievalQualityGateFailure {
+    readonly code: SemanticRetrievalQualityGateFailureCode;
+    readonly actual: number;
+    readonly threshold: number;
+    readonly caseIds?: readonly string[];
+}
+export interface SemanticRetrievalQualityGateResult {
+    readonly passed: boolean;
+    readonly failures: readonly SemanticRetrievalQualityGateFailure[];
+}
+export interface TextRerankCandidate {
+    readonly id: string;
+    readonly text: string;
+}
+export interface TextRerankRequest {
+    readonly query: string;
+    readonly candidates: readonly TextRerankCandidate[];
+    readonly limit: number;
+    readonly signal?: AbortSignal;
+}
+export interface TextRerankScore {
+    readonly id: string;
+    readonly score: number;
+}
+export interface TextRerankResult {
+    readonly ranking: readonly TextRerankScore[];
+    readonly usage?: unknown;
+}
+export interface TextReranker {
+    rerank(request: TextRerankRequest): Promise<TextRerankResult>;
+}
+export interface TextRerankedCandidate {
+    readonly candidate: TextRerankCandidate;
+    readonly score?: number;
+}
+export interface TextRerankOutcome {
+    readonly ranking: readonly TextRerankedCandidate[];
+    readonly usage?: unknown;
+    readonly fallbackReason?: "reranker_invalid_output" | "reranker_timeout" | "reranker_unavailable";
 }
 export declare function normalizeHybridRetrievalPolicy(value?: HybridRetrievalPolicy): NormalizedHybridRetrievalPolicy;
-export declare function runSemanticRetrievalEval(cases: readonly SemanticRetrievalEvalCase[], retrieve: (value: SemanticRetrievalEvalCase) => Promise<readonly string[]>): Promise<SemanticRetrievalEvalReport>;
+export declare function runSemanticRetrievalEval(cases: readonly SemanticRetrievalEvalCase[], retrieve: (value: SemanticRetrievalEvalCase) => Promise<readonly string[] | SemanticRetrievalEvalObservationInput>): Promise<SemanticRetrievalEvalReport>;
+export declare function evaluateSemanticRetrievalQualityGate(input: {
+    readonly baseline: SemanticRetrievalEvalReport;
+    readonly candidate: SemanticRetrievalEvalReport;
+    readonly policy?: SemanticRetrievalQualityGatePolicy;
+}): SemanticRetrievalQualityGateResult;
+export declare function rerankTextCandidates(input: {
+    readonly query: string;
+    readonly candidates: readonly TextRerankCandidate[];
+    readonly limit: number;
+    readonly timeoutMs?: number;
+    readonly failureMode?: "fallback" | "strict";
+    readonly signal?: AbortSignal;
+}, reranker: TextReranker): Promise<TextRerankOutcome>;
 export declare function normalizeTextEmbeddingIdentity(value: TextEmbeddingIdentity): TextEmbeddingIdentity;
 export declare function textEmbeddingIdentitiesEqual(left: TextEmbeddingIdentity, right: TextEmbeddingIdentity): boolean;
 export declare function assertTextEmbeddingResult(value: TextEmbeddingResult, options: {

package/dist/semantic-retrieval.d.ts.map

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