lightclaw2 0.0.1

package/dist/src/socket-handlers.js

@@ -0,0 +1,120 @@
+/**
+ * LightClaw — Socket.IO 事件处理器
+ *
+ * 将 socket 事件监听（message:private、history:request、sessions:request）
+ * 从 gateway 主逻辑中解耦。
+ */
+import { CHANNEL_KEY } from "./config.js";
+import { isDuplicate, isHistoryRequestThrottled, generateMsgId } from "./dedup.js";
+import { getAssistantRuntime } from "./runtime.js";
+import { readSessionHistoryTail, listSessions } from "./session-history.js";
+/**
+ * 绑定所有 Socket.IO 事件监听器
+ */
+export function bindSocketHandlers(socket, deps) {
+    const { account, botClientId, log, enqueueMessage, onEvent } = deps;
+    // ---- 接收用户消息 ----
+    socket.on("message:private", (data) => {
+        // 回环防御：过滤自身发出的消息
+        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("message:history:request", (data) => {
+        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;
+        }
+        // 节流：同一用户在短时间内只处理一次 history 请求
+        if (isHistoryRequestThrottled(data.from)) {
+            log?.warn(`[${CHANNEL_KEY}] Throttled history request from ${data.from}, ignoring`);
+            return;
+        }
+        // 通知框架收到入站事件（更新 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 = readSessionHistoryTail(sessionKey, {
+                limit: data.limit ?? 100,
+                chatOnly: data.chatOnly ?? true,
+            });
+            log?.info(`[${CHANNEL_KEY}] History request: userId=${data.from} sessionKey=${sessionKey} found=${messages.length}。messages:${JSON.stringify(messages)}`);
+            socket.emit("message:history:response", {
+                msgId: generateMsgId(),
+                from: botClientId,
+                to: data.from,
+                sessionKey,
+                messages: messages.filter(msg => !!msg.content.trim()),
+            });
+        }
+        catch (err) {
+            log?.error(`[${CHANNEL_KEY}] History request error: ${err}`);
+            socket.emit("message:history:response", {
+                msgId: generateMsgId(),
+                from: botClientId,
+                to: data.from,
+                sessionKey: "",
+                messages: [],
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    });
+    // ---- 会话列表请求 ----
+    socket.on("sessions:request", (data) => {
+        // 通知框架收到入站事件（更新 lastEventAt，防止 stale-socket 误判）
+        onEvent?.();
+        try {
+            const sessions = listSessions();
+            socket.emit("sessions:response", {
+                requestId: data.requestId,
+                sessions,
+            });
+        }
+        catch (err) {
+            log?.error(`[${CHANNEL_KEY}] Sessions list error: ${err}`);
+            socket.emit("sessions:response", {
+                requestId: data.requestId,
+                sessions: [],
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    });
+}
+//# sourceMappingURL=socket-handlers.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"socket-handlers.js","sourceRoot":"","sources":["../../src/socket-handlers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,yBAAyB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACnF,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,YAAY,EAAuB,MAAM,sBAAsB,CAAC;AAWjG;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAc,EAAE,IAAuB;IACxE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,cAAc,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAEpE,mBAAmB;IACnB,MAAM,CAAC,EAAE,CAAC,iBAAiB,EAAE,CAAC,IAAwB,EAAE,EAAE;QACxD,iBAAiB;QACjB,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW;YAAE,OAAO;QAEtC,uCAAuC;QACvC,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM;YAAE,OAAO;QAE9C,QAAQ;QACR,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC;QACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;QACrD,IAAI,CAAC,UAAU,IAAI,CAAC,QAAQ;YAAE,OAAO;QAErC,KAAK;QACL,IAAI,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,OAAO;QAEpC,gDAAgD;QAChD,OAAO,EAAE,EAAE,CAAC;QAEZ,GAAG,EAAE,IAAI,CAAC,IAAI,WAAW,kBAAkB,IAAI,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,IAAI,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC,EAAE,CAAC,CAAC;QAEjI,cAAc,CAAC;YACb,QAAQ,EAAE,IAAI,CAAC,IAAI;YACnB,IAAI,EAAE,IAAI,CAAC,OAAO,IAAI,EAAE;YACxB,SAAS,EAAE,IAAI,CAAC,KAAK;YACrB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE;YACvB,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,mBAAmB;IACnB,MAAM,CAAC,EAAE,CAAC,yBAAyB,EAAE,CAAC,IAKrC,EAAE,EAAE;QACH,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;YAChB,GAAG,EAAE,IAAI,CAAC,IAAI,WAAW,4CAA4C,CAAC,CAAC;YACvE,OAAO;QACT,CAAC;QAED,sBAAsB;QACtB,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW;YAAE,OAAO;QAEtC,sBAAsB;QACtB,IAAI,IAAI,CAAC,KAAK,IAAI,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1C,GAAG,EAAE,IAAI,CAAC,IAAI,WAAW,+CAA+C,CAAC,CAAC;YAC1E,OAAO;QACT,CAAC;QAED,+BAA+B;QAC/B,IAAI,yBAAyB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACzC,GAAG,EAAE,IAAI,CAAC,IAAI,WAAW,oCAAoC,IAAI,CAAC,IAAI,YAAY,CAAC,CAAC;YACpF,OAAO;QACT,CAAC;QAED,gDAAgD;QAChD,OAAO,EAAE,EAAE,CAAC;QAEZ,IAAI,CAAC;YACH,MAAM,aAAa,GAAG,mBAAmB,EAAE,CAAC;YAC5C,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;YAErD,MAAM,KAAK,GAAG,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC;gBAC5D,GAAG,EAAE,UAAU;gBACf,OAAO,EAAE,WAAW;gBACpB,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,CAAC,IAAI,EAAE;aACxC,CAAC,CAAC;YAEH,MAAM,UAAU,GAAG,KAAK,EAAE,UAAU,IAAI,GAAG,WAAW,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;YACzE,MAAM,QAAQ,GAAG,sBAAsB,CAAC,UAAU,EAAE;gBAClD,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,GAAG;gBACxB,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,IAAI;aAChC,CAAC,CAAC;YAEH,GAAG,EAAE,IAAI,CAAC,IAAI,WAAW,6BAA6B,IAAI,CAAC,IAAI,eAAe,UAAU,UAAU,QAAQ,CAAC,MAAM,aAAa,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YAE1J,MAAM,CAAC,IAAI,CAAC,0BAA0B,EAAE;gBACtC,KAAK,EAAE,aAAa,EAAE;gBACtB,IAAI,EAAE,WAAW;gBACjB,EAAE,EAAE,IAAI,CAAC,IAAI;gBACb,UAAU;gBACV,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;aACvD,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,GAAG,EAAE,KAAK,CAAC,IAAI,WAAW,4BAA4B,GAAG,EAAE,CAAC,CAAC;YAC7D,MAAM,CAAC,IAAI,CAAC,0BAA0B,EAAE;gBACtC,KAAK,EAAE,aAAa,EAAE;gBACtB,IAAI,EAAE,WAAW;gBACjB,EAAE,EAAE,IAAI,CAAC,IAAI;gBACb,UAAU,EAAE,EAAE;gBACd,QAAQ,EAAE,EAAsB;gBAChC,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aACxD,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,mBAAmB;IACnB,MAAM,CAAC,EAAE,CAAC,kBAAkB,EAAE,CAAC,IAA4B,EAAE,EAAE;QAC7D,gDAAgD;QAChD,OAAO,EAAE,EAAE,CAAC;QAEZ,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,YAAY,EAAE,CAAC;YAChC,MAAM,CAAC,IAAI,CAAC,mBAAmB,EAAE;gBAC/B,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,QAAQ;aACT,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,GAAG,EAAE,KAAK,CAAC,IAAI,WAAW,0BAA0B,GAAG,EAAE,CAAC,CAAC;YAC3D,MAAM,CAAC,IAAI,CAAC,mBAAmB,EAAE;gBAC/B,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,QAAQ,EAAE,EAAE;gBACZ,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aACxD,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,53 @@
+/**
+ * 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";
+interface SocketEntry {
+    socket: Socket;
+    botClientId: string;
+    /** 断线期间缓冲的待发消息 */
+    pendingMessages: PrivateMessageData[];
+}
+/** 注册 socket（gateway 首次连接时调用） */
+export declare function registerSocket(accountId: string, socket: Socket, botClientId: string): 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;
+/**
+ * 缓冲一条消息（socket 断开期间由 outbound 调用）。
+ * 返回 true 表示成功缓冲，false 表示该 account 没有注册的 entry。
+ */
+export declare function bufferMessage(accountId: string, message: PrivateMessageData): boolean;
+/**
+ * flush 所有缓冲消息（重连成功后由 gateway 调用）。
+ * 返回发送成功 / 失败的计数。
+ */
+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=socket-registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"socket-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,YAAY,CAAC;AAarD,UAAU,WAAW;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB;IAClB,eAAe,EAAE,kBAAkB,EAAE,CAAC;CACvC;AASD,iCAAiC;AACjC,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAS3F;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;AAMD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAUrF;AAED;;;GAGG;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,CA8BlC;AAED,uBAAuB;AACvB,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEzD"}

package/dist/src/socket-registry.js

@@ -0,0 +1,115 @@
+/**
+ * LightClaw — Socket 注册表
+ *
+ * 让 gateway 启动时注册 socket 实例，
+ * outbound 在需要发送消息时可以通过 WS 连接直接发送，
+ * 无需走 REST API。
+ *
+ * 断线缓冲：
+ *   当 socket 暂时断开（Socket.IO 自动重连中）时，outbound 消息
+ *   会被缓冲在 pendingMessages 队列中，重连后自动 flush 发送。
+ *   仅在 gateway 彻底销毁（cleanup）时才删除 entry。
+ */
+// ============================================================
+// 常量
+// ============================================================
+/** 每个 account 最大缓冲消息数 */
+const MAX_PENDING_MESSAGES = 200;
+/** accountId → SocketEntry */
+const registry = new Map();
+// ============================================================
+// 注册 / 注销
+// ============================================================
+/** 注册 socket（gateway 首次连接时调用） */
+export function registerSocket(accountId, socket, botClientId) {
+    const existing = registry.get(accountId);
+    if (existing) {
+        // 重连场景：更新 socket 引用，保留 pending 队列
+        existing.socket = socket;
+        existing.botClientId = botClientId;
+    }
+    else {
+        registry.set(accountId, { socket, botClientId, pendingMessages: [] });
+    }
+}
+/**
+ * 注销 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;
+}
+// ============================================================
+// 断线缓冲
+// ============================================================
+/**
+ * 缓冲一条消息（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 调用）。
+ * 返回发送成功 / 失败的计数。
+ */
+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;
+        }
+        try {
+            entry.socket.emit("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=socket-registry.js.map

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

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

package/dist/src/types.d.ts

@@ -0,0 +1,100 @@
+/**
+ * LightClaw OpenClaw Channel Plugin — 类型定义
+ *
+ * 用户实际消息格式：
+ *   { msgId, from, to, content, files, timestamp }
+ *
+ * files 格式为 FileAttachment[]，每个文件包含 name, mimeType, bytes(data URL)。
+ */
+/** 用户上传的文件（files[] 数组中的元素） */
+export interface FileAttachment {
+    /** 文件名 */
+    name: string;
+    /** MIME 类型 */
+    mimeType: string;
+    /** base64 data URL（如 "data:text/plain;base64,..."） */
+    bytes: string;
+}
+/**
+ * message:private 事件的 data 结构
+ *
+ * 入站（用户 → 插件）：{ msgId, from, to, content, files, timestamp }
+ * 出站（插件 → 用户）：同结构，可附带 kind 用于流式/typing 控制
+ */
+export interface PrivateMessageData {
+    /** 消息唯一 ID */
+    msgId: string;
+    /** 发送者 ID */
+    from: string;
+    /** 接收者 ID */
+    to: string;
+    /** 消息文本内容（仅发送文件时可为空字符串） */
+    content: string;
+    /** 消息时间戳（ms） */
+    timestamp: number;
+    /** 文件列表（{name, mimeType, bytes} 格式，bytes 为 data URL） */
+    files?: FileAttachment[];
+    /** 消息子类型：流式/typing 控制（出站使用） */
+    kind?: "text" | "stream_chunk" | "stream_end" | "typing_start" | "typing_stop";
+    /** 回复对应的原始消息 ID */
+    replyToMsgId?: string;
+}
+/** 原始配置（config.yaml 中的内容） */
+export interface AssistantAccountConfig {
+    /** API Key / Token */
+    apiKey?: string;
+    /** REST API 基础地址（用于 outbound 主动发送） */
+    apiBaseUrl?: string;
+    /** 是否启用 */
+    enabled?: boolean;
+    /** 账户名称 */
+    name?: string;
+    /** DM 策略 */
+    dmPolicy?: "open" | "allowlist" | "disabled";
+    /** 允许的用户 ID 列表（* 表示所有人） */
+    allowFrom?: string[];
+    /** 自定义系统提示词 */
+    systemPrompt?: string;
+}
+/** 解析后的完整账户（含默认值和环境变量 fallback） */
+export interface ResolvedAssistantAccount {
+    accountId: string;
+    apiKey: string;
+    apiBaseUrl: string;
+    enabled: boolean;
+    name?: string;
+    dmPolicy: "open" | "allowlist" | "disabled";
+    allowFrom: string[];
+    systemPrompt?: string;
+    secretSource: "config" | "env" | "none";
+}
+export interface GatewayContext {
+    account: ResolvedAssistantAccount;
+    abortSignal: AbortSignal;
+    cfg: unknown;
+    onReady?: () => void;
+    onDisconnect?: () => void;
+    onError?: (error: Error) => void;
+    /** 收到任何入站事件时调用，用于通知框架更新 lastEventAt，防止 health-monitor 误判 stale-socket */
+    onEvent?: () => void;
+    log?: {
+        info: (msg: string) => void;
+        warn: (msg: string) => void;
+        error: (msg: string) => void;
+        debug?: (msg: string) => void;
+    };
+}
+/** 消息队列项 — 直接使用用户的 files[] 格式 */
+export interface QueuedMessage {
+    /** 发送者 ID */
+    senderId: string;
+    /** 消息文本 */
+    text: string;
+    /** 消息 ID */
+    messageId: string;
+    /** 文件附件（{name, mimeType, bytes} 格式） */
+    files: FileAttachment[];
+    /** 时间戳 */
+    timestamp: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/src/types.js

@@ -0,0 +1,10 @@
+/**
+ * LightClaw OpenClaw Channel Plugin — 类型定义
+ *
+ * 用户实际消息格式：
+ *   { msgId, from, to, content, files, timestamp }
+ *
+ * files 格式为 FileAttachment[]，每个文件包含 name, mimeType, bytes(data URL)。
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/node_modules/@socket.io/component-emitter/LICENSE

@@ -0,0 +1,24 @@
+(The MIT License)
+
+Copyright (c) 2014 Component contributors <dev@component.io>
+
+Permission is hereby granted, free of charge, to any person
+obtaining a copy of this software and associated documentation
+files (the "Software"), to deal in the Software without
+restriction, including without limitation the rights to use,
+copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following
+conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.

package/node_modules/@socket.io/component-emitter/Readme.md

@@ -0,0 +1,79 @@
+# `@socket.io/component-emitter`
+
+  Event emitter component.
+
+This project is a fork of the [`component-emitter`](https://github.com/sindresorhus/component-emitter) project, with [Socket.IO](https://socket.io/)-specific TypeScript typings.
+
+## Installation
+
+```
+$ npm i @socket.io/component-emitter
+```
+
+## API
+
+### Emitter(obj)
+
+  The `Emitter` may also be used as a mixin. For example
+  a "plain" object may become an emitter, or you may
+  extend an existing prototype.
+
+  As an `Emitter` instance:
+
+```js
+import { Emitter } from '@socket.io/component-emitter';
+
+var emitter = new Emitter;
+emitter.emit('something');
+```
+
+  As a mixin:
+
+```js
+import { Emitter } from '@socket.io/component-emitter';
+
+var user = { name: 'tobi' };
+Emitter(user);
+
+user.emit('im a user');
+```
+
+  As a prototype mixin:
+
+```js
+import { Emitter } from '@socket.io/component-emitter';
+
+Emitter(User.prototype);
+```
+
+### Emitter#on(event, fn)
+
+  Register an `event` handler `fn`.
+
+### Emitter#once(event, fn)
+
+  Register a single-shot `event` handler `fn`,
+  removed immediately after it is invoked the
+  first time.
+
+### Emitter#off(event, fn)
+
+  * Pass `event` and `fn` to remove a listener.
+  * Pass `event` to remove all listeners on that event.
+  * Pass nothing to remove all listeners on all events.
+
+### Emitter#emit(event, ...)
+
+  Emit an `event` with variable option args.
+
+### Emitter#listeners(event)
+
+  Return an array of callbacks, or an empty array.
+
+### Emitter#hasListeners(event)
+
+  Check if this emitter has `event` handlers.
+
+## License
+
+MIT