release: 0.54.0

.github/workflows/ci.yml

@@ -18,7 +18,7 @@ jobs:
   lint:
     timeout-minutes: 10
     name: lint
-    runs-on: ${{ github.repository == 'stainless-sdks/profound-python' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
+    runs-on: ${{ startsWith(github.repository, 'stainless-sdks/') && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
     if: (github.event_name == 'push' || github.event.pull_request.head.repo.fork) && (github.event_name != 'push' || github.event.head_commit.message != 'codegen metadata')
     steps:
       - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
@@ -41,7 +41,7 @@ jobs:
     permissions:
       contents: read
       id-token: write
-    runs-on: ${{ github.repository == 'stainless-sdks/profound-python' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
+    runs-on: ${{ startsWith(github.repository, 'stainless-sdks/') && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
     steps:
       - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
@@ -78,7 +78,7 @@ jobs:
   test:
     timeout-minutes: 10
     name: test
-    runs-on: ${{ github.repository == 'stainless-sdks/profound-python' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
+    runs-on: ${{ startsWith(github.repository, 'stainless-sdks/') && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
     if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
     steps:
       - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.53.0"
+  ".": "0.54.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 102
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/profound/profound-17587551addb077f3da29dd969fcd5f57c7272b4d3d3b1707dca00b1d04b7ee8.yml
-openapi_spec_hash: 261e4f33ccaac115058a54ffc28ad9f6
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/profound/profound-5f34810928a953e7787f5d7dff3a0da1e67ef9ac237d01b9aa4a9e596b0f2a0a.yml
+openapi_spec_hash: e4a76a9d25f44d1dfbd509828504e762
 config_hash: 48130b77367435ca80edf565b73c49f9

CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## 0.54.0 (2026-07-22)
+
+Full Changelog: [v0.53.0...v0.54.0](https://github.com/cooper-square-technologies/profound-python-sdk/compare/v0.53.0...v0.54.0)
+
+### Features
+
+* **api:** api update ([edd5fb6](https://github.com/cooper-square-technologies/profound-python-sdk/commit/edd5fb6d807dd72234eeda6f0effddbed4086c9e))
+* **api:** api update ([79dcecf](https://github.com/cooper-square-technologies/profound-python-sdk/commit/79dcecf0ac4be6dbb3ec556677e21c6688818e5b))
+* **api:** api update ([949c8c4](https://github.com/cooper-square-technologies/profound-python-sdk/commit/949c8c4aecea50ff7fdf56dc3b3ab74a032aa2bb))
+* **api:** api update ([ee476f4](https://github.com/cooper-square-technologies/profound-python-sdk/commit/ee476f40439fd739ac8b3e97b028e55b98135a5d))
+* **api:** api update ([641081e](https://github.com/cooper-square-technologies/profound-python-sdk/commit/641081e222e99a24287f76aca3888d4752b4a07a))
+* **api:** api update ([dcd95d9](https://github.com/cooper-square-technologies/profound-python-sdk/commit/dcd95d9e47d35660760d6590073613d4ef0fc510))
+* **api:** api update ([7aa69a6](https://github.com/cooper-square-technologies/profound-python-sdk/commit/7aa69a6761298ead98c4092ce427303f0343b626))
+* **api:** api update ([bedb038](https://github.com/cooper-square-technologies/profound-python-sdk/commit/bedb0380d42036914f5b548f24d3e056a7672f19))
+* **stlc:** configurable CI runner and private-production-repo support in workflow templates ([02477bf](https://github.com/cooper-square-technologies/profound-python-sdk/commit/02477bf17e69c20b0132cfafe82e54949e0fe960))
+
+
+### Bug Fixes
+
+* **internal:** resolve build failures ([a3e6d1f](https://github.com/cooper-square-technologies/profound-python-sdk/commit/a3e6d1f6665d12629d8c16e90bcc946b18b089bb))
+
 ## 0.53.0 (2026-07-13)
 
 Full Changelog: [v0.52.0...v0.53.0](https://github.com/cooper-square-technologies/profound-python-sdk/compare/v0.52.0...v0.53.0)

api.md

@@ -91,14 +91,18 @@ Methods:
 Types:
 
 ```python
-from profound.types import PromptAnswersResponse, PromptAnswersV2Response
+from profound.types import (
+    PromptAnswersResponse,
+    PromptAnswersV2Response,
+    PromptStreamAnswersV2Response,
+)
 ```
 
 Methods:
 
 - <code title="post /v1/prompts/answers">client.prompts.<a href="./src/profound/resources/prompts.py">answers</a>(\*\*<a href="src/profound/types/prompt_answers_params.py">params</a>) -> <a href="./src/profound/types/prompt_answers_response.py">PromptAnswersResponse</a></code>
 - <code title="post /v2/prompts/answers">client.prompts.<a href="./src/profound/resources/prompts.py">answers_v2</a>(\*\*<a href="src/profound/types/prompt_answers_v2_params.py">params</a>) -> <a href="./src/profound/types/prompt_answers_v2_response.py">PromptAnswersV2Response</a></code>
-- <code title="post /v2/prompts/answers/stream">client.prompts.<a href="./src/profound/resources/prompts.py">stream_answers_v2</a>(\*\*<a href="src/profound/types/prompt_stream_answers_v2_params.py">params</a>) -> None</code>
+- <code title="post /v2/prompts/answers/stream">client.prompts.<a href="./src/profound/resources/prompts.py">stream_answers_v2</a>(\*\*<a href="src/profound/types/prompt_stream_answers_v2_params.py">params</a>) -> <a href="./src/profound/types/prompt_stream_answers_v2_response.py">PromptStreamAnswersV2Response</a></code>
 
 # Reports
 
@@ -122,8 +126,12 @@ from profound.types import (
     ReportQueryVisibilityResponse,
     ReportSentimentV2Response,
     ReportStreamCitationsResponse,
+    ReportStreamCitationsV2Response,
+    ReportStreamQueryFanoutsResponse,
     ReportStreamSentimentResponse,
+    ReportStreamSentimentV2Response,
     ReportStreamVisibilityResponse,
+    ReportStreamVisibilityV2Response,
 )
 ```
 
@@ -142,12 +150,12 @@ Methods:
 - <code title="post /v1/reports/sentiment">client.reports.<a href="./src/profound/resources/reports/reports.py">sentiment</a>(\*\*<a href="src/profound/types/report_sentiment_params.py">params</a>) -> <a href="./src/profound/types/report_response.py">ReportResponse</a></code>
 - <code title="post /v1/reports/sentiment-v2">client.reports.<a href="./src/profound/resources/reports/reports.py">sentiment_v2</a>(\*\*<a href="src/profound/types/report_sentiment_v2_params.py">params</a>) -> <a href="./src/profound/types/report_sentiment_v2_response.py">ReportSentimentV2Response</a></code>
 - <code title="post /v1/reports/citations/stream">client.reports.<a href="./src/profound/resources/reports/reports.py">stream_citations</a>(\*\*<a href="src/profound/types/report_stream_citations_params.py">params</a>) -> <a href="./src/profound/types/report_stream_citations_response.py">ReportStreamCitationsResponse</a></code>
-- <code title="post /v2/reports/citations/stream">client.reports.<a href="./src/profound/resources/reports/reports.py">stream_citations_v2</a>(\*\*<a href="src/profound/types/report_stream_citations_v2_params.py">params</a>) -> None</code>
-- <code title="post /v2/reports/query-fanouts/stream">client.reports.<a href="./src/profound/resources/reports/reports.py">stream_query_fanouts</a>(\*\*<a href="src/profound/types/report_stream_query_fanouts_params.py">params</a>) -> None</code>
+- <code title="post /v2/reports/citations/stream">client.reports.<a href="./src/profound/resources/reports/reports.py">stream_citations_v2</a>(\*\*<a href="src/profound/types/report_stream_citations_v2_params.py">params</a>) -> <a href="./src/profound/types/report_stream_citations_v2_response.py">ReportStreamCitationsV2Response</a></code>
+- <code title="post /v2/reports/query-fanouts/stream">client.reports.<a href="./src/profound/resources/reports/reports.py">stream_query_fanouts</a>(\*\*<a href="src/profound/types/report_stream_query_fanouts_params.py">params</a>) -> <a href="./src/profound/types/report_stream_query_fanouts_response.py">ReportStreamQueryFanoutsResponse</a></code>
 - <code title="post /v1/reports/sentiment/stream">client.reports.<a href="./src/profound/resources/reports/reports.py">stream_sentiment</a>(\*\*<a href="src/profound/types/report_stream_sentiment_params.py">params</a>) -> <a href="./src/profound/types/report_stream_sentiment_response.py">ReportStreamSentimentResponse</a></code>
-- <code title="post /v2/reports/sentiment/stream">client.reports.<a href="./src/profound/resources/reports/reports.py">stream_sentiment_v2</a>(\*\*<a href="src/profound/types/report_stream_sentiment_v2_params.py">params</a>) -> None</code>
+- <code title="post /v2/reports/sentiment/stream">client.reports.<a href="./src/profound/resources/reports/reports.py">stream_sentiment_v2</a>(\*\*<a href="src/profound/types/report_stream_sentiment_v2_params.py">params</a>) -> <a href="./src/profound/types/report_stream_sentiment_v2_response.py">ReportStreamSentimentV2Response</a></code>
 - <code title="post /v1/reports/visibility/stream">client.reports.<a href="./src/profound/resources/reports/reports.py">stream_visibility</a>(\*\*<a href="src/profound/types/report_stream_visibility_params.py">params</a>) -> <a href="./src/profound/types/report_stream_visibility_response.py">ReportStreamVisibilityResponse</a></code>
-- <code title="post /v2/reports/visibility/stream">client.reports.<a href="./src/profound/resources/reports/reports.py">stream_visibility_v2</a>(\*\*<a href="src/profound/types/report_stream_visibility_v2_params.py">params</a>) -> None</code>
+- <code title="post /v2/reports/visibility/stream">client.reports.<a href="./src/profound/resources/reports/reports.py">stream_visibility_v2</a>(\*\*<a href="src/profound/types/report_stream_visibility_v2_params.py">params</a>) -> <a href="./src/profound/types/report_stream_visibility_v2_response.py">ReportStreamVisibilityV2Response</a></code>
 - <code title="post /v1/reports/visibility">client.reports.<a href="./src/profound/resources/reports/reports.py">visibility</a>(\*\*<a href="src/profound/types/report_visibility_params.py">params</a>) -> <a href="./src/profound/types/report_response.py">ReportResponse</a></code>
 
 ## WebSearchResults
@@ -241,26 +249,26 @@ Methods:
 Types:
 
 ```python
-from profound.types.reports import FactcheckQueryScoresResponse
+from profound.types.reports import FactcheckQueryScoresResponse, FactcheckStreamScoresResponse
 ```
 
 Methods:
 
 - <code title="post /v2/reports/factcheck">client.reports.factcheck.<a href="./src/profound/resources/reports/factcheck/factcheck.py">query_scores</a>(\*\*<a href="src/profound/types/reports/factcheck_query_scores_params.py">params</a>) -> <a href="./src/profound/types/reports/factcheck_query_scores_response.py">FactcheckQueryScoresResponse</a></code>
-- <code title="post /v2/reports/factcheck/stream">client.reports.factcheck.<a href="./src/profound/resources/reports/factcheck/factcheck.py">stream_scores</a>(\*\*<a href="src/profound/types/reports/factcheck_stream_scores_params.py">params</a>) -> None</code>
+- <code title="post /v2/reports/factcheck/stream">client.reports.factcheck.<a href="./src/profound/resources/reports/factcheck/factcheck.py">stream_scores</a>(\*\*<a href="src/profound/types/reports/factcheck_stream_scores_params.py">params</a>) -> <a href="./src/profound/types/reports/factcheck_stream_scores_response.py">FactcheckStreamScoresResponse</a></code>
 
 ### Claims
 
 Types:
 
 ```python
-from profound.types.reports.factcheck import ClaimQueryClaimsResponse
+from profound.types.reports.factcheck import ClaimQueryClaimsResponse, ClaimStreamClaimsResponse
 ```
 
 Methods:
 
 - <code title="post /v2/reports/factcheck/claims">client.reports.factcheck.claims.<a href="./src/profound/resources/reports/factcheck/claims.py">query_claims</a>(\*\*<a href="src/profound/types/reports/factcheck/claim_query_claims_params.py">params</a>) -> <a href="./src/profound/types/reports/factcheck/claim_query_claims_response.py">ClaimQueryClaimsResponse</a></code>
-- <code title="post /v2/reports/factcheck/claims/stream">client.reports.factcheck.claims.<a href="./src/profound/resources/reports/factcheck/claims.py">stream_claims</a>(\*\*<a href="src/profound/types/reports/factcheck/claim_stream_claims_params.py">params</a>) -> None</code>
+- <code title="post /v2/reports/factcheck/claims/stream">client.reports.factcheck.claims.<a href="./src/profound/resources/reports/factcheck/claims.py">stream_claims</a>(\*\*<a href="src/profound/types/reports/factcheck/claim_stream_claims_params.py">params</a>) -> <a href="./src/profound/types/reports/factcheck/claim_stream_claims_response.py">ClaimStreamClaimsResponse</a></code>
 
 # Content
 
@@ -312,7 +320,7 @@ from profound.types.agents import RunCreateResponse, RunRetrieveResponse
 Methods:
 
 - <code title="post /v1/agents/{agent_id}/runs">client.agents.runs.<a href="./src/profound/resources/agents/runs.py">create</a>(agent_id, \*\*<a href="src/profound/types/agents/run_create_params.py">params</a>) -> <a href="./src/profound/types/agents/run_create_response.py">RunCreateResponse</a></code>
-- <code title="get /v1/agents/{agent_id}/runs/{run_id}">client.agents.runs.<a href="./src/profound/resources/agents/runs.py">retrieve</a>(run_id, \*, agent_id) -> <a href="./src/profound/types/agents/run_retrieve_response.py">RunRetrieveResponse</a></code>
+- <code title="get /v1/agents/{agent_id}/runs/{run_id}">client.agents.runs.<a href="./src/profound/resources/agents/runs.py">retrieve</a>(run_id, \*, agent_id, \*\*<a href="src/profound/types/agents/run_retrieve_params.py">params</a>) -> <a href="./src/profound/types/agents/run_retrieve_response.py">RunRetrieveResponse</a></code>
 
 ## NodeTypes
 

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "profound"
-version = "0.53.0"
+version = "0.54.0"
 description = "The official Python library for the profound API"
 dynamic = ["readme"]
 license = "Apache-2.0"

scripts/lint

@@ -13,7 +13,7 @@ else
 fi
 
 echo "==> Running pyright"
-uv run pyright
+uv run pyright -p .
 
 echo "==> Running mypy"
 uv run mypy .

src/profound/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "profound"
-__version__ = "0.53.0"  # x-release-please-version
+__version__ = "0.54.0"  # x-release-please-version

src/profound/resources/agents/node_types.py

@@ -78,7 +78,7 @@ def retrieve_schema(
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> NodeTypeRetrieveSchemaResponse:
         """
-        Retrieve the JSON schema and worked examples for a single node type.
+        Retrieve the JSON schema for a single node type.
 
         The `schema` field is an opaque JSON Schema for the node's configuration. Use
         `schema_version` as a cache key — it bumps whenever the schema changes.
@@ -162,7 +162,7 @@ async def retrieve_schema(
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> NodeTypeRetrieveSchemaResponse:
         """
-        Retrieve the JSON schema and worked examples for a single node type.
+        Retrieve the JSON schema for a single node type.
 
         The `schema` field is an opaque JSON Schema for the node's configuration. Use
         `schema_version` as a cache key — it bumps whenever the schema changes.

src/profound/resources/agents/runs.py

@@ -17,7 +17,7 @@
     async_to_streamed_response_wrapper,
 )
 from ..._base_client import make_request_options
-from ...types.agents import run_create_params
+from ...types.agents import run_create_params, run_retrieve_params
 from ...types.agents.run_create_response import RunCreateResponse
 from ...types.agents.run_retrieve_response import RunRetrieveResponse
 
@@ -93,6 +93,7 @@ def retrieve(
         run_id: str,
         *,
         agent_id: str,
+        verbose: 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,
@@ -108,6 +109,8 @@ def retrieve(
 
           run_id: The ID of the run to retrieve.
 
+          verbose: Include each step's raw `outputs` payload in the execution trace.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -123,7 +126,11 @@ def retrieve(
         return self._get(
             path_template("/v1/agents/{agent_id}/runs/{run_id}", agent_id=agent_id, run_id=run_id),
             options=make_request_options(
-                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=maybe_transform({"verbose": verbose}, run_retrieve_params.RunRetrieveParams),
             ),
             cast_to=RunRetrieveResponse,
         )
@@ -198,6 +205,7 @@ async def retrieve(
         run_id: str,
         *,
         agent_id: str,
+        verbose: 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,
@@ -213,6 +221,8 @@ async def retrieve(
 
           run_id: The ID of the run to retrieve.
 
+          verbose: Include each step's raw `outputs` payload in the execution trace.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -228,7 +238,11 @@ async def retrieve(
         return await self._get(
             path_template("/v1/agents/{agent_id}/runs/{run_id}", agent_id=agent_id, run_id=run_id),
             options=make_request_options(
-                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=await async_maybe_transform({"verbose": verbose}, run_retrieve_params.RunRetrieveParams),
             ),
             cast_to=RunRetrieveResponse,
         )