Skip to content

docs: clarify tool search support and namespace guidance#1072

Merged
seratch merged 2 commits intomainfrom
docs/tool-search-guidance
Mar 9, 2026
Merged

docs: clarify tool search support and namespace guidance#1072
seratch merged 2 commits intomainfrom
docs/tool-search-guidance

Conversation

@seratch
Copy link
Member

@seratch seratch commented Mar 7, 2026

This pull request updates the tool search documentation to align the JS SDK guides with the current Responses API behavior and the official tool search guide. It adds a new docs example for deferred tool loading, explains when to keep a deferred tool top-level versus grouping related tools with toolNamespace(), and documents that namespaced and top-level deferred tools can be mixed in the same request.

It also fills in the supporting guide coverage around tool search by:

  • adding tool_search and toolSearchTool() to the main tools guide
  • documenting the RunToolSearchCallItem / RunToolSearchOutputItem result surfaces
  • documenting the tool_search_called / tool_search_output_created streaming events
  • clarifying that deferred tool loading is Responses-only and should be used with GPT-5.4 and newer supported model releases

@changeset-bot
Copy link

changeset-bot bot commented Mar 7, 2026

⚠️ No Changeset found

Latest commit: 472f57c

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@github-actions github-actions bot added the documentation Improvements or additions to documentation label Mar 7, 2026
@seratch seratch added this to the 0.6.x milestone Mar 7, 2026
@seratch seratch merged commit 72f174a into main Mar 9, 2026
8 checks passed
@seratch seratch deleted the docs/tool-search-guidance branch March 9, 2026 04:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant