feat: add tool annotations

[eelkevdbos]

Adds tool annotations described in the tool specification.

[dickdavis]

Thanks for the contribution! I'll be cutting a new release soon that'll include this change.

[eelkevdbos]

@dickdavis, are you open to additions not strictly related to the spec, but needed for proper integration with ChatGPT's authorization hints (e.g. securitySchemes)?

[dickdavis]

@dickdavis, are you open to additions not strictly related to the spec, but needed for proper integration with ChatGPT's authorization hints (e.g. securitySchemes)?

I'm open to including fields from draft specs, especially given the pace of change. Ideally, we'd have a mechanism for excluding certain fields if the negotiated protocol doesn't support the field. However, I don't think this change would break anything, so that shouldn't be a blocker for what you are proposing. We'll need to consider that mechanism more deeply when we encounter breaking changes between protocol versions.

[dickdavis]

@eelkevdbos Would you mind running bundle exec standardrb --fix real quick to clean up the linter errors? Happy to approve again and merge once the checks pass.

[dickdavis]

@eelkevdbos Thanks again! You should be able to pin to ref 89157f743de68137ea3434007d3a3a3217d8739e in your Gemfile (or just main) to pick up your change. The next release will be in a few days; I'm wrapping up some housekeeping stuff, and then it'll be ready.

Feel free to submit any PRs in the meantime.