@epoch-agent/protocol 0.20.1 → 0.21.0

package/dist/index.d.ts

@@ -1805,25 +1805,44 @@ declare function formatMoney(usd: number, opts?: FormatMoneyOptions): string;
  * `url`」就只能靠文档说 —— 而宿主配漏了的表现是那一项画出来、点进去一片空白。
  * 多一个类型换一次编译期拦截，值。
  *
- * ## ⚠️ 安全：三条硬规矩，每条都有具体的攻击面
+ * ## ⚠️ 安全：两条硬规矩，每条都有具体的攻击面
  *
  * 这个键是全仓**唯一一个把宿主给的内容画进我们这张页**的地方，所以它的边界不在
  * 「好不好看」上，在这儿。鉴权那一侧的事实（`server/src/auth.ts` 文件头那张表）：
  * **`HttpOnly` + `SameSite=Strict` 的 cookie**，非 GET 还要 `Origin` 与 `Host`
  * 逐字符一致。
  *
- * 1. **同源的 `url` 一律拒画。** 跨站 iframe 拿不到那个 cookie（`SameSite=Strict`），
- *    写操作还过不了 Origin 校验 —— 两道都在。但**同源**的 iframe 两道全绕过：
- *    它带着 cookie、Origin 又天然对得上，于是那一页能调我们全部的 API =
- *    **整套工具权限**（读文件、跑命令）。
- *    ⚠️ **这一条 schema 拦不住**（配置期不知道服务会绑哪个端口），只能在浏览器里
- *    比一次 `location.origin`。判据和落点在 web 的 `settings/host-pane.tsx` 上。
- * 2. **`sandbox` 里不给 `allow-top-navigation`。** 给了的话宿主那一页能把我们整个
+ * 1. **`sandbox` 里不给 `allow-top-navigation`。** 给了的话宿主那一页能把我们整个
  *    导航走，而那会**丢掉输入框里没发出去的那句话**（草稿只在内存里）——
  *    判据逐字是 `sidebar-menu.ts` 当初否掉「每项配一个 `href`」那一条。
  *    ⚠️ `allow-same-origin` 反过来**是必需的**（宿主那一页要用自己的 cookie 做
- *    SSO），它和第 1 条是一套：正因为给了它，才必须把同源那一档挡死。
- * 3. **`referrerpolicy="no-referrer"`** —— 别把本机地址和端口漏给宿主那一页。
+ *    SSO）。
+ * 2. **`referrerpolicy="no-referrer"`** —— 别把本机地址和端口漏给宿主那一页。
+ *
+ * ## ⚠️ 这里原来有第三条：「同源的 `url` 一律拒画」，2026-09-29 整条撤掉了
+ *
+ * 撤掉的原文是：同源 iframe 两道全绕过（它带着我们的 cookie、Origin 又天然对得上），
+ * 于是那一页能调我们全部的 API = **整套工具权限**。判据当时比 `hostname` 而不是
+ * `origin`（cookie 不认端口），所以连换个端口都拦。
+ *
+ * **为什么撤**：那正好是插件在本机 `127.0.0.1:<port>` 上起一页的形态 ——
+ * 留着它等于「本机插件页永远进不了设置页」，而那是嵌入宿主最自然的用法。
+ * 用户 2026-09-29 拍的板是**不限制 url**：宿主给什么嵌什么。
+ *
+ * ⚠️ **代价不是没有，是换了地方，记在这儿**（当时逐条核过）：
+ *
+ * | 那一页还能干什么 | 为什么 |
+ * | --- | --- |
+ * | 带着 cookie **发**请求 | ✅ 能 —— `SameSite=Strict` 按 site 算、**不看端口**，正是原来要拦的那一档 |
+ * | **读**响应 | ❌ 全仓一个 `Access-Control-Allow-Origin` 都没有 |
+ * | **写**任何东西 | ❌ 写操作全是非 GET，而它要 `Origin` 与 `Host` 逐字符一致 |
+ * | 拿 token | ❌ `HttpOnly`，且它读不了我们那个源 |
+ *
+ * 于是**两条承重假设**顶上来（判据全文在 web 的 `settings/host-pane.tsx` 文件头）：
+ * **① `GET` 端点不许有副作用**（带凭据的 GET 会真的执行，只是读不到结果）；
+ * **② 我们自己的源上不内联用户 / 插件可控的 HTML**（工作区文件与 artifact 两张
+ * inline 白名单都排除了 `.html` / `.svg`）。哪天有人破了其中一条，这一格当场变成
+ * 一个真洞。
  *
  * schema 那一侧只做得了粗的：`url` 要 parse 得动、scheme 只收 `http` / `https`
  * （`file:` / `javascript:` 直接拒）。
@@ -1879,9 +1898,9 @@ interface SettingsPaneItem {
      * ⚠️ **只收 `http` / `https`**（core 的 schema 拦）。`javascript:` 是一条执行
      * 入口，`file:` 是本机任意文件 —— 两个都不是「一页内容」。
      *
-     * ⚠️ **和这张页同源的网址会被拒画**，而那一条 schema 拦不住（配置期不知道服务
-     * 绑哪个端口），是浏览器那一侧现比的。全文在文件头第 1 条 —— 一句话：
-     * 同源 iframe 带着我们的 cookie、Origin 又天然对得上，等于把整套工具权限交出去。
+     * ⚠️ **我们不判它指向哪儿**（2026-09-29 起）：同主机、同源、别的域，一律照嵌。
+     * 原来那条「同源的会被拒画」撤了，为什么撤、撤了之后顶上来哪两条承重假设，
+     * 全文在文件头那一段。
      *
      * ⚠️ **我们不往这个地址上加任何东西**：不拼 token、不拼会话 id、不拼语言。
      * 宿主要什么自己写进这个 url 里 —— 我们拼一次就等于替它决定了那一页的接口，
@@ -2846,7 +2865,7 @@ interface EpochConfig {
      * 宿主**自己的**那几个设置分区（2026-09-23）。**缺省 = 设置页里只有我们那九个。**
      *
      * 每一项是「一个 id、一句话、一个网址」，我们在设置页右边那一栏里把那个网址
-     * 用 `<iframe>` 嵌出来。形状、三条安全边界、以及「为什么不共用
+     * 用 `<iframe>` 嵌出来。形状、两条安全边界、以及「为什么不共用
      * {@link SidebarMenuItem}」全文在
      * [settings-pane-item.ts](./settings-pane-item.ts) 的文件头。
      *
@@ -2859,9 +2878,11 @@ interface EpochConfig {
      *
      * 别的几个交出去的都是「屏幕上多几个字、点下去发一条消息」——
      * 去哪儿、画什么全在宿主自己的窗口里。这一个不是：那一页活在我们的文档里。
-     * 所以它有一组别的键都没有的边界，其中最要紧的一条是**同源的网址一律拒画**
-     * （同源 iframe 带着我们的 `HttpOnly` cookie、Origin 又天然对得上，
-     * 等于把整套工具权限交出去）。判据全文在那个文件头第 1 条。
+     * 所以它有一组别的键都没有的边界。⚠️ **原来最要紧的那一条是「同源的网址一律
+     * 拒画」（同源 iframe 带着我们的 `HttpOnly` cookie、Origin 又天然对得上，
+     * 等于把整套工具权限交出去）—— 2026-09-29 整条撤掉了**，因为那正好是插件在本机
+     * `127.0.0.1` 起一页的形态。现在宿主给什么嵌什么，代价换成了两条承重假设
+     * （`GET` 不带副作用、我们自己的源上不内联可控 HTML），全文在那个文件头。
      *
      * ## ⚠️ 差别二：它和 {@link settingsHidden} 是**两个键，互不掺和**
      *
@@ -4078,6 +4099,31 @@ interface EpochMessage {
  * 提问不碰文件、不起进程、不联网。方案 34 §三把 `core/src/permission/**`
  * 列进禁止触碰，就是这个意思 —— 给它加一道权限判定，等于让 `deny` 规则能把
  * 「问一句」拦掉，而拦掉的表现是模型继续瞎猜。
+ *
+ * ## 页面位（{@link QuestionItem.page}，2026-09-29 加）
+ *
+ * 有些选择用几个选项说不清（几十张图里挑一张、一张表格里圈几行），插件会在
+ * 本机起一张页。这一格让那一页**嵌进 dock 里**，用户不用切到浏览器去。
+ *
+ * 四件事定在这儿，渲染那一侧的细节在 web 的 `dock/question.tsx` 文件头：
+ *
+ * 1. **它是附加的，不替代 `options`。** 选项仍然 2–4 个必填 —— 终端里画不出
+ *    iframe，让页面替代选项的话 TUI 在这一问上**一个可画的东西都不剩**，
+ *    只能新增一条「自己开链接 / 跳过」的分支。
+ * 2. 🔴 **`url` 只收本机回环**（`127.0.0.1` / `localhost`）。⚠️ 这一格和
+ *    `EpochConfig.settingsPanes` 那个 iframe **表面像、安全口径相反**：
+ *    那边的 url 来自**用户自己写的 `config.yaml`**，所以「给什么嵌什么」站得住；
+ *    这边来自**模型参数**，而模型的上下文里有工具输出、网页、插件返回值 ——
+ *    那是可注入的。同一个 iframe，决策者从「用户」换成了「模型」。
+ *    闸的落点在 core 的 `parseQuestion`，用例在 `ask-question.test.ts`。
+ * 3. **答案由页面送回父文档**（`window.parent.postMessage`），再由 dock 走
+ *    今天那条 `POST /api/questions/:requestId` 回去。刻意**不走**插件那条
+ *    「自己 POST 回子进程 + `_wait`」的路（plugin-kit §4.4）—— 那条路要能把
+ *    结果交回引擎，得新造一条「插件进程 → 引擎」的反向链，而 dock 还挂在
+ *    屏幕上（引擎侧 `ask_user_question` 仍阻塞着）。
+ * 4. **它只能递一个答案。** 真正的写操作仍然由模型调插件的工具去执行
+ *    （于是多一次审批框）。这是代价，也是它保住的那条线：
+ *    **模型是唯一发起工具调用的角色**。
  */
 /** 一个选项。**没有「其他」** —— 自由输入由宿主自动提供，不占模型的选项额度 */
 interface QuestionOption {
@@ -4086,6 +4132,37 @@ interface QuestionOption {
     /** 这个选项意味着什么 / 选了会发生什么 */
     description: string;
 }
+/**
+ * 嵌在某一问旁边的一张页面（{@link QuestionItem.page}）。
+ *
+ * 来源是**插件在本机起的一张页**（plugin-kit §4.4）：插件把地址交给模型，
+ * 模型放进这一格。它**不是** `EpochConfig.settingsPanes` 那一族 ——
+ * 那一个是宿主配的、常驻的；这一个随一次提问出现，答完就没了。
+ */
+interface QuestionPage {
+    /**
+     * 那一页的地址。**只能是本机回环**：`127.0.0.1` 或 `localhost`，http / https
+     * 都收（端口不限）。
+     *
+     * ⚠️ **那道闸不在这儿。** 类型挡得住写代码的人，挡不住运行时来的字符串 ——
+     * 真正的校验在 `core/src/tools/builtin/ask-question.ts` 的 `parseQuestion` 里，
+     * 判据见文件头第二节。插件起页本来就要绑 `127.0.0.1`（plugin-kit §4.4 坑 1），
+     * 所以这道闸不挡任何真实用法。
+     *
+     * ⚠️ **我们不往这个地址上加任何东西**：不拼 token、不拼会话 id、不拼语言。
+     * 同 `SettingsPaneItem.url` 那条 —— 拼一次就等于替插件决定了那一页的接口，
+     * 而它改不掉。插件那侧那段一次性随机 token 正是这么自己带上的。
+     */
+    url: string;
+    /**
+     * 页面上显示的那几个字（dock 里那行标识用的）。不给 = 落一句通用文案。
+     *
+     * ⚠️ 和 `SettingsPaneItem.label` 不同的地方：那一个是**宿主给的名字**，
+     * 而且配它的时候人就在场；这一个是**模型填的**，所以它和 `header` 同族
+     * ——**不过 i18n catalog**，模型给什么就是什么。
+     */
+    label?: string;
+}
 /** 一个问题 */
 interface QuestionItem {
     /** 完整问句，带问号 */
@@ -4096,6 +4173,17 @@ interface QuestionItem {
     options: QuestionOption[];
     /** 多选（答案是数组）还是单选（答案是一个字符串） */
     multiSelect: boolean;
+    /**
+     * 这一问还可以嵌一张页面（插件在本机起的）。**附加，不是替代 `options`**。
+     *
+     * 不给 = 今天那个纯选项的形态（绝大多数提问）。给 = dock 在正文区多画一个
+     * `<iframe>`，用户在页面上操作完，答案经 `postMessage` 回到父文档、
+     * 由 dock 走 `POST /api/questions/:requestId` 交回引擎。
+     *
+     * ⚠️ **它的来源是模型参数，不是用户写的配置** —— 所以 `url` 有一道 host 闸，
+     * 全文在文件头那一节。
+     */
+    page?: QuestionPage;
 }
 /**
  * 一次结构化提问。
@@ -6711,16 +6799,73 @@ type WireHubEvent =
  * 飞书宿主的原话逐字同形。产地在 `server/src/api.ts` 的 `patchSession`，
  * **只在 `archived` 真的翻了的时候发**。
  *
- * ## ⚠️ 覆盖不到的那一档：**标题改了仍然不发这一帧**
+ * ## ⚠️ 覆盖不到的那**一档**：置顶，不发这一帧
  *
- * 同一条端点上的另一半：改标题不改变「列哪几段」，只改变某一行上的一格。
- * 于是另一个标签页上那一行的标题仍然会过期到下一次重取。📮 那一档要治得给它
- * 自己的产地（一帧带得动「哪一行的哪一格变了」的事件），别顺手挂到这一帧上 ——
- * 让所有标签页因为别人改了个名字就重取一次整份列表，是拿错误的粒度换方便。
+ * **改标题曾经是这一档的第一半，2026-09-29 搬走了** —— 它拿到了自己的帧
+ * （`session-title-changed`）。判据一个字没变，变的是有人把那个产地建了出来：
+ * 那一帧带得动「**哪一行的哪一格变了**」，于是这一帧不必再替那一格兜底。
+ *
+ * **置顶**仍然不发：它同样不改变「列哪几段」—— 它改的是**顺序**：那一行排在
+ * 它所属那一组的最前，成员一个不多一个不少。
+ *
+ * 📮 要治得给它自己的产地（一帧带得动「这一页的顺序变了」的事件），别顺手
+ * 挂到这一帧上 —— 让所有标签页因为别人置顶了一段会话就重取一次整份列表，
+ * 是拿错误的粒度换方便。⚠️ 这一条现在读作「**还没人去建那个产地**」而不是
+ * 「治不了」：改标题那一半走的就是这条路，照它抄一遍即可。
+ *
+ * ⚠️ 置顶那一档的过期**看得见、但不会骗人**：那一行还在列表里、点得开、
+ * 内容也对，只是位置旧了一拍；而按下去的那一页自己会重取
+ * （`SessionActs.reload`），它当场就是对的。
  */
  | {
     type: 'sessions-changed';
 }
+/**
+ * **某一行上的标题变了**（2026-09-29）。
+ *
+ * ## 它治的是什么
+ *
+ * 会话标题在**按下发送那一刻就落库了**（`core` 的 `session/manager.ts` 拿首条
+ * user 消息截前 50 字，`!meta.title` 那一句保证一辈子只写一次）。但事件流上从来
+ * 没有「这一格变了」这一帧 —— 于是侧栏那一行和顶栏那个 `h1` 只能靠**重取列表**
+ * 才第一次知道它已经不是「未命名会话」了。
+ *
+ * 而 `refresh.ts` 那四个重取时刻没有一个覆盖「一轮跑着跑着标题长出来了」：
+ * 时刻二要求你**正好在这一段上**看着它收口（同一个会话的 running→idle 边沿），
+ * 切走就永不触发。
+ *
+ * 症状（2026-09-29 用户实测）：轮次早跑完了、名字却一直不出现，「切换对话什么的
+ * 点来点去」反倒出来了 —— 那些点击触发的重取把它捡了回来。**名字不是那时候才
+ * 起出来的**，是那时候才被捡回来。
+ *
+ * ## 为什么这一帧**带载荷**（`sessions-changed` 那族不带）
+ *
+ * 那几帧是**纯失效信号**（`tasks-changed` / `plugins-changed`，判据在它们各自的
+ * JSDoc 上）：宾语是「一整张表」，客户端自己答不出新的那份，只能回去重取。
+ *
+ * 这一帧的宾语是**一行上的一格**，真源唯一（DB）、值就在手上 —— 带上它不产生
+ * 第二个真源。反过来，**不带载荷就等于逼客户端重取整份列表**，那还不如直接发
+ * `sessions-changed`；而那条的判据明写着那是拿错误的粒度换方便。
+ * **要么带这一格，要么别发这一帧。**
+ *
+ * ## 信封上那个 `sessionId` 就是这一行
+ *
+ * 和 `session-state` 同族：它说的是「哪一段」，也是这一帧**唯一**的宾语。所以
+ * `reducer.ts` 那边它走 `sessionPatch()` / `overlayRows()`（覆写 `sessions` /
+ * `searchHits` / `currentSummary` 三处），而不是走纯失效信号那条重取的路。
+ *
+ * ⚠️ **别的会话那一行也覆写得到**：`overlayRows` 在「别的会话的帧进 `parked`」
+ * 那句早退**之前**。这正是「标题在别处长出来」那一档要的 —— 你在看 A 段，
+ * B 段那一轮的标题长出来了，侧栏那一行照样得更新。
+ *
+ * ⚠️ **它不替代 `refresh.ts` 的时刻二**：那一条还要兜住旧服务端、以及断线期间
+ * 漏掉的帧。加了这一帧之后它反而变便宜 —— 它的闸是 `currentSummary?.title`，
+ * 这一帧到了那一格就非空，那两发不再打。
+ */
+ | {
+    type: 'session-title-changed';
+    title: string;
+}
 /**
  * **插件那张表变了**（2026-09-24）—— 装 / 更新 / 卸载、市场目录重读过、加 / 移除市场。
  *
@@ -7929,13 +8074,14 @@ interface WireConfigResponse {
     /**
      * 宿主**自己的**那几个设置分区 —— **宿主没配就没有这个键**（2026-09-23）。
      *
-     * 来源是 `EpochConfig.settingsPanes`；形状和三条安全边界全文在
+     * 来源是 `EpochConfig.settingsPanes`；形状和两条安全边界全文在
      * [settings-pane-item.ts](./settings-pane-item.js) 的文件头。
      *
      * ⚠️ **原样转发，服务端一个字都不改**，判据逐字同上面那个 `sidebarMenu` ——
-     * 连 `url` **同不同源也不在这一层判**：这条端点服务着自己画前端的宿主
-     * （EMBEDDING §10），而「同源」是相对**那一张页**说的，服务端不知道它在哪儿。
-     * 判在浏览器里（web 的 `settings/host-pane.tsx`）。
+     * 连 `url` **指向哪儿也不在这一层判**（2026-09-29 起浏览器那一侧也不判了，
+     * 只剩 schema 上那道 http(s)）：这条端点服务着自己画前端的宿主
+     * （EMBEDDING §10），而「那一页能不能嵌」是相对**那一张页**说的，
+     * 服务端不知道它在哪儿。
      */
     settingsPanes?: readonly SettingsPaneItem[];
     /**
@@ -8539,6 +8685,27 @@ interface WireSessionSummary {
      * 而它按定义不可能被归档过（归档写的是 DB 里那一列）。
      */
     archived: boolean;
+    /**
+     * 这段会话被置顶了吗（2026-09-29 接上网线）。
+     *
+     * ## 它不是新加的一格数据，是**终于有人读**那一格
+     *
+     * `sessions.pinned` 从会话库 v1 起就在（`NOT NULL DEFAULT 0`，连
+     * `idx_sessions_pinned` 索引都在），core 的 `SessionSummary.pinned` 和 runtime 的
+     * `SessionControl.setPinned()` 2026-09-20 也补齐了 —— 但那一格**一个消费者都
+     * 没有**，网线上更是一个字都没有。于是它当时唯一的作用是
+     * `pruneCandidates` 里那条「置顶的不参与保留期清理」的豁免。这一格接出来之后，
+     * 侧栏那一行才第一次看得见自己是不是置顶的。
+     *
+     * **必填，不是可选**，理由逐字同上面 `archived`：界面上这一格决定
+     * 「画不画那枚置顶记号」以及「菜单里那一项写『置顶』还是『取消置顶』」，
+     * 而 `undefined` 在那两处都会被读成 `false` —— 于是一段置顶过的会话看起来
+     * 和普通会话一模一样，菜单里那一项还是「置顶」。
+     *
+     * ⚠️ **Hub 里有、DB 里还没有的那种行一律 `false`**，同 `archived` 那条：
+     * 一段还没落盘的会话不可能被置顶过（置顶写的是 DB 里那一列）。
+     */
+    pinned: boolean;
 }
 /**
  * 上面那张接口的必填清单。**要数字段有几个，数这里，别在别处手抄**（抄过去的那份
@@ -8784,19 +8951,21 @@ declare const WIRE_DELETE_SESSION_FIELDS: WireFields<WireDeleteSessionResponse>;
 /**
  * 改一段会话的元信息。
  *
- * ## 「将来」到了（方案 64 PR-2，2026-09-14）
+ * ## 「将来」到了（方案 64 PR-2，2026-09-14）—— 而且是**两次**
  *
  * 上一版这里写着「今天只有 `title` 一个可改字段……将来加 `pinned` / `archived`
  * 时不换形状，那时这里多一个可选字段，老客户端一行不用改」。`archived` 那一格
- * 现在真的来了，而那句预言**兑现了**：老客户端仍然只发 `title`，一个字不用改。
+ * 2026-09-14 来了，`pinned` 那一格 2026-09-29 跟着来了 —— 那句预言**两次都
+ * 兑现了**：老客户端仍然只发 `title`，一个字不用改。兑现它的正是这个形状本身
+ * （「多一个可选字段」），所以别再往这张请求上加必填键。
  *
- * ⚠️ **两个字段都是可选的，但不能一个都不给。** 服务端对「两个都没给」回 400 ——
+ * ⚠️ **几个字段都是可选的，但不能一个都不给。** 服务端对「一个都没给」回 400 ——
  * 一次什么都不改的 PATCH 是调用方写错了，静默回 200 会让它以为改成功了。
  * 判据在 `server/src/api.ts` 的 `patchSession` 上。
  *
  * ⚠️ `title` 仍然**不许是空串**（那条老判据一个字没变）：空标题不是「清空」
  * 而是「没给」—— 标题空着的会话在列表里只剩一个 uuid，而那正是用户点重命名
- * 想解决的问题。要只改归档状态就别带 `title` 这个键。
+ * 想解决的问题。要只改归档 / 置顶状态就别带 `title` 这个键。
  */
 interface WirePatchSessionRequest {
     title?: string;
@@ -8808,14 +8977,34 @@ interface WirePatchSessionRequest {
      * 「全仓唯一一份」的表 —— 那张表这一份只用、不改。
      */
     archived?: boolean;
+    /**
+     * 置顶（`true`）/ 取消置顶（`false`）。
+     *
+     * ## 它和 `archived` 是两件正交的事，不是同一档的两个值
+     *
+     * 归档说的是「**列不列**这段会话」（默认列表不列归档的），置顶说的是
+     * 「**排哪儿**」（排在它自己所属那一组的最前，判据在 web 的 `groupSessions`
+     * 上）。所以这两个键可以同时出现在一次请求里，一段会话也可以同时是置顶的、
+     * 归档的 —— 那组合在界面上是合理的（用户在归档列表里同样要把它排最前）。
+     *
+     * ⚠️ **置顶不是「激活」，它不推进 `updatedAt`。** 判据在 runtime 的
+     * `SessionControl.setPinned` 上（那条「动 = 产生内容或花掉钱」）。所以这一发
+     * 打完，这一行在**按时间排**的那一档里位置不动 —— 变的是排序里置顶那一档。
+     *
+     * ⚠️ `pinned: false` 是一次**真实的取消置顶**，不是「没给」——服务端按
+     * 「键在不在」分档，口径逐字同 `archived`（判据在 `patchSession` 上）。
+     */
+    pinned?: boolean;
 }
 /**
  * ⚠️ **空清单，而且只能是空的。**
  *
  * `wireFields` 收的是**必填**字段（那条约束写在它自己的 JSDoc 第三节上：
  * 可选键写进清单就等于在运行时把它变成必填，于是一个合法的、没带那个字段的
- * 请求会被 `conformsToWire()` 判成不合契约）。这张请求上两个字段都是可选的 ——
- * 只改名的调用方不带 `archived`，只归档的不带 `title`。
+ * 请求会被 `conformsToWire()` 判成不合契约）。这张请求上**三个**字段都是可选的
+ * —— 只改名的调用方不带 `archived` / `pinned`，只归档的不带 `title` / `pinned`，
+ * 只置顶的两个都不带。⚠️ 别在这儿数「几个」：哪天再加第四个键，这句话就该改成
+ * 说清判据（「这张请求上一个必填字段都没有」），而不是把数字往上加一格。
  *
  * 于是「至少给一个」这条约束**没有地方由类型来守**，它由服务端那道 400 守
  * （`server/src/api.ts` 的 `patchSession`）。这是刻意的分工：`wireFields`
@@ -11725,6 +11914,30 @@ interface WirePluginUploadField {
      * 上）：这一格加宽的是**用户能勾几个**，不是值的类型。
      */
     multiple: boolean;
+    /**
+     * 那一格的多选里，树的**第一层最多挑一个**吗（2026-09-29）。**恒有**，判据同上。
+     *
+     * ⚠️ **只在 {@link multiple} 为真时有意义**：单数那一档本来就是「一组里只留一个」，
+     * 再要求「第一层只有一个」是同一句话说第二遍 —— 声明了它而没有声明 `multiple`
+     * 会被 runtime 忽略并发一条启动诊断（判据在 `classifyUploadField` 那张表上）。
+     *
+     * ## ⚠️ 它说的是**第一层**，不是「这一格只能挑一个」
+     *
+     * 开了它之后，第一层挑中哪一条就锁住哪一枝：**别的一级（连同它们底下的二级）
+     * 勾不了，但仍旧点得开** —— 用户的原话是「还能看其他的一级下面有什么」。
+     * 换一级要把当前那条**先取消**（不是勾新的顶掉旧的）：多一步，换来的是那一下
+     * 看得见 —— 旧的那条连同它底下已勾的二级会一起离开值，
+     * 悄悄顶掉的话用户不知道自己刚才丢了什么。
+     *
+     * ⚠️ 锁的是「所属的那一枝」而不是「直接勾过的那一行」：只勾了「办公 / 表格」
+     * 没勾「办公」时，锁住的仍旧是「办公」这一枝（那一条二级的父级）。
+     *
+     * ⚠️ **为什么由宿主声明、而不是界面写死**：这条约束是**那个目录的语义**
+     * （盘古 `plugin/upload` 只收一个 `category`），不是级联控件的通用规则 ——
+     * 另一份目录完全可能允许多个一级。它和 {@link choices} / {@link multiple}
+     * 是同一条规矩的第五半：**别承诺宿主做不到的事**。
+     */
+    singleTop: boolean;
 }
 /**
  * 七格的形态表 —— **每个键恒有，不画的那几格是 `null`**。
@@ -14229,6 +14442,134 @@ interface WireSettingsWriteResponse extends WireSettingPending {
 }
 declare const WIRE_SETTINGS_WRITE_FIELDS: WireFields<WireSettingsWriteResponse>;
 
+/**
+ * 界面外观偏好（主题 / 语言）的值域 + `POST /api/appearance`（2026-09-29）。
+ *
+ * ## 一、值域为什么定义在这儿
+ *
+ * 这一组字面值现在有**四个**消费者，而它们之间没有别的公共祖先：
+ *
+ * | 谁                      | 拿它干什么                                             |
+ * | ----------------------- | ------------------------------------------------------ |
+ * | 第一方界面（`web`）     | 设置页那两行分段器的候选                                |
+ * | 服务端（`server`）      | 首屏 URL 上那两个参数、`POST /api/appearance` 的校验    |
+ * | 引擎（`core`）          | `~/.epoch/appearance.json` 的持久化（坏值当没选过）      |
+ * | 宿主（`createWebServer`）| `ui: { theme, lang }` 这个入参                         |
+ *
+ * `web` 是 `private: true` 的应用包（宿主 import 不到），而 `core` 不许依赖
+ * `web` —— 除了 protocol 没有第三处放得下。翻掉这条的话，「同一个词在三处各写
+ * 一遍」的下场是宿主机给得进、引擎存不下、界面上点不出来，而**没有任何一处会报错**。
+ *
+ * ⚠️ **还有第四份字面量，它注定不能从这儿来**：[web/index.html](../../web/index.html)
+ * 文档头里那段内联脚本。它必须在任何 CSS 之前跑完（防 FOUC），所以它 import 不了
+ * 任何东西 —— 那一份由 `web/__tests__/prefs.test.ts` 读原文钉着相等。
+ *
+ * ## 二、「跟随系统」是三档里的**一个值**，不是「没给」
+ *
+ * `system` 和「这两个键缺席」是两件事，而且两者在行为上刚好相反：
+ *
+ * - **缺席** = 用户还没选过 ⇒ 宿主在 `createWebServer({ ui })` 里给的初值生效
+ * - **`system`** = 用户明确选了跟随系统 ⇒ 宿主的初值**不生效**，界面按
+ *   `prefers-color-scheme` / `navigator.language` 走
+ *
+ * 把 `system` 折成「没给」的话，宿主每次启动都会把用户显式选的跟随系统改成它自己
+ * 那一档 —— 那是「用户的选择活不过一次重启」换了个方向，判据全文在 `core` 的
+ * `appearance.ts` 文件头。
+ *
+ * ## 三、`LANG` 和 `AppearanceLang` **不是一个类型**，别互相赋值
+ *
+ * 前者是「我们支持哪些语言」（`LANGS`，`zh | en`），后者是「偏好有哪几档」
+ * （多一个 `system`）。⚠️ **别把 `system` 塞进 `LANGS`**：`config.yaml` 的
+ * `display.language` 绑的就是它，而写一个不在值域里的值会让
+ * `parseLenient` 产出一条 `config-invalid` 然后**整份配置退默认值**
+ * （provider 和 apiKey 一起没）。外观偏好走的是自己那个文件，**一个字都不写
+ * `config.yaml`** —— 这也是这一轮不把它做成 `display.*` 的原因之一。
+ */
+/**
+ * 「跟随系统」这一档的字面值。主题和语言共用同一个词。
+ *
+ * 它是**偏好**的一个取值，不是**生效值**的取值 —— 生效值只有
+ * `light | dark`（主题）和 `zh | en`（语言），两者是两个东西。
+ */
+declare const FOLLOW_SYSTEM = "system";
+/** 主题偏好那三档，低 → 高无所谓，**顺序就是界面上分段器的顺序** */
+declare const APPEARANCE_THEMES: readonly ["system", "light", "dark"];
+/** 主题偏好。`system` = 跟随 `prefers-color-scheme` */
+type AppearanceTheme = (typeof APPEARANCE_THEMES)[number];
+/**
+ * 语言偏好那三档。**从 `LANGS` 派生**而不是另写一份 `['system','zh','en']`：
+ * 哪天多一个语言，这一格跟着长（同 `bind.ts` 那条「值域跟着 protocol 的 LANGS 走」）。
+ */
+declare const APPEARANCE_LANGS: readonly ["system", "zh", "en"];
+/** 语言偏好。`system` = 跟随 `navigator.language` */
+type AppearanceLang = (typeof APPEARANCE_LANGS)[number];
+declare function isAppearanceTheme(value: unknown): value is AppearanceTheme;
+declare function isAppearanceLang(value: unknown): value is AppearanceLang;
+/**
+ * 一次偏好写入。**只写给了的那几格**（缺席 = 那一格不动），所以这是一次补丁。
+ *
+ * ## 为什么没有 `GET`
+ *
+ * 读这条路已经有了，而且**它必须在第一帧之前就到**：服务端把它拼进首屏 URL
+ * （`?theme=&lang=`），`index.html` 那段内联脚本在第一帧之前读它。再开一条
+ * `GET /api/appearance` 的话，界面会多出第二个「此刻是哪一档」的真源 ——
+ * 而它与 URL 上那一份**天然会不同步**（用户在设置页改完、还没重启时，
+ * 盘上已经是新的、而这一屏按的是刚写下的那个值）。
+ *
+ * 要排查「盘上到底存了什么」，`POST` 的回执原样带回来（{@link WireAppearanceResponse}）。
+ *
+ * ## 为什么是 POST 不是 PUT
+ *
+ * 它**不是幂等的全量替换**：缺席的键意味着「那一格别动」，而同一个 URL 上
+ * 反复提交 `{theme}` 和 `{lang}` 得到的是两种结果。方法名照
+ * `POST /api/sessions/:id/settings` 那条先例走（同样是「改一个/几个键」的补丁）。
+ * 非 GET 这件事本身是硬要求：`auth.ts` 的 Origin 校验只在非安全方法上要求，
+ * 而这条路会往用户磁盘上写文件。
+ *
+ * ## 无会话
+ *
+ * 端点路径上**没有 `:sessionId`**，判据同 `PUT /api/last-session`：落点
+ * `~/.epoch/appearance.json` 是一台机器一份的**进程级**文件，挂到
+ * `/sessions/:id/` 底下会得到一条名字是会话级、行为是机器级的端点。
+ * 而且外观那一屏本来就是**唯一没有会话也画得出来**的分区 ——
+ * 给它加一条「必须先有活会话」的隐含前提，会让「换个主题」在一个没有会话的
+ * 宿主里静默失效（判据全文在 core `appearance.ts` 的文件头第 2 条）。
+ *
+ * ⚠️ **值域由这两个联合说了算**（{@link AppearanceTheme} / {@link AppearanceLang}），
+ * 而服务端**会再校验一遍**（`isAppearanceTheme` / `isAppearanceLang`）——
+ * 客户端那一侧的检查只是为了早说一句，不是判定。
+ */
+interface WireAppearanceRequest {
+    /** 主题偏好。**整个不带这个键 = 这一格不动**（不是「设成跟随系统」） */
+    theme?: AppearanceTheme;
+    /** 语言偏好。同上 */
+    lang?: AppearanceLang;
+}
+/**
+ * 写成功之后的回执：**盘上现在是什么**。
+ *
+ * 不是把请求原样回显 —— 两件不一样的事：请求里缺席的键在盘上有旧值（这一次没
+ * 动它），而回执答的是「这次写完之后那一份」。两个键都缺席 = 盘上还没有任何
+ * 用户偏好（宿主初值仍然生效）。
+ *
+ * 界面那一侧**不看这个回执**（它是 fire-and-forget，写不进去就静默降级，见
+ * `web/src/prefs.ts`）；它给的是**排查的人**和自己画前端的宿主：一条 200 加一份
+ * 实际落盘状态，比让问题在「为什么每次重启都变回去」里查无实据强。
+ */
+interface WireAppearanceResponse {
+    ok: true;
+    /** 盘上的主题偏好。**用户没选过时整个不带这个键** */
+    theme?: AppearanceTheme;
+    /** 盘上的语言偏好。同上 */
+    lang?: AppearanceLang;
+}
+/**
+ * 端点表用的判据。⚠️ **`theme` / `lang` 不在这张表上**：它们是可选键，
+ * 写进来编译不过，见 `wireFields` 那条 ⚠️（这份清单是 `conformsToWire()` 的
+ * 运行时判据，可选键一旦进来，「这一格没给」就会被判成不合契约）。
+ */
+declare const WIRE_APPEARANCE_RESPONSE_FIELDS: WireFields<WireAppearanceResponse>;
+
 /**
  * 此刻生效的那个选择，投影成网线上那一份。和 core 的 `ModelSelection` 逐字同形。
  *
@@ -16103,4 +16444,4 @@ declare const SECRET_SERVICE = "epoch-agent";
  */
 declare const MCP_DATA_KEY_NAME = "mcp-auth-data-key";
 
-export { ACTION_CONTEXTS, AGENT_ROLE_NAME_PATTERN, API_KEY_ENV_VARS, APPROVAL_OUTCOMES, type ActiveAgentRole, type AgentEvent, type AgentEventOf, type AgentEventType, type AgentRole, type AgentRoleScope, type AgentRoleSource, type ApprovalAnswer, type ApprovalOutcome, type ApprovalReply, type ApprovalRequest, type ArtifactKind, type AttributeValue, type Attributes, type BackgroundTaskInfo, type BackgroundTaskKind, type BackgroundTaskStatus, type BlankCard, type BlankGreeting, type BoundKey, type BudgetBreach, COMMAND_NAME_PATTERN, COMPLIANCE_ACTIONS, COMPLIANCE_CATEGORIES, CURRENCIES, type Catalogs, type ComplianceAction, type ComplianceCategory, type ContextBreakdown, type ContextSegment, type Currency, type CurrencyDisplay, type CustomCommandDef, type CustomCommandSource, DEFAULT_AGENT_ROLE, DEFAULT_LANG, type DecidedTrustLevel, type Diagnostic, DiagnosticSink, type DiagnosticStatus, type EpochConfig, type EpochContentPart, 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 EpochUserContent, type ExpandedCommand, 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 JsonSchema, KEY_ACTIONS, type KeyAction, type KeyChord, type KeyContext, type KeySequence, type KeybindingReport, type KeybindingSource, type KeybindingTable, LANGS, type Lang, type LocalizedDetail, type LogFn, MAX_ATTACH_BYTES, MAX_ATTACH_FILES, MAX_ATTACH_TOTAL_BYTES, MAX_HEADER_CHARS, MAX_OPTIONS, MAX_QUESTIONS, MAX_SESSION_ATTACH_BYTES, MAX_SESSION_REFS, MCP_DATA_KEY_NAME, METRIC, MIN_OPTIONS, type MentionSet, type ModelRef, type ModelSelection, type ModelSelectionOrigin, type MoneyDigits, NOOP_TELEMETRY, type NoticeCode, OPERATION_TYPES, OVERSIZE_RATIO, type Operation, type OperationType, PERMISSION_LEVELS, PLAN_OUTCOMES, PLUGIN_CATEGORY_DISPLAY_SEP, PLUGIN_MENU_MESSAGE_TYPE, 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 QuestionRequest, RESERVED_CHORDS, RESERVED_COMMAND_NAMES, type RejectReason, type RejectedKey, type RuleValue, SCHEDULE_DRAFT_TOOL, SCHEDULE_INTERVAL_MINUTES, SCHEDULE_RUN_STATUSES, SCHEDULE_TEMPLATES, 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 ScheduleAllowlist, type ScheduleBackendKind, 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 ScheduleTemplate, type ScheduleTemplateId, 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 SpanLike, type SubToolCall, type SubToolCallResult, 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, type VerifyResult, WIRE_ABORT_FIELDS, WIRE_ABOUT_FIELDS, WIRE_AGENT_ROLE_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_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_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_FIELDS, WIRE_MODEL_SELECTION_FIELDS, WIRE_MODEL_SET_FIELDS, WIRE_MODEL_SUGGESTIONS_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_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_POLICY_DIR_FIELDS, WIRE_POLICY_STATUS_FIELDS, WIRE_PROJECT_INVENTORY_FIELDS, WIRE_PROVIDERS_FIELDS, WIRE_PROVIDER_KEY_FIELDS, WIRE_PROVIDER_MODELS_FIELDS, WIRE_PROVIDER_OPTION_FIELDS, 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_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_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_TOOLS_FIELDS, WIRE_TOOL_GATE_FIELDS, WIRE_TOOL_ROW_FIELDS, WIRE_TRUST_REQUEST_FIELDS, WIRE_TRUST_REQUEST_RESPONSE_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 WireApprovalCacheRevokeRequest, type WireApprovalCacheRevokeResponse, type WireApprovalListResponse, type WireApprovalRequest, type WireArtifactsResponse, 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 WireDiffNote, type WireDiffOmitReason, type WireDiffSource, type WireDiffStatus, 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 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 WireModelProbeStatus, type WireModelRejection, type WireModelResponse, type WireModelSelection, type WireModelSetRequest, type WireModelSetResponse, type WireModelSource, type WireModelSuggestions, 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 WirePluginEntry, type WirePluginHit, type WirePluginHookTally, type WirePluginInstallRequest, type WirePluginLocalInstallRequest, type WirePluginLocalRequest, type WirePluginMarketplace, type WirePluginMarketplaceRequest, type WirePluginMarketplaceResponse, type WirePluginMenuItem, type WirePluginNameRequest, type WirePluginPreview, type WirePluginPreviewRequest, type WirePluginPreviewResponse, type WirePluginRefreshResponse, type WirePluginRefuseReason, type WirePluginSourceType, type WirePluginStageRequest, type WirePluginStageResponse, type WirePluginStatus, 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 WirePluginVisibility, type WirePluginsResponse, type WirePolicyDir, type WirePolicyStatus, type WireProjectInventory, type WireProviderKeyRequest, type WireProviderKeyResponse, type WireProviderModelsRequest, type WireProviderModelsResponse, type WireProviderOption, type WireProviderSummary, type WireProvidersResponse, type WireQuestionListResponse, type WireQuestionRequest, type WireReplayMessage, type WireResetReason, type WireRespondApprovalRequest, type WireRespondApprovalResponse, type WireRespondQuestionRequest, type WireRespondQuestionResponse, 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 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 WireToolGate, type WireToolGateAxis, type WireToolRow, type WireToolSummary, type WireToolVerdict, type WireToolsResponse, type WireTrustRequestRequest, type WireTrustRequestResponse, type WireTurnState, type WireWorkspaceBinding, type WireWorkspaceDiffResponse, type WireWorkspaceDirEntry, type WireWorkspaceDirsResponse, type WireWorkspaceRef, apiKeyEnvVar, assertNeverPart, assistantTurnText, attachSessionSurface, chordId, collectPendingApprovals, compressionThresholdTokens, conformsToWire, contentToText, diagnosticToLine, extractAllMentions, extractMentions, extractSessionMentions, filePartSummary, flattenCatalog, formatMoney, getProviderInfo, hasFailure, imagePartOmittedSummary, isApprovalOutcome, isContextNearlyFull, isCurrency, isHeadlessInputFormat, isHeadlessLifecycleEvent, isHeadlessOutputFormat, isKeyAction, isLang, isMentionableFilePath, isOperationType, isPermissionLevel, isPlanOutcome, isPromptOversize, isProviderType, isQuestionAnswerMap, isSearchProviderType, isSettingsPaneId, isValidAgentRoleName, isValidCommandName, isWireGoalPhase, isWireHubEvent, isWirePlanAction, isWirePluginArchiveName, isWireRewindScope, isWireSettingWriteLayer, isWireSkillDropName, joinUploadMulti, makeTranslate, mcpConnectorState, normalizeApproval, packSessionSurface, parseChord, parseModelRef, parseSequence, perAction, placeholdersOf, promptTokens, resolveHostText, sequenceId, sessionPartSummary, splitUploadMulti, stripSystemNote, systemNote, tableOf, totalUsageTokens, translatorFor, truncateToBudget, turnDigest, unfixedRules, utf8ByteLength, wireFields };
+export { ACTION_CONTEXTS, AGENT_ROLE_NAME_PATTERN, API_KEY_ENV_VARS, APPEARANCE_LANGS, APPEARANCE_THEMES, APPROVAL_OUTCOMES, type ActiveAgentRole, type AgentEvent, type AgentEventOf, type AgentEventType, type AgentRole, type AgentRoleScope, type AgentRoleSource, type AppearanceLang, type AppearanceTheme, type ApprovalAnswer, type ApprovalOutcome, type ApprovalReply, type ApprovalRequest, type ArtifactKind, type AttributeValue, type Attributes, type BackgroundTaskInfo, type BackgroundTaskKind, type BackgroundTaskStatus, type BlankCard, type BlankGreeting, type BoundKey, type BudgetBreach, COMMAND_NAME_PATTERN, COMPLIANCE_ACTIONS, COMPLIANCE_CATEGORIES, CURRENCIES, type Catalogs, type ComplianceAction, type ComplianceCategory, type ContextBreakdown, type ContextSegment, type Currency, type CurrencyDisplay, type CustomCommandDef, type CustomCommandSource, DEFAULT_AGENT_ROLE, DEFAULT_LANG, type DecidedTrustLevel, type Diagnostic, DiagnosticSink, type DiagnosticStatus, type EpochConfig, type EpochContentPart, 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 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 JsonSchema, KEY_ACTIONS, type KeyAction, type KeyChord, type KeyContext, type KeySequence, type KeybindingReport, type KeybindingSource, type KeybindingTable, LANGS, type Lang, type LocalizedDetail, type LogFn, MAX_ATTACH_BYTES, MAX_ATTACH_FILES, MAX_ATTACH_TOTAL_BYTES, MAX_HEADER_CHARS, MAX_OPTIONS, MAX_QUESTIONS, MAX_SESSION_ATTACH_BYTES, MAX_SESSION_REFS, MCP_DATA_KEY_NAME, METRIC, MIN_OPTIONS, type MentionSet, type ModelRef, type ModelSelection, type ModelSelectionOrigin, type MoneyDigits, NOOP_TELEMETRY, type NoticeCode, OPERATION_TYPES, OVERSIZE_RATIO, type Operation, type OperationType, PERMISSION_LEVELS, PLAN_OUTCOMES, PLUGIN_CATEGORY_DISPLAY_SEP, PLUGIN_MENU_MESSAGE_TYPE, 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, RESERVED_CHORDS, RESERVED_COMMAND_NAMES, type RejectReason, type RejectedKey, type RuleValue, SCHEDULE_DRAFT_TOOL, SCHEDULE_INTERVAL_MINUTES, SCHEDULE_RUN_STATUSES, SCHEDULE_TEMPLATES, 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 ScheduleAllowlist, type ScheduleBackendKind, 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 ScheduleTemplate, type ScheduleTemplateId, 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 SpanLike, type SubToolCall, type SubToolCallResult, 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, 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_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_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_FIELDS, WIRE_MODEL_SELECTION_FIELDS, WIRE_MODEL_SET_FIELDS, WIRE_MODEL_SUGGESTIONS_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_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_POLICY_DIR_FIELDS, WIRE_POLICY_STATUS_FIELDS, WIRE_PROJECT_INVENTORY_FIELDS, WIRE_PROVIDERS_FIELDS, WIRE_PROVIDER_KEY_FIELDS, WIRE_PROVIDER_MODELS_FIELDS, WIRE_PROVIDER_OPTION_FIELDS, 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_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_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_TOOLS_FIELDS, WIRE_TOOL_GATE_FIELDS, WIRE_TOOL_ROW_FIELDS, WIRE_TRUST_REQUEST_FIELDS, WIRE_TRUST_REQUEST_RESPONSE_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 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 WireDiffNote, type WireDiffOmitReason, type WireDiffSource, type WireDiffStatus, 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 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 WireModelProbeStatus, type WireModelRejection, type WireModelResponse, type WireModelSelection, type WireModelSetRequest, type WireModelSetResponse, type WireModelSource, type WireModelSuggestions, 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 WirePluginEntry, type WirePluginHit, type WirePluginHookTally, type WirePluginInstallRequest, type WirePluginLocalInstallRequest, type WirePluginLocalRequest, type WirePluginMarketplace, type WirePluginMarketplaceRequest, type WirePluginMarketplaceResponse, type WirePluginMenuItem, type WirePluginNameRequest, type WirePluginPreview, type WirePluginPreviewRequest, type WirePluginPreviewResponse, type WirePluginRefreshResponse, type WirePluginRefuseReason, type WirePluginSourceType, type WirePluginStageRequest, type WirePluginStageResponse, type WirePluginStatus, 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 WirePluginVisibility, type WirePluginsResponse, type WirePolicyDir, type WirePolicyStatus, type WireProjectInventory, type WireProviderKeyRequest, type WireProviderKeyResponse, type WireProviderModelsRequest, type WireProviderModelsResponse, type WireProviderOption, type WireProviderSummary, type WireProvidersResponse, type WireQuestionListResponse, type WireQuestionRequest, type WireReplayMessage, type WireResetReason, type WireRespondApprovalRequest, type WireRespondApprovalResponse, type WireRespondQuestionRequest, type WireRespondQuestionResponse, 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 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 WireToolGate, type WireToolGateAxis, type WireToolRow, type WireToolSummary, type WireToolVerdict, type WireToolsResponse, type WireTrustRequestRequest, type WireTrustRequestResponse, type WireTurnState, type WireWorkspaceBinding, type WireWorkspaceDiffResponse, type WireWorkspaceDirEntry, type WireWorkspaceDirsResponse, type WireWorkspaceRef, apiKeyEnvVar, assertNeverPart, assistantTurnText, attachSessionSurface, chordId, collectPendingApprovals, compressionThresholdTokens, conformsToWire, contentToText, diagnosticToLine, extractAllMentions, extractMentions, extractSessionMentions, filePartSummary, flattenCatalog, formatMoney, getProviderInfo, hasFailure, imagePartOmittedSummary, isAppearanceLang, isAppearanceTheme, isApprovalOutcome, isContextNearlyFull, isCurrency, isHeadlessInputFormat, isHeadlessLifecycleEvent, isHeadlessOutputFormat, isKeyAction, isLang, isMentionableFilePath, isOperationType, isPermissionLevel, isPlanOutcome, isPromptOversize, isProviderType, isQuestionAnswerMap, isSearchProviderType, isSettingsPaneId, isValidAgentRoleName, isValidCommandName, isWireGoalPhase, isWireHubEvent, isWirePlanAction, isWirePluginArchiveName, isWireRewindScope, isWireSettingWriteLayer, isWireSkillDropName, joinUploadMulti, makeTranslate, mcpConnectorState, normalizeApproval, packSessionSurface, parseChord, parseModelRef, parseSequence, perAction, placeholdersOf, promptTokens, resolveHostText, sequenceId, sessionPartSummary, splitUploadMulti, stripSystemNote, systemNote, tableOf, totalUsageTokens, translatorFor, truncateToBudget, turnDigest, unfixedRules, utf8ByteLength, wireFields };

package/dist/index.js

@@ -833,6 +833,7 @@ var HUB_EVENT_TYPES = /* @__PURE__ */ new Set([
   "session-cooled",
   "tasks-changed",
   "sessions-changed",
+  "session-title-changed",
   "plugins-changed",
   "host-compose"
 ]);
@@ -951,7 +952,8 @@ var WIRE_SESSION_SUMMARY_FIELDS = wireFields()({
   turnStartedAt: true,
   lastFinish: true,
   role: true,
-  archived: true
+  archived: true,
+  pinned: true
 });
 var WIRE_SESSION_FINISH_FIELDS = wireFields()({
   reason: true,
@@ -1597,6 +1599,59 @@ var WIRE_SETTINGS_WRITE_FIELDS = wireFields()({
   value: true,
   apply: true
 });
+// src/i18n.ts
+var LANGS = ["zh", "en"];
+var DEFAULT_LANG = "zh";
+function isLang(value) {
+  return LANGS.includes(value);
+}
+var WIRE_LANG_PARAM = "lang";
+var PLACEHOLDER = /\{(\w+)\}/g;
+function placeholdersOf(text) {
+  const found = [];
+  for (const match of text.matchAll(PLACEHOLDER)) {
+    const name = match[1];
+    if (name && !found.includes(name)) found.push(name);
+  }
+  return found;
+}
+function flattenCatalog(value, prefix = "", out = {}) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return out;
+  for (const [key, child] of Object.entries(value)) {
+    const path = prefix ? `${prefix}.${key}` : key;
+    if (typeof child === "string") out[path] = child;
+    else flattenCatalog(child, path, out);
+  }
+  return out;
+}
+function makeTranslate(catalogs) {
+  const catalogOf = (lang) => catalogs[lang] ?? {};
+  return (lang, key, vars) => {
+    const text = catalogOf(lang)[key] ?? catalogOf(DEFAULT_LANG)[key] ?? key;
+    if (!vars) return text;
+    return text.replace(PLACEHOLDER, (whole, name) => {
+      const value = vars[name];
+      return value === void 0 ? whole : String(value);
+    });
+  };
+}
+function translatorFor(catalogs, lang) {
+  const translate = makeTranslate(catalogs);
+  return (key, vars) => translate(lang, key, vars);
+}
+// src/wire-appearance.ts
+var FOLLOW_SYSTEM = "system";
+var APPEARANCE_THEMES = ["system", "light", "dark"];
+var APPEARANCE_LANGS = [FOLLOW_SYSTEM, ...LANGS];
+function isAppearanceTheme(value) {
+  return typeof value === "string" && APPEARANCE_THEMES.includes(value);
+}
+function isAppearanceLang(value) {
+  return typeof value === "string" && APPEARANCE_LANGS.includes(value);
+}
+var WIRE_APPEARANCE_RESPONSE_FIELDS = wireFields()({
+  ok: true
+});
 // src/wire-model.ts
 var WIRE_MODEL_SELECTION_FIELDS = wireFields()({
   provider: true,
@@ -1877,46 +1932,6 @@ var WIRE_FILE_CANDIDATES_FIELDS = wireFields()({
 var SIDEBAR_MENU_MESSAGE_TYPE = "epoch:sidebar-menu";
 // src/plugin-menu.ts
 var PLUGIN_MENU_MESSAGE_TYPE = "epoch:plugin-menu";
-// src/i18n.ts
-var LANGS = ["zh", "en"];
-var DEFAULT_LANG = "zh";
-function isLang(value) {
-  return LANGS.includes(value);
-}
-var WIRE_LANG_PARAM = "lang";
-var PLACEHOLDER = /\{(\w+)\}/g;
-function placeholdersOf(text) {
-  const found = [];
-  for (const match of text.matchAll(PLACEHOLDER)) {
-    const name = match[1];
-    if (name && !found.includes(name)) found.push(name);
-  }
-  return found;
-}
-function flattenCatalog(value, prefix = "", out = {}) {
-  if (!value || typeof value !== "object" || Array.isArray(value)) return out;
-  for (const [key, child] of Object.entries(value)) {
-    const path = prefix ? `${prefix}.${key}` : key;
-    if (typeof child === "string") out[path] = child;
-    else flattenCatalog(child, path, out);
-  }
-  return out;
-}
-function makeTranslate(catalogs) {
-  const catalogOf = (lang) => catalogs[lang] ?? {};
-  return (lang, key, vars) => {
-    const text = catalogOf(lang)[key] ?? catalogOf(DEFAULT_LANG)[key] ?? key;
-    if (!vars) return text;
-    return text.replace(PLACEHOLDER, (whole, name) => {
-      const value = vars[name];
-      return value === void 0 ? whole : String(value);
-    });
-  };
-}
-function translatorFor(catalogs, lang) {
-  const translate = makeTranslate(catalogs);
-  return (key, vars) => translate(lang, key, vars);
-}
 // src/blank-greeting.ts
 function resolveHostText(text, lang) {
   if (!text) return void 0;
@@ -1956,4 +1971,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_ROLE_NAME_PATTERN, API_KEY_ENV_VARS, APPROVAL_OUTCOMES, COMMAND_NAME_PATTERN, COMPLIANCE_ACTIONS, COMPLIANCE_CATEGORIES, CURRENCIES, DEFAULT_AGENT_ROLE, DEFAULT_LANG, DiagnosticSink, GEN_AI, HEADLESS_INPUT_EVENT_TYPES, HEADLESS_INPUT_FORMATS, HEADLESS_OUTPUT_FORMATS, HEADLESS_PROTOCOL_VERSION, KEY_ACTIONS, LANGS, MAX_ATTACH_BYTES, MAX_ATTACH_FILES, MAX_ATTACH_TOTAL_BYTES, MAX_HEADER_CHARS, MAX_OPTIONS, MAX_QUESTIONS, MAX_SESSION_ATTACH_BYTES, MAX_SESSION_REFS, MCP_DATA_KEY_NAME, METRIC, MIN_OPTIONS, NOOP_TELEMETRY, OPERATION_TYPES, OVERSIZE_RATIO, PERMISSION_LEVELS, PLAN_OUTCOMES, PLUGIN_CATEGORY_DISPLAY_SEP, PLUGIN_MENU_MESSAGE_TYPE, PLUGIN_UPLOAD_MULTI_SEP, PROVIDER_INFOS, PROVIDER_TYPES, RESERVED_CHORDS, RESERVED_COMMAND_NAMES, SCHEDULE_DRAFT_TOOL, SCHEDULE_INTERVAL_MINUTES, SCHEDULE_RUN_STATUSES, SCHEDULE_TEMPLATES, 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, WIRE_ABORT_FIELDS, WIRE_ABOUT_FIELDS, WIRE_AGENT_ROLE_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_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_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_FIELDS, WIRE_MODEL_SELECTION_FIELDS, WIRE_MODEL_SET_FIELDS, WIRE_MODEL_SUGGESTIONS_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_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_POLICY_DIR_FIELDS, WIRE_POLICY_STATUS_FIELDS, WIRE_PROJECT_INVENTORY_FIELDS, WIRE_PROVIDERS_FIELDS, WIRE_PROVIDER_KEY_FIELDS, WIRE_PROVIDER_MODELS_FIELDS, WIRE_PROVIDER_OPTION_FIELDS, 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_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_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_TOOLS_FIELDS, WIRE_TOOL_GATE_FIELDS, WIRE_TOOL_ROW_FIELDS, WIRE_TRUST_REQUEST_FIELDS, WIRE_TRUST_REQUEST_RESPONSE_FIELDS, WIRE_WORKSPACE_DIFF_FIELDS, WIRE_WORKSPACE_DIRS_FIELDS, WIRE_WORKSPACE_DIR_ENTRY_FIELDS, WIRE_WORKSPACE_REF_FIELDS, apiKeyEnvVar, assertNeverPart, assistantTurnText, attachSessionSurface, chordId, collectPendingApprovals, compressionThresholdTokens, conformsToWire, contentToText, diagnosticToLine, extractAllMentions, extractMentions, extractSessionMentions, filePartSummary, flattenCatalog, formatMoney, getProviderInfo, hasFailure, imagePartOmittedSummary, isApprovalOutcome, isContextNearlyFull, isCurrency, isHeadlessInputFormat, isHeadlessLifecycleEvent, isHeadlessOutputFormat, isKeyAction, isLang, isMentionableFilePath, isOperationType, isPermissionLevel, isPlanOutcome, isPromptOversize, isProviderType, isQuestionAnswerMap, isSearchProviderType, isSettingsPaneId, isValidAgentRoleName, isValidCommandName, isWireGoalPhase, isWireHubEvent, isWirePlanAction, isWirePluginArchiveName, isWireRewindScope, isWireSettingWriteLayer, isWireSkillDropName, joinUploadMulti, makeTranslate, mcpConnectorState, normalizeApproval, packSessionSurface, parseChord, parseModelRef, parseSequence, perAction, placeholdersOf, promptTokens, resolveHostText, sequenceId, sessionPartSummary, splitUploadMulti, stripSystemNote, systemNote, tableOf, totalUsageTokens, translatorFor, truncateToBudget, turnDigest, unfixedRules, utf8ByteLength, wireFields };
+export { ACTION_CONTEXTS, AGENT_ROLE_NAME_PATTERN, API_KEY_ENV_VARS, APPEARANCE_LANGS, APPEARANCE_THEMES, APPROVAL_OUTCOMES, COMMAND_NAME_PATTERN, COMPLIANCE_ACTIONS, COMPLIANCE_CATEGORIES, CURRENCIES, DEFAULT_AGENT_ROLE, DEFAULT_LANG, DiagnosticSink, FOLLOW_SYSTEM, GEN_AI, HEADLESS_INPUT_EVENT_TYPES, HEADLESS_INPUT_FORMATS, HEADLESS_OUTPUT_FORMATS, HEADLESS_PROTOCOL_VERSION, KEY_ACTIONS, LANGS, MAX_ATTACH_BYTES, MAX_ATTACH_FILES, MAX_ATTACH_TOTAL_BYTES, MAX_HEADER_CHARS, MAX_OPTIONS, MAX_QUESTIONS, MAX_SESSION_ATTACH_BYTES, MAX_SESSION_REFS, MCP_DATA_KEY_NAME, METRIC, MIN_OPTIONS, NOOP_TELEMETRY, OPERATION_TYPES, OVERSIZE_RATIO, PERMISSION_LEVELS, PLAN_OUTCOMES, PLUGIN_CATEGORY_DISPLAY_SEP, PLUGIN_MENU_MESSAGE_TYPE, PLUGIN_UPLOAD_MULTI_SEP, PROVIDER_INFOS, PROVIDER_TYPES, RESERVED_CHORDS, RESERVED_COMMAND_NAMES, SCHEDULE_DRAFT_TOOL, SCHEDULE_INTERVAL_MINUTES, SCHEDULE_RUN_STATUSES, SCHEDULE_TEMPLATES, 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, 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_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_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_FIELDS, WIRE_MODEL_SELECTION_FIELDS, WIRE_MODEL_SET_FIELDS, WIRE_MODEL_SUGGESTIONS_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_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_POLICY_DIR_FIELDS, WIRE_POLICY_STATUS_FIELDS, WIRE_PROJECT_INVENTORY_FIELDS, WIRE_PROVIDERS_FIELDS, WIRE_PROVIDER_KEY_FIELDS, WIRE_PROVIDER_MODELS_FIELDS, WIRE_PROVIDER_OPTION_FIELDS, 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_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_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_TOOLS_FIELDS, WIRE_TOOL_GATE_FIELDS, WIRE_TOOL_ROW_FIELDS, WIRE_TRUST_REQUEST_FIELDS, WIRE_TRUST_REQUEST_RESPONSE_FIELDS, WIRE_WORKSPACE_DIFF_FIELDS, WIRE_WORKSPACE_DIRS_FIELDS, WIRE_WORKSPACE_DIR_ENTRY_FIELDS, WIRE_WORKSPACE_REF_FIELDS, apiKeyEnvVar, assertNeverPart, assistantTurnText, attachSessionSurface, chordId, collectPendingApprovals, compressionThresholdTokens, conformsToWire, contentToText, diagnosticToLine, extractAllMentions, extractMentions, extractSessionMentions, filePartSummary, flattenCatalog, formatMoney, getProviderInfo, hasFailure, imagePartOmittedSummary, isAppearanceLang, isAppearanceTheme, isApprovalOutcome, isContextNearlyFull, isCurrency, isHeadlessInputFormat, isHeadlessLifecycleEvent, isHeadlessOutputFormat, isKeyAction, isLang, isMentionableFilePath, isOperationType, isPermissionLevel, isPlanOutcome, isPromptOversize, isProviderType, isQuestionAnswerMap, isSearchProviderType, isSettingsPaneId, isValidAgentRoleName, isValidCommandName, isWireGoalPhase, isWireHubEvent, isWirePlanAction, isWirePluginArchiveName, isWireRewindScope, isWireSettingWriteLayer, isWireSkillDropName, joinUploadMulti, makeTranslate, mcpConnectorState, normalizeApproval, packSessionSurface, parseChord, parseModelRef, parseSequence, perAction, placeholdersOf, promptTokens, resolveHostText, sequenceId, sessionPartSummary, splitUploadMulti, stripSystemNote, systemNote, tableOf, totalUsageTokens, translatorFor, truncateToBudget, turnDigest, unfixedRules, utf8ByteLength, wireFields };

package/package.json

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