@frontmcp/sdk 0.4.1 → 0.5.0

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

@@ -1,3 +1,22 @@
+/**
+ * MCP-specific error codes per JSON-RPC specification.
+ * These codes are used in the JSON-RPC error response format.
+ */
+export declare const MCP_ERROR_CODES: {
+    /** Resource not found (-32002) */
+    readonly RESOURCE_NOT_FOUND: -32002;
+    /** Invalid request (-32600) */
+    readonly INVALID_REQUEST: -32600;
+    /** Method not found (-32601) */
+    readonly METHOD_NOT_FOUND: -32601;
+    /** Invalid params (-32602) */
+    readonly INVALID_PARAMS: -32602;
+    /** Internal error (-32603) */
+    readonly INTERNAL_ERROR: -32603;
+    /** Parse error (-32700) */
+    readonly PARSE_ERROR: -32700;
+};
+export type McpErrorCode = (typeof MCP_ERROR_CODES)[keyof typeof MCP_ERROR_CODES];
 /**
  * Base class for all MCP-related errors
  */
@@ -68,11 +87,50 @@ export declare class InternalMcpError extends McpError {
     getPublicMessage(): string;
 }
 /**
- * Tool didn't find an error
+ * Tool not found error
  */
 export declare class ToolNotFoundError extends PublicMcpError {
     constructor(toolName: string);
 }
+/**
+ * Resource not found error
+ */
+export declare class ResourceNotFoundError extends PublicMcpError {
+    readonly uri: string;
+    readonly mcpErrorCode: -32002;
+    constructor(uri: string);
+    /**
+     * 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(): {
+        code: number;
+        message: string;
+        data?: {
+            uri: string;
+        };
+    };
+}
+/**
+ * Resource read error (internal)
+ */
+export declare class ResourceReadError extends InternalMcpError {
+    readonly originalError?: Error;
+    constructor(uri: string, originalError?: Error);
+    getInternalMessage(): string;
+}
+/**
+ * Invalid resource URI error
+ */
+export declare class InvalidResourceUriError extends PublicMcpError {
+    constructor(uri: string, reason?: string);
+}
 /**
  * Invalid input validation error
  */
@@ -130,6 +188,48 @@ export declare class GenericServerError extends InternalMcpError {
     constructor(message: string, originalError?: Error);
     getInternalMessage(): string;
 }
+/**
+ * Dependency not found error (internal) - thrown when a required dependency
+ * is not found in a registry during initialization.
+ */
+export declare class DependencyNotFoundError extends InternalMcpError {
+    constructor(registryName: string, dependencyName: string);
+}
+/**
+ * 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).
+ */
+export declare class InvalidHookFlowError extends InternalMcpError {
+    constructor(message: string);
+}
+/**
+ * Auth configuration error - thrown when auth configuration is invalid
+ * (e.g., transparent mode on parent with multiple child providers).
+ */
+export declare class AuthConfigurationError extends PublicMcpError {
+    readonly errors: string[];
+    readonly suggestion?: string;
+    constructor(message: string, options?: {
+        errors?: string[];
+        suggestion?: string;
+    });
+    getPublicMessage(): string;
+}
+/**
+ * Prompt not found error.
+ */
+export declare class PromptNotFoundError extends PublicMcpError {
+    constructor(promptName: string);
+}
+/**
+ * Prompt execution error - wraps errors during prompt execution.
+ */
+export declare class PromptExecutionError extends InternalMcpError {
+    readonly promptName: string;
+    readonly originalError?: Error;
+    constructor(promptName: string, cause?: Error);
+    getInternalMessage(): string;
+}
 /**
  * Check if the error is a public error that can be safely shown to users
  */

package/src/errors/mcp.error.js

@@ -1,11 +1,29 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.GenericServerError = exports.UnauthorizedError = exports.QuotaExceededError = exports.RateLimitError = exports.ToolExecutionError = exports.InvalidMethodError = exports.InvalidOutputError = exports.InvalidInputError = exports.ToolNotFoundError = exports.InternalMcpError = exports.PublicMcpError = exports.McpError = void 0;
+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 = 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
  */
@@ -91,7 +109,7 @@ exports.InternalMcpError = InternalMcpError;
 // Specific Error Classes
 // ============================================================================
 /**
- * Tool didn't find an error
+ * Tool not found error
  */
 class ToolNotFoundError extends PublicMcpError {
     constructor(toolName) {
@@ -99,6 +117,61 @@ class ToolNotFoundError extends PublicMcpError {
     }
 }
 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
  */
@@ -212,6 +285,78 @@ class GenericServerError extends InternalMcpError {
     }
 }
 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;
+/**
+ * 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
 // ============================================================================

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 * 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 didn't find an 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 * 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// 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 * 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/flows/flow.instance.js

@@ -67,8 +67,8 @@ class FlowInstance extends common_1.FlowEntry {
                                 return (0, server_validation_1.writeHttpResponse)(response, e.output);
                         }
                     }
-                    // eslint-disable-next-line no-console
-                    console.error(e);
+                    // Skip console.error due to Node.js 24 util.inspect bug with Zod validation errors
+                    // The error will be returned to the client as a 500 response
                     return (0, server_validation_1.writeHttpResponse)(response, {
                         kind: 'text',
                         status: 500,
@@ -115,8 +115,9 @@ class FlowInstance extends common_1.FlowEntry {
                     metas.push(h.metadata);
                 }
                 catch (e) {
+                    // Use safe logging to avoid Node.js 24 util.inspect bug with Zod errors
                     // eslint-disable-next-line no-console
-                    console.warn('[flow] Ignoring injected hook that failed to materialize:', e);
+                    console.warn('[flow] Ignoring injected hook that failed to materialize:', e instanceof Error ? e.message : 'Unknown error');
                 }
             }
             if (metas.length) {

package/src/flows/flow.instance.js.map

@@ -1 +1 @@
-{"version":3,"file":"flow.instance.js","sourceRoot":"","sources":["../../../src/flows/flow.instance.ts"],"names":[],"mappings":"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","sourcesContent":["// noinspection ExceptionCaughtLocallyJS\n// flows/flow.instance.ts\n\nimport 'reflect-metadata';\nimport {\n  FlowControl,\n  FlowCtxOf,\n  FlowEntry,\n  FlowInputOf,\n  FlowName,\n  FlowOutputOf,\n  FlowPlan,\n  FlowRecord,\n  FlowStagesOf,\n  FlowType,\n  HookEntry,\n  HookMetadata,\n  Reference,\n  ServerRequest,\n  Token,\n  Type,\n} from '../common';\nimport ProviderRegistry from '../provider/provider.registry';\nimport { collectFlowHookMap, StageMap, cloneStageMap, mergeHookMetasIntoStageMap } from './flow.stages';\nimport { writeHttpResponse } from '../server/server.validation';\nimport { Scope } from '../scope';\nimport HookRegistry from '../hooks/hook.registry';\nimport { rpcError } from '../transport/transport.error';\n\ntype StageOutcome = 'ok' | 'respond' | 'next' | 'handled' | 'fail' | 'abort' | 'unknown_error';\n\ninterface StageResult {\n  outcome: StageOutcome;\n  control?: FlowControl | Error;\n}\n\nconst CAP = (s: string) => (s ? s[0].toUpperCase() + s.slice(1) : s);\nconst WILL = (s: string) => `will${CAP(s)}`;\nconst DID = (s: string) => `did${CAP(s)}`;\nconst AROUND = (s: string) => `around${CAP(s)}`;\n\nfunction parseTypedKey(k: string): { base: string; type?: 'will' | 'did' | 'around' } {\n  const lc = k.toLowerCase();\n  if (lc.startsWith('will') && k.length > 4) return { base: k.slice(4, 5).toLowerCase() + k.slice(5), type: 'will' };\n  if (lc.startsWith('did') && k.length > 3) return { base: k.slice(3, 4).toLowerCase() + k.slice(4), type: 'did' };\n  if (lc.startsWith('around') && k.length > 6)\n    return { base: k.slice(6, 7).toLowerCase() + k.slice(7), type: 'around' };\n  return { base: k };\n}\n\nexport class FlowInstance<Name extends FlowName> extends FlowEntry<Name> {\n  readonly deps: Reference[];\n  readonly globalProviders: ProviderRegistry;\n  private plan: FlowPlan<never>;\n  private FlowClass: FlowType;\n  private stages: StageMap<FlowType>;\n  private hooks: HookRegistry;\n\n  constructor(scope: Scope, record: FlowRecord, deps: Set<Reference>, globalProviders: ProviderRegistry) {\n    super(scope, record);\n    this.deps = [...deps];\n    this.globalProviders = globalProviders;\n    this.FlowClass = this.record.provide;\n    this.ready = this.initialize();\n    this.plan = this.record.metadata.plan;\n    this.hooks = scope.providers.getHooksRegistry();\n  }\n\n  protected async initialize() {\n    const server = this.globalProviders.getActiveServer();\n\n    this.stages = collectFlowHookMap(this.FlowClass);\n\n    const { middleware } = this.metadata;\n    if (middleware) {\n      const path = typeof middleware.path === 'string' ? middleware.path : '';\n      server.registerMiddleware(path, async (request, response, next) => {\n        const canActivate = await this.canActivate(request);\n        if (!canActivate) return next();\n\n        try {\n          const result = await this.run({ request, response, next } as any, new Map());\n          if (result) return writeHttpResponse(response, result);\n        } catch (e) {\n          if (e instanceof FlowControl) {\n            switch (e.type) {\n              case 'abort':\n                return writeHttpResponse(response, { kind: 'text', status: 500, body: 'Aborted' });\n              case 'fail':\n                return writeHttpResponse(response, { kind: 'text', status: 500, body: 'Internal Server Error' });\n              case 'handled':\n                return;\n              case 'next':\n                return next();\n              case 'respond':\n                return writeHttpResponse(response, e.output as any);\n            }\n          }\n          // eslint-disable-next-line no-console\n          console.error(e);\n          return writeHttpResponse(response, {\n            kind: 'text',\n            status: 500,\n            body: 'Internal Server Error',\n          });\n        }\n\n        return next();\n      });\n    }\n\n    return Promise.resolve();\n  }\n\n  async canActivate(request: ServerRequest): Promise<boolean> {\n    if (this.method && request.method !== this.method) return false;\n\n    const canActivate = this.metadata.middleware?.canActivate ?? [];\n    if ((this.FlowClass as any)['canActivate']) {\n      canActivate.push((this.FlowClass as any)['canActivate']);\n    }\n    if (canActivate.length === 0) return true;\n\n    const results = await Promise.all(canActivate.map((m) => m(request, this.scope)));\n    return results.every((r) => r);\n  }\n\n  async run(input: FlowInputOf<Name>, deps: Map<Token, Type>): Promise<FlowOutputOf<Name> | undefined> {\n    const scope = this.globalProviders.getActiveScope();\n    const { FlowClass, plan, name } = this;\n\n    // Clone stages so we can merge injections safely per run.\n    const baseStages = this.stages;\n    let stages: StageMap<any> = cloneStageMap(baseStages);\n\n    // Compute next order base after any class-defined entries.\n    let orderBase = Math.max(0, ...Object.values(stages).flatMap((list) => list.map((e: any) => e._order ?? 0))) + 1;\n\n    // Get tool owner ID if this is a tool call flow\n    // The tool owner ID is set by the CallToolFlow.findTool stage\n    const toolOwnerId = (input as any)?._toolOwnerId;\n\n    const initialInjectedHooks =\n      (this.hooks.getFlowHooksForOwner(name, toolOwnerId) as HookEntry<\n        FlowInputOf<Name>,\n        Name,\n        FlowStagesOf<Name>,\n        FlowCtxOf<Name>\n      >[]) ?? [];\n\n    let context: any;\n    let contextReady = false;\n\n    const materializeAndMerge = async (\n      newHooks: HookEntry<FlowInputOf<Name>, Name, FlowStagesOf<Name>, FlowCtxOf<Name>>[],\n      opts?: { orderStart?: number },\n    ) => {\n      if (!newHooks?.length || !contextReady) return;\n\n      const metas: HookMetadata[] = [];\n      for (const h of newHooks) {\n        try {\n          metas.push(h.metadata);\n        } catch (e) {\n          // eslint-disable-next-line no-console\n          console.warn('[flow] Ignoring injected hook that failed to materialize:', e);\n        }\n      }\n\n      if (metas.length) {\n        const start = opts?.orderStart ?? orderBase;\n        mergeHookMetasIntoStageMap(FlowClass, stages, metas, start);\n        if (opts?.orderStart === undefined) orderBase += metas.length;\n      }\n    };\n\n    const appendContextHooks = async (\n      hooks: HookEntry<FlowInputOf<Name>, Name, FlowStagesOf<Name>, FlowCtxOf<Name>>[],\n    ) => {\n      await materializeAndMerge(hooks);\n    };\n\n    // Construct flow instance\n    context = new FlowClass(this.metadata, input, scope, appendContextHooks, deps);\n\n    // Now injections can materialize\n    contextReady = true;\n\n    // Initial registry hooks should not pre-empt stages; they just get registered\n    await materializeAndMerge(initialInjectedHooks, { orderStart: -1_000_000 });\n\n    // Refresh order base to be after everything currently present\n    orderBase = Math.max(0, ...Object.values(stages).flatMap((list) => list.map((e: any) => e._order ?? 0))) + 1;\n\n    let responded: FlowOutputOf<Name> | undefined;\n\n    // Robust list runner (doesn't skip mid-run insertions)\n    const runList = async (key: string, opts?: { ignoreRespond?: boolean }): Promise<StageResult> => {\n      const getList = () => ((stages as any)[key] ?? []) as Array<{ method: (ctx: any) => Promise<void> }>;\n      const seen = new Set<any>();\n\n      while (true) {\n        const list = getList();\n        const item = list.find((e) => !seen.has(e));\n        if (!item) break;\n        seen.add(item);\n\n        try {\n          await item.method(context);\n        } catch (e: any) {\n          if (e instanceof FlowControl) {\n            if (e.type === 'respond') {\n              if (!opts?.ignoreRespond) {\n                responded = e.output as FlowOutputOf<Name>;\n                return { outcome: 'respond', control: e };\n              }\n              continue;\n            }\n            return { outcome: e.type, control: e };\n          }\n          return { outcome: 'unknown_error', control: e as Error };\n        }\n      }\n      return { outcome: 'ok' };\n    };\n\n    // Run exactly one stage in order: will → around → stage → did (did runs once)\n    const runOneStage = async (stageName: string, stopOnRespond: boolean): Promise<StageResult> => {\n      // 1) willStage\n      {\n        const res = await runList(WILL(stageName));\n        if (res.outcome === 'respond' && stopOnRespond) return res;\n        if (res.outcome !== 'ok' && res.outcome !== 'respond') return res;\n      }\n\n      // 2) aroundStage (acts as pre-handlers unless you later add true wrapping)\n      {\n        const res = await runList(AROUND(stageName));\n        if (res.outcome === 'respond' && stopOnRespond) return res;\n        if (res.outcome !== 'ok' && res.outcome !== 'respond') return res;\n      }\n\n      // 3) stage\n      let bodyOutcome: StageResult = { outcome: 'ok' };\n      {\n        const res = await runList(stageName, { ignoreRespond: false });\n        bodyOutcome = res;\n        if (res.outcome !== 'ok' && res.outcome !== 'respond') {\n          // fail/abort/next/handled/unknown → do NOT run did\n          return res;\n        }\n      }\n\n      // 4) didStage (run once regardless of body respond)\n      {\n        const res = await runList(DID(stageName), { ignoreRespond: true });\n        if (res.outcome !== 'ok' && res.outcome !== 'respond') return res;\n      }\n\n      if (bodyOutcome.outcome === 'respond') return bodyOutcome;\n      return { outcome: 'ok' };\n    };\n\n    // IMPORTANT: ignore typed stage names in plan arrays.\n    // Only base stage names in the plan drive execution; typed hooks run *with* their base.\n    const runStageGroup = async (\n      group: Array<string> | undefined,\n      stopOnRespond: boolean,\n      opts?: { ignoreRespond?: boolean },\n    ): Promise<StageResult> => {\n      if (!group || group.length === 0) return { outcome: 'ok' };\n\n      const seenBase = new Set<string>();\n      for (const rawKey of group) {\n        const { base, type } = parseTypedKey(rawKey);\n        if (type) {\n          // Soft warning once per typed key occurrence (optional)\n          // console.warn(`[flow] Ignoring typed stage \"${rawKey}\" in plan; hooks will run with base \"${base}\".`);\n          continue; // Do not run typed keys as standalone stages\n        }\n        if (seenBase.has(base)) continue;\n        seenBase.add(base);\n\n        const res = await runOneStage(base, stopOnRespond);\n        if (res.outcome === 'respond') {\n          if (stopOnRespond) return res;\n          // else keep going\n        } else if (res.outcome !== 'ok') {\n          return res;\n        }\n      }\n      return { outcome: 'ok' };\n    };\n\n    const runErrorStage = async () => {\n      await runStageGroup((plan as any).error, false, { ignoreRespond: true });\n    };\n\n    const runFinalizeStage = async () => {\n      await runStageGroup((plan as any).finalize, false);\n    };\n\n    try {\n      // ---------- PRE ----------\n      {\n        const pre = await runStageGroup((plan as any).pre, true);\n        if (pre.outcome === 'respond') {\n          const post = await runStageGroup((plan as any).post, false);\n          if (post.outcome === 'unknown_error' || post.outcome === 'fail') {\n            try {\n              await runErrorStage();\n            } finally {\n              await runFinalizeStage();\n            }\n            if (post.outcome === 'fail') throw post.control!;\n            throw post.control!;\n          }\n          if (post.outcome === 'abort' || post.outcome === 'next' || post.outcome === 'handled') {\n            await runFinalizeStage();\n            throw post.control as FlowControl;\n          }\n          await runFinalizeStage();\n          return responded;\n        }\n        if (pre.outcome === 'unknown_error' || pre.outcome === 'fail') {\n          try {\n            await runErrorStage();\n          } finally {\n            await runFinalizeStage();\n          }\n          if (pre.outcome === 'fail') throw pre.control!;\n          throw pre.control!;\n        }\n        if (pre.outcome === 'abort' || pre.outcome === 'next' || pre.outcome === 'handled') {\n          await runFinalizeStage();\n          throw pre.control as FlowControl;\n        }\n      }\n\n      // ---------- EXECUTE ----------\n      if (!responded) {\n        const exec = await runStageGroup((plan as any).execute, true);\n        if (exec.outcome === 'respond') {\n          // continue to post + finalize\n        } else if (exec.outcome === 'unknown_error' || exec.outcome === 'fail') {\n          try {\n            await runErrorStage();\n          } finally {\n            await runFinalizeStage();\n          }\n          if (exec.outcome === 'fail') throw exec.control!;\n          throw exec.control!;\n        } else if (exec.outcome === 'abort' || exec.outcome === 'next' || exec.outcome === 'handled') {\n          await runFinalizeStage();\n          throw exec.control as FlowControl;\n        }\n      }\n\n      // ---------- POST ----------\n      {\n        const post = await runStageGroup((plan as any).post, false);\n        if (post.outcome === 'unknown_error' || post.outcome === 'fail') {\n          try {\n            await runErrorStage();\n          } finally {\n            await runFinalizeStage();\n          }\n          if (post.outcome === 'fail') throw post.control!;\n          throw post.control!;\n        }\n        if (post.outcome === 'abort' || post.outcome === 'next' || post.outcome === 'handled') {\n          await runFinalizeStage();\n          throw post.control as FlowControl;\n        }\n      }\n\n      // ---------- FINALIZE ----------\n      await runFinalizeStage();\n\n      return responded;\n    } catch (e) {\n      throw e;\n    }\n  }\n}\n"]}
+{"version":3,"file":"flow.instance.js","sourceRoot":"","sources":["../../../src/flows/flow.instance.ts"],"names":[],"mappings":"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","sourcesContent":["// noinspection ExceptionCaughtLocallyJS\n// flows/flow.instance.ts\n\nimport 'reflect-metadata';\nimport {\n  FlowControl,\n  FlowCtxOf,\n  FlowEntry,\n  FlowInputOf,\n  FlowName,\n  FlowOutputOf,\n  FlowPlan,\n  FlowRecord,\n  FlowStagesOf,\n  FlowType,\n  HookEntry,\n  HookMetadata,\n  Reference,\n  ServerRequest,\n  Token,\n  Type,\n} from '../common';\nimport ProviderRegistry from '../provider/provider.registry';\nimport { collectFlowHookMap, StageMap, cloneStageMap, mergeHookMetasIntoStageMap } from './flow.stages';\nimport { writeHttpResponse } from '../server/server.validation';\nimport { Scope } from '../scope';\nimport HookRegistry from '../hooks/hook.registry';\nimport { rpcError } from '../transport/transport.error';\n\ntype StageOutcome = 'ok' | 'respond' | 'next' | 'handled' | 'fail' | 'abort' | 'unknown_error';\n\ninterface StageResult {\n  outcome: StageOutcome;\n  control?: FlowControl | Error;\n}\n\nconst CAP = (s: string) => (s ? s[0].toUpperCase() + s.slice(1) : s);\nconst WILL = (s: string) => `will${CAP(s)}`;\nconst DID = (s: string) => `did${CAP(s)}`;\nconst AROUND = (s: string) => `around${CAP(s)}`;\n\nfunction parseTypedKey(k: string): { base: string; type?: 'will' | 'did' | 'around' } {\n  const lc = k.toLowerCase();\n  if (lc.startsWith('will') && k.length > 4) return { base: k.slice(4, 5).toLowerCase() + k.slice(5), type: 'will' };\n  if (lc.startsWith('did') && k.length > 3) return { base: k.slice(3, 4).toLowerCase() + k.slice(4), type: 'did' };\n  if (lc.startsWith('around') && k.length > 6)\n    return { base: k.slice(6, 7).toLowerCase() + k.slice(7), type: 'around' };\n  return { base: k };\n}\n\nexport class FlowInstance<Name extends FlowName> extends FlowEntry<Name> {\n  readonly deps: Reference[];\n  readonly globalProviders: ProviderRegistry;\n  private plan: FlowPlan<never>;\n  private FlowClass: FlowType;\n  private stages: StageMap<FlowType>;\n  private hooks: HookRegistry;\n\n  constructor(scope: Scope, record: FlowRecord, deps: Set<Reference>, globalProviders: ProviderRegistry) {\n    super(scope, record);\n    this.deps = [...deps];\n    this.globalProviders = globalProviders;\n    this.FlowClass = this.record.provide;\n    this.ready = this.initialize();\n    this.plan = this.record.metadata.plan;\n    this.hooks = scope.providers.getHooksRegistry();\n  }\n\n  protected async initialize() {\n    const server = this.globalProviders.getActiveServer();\n\n    this.stages = collectFlowHookMap(this.FlowClass);\n\n    const { middleware } = this.metadata;\n    if (middleware) {\n      const path = typeof middleware.path === 'string' ? middleware.path : '';\n      server.registerMiddleware(path, async (request, response, next) => {\n        const canActivate = await this.canActivate(request);\n        if (!canActivate) return next();\n\n        try {\n          const result = await this.run({ request, response, next } as any, new Map());\n          if (result) return writeHttpResponse(response, result);\n        } catch (e) {\n          if (e instanceof FlowControl) {\n            switch (e.type) {\n              case 'abort':\n                return writeHttpResponse(response, { kind: 'text', status: 500, body: 'Aborted' });\n              case 'fail':\n                return writeHttpResponse(response, { kind: 'text', status: 500, body: 'Internal Server Error' });\n              case 'handled':\n                return;\n              case 'next':\n                return next();\n              case 'respond':\n                return writeHttpResponse(response, e.output as any);\n            }\n          }\n          // Skip console.error due to Node.js 24 util.inspect bug with Zod validation errors\n          // The error will be returned to the client as a 500 response\n          return writeHttpResponse(response, {\n            kind: 'text',\n            status: 500,\n            body: 'Internal Server Error',\n          });\n        }\n\n        return next();\n      });\n    }\n\n    return Promise.resolve();\n  }\n\n  async canActivate(request: ServerRequest): Promise<boolean> {\n    if (this.method && request.method !== this.method) return false;\n\n    const canActivate = this.metadata.middleware?.canActivate ?? [];\n    if ((this.FlowClass as any)['canActivate']) {\n      canActivate.push((this.FlowClass as any)['canActivate']);\n    }\n    if (canActivate.length === 0) return true;\n\n    const results = await Promise.all(canActivate.map((m) => m(request, this.scope)));\n    return results.every((r) => r);\n  }\n\n  async run(input: FlowInputOf<Name>, deps: Map<Token, Type>): Promise<FlowOutputOf<Name> | undefined> {\n    const scope = this.globalProviders.getActiveScope();\n    const { FlowClass, plan, name } = this;\n\n    // Clone stages so we can merge injections safely per run.\n    const baseStages = this.stages;\n    let stages: StageMap<any> = cloneStageMap(baseStages);\n\n    // Compute next order base after any class-defined entries.\n    let orderBase = Math.max(0, ...Object.values(stages).flatMap((list) => list.map((e: any) => e._order ?? 0))) + 1;\n\n    // Get tool owner ID if this is a tool call flow\n    // The tool owner ID is set by the CallToolFlow.findTool stage\n    const toolOwnerId = (input as any)?._toolOwnerId;\n\n    const initialInjectedHooks =\n      (this.hooks.getFlowHooksForOwner(name, toolOwnerId) as HookEntry<\n        FlowInputOf<Name>,\n        Name,\n        FlowStagesOf<Name>,\n        FlowCtxOf<Name>\n      >[]) ?? [];\n\n    let context: any;\n    let contextReady = false;\n\n    const materializeAndMerge = async (\n      newHooks: HookEntry<FlowInputOf<Name>, Name, FlowStagesOf<Name>, FlowCtxOf<Name>>[],\n      opts?: { orderStart?: number },\n    ) => {\n      if (!newHooks?.length || !contextReady) return;\n\n      const metas: HookMetadata[] = [];\n      for (const h of newHooks) {\n        try {\n          metas.push(h.metadata);\n        } catch (e) {\n          // Use safe logging to avoid Node.js 24 util.inspect bug with Zod errors\n          // eslint-disable-next-line no-console\n          console.warn(\n            '[flow] Ignoring injected hook that failed to materialize:',\n            e instanceof Error ? e.message : 'Unknown error',\n          );\n        }\n      }\n\n      if (metas.length) {\n        const start = opts?.orderStart ?? orderBase;\n        mergeHookMetasIntoStageMap(FlowClass, stages, metas, start);\n        if (opts?.orderStart === undefined) orderBase += metas.length;\n      }\n    };\n\n    const appendContextHooks = async (\n      hooks: HookEntry<FlowInputOf<Name>, Name, FlowStagesOf<Name>, FlowCtxOf<Name>>[],\n    ) => {\n      await materializeAndMerge(hooks);\n    };\n\n    // Construct flow instance\n    context = new FlowClass(this.metadata, input, scope, appendContextHooks, deps);\n\n    // Now injections can materialize\n    contextReady = true;\n\n    // Initial registry hooks should not pre-empt stages; they just get registered\n    await materializeAndMerge(initialInjectedHooks, { orderStart: -1_000_000 });\n\n    // Refresh order base to be after everything currently present\n    orderBase = Math.max(0, ...Object.values(stages).flatMap((list) => list.map((e: any) => e._order ?? 0))) + 1;\n\n    let responded: FlowOutputOf<Name> | undefined;\n\n    // Robust list runner (doesn't skip mid-run insertions)\n    const runList = async (key: string, opts?: { ignoreRespond?: boolean }): Promise<StageResult> => {\n      const getList = () => ((stages as any)[key] ?? []) as Array<{ method: (ctx: any) => Promise<void> }>;\n      const seen = new Set<any>();\n\n      while (true) {\n        const list = getList();\n        const item = list.find((e) => !seen.has(e));\n        if (!item) break;\n        seen.add(item);\n\n        try {\n          await item.method(context);\n        } catch (e: any) {\n          if (e instanceof FlowControl) {\n            if (e.type === 'respond') {\n              if (!opts?.ignoreRespond) {\n                responded = e.output as FlowOutputOf<Name>;\n                return { outcome: 'respond', control: e };\n              }\n              continue;\n            }\n            return { outcome: e.type, control: e };\n          }\n          return { outcome: 'unknown_error', control: e as Error };\n        }\n      }\n      return { outcome: 'ok' };\n    };\n\n    // Run exactly one stage in order: will → around → stage → did (did runs once)\n    const runOneStage = async (stageName: string, stopOnRespond: boolean): Promise<StageResult> => {\n      // 1) willStage\n      {\n        const res = await runList(WILL(stageName));\n        if (res.outcome === 'respond' && stopOnRespond) return res;\n        if (res.outcome !== 'ok' && res.outcome !== 'respond') return res;\n      }\n\n      // 2) aroundStage (acts as pre-handlers unless you later add true wrapping)\n      {\n        const res = await runList(AROUND(stageName));\n        if (res.outcome === 'respond' && stopOnRespond) return res;\n        if (res.outcome !== 'ok' && res.outcome !== 'respond') return res;\n      }\n\n      // 3) stage\n      let bodyOutcome: StageResult = { outcome: 'ok' };\n      {\n        const res = await runList(stageName, { ignoreRespond: false });\n        bodyOutcome = res;\n        if (res.outcome !== 'ok' && res.outcome !== 'respond') {\n          // fail/abort/next/handled/unknown → do NOT run did\n          return res;\n        }\n      }\n\n      // 4) didStage (run once regardless of body respond)\n      {\n        const res = await runList(DID(stageName), { ignoreRespond: true });\n        if (res.outcome !== 'ok' && res.outcome !== 'respond') return res;\n      }\n\n      if (bodyOutcome.outcome === 'respond') return bodyOutcome;\n      return { outcome: 'ok' };\n    };\n\n    // IMPORTANT: ignore typed stage names in plan arrays.\n    // Only base stage names in the plan drive execution; typed hooks run *with* their base.\n    const runStageGroup = async (\n      group: Array<string> | undefined,\n      stopOnRespond: boolean,\n      opts?: { ignoreRespond?: boolean },\n    ): Promise<StageResult> => {\n      if (!group || group.length === 0) return { outcome: 'ok' };\n\n      const seenBase = new Set<string>();\n      for (const rawKey of group) {\n        const { base, type } = parseTypedKey(rawKey);\n        if (type) {\n          // Soft warning once per typed key occurrence (optional)\n          // console.warn(`[flow] Ignoring typed stage \"${rawKey}\" in plan; hooks will run with base \"${base}\".`);\n          continue; // Do not run typed keys as standalone stages\n        }\n        if (seenBase.has(base)) continue;\n        seenBase.add(base);\n\n        const res = await runOneStage(base, stopOnRespond);\n        if (res.outcome === 'respond') {\n          if (stopOnRespond) return res;\n          // else keep going\n        } else if (res.outcome !== 'ok') {\n          return res;\n        }\n      }\n      return { outcome: 'ok' };\n    };\n\n    const runErrorStage = async () => {\n      await runStageGroup((plan as any).error, false, { ignoreRespond: true });\n    };\n\n    const runFinalizeStage = async () => {\n      await runStageGroup((plan as any).finalize, false);\n    };\n\n    try {\n      // ---------- PRE ----------\n      {\n        const pre = await runStageGroup((plan as any).pre, true);\n        if (pre.outcome === 'respond') {\n          const post = await runStageGroup((plan as any).post, false);\n          if (post.outcome === 'unknown_error' || post.outcome === 'fail') {\n            try {\n              await runErrorStage();\n            } finally {\n              await runFinalizeStage();\n            }\n            if (post.outcome === 'fail') throw post.control!;\n            throw post.control!;\n          }\n          if (post.outcome === 'abort' || post.outcome === 'next' || post.outcome === 'handled') {\n            await runFinalizeStage();\n            throw post.control as FlowControl;\n          }\n          await runFinalizeStage();\n          return responded;\n        }\n        if (pre.outcome === 'unknown_error' || pre.outcome === 'fail') {\n          try {\n            await runErrorStage();\n          } finally {\n            await runFinalizeStage();\n          }\n          if (pre.outcome === 'fail') throw pre.control!;\n          throw pre.control!;\n        }\n        if (pre.outcome === 'abort' || pre.outcome === 'next' || pre.outcome === 'handled') {\n          await runFinalizeStage();\n          throw pre.control as FlowControl;\n        }\n      }\n\n      // ---------- EXECUTE ----------\n      if (!responded) {\n        const exec = await runStageGroup((plan as any).execute, true);\n        if (exec.outcome === 'respond') {\n          // continue to post + finalize\n        } else if (exec.outcome === 'unknown_error' || exec.outcome === 'fail') {\n          try {\n            await runErrorStage();\n          } finally {\n            await runFinalizeStage();\n          }\n          if (exec.outcome === 'fail') throw exec.control!;\n          throw exec.control!;\n        } else if (exec.outcome === 'abort' || exec.outcome === 'next' || exec.outcome === 'handled') {\n          await runFinalizeStage();\n          throw exec.control as FlowControl;\n        }\n      }\n\n      // ---------- POST ----------\n      {\n        const post = await runStageGroup((plan as any).post, false);\n        if (post.outcome === 'unknown_error' || post.outcome === 'fail') {\n          try {\n            await runErrorStage();\n          } finally {\n            await runFinalizeStage();\n          }\n          if (post.outcome === 'fail') throw post.control!;\n          throw post.control!;\n        }\n        if (post.outcome === 'abort' || post.outcome === 'next' || post.outcome === 'handled') {\n          await runFinalizeStage();\n          throw post.control as FlowControl;\n        }\n      }\n\n      // ---------- FINALIZE ----------\n      await runFinalizeStage();\n\n      return responded;\n    } catch (e) {\n      throw e;\n    }\n  }\n}\n"]}

package/src/flows/flow.registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"flow.registry.js","sourceRoot":"","sources":["../../../src/flows/flow.registry.ts"],"names":[],"mappings":"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","sourcesContent":["import ProviderRegistry from '../provider/provider.registry';\nimport { RegistryAbstract, RegistryBuildMapResult } from '../regsitry';\nimport { FlowInputOf, FlowName, FlowOutputOf, FlowRecord, FlowType, ScopeEntry, Token, Type } from '../common';\nimport { normalizeFlow } from './flow.utils';\nimport { tokenName } from '../utils/token.utils';\nimport { FlowInstance } from './flow.instance';\n\nexport default class FlowRegistry extends RegistryAbstract<FlowInstance<FlowName>, FlowRecord, FlowType[]> {\n  constructor(providers: ProviderRegistry, list: FlowType[]) {\n    super('FlowRegistry', providers, list);\n  }\n\n  protected override buildMap(list: FlowType[]): RegistryBuildMapResult<FlowRecord> {\n    const tokens = new Set<Token>();\n    const defs = new Map<Token, FlowRecord>();\n    const graph = new Map<Token, Set<Token>>();\n\n    for (const raw of list) {\n      const rec = normalizeFlow(raw);\n      const provide = rec.provide;\n      tokens.add(provide);\n      defs.set(provide, rec);\n      graph.set(provide, new Set());\n    }\n\n    return { tokens, defs, graph };\n  }\n\n\n  protected buildGraph() {\n    for (const token of this.tokens) {\n      const rec = this.defs.get(token)!;\n      const deps = rec.metadata.dependsOn ?? [];\n\n      for (const d of deps) {\n        if (d == ScopeEntry) {\n          this.graph.get(token)!.add(ScopeEntry);\n        } else {\n          if (!this.providers.get(d)) {\n            throw new Error(`Flow ${tokenName(token)} depends on ${tokenName(d)}, which is not registered.`);\n          }\n          this.graph.get(token)!.add(d);\n        }\n      }\n    }\n  }\n\n  /** Instantiate adapters, run fetch/transform, and populate registries. */\n  protected async initialize(): Promise<void> {\n\n    const readyArr: Promise<void>[] = [];\n    for (const token of this.tokens) {\n      const instance = this.initializeOne(token);\n      readyArr.push(instance.ready);\n    }\n    await Promise.all(readyArr);\n  }\n\n  private initializeOne(token: Token) {\n    const rec = this.defs.get(token)!;\n    const deps = this.graph.get(token)!;\n\n    const instance = new FlowInstance(this.providers.getActiveScope(), rec, deps, this.providers);\n    this.instances.set(rec.metadata.name, instance);\n    return instance;\n  }\n\n\n  async registryFlows(rawFlows: FlowType[]): Promise<void> {\n    const readyArr: Promise<void>[] = [];\n    for (const raw of rawFlows) {\n      const rec = normalizeFlow(raw);\n      const provide = rec.provide;\n      this.tokens.add(provide);\n      this.defs.set(provide, rec);\n      this.graph.set(provide, new Set());\n      readyArr.push(this.initializeOne(provide).ready);\n    }\n    await Promise.all(readyArr);\n  }\n\n\n  runFlow<Name extends FlowName>(name: Name, input: FlowInputOf<Name>, deps?: Map<Token, Type>): Promise<FlowOutputOf<Name> | undefined> {\n    const flow = this.instances.get(name);\n    if (!flow) {\n      throw new Error(`Flow ${name} is not registered`);\n    }\n    return flow.run(input, deps ?? new Map());\n  }\n}\n"]}
+{"version":3,"file":"flow.registry.js","sourceRoot":"","sources":["../../../src/flows/flow.registry.ts"],"names":[],"mappings":"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","sourcesContent":["import ProviderRegistry from '../provider/provider.registry';\nimport { RegistryAbstract, RegistryBuildMapResult } from '../regsitry';\nimport { FlowInputOf, FlowName, FlowOutputOf, FlowRecord, FlowType, ScopeEntry, Token, Type } from '../common';\nimport { normalizeFlow } from './flow.utils';\nimport { tokenName } from '../utils/token.utils';\nimport { FlowInstance } from './flow.instance';\n\nexport default class FlowRegistry extends RegistryAbstract<FlowInstance<FlowName>, FlowRecord, FlowType[]> {\n  constructor(providers: ProviderRegistry, list: FlowType[]) {\n    super('FlowRegistry', providers, list);\n  }\n\n  protected override buildMap(list: FlowType[]): RegistryBuildMapResult<FlowRecord> {\n    const tokens = new Set<Token>();\n    const defs = new Map<Token, FlowRecord>();\n    const graph = new Map<Token, Set<Token>>();\n\n    for (const raw of list) {\n      const rec = normalizeFlow(raw);\n      const provide = rec.provide;\n      tokens.add(provide);\n      defs.set(provide, rec);\n      graph.set(provide, new Set());\n    }\n\n    return { tokens, defs, graph };\n  }\n\n  protected buildGraph() {\n    for (const token of this.tokens) {\n      const rec = this.defs.get(token)!;\n      const deps = rec.metadata.dependsOn ?? [];\n\n      for (const d of deps) {\n        if (d == ScopeEntry) {\n          this.graph.get(token)!.add(ScopeEntry);\n        } else {\n          if (!this.providers.get(d)) {\n            throw new Error(`Flow ${tokenName(token)} depends on ${tokenName(d)}, which is not registered.`);\n          }\n          this.graph.get(token)!.add(d);\n        }\n      }\n    }\n  }\n\n  /** Instantiate adapters, run fetch/transform, and populate registries. */\n  protected async initialize(): Promise<void> {\n    const readyArr: Promise<void>[] = [];\n    for (const token of this.tokens) {\n      const instance = this.initializeOne(token);\n      readyArr.push(instance.ready);\n    }\n    await Promise.all(readyArr);\n  }\n\n  private initializeOne(token: Token) {\n    const rec = this.defs.get(token)!;\n    const deps = this.graph.get(token)!;\n\n    const instance = new FlowInstance(this.providers.getActiveScope(), rec, deps, this.providers);\n    this.instances.set(rec.metadata.name, instance);\n    return instance;\n  }\n\n  async registryFlows(rawFlows: FlowType[]): Promise<void> {\n    const readyArr: Promise<void>[] = [];\n    for (const raw of rawFlows) {\n      const rec = normalizeFlow(raw);\n      const provide = rec.provide;\n      this.tokens.add(provide);\n      this.defs.set(provide, rec);\n      this.graph.set(provide, new Set());\n      readyArr.push(this.initializeOne(provide).ready);\n    }\n    await Promise.all(readyArr);\n  }\n\n  runFlow<Name extends FlowName>(\n    name: Name,\n    input: FlowInputOf<Name>,\n    deps?: Map<Token, Type>,\n  ): Promise<FlowOutputOf<Name> | undefined> {\n    const flow = this.instances.get(name);\n    if (!flow) {\n      throw new Error(`Flow ${name} is not registered`);\n    }\n    return flow.run(input, deps ?? new Map()) as Promise<FlowOutputOf<Name> | undefined>;\n  }\n}\n"]}

package/src/flows/flow.stages.js

@@ -6,6 +6,7 @@ exports.resolveStageKey = resolveStageKey;
 exports.collectFlowHookMap = collectFlowHookMap;
 exports.mergeHookMetasIntoStageMap = mergeHookMetasIntoStageMap;
 const common_1 = require("../common");
+const hook_decorator_1 = require("../common/decorators/hook.decorator");
 const cap = (s) => (s ? s[0].toUpperCase() + s.slice(1) : s);
 const CACHE = new WeakMap();
 function sortStageMap(table) {
@@ -30,13 +31,19 @@ function resolveStageKey(type, stage) {
 }
 function collectFlowHookMap(FlowClass) {
     const cached = CACHE.get(FlowClass);
-    if (cached)
+    if (cached) {
         return cached;
-    const metas = (Reflect.getMetadata(common_1.FrontMcpFlowHookTokens.hooks, FlowClass) ?? []);
+    }
+    // Get existing metadata (from legacy decorators)
+    const existingMetas = (Reflect.getMetadata(common_1.FrontMcpFlowHookTokens.hooks, FlowClass) ?? []);
+    // Resolve any pending TC39 decorator hooks
+    const tc39Metas = (0, hook_decorator_1.resolvePendingTC39HooksForClass)(FlowClass);
+    // Combine both sources
+    const metas = [...existingMetas, ...tc39Metas];
     const sorted = metas
         .map((m, i) => ({ m, i }))
         .sort((a, b) => (a.m.priority ?? 0) - (b.m.priority ?? 0) || a.i - b.i)
-        .map(x => x.m);
+        .map((x) => x.m);
     const table = {};
     let order = 0;
     for (const m of sorted) {
@@ -46,16 +53,13 @@ function collectFlowHookMap(FlowClass) {
             _order: order++,
             method: async (ctx) => {
                 const target = m.static ? FlowClass : ctx;
-                const impl = typeof m.method === 'function'
-                    ? m.method
-                    : target?.[m.method];
+                const impl = typeof m.method === 'function' ? m.method : target?.[m.method];
                 if (typeof impl !== 'function')
                     return;
                 if (m.filter && !(await m.filter(ctx)))
                     return;
                 if (m.type === 'around') {
-                    const next = async () => {
-                    };
+                    const next = async () => { };
                     return m.static ? impl.call(FlowClass, ctx, next) : impl.call(ctx, ctx, next);
                 }
                 else {
@@ -74,7 +78,7 @@ function mergeHookMetasIntoStageMap(FlowClass, table, metas, orderStart = 100_00
     const sorted = metas
         .map((m, i) => ({ m, i }))
         .sort((a, b) => (a.m.priority ?? 0) - (b.m.priority ?? 0) || a.i - b.i)
-        .map(x => x.m);
+        .map((x) => x.m);
     for (const m of sorted) {
         const resolved = resolveStageKey(m.type, m.stage);
         const entry = {
@@ -94,8 +98,7 @@ function mergeHookMetasIntoStageMap(FlowClass, table, metas, orderStart = 100_00
                 if (m.filter && !(await m.filter(ctx)))
                     return;
                 if (m.type === 'around') {
-                    const next = async () => {
-                    };
+                    const next = async () => { };
                     return m.static ? impl.call(target, ctx, next) : impl.call(target, ctx, next);
                 }
                 else {