The reworked Client that speaks every version: a connect sequence that probes server/discover and falls back to initialize, stamps the _meta envelope on modern requests, and exposes both a low-level interface (raw requests, handle MRTR yourself) and a high-level one (negotiation/MRTR/etc. handled). Relationship to ClientSession is part of this design.

What's in it

• Low-level + high-level interface; relationship to ClientSession (replaces? wraps? grows 2026 under the hood?).
• Connect sequence: probe server/discover → fall back to legacy initialize; cache era per origin.
• Stamp the _meta envelope on every modern request.
• Emit Mcp-Method / Mcp-Name / Mcp-Param-* on modern HTTP (consumes the helpers from HTTP standard headers + x-mcp-header #2900).
• Own the client-side wiring of the MRTR loop (MRTR (multi-round-trip requests)), listen stream (subscriptions/listen), and caching parse (Caching hints (ttlMs / cacheScope)) — those issues supply the helpers.
• Never send session-id / open GET / DELETE against modern servers.

Conformance

• request-metadata
• http-standard-headers (runs and passes, not skips)
• http-custom-headers, http-invalid-tool-headers (with HTTP standard headers + x-mcp-header #2900)
• sep-2322-client-request-state (with MRTR (multi-round-trip requests) #2898)

Dependencies

• Depends on: Backwards compatibility & version negotiation #2892

References

• Versioning
• server/discover
• SEP-2575
• client/request-metadata.ts