@greatwait/contracts 0.1.0-alpha.3 → 0.1.0-alpha.5

package/dist/billing.d.ts

@@ -0,0 +1,1231 @@
+import { z } from "./zod.js";
+import { projectIdSchema } from "./identifiers.js";
+export declare const BILLING_AMOUNT_SCALE: 6;
+export declare const BILLING_CURRENCY: "USD";
+/**
+ * Exact integer money on the wire.
+ *
+ * PostgreSQL uses `bigint`; JSON uses a canonical decimal string because a
+ * JavaScript number cannot represent every ledger amount without rounding.
+ */
+export declare const microdollarAmountSchema: import("zod").ZodString;
+export declare const nonnegativeMicrodollarAmountSchema: import("zod").ZodString;
+export declare const BILLING_ACTIVATION_MODES: readonly ["disabled", "shadow", "enforced"];
+export declare const BILLING_BLOCK_REASONS: readonly ["billing-state-missing", "billing-account-closed", "project-ineligible", "insufficient-credit", "execution-cap-reached"];
+export declare const BILLING_ENTRY_KINDS: readonly ["credit_granted", "credit_reversed", "attempt_debited", "attempt_released", "shadow_attempt_debited", "shadow_attempt_released", "late_evidence_waived", "policy_installed", "budget_policy_updated", "budget_threshold_reached", "budget_exhausted", "budget_recovered", "automatic_charge_ceiling_updated", "payment_reserved", "payment_submitted", "payment_pending", "payment_paid", "payment_failed", "payment_canceled", "payment_authentication_required", "payment_action_required", "payment_refunded", "payment_disputed", "payment_reversed", "payment_dispute_restored", "refund_requested", "payment_refund_canceled", "automatic_top_up_cap_reached", "automatic_charge_threshold_reached", "automatic_charge_threshold_recovered", "low_credit_reached", "low_credit_recovered", "notification_settings_updated", "service_blocked", "service_restored"];
+/**
+ * Why a ledger entry that looks like money moved none.
+ *
+ * `provider-details-attached`: the payment provider reported details of a
+ * payment the ledger already recorded — its charge, receipt, hosted page or
+ * tax. The entry repeats the payment's kind and shows a zero amount, so one
+ * purchase never reads as two.
+ */
+export declare const BILLING_LEDGER_ENTRY_NOTES: readonly ["provider-details-attached"];
+export declare const BILLING_PAYMENT_KINDS: readonly ["manual", "automatic"];
+export declare const BILLING_PAYMENT_STATES: readonly ["pending", "paid", "failed", "authentication-required", "action-required", "canceled", "refunded", "reversed", "disputed"];
+declare const nonnegativeExactMoneySchema: import("zod").ZodObject<{
+    currency: import("zod").ZodLiteral<"USD">;
+    microdollars: import("zod").ZodString;
+    scale: import("zod").ZodLiteral<6>;
+}, import("zod/v4/core").$strip>;
+export declare const exactCentMoneySchema: import("zod").ZodObject<{
+    currency: import("zod").ZodLiteral<"USD">;
+    microdollars: import("zod").ZodString;
+    scale: import("zod").ZodLiteral<6>;
+}, import("zod/v4/core").$strip>;
+export declare const manualFundingCreditSchema: import("zod").ZodObject<{
+    currency: import("zod").ZodLiteral<"USD">;
+    microdollars: import("zod").ZodString;
+    scale: import("zod").ZodLiteral<6>;
+}, import("zod/v4/core").$strip>;
+export declare const billingAutoTopUpConfigurationSchema: import("zod").ZodObject<{
+    ceiling: import("zod").ZodObject<{
+        currency: import("zod").ZodLiteral<"USD">;
+        microdollars: import("zod").ZodString;
+        scale: import("zod").ZodLiteral<6>;
+    }, import("zod/v4/core").$strip>;
+    credit: import("zod").ZodObject<{
+        currency: import("zod").ZodLiteral<"USD">;
+        microdollars: import("zod").ZodString;
+        scale: import("zod").ZodLiteral<6>;
+    }, import("zod/v4/core").$strip>;
+    triggerBelow: import("zod").ZodObject<{
+        currency: import("zod").ZodLiteral<"USD">;
+        microdollars: import("zod").ZodString;
+        scale: import("zod").ZodLiteral<6>;
+    }, import("zod/v4/core").$strip>;
+}, import("zod/v4/core").$strict>;
+export declare const billingAutoTopUpPreviewRequestSchema: import("zod").ZodObject<{
+    action: import("zod").ZodEnum<{
+        enable: "enable";
+        edit: "edit";
+        disable: "disable";
+        resume: "resume";
+    }>;
+    ceiling: import("zod").ZodOptional<import("zod").ZodObject<{
+        currency: import("zod").ZodLiteral<"USD">;
+        microdollars: import("zod").ZodString;
+        scale: import("zod").ZodLiteral<6>;
+    }, import("zod/v4/core").$strip>>;
+    credit: import("zod").ZodOptional<import("zod").ZodObject<{
+        currency: import("zod").ZodLiteral<"USD">;
+        microdollars: import("zod").ZodString;
+        scale: import("zod").ZodLiteral<6>;
+    }, import("zod/v4/core").$strip>>;
+    expectedRevision: import("zod").ZodNumber;
+    triggerBelow: import("zod").ZodOptional<import("zod").ZodObject<{
+        currency: import("zod").ZodLiteral<"USD">;
+        microdollars: import("zod").ZodString;
+        scale: import("zod").ZodLiteral<6>;
+    }, import("zod/v4/core").$strip>>;
+}, import("zod/v4/core").$strict>;
+export declare const billingAutoTopUpApplyRequestSchema: import("zod").ZodObject<{
+    confirmed: import("zod").ZodLiteral<true>;
+    expectedRevision: import("zod").ZodNumber;
+    preview: import("zod").ZodString;
+}, import("zod/v4/core").$strict>;
+export declare const billingFundingQuoteRequestSchema: import("zod").ZodObject<{
+    credit: import("zod").ZodObject<{
+        currency: import("zod").ZodLiteral<"USD">;
+        microdollars: import("zod").ZodString;
+        scale: import("zod").ZodLiteral<6>;
+    }, import("zod/v4/core").$strip>;
+}, import("zod/v4/core").$strict>;
+export declare const billingFundingQuoteSchema: import("zod").ZodObject<{
+    credit: import("zod").ZodObject<{
+        currency: import("zod").ZodLiteral<"USD">;
+        microdollars: import("zod").ZodString;
+        scale: import("zod").ZodLiteral<6>;
+    }, import("zod/v4/core").$strip>;
+    expectedRevision: import("zod").ZodNumber;
+    expiresAt: import("zod").ZodString;
+    gross: import("zod").ZodLiteral<null>;
+    quote: import("zod").ZodString;
+    tax: import("zod").ZodLiteral<null>;
+    taxStatus: import("zod").ZodLiteral<"calculated-at-checkout">;
+}, import("zod/v4/core").$strict>;
+export declare const billingPurchaseRequestSchema: import("zod").ZodObject<{
+    automaticTopUp: import("zod").ZodOptional<import("zod").ZodBoolean>;
+    confirmed: import("zod").ZodLiteral<true>;
+    expectedRevision: import("zod").ZodNumber;
+    quote: import("zod").ZodString;
+}, import("zod/v4/core").$strict>;
+export declare const billingCeilingUpdateRequestSchema: import("zod").ZodObject<{
+    automaticExecutionTopUpCeiling: import("zod").ZodNullable<import("zod").ZodObject<{
+        currency: import("zod").ZodLiteral<"USD">;
+        microdollars: import("zod").ZodString;
+        scale: import("zod").ZodLiteral<6>;
+    }, import("zod/v4/core").$strip>>;
+    expectedRevision: import("zod").ZodNumber;
+}, import("zod/v4/core").$strict>;
+export declare const billingAutoTopUpRuleSchema: import("zod").ZodObject<{
+    cooldownUntil: import("zod").ZodNullable<import("zod").ZodString>;
+    desired: import("zod").ZodNullable<import("zod").ZodObject<{
+        ceiling: import("zod").ZodObject<{
+            currency: import("zod").ZodLiteral<"USD">;
+            microdollars: import("zod").ZodString;
+            scale: import("zod").ZodLiteral<6>;
+        }, import("zod/v4/core").$strip>;
+        credit: import("zod").ZodObject<{
+            currency: import("zod").ZodLiteral<"USD">;
+            microdollars: import("zod").ZodString;
+            scale: import("zod").ZodLiteral<6>;
+        }, import("zod/v4/core").$strip>;
+        triggerBelow: import("zod").ZodObject<{
+            currency: import("zod").ZodLiteral<"USD">;
+            microdollars: import("zod").ZodString;
+            scale: import("zod").ZodLiteral<6>;
+        }, import("zod/v4/core").$strip>;
+    }, import("zod/v4/core").$strict>>;
+    effective: import("zod").ZodNullable<import("zod").ZodObject<{
+        ceiling: import("zod").ZodObject<{
+            currency: import("zod").ZodLiteral<"USD">;
+            microdollars: import("zod").ZodString;
+            scale: import("zod").ZodLiteral<6>;
+        }, import("zod/v4/core").$strip>;
+        credit: import("zod").ZodObject<{
+            currency: import("zod").ZodLiteral<"USD">;
+            microdollars: import("zod").ZodString;
+            scale: import("zod").ZodLiteral<6>;
+        }, import("zod/v4/core").$strip>;
+        triggerBelow: import("zod").ZodObject<{
+            currency: import("zod").ZodLiteral<"USD">;
+            microdollars: import("zod").ZodString;
+            scale: import("zod").ZodLiteral<6>;
+        }, import("zod/v4/core").$strip>;
+    }, import("zod/v4/core").$strict>>;
+    setupUrl: import("zod").ZodOptional<import("zod").ZodString>;
+    state: import("zod").ZodEnum<{
+        disabled: "disabled";
+        "payment-method-required": "payment-method-required";
+        ready: "ready";
+    }>;
+    suspension: import("zod").ZodNullable<import("zod").ZodObject<{
+        at: import("zod").ZodString;
+        reason: import("zod").ZodEnum<{
+            "authentication-required": "authentication-required";
+            "payment-failed": "payment-failed";
+        }>;
+    }, import("zod/v4/core").$strict>>;
+}, import("zod/v4/core").$strict>;
+export declare const billingAutoTopUpPreviewSchema: import("zod").ZodObject<{
+    action: import("zod").ZodEnum<{
+        enable: "enable";
+        edit: "edit";
+        disable: "disable";
+        resume: "resume";
+    }>;
+    after: import("zod").ZodNullable<import("zod").ZodObject<{
+        ceiling: import("zod").ZodObject<{
+            currency: import("zod").ZodLiteral<"USD">;
+            microdollars: import("zod").ZodString;
+            scale: import("zod").ZodLiteral<6>;
+        }, import("zod/v4/core").$strip>;
+        credit: import("zod").ZodObject<{
+            currency: import("zod").ZodLiteral<"USD">;
+            microdollars: import("zod").ZodString;
+            scale: import("zod").ZodLiteral<6>;
+        }, import("zod/v4/core").$strip>;
+        triggerBelow: import("zod").ZodObject<{
+            currency: import("zod").ZodLiteral<"USD">;
+            microdollars: import("zod").ZodString;
+            scale: import("zod").ZodLiteral<6>;
+        }, import("zod/v4/core").$strip>;
+    }, import("zod/v4/core").$strict>>;
+    before: import("zod").ZodNullable<import("zod").ZodObject<{
+        ceiling: import("zod").ZodObject<{
+            currency: import("zod").ZodLiteral<"USD">;
+            microdollars: import("zod").ZodString;
+            scale: import("zod").ZodLiteral<6>;
+        }, import("zod/v4/core").$strip>;
+        credit: import("zod").ZodObject<{
+            currency: import("zod").ZodLiteral<"USD">;
+            microdollars: import("zod").ZodString;
+            scale: import("zod").ZodLiteral<6>;
+        }, import("zod/v4/core").$strip>;
+        triggerBelow: import("zod").ZodObject<{
+            currency: import("zod").ZodLiteral<"USD">;
+            microdollars: import("zod").ZodString;
+            scale: import("zod").ZodLiteral<6>;
+        }, import("zod/v4/core").$strip>;
+    }, import("zod/v4/core").$strict>>;
+    currentPeriod: import("zod").ZodObject<{
+        end: import("zod").ZodString;
+        pending: import("zod").ZodObject<{
+            currency: import("zod").ZodLiteral<"USD">;
+            microdollars: import("zod").ZodString;
+            scale: import("zod").ZodLiteral<6>;
+        }, import("zod/v4/core").$strip>;
+        remaining: import("zod").ZodNullable<import("zod").ZodObject<{
+            currency: import("zod").ZodLiteral<"USD">;
+            microdollars: import("zod").ZodString;
+            scale: import("zod").ZodLiteral<6>;
+        }, import("zod/v4/core").$strip>>;
+        settled: import("zod").ZodObject<{
+            currency: import("zod").ZodLiteral<"USD">;
+            microdollars: import("zod").ZodString;
+            scale: import("zod").ZodLiteral<6>;
+        }, import("zod/v4/core").$strip>;
+        start: import("zod").ZodString;
+    }, import("zod/v4/core").$strict>;
+    expectedRevision: import("zod").ZodNumber;
+    expandsAuthority: import("zod").ZodBoolean;
+    expiresAt: import("zod").ZodString;
+    preview: import("zod").ZodString;
+    subscribedProjectFees: import("zod").ZodObject<{
+        currency: import("zod").ZodLiteral<"USD">;
+        microdollars: import("zod").ZodString;
+        scale: import("zod").ZodLiteral<6>;
+    }, import("zod/v4/core").$strip>;
+}, import("zod/v4/core").$strict>;
+export declare const billingPaymentOperationSchema: import("zod").ZodObject<{
+    createdAt: import("zod").ZodString;
+    credit: import("zod").ZodObject<{
+        currency: import("zod").ZodLiteral<"USD">;
+        microdollars: import("zod").ZodString;
+        scale: import("zod").ZodLiteral<6>;
+    }, import("zod/v4/core").$strip>;
+    gross: import("zod").ZodNullable<import("zod").ZodObject<{
+        currency: import("zod").ZodLiteral<"USD">;
+        microdollars: import("zod").ZodString;
+        scale: import("zod").ZodLiteral<6>;
+    }, import("zod/v4/core").$strip>>;
+    id: import("zod").ZodString;
+    kind: import("zod").ZodEnum<{
+        manual: "manual";
+        automatic: "automatic";
+    }>;
+    paymentUrl: import("zod").ZodOptional<import("zod").ZodString>;
+    reason: import("zod").ZodOptional<import("zod").ZodString>;
+    receiptUrl: import("zod").ZodOptional<import("zod").ZodString>;
+    state: import("zod").ZodEnum<{
+        pending: "pending";
+        paid: "paid";
+        failed: "failed";
+        "authentication-required": "authentication-required";
+        "action-required": "action-required";
+        canceled: "canceled";
+        refunded: "refunded";
+        reversed: "reversed";
+        disputed: "disputed";
+    }>;
+    tax: import("zod").ZodNullable<import("zod").ZodObject<{
+        currency: import("zod").ZodLiteral<"USD">;
+        microdollars: import("zod").ZodString;
+        scale: import("zod").ZodLiteral<6>;
+    }, import("zod/v4/core").$strip>>;
+    taxStatus: import("zod").ZodEnum<{
+        confirmed: "confirmed";
+        "calculated-at-checkout": "calculated-at-checkout";
+    }>;
+    updatedAt: import("zod").ZodString;
+}, import("zod/v4/core").$strict>;
+export declare const billingFundingViewSchema: import("zod").ZodObject<{
+    automaticExecutionTopUp: import("zod").ZodObject<{
+        ceiling: import("zod").ZodNullable<import("zod").ZodObject<{
+            currency: import("zod").ZodLiteral<"USD">;
+            microdollars: import("zod").ZodString;
+            scale: import("zod").ZodLiteral<6>;
+        }, import("zod/v4/core").$strip>>;
+        currentPeriod: import("zod").ZodObject<{
+            end: import("zod").ZodString;
+            pending: import("zod").ZodObject<{
+                currency: import("zod").ZodLiteral<"USD">;
+                microdollars: import("zod").ZodString;
+                scale: import("zod").ZodLiteral<6>;
+            }, import("zod/v4/core").$strip>;
+            remaining: import("zod").ZodNullable<import("zod").ZodObject<{
+                currency: import("zod").ZodLiteral<"USD">;
+                microdollars: import("zod").ZodString;
+                scale: import("zod").ZodLiteral<6>;
+            }, import("zod/v4/core").$strip>>;
+            settled: import("zod").ZodObject<{
+                currency: import("zod").ZodLiteral<"USD">;
+                microdollars: import("zod").ZodString;
+                scale: import("zod").ZodLiteral<6>;
+            }, import("zod/v4/core").$strip>;
+            start: import("zod").ZodString;
+        }, import("zod/v4/core").$strip>;
+        rule: import("zod").ZodObject<{
+            cooldownUntil: import("zod").ZodNullable<import("zod").ZodString>;
+            desired: import("zod").ZodNullable<import("zod").ZodObject<{
+                ceiling: import("zod").ZodObject<{
+                    currency: import("zod").ZodLiteral<"USD">;
+                    microdollars: import("zod").ZodString;
+                    scale: import("zod").ZodLiteral<6>;
+                }, import("zod/v4/core").$strip>;
+                credit: import("zod").ZodObject<{
+                    currency: import("zod").ZodLiteral<"USD">;
+                    microdollars: import("zod").ZodString;
+                    scale: import("zod").ZodLiteral<6>;
+                }, import("zod/v4/core").$strip>;
+                triggerBelow: import("zod").ZodObject<{
+                    currency: import("zod").ZodLiteral<"USD">;
+                    microdollars: import("zod").ZodString;
+                    scale: import("zod").ZodLiteral<6>;
+                }, import("zod/v4/core").$strip>;
+            }, import("zod/v4/core").$strict>>;
+            effective: import("zod").ZodNullable<import("zod").ZodObject<{
+                ceiling: import("zod").ZodObject<{
+                    currency: import("zod").ZodLiteral<"USD">;
+                    microdollars: import("zod").ZodString;
+                    scale: import("zod").ZodLiteral<6>;
+                }, import("zod/v4/core").$strip>;
+                credit: import("zod").ZodObject<{
+                    currency: import("zod").ZodLiteral<"USD">;
+                    microdollars: import("zod").ZodString;
+                    scale: import("zod").ZodLiteral<6>;
+                }, import("zod/v4/core").$strip>;
+                triggerBelow: import("zod").ZodObject<{
+                    currency: import("zod").ZodLiteral<"USD">;
+                    microdollars: import("zod").ZodString;
+                    scale: import("zod").ZodLiteral<6>;
+                }, import("zod/v4/core").$strip>;
+            }, import("zod/v4/core").$strict>>;
+            setupUrl: import("zod").ZodOptional<import("zod").ZodString>;
+            state: import("zod").ZodEnum<{
+                disabled: "disabled";
+                "payment-method-required": "payment-method-required";
+                ready: "ready";
+            }>;
+            suspension: import("zod").ZodNullable<import("zod").ZodObject<{
+                at: import("zod").ZodString;
+                reason: import("zod").ZodEnum<{
+                    "authentication-required": "authentication-required";
+                    "payment-failed": "payment-failed";
+                }>;
+            }, import("zod/v4/core").$strict>>;
+        }, import("zod/v4/core").$strict>;
+        revision: import("zod").ZodNumber;
+    }, import("zod/v4/core").$strip>;
+    credit: import("zod").ZodObject<{
+        amountOwed: import("zod").ZodObject<{
+            currency: import("zod").ZodLiteral<"USD">;
+            microdollars: import("zod").ZodString;
+            scale: import("zod").ZodLiteral<6>;
+        }, import("zod/v4/core").$strip>;
+        available: import("zod").ZodObject<{
+            currency: import("zod").ZodLiteral<"USD">;
+            microdollars: import("zod").ZodString;
+            scale: import("zod").ZodLiteral<6>;
+        }, import("zod/v4/core").$strip>;
+        reserved: import("zod").ZodObject<{
+            currency: import("zod").ZodLiteral<"USD">;
+            microdollars: import("zod").ZodString;
+            scale: import("zod").ZodLiteral<6>;
+        }, import("zod/v4/core").$strip>;
+    }, import("zod/v4/core").$strip>;
+    freshness: import("zod").ZodObject<{
+        kind: import("zod").ZodLiteral<"authoritative">;
+    }, import("zod/v4/core").$strip>;
+    paymentOperations: import("zod").ZodArray<import("zod").ZodObject<{
+        createdAt: import("zod").ZodString;
+        credit: import("zod").ZodObject<{
+            currency: import("zod").ZodLiteral<"USD">;
+            microdollars: import("zod").ZodString;
+            scale: import("zod").ZodLiteral<6>;
+        }, import("zod/v4/core").$strip>;
+        gross: import("zod").ZodNullable<import("zod").ZodObject<{
+            currency: import("zod").ZodLiteral<"USD">;
+            microdollars: import("zod").ZodString;
+            scale: import("zod").ZodLiteral<6>;
+        }, import("zod/v4/core").$strip>>;
+        id: import("zod").ZodString;
+        kind: import("zod").ZodEnum<{
+            manual: "manual";
+            automatic: "automatic";
+        }>;
+        paymentUrl: import("zod").ZodOptional<import("zod").ZodString>;
+        reason: import("zod").ZodOptional<import("zod").ZodString>;
+        receiptUrl: import("zod").ZodOptional<import("zod").ZodString>;
+        state: import("zod").ZodEnum<{
+            pending: "pending";
+            paid: "paid";
+            failed: "failed";
+            "authentication-required": "authentication-required";
+            "action-required": "action-required";
+            canceled: "canceled";
+            refunded: "refunded";
+            reversed: "reversed";
+            disputed: "disputed";
+        }>;
+        tax: import("zod").ZodNullable<import("zod").ZodObject<{
+            currency: import("zod").ZodLiteral<"USD">;
+            microdollars: import("zod").ZodString;
+            scale: import("zod").ZodLiteral<6>;
+        }, import("zod/v4/core").$strip>>;
+        taxStatus: import("zod").ZodEnum<{
+            confirmed: "confirmed";
+            "calculated-at-checkout": "calculated-at-checkout";
+        }>;
+        updatedAt: import("zod").ZodString;
+    }, import("zod/v4/core").$strict>>;
+    subscribedProjectFees: import("zod").ZodObject<{
+        currency: import("zod").ZodLiteral<"USD">;
+        microdollars: import("zod").ZodString;
+        scale: import("zod").ZodLiteral<6>;
+    }, import("zod/v4/core").$strip>;
+}, import("zod/v4/core").$strict>;
+export declare const BILLING_NOTICE_KINDS: readonly ["budget-warning", "budget-exhausted", "low-credit", "automatic-top-up-cap-reached", "funding-blocked", "payment-pending", "payment-succeeded", "payment-failed", "payment-authentication-required", "payment-outcome-unresolved", "service-restored"];
+type BillingNoticeMoney = z.infer<typeof nonnegativeExactMoneySchema>;
+export interface BillingNotice {
+    readonly amounts: {
+        readonly available?: BillingNoticeMoney | undefined;
+        readonly gross?: BillingNoticeMoney | undefined;
+        readonly limit?: BillingNoticeMoney | undefined;
+        readonly threshold?: BillingNoticeMoney | undefined;
+    };
+    readonly detail: string;
+    readonly email: {
+        readonly attempts: number;
+        readonly failureCode?: string | undefined;
+        readonly lastAttemptAt: string | null;
+        readonly state: "pending" | "delivered" | "failed" | "suppressed";
+    };
+    readonly id: string;
+    readonly kind: (typeof BILLING_NOTICE_KINDS)[number];
+    readonly occurredAt: string;
+    readonly payment: {
+        readonly operation: string;
+        readonly state: (typeof BILLING_PAYMENT_STATES)[number];
+    } | null;
+    readonly recoveryPath: "#billing" | "#billing-funding" | "#billing-notification-settings";
+    readonly resolvedAt: string | null;
+    readonly scope: {
+        readonly kind: "organization";
+    } | {
+        readonly kind: "project";
+        readonly project: z.infer<typeof projectIdSchema>;
+    };
+    readonly severity: "warning" | "critical" | "recovery";
+    readonly state: "active" | "resolved";
+    readonly title: string;
+    readonly updatedAt: string;
+}
+export interface BillingNoticePage {
+    readonly data: readonly BillingNotice[];
+    readonly freshness: {
+        readonly kind: "authoritative";
+    };
+    readonly nextCursor?: string | undefined;
+}
+export interface BillingNotificationSettings {
+    readonly criticalEmail: true;
+    readonly freshness: {
+        readonly kind: "authoritative";
+    };
+    readonly lowCreditThreshold: z.infer<typeof exactCentMoneySchema>;
+    readonly noncriticalEmail: boolean;
+    readonly recipients: {
+        readonly billingContacts: "active-billing-role-members";
+        readonly owners: true;
+    };
+    readonly revision: number;
+}
+export interface BillingNotificationSettingsUpdateRequest {
+    readonly expectedRevision: number;
+    /**
+     * A chosen threshold; `null` to warn at one fifth of the most recent credit
+     * purchase or grant again, which is the default; omitted to leave the
+     * threshold exactly as it is, chosen or not.
+     */
+    readonly lowCreditThreshold?: z.infer<typeof exactCentMoneySchema> | null | undefined;
+    readonly noncriticalEmail: boolean;
+}
+export declare const billingNoticeRecoveryPathSchema: import("zod").ZodEnum<{
+    "#billing": "#billing";
+    "#billing-funding": "#billing-funding";
+    "#billing-notification-settings": "#billing-notification-settings";
+}>;
+export declare const billingNoticeSchema: z.ZodType<BillingNotice>;
+export declare const billingNoticePageSchema: z.ZodType<BillingNoticePage>;
+export declare const billingNotificationSettingsSchema: z.ZodType<BillingNotificationSettings>;
+export declare const billingNotificationSettingsUpdateRequestSchema: z.ZodType<BillingNotificationSettingsUpdateRequest>;
+export declare const billingRefundRequestCreateSchema: import("zod").ZodObject<{
+    amount: import("zod").ZodObject<{
+        currency: import("zod").ZodLiteral<"USD">;
+        microdollars: import("zod").ZodString;
+        scale: import("zod").ZodLiteral<6>;
+    }, import("zod/v4/core").$strip>;
+    confirmed: import("zod").ZodLiteral<true>;
+    paymentOperation: import("zod").ZodString;
+    reason: import("zod").ZodString;
+}, import("zod/v4/core").$strict>;
+export declare const billingRefundResolutionRequestSchema: import("zod").ZodObject<{
+    confirmed: import("zod").ZodLiteral<true>;
+    decision: import("zod").ZodEnum<{
+        completed: "completed";
+        declined: "declined";
+    }>;
+    gross: import("zod").ZodOptional<import("zod").ZodObject<{
+        currency: import("zod").ZodLiteral<"USD">;
+        microdollars: import("zod").ZodString;
+        scale: import("zod").ZodLiteral<6>;
+    }, import("zod/v4/core").$strip>>;
+    providerRefund: import("zod").ZodOptional<import("zod").ZodString>;
+    tax: import("zod").ZodOptional<import("zod").ZodObject<{
+        currency: import("zod").ZodLiteral<"USD">;
+        microdollars: import("zod").ZodString;
+        scale: import("zod").ZodLiteral<6>;
+    }, import("zod/v4/core").$strip>>;
+}, import("zod/v4/core").$strict>;
+export declare const billingRefundRequestViewSchema: import("zod").ZodObject<{
+    amount: import("zod").ZodObject<{
+        currency: import("zod").ZodLiteral<"USD">;
+        microdollars: import("zod").ZodString;
+        scale: import("zod").ZodLiteral<6>;
+    }, import("zod/v4/core").$strip>;
+    id: import("zod").ZodString;
+    paymentOperation: import("zod").ZodString;
+    requestedAt: import("zod").ZodString;
+    state: import("zod").ZodLiteral<"operator-review-pending">;
+}, import("zod/v4/core").$strict>;
+export type BillingFundingQuoteRequest = z.infer<typeof billingFundingQuoteRequestSchema>;
+export type BillingFundingQuote = z.infer<typeof billingFundingQuoteSchema>;
+export type BillingAutoTopUpConfiguration = z.infer<typeof billingAutoTopUpConfigurationSchema>;
+export type BillingAutoTopUpRule = z.infer<typeof billingAutoTopUpRuleSchema>;
+export type BillingAutoTopUpPreviewRequest = z.infer<typeof billingAutoTopUpPreviewRequestSchema>;
+export type BillingAutoTopUpPreview = z.infer<typeof billingAutoTopUpPreviewSchema>;
+export type BillingAutoTopUpApplyRequest = z.infer<typeof billingAutoTopUpApplyRequestSchema>;
+export type BillingPurchaseRequest = z.infer<typeof billingPurchaseRequestSchema>;
+export type BillingCeilingUpdateRequest = z.infer<typeof billingCeilingUpdateRequestSchema>;
+export type BillingPaymentOperation = z.infer<typeof billingPaymentOperationSchema>;
+export type BillingFundingView = z.infer<typeof billingFundingViewSchema>;
+export type BillingRefundRequestCreate = z.infer<typeof billingRefundRequestCreateSchema>;
+export type BillingRefundResolutionRequest = z.infer<typeof billingRefundResolutionRequestSchema>;
+export type BillingRefundRequestView = z.infer<typeof billingRefundRequestViewSchema>;
+export declare const billingBudgetUpdateRequestSchema: import("zod").ZodObject<{
+    advisoryBudget: import("zod").ZodNullable<import("zod").ZodObject<{
+        currency: import("zod").ZodLiteral<"USD">;
+        microdollars: import("zod").ZodString;
+        scale: import("zod").ZodLiteral<6>;
+    }, import("zod/v4/core").$strip>>;
+    expectedRevision: import("zod").ZodNumber;
+    hardCap: import("zod").ZodNullable<import("zod").ZodObject<{
+        currency: import("zod").ZodLiteral<"USD">;
+        microdollars: import("zod").ZodString;
+        scale: import("zod").ZodLiteral<6>;
+    }, import("zod/v4/core").$strip>>;
+}, import("zod/v4/core").$strip>;
+export type BillingBudgetUpdateRequest = z.infer<typeof billingBudgetUpdateRequestSchema>;
+export declare const billingBudgetPolicySchema: import("zod").ZodObject<{
+    desired: import("zod").ZodObject<{
+        advisoryBudget: import("zod").ZodNullable<import("zod").ZodObject<{
+            currency: import("zod").ZodLiteral<"USD">;
+            microdollars: import("zod").ZodString;
+            scale: import("zod").ZodLiteral<6>;
+        }, import("zod/v4/core").$strip>>;
+        hardCap: import("zod").ZodNullable<import("zod").ZodObject<{
+            currency: import("zod").ZodLiteral<"USD">;
+            microdollars: import("zod").ZodString;
+            scale: import("zod").ZodLiteral<6>;
+        }, import("zod/v4/core").$strip>>;
+    }, import("zod/v4/core").$strip>;
+    desiredRevision: import("zod").ZodNumber;
+    effectiveRevision: import("zod").ZodNumber;
+    pending: import("zod").ZodBoolean;
+}, import("zod/v4/core").$strip>;
+export declare const billingPeriodSummarySchema: import("zod").ZodObject<{
+    advisoryBudget: import("zod").ZodOptional<import("zod").ZodObject<{
+        currency: import("zod").ZodLiteral<"USD">;
+        microdollars: import("zod").ZodString;
+        scale: import("zod").ZodLiteral<6>;
+    }, import("zod/v4/core").$strip>>;
+    hardCap: import("zod").ZodOptional<import("zod").ZodObject<{
+        currency: import("zod").ZodLiteral<"USD">;
+        microdollars: import("zod").ZodString;
+        scale: import("zod").ZodLiteral<6>;
+    }, import("zod/v4/core").$strip>>;
+    remainingToHardCap: import("zod").ZodOptional<import("zod").ZodObject<{
+        currency: import("zod").ZodLiteral<"USD">;
+        microdollars: import("zod").ZodString;
+        scale: import("zod").ZodLiteral<6>;
+    }, import("zod/v4/core").$strip>>;
+    advisoryBudgetProgress: import("zod").ZodOptional<import("zod").ZodObject<{
+        committed: import("zod").ZodObject<{
+            currency: import("zod").ZodLiteral<"USD">;
+            microdollars: import("zod").ZodString;
+            scale: import("zod").ZodLiteral<6>;
+        }, import("zod/v4/core").$strip>;
+        remaining: import("zod").ZodObject<{
+            currency: import("zod").ZodLiteral<"USD">;
+            microdollars: import("zod").ZodString;
+            scale: import("zod").ZodLiteral<6>;
+        }, import("zod/v4/core").$strip>;
+    }, import("zod/v4/core").$strip>>;
+    automaticExecutionTopUp: import("zod").ZodObject<{
+        cap: import("zod").ZodOptional<import("zod").ZodObject<{
+            currency: import("zod").ZodLiteral<"USD">;
+            microdollars: import("zod").ZodString;
+            scale: import("zod").ZodLiteral<6>;
+        }, import("zod/v4/core").$strip>>;
+        pending: import("zod").ZodObject<{
+            currency: import("zod").ZodLiteral<"USD">;
+            microdollars: import("zod").ZodString;
+            scale: import("zod").ZodLiteral<6>;
+        }, import("zod/v4/core").$strip>;
+        remainingToCap: import("zod").ZodOptional<import("zod").ZodObject<{
+            currency: import("zod").ZodLiteral<"USD">;
+            microdollars: import("zod").ZodString;
+            scale: import("zod").ZodLiteral<6>;
+        }, import("zod/v4/core").$strip>>;
+        settled: import("zod").ZodObject<{
+            currency: import("zod").ZodLiteral<"USD">;
+            microdollars: import("zod").ZodString;
+            scale: import("zod").ZodLiteral<6>;
+        }, import("zod/v4/core").$strip>;
+    }, import("zod/v4/core").$strip>;
+    subscribedProjectFees: import("zod").ZodObject<{
+        currency: import("zod").ZodLiteral<"USD">;
+        microdollars: import("zod").ZodString;
+        scale: import("zod").ZodLiteral<6>;
+    }, import("zod/v4/core").$strip>;
+    reservedUsage: import("zod").ZodObject<{
+        currency: import("zod").ZodLiteral<"USD">;
+        microdollars: import("zod").ZodString;
+        scale: import("zod").ZodLiteral<6>;
+    }, import("zod/v4/core").$strip>;
+    settledUsage: import("zod").ZodObject<{
+        currency: import("zod").ZodLiteral<"USD">;
+        microdollars: import("zod").ZodString;
+        scale: import("zod").ZodLiteral<6>;
+    }, import("zod/v4/core").$strip>;
+    start: import("zod").ZodString;
+    end: import("zod").ZodString;
+}, import("zod/v4/core").$strip>;
+export declare const billingSummarySchema: import("zod").ZodObject<{
+    activation: import("zod").ZodObject<{
+        boundary: import("zod").ZodString;
+        mode: import("zod").ZodEnum<{
+            disabled: "disabled";
+            shadow: "shadow";
+            enforced: "enforced";
+        }>;
+    }, import("zod/v4/core").$strip>;
+    blockingReasons: import("zod").ZodArray<import("zod").ZodEnum<{
+        "billing-state-missing": "billing-state-missing";
+        "billing-account-closed": "billing-account-closed";
+        "project-ineligible": "project-ineligible";
+        "insufficient-credit": "insufficient-credit";
+        "execution-cap-reached": "execution-cap-reached";
+    }>>;
+    budgetPolicy: import("zod").ZodObject<{
+        desired: import("zod").ZodObject<{
+            advisoryBudget: import("zod").ZodNullable<import("zod").ZodObject<{
+                currency: import("zod").ZodLiteral<"USD">;
+                microdollars: import("zod").ZodString;
+                scale: import("zod").ZodLiteral<6>;
+            }, import("zod/v4/core").$strip>>;
+            hardCap: import("zod").ZodNullable<import("zod").ZodObject<{
+                currency: import("zod").ZodLiteral<"USD">;
+                microdollars: import("zod").ZodString;
+                scale: import("zod").ZodLiteral<6>;
+            }, import("zod/v4/core").$strip>>;
+        }, import("zod/v4/core").$strip>;
+        desiredRevision: import("zod").ZodNumber;
+        effectiveRevision: import("zod").ZodNumber;
+        pending: import("zod").ZodBoolean;
+    }, import("zod/v4/core").$strip>;
+    closedAt: import("zod").ZodOptional<import("zod").ZodString>;
+    credit: import("zod").ZodObject<{
+        available: import("zod").ZodObject<{
+            currency: import("zod").ZodLiteral<"USD">;
+            microdollars: import("zod").ZodString;
+            scale: import("zod").ZodLiteral<6>;
+        }, import("zod/v4/core").$strip>;
+        consumed: import("zod").ZodObject<{
+            currency: import("zod").ZodLiteral<"USD">;
+            microdollars: import("zod").ZodString;
+            scale: import("zod").ZodLiteral<6>;
+        }, import("zod/v4/core").$strip>;
+        reserved: import("zod").ZodObject<{
+            currency: import("zod").ZodLiteral<"USD">;
+            microdollars: import("zod").ZodString;
+            scale: import("zod").ZodLiteral<6>;
+        }, import("zod/v4/core").$strip>;
+    }, import("zod/v4/core").$strip>;
+    desiredRevision: import("zod").ZodNumber;
+    effectiveRevision: import("zod").ZodNumber;
+    freshness: import("zod").ZodObject<{
+        kind: import("zod").ZodLiteral<"authoritative">;
+    }, import("zod/v4/core").$strip>;
+    includedProject: import("zod").ZodOptional<import("zod").ZodString>;
+    period: import("zod").ZodOptional<import("zod").ZodObject<{
+        advisoryBudget: import("zod").ZodOptional<import("zod").ZodObject<{
+            currency: import("zod").ZodLiteral<"USD">;
+            microdollars: import("zod").ZodString;
+            scale: import("zod").ZodLiteral<6>;
+        }, import("zod/v4/core").$strip>>;
+        hardCap: import("zod").ZodOptional<import("zod").ZodObject<{
+            currency: import("zod").ZodLiteral<"USD">;
+            microdollars: import("zod").ZodString;
+            scale: import("zod").ZodLiteral<6>;
+        }, import("zod/v4/core").$strip>>;
+        remainingToHardCap: import("zod").ZodOptional<import("zod").ZodObject<{
+            currency: import("zod").ZodLiteral<"USD">;
+            microdollars: import("zod").ZodString;
+            scale: import("zod").ZodLiteral<6>;
+        }, import("zod/v4/core").$strip>>;
+        advisoryBudgetProgress: import("zod").ZodOptional<import("zod").ZodObject<{
+            committed: import("zod").ZodObject<{
+                currency: import("zod").ZodLiteral<"USD">;
+                microdollars: import("zod").ZodString;
+                scale: import("zod").ZodLiteral<6>;
+            }, import("zod/v4/core").$strip>;
+            remaining: import("zod").ZodObject<{
+                currency: import("zod").ZodLiteral<"USD">;
+                microdollars: import("zod").ZodString;
+                scale: import("zod").ZodLiteral<6>;
+            }, import("zod/v4/core").$strip>;
+        }, import("zod/v4/core").$strip>>;
+        automaticExecutionTopUp: import("zod").ZodObject<{
+            cap: import("zod").ZodOptional<import("zod").ZodObject<{
+                currency: import("zod").ZodLiteral<"USD">;
+                microdollars: import("zod").ZodString;
+                scale: import("zod").ZodLiteral<6>;
+            }, import("zod/v4/core").$strip>>;
+            pending: import("zod").ZodObject<{
+                currency: import("zod").ZodLiteral<"USD">;
+                microdollars: import("zod").ZodString;
+                scale: import("zod").ZodLiteral<6>;
+            }, import("zod/v4/core").$strip>;
+            remainingToCap: import("zod").ZodOptional<import("zod").ZodObject<{
+                currency: import("zod").ZodLiteral<"USD">;
+                microdollars: import("zod").ZodString;
+                scale: import("zod").ZodLiteral<6>;
+            }, import("zod/v4/core").$strip>>;
+            settled: import("zod").ZodObject<{
+                currency: import("zod").ZodLiteral<"USD">;
+                microdollars: import("zod").ZodString;
+                scale: import("zod").ZodLiteral<6>;
+            }, import("zod/v4/core").$strip>;
+        }, import("zod/v4/core").$strip>;
+        subscribedProjectFees: import("zod").ZodObject<{
+            currency: import("zod").ZodLiteral<"USD">;
+            microdollars: import("zod").ZodString;
+            scale: import("zod").ZodLiteral<6>;
+        }, import("zod/v4/core").$strip>;
+        reservedUsage: import("zod").ZodObject<{
+            currency: import("zod").ZodLiteral<"USD">;
+            microdollars: import("zod").ZodString;
+            scale: import("zod").ZodLiteral<6>;
+        }, import("zod/v4/core").$strip>;
+        settledUsage: import("zod").ZodObject<{
+            currency: import("zod").ZodLiteral<"USD">;
+            microdollars: import("zod").ZodString;
+            scale: import("zod").ZodLiteral<6>;
+        }, import("zod/v4/core").$strip>;
+        start: import("zod").ZodString;
+        end: import("zod").ZodString;
+    }, import("zod/v4/core").$strip>>;
+    pending: import("zod").ZodBoolean;
+    priceVersion: import("zod").ZodString;
+    trialExpiresAt: import("zod").ZodOptional<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>;
+export type BillingSummaryView = z.infer<typeof billingSummarySchema>;
+export declare const billingBudgetUpdateResponseSchema: import("zod").ZodObject<{
+    budgetPolicy: import("zod").ZodObject<{
+        desired: import("zod").ZodObject<{
+            advisoryBudget: import("zod").ZodNullable<import("zod").ZodObject<{
+                currency: import("zod").ZodLiteral<"USD">;
+                microdollars: import("zod").ZodString;
+                scale: import("zod").ZodLiteral<6>;
+            }, import("zod/v4/core").$strip>>;
+            hardCap: import("zod").ZodNullable<import("zod").ZodObject<{
+                currency: import("zod").ZodLiteral<"USD">;
+                microdollars: import("zod").ZodString;
+                scale: import("zod").ZodLiteral<6>;
+            }, import("zod/v4/core").$strip>>;
+        }, import("zod/v4/core").$strip>;
+        desiredRevision: import("zod").ZodNumber;
+        effectiveRevision: import("zod").ZodNumber;
+        pending: import("zod").ZodBoolean;
+    }, import("zod/v4/core").$strip>;
+    freshness: import("zod").ZodObject<{
+        kind: import("zod").ZodLiteral<"authoritative">;
+    }, import("zod/v4/core").$strip>;
+}, import("zod/v4/core").$strip>;
+export type BillingBudgetUpdateResponse = z.infer<typeof billingBudgetUpdateResponseSchema>;
+export declare const billingBudgetUpdateRequestHeadersSchema: import("zod").ZodObject<{
+    "Idempotency-Key": import("zod").ZodString;
+}, import("zod/v4/core").$strip>;
+export declare const billingLedgerEntrySchema: import("zod").ZodObject<{
+    amount: import("zod").ZodObject<{
+        currency: import("zod").ZodLiteral<"USD">;
+        microdollars: import("zod").ZodString;
+        scale: import("zod").ZodLiteral<6>;
+    }, import("zod/v4/core").$strip>;
+    kind: import("zod").ZodEnum<{
+        credit_granted: "credit_granted";
+        credit_reversed: "credit_reversed";
+        attempt_debited: "attempt_debited";
+        attempt_released: "attempt_released";
+        shadow_attempt_debited: "shadow_attempt_debited";
+        shadow_attempt_released: "shadow_attempt_released";
+        late_evidence_waived: "late_evidence_waived";
+        policy_installed: "policy_installed";
+        budget_policy_updated: "budget_policy_updated";
+        budget_threshold_reached: "budget_threshold_reached";
+        budget_exhausted: "budget_exhausted";
+        budget_recovered: "budget_recovered";
+        automatic_charge_ceiling_updated: "automatic_charge_ceiling_updated";
+        payment_reserved: "payment_reserved";
+        payment_submitted: "payment_submitted";
+        payment_pending: "payment_pending";
+        payment_paid: "payment_paid";
+        payment_failed: "payment_failed";
+        payment_canceled: "payment_canceled";
+        payment_authentication_required: "payment_authentication_required";
+        payment_action_required: "payment_action_required";
+        payment_refunded: "payment_refunded";
+        payment_disputed: "payment_disputed";
+        payment_reversed: "payment_reversed";
+        payment_dispute_restored: "payment_dispute_restored";
+        refund_requested: "refund_requested";
+        payment_refund_canceled: "payment_refund_canceled";
+        automatic_top_up_cap_reached: "automatic_top_up_cap_reached";
+        automatic_charge_threshold_reached: "automatic_charge_threshold_reached";
+        automatic_charge_threshold_recovered: "automatic_charge_threshold_recovered";
+        low_credit_reached: "low_credit_reached";
+        low_credit_recovered: "low_credit_recovered";
+        notification_settings_updated: "notification_settings_updated";
+        service_blocked: "service_blocked";
+        service_restored: "service_restored";
+    }>;
+    note: import("zod").ZodOptional<import("zod").ZodEnum<{
+        "provider-details-attached": "provider-details-attached";
+    }>>;
+    period: import("zod").ZodOptional<import("zod").ZodString>;
+    recordedAt: import("zod").ZodString;
+    reference: import("zod").ZodObject<{
+        attempt: import("zod").ZodOptional<import("zod").ZodString>;
+        creditLot: import("zod").ZodOptional<import("zod").ZodString>;
+        event: import("zod").ZodString;
+        paymentOperation: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>;
+    sequence: import("zod").ZodString;
+}, import("zod/v4/core").$strip>;
+export type BillingLedgerEntryView = z.infer<typeof billingLedgerEntrySchema>;
+export declare const billingLedgerRequestSchema: import("zod").ZodObject<{
+    cursor: import("zod").ZodOptional<import("zod").ZodString>;
+    limit: import("zod").ZodDefault<import("zod").ZodNumber>;
+}, import("zod/v4/core").$strip>;
+export type BillingLedgerRequest = z.infer<typeof billingLedgerRequestSchema>;
+export declare const billingLedgerPageSchema: import("zod").ZodObject<{
+    data: import("zod").ZodArray<import("zod").ZodObject<{
+        amount: import("zod").ZodObject<{
+            currency: import("zod").ZodLiteral<"USD">;
+            microdollars: import("zod").ZodString;
+            scale: import("zod").ZodLiteral<6>;
+        }, import("zod/v4/core").$strip>;
+        kind: import("zod").ZodEnum<{
+            credit_granted: "credit_granted";
+            credit_reversed: "credit_reversed";
+            attempt_debited: "attempt_debited";
+            attempt_released: "attempt_released";
+            shadow_attempt_debited: "shadow_attempt_debited";
+            shadow_attempt_released: "shadow_attempt_released";
+            late_evidence_waived: "late_evidence_waived";
+            policy_installed: "policy_installed";
+            budget_policy_updated: "budget_policy_updated";
+            budget_threshold_reached: "budget_threshold_reached";
+            budget_exhausted: "budget_exhausted";
+            budget_recovered: "budget_recovered";
+            automatic_charge_ceiling_updated: "automatic_charge_ceiling_updated";
+            payment_reserved: "payment_reserved";
+            payment_submitted: "payment_submitted";
+            payment_pending: "payment_pending";
+            payment_paid: "payment_paid";
+            payment_failed: "payment_failed";
+            payment_canceled: "payment_canceled";
+            payment_authentication_required: "payment_authentication_required";
+            payment_action_required: "payment_action_required";
+            payment_refunded: "payment_refunded";
+            payment_disputed: "payment_disputed";
+            payment_reversed: "payment_reversed";
+            payment_dispute_restored: "payment_dispute_restored";
+            refund_requested: "refund_requested";
+            payment_refund_canceled: "payment_refund_canceled";
+            automatic_top_up_cap_reached: "automatic_top_up_cap_reached";
+            automatic_charge_threshold_reached: "automatic_charge_threshold_reached";
+            automatic_charge_threshold_recovered: "automatic_charge_threshold_recovered";
+            low_credit_reached: "low_credit_reached";
+            low_credit_recovered: "low_credit_recovered";
+            notification_settings_updated: "notification_settings_updated";
+            service_blocked: "service_blocked";
+            service_restored: "service_restored";
+        }>;
+        note: import("zod").ZodOptional<import("zod").ZodEnum<{
+            "provider-details-attached": "provider-details-attached";
+        }>>;
+        period: import("zod").ZodOptional<import("zod").ZodString>;
+        recordedAt: import("zod").ZodString;
+        reference: import("zod").ZodObject<{
+            attempt: import("zod").ZodOptional<import("zod").ZodString>;
+            creditLot: import("zod").ZodOptional<import("zod").ZodString>;
+            event: import("zod").ZodString;
+            paymentOperation: import("zod").ZodOptional<import("zod").ZodString>;
+        }, import("zod/v4/core").$strip>;
+        sequence: import("zod").ZodString;
+    }, import("zod/v4/core").$strip>>;
+    nextCursor: import("zod").ZodOptional<import("zod").ZodString>;
+    freshness: import("zod").ZodObject<{
+        kind: import("zod").ZodLiteral<"authoritative">;
+    }, import("zod/v4/core").$strip>;
+}, import("zod/v4/core").$strip>;
+export type BillingLedgerPage = z.infer<typeof billingLedgerPageSchema>;
+export declare const PROJECT_BILLING_ACTIONS: readonly ["add", "cancel", "transfer-included"];
+export declare const projectBillingQuoteRequestSchema: import("zod").ZodObject<{
+    action: import("zod").ZodEnum<{
+        add: "add";
+        cancel: "cancel";
+        "transfer-included": "transfer-included";
+    }>;
+    project: import("zod").ZodString;
+    fromProject: import("zod").ZodOptional<import("zod").ZodString>;
+}, import("zod/v4/core").$strict>;
+export declare const projectBillingQuoteSchema: import("zod").ZodObject<{
+    action: import("zod").ZodEnum<{
+        add: "add";
+        cancel: "cancel";
+        "transfer-included": "transfer-included";
+    }>;
+    project: import("zod").ZodString;
+    fromProject: import("zod").ZodOptional<import("zod").ZodString>;
+    quote: import("zod").ZodString;
+    expectedRevision: import("zod").ZodNumber;
+    expiresAt: import("zod").ZodString;
+    charge: import("zod").ZodObject<{
+        currency: import("zod").ZodLiteral<"USD">;
+        microdollars: import("zod").ZodString;
+        scale: import("zod").ZodLiteral<6>;
+    }, import("zod/v4/core").$strip>;
+    monthlyProjectFees: import("zod").ZodObject<{
+        currency: import("zod").ZodLiteral<"USD">;
+        microdollars: import("zod").ZodString;
+        scale: import("zod").ZodLiteral<6>;
+    }, import("zod/v4/core").$strip>;
+    effectiveAt: import("zod").ZodString;
+    formerIncludedWillBlock: import("zod").ZodBoolean;
+}, import("zod/v4/core").$strict>;
+export declare const projectBillingChangeRequestSchema: import("zod").ZodObject<{
+    quote: import("zod").ZodString;
+    expectedRevision: import("zod").ZodNumber;
+    confirmed: import("zod").ZodLiteral<true>;
+}, import("zod/v4/core").$strict>;
+export declare const projectBillingStateSchema: import("zod").ZodObject<{
+    includedProject: import("zod").ZodOptional<import("zod").ZodString>;
+    desiredRevision: import("zod").ZodNumber;
+    effectiveRevision: import("zod").ZodNumber;
+    pending: import("zod").ZodBoolean;
+    recurringProjectFees: import("zod").ZodObject<{
+        currency: import("zod").ZodLiteral<"USD">;
+        microdollars: import("zod").ZodString;
+        scale: import("zod").ZodLiteral<6>;
+    }, import("zod/v4/core").$strip>;
+    projects: import("zod").ZodArray<import("zod").ZodObject<{
+        name: import("zod").ZodString;
+        project: import("zod").ZodString;
+        access: import("zod").ZodEnum<{
+            paid: "paid";
+            included: "included";
+            blocked: "blocked";
+        }>;
+        paidThroughAt: import("zod").ZodOptional<import("zod").ZodString>;
+        renewalGraceUntil: import("zod").ZodOptional<import("zod").ZodString>;
+        cancellationAt: import("zod").ZodOptional<import("zod").ZodString>;
+        deleted: import("zod").ZodBoolean;
+    }, import("zod/v4/core").$strip>>;
+    pendingOperations: import("zod").ZodArray<import("zod").ZodObject<{
+        id: import("zod").ZodString;
+        kind: import("zod").ZodEnum<{
+            add: "add";
+            cancel: "cancel";
+        }>;
+        project: import("zod").ZodString;
+        state: import("zod").ZodEnum<{
+            pending: "pending";
+            "action-required": "action-required";
+        }>;
+        paymentUrl: import("zod").ZodOptional<import("zod").ZodString>;
+        reason: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>>;
+}, import("zod/v4/core").$strip>;
+export declare const billingPortalSchema: import("zod").ZodObject<{
+    url: import("zod").ZodString;
+}, import("zod/v4/core").$strip>;
+/**
+ * The organization's saved payment method (W9-09, widened by W9-14): the one
+ * method automatic top-ups and project subscriptions charge. It is the Stripe
+ * customer's default payment method, read by authenticated provider call and
+ * never stored by GreatWait beyond the provider's own identifier.
+ *
+ * `method` says what it is. A card keeps its brand and last four digits; Link
+ * carries the email it is registered to when the provider reports one; any
+ * other type the provider's checkout offered (Cash App Pay, Amazon Pay,
+ * Klarna) carries the provider's type name. Every variant carries `label`,
+ * the sentence-ready name the dashboard, command line and MCP all show, so no
+ * client needs its own table of provider types. `method` is null when nothing
+ * is saved.
+ *
+ * `card` is the pre-W9-14 field, kept so a client written against it keeps
+ * working: it is set exactly when `method.type` is `card`, and null otherwise
+ * — including when a non-card method is saved, which such a client reads as
+ * "no card".
+ */
+export declare const billingPaymentMethodSchema: import("zod").ZodObject<{
+    card: import("zod").ZodNullable<import("zod").ZodObject<{
+        brand: import("zod").ZodString;
+        last4: import("zod").ZodString;
+        expMonth: import("zod").ZodNumber;
+        expYear: import("zod").ZodNumber;
+    }, import("zod/v4/core").$strict>>;
+    method: import("zod").ZodNullable<import("zod").ZodDiscriminatedUnion<[import("zod").ZodObject<{
+        brand: import("zod").ZodString;
+        last4: import("zod").ZodString;
+        expMonth: import("zod").ZodNumber;
+        expYear: import("zod").ZodNumber;
+        type: import("zod").ZodLiteral<"card">;
+        label: import("zod").ZodString;
+    }, import("zod/v4/core").$strict>, import("zod").ZodObject<{
+        type: import("zod").ZodLiteral<"link">;
+        label: import("zod").ZodString;
+        email: import("zod").ZodNullable<import("zod").ZodString>;
+    }, import("zod/v4/core").$strict>, import("zod").ZodObject<{
+        type: import("zod").ZodLiteral<"other">;
+        label: import("zod").ZodString;
+        providerType: import("zod").ZodString;
+    }, import("zod/v4/core").$strict>], "type">>;
+}, import("zod/v4/core").$strict>;
+/**
+ * Where hosted card setup returns. Optional: the configured dashboard billing
+ * page is the default, and a supplied address must share its origin, so the
+ * operation cannot be used to send a customer to a page GreatWait does not own.
+ */
+export declare const billingPaymentMethodSetupRequestSchema: import("zod").ZodObject<{
+    returnUrl: import("zod").ZodOptional<import("zod").ZodString>;
+}, import("zod/v4/core").$strict>;
+/** The hosted card-setup Checkout session a browser returned from. */
+export declare const billingPaymentMethodConfirmRequestSchema: import("zod").ZodObject<{
+    checkoutSession: import("zod").ZodString;
+}, import("zod/v4/core").$strict>;
+/**
+ * Removing the card on file (W9-09). The literal `true` is the caller's
+ * acknowledgement of what removal does: project subscriptions stop renewing,
+ * paid projects run to the end of the period already paid for and then stop,
+ * and automatic top-up turns off.
+ */
+export declare const billingPaymentMethodRemoveRequestSchema: import("zod").ZodObject<{
+    confirmed: import("zod").ZodLiteral<true>;
+}, import("zod/v4/core").$strict>;
+/**
+ * One project subscription charge (W9-09): a provider invoice for the
+ * organization's project subscription, listed beside execution-credit
+ * payments so a customer who was charged for a project sees the charge and its
+ * receipt. `amount` is the invoice total, tax included. `receiptUrl` is the
+ * provider-hosted invoice page when there is one.
+ */
+export declare const billingInvoiceSchema: import("zod").ZodObject<{
+    id: import("zod").ZodString;
+    createdAt: import("zod").ZodString;
+    amount: import("zod").ZodObject<{
+        currency: import("zod").ZodLiteral<"USD">;
+        microdollars: import("zod").ZodString;
+        scale: import("zod").ZodLiteral<6>;
+    }, import("zod/v4/core").$strip>;
+    state: import("zod").ZodEnum<{
+        void: "void";
+        paid: "paid";
+        open: "open";
+        uncollectible: "uncollectible";
+    }>;
+    receiptUrl: import("zod").ZodOptional<import("zod").ZodString>;
+}, import("zod/v4/core").$strict>;
+/** Execution-credit payment history, with a bounded continuation. */
+export declare const billingPaymentHistoryPageSchema: import("zod").ZodObject<{
+    data: import("zod").ZodArray<import("zod").ZodObject<{
+        createdAt: import("zod").ZodString;
+        credit: import("zod").ZodObject<{
+            currency: import("zod").ZodLiteral<"USD">;
+            microdollars: import("zod").ZodString;
+            scale: import("zod").ZodLiteral<6>;
+        }, import("zod/v4/core").$strip>;
+        gross: import("zod").ZodNullable<import("zod").ZodObject<{
+            currency: import("zod").ZodLiteral<"USD">;
+            microdollars: import("zod").ZodString;
+            scale: import("zod").ZodLiteral<6>;
+        }, import("zod/v4/core").$strip>>;
+        id: import("zod").ZodString;
+        kind: import("zod").ZodEnum<{
+            manual: "manual";
+            automatic: "automatic";
+        }>;
+        paymentUrl: import("zod").ZodOptional<import("zod").ZodString>;
+        reason: import("zod").ZodOptional<import("zod").ZodString>;
+        receiptUrl: import("zod").ZodOptional<import("zod").ZodString>;
+        state: import("zod").ZodEnum<{
+            pending: "pending";
+            paid: "paid";
+            failed: "failed";
+            "authentication-required": "authentication-required";
+            "action-required": "action-required";
+            canceled: "canceled";
+            refunded: "refunded";
+            reversed: "reversed";
+            disputed: "disputed";
+        }>;
+        tax: import("zod").ZodNullable<import("zod").ZodObject<{
+            currency: import("zod").ZodLiteral<"USD">;
+            microdollars: import("zod").ZodString;
+            scale: import("zod").ZodLiteral<6>;
+        }, import("zod/v4/core").$strip>>;
+        taxStatus: import("zod").ZodEnum<{
+            confirmed: "confirmed";
+            "calculated-at-checkout": "calculated-at-checkout";
+        }>;
+        updatedAt: import("zod").ZodString;
+    }, import("zod/v4/core").$strict>>;
+    freshness: import("zod").ZodDiscriminatedUnion<[import("zod").ZodObject<{
+        kind: import("zod").ZodLiteral<"authoritative">;
+    }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+        asOf: import("zod").ZodString;
+        kind: import("zod").ZodLiteral<"projected">;
+        lagSeconds: import("zod").ZodNumber;
+    }, import("zod/v4/core").$strip>], "kind">;
+    nextCursor: import("zod").ZodOptional<import("zod").ZodString>;
+}, import("zod/v4/core").$strict>;
+export type BillingPaymentHistoryPage = z.infer<typeof billingPaymentHistoryPageSchema>;
+/** Project subscription history; an empty filtered page may still have a cursor. */
+export declare const billingInvoiceHistoryPageSchema: import("zod").ZodObject<{
+    data: import("zod").ZodArray<import("zod").ZodObject<{
+        id: import("zod").ZodString;
+        createdAt: import("zod").ZodString;
+        amount: import("zod").ZodObject<{
+            currency: import("zod").ZodLiteral<"USD">;
+            microdollars: import("zod").ZodString;
+            scale: import("zod").ZodLiteral<6>;
+        }, import("zod/v4/core").$strip>;
+        state: import("zod").ZodEnum<{
+            void: "void";
+            paid: "paid";
+            open: "open";
+            uncollectible: "uncollectible";
+        }>;
+        receiptUrl: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strict>>;
+    freshness: import("zod").ZodDiscriminatedUnion<[import("zod").ZodObject<{
+        kind: import("zod").ZodLiteral<"authoritative">;
+    }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+        asOf: import("zod").ZodString;
+        kind: import("zod").ZodLiteral<"projected">;
+        lagSeconds: import("zod").ZodNumber;
+    }, import("zod/v4/core").$strip>], "kind">;
+    nextCursor: import("zod").ZodOptional<import("zod").ZodString>;
+}, import("zod/v4/core").$strict>;
+export type BillingInvoiceHistoryPage = z.infer<typeof billingInvoiceHistoryPageSchema>;
+/** Project subscription charges, most recent first, at most 24. */
+export declare const billingInvoiceListSchema: import("zod").ZodObject<{
+    data: import("zod").ZodArray<import("zod").ZodObject<{
+        id: import("zod").ZodString;
+        createdAt: import("zod").ZodString;
+        amount: import("zod").ZodObject<{
+            currency: import("zod").ZodLiteral<"USD">;
+            microdollars: import("zod").ZodString;
+            scale: import("zod").ZodLiteral<6>;
+        }, import("zod/v4/core").$strip>;
+        state: import("zod").ZodEnum<{
+            void: "void";
+            paid: "paid";
+            open: "open";
+            uncollectible: "uncollectible";
+        }>;
+        receiptUrl: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strict>>;
+}, import("zod/v4/core").$strict>;
+/**
+ * The stable title of the refusal a card-dependent change receives when the
+ * organization has no card on file (W9-09): enabling or resuming automatic
+ * top-up, and quoting or confirming a paid project addition.
+ *
+ * **Why a title and not a new problem code.** The published CLI and SDK parse
+ * error bodies with this package's `problemSchema`, whose `code` is a closed
+ * enum, so a code an installed client does not know turns a precise refusal into
+ * "failed with status 409" with no problem at all. The refusal is therefore
+ * `state_conflict` — which is what it is: the request is well formed and would
+ * succeed once a card is saved — and this exact title is the discriminator.
+ * Detect it as `code === "state_conflict" && title ===
+ * BILLING_PAYMENT_METHOD_REQUIRED_TITLE`.
+ */
+export declare const BILLING_PAYMENT_METHOD_REQUIRED_TITLE: "A card on file is required";
+export type ProjectBillingQuoteRequest = z.infer<typeof projectBillingQuoteRequestSchema>;
+export type ProjectBillingQuote = z.infer<typeof projectBillingQuoteSchema>;
+export type ProjectBillingChangeRequest = z.infer<typeof projectBillingChangeRequestSchema>;
+export type ProjectBillingState = z.infer<typeof projectBillingStateSchema>;
+export type BillingPaymentMethod = z.infer<typeof billingPaymentMethodSchema>;
+export type BillingInvoice = z.infer<typeof billingInvoiceSchema>;
+export type BillingInvoiceList = z.infer<typeof billingInvoiceListSchema>;
+export type BillingPaymentMethodSetupRequest = z.infer<typeof billingPaymentMethodSetupRequestSchema>;
+export type BillingPaymentMethodConfirmRequest = z.infer<typeof billingPaymentMethodConfirmRequestSchema>;
+export type BillingPaymentMethodRemoveRequest = z.infer<typeof billingPaymentMethodRemoveRequestSchema>;
+export {};