Release process/changelog
The project follows a slightly modified version of semantic versioning using the form0.Y.Z. The leading0 indicates the SDK is still evolving rapidly. Increment the components as follows:
Minor (Y) versions
We will increase minor versionsY forbreaking changes to any public interfaces that are not marked as beta. For example, going from0.0.x to0.1.x might include breaking changes.
If you don't want breaking changes, we recommend pinning to0.0.x versions in your project.
Patch (Z) versions
We will incrementZ for non-breaking changes:
- Bug fixes
- New features
- Changes to private interfaces
- Updates to beta features
Breaking change changelog
0.6.0
In this version, the default handoff history is now packaged into a single assistant message instead of exposing the raw user/assistant turns, giving downstream agents a concise, predictable recap- The existing single-message handoff transcript now by default starts with "For context, here is the conversation so far between the user and the previous agent:" before the<CONVERSATION HISTORY> block, so downstream agents get a clearly labeled recap
0.5.0
This version doesn’t introduce any visible breaking changes, but it includes new features and a few significant updates under the hood:
- Added support for
RealtimeRunnerto handleSIP protocol connections - Significantly revised the internal logic of
Runner#run_syncfor Python 3.14 compatibility
0.4.0
In this version,openai package v1.x versions are no longer supported. Please use openai v2.x along with this SDK.
0.3.0
In this version, the Realtime API support migrates to gpt-realtime model and its API interface (GA version).
0.2.0
In this version, a few places that used to takeAgent as an arg, now takeAgentBase as an arg instead. For example, thelist_tools() call in MCP servers. This is a purely typing change, you will still receiveAgent objects. To update, just fix type errors by replacingAgent withAgentBase.
0.1.0
In this version,MCPServer.list_tools() has two new params:run_context andagent. You'll need to add these params to any classes that subclassMCPServer.