github-featured/openai--openai-agents-python

Files

T

History

Kazuhiro Sera 8221e424db feat(realtime): track response usage in session context (#3812 )

2026-07-13 07:42:49 +09:00

..

refactor(sandbox): share Runloop rclone setup (#3799 )

2026-07-10 22:49:28 +00:00

…

fix: recursively extract HTTP errors from nested ExceptionGroups (#3556 )

2026-06-24 10:43:47 +09:00

fix: #3268 fix OpenAI Conversations reasoning persistence (#3352 )

2026-05-12 07:20:47 +09:00

feat: support GPT-5.6 request controls (#3794 )

2026-07-11 06:48:04 +09:00

fix(litellm): surface content-filter refusals instead of an empty turn (#3769 )

2026-07-11 00:52:45 +00:00

feat(realtime): track response usage in session context (#3812 )

2026-07-13 07:42:49 +09:00

refactor(sandbox): share core PTY output collection (#3796 )

2026-07-10 22:14:27 +00:00

test: improve coverage for stream and sandbox edge cases (#3730 )

2026-07-04 10:51:32 +09:00

fix(util): preserve non-dict Mapping values in _to_dump_compatible (#3700 )

2026-06-29 02:33:41 +00:00

fix(models): raise UserError for conflicting provider args instead of assert (#3809 )

2026-07-12 06:50:12 +00:00

__init__.py

…

_fake_workspace_paths.py

feat: support sandbox extra path grants (#2920 )

2026-04-17 15:26:51 -07:00

conftest.py

test: improve coverage and organize test layout (#3085 )

2026-05-02 15:40:54 +09:00

fake_model.py

fix: support cache-write usage across OpenAI Python versions (#3773 )

2026-07-10 07:14:43 +09:00

README.md

docs: make markdown style consistent across the project

2026-07-04 09:04:30 +09:00

test_agent_as_tool.py

…

test_agent_clone_shallow_copy.py

…

test_agent_config.py

…

test_agent_hooks.py

fix: #3512 type tool-end hook results as object (#3518 )

2026-05-28 17:57:33 +09:00

test_agent_instructions_signature.py

…

test_agent_llm_hooks.py

fix: #3512 type tool-end hook results as object (#3518 )

2026-05-28 17:57:33 +09:00

test_agent_memory_leak.py

…

test_agent_prompt.py

…

test_agent_runner_streamed.py

fix: #3459 add opt-in recovery for missing function tools (#3461 )

2026-05-21 10:46:44 +09:00

test_agent_runner_sync.py

Sandbox Agents (#2889 )

2026-04-15 10:00:40 -07:00

test_agent_runner.py

feat: add pre-approval tool input guardrails (#3487 )

2026-06-18 12:38:15 +09:00

test_agent_tool_input.py

…

test_agent_tool_state.py

…

test_agent_tracing.py

fix: support cache-write usage across OpenAI Python versions (#3773 )

2026-07-10 07:14:43 +09:00

test_agents_logging.py

…

test_apply_diff_helpers.py

…

test_apply_diff.py

…

test_apply_patch_tool.py

fix: #3359 preserve local approval rejection reasons (#3360 )

2026-05-11 22:32:46 +00:00

test_asyncio_progress.py

…

test_call_model_input_filter_unit.py

…

test_call_model_input_filter.py

…

test_cancel_streaming.py

fix: #2929 surface run-loop exceptions after stream_events() completes (#2931 )

2026-04-18 09:01:57 +09:00

test_computer_action.py

fix: #3512 type tool-end hook results as object (#3518 )

2026-05-28 17:57:33 +09:00

test_computer_tool_lifecycle.py

fix: exclude Computer instances from provider duck-typing (#3249 )

2026-05-09 02:45:31 +09:00

test_config.py

fix(models): raise UserError for conflicting provider args instead of assert (#3809 )

2026-07-12 06:50:12 +00:00

test_custom_tool.py

fix: #3359 preserve local approval rejection reasons (#3360 )

2026-05-11 22:32:46 +00:00

test_daytona_usaspending_example.py

chore: improve automated example coverage and local service handling (#3297 )

2026-05-09 16:17:49 +09:00

test_debug.py

…

test_doc_parsing.py

…

test_example_workflows.py

docs: stabilize two examples

2026-07-11 10:18:18 +09:00

test_exception_exports.py

test: improve coverage for stream and sandbox edge cases (#3730 )

2026-07-04 10:51:32 +09:00

test_extension_filters.py

fix(handoffs): preserve user messages containing history wrappers (#3815 )

2026-07-12 21:56:08 +00:00

test_extra_headers.py

fix: support cache-write usage across OpenAI Python versions (#3773 )

2026-07-10 07:14:43 +09:00

test_function_schema.py

…

test_function_tool_decorator.py

Sandbox Agents (#2889 )

2026-04-15 10:00:40 -07:00

test_function_tool.py

fix: redact invalid JSON payload in ModelBehaviorError data (#3485 )

2026-05-21 23:54:12 +00:00

test_global_hooks.py

fix: #3512 type tool-end hook results as object (#3518 )

2026-05-28 17:57:33 +09:00

test_guardrails.py

test: improve coverage for stream and sandbox edge cases (#3730 )

2026-07-04 10:51:32 +09:00

test_handoff_history_duplication.py

Sandbox Agents (#2889 )

2026-04-15 10:00:40 -07:00

test_handoff_prompt.py

…

test_handoff_tool.py

test: improve coverage for stream and sandbox edge cases (#3730 )

2026-07-04 10:51:32 +09:00

test_hitl_error_scenarios.py

fix(approvals): skip needs_approval_checker when status resolved in _collect_runs_by_approval (#3259 )

2026-06-22 11:10:56 +09:00

test_hitl_session_scenario.py

…

test_hitl_utils.py

…

test_invalid_final_output_handler.py

feat: add invalid final output recovery handler (#3736 )

2026-07-06 15:25:54 +09:00

test_items_helpers.py

test(items): document refusal None invariant (#3751 )

2026-07-08 08:29:40 +09:00

test_local_shell_tool.py

…

test_logprobs.py

fix: support cache-write usage across OpenAI Python versions (#3773 )

2026-07-10 07:14:43 +09:00

test_max_turns.py

feat: allow disabling max_turns with None (#3132 )

2026-05-06 21:14:27 +09:00

test_mcp_tool_metadata.py

test: add direct unit tests for _mcp_tool_metadata helpers (#3102 )

2026-05-04 18:00:20 +09:00

test_oaiconv_resume_response_id.py

fix(run): preserve last known response_id on conversation resume (#3245 )

2026-05-09 02:42:05 +09:00

test_output_guardrail_cancellation.py

fix: await cancelled output guardrail tasks on tripwire (#3187 )

2026-05-09 11:43:15 +09:00

test_output_tool.py

fix(handoffs): enforce strict Pydantic validation when strict_json_schema=True (#3724 )

2026-07-02 15:42:43 +09:00

test_pretty_print.py

fix: guard None text in text_message_output and add output guardrail count to RunErrorDetails (#3375 )

2026-05-12 14:53:34 +09:00

test_process_model_response.py

fix: #3459 add opt-in recovery for missing function tools (#3461 )

2026-05-21 10:46:44 +09:00

test_prompt_cache_key.py

feat: support GPT-5.6 request controls (#3794 )

2026-07-11 06:48:04 +09:00

test_repl.py

test: add unit tests for run_demo_loop streaming, EOF, and empty-input paths (#3542 )

2026-06-04 07:32:26 +00:00

test_responses_tracing.py

fix: support cache-write usage across OpenAI Python versions (#3773 )

2026-07-10 07:14:43 +09:00

test_responses.py

fix: #3055 surface model refusals during run resolution (#3057 )

2026-05-01 14:28:13 +09:00

test_result_cast.py

…

test_run_config.py

feat: add GPT-5.6 model defaults and migrate examples (#3774 )

2026-07-10 07:58:22 +09:00

test_run_context_approvals.py

Runtime handling updates (#3451 )

2026-05-18 16:53:20 -07:00

test_run_context_wrapper.py

…

test_run_error_details.py

…

test_run_examples_script.py

feat: improve examples auto-run coverage and artifact handling (#3328 )

2026-05-10 14:25:47 +09:00

test_run_hooks.py

test: improve coverage for stream and sandbox edge cases (#3730 )

2026-07-04 10:51:32 +09:00

test_run_impl_resume_paths.py

fix #2151 shield server-managed handoffs from unsupported history rewrites (#2747 )

2026-04-16 03:17:00 +09:00

test_run_internal_approvals.py

test: improve coverage and organize test layout (#3085 )

2026-05-02 15:40:54 +09:00

test_run_internal_error_handlers.py

feat: add invalid final output recovery handler (#3736 )

2026-07-06 15:25:54 +09:00

test_run_internal_items.py

test: improve coverage for stream and sandbox edge cases (#3730 )

2026-07-04 10:51:32 +09:00

test_run_state.py

fix: support cache-write usage across OpenAI Python versions (#3773 )

2026-07-10 07:14:43 +09:00

test_run_step_execution.py

test: improve coverage for stream and sandbox edge cases (#3730 )

2026-07-04 10:51:32 +09:00

test_run_step_processing.py

Sandbox Agents (#2889 )

2026-04-15 10:00:40 -07:00

test_run.py

…

test_runner_guardrail_resume.py

…

test_server_conversation_tracker.py

fix: #3620 avoid stale object-id dedupe in server conversation tracker (#3621 )

2026-06-22 12:53:47 +09:00

test_shell_call_serialization.py

fix: reject string-like shell commands (#3092 )

2026-05-04 09:50:59 +09:00

test_shell_tool.py

fix: #3359 preserve local approval rejection reasons (#3360 )

2026-05-11 22:32:46 +00:00

test_soft_cancel.py

…

test_source_compat_constructors.py

test: improve coverage for stream and sandbox edge cases (#3730 )

2026-07-04 10:51:32 +09:00

test_stream_events.py

test: improve coverage for stream and sandbox edge cases (#3730 )

2026-07-04 10:51:32 +09:00

test_stream_input_guardrail_timing.py

…

test_streamed_terminal_output_backfill.py

fix: backfill streamed terminal output (#3000 )

2026-04-23 09:32:44 +09:00

test_streaming_logging.py

…

test_streaming_tool_call_arguments.py

Sandbox Agents (#2889 )

2026-04-15 10:00:40 -07:00

test_strict_schema_oneof.py

Sandbox Agents (#2889 )

2026-04-15 10:00:40 -07:00

test_strict_schema.py

fix: #3317 return fresh empty strict schemas (#3318 )

2026-05-10 08:54:25 +09:00

test_tool_choice_reset.py

…

test_tool_context.py

fix: make ToolContext hashable to match RunContextWrapper (#3097 )

2026-05-04 09:58:28 +09:00

test_tool_converter.py

…

test_tool_custom_data.py

fix: enforce the documented strict JSON-compatible contract for #3486 (#3657 )

2026-06-18 08:26:47 +00:00

test_tool_guardrails.py

test: cover guardrail name fallback to function __name__ (#3073 )

2026-05-02 08:14:47 +09:00

test_tool_identity.py

test: add direct unit tests for _tool_identity helpers (#3101 )

2026-05-04 17:59:43 +09:00

test_tool_metadata.py

…

test_tool_origin.py

feat: #2228 persist tool origin metadata in run items (#2654 )

2026-04-16 05:01:04 +09:00

test_tool_output_conversion.py

fix(items): empty list/tuple tool output dropped via all([]) == True (#3554 )

2026-06-22 12:15:54 +09:00

test_tool_use_behavior.py

…

test_tool_use_tracker.py

Sandbox Agents (#2889 )

2026-04-15 10:00:40 -07:00

test_trace_processor.py

fix: #3354 interrupt tracing retry backoff on shutdown (#3355 )

2026-05-12 07:23:11 +09:00

test_tracing_errors_streamed.py

fix: redact invalid JSON payload in ModelBehaviorError data (#3485 )

2026-05-21 23:54:12 +00:00

test_tracing_errors.py

fix: redact invalid JSON payload in ModelBehaviorError data (#3485 )

2026-05-21 23:54:12 +00:00

test_tracing_provider_safe_debug.py

…

test_tracing.py

Sandbox Agents (#2889 )

2026-04-15 10:00:40 -07:00

test_transforms.py

fix: #2951 warn for tool name character replacement (#2953 )

2026-04-19 02:18:10 +00:00

test_usage.py

fix: support cache-write usage across OpenAI Python versions (#3773 )

2026-07-10 07:14:43 +09:00

test_usaspending_setup_db.py

feat: improve examples auto-run coverage and artifact handling (#3328 )

2026-05-10 14:25:47 +09:00

test_visualization.py

fix(visualization): keep fillcolor on handoff nodes by merging style attributes (#3744 )

2026-07-07 03:26:38 +00:00

testing_processor.py

Sandbox Agents (#2889 )

2026-04-15 10:00:40 -07:00

README.md

Tests

Before running any tests, make sure you have uv installed (and ideally run make sync after).

Running tests

make tests

make tests runs the shard-safe suite in parallel and then runs tests marked serial in a separate serial pass.

Snapshots

We use inline-snapshots for some tests. If your code adds new snapshot tests or breaks existing ones, you can fix/create them. After fixing/creating snapshots, run make tests again to verify the tests pass.

Fixing snapshots

make snapshots-fix

Creating snapshots

make snapshots-create