Enhance native tool descriptions with examples and clarifications #9486
Conversation
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
- Extract tool descriptions into separate constants for better maintainability - Add detailed JSON examples showing proper usage for each tool - Include parameter explanations and usage clarifications from XML versions - Maintain consistent structure across all tool definitions Tools enhanced (18 total): - apply_diff, ask_followup_question, attempt_completion - browser_action, codebase_search, execute_command - fetch_instructions, generate_image, insert_content - list_code_definition_names, list_files, new_task - read_file, run_slash_command, search_files - switch_mode, update_todo_list, write_to_file All tests passing (6/6 in native-tools/__tests__/)
dosubot
bot
added
the
size:L
Contributor
Review completed. All 18 tool enhancement files have been examined. The changes follow a consistent pattern of extracting descriptions into constants with helpful examples and clarifications. No issues found. Mention @roomote in a comment to request specific changes to this pull request or fix all unresolved issues. |
hannesrudolph
added
the
Issue/PR - Triage
![roomote[bot]](https://avatars.githubusercontent.com/in/1546624?s=60&v=4){kind=small}
mrubens
approved these changes
Nov 22, 2025
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
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.
Summary
This PR enhances the native tool descriptions to match the detail level of their XML counterparts by:
Tools Enhanced (18 total)
Benefits
Testing
✅ All tests pass (4192 passed, 4 skipped)
✅ All lint checks pass
✅ All type checks pass
Important
Enhances 18 native tool descriptions by extracting them into constants, adding JSON examples, and including parameter explanations for better maintainability and consistency.
apply_diff,ask_followup_question,attempt_completion.browser_action,codebase_search,execute_command.fetch_instructions,generate_image,insert_content.list_code_definition_names,list_files,new_task.read_file,run_slash_command,search_files.switch_mode,update_todo_list,write_to_file.This description was created by
for 4bf256f. You can customize this summary. It will automatically update as commits are pushed.