@empiricalrun/playwright-utils 0.63.0 → 0.63.1

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

@@ -1558,6 +1558,30 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/files/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get a file
+         * @description Returns one of the project's files by ID.
+         */
+        get: operations["getFile"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        /**
+         * Confirm a file upload
+         * @description Marks a file `uploaded` after its body was PUT to `upload_url`. Checks the content is in storage and records its size. Safe to repeat.
+         */
+        patch: operations["updateFile"];
+        trace?: never;
+    };
     "/api/reporters": {
         parameters: {
             query?: never;
@@ -4514,6 +4538,66 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/notifications": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List my notifications
+         * @description Returns the signed-in user's unread notifications and their most recent read ones, limited to projects they can still access.
+         */
+        get: operations["listNotifications"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/notifications/{id}/read": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Mark a notification read
+         * @description Marks one of the signed-in user's notifications as read.
+         */
+        post: operations["markNotificationRead"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/notifications/read-all": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Mark all my notifications read
+         * @description Marks every unread notification of the signed-in user as read.
+         */
+        post: operations["markAllNotificationsRead"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/oauth/authorize-url": {
         parameters: {
             query?: never;
@@ -4534,6 +4618,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/oauth/clients/{client_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get an app asking to access Empirical
+         * @description Describes an OAuth client of Empirical's sign-in (e.g. an MCP client) for the consent screen: its self-chosen name, whether Empirical registered it, and where it receives tokens.
+         */
+        get: operations["getOAuthClient"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/onboarding/complete": {
         parameters: {
             query?: never;
@@ -5775,6 +5879,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/sandbox-snapshots/projects/{project_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * ⚙️ List a project's sandbox snapshots
+         * @description Returns the most recent sandbox snapshots for a project; used by sandbox-template CI to wait for a rebuild.
+         */
+        get: operations["listProjectSandboxSnapshots"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/sandbox-snapshots/rebuild": {
         parameters: {
             query?: never;
@@ -6105,6 +6229,30 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/users/me/announcements-seen": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get when the current user last saw announcements
+         * @description Returns the time up to which the signed-in user has seen dashboard announcements, falling back to their signup time.
+         */
+        get: operations["getMyAnnouncementsSeen"];
+        /**
+         * Mark announcements as seen for the current user
+         * @description Moves the signed-in user's announcement seen time forward to the given time, or to now.
+         */
+        put: operations["markMyAnnouncementsSeen"];
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/users/me/memberships": {
         parameters: {
             query?: never;
@@ -8715,6 +8863,45 @@ export interface components {
             /** @description Current document title for this exact destination. */
             title?: string;
         };
+        NotificationListResponse: {
+            /** @description Response payload. */
+            data: {
+                /** @description Unread notifications (newest 100) followed by the most recent read ones. */
+                notifications: components["schemas"]["Notification"][];
+                /** @description Total unread notifications. */
+                unread_count: number;
+            };
+        };
+        Notification: {
+            id: number;
+            /** @enum {string} */
+            kind: "chat_session_waiting" | "test_run";
+            project_id: number;
+            project_slug: string;
+            /** @enum {string} */
+            entity_type: "chat_session" | "test_run";
+            entity_id: number;
+            payload: {
+                [key: string]: unknown;
+            };
+            created_at: string;
+            read_at: string | null;
+            resolved_at: string | null;
+        };
+        NotificationsReadAllResponse: {
+            /** @description Response payload. */
+            data: {
+                /** @description Notifications newly marked read. */
+                updated: number;
+            };
+        };
+        NotificationReadResponse: {
+            /** @description Response payload. */
+            data: {
+                id: number;
+                read_at: string;
+            };
+        };
         OrgListResponse: {
             /** @description Response payload. */
             data: {
@@ -9553,6 +9740,8 @@ export interface components {
              * @enum {string}
              */
             base_template: "pi-sandbox";
+            /** @description Only rebuild these projects. Projects without a snapshot for the template are skipped. */
+            project_ids?: number[];
         };
         RebuildSandboxSnapshotsByTemplateRequest: {
             /**
@@ -10664,23 +10853,6 @@ export interface components {
                 slack_thread_id: number;
             } | null;
         };
-        SlackSupportedAction: {
-            /**
-             * @description Add a button that opens this pull request for review.
-             * @enum {string}
-             */
-            type: "review_pr";
-            /** @description Pull request number in the authenticated project's repository. */
-            pr_number: number;
-        } | {
-            /**
-             * @description Add a button that lets an authorized Slack user merge this pull request.
-             * @enum {string}
-             */
-            type: "merge_pr";
-            /** @description Pull request number in the authenticated project's repository. */
-            pr_number: number;
-        };
         SlackAppInstallMutationResponse: {
             /** @description Whether the write succeeded. */
             success: boolean;
@@ -13178,6 +13350,7 @@ export interface components {
                     job_type: "merge_reports";
                     storage_bucket?: string;
                     resume_run_from_shard?: number;
+                    teardown_shard_index?: number;
                 } | null;
             };
         };
@@ -14964,6 +15137,20 @@ export interface components {
                 is_super_admin: boolean;
             };
         };
+        AnnouncementsSeenResponse: {
+            /** @description Response payload. */
+            data: {
+                /** @description Announcements created at or before this time count as seen. Defaults to the user's signup time. */
+                seen_at: string;
+            };
+        };
+        MarkAnnouncementsSeenRequest: {
+            /**
+             * Format: date-time
+             * @description Mark announcements up to this time as seen. Defaults to now; never moves the seen time backwards or past now.
+             */
+            seen_at?: string;
+        };
         UserDetailResponse: {
             /** @description Response payload. */
             data: {
@@ -15011,6 +15198,15 @@ export interface components {
             mime_type: string | null;
             /** @description File size in bytes, when known. */
             size_bytes: number | null;
+            /**
+             * @description `pending` until the upload to `upload_url` is confirmed with `PATCH /api/files/{id}`.
+             * @enum {string}
+             */
+            status: "pending" | "uploaded";
+            /** @description Chat session the file came from, if an agent created it. */
+            origin_chat_session_id: number | null;
+            /** @description Tool call that produced the file, when known. */
+            origin_tool_call_id: string | null;
             /** @description ISO 8601 creation time. */
             created_at: string;
         };
@@ -15032,6 +15228,21 @@ export interface components {
             mime_type: string;
             /** @description File size in bytes. */
             size_bytes?: number;
+            /** @description Tool call that produced the file, when an agent uploads it. The chat session is taken from the caller's credentials. */
+            origin_tool_call_id?: string;
+        };
+        FileResponse: {
+            /** @description Response payload. */
+            data: {
+                file: components["schemas"]["File"];
+            };
+        };
+        UpdateFileRequest: {
+            /**
+             * @description Confirms the upload to `upload_url` finished. Fails if the file content is not in storage.
+             * @enum {string}
+             */
+            status: "uploaded";
         };
         ImportLoomFileResponse: {
             /** @description Response payload. */
@@ -18212,8 +18423,21 @@ export interface operations {
                 "application/json": {
                     /** @description Markdown message body; not Slack's text field. */
                     markdown: string;
-                    /** @description Actions the message intentionally offers. Omit this field for informational messages, including merged or closed PR updates. */
-                    supported_actions?: components["schemas"]["SlackSupportedAction"][];
+                    /** @description Agent-defined buttons; each requires exactly one of input or url. Input choices are single-use for the entire message: the first authorized selection removes all input buttons and publicly records who chose what. URL buttons remain available and never wake the agent. Selection requests an operation; the agent must report its outcome separately. Omit when no buttons are needed. */
+                    actions?: ({
+                        /** @description Button text shown to the user. */
+                        label: string;
+                        /** @description Text sent to this message's originating agent when selected. Supply enough context to act on it. */
+                        input: string;
+                    } | {
+                        /** @description Button text shown to the user. */
+                        label: string;
+                        /**
+                         * Format: uri
+                         * @description HTTP(S) destination opened by this repeatable navigation button. Does not send input to the agent or consume the message's choices.
+                         */
+                        url: string;
+                    })[];
                     /** @description Slack channel or existing DM channel ID. */
                     channel: string;
                     /** @description Root timestamp of the thread to reply to. Omit for a top-level post. */
@@ -18223,8 +18447,21 @@ export interface operations {
                 } | {
                     /** @description Markdown message body; not Slack's text field. */
                     markdown: string;
-                    /** @description Actions the message intentionally offers. Omit this field for informational messages, including merged or closed PR updates. */
-                    supported_actions?: components["schemas"]["SlackSupportedAction"][];
+                    /** @description Agent-defined buttons; each requires exactly one of input or url. Input choices are single-use for the entire message: the first authorized selection removes all input buttons and publicly records who chose what. URL buttons remain available and never wake the agent. Selection requests an operation; the agent must report its outcome separately. Omit when no buttons are needed. */
+                    actions?: ({
+                        /** @description Button text shown to the user. */
+                        label: string;
+                        /** @description Text sent to this message's originating agent when selected. Supply enough context to act on it. */
+                        input: string;
+                    } | {
+                        /** @description Button text shown to the user. */
+                        label: string;
+                        /**
+                         * Format: uri
+                         * @description HTTP(S) destination opened by this repeatable navigation button. Does not send input to the agent or consume the message's choices.
+                         */
+                        url: string;
+                    })[];
                     /** @description Recipient Slack user ID. Creates a new DM root; in-thread replies return to the sending session. */
                     slack_user_id: string;
                     /** @description Required for recipient-addressed sends. Each send creates a new DM root; root creation is not retry-safe if delivery or registration is uncertain. */
@@ -18232,8 +18469,21 @@ export interface operations {
                 } | {
                     /** @description Markdown message body; not Slack's text field. */
                     markdown: string;
-                    /** @description Actions the message intentionally offers. Omit this field for informational messages, including merged or closed PR updates. */
-                    supported_actions?: components["schemas"]["SlackSupportedAction"][];
+                    /** @description Agent-defined buttons; each requires exactly one of input or url. Input choices are single-use for the entire message: the first authorized selection removes all input buttons and publicly records who chose what. URL buttons remain available and never wake the agent. Selection requests an operation; the agent must report its outcome separately. Omit when no buttons are needed. */
+                    actions?: ({
+                        /** @description Button text shown to the user. */
+                        label: string;
+                        /** @description Text sent to this message's originating agent when selected. Supply enough context to act on it. */
+                        input: string;
+                    } | {
+                        /** @description Button text shown to the user. */
+                        label: string;
+                        /**
+                         * Format: uri
+                         * @description HTTP(S) destination opened by this repeatable navigation button. Does not send input to the agent or consume the message's choices.
+                         */
+                        url: string;
+                    })[];
                     /**
                      * Format: uuid
                      * @description Recipient Empirical UUID with one valid linked Slack account. Alternative to slack_user_id.
@@ -19181,6 +19431,8 @@ export interface operations {
                 page?: number;
                 /** @description Items per page (max 100). */
                 per_page?: number;
+                /** @description Only files created by this chat session. */
+                origin_chat_session_id?: number;
             };
             header?: never;
             path?: never;
@@ -19241,6 +19493,92 @@ export interface operations {
             };
         };
     };
+    getFile: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description File ID. */
+                id: number;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The file. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["FileResponse"];
+                };
+            };
+            /** @description File not found in this project. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    updateFile: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description File ID. */
+                id: number;
+            };
+            cookie?: never;
+        };
+        requestBody?: {
+            content: {
+                "application/json": components["schemas"]["UpdateFileRequest"];
+            };
+        };
+        responses: {
+            /** @description The updated file. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["FileResponse"];
+                };
+            };
+            /** @description Invalid request. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description File not found in this project. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description The file content has not been uploaded yet. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
     listReporters: {
         parameters: {
             query?: never;
@@ -27545,6 +27883,108 @@ export interface operations {
             };
         };
     };
+    listNotifications: {
+        parameters: {
+            query?: {
+                /** @description Maximum read notifications to return. Default 20. */
+                read_limit?: number;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The user's notifications. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["NotificationListResponse"];
+                };
+            };
+            /** @description Only signed-in users have notifications. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    markNotificationRead: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Notification ID. */
+                id: number;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The notification's read time. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["NotificationReadResponse"];
+                };
+            };
+            /** @description Only signed-in users have notifications. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Notification not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    markAllNotificationsRead: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description How many notifications were marked read. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["NotificationsReadAllResponse"];
+                };
+            };
+            /** @description Only signed-in users have notifications. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
     getOAuthAuthorizeUrl: {
         parameters: {
             query: {
@@ -27597,6 +28037,53 @@ export interface operations {
             };
         };
     };
+    getOAuthClient: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description OAuth client ID. */
+                client_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The OAuth client. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: {
+                            client_id: string;
+                            /** @description Name the app gave itself. */
+                            name: string;
+                            /**
+                             * @description dynamic: the app registered itself and is unverified. manual: registered by Empirical.
+                             * @enum {string}
+                             */
+                            registration_type: "dynamic" | "manual";
+                            /** @description Hosts the app receives access tokens on. */
+                            redirect_hosts: string[];
+                            /** @description Whether any redirect goes to a loopback address, i.e. an app on the user's own computer. */
+                            redirects_to_this_device: boolean;
+                        };
+                    };
+                };
+            };
+            /** @description No OAuth client with this ID. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
     completeOnboarding: {
         parameters: {
             query?: never;
@@ -30796,6 +31283,29 @@ export interface operations {
             };
         };
     };
+    listProjectSandboxSnapshots: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Project ID (positive integer). */
+                project_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The project's sandbox snapshots. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SandboxSnapshotListResponse"];
+                };
+            };
+        };
+    };
     rebuildSandboxSnapshots: {
         parameters: {
             query?: never;
@@ -31413,7 +31923,7 @@ export interface operations {
                     }[];
                     /** @description Directory prefix (key prefix) within the bucket. */
                     destination_dir: string;
-                    /** @description Ignored. Uploads always go to `dashboard-uploads`. */
+                    /** @description Ignored. Uploads always go to the files bucket. */
                     bucket?: string;
                 };
             };
@@ -31640,6 +32150,68 @@ export interface operations {
             };
         };
     };
+    getMyAnnouncementsSeen: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Announcement seen time. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AnnouncementsSeenResponse"];
+                };
+            };
+            /** @description User not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    markMyAnnouncementsSeen: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: {
+            content: {
+                "application/json": components["schemas"]["MarkAnnouncementsSeenRequest"];
+            };
+        };
+        responses: {
+            /** @description Updated seen time. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AnnouncementsSeenResponse"];
+                };
+            };
+            /** @description User not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
     createMyMemberships: {
         parameters: {
             query?: never;