lightclawbot 1.2.0-beta.3 → 1.2.5

package/dist/src/utils/common.js

@@ -1,4 +1,7 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
 import { X_PRODUCT } from '../config.js';
+import { resolveOpenClawHome } from '../history/session-store.js';
 /**
  * 将长文本按指定长度拆分为多个文本块。
  *
@@ -53,7 +56,7 @@ export function buildAuthHeaders(apiKey) {
  * - extra 用于透传 kind 相关字段（如 tool_start 的 toolName/toolPhase、tool_end 的 toolIsError）。
  */
 export function emitSignal(ctx, kind, content = '', extra) {
-    const { emitter, targetId, replyMsgId, originalMsgId, agentId } = ctx;
+    const { emitter, targetId, replyMsgId, originalMsgId, agentId, chatId } = ctx;
     return emitter.emit({
         msgId: replyMsgId,
         from: emitter.botClientId,
@@ -64,5 +67,154 @@ export function emitSignal(ctx, kind, content = '', extra) {
         ...(kind !== 'typing_start' ? { replyToMsgId: originalMsgId } : {}),
         ...extra,
         agentId,
+        extra: { chatId: chatId ?? '' },
     });
 }
+/**
+ * 构建 chats.json 的绝对路径：
+ * `~/.openclaw/agents/<agentId>/chats/<userId>/chats.json`
+ */
+export function resolveChatsFilePath(agentId, userId) {
+    const home = resolveOpenClawHome();
+    return path.join(home, 'agents', agentId, 'chats', userId, 'chats.json');
+}
+/**
+ * 读取 chats.json 并返回 chats 列表（**纯只读**，无任何文件落盘副作用）。
+ *
+ * - 文件不存在 → 返回空数组
+ * - JSON 解析失败或结构不合法 → 返回空数组
+ * - 合法记录按 `updatedAt` 倒序排序，未提供则按 `createdAt` 兜底
+ *
+ */
+export function readChatsFile(filePath) {
+    if (!fs.existsSync(filePath))
+        return [];
+    const raw = fs.readFileSync(filePath, 'utf-8');
+    if (!raw.trim())
+        return [];
+    const parsed = JSON.parse(raw);
+    if (!parsed || !Array.isArray(parsed.chats))
+        return [];
+    // 过滤出字段合法的记录
+    const valid = parsed.chats.filter((c) => !!c &&
+        typeof c.chatId === 'string' &&
+        typeof c.title === 'string' &&
+        typeof c.createdAt === 'number' &&
+        typeof c.updatedAt === 'number');
+    // 按 updatedAt 倒序，便于前端直接渲染
+    return valid.sort((a, b) => (b.updatedAt ?? b.createdAt) - (a.updatedAt ?? a.createdAt));
+}
+/**
+ * 读取 chats.json；若文件不存在则**兜底创建一条 chatId='' 的默认对话**并落盘。
+ *
+ * 与 {@link readChatsFile} 的差异：本函数有写盘副作用，专供"必须保证存在默认对话
+ * 兜底条目"的调用方（典型场景：sessionId 登记入口 ensureSessionInHistory）。
+ *
+ * 拆分原因：原 readChatsFile 兼任只读与兜底创建两种语义，导致 history:request 等
+ * 纯查询路径在用户尚未发任何消息前就把 chats.json 写到磁盘上，违反单一职责。
+ *
+ * 行为：
+ *   - 文件不存在 → 落盘 [{ chatId: '', title: '默认会话', ... }] 并返回；
+ *   - 文件存在但解析失败 / 结构不合法 → 沿用 readChatsFile 的容错（返回 []，不创建）；
+ *   - 文件存在但内容合法 → 等价于 readChatsFile。
+ */
+export function readChatsFileOrInitDefault(filePath) {
+    if (!fs.existsSync(filePath)) {
+        const now = Date.now();
+        const defaultChat = {
+            chatId: '',
+            title: '默认会话',
+            createdAt: now,
+            updatedAt: now,
+            titleLocked: false,
+            pinned: false,
+            sessionIdHistory: [],
+        };
+        writeChatsFile(filePath, [defaultChat]);
+        return [defaultChat];
+    }
+    return readChatsFile(filePath);
+}
+/**
+ * 将 chats 列表原子写入 `chats.json`。
+ *
+ * 写入策略：
+ *   1. 目录不存在时逐级创建（recursive: true）
+ *   2. 先写入同目录下的 `.tmp` 文件，再 rename 覆盖目标，
+ *      避免写入过程中进程崩溃导致 json 文件损坏
+ *   3. schema 固定 `version: 1`，为未来平滑升级预留字段
+ *
+ * @param filePath 目标 chats.json 绝对路径
+ * @param chats    完整的 ChatMeta 列表（调用方自行保证顺序与合法性）
+ */
+export function writeChatsFile(filePath, chats) {
+    const dir = path.dirname(filePath);
+    fs.mkdirSync(dir, { recursive: true });
+    const payload = { version: 1, chats };
+    const tmpPath = `${filePath}.tmp`;
+    fs.writeFileSync(tmpPath, JSON.stringify(payload, null, 2), 'utf-8');
+    fs.renameSync(tmpPath, filePath);
+}
+/**
+ * 把当前生效的 sessionId 幂等地登记到 `chats.json` 中对应 chatId 的 `sessionIdHistory` 数组。
+ *
+ * 语义说明：
+ *   - sessionIdHistory 记录该 chat 见过的所有 sessionId（含当前在用），按时间序末尾追加；
+ *   - 同一 sessionId 若已存在则跳过（幂等，不会重复 push）；
+ *   - 列表最后一项 ≈ 该 chat 当前在用的 sessionId（前提是调用方在每次消息进入时都调用本函数）。
+ *
+ * 关于 chatId 为空（''）的处理：
+ *   - 空 chatId 是**合法**的"默认对话"会话标识——`readChatsFile` 在 chats.json
+ *     不存在时会主动写入一条 `chatId: ''` 的兜底记录；
+ *   - 因此本函数对空 chatId 同样登记，目标条目就是 `chatId === ''` 那一条；
+ *   - 若 chats.json 文件不存在 → 通过 readChatsFile 自动创建兜底记录；
+ *   - 若 chats.json 已存在但缺失目标 chatId 条目 → 跳过登记并告警（避免污染他人数据）。
+ *
+ * 容错策略：
+ *   - chatId 为 undefined/null → 跳过；空字符串 '' 视为合法（默认会话）；
+ *   - sessionId 为空 → 跳过；
+ *   - 任意 IO/解析异常 → 静默吞错 + 日志，绝不抛出影响主流程。
+ *
+ * @param agentId   - Agent ID（chats/<agentId> 目录段）
+ * @param userId    - 用户 ID（chats/<agentId>/chats/<userId> 目录段）
+ * @param chatId    - 会话 ID（ChatMeta.chatId）；undefined/null 时跳过；空字符串视为默认会话
+ * @param sessionId - 当前生效的 sessionId（来自 sessions.json 索引）；为空时直接 return
+ * @returns 是否实际写盘（true=本次新增了一个 sessionId；false=跳过 / 已存在 / 出错）
+ */
+export function ensureSessionInHistory(agentId, userId, chatId, sessionId) {
+    // chatId 必须是 string（含空字符串 '' —— 默认会话的合法标识）；undefined/null 跳过
+    if (typeof chatId !== 'string')
+        return false;
+    if (!sessionId || !sessionId.trim())
+        return false;
+    const chatsPath = resolveChatsFilePath(agentId, userId);
+    try {
+        // 登记入口需要兜底：默认对话首次消息时 chats.json 尚不存在，
+        // 走 readChatsFileOrInitDefault 让其落盘一条 chatId='' 的默认对话，
+        // 然后正常走"查找+追加"流程。
+        const chats = readChatsFileOrInitDefault(chatsPath);
+        const idx = chats.findIndex((c) => c.chatId === chatId);
+        if (idx < 0) {
+            return false;
+        }
+        const target = chats[idx];
+        const history = Array.isArray(target.sessionIdHistory) ? target.sessionIdHistory : [];
+        if (history.includes(sessionId)) {
+            // 已存在，幂等跳过，不写盘
+            return false;
+        }
+        // 末尾追加，写回。
+        // 把默认对话/具名对话无端"置顶"，扰乱前端按 updatedAt 倒序的列表排序。
+        const updated = {
+            ...target,
+            sessionIdHistory: [...history, sessionId],
+        };
+        const nextChats = [...chats];
+        nextChats[idx] = updated;
+        writeChatsFile(chatsPath, nextChats);
+        return true;
+    }
+    catch (err) {
+        return false;
+    }
+}

package/node_modules/ws/lib/sender.js

@@ -4,6 +4,9 @@
 
 const { Duplex } = require('stream');
 const { randomFillSync } = require('crypto');
+const {
+  types: { isUint8Array }
+} = require('util');
 
 const PerMessageDeflate = require('./permessage-deflate');
 const { EMPTY_BUFFER, kWebSocket, NOOP } = require('./constants');
@@ -200,8 +203,10 @@ class Sender {
 
       if (typeof data === 'string') {
         buf.write(data, 2);
-      } else {
+      } else if (isUint8Array(data)) {
         buf.set(data, 2);
+      } else {
+        throw new TypeError('Second argument must be a string or a Uint8Array');
       }
     }
 

package/node_modules/ws/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ws",
-  "version": "8.20.0",
+  "version": "8.20.1",
   "description": "Simple to use, blazing fast and thoroughly tested websocket client and server for Node.js",
   "keywords": [
     "HyBi",

package/openclaw.plugin.json

@@ -1,10 +1,84 @@
 {
   "id": "lightclawbot",
-  "channels": ["lightclawbot"],
-  "skills": ["./skills"],
+  "name": "LightClawBot",
+  "description": "Connect OpenClaw to your LightClawBot via WebSocket long-connection",
+  "kind": "channel",
+  "channels": [
+    "lightclawbot"
+  ],
+  "skills": [
+    "./skills"
+  ],
   "configSchema": {
     "type": "object",
     "additionalProperties": false,
     "properties": {}
+  },
+  "channelConfigs": {
+    "lightclawbot": {
+      "label": "LightClawBot",
+      "description": "Connect OpenClaw to your LightClawBot via WebSocket long-connection",
+      "schema": {
+        "$schema": "http://json-schema.org/draft-07/schema#",
+        "type": "object",
+        "additionalProperties": true,
+        "properties": {
+          "enabled": {
+            "type": "boolean",
+            "description": "Whether this channel is enabled."
+          },
+          "name": {
+            "type": "string",
+            "description": "Human-readable account/channel name."
+          },
+          "dmPolicy": {
+            "type": "string",
+            "enum": ["open", "allowlist", "disabled"],
+            "description": "Policy that controls who can DM the bot."
+          },
+          "allowFrom": {
+            "type": "array",
+            "items": { "type": "string" },
+            "description": "Allowlist of user IDs ('*' means everyone)."
+          },
+          "systemPrompt": {
+            "type": "string",
+            "description": "Custom system prompt applied to this account."
+          },
+          "defaultAccount": {
+            "type": "string",
+            "description": "Default account id to use when none is specified."
+          },
+          "accounts": {
+            "type": "object",
+            "description": "Per-account configuration keyed by account id (typically the uin).",
+            "additionalProperties": {
+              "type": "object",
+              "additionalProperties": false,
+              "properties": {
+                "enabled": { "type": "boolean" },
+                "name": { "type": "string" },
+                "apiKey": { "type": "string" },
+                "apiBaseUrl": { "type": "string" },
+                "dmPolicy": {
+                  "type": "string",
+                  "enum": ["open", "allowlist", "disabled"]
+                },
+                "allowFrom": {
+                  "type": "array",
+                  "items": { "type": "string" }
+                },
+                "systemPrompt": { "type": "string" }
+              }
+            }
+          }
+        }
+      }
+    }
+  },
+  "contracts": {
+    "tools": [
+      "lightclaw_upload_file"
+    ]
   }
-}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lightclawbot",
-  "version": "1.2.0-beta.3",
+  "version": "1.2.5",
   "description": "LightClawBot channel plugin with message support, cron jobs, and proactive messaging",
   "type": "module",
   "files": [