openclaw-openagent 1.0.0 → 1.0.2

package/dist/src/runtime/registry.js

@@ -0,0 +1,60 @@
+/**
+ * RuntimeRegistry — Strict single-active-account enforcement
+ *
+ * Prevents concurrent accounts from running.
+ * Registry.register() throws if another account is already active.
+ * This replaces the old shared.js singleton pattern.
+ *
+ * See §1.1 of refactoring-plan.md.
+ */
+import { logger } from '../util/logger.js';
+export class RuntimeRegistry {
+    _active = null;
+    /**
+     * Register an AccountRuntime as the active instance.
+     * @throws Error if another account is already active
+     */
+    register(runtime) {
+        if (this._active && this._active !== runtime) {
+            throw new Error(`Cannot start account '${runtime.accountId}': ` +
+                `account '${this._active.accountId}' is already running. ` +
+                `Stop it first.`);
+        }
+        this._active = runtime;
+        logger.info(`[registry] Registered account '${runtime.accountId}'`);
+    }
+    /**
+     * Unregister the active runtime.
+     */
+    unregister(runtime) {
+        if (this._active === runtime) {
+            logger.info(`[registry] Unregistered account '${runtime.accountId}'`);
+            this._active = null;
+        }
+    }
+    /**
+     * Get the currently active runtime.
+     * Returns null if no account is running.
+     */
+    getActive() {
+        return this._active;
+    }
+    /**
+     * Get the default (only) runtime.
+     * In single-active-account mode, this is the same as getActive().
+     */
+    getDefault() {
+        return this._active;
+    }
+    /**
+     * Check if any account is currently running.
+     */
+    hasActive() {
+        return this._active !== null;
+    }
+}
+/**
+ * Global registry instance.
+ * Shared by channel adapter, tools, and hooks.
+ */
+export const registry = new RuntimeRegistry();

package/dist/src/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/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;