@ai-setting/roy-agent-core 1.7.66 → 1.7.68

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

@@ -0,0 +1,6 @@
+// src/env/task/tools/completion-copy.ts
+var TASK_COMPLETE_ITEM_BY_ITEM = "按子项逐条验收";
+var TASK_COMPLETION_HINT_ANCHOR = "TASK_COMPLETION_HINT";
+var TASK_COMPLETE_VERIFY_DUTY = "核实义务";
+
+export { TASK_COMPLETE_ITEM_BY_ITEM, TASK_COMPLETION_HINT_ANCHOR, TASK_COMPLETE_VERIFY_DUTY };

package/dist/shared/@ai-setting/{roy-agent-core-0ys85x46.js → roy-agent-core-8bjj3d1b.js}

@@ -1,7 +1,7 @@
 import {
   LarkCardPatchNotifier,
   formatDurationMs
-} from "./roy-agent-core-zk2jg0v7.js";
+} from "./roy-agent-core-tadj19vp.js";
 import {
   WorkflowHookPoints,
   init_workflow_hook_points

package/dist/shared/@ai-setting/{roy-agent-core-2wxbx36p.js → roy-agent-core-dnjm17sa.js}

@@ -10,7 +10,7 @@ import {
 } from "./roy-agent-core-1pg0fepg.js";
 import {
   builtInPrompts
-} from "./roy-agent-core-vs5gxgwh.js";
+} from "./roy-agent-core-ma35jyd9.js";
 import {
   DEFAULT_SUBAGENT_PROMPT
 } from "./roy-agent-core-07fvy74y.js";
@@ -1832,14 +1832,33 @@ ${reuseSection.markdown}`;
   async forceStopAll() {
     return this.forceStopAllAcrossParents();
   }
-  async dispose() {
+  async dispose(options) {
     for (const [, timer] of this.progressTimers) {
       try {
         clearInterval(timer);
       } catch {}
     }
     this.progressTimers.clear();
+    const skipAbortRunningTasks = options?.skipAbortRunningTasks === true;
+    const waitForRunningTasks = options?.waitForRunningTasks === true;
+    if (waitForRunningTasks && skipAbortRunningTasks) {
+      const waitStart = Date.now();
+      const WAIT_TIMEOUT_MS = 10 * 60 * 1000;
+      while (Date.now() - waitStart < WAIT_TIMEOUT_MS) {
+        let running = 0;
+        for (const [, t] of this.tasks) {
+          if (t.status === "running" || t.status === "pending")
+            running++;
+        }
+        if (running === 0)
+          break;
+        logger3.info(`[BackgroundTaskManager] dispose waiting for ${running} running task(s)`);
+        await new Promise((resolve) => setTimeout(resolve, 200));
+      }
+    }
     for (const [, controller] of this.abortControllers) {
+      if (skipAbortRunningTasks)
+        break;
       try {
         controller.abort();
       } catch {}

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

@@ -2,6 +2,11 @@ import {
   NEW_TASK_ID_HASH_PLACEHOLDER,
   NEW_TASK_ID_PLACEHOLDER
 } from "./roy-agent-core-tr3ep81v.js";
+import {
+  TASK_COMPLETE_ITEM_BY_ITEM,
+  TASK_COMPLETE_VERIFY_DUTY,
+  TASK_COMPLETION_HINT_ANCHOR
+} from "./roy-agent-core-6m4bw8jy.js";
 import {
   getEnvContextOrEmpty,
   init_env_context,
@@ -38,7 +43,7 @@ var CreateTaskToolSchema = z.object({
   description: z.string().optional().describe("Task description"),
   priority: z.enum(["low", "medium", "high"]).optional().describe("Task priority"),
   type: z.enum(["normal", "cycle", "longterm"]).optional().default("normal").describe("Task type. normal: 常规任务，需要跟踪完成. cycle: 周期任务（如每周发周报），无需 complete，定期执行. longterm: 长期任务/愿景目标（如提升公司影响力），难以一次性完成，持续跟进"),
-  goals_and_expected_deliverables: z.string().optional().describe("Goals and expected deliverables"),
+  goals_and_expected_deliverables: z.string().optional().describe("Goals and expected deliverables. " + "⚠️ 写成可逐条验收的编号子项（1. … 2. … 3. …），每条是一个可判定的交付/动作" + "（文件断言：文件存在/大小/内容；进程断言：命令 exit code/stdout；" + "测试断言：pass/fail 计数；状态断言：版本号/HTTP 200/状态字段）。" + "避免一句话模糊目标（如「做好 X」「完成调研」）——" + "任务完成时 completion hook 会按这些子项逐条对照操作记录验收。"),
   due_date: z.string().optional().describe("Due date (ISO format)"),
   tags: z.array(z.string()).optional().describe("Task tags (for search, stored in task.tags JSON field)"),
   project_path: z.string().default("unknown").describe("Project root path for task positioning. " + "Used to locate the project space for this task. " + "Use 'unknown' if unknown. (Defaults to 'unknown'.)"),
@@ -84,7 +89,7 @@ var UpdateTaskToolSchema = withLegacyTaskId({
   type: z.enum(["normal", "cycle", "longterm"]).optional().describe("Task type"),
   progress: z.number().min(0).max(100).optional(),
   current_status: z.string().optional(),
-  goals_and_expected_deliverables: z.string().optional(),
+  goals_and_expected_deliverables: z.string().optional().describe("Goals and expected deliverables. " + "⚠️ 追加/修改时同样写成可逐条验收的编号子项（1. … 2. … 3. …），" + "每条是一个可判定的交付/动作（文件断言：文件存在/大小/内容；" + "进程断言：命令 exit code/stdout；测试断言：pass/fail 计数；" + "状态断言：版本号/HTTP 200/状态字段）。" + "避免一句话模糊目标（如「做好 X」「完成调研」）——" + "任务完成时 completion hook 会按这些子项逐条对照操作记录验收。" + "（Task #4833 — 与 task_create 的 goals 规则同源）"),
   due_date: z.string().optional(),
   tags: z.array(z.string()).optional(),
   project_path: z.string().optional().describe("Project path, identifies which project this task belongs to"),
@@ -316,6 +321,37 @@ function createTaskTool(taskComponent) {
         - Same-theme tasks cluster under one parent
         - Long-tail/stranded tasks should be archived or merged
 
+      ## ⚠️ Goals 子项拆分规则 (Task #4791)
+
+      \`goals_and_expected_deliverables\` **MUST** be written as
+      **numbered sub-items** (编号子项) that can each be verified
+      one by one (逐条验收) — for \`type=normal\` tasks:
+
+        1. 实现 X（含文件路径）
+        2. 测试 Y 覆盖 Z 场景（pass/fail 计数）
+        3. 文档 W 落盘到 <path>
+
+      ⚠️ For \`type=longterm\` / \`type=cycle\` tasks there is no
+      per-item completion acceptance（不走逐条 complete 验收）, so the
+      MUST above does not apply; for those, it is **strongly recommended**
+      (建议) to split goals into staged, individually checkable sub-items
+      (阶段性可判子项) instead of one vague sentence.
+
+      Why: when the task is completed, the completion hook
+      (task:after.complete) judges the whole goal against the
+      operation-record chain, using each sub-item as fine-grained
+      evidence (逐条对照的依据). Vague one-line goals (一句话模糊目标，
+      如「做好 X」「完成调研」) give the judge nothing to check and
+      make a completion hint much more likely.
+
+      Reference the four atomic assertion forms (Task #4768
+      四原子形态) when writing each sub-item:
+
+        - 文件断言 (file assertion): file exists / size / content grep
+        - 进程断言 (process assertion): command exit code / stdout match
+        - 测试断言 (test assertion): pass/fail counts, no NEW fail
+        - 状态断言 (state assertion): version number / HTTP 200 / status field
+
       ## ⚠️ Spatial + Temporal Context (Task #2325)
 
       A task MUST carry spatio-temporal context so it survives task-handoff
@@ -917,8 +953,28 @@ Mark a task as completed (progress=100, status=completed). Creates an operation
 
 1. Read the task's \`goal\` (description) and \`delivery\` (goals_and_expected_deliverables) fields.
    - Use \`task_get(task_id=<id>)\` to fetch the full task record.
-2. **Validate** whether the goal and delivery match what you actually delivered.
-   - If mismatch, either: (a) extend the task via \`task_update\`, or (b) honestly note the discrepancy in your final report.
+2. **Validate whether each goal sub-item was achieved** (${TASK_COMPLETE_ITEM_BY_ITEM}).
+   - Goals should be numbered sub-items (编号子项, see task_create rules). Check
+     each sub-item against the operation-record chain (操作记录链) and the
+     deliverable evidence (context.deliverable_storage_path).
+   - The completion hook (task:after.complete) judges the whole goal vs.
+     deliverables; numbered sub-items give it finer-grained evidence to
+     reason with (逐条对照的证据粒度). If it detects that the goal or
+     deliverables appear unmet, the task context will carry a
+     \`[${TASK_COMPLETION_HINT_ANCHOR}]\`.
+   - **If you receive a [${TASK_COMPLETION_HINT_ANCHOR}]**, you MUST verify it
+     (${TASK_COMPLETE_VERIFY_DUTY}): re-read the task via \`task_get\`, then do exactly one of:
+     (a) 确认未完成 → \`task_update(task_id=<id>, status=todo)\` reopen and continue; or
+     (b) 确认已完成 → \`task_operation_create\` (milestone_type=decision,
+         milestone_title=<一行结论>) state why the sub-items are actually
+         met (说明理由).
+     Never ignore it (不允许无视).
+   - If the goal and delivery mismatch **without** a hint, either:
+     (a) extend the task via \`task_update\`, or
+     (b) record the discrepancy via \`task_operation_create\`
+         (milestone_type=decision) — the reason **must** land in the
+         operation record (必须落到操作记录里), not merely a line in
+         your final report (不能只在报告里带一句).
 3. **Provide \`deliverable_storage_path\`** parameter with the deliverable's address:
    - Feishu doc URL (e.g., https://my.feishu.cn/docx/abc)
    - Local file path (e.g., /tmp/report.md)

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

@@ -68,6 +68,8 @@ import {
 
 // src/env/agent/agent-component.ts
 init_logger();
+import fs from "fs/promises";
+import path from "path";
 import { z } from "zod";
 
 // src/env/task/plugins/max-iteration-reminder-plugin.ts
@@ -600,6 +602,7 @@ class AgentComponent extends BaseComponent {
   doomLoopCaches = new Map;
   fallbackState = new Map;
   configComponent;
+  skipAbortRunningTasksOnStop = false;
   configWatcher;
   messageConverter = new SessionMessageConverter;
   _constructorConfig;
@@ -622,6 +625,7 @@ class AgentComponent extends BaseComponent {
       throw new Error("ConfigComponent is required for AgentComponent initialization");
     }
     this.configComponent = options.configComponent;
+    this.skipAbortRunningTasksOnStop = options.skipAbortRunningTasksOnStop === true;
     await this.registerConfig(options);
     await this.initRegistry(options.configComponent);
     this.setStatus("running");
@@ -794,13 +798,19 @@ class AgentComponent extends BaseComponent {
   }
   async onStop() {
     logger2.info("[AgentComponent] Stopping and cleaning up resources...");
-    for (const [name, agent] of this.agents) {
-      if (agent.status === "running" || agent.status === "idle") {
-        this.abort(name);
-        logger2.debug(`[AgentComponent] Aborted agent: ${name}`);
+    const skipAbort = this.skipAbortRunningTasksOnStop === true;
+    if (!skipAbort) {
+      for (const [name, agent] of this.agents) {
+        if (agent.status === "running" || agent.status === "idle") {
+          this.abort(name);
+          logger2.debug(`[AgentComponent] Aborted agent: ${name}`);
+        }
       }
+    } else {
+      logger2.info("[AgentComponent] skipAbortRunningTasksOnStop=true — keeping running agent runs alive");
     }
     this.abortControllers.clear();
+    this.aborted.clear();
     this.doomLoopCaches.clear();
     if (this.configWatcher) {
       this.configWatcher();
@@ -1603,12 +1613,18 @@ class AgentComponent extends BaseComponent {
       const session = await sessionComponent.get(sessionId);
       const existingSnapshot = session?.metadata?.cacheSnapshot;
       if (existingSnapshot && typeof existingSnapshot === "object" && existingSnapshot.systemPrompt) {
-        logger2.debug(`[AgentComponent._run] Reusing cacheSnapshot for session ${sessionId} (snapshotAt=${existingSnapshot.snapshotAt})`);
-        return {
-          snapshot: existingSnapshot,
-          systemPromptOverride: existingSnapshot.systemPrompt
-        };
+        const stale = await this._isMemorySnapshotStale(existingSnapshot);
+        if (stale) {
+          logger2.info(`[AgentComponent._run] cacheSnapshot for session ${sessionId} is stale (${stale}); recreating`);
+        } else {
+          logger2.debug(`[AgentComponent._run] Reusing cacheSnapshot for session ${sessionId} (snapshotAt=${existingSnapshot.snapshotAt})`);
+          return {
+            snapshot: existingSnapshot,
+            systemPromptOverride: existingSnapshot.systemPrompt
+          };
+        }
       }
+      const memoryStat = await this._collectMemoryStat();
       let resolvedSystemPrompt = initialSystemPrompt;
       if (resolvedSystemPrompt && resolvedSystemPrompt.includes("{{memory}}")) {
         try {
@@ -1627,7 +1643,8 @@ class AgentComponent extends BaseComponent {
       const snapshot = {
         systemPrompt: resolvedSystemPrompt ?? agentConfigSystemPrompt ?? "",
         additionInfo: effectiveContext.additionInfo || "",
-        snapshotAt: Date.now()
+        snapshotAt: Date.now(),
+        memoryStat
       };
       try {
         await sessionComponent.update(sessionId, {
@@ -1646,6 +1663,46 @@ class AgentComponent extends BaseComponent {
       return { snapshot: null, systemPromptOverride: undefined };
     }
   }
+  async _isMemorySnapshotStale(snapshot) {
+    const stat = snapshot.memoryStat;
+    if (!stat || typeof stat !== "object") {
+      return "no-memoryStat (legacy snapshot)";
+    }
+    const current = await this._collectMemoryStat();
+    if (current.globalMtime !== stat.globalMtime) {
+      return `global memory.md mtime changed (${stat.globalMtime} -> ${current.globalMtime})`;
+    }
+    if (current.projectMtime !== stat.projectMtime) {
+      return `project memory.md mtime changed (${stat.projectMtime} -> ${current.projectMtime})`;
+    }
+    return null;
+  }
+  async _collectMemoryStat() {
+    const empty = { globalMtime: 0, projectMtime: 0 };
+    try {
+      const memoryComponent = this.env?.getComponent?.("memory");
+      if (!memoryComponent?.getMemoryPaths || !memoryComponent.getMemoryFile) {
+        return empty;
+      }
+      const memoryFile = memoryComponent.getMemoryFile();
+      const paths = memoryComponent.getMemoryPaths();
+      const result = { globalMtime: 0, projectMtime: 0 };
+      for (const p of paths) {
+        const filePath = path.join(p.path, memoryFile);
+        try {
+          const st = await fs.stat(filePath);
+          if (p.type === "global") {
+            result.globalMtime = st.mtimeMs;
+          } else if (p.type === "project") {
+            result.projectMtime = st.mtimeMs;
+          }
+        } catch {}
+      }
+      return result;
+    } catch {
+      return empty;
+    }
+  }
   async _fallbackReplaceMemory(systemPrompt) {
     if (!systemPrompt.includes("{{memory}}"))
       return systemPrompt;

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

@@ -10,7 +10,7 @@ import {
 } from "./roy-agent-core-1pg0fepg.js";
 import {
   WORKFLOW_EXTRACT_PROMPT
-} from "./roy-agent-core-vs5gxgwh.js";
+} from "./roy-agent-core-ma35jyd9.js";
 import {
   assertNoLeakage,
   buildHintText,
@@ -24,7 +24,7 @@ import {
 import {
   LarkCardPatchNotifier,
   humanizeValue
-} from "./roy-agent-core-zk2jg0v7.js";
+} from "./roy-agent-core-tadj19vp.js";
 import {
   validateWorkflowDefinition
 } from "./roy-agent-core-yr1mryb8.js";
@@ -929,6 +929,7 @@ function truncateSnippet(text) {
 var DEFAULT_TIMEOUT_MS = 2000;
 var DEFAULT_MAX_STRIKES = 3;
 var DEFAULT_MODEL = "task-decision";
+var DEFAULT_GOAL_MODEL = "task-completion";
 var SYSTEMONE_PATH = "/v1/systemone";
 
 class LayaDecisionPort {
@@ -1058,19 +1059,32 @@ function isTimeoutError(err) {
   }
   return false;
 }
+var LAYA_DECISION_PROVIDER = "laya-decision";
+var LAYA_GOAL_DECISION_PROVIDER = "laya-goal-decision";
+function providerNameForPurpose(purpose) {
+  return purpose === "goal" ? LAYA_GOAL_DECISION_PROVIDER : LAYA_DECISION_PROVIDER;
+}
 async function loadLayaAuth(authPath = `${process.env.HOME ?? "~"}/.roy-agent/auth.json`) {
+  return loadLayaAuthForPurpose(authPath, "create");
+}
+async function loadLayaAuthForPurpose(authPath = `${process.env.HOME ?? "~"}/.roy-agent/auth.json`, purpose = "create") {
   try {
     const fs = await import("fs/promises");
     const raw = await fs.readFile(authPath, "utf-8");
     const parsed = JSON.parse(raw);
-    const p = parsed.providers?.["laya-decision"];
-    if (!p?.baseURL || !p?.apiKey)
-      return null;
-    return {
-      baseURL: p.baseURL,
-      apiKey: p.apiKey,
-      model: p.model ?? DEFAULT_MODEL
-    };
+    const primary = providerNameForPurpose(purpose);
+    const candidates = purpose === "goal" ? [primary, LAYA_DECISION_PROVIDER] : [primary];
+    for (const name of candidates) {
+      const p = parsed.providers?.[name];
+      if (p?.baseURL && p?.apiKey) {
+        return {
+          baseURL: p.baseURL,
+          apiKey: p.apiKey,
+          model: p.model ?? (name === LAYA_GOAL_DECISION_PROVIDER ? DEFAULT_GOAL_MODEL : DEFAULT_MODEL)
+        };
+      }
+    }
+    return null;
   } catch {
     return null;
   }
@@ -2162,6 +2176,7 @@ class LarkCliTaskNotifyHook {
         status,
         meta: this.buildTaskMeta(task),
         finalStep: task.current_status || undefined,
+        expandTimeline: rawStatus === "archived" ? true : undefined,
         ...rawStatus === "archived" ? { pausedMilestoneTitle: "Task 已归档" } : {}
       });
       if (isPaused) {
@@ -2937,4 +2952,4 @@ __legacyDecorateClassTS([
 function createPerTaskGroupChatPlugin(config = {}) {
   return new PerTaskGroupChatPlugin(config);
 }
-export { createAutoTaskPlugin, LAYA_REUSE_THRESHOLD, LayaDecisionPlugin, createLayaDecisionPlugin, WORKFLOW_EXTRACTOR_PROMPT, formatExtractorInput, formatExtractorInputFromDescription, parseExtractorOutput, TaskTagPlugin, extractPerTaskChatId, extractPerTaskChatName, NotifyType, LarkCliTaskNotifyHook, createLarkCliTaskNotifyHook, PerTaskGroupChatPlugin, createPerTaskGroupChatPlugin };
+export { createAutoTaskPlugin, pickGateConfidence, LayaDecisionPort, loadLayaAuthForPurpose, LAYA_REUSE_THRESHOLD, LayaDecisionPlugin, createLayaDecisionPlugin, WORKFLOW_EXTRACTOR_PROMPT, formatExtractorInput, formatExtractorInputFromDescription, parseExtractorOutput, TaskTagPlugin, extractPerTaskChatId, extractPerTaskChatName, NotifyType, LarkCliTaskNotifyHook, createLarkCliTaskNotifyHook, PerTaskGroupChatPlugin, createPerTaskGroupChatPlugin };

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

@@ -1,3 +1,9 @@
+import {
+  TASK_COMPLETE_ITEM_BY_ITEM,
+  TASK_COMPLETE_VERIFY_DUTY,
+  TASK_COMPLETION_HINT_ANCHOR
+} from "./roy-agent-core-6m4bw8jy.js";
+
 // src/env/prompt/prompts-index.ts
 var builtInPrompts = {
   default: `你是 {{agent_name}} 接待智能体（Receptionist Agent）—— {{agent_name}} 系统的智能入口。
@@ -125,7 +131,7 @@ var builtInPrompts = {
 - ✅ 功能开发、bug 修复、重构、文档生成
 - ✅ 网络搜索和研究
 
-**roy** 的提示词中内置了任务生命周期——它知道如何使用 \`task_create\`、\`task_update\`、\`task_operation_create\` 和 \`task_complete\` 来跟踪每项工作。
+**roy** 的提示词中内置了任务生命周期——它知道如何使用 \`task_create\`、\`task_update\`、\`task_operation_create\` 和 \`task_complete\` 来跟踪每项工作。task_complete 时会${TASK_COMPLETE_VERIFY_DUTY}：按子项逐条验收（${TASK_COMPLETE_ITEM_BY_ITEM}），若收到 [${TASK_COMPLETION_HINT_ANCHOR}] 必须核实并二选一（重开 / 落 decision 说明理由）。
 
 推荐使用：
 \`\`\`
@@ -893,8 +899,13 @@ Follow this lifecycle for every task:
 ┌─────────────────────────────────────────────────────────────────┐
 │ 6. COMPLETE (task_complete)                                      │
 │    - Mark task as completed (progress=100%, status=completed)   │
-│    - Verify all goals_and_expected_deliverables are met          │
-│    - Create completion operation record                          │
+│    - ${TASK_COMPLETE_ITEM_BY_ITEM}: check each goal sub-item    │
+│      against the operation-record chain + deliverable evidence  │
+│    - If a [${TASK_COMPLETION_HINT_ANCHOR}] appears in task      │
+│      context, you MUST ${TASK_COMPLETE_VERIFY_DUTY}: reopen     │
+│      (task_update status=todo) or record why it is met          │
+│      (task_operation_create decision). Never ignore it.         │
+│    - Create completion operation record                         │
 └─────────────────────────────────────────────────────────────────┘
 \`\`\`
 

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

@@ -148,6 +148,33 @@ var CONTEXT_SKIP_KEYS = new Set([
   "larkPerTaskChatTaskId",
   "larkPerTaskChatCreatedAt"
 ]);
+function isTerminalStatusForTimeline(status) {
+  return status === "completed" || status === "failed" || status === "cancelled" || status === "deleted";
+}
+function isTerminalStatusForWorkflowTimeline(status) {
+  return status !== "running";
+}
+function appendHr(elements) {
+  if (elements.length > 0 && elements[elements.length - 1].tag === "hr")
+    return;
+  elements.push({ tag: "hr" });
+}
+function buildCollapsiblePanel(opts) {
+  const panel = {
+    tag: "collapsible_panel",
+    expanded: opts.expanded ?? false,
+    header: {
+      title: {
+        tag: "markdown",
+        content: sanitizeInlineText(opts.title, 120)
+      }
+    },
+    elements: opts.elements
+  };
+  if (opts.elementId)
+    panel.element_id = opts.elementId;
+  return panel;
+}
 function renderTaskInfoLines(meta) {
   const lines = [];
   if (meta.id !== undefined)
@@ -274,20 +301,51 @@ function buildTaskCard(opts) {
       tag: "markdown",
       content: `[${label}](${link})`
     });
-    elements.push({ tag: "hr" });
+    appendHr(elements);
   }
   const infoLines = renderTaskInfoLines(opts.meta);
   if (infoLines.length > 0) {
-    elements.push({ tag: "markdown", content: infoLines.join(`
-`) });
-    elements.push({ tag: "hr" });
+    elements.push(buildCollapsiblePanel({
+      title: "\uD83D\uDCCB 任务详情",
+      elementId: "task_detail",
+      elements: [{ tag: "markdown", content: infoLines.join(`
+`) }]
+    }));
+    appendHr(elements);
   }
-  elements.push({ tag: "markdown", content: `## \uD83C\uDFAF 里程碑序列` });
-  elements.push({ tag: "markdown", content: renderMilestones(milestones) });
-  elements.push({ tag: "hr" });
-  elements.push({ tag: "markdown", content: `## \uD83D\uDD27 过程信息` });
-  elements.push({ tag: "markdown", content: renderProcessSteps(processSteps) });
-  elements.push({ tag: "hr" });
+  const timelineElements = [];
+  if (milestones.length > 0) {
+    timelineElements.push({
+      tag: "markdown",
+      content: `## \uD83C\uDFAF 里程碑序列`
+    });
+    timelineElements.push({
+      tag: "markdown",
+      content: renderMilestones(milestones)
+    });
+  }
+  if (processSteps.length > 0) {
+    if (timelineElements.length > 0)
+      timelineElements.push({ tag: "hr" });
+    timelineElements.push({
+      tag: "markdown",
+      content: `## \uD83D\uDD27 过程信息`
+    });
+    timelineElements.push({
+      tag: "markdown",
+      content: renderProcessSteps(processSteps)
+    });
+  }
+  if (timelineElements.length > 0) {
+    const timelineTitle = `⏱️ 执行动态（${milestones.length} 里程碑 / ${processSteps.length} 过程）`;
+    elements.push(buildCollapsiblePanel({
+      title: timelineTitle,
+      elementId: "task_timeline",
+      expanded: opts.expandTimeline ?? isTerminalStatusForTimeline(status),
+      elements: timelineElements
+    }));
+  }
+  appendHr(elements);
   const effectiveProgress = status === "completed" ? 100 : opts.progress;
   const isTerminalStatus = status !== "running";
   const terminalProgressText = status === "deleted" ? "任务已取消（删除），记录已归档" : status === "cancelled" ? "任务已取消" : status === "stopped" ? "任务已停止（可恢复）" : status === "failed" ? "任务失败" : "任务已完成";
@@ -402,21 +460,45 @@ function buildWorkflowCard(opts) {
     error: opts.error
   });
   if (infoLines.length > 0) {
-    elements.push({ tag: "markdown", content: infoLines.join(`
-`) });
-    elements.push({ tag: "hr" });
+    elements.push(buildCollapsiblePanel({
+      title: "\uD83D\uDCCB 运行详情",
+      elementId: "workflow_detail",
+      elements: [{ tag: "markdown", content: infoLines.join(`
+`) }]
+    }));
+    appendHr(elements);
+  }
+  const timelineElements = [];
+  if (milestones.length > 0) {
+    timelineElements.push({ tag: "markdown", content: `## \uD83C\uDFAF 里程碑序列` });
+    timelineElements.push({
+      tag: "markdown",
+      content: renderMilestones(milestones)
+    });
+  }
+  if (processSteps.length > 0) {
+    if (timelineElements.length > 0)
+      timelineElements.push({ tag: "hr" });
+    timelineElements.push({ tag: "markdown", content: `## \uD83D\uDD27 过程信息` });
+    timelineElements.push({
+      tag: "markdown",
+      content: renderProcessSteps(processSteps)
+    });
+  }
+  if (timelineElements.length > 0) {
+    elements.push(buildCollapsiblePanel({
+      title: `⏱️ 执行动态（${milestones.length} 里程碑 / ${processSteps.length} 过程）`,
+      elementId: "workflow_timeline",
+      expanded: opts.expandTimeline ?? isTerminalStatusForWorkflowTimeline(status),
+      elements: timelineElements
+    }));
   }
-  elements.push({ tag: "markdown", content: `## \uD83C\uDFAF 里程碑序列` });
-  elements.push({ tag: "markdown", content: renderMilestones(milestones) });
-  elements.push({ tag: "hr" });
-  elements.push({ tag: "markdown", content: `## \uD83D\uDD27 过程信息` });
-  elements.push({ tag: "markdown", content: renderProcessSteps(processSteps) });
   const effectiveProgress = status === "completed" ? 100 : deriveProgress({
     completedNodes: opts.completedNodes,
     totalNodes: opts.totalNodes,
     progress: opts.progress
   });
-  elements.push({ tag: "hr" });
+  appendHr(elements);
   elements.push({
     tag: "markdown",
     content: effectiveProgress !== undefined ? `**\uD83D\uDCCA 进度**：${renderProgressBar(effectiveProgress)}` : `**\uD83D\uDCCA 进度**：进行中（第 ${updateCount} 次更新，尚未上报百分比）`
@@ -598,7 +680,8 @@ class LarkCardPatchNotifier {
         milestones: mergeUnique(state?.milestones ?? [], [pauseMilestone], milestoneKey),
         processSteps: state?.processSteps ?? [],
         updateCount,
-        spinner
+        spinner,
+        expandTimeline: opts.expandTimeline
       });
       await this.runLarkCli(this.buildPatchCardArgs({
         messageId: opts.messageId,
@@ -653,7 +736,8 @@ class LarkCardPatchNotifier {
         milestones: mergeUnique(state?.milestones ?? [], [finalMilestone], milestoneKey),
         processSteps: state?.processSteps ?? [],
         updateCount,
-        spinner
+        spinner,
+        expandTimeline: opts.expandTimeline
       });
       await this.runLarkCli(this.buildPatchCardArgs({
         messageId: opts.messageId,
@@ -1167,4 +1251,4 @@ function sanitize(text) {
   return `${trimmed.slice(0, 500)}…`;
 }
 
-export { formatTimestampForDisplay, sanitizeInlineText, formatDateTimeForDisplay, renderProgressBar, resolveTaskTitleForDisplay, humanizeValue, renderTaskInfoLines, renderContextAsLines, renderMilestones, renderProcessSteps, buildTaskCard, buildChatAppLink, DEFAULT_APP_LINK_BASE, formatDurationMs, renderWorkflowInfoLines, buildWorkflowCard, LarkCardPatchNotifier };
+export { formatTimestampForDisplay, sanitizeInlineText, formatDateTimeForDisplay, renderProgressBar, resolveTaskTitleForDisplay, humanizeValue, isTerminalStatusForTimeline, isTerminalStatusForWorkflowTimeline, buildCollapsiblePanel, renderTaskInfoLines, renderContextAsLines, renderMilestones, renderProcessSteps, buildTaskCard, buildChatAppLink, DEFAULT_APP_LINK_BASE, formatDurationMs, renderWorkflowInfoLines, buildWorkflowCard, LarkCardPatchNotifier };

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

@@ -1,6 +1,6 @@
 import {
   builtInPrompts
-} from "./roy-agent-core-vs5gxgwh.js";
+} from "./roy-agent-core-ma35jyd9.js";
 import {
   getXDGPath
 } from "./roy-agent-core-qxnbvgwe.js";

package/dist/shared/@ai-setting/{roy-agent-core-4882qsjx.js → roy-agent-core-x0ddc2cr.js}

@@ -1,6 +1,6 @@
 import {
   builtInHandlers
-} from "./roy-agent-core-8nksrtnf.js";
+} from "./roy-agent-core-19na22cc.js";
 import {
   envKeyToConfigKey
 } from "./roy-agent-core-7hh0brvs.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-setting/roy-agent-core",
-  "version": "1.7.66",
+  "version": "1.7.68",
   "type": "module",
   "description": "Core SDK for roy-agent - Environment, Components, Tools, Sessions, Tasks",
   "main": "./dist/index.js",