@agent-native/creative-context 0.1.0

package/dist/embeddings/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/embeddings/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC"}

package/dist/embeddings/providers.d.ts

@@ -0,0 +1,7 @@
+import type { EmbeddingFamily } from "./types.js";
+export declare function createGeminiEmbeddingFamily(apiKey: string, dimensions?: number): EmbeddingFamily;
+export declare function createCohereEmbeddingFamily(apiKey: string, dimensions?: number): EmbeddingFamily;
+export declare function createVoyageEmbeddingFamily(apiKey: string): EmbeddingFamily;
+export declare function availableEmbeddingFamilies(): Promise<EmbeddingFamily[]>;
+export declare function defaultEmbeddingFamily(families: readonly EmbeddingFamily[]): EmbeddingFamily | null;
+//# sourceMappingURL=providers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../../src/embeddings/providers.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,eAAe,EAIhB,MAAM,YAAY,CAAC;AAkEpB,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,MAAM,EACd,UAAU,SAAqB,GAC9B,eAAe,CAsCjB;AAED,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,MAAM,EACd,UAAU,SAAqB,GAC9B,eAAe,CA6CjB;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,CAyC3E;AAED,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAW7E;AAED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,SAAS,eAAe,EAAE,GACnC,eAAe,GAAG,IAAI,CAExB"}

package/dist/embeddings/providers.js

@@ -0,0 +1,176 @@
+import { readBoundedResponseBytes } from "@agent-native/core/ingestion";
+import { resolveSecret } from "@agent-native/core/server";
+const DEFAULT_DIMENSIONS = 1024;
+function dataUrl(image) {
+    return `data:${image.mimeType};base64,${image.base64}`;
+}
+function normalizedInput(input) {
+    const text = input.text?.trim();
+    const images = input.images ?? [];
+    if (!text && images.length === 0) {
+        throw new Error("Embedding input needs text, an image, or both.");
+    }
+    return { text, images };
+}
+async function postJson(url, headers, body, providerModel) {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 30_000);
+    try {
+        const response = await fetch(url, {
+            method: "POST",
+            headers: { "Content-Type": "application/json", ...headers },
+            body: JSON.stringify(body),
+            signal: controller.signal,
+        });
+        if (!response.ok) {
+            throw new Error(`Embedding provider ${providerModel} failed with status ${response.status}.`);
+        }
+        const bytes = await readBoundedResponseBytes(response, 1_000_000);
+        return JSON.parse(new TextDecoder().decode(bytes));
+    }
+    catch (error) {
+        if (controller.signal.aborted) {
+            throw new Error(`Embedding provider ${providerModel} timed out.`);
+        }
+        throw error;
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+function numberVectors(value) {
+    if (!Array.isArray(value))
+        throw new Error("Embedding response was malformed.");
+    return value.map((vector) => {
+        if (!Array.isArray(vector) ||
+            vector.some((entry) => !Number.isFinite(entry))) {
+            throw new Error("Embedding response contained an invalid vector.");
+        }
+        return vector.map(Number);
+    });
+}
+export function createGeminiEmbeddingFamily(apiKey, dimensions = DEFAULT_DIMENSIONS) {
+    const model = "gemini-embedding-2";
+    return {
+        id: `gemini:${model}:${dimensions}`,
+        provider: "gemini",
+        model,
+        version: "stable-2026-04",
+        dimensions,
+        supportedImageMimeTypes: ["image/png", "image/jpeg"],
+        async embed(inputs, purpose) {
+            const vectors = [];
+            for (const raw of inputs) {
+                const input = normalizedInput(raw);
+                const instruction = purpose === "query"
+                    ? "task: search result | query:"
+                    : "title: none | text:";
+                const parts = [
+                    { text: `${instruction} ${input.text ?? ""}`.trim() },
+                    ...input.images.map((image) => ({
+                        inlineData: { mimeType: image.mimeType, data: image.base64 },
+                    })),
+                ];
+                const result = await postJson(`https://generativelanguage.googleapis.com/v1beta/models/${model}:embedContent`, { "x-goog-api-key": apiKey }, {
+                    content: { parts },
+                    output_dimensionality: dimensions,
+                }, `gemini/${model}`);
+                const embedding = result.embedding;
+                vectors.push(...numberVectors([embedding?.values]));
+            }
+            return vectors;
+        },
+    };
+}
+export function createCohereEmbeddingFamily(apiKey, dimensions = DEFAULT_DIMENSIONS) {
+    const model = "embed-v4.0";
+    return {
+        id: `cohere:${model}:${dimensions}`,
+        provider: "cohere",
+        model,
+        version: "v4.0",
+        dimensions,
+        supportedImageMimeTypes: [
+            "image/png",
+            "image/jpeg",
+            "image/webp",
+            "image/gif",
+        ],
+        async embed(inputs, purpose) {
+            const contentInputs = inputs.map((raw) => {
+                const input = normalizedInput(raw);
+                return {
+                    content: [
+                        ...(input.text ? [{ type: "text", text: input.text }] : []),
+                        ...input.images.map((image) => ({
+                            type: "image_url",
+                            image_url: { url: dataUrl(image) },
+                        })),
+                    ],
+                };
+            });
+            const result = await postJson("https://api.cohere.com/v2/embed", { Authorization: `Bearer ${apiKey}` }, {
+                model,
+                inputs: contentInputs,
+                input_type: purpose === "query" ? "search_query" : "search_document",
+                embedding_types: ["float"],
+                output_dimension: dimensions,
+            }, `cohere/${model}`);
+            const embeddings = result.embeddings;
+            return numberVectors(embeddings?.float ?? embeddings?.float_);
+        },
+    };
+}
+export function createVoyageEmbeddingFamily(apiKey) {
+    const model = "voyage-multimodal-3.5";
+    return {
+        id: `voyage:${model}:1024`,
+        provider: "voyage",
+        model,
+        version: "3.5",
+        dimensions: 1024,
+        supportedImageMimeTypes: [
+            "image/png",
+            "image/jpeg",
+            "image/webp",
+            "image/gif",
+        ],
+        async embed(inputs, purpose) {
+            const voyageInputs = inputs.map((raw) => {
+                const input = normalizedInput(raw);
+                return {
+                    content: [
+                        ...(input.text ? [{ type: "text", text: input.text }] : []),
+                        ...input.images.map((image) => ({
+                            type: "image_base64",
+                            image_base64: dataUrl(image),
+                        })),
+                    ],
+                };
+            });
+            const result = await postJson("https://api.voyageai.com/v1/multimodalembeddings", { Authorization: `Bearer ${apiKey}` }, {
+                model,
+                inputs: voyageInputs,
+                input_type: purpose,
+                truncation: true,
+            }, `voyage/${model}`);
+            return numberVectors(result.embeddings);
+        },
+    };
+}
+export async function availableEmbeddingFamilies() {
+    const [gemini, cohere, voyage] = await Promise.all([
+        resolveSecret("GEMINI_API_KEY").catch(() => null),
+        resolveSecret("COHERE_API_KEY").catch(() => null),
+        resolveSecret("VOYAGE_API_KEY").catch(() => null),
+    ]);
+    return [
+        ...(gemini ? [createGeminiEmbeddingFamily(gemini)] : []),
+        ...(cohere ? [createCohereEmbeddingFamily(cohere)] : []),
+        ...(voyage ? [createVoyageEmbeddingFamily(voyage)] : []),
+    ];
+}
+export function defaultEmbeddingFamily(families) {
+    return families.length === 1 ? (families[0] ?? null) : null;
+}
+//# sourceMappingURL=providers.js.map

package/dist/embeddings/providers.js.map

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

package/dist/embeddings/types.d.ts

@@ -0,0 +1,19 @@
+export type EmbeddingInputPurpose = "query" | "document";
+export interface EmbeddingImageInput {
+    mimeType: "image/png" | "image/jpeg" | "image/webp" | "image/gif";
+    base64: string;
+}
+export interface MultimodalEmbeddingInput {
+    text?: string;
+    images?: EmbeddingImageInput[];
+}
+export interface EmbeddingFamily {
+    id: string;
+    provider: "gemini" | "cohere" | "voyage" | (string & {});
+    model: string;
+    version: string;
+    dimensions: number;
+    supportedImageMimeTypes?: readonly EmbeddingImageInput["mimeType"][];
+    embed(inputs: readonly MultimodalEmbeddingInput[], purpose: EmbeddingInputPurpose): Promise<number[][]>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/embeddings/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,UAAU,CAAC;AAEzD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,WAAW,GAAG,YAAY,GAAG,YAAY,GAAG,WAAW,CAAC;IAClE,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,mBAAmB,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,uBAAuB,CAAC,EAAE,SAAS,mBAAmB,CAAC,UAAU,CAAC,EAAE,CAAC;IACrE,KAAK,CACH,MAAM,EAAE,SAAS,wBAAwB,EAAE,EAC3C,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;CACxB"}

package/dist/embeddings/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/embeddings/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/embeddings/types.ts"],"names":[],"mappings":""}

package/dist/eval/acceptance-fixtures.d.ts

@@ -0,0 +1,3 @@
+import type { ContextAcceptanceCase } from "./acceptance.js";
+export declare const CREATIVE_CONTEXT_ACCEPTANCE_CASES: readonly ContextAcceptanceCase[];
+//# sourceMappingURL=acceptance-fixtures.d.ts.map

package/dist/eval/acceptance-fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acceptance-fixtures.d.ts","sourceRoot":"","sources":["../../src/eval/acceptance-fixtures.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAQ7D,eAAO,MAAM,iCAAiC,EAAE,SAAS,qBAAqB,EAwFlE,CAAC"}

package/dist/eval/acceptance-fixtures.js

@@ -0,0 +1,84 @@
+const forbidden = [
+    "INJECTION_EXECUTED",
+    "system prompt",
+    "secret token",
+];
+export const CREATIVE_CONTEXT_ACCEPTANCE_CASES = [
+    {
+        id: "launch-scorecard-slide",
+        prompt: "Draft an executive launch scorecard slide.",
+        reference: "Launch scorecard with four KPI tiles, a purple trend line, and one sentence of interpretation for each trend.",
+        expectedContextKeys: ["upload:launch-system-v2"],
+        requiredTerms: ["four KPI tiles", "purple trend line", "interpretation"],
+        forbiddenTerms: forbidden,
+        contextOff: {
+            output: "Executive launch scorecard with key business metrics.",
+            usedContextKeys: [],
+        },
+        contextOn: {
+            output: "Launch scorecard with four KPI tiles, a purple trend line, and one sentence of interpretation for each trend.",
+            usedContextKeys: ["upload:launch-system-v2"],
+            contextPackId: "pack:launch-scorecard",
+            provenanceKeys: ["upload:launch-system-v2"],
+        },
+    },
+    {
+        id: "pricing-hero-frame",
+        prompt: "Design a pricing hero for the website.",
+        reference: "Use an ink background, Inter 56 heading, three pricing cards, and one purple Start free trial button.",
+        expectedContextKeys: ["figma:brand-system-v2"],
+        requiredTerms: ["Inter 56", "three pricing cards", "Start free trial"],
+        forbiddenTerms: forbidden,
+        contextOff: {
+            output: "A modern pricing hero with a headline, cards, and a button.",
+            usedContextKeys: [],
+        },
+        contextOn: {
+            output: "Use an ink background, Inter 56 heading, three pricing cards, and one purple Start free trial button.",
+            usedContextKeys: ["figma:brand-system-v2"],
+            contextPackId: "pack:pricing-hero",
+            provenanceKeys: ["figma:brand-system-v2"],
+        },
+    },
+    {
+        id: "launch-voice-copy",
+        prompt: "Write the launch announcement opening and CTA.",
+        reference: "Lead with the user outcome in direct active voice, support it with one verified metric, and close with one explicit trial action.",
+        expectedContextKeys: ["notion:launch-narrative-v2"],
+        requiredTerms: ["user outcome", "verified metric", "trial action"],
+        forbiddenTerms: forbidden,
+        contextOff: {
+            output: "We are thrilled to announce our revolutionary best-in-class platform. Learn more today.",
+            usedContextKeys: [],
+        },
+        contextOn: {
+            output: "Lead with the user outcome in direct active voice, support it with one verified metric, and close with one explicit trial action.",
+            usedContextKeys: ["notion:launch-narrative-v2"],
+            contextPackId: "pack:launch-voice",
+            provenanceKeys: ["notion:launch-narrative-v2"],
+        },
+    },
+    {
+        id: "rendered-campaign-page",
+        prompt: "Create a campaign page that proves adoption.",
+        reference: "Use the purple and ink palette, show activation plus 18 percent in a four-metric proof grid, and end with Start free trial.",
+        expectedContextKeys: ["web:rendered-brand-page"],
+        requiredTerms: [
+            "purple and ink",
+            "activation plus 18 percent",
+            "Start free trial",
+        ],
+        forbiddenTerms: forbidden,
+        contextOff: {
+            output: "Use an attractive palette, a collection of metrics, and a compelling call to action.",
+            usedContextKeys: [],
+        },
+        contextOn: {
+            output: "Use the purple and ink palette, show activation plus 18 percent in a four-metric proof grid, and end with Start free trial.",
+            usedContextKeys: ["web:rendered-brand-page"],
+            contextPackId: "pack:campaign-page",
+            provenanceKeys: ["web:rendered-brand-page"],
+        },
+    },
+];
+//# sourceMappingURL=acceptance-fixtures.js.map

package/dist/eval/acceptance-fixtures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"acceptance-fixtures.js","sourceRoot":"","sources":["../../src/eval/acceptance-fixtures.ts"],"names":[],"mappings":"AAEA,MAAM,SAAS,GAAG;IAChB,oBAAoB;IACpB,eAAe;IACf,cAAc;CACN,CAAC;AAEX,MAAM,CAAC,MAAM,iCAAiC,GAC5C;IACE;QACE,EAAE,EAAE,wBAAwB;QAC5B,MAAM,EAAE,4CAA4C;QACpD,SAAS,EACP,+GAA+G;QACjH,mBAAmB,EAAE,CAAC,yBAAyB,CAAC;QAChD,aAAa,EAAE,CAAC,gBAAgB,EAAE,mBAAmB,EAAE,gBAAgB,CAAC;QACxE,cAAc,EAAE,SAAS;QACzB,UAAU,EAAE;YACV,MAAM,EAAE,uDAAuD;YAC/D,eAAe,EAAE,EAAE;SACpB;QACD,SAAS,EAAE;YACT,MAAM,EACJ,+GAA+G;YACjH,eAAe,EAAE,CAAC,yBAAyB,CAAC;YAC5C,aAAa,EAAE,uBAAuB;YACtC,cAAc,EAAE,CAAC,yBAAyB,CAAC;SAC5C;KACF;IACD;QACE,EAAE,EAAE,oBAAoB;QACxB,MAAM,EAAE,wCAAwC;QAChD,SAAS,EACP,uGAAuG;QACzG,mBAAmB,EAAE,CAAC,uBAAuB,CAAC;QAC9C,aAAa,EAAE,CAAC,UAAU,EAAE,qBAAqB,EAAE,kBAAkB,CAAC;QACtE,cAAc,EAAE,SAAS;QACzB,UAAU,EAAE;YACV,MAAM,EAAE,6DAA6D;YACrE,eAAe,EAAE,EAAE;SACpB;QACD,SAAS,EAAE;YACT,MAAM,EACJ,uGAAuG;YACzG,eAAe,EAAE,CAAC,uBAAuB,CAAC;YAC1C,aAAa,EAAE,mBAAmB;YAClC,cAAc,EAAE,CAAC,uBAAuB,CAAC;SAC1C;KACF;IACD;QACE,EAAE,EAAE,mBAAmB;QACvB,MAAM,EAAE,gDAAgD;QACxD,SAAS,EACP,mIAAmI;QACrI,mBAAmB,EAAE,CAAC,4BAA4B,CAAC;QACnD,aAAa,EAAE,CAAC,cAAc,EAAE,iBAAiB,EAAE,cAAc,CAAC;QAClE,cAAc,EAAE,SAAS;QACzB,UAAU,EAAE;YACV,MAAM,EACJ,yFAAyF;YAC3F,eAAe,EAAE,EAAE;SACpB;QACD,SAAS,EAAE;YACT,MAAM,EACJ,mIAAmI;YACrI,eAAe,EAAE,CAAC,4BAA4B,CAAC;YAC/C,aAAa,EAAE,mBAAmB;YAClC,cAAc,EAAE,CAAC,4BAA4B,CAAC;SAC/C;KACF;IACD;QACE,EAAE,EAAE,wBAAwB;QAC5B,MAAM,EAAE,8CAA8C;QACtD,SAAS,EACP,6HAA6H;QAC/H,mBAAmB,EAAE,CAAC,yBAAyB,CAAC;QAChD,aAAa,EAAE;YACb,gBAAgB;YAChB,4BAA4B;YAC5B,kBAAkB;SACnB;QACD,cAAc,EAAE,SAAS;QACzB,UAAU,EAAE;YACV,MAAM,EACJ,sFAAsF;YACxF,eAAe,EAAE,EAAE;SACpB;QACD,SAAS,EAAE;YACT,MAAM,EACJ,6HAA6H;YAC/H,eAAe,EAAE,CAAC,yBAAyB,CAAC;YAC5C,aAAa,EAAE,oBAAoB;YACnC,cAAc,EAAE,CAAC,yBAAyB,CAAC;SAC5C;KACF;CACO,CAAC"}

package/dist/eval/acceptance.d.ts

@@ -0,0 +1,114 @@
+import { z } from "zod";
+export interface ContextAcceptanceArtifact {
+    output: string;
+    usedContextKeys: readonly string[];
+    contextPackId?: string | null;
+    provenanceKeys?: readonly string[];
+}
+export interface ContextAcceptanceCase {
+    id: string;
+    prompt: string;
+    reference: string;
+    expectedContextKeys: readonly string[];
+    requiredTerms: readonly string[];
+    forbiddenTerms: readonly string[];
+    contextOff: ContextAcceptanceArtifact;
+    contextOn: ContextAcceptanceArtifact;
+}
+export interface ContextAcceptanceThresholds {
+    minimumCases: number;
+    minimumContextOnWinRate: number;
+    minimumRequiredTermCoverage: number;
+    minimumMeanEditDistanceReduction: number;
+}
+export declare const ContextAcceptanceReportSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    corpusId: z.ZodString;
+    runId: z.ZodString;
+    cases: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        contextOff: z.ZodObject<{
+            outputHash: z.ZodString;
+            requiredTermCoverage: z.ZodNumber;
+            forbiddenHits: z.ZodArray<z.ZodString>;
+            editDistance: z.ZodNumber;
+            usedContextKeys: z.ZodArray<z.ZodString>;
+            contextPackId: z.ZodNullable<z.ZodString>;
+            provenanceKeys: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>;
+        contextOn: z.ZodObject<{
+            outputHash: z.ZodString;
+            requiredTermCoverage: z.ZodNumber;
+            forbiddenHits: z.ZodArray<z.ZodString>;
+            editDistance: z.ZodNumber;
+            usedContextKeys: z.ZodArray<z.ZodString>;
+            contextPackId: z.ZodNullable<z.ZodString>;
+            provenanceKeys: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>;
+        winner: z.ZodEnum<{
+            "context-off": "context-off";
+            "context-on": "context-on";
+            tie: "tie";
+        }>;
+        contextPackRecorded: z.ZodBoolean;
+        provenanceComplete: z.ZodBoolean;
+        optOutStructurallyClean: z.ZodBoolean;
+    }, z.core.$strip>>;
+    summary: z.ZodObject<{
+        caseCount: z.ZodNumber;
+        contextOnWins: z.ZodNumber;
+        contextOffWins: z.ZodNumber;
+        ties: z.ZodNumber;
+        contextOnWinRate: z.ZodNumber;
+        contextOnRequiredTermCoverage: z.ZodNumber;
+        meanEditDistanceReduction: z.ZodNumber;
+        forbiddenOutputHits: z.ZodNumber;
+        missingContextPacks: z.ZodNumber;
+        missingProvenance: z.ZodNumber;
+        optOutContamination: z.ZodNumber;
+    }, z.core.$strip>;
+    thresholds: z.ZodObject<{
+        minimumCases: z.ZodNumber;
+        minimumContextOnWinRate: z.ZodNumber;
+        minimumRequiredTermCoverage: z.ZodNumber;
+        minimumMeanEditDistanceReduction: z.ZodNumber;
+    }, z.core.$strip>;
+    gates: z.ZodObject<{
+        passed: z.ZodBoolean;
+        failures: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>;
+    manualBlindPreference: z.ZodObject<{
+        status: z.ZodEnum<{
+            complete: "complete";
+            pending: "pending";
+        }>;
+        scoredTrials: z.ZodNumber;
+        contextOnPreferenceRate: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type ContextAcceptanceReport = z.infer<typeof ContextAcceptanceReportSchema>;
+export declare function runContextAcceptanceEvaluation(input: {
+    corpusId: string;
+    cases: readonly ContextAcceptanceCase[];
+    thresholds?: Partial<ContextAcceptanceThresholds>;
+}): ContextAcceptanceReport;
+export declare function assertContextAcceptanceGates(report: ContextAcceptanceReport): void;
+export interface BlindPreferenceWorksheetRow {
+    caseId: string;
+    prompt: string;
+    candidateA: string;
+    candidateB: string;
+}
+export interface BlindPreferenceAnswerKey {
+    caseId: string;
+    contextOnCandidate: "A" | "B";
+}
+export declare function createBlindPreferencePacket(cases: readonly ContextAcceptanceCase[]): {
+    worksheet: BlindPreferenceWorksheetRow[];
+    answerKey: BlindPreferenceAnswerKey[];
+};
+export declare function scoreBlindPreferences(answerKey: readonly BlindPreferenceAnswerKey[], scores: Readonly<Record<string, "A" | "B" | "tie">>): {
+    scoredTrials: number;
+    contextOnPreferenceRate: number;
+};
+//# sourceMappingURL=acceptance.d.ts.map

package/dist/eval/acceptance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acceptance.d.ts","sourceRoot":"","sources":["../../src/eval/acceptance.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,UAAU,EAAE,yBAAyB,CAAC;IACtC,SAAS,EAAE,yBAAyB,CAAC;CACtC;AAED,MAAM,WAAW,2BAA2B;IAC1C,YAAY,EAAE,MAAM,CAAC;IACrB,uBAAuB,EAAE,MAAM,CAAC;IAChC,2BAA2B,EAAE,MAAM,CAAC;IACpC,gCAAgC,EAAE,MAAM,CAAC;CAC1C;AAmBD,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAwCxC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAC3C,OAAO,6BAA6B,CACrC,CAAC;AAuDF,wBAAgB,8BAA8B,CAAC,KAAK,EAAE;IACpD,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACxC,UAAU,CAAC,EAAE,OAAO,CAAC,2BAA2B,CAAC,CAAC;CACnD,GAAG,uBAAuB,CA6H1B;AAED,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,uBAAuB,GAC9B,IAAI,CAON;AAED,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB,EAAE,GAAG,GAAG,GAAG,CAAC;CAC/B;AAED,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,SAAS,qBAAqB,EAAE,GACtC;IACD,SAAS,EAAE,2BAA2B,EAAE,CAAC;IACzC,SAAS,EAAE,wBAAwB,EAAE,CAAC;CACvC,CA0BA;AAED,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,SAAS,wBAAwB,EAAE,EAC9C,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,GAAG,GAAG,GAAG,KAAK,CAAC,CAAC,GAClD;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,uBAAuB,EAAE,MAAM,CAAA;CAAE,CAe3D"}