spawnfile 0.1.24 → 0.1.27

package/dist/training/inference/response-schema.js

@@ -0,0 +1,54 @@
+import { Ajv } from 'ajv';
+import { parseDocument } from 'yaml';
+import { z } from 'zod';
+import { InferenceFailure } from './failure.js';
+const unsupportedSchema = 'Response schema must be a synchronous JSON Schema draft-07 object with locally resolvable references (at most 64 KiB)';
+/** Check JSON safety and transport size before provider-specific dialect admission. */
+export function validateInferenceSchemaData(schema) {
+    try {
+        if (schema === null || typeof schema !== 'object' || Array.isArray(schema))
+            throw new Error('Expected an object schema');
+        const data = z.json().parse(schema);
+        if (Buffer.byteLength(JSON.stringify(data)) > 65_536)
+            throw new Error('Schema exceeds its transport bound');
+        return data;
+    }
+    catch {
+        throw new InferenceFailure('unsupported', unsupportedSchema);
+    }
+}
+function compile(schema) {
+    const data = validateInferenceSchemaData(schema);
+    try {
+        const validate = new Ajv({ strict: true, strictRequired: false, allErrors: false }).compile(data);
+        if ('$async' in validate)
+            throw new Error('Async schemas are unsupported');
+        return validate;
+    }
+    catch {
+        throw new InferenceFailure('unsupported', unsupportedSchema);
+    }
+}
+/** Reject unsupported controls before calling a model; never fetch external schemas. */
+export function validateInferenceSchema(schema) {
+    if (schema !== undefined)
+        compile(schema);
+}
+/** Default strict JSON; extraction may explicitly permit a single json fence. */
+export function validateInferenceResponse(text, schema, jsonFence = false) {
+    if (schema === undefined)
+        return;
+    const validate = compile(schema);
+    try {
+        if (jsonFence)
+            text = /^```json\r?\n([\s\S]*?)\r?\n```$/u.exec(text.trim())?.[1] ?? text;
+        const value = JSON.parse(text);
+        if (parseDocument(text, { uniqueKeys: true }).errors.length || !validate(value))
+            throw new Error('Invalid structured response');
+        z.json().parse(value);
+    }
+    catch {
+        throw new InferenceFailure('protocol', 'Completed inference response does not match its requested JSON schema');
+    }
+}
+//# sourceMappingURL=response-schema.js.map

package/dist/training/inference/response-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-schema.js","sourceRoot":"","sources":["../../../src/training/inference/response-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAyC,MAAM,KAAK,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGhD,MAAM,iBAAiB,GAAG,uHAAuH,CAAC;AAElJ,uFAAuF;AACvF,MAAM,UAAU,2BAA2B,CAAC,MAA0C;IACpF,IAAI,CAAC;QACH,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;QACzH,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,GAAG,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QAC5G,OAAO,IAAiB,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,gBAAgB,CAAC,aAAa,EAAE,iBAAiB,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC;AAED,SAAS,OAAO,CAAC,MAA0C;IACzD,MAAM,IAAI,GAAG,2BAA2B,CAAC,MAAM,CAAC,CAAC;IACjD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAClG,IAAI,QAAQ,IAAI,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QAC3E,OAAO,QAAQ,CAAC;IAClB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,gBAAgB,CAAC,aAAa,EAAE,iBAAiB,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,uBAAuB,CAAC,MAAsB;IAC5D,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,CAAC,MAAM,CAAC,CAAC;AAC5C,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,yBAAyB,CAAC,IAAY,EAAE,MAAsB,EAAE,SAAS,GAAG,KAAK;IAC/F,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO;IACjC,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC;QACH,IAAI,SAAS;YAAE,IAAI,GAAG,mCAAmC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;QACzF,MAAM,KAAK,GAAY,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,aAAa,CAAC,IAAI,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QAChI,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,gBAAgB,CAAC,UAAU,EAAE,uEAAuE,CAAC,CAAC;IAClH,CAAC;AACH,CAAC"}

package/dist/training/inference/routing.d.ts

@@ -0,0 +1,17 @@
+import type { InferenceAttempt, InferenceProvider } from '../contracts/execution.js';
+export interface InferenceRoute {
+    provider: InferenceProvider;
+    model: string;
+}
+export interface RoutedInferenceOptions {
+    id: string;
+    routes: readonly InferenceRoute[];
+    maxAttempts: number;
+    /** Deadline shared by all attempts and their audit writes. */
+    timeoutMs: number;
+    /** Optional additional cap on each attempt's share of remaining time. */
+    attemptTimeoutMs?: number;
+    /** Trusted durable sink; failure stops the route before another generation. */
+    observeAttempt?: (attempt: Readonly<InferenceAttempt>) => void | Promise<void>;
+}
+export declare function createRoutedInference(options: RoutedInferenceOptions): InferenceProvider;

package/dist/training/inference/routing.js

@@ -0,0 +1,152 @@
+import { randomUUID } from 'node:crypto';
+import { immutableAttempts, InferenceFailure } from './failure.js';
+export function createRoutedInference(options) {
+    if (!options.id.trim() || !options.routes.length || !Number.isSafeInteger(options.maxAttempts) ||
+        options.maxAttempts < 1 || options.maxAttempts > options.routes.length)
+        throw new Error('Invalid inference route budget');
+    for (const ms of [options.timeoutMs, options.attemptTimeoutMs ?? options.timeoutMs]) {
+        if (!Number.isSafeInteger(ms) || ms < 1 || ms > 2_147_483_647)
+            throw new Error('Invalid inference time budget');
+    }
+    const routes = options.routes.map(({ provider, model }) => {
+        if (!provider.id.trim() || !model.trim() || model.startsWith('-') ||
+            !['disabled', 'contained'].includes(provider.capabilities.tools))
+            throw new Error('Explicit tool-isolated routes are required');
+        return Object.freeze({ provider, model });
+    });
+    const { maxAttempts, timeoutMs, attemptTimeoutMs = timeoutMs, observeAttempt } = options;
+    return {
+        id: options.id,
+        capabilities: { tools: routes.some(route => route.provider.capabilities.tools === 'contained') ? 'contained' : 'disabled', billing: routes.every(route => route.provider.capabilities.billing === routes[0].provider.capabilities.billing) ? routes[0].provider.capabilities.billing : 'mixed', temperature: false, seed: false },
+        async generate(request) {
+            if (request.temperature !== undefined || request.seed !== undefined)
+                throw new InferenceFailure('unsupported', 'Routed inference does not support sampling controls');
+            if (!request.prompt.trim())
+                throw new InferenceFailure('unsupported', 'Inference prompt must not be empty');
+            const attempts = [];
+            const deadline = Date.now() + timeoutMs;
+            // A stale shared credential authority fails fast: later routes on it are never attempted.
+            const stale = new Set();
+            let index = 0;
+            for (let ordinal = 0; ordinal < maxAttempts; ordinal++) {
+                if (request.signal?.aborted)
+                    throw new InferenceFailure('cancelled', 'Routed inference cancelled', { attempts });
+                const remaining = deadline - Date.now();
+                if (remaining <= 0)
+                    throw new InferenceFailure('timeout', 'Routed inference time budget exhausted', { attempts });
+                const route = routes[index++];
+                const startedAt = new Date().toISOString();
+                let result;
+                let failure;
+                // Reserve time for each remaining authored route; unused time carries forward.
+                const share = Math.max(1, Math.floor(remaining / (maxAttempts - ordinal)));
+                try {
+                    result = await generateBounded(route, request, Math.min(remaining, share, attemptTimeoutMs));
+                }
+                catch (error) {
+                    failure = error instanceof InferenceFailure ? error : new InferenceFailure('unknown', 'Inference provider failed without a classified refusal');
+                }
+                const attempt = immutableAttempts([{ id: randomUUID(), ordinal: ordinal + 1,
+                        providerId: route.provider.id, requestedModel: route.model,
+                        responseModel: result === undefined ? failure.responseModel : result.modelBasis === 'requested-assumption' ? null : result.model,
+                        responseRoute: result?.route ?? failure?.responseRoute ?? null,
+                        outcome: result === undefined ? 'failed' : 'completed', failureKind: failure?.kind ?? null,
+                        startedAt, completedAt: new Date().toISOString(), usage: result?.usage ?? failure?.usage ?? null, }])[0];
+                attempts.push(attempt);
+                try {
+                    if (observeAttempt || (failure?.diagnostic && request.observeFailure))
+                        await persistBounded(async () => {
+                            await observeAttempt?.(attempt);
+                            if (failure?.diagnostic)
+                                await request.observeFailure?.({ attempt, ...(ordinal ? { fallbackOf: attempts[0].id } : {}), diagnostic: failure.diagnostic });
+                        }, deadline - Date.now(), request.signal);
+                }
+                catch (error) {
+                    const kind = request.signal?.aborted ? 'cancelled' : error instanceof AuditBoundaryFailure ? error.kind : Date.now() >= deadline ? 'timeout' : 'unknown';
+                    throw new InferenceFailure(kind, 'Inference audit persistence failed', { attempts });
+                }
+                if (result !== undefined)
+                    return { ...result, attempts: immutableAttempts(attempts) };
+                if (failure.kind === 'auth-stale')
+                    stale.add(authority(route));
+                while (index < routes.length && stale.has(authority(routes[index])))
+                    index++;
+                if (!['quota', 'transport', 'unavailable', 'timeout', 'invalid-response', 'auth-stale'].includes(failure.kind) ||
+                    ordinal + 1 === maxAttempts || index === routes.length) {
+                    // The routed wrapper is what a judge classifies from, so the last route's
+                    // closed refinement has to survive it; rebuilding from `kind` alone put
+                    // a refused grant, an expired one and a dead broker back in one bucket.
+                    throw new InferenceFailure(failure.kind, `Routed inference stopped (${failure.kind})`, { attempts,
+                        ...(failure.detail === null ? {} : { detail: failure.detail }),
+                        ...(failure.status === null ? {} : { status: failure.status }) });
+                }
+            }
+            throw new Error('Unreachable inference route state');
+        },
+    };
+}
+const authority = (route) => route.provider.capabilities.credentialAuthority ?? `provider:${route.provider.id}`;
+async function generateBounded(route, request, timeoutMs) {
+    const controller = new AbortController();
+    let timedOut = false;
+    let timer;
+    let interrupt;
+    const boundary = new Promise((_resolve, reject) => {
+        interrupt = () => { controller.abort(); reject(new InferenceFailure('cancelled', 'Inference cancelled')); };
+        request.signal?.addEventListener('abort', interrupt, { once: true });
+        timer = setTimeout(() => {
+            timedOut = true;
+            controller.abort();
+            reject(new InferenceFailure('timeout', 'Inference attempt time budget exhausted'));
+        }, timeoutMs);
+    });
+    try {
+        const result = await Promise.race([route.provider.generate({ ...request, model: route.model, signal: controller.signal }), boundary]);
+        if (timedOut)
+            throw new InferenceFailure('timeout', 'Inference attempt time budget exhausted', {
+                usage: result.usage, responseModel: result.modelBasis === 'requested-assumption' ? null : result.model, responseRoute: result.route,
+            });
+        return result;
+    }
+    catch (error) {
+        // Abort-responsive providers may settle with known counters immediately. Keep
+        // that receipt while attributing cancellation to our timer, not the operator.
+        if (timedOut && (!(error instanceof InferenceFailure) || ['cancelled', 'timeout'].includes(error.kind))) {
+            throw new InferenceFailure('timeout', 'Inference attempt time budget exhausted', error instanceof InferenceFailure ? error : {});
+        }
+        throw error;
+    }
+    finally {
+        clearTimeout(timer);
+        request.signal?.removeEventListener('abort', interrupt);
+    }
+}
+class AuditBoundaryFailure extends Error {
+    kind;
+    constructor(kind) {
+        super(`Audit boundary ${kind}`);
+        this.kind = kind;
+    }
+}
+/** An unavailable audit store must not leave an unattended route running forever. */
+async function persistBounded(write, timeoutMs, signal) {
+    if (signal?.aborted)
+        throw new AuditBoundaryFailure('cancelled');
+    if (timeoutMs <= 0)
+        throw new AuditBoundaryFailure('timeout');
+    let timer;
+    let interrupt;
+    const boundary = new Promise((_resolve, reject) => {
+        interrupt = () => reject(new AuditBoundaryFailure('cancelled'));
+        signal?.addEventListener('abort', interrupt, { once: true });
+        timer = setTimeout(() => reject(new AuditBoundaryFailure('timeout')), timeoutMs);
+    });
+    try {
+        await Promise.race([Promise.resolve().then(write), boundary]);
+    }
+    finally {
+        clearTimeout(timer);
+        signal?.removeEventListener('abort', interrupt);
+    }
+}
+//# sourceMappingURL=routing.js.map

package/dist/training/inference/routing.js.map

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

package/dist/training/optimization/boundaries.d.ts

@@ -0,0 +1,8 @@
+/** Exact text constraints, not semantic policy judgments or proposer attestations. */
+export interface TextBoundary {
+    kind: 'preserve' | 'require-text' | 'forbid-text';
+    component: string;
+    text: string;
+}
+export declare function compileBoundaries(declarations: string[], seed: Record<string, string>): TextBoundary[];
+export declare function assertBoundaries(rules: TextBoundary[], components: Record<string, string>): void;

package/dist/training/optimization/boundaries.js

@@ -0,0 +1,31 @@
+export function compileBoundaries(declarations, seed) {
+    const rules = declarations.map(declaration => {
+        const match = /^(preserve|require-text|forbid-text) (\[.*\])$/s.exec(declaration);
+        let args;
+        try {
+            args = match ? JSON.parse(match[2]) : undefined;
+        }
+        catch {
+            args = undefined;
+        }
+        if (!match || match[0] !== declaration || !Array.isArray(args) || args.length !== (match[1] === 'preserve' ? 1 : 2)
+            || args.some(arg => typeof arg !== 'string' || !arg.trim()) || !Object.hasOwn(seed, args[0])) {
+            throw new Error('Unsupported hard boundary: expected preserve [component], require-text [component, text], '
+                + 'or forbid-text [component, text] with JSON string arguments and a known component');
+        }
+        const kind = match[1], component = args[0];
+        return { kind, component, text: kind === 'preserve' ? seed[component] : args[1] };
+    });
+    assertBoundaries(rules, seed);
+    return rules;
+}
+export function assertBoundaries(rules, components) {
+    for (const { kind, component, text } of rules) {
+        const value = Object.hasOwn(components, component) ? components[component] : undefined;
+        if (typeof value !== 'string' || (kind === 'preserve' && value !== text)
+            || (kind === 'require-text' && !value.includes(text)) || (kind === 'forbid-text' && value.includes(text))) {
+            throw new Error(`Candidate violates hard boundary: ${kind} on ${component}`);
+        }
+    }
+}
+//# sourceMappingURL=boundaries.js.map

package/dist/training/optimization/boundaries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boundaries.js","sourceRoot":"","sources":["../../../src/training/optimization/boundaries.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,iBAAiB,CAAC,YAAsB,EAAE,IAA4B;IACpF,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE;QAC3C,MAAM,KAAK,GAAG,iDAAiD,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAClF,IAAI,IAAa,CAAC;QAClB,IAAI,CAAC;YAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,IAAI,GAAG,SAAS,CAAC;QAAC,CAAC;QACrF,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,WAAW,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;eAC5G,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAW,CAAC,EAAE,CAAC;YAC3G,MAAM,IAAI,KAAK,CAAC,4FAA4F;kBACxG,mFAAmF,CAAC,CAAC;QAC3F,CAAC;QACD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAyB,EAAE,SAAS,GAAG,IAAI,CAAC,CAAC,CAAW,CAAC;QAC7E,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAW,EAAE,CAAC;IAC/F,CAAC,CAAC,CAAC;IACH,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC9B,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAqB,EAAE,UAAkC;IACxF,KAAK,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,KAAK,EAAE,CAAC;QAC9C,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACvF,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,IAAI,KAAK,UAAU,IAAI,KAAK,KAAK,IAAI,CAAC;eACjE,CAAC,IAAI,KAAK,cAAc,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,aAAa,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YAC9G,MAAM,IAAI,KAAK,CAAC,qCAAqC,IAAI,OAAO,SAAS,EAAE,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/training/optimization/bridge-fixtures.d.ts

@@ -0,0 +1,13 @@
+export declare function bridgeFixture(): Promise<{
+    root: string;
+    command: string;
+    python: string;
+    metadata: string;
+    site: string;
+    context: {
+        bridge: {
+            command: string;
+            cwd: string;
+        };
+    };
+}>;

package/dist/training/optimization/bridge-fixtures.js

@@ -0,0 +1,40 @@
+import { execFile } from 'node:child_process';
+import { chmod, mkdir, mkdtemp, realpath, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { promisify } from 'node:util';
+const bridgeLauncherBody = `# -*- coding: utf-8 -*-
+import sys
+from spawnfile_training_dspy.main import cli
+if __name__ == "__main__":
+    if sys.argv[0].endswith("-script.pyw"):
+        sys.argv[0] = sys.argv[0][:-11]
+    elif sys.argv[0].endswith(".exe"):
+        sys.argv[0] = sys.argv[0][:-4]
+    sys.exit(cli())
+`;
+// Real isolated editable Python installation, with no DSPy download or cognition.
+export async function bridgeFixture() {
+    const root = await realpath(await mkdtemp(join(tmpdir(), 'bridge-identity-')));
+    const python = join(root, '.venv/bin/python'), command = join(root, '.venv/bin/spawnfile-training-dspy');
+    const execute = promisify(execFile);
+    await execute('python3', ['-m', 'venv', '--without-pip', join(root, '.venv')]);
+    const { stdout } = await execute(python, ['-c', 'import sysconfig; print(sysconfig.get_paths()["purelib"])']);
+    const site = stdout.trim();
+    const metadata = join(site, 'spawnfile_training_dspy_bridge-0.1.0.dist-info');
+    await mkdir(metadata);
+    await writeFile(join(metadata, 'METADATA'), 'Metadata-Version: 2.1\nName: spawnfile-training-dspy-bridge\nVersion: 0.1.0\n');
+    await writeFile(join(metadata, 'direct_url.json'), JSON.stringify({ url: pathToFileURL(root).href, dir_info: { editable: true } }));
+    await writeFile(join(site, 'bridge.pth'), root + '\n');
+    await mkdir(join(root, 'spawnfile_training_dspy'));
+    await writeFile(join(root, 'spawnfile_training_dspy/__init__.py'), '"""Fixture package; no cognition."""\n');
+    await writeFile(join(root, 'spawnfile_training_dspy/main.py'), 'def cli(): pass\n');
+    await writeFile(join(root, 'spawnfile_training_dspy/legacy_wire_aliases.json'), '{}\n');
+    await writeFile(join(root, 'pyproject.toml'), '[project]\nname = "spawnfile-training-dspy-bridge"\nversion = "0.1.0"\n[project.scripts]\nspawnfile-training-dspy = "spawnfile_training_dspy.main:cli"\n');
+    await writeFile(join(root, 'requirements.lock'), 'dspy==3.3.1\ngepa==0.1.4\n');
+    await writeFile(command, `#!${python}\n${bridgeLauncherBody}`);
+    await chmod(command, 0o755);
+    return { root, command, python, metadata, site, context: { bridge: { command, cwd: root } } };
+}
+//# sourceMappingURL=bridge-fixtures.js.map

package/dist/training/optimization/bridge-fixtures.js.map

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

package/dist/training/optimization/bridge-identity.d.ts

@@ -0,0 +1,8 @@
+export interface BridgeIdentityContext {
+    bridge?: Readonly<{
+        command: string;
+        cwd: string;
+    }>;
+}
+/** Bind the actual supported editable bridge, not an unrelated bundled source tree. */
+export declare function bridgeExecutionIdentity(root: string | undefined, context: BridgeIdentityContext): Promise<string>;

package/dist/training/optimization/bridge-identity.js

@@ -0,0 +1,110 @@
+import { createHash } from 'node:crypto';
+import { execFile } from 'node:child_process';
+import { lstat, readFile, readdir, readlink, realpath } from 'node:fs/promises';
+import { join, isAbsolute } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { promisify } from 'node:util';
+// Exact supported installed entry points. Arbitrary wrappers are not declared pinned.
+const bridgeLauncherBody = `# -*- coding: utf-8 -*-
+import sys
+from spawnfile_training_dspy.main import cli
+if __name__ == "__main__":
+    if sys.argv[0].endswith("-script.pyw"):
+        sys.argv[0] = sys.argv[0][:-11]
+    elif sys.argv[0].endswith(".exe"):
+        sys.argv[0] = sys.argv[0][:-4]
+    sys.exit(cli())
+`;
+const pipBridgeLauncherBody = `import sys
+from spawnfile_training_dspy.main import cli
+if __name__ == '__main__':
+    sys.argv[0] = sys.argv[0].removesuffix('.exe')
+    sys.exit(cli())
+`;
+const probe = `import importlib.util, importlib.metadata, json, pathlib, sys, tomllib
+root = pathlib.Path(sys.argv[1]).resolve()
+spec = importlib.util.find_spec('spawnfile_training_dspy')
+dist = importlib.metadata.distribution('spawnfile-training-dspy-bridge')
+project = tomllib.loads((root / 'pyproject.toml').read_text())['project']
+print(json.dumps({'origin': spec.origin, 'search': list(spec.submodule_search_locations),
+ 'prefix': str(pathlib.Path(sys.prefix).resolve()), 'python': sys.version,
+ 'interpreter': str(pathlib.Path(sys.executable).resolve()),
+ 'version': dist.version, 'direct': json.loads(dist.read_text('direct_url.json')),
+ 'project': {'name': project['name'], 'version': project['version'], 'scripts': project['scripts']}}))`;
+/** Bind the actual supported editable bridge, not an unrelated bundled source tree. */
+export async function bridgeExecutionIdentity(root, context) {
+    if (!root || !isAbsolute(root) || !context.bridge || await realpath(root) !== root)
+        throw new Error('Explicit canonical bridge root and actual bridge launch are required');
+    const command = join(root, '.venv/bin/spawnfile-training-dspy');
+    if (context.bridge.command !== command || await realpath(command) !== command)
+        throw new Error('Unsupported or mismatched training bridge command');
+    if (process.env.PYTHONPATH || process.env.PYTHONHOME)
+        throw new Error('Python import overrides are unsupported for a pinned bridge');
+    const digest = createHash('sha256').update('spawnfile.training.python-bridge.v1\n');
+    let files = 0, bytes = 0;
+    const bind = async (path, label) => {
+        const stat = await lstat(path);
+        if (!stat.isFile() || stat.isSymbolicLink() || stat.size > 2 * 1024 * 1024 || ++files > 256)
+            throw new Error('Bridge source is not a bounded regular file');
+        const content = await readFile(path);
+        bytes += content.length;
+        if (bytes > 8 * 1024 * 1024)
+            throw new Error('Bridge source closure exceeds its byte bound');
+        digest.update(label).update('\0').update(content).update('\0');
+        return content;
+    };
+    const launcher = await bind(command, 'launcher');
+    const supported = [
+        { python: join(root, '.venv/bin/python'), body: bridgeLauncherBody },
+        { python: join(root, '.venv/bin/python3'), body: pipBridgeLauncherBody },
+    ].find(row => launcher.toString('utf8') === `#!${row.python}\n${row.body}`);
+    if (!supported)
+        throw new Error('Unsupported bridge launcher or interpreter binding');
+    const { python } = supported;
+    for (const file of ['pyproject.toml', 'requirements.lock'])
+        await bind(join(root, file), file);
+    let wireAliasesBound = false;
+    const visit = async (directory, relative = '', depth = 0) => {
+        if (depth > 8)
+            throw new Error('Bridge source depth exceeds its bound');
+        const stat = await lstat(directory);
+        if (!stat.isDirectory() || stat.isSymbolicLink())
+            throw new Error('Bridge package must be a real directory');
+        for (const entry of (await readdir(directory, { withFileTypes: true })).sort((a, b) => a.name.localeCompare(b.name))) {
+            if (entry.name.startsWith('.') || entry.name === '__pycache__' || entry.name.endsWith('_test.py') || entry.name.endsWith('.md'))
+                continue;
+            const path = join(directory, entry.name), label = `${relative}/${entry.name}`;
+            if (relative === '' && entry.name === 'legacy_wire_aliases.json') {
+                if (entry.isSymbolicLink() && await readlink(path) !== '../../../shared/trainingLegacy/trainingLegacyWireAliases.json')
+                    throw new Error('Unsupported bridge wire alias resource');
+                await bind(await realpath(path), `package${label}`);
+                wireAliasesBound = true;
+                continue;
+            }
+            if (entry.isSymbolicLink())
+                throw new Error('Bridge source package symlinks are unsupported');
+            if (entry.isDirectory())
+                await visit(path, label, depth + 1);
+            else if (entry.name.endsWith('.py'))
+                await bind(path, `package${label}`);
+        }
+    };
+    await visit(join(root, 'spawnfile_training_dspy'));
+    if (!wireAliasesBound)
+        throw new Error('Bridge wire alias resource is missing');
+    // Inspection imports no bridge module or cognition, and does not read auth.
+    // The supported console launcher has this directory as its import search root.
+    const { stdout } = await promisify(execFile)(python, ['-c', probe, root], {
+        cwd: join(root, '.venv/bin'), timeout: 10000, maxBuffer: 16384,
+    });
+    const actual = JSON.parse(stdout);
+    if (actual.origin !== join(root, 'spawnfile_training_dspy/__init__.py') || JSON.stringify(actual.search) !== JSON.stringify([join(root, 'spawnfile_training_dspy')]) ||
+        actual.prefix !== await realpath(join(root, '.venv')) || actual.interpreter !== await realpath(python) ||
+        actual.direct.url !== pathToFileURL(root).href || actual.direct.dir_info?.editable !== true ||
+        actual.project.name !== 'spawnfile-training-dspy-bridge' || actual.version !== actual.project.version || actual.project.scripts['spawnfile-training-dspy'] !== 'spawnfile_training_dspy.main:cli') {
+        throw new Error('Installed bridge package, metadata or interpreter differs from its declared source');
+    }
+    digest.update(JSON.stringify(actual));
+    return `spawnfile.training.python-bridge.v1:sha256:${digest.digest('hex')}`;
+}
+//# sourceMappingURL=bridge-identity.js.map

package/dist/training/optimization/bridge-identity.js.map

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

package/dist/training/optimization/checkpoint.d.ts

@@ -0,0 +1,35 @@
+import type { InferenceResult } from '../contracts/execution.js';
+import { type DspyRequest, type DspyStart } from './protocol.js';
+import type { DspyOptimizationOptions, DspyRestoredEvidence } from './types.js';
+export interface CallbackEntry {
+    request: DspyRequest;
+    attempts: number;
+    result?: unknown;
+    inference?: InferenceResult;
+    failedAttempts?: InferenceResult['attempts'];
+    settledFailures?: number;
+}
+/** Protected host journal. Completed callbacks replay; incomplete callbacks consume a new attempt. */
+export declare class OptimizationCheckpoint {
+    private readonly path;
+    private readonly identity;
+    private readonly lineage?;
+    private readonly mutations;
+    private history;
+    get entries(): readonly CallbackEntry[];
+    private constructor();
+    static open(start: DspyStart, options: NonNullable<DspyOptimizationOptions['checkpoint']>): Promise<OptimizationCheckpoint>;
+    begin(request: DspyRequest, budget: DspyStart['budget']): Promise<CallbackEntry>;
+    private beginMutation;
+    complete(entry: CallbackEntry, result: unknown, inference?: InferenceResult): Promise<void>;
+    private completeMutation;
+    failed(entry: CallbackEntry, attempts: NonNullable<InferenceResult['attempts']>): Promise<void>;
+    private failedMutation;
+    private validateResult;
+    private save;
+}
+export declare function restoredDspyEvidence(checkpoint: OptimizationCheckpoint): DspyRestoredEvidence;
+/** Accounting-only restore; validates identity and never starts Python or inference. */
+export declare function readDspyCheckpointEvidence(options: Pick<DspyOptimizationOptions, 'id' | 'components' | 'trainCaseIds' | 'validationCaseIds' | 'budget' | 'seed' | 'proposal' | 'concurrency' | 'search' | 'editScope'> & {
+    checkpoint: NonNullable<DspyOptimizationOptions['checkpoint']>;
+}): Promise<DspyRestoredEvidence>;