@sequenceholdings/pipeline-spec 0.1.0

package/dist/envelope.d.ts

@@ -0,0 +1,1241 @@
+import { z } from 'zod';
+/**
+ * The stage envelope — the kind-agnostic contract every stage carries:
+ * identity, ownership, reliability posture, deploy targets, and operations.
+ * The typed bodies (ingestion / transformation / serving) hang off the `type`
+ * discriminator.
+ *
+ * Everything here is **portable**: symbolic references only (credential
+ * families, alert channels, worker machines). Resolution against a deploy
+ * target's facts happens in `resolveSpec`.
+ */
+export declare const stageIdSchema: z.ZodString;
+export declare const deployTargetSchema: z.ZodString;
+export declare const CRITICALITIES: readonly ["critical", "standard", "experimental"];
+export declare const criticalitySchema: z.ZodEnum<{
+    critical: "critical";
+    standard: "standard";
+    experimental: "experimental";
+}>;
+export type Criticality = z.infer<typeof criticalitySchema>;
+/**
+ * Remediation posture when the platform detects a contract/reliability
+ * failure (carried over from the pipeline-observability contract vocabulary):
+ * `manual_only` (default) — page a human; `draft_pr_allowlisted` — the
+ * platform may draft a fix PR touching allowlisted paths; `disabled` — no
+ * automated remediation, alerts only.
+ */
+export declare const REMEDIATION_POSTURES: readonly ["manual_only", "draft_pr_allowlisted", "disabled"];
+export declare const remediationPostureSchema: z.ZodEnum<{
+    manual_only: "manual_only";
+    draft_pr_allowlisted: "draft_pr_allowlisted";
+    disabled: "disabled";
+}>;
+export type RemediationPosture = z.infer<typeof remediationPostureSchema>;
+/** Reliability targets. Both optional — criticality drives which are required by policy, not schema. */
+export declare const slosSchema: z.ZodObject<{
+    freshness: z.ZodOptional<z.ZodString>;
+    max_duration: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type Slos = z.infer<typeof slosSchema>;
+/** Symbolic alert channel references — bound to concrete routes by `resolveSpec`. */
+export declare const alertsSchema: z.ZodObject<{
+    channels: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export type Alerts = z.infer<typeof alertsSchema>;
+export declare const ingestionStageSchema: z.ZodObject<{
+    runtime: z.ZodEnum<{
+        databricks: "databricks";
+        "edge-worker": "edge-worker";
+        upload: "upload";
+    }>;
+    worker: z.ZodOptional<z.ZodObject<{
+        machine: z.ZodString;
+        data_source: z.ZodString;
+        credential: z.ZodString;
+        operation: z.ZodOptional<z.ZodString>;
+        max_concurrent: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    source: z.ZodOptional<z.ZodObject<{
+        system: z.ZodString;
+        credential: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    materializer: z.ZodOptional<z.ZodObject<{
+        max_concurrent: z.ZodNumber;
+        strategy: z.ZodOptional<z.ZodEnum<{
+            per_feed: "per_feed";
+            sharded: "sharded";
+        }>>;
+    }, z.core.$strict>>;
+    feeds: z.ZodRecord<z.ZodString, z.ZodObject<{
+        columns: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            description: z.ZodString;
+        }, z.core.$strict>>>;
+        documentation_ref: z.ZodOptional<z.ZodString>;
+        snapshot_mode: z.ZodEnum<{
+            full_snapshot: "full_snapshot";
+            incremental: "incremental";
+            event_stream: "event_stream";
+        }>;
+        natural_key: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        cursor: z.ZodOptional<z.ZodObject<{
+            column: z.ZodString;
+            encoding: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        pii: z.ZodDefault<z.ZodEnum<{
+            none: "none";
+            contains_pii: "contains_pii";
+        }>>;
+        format: z.ZodOptional<z.ZodEnum<{
+            json: "json";
+            custom: "custom";
+            parquet: "parquet";
+            csv: "csv";
+            xlsx: "xlsx";
+        }>>;
+        decoder: z.ZodOptional<z.ZodString>;
+        extraction: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+        freshness_slo: z.ZodOptional<z.ZodString>;
+        optional: z.ZodOptional<z.ZodBoolean>;
+        description: z.ZodOptional<z.ZodString>;
+        column_descriptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strict>>;
+    schedule: z.ZodOptional<z.ZodObject<{
+        cron: z.ZodString;
+        tz: z.ZodString;
+        policy: z.ZodOptional<z.ZodObject<{
+            singleton: z.ZodOptional<z.ZodBoolean>;
+            exclusion_group: z.ZodOptional<z.ZodString>;
+            timeout_minutes: z.ZodOptional<z.ZodNumber>;
+            mutates: z.ZodOptional<z.ZodBoolean>;
+            cooldown_minutes: z.ZodOptional<z.ZodNumber>;
+            requires_approval: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    freshness_slo: z.ZodOptional<z.ZodString>;
+    retention: z.ZodOptional<z.ZodString>;
+    entrypoint: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"ingestion">;
+    schema_version: z.ZodLiteral<1>;
+    stage: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodString;
+    owners: z.ZodArray<z.ZodEmail>;
+    criticality: z.ZodEnum<{
+        critical: "critical";
+        standard: "standard";
+        experimental: "experimental";
+    }>;
+    slos: z.ZodOptional<z.ZodObject<{
+        freshness: z.ZodOptional<z.ZodString>;
+        max_duration: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    alerts: z.ZodOptional<z.ZodObject<{
+        channels: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+    runbook: z.ZodOptional<z.ZodURL>;
+    remediation_posture: z.ZodDefault<z.ZodEnum<{
+        manual_only: "manual_only";
+        draft_pr_allowlisted: "draft_pr_allowlisted";
+        disabled: "disabled";
+    }>>;
+    environments: z.ZodArray<z.ZodString>;
+    operations: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        description: z.ZodString;
+        params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodObject<{
+            type: z.ZodLiteral<"enum">;
+            description: z.ZodOptional<z.ZodString>;
+            values: z.ZodArray<z.ZodString>;
+            optional: z.ZodDefault<z.ZodBoolean>;
+            default: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"array">;
+            description: z.ZodOptional<z.ZodString>;
+            items: z.ZodEnum<{
+                string: "string";
+                boolean: "boolean";
+                uuid: "uuid";
+                int: "int";
+                long: "long";
+                numeric: "numeric";
+                double: "double";
+                timestamp: "timestamp";
+                date: "date";
+            }>;
+            optional: z.ZodDefault<z.ZodBoolean>;
+            default: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+            min_items: z.ZodOptional<z.ZodNumber>;
+            max_items: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodEnum<{
+                string: "string";
+                boolean: "boolean";
+                uuid: "uuid";
+                int: "int";
+                long: "long";
+                numeric: "numeric";
+                double: "double";
+                timestamp: "timestamp";
+                date: "date";
+            }>;
+            description: z.ZodOptional<z.ZodString>;
+            optional: z.ZodDefault<z.ZodBoolean>;
+            default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+        }, z.core.$strict>]>>>;
+        policy: z.ZodDefault<z.ZodObject<{
+            singleton: z.ZodOptional<z.ZodBoolean>;
+            exclusion_group: z.ZodOptional<z.ZodString>;
+            timeout_minutes: z.ZodOptional<z.ZodNumber>;
+            mutates: z.ZodOptional<z.ZodBoolean>;
+            cooldown_minutes: z.ZodOptional<z.ZodNumber>;
+            requires_approval: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>;
+        entrypoint: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export declare const transformationStageSchema: z.ZodObject<{
+    engine: z.ZodEnum<{
+        dlt: "dlt";
+        "spark-job": "spark-job";
+        polars: "polars";
+    }>;
+    inputs: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        kind: z.ZodLiteral<"lakebase_cdf">;
+        table: z.ZodString;
+        columns: z.ZodUnion<readonly [z.ZodObject<{
+            schema_ref: z.ZodString;
+        }, z.core.$strict>, z.ZodRecord<z.ZodString, z.ZodObject<{
+            type: z.ZodUnion<readonly [z.ZodEnum<{
+                string: "string";
+                boolean: "boolean";
+                uuid: "uuid";
+                int: "int";
+                long: "long";
+                numeric: "numeric";
+                double: "double";
+                timestamp: "timestamp";
+                date: "date";
+                json: "json";
+            }>, z.ZodEnum<{
+                float: "float";
+                timestamp_ntz: "timestamp_ntz";
+                array: "array";
+                map: "map";
+                struct: "struct";
+                binary: "binary";
+            }>, z.ZodString]>;
+            nullable: z.ZodDefault<z.ZodBoolean>;
+            key: z.ZodDefault<z.ZodBoolean>;
+            domain: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+            description: z.ZodOptional<z.ZodString>;
+            on_violation: z.ZodDefault<z.ZodEnum<{
+                fail: "fail";
+                quarantine: "quarantine";
+                warn: "warn";
+            }>>;
+        }, z.core.$strict>>]>;
+        fold: z.ZodEnum<{
+            latest_state: "latest_state";
+            events: "events";
+        }>;
+    }, z.core.$strict>, z.ZodObject<{
+        stage: z.ZodString;
+        feed: z.ZodOptional<z.ZodString>;
+        output: z.ZodOptional<z.ZodString>;
+        columns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        freshness_requirement: z.ZodOptional<z.ZodString>;
+        declared_loose: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>]>>;
+    trigger: z.ZodObject<{
+        manual: z.ZodOptional<z.ZodLiteral<true>>;
+        cron: z.ZodOptional<z.ZodString>;
+        after: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        refresh_serving: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>;
+    outputs: z.ZodRecord<z.ZodString, z.ZodObject<{
+        description: z.ZodOptional<z.ZodString>;
+        columns: z.ZodUnion<readonly [z.ZodObject<{
+            schema_ref: z.ZodString;
+        }, z.core.$strict>, z.ZodRecord<z.ZodString, z.ZodObject<{
+            type: z.ZodUnion<readonly [z.ZodEnum<{
+                string: "string";
+                boolean: "boolean";
+                uuid: "uuid";
+                int: "int";
+                long: "long";
+                numeric: "numeric";
+                double: "double";
+                timestamp: "timestamp";
+                date: "date";
+                json: "json";
+            }>, z.ZodEnum<{
+                float: "float";
+                timestamp_ntz: "timestamp_ntz";
+                array: "array";
+                map: "map";
+                struct: "struct";
+                binary: "binary";
+            }>, z.ZodString]>;
+            nullable: z.ZodDefault<z.ZodBoolean>;
+            key: z.ZodDefault<z.ZodBoolean>;
+            domain: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+            description: z.ZodOptional<z.ZodString>;
+            on_violation: z.ZodDefault<z.ZodEnum<{
+                fail: "fail";
+                quarantine: "quarantine";
+                warn: "warn";
+            }>>;
+        }, z.core.$strict>>]>;
+        on_type_violation: z.ZodDefault<z.ZodEnum<{
+            fail: "fail";
+            quarantine: "quarantine";
+            warn: "warn";
+        }>>;
+        compatibility: z.ZodDefault<z.ZodEnum<{
+            "additive-only": "additive-only";
+            versioned: "versioned";
+        }>>;
+        write_pattern: z.ZodEnum<{
+            overwrite: "overwrite";
+            append: "append";
+            auto_cdc: "auto_cdc";
+        }>;
+        write_scope: z.ZodOptional<z.ZodObject<{
+            column: z.ZodString;
+            value: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    entrypoint: z.ZodString;
+    config: z.ZodOptional<z.ZodObject<{
+        catalog: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            default: z.ZodString;
+            by_target: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>]>>;
+        history_catalog: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            default: z.ZodString;
+            by_target: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>]>>;
+        silver_catalog: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            default: z.ZodString;
+            by_target: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>]>>;
+        python_environment_version: z.ZodOptional<z.ZodEnum<{
+            3: "3";
+            4: "4";
+        }>>;
+    }, z.core.$catchall<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>>;
+    type: z.ZodLiteral<"transformation">;
+    schema_version: z.ZodLiteral<1>;
+    stage: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodString;
+    owners: z.ZodArray<z.ZodEmail>;
+    criticality: z.ZodEnum<{
+        critical: "critical";
+        standard: "standard";
+        experimental: "experimental";
+    }>;
+    slos: z.ZodOptional<z.ZodObject<{
+        freshness: z.ZodOptional<z.ZodString>;
+        max_duration: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    alerts: z.ZodOptional<z.ZodObject<{
+        channels: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+    runbook: z.ZodOptional<z.ZodURL>;
+    remediation_posture: z.ZodDefault<z.ZodEnum<{
+        manual_only: "manual_only";
+        draft_pr_allowlisted: "draft_pr_allowlisted";
+        disabled: "disabled";
+    }>>;
+    environments: z.ZodArray<z.ZodString>;
+    operations: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        description: z.ZodString;
+        params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodObject<{
+            type: z.ZodLiteral<"enum">;
+            description: z.ZodOptional<z.ZodString>;
+            values: z.ZodArray<z.ZodString>;
+            optional: z.ZodDefault<z.ZodBoolean>;
+            default: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"array">;
+            description: z.ZodOptional<z.ZodString>;
+            items: z.ZodEnum<{
+                string: "string";
+                boolean: "boolean";
+                uuid: "uuid";
+                int: "int";
+                long: "long";
+                numeric: "numeric";
+                double: "double";
+                timestamp: "timestamp";
+                date: "date";
+            }>;
+            optional: z.ZodDefault<z.ZodBoolean>;
+            default: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+            min_items: z.ZodOptional<z.ZodNumber>;
+            max_items: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodEnum<{
+                string: "string";
+                boolean: "boolean";
+                uuid: "uuid";
+                int: "int";
+                long: "long";
+                numeric: "numeric";
+                double: "double";
+                timestamp: "timestamp";
+                date: "date";
+            }>;
+            description: z.ZodOptional<z.ZodString>;
+            optional: z.ZodDefault<z.ZodBoolean>;
+            default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+        }, z.core.$strict>]>>>;
+        policy: z.ZodDefault<z.ZodObject<{
+            singleton: z.ZodOptional<z.ZodBoolean>;
+            exclusion_group: z.ZodOptional<z.ZodString>;
+            timeout_minutes: z.ZodOptional<z.ZodNumber>;
+            mutates: z.ZodOptional<z.ZodBoolean>;
+            cooldown_minutes: z.ZodOptional<z.ZodNumber>;
+            requires_approval: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>;
+        entrypoint: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export declare const servingStageSchema: z.ZodObject<{
+    transport: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"native_lakebase_sync_v1">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"postgres_snapshot_landing_v1">;
+        binding: z.ZodString;
+        database: z.ZodString;
+        entity: z.ZodString;
+        landing: z.ZodObject<{
+            schema: z.ZodString;
+            relation: z.ZodString;
+        }, z.core.$strict>;
+        buffer: z.ZodObject<{
+            schema: z.ZodString;
+            relation: z.ZodString;
+        }, z.core.$strict>;
+        full_source_columns: z.ZodRecord<z.ZodString, z.ZodObject<{
+            type: z.ZodUnion<readonly [z.ZodEnum<{
+                string: "string";
+                boolean: "boolean";
+                uuid: "uuid";
+                int: "int";
+                long: "long";
+                numeric: "numeric";
+                double: "double";
+                timestamp: "timestamp";
+                date: "date";
+                json: "json";
+            }>, z.ZodEnum<{
+                float: "float";
+                timestamp_ntz: "timestamp_ntz";
+                array: "array";
+                map: "map";
+                struct: "struct";
+                binary: "binary";
+            }>, z.ZodString]>;
+            nullable: z.ZodDefault<z.ZodBoolean>;
+            key: z.ZodDefault<z.ZodBoolean>;
+            domain: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+            description: z.ZodOptional<z.ZodString>;
+            on_violation: z.ZodDefault<z.ZodEnum<{
+                fail: "fail";
+                quarantine: "quarantine";
+                warn: "warn";
+            }>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>], "kind">>;
+    source: z.ZodObject<{
+        stage: z.ZodString;
+        output: z.ZodString;
+        catalog: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            default: z.ZodString;
+            by_target: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>]>>;
+        external: z.ZodOptional<z.ZodLiteral<true>>;
+        columns: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            type: z.ZodUnion<readonly [z.ZodEnum<{
+                string: "string";
+                boolean: "boolean";
+                uuid: "uuid";
+                int: "int";
+                long: "long";
+                numeric: "numeric";
+                double: "double";
+                timestamp: "timestamp";
+                date: "date";
+                json: "json";
+            }>, z.ZodEnum<{
+                float: "float";
+                timestamp_ntz: "timestamp_ntz";
+                array: "array";
+                map: "map";
+                struct: "struct";
+                binary: "binary";
+            }>, z.ZodString]>;
+            nullable: z.ZodDefault<z.ZodBoolean>;
+            key: z.ZodDefault<z.ZodBoolean>;
+            domain: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+            description: z.ZodOptional<z.ZodString>;
+            on_violation: z.ZodDefault<z.ZodEnum<{
+                fail: "fail";
+                quarantine: "quarantine";
+                warn: "warn";
+            }>>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>;
+    projection: z.ZodObject<{
+        columns: z.ZodUnion<readonly [z.ZodObject<{
+            schema_ref: z.ZodString;
+        }, z.core.$strict>, z.ZodRecord<z.ZodString, z.ZodObject<{
+            type: z.ZodUnion<readonly [z.ZodEnum<{
+                string: "string";
+                boolean: "boolean";
+                uuid: "uuid";
+                int: "int";
+                long: "long";
+                numeric: "numeric";
+                double: "double";
+                timestamp: "timestamp";
+                date: "date";
+                json: "json";
+            }>, z.ZodEnum<{
+                float: "float";
+                timestamp_ntz: "timestamp_ntz";
+                array: "array";
+                map: "map";
+                struct: "struct";
+                binary: "binary";
+            }>, z.ZodString]>;
+            nullable: z.ZodDefault<z.ZodBoolean>;
+            key: z.ZodDefault<z.ZodBoolean>;
+            domain: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+            description: z.ZodOptional<z.ZodString>;
+            on_violation: z.ZodDefault<z.ZodEnum<{
+                fail: "fail";
+                quarantine: "quarantine";
+                warn: "warn";
+            }>>;
+        }, z.core.$strict>>]>;
+        primary_key: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>;
+    sync_mode: z.ZodEnum<{
+        SNAPSHOT: "SNAPSHOT";
+        TRIGGERED: "TRIGGERED";
+        CONTINUOUS: "CONTINUOUS";
+    }>;
+    trigger: z.ZodOptional<z.ZodObject<{
+        after: z.ZodString;
+    }, z.core.$strict>>;
+    expose: z.ZodObject<{
+        view: z.ZodString;
+        public_view_access: z.ZodOptional<z.ZodEnum<{
+            standard: "standard";
+            reporting: "reporting";
+            owner_only: "owner_only";
+            orm_only: "orm_only";
+        }>>;
+        orm_only_schema: z.ZodOptional<z.ZodString>;
+        orm_only_catalog: z.ZodOptional<z.ZodString>;
+        reporting_table: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    orm_binding: z.ZodOptional<z.ZodObject<{
+        namespace: z.ZodString;
+        table: z.ZodString;
+        mode: z.ZodEnum<{
+            referenced: "referenced";
+            managed: "managed";
+        }>;
+    }, z.core.$strict>>;
+    satisfies: z.ZodOptional<z.ZodObject<{
+        namespace: z.ZodString;
+        table: z.ZodString;
+        content_hash: z.ZodString;
+    }, z.core.$strict>>;
+    type: z.ZodLiteral<"serving">;
+    schema_version: z.ZodLiteral<1>;
+    stage: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodString;
+    owners: z.ZodArray<z.ZodEmail>;
+    criticality: z.ZodEnum<{
+        critical: "critical";
+        standard: "standard";
+        experimental: "experimental";
+    }>;
+    slos: z.ZodOptional<z.ZodObject<{
+        freshness: z.ZodOptional<z.ZodString>;
+        max_duration: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    alerts: z.ZodOptional<z.ZodObject<{
+        channels: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+    runbook: z.ZodOptional<z.ZodURL>;
+    remediation_posture: z.ZodDefault<z.ZodEnum<{
+        manual_only: "manual_only";
+        draft_pr_allowlisted: "draft_pr_allowlisted";
+        disabled: "disabled";
+    }>>;
+    environments: z.ZodArray<z.ZodString>;
+    operations: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        description: z.ZodString;
+        params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodObject<{
+            type: z.ZodLiteral<"enum">;
+            description: z.ZodOptional<z.ZodString>;
+            values: z.ZodArray<z.ZodString>;
+            optional: z.ZodDefault<z.ZodBoolean>;
+            default: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"array">;
+            description: z.ZodOptional<z.ZodString>;
+            items: z.ZodEnum<{
+                string: "string";
+                boolean: "boolean";
+                uuid: "uuid";
+                int: "int";
+                long: "long";
+                numeric: "numeric";
+                double: "double";
+                timestamp: "timestamp";
+                date: "date";
+            }>;
+            optional: z.ZodDefault<z.ZodBoolean>;
+            default: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+            min_items: z.ZodOptional<z.ZodNumber>;
+            max_items: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodEnum<{
+                string: "string";
+                boolean: "boolean";
+                uuid: "uuid";
+                int: "int";
+                long: "long";
+                numeric: "numeric";
+                double: "double";
+                timestamp: "timestamp";
+                date: "date";
+            }>;
+            description: z.ZodOptional<z.ZodString>;
+            optional: z.ZodDefault<z.ZodBoolean>;
+            default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+        }, z.core.$strict>]>>>;
+        policy: z.ZodDefault<z.ZodObject<{
+            singleton: z.ZodOptional<z.ZodBoolean>;
+            exclusion_group: z.ZodOptional<z.ZodString>;
+            timeout_minutes: z.ZodOptional<z.ZodNumber>;
+            mutates: z.ZodOptional<z.ZodBoolean>;
+            cooldown_minutes: z.ZodOptional<z.ZodNumber>;
+            requires_approval: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>;
+        entrypoint: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+/**
+ * A full stage spec: envelope + typed body, discriminated on `type`.
+ * The single source of truth for spec shapes — all TS types are inferred.
+ */
+export declare const stageSpecSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    runtime: z.ZodEnum<{
+        databricks: "databricks";
+        "edge-worker": "edge-worker";
+        upload: "upload";
+    }>;
+    worker: z.ZodOptional<z.ZodObject<{
+        machine: z.ZodString;
+        data_source: z.ZodString;
+        credential: z.ZodString;
+        operation: z.ZodOptional<z.ZodString>;
+        max_concurrent: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    source: z.ZodOptional<z.ZodObject<{
+        system: z.ZodString;
+        credential: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    materializer: z.ZodOptional<z.ZodObject<{
+        max_concurrent: z.ZodNumber;
+        strategy: z.ZodOptional<z.ZodEnum<{
+            per_feed: "per_feed";
+            sharded: "sharded";
+        }>>;
+    }, z.core.$strict>>;
+    feeds: z.ZodRecord<z.ZodString, z.ZodObject<{
+        columns: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            description: z.ZodString;
+        }, z.core.$strict>>>;
+        documentation_ref: z.ZodOptional<z.ZodString>;
+        snapshot_mode: z.ZodEnum<{
+            full_snapshot: "full_snapshot";
+            incremental: "incremental";
+            event_stream: "event_stream";
+        }>;
+        natural_key: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        cursor: z.ZodOptional<z.ZodObject<{
+            column: z.ZodString;
+            encoding: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        pii: z.ZodDefault<z.ZodEnum<{
+            none: "none";
+            contains_pii: "contains_pii";
+        }>>;
+        format: z.ZodOptional<z.ZodEnum<{
+            json: "json";
+            custom: "custom";
+            parquet: "parquet";
+            csv: "csv";
+            xlsx: "xlsx";
+        }>>;
+        decoder: z.ZodOptional<z.ZodString>;
+        extraction: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+        freshness_slo: z.ZodOptional<z.ZodString>;
+        optional: z.ZodOptional<z.ZodBoolean>;
+        description: z.ZodOptional<z.ZodString>;
+        column_descriptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strict>>;
+    schedule: z.ZodOptional<z.ZodObject<{
+        cron: z.ZodString;
+        tz: z.ZodString;
+        policy: z.ZodOptional<z.ZodObject<{
+            singleton: z.ZodOptional<z.ZodBoolean>;
+            exclusion_group: z.ZodOptional<z.ZodString>;
+            timeout_minutes: z.ZodOptional<z.ZodNumber>;
+            mutates: z.ZodOptional<z.ZodBoolean>;
+            cooldown_minutes: z.ZodOptional<z.ZodNumber>;
+            requires_approval: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    freshness_slo: z.ZodOptional<z.ZodString>;
+    retention: z.ZodOptional<z.ZodString>;
+    entrypoint: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"ingestion">;
+    schema_version: z.ZodLiteral<1>;
+    stage: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodString;
+    owners: z.ZodArray<z.ZodEmail>;
+    criticality: z.ZodEnum<{
+        critical: "critical";
+        standard: "standard";
+        experimental: "experimental";
+    }>;
+    slos: z.ZodOptional<z.ZodObject<{
+        freshness: z.ZodOptional<z.ZodString>;
+        max_duration: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    alerts: z.ZodOptional<z.ZodObject<{
+        channels: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+    runbook: z.ZodOptional<z.ZodURL>;
+    remediation_posture: z.ZodDefault<z.ZodEnum<{
+        manual_only: "manual_only";
+        draft_pr_allowlisted: "draft_pr_allowlisted";
+        disabled: "disabled";
+    }>>;
+    environments: z.ZodArray<z.ZodString>;
+    operations: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        description: z.ZodString;
+        params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodObject<{
+            type: z.ZodLiteral<"enum">;
+            description: z.ZodOptional<z.ZodString>;
+            values: z.ZodArray<z.ZodString>;
+            optional: z.ZodDefault<z.ZodBoolean>;
+            default: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"array">;
+            description: z.ZodOptional<z.ZodString>;
+            items: z.ZodEnum<{
+                string: "string";
+                boolean: "boolean";
+                uuid: "uuid";
+                int: "int";
+                long: "long";
+                numeric: "numeric";
+                double: "double";
+                timestamp: "timestamp";
+                date: "date";
+            }>;
+            optional: z.ZodDefault<z.ZodBoolean>;
+            default: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+            min_items: z.ZodOptional<z.ZodNumber>;
+            max_items: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodEnum<{
+                string: "string";
+                boolean: "boolean";
+                uuid: "uuid";
+                int: "int";
+                long: "long";
+                numeric: "numeric";
+                double: "double";
+                timestamp: "timestamp";
+                date: "date";
+            }>;
+            description: z.ZodOptional<z.ZodString>;
+            optional: z.ZodDefault<z.ZodBoolean>;
+            default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+        }, z.core.$strict>]>>>;
+        policy: z.ZodDefault<z.ZodObject<{
+            singleton: z.ZodOptional<z.ZodBoolean>;
+            exclusion_group: z.ZodOptional<z.ZodString>;
+            timeout_minutes: z.ZodOptional<z.ZodNumber>;
+            mutates: z.ZodOptional<z.ZodBoolean>;
+            cooldown_minutes: z.ZodOptional<z.ZodNumber>;
+            requires_approval: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>;
+        entrypoint: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>, z.ZodObject<{
+    engine: z.ZodEnum<{
+        dlt: "dlt";
+        "spark-job": "spark-job";
+        polars: "polars";
+    }>;
+    inputs: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        kind: z.ZodLiteral<"lakebase_cdf">;
+        table: z.ZodString;
+        columns: z.ZodUnion<readonly [z.ZodObject<{
+            schema_ref: z.ZodString;
+        }, z.core.$strict>, z.ZodRecord<z.ZodString, z.ZodObject<{
+            type: z.ZodUnion<readonly [z.ZodEnum<{
+                string: "string";
+                boolean: "boolean";
+                uuid: "uuid";
+                int: "int";
+                long: "long";
+                numeric: "numeric";
+                double: "double";
+                timestamp: "timestamp";
+                date: "date";
+                json: "json";
+            }>, z.ZodEnum<{
+                float: "float";
+                timestamp_ntz: "timestamp_ntz";
+                array: "array";
+                map: "map";
+                struct: "struct";
+                binary: "binary";
+            }>, z.ZodString]>;
+            nullable: z.ZodDefault<z.ZodBoolean>;
+            key: z.ZodDefault<z.ZodBoolean>;
+            domain: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+            description: z.ZodOptional<z.ZodString>;
+            on_violation: z.ZodDefault<z.ZodEnum<{
+                fail: "fail";
+                quarantine: "quarantine";
+                warn: "warn";
+            }>>;
+        }, z.core.$strict>>]>;
+        fold: z.ZodEnum<{
+            latest_state: "latest_state";
+            events: "events";
+        }>;
+    }, z.core.$strict>, z.ZodObject<{
+        stage: z.ZodString;
+        feed: z.ZodOptional<z.ZodString>;
+        output: z.ZodOptional<z.ZodString>;
+        columns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        freshness_requirement: z.ZodOptional<z.ZodString>;
+        declared_loose: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>]>>;
+    trigger: z.ZodObject<{
+        manual: z.ZodOptional<z.ZodLiteral<true>>;
+        cron: z.ZodOptional<z.ZodString>;
+        after: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        refresh_serving: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>;
+    outputs: z.ZodRecord<z.ZodString, z.ZodObject<{
+        description: z.ZodOptional<z.ZodString>;
+        columns: z.ZodUnion<readonly [z.ZodObject<{
+            schema_ref: z.ZodString;
+        }, z.core.$strict>, z.ZodRecord<z.ZodString, z.ZodObject<{
+            type: z.ZodUnion<readonly [z.ZodEnum<{
+                string: "string";
+                boolean: "boolean";
+                uuid: "uuid";
+                int: "int";
+                long: "long";
+                numeric: "numeric";
+                double: "double";
+                timestamp: "timestamp";
+                date: "date";
+                json: "json";
+            }>, z.ZodEnum<{
+                float: "float";
+                timestamp_ntz: "timestamp_ntz";
+                array: "array";
+                map: "map";
+                struct: "struct";
+                binary: "binary";
+            }>, z.ZodString]>;
+            nullable: z.ZodDefault<z.ZodBoolean>;
+            key: z.ZodDefault<z.ZodBoolean>;
+            domain: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+            description: z.ZodOptional<z.ZodString>;
+            on_violation: z.ZodDefault<z.ZodEnum<{
+                fail: "fail";
+                quarantine: "quarantine";
+                warn: "warn";
+            }>>;
+        }, z.core.$strict>>]>;
+        on_type_violation: z.ZodDefault<z.ZodEnum<{
+            fail: "fail";
+            quarantine: "quarantine";
+            warn: "warn";
+        }>>;
+        compatibility: z.ZodDefault<z.ZodEnum<{
+            "additive-only": "additive-only";
+            versioned: "versioned";
+        }>>;
+        write_pattern: z.ZodEnum<{
+            overwrite: "overwrite";
+            append: "append";
+            auto_cdc: "auto_cdc";
+        }>;
+        write_scope: z.ZodOptional<z.ZodObject<{
+            column: z.ZodString;
+            value: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    entrypoint: z.ZodString;
+    config: z.ZodOptional<z.ZodObject<{
+        catalog: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            default: z.ZodString;
+            by_target: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>]>>;
+        history_catalog: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            default: z.ZodString;
+            by_target: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>]>>;
+        silver_catalog: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            default: z.ZodString;
+            by_target: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>]>>;
+        python_environment_version: z.ZodOptional<z.ZodEnum<{
+            3: "3";
+            4: "4";
+        }>>;
+    }, z.core.$catchall<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>>;
+    type: z.ZodLiteral<"transformation">;
+    schema_version: z.ZodLiteral<1>;
+    stage: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodString;
+    owners: z.ZodArray<z.ZodEmail>;
+    criticality: z.ZodEnum<{
+        critical: "critical";
+        standard: "standard";
+        experimental: "experimental";
+    }>;
+    slos: z.ZodOptional<z.ZodObject<{
+        freshness: z.ZodOptional<z.ZodString>;
+        max_duration: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    alerts: z.ZodOptional<z.ZodObject<{
+        channels: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+    runbook: z.ZodOptional<z.ZodURL>;
+    remediation_posture: z.ZodDefault<z.ZodEnum<{
+        manual_only: "manual_only";
+        draft_pr_allowlisted: "draft_pr_allowlisted";
+        disabled: "disabled";
+    }>>;
+    environments: z.ZodArray<z.ZodString>;
+    operations: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        description: z.ZodString;
+        params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodObject<{
+            type: z.ZodLiteral<"enum">;
+            description: z.ZodOptional<z.ZodString>;
+            values: z.ZodArray<z.ZodString>;
+            optional: z.ZodDefault<z.ZodBoolean>;
+            default: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"array">;
+            description: z.ZodOptional<z.ZodString>;
+            items: z.ZodEnum<{
+                string: "string";
+                boolean: "boolean";
+                uuid: "uuid";
+                int: "int";
+                long: "long";
+                numeric: "numeric";
+                double: "double";
+                timestamp: "timestamp";
+                date: "date";
+            }>;
+            optional: z.ZodDefault<z.ZodBoolean>;
+            default: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+            min_items: z.ZodOptional<z.ZodNumber>;
+            max_items: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodEnum<{
+                string: "string";
+                boolean: "boolean";
+                uuid: "uuid";
+                int: "int";
+                long: "long";
+                numeric: "numeric";
+                double: "double";
+                timestamp: "timestamp";
+                date: "date";
+            }>;
+            description: z.ZodOptional<z.ZodString>;
+            optional: z.ZodDefault<z.ZodBoolean>;
+            default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+        }, z.core.$strict>]>>>;
+        policy: z.ZodDefault<z.ZodObject<{
+            singleton: z.ZodOptional<z.ZodBoolean>;
+            exclusion_group: z.ZodOptional<z.ZodString>;
+            timeout_minutes: z.ZodOptional<z.ZodNumber>;
+            mutates: z.ZodOptional<z.ZodBoolean>;
+            cooldown_minutes: z.ZodOptional<z.ZodNumber>;
+            requires_approval: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>;
+        entrypoint: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>, z.ZodObject<{
+    transport: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"native_lakebase_sync_v1">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"postgres_snapshot_landing_v1">;
+        binding: z.ZodString;
+        database: z.ZodString;
+        entity: z.ZodString;
+        landing: z.ZodObject<{
+            schema: z.ZodString;
+            relation: z.ZodString;
+        }, z.core.$strict>;
+        buffer: z.ZodObject<{
+            schema: z.ZodString;
+            relation: z.ZodString;
+        }, z.core.$strict>;
+        full_source_columns: z.ZodRecord<z.ZodString, z.ZodObject<{
+            type: z.ZodUnion<readonly [z.ZodEnum<{
+                string: "string";
+                boolean: "boolean";
+                uuid: "uuid";
+                int: "int";
+                long: "long";
+                numeric: "numeric";
+                double: "double";
+                timestamp: "timestamp";
+                date: "date";
+                json: "json";
+            }>, z.ZodEnum<{
+                float: "float";
+                timestamp_ntz: "timestamp_ntz";
+                array: "array";
+                map: "map";
+                struct: "struct";
+                binary: "binary";
+            }>, z.ZodString]>;
+            nullable: z.ZodDefault<z.ZodBoolean>;
+            key: z.ZodDefault<z.ZodBoolean>;
+            domain: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+            description: z.ZodOptional<z.ZodString>;
+            on_violation: z.ZodDefault<z.ZodEnum<{
+                fail: "fail";
+                quarantine: "quarantine";
+                warn: "warn";
+            }>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>], "kind">>;
+    source: z.ZodObject<{
+        stage: z.ZodString;
+        output: z.ZodString;
+        catalog: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            default: z.ZodString;
+            by_target: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>]>>;
+        external: z.ZodOptional<z.ZodLiteral<true>>;
+        columns: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            type: z.ZodUnion<readonly [z.ZodEnum<{
+                string: "string";
+                boolean: "boolean";
+                uuid: "uuid";
+                int: "int";
+                long: "long";
+                numeric: "numeric";
+                double: "double";
+                timestamp: "timestamp";
+                date: "date";
+                json: "json";
+            }>, z.ZodEnum<{
+                float: "float";
+                timestamp_ntz: "timestamp_ntz";
+                array: "array";
+                map: "map";
+                struct: "struct";
+                binary: "binary";
+            }>, z.ZodString]>;
+            nullable: z.ZodDefault<z.ZodBoolean>;
+            key: z.ZodDefault<z.ZodBoolean>;
+            domain: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+            description: z.ZodOptional<z.ZodString>;
+            on_violation: z.ZodDefault<z.ZodEnum<{
+                fail: "fail";
+                quarantine: "quarantine";
+                warn: "warn";
+            }>>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>;
+    projection: z.ZodObject<{
+        columns: z.ZodUnion<readonly [z.ZodObject<{
+            schema_ref: z.ZodString;
+        }, z.core.$strict>, z.ZodRecord<z.ZodString, z.ZodObject<{
+            type: z.ZodUnion<readonly [z.ZodEnum<{
+                string: "string";
+                boolean: "boolean";
+                uuid: "uuid";
+                int: "int";
+                long: "long";
+                numeric: "numeric";
+                double: "double";
+                timestamp: "timestamp";
+                date: "date";
+                json: "json";
+            }>, z.ZodEnum<{
+                float: "float";
+                timestamp_ntz: "timestamp_ntz";
+                array: "array";
+                map: "map";
+                struct: "struct";
+                binary: "binary";
+            }>, z.ZodString]>;
+            nullable: z.ZodDefault<z.ZodBoolean>;
+            key: z.ZodDefault<z.ZodBoolean>;
+            domain: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+            description: z.ZodOptional<z.ZodString>;
+            on_violation: z.ZodDefault<z.ZodEnum<{
+                fail: "fail";
+                quarantine: "quarantine";
+                warn: "warn";
+            }>>;
+        }, z.core.$strict>>]>;
+        primary_key: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>;
+    sync_mode: z.ZodEnum<{
+        SNAPSHOT: "SNAPSHOT";
+        TRIGGERED: "TRIGGERED";
+        CONTINUOUS: "CONTINUOUS";
+    }>;
+    trigger: z.ZodOptional<z.ZodObject<{
+        after: z.ZodString;
+    }, z.core.$strict>>;
+    expose: z.ZodObject<{
+        view: z.ZodString;
+        public_view_access: z.ZodOptional<z.ZodEnum<{
+            standard: "standard";
+            reporting: "reporting";
+            owner_only: "owner_only";
+            orm_only: "orm_only";
+        }>>;
+        orm_only_schema: z.ZodOptional<z.ZodString>;
+        orm_only_catalog: z.ZodOptional<z.ZodString>;
+        reporting_table: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    orm_binding: z.ZodOptional<z.ZodObject<{
+        namespace: z.ZodString;
+        table: z.ZodString;
+        mode: z.ZodEnum<{
+            referenced: "referenced";
+            managed: "managed";
+        }>;
+    }, z.core.$strict>>;
+    satisfies: z.ZodOptional<z.ZodObject<{
+        namespace: z.ZodString;
+        table: z.ZodString;
+        content_hash: z.ZodString;
+    }, z.core.$strict>>;
+    type: z.ZodLiteral<"serving">;
+    schema_version: z.ZodLiteral<1>;
+    stage: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodString;
+    owners: z.ZodArray<z.ZodEmail>;
+    criticality: z.ZodEnum<{
+        critical: "critical";
+        standard: "standard";
+        experimental: "experimental";
+    }>;
+    slos: z.ZodOptional<z.ZodObject<{
+        freshness: z.ZodOptional<z.ZodString>;
+        max_duration: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    alerts: z.ZodOptional<z.ZodObject<{
+        channels: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+    runbook: z.ZodOptional<z.ZodURL>;
+    remediation_posture: z.ZodDefault<z.ZodEnum<{
+        manual_only: "manual_only";
+        draft_pr_allowlisted: "draft_pr_allowlisted";
+        disabled: "disabled";
+    }>>;
+    environments: z.ZodArray<z.ZodString>;
+    operations: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        description: z.ZodString;
+        params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodObject<{
+            type: z.ZodLiteral<"enum">;
+            description: z.ZodOptional<z.ZodString>;
+            values: z.ZodArray<z.ZodString>;
+            optional: z.ZodDefault<z.ZodBoolean>;
+            default: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"array">;
+            description: z.ZodOptional<z.ZodString>;
+            items: z.ZodEnum<{
+                string: "string";
+                boolean: "boolean";
+                uuid: "uuid";
+                int: "int";
+                long: "long";
+                numeric: "numeric";
+                double: "double";
+                timestamp: "timestamp";
+                date: "date";
+            }>;
+            optional: z.ZodDefault<z.ZodBoolean>;
+            default: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+            min_items: z.ZodOptional<z.ZodNumber>;
+            max_items: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodEnum<{
+                string: "string";
+                boolean: "boolean";
+                uuid: "uuid";
+                int: "int";
+                long: "long";
+                numeric: "numeric";
+                double: "double";
+                timestamp: "timestamp";
+                date: "date";
+            }>;
+            description: z.ZodOptional<z.ZodString>;
+            optional: z.ZodDefault<z.ZodBoolean>;
+            default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+        }, z.core.$strict>]>>>;
+        policy: z.ZodDefault<z.ZodObject<{
+            singleton: z.ZodOptional<z.ZodBoolean>;
+            exclusion_group: z.ZodOptional<z.ZodString>;
+            timeout_minutes: z.ZodOptional<z.ZodNumber>;
+            mutates: z.ZodOptional<z.ZodBoolean>;
+            cooldown_minutes: z.ZodOptional<z.ZodNumber>;
+            requires_approval: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>;
+        entrypoint: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>], "type">;
+export type StageSpec = z.infer<typeof stageSpecSchema>;
+export type StageSpecInput = z.input<typeof stageSpecSchema>;
+export type IngestionStageSpec = Extract<StageSpec, {
+    type: 'ingestion';
+}>;
+export type TransformationStageSpec = Extract<StageSpec, {
+    type: 'transformation';
+}>;
+export type ServingStageSpec = Extract<StageSpec, {
+    type: 'serving';
+}>;
+//# sourceMappingURL=envelope.d.ts.map