spawnfile 0.1.25 → 0.1.28

package/dist/training/cli/types.d.ts

@@ -0,0 +1,101 @@
+import type { InferenceProviderRegistry } from '../contracts/inference-registry.js';
+import type { GraderDependencies } from './grader/index.js';
+import type { TrainingModel } from '../contracts/training-config.js';
+import type { InferenceGrantAuthority, InferenceProvider, SubjectAdapter } from '../contracts/index.js';
+import type { BlobReference } from '../storage/index.js';
+import type { DatasetRegistry, EditPolicy, NativePreparationContext, StoredTrialOptions } from '../index.js';
+import type { TrainingMomentPreparation } from './spawnfile/moments.js';
+import type { SpawnfileTrainingContext } from './spawnfile/index.js';
+import type { SubjectAdapterRegistry } from '../subjects/index.js';
+/** Adapter-owned durable experiment services, passed unchanged to integration hooks. */
+export type NativeTrialServices = Readonly<Record<string, unknown>>;
+export interface CliIO {
+    cwd: string;
+    stdout(text: string): void;
+    stderr(text: string): void;
+    signal?: AbortSignal;
+}
+/** Tests inject only the native/inference boundaries; experiment/storage code stays real. */
+export interface CliDependencies {
+    inferenceProviders?: InferenceProviderRegistry;
+    subjects?: SubjectAdapterRegistry;
+    /** Runtime composition supplies durable native services; the core treats their keys as opaque. */
+    createTrialServices?: (stateRoot: string) => NativeTrialServices;
+    /** Canonical host context, validated against pinned source bytes without a temporary receipt file. */
+    spawnfileContext?: SpawnfileTrainingContext;
+    grader?: GraderDependencies;
+    /** Container integrations may bind internally; the launcher must publish only on host loopback. */
+    viewerBindHost?: '127.0.0.1' | '0.0.0.0';
+    adapter?: (runtime: string, options: {
+        model: string;
+        timeoutMs: number;
+    }) => SubjectAdapter;
+    inference?: (timeoutMs: number) => InferenceProvider;
+    modelInference?: (model: TrainingModel, timeoutMs: number) => InferenceProvider;
+    /** Broker-grant authority seam; defaults to the injected subject capability over the container control socket. */
+    grantAuthority?: () => Promise<InferenceGrantAuthority>;
+    /** Trusted project composition. Registration is static; native factory runs only after preflight. */
+    spawnfile?: SpawnfileCliIntegration;
+}
+export interface CliExecutionIdentityContext {
+    /** Content identity of the frozen authored replacement; no optimizer bridge in comparison mode. */
+    comparisonCandidateId?: string;
+    /** Exact normalized optimizer bridge launch; absent for authored comparison. */
+    bridge?: Readonly<{
+        command: string;
+        cwd: string;
+    }>;
+}
+export interface SpawnfileCliIntegration {
+    id: string;
+    version: string;
+    /** Native scratch path inside the launch environment; never an evaluator root. */
+    subjectRoot?: string;
+    /** Trusted immutable inference image + invocation-policy identity; omitted means ambient host execution. */
+    readonly inferenceExecutionIdentity?: string;
+    /** Existing canonical writable cache base; relative YAML directories resolve beneath it in this execution. */
+    readonly judgeCacheRoot?: string;
+    preparations?: DatasetRegistry['preparations'];
+    unlockedSetupPaths?: readonly string[];
+    /** Named trusted hooks re-materialize authored cases into fresh per-trial state. */
+    momentPreparations?: Readonly<Record<string, TrainingMomentPreparation>>;
+    /** Narrows explicitly selected editable files to their declared sections. Cannot unlock identity. */
+    editPolicies?: Readonly<Record<string, EditPolicy>>;
+    /** Resolved public optimizer and optional hard boundaries (max 50, each 1..500 characters).
+     * YAML declarations must match; local configuration only, no execution. */
+    trainingOptimizer?(context: SpawnfileTrainingContext): Promise<{
+        method: 'gepa';
+        model: string;
+        variants: number;
+        keep: number;
+        budget: {
+            rounds: number;
+        };
+        boundaries?: string[];
+    } | undefined>;
+    /** Hash of immutable preparation/image/tool/evidence inputs; excludes credentials and generated state. */
+    executionIdentity?: (context: CliExecutionIdentityContext) => string | Promise<string>;
+    createAdapter(context: SpawnfileTrainingContext, options: {
+        model: string;
+        timeoutMs: number;
+    } & NativeTrialServices): SubjectAdapter;
+    prepareEnvironment(paths: Parameters<NonNullable<StoredTrialOptions['prepareEnvironment']>>[0], signal: AbortSignal, trial: NativePreparationContext, context: SpawnfileTrainingContext, services: NativeTrialServices): ReturnType<NonNullable<StoredTrialOptions['prepareEnvironment']>>;
+}
+export interface InvocationIndex {
+    schema: 'spawnfile.training.invocation.v1';
+    /** Absent for existing completed invocations. Failure never releases sealed tests. */
+    outcome?: 'failed';
+    command: 'evaluate' | 'train';
+    summaryRunId: string;
+    phase: 'train' | 'test';
+    candidateId: string;
+    trialIds: string[];
+    report: BlobReference;
+    candidate: BlobReference;
+    /** Immutable completed operator export; never exposed through optimizer blob access. */
+    trainingExport?: {
+        directory: string;
+        markdown: string;
+        json: string;
+    };
+}

package/dist/training/cli/types.js

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

package/dist/training/cli/types.js.map

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

package/dist/training/cli/viewer.d.ts

@@ -0,0 +1,40 @@
+import { type CandidateManifest } from '../candidates/index.js';
+import type { TrainingReport } from '../experiments/index.js';
+import { type ModelPrice, type TrainingCostPlan } from '../experiments/costs/index.js';
+import { type ExperimentStore } from '../storage/index.js';
+import { type ViewerData } from '../viewer/index.js';
+import type { CliIO } from './types.js';
+export declare function loadInvocationViewer(root: string): Promise<() => Promise<ViewerData>>;
+export declare function viewInvocation(root: string, port: number, io: CliIO, signal: AbortSignal): Promise<void>;
+export declare function startLiveViewer(options: {
+    bindHost?: '127.0.0.1' | '0.0.0.0';
+    port: number;
+    io: CliIO;
+    store: ExperimentStore;
+    id: string;
+    datasetId: string;
+    planDigest: string;
+    baseline: CandidateManifest;
+    cases: ViewerData['cases'];
+    testCases: ViewerData['cases'];
+    comparison?: {
+        candidate: CandidateManifest;
+        name: string;
+    };
+    budget?: {
+        maxMetricCalls: number;
+        maxProposals: number;
+    };
+    scoring?: TrainingReport['scoring'];
+    costs?: {
+        subjectModel: string;
+        prices?: readonly ModelPrice[];
+        costPlan?: TrainingCostPlan;
+    };
+}): Promise<{
+    close: () => Promise<void>;
+    observe(event: {
+        type: string;
+        payload: unknown;
+    }): Promise<void>;
+}>;

package/dist/training/cli/viewer.js

@@ -0,0 +1,210 @@
+import { canonicalWireId } from '../contracts/index.js';
+import { compatibleWireLiteral } from '../contracts/index.js';
+import { randomUUID } from 'node:crypto';
+import { join } from 'node:path';
+import { z } from 'zod';
+import { assertOriginalPolicy, validateCandidate } from '../candidates/index.js';
+import { summarizeCosts } from '../experiments/costs/index.js';
+import { hydrateEvaluationJson, openExperimentStore } from '../storage/index.js';
+import { projectComparisonReport, projectTrainingReport, projectTrials, startViewer } from '../viewer/index.js';
+import { readCliText } from './datasets.js';
+import { loadFailureView, createActivityTracker, createGenerationTracker } from './progress/index.js';
+const id = z.string().min(1);
+const reference = z.object({ runId: id, id, digest: id, size: z.number().int().nonnegative() }).strict();
+const indexSchema = z.object({ schema: compatibleWireLiteral('spawnfile.training.invocation.v1'), command: z.enum(['evaluate', 'train']),
+    outcome: z.literal('failed').optional(),
+    summaryRunId: id, phase: z.enum(['train', 'test']), candidateId: id, trialIds: z.array(id),
+    report: reference, candidate: reference,
+    trainingExport: z.object({ directory: id, markdown: id, json: id }).strict().optional() }).strict();
+const budgetSchema = z.object({ maxMetricCalls: z.number().int().nonnegative(), maxProposals: z.number().int().nonnegative() });
+export async function loadInvocationViewer(root) {
+    // Resolve the explicit existing index before opening the store; an absent view never creates an output directory.
+    const index = indexSchema.parse(JSON.parse(readCliText(join(root, 'invocation.json'), 2_000_000)));
+    if (index.phase !== (index.command === 'train' && index.outcome !== 'failed' ? 'test' : 'train')
+        || index.report.runId !== index.summaryRunId || index.candidate.runId !== index.summaryRunId)
+        throw new Error('Invocation index references inconsistent phases or summaries');
+    const store = await openExperimentStore(root);
+    const access = { audience: 'operator', phase: 'replay',
+        frozenCandidateIds: [index.candidateId], releaseTestResults: index.phase === 'test' };
+    return async () => {
+        const replay = await store.readReplay(index.summaryRunId, access);
+        if (replay.manifest.candidateId !== index.candidateId || replay.manifest.datasetRole !== index.phase)
+            throw new Error('Invocation index does not match its stored manifest');
+        const candidate = JSON.parse((await store.readBlob(index.candidate, access)).toString());
+        validateCandidate(candidate);
+        if (candidate.id !== index.candidateId)
+            throw new Error('Stored invocation candidate does not match its identity');
+        const report = await hydrateEvaluationJson(store, JSON.parse((await store.readBlob(index.report, access)).toString()), access);
+        if (index.outcome === 'failed')
+            return loadFailureView(report, index, store);
+        if (index.command === 'train') {
+            if (canonicalWireId(report.schema) === 'spawnfile.training.comparison.v1') {
+                if (report.id !== index.summaryRunId || report.candidate.id !== candidate.id)
+                    throw new Error('Stored comparison does not match its invocation');
+                assertOriginalPolicy(report.baseline, report.candidate);
+                return projectComparisonReport(report);
+            }
+            if (canonicalWireId(report.schema) !== 'spawnfile.training.training.v1' || report.id !== index.summaryRunId || report.selected.id !== candidate.id)
+                throw new Error('Stored training report does not match its invocation');
+            const metadata = replay.manifest.metadata;
+            const budget = metadata?.optimizerBudget === undefined ? undefined : budgetSchema.parse(metadata.optimizerBudget);
+            return projectTrainingReport(report, budget);
+        }
+        if (canonicalWireId(report.schema) !== 'spawnfile.training.cli-evaluation.v1' || report.candidateId !== candidate.id)
+            throw new Error('Stored evaluation report does not match its invocation');
+        const trials = report.trials;
+        return projectTrials({ id: index.summaryRunId, title: 'Completed evaluation experiment', phase: 'replay',
+            status: replay.completeness, updatedAt: 'Recorded completion', baseline: candidate, trials,
+            costs: report.costs, costPlan: report.costPlan,
+            cases: trials.map((trial) => ({ id: trial.recordId, split: trial.phase })) });
+    };
+}
+export async function viewInvocation(root, port, io, signal) {
+    const load = await loadInvocationViewer(root);
+    await load(); // Validate the saved invocation before announcing a server.
+    signal.throwIfAborted();
+    const server = await startViewer({ load, port });
+    io.stdout(`${JSON.stringify({ viewer: server.url, mode: 'stored replay' })}\n`);
+    try {
+        await new Promise((resolve) => {
+            if (signal.aborted)
+                resolve();
+            else
+                signal.addEventListener('abort', () => resolve(), { once: true });
+        });
+    }
+    finally {
+        await server.close();
+    }
+}
+export async function startLiveViewer(options) {
+    const runId = `viewer-${options.id}`;
+    await options.store.createRun({ schema: 'spawnfile.training.run.v1', id: runId, datasetId: options.datasetId,
+        datasetRole: 'train', candidateId: options.baseline.id, planDigest: options.planDigest });
+    let frozen = false, unavailable = false;
+    let optimizer;
+    let status = 'starting';
+    let lastPersisted;
+    let proposalAttempts = 0;
+    const generations = createGenerationTracker();
+    const trials = [];
+    const rescores = [];
+    const sealedTrials = new Map();
+    const sealedRescores = new Map();
+    const activity = createActivityTracker();
+    let cases = options.cases;
+    const publish = async () => {
+        try {
+            const data = projectTrials({ id: options.id, title: options.comparison ? `Authored comparison: ${options.comparison.name}` : 'Live native experiment', phase: frozen ? 'final-test' : 'train',
+                status, updatedAt: new Date().toISOString(), baseline: options.baseline, comparison: options.comparison, cases,
+                trials: status === 'failed' ? trials.filter(trial => trial.phase !== 'test') : trials, optimizer, budget: options.budget, scoring: options.scoring,
+                rescores: status === 'failed' ? rescores.filter(score => score.original.phase !== 'test') : rescores,
+                costs: options.costs === undefined ? undefined : summarizeCosts([...new Map([...trials, ...sealedTrials.values()].map(trial => [trial.id, trial])).values()], { ...options.costs,
+                    rescores: [...new Map([...rescores, ...sealedRescores.values()].map(score => [score.id, score])).values()], optimizerGenerations: generations.snapshot() }),
+                costPlan: options.costs?.costPlan });
+            if (!options.comparison && optimizer === undefined && options.budget !== undefined)
+                data.optimizer = { name: 'dspy.GEPA',
+                    status: 'Observed progress; evaluation count includes completed trial reports',
+                    evaluations: trials.filter((trial) => trial.phase !== 'test').length, proposals: proposalAttempts, ...options.budget };
+            data.activity = status === 'failed' ? undefined : activity.snapshot();
+            data.usage = [...data.usage.filter((entry) => entry.purpose !== 'optimizer'), ...generations.snapshot().map(generation => ({ purpose: 'optimizer', model: generation.model, modelBasis: generation.modelBasis,
+                    route: generation.route ?? null, usage: generation.usage }))];
+            if (status === 'failed') {
+                data.usage = [];
+                if (data.optimizer)
+                    data.optimizer.status = 'failed';
+            }
+            await options.store.appendEvent(runId, { id: randomUUID(), payload: data }, 'public');
+            lastPersisted = data;
+            unavailable = false;
+        }
+        catch {
+            unavailable = true;
+            options.io.stderr('Viewer snapshot unavailable; native evidence capture continues.\n');
+        }
+    };
+    await publish();
+    const server = await startViewer({ port: options.port, bindHost: options.bindHost, load: async () => {
+            if (unavailable)
+                throw new Error('Viewer snapshot unavailable');
+            const replay = await options.store.readReplay(runId, { audience: 'viewer', phase: 'training' });
+            return replay.events.at(-1).payload;
+        } });
+    options.io.stdout(`${JSON.stringify({ viewer: server.url, progressRunId: runId })}\n`);
+    return {
+        close: () => server.close(lastPersisted),
+        async observe(event) {
+            if (status === 'failed')
+                return;
+            const generationEvent = generations.observe(event);
+            proposalAttempts = generations.attempts();
+            if (event.type === 'trial.progress') {
+                const payload = event.payload;
+                if (payload.phase === 'test' && !frozen)
+                    return;
+                activity.observe(payload);
+            }
+            else if (event.type === 'trial.rescored' || event.type === 'trial.rescore.restored') {
+                const score = event.payload;
+                if (score.original.phase === 'test' && !frozen) {
+                    sealedRescores.set(score.id, score);
+                    await publish();
+                    return;
+                }
+                if (!rescores.some(row => row.id === score.id))
+                    rescores.push(score);
+            }
+            else if (event.type === 'trial.finished' || event.type === 'trial.restored') {
+                const report = event.payload;
+                if (report.phase === 'test' && !frozen) {
+                    sealedTrials.set(report.id, report);
+                    await publish();
+                    return;
+                }
+                if (!trials.some(row => row.id === report.id))
+                    trials.push(report);
+                status = 'running';
+            }
+            else if (event.type === 'training.started' || event.type === 'comparison.started') {
+                const payload = event.payload;
+                cases = [...payload.train.map((id) => ({ id, split: 'train' })),
+                    ...payload.validation.map((id) => ({ id, split: 'validation' }))];
+                status = options.comparison ? 'comparing frozen arms' : 'optimizing';
+            }
+            else if (event.type === 'selection.frozen' || event.type === 'comparison.frozen') {
+                frozen = true;
+                if (!options.comparison)
+                    optimizer = event.payload.optimizer;
+                for (const report of sealedTrials.values())
+                    if (!trials.some(trial => trial.id === report.id))
+                        trials.push(report);
+                for (const report of sealedRescores.values())
+                    if (!rescores.some(score => score.id === report.id))
+                        rescores.push(report);
+                sealedTrials.clear();
+                sealedRescores.clear();
+                cases = [...cases, ...options.testCases];
+                status = options.comparison ? 'testing frozen arms' : 'testing frozen selection';
+            }
+            else if (event.type === 'optimizer.generation.started') {
+                status = 'reflecting';
+            }
+            else if (generationEvent) {
+                status = 'running';
+            }
+            else if (event.type === 'experiment.failed') {
+                status = 'failed';
+                frozen = false;
+                optimizer = undefined;
+                cases = cases.filter(record => record.split !== 'test');
+                generations.interrupt();
+            }
+            else if (event.type === 'training.completed' || event.type === 'comparison.completed' || event.type === 'evaluation.completed')
+                status = 'completed';
+            else
+                return;
+            await publish();
+        },
+    };
+}
+//# sourceMappingURL=viewer.js.map

package/dist/training/cli/viewer.js.map

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

package/dist/training/contracts/atomic-feedback.d.ts

@@ -0,0 +1,2 @@
+/** Compatibility seam for the atomic grader's public optimizer feedback type. */
+export type { AtomicFeedback } from '../graders/atomic/index.js';

package/dist/training/contracts/atomic-feedback.js

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

package/dist/training/contracts/atomic-feedback.js.map

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

package/dist/training/contracts/dataset.d.ts

@@ -0,0 +1,174 @@
+import type { InferenceProviderRegistry } from './inference-registry.js';
+import type { TrainingConfiguration } from './training-config.js';
+/** Versioned, runtime-neutral authored and resolved dataset contracts. */
+export type DataValue = null | boolean | number | string | DataValue[] | DataMap;
+export interface DataMap {
+    [key: string]: DataValue;
+}
+export interface FileSelector {
+    resource: string;
+    path: string;
+    sha256: string;
+}
+export interface TaskInput {
+    prompt?: string;
+    data?: DataValue;
+    files?: FileSelector[];
+    message?: DataMap;
+}
+export interface CheckNode {
+    id?: string;
+    eval?: string;
+    all?: CheckNode[];
+    any?: CheckNode[];
+    not?: CheckNode;
+    passed?: string;
+    score?: string;
+    at_least?: number;
+    use?: string;
+    with?: DataMap;
+    [parameter: string]: unknown;
+}
+export interface Stage {
+    id: string;
+    checks: CheckNode[];
+    when?: CheckNode;
+    score?: {
+        linear: Record<string, number>;
+    };
+    gate?: CheckNode;
+}
+export interface LiveCheck extends CheckNode {
+    id: string;
+    on: 'event' | {
+        artifact: string;
+    };
+    on_fail?: 'continue' | 'stop';
+}
+export interface TurnBinding {
+    event: 'tool.dispatch' | 'tool.complete' | 'output';
+    where?: {
+        cel: string;
+    };
+    distinct: 'event.id' | 'call.id';
+    cardinality: 'one';
+    value: string;
+}
+export interface Turn {
+    id: string;
+    input: TaskInput;
+    after?: {
+        turn: string;
+        outcome: 'completed';
+    };
+    bind?: Record<string, TurnBinding>;
+    /** Scoped to this turn; equal IDs in other turns or terminal checks are independent. */
+    checks?: CheckNode[];
+}
+export interface RecordFields {
+    context?: DataMap;
+    setup?: DataMap;
+    input?: TaskInput;
+    reference?: {
+        files?: FileSelector[];
+        labels?: DataValue;
+    };
+    outputs?: Record<string, string>;
+}
+export interface DatasetRecord extends RecordFields {
+    id: string;
+    group?: string;
+    /** Evidence ancestors: no identity may appear in another split. */
+    lineage?: string[];
+    use?: string[];
+    turns?: Turn[];
+    checks?: CheckNode[];
+    stages?: Stage[];
+}
+export interface Dataset {
+    schema: 'spawnfile.training.dataset.v1';
+    id: string;
+    subject?: string;
+    training?: TrainingConfiguration;
+    setup?: DataMap;
+    fixtures?: Record<string, RecordFields>;
+    checks?: CheckNode[];
+    stages?: Stage[];
+    live?: {
+        checks: LiveCheck[];
+    };
+    records: DatasetRecord[];
+}
+export interface DatasetDocument {
+    dataset: Dataset;
+    sourceName: string;
+    sourceDigest: string;
+    locations: Record<string, {
+        line: number;
+        column: number;
+    }>;
+}
+export interface ResolvedRecord extends Omit<DatasetRecord, 'use' | 'checks' | 'stages'> {
+    fixtureProvenance: string[];
+    effectiveStages: Stage[];
+    live: {
+        checks: LiveCheck[];
+    };
+}
+export interface ResolvedDataset {
+    schema: 'spawnfile.training.dataset.v1';
+    id: string;
+    subject?: string;
+    training?: TrainingConfiguration;
+    records: ResolvedRecord[];
+    sharedStages: Stage[];
+    live: {
+        checks: LiveCheck[];
+    };
+    sharedPlanDigest: string;
+    sourceDigest: string;
+    sourceName: string;
+    registryVersions: Record<string, string>;
+    criterionFileDigests: Record<string, string>;
+}
+export interface EvaluatorDefinition {
+    version: string;
+    kind: 'mechanical' | 'semantic' | 'embedding';
+    incremental: boolean;
+    /** Supports temporal-finality proofs; not a claim that a current fail is final. */
+    stopProof: boolean;
+    /** Must reject every unsupported parameter; never execute user-authored code. */
+    validate: (parameters: Readonly<Record<string, unknown>>, path: string) => void;
+}
+export interface RulesetDefinition {
+    version: string;
+    expand: (parameters: Readonly<DataMap>) => CheckNode;
+}
+export interface PreparationDefinition {
+    version: string;
+    /** Both this list and the invocation list must permit a record override. */
+    unlockedPaths: readonly string[];
+    validate: (parameters: Readonly<DataMap>, path: string) => void;
+}
+export interface DatasetRegistry {
+    evaluators?: Readonly<Record<string, EvaluatorDefinition>>;
+    rulesets?: Readonly<Record<string, RulesetDefinition>>;
+    preparations?: Readonly<Record<string, PreparationDefinition>>;
+    judges?: Readonly<Record<string, {
+        version: string;
+    }>>;
+    embeddings?: Readonly<Record<string, {
+        version: string;
+    }>>;
+}
+export interface ResolutionOptions {
+    inferenceProviders?: InferenceProviderRegistry;
+    /** Trusted runtime invocation identity, shared with installed judge versions; never authored YAML. */
+    inferenceExecutionIdentity?: string;
+    registry?: DatasetRegistry;
+    subject?: string;
+    unlockedSetupPaths?: readonly string[];
+    requireGroups?: boolean;
+    /** Supplies protected rubric/schema bytes relative to sourceName; required for sidecars. */
+    readCriterionFile?: (path: string, sourceName: string) => string | Uint8Array;
+}

package/dist/training/contracts/dataset.js

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

package/dist/training/contracts/dataset.js.map

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