@ai-setting/roy-agent-core 1.7.93 → 1.7.95

package/dist/env/event-source/event-source-handlers.js

@@ -17,7 +17,7 @@ import {
   resolveLarkChannelSystemPrompt,
   timerHandler,
   wecomCliHandler
-} from "../../shared/@ai-setting/roy-agent-core-33n84tf9.js";
+} from "../../shared/@ai-setting/roy-agent-core-6bga36qk.js";
 import"../../shared/@ai-setting/roy-agent-core-ev110pkx.js";
 import {
   cliCommandHandler
@@ -25,7 +25,7 @@ import {
 import"../../shared/@ai-setting/roy-agent-core-mgmp2gfm.js";
 import"../../shared/@ai-setting/roy-agent-core-kfspjx59.js";
 import"../../shared/@ai-setting/roy-agent-core-2stt4rp5.js";
-import"../../shared/@ai-setting/roy-agent-core-px73ewzd.js";
+import"../../shared/@ai-setting/roy-agent-core-57q8a049.js";
 import"../../shared/@ai-setting/roy-agent-core-th8fq714.js";
 import"../../shared/@ai-setting/roy-agent-core-c4ec7k0p.js";
 import"../../shared/@ai-setting/roy-agent-core-brw8wp2q.js";
@@ -34,8 +34,8 @@ import"../../shared/@ai-setting/roy-agent-core-1pg0fepg.js";
 import"../../shared/@ai-setting/roy-agent-core-msktt7y7.js";
 import"../../shared/@ai-setting/roy-agent-core-m46fe3x4.js";
 import"../../shared/@ai-setting/roy-agent-core-4rtg69cn.js";
-import"../../shared/@ai-setting/roy-agent-core-v3wm8gyj.js";
-import"../../shared/@ai-setting/roy-agent-core-0yzxapfa.js";
+import"../../shared/@ai-setting/roy-agent-core-h3j1z13p.js";
+import"../../shared/@ai-setting/roy-agent-core-ddp3n8cb.js";
 import"../../shared/@ai-setting/roy-agent-core-418zc9ha.js";
 import"../../shared/@ai-setting/roy-agent-core-pxqz1d1m.js";
 import"../../shared/@ai-setting/roy-agent-core-bwyc2j0n.js";

package/dist/env/event-source/index.js

@@ -1,7 +1,7 @@
 import"../../shared/@ai-setting/roy-agent-core-m1fgtnrc.js";
 import {
   EventSourceComponent
-} from "../../shared/@ai-setting/roy-agent-core-mp7sqfb5.js";
+} from "../../shared/@ai-setting/roy-agent-core-83n2nvdp.js";
 import {
   BountyIMInstance,
   COMMAND_PREFIX,
@@ -56,7 +56,7 @@ import {
   translateCardActionToCommand,
   wecomCliHandler,
   writeFallbackModelList
-} from "../../shared/@ai-setting/roy-agent-core-33n84tf9.js";
+} from "../../shared/@ai-setting/roy-agent-core-6bga36qk.js";
 import {
   BUILT_IN_EVENT_SOURCE_TYPES,
   BUILT_IN_EVENT_SOURCE_TYPE_LIST,
@@ -76,7 +76,7 @@ import {
 import"../../shared/@ai-setting/roy-agent-core-mgmp2gfm.js";
 import"../../shared/@ai-setting/roy-agent-core-kfspjx59.js";
 import"../../shared/@ai-setting/roy-agent-core-2stt4rp5.js";
-import"../../shared/@ai-setting/roy-agent-core-px73ewzd.js";
+import"../../shared/@ai-setting/roy-agent-core-57q8a049.js";
 import"../../shared/@ai-setting/roy-agent-core-th8fq714.js";
 import"../../shared/@ai-setting/roy-agent-core-c4ec7k0p.js";
 import {
@@ -90,8 +90,8 @@ import"../../shared/@ai-setting/roy-agent-core-1pg0fepg.js";
 import"../../shared/@ai-setting/roy-agent-core-msktt7y7.js";
 import"../../shared/@ai-setting/roy-agent-core-m46fe3x4.js";
 import"../../shared/@ai-setting/roy-agent-core-4rtg69cn.js";
-import"../../shared/@ai-setting/roy-agent-core-v3wm8gyj.js";
-import"../../shared/@ai-setting/roy-agent-core-0yzxapfa.js";
+import"../../shared/@ai-setting/roy-agent-core-h3j1z13p.js";
+import"../../shared/@ai-setting/roy-agent-core-ddp3n8cb.js";
 import"../../shared/@ai-setting/roy-agent-core-418zc9ha.js";
 import"../../shared/@ai-setting/roy-agent-core-pxqz1d1m.js";
 import"../../shared/@ai-setting/roy-agent-core-bwyc2j0n.js";

package/dist/env/index.js

@@ -1,9 +1,9 @@
 import {
   BaseEnvironment
-} from "../shared/@ai-setting/roy-agent-core-vz886vr8.js";
+} from "../shared/@ai-setting/roy-agent-core-pc2z7kwy.js";
 import {
   TaskComponent
-} from "../shared/@ai-setting/roy-agent-core-aeh7qg1r.js";
+} from "../shared/@ai-setting/roy-agent-core-vw4gv5am.js";
 import"../shared/@ai-setting/roy-agent-core-jzmk4kdh.js";
 import"../shared/@ai-setting/roy-agent-core-jm136jzh.js";
 import"../shared/@ai-setting/roy-agent-core-m4x47ne9.js";
@@ -15,11 +15,11 @@ import"../shared/@ai-setting/roy-agent-core-bcv09vrt.js";
 import"../shared/@ai-setting/roy-agent-core-p5cz9m8v.js";
 import {
   EventSourceComponent
-} from "../shared/@ai-setting/roy-agent-core-mp7sqfb5.js";
+} from "../shared/@ai-setting/roy-agent-core-83n2nvdp.js";
 import {
   builtInHandlers,
   larkCliHandler
-} from "../shared/@ai-setting/roy-agent-core-33n84tf9.js";
+} from "../shared/@ai-setting/roy-agent-core-6bga36qk.js";
 import {
   EventSourceInitHooks,
   getDefaultConfigForType,
@@ -31,7 +31,7 @@ import"../shared/@ai-setting/roy-agent-core-64py47c3.js";
 import"../shared/@ai-setting/roy-agent-core-mgmp2gfm.js";
 import"../shared/@ai-setting/roy-agent-core-kfspjx59.js";
 import"../shared/@ai-setting/roy-agent-core-2stt4rp5.js";
-import"../shared/@ai-setting/roy-agent-core-px73ewzd.js";
+import"../shared/@ai-setting/roy-agent-core-57q8a049.js";
 import"../shared/@ai-setting/roy-agent-core-th8fq714.js";
 import"../shared/@ai-setting/roy-agent-core-c4ec7k0p.js";
 import"../shared/@ai-setting/roy-agent-core-brw8wp2q.js";
@@ -40,8 +40,8 @@ import"../shared/@ai-setting/roy-agent-core-1pg0fepg.js";
 import"../shared/@ai-setting/roy-agent-core-msktt7y7.js";
 import"../shared/@ai-setting/roy-agent-core-m46fe3x4.js";
 import"../shared/@ai-setting/roy-agent-core-4rtg69cn.js";
-import"../shared/@ai-setting/roy-agent-core-v3wm8gyj.js";
-import"../shared/@ai-setting/roy-agent-core-0yzxapfa.js";
+import"../shared/@ai-setting/roy-agent-core-h3j1z13p.js";
+import"../shared/@ai-setting/roy-agent-core-ddp3n8cb.js";
 import"../shared/@ai-setting/roy-agent-core-418zc9ha.js";
 import"../shared/@ai-setting/roy-agent-core-pxqz1d1m.js";
 import {

package/dist/env/task/index.js

@@ -5,7 +5,7 @@ import {
   TaskPriorityEnum,
   TaskStatusEnum,
   TaskTypeEnum
-} from "../../shared/@ai-setting/roy-agent-core-aeh7qg1r.js";
+} from "../../shared/@ai-setting/roy-agent-core-vw4gv5am.js";
 import"../../shared/@ai-setting/roy-agent-core-jzmk4kdh.js";
 import"../../shared/@ai-setting/roy-agent-core-jm136jzh.js";
 import"../../shared/@ai-setting/roy-agent-core-m4x47ne9.js";

package/dist/env/task/plugins/index.js

@@ -30,7 +30,7 @@ import {
   parseExtractorOutput,
   registerLayaCompletionTaskHook,
   renderCompletionState
-} from "../../../shared/@ai-setting/roy-agent-core-px73ewzd.js";
+} from "../../../shared/@ai-setting/roy-agent-core-57q8a049.js";
 import"../../../shared/@ai-setting/roy-agent-core-th8fq714.js";
 import"../../../shared/@ai-setting/roy-agent-core-c4ec7k0p.js";
 import"../../../shared/@ai-setting/roy-agent-core-brw8wp2q.js";
@@ -66,7 +66,7 @@ import {
   renderWorkflowInfoLines,
   resolveTaskTitleForDisplay,
   sanitizeInlineText
-} from "../../../shared/@ai-setting/roy-agent-core-0yzxapfa.js";
+} from "../../../shared/@ai-setting/roy-agent-core-ddp3n8cb.js";
 import"../../../shared/@ai-setting/roy-agent-core-418zc9ha.js";
 import"../../../shared/@ai-setting/roy-agent-core-pxqz1d1m.js";
 import"../../../shared/@ai-setting/roy-agent-core-ecap4nws.js";

package/dist/env/task/plugins/lark-card-action-handler.d.ts

@@ -13,7 +13,7 @@
  *   - 不依赖具体 bot 身份 / profile（由 caller 注入）
  *   - 失败必须明确返回 ok=false，不静默成功
  */
-import { buildTaskCard, DEFAULT_APP_LINK_BASE, type LarkCardPatchNotifier } from "./lark-card-patch-notifier";
+import { buildTaskCard, DEFAULT_APP_LINK_BASE, type LarkCardPatchNotifier, type Milestone, type SessionCardTaskSummary } from "./lark-card-patch-notifier";
 import { type ActivityMessage, type ToolCallView, type ActivityProbeResult } from "./sub-session-activity";
 /** 卡片按钮点击事件的关键字段（精简版，caller 从 event 里挑出） */
 export interface CardActionEvent {
@@ -55,8 +55,8 @@ export interface CardActionEvent {
     /** lark-cli profile */
     profile?: string;
 }
-/** 卡片动作名（★ Task #5360：加 `refresh_activity`） */
-export type CardActionName = "create_group" | "disband_group" | "refresh_activity";
+/** 卡片动作名（★ Task #5360：加 `refresh_activity`；★ Task #5580：加 `select_task`） */
+export type CardActionName = "create_group" | "disband_group" | "refresh_activity" | "select_task";
 /**
  * 运行时判定一个字符串是否是本 handler 认识的 action。
  *
@@ -91,6 +91,13 @@ export type CardActionValidation = {
     ok: true;
     action: "refresh_activity";
     sessionId: string;
+}
+/** ★ Task #5580：切任务需要 sessionId（卡片主键）+ taskId（切到哪个任务） */
+ | {
+    ok: true;
+    action: "select_task";
+    sessionId: string;
+    taskId: number;
 } | {
     ok: false;
     action: string;
@@ -131,6 +138,34 @@ export type SessionCardRefreshHandler = (opts: {
     cardUpdate?: ReturnType<typeof buildTaskCard>;
     error?: string;
 }>;
+/**
+ * ★ Task #5580（CV P6 配套）：`loadSessionTasks` 的**带总数**返回形态。
+ *
+ * ## 为什么需要
+ *
+ * 端口为了压掉 N+1 查询，详情只取**前 N 个**（默认 20）；但卡片要写
+ * 「共 12 个任务」，数字必须来自**真实总数**，不能退化成「共 20 个」。
+ *
+ * 兼容：端口也可以直接返回数组（老形态）—— 那时总数按数组长度计。
+ */
+export interface SessionCardTaskListResult {
+    tasks: SessionCardTaskSummaryPortItem[];
+    /** 该 session 关联的**全部** task 数量（可大于 tasks.length） */
+    total?: number;
+}
+/**
+ * ★ Task #5580：`loadSessionTasks` 端口的条目形状（= 渲染层摘要 + 可选详情字段）。
+ *
+ * 端口实现可以直接返回 `Task` 实体（多字段无害），渲染层只取它认识的。
+ */
+export type SessionCardTaskSummaryPortItem = SessionCardTaskSummary & {
+    currentStatus?: string;
+    priority?: string;
+    parentTaskId?: number;
+    goals?: string;
+    createdAt?: string;
+    updatedAt?: string;
+};
 /** 端口注入（caller 提供 IO 能力，本模块保持纯函数） */
 export interface CardActionPorts {
     /** 读取 task（用于读 context）★ #5581：session_id 可选透传（MCP 路径按钮主键） */
@@ -222,6 +257,26 @@ export interface CardActionPorts {
      * 返回 [] ⇒ 面板照出 + 「暂无消息」（诚实）。
      */
     loadSessionMessages?: (sessionId: string, limit?: number) => Promise<ActivityMessage[] | ToolCallView[] | undefined> | ActivityMessage[] | ToolCallView[] | undefined;
+    /**
+     * ★ Task #5580：读该 session 内的**全部 task**（最近优先，最多若干条）。
+     *
+     * 用途：session 卡的「🗂️ 任务列表」面板（一个 session 复用多次时会有多个
+     * task 生命周期，只显示单 task 不够）。
+     *
+     * 装配点实现：`taskComponent.getTaskIdsBySessionId(sessionId)` + 逐个 `getTask`。
+     *
+     * 不注入 / 抛错 ⇒ 不渲染任务列表面板（降级不抛，与其它端口同一套
+     * best-effort 语义）；返回 [] ⇒ 面板不渲染（没有任务 = 没有这个面板）。
+     */
+    loadSessionTasks?: (sessionId: string) => Promise<SessionCardTaskListResult | SessionCardTaskSummaryPortItem[] | undefined> | SessionCardTaskListResult | SessionCardTaskSummaryPortItem[] | undefined;
+    /**
+     * ★ Task #5580：读某个 task 的里程碑（task_operation 的 milestone 形态）。
+     *
+     * 用途：点 `select_task` 后渲染「📌 任务里程碑」区。
+     *
+     * 不注入 / 抛错 ⇒ 里程碑区显示「（该任务暂无里程碑）」，绝不阻断整卡 patch。
+     */
+    loadTaskMilestones?: (taskId: number) => Promise<Milestone[] | undefined> | Milestone[] | undefined;
     /**
      * ★ Task #5403：建群成功后初始化「群 session」—— **关联建群**。
      *

package/dist/env/task/plugins/lark-card-patch-notifier.d.ts

@@ -551,6 +551,28 @@ export declare function renderMilestones(milestones: Milestone[]): string;
  * 样式：`- **HH:mm:ss → 现在** <title>` + 可选缩进说明行
  */
 export declare function renderProcessSteps(steps: ProcessStep[]): string;
+/**
+ * ★ Task #5580 —— session 卡「任务列表」最多展示几个（用户定稿：最近 5 个）。
+ *
+ * 用户需求（2026-11-13）：一个 sub session 会被复用跑很多 task，卡片要能
+ * 「罗列最近 5 个 + 展示任务总数」，再多就靠总数提示（不刷屏）。
+ */
+export declare const SESSION_TASK_LIST_MAX = 5;
+/**
+ * ★ Task #5580 —— 渲染 session 卡「任务列表」面板内容。
+ *
+ * ## 规则（用户定稿）
+ * - `tasks` 按**最近优先**传入（新 → 旧），渲染层取前 `SESSION_TASK_LIST_MAX` 个
+ *   —— 「最近 5 个」是渲染契约，调用方不必自己截断（少一处漂移点）。
+ * - 超过 5 个 → 标题/首行给总数提示「共 N 个任务，最近 5 个：」
+ * - 每个条目一个 `select_task` 按钮（点击 → 执行动态 / 任务里程碑切到该任务）
+ *
+ * @returns `{ title, elements }`，由调用方包进 collapsible_panel（`session_task_list`）
+ */
+export declare function renderSessionTaskList(sessionId: string, tasks: SessionCardTaskSummary[], taskTotal?: number): {
+    title: string;
+    elements: Array<Record<string, any>>;
+};
 /**
  * ★ Task #4889 —— 按语义来源把过程步骤分成两组。
  *
@@ -660,6 +682,17 @@ export interface SessionCardState {
     activity?: SubSessionActivity | null;
     /** ★ Task #5420：上次的最近消息列表（patch 未传时沿用，避免擦面板） */
     recentMessages?: ActivityMessage[] | ToolCallView[];
+    /**
+     * ★ Task #5580：该 session 的全部 task 摘要（「🗂️ 任务列表」面板）。
+     * 与 task / recentMessages 同语义：本次没传就沿用上一次（不擦面板）。
+     */
+    sessionTasks?: SessionCardTaskSummary[];
+    /** ★ Task #5580：任务总数（tasks 被截断到 5 时用于「共 N 个任务」提示） */
+    taskTotal?: number;
+    /** ★ Task #5580：「📌 任务里程碑」区展示的是哪个任务 */
+    selectedTask?: NonNullable<Parameters<typeof buildSessionCard>[0]["selectedTask"]>;
+    /** ★ Task #5580：选中任务的里程碑 list */
+    selectedTaskMilestones?: Milestone[];
     /**
      * ★ Task #5364 返工（BLOCKER-5）：该 session 内创建的 roy 任务（**可选增强**）。
      *
@@ -715,6 +748,41 @@ export declare function buildSessionCard(opts: {
         createdAt?: string;
         updatedAt?: string;
     };
+    /**
+     * ★ Task #5580：该 session 内**全部 task** 的摘要 list（最近优先）。
+     *
+     * 渲染规则（用户 2026-11-13 定稿）：
+     * - ≤5 个 → 直接罗列
+     * - >5 个 → 只罗列**最近 5 个** + 总数提示（「共 N 个任务，最近 5 个：」）
+     * - 每条带 `select_task` 按钮（点击 → 执行动态切换到该任务）
+     * - undefined → 不渲染面板（零噪音，与 task 区块同语义）
+     */
+    tasks?: SessionCardTaskSummary[];
+    /** ★ Task #5580：任务总数（tasks 被截断到 5 时用于「共 N 个任务」提示） */
+    taskTotal?: number;
+    /**
+     * ★ Task #5580：当前**选中**的任务（点 select_task 后切换到这里）。
+     * undefined → 不渲染「任务里程碑」面板。
+     *
+     * ★ CV P3（已记录取舍）：**没有 null 清除路径** —— 选中态的生命周期绑定
+     *   在任务存续上，任务删除/归档后由刷新把它从 `tasks` 列表里剔除（此时
+     *   `selectedTask` 不再出现在任务列表里，用户自然会点别的任务）。
+     *   若将来需要"取消选中"，把类型扩成 `| null` 并在 rememberSessionCard
+     *   区分 `undefined`（沿用）/ `null`（清除）即可。
+     */
+    selectedTask?: SessionCardTaskSummary & {
+        currentStatus?: string;
+        priority?: string;
+        parentTaskId?: number;
+        goals?: string;
+        createdAt?: string;
+        updatedAt?: string;
+    };
+    /**
+     * ★ Task #5580：选中任务的里程碑 list（task_operation 的 milestone），
+     * 渲染进「任务里程碑」面板，随 select_task 切换。
+     */
+    selectedTaskMilestones?: Milestone[];
     /** 所属 agent（subagentType），可选 */
     agentType?: string;
     /** 开始时间（ISO） */
@@ -1028,6 +1096,15 @@ export declare class LarkCardPatchNotifier {
         activity?: SubSessionActivity | null;
         /** ★ Task #5364 返工：该 session 内的任务信息（渲染进**同一张** session 卡） */
         task?: Parameters<typeof buildSessionCard>[0]["task"];
+        /** ★ Task #5580：该 session 内全部 task 的摘要列表（「🗂️ 任务列表」面板） */
+        tasks?: SessionCardTaskSummary[];
+        /**
+         * ★ Task #5420：最近消息列表（「💬 会话查看」面板）。
+         *
+         * 补声明：方法体内一直读 `opts.recentMessages`（carry-forward 逻辑），
+         * 但 opts 类型漏了这一项 ⇒ tsc 长期报 TS2339（存量缺陷，本次顺手修掉）。
+         */
+        recentMessages?: ActivityMessage[] | ToolCallView[];
         perTaskChatId?: string;
         perTaskChatName?: string;
     }): Promise<boolean>;
@@ -1049,6 +1126,28 @@ export declare class LarkCardPatchNotifier {
     private findSessionCardBySessionId;
     /** 这个 messageId 是否属于一张 **session 卡**（★ Task #5384 守卫入口）。 */
     isSessionCardMessage(messageId: string): boolean;
+    /**
+     * ★ Task #5602：这个 messageId 是否属于一张 **task 卡**。
+     *
+     * ## 为什么需要
+     *
+     * task 卡上的「💬 会话查看」按钮（action=refresh_activity）走
+     * session 主键路径；`buildSessionCardWithActivity` 只查
+     * `sessionStates` ⇒ task 卡查不到 ⇒ fallback `buildSessionCard`
+     * 整卡重建 ⇒ **task 卡被 session 渲染器覆盖**（用户实测：
+     * 「📋 任务卡」点一下变成「💬 会话卡」）。
+     *
+     * handler 据此把 refresh_activity 委托回 task 路径
+     * （`handleRefreshActivity`，保持 task 卡身份渲染）。
+     *
+     * ## 判定来源（两处，覆盖两个生命周期）
+     *
+     * - 运行中：`states`（`startTask` / `hydrateState` 写入）
+     * - 终态后：`finalisedCards`（`finishTask` 会 `states.delete`，
+     *   但卡还在飞书里，用户仍可点按钮 —— #5020 终态守卫的集合
+     *   恰好就是「曾是 task 卡」的权威记录）
+     */
+    isTaskCardMessage(messageId: string): boolean;
     /**
      * ★ Task #5384：把 **task 侧的更新**应用进 session 卡，返回可 patch 的卡片。
      *
@@ -1162,6 +1261,8 @@ export declare class LarkCardPatchNotifier {
         activity?: SubSessionActivity | null;
         /** ★ Task #5364 返工（BLOCKER-5）：session 内的任务信息（合并渲染） */
         task?: Parameters<typeof buildSessionCard>[0]["task"];
+        /** ★ Task #5580：该 session 内全部 task 的摘要列表（「🗂️ 任务列表」面板） */
+        tasks?: SessionCardTaskSummary[];
         perTaskChatId?: string;
         perTaskChatName?: string;
     }): Promise<{
@@ -1204,6 +1305,8 @@ export declare class LarkCardPatchNotifier {
          * 用户 08:13 定稿：**一张 session 卡**，task 信息是卡上的区块。
          */
         task?: Parameters<typeof buildSessionCard>[0]["task"];
+        /** ★ Task #5580：该 session 内全部 task 的摘要列表（首卡就带上） */
+        tasks?: SessionCardTaskSummary[];
         perTaskChatId?: string;
         perTaskChatName?: string;
     }): Promise<StartTaskResult>;
@@ -1228,6 +1331,15 @@ export declare class LarkCardPatchNotifier {
          * undefined = 本次没查（沿用 state 里的上次值，与 activity 同语义）。
          */
         recentMessages?: ActivityMessage[] | ToolCallView[];
+        /**
+         * ★ Task #5580：该 session 的全部 task 摘要（「🗂️ 任务列表」面板）。
+         * undefined = 本次没查（沿用 state）；[] = 查了确实没有（不渲染面板）。
+         */
+        sessionTasks?: SessionCardTaskSummary[];
+        /** ★ Task #5580：当前选中的任务（点 select_task 后的焦点） */
+        selectedTask?: Parameters<typeof buildSessionCard>[0]["selectedTask"];
+        /** ★ Task #5580：选中任务的里程碑（「📌 任务里程碑」区） */
+        selectedTaskMilestones?: Milestone[];
     }): CardPayload | undefined;
     /**
      * ★ 补充需求（22:31）—— 记录 session 卡的累计状态（供 refresh 重建）。
@@ -1252,6 +1364,11 @@ export declare class LarkCardPatchNotifier {
         activity?: SubSessionActivity | null;
         /** ★ Task #5420：上次的最近消息列表 */
         recentMessages?: ActivityMessage[] | ToolCallView[];
+        /** ★ Task #5580：session 内的任务列表 / 总数 / 选中任务 / 里程碑 */
+        sessionTasks?: SessionCardTaskSummary[];
+        taskTotal?: number;
+        selectedTask?: NonNullable<Parameters<typeof buildSessionCard>[0]["selectedTask"]>;
+        selectedTaskMilestones?: Milestone[];
         /** ★ Task #5364 返工：任务区块 + 专属群（合并渲染） */
         task?: NonNullable<Parameters<typeof buildSessionCard>[0]["task"]>;
         perTaskChatId?: string;
@@ -1415,6 +1532,19 @@ export declare class LarkCardPatchNotifier {
  * - 单测要隔离：显式传 `cardNotifier` 构造参数（既有 55 条测试都这么做），
  *   或者调用 {@link __resetSharedLarkCardNotifierForTest}
  */
+/**
+ * ★ Task #5580：session 卡任务列表的**单条摘要**（渲染层最小字段集）。
+ *
+ * 与 `SessionCardTaskPayload`（单 task 详情区块）的区别：
+ * 列表条目只需要「点得动、认得出」—— id / 标题 / 状态 / 进度，
+ * 不搬 goals / parentTaskId / createdAt 等重字段（点进详情再看）。
+ */
+export interface SessionCardTaskSummary {
+    id: number;
+    title?: string;
+    status?: string;
+    progress?: number;
+}
 /**
  * ★ Task #5364 返工：session 卡上「任务信息」区块的渲染载荷类型。
  *

package/dist/env/task/plugins/lark-card-patch-notifier.js

@@ -2,6 +2,7 @@ import {
   DEFAULT_APP_LINK_BASE,
   HEAD_TITLE_MAX_WIDTH,
   LarkCardPatchNotifier,
+  SESSION_TASK_LIST_MAX,
   __resetSharedLarkCardNotifierForTest,
   buildChatAppLink,
   buildCollapsiblePanel,
@@ -21,12 +22,13 @@ import {
   renderMilestones,
   renderProcessSteps,
   renderProgressBar,
+  renderSessionTaskList,
   renderTaskInfoLines,
   renderWorkflowInfoLines,
   resolveTaskTitleForDisplay,
   sanitizeInlineText,
   truncateHeadTitle
-} from "../../../shared/@ai-setting/roy-agent-core-0yzxapfa.js";
+} from "../../../shared/@ai-setting/roy-agent-core-ddp3n8cb.js";
 import"../../../shared/@ai-setting/roy-agent-core-418zc9ha.js";
 import"../../../shared/@ai-setting/roy-agent-core-pxqz1d1m.js";
 import"../../../shared/@ai-setting/roy-agent-core-yshw2fvj.js";
@@ -39,6 +41,7 @@ export {
   resolveTaskTitleForDisplay,
   renderWorkflowInfoLines,
   renderTaskInfoLines,
+  renderSessionTaskList,
   renderProgressBar,
   renderProcessSteps,
   renderMilestones,
@@ -58,6 +61,7 @@ export {
   buildCollapsiblePanel,
   buildChatAppLink,
   __resetSharedLarkCardNotifierForTest,
+  SESSION_TASK_LIST_MAX,
   LarkCardPatchNotifier,
   HEAD_TITLE_MAX_WIDTH,
   DEFAULT_APP_LINK_BASE

package/dist/env/task/plugins/lark-card-state-store.d.ts

@@ -147,6 +147,14 @@ export declare function createLarkCardStateStore(dbPath?: string): LarkCardState
 export declare function getSharedLarkCardStateStore(): LarkCardStateStore;
 /** 测试钩子：丢弃单例（避免用例间串味 / 连到真实库）。 */
 export declare function __resetSharedLarkCardStateStoreForTest(): void;
+/**
+ * 测试钩子：注入指定 store 为共享单例（Task #5608）。
+ *
+ * 守卫的持久层兜底读 `getSharedLarkCardStateStore()`，
+ * 测试需要一个可控的库而不连真实 `~/.local/share/roy-agent/`。
+ * 传 `undefined` 等价 reset。
+ */
+export declare function __setSharedLarkCardStateStoreForTest(store: LarkCardStateStore | undefined): void;
 /**
  * 为什么需要独立表（不能塞进 `lark_card`）
  *

package/dist/env/task/plugins/lark-cli-task-notify-plugin.d.ts

@@ -91,6 +91,63 @@ export interface TaskNotifyConfig {
      *   老卡片再也无法 patch（永远停在"进行中"）+ pin 一直挂着。
      */
     cardStateStore?: LarkCardStateStore;
+    /**
+     * ★ Task #5580：是否在 session 卡之外**再发一张任务卡片**（默认 true）。
+     *
+     * ## 背景（用户 2026-11-13 定稿）
+     *
+     * 「之前的任务卡片功能必须保留：lark-cli ES 插件中根据 task hook 触发的
+     *   任务卡片消息也要发出来并 pin 住。不能只有 session 卡片——两者并存：
+     *   任务卡片（用户关心任务级别）+ session 卡片（调试用，功能以后削弱）」
+     *
+     * 这**反转**了 #5364 的「单卡语义」（当时定稿：一个 session 只发一张卡，
+     * task 信息作为卡上区块）。现在两者并存：
+     * - session 卡：会话视角（任务列表 / 执行动态 / 活性）—— 调试用，后续削弱
+     * - task 卡：任务视角（进度 / 里程碑 / 建群）—— 用户主关注
+     *
+     * 设 `false` 可退回 #5364 的单卡语义（软回滚开关）。
+     */
+    emitTaskCard?: boolean;
+    /**
+     * ★ Task #5580：config.jsonc 开关读取端口（生产装配注入）。
+     * 不传 ⇒ 退回 `emitTaskCard` 代码级默认 / true。
+     */
+    cardNotifyConfigReader?: () => LarkCardNotifyFlags;
+}
+/**
+ * ★ Task #5580（2026-11-15 补充）：config.jsonc 可配的卡片开关。
+ *
+ * ## 配置键（config.jsonc）
+ *
+ * ```jsonc
+ * {
+ *   "task": {
+ *     "plugins": {
+ *       "larkCard": {
+ *         // task hook 触发的任务卡片（用户主关注，pin）
+ *         "emitTaskCard": true,
+ *         // sub-session 生命周期触发的 session 卡片（调试用）
+ *         "emitSessionCard": true
+ *       }
+ *     }
+ *   }
+ * }
+ * ```
+ *
+ * ## 生效方式（热更新）
+ *
+ * config.jsonc 是 task 组件的 file source（watch 开启）⇒
+ * **改文件即生效，无需重启 ES**。开关在每次 hook 执行 / 每次
+ * session 生命周期事件时**现读**（不是构造时缓存）。
+ *
+ * ## 优先级
+ *
+ * 显式传给 hook 的 `config.emitTaskCard`（代码级）优先于
+ * config.jsonc（文件级）—— 便于单测与特殊部署覆盖。
+ */
+export interface LarkCardNotifyFlags {
+    emitTaskCard: boolean;
+    emitSessionCard: boolean;
 }
 /**
  * 卡片路由端口（Task #4230 follow-up）
@@ -118,6 +175,14 @@ export declare class LarkCliTaskNotifyHook implements Hook {
     readonly pluginName?: string;
     readonly sourceId?: string;
     private readonly config;
+    /**
+     * ★ Task #5580：config.jsonc 开关的读取端口（可选注入）。
+     *
+     * 生产装配点（task-component）注入 `taskComponent.getCardNotifyConfig`；
+     * 不注入（单测 / 未接线）⇒ 退回 `config.emitTaskCard` 代码级默认。
+     * 每次 hook 执行时现读 ⇒ config.jsonc 热更新即时生效。
+     */
+    cardNotifyConfigReader?: () => LarkCardNotifyFlags;
     /** 卡片模式 notifier 实例 */
     private cardNotifier?;
     /**
@@ -185,6 +250,16 @@ export declare class LarkCliTaskNotifyHook implements Hook {
     setCardRoutingPorts(ports: CardRoutingPorts): void;
     /** 诊断：端口是否注入 */
     hasCardRoutingPorts(): boolean;
+    /**
+     * ★ Task #5580：emitTaskCard 的**现读**语义。
+     *
+     * 优先级：显式 config.emitTaskCard（代码级）> config.jsonc
+     * （文件级，经 cardNotifyConfigReader）> 默认 true。
+     *
+     * 为什么不用构造时缓存：config.jsonc 是 file source（watch 开），
+     * 用户改文件应即时生效 —— 每次执行现读。
+     */
+    private currentEmitTaskCard;
     execute(ctx: HookContext<unknown>): Promise<void>;
     /** 任务创建：发初始卡片（+ pin） */
     private onAfterCreate;

package/dist/env/task/task-component.d.ts

@@ -87,6 +87,31 @@ export declare class TaskComponent extends BaseComponent {
      * or has been disposed.
      */
     getBackgroundTaskManager(): BackgroundTaskManager | undefined;
+    /**
+     * ★ Task #5580（2026-11-15 补充）—— lark 卡片开关（config.jsonc 可配）。
+     *
+     * ## 配置键（沿用 task 组件点号惯例）
+     *
+     * - `task.plugins.larkCard.emitTaskCard`（默认 true）
+     *   —— task hook 触发的**任务卡片**（用户主关注，pin）
+     * - `task.plugins.larkCard.emitSessionCard`（默认 true）
+     *   —— sub-session 生命周期触发的 **session 卡片**（调试用）
+     *
+     * ## 生效方式
+     *
+     * config.jsonc 是 task 组件的 file source（watch 开启）⇒
+     * 改文件即热更新，**无需重启 ES**。每次 hook 执行时现读
+     * （`LarkCliTaskNotifyHook` 在 execute 内调用本方法）。
+     *
+     * ## 降级
+     *
+     * configComponent 缺失 / 键未配置 / 值不是 boolean ⇒ 默认 true
+     * （与改造前行为一致：两卡并存）。
+     */
+    getCardNotifyConfig(): {
+        emitTaskCard: boolean;
+        emitSessionCard: boolean;
+    };
     /**
      * 发布 EnvEvent
      */

package/dist/env/workflow/plugins/index.js

@@ -1,8 +1,8 @@
 import {
   LarkCliWorkflowNotifyHook,
   createLarkCliWorkflowNotifyHook
-} from "../../../shared/@ai-setting/roy-agent-core-v3wm8gyj.js";
-import"../../../shared/@ai-setting/roy-agent-core-0yzxapfa.js";
+} from "../../../shared/@ai-setting/roy-agent-core-h3j1z13p.js";
+import"../../../shared/@ai-setting/roy-agent-core-ddp3n8cb.js";
 import"../../../shared/@ai-setting/roy-agent-core-418zc9ha.js";
 import"../../../shared/@ai-setting/roy-agent-core-pxqz1d1m.js";
 import"../../../shared/@ai-setting/roy-agent-core-5e9vmj5e.js";