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

package/dist/shared/@ai-setting/{roy-agent-core-v8bz7d8x.js → roy-agent-core-b7jbqfsy.js}

@@ -10,7 +10,7 @@ import {
 } from "./roy-agent-core-1pg0fepg.js";
 import {
   WORKFLOW_EXTRACT_PROMPT
-} from "./roy-agent-core-vs5gxgwh.js";
+} from "./roy-agent-core-ma35jyd9.js";
 import {
   assertNoLeakage,
   buildHintText,
@@ -929,6 +929,7 @@ function truncateSnippet(text) {
 var DEFAULT_TIMEOUT_MS = 2000;
 var DEFAULT_MAX_STRIKES = 3;
 var DEFAULT_MODEL = "task-decision";
+var DEFAULT_GOAL_MODEL = "task-completion";
 var SYSTEMONE_PATH = "/v1/systemone";
 
 class LayaDecisionPort {
@@ -1058,19 +1059,32 @@ function isTimeoutError(err) {
   }
   return false;
 }
+var LAYA_DECISION_PROVIDER = "laya-decision";
+var LAYA_GOAL_DECISION_PROVIDER = "laya-goal-decision";
+function providerNameForPurpose(purpose) {
+  return purpose === "goal" ? LAYA_GOAL_DECISION_PROVIDER : LAYA_DECISION_PROVIDER;
+}
 async function loadLayaAuth(authPath = `${process.env.HOME ?? "~"}/.roy-agent/auth.json`) {
+  return loadLayaAuthForPurpose(authPath, "create");
+}
+async function loadLayaAuthForPurpose(authPath = `${process.env.HOME ?? "~"}/.roy-agent/auth.json`, purpose = "create") {
   try {
     const fs = await import("fs/promises");
     const raw = await fs.readFile(authPath, "utf-8");
     const parsed = JSON.parse(raw);
-    const p = parsed.providers?.["laya-decision"];
-    if (!p?.baseURL || !p?.apiKey)
-      return null;
-    return {
-      baseURL: p.baseURL,
-      apiKey: p.apiKey,
-      model: p.model ?? DEFAULT_MODEL
-    };
+    const primary = providerNameForPurpose(purpose);
+    const candidates = purpose === "goal" ? [primary, LAYA_DECISION_PROVIDER] : [primary];
+    for (const name of candidates) {
+      const p = parsed.providers?.[name];
+      if (p?.baseURL && p?.apiKey) {
+        return {
+          baseURL: p.baseURL,
+          apiKey: p.apiKey,
+          model: p.model ?? (name === LAYA_GOAL_DECISION_PROVIDER ? DEFAULT_GOAL_MODEL : DEFAULT_MODEL)
+        };
+      }
+    }
+    return null;
   } catch {
     return null;
   }
@@ -2937,4 +2951,4 @@ __legacyDecorateClassTS([
 function createPerTaskGroupChatPlugin(config = {}) {
   return new PerTaskGroupChatPlugin(config);
 }
-export { createAutoTaskPlugin, LAYA_REUSE_THRESHOLD, LayaDecisionPlugin, createLayaDecisionPlugin, WORKFLOW_EXTRACTOR_PROMPT, formatExtractorInput, formatExtractorInputFromDescription, parseExtractorOutput, TaskTagPlugin, extractPerTaskChatId, extractPerTaskChatName, NotifyType, LarkCliTaskNotifyHook, createLarkCliTaskNotifyHook, PerTaskGroupChatPlugin, createPerTaskGroupChatPlugin };
+export { createAutoTaskPlugin, pickGateConfidence, LayaDecisionPort, loadLayaAuthForPurpose, LAYA_REUSE_THRESHOLD, LayaDecisionPlugin, createLayaDecisionPlugin, WORKFLOW_EXTRACTOR_PROMPT, formatExtractorInput, formatExtractorInputFromDescription, parseExtractorOutput, TaskTagPlugin, extractPerTaskChatId, extractPerTaskChatName, NotifyType, LarkCliTaskNotifyHook, createLarkCliTaskNotifyHook, PerTaskGroupChatPlugin, createPerTaskGroupChatPlugin };

package/dist/shared/@ai-setting/{roy-agent-core-2wxbx36p.js → roy-agent-core-dnjm17sa.js}

@@ -10,7 +10,7 @@ import {
 } from "./roy-agent-core-1pg0fepg.js";
 import {
   builtInPrompts
-} from "./roy-agent-core-vs5gxgwh.js";
+} from "./roy-agent-core-ma35jyd9.js";
 import {
   DEFAULT_SUBAGENT_PROMPT
 } from "./roy-agent-core-07fvy74y.js";
@@ -1832,14 +1832,33 @@ ${reuseSection.markdown}`;
   async forceStopAll() {
     return this.forceStopAllAcrossParents();
   }
-  async dispose() {
+  async dispose(options) {
     for (const [, timer] of this.progressTimers) {
       try {
         clearInterval(timer);
       } catch {}
     }
     this.progressTimers.clear();
+    const skipAbortRunningTasks = options?.skipAbortRunningTasks === true;
+    const waitForRunningTasks = options?.waitForRunningTasks === true;
+    if (waitForRunningTasks && skipAbortRunningTasks) {
+      const waitStart = Date.now();
+      const WAIT_TIMEOUT_MS = 10 * 60 * 1000;
+      while (Date.now() - waitStart < WAIT_TIMEOUT_MS) {
+        let running = 0;
+        for (const [, t] of this.tasks) {
+          if (t.status === "running" || t.status === "pending")
+            running++;
+        }
+        if (running === 0)
+          break;
+        logger3.info(`[BackgroundTaskManager] dispose waiting for ${running} running task(s)`);
+        await new Promise((resolve) => setTimeout(resolve, 200));
+      }
+    }
     for (const [, controller] of this.abortControllers) {
+      if (skipAbortRunningTasks)
+        break;
       try {
         controller.abort();
       } catch {}

package/dist/shared/@ai-setting/{roy-agent-core-t0ktaevq.js → roy-agent-core-h5vmff8w.js}

@@ -2,6 +2,11 @@ import {
   NEW_TASK_ID_HASH_PLACEHOLDER,
   NEW_TASK_ID_PLACEHOLDER
 } from "./roy-agent-core-tr3ep81v.js";
+import {
+  TASK_COMPLETE_ITEM_BY_ITEM,
+  TASK_COMPLETE_VERIFY_DUTY,
+  TASK_COMPLETION_HINT_ANCHOR
+} from "./roy-agent-core-6m4bw8jy.js";
 import {
   getEnvContextOrEmpty,
   init_env_context,
@@ -38,7 +43,7 @@ var CreateTaskToolSchema = z.object({
   description: z.string().optional().describe("Task description"),
   priority: z.enum(["low", "medium", "high"]).optional().describe("Task priority"),
   type: z.enum(["normal", "cycle", "longterm"]).optional().default("normal").describe("Task type. normal: 常规任务，需要跟踪完成. cycle: 周期任务（如每周发周报），无需 complete，定期执行. longterm: 长期任务/愿景目标（如提升公司影响力），难以一次性完成，持续跟进"),
-  goals_and_expected_deliverables: z.string().optional().describe("Goals and expected deliverables"),
+  goals_and_expected_deliverables: z.string().optional().describe("Goals and expected deliverables. " + "⚠️ 写成可逐条验收的编号子项（1. … 2. … 3. …），每条是一个可判定的交付/动作" + "（文件断言：文件存在/大小/内容；进程断言：命令 exit code/stdout；" + "测试断言：pass/fail 计数；状态断言：版本号/HTTP 200/状态字段）。" + "避免一句话模糊目标（如「做好 X」「完成调研」）——" + "任务完成时 completion hook 会按这些子项逐条对照操作记录验收。"),
   due_date: z.string().optional().describe("Due date (ISO format)"),
   tags: z.array(z.string()).optional().describe("Task tags (for search, stored in task.tags JSON field)"),
   project_path: z.string().default("unknown").describe("Project root path for task positioning. " + "Used to locate the project space for this task. " + "Use 'unknown' if unknown. (Defaults to 'unknown'.)"),
@@ -84,7 +89,7 @@ var UpdateTaskToolSchema = withLegacyTaskId({
   type: z.enum(["normal", "cycle", "longterm"]).optional().describe("Task type"),
   progress: z.number().min(0).max(100).optional(),
   current_status: z.string().optional(),
-  goals_and_expected_deliverables: z.string().optional(),
+  goals_and_expected_deliverables: z.string().optional().describe("Goals and expected deliverables. " + "⚠️ 追加/修改时同样写成可逐条验收的编号子项（1. … 2. … 3. …），" + "每条是一个可判定的交付/动作（文件断言：文件存在/大小/内容；" + "进程断言：命令 exit code/stdout；测试断言：pass/fail 计数；" + "状态断言：版本号/HTTP 200/状态字段）。" + "避免一句话模糊目标（如「做好 X」「完成调研」）——" + "任务完成时 completion hook 会按这些子项逐条对照操作记录验收。" + "（Task #4833 — 与 task_create 的 goals 规则同源）"),
   due_date: z.string().optional(),
   tags: z.array(z.string()).optional(),
   project_path: z.string().optional().describe("Project path, identifies which project this task belongs to"),
@@ -316,6 +321,37 @@ function createTaskTool(taskComponent) {
         - Same-theme tasks cluster under one parent
         - Long-tail/stranded tasks should be archived or merged
 
+      ## ⚠️ Goals 子项拆分规则 (Task #4791)
+
+      \`goals_and_expected_deliverables\` **MUST** be written as
+      **numbered sub-items** (编号子项) that can each be verified
+      one by one (逐条验收) — for \`type=normal\` tasks:
+
+        1. 实现 X（含文件路径）
+        2. 测试 Y 覆盖 Z 场景（pass/fail 计数）
+        3. 文档 W 落盘到 <path>
+
+      ⚠️ For \`type=longterm\` / \`type=cycle\` tasks there is no
+      per-item completion acceptance（不走逐条 complete 验收）, so the
+      MUST above does not apply; for those, it is **strongly recommended**
+      (建议) to split goals into staged, individually checkable sub-items
+      (阶段性可判子项) instead of one vague sentence.
+
+      Why: when the task is completed, the completion hook
+      (task:after.complete) judges the whole goal against the
+      operation-record chain, using each sub-item as fine-grained
+      evidence (逐条对照的依据). Vague one-line goals (一句话模糊目标，
+      如「做好 X」「完成调研」) give the judge nothing to check and
+      make a completion hint much more likely.
+
+      Reference the four atomic assertion forms (Task #4768
+      四原子形态) when writing each sub-item:
+
+        - 文件断言 (file assertion): file exists / size / content grep
+        - 进程断言 (process assertion): command exit code / stdout match
+        - 测试断言 (test assertion): pass/fail counts, no NEW fail
+        - 状态断言 (state assertion): version number / HTTP 200 / status field
+
       ## ⚠️ Spatial + Temporal Context (Task #2325)
 
       A task MUST carry spatio-temporal context so it survives task-handoff
@@ -917,8 +953,28 @@ Mark a task as completed (progress=100, status=completed). Creates an operation
 
 1. Read the task's \`goal\` (description) and \`delivery\` (goals_and_expected_deliverables) fields.
    - Use \`task_get(task_id=<id>)\` to fetch the full task record.
-2. **Validate** whether the goal and delivery match what you actually delivered.
-   - If mismatch, either: (a) extend the task via \`task_update\`, or (b) honestly note the discrepancy in your final report.
+2. **Validate whether each goal sub-item was achieved** (${TASK_COMPLETE_ITEM_BY_ITEM}).
+   - Goals should be numbered sub-items (编号子项, see task_create rules). Check
+     each sub-item against the operation-record chain (操作记录链) and the
+     deliverable evidence (context.deliverable_storage_path).
+   - The completion hook (task:after.complete) judges the whole goal vs.
+     deliverables; numbered sub-items give it finer-grained evidence to
+     reason with (逐条对照的证据粒度). If it detects that the goal or
+     deliverables appear unmet, the task context will carry a
+     \`[${TASK_COMPLETION_HINT_ANCHOR}]\`.
+   - **If you receive a [${TASK_COMPLETION_HINT_ANCHOR}]**, you MUST verify it
+     (${TASK_COMPLETE_VERIFY_DUTY}): re-read the task via \`task_get\`, then do exactly one of:
+     (a) 确认未完成 → \`task_update(task_id=<id>, status=todo)\` reopen and continue; or
+     (b) 确认已完成 → \`task_operation_create\` (milestone_type=decision,
+         milestone_title=<一行结论>) state why the sub-items are actually
+         met (说明理由).
+     Never ignore it (不允许无视).
+   - If the goal and delivery mismatch **without** a hint, either:
+     (a) extend the task via \`task_update\`, or
+     (b) record the discrepancy via \`task_operation_create\`
+         (milestone_type=decision) — the reason **must** land in the
+         operation record (必须落到操作记录里), not merely a line in
+         your final report (不能只在报告里带一句).
 3. **Provide \`deliverable_storage_path\`** parameter with the deliverable's address:
    - Feishu doc URL (e.g., https://my.feishu.cn/docx/abc)
    - Local file path (e.g., /tmp/report.md)

package/dist/shared/@ai-setting/{roy-agent-core-j1kksatb.js → roy-agent-core-hfr6bzts.js}

@@ -68,6 +68,8 @@ import {
 
 // src/env/agent/agent-component.ts
 init_logger();
+import fs from "fs/promises";
+import path from "path";
 import { z } from "zod";
 
 // src/env/task/plugins/max-iteration-reminder-plugin.ts
@@ -600,6 +602,7 @@ class AgentComponent extends BaseComponent {
   doomLoopCaches = new Map;
   fallbackState = new Map;
   configComponent;
+  skipAbortRunningTasksOnStop = false;
   configWatcher;
   messageConverter = new SessionMessageConverter;
   _constructorConfig;
@@ -622,6 +625,7 @@ class AgentComponent extends BaseComponent {
       throw new Error("ConfigComponent is required for AgentComponent initialization");
     }
     this.configComponent = options.configComponent;
+    this.skipAbortRunningTasksOnStop = options.skipAbortRunningTasksOnStop === true;
     await this.registerConfig(options);
     await this.initRegistry(options.configComponent);
     this.setStatus("running");
@@ -794,13 +798,19 @@ class AgentComponent extends BaseComponent {
   }
   async onStop() {
     logger2.info("[AgentComponent] Stopping and cleaning up resources...");
-    for (const [name, agent] of this.agents) {
-      if (agent.status === "running" || agent.status === "idle") {
-        this.abort(name);
-        logger2.debug(`[AgentComponent] Aborted agent: ${name}`);
+    const skipAbort = this.skipAbortRunningTasksOnStop === true;
+    if (!skipAbort) {
+      for (const [name, agent] of this.agents) {
+        if (agent.status === "running" || agent.status === "idle") {
+          this.abort(name);
+          logger2.debug(`[AgentComponent] Aborted agent: ${name}`);
+        }
       }
+    } else {
+      logger2.info("[AgentComponent] skipAbortRunningTasksOnStop=true — keeping running agent runs alive");
     }
     this.abortControllers.clear();
+    this.aborted.clear();
     this.doomLoopCaches.clear();
     if (this.configWatcher) {
       this.configWatcher();
@@ -1603,12 +1613,18 @@ class AgentComponent extends BaseComponent {
       const session = await sessionComponent.get(sessionId);
       const existingSnapshot = session?.metadata?.cacheSnapshot;
       if (existingSnapshot && typeof existingSnapshot === "object" && existingSnapshot.systemPrompt) {
-        logger2.debug(`[AgentComponent._run] Reusing cacheSnapshot for session ${sessionId} (snapshotAt=${existingSnapshot.snapshotAt})`);
-        return {
-          snapshot: existingSnapshot,
-          systemPromptOverride: existingSnapshot.systemPrompt
-        };
+        const stale = await this._isMemorySnapshotStale(existingSnapshot);
+        if (stale) {
+          logger2.info(`[AgentComponent._run] cacheSnapshot for session ${sessionId} is stale (${stale}); recreating`);
+        } else {
+          logger2.debug(`[AgentComponent._run] Reusing cacheSnapshot for session ${sessionId} (snapshotAt=${existingSnapshot.snapshotAt})`);
+          return {
+            snapshot: existingSnapshot,
+            systemPromptOverride: existingSnapshot.systemPrompt
+          };
+        }
       }
+      const memoryStat = await this._collectMemoryStat();
       let resolvedSystemPrompt = initialSystemPrompt;
       if (resolvedSystemPrompt && resolvedSystemPrompt.includes("{{memory}}")) {
         try {
@@ -1627,7 +1643,8 @@ class AgentComponent extends BaseComponent {
       const snapshot = {
         systemPrompt: resolvedSystemPrompt ?? agentConfigSystemPrompt ?? "",
         additionInfo: effectiveContext.additionInfo || "",
-        snapshotAt: Date.now()
+        snapshotAt: Date.now(),
+        memoryStat
       };
       try {
         await sessionComponent.update(sessionId, {
@@ -1646,6 +1663,46 @@ class AgentComponent extends BaseComponent {
       return { snapshot: null, systemPromptOverride: undefined };
     }
   }
+  async _isMemorySnapshotStale(snapshot) {
+    const stat = snapshot.memoryStat;
+    if (!stat || typeof stat !== "object") {
+      return "no-memoryStat (legacy snapshot)";
+    }
+    const current = await this._collectMemoryStat();
+    if (current.globalMtime !== stat.globalMtime) {
+      return `global memory.md mtime changed (${stat.globalMtime} -> ${current.globalMtime})`;
+    }
+    if (current.projectMtime !== stat.projectMtime) {
+      return `project memory.md mtime changed (${stat.projectMtime} -> ${current.projectMtime})`;
+    }
+    return null;
+  }
+  async _collectMemoryStat() {
+    const empty = { globalMtime: 0, projectMtime: 0 };
+    try {
+      const memoryComponent = this.env?.getComponent?.("memory");
+      if (!memoryComponent?.getMemoryPaths || !memoryComponent.getMemoryFile) {
+        return empty;
+      }
+      const memoryFile = memoryComponent.getMemoryFile();
+      const paths = memoryComponent.getMemoryPaths();
+      const result = { globalMtime: 0, projectMtime: 0 };
+      for (const p of paths) {
+        const filePath = path.join(p.path, memoryFile);
+        try {
+          const st = await fs.stat(filePath);
+          if (p.type === "global") {
+            result.globalMtime = st.mtimeMs;
+          } else if (p.type === "project") {
+            result.projectMtime = st.mtimeMs;
+          }
+        } catch {}
+      }
+      return result;
+    } catch {
+      return empty;
+    }
+  }
   async _fallbackReplaceMemory(systemPrompt) {
     if (!systemPrompt.includes("{{memory}}"))
       return systemPrompt;

package/dist/shared/@ai-setting/{roy-agent-core-8nksrtnf.js → roy-agent-core-k4ps1hxp.js}

@@ -13,7 +13,7 @@ import {
   createPerTaskGroupChatPlugin,
   extractPerTaskChatId,
   extractPerTaskChatName
-} from "./roy-agent-core-v8bz7d8x.js";
+} from "./roy-agent-core-b7jbqfsy.js";
 import {
   getSharedEventStore
 } from "./roy-agent-core-na18zwj0.js";
@@ -311,6 +311,88 @@ var SELF_REMINDER_MESSAGE = `[Timer Self-Reminder]
 
 请根据分析结果，创建 1-3 个有价值的任务并执行。`;
 var TIMER_OPTIONS_KEY_GET_MANAGER = "getBackgroundTaskManager";
+var SCHEDULE_TICK_INTERVAL_MS = 30 * 1000;
+var TIMER_OPTIONS_KEY_SCHEDULE = "schedule";
+var TIMER_OPTIONS_KEY_SESSION_ID = "sessionId";
+var TIMER_OPTIONS_KEY_SKIP_WHEN_RUNNING = "skipWhenRunning";
+var TIME_PATTERN = /^([01]\d|2[0-3]):([0-5]\d)$/;
+function isValidScheduleTime(time) {
+  return typeof time === "string" && TIME_PATTERN.test(time);
+}
+function parseSchedule(raw) {
+  if (!Array.isArray(raw))
+    return [];
+  const result = [];
+  for (const item of raw) {
+    if (!item || typeof item !== "object")
+      continue;
+    const obj = item;
+    if (!isValidScheduleTime(obj.time))
+      continue;
+    if (typeof obj.prompt !== "string" || obj.prompt.trim().length === 0)
+      continue;
+    const entry = {
+      time: obj.time,
+      prompt: obj.prompt
+    };
+    if (typeof obj.label === "string" && obj.label.length > 0) {
+      entry.label = obj.label;
+    }
+    if (typeof obj.sessionId === "string" && obj.sessionId.length > 0) {
+      entry.sessionId = obj.sessionId;
+    }
+    result.push(entry);
+  }
+  return result;
+}
+function validateScheduleConfig(config) {
+  const errors = [];
+  const options = config.options ?? {};
+  const raw = options[TIMER_OPTIONS_KEY_SCHEDULE];
+  if (raw === undefined || raw === null)
+    return errors;
+  if (!Array.isArray(raw)) {
+    errors.push("Timer schedule must be an array of { time, prompt } entries");
+    return errors;
+  }
+  if (raw.length === 0) {
+    errors.push("Timer schedule must not be empty");
+    return errors;
+  }
+  raw.forEach((item, index) => {
+    if (!item || typeof item !== "object") {
+      errors.push(`Timer schedule[${index}] must be an object`);
+      return;
+    }
+    const obj = item;
+    if (!isValidScheduleTime(obj.time)) {
+      errors.push(`Timer schedule[${index}].time must be in HH:MM format (24-hour), got: ${String(obj.time)}`);
+    }
+    if (typeof obj.prompt !== "string" || obj.prompt.trim().length === 0) {
+      errors.push(`Timer schedule[${index}].prompt is required and must be a non-empty string`);
+    }
+  });
+  const seenTimes = new Set;
+  const duplicatedTimes = new Set;
+  for (const item of raw) {
+    if (!item || typeof item !== "object")
+      continue;
+    const time = item.time;
+    if (!isValidScheduleTime(time))
+      continue;
+    if (seenTimes.has(time)) {
+      duplicatedTimes.add(time);
+    }
+    seenTimes.add(time);
+  }
+  if (duplicatedTimes.size > 0) {
+    errors.push(`Timer schedule contains duplicate time entries: ${Array.from(duplicatedTimes).join(", ")}`);
+  }
+  if (config.interval !== undefined && config.interval !== null) {
+    errors.push("Timer schedule and interval are mutually exclusive: use schedule for fixed daily times, or interval for periodic triggering");
+  }
+  return errors;
+}
 
 class TimerInstance {
   config;
@@ -318,21 +400,38 @@ class TimerInstance {
   sessionId;
   getRunningTasks;
   customPrompt;
+  schedule;
+  scheduleMode;
+  invalidScheduleWarned = false;
+  scheduleSessionId;
+  skipWhenRunning;
+  firedKeys = new Set;
+  now;
   status = "created";
   timerId;
   eventHandler;
-  constructor(config, getRunningTasks) {
+  constructor(config, getRunningTasks, now) {
     this.config = config;
-    this.interval = typeof config.interval === "number" && config.interval > 0 ? config.interval : DEFAULT_TIMER_INTERVAL_MS;
+    this.now = now ?? (() => Date.now());
+    const options = config.options ?? {};
+    const rawSchedule = options[TIMER_OPTIONS_KEY_SCHEDULE];
+    const scheduleConfigured = rawSchedule !== undefined && rawSchedule !== null;
+    this.schedule = parseSchedule(rawSchedule);
+    this.scheduleMode = scheduleConfigured;
+    const isScheduleMode = this.scheduleMode;
+    this.interval = isScheduleMode ? SCHEDULE_TICK_INTERVAL_MS : typeof config.interval === "number" && config.interval > 0 ? config.interval : DEFAULT_TIMER_INTERVAL_MS;
     this.sessionId = `timer-${config.id}-${process.pid}`;
-    const optionsPrompt = config.options?.prompt;
+    const explicitSessionId = options[TIMER_OPTIONS_KEY_SESSION_ID];
+    this.scheduleSessionId = typeof explicitSessionId === "string" && explicitSessionId.length > 0 ? explicitSessionId : `timer-${config.id}`;
+    this.skipWhenRunning = options[TIMER_OPTIONS_KEY_SKIP_WHEN_RUNNING] === true;
+    const optionsPrompt = options.prompt;
     if (typeof optionsPrompt === "string" && optionsPrompt.trim().length > 0) {
       this.customPrompt = optionsPrompt;
     }
     if (getRunningTasks) {
       this.getRunningTasks = getRunningTasks;
     } else {
-      const factory = config.options?.[TIMER_OPTIONS_KEY_GET_MANAGER];
+      const factory = options[TIMER_OPTIONS_KEY_GET_MANAGER];
       if (typeof factory === "function") {
         const manager = factory();
         this.getRunningTasks = () => manager.listTasks();
@@ -341,6 +440,9 @@ class TimerInstance {
       }
     }
   }
+  get isScheduleMode() {
+    return this.scheduleMode;
+  }
   async start() {
     if (this.status === "running")
       return;
@@ -366,6 +468,10 @@ class TimerInstance {
     this.eventHandler = undefined;
   }
   tick() {
+    if (this.isScheduleMode) {
+      this.tickSchedule();
+      return;
+    }
     let allTasks;
     try {
       allTasks = this.getRunningTasks();
@@ -380,19 +486,81 @@ class TimerInstance {
     const event = this.buildSelfReminderEvent();
     this.eventHandler?.(event);
   }
-  buildSelfReminderEvent() {
-    const timestamp = Date.now();
-    const message = this.customPrompt ?? SELF_REMINDER_MESSAGE;
+  tickSchedule() {
+    if (this.schedule.length === 0) {
+      if (!this.invalidScheduleWarned) {
+        this.invalidScheduleWarned = true;
+        console.warn(`[TimerInstance] Timer ${this.config.id} has an invalid or empty schedule configuration; ` + `no events will be fired. Check options.schedule (expected [{ time: "HH:MM", prompt: "..." }]).`);
+      }
+      return;
+    }
+    const now = new Date(this.now());
+    const hh = String(now.getHours()).padStart(2, "0");
+    const mm = String(now.getMinutes()).padStart(2, "0");
+    const currentTime = `${hh}:${mm}`;
+    const dateKey = `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, "0")}-${String(now.getDate()).padStart(2, "0")}`;
+    for (const entry of this.schedule) {
+      if (entry.time !== currentTime)
+        continue;
+      const firedKey = `${dateKey}#${entry.time}`;
+      if (this.firedKeys.has(firedKey)) {
+        continue;
+      }
+      if (this.skipWhenRunning) {
+        let hasRunning = false;
+        try {
+          const allTasks = this.getRunningTasks();
+          hasRunning = Array.isArray(allTasks) && allTasks.some((t) => t.status === "running");
+        } catch (error) {
+          console.warn(`[TimerInstance] Failed to get running tasks, skipping tick: ${error}`);
+          return;
+        }
+        if (hasRunning) {
+          continue;
+        }
+      }
+      this.firedKeys.add(firedKey);
+      this.pruneFiredKeys(dateKey);
+      const event = this.buildSelfReminderEvent(entry);
+      this.eventHandler?.(event);
+      return;
+    }
+  }
+  pruneFiredKeys(currentDateKey) {
+    if (this.firedKeys.size <= 32)
+      return;
+    for (const key of this.firedKeys) {
+      const datePart = key.split("#")[0];
+      if (datePart !== currentDateKey) {
+        this.firedKeys.delete(key);
+      }
+    }
+  }
+  buildSelfReminderEvent(entry) {
+    const timestamp = this.now();
+    const message = entry?.prompt ?? this.customPrompt ?? SELF_REMINDER_MESSAGE;
+    const triggerSessionId = entry !== undefined ? entry.sessionId ?? this.scheduleSessionId : undefined;
+    const metadata = {
+      source: "event-source",
+      sourceId: this.config.id,
+      sourceMessageType: "timer.selfReminder",
+      sessionId: this.sessionId
+    };
+    if (triggerSessionId !== undefined) {
+      metadata.trigger_session_id = triggerSessionId;
+      metadata.createSessionIfMissing = true;
+    }
+    if (entry?.label !== undefined) {
+      metadata.scheduleLabel = entry.label;
+    }
+    if (entry !== undefined) {
+      metadata.scheduleTime = entry.time;
+    }
     return {
       id: `es-${this.config.id}-${timestamp}-${Math.random().toString(36).slice(2, 8)}`,
       type: "event-source.event.timer",
       timestamp,
-      metadata: {
-        source: "event-source",
-        sourceId: this.config.id,
-        sourceMessageType: "timer.selfReminder",
-        sessionId: this.sessionId
-      },
+      metadata,
       payload: {
         sourceId: this.config.id,
         sourceType: "timer",
@@ -415,6 +583,9 @@ class TimerInstance {
 __legacyDecorateClassTS([
   TracedAs("timer.tick", { recordParams: false, log: false })
 ], TimerInstance.prototype, "tick", null);
+__legacyDecorateClassTS([
+  TracedAs("timer.tickSchedule", { recordParams: false, log: false })
+], TimerInstance.prototype, "tickSchedule", null);
 __legacyDecorateClassTS([
   TracedAs("timer.buildSelfReminderEvent", { recordParams: false, log: false })
 ], TimerInstance.prototype, "buildSelfReminderEvent", null);
@@ -423,7 +594,9 @@ var timerHandler = {
   validateConfig(config) {
     const errors = [];
     const { interval } = config;
-    if (interval !== undefined && interval !== null) {
+    errors.push(...validateScheduleConfig(config));
+    const hasSchedule = config.options?.[TIMER_OPTIONS_KEY_SCHEDULE] !== undefined;
+    if (!hasSchedule && interval !== undefined && interval !== null) {
       if (typeof interval !== "number" || !Number.isFinite(interval)) {
         errors.push("Timer interval must be a finite number");
       } else if (interval <= 0) {
@@ -439,7 +612,7 @@ var timerHandler = {
     return [
       {
         name: "interval",
-        description: `Timer interval in milliseconds (default: ${DEFAULT_TIMER_INTERVAL_MS} = 10 minutes)`,
+        description: `Timer interval in milliseconds (default: ${DEFAULT_TIMER_INTERVAL_MS} = 10 minutes). Mutually exclusive with schedule.`,
         required: false,
         type: "number"
       },
@@ -448,6 +621,18 @@ var timerHandler = {
         description: "Custom prompt message for SelfReminder events (replaces default message)",
         required: false,
         type: "string"
+      },
+      {
+        name: TIMER_OPTIONS_KEY_SCHEDULE,
+        description: "JSON array of { time: 'HH:MM', prompt: string, label?: string, sessionId?: string } " + "for fixed daily trigger times (e.g. 10:00 / 17:00 / 20:00). Mutually exclusive with interval.",
+        required: false,
+        type: "string"
+      },
+      {
+        name: TIMER_OPTIONS_KEY_SESSION_ID,
+        description: "Explicit session ID for timer events (schedule mode). Events are routed to this " + "session instead of the main REPL session.",
+        required: false,
+        type: "string"
       }
     ];
   }

package/dist/shared/@ai-setting/{roy-agent-core-vs5gxgwh.js → roy-agent-core-ma35jyd9.js}

@@ -1,3 +1,9 @@
+import {
+  TASK_COMPLETE_ITEM_BY_ITEM,
+  TASK_COMPLETE_VERIFY_DUTY,
+  TASK_COMPLETION_HINT_ANCHOR
+} from "./roy-agent-core-6m4bw8jy.js";
+
 // src/env/prompt/prompts-index.ts
 var builtInPrompts = {
   default: `你是 {{agent_name}} 接待智能体（Receptionist Agent）—— {{agent_name}} 系统的智能入口。
@@ -125,7 +131,7 @@ var builtInPrompts = {
 - ✅ 功能开发、bug 修复、重构、文档生成
 - ✅ 网络搜索和研究
 
-**roy** 的提示词中内置了任务生命周期——它知道如何使用 \`task_create\`、\`task_update\`、\`task_operation_create\` 和 \`task_complete\` 来跟踪每项工作。
+**roy** 的提示词中内置了任务生命周期——它知道如何使用 \`task_create\`、\`task_update\`、\`task_operation_create\` 和 \`task_complete\` 来跟踪每项工作。task_complete 时会${TASK_COMPLETE_VERIFY_DUTY}：按子项逐条验收（${TASK_COMPLETE_ITEM_BY_ITEM}），若收到 [${TASK_COMPLETION_HINT_ANCHOR}] 必须核实并二选一（重开 / 落 decision 说明理由）。
 
 推荐使用：
 \`\`\`
@@ -893,8 +899,13 @@ Follow this lifecycle for every task:
 ┌─────────────────────────────────────────────────────────────────┐
 │ 6. COMPLETE (task_complete)                                      │
 │    - Mark task as completed (progress=100%, status=completed)   │
-│    - Verify all goals_and_expected_deliverables are met          │
-│    - Create completion operation record                          │
+│    - ${TASK_COMPLETE_ITEM_BY_ITEM}: check each goal sub-item    │
+│      against the operation-record chain + deliverable evidence  │
+│    - If a [${TASK_COMPLETION_HINT_ANCHOR}] appears in task      │
+│      context, you MUST ${TASK_COMPLETE_VERIFY_DUTY}: reopen     │
+│      (task_update status=todo) or record why it is met          │
+│      (task_operation_create decision). Never ignore it.         │
+│    - Create completion operation record                         │
 └─────────────────────────────────────────────────────────────────┘
 \`\`\`