What's Changed

• docs: Fix #1625 code snippet error by @aiwithwhitehat in #1626
• Update all translated document pages by @github-actions[bot] in #1627
• fixed_typo: wiht -> with by @MuhammedSuhaib in #1624
• Update all translated document pages by @github-actions[bot] in #1628
• fix(run): fire on_llm_start / on_llm_end in Runner.run() for streaming & non-streaming (aligns with docs) by @erikanstine in #1619
• Fix #1629 Empty tool call arguments in streaming events by @habema in #1636
• Docs: Fix confusing session usage docs by @habema in #1637
• Update all translated document pages by @github-actions[bot] in #1643
• fix: #1594 support Azure OpenAI Realtime connection using headers by @seratch in #1633
• fix: Fix #1640 openai package breaking changes by @seratch in #1641
• Fix an error with make mypy on local machine by @seratch in #1642
• Improve translation prompt guidance by @seratch in #1647
• Update all translated document pages by @github-actions[bot] in #1648
• Document OpenAI Conversations session option by @seratch in #1649
• docs: Add more clarity on multi-agent design patterns by @seratch in #1650
• Update all translated document pages by @github-actions[bot] in #1654
• v0.2.11 by @rm-openai in #1655

New Contributors

• @aiwithwhitehat made their first contribution in #1626
• @MuhammedSuhaib made their first contribution in #1624
• @erikanstine made their first contribution in #1619

Full Changelog: v0.2.10...v0.2.11

What's Changed

• Performance: only create the OpenAIRealtimeServerEvent TypeAdapter once by @michieldwitte in #1548
• Realtime: fix typecheck error by @rm-openai in #1558
• Docs: Add SQLAlchemy-powered sessions by @habema in #1549
• Update all translated document pages by @github-actions[bot] in #1561
• Add tests for Agent default model settings when using GPT-5 by @seratch in #1562
• Re: #1534 Update models document page to cover gpt-5 use cases by @seratch in #1535
• Update all translated document pages by @github-actions[bot] in #1563
• Docs: Improvements for SQLAlchemy Sessions by @habema in #1576
• Update all translated document pages by @github-actions[bot] in #1577
• Fix: Emit tool_called events immediately in streaming runs by @habema in #1300
• Feature: Make trace_include_sensitive_data configurable via environment variable by @Kunmeer-SyedMohamedHyder in #1192
• Docs: Improve example for custom Session class implementation. by @luke-wriglesworth in #1582
• Update all translated document pages by @github-actions[bot] in #1589
• Remove CI job we no longer actively use by @seratch in #1590
• Upgrade underlying oepnai package to the latest version by @seratch in #1599
• Fix #1585 supporting connectors by @seratch in #1600
• Fix #1592 Web search tool updates by @seratch in #1601
• Handle LiteLLM's json_tool_call addition for structured outputs by @seratch in #1602
• Add reasoning text delta event support for gpt-oss models by @seratch in #1586
• Fix #1564 Add conversations API support by @seratch in #1587
• fix: copy extra_kwargs to prevent litellm from polluting metadata by @zhowzeng in #1610
• v0.2.10 by @rm-openai in #1607

New Contributors

• @michieldwitte made their first contribution in #1548
• @luke-wriglesworth made their first contribution in #1582
• @zhowzeng made their first contribution in #1610

Full Changelog: v0.2.9...v0.2.10

What's Changed

• Fix #1494 by adding a link to Responses API documentation by @seratch in #1502
• Add conditional tool enabling feature to agent as tool. by @thoo in #1193
• Update all translated document pages by @github-actions[bot] in #1503
• feat(agents): Add on_llm_start and on_llm_end Lifecycle Hooks by @uzair330 in #987
• clarify docs for tool_use_behavior and simplify description of stop_on_first_tool behavior by @Abishai-kashif in #1510
• Fix: filename not provided in chatcmpl_converter.py by @Nifury in #1513
• Add local_file example to align with TS SDK repo by @seratch in #1514
• Imrpove "Getting Started" on README by @seratch in #1516
• Add documentation for token usage tracking by @habema in #1518
• Update all translated document pages by @github-actions[bot] in #1524
• Add context parameter to run_demo_loop by @SeeYangZhi in #1527
• docs(visualization): clarify MCP server support and update screenshot by @Subhi-Sadiyev in #1529
• Update all translated document pages by @github-actions[bot] in #1532
• Update tracing.md with Agenta by @mmabrouk in #1541
• Update all translated document pages by @github-actions[bot] in #1543
• docs: Add external documentation link to LocalShellTool docstring by @MuhammadHamidRaza in #1547
• Add SQLAlchemy session backend for conversation history management by @habema in #1357
• feat: add retry logic to MCP server operations by @rm-openai in #1554
• Realtime: input timeout trigger event by @rm-openai in #1552
• Add a quick opt-in option to switch to gpt-5 model by @seratch in #1534
• v0.2.9 by @rm-openai in #1555

New Contributors

• @uzair330 made their first contribution in #987
• @Abishai-kashif made their first contribution in #1510
• @Nifury made their first contribution in #1513
• @SeeYangZhi made their first contribution in #1527
• @Subhi-Sadiyev made their first contribution in #1529
• @mmabrouk made their first contribution in #1541

Full Changelog: 0.2.8...v0.2.9

What's Changed

• Fix: Clarify random_number function docstring for inclusive range by @Abbas-Asad in #1475
• Add input validation and type conversion for user input by @Abbas-Asad in #1476
• Docs: Add missing docstring to get_weather function by @Abbas-Asad in #1478
• Docs: Clarify that guardrails apply to both user input and agent output by @Abbas-Asad in #1482
• Docs: Add missing docstring to how_many_jokes tool by @Abbas-Asad in #1479
• Update all translated document pages by @github-actions[bot] in #1484
• Allow modifying the input sent to the model by @rm-openai in #1483
• Make shallow copies of lists instead of deep copies by @rm-openai in #1490
• Realtime: fix history bug by @rm-openai in #1495
• Realtime: allow arbitrarily sized messages by @rm-openai in #1500
• 0.2.8 by @rm-openai in #1501

Full Changelog: v0.2.7...0.2.8

What's Changed

• Added runtime validation for Agent constructor arguments by @DanielHashmi in #998
• Realtime: add handoff prompt prefix by @rm-openai in #1382
• feat(tests): add tests for unicode content, special characters, and concurrent access in SQLiteSession by @PatrykBochenek in #1399
• Fix: enforce strict instructions function signature in get_system_prompt by @abdullahimran49 in #1426
• Fix #1407 Add reasoning.effort="minimal" and "verbosity" params to ModelSettings by @seratch in #1439
• Add a simple gpt-oss example by @seratch in #1440
• Fix: Clarify random_number function docstring for inclusive range by @Abbas-Asad in #1461
• Add input validation and type conversion for user input by @Abbas-Asad in #1462
• docs: Add a comprehensive example for handling function tool errors. by @MurtazaAliCode in #1354
• Update all translated document pages by @github-actions[bot] in #1469
• Migrate document translation script to gpt-5 by @seratch in #1470
• Update all translated document pages by @github-actions[bot] in #1471
• docs: Clarify the is_enabled parameter in handoff() documentation by @Hafiz-Muhammad-Umar12 in #1472
• Update all translated document pages by @github-actions[bot] in #1473
• Realtime: one guardrail trip event per response by @rm-openai in #1458
• v0.2.7 by @rm-openai in #1480

New Contributors

• @PatrykBochenek made their first contribution in #1399
• @abdullahimran49 made their first contribution in #1426
• @MurtazaAliCode made their first contribution in #1354
• @Hafiz-Muhammad-Umar12 made their first contribution in #1472

Full Changelog: v0.2.6...v0.2.7

What's Changed

• feat: support agent output guardrails in realtime by @jhills20 in #1381
• Enhanced FAQ lookup tool in examples/customer_service app by @HasnainCodeHub in #1063
• Improve accuracy of guardrails and lifecycle hook descriptions by @DanielHashmi in #1386
• Update all translated document pages by @github-actions[bot] in #1413
• Add logprobs to ModelSettings by @zain in #971
• Add streaming function call arguments example by @devtalker in #1052
• Updated the default values for two parameters in the ModelSettings class to align with their documented behavior: by @rudra-attri in #1392
• chore(deps): Bump "openai>=1.99.6,<2" by @seratch in #1415
• v0.2.6 by @rm-openai in #1423

New Contributors

• @HasnainCodeHub made their first contribution in #1063
• @zain made their first contribution in #971
• @rudra-attri made their first contribution in #1392

Full Changelog: v0.2.5...v0.2.6

What's Changed

• Fix tag errors in sessions document page by @seratch in #1307
• Update all translated document pages by @github-actions[bot] in #1308
• Add temporal demo to docs by @rm-openai in #1310
• Fix #1238 by enhancing HandoffInputData and enable passing async functions by @seratch in #1302
• Add support to realtime API for setting "speed" of the models responses by @sect2k in #1309
• Update all translated document pages by @github-actions[bot] in #1313
• Examples: use agent to interact with Remote PDF Documents by @princeaden1 in #1319
• Enhance exception guide in docs by @MuhammadHamidRaza in #1321
• Update all translated document pages by @github-actions[bot] in #1322
• Realtime: make example customizable: by @rm-openai in #1332
• Export MultiProvider in public API (Fix #1325) by @kobol in #1326
• Add tracing guide for non-OpenAI LLMs in docs/tracing.md by @UmmeHabiba1312 in #1329
• Update all translated document pages by @github-actions[bot] in #1336
• docs: Clarify and enhance run_demo_loop utility documentation for beginners by @UmmeHabiba1312 in #1330
• Fix set_api_key breaking cached property mechanism by @DanielHashmi in #1339
• Update all translated document pages by @github-actions[bot] in #1341
• Handle processor exceptions and fix tracing log formatting by @mshsheikh in #1292
• Fix(mcp): Unreachable structured content branch in invoke_mcp_tool by @Kunmeer-SyedMohamedHyder in #1250
• Feat: separate tool_call_item and tool_call_output_item in stream events by @gdisk in #974
• Clarify shallow-copy behavior of tools and handoffs in Agent.clone() by @abdul-kabir-jawed in #1296
• Fix #1277 missing StopAtTools and ToolsToFinalOutputFunction in agents module by @seratch in #1278
• Fix #980 Chat Completions: fails with function name for tool_choice parameter w/ streaming enabled by @seratch in #1206
• Fix type annotation and clarify tool behavior docs by @mshsheikh in #1355
• Fix style and wording issues in handoffs.py by @mshsheikh in #1356
• Fix docstring formatting and add safe check for empty message content by @mshsheikh in #1360
• Add functionality to update agent during realtime session by @marysha-openai in #1366
• feat(viz): draw MCP servers by @aaron-ang in #1368
• Update all translated document pages by @github-actions[bot] in #1369
• Realtime: fix interrupt logic by @rm-openai in #1370
• Realtime: send session update before tool response by @rm-openai in #1388
• v0.2.5 by @rm-openai in #1398

New Contributors

• @sect2k made their first contribution in #1309
• @princeaden1 made their first contribution in #1319
• @UmmeHabiba1312 made their first contribution in #1329
• @Kunmeer-SyedMohamedHyder made their first contribution in #1250
• @gdisk made their first contribution in #974
• @abdul-kabir-jawed made their first contribution in #1296
• @marysha-openai made their first contribution in #1366
• @aaron-ang made their first contribution in #1368

Full Changelog: v0.2.4...v0.2.5

What's Changed

• Add automation script to generate mkdocstrings files by @seratch in #1048
• Set up codex for issues and PRs by @rm-openai in #1214
• Use real codex action by @rm-openai in #1217
• Update codex action to use repo syntax by @rm-openai in #1218
• Fixes two issues in the tracing documentation by @DanielHashmi in #1212
• Update all translated document pages by @github-actions[bot] in #1221
• Fix RealtimeModel reference by @rm-openai in #1215
• Adding docstring to get_weather tool by @mutahirshah11 in #1231
• Update all translated document pages by @github-actions[bot] in #1232
• Add LiteLLM to acknowledgements section by @colesmcintosh in #1240
• [Bugfix] Fix wrong imports in examples by @mdagost in #1241
• Realtime: send audio item/content index by @rm-openai in #1235
• Fix #1227 Chat Completions model fails to handle streaming with openai 1.97.1+ by @seratch in #1246
• Make Trace class inherit from abc.ABC for proper abstract base class behavior by @DanielHashmi in #1233
• docs: add LangDB AI Gateway as a tracing provider by @MrunmayS in #1224
• Update all translated document pages by @github-actions[bot] in #1251
• Fix type placeholder convention by @mshsheikh in #1259
• Tweak on guardrail docstrings by @mshsheikh in #1260
• Consistently use "Python" in docstrings by @mshsheikh in #1261
• gpt 4.5-preview is removed, use gpt-4.1 by @jssmith in #1266
• refactor: remove inherited method from Agent class by @windsornguyen in #1267
• Fix etc. punctuation by @mshsheikh in #1268
• fix: enforce min trigger size=1 to prevent immediate exports by @mshsheikh in #1270
• Fix documentation typo and trailing comma in exporters by @mshsheikh in #1272
• docs: remove non existent even_if_trace_running mention from trace docstring by @mshsheikh in #1273
• fix: convert litellm response with reasoning content to openai message by @zkllll2002 in #1098
• docs: fix UserContext example by @kankute-sameer in #1280
• Fix _export_batches docstring to remove incorrect "threshold" reference by @DanielHashmi in #1287
• Update all translated document pages by @github-actions[bot] in #1289
• examples: minor tweak on llm_as_a_judge example by @mshsheikh in #1284
• Enhance Tool Behavior Documentation for Developer Clarity With Examples by @MuhammadHamidRaza in #1286
• Update all translated document pages by @github-actions[bot] in #1291
• Realtime: enable a playback tracker by @rm-openai in #1242
• Realtime: only cancel response if necessary by @rm-openai in #1243
• Realtime: Twilio example by @rm-openai in #1216
• Realtime: forward all raw model events by @rm-openai in #1252
• v0.2.4 by @rm-openai in #1301

New Contributors

• @mutahirshah11 made their first contribution in #1231
• @colesmcintosh made their first contribution in #1240
• @mdagost made their first contribution in #1241
• @MrunmayS made their first contribution in #1224
• @jssmith made their first contribution in #1266
• @windsornguyen made their first contribution in #1267
• @zkllll2002 made their first contribution in #1098
• @kankute-sameer made their first contribution in #1280
• @MuhammadHamidRaza made their first contribution in #1286

Full Changelog: v0.2.3...v0.2.4

What's Changed

• [realtime] Add direct access to model layer from session by @rm-openai in #1172
• Update all translated document pages by @github-actions[bot] in #1173
• Fix spelling, grammar, and minor formatting issues in running agents documentation by @mshsheikh in #1128
• fix: ensure ResponseUsage token fields are int, not None (fixes #1179) by @kobol in #1181
• Add missing guardrail exception import to quickstart by @slubbers-openai in #1161
• fix: fallback to function name for unnamed output_guardrail decorators by @romankhan26 in #1133
• Mark some dataclasses as pydantic dataclasses by @tconley1428 in #1131
• fix: Apply strict JSON schema validation in FunctionTool constructor by @habema in #1041
• Fix image_generator example error on Windows OS by @seratch in #1180
• Update all translated document pages by @github-actions[bot] in #1184
• Realtime: add user agent header by @rm-openai in #1185
• Realtime: make sure we use the initial model settings by @rm-openai in #1198
• v0.2.3 by @rm-openai in #1201

New Contributors

• @github-actions[bot] made their first contribution in #1173
• @kobol made their first contribution in #1181
• @slubbers-openai made their first contribution in #1161
• @romankhan26 made their first contribution in #1133
• @habema made their first contribution in #1041

Full Changelog: v0.2.2...v0.2.3

What's Changed

• Add a new GH Actions job to automatically update translated document pagse by @seratch in #598
• Adjust #598 to only create a PR rather than pushing changes to main branch by @seratch in #1162
• Realtime: only update model settings from session by @rm-openai in #1169
• v0.2.2 by @rm-openai in #1170

Full Changelog: v0.2.1...v0.2.2