@dsh-workbench/core 0.3.10 → 1.0.0-beta.0

package/skills/workbench-module-diy/WRITES.md

@@ -1,148 +1,121 @@
-# 写通道：要真改东西的那一下，怎么找到、怎么确认
+# 写通道：找到写命令、取得原文、确认、回读
 
-[DATASOURCE.md](DATASOURCE.md) 只管**读**（数据从哪来）。这一份管**写**：提交 / 发布 / 建单 / 改配置。
-判域用的是同一把尺（**要不要新凭据**，见 [DESIGN.md](DESIGN.md) §0）：复用他已有登录、一次调用就能改完的 ⇒ DIY；
-要**新凭据** / 多步长流程（要等、中途要人、失败要接着来）/ 新服务、新进程、新依赖 ⇒ **工程域**，停下来照 [DESIGN.md](DESIGN.md) §0 那张表说清下一步。
+[datasource](DATASOURCE.md) 只管读。本文件管写：提交 / 发布 / 建单 / 改配置。
+
+判域同 [DESIGN.md](DESIGN.md) §0：复用现有登录、一次调用能改完 → DIY；要新凭据 / 多步长流程 / 新服务或依赖 → 工程域。
 
 ## 四步
 
-1. **先找现成写命令** —— `workbench_diy_recon`（`keyword=…`）现在每条命令都**标了读 / 写**：
-   `读` · `写（可预览）` · `写（无预览档，一次就是真的）`；写命令那一行还带**入参签名**（`--id --yes=false`）。
-   **命中现成的就别自己造**（自造等于绕过它已经处理好的登录、XSRF 与错误码）。真渲染长这样：
-
-   ```
-   opencli 自带这 1 组能力（不用装、不用点头）：
-   · antigravity（127.0.0.1） · ui · 要用你的 Chrome 登录
-       读 opencli antigravity cookies —— List cookies on the Antigravity renderer…
-       …
-       … 还有 6 条（其中写 2 条）：opencli antigravity --help
-   直接复用：opencli antigravity cookies（这台机器上就能跑，不用装、不用点头）
-   ```
-
-   写命令那行长这样：`写（可预览） opencli antigravity delete —— … ｜ 入参：--id --yes=false`。
-   只匹配到写命令时，它最后一句会换成：先 `--help` 看入参；带 `--dryRun` / `--yes` 的**先用预览档**；
-   **没有预览档的不许试写**（那一次就是真的）。
-   一条边界：**recon 只查 opencli 自带那份目录** —— `cmdb` / `coding` 这类是另装的**插件**，
-   它只回命令名（`opencli cmdb --help` 看全部）；插件的入参走第 2 步。
-
-2. **入参 / 出参按这个顺序查**（越靠前越可信）：
-   - **`workbench_diy_spec`**（`command='<site> <name>'`，`cmdb publish` / `cmdb/publish` 都认）——
-     **插件与内置都能问**：它把 `opencli <site> <name> --help -f json` **原样**回，stdout 是 JSON 时另给 `spec` ——
-     `access`（读 / 写）、`positionals`、`command_options[{name, required, help, default}]`、出参列都在里面；
-     **不看屏、不要调试约定**。最快的一格，先问它。
-   - recon 回的 `args`（**必填 / 默认值**）与 `preview` 标记 —— 只覆盖 opencli 自带那份目录；插件以 `_spec` 为准。
-   - **adapter 源码是接口的一手来源**：隔离 HOME 下 `.opencli/plugins/<site>` 是**符号链接**，
-     指到插件包 —— 接口 URL / 方法 / cookie / XSRF 都在那儿。例：coding 的评论接口在
-     `opencli-plugin-coding/src/issue-utils.js`（`issueCommentsApiUrl`，POST 表单），
-     cookie 与 `X-XSRF-TOKEN` 在同一个包的 `src/request.js` 里。
-   - `opencli <site> <name> --help`（`-f yaml` 更好读）—— 补**取值枚举**：manifest 里没有 `choices`，
-     枚举只在 help 文本里；`_spec` 那条路回的是 JSON，`-f yaml` 适合人眼扫。
-
-3. **没有现成命令时，让他配合录一次**（agent 主导：你备好、他只动那一下、交回来）：
-   - `workbench_diy_record_prepare({ unit, url, doing })` —— 开一扇窗**顶到最前**（**要用户点头一次**：审批屏上写清
-     站点、录哪一下、落在哪、录完不替他切回来），窗里有一根浮条。请他 ① 按「开始录制」 ② 做**一次**那动作 ③ 按「结束录制」；
-     **别让他点第二次**。`url` 必须是**这个模块读源同域**的页面 —— 模块的 `design.json` 说过读源时，跨域会**当场拒**
-     （没说过就不拦；那一条比的是"别把别处的请求原文带进这个模块"）。
-   - **再让他按一下浮条上的「截图」**：时机是**把表填对之后、点提交之前**（提交完表单就没了）——
-     这一下**不另外审批**（屏幕在 prepare 那一拍已经借过）。它同时落下两样东西：一张整页图（落 `shots/rec-shot-<unit>-<n>.png`）
-     与一份**页面快照**（每个控件的 `name`/`id`、标签、`required`/`aria-required`/容器 class/`*` 这类必填痕迹、当时的填值、是否空、
-     有没有被改过）。**提交那一刻我们会自动再抓一份**，所以他忘了按也不至于空手。
-     他按了截图之后，浮条上会多一个「已拍 N 张」，左栏底部那句也跟着带张数。
-   - `workbench_diy_record_read` 取那一段（他按完结束再取）：回的是**清单** `rows`（每条 `index` / `key` / `method` /
-     `url` / `status` / `ct` / `size` / `source` / `hasRequest` / `hasResponse` / `likelyWrite` / `marked`），
-     **一条都不删、也不回体**；`expect` 只用来标 ⭐ 并把 ⭐ 排到前面。**正文每一行就把它要的两样摆出来了**：
-     `· [0] ⭐ POST 站点/路径（捕获 · 入参 有 · 出参 40 B · at 1792583917392）` —— 开头那串就是 `key` 原文（opencli 给的，
-     可能带 `#2` 这种后缀），`at` 是毫秒时间戳；**没有 `key` 的钩子行**（页面钩子只记 `method`/`url`，没给 key）会写成
-     `method url（钩子 · … · 无 key）`，那种行只有还开着时按 `index` 才取得到。要哪一条的原文再调
-     **`workbench_diy_record_detail`**（给那一行的 `key`，或序号 `index`；**同一个 key 跨轮会重名**，
-     再带上那一行的 `at` 才钉得住是哪一次）——它回**入参（`request.body`）与
-     出参（`response body`）原文**，外加请求头（可能含凭据，别落进 `design.json`）。他还没按结束时 read 会说清"还在录"
-     （要等就带 `waitMs`，帽 15 分钟；等不到会挂一条 notice 叫你）；浮条被导航干掉过会顺手重新装上。
-     **抓不满就重新 prepare 一场**：一场就是一个周期（开始 → 结束），结束之后那一页上的「开始」按不动了。
-   - `workbench_diy_record_stop` 收工：停捕获、收掉那个标签、清状态；**原文另存成 `shots/rec-<unit>.jsonl.last`** ——
-     收工之后给 `_record_detail` 一个 `unit` 还能看那一条。**先 read（或先 detail 完）再 stop**。
-     左栏底部那一格是给他的状态：等出手 `[取消]` / 录制中 `[停]`，按下去只会**给你一条消息**（他不替你按工具）；
-     **录完那一档没有键** —— 你自己来取、自己收工（宿主每 3 秒看一眼那一页，看到结束就发 notice 叫你）。
-   - 抓不到的照旧如实说：`<form>` 原生提交 / WebSocket / service worker / **别处的标签**；
-     页面钩子只认 `fetch` 与 XHR，缓冲上限 50 条、单条请求体截 16 KB（`sendBeacon` 2026-10-20 起抓了）。
-     会话捕获在浏览器那一层，盖得比钩子全、且带体 —— 两处合并去重，同名以钩子为主、缺的 key / 入参 / 出参由捕获补齐。
-   - **兜底的老路**（那一页在别的浏览器里、或录制族用不上时）：`opencli browser <你的会话名> bind`（只认**当前聚焦窗的活动标签**）
-     或 `open … --window foreground` 自己开一扇，**先把捕获臂上再让他动手**：`opencli browser <你的会话名> network --follow`
-     （一次性 `network` 不会替你开捕获；每读一次就把 live 缓冲抽干一次）。取那一段用 `network --raw`
-     （**同一次调用**才带 body；跨调用的 `--detail` 在我们这份隔离运行时落不了盘，恒 `cache_missing`），
-     还是没有请求体就请他打开 DevTools，把那次请求**复制成 curl** 给你。
-   - agent 自己点只限**测试环境 / 可撤销的目标**（同下面第一条纪律）。
-   取证结果要固化成模块自己的写能力：`writes: true` + `needsApproval` + `approvalDetail`（[TOOLS.md](TOOLS.md) §6）。
-
-4. **文档 / 问用户** —— 接口文档、别人给的 curl 样例都行；这属于**需求确认**那一拍
-   （照 [STEPS.md](STEPS.md) 那张表问他"你会看到什么"，别问技术细节）。
-
-## 两条硬纪律
-
-- **写命令只有少数带预览档**：隔离运行时那份 manifest 实测 **357 条写命令里只有 12 条**有
-  `yes` / `dryRun` / `confirm`（那 12 条：antigravity `delete`/`revert` · codex `archive` ·
-  gemini `deep-research` · grok `delete` · kimi `history-rename`/`sign-out` · pinterest 三条 delete ·
-  slock `task-delete` · twitter `list-delete`）。**`opencli cmdb publish` / `cmdb build` 都没有预览开关**
-  —— 调一次就是**真发布 / 真构建**。有预览档的先用预览档；没有的**不许 agent 试写**。
-- **要新凭据 / 多步长流程 / 新依赖 ⇒ 工程域**（同 [DESIGN.md](DESIGN.md) §0）。
-
-## 三条写纪律（与 opencli 自己那份 `deep-recon` 对齐）
-
-1. **授权观察一次 ≠ 授权重放。** 他点一次是"给你看这一次"；**不许因为你已经看过就再放一次**。
-   要再放一次，就得再跟他确认一次（同一场里"再录一段"算同一件事，见下）。
-2. **写后"不确定"要当一档说清，并且**不许自动重试**。命令报错不等于没写成功（可能已经写了）；
-   这种时候停下、**先回读**把状态读回来再决定，别重放。`design.json` 的 `failure` 那一格要写到这一档。
-3. **写要有配对的撤销 / 反操作**（`follow` ↔ `unfollow`、`publish` ↔ `delete`…）。opencli 自己有一条
-   机器判据 `write-without-delete-pair` 盯这个；你交出去的那张卡至少要在**写通道探明记录**里写清
-   "这一步错了怎么退"（哪条命令 / 平台上哪里点）—— 那就是 `writes[].undo` 那一格，**必填**：
-   真没有配对就写"没有配对，一次就是真的"（**空着 = 没想过**，`design check` 会点名 `write.undo`）。
-
-## 出参的最终确认靠**回读**
-
-写完拿**同族的读**（或卡片那条投影）把那一格读回来，**别看"命令没报错"就当成功** ——
-平台可能收下了却没生效，也可能失败在"**可能已经写了**"那一档。写进模块时，
-`design.json` 的 `writes[].readback` 就是这一格（哪条读 / 出参哪个字段）。
-
-## 边界（如实）
-
-- **`browser network --detail` 在工坊会话里拿不到 body**：它依赖一份盘上缓存，默认路径落在会话可写根之外
-  （`EPERM …/opencli/home/.opencli/cache/browser-network`，工具只发一个 `cache_warning`）⇒ 跨调用的 `--detail` 取不到。
-  **录制族不依赖它**：它自己那份 `shots/rec-<unit>.jsonl` 就是原文（`_record_detail` 按 key 现取）。
-  手工取 body 的另一条路是 `workbench_diy_eval` 里的 `fetch` —— 用它自己的登录在页面里读，返回 JSON；
-  或把 `OPENCLI_CACHE_DIR` 指到可写处，再让 `--detail <key>` 生效。
-- **两套 opencli 真相**：PATH 上那份、你机器上 `~/.opencli` 那份、工作台**隔离运行时**那份
-  可能不是同一代。工坊一律以**隔离运行时**（`$DSH_HOME/workbench/opencli/`）为准；
-  核验用工具，别去看错文件。
-- **取值枚举只在 help 文本里**（manifest 没有 `choices`），别指望 recon 的 `args` 带它。
-
-## 落进 `design.json`
-
-写通道填 `writes[]`（一个动作可以打几条写：先建后发布；只有一条写也可以写成 `write: {}`）。
-字段**七个必填**、一个可空；下表右边是 `design render` 渲染出来的**行名（逐字）**：
-
-| 字段 | 渲染出来的行 |
+1. **找现成写命令** —— `workbench_diy_recon`（`keyword=…`）标注每条命令的读写：
+   `读` · `写（可预览）` · `写（无预览档，一次就是真的）`，并给入参签名（`--id --yes=false`）。
+   命中即复用（自造会绕过登录、XSRF、错误码处理）。
+   只命中写命令时，末句提示：先 `--help` 看入参；带 `--dryRun` / `--yes` 的先走预览；**无预览档不许试写**。
+   边界：recon 只覆盖 opencli 自带目录；`inventory` / `demo` 等插件只回命令名，参数走第 2 步。
+
+2. **查入参 / 出参**（按可信度）：
+
+   - `workbench_diy_spec`（`command='<site> <name>'`，`inventory publish` / `inventory/publish` 均可）：
+     返回 `opencli <site> <name> --help -f json` 原文；JSON 时另给 `spec`（`access`、`positionals`、
+     `command_options[{name, required, help, default}]`、出参列）。不碰屏、不需约定。
+   - recon 的 `args`（必填 / 默认值）与 `preview` 标记，仅覆盖自带目录；插件以 `_spec` 为准。
+   - adapter 源码：隔离 HOME 的 `.opencli/plugins/<site>` 指向插件包；接口 URL / 方法 / cookie / XSRF 在源码里。
+   - `opencli <site> <name> --help`（`-f yaml` 可读性更好）：取枚举值（manifest 无 `choices`，枚举只在 help 里）。
+
+3. **无现成命令 → 让用户录一次**（你准备，用户执行）：
+
+   - `workbench_diy_record_prepare({ unit, url, doing })`：开窗置前（**需审批一次**：站点、录哪一下、落点、
+     录完不切回），装浮条。用户：① 开始录制 ② 做一次动作 ③ 结束录制。不要让用户点第二次。
+     `url` 必须与模块读源同域（`design.json` 声明过读源时跨域当场拒）。
+   - 表填好、提交前，请用户按浮条「截图」：不额外审批；产出整页图 + 页面快照（控件 `name` / `id`、
+     标签、必填痕迹、填值、是否空、是否改过）。提交时会自动再抓一份。
+   - `workbench_diy_record_read`：取清单 `rows`（`index` / `key` / `method` / `url` / `status` / `ct` /
+     `size` / `source` / `hasRequest` / `hasResponse` / `likelyWrite` / `marked`），不删行、不回体；
+     `expect` 只标 ⭐ 并置顶。按 `key`（或 `index`）调 `workbench_diy_record_detail`：
+     返回请求体与响应体原文 + 请求头（可能含凭据，不写入 `design.json`）。同 key 跨轮重名，带 `at` 定位。
+     未结束时 read 会说"还在录"；可带 `waitMs`（上限 15 分钟）。**一场 = 一个周期**；上一场未收工再
+     prepare 会当场拒（不弹审批）。
+   - `workbench_diy_record_stop`：停捕获、收标签、清状态，原文另存 `shots/rec-<unit>.jsonl.last`。
+     **先 read / detail，再 stop**。左栏键只发消息；录完无键。
+   - 抓不到：原生 `<form>` 提交 / WebSocket / service worker / 其他标签。页面钩子只认 `fetch` 与 XHR，
+     上限 50 条、单条请求体 16 KB。兜底：`opencli browser <会话> bind`（当前聚焦窗活动标签）或
+     `open … --window foreground`，先 `network --follow` 再让用户操作；取 body 用 `network --raw`
+     （同一调用内）；仍无则请用户从 DevTools 复制 curl。
+   - 参数与返回细则见 [FAMILY.md](FAMILY.md) §4。
+   - 仅测试环境 / 可撤销目标可让 agent 自己点。
+
+   取证结果落成模块的写能力：`writes: true` + `needsApproval` + `approvalDetail`（[TOOLS.md](TOOLS.md) §6）。
+
+4. **文档 / 问用户** —— 接口文档、curl 样例都可用于确认需求；问法照 [STEPS.md](STEPS.md)，不问技术细节。
+
+## 执行体（写工具里那一下）
+
+写工具被点头之后，按这个顺序选：
+
+1. **有现成 opencli 写命令** → `opencli <site> <name> …`；`--yes` 只在 `confirm === true` 时加，
+   没有预览档的写不许试写（见上面四步）。
+2. **没有命令、但能落配方** → `data.submit(recipe, { body })`。预览用
+   `describeRecipe(recipe)`（`@dsh-workbench/shared/host`）回 `{ method, url, body }`，
+   凭据只回"放在哪"；真写才调 `submit`。
+3. **都不行**（签名 / WS / 多步 / 一次性 token）→ 旧的 `data.read({ kind: 'browser', script })`，
+   在 `design.json` 里写 `custom: { why }`，脚本留在代码里。
+
+三条都不自动重试：失败先回读，再决定。写完的回读用同一份 `DATASOURCE` 里的读配方（或同族命令）。
+
+第 2 条走的是哪条传输由壳决定（页面脚本 / 宿主侧的公共通道），模块看不见也不该依赖 ——
+`submit` 的返回形状、错误码、审批、回读全都一样。
+
+**录制 → 配方**：`_record_detail` 的原文是取证。method / path / body / contentType 抄进配方；
+`authorization` / `cookie` / `x-csrf-*` 这些头**丢掉**，改写成 `auth.source` + `auth.place`；
+一次性 token / 签名 / 多步 → `custom`。"授权观察一次 ≠ 授权重放"：每次 `submit` 都重新审批。
+
+## 硬纪律
+
+- **预览**：先确认是否有 `yes` / `dryRun` / `confirm` 档；有则先走预览。`opencli inventory publish` / `inventory build`
+  无预览开关，调用即真发布 / 真构建。**无预览档不许试写。**
+- 要新凭据 / 多步长流程 / 新依赖 → 工程域。
+
+## 写纪律
+
+1. 授权观察一次 ≠ 授权重放。已看过也要再次确认（一场录制即一个周期）。
+2. 写后不确定单独报，不自动重试。命令报错可能已写入：停下，先回读，再决定。
+   `design.json` 的 `failure` 覆盖这一档。
+3. 写要有配对的撤销 / 反操作（`follow` ↔ `unfollow`、`publish` ↔ `delete`…）。`writes[].undo` 必填；
+   没有就写"没有配对，一次就是真的"（空 = 未考虑，`design check` 点名）。
+
+## 回读
+
+写后用同族读或卡片投影读回该格。不以"命令没报错"判成功。`writes[].readback` 记录哪条读 / 哪个字段。
+
+## 边界
+
+- `browser network --detail` 在本会话取不到 body（缓存落在可写根之外）。录制族不依赖它；
+  手工取 body 用 `workbench_diy_eval` 的 `fetch`，或把 `OPENCLI_CACHE_DIR` 指到可写处。
+- opencli 可能有三份（PATH、`~/.opencli`、隔离运行时）；以隔离运行时 `$DSH_HOME/workbench/opencli/` 为准。
+- 枚举值只在 help 文本里。
+
+## design.json：writes[]
+
+字段七个必填、三个可空（`probeCommand` / `key + recipe` / `custom`）：
+
+| 字段 | 行名 |
 |---|---|
 | `command` | 哪条写（命令 / URL + 方法） |
-| `params` | 参数（必填 / 取值枚举 / 上限）—— 写"必填"就得带来源括号，见下 |
-| `credentials` | 凭据从哪来 |
-| `preview` | 有没有预览档（没有就写"没有，一次就是真的"） |
-| `readback` | 写完之后怎么回读确认（哪条读 / 出参哪个字段） |
-| `undo` | 配对的那个撤销 / 删除（没有就写"没有配对，一次就是真的"）← 第三条写纪律那一格 |
-| `failure` | 失败长什么样（含"可能已经写了"） |
-| `probeCommand`（可空） | 当初探明 / 预览用的那次调用（原文） |
-
-`design render` 把它写进 README 的 **`### 写通道探明记录`** 那一节，位置在「数据源探明记录」与「验收」之间
-（一条一张表；多条渲染成 `#### 写 N`）。`dsh-wb-module design check` 会把空着的格点名叫出来。
-**没有写通道的模块不用写** —— 它不判"一条都没有"，`check` 不红。
-
-`undo` 是 2026-10-19 加的（照 opencli 的 `write-without-delete-pair`）：**旧模块**跑 `design check`
-会多出一格 `write.undo` 的空格 —— 补一句"没有配对，一次就是真的"（或真配对那条命令）就过，别的不用动。
-
-`params` **带证据**是 2026-10-21 加的（照 `undo` 那一格同一套做法）：录完一次之后，
-`workbench_diy_record_read` 会给到这一场落下的**图**（他按「截图」那几张）与 `workbench_diy_record_detail` 里的**捕获原文** ——
-照它们写：哪一格必填，就看**图上有没有那个红 `*`**，或者看**契约**（`opencli <命令> --help -f json` 里的 `required`）。
-那一格**没有 DOM 快照这条路**（2026-10-21 撤了：页面的弹层/抽屉在真机上是哈希类名，通用规则圈不住他正在填的那一层）。
-判据只咬**来源有没有写出来**：`params` 里出现"必填"时，同一格必须带来源关键词之一
-（`已证` / `声明` / `人证` / `契约` / `未定`），否则 `design check` 点名 `write.params.source`。
-**旧模块**补一个括号就过 —— `（前端已证）` / `（服务端已证）` / `（人证）` / `（契约）` / `（未定）`；别的不用动。
-写成 `非必填` / `不必填` 的不需要来源（那一格是"可选"）。这一条**不校验来源是不是真的** —— 它逼你想过，不逼你造假。
+| `params` | 参数（必填 / 枚举 / 上限）；写"必填"需带来源 |
+| `credentials` | 凭据来源 |
+| `preview` | 有无预览档（无则"没有，一次就是真的"） |
+| `readback` | 回读方式（哪条读 / 哪个字段） |
+| `undo` | 撤销 / 删除；无则"没有配对，一次就是真的" |
+| `failure` | 失败形态（含"可能已经写了"） |
+| `probeCommand`（可空） | 探明 / 预览调用原文 |
+| `key` + `recipe`（可空，成对） | 调用形状（配方）：写走 `data.submit` 时填，`sync` 把它和读一起生成进 `src/datasource.ts`（`DATASOURCE.<key>`）。`key` 不许和读撞，撞了 `design check` 红 |
+| `custom`（可空） | 只记 `why`：配方盖不住的写（签名 / 多步 / 一次性 token），脚本仍留代码里；与 `recipe` 二选一，`design check` 记 warn |
+
+写了 `key + recipe` 的写，预览用 `describeRecipe(DATASOURCE.<key>)`，执行用
+`data.submit(DATASOURCE.<key>, overrides)`；不再把 origin / path 写进代码。
+
+`design render` 写入 README 的 `### 写通道探明记录`（位于「数据源探明记录」与「验收」之间）。
+`design check` 点名空格；无写通道的模块不写。
+
+`params` 来源：依据 `workbench_diy_record_read` 的截图（必填红星）或契约（`--help -f json` 的 `required`）。
+出现"必填"时须带来源关键词之一：`已证` / `声明` / `人证` / `契约` / `未定`，否则报 `write.params.source`。
+`非必填` / `不必填` 不要求来源。判据只查是否写下来源。

package/dist/types/app/layouts/config-sync/ConfigSyncSection.d.ts

@@ -1,5 +0,0 @@
-import type { Translate } from '@dsh-workbench/shared';
-export interface ConfigSyncSectionProps {
-    readonly t: Translate;
-}
-export declare function ConfigSyncSection({ t }: ConfigSyncSectionProps): JSX.Element;

package/dist/types/shared/api/bundle-install.d.ts

@@ -1,123 +0,0 @@
-export declare const BUNDLE_REGISTRIES_ROUTE = "bundle-registries";
-export declare const BUNDLE_INSPECT_ROUTE = "bundle-inspect";
-export declare const BUNDLE_REGISTRY_DEFAULT = "default";
-export declare const MODULE_VERSIONS_ROUTE = "module-versions";
-export type BundleRegistry = string | null;
-export interface BundleRegistries {
-    readonly registry: BundleRegistry;
-    readonly fallbackRegistries: readonly BundleRegistry[];
-    readonly resolved: string | null;
-}
-export type BundleInspectProblem = 'invalid-spec' | 'already-installed' | 'not-found' | 'not-a-package' | 'not-a-bundle' | 'not-a-workbench-module' | 'not-a-module-or-plugin' | 'network' | 'unknown';
-export type BundleSpecKind = 'registry' | 'path' | 'git' | 'tarball';
-export interface BundleInspectionAccepted {
-    readonly status: 'accepted';
-    readonly kind: BundleSpecKind;
-    readonly name?: string;
-    readonly version?: string;
-    readonly description?: string;
-    readonly bundle: boolean | null;
-    readonly registry: BundleRegistry;
-    readonly host?: string;
-}
-export interface BundleInspectionRefused {
-    readonly status: 'refused';
-    readonly problem: BundleInspectProblem;
-    readonly reason: string;
-    readonly registries?: readonly BundleRegistry[];
-}
-export interface BundleInspectionPlugin {
-    readonly status: 'plugin';
-    readonly pkg: string;
-    readonly registry: BundleRegistry;
-    readonly pluginName?: string;
-    readonly version?: string;
-}
-export type BundleInspection = BundleInspectionAccepted | BundleInspectionRefused | BundleInspectionPlugin;
-export interface BundleRegistriesPayload {
-    readonly available: boolean;
-    readonly registries: BundleRegistries | null;
-}
-export interface BundleInspectionPayload {
-    readonly inspection: BundleInspection;
-}
-export type BundleApplication = 'applied' | 'restart-required' | 'overridden' | 'failed' | 'cancelled';
-export declare const RESTART_REASONS: readonly ["no-hmr", "package-moved", "host-module", "unmanaged-plugin", "module-comparison"];
-export type RestartReason = (typeof RESTART_REASONS)[number];
-export type BundleChangeStage = 'install' | 'enable' | 'remove';
-export type BundleFailureKind = 'pnpm-missing' | 'timeout' | 'not-found' | 'no-matching-version' | 'network' | 'disk-full' | 'permission' | 'build-blocked' | 'integrity' | 'unknown';
-export interface BundlePackageResult {
-    readonly exitCode: number;
-    readonly output: string;
-    readonly truncated: boolean;
-    readonly logPath: string;
-    readonly kind?: BundleFailureKind;
-}
-export interface BundleChange {
-    readonly application: BundleApplication;
-    readonly stage: BundleChangeStage;
-    readonly changed: boolean;
-    readonly target: string;
-    readonly bundle?: string;
-    readonly errorCode?: string;
-    readonly errorDetail?: string;
-    readonly packageResult?: BundlePackageResult;
-    readonly pendingBuilds?: readonly string[];
-    readonly restartReason?: RestartReason;
-    readonly failedAt?: 'registry' | 'spec-host';
-}
-export interface BundleInstallRequest {
-    readonly spec: string;
-    readonly registry?: BundleRegistry;
-    readonly requestId?: string;
-    readonly approvedBuilds?: readonly string[];
-}
-export type BundleCancellation = 'cancelled' | 'too-late' | 'not-running';
-export type BundleSupplyState = 'not-a-module' | 'no-needs' | 'installed' | 'failed' | 'pending-restart';
-export interface BundleModulePayload {
-    readonly kind: 'module' | 'not-module' | 'unknown';
-    readonly pkg: string;
-    readonly unit?: string;
-    readonly version?: string;
-}
-export interface BundleSupplyPayload {
-    readonly state: BundleSupplyState;
-    readonly reason?: string;
-}
-export interface BundleInstalledPlugin {
-    readonly kind: 'opencli-plugin';
-    readonly pkg: string;
-    readonly name?: string;
-}
-export interface BundleInstallPayload {
-    readonly change: BundleChange;
-    readonly module: BundleModulePayload;
-    readonly supply: BundleSupplyPayload;
-    readonly plugin?: BundleInstalledPlugin;
-}
-export interface BundleRemovePayload {
-    readonly change: BundleChange;
-    readonly keptFor: readonly string[];
-}
-export interface BundleCancellationPayload {
-    readonly cancellation: BundleCancellation | null;
-}
-export interface ModuleVersion {
-    readonly unit: string;
-    readonly pkg: string;
-    readonly installed: string;
-    readonly latest?: string;
-    readonly local?: boolean;
-    readonly refused?: readonly string[];
-}
-export interface WorkbenchVersion {
-    readonly pkg: string;
-    readonly installed: string;
-    readonly latest?: string;
-    readonly running?: string;
-    readonly local?: boolean;
-}
-export interface ModuleVersionsPayload {
-    readonly modules: readonly ModuleVersion[];
-    readonly workbench?: WorkbenchVersion;
-}

package/dist/types/shared/api/config-sync.d.ts

@@ -1,35 +0,0 @@
-export declare const CONFIG_SYNC_ROUTE = "config-sync";
-export declare const CONFIG_SYNC_RESOURCE = "configSync";
-export type ConfigSyncState = 'new' | 'differs';
-export interface ConfigSyncRow {
-    readonly key: string;
-    readonly id: string;
-    readonly insert: boolean;
-    readonly state: ConfigSyncState;
-    readonly body: string;
-    readonly ownBody: string | null;
-    readonly missing: readonly string[];
-}
-export interface ConfigSyncProfile {
-    readonly name: string;
-    readonly readable: boolean;
-    readonly candidates: number;
-}
-export interface ConfigSyncSnapshot {
-    readonly self: string;
-    readonly home: string;
-    readonly source: string;
-    readonly profiles: readonly ConfigSyncProfile[];
-    readonly rows: readonly ConfigSyncRow[];
-    readonly emptyProviders: boolean;
-    readonly reason?: string;
-}
-export interface ConfigSyncApplied {
-    readonly written: readonly string[];
-    readonly skipped: readonly string[];
-}
-export interface ConfigSyncRequest {
-    readonly source: string;
-    readonly keys: readonly string[];
-    readonly overwrite: readonly string[];
-}

package/dist/types/shared/api/dsh-plugins.d.ts

@@ -1,11 +0,0 @@
-export declare const DSH_PLUGINS_ROUTE = "dsh-plugins";
-export interface DshPluginRow {
-    readonly name: string;
-    readonly version: string;
-    readonly enabled: boolean;
-}
-export interface DshPluginsSnapshot {
-    readonly available: boolean;
-    readonly bundles: readonly DshPluginRow[];
-    readonly plugins: readonly DshPluginRow[];
-}

package/dist/types/shared/api/host/bundle-manager.d.ts

@@ -1,11 +0,0 @@
-import type { DshHostContext } from '@dsh-workbench/shared';
-import type { BundleCancellation, BundleChange, BundleInspection, BundleInstallRequest, BundleRegistries, BundleRegistry } from '../bundle-install.js';
-export interface BundleManager {
-    registries(): Promise<BundleRegistries | null>;
-    inspect(spec: string, registry?: BundleRegistry): Promise<BundleInspection | null>;
-    install(request: BundleInstallRequest): Promise<BundleChange | null>;
-    remove(name: string): Promise<BundleChange | null>;
-    setEnabled?(name: string, enabled: boolean): Promise<BundleChange | null>;
-    cancel(requestId: string): Promise<BundleCancellation | null>;
-}
-export declare function readBundleManager(ctx: DshHostContext): BundleManager | undefined;

package/dist/types/shared/api/host/config-sync.d.ts

@@ -1,46 +0,0 @@
-import type { PostResource, RouteHandler } from '@dsh-workbench/shared/host';
-import type { ConfigSyncRow, ConfigSyncSnapshot } from '../config-sync.js';
-export interface PatchBlock {
-    readonly key: string;
-    readonly id: string;
-    readonly insert: boolean;
-    readonly body: string;
-    readonly names: readonly string[];
-}
-export declare function patchBlocks(text: string): PatchBlock[];
-export declare function normalizeBlock(body: string): string;
-export declare function syncRows(source: readonly PatchBlock[], own: readonly PatchBlock[], missing: (block: PatchBlock) => readonly string[]): ConfigSyncRow[];
-export declare function mergeBlocks(ownText: string, incoming: readonly PatchBlock[], overwrite: ReadonlySet<string>): {
-    ok: true;
-    text: string;
-    written: string[];
-    skipped: string[];
-} | {
-    ok: false;
-    reason: string;
-};
-export declare function readPatchBlocks(path: string): {
-    ok: true;
-    text: string;
-    blocks: PatchBlock[];
-} | {
-    ok: false;
-    reason: string;
-};
-export declare function writePatchFile(path: string, text: string): void;
-export interface ConfigSyncDeps {
-    readonly home: string;
-    readonly self: string;
-    readonly profileDir: string | null;
-}
-export declare function configSyncHandler(deps: ConfigSyncDeps): RouteHandler;
-export declare function configSyncSnapshot(deps: ConfigSyncDeps, asked?: string): ConfigSyncSnapshot;
-export declare function configSyncApply(deps: ConfigSyncDeps, payload: unknown): {
-    ok: true;
-    written: string[];
-    skipped: string[];
-} | {
-    ok: false;
-    text: string;
-};
-export declare function configSyncAction(deps: ConfigSyncDeps): PostResource;

package/dist/types/shared/api/host/diy-preset-health.d.ts

@@ -1,35 +0,0 @@
-import type { DshAgentPresetRow, DshHostContext } from '@dsh-workbench/shared';
-/**
- * DIY 模式挂不起来时给用户的那条修法：升级 dsh，再重启一次工作台（启动器那道拒绝用的是同一条）。
- */
-export declare const DIY_UPGRADE_COMMAND = "npm i -g @deepseek-ai/dsh@latest";
-/**
- * 一次 DIY 模式体检的结论：`ok` 为真 = 名册里有那一行且挂着；为假时 `rows` 是挂不起来的行名、`detail` 是 dsh 给的原文。
- */
-export interface DiyPresetVerdict {
-    readonly ok: boolean;
-    readonly rows: readonly string[];
-    readonly detail: string;
-}
-/**
- * 把 dsh 名册里那句 `broken` 原文拆成一项一个行名。
- * @param detail - registry 给的原文，一行一项，形如 `tool-schedule (@deepseek-ai/dsh-tool-schedule): never started`。
- * @returns 每行 `(` 之前那一段；空原文给空数组。
- */
-export declare function brokenRowsOf(detail: string): readonly string[];
-/**
- * 从 preset 名册判 DIY 模式挂不挂得起来。
- * @param presets - `agentPresets.list()` 的回值。
- * @returns 名册还空着（preset 行还没登记完）给 `undefined` —— 那是"还不知道"，不是故障；否则给结论。
- */
-export declare function diyPresetVerdictOf(presets: readonly DshAgentPresetRow[]): DiyPresetVerdict | undefined;
-/**
- * 造一个读 preset 名册的探针：名册还没登记完就每 `everyMs` 重读，到 `deadlineMs` 还没读到就放弃。
- * @param ctx - 宿主上下文（取 `agentPresets` 服务；那个服务不在时给一个恒回 `undefined` 的探针）。
- * @param options - 两个时间旋钮（测试用）：多久放弃、隔多久重读。
- * @returns 探针：调一次读一轮，`undefined` 表示"这次没读到"。
- */
-export declare function createDiyPresetProbe(ctx: DshHostContext, options?: {
-    deadlineMs?: number;
-    everyMs?: number;
-}): () => Promise<DiyPresetVerdict | undefined>;

package/dist/types/shared/api/host/diy-workshop.d.ts

@@ -1,23 +0,0 @@
-export interface WorkshopModule {
-    readonly unit: string;
-    readonly name: string;
-    readonly description: string;
-    readonly dir: string;
-    readonly installed: boolean;
-}
-export declare function insideWorkshop(root: string, target: string): boolean;
-export declare function workshopModules(packagesDir: string, installed?: readonly string[]): readonly WorkshopModule[];
-export declare function readDesignOfModule(dir: string): unknown;
-export interface WorkshopSync {
-    readonly state: 'ok' | 'syncing' | 'failed';
-    readonly version: string;
-    readonly at: string;
-    readonly reason?: string;
-}
-export declare function workshopSyncOf(workshopRoot: string): WorkshopSync | undefined;
-export interface WorkshopToolchain {
-    readonly core: string;
-    readonly moduleTools: string;
-    readonly shared: string;
-}
-export declare function workshopToolchainOf(workshopRoot: string): WorkshopToolchain | undefined;

package/dist/types/shared/api/host/dsh-plugins.d.ts

@@ -1,5 +0,0 @@
-import type { DshHostContext } from '@dsh-workbench/shared';
-import type { RouteHandler } from '@dsh-workbench/shared/host';
-import type { DshPluginsSnapshot } from '../dsh-plugins.js';
-export declare function readDshPlugins(ctx: DshHostContext): Promise<DshPluginsSnapshot>;
-export declare function dshPluginsHandler(ctx: DshHostContext): RouteHandler;