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

package/dist/env/task/index.js

@@ -5,25 +5,21 @@ import {
   TaskPriorityEnum,
   TaskStatusEnum,
   TaskTypeEnum
-} from "../../shared/@ai-setting/roy-agent-core-rhtdspx6.js";
+} from "../../shared/@ai-setting/roy-agent-core-fan8g0z1.js";
 import"../../shared/@ai-setting/roy-agent-core-2akfd64z.js";
 import"../../shared/@ai-setting/roy-agent-core-jm136jzh.js";
-import"../../shared/@ai-setting/roy-agent-core-aa2j7bk9.js";
+import"../../shared/@ai-setting/roy-agent-core-0sbmdz8d.js";
 import"../../shared/@ai-setting/roy-agent-core-fttgm52a.js";
-import"../../shared/@ai-setting/roy-agent-core-q813vafd.js";
+import"../../shared/@ai-setting/roy-agent-core-vpcxv1ty.js";
 import {
   TaskEntityEventTypes
 } from "../../shared/@ai-setting/roy-agent-core-8gxth0eh.js";
-import"../../shared/@ai-setting/roy-agent-core-vffccgf6.js";
+import"../../shared/@ai-setting/roy-agent-core-qwd2dq5q.js";
 import"../../shared/@ai-setting/roy-agent-core-p5cz9m8v.js";
-import"../../shared/@ai-setting/roy-agent-core-na18zwj0.js";
-import"../../shared/@ai-setting/roy-agent-core-9vxh6f8h.js";
-import {
-  SQLiteTaskStore,
-  getDefaultTaskDbPath
-} from "../../shared/@ai-setting/roy-agent-core-ezvpreqz.js";
+import"../../shared/@ai-setting/roy-agent-core-4t3yskp8.js";
+import"../../shared/@ai-setting/roy-agent-core-y7fqtzk2.js";
 import"../../shared/@ai-setting/roy-agent-core-1pg0fepg.js";
-import"../../shared/@ai-setting/roy-agent-core-tr3ep81v.js";
+import"../../shared/@ai-setting/roy-agent-core-d6zdbgtc.js";
 import"../../shared/@ai-setting/roy-agent-core-m46fe3x4.js";
 import {
   TASK_ARCHIVED_STATUS_WORD,
@@ -31,16 +27,20 @@ import {
   TASK_COMPLETED_STATUS_WORD,
   TASK_DELIVERABLE_RECORDED
 } from "../../shared/@ai-setting/roy-agent-core-4rtg69cn.js";
-import"../../shared/@ai-setting/roy-agent-core-ed233k5z.js";
+import {
+  SQLiteTaskStore,
+  getDefaultTaskDbPath
+} from "../../shared/@ai-setting/roy-agent-core-6k8mb7zx.js";
+import"../../shared/@ai-setting/roy-agent-core-v1n0106v.js";
 import"../../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
 import"../../shared/@ai-setting/roy-agent-core-c1v263jn.js";
 import"../../shared/@ai-setting/roy-agent-core-7hh0brvs.js";
-import"../../shared/@ai-setting/roy-agent-core-pgvcf91v.js";
-import"../../shared/@ai-setting/roy-agent-core-ax9e9szb.js";
-import"../../shared/@ai-setting/roy-agent-core-cpcd24n2.js";
-import"../../shared/@ai-setting/roy-agent-core-qqaak24r.js";
-import"../../shared/@ai-setting/roy-agent-core-7cbpmk4q.js";
-import"../../shared/@ai-setting/roy-agent-core-qq96p0tj.js";
+import"../../shared/@ai-setting/roy-agent-core-m39v7qpx.js";
+import"../../shared/@ai-setting/roy-agent-core-smf94h73.js";
+import"../../shared/@ai-setting/roy-agent-core-yet36q5k.js";
+import"../../shared/@ai-setting/roy-agent-core-tkpp1ba0.js";
+import"../../shared/@ai-setting/roy-agent-core-p31ftgq9.js";
+import"../../shared/@ai-setting/roy-agent-core-5s2t8z00.js";
 import"../../shared/@ai-setting/roy-agent-core-7f7t9wwp.js";
 import"../../shared/@ai-setting/roy-agent-core-85xyctnb.js";
 import"../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";

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

@@ -7,16 +7,16 @@ import {
   searchTasksTool,
   treeTasksTool,
   updateTaskTool
-} from "../../../shared/@ai-setting/roy-agent-core-vffccgf6.js";
+} from "../../../shared/@ai-setting/roy-agent-core-qwd2dq5q.js";
 import {
   createOperationTool,
   listOperationsTool
 } from "../../../shared/@ai-setting/roy-agent-core-p5cz9m8v.js";
-import"../../../shared/@ai-setting/roy-agent-core-tr3ep81v.js";
+import"../../../shared/@ai-setting/roy-agent-core-d6zdbgtc.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-7cbpmk4q.js";
-import"../../../shared/@ai-setting/roy-agent-core-qq96p0tj.js";
+import"../../../shared/@ai-setting/roy-agent-core-p31ftgq9.js";
+import"../../../shared/@ai-setting/roy-agent-core-5s2t8z00.js";
 import"../../../shared/@ai-setting/roy-agent-core-7f7t9wwp.js";
 import"../../../shared/@ai-setting/roy-agent-core-85xyctnb.js";
 import"../../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";

package/dist/env/task/plugins/card-subject.d.ts

@@ -0,0 +1,117 @@
+/**
+ * @fileoverview Task #5360（用户澄清 2026-11-11 22:37）——
+ *   卡片实体：**sub-session 永远是主键**，task 是可选的**附加增强信息**
+ *
+ * ## 用户澄清原文（覆盖了此前「task-or-session 二选一」的理解）
+ *
+ * > 「**不是**「task 或 sub-session」二选一，而是**以 sub-session 为基底**：
+ * >  1. 卡片主键 = sub-session（不是 task）
+ * >  2. 有些 sub-session 内部创建了 task，有些没有 —— 都是正常的
+ * >  3. 如果该 sub-session 创建了 task → 把 task 信息同步进卡片
+ * >     （taskId、title、状态、进度、操作记录等原有信息一个不少）
+ * >  4. **无论有无 task，sub-session 相关的刷新逻辑始终存在**：
+ * >     刷新看消息数 + 最近 msg（截断）；
+ * >     **超时、完成等生命周期事件也体现在卡片上**（这是 subsession 层的）」
+ *
+ * ## 语义对比（这是本模块存在的全部理由）
+ *
+ * ```
+ * ❌ 旧（错）：type CardSubject = { kind:"task"; taskId } | { kind:"session"; sessionId }
+ *            → 主键二选一；task 卡和 session 卡是两张不同的卡
+ * ✅ 新（对）：type CardSubject = {
+ *              sessionId: string;        // ← 永远是主键，不可缺
+ *              taskId?: number;          // ← 可选增强，有就多显示
+ *            }
+ * ```
+ *
+ * 关键推论（写代码时最容易搞错的地方）：
+ *
+ * 1. **刷新永远读 session store**。有 task 时也读 session —— 因为
+ *    「消息数 + 最近 msg」是**会话**的属性，不是 task 的属性。
+ *    旧实现走 `taskId → bgTask → subSessionId → session`，绕了一圈才拿到
+ *    同一个 session；现在主键就是 sessionId，直达。
+ * 2. **生命周期（超时/完成/停止）是 session 层的事实**。旧设计里终态来自
+ *    `task.status`（没 task 就永远 non-terminal）—— 这正是本次要修的语义错误。
+ *    现在终态来自 **跑这个 session 的后台任务**（`BackgroundTask.status`），
+ *    与「该 session 有没有建 task」无关。
+ * 3. **有 task 只是"多一块信息"**，不改变卡片身份、不改变刷新行为。
+ *
+ * ## 序列化格式
+ *
+ * 持久层主键是字符串，格式：
+ *
+ * ```
+ * session:<sessionId>                    ← 无关联 task
+ * session:<sessionId>#task:<taskId>      ← 有关联 task（附加段）
+ * ```
+ *
+ * - 主键段**永远是 session**；`#task:` 段是纯附加值，缺了不影响解析
+ * - 用 `#` 分隔而不是再嵌 `:`，避免 session id 里含 `:` 时歧义
+ *   （session id 可能含 `-` / `_`，理论上也可能含别的；`#` 最少见）
+ * - 旧数据（只有 `task_id INTEGER`）迁移时**无法**反推 sessionId ⇒ 标记为
+ *   `legacy-task:<n>`，仅用于读旧卡（新卡不再产生这种形态）
+ */
+/**
+ * 卡片实体：**session 为主 + task 可选**。
+ *
+ * ⚠️ `sessionId` 必填 —— 这是本次澄清的核心，不要为了兼容旧代码把它变可选。
+ */
+export interface CardSubject {
+    /** ★ 主键：跑这次执行的 sub-session */
+    sessionId: string;
+    /** 附加增强：该 session 内创建的 roy 任务（可能没有） */
+    taskId?: number;
+}
+/** 持久层主键 */
+export type CardKey = string;
+/**
+ * 造卡片主键。**sessionId 必填**，taskId 可选（附加值）。
+ *
+ * @throws sessionId 为空（空主键会撞脏数据，宁可早失败）
+ */
+export declare function cardKeyOf(subject: CardSubject): CardKey;
+/** 便捷：只给 sessionId（无 task） */
+export declare function sessionCardKey(sessionId: string): CardKey;
+/** 便捷：sessionId + taskId */
+export declare function sessionTaskCardKey(sessionId: string, taskId: number): CardKey;
+/** 旧卡（迁移期只读）：`legacy-task:<n>` */
+export declare function legacyTaskCardKey(taskId: number): CardKey;
+/**
+ * 解析主键。
+ *
+ * 失败（非字符串 / 空 / 缺 `session:` 前缀 / sessionId 为空）一律
+ * `undefined` —— 调用方降级，**绝不抛、绝不猜**。
+ *
+ * 注意：`legacy-task:<n>` **不**解析成 CardSubject（它没有 sessionId，
+ * 无法参与刷新）；需要区分旧卡时用 `isLegacyTaskCardKey`。
+ */
+export declare function parseCardKey(key: unknown): CardSubject | undefined;
+/** 是否是迁移期的旧卡主键（只有 task、没有 session） */
+export declare function isLegacyTaskCardKey(key: unknown): boolean;
+/** 判定版 */
+export declare function isCardKey(v: unknown): v is CardKey;
+/**
+ * 从按钮 `value` 里挑出卡片实体。
+ *
+ * ## 与旧实现的关键差异
+ *
+ * 旧实现「taskId 优先，没有 taskId 才用 sessionId」—— 那会让**有 task 的
+ * session 卡**被当成 task 卡刷新（走 task→bgTask→session 绕路，且丢掉
+ * session 层的生命周期）。现在：**sessionId 是主键，taskId 只是附加值**，
+ * 所以 sessionId 必须存在，taskId 有就带上。
+ *
+ * @returns 无 sessionId ⇒ `undefined`（连主键都没有，无法刷新）
+ */
+export declare function pickCardSubject(value: {
+    sessionId?: unknown;
+    taskId?: unknown;
+}): CardSubject | undefined;
+/**
+ * 主标签：`会话 <sessionId 截断>`。
+ *
+ * session 是卡片身份，所以标签以它为主；task 信息在卡片正文里单独展示
+ * （见 `buildSessionCard` 的「任务信息」面板）。
+ */
+export declare function cardSubjectLabel(subject: CardSubject): string;
+/** 是否有关联 task（决定卡片是否渲染「任务信息」面板） */
+export declare function hasTask(subject: CardSubject): boolean;

package/dist/env/task/plugins/index.d.ts

@@ -10,6 +10,8 @@ export { TASK_COMPLETION_HINT_ANCHOR, TASK_COMPLETE_ITEM_BY_ITEM, TASK_COMPLETE_
 export type { DecisionPort, DecisionRequest, DecisionAnswer, DecisionResponse, } from "./decision-port";
 export { WORKFLOW_EXTRACTOR_PROMPT, formatExtractorInput, formatExtractorInputFromDescription, parseExtractorOutput, } from "./workflow-extractor-agent";
 export { LarkCliTaskNotifyHook, createLarkCliTaskNotifyHook, type TaskNotifyConfig, NotifyType, } from "./lark-cli-task-notify-plugin";
+export { WecomTaskNotifyHook, createWecomTaskNotifyHook, extractWecomFields, buildWecomTaskCard, WecomNotifyType, type WecomTaskNotifyConfig, type WecomMilestone, } from "./wecom-task-notify-plugin";
+export { createWecomCardStateStore, createMemoryWecomCardStore, MemoryWecomCardStateStore, SqliteWecomCardStateStore, getDefaultWecomCardDbPath, type WecomCardState, type WecomCardStateStore, } from "./wecom-card-state-store";
 export { PerTaskGroupChatPlugin, createPerTaskGroupChatPlugin, type PerTaskGroupConfig, } from "./per-task-group-chat-plugin";
 export { LarkCardPatchNotifier, type LarkCardPatchNotifierOptions, buildTaskCard, buildWorkflowCard, renderProgressBar, renderMilestones, renderProcessSteps, renderTaskInfoLines, renderContextAsLines, renderWorkflowInfoLines, formatTimestampForDisplay, formatDateTimeForDisplay, formatDurationMs, sanitizeInlineText, humanizeValue, resolveTaskTitleForDisplay, buildChatAppLink, DEFAULT_APP_LINK_BASE, type CardStatus, type WorkflowCardStatus, type Milestone, type ProcessStep, type TaskMeta, type WorkflowMeta, type CardPayload, type StartTaskOptions, type UpdateTaskOptions, type FinishTaskOptions, type StartTaskResult, type StartWorkflowOptions, type UpdateWorkflowOptions, type FinishWorkflowOptions, } from "./lark-card-patch-notifier";
 export { createLarkCardStateStore, getDefaultLarkCardDbPath, MemoryLarkCardStateStore, SqliteLarkCardStateStore, type LarkCardState, type LarkCardRecordStatus, type LarkCardStateStore, } from "./lark-card-state-store";

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

@@ -4,32 +4,39 @@ import {
   LarkCliTaskNotifyHook,
   LayaCompletionPlugin,
   LayaDecisionPlugin,
-  MemoryLarkCardStateStore,
+  MemoryWecomCardStateStore,
   NotifyType,
   PerTaskGroupChatPlugin,
-  SqliteLarkCardStateStore,
+  SqliteWecomCardStateStore,
   TaskTagPlugin,
   WORKFLOW_EXTRACTOR_PROMPT,
+  WecomNotifyType,
+  WecomTaskNotifyHook,
   buildCompletionHint,
   buildCompletionQuestion,
+  buildWecomTaskCard,
   createAutoTaskPlugin,
-  createLarkCardStateStore,
   createLarkCliTaskNotifyHook,
   createLayaCompletionPlugin,
   createLayaDecisionPlugin,
+  createMemoryWecomCardStore,
   createPerTaskGroupChatPlugin,
+  createWecomCardStateStore,
+  createWecomTaskNotifyHook,
+  extractWecomFields,
   formatExtractorInput,
   formatExtractorInputFromDescription,
-  getDefaultLarkCardDbPath,
+  getDefaultWecomCardDbPath,
   parseExtractorOutput,
   registerLayaCompletionTaskHook,
   renderCompletionState
-} from "../../../shared/@ai-setting/roy-agent-core-rsn44n9y.js";
-import"../../../shared/@ai-setting/roy-agent-core-na18zwj0.js";
-import"../../../shared/@ai-setting/roy-agent-core-9vxh6f8h.js";
-import"../../../shared/@ai-setting/roy-agent-core-ezvpreqz.js";
+} from "../../../shared/@ai-setting/roy-agent-core-ra66sf50.js";
+import"../../../shared/@ai-setting/roy-agent-core-h1e1fm9b.js";
+import"../../../shared/@ai-setting/roy-agent-core-c4ec7k0p.js";
+import"../../../shared/@ai-setting/roy-agent-core-4t3yskp8.js";
+import"../../../shared/@ai-setting/roy-agent-core-y7fqtzk2.js";
 import"../../../shared/@ai-setting/roy-agent-core-1pg0fepg.js";
-import"../../../shared/@ai-setting/roy-agent-core-tr3ep81v.js";
+import"../../../shared/@ai-setting/roy-agent-core-d6zdbgtc.js";
 import"../../../shared/@ai-setting/roy-agent-core-m46fe3x4.js";
 import {
   TASK_COMPLETE_ACCEPTANCE,
@@ -40,12 +47,16 @@ import {
 import {
   DEFAULT_APP_LINK_BASE,
   LarkCardPatchNotifier,
+  MemoryLarkCardStateStore,
+  SqliteLarkCardStateStore,
   buildChatAppLink,
   buildTaskCard,
   buildWorkflowCard,
+  createLarkCardStateStore,
   formatDateTimeForDisplay,
   formatDurationMs,
   formatTimestampForDisplay,
+  getDefaultLarkCardDbPath,
   humanizeValue,
   renderContextAsLines,
   renderMilestones,
@@ -55,9 +66,11 @@ import {
   renderWorkflowInfoLines,
   resolveTaskTitleForDisplay,
   sanitizeInlineText
-} from "../../../shared/@ai-setting/roy-agent-core-w0qjeq2v.js";
-import"../../../shared/@ai-setting/roy-agent-core-1v4g0d4x.js";
-import"../../../shared/@ai-setting/roy-agent-core-cgtq6427.js";
+} from "../../../shared/@ai-setting/roy-agent-core-shb1qsyg.js";
+import"../../../shared/@ai-setting/roy-agent-core-418zc9ha.js";
+import"../../../shared/@ai-setting/roy-agent-core-6k8mb7zx.js";
+import"../../../shared/@ai-setting/roy-agent-core-rm7seqwb.js";
+import"../../../shared/@ai-setting/roy-agent-core-e08bvpaq.js";
 import"../../../shared/@ai-setting/roy-agent-core-er070zjq.js";
 import {
   TASK_OP_WATERMARK_AUDIT_INTERVAL,
@@ -65,12 +78,12 @@ import {
   TASK_OP_WATERMARK_MESSAGE_LIMIT,
   TaskOpWatermarkPlugin,
   createTaskOpWatermarkPlugin
-} from "../../../shared/@ai-setting/roy-agent-core-h21gngxf.js";
+} from "../../../shared/@ai-setting/roy-agent-core-7yh5wps0.js";
 import"../../../shared/@ai-setting/roy-agent-core-mkc3zshb.js";
 import"../../../shared/@ai-setting/roy-agent-core-az13yzmc.js";
-import"../../../shared/@ai-setting/roy-agent-core-qqaak24r.js";
-import"../../../shared/@ai-setting/roy-agent-core-7cbpmk4q.js";
-import"../../../shared/@ai-setting/roy-agent-core-qq96p0tj.js";
+import"../../../shared/@ai-setting/roy-agent-core-tkpp1ba0.js";
+import"../../../shared/@ai-setting/roy-agent-core-p31ftgq9.js";
+import"../../../shared/@ai-setting/roy-agent-core-5s2t8z00.js";
 import"../../../shared/@ai-setting/roy-agent-core-7f7t9wwp.js";
 import"../../../shared/@ai-setting/roy-agent-core-85xyctnb.js";
 import"../../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";
@@ -87,24 +100,32 @@ export {
   registerLayaCompletionTaskHook,
   parseExtractorOutput,
   humanizeValue,
+  getDefaultWecomCardDbPath,
   getDefaultLarkCardDbPath,
   formatTimestampForDisplay,
   formatExtractorInputFromDescription,
   formatExtractorInput,
   formatDurationMs,
   formatDateTimeForDisplay,
+  extractWecomFields,
+  createWecomTaskNotifyHook,
+  createWecomCardStateStore,
   createTaskOpWatermarkPlugin,
   createPerTaskGroupChatPlugin,
+  createMemoryWecomCardStore,
   createLayaDecisionPlugin,
   createLayaCompletionPlugin,
   createLarkCliTaskNotifyHook,
   createLarkCardStateStore,
   createAutoTaskPlugin,
   buildWorkflowCard,
+  buildWecomTaskCard,
   buildTaskCard,
   buildCompletionQuestion,
   buildCompletionHint,
   buildChatAppLink,
+  WecomTaskNotifyHook,
+  WecomNotifyType,
   WORKFLOW_EXTRACTOR_PROMPT,
   TaskTagPlugin,
   TaskOpWatermarkPlugin,
@@ -115,9 +136,11 @@ export {
   TASK_COMPLETE_VERIFY_DUTY,
   TASK_COMPLETE_ITEM_BY_ITEM,
   TASK_COMPLETE_ACCEPTANCE,
+  SqliteWecomCardStateStore,
   SqliteLarkCardStateStore,
   PerTaskGroupChatPlugin,
   NotifyType,
+  MemoryWecomCardStateStore,
   MemoryLarkCardStateStore,
   LayaDecisionPlugin,
   LayaCompletionPlugin,