@lingyao037/openclaw-lingyao-cli 0.9.4 → 0.9.6

package/dist/index.d.ts

@@ -1,285 +1,9 @@
+import { R as ResolvedAccount, L as LingyaoProbeResult } from './status-CVwSoPKi.js';
+import * as openclaw_plugin_sdk from 'openclaw/plugin-sdk';
 import { PluginRuntime, ChannelPlugin } from 'openclaw/plugin-sdk';
-import { a as LingyaoAccountConfig, L as LingyaoRuntime, D as DeviceInfo, b as DeviceToken, A as AccountManager, S as SyncRequest, c as SyncResponse, d as LingyaoMessage, e as LingyaoConfig, N as NotifyPayload, H as HealthStatus } from './accounts-B9ijYIIu.js';
-export { f as AckRequest, g as DiarySyncPayload, F as FailedEntry, h as LINGYAO_SERVER_URL, i as LingyaoAccount, M as MemorySyncPayload, j as MessageType, k as NotifyAction, l as NotifyRequest, P as PairingCode, m as PairingConfirmRequest, n as PairingConfirmResponse, o as PollRequest, p as PollResponse, Q as QueuedMessage, T as TokenRefreshRequest, q as TokenRefreshResponse, W as WebSocketConnection } from './accounts-B9ijYIIu.js';
-
-/**
- * Config Adapter - Account resolution, config validation
- *
- * serverUrl is NOT exposed to users — hardcoded as LINGYAO_SERVER_URL.
- */
-
-/**
- * Resolved account after config resolution.
- */
-interface ResolvedAccount {
-    readonly id: string;
-    readonly accountId?: string | null;
-    readonly enabled: boolean;
-    readonly dmPolicy: 'paired' | 'open' | 'deny';
-    readonly allowFrom: string[];
-    readonly gatewayId?: string;
-    readonly rawConfig: LingyaoAccountConfig;
-}
-
-/**
- * 错误处理模块
- */
-
-/**
- * 错误严重级别
- */
-declare enum ErrorSeverity {
-    LOW = "low",
-    MEDIUM = "medium",
-    HIGH = "high",
-    CRITICAL = "critical"
-}
-/**
- * Lingyao 错误基类
- */
-declare class LingyaoError extends Error {
-    readonly code: string;
-    readonly severity: ErrorSeverity;
-    readonly timestamp: number;
-    readonly context?: Record<string, unknown>;
-    readonly cause?: Error;
-    constructor(message: string, code: string, severity?: ErrorSeverity, context?: Record<string, unknown>, cause?: Error);
-    /**
-     * 转换为 JSON 可序列化格式
-     */
-    toJSON(): Record<string, unknown>;
-}
-/**
- * 错误处理器
- */
-declare class ErrorHandler {
-    private runtime;
-    private errorCounts;
-    private lastErrors;
-    private errorThresholds;
-    private cleanupTimer;
-    private errorTimestamps;
-    constructor(runtime: LingyaoRuntime);
-    destroy(): void;
-    private cleanupOldErrors;
-    /**
-     * 处理错误
-     */
-    handleError(error: Error | LingyaoError): void;
-    /**
-     * 记录错误
-     */
-    private recordError;
-    /**
-     * 检查错误阈值
-     */
-    private checkThresholds;
-    /**
-     * 触发警报
-     */
-    private triggerAlert;
-    /**
-     * 设置错误阈值
-     */
-    setErrorThreshold(code: string, threshold: {
-        count: number;
-        window: number;
-    }): void;
-    /**
-     * 获取错误统计
-     */
-    getErrorStats(): {
-        byCode: Record<string, number>;
-        total: number;
-        recent: Array<{
-            code: string;
-            error: LingyaoError;
-            timestamp: number;
-        }>;
-    };
-    /**
-     * 重置错误计数
-     */
-    resetErrorCounts(code?: string): void;
-    /**
-     * 包装异步函数以自动处理错误
-     */
-    wrapAsync<T>(fn: () => Promise<T>, context?: {
-        operation?: string;
-        fallback?: T;
-        retryable?: boolean;
-    }): Promise<T>;
-    /**
-     * 创建带有错误处理的重试逻辑
-     */
-    retry<T>(fn: () => Promise<T>, options?: {
-        maxRetries?: number;
-        retryDelay?: number;
-        backoff?: boolean;
-        onRetry?: (error: Error, attempt: number) => void;
-    }): Promise<T>;
-    /**
-     * 判断错误是否可重试
-     */
-    isRetryable(error: Error): boolean;
-    /**
-     * 判断错误是否需要降级处理
-     */
-    shouldDegrade(error: Error): boolean;
-    /**
-     * 创建降级响应
-     */
-    createDegradedResponse<T>(fallback: T, error?: Error): {
-        success: false;
-        degraded: true;
-        fallback: T;
-        error?: Error;
-    };
-}
-
-/**
- * Token management utilities
- */
-declare class TokenManager {
-    constructor(_runtime: LingyaoRuntime);
-    /**
-     * Generate a new device token
-     */
-    generateDeviceToken(pairingId: string, deviceInfo: DeviceInfo, expiryDays?: number): DeviceToken;
-    /**
-     * Validate a device token
-     */
-    validateToken(token: string, storedSecret: string): boolean;
-    /**
-     * Check if token is expired
-     */
-    isTokenExpired(token: DeviceToken): boolean;
-    /**
-     * Refresh an existing token
-     */
-    refreshToken(oldToken: DeviceToken, expiryDays?: number): DeviceToken;
-    /**
-     * Extract device ID from token string
-     */
-    extractDeviceId(token: string): string | null;
-    /**
-     * Generate a unique device ID
-     */
-    private generateDeviceId;
-    /**
-     * Generate a random secret key
-     */
-    private generateSecret;
-    /**
-     * Generate a JWT-like token string
-     */
-    private generateTokenString;
-    /**
-     * Sign data with secret
-     */
-    private sign;
-    /**
-     * Base64URL encode without padding
-     */
-    private base64UrlEncode;
-}
-
-/**
- * Agent message format - messages passed directly to Agent
- */
-interface AgentMessage {
-    id: string;
-    type: "diary" | "memory" | "heartbeat";
-    from: string;
-    deviceId: string;
-    content: string;
-    metadata: Record<string, unknown>;
-    timestamp: number;
-}
-/**
- * Message handler callback for delivering messages to Agent
- */
-type MessageHandler = (message: AgentMessage) => void | Promise<void>;
-/**
- * Message Processor - Handles incoming messages and routes them to Agent
- */
-declare class MessageProcessor {
-    private runtime;
-    private accountManager;
-    private messageQueue;
-    private seenMessages;
-    private messageHandler;
-    private readonly maxQueueSize;
-    constructor(runtime: LingyaoRuntime, accountManager: AccountManager);
-    /**
-     * Initialize the message processor
-     */
-    initialize(): Promise<void>;
-    /**
-     * Set the message handler for delivering messages to Agent
-     */
-    setMessageHandler(handler: MessageHandler): void;
-    /**
-     * Get the currently registered Agent message handler.
-     */
-    getMessageHandler(): MessageHandler | null;
-    /**
-     * Deliver a normalized message directly to the registered Agent handler.
-     */
-    deliverToAgent(message: AgentMessage): Promise<void>;
-    /**
-     * Process sync request from app
-     */
-    processSync(deviceId: string, request: SyncRequest): Promise<SyncResponse>;
-    /**
-     * Process a single message
-     */
-    private processMessage;
-    /**
-     * Process diary sync - Pass directly to Agent
-     */
-    private processDiarySync;
-    /**
-     * Process memory sync - Pass directly to Agent
-     */
-    private processMemorySync;
-    /**
-     * Process sync acknowledgment
-     */
-    private processSyncAck;
-    /**
-     * Process heartbeat
-     */
-    private processHeartbeat;
-    /**
-     * Poll for new messages (long-polling)
-     */
-    pollMessages(deviceId: string, timeout?: number): Promise<LingyaoMessage[]>;
-    /**
-     * Queue a message for a device
-     */
-    queueMessage(deviceId: string, message: LingyaoMessage): boolean;
-    /**
-     * Acknowledge messages
-     */
-    acknowledgeMessages(messageIds: string[]): Promise<void>;
-    /**
-     * Check if message has been seen (deduplication)
-     */
-    private isMessageSeen;
-    /**
-     * Mark message as seen
-     */
-    private markMessageSeen;
-    /**
-     * Get queue size for a device
-     */
-    getQueueSize(deviceId: string): number;
-    /**
-     * Get total queue size
-     */
-    getTotalQueueSize(): number;
-}
+import { L as LingyaoRuntime, S as SyncRequest, a as SyncResponse, b as LingyaoMessage, D as DeviceInfo, c as DeviceToken, d as LingyaoConfig, N as NotifyPayload, H as HealthStatus } from './types-LFC6Wpqo.js';
+export { A as AckRequest, e as DiarySyncPayload, F as FailedEntry, f as LINGYAO_SERVER_URL, g as LingyaoAccount, h as LingyaoAccountConfig, M as MemorySyncPayload, i as MessageType, j as NotifyAction, k as NotifyRequest, P as PairingCode, l as PairingConfirmRequest, m as PairingConfirmResponse, n as PollRequest, o as PollResponse, Q as QueuedMessage, T as TokenRefreshRequest, p as TokenRefreshResponse, W as WebSocketConnection, q as getLingyaoGatewayWsUrl } from './types-LFC6Wpqo.js';
+import { A as AccountManager } from './accounts-BykE02r0.js';
 
 /**
  * 灵爻服务器 HTTP 客户端
@@ -410,6 +134,11 @@ declare class ServerHttpClient {
      * 检查是否已注册
      */
     isReady(): boolean;
+    /**
+     * Clear local gateway token/session (storage + in-memory). Used when WS handshake
+     * fails with 404 or when forcing re-registration with the same gatewayId.
+     */
+    clearLocalSession(): Promise<void>;
     /**
      * 从存储恢复会话
      */
@@ -494,6 +223,9 @@ type WSClientEvent = {
 } | {
     type: "error";
     error: Error;
+} | {
+    type: "fatal_handshake";
+    reason: "http_404";
 } | {
     type: "message";
     message: WSMessage;
@@ -535,6 +267,8 @@ declare class LingyaoWSClient {
     private connectionId;
     private heartbeatTimer;
     private reconnectTimer;
+    /** When set, close handler will not schedule reconnect (e.g. HTTP 404 on upgrade). */
+    private suppressReconnect;
     private messageHandlers;
     private logger;
     constructor(runtime: LingyaoRuntime, config: WSClientConfig);
@@ -587,73 +321,170 @@ declare class LingyaoWSClient {
      */
     private stopHeartbeat;
     /**
-     * 安排重连
+     * 安排重连
+     */
+    private scheduleReconnect;
+    /**
+     * 发送消息到服务器
+     */
+    send(message: WSMessage): void;
+    /**
+     * 发送通知到鸿蒙 App
+     */
+    sendNotification(deviceId: string, notification: any): void;
+    /**
+     * 处理 App 消息
+     */
+    private handleAppMessage;
+    /**
+     * 处理消息发送成功
+     */
+    private handleMessageDelivered;
+    /**
+     * 处理配对完成通知（来自 lingyao.live 服务器）
+     */
+    private handlePairingCompleted;
+    /**
+     * 处理消息发送失败
+     */
+    private handleMessageFailed;
+    /**
+     * 处理服务器错误
+     */
+    private handleError;
+    /**
+     * 注册消息处理器
+     */
+    registerMessageHandler(type: string, handler: (message: WSMessage) => void): void;
+    /**
+     * 发送事件
+     */
+    private emitEvent;
+    /**
+     * 更新 WebSocket 连接使用的 token
+     */
+    updateToken(token: string): void;
+    /**
+     * 断开连接
+     */
+    disconnect(): void;
+    /**
+     * 获取连接状态
+     */
+    getState(): ConnectionState;
+    /**
+     * 获取连接 ID
+     */
+    getConnectionId(): string | null;
+    /**
+     * 是否已连接
+     */
+    isConnected(): boolean;
+    /**
+     * 生成消息 ID
+     */
+    private generateMessageId;
+    /**
+     * 生成连接 ID
+     */
+    private generateConnectionId;
+}
+
+/**
+ * Agent message format - messages passed directly to Agent
+ */
+interface AgentMessage {
+    id: string;
+    type: "diary" | "memory" | "heartbeat";
+    from: string;
+    deviceId: string;
+    content: string;
+    metadata: Record<string, unknown>;
+    timestamp: number;
+}
+/**
+ * Message handler callback for delivering messages to Agent
+ */
+type MessageHandler = (message: AgentMessage) => void | Promise<void>;
+/**
+ * Message Processor - Handles incoming messages and routes them to Agent
+ */
+declare class MessageProcessor {
+    private runtime;
+    private accountManager;
+    private messageQueue;
+    private seenMessages;
+    private messageHandler;
+    private readonly maxQueueSize;
+    constructor(runtime: LingyaoRuntime, accountManager: AccountManager);
+    /**
+     * Initialize the message processor
      */
-    private scheduleReconnect;
+    initialize(): Promise<void>;
     /**
-     * 发送消息到服务器
+     * Set the message handler for delivering messages to Agent
      */
-    send(message: WSMessage): void;
+    setMessageHandler(handler: MessageHandler): void;
     /**
-     * 发送通知到鸿蒙 App
+     * Get the currently registered Agent message handler.
      */
-    sendNotification(deviceId: string, notification: any): void;
+    getMessageHandler(): MessageHandler | null;
     /**
-     * 处理 App 消息
+     * Deliver a normalized message directly to the registered Agent handler.
      */
-    private handleAppMessage;
+    deliverToAgent(message: AgentMessage): Promise<void>;
     /**
-     * 处理消息发送成功
+     * Process sync request from app
      */
-    private handleMessageDelivered;
+    processSync(deviceId: string, request: SyncRequest): Promise<SyncResponse>;
     /**
-     * 处理配对完成通知（来自 lingyao.live 服务器）
+     * Process a single message
      */
-    private handlePairingCompleted;
+    private processMessage;
     /**
-     * 处理消息发送失败
+     * Process diary sync - Pass directly to Agent
      */
-    private handleMessageFailed;
+    private processDiarySync;
     /**
-     * 处理服务器错误
+     * Process memory sync - Pass directly to Agent
      */
-    private handleError;
+    private processMemorySync;
     /**
-     * 注册消息处理器
+     * Process sync acknowledgment
      */
-    registerMessageHandler(type: string, handler: (message: WSMessage) => void): void;
+    private processSyncAck;
     /**
-     * 发送事件
+     * Process heartbeat
      */
-    private emitEvent;
+    private processHeartbeat;
     /**
-     * 更新 WebSocket 连接使用的 token
+     * Poll for new messages (long-polling)
      */
-    updateToken(token: string): void;
+    pollMessages(deviceId: string, timeout?: number): Promise<LingyaoMessage[]>;
     /**
-     * 断开连接
+     * Queue a message for a device
      */
-    disconnect(): void;
+    queueMessage(deviceId: string, message: LingyaoMessage): boolean;
     /**
-     * 获取连接状态
+     * Acknowledge messages
      */
-    getState(): ConnectionState;
+    acknowledgeMessages(messageIds: string[]): Promise<void>;
     /**
-     * 获取连接 ID
+     * Check if message has been seen (deduplication)
      */
-    getConnectionId(): string | null;
+    private isMessageSeen;
     /**
-     * 是否已连接
+     * Mark message as seen
      */
-    isConnected(): boolean;
+    private markMessageSeen;
     /**
-     * 生成消息 ID
+     * Get queue size for a device
      */
-    private generateMessageId;
+    getQueueSize(deviceId: string): number;
     /**
-     * 生成连接 ID
+     * Get total queue size
      */
-    private generateConnectionId;
+    getTotalQueueSize(): number;
 }
 
 /**
@@ -823,6 +654,169 @@ declare class Monitor {
     };
 }
 
+/**
+ * 错误处理模块
+ */
+
+/**
+ * 错误严重级别
+ */
+declare enum ErrorSeverity {
+    LOW = "low",
+    MEDIUM = "medium",
+    HIGH = "high",
+    CRITICAL = "critical"
+}
+/**
+ * Lingyao 错误基类
+ */
+declare class LingyaoError extends Error {
+    readonly code: string;
+    readonly severity: ErrorSeverity;
+    readonly timestamp: number;
+    readonly context?: Record<string, unknown>;
+    readonly cause?: Error;
+    constructor(message: string, code: string, severity?: ErrorSeverity, context?: Record<string, unknown>, cause?: Error);
+    /**
+     * 转换为 JSON 可序列化格式
+     */
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * 错误处理器
+ */
+declare class ErrorHandler {
+    private runtime;
+    private errorCounts;
+    private lastErrors;
+    private errorThresholds;
+    private cleanupTimer;
+    private errorTimestamps;
+    constructor(runtime: LingyaoRuntime);
+    destroy(): void;
+    private cleanupOldErrors;
+    /**
+     * 处理错误
+     */
+    handleError(error: Error | LingyaoError): void;
+    /**
+     * 记录错误
+     */
+    private recordError;
+    /**
+     * 检查错误阈值
+     */
+    private checkThresholds;
+    /**
+     * 触发警报
+     */
+    private triggerAlert;
+    /**
+     * 设置错误阈值
+     */
+    setErrorThreshold(code: string, threshold: {
+        count: number;
+        window: number;
+    }): void;
+    /**
+     * 获取错误统计
+     */
+    getErrorStats(): {
+        byCode: Record<string, number>;
+        total: number;
+        recent: Array<{
+            code: string;
+            error: LingyaoError;
+            timestamp: number;
+        }>;
+    };
+    /**
+     * 重置错误计数
+     */
+    resetErrorCounts(code?: string): void;
+    /**
+     * 包装异步函数以自动处理错误
+     */
+    wrapAsync<T>(fn: () => Promise<T>, context?: {
+        operation?: string;
+        fallback?: T;
+        retryable?: boolean;
+    }): Promise<T>;
+    /**
+     * 创建带有错误处理的重试逻辑
+     */
+    retry<T>(fn: () => Promise<T>, options?: {
+        maxRetries?: number;
+        retryDelay?: number;
+        backoff?: boolean;
+        onRetry?: (error: Error, attempt: number) => void;
+    }): Promise<T>;
+    /**
+     * 判断错误是否可重试
+     */
+    isRetryable(error: Error): boolean;
+    /**
+     * 判断错误是否需要降级处理
+     */
+    shouldDegrade(error: Error): boolean;
+    /**
+     * 创建降级响应
+     */
+    createDegradedResponse<T>(fallback: T, error?: Error): {
+        success: false;
+        degraded: true;
+        fallback: T;
+        error?: Error;
+    };
+}
+
+/**
+ * Token management utilities
+ */
+declare class TokenManager {
+    constructor(_runtime: LingyaoRuntime);
+    /**
+     * Generate a new device token
+     */
+    generateDeviceToken(pairingId: string, deviceInfo: DeviceInfo, expiryDays?: number): DeviceToken;
+    /**
+     * Validate a device token
+     */
+    validateToken(token: string, storedSecret: string): boolean;
+    /**
+     * Check if token is expired
+     */
+    isTokenExpired(token: DeviceToken): boolean;
+    /**
+     * Refresh an existing token
+     */
+    refreshToken(oldToken: DeviceToken, expiryDays?: number): DeviceToken;
+    /**
+     * Extract device ID from token string
+     */
+    extractDeviceId(token: string): string | null;
+    /**
+     * Generate a unique device ID
+     */
+    private generateDeviceId;
+    /**
+     * Generate a random secret key
+     */
+    private generateSecret;
+    /**
+     * Generate a JWT-like token string
+     */
+    private generateTokenString;
+    /**
+     * Sign data with secret
+     */
+    private sign;
+    /**
+     * Base64URL encode without padding
+     */
+    private base64UrlEncode;
+}
+
 /**
  * 灵爻频道插件 - 服务器中转模式
  */
@@ -983,7 +977,7 @@ declare function validateConfig(config: unknown): LingyaoConfig;
  */
 declare function getDefaultConfig(): LingyaoConfig;
 
-declare const lingyaoPlugin: ChannelPlugin<ResolvedAccount>;
+declare const lingyaoPlugin: ChannelPlugin<ResolvedAccount, LingyaoProbeResult>;
 declare function initializeLingyaoRuntime(runtime: PluginRuntime): void;
 /** @deprecated Use the default export (OpenClaw SDK entry) instead. */
 declare function createPlugin(runtime: LingyaoRuntime, config?: Partial<LingyaoConfig>): Promise<LingyaoChannel>;
@@ -1006,12 +1000,10 @@ declare const plugin: {
     id: string;
     name: string;
     description: string;
-    register(api: {
-        runtime?: unknown;
-        registerChannel: (params: {
-            plugin: unknown;
-        }) => void;
-    }): void;
+    configSchema: openclaw_plugin_sdk.ChannelConfigSchema;
+    register: (api: openclaw_plugin_sdk.OpenClawPluginApi) => void;
+    channelPlugin: openclaw_plugin_sdk.ChannelPlugin<ResolvedAccount, LingyaoProbeResult>;
+    setChannelRuntime?: (runtime: openclaw_plugin_sdk.PluginRuntime) => void;
 };
 
-export { type AgentMessage, DeviceInfo, DeviceToken, HealthStatus, LingyaoAccountConfig, LingyaoChannel, LingyaoConfig, LingyaoMessage, LingyaoRuntime, NotifyPayload, SyncRequest, SyncResponse, createPlugin, plugin as default, getDefaultConfig, initializeLingyaoRuntime, lingyaoPlugin, pluginMetadata, validateConfig };
+export { type AgentMessage, DeviceInfo, DeviceToken, HealthStatus, LingyaoChannel, LingyaoConfig, LingyaoMessage, LingyaoRuntime, NotifyPayload, SyncRequest, SyncResponse, createPlugin, plugin as default, getDefaultConfig, initializeLingyaoRuntime, lingyaoPlugin, pluginMetadata, validateConfig };