@kya-os/contracts 1.3.4 → 1.4.0

package/dist/well-known/index.js

@@ -0,0 +1,134 @@
+"use strict";
+/**
+ * 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WellKnownResponseSchema = exports.WellKnownConfigSchema = exports.MCPIdentitySchema = exports.AgentDocumentSchema = exports.DIDDocumentSchema = exports.WellKnownPath = void 0;
+exports.isDIDDocument = isDIDDocument;
+exports.isAgentDocument = isAgentDocument;
+exports.isMCPIdentity = isMCPIdentity;
+exports.validateDIDDocument = validateDIDDocument;
+exports.validateAgentDocument = validateAgentDocument;
+exports.validateMCPIdentity = validateMCPIdentity;
+exports.isWellKnownPath = isWellKnownPath;
+exports.getWellKnownContentType = getWellKnownContentType;
+const zod_1 = require("zod");
+/**
+ * Well-known endpoint paths
+ */
+var WellKnownPath;
+(function (WellKnownPath) {
+    WellKnownPath["DID_DOCUMENT"] = "/.well-known/did.json";
+    WellKnownPath["AGENT_DOCUMENT"] = "/.well-known/agent.json";
+    WellKnownPath["MCP_IDENTITY"] = "/.well-known/mcp-identity";
+    WellKnownPath["TOOL_PROTECTIONS"] = "/.well-known/tool-protections.json";
+})(WellKnownPath || (exports.WellKnownPath = WellKnownPath = {}));
+/**
+ * Zod Schemas for Validation
+ */
+exports.DIDDocumentSchema = zod_1.z.object({
+    '@context': zod_1.z.array(zod_1.z.string()),
+    id: zod_1.z.string(),
+    verificationMethod: zod_1.z.array(zod_1.z.object({
+        id: zod_1.z.string(),
+        type: zod_1.z.string(),
+        controller: zod_1.z.string(),
+        publicKeyBase64: zod_1.z.string().optional(),
+        publicKeyMultibase: zod_1.z.string().optional()
+    })),
+    authentication: zod_1.z.array(zod_1.z.string()).optional(),
+    assertionMethod: zod_1.z.array(zod_1.z.string()).optional(),
+    capabilityInvocation: zod_1.z.array(zod_1.z.string()).optional(),
+    capabilityDelegation: zod_1.z.array(zod_1.z.string()).optional(),
+    keyAgreement: zod_1.z.array(zod_1.z.string()).optional(),
+    service: zod_1.z.array(zod_1.z.object({
+        id: zod_1.z.string(),
+        type: zod_1.z.string(),
+        serviceEndpoint: zod_1.z.string()
+    })).optional()
+});
+exports.AgentDocumentSchema = zod_1.z.object({
+    id: zod_1.z.string(),
+    capabilities: zod_1.z.object({
+        'mcp-i': zod_1.z.array(zod_1.z.enum(['handshake', 'signing', 'verification', 'delegation', 'proof-generation']))
+    }).catchall(zod_1.z.array(zod_1.z.string())),
+    metadata: zod_1.z.object({
+        name: zod_1.z.string().optional(),
+        serviceEndpoint: zod_1.z.string().optional(),
+        version: zod_1.z.string().optional(),
+        description: zod_1.z.string().optional()
+    }).optional()
+});
+exports.MCPIdentitySchema = zod_1.z.object({
+    did: zod_1.z.string(),
+    publicKey: zod_1.z.string(),
+    serviceName: zod_1.z.string(),
+    serviceEndpoint: zod_1.z.string(),
+    timestamp: zod_1.z.number(),
+    metadata: zod_1.z.record(zod_1.z.unknown()).optional()
+});
+exports.WellKnownConfigSchema = zod_1.z.object({
+    serviceName: zod_1.z.string().optional(),
+    serviceEndpoint: zod_1.z.string().optional(),
+    metadata: zod_1.z.record(zod_1.z.unknown()).optional()
+});
+exports.WellKnownResponseSchema = zod_1.z.object({
+    status: zod_1.z.number(),
+    headers: zod_1.z.record(zod_1.z.string()),
+    body: zod_1.z.string()
+});
+/**
+ * Type Guards
+ */
+function isDIDDocument(obj) {
+    return exports.DIDDocumentSchema.safeParse(obj).success;
+}
+function isAgentDocument(obj) {
+    return exports.AgentDocumentSchema.safeParse(obj).success;
+}
+function isMCPIdentity(obj) {
+    return exports.MCPIdentitySchema.safeParse(obj).success;
+}
+/**
+ * Validation Functions
+ */
+function validateDIDDocument(obj) {
+    return exports.DIDDocumentSchema.parse(obj);
+}
+function validateAgentDocument(obj) {
+    return exports.AgentDocumentSchema.parse(obj);
+}
+function validateMCPIdentity(obj) {
+    return exports.MCPIdentitySchema.parse(obj);
+}
+/**
+ * Utility Functions
+ */
+/**
+ * Check if a path is a well-known endpoint
+ */
+function isWellKnownPath(path) {
+    return Object.values(WellKnownPath).includes(path);
+}
+/**
+ * Get the content type for a well-known endpoint
+ */
+function getWellKnownContentType(path) {
+    switch (path) {
+        case WellKnownPath.DID_DOCUMENT:
+            return 'application/did+json';
+        case WellKnownPath.AGENT_DOCUMENT:
+        case WellKnownPath.TOOL_PROTECTIONS:
+            return 'application/json';
+        case WellKnownPath.MCP_IDENTITY:
+            return 'application/json';
+        default:
+            return 'application/json';
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kya-os/contracts",
-  "version": "1.3.4",
+  "version": "1.4.0",
   "description": "Shared types and schemas for XMCP-I ecosystem",
   "type": "commonjs",
   "sideEffects": false,
@@ -91,6 +91,11 @@
       "types": "./dist/config/index.d.ts",
       "import": "./dist/config/index.js",
       "require": "./dist/config/index.js"
+    },
+    "./dashboard-config": {
+      "types": "./dist/dashboard-config/index.d.ts",
+      "import": "./dist/dashboard-config/index.js",
+      "require": "./dist/dashboard-config/index.js"
     }
   },
   "files": [