openclaw-openagent 1.0.1 → 1.0.2

package/dist/src/sdk/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/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/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/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/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "ES2020",
+    "moduleResolution": "bundler",
+    "strict": false,
+    "noImplicitAny": false,
+    "noEmit": true,
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "allowJs": true,
+    "checkJs": false
+  },
+  "include": ["./*.ts"],
+  "exclude": ["./modules/*"]
+}

package/dist/src/sdk/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "ES2020",
+    "moduleResolution": "bundler",
+    "strict": false,
+    "noImplicitAny": false,
+    "noEmit": true,
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "allowJs": true,
+    "checkJs": false
+  },
+  "include": ["./*.ts"],
+  "exclude": ["./modules/*"]
+}

package/dist/src/state/pending-invocation-store.d.ts

@@ -0,0 +1,26 @@
+/**
+ * StateStore → OasnInvocation.PendingInvocationStore 适配器
+ *
+ * 设计依据：docs/specs/2026-06-16-oasn-transport-abstraction-design.md §11.1
+ *
+ * 把 SQLite-backed StateStore 的 pending_invocations CRUD 方法包装成
+ * OasnInvocation 模块需要的 PendingInvocationStore 接口形状。
+ *
+ * 拆出独立适配器的好处：
+ *   1. OasnInvocation 不直接依赖 StateStore 类型 —— 子模块测试时可注入纯内存假实现
+ *   2. 后续若多账号场景需要切表/前缀，可以在此层做隔离，不污染 StateStore 主接口
+ *   3. 启动时续轮询逻辑（扫描 listUnsettledInvocations）放在 AccountRuntime 里调用，
+ *      适配器只承担运行时单条 CRUD，职责清晰
+ */
+import type { PendingInvocationStore } from '../transport/oasn/index.js';
+import type { StateStore } from './store.js';
+/**
+ * 适配 StateStore 暴露 PendingInvocationStore 接口。
+ *
+ * 用法：
+ *   const store = new StateStore();
+ *   await store.init(accountId);
+ *   const pending = createPendingInvocationStore(store);
+ *   const transport = createTransport({ ..., pendingStore: pending });
+ */
+export declare function createPendingInvocationStore(store: StateStore): PendingInvocationStore;

package/dist/src/state/pending-invocation-store.js

@@ -0,0 +1,39 @@
+/**
+ * StateStore → OasnInvocation.PendingInvocationStore 适配器
+ *
+ * 设计依据：docs/specs/2026-06-16-oasn-transport-abstraction-design.md §11.1
+ *
+ * 把 SQLite-backed StateStore 的 pending_invocations CRUD 方法包装成
+ * OasnInvocation 模块需要的 PendingInvocationStore 接口形状。
+ *
+ * 拆出独立适配器的好处：
+ *   1. OasnInvocation 不直接依赖 StateStore 类型 —— 子模块测试时可注入纯内存假实现
+ *   2. 后续若多账号场景需要切表/前缀，可以在此层做隔离，不污染 StateStore 主接口
+ *   3. 启动时续轮询逻辑（扫描 listUnsettledInvocations）放在 AccountRuntime 里调用，
+ *      适配器只承担运行时单条 CRUD，职责清晰
+ */
+/**
+ * 适配 StateStore 暴露 PendingInvocationStore 接口。
+ *
+ * 用法：
+ *   const store = new StateStore();
+ *   await store.init(accountId);
+ *   const pending = createPendingInvocationStore(store);
+ *   const transport = createTransport({ ..., pendingStore: pending });
+ */
+export function createPendingInvocationStore(store) {
+    return {
+        getPending(toolCallId) {
+            return store.getPendingInvocation(toolCallId);
+        },
+        upsertPending(record) {
+            store.upsertPendingInvocation(record);
+        },
+        markTerminal(invocationId, status) {
+            store.markPendingInvocationTerminal(invocationId, status);
+        },
+        markAbandoned(invocationId) {
+            store.markPendingInvocationAbandoned(invocationId);
+        },
+    };
+}

package/dist/src/state/store.d.ts

@@ -0,0 +1,165 @@
+/**
+ * State Store — SQLite persistence via sql.js (pure WASM)
+ *
+ * Persists channel state and message dedup records.
+ * sql.js operates in-memory; explicit persist() writes to disk.
+ * No native compilation needed (unlike better-sqlite3).
+ *
+ * v3: All tables use (account_id, channel_id) composite key.
+ * See §0.4 of refactoring-plan.md for field semantics.
+ */
+export interface ChannelState {
+    account_id: string;
+    channel_id: string;
+    channel_name: string;
+    joined: number;
+    last_visit: number;
+    last_reply: number;
+    last_msg_seq: number;
+    created_at: number;
+    updated_at: number;
+}
+export interface ChannelStateDisplay {
+    id: string;
+    name: string;
+    lastVisit: string;
+    lastReply: string;
+    lastMsgSeq: number;
+}
+/**
+ * §11.1 OASN invocation 幂等持久化记录。
+ *
+ * 同一个 tool_call_id 多次重试时必须复用首次生成的 idempotency_key，
+ * 否则服务端会创建多个 Invocation（叠加 §11.2 没有 cancel API 的限制，会泄漏调用配额）。
+ *
+ * 流程：
+ *   1. sendTask 前查询 tool_call_id 是否已有未完成记录 → 复用 idempotency_key
+ *   2. POST /api/invocations 成功后 → upsert 写入 invocation_id + status
+ *   3. 终态 → markTerminal(status)；abort → markAbandoned()
+ *   4. 进程启动时扫描 status NOT IN (succeeded,failed,timed_out,cancelled,abandoned)
+ *      → 调 GET /api/invocations/{id} 续轮询
+ */
+export interface PendingInvocationRecord {
+    /** LLM 工具调用唯一 id（上层传入） */
+    tool_call_id: string;
+    /** 首次生成的 UUID，重试必须复用 */
+    idempotency_key: string;
+    /** POST 返回后回填，POST 之前为 null */
+    invocation_id: string | null;
+    session_id: string | null;
+    target_agent_id: string | null;
+    /** accepted / queued / running / succeeded / failed / timed_out / cancelled / abandoned */
+    status: string;
+    created_at: number;
+    updated_at: number;
+}
+export declare class StateStore {
+    private db;
+    private accountId;
+    private _seenCount;
+    /**
+     * Initialize the SQLite database.
+     * Must be called before any other methods.
+     *
+     * @param currentAccountId - The account ID of the currently starting account.
+     *   Used for schema migration: old data without account_id will be assigned this ID.
+     */
+    init(currentAccountId: string): Promise<StateStore>;
+    private _migrate;
+    private _tableHasColumn;
+    private _tableExists;
+    private _migrateFromV2;
+    private _createV3Tables;
+    persist(): void;
+    /**
+     * Get all joined channels for the current account.
+     */
+    getJoinedChannels(): ChannelState[];
+    getJoinedChannelIds(): string[];
+    getChannel(channelId: string): ChannelState | null;
+    /**
+     * Mark a channel as joined.
+     * Authoritative writer: openagent_join_channel tool (on success).
+     */
+    markJoined(channelId: string, channelName: string): void;
+    /**
+     * Mark a channel as left.
+     * Authoritative writer: openagent_leave_channel tool (on success).
+     */
+    markLeft(channelId: string): void;
+    /**
+     * Update last_visit timestamp for a channel.
+     * Authoritative writer: Collector — on ingest() accepting a message.
+     */
+    updateLastVisit(channelId: string): void;
+    /**
+     * Update last_reply timestamp for a channel.
+     * Authoritative writer: openagent_send_message tool — on sendMessage() success.
+     */
+    updateLastReply(channelId: string): void;
+    /**
+     * Update last_msg_seq for a channel.
+     * Authoritative writer: Collector — on ingest() taking msg.sequence.
+     */
+    updateLastMsgSeq(channelId: string, seq: number): void;
+    hasSeen(messageId: string): boolean;
+    markSeen(messageId: string, channelId: string): void;
+    getSkill(channelId: string): string | null;
+    setSkill(channelId: string, skillContent: string): void;
+    getAllSkills(): Array<{
+        channel_id: string;
+        skill_content: string;
+    }>;
+    getPurpose(channelId: string): string | null;
+    setPurpose(channelId: string, purpose: string): void;
+    removePurpose(channelId: string): void;
+    /**
+     * Clean up old dedup records (older than 24h)
+     */
+    cleanupSeen(): void;
+    /**
+     * Close the database connection
+     */
+    close(): void;
+    /**
+     * 查 tool_call_id 是否有未完成记录。命中 → 复用其 idempotency_key 防止重复创建 Invocation。
+     *
+     * 仅当 status 为非终态（pending/accepted/queued/running）时返回，避免幂等键被复用到新调用上。
+     */
+    getPendingInvocation(toolCallId: string): {
+        idempotency_key: string;
+        invocation_id?: string;
+    } | null;
+    /**
+     * 插入或更新一条 pending 记录。
+     *
+     * 调用时机：
+     *   - sendTask 之前（尚无 invocation_id，status='pending'）
+     *   - POST /api/invocations 返回后（回填 invocation_id + status）
+     */
+    upsertPendingInvocation(record: {
+        tool_call_id: string;
+        idempotency_key: string;
+        invocation_id?: string;
+        session_id?: string;
+        target_agent_id?: string;
+        status: string;
+    }): void;
+    /**
+     * 终态标记。透过 invocation_id 查找（OasnInvocation 在终态回调时只持有 invocation_id）。
+     */
+    markPendingInvocationTerminal(invocationId: string, status: string): void;
+    /**
+     * §11.2 abort 标记。
+     *
+     * 服务端没有 cancel API，本地只能记录"已放弃跟踪"，便于排查 / 配额对账。
+     */
+    markPendingInvocationAbandoned(invocationId: string): void;
+    /**
+     * 列出非终态记录（启动时续轮询用）。
+     *
+     * 返回顺序：按 created_at 升序，先创建的先续。
+     */
+    listUnsettledInvocations(): PendingInvocationRecord[];
+    private _isTerminalStatus;
+}