@kya-os/mcp-i 1.7.0 → 1.7.3

package/dist/runtime/utils/tools.d.ts

@@ -3,6 +3,7 @@ import { ZodTypeAny } from "zod";
 import { ToolFile } from "./server";
 import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
 import { DetachedProof } from "@kya-os/contracts/proof";
+import { type ClientMessagesConfig } from "@kya-os/mcp-i-core";
 export type ZodRawShape = {
     [k: string]: ZodTypeAny;
 };
@@ -22,4 +23,4 @@ export declare function addToolsToServer(server: McpServer, toolModules: Map<str
     environment?: string;
     devIdentityPath?: string;
     privacyMode?: boolean;
-}): Promise<McpServer>;
+}, clientMessagesConfig?: ClientMessagesConfig): Promise<McpServer>;

package/dist/runtime/utils/tools.js

@@ -120,7 +120,7 @@ if (typeof global !== "undefined") {
         global.__MCPI_HANDLERS_REGISTERED__ || false;
 }
 /** Loads tools and injects them into the server */
-async function addToolsToServer(server, toolModules, identityConfig) {
+async function addToolsToServer(server, toolModules, identityConfig, clientMessagesConfig) {
     // Guard against double registration using global scope
     // Set this IMMEDIATELY to prevent race conditions
     if (typeof global !== "undefined") {
@@ -491,7 +491,24 @@ async function addToolsToServer(server, toolModules, identityConfig) {
                     if (identityConfig?.debug) {
                         console.error(`[MCPI] Tool "${name}" blocked - authorization required`);
                     }
+                    // Format human-readable message using DelegationErrorFormatter
+                    // Supports client-specific messages via clientMessagesConfig
+                    // The formatter may modify the URL (e.g., adding extraParams from config)
+                    const formatter = new mcp_i_core_1.DelegationErrorFormatter(clientMessagesConfig);
+                    const { message: displayMessage, consentUrl } = formatter.format({
+                        toolName: name,
+                        consentUrl: verifyResult.authError?.authorizationUrl,
+                        scopes: verifyResult.authError?.scopes,
+                        // TODO: Client-specific message formatting not yet available for Node.js runtime.
+                        // The `findKnownClient()` function that maps client names to IDs (claude, chatgpt, etc.)
+                        // is currently in @kya-os/mcp-i-cloudflare. To enable client-specific messages here,
+                        // consider moving findKnownClient to @kya-os/mcp-i-core for cross-platform use.
+                        // See: packages/mcp-i-cloudflare/src/utils/known-clients.ts
+                        clientId: undefined,
+                    });
                     // Return MCP error format with authorization hints
+                    // Includes both human-readable displayMessage and structured data
+                    // Use formatter's consentUrl (may include extraParams) for consistency with displayMessage
                     return {
                         content: [
                             {
@@ -499,7 +516,8 @@ async function addToolsToServer(server, toolModules, identityConfig) {
                                 text: JSON.stringify({
                                     error: "needs_authorization",
                                     message: `Tool "${name}" requires user authorization`,
-                                    authorizationUrl: verifyResult.authError?.authorizationUrl,
+                                    displayMessage, // Human-readable message for clients to display
+                                    authorizationUrl: consentUrl, // Use formatter's URL for consistency
                                     resumeToken: verifyResult.authError?.resumeToken,
                                     scopes: verifyResult.authError?.scopes,
                                     display: verifyResult.authError?.display,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kya-os/mcp-i",
-  "version": "1.7.0",
+  "version": "1.7.3",
   "description": "The TypeScript MCP framework with identity features built-in",
   "type": "commonjs",
   "main": "dist/index.js",
@@ -63,8 +63,8 @@
     "model-context-protocol"
   ],
   "dependencies": {
-    "@kya-os/contracts": "^1.7.0",
-    "@kya-os/mcp-i-core": "^1.4.0",
+    "@kya-os/contracts": "^1.7.6",
+    "@kya-os/mcp-i-core": "^1.4.3",
     "@modelcontextprotocol/sdk": "^1.11.4",
     "@swc/core": "^1.11.24",
     "@types/express": "^5.0.1",