Function tryClassifyConnectionError

src/utils/tool-handler-helpers.ts:89–109

(
  error: unknown,
  rawSourceId: string | undefined,
  displaySourceId: string
)

 * @param displaySourceId human-readable id used in the message + details
 */
export function tryClassifyConnectionError(
  error: unknown,
  rawSourceId: string | undefined,
  displaySourceId: string
): ReturnType<typeof createToolErrorResponse> | null {
  // Defensive: getSourceConfig throws if the manager is uninitialized. Keep
  // this helper as total as classifyConnectionError itself — never throw from
  // within a caller's catch block.
  let connectorType: ConnectorType | undefined;
  try {
    connectorType = ConnectorManager.getSourceConfig(rawSourceId)?.type;
  } catch {
    return null;
  }
  if (!connectorType) return null;
  const classified = classifyConnectionError(error, connectorType, displaySourceId);
  if (!classified) return null;
  return createToolErrorResponse(classified.message, classified.code, {
    source_id: displaySourceId,
  });
}

/**
 * Higher-order function to wrap tool handlers with automatic request tracking