smooth-py 0.3.0.dev20251013__py3-none-any.whl → 0.3.0.post2__py3-none-any.whl

smooth/__init__.py

@@ -82,7 +82,11 @@ class TaskRequest(BaseModel):
     description=("Browser profile ID to use. Each profile maintains its own state, such as cookies and login credentials."),
   )
   profile_read_only: bool = Field(
-    default=False, description="If true, the profile specified by `profile_id` will be loaded in read-only mode."
+    default=False,
+    description=(
+      "If true, the profile specified by `profile_id` will be loaded in read-only mode. "
+      "Changes made during the task will not be saved back to the profile."
+    ),
   )
   stealth_mode: bool = Field(default=False, description="Run the browser in stealth mode.")
   proxy_server: str | None = Field(
@@ -330,6 +334,10 @@ class BrowserSessionHandle(BaseModel):
       return _encode_url(self.browser_session.live_url, interactive=interactive, embed=embed)
     return None
 
+  def live_id(self):
+    """Returns the live ID for the browser session."""
+    return self.browser_session.live_id
+
 
 class TaskHandle:
   """A handle to a running task."""
@@ -393,6 +401,14 @@ class TaskHandle:
       task_response = self._client._get_task(self.id())
       self._task_response = task_response
       if task_response.recording_url is not None:
+        if not task_response.recording_url:
+          raise ApiError(
+            status_code=404,
+            detail=(
+              f"Recording URL not available for task {self.id()}."
+              " Set `enable_recording=True` when creating the task to enable it."
+            )
+          )
         return task_response.recording_url
       time.sleep(1)
     raise TimeoutError(f"Recording URL not available for task {self.id()}.")
@@ -466,7 +482,7 @@ class SmoothClient(BaseClient):
     max_steps: int = 32,
     device: Literal["desktop", "mobile"] = "mobile",
     allowed_urls: list[str] | None = None,
-    enable_recording: bool = False,
+    enable_recording: bool = True,
     session_id: str | None = None,
     profile_id: str | None = None,
     profile_read_only: bool = False,
@@ -486,7 +502,7 @@ class SmoothClient(BaseClient):
         response_model: If provided, the schema describing the desired output structure.
         url: The starting URL for the task. If not provided, the agent will infer it from the task.
         metadata: A dictionary containing variables or parameters that will be passed to the agent.
-        files: A dictionary of file names to their ids. These files will be passed to the agent.
+        files: A list of file ids to pass to the agent.
         agent: The agent to use for the task.
         max_steps: Maximum number of steps the agent can take (max 64).
         device: Device type for the task. Default is mobile.
@@ -577,7 +593,7 @@ class SmoothClient(BaseClient):
         ApiException: If the API request fails.
     """
     try:
-      response = self._session.get(f"{self.base_url}/browser/session")
+      response = self._session.get(f"{self.base_url}/browser/profile")
       data = self._handle_response(response)
       return BrowserProfilesResponse(**data["r"])
     except requests.exceptions.RequestException as e:
@@ -592,7 +608,7 @@ class SmoothClient(BaseClient):
   def delete_profile(self, profile_id: str):
     """Delete a browser profile."""
     try:
-      response = self._session.delete(f"{self.base_url}/browser/session/{profile_id}")
+      response = self._session.delete(f"{self.base_url}/browser/profile/{profile_id}")
       self._handle_response(response)
     except requests.exceptions.RequestException as e:
       logger.error(f"Request failed: {e}")
@@ -686,7 +702,7 @@ class AsyncTaskHandle:
       await asyncio.sleep(poll_interval)
     raise TimeoutError(f"Task {self.id()} did not complete within {timeout} seconds.")
 
-  async def live_url(self, interactive: bool = True, embed: bool = False, timeout: int | None = None):
+  async def live_url(self, interactive: bool = False, embed: bool = False, timeout: int | None = None):
     """Returns the live URL for the task."""
     if self._task_response and self._task_response.live_url:
       return _encode_url(self._task_response.live_url, interactive=interactive, embed=embed)
@@ -695,13 +711,13 @@ class AsyncTaskHandle:
     while timeout is None or (time.time() - start_time) < timeout:
       task_response = await self._client._get_task(self.id())
       self._task_response = task_response
-      if task_response.live_url is not None:
-        return _encode_url(task_response.live_url, interactive=interactive, embed=embed)
+      if self._task_response.live_url:
+        return _encode_url(self._task_response.live_url, interactive=interactive, embed=embed)
       await asyncio.sleep(1)
 
     raise TimeoutError(f"Live URL not available for task {self.id()}.")
 
-  async def recording_url(self, timeout: int | None = None):
+  async def recording_url(self, timeout: int | None = None) -> str:
     """Returns the recording URL for the task."""
     if self._task_response and self._task_response.recording_url is not None:
       return self._task_response.recording_url
@@ -711,6 +727,14 @@ class AsyncTaskHandle:
       task_response = await self._client._get_task(self.id())
       self._task_response = task_response
       if task_response.recording_url is not None:
+        if not task_response.recording_url:
+          raise ApiError(
+            status_code=404,
+            detail=(
+              f"Recording URL not available for task {self.id()}."
+              " Set `enable_recording=True` when creating the task to enable it."
+            )
+          )
         return task_response.recording_url
       await asyncio.sleep(1)
 
@@ -779,7 +803,7 @@ class SmoothAsyncClient(BaseClient):
     max_steps: int = 32,
     device: Literal["desktop", "mobile"] = "mobile",
     allowed_urls: list[str] | None = None,
-    enable_recording: bool = False,
+    enable_recording: bool = True,
     session_id: str | None = None,
     profile_id: str | None = None,
     profile_read_only: bool = False,
@@ -799,7 +823,7 @@ class SmoothAsyncClient(BaseClient):
         response_model: If provided, the schema describing the desired output structure.
         url: The starting URL for the task. If not provided, the agent will infer it from the task.
         metadata: A dictionary containing variables or parameters that will be passed to the agent.
-        files: A dictionary of file names to their url or base64-encoded content to be used by the agent.
+        files: A list of file ids to pass to the agent.
         agent: The agent to use for the task.
         max_steps: Maximum number of steps the agent can take (max 64).
         device: Device type for the task. Default is mobile.
@@ -850,8 +874,8 @@ class SmoothAsyncClient(BaseClient):
     """Opens an interactive browser instance asynchronously.
 
     Args:
+        profile_id: The profile ID to use for the session. If None, a new profile will be created.
         session_id: (Deprecated, now `profile_id`) The session ID to associate with the browser.
-        profile_id: The profile ID to associate with the browser.
         live_view: Whether to enable live view for the session.
 
     Returns:
@@ -890,7 +914,7 @@ class SmoothAsyncClient(BaseClient):
         ApiException: If the API request fails.
     """
     try:
-      response = await self._client.get(f"{self.base_url}/browser/session")
+      response = await self._client.get(f"{self.base_url}/browser/profile")
       data = self._handle_response(response)
       return BrowserProfilesResponse(**data["r"])
     except httpx.RequestError as e:
@@ -905,7 +929,7 @@ class SmoothAsyncClient(BaseClient):
   async def delete_profile(self, profile_id: str):
     """Delete a browser profile."""
     try:
-      response = await self._client.delete(f"{self.base_url}/browser/session/{profile_id}")
+      response = await self._client.delete(f"{self.base_url}/browser/profile/{profile_id}")
       self._handle_response(response)
     except httpx.RequestError as e:
       logger.error(f"Request failed: {e}")
@@ -936,11 +960,12 @@ class SmoothAsyncClient(BaseClient):
       if name is None:
         raise ValueError("File name must be provided or the file object must have a 'name' attribute.")
 
-      files = {"file": (Path(name).name, file)}
       if purpose:
         data = {"file_purpose": purpose}
       else:
         data = None
+
+      files = {"file": (Path(name).name, file)}
       response = await self._client.post(f"{self.base_url}/file", files=files, data=data)
       data = self._handle_response(response)
       return UploadFileResponse(**data["r"])

{smooth_py-0.3.0.dev20251013.dist-info → smooth_py-0.3.0.post2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: smooth-py
-Version: 0.3.0.dev20251013
+Version: 0.3.0.post2
 Summary: 
 Author: Luca Pinchetti
 Author-email: luca@circlemind.co

smooth_py-0.3.0.post2.dist-info/RECORD

@@ -0,0 +1,6 @@
+smooth/__init__.py,sha256=RlpjOBgw2CiLM3kgtOUBdDqslme2Cqge8rXQTV6lUh0,39212
+smooth/mcp/__init__.py,sha256=0aJVFi2a8Ah3-5xtgyZ5UMbaaJsBWu2T8QLWoFQITk8,219
+smooth/mcp/server.py,sha256=9SymTD4NOGTMN8P-LNGlvYNvv81yCIZfZeeuhEcAc6s,20068
+smooth_py-0.3.0.post2.dist-info/METADATA,sha256=Phb1MamNNmlyJ9g1MWGG0FLTG5JKNSIvIURVuI8EqwM,7523
+smooth_py-0.3.0.post2.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
+smooth_py-0.3.0.post2.dist-info/RECORD,,

smooth_py-0.3.0.dev20251013.dist-info/RECORD

@@ -1,6 +0,0 @@
-smooth/__init__.py,sha256=8cuQGi1QbHBbW0dcM9ZyyZL-PrMmAoR3LmLZcqksdJA,38460
-smooth/mcp/__init__.py,sha256=0aJVFi2a8Ah3-5xtgyZ5UMbaaJsBWu2T8QLWoFQITk8,219
-smooth/mcp/server.py,sha256=9SymTD4NOGTMN8P-LNGlvYNvv81yCIZfZeeuhEcAc6s,20068
-smooth_py-0.3.0.dev20251013.dist-info/METADATA,sha256=CJIChVHrQ4YqTk7TioEH-u_4ecw9OurNAw1KAOf3Q1w,7529
-smooth_py-0.3.0.dev20251013.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
-smooth_py-0.3.0.dev20251013.dist-info/RECORD,,