lightclawbot 1.0.6 → 1.0.8

package/dist/src/socket/handlers.js

@@ -0,0 +1,130 @@
+/**
+ * LightClaw — Socket.IO 事件处理器
+ *
+ * 将 socket 事件监听（message:private、history:request、sessions:request）
+ * 从 gateway 主逻辑中解耦。
+ *
+ * 所有出站 socket.emit 通过 ReliableEmitter 实现 ACK 确认 + 自动重试。
+ */
+import { CHANNEL_KEY, EVENT_MESSAGE_PRIVATE, EVENT_HISTORY_REQUEST, EVENT_HISTORY_RESPONSE, EVENT_SESSIONS_REQUEST, EVENT_SESSIONS_RESPONSE, DEFAULT_HISTORY_LIMIT, } from "../config.js";
+import { isDuplicate, debounceHistoryRequest, generateMsgId } from "../dedup.js";
+import { getAssistantRuntime } from "../runtime.js";
+import { readSessionHistoryWithCron, listSessions } from "../history/index.js";
+/**
+ * 绑定所有 Socket.IO 事件监听器
+ */
+export function bindSocketHandlers(socket, deps) {
+    const { account, botClientId, log, enqueueMessage, onEvent, reliableEmitter } = deps;
+    // ---- 接收用户消息 ----
+    socket.on(EVENT_MESSAGE_PRIVATE, (data, ack) => {
+        ack?.();
+        log?.info(`[${CHANNEL_KEY}] Received private message: ${JSON.stringify(data)}，botClientId:${botClientId}`);
+        // 回环防御：过滤自身发出的消息
+        if (data.from === botClientId)
+            return;
+        // 跳过控制消息（typing / stream 信号），只处理真实用户消息
+        if (data.kind && data.kind !== "text")
+            return;
+        // 无内容跳过
+        const hasContent = data.content?.trim();
+        const hasFiles = data.files && data.files.length > 0;
+        if (!hasContent && !hasFiles)
+            return;
+        // 去重
+        if (isDuplicate(data.msgId))
+            return;
+        // 通知框架收到入站事件（更新 lastEventAt，防止 stale-socket 误判）
+        onEvent?.();
+        log?.info(`[${CHANNEL_KEY}] Message from ${data.from}: "${(data.content || "").slice(0, 60)}" files=${data.files?.length ?? 0}`);
+        enqueueMessage({
+            senderId: data.from,
+            text: data.content || "",
+            messageId: data.msgId,
+            files: data.files ?? [],
+            timestamp: data.timestamp,
+        });
+    });
+    // ---- 历史消息请求 ----
+    socket.on(EVENT_HISTORY_REQUEST, (data, ack) => {
+        ack?.();
+        if (!data?.from) {
+            log?.warn(`[${CHANNEL_KEY}] History request missing userId, ignoring`);
+            return;
+        }
+        // 回环防御：忽略 bot 自身发出的请求
+        if (data.from === botClientId)
+            return;
+        // 去重：如果有 msgId，走消息级去重
+        if (data.msgId && isDuplicate(data.msgId)) {
+            log?.warn(`[${CHANNEL_KEY}] Duplicate history request (msgId), ignoring`);
+            return;
+        }
+        // 防抖：同一用户高频请求只处理最后一条
+        debounceHistoryRequest(data.from, () => {
+            // 通知框架收到入站事件（更新 lastEventAt，防止 stale-socket 误判）
+            onEvent?.();
+            try {
+                const pluginRuntime = getAssistantRuntime();
+                const currentCfg = pluginRuntime.config.loadConfig();
+                const route = pluginRuntime.channel.routing.resolveAgentRoute({
+                    cfg: currentCfg,
+                    channel: CHANNEL_KEY,
+                    accountId: account.accountId,
+                    peer: { kind: "direct", id: data.from },
+                });
+                const sessionKey = route?.sessionKey ?? `${CHANNEL_KEY}:dm:${data.from}`;
+                const messages = readSessionHistoryWithCron(sessionKey, {
+                    limit: data.limit ?? DEFAULT_HISTORY_LIMIT,
+                    chatOnly: data.chatOnly ?? true,
+                    includeCron: true,
+                });
+                log?.info(`[${CHANNEL_KEY}] History request: userId=${data.from} sessionKey=${sessionKey} found=${messages.length}`);
+                const historyMsgId = generateMsgId();
+                reliableEmitter.emitWithAck(EVENT_HISTORY_RESPONSE, {
+                    msgId: historyMsgId,
+                    from: botClientId,
+                    to: data.from,
+                    sessionKey,
+                    messages: messages.filter(msg => !!msg.content.trim() || (msg.files && msg.files.length > 0)),
+                }, historyMsgId);
+            }
+            catch (err) {
+                log?.error(`[${CHANNEL_KEY}] History request error: ${err}`);
+                const errorMsgId = generateMsgId();
+                reliableEmitter.emitWithAck(EVENT_HISTORY_RESPONSE, {
+                    msgId: errorMsgId,
+                    from: botClientId,
+                    to: data.from,
+                    sessionKey: "",
+                    messages: [],
+                    error: err instanceof Error ? err.message : String(err),
+                }, errorMsgId);
+            }
+        });
+    });
+    // ---- 会话列表请求 ----
+    socket.on(EVENT_SESSIONS_REQUEST, (data) => {
+        // 通知框架收到入站事件（更新 lastEventAt，防止 stale-socket 误判）
+        onEvent?.();
+        try {
+            const sessions = listSessions();
+            const sessionsMsgId = generateMsgId();
+            reliableEmitter.emitWithAck(EVENT_SESSIONS_RESPONSE, {
+                requestId: data.requestId,
+                sessions,
+                msgId: sessionsMsgId,
+            }, sessionsMsgId);
+        }
+        catch (err) {
+            log?.error(`[${CHANNEL_KEY}] Sessions list error: ${err}`);
+            const sessionsErrMsgId = generateMsgId();
+            reliableEmitter.emitWithAck(EVENT_SESSIONS_RESPONSE, {
+                requestId: data.requestId,
+                sessions: [],
+                error: err instanceof Error ? err.message : String(err),
+                msgId: sessionsErrMsgId,
+            }, sessionsErrMsgId);
+        }
+    });
+}
+//# sourceMappingURL=handlers.js.map

package/dist/src/socket/handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.js","sourceRoot":"","sources":["../../../src/socket/handlers.ts"],"names":[],"mappings":"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"}

package/dist/src/socket/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * LightClaw — Socket 模块统一入口
+ *
+ * 收敛所有 socket 相关逻辑：事件处理器、注册表、可靠发送。
+ */
+export { bindSocketHandlers } from "./handlers.js";
+export type { SocketHandlerDeps } from "./handlers.js";
+export { registerSocket, unregisterSocket, getSocket, hasEntry, getBotClientId, getReliableEmitter, bufferMessage, flushPendingMessages, getPendingCount, } from "./registry.js";
+export { ReliableEmitter } from "./reliable-emitter.js";
+export type { EmitterStats } from "./reliable-emitter.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/socket/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/socket/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,YAAY,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,SAAS,EACT,QAAQ,EACR,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,oBAAoB,EACpB,eAAe,GAChB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/src/socket/index.js

@@ -0,0 +1,9 @@
+/**
+ * LightClaw — Socket 模块统一入口
+ *
+ * 收敛所有 socket 相关逻辑：事件处理器、注册表、可靠发送。
+ */
+export { bindSocketHandlers } from "./handlers.js";
+export { registerSocket, unregisterSocket, getSocket, hasEntry, getBotClientId, getReliableEmitter, bufferMessage, flushPendingMessages, getPendingCount, } from "./registry.js";
+export { ReliableEmitter } from "./reliable-emitter.js";
+//# sourceMappingURL=index.js.map

package/dist/src/socket/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/socket/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAGnD,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,SAAS,EACT,QAAQ,EACR,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,oBAAoB,EACpB,eAAe,GAChB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/src/socket/registry.d.ts

@@ -0,0 +1,59 @@
+/**
+ * LightClaw — Socket 注册表
+ *
+ * 让 gateway 启动时注册 socket 实例，
+ * outbound 在需要发送消息时可以通过 WS 连接直接发送，
+ * 无需走 REST API。
+ *
+ * 断线缓冲：
+ *   当 socket 暂时断开（Socket.IO 自动重连中）时，outbound 消息
+ *   会被缓冲在 pendingMessages 队列中，重连后自动 flush 发送。
+ *   仅在 gateway 彻底销毁（cleanup）时才删除 entry。
+ */
+import type { Socket } from "socket.io-client";
+import type { PrivateMessageData } from "../types.js";
+import type { ReliableEmitter } from "./reliable-emitter.js";
+interface SocketEntry {
+    socket: Socket;
+    botClientId: string;
+    /** 断线期间缓冲的待发消息 */
+    pendingMessages: PrivateMessageData[];
+    /** 可靠发送器（由 gateway 创建后注入） */
+    reliableEmitter?: ReliableEmitter;
+}
+/** 注册 socket（gateway 首次连接时调用） */
+export declare function registerSocket(accountId: string, socket: Socket, botClientId: string, reliableEmitter?: ReliableEmitter): void;
+/**
+ * 注销 socket（gateway 彻底销毁时调用）。
+ * 注意：普通断线重连不应调用此函数，只在 cleanup 时调用。
+ */
+export declare function unregisterSocket(accountId: string): void;
+/** 获取可用的 socket（仅在 connected 时返回） */
+export declare function getSocket(accountId: string): Pick<SocketEntry, "socket" | "botClientId"> | undefined;
+/** 检查 account 是否有注册的 entry（不管是否 connected） */
+export declare function hasEntry(accountId: string): boolean;
+/** 获取 botClientId（不管 socket 是否 connected） */
+export declare function getBotClientId(accountId: string): string | undefined;
+/** 获取可靠发送器 */
+export declare function getReliableEmitter(accountId: string): ReliableEmitter | undefined;
+/**
+ * 缓冲一条消息（socket 断开期间由 outbound 调用）。
+ * 返回 true 表示成功缓冲，false 表示该 account 没有注册的 entry。
+ */
+export declare function bufferMessage(accountId: string, message: PrivateMessageData): boolean;
+/**
+ * flush 所有缓冲消息（重连成功后由 gateway 调用）。
+ * 如果有 ReliableEmitter，走可靠发送；否则 fallback 直接 emit。
+ * 返回发送成功 / 失败的计数。
+ */
+export declare function flushPendingMessages(accountId: string, log?: {
+    info: (msg: string) => void;
+    warn: (msg: string) => void;
+}): {
+    sent: number;
+    failed: number;
+};
+/** 获取缓冲队列长度（调试/监控用） */
+export declare function getPendingCount(accountId: string): number;
+export {};
+//# sourceMappingURL=registry.d.ts.map

package/dist/src/socket/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/socket/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAM7D,UAAU,WAAW;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB;IAClB,eAAe,EAAE,kBAAkB,EAAE,CAAC;IACtC,6BAA6B;IAC7B,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AASD,iCAAiC;AACjC,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,eAAe,CAAC,EAAE,eAAe,GAChC,IAAI,CAUN;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAExD;AAMD,qCAAqC;AACrC,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE,QAAQ,GAAG,aAAa,CAAC,GAAG,SAAS,CAIpG;AAED,8CAA8C;AAC9C,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED,6CAA6C;AAC7C,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEpE;AAED,cAAc;AACd,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAEjF;AAMD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAUrF;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,GAAG,CAAC,EAAE;IAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,GACjE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAqClC;AAED,uBAAuB;AACvB,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEzD"}

package/dist/src/socket/registry.js

@@ -0,0 +1,125 @@
+/**
+ * LightClaw — Socket 注册表
+ *
+ * 让 gateway 启动时注册 socket 实例，
+ * outbound 在需要发送消息时可以通过 WS 连接直接发送，
+ * 无需走 REST API。
+ *
+ * 断线缓冲：
+ *   当 socket 暂时断开（Socket.IO 自动重连中）时，outbound 消息
+ *   会被缓冲在 pendingMessages 队列中，重连后自动 flush 发送。
+ *   仅在 gateway 彻底销毁（cleanup）时才删除 entry。
+ */
+import { MAX_PENDING_MESSAGES, EVENT_MESSAGE_PRIVATE } from "../config.js";
+/** accountId → SocketEntry */
+const registry = new Map();
+// ============================================================
+// 注册 / 注销
+// ============================================================
+/** 注册 socket（gateway 首次连接时调用） */
+export function registerSocket(accountId, socket, botClientId, reliableEmitter) {
+    const existing = registry.get(accountId);
+    if (existing) {
+        // 重连场景：更新 socket 引用，保留 pending 队列
+        existing.socket = socket;
+        existing.botClientId = botClientId;
+        existing.reliableEmitter = reliableEmitter;
+    }
+    else {
+        registry.set(accountId, { socket, botClientId, pendingMessages: [], reliableEmitter });
+    }
+}
+/**
+ * 注销 socket（gateway 彻底销毁时调用）。
+ * 注意：普通断线重连不应调用此函数，只在 cleanup 时调用。
+ */
+export function unregisterSocket(accountId) {
+    registry.delete(accountId);
+}
+// ============================================================
+// 查询
+// ============================================================
+/** 获取可用的 socket（仅在 connected 时返回） */
+export function getSocket(accountId) {
+    const entry = registry.get(accountId);
+    if (entry && entry.socket.connected)
+        return entry;
+    return undefined;
+}
+/** 检查 account 是否有注册的 entry（不管是否 connected） */
+export function hasEntry(accountId) {
+    return registry.has(accountId);
+}
+/** 获取 botClientId（不管 socket 是否 connected） */
+export function getBotClientId(accountId) {
+    return registry.get(accountId)?.botClientId;
+}
+/** 获取可靠发送器 */
+export function getReliableEmitter(accountId) {
+    return registry.get(accountId)?.reliableEmitter;
+}
+// ============================================================
+// 断线缓冲
+// ============================================================
+/**
+ * 缓冲一条消息（socket 断开期间由 outbound 调用）。
+ * 返回 true 表示成功缓冲，false 表示该 account 没有注册的 entry。
+ */
+export function bufferMessage(accountId, message) {
+    const entry = registry.get(accountId);
+    if (!entry)
+        return false;
+    if (entry.pendingMessages.length >= MAX_PENDING_MESSAGES) {
+        // 队列满了，丢弃最早的消息
+        entry.pendingMessages.shift();
+    }
+    entry.pendingMessages.push(message);
+    return true;
+}
+/**
+ * flush 所有缓冲消息（重连成功后由 gateway 调用）。
+ * 如果有 ReliableEmitter，走可靠发送；否则 fallback 直接 emit。
+ * 返回发送成功 / 失败的计数。
+ */
+export function flushPendingMessages(accountId, log) {
+    const entry = registry.get(accountId);
+    if (!entry)
+        return { sent: 0, failed: 0 };
+    const pending = entry.pendingMessages.splice(0); // 取出全部并清空
+    if (pending.length === 0)
+        return { sent: 0, failed: 0 };
+    let sent = 0;
+    let failed = 0;
+    for (const msg of pending) {
+        if (!entry.socket.connected) {
+            // socket 又断了，把剩余消息放回去
+            entry.pendingMessages.unshift(...pending.slice(sent + failed));
+            break;
+        }
+        if (entry.reliableEmitter) {
+            // 通过可靠发送器发送
+            entry.reliableEmitter.emitWithAck(EVENT_MESSAGE_PRIVATE, msg, msg.msgId);
+            sent++;
+        }
+        else {
+            // fallback: 直接 emit（不应该走到这里）
+            try {
+                entry.socket.emit(EVENT_MESSAGE_PRIVATE, msg);
+                sent++;
+            }
+            catch {
+                failed++;
+                log?.warn(`[socket-registry] Failed to flush buffered message: msgId=${msg.msgId}`);
+            }
+        }
+    }
+    if (sent > 0 || failed > 0) {
+        log?.info(`[socket-registry] Flushed pending messages: sent=${sent}, failed=${failed}`);
+    }
+    return { sent, failed };
+}
+/** 获取缓冲队列长度（调试/监控用） */
+export function getPendingCount(accountId) {
+    return registry.get(accountId)?.pendingMessages.length ?? 0;
+}
+//# sourceMappingURL=registry.js.map

package/dist/src/socket/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/socket/registry.ts"],"names":[],"mappings":"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"}

package/dist/src/socket/reliable-emitter.d.ts

@@ -0,0 +1,79 @@
+/**
+ * LightClaw — 可靠发送器
+ *
+ * 所有出站 socket.emit 都通过此模块，利用 Socket.IO 原生 ACK + timeout 机制：
+ *   socket.timeout(ms).emit(event, data, (err, ...args) => { ... })
+ * 超时由 Socket.IO 原生处理，回调第一个参数为 Error（超时）或 null（成功）。
+ *
+ * 未收到 ACK 则指数退避重试，断线期间暂停重试、重连后立即重发。
+ */
+import type { Socket } from "socket.io-client";
+export interface EmitterStats {
+    totalEmitted: number;
+    totalConfirmed: number;
+    totalRetries: number;
+    totalFailed: number;
+    currentPending: number;
+}
+type LogFn = {
+    info: (msg: string) => void;
+    warn: (msg: string) => void;
+    error: (msg: string) => void;
+};
+export declare class ReliableEmitter {
+    private getSocket;
+    private log?;
+    private pending;
+    private paused;
+    private idCounter;
+    private stats;
+    constructor(getSocket: () => Socket | null, log?: LogFn | undefined);
+    /**
+     * 可靠发送 — 带 ACK 确认 + 自动重试。
+     *
+     * 每次调用都是独立的发送请求，不会因相同 msgId 被合并。
+     * msgId 仅用于日志追踪，内部使用自增 emitId 作为 pending key。
+     *
+     * @param event  Socket.IO 事件名
+     * @param data   消息体
+     * @param msgId  业务层消息 ID（仅用于日志追踪，可选）
+     * @returns true = server 已确认, false = 重试耗尽未确认
+     */
+    emitWithAck(event: string, data: unknown, msgId?: string): Promise<boolean>;
+    /**
+     * 断线时调用 — 暂停所有重试计时器
+     */
+    pause(): void;
+    /**
+     * 重连时调用 — 立即重发所有待确认消息
+     */
+    resume(): void;
+    /**
+     * 销毁 — 清除所有定时器，resolve 所有 pending 为 false
+     */
+    destroy(): void;
+    /** 当前待确认消息数 */
+    get pendingCount(): number;
+    /** 获取统计信息 */
+    getStats(): EmitterStats;
+    /**
+     * 通过 socket.timeout(ms).emit(event, data, callback) 发送消息。
+     *
+     * - 超时由 Socket.IO 原生 .timeout() 处理，无需手动 setTimeout
+     * - 回调签名为 (err: Error | null, ...args)，err 非空说明超时或出错
+     * - socket.emit 是异步的，不会抛同步异常，无需 try-catch
+     */
+    private doEmit;
+    private confirm;
+    private scheduleRetry;
+    /**
+     * 指数退避 + 随机抖动
+     * delay = min(base * 2^(retryCount-1) + jitter, maxDelay)
+     */
+    private getRetryDelay;
+    /** 队列满时淘汰最早的 pending 消息 */
+    private evictIfNeeded;
+    private generateEmitId;
+}
+export {};
+//# sourceMappingURL=reliable-emitter.d.ts.map

package/dist/src/socket/reliable-emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reliable-emitter.d.ts","sourceRoot":"","sources":["../../../src/socket/reliable-emitter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAwB/C,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,KAAK,KAAK,GAAG;IACX,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B,CAAC;AAMF,qBAAa,eAAe;IAcxB,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,GAAG,CAAC;IAdd,OAAO,CAAC,OAAO,CAAqC;IACpD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAK;IAGtB,OAAO,CAAC,KAAK,CAKX;gBAGQ,SAAS,EAAE,MAAM,MAAM,GAAG,IAAI,EAC9B,GAAG,CAAC,EAAE,KAAK,YAAA;IAOrB;;;;;;;;;;OAUG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA+B3E;;OAEG;IACH,KAAK,IAAI,IAAI;IAYb;;OAEG;IACH,MAAM,IAAI,IAAI;IASd;;OAEG;IACH,OAAO,IAAI,IAAI;IASf,eAAe;IACf,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,aAAa;IACb,QAAQ,IAAI,YAAY;IAQxB;;;;;;OAMG;IACH,OAAO,CAAC,MAAM;IAuBd,OAAO,CAAC,OAAO;IAaf,OAAO,CAAC,aAAa;IA4BrB;;;OAGG;IACH,OAAO,CAAC,aAAa;IAMrB,2BAA2B;IAC3B,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,cAAc;CAGvB"}

package/dist/src/socket/reliable-emitter.js

@@ -0,0 +1,213 @@
+/**
+ * LightClaw — 可靠发送器
+ *
+ * 所有出站 socket.emit 都通过此模块，利用 Socket.IO 原生 ACK + timeout 机制：
+ *   socket.timeout(ms).emit(event, data, (err, ...args) => { ... })
+ * 超时由 Socket.IO 原生处理，回调第一个参数为 Error（超时）或 null（成功）。
+ *
+ * 未收到 ACK 则指数退避重试，断线期间暂停重试、重连后立即重发。
+ */
+import { EMIT_ACK_TIMEOUT, EMIT_MAX_RETRIES, EMIT_RETRY_BASE_DELAY, EMIT_RETRY_MAX_DELAY, EMIT_PENDING_MAX, } from "../config.js";
+// ============================================================
+// ReliableEmitter
+// ============================================================
+export class ReliableEmitter {
+    getSocket;
+    log;
+    pending = new Map();
+    paused = false;
+    idCounter = 0;
+    // 统计
+    stats = {
+        totalEmitted: 0,
+        totalConfirmed: 0,
+        totalRetries: 0,
+        totalFailed: 0,
+    };
+    constructor(getSocket, log) {
+        this.getSocket = getSocket;
+        this.log = log;
+    }
+    // ----------------------------------------------------------
+    // 公开 API
+    // ----------------------------------------------------------
+    /**
+     * 可靠发送 — 带 ACK 确认 + 自动重试。
+     *
+     * 每次调用都是独立的发送请求，不会因相同 msgId 被合并。
+     * msgId 仅用于日志追踪，内部使用自增 emitId 作为 pending key。
+     *
+     * @param event  Socket.IO 事件名
+     * @param data   消息体
+     * @param msgId  业务层消息 ID（仅用于日志追踪，可选）
+     * @returns true = server 已确认, false = 重试耗尽未确认
+     */
+    emitWithAck(event, data, msgId) {
+        // 每次调用生成唯一的内部 ID，确保同一 msgId 的多次 emit 不会互相覆盖
+        const emitId = this.generateEmitId();
+        this.stats.totalEmitted++;
+        // 队列满时淘汰最早的
+        this.evictIfNeeded();
+        return new Promise((resolve) => {
+            const entry = {
+                id: emitId,
+                msgId,
+                event,
+                data,
+                retryCount: 0,
+                createdAt: Date.now(),
+                retryTimer: null,
+                resolve,
+            };
+            this.pending.set(emitId, entry);
+            if (this.paused) {
+                // 断线中，先挂着，resume 时统一重发
+                this.log?.info(`[ReliableEmitter] Queued while paused: emitId=${emitId}, msgId=${msgId}`);
+                return;
+            }
+            this.doEmit(entry);
+        });
+    }
+    /**
+     * 断线时调用 — 暂停所有重试计时器
+     */
+    pause() {
+        if (this.paused)
+            return;
+        this.paused = true;
+        for (const entry of this.pending.values()) {
+            if (entry.retryTimer) {
+                clearTimeout(entry.retryTimer);
+                entry.retryTimer = null;
+            }
+        }
+        this.log?.info(`[ReliableEmitter] Paused, ${this.pending.size} message(s) pending`);
+    }
+    /**
+     * 重连时调用 — 立即重发所有待确认消息
+     */
+    resume() {
+        if (!this.paused)
+            return;
+        this.paused = false;
+        this.log?.info(`[ReliableEmitter] Resumed, re-emitting ${this.pending.size} pending message(s)`);
+        for (const entry of this.pending.values()) {
+            this.doEmit(entry);
+        }
+    }
+    /**
+     * 销毁 — 清除所有定时器，resolve 所有 pending 为 false
+     */
+    destroy() {
+        for (const entry of this.pending.values()) {
+            if (entry.retryTimer)
+                clearTimeout(entry.retryTimer);
+            entry.resolve(false);
+        }
+        this.pending.clear();
+        this.log?.info(`[ReliableEmitter] Destroyed`);
+    }
+    /** 当前待确认消息数 */
+    get pendingCount() {
+        return this.pending.size;
+    }
+    /** 获取统计信息 */
+    getStats() {
+        return { ...this.stats, currentPending: this.pending.size };
+    }
+    // ----------------------------------------------------------
+    // 内部方法
+    // ----------------------------------------------------------
+    /**
+     * 通过 socket.timeout(ms).emit(event, data, callback) 发送消息。
+     *
+     * - 超时由 Socket.IO 原生 .timeout() 处理，无需手动 setTimeout
+     * - 回调签名为 (err: Error | null, ...args)，err 非空说明超时或出错
+     * - socket.emit 是异步的，不会抛同步异常，无需 try-catch
+     */
+    doEmit(entry) {
+        const socket = this.getSocket();
+        if (!socket?.connected) {
+            // socket 不可用，等 resume 时重发（不计重试次数）
+            return;
+        }
+        socket.timeout(EMIT_ACK_TIMEOUT).emit(entry.event, entry.data, (err) => {
+            // 已被 destroy 或 confirm
+            if (!this.pending.has(entry.id))
+                return;
+            if (err) {
+                // 超时或服务端回传了错误
+                this.log?.warn(`[ReliableEmitter] ACK error: emitId=${entry.id}, msgId=${entry.msgId}, err=${err.message}, retryCount=${entry.retryCount}`);
+                this.scheduleRetry(entry);
+            }
+            else {
+                this.log?.info(`[ReliableEmitter] ACK success: emitId=${entry.id}, msgId=${entry.msgId}, retryCount=${entry.retryCount}`);
+                // 服务端已确认
+                this.confirm(entry.id);
+            }
+        });
+    }
+    confirm(id) {
+        const entry = this.pending.get(id);
+        if (!entry)
+            return; // 已被 confirm 或 destroy
+        if (entry.retryTimer) {
+            clearTimeout(entry.retryTimer);
+            entry.retryTimer = null;
+        }
+        this.pending.delete(id);
+        this.stats.totalConfirmed++;
+        entry.resolve(true);
+    }
+    scheduleRetry(entry) {
+        // 断线中不重试
+        if (this.paused)
+            return;
+        if (entry.retryCount >= EMIT_MAX_RETRIES) {
+            // 重试耗尽
+            this.pending.delete(entry.id);
+            this.stats.totalFailed++;
+            this.log?.error(`[ReliableEmitter] Gave up after ${entry.retryCount} retries: emitId=${entry.id}, msgId=${entry.msgId}, ` +
+                `elapsed=${Date.now() - entry.createdAt}ms`);
+            entry.resolve(false);
+            return;
+        }
+        entry.retryCount++;
+        this.stats.totalRetries++;
+        const delay = this.getRetryDelay(entry.retryCount);
+        this.log?.info(`[ReliableEmitter] Retry #${entry.retryCount} in ${delay}ms: emitId=${entry.id}, msgId=${entry.msgId}`);
+        entry.retryTimer = setTimeout(() => {
+            entry.retryTimer = null;
+            if (this.paused)
+                return; // 重试期间断线了
+            this.doEmit(entry);
+        }, delay);
+    }
+    /**
+     * 指数退避 + 随机抖动
+     * delay = min(base * 2^(retryCount-1) + jitter, maxDelay)
+     */
+    getRetryDelay(retryCount) {
+        const base = EMIT_RETRY_BASE_DELAY * Math.pow(2, retryCount - 1);
+        const jitter = Math.random() * 1000;
+        return Math.min(base + jitter, EMIT_RETRY_MAX_DELAY);
+    }
+    /** 队列满时淘汰最早的 pending 消息 */
+    evictIfNeeded() {
+        while (this.pending.size >= EMIT_PENDING_MAX) {
+            const oldest = this.pending.values().next().value;
+            if (!oldest)
+                break;
+            if (oldest.retryTimer)
+                clearTimeout(oldest.retryTimer);
+            this.pending.delete(oldest.id);
+            this.stats.totalFailed++;
+            this.log?.warn(`[ReliableEmitter] Evicted oldest pending: emitId=${oldest.id}, msgId=${oldest.msgId}`);
+            oldest.resolve(false);
+        }
+    }
+    generateEmitId() {
+        return `_re_${Date.now().toString(36)}_${(this.idCounter++).toString(36)}`;
+    }
+}
+//# sourceMappingURL=reliable-emitter.js.map