release: 0.8.0-alpha.3

.github/workflows/ci.yml

@@ -22,10 +22,10 @@ jobs:
     runs-on: ${{ github.repository == 'stainless-sdks/llama-stack-client-python' && '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@v6
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v5
+        uses: astral-sh/setup-uv@d4b2f3b6ecc6e67c4457f6d3e41ec42d3d0fcb86 # v5.4.2
         with:
           version: '0.10.2'
 
@@ -44,10 +44,10 @@ jobs:
       id-token: write
     runs-on: ${{ github.repository == 'stainless-sdks/llama-stack-client-python' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v5
+        uses: astral-sh/setup-uv@d4b2f3b6ecc6e67c4457f6d3e41ec42d3d0fcb86 # v5.4.2
         with:
           version: '0.10.2'
 
@@ -62,7 +62,7 @@ jobs:
           github.repository == 'stainless-sdks/llama-stack-client-python' &&
           !startsWith(github.ref, 'refs/heads/stl/')
         id: github-oidc
-        uses: actions/github-script@v8
+        uses: actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd # v8.0.0
         with:
           script: core.setOutput('github_token', await core.getIDToken());
 
@@ -82,10 +82,10 @@ jobs:
     runs-on: ${{ github.repository == 'stainless-sdks/llama-stack-client-python' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
     if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v5
+        uses: astral-sh/setup-uv@d4b2f3b6ecc6e67c4457f6d3e41ec42d3d0fcb86 # v5.4.2
         with:
           version: '0.10.2'
 

.github/workflows/publish-pypi.yml

@@ -14,10 +14,10 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v5
+        uses: astral-sh/setup-uv@d4b2f3b6ecc6e67c4457f6d3e41ec42d3d0fcb86 # v5.4.2
         with:
           version: '0.9.13'
 

.github/workflows/release-doctor.yml

@@ -12,7 +12,7 @@ jobs:
     if: github.repository == 'ogx-ai/ogx-client-python' && (github.event_name == 'push' || github.event_name == 'workflow_dispatch' || startsWith(github.head_ref, 'release-please') || github.head_ref == 'next')
 
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Check release environment
         run: |

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.8.0-alpha.2"
+  ".": "0.8.0-alpha.3"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 67
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/llamastack/llama-stack-client-0a1c852eda740c79412d2aa642e24f7ed057e69e472885e8fb9463e3d5515b55.yml
-openapi_spec_hash: 36c10a2fd3d75032e220697bd5b30b7f
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/llamastack/llama-stack-client-7f49892b4f9f8b421343f703c14da6fd5a93bba1baada52c1fe72da0e79fcf8e.yml
+openapi_spec_hash: 9c2a6e9e73f135654d42469299b01daa
 config_hash: 3d294831d7b8066ba59a8934b980a943

CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## 0.8.0-alpha.3 (2026-06-10)
+
+Full Changelog: [v0.8.0-alpha.2...v0.8.0-alpha.3](https://github.com/ogx-ai/ogx-client-python/compare/v0.8.0-alpha.2...v0.8.0-alpha.3)
+
+### ⚠ BREAKING CHANGES
+
+* **api:** add post-generation schema transforms for Responses API conformance
+
+### Features
+
+* **responses:** add WebSocket transport and fix OpenResponses conformance gaps ([e470f35](https://github.com/ogx-ai/ogx-client-python/commit/e470f354f25f09fc3400a9b66657f3f077dce95b))
+
+
+### Bug Fixes
+
+* **api:** add post-generation schema transforms for Responses API conformance ([96d1529](https://github.com/ogx-ai/ogx-client-python/commit/96d1529b8003b26fd016974140f6eb9618037cc8))
+* **api:** eliminate schema mismatches in Responses compact endpoint ([28931c4](https://github.com/ogx-ai/ogx-client-python/commit/28931c4593e69479179de766e9419bd092e603af))
+* **api:** fix field-level schema mismatches in Responses models ([aa50fe9](https://github.com/ogx-ai/ogx-client-python/commit/aa50fe9861d4642231fc4ea2d3925220b7bc25ac))
+* **brave-search:** align result slicing with search_context_size count ([40f7162](https://github.com/ogx-ai/ogx-client-python/commit/40f71628597b92ed14c6ae3445e09ffb2927da53))
+
 ## 0.8.0-alpha.2 (2026-05-12)
 
 Full Changelog: [v0.8.0-alpha.1...v0.8.0-alpha.2](https://github.com/ogx-ai/ogx-client-python/compare/v0.8.0-alpha.1...v0.8.0-alpha.2)

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "ogx_client"
-version = "0.8.0-alpha.2"
+version = "0.8.0-alpha.3"
 description = "The official Python library for the ogx-client API"
 dynamic = ["readme"]
 license = "MIT"

src/ogx_client/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "ogx_client"
-__version__ = "0.8.0-alpha.2"  # x-release-please-version
+__version__ = "0.8.0-alpha.3"  # x-release-please-version

src/ogx_client/resources/responses/responses.py

@@ -107,6 +107,7 @@ def create(
         prompt: Optional[response_create_params.Prompt] | Omit = omit,
         prompt_cache_key: Optional[str] | Omit = omit,
         reasoning: Optional[response_create_params.Reasoning] | Omit = omit,
+        safety_identifier: Optional[str] | Omit = omit,
         service_tier: Optional[Literal["auto", "default", "flex", "priority"]] | Omit = omit,
         store: bool | Omit = omit,
         stream: Literal[False] | Omit = omit,
@@ -117,7 +118,7 @@ def create(
         tools: Optional[Iterable[response_create_params.Tool]] | Omit = omit,
         top_logprobs: Optional[int] | Omit = omit,
         top_p: Optional[float] | Omit = omit,
-        truncation: Optional[Literal["auto", "disabled"]] | Omit = omit,
+        truncation: Literal["auto", "disabled"] | 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,
@@ -169,6 +170,9 @@ def create(
 
               Controls how much reasoning the model performs before generating a response.
 
+          safety_identifier: A stable identifier used to associate the request with an end user, for safety
+              monitoring. Echoed back on the response.
+
           service_tier: The service tier for the request.
 
           store: Whether to store the response in the database.
@@ -243,6 +247,7 @@ def create(
         prompt: Optional[response_create_params.Prompt] | Omit = omit,
         prompt_cache_key: Optional[str] | Omit = omit,
         reasoning: Optional[response_create_params.Reasoning] | Omit = omit,
+        safety_identifier: Optional[str] | Omit = omit,
         service_tier: Optional[Literal["auto", "default", "flex", "priority"]] | Omit = omit,
         store: bool | Omit = omit,
         stream_options: Optional[response_create_params.StreamOptions] | Omit = omit,
@@ -252,7 +257,7 @@ def create(
         tools: Optional[Iterable[response_create_params.Tool]] | Omit = omit,
         top_logprobs: Optional[int] | Omit = omit,
         top_p: Optional[float] | Omit = omit,
-        truncation: Optional[Literal["auto", "disabled"]] | Omit = omit,
+        truncation: Literal["auto", "disabled"] | 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,
@@ -306,6 +311,9 @@ def create(
 
               Controls how much reasoning the model performs before generating a response.
 
+          safety_identifier: A stable identifier used to associate the request with an end user, for safety
+              monitoring. Echoed back on the response.
+
           service_tier: The service tier for the request.
 
           store: Whether to store the response in the database.
@@ -378,6 +386,7 @@ def create(
         prompt: Optional[response_create_params.Prompt] | Omit = omit,
         prompt_cache_key: Optional[str] | Omit = omit,
         reasoning: Optional[response_create_params.Reasoning] | Omit = omit,
+        safety_identifier: Optional[str] | Omit = omit,
         service_tier: Optional[Literal["auto", "default", "flex", "priority"]] | Omit = omit,
         store: bool | Omit = omit,
         stream_options: Optional[response_create_params.StreamOptions] | Omit = omit,
@@ -387,7 +396,7 @@ def create(
         tools: Optional[Iterable[response_create_params.Tool]] | Omit = omit,
         top_logprobs: Optional[int] | Omit = omit,
         top_p: Optional[float] | Omit = omit,
-        truncation: Optional[Literal["auto", "disabled"]] | Omit = omit,
+        truncation: Literal["auto", "disabled"] | 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,
@@ -441,6 +450,9 @@ def create(
 
               Controls how much reasoning the model performs before generating a response.
 
+          safety_identifier: A stable identifier used to associate the request with an end user, for safety
+              monitoring. Echoed back on the response.
+
           service_tier: The service tier for the request.
 
           store: Whether to store the response in the database.
@@ -512,6 +524,7 @@ def create(
         prompt: Optional[response_create_params.Prompt] | Omit = omit,
         prompt_cache_key: Optional[str] | Omit = omit,
         reasoning: Optional[response_create_params.Reasoning] | Omit = omit,
+        safety_identifier: Optional[str] | Omit = omit,
         service_tier: Optional[Literal["auto", "default", "flex", "priority"]] | Omit = omit,
         store: bool | Omit = omit,
         stream: Literal[False] | Literal[True] | Omit = omit,
@@ -522,7 +535,7 @@ def create(
         tools: Optional[Iterable[response_create_params.Tool]] | Omit = omit,
         top_logprobs: Optional[int] | Omit = omit,
         top_p: Optional[float] | Omit = omit,
-        truncation: Optional[Literal["auto", "disabled"]] | Omit = omit,
+        truncation: Literal["auto", "disabled"] | 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,
@@ -552,6 +565,7 @@ def create(
                     "prompt": prompt,
                     "prompt_cache_key": prompt_cache_key,
                     "reasoning": reasoning,
+                    "safety_identifier": safety_identifier,
                     "service_tier": service_tier,
                     "store": store,
                     "stream": stream,
@@ -704,7 +718,7 @@ def delete(
     def compact(
         self,
         *,
-        model: str,
+        model: Optional[str],
         input: Union[
             str,
             Iterable[
@@ -732,7 +746,7 @@ def compact(
         preserving context. This endpoint is in alpha and may change without notice.
 
         Args:
-          model: The model to use for generating the compacted summary.
+          model: Model identifier.
 
           input: Input message(s) to compact.
 
@@ -854,6 +868,7 @@ async def create(
         prompt: Optional[response_create_params.Prompt] | Omit = omit,
         prompt_cache_key: Optional[str] | Omit = omit,
         reasoning: Optional[response_create_params.Reasoning] | Omit = omit,
+        safety_identifier: Optional[str] | Omit = omit,
         service_tier: Optional[Literal["auto", "default", "flex", "priority"]] | Omit = omit,
         store: bool | Omit = omit,
         stream: Literal[False] | Omit = omit,
@@ -864,7 +879,7 @@ async def create(
         tools: Optional[Iterable[response_create_params.Tool]] | Omit = omit,
         top_logprobs: Optional[int] | Omit = omit,
         top_p: Optional[float] | Omit = omit,
-        truncation: Optional[Literal["auto", "disabled"]] | Omit = omit,
+        truncation: Literal["auto", "disabled"] | 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,
@@ -916,6 +931,9 @@ async def create(
 
               Controls how much reasoning the model performs before generating a response.
 
+          safety_identifier: A stable identifier used to associate the request with an end user, for safety
+              monitoring. Echoed back on the response.
+
           service_tier: The service tier for the request.
 
           store: Whether to store the response in the database.
@@ -990,6 +1008,7 @@ async def create(
         prompt: Optional[response_create_params.Prompt] | Omit = omit,
         prompt_cache_key: Optional[str] | Omit = omit,
         reasoning: Optional[response_create_params.Reasoning] | Omit = omit,
+        safety_identifier: Optional[str] | Omit = omit,
         service_tier: Optional[Literal["auto", "default", "flex", "priority"]] | Omit = omit,
         store: bool | Omit = omit,
         stream_options: Optional[response_create_params.StreamOptions] | Omit = omit,
@@ -999,7 +1018,7 @@ async def create(
         tools: Optional[Iterable[response_create_params.Tool]] | Omit = omit,
         top_logprobs: Optional[int] | Omit = omit,
         top_p: Optional[float] | Omit = omit,
-        truncation: Optional[Literal["auto", "disabled"]] | Omit = omit,
+        truncation: Literal["auto", "disabled"] | 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,
@@ -1053,6 +1072,9 @@ async def create(
 
               Controls how much reasoning the model performs before generating a response.
 
+          safety_identifier: A stable identifier used to associate the request with an end user, for safety
+              monitoring. Echoed back on the response.
+
           service_tier: The service tier for the request.
 
           store: Whether to store the response in the database.
@@ -1125,6 +1147,7 @@ async def create(
         prompt: Optional[response_create_params.Prompt] | Omit = omit,
         prompt_cache_key: Optional[str] | Omit = omit,
         reasoning: Optional[response_create_params.Reasoning] | Omit = omit,
+        safety_identifier: Optional[str] | Omit = omit,
         service_tier: Optional[Literal["auto", "default", "flex", "priority"]] | Omit = omit,
         store: bool | Omit = omit,
         stream_options: Optional[response_create_params.StreamOptions] | Omit = omit,
@@ -1134,7 +1157,7 @@ async def create(
         tools: Optional[Iterable[response_create_params.Tool]] | Omit = omit,
         top_logprobs: Optional[int] | Omit = omit,
         top_p: Optional[float] | Omit = omit,
-        truncation: Optional[Literal["auto", "disabled"]] | Omit = omit,
+        truncation: Literal["auto", "disabled"] | 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,
@@ -1188,6 +1211,9 @@ async def create(
 
               Controls how much reasoning the model performs before generating a response.
 
+          safety_identifier: A stable identifier used to associate the request with an end user, for safety
+              monitoring. Echoed back on the response.
+
           service_tier: The service tier for the request.
 
           store: Whether to store the response in the database.
@@ -1259,6 +1285,7 @@ async def create(
         prompt: Optional[response_create_params.Prompt] | Omit = omit,
         prompt_cache_key: Optional[str] | Omit = omit,
         reasoning: Optional[response_create_params.Reasoning] | Omit = omit,
+        safety_identifier: Optional[str] | Omit = omit,
         service_tier: Optional[Literal["auto", "default", "flex", "priority"]] | Omit = omit,
         store: bool | Omit = omit,
         stream: Literal[False] | Literal[True] | Omit = omit,
@@ -1269,7 +1296,7 @@ async def create(
         tools: Optional[Iterable[response_create_params.Tool]] | Omit = omit,
         top_logprobs: Optional[int] | Omit = omit,
         top_p: Optional[float] | Omit = omit,
-        truncation: Optional[Literal["auto", "disabled"]] | Omit = omit,
+        truncation: Literal["auto", "disabled"] | 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,
@@ -1299,6 +1326,7 @@ async def create(
                     "prompt": prompt,
                     "prompt_cache_key": prompt_cache_key,
                     "reasoning": reasoning,
+                    "safety_identifier": safety_identifier,
                     "service_tier": service_tier,
                     "store": store,
                     "stream": stream,
@@ -1451,7 +1479,7 @@ async def delete(
     async def compact(
         self,
         *,
-        model: str,
+        model: Optional[str],
         input: Union[
             str,
             Iterable[
@@ -1479,7 +1507,7 @@ async def compact(
         preserving context. This endpoint is in alpha and may change without notice.
 
         Args:
-          model: The model to use for generating the compacted summary.
+          model: Model identifier.
 
           input: Input message(s) to compact.