@shgroup/dsh-serenity-hooks 1.89.0 → 1.91.0

package/lib/im/hook.d.ts

@@ -60,12 +60,17 @@ export interface WeixinHookIncomingEvent extends WeixinHookEventBase {
     };
 }
 /**
- * outgoing 事件来源：
- *  - `reply`（缺省，向后兼容）= 收到用户消息后的回复
- *  - `proactive` = 桥被调用主动发给指定用户（CCC MSM 经本机入口发起）
- *  - `reply-fallback`（v1.30.17）= 手动输出模式下 agent 本轮一次都没发送成功 → 桥兜底转发其最终文本
+ * outgoing 事件来源 —— 🔴 **2026-10-24（D238）只剩 `proactive` 一个值**。
+ *
+ * 历史（R↓，两个已退役的值）：
+ *  - `reply`（v1.27 缺省）= 桥收到消息后自动回发最终文本。**随 `autoReplyWithLastMessage` 退役**；
+ *  - `reply-fallback`（v1.30.17）= 手动模式下 agent 未发送时桥兜底转发。**随 `fallbackOnNoSend` 退役**。
+ *
+ * ⇒ 现在**所有出站都来自 agent 自己调 `im-bridge`**。保留 `source` 字段本身是为了：
+ * ① 存量日志里那两种值仍可被读到（历史不改写）；
+ * ② 将来接第二种"出站起因"时不必再动事件形状。
  */
-type WeixinOutgoingSource = 'reply' | 'proactive' | 'reply-fallback';
+type WeixinOutgoingSource = 'proactive';
 /** outgoing 事件（bot → 用户）：回复文本（已剥离 think） */
 export interface WeixinHookOutgoingEvent extends WeixinHookEventBase {
     event: 'outgoing';
@@ -103,7 +108,10 @@ interface OutgoingHookInput {
     sessionId: string;
     role: string;
     reply: string;
-    /** 缺省 'reply'（对话回复）；'proactive' = 主动发送；'reply-fallback' = 手动模式兜底转发 */
+    /**
+     * 出站来源。🔴 **D238 起只剩 `'proactive'`**（历史值 `reply` / `reply-fallback` 已退役）。
+     * 造事件时**不传就不写该字段** —— 缺席 = 调用方未指定，**不是某个缺省语义**（见 buildOutgoingHookEvent）。
+     */
     source?: WeixinOutgoingSource;
     /** 文件外发记录（可选；send-file 路径填） */
     file?: {

package/lib/im/inbound-event.d.ts

@@ -145,7 +145,7 @@ export declare function handleInboundEvent(ctx: Context, root: string, accountId
     channel?: string;
 }): Promise<void>;
 /**
- * 手动输出模式的**机制标记**（v1.30.10 引入；v1.30.16 按「ACC 管机制、CCC 管措辞」重构）。
+ * 出站**机制标记**（v1.30.10 引入；v1.30.16 按「ACC 管机制、CCC 管措辞」重构）。
  *
  * 边界（R↓）：ACC 只提供**机制与数据**——"桥不转发最终文本"这个事实 + 三个已填好的参数值。
  * **纪律措辞归 CCC**：怎么写、必须怎么做、后果是什么，全部写在轨迹的 `PROMPT.md` 里。
@@ -153,21 +153,21 @@ export declare function handleInboundEvent(ctx: Context, root: string, accountId
  * 🔴 **渠道不是常量**（2026-10-20 Q4）：此前这里硬写 `channel:"weixin"`，
  * 而一条**飞书**会话收到的却是"发往微信"的命令 ⇒ 模型照着做必然失败（目标 id 是 open_id）。
  * ⇒ 渠道由调用方传入；缺省 `'weixin'` 保留既有调用点与测试的读数。
+ *
+ * 🔴 2026-10-24（D238）：本标记从"手动模式才注入"变成**每轮必注入**（手动模式已成唯一路径）。
+ * ⚠️ **标记字符串 `[serenity:weixin-manual-output]` 不改名**：CCC 侧角色提示词按它做判据，
+ *    改名会把已写好的纪律文档全打成废纸；它是**协议标记**，不是渠道名（与 A85 同一处置）。
  */
 export declare function manualOutputMarker(accountId: string, userId: string, channel?: string): string;
+export {};
 /**
- * 手动输出模式的**兜底判定**（纯函数，v1.30.17——把决策矩阵从装配里抽出来，可独立测试）。
+ * 🔴 **`manualOutputFallbackNeeded` 已于 2026-10-24 删除**（owner 令，D238）。
  *
- * 四个条件同时成立才兜底：
- * ① CCC 显式开启 `fallbackOnNoSend`（缺省 false = 严格静默）
- * ② 机械闸门**已装配**（未装配时无法判定"是否发送过" → 宁可静默也不冒重复发送风险）
- * ③ 本轮**没有**成功发送（agent 自己发过 → 输出权归 agent，桥不插话）
- * ④ 有最终文本可转发（空文本无意义）
+ * 它实现的是「手动模式下 agent 一次都没发成功 ⇒ 桥兜底转发最终文本」。
+ * **随 `fallbackOnNoSend` 一起退役** —— 那个开关只在 `autoReplyWithLastMessage=false` 时才有意义，
+ * 而后者已整条删除（出站只剩 `im-bridge` 一条路）。
+ *
+ * ⛔ **不要把它改写成"自动兜底"再放回来**：owner 否决的正是"桥替 agent 说最后一句"这件事本身
+ * （「autoReply 并不合适，主动性的 imBridge 仍然是更好的」），而不是它的某个实现细节。
+ * 兜底带来的"不丢消息"收益，改由 guard 打回（可见性前置检查 ＋ 响亮告警）承担。
  */
-export declare function manualOutputFallbackNeeded(input: {
-    fallbackOnNoSend?: boolean;
-    guardActive: boolean;
-    sentThisTurn: boolean;
-    answer: string;
-}): boolean;
-export {};