Introduce tool exposure for deferred registration#22489
Merged
Conversation
pakrym-oai
reviewed
May 13, 2026
pakrym-oai
approved these changes
May 13, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to subscribe to this conversation on GitHub.
Already have an account?
Sign in.
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Why
Deferred tools were tracked with separate side-channel filtering after tool specs had already been assembled. That made the registry responsible for executing tools while the router/spec planner separately decided whether those same tools should be exposed to the model up front.
This PR makes exposure part of the tool handler contract so direct versus deferred availability travels with the executable tool registration.
Next step will be to simplify registration
What Changed
ToolExposuretocodex-toolsand exposes it throughToolExecutor, defaulting tools toDirect.Deferredat construction time.AnyToolHandlertoRegisteredTooland usesToolExposurewhen deciding whether to include a handler's spec in the initial model-visible tool list.Verification