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

package/dist/env/task/plugins/laya-port.d.ts

@@ -131,6 +131,17 @@ export interface LayaAuthConfig {
     apiKey: string;
     model: string;
 }
+/**
+ * Task #4804 — provider 名常量（provider 分离）：
+ *   - create hook（task:before.create，判新建 vs 复用）→ laya-decision
+ *   - completion hook（task:after.complete，判目标 vs 交付物）→ laya-goal-decision
+ *     （缺失时保守回退 laya-decision —— fail-open 语义不变）
+ */
+export declare const LAYA_DECISION_PROVIDER = "laya-decision";
+export declare const LAYA_GOAL_DECISION_PROVIDER = "laya-goal-decision";
+/** hook 用途 → provider 名（Task #4804 provider 分离的唯一映射点） */
+export type LayaHookPurpose = "create" | "goal";
+export declare function providerNameForPurpose(purpose: LayaHookPurpose): string;
 /**
  * 从 `~/.roy-agent/auth.json` 的 `providers["laya-decision"]` 读取端点配置。
  *
@@ -139,5 +150,17 @@ export interface LayaAuthConfig {
  *                                  → providers["laya-decision"].model（可选）
  *
  * ⚠️ 读不到就返回 null —— 调用方必须 fail-open（不提示、不报错）。
+ *
+ * Task #4804 — 向后兼容：默认仍读 laya-decision（create hook 语义）。
+ *   completion hook 侧请用 `loadLayaAuthForPurpose(path, "goal")`。
  */
 export declare function loadLayaAuth(authPath?: string): Promise<LayaAuthConfig | null>;
+/**
+ * Task #4804 — 按用途读 provider：
+ *   - "create" → providers["laya-decision"]
+ *   - "goal"   → providers["laya-goal-decision"]，缺失时保守回退
+ *                providers["laya-decision"]（共享共享配置，fail-open 不变）
+ *
+ * ⚠️ 读不到就返回 null —— 调用方必须 fail-open（不提示、不报错）。
+ */
+export declare function loadLayaAuthForPurpose(authPath?: string, purpose?: LayaHookPurpose): Promise<LayaAuthConfig | null>;

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

@@ -41,6 +41,21 @@ export interface TaskComponentOptions {
     envPrefix?: string;
     /** 直接传入的配置对象（可选，优先级最高） */
     config?: Partial<TaskConfig>;
+    /**
+     * Task #4794 — 组件 stop() 时 BackgroundTaskManager.dispose() 的收尾行为。
+     *
+     * CLI `act` 一次性命令收尾时传 true（主 run 已结束，后台子 agent
+     * 是有意留下继续跑的）；REPL / ESC cascade 等用户主动退出场景
+     * 保持默认 false（abort 全部，语义不变）。
+     */
+    skipAbortRunningTasksOnDispose?: boolean;
+    /**
+     * Task #4794 — 与 skipAbortRunningTasksOnDispose 配套：
+     * stop() 时等待运行中的后台任务完成后再返回。
+     * 子 agent 是同进程异步 run，进程 exit 会直接杀死它们，
+     * 所以 act 收尾必须等待。默认 false。
+     */
+    waitForRunningTasksOnDispose?: boolean;
 }
 export declare class TaskComponent extends BaseComponent {
     name: string;
@@ -49,6 +64,17 @@ export declare class TaskComponent extends BaseComponent {
     private config?;
     private toolComponent?;
     private backgroundTaskManager?;
+    /**
+     * Task #4794 — stop() 时是否跳过 abort 仍在运行的后台任务
+     * （act 一次性命令收尾 = true；用户主动退出 = false 默认）。
+     */
+    private skipAbortRunningTasksOnDispose;
+    /**
+     * Task #4794 — stop() 时是否等待运行中任务完成
+     * （act 收尾配套：跳过 abort 后必须等子 agent 跑完，
+     * 否则 process.exit 仍会杀死同进程子 agent）。
+     */
+    private waitForRunningTasksOnDispose;
     private configComponent?;
     private tagService;
     private plugins;
@@ -235,6 +261,23 @@ export declare class TaskComponent extends BaseComponent {
      * @returns 更新后的 Task 或 undefined
      */
     completeTask(id: number, sessionId: string, deliverableStoragePath?: string): Promise<Task | undefined>;
+    /**
+     * 直接更新任务 context（不触发 BEFORE/AFTER_UPDATE hook、不发事件）
+     *
+     * ★ Task #4776 review MINOR-1：AFTER_COMPLETE hook 内的嵌套
+     *   updateTask({context}) 会二次 fire AFTER_UPDATE，把订阅者
+     *   （LarkCliTaskNotifyHook 等）无谓拉起 —— 终态任务被再次走
+     *   cardStatusOf 终态路径。hint 回写这类「内部簿记」不应有通知副作用，
+     *   因此提供本方法绕过 hook 链，直接走 store 层。
+     *
+     * 语义与 updateTask({context}) 完全一致：整份覆盖 context 字段。
+     * 调用方负责自己 merge 既有字段（不要拿快照整份覆盖别人写的内容）。
+     *
+     * @param id 任务 ID
+     * @param context 新的 context JSON 字符串（整份覆盖）
+     * @returns 更新后的 Task，任务不存在时返回 undefined
+     */
+    updateTaskContext(id: number, context: string): Promise<Task | undefined>;
     /**
      * Create operation record
      */

package/dist/env/task/tools/completion-copy.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @fileoverview Task #4834 — F3: task_complete 验收文案同源锚点
+ *
+ * 背景（reports/goals-criteria-rules-e2e-rebase.md §遗留 F3）：
+ *   prompts-index.ts 的 COMPLETE 生命周期步骤与工具描述
+ *   （TASK_COMPLETE_DESCRIPTION）**不同源** —— 文案漂移会
+ *   稀释工具描述的遵循度。
+ *
+ * 方案：三个关键短语定义于此，complete-tool 与
+ * prompts-index（default prompt）都引用同一常量，
+ * 文案一致性由 completion-copy-consistency.test.ts 守住。
+ *
+ * ⚠️ 本模块必须保持**零依赖**（不 import 任何其他模块），
+ *   以便 prompts-index（超大模板串）与 tools 层都能安全引用。
+ */
+/** 逐条验收短语（工具描述 / default prompt 共用） */
+export declare const TASK_COMPLETE_ITEM_BY_ITEM = "\u6309\u5B50\u9879\u9010\u6761\u9A8C\u6536";
+/** hint 锚点 token（completion hook 写入 task context 的标记） */
+export declare const TASK_COMPLETION_HINT_ANCHOR = "TASK_COMPLETION_HINT";
+/** 核实义务短语（收到 hint 后必须核实，二选一） */
+export declare const TASK_COMPLETE_VERIFY_DUTY = "\u6838\u5B9E\u4E49\u52A1";
+/** F3 同源文案集合（聚合导出，便于测试解构） */
+export declare const TASK_COMPLETE_ACCEPTANCE: {
+    readonly itemByItem: "按子项逐条验收";
+    readonly hintAnchor: "TASK_COMPLETION_HINT";
+    readonly verifyDuty: "核实义务";
+};

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

@@ -9,8 +9,9 @@ import {
   searchTasksTool,
   treeTasksTool,
   updateTaskTool
-} from "../../../shared/@ai-setting/roy-agent-core-t0ktaevq.js";
+} from "../../../shared/@ai-setting/roy-agent-core-h5vmff8w.js";
 import"../../../shared/@ai-setting/roy-agent-core-tr3ep81v.js";
+import"../../../shared/@ai-setting/roy-agent-core-6m4bw8jy.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-7f7t9wwp.js";

package/dist/index.js

@@ -31,7 +31,7 @@ import"./shared/@ai-setting/roy-agent-core-adg9ghbt.js";
 import {
   PromptComponent,
   PromptStore
-} from "./shared/@ai-setting/roy-agent-core-cvm1xgmg.js";
+} from "./shared/@ai-setting/roy-agent-core-wksgtqf9.js";
 import {
   MemoryComponent
 } from "./shared/@ai-setting/roy-agent-core-nwbfepba.js";
@@ -61,21 +61,21 @@ import {
   BaseEnvironment,
   generateDescendingId,
   generateId
-} from "./shared/@ai-setting/roy-agent-core-8mjnb7xc.js";
+} from "./shared/@ai-setting/roy-agent-core-8zas6w5q.js";
 import {
   TaskComponent
-} from "./shared/@ai-setting/roy-agent-core-nr2m4xw1.js";
+} from "./shared/@ai-setting/roy-agent-core-1k83dq3a.js";
 import"./shared/@ai-setting/roy-agent-core-58804s3j.js";
 import"./shared/@ai-setting/roy-agent-core-jm136jzh.js";
-import"./shared/@ai-setting/roy-agent-core-2wxbx36p.js";
+import"./shared/@ai-setting/roy-agent-core-dnjm17sa.js";
 import"./shared/@ai-setting/roy-agent-core-fttgm52a.js";
 import"./shared/@ai-setting/roy-agent-core-ntq0gz7q.js";
 import"./shared/@ai-setting/roy-agent-core-8gxth0eh.js";
-import"./shared/@ai-setting/roy-agent-core-t0ktaevq.js";
+import"./shared/@ai-setting/roy-agent-core-h5vmff8w.js";
 import"./shared/@ai-setting/roy-agent-core-p5cz9m8v.js";
 import {
   EventSourceComponent
-} from "./shared/@ai-setting/roy-agent-core-4882qsjx.js";
+} from "./shared/@ai-setting/roy-agent-core-1kxf910n.js";
 import {
   BountyIMInstance,
   COMMAND_PREFIX,
@@ -107,7 +107,7 @@ import {
   timerHandler,
   translateCardActionToCommand,
   writeFallbackModelList
-} from "./shared/@ai-setting/roy-agent-core-8nksrtnf.js";
+} from "./shared/@ai-setting/roy-agent-core-k4ps1hxp.js";
 import {
   BUILT_IN_EVENT_SOURCE_TYPES,
   BUILT_IN_EVENT_SOURCE_TYPE_LIST,
@@ -132,7 +132,7 @@ import {
 import {
   TaskTagPlugin,
   createAutoTaskPlugin
-} from "./shared/@ai-setting/roy-agent-core-v8bz7d8x.js";
+} from "./shared/@ai-setting/roy-agent-core-b7jbqfsy.js";
 import {
   EventStoreImpl,
   getSharedEventStore,
@@ -149,8 +149,9 @@ import {
 import {
   getBuiltInPrompt,
   getBuiltInPromptNames
-} from "./shared/@ai-setting/roy-agent-core-vs5gxgwh.js";
+} from "./shared/@ai-setting/roy-agent-core-ma35jyd9.js";
 import"./shared/@ai-setting/roy-agent-core-tr3ep81v.js";
+import"./shared/@ai-setting/roy-agent-core-6m4bw8jy.js";
 import"./shared/@ai-setting/roy-agent-core-0ys85x46.js";
 import"./shared/@ai-setting/roy-agent-core-zk2jg0v7.js";
 import {
@@ -199,7 +200,7 @@ import"./shared/@ai-setting/roy-agent-core-jagkferh.js";
 import {
   AgentComponent,
   AgentComponentConfigSchema
-} from "./shared/@ai-setting/roy-agent-core-j1kksatb.js";
+} from "./shared/@ai-setting/roy-agent-core-hfr6bzts.js";
 import {
   ToolComponent,
   ToolRegistry,

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

@@ -7,7 +7,7 @@ import {
 import {
   BackgroundTaskManager,
   createDelegateTool
-} from "./roy-agent-core-2wxbx36p.js";
+} from "./roy-agent-core-dnjm17sa.js";
 import {
   TaskEntityEventTypes
 } from "./roy-agent-core-8gxth0eh.js";
@@ -22,7 +22,7 @@ import {
   searchTasksTool,
   treeTasksTool,
   updateTaskTool
-} from "./roy-agent-core-t0ktaevq.js";
+} from "./roy-agent-core-h5vmff8w.js";
 import {
   createOperationTool,
   deleteOperationTool,
@@ -198,6 +198,8 @@ class TaskComponent extends BaseComponent {
   config;
   toolComponent;
   backgroundTaskManager;
+  skipAbortRunningTasksOnDispose = false;
+  waitForRunningTasksOnDispose = false;
   configComponent;
   tagService;
   plugins = new Map;
@@ -227,6 +229,8 @@ class TaskComponent extends BaseComponent {
       throw new Error("ConfigComponent is required for TaskComponent initialization");
     }
     this.configComponent = options.configComponent;
+    this.skipAbortRunningTasksOnDispose = options.skipAbortRunningTasksOnDispose === true;
+    this.waitForRunningTasksOnDispose = options.waitForRunningTasksOnDispose === true;
     await this.registerConfig(options);
     this.setStatus("running");
     logger2.info("[TaskComponent] Initialized");
@@ -350,7 +354,10 @@ class TaskComponent extends BaseComponent {
       }
     }
     if (this.backgroundTaskManager) {
-      this.backgroundTaskManager.dispose();
+      await this.backgroundTaskManager.dispose(this.skipAbortRunningTasksOnDispose ? {
+        skipAbortRunningTasks: true,
+        waitForRunningTasks: this.waitForRunningTasksOnDispose
+      } : undefined);
       this.backgroundTaskManager = undefined;
     }
     if (this.store) {
@@ -539,6 +546,9 @@ class TaskComponent extends BaseComponent {
     }
     return task;
   }
+  async updateTaskContext(id, context) {
+    return this.store.updateTask(id, { context });
+  }
   async createOperation(options) {
     const createCtx = {
       options: { ...options }

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

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

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