Class RegistryError

constructor

• new RegistryError(
      message: string,
      itemType: "resource" | "tool" | "prompt",
      itemName: string,
      options?: Omit<BaseErrorOptions, "code">,
  ): RegistryError

  Parameters

  • message: string
  • itemType: "resource" | "tool" | "prompt"
  • itemName: string
  • options: Omit<BaseErrorOptions, "code"> = {}

  Returns RegistryError

Optional Readonlycause

Readonlycode

Optional Readonlycontext

ReadonlyerrorId

ReadonlyitemName

ReadonlyitemType

ReadonlymcpCode

message

name

Optional ReadonlyrecoveryHint

Optionalstack

ReadonlystatusCode

Readonlytimestamp

StaticstackTraceLimit

toDetailedString

• toDetailedString(): string

  Create a human-readable error message including cause chain.

  Returns string

  Detailed error string with cause chain

toJSON

• toJSON(): SerializedError

  Serialize error for logging or API response. Excludes stack trace in production for security.

  Returns SerializedError

  Serialized error object

StaticcaptureStackTrace

• captureStackTrace(targetObject: object, constructorOpt?: Function): void

  Creates a .stack property on targetObject, which when accessed returns a string representing the location in the code at which Error.captureStackTrace() was called.

  const myObject = {};
  Error.captureStackTrace(myObject);
  myObject.stack;  // Similar to `new Error().stack`
  Copy

  The first line of the trace will be prefixed with ${myObject.name}: ${myObject.message}.

  The optional constructorOpt argument accepts a function. If given, all frames above constructorOpt, including constructorOpt, will be omitted from the generated stack trace.

  The constructorOpt argument is useful for hiding implementation details of error generation from the user. For instance:

  function a() {
    b();
  }
  
  function b() {
    c();
  }
  
  function c() {
    // Create an error without stack trace to avoid calculating the stack trace twice.
    const { stackTraceLimit } = Error;
    Error.stackTraceLimit = 0;
    const error = new Error();
    Error.stackTraceLimit = stackTraceLimit;
  
    // Capture the stack trace above function b
    Error.captureStackTrace(error, b); // Neither function c, nor b is included in the stack trace
    throw error;
  }
  
  a();
  Copy

  Parameters

  • targetObject: object
  • OptionalconstructorOpt: Function

  Returns void

Staticduplicate

• duplicate(itemType: string, itemName: string): RegistryError

  Create a RegistryError for a generic duplicate registration.

  Parameters

  • itemType: string

    The type of item (e.g., 'Tool', 'Resource', 'Prompt')

  • itemName: string

    The name of the item

  Returns RegistryError

StaticduplicatePrompt

• duplicatePrompt(name: string): RegistryError

  Create a RegistryError for duplicate prompt registration.

  Parameters

  • name: string

  Returns RegistryError

StaticduplicateResource

• duplicateResource(name: string): RegistryError

  Create a RegistryError for duplicate resource registration.

  Parameters

  • name: string

  Returns RegistryError

StaticduplicateTool

• duplicateTool(name: string): RegistryError

  Create a RegistryError for duplicate tool registration.

  Parameters

  • name: string

  Returns RegistryError

StaticisAppError

• isAppError(error: unknown): error is AppError

  Type guard to check if an error is a AppError instance.

  Parameters

  • error: unknown

    The error to check

  Returns error is AppError

  True if error is a AppError

StaticisCancellation

• isCancellation(error: unknown): boolean

  Check if an error is a cancellation error. Handles both OperationCancelledError and native AbortError.

  Parameters

  • error: unknown

    The error to check

  Returns boolean

  True if error represents a cancellation

StaticprepareStackTrace

• prepareStackTrace(err: Error, stackTraces: CallSite[]): any

  Parameters

  • err: Error
  • stackTraces: CallSite[]

  Returns any

  See

  https://v8.dev/docs/stack-trace-api#customizing-stack-traces

StaticpromptNotFound

• promptNotFound(name: string): RegistryError

  Create a RegistryError for a prompt not found.

  Parameters

  • name: string

  Returns RegistryError

StaticresourceNotFound

• resourceNotFound(name: string): RegistryError

  Create a RegistryError for a resource not found.

  Parameters

  • name: string

  Returns RegistryError

StatictoolNotFound

• toolNotFound(name: string): RegistryError

  Create a RegistryError for a tool not found.

  Parameters

  • name: string

  Returns RegistryError

Staticwrap

• wrap(error: unknown, defaultMessage?: string): AppError

  Wrap any error as a AppError. If already a AppError, returns it unchanged.

  Parameters

  • error: unknown

    The error to wrap

  • defaultMessage: string = "An unexpected error occurred"

    Message to use if error has none

  Returns AppError

  A AppError instance

StaticwrapWithContext

• wrapWithContext(error: unknown, context: Record<string, unknown>): AppError

  Create a AppError from an unknown error, preserving type if already AppError. Useful for catch blocks where you want to re-throw with additional context.

  Parameters

  • error: unknown

    The error to wrap

  • context: Record<string, unknown>

    Additional context to add

  Returns AppError

  A AppError with merged context