Repository navigation
Commit a7cdbc0
feat(AIC-3687)!: rename create_openai_agent_handler to create_openai_agents_handler (#225)
Jira: [AIC-3687](https://launchdarkly.atlassian.net/browse/AIC-3687)
## What changed
- `launchdarkly_ai_openai_agents.create_openai_agent_handler` is renamed
`create_openai_agents_handler`, so it matches the other agents packages
(`create_claude_agents_handler`, `create_litellm_agents_handler`). The
non-reporting internal `_create_openai_agent_handler` is renamed
`_create_openai_agents_handler` to match.
- Every reference is updated: package code (`__init__.py`, `handler.py`,
`graph.py`), tests, `README.md`, `AGENTS.md`, `examples/register.py`,
`packages/client/README.md`, `packages/openai-agents/README.md` and
`agents.md`.
- No deprecated alias.
- The `$ld:ai:sdk:usage` ID `openai-agents.createOpenAIAgentHandler` is
**unchanged**, as the monorepo spec requires, so usage telemetry stays
continuous. Only the Python function name changes.
- API report regenerated with `make api-report`.
**Pre-1.0 rename:** the old name is no longer importable. Nothing has
shipped as 1.0, so there is no compatibility promise to keep. The `!`
only gives the 0.x minor bump. The monorepo API-surface lists are
updated in a companion ai-sdks-monorepo PR.
## Testing
- `make api-report` and `make api-report-check`: pass
- `make lint`, `make format-check`, `make typecheck`: pass
- `uv run pytest packages/openai-agents`: 192 passed
- `make test`: 3631 passed, 2 failed. The 2 failures
(`packages/client/tests/test_lifecycle.py::TestInitClientSDKKeyPath::test_uses_options_sdk_key_over_env_var`
and `::test_retries_after_a_failed_init_instead_of_replaying_it`) fail
the same way on an untouched `origin/main` checkout in the same
location. They pick up staging URIs from a local `.env`, so they are a
local environment issue, not caused by this change.
- `git grep create_openai_agent_handler` (excluding CHANGELOGs): no
matches. `git grep -F openai-agents.createOpenAIAgentHandler`: still in
`handler.py` and `tests/test_sdk_usage.py`.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
[AIC-3687]:
https://launchdarkly.atlassian.net/browse/AIC-3687?atlOrigin=eyJpIjoiNWRkNTljNzYxNjVmNDY3MDlhMDU5Y2ZhYzA5YTRkZjUiLCJwIjoiZ2l0aHViLWNvbS1KU1cifQ
<!-- CURSOR_SUMMARY -->
---
> [!NOTE]
> **Overview**
> **Breaking rename** of the OpenAI agents factory from
`create_openai_agent_handler` to **`create_openai_agents_handler`**,
aligning with `create_claude_agents_handler` and other
`*_agents_handler` packages. The internal non-reporting helper is
renamed to `_create_openai_agents_handler` as well.
>
> The public export (`__init__.py`), `handler.py`, `graph.py`,
regenerated API report, examples, and all README/agent docs now use the
new name. **No deprecated alias** — callers must update imports.
>
> The `$ld:ai:sdk:usage` event id
`openai-agents.createOpenAIAgentHandler` is **unchanged** so usage
metrics stay continuous; only the Python symbol changes.
>
> <sup>Reviewed by [Cursor Bugbot](https://cursor.com/bugbot) for commit
1037715. Bugbot is set up for automated
code reviews on this repo. Configure
[here](https://www.cursor.com/dashboard/bugbot).</sup>
<!-- /CURSOR_SUMMARY -->
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>1 parent 11f2c0b commit a7cdbc0
12 files changed
Lines changed: 115 additions & 111 deletions
File tree
- examples
- packages
- client
- openai-agents
- api-report
- src/launchdarkly_ai_openai_agents
- tests
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
482 | 482 | | |
483 | 483 | | |
484 | 484 | | |
485 | | - | |
| 485 | + | |
486 | 486 | | |
487 | 487 | | |
488 | 488 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
183 | 183 | | |
184 | 184 | | |
185 | 185 | | |
186 | | - | |
| 186 | + | |
187 | 187 | | |
188 | 188 | | |
189 | 189 | | |
| |||
208 | 208 | | |
209 | 209 | | |
210 | 210 | | |
211 | | - | |
| 211 | + | |
212 | 212 | | |
213 | 213 | | |
214 | 214 | | |
| |||
457 | 457 | | |
458 | 458 | | |
459 | 459 | | |
460 | | - | |
| 460 | + | |
461 | 461 | | |
462 | 462 | | |
463 | | - | |
| 463 | + | |
464 | 464 | | |
465 | 465 | | |
466 | 466 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
19 | 19 | | |
20 | 20 | | |
21 | 21 | | |
22 | | - | |
| 22 | + | |
23 | 23 | | |
24 | 24 | | |
25 | 25 | | |
26 | 26 | | |
27 | 27 | | |
28 | 28 | | |
29 | 29 | | |
30 | | - | |
| 30 | + | |
31 | 31 | | |
32 | 32 | | |
33 | 33 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
314 | 314 | | |
315 | 315 | | |
316 | 316 | | |
317 | | - | |
| 317 | + | |
318 | 318 | | |
319 | 319 | | |
320 | 320 | | |
| |||
339 | 339 | | |
340 | 340 | | |
341 | 341 | | |
342 | | - | |
| 342 | + | |
343 | 343 | | |
344 | 344 | | |
345 | 345 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
19 | 19 | | |
20 | 20 | | |
21 | 21 | | |
22 | | - | |
| 22 | + | |
23 | 23 | | |
24 | 24 | | |
25 | 25 | | |
26 | 26 | | |
27 | | - | |
| 27 | + | |
28 | 28 | | |
29 | 29 | | |
30 | 30 | | |
| |||
60 | 60 | | |
61 | 61 | | |
62 | 62 | | |
63 | | - | |
| 63 | + | |
64 | 64 | | |
65 | 65 | | |
66 | 66 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
39 | 39 | | |
40 | 40 | | |
41 | 41 | | |
42 | | - | |
| 42 | + | |
43 | 43 | | |
44 | | - | |
| 44 | + | |
45 | 45 | | |
46 | 46 | | |
47 | 47 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
1 | 1 | | |
2 | 2 | | |
3 | | - | |
| 3 | + | |
4 | 4 | | |
5 | 5 | | |
6 | 6 | | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
8 | 8 | | |
9 | 9 | | |
10 | 10 | | |
11 | | - | |
| 11 | + | |
12 | 12 | | |
13 | 13 | | |
14 | 14 | | |
15 | 15 | | |
16 | 16 | | |
17 | | - | |
| 17 | + | |
18 | 18 | | |
19 | 19 | | |
20 | 20 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
4 | 4 | | |
5 | 5 | | |
6 | 6 | | |
7 | | - | |
| 7 | + | |
8 | 8 | | |
9 | 9 | | |
10 | 10 | | |
| |||
14 | 14 | | |
15 | 15 | | |
16 | 16 | | |
17 | | - | |
| 17 | + | |
18 | 18 | | |
19 | 19 | | |
20 | 20 | | |
21 | | - | |
| 21 | + | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
646 | 646 | | |
647 | 647 | | |
648 | 648 | | |
649 | | - | |
| 649 | + | |
650 | 650 | | |
651 | 651 | | |
652 | 652 | | |
| |||
658 | 658 | | |
659 | 659 | | |
660 | 660 | | |
661 | | - | |
| 661 | + | |
662 | 662 | | |
663 | 663 | | |
664 | | - | |
| 664 | + | |
665 | 665 | | |
666 | 666 | | |
667 | | - | |
| 667 | + | |
668 | 668 | | |
669 | 669 | | |
670 | 670 | | |
| |||
943 | 943 | | |
944 | 944 | | |
945 | 945 | | |
946 | | - | |
| 946 | + | |
947 | 947 | | |
948 | 948 | | |
0 commit comments