openclaw-openagent 1.0.1 → 1.0.3

package/dist/src/transport/oasn/oasn-types.js

@@ -0,0 +1,44 @@
+/**
+ * OASN API 请求/响应类型定义
+ *
+ * 设计依据：
+ *   - docs/specs/2026-06-16-oasn-api-module-mapping.md
+ *   - oasn-01-onboarding/apis.md（agent / claim / auth / agent-card / discovery）
+ *   - oasn-02-access-layer/apis.md（invocation / file / artifact）
+ *
+ * 这些类型仅在 OASN transport 内部使用，对外暴露的通用类型在 src/transport/types.ts。
+ * onboarding controller 的 Java record 当前使用 camelCase 请求/响应字段；
+ * transport 层兼容历史 snake_case 响应，并对外归一到 src/transport/types.ts 的稳定模型。
+ */
+/** 是否进入终态（停止轮询） */
+export function isInvocationTerminal(status) {
+    return status === 'succeeded'
+        || status === 'failed'
+        || status === 'timed_out'
+        || status === 'cancelled';
+}
+// ═══════════════════════════════════════════════════════════════
+// 端点常量
+// ═══════════════════════════════════════════════════════════════
+/** OASN HTTP 端点路径（相对于 api_base） */
+export const OASN_ENDPOINTS = {
+    // Agent
+    REGISTER: '/api/agents/register',
+    CLAIM: '/api/agents/claim',
+    AGENT_STATUS: (agentId) => `/api/agents/${encodeURIComponent(agentId)}`,
+    // AgentCard
+    AGENT_CARD: (agentId) => `/api/agent-cards/${encodeURIComponent(agentId)}`,
+    // Discovery
+    CATEGORIES: '/api/agent-card-categories',
+    SEARCH_BY_QUERY: '/api/agent-cards/search/by-query',
+    SEARCH_BY_CATEGORY: '/api/agent-cards/search/by-category',
+    SEARCH_BY_TAGS: '/api/agent-cards/search/by-tags',
+    // Invocation
+    INVOCATIONS: '/api/invocations',
+    INVOCATION: (id) => `/api/invocations/${encodeURIComponent(id)}`,
+    // File / Artifact
+    FILES: '/api/files',
+    ARTIFACT_CONTENT: (id) => `/api/artifacts/${encodeURIComponent(id)}/content`,
+    // Owner
+    USERS_ME: '/api/users/me',
+};

package/dist/src/transport/tim/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * TimTransport 模块导出
+ *
+ * 设计依据：docs/specs/2026-06-16-oasn-transport-abstraction-design.md §3.1
+ */
+export { TimTransportImpl } from './tim-transport.js';
+export type { TimTransportInitOptions } from './tim-transport.js';

package/dist/src/transport/tim/index.js

@@ -0,0 +1,6 @@
+/**
+ * TimTransport 模块导出
+ *
+ * 设计依据：docs/specs/2026-06-16-oasn-transport-abstraction-design.md §3.1
+ */
+export { TimTransportImpl } from './tim-transport.js';

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

@@ -0,0 +1,122 @@
+/**
+ * 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 { TIMClient } from '../../tim/client.js';
+import type { AgentCard, CategoryTree, ChannelInfo, CoreTransportEvent, MemberInfo, ProgressCallback, SearchQuery, SearchResult, TaskHandle, TaskHandler, TaskRequest, TaskResult, TimOnlyTransportEvent, TimTransport, TransportCredentials, TransportMessage } from '../types.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 declare class TimTransportImpl extends EventEmitter implements TimTransport {
+    readonly transportType: "tim";
+    readonly id: string;
+    private _client;
+    /** 用户注册的 T3 任务处理器（onTaskReceived） */
+    private _taskHandler;
+    /** 当前是否就绪（= TIMClient SDK_READY） */
+    private _isReady;
+    constructor(options: TimTransportInitOptions);
+    get isReady(): boolean;
+    /**
+     * 验证凭证并登录 TIM SDK。
+     *
+     * TransportCredentials → TIMCredentials 字段映射：
+     *   identity → userId
+     *   token    → userSig
+     *   注：sdkAppId 来自外部 verify 接口结果，但在 AccountRuntime 拼装时
+     *   会通过 TransportCredentials 之外的"已知字段"传入 —— 实际我们走旧逻辑：
+     *   credentials 直接是 TIMCredentials 子集 + sdkAppId 通过 verify 返回的结构。
+     *
+     * 为了类型安全，本方法接收的 credentials **必须**额外带 sdkAppId（通过
+     * TIM-专属扩展类型 TimCredentialsExt 传入，详见 _resolveCredentials in account.ts）。
+     */
+    ready(credentials: TransportCredentials): Promise<void>;
+    dispose(): Promise<void>;
+    on(event: CoreTransportEvent | TimOnlyTransportEvent, handler: (...args: any[]) => void): this;
+    off(event: CoreTransportEvent | TimOnlyTransportEvent, handler: (...args: any[]) => void): this;
+    /**
+     * 发送 C2C 任务请求。
+     *
+     * TIM C2C 无独立的 invocation 概念，所以 TaskHandle.invocationId = requestId。
+     * sessionId / effectiveTimeoutMs 字段 undefined。
+     */
+    sendTask(targetAgentId: string, task: TaskRequest): Promise<TaskHandle>;
+    /**
+     * 等待 C2C 回复（task_progress + task_result）。
+     * 进度回调通过 c2c.ts 的 pendingRequests 注册。
+     */
+    waitForTaskResult(handle: TaskHandle, options: {
+        timeoutMs: number;
+        signal?: AbortSignal;
+        onProgress?: ProgressCallback;
+    }): Promise<TaskResult>;
+    searchAgents(query: SearchQuery): Promise<SearchResult>;
+    getAgent(agentId: string): Promise<AgentCard | null>;
+    /** TIM 没有 category 概念，返回空树 */
+    getCategories(): Promise<CategoryTree>;
+    onTaskReceived(handler: TaskHandler): void;
+    sendGroupMessage(channelId: string, text: string, atUserList?: string[]): Promise<{
+        ok: boolean;
+        messageId: string;
+    }>;
+    fetchGroupHistory(channelId: string, count?: number): Promise<TransportMessage[]>;
+    listChannels(): Promise<ChannelInfo[]>;
+    searchChannels(keyword: string): Promise<ChannelInfo[]>;
+    joinChannel(channelId: string): Promise<{
+        success: boolean;
+        message: string;
+    }>;
+    leaveChannel(channelId: string): Promise<{
+        success: boolean;
+        message: string;
+    }>;
+    getMembers(channelId: string): Promise<MemberInfo[]>;
+    createChannel(name: string, desc?: string): Promise<{
+        success: boolean;
+        channelId: string;
+    }>;
+    getChannelSkill(channelId: string): Promise<string | null>;
+    setChannelSkill(channelId: string, skill: string): Promise<{
+        success: boolean;
+    }>;
+    /** 暴露底层 TIMClient 给老代码兼容（如 src/runtime/registry 等） */
+    get _internalClient(): TIMClient | null;
+    private _ensureReady;
+    /**
+     * sendC2CCustomMessage 的 transport-local 实现。
+     * 不走 runtime/registry —— 直接用 this._client 持有的 SDK 实例。
+     *
+     * 与 src/tim/c2c.ts 中的同名函数行为等价（含 10s SDK guard），
+     * 但避免了"transport 反向依赖 runtime"。
+     */
+    private _sendC2CCustom;
+    /** 调用注册的 TaskHandler 并把结果通过 C2C 回写给请求方 */
+    private _invokeTaskHandler;
+}

package/dist/src/transport/tim/tim-transport.js

@@ -0,0 +1,402 @@
+/**
+ * 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, } 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 { makeTransportError } from '../types.js';
+// 内部 SDK 引用 —— 仅用于 sendC2CCustomMessage 重新实现
+// （把 c2c.ts 中依赖 registry 的部分搬到 transport 内）
+// @ts-ignore — vendor JS module, typed as unknown
+import TencentCloudChat from '../../sdk/index.js';
+// ───────────────────────────────────────────────────────────────
+// 实现类
+// ───────────────────────────────────────────────────────────────
+/**
+ * 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 {
+    transportType = 'tim';
+    id;
+    _client = null;
+    /** 用户注册的 T3 任务处理器（onTaskReceived） */
+    _taskHandler = null;
+    /** 当前是否就绪（= TIMClient SDK_READY） */
+    _isReady = false;
+    constructor(options) {
+        super();
+        this.id = options.accountId;
+    }
+    get isReady() {
+        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) {
+        // 从扩展字段中读取 sdkAppId（仅 TIM 路径会传入）
+        const sdkAppId = credentials.sdkAppId;
+        if (!sdkAppId) {
+            throw makeTransportError('TIM_MISSING_SDK_APP_ID', 'TimTransport.ready: credentials missing sdkAppId (TIM-specific field)');
+        }
+        const timCreds = {
+            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 = {
+                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) => {
+            const req = {
+                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.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() {
+        this._isReady = false;
+        if (this._client) {
+            try {
+                await this._client.disconnect();
+            }
+            catch (err) {
+                logger.warn(`[transport/tim] disconnect error: ${err.message}`);
+            }
+            this._client = null;
+        }
+        this.removeAllListeners();
+    }
+    // EventEmitter.on 已经支持 string；这里只是收窄类型，让上层只能订阅
+    // CoreTransportEvent | TimOnlyTransportEvent。
+    on(event, handler) {
+        return super.on(event, handler);
+    }
+    off(event, handler) {
+        return super.off(event, handler);
+    }
+    // ─────────────────────────────────────────────────────────────
+    // TaskTransport
+    // ─────────────────────────────────────────────────────────────
+    /**
+     * 发送 C2C 任务请求。
+     *
+     * TIM C2C 无独立的 invocation 概念，所以 TaskHandle.invocationId = requestId。
+     * sessionId / effectiveTimeoutMs 字段 undefined。
+     */
+    async sendTask(targetAgentId, task) {
+        this._ensureReady();
+        const payload = {
+            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, options) {
+        const reply = await waitForC2CReply(handle.invocationId, {
+            timeoutMs: options.timeoutMs,
+            signal: options.signal,
+            onProgress: options.onProgress
+                ? (content) => 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) {
+        this._ensureReady();
+        const channels = query.query
+            ? await timSearchChannels(this._client, query.query)
+            : await timListChannels(this._client);
+        const cards = 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) {
+        // 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() {
+        return { categories: [], updated_at: new Date().toISOString() };
+    }
+    // ─────────────────────────────────────────────────────────────
+    // IMChannelTransport（TIM-only）
+    // ─────────────────────────────────────────────────────────────
+    onTaskReceived(handler) {
+        this._taskHandler = handler;
+    }
+    async sendGroupMessage(channelId, text, atUserList) {
+        this._ensureReady();
+        return timSendMessage(this._client, channelId, text, atUserList);
+    }
+    async fetchGroupHistory(channelId, count = 20) {
+        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() {
+        this._ensureReady();
+        return timListChannels(this._client);
+    }
+    async searchChannels(keyword) {
+        this._ensureReady();
+        return timSearchChannels(this._client, keyword);
+    }
+    async joinChannel(channelId) {
+        this._ensureReady();
+        return timJoinChannel(this._client, channelId);
+    }
+    async leaveChannel(channelId) {
+        this._ensureReady();
+        return timLeaveChannel(this._client, channelId);
+    }
+    async getMembers(channelId) {
+        this._ensureReady();
+        return timGetMembers(this._client, channelId);
+    }
+    async createChannel(name, desc) {
+        this._ensureReady();
+        return timCreateChannel(this._client, name, desc);
+    }
+    async getChannelSkill(channelId) {
+        this._ensureReady();
+        return timGetChannelSkill(this._client, channelId);
+    }
+    async setChannelSkill(channelId, skill) {
+        this._ensureReady();
+        return timSetChannelSkill(this._client, channelId, skill);
+    }
+    // ─────────────────────────────────────────────────────────────
+    // 内部工具
+    // ─────────────────────────────────────────────────────────────
+    /** 暴露底层 TIMClient 给老代码兼容（如 src/runtime/registry 等） */
+    get _internalClient() {
+        return this._client;
+    }
+    _ensureReady() {
+        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"。
+     */
+    async _sendC2CCustom(userId, payload) {
+        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;
+        const timeoutPromise = new Promise((_, 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 回写给请求方 */
+    async _invokeTaskHandler(req) {
+        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.message}`);
+            // 即使 handler 失败也回写 error 结果，避免对方永久阻塞
+            try {
+                await this._sendC2CCustom(req.from, {
+                    type: 'openagent_task_result',
+                    request_id: req.requestId,
+                    status: 'error',
+                    content: err.message,
+                });
+            }
+            catch {
+                /* swallow，已经记日志了 */
+            }
+        }
+    }
+}
+// 引用未使用的导入做编译期检查，避免 lint 报 unused
+void TencentCloudChat;