@epoch-agent/protocol 3.1.2 → 4.0.0

package/README.md

@@ -21,7 +21,7 @@
 | `events.ts`           | `AgentEvent` 判别联合 —— 引擎与所有宿主之间的事件契约、`TokenUsage`                                                                                                                                                                                                                                                                  |
 | `usage.ts`            | `TokenUsage` 的口径算术 + **压缩那条线**（`compressionThresholdTokens`）                                                                                                                                                                                                                                                             |
 | `message.ts`          | `EpochMessage` 及其内容块（文本 / 图片 / `@` 提到的文件 / `@:` 引用的会话）。加第五种部件时 `assertNeverPart` 会让漏掉的分支在编译期红                                                                                                                                                                                               |
-| `permission.ts`       | 5 级权限、操作类型、审批请求 / 应答、`PermissionManager` 接口                                                                                                                                                                                                                                                                        |
+| `permission.ts`       | 4 级权限（`default` / `acceptEdits` / `plan` / `auto`；`bypass` 是 `auto` 的老别名）、操作类型、审批请求 / 应答、`PermissionManager` 接口                                                                                                                                                                                            |
 | `plan.ts`             | plan **模式**（临时只读区间，出口要人批一次）—— 与 `plan` 那个权限级别的口径                                                                                                                                                                                                                                                         |
 | `question.ts`         | 结构化提问的请求 / 答复（**不过权限层** —— 提问不是审批）                                                                                                                                                                                                                                                                            |
 | `hook.ts`             | Hook 类型与 trigger                                                                                                                                                                                                                                                                                                                  |
@@ -45,7 +45,7 @@
 | `artifact.ts`         | 大块工具输出的落盘引用                                                                                                                                                                                                                                                                                                               |
 | `wire.ts`             | 线上的信封（`WireEnvelope` / `WireHubEvent` / `WireAuthGuard`）                                                                                                                                                                                                                                                                      |
 | `wire-rest.ts`        | Web UI 的 REST 载荷（`Wire*Response`）与鉴权常量                                                                                                                                                                                                                                                                                     |
-| `wire-capability.ts`  | 能力页那一个端点的载荷。**单开一个文件**是因为 `wire-rest.ts` 已经 788 行                                                                                                                                                                                                                                                            |
+| `wire-capability.ts`  | 能力页那一个端点的载荷。**单开一个文件**是因为 `wire-rest.ts` 当时已经 788 行（⚠️ 那是**当时的理由**；该文件今天 4232 行，判据没变 —— 新端点别再往里堆）                                                                                                                                                                             |     |
 | `wire-host-badges.ts` | 宿主未读点（`POST/GET /api/host/badges` + `host-badges` 帧）：运行期状态不是配置，补齐为什么走流里那一帧而不是一发 GET，判据在它的文件头                                                                                                                                                                                             |
 | `wire-security.ts`    | 安全中心那五块。**全是读** —— 一个写字段都没有，判据在它的文件头                                                                                                                                                                                                                                                                     |
 | `wire-permission.ts`  | 改**这个会话此刻**的权限档那一对（决定 20 ③）。和上一行不是一回事，见下                                                                                                                                                                                                                                                              |

package/dist/index.d.ts

@@ -300,7 +300,25 @@ interface Operation {
 }
 interface PermissionDecision {
     allowed: boolean;
+    /** 给**用户界面**看的原因（审批框 / 安全中心）—— 跟界面语言走 */
     reason?: string;
+    /**
+     * 给**模型**看的同一条原因，**一律英文**（2026-11-05）。
+     *
+     * ## 为什么要多一格
+     *
+     * `reason` 会被 `tool-executor` 拼进工具输出（`Operation blocked by ...`），
+     * 而它的读者是模型；`reason` 同时又是审批框上给用户看的那句话。
+     * 一个字符串没法同时满足两个读者：跟着界面语言变，模型就会在 zh / en 两台机器上
+     * 看到两套措辞；冻成中文，英文用户看到的审批框就成了中文。
+     *
+     * 所以判定层（`by-level.ts` 的 `reasonPair()`）一次产出两份，**同一个 catalog key
+     * 的两种语言渲染**，不是两份手写文案。
+     *
+     * 缺席时工具输出退回一句固定的英文兜底（不印 `reason`）——
+     * 嵌入宿主自己实现 `PermissionManager` 时不填这一格也不会露出中文。
+     */
+    modelReason?: string;
     /** deny=false 时是否需要弹出审批对话框（ask_user），deny=true 时为静默拒绝 */
     requireApproval?: boolean;
     /**
@@ -1218,19 +1236,25 @@ declare class DiagnosticSink {
  * 角色的来源。同名时优先级 project > user > host > plugin > builtin，
  * 但工具集只取交集。
  *
+ * ## ⚠️ `builtin` 这一档**今天没有生产者**（2026-11-05）
+ *
+ * 内置的那三个角色（`general` / `explore` / `review`）删掉了。这一档留着是
+ * 因为它是**公开契约**：`epoch agents` 的来源徽标、web 能力页的分组索引
+ * （`web/src/capability/experts.tsx` 的 `ROLE_GROUPS`）都按这个联合建表，
+ * 而嵌入宿主引用这个类型时不应当因为一次「我们那边不打算内置了」而编译红。
+ * 看见 `source === 'builtin'` 不必害怕，但也不要指望它会出现。
+ *
  * `plugin`（方案 32）和 `host`（方案 44）的名字**一定带 `<前缀>:`**，所以这两档
- * 排在哪儿其实观察不到 —— 前缀让它们不可能和别的来源撞名。排在 builtin 之上只是
- * 为了让「同名时谁赢」这张表在所有来源上都有定义，不留一个靠合并顺序碰巧决定的角落。
+ * 排在哪儿其实观察不到 —— 前缀让它们不可能和别的来源撞名。排在最后只是为了
+ * 让「同名时谁赢」这张表在所有来源上都有定义，不留一个靠合并顺序碰巧决定的角落。
  *
  * ## `host` 那一档是**装配层**填的，不是宿主自己填的（方案 44 §2.1 a）
  *
  * 嵌入宿主经 `BuildRuntimeOptions.hostCapabilities` 递进来的是一批**没有 `source`
  * 的**角色，这一格和名字前缀都由装配层按宿主给的 namespace 拼。让宿主自己写的
- * 后果很具体：它注入一个叫 `general` 的角色就能顶掉 `BUILTIN_ROLES` 里那条，
- * 而 `delegate_task` 不带 `role` 时取的默认值正是 {@link DEFAULT_AGENT_ROLE}
- * = `'general'` —— 于是**每一次没指定角色的派活都跑在宿主那份 prompt 上**。
- * 而那条内置角色的注释写着它「必须存在且必须不带白名单……行为要与方案 18 之前
- * **逐字一致**」。
+ * 后果很具体：它注入一个叫 `general` 的角色就能静静顶掉同名的用户级那一份
+ * （`mergeRoles` 的同名语义），而屏幕上看不出这一行是从哪来的。前缀把这条
+ * 可能性从根上断掉。
  *
  * ⚠️ 拼前缀的**顺序**有约束：下面的 {@link AGENT_ROLE_NAME_PATTERN} 不允许 `:`，
  * 所以前缀只能在**校验通过之后**拼。这条顺序是 `loadPluginRoles` 立的
@@ -1311,8 +1335,9 @@ interface AgentRole {
      * 工具名会被静默忽略并记一条警告诊断，不会报错中断。
      *
      * ⚠️ **对含 `terminal` 的角色不构成安全边界** —— 有 shell 就能
-     * `echo > file` 绕开「没有 file_write」。内置只读角色的白名单里
-     * 不含 `terminal` 也不含 `code_exec`，那时它才是硬边界。
+     * `echo > file` 绕开「没有 file_write」。只有白名单里**同时**不含
+     * `terminal` 和 `code_exec` 的时候它才是硬边界 —— 2026-11-05 之前
+     * 内置的 `explore` / `review` 就是那种，现在要自己写。
      */
     tools?: string[];
     /**
@@ -1327,7 +1352,7 @@ interface AgentRole {
      *
      * 1. **它当不了边界，想当也当不了。** 技能是盘上的 md 文件，任何拿得到
      *    `file_read` 的角色都能直接读 `~/.epoch/skills/` 下任何一条 `SKILL.md` ——
-     *    而两个内置只读角色的 `READ_ONLY_TOOLS` 里**都有 `file_read`**。
+     *    而只要角色不自己把 `file_read` 从白名单里剔掉，它就有这一条。
      *    这比上面 `tools` 那句「对含 `terminal` 的角色不构成安全边界」更彻底：
      *    那边是「某些角色能绕」，这边是**每个**角色都能绕。所以它的定位只能是
      *    **上下文预算**（同 `skills.maxIndexed` 封顶那一档），不是权限轴；
@@ -1399,7 +1424,18 @@ interface AgentRole {
     maxTurns?: number;
     source: AgentRoleSource;
 }
-/** 默认角色名 —— `delegate_task` 不带 `role` 时用它，行为等于改造前 */
+/**
+ * 默认角色名 —— **历史默认值**，方案 18 时代 `delegate_task` 不带 `role` 时的兜底。
+ *
+ * @deprecated 2026-11-05：内置角色删了，**没有东西再兜底到这个值**。
+ * `delegate_task` 不传 `role` 时现在直接不查表（判据在 `runtime/src/
+ * session-factory.ts` 的 `subRunner`），与「调一个不带白名单的 `general`」
+ * 效果相同 —— 但那是效果相同，不是它仍然被引用。
+ *
+ * 这个常量**没有删**：它是 protocol 的公开导出，嵌入宿主可能还引着它，
+ * 删一次会让下游编译红。新代码别拿它当默认值用，也别指望 `general`
+ * 这个名字在角色表里一定找得到。
+ */
 declare const DEFAULT_AGENT_ROLE = "general";
 /** 角色名的合法形状。定成常量是因为 loader 校验和 CLI 提示都要引它 */
 declare const AGENT_ROLE_NAME_PATTERN: RegExp;
@@ -1701,7 +1737,7 @@ declare function agentMessageLine(msg: Pick<AgentMessage, 'from' | 'text'> & {
  */
 declare function sessionSenderLabel(sessionId: string, title?: string | null): string;
 /** 一条给模型看的 note 标题（父会话那一侧，`TaskNoticeTracker` 拼） */
-declare const AGENT_MESSAGE_NOTE_TITLE = "Agent \u6D88\u606F";
+declare const AGENT_MESSAGE_NOTE_TITLE = "Agent messages";
 /**
  * 团队共享任务的状态（阶段 2）。
  *
@@ -2620,6 +2656,13 @@ interface SettingsPaneItem {
  * | `EpochConfig.sidebarMenu` | 侧栏最底下那一格里「用户」**右边**那枚分体按钮（一项露在外面，其余在「⋯」里） | 那枚按钮整个没有，「用户」照旧一整行 |
  * | `EpochConfig.sidebarHeadMenu`（2026-10-15） | 侧栏头「收起侧栏」左边那几枚图标；收起后探出来那张卡里是几行菜单 | 侧栏头一枚都不多 |
  * | `EpochConfig.topbarMenu`（2026-10-19） | 顶栏最右端那一枚图标按钮（第一项露在外面，其余收在它右边那枚「⋯」展开的菜单里） | 顶栏右边一枚都不多 |
+ * | `EpochConfig.trayMenuLeft`（2026-11-04） | 输入框下面那条托盘左端、「插件」那一格**之后** | 左端一枚都不多 |
+ * | `EpochConfig.trayMenuRight`（2026-11-04） | 同一条托盘右端、上下文环**之前** | 右端一枚都不多 |
+ *
+ * ⚠️ **最后那一对（托盘）的 item 不是这个形状**，是 {@link TrayMenuItem} —— 它多两副
+ * 文案/图标（默认态与选中态）和一个 `closable`。判据在 {@link TrayMenuItem} 上，
+ * 它**继承** {@link SidebarMenuItem} 而不是另起一份：`id` / `label` / `icon` 三个字段
+ * 的含义和校验一个字都没变。
  *
  * 同一条消息还有一个发送方不是菜单项：`EpochConfig.brandMenuId`（2026-10-15）配了时，
  * 点侧栏头那一格品牌发 `{ type, id: brandMenuId }`。
@@ -2789,6 +2832,67 @@ interface SidebarNavItem extends SidebarMenuItem {
      */
     primary?: boolean;
 }
+/**
+ * 托盘（输入框下面那条）里的一项（2026-11-04）—— {@link SidebarMenuItem} 再多三格。
+ *
+ * 它服务 `EpochConfig.trayMenuLeft` / `EpochConfig.trayMenuRight` 两个键，**互不兜底**
+ * （判据同上面那几个键：只配一个的宿主在另一边一项都不多）。
+ *
+ * ## 为什么这一回拆了新名字
+ *
+ * {@link SidebarMenuItem} 的 JSDoc 写着「某个键的 item 真要长得不一样的那天，那时才拆」
+ * —— 这天到了：托盘这一项有**两态**（默认态 / 选中态），而两态各有自己的文案和图标。
+ * 上面那三个键的项没有「选中」这个宾语（点下去是离开这一屏，不是把某项打开）。
+ *
+ * ⚠️ **拆的是「多出来的三格」，不是整个形状**：`id` / `label` / `icon` 原样继承，
+ * 校验（`.min(1)`、`id` 不许重复）也照抄 —— 宿主在两个键之间搬一项时，那三格
+ * 一个字都不用改。
+ *
+ * ## 状态**不在这一份里**
+ *
+ * 这一项此刻是默认态还是选中态，**不是配置**：它是宿主在运行中的业务状态，
+ * 由宿主经 `POST /api/host/tray` 下发（判据在
+ * [wire-host-tray.ts](./wire-host-tray.ts) 的文件头）。配置只回答「这一项长什么样」。
+ * 所以**没有 `active?: boolean` 字段** —— 写进配置的那一份会在第一次宿主改状态时
+ * 变成一个会撒谎的副本，而且重开页面还会拿它把状态盖回去。
+ */
+interface TrayMenuItem extends SidebarMenuItem {
+    /**
+     * 选中态印的那几个字。**不写 = 还用 {@link SidebarMenuItem.label}。**
+     *
+     * 空串是配错了（不要这一态就别写这个键，同 `label`）：core 的 schema 会拦。
+     */
+    activeLabel?: string;
+    /**
+     * 选中态左端那枚图标。**不写 = 还用 {@link SidebarMenuItem.icon}。**
+     *
+     * 白名单和 `icon` 是同一张（`web/src/shell/host-menu.tsx` 的 `HOST_ICONS`），
+     * 认不出来的同样落兜底 —— 判据逐字在同名那个字段上，这儿不重复。
+     *
+     * ⚠️ **写「同步中」的时候别顺手填 `rotate-ccw`**：它在 `IconName` 里，但**不在
+     * 那张白名单里** —— 白名单剔掉的正是「我们这张界面自己的动词」（旋转、叉、加号、
+     * 齿轮那一批，判据在 `HOST_ICONS` 文件头），因为它们在这张页上已经各有各的意思。
+     * 写上去的表现不是报错，是静默落回兜底那枚 `target`（「两态一模一样」看着像没切）。
+     * 名词类的用 `gauge` / `cloud` / `sparkles` 这些。
+     */
+    activeIcon?: string;
+    /**
+     * 选中态左端那一格画成**关闭键**吗。**缺省 `false` = 不画。**
+     *
+     * 缺省选 `false` 而不是 `true`：不写这个键的宿主拿到的是「一枚按钮」——
+     * 和 `sidebarMenu` 的项一样。多出来一枚 × 是它没要的东西，而 × 按下去
+     * **不改这一项自己的状态**（状态归宿主），所以画了它就得配一条宿主监听去处理。
+     *
+     * 画了之后的位置和形状**照抄插件那一格**：左起那一格平时是该项的图标
+     * （选中态用 {@link activeIcon}），悬停 / 键盘聚焦时换成 ×；点它发
+     * `action: 'clear'`，点名字那一半发 `action: 'click'`（判据在
+     * {@link TrayMenuMessage} 上）。
+     *
+     * ⚠️ **× 的语义是「请宿主把这一项切回默认态」，不是「把这一项从托盘上拿掉」**
+     * —— 「这一项画不画」归配置，运行期改不动它（同 `SidebarMenuItem` 那一族）。
+     */
+    closable?: boolean;
+}
 /**
  * 那条 `postMessage` 的 `type`。**宿主和我们共用这一个字面量**，两边都别手抄。
  *
@@ -2805,6 +2909,68 @@ interface SidebarMenuMessage {
     type: typeof SIDEBAR_MENU_MESSAGE_TYPE;
     id: string;
 }
+/**
+ * 托盘项被按了之后发出去的那条消息（2026-11-04）—— **和上面那条同一个 `type`**，
+ * 多一格 {@link action}。
+ *
+ * ## 为什么复用同一个 `type`
+ *
+ * 文件头那条判据（「几个键共用这一条消息，不带来源」）在这里同样成立：宿主已经拿
+ * `id` 认出是哪一项，而 `id` 出自它自己那份配置 —— 它当然知道那一项配在托盘上。
+ * 为托盘另开一个 `epoch:tray-menu` 的代价是**宿主那句监听得跟着改**，换来的是
+ * 一个它本来就答得出的答案。
+ *
+ * ## 为什么多这一格
+ *
+ * `id` 只回答「哪一项」，回答不了「用户按的是主体还是那枚关闭键」—— 而同一项上
+ * 这两下在宿主那边要做的事不一样（点主体是「打开 / 切到某个东西」，点关闭是
+ * 「把它收回去」）。`action` 缺省是 `'click'`，于是**现有宿主那句监听一个字都不用
+ * 改**：它不读 `action` 时，托盘项点主体和侧栏项的行为完全一样。
+ *
+ * ⚠️ **不带「现在是哪一态」**：那同样是宿主自己下发的（`POST /api/host/tray`），
+ * 多带一份就是多一个会漂的副本（判据同 {@link SidebarMenuMessage} 不带 `label`）。
+ */
+interface TrayMenuMessage extends SidebarMenuMessage {
+    /**
+     * 这一下按的是什么。**缺省（消息里不出现）= `'click'`。**
+     *
+     * - `'click'` —— 按了项的主体（名字那一半）
+     * - `'clear'` —— 按了左端那枚关闭键（只有 `closable: true` 的项画得出来）
+     *
+     * 宿主收到之后**自己改状态、再经 `POST /api/host/tray` 回给页面** ——
+     * 页面不自己切，判据在 [wire-host-tray.ts](./wire-host-tray.ts) 文件头。
+     */
+    action?: 'click' | 'clear';
+    /**
+     * 按这一下的时候，这张页**正在看哪一段会话**（2026-11-04）。没有会话时不出现
+     * （新会话空屏、或者宿主还没把 `sessionId` 交给这张页）。
+     *
+     * ## 为什么带在消息里，而不是让宿主去查
+     *
+     * 「这一段会话」是**这张页**的一个状态（路由上那个 id），服务端并没有一个「此刻
+     * 谁在看哪段」的真源：
+     *
+     * - `GET /api/config` 的 `lastSessionId` 是**上次停留**（`PUT /api/last-session`
+     *   落盘的那一份），语义是「下次启动开哪段」—— 它是为**重启**准备的，不是为
+     *   「此刻」；
+     * - 而且那一条是**一台机器一份**（按项目根分格）：两个窗口看两段会话时，
+     *   后上报的那个会盖掉先上报的。拿它当「当前会话」会让宿主偶尔对一个错的
+     *   id 动手，而屏幕上一点异样都没有。
+     *
+     * 反过来，按这一下的时候页面自己手里就握着那个 id —— 带一格是零成本的，
+     * 而让宿主去猜是办不到的。这正是它和 `action` 的区别：`action` 说的是
+     * 「哪种手势」，这一格说的是「对着哪一段」。
+     *
+     * ⚠️ **只在托盘这一条上带，侧栏 / 顶栏 / 品牌那几项不带**：那几个面是**全局
+     * 导航**（返回控制台、帮助中心、站内信），和「哪一段会话」没有关系；给它们也
+     * 塞一格会诱使宿主把一个全局入口当成会话级动作。
+     *
+     * ⚠️ **它是这一下的事实，不是订阅**：宿主不会因为页面切了会话就收到什么。
+     * 想知道「用户现在停在哪」只能等他按一次托盘项，或者自己在宿主那一侧管路由 ——
+     * 我们不做「切会话通知」（那会是一条新的出站消息，形状和这一格完全不同）。
+     */
+    sessionId?: string;
+}
 /**
  * 配了 `EpochConfig.userMenuHost` 时，「用户」那一行点下去**不再画我们那张菜单**
  * —— 改为往父窗口发一条 {@link UserMenuMessage}，宿主收到后弹**它自己的**菜单。
@@ -3712,6 +3878,63 @@ interface EpochConfig {
      * 一项亮着，「⋯」自己右上角也挂一颗（和侧栏收起时那枚开关同一个处置）。
      */
     topbarMenu?: readonly SidebarMenuItem[];
+    /**
+     * 宿主自定义的**托盘左端**（2026-11-04）。**缺省 = 左端一枚都不多。**
+     *
+     * 画的位置：输入框**下面**那条托盘的左半边，「插件」那一格**之后**、上下文环
+     * 那一组之前。一项一枚，**按宿主写的顺序从左到右**。
+     *
+     * ## 每一项有两态，而状态**不在这个键里**
+     *
+     * 默认态印 `label` / `icon`，选中态印 `activeLabel` / `activeIcon`（不写就还用
+     * 默认那副）。这一项此刻选没选中**不是配置** —— 它是宿主运行中的业务状态，经
+     * `POST /api/host/tray` 下发、SSE 帧 `host-tray` 推给页面，判据在
+     * [wire-host-tray.ts](./wire-host-tray.ts) 的文件头。
+     *
+     * ⚠️ **页面自己不切状态**：点主体发 `{ type: 'epoch:sidebar-menu', id, action: 'click' }`，
+     * 点那枚关闭键发 `action: 'clear'`（`closable: true` 才画得出来），宿主收到之后
+     * 改自己的状态、再调那个端点推回来。为什么必须这样（而不是页面先乐观地切过去）
+     * 在那份文件头第二节。
+     *
+     * ⚠️ **`icon` / `activeIcon` 只认 `HOST_ICONS` 那张白名单里的名字**（和侧栏那几项
+     * 同一张），认不出来就落兜底那枚 `target`。想要「同步中」那种转圈记号时别写
+     * `rotate-ccw`（它在图标集里、但**不在白名单里**，判据在 `TrayMenuItem.activeIcon` 上）。
+     *
+     * ## 校验和另外几个宿主菜单键逐字相同
+     *
+     * **空数组是配错了**（不要就别写这个键）、`id` 不许重复、**不设条数上限** ——
+     * 三条都逐字同 {@link sidebarMenu}，连理由都一样（为一个装饰性清单判一次校验
+     * 失败，代价是宿主整份配置退默认值）。装不下由界面自己兜。
+     *
+     * ⚠️ **和 {@link trayMenuRight} 互不兜底**：只配左边时右边一项都不多，反过来也一样
+     * （判据同 `sidebarMenu` / `sidebarHeadMenu` 那一对）。
+     *
+     * ## 窄的时候只剩图标
+     *
+     * 托盘是一条 `nowrap` 的 flex 行，左边已经有工作区（长目录名会裁）、身份、插件，
+     * 右边有上下文环和当前分支。宿主项在**容器窄于 440px** 时只剩图标，`label` 退到
+     * `aria-label` / `title` 上 —— 这是设计里的既定形态，不是缺陷（判据在 `web/src/styles/shell.css`
+     * 的 `@container composer-foot` 那一段）。
+     */
+    trayMenuLeft?: readonly TrayMenuItem[];
+    /**
+     * 宿主自定义的**托盘右端**（2026-11-04）。**缺省 = 右端一枚都不多。**
+     *
+     * 画的位置：同一条托盘右半边、**上下文环之前**（不在分支右边）。理由有两条，
+     * 都指向同一个排法：
+     *
+     * 1. 托盘右端的富余空间只有一个落点，`margin-left: auto` 生效的只能有一份 ——
+     *    它今天是上下文环那一份（分支那份被 `~` 清零，判据在 `shell.css` 的
+     *    `.composer__ctx` 那一段，门禁在 `__tests__/styles-composer-bar.test.ts`）;
+     * 2. 分支和环都是「这个会话此刻的事实」，而宿主那几项是宿主自己的入口 ——
+     *    排在环**之前**，扫一眼过去还是「工作区 → 身份 → 插件 → 宿主项 → 事实」；
+     *    排到分支右边就等于把一句会自己变的旁注切成两半。
+     *
+     * 形状、两态、校验、消息 **全部逐字同 {@link trayMenuLeft}**（同一个
+     * {@link TrayMenuItem}、同一条 `postMessage`、同一套「状态归宿主」的判据），
+     * 差别只有屏幕上那半边。两者**互不兜底**。
+     */
+    trayMenuRight?: readonly TrayMenuItem[];
     /**
      * 宿主自定义的那几张开场卡片（2026-09-04）。**缺省 = 新会话空屏上一张都没有**，
      * 那一屏仍然只有一行招呼。
@@ -5000,7 +5223,7 @@ declare function imagePartOmittedSummary(part: EpochImagePart): string;
  * 理由逐字同 {@link OMIT_LABEL}：它进模型 prompt、进 eval 指纹、**不进 catalog**
  * （跟着界面语言变的后果见 §33.2）。
  */
-declare const OFFLOADED_IMAGE_NOTE = "[\u56FE\u7247\u5DF2\u4E0B\u653E\uFF1A\u539F\u56FE\u4ECD\u5728 artifact \u76EE\u5F55\u91CC\uFF0C\u9700\u8981\u5C31\u8C03 file_read \u6309\u8DEF\u5F84\u53D6\uFF1B\u522B\u8BA9\u7528\u6237\u91CD\u53D1\uFF0C\u91CD\u53D1\u4E5F\u4E0D\u6539\u53D8\u4F53\u79EF]";
+declare const OFFLOADED_IMAGE_NOTE = "[image offloaded: the original is still in the artifact directory \u2014 call file_read by path if you need it; do not ask the user to resend, resending does not change the size]";
 /**
  * 把一张图片部件换成上面那句占位。**内容一个字节都不留** —— 这是「下放」的
  * 全部含义：原图在 artifact 目录里，引用它的是路径，不是 base64。
@@ -5105,7 +5328,7 @@ declare function contentToText(content: EpochUserContent, opts?: ContentToTextOp
  * 所以措辞是「调用过」而不是「做成了」—— 一次被权限拒掉的 `file_write`
  * 在这里照样留一笔，而那句话仍然是真的。
  *
- * ## 为什么住在 protocol、且是冻住的中文
+ * ## 为什么住在 protocol、且是冻住的英文
  *
  * 它的读者是**模型**，和 {@link contentToText} / {@link filePartSummary} 同一类，
  * 所以走同一条规矩：住在这个零依赖的包里、逐字冻住、**不跟着界面语言变**
@@ -6600,6 +6823,17 @@ declare const SCHEDULE_DEFAULT_PERMISSION: PermissionLevel;
  * 界面上把「上一次因为上一次还在跑所以跳过了」显示成红叉，用户会去查一个不存在的故障。
  */
 type ScheduleRunStatus = 'ok' | 'failed' | 'denied' | 'timeout'
+/**
+ * 用户按了「终止」，这一轮在跑到一半被中止（2026-11-04）。
+ *
+ * ⚠️ **它必须和 `failed` 分开。** 判据同三种 `skipped-*`：把「我自己按了停止」
+ * 画成红叉，用户会去查一个不存在的故障。它也不是 `ok` —— 那件事没办完。
+ * 界面上它是 `warn` 那一档（`statusTone` / `statusLabel` 两张表都有它）。
+ *
+ * 产出点只有执行器一处：协作式取消看见标记、或同进程的 `signal` 被 abort。
+ * 被 `kill -9` / `SIGTERM` 强杀的那一轮**没有这一行**（进程跑不到收尾）。
+ */
+ | 'cancelled'
 /**
  * 触顶。
  *
@@ -7843,6 +8077,184 @@ declare function isPromptOversize(prompt: number, contextLength: number): boolea
  */
 declare function totalUsageTokens(usage: TokenUsage): number;
 
+/**
+ * 宿主托盘项的两张**运行期表**（2026-11-04）—— 哪几项选中，以及每一项此刻长什么样。
+ *
+ * ```
+ * POST   /api/host/tray        { id, active }     选中 / 取消一项，回整张表
+ * POST   /api/host/tray/items  { id, label?, … }  覆盖一项的文案 / 图标 / 关闭键，回整张表
+ * DELETE /api/host/tray/items?id=x                撤掉这一项的覆盖（不带 id = 撤掉整份）
+ * GET    /api/host/tray                           → 200 WireHostTray（两张表一起）
+ * ```
+ *
+ * ## 两张表都是运行期状态，都不是配置
+ *
+ * - **选中态**（{@link WireHostTray.active}）：云同步正在跑、设备此刻连着 —— 只有
+ *   宿主在运行中才知道。
+ * - **长什么样**（{@link WireHostTray.items}）：默认来自配置的 `TrayMenuItem`
+ *   （两副文案和图标），但宿主可以在运行期覆盖它 —— 文案随状态变（「云同步 3/10」）
+ *   是这一格的用途，而配置那份写得下的是**常态**。
+ *
+ * 两张表都只在服务进程的内存里，**进程重启即清空**：
+ *
+ * - 一个上次进程留下的「同步中」在启动时自己冒出来，说的是一件宿主此刻并不知道的事；
+ * - 覆盖清空则回落到配置那一份 —— 那是安全的默认（配置里写的正是宿主想要的常态）。
+ *
+ * ## 为什么「长什么样」也要一条运行期通道
+ *
+ * 配置那一份是**装配期预置**的：`runtime.config` 在引擎启动时读一次，
+ * `GET /api/config` 原样转发。全仓**没有配置热重载**（`reloadConfig` / `watchConfig`
+ * 一处都没有），也没有写配置的端点 —— 于是改 `trayMenuLeft` 里的一个字，
+ * **刷新页面没有用**（页面重新拉到的还是同一份内存里的配置），**只有重启引擎**
+ * 才会重读。
+ *
+ * 给托盘单开这条通道，而不是把 `EpochConfig` 改成运行期可变：后者是几十个键共用的
+ * 「装配期预置」契约，改成可变要逐个键重审「改了之后已经跑起来的会话 / 已经连上的
+ * provider 怎么办」。而这里要的只是**几格字**。
+ *
+ * ## 合并语义：`配置那一项 ⊕ 覆盖`
+ *
+ * 逐字段覆盖 —— 给了才盖，没给的用配置那份：
+ *
+ * | 配置 | 覆盖 | 屏幕上是 |
+ * | --- | --- | --- |
+ * | `label: '云同步'` / `icon: 'cloud'` | `label: '云同步 3/10'` | 文案换了，图标照旧 |
+ * | `closable: true` | `closable: false` | 选中态不再画那枚 × |
+ *
+ * ⚠️ **`closable: false` 是一句有效的话**，不是「没给」。判据是 `!== undefined`，
+ * 不是 `if (patch.closable)` —— 后者会把「关掉关闭键」读成「不覆盖」。
+ *
+ * ⚠️ **覆盖改不了「有哪些项、什么顺序」**：配置仍是这一件事的唯一真源。往 `items`
+ * 里写一个配置里没有的 `id` 照收（同 `active`：先覆盖再改配置也走得通），但界面上
+ * 一项都不多 —— **运行期加不了一项**。真要动态加，那是另一笔（得先定「运行期项和
+ * 配置项怎么排序、删掉的那一项怎么收」）。
+ *
+ * ## ⚠️ 真源在宿主，页面只画
+ *
+ * 这一条是这个文件里最要紧的判据，它决定了下面三条投递路径为什么必须是**整张表**：
+ *
+ * 页面上点一下托盘项，发的是 `{ type: 'epoch:sidebar-menu', id, action }`
+ * （`TrayMenuMessage`），**页面自己不切状态**。宿主收到、按自己的业务决定、再调
+ * `POST /api/host/tray` 把新表推回来。
+ *
+ * 反过来做（页面先乐观切成选中态）的代价很具体：宿主那边其实没切过去，屏幕上却
+ * 已经说「同步中」了 —— 而用户下一步会照着这句话等一个不会来的结果。这不是
+ * 「体验更好一点」的取舍，是这个仓库从决定 20 ① 起就立着的那一条：
+ * **一个点下去立刻变了的控件，必须在说真话**。
+ *
+ * 代价如实记着：宿主必须接两件事（出站那条监听 + 调这个端点），而只在浏览器里
+ * 打开 `epoch web` 的机器上没有人调这个端点 —— 托盘项会永远停在默认态。
+ * 那是预期形态（和 `userMenuHost` 那一档同一种：没有宿主就等于没有这半个功能），
+ * 不是缺陷。
+ *
+ * 覆盖那半（`items`）同理，只是它没有「点下去」这个触发器：宿主觉得该变就自己发，
+ * 页面每收一帧就按新表重画。所以 **`items` 也不该被页面本地缓存成自己的状态** ——
+ * 一个自己 `useState` 过的文案会在下一帧到达时和宿主那份分叉，而那种分叉只会在
+ * 「宿主改回去了、屏幕上还是旧的」时才被发现。
+ *
+ * ## 三条投递路径
+ *
+ * | 页面此刻在哪 | 走哪条 |
+ * | --- | --- |
+ * | 首屏，流还没接上 | `GET /api/config` 的 `hostTray`（**两张表都空才不带这个键**） |
+ * | 流**每一次**接上（含断线重连） | 连接级帧 `host-tray`（`seq: 0`）—— 接上那一刻的整张表 |
+ * | 流开着，宿主改了一项 | 广播帧 `host-tray`（进环形缓冲）—— 改完之后的整张表 |
+ *
+ * ⚠️ **补齐走流里那一帧，不走「连上之后自己 GET 一次」**，判据逐字同
+ * [wire-host-badges.ts](./wire-host-badges.ts) 的文件头那一段（晚到的一份旧表会盖掉
+ * 新表；同一条有序的流上，最后落地的总是此刻那一份）。
+ *
+ * ## ⚠️ 没有「回环之外一律 403」那道闸
+ *
+ * 判据同 `POST /api/host/badges`：这一发只改内存里一张表、让屏幕上某一格换一副
+ * 文案，能力不比任何一条已鉴权的写端点大。它照旧过鉴权和 `Origin` 那道闸（POST）。
+ */
+/**
+ * 托盘那一套运行期表的整份（`GET /api/host/tray` 的响应、`host-tray` 帧的载荷、
+ * 以及 `GET /api/config` 上的 `hostTray`）。
+ *
+ * ⚠️ **两张表一起走、一起补帧**：它们是同一条语义（「宿主此刻说托盘长什么样」）的
+ * 两半，拆成两条流只会让连接级补帧多写一遍、让页面多一个「只到了一半」的时刻。
+ */
+interface WireHostTray {
+    /**
+     * 此刻**选中**的那几项的 `id`（托盘项的 `id`，同 `TrayMenuItem.id`），
+     * 按第一次选中的先后排。
+     *
+     * ⚠️ 形状是「选中的那几个 id」，不是 `id → boolean`：取消选中就是从表里拿掉，于是
+     * 「没有这一项」和「这一项是 false」不会是两种说法。以后要带数字的话加一格并列的
+     * 字段，这一格的意思不变。
+     *
+     * ⚠️ **各项互相独立**：同一侧配了多项时，可以同时有多项在这里。互斥（一次只能
+     * 选一个）是宿主的业务决定，不是这个形状的约束 —— 页面照单全画，不替宿主做减法。
+     *
+     * ⚠️ **不认得的 `id` 照收**（服务端不拿它去对配置）：界面上只有配过的那几项会画
+     * 选中态，多出来的 id 不画、不报错 —— 宿主可以先选再配，也可以对着同一张表在
+     * 几处画。
+     */
+    active: string[];
+    /**
+     * 此刻**覆盖**过的项，按 `id` 索引（2026-11-04）。**一项都没覆盖就没有这个键**
+     * —— 和「覆盖了但没给任何字段」不是一回事（后者本就不该发得出来）。
+     *
+     * 值是**只含覆盖字段的那几格**，不含 `id`（`id` 就是这里的键）。页面拿它和配置
+     * 那一份逐项合并，判据见上面的「合并语义」。
+     *
+     * ⚠️ **不认得的 `id` 照收**，理由同上一条 `active`：界面按配置那份清单画，多出来的
+     * 覆盖没有落脚处，不画也不报错。
+     *
+     * ⚠️ **它是整张表**（同 `active`）：一次只发变过的那一份会让「回落到配置」表达不出来
+     * —— 页面得知道哪一项的覆盖被撤掉了。
+     */
+    items?: Record<string, WireTrayItemOverride>;
+}
+/**
+ * 一项托盘项的**覆盖字段**（`WireHostTray.items` 的值、`POST /api/host/tray/items` 的
+ * 请求体去掉 `id` 之后那一半）。
+ *
+ * 五格一一对应 `TrayMenuItem` 上可覆盖的那五个字段 —— 配置换了名字这里要跟着换，
+ * 而校验口径也照那边：`label` / `activeLabel` / `icon` / `activeIcon` **空串一律 400**
+ * （空串是配错了，不是「不要这一格」），`closable` **只认布尔**（写成 `"false"` 也是 400，
+ * 同 core 配置 schema 里每一个开关）。
+ *
+ * ⚠️ **缺省 = 不覆盖**（用配置那一份），所以「想撤掉某一格的覆盖」不是给空值，
+ * 是 `DELETE /api/host/tray/items?id=` 把这一项整个撤掉 —— 否则「空串」和「没给」在
+ * 请求体里会成为两种说法，而它们在协议上不该是两件事。
+ */
+interface WireTrayItemOverride {
+    /** 屏幕上那几个字（缺省 = 配置那份） */
+    label?: string;
+    /** 选中态印的那几个字（缺省 = 配置那份；配置也没写就退回 `label`） */
+    activeLabel?: string;
+    /** 行首那枚图标的名字（缺省 = 配置那份） */
+    icon?: string;
+    /** 选中态那枚图标的名字（缺省 = 配置那份） */
+    activeIcon?: string;
+    /** 选中态左端那一格画成关闭键吗（缺省 = 配置那份；`false` 是有效覆盖） */
+    closable?: boolean;
+}
+/** `POST /api/host/tray` 的请求：选中 / 取消**一项**。同一个值写两次是幂等的（不发帧） */
+interface WireHostTrayRequest {
+    /** 托盘项的 `id`，非空字符串 */
+    id: string;
+    /** `true` 选中、`false` 取消。只认布尔，写成字符串是 400 */
+    active: boolean;
+}
+/**
+ * `POST /api/host/tray/items` 的请求：**覆盖一项**的文案 / 图标 / 关闭键。
+ *
+ * 形状就是 `id` 加上 {@link WireTrayItemOverride} 那五格 —— 「哪些字段能覆盖」只有
+ * 一份定义，改的时候两边一起改。
+ *
+ * ⚠️ **一个覆盖字段都不给是 400**：那一发什么都不变，却会把这一项记进覆盖表里
+ * （而它和配置一模一样），屏幕上看着正常、宿主自己却读回一份没意义的表。想撤掉
+ * 覆盖用 `DELETE`，想写值就给到具体的格。
+ */
+interface WireHostTrayItemRequest extends WireTrayItemOverride {
+    /** 托盘项的 `id`，非空字符串。**不对配置**（同 `WireHostTrayRequest.id`） */
+    id: string;
+}
+
 /**
  * Wire 契约 —— 浏览器与本地服务之间那根线上的形状。
  *
@@ -8258,6 +8670,20 @@ type WireHubEvent =
     type: 'host-badges';
     dots: string[];
 }
+/**
+ * **宿主托盘项的两张运行期表**（2026-11-04）—— 哪几项选中（`active`），以及每一项
+ * 此刻被覆盖成什么样（`items`）。**整张表**，形状、三条投递路径、以及「为什么这两张表
+ * 一起走」全在 [wire-host-tray.ts](./wire-host-tray.ts) 的文件头。
+ *
+ * ⚠️ **它有两种身份**（逐字同上一帧）：宿主改了一项 → 广播帧（进环形缓冲、占序号）；
+ * 每一条连接刚接上 → **连接级帧**（`seq: 0`，排在 `connected` 和补帧之后）。
+ * 两种都**没有 `sessionId`**（进程级）—— 托盘是这张页的一件事，不是某段会话的。
+ */
+ | {
+    type: 'host-tray';
+    active: string[];
+    items?: Record<string, WireTrayItemOverride>;
+}
 /**
  * 这一轮的用户消息 —— **一轮开跑那一刻**广播（2026-10-10）。
  *
@@ -9545,6 +9971,18 @@ interface WireConfigResponse {
      * 这一层照旧把整份清单原样带下去 —— 自己画前端的宿主按自己的排版决定画几枚。
      */
     topbarMenu?: readonly SidebarMenuItem[];
+    /**
+     * 宿主自定义的**托盘左端**（2026-11-04）—— `EpochConfig.trayMenuLeft` 原样转发，
+     * 没配就没有这个键。
+     *
+     * ⚠️ **它只回答「这一项长什么样」**：此刻选没选中在 {@link hostTray} 里，它是运行期
+     * 状态、不是配置（判据在 [wire-host-tray.ts](./wire-host-tray.ts) 文件头）。
+     */
+    trayMenuLeft?: readonly TrayMenuItem[];
+    /**
+     * 宿主自定义的**托盘右端**（2026-11-04）—— 逐字同 {@link trayMenuLeft}，两者互不兜底。
+     */
+    trayMenuRight?: readonly TrayMenuItem[];
     /**
      * 首屏那一刻**亮着点**的那几项（2026-10-15）—— **一个都没亮就没有这个键**。
      *
@@ -9553,6 +9991,17 @@ interface WireConfigResponse {
      * [wire-host-badges.ts](./wire-host-badges.ts) 的文件头。
      */
     hostBadges?: WireHostBadges;
+    /**
+     * 首屏那一刻**托盘那两张运行期表**（2026-11-04）—— **两张都空就没有这个键**。
+     *
+     * 它只管「流还没接上」那一小段：流一接上，服务端就在那条流上补一帧当前的整张表
+     * （连接级 `host-tray`），从那以后以流为准。判据全文在
+     * [wire-host-tray.ts](./wire-host-tray.ts) 的文件头。
+     *
+     * ⚠️ **判据是「两张都空」，不是「没选中」**：只有覆盖、一项都没选中时也得带这个键
+     * —— 不带的话首屏先画配置那份，等流接上才变成覆盖后的样子（闪一下）。
+     */
+    hostTray?: WireHostTray;
     /**
      * 宿主自定义的那几张开场卡片 —— **宿主没配就没有这个键**（2026-09-04）。
      *
@@ -10608,7 +11057,10 @@ interface WirePatchSessionRequest {
      *
      * 归档说的是「**列不列**这段会话」（默认列表不列归档的），置顶说的是
      * 「**排哪儿**」（排在它自己所属那一组的最前，判据在 web 的 `groupSessions`
-     * 上）。所以这两个键可以同时出现在一次请求里，一段会话也可以同时是置顶的、
+     * 上）。⚠️ **2026-11-04 起浏览器侧那几档更细**：块内是「置顶 → 进行中 →
+     * 最近活动倒序」，而服务端只排「置顶 → `live` → 时间」。差的那几档
+     * （进行中那批内部按 `turnStartedAt` 排、`live` 不参与）只有客户端算得出来；
+     * **当前打开的那一段不参与排序** —— 点开一段会话不该让它在屏幕上跳一下。所以这两个键可以同时出现在一次请求里，一段会话也可以同时是置顶的、
      * 归档的 —— 那组合在界面上是合理的（用户在归档列表里同样要把它排最前）。
      *
      * ⚠️ **置顶不是「激活」，它不推进 `updatedAt`。** 判据在 runtime 的
@@ -12531,6 +12983,42 @@ interface WireTeamResponse {
     tasks: readonly TeamTask[];
 }
 declare const WIRE_TEAM_FIELDS: WireFields<WireTeamResponse>;
+/** `POST /api/workspaces/reveal` 的请求体 */
+interface WireRevealWorkspaceRequest {
+    /**
+     * 要打开的那个目录（服务端绝对路径，逐字取自侧栏那一行）。
+     *
+     * ⚠️ **服务端必须校验它**：只接受「已知工作区」清单里的某一行，或者会话列表里
+     * 某个 `bound` 的 `root`。不校验的话，这一条就等于「随便 POST 一个路径就在用户
+     * 屏幕上弹一个窗口」—— 形状和 `trust-request` 那道校验逐字同一个判据。
+     */
+    root: string;
+}
+declare const WIRE_REVEAL_WORKSPACE_FIELDS: WireFields<WireRevealWorkspaceRequest>;
+/**
+ * 打开失败了，为什么。
+ *
+ * ⚠️ **没有 `not-same-machine` 这一档**：同机闸那一下回的是 HTTP 403
+ * （`sendError`），和 `file-open` / `pick` 那两条一个形状 —— 闸那一档是「这条路你
+ * 不该走」，不写进响应体。
+ */
+type WireRevealWorkspaceRefusal = 
+/** 这个路径不是服务端认识的任何工作区根 */
+'unknown-root'
+/** 服务端认识它，但它现在不在了（或者不再是个目录） */
+ | 'missing'
+/** 闸门全过了，但那个 `spawn` 没起来（或者这个平台没有实现） */
+ | 'launch-failed';
+/** `POST /api/workspaces/reveal` 的响应体 */
+interface WireRevealWorkspaceResponse {
+    /** 起起来了没有。**它只说「命令发出去了」**，不说那个窗口真的画出来了 */
+    ok: boolean;
+    /** 没起来的理由。`ok` 为 true 时不出现 */
+    refusal?: WireRevealWorkspaceRefusal;
+    /** 那句给用户看的话（服务端按 `?lang=` 渲染好）。`ok` 为 true 时不出现 */
+    message?: string;
+}
+declare const WIRE_REVEAL_WORKSPACE_RESPONSE_FIELDS: WireFields<WireRevealWorkspaceResponse>;
 
 /**
  * 一个角色在网线上的样子。
@@ -13514,7 +14002,7 @@ declare const WIRE_ROLE_ADD_RESPONSE_FIELDS: WireFields<WireRoleAddResponse>;
  * | ------------- | -------------------------------------- | ------------------------------------- |
  * | `missing`     | 请求里没给名字                         | （界面不该发出这一发，见下）          |
  * | `not-found`   | 角色表里没有这个名字                   | 刷新这一栏再看，多半已经没了          |
- * | `not-user`    | 它来自内置 / 项目 / 插件 / 宿主        | 那句话里点名了是哪一层，各有各的删法  |
+ * | `not-user`    | 它来自项目 / 插件 / 宿主（不是用户级）  | 那句话里点名了是哪一层，各有各的删法  |
  * | `ambiguous`   | 目录里两份以上都叫这个名字             | 去那个目录里留下要的那一份            |
  * | `failed`      | 真的删不动（权限 / 只读盘）            | 去那条路径那儿看一眼                  |
  *
@@ -13561,17 +14049,20 @@ interface WireRoleRemoveResponse {
      *
      * ## ⚠️ 这一格答的是「那一行会不会消失」，而答案常常是「不会」
      *
-     * 用户级那一份可能是一个**同名覆盖**（手写一份 `general.md` 就是，
-     * `mergeRoles` 的同名语义是「prompt / description 整份替换、工具取交集」）。
-     * 删掉它之后下层那一份**浮上来**：能力页刷新出来，那一行**还在**，只是挪去了
-     * 「内置」那一组、描述和工具都变了。
+     * 「浮上来」需要接管者排在用户级**前面**（合并顺序是 user → project，后来者赢）：
+     * 今天那只能是 plugin / host（名字一定带 `<前缀>:`，撞不上手写的那份）或已删的
+     * `builtin` —— 所以 **2026-11-05 之后正常输入下这一格恒为 `null`**。
+     * 用户级盖住项目级这个方向不成立：项目级本来就在上面，那一行的 `source`
+     * 直接就是 `project`，删除会先拿到 `not-user`。
      *
      * 少了这一格，那一屏对用户说的是「已经删掉 x」而列表里 x 还在 —— 一次成功的
-     * 删除长成了一次失败的删除，而屏幕上没有任何地方解释得了。
+     * 删除长成了一次失败的删除，而屏幕上没有任何地方解释得了。机制留着：
+     * 它是公开契约，且将来真出现一个排在用户级前面的无前缀来源时仍然是对的。
      *
-     * 非 `null` 时它是**接管者那一层**（`builtin` / `project` / `plugin` / `host`），
+     * 非 `null` 时它是**接管者那一层**（现实中是 `project` / `plugin` / `host`）。
      * 界面据此多印一句。⚠️ 它**不可能**是 `'user'`：用户级那一份刚被删掉，
      * 而同一个目录里还有第二份同名的话，上面那道 `ambiguous` 已经把这一发拦掉了。
+     * 类型上还有 `'builtin'`，但 2026-11-05 起没有内置角色了，这一档不会出现。
      */
     takenOverBy: AgentRoleSource | null;
     /**
@@ -18590,6 +19081,28 @@ interface WireScheduleRunResponse {
     detail?: string;
 }
 declare const WIRE_SCHEDULE_RUN_FIELDS: WireFields<WireScheduleRunResponse>;
+/**
+ * `POST /api/schedules/:id/cancel` —— 终止正在跑的那一次（2026-11-04）。
+ *
+ * ## 两种送达方式，区别在于「那一发跑在哪个进程里」
+ *
+ * - `aborted`：跑在**服务进程自己**（手点「先跑一次」那一路），当场把 signal
+ *   递进去，下一拍就生效；
+ * - `requested`：跑在**另一个进程**（OS 调度器 / 宿主 headless 起的执行器），
+ *   服务进程够不到它 —— 只能往锁表写一个取消标记，执行器在事件流里看见才停。
+ *   它因此**不是「已经停了」**，界面上那句是「正在停止…」。
+ *
+ * ⚠️ **`ok: false` 只有一种：`no-active-run`。** 这条路上没有活着的锁，说明
+ * 那一次已经跑完了（或者根本没有跑）—— 那时**不许假装成功**：界面要据此知道
+ * 自己刚才看到的那枚转子是过期的。
+ */
+type WireScheduleCancelResponse = {
+    ok: true;
+    mode: 'aborted' | 'requested';
+} | {
+    ok: false;
+    reason: 'no-active-run';
+};
 /**
  * `POST /api/schedules/:id/fix` —— 把这一轮的欠条追加进任务的授权清单。
  *
@@ -18697,6 +19210,14 @@ interface WireRunningSchedule {
     scheduleId: string;
     /** 抢到锁那一刻（epoch 毫秒）。界面上那个走秒的数拿它减出来 */
     startedAt: number;
+    /**
+     * 有人点了「终止」，执行器还没看见（2026-11-04）。`undefined` = 没请求过。
+     *
+     * ⚠️ **有值不等于已经停了。** 协作式取消要等执行器下一次事件循环才生效，
+     * 而那一刻可能正卡在一条长命令上。界面那句是「正在停止…」，转子照画。
+     * 它是 `listRunningSchedules` 原样带过来的——不在服务端另算一个。
+     */
+    cancelRequestedAt?: number;
 }
 declare const WIRE_RUNNING_SCHEDULE_FIELDS: WireFields<WireRunningSchedule>;
 /**
@@ -19496,4 +20017,4 @@ declare const SECRET_SERVICE = "epoch-agent";
  */
 declare const MCP_DATA_KEY_NAME = "mcp-auth-data-key";
 
-export { ACTION_CONTEXTS, AGENT_MESSAGE_NOTE_TITLE, AGENT_ROLE_NAME_PATTERN, API_KEY_ENV_VARS, APPEARANCE_ACCENTS, APPEARANCE_BACKGROUND_FITS, APPEARANCE_BACKGROUND_KINDS, APPEARANCE_BACKGROUND_ON_PARAM, APPEARANCE_CODE_FONTS, APPEARANCE_CODE_FONT_SIZE, APPEARANCE_CONTRAST, APPEARANCE_DEFAULT_CODE_FONT_SIZE, APPEARANCE_DEFAULT_FONT_SIZE, APPEARANCE_DIFF_TREE_WIDTH, APPEARANCE_FIRST_SCREEN_FIELDS, APPEARANCE_FIRST_SCREEN_FIELD_ORDER, APPEARANCE_FONT_SIZE, APPEARANCE_LANGS, APPEARANCE_MOTION, APPEARANCE_ROOT_ATTRIBUTES, APPEARANCE_SIDEBAR_WIDTH, APPEARANCE_THEMES, APPEARANCE_THEME_NAME_MAX, APPEARANCE_TRANSLUCENT, APPEARANCE_UI_FONTS, APPROVAL_OUTCOMES, APPROVAL_POLICIES, type ActiveAgentRole, type AgentEvent, type AgentEventOf, type AgentEventType, type AgentMemberInfo, type AgentMemberStatus, type AgentMessage, type AgentRole, type AgentRoleScope, type AgentRoleSource, type AppearanceAccent, type AppearanceAccentValue, type AppearanceBackground, type AppearanceBackgroundFit, type AppearanceBackgroundKind, type AppearanceCodeFont, type AppearanceEffectiveTheme, type AppearanceFirstScreenField, type AppearanceFirstScreenKind, type AppearanceLang, type AppearanceModePatch, type AppearanceMotion, type AppearanceTheme, type AppearanceUiFont, type AppearanceVisualSource, type ApprovalAnswer, type ApprovalOutcome, type ApprovalPolicy, type ApprovalReply, type ApprovalRequest, type ApprovalScope, type ArtifactKind, type AttributeValue, type Attributes, BRAND_WHEN_SIDEBAR_COLLAPSED, type BackgroundTaskInfo, type BackgroundTaskKind, type BackgroundTaskStatus, type BlankCard, type BlankGreeting, type BoardChannel, type BoardPost, type BoardThread, type BoundKey, type BrandWhenSidebarCollapsed, type BudgetBreach, COMMAND_NAME_PATTERN, COMPLIANCE_ACTIONS, COMPLIANCE_CATEGORIES, CURRENCIES, type Catalogs, type ComplianceAction, type ComplianceCategory, type ContextBreakdown, type ContextCacheStats, type ContextNote, type ContextSegment, type ContextSegmentKind, type Currency, type CurrencyDisplay, type CustomCommandDef, type CustomCommandSource, DEFAULT_AGENT_ROLE, DEFAULT_LANG, DEFAULT_PERMISSION_LEVEL, type DecidedTrustLevel, type Diagnostic, DiagnosticSink, type DiagnosticStatus, ENTRY_REF_PREFIX, ENTRY_SECRET_PREFIX, type EpochConfig, type EpochContentPart, type EpochDiffSnapshot, type EpochFilePart, type EpochHook, type EpochImagePart, type EpochMessage, type EpochMessageRole, type EpochPlugin, type EpochSessionPart, type EpochSkill, type EpochTextPart, type EpochTool, type EpochToolCall, type EpochToolResult, type EpochTurnFacts, type EpochUserCommand, type EpochUserContent, type ExpandedCommand, FOLLOW_SYSTEM, type FileOmitReason, type FinishReason, type FixableApproval, type FlatCatalog, type FormatMoneyOptions, GEN_AI, HEADLESS_INPUT_EVENT_TYPES, HEADLESS_INPUT_FORMATS, HEADLESS_OUTPUT_FORMATS, HEADLESS_PROTOCOL_VERSION, type HeadlessEnvelope, type HeadlessEvent, type HeadlessInit, type HeadlessInputEvent, type HeadlessInputEventType, type HeadlessInputFormat, type HeadlessLifecycleEvent, type HeadlessOutputFormat, type HeadlessResult, type HeadlessResultReason, type HookContext, type HookEvent, type HookHandler, type HookManager, type HookRegistration, type HookType, type HostText, type HostUser, type Hsv, type JsonSchema, KEY_ACTIONS, type KeyAction, type KeyChord, type KeyContext, type KeySequence, type KeybindingReport, type KeybindingSource, type KeybindingTable, LANGS, LEAD_AGENT_ID, LEGACY_LEVEL_ALIASES, LINK_CLICKED_MESSAGE_TYPE, type Lang, type LinkClickedMessage, type LocalizedDetail, type LogFn, MAX_ATTACH_BYTES, MAX_ATTACH_FILES, MAX_ATTACH_TOTAL_BYTES, MAX_HEADER_CHARS, MAX_LINK_URL, MAX_OPTIONS, MAX_QUESTIONS, MAX_SESSION_ATTACH_BYTES, MAX_SESSION_REFS, MCP_DATA_KEY_NAME, METRIC, MIN_OPTIONS, MODEL_ENTRY_PROTOCOLS, type MentionSet, type ModelEntry, type ModelEntryCapabilities, type ModelEntryProtocol, type ModelRef, type ModelSelection, type ModelSelectionOrigin, type MoneyDigits, NOOP_TELEMETRY, type NoticeCode, OFFLOADED_IMAGE_NOTE, OPENABLE_LINK_SCHEMES, OPEN_SETTINGS_MESSAGE_TYPE, OPERATION_TYPES, OVERSIZE_RATIO, type OpenSettingsMessage, type Operation, type OperationType, PERMISSION_LEVELS, PLAN_OUTCOMES, PLUGIN_CATEGORY_DISPLAY_SEP, PLUGIN_MENU_MESSAGE_TYPE, PLUGIN_PREVIEW_STREAM_MIME, PLUGIN_UPLOAD_MULTI_SEP, PROVIDER_INFOS, PROVIDER_TYPES, type PermissionDecision, type PermissionLevel, type PermissionManager, type PermissionRuleLists, type PlanApprovalOutcome, type PlanProposal, type PluginContext, type PluginMenuMessage, type ProviderInfo, type ProviderType, type QuestionAnswer, type QuestionItem, type QuestionOption, type QuestionPage, type QuestionRequest, REASONING_EFFORTS, REASONING_OFF, RESERVED_CHORDS, RESERVED_COMMAND_NAMES, type ReasoningChoice, type ReasoningEffort, type ReasoningState, type RejectReason, type RejectedKey, type ResolvedAppearanceVisual, type RuleValue, SCHEDULE_CONFIRM_PLACEHOLDER, SCHEDULE_DEFAULT_PERMISSION, SCHEDULE_DRAFT_SAVED_MARK, SCHEDULE_DRAFT_TOOL, SCHEDULE_INTERVAL_MAX_MINUTES, SCHEDULE_INTERVAL_MIN_MINUTES, SCHEDULE_MAX_TIMES_PER_DAY, SCHEDULE_RUN_STATUSES, SEARCH_API_KEY_ENV, SEARCH_PROVIDER_TYPES, SECRET_SERVICE, SEQUENCE_CONTEXTS, SESSION_MENTION_PREFIX, SESSION_REFERENCE_ERROR_CODES, SETTINGS_PANE_IDS, SHELL_KINDS, SIDEBAR_MENU_MESSAGE_TYPE, SIMULTANEOUS_CONTEXTS, SYSTEM_NOTE_PREFIX, type SandboxMode, type ScheduleAllowlist, type ScheduleBackendKind, type ScheduleCronTrigger, type ScheduleCycle, type ScheduleDefinition, type ScheduleDraft, type ScheduleDraftAllowlist, type ScheduleDraftCreate, type ScheduleDraftPermission, type ScheduleDraftUpdate, type SchedulePendingApproval, type SchedulePendingItem, type ScheduleRun, type ScheduleRunStatus, type ScheduleRunnerSpec, type ScheduleTrigger, type ScheduleTriggerKind, type ScheduleWeekday, type ScheduleWideningKind, type SearchProviderType, type SecretBackendId, type SecretStore, type SelectionContext, type SelectionRejection, type SelectionWarning, type SessionAttachKind, type SessionAttachResult, type SessionOmitReason, type SessionSurfaceMessage, type SessionSurfaceView, type SetSelectionResult, type SettingsPaneId, type SettingsPaneItem, type ShellKind, type SidebarMenuItem, type SidebarMenuMessage, type SidebarNavItem, type SpanLike, type SubToolCall, type SubToolCallResult, type TeamTask, type TeamTaskPatch, type TeamTaskStatus, type Telemetry, type TokenUsage, type ToolAnnotations, type ToolArtifact, type ToolArtifactInput, type ToolContext, type ToolDefinition, ToolExposure, type ToolProvider, type ToolResult, type Translate, type TranslateVars, type TrustExecGrant, type TrustGrant, type TrustLevel, type TrustManager, type TrustRecord, type TrustScope, type TrustTier, UNLIMITED_TURNS, USER_MENU_MESSAGE_TYPE, type UserMenuMessage, type VerifyResult, WIRE_ABORT_FIELDS, WIRE_ABOUT_FIELDS, WIRE_AGENT_ROLE_FIELDS, WIRE_APPEARANCE_RESPONSE_FIELDS, WIRE_APPROVAL_CACHE_REVOKE_REQUEST_FIELDS, WIRE_APPROVAL_CACHE_REVOKE_RESPONSE_FIELDS, WIRE_APPROVAL_LIST_FIELDS, WIRE_APPROVAL_ROW_FIELDS, WIRE_ARTIFACTS_FIELDS, WIRE_ATTACHMENT_FOLDER_FIELDS, WIRE_ATTACHMENT_UPLOAD_FIELDS, WIRE_AUDIT_LOG_FIELDS, WIRE_AUDIT_ROW_FIELDS, WIRE_AUTH_COOKIE, WIRE_AUTH_COOKIE_ATTRS, WIRE_AUTH_TOKEN_PARAM, WIRE_BACKGROUND_TASK_FIELDS, WIRE_BLOCKED_GOALS_FIELDS, WIRE_BLOCKED_GOAL_FIELDS, WIRE_BLOCKED_LEVEL_FIELDS, WIRE_BUILTIN_CONNECTOR_FIELDS, WIRE_CACHED_APPROVAL_FIELDS, WIRE_CAPABILITIES_FIELDS, WIRE_CAPABILITY_PROJECT_FIELDS, WIRE_CHECKPOINT_LIST_FIELDS, WIRE_CHECKPOINT_SUMMARY_FIELDS, WIRE_COMMANDS_FIELDS, WIRE_COMMAND_EXPANSION_FIELDS, WIRE_COMPACT_FIELDS, WIRE_COMPRESSION_LINE_FIELDS, WIRE_CONFIG_FIELDS, WIRE_CONTEXT_FIELDS, WIRE_CREATE_SESSION_FIELDS, WIRE_CREATE_WORKSPACE_FIELDS, WIRE_CREATE_WORKSPACE_RESPONSE_FIELDS, WIRE_CUSTOM_COMMAND_FIELDS, WIRE_DELETE_SESSION_FIELDS, WIRE_DIFF_FILE_FIELDS, WIRE_DIFF_FILE_RESPONSE_FIELDS, WIRE_ERROR_FIELDS, WIRE_FILE_CANDIDATES_FIELDS, WIRE_FILE_CANDIDATE_FIELDS, WIRE_FILE_CHANGE_FIELDS, WIRE_FILE_OPEN_RESPONSE_FIELDS, WIRE_FILE_REFERENCE_FIELDS, WIRE_FILE_STAT_MAX, WIRE_FILE_STAT_OK_FIELDS, WIRE_FILE_STAT_REFUSED_FIELDS, WIRE_FILE_STAT_RESPONSE_FIELDS, WIRE_FILE_TEXT_RESPONSE_FIELDS, WIRE_FORGET_WORKSPACE_FIELDS, WIRE_FORGET_WORKSPACE_RESPONSE_FIELDS, WIRE_GOAL_ACTIONS, WIRE_GOAL_BLOCK_FIELDS, WIRE_GOAL_CLEAR_FIELDS, WIRE_GOAL_CREATE_FIELDS, WIRE_GOAL_FIELDS, WIRE_GOAL_LIMITS_FIELDS, WIRE_GOAL_PHASES, WIRE_GOAL_REFUSALS, WIRE_GOAL_RESPONSE_FIELDS, WIRE_GOAL_WRITE_FIELDS, WIRE_HEALTH_FIELDS, WIRE_IMAGE_REFERENCE_FIELDS, WIRE_KNOWN_WORKSPACE_FIELDS, WIRE_LANG_PARAM, WIRE_LAST_SESSION_FIELDS, WIRE_LAST_SESSION_RESPONSE_FIELDS, WIRE_MANAGED_LOCK_FIELDS, WIRE_MCP_ADD_FIELDS, WIRE_MCP_ADD_RESPONSE_FIELDS, WIRE_MCP_APPLY_ENTRY_FIELDS, WIRE_MCP_APPLY_RESPONSE_FIELDS, WIRE_MCP_CONFIG_APPLY_FIELDS, WIRE_MCP_CONFIG_FIELDS, WIRE_MCP_CONFIG_ISSUE_FIELDS, WIRE_MCP_CONFIG_SAVE_FIELDS, WIRE_MCP_CONFIG_SAVE_RESPONSE_FIELDS, WIRE_MCP_CONNECTOR_FIELDS, WIRE_MCP_RECONNECT_FIELDS, WIRE_MESSAGE_LIST_FIELDS, WIRE_MODEL_ENTRIES_FIELDS, WIRE_MODEL_ENTRY_MODELS_FIELDS, WIRE_MODEL_ENTRY_SAVE_FIELDS, WIRE_MODEL_ENTRY_TEST_FIELDS, WIRE_MODEL_FIELDS, WIRE_MODEL_SELECTION_FIELDS, WIRE_MODEL_SET_FIELDS, WIRE_PATCH_SESSION_FIELDS, WIRE_PATCH_SESSION_RESPONSE_FIELDS, WIRE_PERMISSION_RULE_FIELDS, WIRE_PERMISSION_SET_REQUEST_FIELDS, WIRE_PERMISSION_SET_RESPONSE_FIELDS, WIRE_PERMISSION_SHADOW_FIELDS, WIRE_PERMISSION_STATE_FIELDS, WIRE_PERMISSION_STATUS_FIELDS, WIRE_PLAN_ACTIONS, WIRE_PLAN_FIELDS, WIRE_PLAN_MODE_REQUEST_FIELDS, WIRE_PLAN_MODE_RESPONSE_FIELDS, WIRE_PLAN_MODE_STATE_FIELDS, WIRE_PLUGINS_FIELDS, WIRE_PLUGIN_ACTION_FIELDS, WIRE_PLUGIN_ARCHIVE_SUFFIXES, WIRE_PLUGIN_INSTALL_FIELDS, WIRE_PLUGIN_LOCAL_FIELDS, WIRE_PLUGIN_LOCAL_INSTALL_FIELDS, WIRE_PLUGIN_MARKETPLACE_FIELDS, WIRE_PLUGIN_MARKETPLACE_RESPONSE_FIELDS, WIRE_PLUGIN_NAME_FIELDS, WIRE_PLUGIN_PREVIEW_FIELDS, WIRE_PLUGIN_PREVIEW_RESPONSE_FIELDS, WIRE_PLUGIN_REFRESH_RESPONSE_FIELDS, WIRE_PLUGIN_STAGE_FIELDS, WIRE_PLUGIN_STAGE_RESPONSE_FIELDS, WIRE_PLUGIN_TOGGLE_FIELDS, WIRE_PLUGIN_UPDATE_FIELDS, WIRE_PLUGIN_UPLOAD_CONFIRM_FIELDS, WIRE_PLUGIN_UPLOAD_FIELDS, WIRE_PLUGIN_UPLOAD_FORM_FIELDS, WIRE_PLUGIN_UPLOAD_PREVIEW_RESPONSE_FIELDS, WIRE_PLUGIN_UPLOAD_RESPONSE_FIELDS, WIRE_PLUGIN_VIEW_FIELDS, WIRE_PLUGIN_VIEW_RESPONSE_FIELDS, WIRE_POLICY_DIR_FIELDS, WIRE_POLICY_STATUS_FIELDS, WIRE_PROJECT_INVENTORY_FIELDS, WIRE_PROVIDER_GROUPS, WIRE_QUESTION_LIST_FIELDS, WIRE_QUESTION_ROW_FIELDS, WIRE_RESPOND_APPROVAL_FIELDS, WIRE_RESPOND_APPROVAL_RESPONSE_FIELDS, WIRE_RESPOND_QUESTION_FIELDS, WIRE_RESPOND_QUESTION_RESPONSE_FIELDS, WIRE_REVIVE_FIELDS, WIRE_REWIND_FILE_PLAN_FIELDS, WIRE_REWIND_OUTCOME_FIELDS, WIRE_REWIND_PREVIEW_FIELDS, WIRE_REWIND_REQUEST_FIELDS, WIRE_REWIND_RESPONSE_FIELDS, WIRE_REWIND_SCOPES, WIRE_ROLES_FIELDS, WIRE_ROLE_ADD_FIELDS, WIRE_ROLE_ADD_RESPONSE_FIELDS, WIRE_ROLE_REMOVE_FIELDS, WIRE_RUNNING_SCHEDULE_FIELDS, WIRE_SANDBOX_STATUS_FIELDS, WIRE_SCHEDULE_CAPABILITY_FIELDS, WIRE_SCHEDULE_CREATE_FIELDS, WIRE_SCHEDULE_DEFAULTS_FIELDS, WIRE_SCHEDULE_DELETE_FIELDS, WIRE_SCHEDULE_FIELDS, WIRE_SCHEDULE_FIX_FIELDS, WIRE_SCHEDULE_FIX_REQUEST_FIELDS, WIRE_SCHEDULE_ISSUE_CODES, WIRE_SCHEDULE_LIST_FIELDS, WIRE_SCHEDULE_PENDING_FIELDS, WIRE_SCHEDULE_RECORDING_FIELDS, WIRE_SCHEDULE_ROW_FIELDS, WIRE_SCHEDULE_RUNNING_FIELDS, WIRE_SCHEDULE_RUNS_FIELDS, WIRE_SCHEDULE_RUN_FIELDS, WIRE_SCHEDULE_SAVE_FIELDS, WIRE_SECURITY_FIELDS, WIRE_SECURITY_WORKSPACE_FIELDS, WIRE_SEND_MESSAGE_FIELDS, WIRE_SEND_MESSAGE_RESPONSE_FIELDS, WIRE_SESSION_BRANCH_RESPONSE_FIELDS, WIRE_SESSION_CANDIDATES_FIELDS, WIRE_SESSION_CANDIDATE_FIELDS, WIRE_SESSION_FINISH_FIELDS, WIRE_SESSION_LIST_FIELDS, WIRE_SESSION_REFERENCE_FIELDS, WIRE_SESSION_RESPONSE_FIELDS, WIRE_SESSION_SUMMARY_FIELDS, WIRE_SESSION_WORKSPACE_FIELDS, WIRE_SESSION_WORKSPACE_RESPONSE_FIELDS, WIRE_SETTINGS_FIELDS, WIRE_SETTINGS_WRITE_FIELDS, WIRE_SETTINGS_WRITE_REQUEST_FIELDS, WIRE_SETTING_PENDING_FIELDS, WIRE_SETTING_ROW_FIELDS, WIRE_SETTING_STEP_FIELDS, WIRE_SETTING_WRITE_FIELDS, WIRE_SETTING_WRITE_LAYERS, WIRE_SKILL_BODY_FIELDS, WIRE_SKILL_DROP_SUFFIXES, WIRE_SKILL_FIELDS, WIRE_SKILL_IMPORT_FIELDS, WIRE_SKILL_IMPORT_PREVIEW_FIELDS, WIRE_SKILL_REMOVE_FIELDS, WIRE_SKILL_STAGE_FIELDS, WIRE_TASKS_FIELDS, WIRE_TEAM_FIELDS, WIRE_TOOLS_FIELDS, WIRE_TOOL_GATE_FIELDS, WIRE_TOOL_ROW_FIELDS, WIRE_TRUST_REQUEST_FIELDS, WIRE_TRUST_REQUEST_RESPONSE_FIELDS, WIRE_WITHDRAW_MESSAGE_FIELDS, WIRE_WORKSPACE_DIFF_FIELDS, WIRE_WORKSPACE_DIRS_FIELDS, WIRE_WORKSPACE_DIR_ENTRY_FIELDS, WIRE_WORKSPACE_REF_FIELDS, type WireAbortResponse, type WireAbout, type WireAgentEnvelope, type WireAgentEvent, type WireAgentRoleSummary, type WireAppearanceRequest, type WireAppearanceResponse, type WireApprovalCacheRevokeRequest, type WireApprovalCacheRevokeResponse, type WireApprovalListResponse, type WireApprovalRequest, type WireArtifactsResponse, type WireAttachmentFolderResponse, type WireAttachmentUploadResponse, type WireAuditCode, type WireAuditLog, type WireAuditOutcome, type WireAuditRow, type WireAuthDenyReason, type WireAuthDenyStatus, type WireAuthGuard, type WireAuthRequestView, type WireAuthVerdict, type WireBackgroundTask, type WireBindWorkspaceRequest, type WireBlockedGoal, type WireBlockedGoalsResponse, type WireBlockedLevel, type WireBuiltinConnector, type WireCachedApproval, type WireCachedDecision, type WireCapabilitiesResponse, type WireCapabilityProject, type WireCheckpointListResponse, type WireCheckpointSummary, type WireCommandExpansion, type WireCommandsResponse, type WireCompactRequest, type WireCompactResponse, type WireCompressionLine, type WireConfigResponse, type WireContextResponse, type WireCreateSessionRequest, type WireCreateSessionResponse, type WireCreateWorkspaceRequest, type WireCreateWorkspaceResponse, type WireCustomCommand, type WireDeleteSessionResponse, type WireDiffFile, type WireDiffFileResponse, type WireDiffNote, type WireDiffOmitReason, type WireDiffSource, type WireDiffStatus, type WireEffectiveModel, type WireEffectiveSlots, type WireEntryProbeCode, type WireEntryProvider, type WireEnvelope, type WireErrorResponse, type WireEvent, type WireFields, type WireFileCandidate, type WireFileCandidatesResponse, type WireFileChange, type WireFileKind, type WireFileOpenRefusal, type WireFileOpenResponse, type WireFileReference, type WireFileRefusal, type WireFileStat, type WireFileStatOk, type WireFileStatRefused, type WireFileStatResponse, type WireFileTextResponse, type WireFixture, type WireFixtureCase, type WireForgetWorkspaceRequest, type WireForgetWorkspaceResponse, type WireGoal, type WireGoalBlock, type WireGoalClearResponse, type WireGoalCreateRequest, type WireGoalLimits, type WireGoalPhase, type WireGoalRefusal, type WireGoalResponse, type WireGoalUpdateRequest, type WireGoalWriteResponse, type WireHealthResponse, type WireHostBadgeRequest, type WireHostBadges, type WireHostCompose, type WireHostComposeRequest, type WireHostComposeResponse, type WireHostComposeStateResponse, type WireHostComposeTakeResponse, type WireHubEnvelope, type WireHubEvent, type WireImageReference, type WireKnownWorkspace, type WireKnownWorkspaceRef, type WireLastSessionRequest, type WireLastSessionResponse, type WireManagedLock, type WireMcpAddRequest, type WireMcpAddResponse, type WireMcpApplyAction, type WireMcpApplyEntry, type WireMcpApplyResponse, type WireMcpConfigApplyRequest, type WireMcpConfigIssue, type WireMcpConfigResponse, type WireMcpConfigSaveRequest, type WireMcpConfigSaveResponse, type WireMcpConnector, type WireMcpReconnectResponse, type WireMessageListResponse, type WireModelCaveat, type WireModelEffortRequest, type WireModelEffortResponse, type WireModelEntriesResponse, type WireModelEntry, type WireModelEntryModelsResponse, type WireModelEntryProbeRequest, type WireModelEntryRefRequest, type WireModelEntryRefs, type WireModelEntrySaveRequest, type WireModelEntrySaveResponse, type WireModelEntryTestResponse, type WireModelRejection, type WireModelResponse, type WireModelSelection, type WireModelSetRequest, type WireModelSetResponse, type WirePatchSessionRequest, type WirePatchSessionResponse, type WirePermissionRememberFailure, type WirePermissionRuleRow, type WirePermissionSetRequest, type WirePermissionSetResponse, type WirePermissionShadow, type WirePermissionState, type WirePermissionStatus, type WirePickDirectoryResponse, type WirePlanAction, type WirePlanModeRequest, type WirePlanModeResponse, type WirePlanModeState, type WirePlanResponse, type WirePluginActionResponse, type WirePluginCategory, type WirePluginCounts, type WirePluginDependency, type WirePluginDependencyInventory, type WirePluginDependencyStatus, type WirePluginDoc, type WirePluginDocs, type WirePluginEntry, type WirePluginHit, type WirePluginHookTally, type WirePluginInstallRequest, type WirePluginLocalInstallRequest, type WirePluginLocalRequest, type WirePluginMarketplace, type WirePluginMarketplaceRequest, type WirePluginMarketplaceResponse, type WirePluginMenuItem, type WirePluginNameRequest, type WirePluginPanel, type WirePluginPreview, type WirePluginPreviewRequest, type WirePluginPreviewResponse, type WirePluginPreviewStreamLine, type WirePluginProgressStep, type WirePluginRefreshResponse, type WirePluginRefuseReason, type WirePluginSourceType, type WirePluginStageRequest, type WirePluginStageResponse, type WirePluginStatus, type WirePluginToggleRequest, type WirePluginUpdateRequest, type WirePluginUploadChoice, type WirePluginUploadConfirmRequest, type WirePluginUploadField, type WirePluginUploadFieldName, type WirePluginUploadFields, type WirePluginUploadFile, type WirePluginUploadForm, type WirePluginUploadPlan, type WirePluginUploadPreviewResponse, type WirePluginUploadRequest, type WirePluginUploadResponse, type WirePluginVersionUnmet, type WirePluginViewRequest, type WirePluginViewResponse, type WirePluginVisibility, type WirePluginsResponse, type WirePolicyDir, type WirePolicyStatus, type WireProjectInventory, type WireProviderGroup, type WireQuestionListResponse, type WireQuestionRequest, type WireReplayMessage, type WireResetReason, type WireRespondApprovalRequest, type WireRespondApprovalResponse, type WireRespondQuestionRequest, type WireRespondQuestionResponse, type WireReviveResponse, type WireRewindAction, type WireRewindDrift, type WireRewindFilePlan, type WireRewindOutcome, type WireRewindPreview, type WireRewindRequest, type WireRewindResponse, type WireRewindScope, type WireRoleAddRequest, type WireRoleAddResponse, type WireRoleRemoveFailure, type WireRoleRemoveResponse, type WireRolesResponse, type WireRunningSchedule, type WireSandboxReason, type WireSandboxStatus, type WireScheduleCapability, type WireScheduleCreateRequest, type WireScheduleDefaults, type WireScheduleDeleteResponse, type WireScheduleFixRequest, type WireScheduleFixResponse, type WireScheduleIssue, type WireScheduleIssueCode, type WireScheduleListResponse, type WireSchedulePendingResponse, type WireScheduleRecordingResponse, type WireScheduleRegisterRefusal, type WireScheduleRegisterWarning, type WireScheduleRegistration, type WireScheduleResponse, type WireScheduleRow, type WireScheduleRunResponse, type WireScheduleRunningResponse, type WireScheduleRunsResponse, type WireScheduleSaveResponse, type WireScheduleUpdateRequest, type WireSecurityResponse, type WireSecurityWorkspace, type WireSendMessageRequest, type WireSendMessageResponse, type WireSessionBranchResponse, type WireSessionCandidate, type WireSessionCandidatesResponse, type WireSessionFinish, type WireSessionListResponse, type WireSessionReference, type WireSessionResponse, type WireSessionSummary, type WireSessionWorkspace, type WireSessionWorkspaceResponse, type WireSettingApply, type WireSettingFutile, type WireSettingLayer, type WireSettingPending, type WireSettingRow, type WireSettingStep, type WireSettingValue, type WireSettingValueKind, type WireSettingWrite, type WireSettingWriteLayer, type WireSettingsResponse, type WireSettingsWriteRequest, type WireSettingsWriteResponse, type WireSkillBodyResponse, type WireSkillImportConflict, type WireSkillImportEntry, type WireSkillImportFailure, type WireSkillImportForm, type WireSkillImportIssue, type WireSkillImportPreviewResponse, type WireSkillImportResponse, type WireSkillRemoveFailure, type WireSkillRemoveResponse, type WireSkillStageFailure, type WireSkillStageResponse, type WireSkillSummary, type WireSummaryWorkspace, type WireTaggedEvent, type WireTasksResponse, type WireTeamResponse, type WireToolGate, type WireToolGateAxis, type WireToolRow, type WireToolSummary, type WireToolVerdict, type WireToolsResponse, type WireTrustRequestRequest, type WireTrustRequestResponse, type WireTurnState, type WireWithdrawMessageResponse, type WireWorkspaceBinding, type WireWorkspaceDiffResponse, type WireWorkspaceDirEntry, type WireWorkspaceDirsResponse, type WireWorkspaceRef, accentScale, agentMessageLine, apiKeyEnvVar, appearanceInlineVars, appearanceRootAttributes, appearanceVisualCss, approvalPolicyForLevel, assertNeverPart, assistantTurnText, attachSessionSurface, chordId, collectPendingApprovals, compressionThresholdTokens, conformsToWire, contentToText, cronTimes, diagnosticToLine, encodeAppearanceFirstScreenValue, entryDisplayName, entryRef, entrySecretName, extractAllMentions, extractMentions, extractSessionMentions, filePartSummary, fillPlaceholders, flattenCatalog, formatAppearanceTranslucent, formatMoney, getProviderInfo, hasFailure, hexToHsv, hsvToHex, imagePartOmittedSummary, isAppearanceAccent, isAppearanceAccentValue, isAppearanceBackground, isAppearanceBackgroundFit, isAppearanceBackgroundKind, isAppearanceCodeFont, isAppearanceCodeFontSize, isAppearanceContrast, isAppearanceDiffTreeWidth, isAppearanceFontSize, isAppearanceLang, isAppearanceModePatch, isAppearanceMotion, isAppearanceSidebarWidth, isAppearanceTheme, isAppearanceThemeName, isAppearanceTranslucent, isAppearanceUiFont, isApprovalOutcome, isContextNearlyFull, isCurrency, isEntrySecretName, isHeadlessInputFormat, isHeadlessLifecycleEvent, isHeadlessOutputFormat, isHexColor, isKeyAction, isLang, isMentionableFilePath, isModelEntryId, isOpenableLink, isOperationType, isPermissionLevel, isPlanOutcome, isPromptOversize, isProviderType, isQuestionAnswerMap, isReasoningEffort, isSearchProviderType, isSettingsPaneId, isValidAgentRoleName, isValidCommandName, isWireGoalPhase, isWireHubEvent, isWirePlanAction, isWirePluginArchiveName, isWireRewindScope, isWireSettingWriteLayer, isWireSkillDropName, joinUploadMulti, makeTranslate, mcpConnectorState, normalizeAppearanceTranslucent, normalizeApproval, offloadedImagePart, packSessionSurface, parseAppearanceTranslucentText, parseChord, parseModelRef, parseSequence, perAction, placeholdersOf, promptTokens, relativeLuminance, resolveAppearanceVisual, resolveHostText, resolvePermissionLevel, sequenceId, sessionPartSummary, sessionSenderLabel, snapAppearanceContrast, splitUploadMulti, stripSystemNote, systemNote, tableOf, totalUsageTokens, translatorFor, truncateToBudget, turnDigest, unfixedRules, utf8ByteLength, wireFields };
+export { ACTION_CONTEXTS, AGENT_MESSAGE_NOTE_TITLE, AGENT_ROLE_NAME_PATTERN, API_KEY_ENV_VARS, APPEARANCE_ACCENTS, APPEARANCE_BACKGROUND_FITS, APPEARANCE_BACKGROUND_KINDS, APPEARANCE_BACKGROUND_ON_PARAM, APPEARANCE_CODE_FONTS, APPEARANCE_CODE_FONT_SIZE, APPEARANCE_CONTRAST, APPEARANCE_DEFAULT_CODE_FONT_SIZE, APPEARANCE_DEFAULT_FONT_SIZE, APPEARANCE_DIFF_TREE_WIDTH, APPEARANCE_FIRST_SCREEN_FIELDS, APPEARANCE_FIRST_SCREEN_FIELD_ORDER, APPEARANCE_FONT_SIZE, APPEARANCE_LANGS, APPEARANCE_MOTION, APPEARANCE_ROOT_ATTRIBUTES, APPEARANCE_SIDEBAR_WIDTH, APPEARANCE_THEMES, APPEARANCE_THEME_NAME_MAX, APPEARANCE_TRANSLUCENT, APPEARANCE_UI_FONTS, APPROVAL_OUTCOMES, APPROVAL_POLICIES, type ActiveAgentRole, type AgentEvent, type AgentEventOf, type AgentEventType, type AgentMemberInfo, type AgentMemberStatus, type AgentMessage, type AgentRole, type AgentRoleScope, type AgentRoleSource, type AppearanceAccent, type AppearanceAccentValue, type AppearanceBackground, type AppearanceBackgroundFit, type AppearanceBackgroundKind, type AppearanceCodeFont, type AppearanceEffectiveTheme, type AppearanceFirstScreenField, type AppearanceFirstScreenKind, type AppearanceLang, type AppearanceModePatch, type AppearanceMotion, type AppearanceTheme, type AppearanceUiFont, type AppearanceVisualSource, type ApprovalAnswer, type ApprovalOutcome, type ApprovalPolicy, type ApprovalReply, type ApprovalRequest, type ApprovalScope, type ArtifactKind, type AttributeValue, type Attributes, BRAND_WHEN_SIDEBAR_COLLAPSED, type BackgroundTaskInfo, type BackgroundTaskKind, type BackgroundTaskStatus, type BlankCard, type BlankGreeting, type BoardChannel, type BoardPost, type BoardThread, type BoundKey, type BrandWhenSidebarCollapsed, type BudgetBreach, COMMAND_NAME_PATTERN, COMPLIANCE_ACTIONS, COMPLIANCE_CATEGORIES, CURRENCIES, type Catalogs, type ComplianceAction, type ComplianceCategory, type ContextBreakdown, type ContextCacheStats, type ContextNote, type ContextSegment, type ContextSegmentKind, type Currency, type CurrencyDisplay, type CustomCommandDef, type CustomCommandSource, DEFAULT_AGENT_ROLE, DEFAULT_LANG, DEFAULT_PERMISSION_LEVEL, type DecidedTrustLevel, type Diagnostic, DiagnosticSink, type DiagnosticStatus, ENTRY_REF_PREFIX, ENTRY_SECRET_PREFIX, type EpochConfig, type EpochContentPart, type EpochDiffSnapshot, type EpochFilePart, type EpochHook, type EpochImagePart, type EpochMessage, type EpochMessageRole, type EpochPlugin, type EpochSessionPart, type EpochSkill, type EpochTextPart, type EpochTool, type EpochToolCall, type EpochToolResult, type EpochTurnFacts, type EpochUserCommand, type EpochUserContent, type ExpandedCommand, FOLLOW_SYSTEM, type FileOmitReason, type FinishReason, type FixableApproval, type FlatCatalog, type FormatMoneyOptions, GEN_AI, HEADLESS_INPUT_EVENT_TYPES, HEADLESS_INPUT_FORMATS, HEADLESS_OUTPUT_FORMATS, HEADLESS_PROTOCOL_VERSION, type HeadlessEnvelope, type HeadlessEvent, type HeadlessInit, type HeadlessInputEvent, type HeadlessInputEventType, type HeadlessInputFormat, type HeadlessLifecycleEvent, type HeadlessOutputFormat, type HeadlessResult, type HeadlessResultReason, type HookContext, type HookEvent, type HookHandler, type HookManager, type HookRegistration, type HookType, type HostText, type HostUser, type Hsv, type JsonSchema, KEY_ACTIONS, type KeyAction, type KeyChord, type KeyContext, type KeySequence, type KeybindingReport, type KeybindingSource, type KeybindingTable, LANGS, LEAD_AGENT_ID, LEGACY_LEVEL_ALIASES, LINK_CLICKED_MESSAGE_TYPE, type Lang, type LinkClickedMessage, type LocalizedDetail, type LogFn, MAX_ATTACH_BYTES, MAX_ATTACH_FILES, MAX_ATTACH_TOTAL_BYTES, MAX_HEADER_CHARS, MAX_LINK_URL, MAX_OPTIONS, MAX_QUESTIONS, MAX_SESSION_ATTACH_BYTES, MAX_SESSION_REFS, MCP_DATA_KEY_NAME, METRIC, MIN_OPTIONS, MODEL_ENTRY_PROTOCOLS, type MentionSet, type ModelEntry, type ModelEntryCapabilities, type ModelEntryProtocol, type ModelRef, type ModelSelection, type ModelSelectionOrigin, type MoneyDigits, NOOP_TELEMETRY, type NoticeCode, OFFLOADED_IMAGE_NOTE, OPENABLE_LINK_SCHEMES, OPEN_SETTINGS_MESSAGE_TYPE, OPERATION_TYPES, OVERSIZE_RATIO, type OpenSettingsMessage, type Operation, type OperationType, PERMISSION_LEVELS, PLAN_OUTCOMES, PLUGIN_CATEGORY_DISPLAY_SEP, PLUGIN_MENU_MESSAGE_TYPE, PLUGIN_PREVIEW_STREAM_MIME, PLUGIN_UPLOAD_MULTI_SEP, PROVIDER_INFOS, PROVIDER_TYPES, type PermissionDecision, type PermissionLevel, type PermissionManager, type PermissionRuleLists, type PlanApprovalOutcome, type PlanProposal, type PluginContext, type PluginMenuMessage, type ProviderInfo, type ProviderType, type QuestionAnswer, type QuestionItem, type QuestionOption, type QuestionPage, type QuestionRequest, REASONING_EFFORTS, REASONING_OFF, RESERVED_CHORDS, RESERVED_COMMAND_NAMES, type ReasoningChoice, type ReasoningEffort, type ReasoningState, type RejectReason, type RejectedKey, type ResolvedAppearanceVisual, type RuleValue, SCHEDULE_CONFIRM_PLACEHOLDER, SCHEDULE_DEFAULT_PERMISSION, SCHEDULE_DRAFT_SAVED_MARK, SCHEDULE_DRAFT_TOOL, SCHEDULE_INTERVAL_MAX_MINUTES, SCHEDULE_INTERVAL_MIN_MINUTES, SCHEDULE_MAX_TIMES_PER_DAY, SCHEDULE_RUN_STATUSES, SEARCH_API_KEY_ENV, SEARCH_PROVIDER_TYPES, SECRET_SERVICE, SEQUENCE_CONTEXTS, SESSION_MENTION_PREFIX, SESSION_REFERENCE_ERROR_CODES, SETTINGS_PANE_IDS, SHELL_KINDS, SIDEBAR_MENU_MESSAGE_TYPE, SIMULTANEOUS_CONTEXTS, SYSTEM_NOTE_PREFIX, type SandboxMode, type ScheduleAllowlist, type ScheduleBackendKind, type ScheduleCronTrigger, type ScheduleCycle, type ScheduleDefinition, type ScheduleDraft, type ScheduleDraftAllowlist, type ScheduleDraftCreate, type ScheduleDraftPermission, type ScheduleDraftUpdate, type SchedulePendingApproval, type SchedulePendingItem, type ScheduleRun, type ScheduleRunStatus, type ScheduleRunnerSpec, type ScheduleTrigger, type ScheduleTriggerKind, type ScheduleWeekday, type ScheduleWideningKind, type SearchProviderType, type SecretBackendId, type SecretStore, type SelectionContext, type SelectionRejection, type SelectionWarning, type SessionAttachKind, type SessionAttachResult, type SessionOmitReason, type SessionSurfaceMessage, type SessionSurfaceView, type SetSelectionResult, type SettingsPaneId, type SettingsPaneItem, type ShellKind, type SidebarMenuItem, type SidebarMenuMessage, type SidebarNavItem, type SpanLike, type SubToolCall, type SubToolCallResult, type TeamTask, type TeamTaskPatch, type TeamTaskStatus, type Telemetry, type TokenUsage, type ToolAnnotations, type ToolArtifact, type ToolArtifactInput, type ToolContext, type ToolDefinition, ToolExposure, type ToolProvider, type ToolResult, type Translate, type TranslateVars, type TrayMenuItem, type TrayMenuMessage, type TrustExecGrant, type TrustGrant, type TrustLevel, type TrustManager, type TrustRecord, type TrustScope, type TrustTier, UNLIMITED_TURNS, USER_MENU_MESSAGE_TYPE, type UserMenuMessage, type VerifyResult, WIRE_ABORT_FIELDS, WIRE_ABOUT_FIELDS, WIRE_AGENT_ROLE_FIELDS, WIRE_APPEARANCE_RESPONSE_FIELDS, WIRE_APPROVAL_CACHE_REVOKE_REQUEST_FIELDS, WIRE_APPROVAL_CACHE_REVOKE_RESPONSE_FIELDS, WIRE_APPROVAL_LIST_FIELDS, WIRE_APPROVAL_ROW_FIELDS, WIRE_ARTIFACTS_FIELDS, WIRE_ATTACHMENT_FOLDER_FIELDS, WIRE_ATTACHMENT_UPLOAD_FIELDS, WIRE_AUDIT_LOG_FIELDS, WIRE_AUDIT_ROW_FIELDS, WIRE_AUTH_COOKIE, WIRE_AUTH_COOKIE_ATTRS, WIRE_AUTH_TOKEN_PARAM, WIRE_BACKGROUND_TASK_FIELDS, WIRE_BLOCKED_GOALS_FIELDS, WIRE_BLOCKED_GOAL_FIELDS, WIRE_BLOCKED_LEVEL_FIELDS, WIRE_BUILTIN_CONNECTOR_FIELDS, WIRE_CACHED_APPROVAL_FIELDS, WIRE_CAPABILITIES_FIELDS, WIRE_CAPABILITY_PROJECT_FIELDS, WIRE_CHECKPOINT_LIST_FIELDS, WIRE_CHECKPOINT_SUMMARY_FIELDS, WIRE_COMMANDS_FIELDS, WIRE_COMMAND_EXPANSION_FIELDS, WIRE_COMPACT_FIELDS, WIRE_COMPRESSION_LINE_FIELDS, WIRE_CONFIG_FIELDS, WIRE_CONTEXT_FIELDS, WIRE_CREATE_SESSION_FIELDS, WIRE_CREATE_WORKSPACE_FIELDS, WIRE_CREATE_WORKSPACE_RESPONSE_FIELDS, WIRE_CUSTOM_COMMAND_FIELDS, WIRE_DELETE_SESSION_FIELDS, WIRE_DIFF_FILE_FIELDS, WIRE_DIFF_FILE_RESPONSE_FIELDS, WIRE_ERROR_FIELDS, WIRE_FILE_CANDIDATES_FIELDS, WIRE_FILE_CANDIDATE_FIELDS, WIRE_FILE_CHANGE_FIELDS, WIRE_FILE_OPEN_RESPONSE_FIELDS, WIRE_FILE_REFERENCE_FIELDS, WIRE_FILE_STAT_MAX, WIRE_FILE_STAT_OK_FIELDS, WIRE_FILE_STAT_REFUSED_FIELDS, WIRE_FILE_STAT_RESPONSE_FIELDS, WIRE_FILE_TEXT_RESPONSE_FIELDS, WIRE_FORGET_WORKSPACE_FIELDS, WIRE_FORGET_WORKSPACE_RESPONSE_FIELDS, WIRE_GOAL_ACTIONS, WIRE_GOAL_BLOCK_FIELDS, WIRE_GOAL_CLEAR_FIELDS, WIRE_GOAL_CREATE_FIELDS, WIRE_GOAL_FIELDS, WIRE_GOAL_LIMITS_FIELDS, WIRE_GOAL_PHASES, WIRE_GOAL_REFUSALS, WIRE_GOAL_RESPONSE_FIELDS, WIRE_GOAL_WRITE_FIELDS, WIRE_HEALTH_FIELDS, WIRE_IMAGE_REFERENCE_FIELDS, WIRE_KNOWN_WORKSPACE_FIELDS, WIRE_LANG_PARAM, WIRE_LAST_SESSION_FIELDS, WIRE_LAST_SESSION_RESPONSE_FIELDS, WIRE_MANAGED_LOCK_FIELDS, WIRE_MCP_ADD_FIELDS, WIRE_MCP_ADD_RESPONSE_FIELDS, WIRE_MCP_APPLY_ENTRY_FIELDS, WIRE_MCP_APPLY_RESPONSE_FIELDS, WIRE_MCP_CONFIG_APPLY_FIELDS, WIRE_MCP_CONFIG_FIELDS, WIRE_MCP_CONFIG_ISSUE_FIELDS, WIRE_MCP_CONFIG_SAVE_FIELDS, WIRE_MCP_CONFIG_SAVE_RESPONSE_FIELDS, WIRE_MCP_CONNECTOR_FIELDS, WIRE_MCP_RECONNECT_FIELDS, WIRE_MESSAGE_LIST_FIELDS, WIRE_MODEL_ENTRIES_FIELDS, WIRE_MODEL_ENTRY_MODELS_FIELDS, WIRE_MODEL_ENTRY_SAVE_FIELDS, WIRE_MODEL_ENTRY_TEST_FIELDS, WIRE_MODEL_FIELDS, WIRE_MODEL_SELECTION_FIELDS, WIRE_MODEL_SET_FIELDS, WIRE_PATCH_SESSION_FIELDS, WIRE_PATCH_SESSION_RESPONSE_FIELDS, WIRE_PERMISSION_RULE_FIELDS, WIRE_PERMISSION_SET_REQUEST_FIELDS, WIRE_PERMISSION_SET_RESPONSE_FIELDS, WIRE_PERMISSION_SHADOW_FIELDS, WIRE_PERMISSION_STATE_FIELDS, WIRE_PERMISSION_STATUS_FIELDS, WIRE_PLAN_ACTIONS, WIRE_PLAN_FIELDS, WIRE_PLAN_MODE_REQUEST_FIELDS, WIRE_PLAN_MODE_RESPONSE_FIELDS, WIRE_PLAN_MODE_STATE_FIELDS, WIRE_PLUGINS_FIELDS, WIRE_PLUGIN_ACTION_FIELDS, WIRE_PLUGIN_ARCHIVE_SUFFIXES, WIRE_PLUGIN_INSTALL_FIELDS, WIRE_PLUGIN_LOCAL_FIELDS, WIRE_PLUGIN_LOCAL_INSTALL_FIELDS, WIRE_PLUGIN_MARKETPLACE_FIELDS, WIRE_PLUGIN_MARKETPLACE_RESPONSE_FIELDS, WIRE_PLUGIN_NAME_FIELDS, WIRE_PLUGIN_PREVIEW_FIELDS, WIRE_PLUGIN_PREVIEW_RESPONSE_FIELDS, WIRE_PLUGIN_REFRESH_RESPONSE_FIELDS, WIRE_PLUGIN_STAGE_FIELDS, WIRE_PLUGIN_STAGE_RESPONSE_FIELDS, WIRE_PLUGIN_TOGGLE_FIELDS, WIRE_PLUGIN_UPDATE_FIELDS, WIRE_PLUGIN_UPLOAD_CONFIRM_FIELDS, WIRE_PLUGIN_UPLOAD_FIELDS, WIRE_PLUGIN_UPLOAD_FORM_FIELDS, WIRE_PLUGIN_UPLOAD_PREVIEW_RESPONSE_FIELDS, WIRE_PLUGIN_UPLOAD_RESPONSE_FIELDS, WIRE_PLUGIN_VIEW_FIELDS, WIRE_PLUGIN_VIEW_RESPONSE_FIELDS, WIRE_POLICY_DIR_FIELDS, WIRE_POLICY_STATUS_FIELDS, WIRE_PROJECT_INVENTORY_FIELDS, WIRE_PROVIDER_GROUPS, WIRE_QUESTION_LIST_FIELDS, WIRE_QUESTION_ROW_FIELDS, WIRE_RESPOND_APPROVAL_FIELDS, WIRE_RESPOND_APPROVAL_RESPONSE_FIELDS, WIRE_RESPOND_QUESTION_FIELDS, WIRE_RESPOND_QUESTION_RESPONSE_FIELDS, WIRE_REVEAL_WORKSPACE_FIELDS, WIRE_REVEAL_WORKSPACE_RESPONSE_FIELDS, WIRE_REVIVE_FIELDS, WIRE_REWIND_FILE_PLAN_FIELDS, WIRE_REWIND_OUTCOME_FIELDS, WIRE_REWIND_PREVIEW_FIELDS, WIRE_REWIND_REQUEST_FIELDS, WIRE_REWIND_RESPONSE_FIELDS, WIRE_REWIND_SCOPES, WIRE_ROLES_FIELDS, WIRE_ROLE_ADD_FIELDS, WIRE_ROLE_ADD_RESPONSE_FIELDS, WIRE_ROLE_REMOVE_FIELDS, WIRE_RUNNING_SCHEDULE_FIELDS, WIRE_SANDBOX_STATUS_FIELDS, WIRE_SCHEDULE_CAPABILITY_FIELDS, WIRE_SCHEDULE_CREATE_FIELDS, WIRE_SCHEDULE_DEFAULTS_FIELDS, WIRE_SCHEDULE_DELETE_FIELDS, WIRE_SCHEDULE_FIELDS, WIRE_SCHEDULE_FIX_FIELDS, WIRE_SCHEDULE_FIX_REQUEST_FIELDS, WIRE_SCHEDULE_ISSUE_CODES, WIRE_SCHEDULE_LIST_FIELDS, WIRE_SCHEDULE_PENDING_FIELDS, WIRE_SCHEDULE_RECORDING_FIELDS, WIRE_SCHEDULE_ROW_FIELDS, WIRE_SCHEDULE_RUNNING_FIELDS, WIRE_SCHEDULE_RUNS_FIELDS, WIRE_SCHEDULE_RUN_FIELDS, WIRE_SCHEDULE_SAVE_FIELDS, WIRE_SECURITY_FIELDS, WIRE_SECURITY_WORKSPACE_FIELDS, WIRE_SEND_MESSAGE_FIELDS, WIRE_SEND_MESSAGE_RESPONSE_FIELDS, WIRE_SESSION_BRANCH_RESPONSE_FIELDS, WIRE_SESSION_CANDIDATES_FIELDS, WIRE_SESSION_CANDIDATE_FIELDS, WIRE_SESSION_FINISH_FIELDS, WIRE_SESSION_LIST_FIELDS, WIRE_SESSION_REFERENCE_FIELDS, WIRE_SESSION_RESPONSE_FIELDS, WIRE_SESSION_SUMMARY_FIELDS, WIRE_SESSION_WORKSPACE_FIELDS, WIRE_SESSION_WORKSPACE_RESPONSE_FIELDS, WIRE_SETTINGS_FIELDS, WIRE_SETTINGS_WRITE_FIELDS, WIRE_SETTINGS_WRITE_REQUEST_FIELDS, WIRE_SETTING_PENDING_FIELDS, WIRE_SETTING_ROW_FIELDS, WIRE_SETTING_STEP_FIELDS, WIRE_SETTING_WRITE_FIELDS, WIRE_SETTING_WRITE_LAYERS, WIRE_SKILL_BODY_FIELDS, WIRE_SKILL_DROP_SUFFIXES, WIRE_SKILL_FIELDS, WIRE_SKILL_IMPORT_FIELDS, WIRE_SKILL_IMPORT_PREVIEW_FIELDS, WIRE_SKILL_REMOVE_FIELDS, WIRE_SKILL_STAGE_FIELDS, WIRE_TASKS_FIELDS, WIRE_TEAM_FIELDS, WIRE_TOOLS_FIELDS, WIRE_TOOL_GATE_FIELDS, WIRE_TOOL_ROW_FIELDS, WIRE_TRUST_REQUEST_FIELDS, WIRE_TRUST_REQUEST_RESPONSE_FIELDS, WIRE_WITHDRAW_MESSAGE_FIELDS, WIRE_WORKSPACE_DIFF_FIELDS, WIRE_WORKSPACE_DIRS_FIELDS, WIRE_WORKSPACE_DIR_ENTRY_FIELDS, WIRE_WORKSPACE_REF_FIELDS, type WireAbortResponse, type WireAbout, type WireAgentEnvelope, type WireAgentEvent, type WireAgentRoleSummary, type WireAppearanceRequest, type WireAppearanceResponse, type WireApprovalCacheRevokeRequest, type WireApprovalCacheRevokeResponse, type WireApprovalListResponse, type WireApprovalRequest, type WireArtifactsResponse, type WireAttachmentFolderResponse, type WireAttachmentUploadResponse, type WireAuditCode, type WireAuditLog, type WireAuditOutcome, type WireAuditRow, type WireAuthDenyReason, type WireAuthDenyStatus, type WireAuthGuard, type WireAuthRequestView, type WireAuthVerdict, type WireBackgroundTask, type WireBindWorkspaceRequest, type WireBlockedGoal, type WireBlockedGoalsResponse, type WireBlockedLevel, type WireBuiltinConnector, type WireCachedApproval, type WireCachedDecision, type WireCapabilitiesResponse, type WireCapabilityProject, type WireCheckpointListResponse, type WireCheckpointSummary, type WireCommandExpansion, type WireCommandsResponse, type WireCompactRequest, type WireCompactResponse, type WireCompressionLine, type WireConfigResponse, type WireContextResponse, type WireCreateSessionRequest, type WireCreateSessionResponse, type WireCreateWorkspaceRequest, type WireCreateWorkspaceResponse, type WireCustomCommand, type WireDeleteSessionResponse, type WireDiffFile, type WireDiffFileResponse, type WireDiffNote, type WireDiffOmitReason, type WireDiffSource, type WireDiffStatus, type WireEffectiveModel, type WireEffectiveSlots, type WireEntryProbeCode, type WireEntryProvider, type WireEnvelope, type WireErrorResponse, type WireEvent, type WireFields, type WireFileCandidate, type WireFileCandidatesResponse, type WireFileChange, type WireFileKind, type WireFileOpenRefusal, type WireFileOpenResponse, type WireFileReference, type WireFileRefusal, type WireFileStat, type WireFileStatOk, type WireFileStatRefused, type WireFileStatResponse, type WireFileTextResponse, type WireFixture, type WireFixtureCase, type WireForgetWorkspaceRequest, type WireForgetWorkspaceResponse, type WireGoal, type WireGoalBlock, type WireGoalClearResponse, type WireGoalCreateRequest, type WireGoalLimits, type WireGoalPhase, type WireGoalRefusal, type WireGoalResponse, type WireGoalUpdateRequest, type WireGoalWriteResponse, type WireHealthResponse, type WireHostBadgeRequest, type WireHostBadges, type WireHostCompose, type WireHostComposeRequest, type WireHostComposeResponse, type WireHostComposeStateResponse, type WireHostComposeTakeResponse, type WireHostTray, type WireHostTrayItemRequest, type WireHostTrayRequest, type WireHubEnvelope, type WireHubEvent, type WireImageReference, type WireKnownWorkspace, type WireKnownWorkspaceRef, type WireLastSessionRequest, type WireLastSessionResponse, type WireManagedLock, type WireMcpAddRequest, type WireMcpAddResponse, type WireMcpApplyAction, type WireMcpApplyEntry, type WireMcpApplyResponse, type WireMcpConfigApplyRequest, type WireMcpConfigIssue, type WireMcpConfigResponse, type WireMcpConfigSaveRequest, type WireMcpConfigSaveResponse, type WireMcpConnector, type WireMcpReconnectResponse, type WireMessageListResponse, type WireModelCaveat, type WireModelEffortRequest, type WireModelEffortResponse, type WireModelEntriesResponse, type WireModelEntry, type WireModelEntryModelsResponse, type WireModelEntryProbeRequest, type WireModelEntryRefRequest, type WireModelEntryRefs, type WireModelEntrySaveRequest, type WireModelEntrySaveResponse, type WireModelEntryTestResponse, type WireModelRejection, type WireModelResponse, type WireModelSelection, type WireModelSetRequest, type WireModelSetResponse, type WirePatchSessionRequest, type WirePatchSessionResponse, type WirePermissionRememberFailure, type WirePermissionRuleRow, type WirePermissionSetRequest, type WirePermissionSetResponse, type WirePermissionShadow, type WirePermissionState, type WirePermissionStatus, type WirePickDirectoryResponse, type WirePlanAction, type WirePlanModeRequest, type WirePlanModeResponse, type WirePlanModeState, type WirePlanResponse, type WirePluginActionResponse, type WirePluginCategory, type WirePluginCounts, type WirePluginDependency, type WirePluginDependencyInventory, type WirePluginDependencyStatus, type WirePluginDoc, type WirePluginDocs, type WirePluginEntry, type WirePluginHit, type WirePluginHookTally, type WirePluginInstallRequest, type WirePluginLocalInstallRequest, type WirePluginLocalRequest, type WirePluginMarketplace, type WirePluginMarketplaceRequest, type WirePluginMarketplaceResponse, type WirePluginMenuItem, type WirePluginNameRequest, type WirePluginPanel, type WirePluginPreview, type WirePluginPreviewRequest, type WirePluginPreviewResponse, type WirePluginPreviewStreamLine, type WirePluginProgressStep, type WirePluginRefreshResponse, type WirePluginRefuseReason, type WirePluginSourceType, type WirePluginStageRequest, type WirePluginStageResponse, type WirePluginStatus, type WirePluginToggleRequest, type WirePluginUpdateRequest, type WirePluginUploadChoice, type WirePluginUploadConfirmRequest, type WirePluginUploadField, type WirePluginUploadFieldName, type WirePluginUploadFields, type WirePluginUploadFile, type WirePluginUploadForm, type WirePluginUploadPlan, type WirePluginUploadPreviewResponse, type WirePluginUploadRequest, type WirePluginUploadResponse, type WirePluginVersionUnmet, type WirePluginViewRequest, type WirePluginViewResponse, type WirePluginVisibility, type WirePluginsResponse, type WirePolicyDir, type WirePolicyStatus, type WireProjectInventory, type WireProviderGroup, type WireQuestionListResponse, type WireQuestionRequest, type WireReplayMessage, type WireResetReason, type WireRespondApprovalRequest, type WireRespondApprovalResponse, type WireRespondQuestionRequest, type WireRespondQuestionResponse, type WireRevealWorkspaceRefusal, type WireRevealWorkspaceRequest, type WireRevealWorkspaceResponse, type WireReviveResponse, type WireRewindAction, type WireRewindDrift, type WireRewindFilePlan, type WireRewindOutcome, type WireRewindPreview, type WireRewindRequest, type WireRewindResponse, type WireRewindScope, type WireRoleAddRequest, type WireRoleAddResponse, type WireRoleRemoveFailure, type WireRoleRemoveResponse, type WireRolesResponse, type WireRunningSchedule, type WireSandboxReason, type WireSandboxStatus, type WireScheduleCancelResponse, type WireScheduleCapability, type WireScheduleCreateRequest, type WireScheduleDefaults, type WireScheduleDeleteResponse, type WireScheduleFixRequest, type WireScheduleFixResponse, type WireScheduleIssue, type WireScheduleIssueCode, type WireScheduleListResponse, type WireSchedulePendingResponse, type WireScheduleRecordingResponse, type WireScheduleRegisterRefusal, type WireScheduleRegisterWarning, type WireScheduleRegistration, type WireScheduleResponse, type WireScheduleRow, type WireScheduleRunResponse, type WireScheduleRunningResponse, type WireScheduleRunsResponse, type WireScheduleSaveResponse, type WireScheduleUpdateRequest, type WireSecurityResponse, type WireSecurityWorkspace, type WireSendMessageRequest, type WireSendMessageResponse, type WireSessionBranchResponse, type WireSessionCandidate, type WireSessionCandidatesResponse, type WireSessionFinish, type WireSessionListResponse, type WireSessionReference, type WireSessionResponse, type WireSessionSummary, type WireSessionWorkspace, type WireSessionWorkspaceResponse, type WireSettingApply, type WireSettingFutile, type WireSettingLayer, type WireSettingPending, type WireSettingRow, type WireSettingStep, type WireSettingValue, type WireSettingValueKind, type WireSettingWrite, type WireSettingWriteLayer, type WireSettingsResponse, type WireSettingsWriteRequest, type WireSettingsWriteResponse, type WireSkillBodyResponse, type WireSkillImportConflict, type WireSkillImportEntry, type WireSkillImportFailure, type WireSkillImportForm, type WireSkillImportIssue, type WireSkillImportPreviewResponse, type WireSkillImportResponse, type WireSkillRemoveFailure, type WireSkillRemoveResponse, type WireSkillStageFailure, type WireSkillStageResponse, type WireSkillSummary, type WireSummaryWorkspace, type WireTaggedEvent, type WireTasksResponse, type WireTeamResponse, type WireToolGate, type WireToolGateAxis, type WireToolRow, type WireToolSummary, type WireToolVerdict, type WireToolsResponse, type WireTrayItemOverride, type WireTrustRequestRequest, type WireTrustRequestResponse, type WireTurnState, type WireWithdrawMessageResponse, type WireWorkspaceBinding, type WireWorkspaceDiffResponse, type WireWorkspaceDirEntry, type WireWorkspaceDirsResponse, type WireWorkspaceRef, accentScale, agentMessageLine, apiKeyEnvVar, appearanceInlineVars, appearanceRootAttributes, appearanceVisualCss, approvalPolicyForLevel, assertNeverPart, assistantTurnText, attachSessionSurface, chordId, collectPendingApprovals, compressionThresholdTokens, conformsToWire, contentToText, cronTimes, diagnosticToLine, encodeAppearanceFirstScreenValue, entryDisplayName, entryRef, entrySecretName, extractAllMentions, extractMentions, extractSessionMentions, filePartSummary, fillPlaceholders, flattenCatalog, formatAppearanceTranslucent, formatMoney, getProviderInfo, hasFailure, hexToHsv, hsvToHex, imagePartOmittedSummary, isAppearanceAccent, isAppearanceAccentValue, isAppearanceBackground, isAppearanceBackgroundFit, isAppearanceBackgroundKind, isAppearanceCodeFont, isAppearanceCodeFontSize, isAppearanceContrast, isAppearanceDiffTreeWidth, isAppearanceFontSize, isAppearanceLang, isAppearanceModePatch, isAppearanceMotion, isAppearanceSidebarWidth, isAppearanceTheme, isAppearanceThemeName, isAppearanceTranslucent, isAppearanceUiFont, isApprovalOutcome, isContextNearlyFull, isCurrency, isEntrySecretName, isHeadlessInputFormat, isHeadlessLifecycleEvent, isHeadlessOutputFormat, isHexColor, isKeyAction, isLang, isMentionableFilePath, isModelEntryId, isOpenableLink, isOperationType, isPermissionLevel, isPlanOutcome, isPromptOversize, isProviderType, isQuestionAnswerMap, isReasoningEffort, isSearchProviderType, isSettingsPaneId, isValidAgentRoleName, isValidCommandName, isWireGoalPhase, isWireHubEvent, isWirePlanAction, isWirePluginArchiveName, isWireRewindScope, isWireSettingWriteLayer, isWireSkillDropName, joinUploadMulti, makeTranslate, mcpConnectorState, normalizeAppearanceTranslucent, normalizeApproval, offloadedImagePart, packSessionSurface, parseAppearanceTranslucentText, parseChord, parseModelRef, parseSequence, perAction, placeholdersOf, promptTokens, relativeLuminance, resolveAppearanceVisual, resolveHostText, resolvePermissionLevel, sequenceId, sessionPartSummary, sessionSenderLabel, snapAppearanceContrast, splitUploadMulti, stripSystemNote, systemNote, tableOf, totalUsageTokens, translatorFor, truncateToBudget, turnDigest, unfixedRules, utf8ByteLength, wireFields };

package/dist/index.js

@@ -54,13 +54,13 @@ function isValidAgentRoleName(name) {
 // src/team.ts
 var LEAD_AGENT_ID = "lead";
 function agentMessageLine(msg) {
-  return `[\u6765\u81EA ${msg.fromLabel ?? msg.from} \u7684\u6D88\u606F] ${msg.text}`;
+  return `[message from ${msg.fromLabel ?? msg.from}] ${msg.text}`;
 }
 function sessionSenderLabel(sessionId, title) {
   const t = title?.trim();
-  return t ? `\u4F1A\u8BDD\u300C${t}\u300D(${sessionId})` : sessionId;
+  return t ? `session "${t}" (${sessionId})` : sessionId;
 }
-var AGENT_MESSAGE_NOTE_TITLE = "Agent \u6D88\u606F";
+var AGENT_MESSAGE_NOTE_TITLE = "Agent messages";
 // src/commands.ts
 var RESERVED_COMMAND_NAMES = [
   "help",
@@ -393,6 +393,7 @@ var SCHEDULE_RUN_STATUSES = [
   "failed",
   "denied",
   "timeout",
+  "cancelled",
   "budget",
   "skipped-overlap",
   "skipped-window",
@@ -463,19 +464,19 @@ var SESSION_REFERENCE_ERROR_CODES = Object.freeze([
   "budget-exceeded"
 ]);
 var OMIT_LABEL = {
-  binary: "\u4E8C\u8FDB\u5236\u6587\u4EF6\uFF0C\u672A\u9644\u5185\u5BB9\uFF1Bfile_read \u5BF9\u4E8C\u8FDB\u5236\u662F\u76F4\u63A5\u62D2\u7684\uFF0C\u8981\u5185\u5BB9\u5F97\u81EA\u5DF1\u53E6\u53D6\uFF0C\u522B\u56DE\u5934\u8BA9\u7528\u6237\u8D34",
-  denied: "\u6743\u9650\u672A\u653E\u884C\uFF0C\u672A\u9644\u5185\u5BB9 \u2014\u2014 \u9700\u8981\u5C31\u8C03 file_read\uFF0C\u90A3\u6761\u8DEF\u4F1A\u8D70\u5B8C\u6574\u5BA1\u6279",
-  unreadable: "\u8BFB\u53D6\u5931\u8D25\uFF0C\u672A\u9644\u5185\u5BB9",
-  "over-limit": "\u8D85\u51FA\u672C\u6761\u6D88\u606F\u7684\u9644\u4EF6\u4E0A\u9650\uFF0C\u672A\u9644\u5185\u5BB9 \u2014\u2014 \u9700\u8981\u5C31\u8C03 file_read",
-  "not-restored": "\u4F1A\u8BDD\u6062\u590D\u540E\u4E0D\u91CD\u8BFB\u5185\u5BB9\uFF0C\u9700\u8981\u5C31\u8C03 file_read"
+  binary: "binary file, content not attached; file_read refuses binary files outright, so fetch the content yourself some other way \u2014 do not ask the user to paste it",
+  denied: "permission not granted, content not attached \u2014 call file_read if you need it, that path goes through full approval",
+  unreadable: "read failed, content not attached",
+  "over-limit": "exceeds the attachment limit for this message, content not attached \u2014 call file_read if you need it",
+  "not-restored": "content is not re-read after a session restore; call file_read if you need it"
 };
 function truncatedNote(part) {
   const kept = part.truncatedTo;
   if (kept === void 0) return "";
-  const scale = part.bytes === void 0 || part.bytes <= 0 ? `\u5DF2\u622A\u65AD\u5230 ${kept} \u5B57\u8282` : `\u53EA\u9644\u4E86\u524D ${kept} / \u5171 ${part.bytes} \u5B57\u8282\uFF08${Math.round(kept / part.bytes * 100)}%\uFF09`;
+  const scale = part.bytes === void 0 || part.bytes <= 0 ? `truncated to ${kept} bytes` : `only the first ${kept} of ${part.bytes} bytes attached (${Math.round(kept / part.bytes * 100)}%)`;
   const lines = part.text === void 0 ? 0 : countLines(part.text);
-  if (lines === 0) return `\uFF0C${scale}\uFF0C\u4E0D\u8DB3\u4E00\u884C \u2014\u2014 \u8981\u5168\u90E8\u5C31\u8C03 file_read \u91CD\u8BFB`;
-  return `\uFF0C${scale}\uFF0C\u5230\u7B2C ${lines} \u884C\u4E3A\u6B62 \u2014\u2014 \u5269\u4E0B\u7684\u8C03 file_read offset=${lines + 1} \u63A5\u7740\u8BFB`;
+  if (lines === 0) return `, ${scale}, not even one full line \u2014 call file_read to read it all`;
+  return `, ${scale}, up to line ${lines} \u2014 read the rest with file_read offset=${lines + 1}`;
 }
 function countLines(text) {
   let n = 0;
@@ -483,13 +484,13 @@ function countLines(text) {
   return n;
 }
 function filePartSummary(part) {
-  if (part.omitted) return `[\u6587\u4EF6 ${part.path}\uFF1A${OMIT_LABEL[part.omitted]}]`;
-  return `[\u6587\u4EF6 ${part.path}${truncatedNote(part)}]`;
+  if (part.omitted) return `[file ${part.path}: ${OMIT_LABEL[part.omitted]}]`;
+  return `[file ${part.path}${truncatedNote(part)}]`;
 }
 function imagePartOmittedSummary(part) {
-  return `[\u56FE\u7247 ${part.mediaType ?? "\u672A\u77E5\u7C7B\u578B"}\uFF1A\u5F53\u524D\u6A21\u578B\u4E0D\u652F\u6301\u56FE\u7247\u8F93\u5165\uFF0C\u5185\u5BB9\u672A\u9644\u4E0A]`;
+  return `[image ${part.mediaType ?? "unknown type"}: the current model does not support image input, content not attached]`;
 }
-var OFFLOADED_IMAGE_NOTE = "[\u56FE\u7247\u5DF2\u4E0B\u653E\uFF1A\u539F\u56FE\u4ECD\u5728 artifact \u76EE\u5F55\u91CC\uFF0C\u9700\u8981\u5C31\u8C03 file_read \u6309\u8DEF\u5F84\u53D6\uFF1B\u522B\u8BA9\u7528\u6237\u91CD\u53D1\uFF0C\u91CD\u53D1\u4E5F\u4E0D\u6539\u53D8\u4F53\u79EF]";
+var OFFLOADED_IMAGE_NOTE = "[image offloaded: the original is still in the artifact directory \u2014 call file_read by path if you need it; do not ask the user to resend, resending does not change the size]";
 function offloadedImagePart() {
   return { type: "text", text: OFFLOADED_IMAGE_NOTE };
 }
@@ -508,7 +509,7 @@ function contentToText(content, opts = {}) {
     if (p.type === "file") return filePartSummary(p);
     if (p.type === "session") return sessionPartSummary(p);
     if (p.type === "image") {
-      return opts.imagesCarriedAsParts ? void 0 : `[\u56FE\u7247 ${p.mediaType ?? "\u672A\u77E5\u7C7B\u578B"}]`;
+      return opts.imagesCarriedAsParts ? void 0 : `[image ${p.mediaType ?? "unknown type"}]`;
     }
     return assertNeverPart(p);
   }).filter((line) => line !== void 0).join("\n");
@@ -521,8 +522,8 @@ function turnDigest(results) {
   const named = [...counts.entries()].slice(0, TURN_DIGEST_MAX_TOOLS);
   const parts = named.map(([name, n]) => n > 1 ? `${name}\xD7${n}` : name);
   const rest = counts.size - named.length;
-  if (rest > 0) parts.push(`\u7B49 ${rest} \u79CD`);
-  return `[\u672C\u8F6E\u8C03\u7528\u8FC7\u7684\u5DE5\u5177\uFF1A${parts.join(" \xB7 ")}]`;
+  if (rest > 0) parts.push(`and ${rest} more`);
+  return `[tools used this turn: ${parts.join(" \xB7 ")}]`;
 }
 var UNFINISHED_TURN_BUDGET = 4e3;
 var UNFINISHED_RESULT_CAP = 1e3;
@@ -539,14 +540,14 @@ function unfinishedTurnText(results) {
     const cap = Math.min(UNFINISHED_RESULT_CAP, left);
     const clipped = output.length > cap;
     lines.push(
-      clipped ? `${r.toolName}\uFF1A${output.slice(0, cap)}
-\uFF08\u8FD9\u4E00\u6761\u53EA\u9644\u4E86\u524D ${cap} / \u5171 ${output.length} \u5B57\u7B26 \u2014\u2014 \u8981\u5269\u4E0B\u7684\u5C31\u91CD\u65B0\u8C03\u4E00\u6B21\uFF09` : `${r.toolName}\uFF1A${output}`
+      clipped ? `${r.toolName}: ${output.slice(0, cap)}
+(only the first ${cap} of ${output.length} characters attached \u2014 call it again if you need the rest)` : `${r.toolName}: ${output}`
     );
     left -= Math.min(output.length, cap);
   }
-  const head = "[\u672C\u8F6E\u6CA1\u8DD1\u5B8C\u5C31\u4E2D\u65AD\u4E86\u3002\u4EE5\u4E0B\u662F**\u5DF2\u7ECF\u6267\u884C\u8FC7**\u7684\u5DE5\u5177\u548C\u5B83\u4EEC\u7684\u7ED3\u679C\uFF0C\u522B\u91CD\u590D\u6267\u884C\uFF1A]";
+  const head = "[this turn was interrupted before it finished. Below are the tools that **already ran** and their results \u2014 do not run them again:]";
   const tail = dropped > 0 ? `
-\uFF08\u53E6\u6709 ${dropped} \u6761\u7ED3\u679C\u56E0\u957F\u5EA6\u672A\u9644 \u2014\u2014 \u9700\u8981\u5C31\u91CD\u65B0\u8C03\u4E00\u6B21\uFF09` : "";
+(${dropped} more result(s) not attached because of length \u2014 call again if you need them)` : "";
   return `${head}
 ${lines.join("\n")}${tail}`;
 }
@@ -759,6 +760,7 @@ var HUB_EVENT_TYPES = /* @__PURE__ */ new Set([
   "plugins-changed",
   "host-compose",
   "host-badges",
+  "host-tray",
   "user-message"
 ]);
 function isWireHubEvent(event) {
@@ -1117,6 +1119,12 @@ var WIRE_TEAM_FIELDS = wireFields()({
   agents: true,
   tasks: true
 });
+var WIRE_REVEAL_WORKSPACE_FIELDS = wireFields()({
+  root: true
+});
+var WIRE_REVEAL_WORKSPACE_RESPONSE_FIELDS = wireFields()({
+  ok: true
+});
 // src/wire-capability.ts
 var WIRE_AGENT_ROLE_FIELDS = wireFields()({
   name: true,
@@ -2009,6 +2017,9 @@ function appearanceInlineVars(resolved) {
     vars["--accent-press"] = scale.press;
     vars["--accent-ink"] = scale.ink;
   }
+  if (resolved.background !== void 0) {
+    vars["--bg-canvas-alpha"] = `${String(100 - resolved.background.opacity)}%`;
+  }
   return vars;
 }
 function appearanceVisualCss(resolved) {
@@ -2427,4 +2438,4 @@ var COMPLIANCE_ACTIONS = ["block", "mask", "warn", "off"];
 var SECRET_SERVICE = "epoch-agent";
 var MCP_DATA_KEY_NAME = "mcp-auth-data-key";
 
-export { ACTION_CONTEXTS, AGENT_MESSAGE_NOTE_TITLE, AGENT_ROLE_NAME_PATTERN, API_KEY_ENV_VARS, APPEARANCE_ACCENTS, APPEARANCE_BACKGROUND_FITS, APPEARANCE_BACKGROUND_KINDS, APPEARANCE_BACKGROUND_ON_PARAM, APPEARANCE_CODE_FONTS, APPEARANCE_CODE_FONT_SIZE, APPEARANCE_CONTRAST, APPEARANCE_DEFAULT_CODE_FONT_SIZE, APPEARANCE_DEFAULT_FONT_SIZE, APPEARANCE_DIFF_TREE_WIDTH, APPEARANCE_FIRST_SCREEN_FIELDS, APPEARANCE_FIRST_SCREEN_FIELD_ORDER, APPEARANCE_FONT_SIZE, APPEARANCE_LANGS, APPEARANCE_MOTION, APPEARANCE_ROOT_ATTRIBUTES, APPEARANCE_SIDEBAR_WIDTH, APPEARANCE_THEMES, APPEARANCE_THEME_NAME_MAX, APPEARANCE_TRANSLUCENT, APPEARANCE_UI_FONTS, APPROVAL_OUTCOMES, APPROVAL_POLICIES, BRAND_WHEN_SIDEBAR_COLLAPSED, COMMAND_NAME_PATTERN, COMPLIANCE_ACTIONS, COMPLIANCE_CATEGORIES, CURRENCIES, DEFAULT_AGENT_ROLE, DEFAULT_LANG, DEFAULT_PERMISSION_LEVEL, DiagnosticSink, ENTRY_REF_PREFIX, ENTRY_SECRET_PREFIX, FOLLOW_SYSTEM, GEN_AI, HEADLESS_INPUT_EVENT_TYPES, HEADLESS_INPUT_FORMATS, HEADLESS_OUTPUT_FORMATS, HEADLESS_PROTOCOL_VERSION, KEY_ACTIONS, LANGS, LEAD_AGENT_ID, LEGACY_LEVEL_ALIASES, LINK_CLICKED_MESSAGE_TYPE, MAX_ATTACH_BYTES, MAX_ATTACH_FILES, MAX_ATTACH_TOTAL_BYTES, MAX_HEADER_CHARS, MAX_LINK_URL, MAX_OPTIONS, MAX_QUESTIONS, MAX_SESSION_ATTACH_BYTES, MAX_SESSION_REFS, MCP_DATA_KEY_NAME, METRIC, MIN_OPTIONS, MODEL_ENTRY_PROTOCOLS, NOOP_TELEMETRY, OFFLOADED_IMAGE_NOTE, OPENABLE_LINK_SCHEMES, OPEN_SETTINGS_MESSAGE_TYPE, OPERATION_TYPES, OVERSIZE_RATIO, PERMISSION_LEVELS, PLAN_OUTCOMES, PLUGIN_CATEGORY_DISPLAY_SEP, PLUGIN_MENU_MESSAGE_TYPE, PLUGIN_PREVIEW_STREAM_MIME, PLUGIN_UPLOAD_MULTI_SEP, PROVIDER_INFOS, PROVIDER_TYPES, REASONING_EFFORTS, REASONING_OFF, RESERVED_CHORDS, RESERVED_COMMAND_NAMES, SCHEDULE_CONFIRM_PLACEHOLDER, SCHEDULE_DEFAULT_PERMISSION, SCHEDULE_DRAFT_SAVED_MARK, SCHEDULE_DRAFT_TOOL, SCHEDULE_INTERVAL_MAX_MINUTES, SCHEDULE_INTERVAL_MIN_MINUTES, SCHEDULE_MAX_TIMES_PER_DAY, SCHEDULE_RUN_STATUSES, SEARCH_API_KEY_ENV, SEARCH_PROVIDER_TYPES, SECRET_SERVICE, SEQUENCE_CONTEXTS, SESSION_MENTION_PREFIX, SESSION_REFERENCE_ERROR_CODES, SETTINGS_PANE_IDS, SHELL_KINDS, SIDEBAR_MENU_MESSAGE_TYPE, SIMULTANEOUS_CONTEXTS, SYSTEM_NOTE_PREFIX, ToolExposure, UNLIMITED_TURNS, USER_MENU_MESSAGE_TYPE, WIRE_ABORT_FIELDS, WIRE_ABOUT_FIELDS, WIRE_AGENT_ROLE_FIELDS, WIRE_APPEARANCE_RESPONSE_FIELDS, WIRE_APPROVAL_CACHE_REVOKE_REQUEST_FIELDS, WIRE_APPROVAL_CACHE_REVOKE_RESPONSE_FIELDS, WIRE_APPROVAL_LIST_FIELDS, WIRE_APPROVAL_ROW_FIELDS, WIRE_ARTIFACTS_FIELDS, WIRE_ATTACHMENT_FOLDER_FIELDS, WIRE_ATTACHMENT_UPLOAD_FIELDS, WIRE_AUDIT_LOG_FIELDS, WIRE_AUDIT_ROW_FIELDS, WIRE_AUTH_COOKIE, WIRE_AUTH_COOKIE_ATTRS, WIRE_AUTH_TOKEN_PARAM, WIRE_BACKGROUND_TASK_FIELDS, WIRE_BLOCKED_GOALS_FIELDS, WIRE_BLOCKED_GOAL_FIELDS, WIRE_BLOCKED_LEVEL_FIELDS, WIRE_BUILTIN_CONNECTOR_FIELDS, WIRE_CACHED_APPROVAL_FIELDS, WIRE_CAPABILITIES_FIELDS, WIRE_CAPABILITY_PROJECT_FIELDS, WIRE_CHECKPOINT_LIST_FIELDS, WIRE_CHECKPOINT_SUMMARY_FIELDS, WIRE_COMMANDS_FIELDS, WIRE_COMMAND_EXPANSION_FIELDS, WIRE_COMPACT_FIELDS, WIRE_COMPRESSION_LINE_FIELDS, WIRE_CONFIG_FIELDS, WIRE_CONTEXT_FIELDS, WIRE_CREATE_SESSION_FIELDS, WIRE_CREATE_WORKSPACE_FIELDS, WIRE_CREATE_WORKSPACE_RESPONSE_FIELDS, WIRE_CUSTOM_COMMAND_FIELDS, WIRE_DELETE_SESSION_FIELDS, WIRE_DIFF_FILE_FIELDS, WIRE_DIFF_FILE_RESPONSE_FIELDS, WIRE_ERROR_FIELDS, WIRE_FILE_CANDIDATES_FIELDS, WIRE_FILE_CANDIDATE_FIELDS, WIRE_FILE_CHANGE_FIELDS, WIRE_FILE_OPEN_RESPONSE_FIELDS, WIRE_FILE_REFERENCE_FIELDS, WIRE_FILE_STAT_MAX, WIRE_FILE_STAT_OK_FIELDS, WIRE_FILE_STAT_REFUSED_FIELDS, WIRE_FILE_STAT_RESPONSE_FIELDS, WIRE_FILE_TEXT_RESPONSE_FIELDS, WIRE_FORGET_WORKSPACE_FIELDS, WIRE_FORGET_WORKSPACE_RESPONSE_FIELDS, WIRE_GOAL_ACTIONS, WIRE_GOAL_BLOCK_FIELDS, WIRE_GOAL_CLEAR_FIELDS, WIRE_GOAL_CREATE_FIELDS, WIRE_GOAL_FIELDS, WIRE_GOAL_LIMITS_FIELDS, WIRE_GOAL_PHASES, WIRE_GOAL_REFUSALS, WIRE_GOAL_RESPONSE_FIELDS, WIRE_GOAL_WRITE_FIELDS, WIRE_HEALTH_FIELDS, WIRE_IMAGE_REFERENCE_FIELDS, WIRE_KNOWN_WORKSPACE_FIELDS, WIRE_LANG_PARAM, WIRE_LAST_SESSION_FIELDS, WIRE_LAST_SESSION_RESPONSE_FIELDS, WIRE_MANAGED_LOCK_FIELDS, WIRE_MCP_ADD_FIELDS, WIRE_MCP_ADD_RESPONSE_FIELDS, WIRE_MCP_APPLY_ENTRY_FIELDS, WIRE_MCP_APPLY_RESPONSE_FIELDS, WIRE_MCP_CONFIG_APPLY_FIELDS, WIRE_MCP_CONFIG_FIELDS, WIRE_MCP_CONFIG_ISSUE_FIELDS, WIRE_MCP_CONFIG_SAVE_FIELDS, WIRE_MCP_CONFIG_SAVE_RESPONSE_FIELDS, WIRE_MCP_CONNECTOR_FIELDS, WIRE_MCP_RECONNECT_FIELDS, WIRE_MESSAGE_LIST_FIELDS, WIRE_MODEL_ENTRIES_FIELDS, WIRE_MODEL_ENTRY_MODELS_FIELDS, WIRE_MODEL_ENTRY_SAVE_FIELDS, WIRE_MODEL_ENTRY_TEST_FIELDS, WIRE_MODEL_FIELDS, WIRE_MODEL_SELECTION_FIELDS, WIRE_MODEL_SET_FIELDS, WIRE_PATCH_SESSION_FIELDS, WIRE_PATCH_SESSION_RESPONSE_FIELDS, WIRE_PERMISSION_RULE_FIELDS, WIRE_PERMISSION_SET_REQUEST_FIELDS, WIRE_PERMISSION_SET_RESPONSE_FIELDS, WIRE_PERMISSION_SHADOW_FIELDS, WIRE_PERMISSION_STATE_FIELDS, WIRE_PERMISSION_STATUS_FIELDS, WIRE_PLAN_ACTIONS, WIRE_PLAN_FIELDS, WIRE_PLAN_MODE_REQUEST_FIELDS, WIRE_PLAN_MODE_RESPONSE_FIELDS, WIRE_PLAN_MODE_STATE_FIELDS, WIRE_PLUGINS_FIELDS, WIRE_PLUGIN_ACTION_FIELDS, WIRE_PLUGIN_ARCHIVE_SUFFIXES, WIRE_PLUGIN_INSTALL_FIELDS, WIRE_PLUGIN_LOCAL_FIELDS, WIRE_PLUGIN_LOCAL_INSTALL_FIELDS, WIRE_PLUGIN_MARKETPLACE_FIELDS, WIRE_PLUGIN_MARKETPLACE_RESPONSE_FIELDS, WIRE_PLUGIN_NAME_FIELDS, WIRE_PLUGIN_PREVIEW_FIELDS, WIRE_PLUGIN_PREVIEW_RESPONSE_FIELDS, WIRE_PLUGIN_REFRESH_RESPONSE_FIELDS, WIRE_PLUGIN_STAGE_FIELDS, WIRE_PLUGIN_STAGE_RESPONSE_FIELDS, WIRE_PLUGIN_TOGGLE_FIELDS, WIRE_PLUGIN_UPDATE_FIELDS, WIRE_PLUGIN_UPLOAD_CONFIRM_FIELDS, WIRE_PLUGIN_UPLOAD_FIELDS, WIRE_PLUGIN_UPLOAD_FORM_FIELDS, WIRE_PLUGIN_UPLOAD_PREVIEW_RESPONSE_FIELDS, WIRE_PLUGIN_UPLOAD_RESPONSE_FIELDS, WIRE_PLUGIN_VIEW_FIELDS, WIRE_PLUGIN_VIEW_RESPONSE_FIELDS, WIRE_POLICY_DIR_FIELDS, WIRE_POLICY_STATUS_FIELDS, WIRE_PROJECT_INVENTORY_FIELDS, WIRE_PROVIDER_GROUPS, WIRE_QUESTION_LIST_FIELDS, WIRE_QUESTION_ROW_FIELDS, WIRE_RESPOND_APPROVAL_FIELDS, WIRE_RESPOND_APPROVAL_RESPONSE_FIELDS, WIRE_RESPOND_QUESTION_FIELDS, WIRE_RESPOND_QUESTION_RESPONSE_FIELDS, WIRE_REVIVE_FIELDS, WIRE_REWIND_FILE_PLAN_FIELDS, WIRE_REWIND_OUTCOME_FIELDS, WIRE_REWIND_PREVIEW_FIELDS, WIRE_REWIND_REQUEST_FIELDS, WIRE_REWIND_RESPONSE_FIELDS, WIRE_REWIND_SCOPES, WIRE_ROLES_FIELDS, WIRE_ROLE_ADD_FIELDS, WIRE_ROLE_ADD_RESPONSE_FIELDS, WIRE_ROLE_REMOVE_FIELDS, WIRE_RUNNING_SCHEDULE_FIELDS, WIRE_SANDBOX_STATUS_FIELDS, WIRE_SCHEDULE_CAPABILITY_FIELDS, WIRE_SCHEDULE_CREATE_FIELDS, WIRE_SCHEDULE_DEFAULTS_FIELDS, WIRE_SCHEDULE_DELETE_FIELDS, WIRE_SCHEDULE_FIELDS, WIRE_SCHEDULE_FIX_FIELDS, WIRE_SCHEDULE_FIX_REQUEST_FIELDS, WIRE_SCHEDULE_ISSUE_CODES, WIRE_SCHEDULE_LIST_FIELDS, WIRE_SCHEDULE_PENDING_FIELDS, WIRE_SCHEDULE_RECORDING_FIELDS, WIRE_SCHEDULE_ROW_FIELDS, WIRE_SCHEDULE_RUNNING_FIELDS, WIRE_SCHEDULE_RUNS_FIELDS, WIRE_SCHEDULE_RUN_FIELDS, WIRE_SCHEDULE_SAVE_FIELDS, WIRE_SECURITY_FIELDS, WIRE_SECURITY_WORKSPACE_FIELDS, WIRE_SEND_MESSAGE_FIELDS, WIRE_SEND_MESSAGE_RESPONSE_FIELDS, WIRE_SESSION_BRANCH_RESPONSE_FIELDS, WIRE_SESSION_CANDIDATES_FIELDS, WIRE_SESSION_CANDIDATE_FIELDS, WIRE_SESSION_FINISH_FIELDS, WIRE_SESSION_LIST_FIELDS, WIRE_SESSION_REFERENCE_FIELDS, WIRE_SESSION_RESPONSE_FIELDS, WIRE_SESSION_SUMMARY_FIELDS, WIRE_SESSION_WORKSPACE_FIELDS, WIRE_SESSION_WORKSPACE_RESPONSE_FIELDS, WIRE_SETTINGS_FIELDS, WIRE_SETTINGS_WRITE_FIELDS, WIRE_SETTINGS_WRITE_REQUEST_FIELDS, WIRE_SETTING_PENDING_FIELDS, WIRE_SETTING_ROW_FIELDS, WIRE_SETTING_STEP_FIELDS, WIRE_SETTING_WRITE_FIELDS, WIRE_SETTING_WRITE_LAYERS, WIRE_SKILL_BODY_FIELDS, WIRE_SKILL_DROP_SUFFIXES, WIRE_SKILL_FIELDS, WIRE_SKILL_IMPORT_FIELDS, WIRE_SKILL_IMPORT_PREVIEW_FIELDS, WIRE_SKILL_REMOVE_FIELDS, WIRE_SKILL_STAGE_FIELDS, WIRE_TASKS_FIELDS, WIRE_TEAM_FIELDS, WIRE_TOOLS_FIELDS, WIRE_TOOL_GATE_FIELDS, WIRE_TOOL_ROW_FIELDS, WIRE_TRUST_REQUEST_FIELDS, WIRE_TRUST_REQUEST_RESPONSE_FIELDS, WIRE_WITHDRAW_MESSAGE_FIELDS, WIRE_WORKSPACE_DIFF_FIELDS, WIRE_WORKSPACE_DIRS_FIELDS, WIRE_WORKSPACE_DIR_ENTRY_FIELDS, WIRE_WORKSPACE_REF_FIELDS, accentScale, agentMessageLine, apiKeyEnvVar, appearanceInlineVars, appearanceRootAttributes, appearanceVisualCss, approvalPolicyForLevel, assertNeverPart, assistantTurnText, attachSessionSurface, chordId, collectPendingApprovals, compressionThresholdTokens, conformsToWire, contentToText, cronTimes, diagnosticToLine, encodeAppearanceFirstScreenValue, entryDisplayName, entryRef, entrySecretName, extractAllMentions, extractMentions, extractSessionMentions, filePartSummary, fillPlaceholders, flattenCatalog, formatAppearanceTranslucent, formatMoney, getProviderInfo, hasFailure, hexToHsv, hsvToHex, imagePartOmittedSummary, isAppearanceAccent, isAppearanceAccentValue, isAppearanceBackground, isAppearanceBackgroundFit, isAppearanceBackgroundKind, isAppearanceCodeFont, isAppearanceCodeFontSize, isAppearanceContrast, isAppearanceDiffTreeWidth, isAppearanceFontSize, isAppearanceLang, isAppearanceModePatch, isAppearanceMotion, isAppearanceSidebarWidth, isAppearanceTheme, isAppearanceThemeName, isAppearanceTranslucent, isAppearanceUiFont, isApprovalOutcome, isContextNearlyFull, isCurrency, isEntrySecretName, isHeadlessInputFormat, isHeadlessLifecycleEvent, isHeadlessOutputFormat, isHexColor, isKeyAction, isLang, isMentionableFilePath, isModelEntryId, isOpenableLink, isOperationType, isPermissionLevel, isPlanOutcome, isPromptOversize, isProviderType, isQuestionAnswerMap, isReasoningEffort, isSearchProviderType, isSettingsPaneId, isValidAgentRoleName, isValidCommandName, isWireGoalPhase, isWireHubEvent, isWirePlanAction, isWirePluginArchiveName, isWireRewindScope, isWireSettingWriteLayer, isWireSkillDropName, joinUploadMulti, makeTranslate, mcpConnectorState, normalizeAppearanceTranslucent, normalizeApproval, offloadedImagePart, packSessionSurface, parseAppearanceTranslucentText, parseChord, parseModelRef, parseSequence, perAction, placeholdersOf, promptTokens, relativeLuminance, resolveAppearanceVisual, resolveHostText, resolvePermissionLevel, sequenceId, sessionPartSummary, sessionSenderLabel, snapAppearanceContrast, splitUploadMulti, stripSystemNote, systemNote, tableOf, totalUsageTokens, translatorFor, truncateToBudget, turnDigest, unfixedRules, utf8ByteLength, wireFields };
+export { ACTION_CONTEXTS, AGENT_MESSAGE_NOTE_TITLE, AGENT_ROLE_NAME_PATTERN, API_KEY_ENV_VARS, APPEARANCE_ACCENTS, APPEARANCE_BACKGROUND_FITS, APPEARANCE_BACKGROUND_KINDS, APPEARANCE_BACKGROUND_ON_PARAM, APPEARANCE_CODE_FONTS, APPEARANCE_CODE_FONT_SIZE, APPEARANCE_CONTRAST, APPEARANCE_DEFAULT_CODE_FONT_SIZE, APPEARANCE_DEFAULT_FONT_SIZE, APPEARANCE_DIFF_TREE_WIDTH, APPEARANCE_FIRST_SCREEN_FIELDS, APPEARANCE_FIRST_SCREEN_FIELD_ORDER, APPEARANCE_FONT_SIZE, APPEARANCE_LANGS, APPEARANCE_MOTION, APPEARANCE_ROOT_ATTRIBUTES, APPEARANCE_SIDEBAR_WIDTH, APPEARANCE_THEMES, APPEARANCE_THEME_NAME_MAX, APPEARANCE_TRANSLUCENT, APPEARANCE_UI_FONTS, APPROVAL_OUTCOMES, APPROVAL_POLICIES, BRAND_WHEN_SIDEBAR_COLLAPSED, COMMAND_NAME_PATTERN, COMPLIANCE_ACTIONS, COMPLIANCE_CATEGORIES, CURRENCIES, DEFAULT_AGENT_ROLE, DEFAULT_LANG, DEFAULT_PERMISSION_LEVEL, DiagnosticSink, ENTRY_REF_PREFIX, ENTRY_SECRET_PREFIX, FOLLOW_SYSTEM, GEN_AI, HEADLESS_INPUT_EVENT_TYPES, HEADLESS_INPUT_FORMATS, HEADLESS_OUTPUT_FORMATS, HEADLESS_PROTOCOL_VERSION, KEY_ACTIONS, LANGS, LEAD_AGENT_ID, LEGACY_LEVEL_ALIASES, LINK_CLICKED_MESSAGE_TYPE, MAX_ATTACH_BYTES, MAX_ATTACH_FILES, MAX_ATTACH_TOTAL_BYTES, MAX_HEADER_CHARS, MAX_LINK_URL, MAX_OPTIONS, MAX_QUESTIONS, MAX_SESSION_ATTACH_BYTES, MAX_SESSION_REFS, MCP_DATA_KEY_NAME, METRIC, MIN_OPTIONS, MODEL_ENTRY_PROTOCOLS, NOOP_TELEMETRY, OFFLOADED_IMAGE_NOTE, OPENABLE_LINK_SCHEMES, OPEN_SETTINGS_MESSAGE_TYPE, OPERATION_TYPES, OVERSIZE_RATIO, PERMISSION_LEVELS, PLAN_OUTCOMES, PLUGIN_CATEGORY_DISPLAY_SEP, PLUGIN_MENU_MESSAGE_TYPE, PLUGIN_PREVIEW_STREAM_MIME, PLUGIN_UPLOAD_MULTI_SEP, PROVIDER_INFOS, PROVIDER_TYPES, REASONING_EFFORTS, REASONING_OFF, RESERVED_CHORDS, RESERVED_COMMAND_NAMES, SCHEDULE_CONFIRM_PLACEHOLDER, SCHEDULE_DEFAULT_PERMISSION, SCHEDULE_DRAFT_SAVED_MARK, SCHEDULE_DRAFT_TOOL, SCHEDULE_INTERVAL_MAX_MINUTES, SCHEDULE_INTERVAL_MIN_MINUTES, SCHEDULE_MAX_TIMES_PER_DAY, SCHEDULE_RUN_STATUSES, SEARCH_API_KEY_ENV, SEARCH_PROVIDER_TYPES, SECRET_SERVICE, SEQUENCE_CONTEXTS, SESSION_MENTION_PREFIX, SESSION_REFERENCE_ERROR_CODES, SETTINGS_PANE_IDS, SHELL_KINDS, SIDEBAR_MENU_MESSAGE_TYPE, SIMULTANEOUS_CONTEXTS, SYSTEM_NOTE_PREFIX, ToolExposure, UNLIMITED_TURNS, USER_MENU_MESSAGE_TYPE, WIRE_ABORT_FIELDS, WIRE_ABOUT_FIELDS, WIRE_AGENT_ROLE_FIELDS, WIRE_APPEARANCE_RESPONSE_FIELDS, WIRE_APPROVAL_CACHE_REVOKE_REQUEST_FIELDS, WIRE_APPROVAL_CACHE_REVOKE_RESPONSE_FIELDS, WIRE_APPROVAL_LIST_FIELDS, WIRE_APPROVAL_ROW_FIELDS, WIRE_ARTIFACTS_FIELDS, WIRE_ATTACHMENT_FOLDER_FIELDS, WIRE_ATTACHMENT_UPLOAD_FIELDS, WIRE_AUDIT_LOG_FIELDS, WIRE_AUDIT_ROW_FIELDS, WIRE_AUTH_COOKIE, WIRE_AUTH_COOKIE_ATTRS, WIRE_AUTH_TOKEN_PARAM, WIRE_BACKGROUND_TASK_FIELDS, WIRE_BLOCKED_GOALS_FIELDS, WIRE_BLOCKED_GOAL_FIELDS, WIRE_BLOCKED_LEVEL_FIELDS, WIRE_BUILTIN_CONNECTOR_FIELDS, WIRE_CACHED_APPROVAL_FIELDS, WIRE_CAPABILITIES_FIELDS, WIRE_CAPABILITY_PROJECT_FIELDS, WIRE_CHECKPOINT_LIST_FIELDS, WIRE_CHECKPOINT_SUMMARY_FIELDS, WIRE_COMMANDS_FIELDS, WIRE_COMMAND_EXPANSION_FIELDS, WIRE_COMPACT_FIELDS, WIRE_COMPRESSION_LINE_FIELDS, WIRE_CONFIG_FIELDS, WIRE_CONTEXT_FIELDS, WIRE_CREATE_SESSION_FIELDS, WIRE_CREATE_WORKSPACE_FIELDS, WIRE_CREATE_WORKSPACE_RESPONSE_FIELDS, WIRE_CUSTOM_COMMAND_FIELDS, WIRE_DELETE_SESSION_FIELDS, WIRE_DIFF_FILE_FIELDS, WIRE_DIFF_FILE_RESPONSE_FIELDS, WIRE_ERROR_FIELDS, WIRE_FILE_CANDIDATES_FIELDS, WIRE_FILE_CANDIDATE_FIELDS, WIRE_FILE_CHANGE_FIELDS, WIRE_FILE_OPEN_RESPONSE_FIELDS, WIRE_FILE_REFERENCE_FIELDS, WIRE_FILE_STAT_MAX, WIRE_FILE_STAT_OK_FIELDS, WIRE_FILE_STAT_REFUSED_FIELDS, WIRE_FILE_STAT_RESPONSE_FIELDS, WIRE_FILE_TEXT_RESPONSE_FIELDS, WIRE_FORGET_WORKSPACE_FIELDS, WIRE_FORGET_WORKSPACE_RESPONSE_FIELDS, WIRE_GOAL_ACTIONS, WIRE_GOAL_BLOCK_FIELDS, WIRE_GOAL_CLEAR_FIELDS, WIRE_GOAL_CREATE_FIELDS, WIRE_GOAL_FIELDS, WIRE_GOAL_LIMITS_FIELDS, WIRE_GOAL_PHASES, WIRE_GOAL_REFUSALS, WIRE_GOAL_RESPONSE_FIELDS, WIRE_GOAL_WRITE_FIELDS, WIRE_HEALTH_FIELDS, WIRE_IMAGE_REFERENCE_FIELDS, WIRE_KNOWN_WORKSPACE_FIELDS, WIRE_LANG_PARAM, WIRE_LAST_SESSION_FIELDS, WIRE_LAST_SESSION_RESPONSE_FIELDS, WIRE_MANAGED_LOCK_FIELDS, WIRE_MCP_ADD_FIELDS, WIRE_MCP_ADD_RESPONSE_FIELDS, WIRE_MCP_APPLY_ENTRY_FIELDS, WIRE_MCP_APPLY_RESPONSE_FIELDS, WIRE_MCP_CONFIG_APPLY_FIELDS, WIRE_MCP_CONFIG_FIELDS, WIRE_MCP_CONFIG_ISSUE_FIELDS, WIRE_MCP_CONFIG_SAVE_FIELDS, WIRE_MCP_CONFIG_SAVE_RESPONSE_FIELDS, WIRE_MCP_CONNECTOR_FIELDS, WIRE_MCP_RECONNECT_FIELDS, WIRE_MESSAGE_LIST_FIELDS, WIRE_MODEL_ENTRIES_FIELDS, WIRE_MODEL_ENTRY_MODELS_FIELDS, WIRE_MODEL_ENTRY_SAVE_FIELDS, WIRE_MODEL_ENTRY_TEST_FIELDS, WIRE_MODEL_FIELDS, WIRE_MODEL_SELECTION_FIELDS, WIRE_MODEL_SET_FIELDS, WIRE_PATCH_SESSION_FIELDS, WIRE_PATCH_SESSION_RESPONSE_FIELDS, WIRE_PERMISSION_RULE_FIELDS, WIRE_PERMISSION_SET_REQUEST_FIELDS, WIRE_PERMISSION_SET_RESPONSE_FIELDS, WIRE_PERMISSION_SHADOW_FIELDS, WIRE_PERMISSION_STATE_FIELDS, WIRE_PERMISSION_STATUS_FIELDS, WIRE_PLAN_ACTIONS, WIRE_PLAN_FIELDS, WIRE_PLAN_MODE_REQUEST_FIELDS, WIRE_PLAN_MODE_RESPONSE_FIELDS, WIRE_PLAN_MODE_STATE_FIELDS, WIRE_PLUGINS_FIELDS, WIRE_PLUGIN_ACTION_FIELDS, WIRE_PLUGIN_ARCHIVE_SUFFIXES, WIRE_PLUGIN_INSTALL_FIELDS, WIRE_PLUGIN_LOCAL_FIELDS, WIRE_PLUGIN_LOCAL_INSTALL_FIELDS, WIRE_PLUGIN_MARKETPLACE_FIELDS, WIRE_PLUGIN_MARKETPLACE_RESPONSE_FIELDS, WIRE_PLUGIN_NAME_FIELDS, WIRE_PLUGIN_PREVIEW_FIELDS, WIRE_PLUGIN_PREVIEW_RESPONSE_FIELDS, WIRE_PLUGIN_REFRESH_RESPONSE_FIELDS, WIRE_PLUGIN_STAGE_FIELDS, WIRE_PLUGIN_STAGE_RESPONSE_FIELDS, WIRE_PLUGIN_TOGGLE_FIELDS, WIRE_PLUGIN_UPDATE_FIELDS, WIRE_PLUGIN_UPLOAD_CONFIRM_FIELDS, WIRE_PLUGIN_UPLOAD_FIELDS, WIRE_PLUGIN_UPLOAD_FORM_FIELDS, WIRE_PLUGIN_UPLOAD_PREVIEW_RESPONSE_FIELDS, WIRE_PLUGIN_UPLOAD_RESPONSE_FIELDS, WIRE_PLUGIN_VIEW_FIELDS, WIRE_PLUGIN_VIEW_RESPONSE_FIELDS, WIRE_POLICY_DIR_FIELDS, WIRE_POLICY_STATUS_FIELDS, WIRE_PROJECT_INVENTORY_FIELDS, WIRE_PROVIDER_GROUPS, WIRE_QUESTION_LIST_FIELDS, WIRE_QUESTION_ROW_FIELDS, WIRE_RESPOND_APPROVAL_FIELDS, WIRE_RESPOND_APPROVAL_RESPONSE_FIELDS, WIRE_RESPOND_QUESTION_FIELDS, WIRE_RESPOND_QUESTION_RESPONSE_FIELDS, WIRE_REVEAL_WORKSPACE_FIELDS, WIRE_REVEAL_WORKSPACE_RESPONSE_FIELDS, WIRE_REVIVE_FIELDS, WIRE_REWIND_FILE_PLAN_FIELDS, WIRE_REWIND_OUTCOME_FIELDS, WIRE_REWIND_PREVIEW_FIELDS, WIRE_REWIND_REQUEST_FIELDS, WIRE_REWIND_RESPONSE_FIELDS, WIRE_REWIND_SCOPES, WIRE_ROLES_FIELDS, WIRE_ROLE_ADD_FIELDS, WIRE_ROLE_ADD_RESPONSE_FIELDS, WIRE_ROLE_REMOVE_FIELDS, WIRE_RUNNING_SCHEDULE_FIELDS, WIRE_SANDBOX_STATUS_FIELDS, WIRE_SCHEDULE_CAPABILITY_FIELDS, WIRE_SCHEDULE_CREATE_FIELDS, WIRE_SCHEDULE_DEFAULTS_FIELDS, WIRE_SCHEDULE_DELETE_FIELDS, WIRE_SCHEDULE_FIELDS, WIRE_SCHEDULE_FIX_FIELDS, WIRE_SCHEDULE_FIX_REQUEST_FIELDS, WIRE_SCHEDULE_ISSUE_CODES, WIRE_SCHEDULE_LIST_FIELDS, WIRE_SCHEDULE_PENDING_FIELDS, WIRE_SCHEDULE_RECORDING_FIELDS, WIRE_SCHEDULE_ROW_FIELDS, WIRE_SCHEDULE_RUNNING_FIELDS, WIRE_SCHEDULE_RUNS_FIELDS, WIRE_SCHEDULE_RUN_FIELDS, WIRE_SCHEDULE_SAVE_FIELDS, WIRE_SECURITY_FIELDS, WIRE_SECURITY_WORKSPACE_FIELDS, WIRE_SEND_MESSAGE_FIELDS, WIRE_SEND_MESSAGE_RESPONSE_FIELDS, WIRE_SESSION_BRANCH_RESPONSE_FIELDS, WIRE_SESSION_CANDIDATES_FIELDS, WIRE_SESSION_CANDIDATE_FIELDS, WIRE_SESSION_FINISH_FIELDS, WIRE_SESSION_LIST_FIELDS, WIRE_SESSION_REFERENCE_FIELDS, WIRE_SESSION_RESPONSE_FIELDS, WIRE_SESSION_SUMMARY_FIELDS, WIRE_SESSION_WORKSPACE_FIELDS, WIRE_SESSION_WORKSPACE_RESPONSE_FIELDS, WIRE_SETTINGS_FIELDS, WIRE_SETTINGS_WRITE_FIELDS, WIRE_SETTINGS_WRITE_REQUEST_FIELDS, WIRE_SETTING_PENDING_FIELDS, WIRE_SETTING_ROW_FIELDS, WIRE_SETTING_STEP_FIELDS, WIRE_SETTING_WRITE_FIELDS, WIRE_SETTING_WRITE_LAYERS, WIRE_SKILL_BODY_FIELDS, WIRE_SKILL_DROP_SUFFIXES, WIRE_SKILL_FIELDS, WIRE_SKILL_IMPORT_FIELDS, WIRE_SKILL_IMPORT_PREVIEW_FIELDS, WIRE_SKILL_REMOVE_FIELDS, WIRE_SKILL_STAGE_FIELDS, WIRE_TASKS_FIELDS, WIRE_TEAM_FIELDS, WIRE_TOOLS_FIELDS, WIRE_TOOL_GATE_FIELDS, WIRE_TOOL_ROW_FIELDS, WIRE_TRUST_REQUEST_FIELDS, WIRE_TRUST_REQUEST_RESPONSE_FIELDS, WIRE_WITHDRAW_MESSAGE_FIELDS, WIRE_WORKSPACE_DIFF_FIELDS, WIRE_WORKSPACE_DIRS_FIELDS, WIRE_WORKSPACE_DIR_ENTRY_FIELDS, WIRE_WORKSPACE_REF_FIELDS, accentScale, agentMessageLine, apiKeyEnvVar, appearanceInlineVars, appearanceRootAttributes, appearanceVisualCss, approvalPolicyForLevel, assertNeverPart, assistantTurnText, attachSessionSurface, chordId, collectPendingApprovals, compressionThresholdTokens, conformsToWire, contentToText, cronTimes, diagnosticToLine, encodeAppearanceFirstScreenValue, entryDisplayName, entryRef, entrySecretName, extractAllMentions, extractMentions, extractSessionMentions, filePartSummary, fillPlaceholders, flattenCatalog, formatAppearanceTranslucent, formatMoney, getProviderInfo, hasFailure, hexToHsv, hsvToHex, imagePartOmittedSummary, isAppearanceAccent, isAppearanceAccentValue, isAppearanceBackground, isAppearanceBackgroundFit, isAppearanceBackgroundKind, isAppearanceCodeFont, isAppearanceCodeFontSize, isAppearanceContrast, isAppearanceDiffTreeWidth, isAppearanceFontSize, isAppearanceLang, isAppearanceModePatch, isAppearanceMotion, isAppearanceSidebarWidth, isAppearanceTheme, isAppearanceThemeName, isAppearanceTranslucent, isAppearanceUiFont, isApprovalOutcome, isContextNearlyFull, isCurrency, isEntrySecretName, isHeadlessInputFormat, isHeadlessLifecycleEvent, isHeadlessOutputFormat, isHexColor, isKeyAction, isLang, isMentionableFilePath, isModelEntryId, isOpenableLink, isOperationType, isPermissionLevel, isPlanOutcome, isPromptOversize, isProviderType, isQuestionAnswerMap, isReasoningEffort, isSearchProviderType, isSettingsPaneId, isValidAgentRoleName, isValidCommandName, isWireGoalPhase, isWireHubEvent, isWirePlanAction, isWirePluginArchiveName, isWireRewindScope, isWireSettingWriteLayer, isWireSkillDropName, joinUploadMulti, makeTranslate, mcpConnectorState, normalizeAppearanceTranslucent, normalizeApproval, offloadedImagePart, packSessionSurface, parseAppearanceTranslucentText, parseChord, parseModelRef, parseSequence, perAction, placeholdersOf, promptTokens, relativeLuminance, resolveAppearanceVisual, resolveHostText, resolvePermissionLevel, sequenceId, sessionPartSummary, sessionSenderLabel, snapAppearanceContrast, splitUploadMulti, stripSystemNote, systemNote, tableOf, totalUsageTokens, translatorFor, truncateToBudget, turnDigest, unfixedRules, utf8ByteLength, wireFields };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epoch-agent/protocol",
-  "version": "3.1.2",
+  "version": "4.0.0",
   "private": false,
   "description": "epoch-agent 契约层：工具 / 事件 / 权限 / 插件的类型定义，零运行时依赖",
   "repository": {