nimble_python 0.18.0__tar.gz → 0.20.0__tar.gz

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

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

{nimble_python-0.18.0 → nimble_python-0.20.0}/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 0.20.0 (2026-06-18)
+
+Full Changelog: [v0.19.0...v0.20.0](https://github.com/Nimbleway/nimble-python/compare/v0.19.0...v0.20.0)
+
+### Features
+
+* **api:** Add jobs api ([9065317](https://github.com/Nimbleway/nimble-python/commit/90653176f426f3566d6b596ab46573dfa5d6bf23))
+* **api:** api update ([0dd31cd](https://github.com/Nimbleway/nimble-python/commit/0dd31cd413a4f9803d95d087a17db47c7fd2cac1))
+
+## 0.19.0 (2026-06-11)
+
+Full Changelog: [v0.18.0...v0.19.0](https://github.com/Nimbleway/nimble-python/compare/v0.18.0...v0.19.0)
+
+### Features
+
+* **api:** manually update openapi ([790af21](https://github.com/Nimbleway/nimble-python/commit/790af21dc4e08b66c5d64e2aa01c0814d1cc2fc6))
+* **api:** Manually update OpenAPI spec ([cc790ea](https://github.com/Nimbleway/nimble-python/commit/cc790ea7a08ea9c84bb79397a6720d630a07eced))
+* **internal/types:** support eagerly validating pydantic iterators ([0e7f8a9](https://github.com/Nimbleway/nimble-python/commit/0e7f8a99fc9d2c80c5eed1891b0e6b37187afc78))
+
 ## 0.18.0 (2026-05-10)
 
 Full Changelog: [v0.17.0...v0.18.0](https://github.com/Nimbleway/nimble-python/compare/v0.17.0...v0.18.0)

{nimble_python-0.18.0 → nimble_python-0.20.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: nimble_python
-Version: 0.18.0
+Version: 0.20.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.18.0 → nimble_python-0.20.0}/api.md

@@ -50,7 +50,6 @@ from nimble_python.types import (
     AgentGenerateResponse,
     AgentGetResponse,
     AgentGetGenerationResponse,
-    AgentPublishResponse,
     AgentRunResponse,
     AgentRunAsyncResponse,
     AgentRunBatchResponse,
@@ -63,7 +62,6 @@ Methods:
 - <code title="post /v1/agents/generations">client.agent.<a href="./src/nimble_python/resources/agent.py">generate</a>(\*\*<a href="src/nimble_python/types/agent_generate_params.py">params</a>) -> <a href="./src/nimble_python/types/agent_generate_response.py">AgentGenerateResponse</a></code>
 - <code title="get /v1/agents/{template_name}">client.agent.<a href="./src/nimble_python/resources/agent.py">get</a>(template_name) -> <a href="./src/nimble_python/types/agent_get_response.py">AgentGetResponse</a></code>
 - <code title="get /v1/agents/generations/{generation_id}">client.agent.<a href="./src/nimble_python/resources/agent.py">get_generation</a>(generation_id) -> <a href="./src/nimble_python/types/agent_get_generation_response.py">AgentGetGenerationResponse</a></code>
-- <code title="post /v1/agents/{agent_name}/publish">client.agent.<a href="./src/nimble_python/resources/agent.py">publish</a>(agent_name, \*\*<a href="src/nimble_python/types/agent_publish_params.py">params</a>) -> <a href="./src/nimble_python/types/agent_publish_response.py">AgentPublishResponse</a></code>
 - <code title="post /v1/agents/run">client.agent.<a href="./src/nimble_python/resources/agent.py">run</a>(\*\*<a href="src/nimble_python/types/agent_run_params.py">params</a>) -> <a href="./src/nimble_python/types/agent_run_response.py">AgentRunResponse</a></code>
 - <code title="post /v1/agents/async">client.agent.<a href="./src/nimble_python/resources/agent.py">run_async</a>(\*\*<a href="src/nimble_python/types/agent_run_async_params.py">params</a>) -> <a href="./src/nimble_python/types/agent_run_async_response.py">AgentRunAsyncResponse</a></code>
 - <code title="post /v1/agents/batch">client.agent.<a href="./src/nimble_python/resources/agent.py">run_batch</a>(\*\*<a href="src/nimble_python/types/agent_run_batch_params.py">params</a>) -> <a href="./src/nimble_python/types/agent_run_batch_response.py">AgentRunBatchResponse</a></code>
@@ -154,3 +152,112 @@ Methods:
 - <code title="post /v1/serp">client.serp.<a href="./src/nimble_python/resources/serp.py">run</a>(\*\*<a href="src/nimble_python/types/serp_run_params.py">params</a>) -> <a href="./src/nimble_python/types/serp_run_response.py">SerpRunResponse</a></code>
 - <code title="post /v1/serp/async">client.serp.<a href="./src/nimble_python/resources/serp.py">run_async</a>(\*\*<a href="src/nimble_python/types/serp_run_async_params.py">params</a>) -> <a href="./src/nimble_python/types/serp_run_async_response.py">SerpRunAsyncResponse</a></code>
 - <code title="post /v1/serp/batch">client.serp.<a href="./src/nimble_python/resources/serp.py">run_batch</a>(\*\*<a href="src/nimble_python/types/serp_run_batch_params.py">params</a>) -> <a href="./src/nimble_python/types/serp_run_batch_response.py">SerpRunBatchResponse</a></code>
+
+# TaskAgent
+
+Types:
+
+```python
+from nimble_python.types import (
+    TaskAgentCreateResponse,
+    TaskAgentUpdateResponse,
+    TaskAgentListResponse,
+    TaskAgentGetResponse,
+    TaskAgentRunResponse,
+)
+```
+
+Methods:
+
+- <code title="post /v1/task-agents">client.task_agent.<a href="./src/nimble_python/resources/task_agent/task_agent.py">create</a>(\*\*<a href="src/nimble_python/types/task_agent_create_params.py">params</a>) -> <a href="./src/nimble_python/types/task_agent_create_response.py">TaskAgentCreateResponse</a></code>
+- <code title="patch /v1/task-agents/{agent_id}">client.task_agent.<a href="./src/nimble_python/resources/task_agent/task_agent.py">update</a>(agent_id, \*\*<a href="src/nimble_python/types/task_agent_update_params.py">params</a>) -> <a href="./src/nimble_python/types/task_agent_update_response.py">TaskAgentUpdateResponse</a></code>
+- <code title="get /v1/task-agents">client.task_agent.<a href="./src/nimble_python/resources/task_agent/task_agent.py">list</a>(\*\*<a href="src/nimble_python/types/task_agent_list_params.py">params</a>) -> <a href="./src/nimble_python/types/task_agent_list_response.py">TaskAgentListResponse</a></code>
+- <code title="delete /v1/task-agents/{agent_id}">client.task_agent.<a href="./src/nimble_python/resources/task_agent/task_agent.py">deactivate</a>(agent_id) -> None</code>
+- <code title="get /v1/task-agents/{agent_id}">client.task_agent.<a href="./src/nimble_python/resources/task_agent/task_agent.py">get</a>(agent_id) -> <a href="./src/nimble_python/types/task_agent_get_response.py">TaskAgentGetResponse</a></code>
+- <code title="post /v1/task-agents/{agent_id}/runs">client.task_agent.<a href="./src/nimble_python/resources/task_agent/task_agent.py">run</a>(agent_id, \*\*<a href="src/nimble_python/types/task_agent_run_params.py">params</a>) -> <a href="./src/nimble_python/types/task_agent_run_response.py">TaskAgentRunResponse</a></code>
+
+## Templates
+
+Types:
+
+```python
+from nimble_python.types.task_agent import TemplateListResponse, TemplateGetResponse
+```
+
+Methods:
+
+- <code title="get /v1/task-agents/templates">client.task_agent.templates.<a href="./src/nimble_python/resources/task_agent/templates.py">list</a>(\*\*<a href="src/nimble_python/types/task_agent/template_list_params.py">params</a>) -> <a href="./src/nimble_python/types/task_agent/template_list_response.py">TemplateListResponse</a></code>
+- <code title="get /v1/task-agents/templates/{template_name}">client.task_agent.templates.<a href="./src/nimble_python/resources/task_agent/templates.py">get</a>(template_name) -> <a href="./src/nimble_python/types/task_agent/template_get_response.py">TemplateGetResponse</a></code>
+
+## Runs
+
+Types:
+
+```python
+from nimble_python.types.task_agent import RunListResponse, RunGetResponse, RunGetResultResponse
+```
+
+Methods:
+
+- <code title="get /v1/task-agents/{agent_id}/runs">client.task_agent.runs.<a href="./src/nimble_python/resources/task_agent/runs.py">list</a>(agent_id, \*\*<a href="src/nimble_python/types/task_agent/run_list_params.py">params</a>) -> <a href="./src/nimble_python/types/task_agent/run_list_response.py">RunListResponse</a></code>
+- <code title="post /v1/task-agents/{agent_id}/runs/{run_id}/cancel">client.task_agent.runs.<a href="./src/nimble_python/resources/task_agent/runs.py">cancel</a>(run_id, \*, agent_id) -> None</code>
+- <code title="get /v1/task-agents/{agent_id}/runs/{run_id}">client.task_agent.runs.<a href="./src/nimble_python/resources/task_agent/runs.py">get</a>(run_id, \*, agent_id) -> <a href="./src/nimble_python/types/task_agent/run_get_response.py">RunGetResponse</a></code>
+- <code title="get /v1/task-agents/{agent_id}/runs/{run_id}/result">client.task_agent.runs.<a href="./src/nimble_python/resources/task_agent/runs.py">get_result</a>(run_id, \*, agent_id) -> <a href="./src/nimble_python/types/task_agent/run_get_result_response.py">RunGetResultResponse</a></code>
+- <code title="get /v1/task-agents/{agent_id}/runs/{run_id}/events">client.task_agent.runs.<a href="./src/nimble_python/resources/task_agent/runs.py">stream_events</a>(run_id, \*, agent_id) -> object</code>
+
+# Jobs
+
+Types:
+
+```python
+from nimble_python.types import (
+    JobCreateResponse,
+    JobUpdateResponse,
+    JobListResponse,
+    JobGetResponse,
+    JobRunResponse,
+)
+```
+
+Methods:
+
+- <code title="post /v1/jobs">client.jobs.<a href="./src/nimble_python/resources/jobs/jobs.py">create</a>(\*\*<a href="src/nimble_python/types/job_create_params.py">params</a>) -> <a href="./src/nimble_python/types/job_create_response.py">JobCreateResponse</a></code>
+- <code title="patch /v1/jobs/{job_id}">client.jobs.<a href="./src/nimble_python/resources/jobs/jobs.py">update</a>(job_id, \*\*<a href="src/nimble_python/types/job_update_params.py">params</a>) -> <a href="./src/nimble_python/types/job_update_response.py">JobUpdateResponse</a></code>
+- <code title="get /v1/jobs">client.jobs.<a href="./src/nimble_python/resources/jobs/jobs.py">list</a>(\*\*<a href="src/nimble_python/types/job_list_params.py">params</a>) -> <a href="./src/nimble_python/types/job_list_response.py">JobListResponse</a></code>
+- <code title="delete /v1/jobs/{job_id}">client.jobs.<a href="./src/nimble_python/resources/jobs/jobs.py">delete</a>(job_id) -> None</code>
+- <code title="get /v1/jobs/{job_id}">client.jobs.<a href="./src/nimble_python/resources/jobs/jobs.py">get</a>(job_id) -> <a href="./src/nimble_python/types/job_get_response.py">JobGetResponse</a></code>
+- <code title="post /v1/jobs/{job_id}/runs">client.jobs.<a href="./src/nimble_python/resources/jobs/jobs.py">run</a>(job_id) -> <a href="./src/nimble_python/types/job_run_response.py">JobRunResponse</a></code>
+
+## Runs
+
+Types:
+
+```python
+from nimble_python.types.jobs import RunListResponse, RunCancelResponse, RunGetResponse
+```
+
+Methods:
+
+- <code title="get /v1/jobs/{job_id}/runs">client.jobs.runs.<a href="./src/nimble_python/resources/jobs/runs/runs.py">list</a>(job_id, \*\*<a href="src/nimble_python/types/jobs/run_list_params.py">params</a>) -> <a href="./src/nimble_python/types/jobs/run_list_response.py">RunListResponse</a></code>
+- <code title="post /v1/jobs/runs/{run_id}/cancel">client.jobs.runs.<a href="./src/nimble_python/resources/jobs/runs/runs.py">cancel</a>(run_id) -> <a href="./src/nimble_python/types/jobs/run_cancel_response.py">RunCancelResponse</a></code>
+- <code title="get /v1/jobs/runs/{run_id}">client.jobs.runs.<a href="./src/nimble_python/resources/jobs/runs/runs.py">get</a>(run_id) -> <a href="./src/nimble_python/types/jobs/run_get_response.py">RunGetResponse</a></code>
+
+### Artifacts
+
+Types:
+
+```python
+from nimble_python.types.jobs.runs import (
+    ArtifactListResponse,
+    ArtifactDownloadURLResponse,
+    ArtifactGetResponse,
+    ArtifactPreviewResponse,
+)
+```
+
+Methods:
+
+- <code title="get /v1/jobs/runs/{run_id}/artifacts">client.jobs.runs.artifacts.<a href="./src/nimble_python/resources/jobs/runs/artifacts.py">list</a>(run_id) -> <a href="./src/nimble_python/types/jobs/runs/artifact_list_response.py">ArtifactListResponse</a></code>
+- <code title="get /v1/jobs/runs/{run_id}/artifacts/{artifact_id}/download-url">client.jobs.runs.artifacts.<a href="./src/nimble_python/resources/jobs/runs/artifacts.py">download_url</a>(artifact_id, \*, run_id) -> <a href="./src/nimble_python/types/jobs/runs/artifact_download_url_response.py">ArtifactDownloadURLResponse</a></code>
+- <code title="get /v1/jobs/runs/{run_id}/artifacts/{artifact_id}">client.jobs.runs.artifacts.<a href="./src/nimble_python/resources/jobs/runs/artifacts.py">get</a>(artifact_id, \*, run_id) -> <a href="./src/nimble_python/types/jobs/runs/artifact_get_response.py">ArtifactGetResponse</a></code>
+- <code title="get /v1/jobs/runs/{run_id}/artifacts/{artifact_id}/preview">client.jobs.runs.artifacts.<a href="./src/nimble_python/resources/jobs/runs/artifacts.py">preview</a>(artifact_id, \*, run_id) -> <a href="./src/nimble_python/types/jobs/runs/artifact_preview_response.py">ArtifactPreviewResponse</a></code>

{nimble_python-0.18.0 → nimble_python-0.20.0}/pyproject.toml

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

{nimble_python-0.18.0 → nimble_python-0.20.0}/src/nimble_python/_client.py

@@ -61,14 +61,16 @@ from .types.extract_async_response import ExtractAsyncResponse
 from .types.extract_batch_response import ExtractBatchResponse
 
 if TYPE_CHECKING:
-    from .resources import serp, agent, crawl, media, tasks, batches, domain_knowledge
+    from .resources import jobs, serp, agent, crawl, media, tasks, batches, task_agent, domain_knowledge
     from .resources.serp import SerpResource, AsyncSerpResource
     from .resources.agent import AgentResource, AsyncAgentResource
     from .resources.crawl import CrawlResource, AsyncCrawlResource
     from .resources.media import MediaResource, AsyncMediaResource
     from .resources.tasks import TasksResource, AsyncTasksResource
     from .resources.batches import BatchesResource, AsyncBatchesResource
+    from .resources.jobs.jobs import JobsResource, AsyncJobsResource
     from .resources.domain_knowledge import DomainKnowledgeResource, AsyncDomainKnowledgeResource
+    from .resources.task_agent.task_agent import TaskAgentResource, AsyncTaskAgentResource
 
 __all__ = ["Timeout", "Transport", "ProxiesTypes", "RequestOptions", "Nimble", "AsyncNimble", "Client", "AsyncClient"]
 
@@ -183,6 +185,18 @@ class Nimble(SyncAPIClient):
 
         return SerpResource(self)
 
+    @cached_property
+    def task_agent(self) -> TaskAgentResource:
+        from .resources.task_agent import TaskAgentResource
+
+        return TaskAgentResource(self)
+
+    @cached_property
+    def jobs(self) -> JobsResource:
+        from .resources.jobs import JobsResource
+
+        return JobsResource(self)
+
     @cached_property
     def with_raw_response(self) -> NimbleWithRawResponse:
         return NimbleWithRawResponse(self)
@@ -280,6 +294,7 @@ class Nimble(SyncAPIClient):
         self,
         *,
         url: str,
+        body: object | Omit = omit,
         browser: client_extract_params.Browser | Omit = omit,
         browser_actions: Iterable[client_extract_params.BrowserAction] | Omit = omit,
         city: str | Omit = omit,
@@ -1092,7 +1107,7 @@ class Nimble(SyncAPIClient):
             "random", "no-referer", "same-origin", "google", "bing", "facebook", "twitter", "instagram"
         ]
         | Omit = omit,
-        render: bool | Omit = omit,
+        render: Union[bool, Literal["auto"]] | Omit = omit,
         request_timeout: float | Omit = omit,
         session: client_extract_params.Session | Omit = omit,
         skill: Union[str, SequenceNotStr[str]] | Omit = omit,
@@ -1169,6 +1184,8 @@ class Nimble(SyncAPIClient):
         Args:
           url: Target URL to scrape
 
+          body: Request body for POST, PUT, PATCH methods
+
           browser: Browser type to emulate
 
           browser_actions: Array of browser automation actions to execute sequentially
@@ -1236,6 +1253,7 @@ class Nimble(SyncAPIClient):
             body=maybe_transform(
                 {
                     "url": url,
+                    "body": body,
                     "browser": browser,
                     "browser_actions": browser_actions,
                     "city": city,
@@ -1276,6 +1294,7 @@ class Nimble(SyncAPIClient):
         self,
         *,
         url: str,
+        body: object | Omit = omit,
         browser: client_extract_async_params.Browser | Omit = omit,
         browser_actions: Iterable[client_extract_async_params.BrowserAction] | Omit = omit,
         callback_url: str | Omit = omit,
@@ -2089,7 +2108,7 @@ class Nimble(SyncAPIClient):
             "random", "no-referer", "same-origin", "google", "bing", "facebook", "twitter", "instagram"
         ]
         | Omit = omit,
-        render: bool | Omit = omit,
+        render: Union[bool, Literal["auto"]] | Omit = omit,
         request_timeout: float | Omit = omit,
         session: client_extract_async_params.Session | Omit = omit,
         skill: Union[str, SequenceNotStr[str]] | Omit = omit,
@@ -2170,6 +2189,8 @@ class Nimble(SyncAPIClient):
         Args:
           url: Target URL to scrape
 
+          body: Request body for POST, PUT, PATCH methods
+
           browser: Browser type to emulate
 
           browser_actions: Array of browser automation actions to execute sequentially
@@ -2247,6 +2268,7 @@ class Nimble(SyncAPIClient):
             body=maybe_transform(
                 {
                     "url": url,
+                    "body": body,
                     "browser": browser,
                     "browser_actions": browser_actions,
                     "callback_url": callback_url,
@@ -3186,6 +3208,7 @@ class Nimble(SyncAPIClient):
         query: str,
         content_type: Optional[SequenceNotStr[str]] | Omit = omit,
         country: str | Omit = omit,
+        debug_params: Optional[Dict[str, object]] | Omit = omit,
         deep_search: Optional[bool] | Omit = omit,
         end_date: Optional[str] | Omit = omit,
         exclude_domains: Optional[SequenceNotStr[str]] | Omit = omit,
@@ -3218,6 +3241,8 @@ class Nimble(SyncAPIClient):
 
           country: Country code for geo-targeted results (e.g., 'US', 'GB', 'IL')
 
+          debug_params: Internal-only. Gated to allowlisted accounts; ignored otherwise.
+
           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)
@@ -3267,6 +3292,7 @@ class Nimble(SyncAPIClient):
                     "query": query,
                     "content_type": content_type,
                     "country": country,
+                    "debug_params": debug_params,
                     "deep_search": deep_search,
                     "end_date": end_date,
                     "exclude_domains": exclude_domains,
@@ -3433,6 +3459,18 @@ class AsyncNimble(AsyncAPIClient):
 
         return AsyncSerpResource(self)
 
+    @cached_property
+    def task_agent(self) -> AsyncTaskAgentResource:
+        from .resources.task_agent import AsyncTaskAgentResource
+
+        return AsyncTaskAgentResource(self)
+
+    @cached_property
+    def jobs(self) -> AsyncJobsResource:
+        from .resources.jobs import AsyncJobsResource
+
+        return AsyncJobsResource(self)
+
     @cached_property
     def with_raw_response(self) -> AsyncNimbleWithRawResponse:
         return AsyncNimbleWithRawResponse(self)
@@ -3530,6 +3568,7 @@ class AsyncNimble(AsyncAPIClient):
         self,
         *,
         url: str,
+        body: object | Omit = omit,
         browser: client_extract_params.Browser | Omit = omit,
         browser_actions: Iterable[client_extract_params.BrowserAction] | Omit = omit,
         city: str | Omit = omit,
@@ -4342,7 +4381,7 @@ class AsyncNimble(AsyncAPIClient):
             "random", "no-referer", "same-origin", "google", "bing", "facebook", "twitter", "instagram"
         ]
         | Omit = omit,
-        render: bool | Omit = omit,
+        render: Union[bool, Literal["auto"]] | Omit = omit,
         request_timeout: float | Omit = omit,
         session: client_extract_params.Session | Omit = omit,
         skill: Union[str, SequenceNotStr[str]] | Omit = omit,
@@ -4419,6 +4458,8 @@ class AsyncNimble(AsyncAPIClient):
         Args:
           url: Target URL to scrape
 
+          body: Request body for POST, PUT, PATCH methods
+
           browser: Browser type to emulate
 
           browser_actions: Array of browser automation actions to execute sequentially
@@ -4486,6 +4527,7 @@ class AsyncNimble(AsyncAPIClient):
             body=await async_maybe_transform(
                 {
                     "url": url,
+                    "body": body,
                     "browser": browser,
                     "browser_actions": browser_actions,
                     "city": city,
@@ -4526,6 +4568,7 @@ class AsyncNimble(AsyncAPIClient):
         self,
         *,
         url: str,
+        body: object | Omit = omit,
         browser: client_extract_async_params.Browser | Omit = omit,
         browser_actions: Iterable[client_extract_async_params.BrowserAction] | Omit = omit,
         callback_url: str | Omit = omit,
@@ -5339,7 +5382,7 @@ class AsyncNimble(AsyncAPIClient):
             "random", "no-referer", "same-origin", "google", "bing", "facebook", "twitter", "instagram"
         ]
         | Omit = omit,
-        render: bool | Omit = omit,
+        render: Union[bool, Literal["auto"]] | Omit = omit,
         request_timeout: float | Omit = omit,
         session: client_extract_async_params.Session | Omit = omit,
         skill: Union[str, SequenceNotStr[str]] | Omit = omit,
@@ -5420,6 +5463,8 @@ class AsyncNimble(AsyncAPIClient):
         Args:
           url: Target URL to scrape
 
+          body: Request body for POST, PUT, PATCH methods
+
           browser: Browser type to emulate
 
           browser_actions: Array of browser automation actions to execute sequentially
@@ -5497,6 +5542,7 @@ class AsyncNimble(AsyncAPIClient):
             body=await async_maybe_transform(
                 {
                     "url": url,
+                    "body": body,
                     "browser": browser,
                     "browser_actions": browser_actions,
                     "callback_url": callback_url,
@@ -6436,6 +6482,7 @@ class AsyncNimble(AsyncAPIClient):
         query: str,
         content_type: Optional[SequenceNotStr[str]] | Omit = omit,
         country: str | Omit = omit,
+        debug_params: Optional[Dict[str, object]] | Omit = omit,
         deep_search: Optional[bool] | Omit = omit,
         end_date: Optional[str] | Omit = omit,
         exclude_domains: Optional[SequenceNotStr[str]] | Omit = omit,
@@ -6468,6 +6515,8 @@ class AsyncNimble(AsyncAPIClient):
 
           country: Country code for geo-targeted results (e.g., 'US', 'GB', 'IL')
 
+          debug_params: Internal-only. Gated to allowlisted accounts; ignored otherwise.
+
           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)
@@ -6517,6 +6566,7 @@ class AsyncNimble(AsyncAPIClient):
                     "query": query,
                     "content_type": content_type,
                     "country": country,
+                    "debug_params": debug_params,
                     "deep_search": deep_search,
                     "end_date": end_date,
                     "exclude_domains": exclude_domains,
@@ -6637,6 +6687,18 @@ class NimbleWithRawResponse:
 
         return SerpResourceWithRawResponse(self._client.serp)
 
+    @cached_property
+    def task_agent(self) -> task_agent.TaskAgentResourceWithRawResponse:
+        from .resources.task_agent import TaskAgentResourceWithRawResponse
+
+        return TaskAgentResourceWithRawResponse(self._client.task_agent)
+
+    @cached_property
+    def jobs(self) -> jobs.JobsResourceWithRawResponse:
+        from .resources.jobs import JobsResourceWithRawResponse
+
+        return JobsResourceWithRawResponse(self._client.jobs)
+
 
 class AsyncNimbleWithRawResponse:
     _client: AsyncNimble
@@ -6702,6 +6764,18 @@ class AsyncNimbleWithRawResponse:
 
         return AsyncSerpResourceWithRawResponse(self._client.serp)
 
+    @cached_property
+    def task_agent(self) -> task_agent.AsyncTaskAgentResourceWithRawResponse:
+        from .resources.task_agent import AsyncTaskAgentResourceWithRawResponse
+
+        return AsyncTaskAgentResourceWithRawResponse(self._client.task_agent)
+
+    @cached_property
+    def jobs(self) -> jobs.AsyncJobsResourceWithRawResponse:
+        from .resources.jobs import AsyncJobsResourceWithRawResponse
+
+        return AsyncJobsResourceWithRawResponse(self._client.jobs)
+
 
 class NimbleWithStreamedResponse:
     _client: Nimble
@@ -6767,6 +6841,18 @@ class NimbleWithStreamedResponse:
 
         return SerpResourceWithStreamingResponse(self._client.serp)
 
+    @cached_property
+    def task_agent(self) -> task_agent.TaskAgentResourceWithStreamingResponse:
+        from .resources.task_agent import TaskAgentResourceWithStreamingResponse
+
+        return TaskAgentResourceWithStreamingResponse(self._client.task_agent)
+
+    @cached_property
+    def jobs(self) -> jobs.JobsResourceWithStreamingResponse:
+        from .resources.jobs import JobsResourceWithStreamingResponse
+
+        return JobsResourceWithStreamingResponse(self._client.jobs)
+
 
 class AsyncNimbleWithStreamedResponse:
     _client: AsyncNimble
@@ -6832,6 +6918,18 @@ class AsyncNimbleWithStreamedResponse:
 
         return AsyncSerpResourceWithStreamingResponse(self._client.serp)
 
+    @cached_property
+    def task_agent(self) -> task_agent.AsyncTaskAgentResourceWithStreamingResponse:
+        from .resources.task_agent import AsyncTaskAgentResourceWithStreamingResponse
+
+        return AsyncTaskAgentResourceWithStreamingResponse(self._client.task_agent)
+
+    @cached_property
+    def jobs(self) -> jobs.AsyncJobsResourceWithStreamingResponse:
+        from .resources.jobs import AsyncJobsResourceWithStreamingResponse
+
+        return AsyncJobsResourceWithStreamingResponse(self._client.jobs)
+
 
 Client = Nimble
 

{nimble_python-0.18.0 → nimble_python-0.20.0}/src/nimble_python/_models.py

@@ -25,7 +25,9 @@ from typing_extensions import (
     ClassVar,
     Protocol,
     Required,
+    Annotated,
     ParamSpec,
+    TypeAlias,
     TypedDict,
     TypeGuard,
     final,
@@ -79,7 +81,15 @@ from ._compat import (
 from ._constants import RAW_RESPONSE_HEADER
 
 if TYPE_CHECKING:
+    from pydantic import GetCoreSchemaHandler, ValidatorFunctionWrapHandler
+    from pydantic_core import CoreSchema, core_schema
     from pydantic_core.core_schema import ModelField, ModelSchema, LiteralSchema, ModelFieldsSchema
+else:
+    try:
+        from pydantic_core import CoreSchema, core_schema
+    except ImportError:
+        CoreSchema = None
+        core_schema = None
 
 __all__ = ["BaseModel", "GenericModel"]
 
@@ -396,6 +406,76 @@ class BaseModel(pydantic.BaseModel):
             )
 
 
+class _EagerIterable(list[_T], Generic[_T]):
+    """
+    Accepts any Iterable[T] input (including generators), consumes it
+    eagerly, and validates all items upfront.
+
+    Validation preserves the original container type where possible
+    (e.g. a set[T] stays a set[T]).  Serialization (model_dump / JSON)
+    always emits a list — round-tripping through model_dump() will not
+    restore the original container type.
+    """
+
+    @classmethod
+    def __get_pydantic_core_schema__(
+        cls,
+        source_type: Any,
+        handler: GetCoreSchemaHandler,
+    ) -> CoreSchema:
+        (item_type,) = get_args(source_type) or (Any,)
+        item_schema: CoreSchema = handler.generate_schema(item_type)
+        list_of_items_schema: CoreSchema = core_schema.list_schema(item_schema)
+
+        return core_schema.no_info_wrap_validator_function(
+            cls._validate,
+            list_of_items_schema,
+            serialization=core_schema.plain_serializer_function_ser_schema(
+                cls._serialize,
+                info_arg=False,
+            ),
+        )
+
+    @staticmethod
+    def _validate(v: Iterable[_T], handler: "ValidatorFunctionWrapHandler") -> Any:
+        original_type: type[Any] = type(v)
+
+        # Normalize to list so list_schema can validate each item
+        if isinstance(v, list):
+            items: list[_T] = v
+        else:
+            try:
+                items = list(v)
+            except TypeError as e:
+                raise TypeError("Value is not iterable") from e
+
+        # Validate items against the inner schema
+        validated: list[_T] = handler(items)
+
+        # Reconstruct original container type
+        if original_type is list:
+            return validated
+        # str(list) produces the list's repr, not a string built from items,
+        # so skip reconstruction for str and its subclasses.
+        if issubclass(original_type, str):
+            return validated
+        try:
+            return original_type(validated)
+        except (TypeError, ValueError):
+            # If the type cannot be reconstructed, just return the validated list
+            return validated
+
+    @staticmethod
+    def _serialize(v: Iterable[_T]) -> list[_T]:
+        """Always serialize as a list so Pydantic's JSON encoder is happy."""
+        if isinstance(v, list):
+            return v
+        return list(v)
+
+
+EagerIterable: TypeAlias = Annotated[Iterable[_T], _EagerIterable]
+
+
 def _construct_field(value: object, field: FieldInfo, key: str) -> object:
     if value is None:
         return field_get_default(field)

{nimble_python-0.18.0 → nimble_python-0.20.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.18.0"  # x-release-please-version
+__version__ = "0.20.0"  # x-release-please-version

{nimble_python-0.18.0 → nimble_python-0.20.0}/src/nimble_python/resources/__init__.py

@@ -1,5 +1,13 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+from .jobs import (
+    JobsResource,
+    AsyncJobsResource,
+    JobsResourceWithRawResponse,
+    AsyncJobsResourceWithRawResponse,
+    JobsResourceWithStreamingResponse,
+    AsyncJobsResourceWithStreamingResponse,
+)
 from .serp import (
     SerpResource,
     AsyncSerpResource,
@@ -48,6 +56,14 @@ from .batches import (
     BatchesResourceWithStreamingResponse,
     AsyncBatchesResourceWithStreamingResponse,
 )
+from .task_agent import (
+    TaskAgentResource,
+    AsyncTaskAgentResource,
+    TaskAgentResourceWithRawResponse,
+    AsyncTaskAgentResourceWithRawResponse,
+    TaskAgentResourceWithStreamingResponse,
+    AsyncTaskAgentResourceWithStreamingResponse,
+)
 from .domain_knowledge import (
     DomainKnowledgeResource,
     AsyncDomainKnowledgeResource,
@@ -100,4 +116,16 @@ __all__ = [
     "AsyncSerpResourceWithRawResponse",
     "SerpResourceWithStreamingResponse",
     "AsyncSerpResourceWithStreamingResponse",
+    "TaskAgentResource",
+    "AsyncTaskAgentResource",
+    "TaskAgentResourceWithRawResponse",
+    "AsyncTaskAgentResourceWithRawResponse",
+    "TaskAgentResourceWithStreamingResponse",
+    "AsyncTaskAgentResourceWithStreamingResponse",
+    "JobsResource",
+    "AsyncJobsResource",
+    "JobsResourceWithRawResponse",
+    "AsyncJobsResourceWithRawResponse",
+    "JobsResourceWithStreamingResponse",
+    "AsyncJobsResourceWithStreamingResponse",
 ]