@weavecode/weave 0.1.2 → 0.1.4

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：对话面据此把投递行精确挂到它的气泡上（比比对
@@ -111,6 +112,11 @@ export interface PromptTerminal {
     sendText(paneId: string, text: string): Promise<void>;
     /** 裸键序注入（作答的选项键 / 中断的 ESC：模态框只吃键盘，不吃粘贴文本）。 */
     sendKeys(paneId: string, keys: string): Promise<void>;
+    /**
+     * 读 pane 可视屏文本（旁路会话读屏通道用）；可缺省（无读屏能力的装配 = 恒
+     * null，侧问入口对读屏 harness 置灰）。
+     */
+    getPaneText?(paneId: string): Promise<string | null>;
     /** 关掉这个 pane（会话生命周期收尾）；无通道的后端明确拒绝。 */
     closePane(paneId: string): Promise<void>;
 }
@@ -145,15 +151,26 @@ export interface MessageDelivererDeps {
     /** 终态驻留窗口（毫秒）；缺省 60s——delivered/injected/succeeded 短时留在在途
      *  视图展示 via/acked，过后消失（failed/timeout/暂停闸成因常驻）。 */
     visibleTtlMs?: number;
-    /** 未回执闸窗口（毫秒）；缺省 120s——prompt 送达后没等到 UPS 回执即暂停该会话
+    /** 未回执闸窗口（毫秒）；缺省 30s——prompt 送达后没等到 UPS 回执即暂停该会话
      *  的队列冲洗（防继续向 Held/Refused 的会话灌消息），手动重发或回执解除。 */
     ackStallMs?: number;
-    /** 闸自动解除窗口（毫秒）；缺省 10min——闸挂着而回执永远不来（消息其实丢了）时，
+    /** 闸自动解除窗口（毫秒）；缺省 90s——闸挂着而回执永远不来（消息其实丢了）时，
      *  队列不能就此停到天荒地老：到点把成因行落成 failed（`unacked`）并续排。 */
     ackStallReleaseMs?: number;
-    /** 会话存活图（测试注入）；缺省 `claudeLivenessById()`——同两个引擎（watch/sequence）
-     *  的取法：没有注册表就空图，会话一律「查不动」，不猜。 */
+    /** 斜杠命令等回执的短窗口（毫秒）；缺省 5s——过了仍无 UPS 即按内建命令收。 */
+    commandAckGraceMs?: number;
+    /** 该会话此刻是否挂着阻塞式模态框（questions 槽；QuestionTracker 是唯一实现）。
+     *  模态框在场时层② 的文本与回车会被它吃掉：投出去只换来一条「已发出却没回执」
+     *  的假送达，回车还可能替用户按下某个选项。缺省 = 不判（测试与无 tracker 装配）。 */
+    blockedByQuestion?: (sessionId: string) => boolean;
+    /** 会话存活图（测试注入）；缺省合并图（claude 注册表 + codex 锁探针缓存）——
+     *  同两个引擎（watch/sequence）的取法：判不动的会话一律「查不到」，不猜。 */
     livenessOf?: () => Map<string, boolean>;
+    /** 读屏通道的回答落库（codex 侧问）：按 (sessionId, question) 找到待答行直更。
+     *  缺省 = 无落库（读屏取到的回答只发帧不存档）。 */
+    sideAnswerStore?: {
+        answerById(sessionId: string, question: string, answer: string): void;
+    };
 }
 /** send() 入参（路由层已做 zod 形状校验）。 */
 export interface SendInput {
@@ -167,8 +184,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 = {
@@ -189,6 +206,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';
@@ -199,6 +221,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。 */
@@ -208,10 +231,27 @@ 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;
     private readonly hooksDir;
+    /** 读屏通道的回答落库（codex = /side；缺省无——回答只发帧不存档）。 */
+    private readonly sideAnswerStore?;
     /** 内存态注册表（pending 之后的生命周期）。 */
     private readonly memory;
     /** 有队列行的会话（ingest 冲洗守卫 + 刷新器探活索引；构造时从磁盘重建）。 */
@@ -225,11 +265,29 @@ export declare class MessageDeliverer {
      * 长时间没动静的会话根本等不到，于是从终端分组里掉出去。
      */
     private readonly paneEnvs;
+    /**
+     * 定位已撤销的会话（会话退出）：pane env 已删、这轮扫描也探不到它，而拓扑
+     * 合并契约是「缺席 = 保留上次分块」——不显式报 null，旧分块会永远留在快照里。
+     * sessionTerminals() 报完即焚；会话再发事件（resume）会重新 notePaneEnv。
+     */
+    private readonly revokedPaneEnvs;
     /** 上次落盘的 pane env（hook 每次事件都上报，值没变就不重写盘）。 */
     private persistedPaneEnvs;
+    /**
+     * 起点候选（weave 起会话的 spawn 回执）。paneEnvSource='launch' 的 harness
+     * （codex）hook env 系统性失真，pane 定位改信这里——sessionId 事后才知道
+     * （宿主自己生成），先按 (harness, projectId) 排队，ingest 侧认领（FIFO）。
+     * 落盘同 pane-envs：只解 daemon 自己的重启。
+     */
+    private pendingOrigins;
+    private persistedPendingOrigins;
     /** 已排自续冲洗的会话（防重复排拍）。 */
     private readonly flushScheduled;
-    /** 正在冲洗的会话（重入闸：异步冲洗 + 多条触发源，防同批行被投两次）。 */
+    /**
+     * 正在冲洗的会话（重入闸：异步冲洗 + 多条触发源，防同批行被投两次）。值是这一拍
+     * 的令牌——强制移除卡住的那一行要就地解除泵闸，旧拍醒来时不能顺手把新拍的闸也
+     * 删掉（两拍并行 = 同一行被投两次）。
+     */
     private readonly flushing;
     /** 队列暂停闸（sessionId → 成因消息）：未回执超窗 / 投递失败即置；重发或回执解除。 */
     private readonly stalled;
@@ -245,6 +303,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 → 按模式落通道
@@ -291,13 +351,44 @@ 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 凭据同一自愈口径）。
      */
     notePaneEnv(sessionId: string, env: Record<string, string>): void;
+    /**
+     * 记一条起点候选（weave 起会话的 spawn 回执）。只为 paneEnvSource='launch'
+     * 的 harness 而来（调用侧闸）：'hook' 的 harness env 精确，起点只会引入过期源。
+     */
+    notePendingOrigin(origin: {
+        harness: Harness;
+        projectId: number;
+        env: Record<string, string>;
+    }): void;
+    /**
+     * 认领起点候选：首个 (harness, projectId) 匹配的 FIFO 条目即该会话的 pane 定位
+     * （notePaneEnv 全语义——分组、层② 定位同一份数据）。没有匹配 no-op：手动开的
+     * 会话没有起点，不分组（与现状持平，不猜）。
+     */
+    claimPendingOrigin(sessionId: string, harness: Harness, projectId: number): void;
     /** 原子写（临时文件 + rename）+ 0600；失败静默（内存态照常能定位，下次再落）。 */
     private persistPaneEnvs;
+    private persistPendingOrigins;
     /**
      * 会话退出（`SessionEnd` 到达）：旁路事实随进程作废——inbox 凭据出盘（旧 socket
      * 已死，留着只会让下一次投递白试一轮）、pane 定位清（窗口随会话关）。**会话行与
@@ -333,17 +424,19 @@ export declare class MessageDeliverer {
      * 对应气泡上（见 `PipeMessage.ackedEventId`）。
      */
     onSessionPrompt(sessionId: string, prompt: string, eventId?: number): string[];
-    /** 未回执闸布防：prompt 送达后 ackStallMs 内没等到 UPS 回执 → 暂停该会话队列。 */
-    private armAckWatch;
-    /** 置闸：成因消息标记 stalled（常驻在途视图）+ message.stalled 帧（web 重拉）。 */
-    private stall;
     /**
-     * 闸到点自动解除：回执一直不来 = 那条很可能压根没进对话（贴着文本按下去的时候
-     * 会话正在重启，输入框被清掉就是这样），闸不能因此把该会话的队列永久停住。
-     * 「已发出却没回执」的行到点**直接从队列清除**（用户裁决：正文只在这一行里，
-     * 窗口期就是给人看清与重发的）；投递失败的行留着等人重发，只解闸续排。
+     * 活动旁证：该会话来了任何 hook 事件 = 宿主活着且在干活。内建命令（`/compact`
+     * 之类）没有 UPS 回执，命令行「已发出」的翻牌就靠它——宿主受理命令后的第一笔
+     * 事件（PreCompact…）及时把行翻成已回执（5s 短窗口只是兜底）。普通文本行有
+     * UPS 正路，不掺和。
      */
-    private releaseStall;
+    noteActivity(sessionId: string): void;
+    /** 未回执闸布防（判定与计时在 delivery/ack-gate.ts）。 */
+    private armAckWatch;
+    /** 斜杠命令的回执收尾（短窗口；内建命令不发 UPS）。 */
+    private armCommandAck;
+    /** 置闸（成因消息标记 stalled + message.stalled 帧）。 */
+    private stall;
     /**
      * 远程作答（阻塞式交互）：向目标会话所在 pane 发裸键序——模态框只吃键盘，
      * inbox/中继投递答不了。键序经白名单（`ANSWER_KEYS`）；pane 匹配复用层② 的
@@ -355,8 +448,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 没有「请退出」这种信号）。**会话行与它的对话照常
@@ -369,6 +475,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 会增删，不做静态映射表），故只验形态不验
@@ -376,10 +493,17 @@ export declare class MessageDeliverer {
      */
     setModel(sessionId: string, name: string): Promise<AnswerResult>;
     /**
-     * 旁路会话（claude = `/btw`）：问句经层② 终端打进会话 pane——宿主的侧问只
-     * 活在 TUI 里（`claude -p "/btw …"` 直说不支持这个环境），也不落任何文件，
-     * 故终端击键是唯一通道。不入队、不布防回执：回答不是 UPS 而是之后的一条
-     * 采集事件（认领见 `hooks/side-questions.ts`）。
+     * 思考强度调整：往会话的输入行打宿主自己的 `/effort <档位>` 并提交。档位过
+     * **词表白名单**（core 表该 harness 的 `effortLevels`）——封闭枚举，表外 400
+     * 不打键；模型能力差异宿主自己降档并回报（事件自带 `effort.level` 纠正显示）。
+     */
+    setEffort(sessionId: string, level: string): Promise<AnswerResult>;
+    /**
+     * 旁路会话：问句经层② 终端打进会话 pane。两条通道按能力面分流——
+     * - **事件认领**（claude = `/btw`）：宿主的侧问只活在 TUI 里，也不落任何文件，
+     *   终端击键是唯一通道；回答是之后的一条采集事件（认领见 `hooks/side-questions.ts`）。
+     * - **读屏**（codex = `/side`）：宿主侧边会话 ephemeral（零落盘、零 hook 事件），
+     *   开面板 → 发问句 → 轮询读屏 → 关面板，回答同步取回（`pollScreenAnswer`）。
      *
      * 返回归一化后的问句（已过 harness 的形态校验）：调用方据此落历史行。
      */
@@ -392,12 +516,24 @@ export declare class MessageDeliverer {
         error: string;
     }>;
     /**
-     * 键序注入路径（作答 / 中断 / 关 pane）共用的落点解析：会话 → 项目 → 终端通道
-     * → pane。全部失败原因是**可判定的语义拒绝**（404/409），调用方原样回给 HTTP；
-     * 两条 409 是给用户看的（web 直拼在「停止失败：」这类动作名后面），故写成中文
-     * 修法，动作名随调用方换。
+     * 读屏通道的执行体（fire-and-forget：POST 先回、行先落 pending，回答到了经
+     * `sideQuestion.answered` 帧推给前端）。时序全部实测钉死（2026-10-27）：
+     * 开面板的 CR 常被吃 → 发完验屏、没开成补一发再验；**收尾前必须确认面板还
+     * 开着**——用户中途关掉后，closeKey 落主线程语境（忙 = 中断确认菜单、闲 =
+     * 退出 TUI），盲打比不收尾糟得多，面板不在就什么都不发。
      */
+    private pollScreenAnswer;
     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 → 中继 → 终端 → 队列），重发即解闸并重新布防回执闸。
@@ -408,8 +544,13 @@ export declare class MessageDeliverer {
      * （pending 只活在 promptbox 文件里）删行——两种都不再出现在这个会话的对话尾巴上。
      * 内存行**不影响已投递的内容**（真到了会话，转录里的记录仍在）；队列行则是
      * **取消发送**（还没出去）。内存行若正是暂停闸的成因 → 一并解闸（否则闸留着却
-     * 没有成因行可看、可操作），并续排空积压（下一条各自重新布防回执闸）。在飞
-     * （delivering/running）的行不删：落定回调会把行写回来，删了也白删。
+     * 没有成因行可看、可操作），并续排空积压（下一条各自重新布防回执闸）。
+     *
+     * **在飞的投递行（delivering）也能强制移除**：投递卡住（后端不回）时它就是队头，
+     * 压着后面每一条都发不出去，闸/行都不给人动手就永远解不开。落定回调按「当前行」
+     * 收尾、行没了即返回（见 `runTerminal`），删了不会被写回来；泵闸也一并就地解除
+     * （那一拍还挂在这次投递上，不解除的话闸看着开了、泵却永远占着）。running
+     * 不在此列：那是编排域的一条真实子进程，删了行只是把活着的进程藏起来。
      */
     dismiss(sessionId: string, messageId: string): AnswerResult;
     /** 删掉队列里的一条待递送行（读到的行自己带 sessionId，配不上即不算命中）。 */
@@ -438,78 +579,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,3 @@
-import{randomUUID as A}from"node:crypto";import{chmodSync as E,mkdirSync as D,readFileSync as T,renameSync as j,writeFileSync as P}from"node:fs";import{tmpdir as M}from"node:os";import{dirname as _,join as p}from"node:path";import{isHarness as B}from"@weavecode/core";import{messagingSurfaceFor as C}from"../surfaces.js";import{claudeLivenessById as g,pidAliveOf as S}from"../daemon/claude-liveness.js";import{normalizeDirKey as v}from"../daemon/opener.js";import{HeadlessRunner as R}from"./headless-runner.js";import{appendOutbox as q,hooksRoot as W}from"./mirror.js";import{INBOX_TARGETS_FILE as F,InboxSocketRegistry as N,deliverViaInboxSocket as K}from"./inbox-socket.js";import{appendPromptbox as $,readAllPromptbox as L,readPromptbox as m,removePromptboxBySession as Q,removePromptboxEntries as f,scanQueuedSessionIds as H}from"./promptbox.js";const G=()=>M(),J=1e3,U=6e4,V=12e4,z=10*6e4,X=8,Z="Session is not running",Y=200,I=/^(?:[1-9]|n|\t|\r|\x1b\[B)$/,ee=/^[^\x00-\x1f\x7f]*$/,se="\x1B",te="\x1B[Z",ie=/^[^\s\x00-\x1f\x7f]{1,128}$/,ne=h=>`/model ${h}`,re=120;function w(h){return h.replace(/<\/?cross-session-message[^>]*>/g,"").replace(/\s+/g," ").trim()}function y(h){return h.replace(/\s+/g,"")}const b="pane-envs.json";function oe(h){try{const e=JSON.parse(T(h,"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 ae=h=>new Promise(e=>setTimeout(e,h));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 R({spawnImpl:e.spawnImpl,killImpl:e.killImpl}),this.hooksDir=e.hooksDir??W(),this.inboxSockets=new N(p(this.hooksDir,F));const t=oe(p(this.hooksDir,b));this.paneEnvs=new Map(Object.entries(t)),this.persistedPaneEnvs=JSON.stringify(t),this.queuedSessions=H(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},l=n==="prompt"&&this.blockedAhead(a.sessionId);l&&(this.queueEntry(a,r.token),this.scheduleFlushContinuation(a.sessionId));const d=l?{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}),d}getMessage(e){return this.memory.get(e)??null}listVisible(e){const t=this.deps.visibleTtlMs??U,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 L(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??J).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,b);try{D(_(t),{recursive:!0});const s=`${t}.tmp`;P(s,`${e}
-`,{encoding:"utf8",mode:384}),j(s,t),E(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?S(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,l=t?.prompt?a?{status:"ready",reason:null}:{status:"unavailable",reason:"no-peer-name"}:{status:"unavailable",reason:"no-mechanism"},d=this.paneEnvs.has(e),u=this.terminalChannel()?d?{status:"ready",reason:null}:{status:"unknown",reason:"no-pane-env"}:{status:"unavailable",reason:"no-backend"},c=this.deps.sessions.getBySessionId(e),k=c?.projectId==null?null:this.deps.projects.getById(c.projectId),O=k?m(this.hooksDir,k.token).filter(x=>x.sessionId===e).length:0;return{alive:i,inbox:o,relay:l,terminal:u,paneEnvReported:d,pending:O,stalled:this.stalled.has(e)}}onSessionPrompt(e,t,s){const i=w(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 l=w(a.text),d=!!l&&(l.length>=X?i.includes(l):i===l),u=(a.images?.length??0)>0&&(l?y(i).includes(y(l)):n.length===0);!d&&!u||(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??V).unref?.()}stall(e,t,s){this.stalled.set(e,{messageId:t.id,reason:s});const i=this.deps.ackStallReleaseMs??z,n=this.memory.get(t.id),r=n&&n.status==="delivered"&&n.acked!==!0?new Date(Date.now()+i).toISOString():null;n&&this.memory.set(t.id,{...n,stalled:!0,releaseAt:r}),this.bus({kind:"message.stalled",messageId:t.id,sessionId:e,reason:s,at:new Date().toISOString()}),setTimeout(()=>this.releaseStall(e,t.id),i).unref?.()}releaseStall(e,t){if(this.stalled.get(e)?.messageId!==t)return;const s=this.memory.get(t);if(s&&s.status==="delivered"&&s.acked!==!0){this.dismiss(e,t);return}this.stalled.delete(e),this.awaitingAck.get(e)===t&&this.awaitingAck.delete(e),this.queuedSessions.has(e)&&this.scheduleFlushContinuation(e)}async answer(e,t){if(t.length===0||!I.test(t[0])||t.some(i=>!I.test(i)&&!ee.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 ae(re),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,se),{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,te),{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(!ie.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,ne(s)),{ok:!0}}catch(n){return{ok:!1,status:409,error:n instanceof Error?n.message:String(n)}}}async askSideQuestion(e,t){if(!this.deps.sessions.getBySessionId(e))return{ok:!1,status:404,error:"Session not found"};const s=this.surfaceOfSession(e),i=s?.sideQuestion??null;if(!i)return{ok:!1,status:409,error:s?.unsupportedReasons?.sideQuestion??"\u8FD9\u4E2A harness \u6CA1\u6709\u65C1\u8DEF\u4F1A\u8BDD\u901A\u9053"};const n=i.validate(t);if(!n.ok)return{ok:!1,status:400,error:n.error};const r=await this.sessionKeysTarget(e,"\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(o){return{ok:!1,status:409,error:o instanceof Error?o.message:String(o)}}}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 l=await this.terminalPaneFor(i,n);if(l)return this.memory.set(e,{...t,status:"delivering",stalled:!1,settledAt:null}),this.runTerminalSubmit(e,l.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,reason:void 0,error: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>Y;){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 u=await this.terminalPaneFor(t,s);if(u){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,u.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 l=r?.resolve(e)??null,d=a.forceTerminal===!0?["terminal"]:a.oneWay===!0?["terminal","relay"]:["relay","terminal"];for(const u of d){if(u==="relay"&&r&&l){if(this.memory.set(a.id,{...a,status:"delivering",via:"relay"}),!this.runRelay(a,r,l.name)){this.memory.delete(a.id);return}this.awaitingAck.set(e,a.id),f(this.hooksDir,s.token,new Set([o.id]));break}if(u==="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+=Q(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 B(s)?this.deps.surfaceFor?.(s)??C(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 l=await s.locatePane?.(i).catch(()=>null);if(l)return{id:l}}if(!e.title)return null;const n=e.title.replace(/^[✻✽✶✳✢⋅◦✦✧∘◐◑◒◓*]+\s*/,""),r=v(t.path,process.platform);let o;try{o=await s.listPanes()}catch{return null}const a=o.filter(l=>l.title!=null&&l.cwd!=null&&r!=null&&l.title.replace(/^[✻✽✶✳✢⋅◦✦✧∘◐◑◒◓*]+\s*/,"")===n&&v(l.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 d=await this.terminalPaneFor(t,s);if(d)return this.memory.set(e.id,{...e,status:"delivering",via:"terminal"}),this.awaitingAck.set(e.sessionId,e.id),this.runTerminalPrompt(e.id,d.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 d of a){if(d==="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(d==="terminal"&&this.terminalChannel()){const u=await this.terminalPaneFor(t,s);if(u)return this.memory.set(e.id,{...e,status:"delivering",via:"terminal"}),this.awaitingAck.set(e.sessionId,e.id),this.runTerminalPrompt(e.id,u.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 l={...e,status:"pending"};return{ok:!0,messageId:e.id,status:"pending",message:l}}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 K(s,i,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){$(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?S(s,t)===!1:!1}failOffline(e){const t=new Date().toISOString(),s={...e,status:"failed",reason:"offline",error:Z,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:G(),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:l=>this.settle(r,o,l)})||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 R}from"node:crypto";import{chmodSync as y,mkdirSync as w,readFileSync as v,renameSync as O,writeFileSync as b}from"node:fs";import{dirname as I,join as g}from"node:path";import{isHarness as E}from"@weavecode/core";import{turnOutputOf as B}from"@weavecode/harness";import{isImageMediaType as T}from"../repositories/uploads.js";import{messagingSurfaceFor as L}from"../surfaces.js";import{pidAliveOf as F}from"../daemon/claude-liveness.js";import{combinedLivenessOf as A}from"../daemon/liveness.js";import{HeadlessRunner as N}from"./headless-runner.js";import{hooksRoot as Q}from"./mirror.js";import{INBOX_TARGETS_FILE as G,InboxSocketRegistry as W,deliverViaInboxSocket as J}from"./inbox-socket.js";import{AckGate as H}from"./delivery/ack-gate.js";import{ANSWER_ATOM as D,ANSWER_ATOM_GAP_MS as U,ANSWER_TEXT as V,CTRL_C as $,ENTER as X,ESC as z,MODEL_NAME as Z,SHIFT_TAB as Y,effortCommand as ee,effortLevelsOf as te,locateTerminalPane as se,modelCommand as ie,sessionKeysTarget as ne}from"./delivery/keys.js";import{hasImages as re,settleDelivered as P,spawnOnce as ae,wireTextOf as oe}from"./delivery/channels.js";import{deliverHeadless as le,deliverInject as ue,resolveChannel as he}from"./delivery/send.js";import{appendQueueEntry as de,failOffline as ce,failQueuedOffline as me,sessionJudgedDead as fe}from"./delivery/queue.js";import{runRelay as pe}from"./delivery/relay.js";import{listInflightCounts as ge,listVisible as ke,sessionTerminals as Se}from"./delivery/views.js";import{readPromptbox as k,removePromptboxBySession as ye,removePromptboxEntries as f,scanQueuedSessionIds as we}from"./promptbox.js";const ve=1e3,Oe=6e4,be=3e4,Ie=9e4,Ee=5e3,Te=8,Ae=250,De=5,Pe=200;export function isSlashCommand(m){return/^\/[A-Za-z][A-Za-z0-9:_-]*(\s|$)/.test(m.trim())}const x="pane-envs.json",_="pending-origins.json",M=15*6e4;function xe(m){try{const e=JSON.parse(v(m,"utf8"));if(!Array.isArray(e))return[];const t=[];for(const s of e){if(typeof s!="object"||s===null)continue;const i=s;if(!E(i.harness)||typeof i.projectId!="number"||typeof i.env!="object"||i.env===null||typeof i.at!="string")continue;const n={};for(const[r,l]of Object.entries(i.env))typeof l=="string"&&l&&(n[r]=l);Object.keys(n).length!==0&&t.push({harness:i.harness,projectId:i.projectId,env:n,at:i.at})}return t.filter(s=>Date.now()-Date.parse(s.at)<M)}catch{return[]}}function _e(m){try{const e=JSON.parse(v(m,"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,l]of Object.entries(i))typeof l=="string"&&l&&(n[r]=l);Object.keys(n).length>0&&(t[s]=n)}return t}catch{return{}}}const p=m=>new Promise(e=>setTimeout(e,m)),j=300,C=1500,Me=1e3,je=12e4;export class MessageDeliverer{deps;headless;hooksDir;sideAnswerStore;memory=new Map;queuedSessions;inboxSockets;paneEnvs;revokedPaneEnvs=new Set;persistedPaneEnvs;pendingOrigins;persistedPendingOrigins;flushScheduled=new Set;flushing=new Map;stalled=new Map;awaitingAck=new Map;dismissedIds=new Set;gate;constructor(e){this.deps=e,this.headless=e.headless??new N({spawnImpl:e.spawnImpl,killImpl:e.killImpl}),this.hooksDir=e.hooksDir??Q(),this.sideAnswerStore=e.sideAnswerStore,this.inboxSockets=new W(g(this.hooksDir,G));const t=_e(g(this.hooksDir,x));this.paneEnvs=new Map(Object.entries(t)),this.persistedPaneEnvs=JSON.stringify(t),this.pendingOrigins=xe(g(this.hooksDir,_)),this.persistedPendingOrigins=JSON.stringify(this.pendingOrigins),this.queuedSessions=we(this.hooksDir),this.gate=new H({awaitingAck:this.awaitingAck,stalled:this.stalled,memory:this.memory},{ackStallMs:e.ackStallMs??be,ackStallReleaseMs:e.ackStallReleaseMs??Ie,commandAckGraceMs:e.commandAckGraceMs??Ee},{emit:s=>this.bus(s)}),this.gate.onAutoRelease=s=>this.scheduleFlushContinuation(s)}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.attachments?[...e.attachments]:[];if(i.length>0){if(!s.attach)return{ok:!1,status:409,error:"This harness cannot receive attachments"};if(i.some(h=>T(h.mediaType))&&!s.attach.kinds.includes("image"))return{ok:!1,status:409,error:"This harness cannot receive images"};if(i.some(h=>!T(h.mediaType))&&!s.attach.kinds.includes("file"))return{ok:!1,status:409,error:"This harness cannot receive file attachments"}}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 l={fromLabel:e.fromKind==="session"?`session ${e.fromSessionId??"unknown"}`:e.fromKind,at:new Date().toISOString(),mode:n},a={id:R(),sessionId:e.toSessionId,text:e.text,...i.length>0?{attachments:i}:{},mode:e.mode,oneWay:e.oneWay===!0,...e.forceTerminal===!0?{forceTerminal:!0}:{},channel:n,status:"pending",at:l.at},o=n==="prompt"&&this.blockedAhead(a.sessionId);o&&(this.queueEntry(a,r.token),this.scheduleFlushContinuation(a.sessionId));const c=o?{ok:!0,messageId:a.id,status:"pending",message:a}:n==="inject"?this.deliverInject(a,r.token,l,s):n==="headless"?this.deliverHeadless(a,r.path,l,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}),c}getMessage(e){return this.memory.get(e)??null}listVisible(e){return ke(this.deps,this.hooksDir,this.memory,e,this.deps.visibleTtlMs??Oe)}hasQueued(e){return this.queuedSessions.has(e)}listInflightCounts(){return ge(this.hooksDir,this.memory)}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??ve).unref?.()}ackGateOpen(e){return this.gate.open(e)}blockedAhead(e){return this.ackGateOpen(e)?this.queuedSessions.has(e)||this.flushing.has(e):!0}noteInboxSocket(e,t){this.inboxSockets.set(e,t)}async awaitInboxReady(e,t){const s=this.surfaceOfSession(e)?.promptInbox??null;if(!s)return!1;const i=()=>{const r=this.inboxSockets.get(e);return!!r&&(!s.requiresAuthOn(process.platform)||!!r.token)},n=Date.now()+t;for(;!i();){if(Date.now()>=n)return!1;await new Promise(r=>setTimeout(r,Ae))}return!0}lastTurnOutput(e){const t=this.deps.hookEvents.listBySession(e,De);for(let s=t.length-1;s>=0;s--){const i=t[s];let n=null;try{n=JSON.parse(i.payload)}catch{continue}const r=B(n?.raw);if(r)return{output:r,at:i.createdAt}}return null}notePaneEnv(e,t){this.paneEnvs.set(e,t),this.revokedPaneEnvs.delete(e),this.persistPaneEnvs()}notePendingOrigin(e){this.pendingOrigins=this.pendingOrigins.filter(t=>Date.now()-Date.parse(t.at)<M),this.pendingOrigins.push({...e,at:new Date().toISOString()}),this.persistPendingOrigins()}claimPendingOrigin(e,t,s){const i=this.pendingOrigins.findIndex(r=>r.harness===t&&r.projectId===s);if(i<0)return;const[n]=this.pendingOrigins.splice(i,1);this.notePaneEnv(e,n.env),this.persistPendingOrigins()}persistPaneEnvs(){const e=JSON.stringify(Object.fromEntries(this.paneEnvs));if(e===this.persistedPaneEnvs)return;const t=g(this.hooksDir,x);try{w(I(t),{recursive:!0});const s=`${t}.tmp`;b(s,`${e}
+`,{encoding:"utf8",mode:384}),O(s,t),y(t,384),this.persistedPaneEnvs=e}catch{}}persistPendingOrigins(){const e=JSON.stringify(this.pendingOrigins);if(e===this.persistedPendingOrigins)return;const t=g(this.hooksDir,_);try{w(I(t),{recursive:!0});const s=`${t}.tmp`;b(s,`${e}
+`,{encoding:"utf8",mode:384}),O(s,t),y(t,384),this.persistedPendingOrigins=e}catch{}}sessionExited(e){this.inboxSockets.forget(e),this.paneEnvs.delete(e),this.revokedPaneEnvs.add(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=k(this.hooksDir,s.token).filter(n=>n.sessionId===e);this.failQueuedOffline(e,i.filter(n=>!this.dismissedIds.has(n.id)))}async sessionTerminals(){return Se(this.deps,this.terminalChannel(),this.paneEnvs,()=>this.persistPaneEnvs(),this.revokedPaneEnvs)}diagnose(e){const t=this.surfaceOfSession(e),s=this.deps.sessions.livenessRowOf(e),i=s?F(s,this.deps.livenessOf?.()??A()):null,n=t?.promptInbox??null,r=this.inboxSockets.get(e),l=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?.queuedPrompt?{status:"ready",reason:null}:{status:"unavailable",reason:"no-mechanism"},o=t?.prompt?.resolve(e)??null,c=t?.prompt?o?{status:"ready",reason:null}:{status:"unavailable",reason:"no-peer-name"}:{status:"unavailable",reason:"no-mechanism"},h=this.paneEnvs.has(e),u=this.terminalChannel()?h?{status:"ready",reason:null}:{status:"unknown",reason:"no-pane-env"}:{status:"unavailable",reason:"no-backend"},d=this.deps.sessions.getBySessionId(e),S=d?.projectId==null?null:this.deps.projects.getById(d.projectId),q=S?k(this.hooksDir,S.token).filter(K=>K.sessionId===e).length:0;return{alive:i,inbox:l,queue:a,relay:c,terminal:u,paneEnvReported:h,pending:q,stalled:this.gate.isStalled(e)}}onSessionPrompt(e,t,s){const i=this.gate.acknowledge(e,t,s,{ackMinText:Te});return this.gate.hitLast&&this.queuedSessions.has(e)&&this.scheduleFlushContinuation(e),i}noteActivity(e){this.gate.noteActivity(e)&&this.queuedSessions.has(e)&&this.scheduleFlushContinuation(e)}armAckWatch(e){this.gate.armAckWatch(e)}armCommandAck(e){this.gate.armCommandAck(e,t=>{this.queuedSessions.has(t)&&this.scheduleFlushContinuation(t)})}stall(e,t,s){this.gate.stall(e,t,s)}async answer(e,t){if(t.length===0||!D.test(t[0])||t.some(i=>!D.test(i)&&!V.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 p(U),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,t="both",s){const i=await this.sessionKeysTarget(e,"\u51FB\u952E",t);if(!i.ok)return i;if(s!=null&&i.paneId===s)return{ok:!0,paneId:i.paneId,sent:!1};try{return await i.terminal.sendKeys(i.paneId,z),{ok:!0,paneId:i.paneId,sent:!0}}catch(n){return{ok:!1,status:409,error:n instanceof Error?n.message:String(n)}}}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,Y),{ok:!0}}catch(s){return{ok:!1,status:409,error:s instanceof Error?s.message:String(s)}}}async pressEnter(e){const t=await this.sessionKeysTarget(e);if(!t.ok)return t;try{return await t.terminal.sendKeys(t.paneId,X),{ok:!0}}catch(s){return{ok:!1,status:409,error:s instanceof Error?s.message:String(s)}}}async pressCtrlC(e){const t=await this.sessionKeysTarget(e);if(!t.ok)return t;try{return await t.terminal.sendKeys(t.paneId,$),{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(!Z.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,ie(s)),{ok:!0}}catch(n){return{ok:!1,status:409,error:n instanceof Error?n.message:String(n)}}}async setEffort(e,t){const s=t.trim(),i=await this.sessionKeysTarget(e);if(!i.ok)return i;const n=te(this.deps.hookEvents,e);if(!n.includes(s))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,ee(s)),{ok:!0}}catch(r){return{ok:!1,status:409,error:r instanceof Error?r.message:String(r)}}}async askSideQuestion(e,t){if(!this.deps.sessions.getBySessionId(e))return{ok:!1,status:404,error:"Session not found"};const s=this.surfaceOfSession(e),i=s?.sideQuestion??null;if(!i)return{ok:!1,status:409,error:s?.unsupportedReasons?.sideQuestion??"\u8FD9\u4E2A harness \u6CA1\u6709\u65C1\u8DEF\u4F1A\u8BDD\u901A\u9053"};const n=i.validate(t);if(!n.ok)return{ok:!1,status:400,error:n.error};if(i.prerequisite&&this.deps.sessions.hasRunOf(e)!==!0)return{ok:!1,status:409,error:i.prerequisite};const r=await this.sessionKeysTarget(e,"\u53D1\u8D77\u65C1\u8DEF\u4F1A\u8BDD");if(!r.ok)return r;try{return i.screen?(this.pollScreenAnswer(e,r.terminal,r.paneId,i,n.text),{ok:!0,question:n.text}):(await r.terminal.sendText(r.paneId,i.command(n.text)),{ok:!0,question:n.text})}catch(l){return{ok:!1,status:409,error:l instanceof Error?l.message:String(l)}}}pollScreenAnswer(e,t,s,i,n){const r=i.screen,l=async()=>await t.getPaneText?.(s).catch(()=>null)??null;(async()=>{const a=await l()??"";await t.sendKeys(s,r.openKeys).catch(()=>{}),await p(j),await t.sendKeys(s,r.submitKey).catch(()=>{}),await p(C);let o=await l();if((!o||!r.panelOpen(o))&&(await t.sendKeys(s,r.submitKey).catch(()=>{}),await p(C),o=await l(),!o||!r.panelOpen(o)))return;await t.sendText(s,n).catch(()=>{}),await p(j),await t.sendKeys(s,r.submitKey).catch(()=>{});const c=Date.now()+je;let h=null;for(;Date.now()<c;){if(await p(Me),o=await l(),o==null)return;const d=r.extractAnswer(n,a,o);if(d.done){h=d.answer;break}}h!=null&&(this.sideAnswerStore?.answerById(e,n,h),this.bus({kind:"sideQuestion.answered",sessionId:e,at:new Date().toISOString()}));const u=await l();u&&r.panelOpen(u)&&await t.sendKeys(s,r.closeKey).catch(()=>{})})()}async sessionKeysTarget(e,t="\u51FB\u952E",s="both"){return ne(this.keysDeps(),e,t,s)}busSafe(){return{emit:e=>this.bus(e)}}channelDeps(){return{setMemory:e=>this.memory.set(e.id,e),deleteMemory:e=>this.memory.delete(e),awaitAck:(e,t)=>this.gate.await(e,t),isSlashCommand,armAckWatch:e=>this.gate.armAckWatch(e),armCommandAck:e=>this.gate.armCommandAck(e,t=>{this.queuedSessions.has(t)&&this.scheduleFlushContinuation(t)}),emit:e=>this.bus(e),...this.deps.spawnImpl?{spawnImpl:this.deps.spawnImpl}:{}}}wireTextOfEntry(e){return oe(e,t=>this.surfaceOfSession(t))}hasImagesEntry(e){return re(e)}keysDeps(){return{sessions:this.deps.sessions,projects:this.deps.projects,hookEvents:this.deps.hookEvents,terminalChannel:()=>this.terminalChannel(),terminalPaneFor:(e,t,s)=>this.terminalPaneFor(e,t,s)}}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.gate.clearStall(t.sessionId,e),t.status==="delivered"&&t.via==="terminal"&&this.terminalChannel()){const o=await this.terminalPaneFor(i,n);if(o)return this.memory.set(e,{...t,status:"delivering",stalled:!1,settledAt:null}),this.runTerminalSubmit(e,o.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 l={...t,status:"pending",stalled:!1,acked:!1,settledAt:null,reason:void 0,error:null},a=await this.deliverPrompt(l,i,n,r);return this.bus({kind:"message.created",messageId:l.id,sessionId:l.sessionId,mode:l.mode,at:new Date().toISOString()}),a}dismiss(e,t){const s=this.memory.get(t);if(s){if(s.status==="running")return{ok:!1,status:409,error:"Message is still in flight"};s.status==="delivering"&&this.gate.headOf(s.sessionId)===t&&this.flushing.delete(s.sessionId),this.memory.delete(t),this.gate.clearStall(s.sessionId,t),this.gate.release(s.sessionId,t),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=k(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>Pe;){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))return;const t=Symbol(e);this.flushing.set(e,t);try{await this.flushSessionInner(e)}catch{}finally{this.flushing.get(e)===t&&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=k(this.hooksDir,s.token).filter(a=>a.sessionId===e);if(i.length===0){this.queuedSessions.delete(e);return}if(this.sessionJudgedDead(e)){this.failQueuedOffline(e,i.filter(a=>!this.dismissedIds.has(a.id)));return}const n=this.surfaceOfSession(e),r=n?.prompt??null,l=this.modalBlocked(e);for(const a of i){if(this.stalled.has(e))return;if(this.dismissedIds.has(a.id))continue;const o={id:a.id,sessionId:e,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(!l&&this.hasImagesEntry(o)&&this.terminalChannel()){const u=await this.terminalPaneFor(t,s);if(u){f(this.hooksDir,s.token,new Set([a.id])),this.memory.set(o.id,{...o,via:"terminal",status:"delivering"}),this.awaitingAck.set(e,o.id),await this.runTerminalPrompt(o.id,u.id,this.wireTextOfEntry(o)),this.settleQueueIndex(e,s.token);return}}if(n&&await this.tryQueuedDeliver(o,n)){f(this.hooksDir,s.token,new Set([a.id])),this.settleQueueIndex(e,s.token);return}if(n&&await this.tryInboxDeliver(o,n)){f(this.hooksDir,s.token,new Set([a.id])),this.settleQueueIndex(e,s.token);return}const c=r?.resolve(e)??null,h=o.forceTerminal===!0?["terminal"]:o.oneWay===!0?["terminal","relay"]:["relay","terminal"];for(const u of h){if(u==="relay"&&r&&c){if(this.memory.set(o.id,{...o,status:"delivering",via:"relay"}),!this.runRelay(o,r,c.name)){this.memory.delete(o.id);return}this.awaitingAck.set(e,o.id),f(this.hooksDir,s.token,new Set([a.id]));break}if(u==="terminal"&&!l&&this.terminalChannel()){const d=await this.terminalPaneFor(t,s);if(d){f(this.hooksDir,s.token,new Set([a.id])),this.memory.set(o.id,{...o,via:"terminal",status:"delivering"}),this.awaitingAck.set(e,o.id),await this.runTerminalPrompt(o.id,d.id,this.wireTextOfEntry(o));break}}}if(this.awaitingAck.get(e)===o.id){this.settleQueueIndex(e,s.token);return}return}this.settleQueueIndex(e,s.token)}settleQueueIndex(e,t){k(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+=ye(this.hooksDir,e),this.queuedSessions.delete(e),this.gate.clearStall(e),this.gate.release(e),this.inboxSockets.forget(e),this.paneEnvs.delete(e),this.revokedPaneEnvs.add(e),this.persistPaneEnvs(),t}forgetProject(e){const t=this.pendingOrigins.length;this.pendingOrigins=this.pendingOrigins.filter(i=>i.projectId!==e),this.pendingOrigins.length!==t&&this.persistPendingOrigins();let s=0;for(const[i,n]of this.memory)this.deps.sessions.getBySessionId(n.sessionId)?.projectId===e&&(this.memory.delete(i),this.inboxSockets.forget(n.sessionId),this.paneEnvs.delete(n.sessionId),this.gate.clearStall(n.sessionId),this.gate.release(n.sessionId),s++);for(const i of[...this.queuedSessions])this.deps.sessions.getBySessionId(i)?.projectId===e&&(s+=this.forgetSession(i));return this.persistPaneEnvs(),s}surfaceOfSession(e){const t=this.deps.hookEvents.listBySession(e,1),s=t[t.length-1]?.source;return E(s)?this.deps.surfaceFor?.(s)??L(s):null}resolveChannel(e,t,s){return he(this.deps.sessions,()=>this.terminalChannel()!=null,e,t,s)}async terminalPaneFor(e,t,s="both"){return se(this.terminalChannel(),this.paneEnvs,e,t,s)}terminalChannel(){const e=this.deps.terminal;return e&&e.available()?e:null}modalBlocked(e){return this.deps.blockedByQuestion?.(e)===!0}async deliverPrompt(e,t,s,i){if(this.sessionJudgedDead(e.sessionId))return{ok:!0,messageId:e.id,status:"failed",message:this.failOffline(e)};const n=this.modalBlocked(e.sessionId);if(!n&&this.hasImagesEntry(e)&&this.terminalChannel()){const u=await this.terminalPaneFor(t,s);if(u)return this.memory.set(e.id,{...e,status:"delivering",via:"terminal"}),this.awaitingAck.set(e.sessionId,e.id),this.runTerminalPrompt(e.id,u.id,this.wireTextOfEntry(e)),{ok:!0,messageId:e.id,status:"delivering",message:this.memory.get(e.id)}}const r=await this.tryQueuedDeliver(e,i);if(r)return{ok:!0,messageId:e.id,status:"delivered",message:r};const l=await this.tryInboxDeliver(e,i);if(l)return{ok:!0,messageId:e.id,status:"delivered",message:l};const a=i.prompt,o=a?.resolve(e.sessionId)??null,c=e.forceTerminal===!0?["terminal"]:e.oneWay===!0?["terminal","relay"]:["relay","terminal"];for(const u of c){if(u==="relay"&&a&&o){if(this.memory.set(e.id,{...e,status:"delivering",via:"relay"}),this.runRelay(e,a,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(u==="terminal"&&!n&&this.terminalChannel()){const d=await this.terminalPaneFor(t,s);if(d)return this.memory.set(e.id,{...e,status:"delivering",via:"terminal"}),this.awaitingAck.set(e.sessionId,e.id),this.runTerminalPrompt(e.id,d.id,this.wireTextOfEntry(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 h={...e,status:"pending"};return{ok:!0,messageId:e.id,status:"pending",message:h}}async tryQueuedDeliver(e,t){const s=t.queuedPrompt;if(!s||this.hasImagesEntry(e))return null;const{bin:i,args:n}=s.command(e.sessionId,this.wireTextOfEntry(e));this.memory.set(e.id,{...e,status:"delivering",via:"queue"});try{await ae(i,n,s.timeoutMs??3e4,this.deps.spawnImpl)}catch{return this.memory.delete(e.id),null}return P(this.channelDeps(),{...e,via:"queue"},"queue")}async tryInboxDeliver(e,t){const s=t.promptInbox,i=this.inboxSockets.get(e.sessionId);if(!s||!i||e.forceTerminal===!0)return null;this.memory.set(e.id,{...e,status:"delivering",via:"socket"});try{await J(s,i,this.wireTextOfEntry(e))}catch{return this.memory.delete(e.id),null}return P(this.channelDeps(),e,"socket")}queueEntry(e,t){de(this.hooksDir,t,e),this.queuedSessions.add(e.sessionId)}sessionJudgedDead(e,t=this.deps.livenessOf?.()??A()){return fe(this.deps.sessions,e,t)}failOffline(e){return ce(this.memory,t=>this.bus(t),e)}failQueuedOffline(e,t){me(this.deps,this.hooksDir,this.memory,s=>this.bus(s),e,t),this.queuedSessions.delete(e)}relayDeps(){return{headless:this.headless,getMemory:e=>this.memory.get(e)??null,setMemory:e=>this.memory.set(e.id,e),awaitAck:(e,t)=>this.gate.await(e,t),stall:(e,t,s)=>this.gate.stall(e,t,s),isSlashCommand,armAckWatch:e=>this.gate.armAckWatch(e),armCommandAck:(e,t)=>this.gate.armCommandAck(e,s=>{t(s),this.queuedSessions.has(s)&&this.scheduleFlushContinuation(s)}),onReleased:e=>{this.queuedSessions.has(e)&&this.scheduleFlushContinuation(e)},emit:e=>this.bus(e),...this.deps.bin?{bin:this.deps.bin}:{},...this.deps.relayTimeoutMs===void 0?{}:{relayTimeoutMs:this.deps.relayTimeoutMs}}}runRelay(e,t,s){return pe(this.relayDeps(),e,t,s,this.wireTextOfEntry(e))}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 n=this.memory.get(e);if(!n)return;const r={...n,status:"delivered",settledAt:new Date().toISOString()};this.memory.set(e,r),isSlashCommand(n.text)?this.armCommandAck(e):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);if(!r)return;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 l={...r,status:"failed",error:n instanceof Error?n.message:String(n),settledAt:new Date().toISOString()};this.memory.set(e,l),this.stall(s.sessionId,l,"failed"),this.bus({kind:"message.finished",messageId:e,sessionId:s.sessionId,status:"failed",at:new Date().toISOString()})}}deliverInject(e,t,s,i){return ue({hooksDir:this.hooksDir,memory:this.memory,bus:this.busSafe()},e,t,s,i,this.wireTextOfEntry(e))}deliverHeadless(e,t,s,i){return le({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}},e,t,s,i,this.wireTextOfEntry(e))}bus(e){try{this.deps.bus?.emit(e)}catch{}}}