@ai-setting/roy-agent-core 1.7.58 → 1.7.61

package/dist/config/index.js

@@ -4,7 +4,7 @@ import {
   ConfigSourceNotFoundError,
   FileSource,
   MemorySource
-} from "../shared/@ai-setting/roy-agent-core-20m8je6e.js";
+} from "../shared/@ai-setting/roy-agent-core-9k8ms63r.js";
 import {
   EnvSource,
   parseJSONC,
@@ -15,13 +15,13 @@ import {
 } from "../shared/@ai-setting/roy-agent-core-adg9ghbt.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-0kn3zt1t.js";
-import"../shared/@ai-setting/roy-agent-core-ytd5eztz.js";
-import"../shared/@ai-setting/roy-agent-core-yphwdm9x.js";
-import"../shared/@ai-setting/roy-agent-core-m97jn2ra.js";
-import"../shared/@ai-setting/roy-agent-core-syyw58p9.js";
-import"../shared/@ai-setting/roy-agent-core-8p63s836.js";
-import"../shared/@ai-setting/roy-agent-core-rt115qfc.js";
+import"../shared/@ai-setting/roy-agent-core-9s3payp1.js";
+import"../shared/@ai-setting/roy-agent-core-expvav8a.js";
+import"../shared/@ai-setting/roy-agent-core-ajmgyawx.js";
+import"../shared/@ai-setting/roy-agent-core-bdzdw1g3.js";
+import"../shared/@ai-setting/roy-agent-core-qrjs2500.js";
+import"../shared/@ai-setting/roy-agent-core-2qkrpc7m.js";
+import"../shared/@ai-setting/roy-agent-core-y0k9kaxz.js";
 import"../shared/@ai-setting/roy-agent-core-jnszp0jq.js";
 import"../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";
 export {

package/dist/env/agent/index.js

@@ -2,26 +2,26 @@ import {
   AgentComponent,
   AgentComponentConfigSchema,
   SummaryAgent
-} from "../../shared/@ai-setting/roy-agent-core-eanq305k.js";
-import"../../shared/@ai-setting/roy-agent-core-fw6k4w1h.js";
-import"../../shared/@ai-setting/roy-agent-core-n0p0hwgd.js";
-import"../../shared/@ai-setting/roy-agent-core-ygn5tzt1.js";
+} from "../../shared/@ai-setting/roy-agent-core-yr5eqyhz.js";
+import"../../shared/@ai-setting/roy-agent-core-pj5tfmn5.js";
+import"../../shared/@ai-setting/roy-agent-core-kfmrfaft.js";
+import"../../shared/@ai-setting/roy-agent-core-dythsgkn.js";
 import"../../shared/@ai-setting/roy-agent-core-qxnbvgwe.js";
-import"../../shared/@ai-setting/roy-agent-core-gksw1gjb.js";
-import"../../shared/@ai-setting/roy-agent-core-ge87xbas.js";
-import"../../shared/@ai-setting/roy-agent-core-e1w17tht.js";
+import"../../shared/@ai-setting/roy-agent-core-hf0t8agb.js";
+import"../../shared/@ai-setting/roy-agent-core-jsdqzfbj.js";
+import"../../shared/@ai-setting/roy-agent-core-m2tv4pj0.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-e25xkv53.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-0kn3zt1t.js";
-import"../../shared/@ai-setting/roy-agent-core-ytd5eztz.js";
-import"../../shared/@ai-setting/roy-agent-core-yphwdm9x.js";
-import"../../shared/@ai-setting/roy-agent-core-m97jn2ra.js";
-import"../../shared/@ai-setting/roy-agent-core-syyw58p9.js";
-import"../../shared/@ai-setting/roy-agent-core-8p63s836.js";
-import"../../shared/@ai-setting/roy-agent-core-rt115qfc.js";
+import"../../shared/@ai-setting/roy-agent-core-9s3payp1.js";
+import"../../shared/@ai-setting/roy-agent-core-expvav8a.js";
+import"../../shared/@ai-setting/roy-agent-core-ajmgyawx.js";
+import"../../shared/@ai-setting/roy-agent-core-bdzdw1g3.js";
+import"../../shared/@ai-setting/roy-agent-core-qrjs2500.js";
+import"../../shared/@ai-setting/roy-agent-core-2qkrpc7m.js";
+import"../../shared/@ai-setting/roy-agent-core-y0k9kaxz.js";
 import"../../shared/@ai-setting/roy-agent-core-jnszp0jq.js";
 import"../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";
 export {

package/dist/env/commands/index.js

@@ -1,14 +1,14 @@
 import {
   CommandsComponent
-} from "../../shared/@ai-setting/roy-agent-core-t64nmayv.js";
+} from "../../shared/@ai-setting/roy-agent-core-mw0bc9g6.js";
 import"../../shared/@ai-setting/roy-agent-core-7hh0brvs.js";
-import"../../shared/@ai-setting/roy-agent-core-0kn3zt1t.js";
-import"../../shared/@ai-setting/roy-agent-core-ytd5eztz.js";
-import"../../shared/@ai-setting/roy-agent-core-yphwdm9x.js";
-import"../../shared/@ai-setting/roy-agent-core-m97jn2ra.js";
-import"../../shared/@ai-setting/roy-agent-core-syyw58p9.js";
-import"../../shared/@ai-setting/roy-agent-core-8p63s836.js";
-import"../../shared/@ai-setting/roy-agent-core-rt115qfc.js";
+import"../../shared/@ai-setting/roy-agent-core-9s3payp1.js";
+import"../../shared/@ai-setting/roy-agent-core-expvav8a.js";
+import"../../shared/@ai-setting/roy-agent-core-ajmgyawx.js";
+import"../../shared/@ai-setting/roy-agent-core-bdzdw1g3.js";
+import"../../shared/@ai-setting/roy-agent-core-qrjs2500.js";
+import"../../shared/@ai-setting/roy-agent-core-2qkrpc7m.js";
+import"../../shared/@ai-setting/roy-agent-core-y0k9kaxz.js";
 import"../../shared/@ai-setting/roy-agent-core-jnszp0jq.js";
 import"../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";
 export {

package/dist/env/context/index.js

@@ -1,6 +1,6 @@
 import {
   init_context
-} from "../../shared/@ai-setting/roy-agent-core-m97jn2ra.js";
+} from "../../shared/@ai-setting/roy-agent-core-bdzdw1g3.js";
 import {
   EVENT_ENV_PREFIX,
   createEnvContext,
@@ -24,9 +24,9 @@ import {
   runWithEnvContextAsync,
   serializeEventToEnv,
   setCurrentTaskId
-} from "../../shared/@ai-setting/roy-agent-core-syyw58p9.js";
-import"../../shared/@ai-setting/roy-agent-core-8p63s836.js";
-import"../../shared/@ai-setting/roy-agent-core-rt115qfc.js";
+} from "../../shared/@ai-setting/roy-agent-core-qrjs2500.js";
+import"../../shared/@ai-setting/roy-agent-core-2qkrpc7m.js";
+import"../../shared/@ai-setting/roy-agent-core-y0k9kaxz.js";
 import"../../shared/@ai-setting/roy-agent-core-jnszp0jq.js";
 import"../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";
 init_context();

package/dist/env/debug/index.js

@@ -4,19 +4,19 @@ import {
   RegexParser,
   SpanBuilder,
   SpanDbReader
-} from "../../shared/@ai-setting/roy-agent-core-029r8kdw.js";
+} from "../../shared/@ai-setting/roy-agent-core-q212q0w1.js";
 import {
   ReplFormatter,
   TraceFormatter,
   TreeFormatter
 } from "../../shared/@ai-setting/roy-agent-core-rvv6ydff.js";
-import"../../shared/@ai-setting/roy-agent-core-0kn3zt1t.js";
-import"../../shared/@ai-setting/roy-agent-core-ytd5eztz.js";
-import"../../shared/@ai-setting/roy-agent-core-yphwdm9x.js";
-import"../../shared/@ai-setting/roy-agent-core-m97jn2ra.js";
-import"../../shared/@ai-setting/roy-agent-core-syyw58p9.js";
-import"../../shared/@ai-setting/roy-agent-core-8p63s836.js";
-import"../../shared/@ai-setting/roy-agent-core-rt115qfc.js";
+import"../../shared/@ai-setting/roy-agent-core-9s3payp1.js";
+import"../../shared/@ai-setting/roy-agent-core-expvav8a.js";
+import"../../shared/@ai-setting/roy-agent-core-ajmgyawx.js";
+import"../../shared/@ai-setting/roy-agent-core-bdzdw1g3.js";
+import"../../shared/@ai-setting/roy-agent-core-qrjs2500.js";
+import"../../shared/@ai-setting/roy-agent-core-2qkrpc7m.js";
+import"../../shared/@ai-setting/roy-agent-core-y0k9kaxz.js";
 import"../../shared/@ai-setting/roy-agent-core-jnszp0jq.js";
 import"../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";
 export {

package/dist/env/event-source/cli-command-handler.d.ts

@@ -0,0 +1,90 @@
+/**
+ * @fileoverview Task #4568 — `cli-command` EventSource handler
+ *
+ * ## 为什么需要它
+ *
+ * 飞书路径的 notify 链路有 5 个环节，CLI 路径**全缺**（设计文档 §4 断点 A~F）：
+ *
+ * | 环节 | 飞书 | CLI（改造前） |
+ * |---|---|---|
+ * | 入口产 triggerEventId | `larkCliHandler.emitTriggerEvent` | ❌ 无 |
+ * | 落库 esType | `lark-cli` | ❌ 无 |
+ * | EnvContext.replyChannel | `{chatId: oc_xxx}` | ❌ 无 |
+ * | notify event metadata | `{triggerEventId, replyChannel}` | ❌ 双缺 |
+ * | v2 notify prompt | `buildNotifyHandlePrompt` 命中 | ❌ gate 不过 |
+ *
+ * 本 handler 补上"CLI 也是一个 EventSource"的一半（生产端 + prompt 端）；
+ * 另一半（入口接线 + sink 分派）在 cli 包里。
+ *
+ * ## 三条硬契约（都有测试锁）
+ *
+ * 1. **落库 esType 必须是 `cli-command`**，不能抄 `lark-cli`。
+ *    `getHandlerForEsType(esType)` 是 v2 prompt 的唯一分派 key。写成
+ *    `lark-cli` 会让 agent 收到"用 lark-cli 发到 oc_xxx"的 prompt ——
+ *    而 CLI 路径根本没有 oc_xxx。见 `cli-command-handler.test.ts` ★ 核心。
+ *
+ * 2. **`buildCliReplyChannel().chatId` 永不为空**，格式 `cli:<sessionId>`。
+ *    `_captureReplyChannelSnapshot()`（delegate-tool.ts:2676）要求
+ *    `chatId || messageId` 至少一个非空，否则**整份快照被丢弃** →
+ *    notify event 无回复目标 → 规则通知静默丢失（探针 D 实测）。
+ *
+ * 3. **`params.sink === 'stdout'`**。
+ *    `EventHandler` 据此选择「console.log」还是「spawn lark-cli」。
+ *    ⚠️ 注意 `targetFromEventMetadata()` 会读 `params.sink`
+ *    （Task #4568 的配套修复，见 `telemetry-notice.ts`）—— 它原本丢弃整个 params。
+ *
+ * ## 与 lark handler 的对照
+ *
+ * | 能力 | larkCliHandler | cliCommandHandler |
+ * |---|---|---|
+ * | `emitTriggerEvent` | 落 `lark-cli` | 落 `cli-command` |
+ * | `extractReplyContext` | chatId/messageId/profile | chatId=`cli:<sid>` |
+ * | `buildNotifyHandlePrompt` | 四段式（含 lark-cli 命令） | 四段式（**明确禁止** lark-cli） |
+ * | `createInstance` | 真起 `lark-cli event consume` 子进程 | 哑实例（CLI 不消费外部流） |
+ */
+import type { EventSourceHandler } from "./types";
+/** CLI 事件源类型名（用户指定，默认启用） */
+export declare const CLI_COMMAND_ES_TYPE = "cli-command";
+/**
+ * CLI 回复目标的 chatId 前缀：`cli:<sessionId>`。
+ *
+ * 为什么需要前缀：
+ *   - 让 `extractChatId()` / `laneKeyFor()` 能把 CLI 通知放进**按 session
+ *     隔离的 lane**（不与真实 `oc_xxx` 群撞车）；
+ *   - 让 `resolveSessionForItemUncached()` 能识别"这不是真 chat，别去
+ *     `ensureChatSession()` 新建一个 `cli:xxx` 假 session"。
+ */
+export declare const CLI_SESSION_CHAT_ID_PREFIX = "cli:";
+/** CLI 通知的默认投递方式（用户 2026-10-27 拍板 ①：用 stdout） */
+export type CliNoticeSink = "stdout";
+/** `buildCliReplyChannel()` 的返回形状（与 `ReplyChannel` 结构兼容） */
+export interface CliReplyChannel {
+    type: string;
+    chatId: string;
+    params: {
+        sink: CliNoticeSink;
+        cliSessionId: string;
+    };
+}
+/**
+ * 构造 CLI 的「可回复 channel」。
+ *
+ * @param params.sessionId 当前 CLI session（空值降级成 `default`，绝不返回空 chatId）
+ */
+export declare function buildCliReplyChannel(params: {
+    sessionId: string;
+}): CliReplyChannel;
+/**
+ * 从 `cli:<sid>` 反解出 session id。非 CLI 前缀 → undefined。
+ *
+ * EventHandler 用它判断"要不要走 ensureChatSession()"。
+ */
+export declare function parseCliSessionChatId(chatId: string | undefined): string | undefined;
+/**
+ * CLI Command Handler（内置 EventSource）。
+ *
+ * ⚠️ 它**不消费**任何外部流（不像 lark-cli 要 spawn `event consume`）：
+ * CLI 的"事件"就是用户敲下的每一行 query，由 cli 包的
+ * `emitCliTriggerEvent()` 主动落库。
+ */
+export declare const cliCommandHandler: EventSourceHandler;

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

@@ -5,7 +5,7 @@
  * 支持通过 handleRule.plugins 加载外部 Plugin
  */
 import { ChildProcess } from "child_process";
-import type { EventSourceConfig, EventSourceHandler, EventSourceInstance, EventSourceStatus, EventSourceEventHandler, EventMetadata, ReplyChannel, RecommendedAction } from "./types";
+import type { EventSourceConfig, EventSourceHandler, EventSourceInstance, EventSourceStatus, EventSourceEventHandler, EventMetadata, ReplyChannel, RecommendedAction, RuleNoticeInfo } from "./types";
 import { timerHandler } from "./timer-handler";
 import { bountyIMHandler } from "./bounty-im-handler";
 import { bountyCliHandler } from "./bounty-cli-handler";
@@ -469,6 +469,16 @@ export declare class LarkCliInstance implements EventSourceInstance {
      */
     private sendLarkMessage;
 }
+/**
+ * 渲染「系统回执」小节 —— 告诉主 agent：群里**已经**看到了什么。
+ *
+ * 三种状态必须分开，否则 agent 会二选一地犯两种错：
+ *   - 已送达却把「已超时」再讲一遍 → 重复刷屏
+ *   - 未送达却以为发了 → 用户永远不知道任务结束了（正是 #4561 的现场）
+ *
+ * @param headline 事件标题句（未送达时要求 agent 自己讲清这个事实）
+ */
+export declare function renderRuleNoticeSection(ruleNotice: RuleNoticeInfo | undefined, headline: string): string;
 /**
  * LarkCli Handler
  */
@@ -494,6 +504,7 @@ export declare const builtInHandlers: EventSourceHandler[];
 export { timerHandler };
 export { bountyIMHandler };
 export { bountyCliHandler };
+export { cliCommandHandler } from "./cli-command-handler";
 /**
  * 根据类型获取内置 Handler
  */

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

@@ -3,13 +3,15 @@
  *
  * 导出所有 EventSource 相关的类型、类和函数
  */
-export type { EventSourceStatus, EventSourceType, EventSourceConfig, EventMetadata, RecommendedAction, ReplyChannel, EventSourceEventPayload, EventSourceEvent, EventSourceEventHandler, EventSourceStatusChangeEvent, EventSourcePersistenceConfig, EventSourceInstance, EventSourceHandler, EventSourceInitHook, EventSourceComponentInterface, EventSourceAgentHandlerConfig, } from "./types";
+export type { EventSourceStatus, EventSourceType, EventSourceConfig, EventMetadata, RecommendedAction, ReplyChannel, EventSourceEventPayload, EventSourceEvent, EventSourceEventHandler, EventSourceStatusChangeEvent, EventSourcePersistenceConfig, EventSourceInstance, EventSourceHandler, EventSourceInitHook, EventSourceComponentInterface, EventSourceAgentHandlerConfig, NotifyChannelInfo, RuleNoticeInfo, } from "./types";
 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 { EventStoreImpl, setSharedEventStore, getSharedEventStore, resetSharedEventStore, } from "./event-store";
 export type { EventStore, TriggerEventInput, TriggerEventMetadata, PersistedEvent, EventStoreOptions, } from "./event-store";
-export { larkCliHandler, timerHandler, bountyIMHandler, builtInHandlers, getBuiltInHandler, extractMetadata, } from "./event-source-handlers";
+export { larkCliHandler, timerHandler, bountyIMHandler, cliCommandHandler, builtInHandlers, getBuiltInHandler, extractMetadata, } from "./event-source-handlers";
+export { CLI_COMMAND_ES_TYPE, CLI_SESSION_CHAT_ID_PREFIX, buildCliReplyChannel, parseCliSessionChatId, } from "./cli-command-handler";
+export type { CliReplyChannel, CliNoticeSink } from "./cli-command-handler";
 export { TimerInstance } from "./timer-handler";
 export { BountyIMInstance, buildDefaultBountyIMSystemPrompt, resolveBountyIMSystemPrompt } from "./bounty-im-handler";

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

@@ -1,17 +1,22 @@
-import"../../shared/@ai-setting/roy-agent-core-3ztzc83c.js";
+import"../../shared/@ai-setting/roy-agent-core-5enxfga2.js";
 import {
   BountyIMInstance,
+  CLI_COMMAND_ES_TYPE,
+  CLI_SESSION_CHAT_ID_PREFIX,
   EventSourceComponent,
   TimerInstance,
   bountyIMHandler,
+  buildCliReplyChannel,
   buildDefaultBountyIMSystemPrompt,
   builtInHandlers,
+  cliCommandHandler,
   extractMetadata,
   getBuiltInHandler,
   larkCliHandler,
+  parseCliSessionChatId,
   resolveBountyIMSystemPrompt,
   timerHandler
-} from "../../shared/@ai-setting/roy-agent-core-fy4mcj6x.js";
+} from "../../shared/@ai-setting/roy-agent-core-ytnedzks.js";
 import {
   BUILT_IN_EVENT_SOURCE_TYPES,
   BUILT_IN_EVENT_SOURCE_TYPE_LIST,
@@ -20,36 +25,36 @@ import {
   isBuiltInEventSourceType,
   isValidEventSourceType,
   validateEventSourceConfig
-} from "../../shared/@ai-setting/roy-agent-core-ck60j1q9.js";
-import"../../shared/@ai-setting/roy-agent-core-tze5596n.js";
-import"../../shared/@ai-setting/roy-agent-core-8bngppw0.js";
-import"../../shared/@ai-setting/roy-agent-core-fbjd7bt6.js";
+} from "../../shared/@ai-setting/roy-agent-core-bxkjk7zx.js";
+import"../../shared/@ai-setting/roy-agent-core-0f989bnp.js";
+import"../../shared/@ai-setting/roy-agent-core-n1ck0x1r.js";
 import {
   EventStoreImpl,
   getSharedEventStore,
   resetSharedEventStore,
   setSharedEventStore
-} from "../../shared/@ai-setting/roy-agent-core-2ctyjy62.js";
+} from "../../shared/@ai-setting/roy-agent-core-z51jktet.js";
+import"../../shared/@ai-setting/roy-agent-core-xeqp659x.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-psg6f1v6.js";
-import"../../shared/@ai-setting/roy-agent-core-c36335nw.js";
-import"../../shared/@ai-setting/roy-agent-core-geh6j7bw.js";
-import"../../shared/@ai-setting/roy-agent-core-89sxsrc7.js";
-import"../../shared/@ai-setting/roy-agent-core-08njdcpj.js";
+import"../../shared/@ai-setting/roy-agent-core-qgapy83x.js";
+import"../../shared/@ai-setting/roy-agent-core-yd85623y.js";
+import"../../shared/@ai-setting/roy-agent-core-p2dpcyrz.js";
+import"../../shared/@ai-setting/roy-agent-core-8fy467qs.js";
+import"../../shared/@ai-setting/roy-agent-core-60p2380d.js";
 import"../../shared/@ai-setting/roy-agent-core-jrj30vq3.js";
-import"../../shared/@ai-setting/roy-agent-core-gksw1gjb.js";
+import"../../shared/@ai-setting/roy-agent-core-hf0t8agb.js";
 import"../../shared/@ai-setting/roy-agent-core-e25xkv53.js";
 import"../../shared/@ai-setting/roy-agent-core-64f22h1g.js";
 import"../../shared/@ai-setting/roy-agent-core-az13yzmc.js";
 import"../../shared/@ai-setting/roy-agent-core-7hh0brvs.js";
-import"../../shared/@ai-setting/roy-agent-core-0kn3zt1t.js";
-import"../../shared/@ai-setting/roy-agent-core-ytd5eztz.js";
-import"../../shared/@ai-setting/roy-agent-core-yphwdm9x.js";
-import"../../shared/@ai-setting/roy-agent-core-m97jn2ra.js";
-import"../../shared/@ai-setting/roy-agent-core-syyw58p9.js";
-import"../../shared/@ai-setting/roy-agent-core-8p63s836.js";
-import"../../shared/@ai-setting/roy-agent-core-rt115qfc.js";
+import"../../shared/@ai-setting/roy-agent-core-9s3payp1.js";
+import"../../shared/@ai-setting/roy-agent-core-expvav8a.js";
+import"../../shared/@ai-setting/roy-agent-core-ajmgyawx.js";
+import"../../shared/@ai-setting/roy-agent-core-bdzdw1g3.js";
+import"../../shared/@ai-setting/roy-agent-core-qrjs2500.js";
+import"../../shared/@ai-setting/roy-agent-core-2qkrpc7m.js";
+import"../../shared/@ai-setting/roy-agent-core-y0k9kaxz.js";
 import"../../shared/@ai-setting/roy-agent-core-jnszp0jq.js";
 import"../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";
 export {
@@ -58,6 +63,7 @@ export {
   setSharedEventStore,
   resolveBountyIMSystemPrompt,
   resetSharedEventStore,
+  parseCliSessionChatId,
   larkCliHandler,
   isValidEventSourceType,
   isBuiltInEventSourceType,
@@ -65,13 +71,17 @@ export {
   getDefaultConfigForType,
   getBuiltInHandler,
   extractMetadata,
+  cliCommandHandler,
   builtInHandlers,
   buildDefaultBountyIMSystemPrompt,
+  buildCliReplyChannel,
   bountyIMHandler,
   TimerInstance,
   EventStoreImpl,
   EventSourceInitHooks,
   EventSourceComponent,
+  CLI_SESSION_CHAT_ID_PREFIX,
+  CLI_COMMAND_ES_TYPE,
   BountyIMInstance,
   BUILT_IN_EVENT_SOURCE_TYPE_LIST,
   BUILT_IN_EVENT_SOURCE_TYPES

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

@@ -29,11 +29,22 @@ export declare const BUILT_IN_EVENT_SOURCE_TYPES: {
     readonly LARK_CLI: "lark-cli";
     readonly TIMER: "timer";
     readonly BOUNTY_IM: "bounty-im";
+    /**
+     * ★ Task #4568：CLI 命令行入口也是事件源。
+     *
+     * 与其它三者不同，它**不消费外部流** —— "事件"就是用户在终端敲下的
+     * 每一行 query，由 cli 包的 `emitCliTriggerEvent()` 主动落库。
+     *
+     * 存在的意义：让 `getHandlerForEsType('cli-command')` 能分派到
+     * `cliCommandHandler.buildNotifyHandlePrompt()`，从而给 agent 一个
+     * 「CLI 没有 IM 通道，输出到 stdout」的 prompt（而不是套用飞书模板）。
+     */
+    readonly CLI_COMMAND: "cli-command";
 };
 /**
  * 内置事件源类型列表
  */
-export declare const BUILT_IN_EVENT_SOURCE_TYPE_LIST: ("lark-cli" | "timer" | "bounty-im")[];
+export declare const BUILT_IN_EVENT_SOURCE_TYPE_LIST: ("lark-cli" | "timer" | "bounty-im" | "cli-command")[];
 /**
  * HandleRuleConfig
  *
@@ -580,6 +591,55 @@ export interface ReplyContext {
     /** lark-cli profile（用于 im +messages-reply --profile） */
     profile?: string;
 }
+/**
+ * 触发渠道信息（渠道无关的最小集合）。
+ *
+ * 由 CLI EventHandler 从 trigger event + handler.extractReplyContext 解析后
+ * 传给 buildNotifyHandlePrompt，让 prompt 能按**真实渠道**渲染：
+ *   - 渠道类型（lark-cli / bounty-im / timer / ...）
+ *   - 群 ID / 群聊还是私聊
+ *   - 触发消息 ID、发送者、profile
+ *
+ * ★ 为什么不让每个 handler 自己从 triggerEvent 里抠字段：
+ *   bounty-im 用 from/to 邮箱、lark 用 chatId/messageId，字段名完全不同；
+ *   统一在这里归一化，handler 只负责渲染「怎么发」。
+ */
+export interface NotifyChannelInfo {
+    /** EventSource 类型（lark-cli / bounty-im / timer / ...） */
+    esType: string;
+    /** 回复目标会话 ID（飞书为 oc_xxx） */
+    chatId?: string;
+    /** 群聊 / 私聊 / 未知（飞书 trigger event metadata.chatType） */
+    chatType?: "group" | "p2p" | "unknown";
+    /** 触发消息 ID（飞书为 om_xxx）；reply 这条可保持话题线索 */
+    messageId?: string;
+    /** 触发者 ID（飞书为 ou_xxx） */
+    senderId?: string;
+    /** 多 appId 场景的 lark-cli profile */
+    profile?: string;
+    /** 回复方式：reply=回复触发消息 / send=新消息 / none=无可用通道 */
+    replyKind?: "reply" | "send" | "none";
+}
+/**
+ * 规则化回执（rule-based direct notice）的投递结果。
+ *
+ * 终态事件（completed / timeout）在进 lane 之前，会先用 telemetry 同一套
+ * 发送器直发一条**保底**消息到触发群；这里把「发没发出去」如实带给主 agent，
+ * 避免 prompt 谎称「已发送」而 agent 又重复/遗漏关键信息。
+ */
+export interface RuleNoticeInfo {
+    /** 是否尝试过直发（false = 该事件类型不在规则回执白名单） */
+    attempted: boolean;
+    /** 是否确实送到群里 */
+    delivered: boolean;
+    chatId?: string;
+    /** 实际发出的文案（送达时带，便于 prompt 里告知「回执已经说了什么」） */
+    text?: string;
+    /** 送达时刻（epoch ms） */
+    sentAt?: number;
+    /** 失败原因（未送达时带） */
+    error?: string;
+}
 /**
  * buildNotifyHandlePrompt 输入
  */
@@ -591,6 +651,21 @@ export interface BuildNotifyHandlePromptInput {
         description?: string;
         result?: string;
         error?: string;
+        /**
+         * 子 session ID —— 超时 / 失败后如需**续跑**，主 agent 可直接
+         * `delegate_task(existingSubSessionId=<此值>, ...)` 让子代理继承历史继续推进，
+         * 不必从零重来。
+         */
+        subSessionId?: string;
+        /**
+         * ★ Task #4568：后台进程 ID（形如 `process_1793101794979_dyvi6vhxx`）。
+         *
+         * 用途：`taskId` 是「sub-agent 自己 task_create 过才有」的业务任务号，
+         * 很多后台任务没有它。此时 prompt 需要一个可辨识的标签，否则只能渲染
+         * `Task #?`（真机验证发现的显示缺陷）。CLI handler 用它生成
+         * `后台任务 dyvi6vhxx`。
+         */
+        backgroundTaskId?: string;
     };
     /** 触发整个 delegate_task 的原始 event（从 EventStore 反查） */
     triggerEvent: PersistedEvent;
@@ -605,6 +680,19 @@ export interface BuildNotifyHandlePromptInput {
      * 让主 agent 拿到的回复命令带上正确的 `--profile`。
      */
     profile?: string;
+    /**
+     * 触发渠道信息（渠道无关，由调用方归一化后传入）。
+     *
+     * 缺省时 handler 自行从 triggerEvent 反查（向后兼容）。
+     */
+    channel?: NotifyChannelInfo;
+    /**
+     * 规则化回执的投递结果。
+     *
+     * 缺省 = 本事件不直发回执（如 failed / stopped / ask_user），
+     * prompt 需要引导 agent 把结果完整讲清楚。
+     */
+    ruleNotice?: RuleNoticeInfo;
 }
 /**
  * buildNotifyHandlePrompt 输出

package/dist/env/hook/index.js

@@ -2,7 +2,7 @@ import {
   createHook,
   createPriorityHook,
   init_hook
-} from "../../shared/@ai-setting/roy-agent-core-ytd5eztz.js";
+} from "../../shared/@ai-setting/roy-agent-core-expvav8a.js";
 import {
   AgentHookPoints,
   HookManager,
@@ -13,11 +13,11 @@ import {
   executeLLMHook,
   executeToolHook,
   globalHookManager
-} from "../../shared/@ai-setting/roy-agent-core-yphwdm9x.js";
-import"../../shared/@ai-setting/roy-agent-core-m97jn2ra.js";
-import"../../shared/@ai-setting/roy-agent-core-syyw58p9.js";
-import"../../shared/@ai-setting/roy-agent-core-8p63s836.js";
-import"../../shared/@ai-setting/roy-agent-core-rt115qfc.js";
+} from "../../shared/@ai-setting/roy-agent-core-ajmgyawx.js";
+import"../../shared/@ai-setting/roy-agent-core-bdzdw1g3.js";
+import"../../shared/@ai-setting/roy-agent-core-qrjs2500.js";
+import"../../shared/@ai-setting/roy-agent-core-2qkrpc7m.js";
+import"../../shared/@ai-setting/roy-agent-core-y0k9kaxz.js";
 import"../../shared/@ai-setting/roy-agent-core-jnszp0jq.js";
 import"../../shared/@ai-setting/roy-agent-core-fs0mn2jk.js";
 init_hook();

package/dist/env/index.d.ts

@@ -16,7 +16,7 @@ export type { Task, TaskOperation, TaskStatus, TaskPriority, ActionType, CreateT
 export { McpComponent, } from "./mcp";
 export type { McpComponentConfig, McpComponentOptions, McpPath, McpServerConfig, McpServerStatus, DiscoveredMcpServer, } from "./mcp";
 export { EventSourceComponent, larkCliHandler, builtInHandlers, } from "./event-source/event-source-component";
-export type { EventSourceConfig, EventSourceStatus, EventSourceType, EventSourceEvent, EventSourceEventPayload, EventSourceEventHandler, EventSourceStatusChangeEvent, EventSourcePersistenceConfig, EventSourceComponentInterface, EventSourceHandler, EventSourceInstance, EventSourceAgentHandlerConfig, BUILT_IN_EVENT_SOURCE_TYPES, } from "./event-source/types";
+export type { EventSourceConfig, EventSourceStatus, EventSourceType, EventSourceEvent, EventSourceEventPayload, EventSourceEventHandler, EventSourceStatusChangeEvent, EventSourcePersistenceConfig, EventSourceComponentInterface, EventSourceHandler, EventSourceInstance, EventSourceAgentHandlerConfig, NotifyChannelInfo, RuleNoticeInfo, BUILT_IN_EVENT_SOURCE_TYPES, } from "./event-source/types";
 export { EventSourceInitHooks, isValidEventSourceType, isBuiltInEventSourceType, getDefaultConfigForType, validateEventSourceConfig, } from "./event-source/types";
 export { WorkflowComponent, } from "./workflow/workflow-component";
 export type { WorkflowComponentConfig, } from "./workflow/workflow-component";