fix: freeze public testing API state contracts - #4404
Merged
Conversation
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 9122aad9c7
ℹ️ 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".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
seratch
force-pushed
the
fix/testing-api-state-contract
branch
from
August 14, 2026 01:17
9122aad to
ec15614
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This pull request fixes a gap in the prospective v0.21.0 released API contract for the new scripted testing utilities. The contract already covered their modules, exports, and callable signatures, but it did not protect their intended public state surfaces. As a result, supported properties or
TypedDictfields could be removed or changed without failing the release-contract check.The existing release-contract policy and generator now:
ModelStepSpec,SandboxStepSpec, andRealtimeConnectCall.baseline_commitprovenance when only a selectedTypedDictsurface changes.The policy remains deliberately scoped: it does not freeze arbitrary class attributes, private implementation classes, callback internals, or every
TypedDictin the repository. This change does not alter runtime behavior, canonical import paths, or existing testing API signatures.