From 5bdd92ba7b63be1f67fb56f9be114be7d3193365 Mon Sep 17 00:00:00 2001 From: "stainless-app[bot]" <142633134+stainless-app[bot]@users.noreply.github.com> Date: Mon, 7 Sep 2026 13:19:26 +0000 Subject: [PATCH 1/2] feat(api): api update --- .stats.yml | 4 +-- src/nimble_python/_client.py | 28 ++++++++----------- .../types/client_search_params.py | 16 +++++------ 3 files changed, 21 insertions(+), 27 deletions(-) diff --git a/.stats.yml b/.stats.yml index 6daca8c..ba92779 100644 --- a/.stats.yml +++ b/.stats.yml @@ -1,4 +1,4 @@ configured_endpoints: 59 -openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/nimbleway/nimbleway-fd1582a9a8f119deb86514ce3d2511abb157d010ea4cfca321eb9c7923f562e5.yml -openapi_spec_hash: 932cd90fd600c7a7cfb419cbd92b5975 +openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/nimbleway/nimbleway-36b2f0951e337c24b2a439452aa9e7269f85443359a60f57b3d7098e10c478d4.yml +openapi_spec_hash: b9c41499f50a5b7581aac397fde0e5d6 config_hash: a9878e098a6929e32711d66374797185 diff --git a/src/nimble_python/_client.py b/src/nimble_python/_client.py index 726d9e1..6c3870e 100644 --- a/src/nimble_python/_client.py +++ b/src/nimble_python/_client.py @@ -1151,7 +1151,7 @@ def search( 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, + search_depth: Optional[Literal["lite", "standard"]] | 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. @@ -1173,7 +1173,8 @@ def search( country: Country code for geo-targeted results (e.g., 'US', 'GB', 'IL') - deep_search: Deprecated. Use search_depth instead. true maps to 'deep', false maps to 'lite'. + deep_search: Deprecated. Use search_depth with full_content instead. true maps to 'lite' with + full_content=true, false maps to 'lite'. end_date: Filter results before this date (format: YYYY-MM-DD or YYYY) @@ -1182,10 +1183,8 @@ def search( focus: Search focus mode (e.g., 'general', 'news', 'shopping') or a list of explicit subagent names (e.g., ['amazon_serp', 'target_serp']) - full_content: Return richer per-result content on the fast path. With search_depth='fast', - enables live crawling of both web and news sources so results carry full - markdown content instead of snippets only. Higher recall and cost. Ignored for - other search_depth values. + full_content: Return full page content for each result, in addition to its title, url, and + description. Works with either search_depth value. Higher recall and cost. include_answer: Generate an LLM-powered answer summary based on search result snippets. @@ -1205,8 +1204,7 @@ def search( - 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 + - standard: Rich content (~2K chars) optimized for AI agents start_date: Filter results after this date (format: YYYY-MM-DD or YYYY) @@ -2368,7 +2366,7 @@ async def search( 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, + search_depth: Optional[Literal["lite", "standard"]] | 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. @@ -2390,7 +2388,8 @@ async def search( country: Country code for geo-targeted results (e.g., 'US', 'GB', 'IL') - deep_search: Deprecated. Use search_depth instead. true maps to 'deep', false maps to 'lite'. + deep_search: Deprecated. Use search_depth with full_content instead. true maps to 'lite' with + full_content=true, false maps to 'lite'. end_date: Filter results before this date (format: YYYY-MM-DD or YYYY) @@ -2399,10 +2398,8 @@ async def search( focus: Search focus mode (e.g., 'general', 'news', 'shopping') or a list of explicit subagent names (e.g., ['amazon_serp', 'target_serp']) - full_content: Return richer per-result content on the fast path. With search_depth='fast', - enables live crawling of both web and news sources so results carry full - markdown content instead of snippets only. Higher recall and cost. Ignored for - other search_depth values. + full_content: Return full page content for each result, in addition to its title, url, and + description. Works with either search_depth value. Higher recall and cost. include_answer: Generate an LLM-powered answer summary based on search result snippets. @@ -2422,8 +2419,7 @@ async def search( - 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 + - standard: Rich content (~2K chars) optimized for AI agents start_date: Filter results after this date (format: YYYY-MM-DD or YYYY) diff --git a/src/nimble_python/types/client_search_params.py b/src/nimble_python/types/client_search_params.py index 19c7f44..933eb50 100644 --- a/src/nimble_python/types/client_search_params.py +++ b/src/nimble_python/types/client_search_params.py @@ -27,7 +27,8 @@ class ClientSearchParams(TypedDict, total=False): deep_search: Optional[bool] """Deprecated. - Use search_depth instead. true maps to 'deep', false maps to 'lite'. + Use search_depth with full_content instead. true maps to 'lite' with + full_content=true, false maps to 'lite'. """ end_date: Optional[str] @@ -43,11 +44,9 @@ class ClientSearchParams(TypedDict, total=False): """ full_content: bool - """Return richer per-result content on the fast path. - - With search_depth='fast', enables live crawling of both web and news sources so - results carry full markdown content instead of snippets only. Higher recall and - cost. Ignored for other search_depth values. + """ + Return full page content for each result, in addition to its title, url, and + description. Works with either search_depth value. Higher recall and cost. """ include_answer: bool @@ -74,13 +73,12 @@ 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"]] + search_depth: Optional[Literal["lite", "standard"]] """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 + - standard: Rich content (~2K chars) optimized for AI agents """ start_date: Optional[str] From 9614bb63998d8430c60a2870741a0da50ed3654f Mon Sep 17 00:00:00 2001 From: "stainless-app[bot]" <142633134+stainless-app[bot]@users.noreply.github.com> Date: Mon, 7 Sep 2026 13:19:55 +0000 Subject: [PATCH 2/2] release: 1.6.0 --- .release-please-manifest.json | 2 +- CHANGELOG.md | 8 ++++++++ pyproject.toml | 2 +- src/nimble_python/_version.py | 2 +- 4 files changed, 11 insertions(+), 3 deletions(-) diff --git a/.release-please-manifest.json b/.release-please-manifest.json index fbd9082..7deae33 100644 --- a/.release-please-manifest.json +++ b/.release-please-manifest.json @@ -1,3 +1,3 @@ { - ".": "1.5.0" + ".": "1.6.0" } \ No newline at end of file diff --git a/CHANGELOG.md b/CHANGELOG.md index 1a6675e..5fe12f4 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,13 @@ # Changelog +## 1.6.0 (2026-09-07) + +Full Changelog: [v1.5.0...v1.6.0](https://github.com/Nimbleway/nimble-python/compare/v1.5.0...v1.6.0) + +### Features + +* **api:** api update ([5bdd92b](https://github.com/Nimbleway/nimble-python/commit/5bdd92ba7b63be1f67fb56f9be114be7d3193365)) + ## 1.5.0 (2026-08-25) Full Changelog: [v1.4.0...v1.5.0](https://github.com/Nimbleway/nimble-python/compare/v1.4.0...v1.5.0) diff --git a/pyproject.toml b/pyproject.toml index e14c713..af55faf 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -1,6 +1,6 @@ [project] name = "nimble_python" -version = "1.5.0" +version = "1.6.0" description = "The official Python library for the nimble API" dynamic = ["readme"] license = "Apache-2.0" diff --git a/src/nimble_python/_version.py b/src/nimble_python/_version.py index f650b14..eef01e7 100644 --- a/src/nimble_python/_version.py +++ b/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__ = "1.5.0" # x-release-please-version +__version__ = "1.6.0" # x-release-please-version