@meet-im/meet 1.0.3

package/src/sdk-bridge.ts

@@ -0,0 +1,268 @@
+import type { MsgContent, SessionInfo, SessionType, AttachmentInfo } from "@meet-im/meet-bot-jssdk"
+import type { MeetMessageContext, MeetReplyContext, MeetMediaAttachment } from "./types.js"
+
+// TODO: 从 SDK 导入，等待 SDK 发布
+export type QuoteMsgMap = Record<string, MsgContent>
+
+export function mapSessionType(sessionType: SessionType): "direct" | "channel" {
+  return sessionType === 1 ? "direct" : "channel"
+}
+
+/**
+ * 生成与 Discord 一致的媒体占位符
+ * 格式：<media:image> (2 images) 或 <media:document> (3 files)
+ */
+function buildMediaPlaceholder(media: MeetMediaAttachment[]): string {
+  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: string[] = []
+
+  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: SessionInfo, quoteSeqID: number): string {
+  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: MsgContent,
+  quoteMsgMap: QuoteMsgMap
+): MeetReplyContext | undefined {
+  // 使用 quoteSeqID 字段（SDK V2）
+  const quoteSeqID = (msg as { quoteSeqID?: number }).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: MsgContent,
+  quoteMsgMap: QuoteMsgMap
+): MeetMediaAttachment[] | undefined {
+  const quoteSeqID = (msg as { quoteSeqID?: number }).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: MsgContent): MeetMediaAttachment[] | undefined {
+  const extraInfo = msg.extraInfo
+  if (!extraInfo) {
+    return undefined
+  }
+
+  const attachments: MeetMediaAttachment[] = []
+
+  // 单附件
+  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: MsgContent): string {
+  const parts: string[] = []
+
+  // 添加文本内容
+  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: MsgContent,
+  botUserId: string,
+  quoteMsgMap: QuoteMsgMap = {},
+): MeetMessageContext {
+  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: string | undefined
+  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: string,
+  botUserId: number,
+): SessionInfo {
+  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: SessionInfo,
+  botUserId: number,
+): string {
+  if (sessionInfo.sessionType === 1) {
+    return sessionInfo.secondID === botUserId
+      ? `user:${sessionInfo.firstID}`
+      : `user:${sessionInfo.secondID}`
+  }
+  return `channel:${sessionInfo.secondID}`
+}

package/src/send.ts

@@ -0,0 +1,223 @@
+import type { ClawdbotConfig, RuntimeEnv } from "openclaw/plugin-sdk";
+import type { ResolvedMeetAccount, MeetMediaInfo } from "./types.js";
+import type { UploadProgress as SdkUploadProgress } from "@meet-im/meet-bot-jssdk";
+import { resolveMeetAccount } from "./accounts.js";
+import { getMeetClient } from "./client.js";
+import { parseTargetToSessionInfo } from "./sdk-bridge.js";
+import { getMeetRuntime } from "./runtime.js";
+
+const MENTION_PATTERN = /<@(-?\d+)>|@(-?\d+)(?![\d])/g;
+
+let _logger: RuntimeEnv | null = null;
+
+export function setSendMessageLogger(logger: RuntimeEnv): void {
+  _logger = logger;
+}
+
+function log(message: string): void {
+  if (_logger) {
+    _logger.log(message);
+  }
+}
+
+function logError(message: string): void {
+  if (_logger) {
+    _logger.error(message);
+  } else {
+    console.error(message);
+  }
+}
+
+export function extractAtIds(text: string): { text: string; atIds: number[] } {
+  const atIds: number[] = [];
+  text.replace(MENTION_PATTERN, (_, id1, id2) => {
+    const id = id1 ?? id2;
+    if (id) {
+      atIds.push(Number(id));
+    }
+    return _;
+  });
+  return { text: text.trim(), atIds };
+}
+
+export type SendMessageMeetOpts = {
+  cfg: ClawdbotConfig;
+  to: string;
+  text: string;
+  accountId?: string;
+  replyToMessageId?: string;
+  atIds?: number[];
+};
+
+export async function sendMessageMeet(
+  opts: SendMessageMeetOpts,
+): Promise<{ messageId: string; chatId: string }> {
+  const { cfg, to, text, accountId, atIds: explicitAtIds } = opts;
+  const account = resolveMeetAccount({ cfg, accountId });
+  if (!account.configured) {
+    throw new Error(`Meet account not configured: ${accountId ?? "default"}`);
+  }
+  const token = account.apiToken;
+  if (!token) {
+    throw new Error("Meet API token not configured");
+  }
+  const botUserId = token.split(":")[0];
+  if (!botUserId) {
+    throw new Error("Invalid Meet API token format");
+  }
+  const bot = getMeetClient(account.accountId);
+  if (!bot) {
+    throw new Error(`Meet client not found for account: ${account.accountId}`);
+  }
+  const { text: cleanText, atIds: extractedAtIds } = extractAtIds(text);
+  const finalAtIds = explicitAtIds
+    ? [...explicitAtIds, ...extractedAtIds]
+    : extractedAtIds;
+  log(`send message to=${to} atIds=${finalAtIds.join(",") || "none"}`);
+  const sessionInfo = parseTargetToSessionInfo(to, Number(botUserId));
+  try {
+    const result = await bot.sendMessage(sessionInfo, {
+      content: cleanText,
+      atIds: finalAtIds,
+    });
+    return {
+      messageId: String(result.msgContent?.seqId ?? 0),
+      chatId: to,
+    };
+  } catch (error) {
+    logError(`send message error: ${String(error)}`);
+    throw error;
+  }
+}
+
+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 async function sendMediaMeet(
+  opts: SendMediaMeetOpts,
+): Promise<{ messageId: string; chatId: string }> {
+  const { cfg, to, text, mediaUrl, mediaLocalRoots, accountId, onProgress } = opts;
+  const account = resolveMeetAccount({ cfg, accountId });
+  if (!account.configured) {
+    throw new Error(`Meet account not configured: ${accountId ?? "default"}`);
+  }
+  const token = account.apiToken;
+  if (!token) {
+    throw new Error("Meet API token not configured");
+  }
+  const botUserId = token.split(":")[0];
+  if (!botUserId) {
+    throw new Error("Invalid Meet API token format");
+  }
+  const bot = getMeetClient(account.accountId);
+  if (!bot) {
+    throw new Error(`Meet client not found for account: ${account.accountId}`);
+  }
+
+  const runtime = getMeetRuntime();
+  const maxBytes = account.config.mediaMaxMb
+    ? account.config.mediaMaxMb * 1024 * 1024
+    : undefined;
+
+  log(`loading media: ${mediaUrl}`);
+  const media = await runtime.media.loadWebMedia(mediaUrl, {
+    maxBytes,
+    localRoots: mediaLocalRoots,
+  });
+
+  // 检查媒体大小限制
+  if (maxBytes && media.buffer.length > maxBytes) {
+    throw new Error(`Media file too large: ${media.buffer.length} bytes (max: ${maxBytes})`);
+  }
+
+  const sessionInfo = parseTargetToSessionInfo(to, Number(botUserId));
+  const fileName = media.fileName || "file";
+
+  log(
+    `sending media to=${to} fileName=${fileName} size=${media.buffer.length}`,
+  );
+
+  // 包装进度回调
+  const progressCallback = onProgress
+    ? (progress: SdkUploadProgress) => {
+        onProgress({
+          percent: progress.percent,
+          loaded: progress.loaded,
+          total: progress.total,
+          speedPerSecond: progress.speedPerSecond,
+        });
+      }
+    : undefined;
+
+  try {
+    const result = await bot.sendMedia(sessionInfo, {
+      buffer: media.buffer,
+      fileName,
+      contentType: media.contentType || "application/octet-stream",
+      content: text || "",
+      onProgress: progressCallback,
+    });
+    return {
+      messageId: String(result.msgContent?.seqId ?? 0),
+      chatId: to,
+    };
+  } catch (error) {
+    logError(`send media error: ${String(error)}`);
+    throw error;
+  }
+}
+
+export async function resolveMeetMedia(
+  mediaUrl: string,
+  opts?: {
+    cfg?: ClawdbotConfig;
+    accountId?: string;
+    mediaLocalRoots?: readonly string[];
+  },
+): Promise<MeetMediaInfo> {
+  const runtime = getMeetRuntime();
+  let maxBytes: number | undefined;
+  if (opts?.cfg) {
+    const account = resolveMeetAccount({
+      cfg: opts.cfg,
+      accountId: opts.accountId,
+    });
+    if (account.config.mediaMaxMb) {
+      maxBytes = account.config.mediaMaxMb * 1024 * 1024;
+    }
+  }
+  const media = await runtime.media.loadWebMedia(mediaUrl, {
+    maxBytes,
+    localRoots: opts?.mediaLocalRoots,
+  });
+  return {
+    path: media.fileName || "file",
+    contentType: media.contentType,
+    placeholder: `[Meet file: ${media.fileName || "file"}]`,
+  };
+}
+
+export async function getMessageMeet(opts: {
+  cfg: ClawdbotConfig;
+  messageId: string;
+  accountId?: string;
+}): Promise<{ content: string } | null> {
+  const { cfg, messageId, accountId } = opts;
+  const account = resolveMeetAccount({ cfg, accountId });
+  if (!account.configured) {
+    return null;
+  }
+  const bot = getMeetClient(account.accountId);
+  if (!bot) {
+    return null;
+  }
+  return null;
+}

package/src/targets.ts

@@ -0,0 +1,101 @@
+export type MeetTargetKind = "user" | "channel"
+
+export type MeetTarget = {
+  kind: MeetTargetKind
+  id: string
+  raw: string
+  normalized: string
+}
+
+export type MeetTargetParseOptions = {
+  defaultKind?: MeetTargetKind
+  ambiguousMessage?: string
+}
+
+function buildMessagingTarget(kind: MeetTargetKind, id: string, raw: string): MeetTarget {
+  return { kind, id, raw, normalized: `${kind}:${id}` }
+}
+
+function parseMentionPrefixOrAtUserTarget(params: {
+  raw: string
+  mentionPattern: RegExp
+  prefixes: Array<{ prefix: string; kind: MeetTargetKind }>
+  atUserPattern: RegExp
+  atUserErrorMessage: string
+}): MeetTarget | undefined {
+  const { raw, mentionPattern, prefixes, atUserPattern } = params
+
+  const mentionMatch = raw.match(mentionPattern)
+  if (mentionMatch) {
+    return buildMessagingTarget("user", mentionMatch[2], raw)
+  }
+
+  for (const { prefix, kind } of prefixes) {
+    if (raw.startsWith(prefix)) {
+      const id = raw.slice(prefix.length)
+      if (id) {
+        return buildMessagingTarget(kind, id, raw)
+      }
+    }
+  }
+
+  if (atUserPattern.test(raw)) {
+    return buildMessagingTarget("user", raw, raw)
+  }
+
+  return undefined
+}
+
+export function parseMeetTarget(
+  raw: string,
+  options: MeetTargetParseOptions = {},
+): MeetTarget | undefined {
+  const trimmed = raw.trim()
+  if (!trimmed) {
+    return undefined
+  }
+
+  const userTarget = parseMentionPrefixOrAtUserTarget({
+    raw: trimmed,
+    mentionPattern: /^@\[([^\]]+)\]\((\d+)\)$/,
+    prefixes: [
+      { prefix: "user:", kind: "user" },
+      { prefix: "channel:", kind: "channel" },
+      { prefix: "meet:", kind: "user" },
+    ],
+    atUserPattern: /^\d+$/,
+    atUserErrorMessage: "Meet DMs require a user id (use user:<id>)",
+  })
+
+  if (userTarget) {
+    return userTarget
+  }
+
+  if (/^\d+$/.test(trimmed)) {
+    if (options.defaultKind) {
+      return buildMessagingTarget(options.defaultKind, trimmed, trimmed)
+    }
+    throw new Error(
+      options.ambiguousMessage ??
+        `Ambiguous Meet recipient "${trimmed}". Use "user:${trimmed}" for DMs or "channel:${trimmed}" for channel messages.`,
+    )
+  }
+
+  return buildMessagingTarget("channel", trimmed, trimmed)
+}
+
+export function resolveMeetChannelId(raw: string): string {
+  const target = parseMeetTarget(raw, { defaultKind: "channel" })
+  if (!target) {
+    throw new Error(`Invalid Meet channel: ${raw}`)
+  }
+  return target.id
+}
+
+export function formatMeetTarget(target: MeetTarget): string {
+  return `${target.kind}:${target.id}`
+}
+
+export function looksLikeMeetId(input: string): boolean {
+  return /^\d+$/.test(input) || /^(user:|channel:|meet:)/.test(input)
+}

package/src/types.ts

@@ -0,0 +1,96 @@
+import type {
+  SessionInfo,
+  AttachmentInfo,
+  UploadProgress,
+} from "@meet-im/meet-bot-jssdk"
+import type { z } from "zod"
+import {
+  MeetConfigSchema,
+  MeetAccountConfigSchema,
+  MeetChannelConfigSchema,
+  MeetGroupConfigSchema,
+} from "./config-schema.js"
+
+export type MeetConfig = z.infer<typeof MeetConfigSchema>
+export type MeetAccountConfig = z.infer<typeof MeetAccountConfigSchema>
+export type MeetChannelConfig = z.infer<typeof MeetChannelConfigSchema>
+export type MeetGroupConfig = z.infer<typeof MeetGroupConfigSchema>
+
+// 重新导出 SDK 类型
+export type { AttachmentInfo, UploadProgress }
+
+export type ResolvedMeetAccount = {
+  accountId: string
+  enabled: boolean
+  configured: boolean
+  name?: string
+  apiEndpoint?: string
+  apiToken?: string
+  config: MeetConfig
+}
+
+export type MeetReplyContext = {
+  messageId: string
+  senderId?: string
+  senderName?: string
+  content?: string
+  timestamp?: number
+  mediaPaths?: string[]
+}
+
+export type MeetMessageContext = {
+  chatId: string
+  messageId: string
+  senderId: string
+  senderOpenId: string
+  senderName?: string
+  chatType: "direct" | "channel"
+  mentionedBot: boolean
+  hasAnyMention?: boolean
+  content: string
+  contentType: string
+  placeholder?: string
+  rawPayload?: string
+  sessionInfo: SessionInfo
+  timestamp?: number
+  atIds?: number[]
+  replyContext?: MeetReplyContext
+  media?: MeetMediaAttachment[]
+}
+
+export type MeetSendResult = {
+  messageId: string
+  chatId: string
+}
+
+export type MeetProbeResult = {
+  ok: boolean
+  error?: string
+  botId?: string
+}
+
+export type MeetMediaInfo = {
+  path: string
+  contentType?: string
+  placeholder: string
+}
+
+/**
+ * 入站消息中的媒体附件信息
+ */
+export type MeetMediaAttachment = {
+  fileId: string | number
+  fileName?: string
+  fileSize?: number
+  mimeType?: string
+  fileUrl?: string
+}
+
+/**
+ * 文件上传结果
+ */
+export type MeetUploadResult = {
+  fileID: number
+  path: string
+  size: number
+}