@ontologie/cli 0.1.0-preview.1

package/dist/output/envelope.schema.d.ts

@@ -0,0 +1,1053 @@
+/**
+ * Zod runtime lock for CLI JSON Contract — `dataforge.cli.v1`.
+ *
+ * Canonical contract: `sdk/docs/cli-contract.md`
+ * Type definitions: `./types.ts`
+ *
+ * This module provides runtime validation so the contract cannot drift silently
+ * as commands evolve. Validation is invoked from `output/json.ts` before any
+ * envelope is written to stdout.
+ *
+ * Design:
+ *  - Every shape declared in `types.ts` has a matching Zod schema here.
+ *  - The schemas use `z.object(...).strict()` to reject unknown keys (avoids
+ *    silent contract drift via passthrough fields).
+ *  - `EnvelopeSchema` is the single entry point used by `validateEnvelope()`.
+ *  - On mismatch we throw `EnvelopeViolationError` rather than emitting a
+ *    malformed envelope (loud errors > silent fallbacks).
+ */
+import { z } from 'zod';
+/**
+ * Schema version literal — bumped on a breaking contract change.
+ * Owned here because `CliMetaSchema` consumes it at module-init via `z.literal`.
+ * Re-exported from `./types.ts` for external consumers.
+ */
+export declare const CLI_META_SCHEMA_VERSION: "dataforge.cli.v1";
+export type CliMetaSchemaVersion = typeof CLI_META_SCHEMA_VERSION;
+declare const EnvironmentBaseSchema: z.ZodEnum<["local", "dev", "staging", "prod"]>;
+export type CliEnvironment = z.infer<typeof EnvironmentBaseSchema>;
+/** Stable error code enum — see cli-contract-v1.md §4 */
+export declare const CliErrorCodeSchema: z.ZodEnum<["INVALID_USAGE", "AUTHENTICATION_ERROR", "AUTHORIZATION_ERROR", "POLICY_VIOLATION", "WRITE_POLICY_VIOLATION", "VALIDATION_ERROR", "CAPABILITY_DRIFT_ERROR", "SCHEMA_DRIFT_ERROR", "QUOTA_EXCEEDED", "BUDGET_EXCEEDED", "RATE_LIMITED", "CONFLICT_ERROR", "PLAN_POLICY_MISMATCH", "SOURCE_OF_TRUTH_CONFLICT", "PLAN_CONTEXT_MISMATCH", "PRECONDITION_FAILED", "NETWORK_ERROR", "TIMEOUT_ERROR", "RUNTIME_UNAVAILABLE", "NOT_FOUND", "UNAVAILABLE", "INTERNAL_ERROR", "CONFIRMATION_REQUIRED", "CONFIGURATION_ERROR"]>;
+export type CliErrorCode = z.infer<typeof CliErrorCodeSchema>;
+export declare const CliWarningSchema: z.ZodObject<{
+    code: z.ZodString;
+    message: z.ZodString;
+    severity: z.ZodEnum<["info", "warning", "deprecated", "danger"]>;
+    docsUrl: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    message: string;
+    code: string;
+    severity: "info" | "warning" | "deprecated" | "danger";
+    docsUrl?: string | undefined;
+}, {
+    message: string;
+    code: string;
+    severity: "info" | "warning" | "deprecated" | "danger";
+    docsUrl?: string | undefined;
+}>;
+export declare const CliMetaSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"dataforge.cli.v1">;
+    command: z.ZodString;
+    requestId: z.ZodString;
+    workspaceId: z.ZodNullable<z.ZodString>;
+    environment: z.ZodNullable<z.ZodEnum<["local", "dev", "staging", "prod"]>>;
+    manifestVersion: z.ZodNullable<z.ZodString>;
+    costUnits: z.ZodNumber;
+    estimatedCostUnits: z.ZodNullable<z.ZodNumber>;
+    quotaRemaining: z.ZodNullable<z.ZodNumber>;
+    rateLimitRemaining: z.ZodNullable<z.ZodNumber>;
+    warnings: z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+        severity: z.ZodEnum<["info", "warning", "deprecated", "danger"]>;
+        docsUrl: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        message: string;
+        code: string;
+        severity: "info" | "warning" | "deprecated" | "danger";
+        docsUrl?: string | undefined;
+    }, {
+        message: string;
+        code: string;
+        severity: "info" | "warning" | "deprecated" | "danger";
+        docsUrl?: string | undefined;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    schemaVersion: "dataforge.cli.v1";
+    command: string;
+    requestId: string;
+    workspaceId: string | null;
+    environment: "local" | "dev" | "staging" | "prod" | null;
+    manifestVersion: string | null;
+    costUnits: number;
+    estimatedCostUnits: number | null;
+    quotaRemaining: number | null;
+    rateLimitRemaining: number | null;
+    warnings: {
+        message: string;
+        code: string;
+        severity: "info" | "warning" | "deprecated" | "danger";
+        docsUrl?: string | undefined;
+    }[];
+}, {
+    schemaVersion: "dataforge.cli.v1";
+    command: string;
+    requestId: string;
+    workspaceId: string | null;
+    environment: "local" | "dev" | "staging" | "prod" | null;
+    manifestVersion: string | null;
+    costUnits: number;
+    estimatedCostUnits: number | null;
+    quotaRemaining: number | null;
+    rateLimitRemaining: number | null;
+    warnings: {
+        message: string;
+        code: string;
+        severity: "info" | "warning" | "deprecated" | "danger";
+        docsUrl?: string | undefined;
+    }[];
+}>;
+export declare const CliErrorSchema: z.ZodObject<{
+    code: z.ZodEnum<["INVALID_USAGE", "AUTHENTICATION_ERROR", "AUTHORIZATION_ERROR", "POLICY_VIOLATION", "WRITE_POLICY_VIOLATION", "VALIDATION_ERROR", "CAPABILITY_DRIFT_ERROR", "SCHEMA_DRIFT_ERROR", "QUOTA_EXCEEDED", "BUDGET_EXCEEDED", "RATE_LIMITED", "CONFLICT_ERROR", "PLAN_POLICY_MISMATCH", "SOURCE_OF_TRUTH_CONFLICT", "PLAN_CONTEXT_MISMATCH", "PRECONDITION_FAILED", "NETWORK_ERROR", "TIMEOUT_ERROR", "RUNTIME_UNAVAILABLE", "NOT_FOUND", "UNAVAILABLE", "INTERNAL_ERROR", "CONFIRMATION_REQUIRED", "CONFIGURATION_ERROR"]>;
+    message: z.ZodString;
+    details: z.ZodEffects<z.ZodUnknown, {} | null, unknown>;
+    retryable: z.ZodBoolean;
+    correlationId: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    message: string;
+    code: "INVALID_USAGE" | "AUTHENTICATION_ERROR" | "AUTHORIZATION_ERROR" | "POLICY_VIOLATION" | "WRITE_POLICY_VIOLATION" | "VALIDATION_ERROR" | "CAPABILITY_DRIFT_ERROR" | "SCHEMA_DRIFT_ERROR" | "QUOTA_EXCEEDED" | "BUDGET_EXCEEDED" | "RATE_LIMITED" | "CONFLICT_ERROR" | "PLAN_POLICY_MISMATCH" | "SOURCE_OF_TRUTH_CONFLICT" | "PLAN_CONTEXT_MISMATCH" | "PRECONDITION_FAILED" | "NETWORK_ERROR" | "TIMEOUT_ERROR" | "RUNTIME_UNAVAILABLE" | "NOT_FOUND" | "UNAVAILABLE" | "INTERNAL_ERROR" | "CONFIRMATION_REQUIRED" | "CONFIGURATION_ERROR";
+    details: {} | null;
+    retryable: boolean;
+    correlationId: string;
+}, {
+    message: string;
+    code: "INVALID_USAGE" | "AUTHENTICATION_ERROR" | "AUTHORIZATION_ERROR" | "POLICY_VIOLATION" | "WRITE_POLICY_VIOLATION" | "VALIDATION_ERROR" | "CAPABILITY_DRIFT_ERROR" | "SCHEMA_DRIFT_ERROR" | "QUOTA_EXCEEDED" | "BUDGET_EXCEEDED" | "RATE_LIMITED" | "CONFLICT_ERROR" | "PLAN_POLICY_MISMATCH" | "SOURCE_OF_TRUTH_CONFLICT" | "PLAN_CONTEXT_MISMATCH" | "PRECONDITION_FAILED" | "NETWORK_ERROR" | "TIMEOUT_ERROR" | "RUNTIME_UNAVAILABLE" | "NOT_FOUND" | "UNAVAILABLE" | "INTERNAL_ERROR" | "CONFIRMATION_REQUIRED" | "CONFIGURATION_ERROR";
+    retryable: boolean;
+    correlationId: string;
+    details?: unknown;
+}>;
+export declare const CliPageSchema: z.ZodObject<{
+    limit: z.ZodNumber;
+    nextCursor: z.ZodNullable<z.ZodString>;
+    hasMore: z.ZodBoolean;
+}, "strict", z.ZodTypeAny, {
+    limit: number;
+    nextCursor: string | null;
+    hasMore: boolean;
+}, {
+    limit: number;
+    nextCursor: string | null;
+    hasMore: boolean;
+}>;
+export type CliMeta = z.infer<typeof CliMetaSchema>;
+export type CliError = z.infer<typeof CliErrorSchema>;
+export type CliWarning = z.infer<typeof CliWarningSchema>;
+export type CliPage = z.infer<typeof CliPageSchema>;
+/**
+ * Generic envelope wrapper. Hand-written because Zod schemas are not generic
+ * over their `data` payload (`EnvelopeSchema.data` is `DefinedUnknownSchema.nullable()`).
+ * Structural shape MUST match `EnvelopeSchema` — narrowed `data: T | null`.
+ */
+export interface CliEnvelope<T = unknown> {
+    ok: boolean;
+    data: T | null;
+    error: CliError | null;
+    page: CliPage | null;
+    meta: CliMeta;
+}
+/**
+ * Top-level envelope schema. Enforces the cli-contract.md §2 invariants:
+ *  - `ok === true` → `data !== null`, `error === null`
+ *  - `ok === false` → `data === null`, `error !== null`
+ */
+export declare const EnvelopeSchema: z.ZodEffects<z.ZodObject<{
+    ok: z.ZodBoolean;
+    data: z.ZodNullable<z.ZodEffects<z.ZodUnknown, {} | null, unknown>>;
+    error: z.ZodNullable<z.ZodObject<{
+        code: z.ZodEnum<["INVALID_USAGE", "AUTHENTICATION_ERROR", "AUTHORIZATION_ERROR", "POLICY_VIOLATION", "WRITE_POLICY_VIOLATION", "VALIDATION_ERROR", "CAPABILITY_DRIFT_ERROR", "SCHEMA_DRIFT_ERROR", "QUOTA_EXCEEDED", "BUDGET_EXCEEDED", "RATE_LIMITED", "CONFLICT_ERROR", "PLAN_POLICY_MISMATCH", "SOURCE_OF_TRUTH_CONFLICT", "PLAN_CONTEXT_MISMATCH", "PRECONDITION_FAILED", "NETWORK_ERROR", "TIMEOUT_ERROR", "RUNTIME_UNAVAILABLE", "NOT_FOUND", "UNAVAILABLE", "INTERNAL_ERROR", "CONFIRMATION_REQUIRED", "CONFIGURATION_ERROR"]>;
+        message: z.ZodString;
+        details: z.ZodEffects<z.ZodUnknown, {} | null, unknown>;
+        retryable: z.ZodBoolean;
+        correlationId: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        message: string;
+        code: "INVALID_USAGE" | "AUTHENTICATION_ERROR" | "AUTHORIZATION_ERROR" | "POLICY_VIOLATION" | "WRITE_POLICY_VIOLATION" | "VALIDATION_ERROR" | "CAPABILITY_DRIFT_ERROR" | "SCHEMA_DRIFT_ERROR" | "QUOTA_EXCEEDED" | "BUDGET_EXCEEDED" | "RATE_LIMITED" | "CONFLICT_ERROR" | "PLAN_POLICY_MISMATCH" | "SOURCE_OF_TRUTH_CONFLICT" | "PLAN_CONTEXT_MISMATCH" | "PRECONDITION_FAILED" | "NETWORK_ERROR" | "TIMEOUT_ERROR" | "RUNTIME_UNAVAILABLE" | "NOT_FOUND" | "UNAVAILABLE" | "INTERNAL_ERROR" | "CONFIRMATION_REQUIRED" | "CONFIGURATION_ERROR";
+        details: {} | null;
+        retryable: boolean;
+        correlationId: string;
+    }, {
+        message: string;
+        code: "INVALID_USAGE" | "AUTHENTICATION_ERROR" | "AUTHORIZATION_ERROR" | "POLICY_VIOLATION" | "WRITE_POLICY_VIOLATION" | "VALIDATION_ERROR" | "CAPABILITY_DRIFT_ERROR" | "SCHEMA_DRIFT_ERROR" | "QUOTA_EXCEEDED" | "BUDGET_EXCEEDED" | "RATE_LIMITED" | "CONFLICT_ERROR" | "PLAN_POLICY_MISMATCH" | "SOURCE_OF_TRUTH_CONFLICT" | "PLAN_CONTEXT_MISMATCH" | "PRECONDITION_FAILED" | "NETWORK_ERROR" | "TIMEOUT_ERROR" | "RUNTIME_UNAVAILABLE" | "NOT_FOUND" | "UNAVAILABLE" | "INTERNAL_ERROR" | "CONFIRMATION_REQUIRED" | "CONFIGURATION_ERROR";
+        retryable: boolean;
+        correlationId: string;
+        details?: unknown;
+    }>>;
+    page: z.ZodNullable<z.ZodObject<{
+        limit: z.ZodNumber;
+        nextCursor: z.ZodNullable<z.ZodString>;
+        hasMore: z.ZodBoolean;
+    }, "strict", z.ZodTypeAny, {
+        limit: number;
+        nextCursor: string | null;
+        hasMore: boolean;
+    }, {
+        limit: number;
+        nextCursor: string | null;
+        hasMore: boolean;
+    }>>;
+    meta: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<"dataforge.cli.v1">;
+        command: z.ZodString;
+        requestId: z.ZodString;
+        workspaceId: z.ZodNullable<z.ZodString>;
+        environment: z.ZodNullable<z.ZodEnum<["local", "dev", "staging", "prod"]>>;
+        manifestVersion: z.ZodNullable<z.ZodString>;
+        costUnits: z.ZodNumber;
+        estimatedCostUnits: z.ZodNullable<z.ZodNumber>;
+        quotaRemaining: z.ZodNullable<z.ZodNumber>;
+        rateLimitRemaining: z.ZodNullable<z.ZodNumber>;
+        warnings: z.ZodArray<z.ZodObject<{
+            code: z.ZodString;
+            message: z.ZodString;
+            severity: z.ZodEnum<["info", "warning", "deprecated", "danger"]>;
+            docsUrl: z.ZodOptional<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            message: string;
+            code: string;
+            severity: "info" | "warning" | "deprecated" | "danger";
+            docsUrl?: string | undefined;
+        }, {
+            message: string;
+            code: string;
+            severity: "info" | "warning" | "deprecated" | "danger";
+            docsUrl?: string | undefined;
+        }>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        schemaVersion: "dataforge.cli.v1";
+        command: string;
+        requestId: string;
+        workspaceId: string | null;
+        environment: "local" | "dev" | "staging" | "prod" | null;
+        manifestVersion: string | null;
+        costUnits: number;
+        estimatedCostUnits: number | null;
+        quotaRemaining: number | null;
+        rateLimitRemaining: number | null;
+        warnings: {
+            message: string;
+            code: string;
+            severity: "info" | "warning" | "deprecated" | "danger";
+            docsUrl?: string | undefined;
+        }[];
+    }, {
+        schemaVersion: "dataforge.cli.v1";
+        command: string;
+        requestId: string;
+        workspaceId: string | null;
+        environment: "local" | "dev" | "staging" | "prod" | null;
+        manifestVersion: string | null;
+        costUnits: number;
+        estimatedCostUnits: number | null;
+        quotaRemaining: number | null;
+        rateLimitRemaining: number | null;
+        warnings: {
+            message: string;
+            code: string;
+            severity: "info" | "warning" | "deprecated" | "danger";
+            docsUrl?: string | undefined;
+        }[];
+    }>;
+}, "strict", z.ZodTypeAny, {
+    ok: boolean;
+    data: {} | null;
+    error: {
+        message: string;
+        code: "INVALID_USAGE" | "AUTHENTICATION_ERROR" | "AUTHORIZATION_ERROR" | "POLICY_VIOLATION" | "WRITE_POLICY_VIOLATION" | "VALIDATION_ERROR" | "CAPABILITY_DRIFT_ERROR" | "SCHEMA_DRIFT_ERROR" | "QUOTA_EXCEEDED" | "BUDGET_EXCEEDED" | "RATE_LIMITED" | "CONFLICT_ERROR" | "PLAN_POLICY_MISMATCH" | "SOURCE_OF_TRUTH_CONFLICT" | "PLAN_CONTEXT_MISMATCH" | "PRECONDITION_FAILED" | "NETWORK_ERROR" | "TIMEOUT_ERROR" | "RUNTIME_UNAVAILABLE" | "NOT_FOUND" | "UNAVAILABLE" | "INTERNAL_ERROR" | "CONFIRMATION_REQUIRED" | "CONFIGURATION_ERROR";
+        details: {} | null;
+        retryable: boolean;
+        correlationId: string;
+    } | null;
+    page: {
+        limit: number;
+        nextCursor: string | null;
+        hasMore: boolean;
+    } | null;
+    meta: {
+        schemaVersion: "dataforge.cli.v1";
+        command: string;
+        requestId: string;
+        workspaceId: string | null;
+        environment: "local" | "dev" | "staging" | "prod" | null;
+        manifestVersion: string | null;
+        costUnits: number;
+        estimatedCostUnits: number | null;
+        quotaRemaining: number | null;
+        rateLimitRemaining: number | null;
+        warnings: {
+            message: string;
+            code: string;
+            severity: "info" | "warning" | "deprecated" | "danger";
+            docsUrl?: string | undefined;
+        }[];
+    };
+}, {
+    ok: boolean;
+    error: {
+        message: string;
+        code: "INVALID_USAGE" | "AUTHENTICATION_ERROR" | "AUTHORIZATION_ERROR" | "POLICY_VIOLATION" | "WRITE_POLICY_VIOLATION" | "VALIDATION_ERROR" | "CAPABILITY_DRIFT_ERROR" | "SCHEMA_DRIFT_ERROR" | "QUOTA_EXCEEDED" | "BUDGET_EXCEEDED" | "RATE_LIMITED" | "CONFLICT_ERROR" | "PLAN_POLICY_MISMATCH" | "SOURCE_OF_TRUTH_CONFLICT" | "PLAN_CONTEXT_MISMATCH" | "PRECONDITION_FAILED" | "NETWORK_ERROR" | "TIMEOUT_ERROR" | "RUNTIME_UNAVAILABLE" | "NOT_FOUND" | "UNAVAILABLE" | "INTERNAL_ERROR" | "CONFIRMATION_REQUIRED" | "CONFIGURATION_ERROR";
+        retryable: boolean;
+        correlationId: string;
+        details?: unknown;
+    } | null;
+    page: {
+        limit: number;
+        nextCursor: string | null;
+        hasMore: boolean;
+    } | null;
+    meta: {
+        schemaVersion: "dataforge.cli.v1";
+        command: string;
+        requestId: string;
+        workspaceId: string | null;
+        environment: "local" | "dev" | "staging" | "prod" | null;
+        manifestVersion: string | null;
+        costUnits: number;
+        estimatedCostUnits: number | null;
+        quotaRemaining: number | null;
+        rateLimitRemaining: number | null;
+        warnings: {
+            message: string;
+            code: string;
+            severity: "info" | "warning" | "deprecated" | "danger";
+            docsUrl?: string | undefined;
+        }[];
+    };
+    data?: unknown;
+}>, {
+    ok: boolean;
+    data: {} | null;
+    error: {
+        message: string;
+        code: "INVALID_USAGE" | "AUTHENTICATION_ERROR" | "AUTHORIZATION_ERROR" | "POLICY_VIOLATION" | "WRITE_POLICY_VIOLATION" | "VALIDATION_ERROR" | "CAPABILITY_DRIFT_ERROR" | "SCHEMA_DRIFT_ERROR" | "QUOTA_EXCEEDED" | "BUDGET_EXCEEDED" | "RATE_LIMITED" | "CONFLICT_ERROR" | "PLAN_POLICY_MISMATCH" | "SOURCE_OF_TRUTH_CONFLICT" | "PLAN_CONTEXT_MISMATCH" | "PRECONDITION_FAILED" | "NETWORK_ERROR" | "TIMEOUT_ERROR" | "RUNTIME_UNAVAILABLE" | "NOT_FOUND" | "UNAVAILABLE" | "INTERNAL_ERROR" | "CONFIRMATION_REQUIRED" | "CONFIGURATION_ERROR";
+        details: {} | null;
+        retryable: boolean;
+        correlationId: string;
+    } | null;
+    page: {
+        limit: number;
+        nextCursor: string | null;
+        hasMore: boolean;
+    } | null;
+    meta: {
+        schemaVersion: "dataforge.cli.v1";
+        command: string;
+        requestId: string;
+        workspaceId: string | null;
+        environment: "local" | "dev" | "staging" | "prod" | null;
+        manifestVersion: string | null;
+        costUnits: number;
+        estimatedCostUnits: number | null;
+        quotaRemaining: number | null;
+        rateLimitRemaining: number | null;
+        warnings: {
+            message: string;
+            code: string;
+            severity: "info" | "warning" | "deprecated" | "danger";
+            docsUrl?: string | undefined;
+        }[];
+    };
+}, {
+    ok: boolean;
+    error: {
+        message: string;
+        code: "INVALID_USAGE" | "AUTHENTICATION_ERROR" | "AUTHORIZATION_ERROR" | "POLICY_VIOLATION" | "WRITE_POLICY_VIOLATION" | "VALIDATION_ERROR" | "CAPABILITY_DRIFT_ERROR" | "SCHEMA_DRIFT_ERROR" | "QUOTA_EXCEEDED" | "BUDGET_EXCEEDED" | "RATE_LIMITED" | "CONFLICT_ERROR" | "PLAN_POLICY_MISMATCH" | "SOURCE_OF_TRUTH_CONFLICT" | "PLAN_CONTEXT_MISMATCH" | "PRECONDITION_FAILED" | "NETWORK_ERROR" | "TIMEOUT_ERROR" | "RUNTIME_UNAVAILABLE" | "NOT_FOUND" | "UNAVAILABLE" | "INTERNAL_ERROR" | "CONFIRMATION_REQUIRED" | "CONFIGURATION_ERROR";
+        retryable: boolean;
+        correlationId: string;
+        details?: unknown;
+    } | null;
+    page: {
+        limit: number;
+        nextCursor: string | null;
+        hasMore: boolean;
+    } | null;
+    meta: {
+        schemaVersion: "dataforge.cli.v1";
+        command: string;
+        requestId: string;
+        workspaceId: string | null;
+        environment: "local" | "dev" | "staging" | "prod" | null;
+        manifestVersion: string | null;
+        costUnits: number;
+        estimatedCostUnits: number | null;
+        quotaRemaining: number | null;
+        rateLimitRemaining: number | null;
+        warnings: {
+            message: string;
+            code: string;
+            severity: "info" | "warning" | "deprecated" | "danger";
+            docsUrl?: string | undefined;
+        }[];
+    };
+    data?: unknown;
+}>;
+export declare const JsonlStartedEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"started">;
+    meta: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<"dataforge.cli.v1">;
+        command: z.ZodString;
+        requestId: z.ZodString;
+        workspaceId: z.ZodNullable<z.ZodString>;
+        environment: z.ZodNullable<z.ZodEnum<["local", "dev", "staging", "prod"]>>;
+        manifestVersion: z.ZodNullable<z.ZodString>;
+        costUnits: z.ZodNumber;
+        estimatedCostUnits: z.ZodNullable<z.ZodNumber>;
+        quotaRemaining: z.ZodNullable<z.ZodNumber>;
+        rateLimitRemaining: z.ZodNullable<z.ZodNumber>;
+        warnings: z.ZodArray<z.ZodObject<{
+            code: z.ZodString;
+            message: z.ZodString;
+            severity: z.ZodEnum<["info", "warning", "deprecated", "danger"]>;
+            docsUrl: z.ZodOptional<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            message: string;
+            code: string;
+            severity: "info" | "warning" | "deprecated" | "danger";
+            docsUrl?: string | undefined;
+        }, {
+            message: string;
+            code: string;
+            severity: "info" | "warning" | "deprecated" | "danger";
+            docsUrl?: string | undefined;
+        }>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        schemaVersion: "dataforge.cli.v1";
+        command: string;
+        requestId: string;
+        workspaceId: string | null;
+        environment: "local" | "dev" | "staging" | "prod" | null;
+        manifestVersion: string | null;
+        costUnits: number;
+        estimatedCostUnits: number | null;
+        quotaRemaining: number | null;
+        rateLimitRemaining: number | null;
+        warnings: {
+            message: string;
+            code: string;
+            severity: "info" | "warning" | "deprecated" | "danger";
+            docsUrl?: string | undefined;
+        }[];
+    }, {
+        schemaVersion: "dataforge.cli.v1";
+        command: string;
+        requestId: string;
+        workspaceId: string | null;
+        environment: "local" | "dev" | "staging" | "prod" | null;
+        manifestVersion: string | null;
+        costUnits: number;
+        estimatedCostUnits: number | null;
+        quotaRemaining: number | null;
+        rateLimitRemaining: number | null;
+        warnings: {
+            message: string;
+            code: string;
+            severity: "info" | "warning" | "deprecated" | "danger";
+            docsUrl?: string | undefined;
+        }[];
+    }>;
+    total: z.ZodNullable<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    type: "started";
+    meta: {
+        schemaVersion: "dataforge.cli.v1";
+        command: string;
+        requestId: string;
+        workspaceId: string | null;
+        environment: "local" | "dev" | "staging" | "prod" | null;
+        manifestVersion: string | null;
+        costUnits: number;
+        estimatedCostUnits: number | null;
+        quotaRemaining: number | null;
+        rateLimitRemaining: number | null;
+        warnings: {
+            message: string;
+            code: string;
+            severity: "info" | "warning" | "deprecated" | "danger";
+            docsUrl?: string | undefined;
+        }[];
+    };
+    total: number | null;
+}, {
+    type: "started";
+    meta: {
+        schemaVersion: "dataforge.cli.v1";
+        command: string;
+        requestId: string;
+        workspaceId: string | null;
+        environment: "local" | "dev" | "staging" | "prod" | null;
+        manifestVersion: string | null;
+        costUnits: number;
+        estimatedCostUnits: number | null;
+        quotaRemaining: number | null;
+        rateLimitRemaining: number | null;
+        warnings: {
+            message: string;
+            code: string;
+            severity: "info" | "warning" | "deprecated" | "danger";
+            docsUrl?: string | undefined;
+        }[];
+    };
+    total: number | null;
+}>;
+export declare const JsonlItemEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"item">;
+    data: z.ZodEffects<z.ZodUnknown, {} | null, unknown>;
+}, "strict", z.ZodTypeAny, {
+    type: "item";
+    data: {} | null;
+}, {
+    type: "item";
+    data?: unknown;
+}>;
+export declare const JsonlCompletedEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"completed">;
+    meta: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<"dataforge.cli.v1">;
+        command: z.ZodString;
+        requestId: z.ZodString;
+        workspaceId: z.ZodNullable<z.ZodString>;
+        environment: z.ZodNullable<z.ZodEnum<["local", "dev", "staging", "prod"]>>;
+        manifestVersion: z.ZodNullable<z.ZodString>;
+        costUnits: z.ZodNumber;
+        estimatedCostUnits: z.ZodNullable<z.ZodNumber>;
+        quotaRemaining: z.ZodNullable<z.ZodNumber>;
+        rateLimitRemaining: z.ZodNullable<z.ZodNumber>;
+        warnings: z.ZodArray<z.ZodObject<{
+            code: z.ZodString;
+            message: z.ZodString;
+            severity: z.ZodEnum<["info", "warning", "deprecated", "danger"]>;
+            docsUrl: z.ZodOptional<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            message: string;
+            code: string;
+            severity: "info" | "warning" | "deprecated" | "danger";
+            docsUrl?: string | undefined;
+        }, {
+            message: string;
+            code: string;
+            severity: "info" | "warning" | "deprecated" | "danger";
+            docsUrl?: string | undefined;
+        }>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        schemaVersion: "dataforge.cli.v1";
+        command: string;
+        requestId: string;
+        workspaceId: string | null;
+        environment: "local" | "dev" | "staging" | "prod" | null;
+        manifestVersion: string | null;
+        costUnits: number;
+        estimatedCostUnits: number | null;
+        quotaRemaining: number | null;
+        rateLimitRemaining: number | null;
+        warnings: {
+            message: string;
+            code: string;
+            severity: "info" | "warning" | "deprecated" | "danger";
+            docsUrl?: string | undefined;
+        }[];
+    }, {
+        schemaVersion: "dataforge.cli.v1";
+        command: string;
+        requestId: string;
+        workspaceId: string | null;
+        environment: "local" | "dev" | "staging" | "prod" | null;
+        manifestVersion: string | null;
+        costUnits: number;
+        estimatedCostUnits: number | null;
+        quotaRemaining: number | null;
+        rateLimitRemaining: number | null;
+        warnings: {
+            message: string;
+            code: string;
+            severity: "info" | "warning" | "deprecated" | "danger";
+            docsUrl?: string | undefined;
+        }[];
+    }>;
+    summary: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, "strict", z.ZodTypeAny, {
+    type: "completed";
+    meta: {
+        schemaVersion: "dataforge.cli.v1";
+        command: string;
+        requestId: string;
+        workspaceId: string | null;
+        environment: "local" | "dev" | "staging" | "prod" | null;
+        manifestVersion: string | null;
+        costUnits: number;
+        estimatedCostUnits: number | null;
+        quotaRemaining: number | null;
+        rateLimitRemaining: number | null;
+        warnings: {
+            message: string;
+            code: string;
+            severity: "info" | "warning" | "deprecated" | "danger";
+            docsUrl?: string | undefined;
+        }[];
+    };
+    summary: Record<string, unknown>;
+}, {
+    type: "completed";
+    meta: {
+        schemaVersion: "dataforge.cli.v1";
+        command: string;
+        requestId: string;
+        workspaceId: string | null;
+        environment: "local" | "dev" | "staging" | "prod" | null;
+        manifestVersion: string | null;
+        costUnits: number;
+        estimatedCostUnits: number | null;
+        quotaRemaining: number | null;
+        rateLimitRemaining: number | null;
+        warnings: {
+            message: string;
+            code: string;
+            severity: "info" | "warning" | "deprecated" | "danger";
+            docsUrl?: string | undefined;
+        }[];
+    };
+    summary: Record<string, unknown>;
+}>;
+export declare const JsonlErrorEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"error">;
+    error: z.ZodObject<{
+        code: z.ZodEnum<["INVALID_USAGE", "AUTHENTICATION_ERROR", "AUTHORIZATION_ERROR", "POLICY_VIOLATION", "WRITE_POLICY_VIOLATION", "VALIDATION_ERROR", "CAPABILITY_DRIFT_ERROR", "SCHEMA_DRIFT_ERROR", "QUOTA_EXCEEDED", "BUDGET_EXCEEDED", "RATE_LIMITED", "CONFLICT_ERROR", "PLAN_POLICY_MISMATCH", "SOURCE_OF_TRUTH_CONFLICT", "PLAN_CONTEXT_MISMATCH", "PRECONDITION_FAILED", "NETWORK_ERROR", "TIMEOUT_ERROR", "RUNTIME_UNAVAILABLE", "NOT_FOUND", "UNAVAILABLE", "INTERNAL_ERROR", "CONFIRMATION_REQUIRED", "CONFIGURATION_ERROR"]>;
+        message: z.ZodString;
+        details: z.ZodEffects<z.ZodUnknown, {} | null, unknown>;
+        retryable: z.ZodBoolean;
+        correlationId: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        message: string;
+        code: "INVALID_USAGE" | "AUTHENTICATION_ERROR" | "AUTHORIZATION_ERROR" | "POLICY_VIOLATION" | "WRITE_POLICY_VIOLATION" | "VALIDATION_ERROR" | "CAPABILITY_DRIFT_ERROR" | "SCHEMA_DRIFT_ERROR" | "QUOTA_EXCEEDED" | "BUDGET_EXCEEDED" | "RATE_LIMITED" | "CONFLICT_ERROR" | "PLAN_POLICY_MISMATCH" | "SOURCE_OF_TRUTH_CONFLICT" | "PLAN_CONTEXT_MISMATCH" | "PRECONDITION_FAILED" | "NETWORK_ERROR" | "TIMEOUT_ERROR" | "RUNTIME_UNAVAILABLE" | "NOT_FOUND" | "UNAVAILABLE" | "INTERNAL_ERROR" | "CONFIRMATION_REQUIRED" | "CONFIGURATION_ERROR";
+        details: {} | null;
+        retryable: boolean;
+        correlationId: string;
+    }, {
+        message: string;
+        code: "INVALID_USAGE" | "AUTHENTICATION_ERROR" | "AUTHORIZATION_ERROR" | "POLICY_VIOLATION" | "WRITE_POLICY_VIOLATION" | "VALIDATION_ERROR" | "CAPABILITY_DRIFT_ERROR" | "SCHEMA_DRIFT_ERROR" | "QUOTA_EXCEEDED" | "BUDGET_EXCEEDED" | "RATE_LIMITED" | "CONFLICT_ERROR" | "PLAN_POLICY_MISMATCH" | "SOURCE_OF_TRUTH_CONFLICT" | "PLAN_CONTEXT_MISMATCH" | "PRECONDITION_FAILED" | "NETWORK_ERROR" | "TIMEOUT_ERROR" | "RUNTIME_UNAVAILABLE" | "NOT_FOUND" | "UNAVAILABLE" | "INTERNAL_ERROR" | "CONFIRMATION_REQUIRED" | "CONFIGURATION_ERROR";
+        retryable: boolean;
+        correlationId: string;
+        details?: unknown;
+    }>;
+}, "strict", z.ZodTypeAny, {
+    type: "error";
+    error: {
+        message: string;
+        code: "INVALID_USAGE" | "AUTHENTICATION_ERROR" | "AUTHORIZATION_ERROR" | "POLICY_VIOLATION" | "WRITE_POLICY_VIOLATION" | "VALIDATION_ERROR" | "CAPABILITY_DRIFT_ERROR" | "SCHEMA_DRIFT_ERROR" | "QUOTA_EXCEEDED" | "BUDGET_EXCEEDED" | "RATE_LIMITED" | "CONFLICT_ERROR" | "PLAN_POLICY_MISMATCH" | "SOURCE_OF_TRUTH_CONFLICT" | "PLAN_CONTEXT_MISMATCH" | "PRECONDITION_FAILED" | "NETWORK_ERROR" | "TIMEOUT_ERROR" | "RUNTIME_UNAVAILABLE" | "NOT_FOUND" | "UNAVAILABLE" | "INTERNAL_ERROR" | "CONFIRMATION_REQUIRED" | "CONFIGURATION_ERROR";
+        details: {} | null;
+        retryable: boolean;
+        correlationId: string;
+    };
+}, {
+    type: "error";
+    error: {
+        message: string;
+        code: "INVALID_USAGE" | "AUTHENTICATION_ERROR" | "AUTHORIZATION_ERROR" | "POLICY_VIOLATION" | "WRITE_POLICY_VIOLATION" | "VALIDATION_ERROR" | "CAPABILITY_DRIFT_ERROR" | "SCHEMA_DRIFT_ERROR" | "QUOTA_EXCEEDED" | "BUDGET_EXCEEDED" | "RATE_LIMITED" | "CONFLICT_ERROR" | "PLAN_POLICY_MISMATCH" | "SOURCE_OF_TRUTH_CONFLICT" | "PLAN_CONTEXT_MISMATCH" | "PRECONDITION_FAILED" | "NETWORK_ERROR" | "TIMEOUT_ERROR" | "RUNTIME_UNAVAILABLE" | "NOT_FOUND" | "UNAVAILABLE" | "INTERNAL_ERROR" | "CONFIRMATION_REQUIRED" | "CONFIGURATION_ERROR";
+        retryable: boolean;
+        correlationId: string;
+        details?: unknown;
+    };
+}>;
+export declare const JsonlProgressEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"progress">;
+    current: z.ZodNumber;
+    total: z.ZodNullable<z.ZodNumber>;
+    message: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    message: string;
+    type: "progress";
+    total: number | null;
+    current: number;
+}, {
+    message: string;
+    type: "progress";
+    total: number | null;
+    current: number;
+}>;
+export declare const JsonlWarningEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"warning">;
+    warning: z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+        severity: z.ZodEnum<["info", "warning", "deprecated", "danger"]>;
+        docsUrl: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        message: string;
+        code: string;
+        severity: "info" | "warning" | "deprecated" | "danger";
+        docsUrl?: string | undefined;
+    }, {
+        message: string;
+        code: string;
+        severity: "info" | "warning" | "deprecated" | "danger";
+        docsUrl?: string | undefined;
+    }>;
+}, "strict", z.ZodTypeAny, {
+    type: "warning";
+    warning: {
+        message: string;
+        code: string;
+        severity: "info" | "warning" | "deprecated" | "danger";
+        docsUrl?: string | undefined;
+    };
+}, {
+    type: "warning";
+    warning: {
+        message: string;
+        code: string;
+        severity: "info" | "warning" | "deprecated" | "danger";
+        docsUrl?: string | undefined;
+    };
+}>;
+export declare const JsonlEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodLiteral<"started">;
+    meta: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<"dataforge.cli.v1">;
+        command: z.ZodString;
+        requestId: z.ZodString;
+        workspaceId: z.ZodNullable<z.ZodString>;
+        environment: z.ZodNullable<z.ZodEnum<["local", "dev", "staging", "prod"]>>;
+        manifestVersion: z.ZodNullable<z.ZodString>;
+        costUnits: z.ZodNumber;
+        estimatedCostUnits: z.ZodNullable<z.ZodNumber>;
+        quotaRemaining: z.ZodNullable<z.ZodNumber>;
+        rateLimitRemaining: z.ZodNullable<z.ZodNumber>;
+        warnings: z.ZodArray<z.ZodObject<{
+            code: z.ZodString;
+            message: z.ZodString;
+            severity: z.ZodEnum<["info", "warning", "deprecated", "danger"]>;
+            docsUrl: z.ZodOptional<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            message: string;
+            code: string;
+            severity: "info" | "warning" | "deprecated" | "danger";
+            docsUrl?: string | undefined;
+        }, {
+            message: string;
+            code: string;
+            severity: "info" | "warning" | "deprecated" | "danger";
+            docsUrl?: string | undefined;
+        }>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        schemaVersion: "dataforge.cli.v1";
+        command: string;
+        requestId: string;
+        workspaceId: string | null;
+        environment: "local" | "dev" | "staging" | "prod" | null;
+        manifestVersion: string | null;
+        costUnits: number;
+        estimatedCostUnits: number | null;
+        quotaRemaining: number | null;
+        rateLimitRemaining: number | null;
+        warnings: {
+            message: string;
+            code: string;
+            severity: "info" | "warning" | "deprecated" | "danger";
+            docsUrl?: string | undefined;
+        }[];
+    }, {
+        schemaVersion: "dataforge.cli.v1";
+        command: string;
+        requestId: string;
+        workspaceId: string | null;
+        environment: "local" | "dev" | "staging" | "prod" | null;
+        manifestVersion: string | null;
+        costUnits: number;
+        estimatedCostUnits: number | null;
+        quotaRemaining: number | null;
+        rateLimitRemaining: number | null;
+        warnings: {
+            message: string;
+            code: string;
+            severity: "info" | "warning" | "deprecated" | "danger";
+            docsUrl?: string | undefined;
+        }[];
+    }>;
+    total: z.ZodNullable<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    type: "started";
+    meta: {
+        schemaVersion: "dataforge.cli.v1";
+        command: string;
+        requestId: string;
+        workspaceId: string | null;
+        environment: "local" | "dev" | "staging" | "prod" | null;
+        manifestVersion: string | null;
+        costUnits: number;
+        estimatedCostUnits: number | null;
+        quotaRemaining: number | null;
+        rateLimitRemaining: number | null;
+        warnings: {
+            message: string;
+            code: string;
+            severity: "info" | "warning" | "deprecated" | "danger";
+            docsUrl?: string | undefined;
+        }[];
+    };
+    total: number | null;
+}, {
+    type: "started";
+    meta: {
+        schemaVersion: "dataforge.cli.v1";
+        command: string;
+        requestId: string;
+        workspaceId: string | null;
+        environment: "local" | "dev" | "staging" | "prod" | null;
+        manifestVersion: string | null;
+        costUnits: number;
+        estimatedCostUnits: number | null;
+        quotaRemaining: number | null;
+        rateLimitRemaining: number | null;
+        warnings: {
+            message: string;
+            code: string;
+            severity: "info" | "warning" | "deprecated" | "danger";
+            docsUrl?: string | undefined;
+        }[];
+    };
+    total: number | null;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"item">;
+    data: z.ZodEffects<z.ZodUnknown, {} | null, unknown>;
+}, "strict", z.ZodTypeAny, {
+    type: "item";
+    data: {} | null;
+}, {
+    type: "item";
+    data?: unknown;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"completed">;
+    meta: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<"dataforge.cli.v1">;
+        command: z.ZodString;
+        requestId: z.ZodString;
+        workspaceId: z.ZodNullable<z.ZodString>;
+        environment: z.ZodNullable<z.ZodEnum<["local", "dev", "staging", "prod"]>>;
+        manifestVersion: z.ZodNullable<z.ZodString>;
+        costUnits: z.ZodNumber;
+        estimatedCostUnits: z.ZodNullable<z.ZodNumber>;
+        quotaRemaining: z.ZodNullable<z.ZodNumber>;
+        rateLimitRemaining: z.ZodNullable<z.ZodNumber>;
+        warnings: z.ZodArray<z.ZodObject<{
+            code: z.ZodString;
+            message: z.ZodString;
+            severity: z.ZodEnum<["info", "warning", "deprecated", "danger"]>;
+            docsUrl: z.ZodOptional<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            message: string;
+            code: string;
+            severity: "info" | "warning" | "deprecated" | "danger";
+            docsUrl?: string | undefined;
+        }, {
+            message: string;
+            code: string;
+            severity: "info" | "warning" | "deprecated" | "danger";
+            docsUrl?: string | undefined;
+        }>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        schemaVersion: "dataforge.cli.v1";
+        command: string;
+        requestId: string;
+        workspaceId: string | null;
+        environment: "local" | "dev" | "staging" | "prod" | null;
+        manifestVersion: string | null;
+        costUnits: number;
+        estimatedCostUnits: number | null;
+        quotaRemaining: number | null;
+        rateLimitRemaining: number | null;
+        warnings: {
+            message: string;
+            code: string;
+            severity: "info" | "warning" | "deprecated" | "danger";
+            docsUrl?: string | undefined;
+        }[];
+    }, {
+        schemaVersion: "dataforge.cli.v1";
+        command: string;
+        requestId: string;
+        workspaceId: string | null;
+        environment: "local" | "dev" | "staging" | "prod" | null;
+        manifestVersion: string | null;
+        costUnits: number;
+        estimatedCostUnits: number | null;
+        quotaRemaining: number | null;
+        rateLimitRemaining: number | null;
+        warnings: {
+            message: string;
+            code: string;
+            severity: "info" | "warning" | "deprecated" | "danger";
+            docsUrl?: string | undefined;
+        }[];
+    }>;
+    summary: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, "strict", z.ZodTypeAny, {
+    type: "completed";
+    meta: {
+        schemaVersion: "dataforge.cli.v1";
+        command: string;
+        requestId: string;
+        workspaceId: string | null;
+        environment: "local" | "dev" | "staging" | "prod" | null;
+        manifestVersion: string | null;
+        costUnits: number;
+        estimatedCostUnits: number | null;
+        quotaRemaining: number | null;
+        rateLimitRemaining: number | null;
+        warnings: {
+            message: string;
+            code: string;
+            severity: "info" | "warning" | "deprecated" | "danger";
+            docsUrl?: string | undefined;
+        }[];
+    };
+    summary: Record<string, unknown>;
+}, {
+    type: "completed";
+    meta: {
+        schemaVersion: "dataforge.cli.v1";
+        command: string;
+        requestId: string;
+        workspaceId: string | null;
+        environment: "local" | "dev" | "staging" | "prod" | null;
+        manifestVersion: string | null;
+        costUnits: number;
+        estimatedCostUnits: number | null;
+        quotaRemaining: number | null;
+        rateLimitRemaining: number | null;
+        warnings: {
+            message: string;
+            code: string;
+            severity: "info" | "warning" | "deprecated" | "danger";
+            docsUrl?: string | undefined;
+        }[];
+    };
+    summary: Record<string, unknown>;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"error">;
+    error: z.ZodObject<{
+        code: z.ZodEnum<["INVALID_USAGE", "AUTHENTICATION_ERROR", "AUTHORIZATION_ERROR", "POLICY_VIOLATION", "WRITE_POLICY_VIOLATION", "VALIDATION_ERROR", "CAPABILITY_DRIFT_ERROR", "SCHEMA_DRIFT_ERROR", "QUOTA_EXCEEDED", "BUDGET_EXCEEDED", "RATE_LIMITED", "CONFLICT_ERROR", "PLAN_POLICY_MISMATCH", "SOURCE_OF_TRUTH_CONFLICT", "PLAN_CONTEXT_MISMATCH", "PRECONDITION_FAILED", "NETWORK_ERROR", "TIMEOUT_ERROR", "RUNTIME_UNAVAILABLE", "NOT_FOUND", "UNAVAILABLE", "INTERNAL_ERROR", "CONFIRMATION_REQUIRED", "CONFIGURATION_ERROR"]>;
+        message: z.ZodString;
+        details: z.ZodEffects<z.ZodUnknown, {} | null, unknown>;
+        retryable: z.ZodBoolean;
+        correlationId: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        message: string;
+        code: "INVALID_USAGE" | "AUTHENTICATION_ERROR" | "AUTHORIZATION_ERROR" | "POLICY_VIOLATION" | "WRITE_POLICY_VIOLATION" | "VALIDATION_ERROR" | "CAPABILITY_DRIFT_ERROR" | "SCHEMA_DRIFT_ERROR" | "QUOTA_EXCEEDED" | "BUDGET_EXCEEDED" | "RATE_LIMITED" | "CONFLICT_ERROR" | "PLAN_POLICY_MISMATCH" | "SOURCE_OF_TRUTH_CONFLICT" | "PLAN_CONTEXT_MISMATCH" | "PRECONDITION_FAILED" | "NETWORK_ERROR" | "TIMEOUT_ERROR" | "RUNTIME_UNAVAILABLE" | "NOT_FOUND" | "UNAVAILABLE" | "INTERNAL_ERROR" | "CONFIRMATION_REQUIRED" | "CONFIGURATION_ERROR";
+        details: {} | null;
+        retryable: boolean;
+        correlationId: string;
+    }, {
+        message: string;
+        code: "INVALID_USAGE" | "AUTHENTICATION_ERROR" | "AUTHORIZATION_ERROR" | "POLICY_VIOLATION" | "WRITE_POLICY_VIOLATION" | "VALIDATION_ERROR" | "CAPABILITY_DRIFT_ERROR" | "SCHEMA_DRIFT_ERROR" | "QUOTA_EXCEEDED" | "BUDGET_EXCEEDED" | "RATE_LIMITED" | "CONFLICT_ERROR" | "PLAN_POLICY_MISMATCH" | "SOURCE_OF_TRUTH_CONFLICT" | "PLAN_CONTEXT_MISMATCH" | "PRECONDITION_FAILED" | "NETWORK_ERROR" | "TIMEOUT_ERROR" | "RUNTIME_UNAVAILABLE" | "NOT_FOUND" | "UNAVAILABLE" | "INTERNAL_ERROR" | "CONFIRMATION_REQUIRED" | "CONFIGURATION_ERROR";
+        retryable: boolean;
+        correlationId: string;
+        details?: unknown;
+    }>;
+}, "strict", z.ZodTypeAny, {
+    type: "error";
+    error: {
+        message: string;
+        code: "INVALID_USAGE" | "AUTHENTICATION_ERROR" | "AUTHORIZATION_ERROR" | "POLICY_VIOLATION" | "WRITE_POLICY_VIOLATION" | "VALIDATION_ERROR" | "CAPABILITY_DRIFT_ERROR" | "SCHEMA_DRIFT_ERROR" | "QUOTA_EXCEEDED" | "BUDGET_EXCEEDED" | "RATE_LIMITED" | "CONFLICT_ERROR" | "PLAN_POLICY_MISMATCH" | "SOURCE_OF_TRUTH_CONFLICT" | "PLAN_CONTEXT_MISMATCH" | "PRECONDITION_FAILED" | "NETWORK_ERROR" | "TIMEOUT_ERROR" | "RUNTIME_UNAVAILABLE" | "NOT_FOUND" | "UNAVAILABLE" | "INTERNAL_ERROR" | "CONFIRMATION_REQUIRED" | "CONFIGURATION_ERROR";
+        details: {} | null;
+        retryable: boolean;
+        correlationId: string;
+    };
+}, {
+    type: "error";
+    error: {
+        message: string;
+        code: "INVALID_USAGE" | "AUTHENTICATION_ERROR" | "AUTHORIZATION_ERROR" | "POLICY_VIOLATION" | "WRITE_POLICY_VIOLATION" | "VALIDATION_ERROR" | "CAPABILITY_DRIFT_ERROR" | "SCHEMA_DRIFT_ERROR" | "QUOTA_EXCEEDED" | "BUDGET_EXCEEDED" | "RATE_LIMITED" | "CONFLICT_ERROR" | "PLAN_POLICY_MISMATCH" | "SOURCE_OF_TRUTH_CONFLICT" | "PLAN_CONTEXT_MISMATCH" | "PRECONDITION_FAILED" | "NETWORK_ERROR" | "TIMEOUT_ERROR" | "RUNTIME_UNAVAILABLE" | "NOT_FOUND" | "UNAVAILABLE" | "INTERNAL_ERROR" | "CONFIRMATION_REQUIRED" | "CONFIGURATION_ERROR";
+        retryable: boolean;
+        correlationId: string;
+        details?: unknown;
+    };
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"progress">;
+    current: z.ZodNumber;
+    total: z.ZodNullable<z.ZodNumber>;
+    message: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    message: string;
+    type: "progress";
+    total: number | null;
+    current: number;
+}, {
+    message: string;
+    type: "progress";
+    total: number | null;
+    current: number;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"warning">;
+    warning: z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+        severity: z.ZodEnum<["info", "warning", "deprecated", "danger"]>;
+        docsUrl: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        message: string;
+        code: string;
+        severity: "info" | "warning" | "deprecated" | "danger";
+        docsUrl?: string | undefined;
+    }, {
+        message: string;
+        code: string;
+        severity: "info" | "warning" | "deprecated" | "danger";
+        docsUrl?: string | undefined;
+    }>;
+}, "strict", z.ZodTypeAny, {
+    type: "warning";
+    warning: {
+        message: string;
+        code: string;
+        severity: "info" | "warning" | "deprecated" | "danger";
+        docsUrl?: string | undefined;
+    };
+}, {
+    type: "warning";
+    warning: {
+        message: string;
+        code: string;
+        severity: "info" | "warning" | "deprecated" | "danger";
+        docsUrl?: string | undefined;
+    };
+}>]>;
+/**
+ * Thrown when an envelope does not conform to `dataforge.cli.v1`. Surfaces
+ * the Zod issue list so the offending field/value is visible.
+ *
+ * Design choice (loud errors, no silent fallback):
+ *  - In `NODE_ENV !== 'production'` we throw immediately.
+ *  - In production we log to stderr and emit a synthesized error envelope
+ *    (handled by the caller in `output/json.ts`).
+ */
+export declare class EnvelopeViolationError extends Error {
+    readonly issues: z.ZodIssue[];
+    constructor(issues: z.ZodIssue[]);
+}
+/**
+ * Parse + assert. Returns the envelope unchanged on success. Throws
+ * `EnvelopeViolationError` on contract violation.
+ */
+export declare function assertEnvelope<T = unknown>(value: unknown): CliEnvelope<T>;
+/**
+ * Non-throwing variant. Returns `{ ok: true, value }` or `{ ok: false, issues }`.
+ * Use in production paths where we prefer to log + emit a synthesized error
+ * envelope rather than crash the CLI.
+ */
+export declare function tryAssertEnvelope<T = unknown>(value: unknown): {
+    ok: true;
+    value: CliEnvelope<T>;
+} | {
+    ok: false;
+    issues: z.ZodIssue[];
+};
+export {};
+//# sourceMappingURL=envelope.schema.d.ts.map