@larksuite/openclaw-lark 2026.3.9

package/src/messaging/converters/types.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Shared types for the content converter system.
+ */
+import type { ClawdbotConfig } from 'openclaw/plugin-sdk';
+import type { LarkAccount } from '../../core/types';
+import type { MentionInfo, ResourceDescriptor } from '../types';
+/**
+ * Shape of a message item returned by the Feishu IM API.
+ *
+ * Used by `buildConvertContextFromItem` (content-converter) and the
+ * `merge_forward` converter to process sub-messages and history items
+ * without resorting to `any`.
+ */
+export interface ApiMessageItem {
+    message_id?: string;
+    msg_type?: string;
+    create_time?: string;
+    upper_message_id?: string;
+    body?: {
+        content?: string;
+    };
+    sender?: {
+        id?: string;
+        sender_type?: string;
+    };
+    mentions?: Array<{
+        key: string;
+        id: unknown;
+        name?: string;
+    }>;
+    parent_id?: string;
+    thread_id?: string;
+    deleted?: boolean;
+    updated?: boolean;
+}
+/** Context passed to every converter function. */
+export interface ConvertContext {
+    /** Map from placeholder key ("@_user_X") to structured mention info. */
+    mentions: Map<string, MentionInfo>;
+    /** Reverse map from openId to MentionInfo for O(1) lookup. */
+    mentionsByOpenId: Map<string, MentionInfo>;
+    messageId: string;
+    botOpenId?: string;
+    /** Plugin config — retained for non-converter downstream consumers. */
+    cfg?: ClawdbotConfig;
+    /**
+     * Pre-resolved account — retained for non-converter downstream consumers.
+     * merge_forward no longer reads this; it uses injected callbacks instead.
+     */
+    account?: LarkAccount;
+    /** Account identifier for multi-account setups. */
+    accountId?: string;
+    /** Synchronous lookup of cached user display name by openId. */
+    resolveUserName?: (openId: string) => string | undefined;
+    /**
+     * Async batch name resolution callback.
+     *
+     * Called by merge_forward to resolve sub-message sender names.
+     * The callback should populate whatever cache `resolveUserName` reads from.
+     * All callers must inject this; merge_forward has no internal fallback.
+     */
+    batchResolveNames?: (openIds: string[]) => Promise<void>;
+    /**
+     * Async callback to fetch sub-messages of a merge_forward container.
+     *
+     * Returns the flat items array from the IM API response.
+     * All callers must inject this; merge_forward has no internal fallback
+     * and returns `<forwarded_messages/>` when not provided.
+     */
+    fetchSubMessages?: (messageId: string) => Promise<ApiMessageItem[]>;
+    /** 是否删除机器人 mention（事件推送场景=true，历史消息读取=false） */
+    stripBotMentions?: boolean;
+}
+/** Result produced by a converter function. */
+export interface ConvertResult {
+    /** AI-friendly formatted text. */
+    content: string;
+    /** Resource descriptors (images, files, audio, video, stickers). */
+    resources: ResourceDescriptor[];
+}
+/**
+ * Converter function for a single message type.
+ *
+ * May return a ConvertResult synchronously or a Promise for types that
+ * require async operations (e.g. merge_forward expansion via API).
+ */
+export type ContentConverterFn = (raw: string, ctx: ConvertContext) => ConvertResult | Promise<ConvertResult>;
+/**
+ * Element within a Feishu "post" (rich text) content block.
+ *
+ * Shared by the `post` and `todo` converters.
+ */
+export interface PostElement {
+    tag: string;
+    text?: string;
+    href?: string;
+    image_key?: string;
+    file_key?: string;
+    user_id?: string;
+    user_name?: string;
+    style?: string[];
+    language?: string;
+    un_escape?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/src/messaging/converters/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/messaging/converters/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAEhE;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5B,MAAM,CAAC,EAAE;QACP,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,QAAQ,CAAC,EAAE,KAAK,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,EAAE,EAAE,OAAO,CAAC;QACZ,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,kDAAkD;AAClD,MAAM,WAAW,cAAc;IAC7B,wEAAwE;IACxE,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACnC,8DAA8D;IAC9D,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB;;;OAGG;IACH,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IACzD;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IACpE,gDAAgD;IAChD,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,+CAA+C;AAC/C,MAAM,WAAW,aAAa;IAC5B,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,SAAS,EAAE,kBAAkB,EAAE,CAAC;CACjC;AAED;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,cAAc,KAAK,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;AAE9G;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB"}

package/src/messaging/converters/types.js

@@ -0,0 +1,8 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Shared types for the content converter system.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/src/messaging/converters/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/messaging/converters/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/src/messaging/converters/unknown.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Fallback converter for unsupported message types.
+ */
+import type { ContentConverterFn } from './types';
+export declare const convertUnknown: ContentConverterFn;
+//# sourceMappingURL=unknown.d.ts.map

package/src/messaging/converters/unknown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unknown.d.ts","sourceRoot":"","sources":["../../../../src/messaging/converters/unknown.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAGlD,eAAO,MAAM,cAAc,EAAE,kBAO5B,CAAC"}

package/src/messaging/converters/unknown.js

@@ -0,0 +1,17 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Fallback converter for unsupported message types.
+ */
+import { safeParse } from './utils';
+export const convertUnknown = (raw) => {
+    const parsed = safeParse(raw);
+    if (parsed != null && typeof parsed === 'object' && 'text' in parsed) {
+        const text = parsed.text;
+        if (typeof text === 'string')
+            return { content: text, resources: [] };
+    }
+    return { content: '[unsupported message]', resources: [] };
+};
+//# sourceMappingURL=unknown.js.map

package/src/messaging/converters/unknown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unknown.js","sourceRoot":"","sources":["../../../../src/messaging/converters/unknown.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC,MAAM,CAAC,MAAM,cAAc,GAAuB,CAAC,GAAG,EAAE,EAAE;IACxD,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,MAAM,IAAI,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;QACrE,MAAM,IAAI,GAAI,MAAkC,CAAC,IAAI,CAAC;QACtD,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IACxE,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,uBAAuB,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;AAC7D,CAAC,CAAC"}

package/src/messaging/converters/utils.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Shared utilities for content converters.
+ */
+/** Escape a string for safe use inside a RegExp. */
+export declare function escapeRegExp(str: string): string;
+/**
+ * Safely parse a JSON string, returning undefined on failure.
+ */
+export declare function safeParse(raw: string): unknown | undefined;
+/**
+ * Format a duration in milliseconds to a human-readable string.
+ *
+ * Examples: 1500 → "1.5s", 65000 → "65s"
+ */
+export declare function formatDuration(ms: number): string;
+/**
+ * Convert a millisecond timestamp to "YYYY-MM-DD HH:mm" in UTC+8 (Beijing time).
+ */
+export declare function millisToDatetime(ms: string | number): string;
+//# sourceMappingURL=utils.d.ts.map

package/src/messaging/converters/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/messaging/converters/utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,oDAAoD;AACpD,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAM1D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAKjD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAe5D"}

package/src/messaging/converters/utils.js

@@ -0,0 +1,52 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Shared utilities for content converters.
+ */
+/** Escape a string for safe use inside a RegExp. */
+export function escapeRegExp(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/**
+ * Safely parse a JSON string, returning undefined on failure.
+ */
+export function safeParse(raw) {
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Format a duration in milliseconds to a human-readable string.
+ *
+ * Examples: 1500 → "1.5s", 65000 → "65s"
+ */
+export function formatDuration(ms) {
+    const seconds = ms / 1000;
+    if (seconds < 1)
+        return `${ms}ms`;
+    if (Number.isInteger(seconds))
+        return `${seconds}s`;
+    return `${seconds.toFixed(1)}s`;
+}
+/**
+ * Convert a millisecond timestamp to "YYYY-MM-DD HH:mm" in UTC+8 (Beijing time).
+ */
+export function millisToDatetime(ms) {
+    const num = Number(ms);
+    if (!Number.isFinite(num))
+        return String(ms);
+    // UTC+8 offset in milliseconds
+    const utc8Offset = 8 * 60 * 60 * 1000;
+    const d = new Date(num + utc8Offset);
+    const year = d.getUTCFullYear();
+    const month = String(d.getUTCMonth() + 1).padStart(2, '0');
+    const day = String(d.getUTCDate()).padStart(2, '0');
+    const hour = String(d.getUTCHours()).padStart(2, '0');
+    const minute = String(d.getUTCMinutes()).padStart(2, '0');
+    return `${year}-${month}-${day} ${hour}:${minute}`;
+}
+//# sourceMappingURL=utils.js.map

package/src/messaging/converters/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../src/messaging/converters/utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,oDAAoD;AACpD,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,OAAO,GAAG,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AACpD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,EAAU;IACvC,MAAM,OAAO,GAAG,EAAE,GAAG,IAAI,CAAC;IAC1B,IAAI,OAAO,GAAG,CAAC;QAAE,OAAO,GAAG,EAAE,IAAI,CAAC;IAClC,IAAI,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC;QAAE,OAAO,GAAG,OAAO,GAAG,CAAC;IACpD,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAAmB;IAClD,MAAM,GAAG,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC;IACvB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC;IAE7C,+BAA+B;IAC/B,MAAM,UAAU,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IACtC,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,GAAG,UAAU,CAAC,CAAC;IAErC,MAAM,IAAI,GAAG,CAAC,CAAC,cAAc,EAAE,CAAC;IAChC,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC3D,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACpD,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACtD,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAE1D,OAAO,GAAG,IAAI,IAAI,KAAK,IAAI,GAAG,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;AACrD,CAAC"}

package/src/messaging/converters/video-chat.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Converter for "video_chat" message type.
+ */
+import type { ContentConverterFn } from './types';
+export declare const convertVideoChat: ContentConverterFn;
+//# sourceMappingURL=video-chat.d.ts.map

package/src/messaging/converters/video-chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-chat.d.ts","sourceRoot":"","sources":["../../../../src/messaging/converters/video-chat.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAGlD,eAAO,MAAM,gBAAgB,EAAE,kBAyB9B,CAAC"}

package/src/messaging/converters/video-chat.js

@@ -0,0 +1,24 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Converter for "video_chat" message type.
+ */
+import { safeParse, millisToDatetime } from './utils';
+export const convertVideoChat = (raw) => {
+    const parsed = safeParse(raw);
+    const topic = parsed?.topic ?? '';
+    const parts = [];
+    if (topic) {
+        parts.push(`📹 ${topic}`);
+    }
+    if (parsed?.start_time) {
+        parts.push(`🕙 ${millisToDatetime(parsed.start_time)}`);
+    }
+    const inner = parts.join('\n') || '[video chat]';
+    return {
+        content: `<meeting>${inner}</meeting>`,
+        resources: [],
+    };
+};
+//# sourceMappingURL=video-chat.js.map

package/src/messaging/converters/video-chat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-chat.js","sourceRoot":"","sources":["../../../../src/messaging/converters/video-chat.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEtD,MAAM,CAAC,MAAM,gBAAgB,GAAuB,CAAC,GAAG,EAAE,EAAE;IAC1D,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAKf,CAAC;IAEd,MAAM,KAAK,GAAG,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC;IAClC,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,KAAK,EAAE,CAAC;QACV,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC;IAC5B,CAAC;IAED,IAAI,MAAM,EAAE,UAAU,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,MAAM,gBAAgB,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,cAAc,CAAC;IAEjD,OAAO;QACL,OAAO,EAAE,YAAY,KAAK,YAAY;QACtC,SAAS,EAAE,EAAE;KACd,CAAC;AACJ,CAAC,CAAC"}

package/src/messaging/converters/video.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Converter for "video" and "media" message types.
+ */
+import type { ContentConverterFn } from './types';
+export declare const convertVideo: ContentConverterFn;
+//# sourceMappingURL=video.d.ts.map

package/src/messaging/converters/video.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video.d.ts","sourceRoot":"","sources":["../../../../src/messaging/converters/video.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAIlD,eAAO,MAAM,YAAY,EAAE,kBAkC1B,CAAC"}

package/src/messaging/converters/video.js

@@ -0,0 +1,33 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Converter for "video" and "media" message types.
+ */
+import { safeParse } from './utils';
+import { formatDuration } from './utils';
+export const convertVideo = (raw) => {
+    const parsed = safeParse(raw);
+    const fileKey = parsed?.file_key;
+    if (!fileKey) {
+        return { content: '[video]', resources: [] };
+    }
+    const fileName = parsed?.file_name ?? '';
+    const duration = parsed?.duration;
+    const coverKey = parsed?.image_key;
+    const nameAttr = fileName ? ` name="${fileName}"` : '';
+    const durationAttr = duration != null ? ` duration="${formatDuration(duration)}"` : '';
+    return {
+        content: `<video key="${fileKey}"${nameAttr}${durationAttr}/>`,
+        resources: [
+            {
+                type: 'video',
+                fileKey,
+                fileName: fileName || undefined,
+                duration: duration ?? undefined,
+                coverImageKey: coverKey ?? undefined,
+            },
+        ],
+    };
+};
+//# sourceMappingURL=video.js.map

package/src/messaging/converters/video.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"video.js","sourceRoot":"","sources":["../../../../src/messaging/converters/video.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEzC,MAAM,CAAC,MAAM,YAAY,GAAuB,CAAC,GAAG,EAAE,EAAE;IACtD,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAOf,CAAC;IAEd,MAAM,OAAO,GAAG,MAAM,EAAE,QAAQ,CAAC;IACjC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IAC/C,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,EAAE,SAAS,IAAI,EAAE,CAAC;IACzC,MAAM,QAAQ,GAAG,MAAM,EAAE,QAAQ,CAAC;IAClC,MAAM,QAAQ,GAAG,MAAM,EAAE,SAAS,CAAC;IAEnC,MAAM,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,UAAU,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACvD,MAAM,YAAY,GAAG,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,cAAc,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAEvF,OAAO;QACL,OAAO,EAAE,eAAe,OAAO,IAAI,QAAQ,GAAG,YAAY,IAAI;QAC9D,SAAS,EAAE;YACT;gBACE,IAAI,EAAE,OAAO;gBACb,OAAO;gBACP,QAAQ,EAAE,QAAQ,IAAI,SAAS;gBAC/B,QAAQ,EAAE,QAAQ,IAAI,SAAS;gBAC/B,aAAa,EAAE,QAAQ,IAAI,SAAS;aACrC;SACF;KACF,CAAC;AACJ,CAAC,CAAC"}

package/src/messaging/converters/vote.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Converter for "vote" message type.
+ */
+import type { ContentConverterFn } from './types';
+export declare const convertVote: ContentConverterFn;
+//# sourceMappingURL=vote.d.ts.map

package/src/messaging/converters/vote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vote.d.ts","sourceRoot":"","sources":["../../../../src/messaging/converters/vote.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAGlD,eAAO,MAAM,WAAW,EAAE,kBA2BzB,CAAC"}

package/src/messaging/converters/vote.js

@@ -0,0 +1,25 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Converter for "vote" message type.
+ */
+import { safeParse } from './utils';
+export const convertVote = (raw) => {
+    const parsed = safeParse(raw);
+    const topic = parsed?.topic ?? '';
+    const options = parsed?.options ?? [];
+    const parts = [];
+    if (topic) {
+        parts.push(topic);
+    }
+    for (const opt of options) {
+        parts.push(`• ${opt}`);
+    }
+    const inner = parts.join('\n') || '[vote]';
+    return {
+        content: `<vote>\n${inner}\n</vote>`,
+        resources: [],
+    };
+};
+//# sourceMappingURL=vote.js.map

package/src/messaging/converters/vote.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vote.js","sourceRoot":"","sources":["../../../../src/messaging/converters/vote.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC,MAAM,CAAC,MAAM,WAAW,GAAuB,CAAC,GAAG,EAAE,EAAE;IACrD,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAKf,CAAC;IAEd,MAAM,KAAK,GAAG,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC;IAClC,MAAM,OAAO,GAAG,MAAM,EAAE,OAAO,IAAI,EAAE,CAAC;IAEtC,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,KAAK,EAAE,CAAC;QACV,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;IACzB,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC;IAE3C,OAAO;QACL,OAAO,EAAE,WAAW,KAAK,WAAW;QACpC,SAAS,EAAE,EAAE;KACd,CAAC;AACJ,CAAC,CAAC"}

package/src/messaging/inbound/dedup.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * FIFO-based message deduplication.
+ *
+ * Feishu WebSocket connections may redeliver messages on reconnect.
+ * This module tracks recently-seen message IDs and filters duplicates.
+ *
+ * Design choices:
+ * - FIFO eviction (not LRU) — message IDs are write-once/check-once,
+ *   no hot/cold access pattern.  FIFO naturally expires the oldest entry
+ *   first, which matches the dedup semantics.
+ * - ES2015 `Map` preserves insertion order, giving us FIFO for free.
+ * - Periodic sweep leverages FIFO ordering: iterate from oldest and
+ *   `break` at the first non-expired entry → O(expired), not O(n).
+ */
+export interface MessageDedupOpts {
+    /** Time-to-live for each entry in milliseconds (default: 5 min). */
+    ttlMs?: number;
+    /** Maximum number of tracked entries (default: 10 000). */
+    maxEntries?: number;
+}
+/**
+ * Check whether a message is too old to process.
+ *
+ * Feishu message `create_time` is a millisecond Unix timestamp encoded
+ * as a string.  When a WebSocket reconnects after a long outage, stale
+ * messages may be redelivered — this function lets callers discard them
+ * before entering the full handling pipeline.
+ */
+export declare function isMessageExpired(createTimeStr: string | undefined, expiryMs?: number): boolean;
+export declare class MessageDedup {
+    private readonly store;
+    private readonly ttlMs;
+    private readonly maxEntries;
+    private readonly sweepTimer;
+    constructor(opts?: MessageDedupOpts);
+    /**
+     * Try to record a message ID.
+     *
+     * @param id   Unique message identifier (e.g. Feishu `message_id`).
+     * @param scope Optional scope prefix (e.g. accountId) to namespace IDs.
+     * @returns `true` if the message is **new**; `false` if it is a duplicate.
+     */
+    tryRecord(id: string, scope?: string): boolean;
+    /** Current number of tracked entries (for diagnostics). */
+    get size(): number;
+    /** Remove all entries and stop the periodic sweep. */
+    clear(): void;
+    /** Stop the periodic sweep timer and clear all tracked entries. */
+    dispose(): void;
+    /**
+     * Sweep expired entries from the front of the map.
+     * Because entries are in insertion order (FIFO), we can stop as soon as
+     * we hit one that hasn't expired yet.
+     */
+    private sweep;
+}
+//# sourceMappingURL=dedup.d.ts.map

package/src/messaging/inbound/dedup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedup.d.ts","sourceRoot":"","sources":["../../../../src/messaging/inbound/dedup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAYD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,GAAE,MAA0B,GAAG,OAAO,CAKjH;AAMD,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA6B;IACnD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAiC;gBAEhD,IAAI,GAAE,gBAAqB;IASvC;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO;IA2B9C,2DAA2D;IAC3D,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,sDAAsD;IACtD,KAAK,IAAI,IAAI;IAKb,mEAAmE;IACnE,OAAO,IAAI,IAAI;IASf;;;;OAIG;IACH,OAAO,CAAC,KAAK;CAOd"}

package/src/messaging/inbound/dedup.js

@@ -0,0 +1,117 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * FIFO-based message deduplication.
+ *
+ * Feishu WebSocket connections may redeliver messages on reconnect.
+ * This module tracks recently-seen message IDs and filters duplicates.
+ *
+ * Design choices:
+ * - FIFO eviction (not LRU) — message IDs are write-once/check-once,
+ *   no hot/cold access pattern.  FIFO naturally expires the oldest entry
+ *   first, which matches the dedup semantics.
+ * - ES2015 `Map` preserves insertion order, giving us FIFO for free.
+ * - Periodic sweep leverages FIFO ordering: iterate from oldest and
+ *   `break` at the first non-expired entry → O(expired), not O(n).
+ */
+const DEFAULT_TTL_MS = 12 * 60 * 60 * 1000; // 12 hours
+const DEFAULT_MAX_ENTRIES = 5_000;
+const SWEEP_INTERVAL_MS = 5 * 60 * 1000; // 5 minutes
+// ---------------------------------------------------------------------------
+// Message expiry check
+// ---------------------------------------------------------------------------
+const DEFAULT_EXPIRY_MS = 30 * 60 * 1000; // 30 minutes
+/**
+ * Check whether a message is too old to process.
+ *
+ * Feishu message `create_time` is a millisecond Unix timestamp encoded
+ * as a string.  When a WebSocket reconnects after a long outage, stale
+ * messages may be redelivered — this function lets callers discard them
+ * before entering the full handling pipeline.
+ */
+export function isMessageExpired(createTimeStr, expiryMs = DEFAULT_EXPIRY_MS) {
+    if (!createTimeStr)
+        return false;
+    const createTime = parseInt(createTimeStr, 10);
+    if (Number.isNaN(createTime))
+        return false;
+    return Date.now() - createTime > expiryMs;
+}
+// ---------------------------------------------------------------------------
+// Message deduplication
+// ---------------------------------------------------------------------------
+export class MessageDedup {
+    store = new Map();
+    ttlMs;
+    maxEntries;
+    sweepTimer;
+    constructor(opts = {}) {
+        this.ttlMs = opts.ttlMs ?? DEFAULT_TTL_MS;
+        this.maxEntries = opts.maxEntries ?? DEFAULT_MAX_ENTRIES;
+        // Periodic sweep — relies on FIFO ordering so we can break early.
+        this.sweepTimer = setInterval(() => this.sweep(), SWEEP_INTERVAL_MS);
+        this.sweepTimer.unref();
+    }
+    /**
+     * Try to record a message ID.
+     *
+     * @param id   Unique message identifier (e.g. Feishu `message_id`).
+     * @param scope Optional scope prefix (e.g. accountId) to namespace IDs.
+     * @returns `true` if the message is **new**; `false` if it is a duplicate.
+     */
+    tryRecord(id, scope) {
+        const key = scope ? `${scope}:${id}` : id;
+        const now = Date.now();
+        const existing = this.store.get(key);
+        if (existing !== undefined) {
+            // Entry exists — check TTL.
+            if (now - existing < this.ttlMs) {
+                // Still within TTL → duplicate.
+                return false;
+            }
+            // Expired — remove so we can re-insert at the tail (refresh position).
+            this.store.delete(key);
+        }
+        // Enforce capacity via FIFO: drop the oldest entry.
+        if (this.store.size >= this.maxEntries) {
+            const oldest = this.store.keys().next().value;
+            if (oldest !== undefined) {
+                this.store.delete(oldest);
+            }
+        }
+        this.store.set(key, now);
+        return true;
+    }
+    /** Current number of tracked entries (for diagnostics). */
+    get size() {
+        return this.store.size;
+    }
+    /** Remove all entries and stop the periodic sweep. */
+    clear() {
+        clearInterval(this.sweepTimer);
+        this.store.clear();
+    }
+    /** Stop the periodic sweep timer and clear all tracked entries. */
+    dispose() {
+        clearInterval(this.sweepTimer);
+        this.store.clear();
+    }
+    // ---------------------------------------------------------------------------
+    // Internal
+    // ---------------------------------------------------------------------------
+    /**
+     * Sweep expired entries from the front of the map.
+     * Because entries are in insertion order (FIFO), we can stop as soon as
+     * we hit one that hasn't expired yet.
+     */
+    sweep() {
+        const now = Date.now();
+        for (const [key, ts] of this.store) {
+            if (now - ts < this.ttlMs)
+                break;
+            this.store.delete(key);
+        }
+    }
+}
+//# sourceMappingURL=dedup.js.map

package/src/messaging/inbound/dedup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedup.js","sourceRoot":"","sources":["../../../../src/messaging/inbound/dedup.ts"],"names":[],"mappings":"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"}