docs: fix self-contradictory 'removed' wording in 3 spots (variadic methods, StreamableHTTPError, SKILL §5 rows)

Author: felixweinberger

docs/migration-SKILL.md

@@ -100,8 +100,8 @@ The v1 names below are still exported as `@deprecated` aliases. Migrate to the v
 | `ResourceReference`                                      | `ResourceTemplateReference`                                                                                     |
 | `ResourceReferenceSchema`                                | `ResourceTemplateReferenceSchema`                                                                               |
 | `ResourceTemplate` (the protocol _type_)                 | `ResourceTemplateType` (`ResourceTemplate` is now the server template _class_)                                  |
-| `IsomorphicHeaders`                                      | REMOVED (use Web Standard `Headers`)                                                                            |
-| `RequestInfo` (custom SDK type)                          | REMOVED (use Web Standard `Request` via `ctx.http?.req`)                                                        |
+| `IsomorphicHeaders`                                      | `Headers` (Web Standard)                                                                                        |
+| `RequestInfo` (custom SDK type)                          | `Request` (Web Standard, via `ctx.http?.req`)                                                                   |
 | `ZodRawShapeCompat`                                      | `StandardSchemaWithJSON`                                                                                        |
 | `AuthInfo` (from `server/auth/types.js`)                 | `AuthInfo` (now re-exported by `@modelcontextprotocol/client` and `@modelcontextprotocol/server`)               |
 | `OAuthProtectedResourceMetadata` (from `shared/auth.js`) | `OAuthProtectedResourceMetadata` (re-exported by `@modelcontextprotocol/client` / `server`)                     |
@@ -112,8 +112,9 @@ The v1 names below are still exported as `@deprecated` aliases. Migrate to the v
 | `ErrorCode`                                              | `ProtocolErrorCode`                                                                                             |
 | `ErrorCode.RequestTimeout`                               | `SdkErrorCode.RequestTimeout`                                                                                   |
 | `ErrorCode.ConnectionClosed`                             | `SdkErrorCode.ConnectionClosed`                                                                                 |
-| `StreamableHTTPError`                                    | REMOVED (use `SdkError` with `SdkErrorCode.ClientHttp*`)                                                        |
-| `WebSocketClientTransport`                               | REMOVED (use `StreamableHTTPClientTransport` or `StdioClientTransport`)                                         |
+| `StreamableHTTPError`                                    | `SdkError` with `SdkErrorCode.ClientHttp*`                                                                      |
+
+`WebSocketClientTransport` is **removed** (no deprecated alias). Use `StreamableHTTPClientTransport` or `StdioClientTransport`.
 
 All other **type** symbols from `@modelcontextprotocol/sdk/types.js` retain their original names. **Zod schemas** (e.g., `CallToolResultSchema`, `ListToolsResultSchema`, `OAuthTokensSchema`) are no longer part of the public API. For runtime validation: use
 `parseJSONRPCMessage(raw)` for transport framing, `isCallToolResult(v)` for the common case, or `specTypeSchema('<Name>')` / `isSpecType('<Name>', v)` for any other spec type. The raw Zod constants remain available at `@modelcontextprotocol/server/zod-schemas` as a compatibility

docs/migration.md

@@ -292,9 +292,7 @@ const debug = url.searchParams.get('debug');
 
 ### `McpServer.tool()`, `.prompt()`, `.resource()` deprecated
 
-These variadic methods are still available as `@deprecated` overloads that forward to `registerTool`/`registerPrompt`/`registerResource`. Migrate when convenient:
-
-The deprecated variadic-overload methods have been removed. Use `registerTool`, `registerPrompt`, and `registerResource` instead. These use an explicit config object rather than positional arguments.
+These variadic methods are still available as `@deprecated` overloads that forward to `registerTool`/`registerPrompt`/`registerResource`. The new methods use an explicit config object rather than positional arguments. Migrate when convenient:
 
 **Before (v1):**
 
@@ -854,7 +852,7 @@ The new `SdkErrorCode` enum contains string-valued codes for local SDK errors:
 | `SdkErrorCode.ClientHttpFailedToOpenStream`       | Failed to open SSE stream                   |
 | `SdkErrorCode.ClientHttpFailedToTerminateSession` | Failed to terminate session                 |
 
-#### `StreamableHTTPError` removed
+#### `StreamableHTTPError` deprecated
 
 `StreamableHTTPError` is now a subclass of `SdkError` (so `instanceof SdkError` and `instanceof StreamableHTTPError` both work). HTTP transport errors carry specific `SdkErrorCode` values for granular handling. Note: `error.code` is now an `SdkErrorCode` string; the HTTP status is on `error.status`.