feat: Add start_url

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-758a1c052b93e7e478fa650c1748f4b466653f44cb26f97fef1314c7a96924df.yml
-openapi_spec_hash: 9e0e99b613f2b9bf3993ac36aa0c7911
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browser-use%2Fbrowser-use-890b9140b139df6307d175ff31cba0bf14d703887bee2f0a8db9f5bffc78e11d.yml
+openapi_spec_hash: 7131a3daffe4f5b67bc1c7ccec06d961
 config_hash: 9d52be5177b2ede4cb0633c04f4cc4ef

src/resources/tasks.ts

@@ -501,9 +501,9 @@ export interface TaskView {
    * View model for representing a session that a task belongs to
    *
    * Attributes: id: Unique identifier for the session status: Current status of the
-   * session live_url: URL where the browser can be viewed live in real-time.
-   * started_at: Timestamp when the session was created and started. finished_at:
-   * Timestamp when the session was stopped (None if still active).
+   * session (active/stopped) live_url: URL where the browser can be viewed live in
+   * real-time. started_at: Timestamp when the session was created and started.
+   * finished_at: Timestamp when the session was stopped (None if still active).
    */
   session: TaskView.Session;
 
@@ -542,9 +542,9 @@ export namespace TaskView {
    * View model for representing a session that a task belongs to
    *
    * Attributes: id: Unique identifier for the session status: Current status of the
-   * session live_url: URL where the browser can be viewed live in real-time.
-   * started_at: Timestamp when the session was created and started. finished_at:
-   * Timestamp when the session was stopped (None if still active).
+   * session (active/stopped) live_url: URL where the browser can be viewed live in
+   * real-time. started_at: Timestamp when the session was created and started.
+   * finished_at: Timestamp when the session was stopped (None if still active).
    */
   export interface Session {
     id: string;
@@ -633,19 +633,20 @@ export interface TaskCreateParams {
   task: string;
 
   /**
-   * Configuration settings for the AI agent
+   * Configuration settings for the agent
    *
-   * Attributes: llm: The LLM model to use for the agent profile_id: Unique
-   * identifier of the agent profile to use for the task
+   * Attributes: llm: The LLM model to use for the agent start_url: Optional URL to
+   * start the agent on (will not be changed as a step) profile_id: Unique identifier
+   * of the agent profile to use for the task
    */
   agentSettings?: TaskCreateParams.AgentSettings;
 
   /**
    * Configuration settings for the browser session
    *
    * Attributes: session_id: Unique identifier of existing session to continue
-   * profile_id: Unique identifier of browser profile to use save_browser_data:
-   * Whether to save browser state/data for the user to download later
+   * profile_id: Unique identifier of browser profile to use (use if you want to
+   * start a new session)
    */
   browserSettings?: TaskCreateParams.BrowserSettings;
 
@@ -660,29 +661,30 @@ export interface TaskCreateParams {
 
 export namespace TaskCreateParams {
   /**
-   * Configuration settings for the AI agent
+   * Configuration settings for the agent
    *
-   * Attributes: llm: The LLM model to use for the agent profile_id: Unique
-   * identifier of the agent profile to use for the task
+   * Attributes: llm: The LLM model to use for the agent start_url: Optional URL to
+   * start the agent on (will not be changed as a step) profile_id: Unique identifier
+   * of the agent profile to use for the task
    */
   export interface AgentSettings {
     llm?: TasksAPI.LlmModel;
 
     profileId?: string | null;
+
+    startUrl?: string | null;
   }
 
   /**
    * Configuration settings for the browser session
    *
    * Attributes: session_id: Unique identifier of existing session to continue
-   * profile_id: Unique identifier of browser profile to use save_browser_data:
-   * Whether to save browser state/data for the user to download later
+   * profile_id: Unique identifier of browser profile to use (use if you want to
+   * start a new session)
    */
   export interface BrowserSettings {
     profileId?: string | null;
 
-    saveBrowserData?: boolean;
-
     sessionId?: string | null;
   }
 }

tests/api-resources/tasks.test.ts

@@ -24,10 +24,13 @@ describe('resource tasks', () => {
   test.skip('create: required and optional params', async () => {
     const response = await client.tasks.create({
       task: 'x',
-      agentSettings: { llm: 'gpt-4o', profileId: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e' },
+      agentSettings: {
+        llm: 'gpt-4o',
+        profileId: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+        startUrl: 'startUrl',
+      },
       browserSettings: {
         profileId: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
-        saveBrowserData: true,
         sessionId: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
       },
       includedFileNames: ['string'],