@od-oneapp/ai-platform 0.1.0

package/dist/client-CpacYDIE.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-CpacYDIE.mjs","names":[],"sources":["../src/tools/mcp/ai-sdk-error-integration.ts","../src/tools/mcp/client.ts"],"sourcesContent":["/**\n * @fileoverview ai-sdk-error-integration.ts\n */\n\nimport { logError, logInfo, logWarn } from '@repo/shared/logs';\n\nimport 'server-only';\nimport { getErrorCode } from '../../server/errors';\n\n/**\n * AI SDK v6 Error Integration for MCP\n * Provides standardized error handling patterns that integrate with AI SDK v6 error callbacks\n *\n * Key Features:\n * - onUncaughtError handler integration\n * - Stream error forwarding\n * - Proper error type conformance with AI SDK conventions\n * - Resource cleanup coordination\n * - Error recovery mechanisms\n */\n\n/**\n * AI SDK v6 compatible error types\n * These align with the error types expected by AI SDK callbacks\n */\nexport type AISDKErrorType =\n  | 'connection-error'\n  | 'transport-error'\n  | 'tool-execution-error'\n  | 'timeout-error'\n  | 'validation-error'\n  | 'resource-exhausted'\n  | 'unknown-error';\n\n/**\n * Enhanced error class that conforms to AI SDK v6 error handling patterns\n */\nexport class AISDKCompatibleMCPError extends Error {\n  public readonly errorType: AISDKErrorType;\n  public readonly timestamp: Date;\n  public readonly recoverable: boolean;\n  public readonly metadata: Record<string, unknown>;\n\n  constructor(\n    message: string,\n    errorType: AISDKErrorType = 'unknown-error',\n    originalError?: Error,\n    metadata: Record<string, unknown> = {},\n    recoverable: boolean = false,\n  ) {\n    super(message);\n    this.name = 'AISDKCompatibleMCPError';\n    this.errorType = errorType;\n    this.timestamp = new Date();\n    this.recoverable = recoverable;\n    this.metadata = {\n      ...metadata,\n      originalError: originalError?.message,\n      originalStack: originalError?.stack,\n    };\n\n    // Maintain stack trace\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, AISDKCompatibleMCPError);\n    }\n  }\n\n  /**\n   * Convert to AI SDK error format for logging\n   */\n  toAISDKFormat() {\n    return {\n      name: this.name,\n      message: this.message,\n      errorType: this.errorType,\n      timestamp: this.timestamp.toISOString(),\n      recoverable: this.recoverable,\n      metadata: this.metadata,\n      stack: this.stack,\n    };\n  }\n}\n\n/**\n * Error handler factory for MCP operations\n * Creates standardized error handlers that integrate with AI SDK v6 patterns\n */\nexport class MCPErrorHandlerFactory {\n  private clientName: string;\n  private operationContext: string;\n\n  constructor(clientName: string, operationContext: string = 'mcp-operation') {\n    this.clientName = clientName;\n    this.operationContext = operationContext;\n  }\n\n  /**\n   * Create an onUncaughtError handler for AI SDK v6 integration\n   */\n  createUncaughtErrorHandler(\n    cleanupFn: () => Promise<void>,\n    options: {\n      enableRecovery?: boolean;\n      maxRecoveryAttempts?: number;\n      logLevel?: 'error' | 'warn' | 'info';\n    } = {},\n  ): (error: Error) => void {\n    const { enableRecovery = false, maxRecoveryAttempts = 1, logLevel = 'error' } = options;\n    let recoveryAttempts = 0;\n\n    return (error: Error) => {\n      const aiError = this.convertToAISDKError(error);\n\n      // Log the error according to AI SDK patterns\n      const logFn = logLevel === 'warn' ? logWarn : logLevel === 'info' ? logInfo : logError;\n      logFn(`MCP uncaught error in ${this.operationContext}`, {\n        operation: 'mcp_uncaught_error_handler',\n        metadata: {\n          clientName: this.clientName,\n          errorType: aiError.errorType,\n          recoverable: aiError.recoverable,\n          recoveryAttempts,\n          maxRecoveryAttempts,\n          ...aiError.metadata,\n        },\n        error: aiError,\n      });\n\n      // Attempt recovery if enabled and error is recoverable\n      if (enableRecovery && aiError.recoverable && recoveryAttempts < maxRecoveryAttempts) {\n        recoveryAttempts++;\n        logInfo(\n          `Attempting recovery for MCP error (attempt ${recoveryAttempts}/${maxRecoveryAttempts})`,\n          {\n            operation: 'mcp_error_recovery_attempt',\n            metadata: {\n              clientName: this.clientName,\n              recoveryAttempt: recoveryAttempts,\n              errorType: aiError.errorType,\n            },\n          },\n        );\n\n        // Recovery is handled by not calling cleanup immediately\n        // The caller should implement retry logic\n        return;\n      }\n\n      // Perform cleanup for non-recoverable errors or exhausted recovery attempts\n      void (async () => {\n        try {\n          await cleanupFn();\n        } catch (cleanupError) {\n          logError(`Failed to cleanup after uncaught error in ${this.operationContext}`, {\n            operation: 'mcp_cleanup_after_uncaught_error',\n            metadata: {\n              clientName: this.clientName,\n              originalError: aiError.message,\n              cleanupError:\n                cleanupError instanceof Error ? cleanupError.message : String(cleanupError),\n            },\n            error: cleanupError instanceof Error ? cleanupError : new Error(String(cleanupError)),\n          });\n        }\n      })();\n    };\n  }\n\n  /**\n   * Create a stream error handler for AI SDK v6 streaming integration\n   */\n  createStreamErrorHandler(\n    cleanupFn: () => Promise<void>,\n    onStreamError?: (error: AISDKCompatibleMCPError) => void,\n  ): (error: Error) => void {\n    return (error: Error) => {\n      const aiError = this.convertToAISDKError(error, 'transport-error');\n\n      logError(`MCP stream error in ${this.operationContext}`, {\n        operation: 'mcp_stream_error_handler',\n        metadata: {\n          clientName: this.clientName,\n          errorType: aiError.errorType,\n          streamContext: this.operationContext,\n          ...aiError.metadata,\n        },\n        error: aiError,\n      });\n\n      // Notify stream error callback if provided\n      if (onStreamError) {\n        try {\n          onStreamError(aiError);\n        } catch (callbackError) {\n          logError(`Stream error callback failed in ${this.operationContext}`, {\n            operation: 'mcp_stream_error_callback_failure',\n            metadata: {\n              clientName: this.clientName,\n              callbackError:\n                callbackError instanceof Error ? callbackError.message : String(callbackError),\n            },\n            error:\n              callbackError instanceof Error ? callbackError : new Error(String(callbackError)),\n          });\n        }\n      }\n\n      // Always attempt cleanup for stream errors\n      void (async () => {\n        try {\n          await cleanupFn();\n        } catch (cleanupError) {\n          logError(`Failed to cleanup after stream error in ${this.operationContext}`, {\n            operation: 'mcp_stream_cleanup_error',\n            metadata: {\n              clientName: this.clientName,\n              originalError: aiError.message,\n              cleanupError:\n                cleanupError instanceof Error ? cleanupError.message : String(cleanupError),\n            },\n            error: cleanupError instanceof Error ? cleanupError : new Error(String(cleanupError)),\n          });\n        }\n      })();\n    };\n  }\n\n  /**\n   * Create a finish handler for proper AI SDK v6 lifecycle management\n   */\n  createFinishHandler(\n    cleanupFn: () => Promise<void>,\n    successCallback?: () => void,\n  ): () => Promise<void> {\n    return async () => {\n      try {\n        await cleanupFn();\n\n        logInfo(`MCP operation completed successfully in ${this.operationContext}`, {\n          operation: 'mcp_finish_handler_success',\n          metadata: {\n            clientName: this.clientName,\n            operationContext: this.operationContext,\n          },\n        });\n\n        // Call success callback if provided\n        if (successCallback) {\n          try {\n            successCallback();\n          } catch (callbackError) {\n            logWarn(`Success callback failed in ${this.operationContext}`, {\n              operation: 'mcp_success_callback_failure',\n              metadata: {\n                clientName: this.clientName,\n                callbackError:\n                  callbackError instanceof Error ? callbackError.message : String(callbackError),\n              },\n            });\n          }\n        }\n      } catch (error) {\n        const aiError = this.convertToAISDKError(\n          error instanceof Error ? error : new Error(String(error)),\n        );\n\n        logError(`MCP finish handler failed in ${this.operationContext}`, {\n          operation: 'mcp_finish_handler_error',\n          metadata: {\n            clientName: this.clientName,\n            errorType: aiError.errorType,\n            ...aiError.metadata,\n          },\n          error: aiError,\n        });\n\n        // Re-throw to maintain AI SDK error handling flow\n        throw aiError;\n      }\n    };\n  }\n\n  /**\n   * Convert generic error to AI SDK compatible error\n   */\n  private convertToAISDKError(\n    error: Error,\n    defaultType: AISDKErrorType = 'unknown-error',\n  ): AISDKCompatibleMCPError {\n    // Check if already an AI SDK compatible error\n    if (error instanceof AISDKCompatibleMCPError) {\n      return error;\n    }\n\n    // Map common error patterns to AI SDK error types\n    let errorType: AISDKErrorType = defaultType;\n    let recoverable = false;\n\n    if (error.message.includes('ECONNREFUSED') || error.message.includes('ENOTFOUND')) {\n      errorType = 'connection-error';\n      recoverable = true;\n    } else if (error.message.includes('timeout') || error.message.includes('TIMEOUT')) {\n      errorType = 'timeout-error';\n      recoverable = true;\n    } else if (error.message.includes('transport') || error.message.includes('Transport')) {\n      errorType = 'transport-error';\n      recoverable = true;\n    } else if (error.message.includes('validation') || error.message.includes('invalid')) {\n      errorType = 'validation-error';\n      recoverable = false;\n    } else if (error.message.includes('resource') || error.message.includes('limit')) {\n      errorType = 'resource-exhausted';\n      recoverable = true;\n    } else if (error.message.includes('tool') || error.message.includes('execution')) {\n      errorType = 'tool-execution-error';\n      recoverable = false;\n    }\n\n    return new AISDKCompatibleMCPError(\n      error.message,\n      errorType,\n      error,\n      {\n        clientName: this.clientName,\n        operationContext: this.operationContext,\n        originalErrorName: error.name,\n      },\n      recoverable,\n    );\n  }\n}\n\n/**\n * Utility functions for AI SDK v6 error integration\n */\nexport const MCPErrorUtils = {\n  /**\n   * Create a standardized error context for MCP operations\n   */\n  createErrorContext(clientName: string, operation: string): MCPErrorHandlerFactory {\n    return new MCPErrorHandlerFactory(clientName, operation);\n  },\n\n  /**\n   * Check if an error is recoverable according to AI SDK patterns\n   */\n  isRecoverableError(error: Error): boolean {\n    if (error instanceof AISDKCompatibleMCPError) {\n      return error.recoverable;\n    }\n\n    // Common recoverable error patterns\n    const recoverablePatterns = [\n      'ECONNREFUSED',\n      'ENOTFOUND',\n      'TIMEOUT',\n      'timeout',\n      'network',\n      'temporary',\n      'rate limit',\n      'throttle',\n    ];\n\n    return recoverablePatterns.some(pattern =>\n      error.message.toLowerCase().includes(pattern.toLowerCase()),\n    );\n  },\n\n  /**\n   * Extract error metadata for AI SDK logging\n   */\n  extractErrorMetadata(error: Error): Record<string, unknown> {\n    const metadata: Record<string, unknown> = {\n      errorName: error.name,\n      errorMessage: error.message,\n      timestamp: new Date().toISOString(),\n    };\n\n    if (error instanceof AISDKCompatibleMCPError) {\n      metadata.errorType = error.errorType;\n      metadata.recoverable = error.recoverable;\n      metadata.customMetadata = error.metadata;\n    }\n\n    // Extract common error properties\n    const errorCode = getErrorCode(error);\n    if (errorCode) {\n      metadata.errorCode = errorCode;\n    }\n\n    const errorDetails = error as { errno?: unknown; syscall?: unknown };\n    if (typeof errorDetails.errno === 'string' || typeof errorDetails.errno === 'number') {\n      metadata.errno = errorDetails.errno;\n    }\n    if (typeof errorDetails.syscall === 'string') {\n      metadata.syscall = errorDetails.syscall;\n    }\n\n    return metadata;\n  },\n};\n","/**\n * @fileoverview client.ts\n */\n\nimport {\n  createMCPClient,\n  type OAuthClientProvider,\n  type MCPClient as SDKMCPClient,\n} from '@ai-sdk/mcp';\nimport { Experimental_StdioMCPTransport } from '@ai-sdk/mcp/mcp-stdio';\nimport { logError, logWarn } from '@repo/shared/logs';\n\nimport { getErrorCode } from '../../server/errors';\n\nimport {\n  AISDKCompatibleMCPError,\n  MCPErrorHandlerFactory,\n  MCPErrorUtils,\n} from './ai-sdk-error-integration';\n\nimport type { SDKToolSet } from '../../shared';\nimport type { IOType } from 'node:child_process';\nimport type { Stream } from 'node:stream';\n\n\n\nexport interface MCPClientConfig {\n  name: string;\n  transport: MCPTransportConfig;\n  retry?: MCPRetryConfig;\n  timeoutMs?: number;\n  gracefulDegradation?: boolean;\n  healthCheck?: MCPHealthCheckConfig;\n}\n\nexport interface MCPTransportConfig {\n  type: 'stdio' | 'sse' | 'http';\n  // For stdio transport\n  command?: string;\n  args?: string[];\n  env?: Record<string, string>;\n  cwd?: string;\n  stderr?: IOType | Stream | number;\n  // For SSE transport\n  url?: string;\n  headers?: Record<string, string>;\n  // For HTTP transport\n  httpUrl?: string;\n  sessionId?: string;\n  authProvider?: OAuthClientProvider;\n}\n\n/**\n * MCP Client wrapper with proper typing\n * Uses AI SDK tool format instead of MCP SDK format\n */\nexport type MCPClient = SDKMCPClient;\n\n/**\n * MCP Transport union type for better type safety\n */\ntype MCPRemoteTransport = {\n  type: 'sse' | 'http';\n  url: string;\n  headers?: Record<string, string>;\n  authProvider?: OAuthClientProvider;\n};\n\nexport type MCPTransport = Experimental_StdioMCPTransport | MCPRemoteTransport;\n\n/**\n * Retry configuration for MCP operations\n */\nexport interface MCPRetryConfig {\n  maxAttempts: number;\n  initialDelayMs: number;\n  maxDelayMs: number;\n  backoffMultiplier: number;\n  retryableErrors: string[];\n}\n\n/**\n * Default retry configuration\n */\nexport const DEFAULT_RETRY_CONFIG: MCPRetryConfig = {\n  maxAttempts: 3,\n  initialDelayMs: 1000,\n  maxDelayMs: 10000,\n  backoffMultiplier: 2,\n  retryableErrors: ['ECONNREFUSED', 'ENOTFOUND', 'TIMEOUT', 'NETWORK_ERROR', 'CONNECTION_LOST'],\n};\n\n/**\n * Health check configuration for MCP servers\n */\nexport interface MCPHealthCheckConfig {\n  enabled: boolean;\n  intervalMs: number;\n  timeoutMs: number;\n  failureThreshold: number;\n  recoveryThreshold: number;\n}\n\n/**\n * Default health check configuration\n */\nexport const DEFAULT_HEALTH_CHECK_CONFIG: MCPHealthCheckConfig = {\n  enabled: true,\n  intervalMs: 60000, // 1 minute\n  timeoutMs: 5000, // 5 seconds\n  failureThreshold: 3,\n  recoveryThreshold: 2,\n};\n\n/**\n * Health status for MCP servers\n */\nexport enum MCPHealthStatus {\n  HEALTHY = 'healthy',\n  DEGRADED = 'degraded',\n  UNHEALTHY = 'unhealthy',\n  UNKNOWN = 'unknown',\n}\n\n/**\n * Health check result\n */\nexport interface MCPHealthCheckResult {\n  status: MCPHealthStatus;\n  lastCheck: Date;\n  consecutiveFailures: number;\n  consecutiveSuccesses: number;\n  responseTimeMs?: number;\n  error?: string;\n}\n\n/**\n * Result type for MCP client creation\n */\nexport interface MCPClientResult {\n  client: MCPClient;\n  toolSet: SDKToolSet;\n  config: MCPClientConfig;\n}\n\n/**\n * MCP Error types for better error handling\n */\nexport class MCPConnectionError extends Error {\n  constructor(\n    message: string,\n    public readonly clientName: string,\n    public readonly transportType: string,\n    public readonly originalError?: Error,\n  ) {\n    super(message);\n    this.name = 'MCPConnectionError';\n  }\n}\n\nexport class MCPTransportError extends Error {\n  constructor(\n    message: string,\n    public readonly transportType: string,\n    public readonly originalError?: Error,\n  ) {\n    super(message);\n    this.name = 'MCPTransportError';\n  }\n}\n\nexport class MCPRetryableError extends Error {\n  constructor(\n    message: string,\n    public readonly attempt: number,\n    public readonly maxAttempts: number,\n    public readonly originalError?: Error,\n  ) {\n    super(message);\n    this.name = 'MCPRetryableError';\n  }\n}\n\n/**\n * Utility function to check if an error is retryable\n */\nfunction isRetryableError(error: Error, retryableErrors: string[]): boolean {\n  // Check error message for known patterns\n  const errorMessage = error.message.toUpperCase();\n  const errorCode = getErrorCode(error);\n\n  return retryableErrors.some(\n    pattern => errorMessage.includes(pattern.toUpperCase()) || errorCode === pattern,\n  );\n}\n\n/**\n * Utility function to calculate exponential backoff delay\n */\nfunction calculateDelay(attempt: number, config: MCPRetryConfig): number {\n  const delay = config.initialDelayMs * Math.pow(config.backoffMultiplier, attempt - 1);\n  return Math.min(delay, config.maxDelayMs);\n}\n\n/**\n * Utility function to sleep for a given duration\n */\nfunction sleep(ms: number): Promise<void> {\n  return new Promise(resolve => setTimeout(resolve, ms));\n}\n\n/**\n * Timeout wrapper that cancels operations after a specified duration\n */\nasync function withTimeout<T>(\n  operation: () => Promise<T>,\n  timeoutMs: number,\n  context: string = 'MCP operation',\n): Promise<T> {\n  const timeoutPromise = new Promise<never>((resolve, reject) => {\n    void resolve;\n    setTimeout(() => {\n      reject(new Error(`${context} timed out after ${timeoutMs}ms`));\n    }, timeoutMs);\n  });\n\n  return Promise.race([operation(), timeoutPromise]);\n}\n\n/**\n * Enhanced retry wrapper with exponential backoff\n */\nasync function withRetry<T>(\n  operation: () => Promise<T>,\n  config: MCPRetryConfig = DEFAULT_RETRY_CONFIG,\n  context: string = 'MCP operation',\n): Promise<T> {\n  let lastError: Error | undefined;\n\n  for (let attempt = 1; attempt <= config.maxAttempts; attempt++) {\n    try {\n      return await operation();\n    } catch (error) {\n      lastError = error instanceof Error ? error : new Error(String(error));\n\n      // If this is the last attempt or error is not retryable, throw\n      if (attempt === config.maxAttempts || !isRetryableError(lastError, config.retryableErrors)) {\n        logError(`${context} failed after ${attempt} attempts`, {\n          operation: 'mcp_retry_exhausted',\n          metadata: {\n            context,\n            attempt,\n            maxAttempts: config.maxAttempts,\n            error: lastError.message,\n          },\n          error: lastError,\n        });\n        throw lastError;\n      }\n\n      // Calculate delay and wait before retry\n      const delay = calculateDelay(attempt, config);\n      logWarn(\n        `${context} failed, retrying in ${delay}ms (attempt ${attempt}/${config.maxAttempts})`,\n        {\n          operation: 'mcp_retry_attempt',\n          metadata: {\n            context,\n            attempt,\n            maxAttempts: config.maxAttempts,\n            delayMs: delay,\n            error: lastError.message,\n          },\n        },\n      );\n\n      await sleep(delay);\n    }\n  }\n\n  // This should never be reached, but TypeScript needs this\n  throw lastError || new Error(`${context} failed after all retry attempts`);\n}\n\n/**\n * Combined retry and timeout wrapper\n */\nexport async function withRetryAndTimeout<T>(\n  operation: () => Promise<T>,\n  retryConfig: MCPRetryConfig = DEFAULT_RETRY_CONFIG,\n  timeoutMs?: number,\n  context: string = 'MCP operation',\n): Promise<T> {\n  const wrappedOperation = timeoutMs ? () => withTimeout(operation, timeoutMs, context) : operation;\n\n  return withRetry(wrappedOperation, retryConfig, context);\n}\n\n/**\n * MCP Server Health Monitor\n * Tracks health status of MCP servers and provides graceful degradation\n */\nexport class MCPHealthMonitor {\n  private healthStatuses = new Map<string, MCPHealthCheckResult>();\n  private healthCheckIntervals = new Map<string, NodeJS.Timeout>();\n\n  /**\n   * Start health monitoring for a client configuration\n   */\n  startMonitoring(config: MCPClientConfig): void {\n    const healthConfig = config.healthCheck ?? DEFAULT_HEALTH_CHECK_CONFIG;\n    if (!healthConfig.enabled) return;\n\n    // Initialize health status\n    this.healthStatuses.set(config.name, {\n      status: MCPHealthStatus.UNKNOWN,\n      lastCheck: new Date(),\n      consecutiveFailures: 0,\n      consecutiveSuccesses: 0,\n    });\n\n    // Set up periodic health checks\n    const intervalId = setInterval(() => {\n      void this.performHealthCheck(config);\n    }, healthConfig.intervalMs);\n\n    this.healthCheckIntervals.set(config.name, intervalId);\n\n    // Perform initial health check\n    void this.performHealthCheck(config);\n  }\n\n  /**\n   * Stop health monitoring for a client\n   */\n  stopMonitoring(clientName: string): void {\n    const intervalId = this.healthCheckIntervals.get(clientName);\n    if (intervalId) {\n      clearInterval(intervalId);\n      this.healthCheckIntervals.delete(clientName);\n    }\n    this.healthStatuses.delete(clientName);\n  }\n\n  /**\n   * Get current health status for a client\n   */\n  getHealthStatus(clientName: string): MCPHealthCheckResult | undefined {\n    return this.healthStatuses.get(clientName);\n  }\n\n  /**\n   * Check if a client is currently healthy\n   */\n  isHealthy(clientName: string): boolean {\n    const status = this.healthStatuses.get(clientName);\n    return status?.status === MCPHealthStatus.HEALTHY;\n  }\n\n  /**\n   * Check if a client should be excluded due to poor health\n   */\n  shouldExclude(clientName: string): boolean {\n    const status = this.healthStatuses.get(clientName);\n    return status?.status === MCPHealthStatus.UNHEALTHY;\n  }\n\n  /**\n   * Perform a health check for a specific client\n   */\n  private async performHealthCheck(config: MCPClientConfig): Promise<void> {\n    const healthConfig = config.healthCheck ?? DEFAULT_HEALTH_CHECK_CONFIG;\n    const startTime = Date.now();\n    let result: MCPHealthCheckResult;\n\n    try {\n      // Attempt to create a temporary client and get tools\n      await withTimeout(\n        async () => {\n          const transport = createTransportFromConfig(config.transport);\n          const tempClient = await createMCPClient({ transport });\n\n          try {\n            await tempClient.tools();\n            await tempClient.close();\n          } catch (toolError) {\n            await tempClient.close();\n            throw toolError;\n          }\n        },\n        healthConfig.timeoutMs,\n        `Health check for ${config.name}`,\n      );\n\n      // Health check succeeded\n      const responseTime = Date.now() - startTime;\n      const currentStatus = this.healthStatuses.get(config.name);\n\n      result = {\n        status: MCPHealthStatus.HEALTHY,\n        lastCheck: new Date(),\n        consecutiveFailures: 0,\n        consecutiveSuccesses: (currentStatus?.consecutiveSuccesses ?? 0) + 1,\n        responseTimeMs: responseTime,\n      };\n    } catch (error) {\n      // Health check failed\n      const currentStatus = this.healthStatuses.get(config.name);\n      const consecutiveFailures = (currentStatus?.consecutiveFailures ?? 0) + 1;\n\n      let newStatus: MCPHealthStatus;\n      if (consecutiveFailures >= healthConfig.failureThreshold) {\n        newStatus = MCPHealthStatus.UNHEALTHY;\n      } else if (consecutiveFailures > 1) {\n        newStatus = MCPHealthStatus.DEGRADED;\n      } else {\n        newStatus = MCPHealthStatus.DEGRADED;\n      }\n\n      result = {\n        status: newStatus,\n        lastCheck: new Date(),\n        consecutiveFailures,\n        consecutiveSuccesses: 0,\n        error: error instanceof Error ? error.message : String(error),\n      };\n\n      logWarn(`Health check failed for MCP client '${config.name}'`, {\n        operation: 'mcp_health_check_failed',\n        metadata: {\n          clientName: config.name,\n          consecutiveFailures,\n          status: newStatus,\n          error: result.error,\n        },\n      });\n    }\n\n    // Log health status changes\n    const previousStatus = this.healthStatuses.get(config.name);\n\n    // Update health status\n    this.healthStatuses.set(config.name, result);\n    if (previousStatus && previousStatus.status !== result.status) {\n      logWarn(\n        `MCP client '${config.name}' health status changed: ${previousStatus.status} → ${result.status}`,\n        {\n          operation: 'mcp_health_status_change',\n          metadata: {\n            clientName: config.name,\n            previousStatus: previousStatus.status,\n            newStatus: result.status,\n            consecutiveFailures: result.consecutiveFailures,\n            consecutiveSuccesses: result.consecutiveSuccesses,\n          },\n        },\n      );\n    }\n  }\n\n  /**\n   * Get summary of all client health statuses\n   */\n  getHealthSummary(): Record<string, MCPHealthCheckResult> {\n    return Object.fromEntries(this.healthStatuses);\n  }\n\n  /**\n   * Cleanup all monitoring\n   */\n  cleanup(): void {\n    // Clear all intervals\n    for (const intervalId of this.healthCheckIntervals.values()) {\n      clearInterval(intervalId);\n    }\n    this.healthCheckIntervals.clear();\n    this.healthStatuses.clear();\n  }\n}\n\n/**\n * Global health monitor instance\n */\nexport const globalMCPHealthMonitor = new MCPHealthMonitor();\n\n/**\n * Validate transport configuration at runtime\n */\nfunction validateTransportConfig(transportConfig: MCPTransportConfig): void {\n  switch (transportConfig.type) {\n    case 'stdio':\n      if (!transportConfig.command) {\n        throw new MCPTransportError('Command is required for stdio transport', 'stdio');\n      }\n      break;\n    case 'sse': {\n      const url = resolveRemoteUrl(transportConfig);\n      if (!url) {\n        throw new MCPTransportError('URL is required for SSE transport', 'sse');\n      }\n      try {\n        new URL(url);\n      } catch {\n        throw new MCPTransportError('Invalid URL format for SSE transport', 'sse');\n      }\n      break;\n    }\n    case 'http': {\n      const url = resolveRemoteUrl(transportConfig);\n      if (!url) {\n        throw new MCPTransportError('HTTP URL is required for HTTP transport', 'http');\n      }\n      try {\n        new URL(url);\n      } catch {\n        throw new MCPTransportError('Invalid HTTP URL format for HTTP transport', 'http');\n      }\n      break;\n    }\n    default:\n      throw new MCPTransportError(\n        `Unsupported transport type: ${getTransportTypeLabel(transportConfig)}`,\n        'unknown',\n      );\n  }\n}\n\n/**\n * Create transport instance from configuration with proper typing and validation\n */\nexport function createTransportFromConfig(transportConfig: MCPTransportConfig): MCPTransport {\n  // Validate configuration first\n  validateTransportConfig(transportConfig);\n\n  switch (transportConfig.type) {\n    case 'stdio':\n      const baseEnv = Object.entries(process.env).reduce<Record<string, string>>(\n        (acc, [key, value]) => {\n          if (typeof value === 'string') {\n            acc[key] = value;\n          }\n          return acc;\n        },\n        {},\n      );\n\n      return new Experimental_StdioMCPTransport({\n        command: transportConfig.command ?? 'node',\n        args: transportConfig.args ?? [],\n        cwd: transportConfig.cwd,\n        stderr: transportConfig.stderr,\n        env: {\n          ...baseEnv,\n          // Ensure API keys are passed to child processes\n          ...(process.env.PERPLEXITY_API_KEY && {\n            PERPLEXITY_API_KEY: process.env.PERPLEXITY_API_KEY,\n          }),\n          ...(process.env.OPENAI_API_KEY && {\n            OPENAI_API_KEY: process.env.OPENAI_API_KEY,\n          }),\n          ...(process.env.ANTHROPIC_API_KEY && {\n            ANTHROPIC_API_KEY: process.env.ANTHROPIC_API_KEY,\n          }),\n          ...transportConfig.env,\n        },\n      });\n\n    case 'sse':\n      return buildRemoteTransport('sse', transportConfig);\n\n    case 'http':\n      return buildRemoteTransport('http', transportConfig);\n\n    default:\n      // TypeScript should catch this, but runtime safety\n      throw new MCPTransportError(\n        `Unsupported transport type: ${getTransportTypeLabel(transportConfig)}`,\n        'unknown',\n      );\n  }\n}\n\nfunction resolveRemoteUrl(transportConfig: MCPTransportConfig): string | undefined {\n  return transportConfig.url ?? transportConfig.httpUrl;\n}\n\nfunction getTransportTypeLabel(transportConfig: MCPTransportConfig): string {\n  return typeof transportConfig.type === 'string' ? transportConfig.type : 'unknown';\n}\n\nfunction buildRemoteTransport(\n  type: 'sse' | 'http',\n  transportConfig: MCPTransportConfig,\n): MCPRemoteTransport {\n  const url = resolveRemoteUrl(transportConfig);\n  if (!url) {\n    throw new MCPTransportError(`URL is required for ${type} transport`, type);\n  }\n\n  const headers = { ...transportConfig.headers };\n  if (type === 'http' && transportConfig.sessionId) {\n    headers['x-mcp-session-id'] = transportConfig.sessionId;\n  }\n\n  return {\n    type,\n    url,\n    headers: Object.keys(headers).length > 0 ? headers : undefined,\n    authProvider: transportConfig.authProvider,\n  };\n}\n\n/**\n * Per-request MCP client manager following Next.js documentation pattern with AI SDK v6 integration\n * Creates clients per request and cleans them up automatically with proper error handling\n */\nexport class MCPRequestManager {\n  public clients: MCPClient[] = [];\n  private tools: SDKToolSet = {};\n  private errorHandlers: Map<string, MCPErrorHandlerFactory> = new Map();\n\n  async addClient(config: MCPClientConfig): Promise<void> {\n    const retryConfig = config.retry ?? DEFAULT_RETRY_CONFIG;\n    const timeoutMs = config.timeoutMs || 30000; // 30 second default timeout\n    const context = `MCP client creation (${config.name})`;\n\n    // Create AI SDK error handler for this client\n    const errorHandler = new MCPErrorHandlerFactory(config.name, context);\n    this.errorHandlers.set(config.name, errorHandler);\n\n    // Check health status if health monitoring is enabled\n    if (globalMCPHealthMonitor.shouldExclude(config.name)) {\n      if (config.gracefulDegradation) {\n        logWarn(`Skipping unhealthy MCP client '${config.name}'`, {\n          operation: 'mcp_skip_unhealthy',\n          metadata: {\n            clientName: config.name,\n            healthStatus: globalMCPHealthMonitor.getHealthStatus(config.name),\n          },\n        });\n        return;\n      } else {\n        throw new AISDKCompatibleMCPError(\n          `MCP client '${config.name}' is marked as unhealthy`,\n          'connection-error',\n          undefined,\n          {\n            clientName: config.name,\n            transportType: config.transport.type,\n            healthStatus: globalMCPHealthMonitor.getHealthStatus(config.name),\n          },\n          true, // This is recoverable - health might improve\n        );\n      }\n    }\n\n    try {\n      await withRetryAndTimeout(\n        async () => {\n          const transport = createTransportFromConfig(config.transport);\n          const client = await createMCPClient({ transport });\n          this.clients.push(client);\n\n          // Get tools from this client and merge them with retry\n          const clientTools = await withRetryAndTimeout<SDKToolSet>(\n            () => client.tools(),\n            retryConfig,\n            timeoutMs,\n            `MCP tools retrieval (${config.name})`,\n          );\n\n          // Merge tools directly (later tools override earlier ones with same name)\n          Object.assign(this.tools, clientTools);\n\n          // Start health monitoring for this client\n          globalMCPHealthMonitor.startMonitoring(config);\n        },\n        retryConfig,\n        timeoutMs,\n        context,\n      );\n    } catch (error) {\n      const originalError = error instanceof Error ? error : new Error(String(error));\n      const aiError = new AISDKCompatibleMCPError(\n        `Failed to create MCP client '${config.name}' after retries`,\n        'connection-error',\n        originalError,\n        {\n          clientName: config.name,\n          transportType: config.transport.type,\n          retryAttempts: retryConfig.maxAttempts,\n          timeoutMs,\n        },\n        MCPErrorUtils.isRecoverableError(originalError),\n      );\n\n      // If graceful degradation is enabled, log and continue\n      if (config.gracefulDegradation) {\n        logWarn(`MCP client '${config.name}' failed, continuing with degraded functionality`, {\n          operation: 'mcp_graceful_degradation',\n          metadata: {\n            clientName: config.name,\n            transportType: config.transport.type,\n            error: aiError.message,\n            errorType: aiError.errorType,\n            recoverable: aiError.recoverable,\n            ...MCPErrorUtils.extractErrorMetadata(originalError),\n          },\n        });\n        return;\n      }\n\n      throw aiError;\n    }\n  }\n\n  getTools(): SDKToolSet {\n    return this.tools;\n  }\n\n  async close(): Promise<void> {\n    const closePromises = this.clients.map(async (client, index) => {\n      try {\n        await client.close();\n      } catch (error) {\n        logWarn(`Failed to close MCP client ${index}`, {\n          operation: 'mcp_client_close',\n          metadata: {\n            clientIndex: index,\n            error: error instanceof Error ? error.message : String(error),\n          },\n        });\n      }\n    });\n\n    await Promise.all(closePromises);\n    this.clients = [];\n    this.tools = {};\n  }\n\n  /**\n   * Get health summary for all managed clients\n   */\n  getHealthSummary(): Record<string, MCPHealthCheckResult> {\n    return globalMCPHealthMonitor.getHealthSummary();\n  }\n\n  /**\n   * Create AI SDK v6 compatible error handlers for all managed clients\n   */\n  createAISDKErrorHandlers(): {\n    onUncaughtError: (error: Error) => void;\n    onFinish: () => Promise<void>;\n    onStreamError: (error: Error) => void;\n  } {\n    const onUncaughtError = (error: Error) => {\n      // Create a composite error handler that handles all clients\n      for (const [, errorHandler] of this.errorHandlers.entries()) {\n        const handler = errorHandler.createUncaughtErrorHandler(() => this.close(), {\n          enableRecovery: true,\n          maxRecoveryAttempts: 1,\n        });\n        handler(error);\n      }\n    };\n\n    const onFinish = async () => {\n      try {\n        await this.close();\n      } catch (error) {\n        // Convert to AI SDK compatible error\n        const aiError = new AISDKCompatibleMCPError(\n          'Failed to close MCP clients on finish',\n          'resource-exhausted',\n          error instanceof Error ? error : new Error(String(error)),\n          {\n            clientCount: this.clients.length,\n            operation: 'finish_cleanup',\n          },\n          false,\n        );\n        throw aiError;\n      }\n    };\n\n    const onStreamError = (error: Error) => {\n      // Handle stream errors for all clients\n      for (const [, errorHandler] of this.errorHandlers.entries()) {\n        const handler = errorHandler.createStreamErrorHandler(() => this.close());\n        handler(error);\n      }\n    };\n\n    return {\n      onUncaughtError,\n      onFinish,\n      onStreamError,\n    };\n  }\n}\n\n/**\n * Create MCP tools for a single request (following Next.js docs pattern)\n * This creates clients per request and returns cleanup functions\n */\nexport async function createMCPToolsForRequest(configs: MCPClientConfig[]): Promise<{\n  tools: SDKToolSet;\n  clients: MCPClient[];\n  cleanup: () => Promise<void>;\n}> {\n  const manager = new MCPRequestManager();\n\n  for (const config of configs) {\n    await manager.addClient(config);\n  }\n\n  return {\n    tools: manager.getTools(),\n    clients: manager.clients,\n    cleanup: () => manager.close(),\n  };\n}\n\n/**\n * Create MCP tools following the exact Next.js documentation pattern\n * This function matches the pattern shown in the official AI SDK docs:\n * https://sdk.vercel.ai/docs/ai-sdk-ui/mcp-tools (Next.js usage)\n * https://sdk.vercel.ai/docs/ai-sdk-core/mcp-tools (Node.js usage)\n *\n * Next.js streamText example from official docs:\n * ```typescript\n * const toolSetOne = await stdioClient.tools();\n * const toolSetTwo = await sseClient.tools();\n * const toolSetThree = await customClient.tools();\n * const tools = {\n *   ...toolSetOne,\n *   ...toolSetTwo,\n *   ...toolSetThree, // note: this approach causes subsequent tool sets to override tools with the same name\n * };\n *\n * const response = streamText({\n *   model: openai('gpt-4o'),\n *   tools,\n *   prompt,\n *   onFinish: async () => {\n *     await stdioClient.close();\n *     await sseClient.close();\n *     await customClient.close();\n *   },\n * });\n * ```\n */\nexport async function createMCPToolsFromConfigs(\n  configs: MCPClientConfig[],\n  options: { gracefulDegradation?: boolean } = {},\n): Promise<{\n  tools: SDKToolSet;\n  clients: MCPClient[];\n  closeAllClients: () => Promise<void>;\n}> {\n  const clients: MCPClient[] = [];\n  const toolSets: SDKToolSet[] = [];\n\n  // Create all clients in parallel for better performance\n  const clientPromises = configs.map(async (config): Promise<MCPClientResult | null> => {\n    const retryConfig = config.retry ?? DEFAULT_RETRY_CONFIG;\n    const timeoutMs = config.timeoutMs || 30000;\n    const enableGracefulDegradation =\n      config.gracefulDegradation ?? options.gracefulDegradation ?? false;\n\n    try {\n      const result = await withRetryAndTimeout(\n        async (): Promise<MCPClientResult> => {\n          const transport = createTransportFromConfig(config.transport);\n\n          // Create MCP client with transport (following official docs pattern)\n          const client = await createMCPClient({ transport });\n\n          try {\n            const toolSet = await withRetryAndTimeout<SDKToolSet>(\n              () => client.tools(),\n              retryConfig,\n              timeoutMs,\n              `MCP tools retrieval (${config.name})`,\n            );\n\n            return { client, toolSet, config };\n          } catch (error) {\n            try {\n              await client.close();\n            } catch (closeError) {\n              logError(`Failed to close failed client ${config.name}`, {\n                operation: 'mcp_client_cleanup',\n                metadata: { clientName: config.name },\n                error: closeError instanceof Error ? closeError : new Error(String(closeError)),\n              });\n            }\n\n            throw error;\n          }\n        },\n        retryConfig,\n        timeoutMs,\n        `MCP client creation (${config.name})`,\n      );\n\n      return result;\n    } catch (error) {\n      const mcpError = new MCPConnectionError(\n        `Failed to create MCP client '${config.name}' after retries`,\n        config.name,\n        config.transport.type,\n        error instanceof Error ? error : new Error(String(error)),\n      );\n\n      if (enableGracefulDegradation) {\n        logWarn(\n          `Failed to create MCP client ${config.name}, continuing with degraded functionality`,\n          {\n            operation: 'mcp_client_creation_degraded',\n            metadata: {\n              clientName: config.name,\n              transportType: config.transport.type,\n              retryAttempts: retryConfig.maxAttempts,\n              timeoutMs,\n              error: mcpError.message,\n            },\n          },\n        );\n        // Return null to filter out later\n        return null;\n      } else {\n        // Re-throw error if not using graceful degradation\n        throw mcpError;\n      }\n    }\n  });\n\n  // Wait for all clients to be created\n  const results = await Promise.all(clientPromises);\n\n  // Filter out failed clients and populate arrays\n  for (const result of results) {\n    if (result) {\n      clients.push(result.client);\n      toolSets.push(result.toolSet);\n    }\n  }\n\n  // Merge all tool sets using explicit spread operator (following Next.js docs pattern)\n  // Note: this approach causes subsequent tool sets to override tools with the same name\n  const tools = mergeToolSets(toolSets);\n\n  // Enhanced cleanup function with better error handling\n  const closeAllClients = async (): Promise<void> => {\n    const closePromises = clients.map(async (client, index) => {\n      try {\n        await client.close();\n      } catch (error) {\n        logWarn(`Failed to close MCP client ${index}`, {\n          operation: 'mcp_client_close',\n          metadata: {\n            clientIndex: index,\n            error: error instanceof Error ? error.message : String(error),\n          },\n        });\n      }\n    });\n\n    await Promise.all(closePromises);\n  };\n\n  return {\n    tools,\n    clients,\n    closeAllClients,\n  };\n}\n\nfunction mergeToolSets(toolSets: SDKToolSet[]): SDKToolSet {\n  const merged: SDKToolSet = {};\n\n  for (const toolSet of toolSets) {\n    Object.assign(merged, toolSet);\n  }\n\n  return merged;\n}\n"],"mappings":"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"}

package/dist/client.d.mts

@@ -0,0 +1,103 @@
+import { Lr as SDKLanguageModelUsage, xa as SDKUIMessage } from "./ai-runtime-DIwOEc6g.mjs";
+import "./shared.mjs";
+import { UIElement, UITree, UseGenerativeUIConfig, UseGenerativeUIReturn } from "./generative-ui-types.mjs";
+
+//#region src/client/hooks.d.ts
+interface VectorSearchResult {
+  id: string;
+  score: number;
+  content?: string;
+  metadata?: Record<string, unknown>;
+  embedding?: number[];
+}
+interface VectorEnrichedMessage {
+  role: 'user' | 'assistant' | 'system';
+  content: string;
+  vectorContext?: VectorSearchResult[];
+  metadata?: Record<string, unknown>;
+}
+interface UseVectorSearchConfig {
+  apiRoute?: string;
+  apiKey?: string;
+  timeout?: number;
+}
+declare function useVectorSearch(config: UseVectorSearchConfig): {
+  search: (query: string, options?: {
+    topK?: number;
+    filter?: Record<string, unknown>;
+    threshold?: number;
+  }) => Promise<VectorSearchResult[]>;
+  results: VectorSearchResult[];
+  isLoading: boolean;
+  error: string | null;
+  clearResults: () => void;
+};
+interface UseVectorChatConfig {
+  apiRoute?: string;
+  chatRoute?: string;
+  apiKey?: string;
+  autoEnrichContext?: boolean;
+  contextTopK?: number;
+  similarityThreshold?: number;
+}
+declare function useVectorChat(config: UseVectorChatConfig): {
+  messages: VectorEnrichedMessage[];
+  vectorContext: VectorSearchResult[];
+  sendMessage: (content: string) => Promise<void>;
+  isLoading: boolean;
+  clearChat: () => void;
+  hasContext: boolean;
+};
+interface UseEmbeddingsConfig {
+  apiRoute?: string;
+  apiKey?: string;
+  embeddingModel?: string;
+}
+declare function useEmbeddings(config: UseEmbeddingsConfig): {
+  generateEmbeddings: (content: string | string[]) => Promise<{
+    embeddings: number[][];
+  }>;
+  isGenerating: boolean;
+  lastEmbeddings: number[][];
+};
+interface UseVectorRecommendationsConfig {
+  apiRoute?: string;
+  apiKey?: string;
+}
+declare function useVectorRecommendations(config: UseVectorRecommendationsConfig): {
+  recommendations: VectorSearchResult[];
+  getRecommendations: (targetId: string, options?: {
+    topK?: number;
+    threshold?: number;
+  }) => Promise<VectorSearchResult[]>;
+  isLoading: boolean;
+};
+//#endregion
+//#region src/client/utils.d.ts
+declare const CLIENT_CONSTANTS: {
+  readonly DEFAULT_TIMEOUT: 30000;
+  readonly MAX_RETRIES: 3;
+  readonly DEFAULT_MODEL: "gpt-4o";
+};
+declare class ClientAIError extends Error {
+  code?: string | undefined;
+  statusCode?: number | undefined;
+  constructor(message: string, code?: string | undefined, statusCode?: number | undefined);
+}
+declare const clientUtils: {
+  generateId: () => string;
+  delay: (ms: number) => Promise<void>;
+  formatBytes: (bytes: number, decimals?: number) => string;
+};
+//#endregion
+//#region src/client/message-utils.d.ts
+declare function extractTextContent(message: SDKUIMessage): string;
+//#endregion
+//#region src/client/chat-usage.d.ts
+declare function aggregateUsage(current: Partial<SDKLanguageModelUsage>, addition: Partial<SDKLanguageModelUsage>): SDKLanguageModelUsage;
+//#endregion
+//#region src/client/use-generative-ui.d.ts
+declare function useGenerativeUI(config?: UseGenerativeUIConfig): UseGenerativeUIReturn;
+//#endregion
+export { CLIENT_CONSTANTS, ClientAIError, type UIElement, type UITree, type UseEmbeddingsConfig, type UseGenerativeUIConfig, type UseGenerativeUIReturn, type UseVectorChatConfig, type UseVectorRecommendationsConfig, type UseVectorSearchConfig, type VectorEnrichedMessage, type VectorSearchResult, aggregateUsage, clientUtils, extractTextContent, useEmbeddings, useGenerativeUI, useVectorChat, useVectorRecommendations, useVectorSearch };
+//# sourceMappingURL=client.d.mts.map

package/dist/client.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.mts","names":[],"sources":["../src/client/hooks.ts","../src/client/utils.ts","../src/client/message-utils.ts","../src/client/chat-usage.ts","../src/client/use-generative-ui.ts"],"mappings":";;;;;UAmBiB,kBAAA;EACf,EAAA;EACA,KAAA;EACA,OAAA;EACA,QAAA,GAAW,MAAA;EACX,SAAA;AAAA;AAAA,UAIe,qBAAA;EACf,IAAA;EACA,OAAA;EACA,aAAA,GAAgB,kBAAA;EAChB,QAAA,GAAW,MAAA;AAAA;AAAA,UAQI,qBAAA;EACf,QAAA;EACA,MAAA;EACA,OAAA;AAAA;AAAA,iBAYc,eAAA,CAAgB,MAAA,EAAQ,qBAAA;0BAOrB,OAAA;IAEX,IAAA;IACA,MAAA,GAAS,MAAA;IACT,SAAA;EAAA,MAED,OAAA,CAAQ,kBAAA;;;;;;UAqDE,mBAAA;EACf,QAAA;EACA,SAAA;EACA,MAAA;EACA,iBAAA;EACA,WAAA;EACA,mBAAA;AAAA;AAAA,iBAiBc,aAAA,CAAc,MAAA,EAAQ,mBAAA;;;oCAMZ,OAAA;;;;;UAiFT,mBAAA;EACf,QAAA;EACA,MAAA;EACA,cAAA;AAAA;AAAA,iBAYc,aAAA,CAAc,MAAA,EAAQ,mBAAA;sDAKD,OAAA;;;;;;UAsCpB,8BAAA;EACf,QAAA;EACA,MAAA;AAAA;AAAA,iBAYc,wBAAA,CAAyB,MAAA,EAAQ,8BAAA;;yCAM3B,OAAA;IACJ,IAAA;IAAe,SAAA;EAAA,MAC1B,OAAA,CAAQ,kBAAA;;;;;cCvSF,gBAAA;EAAA;;;;cAWA,aAAA,SAAsB,KAAA;EAGxB,IAAA;EACA,UAAA;cAFP,OAAA,UACO,IAAA,uBACA,UAAA;AAAA;AAAA,cAYE,WAAA;;yBAWU,OAAA;+BAGM,QAAA;AAAA;;;iBCvCb,kBAAA,CAAmB,OAAA,EAAS,YAAA;;;iBCH5B,cAAA,CACd,OAAA,EAAS,OAAA,CAAQ,qBAAA,GACjB,QAAA,EAAU,OAAA,CAAQ,qBAAA,IACjB,qBAAA;;;iBC+Ba,eAAA,CAAgB,MAAA,GAAQ,qBAAA,GAA6B,qBAAA"}