xiaozhi-client 1.6.3-beta.4 → 1.6.4-beta.0

package/dist/MCPService-B1FvMc8R.d.ts

@@ -0,0 +1,243 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+
+declare enum MCPTransportType {
+    STDIO = "stdio",
+    SSE = "sse",
+    STREAMABLE_HTTP = "streamable-http",
+    MODELSCOPE_SSE = "modelscope-sse"
+}
+declare enum ConnectionState {
+    DISCONNECTED = "disconnected",
+    CONNECTING = "connecting",
+    CONNECTED = "connected",
+    RECONNECTING = "reconnecting",
+    FAILED = "failed"
+}
+interface ReconnectOptions {
+    enabled: boolean;
+    maxAttempts: number;
+    initialInterval: number;
+    maxInterval: number;
+    backoffStrategy: "linear" | "exponential" | "fixed";
+    backoffMultiplier: number;
+    timeout: number;
+    jitter: boolean;
+}
+interface PingOptions {
+    enabled: boolean;
+    interval: number;
+    timeout: number;
+    maxFailures: number;
+    startDelay: number;
+}
+interface ModelScopeSSEOptions {
+    eventSourceInit?: {
+        fetch?: (url: string | URL | Request, init?: RequestInit) => Promise<Response>;
+    };
+    requestInit?: RequestInit;
+}
+interface MCPServiceConfig {
+    name: string;
+    type: MCPTransportType;
+    command?: string;
+    args?: string[];
+    url?: string;
+    apiKey?: string;
+    headers?: Record<string, string>;
+    modelScopeAuth?: boolean;
+    customSSEOptions?: ModelScopeSSEOptions;
+    reconnect?: Partial<ReconnectOptions>;
+    ping?: Partial<PingOptions>;
+    timeout?: number;
+    retryAttempts?: number;
+}
+interface MCPServiceStatus {
+    name: string;
+    connected: boolean;
+    initialized: boolean;
+    transportType: MCPTransportType;
+    toolCount: number;
+    lastError?: string;
+    reconnectAttempts: number;
+    connectionState: ConnectionState;
+    pingEnabled: boolean;
+    lastPingTime?: Date;
+    pingFailureCount: number;
+    isPinging: boolean;
+}
+interface MCPServiceOptions {
+    reconnect?: Partial<ReconnectOptions>;
+}
+interface ToolCallResult {
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+    isError?: boolean;
+}
+/**
+ * MCP 服务类
+ * 负责管理单个 MCP 服务的连接、工具管理和调用
+ */
+declare class MCPService {
+    private config;
+    private client;
+    private transport;
+    private tools;
+    private connectionState;
+    private reconnectOptions;
+    private reconnectState;
+    private logger;
+    private connectionTimeout;
+    private initialized;
+    private pingOptions;
+    private pingTimer;
+    private pingFailureCount;
+    private lastPingTime;
+    private isPinging;
+    constructor(config: MCPServiceConfig, options?: MCPServiceOptions);
+    /**
+     * 带标签的日志方法
+     */
+    private logWithTag;
+    /**
+     * 验证配置
+     */
+    private validateConfig;
+    /**
+     * 连接到 MCP 服务
+     */
+    connect(): Promise<void>;
+    /**
+     * 尝试建立连接
+     */
+    private attemptConnection;
+    /**
+     * 处理连接成功
+     */
+    private handleConnectionSuccess;
+    /**
+     * 处理连接错误
+     */
+    private handleConnectionError;
+    /**
+     * 检查是否应该重连
+     */
+    private shouldReconnect;
+    /**
+     * 安排重连
+     */
+    private scheduleReconnect;
+    /**
+     * 计算下次重连间隔
+     */
+    private calculateNextInterval;
+    /**
+     * 清理连接资源
+     */
+    private cleanupConnection;
+    /**
+     * 停止重连
+     */
+    private stopReconnect;
+    /**
+     * 刷新工具列表
+     */
+    private refreshTools;
+    /**
+     * 断开连接
+     */
+    disconnect(): Promise<void>;
+    /**
+     * 手动重连
+     */
+    reconnect(): Promise<void>;
+    /**
+     * 获取工具列表
+     */
+    getTools(): Tool[];
+    /**
+     * 调用工具
+     */
+    callTool(name: string, arguments_: any): Promise<ToolCallResult>;
+    /**
+     * 检测是否为会话过期错误
+     * @param errorMessage 错误消息
+     * @returns 是否为会话过期错误
+     */
+    private isSessionExpiredError;
+    /**
+     * 获取服务配置
+     */
+    getConfig(): MCPServiceConfig;
+    /**
+     * 获取服务状态
+     */
+    getStatus(): MCPServiceStatus;
+    /**
+     * 检查是否已连接
+     */
+    isConnected(): boolean;
+    /**
+     * 启用自动重连
+     */
+    enableReconnect(): void;
+    /**
+     * 禁用自动重连
+     */
+    disableReconnect(): void;
+    /**
+     * 更新重连配置
+     */
+    updateReconnectOptions(options: Partial<ReconnectOptions>): void;
+    /**
+     * 获取重连配置
+     */
+    getReconnectOptions(): ReconnectOptions;
+    /**
+     * 重置重连状态
+     */
+    resetReconnectState(): void;
+    /**
+     * 启动ping监控
+     */
+    private startPingMonitoring;
+    /**
+     * 停止ping监控
+     */
+    private stopPingMonitoring;
+    /**
+     * 执行ping检查
+     */
+    private performPing;
+    /**
+     * 处理ping成功
+     */
+    private handlePingSuccess;
+    /**
+     * 处理ping失败
+     */
+    private handlePingFailure;
+    /**
+     * 重置ping状态
+     */
+    private resetPingState;
+    /**
+     * 启用ping监控
+     */
+    enablePing(): void;
+    /**
+     * 禁用ping监控
+     */
+    disablePing(): void;
+    /**
+     * 更新ping配置
+     */
+    updatePingOptions(options: Partial<PingOptions>): void;
+    /**
+     * 获取ping配置
+     */
+    getPingOptions(): PingOptions;
+}
+
+export { type MCPServiceConfig as M, MCPService as a };

package/dist/WebServer.d.ts

@@ -1,23 +1,41 @@
-import { AppConfig } from './configManager.js';
-
-interface ClientInfo {
-    status: "connected" | "disconnected";
-    mcpEndpoint: string;
-    activeMCPServers: string[];
-    lastHeartbeat?: number;
-}
+/**
+ * WebServer - 主控制器，协调各个服务和处理器
+ */
 declare class WebServer {
     private app;
     private httpServer;
     private wss;
     private logger;
     private port;
-    private clientInfo;
-    private heartbeatTimeout?;
-    private readonly HEARTBEAT_TIMEOUT;
+    private eventBus;
+    private configService;
+    private statusService;
+    private notificationService;
+    private configApiHandler;
+    private statusApiHandler;
+    private serviceApiHandler;
+    private staticFileHandler;
+    private realtimeNotificationHandler;
+    private heartbeatHandler;
+    private heartbeatMonitorInterval?;
     private proxyMCPServer;
     private xiaozhiConnectionManager;
     private mcpServiceManager;
+    /**
+     * 创建统一的错误响应
+     * @deprecated 使用处理器中的方法替代
+     */
+    private createErrorResponse;
+    /**
+     * 创建统一的成功响应
+     * @deprecated 使用处理器中的方法替代
+     */
+    private createSuccessResponse;
+    /**
+     * 记录废弃功能使用警告
+     * @deprecated 使用处理器中的方法替代
+     */
+    private logDeprecationWarning;
     constructor(port?: number);
     /**
      * 初始化所有连接（配置驱动）
@@ -53,20 +71,13 @@ declare class WebServer {
     private sleep;
     private setupMiddleware;
     private setupRoutes;
-    private serveStaticFile;
     private setupWebSocket;
-    private handleWebSocketMessage;
-    private sendInitialData;
-    broadcastConfigUpdate(config: AppConfig): void;
-    private broadcastRestartStatus;
-    private broadcastStatusUpdate;
-    private updateClientInfo;
-    private resetHeartbeatTimeout;
-    private updateConfig;
-    private restartService;
-    updateStatus(info: Partial<ClientInfo>): void;
     start(): Promise<void>;
     stop(): Promise<void>;
+    /**
+     * 销毁 WebServer 实例，清理所有资源
+     */
+    destroy(): void;
 }
 
 export { WebServer };