openclaw-openagent 1.0.0 → 1.0.2

package/dist/src/sdk/node-env/http-request.js

@@ -0,0 +1,90 @@
+/**
+ * node-env/http-request.js
+ *
+ * 替代 XMLHttpRequest，用 Node.js 内置 fetch() 实现。
+ * SDK 中两处使用 XMLHttpRequest：
+ *   1. Io 函数（网络诊断 getconninfo）— index.js L15844
+ *   2. ErrMsgModule._fetchErrCode（错误码表拉取）— index.js L21296
+ *
+ * 本模块导出两个函数，分别对应这两种用法。
+ */
+
+/**
+ * 替代 Io 函数中的 XMLHttpRequest 用法。
+ * 功能：发送 HTTP 请求，3秒超时，返回 Promise。
+ *
+ * @param {string} method - HTTP 方法 (GET/POST)
+ * @param {string} url - 请求 URL
+ * @param {string} [body] - 请求体（POST 时）
+ * @param {Function} resolve - Promise resolve
+ * @param {Function} reject - Promise reject
+ * @param {Function} createError - 创建 SDK 错误对象的工厂函数 (code) => Error
+ * @param {object} errorCodes - { NETWORK_ERROR, NETWORK_TIMEOUT }
+ * @param {object} logger - SDK 日志对象 { l, w, e }
+ */
+export function httpDiagnose(method, url, body, resolve, reject, createError, errorCodes, logger) {
+  const controller = new AbortController();
+  const timer = setTimeout(() => {
+    controller.abort();
+    reject(createError(errorCodes.NETWORK_TIMEOUT));
+  }, 3000);
+
+  fetch(url, {
+    method,
+    headers: { "Content-type": "application/x-www-form-urlencoded;charset=UTF-8" },
+    body: body || undefined,
+    signal: controller.signal,
+  })
+    .then((res) => {
+      clearTimeout(timer);
+      if (res.ok || res.status === 304) {
+        return res.text().then((text) => {
+          if (text && text.indexOf("NetCheckInfo") > -1) {
+            logger.l("getconninfo ok in node. ret:", JSON.parse(text));
+          }
+          resolve();
+        });
+      }
+      reject(createError(errorCodes.NETWORK_ERROR));
+    })
+    .catch(() => {
+      clearTimeout(timer);
+      reject(createError(errorCodes.NETWORK_TIMEOUT));
+    });
+}
+
+/**
+ * 替代 ErrMsgModule._fetchErrCode 中的 XMLHttpRequest 用法。
+ * 功能：GET 请求拉取错误码 JSON，3秒超时。
+ *
+ * @param {string} url - 错误码表 URL
+ * @param {string} contentType - Content-Type header
+ * @param {Function} resolve - Promise resolve，传入响应文本
+ * @param {Function} reject - Promise reject
+ * @param {object} logger - SDK 日志对象
+ */
+export function httpFetchText(url, contentType, resolve, reject, logger) {
+  const controller = new AbortController();
+  const timer = setTimeout(() => {
+    controller.abort();
+  }, 3000);
+
+  fetch(url, {
+    method: "GET",
+    headers: { "Content-type": contentType },
+    signal: controller.signal,
+  })
+    .then((res) => {
+      clearTimeout(timer);
+      if (res.ok || res.status === 304) {
+        return res.text().then((text) => {
+          resolve(text);
+        });
+      }
+      reject(res.status);
+    })
+    .catch((err) => {
+      clearTimeout(timer);
+      reject(err);
+    });
+}

package/dist/src/sdk/node-env/index.js

@@ -0,0 +1,57 @@
+/**
+ * node-env/index.js
+ *
+ * SDK 的 Node.js 环境适配层。
+ * 在 import SDK 之前先 import 此文件，自动注入浏览器 API 的 Node.js 替代实现。
+ *
+ * 使用方式：
+ *   import './node-env/index.js';   // 必须在 SDK import 之前
+ *   import SDK from './index.js';   // SDK 正常使用
+ *
+ * 提供的替代能力：
+ *   - localStorage → 内存 Map（支持 for...in 遍历）
+ *   - navigator.cookieEnabled → true
+ *   - httpDiagnose / httpFetchText → 通过 SDK 源码内引用
+ *
+ * 不在这里处理的（需要改 SDK 源码）：
+ *   - XMLHttpRequest → 在 index.js 中直接引用 http-request.js
+ *   - unhandled rejection → 在 index.js send() 方法中加 .catch
+ *   - OPENAGENT logger → 已有 globalThis.__OPENAGENT_SDK_LOGGER 机制
+ */
+
+import WS from "ws";
+import { installStorage } from "./storage.js";
+
+// ─── 替换 WebSocket（禁用 permessage-deflate）──────────────
+// 根因：Node.js v22 内置 WebSocket 自动协商 permessage-deflate 扩展，
+// 导致某些 WebSocket 帧（特别是 million_group_open_http_svc 社区群协议）
+// 的响应数据被损坏或丢失。浏览器 WebSocket 不支持此扩展，SDK 设计时
+// 假设接收的是未经传输层压缩的原始数据。
+// 解决方案：用 ws npm 包替代内置 WebSocket，显式关闭 perMessageDeflate。
+globalThis.WebSocket = class OpenAgentWebSocket extends WS {
+  constructor(url, protocols) {
+    super(url, protocols, { perMessageDeflate: false });
+    this.binaryType = "arraybuffer";
+  }
+};
+
+// ─── 安装 localStorage ────────────────────────────────────
+installStorage();
+
+// ─── unhandledRejection 安全网 ────────────────────────────
+// 即使 SDK 内部的 send() 已加 p.catch()，仍需全局兜底
+// 以防其他代码路径产生 unhandled rejection
+if (!globalThis.__OPENAGENT_REJECTION_HANDLER_INSTALLED) {
+  process.on("unhandledRejection", (reason) => {
+    const code = reason?.code || "UNKNOWN";
+    const msg = reason?.message || "";
+    // 用 OPENAGENT logger（如果已注入）或 stderr
+    const logger = globalThis.__OPENAGENT_SDK_LOGGER;
+    if (logger) {
+      logger.warn(`[SDK] unhandled rejection: code=${code} ${msg}`);
+    } else {
+      console.error(`[SDK] unhandled rejection: code=${code} ${msg}`);
+    }
+  });
+  globalThis.__OPENAGENT_REJECTION_HANDLER_INSTALLED = true;
+}

package/dist/src/sdk/node-env/storage.js

@@ -0,0 +1,114 @@
+/**
+ * node-env/storage.js
+ *
+ * 替代浏览器 localStorage，用内存 Map 实现。
+ * SDK 通过 StorageModule（index.js L11400区）使用 localStorage。
+ *
+ * 原始 SDK 通过 _canIUseCookies() 检测：
+ *   typeof window !== "undefined" && navigator.cookieEnabled && localStorage
+ * 在 Node.js 下返回 false → 所有存储操作被跳过。
+ *
+ * 本模块提供一个 localStorage 兼容对象。
+ * 使用方式：在 SDK import 前设置 globalThis.localStorage。
+ * 同时需要设置 globalThis.navigator.cookieEnabled = true。
+ *
+ * 注意：这是内存实现，进程退出后数据丢失。
+ * 对 Agent 场景足够——不需要跨进程持久化。
+ */
+
+const _store = new Map();
+
+const memoryStorage = {
+  getItem(key) {
+    return _store.has(key) ? _store.get(key) : null;
+  },
+
+  setItem(key, value) {
+    _store.set(key, String(value));
+  },
+
+  removeItem(key) {
+    _store.delete(key);
+  },
+
+  clear() {
+    _store.clear();
+  },
+
+  get length() {
+    return _store.size;
+  },
+
+  key(index) {
+    const keys = [..._store.keys()];
+    return index < keys.length ? keys[index] : null;
+  },
+
+  /**
+   * 支持 for...in 遍历（SDK L11445: for (let e in localStorage)）
+   * 通过 Proxy 在 install() 时实现
+   */
+};
+
+/**
+ * 安装 localStorage polyfill 到 globalThis。
+ * 使用 Proxy 支持 for...in 遍历和 hasOwnProperty 调用。
+ *
+ * 必须在 SDK import 之前调用。
+ */
+export function installStorage() {
+  // Proxy 让 for...in 和 hasOwnProperty 工作
+  const storageProxy = new Proxy(memoryStorage, {
+    ownKeys() {
+      return [..._store.keys()];
+    },
+    getOwnPropertyDescriptor(target, prop) {
+      if (_store.has(prop)) {
+        return {
+          configurable: true,
+          enumerable: true,
+          value: _store.get(prop),
+        };
+      }
+      if (prop in target) {
+        return Object.getOwnPropertyDescriptor(target, prop);
+      }
+      return undefined;
+    },
+    has(target, prop) {
+      return _store.has(prop) || prop in target;
+    },
+    get(target, prop) {
+      if (prop === "hasOwnProperty") {
+        return (key) => _store.has(key);
+      }
+      if (prop in target) {
+        const val = target[prop];
+        return typeof val === "function" ? val.bind(target) : val;
+      }
+      return _store.get(prop);
+    },
+  });
+
+  globalThis.localStorage = storageProxy;
+
+  // navigator.cookieEnabled 让 _canIUseCookies() 返回 true
+  if (typeof globalThis.navigator === "undefined") {
+    globalThis.navigator = {};
+  }
+  globalThis.navigator.cookieEnabled = true;
+}
+
+/**
+ * 获取内部 store 的大小（调试用）
+ */
+export function getStorageSize() {
+  return _store.size;
+}
+
+/**
+ * 导出内存 store 的快照（调试用）
+ */
+export function getStorageSnapshot() {
+  return Object.fromEntries(_store);
+}

package/dist/src/sdk/package.json

@@ -0,0 +1,10 @@
+{
+  "name": "@tencentcloud/chat",
+  "version": "3.6.6-clawlink",
+  "description": "Tencent Cloud Chat SDK — prettified JS with Node.js patches",
+  "type": "module",
+  "main": "./index.js",
+  "exports": {
+    ".": "./index.js"
+  }
+}

package/dist/src/sdk/sdk/CLASS_MAP.md

@@ -0,0 +1,143 @@
+# @tencentcloud/chat SDK v3.6.6 — Code Structure Map
+
+> Annotated and formatted for readability. Logic 100% preserved from ESM distribution.
+
+## Quick Navigation
+
+### Core Infrastructure
+
+| Class | Module Name | Lines | Size | Purpose |
+|-------|-------------|-------|------|---------|
+| `s` | — | L157-181 | 25 | Middleware chain |
+| `i` | — | L182-202 | 21 | Uint64 implementation |
+| `ni` | — (extends Error) | L3227-3243 | 17 | SDK custom error |
+| `ui` | — | L3381-3460 | 80 | **Module base class** (all `extends ui` inherit this) |
+| `Mo` | **SocketHandler** | L18135-18685 | **551** | WebSocket connection, reconnection, heartbeat |
+| `To` | **PHandler** | L18964-22460 | **3497** | Protocol handler — frame serialize/deserialize |
+| `vo` | **MsgDispatcher** | L22462-22797 | 336 | Routes incoming WS messages to modules |
+| `Pr` | **ModuleManager** | L27279-27690 | 412 | Central registry — instantiates all modules |
+| `Gr` | — | L27770-28854 | 1085 | **Main SDK class** (TencentCloudChat instance) |
+
+### Messaging
+
+| Class | Module Name | Lines | Size | Purpose |
+|-------|-------------|-------|------|---------|
+| `Qi` | **C2CModule** | L5031-5896 | 866 | One-to-one private chat |
+| `tn` | **MsgListHandler** | L5904-6342 | 439 | Message list storage & pagination |
+| `Xn` | **MessageModule** | L15343-16350 | **1008** | Core message create/send/receive |
+| `Yn` | MergerMessageHandler | L15076-15312 | 237 | Combined message handling |
+| `Zn` | MsgExtModule | L16351-16752 | 402 | Message extensions |
+| `Qn` | MsgReactionModule | L16753-17172 | 420 | Message reactions (emoji) |
+| `eo` | ComboMsgModule | L17173-17370 | 198 | Combo message handling |
+| `so` | SyncUnreadMsgModule | L17392-17499 | 108 | Unread message sync |
+
+### Conversations
+
+| Class | Module Name | Lines | Size | Purpose |
+|-------|-------------|-------|------|---------|
+| `fn` | MsgRemindHandler | L6873-7134 | 262 | Message notification settings |
+| `Mn` | **ConvGroupHandler** | L7135-8124 | 990 | Conversation group (folder) management |
+| `In` | **ConvModule** | L8125-10961 | **2837** | Conversation list, unread counts |
+
+### Groups & Topics
+
+| Class | Module Name | Lines | Size | Purpose |
+|-------|-------------|-------|------|---------|
+| `vn` | TopicModule | L11067-11768 | 702 | Community topic (sub-channel) |
+| `Co` | ChannelModule | L18745-18963 | 219 | Channel/Room messaging |
+
+### User & Profile
+
+| Class | Module Name | Lines | Size | Purpose |
+|-------|-------------|-------|------|---------|
+| `Sn` | ProfileHandler | L11769-12222 | 454 | User profile management |
+| `Dn` | BlacklistHandler | L12231-12384 | 154 | Blocklist |
+| `Ln` | UserStatusHandler | L12400-12669 | 270 | Online/offline status |
+| `An` | UserModule | L12670-12798 | 129 | User operations |
+
+### Auth & Session
+
+| Class | Module Name | Lines | Size | Purpose |
+|-------|-------------|-------|------|---------|
+| `Pn` | SignModule | L13042-13354 | 313 | Authentication signing |
+| `Lo` | **SessionModule** | L22904-23260 | 357 | Login/logout lifecycle |
+
+### Upload & Media
+
+| Class | Module Name | Lines | Size | Purpose |
+|-------|-------------|-------|------|---------|
+| `Wn` | **UploadModule** | L14043-15075 | 1033 | File/image/video upload to COS |
+
+### Quality & Monitoring
+
+| Class | Module Name | Lines | Size | Purpose |
+|-------|-------------|-------|------|---------|
+| `Di` | SSOLogData | L3666-3812 | 147 | SSO log entry |
+| `bn` | EventStatModule | L13576-13703 | 128 | Event statistics |
+| `qn` | NetMonitorModule | L13706-13823 | 118 | Network monitoring |
+| `No` | AvgE2EDelay | L23620-23707 | 88 | End-to-end delay metric |
+| `Po` | AvgRTT | L23708-23774 | 67 | Round-trip time metric |
+| `ko` | QualityStatModule | L24015-24226 | 212 | Quality statistics |
+| `wo` | WorkerTimerModule | L24227-24298 | 72 | Web Worker timer |
+
+### Plugins & Extensions
+
+| Class | Module Name | Lines | Size | Purpose |
+|-------|-------------|-------|------|---------|
+| `to` | PluginModule | L17371-17391 | 21 | Plugin registration |
+| `bo` | PurchasedFeatureHandler | L24299-24401 | 103 | Feature gating |
+| `Fo` | CommercialConfigModule | L24402-24500 | 99 | Commercial config |
+| `qo` | TIMPushModule | L24767-25114 | 348 | Push notifications |
+| `xo` | ProfanityFilterModule | L25115-25321 | 207 | Content moderation |
+| `Ao` | CloudControlModule | L23261-23383 | 123 | Cloud config |
+| `Gn` | StorageModule | L13358-13531 | 174 | Local storage |
+
+### Other
+
+| Class | Module Name | Lines | Size | Purpose |
+|-------|-------------|-------|------|---------|
+| `Oo` | RecoverMsgModule | L23384-23619 | 236 | Message recovery |
+| `Vo` | TransCmdModule | L25322-25398 | 77 | Translation commands |
+| `Bo` | ErrMsgModule | L25399-25568 | 170 | Error message mapping |
+| `Nr` | InflateModule | L27240-27278 | 39 | Data decompression |
+| `Ur` | SafetyCallback | L27691-27769 | 79 | Safe callback wrapper |
+
+---
+
+## Key Top-Level Variables
+
+| Variable | Lines | Size | Purpose |
+|----------|-------|------|---------|
+| `e` | L1-39 | 39 | **EVENT** enum — all SDK event names |
+| `t` | L40-156 | 117 | **TYPES** enum — message/group/conversation types |
+| `n` | L203-317 | 115 | WebSocket server addresses by region |
+| `o` | L318-333 | 16 | Platform IDs |
+| `r` | L334 | 1 | SDK version: `"1.7.3"` |
+| `a` | L335 | 1 | Build number: `537048168` |
+| `f` | L345-392 | 48 | Server host config (current host, service names) |
+| `M` | L393-412 | 20 | Feature capability bitfields |
+| `Ee` | L563-643 | 81 | **Logger** (d/l/i/w/e methods, level control) |
+| `Ts` | L1453-3035 | **1583** | **API command definitions** (wslogin, sendmsg, etc.) |
+| `ys` | L3036-3186 | 151 | **Error codes** (NO_SDKAPPID, NETWORK_TIMEOUT, etc.) |
+| `dr` | L26129-26948 | 820 | **SDK factory** — creates TencentCloudChat instances |
+
+## Key Patch Points
+
+| Line | Content | Clawlink Usage |
+|------|---------|----------------|
+| L514 | `globalThis.__CLAWLINK_SDK_LOGGER` | Logger injection — redirects SDK logs to file |
+| L18135 | `class Mo` (SocketHandler) | WebSocket timeout/reconnect behavior |
+| L18148 | `MAX_RECONNECT_COUNT = 3` | Max reconnection attempts |
+| L5031 | `class Qi` (C2CModule) | Private messaging logic |
+
+---
+
+## External Modules (in `modules/` directory)
+
+| File | Formatted Lines | Classes | Purpose |
+|------|-----------------|---------|---------|
+| `group-module.js` | 6,078 | 28 | Group create/join/quit/update + member mgmt |
+| `relationship-module.js` | 1,981 | 11 | Friend add/delete/check + friend groups |
+| `signaling-module.js` | 1,272 | 7 | Invite/accept/reject signaling |
+| `cloud-search-module.js` | 999 | 5 | Cloud message/group/user search |
+| `follow-module.js` | 935 | 4 | Follow/unfollow user relationships |

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

@@ -0,0 +1,126 @@
+/**
+ * Type declarations for the bundled TIM SDK (src/sdk/index.js)
+ *
+ * The SDK is a modified copy of @tencentcloud/chat without TS declarations.
+ * This file provides the minimal type surface used by openagent.
+ */
+
+interface ChatInstance {
+  setLogLevel(level: number): void;
+  login(options: { userID: string; userSig: string }): Promise<void>;
+  logout(): Promise<void>;
+  on(event: string, handler: (...args: unknown[]) => void): void;
+  off(event: string, handler: (...args: unknown[]) => void): void;
+
+  // Messaging
+  createTextMessage(options: {
+    to: string;
+    conversationType: string;
+    payload: { text: string };
+  }): unknown;
+  createTextAtMessage(options: {
+    to: string;
+    conversationType: string;
+    payload: { text: string; atUserList: string[] };
+  }): unknown;
+  createCustomMessage(options: {
+    to: string;
+    conversationType: string;
+    payload: { data: string; description: string; extension: string };
+  }): unknown;
+  // T4: File message for C2C file transfer
+  createFileMessage(options: {
+    to: string;
+    conversationType: string;
+    payload: { file: File };
+    onProgress?: (event: { percent: number }) => void;
+  }): unknown;
+  sendMessage(message: unknown): Promise<{ data?: { message?: { ID?: string } } }>;
+  getMessageList(options: {
+    conversationID: string;
+    count: number;
+  }): Promise<{
+    data?: {
+      messageList?: Array<{
+        ID?: string;
+        from?: string;
+        type?: string;
+        payload?: { text?: string };
+        time?: number;
+        sequence?: number;
+      }>;
+    };
+  }>;
+
+  // Groups
+  getGroupList(): Promise<{
+    data?: {
+      groupList?: Array<{
+        groupID: string;
+        name: string;
+        introduction?: string;
+      }>;
+    };
+  }>;
+  joinGroup(options: { groupID: string }): Promise<void>;
+  quitGroup(groupID: string): Promise<void>;
+  getGroupMemberList(options: {
+    groupID: string;
+    count: number;
+    offset: number;
+  }): Promise<{
+    data?: {
+      memberList?: Array<{
+        userID: string;
+        nick?: string;
+        role?: string;
+        avatar?: string;
+      }>;
+    };
+  }>;
+  createGroup(options: {
+    type: string;
+    name: string;
+    groupID?: string;
+    introduction?: string;
+    notification?: string;
+    joinOption?: string;
+    isSupportTopic?: boolean;
+  }): Promise<{ data?: { group?: { groupID?: string } } }>;
+  getGroupProfile(options: {
+    groupID: string;
+    groupCustomFieldFilter?: string[];
+  }): Promise<{
+    data?: { group?: { notification?: string } };
+  }>;
+  updateGroupProfile(options: {
+    groupID: string;
+    notification?: string;
+  }): Promise<void>;
+  getConversationProfile(conversationID: string): Promise<unknown>;
+  // T4: Plugin registration for tim-upload-plugin
+  registerPlugin(plugins: Record<string, unknown>): void;
+}
+
+interface TencentCloudChatStatic {
+  create(options: { SDKAppID: number; modules?: Record<string, unknown> }): ChatInstance;
+  EVENT: {
+    SDK_READY: string;
+    SDK_NOT_READY: string;
+    KICKED_OUT: string;
+    MESSAGE_RECEIVED: string;
+  };
+  TYPES: {
+    CONV_GROUP: string;
+    CONV_C2C: string;
+    MSG_TEXT: string;
+    MSG_AT_ALL: string;
+    MSG_FILE: string;
+    GRP_PUBLIC: string;
+    GRP_COMMUNITY: string;
+    JOIN_OPTIONS_FREE_ACCESS: string;
+  };
+}
+
+declare const TencentCloudChat: TencentCloudChatStatic;
+export default TencentCloudChat;