lightclaw2 0.0.1

package/dist/src/gateway.js

@@ -0,0 +1,283 @@
+/**
+ * LightClaw — Socket.IO Gateway
+ *
+ * 连接编排层：
+ * 1. 管理 Socket.IO 连接生命周期（连接/断开/重连/防重入）
+ * 2. 维护消息队列，串行处理入站消息
+ * 3. 提供 socket emit 抽象供子模块使用
+ *
+ * 消息处理逻辑 → inbound.ts
+ * 事件监听绑定 → socket-handlers.ts
+ * 去重/节流/ID → dedup.ts
+ * 媒体文件处理 → media.ts
+ */
+import { io } from "socket.io-client";
+import { CHANNEL_KEY } from "./config.js";
+import { generateMsgId } from "./dedup.js";
+import { createInboundHandler } from "./inbound.js";
+import { bindSocketHandlers } from "./socket-handlers.js";
+import { registerSocket, unregisterSocket, flushPendingMessages } from "./socket-registry.js";
+// ============================================================
+// 常量
+// ============================================================
+const DOMIAN = "lightai.tencentcloud.com";
+const MESSAGE_QUEUE_SIZE = 1000; // 消息队列最大容量
+const MESSAGE_QUEUE_WARN_THRESHOLD = 800; // 队列警告阈值
+const QUEUE_POLL_INTERVAL = 200; // 队列轮询间隔（ms）
+const WS_URL = `wss://${DOMIAN}`;
+/**
+ * Health-monitor 心跳间隔：定期刷新 lastEventAt，防止空闲期被误判为 stale-socket。
+ * 框架默认 stale 阈值为 30 分钟，这里设为 20 分钟确保在阈值内刷新。
+ */
+const HEALTH_HEARTBEAT_INTERVAL = 20 * 60_000;
+// ============================================================
+// Gateway 实例追踪（防止同一 accountId 创建多个连接）
+// ============================================================
+/** accountId → cleanup function */
+const activeGateways = new Map();
+// ============================================================
+// 辅助
+// ============================================================
+/** HTTP API 基础地址（与 WS 同域） */
+const API_BASE_URL = `https://${DOMIAN}`;
+async function deriveBotClientId(apiKey) {
+    const url = `${API_BASE_URL}/user/current`;
+    const resp = await fetch(url, {
+        method: "GET",
+        headers: {
+            Authorization: `Bearer ${apiKey}`,
+            "X-Product": "channel",
+        },
+    });
+    if (!resp.ok) {
+        const body = await resp.text().catch(() => "");
+        throw new Error(`Failed to fetch botId: HTTP ${resp.status} ${resp.statusText}${body ? ` — ${body}` : ""}`);
+    }
+    const result = (await resp.json());
+    if (result.code !== 0) {
+        throw new Error(`Failed to fetch botId: code=${result.code}, message=${result.message ?? "unknown"}`);
+    }
+    const extra = result.data?.client?.extra;
+    if (!extra) {
+        throw new Error("Invalid response: missing data.client.extra");
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(extra);
+    }
+    catch {
+        throw new Error(`Invalid response: data.client.extra is not valid JSON: ${extra}`);
+    }
+    if (!parsed.botId) {
+        throw new Error(`Invalid response: missing botId in data.client.extra: ${extra}`);
+    }
+    return parsed.botId;
+}
+// ============================================================
+// 核心：启动 Gateway
+// ============================================================
+export async function startGateway(ctx) {
+    const { account, abortSignal, onReady, onDisconnect, onEvent, log } = ctx;
+    if (!account.apiKey) {
+        throw new Error(`[${CHANNEL_KEY}] Missing apiKey in config`);
+    }
+    // 防重入：如果同一 accountId 已有活跃 gateway，先销毁
+    const existingCleanup = activeGateways.get(account.accountId);
+    if (existingCleanup) {
+        log?.warn(`[${CHANNEL_KEY}] Destroying existing gateway for account ${account.accountId} before creating new one`);
+        existingCleanup();
+    }
+    // 通过 HTTP 接口获取 Bot 身份
+    log?.info(`[${CHANNEL_KEY}] Fetching bot clientId...`);
+    const botClientId = await deriveBotClientId(account.apiKey);
+    log?.info(`[${CHANNEL_KEY}] Bot clientId: ${botClientId}`);
+    let isAborted = false;
+    let currentSocket = null;
+    let healthHeartbeatTimer = null;
+    // ---- Socket.IO 发送抽象 ----
+    const emit = (data) => {
+        if (!currentSocket?.connected)
+            return false;
+        log?.info(`[${CHANNEL_KEY}] emit: ${JSON.stringify(data)}`);
+        try {
+            currentSocket.emit("message:private", data);
+            return true;
+        }
+        catch (err) {
+            log?.error(`[${CHANNEL_KEY}] emit error: ${err}`);
+            return false;
+        }
+    };
+    const sendReply = (targetId, text, replyToMsgId) => {
+        log?.info(`[${CHANNEL_KEY}] sendReply: ${text} to ${targetId} (replyTo: ${replyToMsgId || "none"})`);
+        return emit({
+            msgId: generateMsgId(),
+            from: botClientId,
+            to: targetId,
+            content: text,
+            timestamp: Date.now(),
+            replyToMsgId,
+        });
+    };
+    const sendFiles = (targetId, text, files, replyToMsgId) => {
+        return emit({
+            msgId: generateMsgId(),
+            from: botClientId,
+            to: targetId,
+            content: text,
+            timestamp: Date.now(),
+            files,
+            replyToMsgId,
+        });
+    };
+    const emitter = { emit, sendReply, sendFiles, botClientId };
+    // ---- 入站消息处理器 ----
+    const handleInboundMessage = createInboundHandler(account, emitter, log);
+    // ---- 消息队列 ----
+    const messageQueue = [];
+    let messageProcessorRunning = false;
+    let queueNotify = null;
+    const enqueueMessage = (msg) => {
+        if (messageQueue.length >= MESSAGE_QUEUE_SIZE) {
+            const dropped = messageQueue.shift();
+            log?.error(`[${CHANNEL_KEY}] Queue full, dropped message from ${dropped?.senderId}`);
+        }
+        if (messageQueue.length >= MESSAGE_QUEUE_WARN_THRESHOLD) {
+            log?.warn(`[${CHANNEL_KEY}] Queue size: ${messageQueue.length}/${MESSAGE_QUEUE_SIZE}`);
+        }
+        messageQueue.push(msg);
+        // 唤醒处理器
+        queueNotify?.();
+    };
+    /** 等待队列中有新消息，或超时后返回 */
+    const waitForMessage = () => {
+        if (messageQueue.length > 0)
+            return Promise.resolve();
+        return new Promise((resolve) => {
+            const timer = setTimeout(() => { queueNotify = null; resolve(); }, QUEUE_POLL_INTERVAL);
+            queueNotify = () => { clearTimeout(timer); queueNotify = null; resolve(); };
+        });
+    };
+    const startMessageProcessor = () => {
+        if (messageProcessorRunning)
+            return;
+        messageProcessorRunning = true;
+        const loop = async () => {
+            while (!isAborted) {
+                await waitForMessage();
+                while (messageQueue.length > 0 && !isAborted) {
+                    const msg = messageQueue.shift();
+                    try {
+                        await handleInboundMessage(msg);
+                    }
+                    catch (err) {
+                        log?.error(`[${CHANNEL_KEY}] Message handler error: ${err}`);
+                    }
+                }
+            }
+            messageProcessorRunning = false;
+        };
+        loop().catch((err) => {
+            log?.error(`[${CHANNEL_KEY}] Message processor crashed: ${err}`);
+            messageProcessorRunning = false;
+        });
+    };
+    // ---- 生命周期 ----
+    const cleanup = () => {
+        isAborted = true;
+        if (healthHeartbeatTimer) {
+            clearInterval(healthHeartbeatTimer);
+            healthHeartbeatTimer = null;
+        }
+        unregisterSocket(account.accountId);
+        activeGateways.delete(account.accountId);
+        if (currentSocket) {
+            currentSocket.removeAllListeners();
+            currentSocket.disconnect();
+            currentSocket = null;
+        }
+        log?.info(`[${CHANNEL_KEY}] Gateway cleaned up`);
+    };
+    activeGateways.set(account.accountId, cleanup);
+    // ---- Socket.IO 连接 ----
+    log?.info(`[${CHANNEL_KEY}] Connecting to ${WS_URL}...`);
+    const socket = io(WS_URL, {
+        auth: { 'x-product': 'channel', authorization: `Bearer ${account.apiKey}` },
+        path: '/claw-socket',
+        forceNew: true,
+        reconnection: true,
+        reconnectionAttempts: Infinity,
+        reconnectionDelay: 1000,
+        reconnectionDelayMax: 30000,
+        transports: ['websocket']
+    });
+    log?.info(`[${CHANNEL_KEY}] Socket created: ${JSON.stringify({
+        auth: { 'x-product': 'channel', authorization: `Bearer ${account.apiKey}` },
+        path: '/claw-socket',
+        forceNew: true,
+        reconnection: true,
+        reconnectionAttempts: Infinity,
+        reconnectionDelay: 1000,
+        reconnectionDelayMax: 30000,
+        transports: ['websocket']
+    })}`);
+    currentSocket = socket;
+    socket.on("connect", () => {
+        log?.info(`[${CHANNEL_KEY}] Connected (id=${socket.id}, botClientId=${botClientId})`);
+        registerSocket(account.accountId, socket, botClientId);
+        startMessageProcessor();
+        // 重连后 flush 断线期间缓冲的 outbound 消息
+        const { sent, failed } = flushPendingMessages(account.accountId, log);
+        if (sent > 0 || failed > 0) {
+            log?.info(`[${CHANNEL_KEY}] Flushed buffered outbound messages: sent=${sent}, failed=${failed}`);
+        }
+        // 启动 health-monitor 心跳：定期刷新 lastEventAt，防止空闲期被误判 stale-socket
+        if (healthHeartbeatTimer)
+            clearInterval(healthHeartbeatTimer);
+        healthHeartbeatTimer = setInterval(() => {
+            if (currentSocket?.connected) {
+                onEvent?.();
+                log?.debug?.(`[${CHANNEL_KEY}] Health heartbeat sent`);
+            }
+        }, HEALTH_HEARTBEAT_INTERVAL);
+        onReady?.();
+    });
+    // 绑定业务事件处理器
+    bindSocketHandlers(socket, {
+        account,
+        botClientId,
+        log,
+        enqueueMessage,
+        onEvent,
+    });
+    socket.on("connect_error", (err) => {
+        log?.error(`[${CHANNEL_KEY}] connect_error: ${err.message}`);
+    });
+    socket.on("disconnect", (reason) => {
+        log?.info(`[${CHANNEL_KEY}] Disconnected: ${reason}`);
+        // 断线时停止心跳，避免在未连接状态下假装活跃
+        if (healthHeartbeatTimer) {
+            clearInterval(healthHeartbeatTimer);
+            healthHeartbeatTimer = null;
+        }
+        // 注意：断线时不调用 unregisterSocket，保留 entry 以便 outbound 消息可以缓冲。
+        // 仅在 cleanup（gateway 彻底销毁）时才 unregisterSocket。
+        onDisconnect?.();
+        if (reason === "io server disconnect") {
+            // 服务端主动断开，需要手动重连
+            log?.warn(`[${CHANNEL_KEY}] Server forced disconnect, attempting manual reconnect...`);
+            socket.connect();
+        }
+    });
+    // ---- 保持 Promise 挂起直到 abort ----
+    // 框架认为 startAccount 返回的 Promise resolve = gateway 已退出，会触发 auto-restart。
+    // 因此必须让 Promise 一直挂起，直到 abortSignal 触发才 resolve。
+    return new Promise((resolve) => {
+        abortSignal.addEventListener("abort", () => {
+            cleanup();
+            log?.info(`[${CHANNEL_KEY}] Gateway aborted`);
+            resolve();
+        });
+    });
+}
+//# sourceMappingURL=gateway.js.map

package/dist/src/gateway.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway.js","sourceRoot":"","sources":["../../src/gateway.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,EAAE,EAAe,MAAM,kBAAkB,CAAC;AAOnD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,oBAAoB,EAAsB,MAAM,cAAc,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE9F,+DAA+D;AAC/D,KAAK;AACL,+DAA+D;AAC/D,MAAM,MAAM,GAAG,0BAA0B,CAAC;AAC1C,MAAM,kBAAkB,GAAG,IAAI,CAAC,CAAC,WAAW;AAC5C,MAAM,4BAA4B,GAAG,GAAG,CAAC,CAAC,SAAS;AACnD,MAAM,mBAAmB,GAAG,GAAG,CAAC,CAAC,aAAa;AAC9C,MAAM,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;AACjC;;;GAGG;AACH,MAAM,yBAAyB,GAAG,EAAE,GAAG,MAAM,CAAC;AAE9C,+DAA+D;AAC/D,sCAAsC;AACtC,+DAA+D;AAE/D,mCAAmC;AACnC,MAAM,cAAc,GAAG,IAAI,GAAG,EAAsB,CAAC;AAErD,+DAA+D;AAC/D,KAAK;AACL,+DAA+D;AAE/D,6BAA6B;AAC7B,MAAM,YAAY,GAAG,WAAW,MAAM,EAAE,CAAC;AAkBzC,KAAK,UAAU,iBAAiB,CAAC,MAAc;IAC7C,MAAM,GAAG,GAAG,GAAG,YAAY,eAAe,CAAC;IAC3C,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAC5B,MAAM,EAAE,KAAK;QACb,OAAO,EAAE;YACP,aAAa,EAAE,UAAU,MAAM,EAAE;YACjC,WAAW,EAAE,SAAS;SACvB;KACF,CAAC,CAAC;IAEH,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;QACb,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QAC/C,MAAM,IAAI,KAAK,CACb,+BAA+B,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAC3F,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAwB,CAAC;IAC1D,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,+BAA+B,MAAM,CAAC,IAAI,aAAa,MAAM,CAAC,OAAO,IAAI,SAAS,EAAE,CAAC,CAAC;IACxG,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC;IACzC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACjE,CAAC;IAED,IAAI,MAA0B,CAAC;IAC/B,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,0DAA0D,KAAK,EAAE,CAAC,CAAC;IACrF,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,yDAAyD,KAAK,EAAE,CAAC,CAAC;IACpF,CAAC;IAED,OAAO,MAAM,CAAC,KAAK,CAAC;AACtB,CAAC;AAED,+DAA+D;AAC/D,gBAAgB;AAChB,+DAA+D;AAE/D,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAmB;IACpD,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC;IAE1E,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,IAAI,WAAW,4BAA4B,CAAC,CAAC;IAC/D,CAAC;IAED,sCAAsC;IACtC,MAAM,eAAe,GAAG,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC9D,IAAI,eAAe,EAAE,CAAC;QACpB,GAAG,EAAE,IAAI,CAAC,IAAI,WAAW,6CAA6C,OAAO,CAAC,SAAS,0BAA0B,CAAC,CAAC;QACnH,eAAe,EAAE,CAAC;IACpB,CAAC;IAED,sBAAsB;IACtB,GAAG,EAAE,IAAI,CAAC,IAAI,WAAW,4BAA4B,CAAC,CAAC;IACvD,MAAM,WAAW,GAAG,MAAM,iBAAiB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5D,GAAG,EAAE,IAAI,CAAC,IAAI,WAAW,mBAAmB,WAAW,EAAE,CAAC,CAAC;IAE3D,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,IAAI,aAAa,GAAkB,IAAI,CAAC;IACxC,IAAI,oBAAoB,GAA0C,IAAI,CAAC;IAEvE,2BAA2B;IAE3B,MAAM,IAAI,GAAG,CAAC,IAAwB,EAAW,EAAE;QACjD,IAAI,CAAC,aAAa,EAAE,SAAS;YAAE,OAAO,KAAK,CAAC;QAC5C,GAAG,EAAE,IAAI,CAAC,IAAI,WAAW,WAAW,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC5D,IAAI,CAAC;YACH,aAAa,CAAC,IAAI,CAAC,iBAAiB,EAAE,IAAI,CAAC,CAAC;YAC5C,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,GAAG,EAAE,KAAK,CAAC,IAAI,WAAW,iBAAiB,GAAG,EAAE,CAAC,CAAC;YAClD,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,SAAS,GAAG,CAAC,QAAgB,EAAE,IAAY,EAAE,YAAqB,EAAW,EAAE;QACnF,GAAG,EAAE,IAAI,CAAC,IAAI,WAAW,gBAAgB,IAAI,OAAO,QAAQ,cAAc,YAAY,IAAI,MAAM,GAAG,CAAC,CAAC;QACrG,OAAO,IAAI,CAAC;YACV,KAAK,EAAE,aAAa,EAAE;YACtB,IAAI,EAAE,WAAW;YACjB,EAAE,EAAE,QAAQ;YACZ,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,YAAY;SACb,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,MAAM,SAAS,GAAG,CAAC,QAAgB,EAAE,IAAY,EAAE,KAAuB,EAAE,YAAqB,EAAW,EAAE;QAC5G,OAAO,IAAI,CAAC;YACV,KAAK,EAAE,aAAa,EAAE;YACtB,IAAI,EAAE,WAAW;YACjB,EAAE,EAAE,QAAQ;YACZ,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,KAAK;YACL,YAAY;SACb,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,MAAM,OAAO,GAAkB,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC;IAE3E,oBAAoB;IAEpB,MAAM,oBAAoB,GAAG,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;IAEzE,iBAAiB;IAEjB,MAAM,YAAY,GAAoB,EAAE,CAAC;IACzC,IAAI,uBAAuB,GAAG,KAAK,CAAC;IACpC,IAAI,WAAW,GAAwB,IAAI,CAAC;IAE5C,MAAM,cAAc,GAAG,CAAC,GAAkB,EAAQ,EAAE;QAClD,IAAI,YAAY,CAAC,MAAM,IAAI,kBAAkB,EAAE,CAAC;YAC9C,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,EAAE,CAAC;YACrC,GAAG,EAAE,KAAK,CAAC,IAAI,WAAW,sCAAsC,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;QACvF,CAAC;QACD,IAAI,YAAY,CAAC,MAAM,IAAI,4BAA4B,EAAE,CAAC;YACxD,GAAG,EAAE,IAAI,CAAC,IAAI,WAAW,iBAAiB,YAAY,CAAC,MAAM,IAAI,kBAAkB,EAAE,CAAC,CAAC;QACzF,CAAC;QACD,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACvB,QAAQ;QACR,WAAW,EAAE,EAAE,CAAC;IAClB,CAAC,CAAC;IAEF,uBAAuB;IACvB,MAAM,cAAc,GAAG,GAAkB,EAAE;QACzC,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QACtD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,GAAG,WAAW,GAAG,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAAC;YACxF,WAAW,GAAG,GAAG,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;QAC9E,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,MAAM,qBAAqB,GAAG,GAAS,EAAE;QACvC,IAAI,uBAAuB;YAAE,OAAO;QACpC,uBAAuB,GAAG,IAAI,CAAC;QAE/B,MAAM,IAAI,GAAG,KAAK,IAAI,EAAE;YACtB,OAAO,CAAC,SAAS,EAAE,CAAC;gBAClB,MAAM,cAAc,EAAE,CAAC;gBACvB,OAAO,YAAY,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;oBAC7C,MAAM,GAAG,GAAG,YAAY,CAAC,KAAK,EAAG,CAAC;oBAClC,IAAI,CAAC;wBACH,MAAM,oBAAoB,CAAC,GAAG,CAAC,CAAC;oBAClC,CAAC;oBAAC,OAAO,GAAG,EAAE,CAAC;wBACb,GAAG,EAAE,KAAK,CAAC,IAAI,WAAW,4BAA4B,GAAG,EAAE,CAAC,CAAC;oBAC/D,CAAC;gBACH,CAAC;YACH,CAAC;YACD,uBAAuB,GAAG,KAAK,CAAC;QAClC,CAAC,CAAC;QAEF,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YACnB,GAAG,EAAE,KAAK,CAAC,IAAI,WAAW,gCAAgC,GAAG,EAAE,CAAC,CAAC;YACjE,uBAAuB,GAAG,KAAK,CAAC;QAClC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,iBAAiB;IAEjB,MAAM,OAAO,GAAG,GAAG,EAAE;QACnB,SAAS,GAAG,IAAI,CAAC;QACjB,IAAI,oBAAoB,EAAE,CAAC;YACzB,aAAa,CAAC,oBAAoB,CAAC,CAAC;YACpC,oBAAoB,GAAG,IAAI,CAAC;QAC9B,CAAC;QACD,gBAAgB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACpC,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACzC,IAAI,aAAa,EAAE,CAAC;YAClB,aAAa,CAAC,kBAAkB,EAAE,CAAC;YACnC,aAAa,CAAC,UAAU,EAAE,CAAC;YAC3B,aAAa,GAAG,IAAI,CAAC;QACvB,CAAC;QACD,GAAG,EAAE,IAAI,CAAC,IAAI,WAAW,sBAAsB,CAAC,CAAC;IACnD,CAAC,CAAC;IAEF,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAE/C,yBAAyB;IAEzB,GAAG,EAAE,IAAI,CAAC,IAAI,WAAW,mBAAmB,MAAM,KAAK,CAAC,CAAC;IAEzD,MAAM,MAAM,GAAG,EAAE,CAAC,MAAM,EAAE;QACxB,IAAI,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,OAAO,CAAC,MAAM,EAAE,EAAE;QAC3E,IAAI,EAAE,cAAc;QACpB,QAAQ,EAAE,IAAI;QACd,YAAY,EAAE,IAAI;QAClB,oBAAoB,EAAE,QAAQ;QAC9B,iBAAiB,EAAE,IAAI;QACvB,oBAAoB,EAAE,KAAK;QAC3B,UAAU,EAAE,CAAC,WAAW,CAAC;KAC1B,CAAC,CAAC;IAEH,GAAG,EAAE,IAAI,CAAC,IAAI,WAAW,qBAAqB,IAAI,CAAC,SAAS,CAAC;QAC3D,IAAI,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,OAAO,CAAC,MAAM,EAAE,EAAE;QAC3E,IAAI,EAAE,cAAc;QACpB,QAAQ,EAAE,IAAI;QACd,YAAY,EAAE,IAAI;QAClB,oBAAoB,EAAE,QAAQ;QAC9B,iBAAiB,EAAE,IAAI;QACvB,oBAAoB,EAAE,KAAK;QAC3B,UAAU,EAAE,CAAC,WAAW,CAAC;KAC1B,CAAC,EAAE,CAAC,CAAC;IAEN,aAAa,GAAG,MAAM,CAAC;IAEvB,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;QACxB,GAAG,EAAE,IAAI,CAAC,IAAI,WAAW,mBAAmB,MAAM,CAAC,EAAE,iBAAiB,WAAW,GAAG,CAAC,CAAC;QACtF,cAAc,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QACvD,qBAAqB,EAAE,CAAC;QAExB,gCAAgC;QAChC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,oBAAoB,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QACtE,IAAI,IAAI,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,GAAG,EAAE,IAAI,CAAC,IAAI,WAAW,8CAA8C,IAAI,YAAY,MAAM,EAAE,CAAC,CAAC;QACnG,CAAC;QAED,8DAA8D;QAC9D,IAAI,oBAAoB;YAAE,aAAa,CAAC,oBAAoB,CAAC,CAAC;QAC9D,oBAAoB,GAAG,WAAW,CAAC,GAAG,EAAE;YACtC,IAAI,aAAa,EAAE,SAAS,EAAE,CAAC;gBAC7B,OAAO,EAAE,EAAE,CAAC;gBACZ,GAAG,EAAE,KAAK,EAAE,CAAC,IAAI,WAAW,yBAAyB,CAAC,CAAC;YACzD,CAAC;QACH,CAAC,EAAE,yBAAyB,CAAC,CAAC;QAE9B,OAAO,EAAE,EAAE,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,YAAY;IACZ,kBAAkB,CAAC,MAAM,EAAE;QACzB,OAAO;QACP,WAAW;QACX,GAAG;QACH,cAAc;QACd,OAAO;KACR,CAAC,CAAC;IAEH,MAAM,CAAC,EAAE,CAAC,eAAe,EAAE,CAAC,GAAG,EAAE,EAAE;QACjC,GAAG,EAAE,KAAK,CAAC,IAAI,WAAW,oBAAoB,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE;QACjC,GAAG,EAAE,IAAI,CAAC,IAAI,WAAW,mBAAmB,MAAM,EAAE,CAAC,CAAC;QACtD,wBAAwB;QACxB,IAAI,oBAAoB,EAAE,CAAC;YACzB,aAAa,CAAC,oBAAoB,CAAC,CAAC;YACpC,oBAAoB,GAAG,IAAI,CAAC;QAC9B,CAAC;QACD,0DAA0D;QAC1D,+CAA+C;QAC/C,YAAY,EAAE,EAAE,CAAC;QACjB,IAAI,MAAM,KAAK,sBAAsB,EAAE,CAAC;YACtC,iBAAiB;YACjB,GAAG,EAAE,IAAI,CAAC,IAAI,WAAW,4DAA4D,CAAC,CAAC;YACvF,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,kCAAkC;IAClC,wEAAwE;IACxE,iDAAiD;IACjD,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QACnC,WAAW,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE;YACzC,OAAO,EAAE,CAAC;YACV,GAAG,EAAE,IAAI,CAAC,IAAI,WAAW,mBAAmB,CAAC,CAAC;YAC9C,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/src/inbound.d.ts

@@ -0,0 +1,18 @@
+/**
+ * LightClaw — 入站消息处理
+ *
+ * 接收用户消息 → 文件处理 → 路由 → AI 分发 → 回复
+ */
+import type { GatewayContext, QueuedMessage, PrivateMessageData, FileAttachment } from "./types.js";
+/** emit / sendReply / sendFiles 等 socket 操作的抽象接口 */
+export interface SocketEmitter {
+    emit: (data: PrivateMessageData) => boolean;
+    sendReply: (targetId: string, text: string, replyToMsgId?: string) => boolean;
+    sendFiles: (targetId: string, text: string, files: FileAttachment[], replyToMsgId?: string) => boolean;
+    botClientId: string;
+}
+/**
+ * 创建入站消息处理器
+ */
+export declare function createInboundHandler(account: GatewayContext["account"], emitter: SocketEmitter, log?: GatewayContext["log"]): (msg: QueuedMessage) => Promise<void>;
+//# sourceMappingURL=inbound.d.ts.map

package/dist/src/inbound.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound.d.ts","sourceRoot":"","sources":["../../src/inbound.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,cAAc,EACf,MAAM,YAAY,CAAC;AAUpB,oDAAoD;AACpD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,CAAC,IAAI,EAAE,kBAAkB,KAAK,OAAO,CAAC;IAC5C,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IAC9E,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE,YAAY,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IACvG,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC,EAClC,OAAO,EAAE,aAAa,EACtB,GAAG,CAAC,EAAE,cAAc,CAAC,KAAK,CAAC,IAEb,KAAK,aAAa,KAAG,OAAO,CAAC,IAAI,CAAC,CAqPjD"}

package/dist/src/inbound.js

@@ -0,0 +1,252 @@
+/**
+ * LightClaw — 入站消息处理
+ *
+ * 接收用户消息 → 文件处理 → 路由 → AI 分发 → 回复
+ */
+import { getAssistantRuntime } from "./runtime.js";
+import { CHANNEL_KEY } from "./config.js";
+import { createReplyPrefixOptions } from "openclaw/plugin-sdk";
+import { generateMsgId } from "./dedup.js";
+import { parseDataUrl, formatFileSize, mediaUrlsToFiles } from "./media.js";
+const REPLY_TIMEOUT = 120_000;
+const MEDIA_MAX_BYTES = 50 * 1024 * 1024;
+/**
+ * 创建入站消息处理器
+ */
+export function createInboundHandler(account, emitter, log) {
+    return async (msg) => {
+        const pluginRuntime = getAssistantRuntime();
+        const currentCfg = pluginRuntime.config.loadConfig();
+        // 1. 确定地址和会话 Key
+        const fromAddress = `${CHANNEL_KEY}:dm:${msg.senderId}`;
+        // 2. 路由解析
+        const route = pluginRuntime.channel.routing.resolveAgentRoute({
+            cfg: currentCfg,
+            channel: CHANNEL_KEY,
+            accountId: account.accountId,
+            peer: { kind: "direct", id: msg.senderId },
+        });
+        // 3. 权限检查
+        const commandAuthorized = checkAuth(account.allowFrom, account.dmPolicy, msg.senderId);
+        // 4. 处理文件附件（files[] → 本地存储）
+        const localMediaPaths = [];
+        const localMediaTypes = [];
+        const ctxAttachments = [];
+        let attachmentDescription = "";
+        for (const file of msg.files) {
+            try {
+                const parsed = parseDataUrl(file.bytes);
+                if (!parsed) {
+                    log?.warn(`[${CHANNEL_KEY}] Invalid data URL for file: ${file.name}, skipping`);
+                    continue;
+                }
+                const saved = await pluginRuntime.channel.media.saveMediaBuffer(parsed.buffer, parsed.mimeType, "inbound", MEDIA_MAX_BYTES, file.name);
+                const savedMime = saved.contentType || parsed.mimeType;
+                localMediaPaths.push(saved.path);
+                localMediaTypes.push(savedMime);
+                ctxAttachments.push({
+                    name: file.name,
+                    mimeType: savedMime,
+                    url: `file://${saved.path}`,
+                });
+                attachmentDescription += `\n用户发送了文件: ${file.name} (${formatFileSize(saved.size)})`;
+                log?.info(`[${CHANNEL_KEY}] File saved: ${saved.path} (${savedMime}, ${formatFileSize(saved.size)})`);
+            }
+            catch (err) {
+                log?.error(`[${CHANNEL_KEY}] File processing failed for ${file.name}: ${err}`);
+            }
+        }
+        // 5. 构建消息体
+        const userText = msg.text + attachmentDescription;
+        const agentBody = account.systemPrompt
+            ? `${account.systemPrompt}\n\n${userText}`
+            : userText;
+        // 6. 构建入站上下文
+        const mediaFields = {};
+        if (localMediaPaths.length > 0) {
+            mediaFields.MediaPaths = localMediaPaths;
+            mediaFields.MediaPath = localMediaPaths[0];
+            mediaFields.MediaTypes = localMediaTypes;
+            mediaFields.MediaType = localMediaTypes[0];
+            mediaFields.MediaUrls = localMediaPaths.map((p) => `file://${p}`);
+            mediaFields.MediaUrl = `file://${localMediaPaths[0]}`;
+        }
+        const ctxPayload = pluginRuntime.channel.reply.finalizeInboundContext({
+            Body: userText,
+            BodyForAgent: agentBody,
+            RawBody: msg.text,
+            CommandBody: msg.text,
+            From: fromAddress,
+            To: `${CHANNEL_KEY}:${account.accountId}`,
+            Channel: CHANNEL_KEY,
+            ChatType: "direct",
+            SessionKey: route?.sessionKey ?? fromAddress,
+            AccountId: route?.accountId ?? account.accountId,
+            SenderId: msg.senderId,
+            SenderName: msg.senderId,
+            Provider: CHANNEL_KEY,
+            Surface: CHANNEL_KEY,
+            MessageSid: msg.messageId,
+            Timestamp: msg.timestamp,
+            OriginatingChannel: CHANNEL_KEY,
+            OriginatingTo: fromAddress,
+            CommandAuthorized: commandAuthorized,
+            OwnerAllowFrom: commandAuthorized ? [msg.senderId, fromAddress] : undefined,
+            AgentId: route?.agentId,
+            Attachments: ctxAttachments.length > 0 ? ctxAttachments : undefined,
+            ...mediaFields,
+        });
+        log?.info(`[${CHANNEL_KEY}] Inbound context: ${JSON.stringify(ctxPayload)}`);
+        const targetId = msg.senderId;
+        log?.info(`[${CHANNEL_KEY}] Processing: from=${msg.senderId} text="${(msg.text || "(仅文件)").slice(0, 60)}" files=${msg.files.length}`);
+        // 6.5 更新 session 的 last route，使 cron 定时任务能找到 lightclaw 的投递目标
+        const storePath = pluginRuntime.channel.session.resolveStorePath(route.agentId);
+        const deliveryCtx = {
+            channel: CHANNEL_KEY,
+            to: fromAddress,
+            accountId: route.accountId ?? account.accountId,
+        };
+        // 写入 per-channel-peer session
+        if (route?.sessionKey) {
+            pluginRuntime.channel.session.updateLastRoute({
+                storePath,
+                sessionKey: route.sessionKey,
+                deliveryContext: deliveryCtx,
+            }).catch((err) => {
+                log?.error(`[${CHANNEL_KEY}] Failed to update last route (session): ${err}`);
+            });
+        }
+        // 写入 main session（兜底）
+        if (route?.mainSessionKey && route.mainSessionKey !== route.sessionKey) {
+            pluginRuntime.channel.session.updateLastRoute({
+                storePath,
+                sessionKey: route.mainSessionKey,
+                deliveryContext: deliveryCtx,
+            }).catch((err) => {
+                log?.error(`[${CHANNEL_KEY}] Failed to update last route (main): ${err}`);
+            });
+        }
+        // 7. 创建 replyPrefixOptions
+        const { onModelSelected, ...prefixOptions } = createReplyPrefixOptions({
+            cfg: currentCfg,
+            agentId: route.agentId,
+            channel: CHANNEL_KEY,
+            accountId: account.accountId,
+        });
+        // 8. 分发给 AI 引擎
+        let hasResponse = false;
+        let idleSent = false;
+        let timeoutId = null;
+        const timeoutPromise = new Promise((_, reject) => {
+            timeoutId = setTimeout(() => {
+                if (!hasResponse)
+                    reject(new Error("AI reply timeout"));
+            }, REPLY_TIMEOUT);
+        });
+        // 同一条消息的流式回复（typing_start / stream_chunk / typing_stop）共用同一个 msgId
+        const replyMsgId = generateMsgId();
+        const dispatchPromise = pluginRuntime.channel.reply.dispatchReplyWithBufferedBlockDispatcher({
+            ctx: ctxPayload,
+            cfg: currentCfg,
+            dispatcherOptions: {
+                ...prefixOptions,
+                deliver: async (payload, info) => {
+                    hasResponse = true;
+                    log?.info(`[${CHANNEL_KEY}] Deliver: ${JSON.stringify(payload)}。info: ${JSON.stringify(info)}`);
+                    if (timeoutId) {
+                        clearTimeout(timeoutId);
+                        timeoutId = null;
+                    }
+                    const replyText = payload.text ?? payload.body ?? "";
+                    const mediaList = payload.mediaUrls?.length
+                        ? payload.mediaUrls
+                        : payload.mediaUrl ? [payload.mediaUrl] : [];
+                    // 流式中间块
+                    if (info.kind === "block") {
+                        if (replyText.trim()) {
+                            emitter.emit({
+                                msgId: replyMsgId,
+                                from: emitter.botClientId,
+                                to: targetId,
+                                content: replyText,
+                                timestamp: Date.now(),
+                                replyToMsgId: msg.messageId,
+                                kind: "stream_chunk",
+                            });
+                        }
+                        return;
+                    }
+                    if (!replyText && !mediaList.length)
+                        return;
+                    // 发送媒体文件
+                    if (mediaList.length > 0) {
+                        const files = await mediaUrlsToFiles(mediaList, log);
+                        if (files.length > 0) {
+                            emitter.sendFiles(targetId, replyText, files, msg.messageId);
+                            return;
+                        }
+                    }
+                    // 发送文本回复
+                    if (replyText.trim()) {
+                        emitter.sendReply(targetId, replyText, msg.messageId);
+                    }
+                },
+                onReplyStart: () => {
+                    emitter.emit({
+                        msgId: replyMsgId,
+                        from: emitter.botClientId,
+                        to: targetId,
+                        content: "",
+                        timestamp: Date.now(),
+                        kind: "typing_start",
+                    });
+                },
+                onIdle: () => {
+                    if (idleSent)
+                        return;
+                    idleSent = true;
+                    emitter.emit({
+                        msgId: replyMsgId,
+                        from: emitter.botClientId,
+                        to: targetId,
+                        content: "",
+                        timestamp: Date.now(),
+                        replyToMsgId: msg.messageId,
+                        kind: "typing_stop",
+                    });
+                },
+                onError: (err, info) => {
+                    log?.error(`[${CHANNEL_KEY}] ${info.kind} reply failed: ${String(err)}`);
+                },
+            },
+            replyOptions: { onModelSelected, disableBlockStreaming: false },
+        });
+        try {
+            await Promise.race([dispatchPromise, timeoutPromise]);
+        }
+        catch (err) {
+            const errMsg = err instanceof Error ? err.message : String(err);
+            log?.error(`[${CHANNEL_KEY}] Dispatch error: ${errMsg}`);
+            emitter.sendReply(targetId, `抱歉，处理您的消息时出现了问题: ${errMsg}`, msg.messageId);
+        }
+        finally {
+            if (timeoutId) {
+                clearTimeout(timeoutId);
+                timeoutId = null;
+            }
+        }
+    };
+}
+// ============================================================
+// 权限检查
+// ============================================================
+function checkAuth(allowFrom, dmPolicy, senderId) {
+    if (dmPolicy === "disabled")
+        return false;
+    if (dmPolicy === "open")
+        return true;
+    if (!allowFrom || allowFrom.length === 0)
+        return false;
+    return allowFrom.includes("*") || allowFrom.some((id) => id.toLowerCase() === senderId.toLowerCase());
+}
+//# sourceMappingURL=inbound.js.map

package/dist/src/inbound.js.map

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

package/dist/src/media.d.ts

@@ -0,0 +1,12 @@
+/**
+ * LightClaw — 媒体文件处理工具
+ */
+import type { FileAttachment, GatewayContext } from "./types.js";
+export declare function parseDataUrl(dataUrl: string): {
+    buffer: Buffer;
+    mimeType: string;
+} | null;
+export declare function formatFileSize(bytes: number): string;
+export declare function guessMimeByExt(ext: string): string;
+export declare function mediaUrlsToFiles(urls: string[], log?: GatewayContext["log"]): Promise<FileAttachment[]>;
+//# sourceMappingURL=media.d.ts.map

package/dist/src/media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.d.ts","sourceRoot":"","sources":["../../src/media.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAMjE,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAIzF;AAMD,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKpD;AAMD,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CASlD;AAMD,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,CAAC,EAAE,cAAc,CAAC,KAAK,CAAC,GAC1B,OAAO,CAAC,cAAc,EAAE,CAAC,CAyC3B"}