@empiricalrun/playwright-utils 0.66.1 → 0.66.2

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

@@ -2165,8 +2165,8 @@ export interface paths {
         get: operations["listTasks"];
         put?: never;
         /**
-         * 🤖 Create a task
-         * @description Creates a task for the scoped project. Every task is owed to a person: `created_by` defaults to the signed-in user or, for an agent, the person who started its session. An agent acting for someone else, such as the person who asked in Slack, passes their user ID as `created_by`. Track your own follow-ups elsewhere; a task with no person behind it is rejected. It does not start a chat session; use `POST /api/tasks/{id}/chat-sessions` for that.
+         * 🛡️ Create a task
+         * @description Creates a task for the scoped project. Only people and Empirical's own services create tasks; agents work on them. `created_by` defaults to the signed-in user. A service may leave it out, and the task is then owed to the platform. It does not start a chat session; use `POST /api/tasks/{id}/chat-sessions` for that.
          */
         post: operations["createTask"];
         delete?: never;
@@ -2190,7 +2190,7 @@ export interface paths {
         put?: never;
         post?: never;
         /**
-         * 🤖 Delete a task
+         * 🛡️ Delete a task
          * @description Permanently deletes a task.
          */
         delete: operations["deleteTask"];
@@ -2198,11 +2198,51 @@ export interface paths {
         head?: never;
         /**
          * 🤖 Update a task
-         * @description Updates a task's title, description, or status. A draft → open transition spawns a chat session.
+         * @description Updates a task's title, description, or status. A status change, and any `note`, is added to the task's activity.
          */
         patch: operations["updateTask"];
         trace?: never;
     };
+    "/api/tasks/{id}/activity": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * 🤖 List a task's activity
+         * @description Returns the task's status changes and comments, oldest first.
+         */
+        get: operations["listTaskActivity"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/tasks/{id}/comments": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * 🤖 Comment on a task
+         * @description Adds a comment to the task's activity.
+         */
+        post: operations["createTaskComment"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/traces/compare": {
         parameters: {
             query?: never;
@@ -6332,84 +6372,6 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/api/sandbox-snapshots/sources/upsert": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /**
-         * ⚙️ Upsert sandbox snapshot sources
-         * @description Upserts one or more snapshot source rows; called by sandbox-template CI.
-         */
-        post: operations["upsertSandboxSnapshotSources"];
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/api/system-messages": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /** 🛡️ List system messages with delivery and ack counts */
-        get: operations["listSystemMessages"];
-        put?: never;
-        /**
-         * 🛡️ Broadcast a system message to manager sessions
-         * @description Persists the message and delivers it to project manager sessions. With `project_ids`, every listed project gets a recipient row, and one without an open manager is recorded as failed. Without it, the message goes to every project with an open manager, and active projects without one are returned in `skipped_project_ids` (not persisted). Delivery is attempted before responding. Managers acknowledge through `POST /api/system-messages/{id}/ack`.
-         */
-        post: operations["createSystemMessage"];
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/api/system-messages/{id}": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /** 🛡️ Get a system message's per-project delivery and ack status */
-        get: operations["getSystemMessage"];
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/api/system-messages/{id}/ack": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /**
-         * Acknowledge a system message from a manager session
-         * @description Records the calling manager session's acknowledgement for its project. Any manager session of the project may ack, so a successor can answer a message its predecessor received. Re-acking overwrites the previous status and note.
-         */
-        post: operations["ackSystemMessage"];
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
     "/api/tasks/{id}/chat-sessions": {
         parameters: {
             query?: never;
@@ -6424,8 +6386,8 @@ export interface paths {
         get: operations["listTaskChatSessions"];
         put?: never;
         /**
-         * ⚙️ Create a chat session for a task
-         * @description Starts a new chat session tied to a task.
+         * 🛡️ Create a chat session for a task
+         * @description Starts a chat session that works on the task. Its first message points the agent at the task and the `empirical-tasks` skill, followed by any `initial_prompt`. A service's session belongs to the person the task is for, or to the platform.
          */
         post: operations["createTaskChatSession"];
         delete?: never;
@@ -6842,20 +6804,6 @@ export interface paths {
 export type webhooks = Record<string, never>;
 export interface components {
     schemas: {
-        AckSystemMessageRequest: {
-            /** @enum {string} */
-            status: "accepted" | "declined";
-            note?: string;
-        };
-        AckSystemMessageResponse: {
-            data: {
-                system_message_id: number;
-                project_id: number;
-                /** @enum {string} */
-                ack_status: "accepted" | "declined";
-                acked_at: string;
-            };
-        };
         ActivityDay: {
             /** @description Local date, YYYY-MM-DD. */
             date: string;
@@ -8343,16 +8291,9 @@ export interface components {
             /** @description ID of the test run this snooze was created from, if applicable. */
             created_from_test_run_id?: string | number;
         };
-        CreateSystemMessageRequest: {
+        CreateTaskCommentRequest: {
+            /** @description Comment text (Markdown). */
             body: string;
-            project_ids?: number[];
-        };
-        CreateSystemMessageResponse: {
-            data: {
-                system_message: components["schemas"]["SystemMessage"];
-                recipients: components["schemas"]["SystemMessageRecipient"][];
-                skipped_project_ids: number[];
-            };
         };
         CreateTaskError: {
             /** @description Always null for error responses. */
@@ -8378,8 +8319,8 @@ export interface components {
              * @description Initial status; defaults to `open`.
              * @enum {string}
              */
-            status?: "draft" | "open" | "in-review" | "closed" | "resolved";
-            /** @description User ID of the person the task is for. Defaults to the signed-in user, or to the person who started the calling agent's session. Pass it when acting for someone else; there must be a person. */
+            status?: "open" | "in-progress" | "blocked" | "in-review" | "resolved" | "closed";
+            /** @description User ID of the person the task is for. Defaults to the signed-in user. A service may leave it out to make the task owed to the platform. */
             created_by?: string;
         };
         CreateTaskResponse: {
@@ -13553,39 +13494,6 @@ export interface components {
             /** @description Branch names the sandbox must not push to. */
             branches: string[];
         };
-        SandboxSnapshot: {
-            /** @description Snapshot row ID. */
-            id: number;
-            /** @description Project the snapshot belongs to, or null. */
-            project_id: number | null;
-            /** @description Sandbox provider (e.g. `e2b`). */
-            provider: string;
-            /** @description Snapshot source identifier. */
-            source_name: string;
-            /** @description Playwright version the snapshot was built with. */
-            playwright_version: string;
-            /** @description Hash of the package lockfile, if known. */
-            package_lock_hash: string | null;
-            /** @description Base branch the snapshot was built from. */
-            base_branch: string | null;
-            /** @description Base template the snapshot was built from. */
-            base_template: string | null;
-            /** @description Head commit SHA the snapshot was built from. */
-            head_sha: string | null;
-            /** @description ISO 8601 creation timestamp. */
-            created_at: string;
-            /** @description ISO 8601 last-update timestamp. */
-            updated_at: string;
-        } | null;
-        SandboxSnapshotSourcesUpsertResponse: {
-            /** @description Response payload. */
-            data: {
-                /** @description Number of sources upserted. */
-                source_count: number;
-                /** @description The upserted snapshot source rows. */
-                sources: components["schemas"]["SandboxSnapshot"][];
-            };
-        };
         ScheduleSnoozeExpiryRequest: {
             /** @description ID of the snooze whose expiry alarm to register. */
             snooze_id: number;
@@ -13875,14 +13783,6 @@ export interface components {
                             };
                         };
                     };
-                } | {
-                    /** @enum {string} */
-                    kind: "system_message";
-                    delivery: {
-                        id: number;
-                        message: string;
-                        ack_instructions: string;
-                    };
                 };
                 rpcCommandId?: string;
             };
@@ -14632,47 +14532,6 @@ export interface components {
                 }[];
             };
         };
-        SystemMessage: {
-            id: number;
-            body: string;
-            created_by: string | null;
-            created_at: string;
-        };
-        SystemMessageDetailResponse: {
-            data: {
-                system_message: components["schemas"]["SystemMessage"];
-                recipients: components["schemas"]["SystemMessageRecipient"][];
-            };
-        };
-        SystemMessageListResponse: {
-            data: {
-                system_messages: components["schemas"]["SystemMessageSummary"][];
-            };
-        };
-        SystemMessageRecipient: {
-            project_id: number;
-            chat_session_id: number | null;
-            /** @enum {string} */
-            delivery_status: "pending" | "delivered" | "failed";
-            delivery_error: string | null;
-            delivered_at: string | null;
-            /** @enum {string|null} */
-            ack_status: "accepted" | "declined" | null;
-            ack_note: string | null;
-            acked_at: string | null;
-            acked_by_chat_session_id: number | null;
-            session_is_closed: boolean | null;
-        };
-        SystemMessageSummary: {
-            id: number;
-            body: string;
-            created_by: string | null;
-            created_at: string;
-            recipients: number;
-            delivered: number;
-            failed: number;
-            acked: number;
-        };
         Task: {
             /** @description Unique identifier for the task. */
             id: number;
@@ -14687,13 +14546,78 @@ export interface components {
             source: string;
             /** @description Identifier of the task in its source system. */
             source_identifier: string;
-            /** @description User ID of the person the task is owed to. `null` only on tasks created before this was required. */
+            /** @description User ID of the person the task is owed to. `null` means it is owed to the platform. */
             created_by: string | null;
             /** @description ISO 8601 timestamp of when the task was created. */
             created_at: string;
             /** @description ISO 8601 timestamp of when the task was last updated. */
             updated_at: string;
         };
+        TaskActivity: {
+            /** @description Activity entry ID. */
+            id: number;
+            /** @description Task the entry is on. */
+            task_id: number;
+            /** @description User who wrote it. `null` for an agent (see `created_by_chat_session_id`) or the platform. */
+            created_by: string | null;
+            /** @description Chat session of the agent that wrote it, if an agent did. */
+            created_by_chat_session_id: number | null;
+            /** @description Comment, or the note on a status change (Markdown). */
+            body: string | null;
+            /**
+             * @description Status before the change; `null` for a plain comment.
+             * @enum {string|null}
+             */
+            status_from: "open" | "in-progress" | "blocked" | "in-review" | "resolved" | "closed" | null;
+            /**
+             * @description Status after the change; `null` for a plain comment.
+             * @enum {string|null}
+             */
+            status_to: "open" | "in-progress" | "blocked" | "in-review" | "resolved" | "closed" | null;
+            /** @description ISO 8601 timestamp of when the entry was written. */
+            created_at: string;
+        };
+        TaskActivityListResponse: {
+            /** @description Response payload. */
+            data: {
+                activity: components["schemas"]["TaskActivityWithCreator"][];
+            };
+        };
+        TaskActivityWithCreator: {
+            /** @description Activity entry ID. */
+            id: number;
+            /** @description Task the entry is on. */
+            task_id: number;
+            /** @description User who wrote it. `null` for an agent (see `created_by_chat_session_id`) or the platform. */
+            created_by: string | null;
+            /** @description Chat session of the agent that wrote it, if an agent did. */
+            created_by_chat_session_id: number | null;
+            /** @description Comment, or the note on a status change (Markdown). */
+            body: string | null;
+            /**
+             * @description Status before the change; `null` for a plain comment.
+             * @enum {string|null}
+             */
+            status_from: "open" | "in-progress" | "blocked" | "in-review" | "resolved" | "closed" | null;
+            /**
+             * @description Status after the change; `null` for a plain comment.
+             * @enum {string|null}
+             */
+            status_to: "open" | "in-progress" | "blocked" | "in-review" | "resolved" | "closed" | null;
+            /** @description ISO 8601 timestamp of when the entry was written. */
+            created_at: string;
+            /** @description Details of the user who wrote it, when a user did. */
+            created_by_user_detail?: {
+                /** @description User ID. */
+                id: string;
+                /** @description User email address. */
+                email: string;
+                /** @description User display name. */
+                name: string;
+                /** @description URL to user avatar image. */
+                picture: string;
+            } | null;
+        };
         TaskChatSession: {
             /** @description Chat session ID. */
             id: number;
@@ -14770,6 +14694,12 @@ export interface components {
             /** @description Chat sessions for the task. */
             data: components["schemas"]["TaskChatSessionWithUser"][];
         };
+        TaskCommentResponse: {
+            /** @description Response payload. */
+            data: {
+                activity: components["schemas"]["TaskActivity"];
+            };
+        };
         TaskListResponse: {
             /** @description The page of tasks. */
             data: {
@@ -14790,10 +14720,10 @@ export interface components {
             };
         };
         /**
-         * @description Moving a `draft` task to `open` starts an agent session. `closed` and `resolved` are terminal.
+         * @description `open`: asked for, nobody is working on it yet. `in-progress`: someone is working on it. `blocked`: cannot continue without a person; say what is needed. `in-review`: the change is ready, e.g. a pull request is open. `resolved`: done, e.g. the pull request is merged. `closed`: dropped without doing it; say why. `resolved` and `closed` are terminal.
          * @enum {string}
          */
-        TaskStatus: "draft" | "open" | "in-review" | "closed" | "resolved";
+        TaskStatus: "open" | "in-progress" | "blocked" | "in-review" | "resolved" | "closed";
         TaskWithCreator: {
             /** @description Unique identifier for the task. */
             id: number;
@@ -14808,7 +14738,7 @@ export interface components {
             source: string;
             /** @description Identifier of the task in its source system. */
             source_identifier: string;
-            /** @description User ID of the person the task is owed to. `null` only on tasks created before this was required. */
+            /** @description User ID of the person the task is owed to. `null` means it is owed to the platform. */
             created_by: string | null;
             /** @description ISO 8601 timestamp of when the task was created. */
             created_at: string;
@@ -16530,10 +16460,12 @@ export interface components {
             /** @description New task description (Markdown). */
             description?: string;
             /**
-             * @description New task status. Moving a `draft` task to `open` starts an agent session.
+             * @description New task status.
              * @enum {string}
              */
-            status?: "draft" | "open" | "in-review" | "closed" | "resolved";
+            status?: "open" | "in-progress" | "blocked" | "in-review" | "resolved" | "closed";
+            /** @description Why the status changed, shown in the task's activity. Say what is needed when moving to `blocked`, and why when moving to `closed`. */
+            note?: string;
         };
         UpdateTestCaseTagsRequest: {
             /** @description Array of tags to assign to the test case. */
@@ -16599,30 +16531,6 @@ export interface components {
             /** @description Signing secret, if set. */
             secret: string | null;
         };
-        UpsertSandboxSnapshotSourcesRequest: {
-            /** @description Snapshot sources to upsert (at least one). */
-            sources: {
-                /** @description Project the source belongs to, or null if generic. */
-                project_id: number | null;
-                /**
-                 * @description Sandbox provider.
-                 * @enum {string}
-                 */
-                provider: "e2b" | "docker" | "vercel";
-                /** @description Snapshot source identifier (e.g. template ID). */
-                source_name: string;
-                /** @description Playwright version the snapshot was built with. */
-                playwright_version: string;
-                /** @description Base template the source was built from. */
-                base_template: string;
-                /** @description Hash of the package lockfile, if known. */
-                package_lock_hash?: string | null;
-                /** @description Base branch the snapshot was built from, if known. */
-                base_branch?: string | null;
-                /** @description Head commit SHA the snapshot was built from. */
-                head_sha?: string | null;
-            }[];
-        };
         UpsertTriageStatusRequest: {
             /** @description The run in which this failure was observed. */
             test_run_id: number;
@@ -23431,7 +23339,7 @@ export interface operations {
                     "application/json": components["schemas"]["CreateTaskResponse"];
                 };
             };
-            /** @description Missing required fields, no person to own the task, or invalid input. */
+            /** @description Missing required fields, or a created_by outside the project. */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -23587,6 +23495,74 @@ export interface operations {
             };
         };
     };
+    listTaskActivity: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Task ID. */
+                id: number;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The task's activity. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["TaskActivityListResponse"];
+                };
+            };
+            /** @description Task not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    createTaskComment: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Task ID. */
+                id: number;
+            };
+            cookie?: never;
+        };
+        requestBody?: {
+            content: {
+                "application/json": components["schemas"]["CreateTaskCommentRequest"];
+            };
+        };
+        responses: {
+            /** @description The new comment. */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["TaskCommentResponse"];
+                };
+            };
+            /** @description Task not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
     compareTraceAgainstPass: {
         parameters: {
             query?: never;
@@ -34276,178 +34252,6 @@ export interface operations {
             };
         };
     };
-    upsertSandboxSnapshotSources: {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        requestBody?: {
-            content: {
-                "application/json": components["schemas"]["UpsertSandboxSnapshotSourcesRequest"];
-            };
-        };
-        responses: {
-            /** @description The upserted sources. */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["SandboxSnapshotSourcesUpsertResponse"];
-                };
-            };
-            /** @description Invalid request. */
-            400: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
-        };
-    };
-    listSystemMessages: {
-        parameters: {
-            query?: {
-                limit?: number;
-            };
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description Recent system messages, newest first. */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["SystemMessageListResponse"];
-                };
-            };
-        };
-    };
-    createSystemMessage: {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        requestBody?: {
-            content: {
-                "application/json": components["schemas"]["CreateSystemMessageRequest"];
-            };
-        };
-        responses: {
-            /** @description The message and its per-project delivery. */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["CreateSystemMessageResponse"];
-                };
-            };
-            /** @description A listed project does not exist. */
-            400: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
-            /** @description Broadcast requested but no project has an open manager session. */
-            422: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
-        };
-    };
-    getSystemMessage: {
-        parameters: {
-            query?: never;
-            header?: never;
-            path: {
-                id: number;
-            };
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description The message and its per-project status. */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["SystemMessageDetailResponse"];
-                };
-            };
-            /** @description System message not found. */
-            404: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
-        };
-    };
-    ackSystemMessage: {
-        parameters: {
-            query?: never;
-            header?: never;
-            path: {
-                id: number;
-            };
-            cookie?: never;
-        };
-        requestBody?: {
-            content: {
-                "application/json": components["schemas"]["AckSystemMessageRequest"];
-            };
-        };
-        responses: {
-            /** @description The recorded acknowledgement. */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["AckSystemMessageResponse"];
-                };
-            };
-            /** @description Caller is not a manager chat session. */
-            403: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
-            /** @description System message was not sent to this project. */
-            404: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
-        };
-    };
     listTaskChatSessions: {
         parameters: {
             query?: never;
@@ -34502,9 +34306,9 @@ export interface operations {
         requestBody?: {
             content: {
                 "application/json": {
-                    /** @description Project the chat session belongs to. */
+                    /** @description The task's project. Optional; the session is always in the task's project. */
                     project_id?: (number | string) | null;
-                    /** @description First message to send to the agent. */
+                    /** @description Extra instructions added after the pointer to the task. */
                     initial_prompt?: string | null;
                     /** @description Model to use for the chat session. */
                     model?: string | null;
@@ -34521,7 +34325,7 @@ export interface operations {
                     "application/json": components["schemas"]["TaskSessionResponse"];
                 };
             };
-            /** @description Missing acting user or project_id, or invalid input. */
+            /** @description Invalid input. */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -34530,7 +34334,16 @@ export interface operations {
                     "application/json": components["schemas"]["ErrorResponse"];
                 };
             };
-            /** @description Project not found or inaccessible. */
+            /** @description The project's billing blocks new sessions. */
+            402: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Task not found, or not in the given project. */
             404: {
                 headers: {
                     [name: string]: unknown;