spawnfile 0.1.24 → 0.1.27

package/dist/training/experiments/trials/live.js

@@ -0,0 +1,68 @@
+import { evaluateNode, mayStop } from '../../evaluation/index.js';
+function semantic(node, registry) {
+    if (node.eval)
+        return registry[node.eval]?.definition.kind !== 'mechanical';
+    if (node.not)
+        return semantic(node.not, registry);
+    return (node.all ?? node.any ?? []).some(child => semantic(child, registry));
+}
+export function createLiveMonitor(options) {
+    const history = [];
+    const pending = [];
+    const latest = new Map();
+    const artifactDigests = new Map();
+    let decisive;
+    let failed;
+    const checks = structuredClone(options.checks);
+    const selected = checks.filter(check => mayStop(check, options.registry));
+    async function evaluate(check, snapshot, boundary) {
+        const evaluated = await evaluateNode(check, { ...options.evaluation, snapshot, results: {}, scores: {}, signal: options.signal }, options.registry);
+        const entry = { checkId: check.id, boundary, result: evaluated };
+        await options.persist(entry);
+        history.push(entry);
+        latest.set(check.id, evaluated);
+        if (selected.includes(check) && evaluated.status === 'fail' && evaluated.finality === 'final' && !decisive) {
+            decisive = evaluated;
+            options.stop(`Decisive mechanical violation: ${check.id}`);
+        }
+    }
+    return {
+        history,
+        get decisive() { return decisive; },
+        async checkpoint(snapshot, boundary) {
+            for (const check of checks) {
+                if (typeof check.on === 'object' && !snapshot.closed) {
+                    const artifact = snapshot.artifacts[check.on.artifact];
+                    if (!artifact || artifactDigests.get(check.id) === artifact.digest)
+                        continue;
+                    artifactDigests.set(check.id, artifact.digest);
+                }
+                const frozen = structuredClone(snapshot);
+                if (semantic(check, options.registry) && !snapshot.closed) {
+                    // Advisory cognition cannot delay a native callback or gate a later stimulus.
+                    pending.push(evaluate(check, frozen, boundary).catch(error => { failed = error; }));
+                }
+                else
+                    await evaluate(check, frozen, boundary);
+            }
+        },
+        async close(snapshot, evaluateFinal = true) {
+            if (evaluateFinal && !decisive) {
+                for (const check of selected) {
+                    await evaluate(check, structuredClone(snapshot), 'closed');
+                    if (decisive)
+                        break;
+                }
+            }
+            await Promise.all(pending);
+            if (failed)
+                throw failed;
+            if (evaluateFinal && !decisive) {
+                for (const check of checks.filter(check => !selected.includes(check)))
+                    await evaluate(check, structuredClone(snapshot), 'closed');
+            }
+            return selected.flatMap(check => latest.has(check.id) ? [latest.get(check.id)] : []);
+        },
+    };
+}
+//# sourceMappingURL=live.js.map

package/dist/training/experiments/trials/live.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"live.js","sourceRoot":"","sources":["../../../../src/training/experiments/trials/live.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAGlE,SAAS,QAAQ,CAAC,IAAe,EAAE,QAA4B;IAC7D,IAAI,IAAI,CAAC,IAAI;QAAE,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC,IAAI,KAAK,YAAY,CAAC;IAC5E,IAAI,IAAI,CAAC,GAAG;QAAE,OAAO,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAClD,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;AAC/E,CAAC;AACD,MAAM,UAAU,iBAAiB,CAAC,OAOjC;IACC,MAAM,OAAO,GAAwB,EAAE,CAAC;IACxC,MAAM,OAAO,GAAoB,EAAE,CAAC;IACpC,MAAM,MAAM,GAAG,IAAI,GAAG,EAA4B,CAAC;IACnD,MAAM,eAAe,GAAG,IAAI,GAAG,EAAkB,CAAC;IAClD,IAAI,QAAsC,CAAC;IAC3C,IAAI,MAAe,CAAC;IACpB,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/C,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC1E,KAAK,UAAU,QAAQ,CAAC,KAAgB,EAAE,QAA4B,EAAE,QAAgB;QACtF,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC,KAAK,EAAE,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;QACpJ,MAAM,KAAK,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;QACjE,MAAM,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC7B,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpB,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;QAChC,IAAI,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC,MAAM,KAAK,MAAM,IAAI,SAAS,CAAC,QAAQ,KAAK,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC3G,QAAQ,GAAG,SAAS,CAAC;YACrB,OAAO,CAAC,IAAI,CAAC,kCAAkC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IACD,OAAO;QACL,OAAO;QACP,IAAI,QAAQ,KAAK,OAAO,QAAQ,CAAC,CAAC,CAAC;QACnC,KAAK,CAAC,UAAU,CAAC,QAA4B,EAAE,QAAgB;YAC7D,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,IAAI,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;oBACrD,MAAM,QAAQ,GAAG,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC;oBACvD,IAAI,CAAC,QAAQ,IAAI,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,QAAQ,CAAC,MAAM;wBAAE,SAAS;oBAC7E,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;gBACjD,CAAC;gBACD,MAAM,MAAM,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;gBACzC,IAAI,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;oBAC1D,8EAA8E;oBAC9E,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,GAAG,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBACtF,CAAC;;oBAAM,MAAM,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;YACjD,CAAC;QACH,CAAC;QACD,KAAK,CAAC,KAAK,CAAC,QAA4B,EAAE,aAAa,GAAG,IAAI;YAC5D,IAAI,aAAa,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAC/B,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;oBAC7B,MAAM,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAC;oBAC3D,IAAI,QAAQ;wBAAE,MAAM;gBACtB,CAAC;YACH,CAAC;YACD,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAC3B,IAAI,MAAM;gBAAE,MAAM,MAAM,CAAC;YACzB,IAAI,aAAa,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAC/B,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;oBAAE,MAAM,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAC;YACpI,CAAC;YACD,OAAO,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACxF,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/training/experiments/trials/paths.d.ts

@@ -0,0 +1,5 @@
+import type { TrialPaths } from './types.js';
+/** Separate subject scratch from evaluator storage when a native runtime needs it. */
+export declare function createTrialPaths(storageRoot: string, subjectRoot?: string): Promise<TrialPaths>;
+/** Only caller-allocated scratch is ephemeral; reports/control stay in the store. */
+export declare function releaseTrialScratch(paths: TrialPaths, subjectRoot: string | undefined, nativeClosed: boolean): Promise<void>;

package/dist/training/experiments/trials/paths.js

@@ -0,0 +1,90 @@
+import { constants } from 'node:fs';
+import { lstat, mkdir, mkdtemp, open, opendir, realpath, rm } from 'node:fs/promises';
+import { dirname, isAbsolute, join, relative, resolve, sep } from 'node:path';
+const contains = (parent, child) => {
+    const name = relative(parent, child);
+    return name === '' || name !== '..' && !name.startsWith(`..${sep}`) && !isAbsolute(name);
+};
+/**
+ * Requires confirmed native closure: no subject process remains alive. Handle-bound
+ * chmod protects the checked inode; ancestor swaps still require a concurrent
+ * writer, which the closure gate must exclude. This is not general race freedom.
+ */
+async function makeScratchRemovable(allocated) {
+    const uid = process.getuid?.();
+    let entries = 0;
+    async function visit(path, depth) {
+        if (++entries > 100_000 || depth > 256) {
+            throw new Error('Subject scratch permission walk exceeded its entry/depth limit');
+        }
+        const info = await lstat(path).catch((error) => {
+            if (error.code === 'ENOENT')
+                return undefined;
+            throw error;
+        });
+        if (info === undefined || info.isSymbolicLink() || !info.isDirectory())
+            return;
+        if (!contains(allocated, path) || await realpath(path) !== path) {
+            throw new Error('Refusing permission changes outside allocated subject scratch');
+        }
+        if (uid === undefined || info.uid !== uid) {
+            throw new Error(`Refusing permission changes to subject scratch owned by another uid: ${path}`);
+        }
+        const handle = await open(path, constants.O_RDONLY | constants.O_DIRECTORY | constants.O_NOFOLLOW);
+        try {
+            const opened = await handle.stat();
+            if (!opened.isDirectory() || opened.uid !== uid || opened.dev !== info.dev || opened.ino !== info.ino) {
+                throw new Error(`Refusing permission changes to replaced subject scratch: ${path}`);
+            }
+            // Unlinking needs write/search on the parent; read-only files need no changes.
+            if ((opened.mode & 0o300) !== 0o300)
+                await handle.chmod(opened.mode | 0o300);
+            // Node's public opendir API cannot enumerate a FileHandle. Path-based
+            // enumeration therefore relies on the same no-concurrent-writer precondition.
+            const directory = await opendir(path);
+            for await (const entry of directory)
+                await visit(join(path, entry.name), depth + 1);
+        }
+        finally {
+            await handle.close();
+        }
+    }
+    await visit(allocated, 0);
+}
+/** Separate subject scratch from evaluator storage when a native runtime needs it. */
+export async function createTrialPaths(storageRoot, subjectRoot) {
+    const storage = resolve(storageRoot);
+    if (subjectRoot !== undefined && (!isAbsolute(subjectRoot) || resolve(subjectRoot) !== subjectRoot ||
+        contains(subjectRoot, storage) || contains(storage, subjectRoot))) {
+        throw new Error('Subject scratch must be an absolute root disjoint from evaluator storage');
+    }
+    await mkdir(storage, { recursive: true, mode: 0o700 });
+    if (subjectRoot !== undefined) {
+        await mkdir(subjectRoot, { recursive: true, mode: 0o700 });
+        const actualStorage = await realpath(storage);
+        if (contains(subjectRoot, actualStorage) || contains(actualStorage, subjectRoot)) {
+            throw new Error('Subject scratch overlaps the resolved evaluator storage');
+        }
+        const info = await lstat(subjectRoot);
+        if (!info.isDirectory() || info.isSymbolicLink() || await realpath(subjectRoot) !== subjectRoot) {
+            throw new Error('Subject scratch must be a real directory without symlink traversal');
+        }
+    }
+    const root = await mkdtemp(join(storage, 'trial-'));
+    const native = subjectRoot === undefined ? root : await mkdtemp(join(subjectRoot, 'trial-'));
+    const paths = { root, workspace: join(native, 'workspace'), control: join(root, 'control'), runtimeHome: join(root, 'runtime') };
+    await Promise.all([paths.workspace, paths.control, paths.runtimeHome].map(path => mkdir(path, { mode: 0o700 })));
+    return paths;
+}
+/** Only caller-allocated scratch is ephemeral; reports/control stay in the store. */
+export async function releaseTrialScratch(paths, subjectRoot, nativeClosed) {
+    if (subjectRoot === undefined || !nativeClosed)
+        return;
+    const allocated = dirname(paths.workspace);
+    if (dirname(allocated) !== subjectRoot || !allocated.startsWith(join(subjectRoot, 'trial-'))) {
+        throw new Error('Refusing to remove unowned subject scratch');
+    }
+    await makeScratchRemovable(allocated);
+    await rm(allocated, { recursive: true, force: true });
+}
+//# sourceMappingURL=paths.js.map

package/dist/training/experiments/trials/paths.js.map

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

package/dist/training/experiments/trials/preflight.d.ts

@@ -0,0 +1,3 @@
+import type { CheckNode } from '../../contracts/dataset.js';
+import type { EvaluationRegistry } from '../../contracts/evaluation.js';
+export declare function requireMechanicalTurn(checks: readonly CheckNode[], registry: EvaluationRegistry): void;

package/dist/training/experiments/trials/preflight.js

@@ -0,0 +1,23 @@
+export function requireMechanicalTurn(checks, registry) {
+    const prior = new Set();
+    function mechanical(node) {
+        const operations = ['eval', 'all', 'any', 'not', 'passed', 'score'].filter(key => Object.hasOwn(node, key));
+        if (operations.length !== 1)
+            return false;
+        if (node.eval)
+            return registry[node.eval]?.definition.kind === 'mechanical';
+        if (node.passed || node.score)
+            return prior.has((node.passed ?? node.score));
+        if (node.not)
+            return mechanical(node.not);
+        const children = node.all ?? node.any;
+        return Boolean(children?.length && children.every(mechanical));
+    }
+    for (const check of checks) {
+        if (!mechanical(check))
+            throw new Error('Native turn gates require self-contained mechanical criteria');
+        if (check.id)
+            prior.add(check.id);
+    }
+}
+//# sourceMappingURL=preflight.js.map

package/dist/training/experiments/trials/preflight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.js","sourceRoot":"","sources":["../../../../src/training/experiments/trials/preflight.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,qBAAqB,CAAC,MAA4B,EAAE,QAA4B;IAC9F,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,SAAS,UAAU,CAAC,IAAe;QACjC,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;QAC5G,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QAC1C,IAAI,IAAI,CAAC,IAAI;YAAE,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC,IAAI,KAAK,YAAY,CAAC;QAC5E,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK,CAAE,CAAC,CAAC;QAC9E,IAAI,IAAI,CAAC,GAAG;YAAE,OAAO,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;QACtC,OAAO,OAAO,CAAC,QAAQ,EAAE,MAAM,IAAI,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;IACjE,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;QACxG,IAAI,KAAK,CAAC,EAAE;YAAE,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACpC,CAAC;AACH,CAAC"}

package/dist/training/experiments/trials/stored.d.ts

@@ -0,0 +1,23 @@
+import type { CandidateManifest } from '../../candidates/index.js';
+import type { ExperimentStore } from '../../storage/index.js';
+import type { TrialOptions, TrialReport, TrialEvent } from './types.js';
+/** Evaluator-owned preparation data; never implicitly delivered to the subject. */
+export interface NativePreparationContext {
+    slot?: TrialOptions['slot'];
+    id: string;
+    phase: TrialOptions['phase'];
+    record: TrialOptions['record'];
+    candidate: CandidateManifest;
+    resources: Record<string, string>;
+}
+export interface StoredTrialOptions extends Omit<TrialOptions, 'candidateId' | 'persist' | 'prepare'> {
+    datasetId: string;
+    candidate: CandidateManifest;
+    store: ExperimentStore;
+    storeRoot: string;
+    /** Called only after the event has reached the protected durable store. */
+    observeEvent?: (event: TrialEvent) => Promise<void>;
+    /** The environment may install tools/state; instructions come from declared candidate resources. */
+    prepareEnvironment?: (paths: Parameters<TrialOptions['prepare']>[0], signal: AbortSignal, context: NativePreparationContext) => Promise<Omit<Awaited<ReturnType<TrialOptions['prepare']>>, 'instructions'>>;
+}
+export declare function runStoredTrial(options: StoredTrialOptions): Promise<TrialReport>;

package/dist/training/experiments/trials/stored.js

@@ -0,0 +1,46 @@
+import { canonicalWireId } from '../../contracts/index.js';
+import { randomUUID } from 'node:crypto';
+import { materializeCandidate, validateCandidate } from '../../candidates/index.js';
+import { runTrial } from './trial.js';
+export async function runStoredTrial(options) {
+    if ('schema' in options.record && canonicalWireId(options.record.schema) === 'spawnfile.training.cost-record.v1')
+        throw new Error('Cost-only records cannot execute trials');
+    validateCandidate(options.candidate);
+    const instructions = options.candidate.resources.filter(resource => resource.destinations.some(destination => destination.kind === 'instructions'));
+    if (!instructions.length)
+        throw new Error('Candidate has no native instruction resource');
+    for (const resource of options.candidate.resources) {
+        for (const destination of resource.destinations) {
+            if (!options.adapter.capabilities.resources.includes(destination.kind))
+                throw new Error(`Adapter does not support ${destination.kind}`);
+        }
+    }
+    if (options.record.setup && !options.prepareEnvironment)
+        throw new Error('Record requires a registered native environment preparation');
+    await options.store.createRun({ schema: 'spawnfile.training.run.v1', id: options.id, datasetId: options.datasetId,
+        datasetRole: options.phase, candidateId: options.candidate.id, planDigest: options.planDigest, recordId: options.record.id,
+        metadata: { adapter: options.adapter.id, model: options.model, timeoutMs: options.timeoutMs } });
+    await options.store.putBlob(options.id, JSON.stringify(options.candidate), 'evaluator');
+    await options.store.putBlob(options.id, JSON.stringify(options.record), 'evaluator');
+    const report = await runTrial({ ...options, candidateId: options.candidate.id,
+        protectedPaths: [options.storeRoot, ...(options.protectedPaths ?? [])],
+        persist: async (event) => {
+            await options.store.appendEvent(options.id, { id: randomUUID(), payload: event }, 'raw');
+            await options.observeEvent?.(event);
+        },
+        prepare: async (paths, signal) => {
+            const receipts = await materializeCandidate(options.candidate, paths.workspace);
+            const environment = await options.prepareEnvironment?.(paths, signal, structuredClone({
+                id: options.id, phase: options.phase, record: options.record, slot: options.slot,
+                candidate: options.candidate, resources: { ...options.resources },
+            }));
+            await options.store.appendEvent(options.id, { id: randomUUID(), payload: { type: 'candidate.installed', receipts } }, 'evaluator');
+            return { ...environment, instructions: instructions.map(resource => resource.content).join('\n\n') };
+        } });
+    report.candidate = structuredClone(options.candidate);
+    if (options.round !== undefined)
+        report.round = options.round;
+    await options.store.appendEvaluation(options.id, { id: randomUUID(), report }, 'evaluator');
+    return report;
+}
+//# sourceMappingURL=stored.js.map

package/dist/training/experiments/trials/stored.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stored.js","sourceRoot":"","sources":["../../../../src/training/experiments/trials/stored.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAGpF,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAuBtC,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAA2B;IAC9D,IAAI,QAAQ,IAAI,OAAO,CAAC,MAAM,IAAI,eAAe,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,mCAAmC;QAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7K,iBAAiB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACrC,MAAM,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,WAAW,CAAC,IAAI,KAAK,cAAc,CAAC,CAAC,CAAC;IACpJ,IAAI,CAAC,YAAY,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAC1F,KAAK,MAAM,QAAQ,IAAI,OAAO,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC;QACnD,KAAK,MAAM,WAAW,IAAI,QAAQ,CAAC,YAAY,EAAE,CAAC;YAChD,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;QAC1I,CAAC;IACH,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,kBAAkB;QAAE,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;IACxI,MAAM,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,2BAA2B,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS;QAC/G,WAAW,EAAE,OAAO,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,CAAC,SAAS,CAAC,EAAE,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE;QAC1H,QAAQ,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IACnG,MAAM,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,WAAW,CAAC,CAAC;IACxF,MAAM,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC,CAAC;IACrF,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,EAAE,GAAG,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC,SAAS,CAAC,EAAE;QAC3E,cAAc,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC;QACtE,OAAO,EAAE,KAAK,EAAC,KAAK,EAAC,EAAE;YACrB,MAAM,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,KAAK,CAAC,CAAC;YACzF,MAAM,OAAO,CAAC,YAAY,EAAE,CAAC,KAAK,CAAC,CAAC;QACtC,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YAC/B,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;YAChF,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,kBAAkB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,eAAe,CAAC;gBACpF,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI;gBAChF,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,SAAS,EAAE,EAAE,GAAG,OAAO,CAAC,SAAS,EAAE;aAClE,CAAC,CAAC,CAAC;YACJ,MAAM,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,qBAAqB,EAAE,QAAQ,EAAE,EAAE,EAAE,WAAW,CAAC,CAAC;YACnI,OAAO,EAAE,GAAG,WAAW,EAAE,YAAY,EAAE,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACvG,CAAC,EAAE,CAAC,CAAC;IACP,MAAM,CAAC,SAAS,GAAG,eAAe,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACtD,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS;QAAE,MAAM,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAC9D,MAAM,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,EAAE,WAAW,CAAC,CAAC;IAC5F,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/training/experiments/trials/subject-usage.d.ts

@@ -0,0 +1,7 @@
+import type { SubjectUsageSnapshot } from '../../contracts/evaluation.js';
+import type { SubjectTurnResult } from '../../contracts/execution.js';
+/** Sum returned per-turn totals exactly once. Caller separately attests lifecycle closure. */
+export declare function subjectUsageSnapshot(turns: readonly SubjectTurnResult[], options: {
+    expectedTurns: number;
+    complete: boolean;
+}): SubjectUsageSnapshot;

package/dist/training/experiments/trials/subject-usage.js

@@ -0,0 +1,66 @@
+const required = ['inputTokens', 'cachedInputTokens', 'outputTokens', 'reasoningTokens'];
+const optional = ['cacheWriteInputTokens', 'cacheWrite5mInputTokens', 'cacheWrite1hInputTokens'];
+const validNumber = (value) => typeof value === 'number' && Number.isSafeInteger(value) && value >= 0;
+/** Validate native totals before arithmetic; cache and reasoning are subsets, not extra tokens. */
+function validUsage(usage) {
+    if (typeof usage.source !== 'string' || !usage.source.trim())
+        return false;
+    if (required.some(key => usage[key] !== null && !validNumber(usage[key])) ||
+        optional.some(key => usage[key] !== undefined && usage[key] !== null && !validNumber(usage[key])))
+        return false;
+    if (usage.inputTokens !== null && usage.outputTokens !== null && !Number.isSafeInteger(usage.inputTokens + usage.outputTokens))
+        return false;
+    if (usage.inputTokens !== null && usage.cachedInputTokens !== null && usage.cachedInputTokens > usage.inputTokens)
+        return false;
+    if (usage.outputTokens !== null && usage.reasoningTokens !== null && usage.reasoningTokens > usage.outputTokens)
+        return false;
+    if (usage.inputTokens !== null && usage.cacheWriteInputTokens != null &&
+        (usage.cachedInputTokens ?? 0) + usage.cacheWriteInputTokens > usage.inputTokens)
+        return false;
+    if (usage.cacheWriteInputTokens != null && (usage.cacheWrite5mInputTokens ?? 0) + (usage.cacheWrite1hInputTokens ?? 0) > usage.cacheWriteInputTokens)
+        return false;
+    if (usage.notionalUsd != null && (typeof usage.notionalUsd !== 'number' || !Number.isFinite(usage.notionalUsd) || usage.notionalUsd < 0))
+        return false;
+    return true;
+}
+/** Sum returned per-turn totals exactly once. Caller separately attests lifecycle closure. */
+export function subjectUsageSnapshot(turns, options) {
+    const missing = { status: 'incomplete', usage: null };
+    if (!turns.length || turns.some(turn => turn.usage === null || !validUsage(turn.usage)))
+        return missing;
+    const totals = turns.map(turn => turn.usage);
+    let usage;
+    if (totals.length === 1)
+        usage = structuredClone(totals[0]);
+    else {
+        usage = { inputTokens: null, cachedInputTokens: null, outputTokens: null, reasoningTokens: null, source: 'spawnfile.training.subject.returned-turn-totals.v1' };
+        for (const key of [...required, ...optional]) {
+            if (optional.includes(key) && totals.every(row => row[key] === undefined))
+                continue;
+            if (totals.some(row => row[key] == null)) {
+                usage[key] = null;
+                continue;
+            }
+            const total = totals.reduce((sum, row) => sum + row[key], 0);
+            if (!Number.isSafeInteger(total))
+                return missing;
+            usage[key] = total;
+        }
+        if (totals.some(row => row.notionalUsd !== undefined)) {
+            usage.notionalUsd = totals.some(row => row.notionalUsd == null) ? null : totals.reduce((sum, row) => sum + row.notionalUsd, 0);
+        }
+        if (!validUsage(usage))
+            return missing;
+    }
+    // Settlement is the execution's closure: completed (or declared-limit-stopped) turns, host settled, stop proven. It
+    // deliberately omits usage coverage, which a retried attempt can leave partial.
+    const settled = options.complete && options.expectedTurns > 0 && Number.isSafeInteger(options.expectedTurns) &&
+        turns.length === options.expectedTurns && turns.every(turn => (turn.status === 'completed' || turn.status === 'failed' && turn.limit !== undefined) &&
+        (!turn.stop || turn.stop.state === 'acknowledged' && turn.stop.quiescence === 'confirmed'));
+    const complete = settled && usage.inputTokens !== null && usage.outputTokens !== null && turns.every(turn => {
+        const channels = turn.coverage.filter(row => row.channel === 'usage');
+        return channels.length > 0 && channels.every(row => row.completeness === 'complete');
+    });
+    return { status: complete ? 'complete' : 'incomplete', usage, ...(settled ? { settled } : {}) };
+}
+//# sourceMappingURL=subject-usage.js.map

package/dist/training/experiments/trials/subject-usage.js.map

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

package/dist/training/experiments/trials/trial.d.ts

@@ -0,0 +1,11 @@
+import type { EvaluationSnapshot } from '../../contracts/evaluation.js';
+import type { TrialOptions, TrialReport, TurnReport } from './types.js';
+/** Re-derived from persisted counters, never from a failure label alone. */
+export declare function hasUnadmittedExecution(turns: readonly TurnReport[]): boolean;
+/** Retained evidence vetoes replacement, including reports classified by older runners. */
+export declare function hasSubjectBehavior(evidence: {
+    turns: readonly TurnReport[];
+    snapshot: Pick<EvaluationSnapshot, 'events' | 'output' | 'artifacts' | 'subjectUsage'>;
+    decisiveFailure?: TrialReport['decisiveFailure'];
+}): boolean;
+export declare function runTrial(options: TrialOptions): Promise<TrialReport>;