@weavecode/weave 0.1.1 → 0.1.3

package/node_modules/@weavecode/server/dist/hooks/message-deliverer.d.ts

@@ -1,16 +1,17 @@
 import { type Harness } from '@weavecode/core';
-import type { MessagingSurface } from '@weavecode/harness';
+import { type MessagingSurface } from '@weavecode/harness';
 import type { HookEventRepository } from '../repositories/hook-events.js';
 import type { ProjectRepository } from '../repositories/projects.js';
 import type { SessionRepository } from '../repositories/sessions.js';
-import { type SessionTerminal } from '../daemon/opener.js';
+import type { SessionTerminal } from '../daemon/opener.js';
 import type { HookEventBus } from './bus.js';
 import { HeadlessRunner, type SpawnLike } from './headless-runner.js';
 /**
  * 消息域投递器（消息域重塑：纯递送管道，非记录系统）——消息不落任何 DB 行，
  * 唯一归宿是目标会话自己的转录；weave 仅投递前短暂持有：
  *
- *   prompt  → 层① 原生 peer 消息中继（claude SendMessage，经受限 headless 进程）
+ *   prompt  → 层①-a 会话本地 inbox socket 直投（harness 声明才可用；手动面排除）
+ *             层① 原生 peer 消息中继（claude SendMessage，经受限 headless 进程）
  *             层② 终端 send-text 兜底（无原生机制的 harness；TerminalBackend 通道）
  *             层③ promptbox 队列（`<dataDir>/hooks/promptbox/<shard>.jsonl`，送达即删行）
  *   inject  → outbox 顺延注入（fire-and-forget，随目标会话下一拍 hook 事件送达）
@@ -43,7 +44,7 @@ export type MessageFromKind = 'dashboard' | 'session';
 /** 管道消息状态：pending 只活在 promptbox 文件，其余在内存注册表。 */
 export type PipeStatus = 'pending' | 'delivering' | 'running' | 'injected' | 'delivered' | 'succeeded' | 'failed' | 'timeout';
 /** 随 prompt 投递的图（上传件引用；路径 = 落盘件的绝对路径，harness 合成引用形态）。 */
-export interface MessageImage {
+export interface MessageAttachment {
     id: string;
     name: string;
     mediaType: string;
@@ -54,17 +55,17 @@ export interface PipeMessage {
     id: string;
     sessionId: string;
     /** **用户原文**（回执比对、气泡文案都用它）；投递出去的文本是它经 harness
-     *  `imageAttach.composePrompt` 合成的形态（带图时追加图引用），见 `wireTextOf`。 */
+     *  `attach.composePrompt` 合成的形态（带附件时追加引用），见 `wireTextOf`。 */
     text: string;
-    /** 随附图（空/缺省 = 纯文本消息）。 */
-    images?: MessageImage[];
+    /** 随附文件（空/缺省 = 纯文本消息）。 */
+    attachments?: MessageAttachment[];
     mode: MessageMode;
     /** 单向注入（手动面：无接收方会话，中继载荷带「无需回复」注记）；编排域不置。 */
     oneWay?: boolean;
     /** 发送人强制层② 终端（层序收窄成只剩它，且重发沿用）。 */
     forceTerminal?: boolean;
-    /** prompt 通道的实际落法（socket 直投 / 中继 / 终端 send-text）。 */
-    via?: 'socket' | 'relay' | 'terminal';
+    /** prompt 通道的实际落法（socket 直投 / 宿主队列 / 中继 / 终端 send-text）。 */
+    via?: 'socket' | 'queue' | 'relay' | 'terminal';
     /** 投递回执：会话自己的 UserPromptSubmit 与本文匹配上了（真到达，非「已交给」）。 */
     acked?: boolean;
     /** 回执命中的那条开轮事件 id：对话面据此把投递行精确挂到它的气泡上（比比对
@@ -75,6 +76,9 @@ export interface PipeMessage {
     settledAt?: string | null;
     /** 本条 = 该会话暂停闸的成因（未回执 / 投递失败）；重发或回执清除。 */
     stalled?: boolean;
+    /** 闸自动清除本行的时刻（只给「已发出却没回执」那种成因行）：到点行消失、队列续排。
+     *  web 拿它走倒计时。 */
+    releaseAt?: string | null;
     /** 判死而没投出去（会话进程不在、三层全无通路）：`failed` 的成因，web 据此出中文说明。 */
     reason?: 'offline';
     /** 实际投递通道（auto 落定后回填；pending = 尚未裁决成通道）。 */
@@ -142,9 +146,18 @@ export interface MessageDelivererDeps {
     /** 终态驻留窗口（毫秒）；缺省 60s——delivered/injected/succeeded 短时留在在途
      *  视图展示 via/acked，过后消失（failed/timeout/暂停闸成因常驻）。 */
     visibleTtlMs?: number;
-    /** 未回执闸窗口（毫秒）；缺省 120s——prompt 送达后没等到 UPS 回执即暂停该会话
+    /** 未回执闸窗口（毫秒）；缺省 30s——prompt 送达后没等到 UPS 回执即暂停该会话
      *  的队列冲洗（防继续向 Held/Refused 的会话灌消息），手动重发或回执解除。 */
     ackStallMs?: number;
+    /** 闸自动解除窗口（毫秒）；缺省 90s——闸挂着而回执永远不来（消息其实丢了）时，
+     *  队列不能就此停到天荒地老：到点把成因行落成 failed（`unacked`）并续排。 */
+    ackStallReleaseMs?: number;
+    /** 斜杠命令等回执的短窗口（毫秒）；缺省 5s——过了仍无 UPS 即按内建命令收。 */
+    commandAckGraceMs?: number;
+    /** 该会话此刻是否挂着阻塞式模态框（questions 槽；QuestionTracker 是唯一实现）。
+     *  模态框在场时层② 的文本与回车会被它吃掉：投出去只换来一条「已发出却没回执」
+     *  的假送达，回车还可能替用户按下某个选项。缺省 = 不判（测试与无 tracker 装配）。 */
+    blockedByQuestion?: (sessionId: string) => boolean;
     /** 会话存活图（测试注入）；缺省 `claudeLivenessById()`——同两个引擎（watch/sequence）
      *  的取法：没有注册表就空图，会话一律「查不动」，不猜。 */
     livenessOf?: () => Map<string, boolean>;
@@ -161,8 +174,8 @@ export interface SendInput {
     /** 强制层② 终端 send-text（手动面下拉选的通道）：跳过直投与中继——宿主把
      *  终端击键当用户输入，另外两层都是「另一个会话发的」。 */
     forceTerminal?: boolean;
-    /** 随附图（已落盘的上传件）；带图且目标 harness 的 `imageAttach` 为 null 即 409。 */
-    images?: readonly MessageImage[];
+    /** 随附文件（已落盘的上传件）；目标 harness 的 `attach` 面不收该类型即 409。 */
+    attachments?: readonly MessageAttachment[];
 }
 /** send() 返回：ok 由路由映射 200，否则 status 即 HTTP 码。 */
 export type SendResult = {
@@ -183,6 +196,11 @@ export type AnswerResult = {
     status: 400 | 404 | 409;
     error: string;
 };
+/**
+ * 层② 定位来源：both = pane env 优先、标题+cwd 回落（投递路径的常规口径）；
+ * locator = 只认 env；heuristic = 只按标题+cwd（中断补打用，见 interrupt）。
+ */
+export type PaneTargetSource = 'both' | 'locator' | 'heuristic';
 /** 通道现况：ready = 现在就能投；unknown = 判不动（终端只剩标题/cwd 回落，被动面看不出来）。 */
 interface ChannelState<R extends string> {
     status: 'ready' | 'unavailable' | 'unknown';
@@ -193,6 +211,7 @@ export interface SessionDeliveryDiagnosis {
     /** 存活三态（同 `pidAliveOf` 口径：判不动 = null）。 */
     alive: boolean | null;
     inbox: ChannelState<'no-mechanism' | 'no-credentials' | 'auth-token-required'>;
+    queue: ChannelState<'no-mechanism'>;
     relay: ChannelState<'no-mechanism' | 'no-peer-name'>;
     terminal: ChannelState<'no-backend' | 'no-pane-env'>;
     /** 该会话有没有上报过 pane 定位 env。 */
@@ -202,6 +221,21 @@ export interface SessionDeliveryDiagnosis {
     /** 暂停闸是否已置（未回执超窗 / 投递失败）。 */
     stalled: boolean;
 }
+/**
+ * 作答键序白名单（安全闸）：逐个**原子**验形态——作答面不能变成任意键序注入
+ * 通道（键序若打进已关的模态框会漏进输入框执行）。原子要么是宿主的键（选项
+ * 序号 / Tab / 回车 / 下移 / 预览面的 `n` 备注键），要么是自定义输入行的文本
+ * （无控制字符——CR/LF/ESC 混进来就成了任意键序注入，不只是打字）。原子表本身
+ * 由 harness 规格拼装（选项 keys / textFocus / textTail），这里只验形态。
+ */
+/**
+ * 斜杠命令（宿主内建命令与 skill/插件命令都算）：判据跟宿主一致——**trim 后以
+ * `/` 开头**（命令只在最前面生效）。两者的回执行为不同：内建命令（`/compact`、
+ * `/model`、`/effort`…）由宿主内部执行、**不发 UserPromptSubmit**，而 skill/插件
+ * 命令会把敲的那行原样报一条 UPS（实测 0.6s）。故不能一律当「无回执」收，见
+ * `armCommandAck` 的短窗口。
+ */
+export declare function isSlashCommand(text: string): boolean;
 export declare class MessageDeliverer {
     private readonly deps;
     private readonly headless;
@@ -223,7 +257,11 @@ export declare class MessageDeliverer {
     private persistedPaneEnvs;
     /** 已排自续冲洗的会话（防重复排拍）。 */
     private readonly flushScheduled;
-    /** 正在冲洗的会话（重入闸：异步冲洗 + 多条触发源，防同批行被投两次）。 */
+    /**
+     * 正在冲洗的会话（重入闸：异步冲洗 + 多条触发源，防同批行被投两次）。值是这一拍
+     * 的令牌——强制移除卡住的那一行要就地解除泵闸，旧拍醒来时不能顺手把新拍的闸也
+     * 删掉（两拍并行 = 同一行被投两次）。
+     */
     private readonly flushing;
     /** 队列暂停闸（sessionId → 成因消息）：未回执超窗 / 投递失败即置；重发或回执解除。 */
     private readonly stalled;
@@ -239,6 +277,8 @@ export declare class MessageDeliverer {
      * 故只留最近 `DISMISS_GUARD_MAX` 条。
      */
     private readonly dismissedIds;
+    /** 回执闸 + 暂停闸（判定与计时逻辑在 delivery/ack-gate.ts，状态仍在本类）。 */
+    private readonly gate;
     constructor(deps: MessageDelivererDeps);
     /**
      * 裁决表（规格顺序）：session 404 → harness 无法判定 400 → 按模式落通道
@@ -285,6 +325,21 @@ export declare class MessageDeliverer {
         socket: string;
         token: string | null;
     } | null): void;
+    /**
+     * 等会话的 inbox 凭据就位（投递方刚把会话拉起来时用）：凭据由会话自己的 hook
+     * 进程随首个事件旁路上报，故按内存态轮询、到点即放弃。**只问有没有、不真连**
+     * ——连不连得上由 `tryInboxDeliver` 现试现回落。机制缺席（无 `promptInbox`）或
+     * 该平台要求 token 而凭据里没有 → 立刻 false，白等没有意义。
+     */
+    awaitInboxReady(sessionId: string, timeoutMs: number): Promise<boolean>;
+    /**
+     * 会话最近一条「说出口的结论」（每轮收尾事件上带的最终输出，跳过空回合）：
+     * 编排边「带上游输出」取用。只读既有 `hook_events`，不新落任何东西；读不到 → null。
+     */
+    lastTurnOutput(sessionId: string): {
+        output: string;
+        at: string;
+    } | null;
     /**
      * hook 旁路上报的会话 pane 定位 env（**每个 hook 事件覆盖刷新**：会话换 pane /
      * resume 到新窗口后，下一次事件就把定位改过来，与 inbox 凭据同一自愈口径）。
@@ -327,9 +382,11 @@ export declare class MessageDeliverer {
      * 对应气泡上（见 `PipeMessage.ackedEventId`）。
      */
     onSessionPrompt(sessionId: string, prompt: string, eventId?: number): string[];
-    /** 未回执闸布防：prompt 送达后 ackStallMs 内没等到 UPS 回执 → 暂停该会话队列。 */
+    /** 未回执闸布防（判定与计时在 delivery/ack-gate.ts）。 */
     private armAckWatch;
-    /** 置闸：成因消息标记 stalled（常驻在途视图）+ message.stalled 帧（web 重拉）。 */
+    /** 斜杠命令的回执收尾（短窗口；内建命令不发 UPS）。 */
+    private armCommandAck;
+    /** 置闸（成因消息标记 stalled + message.stalled 帧）。 */
     private stall;
     /**
      * 远程作答（阻塞式交互）：向目标会话所在 pane 发裸键序——模态框只吃键盘，
@@ -342,8 +399,21 @@ export declare class MessageDeliverer {
      * 中断目标会话正在跑的回合（dashboard 停止按钮）：往 pane 打**一记 ESC**。
      * 键序固定死在服务端（**不当参数收**）——这条通道一放开就是任意击键注入；
      * 且只打一记：claude 里 ESC 一次是中断，连打两次是开历史回退菜单。
-     */
-    interrupt(sessionId: string): Promise<AnswerResult>;
+     *
+     * `source` / `avoidPaneId` 只给 /interrupt 的**补打**用（缺省 = 老口径：locator
+     * 优先、标题+cwd 回落）。宿主没反应时可指定 'heuristic' 只按标题+cwd 重打一记——
+     * pane env 指着旧 pane（会话换了窗口）时，第一记落进的是别人的输入行，宿主
+     * 那边毫无动静，而错误在投递侧根本看不出来（send-text 照样 exit 0）。
+     * `avoidPaneId` 命中即**不打**（`sent:false`）：落到同一个 pane 的第二记只会
+     * 在 claude 里开出历史回退菜单。
+     */
+    interrupt(sessionId: string, source?: PaneTargetSource, avoidPaneId?: string): Promise<{
+        ok: true;
+        paneId: string;
+        sent: boolean;
+    } | Extract<AnswerResult, {
+        ok: false;
+    }>>;
     /**
      * 关掉会话所在的 pane（会话生命周期收尾）：宿主随 pane 一起退出——这是「退出
      * 会话」的远程等价（harness 没有「请退出」这种信号）。**会话行与它的对话照常
@@ -356,6 +426,17 @@ export declare class MessageDeliverer {
      * 实时态只能是 hook 事件里最近一次的 `permission_mode`（「最后已知」）。
      */
     cycleMode(sessionId: string): Promise<AnswerResult>;
+    /**
+     * 手动提交（Enter 键帽）：往 pane 打一记回车，提交宿主输入框里现成的内容。
+     * 与层② 自动补打同一字节、同一语义——**提交的是整个输入框**，框里若有别的东西
+     * 会一起出去，这是盲打回车的固有风险，键帽 tooltip 如实说明。
+     */
+    pressEnter(sessionId: string): Promise<AnswerResult>;
+    /**
+     * 手动硬中断（Ctrl+C 键帽）：往 pane 打一记 Ctrl+C。与 ESC 不同——它是宿主
+     * TUI 的硬中断（杀当前行/退出输入态），不落转录标记，「停没停」判不了，只报送出。
+     */
+    pressCtrlC(sessionId: string): Promise<AnswerResult>;
     /**
      * 模型切换：往会话的输入行打宿主自己的 `/model <名>` 并提交（会话级、不落盘）。
      * 名字是**用户自填**的（网关模型 ID 会增删，不做静态映射表），故只验形态不验
@@ -363,12 +444,38 @@ export declare class MessageDeliverer {
      */
     setModel(sessionId: string, name: string): Promise<AnswerResult>;
     /**
-     * 键序注入路径（作答 / 中断 / 关 pane）共用的落点解析：会话 → 项目 → 终端通道
-     * → pane。全部失败原因是**可判定的语义拒绝**（404/409），调用方原样回给 HTTP；
-     * 两条 409 是给用户看的（web 直拼在「停止失败：」这类动作名后面），故写成中文
-     * 修法，动作名随调用方换。
+     * 思考强度调整：往会话的输入行打宿主自己的 `/effort <档位>` 并提交。档位过
+     * **词表白名单**（core 表该 harness 的 `effortLevels`）——封闭枚举，表外 400
+     * 不打键；模型能力差异宿主自己降档并回报（事件自带 `effort.level` 纠正显示）。
      */
+    setEffort(sessionId: string, level: string): Promise<AnswerResult>;
+    /**
+     * 旁路会话（claude = `/btw`）：问句经层② 终端打进会话 pane——宿主的侧问只
+     * 活在 TUI 里（`claude -p "/btw …"` 直说不支持这个环境），也不落任何文件，
+     * 故终端击键是唯一通道。不入队、不布防回执：回答不是 UPS 而是之后的一条
+     * 采集事件（认领见 `hooks/side-questions.ts`）。
+     *
+     * 返回归一化后的问句（已过 harness 的形态校验）：调用方据此落历史行。
+     */
+    askSideQuestion(sessionId: string, question: string): Promise<{
+        ok: true;
+        question: string;
+    } | {
+        ok: false;
+        status: 400 | 404 | 409;
+        error: string;
+    }>;
     private sessionKeysTarget;
+    /** bus 可选 → 必选形状（delivery 模块的入参）。 */
+    private busSafe;
+    /** 层① 通道尝试的依赖切片（delivery/channels.ts 的入参形状）。 */
+    private channelDeps;
+    /** 投递文本合成（delivery/channels.ts 的纯函数，绑本类的面解析）。 */
+    private wireTextOfEntry;
+    /** 有没有图（delivery/channels.ts 的纯函数）。 */
+    private hasImagesEntry;
+    /** 键序域的依赖切片（delivery/keys.ts 的入参形状）。 */
+    private keysDeps;
     /**
      * 手动重发（暂停闸的解除动作）：prompt 通道 failed 或 delivered-未回执 的消息
      * 重走投递（socket → 中继 → 终端 → 队列），重发即解闸并重新布防回执闸。
@@ -379,8 +486,13 @@ export declare class MessageDeliverer {
      * （pending 只活在 promptbox 文件里）删行——两种都不再出现在这个会话的对话尾巴上。
      * 内存行**不影响已投递的内容**（真到了会话，转录里的记录仍在）；队列行则是
      * **取消发送**（还没出去）。内存行若正是暂停闸的成因 → 一并解闸（否则闸留着却
-     * 没有成因行可看、可操作），并续排空积压（下一条各自重新布防回执闸）。在飞
-     * （delivering/running）的行不删：落定回调会把行写回来，删了也白删。
+     * 没有成因行可看、可操作），并续排空积压（下一条各自重新布防回执闸）。
+     *
+     * **在飞的投递行（delivering）也能强制移除**：投递卡住（后端不回）时它就是队头，
+     * 压着后面每一条都发不出去，闸/行都不给人动手就永远解不开。落定回调按「当前行」
+     * 收尾、行没了即返回（见 `runTerminal`），删了不会被写回来；泵闸也一并就地解除
+     * （那一拍还挂在这次投递上，不解除的话闸看着开了、泵却永远占着）。running
+     * 不在此列：那是编排域的一条真实子进程，删了行只是把活着的进程藏起来。
      */
     dismiss(sessionId: string, messageId: string): AnswerResult;
     /** 删掉队列里的一条待递送行（读到的行自己带 sessionId，配不上即不算命中）。 */
@@ -409,78 +521,56 @@ export declare class MessageDeliverer {
      * 闲 → headless。对象 = 拒绝（409 reason）；字符串 = 选中的通道。
      */
     private resolveChannel;
-    /** 不支持原因：面声明优先，缺省兜底文案。 */
-    private unsupportedReason;
     /**
      * 目标会话的 pane：① **hook 旁路上报的终端定位**（精确——会话自己所在的 pane，
      * 与标题是否漂移无关，也覆盖从没上报过标题的会话；后端已做存在性校验）→
      * ② 回落「标题（剥 spinner 前缀，字符集含 ◐ 等输入等待态）+ 项目 cwd」启发式
      * （无定位能力的终端 / 老 hook），歧义拒绝不打。
+     *
+     * `source='heuristic'` 跳过 ①：只给中断的补打用——① 命中的 pane 活着但已经
+     * 不是这个会话（换过窗口），宿主对那一记毫无反应，此时只剩「按标题认回来」一条路。
      */
     private terminalPaneFor;
     /** 层② 通道现取（装配期注入；与 settings 的 preset 无关，只有「没装」才是 null）。 */
     private terminalChannel;
+    /** 模态框在场时层② 不可盲注（见 deps.blockedByQuestion）。 */
+    private modalBlocked;
     /** prompt 通道入口（send 的即时路径）：层① 命中即时中继，层② 异步找 pane，都不行入队。 */
     private deliverPrompt;
     /**
-     * 层①-a 直投尝试：成功返回落定后的内存行；回落（无面 / 非手动 / 无目标 / 写失败）
+     * 层①-q 宿主自带队列（codex queue）：成功返回落定后的内存行；回落（无面 / 带图 /
+     * CLI 失败）返回 null，调用方照旧走下一层。**队列冲洗也走它**。exit 0 只说明
+     * 「已交给宿主队列」——真正的到达由 UPS 回执核销（codex 的队列投递在宿主眼里
+     * 就是用户输入，UPS 原文与投递正文逐字相同，回执比对天然成立）。
+     */
+    private tryQueuedDeliver;
+    /**
+     * 层①-a 直投尝试：成功返回落定后的内存行；回落（无面 / 无目标 / 强制终端 / 写失败）
      * 返回 null。**队列冲洗也走它**——冲洗恰好由「刚上报凭据的那条 hook 事件」触发，
      * 命中率最高；队列绕过它直奔中继，手动面就会凭空多出跨会话包裹与英文注记。
      */
     private tryInboxDeliver;
     /** 入队（promptbox 追加 + 会话索引登记）。 */
     private queueEntry;
-    /**
-     * 该会话是否已判死：claude 注册表 `pidAlive === false` 才认，`null` 不猜
-     * （codex / 新会话豁免窗 / SessionStart 空壳行都落 null）。判据与「已终止」
-     * 态、两条 terminated 补射同源（claude-liveness 的 pidAliveOf）——消息行与
-     * 会话行不会各说各话。
-     */
     private sessionJudgedDead;
-    /**
-     * 判死落定：三层全无通路、目标进程又不在——**不假装排队**，落 `failed` +
-     * `reason: 'offline'`（`message.finished` 帧照抛，既有 messageFailed 订阅提醒
-     * 生效）。**刻意不置暂停闸**：队列整批转 offline 后已空，闸只会挡住用户重发
-     * ——重发是有意的可逆出口（判活残差 / 会话其实活着时，一点就回来）。
-     */
     private failOffline;
-    /** 冲洗时判死：**该会话全部队列行**都是死信（死会话投不进去），整批落定 + 清队。 */
     private failQueuedOffline;
-    /**
-     * 层① 中继：复用 HeadlessRunner 的 spawn 基建（win32 shell 单串 + stdin +
-     * 超时），键 = 合成键（不占目标会话的 headless 并发闸）。返回是否启动成功。
-     */
+    private relayDeps;
+    /** 层① 中继（判定与终态在 delivery/relay.ts）。 */
     private runRelay;
-    /**
-     * 中继终态：成功 = delivered（+message.delivered，布防回执闸；中继闸释放后若还有
-     * 积压继续下一批）；失败 = failed 留内存可见（+message.finished）并置暂停闸——
-     * 不自动重试（避免对活着但拒收的会话反复打中继），手动重发解除。
-     */
-    private settleRelay;
     /** 层② 终端注入终态（语义同中继：成功 delivered / 失败 failed 可见）。 */
     private runTerminalPrompt;
     /**
-     * 层② 只补一记回车（重发「已贴进框、没回执」的行）：文本在上一次投递里已经
-     * 落到会话的输入框，缺的只是那记提交键——重贴一次会在框里叠一份，用户收到
-     * 两遍正文与两遍图。
+     * 层② 只补一记回车（重发「已贴进框、没回执」的行 / 队列行 Enter 按钮共用）：
+     * 文本在上一次投递里已经落到会话的输入框，缺的只是那记提交键——重贴一次会在
+     * 框里叠一份，用户收到两遍正文与两遍图。
      */
     private runTerminalSubmit;
     private runTerminal;
-    /**
-     * 投递文本 = 用户原文经 harness `imageAttach.composePrompt` 现合成（带图时在
-     * 原文后追加图引用形态）。**只在投递那一刻合成**——`msg.text` 恒为用户原文
-     * （回执比对与气泡文案都要它），队列行也不存合成结果（换 harness 后仍按现面合成）。
-     */
-    private wireTextOf;
-    private hasImages;
     /** inject 通道：信封写 outbox → injected（fire-and-forget 语义）。 */
     private deliverInject;
     /** headless 通道：置 running → 无头 spawn；终态经 onSettle 后台回写。 */
     private deliverHeadless;
-    /** 信封：面可覆写（harness 自己的表示法）；缺省 weave 通用头 + 正文。 */
-    private renderEnvelope;
-    /** 终态落定（幂等，per-run state 守卫）：回写 → message.finished。 */
-    private settle;
     private bus;
 }
 export {};

package/node_modules/@weavecode/server/dist/hooks/message-deliverer.js

@@ -1,4 +1,2 @@
-import{randomUUID as A}from"node:crypto";import{chmodSync as D,mkdirSync as j,readFileSync as T,renameSync as P,writeFileSync as M}from"node:fs";import{tmpdir as _}from"node:os";import{dirname as B,join as p}from"node:path";import{WEAVE_INJECTION_MARKER as C,isHarness as R}from"@weavecode/core";import{messagingSurfaceFor as W}from"../surfaces.js";import{claudeLivenessById as g,pidAliveOf as v}from"../daemon/claude-liveness.js";import{normalizeDirKey as I}from"../daemon/opener.js";import{HeadlessRunner as F}from"./headless-runner.js";import{appendOutbox as q,hooksRoot as N}from"./mirror.js";import{INBOX_TARGETS_FILE as $,InboxSocketRegistry as K,deliverViaInboxSocket as L}from"./inbox-socket.js";import{appendPromptbox as Q,readAllPromptbox as H,readPromptbox as m,removePromptboxBySession as J,removePromptboxEntries as f,scanQueuedSessionIds as G}from"./promptbox.js";const U=()=>_(),V=1e3,X=6e4,z=12e4,Z=8,Y="Session is not running",ee=200,w=/^(?:[1-9]|n|\t|\r|\x1b\[B)$/,se=/^[^\x00-\x1f\x7f]*$/,te="\x1B",ie="\x1B[Z",ne=/^[^\s\x00-\x1f\x7f]{1,128}$/,re=u=>`/model ${u}`,oe=120,k=C;function y(u){return u.replace(/<\/?cross-session-message[^>]*>/g,"").replace(/\s+/g," ").trim()}function ae(u){const e=u.trimStart();return e.startsWith(k)?e.slice(k.length):e}function b(u){return u.replace(/\s+/g,"")}const O="pane-envs.json";function de(u){try{const e=JSON.parse(T(u,"utf8"));if(typeof e!="object"||e===null)return{};const t={};for(const[s,i]of Object.entries(e)){if(typeof i!="object"||i===null)continue;const n={};for(const[r,o]of Object.entries(i))typeof o=="string"&&o&&(n[r]=o);Object.keys(n).length>0&&(t[s]=n)}return t}catch{return{}}}const le=u=>new Promise(e=>setTimeout(e,u));export class MessageDeliverer{deps;headless;hooksDir;memory=new Map;queuedSessions;inboxSockets;paneEnvs;persistedPaneEnvs;flushScheduled=new Set;flushing=new Set;stalled=new Map;awaitingAck=new Map;dismissedIds=new Set;constructor(e){this.deps=e,this.headless=e.headless??new F({spawnImpl:e.spawnImpl,killImpl:e.killImpl}),this.hooksDir=e.hooksDir??N(),this.inboxSockets=new K(p(this.hooksDir,$));const t=de(p(this.hooksDir,O));this.paneEnvs=new Map(Object.entries(t)),this.persistedPaneEnvs=JSON.stringify(t),this.queuedSessions=G(this.hooksDir)}async send(e){const t=this.deps.sessions.getBySessionId(e.toSessionId);if(!t)return{ok:!1,status:404,error:"Session not found"};const s=this.surfaceOfSession(e.toSessionId);if(!s)return{ok:!1,status:400,error:"Session has no hook events to determine its harness"};const i=e.images?[...e.images]:[];if(i.length>0&&!s.imageAttach)return{ok:!1,status:409,error:"This harness cannot receive images"};const n=this.resolveChannel(e.mode,e.toSessionId,s);if(typeof n!="string")return{ok:!1,status:409,error:n.reason};if(t.projectId==null)return{ok:!1,status:400,error:"Session is not bound to a project"};const r=this.deps.projects.getById(t.projectId);if(!r)return{ok:!1,status:404,error:"Project not found"};if(n==="headless"&&this.headless.isBusy(e.toSessionId))return{ok:!1,status:409,error:"Session already has a running run"};const o={fromLabel:e.fromKind==="session"?`session ${e.fromSessionId??"unknown"}`:e.fromKind,at:new Date().toISOString(),mode:n},a={id:A(),sessionId:e.toSessionId,text:e.text,...i.length>0?{images:i}:{},mode:e.mode,oneWay:e.oneWay===!0,...e.forceTerminal===!0?{forceTerminal:!0}:{},channel:n,status:"pending",at:o.at},d=n==="prompt"&&this.blockedAhead(a.sessionId);d&&(this.queueEntry(a,r.token),this.scheduleFlushContinuation(a.sessionId));const l=d?{ok:!0,messageId:a.id,status:"pending",message:a}:n==="inject"?this.deliverInject(a,r.token,o,s):n==="headless"?this.deliverHeadless(a,r.path,o,s):await this.deliverPrompt(a,t,r,s);return this.bus({kind:"message.created",messageId:a.id,sessionId:a.sessionId,mode:a.mode,at:a.at}),l}getMessage(e){return this.memory.get(e)??null}listVisible(e){const t=this.deps.visibleTtlMs??X,s=Date.now(),i=[],n=this.deps.sessions.getBySessionId(e);if(n?.projectId!=null){const r=this.deps.projects.getById(n.projectId);if(r)for(const o of m(this.hooksDir,r.token))o.sessionId===e&&i.push({id:o.id,sessionId:e,text:o.text,...o.images&&o.images.length>0?{images:o.images}:{},mode:"prompt",oneWay:o.oneWay===!0,...o.forceTerminal===!0?{forceTerminal:!0}:{},channel:"prompt",status:"pending",at:o.at})}for(const r of this.memory.values()){if(r.sessionId!==e)continue;if(r.stalled===!0||r.status==="delivering"||r.status==="running"){i.push(r);continue}if(r.status==="failed"||r.status==="timeout"){i.push(r);continue}const o=r.settledAt?Date.parse(r.settledAt):NaN;(r.status==="delivered"&&r.acked!==!0||!Number.isNaN(o)&&s-o<t)&&i.push(r)}return i.sort((r,o)=>r.at<o.at?-1:1)}hasQueued(e){return this.queuedSessions.has(e)}listInflightCounts(){const e=new Map,t=s=>{e.set(s,(e.get(s)??0)+1)};for(const s of H(this.hooksDir))t(s.sessionId);for(const s of this.memory.values())(s.status==="delivering"||s.status==="running")&&t(s.sessionId);return e}hasTerminalChannel(){return this.terminalChannel()!=null}scheduleFlushContinuation(e){if(this.flushScheduled.has(e))return;this.flushScheduled.add(e),setTimeout(()=>{this.flushScheduled.delete(e),this.flushSession(e)},this.deps.flushGapMs??V).unref?.()}ackGateOpen(e){const t=this.awaitingAck.get(e);if(t===void 0)return!0;const s=this.memory.get(t);return s&&s.acked!==!0&&s.status!=="failed"&&s.status!=="timeout"?!1:(this.awaitingAck.delete(e),!0)}blockedAhead(e){return this.ackGateOpen(e)?this.queuedSessions.has(e)||this.flushing.has(e):!0}noteInboxSocket(e,t){this.inboxSockets.set(e,t)}notePaneEnv(e,t){this.paneEnvs.set(e,t),this.persistPaneEnvs()}persistPaneEnvs(){const e=JSON.stringify(Object.fromEntries(this.paneEnvs));if(e===this.persistedPaneEnvs)return;const t=p(this.hooksDir,O);try{j(B(t),{recursive:!0});const s=`${t}.tmp`;M(s,`${e}
-`,{encoding:"utf8",mode:384}),P(s,t),D(t,384),this.persistedPaneEnvs=e}catch{}}sessionExited(e){this.inboxSockets.forget(e),this.paneEnvs.delete(e),this.persistPaneEnvs(),this.awaitingAck.delete(e);const t=this.deps.sessions.getBySessionId(e),s=t?.projectId==null?null:this.deps.projects.getById(t.projectId);if(!s)return;const i=m(this.hooksDir,s.token).filter(n=>n.sessionId===e);this.failQueuedOffline(e,i.filter(n=>!this.dismissedIds.has(n.id)))}async sessionTerminals(){const e=this.terminalChannel();if(!e?.locateScreens||this.paneEnvs.size===0)return{};const t={},s=this.deps.livenessOf?.()??g();for(const[i,n]of this.paneEnvs){if(this.sessionJudgedDead(i,s)){this.paneEnvs.delete(i),this.persistPaneEnvs();continue}t[i]=n}return e.locateScreens(t)}diagnose(e){const t=this.surfaceOfSession(e),s=this.deps.sessions.livenessRowOf(e),i=s?v(s,this.deps.livenessOf?.()??g()):null,n=t?.promptInbox??null,r=this.inboxSockets.get(e),o=n?r?n.requiresAuthOn(process.platform)&&!r.token?{status:"unavailable",reason:"auth-token-required"}:{status:"ready",reason:null}:{status:"unavailable",reason:"no-credentials"}:{status:"unavailable",reason:"no-mechanism"},a=t?.prompt?.resolve(e)??null,d=t?.prompt?a?{status:"ready",reason:null}:{status:"unavailable",reason:"no-peer-name"}:{status:"unavailable",reason:"no-mechanism"},l=this.paneEnvs.has(e),h=this.terminalChannel()?l?{status:"ready",reason:null}:{status:"unknown",reason:"no-pane-env"}:{status:"unavailable",reason:"no-backend"},c=this.deps.sessions.getBySessionId(e),S=c?.projectId==null?null:this.deps.projects.getById(c.projectId),E=S?m(this.hooksDir,S.token).filter(x=>x.sessionId===e).length:0;return{alive:i,inbox:o,relay:d,terminal:h,paneEnvReported:l,pending:E,stalled:this.stalled.has(e)}}onSessionPrompt(e,t,s){const i=y(ae(t)),n=i.replace(/\[Image #\d+\]/gi,"").trim(),r=[];let o=!1;for(const a of[...this.memory.values()].reverse()){if(a.sessionId!==e||a.acked||a.mode!=="prompt")continue;const d=y(a.text),l=!!d&&(d.length>=Z?i.includes(d):i===d),h=(a.images?.length??0)>0&&(d?b(i).includes(b(d)):n.length===0);!l&&!h||(o=!0,this.memory.set(a.id,{...a,acked:!0,stalled:!1,...s===void 0?{}:{ackedEventId:s}}),this.stalled.get(e)?.messageId===a.id&&this.stalled.delete(e),this.awaitingAck.get(e)===a.id&&this.awaitingAck.delete(e),r.push(...a.images?.map(c=>c.id)??[]),this.bus({kind:"message.acknowledged",messageId:a.id,sessionId:e,at:new Date().toISOString()}))}return o&&this.queuedSessions.has(e)&&this.scheduleFlushContinuation(e),r}armAckWatch(e){setTimeout(()=>{const s=this.memory.get(e.id);!s||s.acked||s.status!=="delivered"||this.stall(s.sessionId,s,"unacked")},this.deps.ackStallMs??z).unref?.()}stall(e,t,s){this.stalled.set(e,{messageId:t.id,reason:s});const i=this.memory.get(t.id);i&&this.memory.set(t.id,{...i,stalled:!0}),this.bus({kind:"message.stalled",messageId:t.id,sessionId:e,reason:s,at:new Date().toISOString()})}async answer(e,t){if(t.length===0||!w.test(t[0])||t.some(i=>!w.test(i)&&!se.test(i)))return{ok:!1,status:400,error:"Invalid answer keys"};const s=await this.sessionKeysTarget(e);if(!s.ok)return s;try{for(const[i,n]of t.entries())i>0&&await le(oe),await s.terminal.sendKeys(s.paneId,n);return{ok:!0}}catch(i){return{ok:!1,status:409,error:i instanceof Error?i.message:String(i)}}}async interrupt(e){const t=await this.sessionKeysTarget(e);if(!t.ok)return t;try{return await t.terminal.sendKeys(t.paneId,te),{ok:!0}}catch(s){return{ok:!1,status:409,error:s instanceof Error?s.message:String(s)}}}async closePane(e){const t=await this.sessionKeysTarget(e,"\u5173\u95ED");if(!t.ok)return t;try{return await t.terminal.closePane(t.paneId),{ok:!0}}catch(s){return{ok:!1,status:409,error:s instanceof Error?s.message:String(s)}}}async cycleMode(e){const t=await this.sessionKeysTarget(e);if(!t.ok)return t;try{return await t.terminal.sendKeys(t.paneId,ie),{ok:!0}}catch(s){return{ok:!1,status:409,error:s instanceof Error?s.message:String(s)}}}async setModel(e,t){const s=t.trim();if(!ne.test(s))return{ok:!1,status:400,error:"\u6A21\u578B\u540D\u5F62\u6001\u4E0D\u5408\u6CD5\uFF08\u4E0D\u542B\u7A7A\u767D\u4E0E\u63A7\u5236\u5B57\u7B26\uFF0C\u2264128 \u5B57\u7B26\uFF09"};const i=await this.sessionKeysTarget(e);if(!i.ok)return i;try{return await i.terminal.sendText(i.paneId,re(s)),{ok:!0}}catch(n){return{ok:!1,status:409,error:n instanceof Error?n.message:String(n)}}}async sessionKeysTarget(e,t="\u51FB\u952E"){const s=this.deps.sessions.getBySessionId(e);if(!s)return{ok:!1,status:404,error:"Session not found"};if(s.projectId==null)return{ok:!1,status:400,error:"Session is not bound to a project"};const i=this.deps.projects.getById(s.projectId);if(!i)return{ok:!1,status:404,error:"Project not found"};const n=this.terminalChannel();if(!n)return{ok:!1,status:409,error:`\u7EC8\u7AEF\u901A\u9053\u672A\u88C5\u914D\uFF0C\u65E0\u6CD5\u8FDC\u7A0B${t}`};const r=await this.terminalPaneFor(s,i);return r?{ok:!0,terminal:n,paneId:r.id}:{ok:!1,status:409,error:`\u627E\u4E0D\u5230\u4F1A\u8BDD\u6240\u5728\u7684\u7EC8\u7AEF\u7A97\u53E3\u2014\u2014\u8FD9\u4E2A\u4F1A\u8BDD\u6240\u5728\u7EC8\u7AEF\u6CA1\u6709\u53EF\u7528\u7684\u8FDC\u7A0B${t}\u901A\u9053`}}async resend(e){const t=this.memory.get(e);if(!t)return{ok:!1,status:404,error:"Message not found"};if(!(t.channel==="prompt"&&(t.status==="failed"||t.status==="delivered"&&!t.acked)))return{ok:!1,status:409,error:"Message is not resendable"};const i=this.deps.sessions.getBySessionId(t.sessionId);if(!i)return{ok:!1,status:404,error:"Session not found"};if(i.projectId==null)return{ok:!1,status:400,error:"Session is not bound to a project"};const n=this.deps.projects.getById(i.projectId);if(!n)return{ok:!1,status:404,error:"Project not found"};const r=this.surfaceOfSession(t.sessionId);if(!r)return{ok:!1,status:400,error:"Session has no hook events to determine its harness"};if(this.stalled.get(t.sessionId)?.messageId===e&&this.stalled.delete(t.sessionId),t.status==="delivered"&&t.via==="terminal"&&this.terminalChannel()){const d=await this.terminalPaneFor(i,n);if(d)return this.memory.set(e,{...t,status:"delivering",stalled:!1,settledAt:null}),this.runTerminalSubmit(e,d.id),this.bus({kind:"message.created",messageId:e,sessionId:t.sessionId,mode:t.mode,at:new Date().toISOString()}),{ok:!0,messageId:e,status:"delivering",message:this.memory.get(e)}}this.memory.delete(e);const o={...t,status:"pending",stalled:!1,acked:!1,settledAt:null},a=await this.deliverPrompt(o,i,n,r);return this.bus({kind:"message.created",messageId:o.id,sessionId:o.sessionId,mode:o.mode,at:new Date().toISOString()}),a}dismiss(e,t){const s=this.memory.get(t);if(s){if(s.status==="delivering"||s.status==="running")return{ok:!1,status:409,error:"Message is still in flight"};this.memory.delete(t),this.stalled.get(s.sessionId)?.messageId===t&&this.stalled.delete(s.sessionId),this.awaitingAck.get(s.sessionId)===t&&this.awaitingAck.delete(s.sessionId),this.queuedSessions.has(s.sessionId)&&this.scheduleFlushContinuation(s.sessionId)}else if(!this.dropQueued(e,t))return{ok:!1,status:404,error:"Message not found"};return this.bus({kind:"message.dismissed",messageId:t,sessionId:e,at:new Date().toISOString()}),{ok:!0}}dropQueued(e,t){const s=this.deps.sessions.getBySessionId(e);if(s?.projectId==null)return!1;const i=this.deps.projects.getById(s.projectId);if(!i)return!1;const n=m(this.hooksDir,i.token);if(!n.some(r=>r.id===t&&r.sessionId===e))return!1;for(f(this.hooksDir,i.token,new Set([t])),this.dismissedIds.add(t);this.dismissedIds.size>ee;){const r=this.dismissedIds.values().next().value;if(r===void 0)break;this.dismissedIds.delete(r)}return n.some(r=>r.sessionId===e&&r.id!==t)||this.queuedSessions.delete(e),!0}async flushSession(e){if(!this.stalled.has(e)&&!this.flushing.has(e)&&this.queuedSessions.has(e)){this.flushing.add(e);try{await this.flushSessionInner(e)}catch{}finally{this.flushing.delete(e)}}}async flushSessionInner(e){if(!this.ackGateOpen(e))return;const t=this.deps.sessions.getBySessionId(e);if(t?.projectId==null)return;const s=this.deps.projects.getById(t.projectId);if(!s)return;const i=m(this.hooksDir,s.token).filter(o=>o.sessionId===e);if(i.length===0){this.queuedSessions.delete(e);return}if(this.sessionJudgedDead(e)){this.failQueuedOffline(e,i.filter(o=>!this.dismissedIds.has(o.id)));return}const n=this.surfaceOfSession(e),r=n?.prompt??null;for(const o of i){if(this.stalled.has(e))return;if(this.dismissedIds.has(o.id))continue;const a={id:o.id,sessionId:e,text:o.text,...o.images&&o.images.length>0?{images:o.images}:{},mode:"prompt",oneWay:o.oneWay===!0,...o.forceTerminal===!0?{forceTerminal:!0}:{},via:"socket",channel:"prompt",status:"pending",at:o.at};if(this.hasImages(a)&&this.terminalChannel()){const h=await this.terminalPaneFor(t,s);if(h){f(this.hooksDir,s.token,new Set([o.id])),this.memory.set(a.id,{...a,via:"terminal",status:"delivering"}),this.awaitingAck.set(e,a.id),await this.runTerminalPrompt(a.id,h.id,this.wireTextOf(a)),this.settleQueueIndex(e,s.token);return}}if(n&&await this.tryInboxDeliver(a,n)){f(this.hooksDir,s.token,new Set([o.id])),this.settleQueueIndex(e,s.token);return}const d=r?.resolve(e)??null,l=a.forceTerminal===!0?["terminal"]:a.oneWay===!0?["terminal","relay"]:["relay","terminal"];for(const h of l){if(h==="relay"&&r&&d){if(this.memory.set(a.id,{...a,status:"delivering",via:"relay"}),!this.runRelay(a,r,d.name)){this.memory.delete(a.id);return}this.awaitingAck.set(e,a.id),f(this.hooksDir,s.token,new Set([o.id]));break}if(h==="terminal"&&this.terminalChannel()){const c=await this.terminalPaneFor(t,s);if(c){f(this.hooksDir,s.token,new Set([o.id])),this.memory.set(a.id,{...a,via:"terminal",status:"delivering"}),this.awaitingAck.set(e,a.id),await this.runTerminalPrompt(a.id,c.id,this.wireTextOf(a));break}}}if(this.awaitingAck.get(e)===a.id){this.settleQueueIndex(e,s.token);return}return}this.settleQueueIndex(e,s.token)}settleQueueIndex(e,t){m(this.hooksDir,t).every(s=>s.sessionId!==e)&&this.queuedSessions.delete(e)}async flushAll(){for(const e of[...this.queuedSessions])await this.flushSession(e)}forgetSession(e){let t=0;for(const[s,i]of this.memory)i.sessionId===e&&(this.memory.delete(s),t++);return t+=J(this.hooksDir,e),this.queuedSessions.delete(e),this.stalled.delete(e),this.awaitingAck.delete(e),this.inboxSockets.forget(e),this.paneEnvs.delete(e),this.persistPaneEnvs(),t}forgetProject(e){let t=0;for(const[s,i]of this.memory)this.deps.sessions.getBySessionId(i.sessionId)?.projectId===e&&(this.memory.delete(s),this.inboxSockets.forget(i.sessionId),this.paneEnvs.delete(i.sessionId),this.stalled.delete(i.sessionId),this.awaitingAck.delete(i.sessionId),t++);for(const s of[...this.queuedSessions])this.deps.sessions.getBySessionId(s)?.projectId===e&&(t+=this.forgetSession(s));return this.persistPaneEnvs(),t}surfaceOfSession(e){const t=this.deps.hookEvents.listBySession(e,1),s=t[t.length-1]?.source;return R(s)?this.deps.surfaceFor?.(s)??W(s):null}resolveChannel(e,t,s){if(e==="prompt")return s.prompt||this.terminalChannel()?"prompt":{reason:s.unsupportedReasons?.prompt??`Harness "${s.harness}" has no native prompt channel and the configured terminal cannot inject text`};if(e==="inject"||e==="headless")return(e==="inject"?s.inject:s.headless)?e:{reason:this.unsupportedReason(s,e)};const n=this.deps.sessions.turnOpenOf(t)?"inject":"headless";return(n==="inject"?s.inject:s.headless)?n:{reason:this.unsupportedReason(s,n)}}unsupportedReason(e,t){return e.unsupportedReasons?.[t]??`Harness "${e.harness}" does not support the ${t} messaging channel`}async terminalPaneFor(e,t){const s=this.terminalChannel();if(!s)return null;const i=this.paneEnvs.get(e.sessionId);if(i){const d=await s.locatePane?.(i).catch(()=>null);if(d)return{id:d}}if(!e.title)return null;const n=e.title.replace(/^[✻✽✶✳✢⋅◦✦✧∘◐◑◒◓*]+\s*/,""),r=I(t.path,process.platform);let o;try{o=await s.listPanes()}catch{return null}const a=o.filter(d=>d.title!=null&&d.cwd!=null&&r!=null&&d.title.replace(/^[✻✽✶✳✢⋅◦✦✧∘◐◑◒◓*]+\s*/,"")===n&&I(d.cwd,process.platform)===r);return a.length===1?a[0]:null}terminalChannel(){const e=this.deps.terminal;return e&&e.available()?e:null}async deliverPrompt(e,t,s,i){if(this.sessionJudgedDead(e.sessionId))return{ok:!0,messageId:e.id,status:"failed",message:this.failOffline(e)};if(this.hasImages(e)&&this.terminalChannel()){const l=await this.terminalPaneFor(t,s);if(l)return this.memory.set(e.id,{...e,status:"delivering",via:"terminal"}),this.awaitingAck.set(e.sessionId,e.id),this.runTerminalPrompt(e.id,l.id,this.wireTextOf(e)),{ok:!0,messageId:e.id,status:"delivering",message:this.memory.get(e.id)}}const n=await this.tryInboxDeliver(e,i);if(n)return{ok:!0,messageId:e.id,status:"delivered",message:n};const r=i.prompt,o=r?.resolve(e.sessionId)??null,a=e.forceTerminal===!0?["terminal"]:e.oneWay===!0?["terminal","relay"]:["relay","terminal"];for(const l of a){if(l==="relay"&&r&&o){if(this.memory.set(e.id,{...e,status:"delivering",via:"relay"}),this.runRelay(e,r,o.name))return this.awaitingAck.set(e.sessionId,e.id),{ok:!0,messageId:e.id,status:"delivering",message:this.memory.get(e.id)};this.memory.delete(e.id)}if(l==="terminal"&&this.terminalChannel()){const h=await this.terminalPaneFor(t,s);if(h)return this.memory.set(e.id,{...e,status:"delivering",via:"terminal"}),this.awaitingAck.set(e.sessionId,e.id),this.runTerminalPrompt(e.id,h.id,this.wireTextOf(e)),{ok:!0,messageId:e.id,status:"delivering",message:this.memory.get(e.id)}}}if(this.sessionJudgedDead(e.sessionId))return{ok:!0,messageId:e.id,status:"failed",message:this.failOffline(e)};this.queueEntry(e,s.token);const d={...e,status:"pending"};return{ok:!0,messageId:e.id,status:"pending",message:d}}async tryInboxDeliver(e,t){const s=t.promptInbox,i=this.inboxSockets.get(e.sessionId);if(!s||e.oneWay!==!0||!i||e.forceTerminal===!0)return null;this.memory.set(e.id,{...e,status:"delivering",via:"socket"});try{await L(s,i,`${k}${this.wireTextOf(e)}`)}catch{return this.memory.delete(e.id),null}const n={...this.memory.get(e.id),status:"delivered",via:"socket",settledAt:new Date().toISOString()};return this.memory.set(e.id,n),this.awaitingAck.set(e.sessionId,e.id),this.armAckWatch(n),this.bus({kind:"message.delivered",messageId:e.id,sessionId:e.sessionId,at:new Date().toISOString()}),n}queueEntry(e,t){Q(this.hooksDir,t,[{id:e.id,sessionId:e.sessionId,text:e.text,oneWay:e.oneWay===!0,...e.forceTerminal===!0?{forceTerminal:!0}:{},...e.images&&e.images.length>0?{images:e.images}:{}}]),this.queuedSessions.add(e.sessionId)}sessionJudgedDead(e,t=this.deps.livenessOf?.()??g()){const s=this.deps.sessions.livenessRowOf(e);return s?v(s,t)===!1:!1}failOffline(e){const t=new Date().toISOString(),s={...e,status:"failed",reason:"offline",error:Y,settledAt:t};return this.memory.set(e.id,s),this.bus({kind:"message.finished",messageId:e.id,sessionId:e.sessionId,status:"failed",at:t}),s}failQueuedOffline(e,t){const s=this.deps.sessions.getBySessionId(e),i=s?.projectId==null?null:this.deps.projects.getById(s.projectId);if(!(!i||t.length===0)){for(const n of t)this.failOffline({id:n.id,sessionId:e,text:n.text,...n.images&&n.images.length>0?{images:n.images}:{},mode:"prompt",oneWay:n.oneWay===!0,channel:"prompt",status:"pending",at:n.at});f(this.hooksDir,i.token,new Set(t.map(n=>n.id))),this.queuedSessions.delete(e)}}runRelay(e,t,s){try{return this.headless.run({sessionId:`prompt-relay:${e.sessionId}`,cwd:U(),prompt:t.instruction(s,this.wireTextOf(e),{oneWay:e.oneWay===!0}),spec:{supported:!0,bin:t.bin,args:()=>[...t.args],promptStdin:!0},bin:this.deps.bin??process.env.WEAVE_CLAUDE_BIN??t.bin,timeoutMs:this.deps.relayTimeoutMs??0,detached:!1,onSettle:i=>this.settleRelay(e.id,i)})}catch(i){return this.settleRelay(e.id,{status:"failed",output:null,error:i instanceof Error?i.message:String(i)}),!0}}settleRelay(e,t){const s=this.memory.get(e);if(!s)return;if(t.status==="succeeded"){this.queuedSessions.has(s.sessionId)&&this.scheduleFlushContinuation(s.sessionId);const n={...s,status:"delivered",settledAt:new Date().toISOString()};this.memory.set(e,n),this.armAckWatch(n),this.bus({kind:"message.delivered",messageId:e,sessionId:s.sessionId,at:new Date().toISOString()});return}if(s.acked===!0){const n=new Date().toISOString();this.memory.set(e,{...s,status:"delivered",settledAt:n}),this.bus({kind:"message.delivered",messageId:e,sessionId:s.sessionId,at:n});return}const i={...s,status:"failed",error:t.error??`prompt relay ${t.status}`,settledAt:new Date().toISOString()};this.memory.set(e,i),this.stall(s.sessionId,i,"failed"),this.bus({kind:"message.finished",messageId:e,sessionId:s.sessionId,status:"failed",at:new Date().toISOString()})}async runTerminalPrompt(e,t,s){await this.runTerminal(e,i=>i.sendText(t,s))}async runTerminalSubmit(e,t){await this.runTerminal(e,s=>s.sendKeys(t,"\r"))}async runTerminal(e,t){const s=this.memory.get(e);if(!s)return;const i=this.terminalChannel();if(i)try{await t(i);const r={...this.memory.get(e)??s,status:"delivered",settledAt:new Date().toISOString()};this.memory.set(e,r),this.armAckWatch(r),this.bus({kind:"message.delivered",messageId:e,sessionId:s.sessionId,at:new Date().toISOString()})}catch(n){const r=this.memory.get(e)??s;if(r.acked===!0){const a=new Date().toISOString();this.memory.set(e,{...r,status:"delivered",settledAt:a}),this.bus({kind:"message.delivered",messageId:e,sessionId:r.sessionId,at:a});return}const o={...r,status:"failed",error:n instanceof Error?n.message:String(n),settledAt:new Date().toISOString()};this.memory.set(e,o),this.stall(s.sessionId,o,"failed"),this.bus({kind:"message.finished",messageId:e,sessionId:s.sessionId,status:"failed",at:new Date().toISOString()})}}wireTextOf(e){const t=e.images;return!t||t.length===0?e.text:this.surfaceOfSession(e.sessionId)?.imageAttach?.composePrompt(e.text,t)??e.text}hasImages(e){return(e.images?.length??0)>0}deliverInject(e,t,s,i){const n=this.renderEnvelope(this.wireTextOf(e),s,i);q(this.hooksDir,t,[{sessionId:e.sessionId,text:n}]);const r={...e,status:"injected",settledAt:new Date().toISOString()};return this.memory.set(r.id,r),this.bus({kind:"message.delivered",messageId:r.id,sessionId:r.sessionId,at:new Date().toISOString()}),{ok:!0,messageId:r.id,status:"injected",message:r}}deliverHeadless(e,t,s,i){const n=i.headless,r={...e,status:"running"};this.memory.set(r.id,r);const o={settled:!1};try{this.headless.run({sessionId:r.sessionId,cwd:t,prompt:this.renderEnvelope(this.wireTextOf(r),s,i),spec:n,bin:this.deps.bin??process.env.WEAVE_CLAUDE_BIN??n.bin,timeoutMs:this.deps.timeoutMs,onSettle:d=>this.settle(r,o,d)})||this.settle(r,o,{status:"failed",output:null,error:"Session already has a running run"})}catch(a){this.settle(r,o,{status:"failed",output:null,error:a instanceof Error?a.message:String(a)})}return{ok:!0,messageId:r.id,status:"running",message:this.memory.get(r.id)}}renderEnvelope(e,t,s){return s.renderEnvelope?.(e,t)??`[weave message] from=${t.fromLabel} at=${t.at} mode=${t.mode}
-
-${e}`}settle(e,t,s){if(t.settled)return;t.settled=!0;const i=this.memory.get(e.id);if(i)try{this.memory.set(e.id,{...i,status:s.status,output:s.output,error:s.error,settledAt:new Date().toISOString()}),this.bus({kind:"message.finished",messageId:e.id,sessionId:e.sessionId,status:s.status,at:new Date().toISOString()})}catch{}}bus(e){try{this.deps.bus?.emit(e)}catch{}}}
+import{randomUUID as D}from"node:crypto";import{chmodSync as T,mkdirSync as A,readFileSync as O,renameSync as x,writeFileSync as C}from"node:fs";import{dirname as F,join as g}from"node:path";import{isHarness as P}from"@weavecode/core";import{turnOutputOf as j}from"@weavecode/harness";import{isImageMediaType as k}from"../repositories/uploads.js";import{messagingSurfaceFor as M}from"../surfaces.js";import{claudeLivenessById as I,pidAliveOf as B}from"../daemon/claude-liveness.js";import{HeadlessRunner as q}from"./headless-runner.js";import{hooksRoot as Q}from"./mirror.js";import{INBOX_TARGETS_FILE as R,InboxSocketRegistry as K,deliverViaInboxSocket as W}from"./inbox-socket.js";import{AckGate as _}from"./delivery/ack-gate.js";import{ANSWER_ATOM as S,ANSWER_ATOM_GAP_MS as N,ANSWER_TEXT as G,CTRL_C as J,ENTER as L,ESC as H,MODEL_NAME as $,SHIFT_TAB as z,effortCommand as V,effortLevelsOf as U,locateTerminalPane as X,modelCommand as Z,sessionKeysTarget as Y}from"./delivery/keys.js";import{hasImages as ss,settleDelivered as v,spawnOnce as es,wireTextOf as ts}from"./delivery/channels.js";import{deliverHeadless as is,deliverInject as ns,resolveChannel as rs}from"./delivery/send.js";import{appendQueueEntry as as,failOffline as os,failQueuedOffline as us,sessionJudgedDead as ds}from"./delivery/queue.js";import{runRelay as hs}from"./delivery/relay.js";import{listInflightCounts as ls,listVisible as ms,sessionTerminals as cs}from"./delivery/views.js";import{readPromptbox as p,removePromptboxBySession as fs,removePromptboxEntries as f,scanQueuedSessionIds as ps}from"./promptbox.js";const gs=1e3,ys=6e4,ks=3e4,Is=9e4,Ss=5e3,vs=8,ws=250,bs=5,Es=200;export function isSlashCommand(c){return/^\/[A-Za-z][A-Za-z0-9:_-]*(\s|$)/.test(c.trim())}const w="pane-envs.json";function Ds(c){try{const s=JSON.parse(O(c,"utf8"));if(typeof s!="object"||s===null)return{};const e={};for(const[t,i]of Object.entries(s)){if(typeof i!="object"||i===null)continue;const n={};for(const[r,u]of Object.entries(i))typeof u=="string"&&u&&(n[r]=u);Object.keys(n).length>0&&(e[t]=n)}return e}catch{return{}}}const Ts=c=>new Promise(s=>setTimeout(s,c));export class MessageDeliverer{deps;headless;hooksDir;memory=new Map;queuedSessions;inboxSockets;paneEnvs;persistedPaneEnvs;flushScheduled=new Set;flushing=new Map;stalled=new Map;awaitingAck=new Map;dismissedIds=new Set;gate;constructor(s){this.deps=s,this.headless=s.headless??new q({spawnImpl:s.spawnImpl,killImpl:s.killImpl}),this.hooksDir=s.hooksDir??Q(),this.inboxSockets=new K(g(this.hooksDir,R));const e=Ds(g(this.hooksDir,w));this.paneEnvs=new Map(Object.entries(e)),this.persistedPaneEnvs=JSON.stringify(e),this.queuedSessions=ps(this.hooksDir),this.gate=new _({awaitingAck:this.awaitingAck,stalled:this.stalled,memory:this.memory},{ackStallMs:s.ackStallMs??ks,ackStallReleaseMs:s.ackStallReleaseMs??Is,commandAckGraceMs:s.commandAckGraceMs??Ss},{emit:t=>this.bus(t)}),this.gate.onAutoRelease=t=>this.scheduleFlushContinuation(t)}async send(s){const e=this.deps.sessions.getBySessionId(s.toSessionId);if(!e)return{ok:!1,status:404,error:"Session not found"};const t=this.surfaceOfSession(s.toSessionId);if(!t)return{ok:!1,status:400,error:"Session has no hook events to determine its harness"};const i=s.attachments?[...s.attachments]:[];if(i.length>0){if(!t.attach)return{ok:!1,status:409,error:"This harness cannot receive attachments"};if(i.some(h=>k(h.mediaType))&&!t.attach.kinds.includes("image"))return{ok:!1,status:409,error:"This harness cannot receive images"};if(i.some(h=>!k(h.mediaType))&&!t.attach.kinds.includes("file"))return{ok:!1,status:409,error:"This harness cannot receive file attachments"}}const n=this.resolveChannel(s.mode,s.toSessionId,t);if(typeof n!="string")return{ok:!1,status:409,error:n.reason};if(e.projectId==null)return{ok:!1,status:400,error:"Session is not bound to a project"};const r=this.deps.projects.getById(e.projectId);if(!r)return{ok:!1,status:404,error:"Project not found"};if(n==="headless"&&this.headless.isBusy(s.toSessionId))return{ok:!1,status:409,error:"Session already has a running run"};const u={fromLabel:s.fromKind==="session"?`session ${s.fromSessionId??"unknown"}`:s.fromKind,at:new Date().toISOString(),mode:n},a={id:D(),sessionId:s.toSessionId,text:s.text,...i.length>0?{attachments:i}:{},mode:s.mode,oneWay:s.oneWay===!0,...s.forceTerminal===!0?{forceTerminal:!0}:{},channel:n,status:"pending",at:u.at},o=n==="prompt"&&this.blockedAhead(a.sessionId);o&&(this.queueEntry(a,r.token),this.scheduleFlushContinuation(a.sessionId));const l=o?{ok:!0,messageId:a.id,status:"pending",message:a}:n==="inject"?this.deliverInject(a,r.token,u,t):n==="headless"?this.deliverHeadless(a,r.path,u,t):await this.deliverPrompt(a,e,r,t);return this.bus({kind:"message.created",messageId:a.id,sessionId:a.sessionId,mode:a.mode,at:a.at}),l}getMessage(s){return this.memory.get(s)??null}listVisible(s){return ms(this.deps,this.hooksDir,this.memory,s,this.deps.visibleTtlMs??ys)}hasQueued(s){return this.queuedSessions.has(s)}listInflightCounts(){return ls(this.hooksDir,this.memory)}hasTerminalChannel(){return this.terminalChannel()!=null}scheduleFlushContinuation(s){this.flushScheduled.has(s)||(this.flushScheduled.add(s),setTimeout(()=>{this.flushScheduled.delete(s),this.flushSession(s)},this.deps.flushGapMs??gs).unref?.())}ackGateOpen(s){return this.gate.open(s)}blockedAhead(s){return this.ackGateOpen(s)?this.queuedSessions.has(s)||this.flushing.has(s):!0}noteInboxSocket(s,e){this.inboxSockets.set(s,e)}async awaitInboxReady(s,e){const t=this.surfaceOfSession(s)?.promptInbox??null;if(!t)return!1;const i=()=>{const r=this.inboxSockets.get(s);return!!r&&(!t.requiresAuthOn(process.platform)||!!r.token)},n=Date.now()+e;for(;!i();){if(Date.now()>=n)return!1;await new Promise(r=>setTimeout(r,ws))}return!0}lastTurnOutput(s){const e=this.deps.hookEvents.listBySession(s,bs);for(let t=e.length-1;t>=0;t--){const i=e[t];let n=null;try{n=JSON.parse(i.payload)}catch{continue}const r=j(n?.raw);if(r)return{output:r,at:i.createdAt}}return null}notePaneEnv(s,e){this.paneEnvs.set(s,e),this.persistPaneEnvs()}persistPaneEnvs(){const s=JSON.stringify(Object.fromEntries(this.paneEnvs));if(s===this.persistedPaneEnvs)return;const e=g(this.hooksDir,w);try{A(F(e),{recursive:!0});const t=`${e}.tmp`;C(t,`${s}
+`,{encoding:"utf8",mode:384}),x(t,e),T(e,384),this.persistedPaneEnvs=s}catch{}}sessionExited(s){this.inboxSockets.forget(s),this.paneEnvs.delete(s),this.persistPaneEnvs(),this.awaitingAck.delete(s);const e=this.deps.sessions.getBySessionId(s),t=e?.projectId==null?null:this.deps.projects.getById(e.projectId);if(!t)return;const i=p(this.hooksDir,t.token).filter(n=>n.sessionId===s);this.failQueuedOffline(s,i.filter(n=>!this.dismissedIds.has(n.id)))}async sessionTerminals(){return cs(this.deps,this.terminalChannel(),this.paneEnvs,()=>this.persistPaneEnvs())}diagnose(s){const e=this.surfaceOfSession(s),t=this.deps.sessions.livenessRowOf(s),i=t?B(t,this.deps.livenessOf?.()??I()):null,n=e?.promptInbox??null,r=this.inboxSockets.get(s),u=n?r?n.requiresAuthOn(process.platform)&&!r.token?{status:"unavailable",reason:"auth-token-required"}:{status:"ready",reason:null}:{status:"unavailable",reason:"no-credentials"}:{status:"unavailable",reason:"no-mechanism"},a=e?.queuedPrompt?{status:"ready",reason:null}:{status:"unavailable",reason:"no-mechanism"},o=e?.prompt?.resolve(s)??null,l=e?.prompt?o?{status:"ready",reason:null}:{status:"unavailable",reason:"no-peer-name"}:{status:"unavailable",reason:"no-mechanism"},h=this.paneEnvs.has(s),d=this.terminalChannel()?h?{status:"ready",reason:null}:{status:"unknown",reason:"no-pane-env"}:{status:"unavailable",reason:"no-backend"},m=this.deps.sessions.getBySessionId(s),y=m?.projectId==null?null:this.deps.projects.getById(m.projectId),b=y?p(this.hooksDir,y.token).filter(E=>E.sessionId===s).length:0;return{alive:i,inbox:u,queue:a,relay:l,terminal:d,paneEnvReported:h,pending:b,stalled:this.gate.isStalled(s)}}onSessionPrompt(s,e,t){const i=this.gate.acknowledge(s,e,t,{ackMinText:vs});return this.gate.hitLast&&this.queuedSessions.has(s)&&this.scheduleFlushContinuation(s),i}armAckWatch(s){this.gate.armAckWatch(s)}armCommandAck(s){this.gate.armCommandAck(s,e=>{this.queuedSessions.has(e)&&this.scheduleFlushContinuation(e)})}stall(s,e,t){this.gate.stall(s,e,t)}async answer(s,e){if(e.length===0||!S.test(e[0])||e.some(i=>!S.test(i)&&!G.test(i)))return{ok:!1,status:400,error:"Invalid answer keys"};const t=await this.sessionKeysTarget(s);if(!t.ok)return t;try{for(const[i,n]of e.entries())i>0&&await Ts(N),await t.terminal.sendKeys(t.paneId,n);return{ok:!0}}catch(i){return{ok:!1,status:409,error:i instanceof Error?i.message:String(i)}}}async interrupt(s,e="both",t){const i=await this.sessionKeysTarget(s,"\u51FB\u952E",e);if(!i.ok)return i;if(t!=null&&i.paneId===t)return{ok:!0,paneId:i.paneId,sent:!1};try{return await i.terminal.sendKeys(i.paneId,H),{ok:!0,paneId:i.paneId,sent:!0}}catch(n){return{ok:!1,status:409,error:n instanceof Error?n.message:String(n)}}}async closePane(s){const e=await this.sessionKeysTarget(s,"\u5173\u95ED");if(!e.ok)return e;try{return await e.terminal.closePane(e.paneId),{ok:!0}}catch(t){return{ok:!1,status:409,error:t instanceof Error?t.message:String(t)}}}async cycleMode(s){const e=await this.sessionKeysTarget(s);if(!e.ok)return e;try{return await e.terminal.sendKeys(e.paneId,z),{ok:!0}}catch(t){return{ok:!1,status:409,error:t instanceof Error?t.message:String(t)}}}async pressEnter(s){const e=await this.sessionKeysTarget(s);if(!e.ok)return e;try{return await e.terminal.sendKeys(e.paneId,L),{ok:!0}}catch(t){return{ok:!1,status:409,error:t instanceof Error?t.message:String(t)}}}async pressCtrlC(s){const e=await this.sessionKeysTarget(s);if(!e.ok)return e;try{return await e.terminal.sendKeys(e.paneId,J),{ok:!0}}catch(t){return{ok:!1,status:409,error:t instanceof Error?t.message:String(t)}}}async setModel(s,e){const t=e.trim();if(!$.test(t))return{ok:!1,status:400,error:"\u6A21\u578B\u540D\u5F62\u6001\u4E0D\u5408\u6CD5\uFF08\u4E0D\u542B\u7A7A\u767D\u4E0E\u63A7\u5236\u5B57\u7B26\uFF0C\u2264128 \u5B57\u7B26\uFF09"};const i=await this.sessionKeysTarget(s);if(!i.ok)return i;try{return await i.terminal.sendText(i.paneId,Z(t)),{ok:!0}}catch(n){return{ok:!1,status:409,error:n instanceof Error?n.message:String(n)}}}async setEffort(s,e){const t=e.trim(),i=await this.sessionKeysTarget(s);if(!i.ok)return i;const n=U(this.deps.hookEvents,s);if(!n.includes(t))return{ok:!1,status:400,error:`\u601D\u8003\u5F3A\u5EA6\u6863\u4F4D\u4E0D\u5408\u6CD5\uFF08\u53EF\u9009\uFF1A${n.join(" / ")||"\u65E0"}\uFF09`};try{return await i.terminal.sendText(i.paneId,V(t)),{ok:!0}}catch(r){return{ok:!1,status:409,error:r instanceof Error?r.message:String(r)}}}async askSideQuestion(s,e){if(!this.deps.sessions.getBySessionId(s))return{ok:!1,status:404,error:"Session not found"};const t=this.surfaceOfSession(s),i=t?.sideQuestion??null;if(!i)return{ok:!1,status:409,error:t?.unsupportedReasons?.sideQuestion??"\u8FD9\u4E2A harness \u6CA1\u6709\u65C1\u8DEF\u4F1A\u8BDD\u901A\u9053"};const n=i.validate(e);if(!n.ok)return{ok:!1,status:400,error:n.error};const r=await this.sessionKeysTarget(s,"\u53D1\u8D77\u65C1\u8DEF\u4F1A\u8BDD");if(!r.ok)return r;try{return await r.terminal.sendText(r.paneId,i.command(n.text)),{ok:!0,question:n.text}}catch(u){return{ok:!1,status:409,error:u instanceof Error?u.message:String(u)}}}async sessionKeysTarget(s,e="\u51FB\u952E",t="both"){return Y(this.keysDeps(),s,e,t)}busSafe(){return{emit:s=>this.bus(s)}}channelDeps(){return{setMemory:s=>this.memory.set(s.id,s),deleteMemory:s=>this.memory.delete(s),awaitAck:(s,e)=>this.gate.await(s,e),isSlashCommand,armAckWatch:s=>this.gate.armAckWatch(s),armCommandAck:s=>this.gate.armCommandAck(s,e=>{this.queuedSessions.has(e)&&this.scheduleFlushContinuation(e)}),emit:s=>this.bus(s),...this.deps.spawnImpl?{spawnImpl:this.deps.spawnImpl}:{}}}wireTextOfEntry(s){return ts(s,e=>this.surfaceOfSession(e))}hasImagesEntry(s){return ss(s)}keysDeps(){return{sessions:this.deps.sessions,projects:this.deps.projects,hookEvents:this.deps.hookEvents,terminalChannel:()=>this.terminalChannel(),terminalPaneFor:(s,e,t)=>this.terminalPaneFor(s,e,t)}}async resend(s){const e=this.memory.get(s);if(!e)return{ok:!1,status:404,error:"Message not found"};if(!(e.channel==="prompt"&&(e.status==="failed"||e.status==="delivered"&&!e.acked)))return{ok:!1,status:409,error:"Message is not resendable"};const t=this.deps.sessions.getBySessionId(e.sessionId);if(!t)return{ok:!1,status:404,error:"Session not found"};if(t.projectId==null)return{ok:!1,status:400,error:"Session is not bound to a project"};const i=this.deps.projects.getById(t.projectId);if(!i)return{ok:!1,status:404,error:"Project not found"};const n=this.surfaceOfSession(e.sessionId);if(!n)return{ok:!1,status:400,error:"Session has no hook events to determine its harness"};if(this.gate.clearStall(e.sessionId,s),e.status==="delivered"&&e.via==="terminal"&&this.terminalChannel()){const a=await this.terminalPaneFor(t,i);if(a)return this.memory.set(s,{...e,status:"delivering",stalled:!1,settledAt:null}),this.runTerminalSubmit(s,a.id),this.bus({kind:"message.created",messageId:s,sessionId:e.sessionId,mode:e.mode,at:new Date().toISOString()}),{ok:!0,messageId:s,status:"delivering",message:this.memory.get(s)}}this.memory.delete(s);const r={...e,status:"pending",stalled:!1,acked:!1,settledAt:null,reason:void 0,error:null},u=await this.deliverPrompt(r,t,i,n);return this.bus({kind:"message.created",messageId:r.id,sessionId:r.sessionId,mode:r.mode,at:new Date().toISOString()}),u}dismiss(s,e){const t=this.memory.get(e);if(t){if(t.status==="running")return{ok:!1,status:409,error:"Message is still in flight"};t.status==="delivering"&&this.gate.headOf(t.sessionId)===e&&this.flushing.delete(t.sessionId),this.memory.delete(e),this.gate.clearStall(t.sessionId,e),this.gate.release(t.sessionId,e),this.queuedSessions.has(t.sessionId)&&this.scheduleFlushContinuation(t.sessionId)}else if(!this.dropQueued(s,e))return{ok:!1,status:404,error:"Message not found"};return this.bus({kind:"message.dismissed",messageId:e,sessionId:s,at:new Date().toISOString()}),{ok:!0}}dropQueued(s,e){const t=this.deps.sessions.getBySessionId(s);if(t?.projectId==null)return!1;const i=this.deps.projects.getById(t.projectId);if(!i)return!1;const n=p(this.hooksDir,i.token);if(!n.some(r=>r.id===e&&r.sessionId===s))return!1;for(f(this.hooksDir,i.token,new Set([e])),this.dismissedIds.add(e);this.dismissedIds.size>Es;){const r=this.dismissedIds.values().next().value;if(r===void 0)break;this.dismissedIds.delete(r)}return n.some(r=>r.sessionId===s&&r.id!==e)||this.queuedSessions.delete(s),!0}async flushSession(s){if(this.stalled.has(s)||this.flushing.has(s)||!this.queuedSessions.has(s))return;const e=Symbol(s);this.flushing.set(s,e);try{await this.flushSessionInner(s)}catch{}finally{this.flushing.get(s)===e&&this.flushing.delete(s)}}async flushSessionInner(s){if(!this.ackGateOpen(s))return;const e=this.deps.sessions.getBySessionId(s);if(e?.projectId==null)return;const t=this.deps.projects.getById(e.projectId);if(!t)return;const i=p(this.hooksDir,t.token).filter(a=>a.sessionId===s);if(i.length===0){this.queuedSessions.delete(s);return}if(this.sessionJudgedDead(s)){this.failQueuedOffline(s,i.filter(a=>!this.dismissedIds.has(a.id)));return}const n=this.surfaceOfSession(s),r=n?.prompt??null,u=this.modalBlocked(s);for(const a of i){if(this.stalled.has(s))return;if(this.dismissedIds.has(a.id))continue;const o={id:a.id,sessionId:s,text:a.text,...a.attachments&&a.attachments.length>0?{attachments:a.attachments}:{},mode:"prompt",oneWay:a.oneWay===!0,...a.forceTerminal===!0?{forceTerminal:!0}:{},via:"socket",channel:"prompt",status:"pending",at:a.at};if(!u&&this.hasImagesEntry(o)&&this.terminalChannel()){const d=await this.terminalPaneFor(e,t);if(d){f(this.hooksDir,t.token,new Set([a.id])),this.memory.set(o.id,{...o,via:"terminal",status:"delivering"}),this.awaitingAck.set(s,o.id),await this.runTerminalPrompt(o.id,d.id,this.wireTextOfEntry(o)),this.settleQueueIndex(s,t.token);return}}if(n&&await this.tryQueuedDeliver(o,n)){f(this.hooksDir,t.token,new Set([a.id])),this.settleQueueIndex(s,t.token);return}if(n&&await this.tryInboxDeliver(o,n)){f(this.hooksDir,t.token,new Set([a.id])),this.settleQueueIndex(s,t.token);return}const l=r?.resolve(s)??null,h=o.forceTerminal===!0?["terminal"]:o.oneWay===!0?["terminal","relay"]:["relay","terminal"];for(const d of h){if(d==="relay"&&r&&l){if(this.memory.set(o.id,{...o,status:"delivering",via:"relay"}),!this.runRelay(o,r,l.name)){this.memory.delete(o.id);return}this.awaitingAck.set(s,o.id),f(this.hooksDir,t.token,new Set([a.id]));break}if(d==="terminal"&&!u&&this.terminalChannel()){const m=await this.terminalPaneFor(e,t);if(m){f(this.hooksDir,t.token,new Set([a.id])),this.memory.set(o.id,{...o,via:"terminal",status:"delivering"}),this.awaitingAck.set(s,o.id),await this.runTerminalPrompt(o.id,m.id,this.wireTextOfEntry(o));break}}}if(this.awaitingAck.get(s)===o.id){this.settleQueueIndex(s,t.token);return}return}this.settleQueueIndex(s,t.token)}settleQueueIndex(s,e){p(this.hooksDir,e).every(t=>t.sessionId!==s)&&this.queuedSessions.delete(s)}async flushAll(){for(const s of[...this.queuedSessions])await this.flushSession(s)}forgetSession(s){let e=0;for(const[t,i]of this.memory)i.sessionId===s&&(this.memory.delete(t),e++);return e+=fs(this.hooksDir,s),this.queuedSessions.delete(s),this.gate.clearStall(s),this.gate.release(s),this.inboxSockets.forget(s),this.paneEnvs.delete(s),this.persistPaneEnvs(),e}forgetProject(s){let e=0;for(const[t,i]of this.memory)this.deps.sessions.getBySessionId(i.sessionId)?.projectId===s&&(this.memory.delete(t),this.inboxSockets.forget(i.sessionId),this.paneEnvs.delete(i.sessionId),this.gate.clearStall(i.sessionId),this.gate.release(i.sessionId),e++);for(const t of[...this.queuedSessions])this.deps.sessions.getBySessionId(t)?.projectId===s&&(e+=this.forgetSession(t));return this.persistPaneEnvs(),e}surfaceOfSession(s){const e=this.deps.hookEvents.listBySession(s,1),t=e[e.length-1]?.source;return P(t)?this.deps.surfaceFor?.(t)??M(t):null}resolveChannel(s,e,t){return rs(this.deps.sessions,()=>this.terminalChannel()!=null,s,e,t)}async terminalPaneFor(s,e,t="both"){return X(this.terminalChannel(),this.paneEnvs,s,e,t)}terminalChannel(){const s=this.deps.terminal;return s&&s.available()?s:null}modalBlocked(s){return this.deps.blockedByQuestion?.(s)===!0}async deliverPrompt(s,e,t,i){if(this.sessionJudgedDead(s.sessionId))return{ok:!0,messageId:s.id,status:"failed",message:this.failOffline(s)};const n=this.modalBlocked(s.sessionId);if(!n&&this.hasImagesEntry(s)&&this.terminalChannel()){const d=await this.terminalPaneFor(e,t);if(d)return this.memory.set(s.id,{...s,status:"delivering",via:"terminal"}),this.awaitingAck.set(s.sessionId,s.id),this.runTerminalPrompt(s.id,d.id,this.wireTextOfEntry(s)),{ok:!0,messageId:s.id,status:"delivering",message:this.memory.get(s.id)}}const r=await this.tryQueuedDeliver(s,i);if(r)return{ok:!0,messageId:s.id,status:"delivered",message:r};const u=await this.tryInboxDeliver(s,i);if(u)return{ok:!0,messageId:s.id,status:"delivered",message:u};const a=i.prompt,o=a?.resolve(s.sessionId)??null,l=s.forceTerminal===!0?["terminal"]:s.oneWay===!0?["terminal","relay"]:["relay","terminal"];for(const d of l){if(d==="relay"&&a&&o){if(this.memory.set(s.id,{...s,status:"delivering",via:"relay"}),this.runRelay(s,a,o.name))return this.awaitingAck.set(s.sessionId,s.id),{ok:!0,messageId:s.id,status:"delivering",message:this.memory.get(s.id)};this.memory.delete(s.id)}if(d==="terminal"&&!n&&this.terminalChannel()){const m=await this.terminalPaneFor(e,t);if(m)return this.memory.set(s.id,{...s,status:"delivering",via:"terminal"}),this.awaitingAck.set(s.sessionId,s.id),this.runTerminalPrompt(s.id,m.id,this.wireTextOfEntry(s)),{ok:!0,messageId:s.id,status:"delivering",message:this.memory.get(s.id)}}}if(this.sessionJudgedDead(s.sessionId))return{ok:!0,messageId:s.id,status:"failed",message:this.failOffline(s)};this.queueEntry(s,t.token);const h={...s,status:"pending"};return{ok:!0,messageId:s.id,status:"pending",message:h}}async tryQueuedDeliver(s,e){const t=e.queuedPrompt;if(!t||this.hasImagesEntry(s))return null;const{bin:i,args:n}=t.command(s.sessionId,this.wireTextOfEntry(s));this.memory.set(s.id,{...s,status:"delivering",via:"queue"});try{await es(i,n,t.timeoutMs??3e4,this.deps.spawnImpl)}catch{return this.memory.delete(s.id),null}return v(this.channelDeps(),{...s,via:"queue"},"queue")}async tryInboxDeliver(s,e){const t=e.promptInbox,i=this.inboxSockets.get(s.sessionId);if(!t||!i||s.forceTerminal===!0)return null;this.memory.set(s.id,{...s,status:"delivering",via:"socket"});try{await W(t,i,this.wireTextOfEntry(s))}catch{return this.memory.delete(s.id),null}return v(this.channelDeps(),s,"socket")}queueEntry(s,e){as(this.hooksDir,e,s),this.queuedSessions.add(s.sessionId)}sessionJudgedDead(s,e=this.deps.livenessOf?.()??I()){return ds(this.deps.sessions,s,e)}failOffline(s){return os(this.memory,e=>this.bus(e),s)}failQueuedOffline(s,e){us(this.deps,this.hooksDir,this.memory,t=>this.bus(t),s,e),this.queuedSessions.delete(s)}relayDeps(){return{headless:this.headless,getMemory:s=>this.memory.get(s)??null,setMemory:s=>this.memory.set(s.id,s),awaitAck:(s,e)=>this.gate.await(s,e),stall:(s,e,t)=>this.gate.stall(s,e,t),isSlashCommand,armAckWatch:s=>this.gate.armAckWatch(s),armCommandAck:(s,e)=>this.gate.armCommandAck(s,t=>{e(t),this.queuedSessions.has(t)&&this.scheduleFlushContinuation(t)}),onReleased:s=>{this.queuedSessions.has(s)&&this.scheduleFlushContinuation(s)},emit:s=>this.bus(s),...this.deps.bin?{bin:this.deps.bin}:{},...this.deps.relayTimeoutMs===void 0?{}:{relayTimeoutMs:this.deps.relayTimeoutMs}}}runRelay(s,e,t){return hs(this.relayDeps(),s,e,t,this.wireTextOfEntry(s))}async runTerminalPrompt(s,e,t){await this.runTerminal(s,i=>i.sendText(e,t))}async runTerminalSubmit(s,e){await this.runTerminal(s,t=>t.sendKeys(e,"\r"))}async runTerminal(s,e){const t=this.memory.get(s);if(!t)return;const i=this.terminalChannel();if(i)try{await e(i);const n=this.memory.get(s);if(!n)return;const r={...n,status:"delivered",settledAt:new Date().toISOString()};this.memory.set(s,r),isSlashCommand(n.text)?this.armCommandAck(s):this.armAckWatch(r),this.bus({kind:"message.delivered",messageId:s,sessionId:t.sessionId,at:new Date().toISOString()})}catch(n){const r=this.memory.get(s);if(!r)return;if(r.acked===!0){const a=new Date().toISOString();this.memory.set(s,{...r,status:"delivered",settledAt:a}),this.bus({kind:"message.delivered",messageId:s,sessionId:r.sessionId,at:a});return}const u={...r,status:"failed",error:n instanceof Error?n.message:String(n),settledAt:new Date().toISOString()};this.memory.set(s,u),this.stall(t.sessionId,u,"failed"),this.bus({kind:"message.finished",messageId:s,sessionId:t.sessionId,status:"failed",at:new Date().toISOString()})}}deliverInject(s,e,t,i){return ns({hooksDir:this.hooksDir,memory:this.memory,bus:this.busSafe()},s,e,t,i,this.wireTextOfEntry(s))}deliverHeadless(s,e,t,i){return is({memory:this.memory,headless:this.headless,bus:this.busSafe(),...this.deps.bin?{bin:this.deps.bin}:{},...this.deps.timeoutMs===void 0?{}:{timeoutMs:this.deps.timeoutMs}},s,e,t,i,this.wireTextOfEntry(s))}bus(s){try{this.deps.bus?.emit(s)}catch{}}}

package/node_modules/@weavecode/server/dist/hooks/mirror.d.ts

@@ -1,4 +1,4 @@
-import type { HookRule } from '@weavecode/core';
+import type { Harness, HookRule } from '@weavecode/core';
 import type { ProjectRow, ProjectRepository } from '../repositories/projects.js';
 import type { SessionRepository } from '../repositories/sessions.js';
 import type { HookRuleRegistry } from './registry.js';
@@ -23,6 +23,12 @@ export declare function outboxPathOf(hooksDir: string, shardId: string): string;
 export interface MirrorRule {
     id: string;
     name: string;
+    /**
+     * 归属 harness（'any' = 各 harness 都该吃）。同一项目的各 harness 共读一份
+     * 镜像，故必须逐条盖章、由生成脚本按自己的 harness 过滤——不能在这一侧按某个
+     * harness 剪枝。
+     */
+    harness: Harness | 'any';
     events: string[];
     tools: string[] | null;
     globs: string[] | null;
@@ -37,9 +43,8 @@ export interface HookMirrorDoc {
 }
 /**
  * 项目 → hook 本地注入计划。只投影 inject 规则（manual/webhook/log/plugin 的
- * 动作都在消费侧）：harness 必须是 claude（hook-handler.cjs 只挂在 Claude Code）；
- * crossProjectOnly 需要全项目表参与判定、hook 无法本地裁决 → 不投影，其注入走
- * outbox 顺延。
+ * 动作都在消费侧）；crossProjectOnly 需要全项目表参与判定、hook 无法本地裁决
+ * → 不投影，其注入走 outbox 顺延。
  */
 export declare function buildMirrorDoc(project: ProjectRow, rules: HookRule[], pendingTitles: Record<string, string>): HookMirrorDoc;
 export interface MirrorWriterDeps {

package/node_modules/@weavecode/server/dist/hooks/mirror.js

@@ -1,5 +1,5 @@
-import{createHash as h}from"node:crypto";import{mkdirSync as a,readFileSync as u,renameSync as d,writeFileSync as p}from"node:fs";import{join as n}from"node:path";import{hookSourceHarness as m}from"@weavecode/core";import{getDataDir as l}from"../db/paths.js";import{projectLabel as y}from"./match.js";export const MIRROR_VERSION=1,OUTBOX_MAX_LINES=200;export function hookShardId(i){return h("sha256").update(i).digest("hex").slice(0,16)}export function hooksRoot(i=l()){return n(i,"hooks")}export function mirrorPathOf(i,r){return n(i,"mirror",`${r}.json`)}export function outboxPathOf(i,r){return n(i,"outbox",`${r}.jsonl`)}export function buildMirrorDoc(i,r,e){const o=r.filter(t=>!(t.source.kind!=="hook-event"||m(t.source)!=="claude"||t.handler.type!=="inject"||!t.enabled||t.projectId!==null&&t.projectId!==i.id||t.filter.crossProjectOnly)).sort((t,s)=>s.priority-t.priority).map(t=>({id:t.id,name:t.name,events:[t.source.kind==="hook-event"?t.source.event:""],tools:t.filter.toolNames?.length?[...t.filter.toolNames]:null,globs:t.filter.pathGlobs?.length?[...t.filter.pathGlobs]:null,template:t.handler.type==="inject"?t.handler.template:""}));return{version:MIRROR_VERSION,project:y(i.path),pendingTitles:e,rules:o}}export class MirrorWriter{deps;dataDir;constructor(r){this.deps=r,this.dataDir=r.dataDir??l()}syncAll(){for(const r of this.deps.projects.list())this.syncProject(r.id)}syncProject(r){const e=this.deps.projects.getById(r);if(!e||e.archivedAt)return;const o={};for(const t of this.deps.sessions.list(r))t.pendingTitle&&(o[t.sessionId]=t.pendingTitle);this.write(e.token,buildMirrorDoc(e,this.deps.rules.list(),o))}write(r,e){try{const o=mirrorPathOf(hooksRoot(this.dataDir),hookShardId(r));a(n(hooksRoot(this.dataDir),"mirror"),{recursive:!0});const t=`${o}.tmp`;p(t,JSON.stringify(e)),d(t,o)}catch{}}attachToBus(r){r.subscribe(e=>{if(e.kind!=="session.renamed"||!e.sessionId)return;const o=this.deps.sessions.getBySessionId(e.sessionId);o?.projectId!=null&&this.syncProject(o.projectId)})}}export function appendInbox(i,r,e){const o=n(i,"inbox");a(o,{recursive:!0}),p(n(o,`${hookShardId(r)}.jsonl`),JSON.stringify({v:1,token:r,report:e})+`
-`,{flag:"a"})}export function appendOutbox(i,r,e){if(e.length!==0)try{const o=outboxPathOf(i,hookShardId(r));a(n(i,"outbox"),{recursive:!0});let t=[];try{t=u(o,"utf8").split(`
-`).filter(c=>c.trim())}catch{t=[]}for(const c of e)t.push(JSON.stringify({...c,at:new Date().toISOString()}));const s=t.slice(-OUTBOX_MAX_LINES),f=`${o}.tmp`;p(f,s.length?s.join(`
+import{createHash as h}from"node:crypto";import{mkdirSync as a,readFileSync as u,renameSync as d,writeFileSync as l}from"node:fs";import{join as i}from"node:path";import{hookSourceHarness as f}from"@weavecode/core";import{getDataDir as m,getHooksDir as y}from"../db/paths.js";import{projectLabel as j}from"./match.js";export const MIRROR_VERSION=1,OUTBOX_MAX_LINES=200;export function hookShardId(s){return h("sha256").update(s).digest("hex").slice(0,16)}export function hooksRoot(s){return y(s)}export function mirrorPathOf(s,e){return i(s,"mirror",`${e}.json`)}export function outboxPathOf(s,e){return i(s,"outbox",`${e}.jsonl`)}export function buildMirrorDoc(s,e,o){const r=e.filter(t=>!(t.source.kind!=="hook-event"||t.handler.type!=="inject"||!t.enabled||t.projectId!==null&&t.projectId!==s.id||t.filter.crossProjectOnly)).sort((t,n)=>n.priority-t.priority).map(t=>({id:t.id,name:t.name,harness:f(t.source)??"claude",events:[t.source.kind==="hook-event"?t.source.event:""],tools:t.filter.toolNames?.length?[...t.filter.toolNames]:null,globs:t.filter.pathGlobs?.length?[...t.filter.pathGlobs]:null,template:t.handler.type==="inject"?t.handler.template:""}));return{version:MIRROR_VERSION,project:j(s.path),pendingTitles:o,rules:r}}export class MirrorWriter{deps;dataDir;constructor(e){this.deps=e,this.dataDir=e.dataDir??m()}syncAll(){for(const e of this.deps.projects.list())this.syncProject(e.id)}syncProject(e){const o=this.deps.projects.getById(e);if(!o||o.archivedAt)return;const r={};for(const t of this.deps.sessions.list(e))t.pendingTitle&&(r[t.sessionId]=t.pendingTitle);this.write(o.token,buildMirrorDoc(o,this.deps.rules.list(),r))}write(e,o){try{const r=mirrorPathOf(hooksRoot(this.dataDir),hookShardId(e));a(i(hooksRoot(this.dataDir),"mirror"),{recursive:!0});const t=`${r}.tmp`;l(t,JSON.stringify(o)),d(t,r)}catch{}}attachToBus(e){e.subscribe(o=>{if(o.kind!=="session.renamed"||!o.sessionId)return;const r=this.deps.sessions.getBySessionId(o.sessionId);r?.projectId!=null&&this.syncProject(r.projectId)})}}export function appendInbox(s,e,o){const r=i(s,"inbox");a(r,{recursive:!0}),l(i(r,`${hookShardId(e)}.jsonl`),JSON.stringify({v:1,token:e,report:o})+`
+`,{flag:"a"})}export function appendOutbox(s,e,o){if(o.length!==0)try{const r=outboxPathOf(s,hookShardId(e));a(i(s,"outbox"),{recursive:!0});let t=[];try{t=u(r,"utf8").split(`
+`).filter(c=>c.trim())}catch{t=[]}for(const c of o)t.push(JSON.stringify({...c,at:new Date().toISOString()}));const n=t.slice(-OUTBOX_MAX_LINES),p=`${r}.tmp`;l(p,n.length?n.join(`
 `)+`
-`:""),d(f,o)}catch{}}
+`:""),d(p,r)}catch{}}