updates

seratch · seratch · commit f4b400c01c95 · 2026-02-04T17:05:35.000+09:00
diff --git a/docs/examples.md b/docs/examples.md
@@ -77,13 +77,14 @@ Check out a variety of sample implementations of the SDK in the examples section
     Simple deep research clone that demonstrates complex multi-agent research workflows.
 
 -   **[tools](https://github.com/openai/openai-agents-python/tree/main/examples/tools):**
-    Learn how to implement OAI hosted tools such as:
+    Learn how to implement OAI hosted tools and experimental Codex tooling such as:
 
     -   Web search and web search with filters
     -   File search
     -   Code interpreter
     -   Computer use
     -   Image generation
+    -   Experimental Codex tool workflows (`examples/tools/codex.py`)
 
 -   **[voice](https://github.com/openai/openai-agents-python/tree/main/examples/voice):**
     See examples of voice agents, using our TTS and STT models, including streamed voice examples.
diff --git a/docs/ref/agent_tool_input.md b/docs/ref/agent_tool_input.md
@@ -0,0 +1,3 @@
+# `Agent Tool Input`
+
+::: agents.agent_tool_input
diff --git a/docs/ref/agent_tool_state.md b/docs/ref/agent_tool_state.md
@@ -0,0 +1,3 @@
+# `Agent Tool State`
+
+::: agents.agent_tool_state
diff --git a/docs/ref/memory/session_settings.md b/docs/ref/memory/session_settings.md
@@ -0,0 +1,3 @@
+# `Session Settings`
+
+::: agents.memory.session_settings
diff --git a/docs/ref/run_config.md b/docs/ref/run_config.md
@@ -0,0 +1,3 @@
+# `Run Config`
+
+::: agents.run_config
diff --git a/docs/ref/run_error_handlers.md b/docs/ref/run_error_handlers.md
@@ -0,0 +1,3 @@
+# `Run Error Handlers`
+
+::: agents.run_error_handlers
diff --git a/docs/ref/run_internal/agent_runner_helpers.md b/docs/ref/run_internal/agent_runner_helpers.md
@@ -0,0 +1,3 @@
+# `Agent Runner Helpers`
+
+::: agents.run_internal.agent_runner_helpers
diff --git a/docs/ref/run_internal/approvals.md b/docs/ref/run_internal/approvals.md
@@ -0,0 +1,3 @@
+# `Approvals`
+
+::: agents.run_internal.approvals
diff --git a/docs/ref/run_internal/error_handlers.md b/docs/ref/run_internal/error_handlers.md
@@ -0,0 +1,3 @@
+# `Error Handlers`
+
+::: agents.run_internal.error_handlers
diff --git a/docs/ref/run_internal/guardrails.md b/docs/ref/run_internal/guardrails.md
@@ -0,0 +1,3 @@
+# `Guardrails`
+
+::: agents.run_internal.guardrails
diff --git a/docs/ref/run_internal/items.md b/docs/ref/run_internal/items.md
@@ -0,0 +1,3 @@
+# `Items`
+
+::: agents.run_internal.items
diff --git a/docs/ref/run_internal/oai_conversation.md b/docs/ref/run_internal/oai_conversation.md
@@ -0,0 +1,3 @@
+# `Oai Conversation`
+
+::: agents.run_internal.oai_conversation
diff --git a/docs/ref/run_internal/run_loop.md b/docs/ref/run_internal/run_loop.md
@@ -0,0 +1,3 @@
+# `Run Loop`
+
+::: agents.run_internal.run_loop
diff --git a/docs/ref/run_internal/run_steps.md b/docs/ref/run_internal/run_steps.md
@@ -0,0 +1,3 @@
+# `Run Steps`
+
+::: agents.run_internal.run_steps
diff --git a/docs/ref/run_internal/session_persistence.md b/docs/ref/run_internal/session_persistence.md
@@ -0,0 +1,3 @@
+# `Session Persistence`
+
+::: agents.run_internal.session_persistence
diff --git a/docs/ref/run_internal/streaming.md b/docs/ref/run_internal/streaming.md
@@ -0,0 +1,3 @@
+# `Streaming`
+
+::: agents.run_internal.streaming
diff --git a/docs/ref/run_internal/tool_actions.md b/docs/ref/run_internal/tool_actions.md
@@ -0,0 +1,3 @@
+# `Tool Actions`
+
+::: agents.run_internal.tool_actions
diff --git a/docs/ref/run_internal/tool_execution.md b/docs/ref/run_internal/tool_execution.md
@@ -0,0 +1,3 @@
+# `Tool Execution`
+
+::: agents.run_internal.tool_execution
diff --git a/docs/ref/run_internal/tool_planning.md b/docs/ref/run_internal/tool_planning.md
@@ -0,0 +1,3 @@
+# `Tool Planning`
+
+::: agents.run_internal.tool_planning
diff --git a/docs/ref/run_internal/tool_use_tracker.md b/docs/ref/run_internal/tool_use_tracker.md
@@ -0,0 +1,3 @@
+# `Tool Use Tracker`
+
+::: agents.run_internal.tool_use_tracker
diff --git a/docs/ref/run_internal/turn_preparation.md b/docs/ref/run_internal/turn_preparation.md
@@ -0,0 +1,3 @@
+# `Turn Preparation`
+
+::: agents.run_internal.turn_preparation
diff --git a/docs/ref/run_internal/turn_resolution.md b/docs/ref/run_internal/turn_resolution.md
@@ -0,0 +1,3 @@
+# `Turn Resolution`
+
+::: agents.run_internal.turn_resolution
diff --git a/docs/ref/run_state.md b/docs/ref/run_state.md
@@ -0,0 +1,3 @@
+# `Run State`
+
+::: agents.run_state
diff --git a/docs/ref/tracing/context.md b/docs/ref/tracing/context.md
@@ -0,0 +1,3 @@
+# `Context`
+
+::: agents.tracing.context
diff --git a/docs/ref/tracing/model_tracing.md b/docs/ref/tracing/model_tracing.md
@@ -0,0 +1,3 @@
+# `Model Tracing`
+
+::: agents.tracing.model_tracing
diff --git a/docs/tools.md b/docs/tools.md
@@ -506,7 +506,7 @@ during a tool call. This surface is experimental and may change.
 
 ```python
 from agents import Agent
-from agents.extensions.experimental.codex import ThreadOptions, codex_tool
+from agents.extensions.experimental.codex import ThreadOptions, TurnOptions, codex_tool
 
 agent = Agent(
     name="Codex Agent",
@@ -517,8 +517,13 @@ agent = Agent(
             working_directory="/path/to/repo",
             default_thread_options=ThreadOptions(
                 model="gpt-5.2-codex",
+                model_reasoning_effort="low",
                 network_access_enabled=True,
-                web_search_enabled=False,
+                web_search_mode="disabled",
+                approval_policy="never",
+            ),
+            default_turn_options=TurnOptions(
+                idle_timeout_seconds=60,
             ),
             persist_session=True,
         )
@@ -529,9 +534,13 @@ agent = Agent(
 What to know:
 
 -   Auth: set `CODEX_API_KEY` (preferred) or `OPENAI_API_KEY`, or pass `codex_options={"api_key": "..."}`.
--   Runtime: `codex_options.base_url` overrides the CLI base URL, and `codex_options.codex_path_override` (or `CODEX_PATH`) selects the binary.
+-   Runtime: `codex_options.base_url` overrides the CLI base URL.
+-   Binary resolution: set `codex_options.codex_path_override` (or `CODEX_PATH`) to pin the CLI path. Otherwise the SDK resolves `codex` from `PATH`, then falls back to the bundled vendor binary.
 -   Environment: `codex_options.env` fully controls the subprocess environment. When it is provided, the subprocess does not inherit `os.environ`.
+-   Stream limits: `codex_options.codex_subprocess_stream_limit_bytes` (or `OPENAI_AGENTS_CODEX_SUBPROCESS_STREAM_LIMIT_BYTES`) controls stdout/stderr reader limits. Valid range is `65536` to `67108864`; default is `8388608`.
 -   Inputs: tool calls must include at least one item in `inputs` with `{ "type": "text", "text": ... }` or `{ "type": "local_image", "path": ... }`.
+-   Thread defaults: configure `default_thread_options` for `model_reasoning_effort`, `web_search_mode` (preferred over legacy `web_search_enabled`), `approval_policy`, and `additional_directories`.
+-   Turn defaults: configure `default_turn_options` for `idle_timeout_seconds` and cancellation `signal`.
 -   Safety: pair `sandbox_mode` with `working_directory`; set `skip_git_repo_check=True` outside Git repos.
 -   Behavior: `persist_session=True` reuses a single Codex thread and returns its `thread_id`.
 -   Streaming: `on_stream` receives Codex events (reasoning, command execution, MCP tool calls, file changes, web search).

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	+# `Agent Tool Input`
	`2`	`+`
	`3`	`+::: agents.agent_tool_input`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	+# `Agent Tool State`
	`2`	`+`
	`3`	`+::: agents.agent_tool_state`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	+# `Session Settings`
	`2`	`+`
	`3`	`+::: agents.memory.session_settings`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	+# `Run Config`
	`2`	`+`
	`3`	`+::: agents.run_config`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	+# `Run Error Handlers`
	`2`	`+`
	`3`	`+::: agents.run_error_handlers`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	+# `Agent Runner Helpers`
	`2`	`+`
	`3`	`+::: agents.run_internal.agent_runner_helpers`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	+# `Approvals`
	`2`	`+`
	`3`	`+::: agents.run_internal.approvals`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	+# `Error Handlers`
	`2`	`+`
	`3`	`+::: agents.run_internal.error_handlers`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	+# `Guardrails`
	`2`	`+`
	`3`	`+::: agents.run_internal.guardrails`