Skip to content

feat(api): hide Managed Agents session budget controls and events - #4289

Merged
markstuart-oai merged 1 commit into
mainfrom
castiron/promotions/pr-437
Nov 18, 2026
Merged

markstuart-oai merged 1 commit into
mainfrom
castiron/promotions/pr-437

Conversation

@markstuart-oai

@markstuart-oai markstuart-oai commented Nov 18, 2026 •

Copy link
Copy Markdown
Contributor

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

  • Session requests and responses no longer declare spend_control.
  • The public event and status types no longer declare agent.session.budget_reached or budget_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.

Castiron-Internal-PR: openai/openai-python-internal#437
Castiron-Source-SHA: 085ea987f0fd30f7f2a3ab85fe0b0940a25a9a65
Castiron-Public-Base-SHA: f56a67f
@markstuart-oai
markstuart-oai requested a review from a team as a code owner November 18, 2026 04:55
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Nov 18, 2026 •

Copy link
Copy Markdown
Codex Review Summary: ✅ Completed

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-11-18T04:56:24.186437Z c57ecbf PR opened
🔒 Security Review ✅ Completed 2026-11-18T04:56:53.695336Z c57ecbf PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to 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" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@markstuart-oai markstuart-oai changed the title fix(api): hide Managed Agents session budget controls and events feat(api): hide Managed Agents session budget controls and events Nov 18, 2026

Copy link
Copy Markdown
Contributor Author

SDK-owner review needed on compatibility: detect-breaking-changes has been reporting the removed AgentSessionBudgetReachedEvent, SpendControl types, and spend_control attributes. These are the exact alpha members this PR withdraws. The current SDK has been passing 278 focused tests, but that does not make removal of those imports backward-compatible.

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 jbeckwith-oai left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.

@markstuart-oai

Copy link
Copy Markdown
Contributor Author

We're accepting these breaking changes for Agents API (in alpha)

@markstuart-oai
markstuart-oai merged commit b78d3eb into main Nov 18, 2026
25 of 26 checks passed
@markstuart-oai
markstuart-oai deleted the castiron/promotions/pr-437 branch November 18, 2026 05:04
@openai-sdks openai-sdks Bot mentioned this pull request Nov 18, 2026
gh-actions-shared Bot pushed a commit to xf-qubit/openai-python that referenced this pull request Nov 18, 2026
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>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants