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

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

@@ -174,6 +174,15 @@ export interface AgentComponentOptions {
     envPrefix?: string;
     /** 直接传入的配置对象（可选，优先级最高） */
     config?: Partial<AgentComponentConfig>;
+    /**
+     * Task #4794 — onStop() 时是否跳过 abort 所有运行中的 agent run。
+     *
+     * CLI `act` 一次性命令收尾时传 true：后台子 agent 是有意留下
+     * 继续跑的，onStop 无条件 abort 会中断其 LLM 调用（finishReason=aborted）。
+     * 子 agent 的存活由 TaskComponent.stop 的 waitForRunningTasks 保证。
+     * REPL / ESC cascade 等用户主动退出场景保持默认 false（abort 全部）。
+     */
+    skipAbortRunningTasksOnStop?: boolean;
 }
 /**
  * 按 agent 的 `allowedAgentTypes` 工具级可见性过滤工具列表。
@@ -246,6 +255,11 @@ export declare class AgentComponent extends BaseComponent {
     private fallbackState;
     /** ConfigComponent 用于配置管理 */
     private configComponent?;
+    /**
+     * Task #4794 — onStop() 时是否跳过 abort 运行中的 agent run
+     * （act 一次性命令收尾 = true；用户主动退出 = false 默认）。
+     */
+    private skipAbortRunningTasksOnStop;
     /** 配置变更 watcher 清理函数 */
     private configWatcher?;
     /** Session 消息转换器 */
@@ -492,6 +506,21 @@ export declare class AgentComponent extends BaseComponent {
      * 不阻塞 run。
      */
     private _loadOrCreateCacheSnapshot;
+    /**
+     * 【Task #4813】B1 mtime 失效检测：快照是否因 memory 文件变化而过期
+     *
+     * 返回 null = 快照仍有效（可复用）；返回字符串 = 过期原因（用于日志）。
+     *
+     * 兼容迁移：旧快照（Task #4813 之前持久化）无 memoryStat 字段 → 视为过期。
+     */
+    private _isMemorySnapshotStale;
+    /**
+     * 【Task #4813】采集各 memory 文件的 mtime（按 MemoryComponent 配置的
+     * memoryPaths × memoryFile），供快照失效检测使用。
+     *
+     * 文件不存在 → 记为 0（删除后重拍语义）；memory component 缺失 → 全 0。
+     */
+    private _collectMemoryStat;
     /**
      * 【Task #2744】无 sessionId 时的 {{memory}} fallback 替换
      *

package/dist/env/agent/agent-component.js

@@ -7,7 +7,7 @@ import {
   filterToolsByAgent,
   parseToolList,
   toLLMMessage
-} from "../../shared/@ai-setting/roy-agent-core-j1kksatb.js";
+} from "../../shared/@ai-setting/roy-agent-core-hfr6bzts.js";
 import"../../shared/@ai-setting/roy-agent-core-dt104qa1.js";
 import"../../shared/@ai-setting/roy-agent-core-jvv2h3d6.js";
 import"../../shared/@ai-setting/roy-agent-core-07fvy74y.js";

package/dist/env/agent/index.js

@@ -4,7 +4,7 @@ import {
 import {
   AgentComponent,
   AgentComponentConfigSchema
-} from "../../shared/@ai-setting/roy-agent-core-j1kksatb.js";
+} from "../../shared/@ai-setting/roy-agent-core-hfr6bzts.js";
 import"../../shared/@ai-setting/roy-agent-core-dt104qa1.js";
 import"../../shared/@ai-setting/roy-agent-core-jvv2h3d6.js";
 import"../../shared/@ai-setting/roy-agent-core-07fvy74y.js";

package/dist/env/agent/types.d.ts

@@ -243,6 +243,8 @@ export interface HookContext {
         systemPrompt: string;
         additionInfo: string;
         snapshotAt: number;
+        /** 【Task #4813】B1 mtime 失效检测：首拍时各 memory 文件的 mtime（ms） */
+        memoryStat?: MemorySnapshotStat;
     };
     /** 执行上下文（可直接修改属性） */
     context: AgentContext;
@@ -311,6 +313,20 @@ export interface Plugin {
  * Agent 类型
  */
 export type AgentType = "primary" | "sub" | "summary";
+/**
+ * 【Task #4813】cacheSnapshot 记忆失效检测（B1 mtime 方案）：
+ * 首拍时各 memory 文件的 mtime 快照。
+ *
+ * - globalMtime: global memory.md 的 mtime（ms）；文件不存在记 0
+ * - projectMtime: project memory.md 的 mtime（ms）；文件不存在记 0
+ *
+ * 复用快照前比对当前 mtime，不一致 → 快照过期 → 重拍。
+ * 旧快照无此字段 → 视为过期（一次性迁移重拍）。
+ */
+export interface MemorySnapshotStat {
+    globalMtime: number;
+    projectMtime: number;
+}
 /**
  * Agent 状态
  */

package/dist/env/environment.d.ts

@@ -177,6 +177,19 @@ export declare class BaseEnvironment extends BaseComponent implements Environmen
     protected startComponents(): Promise<void>;
     /**
      * 停止所有组件
+     *
+     * Task #4794 根因 #4 — LIFO 逆序停止。
+     *
+     * 注册顺序是 config→session→llm→tool→agent→…→task，
+     * 旧实现按 Map 迭代顺序 FIFO 停止 → task 最后停。
+     * 当 task 组件在 stop() 里等待后台子 agent 完成
+     * （BackgroundTaskManager.dispose waitForRunningTasks）时，
+     * 子 agent 下一次 LLM 调用会因 LLMComponent 已停而抛
+     * "LLMComponent is not running" → 任务 failed → 等待中断
+     * → 进程退出杀死同进程子 agent（e2e 取证 23:22:56.803）。
+     *
+     * LIFO：task（最后注册）最先停止，等待期间 llm/tool/agent
+     * 仍存活；config/session（最先注册）最后停止。
      */
     protected stopComponents(): Promise<void>;
     /**

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

@@ -11,19 +11,20 @@ import {
   patchCardByLarkCli,
   renderRuleNoticeSection,
   timerHandler
-} from "../../shared/@ai-setting/roy-agent-core-8nksrtnf.js";
+} from "../../shared/@ai-setting/roy-agent-core-k4ps1hxp.js";
 import"../../shared/@ai-setting/roy-agent-core-bxkjk7zx.js";
 import"../../shared/@ai-setting/roy-agent-core-add1zqsh.js";
 import {
   cliCommandHandler
 } from "../../shared/@ai-setting/roy-agent-core-v0hf14bj.js";
 import"../../shared/@ai-setting/roy-agent-core-tm1mxttk.js";
-import"../../shared/@ai-setting/roy-agent-core-v8bz7d8x.js";
+import"../../shared/@ai-setting/roy-agent-core-b7jbqfsy.js";
 import"../../shared/@ai-setting/roy-agent-core-na18zwj0.js";
 import"../../shared/@ai-setting/roy-agent-core-abqhkbn3.js";
 import"../../shared/@ai-setting/roy-agent-core-1pg0fepg.js";
-import"../../shared/@ai-setting/roy-agent-core-vs5gxgwh.js";
+import"../../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"../../shared/@ai-setting/roy-agent-core-c2gbt68e.js";

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

@@ -1,7 +1,7 @@
 import"../../shared/@ai-setting/roy-agent-core-b4x6x4k2.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,
@@ -33,7 +33,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,
@@ -52,7 +52,7 @@ import {
   parseCliSessionChatId
 } from "../../shared/@ai-setting/roy-agent-core-v0hf14bj.js";
 import"../../shared/@ai-setting/roy-agent-core-tm1mxttk.js";
-import"../../shared/@ai-setting/roy-agent-core-v8bz7d8x.js";
+import"../../shared/@ai-setting/roy-agent-core-b7jbqfsy.js";
 import {
   EventStoreImpl,
   getSharedEventStore,
@@ -61,8 +61,9 @@ import {
 } from "../../shared/@ai-setting/roy-agent-core-na18zwj0.js";
 import"../../shared/@ai-setting/roy-agent-core-abqhkbn3.js";
 import"../../shared/@ai-setting/roy-agent-core-1pg0fepg.js";
-import"../../shared/@ai-setting/roy-agent-core-vs5gxgwh.js";
+import"../../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"../../shared/@ai-setting/roy-agent-core-c2gbt68e.js";

package/dist/env/event-source/timer-handler.d.ts

@@ -29,6 +29,53 @@ export type GetRunningTasksFn = () => BackgroundTask[];
  * 用于注入 BackgroundTaskManager 的 options key
  */
 export declare const TIMER_OPTIONS_KEY_GET_MANAGER = "getBackgroundTaskManager";
+/** schedule 模式下的低频 tick 间隔（30 秒） */
+export declare const SCHEDULE_TICK_INTERVAL_MS: number;
+/** options key：多时刻配置 */
+export declare const TIMER_OPTIONS_KEY_SCHEDULE = "schedule";
+/** options key：显式指定事件路由到的 session（独立 session） */
+export declare const TIMER_OPTIONS_KEY_SESSION_ID = "sessionId";
+/** options key：schedule 模式下是否在有运行中后台任务时跳过 */
+export declare const TIMER_OPTIONS_KEY_SKIP_WHEN_RUNNING = "skipWhenRunning";
+/**
+ * 单条 schedule 项
+ *
+ * - time: `HH:MM`（24 小时制，本地时区）
+ * - prompt: 该时刻触发时注入的 prompt
+ * - label: 可选标签（写入 event metadata.scheduleLabel，便于下游识别）
+ * - sessionId: 可选，覆盖实例级 session（该时刻走独立 session）
+ */
+export interface TimerScheduleEntry {
+    time: string;
+    prompt: string;
+    label?: string;
+    sessionId?: string;
+}
+/**
+ * 校验 `HH:MM` 格式
+ *
+ * @returns 合法返回 true；非法返回 false
+ */
+export declare function isValidScheduleTime(time: unknown): time is string;
+/**
+ * 解析 options.schedule 为合法的 schedule 项数组
+ *
+ * 非法项被静默丢弃（validateConfig 负责报错），返回的数组只含合法项。
+ *
+ * @param raw 原始值（通常是 config.options.schedule）
+ * @returns 合法 schedule 项数组；不是数组时返回空数组
+ */
+export declare function parseSchedule(raw: unknown): TimerScheduleEntry[];
+/**
+ * 校验 schedule 配置，返回错误列表（空数组 = 合法）
+ *
+ * 规则：
+ * 1. schedule 必须是数组且非空
+ * 2. 每项 time 必须是 `HH:MM`
+ * 3. 每项 prompt 必须是非空字符串
+ * 4. schedule 与 interval 互斥
+ */
+export declare function validateScheduleConfig(config: EventSourceConfig): string[];
 /**
  * Timer EventSourceInstance 实现
  *
@@ -41,6 +88,20 @@ export declare class TimerInstance implements EventSourceInstance {
     private readonly sessionId;
     private readonly getRunningTasks;
     private readonly customPrompt?;
+    /** schedule 模式：合法 schedule 项 */
+    private readonly schedule;
+    /** 是否处于 schedule 模式（配置了 schedule 键即为 true，即使全项非法） */
+    private readonly scheduleMode;
+    /** 非法 schedule 的告警是否已打印（只打一次，避免刷屏） */
+    private invalidScheduleWarned;
+    /** schedule 模式下实例级默认 session（跨重启稳定） */
+    private readonly scheduleSessionId;
+    /** schedule 模式下是否在有运行中后台任务时跳过 */
+    private readonly skipWhenRunning;
+    /** 已触发标记：`YYYY-MM-DD#HH:MM` → true（当日去重） */
+    private readonly firedKeys;
+    /** 可注入时钟（测试用） */
+    private readonly now;
     private status;
     private timerId?;
     private eventHandler?;
@@ -48,8 +109,11 @@ export declare class TimerInstance implements EventSourceInstance {
      * @param config 事件源配置
      * @param getRunningTasks 可选的回调，用于获取当前所有后台任务。
      *                        测试时可直接传入；生产环境通过 config.options.getBackgroundTaskManager 注入。
+     * @param now 可选的时钟注入（返回 epoch ms），测试用。
      */
-    constructor(config: EventSourceConfig, getRunningTasks?: GetRunningTasksFn);
+    constructor(config: EventSourceConfig, getRunningTasks?: GetRunningTasksFn, now?: () => number);
+    /** 当前是否为 schedule 模式 */
+    private get isScheduleMode();
     start(): Promise<void>;
     stop(): Promise<void>;
     getStatus(): EventSourceStatus;
@@ -61,10 +125,38 @@ export declare class TimerInstance implements EventSourceInstance {
      * Rule-based 检查：有 status === "running" 的后台任务时跳过本次触发
      */
     private tick;
+    /**
+     * ★ Task #4815：schedule 模式 tick
+     *
+     * 逻辑：
+     * 1. 取当前本地时刻（HH:MM）与日期（YYYY-MM-DD）
+     * 2. 找出与当前时刻匹配的 schedule 项
+     * 3. 若该 `日期#时刻` 今日已触发 → 跳过（当日去重）
+     * 4. schedule 模式默认**不**做 rule-based 跳过；
+     *    仅当 options.skipWhenRunning=true 时才检查后台任务
+     * 5. 命中 → 标记已触发 + 构建事件（prompt 取当次命中项）
+     */
+    private tickSchedule;
+    /**
+     * 清理过期的去重标记（只保留当天的）
+     *
+     * 防止长期运行时 Set 无限增长（每天新增若干 key）。
+     * 实现：只保留 `currentDateKey` 当天的标记。
+     * 说明：跨天时昨天的 key 失去意义（dateKey 不同即不同 key），删掉是安全的。
+     */
+    private pruneFiredKeys;
     /**
      * 构建 SelfReminder 事件
      *
      * 结构参考 LarkCliInstance.handleEvent() 输出的 EventSourceEvent
+     *
+     * ★ Task #4815：schedule 模式下
+     *   - message 取命中 schedule 项的 prompt
+     *   - metadata 注入 `trigger_session_id`（EventHandler 用它把事件路由到
+     *     独立 session，而不是主会话）
+     *   - metadata 注入 `scheduleLabel`（可选，便于下游识别是哪个时刻）
+     *
+     * @param entry 命中的 schedule 项；interval 模式不传
      */
     private buildSelfReminderEvent;
 }

package/dist/env/index.js

@@ -1,24 +1,24 @@
 import {
   BaseEnvironment
-} 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 {
   builtInHandlers,
   larkCliHandler
-} from "../shared/@ai-setting/roy-agent-core-8nksrtnf.js";
+} from "../shared/@ai-setting/roy-agent-core-k4ps1hxp.js";
 import {
   EventSourceInitHooks,
   getDefaultConfigForType,
@@ -29,12 +29,13 @@ import {
 import"../shared/@ai-setting/roy-agent-core-add1zqsh.js";
 import"../shared/@ai-setting/roy-agent-core-v0hf14bj.js";
 import"../shared/@ai-setting/roy-agent-core-tm1mxttk.js";
-import"../shared/@ai-setting/roy-agent-core-v8bz7d8x.js";
+import"../shared/@ai-setting/roy-agent-core-b7jbqfsy.js";
 import"../shared/@ai-setting/roy-agent-core-na18zwj0.js";
 import"../shared/@ai-setting/roy-agent-core-abqhkbn3.js";
 import"../shared/@ai-setting/roy-agent-core-1pg0fepg.js";
-import"../shared/@ai-setting/roy-agent-core-vs5gxgwh.js";
+import"../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 {
@@ -67,7 +68,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"../shared/@ai-setting/roy-agent-core-dt104qa1.js";
 import"../shared/@ai-setting/roy-agent-core-jvv2h3d6.js";
 import"../shared/@ai-setting/roy-agent-core-07fvy74y.js";

package/dist/env/prompt/index.js

@@ -3,8 +3,9 @@ import {
   PromptConfigSchema,
   PromptPathSchema,
   PromptRenderer
-} from "../../shared/@ai-setting/roy-agent-core-cvm1xgmg.js";
-import"../../shared/@ai-setting/roy-agent-core-vs5gxgwh.js";
+} from "../../shared/@ai-setting/roy-agent-core-wksgtqf9.js";
+import"../../shared/@ai-setting/roy-agent-core-ma35jyd9.js";
+import"../../shared/@ai-setting/roy-agent-core-6m4bw8jy.js";
 import"../../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
 import"../../shared/@ai-setting/roy-agent-core-7hh0brvs.js";
 import"../../shared/@ai-setting/roy-agent-core-pgvcf91v.js";