@kya-os/cli 2.0.0 → 2.0.2

package/node_modules/@kya-os/contracts/dist/workbench/economics.d.ts

@@ -0,0 +1,1097 @@
+import { z } from 'zod';
+export declare const CostDimensionSchema: z.ZodEnum<["input", "output", "cache_read", "cache_write_short", "cache_write_long", "cache_write_unspecified", "cache_storage"]>;
+export declare const InputAccountingSchema: z.ZodEnum<["excludes_cache", "includes_read_only", "includes_read_and_write"]>;
+/** Rates are micro-USD per million tokens (storage: million token-hours).
+ * Null is unpriced. Zero is explicitly free. Never infer subscription prices. */
+export declare const PriceScheduleSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    currency: z.ZodLiteral<"USD">;
+    provider: z.ZodString;
+    model: z.ZodString;
+    version: z.ZodString;
+    sourceUrl: z.ZodEffects<z.ZodString, string, string>;
+    inputAccounting: z.ZodEnum<["excludes_cache", "includes_read_only", "includes_read_and_write"]>;
+    rates: z.ZodObject<{
+        input: z.ZodNullable<z.ZodNumber>;
+        output: z.ZodNullable<z.ZodNumber>;
+        cache_read: z.ZodNullable<z.ZodNumber>;
+        cache_write_short: z.ZodNullable<z.ZodNumber>;
+        cache_write_long: z.ZodNullable<z.ZodNumber>;
+        cache_write_unspecified: z.ZodNullable<z.ZodNumber>;
+        cache_storage: z.ZodNullable<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        input: number | null;
+        output: number | null;
+        cache_read: number | null;
+        cache_write_short: number | null;
+        cache_write_long: number | null;
+        cache_write_unspecified: number | null;
+        cache_storage: number | null;
+    }, {
+        input: number | null;
+        output: number | null;
+        cache_read: number | null;
+        cache_write_short: number | null;
+        cache_write_long: number | null;
+        cache_write_unspecified: number | null;
+        cache_storage: number | null;
+    }>;
+}, "strict", z.ZodTypeAny, {
+    version: string;
+    provider: string;
+    model: string;
+    schemaVersion: 1;
+    currency: "USD";
+    sourceUrl: string;
+    inputAccounting: "excludes_cache" | "includes_read_only" | "includes_read_and_write";
+    rates: {
+        input: number | null;
+        output: number | null;
+        cache_read: number | null;
+        cache_write_short: number | null;
+        cache_write_long: number | null;
+        cache_write_unspecified: number | null;
+        cache_storage: number | null;
+    };
+}, {
+    version: string;
+    provider: string;
+    model: string;
+    schemaVersion: 1;
+    currency: "USD";
+    sourceUrl: string;
+    inputAccounting: "excludes_cache" | "includes_read_only" | "includes_read_and_write";
+    rates: {
+        input: number | null;
+        output: number | null;
+        cache_read: number | null;
+        cache_write_short: number | null;
+        cache_write_long: number | null;
+        cache_write_unspecified: number | null;
+        cache_storage: number | null;
+    };
+}>;
+export declare const CostQuantitiesSchema: z.ZodObject<{
+    /** Storage quantity is observed token-milliseconds, never idle session time. */
+    values: z.ZodObject<{
+        input: z.ZodNullable<z.ZodNumber>;
+        output: z.ZodNullable<z.ZodNumber>;
+        cache_read: z.ZodNullable<z.ZodNumber>;
+        cache_write_short: z.ZodNullable<z.ZodNumber>;
+        cache_write_long: z.ZodNullable<z.ZodNumber>;
+        cache_write_unspecified: z.ZodNullable<z.ZodNumber>;
+        cache_storage: z.ZodNullable<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        input: number | null;
+        output: number | null;
+        cache_read: number | null;
+        cache_write_short: number | null;
+        cache_write_long: number | null;
+        cache_write_unspecified: number | null;
+        cache_storage: number | null;
+    }, {
+        input: number | null;
+        output: number | null;
+        cache_read: number | null;
+        cache_write_short: number | null;
+        cache_write_long: number | null;
+        cache_write_unspecified: number | null;
+        cache_storage: number | null;
+    }>;
+    telemetryComplete: z.ZodBoolean;
+}, "strict", z.ZodTypeAny, {
+    values: {
+        input: number | null;
+        output: number | null;
+        cache_read: number | null;
+        cache_write_short: number | null;
+        cache_write_long: number | null;
+        cache_write_unspecified: number | null;
+        cache_storage: number | null;
+    };
+    telemetryComplete: boolean;
+}, {
+    values: {
+        input: number | null;
+        output: number | null;
+        cache_read: number | null;
+        cache_write_short: number | null;
+        cache_write_long: number | null;
+        cache_write_unspecified: number | null;
+        cache_storage: number | null;
+    };
+    telemetryComplete: boolean;
+}>;
+export declare const CostEstimateSchema: z.ZodEffects<z.ZodObject<{
+    pricing: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<1>;
+        currency: z.ZodLiteral<"USD">;
+        provider: z.ZodString;
+        model: z.ZodString;
+        version: z.ZodString;
+        sourceUrl: z.ZodEffects<z.ZodString, string, string>;
+        inputAccounting: z.ZodEnum<["excludes_cache", "includes_read_only", "includes_read_and_write"]>;
+        rates: z.ZodObject<{
+            input: z.ZodNullable<z.ZodNumber>;
+            output: z.ZodNullable<z.ZodNumber>;
+            cache_read: z.ZodNullable<z.ZodNumber>;
+            cache_write_short: z.ZodNullable<z.ZodNumber>;
+            cache_write_long: z.ZodNullable<z.ZodNumber>;
+            cache_write_unspecified: z.ZodNullable<z.ZodNumber>;
+            cache_storage: z.ZodNullable<z.ZodNumber>;
+        }, "strict", z.ZodTypeAny, {
+            input: number | null;
+            output: number | null;
+            cache_read: number | null;
+            cache_write_short: number | null;
+            cache_write_long: number | null;
+            cache_write_unspecified: number | null;
+            cache_storage: number | null;
+        }, {
+            input: number | null;
+            output: number | null;
+            cache_read: number | null;
+            cache_write_short: number | null;
+            cache_write_long: number | null;
+            cache_write_unspecified: number | null;
+            cache_storage: number | null;
+        }>;
+    }, "strict", z.ZodTypeAny, {
+        version: string;
+        provider: string;
+        model: string;
+        schemaVersion: 1;
+        currency: "USD";
+        sourceUrl: string;
+        inputAccounting: "excludes_cache" | "includes_read_only" | "includes_read_and_write";
+        rates: {
+            input: number | null;
+            output: number | null;
+            cache_read: number | null;
+            cache_write_short: number | null;
+            cache_write_long: number | null;
+            cache_write_unspecified: number | null;
+            cache_storage: number | null;
+        };
+    }, {
+        version: string;
+        provider: string;
+        model: string;
+        schemaVersion: 1;
+        currency: "USD";
+        sourceUrl: string;
+        inputAccounting: "excludes_cache" | "includes_read_only" | "includes_read_and_write";
+        rates: {
+            input: number | null;
+            output: number | null;
+            cache_read: number | null;
+            cache_write_short: number | null;
+            cache_write_long: number | null;
+            cache_write_unspecified: number | null;
+            cache_storage: number | null;
+        };
+    }>;
+    quantities: z.ZodObject<{
+        /** Storage quantity is observed token-milliseconds, never idle session time. */
+        values: z.ZodObject<{
+            input: z.ZodNullable<z.ZodNumber>;
+            output: z.ZodNullable<z.ZodNumber>;
+            cache_read: z.ZodNullable<z.ZodNumber>;
+            cache_write_short: z.ZodNullable<z.ZodNumber>;
+            cache_write_long: z.ZodNullable<z.ZodNumber>;
+            cache_write_unspecified: z.ZodNullable<z.ZodNumber>;
+            cache_storage: z.ZodNullable<z.ZodNumber>;
+        }, "strict", z.ZodTypeAny, {
+            input: number | null;
+            output: number | null;
+            cache_read: number | null;
+            cache_write_short: number | null;
+            cache_write_long: number | null;
+            cache_write_unspecified: number | null;
+            cache_storage: number | null;
+        }, {
+            input: number | null;
+            output: number | null;
+            cache_read: number | null;
+            cache_write_short: number | null;
+            cache_write_long: number | null;
+            cache_write_unspecified: number | null;
+            cache_storage: number | null;
+        }>;
+        telemetryComplete: z.ZodBoolean;
+    }, "strict", z.ZodTypeAny, {
+        values: {
+            input: number | null;
+            output: number | null;
+            cache_read: number | null;
+            cache_write_short: number | null;
+            cache_write_long: number | null;
+            cache_write_unspecified: number | null;
+            cache_storage: number | null;
+        };
+        telemetryComplete: boolean;
+    }, {
+        values: {
+            input: number | null;
+            output: number | null;
+            cache_read: number | null;
+            cache_write_short: number | null;
+            cache_write_long: number | null;
+            cache_write_unspecified: number | null;
+            cache_storage: number | null;
+        };
+        telemetryComplete: boolean;
+    }>;
+    lines: z.ZodObject<{
+        input: z.ZodNullable<z.ZodNumber>;
+        output: z.ZodNullable<z.ZodNumber>;
+        cache_read: z.ZodNullable<z.ZodNumber>;
+        cache_write_short: z.ZodNullable<z.ZodNumber>;
+        cache_write_long: z.ZodNullable<z.ZodNumber>;
+        cache_write_unspecified: z.ZodNullable<z.ZodNumber>;
+        cache_storage: z.ZodNullable<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        input: number | null;
+        output: number | null;
+        cache_read: number | null;
+        cache_write_short: number | null;
+        cache_write_long: number | null;
+        cache_write_unspecified: number | null;
+        cache_storage: number | null;
+    }, {
+        input: number | null;
+        output: number | null;
+        cache_read: number | null;
+        cache_write_short: number | null;
+        cache_write_long: number | null;
+        cache_write_unspecified: number | null;
+        cache_storage: number | null;
+    }>;
+    pricedSubtotalMicroUsd: z.ZodNumber;
+    totalMicroUsd: z.ZodNullable<z.ZodNumber>;
+    missingDimensions: z.ZodArray<z.ZodEnum<["input", "output", "cache_read", "cache_write_short", "cache_write_long", "cache_write_unspecified", "cache_storage"]>, "many">;
+}, "strict", z.ZodTypeAny, {
+    pricing: {
+        version: string;
+        provider: string;
+        model: string;
+        schemaVersion: 1;
+        currency: "USD";
+        sourceUrl: string;
+        inputAccounting: "excludes_cache" | "includes_read_only" | "includes_read_and_write";
+        rates: {
+            input: number | null;
+            output: number | null;
+            cache_read: number | null;
+            cache_write_short: number | null;
+            cache_write_long: number | null;
+            cache_write_unspecified: number | null;
+            cache_storage: number | null;
+        };
+    };
+    quantities: {
+        values: {
+            input: number | null;
+            output: number | null;
+            cache_read: number | null;
+            cache_write_short: number | null;
+            cache_write_long: number | null;
+            cache_write_unspecified: number | null;
+            cache_storage: number | null;
+        };
+        telemetryComplete: boolean;
+    };
+    lines: {
+        input: number | null;
+        output: number | null;
+        cache_read: number | null;
+        cache_write_short: number | null;
+        cache_write_long: number | null;
+        cache_write_unspecified: number | null;
+        cache_storage: number | null;
+    };
+    pricedSubtotalMicroUsd: number;
+    totalMicroUsd: number | null;
+    missingDimensions: ("input" | "output" | "cache_read" | "cache_write_short" | "cache_write_long" | "cache_write_unspecified" | "cache_storage")[];
+}, {
+    pricing: {
+        version: string;
+        provider: string;
+        model: string;
+        schemaVersion: 1;
+        currency: "USD";
+        sourceUrl: string;
+        inputAccounting: "excludes_cache" | "includes_read_only" | "includes_read_and_write";
+        rates: {
+            input: number | null;
+            output: number | null;
+            cache_read: number | null;
+            cache_write_short: number | null;
+            cache_write_long: number | null;
+            cache_write_unspecified: number | null;
+            cache_storage: number | null;
+        };
+    };
+    quantities: {
+        values: {
+            input: number | null;
+            output: number | null;
+            cache_read: number | null;
+            cache_write_short: number | null;
+            cache_write_long: number | null;
+            cache_write_unspecified: number | null;
+            cache_storage: number | null;
+        };
+        telemetryComplete: boolean;
+    };
+    lines: {
+        input: number | null;
+        output: number | null;
+        cache_read: number | null;
+        cache_write_short: number | null;
+        cache_write_long: number | null;
+        cache_write_unspecified: number | null;
+        cache_storage: number | null;
+    };
+    pricedSubtotalMicroUsd: number;
+    totalMicroUsd: number | null;
+    missingDimensions: ("input" | "output" | "cache_read" | "cache_write_short" | "cache_write_long" | "cache_write_unspecified" | "cache_storage")[];
+}>, {
+    pricing: {
+        version: string;
+        provider: string;
+        model: string;
+        schemaVersion: 1;
+        currency: "USD";
+        sourceUrl: string;
+        inputAccounting: "excludes_cache" | "includes_read_only" | "includes_read_and_write";
+        rates: {
+            input: number | null;
+            output: number | null;
+            cache_read: number | null;
+            cache_write_short: number | null;
+            cache_write_long: number | null;
+            cache_write_unspecified: number | null;
+            cache_storage: number | null;
+        };
+    };
+    quantities: {
+        values: {
+            input: number | null;
+            output: number | null;
+            cache_read: number | null;
+            cache_write_short: number | null;
+            cache_write_long: number | null;
+            cache_write_unspecified: number | null;
+            cache_storage: number | null;
+        };
+        telemetryComplete: boolean;
+    };
+    lines: {
+        input: number | null;
+        output: number | null;
+        cache_read: number | null;
+        cache_write_short: number | null;
+        cache_write_long: number | null;
+        cache_write_unspecified: number | null;
+        cache_storage: number | null;
+    };
+    pricedSubtotalMicroUsd: number;
+    totalMicroUsd: number | null;
+    missingDimensions: ("input" | "output" | "cache_read" | "cache_write_short" | "cache_write_long" | "cache_write_unspecified" | "cache_storage")[];
+}, {
+    pricing: {
+        version: string;
+        provider: string;
+        model: string;
+        schemaVersion: 1;
+        currency: "USD";
+        sourceUrl: string;
+        inputAccounting: "excludes_cache" | "includes_read_only" | "includes_read_and_write";
+        rates: {
+            input: number | null;
+            output: number | null;
+            cache_read: number | null;
+            cache_write_short: number | null;
+            cache_write_long: number | null;
+            cache_write_unspecified: number | null;
+            cache_storage: number | null;
+        };
+    };
+    quantities: {
+        values: {
+            input: number | null;
+            output: number | null;
+            cache_read: number | null;
+            cache_write_short: number | null;
+            cache_write_long: number | null;
+            cache_write_unspecified: number | null;
+            cache_storage: number | null;
+        };
+        telemetryComplete: boolean;
+    };
+    lines: {
+        input: number | null;
+        output: number | null;
+        cache_read: number | null;
+        cache_write_short: number | null;
+        cache_write_long: number | null;
+        cache_write_unspecified: number | null;
+        cache_storage: number | null;
+    };
+    pricedSubtotalMicroUsd: number;
+    totalMicroUsd: number | null;
+    missingDimensions: ("input" | "output" | "cache_read" | "cache_write_short" | "cache_write_long" | "cache_write_unspecified" | "cache_storage")[];
+}>;
+export declare const CostBasisSchema: z.ZodEnum<["unknown", "estimated", "provider_reported", "invoice_reconciled"]>;
+export declare const CostPhaseSchema: z.ZodEnum<["planning", "execution", "retry", "review"]>;
+/** Metered usage is priced per unit; subscription-included usage is not billed per request. */
+export declare const BillingBasisSchema: z.ZodEnum<["metered", "subscription_included", "unknown"]>;
+export declare const CostRecordSchema: z.ZodEffects<z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    recordId: z.ZodString;
+    chargeId: z.ZodString;
+    attemptId: z.ZodString;
+    phase: z.ZodEnum<["planning", "execution", "retry", "review"]>;
+    basis: z.ZodEnum<["unknown", "estimated", "provider_reported", "invoice_reconciled"]>;
+    currency: z.ZodLiteral<"USD">;
+    amountMicroUsd: z.ZodNullable<z.ZodNumber>;
+    knownSubtotalMicroUsd: z.ZodNumber;
+    coverageComplete: z.ZodBoolean;
+    sourceRef: z.ZodNullable<z.ZodString>;
+    estimate: z.ZodNullable<z.ZodEffects<z.ZodObject<{
+        pricing: z.ZodObject<{
+            schemaVersion: z.ZodLiteral<1>;
+            currency: z.ZodLiteral<"USD">;
+            provider: z.ZodString;
+            model: z.ZodString;
+            version: z.ZodString;
+            sourceUrl: z.ZodEffects<z.ZodString, string, string>;
+            inputAccounting: z.ZodEnum<["excludes_cache", "includes_read_only", "includes_read_and_write"]>;
+            rates: z.ZodObject<{
+                input: z.ZodNullable<z.ZodNumber>;
+                output: z.ZodNullable<z.ZodNumber>;
+                cache_read: z.ZodNullable<z.ZodNumber>;
+                cache_write_short: z.ZodNullable<z.ZodNumber>;
+                cache_write_long: z.ZodNullable<z.ZodNumber>;
+                cache_write_unspecified: z.ZodNullable<z.ZodNumber>;
+                cache_storage: z.ZodNullable<z.ZodNumber>;
+            }, "strict", z.ZodTypeAny, {
+                input: number | null;
+                output: number | null;
+                cache_read: number | null;
+                cache_write_short: number | null;
+                cache_write_long: number | null;
+                cache_write_unspecified: number | null;
+                cache_storage: number | null;
+            }, {
+                input: number | null;
+                output: number | null;
+                cache_read: number | null;
+                cache_write_short: number | null;
+                cache_write_long: number | null;
+                cache_write_unspecified: number | null;
+                cache_storage: number | null;
+            }>;
+        }, "strict", z.ZodTypeAny, {
+            version: string;
+            provider: string;
+            model: string;
+            schemaVersion: 1;
+            currency: "USD";
+            sourceUrl: string;
+            inputAccounting: "excludes_cache" | "includes_read_only" | "includes_read_and_write";
+            rates: {
+                input: number | null;
+                output: number | null;
+                cache_read: number | null;
+                cache_write_short: number | null;
+                cache_write_long: number | null;
+                cache_write_unspecified: number | null;
+                cache_storage: number | null;
+            };
+        }, {
+            version: string;
+            provider: string;
+            model: string;
+            schemaVersion: 1;
+            currency: "USD";
+            sourceUrl: string;
+            inputAccounting: "excludes_cache" | "includes_read_only" | "includes_read_and_write";
+            rates: {
+                input: number | null;
+                output: number | null;
+                cache_read: number | null;
+                cache_write_short: number | null;
+                cache_write_long: number | null;
+                cache_write_unspecified: number | null;
+                cache_storage: number | null;
+            };
+        }>;
+        quantities: z.ZodObject<{
+            /** Storage quantity is observed token-milliseconds, never idle session time. */
+            values: z.ZodObject<{
+                input: z.ZodNullable<z.ZodNumber>;
+                output: z.ZodNullable<z.ZodNumber>;
+                cache_read: z.ZodNullable<z.ZodNumber>;
+                cache_write_short: z.ZodNullable<z.ZodNumber>;
+                cache_write_long: z.ZodNullable<z.ZodNumber>;
+                cache_write_unspecified: z.ZodNullable<z.ZodNumber>;
+                cache_storage: z.ZodNullable<z.ZodNumber>;
+            }, "strict", z.ZodTypeAny, {
+                input: number | null;
+                output: number | null;
+                cache_read: number | null;
+                cache_write_short: number | null;
+                cache_write_long: number | null;
+                cache_write_unspecified: number | null;
+                cache_storage: number | null;
+            }, {
+                input: number | null;
+                output: number | null;
+                cache_read: number | null;
+                cache_write_short: number | null;
+                cache_write_long: number | null;
+                cache_write_unspecified: number | null;
+                cache_storage: number | null;
+            }>;
+            telemetryComplete: z.ZodBoolean;
+        }, "strict", z.ZodTypeAny, {
+            values: {
+                input: number | null;
+                output: number | null;
+                cache_read: number | null;
+                cache_write_short: number | null;
+                cache_write_long: number | null;
+                cache_write_unspecified: number | null;
+                cache_storage: number | null;
+            };
+            telemetryComplete: boolean;
+        }, {
+            values: {
+                input: number | null;
+                output: number | null;
+                cache_read: number | null;
+                cache_write_short: number | null;
+                cache_write_long: number | null;
+                cache_write_unspecified: number | null;
+                cache_storage: number | null;
+            };
+            telemetryComplete: boolean;
+        }>;
+        lines: z.ZodObject<{
+            input: z.ZodNullable<z.ZodNumber>;
+            output: z.ZodNullable<z.ZodNumber>;
+            cache_read: z.ZodNullable<z.ZodNumber>;
+            cache_write_short: z.ZodNullable<z.ZodNumber>;
+            cache_write_long: z.ZodNullable<z.ZodNumber>;
+            cache_write_unspecified: z.ZodNullable<z.ZodNumber>;
+            cache_storage: z.ZodNullable<z.ZodNumber>;
+        }, "strict", z.ZodTypeAny, {
+            input: number | null;
+            output: number | null;
+            cache_read: number | null;
+            cache_write_short: number | null;
+            cache_write_long: number | null;
+            cache_write_unspecified: number | null;
+            cache_storage: number | null;
+        }, {
+            input: number | null;
+            output: number | null;
+            cache_read: number | null;
+            cache_write_short: number | null;
+            cache_write_long: number | null;
+            cache_write_unspecified: number | null;
+            cache_storage: number | null;
+        }>;
+        pricedSubtotalMicroUsd: z.ZodNumber;
+        totalMicroUsd: z.ZodNullable<z.ZodNumber>;
+        missingDimensions: z.ZodArray<z.ZodEnum<["input", "output", "cache_read", "cache_write_short", "cache_write_long", "cache_write_unspecified", "cache_storage"]>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        pricing: {
+            version: string;
+            provider: string;
+            model: string;
+            schemaVersion: 1;
+            currency: "USD";
+            sourceUrl: string;
+            inputAccounting: "excludes_cache" | "includes_read_only" | "includes_read_and_write";
+            rates: {
+                input: number | null;
+                output: number | null;
+                cache_read: number | null;
+                cache_write_short: number | null;
+                cache_write_long: number | null;
+                cache_write_unspecified: number | null;
+                cache_storage: number | null;
+            };
+        };
+        quantities: {
+            values: {
+                input: number | null;
+                output: number | null;
+                cache_read: number | null;
+                cache_write_short: number | null;
+                cache_write_long: number | null;
+                cache_write_unspecified: number | null;
+                cache_storage: number | null;
+            };
+            telemetryComplete: boolean;
+        };
+        lines: {
+            input: number | null;
+            output: number | null;
+            cache_read: number | null;
+            cache_write_short: number | null;
+            cache_write_long: number | null;
+            cache_write_unspecified: number | null;
+            cache_storage: number | null;
+        };
+        pricedSubtotalMicroUsd: number;
+        totalMicroUsd: number | null;
+        missingDimensions: ("input" | "output" | "cache_read" | "cache_write_short" | "cache_write_long" | "cache_write_unspecified" | "cache_storage")[];
+    }, {
+        pricing: {
+            version: string;
+            provider: string;
+            model: string;
+            schemaVersion: 1;
+            currency: "USD";
+            sourceUrl: string;
+            inputAccounting: "excludes_cache" | "includes_read_only" | "includes_read_and_write";
+            rates: {
+                input: number | null;
+                output: number | null;
+                cache_read: number | null;
+                cache_write_short: number | null;
+                cache_write_long: number | null;
+                cache_write_unspecified: number | null;
+                cache_storage: number | null;
+            };
+        };
+        quantities: {
+            values: {
+                input: number | null;
+                output: number | null;
+                cache_read: number | null;
+                cache_write_short: number | null;
+                cache_write_long: number | null;
+                cache_write_unspecified: number | null;
+                cache_storage: number | null;
+            };
+            telemetryComplete: boolean;
+        };
+        lines: {
+            input: number | null;
+            output: number | null;
+            cache_read: number | null;
+            cache_write_short: number | null;
+            cache_write_long: number | null;
+            cache_write_unspecified: number | null;
+            cache_storage: number | null;
+        };
+        pricedSubtotalMicroUsd: number;
+        totalMicroUsd: number | null;
+        missingDimensions: ("input" | "output" | "cache_read" | "cache_write_short" | "cache_write_long" | "cache_write_unspecified" | "cache_storage")[];
+    }>, {
+        pricing: {
+            version: string;
+            provider: string;
+            model: string;
+            schemaVersion: 1;
+            currency: "USD";
+            sourceUrl: string;
+            inputAccounting: "excludes_cache" | "includes_read_only" | "includes_read_and_write";
+            rates: {
+                input: number | null;
+                output: number | null;
+                cache_read: number | null;
+                cache_write_short: number | null;
+                cache_write_long: number | null;
+                cache_write_unspecified: number | null;
+                cache_storage: number | null;
+            };
+        };
+        quantities: {
+            values: {
+                input: number | null;
+                output: number | null;
+                cache_read: number | null;
+                cache_write_short: number | null;
+                cache_write_long: number | null;
+                cache_write_unspecified: number | null;
+                cache_storage: number | null;
+            };
+            telemetryComplete: boolean;
+        };
+        lines: {
+            input: number | null;
+            output: number | null;
+            cache_read: number | null;
+            cache_write_short: number | null;
+            cache_write_long: number | null;
+            cache_write_unspecified: number | null;
+            cache_storage: number | null;
+        };
+        pricedSubtotalMicroUsd: number;
+        totalMicroUsd: number | null;
+        missingDimensions: ("input" | "output" | "cache_read" | "cache_write_short" | "cache_write_long" | "cache_write_unspecified" | "cache_storage")[];
+    }, {
+        pricing: {
+            version: string;
+            provider: string;
+            model: string;
+            schemaVersion: 1;
+            currency: "USD";
+            sourceUrl: string;
+            inputAccounting: "excludes_cache" | "includes_read_only" | "includes_read_and_write";
+            rates: {
+                input: number | null;
+                output: number | null;
+                cache_read: number | null;
+                cache_write_short: number | null;
+                cache_write_long: number | null;
+                cache_write_unspecified: number | null;
+                cache_storage: number | null;
+            };
+        };
+        quantities: {
+            values: {
+                input: number | null;
+                output: number | null;
+                cache_read: number | null;
+                cache_write_short: number | null;
+                cache_write_long: number | null;
+                cache_write_unspecified: number | null;
+                cache_storage: number | null;
+            };
+            telemetryComplete: boolean;
+        };
+        lines: {
+            input: number | null;
+            output: number | null;
+            cache_read: number | null;
+            cache_write_short: number | null;
+            cache_write_long: number | null;
+            cache_write_unspecified: number | null;
+            cache_storage: number | null;
+        };
+        pricedSubtotalMicroUsd: number;
+        totalMicroUsd: number | null;
+        missingDimensions: ("input" | "output" | "cache_read" | "cache_write_short" | "cache_write_long" | "cache_write_unspecified" | "cache_storage")[];
+    }>>;
+    recordedAtMs: z.ZodNumber;
+    /** Who billed or reported the charge; required for reported and invoice records. */
+    provider: z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodString>;
+    billingBasis: z.ZodOptional<z.ZodEnum<["metered", "subscription_included", "unknown"]>>;
+}, "strict", z.ZodTypeAny, {
+    schemaVersion: 1;
+    currency: "USD";
+    recordId: string;
+    chargeId: string;
+    attemptId: string;
+    phase: "planning" | "execution" | "retry" | "review";
+    basis: "unknown" | "estimated" | "provider_reported" | "invoice_reconciled";
+    amountMicroUsd: number | null;
+    knownSubtotalMicroUsd: number;
+    coverageComplete: boolean;
+    sourceRef: string | null;
+    estimate: {
+        pricing: {
+            version: string;
+            provider: string;
+            model: string;
+            schemaVersion: 1;
+            currency: "USD";
+            sourceUrl: string;
+            inputAccounting: "excludes_cache" | "includes_read_only" | "includes_read_and_write";
+            rates: {
+                input: number | null;
+                output: number | null;
+                cache_read: number | null;
+                cache_write_short: number | null;
+                cache_write_long: number | null;
+                cache_write_unspecified: number | null;
+                cache_storage: number | null;
+            };
+        };
+        quantities: {
+            values: {
+                input: number | null;
+                output: number | null;
+                cache_read: number | null;
+                cache_write_short: number | null;
+                cache_write_long: number | null;
+                cache_write_unspecified: number | null;
+                cache_storage: number | null;
+            };
+            telemetryComplete: boolean;
+        };
+        lines: {
+            input: number | null;
+            output: number | null;
+            cache_read: number | null;
+            cache_write_short: number | null;
+            cache_write_long: number | null;
+            cache_write_unspecified: number | null;
+            cache_storage: number | null;
+        };
+        pricedSubtotalMicroUsd: number;
+        totalMicroUsd: number | null;
+        missingDimensions: ("input" | "output" | "cache_read" | "cache_write_short" | "cache_write_long" | "cache_write_unspecified" | "cache_storage")[];
+    } | null;
+    recordedAtMs: number;
+    provider?: string | undefined;
+    model?: string | undefined;
+    billingBasis?: "unknown" | "subscription_included" | "metered" | undefined;
+}, {
+    schemaVersion: 1;
+    currency: "USD";
+    recordId: string;
+    chargeId: string;
+    attemptId: string;
+    phase: "planning" | "execution" | "retry" | "review";
+    basis: "unknown" | "estimated" | "provider_reported" | "invoice_reconciled";
+    amountMicroUsd: number | null;
+    knownSubtotalMicroUsd: number;
+    coverageComplete: boolean;
+    sourceRef: string | null;
+    estimate: {
+        pricing: {
+            version: string;
+            provider: string;
+            model: string;
+            schemaVersion: 1;
+            currency: "USD";
+            sourceUrl: string;
+            inputAccounting: "excludes_cache" | "includes_read_only" | "includes_read_and_write";
+            rates: {
+                input: number | null;
+                output: number | null;
+                cache_read: number | null;
+                cache_write_short: number | null;
+                cache_write_long: number | null;
+                cache_write_unspecified: number | null;
+                cache_storage: number | null;
+            };
+        };
+        quantities: {
+            values: {
+                input: number | null;
+                output: number | null;
+                cache_read: number | null;
+                cache_write_short: number | null;
+                cache_write_long: number | null;
+                cache_write_unspecified: number | null;
+                cache_storage: number | null;
+            };
+            telemetryComplete: boolean;
+        };
+        lines: {
+            input: number | null;
+            output: number | null;
+            cache_read: number | null;
+            cache_write_short: number | null;
+            cache_write_long: number | null;
+            cache_write_unspecified: number | null;
+            cache_storage: number | null;
+        };
+        pricedSubtotalMicroUsd: number;
+        totalMicroUsd: number | null;
+        missingDimensions: ("input" | "output" | "cache_read" | "cache_write_short" | "cache_write_long" | "cache_write_unspecified" | "cache_storage")[];
+    } | null;
+    recordedAtMs: number;
+    provider?: string | undefined;
+    model?: string | undefined;
+    billingBasis?: "unknown" | "subscription_included" | "metered" | undefined;
+}>, {
+    schemaVersion: 1;
+    currency: "USD";
+    recordId: string;
+    chargeId: string;
+    attemptId: string;
+    phase: "planning" | "execution" | "retry" | "review";
+    basis: "unknown" | "estimated" | "provider_reported" | "invoice_reconciled";
+    amountMicroUsd: number | null;
+    knownSubtotalMicroUsd: number;
+    coverageComplete: boolean;
+    sourceRef: string | null;
+    estimate: {
+        pricing: {
+            version: string;
+            provider: string;
+            model: string;
+            schemaVersion: 1;
+            currency: "USD";
+            sourceUrl: string;
+            inputAccounting: "excludes_cache" | "includes_read_only" | "includes_read_and_write";
+            rates: {
+                input: number | null;
+                output: number | null;
+                cache_read: number | null;
+                cache_write_short: number | null;
+                cache_write_long: number | null;
+                cache_write_unspecified: number | null;
+                cache_storage: number | null;
+            };
+        };
+        quantities: {
+            values: {
+                input: number | null;
+                output: number | null;
+                cache_read: number | null;
+                cache_write_short: number | null;
+                cache_write_long: number | null;
+                cache_write_unspecified: number | null;
+                cache_storage: number | null;
+            };
+            telemetryComplete: boolean;
+        };
+        lines: {
+            input: number | null;
+            output: number | null;
+            cache_read: number | null;
+            cache_write_short: number | null;
+            cache_write_long: number | null;
+            cache_write_unspecified: number | null;
+            cache_storage: number | null;
+        };
+        pricedSubtotalMicroUsd: number;
+        totalMicroUsd: number | null;
+        missingDimensions: ("input" | "output" | "cache_read" | "cache_write_short" | "cache_write_long" | "cache_write_unspecified" | "cache_storage")[];
+    } | null;
+    recordedAtMs: number;
+    provider?: string | undefined;
+    model?: string | undefined;
+    billingBasis?: "unknown" | "subscription_included" | "metered" | undefined;
+}, {
+    schemaVersion: 1;
+    currency: "USD";
+    recordId: string;
+    chargeId: string;
+    attemptId: string;
+    phase: "planning" | "execution" | "retry" | "review";
+    basis: "unknown" | "estimated" | "provider_reported" | "invoice_reconciled";
+    amountMicroUsd: number | null;
+    knownSubtotalMicroUsd: number;
+    coverageComplete: boolean;
+    sourceRef: string | null;
+    estimate: {
+        pricing: {
+            version: string;
+            provider: string;
+            model: string;
+            schemaVersion: 1;
+            currency: "USD";
+            sourceUrl: string;
+            inputAccounting: "excludes_cache" | "includes_read_only" | "includes_read_and_write";
+            rates: {
+                input: number | null;
+                output: number | null;
+                cache_read: number | null;
+                cache_write_short: number | null;
+                cache_write_long: number | null;
+                cache_write_unspecified: number | null;
+                cache_storage: number | null;
+            };
+        };
+        quantities: {
+            values: {
+                input: number | null;
+                output: number | null;
+                cache_read: number | null;
+                cache_write_short: number | null;
+                cache_write_long: number | null;
+                cache_write_unspecified: number | null;
+                cache_storage: number | null;
+            };
+            telemetryComplete: boolean;
+        };
+        lines: {
+            input: number | null;
+            output: number | null;
+            cache_read: number | null;
+            cache_write_short: number | null;
+            cache_write_long: number | null;
+            cache_write_unspecified: number | null;
+            cache_storage: number | null;
+        };
+        pricedSubtotalMicroUsd: number;
+        totalMicroUsd: number | null;
+        missingDimensions: ("input" | "output" | "cache_read" | "cache_write_short" | "cache_write_long" | "cache_write_unspecified" | "cache_storage")[];
+    } | null;
+    recordedAtMs: number;
+    provider?: string | undefined;
+    model?: string | undefined;
+    billingBasis?: "unknown" | "subscription_included" | "metered" | undefined;
+}>;
+/** Local admission allowance; it does not impose a provider monetary cap. */
+export declare const BudgetAccountSchema: z.ZodObject<{
+    id: z.ZodString;
+    parentId: z.ZodNullable<z.ZodString>;
+    limitMicroUsd: z.ZodNumber;
+}, "strict", z.ZodTypeAny, {
+    id: string;
+    parentId: string | null;
+    limitMicroUsd: number;
+}, {
+    id: string;
+    parentId: string | null;
+    limitMicroUsd: number;
+}>;
+export declare const ReservationRequestSchema: z.ZodObject<{
+    id: z.ZodString;
+    attemptId: z.ZodString;
+    budgetId: z.ZodString;
+    amountMicroUsd: z.ZodNumber;
+    createdAtMs: z.ZodNumber;
+}, "strict", z.ZodTypeAny, {
+    id: string;
+    attemptId: string;
+    amountMicroUsd: number;
+    budgetId: string;
+    createdAtMs: number;
+}, {
+    id: string;
+    attemptId: string;
+    amountMicroUsd: number;
+    budgetId: string;
+    createdAtMs: number;
+}>;
+export declare const BudgetSettlementSchema: z.ZodDiscriminatedUnion<"state", [z.ZodObject<{
+    state: z.ZodLiteral<"known">;
+    costRecordId: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    state: "known";
+    costRecordId: string;
+}, {
+    state: "known";
+    costRecordId: string;
+}>, z.ZodObject<{
+    state: z.ZodLiteral<"unknown">;
+    costRecordId: z.ZodNullable<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    state: "unknown";
+    costRecordId: string | null;
+}, {
+    state: "unknown";
+    costRecordId: string | null;
+}>, z.ZodObject<{
+    state: z.ZodLiteral<"not_started">;
+    evidenceRef: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    state: "not_started";
+    evidenceRef: string;
+}, {
+    state: "not_started";
+    evidenceRef: string;
+}>]>;
+export type PriceSchedule = z.infer<typeof PriceScheduleSchema>;
+export type CostQuantities = z.infer<typeof CostQuantitiesSchema>;
+export type CostEstimate = z.infer<typeof CostEstimateSchema>;
+export type CostRecord = z.infer<typeof CostRecordSchema>;
+export type BillingBasis = z.infer<typeof BillingBasisSchema>;
+export type BudgetAccount = z.infer<typeof BudgetAccountSchema>;
+export type ReservationRequest = z.infer<typeof ReservationRequestSchema>;
+export type BudgetSettlement = z.infer<typeof BudgetSettlementSchema>;