spawnfile 0.1.25 → 0.1.28

package/dist/training/inference/decision/ollama.js.map

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

package/dist/training/inference/decision/prompt.d.ts

@@ -0,0 +1,6 @@
+import type { DecisionRequest } from '../../contracts/grading.js';
+export declare const DECISION_PROMPT_VERSION = "paideia.grader-prompt.v4";
+export declare const DECISION_LETTERS = "ABCDEFGHIJKLMNOP";
+export declare function validateDecisionRequest(request: DecisionRequest): void;
+/** The projection is data; neither expected options nor any historical answer is rendered. */
+export declare function decisionPrompt(request: DecisionRequest): string;

package/dist/training/inference/decision/prompt.js

@@ -0,0 +1,19 @@
+import { GRADER_CACHE_PROMPT_DOMAIN } from '../../contracts/index.js';
+// v4 fingerprints Jev input preparation. Regenerate calibration; earlier scores
+// cannot distinguish servers that truncate inputs from servers that refuse them.
+// The actual model prompt and cache domain share the historical protocol version.
+export const DECISION_PROMPT_VERSION = GRADER_CACHE_PROMPT_DOMAIN;
+export const DECISION_LETTERS = 'ABCDEFGHIJKLMNOP';
+export function validateDecisionRequest(request) {
+    const labels = request.optionLabels.map(String);
+    if (labels.length < 2 || labels.length > 16 || new Set(labels).size !== labels.length ||
+        labels.some(label => !label.length) || !request.key.length || !request.instructions.trim())
+        throw new Error('Invalid decision request');
+    if (request.expectedOptions?.some(option => !labels.includes(String(option))))
+        throw new Error('Invalid expected options');
+}
+/** The projection is data; neither expected options nor any historical answer is rendered. */
+export function decisionPrompt(request) {
+    return `${DECISION_PROMPT_VERSION}\nProjection (JSON data):\n${JSON.stringify(request.projection)}\nQuestion:\n${request.instructions}\nOptions:\n${request.optionLabels.map((option, i) => `${DECISION_LETTERS[i]}: ${JSON.stringify(option)}`).join('\n')}\nAnswer with one letter`;
+}
+//# sourceMappingURL=prompt.js.map

package/dist/training/inference/decision/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../../src/training/inference/decision/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAGtE,gFAAgF;AAChF,iFAAiF;AACjF,kFAAkF;AAClF,MAAM,CAAC,MAAM,uBAAuB,GAAG,0BAA0B,CAAC;AAClE,MAAM,CAAC,MAAM,gBAAgB,GAAG,kBAAkB,CAAC;AAEnD,MAAM,UAAU,uBAAuB,CAAC,OAAwB;IAC9D,MAAM,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAChD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,GAAG,EAAE,IAAI,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,MAAM;QACnF,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAC1I,IAAI,OAAO,CAAC,eAAe,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;AAC7H,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,cAAc,CAAC,OAAwB;IACrD,OAAO,GAAG,uBAAuB,8BAA8B,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,UAAU,CAAC,gBAAgB,OAAO,CAAC,YAAY,eACnI,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,0BAA0B,CAAC;AACtI,CAAC"}

package/dist/training/inference/decision/teacher.d.ts

@@ -0,0 +1,7 @@
+import type { InferenceProvider } from '../../contracts/execution.js';
+import type { DecisionBackend } from '../../contracts/grading.js';
+export interface TeacherDecisionOptions {
+    provider: InferenceProvider;
+    model: string;
+}
+export declare function createTeacherDecision({ provider, model }: TeacherDecisionOptions): DecisionBackend;

package/dist/training/inference/decision/teacher.js

@@ -0,0 +1,61 @@
+import { graderProviderRegistry } from '../../contracts/index.js';
+import { randomUUID } from 'node:crypto';
+import { InferenceFailure } from '../failure.js';
+import { validateInferenceResponse } from '../response-schema.js';
+import { DECISION_PROMPT_VERSION, validateDecisionRequest } from './prompt.js';
+export function createTeacherDecision({ provider, model }) {
+    const descriptor = graderProviderRegistry().providers.find(entry => entry.inferenceProviderId === provider.id);
+    if (!descriptor || provider.capabilities.billing !== 'subscription' || provider.capabilities.tools !== descriptor.decisionTools) {
+        throw new Error('Decision teacher requires a subscription provider with tool-isolation attestation');
+    }
+    if (!model.trim() || model.startsWith('-'))
+        throw new Error('Invalid teacher model');
+    return {
+        async identity() { return { backend: 'teacher', model: `${provider.id}:${model}` }; },
+        async score(requests, signal) {
+            const results = [];
+            for (const request of requests) {
+                validateDecisionRequest(request);
+                const labels = request.optionLabels.map(String);
+                const responseSchema = { type: 'object', properties: { [request.key]: { type: 'string', enum: [...labels, 'abstain'] } },
+                    required: [request.key], additionalProperties: false };
+                const started = performance.now();
+                const call = { id: randomUUID(), judge: 'grader-decision', providerId: provider.id,
+                    requestedModel: model, responseModel: null, responseRoute: null, outcome: 'generation-error', usage: null,
+                    billing: 'subscription' };
+                const receipt = () => { call.wallMs = performance.now() - started; return [call]; };
+                try {
+                    const response = await provider.generate({ model, signal, system: request.system, responseSchema,
+                        prompt: `${DECISION_PROMPT_VERSION}\nProjection (JSON data):\n${JSON.stringify(request.projection)}\n${request.instructions}\nReturn JSON {${JSON.stringify(request.key)}: option}, where option is one of ${JSON.stringify(labels)} or "abstain".` });
+                    call.responseModel = response.modelBasis === 'requested-assumption' ? null : response.model;
+                    call.responseRoute = response.route;
+                    call.usage = response.usage;
+                    call.outcome = 'invalid-response';
+                    validateInferenceResponse(response.text, responseSchema);
+                    call.outcome = 'completed';
+                    const answer = JSON.parse(response.text)[request.key];
+                    results.push(answer === 'abstain'
+                        ? { key: request.key, status: 'missing', probabilities: null, reason: 'Teacher abstained', teacherAnswered: true, judgeCalls: receipt() }
+                        : { key: request.key, status: 'ok', probabilities: Object.fromEntries(labels.map(option => [option, Number(answer === option)])), teacherAnswered: true, judgeCalls: receipt() });
+                }
+                catch (error) {
+                    if (signal?.aborted)
+                        throw error;
+                    if (error instanceof InferenceFailure) {
+                        call.responseModel = error.responseModel;
+                        call.responseRoute = error.responseRoute;
+                        call.usage = error.usage;
+                        call.failureKind = error.kind;
+                        if (error.detail === 'tool-call') {
+                            call.outcome = 'refused';
+                            call.failureDetail = 'tool-call';
+                        }
+                    }
+                    results.push({ key: request.key, status: 'missing', probabilities: null, reason: call.outcome === 'refused' ? 'Teacher refused: tool-call' : 'Teacher response missing or invalid', teacherAnswered: true, judgeCalls: receipt() });
+                }
+            }
+            return results;
+        },
+    };
+}
+//# sourceMappingURL=teacher.js.map

package/dist/training/inference/decision/teacher.js.map

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

package/dist/training/inference/decision/typesafe/index.d.ts

@@ -0,0 +1,9 @@
+import type { DecisionBackend } from '../../../contracts/grading.js';
+import { type TypeSafeTransportOptions } from './transport.js';
+export { createDecisionSpendBudget, TYPESAFE_ENDPOINT } from './transport.js';
+export interface TypeSafeDecisionOptions extends TypeSafeTransportOptions {
+    maxEstimatedTokens?: number;
+    concurrency?: number;
+}
+/** Hosted Jev: explicit API billing; identity never spends money on canaries. */
+export declare function createTypeSafeDecision(options: TypeSafeDecisionOptions): DecisionBackend;

package/dist/training/inference/decision/typesafe/index.js

@@ -0,0 +1,82 @@
+import { typeSafeTransport } from './transport.js';
+import { decode, estimatedTokens, missing, payload, question } from './wire.js';
+export { createDecisionSpendBudget, TYPESAFE_ENDPOINT } from './transport.js';
+/** Hosted Jev: explicit API billing; identity never spends money on canaries. */
+export function createTypeSafeDecision(options) {
+    const transport = typeSafeTransport(options);
+    const limit = options.maxEstimatedTokens ?? 48_000;
+    const concurrency = options.concurrency ?? 8;
+    if (!Number.isSafeInteger(limit) || limit < 1 || limit > 64_000)
+        throw new Error('Invalid TypeSafe token estimate limit');
+    if (!Number.isSafeInteger(concurrency) || concurrency < 1 || concurrency > 32)
+        throw new Error('Invalid TypeSafe concurrency');
+    return {
+        capabilities: { billing: 'api', batch: true },
+        identity: async (signal) => transport.identity(signal),
+        requestReceipts: transport.receipts,
+        async score(requests, signal, receipts) {
+            transport.identity(signal);
+            const stop = new AbortController();
+            const groups = new Map();
+            const results = new Map();
+            for (const request of requests) {
+                question(request);
+                if (results.has(request.key))
+                    throw new Error('Duplicate TypeSafe question key');
+                results.set(request.key, missing(request, 'TypeSafe token estimate limit', 'request-rejected'));
+                // Independently enforce state + longest question <= 32k; never truncate.
+                if (estimatedTokens(options.model, [request]) > Math.min(limit, 32_000))
+                    continue;
+                const state = JSON.stringify(request.projection);
+                const group = groups.get(state) ?? [];
+                group.push(request);
+                groups.set(state, group);
+            }
+            const send = async (batch) => {
+                const response = await transport.send(payload(options.model, batch), estimatedTokens(options.model, batch), signal, receipts);
+                const answers = response.data?.answers;
+                for (const request of batch)
+                    results.set(request.key, response.reason
+                        ? missing(request, response.reason, response.failureCause) : decode(request, answers?.[request.key]));
+            };
+            const sendGroup = async (group) => {
+                let batch = [];
+                for (const request of group) {
+                    if (batch.length && (batch.length === 64 || estimatedTokens(options.model, [...batch, request]) > limit)) {
+                        await send(batch);
+                        batch = [];
+                        if (stop.signal.aborted)
+                            return;
+                    }
+                    batch.push(request);
+                }
+                await send(batch);
+            };
+            // Workers share a synchronous iterator; a terminal failure stops admission.
+            // Drain started work before rejecting so callers can collect final receipts.
+            const pending = groups.values();
+            let failure;
+            const worker = async () => {
+                while (!stop.signal.aborted) {
+                    const next = pending.next();
+                    if (next.done)
+                        return;
+                    try {
+                        await sendGroup(next.value);
+                    }
+                    catch (error) {
+                        if (!stop.signal.aborted) {
+                            failure = error;
+                            stop.abort();
+                        }
+                    }
+                }
+            };
+            await Promise.all(Array.from({ length: Math.min(concurrency, groups.size) }, worker));
+            if (stop.signal.aborted)
+                throw failure;
+            return requests.map(request => results.get(request.key));
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/training/inference/decision/typesafe/index.js.map

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

package/dist/training/inference/decision/typesafe/transport.d.ts

@@ -0,0 +1,44 @@
+import type { InferenceProviderRegistry } from '../../../contracts/inference-registry.js';
+import type { DecisionRequestReceipt, DecisionSpendBudget, DecisionResult } from '../../../contracts/grading.js';
+export interface TypeSafeTransportOptions {
+    inferenceProviders?: InferenceProviderRegistry;
+    model: string;
+    /** Admission ledger charges at least the estimate per attempt when usage is unknown. */
+    conservativeSpend?: boolean;
+    endpoint?: string;
+    pricePerMtokUsd?: number;
+    maxSpendUsd?: number;
+    budget?: DecisionSpendBudget;
+    timeoutMs?: number;
+    maxAttempts?: number;
+    retryBaseMs?: number;
+    fetch?: typeof fetch;
+    env?: Readonly<Record<string, string | undefined>>;
+}
+export declare const TYPESAFE_ENDPOINT = "https://api.typesafe.ai/v1/systemone";
+export declare function createDecisionSpendBudget(maxUsd?: number): DecisionSpendBudget;
+export declare function typeSafeTransport(options: TypeSafeTransportOptions): {
+    receipts: () => {
+        requestId?: string;
+        billing: "api";
+        model: string;
+        endpoint: string;
+        inputTokens: number | null;
+        outputTokens: number | null;
+        usd: number | null;
+        estimatedInputTokens: number;
+        estimatedUsd: number;
+        latencyMs: number;
+        status: number | null;
+    }[];
+    identity(signal?: AbortSignal): {
+        backend: string;
+        model: string;
+        endpoint: string;
+    };
+    send(body: unknown, tokens: number, signal?: AbortSignal, collector?: DecisionRequestReceipt[]): Promise<{
+        data?: unknown;
+        reason?: string;
+        failureCause?: DecisionResult["failureCause"];
+    }>;
+};

package/dist/training/inference/decision/typesafe/transport.js

@@ -0,0 +1,151 @@
+import { trainingEnvironment } from '../../../platform/index.js';
+import { assertModelRequestAdmission } from '../../request-cap.js';
+import { reserveEvaluatorRequest, typeSafeEvaluatorEnvironment } from '../../evaluator/index.js';
+import { setTimeout as delay } from 'node:timers/promises';
+import { randomUUID } from 'node:crypto';
+export const TYPESAFE_ENDPOINT = 'https://api.typesafe.ai/v1/systemone';
+export function createDecisionSpendBudget(maxUsd) {
+    if (maxUsd !== undefined && (!Number.isFinite(maxUsd) || maxUsd < 0))
+        throw new Error('Invalid maximum spend USD');
+    return { maxUsd, spentUsd: 0, reservedUsd: 0 };
+}
+export function typeSafeTransport(options) {
+    assertModelRequestAdmission('typesafe', 'decisions', { purpose: 'decisions', model: options.model }, options.inferenceProviders);
+    const key = (typeSafeEvaluatorEnvironment() ?? options.env ?? process.env).TYPESAFE_API_KEY;
+    if (!key?.trim())
+        throw new Error('TypeSafe requires TYPESAFE_API_KEY');
+    let endpoint;
+    try {
+        endpoint = new URL(options.endpoint ?? TYPESAFE_ENDPOINT);
+    }
+    catch {
+        throw new Error('Invalid TypeSafe endpoint');
+    }
+    const evaluatorCapped = trainingEnvironment('SPAWNFILE_TRAINING_MODEL_REQUEST_CAP') === 'broker' || trainingEnvironment('SPAWNFILE_TRAINING_EVALUATOR_ROUTES_FILE') !== undefined;
+    if (evaluatorCapped && endpoint.href !== TYPESAFE_ENDPOINT) {
+        throw new Error('Capped TypeSafe evaluator requires the declared hosted endpoint');
+    }
+    if (endpoint.protocol !== 'https:' || endpoint.username || endpoint.password ||
+        endpoint.search || endpoint.hash || endpoint.href.includes(key))
+        throw new Error('Invalid TypeSafe endpoint');
+    if (!/^jev-\d+\.\d+\.\d+$/.test(options.model) || options.model.includes(key))
+        throw new Error('TypeSafe requires a pinned versioned model');
+    // Configurable estimate, never a claim about the current provider price or invoice.
+    const price = options.pricePerMtokUsd ?? 0.042;
+    const attempts = options.maxAttempts ?? 3, timeout = options.timeoutMs ?? 180_000, base = options.retryBaseMs ?? 250;
+    if (!Number.isFinite(price) || price <= 0 || !Number.isSafeInteger(attempts) || attempts < 1 || attempts > 10 ||
+        !Number.isSafeInteger(timeout) || timeout < 1 || timeout > 2_147_483_647 || !Number.isSafeInteger(base) || base < 0 || base > 60_000) {
+        throw new Error('Invalid TypeSafe transport options');
+    }
+    const budget = options.budget ?? createDecisionSpendBudget(options.maxSpendUsd);
+    const receipts = [];
+    let drifted = false;
+    const check = (signal) => {
+        if (signal?.aborted)
+            throw new Error('TypeSafe request cancelled or timed out');
+        if (drifted)
+            throw new Error('TypeSafe response model differs from pinned model');
+    };
+    return {
+        receipts: () => receipts.map(receipt => ({ ...receipt })),
+        identity(signal) {
+            check(signal);
+            return { backend: 'typesafe', model: options.model, endpoint: endpoint.href };
+        },
+        async send(body, tokens, signal, collector) {
+            check(signal);
+            const estimate = tokens * price / 1e6;
+            if (budget.maxUsd === 0 || (budget.maxUsd !== undefined && budget.spentUsd + budget.reservedUsd + estimate > budget.maxUsd))
+                return { reason: 'spend cap', failureCause: 'spend-cap' };
+            budget.reservedUsd += estimate;
+            try {
+                for (let attempt = 0; attempt < attempts; attempt++) {
+                    check(signal);
+                    if (options.conservativeSpend && budget.maxUsd !== undefined && budget.spentUsd + budget.reservedUsd > budget.maxUsd)
+                        return { reason: 'spend cap', failureCause: 'spend-cap' };
+                    const admission = evaluatorCapped
+                        ? reserveEvaluatorRequest('typesafe', 'decisions', options.model, estimate, options.inferenceProviders) : undefined;
+                    const receipt = { requestId: admission?.id ?? randomUUID(), billing: 'api', model: options.model, endpoint: endpoint.href,
+                        inputTokens: null, outputTokens: null, usd: null, estimatedInputTokens: tokens, estimatedUsd: estimate,
+                        latencyMs: 0, status: null };
+                    const start = performance.now();
+                    const deadline = new AbortController();
+                    const timer = setTimeout(() => deadline.abort(), timeout);
+                    const attemptSignal = signal ? AbortSignal.any([signal, deadline.signal]) : deadline.signal;
+                    let response;
+                    try {
+                        // No request capture: Authorization exists only at this transport boundary.
+                        response = await (options.fetch ?? fetch)(endpoint.href, { method: 'POST', redirect: 'error', signal: attemptSignal,
+                            headers: { 'content-type': 'application/json', Authorization: `Bearer ${key}` }, body: JSON.stringify(body) });
+                        attemptSignal.throwIfAborted();
+                        receipt.status = response.status;
+                        if (response.status === 401)
+                            throw new Error('TypeSafe authentication failed (401)');
+                        if (response.status === 402)
+                            throw new Error('TypeSafe payment failed (402)');
+                        // 408/499 are proxy-side drops of an otherwise valid request: transient, like 429 and 5xx.
+                        const retry = response.status === 408 || response.status === 429 || response.status === 499 || response.status >= 500;
+                        if (!retry && !response.ok)
+                            return { reason: `TypeSafe HTTP ${response.status}: request rejected`, failureCause: 'request-rejected' };
+                        if (!retry) {
+                            const raw = await response.json();
+                            attemptSignal.throwIfAborted();
+                            const data = raw;
+                            const input = data?.usage?.input_tokens, output = data?.usage?.output_tokens;
+                            if (typeof input === 'number' && Number.isSafeInteger(input) && input >= 0) {
+                                receipt.inputTokens = input;
+                                receipt.usd = input * price / 1e6;
+                                if (!options.conservativeSpend)
+                                    budget.spentUsd += receipt.usd;
+                            }
+                            if (typeof output === 'number' && Number.isSafeInteger(output) && output >= 0)
+                                receipt.outputTokens = output;
+                            if (data?.model !== options.model) {
+                                drifted = true;
+                                check();
+                            }
+                            return { data: raw };
+                        }
+                    }
+                    catch {
+                        // Never propagate fetch/JSON/abort errors: they may embed Authorization or echoed credentials.
+                        check(signal);
+                        if (receipt.status === 401)
+                            throw new Error('TypeSafe authentication failed (401)');
+                        if (receipt.status === 402)
+                            throw new Error('TypeSafe payment failed (402)');
+                        // Network errors and this attempt's timeout share the bounded 5xx retry policy.
+                        // Caller cancellation, authentication, payment and model drift remain terminal.
+                    }
+                    finally {
+                        // Release unread error bodies before returning or admitting another attempt.
+                        // Aborting also closes a fetch body whose reader failed or was interrupted.
+                        deadline.abort();
+                        if (response?.body && !response.bodyUsed)
+                            await response.body.cancel().catch(() => { });
+                        clearTimeout(timer);
+                        if (options.conservativeSpend)
+                            budget.spentUsd += Math.max(estimate, receipt.usd ?? 0);
+                        receipt.latencyMs = performance.now() - start;
+                        receipts.push(receipt);
+                        collector?.push({ ...receipt });
+                        admission?.finish(receipt.status !== null && receipt.status >= 200 && receipt.status < 300 ? 'completed' : 'failed', receipt);
+                    }
+                    if (attempt + 1 === attempts)
+                        throw new Error('TypeSafe infrastructure failure: retry attempts exhausted');
+                    try {
+                        await delay(base * 2 ** attempt * (1 + Math.random()), undefined, { signal });
+                    }
+                    catch {
+                        throw new Error('TypeSafe request cancelled or timed out');
+                    }
+                }
+                throw new Error('TypeSafe infrastructure failure');
+            }
+            finally {
+                budget.reservedUsd -= estimate;
+            }
+        },
+    };
+}
+//# sourceMappingURL=transport.js.map

package/dist/training/inference/decision/typesafe/transport.js.map

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

package/dist/training/inference/decision/typesafe/wire.d.ts

@@ -0,0 +1,25 @@
+import type { DecisionRequest, DecisionResult } from '../../../contracts/grading.js';
+export declare function missing(request: DecisionRequest, reason: string, failureCause?: DecisionResult['failureCause']): DecisionResult;
+export declare function question(request: DecisionRequest): {
+    type: "score" | "yes-no" | "choice" | "noul";
+    instructions: string;
+    criteria: string[] | {
+        [k: string]: string;
+    };
+};
+export declare function payload(model: string, requests: DecisionRequest[]): {
+    model: string;
+    state: string;
+    questions: {
+        [k: string]: {
+            type: "score" | "yes-no" | "choice" | "noul";
+            instructions: string;
+            criteria: string[] | {
+                [k: string]: string;
+            };
+        };
+    };
+};
+/** Includes JSON framing, repeated state and full question instructions. */
+export declare function estimatedTokens(model: string, requests: DecisionRequest[]): number;
+export declare function decode(request: DecisionRequest, raw: unknown): DecisionResult;

package/dist/training/inference/decision/typesafe/wire.js

@@ -0,0 +1,49 @@
+export function missing(request, reason, failureCause) {
+    return { key: request.key, status: 'missing', probabilities: null, reason, ...(failureCause ? { failureCause } : {}) };
+}
+export function question(request) {
+    const labels = request.optionLabels.map(String);
+    const noul = request.type === 'yes-no' || request.type === 'noul';
+    const max = request.type === 'score' ? 10 : noul ? 2 : 255;
+    if (!request.key || !request.instructions.trim() || labels.length < 2 || labels.length > max ||
+        new Set(labels).size !== labels.length || labels.some(label => !label) ||
+        request.type === 'yes-no' && (!labels.includes('yes') || !labels.includes('no')) ||
+        request.type === 'noul' && (!labels.includes('true') || !labels.includes('false'))) {
+        throw new Error('Invalid TypeSafe question or option count');
+    }
+    return { type: noul ? 'noul' : request.type,
+        instructions: [request.system, request.instructions].filter(Boolean).join('\n'),
+        criteria: request.type === 'score' ? labels.map(label => `Score ${label}`)
+            : noul ? { true: 'Yes', false: 'No' }
+                : Object.fromEntries(labels.map(label => [label, label])) };
+}
+export function payload(model, requests) {
+    return { model, state: JSON.stringify(requests[0].projection),
+        questions: Object.fromEntries(requests.map(request => [request.key, question(request)])) };
+}
+/** Includes JSON framing, repeated state and full question instructions. */
+export function estimatedTokens(model, requests) {
+    return Math.ceil(JSON.stringify(payload(model, requests)).length / 3);
+}
+export function decode(request, raw) {
+    const noul = request.type === 'yes-no' || request.type === 'noul';
+    const answer = raw;
+    const fail = () => missing(request, 'TypeSafe requires probabilities over every option with total in [0.97, 1.03]');
+    if (answer?.type !== (noul ? 'noul' : request.type))
+        return fail();
+    const values = noul
+        ? [answer.noul, typeof answer.noul === 'number' ? 1 - answer.noul : undefined]
+        : request.optionLabels.map((label, i) => answer.probabilities?.[request.type === 'score' ? String(i) : String(label)]);
+    if (values.some(value => typeof value !== 'number' || !Number.isFinite(value) || value < 0 || value > 1))
+        return fail();
+    const total = values.reduce((sum, value) => sum + value, 0);
+    const tolerance = Number.EPSILON * values.length;
+    if (total < 0.97 - tolerance || total > 1.03 + tolerance)
+        return fail();
+    const normalized = values.map(value => value / total);
+    const probabilities = noul ? request.type === 'yes-no'
+        ? { yes: normalized[0], no: normalized[1] } : { true: normalized[0], false: normalized[1] }
+        : Object.fromEntries(request.optionLabels.map((label, i) => [String(label), normalized[i]]));
+    return { key: request.key, status: 'ok', probabilities, providerRounded: true };
+}
+//# sourceMappingURL=wire.js.map

package/dist/training/inference/decision/typesafe/wire.js.map

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

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

@@ -0,0 +1,3 @@
+import { type InferenceDiagnostic } from '../contracts/execution.js';
+/** Call only after a provider has verified its whole completion and isolation envelope. */
+export declare function captureInferenceDiagnostic(code: InferenceDiagnostic['code'], text?: string): InferenceDiagnostic;

package/dist/training/inference/diagnostic.js

@@ -0,0 +1,14 @@
+import { createHash } from 'node:crypto';
+import { inferenceDiagnosticCodes } from '../contracts/execution.js';
+/** Call only after a provider has verified its whole completion and isolation envelope. */
+export function captureInferenceDiagnostic(code, text) {
+    if (!inferenceDiagnosticCodes.includes(code) || (text !== undefined && (code !== 'response-schema' || typeof text !== 'string'))) {
+        throw new Error('Invalid protected inference diagnostic');
+    }
+    if (text === undefined)
+        return Object.freeze({ code });
+    const bytes = Buffer.byteLength(text), omitted = bytes > 65_536;
+    return Object.freeze({ code, response: Object.freeze({ bytes, sha256: `sha256:${createHash('sha256').update(text).digest('hex')}`,
+            omitted, ...(omitted ? {} : { text }) }) });
+}
+//# sourceMappingURL=diagnostic.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostic.js","sourceRoot":"","sources":["../../../src/training/inference/diagnostic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,wBAAwB,EAA4B,MAAM,2BAA2B,CAAC;AAE/F,2FAA2F;AAC3F,MAAM,UAAU,0BAA0B,CAAC,IAAiC,EAAE,IAAa;IACzF,IAAI,CAAC,wBAAwB,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,IAAI,KAAK,iBAAiB,IAAI,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,EAAE,CAAC;QACjI,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC5D,CAAC;IACD,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IACvD,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;IAChE,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;YAC/H,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;AAChD,CAAC"}

package/dist/training/inference/evaluator/index.d.ts

@@ -0,0 +1,3 @@
+export { evaluatorRoute, type EvaluatorPurpose } from './policy.js';
+export { reserveEvaluatorRequest } from './ledger.js';
+export { budgetEvaluatorInference, typeSafeEvaluatorEnvironment } from './provider.js';

package/dist/training/inference/evaluator/index.js

@@ -0,0 +1,4 @@
+export { evaluatorRoute } from './policy.js';
+export { reserveEvaluatorRequest } from './ledger.js';
+export { budgetEvaluatorInference, typeSafeEvaluatorEnvironment } from './provider.js';
+//# sourceMappingURL=index.js.map

package/dist/training/inference/evaluator/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/training/inference/evaluator/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAyB,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,wBAAwB,EAAE,4BAA4B,EAAE,MAAM,eAAe,CAAC"}

package/dist/training/inference/evaluator/ledger.d.ts

@@ -0,0 +1,29 @@
+import type { InferenceProviderRegistry } from '../../contracts/inference-registry.js';
+import { z } from 'zod';
+import { type EvaluatorPurpose } from './policy.js';
+declare const receipt: z.ZodObject<{
+    version: z.ZodPreprocess<z.ZodLiteral<"spawnfile.training.evaluator-request.v1">>;
+    id: z.ZodString;
+    policy: z.ZodString;
+    route: z.ZodString;
+    event: z.ZodEnum<{
+        completed: "completed";
+        failed: "failed";
+        admitted: "admitted";
+    }>;
+    at: z.ZodString;
+    reservedUsd: z.ZodNumber;
+    chargedUsd: z.ZodNumber;
+    inputTokens: z.ZodNullable<z.ZodNumber>;
+    outputTokens: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strict>;
+export type EvaluatorReceipt = z.infer<typeof receipt>;
+export declare function reserveEvaluatorRequest(provider: string, purpose: EvaluatorPurpose, model: string, estimatedUsd?: number, registry?: InferenceProviderRegistry): {
+    id: string;
+    finish(outcome: "completed" | "failed", accounting?: {
+        inputTokens?: number | null;
+        outputTokens?: number | null;
+        usd?: number | null;
+    }): void;
+};
+export {};