[Release] openai/openai-agents-python v0.19.0: v0.19.0

OpenAI Agents Python SDK v0.19.0 introduces Programmatic Tool Calling, allowing supported models to generate JavaScript for coordinating tools with per-tool caller restrictions and structured outputs. The release adds a public decorators module with a shorter @tool alias, standardizes SDK configuration to accept both typed objects and dictionaries, hardens sensitive logging across all components, and improves compatibility with AnyLLM, LiteLLM, and Chat Completions while preserving session history on retries.

Key Points

• •Programmatic Tool Calling: New ProgrammaticToolCallingTool enables models to generate JavaScript for tool coordination with per-tool allowed_callers, structured outputs, and full integration with Runner streaming, guardrails, approvals, and sessions
• •Public Decorators Module: Added agents.decorators module with shorter @tool alias alongside existing function and guardrail decorators; function tools now support async callable objects
• •Unified SDK Configuration: SDK now consistently accepts typed settings objects or dictionaries across agents, runs, models, sessions, sandboxes, and voice pipelines with validation
• •Hardened Security Logging: Improved error and diagnostic logging across models, tools, MCP, Realtime, sessions, sandboxes, and tracing to prevent exposure of sensitive payloads while preserving debugging context
• •Enhanced Compatibility: Improved AnyLLM, LiteLLM, and Chat Completions provider compatibility with better error handling and support for edge cases
• •Session History Preservation: Session history is now preserved across model retries and WebSocket overload errors that occur before response starts
• •Vercel Cloud Mount Strategy: Added VercelCloudBucketMountStrategy for mounted sessions that exclude bucket contents from workspace persistence
• •Nested Handoff Improvements: Fixed history ownership partitioning and programmatic transcript summarization during nested handoffs
• •Tool Schema Enhancements: Improved docstring parsing for *args/**kwargs, support for async callable objects, and better handling of structured tool outputs
• •Stability Fixes: Multiple fixes for edge cases including device node parsing, SELinux markers, Modal tar excludes, MCP cleanup, and audio encoding

Workflow Diagram

Concepts