nimble_python 0.22.0__py3-none-any.whl → 0.24.0__py3-none-any.whl

nimble_python/_client.py

@@ -61,13 +61,14 @@ from .types.extract_async_response import ExtractAsyncResponse
 from .types.extract_batch_response import ExtractBatchResponse
 
 if TYPE_CHECKING:
-    from .resources import jobs, serp, agent, crawl, media, tasks, batches, task_agent, domain_knowledge
+    from .resources import jobs, serp, agent, crawl, media, tasks, batches, fast_serp, 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.fast_serp import FastSerpResource, AsyncFastSerpResource
     from .resources.jobs.jobs import JobsResource, AsyncJobsResource
     from .resources.domain_knowledge import DomainKnowledgeResource, AsyncDomainKnowledgeResource
     from .resources.task_agent.task_agent import TaskAgentResource, AsyncTaskAgentResource
@@ -185,6 +186,12 @@ class Nimble(SyncAPIClient):
 
         return SerpResource(self)
 
+    @cached_property
+    def fast_serp(self) -> FastSerpResource:
+        from .resources.fast_serp import FastSerpResource
+
+        return FastSerpResource(self)
+
     @cached_property
     def task_agent(self) -> TaskAgentResource:
         from .resources.task_agent import TaskAgentResource
@@ -3228,7 +3235,6 @@ 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,
@@ -3261,8 +3267,6 @@ 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)
@@ -3312,7 +3316,6 @@ 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,
@@ -3479,6 +3482,12 @@ class AsyncNimble(AsyncAPIClient):
 
         return AsyncSerpResource(self)
 
+    @cached_property
+    def fast_serp(self) -> AsyncFastSerpResource:
+        from .resources.fast_serp import AsyncFastSerpResource
+
+        return AsyncFastSerpResource(self)
+
     @cached_property
     def task_agent(self) -> AsyncTaskAgentResource:
         from .resources.task_agent import AsyncTaskAgentResource
@@ -6522,7 +6531,6 @@ 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,
@@ -6555,8 +6563,6 @@ 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)
@@ -6606,7 +6612,6 @@ 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,
@@ -6727,6 +6732,12 @@ class NimbleWithRawResponse:
 
         return SerpResourceWithRawResponse(self._client.serp)
 
+    @cached_property
+    def fast_serp(self) -> fast_serp.FastSerpResourceWithRawResponse:
+        from .resources.fast_serp import FastSerpResourceWithRawResponse
+
+        return FastSerpResourceWithRawResponse(self._client.fast_serp)
+
     @cached_property
     def task_agent(self) -> task_agent.TaskAgentResourceWithRawResponse:
         from .resources.task_agent import TaskAgentResourceWithRawResponse
@@ -6804,6 +6815,12 @@ class AsyncNimbleWithRawResponse:
 
         return AsyncSerpResourceWithRawResponse(self._client.serp)
 
+    @cached_property
+    def fast_serp(self) -> fast_serp.AsyncFastSerpResourceWithRawResponse:
+        from .resources.fast_serp import AsyncFastSerpResourceWithRawResponse
+
+        return AsyncFastSerpResourceWithRawResponse(self._client.fast_serp)
+
     @cached_property
     def task_agent(self) -> task_agent.AsyncTaskAgentResourceWithRawResponse:
         from .resources.task_agent import AsyncTaskAgentResourceWithRawResponse
@@ -6881,6 +6898,12 @@ class NimbleWithStreamedResponse:
 
         return SerpResourceWithStreamingResponse(self._client.serp)
 
+    @cached_property
+    def fast_serp(self) -> fast_serp.FastSerpResourceWithStreamingResponse:
+        from .resources.fast_serp import FastSerpResourceWithStreamingResponse
+
+        return FastSerpResourceWithStreamingResponse(self._client.fast_serp)
+
     @cached_property
     def task_agent(self) -> task_agent.TaskAgentResourceWithStreamingResponse:
         from .resources.task_agent import TaskAgentResourceWithStreamingResponse
@@ -6958,6 +6981,12 @@ class AsyncNimbleWithStreamedResponse:
 
         return AsyncSerpResourceWithStreamingResponse(self._client.serp)
 
+    @cached_property
+    def fast_serp(self) -> fast_serp.AsyncFastSerpResourceWithStreamingResponse:
+        from .resources.fast_serp import AsyncFastSerpResourceWithStreamingResponse
+
+        return AsyncFastSerpResourceWithStreamingResponse(self._client.fast_serp)
+
     @cached_property
     def task_agent(self) -> task_agent.AsyncTaskAgentResourceWithStreamingResponse:
         from .resources.task_agent import AsyncTaskAgentResourceWithStreamingResponse

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

nimble_python/resources/__init__.py

@@ -56,6 +56,14 @@ from .batches import (
     BatchesResourceWithStreamingResponse,
     AsyncBatchesResourceWithStreamingResponse,
 )
+from .fast_serp import (
+    FastSerpResource,
+    AsyncFastSerpResource,
+    FastSerpResourceWithRawResponse,
+    AsyncFastSerpResourceWithRawResponse,
+    FastSerpResourceWithStreamingResponse,
+    AsyncFastSerpResourceWithStreamingResponse,
+)
 from .task_agent import (
     TaskAgentResource,
     AsyncTaskAgentResource,
@@ -116,6 +124,12 @@ __all__ = [
     "AsyncSerpResourceWithRawResponse",
     "SerpResourceWithStreamingResponse",
     "AsyncSerpResourceWithStreamingResponse",
+    "FastSerpResource",
+    "AsyncFastSerpResource",
+    "FastSerpResourceWithRawResponse",
+    "AsyncFastSerpResourceWithRawResponse",
+    "FastSerpResourceWithStreamingResponse",
+    "AsyncFastSerpResourceWithStreamingResponse",
     "TaskAgentResource",
     "AsyncTaskAgentResource",
     "TaskAgentResourceWithRawResponse",

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
 
@@ -56,6 +57,7 @@ class AgentResource(SyncAPIResource):
         """
         return AgentResourceWithStreamingResponse(self)
 
+    @typing_extensions.deprecated("deprecated")
     def list(
         self,
         *,
@@ -114,6 +116,7 @@ class AgentResource(SyncAPIResource):
             cast_to=AgentListResponse,
         )
 
+    @typing_extensions.deprecated("deprecated")
     @overload
     def generate(
         self,
@@ -121,7 +124,7 @@ class AgentResource(SyncAPIResource):
         prompt: str,
         url: str,
         input_schema: Dict[str, object] | Omit = omit,
-        metadata: Optional[agent_generate_params.CreateAgentGenerationRequestMetadata] | Omit = omit,
+        metadata: Optional[agent_generate_params.CreateTemplateGenerationRequestPublicV1Metadata] | Omit = omit,
         name: Optional[str] | Omit = omit,
         output_schema: Dict[str, object] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -145,6 +148,7 @@ class AgentResource(SyncAPIResource):
         """
         ...
 
+    @typing_extensions.deprecated("deprecated")
     @overload
     def generate(
         self,
@@ -172,6 +176,7 @@ class AgentResource(SyncAPIResource):
         """
         ...
 
+    @typing_extensions.deprecated("deprecated")
     @required_args(["prompt", "url"], ["from_agent", "prompt"])
     def generate(
         self,
@@ -179,7 +184,7 @@ class AgentResource(SyncAPIResource):
         prompt: str,
         url: str | Omit = omit,
         input_schema: Dict[str, object] | Omit = omit,
-        metadata: Optional[agent_generate_params.CreateAgentGenerationRequestMetadata] | Omit = omit,
+        metadata: Optional[agent_generate_params.CreateTemplateGenerationRequestPublicV1Metadata] | Omit = omit,
         name: Optional[str] | Omit = omit,
         output_schema: Dict[str, object] | Omit = omit,
         from_agent: str | Omit = omit,
@@ -210,6 +215,7 @@ class AgentResource(SyncAPIResource):
             cast_to=AgentGenerateResponse,
         )
 
+    @typing_extensions.deprecated("deprecated")
     def get(
         self,
         template_name: str,
@@ -243,6 +249,7 @@ class AgentResource(SyncAPIResource):
             cast_to=AgentGetResponse,
         )
 
+    @typing_extensions.deprecated("deprecated")
     def get_generation(
         self,
         generation_id: str,
@@ -447,6 +454,7 @@ class AsyncAgentResource(AsyncAPIResource):
         """
         return AsyncAgentResourceWithStreamingResponse(self)
 
+    @typing_extensions.deprecated("deprecated")
     async def list(
         self,
         *,
@@ -505,6 +513,7 @@ class AsyncAgentResource(AsyncAPIResource):
             cast_to=AgentListResponse,
         )
 
+    @typing_extensions.deprecated("deprecated")
     @overload
     async def generate(
         self,
@@ -512,7 +521,7 @@ class AsyncAgentResource(AsyncAPIResource):
         prompt: str,
         url: str,
         input_schema: Dict[str, object] | Omit = omit,
-        metadata: Optional[agent_generate_params.CreateAgentGenerationRequestMetadata] | Omit = omit,
+        metadata: Optional[agent_generate_params.CreateTemplateGenerationRequestPublicV1Metadata] | Omit = omit,
         name: Optional[str] | Omit = omit,
         output_schema: Dict[str, object] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -536,6 +545,7 @@ class AsyncAgentResource(AsyncAPIResource):
         """
         ...
 
+    @typing_extensions.deprecated("deprecated")
     @overload
     async def generate(
         self,
@@ -563,6 +573,7 @@ class AsyncAgentResource(AsyncAPIResource):
         """
         ...
 
+    @typing_extensions.deprecated("deprecated")
     @required_args(["prompt", "url"], ["from_agent", "prompt"])
     async def generate(
         self,
@@ -570,7 +581,7 @@ class AsyncAgentResource(AsyncAPIResource):
         prompt: str,
         url: str | Omit = omit,
         input_schema: Dict[str, object] | Omit = omit,
-        metadata: Optional[agent_generate_params.CreateAgentGenerationRequestMetadata] | Omit = omit,
+        metadata: Optional[agent_generate_params.CreateTemplateGenerationRequestPublicV1Metadata] | Omit = omit,
         name: Optional[str] | Omit = omit,
         output_schema: Dict[str, object] | Omit = omit,
         from_agent: str | Omit = omit,
@@ -601,6 +612,7 @@ class AsyncAgentResource(AsyncAPIResource):
             cast_to=AgentGenerateResponse,
         )
 
+    @typing_extensions.deprecated("deprecated")
     async def get(
         self,
         template_name: str,
@@ -634,6 +646,7 @@ class AsyncAgentResource(AsyncAPIResource):
             cast_to=AgentGetResponse,
         )
 
+    @typing_extensions.deprecated("deprecated")
     async def get_generation(
         self,
         generation_id: str,
@@ -822,17 +835,25 @@ class AgentResourceWithRawResponse:
     def __init__(self, agent: AgentResource) -> None:
         self._agent = agent
 
-        self.list = to_raw_response_wrapper(
-            agent.list,
+        self.list = (  # pyright: ignore[reportDeprecated]
+            to_raw_response_wrapper(
+                agent.list,  # pyright: ignore[reportDeprecated],
+            )
         )
-        self.generate = to_raw_response_wrapper(
-            agent.generate,
+        self.generate = (  # pyright: ignore[reportDeprecated]
+            to_raw_response_wrapper(
+                agent.generate,  # pyright: ignore[reportDeprecated],
+            )
         )
-        self.get = to_raw_response_wrapper(
-            agent.get,
+        self.get = (  # pyright: ignore[reportDeprecated]
+            to_raw_response_wrapper(
+                agent.get,  # pyright: ignore[reportDeprecated],
+            )
         )
-        self.get_generation = to_raw_response_wrapper(
-            agent.get_generation,
+        self.get_generation = (  # pyright: ignore[reportDeprecated]
+            to_raw_response_wrapper(
+                agent.get_generation,  # pyright: ignore[reportDeprecated],
+            )
         )
         self.run = to_raw_response_wrapper(
             agent.run,
@@ -849,17 +870,25 @@ class AsyncAgentResourceWithRawResponse:
     def __init__(self, agent: AsyncAgentResource) -> None:
         self._agent = agent
 
-        self.list = async_to_raw_response_wrapper(
-            agent.list,
+        self.list = (  # pyright: ignore[reportDeprecated]
+            async_to_raw_response_wrapper(
+                agent.list,  # pyright: ignore[reportDeprecated],
+            )
         )
-        self.generate = async_to_raw_response_wrapper(
-            agent.generate,
+        self.generate = (  # pyright: ignore[reportDeprecated]
+            async_to_raw_response_wrapper(
+                agent.generate,  # pyright: ignore[reportDeprecated],
+            )
         )
-        self.get = async_to_raw_response_wrapper(
-            agent.get,
+        self.get = (  # pyright: ignore[reportDeprecated]
+            async_to_raw_response_wrapper(
+                agent.get,  # pyright: ignore[reportDeprecated],
+            )
         )
-        self.get_generation = async_to_raw_response_wrapper(
-            agent.get_generation,
+        self.get_generation = (  # pyright: ignore[reportDeprecated]
+            async_to_raw_response_wrapper(
+                agent.get_generation,  # pyright: ignore[reportDeprecated],
+            )
         )
         self.run = async_to_raw_response_wrapper(
             agent.run,
@@ -876,17 +905,25 @@ class AgentResourceWithStreamingResponse:
     def __init__(self, agent: AgentResource) -> None:
         self._agent = agent
 
-        self.list = to_streamed_response_wrapper(
-            agent.list,
+        self.list = (  # pyright: ignore[reportDeprecated]
+            to_streamed_response_wrapper(
+                agent.list,  # pyright: ignore[reportDeprecated],
+            )
         )
-        self.generate = to_streamed_response_wrapper(
-            agent.generate,
+        self.generate = (  # pyright: ignore[reportDeprecated]
+            to_streamed_response_wrapper(
+                agent.generate,  # pyright: ignore[reportDeprecated],
+            )
         )
-        self.get = to_streamed_response_wrapper(
-            agent.get,
+        self.get = (  # pyright: ignore[reportDeprecated]
+            to_streamed_response_wrapper(
+                agent.get,  # pyright: ignore[reportDeprecated],
+            )
         )
-        self.get_generation = to_streamed_response_wrapper(
-            agent.get_generation,
+        self.get_generation = (  # pyright: ignore[reportDeprecated]
+            to_streamed_response_wrapper(
+                agent.get_generation,  # pyright: ignore[reportDeprecated],
+            )
         )
         self.run = to_streamed_response_wrapper(
             agent.run,
@@ -903,17 +940,25 @@ class AsyncAgentResourceWithStreamingResponse:
     def __init__(self, agent: AsyncAgentResource) -> None:
         self._agent = agent
 
-        self.list = async_to_streamed_response_wrapper(
-            agent.list,
-        )
-        self.generate = async_to_streamed_response_wrapper(
-            agent.generate,
-        )
-        self.get = async_to_streamed_response_wrapper(
-            agent.get,
-        )
-        self.get_generation = async_to_streamed_response_wrapper(
-            agent.get_generation,
+        self.list = (  # pyright: ignore[reportDeprecated]
+            async_to_streamed_response_wrapper(
+                agent.list,  # pyright: ignore[reportDeprecated],
+            )
+        )
+        self.generate = (  # pyright: ignore[reportDeprecated]
+            async_to_streamed_response_wrapper(
+                agent.generate,  # pyright: ignore[reportDeprecated],
+            )
+        )
+        self.get = (  # pyright: ignore[reportDeprecated]
+            async_to_streamed_response_wrapper(
+                agent.get,  # pyright: ignore[reportDeprecated],
+            )
+        )
+        self.get_generation = (  # pyright: ignore[reportDeprecated]
+            async_to_streamed_response_wrapper(
+                agent.get_generation,  # pyright: ignore[reportDeprecated],
+            )
         )
         self.run = async_to_streamed_response_wrapper(
             agent.run,