spawnfile 0.1.25 → 0.1.27

package/dist/training/experiments/concurrency/slots.js

@@ -0,0 +1,120 @@
+import { readFile, stat } from 'node:fs/promises';
+import { isAbsolute } from 'node:path';
+import { z } from 'zod';
+const slotSchema = z.object({
+    index: z.number().int().min(0).max(7),
+    workerUid: z.number().int().positive().max(4_294_967_294),
+    roots: z.record(z.string().min(1), z.string().refine(isAbsolute)),
+    ports: z.object({ base: z.number().int().min(1024).max(65535), count: z.number().int().positive() }).strict(),
+}).strict();
+const sharedUidSlotSchema = slotSchema.extend({ isolation: z.literal('shared-uid') });
+const provisionedSlotSchema = z.union([slotSchema, sharedUidSlotSchema]);
+const slotsDocumentSchema = z.discriminatedUnion('schema', [
+    z.object({ schema: z.literal('spawnfile.training-slots.v1'), slots: z.array(slotSchema).min(1).max(8) }).strict(),
+    z.object({ schema: z.literal('spawnfile.training-slots.v2'), slots: z.array(sharedUidSlotSchema).min(1).max(8) }).strict(),
+]);
+export const trialConcurrency = (value) => z.number().int().min(1).max(8).parse(value);
+export async function loadTrialSlots(options = {}) {
+    if (options.concurrency !== undefined)
+        trialConcurrency(options.concurrency);
+    let slots = options.slots;
+    if (!slots) {
+        const path = options.slotsFile ?? '/run/spawnfile-training/slots.json';
+        try {
+            const info = await stat(path);
+            if ((info.mode & 0o222) !== 0)
+                throw new Error('Trial slot descriptor file must be read-only');
+            const document = slotsDocumentSchema.parse(JSON.parse(await readFile(path, 'utf8')));
+            slots = document.slots;
+        }
+        catch (error) {
+            if (error.code !== 'ENOENT' || options.slotsFile)
+                throw error;
+        }
+    }
+    if (!slots) {
+        if ((options.concurrency ?? 1) > 1)
+            throw new Error('Concurrent trials require provisioned slot descriptors');
+        return { concurrency: 1, pool: undefined, slots: undefined };
+    }
+    const parsed = z.array(provisionedSlotSchema).min(1).max(8).parse(slots);
+    for (const [i, slot] of parsed.entries()) {
+        const sharedUid = 'isolation' in slot && slot.isolation === 'shared-uid';
+        if (slot.ports.base + slot.ports.count > 65536 || !sharedUid && !Object.keys(slot.roots).length)
+            throw new Error('Invalid slot roots or port block');
+        for (const prior of parsed.slice(0, i)) {
+            const sharedIdentity = sharedUid && 'isolation' in prior && prior.isolation === 'shared-uid';
+            if (prior.index === slot.index || prior.workerUid === slot.workerUid && !sharedIdentity ||
+                prior.ports.base < slot.ports.base + slot.ports.count && slot.ports.base < prior.ports.base + prior.ports.count) {
+                throw new Error('Slot indices, worker identities and port blocks must be disjoint');
+            }
+        }
+    }
+    const concurrency = options.concurrency ?? parsed.length;
+    if (concurrency > parsed.length)
+        throw new Error('Trial concurrency exceeds provisioned slots');
+    return { concurrency, pool: new SlotPool(parsed.slice(0, concurrency)), slots: parsed };
+}
+/** Resolve an offset from the descriptor supplied to native preparation. */
+export function slotPort(slot, index) {
+    if (!Number.isSafeInteger(index) || index < 0 || index >= slot.ports.count)
+        throw new RangeError('Port index is outside the leased block');
+    return slot.ports.base + index;
+}
+export class SlotPool {
+    free;
+    waiting = [];
+    usable;
+    quarantined = [];
+    constructor(slots) {
+        if (!slots.length)
+            throw new Error('No usable trial slots remain');
+        this.free = structuredClone([...slots]);
+        this.usable = slots.length;
+    }
+    acquire(signal) {
+        if (signal?.aborted)
+            return Promise.reject(signal.reason);
+        if (!this.usable)
+            return Promise.reject(this.exhausted());
+        const slot = this.free.shift();
+        if (slot)
+            return Promise.resolve(this.lease(slot));
+        return new Promise((resolve, reject) => {
+            const waiter = { resolve, reject, signal, abort: () => {
+                    this.waiting.splice(this.waiting.indexOf(waiter), 1);
+                    reject(signal.reason);
+                } };
+            this.waiting.push(waiter);
+            signal?.addEventListener('abort', waiter.abort, { once: true });
+        });
+    }
+    lease(slot) {
+        let released = false;
+        return { slot: structuredClone(slot), port: index => slotPort(slot, index), release: (confirmed, cause) => {
+                if (released)
+                    throw new Error('Trial slot lease already released');
+                released = true;
+                if (confirmed)
+                    this.free.push(slot);
+                else {
+                    this.usable -= 1;
+                    this.quarantined.push(`slot ${slot.index}: ${cause?.trim().slice(0, 300) || 'closure unconfirmed'}`);
+                }
+                while (this.waiting.length && (this.free.length || !this.usable)) {
+                    const waiter = this.waiting.shift();
+                    waiter.signal?.removeEventListener('abort', waiter.abort);
+                    if (!this.usable)
+                        waiter.reject(this.exhausted());
+                    else
+                        waiter.resolve(this.lease(this.free.shift()));
+                }
+                if (!this.usable)
+                    throw this.exhausted();
+            } };
+    }
+    exhausted() {
+        return new Error(`No usable trial slots remain; all slots quarantined (${this.quarantined.join('; ')})`);
+    }
+}
+//# sourceMappingURL=slots.js.map

package/dist/training/experiments/concurrency/slots.js.map

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

package/dist/training/experiments/costs/assumptions.d.ts

@@ -0,0 +1,4 @@
+import type { CostAssumptions } from './types.js';
+/** Broad uncalibrated planning ranges per complete trial / inference call, not measured limits. */
+export declare const defaultCostAssumptions: CostAssumptions;
+export declare function resolveCostAssumptions(input?: unknown): CostAssumptions;

package/dist/training/experiments/costs/assumptions.js

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+const range = z.object({ low: z.number().int().nonnegative().max(1e9), high: z.number().int().nonnegative().max(1e9) })
+    .strict().refine(value => value.low <= value.high, 'Range low must not exceed high');
+const fraction = z.object({ low: z.number().min(0).max(1), high: z.number().min(0).max(1) })
+    .strict().refine(value => value.low <= value.high, 'Range low must not exceed high');
+const tokens = z.object({ inputTokens: range, outputTokens: range, cacheReadFraction: fraction }).strict();
+const schema = z.object({ subject: tokens.optional(), judge: tokens.optional(), optimizer: tokens.optional(),
+    judges: z.record(z.string().min(1), tokens).optional() }).strict();
+/** Broad uncalibrated planning ranges per complete trial / inference call, not measured limits. */
+export const defaultCostAssumptions = {
+    subject: { inputTokens: { low: 10000, high: 250000 }, outputTokens: { low: 2000, high: 16000 }, cacheReadFraction: { low: 0, high: 0.8 } },
+    judge: { inputTokens: { low: 2000, high: 32000 }, outputTokens: { low: 200, high: 2000 }, cacheReadFraction: { low: 0, high: 0.5 } },
+    optimizer: { inputTokens: { low: 8000, high: 64000 }, outputTokens: { low: 500, high: 8000 }, cacheReadFraction: { low: 0, high: 0.5 } },
+};
+export function resolveCostAssumptions(input = {}) {
+    return structuredClone({ ...defaultCostAssumptions, ...schema.parse(input) });
+}
+//# sourceMappingURL=assumptions.js.map

package/dist/training/experiments/costs/assumptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assumptions.js","sourceRoot":"","sources":["../../../../src/training/experiments/costs/assumptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;KACpH,MAAM,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,IAAI,EAAE,gCAAgC,CAAC,CAAC;AACvF,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;KACzF,MAAM,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,IAAI,EAAE,gCAAgC,CAAC,CAAC;AACvF,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,iBAAiB,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AAC3G,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,QAAQ,EAAE;IAC1G,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AAErE,mGAAmG;AACnG,MAAM,CAAC,MAAM,sBAAsB,GAAoB;IACrD,OAAO,EAAE,EAAE,WAAW,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,YAAY,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,iBAAiB,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;IAC1I,KAAK,EAAE,EAAE,WAAW,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,YAAY,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,iBAAiB,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;IACpI,SAAS,EAAE,EAAE,WAAW,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,YAAY,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,iBAAiB,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;CACzI,CAAC;AAEF,MAAM,UAAU,sBAAsB,CAAC,QAAiB,EAAE;IACxD,OAAO,eAAe,CAAC,EAAE,GAAG,sBAAsB,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AAChF,CAAC"}

package/dist/training/experiments/costs/catalog.d.ts

@@ -0,0 +1,3 @@
+import type { ModelPrice } from './types.js';
+/** Offline snapshot; refreshing rates is an explicit source change, never a dry-run side effect. */
+export declare const standardPrices: readonly ModelPrice[];

package/dist/training/experiments/costs/catalog.js

@@ -0,0 +1,24 @@
+/** Offline snapshot; refreshing rates is an explicit source change, never a dry-run side effect. */
+export const standardPrices = [
+    {
+        model: 'gpt-5.5', vendor: 'openai', currency: 'USD',
+        perMillion: { input: 5, cacheRead: 0.5, output: 30 },
+        source: 'https://developers.openai.com/api/docs/models/gpt-5.5', checkedAt: '2026-09-13',
+        scope: 'Standard global text-token pricing; excludes tools, regional uplifts and priority tiers.',
+        longContext: { aboveInputTokens: 272000, inputMultiplier: 2, outputMultiplier: 1.5 },
+    },
+    {
+        model: 'gpt-5.5-2026-04-23', vendor: 'openai', currency: 'USD',
+        perMillion: { input: 5, cacheRead: 0.5, output: 30 },
+        source: 'https://developers.openai.com/api/docs/models/gpt-5.5', checkedAt: '2026-09-13',
+        scope: 'Standard global text-token pricing; excludes tools, regional uplifts and priority tiers.',
+        longContext: { aboveInputTokens: 272000, inputMultiplier: 2, outputMultiplier: 1.5 },
+    },
+    {
+        model: 'claude-fable-5-1', vendor: 'anthropic', currency: 'USD',
+        perMillion: { input: 10, cacheRead: 0.25, output: 50, cacheWrite5m: 12.5, cacheWrite1h: 20 },
+        source: 'https://platform.claude.com/docs/en/about-claude/pricing', checkedAt: '2026-09-13',
+        scope: 'Standard global text-token pricing; excludes tools, residency and fast-mode surcharges.',
+    },
+];
+//# sourceMappingURL=catalog.js.map

package/dist/training/experiments/costs/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../../../src/training/experiments/costs/catalog.ts"],"names":[],"mappings":"AAEA,oGAAoG;AACpG,MAAM,CAAC,MAAM,cAAc,GAA0B;IACnD;QACE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK;QACnD,UAAU,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE;QACpD,MAAM,EAAE,uDAAuD,EAAE,SAAS,EAAE,YAAY;QACxF,KAAK,EAAE,0FAA0F;QACjG,WAAW,EAAE,EAAE,gBAAgB,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC,EAAE,gBAAgB,EAAE,GAAG,EAAE;KACrF;IACD;QACE,KAAK,EAAE,oBAAoB,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK;QAC9D,UAAU,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE;QACpD,MAAM,EAAE,uDAAuD,EAAE,SAAS,EAAE,YAAY;QACxF,KAAK,EAAE,0FAA0F;QACjG,WAAW,EAAE,EAAE,gBAAgB,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC,EAAE,gBAAgB,EAAE,GAAG,EAAE;KACrF;IACD;QACE,KAAK,EAAE,kBAAkB,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,KAAK;QAC/D,UAAU,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE;QAC5F,MAAM,EAAE,0DAA0D,EAAE,SAAS,EAAE,YAAY;QAC3F,KAAK,EAAE,yFAAyF;KACjG;CACF,CAAC"}

package/dist/training/experiments/costs/config.d.ts

@@ -0,0 +1,6 @@
+import type { CostAssumptions, ModelPrice } from './types.js';
+/** Explicit per-model overrides; no alias guessing and no network price refresh. */
+export declare function resolveCostConfig(value?: unknown): {
+    assumptions: CostAssumptions;
+    prices: ModelPrice[];
+};

package/dist/training/experiments/costs/config.js

@@ -0,0 +1,22 @@
+import { compatibleWireLiteral } from '../../contracts/index.js';
+import { z } from 'zod';
+import { resolveCostAssumptions } from './assumptions.js';
+import { standardPrices } from './catalog.js';
+const rate = z.number().nonnegative().finite();
+const price = z.object({ model: z.string().min(1), vendor: z.string().min(1), currency: z.literal('USD'),
+    perMillion: z.object({ input: rate, cacheRead: rate, output: rate, cacheWrite5m: rate.optional(), cacheWrite1h: rate.optional() }).strict(),
+    source: z.string().min(1), checkedAt: z.iso.date(), scope: z.string().min(1),
+    longContext: z.object({ aboveInputTokens: z.number().int().positive(), inputMultiplier: z.number().min(1), outputMultiplier: z.number().min(1) }).strict().optional(),
+}).strict();
+const schema = z.object({ schema: compatibleWireLiteral('spawnfile.training.cost-config.v1'), assumptions: z.unknown().optional(),
+    prices: z.array(price).optional() }).strict();
+/** Explicit per-model overrides; no alias guessing and no network price refresh. */
+export function resolveCostConfig(value) {
+    const config = value === undefined ? undefined : schema.parse(value);
+    const overrides = config?.prices ?? [];
+    if (new Set(overrides.map(entry => entry.model)).size !== overrides.length)
+        throw new Error('Duplicate cost model override');
+    return { assumptions: resolveCostAssumptions(config?.assumptions),
+        prices: structuredClone([...standardPrices.filter(entry => !overrides.some(override => override.model === entry.model)), ...overrides]) };
+}
+//# sourceMappingURL=config.js.map

package/dist/training/experiments/costs/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../../src/training/experiments/costs/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAG9C,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,CAAC,MAAM,EAAE,CAAC;AAC/C,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IACtG,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IAC3I,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5E,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,EAAE,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACtK,CAAC,CAAC,MAAM,EAAE,CAAC;AACZ,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,qBAAqB,CAAC,mCAAmC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC/H,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AAEhD,oFAAoF;AACpF,MAAM,UAAU,iBAAiB,CAAC,KAAe;IAC/C,MAAM,MAAM,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACrE,MAAM,SAAS,GAAG,MAAM,EAAE,MAAM,IAAI,EAAE,CAAC;IACvC,IAAI,IAAI,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IAC7H,OAAO,EAAE,WAAW,EAAE,sBAAsB,CAAC,MAAM,EAAE,WAAW,CAAC;QAC/D,MAAM,EAAE,eAAe,CAAC,CAAC,GAAG,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,SAAS,CAAC,CAAC,EAAE,CAAC;AAC9I,CAAC"}

package/dist/training/experiments/costs/decisions.d.ts

@@ -0,0 +1,5 @@
+import type { TrialReport } from '../trials/index.js';
+import type { RescoreReport } from '../replay/index.js';
+import type { CostEntry } from './report.js';
+/** Originating request identity survives check aliases and selective measurement repair. */
+export declare function decisionCostEntries(trials: readonly TrialReport[], rescores?: readonly RescoreReport[]): CostEntry[];

package/dist/training/experiments/costs/decisions.js

@@ -0,0 +1,48 @@
+import { isDeepStrictEqual } from 'node:util';
+/** Originating request identity survives check aliases and selective measurement repair. */
+export function decisionCostEntries(trials, rescores = []) {
+    const receipts = new Map();
+    const visit = (value, measurement, trialId, path, plan) => {
+        const canonical = value.id && plan?.checks[value.id] ? `check/${value.id}` : path;
+        [...value.decisionAccounting?.receipts ?? [], ...value.grading?.decisionAccounting?.receipts ?? [],
+            ...value.atomicGrading?.receipts ?? []].forEach((receipt, index) => {
+            const id = receipt.requestId === undefined
+                ? JSON.stringify(['decision', measurement, canonical, index]) // Legacy captures have no origin identity.
+                : JSON.stringify(['decision', receipt.requestId]);
+            const entry = receipts.get(id) ?? { trialId, versions: [] };
+            if (!entry.versions.some(version => isDeepStrictEqual(version, receipt)))
+                entry.versions.push(receipt);
+            receipts.set(id, entry);
+        });
+        value.children?.forEach((child, index) => visit(child, measurement, trialId, `${canonical}/children/${index}`, plan));
+    };
+    const plan = (evaluation, id, trialId) => {
+        Object.entries(evaluation.checks).forEach(([key, value]) => visit(value, id, trialId, `check/${key}`, evaluation));
+        evaluation.stages.forEach(stage => {
+            stage.checks.forEach((value, index) => visit(value, id, trialId, `stage/${stage.id}/check/${index}`, evaluation));
+            visit(stage.gate, id, trialId, `check/${stage.id}`, evaluation);
+        });
+    };
+    for (const trial of trials) {
+        plan(trial.evaluation, trial.id, trial.id);
+        trial.turns.forEach(turn => turn.checks.forEach((value, index) => visit(value, trial.id, trial.id, `turn/${turn.id}/${index}`)));
+        trial.live.forEach((value, index) => visit(value.result, trial.id, trial.id, `live/${index}`));
+        // Decisive failures reference a live result; do not bill that reference again.
+        if (trial.decisiveFailure && !trial.live.some(value => JSON.stringify(value.result) === JSON.stringify(trial.decisiveFailure))) {
+            visit(trial.decisiveFailure, trial.id, trial.id, 'decisiveFailure');
+        }
+    }
+    rescores.forEach(rescore => plan(rescore.evaluation, rescore.id, rescore.runId));
+    return [...receipts].map(([id, { trialId, versions }]) => {
+        const receipt = versions[0];
+        const known = versions.length === 1 && receipt.usd !== null && Number.isFinite(receipt.usd) && receipt.usd >= 0;
+        return { id, trialId, role: 'judge', name: `decision/${receipt.model}`, model: receipt.model,
+            modelBasis: 'requested-assumption', responseRoute: receipt.endpoint, outcome: String(receipt.status ?? 'unknown'), usage: null,
+            decisionReceipt: receipt, ...(versions.length > 1 ? { decisionReceiptVersions: versions } : {}),
+            valuation: { status: known ? 'priced' : 'incomplete', price: null,
+                apiEquivalentUsd: known ? { low: receipt.usd, high: receipt.usd } : null,
+                assumptions: [versions.length > 1 ? 'Conflicting representations of one decision receipt; cost cannot be selected.'
+                        : 'Recorded usage-priced API decision cost; admission estimates are not spend or invoice evidence.'] } };
+    });
+}
+//# sourceMappingURL=decisions.js.map

package/dist/training/experiments/costs/decisions.js.map

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

package/dist/training/experiments/costs/index.d.ts

@@ -0,0 +1,9 @@
+export { valueUsage } from './valuation.js';
+export { standardPrices } from './catalog.js';
+export { defaultCostAssumptions, resolveCostAssumptions } from './assumptions.js';
+export { resolveCostConfig } from './config.js';
+export { planTrainingCost } from './planning.js';
+export { summarizeCosts, includeDecisionCosts } from './report.js';
+export type { CostReport, CostReportOptions, CostEntry, CostGroup, OptimizerGeneration } from './report.js';
+export type { TrainingCostOptions, TrainingCostPlan, PlannedCostLine } from './planning.js';
+export type { Range, TokenRates, ModelPrice, CostValuation, UsageCharge, TokenAssumption, CostAssumptions } from './types.js';

package/dist/training/experiments/costs/index.js

@@ -0,0 +1,7 @@
+export { valueUsage } from './valuation.js';
+export { standardPrices } from './catalog.js';
+export { defaultCostAssumptions, resolveCostAssumptions } from './assumptions.js';
+export { resolveCostConfig } from './config.js';
+export { planTrainingCost } from './planning.js';
+export { summarizeCosts, includeDecisionCosts } from './report.js';
+//# sourceMappingURL=index.js.map

package/dist/training/experiments/costs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/training/experiments/costs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAClF,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC"}

package/dist/training/experiments/costs/planning.d.ts

@@ -0,0 +1,71 @@
+import type { ResolvedDataset } from '../../contracts/dataset.js';
+import { type CostDataset } from '../../cases/index.js';
+import type { CostAssumptions, ModelPrice, Range, TokenAssumption } from './types.js';
+export interface PlannedInferenceRoute {
+    model: string;
+    provider: string;
+    fallbacks?: readonly {
+        model: string;
+        provider: string;
+    }[];
+    attempts?: number;
+}
+export interface TrainingCostOptions<Dataset = ResolvedDataset> {
+    train: Dataset;
+    validation?: Dataset;
+    validationGroups?: readonly string[];
+    test: Dataset;
+    subjectModel: string;
+    mode?: 'comparison';
+    optimizerModel?: string;
+    judges: Readonly<Record<string, PlannedInferenceRoute & {
+        citationRepairs?: 0 | 1;
+    }>>;
+    optimizerRoute?: PlannedInferenceRoute;
+    testRepeats?: number;
+    maxTrials: number;
+    maxProposals: number;
+    assumptions?: Partial<CostAssumptions>;
+    prices?: readonly ModelPrice[];
+}
+export interface PlannedCostLine {
+    role: 'subject' | 'judge' | 'optimizer';
+    name: string;
+    phase: 'development' | 'held-out' | 'optimization';
+    model: string;
+    provider?: string;
+    plannedCalls: number;
+    tokensPerCall: TokenAssumption;
+    apiEquivalentUsd: Range | null;
+    price: ModelPrice | null;
+}
+export interface TrainingCostPlan {
+    schema: 'spawnfile.training.training-cost-plan.v1';
+    modelCallsMade: 0;
+    billing: 'API-equivalent valuation; subscription fees are not apportioned';
+    coverage: 'estimated' | 'partial';
+    budget: {
+        maxTrials: number;
+        maxProposals: number;
+        metricCalls: number;
+        reservedTestTrials: number;
+    };
+    datasetDigests: {
+        train: string;
+        test: string;
+        validation?: string;
+    };
+    /** Always emitted by current planning; absent only in older stored v1 plans. */
+    judgeRoutes?: Record<string, PlannedInferenceRoute & {
+        citationRepairs: 0 | 1;
+    }>;
+    lines: PlannedCostLine[];
+    apiEquivalentUsd: Range | null;
+    pricedSubtotalUsd: Range;
+    assumptions: CostAssumptions;
+    warnings: string[];
+    /** Present in current estimates; older persisted v1 plans omit this disclosure. */
+    preparationValidation?: CostDataset['preparation'];
+}
+/** Pure planning over resolved cases. Does not construct an adapter or touch credentials. */
+export declare function planTrainingCost(options: TrainingCostOptions<ResolvedDataset | CostDataset>): TrainingCostPlan;

package/dist/training/experiments/costs/planning.js

@@ -0,0 +1,140 @@
+import { canonicalWireId } from '../../contracts/index.js';
+import { testRepeatCount } from '../../contracts/training-config.js';
+import { builtinEvaluatorDefinitions, validateCostDatasetSplit, projectDatasetCost } from '../../cases/index.js';
+import { resolveTrainingPartitions } from '../training/index.js';
+import { resolveCostAssumptions } from './assumptions.js';
+import { valueUsage } from './valuation.js';
+/** Pure planning over resolved cases. Does not construct an adapter or touch credentials. */
+export function planTrainingCost(options) {
+    const testRepeats = testRepeatCount(options.testRepeats);
+    if (options.mode === 'comparison' && testRepeats !== 1)
+        throw new Error('Comparison does not support test repeats');
+    const project = (dataset) => {
+        const normalized = { ...dataset, schema: canonicalWireId(dataset.schema) };
+        return normalized.schema === 'spawnfile.training.cost-dataset.v1' ? normalized : projectDatasetCost(normalized);
+    };
+    const train = project(options.train), test = project(options.test);
+    const validation = options.validation ? project(options.validation) : undefined;
+    const judgeRoutes = Object.fromEntries(Object.entries(options.judges).map(([name, route]) => {
+        const citationRepairs = route.citationRepairs === undefined ? 0 : route.citationRepairs;
+        if (citationRepairs !== 0 && citationRepairs !== 1)
+            throw new Error(`Invalid citation repair policy for judge ${name}`);
+        return [name, { ...route, citationRepairs }];
+    }));
+    if (options.mode === 'comparison' && (options.maxProposals !== 0 || options.optimizerRoute || options.optimizerModel))
+        throw new Error('Comparison has no optimizer budget or route');
+    if (options.mode !== 'comparison' && !options.optimizerRoute && !options.optimizerModel)
+        throw new Error('Optimizer model is required');
+    for (const [value, max] of [[options.maxTrials, 10000], ...options.mode === 'comparison' ? [] : [[options.maxProposals, 1000]]]) {
+        if (!Number.isSafeInteger(value) || value < 1 || value > max)
+            throw new Error('Invalid training cost budget');
+    }
+    const partition = resolveTrainingPartitions(train, validation, options.validationGroups);
+    if ([partition.train, partition.validation, test].some(dataset => dataset.records.length === 0)) {
+        throw new Error('Cost planning requires nonempty training, validation and test partitions');
+    }
+    validateCostDatasetSplit(partition.train, test, partition.validation);
+    const reservedTestTrials = test.records.length * 2 * testRepeats;
+    const metricCalls = options.mode === 'comparison' ? 2 * (partition.train.records.length + partition.validation.records.length) : options.maxTrials - reservedTestTrials;
+    if (options.mode === 'comparison' && metricCalls + reservedTestTrials > options.maxTrials)
+        throw new Error('Comparison budget cannot cover both arms on every case');
+    if (metricCalls < partition.validation.records.length)
+        throw new Error('Trial budget cannot cover baseline validation and two held-out passes');
+    const assumptions = resolveCostAssumptions(options.assumptions);
+    const warnings = new Set([
+        options.mode === 'comparison' ? 'Fixed comparison: both arms run once on every case; no optimizer calls.' : 'Budget scenario assumes every permitted trial and optimizer proposal is used; early stopping may use less.',
+        'Token ranges are uncalibrated assumptions per full subject trial or judge/optimizer call, not a guaranteed spending ceiling.',
+        'Prompt growth, tool output and private environment size can exceed these assumptions; calibrate them from recorded trials.',
+        'Only standard global API text-token prices are valued; subscription quota percentages, tools and infrastructure are excluded.',
+        'Cache creation and unknown session context tiers are included as pricing ranges. No batch discount is assumed.',
+    ]);
+    const profiles = [...new Set([train, test, ...(validation ? [validation] : [])].flatMap(dataset => dataset.preparation.profiles))].sort();
+    const preparationValidation = { status: 'unverified', profiles, checks: ['availability', 'locks', 'parameter-semantics'] };
+    if (profiles.length)
+        warnings.add(`Preparation profiles ${profiles.join(', ')}: availability, parameter semantics and override locks are unverified; this estimate is not execution readiness.`);
+    const lines = [];
+    let incomplete = false;
+    const omitCost = (warning) => { incomplete = true; warnings.add(warning); };
+    const add = (role, name, phase, model, plannedCalls, tokensPerCall, provider) => {
+        const common = { role, name, model, billing: 'subscription', contextTier: 'unknown' };
+        const low = valueUsage({ ...common, usage: { inputTokens: tokensPerCall.inputTokens.low,
+                cachedInputTokens: Math.floor(tokensPerCall.inputTokens.low * tokensPerCall.cacheReadFraction.high),
+                outputTokens: tokensPerCall.outputTokens.low, reasoningTokens: null, source: 'planning-assumption' } }, options.prices);
+        const high = valueUsage({ ...common, usage: { inputTokens: tokensPerCall.inputTokens.high,
+                cachedInputTokens: Math.floor(tokensPerCall.inputTokens.high * tokensPerCall.cacheReadFraction.low),
+                outputTokens: tokensPerCall.outputTokens.high, reasoningTokens: null, source: 'planning-assumption' } }, options.prices);
+        const apiEquivalentUsd = low.apiEquivalentUsd && high.apiEquivalentUsd
+            ? { low: plannedCalls * low.apiEquivalentUsd.low, high: plannedCalls * high.apiEquivalentUsd.high } : null;
+        if (apiEquivalentUsd === null)
+            omitCost(`Unpriced ${role} ${name}: exact model ${model} has no usable rate.`);
+        lines.push({ role, name, phase, model, provider, plannedCalls, tokensPerCall, apiEquivalentUsd, price: low.price });
+    };
+    const development = [...partition.train.records, ...partition.validation.records];
+    const addRoute = (role, name, phase, route, calls, perCall) => {
+        const routes = [route, ...route.fallbacks ?? []];
+        const attempts = route.attempts ?? routes.length;
+        if (!Number.isSafeInteger(attempts) || attempts < 1 || attempts > routes.length)
+            throw new Error('Invalid planned route attempt budget');
+        for (const [index, selected] of routes.slice(0, attempts).entries()) {
+            add(role, name, phase, selected.model, calls, perCall, selected.provider);
+            if (index && lines.at(-1).apiEquivalentUsd)
+                lines.at(-1).apiEquivalentUsd.low = 0;
+        }
+        if (attempts > 1)
+            warnings.add(`${role} ${name}: reserves every permitted fallback attempt; fallback lower cost is zero and provider prefix-cache reuse is not guaranteed.`);
+    };
+    add('subject', options.train.subject ?? 'subject', 'development', options.subjectModel, metricCalls, assumptions.subject);
+    add('subject', options.train.subject ?? 'subject', 'held-out', options.subjectModel, reservedTestTrials, assumptions.subject);
+    const developmentCounts = development.map(record => countChecks(record, omitCost));
+    const testCounts = test.records.map(record => countChecks(record, omitCost));
+    const names = new Set([...developmentCounts, ...testCounts].flatMap(counts => Object.keys(counts)));
+    for (const name of names) {
+        const route = judgeRoutes[name];
+        if (!route)
+            throw new Error(`Missing judge route ${name}`);
+        const perCall = assumptions.judges?.[name] ?? assumptions.judge;
+        const maxPerMetric = Math.max(...developmentCounts.map(counts => counts[name] ?? 0));
+        const testCalls = 2 * testRepeats * testCounts.reduce((sum, counts) => sum + (counts[name] ?? 0), 0);
+        const attempts = 1 + route.citationRepairs;
+        if (route.citationRepairs)
+            warnings.add(`Judge ${name} reserves one citation repair per check; valid quality failures, authentication/quota failures and malformed JSON are not retried.`);
+        const developmentCalls = options.mode === 'comparison' ? 2 * developmentCounts.reduce((sum, counts) => sum + (counts[name] ?? 0), 0) : metricCalls * maxPerMetric;
+        if (developmentCalls)
+            addRoute('judge', name, 'development', route, developmentCalls * attempts, perCall);
+        if (testCalls)
+            addRoute('judge', name, 'held-out', route, testCalls * attempts, perCall);
+    }
+    if (options.mode !== 'comparison')
+        addRoute('optimizer', 'reflection', 'optimization', options.optimizerRoute ?? { model: options.optimizerModel, provider: 'claude-subscription' }, options.maxProposals, assumptions.optimizer);
+    const pricedSubtotalUsd = lines.reduce((sum, line) => ({ low: sum.low + (line.apiEquivalentUsd?.low ?? 0),
+        high: sum.high + (line.apiEquivalentUsd?.high ?? 0) }), { low: 0, high: 0 });
+    return { schema: 'spawnfile.training.training-cost-plan.v1', modelCallsMade: 0,
+        billing: 'API-equivalent valuation; subscription fees are not apportioned', coverage: incomplete ? 'partial' : 'estimated',
+        budget: { maxTrials: options.maxTrials, maxProposals: options.maxProposals, metricCalls, reservedTestTrials },
+        datasetDigests: { train: options.train.sourceDigest, test: options.test.sourceDigest,
+            ...(options.validation ? { validation: options.validation.sourceDigest } : {}) },
+        judgeRoutes, preparationValidation, lines, apiEquivalentUsd: incomplete ? null : pricedSubtotalUsd, pricedSubtotalUsd, assumptions, warnings: [...warnings] };
+}
+function countChecks(record, omitCost) {
+    const counts = {};
+    const visit = (node, live = false) => {
+        if (node.eval === 'llm-rubric') {
+            if (live)
+                omitCost(`Unbounded live judge ${String(node.judge)}: event frequency is unknown; omitted from finite subtotal.`);
+            else
+                counts[node.judge] = (counts[node.judge] ?? 0) + 1;
+        }
+        else if (node.eval && builtinEvaluatorDefinitions[node.eval]?.kind !== 'mechanical') {
+            omitCost(`Unsupported cost source ${node.eval}: no declared inference cost model; omitted from subtotal.`);
+        }
+        for (const child of node.all ?? node.any ?? [])
+            visit(child, live);
+        if (node.not)
+            visit(node.not, live);
+        // passed/score references reuse results and never cause another model call.
+    };
+    for (const { check, live } of record.costChecks)
+        visit(check, live);
+    return counts;
+}
+//# sourceMappingURL=planning.js.map

package/dist/training/experiments/costs/planning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planning.js","sourceRoot":"","sources":["../../../../src/training/experiments/costs/planning.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAErE,OAAO,EAAE,2BAA2B,EAAE,wBAAwB,EAAE,kBAAkB,EAAqC,MAAM,sBAAsB,CAAC;AACpJ,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAuD5C,6FAA6F;AAC7F,MAAM,UAAU,gBAAgB,CAAC,OAA2D;IAC1F,MAAM,WAAW,GAAG,eAAe,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACzD,IAAI,OAAO,CAAC,IAAI,KAAK,YAAY,IAAI,WAAW,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IACpH,MAAM,OAAO,GAAG,CAAC,OAAsC,EAAE,EAAE;QACzD,MAAM,UAAU,GAAG,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,eAAe,CAAC,OAAO,CAAC,MAAM,CAAC,EAAmC,CAAC;QAC5G,OAAO,UAAU,CAAC,MAAM,KAAK,oCAAoC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAClH,CAAC,CAAC;IACF,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAChF,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE;QAC1F,MAAM,eAAe,GAAG,KAAK,CAAC,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC;QACxF,IAAI,eAAe,KAAK,CAAC,IAAI,eAAe,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,4CAA4C,IAAI,EAAE,CAAC,CAAC;QACxH,OAAO,CAAC,IAAI,EAAE,EAAE,GAAG,KAAK,EAAE,eAAe,EAAE,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC,CAAC;IACJ,IAAI,OAAO,CAAC,IAAI,KAAK,YAAY,IAAI,CAAC,OAAO,CAAC,YAAY,KAAK,CAAC,IAAI,OAAO,CAAC,cAAc,IAAI,OAAO,CAAC,cAAc,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACtL,IAAI,OAAO,CAAC,IAAI,KAAK,YAAY,IAAI,CAAC,OAAO,CAAC,cAAc,IAAI,CAAC,OAAO,CAAC,cAAc;QAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACxI,KAAK,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAChI,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAM,GAAG,CAAC,IAAI,KAAM,GAAG,GAAI;YAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IACnH,CAAC;IACD,MAAM,SAAS,GAAG,yBAAyB,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACzF,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;QAChG,MAAM,IAAI,KAAK,CAAC,0EAA0E,CAAC,CAAC;IAC9F,CAAC;IACD,wBAAwB,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC;IACtE,MAAM,kBAAkB,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,GAAG,WAAW,CAAC;IACjE,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,GAAG,kBAAkB,CAAC;IACxK,IAAI,OAAO,CAAC,IAAI,KAAK,YAAY,IAAI,WAAW,GAAG,kBAAkB,GAAG,OAAO,CAAC,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IACrK,IAAI,WAAW,GAAG,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,uEAAuE,CAAC,CAAC;IAChJ,MAAM,WAAW,GAAG,sBAAsB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAChE,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAS;QAC/B,OAAO,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,CAAC,yEAAyE,CAAC,CAAC,CAAC,4GAA4G;QACxN,8HAA8H;QAC9H,4HAA4H;QAC5H,+HAA+H;QAC/H,gHAAgH;KACjH,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1I,MAAM,qBAAqB,GAA+B,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,cAAc,EAAE,OAAO,EAAE,qBAAqB,CAAC,EAAE,CAAC;IACvJ,IAAI,QAAQ,CAAC,MAAM;QAAE,QAAQ,CAAC,GAAG,CAAC,wBAAwB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,kHAAkH,CAAC,CAAC;IACjM,MAAM,KAAK,GAAsB,EAAE,CAAC;IACpC,IAAI,UAAU,GAAG,KAAK,CAAC;IACvB,MAAM,QAAQ,GAAG,CAAC,OAAe,EAAE,EAAE,GAAG,UAAU,GAAG,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACpF,MAAM,GAAG,GAAG,CAAC,IAA6B,EAAE,IAAY,EAAE,KAA+B,EAAE,KAAa,EACtG,YAAoB,EAAE,aAA8B,EAAE,QAAiB,EAAE,EAAE;QAC3E,MAAM,MAAM,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,SAAkB,EAAE,CAAC;QAC/F,MAAM,GAAG,GAAG,UAAU,CAAC,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,aAAa,CAAC,WAAW,CAAC,GAAG;gBACrF,iBAAiB,EAAE,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,WAAW,CAAC,GAAG,GAAG,aAAa,CAAC,iBAAiB,CAAC,IAAI,CAAC;gBACnG,YAAY,EAAE,aAAa,CAAC,YAAY,CAAC,GAAG,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,EAAE,qBAAqB,EAAE,EAAE,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAC1H,MAAM,IAAI,GAAG,UAAU,CAAC,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,aAAa,CAAC,WAAW,CAAC,IAAI;gBACvF,iBAAiB,EAAE,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,WAAW,CAAC,IAAI,GAAG,aAAa,CAAC,iBAAiB,CAAC,GAAG,CAAC;gBACnG,YAAY,EAAE,aAAa,CAAC,YAAY,CAAC,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,EAAE,qBAAqB,EAAE,EAAE,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAC3H,MAAM,gBAAgB,GAAG,GAAG,CAAC,gBAAgB,IAAI,IAAI,CAAC,gBAAgB;YACpE,CAAC,CAAC,EAAE,GAAG,EAAE,YAAY,GAAG,GAAG,CAAC,gBAAgB,CAAC,GAAG,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAC7G,IAAI,gBAAgB,KAAK,IAAI;YAAE,QAAQ,CAAC,YAAY,IAAI,IAAI,IAAI,iBAAiB,KAAK,sBAAsB,CAAC,CAAC;QAC9G,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;IACtH,CAAC,CAAC;IACF,MAAM,WAAW,GAAG,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAClF,MAAM,QAAQ,GAAG,CAAC,IAA2B,EAAE,IAAY,EAAE,KAA+B,EAC1F,KAA4B,EAAE,KAAa,EAAE,OAAwB,EAAE,EAAE;QACzE,MAAM,MAAM,GAAG,CAAC,KAAK,EAAE,GAAG,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;QACjD,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC;QACjD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,IAAI,QAAQ,GAAG,MAAM,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QACzI,KAAK,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;YACpE,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAC1E,IAAI,KAAK,IAAI,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAE,CAAC,gBAAgB;gBAAE,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAE,CAAC,gBAAiB,CAAC,GAAG,GAAG,CAAC,CAAC;QACvF,CAAC;QACD,IAAI,QAAQ,GAAG,CAAC;YAAE,QAAQ,CAAC,GAAG,CAAC,GAAG,IAAI,IAAI,IAAI,6HAA6H,CAAC,CAAC;IAC/K,CAAC,CAAC;IACF,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,OAAO,IAAI,SAAS,EAAE,aAAa,EAAE,OAAO,CAAC,YAAY,EAAE,WAAW,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAC1H,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,OAAO,IAAI,SAAS,EAAE,UAAU,EAAE,OAAO,CAAC,YAAY,EAAE,kBAAkB,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAC9H,MAAM,iBAAiB,GAAG,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;IACnF,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC7E,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,iBAAiB,EAAE,GAAG,UAAU,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACpG,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,EAAE,CAAC,CAAC;QAC3D,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC;QAChE,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,iBAAiB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrF,MAAM,SAAS,GAAG,CAAC,GAAG,WAAW,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACrG,MAAM,QAAQ,GAAG,CAAC,GAAG,KAAK,CAAC,eAAe,CAAC;QAC3C,IAAI,KAAK,CAAC,eAAe;YAAE,QAAQ,CAAC,GAAG,CAAC,SAAS,IAAI,oIAAoI,CAAC,CAAC;QAC3L,MAAM,gBAAgB,GAAG,OAAO,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,GAAG,YAAY,CAAC;QAClK,IAAI,gBAAgB;YAAE,QAAQ,CAAC,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,gBAAgB,GAAG,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC1G,IAAI,SAAS;YAAE,QAAQ,CAAC,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,GAAG,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC3F,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,KAAK,YAAY;QAAE,QAAQ,CAAC,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,IAAI,EAAC,KAAK,EAAE,OAAO,CAAC,cAAe,EAAE,QAAQ,EAAE,qBAAqB,EAAC,EAAE,OAAO,CAAC,YAAY,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;IACjO,MAAM,iBAAiB,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,gBAAgB,EAAE,GAAG,IAAI,CAAC,CAAC;QACvG,IAAI,EAAE,GAAG,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,gBAAgB,EAAE,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;IAC/E,OAAO,EAAE,MAAM,EAAE,0CAA0C,EAAE,cAAc,EAAE,CAAC;QAC5E,OAAO,EAAE,iEAAiE,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW;QAC1H,MAAM,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE;QAC7G,cAAc,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,YAAY,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,YAAY;YAClF,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE;QAClF,WAAW,EAAE,qBAAqB,EAAE,KAAK,EAAE,gBAAgB,EAAE,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,iBAAiB,EAAE,iBAAiB,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC;AAClK,CAAC;AAED,SAAS,WAAW,CAAC,MAAkB,EAAE,QAAmC;IAC1E,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,MAAM,KAAK,GAAG,CAAC,IAAe,EAAE,IAAI,GAAG,KAAK,EAAE,EAAE;QAC9C,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAC/B,IAAI,IAAI;gBAAE,QAAQ,CAAC,wBAAwB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,6DAA6D,CAAC,CAAC;;gBACvH,MAAM,CAAC,IAAI,CAAC,KAAe,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,KAAe,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QAC9E,CAAC;aAAM,IAAI,IAAI,CAAC,IAAI,IAAI,2BAA2B,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,KAAK,YAAY,EAAE,CAAC;YACtF,QAAQ,CAAC,2BAA2B,IAAI,CAAC,IAAI,4DAA4D,CAAC,CAAC;QAC7G,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,IAAI,EAAE;YAAE,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACnE,IAAI,IAAI,CAAC,GAAG;YAAE,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACpC,4EAA4E;IAC9E,CAAC,CAAC;IACF,KAAK,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,MAAM,CAAC,UAAU;QAAE,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACpE,OAAO,MAAM,CAAC;AAChB,CAAC"}