Skip to content

fix(AIC-3726): realign three usage IDs with the 1.0 factory names - #252

Draft
jeffdupont wants to merge 2 commits into
mainfrom
jdupont/usage-id-realign
Draft

jeffdupont wants to merge 2 commits into
mainfrom
jdupont/usage-id-realign

Conversation

@jeffdupont

@jeffdupont jeffdupont commented Oct 29, 2026 •

Copy link
Copy Markdown
Contributor

What

Renames three $ld:ai:sdk:usage helper IDs (TESTING.md §3.27) so they match the factory names introduced by AIC-3686 / AIC-3687.

Factory (TS / Python / Go) Old ID New ID
createOpenAIMessagesHandler / create_openai_messages_handler / openaimessages.NewHandler openai-messages.createOpenAIHandler openai-messages.createOpenAIMessagesHandler
createLangChainMessagesHandler / create_langchain_messages_handler / langchainmessages.NewHandler langchain-messages.createLangChainHandler langchain-messages.createLangChainMessagesHandler
createOpenAIAgentsHandler / create_openai_agents_handler / openaiagents.NewHandler openai-agents.createOpenAIAgentHandler openai-agents.createOpenAIAgentsHandler

Changes: the three report_usage calls and the test_sdk_usage.py rows and payload assertions.

Why

TESTING.md §3.27 freezes usage IDs, which is why the factory renames kept the old IDs. Nothing has published at 1.0 yet, so this realigns the three IDs once, in every SDK at the same time, before the 1.0 release PRs merge. The spec PR records this as the only pre-1.0 exception; the freeze holds from 1.0.0 on.

Tests

  • pytest: openai-messages 146 passed, langchain-messages 182 passed, openai-agents 195 passed.
  • Check that the test really covers the ID: putting the old ID back in openai-messages/.../handler.py fails 2 of the 3 test_sdk_usage.py tests; the new ID passes all 3.

Links

🤖 Generated with Claude Code

Rename openai-messages.createOpenAIHandler, langchain-messages.createLangChainHandler
and openai-agents.createOpenAIAgentHandler to the factory names from AIC-3686 /
AIC-3687. One-time pre-1.0 exception to the TESTING.md §3.27 ID freeze.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant