Skip to content

Commit c934b04

Browse files
committed
[Doc] Align the ROADMAP deprecation wording with the shipped behavior
## Motivation and Context The Deprecated Features paragraph still described the pre-#516 design, claiming the SDK "emits deprecation warnings when they are used with protocol version 2026-07-28 or newer". Since #516 the only deprecation warning is the client-side one, emitted on a modern connect that declares the Roots or Sampling capabilities, exactly as the 1.2.0 CHANGELOG entry states. Logging never warns (`notify_log_message` is the sanctioned SEP-2575 delivery path on that wire), and the server never warns either: `initialize` counter-offers a legacy version, a modern `Configuration` pin is rejected at construction, and the modern lifecycle refuses the deprecated server-to-client request APIs outright rather than serving them with a warning. The paragraph now describes the shipped behavior and says where each feature lives per lifecycle: unchanged on legacy, carried on 2026-07-28 by input requests embedded in `InputRequiredResult` responses (the SEP-2322 multi round-trip requests pattern) and the envelope's `logLevel`. Those carriers are not the SEP-2577 replacements: the spec's deprecated-features registry points migrating implementations outside the protocol (tool parameters or configuration, direct LLM provider APIs, stderr or OpenTelemetry), and the paragraph now says so instead of presenting the modern delivery forms as the replacements. ## How Has This Been Tested? Documentation-only change; proofread against the `ProtocolDeprecations` module header and the CHANGELOG entry that shipped this behavior in 1.2.0, which the 1.3.0 release leaves unchanged.
1 parent 4eb6615 commit c934b04

1 file changed

Lines changed: 9 additions & 5 deletions

File tree

ROADMAP.md

Lines changed: 9 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -19,11 +19,15 @@ which also defines the Semantic Versioning scheme and breaking-change policy.
1919
## Deprecated Features
2020

2121
The 2026-07-28 spec revision deprecates Roots, Sampling, and Logging (SEP-2577).
22-
These features remain fully supported throughout 1.x, and the SDK emits deprecation warnings when they are used
23-
with protocol version 2026-07-28 or newer.
24-
Under Semantic Versioning their removal requires a major release, but no removal is scheduled yet:
25-
whether 2.0.0 removes them depends on how future MCP spec revisions treat these features
26-
and on adoption of their replacements.
22+
These features remain supported throughout 1.x: on the legacy lifecycle they work unchanged
23+
(the deprecations do not apply there), and the 2026-07-28 lifecycle carries them through its own mechanisms:
24+
roots-shaped and sampling-shaped input requests embedded in `InputRequiredResult` responses
25+
(the SEP-2322 multi round-trip requests pattern) and per-request log delivery through the envelope's `logLevel`.
26+
The replacements SEP-2577 names live outside the protocol: tool parameters or configuration for roots,
27+
direct LLM provider APIs for sampling, and stderr or OpenTelemetry for logging.
28+
The client emits a deprecation warning when a modern connect declares the deprecated Roots or Sampling capabilities.
29+
Under Semantic Versioning their removal requires a major release, but no removal is scheduled yet: whether 2.0.0 removes
30+
them depends on how future MCP spec revisions treat these features and on adoption of their replacements.
2731

2832
## Conformance
2933

0 commit comments

Comments
 (0)