Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .release-please-manifest.json
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
{
".": "1.5.0"
".": "1.6.0"
}
4 changes: 2 additions & 2 deletions .stats.yml
Original file line number Diff line number Diff line change
@@ -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
8 changes: 8 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -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)
Expand Down
2 changes: 1 addition & 1 deletion pyproject.toml
Original file line number Diff line number Diff line change
@@ -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"
Expand Down
28 changes: 12 additions & 16 deletions src/nimble_python/_client.py
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand All @@ -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)

Expand All @@ -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.

Expand All @@ -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)

Expand Down Expand Up @@ -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.
Expand All @@ -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)

Expand All @@ -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.

Expand All @@ -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)

Expand Down
2 changes: 1 addition & 1 deletion src/nimble_python/_version.py
Original file line number Diff line number Diff line change
@@ -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
16 changes: 7 additions & 9 deletions src/nimble_python/types/client_search_params.py
Original file line number Diff line number Diff line change
Expand Up @@ -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]
Expand All @@ -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
Expand All @@ -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]
Expand Down
Loading