anchorbrowser 0.2.0__tar.gz → 0.3.1__tar.gz

anchorbrowser-0.3.1/.release-please-manifest.json

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

{anchorbrowser-0.2.0 → anchorbrowser-0.3.1}/CHANGELOG.md

@@ -1,5 +1,33 @@
 # Changelog
 
+## 0.3.1 (2025-10-26)
+
+Full Changelog: [v0.3.0...v0.3.1](https://github.com/anchorbrowser/AnchorBrowser-SDK-Python/compare/v0.3.0...v0.3.1)
+
+### Features
+
+* **api:** manual updates ([ab2e49e](https://github.com/anchorbrowser/AnchorBrowser-SDK-Python/commit/ab2e49eeb383bef056d6255e30503363fa87869e))
+
+## 0.3.0 (2025-10-21)
+
+Full Changelog: [v0.2.0...v0.3.0](https://github.com/anchorbrowser/AnchorBrowser-SDK-Python/compare/v0.2.0...v0.3.0)
+
+### ⚠ BREAKING CHANGES
+
+* **python:** Use `client.task.run()` instead of `client.task.run.execute()`
+
+### Features
+
+* **python:** move task.run.execute() to task.run() ([7d19ce5](https://github.com/anchorbrowser/AnchorBrowser-SDK-Python/commit/7d19ce588df9a75d38fc0e53472b126c1b71112c))
+
+
+### Bug Fixes
+
+* reorganize task tests ([c9621f8](https://github.com/anchorbrowser/AnchorBrowser-SDK-Python/commit/c9621f84d08522a8aa04bafda00893a026355979))
+* resolve linting errors ([b2e73c8](https://github.com/anchorbrowser/AnchorBrowser-SDK-Python/commit/b2e73c8a22b11cb5f4624b6ed3a6687cd9265bc7))
+* resolve linting errors1 ([4544a64](https://github.com/anchorbrowser/AnchorBrowser-SDK-Python/commit/4544a6435773a443fdb360e2647762224ac3c50b))
+* resolve linting errors2 ([0405baa](https://github.com/anchorbrowser/AnchorBrowser-SDK-Python/commit/0405baa1fb7fb666fe5144e7a5762224cdea6cff))
+
 ## 0.2.0 (2025-10-20)
 
 Full Changelog: [v0.1.1...v0.2.0](https://github.com/anchorbrowser/AnchorBrowser-SDK-Python/compare/v0.1.1...v0.2.0)

{anchorbrowser-0.2.0 → anchorbrowser-0.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: anchorbrowser
-Version: 0.2.0
+Version: 0.3.1
 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
@@ -68,10 +68,10 @@ client = Anchorbrowser(
     api_key=os.environ.get("ANCHORBROWSER_API_KEY"),  # This is the default and can be omitted
 )
 
-success_response = client.profiles.create(
-    name="REPLACE_ME",
+session = client.sessions.create(
+    session={"recording": {"active": False}},
 )
-print(success_response.data)
+print(session.data)
 ```
 
 While you can provide an `api_key` keyword argument,
@@ -94,10 +94,10 @@ client = AsyncAnchorbrowser(
 
 
 async def main() -> None:
-    success_response = await client.profiles.create(
-        name="REPLACE_ME",
+    session = await client.sessions.create(
+        session={"recording": {"active": False}},
     )
-    print(success_response.data)
+    print(session.data)
 
 
 asyncio.run(main())
@@ -129,10 +129,10 @@ async def main() -> None:
         api_key="Your API Key",
         http_client=DefaultAioHttpClient(),
     ) as client:
-        success_response = await client.profiles.create(
-            name="REPLACE_ME",
+        session = await client.sessions.create(
+            session={"recording": {"active": False}},
         )
-        print(success_response.data)
+        print(session.data)
 
 
 asyncio.run(main())
@@ -196,8 +196,8 @@ from anchorbrowser import Anchorbrowser
 client = Anchorbrowser()
 
 try:
-    client.profiles.create(
-        name="REPLACE_ME",
+    client.sessions.create(
+        session={"recording": {"active": False}},
     )
 except anchorbrowser.APIConnectionError as e:
     print("The server could not be reached")
@@ -241,8 +241,8 @@ client = Anchorbrowser(
 )
 
 # Or, configure per-request:
-client.with_options(max_retries=5).profiles.create(
-    name="REPLACE_ME",
+client.with_options(max_retries=5).sessions.create(
+    session={"recording": {"active": False}},
 )
 ```
 
@@ -266,8 +266,8 @@ client = Anchorbrowser(
 )
 
 # Override per-request:
-client.with_options(timeout=5.0).profiles.create(
-    name="REPLACE_ME",
+client.with_options(timeout=5.0).sessions.create(
+    session={"recording": {"active": False}},
 )
 ```
 
@@ -309,13 +309,17 @@ The "raw" Response object can be accessed by prefixing `.with_raw_response.` to
 from anchorbrowser import Anchorbrowser
 
 client = Anchorbrowser()
-response = client.profiles.with_raw_response.create(
-    name="REPLACE_ME",
+response = client.sessions.with_raw_response.create(
+    session={
+        "recording": {
+            "active": False
+        }
+    },
 )
 print(response.headers.get('X-My-Header'))
 
-profile = response.parse()  # get the object that `profiles.create()` would have returned
-print(profile.data)
+session = response.parse()  # get the object that `sessions.create()` would have returned
+print(session.data)
 ```
 
 These methods return an [`APIResponse`](https://github.com/anchorbrowser/AnchorBrowser-SDK-Python/tree/main/src/anchorbrowser/_response.py) object.
@@ -329,8 +333,8 @@ The above interface eagerly reads the full response body when you make the reque
 To stream the response body, use `.with_streaming_response` instead, which requires a context manager and only reads the response body once you call `.read()`, `.text()`, `.json()`, `.iter_bytes()`, `.iter_text()`, `.iter_lines()` or `.parse()`. In the async client, these are async methods.
 
 ```python
-with client.profiles.with_streaming_response.create(
-    name="REPLACE_ME",
+with client.sessions.with_streaming_response.create(
+    session={"recording": {"active": False}},
 ) as response:
     print(response.headers.get("X-My-Header"))
 

{anchorbrowser-0.2.0 → anchorbrowser-0.3.1}/README.md

@@ -32,10 +32,10 @@ client = Anchorbrowser(
     api_key=os.environ.get("ANCHORBROWSER_API_KEY"),  # This is the default and can be omitted
 )
 
-success_response = client.profiles.create(
-    name="REPLACE_ME",
+session = client.sessions.create(
+    session={"recording": {"active": False}},
 )
-print(success_response.data)
+print(session.data)
 ```
 
 While you can provide an `api_key` keyword argument,
@@ -58,10 +58,10 @@ client = AsyncAnchorbrowser(
 
 
 async def main() -> None:
-    success_response = await client.profiles.create(
-        name="REPLACE_ME",
+    session = await client.sessions.create(
+        session={"recording": {"active": False}},
     )
-    print(success_response.data)
+    print(session.data)
 
 
 asyncio.run(main())
@@ -93,10 +93,10 @@ async def main() -> None:
         api_key="Your API Key",
         http_client=DefaultAioHttpClient(),
     ) as client:
-        success_response = await client.profiles.create(
-            name="REPLACE_ME",
+        session = await client.sessions.create(
+            session={"recording": {"active": False}},
         )
-        print(success_response.data)
+        print(session.data)
 
 
 asyncio.run(main())
@@ -160,8 +160,8 @@ from anchorbrowser import Anchorbrowser
 client = Anchorbrowser()
 
 try:
-    client.profiles.create(
-        name="REPLACE_ME",
+    client.sessions.create(
+        session={"recording": {"active": False}},
     )
 except anchorbrowser.APIConnectionError as e:
     print("The server could not be reached")
@@ -205,8 +205,8 @@ client = Anchorbrowser(
 )
 
 # Or, configure per-request:
-client.with_options(max_retries=5).profiles.create(
-    name="REPLACE_ME",
+client.with_options(max_retries=5).sessions.create(
+    session={"recording": {"active": False}},
 )
 ```
 
@@ -230,8 +230,8 @@ client = Anchorbrowser(
 )
 
 # Override per-request:
-client.with_options(timeout=5.0).profiles.create(
-    name="REPLACE_ME",
+client.with_options(timeout=5.0).sessions.create(
+    session={"recording": {"active": False}},
 )
 ```
 
@@ -273,13 +273,17 @@ The "raw" Response object can be accessed by prefixing `.with_raw_response.` to
 from anchorbrowser import Anchorbrowser
 
 client = Anchorbrowser()
-response = client.profiles.with_raw_response.create(
-    name="REPLACE_ME",
+response = client.sessions.with_raw_response.create(
+    session={
+        "recording": {
+            "active": False
+        }
+    },
 )
 print(response.headers.get('X-My-Header'))
 
-profile = response.parse()  # get the object that `profiles.create()` would have returned
-print(profile.data)
+session = response.parse()  # get the object that `sessions.create()` would have returned
+print(session.data)
 ```
 
 These methods return an [`APIResponse`](https://github.com/anchorbrowser/AnchorBrowser-SDK-Python/tree/main/src/anchorbrowser/_response.py) object.
@@ -293,8 +297,8 @@ The above interface eagerly reads the full response body when you make the reque
 To stream the response body, use `.with_streaming_response` instead, which requires a context manager and only reads the response body once you call `.read()`, `.text()`, `.json()`, `.iter_bytes()`, `.iter_text()`, `.iter_lines()` or `.parse()`. In the async client, these are async methods.
 
 ```python
-with client.profiles.with_streaming_response.create(
-    name="REPLACE_ME",
+with client.sessions.with_streaming_response.create(
+    session={"recording": {"active": False}},
 ) as response:
     print(response.headers.get("X-My-Header"))
 

{anchorbrowser-0.2.0 → anchorbrowser-0.3.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "anchorbrowser"
-version = "0.2.0"
+version = "0.3.1"
 description = "The official Python library for the anchorbrowser API"
 dynamic = ["readme"]
 license = "Apache-2.0"

{anchorbrowser-0.2.0 → anchorbrowser-0.3.1}/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 agent, tools, events, browser, profiles, extensions, batch_sessions
+from .resources import task, agent, tools, events, browser, profiles, extensions, batch_sessions
 from ._streaming import Stream as Stream, AsyncStream as AsyncStream
 from ._exceptions import APIStatusError, AnchorbrowserError
 from ._base_client import (
@@ -29,7 +29,6 @@ from ._base_client import (
     SyncAPIClient,
     AsyncAPIClient,
 )
-from .resources.task import task
 from .resources.sessions import sessions
 
 __all__ = [

{anchorbrowser-0.2.0 → anchorbrowser-0.3.1}/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.2.0"  # x-release-please-version
+__version__ = "0.3.1"  # x-release-please-version

{anchorbrowser-0.2.0/src/anchorbrowser/resources/task → anchorbrowser-0.3.1/src/anchorbrowser/resources}/task.py

@@ -2,41 +2,32 @@
 
 from __future__ import annotations
 
+from typing import Dict
 from typing_extensions import Literal
 
 import httpx
 
-from .run import (
-    RunResource,
-    AsyncRunResource,
-    RunResourceWithRawResponse,
-    AsyncRunResourceWithRawResponse,
-    RunResourceWithStreamingResponse,
-    AsyncRunResourceWithStreamingResponse,
-)
-from ...types import task_list_params, task_create_params
-from ..._types import Body, Omit, Query, Headers, NotGiven, omit, not_given
-from ..._utils import maybe_transform, async_maybe_transform
-from ..._compat import cached_property
-from ..._resource import SyncAPIResource, AsyncAPIResource
-from ..._response import (
+from ..types import task_list_params, task_create_params
+from .._types import Body, Omit, Query, Headers, NotGiven, omit, not_given
+from .._utils import maybe_transform, async_maybe_transform
+from .._compat import cached_property
+from .._resource import SyncAPIResource, AsyncAPIResource
+from .._response import (
     to_raw_response_wrapper,
     to_streamed_response_wrapper,
     async_to_raw_response_wrapper,
     async_to_streamed_response_wrapper,
 )
-from ..._base_client import make_request_options
-from ...types.task_list_response import TaskListResponse
-from ...types.task_create_response import TaskCreateResponse
+from ..types.task import run_execute_params
+from .._base_client import make_request_options
+from ..types.task_list_response import TaskListResponse
+from ..types.task_create_response import TaskCreateResponse
+from ..types.task.run_execute_response import RunExecuteResponse
 
 __all__ = ["TaskResource", "AsyncTaskResource"]
 
 
 class TaskResource(SyncAPIResource):
-    @cached_property
-    def run(self) -> RunResource:
-        return RunResource(self._client)
-
     @cached_property
     def with_raw_response(self) -> TaskResourceWithRawResponse:
         """
@@ -162,12 +153,70 @@ class TaskResource(SyncAPIResource):
             cast_to=TaskListResponse,
         )
 
+    def run(
+        self,
+        *,
+        task_id: str,
+        inputs: Dict[str, str] | Omit = omit,
+        override_browser_configuration: run_execute_params.OverrideBrowserConfiguration | Omit = omit,
+        session_id: str | Omit = omit,
+        task_session_id: str | Omit = omit,
+        version: str | Omit = omit,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> RunExecuteResponse:
+        """Executes a task in a browser session.
+
+        The task can be run with a specific
+        version or the latest version. Optionally, you can provide an existing session
+        ID or let the system create a new one.
 
-class AsyncTaskResource(AsyncAPIResource):
-    @cached_property
-    def run(self) -> AsyncRunResource:
-        return AsyncRunResource(self._client)
+        Args:
+          task_id: Task identifier
+
+          inputs: Environment variables for task execution (keys must start with ANCHOR\\__)
+
+          override_browser_configuration: Override browser configuration for this execution
+
+          session_id: Optional existing session ID to use
+
+          task_session_id: Optional task-specific session ID
+
+          version: Version to run (draft, latest, or version number)
+
+          extra_headers: Send extra headers
 
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        return self._post(
+            "/v1/task/run",
+            body=maybe_transform(
+                {
+                    "task_id": task_id,
+                    "inputs": inputs,
+                    "override_browser_configuration": override_browser_configuration,
+                    "session_id": session_id,
+                    "task_session_id": task_session_id,
+                    "version": version,
+                },
+                run_execute_params.RunExecuteParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=RunExecuteResponse,
+        )
+
+
+class AsyncTaskResource(AsyncAPIResource):
     @cached_property
     def with_raw_response(self) -> AsyncTaskResourceWithRawResponse:
         """
@@ -293,6 +342,68 @@ class AsyncTaskResource(AsyncAPIResource):
             cast_to=TaskListResponse,
         )
 
+    async def run(
+        self,
+        *,
+        task_id: str,
+        inputs: Dict[str, str] | Omit = omit,
+        override_browser_configuration: run_execute_params.OverrideBrowserConfiguration | Omit = omit,
+        session_id: str | Omit = omit,
+        task_session_id: str | Omit = omit,
+        version: str | Omit = omit,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> RunExecuteResponse:
+        """Executes a task in a browser session.
+
+        The task can be run with a specific
+        version or the latest version. Optionally, you can provide an existing session
+        ID or let the system create a new one.
+
+        Args:
+          task_id: Task identifier
+
+          inputs: Environment variables for task execution (keys must start with ANCHOR\\__)
+
+          override_browser_configuration: Override browser configuration for this execution
+
+          session_id: Optional existing session ID to use
+
+          task_session_id: Optional task-specific session ID
+
+          version: Version to run (draft, latest, or version number)
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        return await self._post(
+            "/v1/task/run",
+            body=await async_maybe_transform(
+                {
+                    "task_id": task_id,
+                    "inputs": inputs,
+                    "override_browser_configuration": override_browser_configuration,
+                    "session_id": session_id,
+                    "task_session_id": task_session_id,
+                    "version": version,
+                },
+                run_execute_params.RunExecuteParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=RunExecuteResponse,
+        )
+
 
 class TaskResourceWithRawResponse:
     def __init__(self, task: TaskResource) -> None:
@@ -304,10 +415,9 @@ class TaskResourceWithRawResponse:
         self.list = to_raw_response_wrapper(
             task.list,
         )
-
-    @cached_property
-    def run(self) -> RunResourceWithRawResponse:
-        return RunResourceWithRawResponse(self._task.run)
+        self.run = to_raw_response_wrapper(
+            task.run,
+        )
 
 
 class AsyncTaskResourceWithRawResponse:
@@ -320,10 +430,9 @@ class AsyncTaskResourceWithRawResponse:
         self.list = async_to_raw_response_wrapper(
             task.list,
         )
-
-    @cached_property
-    def run(self) -> AsyncRunResourceWithRawResponse:
-        return AsyncRunResourceWithRawResponse(self._task.run)
+        self.run = async_to_raw_response_wrapper(
+            task.run,
+        )
 
 
 class TaskResourceWithStreamingResponse:
@@ -336,10 +445,9 @@ class TaskResourceWithStreamingResponse:
         self.list = to_streamed_response_wrapper(
             task.list,
         )
-
-    @cached_property
-    def run(self) -> RunResourceWithStreamingResponse:
-        return RunResourceWithStreamingResponse(self._task.run)
+        self.run = to_streamed_response_wrapper(
+            task.run,
+        )
 
 
 class AsyncTaskResourceWithStreamingResponse:
@@ -352,7 +460,6 @@ class AsyncTaskResourceWithStreamingResponse:
         self.list = async_to_streamed_response_wrapper(
             task.list,
         )
-
-    @cached_property
-    def run(self) -> AsyncRunResourceWithStreamingResponse:
-        return AsyncRunResourceWithStreamingResponse(self._task.run)
+        self.run = async_to_streamed_response_wrapper(
+            task.run,
+        )