openclaw-channel-xiaozhu 2.1.0 → 3.0.0

package/dist/channel.d.ts

@@ -1,5 +1,7 @@
 /**
- * Channel 插件对象 — config / gateway / outbound / status 四个适配器
+ * Channel 插件对象 — 16 个适配器（config / gateway / outbound / status +
+ * messaging / groups / mentions / pairing / security / commands /
+ * streaming / threading / agentPrompt / directory / actions / heartbeat）
  */
 import type { HttpApiAccount, PluginRuntime, ChannelConfig, GatewayContext } from "./types.js";
 export declare function setRuntime(rt: PluginRuntime): void;
@@ -10,6 +12,7 @@ export declare const httpChannelPlugin: {
         label: string;
         selectionLabel: string;
         blurb: string;
+        docsPath: string;
         order: number;
         aliases: string[];
     };
@@ -20,17 +23,15 @@ export declare const httpChannelPlugin: {
         media: boolean;
         nativeCommands: boolean;
         blockStreaming: boolean;
-        fileUpload: boolean;
-        sessionManagement: boolean;
-        stt: boolean;
-        tts: boolean;
-        typing: boolean;
-        heartbeat: boolean;
-        webhookSigning: boolean;
+    };
+    defaults: {
+        queue: {
+            debounceMs: number;
+        };
     };
     config: {
         listAccountIds: (cfg: ChannelConfig) => string[];
-        resolveAccount: (cfg: ChannelConfig, accountId: string) => HttpApiAccount;
+        resolveAccount: (cfg: ChannelConfig, accountId?: string | null) => HttpApiAccount;
         defaultAccountId: (_cfg: ChannelConfig) => string;
         isConfigured: (account: HttpApiAccount) => boolean;
         describeAccount: (account: HttpApiAccount) => {
@@ -38,11 +39,6 @@ export declare const httpChannelPlugin: {
             name: string;
             enabled: boolean;
             configured: boolean;
-            features: {
-                perIpRateLimit: boolean;
-                webhookSigning: boolean;
-                commands: boolean;
-            };
         };
         setAccountEnabled: ({ cfg, accountId, enabled }: {
             cfg: ChannelConfig;
@@ -50,7 +46,7 @@ export declare const httpChannelPlugin: {
             enabled: boolean;
         }) => {
             channels: {
-                "channel-xiaozhu": {
+                "openclaw-channel-xiaozhu": {
                     accounts: {
                         [x: string]: Record<string, unknown>;
                     };
@@ -58,7 +54,7 @@ export declare const httpChannelPlugin: {
             };
         } | {
             channels: {
-                "channel-xiaozhu": {
+                "openclaw-channel-xiaozhu": {
                     enabled: boolean;
                 };
             };
@@ -71,6 +67,16 @@ export declare const httpChannelPlugin: {
                 [x: string]: Record<string, unknown>;
             };
         };
+        resolveAllowFrom: ({ cfg, accountId }: {
+            cfg: ChannelConfig;
+            accountId?: string | null;
+        }) => string[] | undefined;
+        formatAllowFrom: ({ allowFrom }: {
+            cfg: ChannelConfig;
+            accountId?: string | null;
+            allowFrom: Array<string | number>;
+        }) => string[];
+        resolveDefaultTo: () => string | undefined;
     };
     gateway: {
         startAccount: (ctx: GatewayContext) => Promise<void>;
@@ -78,6 +84,8 @@ export declare const httpChannelPlugin: {
     outbound: {
         deliveryMode: "direct";
         textChunkLimit: number;
+        chunker: (text: string, limit: number) => string[];
+        chunkerMode: "markdown";
         sendText: (opts: Record<string, unknown>) => Promise<{
             channel: string;
             ok: boolean;
@@ -96,6 +104,22 @@ export declare const httpChannelPlugin: {
             ok: boolean;
             error?: undefined;
         }>;
+        sendPayload: (ctx: Record<string, unknown>) => Promise<{
+            channel: string;
+            ok: boolean;
+            error: Error;
+            messageId?: undefined;
+        } | {
+            channel: string;
+            ok: boolean;
+            error: Error;
+            messageId: string;
+        } | {
+            channel: string;
+            ok: boolean;
+            messageId: string;
+            error?: undefined;
+        }>;
     };
     status: {
         defaultRuntime: {
@@ -103,7 +127,10 @@ export declare const httpChannelPlugin: {
             running: boolean;
             connected: boolean;
             lastStartAt: null;
+            lastStopAt: null;
             lastError: null;
+            lastInboundAt: null;
+            lastOutboundAt: null;
         };
         probeAccount: ({ account, timeoutMs }: {
             account: HttpApiAccount;
@@ -112,6 +139,146 @@ export declare const httpChannelPlugin: {
             ok: boolean;
             latencyMs: number;
         }>;
+        buildAccountSnapshot: ({ account, runtime }: {
+            account: HttpApiAccount;
+            cfg: ChannelConfig;
+            runtime?: Record<string, unknown>;
+        }) => {
+            accountId: string;
+            name: string;
+            enabled: boolean;
+            configured: boolean;
+            running: boolean;
+            connected: boolean;
+            lastStartAt: number | null;
+            lastStopAt: number | null;
+            lastError: string | null;
+            mode: "webhook" | "cloud";
+            lastInboundAt: number | null;
+            lastOutboundAt: number | null;
+        };
+        buildChannelSummary: ({ snapshot }: {
+            account: HttpApiAccount;
+            cfg: ChannelConfig;
+            defaultAccountId: string;
+            snapshot: Record<string, unknown>;
+        }) => {
+            configured: boolean;
+            running: boolean;
+            connected: boolean;
+            mode: string;
+            lastStartAt: {} | null;
+            lastStopAt: {} | null;
+            lastError: {} | null;
+            lastInboundAt: {} | null;
+            lastOutboundAt: {} | null;
+        };
+    };
+    messaging: {
+        normalizeTarget: (raw: string) => string | undefined;
+        targetResolver: {
+            looksLikeId: (raw: string) => boolean;
+            hint: string;
+        };
+        formatTargetDisplay: ({ target, display }: {
+            target: string;
+            display?: string;
+            kind?: string;
+        }) => string;
+    };
+    groups: {
+        resolveRequireMention: ({ cfg, accountId }: {
+            cfg: ChannelConfig;
+            accountId?: string | null;
+        }) => boolean | undefined;
+        resolveGroupIntroHint: ({ cfg, accountId }: {
+            cfg: ChannelConfig;
+            accountId?: string | null;
+        }) => string | undefined;
+    };
+    mentions: {
+        stripPatterns: () => string[];
+        stripMentions: ({ text }: {
+            text: string;
+        }) => string;
+    };
+    pairing: {
+        idLabel: string;
+        normalizeAllowEntry: (entry: string) => string;
+        notifyApproval: () => Promise<void>;
+    };
+    security: {
+        resolveDmPolicy: () => null;
+        collectWarnings: ({ account }: {
+            account: HttpApiAccount;
+        }) => string[];
+    };
+    commands: {
+        enforceOwnerForCommands: boolean;
+        skipWhenConfigEmpty: boolean;
+    };
+    streaming: {
+        blockStreamingCoalesceDefaults: {
+            minChars: number;
+            idleMs: number;
+        };
+    };
+    threading: {
+        resolveReplyToMode: ({ cfg, accountId }: {
+            cfg: ChannelConfig;
+            accountId?: string | null;
+        }) => "off" | "first" | "all";
+        allowExplicitReplyTagsWhenOff: boolean;
+    };
+    agentPrompt: {
+        messageToolHints: () => string[];
+    };
+    directory: {
+        self: ({ accountId }: {
+            accountId?: string;
+        }) => Promise<{
+            id: string;
+            name: string;
+            kind: string;
+        } | null>;
+        listPeers: ({ accountId }: {
+            accountId?: string;
+        }) => Promise<{
+            id: string;
+            name: string;
+            kind: string;
+        }[]>;
+        listGroups: ({ accountId }: {
+            accountId?: string;
+        }) => Promise<{
+            id: string;
+            name: string;
+            kind: string;
+        }[]>;
+    };
+    actions: {
+        listActions: () => string[];
+        supportsAction: ({ action }: {
+            action: string;
+        }) => boolean;
+        supportsButtons: () => boolean;
+        supportsCards: () => boolean;
+    };
+    heartbeat: {
+        checkReady: ({ cfg, accountId }: {
+            cfg: ChannelConfig;
+            accountId?: string | null;
+        }) => Promise<{
+            ok: boolean;
+            reason: string;
+        }>;
+        resolveRecipients: ({ cfg, accountId }: {
+            cfg: ChannelConfig;
+            accountId?: string | null;
+        }) => {
+            recipients: string[];
+            source: string;
+        };
     };
 };
 //# sourceMappingURL=channel.d.ts.map

package/dist/channel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../src/channel.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAU,MAAM,YAAY,CAAC;AAQvG,wBAAgB,UAAU,CAAC,EAAE,EAAE,aAAa,QAE3C;AAwCD,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;8BA8BJ,aAAa,KAAG,MAAM,EAAE;8BAcxB,aAAa,aAAa,MAAM,KAAG,cAAc;iCAc9C,aAAa,KAAG,MAAM;gCAEvB,cAAc,KAAG,OAAO;mCAIrB,cAAc;;;;;;;;;;;yDAYQ;YAAE,GAAG,EAAE,aAAa,CAAC;YAAC,SAAS,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,OAAO,CAAA;SAAE;;;;;;;;;;;;;;;4CAYxE;YAAE,GAAG,EAAE,aAAa,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE;;;;;;;4BAiBnD,cAAc;;;;;yBA8EjB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;0BAoCtB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;;;;;;;;;+CA0CF;YAAE,OAAO,EAAE,cAAc,CAAC;YAAC,SAAS,CAAC,EAAE,MAAM,CAAA;SAAE;;;;;CAa/F,CAAC"}
+{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../src/channel.ts"],"names":[],"mappings":"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"}

package/dist/channel.js

@@ -1,11 +1,13 @@
 /**
- * Channel 插件对象 — config / gateway / outbound / status 四个适配器
+ * Channel 插件对象 — 16 个适配器（config / gateway / outbound / status +
+ * messaging / groups / mentions / pairing / security / commands /
+ * streaming / threading / agentPrompt / directory / actions / heartbeat）
  */
-import { startHttpServer, getRuntimeWebhookUrl } from "./server.js";
+import { startHttpServer, getRuntimeWebhookUrl, getAccountState } from "./server.js";
 import { startRelayClient } from "./relay/client.js";
 import { sendWithRetry } from "./utils/webhook-sender.js";
 import { chunkText } from "./utils/text-chunker.js";
-const CHANNEL_ID = "channel-xiaozhu";
+const CHANNEL_ID = "openclaw-channel-xiaozhu";
 const DEFAULT_PORT = 18800;
 const DEFAULT_RELAY_URL = "wss://relay.xiaozhu.ai/ws/bot";
 let pluginRuntime = null;
@@ -46,15 +48,24 @@ function parseAccountFromRaw(raw, accountId) {
         networkMode: raw.networkMode,
         relayUrl: raw.relayUrl,
         relayToken: raw.relayToken,
+        requireMention: raw.requireMention,
+        groupIntroHint: raw.groupIntroHint,
+        replyToMode: raw.replyToMode,
+        dmPolicy: raw.dmPolicy,
     };
 }
+/** 解析账号的快捷方式（供多个适配器复用） */
+function resolveAccount(cfg, accountId) {
+    return httpChannelPlugin.config.resolveAccount(cfg, accountId || "default");
+}
 export const httpChannelPlugin = {
     id: CHANNEL_ID,
     meta: {
         id: CHANNEL_ID,
         label: "小助",
-        selectionLabel: "小助",
+        selectionLabel: "小助 (HTTP/SSE)",
         blurb: "通过 HTTP/SSE 接口接入对话的通用渠道",
+        docsPath: "/docs/channels/xiaozhu",
         order: 90,
         aliases: ["xiaozhu", "http", "api", "rest"],
     },
@@ -65,13 +76,9 @@ export const httpChannelPlugin = {
         media: true,
         nativeCommands: true,
         blockStreaming: true,
-        fileUpload: true,
-        sessionManagement: true,
-        stt: true,
-        tts: true,
-        typing: true,
-        heartbeat: true,
-        webhookSigning: true,
+    },
+    defaults: {
+        queue: { debounceMs: 300 },
     },
     // ── config 适配器 ──
     config: {
@@ -90,14 +97,15 @@ export const httpChannelPlugin = {
         },
         resolveAccount: (cfg, accountId) => {
             const ch = getChannelConfig(cfg) || {};
+            const id = accountId || "default";
             // 多账号模式
             if (ch.accounts && typeof ch.accounts === "object" && !Array.isArray(ch.accounts)) {
                 const accounts = ch.accounts;
-                const raw = accounts[accountId] || {};
-                return parseAccountFromRaw(raw, accountId);
+                const raw = accounts[id] || {};
+                return parseAccountFromRaw(raw, id);
             }
             // 单账号模式
-            return parseAccountFromRaw(ch, accountId);
+            return parseAccountFromRaw(ch, id);
         },
         defaultAccountId: (_cfg) => "default",
         isConfigured: (account) => {
@@ -108,36 +116,35 @@ export const httpChannelPlugin = {
             name: `小助 :${account.port}`,
             enabled: account.enabled,
             configured: !!account.token,
-            features: {
-                perIpRateLimit: !!account.perIpRateLimit,
-                webhookSigning: !!account.webhookSecret,
-                commands: account.commandsEnabled !== false,
-            },
         }),
         setAccountEnabled: ({ cfg, accountId, enabled }) => {
             const ch = getChannelConfig(cfg) || {};
-            // 多账号模式：设置具体账号的 enabled
             if (ch.accounts && typeof ch.accounts === "object" && !Array.isArray(ch.accounts)) {
                 const accounts = { ...ch.accounts };
                 accounts[accountId] = { ...accounts[accountId], enabled };
                 return { ...cfg, channels: { ...cfg.channels, [CHANNEL_ID]: { ...ch, accounts } } };
             }
-            // 单账号模式
             return { ...cfg, channels: { ...cfg.channels, [CHANNEL_ID]: { ...ch, enabled } } };
         },
         deleteAccount: ({ cfg, accountId }) => {
             const ch = getChannelConfig(cfg) || {};
-            // 多账号模式：只删除指定账号
             if (ch.accounts && typeof ch.accounts === "object" && !Array.isArray(ch.accounts)) {
                 const accounts = { ...ch.accounts };
                 delete accounts[accountId];
                 return { ...cfg, channels: { ...cfg.channels, [CHANNEL_ID]: { ...ch, accounts } } };
             }
-            // 单账号模式：删除整个渠道
             const channels = { ...cfg.channels };
             delete channels[CHANNEL_ID];
             return { ...cfg, channels };
         },
+        resolveAllowFrom: ({ cfg, accountId }) => {
+            const account = resolveAccount(cfg, accountId);
+            return account.allowFrom;
+        },
+        formatAllowFrom: ({ allowFrom }) => {
+            return allowFrom.map((e) => String(e).trim()).filter(Boolean);
+        },
+        resolveDefaultTo: () => undefined,
     },
     // ── gateway 适配器 ──
     gateway: {
@@ -212,6 +219,8 @@ export const httpChannelPlugin = {
     outbound: {
         deliveryMode: "direct",
         textChunkLimit: 4000,
+        chunker: (text, limit) => chunkText(text, { maxLength: limit }),
+        chunkerMode: "markdown",
         sendText: async (opts) => {
             const account = opts?.account;
             const text = opts?.text || "";
@@ -223,7 +232,6 @@ export const httpChannelPlugin = {
             if (!text) {
                 return { channel: CHANNEL_ID, ok: true };
             }
-            // Fence-aware chunking for long messages
             const chunks = chunkText(text, { maxLength: account?.textChunkLimit || 4000 });
             for (const chunk of chunks) {
                 const result = await sendWithRetry({
@@ -264,6 +272,40 @@ export const httpChannelPlugin = {
             }
             return { channel: CHANNEL_ID, ok: true };
         },
+        sendPayload: async (ctx) => {
+            const cfg = ctx.cfg;
+            const accountId = ctx.accountId;
+            const to = ctx.to;
+            const payload = ctx.payload;
+            const account = cfg ? resolveAccount(cfg, accountId) : undefined;
+            const webhookUrl = getRuntimeWebhookUrl(accountId) || account?.webhookUrl;
+            if (!webhookUrl) {
+                return { channel: CHANNEL_ID, ok: false, error: new Error("No webhookUrl configured for payload delivery") };
+            }
+            // 优先发送渠道专属数据（channelData.xiaozhu），回退到通用 text
+            const channelData = payload?.channelData?.xiaozhu;
+            const webhookPayload = channelData || {
+                type: "payload",
+                text: payload?.text || "",
+                session: to || "",
+                from: "openclaw",
+                channel: CHANNEL_ID,
+                timestamp: Date.now(),
+                ...(payload?.mediaUrl ? { mediaUrl: payload.mediaUrl } : {}),
+            };
+            const result = await sendWithRetry({
+                url: webhookUrl,
+                payload: webhookPayload,
+                token: account?.token || "",
+                secret: account?.webhookSecret,
+                maxAttempts: account?.webhookRetry?.maxAttempts ?? 3,
+                baseDelayMs: account?.webhookRetry?.baseDelayMs ?? 1000,
+            });
+            if (!result.ok) {
+                return { channel: CHANNEL_ID, ok: false, error: result.error || new Error("Webhook payload failed"), messageId: "" };
+            }
+            return { channel: CHANNEL_ID, ok: true, messageId: "" };
+        },
     },
     // ── status 适配器 ──
     status: {
@@ -272,12 +314,20 @@ export const httpChannelPlugin = {
             running: false,
             connected: false,
             lastStartAt: null,
+            lastStopAt: null,
             lastError: null,
+            lastInboundAt: null,
+            lastOutboundAt: null,
         },
         probeAccount: async ({ account, timeoutMs }) => {
             const start = Date.now();
             try {
-                const res = await fetch(`http://127.0.0.1:${account.port}/api/health`, { signal: AbortSignal.timeout(timeoutMs ?? 3000) });
+                const ctrl = new AbortController();
+                const timer = setTimeout(() => ctrl.abort(), timeoutMs ?? 3000);
+                if (timer.unref)
+                    timer.unref();
+                const res = await fetch(`http://127.0.0.1:${account.port}/api/health`, { signal: ctrl.signal });
+                clearTimeout(timer);
                 const latencyMs = Date.now() - start;
                 let data = null;
                 try {
@@ -290,6 +340,175 @@ export const httpChannelPlugin = {
                 return { ok: false, latencyMs: Date.now() - start };
             }
         },
+        buildAccountSnapshot: ({ account, runtime }) => ({
+            accountId: account.accountId,
+            name: `小助 :${account.port}`,
+            enabled: account.enabled,
+            configured: !!account.token,
+            running: runtime?.running ?? false,
+            connected: runtime?.connected ?? false,
+            lastStartAt: runtime?.lastStartAt ?? null,
+            lastStopAt: runtime?.lastStopAt ?? null,
+            lastError: runtime?.lastError ?? null,
+            mode: account.networkMode || "webhook",
+            lastInboundAt: runtime?.lastInboundAt ?? null,
+            lastOutboundAt: runtime?.lastOutboundAt ?? null,
+        }),
+        buildChannelSummary: ({ snapshot }) => ({
+            configured: snapshot.configured ?? false,
+            running: snapshot.running ?? false,
+            connected: snapshot.connected ?? false,
+            mode: snapshot.mode ?? "webhook",
+            lastStartAt: snapshot.lastStartAt ?? null,
+            lastStopAt: snapshot.lastStopAt ?? null,
+            lastError: snapshot.lastError ?? null,
+            lastInboundAt: snapshot.lastInboundAt ?? null,
+            lastOutboundAt: snapshot.lastOutboundAt ?? null,
+        }),
+    },
+    // ── messaging 适配器 ──
+    messaging: {
+        normalizeTarget: (raw) => {
+            const trimmed = raw.trim().toLowerCase();
+            return trimmed || undefined;
+        },
+        targetResolver: {
+            looksLikeId: (raw) => /^[\w.@:+\-]{1,128}$/.test(raw.trim()),
+            hint: "用户 ID（字母、数字、下划线、点、@、冒号、加号、减号）",
+        },
+        formatTargetDisplay: ({ target, display }) => {
+            return display || target;
+        },
+    },
+    // ── groups 适配器 ──
+    groups: {
+        resolveRequireMention: ({ cfg, accountId }) => {
+            const account = resolveAccount(cfg, accountId);
+            return account.requireMention;
+        },
+        resolveGroupIntroHint: ({ cfg, accountId }) => {
+            const account = resolveAccount(cfg, accountId);
+            return account.groupIntroHint;
+        },
+    },
+    // ── mentions 适配器 ──
+    mentions: {
+        stripPatterns: () => [
+            "^@小助\\s*",
+            "^@xiaozhu\\s*",
+            "^@bot\\s*",
+        ],
+        stripMentions: ({ text }) => {
+            return text.replace(/^@(?:小助|xiaozhu|bot)\s*/i, "").trim();
+        },
+    },
+    // ── pairing 适配器 ──
+    pairing: {
+        idLabel: "用户 ID",
+        normalizeAllowEntry: (entry) => entry.trim().toLowerCase(),
+        notifyApproval: async () => {
+            // HTTP 渠道无原生推送通道，审批通知通过 webhook 推送（如已配置）
+        },
+    },
+    // ── security 适配器 ──
+    security: {
+        resolveDmPolicy: () => null, // 使用 OpenClaw 默认策略（HTTP 已有 token 鉴权）
+        collectWarnings: ({ account }) => {
+            const warnings = [];
+            if (!account.token)
+                warnings.push("未配置 token，服务不可用");
+            if (account.allowFrom?.includes("*"))
+                warnings.push("allowFrom 设为 *，任何人可发送消息");
+            if (!account.webhookUrl && account.networkMode !== "cloud") {
+                warnings.push("未配置 webhookUrl，outbound 消息无法推送");
+            }
+            return warnings;
+        },
+    },
+    // ── commands 适配器 ──
+    commands: {
+        enforceOwnerForCommands: false,
+        skipWhenConfigEmpty: false,
+    },
+    // ── streaming 适配器 ──
+    streaming: {
+        blockStreamingCoalesceDefaults: { minChars: 200, idleMs: 500 },
+    },
+    // ── threading 适配器 ──
+    threading: {
+        resolveReplyToMode: ({ cfg, accountId }) => {
+            if (!accountId)
+                return "off";
+            const account = resolveAccount(cfg, accountId);
+            return account.replyToMode || "off";
+        },
+        allowExplicitReplyTagsWhenOff: false,
+    },
+    // ── agentPrompt 适配器 ──
+    agentPrompt: {
+        messageToolHints: () => [
+            "用户通过 HTTP API 发送消息，支持文本、图片、文件和语音",
+            "回复支持 Markdown 格式，长回复会自动分块（围栏感知）",
+        ],
+    },
+    // ── directory 适配器 ──
+    directory: {
+        self: async ({ accountId }) => {
+            return {
+                id: `${CHANNEL_ID}:${accountId || "default"}`,
+                name: `小助 (${accountId || "default"})`,
+                kind: "bot",
+            };
+        },
+        listPeers: async ({ accountId }) => {
+            const state = getAccountState(accountId);
+            if (!state)
+                return [];
+            const sessions = state.sessionStore.list({ accountId, chatType: "direct" });
+            const seen = new Set();
+            return sessions
+                .filter((s) => { if (seen.has(s.from))
+                return false; seen.add(s.from); return true; })
+                .map((s) => ({ id: s.from, name: s.from, kind: "user" }));
+        },
+        listGroups: async ({ accountId }) => {
+            const state = getAccountState(accountId);
+            if (!state)
+                return [];
+            return state.sessionStore.list({ accountId, chatType: "group" })
+                .map((s) => ({ id: s.session, name: s.session, kind: "group" }));
+        },
+    },
+    // ── actions 适配器 ──
+    actions: {
+        listActions: () => ["reply", "forward"],
+        supportsAction: ({ action }) => action === "reply" || action === "forward",
+        supportsButtons: () => false,
+        supportsCards: () => false,
+    },
+    // ── heartbeat 适配器 ──
+    heartbeat: {
+        checkReady: async ({ cfg, accountId }) => {
+            const account = resolveAccount(cfg, accountId);
+            try {
+                const ctrl = new AbortController();
+                const timer = setTimeout(() => ctrl.abort(), 3000);
+                if (timer.unref)
+                    timer.unref();
+                const res = await fetch(`http://127.0.0.1:${account.port}/api/health`, { signal: ctrl.signal });
+                clearTimeout(timer);
+                const data = await res.json();
+                return { ok: data.ok === true, reason: data.ok ? "healthy" : "health check returned ok=false" };
+            }
+            catch (err) {
+                return { ok: false, reason: err instanceof Error ? err.message : "health check failed" };
+            }
+        },
+        resolveRecipients: ({ cfg, accountId }) => {
+            const account = resolveAccount(cfg, accountId);
+            const url = getRuntimeWebhookUrl(account.accountId) || account.webhookUrl;
+            return url ? { recipients: [url], source: "webhook" } : { recipients: [], source: "none" };
+        },
     },
 };
 //# sourceMappingURL=channel.js.map