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

package/dist/operations.d.ts

@@ -275,7 +275,149 @@ type BillingFundingContract = {
 type NamedOperation<TId extends string> = OperationDefinition & {
     readonly id: TId;
 };
-export declare const OPERATIONS: readonly [OperationDefinition & {
+export declare const OPERATIONS: readonly [{
+    readonly creates: false;
+    readonly description: "" | "Read the verified organization's execution-credit payments with bounded cursor continuation. Existing recent-history responses remain compatible.";
+    readonly example: {
+        data?: never;
+        freshness?: never;
+    } | {
+        data: never[];
+        freshness: {
+            kind: string;
+        };
+    };
+    readonly id: "billing.paymenthistory";
+    readonly idempotent: true;
+    readonly mcp: {
+        readonly destructive: false;
+        readonly kind: "tool";
+        readonly openWorld: false;
+    };
+    readonly method: "GET";
+    readonly mutates: false;
+    readonly path: "/v1/billing/payment-history";
+    readonly principals: readonly ["api-credential", "oauth", "session"];
+    readonly problems: readonly ["invalid_request", "service_unavailable"];
+    readonly query: import("zod").ZodObject<{
+        cursor: import("zod").ZodOptional<import("zod").ZodString>;
+        limit: import("zod").ZodDefault<import("zod").ZodNumber>;
+    }, import("zod/v4/core").$strip>;
+    readonly response: 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> | import("zod").ZodNever;
+    readonly scopes: readonly ["usage:read"];
+    readonly sessionAuthority: "headers";
+    readonly summary: "" | "Page execution-credit payments";
+    readonly surfaces: readonly ["api", "mock"];
+}, {
+    readonly creates: false;
+    readonly description: "" | "Read the verified organization's project subscription invoices with bounded cursor continuation. Existing recent-history responses remain compatible.";
+    readonly example: {
+        data?: never;
+        freshness?: never;
+    } | {
+        data: never[];
+        freshness: {
+            kind: string;
+        };
+    };
+    readonly id: "billing.invoicehistory";
+    readonly idempotent: true;
+    readonly mcp: {
+        readonly destructive: false;
+        readonly kind: "tool";
+        readonly openWorld: false;
+    };
+    readonly method: "GET";
+    readonly mutates: false;
+    readonly path: "/v1/billing/invoice-history";
+    readonly principals: readonly ["api-credential", "oauth", "session"];
+    readonly problems: readonly ["invalid_request", "service_unavailable"];
+    readonly query: import("zod").ZodObject<{
+        cursor: import("zod").ZodOptional<import("zod").ZodString>;
+        limit: import("zod").ZodDefault<import("zod").ZodNumber>;
+    }, import("zod/v4/core").$strip>;
+    readonly response: 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> | import("zod").ZodNever;
+    readonly scopes: readonly ["usage:read"];
+    readonly sessionAuthority: "headers";
+    readonly summary: "" | "Page project subscription invoices";
+    readonly surfaces: readonly ["api", "mock"];
+}, OperationDefinition & {
     readonly id: "exports.create";
 }, OperationDefinition & {
     readonly id: "exports.read";
@@ -443,7 +585,7 @@ export declare const OPERATIONS: readonly [OperationDefinition & {
     readonly surfaces: readonly ["mock"];
 }, {
     readonly creates: true;
-    readonly description: "" | "Creates a reusable callback endpoint in the caller's project and environment. The destination must be HTTPS on effective port 443, contain no URL credentials or fragment, and resolve only to public unicast addresses. The endpoint is active and usable the moment it exists; there is nothing to verify. A disabled endpoint is never delivered to, and a schedule write naming one answers not_found, because disabling is terminal rather than a state to recover from. The per-endpoint secret is returned in this response and nowhere else. The 50-record safety ceiling includes disabled endpoints because they remain readable for audit.";
+    readonly description: "" | "Creates a reusable callback endpoint in the caller's project and environment. The destination must be HTTPS on effective port 443, contain no URL credentials or fragment, and resolve only to public unicast addresses. The endpoint is active and usable the moment it exists; there is nothing to verify. A disabled endpoint is never delivered to, and a schedule write naming one answers not_found, because disabling is terminal rather than a state to recover from. The per-endpoint secret is returned to this call and to no other call an API credential or an OAuth token can make; a signed-in member can read it again through endpoints.revealSigningSecret. There is no endpoint-count ceiling. Disabled endpoints remain readable for audit; request and DNS inspection admission bound creation work and reads are paged.";
     readonly example: {
         createdAt?: never;
         environmentKind?: never;
@@ -771,7 +913,7 @@ export declare const OPERATIONS: readonly [OperationDefinition & {
         ETag: import("zod").ZodString;
     }, import("zod/v4/core").$strip>;
     readonly creates: true;
-    readonly description: "" | "Creates the next endpoint signing key and selects it immediately for new deliveries while retaining the current key in the receiver acceptance set for a bounded overlap. The overlap defaults to and cannot exceed 24 hours. A second rotation is refused until the current overlap ends. The new secret is returned once and has no recovery operation, so a call whose answer was never read may have rotated a key nobody holds: read the endpoint and compare its signing keys before repeating one. Send If-Match with the version the endpoint was read at to be refused rather than rotate an endpoint that has changed since.";
+    readonly description: "" | "Creates the next endpoint signing key and selects it immediately for new deliveries while retaining the current key in the receiver acceptance set for a bounded overlap. The overlap defaults to and cannot exceed 24 hours. A second rotation is refused until the current overlap ends. The new secret is returned once to this call, so a call whose answer was never read has rotated a key the caller does not hold. It is recoverable: a signed-in member can read both keys, and the instant the overlap ends, through endpoints.revealSigningSecret. An API credential or an OAuth token cannot, so an integration that loses the answer needs a member to read it back rather than a second rotation, which is refused until the overlap ends. Send If-Match with the version the endpoint was read at to be refused rather than rotate an endpoint that has changed since.";
     readonly example: {
         endpoint?: never;
         keyId?: never;
@@ -3347,7 +3489,7 @@ export declare const OPERATIONS: readonly [OperationDefinition & {
     readonly surfaces: readonly ["api", "mock"];
 }, {
     readonly creates: false;
-    readonly description: "" | "Counts the occurrences this project and environment expect to fire, in epoch-aligned time buckets, with a latency-class split on every bucket and an optional customer partition-key breakdown. A recurring series contributes every instant it fires inside the window rather than only its next one, and `nextFireCount` reports how many of a bucket's occurrences are a schedule's next firing. The answer states its own freshness and is refused rather than shortened when a partition cannot complete it. It carries counts only: no schedule identifier, callback destination, payload or endpoint detail has a field in the response.";
+    readonly description: "" | "Counts the occurrences this project and environment expect to fire, in epoch-aligned time buckets, with a latency-class split on every bucket and an optional customer partition-key breakdown. A recurring series contributes every instant it fires inside the window rather than only its next one, and `nextFireCount` reports how many of a bucket's occurrences are a schedule's next firing. The answer states freshness and explicit coverage. Clients sending X-Greatwait-Accept-Partial-Forecast: true receive bounded lower-bound counts when a book reaches a row, cell or recurrence-work bound, with coverage.complete false and the exact bounds reached. Without this capability header the previous refusal behavior remains safe for clients that only read totals. Unavailable or stale sources still refuse. Coverage identifies the selected recurring schedule range but never includes destinations, payload or endpoint detail.";
     readonly example: {
         buckets?: never;
         freshness?: never;
@@ -3378,6 +3520,9 @@ export declare const OPERATIONS: readonly [OperationDefinition & {
             to: string;
         };
     };
+    readonly requestHeaders: import("zod").ZodObject<{
+        "X-Greatwait-Accept-Partial-Forecast": import("zod").ZodOptional<import("zod").ZodLiteral<"true">>;
+    }, import("zod/v4/core").$strip>;
     readonly id: "forecast.read";
     readonly idempotent: true;
     readonly mcp: {
@@ -3400,6 +3545,52 @@ export declare const OPERATIONS: readonly [OperationDefinition & {
         to: import("zod").ZodOptional<import("zod").ZodString>;
     }, import("zod/v4/core").$strip>;
     readonly response: import("zod").ZodNever | import("zod").ZodObject<{
+        coverage: import("zod").ZodOptional<import("zod").ZodObject<{
+            complete: import("zod").ZodBoolean;
+            countMeaning: import("zod").ZodEnum<{
+                "complete-total": "complete-total";
+                "lower-bound": "lower-bound";
+            }>;
+            projectedWindow: import("zod").ZodObject<{
+                from: import("zod").ZodString;
+                to: import("zod").ZodString;
+            }, import("zod/v4/core").$strip>;
+            completeThrough: import("zod").ZodString;
+            heads: import("zod").ZodObject<{
+                groupsRead: import("zod").ZodNumber;
+                occurrencesCounted: import("zod").ZodNumber;
+                complete: import("zod").ZodBoolean;
+                selection: import("zod").ZodLiteral<"earliest bucket, latency class, partition key groups">;
+                lastGroup: import("zod").ZodOptional<import("zod").ZodObject<{
+                    start: import("zod").ZodString;
+                    latencyClass: import("zod").ZodEnum<{
+                        realtime: "realtime";
+                        bulk: "bulk";
+                    }>;
+                    partitionKey: import("zod").ZodString;
+                }, import("zod/v4/core").$strip>>;
+            }, import("zod/v4/core").$strip>;
+            recurring: import("zod").ZodObject<{
+                schedulesRead: import("zod").ZodNumber;
+                populationComplete: import("zod").ZodBoolean;
+                selection: import("zod").ZodLiteral<"oldest eligible active recurring schedules by createdAt and scheduleId">;
+                firstScheduleId: import("zod").ZodOptional<import("zod").ZodString>;
+                lastScheduleId: import("zod").ZodOptional<import("zod").ZodString>;
+            }, import("zod/v4/core").$strip>;
+            work: import("zod").ZodObject<{
+                usedUnits: import("zod").ZodNumber;
+                limitUnits: import("zod").ZodNumber;
+            }, import("zod/v4/core").$strip>;
+            boundsReached: import("zod").ZodArray<import("zod").ZodObject<{
+                kind: import("zod").ZodEnum<{
+                    "head-cells": "head-cells";
+                    "recurring-series": "recurring-series";
+                    "projection-work": "projection-work";
+                    "projection-cells": "projection-cells";
+                }>;
+                limit: import("zod").ZodNumber;
+            }, import("zod/v4/core").$strip>>;
+        }, import("zod/v4/core").$strip>>;
         buckets: import("zod").ZodArray<import("zod").ZodObject<{
             byLatencyClass: import("zod").ZodObject<{
                 bulk: import("zod").ZodNumber;
@@ -3428,7 +3619,7 @@ export declare const OPERATIONS: readonly [OperationDefinition & {
     readonly surfaces: readonly ["api", "mock"];
 }, {
     readonly creates: false;
-    readonly description: "" | "Reads the verified principal's organization-wide prepaid execution position from the authoritative PostgreSQL ledger. Desired and effective revisions remain distinct, and pending stays true until D1 records PostgreSQL confirmation. Amounts are exact integer microdollars encoded as decimal strings; currency is USD and scale is six. Reserved credit has already been committed to a logical attempt but is not yet a settled debit. A missing hard cap means the customer elected no execution spending cap, never zero room. Shadow mode records what enforcement would have done without charging or blocking, and the activation boundary prevents retroactive charges.";
+    readonly description: "" | "Reads the verified principal's organization-wide prepaid execution position from the authoritative PostgreSQL ledger. Desired and effective revisions remain distinct, and pending stays true until the control plane records PostgreSQL confirmation. Amounts are exact integer microdollars encoded as decimal strings; currency is USD and scale is six. Reserved credit has already been committed to a logical attempt but is not yet a settled debit. A missing hard cap means the customer elected no execution spending cap, never zero room. Shadow mode records what enforcement would have done without charging or blocking, and the activation boundary prevents retroactive charges.";
     readonly example: {};
     readonly id: "billing.summary";
     readonly idempotent: true;
@@ -3441,7 +3632,7 @@ export declare const OPERATIONS: readonly [OperationDefinition & {
     readonly mutates: false;
     readonly path: "/v1/billing/summary";
     readonly principals: readonly ["api-credential", "oauth", "session"];
-    readonly problems: readonly [];
+    readonly problems: readonly ["billing_not_ready", "service_unavailable"];
     readonly response: import("zod").ZodObject<{
         activation: import("zod").ZodObject<{
             boundary: import("zod").ZodString;
@@ -3668,6 +3859,7 @@ export declare const OPERATIONS: readonly [OperationDefinition & {
     readonly principals: readonly ["api-credential", "oauth", "session"];
     readonly problems: readonly ["idempotency_key_reused", "invalid_request", "not_found", "revision_conflict", "service_unavailable", "state_conflict", "test_to_live_escalation"];
     readonly request: import("zod").ZodObject<{
+        automaticTopUp: import("zod").ZodOptional<import("zod").ZodBoolean>;
         confirmed: import("zod").ZodLiteral<true>;
         expectedRevision: import("zod").ZodNumber;
         quote: import("zod").ZodString;
@@ -3684,6 +3876,26 @@ export declare const OPERATIONS: readonly [OperationDefinition & {
     readonly requestHeaders: import("zod").ZodObject<{
         "Idempotency-Key": import("zod").ZodString;
     }, import("zod/v4/core").$strip>;
+} & BillingFundingContract, {
+    readonly creates: false;
+    readonly description: "" | "Confirms one execution-credit payment or saved-payment-method setup now, typically when the customer returns from hosted Checkout, instead of waiting for the provider's notification or the scheduled repair. It reads that one operation from the payment provider under the caller organization's authenticated account and applies what the provider reports: a paid Checkout grants its exact credit once, an open or unpaid one stays pending, and an operation already settled is answered without reading the provider. Nothing in the request can claim a payment succeeded — it names only which operation to read. Repeating the call is safe and converges on the same state. Returns the same execution-funding position as billing.funding.";
+    readonly environments: readonly ["live"];
+    readonly id: "billing.fundingconfirm";
+    readonly idempotent: true;
+    readonly mcp: {
+        readonly destructive: false;
+        readonly kind: "tool";
+        readonly openWorld: false;
+    };
+    readonly method: "POST";
+    readonly mutates: true;
+    readonly path: "/v1/billing/funding/{paymentOperation}/confirm";
+    readonly principals: readonly ["api-credential", "oauth", "session"];
+    readonly problems: readonly ["not_found", "service_unavailable", "state_conflict", "test_to_live_escalation"];
+    readonly scopes: readonly ["billing:write"];
+    readonly sessionAuthority: "headers";
+    readonly summary: "" | "Confirm one payment with the provider now";
+    readonly surfaces: readonly ["api", "mock"];
 } & BillingFundingContract, {
     readonly scopes: readonly ["billing:write"];
     readonly sessionAuthority: "headers";
@@ -3731,14 +3943,13 @@ export declare const OPERATIONS: readonly [OperationDefinition & {
     }, import("zod/v4/core").$strip>;
 } & BillingFundingContract, NamedOperation<"billing.autotopuppreview">, NamedOperation<"billing.autotopup">, {
     readonly scopes: readonly ["billing:write"];
-    readonly sessionAuthority: "headers";
-    readonly summary: "" | "Request operator-reviewed refund";
+    readonly summary: "" | "Reserve credit against a payment for refund";
     readonly surfaces: readonly ["api", "mock"];
     readonly responseHeaders?: import("zod").ZodObject<{
         "Idempotency-Replayed": import("zod").ZodOptional<import("zod").ZodLiteral<"true">>;
     }, import("zod/v4/core").$strip>;
     readonly creates: true;
-    readonly description: "" | "Records an explicitly approved billing-owner request for operator review of unused purchased execution credit. It never submits a refund, cashes out credit or grants an MCP cash-out path; the Idempotency-Key preserves one request across retries. Trial credit has no cash value, provider submission remains an operator action, and any later refund does not restore automatic purchasing authority for the month.";
+    readonly description: "" | "Reserves unused purchased execution credit against one original payment, with the billing owner's explicit confirmation. Purchased credit is not refundable except where a charge is refunded because the service did not work as described, so this records no promise of a refund: it never calls Stripe, cashes out credit or grants an MCP cash-out path. A Stripe refund of that payment settles the reservation when it carries the same credit and supersedes it otherwise; the Idempotency-Key preserves one reservation across retries. Trial credit has no cash value, and a refund does not restore automatic purchasing authority used in the month.";
     readonly environments: readonly ["live"];
     readonly example: {
         amount?: never;
@@ -3767,7 +3978,7 @@ export declare const OPERATIONS: readonly [OperationDefinition & {
     readonly method: "POST";
     readonly mutates: true;
     readonly path: "/v1/billing/funding/refunds";
-    readonly principals: readonly ["api-credential", "oauth", "session"];
+    readonly principals: readonly ["api-credential", "oauth"];
     readonly problems: readonly ["idempotency_key_reused", "invalid_request", "not_found", "service_unavailable", "state_conflict", "test_to_live_escalation"];
     readonly request: import("zod").ZodObject<{
         amount: import("zod").ZodObject<{
@@ -3810,14 +4021,13 @@ export declare const OPERATIONS: readonly [OperationDefinition & {
     }, import("zod/v4/core").$strict> | import("zod").ZodNever;
 }, {
     readonly scopes: readonly ["billing:write"];
-    readonly sessionAuthority: "headers";
-    readonly summary: "" | "Record a reviewed refund decision";
+    readonly summary: "" | "Complete or decline a refund reservation";
     readonly surfaces: readonly ["api", "mock"];
     readonly responseHeaders?: import("zod").ZodObject<{
         "Idempotency-Replayed": import("zod").ZodOptional<import("zod").ZodLiteral<"true">>;
     }, import("zod/v4/core").$strip>;
     readonly creates: false;
-    readonly description: "" | "Records an already-made external operator decision on a pending unused-credit refund request. Completion verifies an existing Stripe refund by authenticated provider read before applying the exact credit, tax and gross adjustment; it never creates a provider refund. Decline releases the reserved credit without contacting the provider. The Idempotency-Key makes either decision converge across retries.";
+    readonly description: "" | "Completes or declines a pending refund reservation. Completion verifies an existing Stripe refund by authenticated provider read before applying the exact credit, tax and gross adjustment, and converges on the recorded adjustment when that refund already settled the reservation; it never creates a provider refund. Decline releases the reserved credit without contacting the provider, and a reservation a Stripe refund superseded is refused as a state conflict. The Idempotency-Key makes either outcome converge across retries.";
     readonly environments: readonly ["live"];
     readonly id: "billing.refundresolution";
     readonly idempotent: true;
@@ -3829,7 +4039,7 @@ export declare const OPERATIONS: readonly [OperationDefinition & {
     readonly method: "PATCH";
     readonly mutates: true;
     readonly path: "/v1/billing/funding/refunds/{refundRequest}";
-    readonly principals: readonly ["api-credential", "oauth", "session"];
+    readonly principals: readonly ["api-credential", "oauth"];
     readonly problems: readonly ["idempotency_key_reused", "invalid_request", "not_found", "service_unavailable", "state_conflict", "test_to_live_escalation"];
     readonly request: import("zod").ZodObject<{
         confirmed: import("zod").ZodLiteral<true>;
@@ -4082,6 +4292,282 @@ export declare const OPERATIONS: readonly [OperationDefinition & {
     };
     readonly summary: "" | "Open hosted payment recovery";
     readonly problems: readonly ["service_unavailable", "state_conflict", "not_found", "revision_conflict", "test_to_live_escalation"];
+}, {
+    readonly creates: false;
+    readonly description: "" | "Reads the verified organization's saved payment method: the one method automatic execution top-ups and project subscriptions charge. It is the payment provider's default payment method for the organization, read by authenticated provider call. method says what it is — type card with brand, last four digits and expiry; type link with the email Link reports, when it reports one; or type other with the provider's type name (cashapp, amazon_pay, klarna and the like) — and every variant carries label, the name to show a person. card repeats the card details when the method is a card and is null otherwise; it is kept for clients written before other payment methods were accepted. A method the organization already authorized for automatic top-up or a project subscription is adopted as the saved method, so an existing customer is not told they have none. method and card are null when the organization has none.";
+    readonly example: {
+        card?: never;
+        method?: never;
+    } | {
+        card: {
+            brand: string;
+            expMonth: number;
+            expYear: number;
+            last4: string;
+        };
+        method: {
+            brand: string;
+            expMonth: number;
+            expYear: number;
+            label: string;
+            last4: string;
+            type: string;
+        };
+    };
+    readonly id: "billing.paymentmethod";
+    readonly idempotent: true;
+    readonly mcp: {
+        readonly destructive: false;
+        readonly kind: "tool";
+        readonly openWorld: false;
+    };
+    readonly method: "GET";
+    readonly mutates: false;
+    readonly path: "/v1/billing/payment-method";
+    readonly principals: readonly ["api-credential", "oauth", "session"];
+    readonly problems: readonly ["service_unavailable"];
+    readonly response: 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> | import("zod").ZodNever;
+    readonly scopes: readonly ["usage:read"];
+    readonly sessionAuthority: "headers";
+    readonly summary: "" | "Read the saved payment method";
+    readonly surfaces: readonly ["api", "mock"];
+}, {
+    readonly creates: false;
+    readonly description: "" | "Lists the verified organization's project subscription charges: the payment provider's invoices for its project subscription, read by authenticated provider call, most recent first and at most 24. Execution-credit purchases are not listed here; billing.funding reports them. Draft and zero-amount invoices are omitted. Each amount is the invoice total including tax, and the receipt link, when present, is the provider-hosted invoice page. An organization that has never been billed has an empty list; reading it creates nothing and changes nothing.";
+    readonly example: {
+        data?: never;
+    } | {
+        data: {
+            amount: {
+                currency: string;
+                microdollars: string;
+                scale: number;
+            };
+            createdAt: string;
+            id: string;
+            receiptUrl: string;
+            state: string;
+        }[];
+    };
+    readonly id: "billing.invoices";
+    readonly idempotent: true;
+    readonly mcp: {
+        readonly destructive: false;
+        readonly kind: "tool";
+        readonly openWorld: false;
+    };
+    readonly method: "GET";
+    readonly mutates: false;
+    readonly path: "/v1/billing/invoices";
+    readonly principals: readonly ["api-credential", "oauth", "session"];
+    readonly problems: readonly ["service_unavailable"];
+    readonly response: 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> | import("zod").ZodNever;
+    readonly scopes: readonly ["usage:read"];
+    readonly sessionAuthority: "headers";
+    readonly summary: "" | "List project subscription charges";
+    readonly surfaces: readonly ["api", "mock"];
+}, {
+    readonly creates: false;
+    readonly description: "" | "Creates a short-lived provider-hosted payment-method setup session for the verified organization and returns its address. It offers every payment method the provider account enables that can be charged later without the customer present — cards, Link and others. Saving one there charges nothing; it becomes the saved payment method only once billing.paymentmethodconfirm (when the browser returns) or the provider's notification reads the completed setup by authenticated provider call. An optional return address must share the origin of the configured billing page.";
+    readonly environments: readonly ["live"];
+    readonly example: {
+        url?: never;
+    } | {
+        url: string;
+    };
+    readonly id: "billing.paymentmethodsetup";
+    readonly idempotent: false;
+    readonly mcp: {
+        readonly destructive: false;
+        readonly kind: "tool";
+        readonly openWorld: false;
+    };
+    readonly method: "POST";
+    readonly mutates: true;
+    readonly path: "/v1/billing/payment-method/setup";
+    readonly principals: readonly ["api-credential", "oauth", "session"];
+    readonly problems: readonly ["invalid_request", "service_unavailable", "state_conflict", "not_found", "revision_conflict", "test_to_live_escalation"];
+    readonly request: import("zod").ZodObject<{
+        returnUrl: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strict>;
+    readonly requestExample: {};
+    readonly response: import("zod").ZodObject<{
+        url: import("zod").ZodString;
+    }, import("zod/v4/core").$strip> | import("zod").ZodNever;
+    readonly scopes: readonly ["billing:write"];
+    readonly sessionAuthority: "headers";
+    readonly summary: "" | "Start saving a payment method";
+    readonly surfaces: readonly ["api", "mock"];
+}, {
+    readonly creates: false;
+    readonly description: "" | "Makes the payment method saved in one completed hosted setup the organization's saved payment method, typically when the browser returns from it. The session is read by authenticated provider call and must belong to the verified organization's own customer; a session of another organization is answered not found. It becomes the provider default for invoices, the default of the organization's project subscription, and the automatic top-up payment method — readying a top-up rule that was waiting for one. The response has the shape billing.paymentmethod returns. When the previous method was removed (billing.paymentmethodremove) and the paid period it let run out has not ended, renewal resumes for the projects that removal stopped; a project the customer cancelled themselves stays cancelled. Nothing in the request can claim a setup succeeded, and repeating the call is safe.";
+    readonly environments: readonly ["live"];
+    readonly example: {
+        card?: never;
+        method?: never;
+    } | {
+        card: {
+            brand: string;
+            expMonth: number;
+            expYear: number;
+            last4: string;
+        };
+        method: {
+            brand: string;
+            expMonth: number;
+            expYear: number;
+            label: string;
+            last4: string;
+            type: string;
+        };
+    };
+    readonly id: "billing.paymentmethodconfirm";
+    readonly idempotent: true;
+    readonly mcp: {
+        readonly destructive: false;
+        readonly kind: "tool";
+        readonly openWorld: false;
+    };
+    readonly method: "POST";
+    readonly mutates: true;
+    readonly path: "/v1/billing/payment-method/confirm";
+    readonly principals: readonly ["api-credential", "oauth", "session"];
+    readonly problems: readonly ["invalid_request", "not_found", "service_unavailable", "state_conflict", "revision_conflict", "test_to_live_escalation"];
+    readonly request: import("zod").ZodObject<{
+        checkoutSession: import("zod").ZodString;
+    }, import("zod/v4/core").$strict>;
+    readonly requestExample: {
+        checkoutSession?: never;
+    } | {
+        checkoutSession: string;
+    };
+    readonly response: 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> | import("zod").ZodNever;
+    readonly scopes: readonly ["billing:write"];
+    readonly sessionAuthority: "headers";
+    readonly summary: "" | "Confirm a saved payment method";
+    readonly surfaces: readonly ["api", "mock"];
+}, {
+    readonly creates: false;
+    readonly description: "" | "Removes the verified organization's saved payment method, and with it everything that charges it. Removing it stops renewal: every project subscription is set to end at the end of the period already paid for, so paid projects keep running until then and then stop, with nothing refunded and nothing more charged; billing.projects shows each one's cancellationAt. The included free project is unaffected. Automatic top-up turns off immediately and forgets its payment method. A pending or declined project addition is ended, so nothing later starts a checkout or a charge, and no project can be added until a payment method is saved again. The method stops being the provider default and is detached from the organization's customer. The request must carry confirmed: true. Repeating the call is safe: with nothing on file it answers a null method and card and still makes sure nothing is left that could charge one. Saving a payment method through billing.paymentmethodsetup before the period ends keeps those projects: renewal resumes on the new method, except for any project the customer cancelled themselves. After the period ends, a paid project must be added again.";
+    readonly environments: readonly ["live"];
+    readonly example: {
+        card?: never;
+        method?: never;
+    } | {
+        card: null;
+        method: null;
+    };
+    readonly id: "billing.paymentmethodremove";
+    readonly idempotent: true;
+    readonly mcp: {
+        readonly destructive: true;
+        readonly kind: "tool";
+        readonly openWorld: false;
+    };
+    readonly method: "POST";
+    readonly mutates: true;
+    readonly path: "/v1/billing/payment-method/remove";
+    readonly principals: readonly ["api-credential", "oauth", "session"];
+    readonly problems: readonly ["invalid_request", "not_found", "service_unavailable", "state_conflict", "revision_conflict", "test_to_live_escalation"];
+    readonly request: import("zod").ZodObject<{
+        confirmed: import("zod").ZodLiteral<true>;
+    }, import("zod/v4/core").$strict>;
+    readonly requestExample: {
+        confirmed?: never;
+    } | {
+        confirmed: boolean;
+    };
+    readonly response: 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> | import("zod").ZodNever;
+    readonly scopes: readonly ["billing:write"];
+    readonly sessionAuthority: "headers";
+    readonly summary: "" | "Remove the saved payment method";
+    readonly surfaces: readonly ["api", "mock"];
 }, {
     readonly creates: false;
     readonly description: "" | "Advances at most one due, already-authorized desired billing-policy revision for the caller's organization into PostgreSQL, then returns the same exact desired/effective summary as billing.summary. The command never changes the desired document. A transport failure is recorded for bounded retry and remains pending. Repeating the command may advance the next queued revision, so each call requires approval.";
@@ -4098,7 +4584,7 @@ export declare const OPERATIONS: readonly [OperationDefinition & {
     readonly mutates: true;
     readonly path: "/v1/billing/reconcile";
     readonly principals: readonly ["api-credential", "oauth", "session"];
-    readonly problems: readonly ["service_unavailable", "test_to_live_escalation"];
+    readonly problems: readonly ["billing_not_ready", "service_unavailable", "test_to_live_escalation"];
     readonly response: import("zod").ZodObject<{
         activation: import("zod").ZodObject<{
             boundary: import("zod").ZodString;
@@ -4423,6 +4909,9 @@ export declare const OPERATIONS: readonly [OperationDefinition & {
                 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<{
@@ -4442,6 +4931,83 @@ export declare const OPERATIONS: readonly [OperationDefinition & {
     readonly sessionAuthority: "headers";
     readonly summary: "" | "List immutable billing entries";
     readonly surfaces: readonly ["api", "mock"];
+}, {
+    readonly creates: false;
+    readonly description: "" | "Read effective customer allowances for the verified organization. Deployment and organization revisions identify the policy used; infrastructure and other organizations' settings are excluded.";
+    readonly example: {
+        limits?: never;
+        provenance?: never;
+        revision?: never;
+    } | {
+        limits: {
+            inlinePayloadBytes: number;
+            forecastHorizonSeconds: number;
+            usageWindowDays: number;
+        };
+        provenance: {
+            inlinePayloadBytes: string;
+            forecastHorizonSeconds: string;
+            usageWindowDays: string;
+        };
+        revision: {
+            global: number;
+            organization: number;
+        };
+    };
+    readonly id: "limits.read";
+    readonly idempotent: true;
+    readonly mcp: {
+        readonly destructive: false;
+        readonly kind: "tool";
+        readonly openWorld: false;
+    };
+    readonly method: "GET";
+    readonly mutates: false;
+    readonly path: "/v1/limits";
+    readonly principals: readonly ["api-credential", "oauth", "session"];
+    readonly problems: readonly ["service_unavailable"];
+    readonly response: import("zod").ZodObject<{
+        limits: import("zod").ZodObject<{
+            inlinePayloadBytes: import("zod").ZodNumber;
+            partitionKeyCeiling: import("zod").ZodOptional<import("zod").ZodNumber>;
+            forecastHorizonSeconds: import("zod").ZodNumber;
+            usageWindowDays: import("zod").ZodNumber;
+        }, import("zod/v4/core").$strict>;
+        provenance: import("zod").ZodObject<{
+            inlinePayloadBytes: import("zod").ZodEnum<{
+                organization: "organization";
+                default: "default";
+                global: "global";
+                deployment: "deployment";
+            }>;
+            partitionKeyCeiling: import("zod").ZodOptional<import("zod").ZodEnum<{
+                organization: "organization";
+                default: "default";
+                global: "global";
+                deployment: "deployment";
+            }>>;
+            forecastHorizonSeconds: import("zod").ZodEnum<{
+                organization: "organization";
+                default: "default";
+                global: "global";
+                deployment: "deployment";
+            }>;
+            usageWindowDays: import("zod").ZodEnum<{
+                organization: "organization";
+                default: "default";
+                global: "global";
+                deployment: "deployment";
+            }>;
+        }, import("zod/v4/core").$strict>;
+        revision: import("zod").ZodObject<{
+            global: import("zod").ZodNumber;
+            organization: import("zod").ZodNumber;
+        }, import("zod/v4/core").$strict>;
+    }, import("zod/v4/core").$strict> | import("zod").ZodNever;
+    readonly scopes: readonly ["schedules:read"];
+    readonly sessionAuthority: "headers";
+    readonly summary: "" | "Read effective customer limits";
+    readonly surfaces: readonly ["api", "mock"];
 }, {
     readonly creates: false;
     readonly description: "" | "Legacy terminal-occurrence volume by UTC day from the authoritative scheduling model. This is an operational outcome aggregate retained for compatibility; it is not the PAYG invoice meter. Billing is per logical delivery attempt, including retries and redeliveries, and is exposed exactly by billing.summary and billing.ledger. Days with no terminal occurrence are absent rather than zero, and the window states which days the answer covers. `from` and `to` are snapped outward to UTC midnight, so an answer always covers whole days.";
@@ -4645,7 +5211,7 @@ export declare const OPERATIONS: readonly [OperationDefinition & {
     readonly idempotent: true;
     readonly mcp: {
         readonly kind: "unavailable";
-        readonly reason: "A transitional shape for the autoscaler migration, scheduled for withdrawal once W6-02 has cut over. forecast.read is the same data in the shape this product publishes, and it is the tool an agent should reach for.";
+        readonly reason: "A transitional shape for the autoscaler migration, withdrawn after its cutover. forecast.read is the same data in the shape this product publishes, and it is the tool an agent should reach for.";
     };
     readonly method: "GET";
     readonly mutates: false;
@@ -4948,6 +5514,8 @@ export declare const OPERATIONS: readonly [OperationDefinition & {
         data: {
             attemptNumber: number;
             classifiedAt: string;
+            dispatchRecoveries: number;
+            localReceiptRecoveries: number;
             delivery: string;
             diagnostic: string;
             durationMs: number;
@@ -4989,7 +5557,9 @@ export declare const OPERATIONS: readonly [OperationDefinition & {
     readonly response: import("zod").ZodObject<{
         data: import("zod").ZodArray<import("zod").ZodObject<{
             id: import("zod").ZodString;
+            localReceiptRecoveries: import("zod").ZodOptional<import("zod").ZodInt>;
             occurrence: import("zod").ZodString;
+            rescues: import("zod").ZodOptional<import("zod").ZodInt>;
             remediation: import("zod").ZodOptional<import("zod").ZodEnum<{
                 none: "none";
                 review_retry_policy: "review_retry_policy";
@@ -5048,6 +5618,7 @@ export declare const OPERATIONS: readonly [OperationDefinition & {
                 network_ambiguous: "network_ambiguous";
                 payload_unavailable: "payload_unavailable";
             }>>;
+            dispatchRecoveries: import("zod").ZodOptional<import("zod").ZodInt>;
             durationMs: import("zod").ZodOptional<import("zod").ZodNumber>;
         }, import("zod/v4/core").$strip>>;
         nextCursor: import("zod").ZodOptional<import("zod").ZodString>;
@@ -5069,6 +5640,8 @@ export declare const OPERATIONS: readonly [OperationDefinition & {
         attempt: {
             attemptNumber: number;
             classifiedAt: string;
+            dispatchRecoveries: number;
+            localReceiptRecoveries: number;
             delivery: string;
             diagnostic: string;
             durationMs: number;
@@ -5104,7 +5677,9 @@ export declare const OPERATIONS: readonly [OperationDefinition & {
     readonly response: import("zod").ZodObject<{
         attempt: import("zod").ZodObject<{
             id: import("zod").ZodString;
+            localReceiptRecoveries: import("zod").ZodOptional<import("zod").ZodInt>;
             occurrence: import("zod").ZodString;
+            rescues: import("zod").ZodOptional<import("zod").ZodInt>;
             remediation: import("zod").ZodOptional<import("zod").ZodEnum<{
                 none: "none";
                 review_retry_policy: "review_retry_policy";
@@ -5163,6 +5738,7 @@ export declare const OPERATIONS: readonly [OperationDefinition & {
                 network_ambiguous: "network_ambiguous";
                 payload_unavailable: "payload_unavailable";
             }>>;
+            dispatchRecoveries: import("zod").ZodOptional<import("zod").ZodInt>;
             durationMs: import("zod").ZodOptional<import("zod").ZodNumber>;
         }, import("zod/v4/core").$strip>;
         freshness: import("zod").ZodObject<{
@@ -5189,6 +5765,8 @@ export declare const OPERATIONS: readonly [OperationDefinition & {
     } | {
         attempt: {
             attemptNumber: number;
+            dispatchRecoveries: number;
+            localReceiptRecoveries: number;
             delivery: string;
             id: string;
             occurrence: string;
@@ -5220,7 +5798,9 @@ export declare const OPERATIONS: readonly [OperationDefinition & {
     readonly response: import("zod").ZodObject<{
         attempt: import("zod").ZodObject<{
             id: import("zod").ZodString;
+            localReceiptRecoveries: import("zod").ZodOptional<import("zod").ZodInt>;
             occurrence: import("zod").ZodString;
+            rescues: import("zod").ZodOptional<import("zod").ZodInt>;
             remediation: import("zod").ZodOptional<import("zod").ZodEnum<{
                 none: "none";
                 review_retry_policy: "review_retry_policy";
@@ -5279,6 +5859,7 @@ export declare const OPERATIONS: readonly [OperationDefinition & {
                 network_ambiguous: "network_ambiguous";
                 payload_unavailable: "payload_unavailable";
             }>>;
+            dispatchRecoveries: import("zod").ZodOptional<import("zod").ZodInt>;
             durationMs: import("zod").ZodOptional<import("zod").ZodNumber>;
         }, import("zod/v4/core").$strip>;
         freshness: import("zod").ZodObject<{