roveapi 1.1.0__tar.gz → 1.2.0__tar.gz

{roveapi-1.1.0 → roveapi-1.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: roveapi
-Version: 1.1.0
+Version: 1.2.0
 Summary: Browser automation SDK for AI agents — Playwright-as-a-Service with accessibility trees
 Project-URL: Homepage, https://roveapi.com
 Project-URL: Documentation, https://roveapi.com/docs

{roveapi-1.1.0 → roveapi-1.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "roveapi"
-version = "1.1.0"
+version = "1.2.0"
 description = "Browser automation SDK for AI agents — Playwright-as-a-Service with accessibility trees"
 readme = "README.md"
 license = "MIT"

{roveapi-1.1.0 → roveapi-1.2.0}/src/roveapi/client.py

@@ -107,6 +107,7 @@ class BrowserClient:
         timezone: str | None = None,
         user_agent: str | None = None,
         block_resources: list[str] | None = None,
+        supervised: bool = False,
     ) -> Session:
         """Create a persistent browser session."""
         body: dict[str, Any] = {}
@@ -122,10 +123,74 @@ class BrowserClient:
             body["user_agent"] = user_agent
         if block_resources:
             body["block_resources"] = block_resources
+        if supervised:
+            body["supervised"] = True
 
         data = self._request("POST", "/v1/browser/session", json=body)
         return Session(data["session_id"], self)
 
+    def create_viewer_grant(self, session_id: str) -> dict[str, Any]:
+        """Mint a one-time, origin-bound grant for the public supervised viewer."""
+        from urllib.parse import urlparse
+        origin = f"{urlparse(self.base_url).scheme}://{urlparse(self.base_url).netloc}"
+        data = self._request(
+            "POST",
+            f"/v1/browser/sessions/{session_id}/viewer-grants",
+            json={"origin": origin},
+        )
+        return {
+            "admission_code": data["admission_code"],
+            "expires_in_seconds": data["expires_in_seconds"],
+            "viewer_url": data["viewer_url"],
+            "origin": origin,
+        }
+
+    def exchange_viewer_admission(self, code: str, origin: str) -> dict[str, Any]:
+        """Exchange a one-time admission code for viewer credentials."""
+        # Note: origin header required by the API
+        response = self._client.post(
+            "/viewer-admissions",
+            json={"code": code, "origin": origin},
+            headers={"origin": origin},
+        )
+        if response.is_success:
+            return response.json()
+        raise _map_error(response)
+
+    def transition_viewer_control(
+        self,
+        *,
+        credential: str,
+        origin: str,
+        action: str,  # 'take' | 'resume' | 'return'
+        expected_generation: int,
+    ) -> dict[str, Any]:
+        """Take, resume, or return control of a supervised viewer session."""
+        response = self._client.post(
+            "/viewer-control",
+            json={
+                "credential": credential,
+                "origin": origin,
+                "action": action,
+                "expected_generation": expected_generation,
+            },
+            headers={"origin": origin},
+        )
+        if response.is_success:
+            return response.json()
+        raise _map_error(response)
+
+    def stop_viewer(self, *, credential: str, origin: str) -> dict[str, Any]:
+        """Stop a supervised viewer session."""
+        response = self._client.post(
+            "/viewer-stop",
+            json={"credential": credential, "origin": origin},
+            headers={"origin": origin},
+        )
+        if response.is_success:
+            return response.json()
+        raise _map_error(response)
+
     def screenshot(
         self,
         url: str,