@empiricalrun/playwright-utils 0.60.4 → 0.61.0

package/dist/generated/api-worker-openapi.d.ts

@@ -1149,7 +1149,7 @@ export interface paths {
         put?: never;
         /**
          * 🤖 Post a Slack message
-         * @description Posts Markdown to a Slack channel/thread, or a recipient-addressed DM, as the Empirical bot. Provide exactly one of channel, slack_user_id, or user_id. Recipient sends create a new DM root and require idempotency_key. Channel sends use the channel and root timestamp coordinates the agent was given. Sandbox-delegated principals only; the channel must be one the calling project can reach. Registered-root replies are recorded and de-duplicated by idempotency key for the sending session. New roots are registered and bound to the sending session after posting; if delivery or registration is uncertain, check Slack before retrying.
+         * @description Posts Markdown to a Slack channel/thread, or a recipient-addressed DM, as the Empirical bot. Provide exactly one of channel, slack_user_id, or user_id. Recipient sends create a new DM root and require idempotency_key. Channel-wide mentions (<!channel>, <!here>, <!everyone>) are rejected; tag a subteam or users instead. Channel sends use the channel and root timestamp coordinates the agent was given. Sandbox-delegated principals only; the channel must be one the calling project can reach. Registered-root replies are recorded and de-duplicated by idempotency key for the sending session. New roots are registered and bound to the sending session after posting; if delivery or registration is uncertain, check Slack before retrying.
          */
         post: operations["slackSendMessage"];
         delete?: never;
@@ -1965,6 +1965,66 @@ export interface paths {
         patch: operations["updateApiKey"];
         trace?: never;
     };
+    "/api/billing/month-summary": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * 🛡️ Get the org's usage and cost for a month
+         * @description Org-wide usage across all of the scoped project's org projects, against the plan in effect: per-meter usage, overage so far, a month-end projection, and the usage limit.
+         */
+        get: operations["getBillingMonthSummary"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/billing/usage-limit": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        /**
+         * 🛡️ Set or remove the org's usage limit
+         * @description Sets the most overage the org allows per usage month, in whole dollars as cents, or removes the limit with null. Takes effect right away: a limit at or below this month's overage pauses new work.
+         */
+        put: operations["setUsageLimit"];
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/billing/usage-limit/events": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * 🛡️ List the usage limit's history
+         * @description Changes to the org's usage limit and the alerts and blocks it caused, newest first.
+         */
+        get: operations["listUsageLimitEvents"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/chat-sessions": {
         parameters: {
             query?: never;
@@ -3371,6 +3431,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/invoices/{id}/email-preview": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * 🛡️ Preview an invoice email
+         * @description Renders the invoice email exactly as `POST /{id}/send` would send it, without sending anything.
+         */
+        get: operations["previewInvoiceEmail"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/invoices/{id}/generate": {
         parameters: {
             query?: never;
@@ -3462,7 +3542,7 @@ export interface paths {
         put?: never;
         /**
          * 🛡️ Send an invoice
-         * @description Emails the invoice PDF to the organisation's billing contacts and marks it as sent (unless `is_test_email` is set).
+         * @description Emails the invoice PDF to the organisation's billing contacts and marks it as sent (unless `is_test_email` is set). On a real send, an unpaid INR invoice without a payment link gets a Razorpay-hosted payment link, stored on the invoice and included in the email.
          */
         post: operations["sendInvoice"];
         delete?: never;
@@ -4272,13 +4352,13 @@ export interface paths {
         };
         /**
          * 🛡️ List plan assignments
-         * @description Returns a paginated list of plan assignments, optionally filtered by organisation and order-form line.
+         * @description Returns a paginated list of plan assignments, optionally filtered by organisation and plan.
          */
         get: operations["listPlanAssignments"];
         put?: never;
         /**
          * 🛡️ Create a plan assignment
-         * @description Creates a plan assignment for an existing organisation.
+         * @description Puts an existing organisation on a plan from `effective_from`.
          */
         post: operations["createPlanAssignment"];
         delete?: never;
@@ -4311,6 +4391,74 @@ export interface paths {
         patch: operations["updatePlanAssignment"];
         trace?: never;
     };
+    "/api/plan-assignments/org": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * 🛡️ Get the org's plan
+         * @description Returns whether the scoped project's org is on a plan (now, or during `month`), and the plan's terms when it is a shared plan.
+         */
+        get: operations["getOrgPlan"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/plans": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * 🛡️ List plans
+         * @description Returns the shared plans with their meters, or one organisation's custom plans.
+         */
+        get: operations["listPlans"];
+        put?: never;
+        /**
+         * 🛡️ Create a shared plan
+         * @description Creates a shared plan and its meters. Plans are immutable once created, apart from `status`: to change a price, create a new plan with a new key and retire the old one. Custom plans are created through order forms.
+         */
+        post: operations["createPlan"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/plans/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * 🛡️ Get a plan
+         * @description Retrieves a single plan with its meters.
+         */
+        get: operations["getPlanById"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        /**
+         * 🛡️ Update a plan's status
+         * @description Sets a plan's `status`. Plans are immutable apart from status: any other field is rejected. Retiring a plan does not touch existing assignments, which stay on it.
+         */
+        patch: operations["updatePlan"];
+        trace?: never;
+    };
     "/api/project-addons": {
         parameters: {
             query?: never;
@@ -5235,6 +5383,64 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/system-messages": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** 🛡️ 🧪 List system messages with delivery and ack counts */
+        get: operations["listSystemMessages"];
+        put?: never;
+        /**
+         * 🛡️ 🧪 Broadcast a system message to manager sessions
+         * @description Persists the message and delivers it to project manager sessions. With `project_ids`, every listed project gets a recipient row, and one without an open manager is recorded as failed. Without it, the message goes to every project with an open manager, and active projects without one are returned in `skipped_project_ids` (not persisted). Delivery is attempted before responding. Managers acknowledge through `POST /api/system-messages/{id}/ack`.
+         */
+        post: operations["createSystemMessage"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/system-messages/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** 🛡️ 🧪 Get a system message's per-project delivery and ack status */
+        get: operations["getSystemMessage"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/system-messages/{id}/ack": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * 🧪 Acknowledge a system message from a manager session
+         * @description Records the calling manager session's acknowledgement for its project. Any manager session of the project may ack, so a successor can answer a message its predecessor received. Re-acking overwrites the previous status and note.
+         */
+        post: operations["ackSystemMessage"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/test-runs/events": {
         parameters: {
             query?: never;
@@ -5899,8 +6105,8 @@ export interface components {
             fx_rate: number | null;
             /** @description Billing line kind (`tier` or `addon`). */
             kind: string;
-            /** @description Originating order-form line ID, if any. */
-            order_form_line_id: number | null;
+            /** @description Plan this charge was billed from, if any. */
+            plan_id: number | null;
             /** @description Tier name, if applicable. */
             tier: string | null;
             /** @description Display label. */
@@ -5937,7 +6143,7 @@ export interface components {
                 /** @enum {string} */
                 kind?: "tier" | "addon";
                 project_id?: number | null;
-                order_form_line_id?: number | null;
+                plan_id?: number | null;
                 tier?: string | null;
                 label?: string | null;
                 base_price_cents: number;
@@ -6102,7 +6308,8 @@ export interface components {
                 label?: string | null;
                 base_price_cents: number;
                 meters?: {
-                    meter: string;
+                    /** @enum {string} */
+                    meter: "test_suite_size" | "ai_credits" | "test_minutes" | "test_run_duration";
                     included_qty?: number | null;
                     overage_price_cents?: number | null;
                 }[];
@@ -6128,7 +6335,8 @@ export interface components {
                 label?: string | null;
                 base_price_cents: number;
                 meters?: {
-                    meter: string;
+                    /** @enum {string} */
+                    meter: "test_suite_size" | "ai_credits" | "test_minutes" | "test_run_duration";
                     included_qty?: number | null;
                     overage_price_cents?: number | null;
                 }[];
@@ -6137,6 +6345,31 @@ export interface components {
         OrderFormPdfUploadRequest: {
             pdf_base64: string;
         };
+        OrgPlanResponse: {
+            /** @description Response payload. */
+            data: {
+                /** @description Whether the org has a plan assignment in effect now. */
+                has_plan: boolean;
+                /** @description The shared plan in effect, or null when the org has no plan or is on a custom plan. */
+                plan: {
+                    /** @description Plan name, e.g. `Managed`. */
+                    name: string;
+                    /** @description Currency of the prices below, e.g. `usd`. */
+                    currency: string;
+                    /** @description Monthly base price in cents of `currency`. */
+                    base_price_cents: number;
+                    /** @description Metered allowances and overage rates. */
+                    meters: {
+                        /** @description Meter key, e.g. `ai_credits` or `test_minutes`. */
+                        meter: string;
+                        /** @description Units included each month. */
+                        included_qty: number | null;
+                        /** @description Price per unit above the allowance, in cents of `currency`; may be fractional. */
+                        overage_price_cents: number | null;
+                    }[];
+                } | null;
+            };
+        };
         PlanAssignmentListResponse: {
             /** @description The page of plan assignments. */
             data: {
@@ -6149,18 +6382,14 @@ export interface components {
             id: number;
             /** @description Organisation this assignment belongs to. */
             org_id: number;
-            /** @description Order form line that backs this assignment. */
-            order_form_line_id: number;
+            /** @description Plan the organisation is on. */
+            plan_id: number;
             /** @description ISO-8601 timestamp the assignment starts. */
             effective_from: string;
             /** @description ISO-8601 timestamp the assignment ends, or null for open-ended. */
             effective_to: string | null;
             /** @description Origin: `order_form`, `derived_from_invoice`, or `manual`. */
             source: string;
-            /** @description Whether the assignment is pinned. */
-            pinned: boolean;
-            /** @description Arbitrary JSON overrides for the plan, or null. */
-            custom_overrides?: unknown;
             /** @description ISO-8601 creation timestamp. */
             created_at: string;
             /** @description ISO-8601 last-update timestamp. */
@@ -6179,8 +6408,8 @@ export interface components {
         CreatePlanAssignmentRequest: {
             /** @description Organisation this plan assignment belongs to. */
             org_id: number;
-            /** @description Order form line that backs this assignment. */
-            order_form_line_id: number;
+            /** @description Plan the organisation is on. */
+            plan_id: number;
             /**
              * Format: date-time
              * @description When the assignment starts being effective (timestamptz).
@@ -6196,16 +6425,12 @@ export interface components {
              * @enum {string}
              */
             source?: "order_form" | "derived_from_invoice" | "manual";
-            /** @description Whether the assignment is pinned. Defaults false. */
-            pinned?: boolean;
-            /** @description Arbitrary JSON overrides for the plan. */
-            custom_overrides?: unknown;
         };
         UpdatePlanAssignmentRequest: {
             /** @description Organisation this plan assignment belongs to. */
             org_id?: number;
-            /** @description Order form line that backs this assignment. */
-            order_form_line_id?: number;
+            /** @description Plan the organisation is on. */
+            plan_id?: number;
             /**
              * Format: date-time
              * @description When the assignment starts being effective (timestamptz).
@@ -6221,93 +6446,284 @@ export interface components {
              * @enum {string}
              */
             source?: "order_form" | "derived_from_invoice" | "manual";
-            /** @description Whether the assignment is pinned. */
-            pinned?: boolean;
-            /** @description Arbitrary JSON overrides for the plan. */
-            custom_overrides?: unknown;
         };
-        RunnerBackendListResponse: {
+        PlanListResponse: {
             /** @description Response payload. */
             data: {
-                runner_backends: components["schemas"]["RunnerBackend"][];
+                plans: components["schemas"]["Plan"][];
             };
         };
-        RunnerBackend: {
-            /** @description Runner backend ID. */
+        Plan: {
+            /** @description Plan ID. */
             id: number;
-            /** @description Organisation that owns the installation. */
-            org_id: number;
-            /** @description Human-readable name. */
-            name: string;
-            /** @description AWS account the installation runs in. */
-            aws_account_id: string;
-            /** @description AWS region of the installation. */
-            region: string;
-            /** @description Role api-worker assumes to drive the plane. */
-            role_arn: string;
-            /** @description External ID the role's trust policy must require. Give it only to this installation's owner. */
-            external_id: string;
-            /** @description ECS cluster name. */
-            cluster_name: string;
-            /** @description CloudWatch log group of the worker. */
-            log_group_name: string;
-            /** @description Worker container name. */
-            container_name: string;
-            /** @description Job queue URLs are `${queue_prefix}-${machineSize}`. */
-            queue_prefix: string;
-            /**
-             * @description `pending` until verified; only `active` backends receive runs.
-             * @enum {string}
-             */
-            status: "pending" | "active" | "disabled";
-            /** @description ISO-8601 time of the last successful verify. */
-            last_verified_at: string | null;
-            /** @description ISO-8601 time of the last verify, manual or scheduled, whatever its outcome. */
-            last_checked_at: string | null;
-            /** @description Outcome of the last verify; null if never run. */
-            last_check_ok: boolean | null;
-            /** @description Every check from the last verify. */
-            last_check_results: components["schemas"]["RunnerBackendCheck"][] | null;
-            /** @description ISO-8601 start of the current run of failed checks; null while passing. A failing check does not change `status`. */
-            check_failing_since: string | null;
-            /** @description ISO-8601 creation time. */
+            /** @description Organisation a custom plan belongs to; null for a shared plan. */
+            org_id: number | null;
+            /** @description Order form a custom plan comes from, if any. */
+            order_form_id: number | null;
+            /** @description `tier` or `addon`. */
+            kind: string;
+            /** @description Stable unique key of a shared plan, e.g. `managed`. */
+            key: string | null;
+            /** @description Display name, e.g. `Managed`, `Starter`. */
+            name: string | null;
+            /** @description Currency the plan is priced in, e.g. `usd`. */
+            currency: string;
+            /** @description Monthly base price in cents of `currency`. */
+            base_price_cents: number;
+            /** @description `active` or `retired`. Retired plans keep existing assignments. */
+            status: string;
+            /** @description ISO-8601 creation timestamp. */
             created_at: string;
-            /** @description ISO-8601 last-update time. */
-            updated_at: string;
+            /** @description Metered allowances and overage rates. */
+            meters: components["schemas"]["PlanMeter"][];
         };
-        RunnerBackendCheck: {
-            /** @description `assume_role`, `job_queue`, `scaler_trigger_queue`, `ecs_cluster`, `ecs_tasks` or `worker_logs`. */
-            name: string;
-            /** @description Whether the check passed. */
-            ok: boolean;
-            /** @description The resource checked, or the AWS error. */
-            detail: string;
+        PlanMeter: {
+            /** @description Plan meter ID. */
+            id: number;
+            /** @description Plan this meter belongs to. */
+            plan_id: number;
+            /** @description Meter key, e.g. `ai_credits` or `test_minutes`. */
+            meter: string;
+            /** @description Units included in the base price each month. */
+            included_qty: number | null;
+            /** @description Price per unit above the included quantity, in cents of the plan currency. May be fractional (0.5 = $0.005). Null means usage above the allowance is not billed. */
+            overage_price_cents: number | null;
+            /** @description Display order. */
+            sort_order: number;
         };
-        RunnerBackendResponse: {
+        PlanResponse: {
             /** @description Response payload. */
             data: {
-                runner_backend: components["schemas"]["RunnerBackend"];
+                plan: components["schemas"]["Plan"];
             };
         };
-        CreateRunnerBackendBody: {
-            /** @description Owning organisation. */
-            org_id: number;
-            /** @description Human-readable name. */
+        CreatePlanRequest: {
+            /** @description Stable unique key, e.g. `managed`. */
+            key: string;
+            /** @description Display name. */
             name: string;
-            /** @description 12-digit AWS account ID. */
-            aws_account_id: string;
-            /** @description AWS region, e.g. `us-east-1`. */
-            region: string;
-            /** @description ARN of a role named `empirical-private-runner-*` in `aws_account_id`. */
-            role_arn: string;
-            /** @description ECS cluster name. */
-            cluster_name: string;
-            /** @description CloudWatch log group of the worker. */
-            log_group_name: string;
-            /** @description `https://sqs.<region>.amazonaws.com/<account>/<name>`; queues are `${queue_prefix}-${machineSize}`. */
-            queue_prefix: string;
-            /** @description Worker container name. Defaults to `test-run-worker`. */
-            container_name?: string;
+            /**
+             * @description Currency the plan is priced in. Defaults to `usd`.
+             * @enum {string}
+             */
+            currency?: "usd" | "inr" | "aed";
+            /** @description Monthly base price in cents of `currency`. */
+            base_price_cents: number;
+            /**
+             * @description Metered allowances, in display order.
+             * @default []
+             */
+            meters: {
+                /**
+                 * @description Meter key from the meter registry. Its unit applies to both `included_qty` and `overage_price_cents`.
+                 * @enum {string}
+                 */
+                meter: "test_suite_size" | "ai_credits" | "test_minutes" | "test_run_duration";
+                /** @description Units included each month. */
+                included_qty?: number | null;
+                /** @description Price per unit above the allowance, in cents; may be fractional. */
+                overage_price_cents?: number | null;
+            }[];
+        };
+        UpdatePlanRequest: {
+            /**
+             * @description `retired` hides the plan from new sales; existing assignments keep it.
+             * @enum {string}
+             */
+            status: "active" | "retired";
+        };
+        BillingMonthSummaryResponse: {
+            /** @description Response payload. */
+            data: {
+                /** @description Usage month, YYYY-MM (UTC). */
+                month: string;
+                period_start: string;
+                /** @description Exclusive (ISO 8601). */
+                period_end: string;
+                is_current_month: boolean;
+                /** @description The shared plan in effect; null for no plan or a custom contract. */
+                plan: {
+                    name: string;
+                    currency: string;
+                    base_price_cents: number;
+                } | null;
+                meters: components["schemas"]["BillingMeterSummary"][];
+                projects: {
+                    project_id: number;
+                    name: string;
+                    slug: string;
+                    ai_credits: number;
+                    test_minutes: number;
+                }[];
+                overage_cents: number;
+                projected_overage_cents: number | null;
+                /** @description Overage of the previous usage month, as a guide when picking a limit. Current month only. */
+                last_month_overage_cents: number | null;
+                usage_limit: components["schemas"]["UsageLimit"];
+            };
+        };
+        BillingMeterSummary: {
+            /** @enum {string} */
+            meter: "ai_credits" | "test_minutes";
+            included_qty: number | null;
+            overage_price_cents: number | null;
+            /** @description Units used so far this month. */
+            used: number;
+            /** @description Projected units at month end (trailing 7-day pace); null when too early to project. */
+            projected: number | null;
+            overage_cents: number;
+            projected_overage_cents: number | null;
+        };
+        UsageLimit: {
+            /** @description Whether the org's plan supports a usage limit (catalog plans with overage pricing). */
+            available: boolean;
+            /** @description Most overage allowed per usage month, in cents of the plan currency. Null means no limit. */
+            cap_cents: number | null;
+            /**
+             * @description `warning` at 80% of the limit (or, for a $0 limit, 80% of any allowance); `reached` when new work is paused.
+             * @enum {string}
+             */
+            status: "none" | "ok" | "warning" | "reached";
+            /** @description When the limit was reached this month (ISO 8601). */
+            reached_at: string | null;
+            updated_at: string | null;
+            /** @description Who made a change. */
+            updated_by: {
+                /** @description user | agent | api_key | system */
+                kind: string;
+                id: string | null;
+                /** @description User name, when a user. */
+                name: string | null;
+            } | null;
+        };
+        UsageLimitResponse: {
+            /** @description Response payload. */
+            data: {
+                /** @description Whether the org's plan supports a usage limit (catalog plans with overage pricing). */
+                available: boolean;
+                /** @description Most overage allowed per usage month, in cents of the plan currency. Null means no limit. */
+                cap_cents: number | null;
+                /**
+                 * @description `warning` at 80% of the limit (or, for a $0 limit, 80% of any allowance); `reached` when new work is paused.
+                 * @enum {string}
+                 */
+                status: "none" | "ok" | "warning" | "reached";
+                /** @description When the limit was reached this month (ISO 8601). */
+                reached_at: string | null;
+                updated_at: string | null;
+                /** @description Who made a change. */
+                updated_by: {
+                    /** @description user | agent | api_key | system */
+                    kind: string;
+                    id: string | null;
+                    /** @description User name, when a user. */
+                    name: string | null;
+                } | null;
+            };
+        };
+        UsageLimitEventsResponse: {
+            /** @description Response payload. */
+            data: components["schemas"]["UsageLimitEvent"][];
+        };
+        UsageLimitEvent: {
+            id: number;
+            /** @description spend_cap.set | spend_cap.removed | spend_cap.alert_sent | spend_cap.reached | spend_cap.cleared */
+            action: string;
+            /** @description Who made a change. */
+            actor: {
+                /** @description user | agent | api_key | system */
+                kind: string;
+                id: string | null;
+                /** @description User name, when a user. */
+                name: string | null;
+            };
+            before?: unknown;
+            after?: unknown;
+            metadata?: unknown;
+            created_at: string;
+        };
+        RunnerBackendListResponse: {
+            /** @description Response payload. */
+            data: {
+                runner_backends: components["schemas"]["RunnerBackend"][];
+            };
+        };
+        RunnerBackend: {
+            /** @description Runner backend ID. */
+            id: number;
+            /** @description Organisation that owns the installation. */
+            org_id: number;
+            /** @description Human-readable name. */
+            name: string;
+            /** @description AWS account the installation runs in. */
+            aws_account_id: string;
+            /** @description AWS region of the installation. */
+            region: string;
+            /** @description Role api-worker assumes to drive the plane. */
+            role_arn: string;
+            /** @description External ID the role's trust policy must require. Give it only to this installation's owner. */
+            external_id: string;
+            /** @description ECS cluster name. */
+            cluster_name: string;
+            /** @description CloudWatch log group of the worker. */
+            log_group_name: string;
+            /** @description Worker container name. */
+            container_name: string;
+            /** @description Job queue URLs are `${queue_prefix}-${machineSize}`. */
+            queue_prefix: string;
+            /**
+             * @description `pending` until verified; only `active` backends receive runs.
+             * @enum {string}
+             */
+            status: "pending" | "active" | "disabled";
+            /** @description ISO-8601 time of the last successful verify. */
+            last_verified_at: string | null;
+            /** @description ISO-8601 time of the last verify, manual or scheduled, whatever its outcome. */
+            last_checked_at: string | null;
+            /** @description Outcome of the last verify; null if never run. */
+            last_check_ok: boolean | null;
+            /** @description Every check from the last verify. */
+            last_check_results: components["schemas"]["RunnerBackendCheck"][] | null;
+            /** @description ISO-8601 start of the current run of failed checks; null while passing. A failing check does not change `status`. */
+            check_failing_since: string | null;
+            /** @description ISO-8601 creation time. */
+            created_at: string;
+            /** @description ISO-8601 last-update time. */
+            updated_at: string;
+        };
+        RunnerBackendCheck: {
+            /** @description `assume_role`, `job_queue`, `scaler_trigger_queue`, `ecs_cluster`, `ecs_tasks` or `worker_logs`. */
+            name: string;
+            /** @description Whether the check passed. */
+            ok: boolean;
+            /** @description The resource checked, or the AWS error. */
+            detail: string;
+        };
+        RunnerBackendResponse: {
+            /** @description Response payload. */
+            data: {
+                runner_backend: components["schemas"]["RunnerBackend"];
+            };
+        };
+        CreateRunnerBackendBody: {
+            /** @description Owning organisation. */
+            org_id: number;
+            /** @description Human-readable name. */
+            name: string;
+            /** @description 12-digit AWS account ID. */
+            aws_account_id: string;
+            /** @description AWS region, e.g. `us-east-1`. */
+            region: string;
+            /** @description ARN of a role named `empirical-private-runner-*` in `aws_account_id`. */
+            role_arn: string;
+            /** @description ECS cluster name. */
+            cluster_name: string;
+            /** @description CloudWatch log group of the worker. */
+            log_group_name: string;
+            /** @description `https://sqs.<region>.amazonaws.com/<account>/<name>`; queues are `${queue_prefix}-${machineSize}`. */
+            queue_prefix: string;
+            /** @description Worker container name. Defaults to `test-run-worker`. */
+            container_name?: string;
             /** @description Only for installations whose role already requires a fixed ID (Empirical's own dogfood). Generated otherwise. */
             external_id?: string;
         };
@@ -6380,6 +6796,73 @@ export interface components {
                 runner_backend: components["schemas"]["RunnerBackend"];
             };
         };
+        CreateSystemMessageResponse: {
+            data: {
+                system_message: components["schemas"]["SystemMessage"];
+                recipients: components["schemas"]["SystemMessageRecipient"][];
+                skipped_project_ids: number[];
+            };
+        };
+        SystemMessage: {
+            id: number;
+            body: string;
+            created_by: string | null;
+            created_at: string;
+        };
+        SystemMessageRecipient: {
+            project_id: number;
+            chat_session_id: number | null;
+            /** @enum {string} */
+            delivery_status: "pending" | "delivered" | "failed";
+            delivery_error: string | null;
+            delivered_at: string | null;
+            /** @enum {string|null} */
+            ack_status: "accepted" | "declined" | null;
+            ack_note: string | null;
+            acked_at: string | null;
+            acked_by_chat_session_id: number | null;
+            session_error: string | null;
+            session_is_closed: boolean | null;
+        };
+        CreateSystemMessageRequest: {
+            body: string;
+            project_ids?: number[];
+        };
+        SystemMessageListResponse: {
+            data: {
+                system_messages: components["schemas"]["SystemMessageSummary"][];
+            };
+        };
+        SystemMessageSummary: {
+            id: number;
+            body: string;
+            created_by: string | null;
+            created_at: string;
+            recipients: number;
+            delivered: number;
+            failed: number;
+            acked: number;
+        };
+        SystemMessageDetailResponse: {
+            data: {
+                system_message: components["schemas"]["SystemMessage"];
+                recipients: components["schemas"]["SystemMessageRecipient"][];
+            };
+        };
+        AckSystemMessageResponse: {
+            data: {
+                system_message_id: number;
+                project_id: number;
+                /** @enum {string} */
+                ack_status: "accepted" | "declined";
+                acked_at: string;
+            };
+        };
+        AckSystemMessageRequest: {
+            /** @enum {string} */
+            status: "accepted" | "declined";
+            note?: string;
+        };
         ApiKeyListResponse: {
             /** @description Response payload. */
             data: {
@@ -7976,8 +8459,8 @@ export interface components {
             effective_from: string;
             /** @description ISO timestamp it was turned off; null while active. */
             effective_to: string | null;
-            /** @description Order-form line this period bills against, when a priced line exists. Null for add-ons that are free today. */
-            order_form_line_id: number | null;
+            /** @description Add-on plan this period bills against, when a priced one exists. Null for add-ons that are free today. */
+            plan_id: number | null;
             created_by: string | null;
             ended_by: string | null;
         };
@@ -7993,8 +8476,8 @@ export interface components {
              * @description Backdate the period to this ISO timestamp. Super admin only; defaults to now.
              */
             effective_from?: string;
-            /** @description Order-form line (kind='addon') this period bills against. Super admin only. */
-            order_form_line_id?: number;
+            /** @description Add-on plan (kind='addon') this period bills against. Super admin only. */
+            plan_id?: number;
         };
         StaticIpsResponse: {
             /** @description Response payload. */
@@ -9053,8 +9536,14 @@ export interface components {
             /** @description Response payload. */
             data: {
                 chat_session: components["schemas"]["ChatSession"];
+                subscription: components["schemas"]["ChatSessionCallerSubscription"];
             };
         };
+        /** @description One-shot subscription that wakes the calling agent session when this session next waits for input; null when none was created. */
+        ChatSessionCallerSubscription: {
+            /** @description Subscription ID. */
+            id: number;
+        } | null;
         ChatSessionDetailResponse: {
             /** @description Response payload. */
             data: {
@@ -9123,6 +9612,7 @@ export interface components {
             /** @description Response payload. */
             data: {
                 chat_session: components["schemas"]["ChatSession"];
+                subscription: components["schemas"]["ChatSessionCallerSubscription"];
             };
         };
         ChatSessionTimelineResponse: {
@@ -11489,8 +11979,6 @@ export interface components {
                         number: number;
                         url: string;
                     } | null;
-                    /** @description Whether the project posts the linked test changes check on GitHub. */
-                    check_enabled: boolean;
                     /** @description Latest GitHub check written for the app PR, from any of its runs. */
                     check: {
                         check_run_url: string | null;
@@ -17747,9 +18235,14 @@ export interface operations {
                                 entity_type: string;
                                 /** @description Exact entity id, or null when this trigger matches every entity. */
                                 entity_id: string | null;
-                                /** @description Optional payload equality filters. Keys must be allowed for the selected event in the canonical event catalog, and enum-like fields only accept the values the event emits. */
+                                /** @description Optional payload filters. Keys must be allowed for the selected event in the canonical event catalog. A primitive value is an equality match, and enum-like fields only accept the values the event emits. Numeric fields also accept a comparison object such as {"gt": 2} or {"gte": 1, "lte": 5}; operators combine with AND and never match null. */
                                 payload_filter: {
-                                    [key: string]: string | number | boolean | unknown;
+                                    [key: string]: string | number | boolean | {
+                                        gt?: number;
+                                        gte?: number;
+                                        lt?: number;
+                                        lte?: number;
+                                    } | unknown;
                                 };
                                 message: string;
                                 /**
@@ -17794,9 +18287,14 @@ export interface operations {
                     event_type: string;
                     /** @description Exact canonical entity id to match. Omit on create, or set null on update, to match every entity. */
                     entity_id?: string;
-                    /** @description Optional payload equality filters. Keys must be allowed for the selected event in the canonical event catalog, and enum-like fields only accept the values the event emits. */
+                    /** @description Optional payload filters. Keys must be allowed for the selected event in the canonical event catalog. A primitive value is an equality match, and enum-like fields only accept the values the event emits. Numeric fields also accept a comparison object such as {"gt": 2} or {"gte": 1, "lte": 5}; operators combine with AND and never match null. */
                     payload_filter?: {
-                        [key: string]: string | number | boolean | unknown;
+                        [key: string]: string | number | boolean | {
+                            gt?: number;
+                            gte?: number;
+                            lt?: number;
+                            lte?: number;
+                        } | unknown;
                     };
                     /** @description Continuation instruction delivered to the session after the event matches. */
                     message: string;
@@ -17825,9 +18323,14 @@ export interface operations {
                             entity_type: string;
                             /** @description Exact entity id, or null when this trigger matches every entity. */
                             entity_id: string | null;
-                            /** @description Optional payload equality filters. Keys must be allowed for the selected event in the canonical event catalog, and enum-like fields only accept the values the event emits. */
+                            /** @description Optional payload filters. Keys must be allowed for the selected event in the canonical event catalog. A primitive value is an equality match, and enum-like fields only accept the values the event emits. Numeric fields also accept a comparison object such as {"gt": 2} or {"gte": 1, "lte": 5}; operators combine with AND and never match null. */
                             payload_filter: {
-                                [key: string]: string | number | boolean | unknown;
+                                [key: string]: string | number | boolean | {
+                                    gt?: number;
+                                    gte?: number;
+                                    lt?: number;
+                                    lte?: number;
+                                } | unknown;
                             };
                             message: string;
                             /**
@@ -17899,9 +18402,14 @@ export interface operations {
                             entity_type: string;
                             /** @description Exact entity id, or null when this trigger matches every entity. */
                             entity_id: string | null;
-                            /** @description Optional payload equality filters. Keys must be allowed for the selected event in the canonical event catalog, and enum-like fields only accept the values the event emits. */
+                            /** @description Optional payload filters. Keys must be allowed for the selected event in the canonical event catalog. A primitive value is an equality match, and enum-like fields only accept the values the event emits. Numeric fields also accept a comparison object such as {"gt": 2} or {"gte": 1, "lte": 5}; operators combine with AND and never match null. */
                             payload_filter: {
-                                [key: string]: string | number | boolean | unknown;
+                                [key: string]: string | number | boolean | {
+                                    gt?: number;
+                                    gte?: number;
+                                    lt?: number;
+                                    lte?: number;
+                                } | unknown;
                             };
                             message: string;
                             /**
@@ -17974,9 +18482,14 @@ export interface operations {
                     event_type?: string;
                     /** @description Exact canonical entity id to match. Omit on create, or set null on update, to match every entity. */
                     entity_id?: string | null;
-                    /** @description Optional payload equality filters. Keys must be allowed for the selected event in the canonical event catalog, and enum-like fields only accept the values the event emits. */
+                    /** @description Optional payload filters. Keys must be allowed for the selected event in the canonical event catalog. A primitive value is an equality match, and enum-like fields only accept the values the event emits. Numeric fields also accept a comparison object such as {"gt": 2} or {"gte": 1, "lte": 5}; operators combine with AND and never match null. */
                     payload_filter?: {
-                        [key: string]: string | number | boolean | unknown;
+                        [key: string]: string | number | boolean | {
+                            gt?: number;
+                            gte?: number;
+                            lt?: number;
+                            lte?: number;
+                        } | unknown;
                     };
                     /** @description Continuation instruction delivered to the session after the event matches. */
                     message?: string;
@@ -18005,9 +18518,14 @@ export interface operations {
                             entity_type: string;
                             /** @description Exact entity id, or null when this trigger matches every entity. */
                             entity_id: string | null;
-                            /** @description Optional payload equality filters. Keys must be allowed for the selected event in the canonical event catalog, and enum-like fields only accept the values the event emits. */
+                            /** @description Optional payload filters. Keys must be allowed for the selected event in the canonical event catalog. A primitive value is an equality match, and enum-like fields only accept the values the event emits. Numeric fields also accept a comparison object such as {"gt": 2} or {"gte": 1, "lte": 5}; operators combine with AND and never match null. */
                             payload_filter: {
-                                [key: string]: string | number | boolean | unknown;
+                                [key: string]: string | number | boolean | {
+                                    gt?: number;
+                                    gte?: number;
+                                    lt?: number;
+                                    lte?: number;
+                                } | unknown;
                             };
                             message: string;
                             /**
@@ -18652,31 +19170,11 @@ export interface operations {
             };
         };
     };
-    listChatSessions: {
+    getBillingMonthSummary: {
         parameters: {
             query?: {
-                /** @description Restrict to a single project (ignored for bound principals). */
-                project_id?: number;
-                /** @description Include closed sessions when `true`. */
-                show_closed?: boolean | null;
-                /** @description Filter sessions by preset (all, active, merged). */
-                preset?: "all" | "active" | "merged";
-                /** @description Page number (1-indexed). Default 1. */
-                page?: number;
-                /** @description Items per page. Default 10. */
-                per_page?: number;
-                /** @description Optional Manager sidebar category: executor sessions, or all non-manager/non-executor user-facing sessions. */
-                category?: "executor" | "user";
-                /** @description Comma-separated project IDs to include. */
-                project_ids?: string;
-                /** @description Comma-separated project IDs to exclude. */
-                exclude_project_ids?: string;
-                /** @description Comma-separated creator user IDs to filter by. */
-                user_ids?: string;
-                /** @description Only sessions updated within this many days. */
-                updated_within_days?: number;
-                /** @description URL-encoded JSON array of generic filter conditions. */
-                filters?: string;
+                /** @description Usage month (YYYY-MM, UTC). Defaults to the current month. */
+                month?: string;
             };
             header?: never;
             path?: never;
@@ -18684,16 +19182,16 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Page of chat sessions. */
+            /** @description The month summary. */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ChatSessionListResponse"];
+                    "application/json": components["schemas"]["BillingMonthSummaryResponse"];
                 };
             };
-            /** @description Invalid request. */
+            /** @description Invalid month, or missing project scope. */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -18702,7 +19200,7 @@ export interface operations {
                     "application/json": components["schemas"]["ErrorResponse"];
                 };
             };
-            /** @description Project not found or not accessible. */
+            /** @description The project has no org. */
             404: {
                 headers: {
                     [name: string]: unknown;
@@ -18713,7 +19211,7 @@ export interface operations {
             };
         };
     };
-    createChatSession: {
+    setUsageLimit: {
         parameters: {
             query?: never;
             header?: never;
@@ -18723,28 +19221,22 @@ export interface operations {
         requestBody?: {
             content: {
                 "application/json": {
-                    message?: string | null;
-                    mode?: string | null;
-                    source?: string | null;
-                    source_identifier?: string | null;
-                    model?: string | null;
-                    /** @description Deprecated. Sessions start on the project default branch; a different branch is added to `message` as an instruction to work from it. */
-                    base_branch?: string | null;
-                    created_by?: string | null;
+                    /** @description Whole dollars, in cents; null removes it. */
+                    cap_cents: number | null;
                 };
             };
         };
         responses: {
-            /** @description The created chat session. */
-            201: {
+            /** @description The updated usage limit. */
+            200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ChatSessionCreateResponse"];
+                    "application/json": components["schemas"]["UsageLimitResponse"];
                 };
             };
-            /** @description Invalid request. */
+            /** @description Invalid body, or the plan doesn't support a limit. */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -18753,30 +19245,49 @@ export interface operations {
                     "application/json": components["schemas"]["ErrorResponse"];
                 };
             };
+            /** @description The project has no org. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
         };
     };
-    getChatSession: {
+    listUsageLimitEvents: {
         parameters: {
-            query?: never;
-            header?: never;
-            path: {
-                /** @description Chat session ID. */
-                id: number;
+            query?: {
+                per_page?: number;
+                /** @description Return events older than this id (pagination cursor). */
+                before_id?: number;
             };
+            header?: never;
+            path?: never;
             cookie?: never;
         };
         requestBody?: never;
         responses: {
-            /** @description The chat session. */
+            /** @description Usage limit events. */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ChatSessionDetailResponse"];
+                    "application/json": components["schemas"]["UsageLimitEventsResponse"];
                 };
             };
-            /** @description Chat session not found. */
+            /** @description Invalid query, or missing project scope. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description The project has no org. */
             404: {
                 headers: {
                     [name: string]: unknown;
@@ -18787,17 +19298,154 @@ export interface operations {
             };
         };
     };
-    patchChatSession: {
+    listChatSessions: {
         parameters: {
-            query?: never;
-            header?: never;
-            path: {
-                /** @description Chat session ID. */
-                id: number;
-            };
-            cookie?: never;
-        };
-        requestBody?: {
+            query?: {
+                /** @description Restrict to a single project (ignored for bound principals). */
+                project_id?: number;
+                /** @description Include closed sessions when `true`. */
+                show_closed?: boolean | null;
+                /** @description Filter sessions by preset (all, active, merged). */
+                preset?: "all" | "active" | "merged";
+                /** @description Page number (1-indexed). Default 1. */
+                page?: number;
+                /** @description Items per page. Default 10. */
+                per_page?: number;
+                /** @description Optional Manager sidebar category: executor sessions, or all non-manager/non-executor user-facing sessions. */
+                category?: "executor" | "user";
+                /** @description Comma-separated project IDs to include. */
+                project_ids?: string;
+                /** @description Comma-separated project IDs to exclude. */
+                exclude_project_ids?: string;
+                /** @description Comma-separated creator user IDs to filter by. */
+                user_ids?: string;
+                /** @description Only sessions updated within this many days. */
+                updated_within_days?: number;
+                /** @description URL-encoded JSON array of generic filter conditions. */
+                filters?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Page of chat sessions. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ChatSessionListResponse"];
+                };
+            };
+            /** @description Invalid request. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Project not found or not accessible. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    createChatSession: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: {
+            content: {
+                "application/json": {
+                    message?: string | null;
+                    mode?: string | null;
+                    source?: string | null;
+                    source_identifier?: string | null;
+                    model?: string | null;
+                    /** @description Deprecated. Sessions start on the project default branch; a different branch is added to `message` as an instruction to work from it. */
+                    base_branch?: string | null;
+                    created_by?: string | null;
+                    /** @description When the caller is an agent session, wake it the next time this session waits for input (one-shot). Defaults to true; pass false for a fire-and-forget message. Ignored for other callers. */
+                    subscribe?: boolean | null;
+                };
+            };
+        };
+        responses: {
+            /** @description The created chat session. */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ChatSessionCreateResponse"];
+                };
+            };
+            /** @description Invalid request. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    getChatSession: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Chat session ID. */
+                id: number;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The chat session. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ChatSessionDetailResponse"];
+                };
+            };
+            /** @description Chat session not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    patchChatSession: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Chat session ID. */
+                id: number;
+            };
+            cookie?: never;
+        };
+        requestBody?: {
             content: {
                 "application/json": {
                     title?: string;
@@ -19294,7 +19942,9 @@ export interface operations {
                                     entity_type: string;
                                     entity_id: string | null;
                                     payload_filter: {
-                                        [key: string]: string | number | boolean | unknown;
+                                        [key: string]: string | number | boolean | {
+                                            [key: string]: number;
+                                        } | unknown;
                                     };
                                     message: string;
                                     /** @enum {string} */
@@ -19390,6 +20040,8 @@ export interface operations {
                     send_action: "steer" | "follow_up" | "stop";
                     created_by?: string | null;
                     rpc_command_id?: string;
+                    /** @description When the caller is an agent session, wake it the next time this session waits for input (one-shot). Defaults to true; pass false for a fire-and-forget message. Ignored for other callers. */
+                    subscribe?: boolean | null;
                 };
             };
         };
@@ -22260,6 +22912,70 @@ export interface operations {
             };
         };
     };
+    previewInvoiceEmail: {
+        parameters: {
+            query?: {
+                /** @description When `true`, preview the test email (sent to the internal test recipient). Defaults to `false`. */
+                is_test_email?: "true" | "false";
+            };
+            header?: never;
+            path: {
+                /** @description Invoice ID. */
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The rendered email. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Response payload. */
+                        data: {
+                            /** @description Sender address. */
+                            from: string;
+                            /** @description To recipients. */
+                            to: string[];
+                            /** @description CC recipients. */
+                            cc: string[];
+                            /** @description BCC recipients. */
+                            bcc: string[];
+                            /** @description Reply-To addresses. */
+                            reply_to: string[];
+                            /** @description Email subject. */
+                            subject: string;
+                            /** @description Rendered email body HTML. */
+                            html: string;
+                            /** @description Attached PDF filename, or null when the invoice has no PDF. */
+                            attachment_filename: string | null;
+                        };
+                    };
+                };
+            };
+            /** @description Invalid invoice ID or organisation not found. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Invoice not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
     generateInvoicePdf: {
         parameters: {
             query?: never;
@@ -24454,8 +25170,8 @@ export interface operations {
                 per_page?: number;
                 /** @description Filter to assignments for this organisation. */
                 org_id?: number | null;
-                /** @description Filter to assignments for this order-form line. */
-                order_form_line_id?: number | null;
+                /** @description Filter to assignments for this plan. */
+                plan_id?: number | null;
             };
             header?: never;
             path?: never;
@@ -24505,7 +25221,7 @@ export interface operations {
                     "application/json": components["schemas"]["PlanAssignmentResponse"];
                 };
             };
-            /** @description Validation failed or the organisation does not exist. */
+            /** @description Validation failed, or the organisation or plan does not exist. */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -24602,6 +25318,189 @@ export interface operations {
             };
         };
     };
+    getOrgPlan: {
+        parameters: {
+            query?: {
+                /** @description Usage month (YYYY-MM, UTC). Returns the plan in effect at the end of that month, or now for the current month. Defaults to now. */
+                month?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The org's plan status. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["OrgPlanResponse"];
+                };
+            };
+            /** @description Invalid month, or missing project scope. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    listPlans: {
+        parameters: {
+            query?: {
+                /** @description List this organisation's custom plans instead of the shared plans. */
+                org_id?: number | null;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The plans. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PlanListResponse"];
+                };
+            };
+        };
+    };
+    createPlan: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: {
+            content: {
+                "application/json": components["schemas"]["CreatePlanRequest"];
+            };
+        };
+        responses: {
+            /** @description The created plan. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PlanResponse"];
+                };
+            };
+            /** @description Validation failed. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description A plan with this key already exists. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    getPlanById: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Plan ID. */
+                id: number;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The plan. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PlanResponse"];
+                };
+            };
+            /** @description Invalid plan id. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Plan not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    updatePlan: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Plan ID. */
+                id: number;
+            };
+            cookie?: never;
+        };
+        requestBody?: {
+            content: {
+                "application/json": components["schemas"]["UpdatePlanRequest"];
+            };
+        };
+        responses: {
+            /** @description The updated plan. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PlanResponse"];
+                };
+            };
+            /** @description Validation failed. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Plan not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
     listProjectAddons: {
         parameters: {
             query?: never;
@@ -24724,7 +25623,7 @@ export interface operations {
                     "application/json": components["schemas"]["ErrorResponse"];
                 };
             };
-            /** @description effective_from / order_form_line_id require super admin. */
+            /** @description effective_from / plan_id require super admin. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -26990,6 +27889,145 @@ export interface operations {
             };
         };
     };
+    listSystemMessages: {
+        parameters: {
+            query?: {
+                limit?: number;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Recent system messages, newest first. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SystemMessageListResponse"];
+                };
+            };
+        };
+    };
+    createSystemMessage: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: {
+            content: {
+                "application/json": components["schemas"]["CreateSystemMessageRequest"];
+            };
+        };
+        responses: {
+            /** @description The message and its per-project delivery. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CreateSystemMessageResponse"];
+                };
+            };
+            /** @description A listed project does not exist. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Broadcast requested but no project has an open manager session. */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    getSystemMessage: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: number;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The message and its per-project status. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SystemMessageDetailResponse"];
+                };
+            };
+            /** @description System message not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    ackSystemMessage: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: number;
+            };
+            cookie?: never;
+        };
+        requestBody?: {
+            content: {
+                "application/json": components["schemas"]["AckSystemMessageRequest"];
+            };
+        };
+        responses: {
+            /** @description The recorded acknowledgement. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AckSystemMessageResponse"];
+                };
+            };
+            /** @description Caller is not a manager chat session. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description System message was not sent to this project. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
     ingestTestCaseRunEndEvent: {
         parameters: {
             query?: never;