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

package/dist/env/event-source/fallback-model-command.d.ts

@@ -0,0 +1,80 @@
+/**
+ * @fileoverview Task #4722 — `fallback-model` command
+ *
+ * 管理 `~/.roy-agent/config.jsonc` 里的兜底模型列表：
+ *
+ *   "llm": {
+ *     "fallbackModels": ["a/M1", "b/M2"]   // 有序 = 优先级，index 0 最高
+ *   }
+ *
+ * ## 与 Task #4623/#4682 的关系
+ *
+ * 现有 fallback 机制读 `llm.fallbackModel`（单字符串，见
+ * agent-component.ts 的 resolveFallbackModel）。本 command 引入
+ * `llm.fallbackModels` **数组**（有序列表），并保持向后兼容：
+ *
+ * - list：fallbackModels 数组优先；无数组时回落 fallbackModel 单值
+ * - add：单值 → 自动迁移成数组
+ *
+ * agent 侧消费数组的接线（resolveFallbackModel 读数组首项）是
+ * 后续 commit，本文件先保证 command 层读写正确。
+ *
+ * ## JSONC 注释保留
+ *
+ * config.jsonc 有用户注释，不能 parse→stringify 整文件重写
+ * （注释会丢）。用 jsonc-parser 的 modify + applyEdits 做
+ * **最小编辑**，注释原样保留。
+ */
+import type { CommandDefinition } from "./command-registry";
+/**
+ * 默认配置路径（生产环境）
+ *
+ * ★ Task #4722 round3（交叉验证第 2 轮 MINOR m7）：用 `os.homedir()` 而不是
+ *   `process.env.HOME ?? process.env.HOMEPATH ?? "~"` ——
+ *   后者在 HOME 未设置时会退化成**相对路径** `~/.roy-agent/config.jsonc`，
+ *   读写会落到当前工作目录（行为不可预期）。
+ */
+export declare const DEFAULT_CONFIG_PATH: string;
+/**
+ * 读 fallback 模型列表（有序 = 优先级）。
+ *
+ * 兼容两种存量形态：
+ * - `llm.fallbackModels`: string[]（新）
+ * - `llm.fallbackModel`: string（旧，单值）
+ *
+ * ★ Task #4722 round2（交叉验证 MINOR-6）：数组里的**非字符串 / 空串条目**
+ *   会被过滤掉（展示层要的是有效模型名），但这会造成「展示索引」与
+ *   「存储数组」的下标错位 —— 首次写入时那些无效条目会被静默删掉。
+ *   为避免这种意外数据丢失，读取时**保留原始条目位置**：
+ *   非字符串条目用空串占位（数量不变 → 下标对齐），
+ *   命令层再把空串当作「无效项」跳过。
+ */
+export declare function readFallbackModelList(configPath: string): string[];
+/**
+ * 读取**原始** fallbackModels 数组（不做任何过滤/归一化）。
+ *
+ * ★ Task #4722 round2（MINOR-6）：写回时用它，保证用户手写的异常条目
+ *   （非字符串 / 空串）**原样保留**，不会被一次 add/remove 静默删掉。
+ */
+export declare function readRawFallbackModelArray(configPath: string): unknown[];
+/**
+ * 写回 fallback 模型列表（有序 = 优先级）。
+ *
+ * 走 jsonc modify → **保留用户注释**（config.jsonc 是用户手写的，
+ * parse→stringify 重写会丢注释）。
+ *
+ * ★ Task #4722 round3（交叉验证第 2 轮 MINOR m5）：这个公开 API 与
+ *   命令层的「原始条目保留」保证保持一致 —— 写入时保留原有数组里
+ *   非字符串条目的**位置**（空串占位），不会把用户手写的异常条目删掉。
+ *   （与 add/remove/reorder 走同一条 raw 数组路径）
+ */
+export declare function writeFallbackModelList(configPath: string, list: string[]): void;
+/** fallback-model command 定义（注册进 CommandRegistry） */
+export declare const fallbackModelCommand: CommandDefinition;
+/**
+ * `list` command：`list model` → fallback-model list 的快捷方式。
+ *
+ * 用户需求示例消息是 `##command##: list model`，注册这个别名
+ * 让示例开箱即用。未来可扩展 `list <其他资源>`。
+ */
+export declare const listCommand: CommandDefinition;

package/dist/env/event-source/index.d.ts

@@ -8,6 +8,13 @@ export { EventSourceInitHooks } from "./types";
 export { BUILT_IN_EVENT_SOURCE_TYPES, BUILT_IN_EVENT_SOURCE_TYPE_LIST } from "./types";
 export { isBuiltInEventSourceType, isValidEventSourceType, getDefaultConfigForType, validateEventSourceConfig, } from "./types";
 export { EventSourceComponent } from "./event-source-component";
+export { COMMAND_PREFIX, isCommandMessage, extractCommandInvocation, CommandRegistry, getGlobalCommandRegistry, handleCommandMessage, } from "./command-registry";
+export type { CommandInvocation, CommandContext, CommandOutput, CommandTextOutput, CommandCardOutput, CommandResult, CommandDefinition, } from "./command-registry";
+export { renderTextCard, renderFallbackModelCard, isFallbackModelCard, FALLBACK_MODEL_ACTIONS, FALLBACK_MODEL_ACTION_NS, } from "./command-cards";
+export type { LarkCard } from "./command-types";
+export { isCommandCardAction, translateCardActionToCommand, handleCommandCardAction, } from "./command-card-action";
+export type { CommandCardActionEvent, CommandCardActionPorts, CommandCardActionResult, } from "./command-card-action";
+export { fallbackModelCommand, listCommand, readFallbackModelList, readRawFallbackModelArray, writeFallbackModelList, DEFAULT_CONFIG_PATH, } from "./fallback-model-command";
 export { EventStoreImpl, setSharedEventStore, getSharedEventStore, resetSharedEventStore, } from "./event-store";
 export type { EventStore, TriggerEventInput, TriggerEventMetadata, PersistedEvent, EventStoreOptions, } from "./event-store";
 export { larkCliHandler, timerHandler, bountyIMHandler, cliCommandHandler, builtInHandlers, getBuiltInHandler, extractMetadata, } from "./event-source-handlers";

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

@@ -1,19 +1,39 @@
-import"../../shared/@ai-setting/roy-agent-core-5enxfga2.js";
+import"../../shared/@ai-setting/roy-agent-core-b4x6x4k2.js";
 import {
   EventSourceComponent
-} from "../../shared/@ai-setting/roy-agent-core-e42v9bcq.js";
+} from "../../shared/@ai-setting/roy-agent-core-1kxf910n.js";
 import {
   BountyIMInstance,
+  COMMAND_PREFIX,
+  CommandRegistry,
+  DEFAULT_CONFIG_PATH,
+  FALLBACK_MODEL_ACTIONS,
+  FALLBACK_MODEL_ACTION_NS,
   TimerInstance,
   bountyIMHandler,
   buildDefaultBountyIMSystemPrompt,
   builtInHandlers,
+  extractCommandInvocation,
   extractMetadata,
+  fallbackModelCommand,
   getBuiltInHandler,
+  getGlobalCommandRegistry,
+  handleCommandCardAction,
+  handleCommandMessage,
+  isCommandCardAction,
+  isCommandMessage,
+  isFallbackModelCard,
   larkCliHandler,
+  listCommand,
+  readFallbackModelList,
+  readRawFallbackModelArray,
+  renderFallbackModelCard,
+  renderTextCard,
   resolveBountyIMSystemPrompt,
-  timerHandler
-} from "../../shared/@ai-setting/roy-agent-core-18am1h07.js";
+  timerHandler,
+  translateCardActionToCommand,
+  writeFallbackModelList
+} from "../../shared/@ai-setting/roy-agent-core-k4ps1hxp.js";
 import {
   BUILT_IN_EVENT_SOURCE_TYPES,
   BUILT_IN_EVENT_SOURCE_TYPE_LIST,
@@ -32,17 +52,18 @@ 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-f6c0nadn.js";
+import"../../shared/@ai-setting/roy-agent-core-b7jbqfsy.js";
 import {
   EventStoreImpl,
   getSharedEventStore,
   resetSharedEventStore,
   setSharedEventStore
 } from "../../shared/@ai-setting/roy-agent-core-na18zwj0.js";
-import"../../shared/@ai-setting/roy-agent-core-9bs6xrav.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-6masakz4.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";
@@ -65,28 +86,48 @@ 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";
 export {
+  writeFallbackModelList,
   validateEventSourceConfig,
+  translateCardActionToCommand,
   timerHandler,
   setSharedEventStore,
   resolveBountyIMSystemPrompt,
   resetSharedEventStore,
+  renderTextCard,
+  renderFallbackModelCard,
+  readRawFallbackModelArray,
+  readFallbackModelList,
   parseCliSessionChatId,
+  listCommand,
   larkCliHandler,
   isValidEventSourceType,
+  isFallbackModelCard,
+  isCommandMessage,
+  isCommandCardAction,
   isBuiltInEventSourceType,
+  handleCommandMessage,
+  handleCommandCardAction,
   getSharedEventStore,
+  getGlobalCommandRegistry,
   getDefaultConfigForType,
   getBuiltInHandler,
+  fallbackModelCommand,
   extractMetadata,
+  extractCommandInvocation,
   cliCommandHandler,
   builtInHandlers,
   buildDefaultBountyIMSystemPrompt,
   buildCliReplyChannel,
   bountyIMHandler,
   TimerInstance,
+  FALLBACK_MODEL_ACTION_NS,
+  FALLBACK_MODEL_ACTIONS,
   EventStoreImpl,
   EventSourceInitHooks,
   EventSourceComponent,
+  DEFAULT_CONFIG_PATH,
+  CommandRegistry,
+  COMMAND_PREFIX,
   CLI_SESSION_CHAT_ID_PREFIX,
   CLI_COMMAND_ES_TYPE,
   BountyIMInstance,

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-6z412atw.js";
+} from "../shared/@ai-setting/roy-agent-core-8zas6w5q.js";
 import {
   TaskComponent
-} from "../shared/@ai-setting/roy-agent-core-hmdcz3g9.js";
-import"../shared/@ai-setting/roy-agent-core-amkqnyzy.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-hjejpcg5.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-gxzxq1sf.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-rn57psp0.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-e42v9bcq.js";
+} from "../shared/@ai-setting/roy-agent-core-1kxf910n.js";
 import {
   builtInHandlers,
   larkCliHandler
-} from "../shared/@ai-setting/roy-agent-core-18am1h07.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-f6c0nadn.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-9bs6xrav.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-6masakz4.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,8 +68,8 @@ import"../shared/@ai-setting/roy-agent-core-jagkferh.js";
 import {
   AgentComponent,
   AgentComponentConfigSchema
-} from "../shared/@ai-setting/roy-agent-core-xhrrgfdy.js";
-import"../shared/@ai-setting/roy-agent-core-es467wsz.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";
 import {

package/dist/env/llm/index.js

@@ -13,7 +13,7 @@ import {
   createLLMAdapter,
   getLLMProviderOverride,
   setLLMProvider
-} from "../../shared/@ai-setting/roy-agent-core-rjzdj0xb.js";
+} from "../../shared/@ai-setting/roy-agent-core-02j24hrg.js";
 import"../../shared/@ai-setting/roy-agent-core-adg9ghbt.js";
 import {
   PiAiAdapter,

package/dist/env/prompt/index.js

@@ -3,8 +3,9 @@ import {
   PromptConfigSchema,
   PromptPathSchema,
   PromptRenderer
-} from "../../shared/@ai-setting/roy-agent-core-w07ymg29.js";
-import"../../shared/@ai-setting/roy-agent-core-6masakz4.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";