Repository navigation
feat(api): hide Managed Agents session budget controls and events - #4289
Conversation
Castiron-Internal-PR: openai/openai-python-internal#437 Castiron-Source-SHA: 085ea987f0fd30f7f2a3ab85fe0b0940a25a9a65 Castiron-Public-Base-SHA: f56a67f
Codex Review Summary: ✅ CompletedThis comment shows the latest Codex review activity on this pull request.
ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings. |
|
SDK-owner review needed on compatibility: Is there an approved process for recording this specific alpha exception, or should this PR wait? I have not been modifying the detector or skipping its failures. |
jbeckwith-oai
left a comment
There was a problem hiding this comment.
No actionable code findings at this commit. Reviewed the intentional removal of the alpha spending controls, budget event/status types, and turn-error member across generated models, request surfaces, schema, and exports. Default union decoding preserves opaque budget frames and dict-valued session snapshots. Sync/async helpers and collectors require nonempty matching session IDs and correct turn boundaries. Strict response validation rejects the removed private variants, consistently with the narrowed public union. Reviewed the relevant regression coverage and verified generated hashes and public/internal changed-file parity.
Hosted CI at publication: 1 failure, 16 success, 9 skipped. The compatibility detector reports the intentionally removed budget event module, SpendControl types, and spend_control attributes: https://github.com/openai/openai-python/actions/runs/44240644271/job/134587416915. Code approval does not resolve the requested SDK-owner decision on recording an alpha compatibility exception or authorize bypassing that gate; that process question remains open. Static review with independent review; no candidate code or local tests executed.
|
We're accepting these breaking changes for Agents API (in alpha) |
Automated Release PR --- ## [3.55.0](openai/openai-python@v3.54.0...v3.55.0) (2026-11-18) ### Features * **api:** add Live MCP server configuration ([openai#4280](openai#4280)) ([f56a67f](openai@f56a67f)) * **api:** hide Managed Agents session budget controls and events ([openai#4289](openai#4289)) ([b78d3eb](openai@b78d3eb)) --- This PR was generated with [Release Please](https://github.com/googleapis/release-please). See [documentation](https://github.com/googleapis/release-please#release-please). Co-authored-by: openai-sdks[bot] <284451331+openai-sdks[bot]@users.noreply.github.com>
Summary
The SDK has been exposing Managed Agents session budget controls as public types. This update removes the alpha budget API from those types.
This is an alpha breaking change for a minor release. If your application depends on these members, stay on the previous SDK until you can remove those references. There is no replacement typed budget API in this release.
Changes
spend_control.agent.session.budget_reachedorbudget_reached. Code that names these members needs to change before upgrading.This also includes the turn-error code removal from #4288. This PR supersedes that narrower change; the old PR does not need to land first.
Verification
The 278 focused SDK tests have been passing (6 skipped), along with Ruff and formatting. The tests cover preserving a generic error, ignoring unrelated unknown frames, and ending a helper's wait when a matching opaque budget frame arrives.