chaser-sdk 0.1.0__tar.gz

chaser_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,132 @@
+Metadata-Version: 2.4
+Name: chaser-sdk
+Version: 0.1.0
+Summary: Official Python SDK for Chaser
+Author: Chaser Team
+Keywords: chaser,sandbox,browser,microvm,automation
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Provides-Extra: cdp
+Requires-Dist: websocket-client>=1.8.0; extra == "cdp"
+
+# chaser-sdk
+
+Official Python SDK for Chaser.
+
+This package is the Python **beta** SDK for the core public Chaser surface:
+
+- sessions
+- workspaces
+- exec
+- command lifecycle
+- files
+- browser CDP helpers
+- accounts and organizations
+- service accounts and keys
+- billing
+- lifecycle webhooks
+- audit
+- jobs
+
+## Installation
+
+```bash
+pip install chaser-sdk
+```
+
+Optional CDP websocket support:
+
+```bash
+pip install 'chaser-sdk[cdp]'
+```
+
+## Quickstart
+
+```py
+from chaser_sdk import ChaserClient
+
+client = ChaserClient(api_key="sk_...", account="personal")
+
+workspace = client.workspaces.create(
+    {
+        "name": "frontend-app",
+        "session_type": "sandbox",
+        "image": "ghcr.io/example/dev:latest",
+    }
+)
+
+session = client.sessions.create(
+    {
+        "workspace": workspace["name"],
+        "session_type": "sandbox",
+    }
+)
+
+client.sessions.wait_until_ready(session["id"])
+result = client.exec.in_session(
+    session["id"],
+    {
+        "command": "node -v && pwd",
+        "cwd": "/workspace",
+    },
+)
+
+print(result.get("output"))
+```
+
+## Stateless exec
+
+```py
+result = client.exec.run(
+    {
+        "ephemeral": True,
+        "image": "node:20-bookworm",
+        "command": "python3 -c 'print(42)'",
+    }
+)
+```
+
+## Files and previews
+
+```py
+client.files.upload_text(session["id"], "/workspace/hello.txt", "hello from sdk")
+text = client.files.download_text(session["id"], "/workspace/hello.txt")
+preview = client.sessions.forward_url(session["id"], 3000)
+```
+
+## Browser CDP helper
+
+```py
+browser = client.sessions.create({"session_type": "browser", "ephemeral": True})
+ws_url = client.browser.cdp_websocket_url(browser["id"])
+print(ws_url)
+```
+
+If you install the optional `cdp` extra, you can also open a lightweight websocket client:
+
+```py
+cdp = client.browser.connect(browser["id"])
+print(cdp.send("Browser.getVersion"))
+cdp.close()
+```
+
+## Organization automation
+
+```py
+org_client = client.with_account("Acme Engineering")
+service_account = org_client.accounts.service_accounts.create("ci-bot")
+key = org_client.accounts.service_accounts.keys.create(
+    service_account["id"],
+    name="ci-key",
+    scopes=["sessions.read", "workspaces.write", "exec.write", "files.read", "webhooks.write"],
+)
+print(key["key"])
+```

chaser_sdk-0.1.0/README.md

@@ -0,0 +1,113 @@
+# chaser-sdk
+
+Official Python SDK for Chaser.
+
+This package is the Python **beta** SDK for the core public Chaser surface:
+
+- sessions
+- workspaces
+- exec
+- command lifecycle
+- files
+- browser CDP helpers
+- accounts and organizations
+- service accounts and keys
+- billing
+- lifecycle webhooks
+- audit
+- jobs
+
+## Installation
+
+```bash
+pip install chaser-sdk
+```
+
+Optional CDP websocket support:
+
+```bash
+pip install 'chaser-sdk[cdp]'
+```
+
+## Quickstart
+
+```py
+from chaser_sdk import ChaserClient
+
+client = ChaserClient(api_key="sk_...", account="personal")
+
+workspace = client.workspaces.create(
+    {
+        "name": "frontend-app",
+        "session_type": "sandbox",
+        "image": "ghcr.io/example/dev:latest",
+    }
+)
+
+session = client.sessions.create(
+    {
+        "workspace": workspace["name"],
+        "session_type": "sandbox",
+    }
+)
+
+client.sessions.wait_until_ready(session["id"])
+result = client.exec.in_session(
+    session["id"],
+    {
+        "command": "node -v && pwd",
+        "cwd": "/workspace",
+    },
+)
+
+print(result.get("output"))
+```
+
+## Stateless exec
+
+```py
+result = client.exec.run(
+    {
+        "ephemeral": True,
+        "image": "node:20-bookworm",
+        "command": "python3 -c 'print(42)'",
+    }
+)
+```
+
+## Files and previews
+
+```py
+client.files.upload_text(session["id"], "/workspace/hello.txt", "hello from sdk")
+text = client.files.download_text(session["id"], "/workspace/hello.txt")
+preview = client.sessions.forward_url(session["id"], 3000)
+```
+
+## Browser CDP helper
+
+```py
+browser = client.sessions.create({"session_type": "browser", "ephemeral": True})
+ws_url = client.browser.cdp_websocket_url(browser["id"])
+print(ws_url)
+```
+
+If you install the optional `cdp` extra, you can also open a lightweight websocket client:
+
+```py
+cdp = client.browser.connect(browser["id"])
+print(cdp.send("Browser.getVersion"))
+cdp.close()
+```
+
+## Organization automation
+
+```py
+org_client = client.with_account("Acme Engineering")
+service_account = org_client.accounts.service_accounts.create("ci-bot")
+key = org_client.accounts.service_accounts.keys.create(
+    service_account["id"],
+    name="ci-key",
+    scopes=["sessions.read", "workspaces.write", "exec.write", "files.read", "webhooks.write"],
+)
+print(key["key"])
+```

chaser_sdk-0.1.0/chaser_sdk/__init__.py

@@ -0,0 +1,11 @@
+from .cdp import CdpClient
+from .client import ChaserClient
+from .errors import ChaserApiError, ChaserTimeoutError, RateLimitMetadata
+
+__all__ = [
+    "CdpClient",
+    "ChaserApiError",
+    "ChaserClient",
+    "ChaserTimeoutError",
+    "RateLimitMetadata",
+]

chaser_sdk-0.1.0/chaser_sdk/cdp.py

@@ -0,0 +1,54 @@
+from __future__ import annotations
+
+import json
+from dataclasses import dataclass, field
+from typing import Any
+
+
+@dataclass(slots=True)
+class CdpClient:
+    websocket_url: str
+    _socket: Any = field(default=None, init=False, repr=False)
+    _next_id: int = field(default=1, init=False, repr=False)
+
+    def connect(self) -> None:
+        if self._socket is not None:
+            return
+        try:
+            import websocket  # type: ignore
+        except ImportError as exc:
+            raise RuntimeError(
+                "CDP websocket support requires the optional 'websocket-client' dependency. "
+                "Install with: pip install chaser-sdk[cdp]"
+            ) from exc
+
+        self._socket = websocket.create_connection(self.websocket_url)
+
+    def close(self) -> None:
+        if self._socket is not None:
+            self._socket.close()
+            self._socket = None
+
+    def send(self, method: str, params: dict[str, Any] | None = None, session_id: str | None = None) -> Any:
+        if self._socket is None:
+            raise RuntimeError("CDP websocket is not connected")
+
+        message = {
+            "id": self._next_id,
+            "method": method,
+            "params": params or {},
+        }
+        if session_id:
+            message["sessionId"] = session_id
+        request_id = self._next_id
+        self._next_id += 1
+
+        self._socket.send(json.dumps(message))
+        while True:
+            raw = self._socket.recv()
+            payload = json.loads(raw)
+            if payload.get("id") != request_id:
+                continue
+            if "error" in payload:
+                raise RuntimeError(payload["error"].get("message", "CDP request failed"))
+            return payload.get("result")