openclaw-openagent 1.0.13 → 1.0.14

package/src/transport/tim/tim-transport.ts

@@ -1,515 +0,0 @@
-/**
- * TimTransport —— 把现有 TIM SDK 代码封装到 AgentTransport 接口背后
- *
- * 设计依据：docs/specs/2026-06-16-oasn-transport-abstraction-design.md §2.3
- *
- * 实现策略：
- *   - 直接复用现有 `src/tim/{client,c2c,messages,channels}.ts` 模块（不复制粘贴）
- *   - 内部持有自己的 TIMClient 实例，不依赖 `runtime/registry`
- *   - `sendC2CCustomMessage` 在 transport 内部就地重新实现一份（不用 registry），
- *     避免 c2c.ts 中的 `registry.getDefault()` 反向依赖运行时
- *   - waitForC2CReply / 进度回调走原版 pendingRequests Map（c2c.ts 模块级单例 OK，
- *     因为 TimTransport 同进程只会有一个 active 实例）
- *
- * 不实现的方法：
- *   - registerAgent / claimAgent / updateAgentCard / uploadFile / downloadArtifact
- *     这些是 OASN-only，TimTransport 不在能力接口里声明，调用方需先 narrow 类型。
- *
- * 注：当前是「在 openagent 基础上原地改造」，所以 TIM 代码仍存于 src/tim/ 而非 src/transport/tim/。
- * 等独立 npm 包发布时再做物理迁移。
- */
-
-import { EventEmitter } from 'node:events';
-
-import { logger } from '../../util/logger.js';
-import { TIMClient } from '../../tim/client.js';
-import {
-  initC2CHandler,
-  waitForC2CReply,
-  type C2CMessagePayload,
-} from '../../tim/c2c.js';
-import {
-  sendMessage as timSendMessage,
-  fetchMessages as timFetchMessages,
-} from '../../tim/messages.js';
-import {
-  listChannels as timListChannels,
-  searchChannels as timSearchChannels,
-  joinChannel as timJoinChannel,
-  leaveChannel as timLeaveChannel,
-  getMembers as timGetMembers,
-  createChannel as timCreateChannel,
-  getChannelSkill as timGetChannelSkill,
-  setChannelSkill as timSetChannelSkill,
-} from '../../tim/channels.js';
-import type { TIMCredentials } from '../../auth/verify.js';
-
-import type {
-  AgentCard,
-  CategoryTree,
-  ChannelInfo,
-  CoreTransportEvent,
-  MemberInfo,
-  ProgressCallback,
-  SearchQuery,
-  SearchResult,
-  TaskHandle,
-  TaskHandler,
-  TaskRequest,
-  TaskResult,
-  TimOnlyTransportEvent,
-  TimTransport,
-  TransportCredentials,
-  TransportMessage,
-} from '../types.js';
-import { makeTransportError } from '../types.js';
-
-// 内部 SDK 引用 —— 仅用于 sendC2CCustomMessage 重新实现
-// （把 c2c.ts 中依赖 registry 的部分搬到 transport 内）
-// @ts-ignore — vendor JS module, typed as unknown
-import TencentCloudChat from '../../sdk/index.js';
-
-// ───────────────────────────────────────────────────────────────
-// 构造参数
-// ───────────────────────────────────────────────────────────────
-
-export interface TimTransportInitOptions {
-  /** 实例 id（多账户场景区分用） */
-  accountId: string;
-}
-
-// ───────────────────────────────────────────────────────────────
-// 实现类
-// ───────────────────────────────────────────────────────────────
-
-/**
- * TimTransport 具体实现。
- *
- * 事件路由：
- *   - TIMClient 的 'message' / 'c2c_request' / 'credential_expired' / 'reconnected'
- *     在此处转发为 TransportEvent（'message' / 'task_received' / 'credential_expired' / 'reconnected'）
- *   - 'task_progress' 不通过 EventEmitter 触发 —— C2C 进度走 c2c.ts 的 pendingRequests
- *     回调（waitForC2CReply 的 onProgress 参数），与 sendTask 调用方直接绑定
- */
-export class TimTransportImpl extends EventEmitter implements TimTransport {
-  readonly transportType = 'tim' as const;
-  readonly id: string;
-
-  private _client: TIMClient | null = null;
-  /** 用户注册的 T3 任务处理器（onTaskReceived） */
-  private _taskHandler: TaskHandler | null = null;
-  /** 当前是否就绪（= TIMClient SDK_READY） */
-  private _isReady = false;
-
-  constructor(options: TimTransportInitOptions) {
-    super();
-    this.id = options.accountId;
-  }
-
-  get isReady(): boolean {
-    return this._isReady && (this._client?.isReady ?? false);
-  }
-
-  // ─────────────────────────────────────────────────────────────
-  // CoreTransport
-  // ─────────────────────────────────────────────────────────────
-
-  /**
-   * 验证凭证并登录 TIM SDK。
-   *
-   * TransportCredentials → TIMCredentials 字段映射：
-   *   identity → userId
-   *   token    → userSig
-   *   注：sdkAppId 来自外部 verify 接口结果，但在 AccountRuntime 拼装时
-   *   会通过 TransportCredentials 之外的"已知字段"传入 —— 实际我们走旧逻辑：
-   *   credentials 直接是 TIMCredentials 子集 + sdkAppId 通过 verify 返回的结构。
-   *
-   * 为了类型安全，本方法接收的 credentials **必须**额外带 sdkAppId（通过
-   * TIM-专属扩展类型 TimCredentialsExt 传入，详见 _resolveCredentials in account.ts）。
-   */
-  async ready(credentials: TransportCredentials): Promise<void> {
-    // 从扩展字段中读取 sdkAppId（仅 TIM 路径会传入）
-    const sdkAppId = (credentials as TransportCredentials & { sdkAppId?: number }).sdkAppId;
-    if (!sdkAppId) {
-      throw makeTransportError(
-        'TIM_MISSING_SDK_APP_ID',
-        'TimTransport.ready: credentials missing sdkAppId (TIM-specific field)',
-      );
-    }
-
-    const timCreds: TIMCredentials = {
-      sdkAppId,
-      userSig: credentials.token,
-      userId: credentials.identity,
-      // expire 是相对秒数（TIM 约定），而 TransportCredentials.expiresAt 是绝对 epoch ms。
-      // 这里换算回相对秒数（最低 1 小时，避免 0）。
-      expire: credentials.expiresAt > 0
-        ? Math.max(3600, Math.floor((credentials.expiresAt - Date.now()) / 1000))
-        : 604800,
-    };
-
-    // 创建并连接 TIMClient
-    this._client = new TIMClient();
-
-    // SDK 'credential_expired' → transport 'credential_expired'（核心事件）
-    this._client.on('credential_expired', () => {
-      logger.warn(`[transport/tim] credential_expired emitted (account=${this.id})`);
-      this._isReady = false;
-      this.emit('credential_expired');
-    });
-
-    // SDK 'reconnected' → transport 'reconnected'
-    this._client.on('reconnected', () => {
-      logger.info(`[transport/tim] reconnected (account=${this.id})`);
-      this._isReady = true;
-      this.emit('reconnected');
-    });
-
-    // 群聊消息 → transport 'message'（仅 TIM-only 订阅者收到）
-    this._client.on('message', (msg) => {
-      // 适配 RawPushMessage → TransportMessage（字段语义一致）
-      const transportMsg: TransportMessage = {
-        id: msg.id,
-        channelId: msg.channelId,
-        from: msg.from,
-        nick: msg.nick,
-        text: msg.text,
-        time: msg.time,
-        mentionsMe: msg.mentionsMe,
-      };
-      this.emit('message', transportMsg);
-    });
-
-    // C2C 入站任务请求 → transport 'task_received'（T3 路径）
-    // initC2CHandler 注册了 c2c.ts 内部的 pendingRequests 监听 +
-    // 'c2c_request' 自定义事件（task_request 类型转发）
-    this._client.on('c2c_request', (raw: {
-      from: string;
-      payload: { request_id: string; task: string; session_mode: string };
-      time: number;
-    }) => {
-      const req: TaskRequest & { from: string } = {
-        from: raw.from,
-        requestId: raw.payload.request_id,
-        task: raw.payload.task,
-      };
-      // 优先调用注册的 TaskHandler；同时 emit 事件给那些只想旁听的订阅者
-      this.emit('task_received', req);
-      if (this._taskHandler) {
-        // 异步处理，不阻塞 c2c handler
-        this._invokeTaskHandler(req).catch((err) =>
-          logger.error(`[transport/tim] task handler error: ${(err as Error).message}`),
-        );
-      }
-    });
-
-    // 实际登录
-    await this._client.connect(timCreds);
-
-    // 初始化 C2C 消息处理器（解析 task_request/progress/result 自定义消息）
-    initC2CHandler(this._client);
-
-    this._isReady = true;
-    logger.info(`[transport/tim] ready (account=${this.id} agentId=${credentials.identity})`);
-  }
-
-  async dispose(): Promise<void> {
-    this._isReady = false;
-    if (this._client) {
-      try {
-        await this._client.disconnect();
-      } catch (err) {
-        logger.warn(`[transport/tim] disconnect error: ${(err as Error).message}`);
-      }
-      this._client = null;
-    }
-    this.removeAllListeners();
-  }
-
-  // EventEmitter.on 已经支持 string；这里只是收窄类型，让上层只能订阅
-  // CoreTransportEvent | TimOnlyTransportEvent。
-  override on(
-    event: CoreTransportEvent | TimOnlyTransportEvent,
-    handler: (...args: any[]) => void,
-  ): this {
-    return super.on(event, handler);
-  }
-
-  override off(
-    event: CoreTransportEvent | TimOnlyTransportEvent,
-    handler: (...args: any[]) => void,
-  ): this {
-    return super.off(event, handler);
-  }
-
-  // ─────────────────────────────────────────────────────────────
-  // TaskTransport
-  // ─────────────────────────────────────────────────────────────
-
-  /**
-   * 发送 C2C 任务请求。
-   *
-   * TIM C2C 无独立的 invocation 概念，所以 TaskHandle.invocationId = requestId。
-   * sessionId / effectiveTimeoutMs 字段 undefined。
-   */
-  async sendTask(targetAgentId: string, task: TaskRequest): Promise<TaskHandle> {
-    this._ensureReady();
-    const payload: C2CMessagePayload = {
-      type: 'openagent_task_request',
-      request_id: task.requestId,
-      task: task.task,
-      session_mode: 'default',
-    };
-    await this._sendC2CCustom(targetAgentId, payload);
-    return {
-      invocationId: task.requestId,
-      // sessionId / effectiveTimeoutMs 故意不返回
-    };
-  }
-
-  /**
-   * 等待 C2C 回复（task_progress + task_result）。
-   * 进度回调通过 c2c.ts 的 pendingRequests 注册。
-   */
-  async waitForTaskResult(
-    handle: TaskHandle,
-    options: { timeoutMs: number; signal?: AbortSignal; onProgress?: ProgressCallback },
-  ): Promise<TaskResult> {
-    const reply = await waitForC2CReply(handle.invocationId, {
-      timeoutMs: options.timeoutMs,
-      signal: options.signal,
-      onProgress: options.onProgress
-        ? (content: string) => options.onProgress!({
-            requestId: handle.invocationId,
-            content,
-          })
-        : undefined,
-    });
-
-    // mediaUrls (本地文件路径) → ArtifactRef[]
-    // 注：TIM 路径走的是本地磁盘路径，contentUrl 直接是 file:// 风格的本地路径，
-    // 上层 remote-agent-tool.ts 知道如何处理（fs.readFile 而非 fetch）。
-    const artifacts = reply.mediaUrls?.map((path, idx) => ({
-      id: `tim-file-${idx}`,
-      displayName: path.split('/').pop() ?? `file-${idx}`,
-      mimeType: 'application/octet-stream',
-      sizeBytes: 0,
-      contentAvailable: true,
-      contentUrl: path,
-    }));
-
-    return {
-      requestId: handle.invocationId,
-      status: reply.status,
-      content: reply.content,
-      ...(artifacts && artifacts.length > 0 ? { artifacts } : {}),
-    };
-  }
-
-  // ─────────────────────────────────────────────────────────────
-  // DiscoveryTransport（TIM 把 channel 列表伪装成 AgentCard）
-  // ─────────────────────────────────────────────────────────────
-
-  async searchAgents(query: SearchQuery): Promise<SearchResult> {
-    this._ensureReady();
-    const channels = query.query
-      ? await timSearchChannels(this._client!, query.query)
-      : await timListChannels(this._client!);
-
-    const cards: AgentCard[] = channels.map((ch) => ({
-      agent_id: ch.id,
-      agent_type: 'service',
-      name: ch.name,
-      description: ch.desc,
-      MOM: null,
-      tags: [],
-      category: [],
-      avatar_url: null,
-    }));
-
-    return {
-      searchId: `tim-search-${Date.now()}`,
-      agentCards: cards,
-      pageNum: 1,
-      pageSize: cards.length,
-      hasNext: false,
-    };
-  }
-
-  async getAgent(agentId: string): Promise<AgentCard | null> {
-    // TIM 没有 AgentCard 概念，按 channelId 反查（如果是 channel id）
-    this._ensureReady();
-    const all = await timListChannels(this._client!);
-    const ch = all.find((c) => c.id === agentId);
-    if (!ch) return null;
-    return {
-      agent_id: ch.id,
-      agent_type: 'service',
-      name: ch.name,
-      description: ch.desc,
-      MOM: null,
-      tags: [],
-      category: [],
-      avatar_url: null,
-    };
-  }
-
-  /** TIM 没有 category 概念，返回空树 */
-  async getCategories(): Promise<CategoryTree> {
-    return { categories: [], updated_at: new Date().toISOString() };
-  }
-
-  // ─────────────────────────────────────────────────────────────
-  // IMChannelTransport（TIM-only）
-  // ─────────────────────────────────────────────────────────────
-
-  onTaskReceived(handler: TaskHandler): void {
-    this._taskHandler = handler;
-  }
-
-  async sendGroupMessage(
-    channelId: string,
-    text: string,
-    atUserList?: string[],
-  ): Promise<{ ok: boolean; messageId: string }> {
-    this._ensureReady();
-    return timSendMessage(this._client!, channelId, text, atUserList);
-  }
-
-  async fetchGroupHistory(channelId: string, count = 20): Promise<TransportMessage[]> {
-    this._ensureReady();
-    const msgs = await timFetchMessages(this._client!, channelId, count);
-    return msgs.map((m) => ({
-      id: m.id,
-      channelId,
-      from: m.from,
-      nick: m.from,
-      text: m.text,
-      time: m.time,
-      mentionsMe: false,
-    }));
-  }
-
-  // 频道管理（DORMANT，接口保留）
-  async listChannels(): Promise<ChannelInfo[]> {
-    this._ensureReady();
-    return timListChannels(this._client!);
-  }
-  async searchChannels(keyword: string): Promise<ChannelInfo[]> {
-    this._ensureReady();
-    return timSearchChannels(this._client!, keyword);
-  }
-  async joinChannel(channelId: string) {
-    this._ensureReady();
-    return timJoinChannel(this._client!, channelId);
-  }
-  async leaveChannel(channelId: string) {
-    this._ensureReady();
-    return timLeaveChannel(this._client!, channelId);
-  }
-  async getMembers(channelId: string): Promise<MemberInfo[]> {
-    this._ensureReady();
-    return timGetMembers(this._client!, channelId);
-  }
-  async createChannel(name: string, desc?: string) {
-    this._ensureReady();
-    return timCreateChannel(this._client!, name, desc);
-  }
-  async getChannelSkill(channelId: string) {
-    this._ensureReady();
-    return timGetChannelSkill(this._client!, channelId);
-  }
-  async setChannelSkill(channelId: string, skill: string) {
-    this._ensureReady();
-    return timSetChannelSkill(this._client!, channelId, skill);
-  }
-
-  // ─────────────────────────────────────────────────────────────
-  // 内部工具
-  // ─────────────────────────────────────────────────────────────
-
-  /** 暴露底层 TIMClient 给老代码兼容（如 src/runtime/registry 等） */
-  get _internalClient(): TIMClient | null {
-    return this._client;
-  }
-
-  private _ensureReady(): void {
-    if (!this.isReady || !this._client) {
-      throw makeTransportError('TRANSPORT_NOT_READY', 'TimTransport not ready');
-    }
-  }
-
-  /**
-   * sendC2CCustomMessage 的 transport-local 实现。
-   * 不走 runtime/registry —— 直接用 this._client 持有的 SDK 实例。
-   *
-   * 与 src/tim/c2c.ts 中的同名函数行为等价（含 10s SDK guard），
-   * 但避免了"transport 反向依赖 runtime"。
-   */
-  private async _sendC2CCustom(
-    userId: string,
-    payload: C2CMessagePayload,
-  ): Promise<void> {
-    this._ensureReady();
-    const chat = this._client!._chat;
-    const types = this._client!._types;
-    if (!chat) {
-      throw makeTransportError('TIM_SDK_NULL', 'TIM SDK not initialized');
-    }
-    const message = chat.createCustomMessage({
-      to: userId,
-      conversationType: types.CONV_C2C,
-      payload: {
-        data: JSON.stringify(payload),
-        description: payload.type,
-        extension: '',
-      },
-    });
-
-    // 10s SDK-call guard：避免死 WebSocket 让 Tool 永久阻塞
-    let timeoutHandle: ReturnType<typeof setTimeout>;
-    const timeoutPromise = new Promise<never>((_, reject) => {
-      timeoutHandle = setTimeout(
-        () => reject(new Error(`sendC2CCustomMessage timeout (10s) to=${userId}`)),
-        10_000,
-      );
-    });
-
-    try {
-      await Promise.race([chat.sendMessage(message), timeoutPromise]);
-      logger.info(`[transport/tim] C2C sent: to=${userId} type=${payload.type}`);
-    } finally {
-      clearTimeout(timeoutHandle!);
-    }
-  }
-
-  /** 调用注册的 TaskHandler 并把结果通过 C2C 回写给请求方 */
-  private async _invokeTaskHandler(req: TaskRequest & { from: string }): Promise<void> {
-    if (!this._taskHandler) return;
-    try {
-      const result = await this._taskHandler(req);
-      await this._sendC2CCustom(req.from, {
-        type: 'openagent_task_result',
-        request_id: result.requestId,
-        status: result.status,
-        content: result.content,
-      });
-    } catch (err) {
-      logger.error(`[transport/tim] _invokeTaskHandler failed: ${(err as Error).message}`);
-      // 即使 handler 失败也回写 error 结果，避免对方永久阻塞
-      try {
-        await this._sendC2CCustom(req.from, {
-          type: 'openagent_task_result',
-          request_id: req.requestId,
-          status: 'error',
-          content: (err as Error).message,
-        });
-      } catch {
-        /* swallow，已经记日志了 */
-      }
-    }
-  }
-}
-
-// 引用未使用的导入做编译期检查，避免 lint 报 unused
-void TencentCloudChat;