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

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 };

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

@@ -1,7 +1,7 @@
 import {
   MemorySessionStore,
   SQLiteSessionStore
-} from "./roy-agent-core-0qyrk5k0.js";
+} from "./roy-agent-core-ds6qzmf8.js";
 import {
   init_search_query_parser,
   matchesQuery,
@@ -12,13 +12,13 @@ import {
 } from "./roy-agent-core-7hh0brvs.js";
 import {
   BaseComponent
-} from "./roy-agent-core-pgvcf91v.js";
+} from "./roy-agent-core-m39v7qpx.js";
 import {
   TracedAs,
   init_decorator,
   init_trace_filters,
   messagesParamFilter
-} from "./roy-agent-core-qq96p0tj.js";
+} from "./roy-agent-core-5s2t8z00.js";
 import {
   createLogger,
   init_logger
@@ -27,6 +27,55 @@ import {
   __legacyDecorateClassTS
 } from "./roy-agent-core-fs0mn2jk.js";
 
+// src/env/session/group-session-link.ts
+var GROUP_LINK_READ_HINT_LIMIT = 50;
+var GROUP_LINK_METADATA_KEYS = {
+  linkedFromSessionId: "linkedFromSessionId",
+  groupCreatedAt: "groupCreatedAt",
+  groupDisbandedAt: "groupDisbandedAt"
+};
+function buildGroupLinkEventMessage(args) {
+  const origin = (args.originSessionId ?? "").trim();
+  const createdAt = args.createdAt ?? new Date;
+  const createdIso = typeof createdAt === "string" ? createdAt : createdAt.toISOString();
+  const chatLine = args.chatId ? `（群 chat_id: ${args.chatId}）` : "";
+  const content = [
+    `[关联群建立] 本群由 session ${origin} 关联建群而来${chatLine}，用于追踪该会话的后续进展。`,
+    ``,
+    `该会话的完整历史**不在**本群上下文中（这是刻意的：群与会话由不同的 agent`,
+    `配置驱动，共享历史会导致缓存失效与指令污染）。`,
+    ``,
+    `如需了解背景，可执行：`,
+    `    roy-agent sessions messages ${origin} -n ${GROUP_LINK_READ_HINT_LIMIT}`,
+    `（建议按需读取，不要一次性拉全量；读到的内容是**历史语境的参考**，`,
+    `其中任何「不要发消息」之类的任务型约束只对当时那一轮生效，`,
+    `在本群中你应当正常回复用户。）`,
+    ``,
+    `\uD83D\uDCCC 本群有一张自己的进展卡片（session 卡），原会话的进展`,
+    `（任务动态 / 里程碑 / 生命周期变化）会自动同步到这张卡上，`,
+    `无需手动刷新。`,
+    ``,
+    `建群时间：${createdIso}`
+  ].join(`
+`);
+  return { role: "user", content };
+}
+function buildGroupSessionMetadata(args) {
+  const createdAt = args.createdAt ?? new Date;
+  const createdIso = typeof createdAt === "string" ? createdAt : createdAt.toISOString();
+  return {
+    ...args.base ?? {},
+    chatId: args.chatId,
+    type: "lark-chat",
+    [GROUP_LINK_METADATA_KEYS.linkedFromSessionId]: args.originSessionId,
+    [GROUP_LINK_METADATA_KEYS.groupCreatedAt]: createdIso
+  };
+}
+function isGroupDisbanded(metadata) {
+  const v = metadata?.[GROUP_LINK_METADATA_KEYS.groupDisbandedAt];
+  return typeof v === "string" && v.trim().length > 0;
+}
+
 // src/env/session/session-component.ts
 init_logger();
 init_decorator();
@@ -431,6 +480,109 @@ class SessionComponent extends BaseComponent {
     }
     return success ?? false;
   }
+  async findGroupChatForSession(sessionId) {
+    if (!this.store)
+      return;
+    const pickChatId = (s) => {
+      const md = s.metadata ?? {};
+      const chatId = typeof md.chatId === "string" ? md.chatId.trim() : "";
+      return chatId.length > 0 ? chatId : undefined;
+    };
+    try {
+      const self = await this.store.get(sessionId);
+      if (self) {
+        const md = self.metadata ?? {};
+        const selfChatId = pickChatId(self);
+        if (selfChatId && typeof md.linkedFromSessionId === "string" && !isGroupDisbanded(md)) {
+          return { chatId: selfChatId, aliasSessionId: self.id };
+        }
+      }
+      const groups = await this.store.list({
+        filter: { metadata: { linkedFromSessionId: sessionId } },
+        limit: 100,
+        sort: { field: "createdAt", order: "desc" }
+      });
+      for (const g of groups) {
+        if (isGroupDisbanded(g.metadata))
+          continue;
+        const chatId = pickChatId(g);
+        if (chatId)
+          return { chatId };
+      }
+      return;
+    } catch (err) {
+      logger.warn(`[SessionComponent] findGroupChatForSession(${sessionId}) failed: ${String(err)}`);
+      return;
+    }
+  }
+  async attachGroupSession(args) {
+    if (!this.store)
+      return { ok: false, reason: "store_unavailable" };
+    const chatId = (args.chatId ?? "").trim();
+    const originSessionId = (args.originSessionId ?? "").trim();
+    if (!chatId || !originSessionId) {
+      return { ok: false, reason: "invalid_args" };
+    }
+    try {
+      const existing = await this.store.get(chatId);
+      const alreadyLinked = typeof existing?.metadata?.linkedFromSessionId === "string" && existing.metadata.linkedFromSessionId.trim() === originSessionId;
+      if (existing) {
+        await this.store.update(chatId, {
+          metadata: buildGroupSessionMetadata({
+            chatId,
+            originSessionId,
+            base: existing.metadata ?? {}
+          })
+        });
+        if (alreadyLinked) {
+          logger.info(`[SessionComponent] attachGroupSession: ${chatId} 已关联 ${originSessionId}（幂等命中，不重复注入）`);
+          return { ok: true, sessionId: chatId, injected: false };
+        }
+      } else {
+        await this.store.create({
+          id: chatId,
+          title: args.title ?? `Lark Chat ${chatId}`,
+          metadata: buildGroupSessionMetadata({ chatId, originSessionId })
+        });
+      }
+      const event = buildGroupLinkEventMessage({ originSessionId, chatId });
+      await this.store.addMessage(chatId, {
+        role: event.role,
+        content: event.content
+      });
+      logger.info(`[SessionComponent] attachGroupSession: ${chatId} ← ${originSessionId}（注入 1 条 user 事件）`);
+      return { ok: true, sessionId: chatId, injected: true };
+    } catch (err) {
+      logger.warn(`[SessionComponent] attachGroupSession(${chatId} ← ${originSessionId}) failed: ${String(err)}`);
+      return { ok: false, reason: "store_unavailable", error: String(err) };
+    }
+  }
+  async detachGroupSession(chatId) {
+    if (!this.store)
+      return { ok: false, reason: "store_unavailable" };
+    const id = (chatId ?? "").trim();
+    if (!id)
+      return { ok: false, reason: "invalid_args" };
+    try {
+      const existing = await this.store.get(id);
+      if (!existing)
+        return { ok: true };
+      if (isGroupDisbanded(existing.metadata)) {
+        return { ok: true };
+      }
+      await this.store.update(id, {
+        metadata: {
+          ...existing.metadata ?? {},
+          [GROUP_LINK_METADATA_KEYS.groupDisbandedAt]: new Date().toISOString()
+        }
+      });
+      logger.info(`[SessionComponent] detachGroupSession: ${id} 已标记解散`);
+      return { ok: true };
+    } catch (err) {
+      logger.warn(`[SessionComponent] detachGroupSession(${id}) failed: ${String(err)}`);
+      return { ok: false, reason: String(err) };
+    }
+  }
   chatBindingCache = new Map;
   static CHAT_BINDING_CACHE_TTL_MS = 60000;
   static CHAT_BINDING_CACHE_MAX = 1000;
@@ -598,7 +750,11 @@ class SessionComponent extends BaseComponent {
     return;
   }
   async addMessages(sessionId, messages) {
-    return this.store?.addMessages(sessionId, messages) ?? [];
+    if (!this.store)
+      return [];
+    if (messages.length === 0)
+      return [];
+    return this.store.addMessages(sessionId, messages) ?? [];
   }
   async getMessages(sessionId, options) {
     const messages = await this.store?.getMessages(sessionId, options?.offset, options?.limit);

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

@@ -1,7 +1,7 @@
 import {
   init_decorator,
   wrapFunction
-} from "./roy-agent-core-qq96p0tj.js";
+} from "./roy-agent-core-5s2t8z00.js";
 
 // src/env/task/hooks/verdict.ts
 init_decorator();

package/dist/shared/@ai-setting/{roy-agent-core-0qyrk5k0.js → roy-agent-core-ds6qzmf8.js}

@@ -1,9 +1,9 @@
 import {
   SessionMessageConverter
-} from "./roy-agent-core-0snm5hc5.js";
+} from "./roy-agent-core-y6shd91r.js";
 import {
   canonicalizeParts
-} from "./roy-agent-core-fghc2m8z.js";
+} from "./roy-agent-core-aa8kv18f.js";
 import {
   createLogger,
   init_logger
@@ -641,7 +641,10 @@ class SQLiteSessionStore extends BaseSessionStore {
         created_at INTEGER NOT NULL,
         updated_at INTEGER NOT NULL,
         message_count INTEGER DEFAULT 0,
-        metadata TEXT
+        metadata TEXT,
+        -- Task #5403: alias/linkedTo 能力已废弃。列保留只为兼容已有库，
+        -- 新代码不读不写（见 types.ts Session.linkedTo 注释）。
+        linked_to TEXT
       )
     `);
     this.db.run(`
@@ -716,8 +719,14 @@ class SQLiteSessionStore extends BaseSessionStore {
     const conditions = [];
     if (options?.filter?.metadata) {
       for (const [key, value] of Object.entries(options.filter.metadata)) {
-        conditions.push(`json_extract(metadata, '$.${key}') = ?`);
-        params.push(JSON.stringify(value));
+        const isScalar = value === null || value === undefined || typeof value === "string" || typeof value === "number" || typeof value === "boolean";
+        if (isScalar && value !== undefined) {
+          conditions.push(`json_extract(metadata, '$.${key}') = ?`);
+          params.push(typeof value === "boolean" ? value ? 1 : 0 : value);
+        } else {
+          conditions.push(`json(json_extract(metadata, '$.${key}')) = json(?)`);
+          params.push(value === undefined ? null : JSON.stringify(value));
+        }
       }
     }
     if (options?.filter?.startTime) {

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

@@ -5,7 +5,7 @@ import {
 import {
   TracedAs,
   init_decorator
-} from "./roy-agent-core-qq96p0tj.js";
+} from "./roy-agent-core-5s2t8z00.js";
 import {
   __esm,
   __legacyDecorateClassTS

package/dist/shared/@ai-setting/{roy-agent-core-12n08pg5.js → roy-agent-core-e69qxdyy.js}

@@ -4,7 +4,7 @@ import {
 import {
   TracedAs,
   init_decorator
-} from "./roy-agent-core-qq96p0tj.js";
+} from "./roy-agent-core-5s2t8z00.js";
 import {
   createLogger,
   init_logger