anchorbrowser 0.1.0a1__tar.gz → 0.1.0a3__tar.gz

{anchorbrowser-0.1.0a1 → anchorbrowser-0.1.0a3}/.gitignore

@@ -1,5 +1,4 @@
 .prism.log
-.vscode
 _dev
 
 __pycache__

anchorbrowser-0.1.0a3/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.1.0-alpha.3"
+}

{anchorbrowser-0.1.0a1 → anchorbrowser-0.1.0a3}/CHANGELOG.md

@@ -1,5 +1,31 @@
 # Changelog
 
+## 0.1.0-alpha.3 (2025-07-25)
+
+Full Changelog: [v0.1.0-alpha.2...v0.1.0-alpha.3](https://github.com/anchorbrowser/AnchorBrowser-SDK-Python/compare/v0.1.0-alpha.2...v0.1.0-alpha.3)
+
+### Chores
+
+* **project:** add settings file for vscode ([700d561](https://github.com/anchorbrowser/AnchorBrowser-SDK-Python/commit/700d5613b0d22d41afa095b4dc4e62d8cfb822ae))
+
+## 0.1.0-alpha.2 (2025-07-23)
+
+Full Changelog: [v0.1.0-alpha.1...v0.1.0-alpha.2](https://github.com/anchorbrowser/AnchorBrowser-SDK-Python/compare/v0.1.0-alpha.1...v0.1.0-alpha.2)
+
+### Features
+
+* **agent:** add Agent and Browser resources for AI task execution ([36eab12](https://github.com/anchorbrowser/AnchorBrowser-SDK-Python/commit/36eab12a4d3ea747a6f863c3c43cc51a03461ba4))
+
+
+### Bug Fixes
+
+* **parsing:** parse extra field types ([0348a34](https://github.com/anchorbrowser/AnchorBrowser-SDK-Python/commit/0348a34079f2fc5ecf9ad5d5eaf1fed486d0263c))
+
+
+### Refactors
+
+* add type hints to agent and browser resource methods for improved clarity ([047d45c](https://github.com/anchorbrowser/AnchorBrowser-SDK-Python/commit/047d45c79efd205353f21b9ec6d9960d332ddc94))
+
 ## 0.1.0-alpha.1 (2025-07-22)
 
 Full Changelog: [v0.0.1-alpha.0...v0.1.0-alpha.1](https://github.com/anchorbrowser/AnchorBrowser-SDK-Python/compare/v0.0.1-alpha.0...v0.1.0-alpha.1)

{anchorbrowser-0.1.0a1 → anchorbrowser-0.1.0a3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: anchorbrowser
-Version: 0.1.0a1
+Version: 0.1.0a3
 Summary: The official Python library for the anchorbrowser API
 Project-URL: Homepage, https://github.com/anchorbrowser/AnchorBrowser-SDK-Python
 Project-URL: Repository, https://github.com/anchorbrowser/AnchorBrowser-SDK-Python
@@ -26,8 +26,10 @@ Requires-Dist: anyio<5,>=3.5.0
 Requires-Dist: distro<2,>=1.7.0
 Requires-Dist: httpx<1,>=0.23.0
 Requires-Dist: pydantic<3,>=1.9.0
+Requires-Dist: pytest-playwright
 Requires-Dist: sniffio
 Requires-Dist: typing-extensions<5,>=4.10
+Requires-Dist: websockets
 Provides-Extra: aiohttp
 Requires-Dist: aiohttp; extra == 'aiohttp'
 Requires-Dist: httpx-aiohttp>=0.1.8; extra == 'aiohttp'

{anchorbrowser-0.1.0a1 → anchorbrowser-0.1.0a3}/pyproject.toml

@@ -1,19 +1,19 @@
 [project]
 name = "anchorbrowser"
-version = "0.1.0-alpha.1"
+version = "0.1.0-alpha.3"
 description = "The official Python library for the anchorbrowser API"
 dynamic = ["readme"]
 license = "Apache-2.0"
-authors = [
-{ name = "Anchorbrowser", email = "support@anchorbrowser.io" },
-]
+authors = [{ name = "Anchorbrowser", email = "support@anchorbrowser.io" }]
 dependencies = [
-    "httpx>=0.23.0, <1",
-    "pydantic>=1.9.0, <3",
-    "typing-extensions>=4.10, <5",
-    "anyio>=3.5.0, <5",
-    "distro>=1.7.0, <2",
-    "sniffio",
+  "httpx>=0.23.0, <1",
+  "pydantic>=1.9.0, <3",
+  "typing-extensions>=4.10, <5",
+  "anyio>=3.5.0, <5",
+  "distro>=1.7.0, <2",
+  "sniffio",
+  "pytest-playwright",
+  "websockets",
 ]
 requires-python = ">= 3.8"
 classifiers = [
@@ -31,7 +31,7 @@ classifiers = [
   "Operating System :: POSIX :: Linux",
   "Operating System :: Microsoft :: Windows",
   "Topic :: Software Development :: Libraries :: Python Modules",
-  "License :: OSI Approved :: Apache Software License"
+  "License :: OSI Approved :: Apache Software License",
 ]
 
 [project.urls]
@@ -45,19 +45,19 @@ aiohttp = ["aiohttp", "httpx_aiohttp>=0.1.8"]
 managed = true
 # version pins are in requirements-dev.lock
 dev-dependencies = [
-    "pyright==1.1.399",
-    "mypy",
-    "respx",
-    "pytest",
-    "pytest-asyncio",
-    "ruff",
-    "time-machine",
-    "nox",
-    "dirty-equals>=0.6.0",
-    "importlib-metadata>=6.7.0",
-    "rich>=13.7.1",
-    "nest_asyncio==1.6.0",
-    "pytest-xdist>=3.6.1",
+  "pyright==1.1.399",
+  "mypy",
+  "respx",
+  "pytest",
+  "pytest-asyncio",
+  "ruff",
+  "time-machine",
+  "nox",
+  "dirty-equals>=0.6.0",
+  "importlib-metadata>=6.7.0",
+  "rich>=13.7.1",
+  "nest_asyncio==1.6.0",
+  "pytest-xdist>=3.6.1",
 ]
 
 [tool.rye.scripts]
@@ -67,24 +67,17 @@ format = { chain = [
   "fix:ruff",
   # run formatting again to fix any inconsistencies when imports are stripped
   "format:ruff",
-]}
+] }
 "format:docs" = "python scripts/utils/ruffen-docs.py README.md api.md"
 "format:ruff" = "ruff format"
 
-"lint" = { chain = [
-  "check:ruff",
-  "typecheck",
-  "check:importable",
-]}
+"lint" = { chain = ["check:ruff", "typecheck", "check:importable"] }
 "check:ruff" = "ruff check ."
 "fix:ruff" = "ruff check --fix ."
 
 "check:importable" = "python -c 'import anchorbrowser'"
 
-typecheck = { chain = [
-  "typecheck:pyright",
-  "typecheck:mypy"
-]}
+typecheck = { chain = ["typecheck:pyright", "typecheck:mypy"] }
 "typecheck:pyright" = "pyright"
 "typecheck:verify-types" = "pyright --verifytypes anchorbrowser --ignoreexternal"
 "typecheck:mypy" = "mypy ."
@@ -94,9 +87,7 @@ requires = ["hatchling==1.26.3", "hatch-fancy-pypi-readme"]
 build-backend = "hatchling.build"
 
 [tool.hatch.build]
-include = [
-  "src/*"
-]
+include = ["src/*"]
 
 [tool.hatch.build.targets.wheel]
 packages = ["src/anchorbrowser"]
@@ -133,9 +124,7 @@ addopts = "--tb=short -n auto"
 xfail_strict = true
 asyncio_mode = "auto"
 asyncio_default_fixture_loop_scope = "session"
-filterwarnings = [
-  "error"
-]
+filterwarnings = ["error"]
 
 [tool.pyright]
 # this enables practically every flag given by pyright.
@@ -144,11 +133,7 @@ filterwarnings = [
 typeCheckingMode = "strict"
 pythonVersion = "3.8"
 
-exclude = [
-    "_dev",
-    ".venv",
-    ".nox",
-]
+exclude = ["_dev", ".venv", ".nox"]
 
 reportImplicitOverride = true
 reportOverlappingOverload = false

{anchorbrowser-0.1.0a1 → anchorbrowser-0.1.0a3}/requirements-dev.lock

@@ -31,6 +31,9 @@ attrs==25.3.0
 certifi==2023.7.22
     # via httpcore
     # via httpx
+    # via requests
+charset-normalizer==3.4.2
+    # via requests
 colorlog==6.7.0
     # via nox
 dirty-equals==0.6.0
@@ -48,6 +51,8 @@ filelock==3.12.4
 frozenlist==1.6.2
     # via aiohttp
     # via aiosignal
+greenlet==3.2.3
+    # via playwright
 h11==0.16.0
     # via httpcore
 httpcore==1.0.9
@@ -61,6 +66,7 @@ httpx-aiohttp==0.1.8
 idna==3.4
     # via anyio
     # via httpx
+    # via requests
     # via yarl
 importlib-metadata==7.0.0
 iniconfig==2.0.0
@@ -84,6 +90,8 @@ packaging==23.2
     # via pytest
 platformdirs==3.11.0
     # via virtualenv
+playwright==1.53.0
+    # via pytest-playwright
 pluggy==1.5.0
     # via pytest
 propcache==0.3.1
@@ -93,18 +101,30 @@ pydantic==2.10.3
     # via anchorbrowser
 pydantic-core==2.27.1
     # via pydantic
+pyee==13.0.0
+    # via playwright
 pygments==2.18.0
     # via rich
 pyright==1.1.399
 pytest==8.3.3
     # via pytest-asyncio
+    # via pytest-base-url
+    # via pytest-playwright
     # via pytest-xdist
 pytest-asyncio==0.24.0
+pytest-base-url==2.1.0
+    # via pytest-playwright
+pytest-playwright==0.7.0
+    # via anchorbrowser
 pytest-xdist==3.7.0
 python-dateutil==2.8.2
     # via time-machine
+python-slugify==8.0.4
+    # via pytest-playwright
 pytz==2023.3.post1
     # via dirty-equals
+requests==2.32.4
+    # via pytest-base-url
 respx==0.22.0
 rich==13.7.1
 ruff==0.9.4
@@ -115,6 +135,8 @@ six==1.16.0
 sniffio==1.3.0
     # via anchorbrowser
     # via anyio
+text-unidecode==1.3
+    # via python-slugify
 time-machine==2.9.0
 tomli==2.0.2
     # via mypy
@@ -126,9 +148,14 @@ typing-extensions==4.12.2
     # via mypy
     # via pydantic
     # via pydantic-core
+    # via pyee
     # via pyright
+urllib3==2.5.0
+    # via requests
 virtualenv==20.24.5
     # via nox
+websockets==15.0.1
+    # via anchorbrowser
 yarl==1.20.0
     # via aiohttp
 zipp==3.17.0

{anchorbrowser-0.1.0a1 → anchorbrowser-0.1.0a3}/requirements.lock

@@ -29,13 +29,19 @@ attrs==25.3.0
 certifi==2023.7.22
     # via httpcore
     # via httpx
+    # via requests
+charset-normalizer==3.4.2
+    # via requests
 distro==1.8.0
     # via anchorbrowser
 exceptiongroup==1.2.2
     # via anyio
+    # via pytest
 frozenlist==1.6.2
     # via aiohttp
     # via aiosignal
+greenlet==3.2.3
+    # via playwright
 h11==0.16.0
     # via httpcore
 httpcore==1.0.9
@@ -48,10 +54,19 @@ httpx-aiohttp==0.1.8
 idna==3.4
     # via anyio
     # via httpx
+    # via requests
     # via yarl
+iniconfig==2.1.0
+    # via pytest
 multidict==6.4.4
     # via aiohttp
     # via yarl
+packaging==25.0
+    # via pytest
+playwright==1.53.0
+    # via pytest-playwright
+pluggy==1.6.0
+    # via pytest
 propcache==0.3.1
     # via aiohttp
     # via yarl
@@ -59,14 +74,38 @@ pydantic==2.10.3
     # via anchorbrowser
 pydantic-core==2.27.1
     # via pydantic
+pyee==13.0.0
+    # via playwright
+pygments==2.19.2
+    # via pytest
+pytest==8.4.1
+    # via pytest-base-url
+    # via pytest-playwright
+pytest-base-url==2.1.0
+    # via pytest-playwright
+pytest-playwright==0.7.0
+    # via anchorbrowser
+python-slugify==8.0.4
+    # via pytest-playwright
+requests==2.32.4
+    # via pytest-base-url
 sniffio==1.3.0
     # via anchorbrowser
     # via anyio
+text-unidecode==1.3
+    # via python-slugify
+tomli==2.2.1
+    # via pytest
 typing-extensions==4.12.2
     # via anchorbrowser
     # via anyio
     # via multidict
     # via pydantic
     # via pydantic-core
+    # via pyee
+urllib3==2.5.0
+    # via requests
+websockets==15.0.1
+    # via anchorbrowser
 yarl==1.20.0
     # via aiohttp

{anchorbrowser-0.1.0a1 → anchorbrowser-0.1.0a3}/src/anchorbrowser/_client.py

@@ -21,7 +21,7 @@ from ._types import (
 )
 from ._utils import is_given, get_async_library
 from ._version import __version__
-from .resources import tools, profiles, extensions
+from .resources import agent, tools, browser, profiles, extensions
 from ._streaming import Stream as Stream, AsyncStream as AsyncStream
 from ._exceptions import APIStatusError, AnchorbrowserError
 from ._base_client import (
@@ -48,6 +48,8 @@ class Anchorbrowser(SyncAPIClient):
     sessions: sessions.SessionsResource
     tools: tools.ToolsResource
     extensions: extensions.ExtensionsResource
+    browser: browser.BrowserResource
+    agent: agent.AgentResource
     with_raw_response: AnchorbrowserWithRawResponse
     with_streaming_response: AnchorbrowserWithStreamedResponse
 
@@ -109,6 +111,8 @@ class Anchorbrowser(SyncAPIClient):
         self.sessions = sessions.SessionsResource(self)
         self.tools = tools.ToolsResource(self)
         self.extensions = extensions.ExtensionsResource(self)
+        self.browser = browser.BrowserResource(self)
+        self.agent = agent.AgentResource(self)
         self.with_raw_response = AnchorbrowserWithRawResponse(self)
         self.with_streaming_response = AnchorbrowserWithStreamedResponse(self)
 
@@ -222,6 +226,8 @@ class AsyncAnchorbrowser(AsyncAPIClient):
     sessions: sessions.AsyncSessionsResource
     tools: tools.AsyncToolsResource
     extensions: extensions.AsyncExtensionsResource
+    browser: browser.AsyncBrowserResource
+    agent: agent.AsyncAgentResource
     with_raw_response: AsyncAnchorbrowserWithRawResponse
     with_streaming_response: AsyncAnchorbrowserWithStreamedResponse
 
@@ -283,6 +289,8 @@ class AsyncAnchorbrowser(AsyncAPIClient):
         self.sessions = sessions.AsyncSessionsResource(self)
         self.tools = tools.AsyncToolsResource(self)
         self.extensions = extensions.AsyncExtensionsResource(self)
+        self.browser = browser.AsyncBrowserResource(self)
+        self.agent = agent.AsyncAgentResource(self)
         self.with_raw_response = AsyncAnchorbrowserWithRawResponse(self)
         self.with_streaming_response = AsyncAnchorbrowserWithStreamedResponse(self)
 
@@ -397,7 +405,8 @@ class AnchorbrowserWithRawResponse:
         self.sessions = sessions.SessionsResourceWithRawResponse(client.sessions)
         self.tools = tools.ToolsResourceWithRawResponse(client.tools)
         self.extensions = extensions.ExtensionsResourceWithRawResponse(client.extensions)
-
+        self.browser = browser.BrowserResourceWithRawResponse(client.browser)
+        self.agent = agent.AgentResourceWithRawResponse(client.agent)
 
 class AsyncAnchorbrowserWithRawResponse:
     def __init__(self, client: AsyncAnchorbrowser) -> None:
@@ -405,7 +414,8 @@ class AsyncAnchorbrowserWithRawResponse:
         self.sessions = sessions.AsyncSessionsResourceWithRawResponse(client.sessions)
         self.tools = tools.AsyncToolsResourceWithRawResponse(client.tools)
         self.extensions = extensions.AsyncExtensionsResourceWithRawResponse(client.extensions)
-
+        self.browser = browser.AsyncBrowserResourceWithRawResponse(client.browser)
+        self.agent = agent.AsyncAgentResourceWithRawResponse(client.agent)
 
 class AnchorbrowserWithStreamedResponse:
     def __init__(self, client: Anchorbrowser) -> None:
@@ -413,7 +423,8 @@ class AnchorbrowserWithStreamedResponse:
         self.sessions = sessions.SessionsResourceWithStreamingResponse(client.sessions)
         self.tools = tools.ToolsResourceWithStreamingResponse(client.tools)
         self.extensions = extensions.ExtensionsResourceWithStreamingResponse(client.extensions)
-
+        self.browser = browser.BrowserResourceWithStreamingResponse(client.browser)
+        self.agent = agent.AgentResourceWithStreamingResponse(client.agent)
 
 class AsyncAnchorbrowserWithStreamedResponse:
     def __init__(self, client: AsyncAnchorbrowser) -> None:
@@ -421,7 +432,8 @@ class AsyncAnchorbrowserWithStreamedResponse:
         self.sessions = sessions.AsyncSessionsResourceWithStreamingResponse(client.sessions)
         self.tools = tools.AsyncToolsResourceWithStreamingResponse(client.tools)
         self.extensions = extensions.AsyncExtensionsResourceWithStreamingResponse(client.extensions)
-
+        self.browser = browser.AsyncBrowserResourceWithStreamingResponse(client.browser)
+        self.agent = agent.AsyncAgentResourceWithStreamingResponse(client.agent)
 
 Client = Anchorbrowser
 

{anchorbrowser-0.1.0a1 → anchorbrowser-0.1.0a3}/src/anchorbrowser/_models.py

@@ -208,14 +208,18 @@ class BaseModel(pydantic.BaseModel):
             else:
                 fields_values[name] = field_get_default(field)
 
+        extra_field_type = _get_extra_fields_type(__cls)
+
         _extra = {}
         for key, value in values.items():
             if key not in model_fields:
+                parsed = construct_type(value=value, type_=extra_field_type) if extra_field_type is not None else value
+
                 if PYDANTIC_V2:
-                    _extra[key] = value
+                    _extra[key] = parsed
                 else:
                     _fields_set.add(key)
-                    fields_values[key] = value
+                    fields_values[key] = parsed
 
         object.__setattr__(m, "__dict__", fields_values)
 
@@ -370,6 +374,23 @@ def _construct_field(value: object, field: FieldInfo, key: str) -> object:
     return construct_type(value=value, type_=type_, metadata=getattr(field, "metadata", None))
 
 
+def _get_extra_fields_type(cls: type[pydantic.BaseModel]) -> type | None:
+    if not PYDANTIC_V2:
+        # TODO
+        return None
+
+    schema = cls.__pydantic_core_schema__
+    if schema["type"] == "model":
+        fields = schema["schema"]
+        if fields["type"] == "model-fields":
+            extras = fields.get("extras_schema")
+            if extras and "cls" in extras:
+                # mypy can't narrow the type
+                return extras["cls"]  # type: ignore[no-any-return]
+
+    return None
+
+
 def is_basemodel(type_: type) -> bool:
     """Returns whether or not the given type is either a `BaseModel` or a union of `BaseModel`"""
     if is_union(type_):

{anchorbrowser-0.1.0a1 → anchorbrowser-0.1.0a3}/src/anchorbrowser/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "anchorbrowser"
-__version__ = "0.1.0-alpha.1"  # x-release-please-version
+__version__ = "0.1.0-alpha.3"  # x-release-please-version

anchorbrowser-0.1.0a3/src/anchorbrowser/lib/agent.py

@@ -0,0 +1,69 @@
+import json
+import asyncio
+import threading
+from typing import Any, Dict, Callable, Optional, TypedDict
+from asyncio import Future
+
+from ..lib.browser import BrowserSetup, get_agent_ws_url
+
+
+class AgentTaskParams(TypedDict, total=False):
+    url: Optional[str]
+    output_schema: Optional[Dict[str, Any]]
+    on_agent_step: Optional[Callable[[str], None]]
+
+
+def create_task_payload(prompt: str, output_schema: Optional[Dict[str, Any]] = None) -> str:
+    if not prompt or prompt.strip() == "":
+        raise ValueError("Prompt cannot be empty")
+
+    return json.dumps(
+        {
+            "prompt": prompt,
+            "output_schema": output_schema,
+        }
+    )
+
+
+def on_agent_step_sync(on_agent_step: Callable[[str], None], browser_setup: BrowserSetup) -> Future[None]:
+    import websockets
+
+    async def websocket_listener() -> None:
+        ws_url = get_agent_ws_url(browser_setup.base_url, browser_setup.session_id)
+        try:
+            async with websockets.connect(ws_url) as ws:
+                async for ws_msg in ws:
+                    on_agent_step(str(ws_msg))
+        except Exception as e:
+            future.set_exception(e)
+
+    def run_in_thread() -> None:
+        loop = asyncio.new_event_loop()
+        asyncio.set_event_loop(loop)
+        try:
+            loop.run_until_complete(websocket_listener())
+        finally:
+            loop.close()
+
+    # Create a future to track the task
+    future = Future[None]()
+    try:
+        thread = threading.Thread(target=lambda: future.set_result(run_in_thread()))
+        thread.daemon = True
+        thread.start()
+    except Exception:
+        pass
+
+    return future
+
+
+def on_agent_step_async(on_agent_step: Callable[[str], None], browser_setup: BrowserSetup) -> None:
+    import websockets
+
+    async def websocket_listener() -> None:
+        ws_url = get_agent_ws_url(browser_setup.base_url, browser_setup.session_id)
+        async with websockets.connect(ws_url) as ws:
+            async for ws_msg in ws:
+                on_agent_step(str(ws_msg))
+
+    asyncio.create_task(websocket_listener())