@rudra-js/core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Clive Dsouza
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,189 @@
+# @rudra-js/core
+
+The contracts and logic that turn one tracking payload into one renderable
+component specification.
+
+## Install
+
+```sh
+npm install @rudra-js/core zod@^4
+```
+
+`zod` is a peer dependency: the package's public API _is_ zod schemas, so your
+application and this package must resolve the same zod instance. **zod 4 is
+required** — the schemas use zod 4 APIs, and installing into a zod 3 app fails
+with `ERESOLVE` rather than anything more helpful.
+
+## Running without a model
+
+`createComponentGenerator` takes a `provider`. Leave it out, or pass `null`, and
+nothing calls a model and nothing is billed:
+
+```ts
+const generator = createComponentGenerator({ provider: null });
+const spec = await generator.generate(input);
+```
+
+That is a supported configuration rather than a stub. It is the control arm of
+the benchmark, and the right setting for anyone who has not yet decided on a
+provider. `generate` returns a promise either way, so the shape of your code
+does not change when you add one.
+
+The deterministic component emits exactly one **grid** block — or nothing, when
+no candidate is in stock — with a headline from a fixed set of four. Every other
+block kind in the vocabulary (hero, carousel, banner, copy, bundle) only ever
+comes from a model. If you are wiring bundles and none appear, that is why, and
+not your catalog.
+
+To render a spec you wrote yourself, without a model, pass
+`createFixedSpecProvider(spec)` as the provider. It answers every request with
+that spec, which is how the tests exercise blocks the deterministic component
+never emits.
+
+## `tracking-input`
+
+The boundary between a host application and rudra-js. rudra-js collects,
+stores and aggregates nothing — the host owns its tracking pipeline and hands
+the framework one JSON object per render.
+
+```ts
+import { parseTrackingInput } from '@rudra-js/core';
+
+const input = parseTrackingInput({
+  user: { id: 'shopper-1' },
+  context: { surface: 'pdp', currentSku: 'TR-102' },
+  signals: {
+    likes: [{ sku: 'TR-104' }],
+    recentSearches: ['waterproof trail shoe'],
+  },
+  candidates: [
+    {
+      sku: 'TR-102',
+      title: 'Switchback Trail Shoe GTX',
+      category: 'Trail Running',
+      price: 174,
+      imageUrl: 'https://cdn.example.com/tr-102.png', // or '/images/tr-102.png'
+    },
+  ],
+});
+```
+
+`parseTrackingInput` throws a `ZodError`; `safeParseTrackingInput` returns a
+`TrackingInputResult` instead, so a host can inspect `result.error.issues`
+without importing zod itself.
+
+### Cold start is not an error
+
+A payload with no `signals` block is a first-time visitor, not a malformed
+request. Every category defaults to `[]`, so the host needs no special case.
+
+### What the host must supply
+
+`user.id`, `context.surface`, and at least one entry in `candidates`.
+`candidates` is the merchandising boundary: whatever the host leaves out cannot
+be recommended, which is what makes it impossible to surface a product that
+does not exist or is not merchandised for this shopper. SKUs must be unique.
+
+`bundles` is optional: the sets the shop sells together, each with the shop's
+own price for the set, the currency that price is in, and, if you want one,
+your own name for it. Every product in a set must also be a candidate — that is
+what lets the same checks that pass a single product pass a whole set, and what
+lets the renderer look the members up in the catalog it already has. Ids must be
+unique, and one set must not name the same product twice.
+
+The model never picks a set and is never told a price. It only asks for a
+bundle block and writes the words around it; the framework picks which set when
+the page is served, from what the shopper has in their basket, has looked at,
+or is browsing now.
+
+Every word the model writes is read for claims: the headline, the subheadline,
+a hero, a banner, a block title, the copy block, the reason under a product,
+and the words around the set. Text you supplied is never read this way — a
+product title, a category and a bundle `label` are your words, not the model's.
+
+The framework drops text that makes a claim it cannot check. It looks for
+money, a customer score, a delivery date and a count of what is left, and it
+leaves a specification alone even when the specification has a number in it.
+Spotting one is not a guarantee, the way checking a price against your catalog
+is. A field that cannot be empty — a headline, a banner's text — is emptied
+instead of nulled, so the block drops the way any block with no text drops, and
+an emptied page headline makes the whole generation unusable.
+
+For the set the prompt also tells the model to write about the offer, not the
+products in it, and never to say the set saves money or by how much. Pass a
+`label` on the bundle to put your own words on the set: a label is text you
+wrote, not text the model wrote, and it renders ahead of the model's words.
+
+### Defaults
+
+| Field                      | Default             |
+| -------------------------- | ------------------- |
+| `schemaVersion`            | `'1'`               |
+| `context.slot`             | `'recommendations'` |
+| `context.locale`           | `'en-US'`           |
+| `context.maxItems`         | `4`                 |
+| `candidates[].currency`    | `'USD'`             |
+| `candidates[].isInStock`   | `true`              |
+| `candidates[].tags`        | `[]`                |
+| `signals.*`                | `[]`                |
+| `bundles`                  | `[]`                |
+| `bundles[].currency`       | `'USD'`             |
+| `mostViewed[].views`       | `1`                 |
+| `lastPurchased[].quantity` | `1`                 |
+
+### Cohorts
+
+By default one generated component is shared between shoppers who look alike,
+and each shopper's own products are filled in per request. A cohort is the
+shopper's segment, the surface and slot, the locale, the item count, whether
+they are a first-time visitor, and the category they lean towards. Everything
+that makes a person an individual — who they are, what they liked, viewed or
+searched for — is left out, which is what lets many page views reuse one call.
+
+The candidate list is part of the cohort too, because the model is shown those
+products and writes about them. In most shops candidates come from the page, so
+everyone looking at it shares them. A shop that picks candidates per shopper
+gets smaller cohorts, which is the honest outcome: its prompt really is
+personal.
+
+Pass `generation: 'per-shopper'` to generate for the individual instead. Then
+the model chooses the products too, and every shopper pays for their own call.
+
+```ts
+createComponentGenerator({ provider, generation: 'per-shopper' });
+```
+
+### Limits
+
+Every free-text field and every array is capped, because host strings end up
+inside a model prompt and a model is billed per token. The caps live in
+`FIELD_LIMITS` and are exported, so a host can validate against the same
+numbers rather than discovering them from a rejection.
+
+| Limit                | Value | Applies to                                                          |
+| -------------------- | ----- | ------------------------------------------------------------------- |
+| `identifier`         | 128   | `sku`, `category`, `surface`, `slot`, `interaction.type`, meta keys |
+| `shortText`          | 200   | `title`, `imageUrl`, `interaction.value`, meta values               |
+| `searchQuery`        | 200   | `context.searchQuery`, `recentSearches[]`                           |
+| `tag`                | 64    | `tags[]`                                                            |
+| `tagsPerProduct`     | 20    | `tags`                                                              |
+| `metaEntries`        | 50    | `interaction.meta`                                                  |
+| `signalsPerCategory` | 500   | each array under `signals`                                          |
+| `candidates`         | 200   | `candidates`                                                        |
+| `productsPerBundle`  | 5     | `bundles[].skus`, which also needs at least 2                       |
+| `bundles`            | 20    | `bundles`                                                           |
+
+These bound each field individually; they are not an aggregate prompt budget.
+Fitting a payload into a context window is `digest`'s job, and it trims rather
+than throws.
+
+### Unknown fields are rejected
+
+Every fixed-shape object is a `strictObject`. A host that misspells
+`recentSearches` gets an error, not a shopper who silently looks like a
+first-time visitor. `interaction.meta` is the one dynamic shape — an open
+record, minus the keys that would mutate a prototype instead of the object.
+
+## Licence
+
+[MIT](./LICENSE)

package/dist/component-generator.d.ts

@@ -0,0 +1,84 @@
+import { type ComponentSpec, type DegradedReason, type SpecSource } from './component-spec.js';
+import type { ComponentProvider, TokenUsage } from './provider.js';
+import { type SpecCache } from './spec-cache.js';
+import { type TrackingInputDraft } from './tracking-input.js';
+/**
+ * Turns one tracking payload into one renderable component.
+ *
+ * Everything else in this package is a piece of that sentence; this module is
+ * the order they go in. It is deliberately the only place that knows the whole
+ * sequence, and it is written as a straight line so the sequence is readable:
+ *
+ *   validate → digest → cache → generate → reconcile → render
+ *
+ * The single promise it makes to a caller is that `generate` always returns
+ * something renderable. A model that is slow, refusing, erroring, rate-limited
+ * or simply not configured produces the deterministic component instead. The
+ * only way it rejects is a malformed payload, which is a caller bug and should
+ * be loud.
+ */
+/**
+ * Reported exactly once per call to `generate`, whatever happened.
+ *
+ * One flat shape rather than a variant per outcome, because the numbers the
+ * evaluation needs are ratios over all calls — hit rate, fallback share, model
+ * calls and cost per thousand views. A variant that some callers do not emit
+ * makes every one of those ratios wrong by however many it skipped, which is
+ * what happened when requests that joined an in-flight generation reported
+ * nothing at all.
+ */
+export interface GenerationEvent {
+    /** Null when no key was computed, which means no provider was configured. */
+    key: string | null;
+    source: SpecSource;
+    /** Wall-clock milliseconds for the whole call. */
+    elapsedMs: number;
+    /**
+     * True for the caller that sent the request, on every outcome — including a
+     * call that timed out, errored or came back unparseable. Requests that joined
+     * an in-flight generation share its answer and its usage figures, so cost
+     * must be summed over this flag rather than over every event.
+     *
+     * It counts requests sent, which is an upper bound on requests billed: an
+     * adapter that throws before it reaches the vendor looks the same from here
+     * as one that throws after. An upper bound is the useful direction — the
+     * calls that produce nothing are the ones worth seeing, and reporting them as
+     * no call at all hides them completely.
+     */
+    calledModel: boolean;
+    /** What reconciliation removed. Absent when no spec was reconciled. */
+    violations?: string[];
+    usage?: TokenUsage;
+    degradedReason?: DegradedReason;
+}
+export interface ComponentGeneratorOptions {
+    /**
+     * Omit to run without a model. That is a supported configuration rather than
+     * a stub: it is the control arm of the benchmark, and the right setting for
+     * anyone who has not yet decided on a provider.
+     */
+    provider?: ComponentProvider | null;
+    /** Defaults to an in-process cache. Pass `createNullSpecCache()` to disable. */
+    cache?: SpecCache;
+    /**
+     * How long the model gets. Past this the deterministic component renders and
+     * the request is aborted. Defaults to 1500ms.
+     */
+    modelTimeoutMs?: number;
+    /**
+     * How long the cache gets. The shipped caches cannot exceed it, but the store
+     * is a port a host implements — a hung Redis read on the render path would
+     * hold the page open, which is exactly what this module exists to prevent.
+     */
+    cacheTimeoutMs?: number;
+    generation?: 'cohort' | 'per-shopper';
+    /** Observability. Never allowed to break a render. */
+    onEvent?: (event: GenerationEvent) => void;
+}
+export interface ComponentGenerator {
+    generate(input: TrackingInputDraft): Promise<ComponentSpec>;
+    /** The deterministic component, without consulting a model or a cache. */
+    generateDeterministic(input: TrackingInputDraft): ComponentSpec;
+}
+export declare function createComponentGenerator(options?: ComponentGeneratorOptions): ComponentGenerator;
+//# sourceMappingURL=component-generator.d.ts.map

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

@@ -0,0 +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;AAUnE,OAAO,EAKL,KAAK,SAAS,EACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;;;;;;;;GAcG;AAEH;;;;;;;;;GASG;AACH,MAAM,WAAW,eAAe;IAC9B,6EAA6E;IAC7E,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,MAAM,EAAE,UAAU,CAAC;IACnB,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;;;;;;;OAWG;IACH,WAAW,EAAE,OAAO,CAAC;IACrB,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED,MAAM,WAAW,yBAAyB;IACxC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACpC,gFAAgF;IAChF,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAIxB,UAAU,CAAC,EAAE,QAAQ,GAAG,aAAa,CAAC;IACtC,sDAAsD;IACtD,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,0EAA0E;IAC1E,qBAAqB,CAAC,KAAK,EAAE,kBAAkB,GAAG,aAAa,CAAC;CACjE;AAiKD,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,yBAA8B,GACtC,kBAAkB,CA+OpB"}

package/dist/component-generator.js

@@ -0,0 +1,331 @@
+import { z } from 'zod';
+import { SPEC_VERSION, generatedSpecSchema, } from './component-spec.js';
+import { buildFallbackSpec } from './fallback-component.js';
+import { buildPrompt } from './model-prompt.js';
+import { MAX_BLOCKS, bundleForShopper, placeableHeroSkus, reconcileSpec, } from './reconciliation.js';
+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 { parseTrackingInput, } from './tracking-input.js';
+class TimeoutError extends Error {
+    constructor(label, milliseconds) {
+        super(`${label} exceeded ${milliseconds}ms`);
+        this.name = 'TimeoutError';
+    }
+}
+/**
+ * Races a promise against a deadline.
+ *
+ * The deadline is enforced here rather than trusted to the thing being waited
+ * on. A provider that ignores its abort signal, or a store that never settles,
+ * must still not hold a page open.
+ *
+ * Once the deadline has fired the caller is told so, whatever the race
+ * actually settled with. Aborting is what makes that necessary: a provider
+ * honouring its half of the contract rejects from inside the `abort()` below,
+ * so its rejection reaches the race first and the deadline's own never wins.
+ * Reporting the error that happened to arrive would blame the vendor for the
+ * caller's deadline — and blame it most often on the best-behaved adapters.
+ */
+async function withinBudget(label, milliseconds, start) {
+    const controller = new AbortController();
+    let timer;
+    let expired;
+    const deadline = new Promise((_resolve, reject) => {
+        timer = setTimeout(() => {
+            expired = new TimeoutError(label, milliseconds);
+            controller.abort();
+            reject(expired);
+        }, milliseconds);
+    });
+    try {
+        return await Promise.race([start(controller.signal), deadline]);
+    }
+    catch (error) {
+        throw expired ?? error;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/**
+ * Collapses concurrent work for the same key into one execution.
+ *
+ * Without this, a key that is not yet cached fans out into one model call per
+ * concurrent request — the same answer, bought many times over. The entry is
+ * removed as soon as it settles, so one failure does not poison the next
+ * attempt.
+ */
+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;
+        },
+    };
+}
+/** A cache entry is no more trustworthy than model output, so it is parsed too. */
+const cachedSpecSchema = z.object({
+    spec: generatedSpecSchema,
+    generatedAt: z.number(),
+});
+/**
+ * Fills a cohort spec with this shopper's products, keeping room for a set.
+ *
+ * The grid used to take the whole item budget, so a bundle block later in the
+ * spec found nothing left and was dropped. The set is chosen first, its
+ * products are held back from the grid, and the grid's limit drops by what the
+ * set and the heroes have already spoken for.
+ *
+ * The arithmetic has to hold whatever order the model put the blocks in, so it
+ * is written as one sum over the whole spec rather than as a running budget:
+ * the grid gets `maxItems` minus every distinct product the set and the heroes
+ * will place. Nothing is then dropped for want of budget, and reconciliation
+ * reaches the same set this did — it can only ever have more placed than the
+ * pre-choice assumed, and never one of the set's own products.
+ */
+function fitCohortSpec(spec, input, digest) {
+    const picks = selectProducts(input, digest);
+    // Blocks past the cap never render, so a set is not worth reserving for one.
+    const blocks = spec.blocks.slice(0, MAX_BLOCKS);
+    let hasBundleBlock = false;
+    const aboveBundle = [];
+    for (const block of blocks) {
+        if (block.kind === 'bundle') {
+            hasBundleBlock = true;
+            break;
+        }
+        aboveBundle.push(block);
+    }
+    if (!hasBundleBlock)
+        return fitToShopper(spec, picks, digest.maxItems);
+    // Only the heroes above the bundle block are placed when it is reached, so
+    // they are all the choice may account for.
+    const chosen = bundleForShopper(input, digest, placeableHeroSkus(aboveBundle, input, digest));
+    if (!chosen)
+        return fitToShopper(spec, picks, digest.maxItems);
+    const spokenFor = new Set(chosen.skus);
+    for (const sku of placeableHeroSkus(blocks, input, digest))
+        spokenFor.add(sku);
+    const roomLeft = digest.maxItems - spokenFor.size;
+    // A set is worth showing, but not at the cost of an empty grid.
+    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);
+    }
+    return fitToShopper(spec, forGrid, roomLeft);
+}
+/** Attaches the provenance the server owns. The model never supplies any of it. */
+function withProvenance(spec, provenance) {
+    return { ...spec, specVersion: SPEC_VERSION, ...provenance };
+}
+export function createComponentGenerator(options = {}) {
+    const provider = options.provider ?? null;
+    const cache = options.cache ?? createMemorySpecCache();
+    const generation = options.generation ?? 'cohort';
+    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 {
+            // A broken metrics hook must not take down a page.
+        }
+    };
+    const buildDeterministic = (input, digest, startedAt, key, degradedReason, 
+    /**
+     * What the model call cost, when there was one. A generation that is
+     * unusable for this shopper was still asked for and still billed, so
+     * omitting it here would hide the calls that produce nothing — exactly the
+     * ones worth knowing about.
+     */
+    modelCall = {
+        calledModel: false,
+    }) => {
+        const finishedAt = Date.now();
+        report({
+            key,
+            source: 'fallback',
+            elapsedMs: finishedAt - startedAt,
+            ...modelCall,
+            degradedReason,
+        });
+        return withProvenance(buildFallbackSpec(input, digest), {
+            slot: digest.slot,
+            source: 'fallback',
+            generatedAt: finishedAt,
+            latencyMs: finishedAt - startedAt,
+            provider: null,
+            model: null,
+            degradedReason,
+        });
+    };
+    /**
+     * Reads the cache, treating anything unexpected as a miss.
+     *
+     * The value is re-validated because a store is a port a host implements, and
+     * what comes back is no more trustworthy than what a model returns — a shared
+     * store outlives a deploy, so it can hold entries written by an older shape of
+     * the spec. Generating again is always safe; handing an unvalidated object to
+     * reconciliation is not.
+     */
+    const readCache = async (key) => {
+        try {
+            const stored = await withinBudget('cache read', cacheTimeoutMs, () => cache.get(key));
+            const parsed = cachedSpecSchema.safeParse(stored);
+            return parsed.success ? parsed.data : undefined;
+        }
+        catch {
+            // A store that is down or slow degrades to generating, not to an error
+            // page. Nothing here is worth failing a render over.
+            return undefined;
+        }
+    };
+    /**
+     * Writes to the cache without the render waiting for it.
+     *
+     * The spec is already in hand; nothing downstream needs the write to finish.
+     * Awaiting it put a second unbounded call to a host-implemented store on the
+     * render path, which is the failure this module exists to prevent arriving
+     * through the other door. The `Promise.resolve` wrapper is what catches a
+     * store that throws synchronously rather than rejecting.
+     */
+    const storeInBackground = (key, cached) => {
+        void Promise.resolve()
+            .then(() => cache.set(key, cached))
+            .catch(() => {
+            // A store that cannot be written is not a reason to fail a render.
+        });
+    };
+    /**
+     * Asks the model.
+     *
+     * Deliberately does not decide whether the answer is usable. That depends on
+     * the asking shopper's live facts — stock, dislikes, what is in their basket
+     * — and none of those are in the cache key, so a verdict reached here would
+     * be handed to every request that joined this one. A null `spec` in the
+     * result means the answer did not satisfy the schema, which is a fault of the
+     * adapter rather than a judgement about any shopper — and is still a call
+     * that happened, so its usage comes back with it.
+     */
+    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 }));
+        // Providers return parsed objects, but the shape is still model output.
+        const parsed = generatedSpecSchema.safeParse(result.spec);
+        return {
+            spec: parsed.success ? parsed.data : null,
+            ...(result.usage ? { usage: result.usage } : {}),
+        };
+    };
+    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();
+            // Deliberately unguarded: an invalid payload is a caller bug, not a
+            // degraded render.
+            const input = parseTrackingInput(draft);
+            const digest = buildDigest(input);
+            if (!provider) {
+                return buildDeterministic(input, digest, startedAt, null, 'no-provider');
+            }
+            const providerId = `${provider.name}:${provider.model}`;
+            const key = generation === 'cohort'
+                ? cohortCacheKey(digest, input.candidates.map((product) => product.sku), providerId)
+                : specCacheKey(digest, input.candidates.map((product) => product.sku), providerId);
+            const cached = await readCache(key);
+            let calledModel = false;
+            let answer;
+            // When the model produced this, not when it was served. A cached
+            // component is not newly generated, and pretending otherwise makes any
+            // measure of how stale a page is showing read as zero.
+            let generatedAt;
+            if (cached) {
+                answer = { spec: cached.spec };
+                generatedAt = cached.generatedAt;
+            }
+            else {
+                // Asked before joining, because by the time the shared promise settles
+                // the entry is gone and there is no way to tell a leader from a
+                // follower — and they must not both be counted as a model call.
+                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';
+                    // The request went out. Leaving `calledModel` to default here reported
+                    // every failed call as no call at all, so the calls that cost money
+                    // and produced nothing were the only ones missing from the count.
+                    return buildDeterministic(input, digest, startedAt, key, reason, { calledModel });
+                }
+                if (!call.spec) {
+                    return buildDeterministic(input, digest, startedAt, key, 'invalid-generation', {
+                        calledModel,
+                        ...(call.usage ? { usage: call.usage } : {}),
+                    });
+                }
+                answer = { spec: call.spec, ...(call.usage ? { usage: call.usage } : {}) };
+                generatedAt = Date.now();
+                // Stored unreconciled on purpose, and stored even when it is unusable
+                // for this shopper. Reconciliation narrows a spec to one shopper's live
+                // facts, and those move independently of the key — a product can sell
+                // out and come back without the candidate list changing. Keeping what
+                // the model said means the restock is picked up from cache rather than
+                // paid for again.
+                if (calledModel)
+                    storeInBackground(key, { spec: answer.spec, generatedAt });
+            }
+            // One place where anything is served, whichever side of the cache it came
+            // from, and always against the facts of the shopper asking now.
+            // A cohort spec names products chosen for whoever asked first.
+            const served = generation === 'cohort' ? fitCohortSpec(answer.spec, input, digest) : answer.spec;
+            const reconciled = reconcileSpec(served, input, digest);
+            if (!reconciled.isUsable) {
+                return buildDeterministic(input, digest, startedAt, key, 'unusable-on-serve', {
+                    calledModel,
+                    violations: reconciled.violations,
+                    ...(answer.usage ? { usage: answer.usage } : {}),
+                });
+            }
+            const finishedAt = Date.now();
+            const source = cached ? 'cache' : 'llm';
+            report({
+                key,
+                source,
+                elapsedMs: finishedAt - startedAt,
+                calledModel,
+                violations: reconciled.violations,
+                ...(answer.usage ? { usage: answer.usage } : {}),
+            });
+            return withProvenance(reconciled.spec, {
+                slot: digest.slot,
+                source,
+                generatedAt,
+                latencyMs: finishedAt - startedAt,
+                provider: provider.name,
+                model: provider.model,
+            });
+        },
+    };
+}
+//# sourceMappingURL=component-generator.js.map

package/dist/component-generator.js.map

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