@cyanheads/mcp-ts-core 0.13.12 → 0.13.13

package/dist/utils/internal/error-handler/errorHandler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errorHandler.d.ts","sourceRoot":"","sources":["../../../../src/utils/internal/error-handler/errorHandler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,OAAO,EAAE,gBAAgB,EAA8B,MAAM,0BAA0B,CAAC;AAoBxF,OAAO,KAAK,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAapE,0FAA0F;AAC1F,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAWD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAI/E;AAED;;GAEG;AAEH,qBAAa,YAAY;IACvB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACH,OAAc,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CA0DjE;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;IACH,OAAc,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,mBAAmB,GAAG,KAAK,CAqL7E;IAED;;;;;;;;;;OAUG;IACH,OAAc,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG;QAC1C,IAAI,EAAE,gBAAgB,CAAC;QACvB,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAChC,CAeA;IAED;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,OAAc,QAAQ,CAAC,CAAC,SAAS,KAAK,EACpC,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EACxC,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,GACxE,CAAC,GAAG,KAAK,CAgBX;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,OAAc,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAsBjE;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,OAAoB,QAAQ,CAAC,CAAC,EAC5B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EACxB,OAAO,EAAE,IAAI,CAAC,mBAAmB,EAAE,SAAS,CAAC,GAC5C,OAAO,CAAC,CAAC,CAAC,CAUZ;CACF"}
+{"version":3,"file":"errorHandler.d.ts","sourceRoot":"","sources":["../../../../src/utils/internal/error-handler/errorHandler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,OAAO,EAAE,gBAAgB,EAA8B,MAAM,0BAA0B,CAAC;AAmCxF,OAAO,KAAK,EAAgB,mBAAmB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAalF,0FAA0F;AAC1F,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AA8BD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAS/E;AAED;;GAEG;AAEH,qBAAa,YAAY;IACvB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACH,OAAc,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CA2DjE;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4CG;IACH,OAAc,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,mBAAmB,GAAG,KAAK,CA2N7E;IAED;;;;;;;;;;OAUG;IACH,OAAc,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG;QAC1C,IAAI,EAAE,gBAAgB,CAAC;QACvB,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAChC,CAkBA;IAED;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,OAAc,QAAQ,CAAC,CAAC,SAAS,KAAK,EACpC,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EACxC,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,GACxE,CAAC,GAAG,KAAK,CAgBX;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,OAAc,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAsBjE;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,OAAoB,QAAQ,CAAC,CAAC,EAC5B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EACxB,OAAO,EAAE,IAAI,CAAC,mBAAmB,EAAE,SAAS,CAAC,GAC5C,OAAO,CAAC,CAAC,CAAC,CAUZ;CACF"}

package/dist/utils/internal/error-handler/errorHandler.js

@@ -4,16 +4,18 @@
  * @module src/utils/internal/error-handler/errorHandler
  */
 import { SdkError, SdkErrorCode } from '@modelcontextprotocol/server';
-import { SpanStatusCode, trace } from '@opentelemetry/api';
+import { trace } from '@opentelemetry/api';
 import { ZodError } from 'zod';
 import { isInputRequiredSignal } from '../../../mcp-server/inputRequired.js';
 import { JsonRpcErrorCode, McpError, requestCancelled } from '../../../types-global/errors.js';
 import { logger } from '../logger.js';
+import { toLogValue } from '../logValue.js';
 import { generateUUID } from '../../security/idGenerator.js';
 import { sanitizeInputForLogging } from '../../security/sanitization.js';
 import { ATTR_MCP_ERROR_CATEGORY, ATTR_MCP_ERROR_CLASSIFIED_CODE, ATTR_MCP_ERROR_SEVERITY, } from '../../telemetry/attributes.js';
 import { createCounter } from '../../telemetry/metrics.js';
-import { extractErrorCauseChain, getErrorMessage, getErrorName } from './helpers.js';
+import { isRecord } from '../../types/guards.js';
+import { asError, copyFields, errorText, extractErrorCauseChain, getErrorMessage, getErrorName, isInstance, readErrorData, readField, readWireErrorData, recordSpanFailure, UNREADABLE, } from './helpers.js';
 import { COMPILED_ERROR_PATTERNS, COMPILED_PROVIDER_PATTERNS, ENGINE_RESOURCE_LIMIT_MESSAGES, ERROR_TYPE_MAPPINGS, getCompiledPattern, getErrorCategory, } from './mappings.js';
 let errorClassifiedCounter;
 function getErrorMetrics() {
@@ -24,11 +26,33 @@ function getErrorMetrics() {
 export function initErrorMetrics() {
     getErrorMetrics();
 }
-/** A copy of `record` without `key`, for an `includeStack: false` log record. */
-function withoutKey(record, key) {
-    const { [key]: _omitted, ...rest } = record;
+/**
+ * A record's `extra` as a stack-free record writes it, every field in one walk
+ * — the context's, `input`, `errorData`: each `Error` written without its
+ * `stack`, no `stack`, and none of `errorData`'s stack fields (`originalStack`,
+ * and on each `causeChain` node its `stack` and the same fields in its `data`).
+ * `extra` is the record's own object literal, so the walk returns an object
+ * whatever the context's `extra` was.
+ */
+function toStackFreeExtra(extra) {
+    const { stack: _stack, ...rest } = toLogValue(extra, { includeStack: false });
+    if (isRecord(rest.errorData))
+        dropStackFields(rest.errorData);
     return rest;
 }
+/** Deletes the record's stack fields from `data`, a walked copy, down its `causeChain`. */
+function dropStackFields(data) {
+    delete data.originalStack;
+    if (!Array.isArray(data.causeChain))
+        return;
+    for (const node of data.causeChain) {
+        if (!isRecord(node))
+            continue;
+        delete node.stack;
+        if (isRecord(node.data))
+            dropStackFields(node.data);
+    }
+}
 /**
  * The value a handler unwound with, resolved against its request's cancellation.
  *
@@ -63,8 +87,10 @@ function withoutKey(record, key) {
 export function asRequestCancelled(error, signal) {
     if (!signal.aborted || isInputRequiredSignal(error))
         return error;
-    if (error instanceof McpError && error.code === JsonRpcErrorCode.RequestCancelled)
+    if (isInstance(error, McpError) &&
+        readField(error, 'code') === JsonRpcErrorCode.RequestCancelled) {
         return error;
+    }
     return requestCancelled(getErrorMessage(error), undefined, { cause: error });
 }
 /**
@@ -81,7 +107,7 @@ export class ErrorHandler {
      * which outranks every step below.
      *
      * Resolution order:
-     * 1. `McpError` instances — returns `error.code` directly.
+     * 1. `McpError` instances — returns `error.code` directly (`InternalError` when the code cannot be read).
      * 2. SDK `ConnectionClosed` rejections — mapped to `RequestCancelled`, ahead of the pattern ladder.
      * 3. Engine resource-limit `RangeError`s — a whole message in `ENGINE_RESOURCE_LIMIT_MESSAGES`
      *    (stack overflow, maximum string size) maps to `InternalError` (#482).
@@ -107,8 +133,14 @@ export class ErrorHandler {
      * ```
      */
     static determineErrorCode(error) {
-        if (error instanceof McpError) {
-            return error.code;
+        /**
+         * Every read of the thrown value is guarded (#697): a value `instanceof`
+         * cannot inspect (a revoked `Proxy`) is classified as a non-Error, and a
+         * field whose read throws as `'[Unreadable]'`.
+         */
+        if (isInstance(error, McpError)) {
+            const code = readField(error, 'code');
+            return code === UNREADABLE ? JsonRpcErrorCode.InternalError : code;
         }
         /**
          * The SDK rejects every request still in flight when the transport closes,
@@ -117,7 +149,7 @@ export class ErrorHandler {
          * one wording, and the one that says "aborted" would otherwise be caught by
          * the generic abort pattern below and read as a `Timeout`.
          */
-        if (error instanceof SdkError && error.code === SdkErrorCode.ConnectionClosed) {
+        if (isInstance(error, SdkError) && readField(error, 'code') === SdkErrorCode.ConnectionClosed) {
             return JsonRpcErrorCode.RequestCancelled;
         }
         const errorName = getErrorName(error);
@@ -149,10 +181,7 @@ export class ErrorHandler {
             }
         }
         // Special-case common platform errors
-        if (typeof error === 'object' &&
-            error !== null &&
-            'name' in error &&
-            error.name === 'AbortError') {
+        if (typeof error === 'object' && error !== null && readField(error, 'name') === 'AbortError') {
             return JsonRpcErrorCode.Timeout;
         }
         return JsonRpcErrorCode.InternalError;
@@ -163,15 +192,24 @@ export class ErrorHandler {
      * Steps performed:
      * 1. Records the exception on the active OTel span and sets span status to ERROR.
      * 2. Sanitizes `options.input` via `sanitizeInputForLogging` before including in logs.
-     * 3. Extracts and consolidates error data, original stack, and the full cause chain.
+     * 3. Extracts and consolidates error data and the full cause chain.
      * 4. Rebuilds the error as a new `McpError` carrying the consolidated data — the thrown
-     *    error's own `data`, `originalErrorName`, `originalMessage`, and `rootCause` — preserving
-     *    the classified code (or delegates to `options.errorMapper`). That `data` is client-visible
-     *    once the error is thrown toward a handler, so it carries no stack and no `context`:
-     *    `originalStack`, `causeChain`, and the context ride the log record only.
+     *    error's own `data`, `originalErrorName`, and `originalMessage` — preserving the classified
+     *    code (or delegates to `options.errorMapper`). That `data` is client-visible once the error
+     *    is thrown toward a handler, so it carries nothing derived from a cause, no stack, and no
+     *    `context`: `rootCause`, `causeChain`, and the context ride the log record only. The
+     *    rebuilt error takes the thrown error's stack, so it starts at the throw site.
      * 5. Logs the result via the global logger with full structured context — at `error` level,
-     *    or at `info` without a stack for `RequestCancelled`, which is a routine caller disconnect.
-     *    `includeStack: false` logs no stack anywhere in the record (see `ErrorHandlerOptions`).
+     *    with the throw site's stack as the record's `stack` (none for a thrown value without one,
+     *    and never a context's `extra.stack`), and each stack written once: a `causeChain` node
+     *    carrying the record's stack, or the same stack as the node before it, is written without
+     *    it. The handler's own fields lead the record, ahead of the context's `extra` and `input`,
+     *    and no caller key replaces one. A field of the thrown value whose read throws is written
+     *    as `'[Unreadable]'`, so the call never throws on what it reports.
+     *    A record is stack-free for `RequestCancelled`, which is a routine caller disconnect logged
+     *    at `info`, and under `includeStack: false`: no `stack`, no `errorData.originalStack`, no
+     *    `causeChain` node `stack` nor `originalStack` in a node's `data`, and every `Error` in the
+     *    record written without its `stack` (see `ErrorHandlerOptions`).
      * 6. Returns the processed error, or rethrows it if `options.rethrow` is `true`.
      *
      * @param error - The error instance or value that occurred.
@@ -197,34 +235,42 @@ export class ErrorHandler {
         // --- OpenTelemetry Integration ---
         // Skip ended/no-op spans — measure*Execution paths already record + end the span before re-throwing.
         const activeSpan = trace.getActiveSpan();
-        if (activeSpan?.isRecording()) {
-            if (error instanceof Error) {
-                activeSpan.recordException(error);
-            }
-            activeSpan.setStatus({
-                code: SpanStatusCode.ERROR,
-                message: error instanceof Error ? error.message : String(error),
-            });
-        }
+        if (activeSpan?.isRecording())
+            recordSpanFailure(activeSpan, error);
         // --- End OpenTelemetry Integration ---
         const { context = {}, operation, input, rethrow = false, errorCode: explicitErrorCode, includeStack = true, critical = false, errorMapper, severity, } = options;
         const sanitizedInput = input !== undefined ? sanitizeInputForLogging(input) : undefined;
+        /**
+         * Every read of the thrown value is guarded: a `name`, `message`, `stack`,
+         * `cause`, or an `McpError`'s `code` whose read throws (a getter, a revoked
+         * `Proxy`), or a `data` that cannot be read or copied, is written as
+         * `'[Unreadable]'` or left out, and a value `instanceof` cannot inspect is
+         * handled as a non-Error, so reporting a failure never fails itself (#697).
+         */
         const originalErrorName = getErrorName(error);
         const originalErrorMessage = getErrorMessage(error);
-        const originalStack = error instanceof Error ? error.stack : undefined;
+        const thrownError = isInstance(error, Error) ? error : undefined;
+        const thrownMcpError = isInstance(error, McpError) ? error : undefined;
+        const originalStack = thrownError ? readField(thrownError, 'stack') : undefined;
         /**
          * Classified before the record is assembled, because the code decides more
          * than the wire response: a caller-abandoned request is a routine event, so
          * it is logged at `info` and carries no stack. Attaching one invites triage
          * to read a client hanging up as a fault in this server.
          */
-        const loggedErrorCode = error instanceof McpError
-            ? error.code
+        const loggedErrorCode = thrownMcpError
+            ? ErrorHandler.determineErrorCode(thrownMcpError)
             : explicitErrorCode || ErrorHandler.determineErrorCode(error);
         const isCancellation = loggedErrorCode === JsonRpcErrorCode.RequestCancelled;
-        const errorDataSeed = error instanceof McpError && typeof error.data === 'object' && error.data !== null
-            ? { ...error.data }
-            : {};
+        /**
+         * A stack-free record has none of the stack fields `ErrorHandlerOptions.includeStack`
+         * lists, and writes every `Error` in it without its `stack` — whether this
+         * handler, the thrown `McpError`'s own `data`, the context, or `input`
+         * supplied it (#650). Any other key named `stack` is a caller's data and is
+         * written as given. The returned error is the same either way.
+         */
+        const stackFree = !includeStack || isCancellation;
+        const errorDataSeed = readErrorData(error) ?? {};
         /**
          * `consolidatedData` becomes `McpError.data`, which the tool handler puts on
          * `structuredContent.error.data`. It carries the thrown error's own data and
@@ -239,34 +285,58 @@ export class ErrorHandler {
             originalMessage: originalErrorMessage,
         };
         /**
-         * Stack-bearing diagnostics go to the log record only, never into the
+         * What the cause chain says goes to the log record only, never into the
          * returned error's `data`: `tryCatch` throws that error, and tools and
-         * resources forward an `McpError`'s `data` to the client verbatim (#519).
-         * A cancellation carries neither — its every node would hold a stack and
-         * invite triage to read a caller hanging up as a fault in this server.
-         * `includeStack: false` keeps the chain but logs no stack on any of its
-         * nodes; the record's `originalStack` is dropped where it is logged (#586).
+         * resources forward an `McpError`'s `data` to the client verbatim (#519),
+         * so a message redacted at the throw site would reach the client raw
+         * through its cause (#644). A cancellation carries no chain — its every
+         * node would hold a stack and invite triage to read a caller hanging up
+         * as a fault in this server. `includeStack: false` keeps the chain, and
+         * the stack-free record logs none of its nodes' stacks (#586).
          */
         const diagnostics = {};
-        if (originalStack &&
-            !isCancellation &&
-            !(error instanceof McpError && error.data?.originalStack)) {
-            diagnostics.originalStack = originalStack;
-        }
-        const cause = error instanceof Error ? error : undefined;
-        if (!isCancellation && error instanceof Error && error.cause) {
-            const causeChain = extractErrorCauseChain(error);
+        if (!isCancellation && thrownError && readField(thrownError, 'cause')) {
+            const causeChain = extractErrorCauseChain(thrownError);
             const rootCause = causeChain.at(-1);
             if (rootCause) {
-                consolidatedData.rootCause = { name: rootCause.name, message: rootCause.message };
-                diagnostics.causeChain = includeStack
-                    ? causeChain
-                    : causeChain.map(({ stack: _stack, ...node }) => node.data ? { ...node, data: withoutKey(node.data, 'originalStack') } : node);
+                diagnostics.rootCause = { name: rootCause.name, message: rootCause.message };
+                /**
+                 * A node whose stack is the record's own, or the node's before it, is
+                 * written without it — the rule the log walk applies to an `Error`'s
+                 * `cause` — so the record carries each stack once (#694): the thrown
+                 * error itself, and every error a nested `tryCatch` rebuilt from
+                 * another. A stack that could not be read is no stack to repeat.
+                 */
+                diagnostics.causeChain = causeChain.map((node, i) => {
+                    const { stack } = node;
+                    const repeated = stack === originalStack || stack === causeChain[i - 1]?.stack;
+                    if (stack === undefined || stack === UNREADABLE || !repeated)
+                        return node;
+                    const { stack: _stack, ...rest } = node;
+                    return rest;
+                });
             }
         }
         const finalError = errorMapper
             ? errorMapper(error)
-            : new McpError(loggedErrorCode, originalErrorMessage, consolidatedData, { cause });
+            : new McpError(loggedErrorCode, originalErrorMessage, consolidatedData, {
+                cause: thrownError,
+            });
+        /**
+         * The rebuilt error takes the throw site's stack, so the error `tryCatch`
+         * rethrows starts where the failure happened rather than here (#694). It is
+         * copied verbatim: the header line names the class that was thrown, and
+         * `finalErrorType` on the record names the rebuilt one. A mapper's result
+         * keeps the stack its mapper gave it, and takes the throw site's only when
+         * it has none. A throw-site stack that could not be read is not copied.
+         */
+        if (typeof originalStack === 'string' &&
+            originalStack &&
+            originalStack !== UNREADABLE &&
+            finalError !== error &&
+            (!errorMapper || !finalError.stack)) {
+            finalError.stack = originalStack;
+        }
         /**
          * Record error classification metric. The category is the same
          * `getErrorCategory` answer the per-surface error counters carry, handed
@@ -281,47 +351,64 @@ export class ErrorHandler {
          */
         getErrorMetrics().errorClassifiedCounter.add(1, {
             [ATTR_MCP_ERROR_CLASSIFIED_CODE]: String(loggedErrorCode),
-            [ATTR_MCP_ERROR_CATEGORY]: getErrorCategory(loggedErrorCode, error instanceof McpError ? error.data : undefined),
+            [ATTR_MCP_ERROR_CATEGORY]: getErrorCategory(loggedErrorCode, errorDataSeed),
             operation,
             ...(severity !== undefined && { [ATTR_MCP_ERROR_SEVERITY]: severity }),
         });
-        if (finalError !== error &&
-            error instanceof Error &&
-            finalError instanceof Error &&
-            !finalError.stack &&
-            error.stack) {
-            finalError.stack = error.stack;
-        }
-        const logRequestId = typeof context.requestId === 'string' && context.requestId
-            ? context.requestId
+        /**
+         * The context is read once, through these copies: a field that throws when
+         * read — an own getter, a `Proxy` trap — would otherwise fail the call that
+         * reports a failure. A copy that throws is written as `'[Unreadable]'` in
+         * the record, under `context` or `extra`.
+         */
+        const contextFields = copyFields(context);
+        const { extra: contextExtra, ...contextCanonical } = contextFields ?? {};
+        const extraFields = copyFields(contextExtra);
+        const logRequestId = typeof contextCanonical.requestId === 'string' && contextCanonical.requestId
+            ? contextCanonical.requestId
             : generateUUID();
-        const logTimestamp = typeof context.timestamp === 'string' && context.timestamp
-            ? context.timestamp
+        const logTimestamp = typeof contextCanonical.timestamp === 'string' && contextCanonical.timestamp
+            ? contextCanonical.timestamp
             : new Date().toISOString();
-        const stack = finalError instanceof Error ? finalError.stack : originalStack;
-        const errorData = {
-            ...(finalError instanceof McpError && finalError.data ? finalError.data : consolidatedData),
-            ...diagnostics,
+        /**
+         * Read and copied as the thrown value's is: an `errorMapper` may return the
+         * very error it was given. A `data` that cannot be read or copied gives way
+         * to `consolidatedData`.
+         */
+        const errorData = { ...(readErrorData(finalError) ?? consolidatedData), ...diagnostics };
+        const handlerFields = {
+            critical,
+            errorCode: loggedErrorCode,
+            originalErrorType: originalErrorName,
+            finalErrorType: getErrorName(finalError),
+            errorData,
+            // The record's one stack: the throw site's, absent for a thrown value with none (#694).
+            ...(originalStack ? { stack: originalStack } : {}),
+        };
+        // A context's `extra.stack` never stands in for the throw site's (#694).
+        const { stack: _contextStack, ...callerExtra } = extraFields ?? { extra: UNREADABLE };
+        /**
+         * The handler's own fields lead the record, so the log walk, which works
+         * in key order, reaches `errorData` before caller-sized `extra` and `input`
+         * can spend its bound on what it writes (#649); spread again last, so a
+         * caller's key never replaces one.
+         */
+        const recordExtra = {
+            ...handlerFields,
+            ...callerExtra,
+            ...(contextFields === undefined && { context: UNREADABLE }),
+            input: sanitizedInput,
+            ...handlerFields,
         };
-        const { extra: contextExtra = {}, ...contextCanonical } = context;
         const logContext = {
             operation,
             ...contextCanonical,
             requestId: logRequestId,
             timestamp: logTimestamp,
-            extra: {
-                // `extra.stack` is the record's stack field, whoever set it.
-                ...(includeStack ? contextExtra : withoutKey(contextExtra, 'stack')),
-                input: sanitizedInput,
-                critical,
-                errorCode: loggedErrorCode,
-                originalErrorType: originalErrorName,
-                finalErrorType: getErrorName(finalError),
-                errorData: includeStack ? errorData : withoutKey(errorData, 'originalStack'),
-                ...(includeStack && stack && !isCancellation ? { stack } : {}),
-            },
+            extra: stackFree ? toStackFreeExtra(recordExtra) : recordExtra,
         };
-        const logDescription = finalError.message || originalErrorMessage;
+        const finalMessage = readField(finalError, 'message');
+        const logDescription = finalMessage ? errorText(finalMessage) : originalErrorMessage;
         if (isCancellation) {
             logger.info(`Cancelled ${operation}: ${logDescription}`, logContext);
         }
@@ -350,14 +437,17 @@ export class ErrorHandler {
      *          the full `issues` array so clients can render field-level errors).
      */
     static classifyOnly(error) {
-        if (error instanceof McpError) {
-            return { code: error.code, message: error.message };
+        if (isInstance(error, McpError)) {
+            return {
+                code: ErrorHandler.determineErrorCode(error),
+                message: errorText(readField(error, 'message')),
+            };
         }
-        if (error instanceof ZodError) {
+        if (isInstance(error, ZodError)) {
             return {
                 code: JsonRpcErrorCode.ValidationError,
                 message: getErrorMessage(error),
-                data: { issues: error.issues },
+                data: { issues: readField(error, 'issues') },
             };
         }
         return {
@@ -403,15 +493,23 @@ export class ErrorHandler {
         if (defaultFactory) {
             return defaultFactory(error);
         }
-        return error instanceof Error ? error : new Error(String(error));
+        return asError(error);
     }
     /**
      * Formats an error into a consistent `{ code, message, data }` structure for API responses or structured logging.
      *
-     * - `McpError` → `{ code: error.code, message: error.message, data: error.data ?? {} }`
+     * - `McpError` → `{ code: error.code, message: error.message, data: <a copy of error.data> ?? {} }`
      * - `Error` → `{ code: determineErrorCode(error), message: error.message, data: { errorType: error.name } }`
      * - Other values → `{ code: JsonRpcErrorCode.UnknownError, message: getErrorMessage(value), data: { errorType: getErrorName(value) } }`
      *
+     * Never throws on the value it formats: a `message` or `name` whose read throws is
+     * `'[Unreadable]'`, one that is not a string is written as text (`String` for a
+     * primitive, `'[Unreadable]'` for an object), a `data` that cannot be read or copied
+     * (a revoked `Proxy`) is `{}`, and a value `instanceof` cannot inspect (a revoked
+     * `Proxy`) is formatted as a non-Error. Every `data` field is one a response can
+     * carry: one `JSON.stringify` cannot write is `'[Unreadable]'`, and one that takes
+     * more than 1,000,000 JSON values to write is `'[Truncated]'`.
+     *
      * @param error - The error instance or value to format.
      * @returns A plain object with `code` (numeric `JsonRpcErrorCode`), `message` (string), and `data` (object).
      *
@@ -425,18 +523,18 @@ export class ErrorHandler {
      * ```
      */
     static formatError(error) {
-        if (error instanceof McpError) {
+        if (isInstance(error, McpError)) {
             return {
-                code: error.code,
-                message: error.message,
-                data: typeof error.data === 'object' && error.data !== null ? error.data : {},
+                code: ErrorHandler.determineErrorCode(error),
+                message: errorText(readField(error, 'message')),
+                data: readWireErrorData(error) ?? {},
             };
         }
-        if (error instanceof Error) {
+        if (isInstance(error, Error)) {
             return {
                 code: ErrorHandler.determineErrorCode(error),
-                message: error.message,
-                data: { errorType: error.name || 'Error' },
+                message: errorText(readField(error, 'message')),
+                data: { errorType: getErrorName(error) },
             };
         }
         return {
@@ -454,9 +552,9 @@ export class ErrorHandler {
      * error-handling boilerplate.
      *
      * The thrown error's `data` reaches the client when a tool or resource handler lets it propagate,
-     * so it carries the caught error's own `data`, `originalErrorName`, `originalMessage`, and
-     * `rootCause`, but no stack and nothing from `options.context`; the throw-site stack, the cause
-     * chain, and the context are logged (#548).
+     * so it carries the caught error's own `data`, `originalErrorName`, and `originalMessage`, but
+     * nothing derived from a cause, no stack, and nothing from `options.context`; the throw-site
+     * stack, `rootCause`, the cause chain, and the context are logged (#548, #644).
      *
      * @template T The expected return type of `fn`.
      * @param fn - The function to execute. May be synchronous or return a `Promise`.

package/dist/utils/internal/error-handler/errorHandler.js.map

@@ -1 +1 @@
-{"version":3,"file":"errorHandler.js","sourceRoot":"","sources":["../../../../src/utils/internal/error-handler/errorHandler.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"errorHandler.js","sourceRoot":"","sources":["../../../../src/utils/internal/error-handler/errorHandler.ts"],"names":[],"mappings":"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"}

package/dist/utils/internal/error-handler/helpers.d.ts

@@ -3,7 +3,68 @@
  * Enhanced with cause chain extraction and circular reference detection.
  * @module src/utils/internal/error-handler/helpers
  */
+import { type Span } from '@opentelemetry/api';
 import { ZodError } from 'zod';
+/**
+ * What the error path writes for a field whose read throws — a getter, a
+ * `Proxy` trap, a revoked `Proxy` — as the log-data walk does.
+ */
+export declare const UNREADABLE = "[Unreadable]";
+/** `value[key]`, or {@link UNREADABLE} when reading it throws. */
+export declare function readField(value: object, key: PropertyKey): unknown;
+/**
+ * An error's `message` or `name`, as read, written as text: a string as it is;
+ * any other primitive as `String` converts it, which runs no caller code and
+ * never throws, a `Symbol` included (`'Symbol(description)'`), so a `message`
+ * set to `404` reads `'404'`; and an object or function as {@link UNREADABLE},
+ * since converting one runs its own `toString`, which can throw or return
+ * anything.
+ */
+export declare function errorText(value: unknown): string;
+/**
+ * `value instanceof type`, or `false` when the check throws — a revoked
+ * `Proxy`, a `getPrototypeOf` trap — so such a value is handled as the
+ * non-instance it cannot be shown not to be.
+ */
+export declare function isInstance<T>(value: unknown, type: abstract new (...args: never[]) => T): value is T;
+/**
+ * A copy of `value`'s own enumerable fields, as a spread makes it (`{}` for
+ * `undefined`), or `undefined` when making it throws — a getter that throws, a
+ * `Proxy` whose trap throws.
+ */
+export declare function copyFields<T extends object>(value: T | undefined): T | undefined;
+/**
+ * A shallow copy of the `data` a thrown `McpError` carries, so the error path
+ * reads plain fields rather than the thrown value's. Nothing is serialized: the
+ * log record writes the copy through the bounded log walk, and the wire
+ * boundaries check it with {@link readWireErrorData}. `undefined` when `error`
+ * is not an `McpError`, carries no object `data`, or its `data` cannot be read
+ * or copied — a getter, a revoked `Proxy`, a throwing `ownKeys` trap.
+ */
+export declare function readErrorData(error: unknown): Record<string, unknown> | undefined;
+/**
+ * {@link readErrorData} for a response: every field is one the wire carries.
+ * A field `JSON.stringify` cannot write is {@link UNREADABLE}, since a response
+ * holding one is never sent and the client waits for it, and a field that takes
+ * more than {@link WIRE_VALUES} JSON values to write is `'[Truncated]'`. Every
+ * other field is the thrown value itself, so readable `data` is sent byte for
+ * byte as thrown.
+ */
+export declare function readWireErrorData(error: unknown): Record<string, unknown> | undefined;
+/**
+ * `value` when it is an `Error`, else an `Error` whose message is `String(value)`
+ * — or {@link UNREADABLE} when the value can be neither checked nor converted
+ * (a revoked `Proxy`, a null-prototype object).
+ */
+export declare function asError(value: unknown): Error;
+/**
+ * Marks `span` failed with `error`: records an `Error` as the span's exception,
+ * then sets the `ERROR` status with its `message` (any other value as `String`
+ * converts it). Never throws: an exception the span cannot read — a field
+ * whose getter throws, which the SDK's `recordException` reads unguarded — is
+ * left unrecorded, and a message that cannot be read is {@link UNREADABLE}.
+ */
+export declare function recordSpanFailure(span: Span, error: unknown): void;
 /**
  * Formats a ZodError as a single readable line: `<dotted.path>: <message>`.
  *
@@ -26,11 +87,13 @@ export declare function formatZodErrorMessage(err: ZodError): string;
 /**
  * Retrieves a descriptive name for an error object or value.
  *
- * - `Error` instances → `error.name` (e.g. `'TypeError'`), falling back to `'Error'`.
+ * - `Error` instances → `error.name` (e.g. `'TypeError'`), falling back to `'Error'`;
+ *   a `name` that is not a string is written as {@link errorText} writes it.
  * - `null` → `'NullValueEncountered'`
  * - `undefined` → `'UndefinedValueEncountered'`
  * - Non-plain objects with a named constructor → `'<ConstructorName>Encountered'`
  * - Everything else → `'<typeof value>Encountered'` (e.g. `'stringEncountered'`)
+ * - A value whose inspection throws (a `name` getter, a revoked `Proxy`) → `'[Unreadable]'`
  *
  * @param error - The error object or value.
  * @returns A stable, human-readable string identifying the error's type.
@@ -47,13 +110,16 @@ export declare function getErrorName(error: unknown): string;
  * Extracts a human-readable message string from any thrown value.
  *
  * Handles every JavaScript type so that `catch (e)` blocks never produce `[object Object]`:
- * - `AggregateError` → combines up to 3 inner error messages after the outer message.
- * - `Error` → `error.message`
+ * - `AggregateError` → combines up to 3 inner error messages after the outer message,
+ *   each one that cannot be read as `'[Unreadable]'`.
+ * - `Error` → `error.message`, or `'[Unreadable]'` when reading it throws (a getter);
+ *   a `message` that is not a string, the outer's or a member's, as {@link errorText} writes it.
  * - `null` / `undefined` → descriptive literal strings.
  * - Primitives (`string`, `number`, `boolean`, `bigint`, `symbol`) → string-coerced value.
  * - Functions → `[function <name>]`
  * - Objects → JSON-serialized if possible; otherwise constructor name fallback.
- * - If conversion itself throws, returns a safe fallback describing the conversion error.
+ * - A value whose inspection throws (a getter, a `Proxy` trap, a revoked `Proxy`) →
+ *   `'[Unreadable]'`, never the text of what the read threw.
  *
  * @param error - The thrown value to extract a message from.
  * @returns A non-empty string describing the error.
@@ -105,6 +171,11 @@ export interface ErrorCauseNode {
  * `McpError` nodes include the `data` property when present, and any `Error`
  * node carrying a string `code` includes it.
  * Circular references are detected via `WeakSet` identity tracking.
+ * Every read is guarded: a `name`, `message`, or `stack` whose read throws is
+ * `'[Unreadable]'` on its node, an unreadable `code` or `data` is left out, and
+ * a cause that cannot be read or inspected — a throwing `cause` getter, a
+ * revoked `Proxy` — ends the chain as a node whose `name` and `message` are
+ * both `'[Unreadable]'`.
  *
  * @param error - The outermost error to start traversal from.
  * @param maxDepth - Maximum number of nodes to traverse before stopping. Defaults to `20`.