spawnfile 0.1.24 → 0.1.27

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

@@ -0,0 +1 @@
+{"version":3,"file":"execution.js","sourceRoot":"","sources":["../../../src/training/contracts/execution.ts"],"names":[],"mappings":"AA8SA;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,eAAe,EAAE,eAAe,EAAE,iBAAiB,EAAE,WAAW,CAAU,CAAC;AAGnH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,gBAAgB,EAAE,gBAAgB,EAAE,cAAc,EAAE,mBAAmB,EAAE,gBAAgB;IAC9H,gBAAgB,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,kBAAkB;IAClG,eAAe,EAAE,eAAe,EAAE,eAAe,EAAE,mBAAmB,EAAE,iBAAiB,CAAU,CAAC"}

package/dist/training/contracts/grader-providers.d.ts

@@ -0,0 +1,40 @@
+import type { InferenceProvider } from './execution.js';
+export interface GraderTeacher {
+    id: string;
+    provider: string;
+    model: string;
+    effort?: string;
+}
+export interface ProviderAvailabilityWindow {
+    start: string;
+    end: string;
+    timeZone?: string;
+}
+export interface GraderProviderDescriptor {
+    id: string;
+    inferenceProviderId: string;
+    decisionTools: 'disabled' | 'contained';
+    teacherPolicy: string;
+    decompositionExtractor: boolean;
+    atomicExtractor: boolean;
+    validateAtomicConfig(config: GraderTeacher): void;
+    create(config: GraderTeacher, timeoutMs?: number): InferenceProvider;
+}
+export interface CouncilProviderPolicy {
+    requiredProviders: readonly string[];
+    requiredMessage: string;
+    defaultWindow: ProviderAvailabilityWindow;
+    windowOpen(now: Date, window?: ProviderAvailabilityWindow): boolean;
+    limitedProvider: string;
+    outsideWindow(window: ProviderAvailabilityWindow): string;
+    closedWindow(phase: 'adjudication' | 'teacher'): string;
+    extractorMessage: string;
+}
+export interface GraderProviderRegistry {
+    providers: readonly GraderProviderDescriptor[];
+    council: CouncilProviderPolicy;
+}
+/** Composition supplies provider data before loading authored grader files. */
+export declare function configureGraderProviders(registry: GraderProviderRegistry): void;
+export declare function graderProviderRegistry(): GraderProviderRegistry;
+export declare function graderProvider(id: string): GraderProviderDescriptor;

package/dist/training/contracts/grader-providers.js

@@ -0,0 +1,27 @@
+let configured;
+/** Composition supplies provider data before loading authored grader files. */
+export function configureGraderProviders(registry) {
+    const ids = registry.providers.map(provider => provider.id);
+    if (new Set(ids).size !== ids.length)
+        throw new Error('Duplicate grader provider');
+    if (configured && configured !== registry)
+        throw new Error('Grader provider registry is already configured');
+    registry.providers.forEach(Object.freeze);
+    Object.freeze(registry.providers);
+    Object.freeze(registry.council.requiredProviders);
+    Object.freeze(registry.council.defaultWindow);
+    Object.freeze(registry.council);
+    configured = Object.freeze(registry);
+}
+export function graderProviderRegistry() {
+    if (!configured)
+        throw new Error('Grader provider registry is not configured');
+    return configured;
+}
+export function graderProvider(id) {
+    const provider = graderProviderRegistry().providers.find(provider => provider.id === id);
+    if (!provider)
+        throw new Error(`Unsupported grader provider ${id}`);
+    return provider;
+}
+//# sourceMappingURL=grader-providers.js.map

package/dist/training/contracts/grader-providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grader-providers.js","sourceRoot":"","sources":["../../../src/training/contracts/grader-providers.ts"],"names":[],"mappings":"AA4BA,IAAI,UAA8C,CAAC;AACnD,+EAA+E;AAC/E,MAAM,UAAU,wBAAwB,CAAC,QAAgC;IACvE,MAAM,GAAG,GAAG,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC5D,IAAI,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IACnF,IAAI,UAAU,IAAI,UAAU,KAAK,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IAC7G,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC1C,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAClC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAClD,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAC9C,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAChC,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AACvC,CAAC;AACD,MAAM,UAAU,sBAAsB;IACpC,IAAI,CAAC,UAAU;QAAE,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAC/E,OAAO,UAAU,CAAC;AACpB,CAAC;AACD,MAAM,UAAU,cAAc,CAAC,EAAU;IACvC,MAAM,QAAQ,GAAG,sBAAsB,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACzF,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,EAAE,EAAE,CAAC,CAAC;IACpE,OAAO,QAAQ,CAAC;AAClB,CAAC"}

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

@@ -0,0 +1,74 @@
+import type { JudgeCall } from './evaluation.js';
+/** Runtime-neutral option scoring; expectedOptions is bounds metadata, never prompt data. */
+export interface DecisionRequest {
+    key: string;
+    type: 'yes-no' | 'noul' | 'choice' | 'score';
+    optionLabels: readonly (string | number)[];
+    expectedOptions?: readonly (string | number)[];
+    instructions: string;
+    system?: string;
+    projection: Record<string, unknown>;
+}
+export interface DecisionResult {
+    key: string;
+    probabilities: Record<string, number> | null;
+    status: 'ok' | 'missing';
+    reason?: string;
+    /** Infrastructure refusal, distinct from missing behavioral evidence. */
+    failureCause?: 'spend-cap' | 'request-rejected';
+    bounded?: boolean;
+    /** Provider probabilities have approximately 0.01 resolution, even when their sum is one. */
+    providerRounded?: boolean;
+    teacherAnswered?: boolean;
+    /** Actual subscription attempts, absent for local option scorers. */
+    judgeCalls?: JudgeCall[];
+}
+export interface DecisionIdentity {
+    backend: string;
+    model: string;
+    digest?: string;
+    fingerprint?: string;
+    endpoint?: string;
+}
+export interface DecisionSpendBudget {
+    maxUsd?: number;
+    spentUsd: number;
+    reservedUsd: number;
+}
+export interface DecisionRequestReceipt {
+    /** Originating dispatched attempt; retained across references and repairs. Absent in legacy captures. */
+    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;
+}
+export interface DecisionAccounting {
+    billing: 'api';
+    requests: number;
+    inputTokens: number | null;
+    outputTokens: number | null;
+    usd: number | null;
+    latencyMs: {
+        p50: number | null;
+        p95: number | null;
+    };
+    receipts: DecisionRequestReceipt[];
+}
+export interface DecisionBackend {
+    capabilities?: {
+        billing: 'local' | 'subscription' | 'api';
+        batch?: boolean;
+    };
+    /** Diagnostic history only; never use for invocation accounting. */
+    requestReceipts?(): DecisionRequestReceipt[];
+    /** Append only this call's dispatched receipts, including failures, before settling. */
+    identity(signal?: AbortSignal, receipts?: DecisionRequestReceipt[]): Promise<DecisionIdentity>;
+    score(requests: DecisionRequest[], signal?: AbortSignal, receipts?: DecisionRequestReceipt[]): Promise<DecisionResult[]>;
+}

package/dist/training/contracts/grading.js

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

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

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

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

@@ -0,0 +1,16 @@
+export { legacyWireAliases, canonicalWireId, compatibleWireLiteral, wireIdMatches, hasLegacyTrainingDistribution } from '../../shared/trainingLegacy/index.js';
+export { EVIDENCE_UNITS_DIGEST_SCHEMA, EXTRACTION_CHECKPOINT_DOMAIN, TRAP_CHECKPOINT_DOMAIN, JUDGMENT_CACHE_DOMAIN, GRADER_CACHE_PROMPT_DOMAIN, GRADER_CACHE_LEGACY_DIRECTORY, DECOMPOSITION_DIGEST_SCHEMA, CHECK_TEMPLATES_DIGEST_SCHEMA } from '../../shared/trainingLegacy/index.js';
+export { LEGACY_MEASUREMENT_COMPATIBILITY_VERSION, LEGACY_INFERENCE_VERSION_PREFIX, AUTHORED_JUDGE_VERSION_PREFIX, OPTIMIZER_ROUTE_PREFIX, INFERENCE_POLICY_VERSIONS, LABEL_PROMPT_VERSION, ADJUDICATION_SEED, COUNCIL_PROMPT_VERSION, COUNCIL_SEED, GRADING_POLICY_VERSION, CANDIDATE_DIGEST_SCHEMA, DATASET_DIGEST_SCHEMA, LABELS_DIGEST_SCHEMA, CALIBRATION_DIGEST_SCHEMA, COMMAND_EXECUTION_DOMAIN, COMPARISON_CHECKPOINT_DOMAIN, JEV_IDENTITY_KEY, JEV_IDENTITY_LONG_KEY, JEV_CANARY_MARKER, JEV_CANARY_QUESTION } from '../../shared/trainingLegacy/index.js';
+export type * from './dataset.js';
+export type * from './training-config.js';
+export type * from './execution.js';
+export type * from './evaluation.js';
+export { judgeFailureCauses } from './evaluation.js';
+export { inferenceFailureDetails } from './execution.js';
+export type * from './inference-grants.js';
+export type * from './grading.js';
+export type { AtomicFeedback } from './atomic-feedback.js';
+export type { TrialSlot } from "./trial-slot.js";
+export type * from './inference-registry.js';
+export { inferenceProviderDescriptor } from './inference-registry.js';
+export * from './grader-providers.js';

package/dist/training/contracts/index.js

@@ -0,0 +1,8 @@
+export { legacyWireAliases, canonicalWireId, compatibleWireLiteral, wireIdMatches, hasLegacyTrainingDistribution } from '../../shared/trainingLegacy/index.js';
+export { EVIDENCE_UNITS_DIGEST_SCHEMA, EXTRACTION_CHECKPOINT_DOMAIN, TRAP_CHECKPOINT_DOMAIN, JUDGMENT_CACHE_DOMAIN, GRADER_CACHE_PROMPT_DOMAIN, GRADER_CACHE_LEGACY_DIRECTORY, DECOMPOSITION_DIGEST_SCHEMA, CHECK_TEMPLATES_DIGEST_SCHEMA } from '../../shared/trainingLegacy/index.js';
+export { LEGACY_MEASUREMENT_COMPATIBILITY_VERSION, LEGACY_INFERENCE_VERSION_PREFIX, AUTHORED_JUDGE_VERSION_PREFIX, OPTIMIZER_ROUTE_PREFIX, INFERENCE_POLICY_VERSIONS, LABEL_PROMPT_VERSION, ADJUDICATION_SEED, COUNCIL_PROMPT_VERSION, COUNCIL_SEED, GRADING_POLICY_VERSION, CANDIDATE_DIGEST_SCHEMA, DATASET_DIGEST_SCHEMA, LABELS_DIGEST_SCHEMA, CALIBRATION_DIGEST_SCHEMA, COMMAND_EXECUTION_DOMAIN, COMPARISON_CHECKPOINT_DOMAIN, JEV_IDENTITY_KEY, JEV_IDENTITY_LONG_KEY, JEV_CANARY_MARKER, JEV_CANARY_QUESTION } from '../../shared/trainingLegacy/index.js';
+export { judgeFailureCauses } from './evaluation.js';
+export { inferenceFailureDetails } from './execution.js';
+export { inferenceProviderDescriptor } from './inference-registry.js';
+export * from './grader-providers.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/training/contracts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,qBAAqB,EAAE,aAAa,EAAE,6BAA6B,EAAE,MAAM,sCAAsC,CAAC;AAC/J,OAAO,EAAE,4BAA4B,EAAE,4BAA4B,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,6BAA6B,EAAE,2BAA2B,EAAE,6BAA6B,EAAE,MAAM,sCAAsC,CAAC;AACxR,OAAO,EAAE,wCAAwC,EAAE,+BAA+B,EAAE,6BAA6B,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,YAAY,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,4BAA4B,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAKpiB,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AASzD,OAAO,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAEtE,cAAc,uBAAuB,CAAC"}

package/dist/training/contracts/inference-grants.d.ts

@@ -0,0 +1,34 @@
+/** A host lends a bounded credential capability without exposing its native login. */
+export interface InferenceGrant {
+    grantId: string;
+    token: string;
+    baseUrl: string;
+    model: string;
+    reasoningEffort: 'low' | 'medium' | 'high';
+    purpose: 'judge' | 'optimizer';
+    expiresAt: string;
+    limits: {
+        maxRequests: number;
+        maxTokens: number;
+        timeoutMs: number;
+    };
+}
+export interface InferenceClientConfigInput {
+    baseUrl: string;
+    model: string;
+    reasoningEffort: 'low' | 'medium' | 'high';
+    envKey: string;
+}
+export interface InferenceGrantAuthority {
+    readonly clientModelId: string;
+    readonly envKey: string;
+    readonly maxLiveGrants: number;
+    request(input: {
+        model: string;
+        reasoningEffort: 'low' | 'medium' | 'high';
+        purpose: 'judge' | 'optimizer';
+    }): Promise<InferenceGrant>;
+    release(grantId: string): Promise<boolean>;
+    renderClientConfig(input: InferenceClientConfigInput): string;
+    pinnedClientConfigSha256(model: string, reasoningEffort: 'low' | 'medium' | 'high'): string | undefined;
+}

package/dist/training/contracts/inference-grants.js

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

package/dist/training/contracts/inference-grants.js.map

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

package/dist/training/contracts/inference-registry.d.ts

@@ -0,0 +1,38 @@
+import type { InferenceProvider } from './execution.js';
+import type { TrainingModel } from './training-config.js';
+/** One command shares resources and awaits registered cleanup on every exit. */
+export interface InferenceProviderFactoryContext {
+    timeoutMs: number;
+    purpose: 'judge' | 'optimizer';
+    resources: Map<string, unknown>;
+    onClose(callback: () => Promise<void>): void;
+}
+/** Registration is data and validation; factories run only after preflight. */
+export interface InferenceProviderDescriptor {
+    policyVersion: string;
+    /** Historical default-judge identity, when distinct from the invocation policy. */
+    legacyJudgeVersion?: string;
+    validate(model: Readonly<Record<string, unknown>>, path: string): void;
+    normalizeIdentity?(model: TrainingModel): TrainingModel;
+    capabilities: {
+        purposeScoped?: boolean;
+        brokerAdmission?: boolean;
+        evaluatorPurposes?: readonly string[];
+        evaluatorBudget?: 'requests' | 'usd';
+    };
+    incompatibleWith?: readonly string[];
+    incompatibilityReason?: string;
+    create(model: TrainingModel, context: InferenceProviderFactoryContext): InferenceProvider;
+}
+/** Runtime composition supplies all available provider implementations. */
+export interface InferenceProviderRegistry {
+    providers: Readonly<Record<string, InferenceProviderDescriptor>>;
+    defaultProviderId: string;
+    brokerAdmissionLabel?: string;
+    /** Dedicated decision services share admission without pretending to generate text. */
+    evaluatorProviders?: Readonly<Record<string, {
+        purposes: readonly string[];
+        budget: 'requests' | 'usd';
+    }>>;
+}
+export declare function inferenceProviderDescriptor(registry: InferenceProviderRegistry, id: string): InferenceProviderDescriptor;

package/dist/training/contracts/inference-registry.js

@@ -0,0 +1,7 @@
+export function inferenceProviderDescriptor(registry, id) {
+    const descriptor = Object.hasOwn(registry.providers, id) ? registry.providers[id] : undefined;
+    if (!descriptor)
+        throw new Error(`Unknown inference provider ${id}`);
+    return descriptor;
+}
+//# sourceMappingURL=inference-registry.js.map

package/dist/training/contracts/inference-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inference-registry.js","sourceRoot":"","sources":["../../../src/training/contracts/inference-registry.ts"],"names":[],"mappings":"AAsCA,MAAM,UAAU,2BAA2B,CAAC,QAAmC,EAAE,EAAU;IACzF,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC9F,IAAI,CAAC,UAAU;QAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,EAAE,EAAE,CAAC,CAAC;IACrE,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/training/contracts/training-config.d.ts

@@ -0,0 +1,95 @@
+/** Authored controls live in the dataset, never in the subject workspace. */
+export interface TrainingModel {
+    /** Registered inference provider identifier, supplied by host composition. */
+    provider: string;
+    model: string;
+    endpoint?: string;
+    /** Provider-specific reasoning control; validated by its descriptor. */
+    reasoning_effort?: 'low' | 'medium' | 'high' | 'xhigh';
+    /** Native Ollama controls; other providers must reject these fields. */
+    think?: boolean;
+    keep_alive_seconds?: number;
+    max_output_tokens?: number;
+    context_window?: number;
+}
+export interface TrainingRoute {
+    model: string;
+    fallbacks?: string[];
+    attempts?: number;
+    timeout_ms?: number;
+}
+export interface TrainingProposalPolicy {
+    strategy?: 'refine' | 'rewrite';
+    min_change?: number;
+    rewrite_share?: number;
+    hypothesis_similarity?: number;
+    max_attempts?: number;
+    history_entries?: number;
+    history_bytes?: number;
+}
+export interface TrainingOptimizer extends TrainingRoute {
+    method?: 'gepa';
+    variants?: number;
+    keep?: number;
+    budget?: {
+        rounds: number;
+    };
+    selection?: 'pareto' | 'top-k';
+    boundaries?: string[];
+    patience?: number;
+    proposal?: TrainingProposalPolicy;
+}
+export interface TrainingJudge extends TrainingRoute {
+    protocol?: 'citations' | 'evidence-ids';
+    template?: {
+        language: 'jinja';
+        text: string;
+    };
+    citation_repairs?: 0 | 1;
+}
+export interface TrainingComparison {
+    candidate: {
+        name: string;
+        replacements: {
+            resource: string;
+            source: string;
+        }[];
+    };
+}
+export interface TrainingScoring {
+    /** Closed deferred deliveries remain failures; optionally retain measured stage reward. */
+    deferred?: 'zero' | 'stage-score';
+}
+export interface TrainingConfiguration {
+    scoring?: TrainingScoring;
+    comparison?: TrainingComparison;
+    models: Record<string, TrainingModel>;
+    judges?: Record<string, TrainingJudge>;
+    optimizer?: TrainingOptimizer;
+    budget?: {
+        trial_retries?: number;
+        test_repeats?: number;
+        max_trials?: number;
+        max_proposals?: number;
+        timeout_ms?: number;
+        experiment_timeout_ms?: number;
+        trial_timeout_ms?: number;
+    };
+    cache?: {
+        mode: 'off' | 'exact' | 'persistent';
+        max_entries?: number;
+        namespace?: string;
+        directory?: string;
+    };
+    recovery?: {
+        max_attempts?: number;
+    };
+    test?: string;
+    validation?: string;
+    validation_groups?: string[];
+    seed?: number;
+}
+/** Independent sealed native trials per candidate/case; omitted preserves one pass. */
+export declare function testRepeatCount(value?: number): number;
+/** Fresh replacements for infrastructure-failed native trials only. */
+export declare function trialRetryCount(value?: number): number;

package/dist/training/contracts/training-config.js

@@ -0,0 +1,15 @@
+/** Independent sealed native trials per candidate/case; omitted preserves one pass. */
+export function testRepeatCount(value = 1) {
+    if (!Number.isSafeInteger(value) || value < 1 || value > 8) {
+        throw new Error('training.budget.test_repeats must be an integer from 1 to 8');
+    }
+    return value;
+}
+/** Fresh replacements for infrastructure-failed native trials only. */
+export function trialRetryCount(value = 0) {
+    if (!Number.isSafeInteger(value) || value < 0 || value > 3) {
+        throw new Error('training.budget.trial_retries must be an integer from 0 to 3');
+    }
+    return value;
+}
+//# sourceMappingURL=training-config.js.map

package/dist/training/contracts/training-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"training-config.js","sourceRoot":"","sources":["../../../src/training/contracts/training-config.ts"],"names":[],"mappings":"AAmEA,uFAAuF;AACvF,MAAM,UAAU,eAAe,CAAC,QAAgB,CAAC;IAC/C,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;IACjF,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,eAAe,CAAC,QAAgB,CAAC;IAC/C,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/training/contracts/trial-slot.d.ts

@@ -0,0 +1,12 @@
+/** Provisioner-owned isolated resources, opaque to experiment policy. */
+export interface TrialSlot {
+    /** v2 native slots share the container uid; v1 retains distinct worker identities. */
+    isolation?: 'shared-uid';
+    index: number;
+    workerUid: number;
+    roots: Readonly<Record<string, string>>;
+    ports: {
+        base: number;
+        count: number;
+    };
+}

package/dist/training/contracts/trial-slot.js

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

package/dist/training/contracts/trial-slot.js.map

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

package/dist/training/dspy/AGENTS.md

@@ -0,0 +1,29 @@
+# DSPy Bridge
+
+Owns the minimal Python boundary to released DSPy 3.3.1 and GEPA 0.1.4.
+
+- Receive versioned candidate components, case references and evaluation feedback
+  from the TypeScript owner. Do not reimplement the native subject's cognition.
+- Use explicit subscription-backed inference supplied through Training; bind every
+  enabled DSPy reflection, proposal and judge route without paid API fallback.
+- Pin the released DSPy integration seam and test it; upstream main inspection is
+  feasibility evidence, not proof the installed version behaves the same way.
+- Preserve locked resources and split restrictions. Do not expose sealed-test
+  feedback or credentials to optimization requests.
+- Tests belong beside Python source and need a language-appropriate coverage gate.
+  First acceptance must show the changed candidate reaches a real native subject.
+- `protocol.md` specifies the JSONL host contract. `spawnfile_training_dspy/` owns the
+  process and tests; the root README contains reproducible installation/checks.
+- `requirements.lock` pins the exercised dependency closure. A dependency upgrade
+  requires the real optimizer conformance test, not source inspection alone.
+- Simulated-host tests run actual DSPy optimization and verify changed multi-file
+  bundles reach callbacks. They do not establish real native-agent acceptance.
+
+- Optional authored population search lives beside legacy GEPA in `search/` under
+  the process package. Planning and realization use only declared boundaries and
+  train evidence; no implicit role/interface preservation prompt. Follow exact
+  defaults and resume limits in README/protocol. P6 concurrency is a separate owner.
+
+The evaluate protocol carries optional nonnegative round attribution. Current
+bridge callbacks always emit actual GEPA/population round IDs; legacy omission
+remains explicit and older interrupted journals require their original bridge.