Skip to content

Commit 93ce57c

Browse files
feat(compat): overhaul v1→v2 migration docs for "just bump" path
Reframe both migration.md and migration-SKILL.md to lead with the backwards-compatible upgrade path: bump @modelcontextprotocol/sdk to ^2 and let deprecation warnings guide further migration. New content: - Prerequisites section: zod ^4.2.0 runtime-crash callout, moduleResolution bundler/nodenext requirement, bun file: cache note - "core is bundled" wording (never appears in node_modules) - Zod schemas no longer exported → parseJSONRPCMessage / specTypeSchema / isSpecType mapping; /zod-schemas escape hatch - Custom-method handler registration + spec-method extension warning - Transitive-v1-dependency type-mix guidance - OAuthError.errorCode → .code rename Mapping-table rows added: ResourceTemplateType, ZodRawShapeCompat, RequestInfo, FetchLike, OAuthProtectedResourceMetadata, server/auth/errors.js, server/express.js, inMemory.js, roots/list, completion/complete, resources/subscribe|unsubscribe|templates/list, tasks/get|result, notifications/roots/list_changed, notifications/elicitation/complete, callToolStream. Absorbs the doc edits from #1834 (SSE before/after example, InMemoryTransport export location, validator import simplification, method-string and callToolStream additions).
1 parent 9ed62fe commit 93ce57c

File tree

3 files changed

+380
-140
lines changed

3 files changed

+380
-140
lines changed
Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
---
2+
'@modelcontextprotocol/server': patch
3+
'@modelcontextprotocol/client': patch
4+
---
5+
6+
Overhaul v1→v2 migration docs: lead with the "just bump `@modelcontextprotocol/sdk` to ^2" path, add prerequisite callouts (zod ^4.2.0, `moduleResolution: bundler|nodenext`, bun cache), and fill mapping-table gaps (`ResourceTemplateType`, `OAuthError.code`, `parseJSONRPCMessage`,
7+
`specTypeSchema`, `ZodRawShapeCompat`, `roots/list`/`tasks/*`/`completion/complete` method strings, `InMemoryTransport`, `callToolStream`, custom-method handlers, transitive-v1-dep guidance).

0 commit comments

Comments
 (0)