@ai-setting/roy-agent-core 1.7.85 → 1.7.88

package/dist/shared/@ai-setting/{roy-agent-core-fghc2m8z.js → roy-agent-core-aa8kv18f.js}

@@ -1,3 +1,6 @@
+import {
+  isToolReasonRequired
+} from "./roy-agent-core-wxrkcb17.js";
 import {
   sniffImageMime
 } from "./roy-agent-core-zjdzk1gg.js";
@@ -11,7 +14,7 @@ import {
   embedResultFilter,
   init_decorator,
   init_trace_filters
-} from "./roy-agent-core-qq96p0tj.js";
+} from "./roy-agent-core-5s2t8z00.js";
 import {
   createLogger,
   init_logger
@@ -309,7 +312,20 @@ function toolParametersToJsonSchema(parameters) {
     if (deref["properties"] && typeof deref["properties"] === "object") {
       deref["type"] = "object";
     } else {
-      return EMPTY;
+      const emptyWithReason = {
+        type: "object",
+        properties: {}
+      };
+      if (isToolReasonRequired()) {
+        emptyWithReason["properties"] = {
+          reason: {
+            type: "string",
+            description: "一句话说明为什么调用此工具（将随调用记录存入会话，便于事后追溯）"
+          }
+        };
+        emptyWithReason["required"] = ["reason"];
+      }
+      return emptyWithReason;
     }
   }
   if (!deref["properties"] || typeof deref["properties"] !== "object") {
@@ -318,6 +334,22 @@ function toolParametersToJsonSchema(parameters) {
   delete deref["definitions"];
   delete deref["$defs"];
   delete deref["$schema"];
+  if (isToolReasonRequired()) {
+    const props = deref["properties"];
+    if (!props["reason"]) {
+      props["reason"] = {
+        type: "string",
+        description: "一句话说明为什么调用此工具（将随调用记录存入会话，便于事后追溯）"
+      };
+    }
+    const required = deref["required"];
+    if (Array.isArray(required)) {
+      if (!required.includes("reason"))
+        required.push("reason");
+    } else {
+      deref["required"] = ["reason"];
+    }
+  }
   return deref;
 }
 

package/dist/shared/@ai-setting/{roy-agent-core-p6ks90tb.js → roy-agent-core-an35dzbf.js}

@@ -2,7 +2,7 @@ import {
   createAutoTaskPlugin,
   createLayaDecisionPlugin,
   registerLayaCompletionTaskHook
-} from "./roy-agent-core-b31v3qpv.js";
+} from "./roy-agent-core-ra66sf50.js";
 import {
   TaskHookPoints
 } from "./roy-agent-core-1pg0fepg.js";
@@ -12,24 +12,24 @@ import {
 } from "./roy-agent-core-ctdhjv68.js";
 import {
   BaseComponent
-} from "./roy-agent-core-pgvcf91v.js";
+} from "./roy-agent-core-m39v7qpx.js";
 import {
   init_hook
-} from "./roy-agent-core-ax9e9szb.js";
+} from "./roy-agent-core-smf94h73.js";
 import {
   init_context
-} from "./roy-agent-core-qqaak24r.js";
+} from "./roy-agent-core-tkpp1ba0.js";
 import {
   getEnvContext,
   init_env_context,
   runWithEnvContextAsync
-} from "./roy-agent-core-7cbpmk4q.js";
+} from "./roy-agent-core-p31ftgq9.js";
 import {
   TracedAs,
   envQueryParamFilter,
   init_decorator,
   init_trace_filters
-} from "./roy-agent-core-qq96p0tj.js";
+} from "./roy-agent-core-5s2t8z00.js";
 import {
   createLogger,
   init_logger

package/dist/shared/@ai-setting/{roy-agent-core-7bpj859q.js → roy-agent-core-azyz78ky.js}

@@ -1,16 +1,16 @@
 import {
   isValidSessionId
-} from "./roy-agent-core-ddyk1rc0.js";
+} from "./roy-agent-core-cre2y2ct.js";
 import {
   TAG_MAX_COUNT,
   TAG_MIN_COUNT
-} from "./roy-agent-core-12n08pg5.js";
+} from "./roy-agent-core-e69qxdyy.js";
 import {
   deliverAskUserMessage
-} from "./roy-agent-core-rykf7c04.js";
+} from "./roy-agent-core-9c565frx.js";
 import {
   validateWorkflowDefinition
-} from "./roy-agent-core-1v4g0d4x.js";
+} from "./roy-agent-core-rm7seqwb.js";
 import {
   getCurrentBgTaskId
 } from "./roy-agent-core-c1v263jn.js";
@@ -20,14 +20,14 @@ import {
 } from "./roy-agent-core-mkc3zshb.js";
 import {
   init_context
-} from "./roy-agent-core-qqaak24r.js";
+} from "./roy-agent-core-tkpp1ba0.js";
 import {
   getEnvContext
-} from "./roy-agent-core-7cbpmk4q.js";
+} from "./roy-agent-core-p31ftgq9.js";
 import {
   TracedAs,
   init_decorator
-} from "./roy-agent-core-qq96p0tj.js";
+} from "./roy-agent-core-5s2t8z00.js";
 import {
   createLogger,
   init_logger

package/dist/shared/@ai-setting/{roy-agent-core-264qexac.js → roy-agent-core-b7h39vrc.js}

@@ -6,7 +6,7 @@ import {
   PiAiAdapter,
   invoke,
   invokeNonStream
-} from "./roy-agent-core-fghc2m8z.js";
+} from "./roy-agent-core-aa8kv18f.js";
 import {
   ContextError,
   ErrorCodes
@@ -17,12 +17,12 @@ import {
 } from "./roy-agent-core-7hh0brvs.js";
 import {
   BaseComponent
-} from "./roy-agent-core-pgvcf91v.js";
+} from "./roy-agent-core-m39v7qpx.js";
 import {
   LLMHookPoints,
   globalHookManager,
   init_global_hook_manager
-} from "./roy-agent-core-cpcd24n2.js";
+} from "./roy-agent-core-yet36q5k.js";
 import {
   TracedAs,
   embedParamFilter,
@@ -32,7 +32,7 @@ import {
   llmInvokeParamFilter,
   llmInvokeResultFilter,
   wrapFunction
-} from "./roy-agent-core-qq96p0tj.js";
+} from "./roy-agent-core-5s2t8z00.js";
 import {
   createLogger,
   init_logger

package/dist/shared/@ai-setting/{roy-agent-core-dqxec05w.js → roy-agent-core-bjtc9d35.js}

@@ -9,12 +9,12 @@ import {
 import {
   globalHookManager,
   init_global_hook_manager
-} from "./roy-agent-core-cpcd24n2.js";
+} from "./roy-agent-core-yet36q5k.js";
 import {
   TracedAs,
   init_decorator,
   wrapFunction
-} from "./roy-agent-core-qq96p0tj.js";
+} from "./roy-agent-core-5s2t8z00.js";
 import {
   createLogger,
   init_logger

package/dist/shared/@ai-setting/roy-agent-core-c4ec7k0p.js

@@ -0,0 +1,426 @@
+import {
+  formatActivityQuote
+} from "./roy-agent-core-418zc9ha.js";
+
+// src/env/event-source/wecom-card-builder.ts
+var WecomCardActionKey = {
+  VIEW: "task_view",
+  MARK_DONE: "task_mark_done",
+  REOPEN: "task_reopen",
+  REFRESH_ACTIVITY: "task_refresh_activity",
+  CREATE_LARK_GROUP: "task_create_lark_group"
+};
+function wecomCardTaskIdForTask(taskId) {
+  return `roy-task-${taskId}`;
+}
+var ROY_SESSION_PREFIX = "roy-session-";
+function wecomCardTaskIdForSession(sessionId, taskId) {
+  const id = typeof sessionId === "string" ? sessionId.trim() : "";
+  if (!id)
+    throw new Error("wecomCardTaskIdForSession: sessionId is required");
+  const base = `${ROY_SESSION_PREFIX}${id}`;
+  if (typeof taskId === "number" && Number.isSafeInteger(taskId) && taskId > 0) {
+    return `${base}${WECOM_SESSION_TASK_SEP}${taskId}`;
+  }
+  return base;
+}
+var WECOM_SESSION_TASK_SEP = "@task-";
+var cardSeq = 0;
+function newWecomCardTaskId(taskId) {
+  cardSeq = (cardSeq + 1) % 1e6;
+  const rand = Math.random().toString(36).slice(2, 8);
+  return `${wecomCardTaskIdForTask(taskId)}-${cardSeq}-${rand}`;
+}
+function formatTs(iso) {
+  try {
+    const d = new Date(iso);
+    if (isNaN(d.getTime()))
+      return iso;
+    const pad = (n) => String(n).padStart(2, "0");
+    return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())} ` + `${pad(d.getHours())}:${pad(d.getMinutes())}`;
+  } catch {
+    return iso;
+  }
+}
+function clip(text, max) {
+  if (!text)
+    return "";
+  const t = text.trim();
+  return t.length > max ? `${t.slice(0, max)}…` : t;
+}
+function shortMilestoneValue(text) {
+  if (!text)
+    return "";
+  const t = text.trim();
+  const colonIdx = t.indexOf("：");
+  const head = colonIdx > 0 && colonIdx <= 20 ? t.slice(0, colonIdx).trim() : t;
+  if (head.length <= MAX_HORIZONTAL_VALUE)
+    return head;
+  return clipWord(head, MAX_HORIZONTAL_VALUE);
+}
+function clipWord(text, max) {
+  if (!text)
+    return "";
+  const t = text.trim();
+  if (t.length <= max)
+    return t;
+  let cut = t.slice(0, max - 1);
+  const lastSpace = cut.lastIndexOf(" ");
+  if (lastSpace > max * 0.4)
+    return `${cut.slice(0, lastSpace).trimEnd()}…`;
+  const cjkBoundary = findCjkAsciiBoundary(cut);
+  if (cjkBoundary > max * 0.4)
+    return `${cut.slice(0, cjkBoundary).trimEnd()}…`;
+  return cut.slice(0, max - 1);
+}
+function findCjkAsciiBoundary(text) {
+  const isCjk = (ch) => /[一-鿿぀-ヿ가-힯]/.test(ch);
+  const isAsciiAlnum = (ch) => /[A-Za-z0-9]/.test(ch);
+  for (let i = text.length - 1;i > 0; i--) {
+    const prev = text[i - 1];
+    const cur = text[i];
+    if (isCjk(prev) !== isAsciiAlnum(cur) && isCjk(cur) !== isAsciiAlnum(prev)) {
+      if (isCjk(prev) && isAsciiAlnum(cur) || isAsciiAlnum(prev) && isCjk(cur)) {
+        return i;
+      }
+    }
+  }
+  return -1;
+}
+var MAX_TIMELINE_LINES = 8;
+var MAX_HORIZONTAL_ROWS = 6;
+var MAX_HORIZONTAL_VALUE = 26;
+var MAX_HORIZONTAL_KEYNAME = 5;
+function buildWecomTextNoticeCard(input) {
+  const progressPct = `${Math.max(0, Math.min(100, Math.round(input.progress ?? 0)))}%`;
+  const sorted = [...input.milestones].slice(-MAX_TIMELINE_LINES).reverse();
+  const timelineRows = sorted.slice(0, MAX_HORIZONTAL_ROWS - 1).map((m) => ({
+    keyname: formatTs(m.timestamp).slice(11),
+    value: shortMilestoneValue(m.title)
+  }));
+  const horizontal = [
+    { keyname: "状态", value: clip(input.statusLabel, MAX_HORIZONTAL_VALUE) },
+    ...timelineRows
+  ];
+  const latest = sorted[0];
+  const quoteLine = latest ? `${formatTs(latest.timestamp)} — ${clipWord(latest.title, 80)}${latest.description ? `：${clipWord(latest.description, 80)}` : ""}` : "";
+  const latestSummary = latest && latest.title ? `${formatTs(latest.timestamp)} ${clip(latest.title, 140)}` : undefined;
+  const subTitle = input.terminal ? `任务${input.statusLabel.replace(/^[^\u4e00-\u9fa5A-Za-z]*/, "")} · 详见会话` : latestSummary;
+  return {
+    card_type: "text_notice",
+    main_title: {
+      title: `\uD83D\uDCCB Task #${input.taskId} · ${clip(input.title, 60)}`,
+      desc: clip(input.description, 80) || undefined
+    },
+    emphasis_content: {
+      title: progressPct,
+      desc: "进度"
+    },
+    sub_title_text: subTitle,
+    horizontal_content_list: horizontal,
+    quote_area: {
+      type: 0,
+      title: "最新进展",
+      quote_text: quoteLine || "（暂无操作记录）"
+    },
+    card_action: { type: 0 }
+  };
+}
+var MAX_BUTTONS = 6;
+var MAX_BUTTON_TEXT = 10;
+function buildWecomButtonInteractionCard(input) {
+  const notice = buildWecomTextNoticeCard({
+    taskId: input.taskId,
+    title: input.title,
+    statusLabel: input.statusLabel,
+    progress: input.progress,
+    description: input.description,
+    changeSummary: input.changeSummary,
+    milestones: input.milestones ?? []
+  });
+  const buttons = (input.buttons ?? []).slice(0, MAX_BUTTONS).map((b) => ({
+    text: clip(b.text, MAX_BUTTON_TEXT),
+    style: b.style ?? 1,
+    key: b.key
+  }));
+  return {
+    card_type: "button_interaction",
+    main_title: notice.main_title,
+    sub_title_text: notice.sub_title_text,
+    horizontal_content_list: notice.horizontal_content_list,
+    quote_area: notice.quote_area,
+    button_list: buttons,
+    card_action: { type: 0 },
+    task_id: input.cardTaskId ?? newWecomCardTaskId(input.taskId)
+  };
+}
+var WECOM_SESSION_LIFECYCLE_PHRASE = {
+  running: "运行中",
+  completed: "已完成",
+  timeout: "已超时",
+  failed: "已失败",
+  stopped: "已停止",
+  unknown: "状态未知"
+};
+var MAX_SESSION_TITLE = 100;
+function buildWecomSessionCard(input) {
+  const lifecycle = input.lifecycle ?? "running";
+  const statusLabel = WECOM_SESSION_LIFECYCLE_PHRASE[lifecycle];
+  const terminal = lifecycle !== "running";
+  const headRaw = input.title?.trim() || input.sessionId;
+  const head = clip(headRaw, MAX_SESSION_TITLE);
+  const titleParts = [`\uD83D\uDCCA 子会话`, head, statusLabel];
+  const rows = [];
+  rows.push({ keyname: "会话", value: clip(input.sessionId, MAX_HORIZONTAL_VALUE) });
+  if (input.agentType) {
+    rows.push({ keyname: "Agent", value: clip(input.agentType, MAX_HORIZONTAL_VALUE) });
+  }
+  if (input.elapsedText) {
+    rows.push({ keyname: "已运行", value: clip(input.elapsedText, MAX_HORIZONTAL_VALUE) });
+  }
+  if (input.task) {
+    rows.push({
+      keyname: "任务",
+      value: clip(`#${input.task.id}${input.task.title ? ` ${input.task.title}` : ""}`, MAX_HORIZONTAL_VALUE)
+    });
+    if (input.task.status) {
+      rows.push({
+        keyname: "任务状态",
+        value: clip(input.task.status, MAX_HORIZONTAL_VALUE)
+      });
+    }
+  }
+  let quoteArea;
+  let subTitle;
+  if (input.activity !== undefined) {
+    const q = formatActivityQuote(input.activity ?? undefined, input.activityNow ?? Date.now(), terminal);
+    if (q.overflow) {
+      subTitle = q.text.replace(/\n/g, " · ");
+    } else {
+      quoteArea = { type: 0, title: q.title, quote_text: q.text };
+    }
+  } else if (input.milestones && input.milestones.length > 0) {
+    const latest = input.milestones[input.milestones.length - 1];
+    subTitle = clipWord(latest.title, 60);
+  }
+  return {
+    card_type: "button_interaction",
+    main_title: {
+      title: titleParts.join(" · ")
+    },
+    sub_title_text: subTitle,
+    horizontal_content_list: rows,
+    ...quoteArea ? { quote_area: quoteArea } : {},
+    button_list: [
+      {
+        text: "刷新活性",
+        style: 1,
+        key: WecomCardActionKey.REFRESH_ACTIVITY
+      },
+      {
+        text: "建飞书群",
+        style: 1,
+        key: WecomCardActionKey.CREATE_LARK_GROUP
+      }
+    ],
+    card_action: { type: 0 },
+    task_id: wecomCardTaskIdForSession(input.sessionId, input.task?.id)
+  };
+}
+function buildWecomSendCardFrame(input) {
+  const reqId = input.reqId && input.reqId.trim() ? input.reqId.trim() : `aibot_send_msg_${Date.now()}_${Math.random().toString(36).slice(2, 10)}`;
+  return {
+    cmd: "aibot_send_msg",
+    headers: { req_id: reqId },
+    body: {
+      chatid: input.chatId,
+      chat_type: input.chatType === "group" ? 2 : 1,
+      msgtype: "template_card",
+      template_card: input.card
+    }
+  };
+}
+var MAX_UPDATE_TITLE = 60;
+function buildUpdateMainTitle(statusLabel, taskNumber, taskTitle) {
+  const segments = [];
+  if (taskNumber !== undefined && Number.isFinite(taskNumber)) {
+    segments.push(`Task #${taskNumber}`);
+  }
+  if (taskTitle) {
+    segments.push(clip(taskTitle, MAX_UPDATE_TITLE));
+  }
+  segments.push(statusLabel);
+  return segments.length > 1 ? `\uD83D\uDCCB ${segments.join(" · ")}` : `\uD83D\uDCCB ${statusLabel}`;
+}
+function buildWecomCardUpdateFrame(input) {
+  const reqId = (input.reqId ?? "").trim();
+  if (!reqId) {
+    throw new Error("buildWecomCardUpdateFrame: req_id is required " + "(update must reference the template_card_event frame)");
+  }
+  const buttons = (input.buttonOverrides ?? []).slice(0, MAX_BUTTONS).map((b) => ({
+    text: clip(b.text, MAX_BUTTON_TEXT),
+    style: b.style ?? 1,
+    key: b.key
+  }));
+  const sorted = [...input.timeline ?? []].reverse();
+  const timelineRows = sorted.slice(0, MAX_HORIZONTAL_ROWS).map((m) => ({
+    keyname: formatTs(m.timestamp).slice(11),
+    value: shortMilestoneValue(m.title)
+  }));
+  const total = sorted.length;
+  let subTitle = total > 0 ? total > MAX_HORIZONTAL_ROWS ? `共 ${total} 条操作记录，显示最近 ${MAX_HORIZONTAL_ROWS} 条（最新在顶部）` : `共 ${total} 条操作记录（最新在顶部）` : undefined;
+  let quoteArea;
+  if (input.activity !== undefined) {
+    const q = formatActivityQuote(input.activity ?? undefined, input.activityNow ?? Date.now(), input.activityTerminal ?? false);
+    if (q.overflow) {
+      const oneLine = q.text.replace(/\n/g, " · ");
+      subTitle = subTitle ? `${subTitle}
+${oneLine}` : oneLine;
+      quoteArea = undefined;
+    } else {
+      quoteArea = { type: 0, title: q.title, quote_text: q.text };
+    }
+  }
+  return {
+    cmd: "aibot_respond_update_msg",
+    headers: { req_id: reqId },
+    body: {
+      response_type: "update_template_card",
+      template_card: {
+        card_type: "button_interaction",
+        main_title: {
+          title: buildUpdateMainTitle(input.statusLabel, input.taskNumber, input.taskTitle),
+          desc: input.note ? clip(input.note, 80) : undefined
+        },
+        sub_title_text: subTitle,
+        horizontal_content_list: timelineRows,
+        ...quoteArea ? { quote_area: quoteArea } : {},
+        button_list: buttons,
+        task_id: String(input.taskId)
+      }
+    }
+  };
+}
+var MAX_SESSION_UPDATE_HEAD = 40;
+function buildWecomSessionUpdateFrame(input) {
+  const reqId = (input.reqId ?? "").trim();
+  if (!reqId) {
+    throw new Error("buildWecomSessionUpdateFrame: req_id is required " + "(update must reference the template_card_event frame)");
+  }
+  const now = input.now ?? Date.now();
+  const lifecycle = input.lifecycle;
+  const statusLabel = WECOM_SESSION_LIFECYCLE_PHRASE[lifecycle];
+  const terminal = lifecycle !== "running";
+  const headRaw = input.title?.trim() || input.sessionId;
+  const head = clip(headRaw, MAX_SESSION_UPDATE_HEAD);
+  const mainTitle = `\uD83D\uDCCA 子会话 · ${head} · ${statusLabel}`;
+  const rows = [];
+  rows.push({
+    keyname: clip("状态", MAX_HORIZONTAL_KEYNAME),
+    value: clip(statusLabel, MAX_HORIZONTAL_VALUE)
+  });
+  rows.push({
+    keyname: clip("会话", MAX_HORIZONTAL_KEYNAME),
+    value: clip(input.sessionId, MAX_HORIZONTAL_VALUE)
+  });
+  if (input.agentType) {
+    rows.push({
+      keyname: clip("Agent", MAX_HORIZONTAL_KEYNAME),
+      value: clip(input.agentType, MAX_HORIZONTAL_VALUE)
+    });
+  }
+  const elapsed = input.elapsedText ?? formatElapsedText(input.startedAt, now, terminal);
+  if (elapsed) {
+    rows.push({
+      keyname: clip("已运行", MAX_HORIZONTAL_KEYNAME),
+      value: clip(elapsed, MAX_HORIZONTAL_VALUE)
+    });
+  }
+  if (input.task) {
+    rows.push({
+      keyname: clip("任务", MAX_HORIZONTAL_KEYNAME),
+      value: clip(`#${input.task.id}${input.task.title ? ` ${input.task.title}` : ""}`, MAX_HORIZONTAL_VALUE)
+    });
+  }
+  if (input.perTaskChatId) {
+    rows.push({
+      keyname: clip("飞书群", MAX_HORIZONTAL_KEYNAME),
+      value: clip(input.perTaskChatId, MAX_HORIZONTAL_VALUE)
+    });
+  }
+  if (input.task?.status && rows.length < MAX_HORIZONTAL_ROWS) {
+    rows.push({
+      keyname: clip("任务状态", MAX_HORIZONTAL_KEYNAME),
+      value: clip(input.task.status, MAX_HORIZONTAL_VALUE)
+    });
+  }
+  const sorted = [...input.milestones ?? []].reverse();
+  const remaining = Math.max(0, MAX_HORIZONTAL_ROWS - rows.length);
+  const timelineRows = sorted.slice(0, remaining).map((m) => ({
+    keyname: clip(formatTs(m.timestamp).slice(11), MAX_HORIZONTAL_KEYNAME),
+    value: shortMilestoneValue(m.title)
+  }));
+  const totalMs = sorted.length;
+  const droppedMs = totalMs - timelineRows.length;
+  let quoteArea;
+  let subTitle;
+  if (input.activity !== undefined) {
+    const q = formatActivityQuote(input.activity ?? undefined, input.now ?? Date.now(), terminal);
+    if (q.overflow) {
+      subTitle = q.text.replace(/\n/g, " · ");
+    } else {
+      quoteArea = { type: 0, title: q.title, quote_text: q.text };
+    }
+  }
+  if (droppedMs > 0) {
+    const hint = `共 ${totalMs} 条操作记录，显示最近 ${timelineRows.length} 条`;
+    subTitle = subTitle ? `${hint} · ${subTitle}` : hint;
+  }
+  if (input.errorHint) {
+    subTitle = subTitle ? `${input.errorHint} · ${subTitle}` : input.errorHint;
+  }
+  return {
+    cmd: "aibot_respond_update_msg",
+    headers: { req_id: reqId },
+    body: {
+      response_type: "update_template_card",
+      template_card: {
+        card_type: "button_interaction",
+        main_title: { title: mainTitle },
+        ...subTitle ? { sub_title_text: subTitle } : {},
+        horizontal_content_list: [...rows, ...timelineRows],
+        ...quoteArea ? { quote_area: quoteArea } : {},
+        button_list: [
+          {
+            text: "刷新活性",
+            style: 1,
+            key: WecomCardActionKey.REFRESH_ACTIVITY
+          },
+          {
+            text: "建飞书群",
+            style: 1,
+            key: WecomCardActionKey.CREATE_LARK_GROUP
+          }
+        ],
+        card_action: { type: 0 },
+        task_id: String(input.cardTaskId)
+      }
+    }
+  };
+}
+function formatElapsedText(startedAt, now, _terminal) {
+  if (!startedAt)
+    return;
+  const start = new Date(startedAt).getTime();
+  if (!Number.isFinite(start))
+    return;
+  const ms = Math.max(0, now - start);
+  const totalMin = Math.floor(ms / 60000);
+  if (totalMin < 1)
+    return "<1m";
+  const h = Math.floor(totalMin / 60);
+  const m = totalMin % 60;
+  return h > 0 ? `${h}h${m}m` : `${m}m`;
+}
+
+export { WecomCardActionKey, ROY_SESSION_PREFIX, WECOM_SESSION_TASK_SEP, buildWecomTextNoticeCard, buildWecomButtonInteractionCard, buildWecomSessionCard, buildWecomSendCardFrame, buildWecomCardUpdateFrame, buildWecomSessionUpdateFrame };