@meet-im/meet 2.0.6 → 3.0.0-beta.0

package/dist/src/reply-dispatcher.js

@@ -0,0 +1,173 @@
+import { createReplyPrefixContext } from "openclaw/plugin-sdk/channel-runtime";
+import { getMeetRuntime } from "./runtime.js";
+import { sendMessageMeet, sendMediaMeet } from "./send.js";
+/**
+ * 匹配末尾不完整的 mention 开始: <@ 或 <@xxx (没有闭合的 >)
+ */
+const INCOMPLETE_MENTION_START = /<@(-?\d*)$/;
+/**
+ * 匹配开头不完整的 mention 结束: xxx> (没有开始的 <@)
+ */
+const INCOMPLETE_MENTION_END = /^(-?\d+)>/;
+/**
+ * 保护 mention 格式在分片后不被截断
+ *
+ * 当文本被分片后，`<@userId>` 格式可能被截断成：
+ * - 第一个 chunk 末尾: `<@123`
+ * - 第二个 chunk 开头: `456>`
+ *
+ * 此函数检测并修复这种情况，确保 mention 格式完整。
+ */
+export function protectMentionsInChunks(chunks) {
+    if (chunks.length <= 1) {
+        return chunks;
+    }
+    const result = [];
+    let pendingSuffix = "";
+    for (let i = 0; i < chunks.length; i++) {
+        let chunk = pendingSuffix + chunks[i];
+        pendingSuffix = "";
+        // 检测末尾是否有不完整的 mention 开始 (<@ 或 <@xxx)
+        const startMatch = chunk.match(INCOMPLETE_MENTION_START);
+        if (startMatch) {
+            // 检查下一个 chunk 是否有对应的结束部分
+            const nextChunk = chunks[i + 1];
+            if (nextChunk !== undefined) {
+                const endMatch = nextChunk.match(INCOMPLETE_MENTION_END);
+                if (endMatch) {
+                    // 将不完整的部分移到下一个 chunk 前面
+                    const splitIndex = chunk.lastIndexOf("<@");
+                    // splitIndex >= 0 时处理（包括 chunk 只有 "<@" 的情况）
+                    if (splitIndex >= 0) {
+                        // 如果 splitIndex 之前有内容，保留到 result
+                        if (splitIndex > 0) {
+                            result.push(chunk.slice(0, splitIndex));
+                        }
+                        pendingSuffix = chunk.slice(splitIndex);
+                        continue;
+                    }
+                }
+            }
+        }
+        result.push(chunk);
+    }
+    return result;
+}
+export async function createMeetReplyDispatcher(opts) {
+    const { cfg, agentId, chatId, replyToMessageId, accountId, mediaLocalRoots } = opts;
+    const core = getMeetRuntime();
+    const textChunkLimit = core.channel.text.resolveTextChunkLimit(cfg, "meet", accountId, {
+        fallbackLimit: 4000,
+    });
+    const chunkMode = core.channel.text.resolveChunkMode(cfg, "meet", accountId);
+    const prefixContext = createReplyPrefixContext({ cfg, agentId });
+    const { dispatcher, replyOptions, markDispatchIdle, markRunComplete } = core.channel.reply.createReplyDispatcherWithTyping({
+        responsePrefix: prefixContext.responsePrefix,
+        responsePrefixContextProvider: prefixContext.responsePrefixContextProvider,
+        humanDelay: core.channel.reply.resolveHumanDelayConfig(cfg, agentId),
+        onReplyStart: async () => {
+        },
+        deliver: async (payload, _info) => {
+            opts.runtime.log?.(`[${accountId}]: reply deliver kind=${_info.kind} text_len=${payload.text?.length ?? 0} media_count=${payload.mediaUrls?.length ?? (payload.mediaUrl ? 1 : 0)} reasoning=${payload.isReasoning === true} error=${payload.isError === true}`);
+            const text = payload.text ?? "";
+            const mediaUrls = payload.mediaUrls ?? (payload.mediaUrl ? [payload.mediaUrl] : []);
+            // 如果既没有文本也没有媒体，直接返回
+            if (!text.trim() && mediaUrls.length === 0) {
+                return;
+            }
+            // 处理媒体文件：先发送媒体，再发送文本
+            // 如果有媒体，第一个媒体带上文本作为 caption，后续媒体不带文本
+            if (mediaUrls.length > 0) {
+                // 第一个媒体带上 caption
+                await sendMediaMeet({
+                    cfg,
+                    to: chatId,
+                    text: text.trim() || undefined,
+                    mediaUrl: mediaUrls[0],
+                    mediaLocalRoots,
+                    accountId,
+                });
+                // 后续媒体不带文本
+                for (let i = 1; i < mediaUrls.length; i++) {
+                    await sendMediaMeet({
+                        cfg,
+                        to: chatId,
+                        text: undefined,
+                        mediaUrl: mediaUrls[i],
+                        mediaLocalRoots,
+                        accountId,
+                    });
+                }
+                return;
+            }
+            // 只有文本，分片发送
+            const rawChunks = core.channel.text.chunkTextWithMode(text, textChunkLimit, chunkMode);
+            const protectedChunks = protectMentionsInChunks(rawChunks);
+            for (const chunk of protectedChunks) {
+                await sendMessageMeet({
+                    cfg,
+                    to: chatId,
+                    text: chunk,
+                    accountId,
+                    replyToMessageId,
+                });
+            }
+        },
+        onError: async (error, info) => {
+            const errorMessage = String(error);
+            opts.runtime.error?.(`meet[${accountId}] ${info.kind} reply failed: ${errorMessage}`);
+            // 发送错误提示给用户，让 AI 也能看到错误并修正
+            // 根据错误类型生成友好提示
+            let userMessage;
+            const lowerError = errorMessage.toLowerCase();
+            if (lowerError.includes("not found") ||
+                lowerError.includes("enoent") ||
+                lowerError.includes("does not exist") ||
+                lowerError.includes("local media file not found")) {
+                userMessage = `发送失败: 文件不存在或无法访问。请提供有效的文件路径（建议使用绝对路径）。\n错误详情: ${errorMessage}`;
+            }
+            else if (lowerError.includes("mediafetcherror") ||
+                lowerError.includes("fetch_failed") ||
+                lowerError.includes("failed to fetch")) {
+                userMessage = `发送失败: 无法获取媒体文件。请检查 URL 是否正确或网络是否可用。\n错误详情: ${errorMessage}`;
+            }
+            else if (lowerError.includes("localmediaaccesserror") ||
+                lowerError.includes("path-not-allowed") ||
+                lowerError.includes("not safe to read") ||
+                lowerError.includes("network-path-not-allowed")) {
+                userMessage = `发送失败: 文件路径不在允许访问的目录内。请使用工作区内的文件路径，或联系管理员配置 mediaLocalRoots。\n错误详情: ${errorMessage}`;
+            }
+            else if (lowerError.includes("max_bytes") ||
+                lowerError.includes("exceeds maxbytes") ||
+                lowerError.includes("exceeds") && lowerError.includes("limit")) {
+                userMessage = `发送失败: 文件大小超过限制。请使用较小的文件。\n错误详情: ${errorMessage}`;
+            }
+            else if (lowerError.includes("not a file")) {
+                userMessage = `发送失败: 路径不是文件。请提供文件路径而非目录。\n错误详情: ${errorMessage}`;
+            }
+            else {
+                userMessage = `发送失败: ${errorMessage}`;
+            }
+            // 尝试发送错误消息，忽略发送失败（避免递归）
+            try {
+                await sendMessageMeet({
+                    cfg,
+                    to: chatId,
+                    text: userMessage,
+                    accountId,
+                });
+            }
+            catch {
+                // 忽略错误消息发送失败
+            }
+        },
+        onIdle: async () => {
+        },
+    });
+    return {
+        dispatcher,
+        replyOptions,
+        markDispatchIdle,
+        markRunComplete,
+    };
+}

package/dist/src/runtime.d.ts

@@ -0,0 +1,11 @@
+import type { PluginRuntime } from "openclaw/plugin-sdk/channel-core";
+type MeetChannelRuntime = {
+    sendMessageMeet?: typeof import("./send.js").sendMessageMeet;
+};
+export type MeetRuntime = PluginRuntime & {
+    channel: PluginRuntime["channel"] & {
+        meet?: MeetChannelRuntime;
+    };
+};
+declare const setMeetRuntime: (next: MeetRuntime) => void, getOptionalMeetRuntime: () => MeetRuntime | null, getMeetRuntime: () => MeetRuntime;
+export { getMeetRuntime, getOptionalMeetRuntime, setMeetRuntime };

package/dist/src/runtime.js

@@ -0,0 +1,6 @@
+import { createPluginRuntimeStore } from "openclaw/plugin-sdk/runtime-store";
+const { setRuntime: setMeetRuntime, tryGetRuntime: getOptionalMeetRuntime, getRuntime: getMeetRuntime, } = createPluginRuntimeStore({
+    pluginId: "meet",
+    errorMessage: "Meet runtime not initialized",
+});
+export { getMeetRuntime, getOptionalMeetRuntime, setMeetRuntime };

package/dist/src/sdk-bridge.d.ts

@@ -0,0 +1,21 @@
+import type { MsgContent, SessionInfo, SessionType } from "@meet-im/meet-bot-jssdk";
+import type { MeetMessageContext, MeetReplyContext, MeetMediaAttachment } from "./types.js";
+export type QuoteMsgMap = Record<string, MsgContent>;
+export declare function mapSessionType(sessionType: SessionType): "direct" | "channel";
+/**
+ * 构建引用消息查找 Key
+ * 群聊: firstID+secondID:quoteSeqID
+ * 私聊: min(firstID,secondID):max(firstID,secondID):quoteSeqID
+ */
+export declare function buildQuoteMsgKey(sessionInfo: SessionInfo, quoteSeqID: number): string;
+/**
+ * 解析引用消息
+ */
+export declare function resolveQuoteMessage(msg: MsgContent, quoteMsgMap: QuoteMsgMap): MeetReplyContext | undefined;
+/**
+ * 从引用消息中提取媒体附件信息（用于下载）
+ */
+export declare function extractQuoteMessageMedia(msg: MsgContent, quoteMsgMap: QuoteMsgMap): MeetMediaAttachment[] | undefined;
+export declare function msgContentToContext(msg: MsgContent, botUserId: string, quoteMsgMap?: QuoteMsgMap): MeetMessageContext;
+export declare function parseTargetToSessionInfo(target: string, botUserId: number): SessionInfo;
+export declare function buildMeetTarget(sessionInfo: SessionInfo, botUserId: number): string;

package/dist/src/sdk-bridge.js

@@ -0,0 +1,214 @@
+export function mapSessionType(sessionType) {
+    return sessionType === 1 ? "direct" : "channel";
+}
+/**
+ * 生成与 Discord 一致的媒体占位符
+ * 格式：<media:image> (2 images) 或 <media:document> (3 files)
+ */
+function buildMediaPlaceholder(media) {
+    const images = media.filter((m) => m.mimeType?.startsWith("image/"));
+    const videos = media.filter((m) => m.mimeType?.startsWith("video/"));
+    const audios = media.filter((m) => m.mimeType?.startsWith("audio/"));
+    const documents = media.filter((m) => !m.mimeType?.startsWith("image/") &&
+        !m.mimeType?.startsWith("video/") &&
+        !m.mimeType?.startsWith("audio/"));
+    const parts = [];
+    if (images.length > 0) {
+        const label = images.length === 1 ? "image" : "images";
+        parts.push(`<media:image> (${images.length} ${label})`);
+    }
+    if (videos.length > 0) {
+        const label = videos.length === 1 ? "video" : "videos";
+        parts.push(`<media:video> (${videos.length} ${label})`);
+    }
+    if (audios.length > 0) {
+        const label = audios.length === 1 ? "audio" : "audios";
+        parts.push(`<media:audio> (${audios.length} ${label})`);
+    }
+    if (documents.length > 0) {
+        const label = documents.length === 1 ? "document" : "documents";
+        parts.push(`<media:document> (${documents.length} ${label})`);
+    }
+    return parts.join("\n");
+}
+/**
+ * 构建引用消息查找 Key
+ * 群聊: firstID+secondID:quoteSeqID
+ * 私聊: min(firstID,secondID):max(firstID,secondID):quoteSeqID
+ */
+export function buildQuoteMsgKey(sessionInfo, quoteSeqID) {
+    const { firstID, secondID, sessionType } = sessionInfo;
+    if (sessionType === 3) {
+        return `${firstID}+${secondID}:${quoteSeqID}`;
+    }
+    else {
+        const [minId, maxId] = firstID < secondID ? [firstID, secondID] : [secondID, firstID];
+        return `${minId}:${maxId}:${quoteSeqID}`;
+    }
+}
+/**
+ * 解析引用消息
+ */
+export function resolveQuoteMessage(msg, quoteMsgMap) {
+    // 使用 quoteSeqID 字段（SDK V2）
+    const quoteSeqID = msg.quoteSeqID;
+    if (!quoteSeqID || !msg.sessionInfo) {
+        return undefined;
+    }
+    const key = buildQuoteMsgKey(msg.sessionInfo, quoteSeqID);
+    const quoteMsg = quoteMsgMap[key];
+    if (!quoteMsg) {
+        return undefined;
+    }
+    // 对齐 Discord: 引用消息的 body 包含媒体占位符
+    const body = buildQuoteMessageBody(quoteMsg);
+    return {
+        messageId: String(quoteMsg.seqId ?? 0),
+        senderId: quoteMsg.fromUid ? String(quoteMsg.fromUid) : undefined,
+        content: body,
+        timestamp: quoteMsg.timestamp,
+    };
+}
+/**
+ * 从引用消息中提取媒体附件信息（用于下载）
+ */
+export function extractQuoteMessageMedia(msg, quoteMsgMap) {
+    const quoteSeqID = msg.quoteSeqID;
+    if (!quoteSeqID || !msg.sessionInfo) {
+        return undefined;
+    }
+    const key = buildQuoteMsgKey(msg.sessionInfo, quoteSeqID);
+    const quoteMsg = quoteMsgMap[key];
+    if (!quoteMsg) {
+        return undefined;
+    }
+    return extractMediaAttachments(quoteMsg);
+}
+/**
+ * 从消息中提取媒体附件信息
+ */
+function extractMediaAttachments(msg) {
+    const extraInfo = msg.extraInfo;
+    if (!extraInfo) {
+        return undefined;
+    }
+    const attachments = [];
+    // 单附件
+    if (extraInfo.attechmentInfo) {
+        const att = extraInfo.attechmentInfo;
+        attachments.push({
+            fileId: att.fileID,
+            fileName: att.fileName,
+            fileSize: att.fileSize,
+            mimeType: att.mimeType,
+            fileUrl: att.fileUrl,
+        });
+    }
+    // 多附件
+    if (extraInfo.attechmentInfos && Array.isArray(extraInfo.attechmentInfos)) {
+        for (const att of extraInfo.attechmentInfos) {
+            attachments.push({
+                fileId: att.fileID,
+                fileName: att.fileName,
+                fileSize: att.fileSize,
+                mimeType: att.mimeType,
+                fileUrl: att.fileUrl,
+            });
+        }
+    }
+    return attachments.length > 0 ? attachments : undefined;
+}
+/**
+ * 构建引用消息的 body（对齐 Discord）
+ * 包含文本内容 + 媒体占位符
+ */
+function buildQuoteMessageBody(quoteMsg) {
+    const parts = [];
+    // 添加文本内容
+    const text = quoteMsg.content?.trim();
+    if (text) {
+        parts.push(text);
+    }
+    // 添加媒体占位符
+    const media = extractMediaAttachments(quoteMsg);
+    if (media && media.length > 0) {
+        const placeholder = buildMediaPlaceholder(media);
+        if (placeholder) {
+            parts.push(placeholder);
+        }
+    }
+    return parts.join("\n");
+}
+export function msgContentToContext(msg, botUserId, quoteMsgMap = {}) {
+    if (!msg) {
+        throw new Error("MsgContent is undefined or null");
+    }
+    if (!msg.sessionInfo) {
+        throw new Error("MsgContent missing sessionInfo");
+    }
+    const chatType = mapSessionType(msg.sessionInfo.sessionType);
+    const chatId = chatType === "direct"
+        ? `user:${msg.fromUid}`
+        : `channel:${msg.sessionInfo.secondID}`;
+    const mentionedBot = msg.atIds?.includes(Number(botUserId)) ?? false;
+    const replyContext = resolveQuoteMessage(msg, quoteMsgMap);
+    const media = extractMediaAttachments(msg);
+    // 检测消息类型，生成与 Discord 一致的占位符
+    let contentType = "text";
+    let placeholder;
+    if (media && media.length > 0) {
+        contentType = "media";
+        placeholder = buildMediaPlaceholder(media);
+    }
+    return {
+        chatId,
+        messageId: String(msg.seqId ?? 0),
+        senderId: String(msg.fromUid ?? 0),
+        senderOpenId: String(msg.fromUid ?? 0),
+        chatType,
+        mentionedBot,
+        content: msg.content ?? "",
+        contentType,
+        placeholder,
+        sessionInfo: msg.sessionInfo,
+        timestamp: msg.timestamp,
+        atIds: msg.atIds,
+        replyContext,
+        media,
+    };
+}
+export function parseTargetToSessionInfo(target, botUserId) {
+    const userMatch = target.match(/^user:(\d+)$/);
+    if (userMatch) {
+        return {
+            firstID: botUserId,
+            secondID: Number(userMatch[1]),
+            sessionType: 1,
+        };
+    }
+    const channelMatch = target.match(/^channel:(\d+)$/);
+    if (channelMatch) {
+        return {
+            firstID: 1,
+            secondID: Number(channelMatch[1]),
+            sessionType: 3,
+        };
+    }
+    const numericMatch = target.match(/^(\d+)$/);
+    if (numericMatch) {
+        return {
+            firstID: botUserId,
+            secondID: Number(numericMatch[1]),
+            sessionType: 1,
+        };
+    }
+    throw new Error(`Invalid Meet target: ${target}`);
+}
+export function buildMeetTarget(sessionInfo, botUserId) {
+    if (sessionInfo.sessionType === 1) {
+        return sessionInfo.secondID === botUserId
+            ? `user:${sessionInfo.firstID}`
+            : `user:${sessionInfo.secondID}`;
+    }
+    return `channel:${sessionInfo.secondID}`;
+}

package/dist/src/send.d.ts

@@ -0,0 +1,60 @@
+import type { ClawdbotConfig, RuntimeEnv } from "openclaw/plugin-sdk";
+import type { MeetMediaInfo } from "./types.js";
+/**
+ * 根据文件扩展名推断 MIME 类型
+ * 支持常见图片格式，包括现代格式如 avif, webp, heic
+ */
+export declare function inferContentTypeFromFileName(fileName: string): string | undefined;
+/**
+ * 获取最终的 contentType
+ * 如果原始 contentType 缺失或为通用二进制流，则根据文件名推断
+ */
+export declare function resolveContentType(fileName: string, originalContentType?: string): string;
+export declare function setSendMessageLogger(logger: RuntimeEnv): void;
+export declare function extractAtIds(text: string): {
+    text: string;
+    atIds: number[];
+};
+export type SendMessageMeetOpts = {
+    cfg: ClawdbotConfig;
+    to: string;
+    text: string;
+    accountId?: string;
+    replyToMessageId?: string;
+    atIds?: number[];
+};
+export declare function sendMessageMeet(opts: SendMessageMeetOpts): Promise<{
+    messageId: string;
+    chatId: string;
+}>;
+export type SendMediaMeetOpts = {
+    cfg: ClawdbotConfig;
+    to: string;
+    text?: string;
+    mediaUrl: string;
+    mediaLocalRoots?: readonly string[];
+    accountId?: string;
+    /** 上传进度回调 */
+    onProgress?: (progress: {
+        percent: string;
+        loaded: number;
+        total: number;
+        speedPerSecond: string;
+    }) => void;
+};
+export declare function sendMediaMeet(opts: SendMediaMeetOpts): Promise<{
+    messageId: string;
+    chatId: string;
+}>;
+export declare function resolveMeetMedia(mediaUrl: string, opts?: {
+    cfg?: ClawdbotConfig;
+    accountId?: string;
+    mediaLocalRoots?: readonly string[];
+}): Promise<MeetMediaInfo>;
+export declare function getMessageMeet(opts: {
+    cfg: ClawdbotConfig;
+    messageId: string;
+    accountId?: string;
+}): Promise<{
+    content: string;
+} | null>;