@53ai/53ai-openclaw 1.0.8 → 1.1.0

package/dist/src/const.d.ts

@@ -14,6 +14,12 @@ export declare const WS_RECONNECT_BASE_DELAY_MS = 1000;
 export declare const TEXT_CHUNK_LIMIT = 4000;
 /** 消息处理超时（毫秒） */
 export declare const MESSAGE_PROCESS_TIMEOUT_MS = 120000;
+/**
+ * 消息缓存 TTL（毫秒）
+ * 设为 35 分钟，确保覆盖最大重连时间（约 28.5 分钟）+ 缓冲
+ * @see WS_MAX_RECONNECT_ATTEMPTS - 60 次，指数退避最大 30s
+ */
+export declare const MESSAGE_CACHE_TTL_MS: number;
 /** 默认媒体大小上限（MB） */
 export declare const DEFAULT_MEDIA_MAX_MB = 20;
 /** 图片下载超时（毫秒） */

package/dist/src/message-cache.d.ts

@@ -0,0 +1,119 @@
+import type { RuntimeEnv } from "openclaw/plugin-sdk";
+import type { WebSocket } from "ws";
+/**
+ * 缓存的消息条目
+ */
+interface CachedMessage {
+    /** 缓存唯一 key */
+    cacheKey: string;
+    /** 消息 ID */
+    reqId: string;
+    /** 目标聊天 ID */
+    toChatId: string;
+    /** 消息内容 */
+    text: string;
+    /** 是否为最终消息 */
+    finish: boolean;
+    /** 是否为错误消息 */
+    isError?: boolean;
+    /** 错误码 */
+    errorCode?: string;
+    /** 错误详情 */
+    errorDetails?: string;
+    /** 是否为思考消息 */
+    isThinking?: boolean;
+    /** 创建时间戳 */
+    createdAt: number;
+    /** 重试次数 */
+    retryCount: number;
+}
+/**
+ * 消息缓存配置
+ */
+interface MessageCacheConfig {
+    maxEntries: number;
+    ttlMs: number;
+    maxRetries: number;
+}
+/**
+ * 按 accountId 隔离的消息缓存管理器
+ */
+declare class MessageCache {
+    private cache;
+    private config;
+    private accountId;
+    private runtime;
+    constructor(accountId: string, config?: Partial<MessageCacheConfig>, runtime?: RuntimeEnv);
+    /**
+     * 生成唯一缓存 key
+     */
+    private generateCacheKey;
+    /**
+     * 添加消息到缓存，返回缓存 key
+     */
+    add(params: {
+        reqId: string;
+        toChatId: string;
+        text: string;
+        finish: boolean;
+        isError?: boolean;
+        errorCode?: string;
+        errorDetails?: string;
+        isThinking?: boolean;
+    }): string;
+    /**
+     * 获取所有待重试的消息，返回 cacheKey + entry
+     */
+    getPendingMessages(): CachedMessage[];
+    /**
+     * 按 cacheKey 标记消息为已发送
+     */
+    markSent(cacheKey: string): void;
+    /**
+     * 按 cacheKey 增加重试计数
+     */
+    incrementRetry(cacheKey: string): void;
+    /**
+     * 清理过期条目
+     */
+    private prune;
+    size(): number;
+    clear(): void;
+}
+/**
+ * 获取或创建按账号隔离的缓存实例
+ */
+export declare function getMessageCache(accountId: string, runtime?: RuntimeEnv): MessageCache;
+/**
+ * 清理指定账号的缓存
+ */
+export declare function clearAccountCache(accountId: string): void;
+/**
+ * 发送消息参数（与 sendReply 兼容）
+ */
+export interface CachedSendParams {
+    wsClient: WebSocket;
+    text: string;
+    toChatId: string;
+    replyToMsgId?: string;
+    runtime: RuntimeEnv;
+    finish: boolean;
+    streamId: string;
+    isError?: boolean;
+    errorCode?: string;
+    errorDetails?: string;
+    isThinking?: boolean;
+}
+/**
+ * 缓存感知的消息发送器
+ * 返回 [success, cacheKey?] - 成功时 cacheKey 为 undefined，失败时返回缓存 key
+ */
+export declare function sendWithCache(accountId: string, params: CachedSendParams, sendFn: (params: CachedSendParams) => Promise<void>): Promise<{
+    success: boolean;
+    cacheKey?: string;
+}>;
+/**
+ * 重放缓存的消息
+ */
+export declare function replayCachedMessages(accountId: string, wsClient: WebSocket, runtime: RuntimeEnv, sendFn: (params: CachedSendParams) => Promise<void>): Promise<number>;
+export {};

package/dist/src/state-manager.d.ts

@@ -13,5 +13,5 @@ export declare function setLastMsgIdForChat(chatId: string, msgId: string, accou
 export declare function getLastMsgIdForChat(chatId: string, accountId?: string): string | undefined;
 export declare function warmupReqIdStore(accountId?: string, log?: (msg: string) => void): Promise<number>;
 export declare function flushReqIdStore(accountId?: string): Promise<void>;
-export declare function cleanupAccount(accountId: string): Promise<void>;
+export declare function cleanupAccount(accountId: string, clearCache?: boolean): Promise<void>;
 export declare function cleanupAll(): Promise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@53ai/53ai-openclaw",
-  "version": "1.0.8",
+  "version": "1.1.0",
   "type": "module",
   "main": "dist/index.cjs.js",
   "module": "dist/index.esm.js",
@@ -41,7 +41,7 @@
   "bugs": {
     "url": "https://github.com/53AI/53ai-openclaw/issues"
   },
-  "homepage": "https://github.com/53AI/53ai-openclaw#readme",
+  "homepage": "https://www.53ai.com",
   "dependencies": {
     "ws": "^8.16.0"
   },