feat(specTypeSchema): include ResourceTemplate in SPEC_SCHEMA_KEYS

ResourceTemplate is a first-class spec type with a public type export
(ResourceTemplateType). It was excluded under the assumption that the
name collides with the server package's ResourceTemplate class, but
isSpecType.ResourceTemplate is a record property, not a top-level
export, so no collision occurs. Including it makes the migration docs'
'every named type in the MCP spec' claim accurate.

Corrected the allowlist comment (ResourceTemplate is not an internal
helper) and added type-level and runtime tests.

Author: felixweinberger

packages/core/src/types/specTypeSchema.ts

@@ -21,10 +21,14 @@ import * as schemas from './schemas.js';
  *
  * This intentionally excludes internal helper schemas exported from `schemas.ts` that have no
  * matching public type (e.g. `ListChangedOptionsBaseSchema`, `BaseRequestParamsSchema`,
- * `NotificationsParamsSchema`, `ClientTasksCapabilitySchema`, `ServerTasksCapabilitySchema`,
- * `ResourceTemplateSchema` whose public type was renamed to `ResourceTemplateType`). Keeping the
- * list explicit means new public spec types must be added here deliberately, and internals never
- * leak into `SpecTypeName`.
+ * `NotificationsParamsSchema`, `ClientTasksCapabilitySchema`, `ServerTasksCapabilitySchema`).
+ * Keeping the list explicit means new public spec types must be added here deliberately, and
+ * internals never leak into `SpecTypeName`.
+ *
+ * `ResourceTemplateSchema` is included; its public type is exported as `ResourceTemplateType`
+ * (the bare name collides with the server package's `ResourceTemplate` class), so
+ * `SpecTypes['ResourceTemplate']` is structurally equal to `ResourceTemplateType` rather than to
+ * a type literally named `ResourceTemplate`.
  */
 const SPEC_SCHEMA_KEYS = [
     'AnnotationsSchema',
@@ -135,6 +139,7 @@ const SPEC_SCHEMA_KEYS = [
     'ResourceLinkSchema',
     'ResourceListChangedNotificationSchema',
     'ResourceRequestParamsSchema',
+    'ResourceTemplateSchema',
     'ResourceTemplateReferenceSchema',
     'ResourceUpdatedNotificationSchema',
     'ResourceUpdatedNotificationParamsSchema',

packages/core/test/types/specTypeSchema.test.ts

@@ -3,7 +3,14 @@ import { describe, expect, expectTypeOf, it } from 'vitest';
 import type { OAuthMetadata, OAuthTokens } from '../../src/shared/auth.js';
 import type { SpecTypeName, SpecTypes } from '../../src/types/specTypeSchema.js';
 import { isSpecType, specTypeSchemas } from '../../src/types/specTypeSchema.js';
-import type { CallToolResult, ContentBlock, Implementation, JSONRPCRequest, Tool } from '../../src/types/types.js';
+import type {
+    CallToolResult,
+    ContentBlock,
+    Implementation,
+    JSONRPCRequest,
+    ResourceTemplateType,
+    Tool,
+} from '../../src/types/types.js';
 
 describe('specTypeSchemas', () => {
     it('returns a StandardSchemaV1 validator that accepts valid values', () => {
@@ -103,6 +110,7 @@ describe('SpecTypeName / SpecTypes (type-level)', () => {
         expectTypeOf<'JSONRPCRequest'>().toMatchTypeOf<SpecTypeName>();
         expectTypeOf<'OAuthTokens'>().toMatchTypeOf<SpecTypeName>();
         expectTypeOf<'OAuthMetadata'>().toMatchTypeOf<SpecTypeName>();
+        expectTypeOf<'ResourceTemplate'>().toMatchTypeOf<SpecTypeName>();
     });
 
     it('SpecTypes[K] matches the named export type', () => {
@@ -113,5 +121,14 @@ describe('SpecTypeName / SpecTypes (type-level)', () => {
         expectTypeOf<SpecTypes['JSONRPCRequest']>().toEqualTypeOf<JSONRPCRequest>();
         expectTypeOf<SpecTypes['OAuthTokens']>().toEqualTypeOf<OAuthTokens>();
         expectTypeOf<SpecTypes['OAuthMetadata']>().toEqualTypeOf<OAuthMetadata>();
+        // The public type is exported as ResourceTemplateType (the bare name collides with the
+        // server package's ResourceTemplate class), so this is the one entry where the key and
+        // the public type name differ.
+        expectTypeOf<SpecTypes['ResourceTemplate']>().toEqualTypeOf<ResourceTemplateType>();
+    });
+
+    it('isSpecType.ResourceTemplate validates a resource template', () => {
+        expect(isSpecType.ResourceTemplate({ name: 'r', uriTemplate: 'file:///{path}' })).toBe(true);
+        expect(isSpecType.ResourceTemplate({ name: 'r' })).toBe(false);
     });
 });