feat: add tool execution properties to Tool

[devcrocod]

closes #543

How Has This Been Tested?

unit

Breaking Changes

binary compatibility in the Tool class

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

[Copilot]

Pull request overview

Adds support for MCP “tool execution” metadata in the Kotlin SDK so tools can advertise task-augmented execution capabilities (issue #543).

Changes:

• Introduces ToolExecution + TaskSupport and adds optional execution to Tool.
• Extends Server.addTool(...) overload to accept execution and pass it into the registered Tool.
• Adds serialization/deserialization unit tests and updates API dumps (plus adds detekt baseline files).

Reviewed changes

Copilot reviewed 8 out of 8 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
kotlin-sdk-server/src/commonMain/kotlin/io/modelcontextprotocol/kotlin/sdk/server/Server.kt	Extends addTool overload to accept/pass ToolExecution.
kotlin-sdk-server/api/kotlin-sdk-server.api	Updates public API surface for the new addTool signature.
kotlin-sdk-core/src/commonTest/kotlin/io/modelcontextprotocol/kotlin/sdk/types/ToolsTest.kt	Adds unit tests for ToolExecution and Tool.execution JSON round-trips.
kotlin-sdk-core/src/commonMain/kotlin/io/modelcontextprotocol/kotlin/sdk/types/tools.kt	Adds Tool.execution, new ToolExecution model, and TaskSupport enum.
kotlin-sdk-core/src/commonMain/kotlin/io/modelcontextprotocol/kotlin/sdk/types.kt	Adjusts deprecated Tool(...) wrapper callsite to use named meta argument.
kotlin-sdk-core/detekt-baseline-test.xml	Adds a detekt baseline for tests (currently appears unused/stale).
kotlin-sdk-core/detekt-baseline-commonTestSourceSet.xml	Adds a detekt baseline for commonTest source set (currently appears unused).
kotlin-sdk-core/api/kotlin-sdk-core.api	Updates public API surface for new types and Tool signature changes.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[kpavlov]

Thank you @devcrocod !

Almost perfect, but let's address @copilot findings, especially breaking changes, KDoc discrepancy and baseline cleanup suggestions.
Let's not inflate detekt baseline files: they should only shrink.
Let's maintain PR description accurate and informative.

[kpavlov]

1. This is a legitimate finding. Let's split ToolsTest for maintainability instead of suppressing warning.

2. In general, let's not add anything to baselines. Only remove. In exceptional cases let's use @Suppress annotation in place

[devcrocod]

1. currently, our approach is to group unit tests by entity for types. Splitting ToolsTest into separate files would increase complexity and make the structure less clear
2. ideally, we should avoid adding @Suppress annotations from third-party tools into the source code. For now, I've added this to baseline, which is also not the best solution. If you see a better approach, I'd appreciate your suggestion

[kpavlov]

1. This method might not be the best fit when the group gets too large.

Splitting ToolsTest into separate files would increase complexity and make the structure less clear

Actually, it is often the other way around. Smaller files are usually easier to understand and keep up with. This one is over 500 lines and checks out several classes. It could be broken down into smaller pieces, so let’s do that.

[kpavlov]

2. Ideally, we should avoid situations where @Suppress is needed.

There is one exception: when we are clearly explaining our design choice to NOT follow best practices. We can add a comment to clarify this. If it is in the code, it is easy to see whether it is a false positive or not. But if it is in the baseline file, it’s separate from the code.

Let’s focus on removing baseline files rather than adding more to them.

I’m afraid I won’t be able to give +1 on this.

[Copilot]

Pull request overview

Copilot reviewed 8 out of 8 changed files in this pull request and generated no new comments.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[codecov-commenter]

Codecov Report

❌ Patch coverage is 88.88889% with 1 line in your changes missing coverage. Please review.
✅ All tests successful. No failed tests found.

Files with missing lines	Patch %	Lines
.../io/modelcontextprotocol/kotlin/sdk/types/tools.kt	85.71%	0 Missing and 1 partial ⚠️

📢 Thoughts on this report? Let us know!

[kpavlov]

@devcrocod, ok please check the #582 and consider removing unnecessary baselines