@lingyao037/openclaw-lingyao-cli 0.3.3 → 0.4.0

package/dist/index.d.ts

@@ -1,21 +1,262 @@
-import { a as LingyaoAccountConfig, L as LingyaoRuntime, A as AccountManager, S as SyncRequest, b as SyncResponse, c as LingyaoMessage, D as DeviceInfo, d as DeviceToken, e as LingyaoConfig, N as NotifyPayload, H as HealthStatus } from './accounts-Bkwmg14Q.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-Bkwmg14Q.js';
+import * as openclaw_plugin_sdk_core from 'openclaw/plugin-sdk/core';
+import * as openclaw_plugin_sdk from 'openclaw/plugin-sdk';
+import { L as LingyaoRuntime, D as DeviceInfo, a as DeviceToken, A as AccountManager, S as SyncRequest, b as SyncResponse, c as LingyaoMessage, d as LingyaoConfig, N as NotifyPayload, H as HealthStatus } from './accounts-AwHXj7VB.js';
+export { e as AckRequest, f as DiarySyncPayload, F as FailedEntry, g as LINGYAO_SERVER_URL, h as LingyaoAccount, i as LingyaoAccountConfig, 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-AwHXj7VB.js';
 
 /**
- * Config Adapter - Account resolution, config validation
- *
- * serverUrl is NOT exposed to users — hardcoded as LINGYAO_SERVER_URL.
+ * 错误处理模块
+ */
+
+/**
+ * 错误严重级别
+ */
+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;
+    constructor(runtime: LingyaoRuntime);
+    /**
+     * 处理错误
+     */
+    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;
+}
 
 /**
- * Resolved account after config resolution.
+ * 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
  */
-interface ResolvedAccount {
-    readonly id: string;
-    readonly enabled: boolean;
-    readonly dmPolicy: 'paired' | 'open' | 'deny';
-    readonly allowFrom: readonly string[];
-    readonly rawConfig: LingyaoAccountConfig;
+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;
 }
 
 /**
@@ -376,104 +617,7 @@ declare class LingyaoWSClient {
 }
 
 /**
- * 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;
-}
-
-/**
- * 监控和指标收集模块
+ * 监控和指标收集模块
  */
 
 /**
@@ -639,301 +783,6 @@ 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;
-    constructor(runtime: LingyaoRuntime);
-    /**
-     * 处理错误
-     */
-    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;
-    };
-}
-
-/**
- * Directory Adapter - List paired devices (peers)
- *
- * Implements ChannelDirectoryAdapter:
- * - listPeers: return all active paired devices for an account
- *
- * SDK passes:
- *   listPeers({ cfg, accountId?, query?, limit?, runtime })
- *
- * Returns ChannelDirectoryEntry[] with { kind, id, name?, ... }
- *
- * Uses AccountManager to get the device list.
- * Each device is returned as a "user" peer (no groups in Lingyao).
- */
-
-/**
- * Matches SDK's ChannelDirectoryEntry.
- */
-interface DirectoryEntry {
-    kind: 'user' | 'group' | 'channel';
-    id: string;
-    name?: string;
-    handle?: string;
-    avatarUrl?: string;
-    rank?: number;
-    raw?: unknown;
-}
-
-/**
- * Status Adapter - Health checks and channel summary
- *
- * Implements ChannelStatusAdapter:
- * - probeAccount: run health checks for a specific account
- * - buildChannelSummary: aggregate status for a single account
- *
- * SDK passes:
- *   probeAccount({ account, timeoutMs, cfg })
- *   buildChannelSummary({ account, cfg, defaultAccountId, snapshot })
- *
- * Wraps existing Probe and Monitor classes.
- */
-
-/**
- * Probe result structure.
- */
-interface LingyaoProbeResult {
-    ok: boolean;
-    status: 'healthy' | 'degraded' | 'unhealthy';
-    wsConnected: boolean;
-    uptime?: number;
-    checks?: Record<string, {
-        passed: boolean;
-        message: string;
-        duration?: number;
-    }>;
-    error?: string;
-}
-
-/**
- * Outbound Adapter - Send messages from Agent to App devices
- *
- * Implements ChannelOutboundAdapter:
- * - deliveryMode: "direct" (synchronous via WS)
- * - sendText: send plain text notification
- * - sendPayload: send structured payload notification
- * - resolveTarget: validate and resolve target deviceId
- *
- * SDK passes ChannelOutboundContext = { cfg, to, text, accountId?, ... }
- * and expects OutboundDeliveryResult = { channel, messageId, ... } return.
- *
- * Routes through MultiAccountOrchestrator to the correct
- * account's WS connection.
- */
-
-/**
- * Minimal subset of ChannelOutboundContext that we need.
- */
-interface OutboundContext {
-    cfg?: unknown;
-    to: string;
-    text: string;
-    mediaUrl?: string;
-    accountId?: string | null;
-    silent?: boolean;
-}
-/**
- * Minimal ChannelOutboundPayloadContext.
- */
-interface OutboundPayloadContext extends OutboundContext {
-    payload: unknown;
-}
-/**
- * OutboundDeliveryResult - what SDK expects back.
- */
-interface DeliveryResult {
-    channel: string;
-    messageId: string;
-    chatId?: string;
-    timestamp?: number;
-    meta?: Record<string, unknown>;
-}
-
-/**
- * Gateway Adapter - Account lifecycle management
- *
- * Implements ChannelGatewayAdapter:
- * - startAccount: create WS/HTTP connections for an account
- * - stopAccount: tear down connections for an account
- *
- * Delegates to MultiAccountOrchestrator for all operations.
- *
- * SDK passes ChannelGatewayContext which includes:
- *   cfg, accountId, account, runtime, abortSignal, log,
- *   getStatus, setStatus, channelRuntime?
- */
-
-/**
- * Minimal subset of ChannelGatewayContext that we need.
- * We define this locally to avoid importing internal SDK types.
- */
-interface GatewayContext {
-    accountId: string;
-    account: ResolvedAccount;
-    cfg?: unknown;
-    runtime?: unknown;
-    abortSignal?: AbortSignal;
-    log?: {
-        info: (msg: string) => void;
-        warn: (msg: string) => void;
-        error: (msg: string) => void;
-        debug?: (msg: string) => void;
-    };
-    getStatus?: () => unknown;
-    setStatus?: (next: unknown) => void;
-}
-
-/**
- * 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;
-}
-
 /**
  * 灵爻频道插件 - 服务器中转模式
  */
@@ -1094,14 +943,17 @@ declare function validateConfig(config: unknown): LingyaoConfig;
  */
 declare function getDefaultConfig(): LingyaoConfig;
 
-/**
- * Create a LingyaoChannel instance (legacy API).
- * Use this for standalone usage without the OpenClaw SDK.
- */
+declare const _default: {
+    id: string;
+    name: string;
+    description: string;
+    configSchema: openclaw_plugin_sdk.OpenClawPluginConfigSchema;
+    register: NonNullable<openclaw_plugin_sdk_core.OpenClawPluginDefinition["register"]>;
+} & Pick<openclaw_plugin_sdk_core.OpenClawPluginDefinition, "kind">;
+
+/** @deprecated Use the default export (OpenClaw SDK entry) instead. */
 declare function createPlugin(runtime: LingyaoRuntime, config?: Partial<LingyaoConfig>): Promise<LingyaoChannel>;
-/**
- * Plugin metadata (legacy API).
- */
+/** @deprecated Use openclaw.plugin.json for plugin metadata. */
 declare const pluginMetadata: {
     name: string;
     version: string;
@@ -1115,115 +967,5 @@ declare const pluginMetadata: {
     };
     defaultConfig: LingyaoConfig;
 };
-declare const pluginEntry: {
-    id: string;
-    name: string;
-    description: string;
-    setRuntime(runtime: unknown): void;
-    readonly plugin: {
-        id: "lingyao";
-        meta: {
-            id: string;
-            label: string;
-            selectionLabel: string;
-            docsPath: string;
-            docsLabel: string;
-            blurb: string;
-            order: number;
-            aliases: string[];
-        };
-        capabilities: {
-            chatTypes: readonly ["direct"];
-            media: boolean;
-            reactions: boolean;
-            threads: boolean;
-            polls: boolean;
-            edit: boolean;
-            unsend: boolean;
-            reply: boolean;
-            effects: boolean;
-            groupManagement: boolean;
-            nativeCommands: boolean;
-            blockStreaming: boolean;
-        };
-        config: {
-            listAccountIds(cfg: unknown): string[];
-            resolveAccount(cfg: unknown, accountId?: string | null): ResolvedAccount;
-            isConfigured(_account: ResolvedAccount): boolean;
-            isEnabled(account: ResolvedAccount): boolean;
-        };
-        gateway: {
-            startAccount(ctx: GatewayContext): Promise<void>;
-            stopAccount(ctx: GatewayContext): Promise<void>;
-        };
-        outbound: {
-            deliveryMode: "direct";
-            sendText(ctx: OutboundContext): Promise<DeliveryResult>;
-            sendPayload(ctx: OutboundPayloadContext): Promise<DeliveryResult>;
-            resolveTarget(params: {
-                cfg?: unknown;
-                to?: string;
-                accountId?: string | null;
-            }): {
-                ok: true;
-                to: string;
-            } | {
-                ok: false;
-                error: Error;
-            };
-        };
-        status: {
-            probeAccount(params: {
-                account: ResolvedAccount;
-                timeoutMs: number;
-                cfg: unknown;
-            }): Promise<LingyaoProbeResult>;
-            buildChannelSummary(params: {
-                account: ResolvedAccount;
-                cfg: unknown;
-                defaultAccountId: string;
-                snapshot: Record<string, unknown>;
-            }): Promise<Record<string, unknown>>;
-        };
-        directory: {
-            listPeers(params: {
-                cfg: unknown;
-                accountId?: string | null;
-                query?: string | null;
-                limit?: number | null;
-                runtime?: unknown;
-            }): Promise<DirectoryEntry[]>;
-        };
-        messaging: {
-            normalizeTarget(raw: string): string | undefined;
-            resolveSessionTarget(params: {
-                kind: "group" | "channel";
-                id: string;
-                threadId?: string | null;
-            }): string | undefined;
-            inferTargetChatType(_params: {
-                to: string;
-            }): "direct" | undefined;
-        };
-    };
-    security: {
-        dm: {
-            channelKey: string;
-            resolvePolicy: (account: ResolvedAccount) => "paired" | "open" | "deny";
-            resolveAllowFrom: (account: ResolvedAccount) => readonly string[];
-            defaultPolicy: "paired";
-        };
-    };
-    pairing: {
-        text: {
-            idLabel: string;
-            message: string;
-            notify: (params: {
-                cfg: unknown;
-                id: string;
-            }) => Promise<void>;
-        };
-    };
-};
 
-export { type AgentMessage, DeviceInfo, DeviceToken, HealthStatus, LingyaoAccountConfig, LingyaoChannel, LingyaoConfig, LingyaoMessage, LingyaoRuntime, NotifyPayload, SyncRequest, SyncResponse, createPlugin, pluginEntry as default, getDefaultConfig, pluginMetadata, validateConfig };
+export { type AgentMessage, DeviceInfo, DeviceToken, HealthStatus, LingyaoChannel, LingyaoConfig, LingyaoMessage, LingyaoRuntime, NotifyPayload, SyncRequest, SyncResponse, createPlugin, _default as default, getDefaultConfig, pluginMetadata, validateConfig };