@frontmcp/sdk 0.6.0 → 0.6.2

package/src/errors/mcp.error.js

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

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

@@ -1 +0,0 @@
-{"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"]}

package/src/exceptions/mcp-exceptions/session-missing.exception.js

@@ -1,11 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SessionMissingException = void 0;
-class SessionMissingException extends Error {
-    constructor(message = 'Unauthorized: missing session') {
-        super(message);
-        this.name = 'SessionMissingError';
-    }
-}
-exports.SessionMissingException = SessionMissingException;
-//# sourceMappingURL=session-missing.exception.js.map

package/src/exceptions/mcp-exceptions/session-missing.exception.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"session-missing.exception.js","sourceRoot":"","sources":["../../../../src/exceptions/mcp-exceptions/session-missing.exception.ts"],"names":[],"mappings":";;;AAAA,MAAa,uBAAwB,SAAQ,KAAK;IAChD,YAAY,OAAO,GAAG,+BAA+B;QACnD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AALD,0DAKC","sourcesContent":["export class SessionMissingException extends Error {\n  constructor(message = 'Unauthorized: missing session') {\n    super(message);\n    this.name = 'SessionMissingError';\n  }\n}\n"]}

package/src/exceptions/mcp-exceptions/unsupported-client-version.exception.js

@@ -1,15 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.UnsupportedClientVersionException = void 0;
-class UnsupportedClientVersionException extends Error {
-    version;
-    constructor(version) {
-        super(`Unsupported client version: ${version}`);
-        this.version = version;
-    }
-    static fromVersion(version) {
-        return new UnsupportedClientVersionException(version);
-    }
-}
-exports.UnsupportedClientVersionException = UnsupportedClientVersionException;
-//# sourceMappingURL=unsupported-client-version.exception.js.map

package/src/exceptions/mcp-exceptions/unsupported-client-version.exception.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"unsupported-client-version.exception.js","sourceRoot":"","sources":["../../../../src/exceptions/mcp-exceptions/unsupported-client-version.exception.ts"],"names":[],"mappings":";;;AAAA,MAAa,iCAAkC,SAAQ,KAAK;IACvC;IAAnB,YAAmB,OAAe;QAChC,KAAK,CAAC,+BAA+B,OAAO,EAAE,CAAC,CAAC;QAD/B,YAAO,GAAP,OAAO,CAAQ;IAElC,CAAC;IACD,MAAM,CAAC,WAAW,CAAC,OAAe;QAChC,OAAO,IAAI,iCAAiC,CAAC,OAAO,CAAC,CAAC;IACxD,CAAC;CACF;AAPD,8EAOC","sourcesContent":["export class UnsupportedClientVersionException extends Error {\n  constructor(public version: string) {\n    super(`Unsupported client version: ${version}`);\n  }\n  static fromVersion(version: string) {\n    return new UnsupportedClientVersionException(version);\n  }\n}\n"]}