@xgjktech/xg_cwork_im 1.11.1 → 1.11.4

package/{src/channel.ts → dist/src/channel.js}

@@ -7,48 +7,29 @@
  * - gateway  : 启动 WebSocket 长连接，接收 robotMention 消息后通过
  *              PluginRuntime 路由给 OpenClaw 处理
  */
-
 import { randomUUID } from "node:crypto";
-import type { OpenClawConfig } from "openclaw/plugin-sdk";
 import { buildChannelConfigSchema } from "openclaw/plugin-sdk";
 import { z } from "zod";
 import { clearTokenCache, getToken } from "./auth.js";
-import { startWebSocket, type ImStreamClient } from "./connection.js";
+import { startWebSocket } from "./connection.js";
 import { normalizeInboundWorkspaceSubdir, saveInboundFilesToWorkspace } from "./inbound-media-local.js";
-import { sendReplyDeliverBlock, sendTextMessage, type ReplyDeliverPayload } from "./send-service.js";
-import {
-    imFormatToMimeType,
-    type BotIdentity,
-    type GatewayStartContext,
-    type MsgFileVO,
-    type PluginRuntime,
-    type ResolvedAccount,
-    type WsMessage,
-    type WsMessageContent,
-    type WsMessageParams,
-    type XgImChannelPlugin,
-    type XgImConfig,
-} from "./types.js";
-
+import { sendReplyDeliverBlock, sendTextMessage } from "./send-service.js";
 // ─── 全局 Runtime（在 index.ts 的 register 中注入）────────────────────────────
-
-let xgImRuntime: PluginRuntime | null = null;
-
-export function setXgImRuntime(rt: PluginRuntime): void {
+let xgImRuntime = null;
+export function setXgImRuntime(rt) {
     xgImRuntime = rt;
 }
-
-function getXgImRuntime(): PluginRuntime {
-    if (!xgImRuntime) throw new Error("[cwork_im] Plugin runtime not initialized");
+function getXgImRuntime() {
+    if (!xgImRuntime)
+        throw new Error("[cwork_im] Plugin runtime not initialized");
     return xgImRuntime;
 }
-
 // ─── 配置 Schema ──────────────────────────────────────────────────────────────
-
 const XgImAccountConfigSchema = z.object({
-    // 注意：为了兼容 OpenClaw doctor 生成的 accounts.default（仅包含默认项，不含 appKey），这里先放宽为 optional，
-    // 然后在 XgImConfigSchema.superRefine 中强制校验：除 default 之外的账号必须提供 appKey。
-    appKey: z.string().min(1, "appKey is required").optional(),
+    // 注意：为了兼容 OpenClaw doctor 生成的 accounts.default（仅包含默认项，不含 appKey/robotKey），这里先放宽为 optional，
+    // 然后在 XgImConfigSchema.superRefine 中强制校验：除 default 之外的账号必须提供 robotKey 或 appKey。
+    robotKey: z.string().min(1).optional(),
+    appKey: z.string().min(1).optional(),
     agentId: z.string().optional().default("main"),
     name: z.string().optional(),
     groupPolicy: z.enum(["open", "mention"]).optional().default("mention"),
@@ -59,8 +40,8 @@ const XgImAccountConfigSchema = z.object({
     inboundMediaSandboxRootPrefix: z.string().optional(),
     systemPrompt: z.string().optional(),
 });
-
 const XgImConfigSchema = z.object({
+    robotKey: z.string().optional(),
     appKey: z.string().optional(),
     agentId: z.string().optional().default("main"),
     baseUrl: z.string().url("baseUrl must be a valid URL"),
@@ -89,21 +70,15 @@ const XgImConfigSchema = z.object({
     // 多账户：对象 map（key 为 accountId）
     accounts: z.record(z.string(), XgImAccountConfigSchema).optional(),
 }).superRefine((val, ctx) => {
-    const badSubdir = (s: string | undefined): boolean =>
-        typeof s === "string" && s.trim().length > 0 && normalizeInboundWorkspaceSubdir(s) == null;
-
+    const badSubdir = (s) => typeof s === "string" && s.trim().length > 0 && normalizeInboundWorkspaceSubdir(s) == null;
     if (badSubdir(val.inboundMediaWorkspaceSubdir)) {
         ctx.addIssue({
             code: z.ZodIssueCode.custom,
             path: ["inboundMediaWorkspaceSubdir"],
-            message:
-                "inboundMediaWorkspaceSubdir must be a relative path under workspace (no .., no absolute path)",
+            message: "inboundMediaWorkspaceSubdir must be a relative path under workspace (no .., no absolute path)",
         });
     }
-
-    const badSandboxPrefix = (s: string | undefined): boolean =>
-        typeof s === "string" && s.trim().length > 0 && !s.trim().startsWith("/");
-
+    const badSandboxPrefix = (s) => typeof s === "string" && s.trim().length > 0 && !s.trim().startsWith("/");
     if (badSandboxPrefix(val.inboundMediaSandboxRootPrefix)) {
         ctx.addIssue({
             code: z.ZodIssueCode.custom,
@@ -111,129 +86,123 @@ const XgImConfigSchema = z.object({
             message: "inboundMediaSandboxRootPrefix must be empty or an absolute path such as /workspace",
         });
     }
-
     const accounts = val.accounts;
-    if (!accounts) return;
+    if (!accounts)
+        return;
     for (const [key, acc] of Object.entries(accounts)) {
-        if (key === "default") continue;
-        if (!acc || typeof acc !== "object") continue;
-        if (!("appKey" in acc) || !acc.appKey) {
+        if (key === "default")
+            continue;
+        if (!acc || typeof acc !== "object")
+            continue;
+        if (!acc.robotKey && !acc.appKey) {
             ctx.addIssue({
                 code: z.ZodIssueCode.custom,
-                path: ["accounts", key, "appKey"],
-                message: "appKey is required for account entries (except accounts.default)",
+                path: ["accounts", key, "robotKey"],
+                message: "robotKey (or appKey) is required for account entries (except accounts.default)",
             });
         }
         if (badSubdir(acc.inboundMediaWorkspaceSubdir)) {
             ctx.addIssue({
                 code: z.ZodIssueCode.custom,
                 path: ["accounts", key, "inboundMediaWorkspaceSubdir"],
-                message:
-                    "inboundMediaWorkspaceSubdir must be a relative path under workspace (no .., no absolute path)",
+                message: "inboundMediaWorkspaceSubdir must be a relative path under workspace (no .., no absolute path)",
             });
         }
         if (badSandboxPrefix(acc.inboundMediaSandboxRootPrefix)) {
             ctx.addIssue({
                 code: z.ZodIssueCode.custom,
                 path: ["accounts", key, "inboundMediaSandboxRootPrefix"],
-                message:
-                    "inboundMediaSandboxRootPrefix must be empty or an absolute path such as /workspace",
+                message: "inboundMediaSandboxRootPrefix must be empty or an absolute path such as /workspace",
             });
         }
     }
 });
-
 // ─── 辅助函数 ─────────────────────────────────────────────────────────────────
-
+/**
+ * 规范化 key 字段：优先取 robotKey，没有则取 appKey，统一写入 appKey。
+ * 这样下游代码（auth.ts 等）只需读 config.appKey，无需感知 robotKey 的存在。
+ */
+function normalizeRobotKey(config) {
+    const resolved = config.robotKey ?? config.appKey;
+    if (resolved === config.appKey)
+        return config;
+    return { ...config, appKey: resolved };
+}
 /** 从顶层 cfg 中取出 XgImConfig，支持多账户（README：channels.xg_cwork_im） */
-function getXgImConfig(cfg: OpenClawConfig, accountId?: string | null): XgImConfig {
-    const raw = (cfg as Record<string, Record<string, unknown>>)?.channels?.xg_cwork_im as XgImConfig | undefined;
-    if (!raw) throw new Error("[cwork_im] channels.xg_cwork_im config not found");
-
-    const accounts = raw.accounts as unknown;
-    const accountMap =
-        accounts && typeof accounts === "object" && !Array.isArray(accounts)
-            ? (accounts as Record<string, Partial<XgImConfig> | undefined>)
-            : undefined;
+function getXgImConfig(cfg, accountId) {
+    const raw = cfg?.channels?.xg_cwork_im;
+    if (!raw)
+        throw new Error("[cwork_im] channels.xg_cwork_im config not found");
+    const accounts = raw.accounts;
+    const accountMap = accounts && typeof accounts === "object" && !Array.isArray(accounts)
+        ? accounts
+        : undefined;
     const defaults = accountMap?.default ? { ...accountMap.default } : undefined;
-
     // 指定了具体账户 ID 时，优先合并对应账户配置
     if (accountId && accountId !== "default" && accountMap) {
         const sub = accountMap[accountId];
-        if (sub) return { ...raw, ...(defaults ?? {}), ...sub };
+        if (sub)
+            return normalizeRobotKey({ ...raw, ...(defaults ?? {}), ...sub });
     }
-
     // 没有指定 accountId（如 Cron outbound 场景），自动 fallback 到「第一个账户」
-    // 避免顶层 raw 没有 appKey 时 getToken 失败
-    if (accountMap && !raw.appKey) {
+    // 避免顶层 raw 没有 appKey/robotKey 时 getToken 失败
+    if (accountMap && !raw.appKey && !raw.robotKey) {
         const firstKey = Object.keys(accountMap).find((k) => k !== "default");
         const first = firstKey ? accountMap[firstKey] : undefined;
-        if (first) return { ...raw, ...(defaults ?? {}), ...first };
+        if (first)
+            return normalizeRobotKey({ ...raw, ...(defaults ?? {}), ...first });
     }
-
-    return raw;
+    return normalizeRobotKey(raw);
 }
-
 /**
  * 合并 `channels.xg_cwork_im` 顶层、`accounts.default`、以及 `accounts.<accountId>` 后的 `systemPrompt`，
  * 写入 OpenClaw 入站 `GroupSystemPrompt`（与 getXgImConfig 的非 default 账户合并方式一致；对 default 账户会合并 default 片段）。
  */
-function resolveXgImGroupSystemPrompt(cfg: OpenClawConfig, accountId: string): string | undefined {
+function resolveXgImGroupSystemPrompt(cfg, accountId) {
     try {
-        const raw = (cfg as Record<string, Record<string, unknown>>)?.channels?.xg_cwork_im as XgImConfig | undefined;
-        if (!raw) return undefined;
-        const accountMap =
-            raw.accounts && typeof raw.accounts === "object" && !Array.isArray(raw.accounts)
-                ? (raw.accounts as Record<string, Partial<XgImConfig> | undefined>)
-                : undefined;
+        const raw = cfg?.channels?.xg_cwork_im;
+        if (!raw)
+            return undefined;
+        const accountMap = raw.accounts && typeof raw.accounts === "object" && !Array.isArray(raw.accounts)
+            ? raw.accounts
+            : undefined;
         const defaults = accountMap?.default ? { ...accountMap.default } : {};
-        const base: XgImConfig = { ...raw, ...defaults };
-        let merged: XgImConfig = base;
+        const base = { ...raw, ...defaults };
+        let merged = base;
         if (accountId && accountId !== "default" && accountMap?.[accountId]) {
             merged = { ...base, ...accountMap[accountId] };
         }
         const t = merged.systemPrompt?.trim();
         return t || undefined;
-    } catch {
+    }
+    catch {
         return undefined;
     }
 }
-
-function isConfigured(cfg: OpenClawConfig): boolean {
+function isConfigured(cfg) {
     try {
         const c = getXgImConfig(cfg);
         return Boolean(c?.appKey && c?.baseUrl);
-    } catch {
+    }
+    catch {
         return false;
     }
 }
-
 /**
  * OpenClaw 对入站命令：`CommandAuthorized === undefined` 会按 false 处理，文本 /command 会被静默忽略（仍走普通 AI）。
  * 见 openclaw LINE #26996 等修复。此处与 channels.xg_cwork_im.allowFrom 对齐；allowFrom 为空表示不限制发送者。
  */
-function isSenderInXgImAllowFrom(config: XgImConfig, senderId: string | undefined): boolean {
+function isSenderInXgImAllowFrom(config, senderId) {
     const allow = config.allowFrom ?? [];
-    if (allow.length === 0) return true;
+    if (allow.length === 0)
+        return true;
     const id = senderId?.trim();
-    if (!id) return false;
+    if (!id)
+        return false;
     return allow.includes(id);
 }
-
-function resolveInboundCommandAuthorized(
-    rt: unknown,
-    cfg: OpenClawConfig,
-    p: { accountId: string; senderId: string | undefined; config: XgImConfig },
-): boolean {
-    const r = rt as {
-        channel?: {
-            commands?: {
-                resolveControlCommandGate?: (args: Record<string, unknown>) =>
-                    | boolean
-                    | { commandAuthorized?: boolean };
-            };
-        };
-    };
+function resolveInboundCommandAuthorized(rt, cfg, p) {
+    const r = rt;
     const fn = r?.channel?.commands?.resolveControlCommandGate;
     if (typeof fn === "function") {
         try {
@@ -244,28 +213,19 @@ function resolveInboundCommandAuthorized(
                 senderId: p.senderId ?? "",
                 chatType: "group",
             });
-            if (typeof out === "boolean") return out;
+            if (typeof out === "boolean")
+                return out;
             if (out && typeof out === "object" && "commandAuthorized" in out) {
-                return Boolean((out as { commandAuthorized?: boolean }).commandAuthorized);
+                return Boolean(out.commandAuthorized);
             }
-        } catch {
+        }
+        catch {
             /* 回退到 allowFrom */
         }
     }
     return isSenderInXgImAllowFrom(p.config, p.senderId);
 }
-
-// ─── 日志适配器 ───────────────────────────────────────────────────────────────
-// ChannelLogSink 的 info/warn/error 方法接受单个 string
-
-interface Logger {
-    info: (msg: string) => void;
-    warn: (msg: string) => void;
-    error: (msg: string) => void;
-    debug?: (msg: string) => void;
-}
-
-function toLogger(sink: { info?: (msg: string) => void; warn?: (msg: string) => void; error?: (msg: string) => void; debug?: (msg: string) => void } | undefined): Logger {
+function toLogger(sink) {
     return {
         info: (msg) => sink?.info?.(msg),
         warn: (msg) => sink?.warn?.(msg),
@@ -273,14 +233,11 @@ function toLogger(sink: { info?: (msg: string) => void; warn?: (msg: string) =>
         debug: (msg) => sink?.debug?.(msg),
     };
 }
-
 // ─── WebSocket 入站：纯函数与 @ 后派发 ───────────────────────────────────────
-
-function collectFileItems(msgContent: WsMessageContent | undefined): MsgFileVO[] {
+function collectFileItems(msgContent) {
     return (msgContent?.files ?? []).filter((f) => f.url?.trim());
 }
-
-function buildInboundDisplayText(msgContent: WsMessageContent | undefined, fileItems: MsgFileVO[]): string {
+function buildInboundDisplayText(msgContent, fileItems) {
     let rawText = msgContent?.text ?? "";
     if (fileItems.length > 0) {
         const lines = fileItems.map((f) => {
@@ -289,67 +246,54 @@ function buildInboundDisplayText(msgContent: WsMessageContent | undefined, fileI
         });
         const block = `**附件（${fileItems.length}）**\n${lines.join("\n")}`;
         rawText = rawText.trim() ? `${rawText.trim()}\n\n${block}` : block;
-
         const parsedParts = fileItems
             .map((f) => {
-                const c = f.content?.trim();
-                if (!c) return null;
-                const name = f.name?.trim() || f.fileId || "未命名文件";
-                return `### ${name}\n\n${c}`;
-            })
-            .filter((x): x is string => x != null);
+            const c = f.content?.trim();
+            if (!c)
+                return null;
+            const name = f.name?.trim() || f.fileId || "未命名文件";
+            return `### ${name}\n\n${c}`;
+        })
+            .filter((x) => x != null);
         if (parsedParts.length > 0) {
             const parsedBlock = `**附件解析内容**\n\n${parsedParts.join("\n\n")}`;
             rawText = `${rawText.trim()}\n\n${parsedBlock}`;
         }
-
-        const urlGuard =
-            "**附件 URL 使用约束**\n" +
+        const urlGuard = "**附件 URL 使用约束**\n" +
             "处理附件时必须逐字原样使用消息中提供的完整 URL；禁止修改、删除或重排任何 query 参数。";
         rawText = `${rawText.trim()}\n\n${urlGuard}`;
     }
     return rawText;
 }
-
-function isActuallyMentioned(
-    msg: WsMessage,
-    params: WsMessageParams,
-    bot: { userId: string; name: string },
-    rawTextForLegacy: string,
-): boolean {
+function isActuallyMentioned(msg, params, bot, rawTextForLegacy) {
     const mentions = params.mentions;
-    const isMentioned =
-        Array.isArray(mentions) && (mentions.includes(bot.userId) || mentions.includes("all"));
-    const isLegacyMentioned =
-        msg.cmd === "robotMention" &&
+    const isMentioned = Array.isArray(mentions) && (mentions.includes(bot.userId) || mentions.includes("all"));
+    const isLegacyMentioned = msg.cmd === "robotMention" &&
         (!params.mentions || params.mentions.length === 0) &&
         new RegExp(`@${bot.name}\\b`).test(rawTextForLegacy);
     return isMentioned || isLegacyMentioned;
 }
-
-function mediaFieldsFromFileItems(fileItems: MsgFileVO[]): Record<string, unknown> {
-    if (fileItems.length === 0) return {};
+function mediaFieldsFromFileItems(fileItems) {
+    if (fileItems.length === 0)
+        return {};
     // 只传 MediaPath(s)，不传 MediaType(s)。
     // 预签名 URL 的 query 中常含 response-content-type；若额外给 MediaType，模型/工具更容易“改写 URL”导致签名失效。
     if (fileItems.length === 1) {
         return {
-            MediaPath: fileItems[0]!.url,
+            MediaPath: fileItems[0].url,
         };
     }
     return {
         MediaPaths: fileItems.map((f) => f.url),
     };
 }
-
 /** ext / 用户 background / 附件元数据（不含下载 URL，避免预签名链过长；URL 已在入站 MediaPath(s)） */
-function buildUntrustedContext(
-    msgExt: WsMessageContent["ext"],
-    senderBackground: string | undefined,
-    fileItems: MsgFileVO[],
-): string[] | undefined {
-    const parts: string[] = [];
-    if (msgExt) parts.push(JSON.stringify(msgExt));
-    if (senderBackground) parts.push(String(senderBackground));
+function buildUntrustedContext(msgExt, senderBackground, fileItems) {
+    const parts = [];
+    if (msgExt)
+        parts.push(JSON.stringify(msgExt));
+    if (senderBackground)
+        parts.push(String(senderBackground));
     if (fileItems.length > 0) {
         const summary = fileItems.map((f) => ({
             name: f.name ?? null,
@@ -362,13 +306,7 @@ function buildUntrustedContext(
     }
     return parts.length > 0 ? parts : undefined;
 }
-
-function buildTargetReplyMeta(params: WsMessageParams): {
-    targetMsgId: string;
-    targetUserId: string;
-    targetUserName: string;
-    previewText: string;
-} {
+function buildTargetReplyMeta(params) {
     return {
         targetMsgId: params.msgId,
         targetUserId: params.userInfo?.id ?? "",
@@ -376,61 +314,41 @@ function buildTargetReplyMeta(params: WsMessageParams): {
         previewText: params.msgContent?.text ?? "",
     };
 }
-
 /** 流式 START → dispatch → 必发 END；首包超时走 HTTP 覆盖占位 */
-async function dispatchMentionedReply(args: {
-    rt: any;
-    cfg: OpenClawConfig;
-    config: XgImConfig;
-    log: Logger;
-    logPrefix: string;
-    route: { sessionKey: string };
-    inboundCtx: unknown;
-    params: WsMessageParams;
-    currentIdentity: BotIdentity;
-    streamClient: ImStreamClient;
-}): Promise<void> {
+async function dispatchMentionedReply(args) {
     const { rt, cfg, config, log, logPrefix, route, inboundCtx, params, currentIdentity, streamClient } = args;
-
     log.info(`${logPrefix} [dispatch] Dispatching to OpenClaw AI, sessionKey=${route.sessionKey}`);
     let isFirstReply = true;
     const dispatchStart = Date.now();
-
     const { msgId: streamMsgId } = await streamClient.start({
         groupId: params.groupId,
     });
     log.info(`${logPrefix} [stream] START acknowledged: msgId=${streamMsgId}`);
-
     let hasFirstReply = false;
     const firstReplyTimeoutMs = config.firstReplyTimeoutMs ?? 30 * 60_000;
     const timeoutLabel = `${logPrefix} [stream] First reply timeout after ${firstReplyTimeoutMs}ms, updating thinking message as error`;
     const firstReplyTimeout = setTimeout(async () => {
-        if (hasFirstReply) return;
+        if (hasFirstReply)
+            return;
         log.warn(timeoutLabel);
         try {
             const reply = buildTargetReplyMeta(params);
             const timeoutText = "当前请求处理超时，请稍后重试。";
-            await sendTextMessage(
-                config,
-                currentIdentity.token,
-                params.groupId,
-                timeoutText,
-                [reply.targetUserId] as string[],
-                log,
-                streamMsgId,
-                reply,
-            );
-            log.info(
-                `${logPrefix} [send] Timeout reply sent via HTTP: groupId=${params.groupId} msgId=${streamMsgId} text="${timeoutText}"`,
-            );
-        } catch (err: unknown) {
+            await sendTextMessage(config, currentIdentity.token, params.groupId, timeoutText, [reply.targetUserId], log, streamMsgId, reply);
+            // 标记已发送，让 finally 以 reason=stop 结束，避免后台再显示"AI未响应"
+            hasFirstReply = true;
+            log.info(`${logPrefix} [send] Timeout reply sent via HTTP: groupId=${params.groupId} msgId=${streamMsgId} text="${timeoutText}"`);
+        }
+        catch (err) {
             log.error(`${logPrefix} [timeout] Failed to send timeout reply: ${String(err)}`);
         }
     }, firstReplyTimeoutMs);
-
     let deliverCallCount = 0;
     let deliverSkippedCount = 0;
-
+    let dispatchError = undefined;
+    // 捕获 deliver 抛出后被 dispatcher 静默吞掉的错误：postImMessage 已带 5 次重试，
+    // 进到这里说明所有重试均失败（IM 后台不可用 / 4xx / resultCode 业务错误等），需要让 finally 走兜底分支
+    let lastDeliverError = undefined;
     try {
         await rt.channel.reply.dispatchReplyWithBufferedBlockDispatcher({
             ctx: inboundCtx,
@@ -438,111 +356,100 @@ async function dispatchMentionedReply(args: {
             dispatcherOptions: {
                 responsePrefix: "",
                 // Logged when normalizeReplyPayload decides to skip a payload (e.g. heartbeat, silent token, empty).
-                onSkip: (payload: unknown, meta: { kind: string; reason: string }) => {
+                onSkip: (payload, meta) => {
                     deliverSkippedCount++;
-                    log.info(
-                        `${logPrefix} [deliver] Payload skipped by normalizer kind=${meta.kind} reason=${meta.reason}`,
-                    );
+                    log.info(`${logPrefix} [deliver] Payload skipped by normalizer kind=${meta.kind} reason=${meta.reason}`);
                 },
                 // Logged when deliver throws and the dispatcher catches it (error would otherwise be silently dropped).
-                onError: (err: unknown, meta: { kind: string }) => {
-                    log.error(
-                        `${logPrefix} [deliver] Dispatcher caught unhandled error kind=${meta.kind}: ${String(err)}`,
-                    );
+                onError: (err, meta) => {
+                    lastDeliverError = err;
+                    log.error(`${logPrefix} [deliver] Dispatcher caught unhandled error kind=${meta.kind}: ${String(err)}`);
                 },
-                deliver: async (payload: ReplyDeliverPayload) => {
+                deliver: async (payload) => {
                     try {
                         const textPart = (payload.markdown || payload.text || "").trim();
-                        const hasMedia =
-                            Boolean(payload.mediaUrl?.trim()) ||
+                        const hasMedia = Boolean(payload.mediaUrl?.trim()) ||
                             Boolean(payload.mediaUrls?.some((u) => typeof u === "string" && u.trim()));
                         if (!textPart && !(hasMedia && !payload.isThinking)) {
-                            log.info(
-                                `${logPrefix} [deliver] Payload has no sendable content, skipping` +
-                                    ` (isThinking=${payload.isThinking ?? false} hasMedia=${hasMedia})`,
-                            );
+                            log.info(`${logPrefix} [deliver] Payload has no sendable content, skipping` +
+                                ` (isThinking=${payload.isThinking ?? false} hasMedia=${hasMedia})`);
                             return;
                         }
-
                         deliverCallCount++;
                         if (isFirstReply) {
                             const ttfr = Date.now() - dispatchStart;
-                            log.info(
-                                `${logPrefix} [deliver] First response block received from AI (TTFB: ${ttfr}ms)`,
-                            );
+                            log.info(`${logPrefix} [deliver] First response block received from AI (TTFB: ${ttfr}ms)`);
                             isFirstReply = false;
                         }
-
                         const reply = buildTargetReplyMeta(params);
-                        const atIds = [reply.targetUserId] as string[];
-
+                        const atIds = [reply.targetUserId];
                         if (!hasFirstReply) {
-                            hasFirstReply = true;
                             clearTimeout(firstReplyTimeout);
-                            await sendReplyDeliverBlock(
-                                config,
-                                currentIdentity.token,
-                                params.groupId,
-                                payload,
-                                atIds,
-                                log,
-                                streamMsgId,
-                                reply,
-                            );
-                            const preview =
-                                textPart.length > 80 ? `${textPart.slice(0, 80)}...` : textPart || "[media]";
-                            log.info(
-                                `${logPrefix} [send] First reply sent via HTTP: groupId=${params.groupId} msgId=${streamMsgId} preview="${preview}"`,
-                            );
+                            await sendReplyDeliverBlock(config, currentIdentity.token, params.groupId, payload, atIds, log, streamMsgId, reply);
+                            hasFirstReply = true; // set after successful send
+                            const preview = textPart.length > 80 ? `${textPart.slice(0, 80)}...` : textPart || "[media]";
+                            log.info(`${logPrefix} [send] First reply sent via HTTP: groupId=${params.groupId} msgId=${streamMsgId} preview="${preview}"`);
                             return;
                         }
-
-                        await sendReplyDeliverBlock(
-                            config,
-                            currentIdentity.token,
-                            params.groupId,
-                            payload,
-                            atIds,
-                            log,
-                            undefined,
-                            reply,
-                        );
-                        const preview =
-                            textPart.length > 80 ? `${textPart.slice(0, 80)}...` : textPart || "[media]";
-                        log.info(
-                            `${logPrefix} [send] Additional reply sent via HTTP: groupId=${params.groupId} preview="${preview}"`,
-                        );
-                    } catch (err: unknown) {
+                        await sendReplyDeliverBlock(config, currentIdentity.token, params.groupId, payload, atIds, log, undefined, reply);
+                        const preview = textPart.length > 80 ? `${textPart.slice(0, 80)}...` : textPart || "[media]";
+                        log.info(`${logPrefix} [send] Additional reply sent via HTTP: groupId=${params.groupId} preview="${preview}"`);
+                    }
+                    catch (err) {
                         log.error(`${logPrefix} [deliver] Reply deliver failed: ${String(err)}`);
                         throw err;
                     }
                 },
             },
         });
-        log.info(
-            `${logPrefix} [dispatch] Dispatch completed for sessionKey=${route.sessionKey}` +
-                ` (delivered=${deliverCallCount} skipped=${deliverSkippedCount})`,
-        );
+        log.info(`${logPrefix} [dispatch] Dispatch completed for sessionKey=${route.sessionKey}` +
+            ` (delivered=${deliverCallCount} skipped=${deliverSkippedCount})`);
+    }
+    catch (dispatchErr) {
+        dispatchError = dispatchErr;
+        log.error(`${logPrefix} [dispatch] Dispatch failed (delivered=${deliverCallCount} skipped=${deliverSkippedCount}): ${String(dispatchErr)}`);
+    }
+    finally {
+        clearTimeout(firstReplyTimeout);
+        // 兜底原则：
+        // - 有"实际错误"（dispatch 自身异常 / deliver 全部重试后仍失败）且尚未发过任何消息
+        //   → 主动告知用户，以 reason=stop 结束（后台信任已发消息）。
+        // - 无错误也无回复（AI 输出为空 / 全部被 normalizer skip / /reset 类静默命令）
+        //   → 以 reason=no_reply 结束，由后台展示"AI未响应"。
         if (!hasFirstReply) {
-            log.warn(
-                `${logPrefix} [dispatch] No reply was sent to user after dispatch completed` +
-                    ` (delivered=${deliverCallCount} skipped=${deliverSkippedCount})`,
-            );
+            const reportableError = dispatchError ?? lastDeliverError;
+            if (reportableError !== undefined) {
+                const errSource = dispatchError !== undefined ? "dispatch" : "deliver";
+                log.warn(`${logPrefix} [dispatch] ${errSource} error with no prior reply` +
+                    ` (delivered=${deliverCallCount} skipped=${deliverSkippedCount}), sending error notice`);
+                const replyMeta = buildTargetReplyMeta(params);
+                try {
+                    await sendTextMessage(config, currentIdentity.token, params.groupId, `当前请求处理时出现异常，请稍后重试。\n错误信息：${String(reportableError)}`, [replyMeta.targetUserId], log, streamMsgId, replyMeta);
+                    hasFirstReply = true;
+                }
+                catch (fallbackErr) {
+                    log.error(`${logPrefix} [dispatch] Failed to send error notice (${errSource} error): ${String(fallbackErr)}`);
+                }
+            }
+            else {
+                log.warn(`${logPrefix} [dispatch] No reply was sent to user` +
+                    ` (delivered=${deliverCallCount} skipped=${deliverSkippedCount}), ending with reason=no_reply`);
+            }
         }
-    } finally {
-        clearTimeout(firstReplyTimeout);
+        // reason=stop：已通过 HTTP 发送了至少一条回复（含兜底错误消息），后台信任已有消息。
+        // reason=no_reply：本次无任何回复且无异常，后台凭此展示"AI未响应"。
+        const endReason = hasFirstReply ? "stop" : "no_reply";
         try {
-            await streamClient.end(streamMsgId, "stop");
-            log.info(`${logPrefix} [stream] END sent: msgId=${streamMsgId}`);
-        } catch (endErr: unknown) {
+            await streamClient.end(streamMsgId, endReason);
+            log.info(`${logPrefix} [stream] END sent: msgId=${streamMsgId} reason=${endReason}`);
+        }
+        catch (endErr) {
             log.error(`${logPrefix} [stream] END failed (msgId=${streamMsgId}): ${String(endErr)}`);
         }
     }
 }
-
 // ─── Channel Plugin 定义 ─────────────────────────────────────────────────────
-
-export const xgCworkImChannelPlugin: XgImChannelPlugin = {
+export const xgCworkImChannelPlugin = {
     id: "xg_cwork_im",
     meta: {
         id: "xg_cwork_im",
@@ -554,9 +461,9 @@ export const xgCworkImChannelPlugin: XgImChannelPlugin = {
     },
     // 双重类型转换绕过 zod v3/v4 的 TS 类型不兼容
     // buildChannelConfigSchema 会将 schema 包装成可序列化的形式，避免 DataCloneError
-    configSchema: buildChannelConfigSchema(XgImConfigSchema as unknown as Parameters<typeof buildChannelConfigSchema>[0]),
+    configSchema: buildChannelConfigSchema(XgImConfigSchema),
     capabilities: {
-        chatTypes: ["group"] as Array<"direct" | "group">,
+        chatTypes: ["group"],
         reactions: false,
         threads: false,
         media: true,
@@ -564,27 +471,26 @@ export const xgCworkImChannelPlugin: XgImChannelPlugin = {
         blockStreaming: false,
     },
     reload: { configPrefixes: ["channels.xg_cwork_im"] },
-
     // ── 账户配置 ────────────────────────────────────────────────────────────────
     config: {
-        listAccountIds: (cfg: OpenClawConfig): string[] => {
+        listAccountIds: (cfg) => {
             try {
                 const config = getXgImConfig(cfg);
-                const accounts = config.accounts as unknown;
+                const accounts = config.accounts;
                 if (accounts) {
                     if (!Array.isArray(accounts) && typeof accounts === "object") {
                         // 推荐写法：对象 key 作为 accountId
-                        const keys = Object.keys(accounts as Record<string, unknown>).filter((k) => k !== "default");
+                        const keys = Object.keys(accounts).filter((k) => k !== "default");
                         return keys;
                     }
                 }
                 return isConfigured(cfg) ? ["default"] : [];
-            } catch {
+            }
+            catch {
                 return [];
             }
         },
-
-        resolveAccount: (cfg: OpenClawConfig, accountId?: string | null): ResolvedAccount => {
+        resolveAccount: (cfg, accountId) => {
             const id = accountId || "default";
             try {
                 const config = getXgImConfig(cfg, id);
@@ -595,166 +501,135 @@ export const xgCworkImChannelPlugin: XgImChannelPlugin = {
                     configured: Boolean(config.appKey && config.baseUrl),
                     name: config.name ?? null,
                 };
-            } catch {
+            }
+            catch {
                 return {
                     accountId: id,
-                    config: {} as XgImConfig,
+                    config: {},
                     enabled: false,
                     configured: false,
                     name: null,
                 };
             }
         },
-
         // 注意：OpenClaw 可能在缺省路由时使用 defaultAccountId。
         // 我们使用 "default" 作为别名：getXgImConfig 会自动 fallback 到第一个非 default 的真实账号。
-        defaultAccountId: (): string => "default",
-
-        isConfigured: (account: ResolvedAccount): boolean => account.configured,
-
-        describeAccount: (account: ResolvedAccount) => ({
+        defaultAccountId: () => "default",
+        isConfigured: (account) => account.configured,
+        describeAccount: (account) => ({
             accountId: account.accountId,
             name: account.config?.name ?? "xg_cwork_im",
             enabled: account.enabled,
             configured: account.configured,
         }),
     },
-
     // ── 群聊设置 ─────────────────────────────────────────────────────────────────
     groups: {
-        resolveRequireMention: (params): boolean => {
+        resolveRequireMention: (params) => {
             try {
                 const config = getXgImConfig(params.cfg, params.accountId);
                 return config?.groupPolicy !== "open";
-            } catch {
+            }
+            catch {
                 return true; // 默认需要 @
             }
         },
     },
-
     // ── 出站消息（openclaw 主动发送时调用）────────────────────────────────────────
     outbound: {
-        deliveryMode: "direct" as const,
-
+        deliveryMode: "direct",
         resolveTarget: (params) => {
             const trimmed = params.to?.trim();
             if (!trimmed) {
                 return {
-                    ok: false as const,
+                    ok: false,
                     error: new Error("XG-IM message requires --to <groupId>"),
                 };
             }
-            return { ok: true as const, to: trimmed };
+            return { ok: true, to: trimmed };
         },
-
         sendText: async (ctx) => {
-            const { cfg, to, text, accountId, log: ctxLog } = ctx as typeof ctx & { log?: Logger };
+            const { cfg, to, text, accountId, log: ctxLog } = ctx;
             const log = toLogger(ctxLog);
             const config = getXgImConfig(cfg, accountId);
             const identity = await getToken(config, log);
-
             await sendTextMessage(config, identity.token, to, text, [], log);
-
             return {
                 channel: "xg_cwork_im",
                 messageId: randomUUID(),
             };
         },
-
         /** 出站带媒体：上传资源后发 FILE，与网关 deliver 逻辑一致（OpenClaw 要求与 sendText 同时实现） */
         sendMedia: async (ctx) => {
-            const { cfg, to, text, mediaUrl, accountId, log: ctxLog } = ctx as typeof ctx & { log?: Logger };
+            const { cfg, to, text, mediaUrl, accountId, log: ctxLog } = ctx;
             const log = toLogger(ctxLog);
             const config = getXgImConfig(cfg, accountId);
             const identity = await getToken(config, log);
-
             if (!mediaUrl?.trim()) {
                 await sendTextMessage(config, identity.token, to, text || "", [], log);
                 return { channel: "xg_cwork_im", messageId: randomUUID() };
             }
-
-            await sendReplyDeliverBlock(
-                config,
-                identity.token,
-                to,
-                { text: text || "", mediaUrl: mediaUrl.trim() },
-                [],
-                log,
-                undefined,
-                undefined,
-            );
-
+            await sendReplyDeliverBlock(config, identity.token, to, { text: text || "", mediaUrl: mediaUrl.trim() }, [], log, undefined, undefined);
             return {
                 channel: "xg_cwork_im",
                 messageId: randomUUID(),
             };
         },
     },
-
     // ── 网关（WebSocket 长连接）─────────────────────────────────────────────────
     gateway: {
-        startAccount: async (ctx: GatewayStartContext): Promise<void> => {
+        startAccount: async (ctx) => {
             const account = ctx.account;
             const config = account.config;
             const log = toLogger(ctx.log);
             const logPrefix = `[${account.accountId}:${config.agentId || "main"}]`;
-
             if (!config.appKey || !config.baseUrl) {
                 throw new Error(`${logPrefix} appKey and baseUrl are required in config`);
             }
-
             log.info(`${logPrefix} Starting xg-cwork-im channel...`);
-
             // 1. 获取机器人 token（有效期一年，缓存后无需重复请求）
             const identity = await getToken(config, log);
-
             // 2. 获取 PluginRuntime（用于路由消息给 OpenClaw）
             // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            const rt = getXgImRuntime() as any;
-
+            const rt = getXgImRuntime();
             // 3. 若 abort 信号已触发则不启动
             if (ctx.abortSignal?.aborted) {
                 throw new Error(`${logPrefix} Connection aborted before start`);
             }
-
             // 4. 消息去重（按账户隔离）
-            const processedMsgIds = new Set<string>();
+            const processedMsgIds = new Set();
             const MSG_DEDUP_MAX = 1_000;
-
-            const isDuplicate = (msgId: string): boolean => {
-                if (processedMsgIds.has(msgId)) return true;
+            const isDuplicate = (msgId) => {
+                if (processedMsgIds.has(msgId))
+                    return true;
                 if (processedMsgIds.size >= MSG_DEDUP_MAX) {
                     const iter = processedMsgIds.values();
                     for (let i = 0; i < MSG_DEDUP_MAX / 2; i++) {
                         const val = iter.next().value;
-                        if (val !== undefined) processedMsgIds.delete(val);
+                        if (val !== undefined)
+                            processedMsgIds.delete(val);
                     }
                 }
                 processedMsgIds.add(msgId);
                 return false;
             };
-
             // 5. 收到 WebSocket 消息时的处理逻辑
-            const handleMessage = async (msg: WsMessage): Promise<void> => {
+            const handleMessage = async (msg) => {
                 const params = msg.params;
                 try {
                     if (isDuplicate(params.msgId)) {
                         log.debug?.(`${logPrefix} Duplicate msgId=${params.msgId}, skipping`);
                         return;
                     }
-
                     const msgContent = params.msgContent;
                     let fileItems = collectFileItems(msgContent);
                     const msgExt = msgContent?.ext;
                     const senderId = params.userInfo?.id;
                     const senderName = params.userInfo?.name || senderId || "";
                     const senderBackground = params.userInfo?.background;
-
                     const inboundSub = config.inboundMediaWorkspaceSubdir?.trim();
                     if (inboundSub && fileItems.length > 0 && normalizeInboundWorkspaceSubdir(inboundSub)) {
-                        log.info(
-                            `${logPrefix} [inbound-local] enabled subdir=${inboundSub} sender=${senderId ?? "unknown"} files=${fileItems.length} pathStyle=${config.inboundMediaOpenClawPath ?? "workspaceRelative"} sandboxPrefix=${config.inboundMediaSandboxRootPrefix ?? "(none)"}`,
-                        );
+                        log.info(`${logPrefix} [inbound-local] enabled subdir=${inboundSub} sender=${senderId ?? "unknown"} files=${fileItems.length} pathStyle=${config.inboundMediaOpenClawPath ?? "workspaceRelative"} sandboxPrefix=${config.inboundMediaSandboxRootPrefix ?? "(none)"}`);
                         fileItems = await saveInboundFilesToWorkspace({
                             rt,
                             cfg: ctx.cfg,
@@ -765,21 +640,14 @@ export const xgCworkImChannelPlugin: XgImChannelPlugin = {
                             log,
                         });
                     }
-
                     const text = buildInboundDisplayText(msgContent, fileItems);
-
                     if (!text.trim() && fileItems.length === 0) {
                         log.debug?.(`${logPrefix} Empty message (no text and no files), skipping`);
                         return;
                     }
-
-                    log.info(
-                        `${logPrefix} Message from ${senderName}(${senderId ?? "unknown"}) in group=${params.groupId}: ${text}`,
-                    );
-
+                    log.info(`${logPrefix} Message from ${senderName}(${senderId ?? "unknown"}) in group=${params.groupId}: ${text}`);
                     const currentIdentity = await getToken(config, log);
                     const actuallyMentioned = isActuallyMentioned(msg, params, currentIdentity, text);
-
                     // 通过 PluginRuntime 路由消息到 OpenClaw
                     const route = rt.channel.routing.resolveAgentRoute({
                         cfg: ctx.cfg,
@@ -789,17 +657,14 @@ export const xgCworkImChannelPlugin: XgImChannelPlugin = {
                         peer: { kind: "group", id: params.groupId },
                     });
                     log.info(`${logPrefix} [route] agentId=${route.agentId} sessionKey=${route.sessionKey}`);
-
                     const storePath = rt.channel.session.resolveStorePath(ctx.cfg.session?.store, {
                         agentId: route.agentId,
                     });
-
                     const envelopeOptions = rt.channel.reply.resolveEnvelopeFormatOptions(ctx.cfg);
                     const previousTimestamp = rt.channel.session.readSessionUpdatedAt({
                         storePath,
                         sessionKey: route.sessionKey,
                     });
-
                     const msgTime = params.timestamp ?? params.msgSendTime ?? 0;
                     const fromLabel = `${params.groupId} - ${senderName}`;
                     const body = rt.channel.reply.formatInboundEnvelope({
@@ -812,23 +677,18 @@ export const xgCworkImChannelPlugin: XgImChannelPlugin = {
                         previousTimestamp,
                         envelope: envelopeOptions,
                     });
-
                     const commandAuthorized = resolveInboundCommandAuthorized(rt, ctx.cfg, {
                         accountId: account.accountId,
                         senderId,
                         config,
                     });
-
                     const groupSystemPromptResolved = resolveXgImGroupSystemPrompt(ctx.cfg, account.accountId);
                     if (config.debug) {
-                        log.info(
-                            `${logPrefix} [GroupSystemPrompt] ` +
-                                (groupSystemPromptResolved
-                                    ? `active len=${groupSystemPromptResolved.length} preview=${JSON.stringify(groupSystemPromptResolved.slice(0, 96))}`
-                                    : "(empty — 若已配置 systemPrompt：检查网关是否加载了含本字段的插件构建，或把 systemPrompt 写到 accounts.<id> 再试)"),
-                        );
+                        log.info(`${logPrefix} [GroupSystemPrompt] ` +
+                            (groupSystemPromptResolved
+                                ? `active len=${groupSystemPromptResolved.length} preview=${JSON.stringify(groupSystemPromptResolved.slice(0, 96))}`
+                                : "(empty — 若已配置 systemPrompt：检查网关是否加载了含本字段的插件构建，或把 systemPrompt 写到 accounts.<id> 再试)"));
                     }
-
                     const inboundCtx = rt.channel.reply.finalizeInboundContext({
                         Body: body,
                         RawBody: text,
@@ -856,18 +716,15 @@ export const xgCworkImChannelPlugin: XgImChannelPlugin = {
                         // 同时保留原始 ext 供可能的后续逻辑使用
                         XgImExt: msgExt,
                     });
-
                     // 若消息内容为 /reset，则在将其转交给 OpenClaw 之前完整打印一次入站上下文，便于排查 reset 行为
                     if (text.trim() === "/reset") {
                         try {
-                            log.info?.(
-                                `${logPrefix} [reset] inboundCtx payload before dispatch: ${JSON.stringify(inboundCtx)}`,
-                            );
-                        } catch {
+                            log.info?.(`${logPrefix} [reset] inboundCtx payload before dispatch: ${JSON.stringify(inboundCtx)}`);
+                        }
+                        catch {
                             // 忽略 JSON 序列化异常，避免影响正常流程
                         }
                     }
-
                     // 【所有消息都必须做】记录到数据库！让 AI 产生“记忆”
                     log.info(`${logPrefix} [session] Recording inbound session sessionKey=${inboundCtx.SessionKey || route.sessionKey}`);
                     await rt.channel.session.recordInboundSession({
@@ -880,11 +737,10 @@ export const xgCworkImChannelPlugin: XgImChannelPlugin = {
                             to: params.groupId,
                             accountId: account.accountId,
                         },
-                        onRecordError: (err: unknown) => {
+                        onRecordError: (err) => {
                             log.error(`${logPrefix} Failed to record session: ${String(err)}`);
                         },
                     });
-
                     if (actuallyMentioned) {
                         await dispatchMentionedReply({
                             rt,
@@ -898,31 +754,31 @@ export const xgCworkImChannelPlugin: XgImChannelPlugin = {
                             currentIdentity,
                             streamClient: wsHandle.streamClient,
                         });
-                    } else {
+                    }
+                    else {
                         // 没 @ 我，仅作为旁观者缓存记忆，不打扰群里聊天
                         log.debug?.(`${logPrefix} Not mentioned in group, quietly memorized the message context.`);
                     }
-                } catch (err: unknown) {
+                }
+                catch (err) {
                     log.error(`${logPrefix} handleMessage error: ${String(err)}`);
                 }
             };
-
             // 5. 启动 WebSocket 连接
             const wsHandle = startWebSocket(config, identity.token, handleMessage, log);
-
             // 6. 阻塞到 abortSignal 触发（若存在）；若无 abortSignal，则交由进程生命周期管理
             if (ctx.abortSignal) {
-                await new Promise<void>((resolve) => {
-                    const abortHandler = (): void => {
+                await new Promise((resolve) => {
+                    const abortHandler = () => {
                         log.info(`${logPrefix} Abort signal received, stopping XG-IM channel...`);
                         wsHandle.stop();
                         clearTokenCache(config);
                         resolve();
                     };
-
                     ctx.abortSignal?.addEventListener("abort", abortHandler, { once: true });
                 });
             }
         },
     },
 };
+//# sourceMappingURL=channel.js.map