@frontmcp/sdk 0.6.0 → 0.6.1

package/src/common/types/options/transport.options.d.ts

@@ -7,7 +7,8 @@ export type { SessionMode, TransportIdMode, PlatformMappingEntry, PlatformDetect
  */
 export declare const transportPersistenceConfigSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodBoolean>;
-    redis: z.ZodOptional<z.ZodObject<{
+    redis: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+        provider: z.ZodLiteral<"redis">;
         host: z.ZodString;
         port: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
         password: z.ZodOptional<z.ZodString>;
@@ -15,7 +16,38 @@ export declare const transportPersistenceConfigSchema: z.ZodObject<{
         tls: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
         keyPrefix: z.ZodDefault<z.ZodOptional<z.ZodString>>;
         defaultTtlMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-    }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        provider: z.ZodLiteral<"vercel-kv">;
+        url: z.ZodOptional<z.ZodString>;
+        token: z.ZodOptional<z.ZodString>;
+        keyPrefix: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        defaultTtlMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, z.core.$strip>, z.ZodPipe<z.ZodObject<{
+        host: z.ZodString;
+        port: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        password: z.ZodOptional<z.ZodString>;
+        db: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        tls: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        keyPrefix: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        defaultTtlMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, z.core.$strip>, z.ZodTransform<{
+        provider: "redis";
+        host: string;
+        port: number;
+        db: number;
+        tls: boolean;
+        keyPrefix: string;
+        defaultTtlMs: number;
+        password?: string | undefined;
+    }, {
+        host: string;
+        port: number;
+        db: number;
+        tls: boolean;
+        keyPrefix: string;
+        defaultTtlMs: number;
+        password?: string | undefined;
+    }>>]>>;
     defaultTtlMs: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strip>;
 /**
@@ -50,7 +82,22 @@ export declare const transportOptionsSchema: z.ZodObject<{
     requireSessionForStreamable: z.ZodDefault<z.ZodBoolean>;
     persistence: z.ZodOptional<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
-        redis: z.ZodOptional<z.ZodObject<{
+        redis: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+            provider: z.ZodLiteral<"redis">;
+            host: z.ZodString;
+            port: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+            password: z.ZodOptional<z.ZodString>;
+            db: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+            tls: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            keyPrefix: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+            defaultTtlMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        }, z.core.$strip>, z.ZodObject<{
+            provider: z.ZodLiteral<"vercel-kv">;
+            url: z.ZodOptional<z.ZodString>;
+            token: z.ZodOptional<z.ZodString>;
+            keyPrefix: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+            defaultTtlMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        }, z.core.$strip>, z.ZodPipe<z.ZodObject<{
             host: z.ZodString;
             port: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
             password: z.ZodOptional<z.ZodString>;
@@ -58,7 +105,24 @@ export declare const transportOptionsSchema: z.ZodObject<{
             tls: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
             keyPrefix: z.ZodDefault<z.ZodOptional<z.ZodString>>;
             defaultTtlMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-        }, z.core.$strip>>;
+        }, z.core.$strip>, z.ZodTransform<{
+            provider: "redis";
+            host: string;
+            port: number;
+            db: number;
+            tls: boolean;
+            keyPrefix: string;
+            defaultTtlMs: number;
+            password?: string | undefined;
+        }, {
+            host: string;
+            port: number;
+            db: number;
+            tls: boolean;
+            keyPrefix: string;
+            defaultTtlMs: number;
+            password?: string | undefined;
+        }>>]>>;
         defaultTtlMs: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>>;
 }, z.core.$strip>;

package/src/common/utils/global-config.utils.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Global Configuration Utilities
+ *
+ * Helper functions for plugins to access global configuration from @FrontMcp decorator.
+ */
+import type { FrontMcpConfigType } from '../metadata';
+import type { RedisOptions } from '../types';
+/**
+ * Extract store configuration from global FrontMcp configuration.
+ *
+ * This helper is used by plugins that want to use the global redis/store
+ * configuration instead of requiring explicit configuration.
+ *
+ * @param pluginName - Name of the plugin requesting the config (for error messages)
+ * @param config - The FrontMcp configuration object
+ * @returns The redis/store configuration
+ * @throws GlobalConfigNotFoundError if redis is not configured
+ *
+ * @example
+ * ```typescript
+ * // In plugin dynamicProviders:
+ * static dynamicProviders = (options: MyPluginOptions) => {
+ *   if (options.type === 'global-store') {
+ *     return [{
+ *       provide: MyStoreToken,
+ *       inject: () => [FrontMcpConfig],
+ *       useFactory: (config: FrontMcpConfigType) => {
+ *         const storeConfig = getGlobalStoreConfig('MyPlugin', config);
+ *         return new MyStoreProvider(storeConfig);
+ *       },
+ *     }];
+ *   }
+ * };
+ * ```
+ */
+export declare function getGlobalStoreConfig(pluginName: string, config: FrontMcpConfigType): RedisOptions;

package/src/common/utils/global-config.utils.js

@@ -0,0 +1,44 @@
+"use strict";
+/**
+ * Global Configuration Utilities
+ *
+ * Helper functions for plugins to access global configuration from @FrontMcp decorator.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getGlobalStoreConfig = getGlobalStoreConfig;
+const errors_1 = require("../../errors");
+/**
+ * Extract store configuration from global FrontMcp configuration.
+ *
+ * This helper is used by plugins that want to use the global redis/store
+ * configuration instead of requiring explicit configuration.
+ *
+ * @param pluginName - Name of the plugin requesting the config (for error messages)
+ * @param config - The FrontMcp configuration object
+ * @returns The redis/store configuration
+ * @throws GlobalConfigNotFoundError if redis is not configured
+ *
+ * @example
+ * ```typescript
+ * // In plugin dynamicProviders:
+ * static dynamicProviders = (options: MyPluginOptions) => {
+ *   if (options.type === 'global-store') {
+ *     return [{
+ *       provide: MyStoreToken,
+ *       inject: () => [FrontMcpConfig],
+ *       useFactory: (config: FrontMcpConfigType) => {
+ *         const storeConfig = getGlobalStoreConfig('MyPlugin', config);
+ *         return new MyStoreProvider(storeConfig);
+ *       },
+ *     }];
+ *   }
+ * };
+ * ```
+ */
+function getGlobalStoreConfig(pluginName, config) {
+    if (!config.redis) {
+        throw new errors_1.GlobalConfigNotFoundError(pluginName, 'redis');
+    }
+    return config.redis;
+}
+//# sourceMappingURL=global-config.utils.js.map

package/src/common/utils/global-config.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-config.utils.js","sourceRoot":"","sources":["../../../../src/common/utils/global-config.utils.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAkCH,oDAKC;AAnCD,yCAAyD;AAEzD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,SAAgB,oBAAoB,CAAC,UAAkB,EAAE,MAA0B;IACjF,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,IAAI,kCAAyB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC;AACtB,CAAC","sourcesContent":["/**\n * Global Configuration Utilities\n *\n * Helper functions for plugins to access global configuration from @FrontMcp decorator.\n */\n\nimport type { FrontMcpConfigType } from '../metadata';\nimport type { RedisOptions } from '../types';\nimport { GlobalConfigNotFoundError } from '../../errors';\n\n/**\n * Extract store configuration from global FrontMcp configuration.\n *\n * This helper is used by plugins that want to use the global redis/store\n * configuration instead of requiring explicit configuration.\n *\n * @param pluginName - Name of the plugin requesting the config (for error messages)\n * @param config - The FrontMcp configuration object\n * @returns The redis/store configuration\n * @throws GlobalConfigNotFoundError if redis is not configured\n *\n * @example\n * ```typescript\n * // In plugin dynamicProviders:\n * static dynamicProviders = (options: MyPluginOptions) => {\n *   if (options.type === 'global-store') {\n *     return [{\n *       provide: MyStoreToken,\n *       inject: () => [FrontMcpConfig],\n *       useFactory: (config: FrontMcpConfigType) => {\n *         const storeConfig = getGlobalStoreConfig('MyPlugin', config);\n *         return new MyStoreProvider(storeConfig);\n *       },\n *     }];\n *   }\n * };\n * ```\n */\nexport function getGlobalStoreConfig(pluginName: string, config: FrontMcpConfigType): RedisOptions {\n  if (!config.redis) {\n    throw new GlobalConfigNotFoundError(pluginName, 'redis');\n  }\n  return config.redis;\n}\n"]}

package/src/common/utils/index.d.ts

@@ -1,2 +1,3 @@
 export * from './decide-request-intent.utils';
 export * from './path.utils';
+export * from './global-config.utils';

package/src/common/utils/index.js

@@ -3,4 +3,5 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./decide-request-intent.utils"), exports);
 tslib_1.__exportStar(require("./path.utils"), exports);
+tslib_1.__exportStar(require("./global-config.utils"), exports);
 //# sourceMappingURL=index.js.map

package/src/common/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/common/utils/index.ts"],"names":[],"mappings":";;;AAAA,wEAA6C;AAC7C,uDAA4B","sourcesContent":["export * from './decide-request-intent.utils'\nexport * from './path.utils'"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/common/utils/index.ts"],"names":[],"mappings":";;;AAAA,wEAA8C;AAC9C,uDAA6B;AAC7B,gEAAsC","sourcesContent":["export * from './decide-request-intent.utils';\nexport * from './path.utils';\nexport * from './global-config.utils';\n"]}

package/src/completion/flows/complete.flow.d.ts

@@ -4,15 +4,11 @@ declare const inputSchema: z.ZodObject<{
     request: z.ZodObject<{
         method: z.ZodLiteral<"completion/complete">;
         params: z.ZodObject<{
-            task: z.ZodOptional<z.ZodObject<{
-                ttl: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodNull]>>;
-                pollInterval: z.ZodOptional<z.ZodNumber>;
-            }, z.core.$loose>>;
             _meta: z.ZodOptional<z.ZodObject<{
                 progressToken: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
                 "io.modelcontextprotocol/related-task": z.ZodOptional<z.ZodObject<{
                     taskId: z.ZodString;
-                }, z.core.$loose>>;
+                }, z.core.$strip>>;
             }, z.core.$loose>>;
             ref: z.ZodUnion<readonly [z.ZodObject<{
                 type: z.ZodLiteral<"ref/prompt">;
@@ -28,15 +24,16 @@ declare const inputSchema: z.ZodObject<{
             context: z.ZodOptional<z.ZodObject<{
                 arguments: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
             }, z.core.$strip>>;
-        }, z.core.$loose>;
+        }, z.core.$strip>;
     }, z.core.$strip>;
     ctx: z.ZodUnknown;
 }, z.core.$strip>;
 declare const outputSchema: z.ZodObject<{
     _meta: z.ZodOptional<z.ZodObject<{
+        progressToken: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
         "io.modelcontextprotocol/related-task": z.ZodOptional<z.ZodObject<{
             taskId: z.ZodString;
-        }, z.core.$loose>>;
+        }, z.core.$strip>>;
     }, z.core.$loose>>;
     completion: z.ZodObject<{
         values: z.ZodArray<z.ZodString>;
@@ -58,9 +55,10 @@ declare const stateSchema: z.ZodObject<{
     }, z.core.$strip>;
     output: z.ZodObject<{
         _meta: z.ZodOptional<z.ZodObject<{
+            progressToken: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
             "io.modelcontextprotocol/related-task": z.ZodOptional<z.ZodObject<{
                 taskId: z.ZodString;
-            }, z.core.$loose>>;
+            }, z.core.$strip>>;
         }, z.core.$loose>>;
         completion: z.ZodObject<{
             values: z.ZodArray<z.ZodString>;

package/src/errors/index.d.ts

@@ -1,3 +1,3 @@
-export { McpError, PublicMcpError, InternalMcpError, ToolNotFoundError, ResourceNotFoundError, ResourceReadError, InvalidResourceUriError, InvalidInputError, InvalidOutputError, InvalidMethodError, ToolExecutionError, RateLimitError, QuotaExceededError, UnauthorizedError, GenericServerError, DependencyNotFoundError, InvalidHookFlowError, AuthConfigurationError, PromptNotFoundError, PromptExecutionError, isPublicError, toMcpError, formatMcpErrorResponse, MCP_ERROR_CODES, type McpErrorCode, } from './mcp.error';
+export { McpError, PublicMcpError, InternalMcpError, ToolNotFoundError, ResourceNotFoundError, ResourceReadError, InvalidResourceUriError, InvalidInputError, InvalidOutputError, InvalidMethodError, ToolExecutionError, RateLimitError, QuotaExceededError, UnauthorizedError, GenericServerError, DependencyNotFoundError, InvalidHookFlowError, AuthConfigurationError, PromptNotFoundError, PromptExecutionError, GlobalConfigNotFoundError, isPublicError, toMcpError, formatMcpErrorResponse, MCP_ERROR_CODES, type McpErrorCode, } from './mcp.error';
 export { authorizationRequiredDataSchema, authorizationRequiredParamsSchema, authorizationRequiredMetaSchema, AuthorizationRequiredData, AuthorizationRequiredParams, AuthorizationRequiredMeta, AuthorizationRequiredError, } from './authorization-required.error';
 export { ErrorHandler, ErrorHandlerOptions, createErrorHandler, shouldStopExecution } from './error-handler';

package/src/errors/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.shouldStopExecution = exports.createErrorHandler = exports.ErrorHandler = exports.AuthorizationRequiredError = exports.authorizationRequiredMetaSchema = exports.authorizationRequiredParamsSchema = exports.authorizationRequiredDataSchema = exports.MCP_ERROR_CODES = exports.formatMcpErrorResponse = exports.toMcpError = exports.isPublicError = exports.PromptExecutionError = exports.PromptNotFoundError = exports.AuthConfigurationError = exports.InvalidHookFlowError = exports.DependencyNotFoundError = exports.GenericServerError = exports.UnauthorizedError = exports.QuotaExceededError = exports.RateLimitError = exports.ToolExecutionError = exports.InvalidMethodError = exports.InvalidOutputError = exports.InvalidInputError = exports.InvalidResourceUriError = exports.ResourceReadError = exports.ResourceNotFoundError = exports.ToolNotFoundError = exports.InternalMcpError = exports.PublicMcpError = exports.McpError = void 0;
+exports.shouldStopExecution = exports.createErrorHandler = exports.ErrorHandler = exports.AuthorizationRequiredError = exports.authorizationRequiredMetaSchema = exports.authorizationRequiredParamsSchema = exports.authorizationRequiredDataSchema = exports.MCP_ERROR_CODES = exports.formatMcpErrorResponse = exports.toMcpError = exports.isPublicError = exports.GlobalConfigNotFoundError = exports.PromptExecutionError = exports.PromptNotFoundError = exports.AuthConfigurationError = exports.InvalidHookFlowError = exports.DependencyNotFoundError = exports.GenericServerError = exports.UnauthorizedError = exports.QuotaExceededError = exports.RateLimitError = exports.ToolExecutionError = exports.InvalidMethodError = exports.InvalidOutputError = exports.InvalidInputError = exports.InvalidResourceUriError = exports.ResourceReadError = exports.ResourceNotFoundError = exports.ToolNotFoundError = exports.InternalMcpError = exports.PublicMcpError = exports.McpError = void 0;
 // Export all error classes
 var mcp_error_1 = require("./mcp.error");
 Object.defineProperty(exports, "McpError", { enumerable: true, get: function () { return mcp_error_1.McpError; } });
@@ -23,6 +23,7 @@ Object.defineProperty(exports, "InvalidHookFlowError", { enumerable: true, get:
 Object.defineProperty(exports, "AuthConfigurationError", { enumerable: true, get: function () { return mcp_error_1.AuthConfigurationError; } });
 Object.defineProperty(exports, "PromptNotFoundError", { enumerable: true, get: function () { return mcp_error_1.PromptNotFoundError; } });
 Object.defineProperty(exports, "PromptExecutionError", { enumerable: true, get: function () { return mcp_error_1.PromptExecutionError; } });
+Object.defineProperty(exports, "GlobalConfigNotFoundError", { enumerable: true, get: function () { return mcp_error_1.GlobalConfigNotFoundError; } });
 Object.defineProperty(exports, "isPublicError", { enumerable: true, get: function () { return mcp_error_1.isPublicError; } });
 Object.defineProperty(exports, "toMcpError", { enumerable: true, get: function () { return mcp_error_1.toMcpError; } });
 Object.defineProperty(exports, "formatMcpErrorResponse", { enumerable: true, get: function () { return mcp_error_1.formatMcpErrorResponse; } });

package/src/errors/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/errors/index.ts"],"names":[],"mappings":";;;AAAA,2BAA2B;AAC3B,yCA2BqB;AA1BnB,qGAAA,QAAQ,OAAA;AACR,2GAAA,cAAc,OAAA;AACd,6GAAA,gBAAgB,OAAA;AAChB,8GAAA,iBAAiB,OAAA;AACjB,kHAAA,qBAAqB,OAAA;AACrB,8GAAA,iBAAiB,OAAA;AACjB,oHAAA,uBAAuB,OAAA;AACvB,8GAAA,iBAAiB,OAAA;AACjB,+GAAA,kBAAkB,OAAA;AAClB,+GAAA,kBAAkB,OAAA;AAClB,+GAAA,kBAAkB,OAAA;AAClB,2GAAA,cAAc,OAAA;AACd,+GAAA,kBAAkB,OAAA;AAClB,8GAAA,iBAAiB,OAAA;AACjB,+GAAA,kBAAkB,OAAA;AAClB,oHAAA,uBAAuB,OAAA;AACvB,iHAAA,oBAAoB,OAAA;AACpB,mHAAA,sBAAsB,OAAA;AACtB,gHAAA,mBAAmB,OAAA;AACnB,iHAAA,oBAAoB,OAAA;AACpB,0GAAA,aAAa,OAAA;AACb,uGAAA,UAAU,OAAA;AACV,mHAAA,sBAAsB,OAAA;AACtB,cAAc;AACd,4GAAA,eAAe,OAAA;AAIjB,2DAA2D;AAC3D,+EAWwC;AAVtC,UAAU;AACV,+IAAA,+BAA+B,OAAA;AAC/B,iJAAA,iCAAiC,OAAA;AACjC,+IAAA,+BAA+B,OAAA;AAK/B,cAAc;AACd,0IAAA,0BAA0B,OAAA;AAG5B,iCAAiC;AACjC,iDAA6G;AAApG,6GAAA,YAAY,OAAA;AAAuB,mHAAA,kBAAkB,OAAA;AAAE,oHAAA,mBAAmB,OAAA","sourcesContent":["// Export all error classes\nexport {\n  McpError,\n  PublicMcpError,\n  InternalMcpError,\n  ToolNotFoundError,\n  ResourceNotFoundError,\n  ResourceReadError,\n  InvalidResourceUriError,\n  InvalidInputError,\n  InvalidOutputError,\n  InvalidMethodError,\n  ToolExecutionError,\n  RateLimitError,\n  QuotaExceededError,\n  UnauthorizedError,\n  GenericServerError,\n  DependencyNotFoundError,\n  InvalidHookFlowError,\n  AuthConfigurationError,\n  PromptNotFoundError,\n  PromptExecutionError,\n  isPublicError,\n  toMcpError,\n  formatMcpErrorResponse,\n  // Error codes\n  MCP_ERROR_CODES,\n  type McpErrorCode,\n} from './mcp.error';\n\n// Export authorization required error for progressive auth\nexport {\n  // Schemas\n  authorizationRequiredDataSchema,\n  authorizationRequiredParamsSchema,\n  authorizationRequiredMetaSchema,\n  // Types (inferred from schemas)\n  AuthorizationRequiredData,\n  AuthorizationRequiredParams,\n  AuthorizationRequiredMeta,\n  // Error class\n  AuthorizationRequiredError,\n} from './authorization-required.error';\n\n// Export error handler utilities\nexport { ErrorHandler, ErrorHandlerOptions, createErrorHandler, shouldStopExecution } from './error-handler';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/errors/index.ts"],"names":[],"mappings":";;;AAAA,2BAA2B;AAC3B,yCA4BqB;AA3BnB,qGAAA,QAAQ,OAAA;AACR,2GAAA,cAAc,OAAA;AACd,6GAAA,gBAAgB,OAAA;AAChB,8GAAA,iBAAiB,OAAA;AACjB,kHAAA,qBAAqB,OAAA;AACrB,8GAAA,iBAAiB,OAAA;AACjB,oHAAA,uBAAuB,OAAA;AACvB,8GAAA,iBAAiB,OAAA;AACjB,+GAAA,kBAAkB,OAAA;AAClB,+GAAA,kBAAkB,OAAA;AAClB,+GAAA,kBAAkB,OAAA;AAClB,2GAAA,cAAc,OAAA;AACd,+GAAA,kBAAkB,OAAA;AAClB,8GAAA,iBAAiB,OAAA;AACjB,+GAAA,kBAAkB,OAAA;AAClB,oHAAA,uBAAuB,OAAA;AACvB,iHAAA,oBAAoB,OAAA;AACpB,mHAAA,sBAAsB,OAAA;AACtB,gHAAA,mBAAmB,OAAA;AACnB,iHAAA,oBAAoB,OAAA;AACpB,sHAAA,yBAAyB,OAAA;AACzB,0GAAA,aAAa,OAAA;AACb,uGAAA,UAAU,OAAA;AACV,mHAAA,sBAAsB,OAAA;AACtB,cAAc;AACd,4GAAA,eAAe,OAAA;AAIjB,2DAA2D;AAC3D,+EAWwC;AAVtC,UAAU;AACV,+IAAA,+BAA+B,OAAA;AAC/B,iJAAA,iCAAiC,OAAA;AACjC,+IAAA,+BAA+B,OAAA;AAK/B,cAAc;AACd,0IAAA,0BAA0B,OAAA;AAG5B,iCAAiC;AACjC,iDAA6G;AAApG,6GAAA,YAAY,OAAA;AAAuB,mHAAA,kBAAkB,OAAA;AAAE,oHAAA,mBAAmB,OAAA","sourcesContent":["// Export all error classes\nexport {\n  McpError,\n  PublicMcpError,\n  InternalMcpError,\n  ToolNotFoundError,\n  ResourceNotFoundError,\n  ResourceReadError,\n  InvalidResourceUriError,\n  InvalidInputError,\n  InvalidOutputError,\n  InvalidMethodError,\n  ToolExecutionError,\n  RateLimitError,\n  QuotaExceededError,\n  UnauthorizedError,\n  GenericServerError,\n  DependencyNotFoundError,\n  InvalidHookFlowError,\n  AuthConfigurationError,\n  PromptNotFoundError,\n  PromptExecutionError,\n  GlobalConfigNotFoundError,\n  isPublicError,\n  toMcpError,\n  formatMcpErrorResponse,\n  // Error codes\n  MCP_ERROR_CODES,\n  type McpErrorCode,\n} from './mcp.error';\n\n// Export authorization required error for progressive auth\nexport {\n  // Schemas\n  authorizationRequiredDataSchema,\n  authorizationRequiredParamsSchema,\n  authorizationRequiredMetaSchema,\n  // Types (inferred from schemas)\n  AuthorizationRequiredData,\n  AuthorizationRequiredParams,\n  AuthorizationRequiredMeta,\n  // Error class\n  AuthorizationRequiredError,\n} from './authorization-required.error';\n\n// Export error handler utilities\nexport { ErrorHandler, ErrorHandlerOptions, createErrorHandler, shouldStopExecution } from './error-handler';\n"]}

package/src/errors/mcp.error.d.ts

@@ -237,6 +237,15 @@ export declare class PromptExecutionError extends InternalMcpError {
     constructor(promptName: string, cause?: Error);
     getInternalMessage(): string;
 }
+/**
+ * Global configuration not found error - thrown when a plugin requires
+ * global configuration that is not defined in @FrontMcp decorator.
+ */
+export declare class GlobalConfigNotFoundError extends PublicMcpError {
+    readonly pluginName: string;
+    readonly configKey: string;
+    constructor(pluginName: string, configKey: string);
+}
 /**
  * Check if the error is a public error that can be safely shown to users
  */

package/src/errors/mcp.error.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PromptExecutionError = exports.PromptNotFoundError = exports.AuthConfigurationError = exports.RequestContextNotAvailableError = exports.InvalidHookFlowError = exports.DependencyNotFoundError = exports.GenericServerError = exports.UnauthorizedError = exports.QuotaExceededError = exports.RateLimitError = exports.ToolExecutionError = exports.InvalidMethodError = exports.InvalidOutputError = exports.InvalidInputError = exports.InvalidResourceUriError = exports.ResourceReadError = exports.ResourceNotFoundError = exports.ToolNotFoundError = exports.InternalMcpError = exports.PublicMcpError = exports.McpError = exports.MCP_ERROR_CODES = void 0;
+exports.GlobalConfigNotFoundError = exports.PromptExecutionError = exports.PromptNotFoundError = exports.AuthConfigurationError = exports.RequestContextNotAvailableError = exports.InvalidHookFlowError = exports.DependencyNotFoundError = exports.GenericServerError = exports.UnauthorizedError = exports.QuotaExceededError = exports.RateLimitError = exports.ToolExecutionError = exports.InvalidMethodError = exports.InvalidOutputError = exports.InvalidInputError = exports.InvalidResourceUriError = exports.ResourceReadError = exports.ResourceNotFoundError = exports.ToolNotFoundError = exports.InternalMcpError = exports.PublicMcpError = exports.McpError = exports.MCP_ERROR_CODES = void 0;
 exports.isPublicError = isPublicError;
 exports.toMcpError = toMcpError;
 exports.formatMcpErrorResponse = formatMcpErrorResponse;
@@ -368,6 +368,24 @@ class PromptExecutionError extends InternalMcpError {
 }
 exports.PromptExecutionError = PromptExecutionError;
 // ============================================================================
+// Configuration Errors
+// ============================================================================
+/**
+ * Global configuration not found error - thrown when a plugin requires
+ * global configuration that is not defined in @FrontMcp decorator.
+ */
+class GlobalConfigNotFoundError extends PublicMcpError {
+    pluginName;
+    configKey;
+    constructor(pluginName, configKey) {
+        super(`Plugin "${pluginName}" requires global "${configKey}" configuration. ` +
+            `Add "${configKey}" to your @FrontMcp decorator options.`, 'GLOBAL_CONFIG_NOT_FOUND', 500);
+        this.pluginName = pluginName;
+        this.configKey = configKey;
+    }
+}
+exports.GlobalConfigNotFoundError = GlobalConfigNotFoundError;
+// ============================================================================
 // Error Utilities
 // ============================================================================
 /**

package/src/errors/mcp.error.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp.error.js","sourceRoot":"","sources":["../../../src/errors/mcp.error.ts"],"names":[],"mappings":"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","sourcesContent":["// errors/mcp.error.ts\nimport { randomBytes } from 'crypto';\n\n/**\n * MCP-specific error codes per JSON-RPC specification.\n * These codes are used in the JSON-RPC error response format.\n */\nexport const MCP_ERROR_CODES = {\n  /** Resource not found (-32002) */\n  RESOURCE_NOT_FOUND: -32002,\n  /** Invalid request (-32600) */\n  INVALID_REQUEST: -32600,\n  /** Method not found (-32601) */\n  METHOD_NOT_FOUND: -32601,\n  /** Invalid params (-32602) */\n  INVALID_PARAMS: -32602,\n  /** Internal error (-32603) */\n  INTERNAL_ERROR: -32603,\n  /** Parse error (-32700) */\n  PARSE_ERROR: -32700,\n} as const;\n\nexport type McpErrorCode = (typeof MCP_ERROR_CODES)[keyof typeof MCP_ERROR_CODES];\n\n/**\n * Base class for all MCP-related errors\n */\nexport abstract class McpError extends Error {\n  /**\n   * Unique error ID for tracking in logs\n   */\n  errorId: string;\n\n  /**\n   * Whether this error should expose details to the client\n   */\n  abstract readonly isPublic: boolean;\n\n  /**\n   * HTTP status code equivalent (for reference)\n   */\n  abstract readonly statusCode: number;\n\n  /**\n   * Error code for categorization\n   */\n  abstract readonly code: string;\n\n  protected constructor(message: string, errorId?: string) {\n    super(message);\n    this.name = this.constructor.name;\n    this.errorId = errorId || this.generateErrorId();\n    Error.captureStackTrace(this, this.constructor);\n  }\n\n  private generateErrorId(): string {\n    return `err_${randomBytes(8).toString('hex')}`;\n  }\n\n  /**\n   * Get the public-facing error message\n   */\n  abstract getPublicMessage(): string;\n\n  /**\n   * Get the internal error message (for logging)\n   */\n  getInternalMessage(): string {\n    return this.message;\n  }\n\n  /**\n   * Convert to MCP error response format\n   */\n  toMcpError(isDevelopment = false): {\n    content: Array<{ type: 'text'; text: string }>;\n    isError: true;\n    _meta?: {\n      errorId: string;\n      code: string;\n      timestamp: string;\n      stack?: string;\n    };\n  } {\n    const message = isDevelopment ? this.getInternalMessage() : this.getPublicMessage();\n\n    return {\n      content: [\n        {\n          type: 'text',\n          text: message,\n        },\n      ],\n      isError: true,\n      _meta: {\n        errorId: this.errorId,\n        code: this.code,\n        timestamp: new Date().toISOString(),\n        ...(isDevelopment && { stack: this.stack }),\n      },\n    };\n  }\n}\n\n/**\n * Public errors - safe to expose to clients\n * These include validation errors, not found errors, etc.\n */\nexport class PublicMcpError extends McpError {\n  readonly isPublic = true;\n  readonly statusCode: number;\n  readonly code: string;\n\n  constructor(message: string, code = 'PUBLIC_ERROR', statusCode = 400) {\n    super(message);\n    this.code = code;\n    this.statusCode = statusCode;\n  }\n\n  getPublicMessage(): string {\n    return this.message;\n  }\n}\n\n/**\n * Internal errors - should not expose details to clients\n * These are server errors, unexpected failures, etc.\n */\nexport class InternalMcpError extends McpError {\n  readonly isPublic = false;\n  readonly statusCode = 500;\n  readonly code: string;\n\n  constructor(message: string, code = 'INTERNAL_ERROR') {\n    super(message);\n    this.code = code;\n  }\n\n  getPublicMessage(): string {\n    return `Internal FrontMCP error. Please contact support with error ID: ${this.errorId}`;\n  }\n}\n\n// ============================================================================\n// Specific Error Classes\n// ============================================================================\n\n/**\n * Tool not found error\n */\nexport class ToolNotFoundError extends PublicMcpError {\n  constructor(toolName: string) {\n    super(`Tool \"${toolName}\" not found`, 'TOOL_NOT_FOUND', 404);\n  }\n}\n\n/**\n * Resource not found error\n */\nexport class ResourceNotFoundError extends PublicMcpError {\n  readonly uri: string;\n  readonly mcpErrorCode = MCP_ERROR_CODES.RESOURCE_NOT_FOUND;\n\n  constructor(uri: string) {\n    super(`Resource not found: ${uri}`, 'RESOURCE_NOT_FOUND', 404);\n    this.uri = uri;\n  }\n\n  /**\n   * Convert to JSON-RPC error format per MCP specification.\n   *\n   * @example\n   * {\n   *   \"code\": -32002,\n   *   \"message\": \"Resource not found: file:///missing.txt\",\n   *   \"data\": { \"uri\": \"file:///missing.txt\" }\n   * }\n   */\n  toJsonRpcError(): {\n    code: number;\n    message: string;\n    data?: { uri: string };\n  } {\n    return {\n      code: this.mcpErrorCode,\n      message: this.getPublicMessage(),\n      data: { uri: this.uri },\n    };\n  }\n}\n\n/**\n * Resource read error (internal)\n */\nexport class ResourceReadError extends InternalMcpError {\n  readonly originalError?: Error;\n\n  constructor(uri: string, originalError?: Error) {\n    super(`Resource \"${uri}\" read failed: ${originalError?.message || 'Unknown error'}`, 'RESOURCE_READ_ERROR');\n    this.originalError = originalError;\n  }\n\n  override getInternalMessage(): string {\n    if (this.originalError?.stack) {\n      return `${this.message}\\n\\nOriginal error:\\n${this.originalError.stack}`;\n    }\n    return this.message;\n  }\n}\n\n/**\n * Invalid resource URI error\n */\nexport class InvalidResourceUriError extends PublicMcpError {\n  constructor(uri: string, reason?: string) {\n    super(`Invalid resource URI: ${uri}${reason ? ` (${reason})` : ''}`, 'INVALID_RESOURCE_URI', 400);\n  }\n}\n\n/**\n * Invalid input validation error\n */\nexport class InvalidInputError extends PublicMcpError {\n  readonly validationErrors?: any;\n\n  constructor(message = 'Invalid input: validation failed', validationErrors?: any) {\n    super(message, 'INVALID_INPUT', 400);\n    this.validationErrors = validationErrors;\n  }\n\n  override getInternalMessage(): string {\n    return this.message + (this.validationErrors ? `\\nDetails: ${JSON.stringify(this.validationErrors, null, 2)}` : '');\n  }\n  override getPublicMessage(): string {\n    if (this.validationErrors) {\n      return `${this.message}\\nDetails: ${JSON.stringify(this.validationErrors, null, 2)}`;\n    }\n    return this.message;\n  }\n}\n\n/**\n * Invalid output validation error (internal - don't expose schema details)\n */\nexport class InvalidOutputError extends InternalMcpError {\n  private readonly hasCustomErrorId: boolean;\n\n  constructor(errorId?: string) {\n    super('Tool output validation failed', 'INVALID_OUTPUT');\n    this.hasCustomErrorId = !!errorId;\n    if (errorId) {\n      this.errorId = errorId;\n    }\n  }\n\n  override getPublicMessage(): string {\n    // If a custom errorId was provided (e.g., request ID), include it for correlation\n    // Otherwise, use a simpler message since the auto-generated ID isn't meaningful to users\n    if (this.hasCustomErrorId) {\n      return `Output validation failed. Please contact support with error ID: ${this.errorId}`;\n    }\n    return 'Output validation failed. Please contact support.';\n  }\n}\n\n/**\n * Invalid method error\n */\nexport class InvalidMethodError extends PublicMcpError {\n  constructor(method: string, expected: string) {\n    super(`Invalid method \"${method}\". Expected \"${expected}\"`, 'INVALID_METHOD', 400);\n  }\n}\n\n/**\n * Tool execution error (internal)\n */\nexport class ToolExecutionError extends InternalMcpError {\n  readonly originalError?: Error;\n\n  constructor(toolName: string, originalError?: Error) {\n    super(`Tool \"${toolName}\" execution failed: ${originalError?.message || 'Unknown error'}`, 'TOOL_EXECUTION_ERROR');\n    this.originalError = originalError;\n  }\n\n  override getInternalMessage(): string {\n    if (this.originalError?.stack) {\n      return `${this.message}\\n\\nOriginal error:\\n${this.originalError.stack}`;\n    }\n    return this.message;\n  }\n}\n\n/**\n * Rate limit error\n */\nexport class RateLimitError extends PublicMcpError {\n  constructor(retryAfter?: number) {\n    const message = retryAfter ? `Rate limit exceeded. Retry after ${retryAfter} seconds` : 'Rate limit exceeded';\n    super(message, 'RATE_LIMIT_EXCEEDED', 429);\n  }\n}\n\n/**\n * Quota exceeded error\n */\nexport class QuotaExceededError extends PublicMcpError {\n  constructor(quotaType = 'usage') {\n    super(`${quotaType} quota exceeded`, 'QUOTA_EXCEEDED', 429);\n  }\n}\n\n/**\n * Unauthorized error\n */\nexport class UnauthorizedError extends PublicMcpError {\n  constructor(message = 'Unauthorized') {\n    super(message, 'UNAUTHORIZED', 401);\n  }\n}\n\n/**\n * Generic server error wrapper\n */\nexport class GenericServerError extends InternalMcpError {\n  readonly originalError?: Error;\n\n  constructor(message: string, originalError?: Error) {\n    super(message, 'SERVER_ERROR');\n    this.originalError = originalError;\n  }\n\n  override getInternalMessage(): string {\n    if (this.originalError?.stack) {\n      return `${this.message}\\n\\nOriginal error:\\n${this.originalError.stack}`;\n    }\n    return this.message;\n  }\n}\n\n/**\n * Dependency not found error (internal) - thrown when a required dependency\n * is not found in a registry during initialization.\n */\nexport class DependencyNotFoundError extends InternalMcpError {\n  constructor(registryName: string, dependencyName: string) {\n    super(`Dependency \"${dependencyName}\" not found in ${registryName}`, 'DEPENDENCY_NOT_FOUND');\n  }\n}\n\n/**\n * Invalid hook flow error - thrown when a hook is registered with a flow\n * that is not supported by the entry type (e.g., tool hook on resource class).\n */\nexport class InvalidHookFlowError extends InternalMcpError {\n  constructor(message: string) {\n    super(message, 'INVALID_HOOK_FLOW');\n  }\n}\n\n/**\n * Request context not available error - thrown when code attempts to access\n * RequestContext outside of a request scope (i.e., without AsyncLocalStorage context).\n */\nexport class RequestContextNotAvailableError extends InternalMcpError {\n  constructor(\n    message = 'RequestContext not available. Ensure execution runs within a request scope created by RequestContextStorage.run().',\n  ) {\n    super(message, 'REQUEST_CONTEXT_NOT_AVAILABLE');\n  }\n}\n\n/**\n * Auth configuration error - thrown when auth configuration is invalid\n * (e.g., transparent mode on parent with multiple child providers).\n */\nexport class AuthConfigurationError extends PublicMcpError {\n  readonly errors: string[];\n  readonly suggestion?: string;\n\n  constructor(message: string, options?: { errors?: string[]; suggestion?: string }) {\n    super(message, 'AUTH_CONFIGURATION_ERROR', 500);\n    this.errors = options?.errors ?? [message];\n    this.suggestion = options?.suggestion;\n  }\n\n  override getPublicMessage(): string {\n    let msg = this.message;\n    if (this.suggestion) {\n      msg += `\\n\\nTo fix this issue:\\n${this.suggestion}`;\n    }\n    return msg;\n  }\n}\n\n// ============================================================================\n// Prompt Errors\n// ============================================================================\n\n/**\n * Prompt not found error.\n */\nexport class PromptNotFoundError extends PublicMcpError {\n  constructor(promptName: string) {\n    super(`Prompt not found: ${promptName}`, 'PROMPT_NOT_FOUND', 404);\n  }\n}\n\n/**\n * Prompt execution error - wraps errors during prompt execution.\n */\nexport class PromptExecutionError extends InternalMcpError {\n  readonly promptName: string;\n  readonly originalError?: Error;\n\n  constructor(promptName: string, cause?: Error) {\n    super(\n      cause ? `Prompt execution failed: ${cause.message}` : `Prompt execution failed: ${promptName}`,\n      'PROMPT_EXECUTION_FAILED',\n    );\n    this.promptName = promptName;\n    this.originalError = cause;\n  }\n\n  override getInternalMessage(): string {\n    if (this.originalError?.stack) {\n      return `${this.message}\\n\\nOriginal error:\\n${this.originalError.stack}`;\n    }\n    return this.message;\n  }\n}\n\n// ============================================================================\n// Error Utilities\n// ============================================================================\n\n/**\n * Check if the error is a public error that can be safely shown to users\n */\nexport function isPublicError(error: any): error is PublicMcpError {\n  return error instanceof McpError && error.isPublic;\n}\n\n/**\n * Convert any error to an MCP error\n */\nexport function toMcpError(error: any): McpError {\n  if (error instanceof McpError) {\n    return error;\n  }\n\n  if (error instanceof Error) {\n    return new GenericServerError(error.message, error);\n  }\n\n  return new GenericServerError(String(error));\n}\n\n/**\n * Format error for MCP response\n */\nexport function formatMcpErrorResponse(error: any, isDevelopment: boolean = process.env['NODE_ENV'] !== 'production') {\n  const mcpError = toMcpError(error);\n  return mcpError.toMcpError(isDevelopment);\n}\n"]}
+{"version":3,"file":"mcp.error.js","sourceRoot":"","sources":["../../../src/errors/mcp.error.ts"],"names":[],"mappings":"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","sourcesContent":["// errors/mcp.error.ts\nimport { randomBytes } from 'crypto';\n\n/**\n * MCP-specific error codes per JSON-RPC specification.\n * These codes are used in the JSON-RPC error response format.\n */\nexport const MCP_ERROR_CODES = {\n  /** Resource not found (-32002) */\n  RESOURCE_NOT_FOUND: -32002,\n  /** Invalid request (-32600) */\n  INVALID_REQUEST: -32600,\n  /** Method not found (-32601) */\n  METHOD_NOT_FOUND: -32601,\n  /** Invalid params (-32602) */\n  INVALID_PARAMS: -32602,\n  /** Internal error (-32603) */\n  INTERNAL_ERROR: -32603,\n  /** Parse error (-32700) */\n  PARSE_ERROR: -32700,\n} as const;\n\nexport type McpErrorCode = (typeof MCP_ERROR_CODES)[keyof typeof MCP_ERROR_CODES];\n\n/**\n * Base class for all MCP-related errors\n */\nexport abstract class McpError extends Error {\n  /**\n   * Unique error ID for tracking in logs\n   */\n  errorId: string;\n\n  /**\n   * Whether this error should expose details to the client\n   */\n  abstract readonly isPublic: boolean;\n\n  /**\n   * HTTP status code equivalent (for reference)\n   */\n  abstract readonly statusCode: number;\n\n  /**\n   * Error code for categorization\n   */\n  abstract readonly code: string;\n\n  protected constructor(message: string, errorId?: string) {\n    super(message);\n    this.name = this.constructor.name;\n    this.errorId = errorId || this.generateErrorId();\n    Error.captureStackTrace(this, this.constructor);\n  }\n\n  private generateErrorId(): string {\n    return `err_${randomBytes(8).toString('hex')}`;\n  }\n\n  /**\n   * Get the public-facing error message\n   */\n  abstract getPublicMessage(): string;\n\n  /**\n   * Get the internal error message (for logging)\n   */\n  getInternalMessage(): string {\n    return this.message;\n  }\n\n  /**\n   * Convert to MCP error response format\n   */\n  toMcpError(isDevelopment = false): {\n    content: Array<{ type: 'text'; text: string }>;\n    isError: true;\n    _meta?: {\n      errorId: string;\n      code: string;\n      timestamp: string;\n      stack?: string;\n    };\n  } {\n    const message = isDevelopment ? this.getInternalMessage() : this.getPublicMessage();\n\n    return {\n      content: [\n        {\n          type: 'text',\n          text: message,\n        },\n      ],\n      isError: true,\n      _meta: {\n        errorId: this.errorId,\n        code: this.code,\n        timestamp: new Date().toISOString(),\n        ...(isDevelopment && { stack: this.stack }),\n      },\n    };\n  }\n}\n\n/**\n * Public errors - safe to expose to clients\n * These include validation errors, not found errors, etc.\n */\nexport class PublicMcpError extends McpError {\n  readonly isPublic = true;\n  readonly statusCode: number;\n  readonly code: string;\n\n  constructor(message: string, code = 'PUBLIC_ERROR', statusCode = 400) {\n    super(message);\n    this.code = code;\n    this.statusCode = statusCode;\n  }\n\n  getPublicMessage(): string {\n    return this.message;\n  }\n}\n\n/**\n * Internal errors - should not expose details to clients\n * These are server errors, unexpected failures, etc.\n */\nexport class InternalMcpError extends McpError {\n  readonly isPublic = false;\n  readonly statusCode = 500;\n  readonly code: string;\n\n  constructor(message: string, code = 'INTERNAL_ERROR') {\n    super(message);\n    this.code = code;\n  }\n\n  getPublicMessage(): string {\n    return `Internal FrontMCP error. Please contact support with error ID: ${this.errorId}`;\n  }\n}\n\n// ============================================================================\n// Specific Error Classes\n// ============================================================================\n\n/**\n * Tool not found error\n */\nexport class ToolNotFoundError extends PublicMcpError {\n  constructor(toolName: string) {\n    super(`Tool \"${toolName}\" not found`, 'TOOL_NOT_FOUND', 404);\n  }\n}\n\n/**\n * Resource not found error\n */\nexport class ResourceNotFoundError extends PublicMcpError {\n  readonly uri: string;\n  readonly mcpErrorCode = MCP_ERROR_CODES.RESOURCE_NOT_FOUND;\n\n  constructor(uri: string) {\n    super(`Resource not found: ${uri}`, 'RESOURCE_NOT_FOUND', 404);\n    this.uri = uri;\n  }\n\n  /**\n   * Convert to JSON-RPC error format per MCP specification.\n   *\n   * @example\n   * {\n   *   \"code\": -32002,\n   *   \"message\": \"Resource not found: file:///missing.txt\",\n   *   \"data\": { \"uri\": \"file:///missing.txt\" }\n   * }\n   */\n  toJsonRpcError(): {\n    code: number;\n    message: string;\n    data?: { uri: string };\n  } {\n    return {\n      code: this.mcpErrorCode,\n      message: this.getPublicMessage(),\n      data: { uri: this.uri },\n    };\n  }\n}\n\n/**\n * Resource read error (internal)\n */\nexport class ResourceReadError extends InternalMcpError {\n  readonly originalError?: Error;\n\n  constructor(uri: string, originalError?: Error) {\n    super(`Resource \"${uri}\" read failed: ${originalError?.message || 'Unknown error'}`, 'RESOURCE_READ_ERROR');\n    this.originalError = originalError;\n  }\n\n  override getInternalMessage(): string {\n    if (this.originalError?.stack) {\n      return `${this.message}\\n\\nOriginal error:\\n${this.originalError.stack}`;\n    }\n    return this.message;\n  }\n}\n\n/**\n * Invalid resource URI error\n */\nexport class InvalidResourceUriError extends PublicMcpError {\n  constructor(uri: string, reason?: string) {\n    super(`Invalid resource URI: ${uri}${reason ? ` (${reason})` : ''}`, 'INVALID_RESOURCE_URI', 400);\n  }\n}\n\n/**\n * Invalid input validation error\n */\nexport class InvalidInputError extends PublicMcpError {\n  readonly validationErrors?: any;\n\n  constructor(message = 'Invalid input: validation failed', validationErrors?: any) {\n    super(message, 'INVALID_INPUT', 400);\n    this.validationErrors = validationErrors;\n  }\n\n  override getInternalMessage(): string {\n    return this.message + (this.validationErrors ? `\\nDetails: ${JSON.stringify(this.validationErrors, null, 2)}` : '');\n  }\n  override getPublicMessage(): string {\n    if (this.validationErrors) {\n      return `${this.message}\\nDetails: ${JSON.stringify(this.validationErrors, null, 2)}`;\n    }\n    return this.message;\n  }\n}\n\n/**\n * Invalid output validation error (internal - don't expose schema details)\n */\nexport class InvalidOutputError extends InternalMcpError {\n  private readonly hasCustomErrorId: boolean;\n\n  constructor(errorId?: string) {\n    super('Tool output validation failed', 'INVALID_OUTPUT');\n    this.hasCustomErrorId = !!errorId;\n    if (errorId) {\n      this.errorId = errorId;\n    }\n  }\n\n  override getPublicMessage(): string {\n    // If a custom errorId was provided (e.g., request ID), include it for correlation\n    // Otherwise, use a simpler message since the auto-generated ID isn't meaningful to users\n    if (this.hasCustomErrorId) {\n      return `Output validation failed. Please contact support with error ID: ${this.errorId}`;\n    }\n    return 'Output validation failed. Please contact support.';\n  }\n}\n\n/**\n * Invalid method error\n */\nexport class InvalidMethodError extends PublicMcpError {\n  constructor(method: string, expected: string) {\n    super(`Invalid method \"${method}\". Expected \"${expected}\"`, 'INVALID_METHOD', 400);\n  }\n}\n\n/**\n * Tool execution error (internal)\n */\nexport class ToolExecutionError extends InternalMcpError {\n  readonly originalError?: Error;\n\n  constructor(toolName: string, originalError?: Error) {\n    super(`Tool \"${toolName}\" execution failed: ${originalError?.message || 'Unknown error'}`, 'TOOL_EXECUTION_ERROR');\n    this.originalError = originalError;\n  }\n\n  override getInternalMessage(): string {\n    if (this.originalError?.stack) {\n      return `${this.message}\\n\\nOriginal error:\\n${this.originalError.stack}`;\n    }\n    return this.message;\n  }\n}\n\n/**\n * Rate limit error\n */\nexport class RateLimitError extends PublicMcpError {\n  constructor(retryAfter?: number) {\n    const message = retryAfter ? `Rate limit exceeded. Retry after ${retryAfter} seconds` : 'Rate limit exceeded';\n    super(message, 'RATE_LIMIT_EXCEEDED', 429);\n  }\n}\n\n/**\n * Quota exceeded error\n */\nexport class QuotaExceededError extends PublicMcpError {\n  constructor(quotaType = 'usage') {\n    super(`${quotaType} quota exceeded`, 'QUOTA_EXCEEDED', 429);\n  }\n}\n\n/**\n * Unauthorized error\n */\nexport class UnauthorizedError extends PublicMcpError {\n  constructor(message = 'Unauthorized') {\n    super(message, 'UNAUTHORIZED', 401);\n  }\n}\n\n/**\n * Generic server error wrapper\n */\nexport class GenericServerError extends InternalMcpError {\n  readonly originalError?: Error;\n\n  constructor(message: string, originalError?: Error) {\n    super(message, 'SERVER_ERROR');\n    this.originalError = originalError;\n  }\n\n  override getInternalMessage(): string {\n    if (this.originalError?.stack) {\n      return `${this.message}\\n\\nOriginal error:\\n${this.originalError.stack}`;\n    }\n    return this.message;\n  }\n}\n\n/**\n * Dependency not found error (internal) - thrown when a required dependency\n * is not found in a registry during initialization.\n */\nexport class DependencyNotFoundError extends InternalMcpError {\n  constructor(registryName: string, dependencyName: string) {\n    super(`Dependency \"${dependencyName}\" not found in ${registryName}`, 'DEPENDENCY_NOT_FOUND');\n  }\n}\n\n/**\n * Invalid hook flow error - thrown when a hook is registered with a flow\n * that is not supported by the entry type (e.g., tool hook on resource class).\n */\nexport class InvalidHookFlowError extends InternalMcpError {\n  constructor(message: string) {\n    super(message, 'INVALID_HOOK_FLOW');\n  }\n}\n\n/**\n * Request context not available error - thrown when code attempts to access\n * RequestContext outside of a request scope (i.e., without AsyncLocalStorage context).\n */\nexport class RequestContextNotAvailableError extends InternalMcpError {\n  constructor(\n    message = 'RequestContext not available. Ensure execution runs within a request scope created by RequestContextStorage.run().',\n  ) {\n    super(message, 'REQUEST_CONTEXT_NOT_AVAILABLE');\n  }\n}\n\n/**\n * Auth configuration error - thrown when auth configuration is invalid\n * (e.g., transparent mode on parent with multiple child providers).\n */\nexport class AuthConfigurationError extends PublicMcpError {\n  readonly errors: string[];\n  readonly suggestion?: string;\n\n  constructor(message: string, options?: { errors?: string[]; suggestion?: string }) {\n    super(message, 'AUTH_CONFIGURATION_ERROR', 500);\n    this.errors = options?.errors ?? [message];\n    this.suggestion = options?.suggestion;\n  }\n\n  override getPublicMessage(): string {\n    let msg = this.message;\n    if (this.suggestion) {\n      msg += `\\n\\nTo fix this issue:\\n${this.suggestion}`;\n    }\n    return msg;\n  }\n}\n\n// ============================================================================\n// Prompt Errors\n// ============================================================================\n\n/**\n * Prompt not found error.\n */\nexport class PromptNotFoundError extends PublicMcpError {\n  constructor(promptName: string) {\n    super(`Prompt not found: ${promptName}`, 'PROMPT_NOT_FOUND', 404);\n  }\n}\n\n/**\n * Prompt execution error - wraps errors during prompt execution.\n */\nexport class PromptExecutionError extends InternalMcpError {\n  readonly promptName: string;\n  readonly originalError?: Error;\n\n  constructor(promptName: string, cause?: Error) {\n    super(\n      cause ? `Prompt execution failed: ${cause.message}` : `Prompt execution failed: ${promptName}`,\n      'PROMPT_EXECUTION_FAILED',\n    );\n    this.promptName = promptName;\n    this.originalError = cause;\n  }\n\n  override getInternalMessage(): string {\n    if (this.originalError?.stack) {\n      return `${this.message}\\n\\nOriginal error:\\n${this.originalError.stack}`;\n    }\n    return this.message;\n  }\n}\n\n// ============================================================================\n// Configuration Errors\n// ============================================================================\n\n/**\n * Global configuration not found error - thrown when a plugin requires\n * global configuration that is not defined in @FrontMcp decorator.\n */\nexport class GlobalConfigNotFoundError extends PublicMcpError {\n  readonly pluginName: string;\n  readonly configKey: string;\n\n  constructor(pluginName: string, configKey: string) {\n    super(\n      `Plugin \"${pluginName}\" requires global \"${configKey}\" configuration. ` +\n        `Add \"${configKey}\" to your @FrontMcp decorator options.`,\n      'GLOBAL_CONFIG_NOT_FOUND',\n      500,\n    );\n    this.pluginName = pluginName;\n    this.configKey = configKey;\n  }\n}\n\n// ============================================================================\n// Error Utilities\n// ============================================================================\n\n/**\n * Check if the error is a public error that can be safely shown to users\n */\nexport function isPublicError(error: any): error is PublicMcpError {\n  return error instanceof McpError && error.isPublic;\n}\n\n/**\n * Convert any error to an MCP error\n */\nexport function toMcpError(error: any): McpError {\n  if (error instanceof McpError) {\n    return error;\n  }\n\n  if (error instanceof Error) {\n    return new GenericServerError(error.message, error);\n  }\n\n  return new GenericServerError(String(error));\n}\n\n/**\n * Format error for MCP response\n */\nexport function formatMcpErrorResponse(error: any, isDevelopment: boolean = process.env['NODE_ENV'] !== 'production') {\n  const mcpError = toMcpError(error);\n  return mcpError.toMcpError(isDevelopment);\n}\n"]}