@ai-setting/roy-agent-core 1.7.51 → 1.7.53

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

@@ -0,0 +1,74 @@
+/**
+ * Timer EventSource Handler
+ *
+ * 周期性触发事件（默认 10 分钟），通过 rule-based 逻辑检查
+ * BackgroundTaskManager：如果没有运行中的任务，则构造 selfReminder
+ * 事件触发 agent 处理。
+ *
+ * 设计要点：
+ * 1. 实现 EventSourceHandler / EventSourceInstance 接口
+ * 2. 使用 setInterval 定时触发
+ * 3. Rule-based 检查：过滤 status === "running" 的 BackgroundTask
+ * 4. 同一实例维护固定 sessionId（格式：timer-{sourceId}-{processId}）
+ * 5. 事件结构参考 LarkCliInstance
+ */
+import type { EventSourceConfig, EventSourceHandler, EventSourceInstance, EventSourceStatus, EventSourceEventHandler } from "./types";
+import type { BackgroundTask } from "../task/delegate/delegate-tool";
+/** 默认触发间隔：10 分钟 */
+export declare const DEFAULT_TIMER_INTERVAL_MS: number;
+/**
+ * 获取运行中任务的回调函数
+ *
+ * 返回的数组中，任何 status === "running" 的任务都会阻止本次触发。
+ * 设计为回调而不是直接传入 BackgroundTaskManager，是为了：
+ * 1. 保持 createInstance(config) 签名不变（不破坏 EventSourceHandler 接口）
+ * 2. 便于测试时注入 mock
+ */
+export type GetRunningTasksFn = () => BackgroundTask[];
+/**
+ * 用于注入 BackgroundTaskManager 的 options key
+ */
+export declare const TIMER_OPTIONS_KEY_GET_MANAGER = "getBackgroundTaskManager";
+/**
+ * Timer EventSourceInstance 实现
+ *
+ * 使用 setInterval 周期性触发事件，每次触发前通过 getRunningTasks
+ * 检查是否有运行中的任务。
+ */
+export declare class TimerInstance implements EventSourceInstance {
+    private readonly config;
+    private readonly interval;
+    private readonly sessionId;
+    private readonly getRunningTasks;
+    private readonly customPrompt?;
+    private status;
+    private timerId?;
+    private eventHandler?;
+    /**
+     * @param config 事件源配置
+     * @param getRunningTasks 可选的回调，用于获取当前所有后台任务。
+     *                        测试时可直接传入；生产环境通过 config.options.getBackgroundTaskManager 注入。
+     */
+    constructor(config: EventSourceConfig, getRunningTasks?: GetRunningTasksFn);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    getStatus(): EventSourceStatus;
+    onEvent(handler: EventSourceEventHandler): void;
+    offEvent(): void;
+    /**
+     * 定时器 tick 回调
+     *
+     * Rule-based 检查：有 status === "running" 的后台任务时跳过本次触发
+     */
+    private tick;
+    /**
+     * 构建 SelfReminder 事件
+     *
+     * 结构参考 LarkCliInstance.handleEvent() 输出的 EventSourceEvent
+     */
+    private buildSelfReminderEvent;
+}
+/**
+ * Timer EventSourceHandler 实现
+ */
+export declare const timerHandler: EventSourceHandler;