@runlot/api 0.1.0-rc.46 → 0.1.0-rc.48

package/dist/schema.d.ts

@@ -610,7 +610,7 @@ export interface paths {
         put?: never;
         /**
          * Creates a diagnostic image (`runlot pg export`)
-         * @description **Is not a backup** (docs/env-db-assembly.md §5). What it creates is an **immutable
+         * @description **This is not a backup** (docs/env-db-assembly.md §5). What it creates is an **immutable
          *     diagnostic key** under the current `(project, epoch)`, and it moves none of the latest,
          *     freshness, or retention pointers, nor does it affect the name of the next automatic
          *     backup.
@@ -622,14 +622,14 @@ export interface paths {
          *     this endpoint creates stays **outside** that namespace — restore cannot select it,
          *     pruning does not count it, and it cannot move latest.
          *
-         *     **Is not idempotent.** Each call creates one more image, because the server builds a new
+         *     **This is not idempotent.** Each call creates one more image, because the server builds a new
          *     stamp for every request. The only thing absorbed idempotently is a **retry of the same
          *     stamp** once it has reached the node.
          *
          *     Requires member or higher only. The image is the entire database, so it is not something
          *     a viewer should fetch in a single call.
          *
-         *     Is slow. The response arrives only after the dump finishes — in proportion to size — and
+         *     It is slow. The response arrives only after the dump finishes — in proportion to size — and
          *     the project's actor is held for that duration.
          */
         post: operations["exportDatabase"];
@@ -804,8 +804,7 @@ export interface paths {
         /**
          * Aborts an in-progress operation (`runlot pg abort`)
          * @description Only possible **before** an unrecoverable phase (docs/phase5.md B4): evict,
-         *     restore_generation, and delete are abortable up to committing; restore is not. Aborting
-         *     returns the batch to active and leaves `terminalCode=aborted`.
+         *     restore_generation, and delete are abortable up to committing; restore is not. Aborting returns the placement to active and leaves `terminalCode=aborted`.
          *
          *     admin and above. The server **reads first, then aborts** — reversing the order would
          *     abort another project's operation for real before returning 404.
@@ -978,7 +977,7 @@ export interface paths {
          */
         post: operations["grantStorage"];
         /**
-         * Unprovision storage usage (`runlot storage delete`)
+         * Remove project storage (`runlot storage delete`)
          * @description **Objects are not deleted.** Deleting everything under the prefix must be a CP operation
          *     idempotent by `op_id` (docs/storage.md §7, the same lane as database deletion), and that
          *     lane does not exist yet — this fact is recorded in the audit log.
@@ -1002,21 +1001,21 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * AI 모델 카탈로그 (`runlot ai models`)
-         * @description `env.ai` 가 부를 수 있는 모델의 전부다 (docs/ai.md §2.3). **로그인만 하면
-         *     볼 수 있다** — 무엇을 살 수 있는지는 org 의 비밀이 아니고, 이 목록이 곧
-         *     가격표다.
+         * AI model catalog (`runlot ai models`)
+         * @description Every model `env.ai` can call (docs/ai.md §2.3). **Any signed-in user can read it** — what you can
+         *     buy is not an org secret, and this list is the price list.
          *
-         *     차선이 둘이다. `frontier` 는 프로바이더 **정가 그대로** 통과시킨다
-         *     (`listPrice: true`, 마진 0) — 그래서 모델 id 에 프로바이더 이름이 그대로
-         *     있고 `provider` 도 실린다. `value` 는 우리가 도매로 사서 우리 값으로 파는
-         *     가성비 모델이라 `provider` 를 **안 싣는다**: 그 값은 우리가 언제든 갈아끼운다.
+         *     There are two lanes. `frontier` passes the provider's **list price** straight through
+         *     (`listPrice: true`, zero margin) — that is why the provider's name stays in the model id and
+         *     `provider` is included. `value` models are the ones we buy wholesale and sell at our own price, so
+         *     `provider` is **not included**: that is a value we swap whenever we want.
          *
-         *     단가는 100 만 토큰당 **마이크로센트** 정수다 (1 µ¢ = 1e-8 USD). 소수
-         *     자리를 서버가 정하지 않는 것이 요점이다 — 작은 호출이 센트로 반올림하면
-         *     0 이 되고 (docs/ai.md §3.1), 그 사실이 포맷 문자열 하나에 묶이면 안 된다.
+         *     Prices are integer **microcents** per million tokens (1 µ¢ = 1e-8 USD). The point is that the
+         *     server does not fix the number of decimal places — a small call rounds to 0 in cents
+         *     (docs/ai.md §3.1), and that fact must not be tied to a single format string.
          *
-         *     목록에 없는 모델 id 는 호출에서 400 이다. **임의 모델 패스스루는 없다.**
+         *     A model id that is not on this list returns 400 at call time. **There is no arbitrary model
+         *     passthrough.**
          */
         get: operations["listAIModels"];
         put?: never;
@@ -1038,45 +1037,44 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * AI 상태 (`runlot ai usage`)
-         * @description 부여 여부·상한 넷·org 잔액·최근 24 시간 사용량 (docs/ai.md §6). 부여가
-         *     없어도 상한은 채워 온다 — "켜면 이런 상한이 됩니다" 의 재료이고,
-         *     `granted` 가 진짜 상태다.
+         * AI status (`runlot ai usage`)
+         * @description Whether AI is turned on, the four limits, the org's balance, and the last 24 hours of usage
+         *     (docs/ai.md §6). The limits come populated even when AI is off — they are the material for "here is
+         *     what the limits would be if you turned this on", and `granted` is the real state.
          *
-         *     `maxOutputTokens`·`maxInputTokens` 의 `0` 은 **"모델이 정한다"** 다.
+         *     `0` in `maxOutputTokens` and `maxInputTokens` means **the model decides**.
          *
-         *     `spentMicroCents24h` 는 `usage_hourly` 에서 못 만드는 수라 원장에서 따로
-         *     읽는다 — 단가가 시점의 함수이기 때문이고, 그것이 0046 이 표를 둘로 가른
-         *     이유다.
+         *     `spentMicroCents24h` cannot be built from `usage_hourly`, so it is read from the ledger instead —
+         *     prices are a function of the moment, which is why 0046 split the two tables.
          *
-         *     viewer 이상.
+         *     viewer or above.
          */
         get: operations["getAI"];
         put?: never;
         /**
-         * AI 를 켠다 (배포가 `"ai": true` 를 읽고 부른다)
-         * @description **멱등이다.** 요청 본문이 없다 — 상한도 모델 목록도 사용자가 정하는 값이
-         *     아니다.
+         * Turns on AI (a deployment calls this after reading `"ai": true`)
+         * @description **This is idempotent.** There is no request body — neither the limits nor the model list is a
+         *     value the user sets.
          *
-         *     켜지면 노드가 다음 수렴에서 `env.ai` 를 연결한다. **번들도 `"ai": true`
-         *     여야 실린다** — 부여는 CP 의 것이고 어떤 시스템 워커를 띄울지는 번들의
-         *     것이다.
+         *     Once it is on, the node connects `env.ai` on the next convergence. **The bundle must also say
+         *     `\"ai\": true`** — turning it on is the CP's side, and which system workers start is the bundle's
+         *     side.
          *
-         *     노드 자격 검사가 **없다**: 상류(Bedrock·Vertex)는 노드 site.env 의 값이라
-         *     그 사실이 CP 에 등록돼 있지 않다. 자격 없는 노드에서는 부여가 통과하고
-         *     호출이 503 이다 (docs/ai.md §9 의 열린 것).
+         *     There is **no node credential check**: the upstream credentials (Bedrock, Vertex) live in the
+         *     node's site.env, so the CP has no record of them. On a node without them, turning it on still
+         *     succeeds and the call returns 503 (an open item in docs/ai.md §9).
          *
-         *     member 이상. 감사 `ai.grant`.
+         *     member and above. Audited as `ai.grant`.
          */
         post: operations["grantAI"];
         /**
-         * AI 를 끈다 (`runlot ai delete`)
-         * @description 다음 배포부터 `env.ai` 가 없다. 멱등이다.
+         * Turns off AI (`runlot ai delete`)
+         * @description From the next deployment on, there is no `env.ai`. This is idempotent.
          *
-         *     **원장은 안 지운다** — 이미 지불한 돈의 기록이다. 크레딧 잔액도 그대로다:
-         *     잔액은 org 의 것이고 이 부여는 프로젝트의 것이다.
+         *     **The ledger is not deleted** — it is the record of money already paid. The credit balance stays
+         *     as well: the balance belongs to the org, and what you are turning off belongs to the project.
          *
-         *     admin. 감사 `ai.revoke`.
+         *     admin. Audited as `ai.revoke`.
          */
         delete: operations["revokeAI"];
         options?: never;
@@ -1094,17 +1092,18 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * AI 크레딧 잔액과 자동 충전 설정 (`runlot ai credit`)
-         * @description 잔액은 **마이크로센트**이고 음수일 수 있다 (docs/ai.md §3.3 — 잔액 검사는
-         *     호출 전이고 차감은 뒤라 시작한 호출 하나가 잔액을 넘길 수 있다).
+         * AI credit balance and auto top-up settings (`runlot ai credit`)
+         * @description The balance is in **microcents** and can go negative (docs/ai.md §3.3 — the balance check runs
+         *     before a call and the deduction after it, so a single call that has already started can take the
+         *     balance past zero).
          *
-         *     `hasPaymentMethod` 가 거짓이면 자동 충전을 켤 수 없다 — 저장된 카드가
-         *     없기 때문이고, **첫 충전은 반드시 수동이다** (그것이 카드를 저장한다).
+         *     If `hasPaymentMethod` is false, auto top-up cannot be turned on — there is no saved card, and
+         *     **the first top-up is always manual** (that is what saves the card).
          *
-         *     `autoTopupsToday` 와 `autoTopupPerDay` 를 같이 준다. 그 상한이 곧 하루
-         *     지출 천장이라 화면이 둘을 같이 보여야 "왜 안 충전됐지" 에 답이 된다.
+         *     `autoTopupsToday` and `autoTopupPerDay` come together. That cap is the ceiling on a day's spend,
+         *     so a screen has to show both to answer "why didn't it top up".
          *
-         *     member 이상.
+         *     member or above.
          */
         get: operations["getAICredit"];
         put?: never;
@@ -1125,12 +1124,12 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * AI 원장
-         * @description 금액의 정본이다 (0046). `kind` 는 `call`(음수)·`topup`(양수)·`adjust`.
-         *     커서는 `ledger_id` — 시각으로 자르면 같은 밀리초의 행 둘이 페이지 경계에서
-         *     갈린다.
+         * AI ledger
+         * @description This is the source of truth for amounts (0046). `kind` is `call` (negative), `topup` (positive),
+         *     or `adjust`. The cursor is `ledger_id` — cutting by time would split two rows in the same
+         *     millisecond across a page boundary.
          *
-         *     member 이상.
+         *     member or above.
          */
         get: operations["listAILedger"];
         put?: never;
@@ -1153,18 +1152,16 @@ export interface paths {
         get?: never;
         put?: never;
         /**
-         * 크레딧 충전 체크아웃
-         * @description 임베드 체크아웃 URL 을 준다 (docs/billing.md §3.1 과 같은 모양 — 대시보드가
-         *     iframe 으로 띄운다).
-         *
-         *     **돌아온 브라우저는 증거가 아니다.** 잔액을 올리는 것은 `order.paid` 웹훅
-         *     하나이고, 화면은 성공 사건 뒤에 잔액을 폴링한다.
+         * Credit top-up checkout
+         * @description Returns an embedded checkout URL (the same shape as docs/billing.md §3.1 — the dashboard opens it
+         *     in an iframe).
          *
-         *     `microCents` 는 열거된 티어 중 하나여야 한다 — 자동 충전이 같은 목록을
-         *     쓰므로 (사람 없는 자리에서 도는 청구라 금액이 열거된 값이어야 한다) 수동만
-         *     자유롭게 두면 표가 둘이 된다.
+         *     **A browser coming back is not proof.** The one thing that raises the balance is the `order.paid`
+         *     webhook, and the screen polls the balance after the success event.
          *
-         *     admin.
+         *     `microCents` must be one of the listed tiers — auto top-up uses the same list (it charges with
+         *     nobody watching, so the amount has to be one of the enumerated values), and leaving manual top-up
+         *     free-form would create two tables.
          */
         post: operations["createAICreditCheckout"];
         delete?: never;
@@ -1184,19 +1181,19 @@ export interface paths {
         };
         get?: never;
         /**
-         * 자동 충전을 켜거나 끈다
-         * @description **켜는 것은 명시 동의다** (docs/ai.md §3.5). 화면이 "잔액이 X 아래로
-         *     내려가면 저장된 카드에 Y 를 자동으로 청구합니다. 하루 최대 N 회" 를 그대로
-         *     보여 주고 체크를 받는다 — off-session 청구는 카드사 규정이 사전 동의를
-         *     요구하고, 그 문장이 곧 동의의 내용이다.
+         * Turns auto top-up on or off
+         * @description **Turning it on is explicit consent** (docs/ai.md §3.5). The screen shows "when the balance falls
+         *     below X, we charge Y to the saved card, at most N times a day" verbatim and takes a checkbox — card
+         *     network rules require prior consent for off-session charges, and that sentence is the content of
+         *     the consent.
          *
-         *     서버가 보는 것 셋: 저장된 결제 수단이 있는가 (없으면 409), 금액이 티어
-         *     목록에 있는가, 그리고 기준이 **0 보다 크고 충전 금액보다 작은가**. 기준이
-         *     0 이면 충전이 비동기인 그 창 전부가 402 이고, 기준이 충전액 이상이면 한 번
-         *     충전해도 여전히 기준 아래라 하루 상한까지 계속 충전한다 — 설정이 아니라
-         *     함정이다.
+         *     The server checks three things: whether a payment method is saved (409 if not), whether the amount
+         *     is on the tier list, and whether the threshold is **greater than 0 and smaller than the top-up
+         *     amount**. A threshold of 0 makes the whole asynchronous top-up window return 402, and a threshold
+         *     at or above the top-up amount leaves the balance still below the threshold after a top-up, so it
+         *     keeps topping up to the daily cap — that is a trap, not a setting.
          *
-         *     admin. 감사 `ai.autotopup.on` / `ai.autotopup.off`.
+         *     admin. Audited as `ai.autotopup.on` / `ai.autotopup.off`.
          */
         put: operations["setAIAutoTopup"];
         post?: never;
@@ -1228,7 +1225,7 @@ export interface paths {
         put?: never;
         /**
          * Turns on email (a deployment calls this after reading `"email": true`)
-         * @description **Is idempotent.** There is no request body — we determine the address
+         * @description **This is idempotent.** There is no request body — we determine the address
          *     (`<project>.<org>.<mail-domain>`), and the plan determines the limit. The address is
          *     fixed to the name at the time of grant.
          *
@@ -1402,16 +1399,15 @@ export interface paths {
         head?: never;
         /**
          * Change settings (`runlot auth set`)
-         * @description **Is a partial update.** Only the fields you send change, and the rest stay as they are.
+         * @description **This is a partial update.** Only the fields you send change, and the rest stay as they are.
          *     If the UI sends all three brand settings every time a single switch changes, a later
          *     save can overwrite an earlier one when two users edit the same settings.
          *
-         *     Returns 404 `not_granted` if the usage setting does not exist. You cannot save settings
-         *     alone ahead of time, because the setting values are stored together with the usage
-         *     setting record.
+         *     Returns 404 `not_granted` if auth has not been turned on for this project. You cannot save settings
+         *     alone ahead of time, because the setting values are stored in the record created when auth was turned on.
          *
          *     `sessionDays` is a setting that also determines the size of the session table
-         *     (docs/auth.md §13 — it stays within the 150 MB cap).
+         *     (docs/auth.md §13 — it stays well within the database size cap).
          *
          *     Requires member or higher. Audited as `auth.settings`.
          */
@@ -2353,7 +2349,7 @@ export interface paths {
         get?: never;
         put?: never;
         /**
-         * Renews it (`runlot domains renew`)
+         * Renews a domain (`runlot domains renew`)
          * @description Requires admin or higher. Audited as `domain.renew`.
          */
         post: operations["renewDomain"];
@@ -2457,7 +2453,7 @@ export interface paths {
         get?: never;
         put?: never;
         /**
-         * The registrar reads this again right now
+         * Re-reads this domain from the registrar now (`runlot domains sync`)
          * @description Requires member or higher. The registrar is the source of truth for
          *     expiry date, lock, and NS. If the registrar responds that it is not in
          *     our account, that is `transferred_out` — the only signal that a transfer
@@ -3003,7 +2999,7 @@ export interface components {
         };
         /**
          * @description Becomes a single label of the hostname, so it follows DNS rules. Since
-         *     the project name goes directly into `<name>.lvh.me`, not enforcing this
+         *     the project name goes directly into `<name>.<org>.<app-domain>`, not enforcing this
          *     here would let you create a project that exists but is unreachable.
          */
         Slug: string;
@@ -3059,6 +3055,14 @@ export interface components {
              *     (the 409 `project_limit` from `createProject`).
              */
             projectLimit: number;
+            /**
+             * Format: int64
+             * @description The project database size cap for this plan (Free 500 MiB, Pro 8 GiB). The
+             *     same derived-value reasoning as `projectLimit`: the dashboard's usage meter and
+             *     the CLI's limit line read it from here instead of carrying their own table.
+             *     Nothing rejects a write at the cap; see `/docs/data/database/size-cap`.
+             */
+            dbCapBytes: number;
         };
         Notification: {
             /** Format: int64 */
@@ -3271,7 +3275,7 @@ export interface components {
             user: string;
             password: string;
             /**
-             * @description **The disabled value never responds.** front cuts off the SSLRequest at the
+             * @description **Connections with sslmode=disable are rejected.** front cuts off the SSLRequest at the
              *     rejection stage, so `disable` never connects in the first place.
              * @enum {string}
              */
@@ -3363,16 +3367,55 @@ export interface components {
              */
             seq: number;
             /**
-             * @description Offsite key (`gen/<project>/<epoch>/<stamp>-<seq>.feather`)
-             * @example gen/2f1c…/7/20260902T031500Z-0003.feather
+             * @description Offsite key (`gen/<project>/<epoch>/<stamp>-<seq>.log`)
+             * @example gen/2f1c…/7/20260902T031500Z-0003.log
              */
             key: string;
             /**
              * Format: int64
-             * @description The size of the **object stored offsite**. An encrypted generation is larger than
-             *     the plaintext, and the admission reservation is also calculated based on this value.
+             * @description The size of the **object stored offsite**. An encrypted backup is larger than
+             *     the plaintext. For a commit log this is the size of the logged page versions only —
+             *     see `imageBytes` for the size of the database a restore produces.
              */
             bytes: number;
+            /**
+             * @description `true` when this object alone restores the database; `false` for a commit log, which
+             *     is replayed on top of the chain that ends at `prevTxnId`. Restoring a log pours its
+             *     whole chain (full first); the chain is resolved by the server and never crosses an epoch.
+             */
+            full: boolean;
+            /**
+             * Format: int64
+             * @description For a commit log, the last commit of the backup it links to. 0 for a full.
+             */
+            prevTxnId?: number;
+            /**
+             * Format: int64
+             * @description The size of the database a restore of this generation produces.
+             */
+            imageBytes: number;
+            /**
+             * Format: int64
+             * @description The first commit this backup carries. A backup is an ordered log of the commits since
+             *     the previous one, so every commit in `[firstTxnId, txnId]` is a restore point
+             *     (`RestoreRequest.txnId`). Equal to `txnId` for a full and for a backup with no commits.
+             */
+            firstTxnId: number;
+            /**
+             * Format: int64
+             * @description How many commits this backup carries. 1 for a full, 0 for a backup taken with no writes since the previous one.
+             */
+            commitCount: number;
+            /**
+             * Format: date-time
+             * @description Wall-clock time of the first commit carried. Absent when `commitCount` is 0.
+             */
+            firstAt?: string;
+            /**
+             * Format: date-time
+             * @description Wall-clock time of the last commit carried. Absent when `commitCount` is 0.
+             */
+            lastAt?: string;
             sha256: string;
             /**
              * Format: int64
@@ -3385,12 +3428,12 @@ export interface components {
              * Format: int64
              * @description Commit number that the image contains. 0 means unknown.
              */
-            txnId?: number;
+            txnId: number;
             /**
-             * @description Why the generation was created. Not used for decisions
+             * @description Why the generation was created. Not used for decisions. `park`, `evict` and `deploy` are the shipment taken right before the process stops.
              * @enum {string}
              */
-            kind?: "scheduled" | "manual" | "pre-restore" | "pre-delete";
+            kind?: "scheduled" | "park" | "evict" | "deploy" | "manual" | "pre-restore" | "pre-delete";
             /** Format: date-time */
             createdAt: string;
             /** @description The node that captured the generation */
@@ -3407,11 +3450,28 @@ export interface components {
              */
             final: boolean;
         };
+        /**
+         * @description A restore point, given in **exactly one** of three ways. `(epoch, seq)` restores to the
+         *     end of that backup. `txnId` restores to that commit, which may be inside a backup — every
+         *     backup carries the commits between it and the previous one in order, so any of them is a
+         *     restore point (`GenerationRow.firstTxnId` … `txnId`). `at` restores to the last commit at
+         *     or before that time (RFC 3339); the resolution is one backup interval.
+         */
         RestoreRequest: {
             /** Format: int64 */
-            epoch: number;
+            epoch?: number;
             /** Format: int64 */
-            seq: number;
+            seq?: number;
+            /**
+             * Format: int64
+             * @description A commit to restore to. Must lie inside some backup's `[firstTxnId, txnId]`.
+             */
+            txnId?: number;
+            /**
+             * Format: date-time
+             * @description Restore to the last commit at or before this time.
+             */
+            at?: string;
         };
         DeleteRequest: {
             /**
@@ -3771,65 +3831,65 @@ export interface components {
              */
             mailIn: number;
         };
-        /** @description 카탈로그 한 줄 (docs/ai.md §2.3). */
+        /** @description One row of the catalog (docs/ai.md §2.3). */
         AIModel: {
-            /** @description `env.ai.run()` 에 적는 문자열. 프론티어는 `<provider>/<model>`, 가성비 모델은 `@runlot/<model>` */
+            /** @description The string you write in `env.ai.run()`. Frontier models are `<provider>/<model>`, value models are `@runlot/<model>` */
             id: string;
             /** @enum {string} */
             lane: "frontier" | "value";
             display: string;
-            /** @description 모델을 만든 곳 (Anthropic·Google·Meta…) */
+            /** @description who built the model (Anthropic, Google, Meta, and so on) */
             vendor: string;
             /**
-             * @description 우리가 부르는 곳. **프론티어에서만 실린다** — 가성비 모델은 우리가
-             *     갈아끼우는 값이라 계약이 아니다.
+             * @description The provider we call. **Included for frontier models only** — for value models this is something we
+             *     swap, so it is not part of the contract.
              */
             provider?: string;
-            /** @description 모델 자체의 컨텍스트 */
+            /** @description the model's own context window */
             contextTokens: number;
             /**
-             * @description runlot 이 이 모델에 허용하는 입력 상한. 대부분 contextTokens 와 같고,
-             *     GPT-5.6 Terra 는 272,000 — 그 뒤는 요청 전체가 장문 단가로 바뀌므로
-             *     표준 단가 하나만 광고하는 카탈로그가 그 앞에서 자른다.
+             * @description The input limit runlot allows for this model. It is the same as contextTokens for most models;
+             *     GPT-5.6 Terra is 272,000 — past that point the whole request switches to long-context pricing, so a
+             *     catalog that advertises a single standard price cuts it off there.
              */
             maxInputTokens: number;
             maxOutputTokens: number;
             /**
              * Format: int64
-             * @description 100 만 입력 토큰당 마이크로센트
+             * @description microcents per million input tokens
              */
             inPerMTok: number;
             /** Format: int64 */
             outPerMTok: number;
             /**
              * Format: int64
-             * @description 캐시된 입력의 단가. 없으면 캐시 할인이 없는 모델이고 캐시된 토큰도 정가다
+             * @description The price of cached input. Absent means the model has no cache discount and cached tokens are billed at the full input price
              */
             cachedInPerMTok?: number;
             /**
-             * @description 참이면 프로바이더 **정가 그대로**다 (마진 0). 화면이 그 사실을 말하는
-             *     것이 이 제품의 문장 하나이고, 말하지 않으면 사용자는 마크업을 가정한다.
+             * @description When true, this is the provider's **list price** passed straight through (zero margin). Saying so
+             *     on screen is one of this product's promises — if it goes unsaid, users assume a markup.
              */
             listPrice: boolean;
         };
         AIStatus: {
             granted: boolean;
-            /** @description 프로젝트마다 분당 호출 상한 */
+            /** @description calls per minute, per project */
             perMinute: number;
-            /** @description 프로젝트마다 동시 호출 상한 */
+            /** @description concurrent calls, per project */
             concurrent: number;
-            /** @description 0 이면 모델이 정한다 */
+            /** @description 0 means the model decides */
             maxOutputTokens?: number;
-            /** @description 0 이면 모델이 정한다 */
+            /** @description 0 means the model decides */
             maxInputTokens?: number;
             /**
              * Format: int64
-             * @description org 잔액 (음수 가능)
+             * @description the org balance (can be negative)
              */
             creditMicroCents: number;
             /**
              * Format: int64
-             * @description 가성비 모델에만 주는 하루치
+             * @description the daily allowance, for value models only
              */
             freeDailyMicroCents?: number;
             /** Format: int64 */
@@ -3840,7 +3900,7 @@ export interface components {
             tokensOut24h?: number;
             /**
              * Format: int64
-             * @description 최근 24 시간 원장의 합 (양수 = 쓴 금액). usage_hourly 에서는 못 만드는 수다
+             * @description The sum of the last 24 hours of the ledger (positive = amount spent). This number cannot be built from usage_hourly
              */
             spentMicroCents24h?: number;
         };
@@ -3851,25 +3911,25 @@ export interface components {
             microCents: number;
         };
         AICredit: {
-            /** @description 거짓이면 이 배치에 크레딧 상품이 없다 — 충전 끝점은 501 */
+            /** @description false means this installation has no credit product — the top-up endpoints return 501 */
             enabled: boolean;
             sandbox: boolean;
             /**
              * Format: int64
-             * @description 잔액 (음수 가능)
+             * @description the balance (can be negative)
              */
             microCents: number;
             /** Format: int64 */
             lowMicroCents?: number;
             /** Format: int64 */
             freeDailyMicroCents?: number;
-            /** @description 충전 단위. 자동 충전이 **같은 목록**을 쓴다 */
+            /** @description A top-up tier. Auto top-up uses the **same list** */
             tiers: number[];
-            /** @description 거짓이면 자동 충전을 못 켠다 — 첫 충전이 카드를 저장한다 */
+            /** @description When false, auto top-up cannot be turned on — the first top-up is what saves the card */
             hasPaymentMethod: boolean;
             autoTopup?: components["schemas"]["AIAutoTopup"];
             autoTopupsToday: number;
-            /** @description 이 수가 곧 하루 지출 천장이다 */
+            /** @description this number is the daily spending ceiling */
             autoTopupPerDay: number;
         };
         AILedgerRow: {
@@ -3883,7 +3943,7 @@ export interface components {
             tokensOut?: number;
             /**
              * Format: int64
-             * @description `call` 은 음수
+             * @description `call` rows are negative
              */
             microCents: number;
             /** Format: date-time */
@@ -3925,7 +3985,7 @@ export interface components {
              * @description number received in the last 24 hours
              */
             received24h: number;
-            /** @description The mail domain suffix for this batch. Email cannot be enabled if it is empty. */
+            /** @description The mail domain suffix for this installation. Email cannot be enabled if it is empty. */
             mailDomain: string;
         };
         /** @description One line of the email log (docs/email.md §6.1). */
@@ -3990,6 +4050,13 @@ export interface components {
             projects: number;
             /** Format: int64 */
             storageBytes: number;
+            /**
+             * Format: int64
+             * @description The project Postgres size cap for this plan (Free 500 MiB, Pro 8 GiB). The
+             *     dashboard's usage meter and chart read this value; nothing enforces it — the 90 %
+             *     notification is the only consumer on the server.
+             */
+            dbCapBytes: number;
             /** @description number of retained generations (= time) */
             backupKeep: number;
             crons: number;
@@ -4003,7 +4070,7 @@ export interface components {
          */
         StorageStatus: {
             /**
-             * @description Indicates whether storage usage is provisioned. Since the existence of the usage
+             * @description Indicates whether storage has been turned on for this project. Since the existence of that
              *     record is the only representation of this (migration 0022), there is no state of
              *     "provisioned but turned off".
              */
@@ -4107,7 +4174,7 @@ export interface components {
             requireVerifiedEmail: boolean;
             /**
              * @description The lifetime of the session cookie, in days. It also affects the size of the session
-             *     table. Since the project database is within the 150 MB cap (docs/auth.md §13),
+             *     table. Since the project database has a size cap (docs/auth.md §13),
              *     10,000 active users each using three devices would produce 6 MB of session data.
              */
             sessionDays: number;
@@ -4162,7 +4229,7 @@ export interface components {
         AuthStatus: {
             /**
              * @description Indicates whether auth is configured for use. Since the existence of a
-             *     usage-configuration record is the only representation, there is no "configured but
+             *     record created when auth was turned on is the only representation, there is no "configured but
              *     disabled" state. When disabled, `settings` holds default values and `providers` is
              *     an empty array.
              */
@@ -4181,11 +4248,8 @@ export interface components {
              *     login fails
              *     on that host alone, and the reason is visible only in the provider's console.
              *
-             *     There are two default hostnames — `<project>.<org>.<domain>` and the older
-             *     single-label
-             *     name `<project>--<org>.<domain>`. A deploy registers both, so links already in the
-             *     wild keep
-             *     working, which is why both callback URLs are needed.
+             *     The default hostname is `<project>.<org>.<domain>`. Register a callback URL for every host in
+             *     this list — the list is exactly the set of hosts this project answers on.
              * @example [
              *       "app.acme.runlot.app",
              *       "app--acme.runlot.app",
@@ -4243,7 +4307,7 @@ export interface components {
              */
             hostname: string;
             /**
-             * @description `default` is the default name — this includes both `<project>.<org>.<app-domain>` and the legacy alias `<project>--<org>.<app-domain>`, which merges it into a single label. `custom` is a customer domain
+             * @description `default` is the default name `<project>.<org>.<app-domain>`. `custom` is a customer domain
              * @enum {string}
              */
             kind: "default" | "custom";
@@ -5488,7 +5552,7 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description Not in a state that can be restored (for example, no batch node available) */
+            /** @description Not in a state that can be restored (for example, no node available for placement) */
             503: {
                 headers: {
                     [name: string]: unknown;
@@ -5923,7 +5987,7 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description 카탈로그 */
+            /** @description Catalog */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -5933,12 +5997,12 @@ export interface operations {
                         models: components["schemas"]["AIModel"][];
                         /**
                          * Format: int64
-                         * @description org 마다 하루 무료분 (마이크로센트). **가성비 모델에만** 쓴다
+                         * @description The per-org daily free allowance (microcents). It applies to **value-lane models only**
                          */
                         freeDailyMicroCents: number;
                         /**
                          * Format: int64
-                         * @description "잔액이 낮다" 의 선 — 화면이 하드코딩하면 표가 둘이 된다
+                         * @description The "balance is low" threshold — if the UI hardcoded it, there would be two tables to keep in sync
                          */
                         lowMicroCents: number;
                     };
@@ -5959,7 +6023,7 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description AI 상태 */
+            /** @description AI status */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -5993,7 +6057,7 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description 부여 상태 (이미 있었으면 기존 값) */
+            /** @description Status after turning it on (the existing value if it was already on) */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -6027,7 +6091,7 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description 껐다 */
+            /** @description turned off */
             204: {
                 headers: {
                     [name: string]: unknown;
@@ -6058,7 +6122,7 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description 크레딧 상태 */
+            /** @description Credit status */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -6074,7 +6138,7 @@ export interface operations {
         parameters: {
             query?: {
                 limit?: number;
-                /** @description 이 ledger_id 보다 앞의 행 */
+                /** @description rows before this ledger_id */
                 before?: number;
             };
             header?: never;
@@ -6085,7 +6149,7 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description 원장 */
+            /** @description Ledger */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -6120,7 +6184,7 @@ export interface operations {
             };
         };
         responses: {
-            /** @description 체크아웃 */
+            /** @description Checkout */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -6132,7 +6196,7 @@ export interface operations {
                     };
                 };
             };
-            /** @description 충전 단위가 목록에 없다 · returnTo 가 허용된 주소가 아니다 */
+            /** @description The top-up amount is not one of the offered tiers, or `returnTo` is not an allowed address */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -6142,7 +6206,7 @@ export interface operations {
                 };
             };
             403: components["responses"]["Forbidden"];
-            /** @description `billing_off` — 이 배치에 크레딧 상품이 없다 */
+            /** @description `billing_off` — this installation has no credit product configured */
             501: {
                 headers: {
                     [name: string]: unknown;
@@ -6174,7 +6238,7 @@ export interface operations {
             };
         };
         responses: {
-            /** @description 켰다 */
+            /** @description Turned on */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -6185,14 +6249,14 @@ export interface operations {
                     };
                 };
             };
-            /** @description 껐다 */
+            /** @description turned off */
             204: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content?: never;
             };
-            /** @description 금액이 티어에 없다 · 기준이 0 이하 · 기준이 충전 금액 이상 */
+            /** @description The amount is not on the tier list, the threshold is 0 or less, or the threshold is at or above the top-up amount */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -6202,7 +6266,7 @@ export interface operations {
                 };
             };
             403: components["responses"]["Forbidden"];
-            /** @description `no_payment_method` — 저장된 카드가 없다. 먼저 한 번 수동으로 충전한다 */
+            /** @description `no_payment_method` — there is no saved card. Top up manually once first */
             409: {
                 headers: {
                     [name: string]: unknown;