openclaw-openagent 1.0.13 → 1.0.14

package/src/tim/channels.ts

@@ -1,364 +0,0 @@
-/**
- * TIM Channels — Channel management operations via SDK
- *
- * All operations use the TIM SDK (not REST API).
- * listChannels uses the auth service endpoint.
- */
-
-import { logger } from '../util/logger.js';
-import { httpGet } from '../util/http.js';
-import type { TIMClient } from './client.js';
-
-const AUTH_BASE = 'https://auth.ai-talk.live';
-
-// ── Types ──
-
-export interface ChannelInfo {
-  id: string;
-  name: string;
-  desc: string;
-  memberCount?: number;
-}
-
-export interface MemberInfo {
-  id: string;
-  nick: string;
-  role: string;
-  avatar?: string;
-}
-
-// ── Functions ──
-
-/**
- * List all available channels from the auth service.
- */
-export async function listChannels(client: TIMClient): Promise<ChannelInfo[]> {
-  logger.info('[tim/channels] listChannels: fetching from auth service');
-  try {
-    const headers: Record<string, string> = {};
-    if (client.userSig) {
-      headers['Authorization'] = `Bearer ${client.userSig}`;
-    }
-
-    const data = await httpGet<
-      | ChannelInfo[]
-      | { data?: ChannelInfo[]; channels?: ChannelInfo[] }
-    >(`${AUTH_BASE}/api/channels`, { headers });
-
-    const rawList: unknown[] = Array.isArray(data) ? data : (
-      (data as { data?: unknown[] }).data
-      || (data as { channels?: unknown[] }).channels
-      || []
-    );
-
-    logger.info(`[tim/channels] listChannels: found ${rawList.length} channels`);
-    return rawList.map((item) => {
-      const ch = item as Record<string, unknown>;
-      return {
-        id: (ch['channel_id'] || ch['id'] || ch['channelId'] || ch['GroupId'] || '') as string,
-        name: (ch['name'] || ch['Name'] || '') as string,
-        desc: (ch['description'] || ch['desc'] || ch['Introduction'] || '') as string,
-        memberCount: (ch['member_count'] || ch['memberCount'] || 0) as number,
-      };
-    });
-  } catch (err) {
-    logger.error(`[tim/channels] listChannels error: ${(err as Error).message}`);
-    throw err;
-  }
-}
-
-/**
- * Search channels by keyword (client-side filter of listChannels).
- */
-export async function searchChannels(
-  client: TIMClient,
-  keyword: string,
-): Promise<ChannelInfo[]> {
-  logger.info(`[tim/channels] searchChannels: keyword="${keyword}"`);
-  const all = await listChannels(client);
-  const lower = keyword.toLowerCase();
-  return all.filter(ch =>
-    ch.name.toLowerCase().includes(lower) ||
-    ch.desc.toLowerCase().includes(lower) ||
-    ch.id.toLowerCase().includes(lower),
-  );
-}
-
-/**
- * TIM SDK error code for "already a group member".
- * @see https://cloud.tencent.com/document/product/269/75394
- */
-const ERR_ALREADY_GROUP_MEMBER = 10013;
-
-/**
- * Join a group channel.
- *
- * Per TIM Web SDK docs, joinGroup may:
- *   - Resolve with status JOIN_STATUS_SUCCESS / ALREADY_IN_GROUP / WAIT_APPROVAL
- *   - Reject with error code 10013 ("already group member")
- *
- * We handle both paths and always refresh the SDK conversation cache
- * afterwards to prevent sendMessage error 2801.
- *
- * @see https://cloud.tencent.com/document/product/269/75395
- */
-export async function joinChannel(
-  client: TIMClient,
-  channelId: string,
-): Promise<{ success: boolean; message: string }> {
-  const chat = client._chat;
-  if (!chat || !client.isReady) throw new Error('Not connected');
-
-  logger.info(`[tim/channels] joinChannel: ${channelId}`);
-
-  try {
-    await chat.joinGroup({ groupID: channelId });
-    logger.info(`[tim/channels] joinChannel: joined ${channelId}`);
-  } catch (err) {
-    const code = (err as { code?: number })?.code;
-    if (code === ERR_ALREADY_GROUP_MEMBER) {
-      logger.info(`[tim/channels] joinChannel: already a member of ${channelId} (code=${code})`);
-    } else {
-      logger.error(`[tim/channels] joinChannel failed: code=${code} msg=${(err as Error).message}`);
-      throw err;
-    }
-  }
-
-  // Force SDK to cache group conversation profile.
-  // Required because: (1) ALREADY_IN_GROUP does not refresh cache,
-  // and (2) even new joins may not populate the conversation list.
-  // Without this, sendMessage fails with error 2801 (group profile cache miss).
-  try {
-    await chat.getConversationProfile(`GROUP${channelId}`);
-    logger.info(`[tim/channels] joinChannel: conversation profile cached for ${channelId}`);
-  } catch (cacheErr) {
-    const cacheCode = (cacheErr as { code?: number })?.code;
-    logger.warn(`[tim/channels] joinChannel: failed to cache conversation profile for ${channelId} (code=${cacheCode})`);
-  }
-
-  return { success: true, message: `Joined ${channelId}` };
-}
-
-/**
- * Leave a group channel.
- */
-export async function leaveChannel(
-  client: TIMClient,
-  channelId: string,
-): Promise<{ success: boolean; message: string }> {
-  const chat = client._chat;
-  if (!chat || !client.isReady) throw new Error('Not connected');
-
-  logger.info(`[tim/channels] leaveChannel: ${channelId}`);
-  try {
-    await chat.quitGroup(channelId);
-    return { success: true, message: `Left ${channelId}` };
-  } catch (err) {
-    const code = (err as { code?: number })?.code;
-    logger.error(`[tim/channels] leaveChannel failed: code=${code} msg=${(err as Error).message} ch=${channelId}`);
-    throw err;
-  }
-}
-
-/**
- * Get members of a group channel.
- */
-export async function getMembers(
-  client: TIMClient,
-  channelId: string,
-): Promise<MemberInfo[]> {
-  const chat = client._chat;
-  if (!chat || !client.isReady) throw new Error('Not connected');
-
-  logger.info(`[tim/channels] getMembers: ${channelId}`);
-  try {
-    const res = await chat.getGroupMemberList({
-      groupID: channelId,
-      count: 100,
-      offset: 0,
-    }) as {
-      data?: {
-        memberList?: Array<{
-          userID: string;
-          nick?: string;
-          role?: string;
-          avatar?: string;
-        }>;
-      };
-    };
-
-    const members = (res.data?.memberList || []).map(m => ({
-      id: m.userID,
-      nick: m.nick || m.userID,
-      role: m.role || 'Member',
-      avatar: m.avatar || '',
-    }));
-    logger.info(`[tim/channels] getMembers: ${channelId} found ${members.length} members`);
-    return members;
-  } catch (err) {
-    const code = (err as { code?: number })?.code;
-    logger.error(`[tim/channels] getMembers failed: code=${code} msg=${(err as Error).message} ch=${channelId}`);
-    throw err;
-  }
-}
-
-/**
- * Create a new Community group channel.
- *
- * Uses GRP_COMMUNITY (社群) — supports large-scale membership, topics,
- * and free join/leave. Requires Tencent IM flagship plan with Community
- * feature enabled in console.
- *
- * groupID is always auto-generated by the SDK with @TGS#_ prefix.
- * Community groups reject custom groupIDs that don't start with @TGS#_
- * (SDK error ILLEGAL_GRP_ID / 2602).
- *
- * @see https://cloud.tencent.com/document/product/269/75394
- * @see https://cloud.tencent.com/document/product/269/1502 (群组类型)
- */
-export async function createChannel(
-  client: TIMClient,
-  name: string,
-  description = '',
-  skill = '',
-): Promise<{ success: boolean; channelId: string }> {
-  const chat = client._chat;
-  if (!chat || !client.isReady) throw new Error('Not connected');
-
-  logger.info(`[tim/channels] createChannel: type=Community name="${name}"`);
-
-  try {
-    // Community groups require groupID to start with @TGS#_ or be empty.
-    // SDK auto-generates @TGS#_ prefixed ID when groupID is omitted.
-    const result = await chat.createGroup({
-      type: client._types.GRP_COMMUNITY,
-      name,
-      // groupID intentionally omitted — SDK auto-generates @TGS#_ prefixed ID
-      introduction: description,
-      notification: skill,
-      isSupportTopic: false,
-    });
-
-    const actualId = result?.data?.group?.groupID;
-    if (!actualId) throw new Error('SDK returned no groupID');
-    logger.info(`[tim/channels] Channel created: ${actualId} (type=Community)`);
-    return { success: true, channelId: actualId };
-  } catch (err) {
-    const code = (err as { code?: number })?.code;
-    const msg = (err as { message?: string })?.message || String(err);
-    logger.error(`[tim/channels] createChannel failed: code=${code} msg=${msg}`);
-    throw err;
-  }
-}
-
-/**
- * Get channel skill (stored in group notification field).
- */
-export async function getChannelSkill(
-  client: TIMClient,
-  channelId: string,
-): Promise<string | null> {
-  const chat = client._chat;
-  if (!chat || !client.isReady) return null;
-
-  try {
-    const res = await chat.getGroupProfile({
-      groupID: channelId,
-      groupCustomFieldFilter: [],
-    }) as { data?: { group?: { notification?: string } } };
-
-    return res.data?.group?.notification || null;
-  } catch (err) {
-    const code = (err as { code?: number })?.code;
-    logger.warn(`[tim/channels] getChannelSkill failed: code=${code} msg=${(err as Error).message} ch=${channelId}`);
-    return null;
-  }
-}
-
-/**
- * Set channel skill (stored in group notification field).
- */
-export async function setChannelSkill(
-  client: TIMClient,
-  channelId: string,
-  skill: string,
-): Promise<{ success: boolean }> {
-  const chat = client._chat;
-  if (!chat || !client.isReady) throw new Error('Not connected');
-
-  logger.info(`[tim/channels] setChannelSkill: ${channelId}`);
-  try {
-    await chat.updateGroupProfile({
-      groupID: channelId,
-      notification: skill,
-    });
-    return { success: true };
-  } catch (err) {
-    const code = (err as { code?: number })?.code;
-    logger.error(`[tim/channels] setChannelSkill failed: code=${code} msg=${(err as Error).message} ch=${channelId}`);
-    throw err;
-  }
-}
-
-/**
- * Get channel display name from group profile.
- */
-export async function getGroupName(
-  client: TIMClient,
-  channelId: string,
-): Promise<string | null> {
-  const chat = client._chat;
-  if (!chat || !client.isReady) return null;
-
-  try {
-    const res = await chat.getGroupProfile({
-      groupID: channelId,
-      groupCustomFieldFilter: [],
-    }) as { data?: { group?: { name?: string } } };
-
-    return res.data?.group?.name || null;
-  } catch (err) {
-    const code = (err as { code?: number })?.code;
-    logger.warn(`[tim/channels] getGroupName failed: code=${code} msg=${(err as Error).message} ch=${channelId}`);
-    return null;
-  }
-}
-
-/**
- * Read a single group-level custom field (AppDefinedData).
- *
- * Uses getGroupProfile with groupCustomFieldFilter to fetch only the
- * requested field. Returns null if field not set or fetch fails.
- *
- * @param fieldKey - The custom field key (e.g. 'gm_req_mention')
- */
-export async function getGroupCustomField(
-  client: TIMClient,
-  channelId: string,
-  fieldKey: string,
-): Promise<string | null> {
-  const chat = client._chat;
-  if (!chat || !client.isReady) return null;
-
-  try {
-    const res = await chat.getGroupProfile({
-      groupID: channelId,
-      groupCustomFieldFilter: [fieldKey],
-    }) as {
-      data?: {
-        group?: {
-          groupCustomField?: Array<{ key: string; value: string }>;
-        };
-      };
-    };
-
-    const fields = res.data?.group?.groupCustomField ?? [];
-    const target = fields.find((f: { key: string; value: string }) => f.key === fieldKey);
-    return target?.value ?? null;
-  } catch (err) {
-    const code = (err as { code?: number })?.code;
-    logger.warn(`[tim/channels] getGroupCustomField(${fieldKey}) failed: code=${code} ch=${channelId}`);
-    return null;
-  }
-}
-

package/src/tim/client.ts

@@ -1,330 +0,0 @@
-/**
- * TIM Client — SDK connection core
- *
- * Manages TIM SDK lifecycle: connect, disconnect, auto-reconnect.
- * Emits 'message' events for incoming group chat messages.
- * Emits 'reconnected' when auto-reconnect succeeds.
- *
- * Internal noise containment: all SDK calls wrapped in try/catch,
- * known TIM noise errors logged at debug level.
- */
-
-import './sdk-logger-init.js'; // Must be before @tencentcloud/chat — redirects SDK logs to file
-// @ts-ignore — JS side-effect module, no types needed
-import '../sdk/node-env/index.js'; // Must be before @tencentcloud/chat — installs ws (no permessage-deflate), localStorage, rejection handler
-import TencentCloudChat from '../sdk/index.js';
-// @ts-ignore — vendor JS module, typed as unknown
-import GroupModule from '../sdk/modules/group-module.js';
-// @ts-ignore — vendor JS module, patched for Node.js
-import TIMUploadPlugin from '../sdk/modules/tim-upload-plugin.js';
-import { EventEmitter } from 'node:events';
-
-import { logger } from '../util/logger.js';
-import type { TIMCredentials } from '../auth/verify.js';
-
-// ── Types ──
-
-export interface RawPushMessage {
-  id: string;
-  channelId: string;
-  seq: number;
-  from: string;
-  nick: string;
-  text: string;
-  time: number;
-  mentionsMe: boolean;
-  source: 'push';
-}
-
-// ── TIMClient ──
-
-export class TIMClient extends EventEmitter {
-  private chat: ReturnType<typeof TencentCloudChat.create> | null = null;
-  private _agentId: string = '';
-  private _credentials: TIMCredentials | null = null;
-  private _reconnecting = false;
-  private _ready = false;
-
-  get agentId(): string { return this._agentId; }
-  get isReady(): boolean { return this._ready; }
-  get userSig(): string | null { return this._credentials?.userSig ?? null; }
-
-  /**
-   * Connect to TIM SDK using verified credentials.
-   */
-  async connect(credentials: TIMCredentials): Promise<void> {
-    this._agentId = credentials.userId;
-    this._credentials = credentials;
-
-    logger.info(`[tim/client] Connecting agentId=${this._agentId}`);
-
-    // Create SDK instance
-    this.chat = TencentCloudChat.create({
-      SDKAppID: credentials.sdkAppId,
-      modules: { 'group-module': GroupModule },
-    });
-    this.chat.setLogLevel(0); // ALL logs — WebSocket heartbeat, transport, message push (P0-A diagnosis)
-
-    // Register tim-upload-plugin — enables createFileMessage/sendMessage for T4 file transfer
-    // Must be after create(), before login(). SDK_READY triggers UploadModule._init() which looks up this plugin.
-    // @see docs/audit/023-tim-upload-plugin-v1.md §4.7
-    this.chat.registerPlugin({ 'tim-upload-plugin': TIMUploadPlugin });
-    logger.info('[tim/client] tim-upload-plugin registered');
-
-    // Wait for SDK_READY with guaranteed timer cleanup
-    let readyTimeout: ReturnType<typeof setTimeout>;
-    const sdkReadyPromise = new Promise<void>((resolve, reject) => {
-      readyTimeout = setTimeout(
-        () => reject(new Error('SDK_READY timeout (15s)')),
-        15_000,
-      );
-      this.chat!.on(TencentCloudChat.EVENT.SDK_READY, () => {
-        clearTimeout(readyTimeout);
-        this._ready = true;
-        resolve();
-      });
-    });
-
-    // Register event listeners
-    this._registerListeners();
-
-    logger.info('[tim/client] Calling TIM SDK login...');
-    try {
-      await this.chat.login({
-        userID: credentials.userId,
-        userSig: credentials.userSig,
-      });
-      await sdkReadyPromise;
-    } catch (err) {
-      clearTimeout(readyTimeout!);
-      this._ready = false;
-      throw err;
-    }
-
-    logger.info('[tim/client] SDK_READY — connected');
-  }
-
-  /**
-   * Gracefully disconnect from TIM SDK.
-   */
-  async disconnect(): Promise<void> {
-    this._reconnecting = false;
-    if (this.chat) {
-      try { await this.chat.logout(); } catch { /* ignore */ }
-      this._ready = false;
-      this._removeListeners();
-      this.chat = null;
-    }
-  }
-
-  // ── Event Listeners ──
-
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  private _messageHandler: ((...args: any[]) => void) | null = null;
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  private _notReadyHandler: ((...args: any[]) => void) | null = null;
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  private _kickedHandler: ((...args: any[]) => void) | null = null;
-
-  private _registerListeners(): void {
-    if (!this.chat) {
-      logger.error('[tim/client] _registerListeners: chat instance is null, cannot register');
-      return;
-    }
-    logger.info('[tim/client] _registerListeners: installing SDK event handlers');
-
-    // Disconnect detection
-    this._notReadyHandler = () => {
-      logger.warn('[tim/client] SDK_NOT_READY — connection lost');
-      this._ready = false;
-      void this._autoReconnect();
-    };
-    this.chat.on(TencentCloudChat.EVENT.SDK_NOT_READY, this._notReadyHandler);
-
-    this._kickedHandler = (event: unknown) => {
-      const ev = event as { data?: { type?: string } } | undefined;
-      const reason = ev?.data?.type || 'unknown';
-      logger.warn(`[tim/client] KICKED_OUT (reason=${reason})`);
-      this._ready = false;
-
-      switch (reason) {
-        case 'multipleDevice':
-        case 'multipleAccount':
-          // Multi-device/page kick: do NOT reconnect to avoid kick loop
-          logger.warn('[tim/client] Kicked by multi-device/account login, will not reconnect');
-          break;
-
-        case 'userSigExpired':
-          // UserSig expired: old credentials are useless, notify upper layer
-          logger.warn('[tim/client] UserSig expired, emitting credential_expired event');
-          this.emit('credential_expired');
-          break;
-
-        case 'REST_API_Kick':
-        default:
-          // REST API kick or unknown: reconnect with existing credentials
-          void this._autoReconnect();
-          break;
-      }
-    };
-    this.chat.on(TencentCloudChat.EVENT.KICKED_OUT, this._kickedHandler);
-
-    // Push message listener
-    this._messageHandler = (event: unknown) => {
-      const ev = event as { data: unknown[] };
-      const messages = ev.data as Array<{
-        conversationType: string;
-        type?: string;
-        from: string;
-        to: string;
-        sequence: number;
-        nick?: string;
-        time: number;
-        payload?: { text?: string; data?: string; description?: string; extension?: string };
-        atUserList?: string[];
-      }>;
-
-      logger.info(`[tim/client] MESSAGE_RECEIVED fired: ${messages?.length ?? 0} message(s)`);
-
-      if (!messages || messages.length === 0) {
-        logger.warn('[tim/client] MESSAGE_RECEIVED: empty data array, nothing to process');
-        return;
-      }
-
-      for (const msg of messages) {
-        try {
-          // ── C2C messages → emit for c2c.ts handler, skip group logic ──
-          if (msg.conversationType === TencentCloudChat.TYPES.CONV_C2C) {
-            logger.info(`[tim/client] C2C msg from=${msg.from}`);
-            this.emit('c2c_message', {
-              from: msg.from,
-              payload: msg.payload,
-              type: msg.type,
-              time: msg.time,
-            });
-            continue;
-          }
-
-          // Only group messages
-          if (msg.conversationType !== TencentCloudChat.TYPES.CONV_GROUP) {
-            logger.debug(`[tim/client] skip non-group msg type=${msg.conversationType} from=${msg.from}`);
-            continue;
-          }
-          // Skip own messages
-          if (msg.from === this._agentId) {
-            logger.debug(`[tim/client] skip self msg from=${msg.from} to=${msg.to}`);
-            continue;
-          }
-
-          const text = msg.payload?.text || '';
-          if (!text) {
-            logger.debug(`[tim/client] skip empty text msg from=${msg.from} to=${msg.to}`);
-            continue;
-          }
-
-          const channelId = msg.to;
-          const seq = msg.sequence;
-
-          const rawMessage: RawPushMessage = {
-            id: `${channelId}:${seq}`,
-            channelId,
-            seq,
-            from: msg.from,
-            nick: msg.nick || msg.from,
-            text,
-            time: msg.time * 1000,
-            mentionsMe: Array.isArray(msg.atUserList)
-              && (msg.atUserList.includes(this._agentId)
-                  || msg.atUserList.includes(TencentCloudChat.TYPES.MSG_AT_ALL)),
-            source: 'push',
-          };
-
-          logger.debug(`[tim/client] PUSH msg id=${rawMessage.id} ch=${channelId} from=${rawMessage.nick}`);
-          this.emit('message', rawMessage);
-        } catch (err) {
-          logger.debug(`[tim/client] Error processing push message: ${(err as Error).message}`);
-        }
-      }
-    };
-    this.chat.on(TencentCloudChat.EVENT.MESSAGE_RECEIVED, this._messageHandler);
-  }
-
-  private _removeListeners(): void {
-    if (!this.chat) return;
-    if (this._notReadyHandler) {
-      this.chat.off(TencentCloudChat.EVENT.SDK_NOT_READY, this._notReadyHandler);
-      this._notReadyHandler = null;
-    }
-    if (this._kickedHandler) {
-      this.chat.off(TencentCloudChat.EVENT.KICKED_OUT, this._kickedHandler);
-      this._kickedHandler = null;
-    }
-    if (this._messageHandler) {
-      this.chat.off(TencentCloudChat.EVENT.MESSAGE_RECEIVED, this._messageHandler);
-      this._messageHandler = null;
-    }
-  }
-
-  // ── Auto-reconnect ──
-
-  private async _autoReconnect(maxRetries = 5): Promise<void> {
-    if (this._reconnecting) {
-      logger.debug('[tim/client] Reconnect already in progress');
-      return;
-    }
-    if (!this._credentials) {
-      logger.error('[tim/client] Cannot reconnect: missing credentials');
-      return;
-    }
-
-    this._reconnecting = true;
-    logger.warn('[tim/client] Starting auto-reconnect...');
-
-    for (let attempt = 1; attempt <= maxRetries; attempt++) {
-      if (!this._reconnecting) {
-        logger.info('[tim/client] Reconnect cancelled');
-        return;
-      }
-
-      const delay = Math.min(5000 * attempt, 25_000);
-      logger.info(`[tim/client] Reconnect attempt ${attempt}/${maxRetries} in ${delay / 1000}s...`);
-      await new Promise(r => setTimeout(r, delay));
-
-      try {
-        // Teardown old SDK instance
-        if (this.chat) {
-          this._removeListeners();
-          try { await this.chat.logout(); } catch { /* ignore */ }
-          this.chat = null;
-        }
-        this._ready = false;
-
-        await this.connect(this._credentials);
-
-        if (this._ready) {
-          logger.info(`[tim/client] Auto-reconnect successful on attempt ${attempt}`);
-          this._reconnecting = false;
-          this.emit('reconnected');
-          return;
-        }
-      } catch (err) {
-        logger.error(`[tim/client] Reconnect attempt ${attempt}/${maxRetries} failed: ${(err as Error).message}`);
-      }
-    }
-
-    this._reconnecting = false;
-    logger.error(`[tim/client] All ${maxRetries} reconnect attempts failed`);
-  }
-
-  // ── Internal SDK access (for messages.ts and channels.ts) ──
-
-  /** @internal */
-  get _chat(): ReturnType<typeof TencentCloudChat.create> | null {
-    return this.chat;
-  }
-
-  /** @internal */
-  get _types(): typeof TencentCloudChat.TYPES {
-    return TencentCloudChat.TYPES;
-  }
-}

package/src/tim/index.ts

@@ -1,18 +0,0 @@
-/**
- * TIM — Module barrel export
- */
-
-export { TIMClient, type RawPushMessage } from './client.js';
-export { sendMessage, fetchMessages, mapToHistoryMessage, type HistoryMessage, type SendResult } from './messages.js';
-export {
-  listChannels,
-  searchChannels,
-  joinChannel,
-  leaveChannel,
-  getMembers,
-  createChannel,
-  getChannelSkill,
-  setChannelSkill,
-  type ChannelInfo,
-  type MemberInfo,
-} from './channels.js';