nimble_python 0.21.0__tar.gz → 0.23.0__tar.gz

nimble_python-0.23.0/.release-please-manifest.json

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

{nimble_python-0.21.0 → nimble_python-0.23.0}/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## 0.23.0 (2026-07-13)
+
+Full Changelog: [v0.22.0...v0.23.0](https://github.com/Nimbleway/nimble-python/compare/v0.22.0...v0.23.0)
+
+### Features
+
+* **api:** api update ([a1e3f26](https://github.com/Nimbleway/nimble-python/commit/a1e3f264c89f0a534be69714d3af67b73c1b740c))
+* **api:** api update ([082bc09](https://github.com/Nimbleway/nimble-python/commit/082bc099c7c2b53c0df4c6336ea489cdb1a0fe3c))
+
+## 0.22.0 (2026-07-07)
+
+Full Changelog: [v0.21.0...v0.22.0](https://github.com/Nimbleway/nimble-python/compare/v0.21.0...v0.22.0)
+
+### Features
+
+* **api:** api update ([b9d8f7e](https://github.com/Nimbleway/nimble-python/commit/b9d8f7e29a43a4a255acb37f2de95b23c26e5d98))
+
+
+### Bug Fixes
+
+* **types:** avoid type-checker errors on params with additional properties ([8d6acbb](https://github.com/Nimbleway/nimble-python/commit/8d6acbb1583852c2d6be660fa286c4beeb71aa9e))
+
 ## 0.21.0 (2026-06-22)
 
 Full Changelog: [v0.20.0...v0.21.0](https://github.com/Nimbleway/nimble-python/compare/v0.20.0...v0.21.0)

{nimble_python-0.21.0 → nimble_python-0.23.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: nimble_python
-Version: 0.21.0
+Version: 0.23.0
 Summary: The official Python library for the nimble API
 Project-URL: Homepage, https://github.com/Nimbleway/nimble-python
 Project-URL: Repository, https://github.com/Nimbleway/nimble-python

{nimble_python-0.21.0 → nimble_python-0.23.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "nimble_python"
-version = "0.21.0"
+version = "0.23.0"
 description = "The official Python library for the nimble API"
 dynamic = ["readme"]
 license = "Apache-2.0"

{nimble_python-0.21.0 → nimble_python-0.23.0}/src/nimble_python/_client.py

@@ -301,6 +301,7 @@ class Nimble(SyncAPIClient):
         self,
         *,
         url: str,
+        auto_driver_configuration: Dict[str, int] | Omit = omit,
         body: object | Omit = omit,
         browser: client_extract_params.Browser | Omit = omit,
         browser_actions: Iterable[client_extract_params.BrowserAction] | Omit = omit,
@@ -562,7 +563,10 @@ class Nimble(SyncAPIClient):
         ]
         | Omit = omit,
         device: Literal["desktop", "mobile", "tablet"] | Omit = omit,
-        driver: Literal["vx6", "vx8", "vx8-pro", "vx10", "vx10-pro", "vx12", "vx12-pro", "media-vx6"] | Omit = omit,
+        driver: Literal[
+            "auto", "vx6", "vx8", "vx8-pro", "vx10", "vx10-pro", "vx12", "vx12-pro", "media-vx6", "fast-vx6"
+        ]
+        | Omit = omit,
         expected_status_codes: Iterable[int] | Omit = omit,
         formats: List[Literal["html", "markdown", "screenshot", "headers", "links"]] | Omit = omit,
         headers: Dict[str, Union[str, SequenceNotStr[str], None]] | Omit = omit,
@@ -1191,6 +1195,11 @@ class Nimble(SyncAPIClient):
         Args:
           url: Target URL to scrape
 
+          auto_driver_configuration: Custom flow for the optimization engine: maps candidate names to the number of
+              attempts to spend on each candidate before advancing (0 skips it). Key order
+              defines the flow order. Providing it opts the request into 'auto' driver
+              selection.
+
           body: Request body for POST, PUT, PATCH methods
 
           browser: Browser type to emulate
@@ -1260,6 +1269,7 @@ class Nimble(SyncAPIClient):
             body=maybe_transform(
                 {
                     "url": url,
+                    "auto_driver_configuration": auto_driver_configuration,
                     "body": body,
                     "browser": browser,
                     "browser_actions": browser_actions,
@@ -1301,6 +1311,7 @@ class Nimble(SyncAPIClient):
         self,
         *,
         url: str,
+        auto_driver_configuration: Dict[str, int] | Omit = omit,
         body: object | Omit = omit,
         browser: client_extract_async_params.Browser | Omit = omit,
         browser_actions: Iterable[client_extract_async_params.BrowserAction] | Omit = omit,
@@ -1563,7 +1574,10 @@ class Nimble(SyncAPIClient):
         ]
         | Omit = omit,
         device: Literal["desktop", "mobile", "tablet"] | Omit = omit,
-        driver: Literal["vx6", "vx8", "vx8-pro", "vx10", "vx10-pro", "vx12", "vx12-pro", "media-vx6"] | Omit = omit,
+        driver: Literal[
+            "auto", "vx6", "vx8", "vx8-pro", "vx10", "vx10-pro", "vx12", "vx12-pro", "media-vx6", "fast-vx6"
+        ]
+        | Omit = omit,
         expected_status_codes: Iterable[int] | Omit = omit,
         formats: List[Literal["html", "markdown", "screenshot", "headers", "links"]] | Omit = omit,
         headers: Dict[str, Union[str, SequenceNotStr[str], None]] | Omit = omit,
@@ -2196,6 +2210,11 @@ class Nimble(SyncAPIClient):
         Args:
           url: Target URL to scrape
 
+          auto_driver_configuration: Custom flow for the optimization engine: maps candidate names to the number of
+              attempts to spend on each candidate before advancing (0 skips it). Key order
+              defines the flow order. Providing it opts the request into 'auto' driver
+              selection.
+
           body: Request body for POST, PUT, PATCH methods
 
           browser: Browser type to emulate
@@ -2275,6 +2294,7 @@ class Nimble(SyncAPIClient):
             body=maybe_transform(
                 {
                     "url": url,
+                    "auto_driver_configuration": auto_driver_configuration,
                     "body": body,
                     "browser": browser,
                     "browser_actions": browser_actions,
@@ -3581,6 +3601,7 @@ class AsyncNimble(AsyncAPIClient):
         self,
         *,
         url: str,
+        auto_driver_configuration: Dict[str, int] | Omit = omit,
         body: object | Omit = omit,
         browser: client_extract_params.Browser | Omit = omit,
         browser_actions: Iterable[client_extract_params.BrowserAction] | Omit = omit,
@@ -3842,7 +3863,10 @@ class AsyncNimble(AsyncAPIClient):
         ]
         | Omit = omit,
         device: Literal["desktop", "mobile", "tablet"] | Omit = omit,
-        driver: Literal["vx6", "vx8", "vx8-pro", "vx10", "vx10-pro", "vx12", "vx12-pro", "media-vx6"] | Omit = omit,
+        driver: Literal[
+            "auto", "vx6", "vx8", "vx8-pro", "vx10", "vx10-pro", "vx12", "vx12-pro", "media-vx6", "fast-vx6"
+        ]
+        | Omit = omit,
         expected_status_codes: Iterable[int] | Omit = omit,
         formats: List[Literal["html", "markdown", "screenshot", "headers", "links"]] | Omit = omit,
         headers: Dict[str, Union[str, SequenceNotStr[str], None]] | Omit = omit,
@@ -4471,6 +4495,11 @@ class AsyncNimble(AsyncAPIClient):
         Args:
           url: Target URL to scrape
 
+          auto_driver_configuration: Custom flow for the optimization engine: maps candidate names to the number of
+              attempts to spend on each candidate before advancing (0 skips it). Key order
+              defines the flow order. Providing it opts the request into 'auto' driver
+              selection.
+
           body: Request body for POST, PUT, PATCH methods
 
           browser: Browser type to emulate
@@ -4540,6 +4569,7 @@ class AsyncNimble(AsyncAPIClient):
             body=await async_maybe_transform(
                 {
                     "url": url,
+                    "auto_driver_configuration": auto_driver_configuration,
                     "body": body,
                     "browser": browser,
                     "browser_actions": browser_actions,
@@ -4581,6 +4611,7 @@ class AsyncNimble(AsyncAPIClient):
         self,
         *,
         url: str,
+        auto_driver_configuration: Dict[str, int] | Omit = omit,
         body: object | Omit = omit,
         browser: client_extract_async_params.Browser | Omit = omit,
         browser_actions: Iterable[client_extract_async_params.BrowserAction] | Omit = omit,
@@ -4843,7 +4874,10 @@ class AsyncNimble(AsyncAPIClient):
         ]
         | Omit = omit,
         device: Literal["desktop", "mobile", "tablet"] | Omit = omit,
-        driver: Literal["vx6", "vx8", "vx8-pro", "vx10", "vx10-pro", "vx12", "vx12-pro", "media-vx6"] | Omit = omit,
+        driver: Literal[
+            "auto", "vx6", "vx8", "vx8-pro", "vx10", "vx10-pro", "vx12", "vx12-pro", "media-vx6", "fast-vx6"
+        ]
+        | Omit = omit,
         expected_status_codes: Iterable[int] | Omit = omit,
         formats: List[Literal["html", "markdown", "screenshot", "headers", "links"]] | Omit = omit,
         headers: Dict[str, Union[str, SequenceNotStr[str], None]] | Omit = omit,
@@ -5476,6 +5510,11 @@ class AsyncNimble(AsyncAPIClient):
         Args:
           url: Target URL to scrape
 
+          auto_driver_configuration: Custom flow for the optimization engine: maps candidate names to the number of
+              attempts to spend on each candidate before advancing (0 skips it). Key order
+              defines the flow order. Providing it opts the request into 'auto' driver
+              selection.
+
           body: Request body for POST, PUT, PATCH methods
 
           browser: Browser type to emulate
@@ -5555,6 +5594,7 @@ class AsyncNimble(AsyncAPIClient):
             body=await async_maybe_transform(
                 {
                     "url": url,
+                    "auto_driver_configuration": auto_driver_configuration,
                     "body": body,
                     "browser": browser,
                     "browser_actions": browser_actions,

{nimble_python-0.21.0 → nimble_python-0.23.0}/src/nimble_python/_version.py

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

{nimble_python-0.21.0 → nimble_python-0.23.0}/src/nimble_python/resources/agent.py

@@ -120,9 +120,9 @@ class AgentResource(SyncAPIResource):
         *,
         prompt: str,
         url: str,
-        agent_name: Optional[str] | Omit = omit,
         input_schema: Dict[str, object] | Omit = omit,
-        metadata: Optional[agent_generate_params.CreateAgentGenerationRequestMetadata] | Omit = omit,
+        metadata: Optional[agent_generate_params.CrustCreateAgentGenerationRequestMetadata] | Omit = omit,
+        name: Optional[str] | Omit = omit,
         output_schema: Dict[str, object] | 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.
@@ -178,9 +178,9 @@ class AgentResource(SyncAPIResource):
         *,
         prompt: str,
         url: str | Omit = omit,
-        agent_name: Optional[str] | Omit = omit,
         input_schema: Dict[str, object] | Omit = omit,
-        metadata: Optional[agent_generate_params.CreateAgentGenerationRequestMetadata] | Omit = omit,
+        metadata: Optional[agent_generate_params.CrustCreateAgentGenerationRequestMetadata] | Omit = omit,
+        name: Optional[str] | Omit = omit,
         output_schema: Dict[str, object] | Omit = omit,
         from_agent: str | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -196,9 +196,9 @@ class AgentResource(SyncAPIResource):
                 {
                     "prompt": prompt,
                     "url": url,
-                    "agent_name": agent_name,
                     "input_schema": input_schema,
                     "metadata": metadata,
+                    "name": name,
                     "output_schema": output_schema,
                     "from_agent": from_agent,
                 },
@@ -511,9 +511,9 @@ class AsyncAgentResource(AsyncAPIResource):
         *,
         prompt: str,
         url: str,
-        agent_name: Optional[str] | Omit = omit,
         input_schema: Dict[str, object] | Omit = omit,
-        metadata: Optional[agent_generate_params.CreateAgentGenerationRequestMetadata] | Omit = omit,
+        metadata: Optional[agent_generate_params.CrustCreateAgentGenerationRequestMetadata] | Omit = omit,
+        name: Optional[str] | Omit = omit,
         output_schema: Dict[str, object] | 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.
@@ -569,9 +569,9 @@ class AsyncAgentResource(AsyncAPIResource):
         *,
         prompt: str,
         url: str | Omit = omit,
-        agent_name: Optional[str] | Omit = omit,
         input_schema: Dict[str, object] | Omit = omit,
-        metadata: Optional[agent_generate_params.CreateAgentGenerationRequestMetadata] | Omit = omit,
+        metadata: Optional[agent_generate_params.CrustCreateAgentGenerationRequestMetadata] | Omit = omit,
+        name: Optional[str] | Omit = omit,
         output_schema: Dict[str, object] | Omit = omit,
         from_agent: str | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -587,9 +587,9 @@ class AsyncAgentResource(AsyncAPIResource):
                 {
                     "prompt": prompt,
                     "url": url,
-                    "agent_name": agent_name,
                     "input_schema": input_schema,
                     "metadata": metadata,
+                    "name": name,
                     "output_schema": output_schema,
                     "from_agent": from_agent,
                 },

{nimble_python-0.21.0 → nimble_python-0.23.0}/src/nimble_python/resources/jobs/jobs.py

@@ -80,6 +80,20 @@ class JobsResource(SyncAPIResource):
         Create Job
 
         Args:
+          agent_name: Name of the agent to run.
+
+          name: Job name.
+
+          description: Free-text description of the job.
+
+          destination: Where a job writes its results.
+
+          display_name: Human-friendly job name shown in the UI.
+
+          inputs: Configuration for the input data a job processes.
+
+          schedule: Cron-based schedule controlling when a job runs automatically.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -128,6 +142,16 @@ class JobsResource(SyncAPIResource):
         Update Job
 
         Args:
+          description: New description.
+
+          destination: Where a job writes its results.
+
+          display_name: New display name.
+
+          inputs: Configuration for the input data a job processes.
+
+          schedule: Cron-based schedule controlling when a job runs automatically.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -352,6 +376,20 @@ class AsyncJobsResource(AsyncAPIResource):
         Create Job
 
         Args:
+          agent_name: Name of the agent to run.
+
+          name: Job name.
+
+          description: Free-text description of the job.
+
+          destination: Where a job writes its results.
+
+          display_name: Human-friendly job name shown in the UI.
+
+          inputs: Configuration for the input data a job processes.
+
+          schedule: Cron-based schedule controlling when a job runs automatically.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -400,6 +438,16 @@ class AsyncJobsResource(AsyncAPIResource):
         Update Job
 
         Args:
+          description: New description.
+
+          destination: Where a job writes its results.
+
+          display_name: New display name.
+
+          inputs: Configuration for the input data a job processes.
+
+          schedule: Cron-based schedule controlling when a job runs automatically.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request

{nimble_python-0.21.0 → nimble_python-0.23.0}/src/nimble_python/resources/task_agent/runs.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Any, cast
+from typing import Any, Optional, cast
 
 import httpx
 
@@ -51,6 +51,8 @@ class RunsResource(SyncAPIResource):
         *,
         limit: int | Omit = omit,
         offset: int | Omit = omit,
+        q: Optional[str] | Omit = omit,
+        status: Optional[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,
@@ -59,7 +61,10 @@ class RunsResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> RunListResponse:
         """
-        List task runs for the caller's workspace and the given agent, newest first.
+        List runs for this instance.
+
+        `status` accepts a lowercase `TaskRunStatusValue` (e.g. "completed") or a
+        comma-separated list of them (e.g. "queued,running").
 
         Args:
           extra_headers: Send extra headers
@@ -83,6 +88,8 @@ class RunsResource(SyncAPIResource):
                     {
                         "limit": limit,
                         "offset": offset,
+                        "q": q,
+                        "status": status,
                     },
                     run_list_params.RunListParams,
                 ),
@@ -105,6 +112,9 @@ class RunsResource(SyncAPIResource):
         """
         Cancel an in-progress or queued run.
 
+        Verb is POST + `/cancel` action segment per the AGENTS-1666 spec (replaces the
+        old `DELETE …/runs/{run_id}`).
+
         Args:
           extra_headers: Send extra headers
 
@@ -139,9 +149,12 @@ class RunsResource(SyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> RunGetResponse:
-        """Poll run status.
+        """
+        Fetch a run by id, scoped to the instance.
 
-        Repeat until status is 'completed', 'failed', or 'cancelled'.
+        A run resolves only when (run_id, agent_id) match — otherwise 404. This means a
+        stale URL with a swapped agent_id won't leak runs across instances even if the
+        run_id is real.
 
         Args:
           extra_headers: Send extra headers
@@ -176,10 +189,15 @@ class RunsResource(SyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> RunGetResultResponse:
-        """Fetch the result for a terminal run.
+        """
+        Fetch the result for a terminal run on this instance.
 
-        Returns 408 if still active, 422 with
-        `AgentRunFailedResult` if failed.
+        Mirrors the previous flat `GET /tasks/runs/:run_id/result` semantics:
+
+        - 404 when the run doesn't belong to the agent.
+        - 408 when the run is still active.
+        - 422 (with TaskRunFailedResult body) when the run failed or was cancelled.
+        - 200 (with TaskRunResult body) on success.
 
         Args:
           extra_headers: Send extra headers
@@ -219,10 +237,8 @@ class RunsResource(SyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> object:
-        """Server-Sent Events stream of real-time progress events for a run.
-
-        The run must
-        have been created with `enable_events=true`.
+        """
+        SSE stream of real-time progress events for a run on this instance.
 
         Args:
           extra_headers: Send extra headers
@@ -272,6 +288,8 @@ class AsyncRunsResource(AsyncAPIResource):
         *,
         limit: int | Omit = omit,
         offset: int | Omit = omit,
+        q: Optional[str] | Omit = omit,
+        status: Optional[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,
@@ -280,7 +298,10 @@ class AsyncRunsResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> RunListResponse:
         """
-        List task runs for the caller's workspace and the given agent, newest first.
+        List runs for this instance.
+
+        `status` accepts a lowercase `TaskRunStatusValue` (e.g. "completed") or a
+        comma-separated list of them (e.g. "queued,running").
 
         Args:
           extra_headers: Send extra headers
@@ -304,6 +325,8 @@ class AsyncRunsResource(AsyncAPIResource):
                     {
                         "limit": limit,
                         "offset": offset,
+                        "q": q,
+                        "status": status,
                     },
                     run_list_params.RunListParams,
                 ),
@@ -326,6 +349,9 @@ class AsyncRunsResource(AsyncAPIResource):
         """
         Cancel an in-progress or queued run.
 
+        Verb is POST + `/cancel` action segment per the AGENTS-1666 spec (replaces the
+        old `DELETE …/runs/{run_id}`).
+
         Args:
           extra_headers: Send extra headers
 
@@ -360,9 +386,12 @@ class AsyncRunsResource(AsyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> RunGetResponse:
-        """Poll run status.
+        """
+        Fetch a run by id, scoped to the instance.
 
-        Repeat until status is 'completed', 'failed', or 'cancelled'.
+        A run resolves only when (run_id, agent_id) match — otherwise 404. This means a
+        stale URL with a swapped agent_id won't leak runs across instances even if the
+        run_id is real.
 
         Args:
           extra_headers: Send extra headers
@@ -397,10 +426,15 @@ class AsyncRunsResource(AsyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> RunGetResultResponse:
-        """Fetch the result for a terminal run.
+        """
+        Fetch the result for a terminal run on this instance.
 
-        Returns 408 if still active, 422 with
-        `AgentRunFailedResult` if failed.
+        Mirrors the previous flat `GET /tasks/runs/:run_id/result` semantics:
+
+        - 404 when the run doesn't belong to the agent.
+        - 408 when the run is still active.
+        - 422 (with TaskRunFailedResult body) when the run failed or was cancelled.
+        - 200 (with TaskRunResult body) on success.
 
         Args:
           extra_headers: Send extra headers
@@ -440,10 +474,8 @@ class AsyncRunsResource(AsyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> object:
-        """Server-Sent Events stream of real-time progress events for a run.
-
-        The run must
-        have been created with `enable_events=true`.
+        """
+        SSE stream of real-time progress events for a run on this instance.
 
         Args:
           extra_headers: Send extra headers