feat: Align Task Filtering by Status with status Field

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 26
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browser-use%2Fbrowser-use-890b9140b139df6307d175ff31cba0bf14d703887bee2f0a8db9f5bffc78e11d.yml
-openapi_spec_hash: 7131a3daffe4f5b67bc1c7ccec06d961
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browser-use%2Fbrowser-use-3a9488448292a0736b08b2d6427e702eaf7106d86345ca2e65b64bed4398b036.yml
+openapi_spec_hash: 5ff2781dcc11a0c9aa353f5cb14bcc16
 config_hash: 9d52be5177b2ede4cb0633c04f4cc4ef

src/resources/tasks.ts

@@ -226,25 +226,18 @@ export class Tasks extends APIResource {
   }
 
   /**
-   * Get a paginated list of all AI agent tasks for the authenticated user.
+   * Get a paginated list of all Browser Use Agent tasks for the authenticated user.
    *
-   * AI agent tasks are the individual jobs that your agents perform within a
-   * session. Each task represents a specific instruction or goal that the agent
+   * Browser Use Agent tasks are the individual jobs that your agents perform within
+   * a session. Each task represents a specific instruction or goal that the agent
    * works on, such as filling out a form, extracting data, or navigating to specific
    * pages.
    *
-   * You can control what data is included for each task:
-   *
-   * - Task steps: Detailed actions the agent took
-   * - User uploaded files: Files you provided for the task
-   * - Output files: Files generated by the agent during the task
-   *
    * Returns:
    *
-   * - A paginated list of agent tasks
-   * - Total count of tasks
+   * - A paginated list of Browser Use Agent tasks
+   * - Total count of Browser Use Agent tasks
    * - Page information for navigation
-   * - Optional detailed data based on your parameters
    */
   list(
     query: TaskListParams | null | undefined = {},
@@ -417,9 +410,10 @@ export interface TaskItemView {
   /**
    * Enumeration of possible task execution states
    *
-   * Attributes: STARTED: Task has been started and is currently running PAUSED: Task
-   * execution has been temporarily paused (can be resumed) STOPPED: Task execution
-   * has been stopped (cannot be resumed) FINISHED: Task has completed successfully
+   * Attributes: STARTED: Task has been started and is currently running. PAUSED:
+   * Task execution has been temporarily paused (can be resumed) FINISHED: Task has
+   * finished and the agent has completed the task. STOPPED: Task execution has been
+   * manually stopped (cannot be resumed).
    */
   status: TaskStatus;
 
@@ -439,11 +433,12 @@ export interface TaskItemView {
 /**
  * Enumeration of possible task execution states
  *
- * Attributes: STARTED: Task has been started and is currently running PAUSED: Task
- * execution has been temporarily paused (can be resumed) STOPPED: Task execution
- * has been stopped (cannot be resumed) FINISHED: Task has completed successfully
+ * Attributes: STARTED: Task has been started and is currently running. PAUSED:
+ * Task execution has been temporarily paused (can be resumed) FINISHED: Task has
+ * finished and the agent has completed the task. STOPPED: Task execution has been
+ * manually stopped (cannot be resumed).
  */
-export type TaskStatus = 'started' | 'paused' | 'stopped' | 'finished';
+export type TaskStatus = 'started' | 'paused' | 'finished' | 'stopped';
 
 /**
  * View model for representing a single step in a task's execution
@@ -514,9 +509,10 @@ export interface TaskView {
   /**
    * Enumeration of possible task execution states
    *
-   * Attributes: STARTED: Task has been started and is currently running PAUSED: Task
-   * execution has been temporarily paused (can be resumed) STOPPED: Task execution
-   * has been stopped (cannot be resumed) FINISHED: Task has completed successfully
+   * Attributes: STARTED: Task has been started and is currently running. PAUSED:
+   * Task execution has been temporarily paused (can be resumed) FINISHED: Task has
+   * finished and the agent has completed the task. STOPPED: Task execution has been
+   * manually stopped (cannot be resumed).
    */
   status: TaskStatus;
 
@@ -701,14 +697,19 @@ export interface TaskUpdateParams {
 }
 
 export interface TaskListParams {
+  after?: string | null;
+
+  before?: string | null;
+
   /**
-   * Enumeration of possible task filters
+   * Enumeration of possible task execution states
    *
-   * Attributes: STARTED: All started tasks PAUSED: All paused tasks STOPPED: All
-   * stopped tasks FINISHED: All finished tasks SUCCESSFUL: All successful tasks
-   * UNSUCCESSFUL: All unsuccessful tasks
+   * Attributes: STARTED: Task has been started and is currently running. PAUSED:
+   * Task execution has been temporarily paused (can be resumed) FINISHED: Task has
+   * finished and the agent has completed the task. STOPPED: Task execution has been
+   * manually stopped (cannot be resumed).
    */
-  filterBy?: 'started' | 'paused' | 'stopped' | 'finished' | 'successful' | 'unsuccessful' | null;
+  filterBy?: TaskStatus | null;
 
   pageNumber?: number;
 

tests/api-resources/tasks.test.ts

@@ -87,6 +87,8 @@ describe('resource tasks', () => {
     await expect(
       client.tasks.list(
         {
+          after: '2019-12-27T18:11:19.117Z',
+          before: '2019-12-27T18:11:19.117Z',
           filterBy: 'started',
           pageNumber: 1,
           pageSize: 1,