@rudra-js/core 0.7.4 → 0.7.6

package/README.md

@@ -1,7 +1,16 @@
 # @rudra-js/core
 
-The contracts and logic that turn one tracking payload into one renderable
-component specification.
+This package is part of [rudra-js](https://rudrajs.com).
+
+rudra-js is an open-source TypeScript library (MIT) you install from npm. A language model designs one product-recommendation block for a page in your shop, rudra-js checks it against your catalog, and React renders it.
+
+It is not a hosted platform, a visual or low-code app builder, or a workspace you sign up for.
+
+You give this package one page view: the shopper and what they've been doing,
+the page they're on, and the products you're willing to show. It gives back a
+specification for the recommendations on that page, written by your model or
+built without one, and checked against those products. There's no React in it.
+`@rudra-js/react` turns the specification into markup.
 
 Every export of this package is documented at [rudrajs.com](https://rudrajs.com/docs).
 
@@ -55,8 +64,9 @@ appear, that's why. It isn't your catalog.
 
 Want to render a spec you wrote yourself, still without a model? Pass
 `createFixedSpecProvider(spec)` as the provider and it answers every request with
-that spec. That's how our tests exercise the blocks the deterministic component
-never emits.
+that spec. It still goes through reconciliation, so it needs a headline that
+survives screening and at least one product on show, or you get the
+deterministic component.
 
 ## Options
 

package/dist/claim-screening.d.ts

@@ -1,10 +1,10 @@
-import type { Product, TrackingInput } from './tracking-input.js';
+import type { TrackingInput } from './tracking-input.js';
 export declare const ALLOWED_PHRASES: string[];
-export declare function productFacts(product: Product): string[];
+export declare const NO_FACTS: readonly string[];
 export interface HostFacts {
     pooled: string[];
     bySku: Map<string, string[]>;
 }
 export declare function hostFacts(input: TrackingInput): HostFacts;
-export declare function claimIn(text: string): string | null;
+export declare function unbackedClaim(raw: string, clamped: string, facts: readonly string[]): string | null;
 //# sourceMappingURL=claim-screening.d.ts.map

package/dist/claim-screening.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"claim-screening.d.ts","sourceRoot":"","sources":["../src/claim-screening.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAoKlE,eAAO,MAAM,eAAe,UAK3B,CAAC;AAIF,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,EAAE,CAOvD;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAC9B;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,CAWzD;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAWnD"}
+{"version":3,"file":"claim-screening.d.ts","sourceRoot":"","sources":["../src/claim-screening.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AA4EzD,eAAO,MAAM,eAAe,UAK3B,CAAC;AAKF,eAAO,MAAM,QAAQ,EAAE,SAAS,MAAM,EAAO,CAAC;AAE9C,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAC9B;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,CAWzD;AAaD,wBAAgB,aAAa,CAC3B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,SAAS,MAAM,EAAE,GACvB,MAAM,GAAG,IAAI,CASf"}

package/dist/claim-screening.js

@@ -1,3 +1,4 @@
+import { foldLookalikes, verify } from '@rudra-js/attested';
 import { offeredCandidates } from './model-prompt.js';
 const CLAIM_PATTERNS = [
     {
@@ -10,7 +11,8 @@ const CLAIM_PATTERNS = [
             /\bratings?\s+of\s+[0-5]\.\d\b/,
             /\b[0-5](?:\.\d)?\s+out of\s+(?:5|five)\b/,
             /\b(?:highly|top|best|well|poorly|five|four)[\s-]rated\b/,
-            /\brated\s+(?:[0-5]\.\d|(?:[0-5]|three|four|five)\s+(?:stars?|out of))\b/,
+            /\brated\s+[0-5]\.\d\b/,
+            /\brated\s+(?:[0-5]|three|four|five)\s+(?:stars?|out of)\b/,
             /\bbest[\s-]?sell(?:er|ers|ing)\b/,
             /(?:\bnumber one|\bno\.? ?1|#\s?1)[\s-]?sell(?:er|ers|ing)\b/,
             /\bloved by (?:thousands|hundreds|millions|\d)/,
@@ -43,7 +45,10 @@ const CLAIM_PATTERNS = [
             /\bhalf[\s-]?(?:price|off)\b/,
             /\bsaves?\s+\d[\d.,]*\s+off\b/,
             /\bclearance\s+(?:sale|price|event|deal)\b|\bon clearance\b/,
-            /\bprice reduced\b|\breduced price\b|\breduced by \d+\s?(?:%|percent)|\breduced\s+(?:this|next|last)\s+week\b/,
+            /\bprice reduced\b/,
+            /\breduced price\b/,
+            /\breduced by \d+\s?(?:%|percent)/,
+            /\breduced\s+(?:this|next|last)\s+week\b/,
         ],
     },
     {
@@ -68,114 +73,46 @@ const CLAIM_PATTERNS = [
         ],
     },
 ];
-const CONFUSABLES = {
-    а: 'a',
-    в: 'b',
-    е: 'e',
-    к: 'k',
-    м: 'm',
-    н: 'h',
-    о: 'o',
-    р: 'p',
-    с: 'c',
-    т: 't',
-    х: 'x',
-    у: 'y',
-    ѕ: 's',
-    і: 'i',
-    ј: 'j',
-    ԁ: 'd',
-    һ: 'h',
-    ӏ: 'l',
-    α: 'a',
-    ε: 'e',
-    ι: 'i',
-    κ: 'k',
-    ν: 'v',
-    ο: 'o',
-    ρ: 'p',
-    τ: 't',
-    υ: 'u',
-    χ: 'x',
-    ϳ: 'j',
-    ѵ: 'v',
-};
-// Capitals that lowercasing reads wrong: Ν becomes ν, which reads as v.
-const CAPITALS = {
-    Β: 'b',
-    Ζ: 'z',
-    Η: 'h',
-    Μ: 'm',
-    Ν: 'n',
-    Υ: 'y',
-    Ү: 'y',
-    Ӏ: 'i',
-    Ԛ: 'q',
-    Ԝ: 'w',
-    Ϻ: 'm',
-    Ϝ: 'f',
-    Ԍ: 'g',
-};
-const INVISIBLE = /[\p{Cf}\p{Default_Ignorable_Code_Point}\p{Cc}]/gu;
-const SPACING = /[\t\n\v\f\r\u0085]/;
-const MARKS = /[\p{Mn}\p{Me}]/gu;
-function normaliseForClaims(text, byLook) {
-    // NFKC would turn the lunate sigmas into ς and Σ, which the fold can't read as c.
-    const compatible = text
-        .replace(INVISIBLE, (char) => (SPACING.test(char) ? char : ''))
-        .replace(/[ϲϹ]/g, 'c')
-        .normalize('NFKC');
-    let cased = compatible;
-    if (byLook) {
-        cased = '';
-        for (const char of compatible)
-            cased += CAPITALS[char] ?? char;
-    }
-    const lowered = cased.toLowerCase().normalize('NFC').replace(MARKS, '');
-    let folded = '';
-    for (const char of lowered)
-        folded += CONFUSABLES[char] ?? char;
-    return folded;
-}
 export const ALLOWED_PHRASES = [
     'does not feel cheap',
     "doesn't feel cheap",
     'last few miles',
     'sustainable pace',
 ];
-const DIGIT = /\p{Nd}/u;
-export function productFacts(product) {
-    const facts = [];
-    if (DIGIT.test(product.category))
-        facts.push(product.category);
-    for (const tag of product.tags) {
-        if (DIGIT.test(tag))
-            facts.push(tag);
-    }
-    return facts;
-}
+const FACT_DIGIT = /\p{Nd}/u;
+const NUMERAL = /[\p{Nd}\p{No}\p{Nl}]/u;
+export const NO_FACTS = [];
 export function hostFacts(input) {
     const pooled = new Set();
     const bySku = new Map();
     for (const product of offeredCandidates(input)) {
-        const own = productFacts(product);
+        const own = [product.category, ...product.tags].filter((text) => FACT_DIGIT.test(text));
         bySku.set(product.sku, own);
         for (const fact of own)
             pooled.add(fact);
     }
     return { pooled: [...pooled], bySku };
 }
-export function claimIn(text) {
-    // Read twice, since Ν reads as N but ν as v.
-    for (const byLook of [false, true]) {
-        const normalised = normaliseForClaims(text, byLook);
-        for (const claim of CLAIM_PATTERNS) {
-            for (const pattern of claim.patterns) {
-                if (pattern.test(normalised))
-                    return claim.kind;
-            }
-        }
+function kindIn(reading) {
+    for (const claim of CLAIM_PATTERNS) {
+        if (claim.patterns.some((pattern) => pattern.test(reading)))
+            return claim.kind;
     }
     return null;
 }
+function claimIn(text) {
+    return kindIn(foldLookalikes(text)) ?? kindIn(foldLookalikes(text, true));
+}
+export function unbackedClaim(raw, clamped, facts) {
+    const kind = claimIn(raw) ?? claimIn(clamped);
+    if (kind !== null)
+        return kind;
+    const values = NUMERAL.test(clamped) ? facts : NO_FACTS;
+    const result = verify(clamped, { values, allowedPhrases: ALLOWED_PHRASES });
+    if (!result.quantity.supported)
+        return 'quantity';
+    if (!result.wording.supported)
+        return 'wording';
+    return null;
+}
 //# sourceMappingURL=claim-screening.js.map

package/dist/claim-screening.js.map

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

package/dist/component-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"component-generator.d.ts","sourceRoot":"","sources":["../src/component-generator.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,aAAa,EAClB,KAAK,cAAc,EAEnB,KAAK,UAAU,EAChB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEnE,OAAO,EAAkB,KAAK,SAAS,EAAoB,MAAM,wBAAwB,CAAC;AAG1F,OAAO,EAKL,KAAK,SAAS,EACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,MAAM,EAAE,UAAU,CAAC;IAEnB,SAAS,EAAE,MAAM,CAAC;IAElB,WAAW,EAAE,OAAO,CAAC;IAErB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;CAC9C;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAEpC,KAAK,CAAC,EAAE,SAAS,CAAC;IAElB,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,UAAU,CAAC,EAAE,QAAQ,GAAG,aAAa,CAAC;IAEtC,IAAI,CAAC,EAAE,SAAS,CAAC;IAEjB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;CAC5C;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAE5D,qBAAqB,CAAC,KAAK,EAAE,kBAAkB,GAAG,aAAa,CAAC;CACjE;AAED,qBAAa,YAAa,SAAQ,KAAK;IACrC,YAAY,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAG9C;CACF;AAkGD,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,yBAA8B,GACtC,kBAAkB,CA2LpB"}
+{"version":3,"file":"component-generator.d.ts","sourceRoot":"","sources":["../src/component-generator.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,cAAc,EAEnB,KAAK,UAAU,EAChB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEnE,OAAO,EAAkB,KAAK,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAGxE,OAAO,EAIL,KAAK,SAAS,EACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;CAC9C;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACpC,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,QAAQ,GAAG,aAAa,CAAC;IACtC,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;CAC5C;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAC5D,qBAAqB,CAAC,KAAK,EAAE,kBAAkB,GAAG,aAAa,CAAC;CACjE;AAED,qBAAa,YAAa,SAAQ,KAAK;IACrC,YAAY,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAG9C;CACF;AAuGD,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,yBAA8B,GACtC,kBAAkB,CAgBpB"}

package/dist/component-generator.js

@@ -6,7 +6,7 @@ import { bundleForShopper, capBlocks, placeableHeroSkus, reconcileSpec } from '.
 import { selectProducts } from './product-selection.js';
 import { fitToShopper } from './fit-to-shopper.js';
 import { buildDigest, toCohortDigest } from './signal-digest.js';
-import { createMemorySpecCache, cohortCacheKey, specCacheKey, } from './spec-cache.js';
+import { createMemorySpecCache, specCacheKey, } from './spec-cache.js';
 import { parseTrackingInput, } from './tracking-input.js';
 export class TimeoutError extends Error {
     constructor(label, milliseconds) {
@@ -35,20 +35,6 @@ async function withinBudget(label, milliseconds, start) {
         clearTimeout(timer);
     }
 }
-function createSingleFlight() {
-    const inFlight = new Map();
-    return {
-        isRunning: (key) => inFlight.has(key),
-        run(key, task) {
-            const existing = inFlight.get(key);
-            if (existing)
-                return existing;
-            const started = task().finally(() => inFlight.delete(key));
-            inFlight.set(key, started);
-            return started;
-        },
-    };
-}
 const cachedSpecSchema = z.object({
     spec: generatedSpecSchema,
     generatedAt: z.number(),
@@ -56,183 +42,182 @@ const cachedSpecSchema = z.object({
 function fitCohortSpec(spec, input, digest, rank) {
     const picks = selectProducts(input, digest, { rank });
     const blocks = capBlocks(spec.blocks);
-    let hasBundleBlock = false;
-    const aboveBundle = [];
-    for (const block of blocks) {
-        if (block.kind === 'bundle') {
-            hasBundleBlock = true;
-            break;
-        }
-        aboveBundle.push(block);
-    }
-    if (!hasBundleBlock)
+    const bundleAt = blocks.findIndex((block) => block.kind === 'bundle');
+    if (bundleAt === -1)
         return fitToShopper(spec, picks, digest.maxItems);
-    const chosen = bundleForShopper(input, digest, placeableHeroSkus(aboveBundle, input));
-    if (!chosen)
+    const heroesAbove = placeableHeroSkus(blocks.slice(0, bundleAt), input);
+    const bundle = bundleForShopper(input, digest, heroesAbove);
+    if (!bundle)
         return fitToShopper(spec, picks, digest.maxItems);
-    const spokenFor = new Set(chosen.skus);
+    const spokenFor = new Set(bundle.skus);
     for (const sku of placeableHeroSkus(blocks, input))
         spokenFor.add(sku);
     const roomLeft = digest.maxItems - spokenFor.size;
     if (roomLeft <= 0)
         return fitToShopper(spec, picks, digest.maxItems);
-    const forGrid = [];
-    for (const pick of picks) {
-        if (!spokenFor.has(pick.product.sku))
-            forGrid.push(pick);
-    }
+    const forGrid = picks.filter((pick) => !spokenFor.has(pick.product.sku));
     return fitToShopper(spec, forGrid, roomLeft);
 }
 export function createComponentGenerator(options = {}) {
-    const provider = options.provider ?? null;
-    const cache = options.cache ?? createMemorySpecCache();
-    const generation = options.generation ?? 'cohort';
-    const rank = options.rank ?? 'signals';
-    const modelTimeoutMs = options.modelTimeoutMs ?? 1_500;
-    const cacheTimeoutMs = options.cacheTimeoutMs ?? 50;
-    const singleFlight = createSingleFlight();
-    const report = (event) => {
-        if (!options.onEvent)
-            return;
-        try {
-            options.onEvent(event);
-        }
-        catch { }
+    const settings = {
+        options,
+        provider: options.provider ?? null,
+        cache: options.cache ?? createMemorySpecCache(),
+        generation: options.generation ?? 'cohort',
+        rank: options.rank ?? 'signals',
+        modelTimeoutMs: options.modelTimeoutMs ?? 1_500,
+        cacheTimeoutMs: options.cacheTimeoutMs ?? 50,
+        inFlight: new Map(),
     };
-    const buildDeterministic = (input, digest, startedAt, key, degradedReason, modelCall = {
-        calledModel: false,
-    }) => {
-        const finishedAt = Date.now();
-        report({
-            key,
-            source: 'fallback',
-            elapsedMs: finishedAt - startedAt,
-            ...modelCall,
-            degradedReason,
-        });
-        return {
-            ...buildFallbackSpec(input, digest, { rank }),
-            specVersion: SPEC_VERSION,
-            slot: digest.slot,
-            source: 'fallback',
-            generatedAt: finishedAt,
-            latencyMs: finishedAt - startedAt,
-            provider: null,
-            model: null,
-            degradedReason,
-        };
+    return {
+        generate: (draft) => generate(settings, draft),
+        generateDeterministic: (draft) => generateDeterministic(settings, draft),
     };
-    const readCache = async (key) => {
-        try {
-            const stored = await withinBudget('cache read', cacheTimeoutMs, () => cache.get(key));
-            const parsed = cachedSpecSchema.safeParse(stored);
-            return parsed.success ? { outcome: 'hit', entry: parsed.data } : { outcome: 'miss' };
-        }
-        catch (error) {
-            return { outcome: error instanceof TimeoutError ? 'timeout' : 'error' };
-        }
+}
+async function generate(settings, draft) {
+    const run = startRun(settings, draft);
+    const provider = settings.provider;
+    if (!provider)
+        return fallback(settings, run, null, 'no-provider');
+    const key = cacheKeyFor(provider, run);
+    const found = await findSpec(settings, provider, run, key);
+    if ('failed' in found)
+        return fallback(settings, run, key, found.failed, eventDetails(found.trace));
+    const reconciled = shapeForShopper(settings, run, found.spec);
+    const details = eventDetails(found.trace, reconciled.violations);
+    if (!reconciled.isUsable)
+        return fallback(settings, run, key, 'unusable-on-serve', details);
+    const finishedAt = Date.now();
+    report(settings, {
+        key,
+        source: found.source,
+        elapsedMs: finishedAt - run.startedAt,
+        ...details,
+    });
+    return {
+        ...reconciled.spec,
+        specVersion: SPEC_VERSION,
+        slot: run.digest.slot,
+        source: found.source,
+        generatedAt: found.generatedAt,
+        latencyMs: finishedAt - run.startedAt,
+        provider: provider.name,
+        model: provider.model,
     };
-    const storeInBackground = (key, cached) => {
-        void Promise.resolve()
-            .then(() => cache.set(key, cached))
-            .catch(() => { });
+}
+function generateDeterministic(settings, draft) {
+    return fallback(settings, startRun(settings, draft), null, 'requested');
+}
+function startRun(settings, draft) {
+    const startedAt = Date.now();
+    const input = parseTrackingInput(draft);
+    const digest = buildDigest(input);
+    const promptDigest = settings.generation === 'cohort' ? toCohortDigest(digest) : digest;
+    return { input, digest, promptDigest, startedAt };
+}
+function cacheKeyFor(provider, run) {
+    const identity = { name: provider.name, model: provider.model };
+    const skus = run.input.candidates.map((product) => product.sku);
+    return specCacheKey(run.promptDigest, skus, identity);
+}
+async function findSpec(settings, provider, run, key) {
+    const read = await readCache(settings, key);
+    if (read.entry) {
+        const trace = { calledModel: false, cache: read.outcome, usage: undefined };
+        return { spec: read.entry.spec, generatedAt: read.entry.generatedAt, source: 'cache', trace };
+    }
+    const calledModel = !settings.inFlight.has(key);
+    let call;
+    try {
+        call = await sharedCall(settings, key, () => askModel(settings, provider, run));
+    }
+    catch (error) {
+        const failed = error instanceof TimeoutError ? 'timeout' : 'provider-error';
+        return { failed, trace: { calledModel, cache: read.outcome, usage: undefined, error } };
+    }
+    const trace = { calledModel, cache: read.outcome, usage: call.usage };
+    if (!call.spec)
+        return { failed: 'invalid-generation', trace };
+    const generatedAt = Date.now();
+    if (calledModel)
+        storeInBackground(settings, key, { spec: call.spec, generatedAt });
+    return { spec: call.spec, generatedAt, source: 'llm', trace };
+}
+async function readCache(settings, key) {
+    try {
+        const stored = await withinBudget('cache read', settings.cacheTimeoutMs, () => settings.cache.get(key));
+        const parsed = cachedSpecSchema.safeParse(stored);
+        return parsed.success ? { outcome: 'hit', entry: parsed.data } : { outcome: 'miss' };
+    }
+    catch (error) {
+        return { outcome: error instanceof TimeoutError ? 'timeout' : 'error' };
+    }
+}
+async function askModel(settings, provider, run) {
+    const { system, user } = buildPrompt(run.input, run.promptDigest);
+    const result = await withinBudget('generation', settings.modelTimeoutMs, (signal) => provider.generate({ system, user, schema: generatedSpecSchema, signal }));
+    const parsed = generatedSpecSchema.safeParse(result.spec);
+    return {
+        spec: parsed.success ? parsed.data : null,
+        ...(result.usage ? { usage: result.usage } : {}),
     };
-    const askModel = async (active, input, promptDigest) => {
-        const { system, user } = buildPrompt(input, promptDigest);
-        const result = await withinBudget('generation', modelTimeoutMs, (signal) => active.generate({ system, user, schema: generatedSpecSchema, signal }));
-        const parsed = generatedSpecSchema.safeParse(result.spec);
-        return {
-            spec: parsed.success ? parsed.data : null,
-            ...(result.usage ? { usage: result.usage } : {}),
-        };
+}
+function sharedCall(settings, key, ask) {
+    const running = settings.inFlight.get(key);
+    if (running)
+        return running;
+    const started = ask().finally(() => settings.inFlight.delete(key));
+    settings.inFlight.set(key, started);
+    return started;
+}
+function storeInBackground(settings, key, cached) {
+    void Promise.resolve()
+        .then(() => settings.cache.set(key, cached))
+        .catch(() => { });
+}
+function shapeForShopper(settings, run, spec) {
+    if (settings.generation !== 'cohort') {
+        return reconcileSpec(spec, run.input, run.digest, new Map());
+    }
+    const fitted = fitCohortSpec(spec, run.input, run.digest, settings.rank);
+    return reconcileSpec(fitted.spec, run.input, run.digest, fitted.ourReasons);
+}
+function fallback(settings, run, key, degradedReason, details = { calledModel: false }) {
+    const finishedAt = Date.now();
+    report(settings, {
+        key,
+        source: 'fallback',
+        elapsedMs: finishedAt - run.startedAt,
+        ...details,
+        degradedReason,
+    });
+    return {
+        ...buildFallbackSpec(run.input, run.digest, { rank: settings.rank }),
+        specVersion: SPEC_VERSION,
+        slot: run.digest.slot,
+        source: 'fallback',
+        generatedAt: finishedAt,
+        latencyMs: finishedAt - run.startedAt,
+        provider: null,
+        model: null,
+        degradedReason,
     };
+}
+function eventDetails(trace, violations) {
     return {
-        generateDeterministic(draft) {
-            const startedAt = Date.now();
-            const input = parseTrackingInput(draft);
-            return buildDeterministic(input, buildDigest(input), startedAt, null, 'requested');
-        },
-        async generate(draft) {
-            const startedAt = Date.now();
-            const input = parseTrackingInput(draft);
-            const digest = buildDigest(input);
-            if (!provider) {
-                return buildDeterministic(input, digest, startedAt, null, 'no-provider');
-            }
-            const identity = { name: provider.name, model: provider.model };
-            const candidateSkus = input.candidates.map((product) => product.sku);
-            const key = generation === 'cohort'
-                ? cohortCacheKey(digest, candidateSkus, identity)
-                : specCacheKey(digest, candidateSkus, identity);
-            const read = await readCache(key);
-            const cached = read.entry;
-            let calledModel = false;
-            let answer;
-            let generatedAt;
-            if (cached) {
-                answer = { spec: cached.spec };
-                generatedAt = cached.generatedAt;
-            }
-            else {
-                calledModel = !singleFlight.isRunning(key);
-                let call;
-                try {
-                    call = await singleFlight.run(key, () => askModel(provider, input, generation === 'cohort' ? toCohortDigest(digest) : digest));
-                }
-                catch (error) {
-                    const reason = error instanceof TimeoutError ? 'timeout' : 'provider-error';
-                    return buildDeterministic(input, digest, startedAt, key, reason, {
-                        calledModel,
-                        cache: read.outcome,
-                        error,
-                    });
-                }
-                if (!call.spec) {
-                    return buildDeterministic(input, digest, startedAt, key, 'invalid-generation', {
-                        calledModel,
-                        cache: read.outcome,
-                        ...(call.usage ? { usage: call.usage } : {}),
-                    });
-                }
-                answer = { spec: call.spec, ...(call.usage ? { usage: call.usage } : {}) };
-                generatedAt = Date.now();
-                if (calledModel)
-                    storeInBackground(key, { spec: answer.spec, generatedAt });
-            }
-            const { spec: served, ourReasons } = generation === 'cohort'
-                ? fitCohortSpec(answer.spec, input, digest, rank)
-                : { spec: answer.spec, ourReasons: new Map() };
-            const reconciled = reconcileSpec(served, input, digest, ourReasons);
-            if (!reconciled.isUsable) {
-                return buildDeterministic(input, digest, startedAt, key, 'unusable-on-serve', {
-                    calledModel,
-                    cache: read.outcome,
-                    violations: reconciled.violations,
-                    ...(answer.usage ? { usage: answer.usage } : {}),
-                });
-            }
-            const finishedAt = Date.now();
-            const source = cached ? 'cache' : 'llm';
-            report({
-                key,
-                source,
-                elapsedMs: finishedAt - startedAt,
-                calledModel,
-                cache: read.outcome,
-                violations: reconciled.violations,
-                ...(answer.usage ? { usage: answer.usage } : {}),
-            });
-            return {
-                ...reconciled.spec,
-                specVersion: SPEC_VERSION,
-                slot: digest.slot,
-                source,
-                generatedAt,
-                latencyMs: finishedAt - startedAt,
-                provider: provider.name,
-                model: provider.model,
-            };
-        },
+        calledModel: trace.calledModel,
+        cache: trace.cache,
+        ...(violations ? { violations } : {}),
+        ...(trace.usage ? { usage: trace.usage } : {}),
+        ...('error' in trace ? { error: trace.error } : {}),
     };
 }
+function report(settings, event) {
+    if (!settings.options.onEvent)
+        return;
+    try {
+        settings.options.onEvent(event);
+    }
+    catch { }
+}
 //# sourceMappingURL=component-generator.js.map