openai / openai/openai-agents-python

Planned changes for v1.0 release

Open
#2,921 0 comments 0 reactions 1 assignee View on GitHub

@seratch is already working on this.

Since Apr 17, 2026.

enhancement feature:core
Dominant language
Python
Stars
29.6k
Forks
4.8k
Avg merge
1d 20h
Merged PRs (30d)
123

Description

Clearly set Development Status

diff --git a/pyproject.toml b/pyproject.toml
index 814e4dab..ed4a9276 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -17,6 +17,7 @@ dependencies = [
     "mcp>=1.19.0, <2; python_version >= '3.10'",
 ]
 classifiers = [
+    "Development Status :: 5 - Production/Stable",
     "Typing :: Typed",
     "Intended Audience :: Developers",
     "Programming Language :: Python :: 3",

Update type hints in lifecycle hook arguments

When releasing a major version, we will revisit the type hints in lifecycle hooks for more convenience. See https://github.com/openai/openai-agents-python/pull/2915#issuecomment-4265023306 for more context.

This change requries:

  • SDK code changes
  • Migration guide for existing users (actually no runtime impact; just incompatibility when linting)

Change max_turns default

since 0.16, the max_turns could be None, which means unlimited turns. We'll use this as the default value in v1.

For external contributors, we as core maintainers will handle this. So, please refrain from sending pull requests for this issue.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.