nimble_python 0.13.0__tar.gz → 0.15.0__tar.gz

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

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

{nimble_python-0.13.0 → nimble_python-0.15.0}/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changelog
 
+## 0.15.0 (2026-03-29)
+
+Full Changelog: [v0.14.0...v0.15.0](https://github.com/Nimbleway/nimble-python/compare/v0.14.0...v0.15.0)
+
+### Features
+
+* **api:** api update ([691eb61](https://github.com/Nimbleway/nimble-python/commit/691eb61893fadbc901e48eaf17077a229abc06f5))
+* **api:** manual updates ([99d2baf](https://github.com/Nimbleway/nimble-python/commit/99d2baff4c87c9402cf4f3615825d6c8b42e5d28))
+* **internal:** implement indices array format for query and form serialization ([e74fd0c](https://github.com/Nimbleway/nimble-python/commit/e74fd0c52e59349932a467177eb6f5f5b554f218))
+
+## 0.14.0 (2026-03-25)
+
+Full Changelog: [v0.13.0...v0.14.0](https://github.com/Nimbleway/nimble-python/compare/v0.13.0...v0.14.0)
+
+### Features
+
+* **api:** api update ([821cfa1](https://github.com/Nimbleway/nimble-python/commit/821cfa15a5328f20cda1f76b1d7a284d3d53b23f))
+
+
+### Chores
+
+* **ci:** skip lint on metadata-only changes ([3e1d8f5](https://github.com/Nimbleway/nimble-python/commit/3e1d8f5838127cb3145a69876d993bca07bc4b8e))
+
 ## 0.13.0 (2026-03-24)
 
 Full Changelog: [v0.12.0...v0.13.0](https://github.com/Nimbleway/nimble-python/compare/v0.12.0...v0.13.0)

{nimble_python-0.13.0 → nimble_python-0.15.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: nimble_python
-Version: 0.13.0
+Version: 0.15.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.13.0 → nimble_python-0.15.0}/api.md

@@ -50,6 +50,7 @@ from nimble_python.types import (
     AgentGetResponse,
     AgentRunResponse,
     AgentRunAsyncResponse,
+    AgentRunBatchResponse,
 )
 ```
 
@@ -59,6 +60,7 @@ Methods:
 - <code title="get /v1/agents/{template_name}">client.agent.<a href="./src/nimble_python/resources/agent.py">get</a>(template_name) -> <a href="./src/nimble_python/types/agent_get_response.py">AgentGetResponse</a></code>
 - <code title="post /v1/agents/run">client.agent.<a href="./src/nimble_python/resources/agent.py">run</a>(\*\*<a href="src/nimble_python/types/agent_run_params.py">params</a>) -> <a href="./src/nimble_python/types/agent_run_response.py">AgentRunResponse</a></code>
 - <code title="post /v1/agents/async">client.agent.<a href="./src/nimble_python/resources/agent.py">run_async</a>(\*\*<a href="src/nimble_python/types/agent_run_async_params.py">params</a>) -> <a href="./src/nimble_python/types/agent_run_async_response.py">AgentRunAsyncResponse</a></code>
+- <code title="post /v1/agents/batch">client.agent.<a href="./src/nimble_python/resources/agent.py">run_batch</a>(\*\*<a href="src/nimble_python/types/agent_run_batch_params.py">params</a>) -> <a href="./src/nimble_python/types/agent_run_batch_response.py">AgentRunBatchResponse</a></code>
 
 # Crawl
 

{nimble_python-0.13.0 → nimble_python-0.15.0}/pyproject.toml

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

{nimble_python-0.13.0 → nimble_python-0.15.0}/src/nimble_python/_client.py

@@ -500,7 +500,7 @@ class Nimble(SyncAPIClient):
         device: Literal["desktop", "mobile", "tablet"] | Omit = omit,
         driver: Literal["vx6", "vx8", "vx8-pro", "vx10", "vx10-pro", "vx12", "vx12-pro"] | Omit = omit,
         expected_status_codes: Iterable[int] | Omit = omit,
-        formats: List[Literal["html", "markdown", "screenshot"]] | Omit = omit,
+        formats: List[Literal["html", "markdown", "screenshot", "headers"]] | Omit = omit,
         headers: Dict[str, Union[str, SequenceNotStr[str], None]] | Omit = omit,
         http2: bool | Omit = omit,
         is_xhr: bool | Omit = omit,
@@ -1491,7 +1491,7 @@ class Nimble(SyncAPIClient):
         device: Literal["desktop", "mobile", "tablet"] | Omit = omit,
         driver: Literal["vx6", "vx8", "vx8-pro", "vx10", "vx10-pro", "vx12", "vx12-pro"] | Omit = omit,
         expected_status_codes: Iterable[int] | Omit = omit,
-        formats: List[Literal["html", "markdown", "screenshot"]] | Omit = omit,
+        formats: List[Literal["html", "markdown", "screenshot", "headers"]] | Omit = omit,
         headers: Dict[str, Union[str, SequenceNotStr[str], None]] | Omit = omit,
         http2: bool | Omit = omit,
         is_xhr: bool | Omit = omit,
@@ -2237,8 +2237,8 @@ class Nimble(SyncAPIClient):
     def extract_batch(
         self,
         *,
-        params: Iterable[client_extract_batch_params.Param],
-        shared_params: client_extract_batch_params.SharedParams | Omit = omit,
+        inputs: Iterable[client_extract_batch_params.Input],
+        shared_inputs: client_extract_batch_params.SharedInputs | 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,
@@ -2249,13 +2249,13 @@ class Nimble(SyncAPIClient):
         """Extract Batch Endpoint
 
         Args:
-          params: Array of extraction requests.
+          inputs: Array of extraction requests.
 
-        Each object represents one extraction with its own
-              parameters.
+        Each object can include extraction parameters and
+              async/storage settings.
 
-          shared_params: Shared parameters applied to the entire batch, such as storage and callback
-              configuration.
+          shared_inputs: Shared parameters applied to the entire batch. Can include extraction parameters
+              and async/storage settings.
 
           extra_headers: Send extra headers
 
@@ -2269,8 +2269,8 @@ class Nimble(SyncAPIClient):
             "/v1/extract/batch",
             body=maybe_transform(
                 {
-                    "params": params,
-                    "shared_params": shared_params,
+                    "inputs": inputs,
+                    "shared_inputs": shared_inputs,
                 },
                 client_extract_batch_params.ClientExtractBatchParams,
             ),
@@ -3700,7 +3700,7 @@ class AsyncNimble(AsyncAPIClient):
         device: Literal["desktop", "mobile", "tablet"] | Omit = omit,
         driver: Literal["vx6", "vx8", "vx8-pro", "vx10", "vx10-pro", "vx12", "vx12-pro"] | Omit = omit,
         expected_status_codes: Iterable[int] | Omit = omit,
-        formats: List[Literal["html", "markdown", "screenshot"]] | Omit = omit,
+        formats: List[Literal["html", "markdown", "screenshot", "headers"]] | Omit = omit,
         headers: Dict[str, Union[str, SequenceNotStr[str], None]] | Omit = omit,
         http2: bool | Omit = omit,
         is_xhr: bool | Omit = omit,
@@ -4691,7 +4691,7 @@ class AsyncNimble(AsyncAPIClient):
         device: Literal["desktop", "mobile", "tablet"] | Omit = omit,
         driver: Literal["vx6", "vx8", "vx8-pro", "vx10", "vx10-pro", "vx12", "vx12-pro"] | Omit = omit,
         expected_status_codes: Iterable[int] | Omit = omit,
-        formats: List[Literal["html", "markdown", "screenshot"]] | Omit = omit,
+        formats: List[Literal["html", "markdown", "screenshot", "headers"]] | Omit = omit,
         headers: Dict[str, Union[str, SequenceNotStr[str], None]] | Omit = omit,
         http2: bool | Omit = omit,
         is_xhr: bool | Omit = omit,
@@ -5437,8 +5437,8 @@ class AsyncNimble(AsyncAPIClient):
     async def extract_batch(
         self,
         *,
-        params: Iterable[client_extract_batch_params.Param],
-        shared_params: client_extract_batch_params.SharedParams | Omit = omit,
+        inputs: Iterable[client_extract_batch_params.Input],
+        shared_inputs: client_extract_batch_params.SharedInputs | 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,
@@ -5449,13 +5449,13 @@ class AsyncNimble(AsyncAPIClient):
         """Extract Batch Endpoint
 
         Args:
-          params: Array of extraction requests.
+          inputs: Array of extraction requests.
 
-        Each object represents one extraction with its own
-              parameters.
+        Each object can include extraction parameters and
+              async/storage settings.
 
-          shared_params: Shared parameters applied to the entire batch, such as storage and callback
-              configuration.
+          shared_inputs: Shared parameters applied to the entire batch. Can include extraction parameters
+              and async/storage settings.
 
           extra_headers: Send extra headers
 
@@ -5469,8 +5469,8 @@ class AsyncNimble(AsyncAPIClient):
             "/v1/extract/batch",
             body=await async_maybe_transform(
                 {
-                    "params": params,
-                    "shared_params": shared_params,
+                    "inputs": inputs,
+                    "shared_inputs": shared_inputs,
                 },
                 client_extract_batch_params.ClientExtractBatchParams,
             ),

{nimble_python-0.13.0 → nimble_python-0.15.0}/src/nimble_python/_qs.py

@@ -101,7 +101,10 @@ class Querystring:
                     items.extend(self._stringify_item(key, item, opts))
                 return items
             elif array_format == "indices":
-                raise NotImplementedError("The array indices format is not supported yet")
+                items = []
+                for i, item in enumerate(value):
+                    items.extend(self._stringify_item(f"{key}[{i}]", item, opts))
+                return items
             elif array_format == "brackets":
                 items = []
                 key = key + "[]"

{nimble_python-0.13.0 → nimble_python-0.15.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.13.0"  # x-release-please-version
+__version__ = "0.15.0"  # x-release-please-version

{nimble_python-0.13.0 → nimble_python-0.15.0}/src/nimble_python/resources/agent.py

@@ -2,12 +2,12 @@
 
 from __future__ import annotations
 
-from typing import Dict, Optional
+from typing import Dict, List, Iterable, Optional
 from typing_extensions import Literal
 
 import httpx
 
-from ..types import agent_run_params, agent_list_params, agent_run_async_params
+from ..types import agent_run_params, agent_list_params, agent_run_async_params, agent_run_batch_params
 from .._types import Body, Omit, Query, Headers, NotGiven, omit, not_given
 from .._utils import path_template, maybe_transform, async_maybe_transform
 from .._compat import cached_property
@@ -23,6 +23,7 @@ from ..types.agent_get_response import AgentGetResponse
 from ..types.agent_run_response import AgentRunResponse
 from ..types.agent_list_response import AgentListResponse
 from ..types.agent_run_async_response import AgentRunAsyncResponse
+from ..types.agent_run_batch_response import AgentRunBatchResponse
 
 __all__ = ["AgentResource", "AsyncAgentResource"]
 
@@ -143,6 +144,7 @@ class AgentResource(SyncAPIResource):
         *,
         agent: str,
         params: Dict[str, object],
+        formats: List[Literal["html", "markdown", "screenshot", "headers"]] | Omit = omit,
         localization: bool | 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.
@@ -151,10 +153,13 @@ class AgentResource(SyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> AgentRunResponse:
-        """
-        Execute WSA Realtime Endpoint
+        """Execute WSA Realtime Endpoint
 
         Args:
+          formats: Response formats to include.
+
+        All disabled by default.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -169,6 +174,7 @@ class AgentResource(SyncAPIResource):
                 {
                     "agent": agent,
                     "params": params,
+                    "formats": formats,
                     "localization": localization,
                 },
                 agent_run_params.AgentRunParams,
@@ -185,6 +191,7 @@ class AgentResource(SyncAPIResource):
         agent: str,
         params: Dict[str, object],
         callback_url: str | Omit = omit,
+        formats: List[Literal["html", "markdown", "screenshot", "headers"]] | Omit = omit,
         localization: bool | Omit = omit,
         storage_compress: bool | Omit = omit,
         storage_object_name: str | Omit = omit,
@@ -203,6 +210,8 @@ class AgentResource(SyncAPIResource):
         Args:
           callback_url: URL to call back when async operation completes
 
+          formats: Response formats to include. All disabled by default.
+
           storage_compress: Whether to compress stored data
 
           storage_object_name: Custom name for the stored object
@@ -226,6 +235,7 @@ class AgentResource(SyncAPIResource):
                     "agent": agent,
                     "params": params,
                     "callback_url": callback_url,
+                    "formats": formats,
                     "localization": localization,
                     "storage_compress": storage_compress,
                     "storage_object_name": storage_object_name,
@@ -240,6 +250,45 @@ class AgentResource(SyncAPIResource):
             cast_to=AgentRunAsyncResponse,
         )
 
+    def run_batch(
+        self,
+        *,
+        inputs: Iterable[agent_run_batch_params.Input],
+        shared_inputs: agent_run_batch_params.SharedInputs,
+        # 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,
+    ) -> AgentRunBatchResponse:
+        """
+        Execute WSA Batch Endpoint
+
+        Args:
+          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/agents/batch",
+            body=maybe_transform(
+                {
+                    "inputs": inputs,
+                    "shared_inputs": shared_inputs,
+                },
+                agent_run_batch_params.AgentRunBatchParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=AgentRunBatchResponse,
+        )
+
 
 class AsyncAgentResource(AsyncAPIResource):
     @cached_property
@@ -357,6 +406,7 @@ class AsyncAgentResource(AsyncAPIResource):
         *,
         agent: str,
         params: Dict[str, object],
+        formats: List[Literal["html", "markdown", "screenshot", "headers"]] | Omit = omit,
         localization: bool | 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.
@@ -365,10 +415,13 @@ class AsyncAgentResource(AsyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> AgentRunResponse:
-        """
-        Execute WSA Realtime Endpoint
+        """Execute WSA Realtime Endpoint
 
         Args:
+          formats: Response formats to include.
+
+        All disabled by default.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -383,6 +436,7 @@ class AsyncAgentResource(AsyncAPIResource):
                 {
                     "agent": agent,
                     "params": params,
+                    "formats": formats,
                     "localization": localization,
                 },
                 agent_run_params.AgentRunParams,
@@ -399,6 +453,7 @@ class AsyncAgentResource(AsyncAPIResource):
         agent: str,
         params: Dict[str, object],
         callback_url: str | Omit = omit,
+        formats: List[Literal["html", "markdown", "screenshot", "headers"]] | Omit = omit,
         localization: bool | Omit = omit,
         storage_compress: bool | Omit = omit,
         storage_object_name: str | Omit = omit,
@@ -417,6 +472,8 @@ class AsyncAgentResource(AsyncAPIResource):
         Args:
           callback_url: URL to call back when async operation completes
 
+          formats: Response formats to include. All disabled by default.
+
           storage_compress: Whether to compress stored data
 
           storage_object_name: Custom name for the stored object
@@ -440,6 +497,7 @@ class AsyncAgentResource(AsyncAPIResource):
                     "agent": agent,
                     "params": params,
                     "callback_url": callback_url,
+                    "formats": formats,
                     "localization": localization,
                     "storage_compress": storage_compress,
                     "storage_object_name": storage_object_name,
@@ -454,6 +512,45 @@ class AsyncAgentResource(AsyncAPIResource):
             cast_to=AgentRunAsyncResponse,
         )
 
+    async def run_batch(
+        self,
+        *,
+        inputs: Iterable[agent_run_batch_params.Input],
+        shared_inputs: agent_run_batch_params.SharedInputs,
+        # 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,
+    ) -> AgentRunBatchResponse:
+        """
+        Execute WSA Batch Endpoint
+
+        Args:
+          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/agents/batch",
+            body=await async_maybe_transform(
+                {
+                    "inputs": inputs,
+                    "shared_inputs": shared_inputs,
+                },
+                agent_run_batch_params.AgentRunBatchParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=AgentRunBatchResponse,
+        )
+
 
 class AgentResourceWithRawResponse:
     def __init__(self, agent: AgentResource) -> None:
@@ -471,6 +568,9 @@ class AgentResourceWithRawResponse:
         self.run_async = to_raw_response_wrapper(
             agent.run_async,
         )
+        self.run_batch = to_raw_response_wrapper(
+            agent.run_batch,
+        )
 
 
 class AsyncAgentResourceWithRawResponse:
@@ -489,6 +589,9 @@ class AsyncAgentResourceWithRawResponse:
         self.run_async = async_to_raw_response_wrapper(
             agent.run_async,
         )
+        self.run_batch = async_to_raw_response_wrapper(
+            agent.run_batch,
+        )
 
 
 class AgentResourceWithStreamingResponse:
@@ -507,6 +610,9 @@ class AgentResourceWithStreamingResponse:
         self.run_async = to_streamed_response_wrapper(
             agent.run_async,
         )
+        self.run_batch = to_streamed_response_wrapper(
+            agent.run_batch,
+        )
 
 
 class AsyncAgentResourceWithStreamingResponse:
@@ -525,3 +631,6 @@ class AsyncAgentResourceWithStreamingResponse:
         self.run_async = async_to_streamed_response_wrapper(
             agent.run_async,
         )
+        self.run_batch = async_to_streamed_response_wrapper(
+            agent.run_batch,
+        )

{nimble_python-0.13.0 → nimble_python-0.15.0}/src/nimble_python/types/__init__.py

@@ -39,10 +39,12 @@ from .client_extract_params import ClientExtractParams as ClientExtractParams
 from .crawl_status_response import CrawlStatusResponse as CrawlStatusResponse
 from .task_results_response import TaskResultsResponse as TaskResultsResponse
 from .agent_run_async_params import AgentRunAsyncParams as AgentRunAsyncParams
+from .agent_run_batch_params import AgentRunBatchParams as AgentRunBatchParams
 from .extract_async_response import ExtractAsyncResponse as ExtractAsyncResponse
 from .extract_batch_response import ExtractBatchResponse as ExtractBatchResponse
 from .batch_progress_response import BatchProgressResponse as BatchProgressResponse
 from .agent_run_async_response import AgentRunAsyncResponse as AgentRunAsyncResponse
+from .agent_run_batch_response import AgentRunBatchResponse as AgentRunBatchResponse
 from .crawl_terminate_response import CrawlTerminateResponse as CrawlTerminateResponse
 from .client_extract_async_params import ClientExtractAsyncParams as ClientExtractAsyncParams
 from .client_extract_batch_params import ClientExtractBatchParams as ClientExtractBatchParams

{nimble_python-0.13.0 → nimble_python-0.15.0}/src/nimble_python/types/agent_run_async_params.py

@@ -2,8 +2,8 @@
 
 from __future__ import annotations
 
-from typing import Dict
-from typing_extensions import Required, TypedDict
+from typing import Dict, List
+from typing_extensions import Literal, Required, TypedDict
 
 __all__ = ["AgentRunAsyncParams"]
 
@@ -16,6 +16,9 @@ class AgentRunAsyncParams(TypedDict, total=False):
     callback_url: str
     """URL to call back when async operation completes"""
 
+    formats: List[Literal["html", "markdown", "screenshot", "headers"]]
+    """Response formats to include. All disabled by default."""
+
     localization: bool
 
     storage_compress: bool

nimble_python-0.15.0/src/nimble_python/types/agent_run_batch_params.py

@@ -0,0 +1,34 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Dict, List, Iterable
+from typing_extensions import Literal, Required, TypedDict
+
+__all__ = ["AgentRunBatchParams", "Input", "SharedInputs"]
+
+
+class AgentRunBatchParams(TypedDict, total=False):
+    inputs: Required[Iterable[Input]]
+
+    shared_inputs: Required[SharedInputs]
+
+
+class Input(TypedDict, total=False):
+    formats: List[Literal["html", "markdown", "screenshot", "headers"]]
+    """Response formats to include. All disabled by default."""
+
+    localization: bool
+
+    params: Dict[str, object]
+
+
+class SharedInputs(TypedDict, total=False):
+    agent: Required[str]
+
+    formats: List[Literal["html", "markdown", "screenshot", "headers"]]
+    """Response formats to include. All disabled by default."""
+
+    localization: bool
+
+    params: Dict[str, object]

nimble_python-0.15.0/src/nimble_python/types/agent_run_batch_response.py

@@ -0,0 +1,68 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Optional
+from typing_extensions import Literal
+
+from pydantic import Field as FieldInfo
+
+from .._models import BaseModel
+
+__all__ = ["AgentRunBatchResponse", "Task"]
+
+
+class Task(BaseModel):
+    id: str
+    """Unique task identifier."""
+
+    api_query: object = FieldInfo(alias="_query")
+
+    created_at: str
+    """Timestamp when the task was created."""
+
+    input: object
+    """Original input data for the task."""
+
+    state: Literal["pending", "success", "error"]
+    """Current state of the task."""
+
+    status_url: str
+    """URL for checking the task status."""
+
+    account_name: Optional[str] = None
+    """Account name that owns the task."""
+
+    api_type: Optional[Literal["web", "serp", "ecommerce", "social", "media", "agent", "extract"]] = None
+
+    batch_id: Optional[str] = None
+    """Batch ID if this task is part of a batch."""
+
+    download_url: Optional[str] = None
+    """URL for downloading the task results."""
+
+    error: Optional[str] = None
+    """Error message if the task failed."""
+
+    error_type: Optional[str] = None
+    """Classification of the error type."""
+
+    modified_at: Optional[str] = None
+    """Timestamp when the task was last modified."""
+
+    output_url: Optional[str] = None
+    """Storage location of the output data."""
+
+    status_code: Optional[float] = None
+    """HTTP status code from the task execution."""
+
+
+class AgentRunBatchResponse(BaseModel):
+    """Response when a batch of extract tasks is created successfully."""
+
+    batch_id: str
+    """Unique identifier for the batch."""
+
+    batch_size: float
+    """Number of tasks in the batch."""
+
+    tasks: List[Task]
+    """List of created tasks."""

{nimble_python-0.13.0 → nimble_python-0.15.0}/src/nimble_python/types/agent_run_params.py

@@ -2,8 +2,8 @@
 
 from __future__ import annotations
 
-from typing import Dict
-from typing_extensions import Required, TypedDict
+from typing import Dict, List
+from typing_extensions import Literal, Required, TypedDict
 
 __all__ = ["AgentRunParams"]
 
@@ -13,4 +13,7 @@ class AgentRunParams(TypedDict, total=False):
 
     params: Required[Dict[str, object]]
 
+    formats: List[Literal["html", "markdown", "screenshot", "headers"]]
+    """Response formats to include. All disabled by default."""
+
     localization: bool

{nimble_python-0.13.0 → nimble_python-0.15.0}/src/nimble_python/types/agent_run_response.py

@@ -246,6 +246,9 @@ class Data(BaseModel):
     network_capture: Optional[List[DataNetworkCapture]] = None
     """The network capture data collected during the task."""
 
+    pages_html: Optional[List[str]] = None
+    """Individual HTML content of each pagination page, before merging."""
+
     parsing: Optional[DataParsing] = None
     """The parsing results extracted from the HTML & network content."""
 

{nimble_python-0.13.0 → nimble_python-0.15.0}/src/nimble_python/types/client_extract_async_params.py

@@ -319,7 +319,7 @@ class ClientExtractAsyncParams(TypedDict, total=False):
     expected_status_codes: Iterable[int]
     """Expected HTTP status codes for successful requests"""
 
-    formats: List[Literal["html", "markdown", "screenshot"]]
+    formats: List[Literal["html", "markdown", "screenshot", "headers"]]
     """List of acceptable response formats in order of preference"""
 
     headers: Dict[str, Union[str, SequenceNotStr[str], None]]