ref(openai-agents): Use first class tool hooks when available

[alexander-alderman-webb]

Description

Register a RunHooks instance or patch a user-provided hooks instance if it exists. Inject the resulting instance as the hooks keyword-only argument to AgentRunner.run() and AgentRunner.run_streamed().

Note that the hooks are only added starting with openai-agents version 0.3.2 as tool call arguments are unavailable in prior versions.

The openai-agents/patches/tools.py file can be removed in the next major due to redundancy with the hooks.

Rename responses_tool_call_model_responses by prefixing the fixture with nonstreaming_, and add a minimal equivalent streaming fixture. Add a variant of the test_tool_execution_span test that calls AgentRunner.run_streamed() instead of AgentRunner.run().

Issues

Closes #6988

Reminders

• Please add tests to validate your changes, and lint your code using uv run ruff.
• Add GH Issue ID & Linear ID (if applicable)
• PR title should use conventional commit style (feat:, fix:, ref:, meta:)
• For external contributors: CONTRIBUTING.md, Sentry SDK development docs, Discord community

[github-actions]

Codecov Results 📊

✅ 95743 passed | ⏭️ 6239 skipped | Total: 101982 | Pass Rate: 93.88% | Execution Time: 350m 2s

📊 Comparison with Base Branch

Metric	Change
Total Tests	📈 +180
Passed Tests	📈 +180
Failed Tests	—
Skipped Tests	—

All tests are passing successfully.

✅ Patch coverage is 94.59%. Project has 2509 uncovered lines.
✅ Project coverage is 89.92%. Comparing base (base) to head (head).

Files with missing lines (2)

File	Patch %	Lines
sentry_sdk/integrations/openai_agents/patches/runner.py	94.74%	⚠️ 3 Missing and 4 partials
sentry_sdk/integrations/openai_agents/patches/tools.py	87.50%	⚠️ 1 Missing and 1 partials

Coverage diff

@@            Coverage Diff             @@
##          main       #PR       +/-##
==========================================
+ Coverage    89.92%    89.92%        —%
==========================================
  Files          193       193         —
  Lines        24825     24880       +55
  Branches      8912      8936       +24
==========================================
+ Hits         22321     22371       +50
- Misses        2504      2509        +5
- Partials      1414      1421        +7

---

Generated by Codecov Action

[cursor]

Cursor Bugbot has reviewed your changes and found 2 potential issues.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

Want reviews to match your repository better? Bugbot Learning can learn team-specific rules from PR activity. A team admin can enable Learning in the Cursor dashboard.

^{Reviewed by Cursor Bugbot for commit bb76a15. Configure here.}

[sentrivana]

Lgtm.

The openai-agents/patches/tools.py file can be removed in the next major due to redundancy with the hooks.

Let's add a comment to the file so that we don't forget?