nimble_python 0.22.0__py3-none-any.whl → 0.23.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
@@ -3479,6 +3486,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
@@ -6727,6 +6740,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 +6823,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 +6906,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 +6989,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.23.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

@@ -121,7 +121,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.CrustCreateAgentGenerationRequestMetadata] | 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.
@@ -179,7 +179,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.CrustCreateAgentGenerationRequestMetadata] | Omit = omit,
         name: Optional[str] | Omit = omit,
         output_schema: Dict[str, object] | Omit = omit,
         from_agent: str | Omit = omit,
@@ -512,7 +512,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.CrustCreateAgentGenerationRequestMetadata] | 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.
@@ -570,7 +570,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.CrustCreateAgentGenerationRequestMetadata] | Omit = omit,
         name: Optional[str] | Omit = omit,
         output_schema: Dict[str, object] | Omit = omit,
         from_agent: str | Omit = omit,

nimble_python/resources/fast_serp.py

@@ -0,0 +1,293 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Literal
+
+import httpx
+
+from ..types import fast_serp_run_params
+from .._types import Body, Omit, Query, Headers, NotGiven, omit, not_given
+from .._utils import maybe_transform, async_maybe_transform
+from .._compat import cached_property
+from .._resource import SyncAPIResource, AsyncAPIResource
+from .._response import (
+    to_raw_response_wrapper,
+    to_streamed_response_wrapper,
+    async_to_raw_response_wrapper,
+    async_to_streamed_response_wrapper,
+)
+from .._base_client import make_request_options
+from ..types.fast_serp_run_response import FastSerpRunResponse
+
+__all__ = ["FastSerpResource", "AsyncFastSerpResource"]
+
+
+class FastSerpResource(SyncAPIResource):
+    @cached_property
+    def with_raw_response(self) -> FastSerpResourceWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/Nimbleway/nimble-python#accessing-raw-response-data-eg-headers
+        """
+        return FastSerpResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> FastSerpResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/Nimbleway/nimble-python#with_streaming_response
+        """
+        return FastSerpResourceWithStreamingResponse(self)
+
+    def run(
+        self,
+        *,
+        search_engine: Literal[
+            "google_search",
+            "google_sge",
+            "google_aio",
+            "google_maps_search",
+            "google_maps_reviews",
+            "google_maps_place",
+            "google_news",
+            "google_images",
+            "bing_search",
+            "yandex_search",
+        ],
+        country: str | Omit = omit,
+        device: Literal["desktop", "mobile"] | Omit = omit,
+        domain: str | Omit = omit,
+        locale: str | Omit = omit,
+        location: str | Omit = omit,
+        num_results: int | Omit = omit,
+        page: int | Omit = omit,
+        parse: bool | Omit = omit,
+        query: str | Omit = omit,
+        render: bool | Omit = omit,
+        show_hidden_results: bool | 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,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> FastSerpRunResponse:
+        """
+        Fast SERP
+
+        Args:
+          search_engine: The search engine to query.
+
+          country: ISO Alpha-2 country code used to access the target search engine (e.g. US, DE,
+              GB).
+
+          device: Device type used for the search request.
+
+          domain: Top-level domain for the search engine (e.g. "com", "co.uk", "de").
+
+          locale: Locale used for the search request.
+
+          location: Geo-location for the search (canonical Google location name).
+
+          num_results: Number of results to return (1–100).
+
+          page: The result page number for pagination.
+
+          parse: When true, the SERP response is parsed into structured JSON.
+
+          query: The search keyword or phrase to query.
+
+          render: Whether to render the page in a browser before extracting.
+
+          show_hidden_results: When true, disables Google result filtering (filter=0) so omitted/duplicate and
+              highly similar pages are also returned. Applies to Google search engines.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        return self._post(
+            "/v1/fast-serp",
+            body=maybe_transform(
+                {
+                    "search_engine": search_engine,
+                    "country": country,
+                    "device": device,
+                    "domain": domain,
+                    "locale": locale,
+                    "location": location,
+                    "num_results": num_results,
+                    "page": page,
+                    "parse": parse,
+                    "query": query,
+                    "render": render,
+                    "show_hidden_results": show_hidden_results,
+                },
+                fast_serp_run_params.FastSerpRunParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=FastSerpRunResponse,
+        )
+
+
+class AsyncFastSerpResource(AsyncAPIResource):
+    @cached_property
+    def with_raw_response(self) -> AsyncFastSerpResourceWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/Nimbleway/nimble-python#accessing-raw-response-data-eg-headers
+        """
+        return AsyncFastSerpResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> AsyncFastSerpResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/Nimbleway/nimble-python#with_streaming_response
+        """
+        return AsyncFastSerpResourceWithStreamingResponse(self)
+
+    async def run(
+        self,
+        *,
+        search_engine: Literal[
+            "google_search",
+            "google_sge",
+            "google_aio",
+            "google_maps_search",
+            "google_maps_reviews",
+            "google_maps_place",
+            "google_news",
+            "google_images",
+            "bing_search",
+            "yandex_search",
+        ],
+        country: str | Omit = omit,
+        device: Literal["desktop", "mobile"] | Omit = omit,
+        domain: str | Omit = omit,
+        locale: str | Omit = omit,
+        location: str | Omit = omit,
+        num_results: int | Omit = omit,
+        page: int | Omit = omit,
+        parse: bool | Omit = omit,
+        query: str | Omit = omit,
+        render: bool | Omit = omit,
+        show_hidden_results: bool | 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,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> FastSerpRunResponse:
+        """
+        Fast SERP
+
+        Args:
+          search_engine: The search engine to query.
+
+          country: ISO Alpha-2 country code used to access the target search engine (e.g. US, DE,
+              GB).
+
+          device: Device type used for the search request.
+
+          domain: Top-level domain for the search engine (e.g. "com", "co.uk", "de").
+
+          locale: Locale used for the search request.
+
+          location: Geo-location for the search (canonical Google location name).
+
+          num_results: Number of results to return (1–100).
+
+          page: The result page number for pagination.
+
+          parse: When true, the SERP response is parsed into structured JSON.
+
+          query: The search keyword or phrase to query.
+
+          render: Whether to render the page in a browser before extracting.
+
+          show_hidden_results: When true, disables Google result filtering (filter=0) so omitted/duplicate and
+              highly similar pages are also returned. Applies to Google search engines.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        return await self._post(
+            "/v1/fast-serp",
+            body=await async_maybe_transform(
+                {
+                    "search_engine": search_engine,
+                    "country": country,
+                    "device": device,
+                    "domain": domain,
+                    "locale": locale,
+                    "location": location,
+                    "num_results": num_results,
+                    "page": page,
+                    "parse": parse,
+                    "query": query,
+                    "render": render,
+                    "show_hidden_results": show_hidden_results,
+                },
+                fast_serp_run_params.FastSerpRunParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=FastSerpRunResponse,
+        )
+
+
+class FastSerpResourceWithRawResponse:
+    def __init__(self, fast_serp: FastSerpResource) -> None:
+        self._fast_serp = fast_serp
+
+        self.run = to_raw_response_wrapper(
+            fast_serp.run,
+        )
+
+
+class AsyncFastSerpResourceWithRawResponse:
+    def __init__(self, fast_serp: AsyncFastSerpResource) -> None:
+        self._fast_serp = fast_serp
+
+        self.run = async_to_raw_response_wrapper(
+            fast_serp.run,
+        )
+
+
+class FastSerpResourceWithStreamingResponse:
+    def __init__(self, fast_serp: FastSerpResource) -> None:
+        self._fast_serp = fast_serp
+
+        self.run = to_streamed_response_wrapper(
+            fast_serp.run,
+        )
+
+
+class AsyncFastSerpResourceWithStreamingResponse:
+    def __init__(self, fast_serp: AsyncFastSerpResource) -> None:
+        self._fast_serp = fast_serp
+
+        self.run = async_to_streamed_response_wrapper(
+            fast_serp.run,
+        )

nimble_python/resources/jobs/jobs.py

@@ -84,6 +84,8 @@ class JobsResource(SyncAPIResource):
 
           name: Job name.
 
+          description: Free-text description of the job.
+
           destination: Where a job writes its results.
 
           display_name: Human-friendly job name shown in the UI.
@@ -140,6 +142,8 @@ class JobsResource(SyncAPIResource):
         Update Job
 
         Args:
+          description: New description.
+
           destination: Where a job writes its results.
 
           display_name: New display name.
@@ -376,6 +380,8 @@ class AsyncJobsResource(AsyncAPIResource):
 
           name: Job name.
 
+          description: Free-text description of the job.
+
           destination: Where a job writes its results.
 
           display_name: Human-friendly job name shown in the UI.
@@ -432,6 +438,8 @@ class AsyncJobsResource(AsyncAPIResource):
         Update Job
 
         Args:
+          description: New description.
+
           destination: Where a job writes its results.
 
           display_name: New display name.

nimble_python/resources/task_agent/runs.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Any, cast
+from typing import Any, Optional, cast
 
 import httpx
 
@@ -51,6 +51,8 @@ class RunsResource(SyncAPIResource):
         *,
         limit: int | Omit = omit,
         offset: int | Omit = omit,
+        q: Optional[str] | Omit = omit,
+        status: 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,
@@ -59,7 +61,10 @@ class RunsResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> RunListResponse:
         """
-        List task runs for the caller's workspace and the given agent, newest first.
+        List runs for this instance.
+
+        `status` accepts a lowercase `TaskRunStatusValue` (e.g. "completed") or a
+        comma-separated list of them (e.g. "queued,running").
 
         Args:
           extra_headers: Send extra headers
@@ -83,6 +88,8 @@ class RunsResource(SyncAPIResource):
                     {
                         "limit": limit,
                         "offset": offset,
+                        "q": q,
+                        "status": status,
                     },
                     run_list_params.RunListParams,
                 ),
@@ -105,6 +112,9 @@ class RunsResource(SyncAPIResource):
         """
         Cancel an in-progress or queued run.
 
+        Verb is POST + `/cancel` action segment per the AGENTS-1666 spec (replaces the
+        old `DELETE …/runs/{run_id}`).
+
         Args:
           extra_headers: Send extra headers
 
@@ -139,9 +149,12 @@ class RunsResource(SyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> RunGetResponse:
-        """Poll run status.
+        """
+        Fetch a run by id, scoped to the instance.
 
-        Repeat until status is 'completed', 'failed', or 'cancelled'.
+        A run resolves only when (run_id, agent_id) match — otherwise 404. This means a
+        stale URL with a swapped agent_id won't leak runs across instances even if the
+        run_id is real.
 
         Args:
           extra_headers: Send extra headers
@@ -176,10 +189,15 @@ class RunsResource(SyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> RunGetResultResponse:
-        """Fetch the result for a terminal run.
+        """
+        Fetch the result for a terminal run on this instance.
 
-        Returns 408 if still active, 422 with
-        `AgentRunFailedResult` if failed.
+        Mirrors the previous flat `GET /tasks/runs/:run_id/result` semantics:
+
+        - 404 when the run doesn't belong to the agent.
+        - 408 when the run is still active.
+        - 422 (with TaskRunFailedResult body) when the run failed or was cancelled.
+        - 200 (with TaskRunResult body) on success.
 
         Args:
           extra_headers: Send extra headers
@@ -219,10 +237,8 @@ class RunsResource(SyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> object:
-        """Server-Sent Events stream of real-time progress events for a run.
-
-        The run must
-        have been created with `enable_events=true`.
+        """
+        SSE stream of real-time progress events for a run on this instance.
 
         Args:
           extra_headers: Send extra headers
@@ -272,6 +288,8 @@ class AsyncRunsResource(AsyncAPIResource):
         *,
         limit: int | Omit = omit,
         offset: int | Omit = omit,
+        q: Optional[str] | Omit = omit,
+        status: 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,
@@ -280,7 +298,10 @@ class AsyncRunsResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> RunListResponse:
         """
-        List task runs for the caller's workspace and the given agent, newest first.
+        List runs for this instance.
+
+        `status` accepts a lowercase `TaskRunStatusValue` (e.g. "completed") or a
+        comma-separated list of them (e.g. "queued,running").
 
         Args:
           extra_headers: Send extra headers
@@ -304,6 +325,8 @@ class AsyncRunsResource(AsyncAPIResource):
                     {
                         "limit": limit,
                         "offset": offset,
+                        "q": q,
+                        "status": status,
                     },
                     run_list_params.RunListParams,
                 ),
@@ -326,6 +349,9 @@ class AsyncRunsResource(AsyncAPIResource):
         """
         Cancel an in-progress or queued run.
 
+        Verb is POST + `/cancel` action segment per the AGENTS-1666 spec (replaces the
+        old `DELETE …/runs/{run_id}`).
+
         Args:
           extra_headers: Send extra headers
 
@@ -360,9 +386,12 @@ class AsyncRunsResource(AsyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> RunGetResponse:
-        """Poll run status.
+        """
+        Fetch a run by id, scoped to the instance.
 
-        Repeat until status is 'completed', 'failed', or 'cancelled'.
+        A run resolves only when (run_id, agent_id) match — otherwise 404. This means a
+        stale URL with a swapped agent_id won't leak runs across instances even if the
+        run_id is real.
 
         Args:
           extra_headers: Send extra headers
@@ -397,10 +426,15 @@ class AsyncRunsResource(AsyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> RunGetResultResponse:
-        """Fetch the result for a terminal run.
+        """
+        Fetch the result for a terminal run on this instance.
 
-        Returns 408 if still active, 422 with
-        `AgentRunFailedResult` if failed.
+        Mirrors the previous flat `GET /tasks/runs/:run_id/result` semantics:
+
+        - 404 when the run doesn't belong to the agent.
+        - 408 when the run is still active.
+        - 422 (with TaskRunFailedResult body) when the run failed or was cancelled.
+        - 200 (with TaskRunResult body) on success.
 
         Args:
           extra_headers: Send extra headers
@@ -440,10 +474,8 @@ class AsyncRunsResource(AsyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> object:
-        """Server-Sent Events stream of real-time progress events for a run.
-
-        The run must
-        have been created with `enable_events=true`.
+        """
+        SSE stream of real-time progress events for a run on this instance.
 
         Args:
           extra_headers: Send extra headers