v0.2.0

Please note that this version includes a small breaking change (breaks Agent into AgentBase + Agent), hence the minor version bump. See https://openai.github.io/openai-agents-python/release/ for the breaking change changelog.

Key changes include:

1. Support for Sessions, a way to manage conversation sessions.
2. Beta support for Realtime agents (likely buggy, and we are evolving/fixing it as we speak)

What's Changed

• docs: mention 'name' is required in Agent constructor . fix: mention 'name' as required in Agent init doc by @maneeshanif in #1033
• Fix agent lifecycle example output to reflect correct hook execution order by @DanielHashmi in #1015
• Support mcp prompts by @thoo in #1010
• Add on_start support to VoiceWorkflowBase and VoicePipeline by @vrtnis in #922
• Add Makefile check rule to run all the linters and checkers by @ant31 in #1038
• Support for file_input content (#fix 893) by @ant31 in #1009
• description_override is not properly used for function_schema.description by @HafizFasih in #1000
• avoid concat tool call delta id by @DeoLeung in #990
• Fix #976 MCP filtering, make agent and run ctx optional by @njbrake in #977
• Add Sessions for Automatic Conversation History Management by @knowsuchagency in #752
• Updated llm_as_a_judge.py by @zaidrj in #1055
• [1/n] Break Agent into AgentBase+Agent by @rm-openai in #1068
• [2/n] Introduce RealtimeAgent by @rm-openai in #1069
• [3/n] Config and items for realtime by @rm-openai in #1070
• [4/n] Transport interface + events by @rm-openai in #1071
• [5/n] OpenAI realtime transport impl by @rm-openai in #1072
• [6/n] RealtimeSession + events by @rm-openai in #1073
• [7/n] Demo for realtime by @rm-openai in #1074
• Fix typo in Evaluator Instructions (capitalization of "After 5 attemp… by @mshsheikh in #1067
• [8/n] Make realtime more like the rest of agents sdk by @rm-openai in #1076
• Tests for realtime runner by @rm-openai in #1079
• Tests for realtime session by @rm-openai in #1080
• Add tests for openai realtime model by @rm-openai in #1081
• Fix #968 by upgrading openai package to the latest by @seratch in #1034
• Realtime guardrail support by @rm-openai in #1082
• Realtime tracing by @rm-openai in #1084
• enhancement: Add tool_name to ToolContext to support shared tool handlers by @vrtnis in #1043
• Fix incorrect comment order when popping session items by @MuhammadHassaanArain in #1086
• Back out "enhancement: Add tool_name to ToolContext to support shared tool handlers (#1043)" by @rm-openai in #1105
• Realtime: run guardrails without blockign event loop by @rm-openai in #1104
• Run make format by @rm-openai in #1106
• Realtime: forward exceptions from transport layer by @rm-openai in #1107
• Realtime: update model to have a single send_event method by @rm-openai in #1111
• Realtime: send session.update event at connection/handoffs by @rm-openai in #1112
• add numpy dev dependency by @jhills20 in #1117
• feat(function_schema): Add support for pydantic Field annotations in tool arguments (for tools decorated with @function_schema) by @georg-wolflein in #1124
• Fix typos and update async for loop variable by @sarmadalikhanofficial in #1122
• Realtime: export everything by @rm-openai in #1118
• Update examples docs with realtime section by @jhills20 in #1113
• Retry: Add tool_name to ToolContext for generic tool handlers by @vrtnis in #1110
• update-input-guardrail-name by @Quratulain-bilal in #1053
• Realtime: fix item parsing by @rm-openai in #1119

New Contributors

• @maneeshanif made their first contribution in #1033
• @thoo made their first contribution in #1010
• @vrtnis made their first contribution in #922
• @ant31 made their first contribution in #1038
• @HafizFasih made their first contribution in #1000
• @DeoLeung made their first contribution in #990
• @knowsuchagency made their first contribution in #752
• @zaidrj made their first contribution in #1055
• @mshsheikh made their first contribution in #1067
• @MuhammadHassaanArain made their first contribution in #1086
• @georg-wolflein made their first contribution in #1124
• @sarmadalikhanofficial made their first contribution in #1122
• @Quratulain-bilal made their first contribution in #1053

Full Changelog: v0.1.0...v0.2.0