@daniel.stefan/metalink 1.3.1

package/packages/core/dist/server/prompts.js

@@ -0,0 +1,405 @@
+/**
+ * MCP Prompts Module
+ *
+ * Provides built-in educational prompts for the Metalink 4-tool Speakeasy pattern.
+ * Implements MCP protocol prompts/list and prompts/get endpoints.
+ *
+ * v1.3.x: Consolidated to 2 documentation prompts (guide, safety).
+ * Executable skills are now provided via Claude Code user commands.
+ */
+/**
+ * Built-in prompt definitions
+ * v1.3.x: Consolidated to 2 documentation prompts
+ */
+const PROMPT_DEFINITIONS = [
+    {
+        name: 'guide',
+        description: 'Complete guide to using Metalink: the 4-tool workflow, searching, describing, and executing MCP tools',
+        arguments: [],
+    },
+    {
+        name: 'safety',
+        description: 'Understanding safe vs risky tool execution: when to use execute_tool vs execute_tool_confirm',
+        arguments: [],
+    },
+];
+/**
+ * Prompt template generators
+ */
+const PROMPT_TEMPLATES = {
+    'guide': () => {
+        return {
+            description: 'Complete Metalink 4-Tool Workflow Guide',
+            messages: [
+                {
+                    role: 'user',
+                    content: {
+                        type: 'text',
+                        text: 'How do I use Metalink to access MCP tools?',
+                    },
+                },
+                {
+                    role: 'assistant',
+                    content: {
+                        type: 'text',
+                        text: `# Metalink: Complete Guide
+
+## Overview
+
+Metalink uses a **4-tool Speakeasy pattern** for 97% token reduction:
+- \`search_tools\` - Find tools across all MCP servers
+- \`describe_tool\` - Get full schema and parameters
+- \`execute_tool\` - Run safe (read-only) tools
+- \`execute_tool_confirm\` - Run risky (write) tools with confirmation
+
+---
+
+## Step 1: Search for Tools
+
+Find tools matching your needs:
+
+\`\`\`json
+search_tools({ "query": "memory" })
+\`\`\`
+
+**Results include:**
+- \`server\`: Which MCP server provides the tool
+- \`tool\`: Tool name
+- \`safety\`: "safe" or "risky" (v1.3.x: top-level field)
+- \`execute_with\`: "execute_tool" or "execute_tool_confirm"
+- \`description\`: What the tool does
+- \`annotations.safetyReason\`: Why it's classified that way
+
+**Search strategies:**
+- Keywords: \`"search"\`, \`"create"\`, \`"memory"\`, \`"file"\`
+- Server-specific: \`search_tools({ "server_name": "memory" })\`
+- Multi-word: \`"memory search"\` matches server AND tool name
+
+---
+
+## Step 2: Describe the Tool
+
+Get complete schema before execution:
+
+\`\`\`json
+describe_tool({
+  "server_name": "memory",
+  "tool_name": "search_nodes"
+})
+\`\`\`
+
+**Response includes:**
+- \`inputSchema\`: Full JSON Schema for parameters
+- \`requiredParams\`: List of required parameter names
+- \`optionalParams\`: List of optional parameters
+- \`example\`: Sample usage (if available)
+
+---
+
+## Step 3: Execute the Tool
+
+### For SAFE tools (read-only):
+
+Check: \`safety: "safe"\` or \`execute_with: "execute_tool"\`
+
+\`\`\`json
+execute_tool({
+  "server_name": "memory",
+  "tool_name": "search_nodes",
+  "arguments": {
+    "query": "my search term"
+  }
+})
+\`\`\`
+
+### For RISKY tools (write/modify):
+
+Check: \`safety: "risky"\` or \`execute_with: "execute_tool_confirm"\`
+
+\`\`\`json
+execute_tool_confirm({
+  "server_name": "memory",
+  "tool_name": "create_entities",
+  "arguments": {
+    "entities": [{ "name": "Example", "entityType": "concept" }]
+  }
+})
+\`\`\`
+
+User must approve before execution.
+
+---
+
+## Quick Reference
+
+| Tool | Purpose | Safety |
+|------|---------|--------|
+| search_tools | Find tools | Always safe |
+| describe_tool | Get schema | Always safe |
+| execute_tool | Run tool | For safe tools only |
+| execute_tool_confirm | Run tool | For risky tools |
+
+---
+
+## Common Patterns
+
+**Memory/Knowledge:**
+\`\`\`
+search_tools({ "query": "memory" })
+→ search_nodes, create_entities, add_observations
+\`\`\`
+
+**Web/Research:**
+\`\`\`
+search_tools({ "query": "search web" })
+→ duckduckgo search, fetch content
+\`\`\`
+
+**Time/Utilities:**
+\`\`\`
+search_tools({ "query": "time" })
+→ get_current_time
+\`\`\`
+
+---
+
+## Error Handling
+
+**Missing parameters:**
+- Use describe_tool to see required fields
+- Check the example in describe response
+
+**Wrong safety level:**
+- If execute_tool blocks a tool, it's risky
+- Switch to execute_tool_confirm
+
+**Pagination:**
+- Add \`max_results: 10\` to limit results
+- Add \`max_result_chars: 10000\` to limit response size
+
+---
+
+## Server-Level Safety (v1.3.x)
+
+Servers can be configured as fully trusted:
+
+\`\`\`json
+{
+  "name": "memory",
+  "safety": "safe"  // All tools from this server are safe
+}
+\`\`\`
+
+Options:
+- \`"safe"\`: All tools auto-approved
+- \`"risky"\`: All tools need confirmation
+- \`"default"\`: Per-tool classification (normal behavior)
+
+---
+
+This is everything you need to use Metalink effectively!`,
+                    },
+                },
+            ],
+        };
+    },
+    'safety': () => {
+        return {
+            description: 'Safe vs Risky Tool Execution Guide',
+            messages: [
+                {
+                    role: 'user',
+                    content: {
+                        type: 'text',
+                        text: 'When should I use execute_tool vs execute_tool_confirm?',
+                    },
+                },
+                {
+                    role: 'assistant',
+                    content: {
+                        type: 'text',
+                        text: `# Understanding Tool Safety in Metalink
+
+## The Two Execution Tools
+
+### execute_tool (Auto-Approved)
+For **safe, read-only** operations that don't modify state.
+
+\`\`\`json
+execute_tool({
+  "server_name": "memory",
+  "tool_name": "search_nodes",
+  "arguments": { "query": "test" }
+})
+\`\`\`
+
+**Runs immediately without user confirmation.**
+
+---
+
+### execute_tool_confirm (Requires Confirmation)
+For **risky, write** operations that modify state.
+
+\`\`\`json
+execute_tool_confirm({
+  "server_name": "memory",
+  "tool_name": "create_entities",
+  "arguments": { "entities": [...] }
+})
+\`\`\`
+
+**User must approve before execution.**
+
+---
+
+## How Safety is Determined
+
+### 1. Search Results (v1.3.x - Top-Level Fields)
+
+\`\`\`json
+{
+  "tool": "create_entities",
+  "server": "memory",
+  "safety": "risky",                    // Top-level for easy access
+  "execute_with": "execute_tool_confirm", // Tells you which to use
+  "annotations": {
+    "safety": "risky",
+    "safetyReason": "Tool name matches risky pattern",
+    "requiresConfirmation": true
+  }
+}
+\`\`\`
+
+### 2. Server-Level Safety (v1.3.x)
+
+Servers can be configured as fully trusted:
+
+| Config | Meaning |
+|--------|---------|
+| \`safety: "safe"\` | All tools from this server are safe |
+| \`safety: "risky"\` | All tools need confirmation |
+| \`safety: "default"\` | Use tool-level classification |
+
+### 3. Tool Name Pattern Matching
+
+**Safe patterns (execute_tool):**
+- search, list, get, read, view, query, check, find, show, fetch
+
+**Risky patterns (execute_tool_confirm):**
+- create, update, delete, set, write, modify, remove, insert, add
+
+### 4. Explicit Overrides
+
+Some tools have explicit safe/risky overrides regardless of name:
+- \`memory:*\` tools may be explicitly safe
+- \`docs-server:*\` tools are explicitly safe
+- External APIs default to risky
+
+---
+
+## Safety Priority Order
+
+1. **Server-level safety** (highest) - If server has \`safety: "safe"\`
+2. **Explicit risky overrides** - Forced risky tools
+3. **Explicit safe overrides** - Forced safe tools
+4. **Argument inspection** - Some tools check argument content
+5. **Risky name patterns** - create, update, delete, etc.
+6. **Safe name patterns** - search, list, get, etc.
+7. **Default: risky** - Unknown tools require confirmation
+
+---
+
+## What Happens If You Use Wrong Tool?
+
+### execute_tool on risky tool:
+\`\`\`
+Error: Tool memory:create_entities is classified as RISKY
+Use 'execute_tool_confirm' instead.
+Reason: Tool name matches risky pattern (create, update, delete, etc.)
+\`\`\`
+
+### execute_tool_confirm on safe tool:
+Works fine, but unnecessary confirmation prompt.
+
+---
+
+## Best Practices
+
+1. **Check \`execute_with\` field** in search results
+2. **Use \`safety\` field** for quick classification
+3. **When unsure, use execute_tool_confirm** - it's always safe
+4. **Trust the error messages** - they tell you which to use
+
+---
+
+## Examples
+
+### Safe Tools (execute_tool):
+- \`memory:search_nodes\` - searches, doesn't modify
+- \`time:get_current_time\` - reads current time
+- \`duckduckgo:search\` - web search
+- \`docs-server:search_docs\` - documentation search
+
+### Risky Tools (execute_tool_confirm):
+- \`memory:create_entities\` - creates new data
+- \`memory:delete_entities\` - removes data
+- \`filesystem:write_file\` - modifies files
+- \`database:execute\` - runs mutations
+
+---
+
+## Quick Decision Flow
+
+\`\`\`
+1. Search for tool
+2. Check "execute_with" field in results
+3. If "execute_tool" → Use execute_tool
+4. If "execute_tool_confirm" → Use execute_tool_confirm
+5. If unsure → Use execute_tool_confirm (safe default)
+\`\`\`
+
+The safety classification protects against accidental data modification!`,
+                    },
+                },
+            ],
+        };
+    },
+};
+/**
+ * Get list of all available prompts
+ *
+ * @returns Array of prompt definitions for prompts/list response
+ */
+export function getPromptsList() {
+    return PROMPT_DEFINITIONS;
+}
+/**
+ * Get a specific prompt with arguments resolved
+ *
+ * @param name - Prompt identifier
+ * @param args - Argument key-value pairs
+ * @returns Rendered prompt with messages
+ * @throws Error if prompt not found or required arguments missing
+ */
+export function getPrompt(name, args = {}) {
+    // Validate prompt exists
+    const definition = PROMPT_DEFINITIONS.find(p => p.name === name);
+    if (!definition) {
+        throw new Error(`Prompt not found: ${name}`);
+    }
+    // Validate required arguments
+    const requiredArgs = definition.arguments?.filter(a => a.required) || [];
+    for (const arg of requiredArgs) {
+        if (!args[arg.name]) {
+            throw new Error(`Missing required argument: ${arg.name}`);
+        }
+    }
+    // Get template function
+    const template = PROMPT_TEMPLATES[name];
+    if (!template) {
+        throw new Error(`Prompt template not implemented: ${name}`);
+    }
+    // Render and return
+    return template(args);
+}
+//# sourceMappingURL=prompts.js.map

package/packages/core/dist/server/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../src/server/prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAqCH;;;GAGG;AACH,MAAM,kBAAkB,GAAuB;IAC7C;QACE,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,uGAAuG;QACpH,SAAS,EAAE,EAAE;KACd;IACD;QACE,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,8FAA8F;QAC3G,SAAS,EAAE,EAAE;KACd;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,gBAAgB,GAAqE;IACzF,OAAO,EAAE,GAAmB,EAAE;QAC5B,OAAO;YACL,WAAW,EAAE,yCAAyC;YACtD,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE;wBACP,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,4CAA4C;qBACnD;iBACF;gBACD;oBACE,IAAI,EAAE,WAAW;oBACjB,OAAO,EAAE;wBACP,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yDA2JuC;qBAC9C;iBACF;aACF;SACF,CAAC;IACJ,CAAC;IAED,QAAQ,EAAE,GAAmB,EAAE;QAC7B,OAAO;YACL,WAAW,EAAE,oCAAoC;YACjD,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE;wBACP,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,yDAAyD;qBAChE;iBACF;gBACD;oBACE,IAAI,EAAE,WAAW;oBACjB,OAAO,EAAE;wBACP,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yEA4IuD;qBAC9D;iBACF;aACF;SACF,CAAC;IACJ,CAAC;CACF,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,kBAAkB,CAAC;AAC5B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,OAA+B,EAAE;IACvE,yBAAyB;IACzB,MAAM,UAAU,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IACjE,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,8BAA8B;IAC9B,MAAM,YAAY,GAAG,UAAU,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IACzE,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;QAC/B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,8BAA8B,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAED,wBAAwB;IACxB,MAAM,QAAQ,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,oCAAoC,IAAI,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,oBAAoB;IACpB,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC"}

package/packages/core/dist/server/protocol-versions.d.ts

@@ -0,0 +1,49 @@
+/**
+ * v1.1.8: Protocol Versions Manager
+ * Manages MCP protocol version lifecycle and deprecation warnings
+ * Supports version tracking, EOL dates, and upgrade recommendations
+ */
+export interface ProtocolVersion {
+    version: string;
+    status: 'current' | 'deprecated' | 'legacy';
+    features: string[];
+    deprecatedDate?: Date;
+    eolDate?: Date;
+    upgradeTo?: string;
+    minorVersions?: string[];
+}
+export interface ProtocolCompliance {
+    requestVersion: string;
+    status: 'compliant' | 'deprecated' | 'legacy' | 'unsupported';
+    isDeprecated: boolean;
+    isLegacy: boolean;
+    daysUntilEOL?: number;
+    eolDate?: Date;
+    upgradeTo?: string;
+    warningMessage?: string;
+}
+/**
+ * Check protocol compliance
+ */
+export declare function checkProtocolCompliance(requestVersion: string): ProtocolCompliance;
+/**
+ * Get all protocol versions with status
+ */
+export declare function getAllProtocolVersions(): ProtocolVersion[];
+/**
+ * Get current protocol version
+ */
+export declare function getCurrentProtocolVersion(): string;
+/**
+ * Build response headers for protocol status
+ */
+export declare function buildProtocolHeaders(requestVersion: string): Record<string, string>;
+/**
+ * Format protocol status for logging
+ */
+export declare function formatProtocolStatus(compliance: ProtocolCompliance): string;
+/**
+ * Test helper: Create mock compliance result
+ */
+export declare function createMockCompliance(version: string, status: string): ProtocolCompliance;
+//# sourceMappingURL=protocol-versions.d.ts.map

package/packages/core/dist/server/protocol-versions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-versions.d.ts","sourceRoot":"","sources":["../../src/server/protocol-versions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,SAAS,GAAG,YAAY,GAAG,QAAQ,CAAC;IAC5C,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,cAAc,CAAC,EAAE,IAAI,CAAC;IACtB,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,WAAW,GAAG,YAAY,GAAG,QAAQ,GAAG,aAAa,CAAC;IAC9D,YAAY,EAAE,OAAO,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAiED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,cAAc,EAAE,MAAM,GAAG,kBAAkB,CA4ClF;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,eAAe,EAAE,CAE1D;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAElD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAmBnF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,kBAAkB,GAAG,MAAM,CAU3E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,kBAAkB,CASxF"}

package/packages/core/dist/server/protocol-versions.js

@@ -0,0 +1,173 @@
+/**
+ * v1.1.8: Protocol Versions Manager
+ * Manages MCP protocol version lifecycle and deprecation warnings
+ * Supports version tracking, EOL dates, and upgrade recommendations
+ */
+/**
+ * Protocol version registry
+ */
+const PROTOCOL_VERSIONS = {
+    '2025-11-25': {
+        version: '2025-11-25',
+        status: 'current',
+        features: [
+            'JSON-RPC 2.0 compliance',
+            'Session management (30min timeout)',
+            'Batch requests (sequential/parallel/hybrid)',
+            'Tool schema caching',
+            'Server auto-start',
+            'Client capability detection',
+            'Protocol deprecation warnings',
+            'Response headers: MCP-Protocol-Version, Mcp-Session-Id',
+            'Streamable HTTP transport'
+        ]
+    },
+    '2025-06-18': {
+        version: '2025-06-18',
+        status: 'current',
+        features: [
+            'JSON-RPC 2.0 compliance',
+            'Session management (30min timeout)',
+            'Batch requests (sequential/parallel/hybrid)',
+            'Tool schema caching',
+            'Server auto-start',
+            'Client capability detection',
+            'Protocol deprecation warnings',
+            'Response headers: MCP-Protocol-Version, Mcp-Session-Id'
+        ]
+    },
+    '2025-03-26': {
+        version: '2025-03-26',
+        status: 'deprecated',
+        deprecatedDate: new Date('2025-11-22'),
+        eolDate: new Date('2026-06-01'),
+        upgradeTo: '2025-11-25',
+        features: [
+            'JSON-RPC 2.0 compliance',
+            'Session management',
+            'Tool schema caching',
+            'Server auto-start'
+        ]
+    },
+    '2024-11-05': {
+        version: '2024-11-05',
+        status: 'legacy',
+        deprecatedDate: new Date('2025-06-01'),
+        eolDate: new Date('2025-12-01'),
+        upgradeTo: '2025-11-25',
+        features: [
+            'JSON-RPC 2.0 basic support',
+            'Tool list endpoint',
+            'Tool execution'
+        ]
+    }
+};
+/**
+ * Check protocol compliance
+ */
+export function checkProtocolCompliance(requestVersion) {
+    const versionInfo = PROTOCOL_VERSIONS[requestVersion];
+    if (!versionInfo) {
+        return {
+            requestVersion,
+            status: 'unsupported',
+            isDeprecated: false,
+            isLegacy: false,
+            upgradeTo: '2025-11-25',
+            warningMessage: `Protocol version ${requestVersion} is not supported. Current version: 2025-11-25`
+        };
+    }
+    const now = new Date();
+    const daysUntilEOL = versionInfo.eolDate
+        ? Math.ceil((versionInfo.eolDate.getTime() - now.getTime()) / (1000 * 60 * 60 * 24))
+        : undefined;
+    let status = 'compliant';
+    let warningMessage;
+    if (versionInfo.status === 'deprecated') {
+        status = 'deprecated';
+        warningMessage = `Protocol version ${requestVersion} is deprecated as of ${versionInfo.deprecatedDate?.toISOString().split('T')[0]}. ` +
+            `EOL: ${versionInfo.eolDate?.toISOString().split('T')[0]}. ` +
+            `Please upgrade to ${versionInfo.upgradeTo}`;
+    }
+    else if (versionInfo.status === 'legacy') {
+        status = 'legacy';
+        warningMessage = `Protocol version ${requestVersion} is legacy (deprecated since ${versionInfo.deprecatedDate?.toISOString().split('T')[0]}). ` +
+            `EOL: ${versionInfo.eolDate?.toISOString().split('T')[0]}. ` +
+            `URGENT: Upgrade to ${versionInfo.upgradeTo}`;
+    }
+    return {
+        requestVersion,
+        status,
+        isDeprecated: versionInfo.status === 'deprecated',
+        isLegacy: versionInfo.status === 'legacy',
+        daysUntilEOL,
+        eolDate: versionInfo.eolDate,
+        upgradeTo: versionInfo.upgradeTo,
+        warningMessage
+    };
+}
+/**
+ * Get all protocol versions with status
+ */
+export function getAllProtocolVersions() {
+    return Object.values(PROTOCOL_VERSIONS);
+}
+/**
+ * Get current protocol version
+ */
+export function getCurrentProtocolVersion() {
+    return '2025-11-25';
+}
+/**
+ * Build response headers for protocol status
+ */
+export function buildProtocolHeaders(requestVersion) {
+    const compliance = checkProtocolCompliance(requestVersion);
+    const headers = {
+        'MCP-Protocol-Version': getCurrentProtocolVersion()
+    };
+    if (compliance.isDeprecated) {
+        headers['X-MetaLink-Protocol-Status'] = 'deprecated';
+        if (compliance.daysUntilEOL !== undefined) {
+            headers['X-MetaLink-Protocol-EOL'] = compliance.eolDate?.toISOString().split('T')[0] || '';
+        }
+        headers['X-MetaLink-Upgrade-Available'] = compliance.upgradeTo || '';
+    }
+    else if (compliance.isLegacy) {
+        headers['X-MetaLink-Protocol-Status'] = 'legacy';
+        headers['X-MetaLink-Protocol-EOL'] = compliance.eolDate?.toISOString().split('T')[0] || '';
+        headers['X-MetaLink-Upgrade-Available'] = compliance.upgradeTo || '';
+    }
+    return headers;
+}
+/**
+ * Format protocol status for logging
+ */
+export function formatProtocolStatus(compliance) {
+    if (compliance.status === 'compliant') {
+        return `✅ Protocol ${compliance.requestVersion} compliant`;
+    }
+    else if (compliance.status === 'deprecated') {
+        return `⚠️  Protocol ${compliance.requestVersion} deprecated (EOL in ${compliance.daysUntilEOL} days)`;
+    }
+    else if (compliance.status === 'legacy') {
+        return `🔴 Protocol ${compliance.requestVersion} legacy (EOL in ${compliance.daysUntilEOL} days, UPGRADE REQUIRED)`;
+    }
+    else {
+        return `❌ Protocol ${compliance.requestVersion} unsupported`;
+    }
+}
+/**
+ * Test helper: Create mock compliance result
+ */
+export function createMockCompliance(version, status) {
+    return {
+        requestVersion: version,
+        status: status,
+        isDeprecated: status === 'deprecated',
+        isLegacy: status === 'legacy',
+        daysUntilEOL: status === 'deprecated' ? 180 : 0,
+        upgradeTo: status === 'deprecated' || status === 'legacy' ? '2025-11-25' : undefined
+    };
+}
+//# sourceMappingURL=protocol-versions.js.map

package/packages/core/dist/server/protocol-versions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-versions.js","sourceRoot":"","sources":["../../src/server/protocol-versions.ts"],"names":[],"mappings":"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"}