release: 0.81.0

[openai-sdks]

Automated Release PR

0.81.0 (2026-08-25)

Features

• Add client.with_options support (#438) (72b0927)
• add Realtime transcription over WebSockets (#445) (e9f45c4)
• add Realtime WebSocket core (#443) (aba0f05)
• api: add file and vector store polling helpers (#421) (2cad0f7)
• api: Add obfuscation field to ChatCompletionChunk (#484) (5065a37)
• api: add project residency and cost quantity units (#522) (b0abe2b)
• api: support backend-mediated Realtime WebRTC calls (#531) (6ec6c7a)
• auth: add caller-attested X.509 transport capability (#523) (712f3c8)
• realtime: add sideband WebSocket call control (#530) (2fea73b)
• update streaming models and regional endpoint selection (#442) (f2e94ab)

Bug Fixes

• align nullable collection matchers (#497) (ee922b3), closes #376
• attach partial completion to streaming length errors (#432) (2dd3eab)
• auth: harden X.509 refresh and diagnostic boundaries (#529) (dd0a37c)
• ci: require fail-closed CodeQL checks for Ruby and GitHub Actions (#480) (8d716b6)
• ci: update Bedrock lockfile during releases (#509) (ccabba8)
• fix Page#next_page to raise when unavailable (#487) (4d7bb33)
• ignore response stream keepalive events (#422) (0182edd), closes #287
• improve API status error diagnostics (#472) (eab2b2a)
• isolate union coercion state (#446) (5a7752a)
• keep authenticated requests on the configured origin (#470) (3978736)
• keep CodeQL action updates atomic (#473) (1dc83e5)
• normalize filenames inferred from file handles (#468) (d8cba3f)
• omit URL fragments from diagnostic logs (#466) (7bfb7c4)
• preserve derived pagination cursors (#489) (e6346e3)
• preserve generic request authentication precedence (#476) (14695dc)
• preserve nullable nil values (#450) (79cc156)
• preserve request boundaries across redirects (#471) (48be3b5)
• redact credentials from client inspect (#488) (b78194a)
• remove runtime base64 dependency (#454) (d4415dd)
• require authority when validating request origins (#483) (35acd86)
• retain collection conversion errors (#495) (851f534)
• streaming: keep indexed snapshots compact (#490) (0491bb7)
• Validate multipart file content types (#467) (313f3a3)

Chores

• api: Clarify image background and realtime audio-delta docs (#499) (d873fcf)
• api: enforce signature formatting and canonicalize generated Ruby (#451) (38440f2)
• api: refresh image model docs and generated lint policy (#486) (589d384)
• api: refresh SDK generation metadata (#512) (3ddbc77)
• ci: upgrade actions/checkout to v7.0.1 (#475) (4fecd5b)
• deps-dev: bump sorbet-runtime from 0.6.13421 to 0.6.13425 (#493) (a099412)
• deps-dev: bump syntax_tree-rbs from f94bc30 to 2478329 (#462) (3a95231)
• deps-dev: bump the development-dependencies group with 2 updates (#520) (c3fe427)
• deps-dev: safely update development dependencies (#478) (69d62eb)
• deps-dev: upgrade Steep with compatible RBS diagnostics (#474) (85686e9)
• deps: bump actions/github-script from 7.1.0 to 9.0.0 (#485) (f55d45d)
• deps: bump rubygems/release-gem from 1.2.0 to 1.4.1 (#460) (9faee6a)
• deps: bump the codeql group with 2 updates (#521) (bc5f12c)
• deps: configure Ruby and GitHub Actions Dependabot (#439) (4f57b71)
• enforce outer local variable shadowing (#433) (d644765)
• enforce redundant enable directives (#436) (aeb8cde)
• enforce top-level return arguments (#435) (8a022a6)
• isolate documentation dependencies (#482) (3130e59)
• preserve flexibly spaced RBS aliases (#515) (45e3193)
• prevent intermittent RBS formatting failures (#528) (8057a05)
• remove Tapioca development dependency (#452) (0965227)
• restore generated webhook signature comments (#502) (a64c3bd)
• set a 4,000-line custom-code budget (#510) (0706a29)
• skills: prioritize customer-impacting Ruby SDK defects (#519) (d638c57)
• synchronize generated response signatures and tests (#444) (4effc6a)

Documentation

• add Realtime voice turn example (#449) (b18e4c7)
• add recurring repository improvement skill (#491) (8977731)
• realtime: add standard WebSocket workflows (#500) (e0dbef7)
• security: standardize Ruby vulnerability reporting (#440) (2c16022)
• strengthen Ruby SDK security guidance (#437) (68b5c92)

Refactors

• isolate Chat Completions structured-output parsing (#501) (e0e6e42)
• isolate file polling status loops (#496) (7ab65d8)
• isolate Responses structured-output parsing (#498) (2c4abe5)

---

This PR was generated with Release Please. See documentation.

[openai-sdks]

OkTest Summary

✅ 237/237 SDK tests passed in 9.331s for Ruby SDK PR #434.

Test results — 42 files

Test	Result	Time
tests/chat-completions-complex-body.test.ts	✅ Passed	173ms
tests/chat-completions-create.test.ts	✅ Passed	279ms
tests/chat-completions-stream.test.ts	✅ Passed	118ms
tests/files-content-binary.test.ts	✅ Passed	129ms
tests/files-create-multipart.test.ts	✅ Passed	129ms
tests/files-list-pagination.test.ts	✅ Passed	139ms
tests/initialize-config.test.ts	✅ Passed	221ms
tests/instance-isolation.test.ts	✅ Passed	126ms
tests/models-list.test.ts	✅ Passed	255ms
tests/responses-background-lifecycle.test.ts	✅ Passed	187ms
tests/responses-body-method-errors.test.ts	✅ Passed	447ms
tests/responses-cancel-timeout.test.ts	✅ Passed	221ms
tests/responses-cancel.test.ts	✅ Passed	249ms
tests/responses-compact-retries.test.ts	✅ Passed	238ms
tests/responses-compact.test.ts	✅ Passed	226ms
tests/responses-create-advanced-stream.test.ts	✅ Passed	145ms
tests/responses-create-advanced.test.ts	✅ Passed	203ms
tests/responses-create-disconnect.test.ts	✅ Passed	1.042s
tests/responses-create-errors.test.ts	✅ Passed	256ms
tests/responses-create-malformed-api-responses.test.ts	✅ Passed	118ms
tests/responses-create-retries.test.ts	✅ Passed	280ms
tests/responses-create-stream-failures.test.ts	✅ Passed	132ms
tests/responses-create-stream-timeout.test.ts	✅ Passed	207ms
tests/responses-create-stream-wire.test.ts	✅ Passed	2.249s
tests/responses-create-stream.test.ts	✅ Passed	75ms
tests/responses-create-terminal-states.test.ts	✅ Passed	265ms
tests/responses-create-timeout.test.ts	✅ Passed	212ms
tests/responses-create.test.ts	✅ Passed	233ms
tests/responses-delete.test.ts	✅ Passed	249ms
tests/responses-input-items-errors.test.ts	✅ Passed	181ms
tests/responses-input-items-list.test.ts	✅ Passed	184ms
tests/responses-input-items-options.test.ts	✅ Passed	247ms
tests/responses-input-tokens-count-timeout.test.ts	✅ Passed	280ms
tests/responses-input-tokens-count.test.ts	✅ Passed	233ms
tests/responses-malformed-inputs.test.ts	✅ Passed	1.916s
tests/responses-not-found-errors.test.ts	✅ Passed	293ms
tests/responses-parse.test.ts	✅ Passed	178ms
tests/responses-retrieve-retries.test.ts	✅ Passed	243ms
tests/responses-retrieve.test.ts	✅ Passed	215ms
tests/responses-stored-method-errors.test.ts	✅ Passed	646ms
tests/retry-behavior.test.ts	✅ Passed	3.176s
tests/sdk-error-shape.test.ts	✅ Passed	329ms

View OkTest run #32896806638

_{SDK merge (16a87e677466) · head (84ad4413c8ca) · base (2fea73b26b15) · OkTest (2b1bdfd25e98)}

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: e1c76f3832

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

[chatgpt-codex-connector]

Preserve the newly added Realtime voice documentation

This release still packages examples/realtime/websocket_voice_turn.rb, documents it in realtime.md, and announces it in the 0.81.0 changelog, but these lines revert the immediately preceding voice-example commit and tell README users that only text and transcription examples exist. Keep the voice example in this list (and the corresponding capability sentence above) so the release documentation accurately exposes the feature being shipped.

Useful? React with 👍 / 👎.

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: ee118fb360

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

[chatgpt-codex-connector]

Include examples-prefixed fixes in the release notes

Add the five examples: commits shipped since 0.80.0 to this release section: 3f7f15d, 17d43f3, 86eb8e2, 9775e7b, and 1e7b3da are all absent, including user-visible fixes for binary image output and invalid structured/streaming responses. These commits use the repository-required prefix, but release-please-config.json has no examples changelog mapping, so publishing this generated changelog hides the fixes and will repeat the omission in future releases unless that type is mapped.

AGENTS.md reference: AGENTS.md:L5-L8

Useful? React with 👍 / 👎.

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 08be53f2c0

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

[chatgpt-codex-connector]

Document the CGI runtime dependency removal

For users upgrading from 0.80.0, these notes report the analogous base64 dependency removal but omit commit eb43275, which also removes cgi from the published gem's runtime dependencies and replaces its query-decoding implementation. Because that commit's title lacks a recognized Conventional Commit prefix, Release Please skipped it; add it manually to the 0.81.0 notes so the shipped dependency and behavior change is discoverable.

Useful? React with 👍 / 👎.