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/browser_use_sdk/resources/tasks.py

@@ -113,16 +113,17 @@ def create(
         - 400: If session is stopped or already has a running task
 
         Args:
-          agent_settings: Configuration settings for the AI agent
+          agent_settings: 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
 
           browser_settings: 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)
 
           extra_headers: Send extra headers
 
@@ -610,16 +611,17 @@ async def create(
         - 400: If session is stopped or already has a running task
 
         Args:
-          agent_settings: Configuration settings for the AI agent
+          agent_settings: 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
 
           browser_settings: 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)
 
           extra_headers: Send extra headers
 

src/browser_use_sdk/types/task_create_params.py

@@ -15,18 +15,19 @@ class TaskCreateParams(TypedDict, total=False):
     task: Required[str]
 
     agent_settings: Annotated[AgentSettings, PropertyInfo(alias="agentSettings")]
-    """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
     """
 
     browser_settings: Annotated[BrowserSettings, PropertyInfo(alias="browserSettings")]
     """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)
     """
 
     included_file_names: Annotated[Optional[List[str]], PropertyInfo(alias="includedFileNames")]
@@ -43,10 +44,10 @@ class AgentSettings(TypedDict, total=False):
 
     profile_id: Annotated[Optional[str], PropertyInfo(alias="profileId")]
 
+    start_url: Annotated[Optional[str], PropertyInfo(alias="startUrl")]
+
 
 class BrowserSettings(TypedDict, total=False):
     profile_id: Annotated[Optional[str], PropertyInfo(alias="profileId")]
 
-    save_browser_data: Annotated[bool, PropertyInfo(alias="saveBrowserData")]
-
     session_id: Annotated[Optional[str], PropertyInfo(alias="sessionId")]

src/browser_use_sdk/types/task_view.py

@@ -45,9 +45,9 @@ class TaskView(BaseModel):
     """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_id: str = FieldInfo(alias="sessionId")

tests/api_resources/test_tasks.py

@@ -40,10 +40,10 @@ def test_method_create_with_all_params(self, client: BrowserUse) -> None:
             agent_settings={
                 "llm": "gpt-4o",
                 "profile_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
+                "start_url": "startUrl",
             },
             browser_settings={
                 "profile_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
-                "save_browser_data": True,
                 "session_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
             },
             included_file_names=["string"],
@@ -374,10 +374,10 @@ async def test_method_create_with_all_params(self, async_client: AsyncBrowserUse
             agent_settings={
                 "llm": "gpt-4o",
                 "profile_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
+                "start_url": "startUrl",
             },
             browser_settings={
                 "profile_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
-                "save_browser_data": True,
                 "session_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
             },
             included_file_names=["string"],