@juspay/neurolink 9.54.3 → 9.54.5

package/dist/types/mcpTypes.d.ts

@@ -1,787 +0,0 @@
-/**
- * MCP Types for In-Memory Server Support
- * Enables various integrations to register tools directly
- */
-import type { JsonValue, JsonObject } from "./common.js";
-import type { ExecutionContext, ToolInfo, ToolResult } from "./tools.js";
-/**
- * In-memory MCP server configuration
- */
-/**
- * MCP Transport Types - Maximally Reusable
- */
-export type MCPTransportType = "stdio" | "sse" | "websocket" | "http" | "ws" | "tcp" | "unix";
-/**
- * MCP Server Connection Status - Individual server status
- */
-export type MCPServerConnectionStatus = "initializing" | "connecting" | "connected" | "disconnected" | "failed" | "restarting" | "stopping" | "stopped";
-/**
- * MCP Server Category Types - Deployment and server type classification
- */
-export type MCPServerCategory = "external" | "in-memory" | "built-in" | "user-defined" | "custom" | "uncategorized";
-/**
- * MCP Server Domain Categories - Functional domain classification
- */
-export type MCPServerDomainCategory = "aiProviders" | "frameworks" | "development" | "business" | "content" | "data" | "integrations" | "automation" | "analysis" | "custom";
-/**
- * Universal MCP Server - Unified configuration and runtime state
- * MCP 2024-11-05 specification compliant
- * Replaces both MCPServerInfo and MCPServerConfig
- */
-export type MCPServerInfo = {
-    id: string;
-    name: string;
-    description: string;
-    transport: MCPTransportType;
-    status: MCPServerConnectionStatus;
-    tools: Array<{
-        name: string;
-        description: string;
-        inputSchema?: object;
-        execute?: (params: unknown, context?: unknown) => Promise<unknown> | unknown;
-    }>;
-    command?: string;
-    args?: string[];
-    env?: Record<string, string>;
-    url?: string;
-    headers?: Record<string, string>;
-    /** HTTP transport-specific options */
-    httpOptions?: MCPHTTPTransportOptions;
-    timeout?: number;
-    retries?: number;
-    error?: string;
-    installed?: boolean;
-    cwd?: string;
-    autoRestart?: boolean;
-    healthCheckInterval?: number;
-    /** Retry configuration for HTTP transport */
-    retryConfig?: {
-        maxAttempts?: number;
-        initialDelay?: number;
-        maxDelay?: number;
-        backoffMultiplier?: number;
-    };
-    /** Rate limiting configuration for HTTP transport */
-    rateLimiting?: {
-        /** Maximum requests per minute (default: 60) */
-        requestsPerMinute?: number;
-        /** Maximum requests per hour (optional) */
-        requestsPerHour?: number;
-        /** Maximum burst size for token bucket (default: 10) */
-        maxBurst?: number;
-        /** Use token bucket algorithm (default: true) */
-        useTokenBucket?: boolean;
-    };
-    blockedTools?: string[];
-    /** Authentication configuration for HTTP/SSE/WebSocket transports */
-    auth?: {
-        /** Authentication type */
-        type: "oauth2" | "bearer" | "api-key";
-        /** OAuth 2.1 configuration */
-        oauth?: {
-            /** OAuth client ID */
-            clientId: string;
-            /** OAuth client secret (optional for public clients with PKCE) */
-            clientSecret?: string;
-            /** Authorization endpoint URL */
-            authorizationUrl: string;
-            /** Token endpoint URL */
-            tokenUrl: string;
-            /** Redirect URI for OAuth callback */
-            redirectUrl: string;
-            /** OAuth scope (space-separated) */
-            scope?: string;
-            /** Enable PKCE (Proof Key for Code Exchange) - recommended for OAuth 2.1 */
-            usePKCE?: boolean;
-        };
-        /** Bearer token for simple token authentication */
-        token?: string;
-        /** API key for API key authentication */
-        apiKey?: string;
-        /** Header name for API key (default: "X-API-Key") */
-        apiKeyHeader?: string;
-    };
-    metadata?: {
-        uptime?: number;
-        toolCount?: number;
-        category?: MCPServerCategory;
-        provider?: string;
-        version?: string;
-        author?: string;
-        tags?: string[];
-        [key: string]: unknown;
-    };
-};
-/**
- * HTTP Transport Options for fine-grained control
- */
-export type MCPHTTPTransportOptions = {
-    /** Connection timeout in milliseconds (default: 30000) */
-    connectionTimeout?: number;
-    /** Request timeout in milliseconds (default: 60000) */
-    requestTimeout?: number;
-    /** Idle timeout for connection pool (default: 120000) */
-    idleTimeout?: number;
-    /** Keep-alive timeout (default: 30000) */
-    keepAliveTimeout?: number;
-};
-/**
- * MCP Server Status for CLI Operations - High Reusability
- */
-export type MCPServerStatus = {
-    /** Whether MCP is initialized */
-    mcpInitialized: boolean;
-    /** Total number of servers */
-    totalServers: number;
-    /** Number of available servers */
-    availableServers: number;
-    /** Number of auto-discovered servers */
-    autoDiscoveredCount: number;
-    /** Total number of tools */
-    totalTools: number;
-    /** Number of custom tools */
-    customToolsCount: number;
-    /** Number of in-memory servers */
-    inMemoryServersCount: number;
-    /** Error message */
-    error?: string;
-    /** Auto-discovered servers from various sources */
-    autoDiscoveredServers?: MCPDiscoveredServer[];
-    /** Currently connected servers */
-    connectedServers: MCPConnectedServer[];
-    /** Available tools across all servers */
-    availableTools: MCPToolInfo[];
-    /** Server registry entries */
-    serverRegistry?: Record<string, MCPServerInfo>;
-};
-/**
- * Auto-discovered MCP Server - High Reusability
- */
-export type MCPDiscoveredServer = {
-    name: string;
-    status: MCPServerConnectionStatus;
-    source: string;
-    transport: MCPTransportType;
-    description?: string;
-    url?: string;
-    args?: string[];
-    env?: Record<string, string>;
-    metadata?: MCPServerMetadata;
-};
-/**
- * Connected MCP Server - High Reusability
- */
-export type MCPConnectedServer = {
-    name: string;
-    transport: MCPTransportType;
-    connected: boolean;
-    description?: string;
-    tools: MCPToolInfo[];
-    lastSeen?: Date;
-    connectionTime?: Date;
-    metadata?: MCPServerMetadata;
-};
-/**
- * MCP Tool Information - High Reusability
- */
-export type MCPToolInfo = {
-    name: string;
-    description: string;
-    serverId: string;
-    isExternal: boolean;
-    isImplemented?: boolean;
-    inputSchema?: JsonObject;
-    outputSchema?: JsonObject;
-    metadata?: MCPToolMetadata;
-};
-/**
- * MCP Executable Tool - Tool with execution capability
- * Extracted from MCPServerInfo.tools array for better readability
- */
-export type MCPExecutableTool = MCPServerInfo["tools"][0];
-/**
- * MCP Server Metadata - Extensible
- */
-export type MCPServerMetadata = {
-    [key: string]: JsonValue;
-} & {
-    provider?: string;
-    version?: string;
-    author?: string;
-    category?: string;
-    tags?: string[];
-};
-/**
- * MCP Tool Metadata - Extensible
- */
-export type MCPToolMetadata = {
-    [key: string]: JsonValue;
-} & {
-    category?: string;
-    tags?: string[];
-    complexity?: "simple" | "medium" | "complex";
-    executionTime?: number;
-};
-/**
- * MCP Server Registry Entry - For Object.entries() usage
- */
-export type MCPServerRegistryEntry = [string, MCPServerInfo];
-export type MCPStatus = {
-    mcpInitialized: boolean;
-    totalServers: number;
-    availableServers: number;
-    autoDiscoveredCount: number;
-    totalTools: number;
-    autoDiscoveredServers: MCPServerInfo[];
-    customToolsCount: number;
-    inMemoryServersCount: number;
-    externalMCPServersCount?: number;
-    externalMCPConnectedCount?: number;
-    externalMCPFailedCount?: number;
-    externalMCPServers?: MCPServerInfo[];
-    error?: string;
-    [key: string]: unknown;
-};
-/**
- * Call record for circuit breaker statistics tracking
- * Extracted from mcpCircuitBreaker.ts for centralized type management
- */
-export type CallRecord = {
-    timestamp: number;
-    success: boolean;
-    duration: number;
-};
-/**
- * Tool execution context - Rich context passed to every tool execution
- * Extracted from factory.ts for centralized type management
- * Following standard patterns for rich tool context
- */
-export type NeuroLinkExecutionContext = {
-    sessionId?: string;
-    userId?: string;
-    aiProvider?: string;
-    modelId?: string;
-    temperature?: number;
-    maxTokens?: number;
-    appId?: string;
-    clientId?: string;
-    clientVersion?: string;
-    organizationId?: string;
-    projectId?: string;
-    environment?: string;
-    environmentType?: "development" | "staging" | "production";
-    platform?: string;
-    device?: string;
-    browser?: string;
-    userAgent?: string;
-    frameworkType?: "react" | "vue" | "svelte" | "next" | "nuxt" | "sveltekit";
-    toolChain?: string[];
-    parentToolId?: string;
-    locale?: string;
-    timezone?: string;
-    ipAddress?: string;
-    requestId?: string;
-    timestamp?: number;
-    permissions?: string[];
-    features?: string[];
-    enableDemoMode?: boolean;
-    securityLevel?: "public" | "private" | "organization";
-    metadata?: Record<string, unknown>;
-    [key: string]: unknown;
-};
-export type { ToolResult } from "./tools.js";
-/**
- * Unified MCP Registry type
- */
-export type UnifiedMCPRegistry = {
-    /**
-     * Register an in-memory server
-     */
-    registerInMemoryServer(serverId: string, serverInfo: MCPServerInfo): Promise<void>;
-    /**
-     * Get all available tools
-     */
-    getAllTools(): Promise<MCPToolInfo[]>;
-    /**
-     * Execute a tool
-     */
-    executeTool(toolName: string, params: JsonObject, context: JsonObject): Promise<unknown>;
-    /**
-     * Check if connected to a server
-     */
-    isConnected(serverId: string): boolean;
-};
-import type { StandardRecord } from "./typeAliases.js";
-/**
- * NeuroLink MCP Tool Type - Standardized tool definition for MCP integration
- * Moved from src/lib/mcp/factory.ts
- */
-export type NeuroLinkMCPTool = {
-    /** Unique tool identifier for MCP registration and execution */
-    name: string;
-    /** Human-readable description of tool functionality */
-    description: string;
-    /** Optional category for tool organization and discovery */
-    category?: string;
-    /** Optional input schema for parameter validation (Zod or JSON Schema) */
-    inputSchema?: unknown;
-    /** Optional output schema for result validation */
-    outputSchema?: unknown;
-    /** Implementation status flag for development tracking */
-    isImplemented?: boolean;
-    /** Required permissions for tool execution in secured environments */
-    permissions?: string[];
-    /** Tool version for compatibility and update management */
-    version?: string;
-    /** Additional metadata for tool information and capabilities */
-    metadata?: Record<string, unknown>;
-    /**
-     * Tool execution function with standardized signature
-     */
-    execute: (params: unknown, context: NeuroLinkExecutionContext) => Promise<ToolResult>;
-};
-/**
- * NeuroLink MCP Server Type - Standard compatible
- * Moved from src/lib/mcp/factory.ts
- */
-export type NeuroLinkMCPServer = {
-    id: string;
-    title: string;
-    description?: string;
-    version?: string;
-    category?: MCPServerDomainCategory;
-    visibility?: "public" | "private" | "organization";
-    tools: Record<string, NeuroLinkMCPTool>;
-    registerTool(tool: NeuroLinkMCPTool): NeuroLinkMCPServer;
-    metadata?: Record<string, unknown>;
-    dependencies?: string[];
-    capabilities?: string[];
-};
-/**
- * MCP Server Configuration for creation
- * Moved from src/lib/mcp/factory.ts
- */
-export type MCPServerConfig = {
-    id: string;
-    title: string;
-    description?: string;
-    version?: string;
-    category?: MCPServerDomainCategory;
-    visibility?: "public" | "private" | "organization";
-    metadata?: Record<string, unknown>;
-    dependencies?: string[];
-    capabilities?: string[];
-};
-/**
- * Discovered MCP server/plugin definition
- * Moved from src/lib/mcp/contracts/mcpContract.ts
- */
-export type DiscoveredMcp<TTools = StandardRecord> = {
-    metadata: McpMetadata;
-    tools?: TTools;
-    capabilities?: string[];
-    version?: string;
-    configuration?: Record<string, string | number | boolean>;
-    [key: string]: unknown;
-};
-/**
- * MCP server metadata
- * Moved from src/lib/mcp/contracts/mcpContract.ts
- */
-export type McpMetadata = {
-    name: string;
-    description?: string;
-    version?: string;
-    author?: string;
-    homepage?: string;
-    repository?: string;
-    category?: string;
-};
-/**
- * Tool discovery result
- * Moved from src/lib/mcp/toolDiscoveryService.ts
- */
-export type ToolDiscoveryResult = {
-    /** Whether discovery was successful */
-    success: boolean;
-    /** Number of tools discovered */
-    toolCount: number;
-    /** Discovered tools */
-    tools: import("./externalMcp.js").ExternalMCPToolInfo[];
-    /** Error message if failed */
-    error?: string;
-    /** Discovery duration in milliseconds */
-    duration: number;
-    /** Server ID */
-    serverId: string;
-};
-/**
- * External MCP tool execution options
- * Moved from src/lib/mcp/toolDiscoveryService.ts
- */
-export type ExternalToolExecutionOptions = {
-    /** Execution timeout in milliseconds */
-    timeout?: number;
-    /** Additional context for execution */
-    context?: Partial<import("./externalMcp.js").ExternalMCPToolContext>;
-    /** Whether to validate input parameters */
-    validateInput?: boolean;
-    /** Whether to validate output */
-    validateOutput?: boolean;
-};
-/**
- * Tool validation result
- * Moved from src/lib/mcp/toolDiscoveryService.ts
- */
-export type ToolValidationResult = {
-    /** Whether the tool is valid */
-    isValid: boolean;
-    /** Validation errors */
-    errors: string[];
-    /** Validation warnings */
-    warnings: string[];
-    /** Tool metadata */
-    metadata?: {
-        category?: string;
-        complexity?: "simple" | "moderate" | "complex";
-        requiresAuth?: boolean;
-        isDeprecated?: boolean;
-    };
-};
-/**
- * Tool registry events
- * Moved from src/lib/mcp/toolDiscoveryService.ts
- */
-export type ToolRegistryEvents = {
-    toolRegistered: {
-        serverId: string;
-        toolName: string;
-        toolInfo: import("./externalMcp.js").ExternalMCPToolInfo;
-        timestamp: Date;
-    };
-    toolUnregistered: {
-        serverId: string;
-        toolName: string;
-        timestamp: Date;
-    };
-    toolExecuted: {
-        serverId: string;
-        toolName: string;
-        success: boolean;
-        duration: number;
-        timestamp: Date;
-    };
-    discoveryStarted: {
-        serverId: string;
-        timestamp: Date;
-    };
-    discoveryCompleted: {
-        serverId: string;
-        toolCount: number;
-        duration: number;
-        timestamp: Date;
-    };
-    discoveryFailed: {
-        serverId: string;
-        error: string;
-        timestamp: Date;
-    };
-};
-/**
- * Circuit breaker states
- * Moved from src/lib/mcp/mcpCircuitBreaker.ts
- */
-export type CircuitBreakerState = "closed" | "open" | "half-open";
-/**
- * Circuit breaker configuration
- * Moved from src/lib/mcp/mcpCircuitBreaker.ts
- */
-export type CircuitBreakerConfig = {
-    /** Number of failures before opening the circuit */
-    failureThreshold: number;
-    /** Time to wait before attempting reset (milliseconds) */
-    resetTimeout: number;
-    /** Maximum calls allowed in half-open state */
-    halfOpenMaxCalls: number;
-    /** Timeout for individual operations (milliseconds) */
-    operationTimeout: number;
-    /** Minimum number of calls before calculating failure rate */
-    minimumCallsBeforeCalculation: number;
-    /** Window size for calculating failure rate (milliseconds) */
-    statisticsWindowSize: number;
-};
-/**
- * Circuit breaker statistics
- * Moved from src/lib/mcp/mcpCircuitBreaker.ts
- */
-export type CircuitBreakerStats = {
-    /** Current state */
-    state: CircuitBreakerState;
-    /** Total number of calls */
-    totalCalls: number;
-    /** Number of successful calls */
-    successfulCalls: number;
-    /** Number of failed calls */
-    failedCalls: number;
-    /** Current failure rate (0-1) */
-    failureRate: number;
-    /** Calls in current time window */
-    windowCalls: number;
-    /** Last state change timestamp */
-    lastStateChange: Date;
-    /** Next retry time (for open state) */
-    nextRetryTime?: Date;
-    /** Half-open call count */
-    halfOpenCalls: number;
-};
-/**
- * Circuit breaker events
- * Moved from src/lib/mcp/mcpCircuitBreaker.ts
- */
-export type CircuitBreakerEvents = {
-    stateChange: {
-        oldState: CircuitBreakerState;
-        newState: CircuitBreakerState;
-        reason: string;
-        timestamp: Date;
-    };
-    callSuccess: {
-        duration: number;
-        timestamp: Date;
-    };
-    callFailure: {
-        error: string;
-        duration: number;
-        timestamp: Date;
-    };
-    circuitOpen: {
-        failureRate: number;
-        totalCalls: number;
-        timestamp: Date;
-    };
-    circuitHalfOpen: {
-        timestamp: Date;
-    };
-    circuitClosed: {
-        timestamp: Date;
-    };
-};
-/**
- * MCP Registry type with optional methods for maximum flexibility
- * Moved from src/lib/mcp/registry.ts
- */
-export type McpRegistry = {
-    registerServer?(serverId: string, serverConfig?: unknown, context?: ExecutionContext): Promise<void>;
-    executeTool?<T = unknown>(toolName: string, args?: unknown, context?: ExecutionContext): Promise<T>;
-    listTools?(context?: ExecutionContext): Promise<ToolInfo[]>;
-};
-/**
- * MCP client creation result
- * Moved from src/lib/mcp/mcpClientFactory.ts
- */
-export type MCPClientResult = {
-    /** Whether client creation was successful */
-    success: boolean;
-    /** Created client instance */
-    client?: import("@modelcontextprotocol/sdk/client/index.js").Client;
-    /** Created transport instance */
-    transport?: import("@modelcontextprotocol/sdk/shared/transport.js").Transport;
-    /** Created process (for stdio transport) */
-    process?: import("child_process").ChildProcess;
-    /** Error message if failed */
-    error?: string;
-    /** Creation duration in milliseconds */
-    duration: number;
-    /** Server capabilities reported during handshake */
-    capabilities?: import("@modelcontextprotocol/sdk/types.js").ClientCapabilities;
-};
-/**
- * Flexible validation result
- * Moved from src/lib/mcp/flexibleToolValidator.ts
- */
-export type FlexibleValidationResult = {
-    /** Whether validation passed */
-    isValid: boolean;
-    /** Validation error message (for simple cases) */
-    error?: string;
-    /** Validation warnings */
-    warnings?: string[];
-    /** Normalized parameters (if valid) */
-    normalizedParams?: Record<string, unknown>;
-    /** Validation metadata */
-    metadata?: {
-        validationTime?: number;
-        validator?: string;
-        schema?: string;
-    };
-};
-/**
- * OAuth tokens structure for MCP HTTP transport authentication
- */
-export type OAuthTokens = {
-    /** Access token for API authentication */
-    accessToken: string;
-    /** Refresh token for obtaining new access tokens */
-    refreshToken?: string;
-    /** Token expiration timestamp (Unix epoch in milliseconds) */
-    expiresAt?: number;
-    /** Token type (typically "Bearer") */
-    tokenType: string;
-    /** OAuth scope granted */
-    scope?: string;
-};
-/**
- * Token storage type for OAuth 2.1 authentication
- * Implementations can use in-memory, file-based, or external storage
- */
-export type TokenStorage = {
-    /**
-     * Get stored tokens for a server
-     * @param serverId - Unique identifier for the MCP server
-     * @returns Stored tokens or null if not found
-     */
-    getTokens(serverId: string): Promise<OAuthTokens | null>;
-    /**
-     * Save tokens for a server
-     * @param serverId - Unique identifier for the MCP server
-     * @param tokens - OAuth tokens to store
-     */
-    saveTokens(serverId: string, tokens: OAuthTokens): Promise<void>;
-    /**
-     * Delete stored tokens for a server
-     * @param serverId - Unique identifier for the MCP server
-     */
-    deleteTokens(serverId: string): Promise<void>;
-    /**
-     * Check if tokens exist for a server
-     * @param serverId - Unique identifier for the MCP server
-     * @returns True if tokens exist
-     */
-    hasTokens?(serverId: string): Promise<boolean>;
-    /**
-     * Clear all stored tokens
-     */
-    clearAll?(): Promise<void>;
-};
-/**
- * OAuth 2.1 configuration for MCP servers
- */
-export type MCPOAuthConfig = {
-    /** OAuth client ID */
-    clientId: string;
-    /** OAuth client secret (optional for public clients with PKCE) */
-    clientSecret?: string;
-    /** Authorization endpoint URL */
-    authorizationUrl: string;
-    /** Token endpoint URL */
-    tokenUrl: string;
-    /** Redirect URI for OAuth callback */
-    redirectUrl: string;
-    /** OAuth scope (space-separated) */
-    scope?: string;
-    /** Enable PKCE (Proof Key for Code Exchange) - recommended for OAuth 2.1 */
-    usePKCE?: boolean;
-    /** Additional authorization parameters */
-    additionalParams?: Record<string, string>;
-};
-/**
- * OAuth client information returned to MCP SDK
- */
-export type OAuthClientInformation = {
-    clientId: string;
-    clientSecret?: string;
-    redirectUri: string;
-};
-/**
- * Authorization URL result from OAuth flow
- */
-export type AuthorizationUrlResult = {
-    url: string;
-    state: string;
-    codeVerifier?: string;
-};
-/**
- * Token exchange request for OAuth code exchange
- */
-export type TokenExchangeRequest = {
-    code: string;
-    state: string;
-    codeVerifier?: string;
-};
-/**
- * Token bucket rate limit configuration options for HTTP transport
- */
-export type TokenBucketRateLimitConfig = {
-    /** Maximum requests per window */
-    requestsPerWindow: number;
-    /** Window size in milliseconds (default: 60000 = 1 minute) */
-    windowMs: number;
-    /** Use token bucket algorithm (default: true) */
-    useTokenBucket: boolean;
-    /** Token refill rate (tokens per second, for token bucket) */
-    refillRate: number;
-    /** Maximum burst size (for token bucket) */
-    maxBurst: number;
-};
-/** @deprecated Use TokenBucketRateLimitConfig instead */
-export type RateLimitConfig = TokenBucketRateLimitConfig;
-/**
- * HTTP retry configuration for MCP transport
- */
-export type HTTPRetryConfig = {
-    /** Maximum retry attempts (default: 3) */
-    maxAttempts: number;
-    /** Initial delay in ms (default: 1000) */
-    initialDelay: number;
-    /** Maximum delay in ms (default: 30000) */
-    maxDelay: number;
-    /** Backoff multiplier (default: 2) */
-    backoffMultiplier: number;
-    /** HTTP status codes that trigger retry */
-    retryableStatusCodes: number[];
-};
-/**
- * PKCE (Proof Key for Code Exchange) challenge data for OAuth 2.1 authentication
- * Used internally by OAuth client providers to generate and store PKCE parameters
- */
-export type PKCEChallenge = {
-    /** Random code verifier string (43-128 characters, URL-safe) */
-    codeVerifier: string;
-    /** SHA-256 hash of code verifier, base64url encoded */
-    codeChallenge: string;
-    /** Challenge method - always "S256" per OAuth 2.1 specification */
-    codeChallengeMethod: "S256";
-};
-/**
- * Rate limiter statistics for monitoring and debugging HTTP transport rate limiting
- * Provides insight into token bucket state and queue status
- */
-export type RateLimiterStats = {
-    /** Current number of available tokens */
-    tokens: number;
-    /** Maximum burst size (token capacity) */
-    maxBurst: number;
-    /** Token refill rate (tokens per second) */
-    refillRate: number;
-    /** Number of requests waiting in queue */
-    queueLength: number;
-    /** Timestamp of last token refill */
-    lastRefill: Date;
-};
-/**
- * Token response from OAuth server
- * Standard OAuth 2.0/2.1 token endpoint response structure
- * Used internally by NeuroLinkOAuthProvider for token exchange and refresh
- */
-export type TokenResponse = {
-    /** Access token for API authentication */
-    access_token: string;
-    /** Refresh token for obtaining new access tokens (optional) */
-    refresh_token?: string;
-    /** Token lifetime in seconds (optional) */
-    expires_in?: number;
-    /** Token type (typically "Bearer") */
-    token_type: string;
-    /** OAuth scope granted (optional, space-separated) */
-    scope?: string;
-};