@ai-setting/roy-agent-core 1.7.85 → 1.7.89

package/dist/config/index.js

@@ -4,7 +4,7 @@ import {
   ConfigSourceNotFoundError,
   FileSource,
   MemorySource
-} from "../shared/@ai-setting/roy-agent-core-zxz5fkwj.js";
+} from "../shared/@ai-setting/roy-agent-core-v6yshv0z.js";
 import {
   EnvSource,
   parseJSONC,
@@ -24,12 +24,12 @@ import {
 } from "../shared/@ai-setting/roy-agent-core-2stt4rp5.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";
-import"../shared/@ai-setting/roy-agent-core-ax9e9szb.js";
-import"../shared/@ai-setting/roy-agent-core-cpcd24n2.js";
-import"../shared/@ai-setting/roy-agent-core-qqaak24r.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-m39v7qpx.js";
+import"../shared/@ai-setting/roy-agent-core-smf94h73.js";
+import"../shared/@ai-setting/roy-agent-core-yet36q5k.js";
+import"../shared/@ai-setting/roy-agent-core-tkpp1ba0.js";
+import"../shared/@ai-setting/roy-agent-core-p31ftgq9.js";
+import"../shared/@ai-setting/roy-agent-core-5s2t8z00.js";
 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";

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

@@ -202,7 +202,7 @@ export interface AgentComponentOptions {
  * @param agent 当前请求工具列表的 agent
  * @returns 过滤后的新数组（保留原数组的相对顺序）
  */
-export declare function filterToolsByAgent(tools: Tool[], agent: AgentInstance): Tool[];
+export declare function filterToolsByAgent(tools: Tool[], agent: AgentInstance, extendTools?: string[]): Tool[];
 /**
  * 构建一次 Agent run 的 EnvContext（effectiveContext + 父级 ALS 继承）。
  *

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

@@ -7,26 +7,27 @@ import {
   filterToolsByAgent,
   parseToolList,
   toLLMMessage
-} from "../../shared/@ai-setting/roy-agent-core-dkrvmjsh.js";
-import"../../shared/@ai-setting/roy-agent-core-ze5cqpf2.js";
+} from "../../shared/@ai-setting/roy-agent-core-tpm1dd1g.js";
+import"../../shared/@ai-setting/roy-agent-core-mx855td4.js";
 import"../../shared/@ai-setting/roy-agent-core-jvv2h3d6.js";
-import"../../shared/@ai-setting/roy-agent-core-ed233k5z.js";
+import"../../shared/@ai-setting/roy-agent-core-v1n0106v.js";
 import"../../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
-import"../../shared/@ai-setting/roy-agent-core-h21gngxf.js";
-import"../../shared/@ai-setting/roy-agent-core-0snm5hc5.js";
-import"../../shared/@ai-setting/roy-agent-core-fghc2m8z.js";
+import"../../shared/@ai-setting/roy-agent-core-7yh5wps0.js";
+import"../../shared/@ai-setting/roy-agent-core-y6shd91r.js";
+import"../../shared/@ai-setting/roy-agent-core-aa8kv18f.js";
+import"../../shared/@ai-setting/roy-agent-core-wxrkcb17.js";
 import"../../shared/@ai-setting/roy-agent-core-zjdzk1gg.js";
 import"../../shared/@ai-setting/roy-agent-core-c1v263jn.js";
 import"../../shared/@ai-setting/roy-agent-core-ntn32q7j.js";
 import"../../shared/@ai-setting/roy-agent-core-mkc3zshb.js";
 import"../../shared/@ai-setting/roy-agent-core-ctdhjv68.js";
 import"../../shared/@ai-setting/roy-agent-core-7hh0brvs.js";
-import"../../shared/@ai-setting/roy-agent-core-pgvcf91v.js";
-import"../../shared/@ai-setting/roy-agent-core-ax9e9szb.js";
-import"../../shared/@ai-setting/roy-agent-core-cpcd24n2.js";
-import"../../shared/@ai-setting/roy-agent-core-qqaak24r.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-m39v7qpx.js";
+import"../../shared/@ai-setting/roy-agent-core-smf94h73.js";
+import"../../shared/@ai-setting/roy-agent-core-yet36q5k.js";
+import"../../shared/@ai-setting/roy-agent-core-tkpp1ba0.js";
+import"../../shared/@ai-setting/roy-agent-core-p31ftgq9.js";
+import"../../shared/@ai-setting/roy-agent-core-5s2t8z00.js";
 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";

package/dist/env/agent/index.js

@@ -4,26 +4,27 @@ import {
 import {
   AgentComponent,
   AgentComponentConfigSchema
-} from "../../shared/@ai-setting/roy-agent-core-dkrvmjsh.js";
-import"../../shared/@ai-setting/roy-agent-core-ze5cqpf2.js";
+} from "../../shared/@ai-setting/roy-agent-core-tpm1dd1g.js";
+import"../../shared/@ai-setting/roy-agent-core-mx855td4.js";
 import"../../shared/@ai-setting/roy-agent-core-jvv2h3d6.js";
-import"../../shared/@ai-setting/roy-agent-core-ed233k5z.js";
+import"../../shared/@ai-setting/roy-agent-core-v1n0106v.js";
 import"../../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
-import"../../shared/@ai-setting/roy-agent-core-h21gngxf.js";
-import"../../shared/@ai-setting/roy-agent-core-0snm5hc5.js";
-import"../../shared/@ai-setting/roy-agent-core-fghc2m8z.js";
+import"../../shared/@ai-setting/roy-agent-core-7yh5wps0.js";
+import"../../shared/@ai-setting/roy-agent-core-y6shd91r.js";
+import"../../shared/@ai-setting/roy-agent-core-aa8kv18f.js";
+import"../../shared/@ai-setting/roy-agent-core-wxrkcb17.js";
 import"../../shared/@ai-setting/roy-agent-core-zjdzk1gg.js";
 import"../../shared/@ai-setting/roy-agent-core-c1v263jn.js";
 import"../../shared/@ai-setting/roy-agent-core-ntn32q7j.js";
 import"../../shared/@ai-setting/roy-agent-core-mkc3zshb.js";
 import"../../shared/@ai-setting/roy-agent-core-ctdhjv68.js";
 import"../../shared/@ai-setting/roy-agent-core-7hh0brvs.js";
-import"../../shared/@ai-setting/roy-agent-core-pgvcf91v.js";
-import"../../shared/@ai-setting/roy-agent-core-ax9e9szb.js";
-import"../../shared/@ai-setting/roy-agent-core-cpcd24n2.js";
-import"../../shared/@ai-setting/roy-agent-core-qqaak24r.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-m39v7qpx.js";
+import"../../shared/@ai-setting/roy-agent-core-smf94h73.js";
+import"../../shared/@ai-setting/roy-agent-core-yet36q5k.js";
+import"../../shared/@ai-setting/roy-agent-core-tkpp1ba0.js";
+import"../../shared/@ai-setting/roy-agent-core-p31ftgq9.js";
+import"../../shared/@ai-setting/roy-agent-core-5s2t8z00.js";
 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";

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

@@ -145,6 +145,20 @@ export interface AgentContext {
     pluginEnabled?: Record<string, boolean>;
     /** 额外工具列表（上下文级别，会追加到可用工具列表末尾） */
     extraTools?: import("../tool/types").Tool[];
+    /**
+     * ★ Task #5333 — 放行的 channel-only 工具名单（会话渠道上下文）。
+     *
+     * 由事件源驱动的一轮对话注入（EventSourceConfig.extendTools →
+     * evt.metadata.extendTools → agentContext.extendTools）。
+     *
+     * `tool.metadata.channelOnly === true` 的工具只有名字出现在这里时才可见；
+     * 未标记 channelOnly 的工具完全不受影响。
+     *
+     * 典型：企微 ES 注入 `["wecom_respond"]`，于是处理企微事件的 agent
+     * （可能是 default）能看到 wecom_respond；而同名 default agent
+     * 在交互式 CLI / 飞书会话里看不到它。
+     */
+    extendTools?: string[];
     /** 是否将 ReAct 消息持久化到 session DB（默认 true）。
      *  设为 false 时，agent run 仍会读取 session history，但不会写入新消息。
      *  用于子 agent 复用父 session 的 history 但不污染 session DB。 */

package/dist/env/commands/index.js

@@ -1,13 +1,13 @@
 import {
   CommandsComponent
-} from "../../shared/@ai-setting/roy-agent-core-g8htfwxj.js";
+} from "../../shared/@ai-setting/roy-agent-core-7f10p7m2.js";
 import"../../shared/@ai-setting/roy-agent-core-7hh0brvs.js";
-import"../../shared/@ai-setting/roy-agent-core-pgvcf91v.js";
-import"../../shared/@ai-setting/roy-agent-core-ax9e9szb.js";
-import"../../shared/@ai-setting/roy-agent-core-cpcd24n2.js";
-import"../../shared/@ai-setting/roy-agent-core-qqaak24r.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-m39v7qpx.js";
+import"../../shared/@ai-setting/roy-agent-core-smf94h73.js";
+import"../../shared/@ai-setting/roy-agent-core-yet36q5k.js";
+import"../../shared/@ai-setting/roy-agent-core-tkpp1ba0.js";
+import"../../shared/@ai-setting/roy-agent-core-p31ftgq9.js";
+import"../../shared/@ai-setting/roy-agent-core-5s2t8z00.js";
 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";

package/dist/env/context/index.js

@@ -1,6 +1,6 @@
 import {
   init_context
-} from "../../shared/@ai-setting/roy-agent-core-qqaak24r.js";
+} from "../../shared/@ai-setting/roy-agent-core-tkpp1ba0.js";
 import {
   EVENT_ENV_PREFIX,
   createEnvContext,
@@ -24,8 +24,8 @@ import {
   runWithEnvContextAsync,
   serializeEventToEnv,
   setCurrentTaskId
-} from "../../shared/@ai-setting/roy-agent-core-7cbpmk4q.js";
-import"../../shared/@ai-setting/roy-agent-core-qq96p0tj.js";
+} from "../../shared/@ai-setting/roy-agent-core-p31ftgq9.js";
+import"../../shared/@ai-setting/roy-agent-core-5s2t8z00.js";
 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";

package/dist/env/debug/index.js

@@ -4,18 +4,18 @@ import {
   RegexParser,
   SpanBuilder,
   SpanDbReader
-} from "../../shared/@ai-setting/roy-agent-core-87942bw4.js";
+} from "../../shared/@ai-setting/roy-agent-core-1mhyh4c5.js";
 import {
   ReplFormatter,
   TraceFormatter,
   TreeFormatter
 } from "../../shared/@ai-setting/roy-agent-core-rvv6ydff.js";
-import"../../shared/@ai-setting/roy-agent-core-pgvcf91v.js";
-import"../../shared/@ai-setting/roy-agent-core-ax9e9szb.js";
-import"../../shared/@ai-setting/roy-agent-core-cpcd24n2.js";
-import"../../shared/@ai-setting/roy-agent-core-qqaak24r.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-m39v7qpx.js";
+import"../../shared/@ai-setting/roy-agent-core-smf94h73.js";
+import"../../shared/@ai-setting/roy-agent-core-yet36q5k.js";
+import"../../shared/@ai-setting/roy-agent-core-tkpp1ba0.js";
+import"../../shared/@ai-setting/roy-agent-core-p31ftgq9.js";
+import"../../shared/@ai-setting/roy-agent-core-5s2t8z00.js";
 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";

package/dist/env/error-reply.js

@@ -8,7 +8,7 @@ import {
   getFailureRuleIds,
   humanizeRetryAfter,
   notifyReactFailure
-} from "../shared/@ai-setting/roy-agent-core-rykf7c04.js";
+} from "../shared/@ai-setting/roy-agent-core-9c565frx.js";
 import"../shared/@ai-setting/roy-agent-core-ntn32q7j.js";
 import"../shared/@ai-setting/roy-agent-core-m880qz3y.js";
 import"../shared/@ai-setting/roy-agent-core-7f7t9wwp.js";

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

@@ -9,6 +9,20 @@ import type { EventSourceConfig, EventSourceHandler, EventSourceInstance, EventS
 import { timerHandler } from "./timer-handler";
 import { bountyIMHandler } from "./bounty-im-handler";
 import { bountyCliHandler } from "./bounty-cli-handler";
+/**
+ * ★ Task #5473：从原始 event 提取 agent 回复必需的精简字段。
+ *
+ * 保留：chat_id / message_id / sender_id / chat_type / content / mentions
+ * 删除：createTime / updateTime / type / event_id / timestamp / id /
+ *       message_type / sender_type（及其他所有冗余栏位）
+ *
+ * 支持两种格式：
+ * - 简化格式（lark-cli consume）：顶层 chat_id / message_id / sender_id
+ * - 嵌套格式（webhook）：event.message.* / event.sender.sender_id.*
+ *
+ * 纯函数：不修改 rawEvent 本身（payload.rawEvent 仍持有完整原始 event）。
+ */
+export declare function buildSlimRawData(rawEvent: unknown): Record<string, unknown>;
 /**
  * 构建 Lark `im.message.receive_v1` 事件推荐动作 prompt (Task #2185 / #4137 / #4242)
  *
@@ -55,6 +69,7 @@ export declare function buildLarkRecommendedAction(opts: {
     appId?: string;
     chatId?: string;
     messageId?: string;
+    senderId?: string;
 }): RecommendedAction;
 /**
  * 渠道静态规则章节标题（system prompt 与 lean 卡片互相指认的锚点）
@@ -71,9 +86,10 @@ export declare const LARK_CHANNEL_PROMPT_SECTION_TITLE = "\u2B50 \u98DE\u4E66\u5
  * 但「各加一节」式回归会立刻超。改动相关章节前先量长度，
  * 改完必须跑 lark-channel-system-prompt.test.ts (G) 组守护测试。
  * （历史：旧 action 模板 ~4486 → profile=tongzhuli 时 4745 → #5164 追加
- *  文档交付规范段后 4991 → #5212 追加引用上下文段后 5287。）
+ *  文档交付规范段后 4991 → #5212 追加引用上下文段后 5287 →
+ *  #5472 关键 1 追加群聊 @ sender 可跑示例后 5808，预算 5300→5900。）
  */
-export declare const LARK_PROMPT_LENGTH_BUDGET = 5300;
+export declare const LARK_PROMPT_LENGTH_BUDGET = 5900;
 /**
  * 构建飞书渠道级 system prompt（ES-M1 lean 模式核心）。
  *

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

@@ -6,6 +6,7 @@ import {
   bountyIMHandler,
   buildLarkChannelSystemPrompt,
   buildLarkRecommendedAction,
+  buildSlimRawData,
   builtInHandlers,
   extractCommandText,
   extractMetadata,
@@ -16,41 +17,44 @@ import {
   resolveLarkChannelSystemPrompt,
   timerHandler,
   wecomCliHandler
-} from "../../shared/@ai-setting/roy-agent-core-xf6z96qy.js";
+} from "../../shared/@ai-setting/roy-agent-core-4b38m749.js";
 import"../../shared/@ai-setting/roy-agent-core-vx8zc847.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-age3qseb.js";
+import"../../shared/@ai-setting/roy-agent-core-mf5p38yf.js";
 import"../../shared/@ai-setting/roy-agent-core-2stt4rp5.js";
-import"../../shared/@ai-setting/roy-agent-core-b31v3qpv.js";
-import"../../shared/@ai-setting/roy-agent-core-m3vjepzz.js";
-import"../../shared/@ai-setting/roy-agent-core-na18zwj0.js";
-import"../../shared/@ai-setting/roy-agent-core-9vxh6f8h.js";
-import"../../shared/@ai-setting/roy-agent-core-ezvpreqz.js";
+import"../../shared/@ai-setting/roy-agent-core-k3h8t4q1.js";
+import"../../shared/@ai-setting/roy-agent-core-h1e1fm9b.js";
+import"../../shared/@ai-setting/roy-agent-core-c4ec7k0p.js";
+import"../../shared/@ai-setting/roy-agent-core-4t3yskp8.js";
+import"../../shared/@ai-setting/roy-agent-core-y7fqtzk2.js";
 import"../../shared/@ai-setting/roy-agent-core-1pg0fepg.js";
-import"../../shared/@ai-setting/roy-agent-core-tr3ep81v.js";
+import"../../shared/@ai-setting/roy-agent-core-d6zdbgtc.js";
 import"../../shared/@ai-setting/roy-agent-core-m46fe3x4.js";
 import"../../shared/@ai-setting/roy-agent-core-4rtg69cn.js";
-import"../../shared/@ai-setting/roy-agent-core-d1n4jbza.js";
-import"../../shared/@ai-setting/roy-agent-core-7dd0s3xb.js";
-import"../../shared/@ai-setting/roy-agent-core-rykf7c04.js";
-import"../../shared/@ai-setting/roy-agent-core-c2gbt68e.js";
-import"../../shared/@ai-setting/roy-agent-core-1v4g0d4x.js";
-import"../../shared/@ai-setting/roy-agent-core-cgtq6427.js";
+import"../../shared/@ai-setting/roy-agent-core-5dhvfgaw.js";
+import"../../shared/@ai-setting/roy-agent-core-0n1wwndq.js";
+import"../../shared/@ai-setting/roy-agent-core-418zc9ha.js";
+import"../../shared/@ai-setting/roy-agent-core-m66ysky0.js";
+import"../../shared/@ai-setting/roy-agent-core-9c565frx.js";
+import"../../shared/@ai-setting/roy-agent-core-h83zdsrq.js";
+import"../../shared/@ai-setting/roy-agent-core-rm7seqwb.js";
+import"../../shared/@ai-setting/roy-agent-core-e08bvpaq.js";
 import"../../shared/@ai-setting/roy-agent-core-er070zjq.js";
-import"../../shared/@ai-setting/roy-agent-core-h21gngxf.js";
+import"../../shared/@ai-setting/roy-agent-core-7yh5wps0.js";
 import"../../shared/@ai-setting/roy-agent-core-ntn32q7j.js";
 import"../../shared/@ai-setting/roy-agent-core-mkc3zshb.js";
 import"../../shared/@ai-setting/roy-agent-core-az13yzmc.js";
 import"../../shared/@ai-setting/roy-agent-core-m880qz3y.js";
 import"../../shared/@ai-setting/roy-agent-core-7hh0brvs.js";
-import"../../shared/@ai-setting/roy-agent-core-pgvcf91v.js";
-import"../../shared/@ai-setting/roy-agent-core-ax9e9szb.js";
-import"../../shared/@ai-setting/roy-agent-core-cpcd24n2.js";
-import"../../shared/@ai-setting/roy-agent-core-qqaak24r.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-m39v7qpx.js";
+import"../../shared/@ai-setting/roy-agent-core-smf94h73.js";
+import"../../shared/@ai-setting/roy-agent-core-yet36q5k.js";
+import"../../shared/@ai-setting/roy-agent-core-tkpp1ba0.js";
+import"../../shared/@ai-setting/roy-agent-core-p31ftgq9.js";
+import"../../shared/@ai-setting/roy-agent-core-5s2t8z00.js";
 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";
@@ -66,6 +70,7 @@ export {
   extractCommandText,
   cliCommandHandler,
   builtInHandlers,
+  buildSlimRawData,
   buildLarkRecommendedAction,
   buildLarkChannelSystemPrompt,
   bountyIMHandler,

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

@@ -4,8 +4,8 @@ import {
   getSharedEventStore,
   resetSharedEventStore,
   setSharedEventStore
-} from "../../shared/@ai-setting/roy-agent-core-na18zwj0.js";
-import"../../shared/@ai-setting/roy-agent-core-qq96p0tj.js";
+} from "../../shared/@ai-setting/roy-agent-core-4t3yskp8.js";
+import"../../shared/@ai-setting/roy-agent-core-5s2t8z00.js";
 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";

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

@@ -1,7 +1,7 @@
 import"../../shared/@ai-setting/roy-agent-core-m1fgtnrc.js";
 import {
   EventSourceComponent
-} from "../../shared/@ai-setting/roy-agent-core-begm7ytz.js";
+} from "../../shared/@ai-setting/roy-agent-core-m7d1t3db.js";
 import {
   BountyIMInstance,
   COMMAND_PREFIX,
@@ -56,7 +56,7 @@ import {
   translateCardActionToCommand,
   wecomCliHandler,
   writeFallbackModelList
-} from "../../shared/@ai-setting/roy-agent-core-xf6z96qy.js";
+} from "../../shared/@ai-setting/roy-agent-core-4b38m749.js";
 import {
   BUILT_IN_EVENT_SOURCE_TYPES,
   BUILT_IN_EVENT_SOURCE_TYPE_LIST,
@@ -73,41 +73,44 @@ import {
   cliCommandHandler,
   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-age3qseb.js";
+import"../../shared/@ai-setting/roy-agent-core-mf5p38yf.js";
 import"../../shared/@ai-setting/roy-agent-core-2stt4rp5.js";
-import"../../shared/@ai-setting/roy-agent-core-b31v3qpv.js";
-import"../../shared/@ai-setting/roy-agent-core-m3vjepzz.js";
+import"../../shared/@ai-setting/roy-agent-core-k3h8t4q1.js";
+import"../../shared/@ai-setting/roy-agent-core-h1e1fm9b.js";
+import"../../shared/@ai-setting/roy-agent-core-c4ec7k0p.js";
 import {
   EventStoreImpl,
   getSharedEventStore,
   resetSharedEventStore,
   setSharedEventStore
-} from "../../shared/@ai-setting/roy-agent-core-na18zwj0.js";
-import"../../shared/@ai-setting/roy-agent-core-9vxh6f8h.js";
-import"../../shared/@ai-setting/roy-agent-core-ezvpreqz.js";
+} from "../../shared/@ai-setting/roy-agent-core-4t3yskp8.js";
+import"../../shared/@ai-setting/roy-agent-core-y7fqtzk2.js";
 import"../../shared/@ai-setting/roy-agent-core-1pg0fepg.js";
-import"../../shared/@ai-setting/roy-agent-core-tr3ep81v.js";
+import"../../shared/@ai-setting/roy-agent-core-d6zdbgtc.js";
 import"../../shared/@ai-setting/roy-agent-core-m46fe3x4.js";
 import"../../shared/@ai-setting/roy-agent-core-4rtg69cn.js";
-import"../../shared/@ai-setting/roy-agent-core-d1n4jbza.js";
-import"../../shared/@ai-setting/roy-agent-core-7dd0s3xb.js";
-import"../../shared/@ai-setting/roy-agent-core-rykf7c04.js";
-import"../../shared/@ai-setting/roy-agent-core-c2gbt68e.js";
-import"../../shared/@ai-setting/roy-agent-core-1v4g0d4x.js";
-import"../../shared/@ai-setting/roy-agent-core-cgtq6427.js";
+import"../../shared/@ai-setting/roy-agent-core-5dhvfgaw.js";
+import"../../shared/@ai-setting/roy-agent-core-0n1wwndq.js";
+import"../../shared/@ai-setting/roy-agent-core-418zc9ha.js";
+import"../../shared/@ai-setting/roy-agent-core-m66ysky0.js";
+import"../../shared/@ai-setting/roy-agent-core-9c565frx.js";
+import"../../shared/@ai-setting/roy-agent-core-h83zdsrq.js";
+import"../../shared/@ai-setting/roy-agent-core-rm7seqwb.js";
+import"../../shared/@ai-setting/roy-agent-core-e08bvpaq.js";
 import"../../shared/@ai-setting/roy-agent-core-er070zjq.js";
-import"../../shared/@ai-setting/roy-agent-core-h21gngxf.js";
+import"../../shared/@ai-setting/roy-agent-core-7yh5wps0.js";
 import"../../shared/@ai-setting/roy-agent-core-ntn32q7j.js";
 import"../../shared/@ai-setting/roy-agent-core-mkc3zshb.js";
 import"../../shared/@ai-setting/roy-agent-core-az13yzmc.js";
 import"../../shared/@ai-setting/roy-agent-core-m880qz3y.js";
 import"../../shared/@ai-setting/roy-agent-core-7hh0brvs.js";
-import"../../shared/@ai-setting/roy-agent-core-pgvcf91v.js";
-import"../../shared/@ai-setting/roy-agent-core-ax9e9szb.js";
-import"../../shared/@ai-setting/roy-agent-core-cpcd24n2.js";
-import"../../shared/@ai-setting/roy-agent-core-qqaak24r.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-m39v7qpx.js";
+import"../../shared/@ai-setting/roy-agent-core-smf94h73.js";
+import"../../shared/@ai-setting/roy-agent-core-yet36q5k.js";
+import"../../shared/@ai-setting/roy-agent-core-tkpp1ba0.js";
+import"../../shared/@ai-setting/roy-agent-core-p31ftgq9.js";
+import"../../shared/@ai-setting/roy-agent-core-5s2t8z00.js";
 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";

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

@@ -25,6 +25,29 @@ export declare const DEFAULT_TIMER_INTERVAL_MS: number;
  * 2. 便于测试时注入 mock
  */
 export type GetRunningTasksFn = () => BackgroundTask[];
+/**
+ * ★ Task #5409：tick 的两种触发模式（写进 `timer.tick.fire` span 的 mode 属性）
+ */
+export type TimerFireMode = "interval" | "schedule";
+/**
+ * ★ Task #5409：tick 统计（跳过 / 触发计数）
+ *
+ * 为什么需要：修复后**空转 tick 不再留 trace**（原来每 30 秒一条 `timer.tick`，
+ * 每天约 2880 条无价值 span，全部 0ms）。代价是「被跳过的 tick」在 trace 里
+ * 不可见，无法再靠 `debug trace --list` 判断 timer 是否活着。
+ *
+ * 因此把可观测性改到**进程内计数器**：`getTickStats()` 可随时读取，
+ * 另外每次真正 fire 的 span 上会带 `skippedSinceLastFire` —— 一眼看出
+ * 「这个 timer 一直在跑，只是长期被 running 任务挡住」。
+ */
+export interface TimerTickStats {
+    /** 累计真正 fire（构建并投递 SelfReminder 事件）的次数 */
+    firedTicks: number;
+    /** 累计被跳过的 tick 次数（有 running 任务 / 抛错 / 时刻不命中 / 当日去重） */
+    skippedTicks: number;
+    /** 距离上次 fire 之间被跳过的 tick 次数（fire 后归零） */
+    skippedSinceLastFire: number;
+}
 /**
  * 用于注入 BackgroundTaskManager 的 options key
  */
@@ -51,6 +74,29 @@ export interface TimerScheduleEntry {
     label?: string;
     sessionId?: string;
 }
+/**
+ * ★ Task #5409：`fireTick()` 的入参（object 形式，便于 paramFilter 取出全部字段）
+ */
+export interface TimerFireContext {
+    /** 触发模式 */
+    mode: TimerFireMode;
+    /** timer 事件源 id（`this.config.id`）—— paramFilter 拿不到 this，故显式传入 */
+    sourceId: string;
+    /** 距上次 fire 被跳过的 tick 次数 */
+    skippedSinceLastFire: number;
+    /** schedule 模式的命中项 */
+    entry?: TimerScheduleEntry;
+}
+/**
+ * ★ Task #5409：构造 `timer.tick.fire` span 的属性（供 paramFilter 摊平到顶层）
+ *
+ * 出参键名就是 `debug trace` / `debug span` 里能直接看到的字段：
+ * - `mode`：interval / schedule
+ * - `sourceId`：timer 事件源 id（哪个 timer 触发的）
+ * - `skippedSinceLastFire`：距上次 fire 被跳过的 tick 次数
+ * - `scheduleTime` / `scheduleLabel`：schedule 模式的命中项
+ */
+export declare function buildFireSpanAttributes(ctx: TimerFireContext): Record<string, unknown>;
 /**
  * 校验 `HH:MM` 格式
  *
@@ -100,6 +146,10 @@ export declare class TimerInstance implements EventSourceInstance {
     private readonly skipWhenRunning;
     /** 已触发标记：`YYYY-MM-DD#HH:MM` → true（当日去重） */
     private readonly firedKeys;
+    /** ★ Task #5409：tick 统计（跳过/触发计数），替代原「每次都留 trace」的可观测性 */
+    private firedTicks;
+    private skippedTicks;
+    private skippedSinceLastFire;
     /** 可注入时钟（测试用） */
     private readonly now;
     private status;
@@ -117,14 +167,54 @@ export declare class TimerInstance implements EventSourceInstance {
     start(): Promise<void>;
     stop(): Promise<void>;
     getStatus(): EventSourceStatus;
+    /**
+     * ★ Task #5409：读取 tick 统计（跳过 / 触发计数）
+     *
+     * 修复后空转 tick 不再落 trace，用这个计数器保留「timer 还活着」的可观测性：
+     * - `firedTicks` 一直为 0 且 `skippedTicks` 持续增长 → 一直被 running 任务挡住
+     * - 两者都不再增长 → tick 本身可能没在跑（`getStatus()` 应为 running）
+     */
+    getTickStats(): TimerTickStats;
     onEvent(handler: EventSourceEventHandler): void;
     offEvent(): void;
     /**
      * 定时器 tick 回调
      *
      * Rule-based 检查：有 status === "running" 的后台任务时跳过本次触发
+     *
+     * ★ Task #5409：**入口不再挂 `@TracedAs`**。
+     *
+     * 原来 `@TracedAs("timer.tick")` 在入口就建 span，于是「有 running 任务 →
+     * return」这种什么都没做的空转 tick 也会落一条 trace。生产实测每 30 秒一条、
+     * 全部 0ms/ok，每天约 2880 条，是 traces.db 膨胀的增量来源之一。
+     *
+     * 现在只有**真正 fire 了 SelfReminder 事件**才记一条 `timer.tick.fire`
+     * （见 `fireTick()`），跳过路径零 trace；跳过次数改由 `getTickStats()` 暴露。
      */
     private tick;
+    /**
+     * ★ Task #5409：记录一次「被跳过」的 tick（零 trace）
+     *
+     * 可观测性走两条路：
+     * 1. 进程内计数器（`getTickStats()`）—— 供 `/status` 类排查直接读
+     * 2. 每累计 `SKIPPED_TICK_LOG_EVERY` 次打一条 debug 汇总日志 —— 供 app.log
+     *    确认 timer 仍在跑（`log_trace.logging.level=debug` 时可见）
+     */
+    private recordSkip;
+    /**
+     * ★ Task #5409：真正 fire 一次的**唯一入口** —— 事件构建 + 投递 + 1 条 trace
+     *
+     * 命名 `timer.tick.fire`（而不是保留 `timer.tick`）：trace 列表里一眼能看出
+     * 「这条 span 代表 timer 真的触发了」，不再是「tick 发生了但可能什么都没做」。
+     *
+     * span 属性（经 paramFilter 摊平到顶层）：
+     * - `mode`：interval / schedule
+     * - `sourceId`：timer 事件源 id
+     * - `skippedSinceLastFire`：距上次 fire 被跳过的次数 —— 长期被 running 任务
+     *   挡住时这个数字会很大，是「空转但不留 trace」的可观测证据
+     * - `scheduleTime` / `scheduleLabel`：schedule 模式下的命中项
+     */
+    private fireTick;
     /**
      * ★ Task #4815：schedule 模式 tick
      *
@@ -135,6 +225,10 @@ export declare class TimerInstance implements EventSourceInstance {
      * 4. schedule 模式默认**不**做 rule-based 跳过；
      *    仅当 options.skipWhenRunning=true 时才检查后台任务
      * 5. 命中 → 标记已触发 + 构建事件（prompt 取当次命中项）
+     *
+     * ★ Task #5409：入口不再挂 `@TracedAs`。只有真正命中并 fire 时才由
+     * `fireTick()` 落一条 `timer.tick.fire`（mode=schedule）；未命中 / 当日已触发 /
+     * 被 running 任务挡住 / schedule 全项非法 → 零 trace，只累加 `skippedTicks`。
      */
     private tickSchedule;
     /**
@@ -157,6 +251,10 @@ export declare class TimerInstance implements EventSourceInstance {
      *   - metadata 注入 `scheduleLabel`（可选，便于下游识别是哪个时刻）
      *
      * @param entry 命中的 schedule 项；interval 模式不传
+     *
+     * ★ Task #5409：不再挂 `@TracedAs` —— 它只在 `fireTick()` 内部被调用一次，
+     * 且 fireTick 已经有 `timer.tick.fire` span。原来这里再加一个装饰器，
+     * 会让「一次 fire」落 2 条 span（实测 span 数交替 2/3 正是这个原因）。
      */
     private buildSelfReminderEvent;
 }