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

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

@@ -4,35 +4,35 @@ import {
 } from "./roy-agent-core-fttgm52a.js";
 import {
   getSharedEventStore
-} from "./roy-agent-core-na18zwj0.js";
+} from "./roy-agent-core-4t3yskp8.js";
 import {
   builtInPrompts
-} from "./roy-agent-core-9vxh6f8h.js";
+} from "./roy-agent-core-y7fqtzk2.js";
 import {
   TaskHookPoints
 } from "./roy-agent-core-1pg0fepg.js";
 import {
   DEFAULT_SUBAGENT_PROMPT
-} from "./roy-agent-core-ed233k5z.js";
+} from "./roy-agent-core-v1n0106v.js";
 import {
   runWithBgTaskIdAsync
 } from "./roy-agent-core-c1v263jn.js";
 import {
   globalHookManager,
   init_global_hook_manager
-} from "./roy-agent-core-cpcd24n2.js";
+} from "./roy-agent-core-yet36q5k.js";
 import {
   init_context
-} from "./roy-agent-core-qqaak24r.js";
+} from "./roy-agent-core-tkpp1ba0.js";
 import {
   getCurrentTaskId,
   getEnvContext
-} from "./roy-agent-core-7cbpmk4q.js";
+} from "./roy-agent-core-p31ftgq9.js";
 import {
   TracedAs,
   init_decorator,
   wrapFunction
-} from "./roy-agent-core-qq96p0tj.js";
+} from "./roy-agent-core-5s2t8z00.js";
 import {
   createLogger,
   init_logger
@@ -47,6 +47,43 @@ init_decorator();
 init_context();
 import { z } from "zod";
 
+// src/env/task/delegate/delegate-channel-hint.ts
+var DELEGATE_CHANNEL_HINT_TITLE = "## 渠道交付提示（当前会话来自外部渠道）";
+function buildDelegateChannelHint(channelType) {
+  if (!channelType)
+    return;
+  let channelBody;
+  if (channelType === "lark-cli" || channelType.startsWith("lark")) {
+    channelBody = [
+      `- 触发渠道是**飞书**。文档类产出（调研文档 / 报告 / PPT / doc 等）`,
+      `  必须用**飞书云盘**存储：\`lark-cli docs +create --title <标题> --markdown @<本地md>\`，用完即弃。`,
+      `- 交付时只给**云盘链接**（https://my.feishu.cn/...），**不落本地路径**交付。`,
+      `  本地路径只作中转（生成 md → 上传云盘 → 回复里贴云盘链接），不作为交付物。`
+    ].join(`
+`);
+  } else if (channelType === "wecom-cli" || channelType.startsWith("wecom")) {
+    channelBody = [
+      `- 触发渠道是**企业微信**。文档类产出（调研文档 / docs / ppt 等）`,
+      `  必须上传到**企微文档**，链接作为交付物：`,
+      `  - 在线文档：\`wecom-cli doc create --doc-name <标题> --doc-type doc --content-type text --file-path <本地md>\``,
+      `  - 微盘文件：\`wecom-cli disk files upload --file-path <本地文件>\`（默认传到我的空间）`,
+      `- 本地路径只作中转（生成 → 上传企微文档 → 回复里贴链接），**不落本地路径**交付。`
+    ].join(`
+`);
+  }
+  if (!channelBody)
+    return;
+  return [
+    DELEGATE_CHANNEL_HINT_TITLE,
+    ``,
+    `通用措辞：当前会话来自外部渠道，交付类产出优先用该渠道的原生存储/展示方式，`,
+    `不要把本地文件路径当作交付物（渠道用户无法访问本机文件系统）。`,
+    ``,
+    channelBody
+  ].join(`
+`);
+}
+
 // src/env/task/delegate/subagent-resolver.ts
 function isKnownSubagentType(subagentType, registry) {
   if (getSubAgentSpec(subagentType)) {
@@ -743,7 +780,8 @@ var BackgroundTaskEventTypes = {
   FAILED: "task.background.failed",
   TIMEOUT: "task.background.timeout",
   STOPPED: "task.background.stopped",
-  ASK_USER: "task.background.ask_user"
+  ASK_USER: "task.background.ask_user",
+  SESSION_STARTED: "task.background.session_started"
 };
 var builtInSubAgents = [
   {
@@ -825,6 +863,21 @@ var builtInSubAgents = [
 function getSubAgentSpec(id) {
   return builtInSubAgents.find((agent) => agent.id === id);
 }
+function normalizeExtendTools(raw) {
+  if (!Array.isArray(raw))
+    return;
+  const out = [];
+  for (const v of raw) {
+    if (typeof v !== "string")
+      continue;
+    const trimmed = v.trim();
+    if (trimmed.length === 0)
+      continue;
+    if (!out.includes(trimmed))
+      out.push(trimmed);
+  }
+  return out.length > 0 ? out : undefined;
+}
 function ensureSubAgentRegistered(agentComponent, subagentType, basePrompt, subAgent, deniedTools) {
   const registry = agentComponent.getRegistry?.();
   if (registry) {
@@ -858,7 +911,7 @@ var DelegateToolParameters = z.object({
   timeout: z.number().describe("Task timeout in milliseconds. Default: 1800000 (30 minutes). If set, task will be terminated after timeout.").optional(),
   reason: z.string().describe("Brief reason for calling this tool (max 30 chars, e.g., 'Delegate refactor task')").optional(),
   similar_task_ids: z.array(z.number()).max(3).describe("Similar task IDs (max 3) to reference for improving task execution. Search for similar tasks before calling this tool."),
-  sub_session_id: z.string().describe("Existing sub-agent session ID to resume. " + "If provided, the sub-agent will continue from the previous conversation " + "context (used for retry on timeout/failure). " + "Leave empty for a new session.").optional(),
+  sub_session_id: z.string().describe("⚠️ 硬约束：同一任务链的续跑必须传此参数（从终态 notify 的「子 session:」行" + "或 delegate 返回的「\uD83D\uDD17 Sub-session:」行复制）。" + "仅当旧 session 上下文已确认不可救（compact_session 后仍超限 / 迭代上限且无可复用断点）时才留空；" + "留空等于丢弃全部上下文，从零开始。").optional(),
   triggerEventId: z.string().describe("EventStore trigger event ID (ESPlugin v2). Pass it when this delegate_task " + "is triggered by an external event source (e.g. Feishu message) so the " + "completion notification can reply to the original chat instead of a " + "fallback channel. Leave empty if not triggered by an event source.").optional()
 });
 function buildEntryAgentPrompt(options) {
@@ -1116,7 +1169,7 @@ class BackgroundTaskManager {
     return null;
   }
   async createTask(options) {
-    const { parentSessionId, description, prompt, subagentType, timeout, similarTaskIds, existingSubSessionId, triggerEventId, model, fallbackModel, fallbackModels, systemPrompt } = options;
+    const { parentSessionId, description, prompt, subagentType, timeout, similarTaskIds, existingSubSessionId, triggerEventId, model, fallbackModel, fallbackModels, systemPrompt, extendTools } = options;
     const taskIdGen = `process_${Date.now()}_${Math.random().toString(36).slice(2, 11)}`;
     const sessionComponent = this.getSessionComponent();
     if (!sessionComponent) {
@@ -1175,6 +1228,10 @@ class BackgroundTaskManager {
         if (profile) {
           metadata.larkProfile = profile;
         }
+        const channelType = replyChannel?.type;
+        if (channelType) {
+          metadata.channelType = channelType;
+        }
       }
       if (triggerEventId) {
         metadata.triggerEventId = triggerEventId;
@@ -1219,6 +1276,7 @@ class BackgroundTaskManager {
       fallbackModel,
       fallbackModels,
       systemPrompt,
+      extendTools,
       replyChannel: replyChannelSnapshot,
       pluginEnabledSnapshot
     };
@@ -1234,6 +1292,16 @@ class BackgroundTaskManager {
       timeoutMs: timeout || DEFAULT_TIMEOUT
     };
     this.publishBackgroundEvent(BackgroundTaskEventTypes.STARTED, startedPayload, parentSessionId, triggerEventId, replyChannelSnapshot, task.pluginEnabledSnapshot);
+    this.publishBackgroundEvent(BackgroundTaskEventTypes.SESSION_STARTED, {
+      backgroundTaskId: taskIdGen,
+      subSessionId: subSession.id,
+      parentSessionId,
+      description,
+      subagentType,
+      associatedTaskId: undefined,
+      lifecycle: "running",
+      startedAt: createdAt
+    }, parentSessionId, triggerEventId, replyChannelSnapshot, task.pluginEnabledSnapshot);
     this.executeTask(taskIdGen, prompt, timeout, parentSessionId).catch((err) => {
       logger3.error(`[BackgroundTaskManager] executeTask unhandled rejection`, {
         taskId: taskIdGen,
@@ -1277,6 +1345,16 @@ class BackgroundTaskManager {
       if (task.associatedTaskId === undefined) {
         task.associatedTaskId = getCurrentTaskId();
       }
+      this.publishBackgroundEvent(BackgroundTaskEventTypes.SESSION_STARTED, {
+        backgroundTaskId: task.id,
+        subSessionId: task.subSessionId,
+        parentSessionId: parentSessionId || task.parentSessionId,
+        description: task.description,
+        subagentType: task.subagentType,
+        associatedTaskId: task.associatedTaskId,
+        lifecycle: "completed",
+        executionTimeMs
+      }, parentSessionId || task.parentSessionId, task.triggerEventId, task.replyChannel, task.pluginEnabledSnapshot);
       const completedPayload = {
         backgroundTaskId: task.id,
         subSessionId: task.subSessionId,
@@ -1324,7 +1402,7 @@ class BackgroundTaskManager {
           executionTimeMs,
           hints: [
             "请把上面的问题原样通过 ask_user tool 展示给用户并等待答复",
-            `得到用户回复后，通过 delegate_task(subagentType="${task.subagentType}", existingSubSessionId="${task.subSessionId}", prompt=<基于用户回复>) 复用 sub-session 让 sub-agent 继承之前消息历史继续推进，无需实现 resume function`
+            `得到用户回复后，通过 delegate_task(subagent_type="${task.subagentType}", sub_session_id="${task.subSessionId}", prompt=<基于用户回复>) 复用 sub-session 让 sub-agent 继承之前消息历史继续推进，无需实现 resume function`
           ],
           associatedTaskId: task.associatedTaskId
         };
@@ -1351,6 +1429,16 @@ class BackgroundTaskManager {
           associatedTaskId: task.associatedTaskId
         };
         this.publishBackgroundEvent(BackgroundTaskEventTypes.STOPPED, stoppedPayload, parentSessionId || task.parentSessionId, task.triggerEventId, task.replyChannel, task.pluginEnabledSnapshot);
+        this.publishBackgroundEvent(BackgroundTaskEventTypes.SESSION_STARTED, {
+          backgroundTaskId: task.id,
+          subSessionId: task.subSessionId,
+          parentSessionId: parentSessionId || task.parentSessionId,
+          description: task.description,
+          subagentType: task.subagentType,
+          associatedTaskId: task.associatedTaskId,
+          lifecycle: "stopped",
+          executionTimeMs
+        }, parentSessionId || task.parentSessionId, task.triggerEventId, task.replyChannel, task.pluginEnabledSnapshot);
       } else if (errorMessage.startsWith("Task execution timeout after")) {
         task.status = "timeout";
         const timeoutPayload = {
@@ -1364,6 +1452,16 @@ class BackgroundTaskManager {
           associatedTaskId: task.associatedTaskId
         };
         this.publishBackgroundEvent(BackgroundTaskEventTypes.TIMEOUT, timeoutPayload, parentSessionId || task.parentSessionId, task.triggerEventId, task.replyChannel, task.pluginEnabledSnapshot);
+        this.publishBackgroundEvent(BackgroundTaskEventTypes.SESSION_STARTED, {
+          backgroundTaskId: task.id,
+          subSessionId: task.subSessionId,
+          parentSessionId: parentSessionId || task.parentSessionId,
+          description: task.description,
+          subagentType: task.subagentType,
+          associatedTaskId: task.associatedTaskId,
+          lifecycle: "timeout",
+          executionTimeMs
+        }, parentSessionId || task.parentSessionId, task.triggerEventId, task.replyChannel, task.pluginEnabledSnapshot);
       } else {
         task.status = "failed";
         const failedPayload = {
@@ -1376,6 +1474,16 @@ class BackgroundTaskManager {
           associatedTaskId: task.associatedTaskId
         };
         this.publishBackgroundEvent(BackgroundTaskEventTypes.FAILED, failedPayload, parentSessionId || task.parentSessionId, task.triggerEventId, task.replyChannel, task.pluginEnabledSnapshot);
+        this.publishBackgroundEvent(BackgroundTaskEventTypes.SESSION_STARTED, {
+          backgroundTaskId: task.id,
+          subSessionId: task.subSessionId,
+          parentSessionId: parentSessionId || task.parentSessionId,
+          description: task.description,
+          subagentType: task.subagentType,
+          associatedTaskId: task.associatedTaskId,
+          lifecycle: "failed",
+          executionTimeMs
+        }, parentSessionId || task.parentSessionId, task.triggerEventId, task.replyChannel, task.pluginEnabledSnapshot);
       }
       task.error = errorMessage;
       logger3.error(`[BackgroundTaskManager] Task execution error`, {
@@ -1552,6 +1660,15 @@ ${reuseSection.markdown}`;
         error: err instanceof Error ? err.message : String(err)
       });
     }
+    const channelTypeHint = metadata.channelType ?? getEnvContext()?.replyChannel?.type;
+    const channelHint = buildDelegateChannelHint(channelTypeHint);
+    if (channelHint) {
+      fullPrompt += `
+
+---
+
+${channelHint}`;
+    }
     const subAgentForRegister = subAgent ? { ...subAgent, allowedTools } : allowedTools ? {
       id: subagentType,
       name: subagentType,
@@ -1641,7 +1758,8 @@ ${reuseSection.markdown}`;
           ...inheritedModel ? { model: inheritedModel } : {},
           ...inheritedFallbackModel ? { fallbackModel: inheritedFallbackModel } : {},
           ...Array.isArray(inheritedFallbackModels) ? { fallbackModels: inheritedFallbackModels } : {},
-          ...task?.systemPrompt ? { metadata: { systemPrompt: task.systemPrompt } } : {}
+          ...task?.systemPrompt ? { metadata: { systemPrompt: task.systemPrompt } } : {},
+          ...task?.extendTools?.length ? { extendTools: task.extendTools } : {}
         });
       };
       const wrappedPromise = processRegistry ? runWithProcessRegistryAsync(processRegistry, () => runWithBgTaskIdAsync(bgTaskId, () => invokeHandleQuery())) : runWithBgTaskIdAsync(bgTaskId, () => invokeHandleQuery());
@@ -2057,7 +2175,7 @@ No need to poll — just wait for the notification and use \`task_get\` with the
       };
       await globalHookManager.execute(TaskHookPoints.DELEGATE_BEFORE, delegateCtx, { sessionId: parentSessionId });
       promptWithTaskInfo = delegateCtx.prompt;
-      return await handleBackgroundTask(backgroundTaskManager, parentSessionId, description, promptWithTaskInfo, delegateCtx.subagentType, delegateCtx.timeout, similar_task_ids, params.sub_session_id, resolvedTriggerEventId, ctx.model, ctx.fallbackModel, ctx.fallbackModels, ctx.metadata?.systemPrompt);
+      return await handleBackgroundTask(backgroundTaskManager, parentSessionId, description, promptWithTaskInfo, delegateCtx.subagentType, delegateCtx.timeout, similar_task_ids, params.sub_session_id, resolvedTriggerEventId, ctx.model, ctx.fallbackModel, ctx.fallbackModels, ctx.metadata?.systemPrompt, normalizeExtendTools(ctx.metadata?.extendTools));
     }
   };
   tool.execute = wrapFunction(tool.execute, "delegate.execute", {
@@ -2113,7 +2231,7 @@ function _capturePluginEnabledSnapshot() {
   return { ...pluginEnabled };
 }
 var capturePluginEnabledSnapshot = wrapFunction(_capturePluginEnabledSnapshot, "delegate.capturePluginEnabled", { recordParams: false, recordResult: true, recordError: true });
-async function handleBackgroundTask(backgroundTaskManager, parentSessionId, description, prompt, subagentType, timeout, similarTaskIds, existingSubSessionId, triggerEventId, model, fallbackModel, fallbackModels, systemPrompt) {
+async function handleBackgroundTask(backgroundTaskManager, parentSessionId, description, prompt, subagentType, timeout, similarTaskIds, existingSubSessionId, triggerEventId, model, fallbackModel, fallbackModels, systemPrompt, extendTools) {
   const startTime = Date.now();
   try {
     let actualSubagentType = subagentType;
@@ -2143,7 +2261,8 @@ async function handleBackgroundTask(backgroundTaskManager, parentSessionId, desc
       model,
       fallbackModel,
       fallbackModels,
-      systemPrompt
+      systemPrompt,
+      extendTools
     });
     const output = [
       `✅ Background task accepted`,
@@ -2153,6 +2272,8 @@ async function handleBackgroundTask(backgroundTaskManager, parentSessionId, desc
       `\uD83E\uDD16 Sub-agent: ${actualSubagentType}${originalWorkflowName ? ` (workflow: ${originalWorkflowName})` : ""}`,
       `⏱️ Timeout: ${(timeout || DEFAULT_TIMEOUT) / 1000}s`,
       "",
+      `\uD83D\uDD17 Sub-session: ${subSessionId}   （续跑本任务：delegate_task(sub_session_id="${subSessionId}", prompt="...")）`,
+      "",
       `Use stop_task with task_id="${bgProcessId}" to cancel this task.`
     ].join(`
 `);
@@ -2176,4 +2297,4 @@ async function handleBackgroundTask(backgroundTaskManager, parentSessionId, desc
     };
   }
 }
-export { BackgroundTaskEventTypes, builtInSubAgents, getSubAgentSpec, DelegateToolParameters, buildEntryAgentPrompt, WORKFLOW_COMPAT_ALIASES, DEFAULT_TIMEOUT, PROGRESS_INTERVAL, BackgroundTaskManager, createDelegateTool, deriveTriggerEventIdFromEnvContext, captureReplyChannelSnapshot, capturePluginEnabledSnapshot, handleBackgroundTask };
+export { BackgroundTaskEventTypes, builtInSubAgents, getSubAgentSpec, normalizeExtendTools, DelegateToolParameters, buildEntryAgentPrompt, WORKFLOW_COMPAT_ALIASES, DEFAULT_TIMEOUT, PROGRESS_INTERVAL, BackgroundTaskManager, createDelegateTool, deriveTriggerEventIdFromEnvContext, captureReplyChannelSnapshot, capturePluginEnabledSnapshot, handleBackgroundTask };

package/dist/shared/@ai-setting/{roy-agent-core-87942bw4.js → roy-agent-core-1mhyh4c5.js}

@@ -4,7 +4,7 @@ import {
 } from "./roy-agent-core-rvv6ydff.js";
 import {
   BaseComponent
-} from "./roy-agent-core-pgvcf91v.js";
+} from "./roy-agent-core-m39v7qpx.js";
 import {
   __require
 } from "./roy-agent-core-fs0mn2jk.js";

package/dist/shared/@ai-setting/{roy-agent-core-v6vr6za7.js → roy-agent-core-1vv4fx15.js}

@@ -3,17 +3,17 @@ import {
 } from "./roy-agent-core-az13yzmc.js";
 import {
   BaseComponent
-} from "./roy-agent-core-pgvcf91v.js";
+} from "./roy-agent-core-m39v7qpx.js";
 import {
   globalHookManager,
   init_global_hook_manager
-} from "./roy-agent-core-cpcd24n2.js";
+} from "./roy-agent-core-yet36q5k.js";
 import {
   init_context
-} from "./roy-agent-core-qqaak24r.js";
+} from "./roy-agent-core-tkpp1ba0.js";
 import {
   getEnvContextOrEmpty
-} from "./roy-agent-core-7cbpmk4q.js";
+} from "./roy-agent-core-p31ftgq9.js";
 import {
   createLogger,
   init_logger

package/dist/shared/@ai-setting/{roy-agent-core-nwbfepba.js → roy-agent-core-3e040tc5.js}

@@ -6,7 +6,7 @@ import {
 } from "./roy-agent-core-7hh0brvs.js";
 import {
   BaseComponent
-} from "./roy-agent-core-pgvcf91v.js";
+} from "./roy-agent-core-m39v7qpx.js";
 import {
   createLogger,
   init_logger

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

@@ -0,0 +1,288 @@
+// src/env/task/plugins/sub-session-activity.ts
+function flattenInline(text) {
+  return text.replace(/\r\n?/g, `
+`).replace(/\n+/g, " · ").replace(/\s{2,}/g, " ").replace(/(?:\s*·\s*){2,}/g, " · ").replace(/^(\s*·\s*)+/, "").replace(/(\s*·\s*)+$/, "").trim();
+}
+var ACTIVITY_ACTIVE_MS = 5 * 60 * 1000;
+var ACTIVITY_SLOW_MS = 20 * 60 * 1000;
+var DEFAULT_ACTIVITY_MESSAGE_MAX = 200;
+function formatAgo(updatedAt, now) {
+  if (updatedAt === undefined || !Number.isFinite(updatedAt))
+    return;
+  const diff = now - updatedAt;
+  if (!Number.isFinite(diff) || diff < 60000)
+    return "刚刚";
+  const minutes = Math.floor(diff / 60000);
+  if (minutes < 60)
+    return `${minutes} 分钟前`;
+  const hours = Math.floor(minutes / 60);
+  if (hours < 24)
+    return `${hours} 小时前`;
+  return `${Math.floor(hours / 24)} 天前`;
+}
+function formatClockTime(ts) {
+  if (ts === undefined || !Number.isFinite(ts))
+    return;
+  const d = new Date(ts);
+  if (Number.isNaN(d.getTime()))
+    return;
+  const pad = (n) => n < 10 ? `0${n}` : String(n);
+  return `${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}`;
+}
+function resolveActivityLiveness(activity, now, terminal = false) {
+  if (!activity) {
+    return { level: "unknown", dot: "❔", label: "未知" };
+  }
+  const agoText = formatAgo(activity.updatedAt, now);
+  if (terminal) {
+    return { level: "terminal", dot: "⚪", label: "已结束", agoText };
+  }
+  const updatedAt = activity.updatedAt;
+  if (updatedAt === undefined || !Number.isFinite(updatedAt)) {
+    return { level: "unknown", dot: "❔", label: "未知", agoText };
+  }
+  const age = now - updatedAt;
+  if (!Number.isFinite(age) || age < ACTIVITY_ACTIVE_MS) {
+    return { level: "active", dot: "\uD83D\uDFE2", label: "活跃", agoText };
+  }
+  if (age < ACTIVITY_SLOW_MS) {
+    return { level: "slow", dot: "\uD83D\uDFE1", label: "缓慢", agoText };
+  }
+  return { level: "stalled", dot: "\uD83D\uDD34", label: "疑似停滞", agoText };
+}
+function truncateActivityMessage(text, max = DEFAULT_ACTIVITY_MESSAGE_MAX) {
+  if (!text)
+    return "";
+  const flat = flattenInline(text);
+  if (!flat)
+    return "";
+  if (flat.length <= max)
+    return flat;
+  const cut = flat.slice(0, max - 1);
+  const lastSpace = cut.lastIndexOf(" ");
+  if (lastSpace > max * 0.6)
+    return `${cut.slice(0, lastSpace).trimEnd()}…`;
+  return `${cut}…`;
+}
+function formatActivityLines(activity, now, terminal = false) {
+  const live = resolveActivityLiveness(activity, now, terminal);
+  if (!activity) {
+    return ["❔ 暂无数据（子会话已归档或未落盘）"];
+  }
+  const headParts = [];
+  const agoPhrase = live.agoText ? `（${live.agoText}有写入）` : "";
+  headParts.push(`${live.dot} ${live.label}${agoPhrase}`);
+  headParts.push(`消息数 ${activity.messageCount} 条`);
+  const lines = [headParts.join(" · ")];
+  const clock = formatClockTime(activity.updatedAt);
+  if (clock)
+    lines.push(`\uD83D\uDD50 最近写入：${clock}`);
+  const last = activity.lastMessage;
+  if (last && last.content) {
+    const role = last.role ? `[${last.role}] ` : "";
+    lines.push(`\uD83D\uDCAC 最近消息：${role}${last.content}`);
+  } else {
+    lines.push("\uD83D\uDCAC 最近消息：（暂无文本消息）");
+  }
+  return lines;
+}
+function formatActivityQuote(activity, now, terminal = false) {
+  const live = resolveActivityLiveness(activity, now, terminal);
+  if (!activity) {
+    return {
+      title: "⚡ 子会话活性",
+      text: "❔ 暂无数据（子会话已归档或未落盘）",
+      overflow: false
+    };
+  }
+  const agoPhrase = live.agoText ? `（${live.agoText}有写入）` : "";
+  const head = `${live.dot} ${live.label}${agoPhrase} · 消息数 ${activity.messageCount} 条`;
+  const last = activity.lastMessage;
+  const role = last?.role ? `[${last.role}] ` : "";
+  const body = last?.content ? `${role}${truncateActivityMessage(last.content, 80)}` : "（暂无文本消息）";
+  const text = `${head}
+\uD83D\uDCAC ${body}`;
+  const overflow = text.length > 112;
+  return { title: "⚡ 子会话活性", text, overflow };
+}
+function findBackgroundTaskByAssociatedTaskId(tasks, taskId) {
+  if (!tasks || tasks.length === 0)
+    return;
+  if (!Number.isFinite(taskId))
+    return;
+  let found;
+  for (const t of tasks) {
+    if (!t || typeof t.subSessionId !== "string" || !t.subSessionId)
+      continue;
+    if (t.associatedTaskId === taskId)
+      found = t;
+  }
+  return found;
+}
+function createSessionActivityProbe(ports) {
+  return async (sessionId) => {
+    if (!sessionId)
+      return { activity: undefined, terminal: false };
+    let session;
+    try {
+      session = await ports.getSession?.(sessionId);
+    } catch {
+      session = undefined;
+    }
+    if (!session)
+      return { activity: undefined, terminal: false };
+    let lastMessage;
+    try {
+      lastMessage = await ports.getLastMessage?.(sessionId);
+    } catch {
+      lastMessage = undefined;
+    }
+    let lifecycle = "running";
+    try {
+      lifecycle = await ports.getLifecycle?.(sessionId) ?? "running";
+    } catch {
+      lifecycle = "running";
+    }
+    return {
+      lifecycle,
+      terminal: lifecycle !== "running",
+      activity: {
+        subSessionId: sessionId,
+        messageCount: typeof session.messageCount === "number" ? session.messageCount : 0,
+        updatedAt: typeof session.updatedAt === "number" ? session.updatedAt : Number.NaN,
+        ...lastMessage ? { lastMessage } : {}
+      }
+    };
+  };
+}
+function createActivityProbe(ports) {
+  return async (taskId) => {
+    let terminal = false;
+    try {
+      terminal = await ports.isTerminalTask?.(taskId) ?? false;
+    } catch {
+      terminal = false;
+    }
+    let task;
+    try {
+      task = findBackgroundTaskByAssociatedTaskId(ports.listBackgroundTasks?.(), taskId);
+    } catch {
+      task = undefined;
+    }
+    if (!task)
+      return { activity: undefined, terminal };
+    let stats;
+    try {
+      stats = await ports.getSubSessionActivity?.(task.id);
+    } catch {
+      stats = undefined;
+    }
+    if (!stats)
+      return { activity: undefined, terminal };
+    let lastMessage;
+    try {
+      lastMessage = await ports.getLastMessage?.(task.subSessionId);
+    } catch {
+      lastMessage = undefined;
+    }
+    return {
+      terminal,
+      activity: {
+        subSessionId: task.subSessionId,
+        messageCount: stats.messageCount ?? 0,
+        updatedAt: stats.updatedAt,
+        ...lastMessage ? { lastMessage } : {}
+      }
+    };
+  };
+}
+function toActivityMessage(msg, max = DEFAULT_ACTIVITY_MESSAGE_MAX) {
+  if (!msg)
+    return;
+  let text = msg.content;
+  if (!text || text.length === 0) {
+    const textParts = [];
+    for (const part of msg.parts ?? []) {
+      if (part?.type === "text" && typeof part.content === "string") {
+        textParts.push(part.content);
+      } else if (part?.type === "tool-result" && typeof part.output === "string") {
+        textParts.push(part.output);
+      }
+    }
+    if (textParts.length > 0)
+      text = textParts.join(" ");
+  }
+  const content = truncateActivityMessage(text, max);
+  if (!content) {
+    if (max === DEFAULT_ACTIVITY_MESSAGE_MAX)
+      return;
+    return {
+      role: typeof msg.role === "string" ? msg.role : "unknown",
+      content: "（无文本内容）",
+      ...typeof msg.timestamp === "number" ? { timestamp: msg.timestamp } : {}
+    };
+  }
+  return {
+    role: typeof msg.role === "string" ? msg.role : "unknown",
+    content,
+    ...typeof msg.timestamp === "number" ? { timestamp: msg.timestamp } : {}
+  };
+}
+function mapBgTaskStatusToSessionLifecycle(status) {
+  switch (status) {
+    case "completed":
+      return "completed";
+    case "timeout":
+    case "timed_out":
+      return "timeout";
+    case "failed":
+    case "error":
+      return "failed";
+    case "stopped":
+    case "cancelled":
+    case "canceled":
+    case "aborted":
+      return "stopped";
+    default:
+      return "running";
+  }
+}
+var RECENT_MESSAGE_LIMIT = 5;
+var RECENT_MESSAGE_MAX = 100;
+function extractToolCallsFromMessages(messages) {
+  const calls = [];
+  for (const msg of messages ?? []) {
+    for (const part of msg?.parts ?? []) {
+      if (part?.type !== "tool-call")
+        continue;
+      const toolName = typeof part.toolName === "string" ? part.toolName : undefined;
+      if (!toolName)
+        continue;
+      let args;
+      if (typeof part.arguments === "string") {
+        try {
+          const parsed = JSON.parse(part.arguments);
+          if (parsed && typeof parsed === "object") {
+            args = parsed;
+          }
+        } catch {}
+      } else if (part.arguments && typeof part.arguments === "object") {
+        args = part.arguments;
+      }
+      const reason = typeof args?.reason === "string" && args.reason.trim().length > 0 ? args.reason.trim() : undefined;
+      calls.push({ toolName, ...reason ? { reason } : {} });
+    }
+  }
+  return calls;
+}
+function formatRecentToolCallLines(calls, max = RECENT_MESSAGE_MAX) {
+  if (!calls || calls.length === 0) {
+    return ["暂无工具调用"];
+  }
+  return calls.map((c) => {
+    const reason = truncateActivityMessage(c?.reason, max) || "—";
+    return `- ${c?.toolName ?? "未知"}：${reason}`;
+  });
+}
+
+export { formatActivityLines, formatActivityQuote, createSessionActivityProbe, createActivityProbe, toActivityMessage, mapBgTaskStatusToSessionLifecycle, RECENT_MESSAGE_LIMIT, extractToolCallsFromMessages, formatRecentToolCallLines };