docs: clarify read_command_output search param should be omitted when not filtering #11056
+2
−2
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
Adds explicit guidance to the
read_command_outputtool description telling models to omit thesearchparameter entirely when not filtering, rather than passingnullor empty string.This prevents models from mistakenly passing the literal string
"null"as a search pattern, which causes the tool to search for lines containing the text "null" instead of returning all content.Changes
searchparameter description in the tool's overall description to include: "Omit this parameter entirely if you don't need to filter - do not pass null or empty string."SEARCH_DESCRIPTIONconstant with the same guidanceContext
Investigation found that models sometimes pass
"search": "null"when they intend "no search filter". The tool was designed withstrict: falsespecifically so models could omit optional parameters. This documentation update teaches models the correct behavior.Important
Clarifies
searchparameter usage inread_command_output.tsto omit it when not filtering.searchparameter description inread_command_output.tsto instruct omitting it if not filtering.SEARCH_DESCRIPTIONconstant with the same guidance.This description was created by
for c2f6d00. You can customize this summary. It will automatically update as commits are pushed.