Skip to content

Remove "unconditionally" from conditional description #1289

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

mssalvatore
Copy link

The current docstrings regarding tool creation read, "unconditionally creates a structured tool (return type annotation permitting)". If the return type annotation limits whether or not a structured tool can be created, then creation of a structured tool is conditional upon the presence of a proper return type annotation. Therefore, these descriptions should not include the word "unconditionally", as it is inaccurate and contradictory.

Motivation and Context

Certain docstrings are self-contradictory, which is either a mistake or an indication that the description is not sufficiently clear.

How Has This Been Tested?

Since this changes only docstrings, it has not been tested.

Breaking Changes

None

Types of changes

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to change)
  • Documentation update

Checklist

  • I have read the MCP Documentation
  • My code follows the repository's style guidelines
  • New and existing tests pass locally
  • I have added appropriate error handling
  • I have added or updated documentation as needed

The current docstrings regarding tool creation read, "unconditionally
creates a structured tool (return type annotation permitting)". If the
return type annotation limits whether or not a structured tool can be
created, then creation of a structured tool is *conditional* upon the
presence of a proper return type annotation. Therefore, these
descriptions should not include the word "unconditionally", as it is
inaccurate and contradictory.
@mssalvatore mssalvatore requested a review from a team as a code owner August 20, 2025 19:48
@mssalvatore mssalvatore requested a review from dsp-ant August 20, 2025 19:48
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