nimble_python 0.10.0__tar.gz → 0.11.0__tar.gz

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

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

{nimble_python-0.10.0 → nimble_python-0.11.0}/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## 0.11.0 (2026-03-10)
+
+Full Changelog: [v0.10.0...v0.11.0](https://github.com/Nimbleway/nimble-python/compare/v0.10.0...v0.11.0)
+
+### Features
+
+* **api:** api update ([5920fac](https://github.com/Nimbleway/nimble-python/commit/5920facd8a20c83c88ef893e7dafef6dea115239))
+* **api:** api update ([802ba25](https://github.com/Nimbleway/nimble-python/commit/802ba250e6e4681b18259305b7f9d9fac28569b6))
+
+
+### Chores
+
+* **ci:** bump uv version ([146ce46](https://github.com/Nimbleway/nimble-python/commit/146ce4600e65bd53d9dfaed8faa27483d0b13b2c))
+* **ci:** skip uploading artifacts on stainless-internal branches ([0367a98](https://github.com/Nimbleway/nimble-python/commit/0367a9816cb6178e9c769d09eff4b26bd4b8cd29))
+
+
+### Refactors
+
+* **types:** use `extra_items` from PEP 728 ([4c233b7](https://github.com/Nimbleway/nimble-python/commit/4c233b70e9763d97f5e03d196d28d951a37d1609))
+
 ## 0.10.0 (2026-02-25)
 
 Full Changelog: [v0.9.1...v0.10.0](https://github.com/Nimbleway/nimble-python/compare/v0.9.1...v0.10.0)

{nimble_python-0.10.0 → nimble_python-0.11.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: nimble_python
-Version: 0.10.0
+Version: 0.11.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.10.0 → nimble_python-0.11.0}/pyproject.toml

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

{nimble_python-0.10.0 → nimble_python-0.11.0}/src/nimble_python/_client.py

@@ -3072,7 +3072,7 @@ class Nimble(SyncAPIClient):
         query: str,
         content_type: Optional[SequenceNotStr[str]] | Omit = omit,
         country: str | Omit = omit,
-        deep_search: bool | Omit = omit,
+        deep_search: Optional[bool] | Omit = omit,
         end_date: Optional[str] | Omit = omit,
         exclude_domains: Optional[SequenceNotStr[str]] | Omit = omit,
         focus: Union[str, SequenceNotStr[str]] | Omit = omit,
@@ -3082,6 +3082,7 @@ class Nimble(SyncAPIClient):
         max_results: int | Omit = omit,
         max_subagents: int | Omit = omit,
         output_format: Literal["plain_text", "markdown", "simplified_html"] | Omit = omit,
+        search_depth: Optional[Literal["lite", "fast", "deep"]] | Omit = omit,
         start_date: Optional[str] | Omit = omit,
         time_range: Optional[Literal["hour", "day", "week", "month", "year"]] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -3103,9 +3104,7 @@ class Nimble(SyncAPIClient):
 
           country: Country code for geo-targeted results (e.g., 'US', 'GB', 'IL')
 
-          deep_search: Deep Mode (true, default): fetches full-page content for deeper analysis. Fast
-              Mode (false): returns metadata only (title, snippet, URL) for quick,
-              token-efficient results.
+          deep_search: Deprecated. Use search_depth instead. true maps to 'deep', false maps to 'lite'.
 
           end_date: Filter results before this date (format: YYYY-MM-DD or YYYY)
 
@@ -3128,6 +3127,13 @@ class Nimble(SyncAPIClient):
 
           output_format: Output format: plain_text, markdown, or simplified_html
 
+          search_depth: Controls content richness and latency of search results.
+
+              - lite: Token-efficient metadata for high-volume pipelines (title, URL,
+                description only)
+              - fast: Rich content (~2K chars) optimized for AI agents
+              - deep: Full page content via Webit scraping for comprehensive analysis
+
           start_date: Filter results after this date (format: YYYY-MM-DD or YYYY)
 
           time_range: Time range filters passed to Webit SERP API as 'time' parameter.
@@ -3157,6 +3163,7 @@ class Nimble(SyncAPIClient):
                     "max_results": max_results,
                     "max_subagents": max_subagents,
                     "output_format": output_format,
+                    "search_depth": search_depth,
                     "start_date": start_date,
                     "time_range": time_range,
                 },
@@ -6213,7 +6220,7 @@ class AsyncNimble(AsyncAPIClient):
         query: str,
         content_type: Optional[SequenceNotStr[str]] | Omit = omit,
         country: str | Omit = omit,
-        deep_search: bool | Omit = omit,
+        deep_search: Optional[bool] | Omit = omit,
         end_date: Optional[str] | Omit = omit,
         exclude_domains: Optional[SequenceNotStr[str]] | Omit = omit,
         focus: Union[str, SequenceNotStr[str]] | Omit = omit,
@@ -6223,6 +6230,7 @@ class AsyncNimble(AsyncAPIClient):
         max_results: int | Omit = omit,
         max_subagents: int | Omit = omit,
         output_format: Literal["plain_text", "markdown", "simplified_html"] | Omit = omit,
+        search_depth: Optional[Literal["lite", "fast", "deep"]] | Omit = omit,
         start_date: Optional[str] | Omit = omit,
         time_range: Optional[Literal["hour", "day", "week", "month", "year"]] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -6244,9 +6252,7 @@ class AsyncNimble(AsyncAPIClient):
 
           country: Country code for geo-targeted results (e.g., 'US', 'GB', 'IL')
 
-          deep_search: Deep Mode (true, default): fetches full-page content for deeper analysis. Fast
-              Mode (false): returns metadata only (title, snippet, URL) for quick,
-              token-efficient results.
+          deep_search: Deprecated. Use search_depth instead. true maps to 'deep', false maps to 'lite'.
 
           end_date: Filter results before this date (format: YYYY-MM-DD or YYYY)
 
@@ -6269,6 +6275,13 @@ class AsyncNimble(AsyncAPIClient):
 
           output_format: Output format: plain_text, markdown, or simplified_html
 
+          search_depth: Controls content richness and latency of search results.
+
+              - lite: Token-efficient metadata for high-volume pipelines (title, URL,
+                description only)
+              - fast: Rich content (~2K chars) optimized for AI agents
+              - deep: Full page content via Webit scraping for comprehensive analysis
+
           start_date: Filter results after this date (format: YYYY-MM-DD or YYYY)
 
           time_range: Time range filters passed to Webit SERP API as 'time' parameter.
@@ -6298,6 +6311,7 @@ class AsyncNimble(AsyncAPIClient):
                     "max_results": max_results,
                     "max_subagents": max_subagents,
                     "output_format": output_format,
+                    "search_depth": search_depth,
                     "start_date": start_date,
                     "time_range": time_range,
                 },

{nimble_python-0.10.0 → nimble_python-0.11.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.10.0"  # x-release-please-version
+__version__ = "0.11.0"  # x-release-please-version

{nimble_python-0.10.0 → nimble_python-0.11.0}/src/nimble_python/resources/agent.py

@@ -51,9 +51,10 @@ class AgentResource(SyncAPIResource):
         self,
         *,
         limit: int | Omit = omit,
-        managed_by: Optional[Literal["nimble", "community"]] | Omit = omit,
+        managed_by: Optional[Literal["nimble", "community", "self_managed"]] | Omit = omit,
         offset: int | Omit = omit,
-        privacy: Literal["public", "private", "all"] | Omit = omit,
+        privacy: Optional[Literal["public", "private", "all"]] | Omit = omit,
+        search: 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,
@@ -67,12 +68,14 @@ class AgentResource(SyncAPIResource):
         Args:
           limit: Number of results per page
 
-          managed_by: Filter public templates by attribution
+          managed_by: Filter templates by attribution
 
           offset: Pagination offset
 
           privacy: Filter by privacy level
 
+          search: Search templates by name, domain, or vertical
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -94,6 +97,7 @@ class AgentResource(SyncAPIResource):
                         "managed_by": managed_by,
                         "offset": offset,
                         "privacy": privacy,
+                        "search": search,
                     },
                     agent_list_params.AgentListParams,
                 ),
@@ -261,9 +265,10 @@ class AsyncAgentResource(AsyncAPIResource):
         self,
         *,
         limit: int | Omit = omit,
-        managed_by: Optional[Literal["nimble", "community"]] | Omit = omit,
+        managed_by: Optional[Literal["nimble", "community", "self_managed"]] | Omit = omit,
         offset: int | Omit = omit,
-        privacy: Literal["public", "private", "all"] | Omit = omit,
+        privacy: Optional[Literal["public", "private", "all"]] | Omit = omit,
+        search: 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,
@@ -277,12 +282,14 @@ class AsyncAgentResource(AsyncAPIResource):
         Args:
           limit: Number of results per page
 
-          managed_by: Filter public templates by attribution
+          managed_by: Filter templates by attribution
 
           offset: Pagination offset
 
           privacy: Filter by privacy level
 
+          search: Search templates by name, domain, or vertical
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -304,6 +311,7 @@ class AsyncAgentResource(AsyncAPIResource):
                         "managed_by": managed_by,
                         "offset": offset,
                         "privacy": privacy,
+                        "search": search,
                     },
                     agent_list_params.AgentListParams,
                 ),

{nimble_python-0.10.0 → nimble_python-0.11.0}/src/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 Dict, List, Optional
+from typing import List, Optional
 
 from .._models import BaseModel
 
@@ -50,6 +50,6 @@ class AgentGetResponse(BaseModel):
 
     managed_by: Optional[str] = None
 
-    output_schema: Optional[Dict[str, object]] = None
+    output_schema: Optional[object] = None
 
     vertical: Optional[str] = None

{nimble_python-0.10.0 → nimble_python-0.11.0}/src/nimble_python/types/agent_list_params.py

@@ -12,11 +12,14 @@ class AgentListParams(TypedDict, total=False):
     limit: int
     """Number of results per page"""
 
-    managed_by: Optional[Literal["nimble", "community"]]
-    """Filter public templates by attribution"""
+    managed_by: Optional[Literal["nimble", "community", "self_managed"]]
+    """Filter templates by attribution"""
 
     offset: int
     """Pagination offset"""
 
-    privacy: Literal["public", "private", "all"]
+    privacy: Optional[Literal["public", "private", "all"]]
     """Filter by privacy level"""
+
+    search: Optional[str]
+    """Search templates by name, domain, or vertical"""

{nimble_python-0.10.0 → nimble_python-0.11.0}/src/nimble_python/types/client_extract_async_params.py

@@ -999,7 +999,7 @@ BrowserAction: TypeAlias = Union[
 ]
 
 
-class CookiesUnionMember0Typed(TypedDict, total=False):
+class CookiesUnionMember0(TypedDict, total=False, extra_items=object):  # type: ignore[call-arg]
     creation: Optional[str]
 
     domain: Optional[str]
@@ -1029,9 +1029,6 @@ class CookiesUnionMember0Typed(TypedDict, total=False):
     value: str
 
 
-CookiesUnionMember0: TypeAlias = Union[CookiesUnionMember0Typed, Dict[str, object]]
-
-
 class NetworkCaptureURL(TypedDict, total=False):
     value: Required[str]
 

{nimble_python-0.10.0 → nimble_python-0.11.0}/src/nimble_python/types/client_extract_params.py

@@ -984,7 +984,7 @@ BrowserAction: TypeAlias = Union[
 ]
 
 
-class CookiesUnionMember0Typed(TypedDict, total=False):
+class CookiesUnionMember0(TypedDict, total=False, extra_items=object):  # type: ignore[call-arg]
     creation: Optional[str]
 
     domain: Optional[str]
@@ -1014,9 +1014,6 @@ class CookiesUnionMember0Typed(TypedDict, total=False):
     value: str
 
 
-CookiesUnionMember0: TypeAlias = Union[CookiesUnionMember0Typed, Dict[str, object]]
-
-
 class NetworkCaptureURL(TypedDict, total=False):
     value: Required[str]
 

{nimble_python-0.10.0 → nimble_python-0.11.0}/src/nimble_python/types/client_search_params.py

@@ -24,11 +24,10 @@ class ClientSearchParams(TypedDict, total=False):
     country: str
     """Country code for geo-targeted results (e.g., 'US', 'GB', 'IL')"""
 
-    deep_search: bool
-    """Deep Mode (true, default): fetches full-page content for deeper analysis.
+    deep_search: Optional[bool]
+    """Deprecated.
 
-    Fast Mode (false): returns metadata only (title, snippet, URL) for quick,
-    token-efficient results.
+    Use search_depth instead. true maps to 'deep', false maps to 'lite'.
     """
 
     end_date: Optional[str]
@@ -67,6 +66,15 @@ class ClientSearchParams(TypedDict, total=False):
     output_format: Literal["plain_text", "markdown", "simplified_html"]
     """Output format: plain_text, markdown, or simplified_html"""
 
+    search_depth: Optional[Literal["lite", "fast", "deep"]]
+    """Controls content richness and latency of search results.
+
+    - lite: Token-efficient metadata for high-volume pipelines (title, URL,
+      description only)
+    - fast: Rich content (~2K chars) optimized for AI agents
+    - deep: Full page content via Webit scraping for comprehensive analysis
+    """
+
     start_date: Optional[str]
     """Filter results after this date (format: YYYY-MM-DD or YYYY)"""
 

{nimble_python-0.10.0 → nimble_python-0.11.0}/src/nimble_python/types/crawl_run_params.py

@@ -118,7 +118,7 @@ ExtractOptionsBrowserAction: TypeAlias = Union[
 ]
 
 
-class ExtractOptionsCookiesUnionMember0Typed(TypedDict, total=False):
+class ExtractOptionsCookiesUnionMember0(TypedDict, total=False, extra_items=object):  # type: ignore[call-arg]
     creation: Optional[str]
 
     domain: Optional[str]
@@ -148,9 +148,6 @@ class ExtractOptionsCookiesUnionMember0Typed(TypedDict, total=False):
     value: str
 
 
-ExtractOptionsCookiesUnionMember0: TypeAlias = Union[ExtractOptionsCookiesUnionMember0Typed, Dict[str, object]]
-
-
 class ExtractOptionsNetworkCaptureURL(TypedDict, total=False):
     value: Required[str]
 

{nimble_python-0.10.0 → nimble_python-0.11.0}/src/nimble_python/types/extract_async_response.py

@@ -33,7 +33,7 @@ class Task(BaseModel):
     account_name: Optional[str] = None
     """Account name that owns the task."""
 
-    api_type: Optional[Literal["web", "serp", "ecommerce", "social", "agent", "extract"]] = None
+    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."""

{nimble_python-0.10.0 → nimble_python-0.11.0}/src/nimble_python/types/shared_params/get_cookies_action.py

@@ -2,13 +2,13 @@
 
 from __future__ import annotations
 
-from typing import Dict, Union
+from typing import Union
 from typing_extensions import Literal, Required, TypeAlias, TypedDict
 
 __all__ = ["GetCookiesAction", "GetCookies", "GetCookiesUnionMember1"]
 
 
-class GetCookiesUnionMember1Typed(TypedDict, total=False):
+class GetCookiesUnionMember1(TypedDict, total=False, extra_items=object):  # type: ignore[call-arg]
     required: Union[Literal["true", "false"], bool]
     """Whether this action is required.
 
@@ -23,8 +23,6 @@ class GetCookiesUnionMember1Typed(TypedDict, total=False):
     """
 
 
-GetCookiesUnionMember1: TypeAlias = Union[GetCookiesUnionMember1Typed, Dict[str, object]]
-
 GetCookies: TypeAlias = Union[bool, GetCookiesUnionMember1]
 
 

{nimble_python-0.10.0 → nimble_python-0.11.0}/src/nimble_python/types/task_get_response.py

@@ -31,7 +31,7 @@ class Task(BaseModel):
     account_name: Optional[str] = None
     """Account name that owns the task."""
 
-    api_type: Optional[Literal["web", "serp", "ecommerce", "social", "agent", "extract"]] = None
+    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."""

{nimble_python-0.10.0 → nimble_python-0.11.0}/src/nimble_python/types/task_list_response.py

@@ -31,7 +31,7 @@ class Data(BaseModel):
     account_name: Optional[str] = None
     """Account name that owns the task."""
 
-    api_type: Optional[Literal["web", "serp", "ecommerce", "social", "agent", "extract"]] = None
+    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."""

{nimble_python-0.10.0 → nimble_python-0.11.0}/tests/api_resources/test_agent.py

@@ -36,6 +36,7 @@ class TestAgent:
             managed_by="nimble",
             offset=0,
             privacy="public",
+            search="search",
         )
         assert_matches_type(AgentListResponse, agent, path=["response"])
 
@@ -222,6 +223,7 @@ class TestAsyncAgent:
             managed_by="nimble",
             offset=0,
             privacy="public",
+            search="search",
         )
         assert_matches_type(AgentListResponse, agent, path=["response"])
 

{nimble_python-0.10.0 → nimble_python-0.11.0}/tests/api_resources/test_client.py

@@ -405,6 +405,7 @@ class TestClient:
             max_results=1,
             max_subagents=1,
             output_format="plain_text",
+            search_depth="lite",
             start_date="start_date",
             time_range="hour",
         )
@@ -825,6 +826,7 @@ class TestAsyncClient:
             max_results=1,
             max_subagents=1,
             output_format="plain_text",
+            search_depth="lite",
             start_date="start_date",
             time_range="hour",
         )

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

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