palbase 0.32.1 → 0.34.0

package/types/cloud/src/generated/studio.d.ts

@@ -38,6 +38,21 @@ export declare function client(t: Transport): {
                 created_at: string;
             })[];
         }>>;
+        create(input: {
+            headers?: {
+                "Idempotency-Key"?: string;
+            };
+            body: {
+                name: string;
+            }; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
+            signal?: AbortSignal;
+        }): Promise<Reply<200, {
+            id: string;
+            name: string;
+            role: "owner" | "admin" | "member";
+            created_by: string | null;
+            created_at: string;
+        }>>;
         get(input: {
             path: {
                 id: string;
@@ -50,6 +65,33 @@ export declare function client(t: Transport): {
             created_by: string | null;
             created_at: string;
         }>>;
+        takeAway(input: {
+            path: {
+                id: string;
+            };
+            headers?: {
+                "Idempotency-Key"?: string;
+            }; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
+            signal?: AbortSignal;
+        }): Promise<Reply<204, undefined>>;
+        rename(input: {
+            path: {
+                id: string;
+            };
+            headers?: {
+                "Idempotency-Key"?: string;
+            };
+            body: {
+                name: string;
+            }; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
+            signal?: AbortSignal;
+        }): Promise<Reply<200, {
+            id: string;
+            name: string;
+            role: "owner" | "admin" | "member";
+            created_by: string | null;
+            created_at: string;
+        }>>;
         members(input: {
             path: {
                 id: string;
@@ -287,9 +329,6 @@ export declare function client(t: Transport): {
             path: {
                 id: string;
             };
-            query?: {
-                move_credit_to?: string;
-            };
             headers?: {
                 "Idempotency-Key"?: string;
             }; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
@@ -363,9 +402,6 @@ export declare function client(t: Transport): {
             path: {
                 ref: string;
             };
-            query?: {
-                move_credit_to?: string;
-            };
             headers?: {
                 "Idempotency-Key"?: string;
             }; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
@@ -1306,6 +1342,11 @@ export declare function client(t: Transport): {
             organization_id: string;
             exempt: boolean;
             has_account: boolean;
+            paid_by: ({
+                organization_id: string;
+                name: string;
+                held: boolean;
+            }) | null;
             paying: boolean;
             enforced: boolean;
             account: ({
@@ -1313,11 +1354,18 @@ export declare function client(t: Transport): {
                 payment_method: string | null;
                 terms_version: string | null;
                 terms_accepted_at: string | null;
+                threshold_micros: number;
+                owed_micros: number;
+                unpaid_micros: number;
+                past_due_since: string | null;
+                free_on: string | null;
+                held: ("unpaid" | "disputed") | null;
+                paid_organizations: number;
             }) | null;
             period: string;
             charged_micros?: number;
             gross_micros?: number;
-            taken_micros?: number;
+            owed_micros?: number;
             projects: ({
                 project_id: string;
                 ref: string;
@@ -1328,19 +1376,10 @@ export declare function client(t: Transport): {
                 at_limit: boolean;
                 gone: boolean;
                 deleted: boolean;
-                wallet?: {
-                    balance_micros: number;
-                    auto_topup: boolean;
-                    auto_threshold_micros: number;
-                    auto_amount_micros: number;
-                    monthly_limit_micros: number | null;
-                    low_balance_days: number;
-                    exhausted: boolean;
-                    topup_failures: number;
-                };
+                monthly_limit_micros?: number | null;
                 charged_micros?: number;
                 gross_micros?: number;
-                taken_micros?: number;
+                owed_micros?: number;
                 items: ({
                     item: string;
                     units: number;
@@ -1359,7 +1398,6 @@ export declare function client(t: Transport): {
             }; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
             signal?: AbortSignal;
         }): Promise<Reply<200, {
-            paid: boolean;
             saved: boolean;
         }>>;
         cards(input: {
@@ -1503,7 +1541,7 @@ export declare function client(t: Transport): {
                     project_name: string;
                 }) | null;
             })[];
-            taken_micros: {
+            owed_micros: {
                 [key: string]: number;
             };
         }>>;
@@ -1527,7 +1565,7 @@ export declare function client(t: Transport): {
         }): Promise<Reply<200, {
             invoices: ({
                 id: string;
-                kind: "checkout" | "auto" | "card" | "bank_transfer";
+                kind: "month" | "threshold" | "checkout" | "auto" | "card" | "bank_transfer";
                 project_id: string | null;
                 project_ref: string | null;
                 project_name: string | null;
@@ -1548,7 +1586,7 @@ export declare function client(t: Transport): {
                 }) | null;
             })[];
         }>>;
-        transfer(input: {
+        payer(input: {
             path: {
                 id: string;
             };
@@ -1556,16 +1594,141 @@ export declare function client(t: Transport): {
                 "Idempotency-Key"?: string;
             };
             body: {
-                from: string;
-                to: string;
-                amount_micros?: number;
+                account: string | null;
+            }; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
+            signal?: AbortSignal;
+        }): Promise<Reply<200, {
+            environments: ({
+                platform_id: string;
+                ref: string;
+                name: string;
+                project_id: string;
+                project_name: string;
+            })[];
+            organization_id: string;
+            exempt: boolean;
+            has_account: boolean;
+            paid_by: ({
+                organization_id: string;
+                name: string;
+                held: boolean;
+            }) | null;
+            paying: boolean;
+            enforced: boolean;
+            account: ({
+                stripe_mode: "live" | "test";
+                payment_method: string | null;
+                terms_version: string | null;
+                terms_accepted_at: string | null;
+                threshold_micros: number;
+                owed_micros: number;
+                unpaid_micros: number;
+                past_due_since: string | null;
+                free_on: string | null;
+                held: ("unpaid" | "disputed") | null;
+                paid_organizations: number;
+            }) | null;
+            period: string;
+            charged_micros?: number;
+            gross_micros?: number;
+            owed_micros?: number;
+            projects: ({
+                project_id: string;
+                ref: string;
+                name: string;
+                plan: "free" | "pay_as_you_go";
+                paid: boolean;
+                frozen: boolean;
+                at_limit: boolean;
+                gone: boolean;
+                deleted: boolean;
+                monthly_limit_micros?: number | null;
+                charged_micros?: number;
+                gross_micros?: number;
+                owed_micros?: number;
+                items: ({
+                    item: string;
+                    units: number;
+                    gross_micros?: number;
+                    micros?: number;
+                })[];
+            })[];
+        }>>;
+        paid(input: {
+            path: {
+                id: string;
+            }; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
+            signal?: AbortSignal;
+        }): Promise<Reply<200, {
+            organizations: ({
+                organization_id: string;
+                name: string;
+                environments: number;
+                pay_as_you_go: number;
+            })[];
+        }>>;
+        stopPaying(input: {
+            path: {
+                id: string;
+                org: string;
+            };
+            headers?: {
+                "Idempotency-Key"?: string;
+            }; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
+            signal?: AbortSignal;
+        }): Promise<Reply<204, undefined>>;
+        report(input: {
+            path: {
+                id: string;
+            };
+            query?: {
+                period?: string;
             }; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
             signal?: AbortSignal;
         }): Promise<Reply<200, {
-            moved_micros: number;
-            from: string;
-            to: string;
+            account: string;
+            period: string;
+            owed_micros: number;
+            charged_micros: number;
+            gross_micros: number;
+            organizations: ({
+                organization_id: string;
+                name: string;
+                owed_micros: number;
+                charged_micros: number;
+                gross_micros: number;
+                environments: ({
+                    project_id: string;
+                    ref: string;
+                    name: string;
+                    owed_micros: number;
+                    charged_micros: number;
+                    gross_micros: number;
+                    items: ({
+                        item: string;
+                        units: number;
+                        gross_micros: number;
+                        micros: number;
+                    })[];
+                    environment: ({
+                        platform_id: string;
+                        ref: string;
+                        name: string;
+                        project_id: string;
+                        project_name: string;
+                    }) | null;
+                })[];
+            })[];
         }>>;
+        reportCsv(input: {
+            path: {
+                id: string;
+            };
+            query?: {
+                period?: string;
+            }; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
+            signal?: AbortSignal;
+        }): Promise<Reply<number, Response>>;
         environment(input: {
             path: {
                 id: string;
@@ -1582,19 +1745,10 @@ export declare function client(t: Transport): {
             at_limit: boolean;
             gone: boolean;
             deleted: boolean;
-            wallet?: {
-                balance_micros: number;
-                auto_topup: boolean;
-                auto_threshold_micros: number;
-                auto_amount_micros: number;
-                monthly_limit_micros: number | null;
-                low_balance_days: number;
-                exhausted: boolean;
-                topup_failures: number;
-            };
+            monthly_limit_micros?: number | null;
             charged_micros?: number;
             gross_micros?: number;
-            taken_micros?: number;
+            owed_micros?: number;
             items: ({
                 item: string;
                 units: number;
@@ -1621,10 +1775,6 @@ export declare function client(t: Transport): {
                 plan?: "free" | "pay_as_you_go";
                 frozen?: boolean;
                 monthly_limit_micros?: number | null;
-                auto_topup?: boolean;
-                auto_threshold_micros?: number;
-                auto_amount_micros?: number;
-                low_balance_days?: number;
             }; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
             signal?: AbortSignal;
         }): Promise<Reply<200, {
@@ -1637,19 +1787,10 @@ export declare function client(t: Transport): {
             at_limit: boolean;
             gone: boolean;
             deleted: boolean;
-            wallet?: {
-                balance_micros: number;
-                auto_topup: boolean;
-                auto_threshold_micros: number;
-                auto_amount_micros: number;
-                monthly_limit_micros: number | null;
-                low_balance_days: number;
-                exhausted: boolean;
-                topup_failures: number;
-            };
+            monthly_limit_micros?: number | null;
             charged_micros?: number;
             gross_micros?: number;
-            taken_micros?: number;
+            owed_micros?: number;
             items: ({
                 item: string;
                 units: number;
@@ -1664,69 +1805,6 @@ export declare function client(t: Transport): {
                 project_name: string;
             };
         }>>;
-        topUp(input: {
-            path: {
-                id: string;
-                ref: string;
-            };
-            headers?: {
-                "Idempotency-Key"?: string;
-            };
-            body: {
-                amount_micros: number;
-                payment_method?: string;
-                plan?: "pay_as_you_go";
-            }; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
-            signal?: AbortSignal;
-        }): Promise<Reply<200, {
-            invoice_id: string;
-            status: string;
-            hosted_url?: string;
-        }>>;
-        bankTransfer(input: {
-            path: {
-                id: string;
-                ref: string;
-            };
-            headers?: {
-                "Idempotency-Key"?: string;
-            };
-            body: {
-                amount_micros: number;
-            }; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
-            signal?: AbortSignal;
-        }): Promise<Reply<200, {
-            invoice_id: string;
-            status: string;
-            hosted_url?: string;
-        }>>;
-        ledger(input: {
-            path: {
-                id: string;
-                ref: string;
-            };
-            query?: {
-                before?: number;
-                kind?: string;
-            }; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
-            signal?: AbortSignal;
-        }): Promise<Reply<200, {
-            lines: ({
-                from_environment?: string | null;
-                to_environment?: string | null;
-                id: number;
-                kind: "topup" | "bonus" | "usage" | "expiry" | "refund" | "adjustment" | "transfer" | "forfeit";
-                amount_micros: number;
-                ref: string;
-                remaining_micros: number | null;
-                expires_at: string | null;
-                created_at: string;
-                via: string | null;
-                invoice: string | null;
-                from_project?: string;
-                to_project?: string;
-            })[];
-        }>>;
     };
     accessRequests: {
         request(input: {

package/types/internal/src/modules/ai.d.ts

@@ -1256,7 +1256,7 @@ export type MessageAttachment = {
      */
     content_type: string;
     /**
-     * image: a picture the model is shown with the message; file: a file put in the chat's workspace.
+     * image: a picture the model is shown with the message; file: a file the agent is given as read_as says, and put in the chat's workspace when it has one.
      */
     kind: "image" | "file";
     /**
@@ -1276,12 +1276,16 @@ export type MessageAttachment = {
      */
     size: number;
     /**
-     * Where a file is in the chat's workspace: .palbase/attachments/<message id>/<name>.
+     * How the agent's model is given a file: picture (shown), document (a PDF, given whole), text (its text, drawn out of a Word, Excel or PowerPoint file, or a text file). None: a file of the chat's workspace alone.
+     */
+    read_as?: "picture" | "document" | "text";
+    /**
+     * Where a file is in the chat's workspace: .palbase/attachments/<message id>/<name>. None in a chat that works in no workspace.
      */
     workspace_path?: string;
 };
 /**
- * A file of the project's storage a message puts in its chat's workspace.
+ * A file of the project's storage a message gives its chat's agent, and puts in its workspace when it has one.
  */
 export type MessageFileRequest = {
     /**
@@ -1349,7 +1353,7 @@ export type MessageRequest = {
      */
     delivery?: "next" | "now";
     /**
-     * Files of the project's storage put in the chat's workspace before the agent reads the message, at .palbase/attachments/<message id>/<filename>, and the agent is told where (8 at most, 15 MiB each at most). A chat that works in no workspace takes none (409 no_workspace). Copied for the chat, and who may attach which, as images; an object the message names twice — a picture of it and a file of it too — is read once.
+     * Files of the project's storage given to the agent with the message (8 at most, 50 MB each at most), by what their bytes are: a PDF whole, each page as its text and as a picture; a picture (png, jpeg, webp or gif, 5 MiB at most) shown, while the message shows fewer than 4; a Word, Excel or PowerPoint file (.docx, .xlsx, .pptx) or a text file as its text, drawn out by the platform (400,000 bytes of it at most). In a chat that works in a workspace each is also put in it before the agent reads the message, at .palbase/attachments/<message id>/<filename>, and the agent is told where. A chat that works in no workspace refuses a file its agent is given nothing of (415, 413 or 422 unreadable_attachment). Copied for the chat, and who may attach which, as images; an object the message names twice — a picture of it and a file of it too — is read once.
      */
     files?: MessageFileRequest[];
     /**

package/types/internal/src/modules/machines.d.ts

@@ -214,7 +214,7 @@ export type Machine = {
      */
     always_on: boolean;
     /**
-     * Whether a pull request opened against its branch is previewed: its head built into a machine of its own, <name>-pr<n>, in this environment, with this environment's settings and secrets, answering at <name>-pr<n>-<ref> until the pull request closes; the pull request is told where in a comment. Turn it on in an environment kept for previews, not production's: the pull request's code runs with the environment's secrets.
+     * Whether a pull request opened against its branch is previewed: its head built into a machine of its own, <name>-pr<n>, in this environment, with this environment's settings and secrets, answering at <name>-pr<n>-<ref> until the pull request closes; the pull request is told where in a comment. Any environment previews, production's too: the pull request's code runs with the environment's settings, secrets and users, with a database of its own when the machine runs its database's migrations.
      */
     previews: boolean;
     /**
@@ -307,7 +307,7 @@ export type MachineCreate = {
      */
     always_on?: boolean;
     /**
-     * Whether a pull request opened against its branch is previewed: its head built into a machine of its own, <name>-pr<n>, in this environment, with this environment's settings and secrets, answering at <name>-pr<n>-<ref> until the pull request closes; the pull request is told where in a comment. Turn it on in an environment kept for previews, not production's: the pull request's code runs with the environment's secrets. A machine read with a platform's tokens (source.access token) previews what its platform puts (PUT /machines/{name}/previews/{pull_request}), no comment written.
+     * Whether a pull request opened against its branch is previewed: its head built into a machine of its own, <name>-pr<n>, in this environment, with this environment's settings and secrets, answering at <name>-pr<n>-<ref> until the pull request closes; the pull request is told where in a comment. Any environment previews, production's too: the pull request's code runs with the environment's settings, secrets and users, with a database of its own when the machine runs its database's migrations. A machine read with a platform's tokens (source.access token) previews what its platform puts (PUT /machines/{name}/previews/{pull_request}), no comment written.
      */
     previews?: boolean;
     /**
@@ -802,6 +802,14 @@ export type DatabaseLimits = {
      * The connections it takes (Postgres' max_connections).
      */
     connections: number;
+    /**
+     * The sessions its direct port (5432) takes at once.
+     */
+    direct_connections: number;
+    /**
+     * The transactions its pooled port (6543) runs at once.
+     */
+    pooled_connections: number;
 };
 /**
  * One bucket of a database's usage.
@@ -1197,6 +1205,14 @@ export type DatabaseSize = {
      * A week asleep, its volume is taken back and its next connection brings it back from its backup.
      */
     archives: boolean;
+    /**
+     * How many sessions its direct port (5432) takes at once: a session holds one until it ends, and a client past them is refused (53300).
+     */
+    direct_connections: number;
+    /**
+     * How many transactions its pooled port (6543) runs at once, however many of its clients are connected: a transaction that finds none of them free within 20 s is refused (53300).
+     */
+    pooled_connections: number;
     /**
      * A size counted against the project's free databases; the others are paid for.
      */
@@ -1476,7 +1492,7 @@ export type Site = {
     source: SiteSourceView;
     build: SiteBuildSettings;
     /**
-     * Whether a pull request opened against its source's branch is previewed: its head built, with this environment's build settings, into a release of its own that answers at <name>-pr<n>-<ref> until the pull request closes — never what the site serves, none of its releases; the pull request is told where in a comment. Turn it on in an environment kept for previews, not production's.
+     * Whether a pull request opened against its source's branch is previewed: its head built, with this environment's build settings, into a release of its own that answers at <name>-pr<n>-<ref> until the pull request closes — never what the site serves, none of its releases; the pull request is told where in a comment. Any environment previews, production's too: the pull request's build runs with the environment's settings.
      */
     previews: boolean;
     /**
@@ -1522,7 +1538,7 @@ export type SiteCreate = {
     source?: SiteSource;
     build?: SiteBuildSettings;
     /**
-     * Whether a pull request opened against its source's branch is previewed: its head built, with this environment's build settings, into a release of its own that answers at <name>-pr<n>-<ref> until the pull request closes — never what the site serves, none of its releases; the pull request is told where in a comment. Turn it on in an environment kept for previews, not production's.
+     * Whether a pull request opened against its source's branch is previewed: its head built, with this environment's build settings, into a release of its own that answers at <name>-pr<n>-<ref> until the pull request closes — never what the site serves, none of its releases; the pull request is told where in a comment. Any environment previews, production's too: the pull request's build runs with the environment's settings.
      */
     previews?: boolean;
     /**
@@ -1858,7 +1874,7 @@ export type PreviewOpened = {
     commit: string;
 };
 /**
- * A platform's pull request: its branch — one of the machine's repository's own — the head its machine's preview builds, and the token it is read with.
+ * A platform's pull request: its branch — one of the machine's repository's own — the head its machine's preview builds, and, for a machine read with a platform's tokens, the token it is read with.
  */
 export type PreviewDeploy = {
     /**
@@ -1870,9 +1886,9 @@ export type PreviewDeploy = {
      */
     commit?: string;
     /**
-     * A GitHub App installation's token (ghs_…) for the machine's repository alone, read-only: used once, never kept.
+     * For a machine read with a platform's tokens (source.access token), and required for one: a GitHub App installation's token (ghs_…) for the machine's repository alone, read-only, used once, never kept. A machine read with Palbase's GitHub App takes none (400 token_not_taken): its branch is read with the project's installation.
      */
-    git_access_token: string;
+    git_access_token?: string;
 };
 /** Palbase Machines */
 export declare function client(t: Transport): {
@@ -2044,7 +2060,7 @@ export declare function client(t: Transport): {
     /**
      * Open or update a platform's pull request preview
      *
-     * For a machine read with a platform's tokens (source.access token: PalCore's, whose repositories have no Palbase App, so no pull request is heard here): opens the preview of the pull request at the head of its branch — one of the machine's repository's own: a fork's is not built — its own machine, <name>-pr<n>, and a database of its own when the machine runs its database's migrations — or builds the open one at it, and opens one that went idle again. The branch is read with git_access_token, a GitHub App installation's token for the machine's repository alone (ghs_…), once; a commit named must be the branch's head (409 commit_not_head). Its address and state are read with GET /machines/{name}/previews; the platform tells its pull request itself. Refused in a production environment (409 previews_in_production), for a machine read with Palbase's GitHub App (409 previews_from_github), with previews off (409 previews_off), and when the environment's limits refuse the preview (409 preview_refused, with why).
+     * For a platform — PalCore — that previews its product's machine itself: one read with its tokens (source.access token), whose pull requests are not heard here, or one read with Palbase's GitHub App, whose numbers then are the platform's (a pull request GitHub told of keeps its own: 409 preview_taken). Opens the preview of the pull request at the head of its branch — one of the machine's repository's own: a fork's is not built — its own machine, <name>-pr<n>, and a database of its own when the machine runs its database's migrations — or builds the open one at it, and opens one that went idle again. A machine read with tokens has its branch read with git_access_token, a GitHub App installation's token for the machine's repository alone (ghs_…), once (400 token_required without); one read with Palbase's App, with the project's installation (400 token_not_taken with one). A commit named must be the branch's head (409 commit_not_head). Any environment previews, production's too: the preview runs with its settings, secrets and users. Its address and state are read with GET /machines/{name}/previews; the platform tells its pull request itself. Refused with previews off (409 previews_off), and when the environment's limits refuse the preview (409 preview_refused, with why).
      */
     putMachinePreview(input: {
         path: {
@@ -2057,7 +2073,7 @@ export declare function client(t: Transport): {
     /**
      * Close a platform's pull request preview
      *
-     * For a machine read with a platform's tokens: closes the preview of the pull request, its pull request closed — its machine and its own database are deleted at once. A machine read with Palbase's GitHub App has its previews closed as GitHub tells (409 previews_from_github).
+     * Closes a preview its platform put (PUT): its machine and its own database are deleted at once. A preview GitHub told of closes as its pull request does (409 previews_from_github).
      */
     deleteMachinePreview(input: {
         path: {