nimble_python 0.16.0__py3-none-any.whl → 0.17.0__py3-none-any.whl

nimble_python/_base_client.py

@@ -540,6 +540,10 @@ class BaseClient(Generic[_HttpxClientT, _DefaultStreamT]):
                 files = cast(HttpxRequestFiles, ForceMultipartDict())
 
         prepared_url = self._prepare_url(options.url)
+        # preserve hard-coded query params from the url
+        if params and prepared_url.query:
+            params = {**dict(prepared_url.params.items()), **params}
+            prepared_url = prepared_url.copy_with(raw_path=prepared_url.raw_path.split(b"?", 1)[0])
         if "_" in prepared_url.host:
             # work around https://github.com/encode/httpx/discussions/2880
             kwargs["extensions"] = {"sni_hostname": prepared_url.host.replace("_", "-")}

nimble_python/_client.py

@@ -33,6 +33,7 @@ from ._types import (
 )
 from ._utils import (
     is_given,
+    is_mapping_t,
     maybe_transform,
     get_async_library,
     async_maybe_transform,
@@ -72,11 +73,13 @@ __all__ = ["Timeout", "Transport", "ProxiesTypes", "RequestOptions", "Nimble", "
 class Nimble(SyncAPIClient):
     # client options
     api_key: str | None
+    client_source: str | None
 
     def __init__(
         self,
         *,
         api_key: str | None = None,
+        client_source: str | None = None,
         base_url: str | httpx.URL | None = None,
         timeout: float | Timeout | None | NotGiven = not_given,
         max_retries: int = DEFAULT_MAX_RETRIES,
@@ -98,17 +101,32 @@ class Nimble(SyncAPIClient):
     ) -> None:
         """Construct a new synchronous Nimble client instance.
 
-        This automatically infers the `api_key` argument from the `NIMBLE_API_KEY` environment variable if it is not provided.
+        This automatically infers the following arguments from their corresponding environment variables if they are not provided:
+        - `api_key` from `NIMBLE_API_KEY`
+        - `client_source` from `CLIENT_SOURCE`
         """
         if api_key is None:
             api_key = os.environ.get("NIMBLE_API_KEY")
         self.api_key = api_key
 
+        if client_source is None:
+            client_source = os.environ.get("CLIENT_SOURCE") or "sdk"
+        self.client_source = client_source
+
         if base_url is None:
             base_url = os.environ.get("NIMBLE_BASE_URL")
         if base_url is None:
             base_url = f"https://sdk.nimbleway.com"
 
+        custom_headers_env = os.environ.get("NIMBLE_CUSTOM_HEADERS")
+        if custom_headers_env is not None:
+            parsed: dict[str, str] = {}
+            for line in custom_headers_env.split("\n"):
+                colon = line.find(":")
+                if colon >= 0:
+                    parsed[line[:colon].strip()] = line[colon + 1 :].strip()
+            default_headers = {**parsed, **(default_headers if is_mapping_t(default_headers) else {})}
+
         super().__init__(
             version=__version__,
             base_url=base_url,
@@ -171,6 +189,7 @@ class Nimble(SyncAPIClient):
         return {
             **super().default_headers,
             "X-Stainless-Async": "false",
+            "X-Client-Source": self.client_source if self.client_source is not None else Omit(),
             **self._custom_headers,
         }
 
@@ -187,6 +206,7 @@ class Nimble(SyncAPIClient):
         self,
         *,
         api_key: str | None = None,
+        client_source: str | None = None,
         base_url: str | httpx.URL | None = None,
         timeout: float | Timeout | None | NotGiven = not_given,
         http_client: httpx.Client | None = None,
@@ -221,6 +241,7 @@ class Nimble(SyncAPIClient):
         http_client = http_client or self._client
         return self.__class__(
             api_key=api_key or self.api_key,
+            client_source=client_source or self.client_source,
             base_url=base_url or self.base_url,
             timeout=self.timeout if isinstance(timeout, NotGiven) else timeout,
             http_client=http_client,
@@ -498,9 +519,9 @@ class Nimble(SyncAPIClient):
         ]
         | Omit = omit,
         device: Literal["desktop", "mobile", "tablet"] | Omit = omit,
-        driver: Literal["vx6", "vx8", "vx8-pro", "vx10", "vx10-pro", "vx12", "vx12-pro"] | Omit = omit,
+        driver: Literal["vx6", "vx8", "vx8-pro", "vx10", "vx10-pro", "vx12", "vx12-pro", "media-vx6"] | Omit = omit,
         expected_status_codes: Iterable[int] | Omit = omit,
-        formats: List[Literal["html", "markdown", "screenshot", "headers"]] | Omit = omit,
+        formats: List[Literal["html", "markdown", "screenshot", "headers", "links"]] | Omit = omit,
         headers: Dict[str, Union[str, SequenceNotStr[str], None]] | Omit = omit,
         http2: bool | Omit = omit,
         is_xhr: bool | Omit = omit,
@@ -1040,6 +1061,7 @@ class Nimble(SyncAPIClient):
             "auto",
         ]
         | Omit = omit,
+        markdown_backend: Literal["full_page", "main_content"] | Omit = omit,
         method: Literal["GET", "POST", "PUT", "PATCH", "DELETE"] | Omit = omit,
         network_capture: Iterable[client_extract_params.NetworkCapture] | Omit = omit,
         os: Literal["windows", "mac os", "linux", "android", "ios"] | Omit = omit,
@@ -1154,6 +1176,10 @@ class Nimble(SyncAPIClient):
 
           locale: Locale for browser language and region settings
 
+          markdown_backend: Selects which markdown conversion strategy to use. "full_page" converts the
+              entire HTML page. "main_content" uses Mozilla Readability to extract the main
+              article content before converting.
+
           method: HTTP method for the request
 
           network_capture: Filters for capturing network traffic
@@ -1203,6 +1229,7 @@ class Nimble(SyncAPIClient):
                     "http2": http2,
                     "is_xhr": is_xhr,
                     "locale": locale,
+                    "markdown_backend": markdown_backend,
                     "method": method,
                     "network_capture": network_capture,
                     "os": os,
@@ -1489,9 +1516,9 @@ class Nimble(SyncAPIClient):
         ]
         | Omit = omit,
         device: Literal["desktop", "mobile", "tablet"] | Omit = omit,
-        driver: Literal["vx6", "vx8", "vx8-pro", "vx10", "vx10-pro", "vx12", "vx12-pro"] | Omit = omit,
+        driver: Literal["vx6", "vx8", "vx8-pro", "vx10", "vx10-pro", "vx12", "vx12-pro", "media-vx6"] | Omit = omit,
         expected_status_codes: Iterable[int] | Omit = omit,
-        formats: List[Literal["html", "markdown", "screenshot", "headers"]] | Omit = omit,
+        formats: List[Literal["html", "markdown", "screenshot", "headers", "links"]] | Omit = omit,
         headers: Dict[str, Union[str, SequenceNotStr[str], None]] | Omit = omit,
         http2: bool | Omit = omit,
         is_xhr: bool | Omit = omit,
@@ -2031,6 +2058,7 @@ class Nimble(SyncAPIClient):
             "auto",
         ]
         | Omit = omit,
+        markdown_backend: Literal["full_page", "main_content"] | Omit = omit,
         method: Literal["GET", "POST", "PUT", "PATCH", "DELETE"] | Omit = omit,
         network_capture: Iterable[client_extract_async_params.NetworkCapture] | Omit = omit,
         os: Literal["windows", "mac os", "linux", "android", "ios"] | Omit = omit,
@@ -2151,6 +2179,10 @@ class Nimble(SyncAPIClient):
 
           locale: Locale for browser language and region settings
 
+          markdown_backend: Selects which markdown conversion strategy to use. "full_page" converts the
+              entire HTML page. "main_content" uses Mozilla Readability to extract the main
+              article content before converting.
+
           method: HTTP method for the request
 
           network_capture: Filters for capturing network traffic
@@ -2209,6 +2241,7 @@ class Nimble(SyncAPIClient):
                     "http2": http2,
                     "is_xhr": is_xhr,
                     "locale": locale,
+                    "markdown_backend": markdown_backend,
                     "method": method,
                     "network_capture": network_capture,
                     "os": os,
@@ -3272,11 +3305,13 @@ class Nimble(SyncAPIClient):
 class AsyncNimble(AsyncAPIClient):
     # client options
     api_key: str | None
+    client_source: str | None
 
     def __init__(
         self,
         *,
         api_key: str | None = None,
+        client_source: str | None = None,
         base_url: str | httpx.URL | None = None,
         timeout: float | Timeout | None | NotGiven = not_given,
         max_retries: int = DEFAULT_MAX_RETRIES,
@@ -3298,17 +3333,32 @@ class AsyncNimble(AsyncAPIClient):
     ) -> None:
         """Construct a new async AsyncNimble client instance.
 
-        This automatically infers the `api_key` argument from the `NIMBLE_API_KEY` environment variable if it is not provided.
+        This automatically infers the following arguments from their corresponding environment variables if they are not provided:
+        - `api_key` from `NIMBLE_API_KEY`
+        - `client_source` from `CLIENT_SOURCE`
         """
         if api_key is None:
             api_key = os.environ.get("NIMBLE_API_KEY")
         self.api_key = api_key
 
+        if client_source is None:
+            client_source = os.environ.get("CLIENT_SOURCE") or "sdk"
+        self.client_source = client_source
+
         if base_url is None:
             base_url = os.environ.get("NIMBLE_BASE_URL")
         if base_url is None:
             base_url = f"https://sdk.nimbleway.com"
 
+        custom_headers_env = os.environ.get("NIMBLE_CUSTOM_HEADERS")
+        if custom_headers_env is not None:
+            parsed: dict[str, str] = {}
+            for line in custom_headers_env.split("\n"):
+                colon = line.find(":")
+                if colon >= 0:
+                    parsed[line[:colon].strip()] = line[colon + 1 :].strip()
+            default_headers = {**parsed, **(default_headers if is_mapping_t(default_headers) else {})}
+
         super().__init__(
             version=__version__,
             base_url=base_url,
@@ -3371,6 +3421,7 @@ class AsyncNimble(AsyncAPIClient):
         return {
             **super().default_headers,
             "X-Stainless-Async": f"async:{get_async_library()}",
+            "X-Client-Source": self.client_source if self.client_source is not None else Omit(),
             **self._custom_headers,
         }
 
@@ -3387,6 +3438,7 @@ class AsyncNimble(AsyncAPIClient):
         self,
         *,
         api_key: str | None = None,
+        client_source: str | None = None,
         base_url: str | httpx.URL | None = None,
         timeout: float | Timeout | None | NotGiven = not_given,
         http_client: httpx.AsyncClient | None = None,
@@ -3421,6 +3473,7 @@ class AsyncNimble(AsyncAPIClient):
         http_client = http_client or self._client
         return self.__class__(
             api_key=api_key or self.api_key,
+            client_source=client_source or self.client_source,
             base_url=base_url or self.base_url,
             timeout=self.timeout if isinstance(timeout, NotGiven) else timeout,
             http_client=http_client,
@@ -3698,9 +3751,9 @@ class AsyncNimble(AsyncAPIClient):
         ]
         | Omit = omit,
         device: Literal["desktop", "mobile", "tablet"] | Omit = omit,
-        driver: Literal["vx6", "vx8", "vx8-pro", "vx10", "vx10-pro", "vx12", "vx12-pro"] | Omit = omit,
+        driver: Literal["vx6", "vx8", "vx8-pro", "vx10", "vx10-pro", "vx12", "vx12-pro", "media-vx6"] | Omit = omit,
         expected_status_codes: Iterable[int] | Omit = omit,
-        formats: List[Literal["html", "markdown", "screenshot", "headers"]] | Omit = omit,
+        formats: List[Literal["html", "markdown", "screenshot", "headers", "links"]] | Omit = omit,
         headers: Dict[str, Union[str, SequenceNotStr[str], None]] | Omit = omit,
         http2: bool | Omit = omit,
         is_xhr: bool | Omit = omit,
@@ -4240,6 +4293,7 @@ class AsyncNimble(AsyncAPIClient):
             "auto",
         ]
         | Omit = omit,
+        markdown_backend: Literal["full_page", "main_content"] | Omit = omit,
         method: Literal["GET", "POST", "PUT", "PATCH", "DELETE"] | Omit = omit,
         network_capture: Iterable[client_extract_params.NetworkCapture] | Omit = omit,
         os: Literal["windows", "mac os", "linux", "android", "ios"] | Omit = omit,
@@ -4354,6 +4408,10 @@ class AsyncNimble(AsyncAPIClient):
 
           locale: Locale for browser language and region settings
 
+          markdown_backend: Selects which markdown conversion strategy to use. "full_page" converts the
+              entire HTML page. "main_content" uses Mozilla Readability to extract the main
+              article content before converting.
+
           method: HTTP method for the request
 
           network_capture: Filters for capturing network traffic
@@ -4403,6 +4461,7 @@ class AsyncNimble(AsyncAPIClient):
                     "http2": http2,
                     "is_xhr": is_xhr,
                     "locale": locale,
+                    "markdown_backend": markdown_backend,
                     "method": method,
                     "network_capture": network_capture,
                     "os": os,
@@ -4689,9 +4748,9 @@ class AsyncNimble(AsyncAPIClient):
         ]
         | Omit = omit,
         device: Literal["desktop", "mobile", "tablet"] | Omit = omit,
-        driver: Literal["vx6", "vx8", "vx8-pro", "vx10", "vx10-pro", "vx12", "vx12-pro"] | Omit = omit,
+        driver: Literal["vx6", "vx8", "vx8-pro", "vx10", "vx10-pro", "vx12", "vx12-pro", "media-vx6"] | Omit = omit,
         expected_status_codes: Iterable[int] | Omit = omit,
-        formats: List[Literal["html", "markdown", "screenshot", "headers"]] | Omit = omit,
+        formats: List[Literal["html", "markdown", "screenshot", "headers", "links"]] | Omit = omit,
         headers: Dict[str, Union[str, SequenceNotStr[str], None]] | Omit = omit,
         http2: bool | Omit = omit,
         is_xhr: bool | Omit = omit,
@@ -5231,6 +5290,7 @@ class AsyncNimble(AsyncAPIClient):
             "auto",
         ]
         | Omit = omit,
+        markdown_backend: Literal["full_page", "main_content"] | Omit = omit,
         method: Literal["GET", "POST", "PUT", "PATCH", "DELETE"] | Omit = omit,
         network_capture: Iterable[client_extract_async_params.NetworkCapture] | Omit = omit,
         os: Literal["windows", "mac os", "linux", "android", "ios"] | Omit = omit,
@@ -5351,6 +5411,10 @@ class AsyncNimble(AsyncAPIClient):
 
           locale: Locale for browser language and region settings
 
+          markdown_backend: Selects which markdown conversion strategy to use. "full_page" converts the
+              entire HTML page. "main_content" uses Mozilla Readability to extract the main
+              article content before converting.
+
           method: HTTP method for the request
 
           network_capture: Filters for capturing network traffic
@@ -5409,6 +5473,7 @@ class AsyncNimble(AsyncAPIClient):
                     "http2": http2,
                     "is_xhr": is_xhr,
                     "locale": locale,
+                    "markdown_backend": markdown_backend,
                     "method": method,
                     "network_capture": network_capture,
                     "os": os,

nimble_python/_files.py

@@ -3,8 +3,8 @@ from __future__ import annotations
 import io
 import os
 import pathlib
-from typing import overload
-from typing_extensions import TypeGuard
+from typing import Sequence, cast, overload
+from typing_extensions import TypeVar, TypeGuard
 
 import anyio
 
@@ -17,7 +17,9 @@ from ._types import (
     HttpxFileContent,
     HttpxRequestFiles,
 )
-from ._utils import is_tuple_t, is_mapping_t, is_sequence_t
+from ._utils import is_list, is_mapping, is_tuple_t, is_mapping_t, is_sequence_t
+
+_T = TypeVar("_T")
 
 
 def is_base64_file_input(obj: object) -> TypeGuard[Base64FileInput]:
@@ -121,3 +123,51 @@ async def async_read_file_content(file: FileContent) -> HttpxFileContent:
         return await anyio.Path(file).read_bytes()
 
     return file
+
+
+def deepcopy_with_paths(item: _T, paths: Sequence[Sequence[str]]) -> _T:
+    """Copy only the containers along the given paths.
+
+    Used to guard against mutation by extract_files without copying the entire structure.
+    Only dicts and lists that lie on a path are copied; everything else
+    is returned by reference.
+
+    For example, given paths=[["foo", "files", "file"]] and the structure:
+        {
+            "foo": {
+                "bar": {"baz": {}},
+                "files": {"file": <content>}
+            }
+        }
+    The root dict, "foo", and "files" are copied (they lie on the path).
+    "bar" and "baz" are returned by reference (off the path).
+    """
+    return _deepcopy_with_paths(item, paths, 0)
+
+
+def _deepcopy_with_paths(item: _T, paths: Sequence[Sequence[str]], index: int) -> _T:
+    if not paths:
+        return item
+    if is_mapping(item):
+        key_to_paths: dict[str, list[Sequence[str]]] = {}
+        for path in paths:
+            if index < len(path):
+                key_to_paths.setdefault(path[index], []).append(path)
+
+        # if no path continues through this mapping, it won't be mutated and copying it is redundant
+        if not key_to_paths:
+            return item
+
+        result = dict(item)
+        for key, subpaths in key_to_paths.items():
+            if key in result:
+                result[key] = _deepcopy_with_paths(result[key], subpaths, index + 1)
+        return cast(_T, result)
+    if is_list(item):
+        array_paths = [path for path in paths if index < len(path) and path[index] == "<array>"]
+
+        # if no path expects a list here, nothing will be mutated inside it - return by reference
+        if not array_paths:
+            return cast(_T, item)
+        return cast(_T, [_deepcopy_with_paths(entry, array_paths, index + 1) for entry in item])
+    return item

nimble_python/_qs.py

@@ -2,17 +2,13 @@ from __future__ import annotations
 
 from typing import Any, List, Tuple, Union, Mapping, TypeVar
 from urllib.parse import parse_qs, urlencode
-from typing_extensions import Literal, get_args
+from typing_extensions import get_args
 
-from ._types import NotGiven, not_given
+from ._types import NotGiven, ArrayFormat, NestedFormat, not_given
 from ._utils import flatten
 
 _T = TypeVar("_T")
 
-
-ArrayFormat = Literal["comma", "repeat", "indices", "brackets"]
-NestedFormat = Literal["dots", "brackets"]
-
 PrimitiveData = Union[str, int, float, bool, None]
 # this should be Data = Union[PrimitiveData, "List[Data]", "Tuple[Data]", "Mapping[str, Data]"]
 # https://github.com/microsoft/pyright/issues/3555

nimble_python/_types.py

@@ -47,6 +47,9 @@ AnyMapping = Mapping[str, object]
 ModelT = TypeVar("ModelT", bound=pydantic.BaseModel)
 _T = TypeVar("_T")
 
+ArrayFormat = Literal["comma", "repeat", "indices", "brackets"]
+NestedFormat = Literal["dots", "brackets"]
+
 
 # Approximates httpx internal ProxiesTypes and RequestFiles types
 # while adding support for `PathLike` instances

nimble_python/_utils/__init__.py

@@ -24,7 +24,6 @@ from ._utils import (
     coerce_integer as coerce_integer,
     file_from_path as file_from_path,
     strip_not_given as strip_not_given,
-    deepcopy_minimal as deepcopy_minimal,
     get_async_library as get_async_library,
     maybe_coerce_float as maybe_coerce_float,
     get_required_header as get_required_header,

nimble_python/_utils/_utils.py

@@ -17,11 +17,11 @@ from typing import (
 )
 from pathlib import Path
 from datetime import date, datetime
-from typing_extensions import TypeGuard
+from typing_extensions import TypeGuard, get_args
 
 import sniffio
 
-from .._types import Omit, NotGiven, FileTypes, HeadersLike
+from .._types import Omit, NotGiven, FileTypes, ArrayFormat, HeadersLike
 
 _T = TypeVar("_T")
 _TupleT = TypeVar("_TupleT", bound=Tuple[object, ...])
@@ -40,25 +40,45 @@ def extract_files(
     query: Mapping[str, object],
     *,
     paths: Sequence[Sequence[str]],
+    array_format: ArrayFormat = "brackets",
 ) -> list[tuple[str, FileTypes]]:
     """Recursively extract files from the given dictionary based on specified paths.
 
     A path may look like this ['foo', 'files', '<array>', 'data'].
 
+    ``array_format`` controls how ``<array>`` segments contribute to the emitted
+    field name. Supported values: ``"brackets"`` (``foo[]``), ``"repeat"`` and
+    ``"comma"`` (``foo``), ``"indices"`` (``foo[0]``, ``foo[1]``).
+
     Note: this mutates the given dictionary.
     """
     files: list[tuple[str, FileTypes]] = []
     for path in paths:
-        files.extend(_extract_items(query, path, index=0, flattened_key=None))
+        files.extend(_extract_items(query, path, index=0, flattened_key=None, array_format=array_format))
     return files
 
 
+def _array_suffix(array_format: ArrayFormat, array_index: int) -> str:
+    if array_format == "brackets":
+        return "[]"
+    if array_format == "indices":
+        return f"[{array_index}]"
+    if array_format == "repeat" or array_format == "comma":
+        # Both repeat the bare field name for each file part; there is no
+        # meaningful way to comma-join binary parts.
+        return ""
+    raise NotImplementedError(
+        f"Unknown array_format value: {array_format}, choose from {', '.join(get_args(ArrayFormat))}"
+    )
+
+
 def _extract_items(
     obj: object,
     path: Sequence[str],
     *,
     index: int,
     flattened_key: str | None,
+    array_format: ArrayFormat,
 ) -> list[tuple[str, FileTypes]]:
     try:
         key = path[index]
@@ -75,9 +95,11 @@ def _extract_items(
 
         if is_list(obj):
             files: list[tuple[str, FileTypes]] = []
-            for entry in obj:
-                assert_is_file_content(entry, key=flattened_key + "[]" if flattened_key else "")
-                files.append((flattened_key + "[]", cast(FileTypes, entry)))
+            for array_index, entry in enumerate(obj):
+                suffix = _array_suffix(array_format, array_index)
+                emitted_key = (flattened_key + suffix) if flattened_key else suffix
+                assert_is_file_content(entry, key=emitted_key)
+                files.append((emitted_key, cast(FileTypes, entry)))
             return files
 
         assert_is_file_content(obj, key=flattened_key)
@@ -86,8 +108,9 @@ def _extract_items(
     index += 1
     if is_dict(obj):
         try:
-            # We are at the last entry in the path so we must remove the field
-            if (len(path)) == index:
+            # Remove the field if there are no more dict keys in the path,
+            # only "<array>" traversal markers or end.
+            if all(p == "<array>" for p in path[index:]):
                 item = obj.pop(key)
             else:
                 item = obj[key]
@@ -105,6 +128,7 @@ def _extract_items(
             path,
             index=index,
             flattened_key=flattened_key,
+            array_format=array_format,
         )
     elif is_list(obj):
         if key != "<array>":
@@ -116,9 +140,12 @@ def _extract_items(
                     item,
                     path,
                     index=index,
-                    flattened_key=flattened_key + "[]" if flattened_key is not None else "[]",
+                    flattened_key=(
+                        (flattened_key if flattened_key is not None else "") + _array_suffix(array_format, array_index)
+                    ),
+                    array_format=array_format,
                 )
-                for item in obj
+                for array_index, item in enumerate(obj)
             ]
         )
 
@@ -176,21 +203,6 @@ def is_iterable(obj: object) -> TypeGuard[Iterable[object]]:
     return isinstance(obj, Iterable)
 
 
-def deepcopy_minimal(item: _T) -> _T:
-    """Minimal reimplementation of copy.deepcopy() that will only copy certain object types:
-
-    - mappings, e.g. `dict`
-    - list
-
-    This is done for performance reasons.
-    """
-    if is_mapping(item):
-        return cast(_T, {k: deepcopy_minimal(v) for k, v in item.items()})
-    if is_list(item):
-        return cast(_T, [deepcopy_minimal(entry) for entry in item])
-    return item
-
-
 # copied from https://github.com/Rapptz/RoboDanny
 def human_join(seq: Sequence[str], *, delim: str = ", ", final: str = "or") -> str:
     size = len(seq)

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.16.0"  # x-release-please-version
+__version__ = "0.17.0"  # x-release-please-version

nimble_python/resources/agent.py

@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+import typing_extensions
 from typing import Dict, List, Iterable, Optional
 from typing_extensions import Literal, overload
 
@@ -120,11 +121,11 @@ class AgentResource(SyncAPIResource):
     def generate(
         self,
         *,
-        agent_name: str,
         prompt: str,
         url: str,
+        agent_name: Optional[str] | Omit = omit,
         input_schema: object | Omit = omit,
-        metadata: Optional[object] | Omit = omit,
+        metadata: Optional[agent_generate_params.CreateAgentGenerationRequestMetadata] | Omit = omit,
         output_schema: 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.
@@ -174,15 +175,15 @@ class AgentResource(SyncAPIResource):
         """
         ...
 
-    @required_args(["agent_name", "prompt", "url"], ["from_agent", "prompt"])
+    @required_args(["prompt", "url"], ["from_agent", "prompt"])
     def generate(
         self,
         *,
-        agent_name: str | Omit = omit,
         prompt: str,
         url: str | Omit = omit,
+        agent_name: Optional[str] | Omit = omit,
         input_schema: object | Omit = omit,
-        metadata: Optional[object] | Omit = omit,
+        metadata: Optional[agent_generate_params.CreateAgentGenerationRequestMetadata] | Omit = omit,
         output_schema: 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 +197,9 @@ class AgentResource(SyncAPIResource):
             "/v1/agents/generations",
             body=maybe_transform(
                 {
-                    "agent_name": agent_name,
                     "prompt": prompt,
                     "url": url,
+                    "agent_name": agent_name,
                     "input_schema": input_schema,
                     "metadata": metadata,
                     "output_schema": output_schema,
@@ -278,6 +279,7 @@ class AgentResource(SyncAPIResource):
             cast_to=AgentGetGenerationResponse,
         )
 
+    @typing_extensions.deprecated("deprecated")
     def publish(
         self,
         agent_name: str,
@@ -318,7 +320,7 @@ class AgentResource(SyncAPIResource):
         *,
         agent: str,
         params: Dict[str, object],
-        formats: List[Literal["html", "markdown", "screenshot", "headers"]] | Omit = omit,
+        formats: List[Literal["html", "markdown", "screenshot", "headers", "links"]] | 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,7 +367,7 @@ class AgentResource(SyncAPIResource):
         agent: str,
         params: Dict[str, object],
         callback_url: str | Omit = omit,
-        formats: List[Literal["html", "markdown", "screenshot", "headers"]] | Omit = omit,
+        formats: List[Literal["html", "markdown", "screenshot", "headers", "links"]] | Omit = omit,
         localization: bool | Omit = omit,
         storage_compress: bool | Omit = omit,
         storage_object_name: str | Omit = omit,
@@ -546,11 +548,11 @@ class AsyncAgentResource(AsyncAPIResource):
     async def generate(
         self,
         *,
-        agent_name: str,
         prompt: str,
         url: str,
+        agent_name: Optional[str] | Omit = omit,
         input_schema: object | Omit = omit,
-        metadata: Optional[object] | Omit = omit,
+        metadata: Optional[agent_generate_params.CreateAgentGenerationRequestMetadata] | Omit = omit,
         output_schema: 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.
@@ -600,15 +602,15 @@ class AsyncAgentResource(AsyncAPIResource):
         """
         ...
 
-    @required_args(["agent_name", "prompt", "url"], ["from_agent", "prompt"])
+    @required_args(["prompt", "url"], ["from_agent", "prompt"])
     async def generate(
         self,
         *,
-        agent_name: str | Omit = omit,
         prompt: str,
         url: str | Omit = omit,
+        agent_name: Optional[str] | Omit = omit,
         input_schema: object | Omit = omit,
-        metadata: Optional[object] | Omit = omit,
+        metadata: Optional[agent_generate_params.CreateAgentGenerationRequestMetadata] | Omit = omit,
         output_schema: 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.
@@ -622,9 +624,9 @@ class AsyncAgentResource(AsyncAPIResource):
             "/v1/agents/generations",
             body=await async_maybe_transform(
                 {
-                    "agent_name": agent_name,
                     "prompt": prompt,
                     "url": url,
+                    "agent_name": agent_name,
                     "input_schema": input_schema,
                     "metadata": metadata,
                     "output_schema": output_schema,
@@ -704,6 +706,7 @@ class AsyncAgentResource(AsyncAPIResource):
             cast_to=AgentGetGenerationResponse,
         )
 
+    @typing_extensions.deprecated("deprecated")
     async def publish(
         self,
         agent_name: str,
@@ -744,7 +747,7 @@ class AsyncAgentResource(AsyncAPIResource):
         *,
         agent: str,
         params: Dict[str, object],
-        formats: List[Literal["html", "markdown", "screenshot", "headers"]] | Omit = omit,
+        formats: List[Literal["html", "markdown", "screenshot", "headers", "links"]] | 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.
@@ -791,7 +794,7 @@ class AsyncAgentResource(AsyncAPIResource):
         agent: str,
         params: Dict[str, object],
         callback_url: str | Omit = omit,
-        formats: List[Literal["html", "markdown", "screenshot", "headers"]] | Omit = omit,
+        formats: List[Literal["html", "markdown", "screenshot", "headers", "links"]] | Omit = omit,
         localization: bool | Omit = omit,
         storage_compress: bool | Omit = omit,
         storage_object_name: str | Omit = omit,
@@ -906,8 +909,10 @@ class AgentResourceWithRawResponse:
         self.get_generation = to_raw_response_wrapper(
             agent.get_generation,
         )
-        self.publish = to_raw_response_wrapper(
-            agent.publish,
+        self.publish = (  # pyright: ignore[reportDeprecated]
+            to_raw_response_wrapper(
+                agent.publish,  # pyright: ignore[reportDeprecated],
+            )
         )
         self.run = to_raw_response_wrapper(
             agent.run,
@@ -936,8 +941,10 @@ class AsyncAgentResourceWithRawResponse:
         self.get_generation = async_to_raw_response_wrapper(
             agent.get_generation,
         )
-        self.publish = async_to_raw_response_wrapper(
-            agent.publish,
+        self.publish = (  # pyright: ignore[reportDeprecated]
+            async_to_raw_response_wrapper(
+                agent.publish,  # pyright: ignore[reportDeprecated],
+            )
         )
         self.run = async_to_raw_response_wrapper(
             agent.run,
@@ -966,8 +973,10 @@ class AgentResourceWithStreamingResponse:
         self.get_generation = to_streamed_response_wrapper(
             agent.get_generation,
         )
-        self.publish = to_streamed_response_wrapper(
-            agent.publish,
+        self.publish = (  # pyright: ignore[reportDeprecated]
+            to_streamed_response_wrapper(
+                agent.publish,  # pyright: ignore[reportDeprecated],
+            )
         )
         self.run = to_streamed_response_wrapper(
             agent.run,
@@ -996,8 +1005,10 @@ class AsyncAgentResourceWithStreamingResponse:
         self.get_generation = async_to_streamed_response_wrapper(
             agent.get_generation,
         )
-        self.publish = async_to_streamed_response_wrapper(
-            agent.publish,
+        self.publish = (  # pyright: ignore[reportDeprecated]
+            async_to_streamed_response_wrapper(
+                agent.publish,  # pyright: ignore[reportDeprecated],
+            )
         )
         self.run = async_to_streamed_response_wrapper(
             agent.run,

nimble_python/types/agent_generate_params.py

@@ -5,23 +5,38 @@ from __future__ import annotations
 from typing import Union, Optional
 from typing_extensions import Required, TypeAlias, TypedDict
 
-__all__ = ["AgentGenerateParams", "CreateAgentGenerationRequest", "CreateAgentRefinementRequest"]
+from .._types import SequenceNotStr
 
+__all__ = [
+    "AgentGenerateParams",
+    "CreateAgentGenerationRequest",
+    "CreateAgentGenerationRequestMetadata",
+    "CreateAgentRefinementRequest",
+]
 
-class CreateAgentGenerationRequest(TypedDict, total=False):
-    agent_name: Required[str]
 
+class CreateAgentGenerationRequest(TypedDict, total=False):
     prompt: Required[str]
 
     url: Required[str]
 
+    agent_name: Optional[str]
+
     input_schema: object
 
-    metadata: Optional[object]
+    metadata: Optional[CreateAgentGenerationRequestMetadata]
 
     output_schema: object
 
 
+class CreateAgentGenerationRequestMetadata(TypedDict, total=False):
+    description: Optional[str]
+
+    display_name: Optional[str]
+
+    tags: SequenceNotStr[str]
+
+
 class CreateAgentRefinementRequest(TypedDict, total=False):
     from_agent: Required[str]
 

nimble_python/types/agent_generate_response.py

@@ -1,11 +1,47 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-from typing import Optional
+from typing import List, Optional
 from datetime import datetime
 
 from .._models import BaseModel
 
-__all__ = ["AgentGenerateResponse"]
+__all__ = ["AgentGenerateResponse", "GeneratedVersion", "GeneratedVersionMetadata"]
+
+
+class GeneratedVersionMetadata(BaseModel):
+    data_source: Optional[str] = None
+
+    description: Optional[str] = None
+
+    display_name: Optional[str] = None
+
+    domain: Optional[str] = None
+
+    entity_type: Optional[str] = None
+
+    tags: Optional[List[str]] = None
+
+    vertical: Optional[str] = None
+
+
+class GeneratedVersion(BaseModel):
+    id: str
+
+    agent_name: str
+
+    created_at: datetime
+
+    input_schema: object
+
+    metadata: GeneratedVersionMetadata
+
+    output_schema: object
+
+    steps: List[object]
+
+    version_number: int
+
+    output_sample_data: Optional[object] = None
 
 
 class AgentGenerateResponse(BaseModel):
@@ -21,7 +57,7 @@ class AgentGenerateResponse(BaseModel):
 
     error: Optional[str] = None
 
-    generated_version: Optional[object] = None
+    generated_version: Optional[GeneratedVersion] = None
 
     generated_version_id: Optional[str] = None
 

nimble_python/types/agent_get_generation_response.py

@@ -1,11 +1,47 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-from typing import Optional
+from typing import List, Optional
 from datetime import datetime
 
 from .._models import BaseModel
 
-__all__ = ["AgentGetGenerationResponse"]
+__all__ = ["AgentGetGenerationResponse", "GeneratedVersion", "GeneratedVersionMetadata"]
+
+
+class GeneratedVersionMetadata(BaseModel):
+    data_source: Optional[str] = None
+
+    description: Optional[str] = None
+
+    display_name: Optional[str] = None
+
+    domain: Optional[str] = None
+
+    entity_type: Optional[str] = None
+
+    tags: Optional[List[str]] = None
+
+    vertical: Optional[str] = None
+
+
+class GeneratedVersion(BaseModel):
+    id: str
+
+    agent_name: str
+
+    created_at: datetime
+
+    input_schema: object
+
+    metadata: GeneratedVersionMetadata
+
+    output_schema: object
+
+    steps: List[object]
+
+    version_number: int
+
+    output_sample_data: Optional[object] = None
 
 
 class AgentGetGenerationResponse(BaseModel):
@@ -21,7 +57,7 @@ class AgentGetGenerationResponse(BaseModel):
 
     error: Optional[str] = None
 
-    generated_version: Optional[object] = None
+    generated_version: Optional[GeneratedVersion] = None
 
     generated_version_id: Optional[str] = None
 

nimble_python/types/agent_get_response.py

@@ -1,6 +1,6 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-from typing import List, Optional
+from typing import List, Union, Optional
 
 from .._models import BaseModel
 
@@ -14,14 +14,16 @@ class FeatureFlags(BaseModel):
 
 
 class InputProperty(BaseModel):
-    default: Optional[str] = None
+    default: Union[str, bool, float, None] = None
 
     description: Optional[str] = None
 
-    examples: Optional[List[str]] = None
+    examples: Optional[List[object]] = None
 
     is_localization_param: Optional[bool] = None
 
+    is_pagination_param: Optional[bool] = None
+
     name: Optional[str] = None
 
     required: Optional[bool] = None

nimble_python/types/agent_run_async_params.py

@@ -16,7 +16,7 @@ class AgentRunAsyncParams(TypedDict, total=False):
     callback_url: str
     """URL to call back when async operation completes"""
 
-    formats: List[Literal["html", "markdown", "screenshot", "headers"]]
+    formats: List[Literal["html", "markdown", "screenshot", "headers", "links"]]
     """Response formats to include. All disabled by default."""
 
     localization: bool

nimble_python/types/agent_run_batch_params.py

@@ -15,7 +15,7 @@ class AgentRunBatchParams(TypedDict, total=False):
 
 
 class Input(TypedDict, total=False):
-    formats: List[Literal["html", "markdown", "screenshot", "headers"]]
+    formats: List[Literal["html", "markdown", "screenshot", "headers", "links"]]
     """Response formats to include. All disabled by default."""
 
     localization: bool
@@ -26,7 +26,7 @@ class Input(TypedDict, total=False):
 class SharedInputs(TypedDict, total=False):
     agent: Required[str]
 
-    formats: List[Literal["html", "markdown", "screenshot", "headers"]]
+    formats: List[Literal["html", "markdown", "screenshot", "headers", "links"]]
     """Response formats to include. All disabled by default."""
 
     localization: bool

nimble_python/types/agent_run_params.py

@@ -13,7 +13,7 @@ class AgentRunParams(TypedDict, total=False):
 
     params: Required[Dict[str, object]]
 
-    formats: List[Literal["html", "markdown", "screenshot", "headers"]]
+    formats: List[Literal["html", "markdown", "screenshot", "headers", "links"]]
     """Response formats to include. All disabled by default."""
 
     localization: bool

nimble_python/types/agent_run_response.py

@@ -240,6 +240,9 @@ class Data(BaseModel):
     html: Optional[str] = None
     """The HTML content of the page."""
 
+    links: Optional[List[str]] = None
+    """List of all unique URLs found on the page."""
+
     markdown: Optional[str] = None
     """The Markdown version of the HTML content."""
 

nimble_python/types/client_extract_async_params.py

@@ -313,13 +313,13 @@ class ClientExtractAsyncParams(TypedDict, total=False):
     device: Literal["desktop", "mobile", "tablet"]
     """Device type for browser emulation"""
 
-    driver: Literal["vx6", "vx8", "vx8-pro", "vx10", "vx10-pro", "vx12", "vx12-pro"]
+    driver: Literal["vx6", "vx8", "vx8-pro", "vx10", "vx10-pro", "vx12", "vx12-pro", "media-vx6"]
     """Browser driver to use"""
 
     expected_status_codes: Iterable[int]
     """Expected HTTP status codes for successful requests"""
 
-    formats: List[Literal["html", "markdown", "screenshot", "headers"]]
+    formats: List[Literal["html", "markdown", "screenshot", "headers", "links"]]
     """List of acceptable response formats in order of preference"""
 
     headers: Dict[str, Union[str, SequenceNotStr[str], None]]
@@ -868,6 +868,13 @@ class ClientExtractAsyncParams(TypedDict, total=False):
     ]
     """Locale for browser language and region settings"""
 
+    markdown_backend: Literal["full_page", "main_content"]
+    """Selects which markdown conversion strategy to use.
+
+    "full_page" converts the entire HTML page. "main_content" uses Mozilla
+    Readability to extract the main article content before converting.
+    """
+
     method: Literal["GET", "POST", "PUT", "PATCH", "DELETE"]
     """HTTP method for the request"""
 

nimble_python/types/client_extract_batch_params.py

@@ -422,13 +422,13 @@ class Input(TypedDict, total=False):
     device: Literal["desktop", "mobile", "tablet"]
     """Device type for browser emulation"""
 
-    driver: Literal["vx6", "vx8", "vx8-pro", "vx10", "vx10-pro", "vx12", "vx12-pro"]
+    driver: Literal["vx6", "vx8", "vx8-pro", "vx10", "vx10-pro", "vx12", "vx12-pro", "media-vx6"]
     """Browser driver to use"""
 
     expected_status_codes: Iterable[int]
     """Expected HTTP status codes for successful requests"""
 
-    formats: List[Literal["html", "markdown", "screenshot", "headers"]]
+    formats: List[Literal["html", "markdown", "screenshot", "headers", "links"]]
     """List of acceptable response formats in order of preference"""
 
     headers: Dict[str, Union[str, SequenceNotStr[str], None]]
@@ -977,6 +977,13 @@ class Input(TypedDict, total=False):
     ]
     """Locale for browser language and region settings"""
 
+    markdown_backend: Literal["full_page", "main_content"]
+    """Selects which markdown conversion strategy to use.
+
+    "full_page" converts the entire HTML page. "main_content" uses Mozilla
+    Readability to extract the main article content before converting.
+    """
+
     method: Literal["GET", "POST", "PUT", "PATCH", "DELETE"]
     """HTTP method for the request"""
 
@@ -1456,13 +1463,13 @@ class SharedInputs(TypedDict, total=False):
     device: Literal["desktop", "mobile", "tablet"]
     """Device type for browser emulation"""
 
-    driver: Literal["vx6", "vx8", "vx8-pro", "vx10", "vx10-pro", "vx12", "vx12-pro"]
+    driver: Literal["vx6", "vx8", "vx8-pro", "vx10", "vx10-pro", "vx12", "vx12-pro", "media-vx6"]
     """Browser driver to use"""
 
     expected_status_codes: Iterable[int]
     """Expected HTTP status codes for successful requests"""
 
-    formats: List[Literal["html", "markdown", "screenshot", "headers"]]
+    formats: List[Literal["html", "markdown", "screenshot", "headers", "links"]]
     """List of acceptable response formats in order of preference"""
 
     headers: Dict[str, Union[str, SequenceNotStr[str], None]]
@@ -2011,6 +2018,13 @@ class SharedInputs(TypedDict, total=False):
     ]
     """Locale for browser language and region settings"""
 
+    markdown_backend: Literal["full_page", "main_content"]
+    """Selects which markdown conversion strategy to use.
+
+    "full_page" converts the entire HTML page. "main_content" uses Mozilla
+    Readability to extract the main article content before converting.
+    """
+
     method: Literal["GET", "POST", "PUT", "PATCH", "DELETE"]
     """HTTP method for the request"""
 

nimble_python/types/client_extract_params.py

@@ -310,13 +310,13 @@ class ClientExtractParams(TypedDict, total=False):
     device: Literal["desktop", "mobile", "tablet"]
     """Device type for browser emulation"""
 
-    driver: Literal["vx6", "vx8", "vx8-pro", "vx10", "vx10-pro", "vx12", "vx12-pro"]
+    driver: Literal["vx6", "vx8", "vx8-pro", "vx10", "vx10-pro", "vx12", "vx12-pro", "media-vx6"]
     """Browser driver to use"""
 
     expected_status_codes: Iterable[int]
     """Expected HTTP status codes for successful requests"""
 
-    formats: List[Literal["html", "markdown", "screenshot", "headers"]]
+    formats: List[Literal["html", "markdown", "screenshot", "headers", "links"]]
     """List of acceptable response formats in order of preference"""
 
     headers: Dict[str, Union[str, SequenceNotStr[str], None]]
@@ -865,6 +865,13 @@ class ClientExtractParams(TypedDict, total=False):
     ]
     """Locale for browser language and region settings"""
 
+    markdown_backend: Literal["full_page", "main_content"]
+    """Selects which markdown conversion strategy to use.
+
+    "full_page" converts the entire HTML page. "main_content" uses Mozilla
+    Readability to extract the main article content before converting.
+    """
+
     method: Literal["GET", "POST", "PUT", "PATCH", "DELETE"]
     """HTTP method for the request"""
 

nimble_python/types/crawl_run_params.py

@@ -455,13 +455,13 @@ class ExtractOptions(TypedDict, total=False):
     device: Literal["desktop", "mobile", "tablet"]
     """Device type for browser emulation"""
 
-    driver: Literal["vx6", "vx8", "vx8-pro", "vx10", "vx10-pro", "vx12", "vx12-pro"]
+    driver: Literal["vx6", "vx8", "vx8-pro", "vx10", "vx10-pro", "vx12", "vx12-pro", "media-vx6"]
     """Browser driver to use"""
 
     expected_status_codes: Iterable[int]
     """Expected HTTP status codes for successful requests"""
 
-    formats: List[Literal["html", "markdown", "screenshot", "headers"]]
+    formats: List[Literal["html", "markdown", "screenshot", "headers", "links"]]
     """List of acceptable response formats in order of preference"""
 
     headers: Dict[str, Union[str, SequenceNotStr[str], None]]
@@ -1010,6 +1010,13 @@ class ExtractOptions(TypedDict, total=False):
     ]
     """Locale for browser language and region settings"""
 
+    markdown_backend: Literal["full_page", "main_content"]
+    """Selects which markdown conversion strategy to use.
+
+    "full_page" converts the entire HTML page. "main_content" uses Mozilla
+    Readability to extract the main article content before converting.
+    """
+
     method: Literal["GET", "POST", "PUT", "PATCH", "DELETE"]
     """HTTP method for the request"""
 

nimble_python/types/extract_response.py

@@ -240,6 +240,9 @@ class Data(BaseModel):
     html: Optional[str] = None
     """The HTML content of the page."""
 
+    links: Optional[List[str]] = None
+    """List of all unique URLs found on the page."""
+
     markdown: Optional[str] = None
     """The Markdown version of the HTML content."""
 

{nimble_python-0.16.0.dist-info → nimble_python-0.17.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: nimble_python
-Version: 0.16.0
+Version: 0.17.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.16.0.dist-info → nimble_python-0.17.0.dist-info}/RECORD

@@ -1,19 +1,19 @@
 nimble_python/__init__.py,sha256=QWpm5I50gjoMEPPXsRiT0i3aqvsJby6NegnPHYrhCfs,2645
-nimble_python/_base_client.py,sha256=IR2D-rcC7Lz8L2c0xH_4dOX50NJEgUK0IzpKAbK11FU,73665
-nimble_python/_client.py,sha256=pP-ipRU38aLLPGVS1DISXGVJI474Qk_pQ2t1eT-fkvo,162929
+nimble_python/_base_client.py,sha256=GVMopeALSRNw5GTAmUQfFvON3_tSKYw-MjKo8lDRfos,73932
+nimble_python/_client.py,sha256=rdzJrl1TL5knL6v6YVjwCG7v0eh4oaFDVobyn2J5FnA,166509
 nimble_python/_compat.py,sha256=_9guQfzYnL3DNtudX5W7T2cdSskx89B5AFfhPQDxMUk,6811
 nimble_python/_constants.py,sha256=giUwuSKDnpjRLaHvgzErnXB3CSYjKMaI5xnBQJI-23s,464
 nimble_python/_exceptions.py,sha256=x1M0s_wI9jkJ5ARR07APUuDZfxl7BjQ53snlFU-jAoQ,3220
-nimble_python/_files.py,sha256=KnEzGi_O756MvKyJ4fOCW_u3JhOeWPQ4RsmDvqihDQU,3545
+nimble_python/_files.py,sha256=GsGgJfC6PEiO0d4ItFBMQlBrK8LLNpTaBdHa7T3EMDE,5452
 nimble_python/_models.py,sha256=R3MpO2z4XhTAnD3ObEks32suRXleF1g7BEgQTOLIxTs,32112
-nimble_python/_qs.py,sha256=ExvESqZz_a5ZALZG1aR2rkzE35o9Rmk0yPMQtKN0DTo,4924
+nimble_python/_qs.py,sha256=ZSfQv6arGBBoWlcy60zK1zmPE2Ije0i8kzKdnoxWUjU,4833
 nimble_python/_resource.py,sha256=TDtzjUMbNHRGQNq-4HJqce3T3THBD5Q7ESrONYPvKdI,1100
 nimble_python/_response.py,sha256=hrLOCn3D0gCapH31eR9BVOgBpTYliUTVUsdeWc1J76A,28983
 nimble_python/_streaming.py,sha256=StqGzUAIG9gQNCkRQnEAbN3IyiX4hDdCp2QR7_DANw8,10550
-nimble_python/_types.py,sha256=ZhbxWgjPQAqNY4ePn8aUJV26mm5oDBrZqskA1XyjlQ0,7601
-nimble_python/_version.py,sha256=Lb-CsoIL_IraYv5EV1eucIYPOAIePAbpXjQtYHRX5vQ,166
+nimble_python/_types.py,sha256=rYClHO7LPhg_rRUmxWuC34Tf2mVPfmCZBIANhQ2fC3o,7709
+nimble_python/_version.py,sha256=rVW0OGVVDRW6LcAJHqq6Eamsw-h_2lwUvwrSUUTaU5Y,166
 nimble_python/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-nimble_python/_utils/__init__.py,sha256=DJEWihdzRWrZI23vwocBkgvZCwn9iG7yV0c_9vKaysU,2355
+nimble_python/_utils/__init__.py,sha256=nQq-iFa5YxTaWySaLigatew5rHgTR0M75FNYm4mrO1s,2313
 nimble_python/_utils/_compat.py,sha256=33246eDcl3pwL6kWsEhVuT4Akrd8gZEW9LPTm465ohk,1231
 nimble_python/_utils/_datetime_parse.py,sha256=bABTs0Bc6rabdFvnIwXjEhWL15TcRgWZ_6XGTqN8xUk,4204
 nimble_python/_utils/_json.py,sha256=bl95uuIWwgSfXX-gP1trK_lDAPwJujYfJ05Cxo2SEC4,962
@@ -26,44 +26,44 @@ nimble_python/_utils/_streams.py,sha256=SMC90diFFecpEg_zgDRVbdR3hSEIgVVij4taD-no
 nimble_python/_utils/_sync.py,sha256=HBnZkkBnzxtwOZe0212C4EyoRvxhTVtTrLFDz2_xVCg,1589
 nimble_python/_utils/_transform.py,sha256=NjCzmnfqYrsAikUHQig6N9QfuTVbKipuP3ur9mcNF-E,15951
 nimble_python/_utils/_typing.py,sha256=N_5PPuFNsaygbtA_npZd98SVN1LQQvFTKL6bkWPBZGU,4786
-nimble_python/_utils/_utils.py,sha256=ugfUaneOK7I8h9b3656flwf5u_kthY0gvNuqvgOLoSU,12252
+nimble_python/_utils/_utils.py,sha256=2nPOzDrPe2GADpLCRM4bNQS8Mu7LjEiCG_LJ2AAL6jg,13111
 nimble_python/lib/.keep,sha256=wuNrz-5SXo3jJaJOJgz4vFHM41YH_g20F5cRQo0vLes,224
 nimble_python/resources/__init__.py,sha256=Wh5Ns-DfhwV5B1NL1sauYogLEctZiqtJxLuEVQzUvVw,1876
-nimble_python/resources/agent.py,sha256=lA2lZIr6D_yOXtyBUVM8nEdR1vsVtRQCw138Z6cqU-4,37893
+nimble_python/resources/agent.py,sha256=ecyhlZxtmnuGwHJwsouKPC4wwex8yipbVmySC2_MkCw,38726
 nimble_python/resources/batches.py,sha256=LxPXo7mpDcXmtJAv7prVnDpJHkhHypix6ZNSxh9kpQU,11688
 nimble_python/resources/crawl.py,sha256=GOMDGANIPAfay-J3ujW9ghlK-h-aIy99ChIKRN-pZK8,20651
 nimble_python/resources/tasks.py,sha256=8rV6YZNpx8rq_83L8UZvt7HlPlRhY8SGrbVQAFDjBtM,13021
 nimble_python/types/__init__.py,sha256=IMIgUvouuZ_JeP5p7HBJEnwQJdnSBt9YopnYPY8y2Tw,3327
-nimble_python/types/agent_generate_params.py,sha256=2YZjjZy7EDa-ISBftfjtgDh3wOba8UmmIVimYkILrG8,766
-nimble_python/types/agent_generate_response.py,sha256=NaLHpAtIMssf5o094YfpsphnQXRtdIyAbM7RiVa5ij8,664
-nimble_python/types/agent_get_generation_response.py,sha256=phzi3gsbrruea_eNcZIYJu9f8jYw26Nc_1sOyBsxIss,674
-nimble_python/types/agent_get_response.py,sha256=qQtjNztWHGWGJ_LKLn2-VtQlzv2AfkPvu0QaADRXqIg,1131
+nimble_python/types/agent_generate_params.py,sha256=tPnfQ43Tux_uZUmSwr4tJFjVPDblkM1GfrHKwUa0tzA,1057
+nimble_python/types/agent_generate_response.py,sha256=gSREaNTF0mlMsmKY14f3XI2f7hHS8u77XUkNGtgT98U,1325
+nimble_python/types/agent_get_generation_response.py,sha256=1wZyJS54wSVa7fTzexX4Kd-G3ZWBZdYrlc2a1WbC9RM,1335
+nimble_python/types/agent_get_response.py,sha256=Ok4Lz5FTMrP5ok6Ao4wQithGIwdkopPx1V4gnCOxGTc,1205
 nimble_python/types/agent_list_params.py,sha256=yUwgtiXrzfEXd3I--X_ISovY2BSHKXDvFZ2XUCUR9ew,670
 nimble_python/types/agent_list_response.py,sha256=kBEVOD9nlby5QsfaDkjPLXDJyQotph3HBo321jP8rb4,599
 nimble_python/types/agent_publish_params.py,sha256=GNnBk5qgq1T1JMotVJSVrY_bW6CJHRRuF5H-9ofj9zE,289
 nimble_python/types/agent_publish_response.py,sha256=VEyf8cMKVqgWRhOGPDuYevVhwPcE-oynoBc8UPoXVs8,247
-nimble_python/types/agent_run_async_params.py,sha256=kma0zTwV2RK4BIDnOAneQ1Vx1sLZqSezBs403ODdoaI,877
+nimble_python/types/agent_run_async_params.py,sha256=2muyw_xyABrMVtZTIW9GLwBx8UO2LM3jU8B4fl3NLtI,886
 nimble_python/types/agent_run_async_response.py,sha256=aawcjhtW6FaWxIPcg-l-1yIhsQDLUoYOaoSf_MLJ67s,321
-nimble_python/types/agent_run_batch_params.py,sha256=R6yqYKx4w4-WFitwU1uPUu4DskYIc32c9NeKccm8UQ4,909
+nimble_python/types/agent_run_batch_params.py,sha256=LCTCHB6kQAAy-TOZSan_Gzv5luYOhn-h2GikxP93nec,927
 nimble_python/types/agent_run_batch_response.py,sha256=0dtYQ6epddVqO2sdbeTDJyGGGAob24Cl3y1qC2k2AT4,1776
-nimble_python/types/agent_run_params.py,sha256=hC7CkPKvFoJf-KKIifJNKwDv-O_dS6Mk65k-A7up_RY,517
-nimble_python/types/agent_run_response.py,sha256=0kPTccMFP3kBu-9legG_dRP5HSDNiafqDgZkaYxnqFA,8155
+nimble_python/types/agent_run_params.py,sha256=vn3zIe4k1eb-9rb2XhhBnJIRyr6NAxpO5PhfU0S6uWw,526
+nimble_python/types/agent_run_response.py,sha256=TavoLSUAvUI7xhaOVaMuTBKOtrGyEeJlWnQ34xu-mxY,8247
 nimble_python/types/batch_get_response.py,sha256=5MIDHw3xt4UPdZY7eeYMDTJHbvyP4fCWNFMOLmuxcGM,2117
 nimble_python/types/batch_progress_response.py,sha256=oHEHXclc0NnI3TiGMalfElhZ15rfvR7nZRub9Gg_nqs,726
-nimble_python/types/client_extract_async_params.py,sha256=P26kzOH_UudChy5ZcCfoVz5YE-RVNCYifMAIAAeXErI,19339
-nimble_python/types/client_extract_batch_params.py,sha256=ZUrgFvuOMXsfsAEF-CmwZH4R5l48td3kzqZeZIGcMKM,38402
-nimble_python/types/client_extract_params.py,sha256=U5GAyppMNGKuBqwxhF_h-y9XCcGLlTj5bhzpYtvbeeY,18979
+nimble_python/types/client_extract_async_params.py,sha256=-PftJe9MMk6fNJmAtPwSgVeN6KKw-_pQPnf_r_orjKc,19634
+nimble_python/types/client_extract_batch_params.py,sha256=i_e4X2hxtdAm_DXjYSqBG-YHbw_M5YEAjX6XzP7btIw,38992
+nimble_python/types/client_extract_params.py,sha256=Sd6kYzenVUB7jBdCodWcX-y5XuT7IukZRIKdwoCML3Y,19274
 nimble_python/types/client_map_params.py,sha256=UrYDjx_AjEdRVRkbJUaSBWAM7_bJIFZ95RzISFhidkA,13217
 nimble_python/types/client_search_params.py,sha256=KubZviMs3gOsbko4B_AHJ4ytomMfITVbrNmKDigYK2Y,2682
 nimble_python/types/crawl_list_params.py,sha256=Z6WaMJtkeBhRhK0ejXMHrQsSZI3OQWr-BlVFrPl3Lg4,527
 nimble_python/types/crawl_list_response.py,sha256=roMnzSv0XrpqfryMbeDGjvooMG3GsgJeW1yJS2g7RQs,2914
-nimble_python/types/crawl_run_params.py,sha256=jXrAV4sGi04eXhdEEGixqSG2Avb9bRJZKoNMFyfG_uU,20828
+nimble_python/types/crawl_run_params.py,sha256=0LfsQIzgFtPCYoaLfO4h2ryWBleKTiIhRUYYfBG1sLs,21123
 nimble_python/types/crawl_run_response.py,sha256=DSi6cUZzEtCg7P6A0MrryrT7-mTe4mTPF7976OVx14M,2572
 nimble_python/types/crawl_status_response.py,sha256=rCNZkRNV65KzZpQCqbSX2FIW6kLh93C_lYMieS_UVEQ,2578
 nimble_python/types/crawl_terminate_response.py,sha256=Kw0udMxFAfBZcpKfIpK8Dt1wKyjFM5zUgGTiBNl1K4c,271
 nimble_python/types/extract_async_response.py,sha256=__3OdwaSstOvDzaQnMv2w4cWeD4GN0-2zZ7YxdNDufs,1786
 nimble_python/types/extract_batch_response.py,sha256=AjiTdf7eHP_kE3TCX7nDr2OdzdKWZyLDFkh3duZlNyg,1774
-nimble_python/types/extract_response.py,sha256=B1Md11774eeSLinT7Z-a6ImP_X-WrUGoYSD1mbZMPjo,8153
+nimble_python/types/extract_response.py,sha256=67CkH4vOsZTUvGOWEMLANPBK_d2hgDcqlmEB_B3LhMk,8245
 nimble_python/types/map_response.py,sha256=rNCav8_9GXdbdNIaIQEWi6f8c_YduImddoCzxV4i4Os,607
 nimble_python/types/search_response.py,sha256=lykUe_ICfs-dvtcz9nnrcFrV80FkSkWrR3ljumCyH4Y,2210
 nimble_python/types/task_get_response.py,sha256=YMLwfZv2ejUu-4VePPCUkojzXDZ_4tYtYCem9JfQh0U,1563
@@ -98,7 +98,7 @@ nimble_python/types/shared_params/scroll_action.py,sha256=6PJMWVc9JhjyrXeAsFnvHR
 nimble_python/types/shared_params/wait_action.py,sha256=2jlVgNNZcC2M9tka3xbmLkDocCJuoX_1qIGOmd6a2DU,1046
 nimble_python/types/shared_params/wait_for_element_action.py,sha256=cKhvFe09G2aQBFKBXg00S43ykQqgNyTLYR1DoJmDvTA,1364
 nimble_python/types/shared_params/wait_for_navigation_action.py,sha256=oPAK3OxZObqJjDEh9v0_q1ntHfWqgtXOp_k-oX8ZiHE,1257
-nimble_python-0.16.0.dist-info/METADATA,sha256=be0K4zHYggpMamVI94U0JkITCx187hFZMdUYzxaXdrM,15816
-nimble_python-0.16.0.dist-info/WHEEL,sha256=C2FUgwZgiLbznR-k0b_5k3Ai_1aASOXDss3lzCUsUug,87
-nimble_python-0.16.0.dist-info/licenses/LICENSE,sha256=khtIpaYdgNbXXcmzsxlSL_iKmh160uTREZTiMQKCB24,11336
-nimble_python-0.16.0.dist-info/RECORD,,
+nimble_python-0.17.0.dist-info/METADATA,sha256=0ZU6r9zx2r4CJ-wHv-ZY9i0gJyv_7ydND6BGckLgnPE,15816
+nimble_python-0.17.0.dist-info/WHEEL,sha256=C2FUgwZgiLbznR-k0b_5k3Ai_1aASOXDss3lzCUsUug,87
+nimble_python-0.17.0.dist-info/licenses/LICENSE,sha256=khtIpaYdgNbXXcmzsxlSL_iKmh160uTREZTiMQKCB24,11336
+nimble_python-0.17.0.dist-info/RECORD,,