spawnfile 0.1.24 → 0.1.27

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

@@ -0,0 +1,70 @@
+import { compatibleWireLiteral } from '../../contracts/index.js';
+import { appendFileSync, constants, closeSync, fstatSync, fsyncSync, openSync, readFileSync } from 'node:fs';
+import { randomUUID, createHash } from 'node:crypto';
+import { z } from 'zod';
+import { evaluatorRoute, routeKey } from './policy.js';
+const receipt = z.object({ version: compatibleWireLiteral('spawnfile.training.evaluator-request.v1'), id: z.string().uuid(),
+    policy: z.string().regex(/^[a-f0-9]{64}$/u), route: z.string(),
+    event: z.enum(['admitted', 'completed', 'failed']), at: z.string().datetime(),
+    reservedUsd: z.number().finite().nonnegative(), chargedUsd: z.number().finite().nonnegative(),
+    inputTokens: z.number().int().nonnegative().nullable(), outputTokens: z.number().int().nonnegative().nullable(),
+}).strict();
+export function reserveEvaluatorRequest(provider, purpose, model, estimatedUsd = 0, registry) {
+    const selected = evaluatorRoute(provider, purpose, model, registry), route = routeKey(selected.route);
+    const policy = createHash('sha256').update(JSON.stringify(selected.route)).digest('hex');
+    if (!Number.isFinite(estimatedUsd) || estimatedUsd < 0)
+        throw Error('Invalid evaluator spend estimate');
+    // Synchronous append and fsync serialize concurrent admission in the single evaluator process.
+    // The admission survives interruption; missing completions keep their conservative charge.
+    const fd = openSync(selected.receiptPath, constants.O_RDWR | constants.O_APPEND | constants.O_CREAT | constants.O_NOFOLLOW | constants.O_NONBLOCK, 0o600);
+    try {
+        if (!fstatSync(fd).isFile())
+            throw Error('Invalid evaluator receipt ledger');
+        const bytes = readFileSync(fd, 'utf8');
+        const previous = bytes === '' ? [] : bytes.trimEnd().split('\n').map(line => receipt.parse(JSON.parse(line)));
+        const owned = previous.filter(item => item.route === route);
+        if (owned.some(item => item.policy !== policy))
+            throw Error('Evaluator budget changed on resume');
+        const calls = new Map();
+        for (const item of owned) {
+            if (item.event === 'admitted') {
+                if (calls.has(item.id))
+                    throw Error('Duplicate evaluator admission');
+            }
+            else if (calls.get(item.id)?.event !== 'admitted')
+                throw Error('Invalid evaluator completion');
+            calls.set(item.id, item);
+        }
+        const spent = [...calls.values()].reduce((sum, item) => sum + Math.max(item.reservedUsd, item.chargedUsd), 0);
+        if (calls.size >= selected.route.maxRequests)
+            throw Error('Evaluator request cap exhausted');
+        if (selected.route.maxSpendUsd === 0 || (selected.route.maxSpendUsd !== undefined && spent + estimatedUsd > selected.route.maxSpendUsd)) {
+            throw Error('Evaluator spend cap exhausted');
+        }
+        const admitted = { version: 'spawnfile.training.evaluator-request.v1', id: randomUUID(), policy, route,
+            event: 'admitted', at: new Date().toISOString(), reservedUsd: estimatedUsd, chargedUsd: 0, inputTokens: null, outputTokens: null };
+        appendFileSync(fd, `${JSON.stringify(admitted)}\n`);
+        fsyncSync(fd);
+        return { id: admitted.id,
+            finish(outcome, accounting) {
+                const count = (value) => typeof value === 'number' && Number.isSafeInteger(value) && value >= 0 ? value : null;
+                const usd = accounting?.usd;
+                const completed = { ...admitted, event: outcome, at: new Date().toISOString(),
+                    chargedUsd: typeof usd === 'number' && Number.isFinite(usd) && usd >= 0 ? usd : 0,
+                    inputTokens: count(accounting?.inputTokens), outputTokens: count(accounting?.outputTokens) };
+                const target = openSync(selected.receiptPath, constants.O_WRONLY | constants.O_APPEND | constants.O_NOFOLLOW);
+                try {
+                    appendFileSync(target, `${JSON.stringify(completed)}\n`);
+                    fsyncSync(target);
+                }
+                finally {
+                    closeSync(target);
+                }
+            },
+        };
+    }
+    finally {
+        closeSync(fd);
+    }
+}
+//# sourceMappingURL=ledger.js.map

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

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

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

@@ -0,0 +1,39 @@
+import type { InferenceProviderRegistry } from '../../contracts/inference-registry.js';
+import { z } from 'zod';
+declare const route: z.ZodObject<{
+    purpose: z.ZodEnum<{
+        extraction: "extraction";
+        decisions: "decisions";
+        proposals: "proposals";
+    }>;
+    provider: z.ZodString;
+    model: z.ZodString;
+    maxRequests: z.ZodNumber;
+    maxSpendUsd: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export type EvaluatorRoute = z.infer<typeof route>;
+export type EvaluatorPurpose = EvaluatorRoute['purpose'];
+export declare function routeKey(value: Pick<EvaluatorRoute, 'purpose' | 'provider' | 'model'>): string;
+export declare function readProtectedFile(file: string, maximum: number): string;
+export declare function evaluatorPolicy(registry?: InferenceProviderRegistry): {
+    version: "spawnfile.training.evaluator-routes.v1";
+    routes: {
+        purpose: "extraction" | "decisions" | "proposals";
+        provider: string;
+        model: string;
+        maxRequests: number;
+        maxSpendUsd?: number | undefined;
+    }[];
+    receiptPath: string;
+} | undefined;
+export declare function evaluatorRoute(provider: string, purpose: EvaluatorPurpose, model: string, registry?: InferenceProviderRegistry): {
+    route: {
+        purpose: "extraction" | "decisions" | "proposals";
+        provider: string;
+        model: string;
+        maxRequests: number;
+        maxSpendUsd?: number | undefined;
+    };
+    receiptPath: string;
+};
+export {};

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

@@ -0,0 +1,67 @@
+import { defaultInferenceProviders } from '../../providers/index.js';
+import { trainingEnvironment } from '../../platform/index.js';
+import { compatibleWireLiteral } from '../../contracts/index.js';
+import { constants, closeSync, fstatSync, openSync, readFileSync } from 'node:fs';
+import { isAbsolute } from 'node:path';
+import { z } from 'zod';
+const route = z.object({
+    purpose: z.enum(['extraction', 'proposals', 'decisions']),
+    provider: z.string().min(1).max(128), model: z.string().min(1).max(128).regex(/^[A-Za-z0-9._:-]+$/u),
+    maxRequests: z.number().int().positive().max(Number.MAX_SAFE_INTEGER),
+    maxSpendUsd: z.number().finite().nonnegative().optional(),
+}).strict();
+const schema = z.object({ version: compatibleWireLiteral('spawnfile.training.evaluator-routes.v1'), routes: z.array(route).min(1).max(64),
+    receiptPath: z.string().min(1).refine(isAbsolute),
+}).strict().superRefine((value, ctx) => {
+    const keys = value.routes.map(routeKey);
+    if (new Set(keys).size !== keys.length)
+        ctx.addIssue({ code: 'custom', message: 'Duplicate evaluator route' });
+});
+export function routeKey(value) {
+    return `${value.purpose}:${value.provider}:${value.model}`;
+}
+export function readProtectedFile(file, maximum) {
+    const fd = openSync(file, constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK);
+    try {
+        const stat = fstatSync(fd);
+        if (!stat.isFile() || stat.nlink !== 1 || stat.size > maximum)
+            throw Error('Invalid evaluator leaf file');
+        const bytes = readFileSync(fd);
+        if (bytes.length > maximum)
+            throw Error('Invalid evaluator leaf file');
+        return new TextDecoder('utf-8', { fatal: true }).decode(bytes);
+    }
+    finally {
+        closeSync(fd);
+    }
+}
+export function evaluatorPolicy(registry = defaultInferenceProviders) {
+    const file = trainingEnvironment('SPAWNFILE_TRAINING_EVALUATOR_ROUTES_FILE');
+    if (!file)
+        return undefined;
+    try {
+        const policy = schema.parse(JSON.parse(readProtectedFile(file, 64 * 1024)));
+        for (const route of policy.routes) {
+            const descriptor = Object.hasOwn(registry.providers, route.provider) ? registry.providers[route.provider] : undefined;
+            const dedicated = registry.evaluatorProviders && Object.hasOwn(registry.evaluatorProviders, route.provider)
+                ? registry.evaluatorProviders[route.provider] : undefined;
+            const purposes = dedicated?.purposes ?? descriptor?.capabilities.evaluatorPurposes;
+            const budget = dedicated?.budget ?? descriptor?.capabilities.evaluatorBudget;
+            if (!purposes?.includes(route.purpose) || !budget ||
+                (budget === 'usd') !== (route.maxSpendUsd !== undefined))
+                throw Error('Unsupported budgeted provider');
+        }
+        return policy;
+    }
+    catch {
+        throw Error('Invalid evaluator route policy');
+    }
+}
+export function evaluatorRoute(provider, purpose, model, registry = defaultInferenceProviders) {
+    const policy = evaluatorPolicy(registry);
+    const selected = policy?.routes.find(value => value.provider === provider && value.purpose === purpose && value.model === model);
+    if (!selected)
+        throw Error(`Capped training requires ${registry.brokerAdmissionLabel ?? 'broker'} admission; undeclared evaluator ${purpose} uses unsupported ${provider}`);
+    return { route: selected, receiptPath: policy.receiptPath };
+}
+//# sourceMappingURL=policy.js.map

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

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

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

@@ -0,0 +1,6 @@
+import type { InferenceProviderRegistry } from '../../contracts/inference-registry.js';
+import type { InferenceProvider } from '../../contracts/execution.js';
+import { type EvaluatorPurpose } from './policy.js';
+export declare function budgetEvaluatorInference(provider: InferenceProvider, name: string, purpose: EvaluatorPurpose, model: string, registry?: InferenceProviderRegistry): InferenceProvider;
+/** The leaf becomes an evaluator transport-local environment, never process.env. */
+export declare function typeSafeEvaluatorEnvironment(): Readonly<Record<string, string | undefined>> | undefined;

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

@@ -0,0 +1,45 @@
+import { defaultInferenceProviders } from '../../providers/index.js';
+import { trainingEnvironment } from '../../platform/index.js';
+import { evaluatorRoute, readProtectedFile } from './policy.js';
+import { reserveEvaluatorRequest } from './ledger.js';
+export function budgetEvaluatorInference(provider, name, purpose, model, registry = defaultInferenceProviders) {
+    if (Object.hasOwn(registry.providers, name) && registry.providers[name]?.capabilities.brokerAdmission || trainingEnvironment('SPAWNFILE_TRAINING_MODEL_REQUEST_CAP') !== 'broker' && trainingEnvironment('SPAWNFILE_TRAINING_EVALUATOR_ROUTES_FILE') === undefined)
+        return provider;
+    evaluatorRoute(name, purpose, model, registry);
+    return { ...provider, async generate(request) {
+            if (request.model !== model)
+                throw Error('Evaluator request model differs from declared model');
+            request.signal?.throwIfAborted();
+            const admission = reserveEvaluatorRequest(name, purpose, model, 0, registry);
+            let settled = false;
+            try {
+                const result = await provider.generate(request);
+                settled = true;
+                admission.finish('completed', result.usage ?? undefined);
+                return result;
+            }
+            catch (error) {
+                if (!settled) {
+                    const usage = error !== null && typeof error === 'object' && 'usage' in error ? error.usage : undefined;
+                    admission.finish('failed', usage && typeof usage === 'object' ? usage : undefined);
+                }
+                throw error;
+            }
+        } };
+}
+/** The leaf becomes an evaluator transport-local environment, never process.env. */
+export function typeSafeEvaluatorEnvironment() {
+    const file = trainingEnvironment('SPAWNFILE_TRAINING_TYPESAFE_SECRET_FILE');
+    if (!file)
+        return undefined;
+    try {
+        const key = readProtectedFile(file, 16 * 1024).trim();
+        if (!key || /[\r\n\0]/u.test(key))
+            throw Error('invalid');
+        return { TYPESAFE_API_KEY: key };
+    }
+    catch {
+        throw Error('Invalid evaluator TypeSafe secret file');
+    }
+}
+//# sourceMappingURL=provider.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../../../src/training/inference/evaluator/provider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAE9D,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAyB,MAAM,aAAa,CAAC;AACvF,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAEtD,MAAM,UAAU,wBAAwB,CAAC,QAA2B,EAAE,IAAY,EAAE,OAAyB,EAAE,KAAa,EAAE,WAAsC,yBAAyB;IAC3L,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC,eAAe,IAAI,mBAAmB,CAAC,sCAAsC,CAAC,KAAK,QAAQ,IAAI,mBAAmB,CAAC,0CAA0C,CAAC,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IACpR,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC/C,OAAO,EAAE,GAAG,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,OAAO;YAC1C,IAAI,OAAO,CAAC,KAAK,KAAK,KAAK;gBAAE,MAAM,KAAK,CAAC,qDAAqD,CAAC,CAAC;YAChG,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;YACjC,MAAM,SAAS,GAAG,uBAAuB,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC;YAC7E,IAAI,OAAO,GAAG,KAAK,CAAC;YACpB,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;gBAChD,OAAO,GAAG,IAAI,CAAC;gBACf,SAAS,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,KAAK,IAAI,SAAS,CAAC,CAAC;gBACzD,OAAO,MAAM,CAAC;YAChB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,OAAO,EAAE,CAAC;oBACb,MAAM,KAAK,GAAG,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;oBACxG,SAAS,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;gBACrF,CAAC;gBACD,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC,EAAE,CAAC;AACN,CAAC;AACD,oFAAoF;AACpF,MAAM,UAAU,4BAA4B;IAC1C,MAAM,IAAI,GAAG,mBAAmB,CAAC,yCAAyC,CAAC,CAAC;IAC5E,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,iBAAiB,CAAC,IAAI,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;QACtD,IAAI,CAAC,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC;YAAE,MAAM,KAAK,CAAC,SAAS,CAAC,CAAC;QAC1D,OAAO,EAAE,gBAAgB,EAAE,GAAG,EAAE,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QAAC,MAAM,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAAC,CAAC;AACpE,CAAC"}

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

@@ -0,0 +1,27 @@
+import type { InferenceAttempt, InferenceFailureDetail, InferenceFailureKind, InferenceDiagnostic, Usage } from '../contracts/execution.js';
+export interface InferenceFailureEvidence {
+    /** A closed refinement of `kind`, set only by the adapter that observed the distinction. */
+    detail?: InferenceFailureDetail | null;
+    /** A provider-reported response status, retained as a number so no prose has to be parsed back. */
+    status?: number | null;
+    usage?: Usage | null;
+    responseModel?: string | null;
+    responseRoute?: string | null;
+    attempts?: readonly InferenceAttempt[];
+    diagnostic?: InferenceDiagnostic;
+}
+/** Adapters classify native evidence; routing never guesses from arbitrary error text. */
+export declare class InferenceFailure extends Error {
+    #private;
+    readonly kind: InferenceFailureKind;
+    readonly detail: InferenceFailureDetail | null;
+    readonly status: number | null;
+    readonly usage: Usage | null;
+    readonly responseModel: string | null;
+    readonly responseRoute: string | null;
+    readonly attempts: readonly InferenceAttempt[];
+    /** Prototype getter keeps protected text out of JSON.stringify/spread of errors. */
+    get diagnostic(): InferenceDiagnostic | undefined;
+    constructor(kind: InferenceFailureKind, message: string, evidence?: InferenceFailureEvidence);
+}
+export declare function immutableAttempts(attempts: readonly InferenceAttempt[]): readonly InferenceAttempt[];

package/dist/training/inference/failure.js

@@ -0,0 +1,36 @@
+/** Adapters classify native evidence; routing never guesses from arbitrary error text. */
+export class InferenceFailure extends Error {
+    kind;
+    detail;
+    status;
+    usage;
+    responseModel;
+    responseRoute;
+    attempts;
+    #diagnostic;
+    /** Prototype getter keeps protected text out of JSON.stringify/spread of errors. */
+    get diagnostic() { return this.#diagnostic; }
+    constructor(kind, message, evidence = {}) {
+        super(message);
+        this.name = 'InferenceFailure';
+        this.kind = kind;
+        this.detail = evidence.detail ?? null;
+        this.status = Number.isSafeInteger(evidence.status) ? evidence.status : null;
+        if (evidence.diagnostic) {
+            const diagnostic = structuredClone(evidence.diagnostic);
+            if (diagnostic.response)
+                Object.freeze(diagnostic.response);
+            this.#diagnostic = Object.freeze(diagnostic);
+        }
+        this.usage = evidence.usage == null ? null : Object.freeze(structuredClone(evidence.usage));
+        this.responseModel = evidence.responseModel ?? null;
+        this.responseRoute = evidence.responseRoute ?? null;
+        this.attempts = immutableAttempts(evidence.attempts ?? []);
+    }
+}
+export function immutableAttempts(attempts) {
+    return Object.freeze(attempts.map(attempt => Object.freeze({ ...attempt,
+        usage: attempt.usage === null ? null : Object.freeze(structuredClone(attempt.usage)),
+    })));
+}
+//# sourceMappingURL=failure.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"failure.js","sourceRoot":"","sources":["../../../src/training/inference/failure.ts"],"names":[],"mappings":"AAcA,0FAA0F;AAC1F,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAChC,IAAI,CAAuB;IAC3B,MAAM,CAAgC;IACtC,MAAM,CAAgB;IACtB,KAAK,CAAe;IACpB,aAAa,CAAgB;IAC7B,aAAa,CAAgB;IAC7B,QAAQ,CAA8B;IAC/C,WAAW,CAAuB;IAClC,oFAAoF;IACpF,IAAI,UAAU,KAAsC,OAAO,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;IAE9E,YAAY,IAA0B,EAAE,OAAe,EAAE,WAAqC,EAAE;QAC9F,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,IAAI,IAAI,CAAC;QACtC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAO,CAAC,CAAC,CAAC,IAAI,CAAC;QAC9E,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;YACxB,MAAM,UAAU,GAAG,eAAe,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;YACxD,IAAI,UAAU,CAAC,QAAQ;gBAAE,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;YAC5D,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC/C,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;QAC5F,IAAI,CAAC,aAAa,GAAG,QAAQ,CAAC,aAAa,IAAI,IAAI,CAAC;QACpD,IAAI,CAAC,aAAa,GAAG,QAAQ,CAAC,aAAa,IAAI,IAAI,CAAC;QACpD,IAAI,CAAC,QAAQ,GAAG,iBAAiB,CAAC,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;IAC7D,CAAC;CACF;AAED,MAAM,UAAU,iBAAiB,CAAC,QAAqC;IACrE,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,OAAO;QACrE,KAAK,EAAE,OAAO,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;KACrF,CAAC,CAAC,CAAC,CAAC;AACP,CAAC"}

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

@@ -0,0 +1,8 @@
+export { createClaudeInference, type ClaudeInferenceOptions } from './claude/index.js';
+export { InferenceFailure, type InferenceFailureEvidence } from './failure.js';
+export { createRoutedInference, type InferenceRoute, type RoutedInferenceOptions } from './routing.js';
+export { createOllamaInference, type OllamaInferenceOptions } from './ollama/index.js';
+export { validateInferenceSchema, validateInferenceResponse, validateInferenceSchemaData } from './response-schema.js';
+export { captureInferenceDiagnostic } from './diagnostic.js';
+export { assertModelRequestAdmission } from './request-cap.js';
+export { budgetEvaluatorInference, typeSafeEvaluatorEnvironment } from './evaluator/index.js';

package/dist/training/inference/index.js

@@ -0,0 +1,9 @@
+export { createClaudeInference } from './claude/index.js';
+export { InferenceFailure } from './failure.js';
+export { createRoutedInference } from './routing.js';
+export { createOllamaInference } from './ollama/index.js';
+export { validateInferenceSchema, validateInferenceResponse, validateInferenceSchemaData } from './response-schema.js';
+export { captureInferenceDiagnostic } from './diagnostic.js';
+export { assertModelRequestAdmission } from './request-cap.js';
+export { budgetEvaluatorInference, typeSafeEvaluatorEnvironment } from './evaluator/index.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/training/inference/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAA+B,MAAM,mBAAmB,CAAC;AACvF,OAAO,EAAE,gBAAgB,EAAiC,MAAM,cAAc,CAAC;AAC/E,OAAO,EAAE,qBAAqB,EAAoD,MAAM,cAAc,CAAC;AACvG,OAAO,EAAE,qBAAqB,EAA+B,MAAM,mBAAmB,CAAC;AACvF,OAAO,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACvH,OAAO,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,wBAAwB,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/training/inference/ollama/context.d.ts

@@ -0,0 +1,2 @@
+/** Native truncate/shift controls are verified against the first tested server release. */
+export declare function ollamaContextSupport(base: URL, fetcher: typeof fetch): (signal: AbortSignal) => Promise<void>;

package/dist/training/inference/ollama/context.js

@@ -0,0 +1,28 @@
+import { InferenceFailure } from '../failure.js';
+/** Native truncate/shift controls are verified against the first tested server release. */
+export function ollamaContextSupport(base, fetcher) {
+    let verified = false;
+    return async (signal) => {
+        if (verified)
+            return;
+        const url = new URL(`${base.pathname.replace(/\/$/u, '')}/api/version`, base);
+        const response = await fetcher(url, { signal });
+        if (!response.ok)
+            throw new InferenceFailure(response.status === 401 || response.status === 403 ? 'authentication' : 'unavailable', 'Ollama context capability check failed');
+        let body;
+        try {
+            body = await response.json();
+        }
+        catch (error) {
+            if (signal.aborted)
+                throw error;
+            throw new InferenceFailure('protocol', 'Ollama version response is not valid JSON');
+        }
+        const version = typeof body?.version === 'string' ? /^(\d+)\.(\d+)\.(\d+)$/u.exec(body.version) : null;
+        if (!version || (Number(version[1]) === 0 && Number(version[2]) < 34)) {
+            throw new InferenceFailure('unsupported', 'Explicit no-truncation context requires Ollama 0.34.0 or later');
+        }
+        verified = true;
+    };
+}
+//# sourceMappingURL=context.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../../src/training/inference/ollama/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,2FAA2F;AAC3F,MAAM,UAAU,oBAAoB,CAAC,IAAS,EAAE,OAAqB;IACnE,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,OAAO,KAAK,EAAE,MAAmB,EAAiB,EAAE;QAClD,IAAI,QAAQ;YAAE,OAAO;QACrB,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;QAC9E,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QAChD,IAAI,CAAC,QAAQ,CAAC,EAAE;YAAE,MAAM,IAAI,gBAAgB,CAAC,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,aAAa,EAAE,wCAAwC,CAAC,CAAC;QAC9K,IAAI,IAAkC,CAAC;QACvC,IAAI,CAAC;YAAC,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAkC,CAAC;QAAC,CAAC;QACrE,OAAO,KAAK,EAAE,CAAC;YACb,IAAI,MAAM,CAAC,OAAO;gBAAE,MAAM,KAAK,CAAC;YAChC,MAAM,IAAI,gBAAgB,CAAC,UAAU,EAAE,2CAA2C,CAAC,CAAC;QACtF,CAAC;QACD,MAAM,OAAO,GAAG,OAAO,IAAI,EAAE,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACvG,IAAI,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC;YACtE,MAAM,IAAI,gBAAgB,CAAC,aAAa,EAAE,gEAAgE,CAAC,CAAC;QAC9G,CAAC;QACD,QAAQ,GAAG,IAAI,CAAC;IAClB,CAAC,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,2 @@
+export { createOllamaInference, type OllamaInferenceOptions } from './provider.js';
+export { ollamaContextSupport } from './context.js';

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

@@ -0,0 +1,3 @@
+export { createOllamaInference } from './provider.js';
+export { ollamaContextSupport } from './context.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/training/inference/ollama/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAA+B,MAAM,eAAe,CAAC;AACnF,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC"}

package/dist/training/inference/ollama/provider.d.ts

@@ -0,0 +1,12 @@
+import type { InferenceProvider } from '../../contracts/execution.js';
+export interface OllamaInferenceOptions {
+    baseUrl: string;
+    timeoutMs?: number;
+    fetch?: typeof fetch;
+    think?: boolean;
+    keepAliveSeconds?: number;
+    maxOutputTokens?: number;
+    contextWindowTokens?: number;
+}
+/** Native Ollama chat, without tools. Reasoning is never substituted for final content. */
+export declare function createOllamaInference(options: OllamaInferenceOptions): InferenceProvider;

package/dist/training/inference/ollama/provider.js

@@ -0,0 +1,100 @@
+import { ollamaContextSupport } from './context.js';
+import { captureInferenceDiagnostic } from '../diagnostic.js';
+import { InferenceFailure } from '../failure.js';
+import { validateInferenceSchema, validateInferenceResponse } from '../response-schema.js';
+/** Native Ollama chat, without tools. Reasoning is never substituted for final content. */
+export function createOllamaInference(options) {
+    const base = new URL(options.baseUrl);
+    if (!['http:', 'https:'].includes(base.protocol) || base.username || base.password || base.search || base.hash)
+        throw new Error('Invalid Ollama endpoint');
+    const timeoutMs = options.timeoutMs ?? 180_000;
+    if (!Number.isSafeInteger(timeoutMs) || timeoutMs < 1 || timeoutMs > 2_147_483_647)
+        throw new Error('Invalid Ollama timeout');
+    const { think, keepAliveSeconds, maxOutputTokens, contextWindowTokens } = options;
+    if ((contextWindowTokens !== undefined && (!Number.isSafeInteger(contextWindowTokens) || contextWindowTokens < 512 || contextWindowTokens > 1048576)) ||
+        (think !== undefined && typeof think !== 'boolean') ||
+        (keepAliveSeconds !== undefined && (!Number.isSafeInteger(keepAliveSeconds) || keepAliveSeconds < 0 || keepAliveSeconds > 86400)) ||
+        (maxOutputTokens !== undefined && (!Number.isSafeInteger(maxOutputTokens) || maxOutputTokens < 1 || maxOutputTokens > 131072))) {
+        throw new InferenceFailure('unsupported', 'Invalid native Ollama completion controls');
+    }
+    const endpoint = new URL(`${base.pathname.replace(/\/$/u, '')}/api/chat`, base).href;
+    const verifyContext = ollamaContextSupport(base, options.fetch ?? fetch);
+    return {
+        id: `ollama:${base.href}`,
+        capabilities: { tools: 'disabled', billing: 'local', temperature: true, seed: true },
+        async generate(request) {
+            validateInferenceSchema(request.responseSchema);
+            const responseSchema = request.responseSchema === undefined ? undefined : structuredClone(request.responseSchema);
+            if ((responseSchema !== undefined || contextWindowTokens !== undefined || think !== undefined || keepAliveSeconds !== undefined || maxOutputTokens !== undefined) && (base.hostname === 'ollama.com' || base.hostname.endsWith('.ollama.com') || request.model.endsWith('-cloud'))) {
+                throw new InferenceFailure('unsupported', 'Ollama Cloud does not support the requested native controls');
+            }
+            if (think !== undefined && /(?:^|\/)gpt-oss(?::|$)/u.test(request.model))
+                throw new InferenceFailure('unsupported', 'GPT-OSS requires thinking levels; boolean think is unsupported');
+            if (!request.prompt.trim() || !request.model.trim() || request.model.startsWith('-') ||
+                (request.temperature !== undefined && (!Number.isFinite(request.temperature) || request.temperature < 0)) ||
+                (request.seed !== undefined && !Number.isSafeInteger(request.seed)))
+                throw new InferenceFailure('unsupported', 'Invalid Ollama request');
+            if (request.signal?.aborted)
+                throw new InferenceFailure('cancelled', 'Ollama cancelled');
+            const timeout = AbortSignal.timeout(timeoutMs);
+            const signal = request.signal === undefined ? timeout : AbortSignal.any([request.signal, timeout]);
+            let response;
+            try {
+                if (contextWindowTokens !== undefined)
+                    await verifyContext(signal);
+                response = await (options.fetch ?? fetch)(endpoint, { method: 'POST', signal,
+                    headers: { 'content-type': 'application/json' },
+                    body: JSON.stringify({ model: request.model, stream: false,
+                        ...(contextWindowTokens === undefined ? {} : { truncate: false, shift: false }),
+                        ...(think === undefined ? {} : { think }),
+                        ...(keepAliveSeconds === undefined ? {} : { keep_alive: `${keepAliveSeconds}s` }),
+                        ...(responseSchema === undefined ? {} : { format: responseSchema }),
+                        messages: [...(request.system === undefined ? [] : [{ role: 'system', content: request.system }]),
+                            { role: 'user', content: request.prompt }],
+                        options: { ...(contextWindowTokens === undefined ? {} : { num_ctx: contextWindowTokens }), temperature: request.temperature, seed: request.seed, ...(maxOutputTokens === undefined ? {} : { num_predict: maxOutputTokens }) } }),
+                });
+            }
+            catch (error) {
+                if (error instanceof InferenceFailure)
+                    throw error;
+                throw new InferenceFailure(request.signal?.aborted ? 'cancelled' : timeout.aborted ? 'timeout' : 'transport', 'Ollama request failed');
+            }
+            if (!response.ok)
+                throw new InferenceFailure(response.status === 429 ? 'quota' :
+                    response.status === 401 || response.status === 403 ? 'authentication' :
+                        response.status >= 500 || response.status === 404 ? 'unavailable' :
+                            (responseSchema !== undefined || think !== undefined || keepAliveSeconds !== undefined || maxOutputTokens !== undefined || contextWindowTokens !== undefined) && response.status === 400 ? 'unsupported' : 'protocol', `Ollama HTTP ${response.status}`);
+            let raw;
+            try {
+                raw = await response.json();
+            }
+            catch {
+                throw new InferenceFailure(request.signal?.aborted ? 'cancelled' : timeout.aborted ? 'timeout' : 'protocol', 'Ollama response body failed');
+            }
+            const data = raw;
+            const message = data?.['message'];
+            const count = (key) => typeof data?.[key] === 'number' && Number.isSafeInteger(data[key]) && data[key] >= 0 ? data[key] : null;
+            const evidence = {
+                responseModel: typeof data?.['model'] === 'string' && data['model'].trim() ? data['model'] : null,
+                responseRoute: `ollama:${base.href}`,
+                usage: { inputTokens: count('prompt_eval_count'), outputTokens: count('eval_count'), cachedInputTokens: null,
+                    reasoningTokens: null, source: 'ollama.chat.counts' },
+            };
+            if ((data?.['done_reason'] !== undefined && data['done_reason'] !== 'stop') || data?.['done'] !== true || typeof data['model'] !== 'string' || !data['model'].trim() ||
+                typeof message?.['content'] !== 'string' || !message['content'].trim() ||
+                (Array.isArray(message['tool_calls']) && message['tool_calls'].length > 0))
+                throw new InferenceFailure('protocol', 'Ollama omitted a completed text response', { ...evidence, diagnostic: captureInferenceDiagnostic('response-envelope') });
+            if (think === false && typeof message['thinking'] === 'string' && message['thinking'].length)
+                throw new InferenceFailure('unsupported', 'Ollama returned thinking despite think:false', evidence);
+            try {
+                validateInferenceResponse(message['content'], responseSchema);
+            }
+            catch {
+                throw new InferenceFailure('invalid-response', 'Ollama response violated the requested schema', { ...evidence, diagnostic: captureInferenceDiagnostic('response-schema', message['content']) });
+            }
+            return { text: message['content'], model: data['model'], modelBasis: 'provider-reported', route: `ollama:${base.href}`,
+                usage: evidence.usage };
+        },
+    };
+}
+//# sourceMappingURL=provider.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../../../src/training/inference/ollama/provider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAY3F,2FAA2F;AAC3F,MAAM,UAAU,qBAAqB,CAAC,OAA+B;IACnE,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACtC,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC3J,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC;IAC/C,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,SAAS,GAAG,CAAC,IAAI,SAAS,GAAG,aAAa;QAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAC9H,MAAM,EAAE,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,mBAAmB,EAAE,GAAG,OAAO,CAAC;IAClF,IAAI,CAAC,mBAAmB,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,mBAAmB,CAAC,IAAI,mBAAmB,GAAG,GAAG,IAAI,mBAAmB,GAAG,OAAO,CAAC,CAAC;QACnJ,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,SAAS,CAAC;QACnD,CAAC,gBAAgB,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,gBAAgB,CAAC,IAAI,gBAAgB,GAAG,CAAC,IAAI,gBAAgB,GAAG,KAAK,CAAC,CAAC;QACjI,CAAC,eAAe,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,eAAe,CAAC,IAAI,eAAe,GAAG,CAAC,IAAI,eAAe,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC;QACjI,MAAM,IAAI,gBAAgB,CAAC,aAAa,EAAE,2CAA2C,CAAC,CAAC;IACzF,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC;IACrF,MAAM,aAAa,GAAG,oBAAoB,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC,CAAC;IACzE,OAAO;QACL,EAAE,EAAE,UAAU,IAAI,CAAC,IAAI,EAAE;QACzB,YAAY,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE;QACpF,KAAK,CAAC,QAAQ,CAAC,OAAO;YACpB,uBAAuB,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;YAChD,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;YAClH,IAAI,CAAC,cAAc,KAAK,SAAS,IAAI,mBAAmB,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS,IAAI,gBAAgB,KAAK,SAAS,IAAI,eAAe,KAAK,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,KAAK,YAAY,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;gBACnR,MAAM,IAAI,gBAAgB,CAAC,aAAa,EAAE,6DAA6D,CAAC,CAAC;YAC3G,CAAC;YACD,IAAI,KAAK,KAAK,SAAS,IAAI,yBAAyB,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;gBAAE,MAAM,IAAI,gBAAgB,CAAC,aAAa,EAAE,gEAAgE,CAAC,CAAC;YACtL,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;gBAClF,CAAC,OAAO,CAAC,WAAW,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,OAAO,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC;gBACzG,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;gBAAE,MAAM,IAAI,gBAAgB,CAAC,aAAa,EAAE,wBAAwB,CAAC,CAAC;YAC3I,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO;gBAAE,MAAM,IAAI,gBAAgB,CAAC,WAAW,EAAE,kBAAkB,CAAC,CAAC;YACzF,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YAC/C,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;YACnG,IAAI,QAAkB,CAAC;YACvB,IAAI,CAAC;gBACH,IAAI,mBAAmB,KAAK,SAAS;oBAAE,MAAM,aAAa,CAAC,MAAM,CAAC,CAAC;gBACnE,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;oBAC1E,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;oBAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK;wBACxD,GAAG,CAAC,mBAAmB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;wBAC/E,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;wBACzC,GAAG,CAAC,gBAAgB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,gBAAgB,GAAG,EAAE,CAAC;wBACjF,GAAG,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;wBACnE,QAAQ,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;4BAC/F,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;wBAC5C,OAAO,EAAE,EAAE,GAAG,CAAC,mBAAmB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,mBAAmB,EAAE,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,eAAe,EAAE,CAAC,EAAE,EAAE,CAAC;iBACnO,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,KAAK,YAAY,gBAAgB;oBAAE,MAAM,KAAK,CAAC;gBACnD,MAAM,IAAI,gBAAgB,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,EAAE,uBAAuB,CAAC,CAAC;YACzI,CAAC;YACD,IAAI,CAAC,QAAQ,CAAC,EAAE;gBAAE,MAAM,IAAI,gBAAgB,CAAC,QAAQ,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;oBAC9E,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;wBACrE,QAAQ,CAAC,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;4BACjE,CAAC,cAAc,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS,IAAI,gBAAgB,KAAK,SAAS,IAAI,eAAe,KAAK,SAAS,IAAI,mBAAmB,KAAK,SAAS,CAAC,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,UAAU,EAAE,eAAe,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YAC/P,IAAI,GAAY,CAAC;YACjB,IAAI,CAAC;gBAAC,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC;gBAC1C,MAAM,IAAI,gBAAgB,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,EAAE,6BAA6B,CAAC,CAAC;YAC9I,CAAC;YACD,MAAM,IAAI,GAAG,GAAqC,CAAC;YACnD,MAAM,OAAO,GAAG,IAAI,EAAE,CAAC,SAAS,CAAwC,CAAC;YACzE,MAAM,KAAK,GAAG,CAAC,GAAW,EAAiB,EAAE,CAAC,OAAO,IAAI,EAAE,CAAC,GAAG,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YACtJ,MAAM,QAAQ,GAAG;gBACf,aAAa,EAAE,OAAO,IAAI,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI;gBACjG,aAAa,EAAE,UAAU,IAAI,CAAC,IAAI,EAAE;gBACpC,KAAK,EAAE,EAAE,WAAW,EAAE,KAAK,CAAC,mBAAmB,CAAC,EAAE,YAAY,EAAE,KAAK,CAAC,YAAY,CAAC,EAAE,iBAAiB,EAAE,IAAI;oBAC1G,eAAe,EAAE,IAAI,EAAE,MAAM,EAAE,oBAAoB,EAAE;aACxD,CAAC;YACF,IAAI,CAAC,IAAI,EAAE,CAAC,aAAa,CAAC,KAAK,SAAS,IAAI,IAAI,CAAC,aAAa,CAAC,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,MAAM,CAAC,KAAK,IAAI,IAAI,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE;gBAClK,OAAO,OAAO,EAAE,CAAC,SAAS,CAAC,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE;gBACtE,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;gBAAE,MAAM,IAAI,gBAAgB,CAAC,UAAU,EAAE,0CAA0C,EAAE,EAAE,GAAG,QAAQ,EAAE,UAAU,EAAE,0BAA0B,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC;YAC/O,IAAI,KAAK,KAAK,KAAK,IAAI,OAAO,OAAO,CAAC,UAAU,CAAC,KAAK,QAAQ,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC,MAAM;gBAAE,MAAM,IAAI,gBAAgB,CAAC,aAAa,EAAE,8CAA8C,EAAE,QAAQ,CAAC,CAAC;YAClM,IAAI,CAAC;gBAAC,yBAAyB,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,cAAc,CAAC,CAAC;YAAC,CAAC;YACtE,MAAM,CAAC;gBAAC,MAAM,IAAI,gBAAgB,CAAC,kBAAkB,EAAE,+CAA+C,EAAE,EAAE,GAAG,QAAQ,EAAE,UAAU,EAAE,0BAA0B,CAAC,iBAAiB,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC;YAAC,CAAC;YAC1M,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,mBAAmB,EAAE,KAAK,EAAE,UAAU,IAAI,CAAC,IAAI,EAAE;gBACpH,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC;QAC5B,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/training/inference/request-cap.d.ts

@@ -0,0 +1,7 @@
+import type { InferenceProviderRegistry } from '../contracts/inference-registry.js';
+import { type EvaluatorPurpose } from './evaluator/index.js';
+/** Subject requests remain broker-owned; evaluator admission pins purpose and model. */
+export declare function assertModelRequestAdmission(provider: string, route: string, evaluator?: {
+    purpose: EvaluatorPurpose;
+    model: string;
+}, registry?: InferenceProviderRegistry): void;

package/dist/training/inference/request-cap.js

@@ -0,0 +1,22 @@
+import { defaultInferenceProviders } from '../providers/index.js';
+import { trainingEnvironment } from '../platform/index.js';
+import { evaluatorRoute } from './evaluator/index.js';
+/** Subject requests remain broker-owned; evaluator admission pins purpose and model. */
+export function assertModelRequestAdmission(provider, route, evaluator, registry = defaultInferenceProviders) {
+    const policy = trainingEnvironment('SPAWNFILE_TRAINING_MODEL_REQUEST_CAP');
+    if (policy === undefined) {
+        if (evaluator && trainingEnvironment('SPAWNFILE_TRAINING_EVALUATOR_ROUTES_FILE') !== undefined)
+            evaluatorRoute(provider, evaluator.purpose, evaluator.model, registry);
+        return;
+    }
+    if (policy !== 'broker')
+        throw new Error('Unsupported SPAWNFILE_TRAINING_MODEL_REQUEST_CAP policy');
+    if (Object.hasOwn(registry.providers, provider) && registry.providers[provider]?.capabilities.brokerAdmission)
+        return;
+    if (evaluator) {
+        evaluatorRoute(provider, evaluator.purpose, evaluator.model, registry);
+        return;
+    }
+    throw new Error(`Capped training requires ${registry.brokerAdmissionLabel ?? 'broker'} admission; ${route} uses unsupported ${provider}`);
+}
+//# sourceMappingURL=request-cap.js.map

package/dist/training/inference/request-cap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-cap.js","sourceRoot":"","sources":["../../../src/training/inference/request-cap.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAyB,MAAM,sBAAsB,CAAC;AAE7E,wFAAwF;AACxF,MAAM,UAAU,2BAA2B,CAAC,QAAgB,EAAE,KAAa,EACzE,SAAwD,EAAE,WAAsC,yBAAyB;IACzH,MAAM,MAAM,GAAG,mBAAmB,CAAC,sCAAsC,CAAC,CAAC;IAC3E,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,IAAI,SAAS,IAAI,mBAAmB,CAAC,0CAA0C,CAAC,KAAK,SAAS;YAAE,cAAc,CAAC,QAAQ,EAAE,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACvK,OAAO;IACT,CAAC;IACD,IAAI,MAAM,KAAK,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IACpG,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,IAAI,QAAQ,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAC,eAAe;QAAE,OAAO;IACtH,IAAI,SAAS,EAAE,CAAC;QAAC,cAAc,CAAC,QAAQ,EAAE,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QAAC,OAAO;IAAC,CAAC;IAClG,MAAM,IAAI,KAAK,CAAC,4BAA4B,QAAQ,CAAC,oBAAoB,IAAI,QAAQ,eAAe,KAAK,qBAAqB,QAAQ,EAAE,CAAC,CAAC;AAC5I,CAAC"}

package/dist/training/inference/response-schema.d.ts

@@ -0,0 +1,9 @@
+import { type AnySchema } from 'ajv';
+type ResponseSchema = Readonly<Record<string, unknown>> | undefined;
+/** Check JSON safety and transport size before provider-specific dialect admission. */
+export declare function validateInferenceSchemaData(schema: Exclude<ResponseSchema, undefined>): AnySchema;
+/** Reject unsupported controls before calling a model; never fetch external schemas. */
+export declare function validateInferenceSchema(schema: ResponseSchema): void;
+/** Default strict JSON; extraction may explicitly permit a single json fence. */
+export declare function validateInferenceResponse(text: string, schema: ResponseSchema, jsonFence?: boolean): void;
+export {};