@gestaltrun/dsh-agent-eval 0.0.0-stage → 0.1.1

package/lib/types/script-production.d.ts

@@ -0,0 +1,955 @@
+import type { MerchantIdentityCapture } from '@gestaltrun/dsh-merchant-account';
+import type { Context } from '@deepseek-ai/cordis';
+import { z } from 'zod';
+import { type CaseDataCollectionSummary } from '@gestaltrun/dsh-cs-hosting/case-data';
+import { type SalesCase, type SalesCoverageResult } from '@gestaltrun/dsh-cs-hosting/sales-case-contract';
+import type { ProductionWork } from './production-budget.ts';
+import type { CsHostingEvaluationProduction, CsHostingPrepareCounts } from '@gestaltrun/dsh-cs-hosting/types';
+import type { ProductionWindow } from './production-buyers.ts';
+/** Explicit operator release; unconfirmed versions may remain unused on the server. */
+export declare const ScriptRecoveryRequest: z.ZodObject<{
+    operationId: z.ZodUUID;
+    setId: z.ZodUUID;
+    unconfirmedScriptKeys: z.ZodArray<z.ZodUUID>;
+    invalidScriptVersionIds: z.ZodArray<z.ZodUUID>;
+    reason: z.ZodString;
+}, z.core.$strict>;
+declare const InvalidScript: z.ZodObject<{
+    caseId: z.ZodUUID;
+    scriptKey: z.ZodUUID;
+    scriptVersionId: z.ZodUUID;
+    reason: z.ZodString;
+}, z.core.$strict>;
+/** Legacy unscoped sets use this server default; shorter previews rediscover buyers before production. */
+export declare const SERVER_COVERAGE_LOOKBACK_DAYS = 180;
+/**
+ * Require each selection, or one of its same-group alternates, to be submitted and inside the window.
+ * A larger case revision is current when the case segment message keys still match the feature material.
+ * @param ctx - Tenant-bound merchant reader.
+ * @param coverage - Immutable set whose selected inputs will be used.
+ * @param window - Admitted last-message window.
+ * @param signal - Run or preview lifetime.
+ */
+export declare function verifyCoverageScope(ctx: Context, coverage: z.infer<typeof SalesCoverageResult>, window: ProductionWindow, signal: AbortSignal): Promise<void>;
+/** Validated deployment choices for production workers and server polling. */
+export interface ProductionConfig {
+    readonly taskConcurrency: number;
+    /** Concurrent script authors. Independent of case-data workers. */
+    readonly scriptConcurrency: number;
+    readonly pollIntervalMs: number;
+    readonly jobTimeoutMs: number;
+    readonly revisionRetries: number;
+    /** Additional attempts for transient case-page reads; defaults to 3. */
+    readonly caseReadRetries?: number;
+    /** First exponential retry delay; defaults to 1000 ms. */
+    readonly caseReadRetryInitialMs?: number;
+    /** Retry-delay ceiling; defaults to 10000 ms. */
+    readonly caseReadRetryMaxMs?: number;
+}
+/** Stages that admit model work against the shop quota. */
+export type ProductionBudgetStage = 'coverage' | 'case_data' | 'scripts';
+/** Production-owned operations whose successful results can be resumed without another model call. */
+export interface ProductionOperations {
+    /** @param signal - Shop/run lifetime. @param window - Fixed production range, if supplied. @returns All distinct buyers in the server's formal-message range. */
+    buyers(signal: AbortSignal, window?: ProductionWindow): Promise<readonly string[]>;
+    /** Rejects with SupplyCaptureError when write certainty is known; other errors retain an unknown outcome. @param signal - Shop/run lifetime. @returns Submitted supply revision and notice read counts. */
+    captureSupply(signal: AbortSignal): Promise<{
+        readonly revision: number;
+        readonly noticeReadFailures: number;
+        readonly noticeTruncations: number;
+        readonly products?: number;
+        readonly destinations?: number;
+    }>;
+    /** @param row - Current server revision. @param signal - Task lifetime. @returns Revision acknowledged by the submission tool. */
+    collect(row: z.infer<typeof SalesCase>, signal: AbortSignal): Promise<number>;
+    /** @param caseId - Collected demand line. @returns Submitted-data counts, absent for historical checkpoints. */
+    collectionSummary?(caseId: string): CaseDataCollectionSummary | undefined;
+    /** True when author calls beforeSubmit durably before its first server write. */
+    readonly checkpointsScriptSubmission?: boolean;
+    /** @param set - Immutable selected material. @param scriptKey - Missing slot. @param signal - Task lifetime. @param beforeSubmit - Durable write intent, required before a server submission when supported. @returns Submitted immutable version UUID. */
+    author(set: z.infer<typeof SalesCoverageResult>, scriptKey: string, signal: AbortSignal, beforeSubmit: () => Promise<void>): Promise<string>;
+    /** @param work - Remaining model tasks. @param signal - Request lifetime. @param stage - Requesting stage; quota refusals carry it as the failure stage. @returns Affordable new script/evaluation pairs after this work; rejects insufficient quota. */
+    budget(work: ProductionWork, signal: AbortSignal, stage: ProductionBudgetStage): Promise<number>;
+    /** @param signal - Read lifetime. @returns Untrusted durable checkpoint, or null on first start. */
+    load(signal: AbortSignal): Promise<unknown>;
+    /** @param value - Validated checkpoint. @param signal - Write lifetime. */
+    save(value: ProductionCheckpoint, signal: AbortSignal): Promise<void>;
+    /** Discard retained case replay when a deleted server reference invalidates the batch. */
+    resetRetained?(): void;
+}
+declare const Checkpoint: z.ZodPipe<z.ZodUnion<readonly [z.ZodObject<{
+    substitutions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    collectionRestart: z.ZodOptional<z.ZodObject<{
+        operationId: z.ZodUUID;
+        actorUserId: z.ZodString;
+        startedAt: z.ZodISODateTime;
+        previousSetId: z.ZodNullable<z.ZodUUID>;
+        previousCaseIds: z.ZodArray<z.ZodUUID>;
+        setId: z.ZodOptional<z.ZodUUID>;
+        version: z.ZodOptional<z.ZodNumber>;
+        supplyRevision: z.ZodOptional<z.ZodNumber>;
+        selectionDifference: z.ZodOptional<z.ZodObject<{
+            same: z.ZodNumber;
+            added: z.ZodNumber;
+            removed: z.ZodNumber;
+        }, z.core.$strict>>;
+        events: z.ZodArray<z.ZodObject<{
+            stage: z.ZodEnum<{
+                prescreen: "prescreen";
+                coverage: "coverage";
+                scripts: "scripts";
+                reuse: "reuse";
+                aggregation: "aggregation";
+                case_data: "case_data";
+                evaluation: "evaluation";
+                report: "report";
+            }>;
+            at: z.ZodISODateTime;
+            status: z.ZodEnum<{
+                failed: "failed";
+                completed: "completed";
+                started: "started";
+            }>;
+            code: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        endedAt: z.ZodOptional<z.ZodISODateTime>;
+    }, z.core.$strict>>;
+    collectionRestartHistory: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        operationId: z.ZodUUID;
+        actorUserId: z.ZodString;
+        startedAt: z.ZodISODateTime;
+        previousSetId: z.ZodNullable<z.ZodUUID>;
+        previousCaseIds: z.ZodArray<z.ZodUUID>;
+        setId: z.ZodOptional<z.ZodUUID>;
+        version: z.ZodOptional<z.ZodNumber>;
+        supplyRevision: z.ZodOptional<z.ZodNumber>;
+        selectionDifference: z.ZodOptional<z.ZodObject<{
+            same: z.ZodNumber;
+            added: z.ZodNumber;
+            removed: z.ZodNumber;
+        }, z.core.$strict>>;
+        events: z.ZodArray<z.ZodObject<{
+            stage: z.ZodEnum<{
+                prescreen: "prescreen";
+                coverage: "coverage";
+                scripts: "scripts";
+                reuse: "reuse";
+                aggregation: "aggregation";
+                case_data: "case_data";
+                evaluation: "evaluation";
+                report: "report";
+            }>;
+            at: z.ZodISODateTime;
+            status: z.ZodEnum<{
+                failed: "failed";
+                completed: "completed";
+                started: "started";
+            }>;
+            code: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        endedAt: z.ZodOptional<z.ZodISODateTime>;
+    }, z.core.$strict>>>;
+    restartSubmittedCaseIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    supplyRevision: z.ZodNullable<z.ZodNumber>;
+    supplyDestinationExtractionVersion: z.ZodOptional<z.ZodNumber>;
+    buyers: z.ZodNullable<z.ZodArray<z.ZodString>>;
+    aggregations: z.ZodRecord<z.ZodString, z.ZodObject<{
+        jobId: z.ZodUUID;
+        status: z.ZodString;
+        attempts: z.ZodNumber;
+        errorCode: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    completed: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    coverageJob: z.ZodNullable<z.ZodObject<{
+        jobId: z.ZodUUID;
+        status: z.ZodString;
+        attempts: z.ZodNumber;
+        errorCode: z.ZodNullable<z.ZodString>;
+        setId: z.ZodNullable<z.ZodUUID>;
+    }, z.core.$strip>>;
+    setId: z.ZodNullable<z.ZodUUID>;
+    scripts: z.ZodRecord<z.ZodString, z.ZodUUID>;
+    uncertain: z.ZodNullable<z.ZodEnum<{
+        script: "script";
+        coverage: "coverage";
+        supply: "supply";
+        aggregation: "aggregation";
+        prescreen: "prescreen";
+    }>>;
+    unconfirmedScriptKeys: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    scriptRecoveries: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        operationId: z.ZodUUID;
+        setId: z.ZodUUID;
+        unconfirmedScriptKeys: z.ZodArray<z.ZodUUID>;
+        invalidScriptVersionIds: z.ZodArray<z.ZodUUID>;
+        reason: z.ZodString;
+        actorUserId: z.ZodString;
+        at: z.ZodISODateTime;
+        invalidScripts: z.ZodArray<z.ZodObject<{
+            caseId: z.ZodUUID;
+            scriptKey: z.ZodUUID;
+            scriptVersionId: z.ZodUUID;
+            reason: z.ZodString;
+        }, z.core.$strict>>;
+        orphanedVersionsPossible: z.ZodLiteral<true>;
+    }, z.core.$strict>>>;
+    dataFailures: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        code: z.ZodString;
+        attempts: z.ZodNumber;
+        revision: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>>;
+    dataCollection: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        records: z.ZodNumber;
+        gapCount: z.ZodNumber;
+        gapReasons: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        inventoryEstimates: z.ZodNumber;
+    }, z.core.$strip>>>;
+    retryReleases: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        operationId: z.ZodUUID;
+        actorUserId: z.ZodString;
+        at: z.ZodISODateTime;
+        cases: z.ZodArray<z.ZodObject<{
+            caseId: z.ZodUUID;
+            revision: z.ZodNumber;
+            previousCode: z.ZodString;
+        }, z.core.$strict>>;
+        scripts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            scriptKey: z.ZodString;
+            previousCode: z.ZodString;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>>;
+    scriptFailures: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        code: z.ZodString;
+        attempts: z.ZodNumber;
+        revision: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>>;
+    prescreenJob: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        jobId: z.ZodUUID;
+        status: z.ZodString;
+        attempts: z.ZodNumber;
+        errorCode: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>>;
+    skippedPrescreen: z.ZodOptional<z.ZodNumber>;
+    supplyProducts: z.ZodOptional<z.ZodNumber>;
+    supplyDestinations: z.ZodOptional<z.ZodNumber>;
+    threadCount: z.ZodOptional<z.ZodNumber>;
+    passedCount: z.ZodOptional<z.ZodNumber>;
+    window: z.ZodOptional<z.ZodObject<{
+        from: z.ZodISODateTime;
+        to: z.ZodISODateTime;
+    }, z.core.$strip>>;
+    skippedOutsideWindow: z.ZodOptional<z.ZodNumber>;
+    noticeReadFailures: z.ZodOptional<z.ZodNumber>;
+    noticeTruncations: z.ZodOptional<z.ZodNumber>;
+    version: z.ZodLiteral<2>;
+}, z.core.$strict>, z.ZodObject<{
+    collectionRestart: z.ZodOptional<z.ZodObject<{
+        operationId: z.ZodUUID;
+        actorUserId: z.ZodString;
+        startedAt: z.ZodISODateTime;
+        previousSetId: z.ZodNullable<z.ZodUUID>;
+        previousCaseIds: z.ZodArray<z.ZodUUID>;
+        setId: z.ZodOptional<z.ZodUUID>;
+        version: z.ZodOptional<z.ZodNumber>;
+        supplyRevision: z.ZodOptional<z.ZodNumber>;
+        selectionDifference: z.ZodOptional<z.ZodObject<{
+            same: z.ZodNumber;
+            added: z.ZodNumber;
+            removed: z.ZodNumber;
+        }, z.core.$strict>>;
+        events: z.ZodArray<z.ZodObject<{
+            stage: z.ZodEnum<{
+                prescreen: "prescreen";
+                coverage: "coverage";
+                scripts: "scripts";
+                reuse: "reuse";
+                aggregation: "aggregation";
+                case_data: "case_data";
+                evaluation: "evaluation";
+                report: "report";
+            }>;
+            at: z.ZodISODateTime;
+            status: z.ZodEnum<{
+                failed: "failed";
+                completed: "completed";
+                started: "started";
+            }>;
+            code: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        endedAt: z.ZodOptional<z.ZodISODateTime>;
+    }, z.core.$strict>>;
+    collectionRestartHistory: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        operationId: z.ZodUUID;
+        actorUserId: z.ZodString;
+        startedAt: z.ZodISODateTime;
+        previousSetId: z.ZodNullable<z.ZodUUID>;
+        previousCaseIds: z.ZodArray<z.ZodUUID>;
+        setId: z.ZodOptional<z.ZodUUID>;
+        version: z.ZodOptional<z.ZodNumber>;
+        supplyRevision: z.ZodOptional<z.ZodNumber>;
+        selectionDifference: z.ZodOptional<z.ZodObject<{
+            same: z.ZodNumber;
+            added: z.ZodNumber;
+            removed: z.ZodNumber;
+        }, z.core.$strict>>;
+        events: z.ZodArray<z.ZodObject<{
+            stage: z.ZodEnum<{
+                prescreen: "prescreen";
+                coverage: "coverage";
+                scripts: "scripts";
+                reuse: "reuse";
+                aggregation: "aggregation";
+                case_data: "case_data";
+                evaluation: "evaluation";
+                report: "report";
+            }>;
+            at: z.ZodISODateTime;
+            status: z.ZodEnum<{
+                failed: "failed";
+                completed: "completed";
+                started: "started";
+            }>;
+            code: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        endedAt: z.ZodOptional<z.ZodISODateTime>;
+    }, z.core.$strict>>>;
+    restartSubmittedCaseIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    supplyRevision: z.ZodNullable<z.ZodNumber>;
+    supplyDestinationExtractionVersion: z.ZodOptional<z.ZodNumber>;
+    buyers: z.ZodNullable<z.ZodArray<z.ZodString>>;
+    aggregations: z.ZodRecord<z.ZodString, z.ZodObject<{
+        jobId: z.ZodUUID;
+        status: z.ZodString;
+        attempts: z.ZodNumber;
+        errorCode: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    completed: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    coverageJob: z.ZodNullable<z.ZodObject<{
+        jobId: z.ZodUUID;
+        status: z.ZodString;
+        attempts: z.ZodNumber;
+        errorCode: z.ZodNullable<z.ZodString>;
+        setId: z.ZodNullable<z.ZodUUID>;
+    }, z.core.$strip>>;
+    setId: z.ZodNullable<z.ZodUUID>;
+    scripts: z.ZodRecord<z.ZodString, z.ZodUUID>;
+    uncertain: z.ZodNullable<z.ZodEnum<{
+        script: "script";
+        coverage: "coverage";
+        supply: "supply";
+        aggregation: "aggregation";
+        prescreen: "prescreen";
+    }>>;
+    unconfirmedScriptKeys: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    scriptRecoveries: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        operationId: z.ZodUUID;
+        setId: z.ZodUUID;
+        unconfirmedScriptKeys: z.ZodArray<z.ZodUUID>;
+        invalidScriptVersionIds: z.ZodArray<z.ZodUUID>;
+        reason: z.ZodString;
+        actorUserId: z.ZodString;
+        at: z.ZodISODateTime;
+        invalidScripts: z.ZodArray<z.ZodObject<{
+            caseId: z.ZodUUID;
+            scriptKey: z.ZodUUID;
+            scriptVersionId: z.ZodUUID;
+            reason: z.ZodString;
+        }, z.core.$strict>>;
+        orphanedVersionsPossible: z.ZodLiteral<true>;
+    }, z.core.$strict>>>;
+    dataFailures: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        code: z.ZodString;
+        attempts: z.ZodNumber;
+        revision: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>>;
+    dataCollection: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        records: z.ZodNumber;
+        gapCount: z.ZodNumber;
+        gapReasons: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        inventoryEstimates: z.ZodNumber;
+    }, z.core.$strip>>>;
+    retryReleases: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        operationId: z.ZodUUID;
+        actorUserId: z.ZodString;
+        at: z.ZodISODateTime;
+        cases: z.ZodArray<z.ZodObject<{
+            caseId: z.ZodUUID;
+            revision: z.ZodNumber;
+            previousCode: z.ZodString;
+        }, z.core.$strict>>;
+        scripts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            scriptKey: z.ZodString;
+            previousCode: z.ZodString;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>>;
+    scriptFailures: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        code: z.ZodString;
+        attempts: z.ZodNumber;
+        revision: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>>;
+    prescreenJob: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        jobId: z.ZodUUID;
+        status: z.ZodString;
+        attempts: z.ZodNumber;
+        errorCode: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>>;
+    skippedPrescreen: z.ZodOptional<z.ZodNumber>;
+    supplyProducts: z.ZodOptional<z.ZodNumber>;
+    supplyDestinations: z.ZodOptional<z.ZodNumber>;
+    threadCount: z.ZodOptional<z.ZodNumber>;
+    passedCount: z.ZodOptional<z.ZodNumber>;
+    window: z.ZodOptional<z.ZodObject<{
+        from: z.ZodISODateTime;
+        to: z.ZodISODateTime;
+    }, z.core.$strip>>;
+    skippedOutsideWindow: z.ZodOptional<z.ZodNumber>;
+    noticeReadFailures: z.ZodOptional<z.ZodNumber>;
+    noticeTruncations: z.ZodOptional<z.ZodNumber>;
+    version: z.ZodLiteral<1>;
+}, z.core.$strict>]>, z.ZodTransform<{
+    supplyRevision: number | null;
+    buyers: string[] | null;
+    aggregations: Record<string, {
+        jobId: string;
+        status: string;
+        attempts: number;
+        errorCode: string | null;
+    }>;
+    completed: Record<string, number>;
+    coverageJob: {
+        jobId: string;
+        status: string;
+        attempts: number;
+        errorCode: string | null;
+        setId: string | null;
+    } | null;
+    setId: string | null;
+    scripts: Record<string, string>;
+    uncertain: "script" | "coverage" | "supply" | "aggregation" | "prescreen" | null;
+    version: 2;
+    substitutions?: Record<string, string> | undefined;
+    collectionRestart?: {
+        operationId: string;
+        actorUserId: string;
+        startedAt: string;
+        previousSetId: string | null;
+        previousCaseIds: string[];
+        events: {
+            stage: "case_data" | "coverage" | "aggregation" | "prescreen" | "scripts" | "reuse" | "evaluation" | "report";
+            at: string;
+            status: "failed" | "completed" | "started";
+            code?: string | undefined;
+        }[];
+        setId?: string | undefined;
+        version?: number | undefined;
+        supplyRevision?: number | undefined;
+        selectionDifference?: {
+            same: number;
+            added: number;
+            removed: number;
+        } | undefined;
+        endedAt?: string | undefined;
+    } | undefined;
+    collectionRestartHistory?: {
+        operationId: string;
+        actorUserId: string;
+        startedAt: string;
+        previousSetId: string | null;
+        previousCaseIds: string[];
+        events: {
+            stage: "case_data" | "coverage" | "aggregation" | "prescreen" | "scripts" | "reuse" | "evaluation" | "report";
+            at: string;
+            status: "failed" | "completed" | "started";
+            code?: string | undefined;
+        }[];
+        setId?: string | undefined;
+        version?: number | undefined;
+        supplyRevision?: number | undefined;
+        selectionDifference?: {
+            same: number;
+            added: number;
+            removed: number;
+        } | undefined;
+        endedAt?: string | undefined;
+    }[] | undefined;
+    restartSubmittedCaseIds?: string[] | undefined;
+    supplyDestinationExtractionVersion?: number | undefined;
+    unconfirmedScriptKeys?: string[] | undefined;
+    scriptRecoveries?: {
+        operationId: string;
+        setId: string;
+        unconfirmedScriptKeys: string[];
+        invalidScriptVersionIds: string[];
+        reason: string;
+        actorUserId: string;
+        at: string;
+        invalidScripts: {
+            caseId: string;
+            scriptKey: string;
+            scriptVersionId: string;
+            reason: string;
+        }[];
+        orphanedVersionsPossible: true;
+    }[] | undefined;
+    dataFailures?: Record<string, {
+        code: string;
+        attempts: number;
+        revision?: number | undefined;
+    }> | undefined;
+    dataCollection?: Record<string, {
+        records: number;
+        gapCount: number;
+        gapReasons: Record<string, number>;
+        inventoryEstimates: number;
+    }> | undefined;
+    retryReleases?: {
+        operationId: string;
+        actorUserId: string;
+        at: string;
+        cases: {
+            caseId: string;
+            revision: number;
+            previousCode: string;
+        }[];
+        scripts?: {
+            scriptKey: string;
+            previousCode: string;
+        }[] | undefined;
+    }[] | undefined;
+    scriptFailures?: Record<string, {
+        code: string;
+        attempts: number;
+        revision?: number | undefined;
+    }> | undefined;
+    prescreenJob?: {
+        jobId: string;
+        status: string;
+        attempts: number;
+        errorCode: string | null;
+    } | null | undefined;
+    skippedPrescreen?: number | undefined;
+    supplyProducts?: number | undefined;
+    supplyDestinations?: number | undefined;
+    threadCount?: number | undefined;
+    passedCount?: number | undefined;
+    window?: {
+        from: string;
+        to: string;
+    } | undefined;
+    skippedOutsideWindow?: number | undefined;
+    noticeReadFailures?: number | undefined;
+    noticeTruncations?: number | undefined;
+}, {
+    supplyRevision: number | null;
+    buyers: string[] | null;
+    aggregations: Record<string, {
+        jobId: string;
+        status: string;
+        attempts: number;
+        errorCode: string | null;
+    }>;
+    completed: Record<string, number>;
+    coverageJob: {
+        jobId: string;
+        status: string;
+        attempts: number;
+        errorCode: string | null;
+        setId: string | null;
+    } | null;
+    setId: string | null;
+    scripts: Record<string, string>;
+    uncertain: "script" | "coverage" | "supply" | "aggregation" | "prescreen" | null;
+    version: 2;
+    substitutions?: Record<string, string> | undefined;
+    collectionRestart?: {
+        operationId: string;
+        actorUserId: string;
+        startedAt: string;
+        previousSetId: string | null;
+        previousCaseIds: string[];
+        events: {
+            stage: "case_data" | "coverage" | "aggregation" | "prescreen" | "scripts" | "reuse" | "evaluation" | "report";
+            at: string;
+            status: "failed" | "completed" | "started";
+            code?: string | undefined;
+        }[];
+        setId?: string | undefined;
+        version?: number | undefined;
+        supplyRevision?: number | undefined;
+        selectionDifference?: {
+            same: number;
+            added: number;
+            removed: number;
+        } | undefined;
+        endedAt?: string | undefined;
+    } | undefined;
+    collectionRestartHistory?: {
+        operationId: string;
+        actorUserId: string;
+        startedAt: string;
+        previousSetId: string | null;
+        previousCaseIds: string[];
+        events: {
+            stage: "case_data" | "coverage" | "aggregation" | "prescreen" | "scripts" | "reuse" | "evaluation" | "report";
+            at: string;
+            status: "failed" | "completed" | "started";
+            code?: string | undefined;
+        }[];
+        setId?: string | undefined;
+        version?: number | undefined;
+        supplyRevision?: number | undefined;
+        selectionDifference?: {
+            same: number;
+            added: number;
+            removed: number;
+        } | undefined;
+        endedAt?: string | undefined;
+    }[] | undefined;
+    restartSubmittedCaseIds?: string[] | undefined;
+    supplyDestinationExtractionVersion?: number | undefined;
+    unconfirmedScriptKeys?: string[] | undefined;
+    scriptRecoveries?: {
+        operationId: string;
+        setId: string;
+        unconfirmedScriptKeys: string[];
+        invalidScriptVersionIds: string[];
+        reason: string;
+        actorUserId: string;
+        at: string;
+        invalidScripts: {
+            caseId: string;
+            scriptKey: string;
+            scriptVersionId: string;
+            reason: string;
+        }[];
+        orphanedVersionsPossible: true;
+    }[] | undefined;
+    dataFailures?: Record<string, {
+        code: string;
+        attempts: number;
+        revision?: number | undefined;
+    }> | undefined;
+    dataCollection?: Record<string, {
+        records: number;
+        gapCount: number;
+        gapReasons: Record<string, number>;
+        inventoryEstimates: number;
+    }> | undefined;
+    retryReleases?: {
+        operationId: string;
+        actorUserId: string;
+        at: string;
+        cases: {
+            caseId: string;
+            revision: number;
+            previousCode: string;
+        }[];
+        scripts?: {
+            scriptKey: string;
+            previousCode: string;
+        }[] | undefined;
+    }[] | undefined;
+    scriptFailures?: Record<string, {
+        code: string;
+        attempts: number;
+        revision?: number | undefined;
+    }> | undefined;
+    prescreenJob?: {
+        jobId: string;
+        status: string;
+        attempts: number;
+        errorCode: string | null;
+    } | null | undefined;
+    skippedPrescreen?: number | undefined;
+    supplyProducts?: number | undefined;
+    supplyDestinations?: number | undefined;
+    threadCount?: number | undefined;
+    passedCount?: number | undefined;
+    window?: {
+        from: string;
+        to: string;
+    } | undefined;
+    skippedOutsideWindow?: number | undefined;
+    noticeReadFailures?: number | undefined;
+    noticeTruncations?: number | undefined;
+} | {
+    supplyRevision: number | null;
+    buyers: string[] | null;
+    aggregations: Record<string, {
+        jobId: string;
+        status: string;
+        attempts: number;
+        errorCode: string | null;
+    }>;
+    completed: Record<string, number>;
+    coverageJob: {
+        jobId: string;
+        status: string;
+        attempts: number;
+        errorCode: string | null;
+        setId: string | null;
+    } | null;
+    setId: string | null;
+    scripts: Record<string, string>;
+    uncertain: "script" | "coverage" | "supply" | "aggregation" | "prescreen" | null;
+    version: 1;
+    collectionRestart?: {
+        operationId: string;
+        actorUserId: string;
+        startedAt: string;
+        previousSetId: string | null;
+        previousCaseIds: string[];
+        events: {
+            stage: "case_data" | "coverage" | "aggregation" | "prescreen" | "scripts" | "reuse" | "evaluation" | "report";
+            at: string;
+            status: "failed" | "completed" | "started";
+            code?: string | undefined;
+        }[];
+        setId?: string | undefined;
+        version?: number | undefined;
+        supplyRevision?: number | undefined;
+        selectionDifference?: {
+            same: number;
+            added: number;
+            removed: number;
+        } | undefined;
+        endedAt?: string | undefined;
+    } | undefined;
+    collectionRestartHistory?: {
+        operationId: string;
+        actorUserId: string;
+        startedAt: string;
+        previousSetId: string | null;
+        previousCaseIds: string[];
+        events: {
+            stage: "case_data" | "coverage" | "aggregation" | "prescreen" | "scripts" | "reuse" | "evaluation" | "report";
+            at: string;
+            status: "failed" | "completed" | "started";
+            code?: string | undefined;
+        }[];
+        setId?: string | undefined;
+        version?: number | undefined;
+        supplyRevision?: number | undefined;
+        selectionDifference?: {
+            same: number;
+            added: number;
+            removed: number;
+        } | undefined;
+        endedAt?: string | undefined;
+    }[] | undefined;
+    restartSubmittedCaseIds?: string[] | undefined;
+    supplyDestinationExtractionVersion?: number | undefined;
+    unconfirmedScriptKeys?: string[] | undefined;
+    scriptRecoveries?: {
+        operationId: string;
+        setId: string;
+        unconfirmedScriptKeys: string[];
+        invalidScriptVersionIds: string[];
+        reason: string;
+        actorUserId: string;
+        at: string;
+        invalidScripts: {
+            caseId: string;
+            scriptKey: string;
+            scriptVersionId: string;
+            reason: string;
+        }[];
+        orphanedVersionsPossible: true;
+    }[] | undefined;
+    dataFailures?: Record<string, {
+        code: string;
+        attempts: number;
+        revision?: number | undefined;
+    }> | undefined;
+    dataCollection?: Record<string, {
+        records: number;
+        gapCount: number;
+        gapReasons: Record<string, number>;
+        inventoryEstimates: number;
+    }> | undefined;
+    retryReleases?: {
+        operationId: string;
+        actorUserId: string;
+        at: string;
+        cases: {
+            caseId: string;
+            revision: number;
+            previousCode: string;
+        }[];
+        scripts?: {
+            scriptKey: string;
+            previousCode: string;
+        }[] | undefined;
+    }[] | undefined;
+    scriptFailures?: Record<string, {
+        code: string;
+        attempts: number;
+        revision?: number | undefined;
+    }> | undefined;
+    prescreenJob?: {
+        jobId: string;
+        status: string;
+        attempts: number;
+        errorCode: string | null;
+    } | null | undefined;
+    skippedPrescreen?: number | undefined;
+    supplyProducts?: number | undefined;
+    supplyDestinations?: number | undefined;
+    threadCount?: number | undefined;
+    passedCount?: number | undefined;
+    window?: {
+        from: string;
+        to: string;
+    } | undefined;
+    skippedOutsideWindow?: number | undefined;
+    noticeReadFailures?: number | undefined;
+    noticeTruncations?: number | undefined;
+}>>;
+/** Durable production state; model output and credentials are never checkpoint fields. Version 1 loads as version 2. */
+export type ProductionCheckpoint = z.output<typeof Checkpoint>;
+/** A stopped stage with a stable machine code; completed checkpoints remain reusable. */
+export declare class ProductionFailure extends Error {
+    readonly code: string;
+    readonly stage: CsHostingEvaluationProduction['stage'];
+    readonly terminalJob: boolean;
+    /** @param code - Machine-readable cause. @param stage - Operation that stopped. @param terminalJob - True only after a definitive server job failure; omission retains its id for polling. */
+    constructor(code: string, stage: CsHostingEvaluationProduction['stage'], terminalJob?: boolean);
+}
+/** Owns supply, aggregation, prescreen, coverage, selected case data, and script attachment. A definite per-item failure does not block the later stages. */
+export declare class ScriptProductionPipeline {
+    private readonly ctx;
+    private readonly config;
+    private readonly operations;
+    private state;
+    private saving;
+    private scriptAttach;
+    private readonly caseReadPolicy;
+    /** @param ctx - Tenant-bound merchant requests. @param config - Resolved deployment choices. @param operations - Workspace tasks and durable checkpoint IO. */
+    constructor(ctx: Context, config: ProductionConfig, operations: ProductionOperations);
+    /** @returns The durable fresh-collection audit, absent on ordinary production. */
+    get collectionRestart(): CsHostingEvaluationProduction['collectionRestart'];
+    /** @param signal - Shop lifetime. @returns After confirming that no previously submitted write has an unknown outcome. */
+    assertResumable(signal: AbortSignal): Promise<void>;
+    /** @param signal - Shop lifetime. @returns The unfinished durable batch for explicit cancellation; unknown writes reject before any mutation. */
+    restoreCollectionRestart(signal: AbortSignal): Promise<CsHostingEvaluationProduction['collectionRestart']>;
+    /** @param fallback - Window of a new batch. @param signal - Shop lifetime. @returns The saved unfinished batch window, or the new window, without writing a checkpoint. */
+    previewCollectionRestart(fallback: ProductionWindow, signal: AbortSignal): Promise<{
+        window: ProductionWindow;
+        resuming: boolean;
+        caseCount?: number;
+    }>;
+    /** @param stage - Completed or started operation. @param status - Acknowledged stage outcome. @param signal - Shop lifetime. @param code - Safe failure code. */
+    auditRestart(stage: NonNullable<CsHostingEvaluationProduction['collectionRestart']>['events'][number]['stage'], status: 'started' | 'completed' | 'failed', signal: AbortSignal, code?: string): Promise<void>;
+    /** @returns Practice cases acknowledged in this restart batch, including cases still awaiting judgment. */
+    get submittedPracticeCaseIds(): readonly string[];
+    /** @param caseId - Server-acknowledged practice case. @param signal - Shop lifetime. */
+    acknowledgePractice(caseId: string, signal: AbortSignal): Promise<void>;
+    private captureSupply;
+    private beginRestart;
+    /**
+     * Release explicitly named unknown script writes and exclude fixed versions without changing server bindings.
+     * @param request - Operator-authorized recovery, including acceptance of possibly unused server versions.
+     * @param actorUserId - Current Host-authenticated administrator.
+     * @param signal - Captured shop lifetime.
+     * @returns After the release and audit are durable; identical operation ids are idempotent.
+     */
+    recoverScripts(request: z.input<typeof ScriptRecoveryRequest>, actorUserId: MerchantIdentityCapture['identity']['userId'], signal: AbortSignal): Promise<void>;
+    /** @returns Explicitly excluded immutable versions, retained across production restarts. */
+    get invalidScripts(): readonly z.infer<typeof InvalidScript>[];
+    /** @returns Durable operator recovery identities associated with this production checkpoint. */
+    get scriptRecoveryOperationIds(): string[];
+    /**
+     * Grant one further attempt to every exhausted primary, alternate and missing script slot in this set; committed material and coverage remain intact.
+     * @param actorUserId - Host-authenticated administrator responsible for this release.
+     * @param signal - Current shop lifetime.
+     * @param operationId - Stable command identity when retry is dispatched remotely.
+     * @returns Released case ids and script keys after the audit record and grants are durable.
+     */
+    retryFailedCases(actorUserId: MerchantIdentityCapture['identity']['userId'], signal: AbortSignal, operationId?: string): Promise<{
+        readonly caseIds: readonly string[];
+        readonly scriptKeys: readonly string[];
+    }>;
+    /** @returns The admitted persisted range, or undefined when neither the checkpoint nor caller supplied one. */
+    get window(): ProductionWindow | undefined;
+    /** @param signal - Shop lifetime. @returns The checkpoint's set and fixed window, if available. */
+    checkpointScope(signal: AbortSignal): Promise<{
+        setId: string | null;
+        window?: ProductionWindow;
+    } | undefined>;
+    /**
+     * Counts this process has already read. Supply stays absent until capture or a successful supply read;
+     * buyers stay absent until discovery; threads and passed stay absent until the prescreen case read.
+     * @returns The measured subset, or undefined when none of those reads has finished.
+     */
+    prepareFacts(): CsHostingPrepareCounts | undefined;
+    /**
+     * Resume committed stages and attach every confirmed script before returning.
+     * A definite per-item failure is checkpointed and retried once; unknown writes stop until the owning operator resolves them.
+     * @param signal - Run and shop lifetime; cancellation joins all workers.
+     * @param progress - Running-workbench stage projection.
+     * @param existingSetId - Published set to reuse when no local checkpoint exists; omission runs all production stages.
+     * @param window - Fixed last-message range sent to coverage; omission uses the server's default range.
+     * @param restartActorUserId - Explicit fresh collection request; stale supply is refreshed once, and unfinished batches resume their acknowledged revision and saved window.
+     * @param resuming - Whether this is an existing assigned run whose checkpoint must not be replaced.
+     * @returns Ready immutable evaluation set UUID.
+     */
+    prepare(signal: AbortSignal, progress: (value: CsHostingEvaluationProduction) => void, existingSetId?: string, window?: ProductionWindow, restartActorUserId?: string, resuming?: boolean): Promise<string>;
+    private prepareOnce;
+    private cases;
+    private casePage;
+    private poll;
+    private work;
+    private acceptsSubmitted;
+    private collectSelected;
+    private currentCaseId;
+    private openSlot;
+    private filledCount;
+    private slotResolved;
+    private hasCollectableAlternative;
+    private promote;
+    private practiced;
+    private collectCases;
+    /** Cancellation, unknown writes, quota, and identity failure stop every worker. Other task errors stay on that item. */
+    private stopsStage;
+    private definiteTaskError;
+    private noteDataFailure;
+    private clearDataFailure;
+    private noteScriptFailure;
+    private clearScriptFailure;
+    private alternativeProjection;
+    private noticeProjection;
+    private failureProjection;
+    private throwIfUnconfirmed;
+    private markScriptUnconfirmed;
+    private clearScriptUnconfirmed;
+    /** Attach one confirmed version at a time. The route updates the set atomically, so overlapping posts can reject a new version. */
+    private attachScript;
+    private refused;
+    private save;
+}
+/**
+ * A higher revision stays current when the ordered case segment message keys still equal the feature material keys.
+ * Script submit and attach accept that revision only when the feature material signature matches the current conversation; this check uses those keys and does not read sourceSignature.
+ * @param row - Current case.
+ * @param recorded - Revision stored on the selection or alternate.
+ * @param feature - Coverage feature that owns the saved material.
+ * @returns Whether the case is still the recorded conversation.
+ */
+export declare function caseMaterialCurrent(row: z.infer<typeof SalesCase>, recorded: number, feature: {
+    material: readonly {
+        messageKey: string;
+    }[];
+} | undefined): boolean;
+/**
+ * Feature id to send when the practiced selection is an alternate.
+ * Omission means the original selected feature.
+ * @param selection - Selection after a possible alternate substitution.
+ * @returns The alternate feature id, or undefined for the original selection.
+ */
+export declare function alternateFeatureId(selection: {
+    featureId: string;
+    alternates?: readonly {
+        featureId: string;
+    }[] | undefined;
+}): string | undefined;
+export {};