@kya-os/contracts 1.6.19 → 1.7.1

package/dist/well-known/index.js

@@ -9,7 +9,7 @@
  * @module @kya-os/contracts/well-known
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WellKnownResponseSchema = exports.WellKnownConfigSchema = exports.MCPIdentitySchema = exports.AgentDocumentSchema = exports.DIDDocumentSchema = exports.WellKnownPath = void 0;
+exports.WellKnownResponseSchema = exports.WellKnownConfigSchema = exports.MCPClientConfigSchema = exports.MCPServerConfigSchema = exports.MCPServerCardSchema = exports.MCPIdentitySchema = exports.AgentDocumentSchema = exports.DIDDocumentSchema = exports.WellKnownPath = void 0;
 exports.isDIDDocument = isDIDDocument;
 exports.isAgentDocument = isAgentDocument;
 exports.isMCPIdentity = isMCPIdentity;
@@ -18,6 +18,12 @@ exports.validateAgentDocument = validateAgentDocument;
 exports.validateMCPIdentity = validateMCPIdentity;
 exports.isWellKnownPath = isWellKnownPath;
 exports.getWellKnownContentType = getWellKnownContentType;
+exports.isMCPServerCard = isMCPServerCard;
+exports.validateMCPServerCard = validateMCPServerCard;
+exports.isMCPServerConfig = isMCPServerConfig;
+exports.validateMCPServerConfig = validateMCPServerConfig;
+exports.isMCPClientConfig = isMCPClientConfig;
+exports.validateMCPClientConfig = validateMCPClientConfig;
 const zod_1 = require("zod");
 /**
  * Well-known endpoint paths
@@ -28,6 +34,12 @@ var WellKnownPath;
     WellKnownPath["AGENT_DOCUMENT"] = "/.well-known/agent.json";
     WellKnownPath["MCP_IDENTITY"] = "/.well-known/mcp-identity";
     WellKnownPath["TOOL_PROTECTIONS"] = "/.well-known/tool-protections.json";
+    /** SEP-1649 MCP Server Card (current usage by Cursor/Claude Desktop) */
+    WellKnownPath["MCP_SERVER_CONFIG"] = "/.well-known/mcp.json";
+    /** SEP-1649 MCP Server Card (proposed spec path) */
+    WellKnownPath["MCP_SERVER_CARD"] = "/.well-known/mcp/server-card.json";
+    /** Client configuration helper (Cursor/Claude Desktop ready-to-use config) */
+    WellKnownPath["MCP_CLIENT_CONFIG"] = "/.well-known/mcp-client-config.json";
 })(WellKnownPath || (exports.WellKnownPath = WellKnownPath = {}));
 /**
  * Zod Schemas for Validation
@@ -73,9 +85,128 @@ exports.MCPIdentitySchema = zod_1.z.object({
     timestamp: zod_1.z.number(),
     metadata: zod_1.z.record(zod_1.z.unknown()).optional()
 });
+/** SEP-1649 MCP Server Card Schema */
+exports.MCPServerCardSchema = zod_1.z.object({
+    $schema: zod_1.z.string().optional(),
+    version: zod_1.z.string(),
+    protocolVersion: zod_1.z.string(),
+    serverInfo: zod_1.z.object({
+        name: zod_1.z.string(),
+        title: zod_1.z.string().optional(),
+        version: zod_1.z.string()
+    }),
+    description: zod_1.z.string().optional(),
+    iconUrl: zod_1.z.string().optional(),
+    documentationUrl: zod_1.z.string().optional(),
+    transport: zod_1.z.object({
+        type: zod_1.z.enum(['streamable-http', 'sse', 'stdio']),
+        endpoint: zod_1.z.string()
+    }),
+    capabilities: zod_1.z.object({
+        tools: zod_1.z.object({ listChanged: zod_1.z.boolean().optional() }).optional(),
+        prompts: zod_1.z.object({ listChanged: zod_1.z.boolean().optional() }).optional(),
+        resources: zod_1.z.object({
+            subscribe: zod_1.z.boolean().optional(),
+            listChanged: zod_1.z.boolean().optional()
+        }).optional(),
+        logging: zod_1.z.record(zod_1.z.unknown()).optional(),
+        completions: zod_1.z.record(zod_1.z.unknown()).optional(),
+        experimental: zod_1.z.record(zod_1.z.unknown()).optional()
+    }).optional(),
+    requires: zod_1.z.object({
+        sampling: zod_1.z.record(zod_1.z.unknown()).optional(),
+        roots: zod_1.z.record(zod_1.z.unknown()).optional(),
+        elicitation: zod_1.z.record(zod_1.z.unknown()).optional(),
+        experimental: zod_1.z.record(zod_1.z.unknown()).optional()
+    }).optional(),
+    authentication: zod_1.z.object({
+        required: zod_1.z.boolean(),
+        schemes: zod_1.z.array(zod_1.z.string())
+    }).optional(),
+    instructions: zod_1.z.string().optional(),
+    resources: zod_1.z.union([
+        zod_1.z.literal('dynamic'),
+        zod_1.z.array(zod_1.z.object({
+            name: zod_1.z.string(),
+            title: zod_1.z.string().optional(),
+            uri: zod_1.z.string(),
+            description: zod_1.z.string().optional(),
+            mimeType: zod_1.z.string().optional()
+        }))
+    ]).optional(),
+    tools: zod_1.z.union([
+        zod_1.z.literal('dynamic'),
+        zod_1.z.array(zod_1.z.object({
+            name: zod_1.z.string(),
+            title: zod_1.z.string().optional(),
+            description: zod_1.z.string().optional(),
+            inputSchema: zod_1.z.record(zod_1.z.unknown()).optional()
+        }))
+    ]).optional(),
+    prompts: zod_1.z.union([
+        zod_1.z.literal('dynamic'),
+        zod_1.z.array(zod_1.z.object({
+            name: zod_1.z.string(),
+            title: zod_1.z.string().optional(),
+            description: zod_1.z.string().optional(),
+            arguments: zod_1.z.array(zod_1.z.object({
+                name: zod_1.z.string(),
+                description: zod_1.z.string().optional(),
+                required: zod_1.z.boolean().optional()
+            })).optional()
+        }))
+    ]).optional(),
+    _meta: zod_1.z.record(zod_1.z.unknown()).optional()
+});
+/** Legacy MCP Server Config Schema */
+exports.MCPServerConfigSchema = zod_1.z.object({
+    name: zod_1.z.string(),
+    description: zod_1.z.string().optional(),
+    url: zod_1.z.string(),
+    transport: zod_1.z.enum(['sse', 'stdio', 'http']),
+    version: zod_1.z.string().optional(),
+    agentDid: zod_1.z.string().optional(),
+    capabilities: zod_1.z.array(zod_1.z.string()).optional(),
+    requiresAuth: zod_1.z.boolean().optional(),
+    authProvider: zod_1.z.string().optional(),
+    metadata: zod_1.z.record(zod_1.z.unknown()).optional()
+});
+/** MCP Client Config Schema */
+exports.MCPClientConfigSchema = zod_1.z.object({
+    claudeDesktop: zod_1.z.object({
+        mcpServers: zod_1.z.record(zod_1.z.object({
+            url: zod_1.z.string(),
+            transport: zod_1.z.literal('sse').optional()
+        }))
+    }),
+    cursor: zod_1.z.object({
+        mcpServers: zod_1.z.record(zod_1.z.object({
+            url: zod_1.z.string(),
+            transport: zod_1.z.literal('sse').optional()
+        }))
+    }),
+    cursorDeepLink: zod_1.z.string().optional(),
+    _meta: zod_1.z.object({
+        serverName: zod_1.z.string().optional(),
+        serverUrl: zod_1.z.string().optional(),
+        mcpEndpoint: zod_1.z.string().optional(),
+        agentDid: zod_1.z.string().optional(),
+        generatedAt: zod_1.z.number().optional(),
+        instructions: zod_1.z.string().optional()
+    }).catchall(zod_1.z.unknown()).optional()
+});
 exports.WellKnownConfigSchema = zod_1.z.object({
     serviceName: zod_1.z.string().optional(),
+    serviceTitle: zod_1.z.string().optional(),
     serviceEndpoint: zod_1.z.string().optional(),
+    description: zod_1.z.string().optional(),
+    serverVersion: zod_1.z.string().optional(),
+    protocolVersion: zod_1.z.string().optional(),
+    iconUrl: zod_1.z.string().optional(),
+    documentationUrl: zod_1.z.string().optional(),
+    requiresAuth: zod_1.z.boolean().optional(),
+    authSchemes: zod_1.z.array(zod_1.z.string()).optional(),
+    instructions: zod_1.z.string().optional(),
     metadata: zod_1.z.record(zod_1.z.unknown()).optional()
 });
 exports.WellKnownResponseSchema = zod_1.z.object({
@@ -125,6 +256,7 @@ function getWellKnownContentType(path) {
             return 'application/did+json';
         case WellKnownPath.AGENT_DOCUMENT:
         case WellKnownPath.TOOL_PROTECTIONS:
+        case WellKnownPath.MCP_SERVER_CONFIG:
             return 'application/json';
         case WellKnownPath.MCP_IDENTITY:
             return 'application/json';
@@ -132,3 +264,39 @@ function getWellKnownContentType(path) {
             return 'application/json';
     }
 }
+/**
+ * Type guard for MCPServerCard (SEP-1649)
+ */
+function isMCPServerCard(obj) {
+    return exports.MCPServerCardSchema.safeParse(obj).success;
+}
+/**
+ * Validation function for MCPServerCard (SEP-1649)
+ */
+function validateMCPServerCard(obj) {
+    return exports.MCPServerCardSchema.parse(obj);
+}
+/**
+ * Type guard for MCPServerConfig (legacy)
+ */
+function isMCPServerConfig(obj) {
+    return exports.MCPServerConfigSchema.safeParse(obj).success;
+}
+/**
+ * Validation function for MCPServerConfig (legacy)
+ */
+function validateMCPServerConfig(obj) {
+    return exports.MCPServerConfigSchema.parse(obj);
+}
+/**
+ * Type guard for MCPClientConfig
+ */
+function isMCPClientConfig(obj) {
+    return exports.MCPClientConfigSchema.safeParse(obj).success;
+}
+/**
+ * Validation function for MCPClientConfig
+ */
+function validateMCPClientConfig(obj) {
+    return exports.MCPClientConfigSchema.parse(obj);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kya-os/contracts",
-  "version": "1.6.19",
+  "version": "1.7.1",
   "description": "Shared contracts, types, and schemas for MCP-I framework",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -95,6 +95,7 @@
   },
   "sideEffects": false,
   "dependencies": {
+    "@kya-os/consent": "^0.1.2",
     "zod": "^3.25.76"
   },
   "devDependencies": {