@kya-os/cli 2.0.0 → 2.0.3

package/node_modules/@kya-os/contracts/dist/well-known/index.d.ts

@@ -0,0 +1,1013 @@
+/**
+ * MCP-I Well-Known Endpoints Specification
+ *
+ * This module defines the types for well-known endpoints as specified in the
+ * MCP-I protocol. These endpoints provide identity discovery and verification
+ * capabilities for MCP-I agents.
+ *
+ * @module @kya-os/contracts/well-known
+ */
+import { z } from 'zod';
+/**
+ * DID Document as per W3C DID specification
+ * Returned from /.well-known/did.json
+ */
+export interface DIDDocument {
+    '@context': string[];
+    id: string;
+    verificationMethod: Array<{
+        id: string;
+        type: string;
+        controller: string;
+        publicKeyBase64?: string;
+        publicKeyMultibase?: string;
+    }>;
+    authentication?: string[];
+    assertionMethod?: string[];
+    capabilityInvocation?: string[];
+    capabilityDelegation?: string[];
+    keyAgreement?: string[];
+    service?: Array<{
+        id: string;
+        type: string;
+        serviceEndpoint: string;
+    }>;
+}
+/**
+ * Agent Document for MCP-I capability discovery
+ * Returned from /.well-known/agent.json
+ */
+export interface AgentDocument {
+    /** The agent's DID */
+    id: string;
+    /** Capabilities supported by this agent */
+    capabilities: {
+        'mcp-i': Array<'handshake' | 'signing' | 'verification' | 'delegation' | 'proof-generation'>;
+        [key: string]: string[];
+    };
+    /** Optional metadata about the agent */
+    metadata?: {
+        name?: string;
+        serviceEndpoint?: string;
+        version?: string;
+        description?: string;
+    };
+}
+/**
+ * MCP Identity information
+ * Returned from /.well-known/mcp-identity
+ */
+export interface MCPIdentity {
+    /** The agent's DID */
+    did: string;
+    /** The agent's public key */
+    publicKey: string;
+    /** Service name */
+    serviceName: string;
+    /** Service endpoint URL */
+    serviceEndpoint: string;
+    /** Timestamp of when this was generated */
+    timestamp: number;
+    /** Optional additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * MCP Server Card (SEP-1649)
+ * Returned from /.well-known/mcp.json
+ *
+ * This enables MCP clients to automatically discover server capabilities,
+ * available transports, authentication requirements, and protocol versions
+ * before establishing a connection.
+ *
+ * @see https://github.com/modelcontextprotocol/modelcontextprotocol/issues/1649
+ */
+export interface MCPServerCard {
+    /** URL to the JSON schema definition */
+    $schema?: string;
+    /** Schema version for the server card document (e.g., "1.0") */
+    version: string;
+    /** The MCP protocol version the server supports (e.g., "2025-06-18") */
+    protocolVersion: string;
+    /** Server identification */
+    serverInfo: {
+        /** Server identifier for programmatic use */
+        name: string;
+        /** Human-readable server display name */
+        title?: string;
+        /** Server software version */
+        version: string;
+    };
+    /** Human-readable description of the server */
+    description?: string;
+    /** URL to an icon representing the server */
+    iconUrl?: string;
+    /** URL to the server's documentation */
+    documentationUrl?: string;
+    /** Transport configuration */
+    transport: {
+        /** Transport type (streamable-http, sse, stdio) */
+        type: 'streamable-http' | 'sse' | 'stdio';
+        /** Transport endpoint path (e.g., "/mcp") */
+        endpoint: string;
+    };
+    /** Server capabilities */
+    capabilities?: {
+        tools?: {
+            listChanged?: boolean;
+        };
+        prompts?: {
+            listChanged?: boolean;
+        };
+        resources?: {
+            subscribe?: boolean;
+            listChanged?: boolean;
+        };
+        logging?: Record<string, unknown>;
+        completions?: Record<string, unknown>;
+        experimental?: Record<string, unknown>;
+    };
+    /** Required client capabilities */
+    requires?: {
+        sampling?: Record<string, unknown>;
+        roots?: Record<string, unknown>;
+        elicitation?: Record<string, unknown>;
+        experimental?: Record<string, unknown>;
+    };
+    /** Authentication requirements */
+    authentication?: {
+        /** Whether authentication is mandatory */
+        required: boolean;
+        /** Supported authentication schemes */
+        schemes: Array<'bearer' | 'oauth2' | 'basic' | string>;
+    };
+    /** Usage instructions for the server */
+    instructions?: string;
+    /** Resource definitions - "dynamic" or array of resources */
+    resources?: 'dynamic' | Array<{
+        name: string;
+        title?: string;
+        uri: string;
+        description?: string;
+        mimeType?: string;
+    }>;
+    /** Tool definitions - "dynamic" or array of tools */
+    tools?: 'dynamic' | Array<{
+        name: string;
+        title?: string;
+        description?: string;
+        inputSchema?: Record<string, unknown>;
+    }>;
+    /** Prompt definitions - "dynamic" or array of prompts */
+    prompts?: 'dynamic' | Array<{
+        name: string;
+        title?: string;
+        description?: string;
+        arguments?: Array<{
+            name: string;
+            description?: string;
+            required?: boolean;
+        }>;
+    }>;
+    /** Additional metadata */
+    _meta?: Record<string, unknown>;
+}
+/**
+ * MCP Server Configuration (Legacy/Simplified format)
+ * @deprecated Use MCPServerCard for SEP-1649 compliance
+ */
+export interface MCPServerConfig {
+    /** Server name for display in client UI */
+    name: string;
+    /** Server description */
+    description?: string;
+    /** MCP protocol endpoint URL (typically /mcp) */
+    url: string;
+    /** Transport type - "sse" for Server-Sent Events (Streamable HTTP) */
+    transport: 'sse' | 'stdio' | 'http';
+    /** MCP-I protocol version */
+    version?: string;
+    /** Agent's DID for identity verification */
+    agentDid?: string;
+    /** Supported capabilities */
+    capabilities?: string[];
+    /** Whether this server requires authentication */
+    requiresAuth?: boolean;
+    /** OAuth provider for authentication (if requiresAuth is true) */
+    authProvider?: string;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Client Configuration for Cursor/Claude Desktop
+ * Returned from /.well-known/mcp-client-config.json
+ *
+ * Returns ready-to-use configuration that can be copy-pasted into
+ * client configuration files.
+ */
+export interface MCPClientConfig {
+    /** Configuration for Claude Desktop (claude_desktop_config.json) */
+    claudeDesktop: {
+        mcpServers: Record<string, {
+            url: string;
+            transport?: 'sse';
+        }>;
+    };
+    /** Configuration for Cursor (.cursor/mcp.json) */
+    cursor: {
+        mcpServers: Record<string, {
+            url: string;
+            transport?: 'sse';
+        }>;
+    };
+    /** Deep link for one-click Cursor installation */
+    cursorDeepLink?: string;
+    /** Additional metadata (server info, agent DID, etc.) */
+    _meta?: {
+        serverName?: string;
+        serverUrl?: string;
+        mcpEndpoint?: string;
+        agentDid?: string;
+        generatedAt?: number;
+        instructions?: string;
+        [key: string]: unknown;
+    };
+}
+/**
+ * Well-known endpoint handler configuration
+ */
+export interface WellKnownConfig {
+    /** Service name to advertise (programmatic identifier) */
+    serviceName?: string;
+    /** Human-readable display title */
+    serviceTitle?: string;
+    /** Service endpoint URL (base URL, e.g., https://example.com) */
+    serviceEndpoint?: string;
+    /** Server description */
+    description?: string;
+    /** Server software version */
+    serverVersion?: string;
+    /** MCP protocol version (e.g., "2025-06-18") */
+    protocolVersion?: string;
+    /** URL to server icon */
+    iconUrl?: string;
+    /** URL to documentation */
+    documentationUrl?: string;
+    /** Whether authentication is required */
+    requiresAuth?: boolean;
+    /** Supported authentication schemes */
+    authSchemes?: Array<'bearer' | 'oauth2' | 'basic' | string>;
+    /** Usage instructions */
+    instructions?: string;
+    /** Additional metadata to include */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Well-known endpoint response
+ */
+export interface WellKnownResponse {
+    status: number;
+    headers: Record<string, string>;
+    body: string;
+}
+/**
+ * Well-known endpoint paths
+ */
+export declare enum WellKnownPath {
+    DID_DOCUMENT = "/.well-known/did.json",
+    AGENT_DOCUMENT = "/.well-known/agent.json",
+    MCP_IDENTITY = "/.well-known/mcp-identity",
+    TOOL_PROTECTIONS = "/.well-known/tool-protections.json",
+    /** SEP-1649 MCP Server Card (current usage by Cursor/Claude Desktop) */
+    MCP_SERVER_CONFIG = "/.well-known/mcp.json",
+    /** SEP-1649 MCP Server Card (proposed spec path) */
+    MCP_SERVER_CARD = "/.well-known/mcp/server-card.json",
+    /** Client configuration helper (Cursor/Claude Desktop ready-to-use config) */
+    MCP_CLIENT_CONFIG = "/.well-known/mcp-client-config.json"
+}
+/**
+ * Zod Schemas for Validation
+ */
+export declare const DIDDocumentSchema: z.ZodObject<{
+    '@context': z.ZodArray<z.ZodString, "many">;
+    id: z.ZodString;
+    verificationMethod: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodString;
+        controller: z.ZodString;
+        publicKeyBase64: z.ZodOptional<z.ZodString>;
+        publicKeyMultibase: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: string;
+        id: string;
+        controller: string;
+        publicKeyMultibase?: string | undefined;
+        publicKeyBase64?: string | undefined;
+    }, {
+        type: string;
+        id: string;
+        controller: string;
+        publicKeyMultibase?: string | undefined;
+        publicKeyBase64?: string | undefined;
+    }>, "many">;
+    authentication: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    assertionMethod: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    capabilityInvocation: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    capabilityDelegation: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    keyAgreement: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    service: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodString;
+        serviceEndpoint: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: string;
+        id: string;
+        serviceEndpoint: string;
+    }, {
+        type: string;
+        id: string;
+        serviceEndpoint: string;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    verificationMethod: {
+        type: string;
+        id: string;
+        controller: string;
+        publicKeyMultibase?: string | undefined;
+        publicKeyBase64?: string | undefined;
+    }[];
+    '@context': string[];
+    authentication?: string[] | undefined;
+    assertionMethod?: string[] | undefined;
+    keyAgreement?: string[] | undefined;
+    capabilityInvocation?: string[] | undefined;
+    capabilityDelegation?: string[] | undefined;
+    service?: {
+        type: string;
+        id: string;
+        serviceEndpoint: string;
+    }[] | undefined;
+}, {
+    id: string;
+    verificationMethod: {
+        type: string;
+        id: string;
+        controller: string;
+        publicKeyMultibase?: string | undefined;
+        publicKeyBase64?: string | undefined;
+    }[];
+    '@context': string[];
+    authentication?: string[] | undefined;
+    assertionMethod?: string[] | undefined;
+    keyAgreement?: string[] | undefined;
+    capabilityInvocation?: string[] | undefined;
+    capabilityDelegation?: string[] | undefined;
+    service?: {
+        type: string;
+        id: string;
+        serviceEndpoint: string;
+    }[] | undefined;
+}>;
+export declare const AgentDocumentSchema: z.ZodObject<{
+    id: z.ZodString;
+    capabilities: z.ZodObject<{
+        'mcp-i': z.ZodArray<z.ZodEnum<["handshake", "signing", "verification", "delegation", "proof-generation"]>, "many">;
+    }, "strip", z.ZodArray<z.ZodString, "many">, z.objectOutputType<{
+        'mcp-i': z.ZodArray<z.ZodEnum<["handshake", "signing", "verification", "delegation", "proof-generation"]>, "many">;
+    }, z.ZodArray<z.ZodString, "many">, "strip">, z.objectInputType<{
+        'mcp-i': z.ZodArray<z.ZodEnum<["handshake", "signing", "verification", "delegation", "proof-generation"]>, "many">;
+    }, z.ZodArray<z.ZodString, "many">, "strip">>;
+    metadata: z.ZodOptional<z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        serviceEndpoint: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        name?: string | undefined;
+        version?: string | undefined;
+        description?: string | undefined;
+        serviceEndpoint?: string | undefined;
+    }, {
+        name?: string | undefined;
+        version?: string | undefined;
+        description?: string | undefined;
+        serviceEndpoint?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    capabilities: {
+        'mcp-i': ("verification" | "handshake" | "signing" | "delegation" | "proof-generation")[];
+    } & {
+        [k: string]: string[];
+    };
+    metadata?: {
+        name?: string | undefined;
+        version?: string | undefined;
+        description?: string | undefined;
+        serviceEndpoint?: string | undefined;
+    } | undefined;
+}, {
+    id: string;
+    capabilities: {
+        'mcp-i': ("verification" | "handshake" | "signing" | "delegation" | "proof-generation")[];
+    } & {
+        [k: string]: string[];
+    };
+    metadata?: {
+        name?: string | undefined;
+        version?: string | undefined;
+        description?: string | undefined;
+        serviceEndpoint?: string | undefined;
+    } | undefined;
+}>;
+export declare const MCPIdentitySchema: z.ZodObject<{
+    did: z.ZodString;
+    publicKey: z.ZodString;
+    serviceName: z.ZodString;
+    serviceEndpoint: z.ZodString;
+    timestamp: z.ZodNumber;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    timestamp: number;
+    did: string;
+    publicKey: string;
+    serviceEndpoint: string;
+    serviceName: string;
+    metadata?: Record<string, unknown> | undefined;
+}, {
+    timestamp: number;
+    did: string;
+    publicKey: string;
+    serviceEndpoint: string;
+    serviceName: string;
+    metadata?: Record<string, unknown> | undefined;
+}>;
+/** SEP-1649 MCP Server Card Schema */
+export declare const MCPServerCardSchema: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodString>;
+    version: z.ZodString;
+    protocolVersion: z.ZodString;
+    serverInfo: z.ZodObject<{
+        name: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        version: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        version: string;
+        title?: string | undefined;
+    }, {
+        name: string;
+        version: string;
+        title?: string | undefined;
+    }>;
+    description: z.ZodOptional<z.ZodString>;
+    iconUrl: z.ZodOptional<z.ZodString>;
+    documentationUrl: z.ZodOptional<z.ZodString>;
+    transport: z.ZodObject<{
+        type: z.ZodEnum<["streamable-http", "sse", "stdio"]>;
+        endpoint: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "streamable-http" | "sse" | "stdio";
+        endpoint: string;
+    }, {
+        type: "streamable-http" | "sse" | "stdio";
+        endpoint: string;
+    }>;
+    capabilities: z.ZodOptional<z.ZodObject<{
+        tools: z.ZodOptional<z.ZodObject<{
+            listChanged: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            listChanged?: boolean | undefined;
+        }, {
+            listChanged?: boolean | undefined;
+        }>>;
+        prompts: z.ZodOptional<z.ZodObject<{
+            listChanged: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            listChanged?: boolean | undefined;
+        }, {
+            listChanged?: boolean | undefined;
+        }>>;
+        resources: z.ZodOptional<z.ZodObject<{
+            subscribe: z.ZodOptional<z.ZodBoolean>;
+            listChanged: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            listChanged?: boolean | undefined;
+            subscribe?: boolean | undefined;
+        }, {
+            listChanged?: boolean | undefined;
+            subscribe?: boolean | undefined;
+        }>>;
+        logging: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        completions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        experimental: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        tools?: {
+            listChanged?: boolean | undefined;
+        } | undefined;
+        prompts?: {
+            listChanged?: boolean | undefined;
+        } | undefined;
+        resources?: {
+            listChanged?: boolean | undefined;
+            subscribe?: boolean | undefined;
+        } | undefined;
+        logging?: Record<string, unknown> | undefined;
+        completions?: Record<string, unknown> | undefined;
+        experimental?: Record<string, unknown> | undefined;
+    }, {
+        tools?: {
+            listChanged?: boolean | undefined;
+        } | undefined;
+        prompts?: {
+            listChanged?: boolean | undefined;
+        } | undefined;
+        resources?: {
+            listChanged?: boolean | undefined;
+            subscribe?: boolean | undefined;
+        } | undefined;
+        logging?: Record<string, unknown> | undefined;
+        completions?: Record<string, unknown> | undefined;
+        experimental?: Record<string, unknown> | undefined;
+    }>>;
+    requires: z.ZodOptional<z.ZodObject<{
+        sampling: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        roots: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        elicitation: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        experimental: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        experimental?: Record<string, unknown> | undefined;
+        sampling?: Record<string, unknown> | undefined;
+        roots?: Record<string, unknown> | undefined;
+        elicitation?: Record<string, unknown> | undefined;
+    }, {
+        experimental?: Record<string, unknown> | undefined;
+        sampling?: Record<string, unknown> | undefined;
+        roots?: Record<string, unknown> | undefined;
+        elicitation?: Record<string, unknown> | undefined;
+    }>>;
+    authentication: z.ZodOptional<z.ZodObject<{
+        required: z.ZodBoolean;
+        schemes: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        required: boolean;
+        schemes: string[];
+    }, {
+        required: boolean;
+        schemes: string[];
+    }>>;
+    instructions: z.ZodOptional<z.ZodString>;
+    resources: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<"dynamic">, z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        uri: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        mimeType: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        uri: string;
+        title?: string | undefined;
+        description?: string | undefined;
+        mimeType?: string | undefined;
+    }, {
+        name: string;
+        uri: string;
+        title?: string | undefined;
+        description?: string | undefined;
+        mimeType?: string | undefined;
+    }>, "many">]>>;
+    tools: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<"dynamic">, z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        inputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        title?: string | undefined;
+        description?: string | undefined;
+        inputSchema?: Record<string, unknown> | undefined;
+    }, {
+        name: string;
+        title?: string | undefined;
+        description?: string | undefined;
+        inputSchema?: Record<string, unknown> | undefined;
+    }>, "many">]>>;
+    prompts: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<"dynamic">, z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        arguments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            required: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            required?: boolean | undefined;
+            description?: string | undefined;
+        }, {
+            name: string;
+            required?: boolean | undefined;
+            description?: string | undefined;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        title?: string | undefined;
+        description?: string | undefined;
+        arguments?: {
+            name: string;
+            required?: boolean | undefined;
+            description?: string | undefined;
+        }[] | undefined;
+    }, {
+        name: string;
+        title?: string | undefined;
+        description?: string | undefined;
+        arguments?: {
+            name: string;
+            required?: boolean | undefined;
+            description?: string | undefined;
+        }[] | undefined;
+    }>, "many">]>>;
+    _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    version: string;
+    protocolVersion: string;
+    transport: {
+        type: "streamable-http" | "sse" | "stdio";
+        endpoint: string;
+    };
+    serverInfo: {
+        name: string;
+        version: string;
+        title?: string | undefined;
+    };
+    tools?: "dynamic" | {
+        name: string;
+        title?: string | undefined;
+        description?: string | undefined;
+        inputSchema?: Record<string, unknown> | undefined;
+    }[] | undefined;
+    capabilities?: {
+        tools?: {
+            listChanged?: boolean | undefined;
+        } | undefined;
+        prompts?: {
+            listChanged?: boolean | undefined;
+        } | undefined;
+        resources?: {
+            listChanged?: boolean | undefined;
+            subscribe?: boolean | undefined;
+        } | undefined;
+        logging?: Record<string, unknown> | undefined;
+        completions?: Record<string, unknown> | undefined;
+        experimental?: Record<string, unknown> | undefined;
+    } | undefined;
+    $schema?: string | undefined;
+    description?: string | undefined;
+    _meta?: Record<string, unknown> | undefined;
+    authentication?: {
+        required: boolean;
+        schemes: string[];
+    } | undefined;
+    instructions?: string | undefined;
+    iconUrl?: string | undefined;
+    documentationUrl?: string | undefined;
+    prompts?: "dynamic" | {
+        name: string;
+        title?: string | undefined;
+        description?: string | undefined;
+        arguments?: {
+            name: string;
+            required?: boolean | undefined;
+            description?: string | undefined;
+        }[] | undefined;
+    }[] | undefined;
+    resources?: "dynamic" | {
+        name: string;
+        uri: string;
+        title?: string | undefined;
+        description?: string | undefined;
+        mimeType?: string | undefined;
+    }[] | undefined;
+    requires?: {
+        experimental?: Record<string, unknown> | undefined;
+        sampling?: Record<string, unknown> | undefined;
+        roots?: Record<string, unknown> | undefined;
+        elicitation?: Record<string, unknown> | undefined;
+    } | undefined;
+}, {
+    version: string;
+    protocolVersion: string;
+    transport: {
+        type: "streamable-http" | "sse" | "stdio";
+        endpoint: string;
+    };
+    serverInfo: {
+        name: string;
+        version: string;
+        title?: string | undefined;
+    };
+    tools?: "dynamic" | {
+        name: string;
+        title?: string | undefined;
+        description?: string | undefined;
+        inputSchema?: Record<string, unknown> | undefined;
+    }[] | undefined;
+    capabilities?: {
+        tools?: {
+            listChanged?: boolean | undefined;
+        } | undefined;
+        prompts?: {
+            listChanged?: boolean | undefined;
+        } | undefined;
+        resources?: {
+            listChanged?: boolean | undefined;
+            subscribe?: boolean | undefined;
+        } | undefined;
+        logging?: Record<string, unknown> | undefined;
+        completions?: Record<string, unknown> | undefined;
+        experimental?: Record<string, unknown> | undefined;
+    } | undefined;
+    $schema?: string | undefined;
+    description?: string | undefined;
+    _meta?: Record<string, unknown> | undefined;
+    authentication?: {
+        required: boolean;
+        schemes: string[];
+    } | undefined;
+    instructions?: string | undefined;
+    iconUrl?: string | undefined;
+    documentationUrl?: string | undefined;
+    prompts?: "dynamic" | {
+        name: string;
+        title?: string | undefined;
+        description?: string | undefined;
+        arguments?: {
+            name: string;
+            required?: boolean | undefined;
+            description?: string | undefined;
+        }[] | undefined;
+    }[] | undefined;
+    resources?: "dynamic" | {
+        name: string;
+        uri: string;
+        title?: string | undefined;
+        description?: string | undefined;
+        mimeType?: string | undefined;
+    }[] | undefined;
+    requires?: {
+        experimental?: Record<string, unknown> | undefined;
+        sampling?: Record<string, unknown> | undefined;
+        roots?: Record<string, unknown> | undefined;
+        elicitation?: Record<string, unknown> | undefined;
+    } | undefined;
+}>;
+/** Legacy MCP Server Config Schema */
+export declare const MCPServerConfigSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    url: z.ZodString;
+    transport: z.ZodEnum<["sse", "stdio", "http"]>;
+    version: z.ZodOptional<z.ZodString>;
+    agentDid: z.ZodOptional<z.ZodString>;
+    capabilities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    requiresAuth: z.ZodOptional<z.ZodBoolean>;
+    authProvider: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    url: string;
+    transport: "sse" | "stdio" | "http";
+    agentDid?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    version?: string | undefined;
+    capabilities?: string[] | undefined;
+    description?: string | undefined;
+    requiresAuth?: boolean | undefined;
+    authProvider?: string | undefined;
+}, {
+    name: string;
+    url: string;
+    transport: "sse" | "stdio" | "http";
+    agentDid?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    version?: string | undefined;
+    capabilities?: string[] | undefined;
+    description?: string | undefined;
+    requiresAuth?: boolean | undefined;
+    authProvider?: string | undefined;
+}>;
+/** MCP Client Config Schema */
+export declare const MCPClientConfigSchema: z.ZodObject<{
+    claudeDesktop: z.ZodObject<{
+        mcpServers: z.ZodRecord<z.ZodString, z.ZodObject<{
+            url: z.ZodString;
+            transport: z.ZodOptional<z.ZodLiteral<"sse">>;
+        }, "strip", z.ZodTypeAny, {
+            url: string;
+            transport?: "sse" | undefined;
+        }, {
+            url: string;
+            transport?: "sse" | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        mcpServers: Record<string, {
+            url: string;
+            transport?: "sse" | undefined;
+        }>;
+    }, {
+        mcpServers: Record<string, {
+            url: string;
+            transport?: "sse" | undefined;
+        }>;
+    }>;
+    cursor: z.ZodObject<{
+        mcpServers: z.ZodRecord<z.ZodString, z.ZodObject<{
+            url: z.ZodString;
+            transport: z.ZodOptional<z.ZodLiteral<"sse">>;
+        }, "strip", z.ZodTypeAny, {
+            url: string;
+            transport?: "sse" | undefined;
+        }, {
+            url: string;
+            transport?: "sse" | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        mcpServers: Record<string, {
+            url: string;
+            transport?: "sse" | undefined;
+        }>;
+    }, {
+        mcpServers: Record<string, {
+            url: string;
+            transport?: "sse" | undefined;
+        }>;
+    }>;
+    cursorDeepLink: z.ZodOptional<z.ZodString>;
+    _meta: z.ZodOptional<z.ZodObject<{
+        serverName: z.ZodOptional<z.ZodString>;
+        serverUrl: z.ZodOptional<z.ZodString>;
+        mcpEndpoint: z.ZodOptional<z.ZodString>;
+        agentDid: z.ZodOptional<z.ZodString>;
+        generatedAt: z.ZodOptional<z.ZodNumber>;
+        instructions: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodUnknown, z.objectOutputType<{
+        serverName: z.ZodOptional<z.ZodString>;
+        serverUrl: z.ZodOptional<z.ZodString>;
+        mcpEndpoint: z.ZodOptional<z.ZodString>;
+        agentDid: z.ZodOptional<z.ZodString>;
+        generatedAt: z.ZodOptional<z.ZodNumber>;
+        instructions: z.ZodOptional<z.ZodString>;
+    }, z.ZodUnknown, "strip">, z.objectInputType<{
+        serverName: z.ZodOptional<z.ZodString>;
+        serverUrl: z.ZodOptional<z.ZodString>;
+        mcpEndpoint: z.ZodOptional<z.ZodString>;
+        agentDid: z.ZodOptional<z.ZodString>;
+        generatedAt: z.ZodOptional<z.ZodNumber>;
+        instructions: z.ZodOptional<z.ZodString>;
+    }, z.ZodUnknown, "strip">>>;
+}, "strip", z.ZodTypeAny, {
+    claudeDesktop: {
+        mcpServers: Record<string, {
+            url: string;
+            transport?: "sse" | undefined;
+        }>;
+    };
+    cursor: {
+        mcpServers: Record<string, {
+            url: string;
+            transport?: "sse" | undefined;
+        }>;
+    };
+    _meta?: z.objectOutputType<{
+        serverName: z.ZodOptional<z.ZodString>;
+        serverUrl: z.ZodOptional<z.ZodString>;
+        mcpEndpoint: z.ZodOptional<z.ZodString>;
+        agentDid: z.ZodOptional<z.ZodString>;
+        generatedAt: z.ZodOptional<z.ZodNumber>;
+        instructions: z.ZodOptional<z.ZodString>;
+    }, z.ZodUnknown, "strip"> | undefined;
+    cursorDeepLink?: string | undefined;
+}, {
+    claudeDesktop: {
+        mcpServers: Record<string, {
+            url: string;
+            transport?: "sse" | undefined;
+        }>;
+    };
+    cursor: {
+        mcpServers: Record<string, {
+            url: string;
+            transport?: "sse" | undefined;
+        }>;
+    };
+    _meta?: z.objectInputType<{
+        serverName: z.ZodOptional<z.ZodString>;
+        serverUrl: z.ZodOptional<z.ZodString>;
+        mcpEndpoint: z.ZodOptional<z.ZodString>;
+        agentDid: z.ZodOptional<z.ZodString>;
+        generatedAt: z.ZodOptional<z.ZodNumber>;
+        instructions: z.ZodOptional<z.ZodString>;
+    }, z.ZodUnknown, "strip"> | undefined;
+    cursorDeepLink?: string | undefined;
+}>;
+export declare const WellKnownConfigSchema: z.ZodObject<{
+    serviceName: z.ZodOptional<z.ZodString>;
+    serviceTitle: z.ZodOptional<z.ZodString>;
+    serviceEndpoint: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    serverVersion: z.ZodOptional<z.ZodString>;
+    protocolVersion: z.ZodOptional<z.ZodString>;
+    iconUrl: z.ZodOptional<z.ZodString>;
+    documentationUrl: z.ZodOptional<z.ZodString>;
+    requiresAuth: z.ZodOptional<z.ZodBoolean>;
+    authSchemes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    instructions: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    metadata?: Record<string, unknown> | undefined;
+    protocolVersion?: string | undefined;
+    description?: string | undefined;
+    serviceEndpoint?: string | undefined;
+    instructions?: string | undefined;
+    serviceName?: string | undefined;
+    iconUrl?: string | undefined;
+    documentationUrl?: string | undefined;
+    requiresAuth?: boolean | undefined;
+    serviceTitle?: string | undefined;
+    serverVersion?: string | undefined;
+    authSchemes?: string[] | undefined;
+}, {
+    metadata?: Record<string, unknown> | undefined;
+    protocolVersion?: string | undefined;
+    description?: string | undefined;
+    serviceEndpoint?: string | undefined;
+    instructions?: string | undefined;
+    serviceName?: string | undefined;
+    iconUrl?: string | undefined;
+    documentationUrl?: string | undefined;
+    requiresAuth?: boolean | undefined;
+    serviceTitle?: string | undefined;
+    serverVersion?: string | undefined;
+    authSchemes?: string[] | undefined;
+}>;
+export declare const WellKnownResponseSchema: z.ZodObject<{
+    status: z.ZodNumber;
+    headers: z.ZodRecord<z.ZodString, z.ZodString>;
+    body: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    status: number;
+    headers: Record<string, string>;
+    body: string;
+}, {
+    status: number;
+    headers: Record<string, string>;
+    body: string;
+}>;
+/**
+ * Type Guards
+ */
+export declare function isDIDDocument(obj: any): obj is DIDDocument;
+export declare function isAgentDocument(obj: any): obj is AgentDocument;
+export declare function isMCPIdentity(obj: any): obj is MCPIdentity;
+/**
+ * Validation Functions
+ */
+export declare function validateDIDDocument(obj: any): DIDDocument;
+export declare function validateAgentDocument(obj: any): AgentDocument;
+export declare function validateMCPIdentity(obj: any): MCPIdentity;
+/**
+ * Utility Functions
+ */
+/**
+ * Check if a path is a well-known endpoint
+ */
+export declare function isWellKnownPath(path: string): boolean;
+/**
+ * Get the content type for a well-known endpoint
+ */
+export declare function getWellKnownContentType(path: WellKnownPath | string): string;
+/**
+ * Type guard for MCPServerCard (SEP-1649)
+ */
+export declare function isMCPServerCard(obj: any): obj is MCPServerCard;
+/**
+ * Validation function for MCPServerCard (SEP-1649)
+ */
+export declare function validateMCPServerCard(obj: any): MCPServerCard;
+/**
+ * Type guard for MCPServerConfig (legacy)
+ */
+export declare function isMCPServerConfig(obj: any): obj is MCPServerConfig;
+/**
+ * Validation function for MCPServerConfig (legacy)
+ */
+export declare function validateMCPServerConfig(obj: any): MCPServerConfig;
+/**
+ * Type guard for MCPClientConfig
+ */
+export declare function isMCPClientConfig(obj: any): obj is MCPClientConfig;
+/**
+ * Validation function for MCPClientConfig
+ */
+export declare function validateMCPClientConfig(obj: any): MCPClientConfig;