@mcpdesc/validator 0.9.0 → 0.10.1

package/src/snapshots/{0.8.0-rc.1 → 0.8.0-rc.3}/semantic.js

@@ -1,4 +1,4 @@
-// Validate the immutable 0.8.0-rc.1 snapshot using only snapshot-local artifacts.
+// Validate the immutable 0.8.0-rc.3 snapshot using only snapshot-local artifacts.
 
 import Ajv from 'ajv';
 import Ajv2020 from 'ajv/dist/2020.js';
@@ -6,11 +6,13 @@ import addFormats from 'ajv-formats';
 import { UriTemplateMatcher } from 'uri-template-matcher';
 import schema from './schema.json' with { type: 'json' };
 import {
+  mcpExtensionCatalogue,
+  mcpExtensionMaturity,
   semanticValidateDocument as validateBaseSemantics,
   supportedProtocolVersions
 } from './base.js';
 
-export { supportedProtocolVersions };
+export { mcpExtensionCatalogue, mcpExtensionMaturity, supportedProtocolVersions };
 
 const TOOL_INTERACTION_SENTINEL = '__interaction_example__';
 const ajv = new Ajv2020({ allErrors: true, strict: false });
@@ -21,7 +23,6 @@ const validateStructure = ajv.compile(schema);
 const primitiveCollections = ['tools', 'resources', 'resourceTemplates', 'prompts'];
 const componentNamespaces = ['schemas', 'toolExamples', 'resourceExamples', 'resourceTemplateExamples', 'promptExamples'];
 const knownClientCapabilities = new Set(['roots', 'sampling', 'elicitation', 'tasks', 'extensions', 'experimental']);
-const knownReservedCapabilityExtensions = new Set(['io.modelcontextprotocol/tasks']);
 const protocolOrder = new Map(supportedProtocolVersions.map((version, index) => [version, index]));
 
 const clientCapabilitiesByVersion = {
@@ -66,7 +67,7 @@ export function resolveComponentReferences(document, rel = 'document') {
 
   function resolve(reference, expectedNamespace, path, stack = []) {
     const match = /^#\/components\/([^/]+)\/([^/]+)$/.exec(reference?.$componentRef ?? '');
-    if (!match) return { value: reference };
+    if (!match) return reference;
     const [, namespace, name] = match;
     if (namespace !== expectedNamespace) {
       diagnostics.push(componentDiagnostic(
@@ -581,7 +582,17 @@ function validateClientRequirements(document) {
             validateTasks(value, location, path, version);
           } else if (capability === 'extensions') {
             for (const extension of Object.keys(value)) {
-              if (usesMcpReservedPrefix(extension) && !knownReservedCapabilityExtensions.has(extension)) {
+              if (!usesMcpReservedPrefix(extension)) continue;
+              const maturity = mcpExtensionMaturity(extension);
+              if (maturity === 'official') continue;
+              if (maturity === 'experimental') {
+                diagnostics.push(semanticDiagnostic(
+                  'experimental-reserved-extension-identifier',
+                  'warning',
+                  `${location} contains experimental MCP extension ${JSON.stringify(extension)}; preserve it and review its maturity before relying on it`,
+                  [...path, extension]
+                ));
+              } else {
                 diagnostics.push(semanticDiagnostic(
                   'unknown-reserved-extension-identifier',
                   'warning',