@usherlabs/cex-broker 0.2.49 → 0.2.51

package/dist/helpers/market-data-preparation/contracts.d.ts

@@ -1,16 +1,20 @@
-import type { ArchiveSelectionWire, BackfillJobResultWire, FixedUtcTimestamp, LowercaseUuid, Sha256Hex } from "../market-data-vendor-backfill/contracts";
+import type { ArchiveSelectionWire, BackfillOutcomeWire, FixedUtcTimestamp, LowercaseUuid, Sha256Hex } from "../market-data-vendor-backfill/contracts";
 export declare const BACKFILL_RESULT_V2_SCHEMA_ID: string;
 export declare const CANONICAL_ORDERBOOK_EXPORT_REQUEST_SCHEMA_ID: string;
 export declare const CANONICAL_ORDERBOOK_EXPORT_RESULT_SCHEMA_ID: string;
 export declare const PREPARATION_PRODUCT_PIN_SCHEMA_ID: string;
-export declare const PREPARATION_SCHEMA_MANIFEST_V2_ID: "https://schemas.usher.so/market-data-vendor-backfill-schema-manifest/v2";
+export declare const ORDER_BOOK_LEVELS_PARQUET_PROJECTION_SCHEMA_ID: string;
+export declare const ORDER_BOOK_DEPTH_SUMMARY_PARQUET_PROJECTION_SCHEMA_ID: string;
+export declare const SOURCE_FORENSICS_LEDGER_SCHEMA_ID: string;
+export declare const SOURCE_QUALIFICATION_RECORD_SCHEMA_ID: string;
+export declare const PREPARATION_SCHEMA_MANIFEST_V3_ID: "https://schemas.usher.so/market-data-vendor-backfill-schema-manifest/v3";
 export type PreparationTarget = {
     environment: string;
     cluster: string;
 };
 export type PreparationProducerIdentity = {
     product_id: "market-data-vendor-backfill" | "cex-canonical-orderbook-export";
-    product_version: "market-data-vendor-backfill/v1" | "cex-canonical-orderbook-export/v1";
+    product_version: "market-data-vendor-backfill/v1" | "cex-canonical-orderbook-export/v2";
     package: {
         name: "@usherlabs/cex-broker";
         version: string;
@@ -42,7 +46,7 @@ export type BackfillJobResultV2Wire = {
     };
     started_at: FixedUtcTimestamp;
     completed_at: FixedUtcTimestamp;
-    outcome: BackfillJobResultWire["outcome"];
+    outcome: BackfillOutcomeWire;
 };
 export type CanonicalOrderBookExportRequestWire = {
     schema_id: typeof CANONICAL_ORDERBOOK_EXPORT_REQUEST_SCHEMA_ID;
@@ -50,7 +54,7 @@ export type CanonicalOrderBookExportRequestWire = {
     target: PreparationTarget;
     selection: ArchiveSelectionWire;
     depth: number;
-    construction_mode: "sampled_top_n_snapshot" | "exact_l2_reconstruction";
+    construction_mode: "sampled_top_n_snapshot" | "exact_l2_reconstruction" | "policy_neutral_top_n_state_change_tape/v1";
     canonical_schema_version: string;
     checksum_algorithm: "sha256-canonical-json-v1";
 };
@@ -62,6 +66,8 @@ export type CanonicalOrderBookExportArtifact = {
     rows: number;
     bytes: number;
     sha256: Sha256Hex;
+    projection_schema_id: typeof ORDER_BOOK_LEVELS_PARQUET_PROJECTION_SCHEMA_ID | typeof ORDER_BOOK_DEPTH_SUMMARY_PARQUET_PROJECTION_SCHEMA_ID;
+    projection_schema_sha256: Sha256Hex;
 };
 export type CanonicalOrderBookExportResultWire = {
     schema_id: typeof CANONICAL_ORDERBOOK_EXPORT_RESULT_SCHEMA_ID;
@@ -70,7 +76,7 @@ export type CanonicalOrderBookExportResultWire = {
     request_file_sha256: Sha256Hex | null;
     producer: PreparationProducerIdentity & {
         product_id: "cex-canonical-orderbook-export";
-        product_version: "cex-canonical-orderbook-export/v1";
+        product_version: "cex-canonical-orderbook-export/v2";
     };
     started_at: FixedUtcTimestamp;
     completed_at: FixedUtcTimestamp;
@@ -108,7 +114,7 @@ export type PreparationProductPinWire = {
         executable_sha256: Sha256Hex;
     }>;
     schema_manifest: {
-        schema_id: typeof PREPARATION_SCHEMA_MANIFEST_V2_ID;
+        schema_id: typeof PREPARATION_SCHEMA_MANIFEST_V3_ID;
         manifest_sha256: Sha256Hex;
         relative_path: "dist/market-data-preparation/schema-manifest.json";
     };
@@ -120,10 +126,29 @@ export type PreparationProductPinWire = {
         policy_id: string;
         policy_sha256: Sha256Hex;
     };
+    source_tape_capability: {
+        policy_id: string;
+        policy_sha256: Sha256Hex;
+    };
     resource_policy: {
         policy_id: string;
         policy_sha256: Sha256Hex;
     };
+    preparation_library: {
+        exported_subpath: "@usherlabs/cex-broker/market-data-preparation";
+        runtime_entry_sha256: Sha256Hex;
+        declaration_sha256: Sha256Hex;
+        operations: [
+            {
+                symbol: "runMarketDataSourceTape";
+                operation_id: "market-data-source-tape/v1";
+            },
+            {
+                symbol: "runMarketDataRequiredClockQualification";
+                operation_id: "market-data-required-clock-qualification/v1";
+            }
+        ];
+    };
 };
 type Codec<T> = {
     decode(value: unknown): T;
@@ -137,7 +162,7 @@ export declare function finalizeBackfillResultV2(content: Omit<BackfillJobResult
 export declare function finalizeCanonicalOrderBookExportResult(content: Omit<CanonicalOrderBookExportResultWire, "result_sha256">): CanonicalOrderBookExportResultWire;
 export declare const PREPARATION_SCHEMA_ARTIFACTS: readonly Readonly<{
     schema_id: string;
-    path: "schemas/backfill-request-v1.schema.json" | "schemas/backfill-result-v2.schema.json" | "schemas/required-clock-v1.schema.json" | "schemas/archive-selection-v1.schema.json" | "schemas/promotion-receipt-v1.schema.json" | "schemas/canonical-orderbook-export-request-v1.schema.json" | "schemas/canonical-orderbook-export-result-v1.schema.json" | "schemas/preparation-product-pin-v1.schema.json";
+    path: "schemas/backfill-request-v1.schema.json" | "schemas/backfill-result-v2.schema.json" | "schemas/required-clock-v1.schema.json" | "schemas/archive-selection-v1.schema.json" | "schemas/promotion-receipt-v1.schema.json" | "schemas/canonical-orderbook-export-request-v1.schema.json" | "schemas/canonical-orderbook-export-result-v2.schema.json" | "schemas/preparation-product-pin-v2.schema.json" | "schemas/order-book-levels-parquet-projection-v1.schema.json" | "schemas/order-book-depth-summary-parquet-projection-v1.schema.json" | "schemas/source-forensics-ledger-v1.schema.json" | "schemas/source-qualification-record-v1.schema.json";
     schema_sha256: string;
     schema: {
         $schema: string;
@@ -1540,9 +1565,63 @@ export declare const PREPARATION_SCHEMA_ARTIFACTS: readonly Readonly<{
                     sha256: {
                         $ref: string;
                     };
+                    projection_schema_id: {
+                        enum: string[];
+                    };
+                    projection_schema_sha256: {
+                        $ref: string;
+                    };
                 };
             };
         };
+    } | {
+        $schema: string;
+        $id: string;
+        title: string;
+        canonical_schema_id: string;
+        file_name: string;
+        parquet_metadata: {
+            key_value_metadata: never[];
+        };
+        columns: ({
+            name: string;
+            physical_type: string;
+            logical_type: string;
+            nullable: boolean;
+        } | {
+            name: string;
+            physical_type: string;
+            logical_type: null;
+            nullable: boolean;
+        })[];
+        metadata: {
+            "cex.canonical_schema_id": string;
+            "cex.projection_schema_id": string;
+        };
+    } | {
+        $schema: string;
+        $id: string;
+        title: string;
+        canonical_schema_id: string;
+        file_name: string;
+        parquet_metadata: {
+            key_value_metadata: never[];
+        };
+        columns: ({
+            name: string;
+            physical_type: string;
+            logical_type: string;
+            nullable: boolean;
+        } | {
+            name: string;
+            physical_type: string;
+            logical_type: null;
+            nullable: boolean;
+        })[];
+        metadata: {
+            "cex.canonical_schema_id": string;
+            "cex.projection_schema_id": string;
+        };
     } | {
         $schema: string;
         $id: string;
@@ -1647,9 +1726,47 @@ export declare const PREPARATION_SCHEMA_ARTIFACTS: readonly Readonly<{
             capability_policy: {
                 $ref: string;
             };
+            source_tape_capability: {
+                $ref: string;
+            };
             resource_policy: {
                 $ref: string;
             };
+            preparation_library: {
+                type: string;
+                additionalProperties: boolean;
+                required: string[];
+                properties: {
+                    exported_subpath: {
+                        const: string;
+                    };
+                    runtime_entry_sha256: {
+                        $ref: string;
+                    };
+                    declaration_sha256: {
+                        $ref: string;
+                    };
+                    operations: {
+                        type: string;
+                        prefixItems: {
+                            type: string;
+                            additionalProperties: boolean;
+                            required: string[];
+                            properties: {
+                                symbol: {
+                                    const: string;
+                                };
+                                operation_id: {
+                                    const: string;
+                                };
+                            };
+                        }[];
+                        items: boolean;
+                        minItems: number;
+                        maxItems: number;
+                    };
+                };
+            };
         };
         $defs: {
             sha256: {
@@ -1676,15 +1793,1178 @@ export declare const PREPARATION_SCHEMA_ARTIFACTS: readonly Readonly<{
                 };
             };
         };
-    };
-}>[];
-export declare const PREPARATION_SCHEMA_MANIFEST_V2: Readonly<{
-    manifest_sha256: string;
-    schema_id: "https://schemas.usher.so/market-data-vendor-backfill-schema-manifest/v2";
-    artifacts: {
-        schema_id: string;
-        path: "schemas/backfill-request-v1.schema.json" | "schemas/backfill-result-v2.schema.json" | "schemas/required-clock-v1.schema.json" | "schemas/archive-selection-v1.schema.json" | "schemas/promotion-receipt-v1.schema.json" | "schemas/canonical-orderbook-export-request-v1.schema.json" | "schemas/canonical-orderbook-export-result-v1.schema.json" | "schemas/preparation-product-pin-v1.schema.json";
-        schema_sha256: string;
-    }[];
+    } | {
+        $schema: string;
+        $id: string;
+        title: string;
+        type: string;
+        additionalProperties: boolean;
+        required: string[];
+        properties: {
+            schema_id: {
+                const: string;
+            };
+            ledger_sha256: {
+                $ref: string;
+            };
+            operation_kind: {
+                enum: string[];
+            };
+            normalized_invocation_sha256: {
+                $ref: string;
+            };
+            request_id: {
+                $ref: string;
+            };
+            scope: {
+                $ref: string;
+            };
+            window: {
+                $ref: string;
+            };
+            required_clock: {
+                $ref: string;
+            };
+            source_tape: {
+                $ref: string;
+            };
+            effective_policies: {
+                $ref: string;
+            };
+            provider_object_inventory: {
+                $ref: string;
+            };
+            provider_objects: {
+                type: string;
+                items: {
+                    $ref: string;
+                };
+            };
+            records: {
+                type: string;
+                maxItems: number;
+                items: {
+                    $ref: string;
+                };
+            };
+            target_dispositions: {
+                type: string;
+                maxItems: number;
+                items: {
+                    $ref: string;
+                };
+            };
+            summary: {
+                type: string;
+            };
+            limits: {
+                type: string;
+                additionalProperties: boolean;
+                required: string[];
+                properties: {
+                    max_records: {
+                        const: number;
+                    };
+                    max_canonical_json_bytes: {
+                        const: number;
+                    };
+                };
+            };
+            complete: {
+                type: string;
+            };
+            incomplete_reason: {
+                oneOf: ({
+                    type: string;
+                    const?: undefined;
+                } | {
+                    const: string;
+                    type?: undefined;
+                })[];
+            };
+        };
+        oneOf: ({
+            properties: {
+                operation_kind: {
+                    const: string;
+                };
+                summary: {
+                    $ref: string;
+                };
+                required_clock: {
+                    $ref: string;
+                };
+                target_dispositions: {
+                    type: string;
+                    maxItems: number;
+                    items: {
+                        $ref: string;
+                    };
+                };
+                source_tape: {
+                    $ref?: undefined;
+                };
+            };
+            required: string[];
+            not: {
+                properties: {
+                    source_tape: {};
+                };
+                required: string[];
+                anyOf?: undefined;
+            };
+        } | {
+            properties: {
+                operation_kind: {
+                    const: string;
+                };
+                summary: {
+                    $ref: string;
+                };
+                source_tape: {
+                    $ref: string;
+                };
+                required_clock: {
+                    $ref?: undefined;
+                };
+                target_dispositions: {
+                    type?: undefined;
+                    maxItems?: undefined;
+                    items?: undefined;
+                };
+            };
+            required: string[];
+            not: {
+                anyOf: ({
+                    properties: {
+                        required_clock: {};
+                        target_dispositions?: undefined;
+                    };
+                    required: string[];
+                } | {
+                    properties: {
+                        target_dispositions: {};
+                        required_clock?: undefined;
+                    };
+                    required: string[];
+                })[];
+                properties?: undefined;
+                required?: undefined;
+            };
+        })[];
+        $defs: {
+            sha256: {
+                type: string;
+                pattern: string;
+            };
+            uuid: {
+                type: string;
+                pattern: string;
+            };
+            uint: {
+                type: string;
+                minimum: number;
+                maximum: number;
+            };
+            pin: {
+                type: string;
+                additionalProperties: boolean;
+                required: string[];
+                properties: {
+                    policy_id: {
+                        type: string;
+                        minLength: number;
+                        maxLength: number;
+                    };
+                    policy_sha256: {
+                        $ref: string;
+                    };
+                };
+            };
+            scope: {
+                type: string;
+                additionalProperties: boolean;
+                required: string[];
+                properties: {
+                    exchange: {
+                        type: string;
+                        pattern: string;
+                    };
+                    trading_pair: {
+                        type: string;
+                        pattern: string;
+                    };
+                    market_type: {
+                        enum: string[];
+                    };
+                    feed: {
+                        const: string;
+                    };
+                };
+            };
+            interval: {
+                type: string;
+                additionalProperties: boolean;
+                required: string[];
+                properties: {
+                    start_time_ms: {
+                        $ref: string;
+                    };
+                    end_time_ms_exclusive: {
+                        $ref: string;
+                    };
+                };
+            };
+            clock: {
+                type: string;
+                additionalProperties: boolean;
+                required: string[];
+                properties: {
+                    clock_id: {
+                        $ref: string;
+                    };
+                    clock_sha256: {
+                        $ref: string;
+                    };
+                    event_count: {
+                        $ref: string;
+                    };
+                };
+            };
+            sourceTape: {
+                type: string;
+                additionalProperties: boolean;
+                required: string[];
+                properties: {
+                    product_id: {
+                        const: string;
+                    };
+                    product_version: {
+                        const: string;
+                    };
+                    state_count: {
+                        $ref: string;
+                    };
+                };
+            };
+            policies: {
+                type: string;
+                additionalProperties: boolean;
+                required: string[];
+                properties: {
+                    capability_policy: {
+                        $ref: string;
+                    };
+                    resource_policy: {
+                        $ref: string;
+                    };
+                    adapter_policy: {
+                        $ref: string;
+                    };
+                    acquisition_policy: {
+                        $ref: string;
+                    };
+                };
+            };
+            inventory: {
+                type: string;
+                additionalProperties: boolean;
+                required: string[];
+                properties: {
+                    expected_identities: {
+                        type: string;
+                        maxItems: number;
+                        uniqueItems: boolean;
+                        items: {
+                            type: string;
+                            minLength: number;
+                            maxLength: number;
+                        };
+                    };
+                    observed_identities: {
+                        type: string;
+                        maxItems: number;
+                        uniqueItems: boolean;
+                        items: {
+                            type: string;
+                            minLength: number;
+                            maxLength: number;
+                        };
+                    };
+                    expected_selected_intervals: {
+                        type: string;
+                        maxItems: number;
+                        uniqueItems: boolean;
+                        items: {
+                            $ref: string;
+                        };
+                    };
+                    observed_selected_intervals: {
+                        type: string;
+                        maxItems: number;
+                        uniqueItems: boolean;
+                        items: {
+                            $ref: string;
+                        };
+                    };
+                    complete: {
+                        type: string;
+                    };
+                };
+            };
+            object: {
+                type: string;
+                additionalProperties: boolean;
+                required: string[];
+                properties: {
+                    identity: {
+                        type: string;
+                        minLength: number;
+                        maxLength: number;
+                    };
+                    checksums: {
+                        type: string;
+                        minItems: number;
+                        uniqueItems: boolean;
+                        items: {
+                            $ref: string;
+                        };
+                    };
+                    attempt_count: {
+                        type: string;
+                        minimum: number;
+                        maximum: number;
+                    };
+                    quarantined: {
+                        type: string;
+                    };
+                };
+            };
+            anchor: {
+                type: string;
+                additionalProperties: boolean;
+                required: string[];
+                properties: {
+                    event_time_ms: {
+                        $ref: string;
+                    };
+                    sequence: {
+                        type: string;
+                        pattern: string;
+                    };
+                    object_identity: {
+                        type: string;
+                        minLength: number;
+                        maxLength: number;
+                    };
+                    object_checksum: {
+                        $ref: string;
+                    };
+                };
+            };
+            targetInterval: {
+                type: string;
+                additionalProperties: boolean;
+                required: string[];
+                properties: {
+                    start_target_time_ms: {
+                        $ref: string;
+                    };
+                    end_target_time_ms_exclusive: {
+                        $ref: string;
+                    };
+                    target_count: {
+                        $ref: string;
+                    };
+                };
+            };
+            lagDistribution: {
+                type: string;
+                additionalProperties: boolean;
+                required: string[];
+                properties: {
+                    lag_1000_ms: {
+                        $ref: string;
+                    };
+                    lag_2000_ms: {
+                        $ref: string;
+                    };
+                    lag_5000_ms: {
+                        $ref: string;
+                    };
+                    lag_10000_ms: {
+                        $ref: string;
+                    };
+                    lag_30000_ms: {
+                        $ref: string;
+                    };
+                    lag_60000_ms: {
+                        $ref: string;
+                    };
+                };
+            };
+            sequence: {
+                type: string;
+                additionalProperties: boolean;
+                required: string[];
+                properties: {
+                    expected_previous: {
+                        type: string;
+                        pattern: string;
+                    };
+                    observed_previous: {
+                        type: string;
+                        pattern: string;
+                    };
+                    observed_final: {
+                        type: string;
+                        pattern: string;
+                    };
+                    event_time_ms: {
+                        $ref: string;
+                    };
+                };
+            };
+            record: {
+                type: string;
+                additionalProperties: boolean;
+                required: string[];
+                properties: {
+                    record_sha256: {
+                        $ref: string;
+                    };
+                    kind: {
+                        enum: string[];
+                    };
+                    scope: {
+                        $ref: string;
+                    };
+                    provider_objects: {
+                        type: string;
+                        items: {
+                            $ref: string;
+                        };
+                    };
+                    previous_anchor: {
+                        oneOf: ({
+                            type: string;
+                            $ref?: undefined;
+                        } | {
+                            $ref: string;
+                            type?: undefined;
+                        })[];
+                    };
+                    next_anchor: {
+                        oneOf: ({
+                            type: string;
+                            $ref?: undefined;
+                        } | {
+                            $ref: string;
+                            type?: undefined;
+                        })[];
+                    };
+                    target_interval: {
+                        oneOf: ({
+                            type: string;
+                            $ref?: undefined;
+                        } | {
+                            $ref: string;
+                            type?: undefined;
+                        })[];
+                    };
+                    lag_distribution: {
+                        oneOf: ({
+                            type: string;
+                            $ref?: undefined;
+                        } | {
+                            $ref: string;
+                            type?: undefined;
+                        })[];
+                    };
+                    sequence: {
+                        oneOf: ({
+                            type: string;
+                            $ref?: undefined;
+                        } | {
+                            $ref: string;
+                            type?: undefined;
+                        })[];
+                    };
+                    classification: {
+                        oneOf: ({
+                            type: string;
+                            enum?: undefined;
+                        } | {
+                            enum: string[];
+                            type?: undefined;
+                        })[];
+                    };
+                    adapter_version: {
+                        type: string;
+                        minLength: number;
+                        maxLength: number;
+                    };
+                };
+            };
+            disposition: {
+                type: string;
+                additionalProperties: boolean;
+                required: string[];
+                properties: {
+                    target_id: {
+                        $ref: string;
+                    };
+                    target_time_ms: {
+                        $ref: string;
+                    };
+                    disposition: {
+                        enum: string[];
+                    };
+                    source_time_ms: {
+                        oneOf: ({
+                            type: string;
+                            $ref?: undefined;
+                        } | {
+                            $ref: string;
+                            type?: undefined;
+                        })[];
+                    };
+                    asof_age_ms: {
+                        oneOf: ({
+                            type: string;
+                            $ref?: undefined;
+                        } | {
+                            $ref: string;
+                            type?: undefined;
+                        })[];
+                    };
+                    record_sha256s: {
+                        type: string;
+                        uniqueItems: boolean;
+                        items: {
+                            $ref: string;
+                        };
+                    };
+                };
+            };
+            recordSummary: {
+                type: string;
+                additionalProperties: boolean;
+                required: string[];
+                properties: {
+                    retained_record_count: {
+                        $ref: string;
+                    };
+                    total_record_count: {
+                        $ref: string;
+                    };
+                    omitted_record_count: {
+                        $ref: string;
+                    };
+                    affected_target_count: {
+                        $ref: string;
+                    };
+                    unresolved_record_count: {
+                        $ref: string;
+                    };
+                };
+            };
+            clockSummary: {
+                type: string;
+                additionalProperties: boolean;
+                required: string[];
+                properties: {
+                    retained_record_count: {
+                        $ref: string;
+                    };
+                    total_record_count: {
+                        $ref: string;
+                    };
+                    omitted_record_count: {
+                        $ref: string;
+                    };
+                    affected_target_count: {
+                        $ref: string;
+                    };
+                    unresolved_record_count: {
+                        $ref: string;
+                    };
+                    disposition_complete: {
+                        type: string;
+                    };
+                    fresh_target_count: {
+                        $ref: string;
+                    };
+                    inactive_target_count: {
+                        $ref: string;
+                    };
+                    disqualifying_target_count: {
+                        $ref: string;
+                    };
+                    omitted_target_disposition_count: {
+                        $ref: string;
+                    };
+                };
+            };
+        };
+    } | {
+        $schema: string;
+        $id: string;
+        title: string;
+        type: string;
+        additionalProperties: boolean;
+        required: string[];
+        properties: {
+            schema_id: {
+                const: string;
+            };
+            record_sha256: {
+                $ref: string;
+            };
+            created_at: {
+                $ref: string;
+            };
+            operation_kind: {
+                enum: string[];
+            };
+            normalized_invocation_sha256: {
+                $ref: string;
+            };
+            request_id: {
+                $ref: string;
+            };
+            scope: {
+                $ref: string;
+            };
+            ledger: {
+                $ref: string;
+            };
+            source_reconstruction_accepted: {
+                type: string;
+            };
+            source_event_enumeration_eligible: {
+                type: string;
+            };
+            qualified: {
+                type: string;
+            };
+            source_partition_complete: {
+                type: string;
+            };
+            source_tape_eligible: {
+                type: string;
+            };
+            initializer: {
+                oneOf: ({
+                    $ref: string;
+                    type?: undefined;
+                } | {
+                    type: string;
+                    $ref?: undefined;
+                })[];
+            };
+            outcome: {};
+        };
+        oneOf: ({
+            properties: {
+                operation_kind: {
+                    const: string;
+                };
+                ledger: {
+                    $ref: string;
+                };
+                qualified: {
+                    type: string;
+                };
+                source_partition_complete: {
+                    type: string;
+                };
+                source_tape_eligible: {
+                    type?: undefined;
+                };
+                initializer: {
+                    oneOf?: undefined;
+                };
+                outcome: {
+                    $ref: string;
+                };
+            };
+            required: string[];
+            not: {
+                anyOf: ({
+                    properties: {
+                        source_tape_eligible: {};
+                        initializer?: undefined;
+                    };
+                    required: string[];
+                } | {
+                    properties: {
+                        initializer: {};
+                        source_tape_eligible?: undefined;
+                    };
+                    required: string[];
+                })[];
+            };
+        } | {
+            properties: {
+                operation_kind: {
+                    const: string;
+                };
+                ledger: {
+                    $ref: string;
+                };
+                source_tape_eligible: {
+                    type: string;
+                };
+                initializer: {
+                    oneOf: ({
+                        $ref: string;
+                        type?: undefined;
+                    } | {
+                        type: string;
+                        $ref?: undefined;
+                    })[];
+                };
+                outcome: {
+                    $ref: string;
+                };
+                qualified: {
+                    type?: undefined;
+                };
+                source_partition_complete: {
+                    type?: undefined;
+                };
+            };
+            required: string[];
+            not: {
+                anyOf: ({
+                    properties: {
+                        qualified: {};
+                        source_partition_complete?: undefined;
+                    };
+                    required: string[];
+                } | {
+                    properties: {
+                        source_partition_complete: {};
+                        qualified?: undefined;
+                    };
+                    required: string[];
+                })[];
+            };
+        })[];
+        $defs: {
+            sha256: {
+                type: string;
+                pattern: string;
+            };
+            uuid: {
+                type: string;
+                pattern: string;
+            };
+            uint: {
+                type: string;
+                minimum: number;
+                maximum: number;
+            };
+            timestamp: {
+                type: string;
+                pattern: string;
+            };
+            scope: {
+                type: string;
+                additionalProperties: boolean;
+                required: string[];
+                properties: {
+                    exchange: {
+                        type: string;
+                        pattern: string;
+                    };
+                    trading_pair: {
+                        type: string;
+                        pattern: string;
+                    };
+                    market_type: {
+                        enum: string[];
+                    };
+                    feed: {
+                        const: string;
+                    };
+                };
+            };
+            ledger: {
+                type: string;
+                additionalProperties: boolean;
+                required: string[];
+                properties: {
+                    schema_id: {
+                        const: string;
+                    };
+                    file_name: {
+                        type: string;
+                        pattern: string;
+                    };
+                    sha256: {
+                        $ref: string;
+                    };
+                    bytes: {
+                        $ref: string;
+                    };
+                    retained_record_count: {
+                        $ref: string;
+                    };
+                    total_record_count: {
+                        $ref: string;
+                    };
+                    omitted_record_count: {
+                        $ref: string;
+                    };
+                    complete: {
+                        type: string;
+                    };
+                    disposition_complete: {
+                        type: string;
+                    };
+                    fresh_target_count: {
+                        $ref: string;
+                    };
+                    inactive_target_count: {
+                        $ref: string;
+                    };
+                    disqualifying_target_count: {
+                        $ref: string;
+                    };
+                    omitted_target_disposition_count: {
+                        $ref: string;
+                    };
+                    state_count: {
+                        $ref: string;
+                    };
+                };
+            };
+            clockLedger: {
+                allOf: ({
+                    $ref: string;
+                    type?: undefined;
+                    properties?: undefined;
+                    required?: undefined;
+                    not?: undefined;
+                } | {
+                    type: string;
+                    properties: {
+                        disposition_complete: {};
+                        fresh_target_count: {};
+                        inactive_target_count: {};
+                        disqualifying_target_count: {};
+                        omitted_target_disposition_count: {};
+                        state_count: {};
+                    };
+                    required: string[];
+                    not: {
+                        type: string;
+                        properties: {
+                            state_count: {};
+                        };
+                        required: string[];
+                    };
+                    $ref?: undefined;
+                })[];
+            };
+            tapeLedger: {
+                allOf: ({
+                    $ref: string;
+                    type?: undefined;
+                    properties?: undefined;
+                    required?: undefined;
+                    not?: undefined;
+                } | {
+                    type: string;
+                    properties: {
+                        state_count: {};
+                        disposition_complete: {};
+                        fresh_target_count: {};
+                        inactive_target_count: {};
+                        disqualifying_target_count: {};
+                        omitted_target_disposition_count: {};
+                    };
+                    required: string[];
+                    not: {
+                        type: string;
+                        anyOf: ({
+                            type: string;
+                            properties: {
+                                disposition_complete: {};
+                                fresh_target_count?: undefined;
+                                inactive_target_count?: undefined;
+                                disqualifying_target_count?: undefined;
+                                omitted_target_disposition_count?: undefined;
+                            };
+                            required: string[];
+                        } | {
+                            type: string;
+                            properties: {
+                                fresh_target_count: {};
+                                disposition_complete?: undefined;
+                                inactive_target_count?: undefined;
+                                disqualifying_target_count?: undefined;
+                                omitted_target_disposition_count?: undefined;
+                            };
+                            required: string[];
+                        } | {
+                            type: string;
+                            properties: {
+                                inactive_target_count: {};
+                                disposition_complete?: undefined;
+                                fresh_target_count?: undefined;
+                                disqualifying_target_count?: undefined;
+                                omitted_target_disposition_count?: undefined;
+                            };
+                            required: string[];
+                        } | {
+                            type: string;
+                            properties: {
+                                disqualifying_target_count: {};
+                                disposition_complete?: undefined;
+                                fresh_target_count?: undefined;
+                                inactive_target_count?: undefined;
+                                omitted_target_disposition_count?: undefined;
+                            };
+                            required: string[];
+                        } | {
+                            type: string;
+                            properties: {
+                                omitted_target_disposition_count: {};
+                                disposition_complete?: undefined;
+                                fresh_target_count?: undefined;
+                                inactive_target_count?: undefined;
+                                disqualifying_target_count?: undefined;
+                            };
+                            required: string[];
+                        })[];
+                    };
+                    $ref?: undefined;
+                })[];
+            };
+            evidenceDescriptor: {
+                type: string;
+                additionalProperties: boolean;
+                required: string[];
+                properties: {
+                    kind: {
+                        enum: string[];
+                    };
+                    file_name: {
+                        type: string;
+                        pattern: string;
+                    };
+                    sha256: {
+                        $ref: string;
+                    };
+                    bytes: {
+                        $ref: string;
+                    };
+                };
+            };
+            exportResultDescriptor: {
+                type: string;
+                additionalProperties: boolean;
+                required: string[];
+                properties: {
+                    schema_id: {
+                        const: string;
+                    };
+                    file_name: {
+                        type: string;
+                        pattern: string;
+                    };
+                    sha256: {
+                        $ref: string;
+                    };
+                    bytes: {
+                        $ref: string;
+                    };
+                    result_sha256: {
+                        $ref: string;
+                    };
+                };
+            };
+            initializer: {
+                type: string;
+                additionalProperties: boolean;
+                required: string[];
+                properties: {
+                    canonical_snapshot_id: {
+                        $ref: string;
+                    };
+                    source_time_ms: {
+                        $ref: string;
+                    };
+                    sequence: {
+                        type: string;
+                        pattern: string;
+                    };
+                    semantic_stream_position: {
+                        const: number;
+                    };
+                };
+            };
+            clockOutcome: {
+                oneOf: ({
+                    type: string;
+                    additionalProperties: boolean;
+                    required: string[];
+                    properties: {
+                        status: {
+                            const: string;
+                        };
+                        reason: {
+                            const: string;
+                            enum?: undefined;
+                        };
+                        partial_evidence: {
+                            type: string;
+                            items: {
+                                $ref: string;
+                            };
+                        };
+                        exporter_result: {
+                            type: string;
+                        };
+                    };
+                } | {
+                    type: string;
+                    additionalProperties: boolean;
+                    required: string[];
+                    properties: {
+                        status: {
+                            const: string;
+                        };
+                        reason: {
+                            enum: string[];
+                            const?: undefined;
+                        };
+                        partial_evidence: {
+                            type: string;
+                            items: {
+                                $ref: string;
+                            };
+                        };
+                        exporter_result: {
+                            type: string;
+                        };
+                    };
+                })[];
+            };
+            tapeOutcome: {
+                oneOf: ({
+                    type: string;
+                    additionalProperties: boolean;
+                    required: string[];
+                    properties: {
+                        status: {
+                            const: string;
+                        };
+                        reason: {
+                            const: string;
+                            enum?: undefined;
+                        };
+                        partial_evidence: {
+                            type: string;
+                            items: {
+                                $ref: string;
+                            };
+                        };
+                        exporter_result: {
+                            $ref: string;
+                            type?: undefined;
+                        };
+                    };
+                } | {
+                    type: string;
+                    additionalProperties: boolean;
+                    required: string[];
+                    properties: {
+                        status: {
+                            const: string;
+                        };
+                        reason: {
+                            enum: string[];
+                            const?: undefined;
+                        };
+                        partial_evidence: {
+                            type: string;
+                            items: {
+                                $ref: string;
+                            };
+                        };
+                        exporter_result: {
+                            type: string;
+                            $ref?: undefined;
+                        };
+                    };
+                })[];
+            };
+        };
+    };
+}>[];
+export declare const PREPARATION_SCHEMA_MANIFEST_V3: Readonly<{
+    manifest_sha256: string;
+    schema_id: "https://schemas.usher.so/market-data-vendor-backfill-schema-manifest/v3";
+    artifacts: {
+        schema_id: string;
+        path: "schemas/backfill-request-v1.schema.json" | "schemas/backfill-result-v2.schema.json" | "schemas/required-clock-v1.schema.json" | "schemas/archive-selection-v1.schema.json" | "schemas/promotion-receipt-v1.schema.json" | "schemas/canonical-orderbook-export-request-v1.schema.json" | "schemas/canonical-orderbook-export-result-v2.schema.json" | "schemas/preparation-product-pin-v2.schema.json" | "schemas/order-book-levels-parquet-projection-v1.schema.json" | "schemas/order-book-depth-summary-parquet-projection-v1.schema.json" | "schemas/source-forensics-ledger-v1.schema.json" | "schemas/source-qualification-record-v1.schema.json";
+        schema_sha256: string;
+    }[];
+}>;
+export declare const ORDER_BOOK_LEVELS_PARQUET_PROJECTION: Readonly<{
+    $schema: string;
+    $id: string;
+    title: string;
+    canonical_schema_id: string;
+    file_name: string;
+    parquet_metadata: {
+        key_value_metadata: never[];
+    };
+    columns: ({
+        name: string;
+        physical_type: string;
+        logical_type: string;
+        nullable: boolean;
+    } | {
+        name: string;
+        physical_type: string;
+        logical_type: null;
+        nullable: boolean;
+    })[];
+    metadata: {
+        "cex.canonical_schema_id": string;
+        "cex.projection_schema_id": string;
+    };
+}>;
+export declare const ORDER_BOOK_DEPTH_SUMMARY_PARQUET_PROJECTION: Readonly<{
+    $schema: string;
+    $id: string;
+    title: string;
+    canonical_schema_id: string;
+    file_name: string;
+    parquet_metadata: {
+        key_value_metadata: never[];
+    };
+    columns: ({
+        name: string;
+        physical_type: string;
+        logical_type: string;
+        nullable: boolean;
+    } | {
+        name: string;
+        physical_type: string;
+        logical_type: null;
+        nullable: boolean;
+    })[];
+    metadata: {
+        "cex.canonical_schema_id": string;
+        "cex.projection_schema_id": string;
+    };
 }>;
+export declare const ORDER_BOOK_LEVELS_PARQUET_PROJECTION_SCHEMA_SHA256: string;
+export declare const ORDER_BOOK_DEPTH_SUMMARY_PARQUET_PROJECTION_SCHEMA_SHA256: string;
 export {};