dsh-context-truth 0.1.3 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,10 +1,12 @@
1
1
  # dsh-context-truth
2
2
 
3
+ [![Listed on dsh-plugin.org](https://dsh-plugin.org/badges/listed.svg)](https://dsh-plugin.org/plugins/deepseekv41flash/dsh-context-truth)
4
+
3
5
  [English](README-en.md) · [简体中文](README.md)
4
6
 
5
7
  > 让模型知道自己**真实的**上下文占用——每轮由宿主实测回填,并且不让"上下文快用完了"这句错话被压缩摘要继承下去。
6
8
 
7
- DSH(DeepSeek Harness)插件 · 零依赖 · 零工具 · 零 UI · 免构建 · MIT
9
+ DSH(DeepSeek Harness)插件 · 单一 peer 依赖(宿主自带的 `schemastery`)· 需要宿主服务 `tokenMeter` 与 `compaction`(标准部署的 `dsh-base` 自带)· 1 个工具(`handoff_ready`,交接式折叠用)· 1 个客户端设置卡片 · 免构建 · MIT
8
10
 
9
11
  ---
10
12
 
@@ -22,7 +24,7 @@ DSH(DeepSeek Harness)插件 · 零依赖 · 零工具 · 零 UI · 免构建
22
24
 
23
25
  本插件同时掐断这条链的两端。
24
26
 
25
- ## 两个能力
27
+ ## 三个能力
26
28
 
27
29
  ### 1. 实测占用回填(默认开)
28
30
 
@@ -41,6 +43,50 @@ estimate it from the conversation's length.
41
43
  读数不足一个显示台阶时渲染为 `under 50K / 1.00M tokens used (under 5%)`——不会渲染成 `0`,
42
44
  那会和同一行里的剩余量自相矛盾。
43
45
 
46
+ **余量还能撑几步**:`tight` / `critical` 档会把这行余量换算成本会话自己的节奏,例如
47
+ `At this session's recent rate that is roughly 6 more steps.`。它是**测出来的**,不是猜的——
48
+ 每步增量取"步边界之间读数差"的**中位数**,步号来自宿主自己的 `(turn, step)` 计数器。所以
49
+ 一次 30K 的工具结果拖不动它;而压缩折叠会让读数重锚(实测 200K → 不足 50K,3 秒内),
50
+ 负增量会**清空历史**、让估算重新累积,绝不与旧基线平均。档位取 `1/2/3/5/8/13/20+` 且**向下取整**
51
+ (与余量本身同方向:绝不承诺比真实节奏更多的步数)。顶部是开放档:实测里原始步数在 23~38 之间
52
+ 摆动、正骑在旧的 `21/34` 边界上,90 秒内让这一行翻了 4 次(其中一次快照重发完全由翻档造成),
53
+ 而 20 步以上那个精确数字并不改变任何决策。档位另带**单边迟滞**:向下立即生效(少承诺的余量绝不
54
+ 拖延),向上要超出该档 25%(`paceMargin`)才改口——骑在边界上的估算翻不动它,真正变慢的会话
55
+ 也不会被永久卡住。它纯属展示——不参与分档、阈值或任何折叠判定;关掉它就是 0.1.3 的行文本。
56
+
57
+ **`tight` 档默认什么都不说**:这一档只报数字(已用、阈值、剩余量、约合几步),**不加任何收尾句**。
58
+ 这是被实测逼出来的结论——三种措辞试过:0.1.3 命令"收尾、交接",0.1.4 陈述"快折叠了,别让关键状态
59
+ 只留在对话里",两者都让模型开始在回复里**反复谈论压缩**并降低工作积极性,而 tight 恰恰是重发最
60
+ 频繁的档(实测该档提交 333 次、间隔中位数 45 秒、成串出现 4~20 秒)。`tightAdvice: 'inform'` 可
61
+ 恢复 0.1.4 那句,`'stop'` 恢复 0.1.3 的祈使句。
62
+
63
+ **这行会明说自己是遥测——而且不是一笔可以花掉的预算**:收尾句是"本行是宿主的后台遥测……不要提起它、
64
+ 不要凭对话长度估计压力、**不要自行倒计时**(读数变化时它会自动重述),也不要对压缩采取任何动作:
65
+ **折叠由宿主在步与步之间自动完成**"。后半句同样是被实测逼出来的:模型前几次还抄得准,之后就自己往下
66
+ 减——`30K → 28K → 16K → 10K → 7K → 5K`——而宿主报的数一直停在 `About 10K`(它只在跨档时重述)。
67
+ 12 分钟后模型宣布 "Context is nearly exhausted (~5K)",这个数宿主从未报过。
68
+
69
+ **这行同时回答"我还剩多少上下文"**:它原先只印"距折叠点的余量",从没印"窗口还剩多少"。实测里模型
70
+ 用前者回答了后者——在余量 `Under 10K` 时写下 "Very low context",而当时**窗口还有 350K 未使用**:
71
+ 两个数都是真的,但只有一个回答了它的问题。现在每一档都带 `About 300K of the window is still free`,
72
+ 而且**一个数字都没删**:我们认真考虑过在临近折叠时撤掉余量数字,结论是**不能这么做**——两个端点
73
+ (已用量、折叠点)本来就印在行里,模型做一次减法照样能得到,撤掉一个可推导的数字只会在最需要
74
+ 真值的时刻重建最初那个 bug 的前提(没有基准 → 凭空猜)。它与"已用"共用同一个显示台阶,因此不带来
75
+ 额外重发;`freeClause: false` 可关闭。
76
+
77
+ **余量小的两档会定义"折叠是什么"**:光给数字还留着一个缺口,实测里模型正好踩进去——那一行报出
78
+ `Under 10K tokens of headroom remain before it` 之后 **11 秒**,模型写下 "Very low context. I must do
79
+ this in as few commands as possible, then a short answer."。数字它读对了,但它把"距折叠的余量"理解成
80
+ 了"剩下的上下文",而当时窗口还剩 350K、折叠只是把较早的对话换成摘要。所以 `tight` 档补上一句
81
+ **定义**(不是指令):"折叠是例行操作,不是窗口的终点:较早的对话会被折成摘要,之后工作照常继续。"
82
+ `critical` 档用短版:"窗口并未耗尽——折叠之后工作照常继续。" 两句都不含任何动作要求,因此不会退化成
83
+ 0.1.3 那种"收尾/交接"的催促。`foldClause: false` 可关闭。
84
+
85
+ **余量档位在临近阈值时保持粗粒度**:早先的实现会在余量变少时把档位缩到 2K,而那正是这一行重发最
86
+ 频繁的区间,于是几乎每一步都跳一次。现在档位下限是窗口量子的 10%(1M 窗口即 10K):距阈值只有几
87
+ 万 tokens 时,"约合几步"才是有效信号,而小于一档的余量仍会如实渲染成 `Under 10K`。从 128K 余量走
88
+ 到 0,这行的重发次数由 **23 次降到 11 次**。
89
+
44
90
  ### 2. 压缩指令补规则(默认开)
45
91
 
46
92
  压缩摘要调用的最后一条消息就是摘要指令。本插件通过**公开的 `llm/stream` 瀑布**在它末尾追加
@@ -60,6 +106,60 @@ estimate it from the conversation's length.
60
106
  消息**以指令开头**——所以"只是引用了引擎"的工具结果(源码转储、日志片段、grep 命中)不会被
61
107
  误改,也不会吃掉那条一次性失败告警。
62
108
 
109
+ **实测(2026-10-12,长会话两次自动折叠)**:压缩请求里带上的是**补丁后**的指令,采集到的尾部
110
+ 指令 **2,336 字符**(原指令 1,802 + 两条规则 534),三条规则特征串全部命中;同一时刻接缝上
111
+ `compaction-cache: aligned` 那行与本插件的请求相隔 **19 毫秒**(21:46:08.085 / 21:46:08.104),
112
+ 两个插件互为交叉验证。附带确认:被追加的那条消息在补丁后**不是冻结对象**——本插件替换的是
113
+ 数组槽位(而非改写原对象),所以不受引擎对追加消息的 `deepFreeze` 影响。
114
+
115
+ **代价**:指令从 1,802 涨到 2,336 字符,**+534 字符 ≈ +134 token(+0.09%)**;因为只加在
116
+ 缓存前缀**之后**,这 134 token 就是每次折叠唯一新增的全价输入。
117
+
118
+ ### 3. 轮末折叠:`idle`(默认)/ `handoff`(实验性)
119
+
120
+ 宿主的自动压缩是一个**"跨过阈值"**触发器,而模型在临近阈值时的行为——合并往返、回避高风险改动、
121
+ 改到一半就提交 WIP——**恰好使读数永远停在阈值下面**。实测一个长会话:
122
+
123
+ ```
124
+ 4 小时零折叠 · 每轮只有 2~8 步 · 连续三次"继续"仍无法完成同一个任务
125
+ 读数长期停在 "Under 10K tokens of headroom remain"
126
+ ```
127
+
128
+ `foldMode` 决定本插件在**模型自己的回合边界**(`agent/status === 'idle'`)做什么:
129
+
130
+ | 模式 | 行为 |
131
+ |---|---|
132
+ | `off` | 只报告占用,从不折叠。想完全交给宿主的压力触发时用它。 |
133
+ | `idle` | **默认。** 读数进入 `foldAtIdleMarginPercent`(默认窗口的 5%,1M 窗口即 50K)以内时调用官方 `compaction.compactNow()`。官方引擎本来就只允许在 idle 时压缩,所以时机正好。折完余量回到几百 K,条件不再满足 → **一个周期只折一次**。 |
134
+ | `handoff` | **实验性。** 先让模型写交接档,再折叠,折叠后自动开唯一一轮把档读回来。见下。 |
135
+
136
+ > 兼容性:没写过 `foldMode` 的旧配置按 `idle` 处理(它就是本插件此前的行为,当时由 `foldAtIdle: true` 打开);
137
+ > 显式写过 `foldAtIdle: false` 的配置仍然解析成 `off`,不会被这次改默认值带走。显式 `foldMode` 永远优先。
138
+
139
+ #### 交接式折叠(`handoff`,实验性)
140
+
141
+ 长任务真正贵的不是摘要本身,而是**折叠后的重复劳动**:模型不知道什么时候会被折,折叠后又
142
+ 基于摘要重建画面,于是把上一轮已经做过的事再做一遍。基线测量(143 次折叠):**81 次(57%)
143
+ 折叠后重新读取了自己刚写过的文件,合计 225 次**。
144
+
145
+ 这条链路是:
146
+
147
+ 1. 读数到达**准备点**(`handoffAt` × 折叠点,默认 85%)时,插件往本会话注入一条提醒,给出**唯一**
148
+ 允许的交接档路径(`$DSH_HOME/handoffs/<sessionId>/<fold#>.handoff.md`,绝不写进工作区);
149
+ 2. 模型把"折叠后的自己需要知道的一切"写进这份档(目标、已定案、证据、下一步、走过的死路),
150
+ 然后调用 `handoff_ready` 登记;
151
+ 3. 这一轮结束时插件调用 `compactNow()` 真正折叠;
152
+ 4. 折叠后插件用 `followup` **只自动激活一轮**,第一条指令就是"先读这份档,再从它的下一步继续"。
153
+
154
+ 护栏:提醒每周期最多 3 次;某个回合结束时如果模型还没登记、但已过准备点,插件会用
155
+ `followup` **唤醒**一轮把提醒送到(`agent.inject` 只排进下一次请求,轮次结束时没人再发请求,
156
+ 提醒就会一直等人类开口——实测踩过);交接档是临时文件,下一次交接生成时回收旧的、7 天兜底清理;
157
+ 登记了档但没折成(引擎拒绝、被别的东西先折了)时不会激活,档保留。
158
+
159
+ **切换模式立即生效,不需要重启**:`foldMode` 是 volatile 配置,设置卡直接写进运行中的引用,
160
+ 插件每次调用都重新解析选项(实测:面板切到 `handoff` 后,运行中的实例在下一次调用就按 handoff 执行)。
161
+ 但切换本身**不会触发折叠**——折叠仍要等读数到点。
162
+
63
163
  ## 数据来源(都是宿主的真实数字,没有估算)
64
164
 
65
165
  | 项目 | 来源 |
@@ -89,7 +189,17 @@ dsh plugin --profile web add dsh-context-truth
89
189
  ```
90
190
 
91
191
  本包带 `dsh.bundle.patch`,作为 bundle 列进 profile 的 `dsh.profile.bundles` 也会自动装配。
92
- **没有任何依赖、不需要构建**:`lib/index.js` 同时是源码和产物。
192
+ **不需要构建**:`lib/index.js` 同时是源码和产物。
193
+
194
+ **宿主要求**:`inject = ['systemPrompt', 'tokenMeter']` —— **两个**。`compaction` 是**刻意不声明**的:
195
+ 声明它会让条目**永久 pending**(插件完全不加载,第 1 个能力的占用行也一起消失),已向上游报告
196
+ [#9425](https://github.com/deepseek-ai/deepseek-harness/discussions/9425)。
197
+
198
+ 第 3 个能力在折叠时自己按**候选链**去找引擎:`agent.ctx` → `ctx` → 已接线服务,取第一个**真的带
199
+ `compactNow`** 的实现(不是"第一个不是 undefined 的"——对一个本 fiber 没有的服务做属性读取会返回
200
+ **诊断字符串**而不是 `undefined`,这是踩过的坑)。所以启动诊断里那行
201
+ `compaction=undefined/none` **只反映插件自身 ctx 的可见性,不代表折叠不可用**:本 profile 现在
202
+ 打印的就是 `undefined/none`,而 2026-10-12 的两次自动折叠都成功完成了。
93
203
 
94
204
  ## 配置(全部可选)
95
205
 
@@ -99,16 +209,55 @@ dsh plugin --profile web add dsh-context-truth
99
209
  | `language` | `en` | `en` / `zh` 文案语言 |
100
210
  | `order` | `100` | 在 runtime-context 里的排序(沙箱 110、审批 115,所以在最前) |
101
211
  | `quantumPercent` | `5` | 显示台阶(窗口百分比),决定重发频率 |
212
+ | `paceEstimate` | `true` | 是否把余量换算成本会话节奏(`tight`/`critical` 档) |
213
+ | `paceSamples` | `16` | 节奏取中位数的样本数(近 N 步增量) |
214
+ | `paceMinSamples` | `3` | 少于此样本数不显示估算 |
215
+ | `paceMargin` | `0.25` | 向上换档需超出该档的比例(防抖,且不会卡死) |
102
216
  | `thresholdRatio` | `0.8` | 与 `dsh-compaction-basic` 对齐 |
103
217
  | `headroomTokens` | `65536` | 同上 |
104
218
  | `reservedCompletionTokens` | `null` | 默认读路由请求自身的 `maxTokens` |
105
219
  | `moderateAt` / `tightAt` | `0.5` / `0.85` | 分档边界(相对自动压缩点) |
106
220
  | `hysteresis` | `0.05` | 降档迟滞 |
221
+ | `tightAdvice` | `none` | `tight` 档收尾句:`none` 不加(默认);`inform` 陈述后果;`stop` 用 0.1.3 的命令式 |
107
222
  | `authoritative` | `true` | 是否附加"本行是唯一权威"那句 |
108
223
  | `staleClaimClause` | `true` | 是否在 calm 档声明旧说法作废 |
224
+ | `foldClause` | `true` | 是否在 `tight`/`critical` 档定义"折叠是什么" |
225
+ | `freeClause` | `true` | 是否报告"窗口还剩多少未使用" |
109
226
  | `logBandChanges` | `true` | 分档变化时写一条 `ctx.logger.info` |
110
227
  | `patchCompactionPrompt` | `true` | 是否给压缩指令补规则 |
111
228
  | `compactionRules` | 见上 | 规则数组;`[]` 关闭本能力 |
229
+ | `foldMode` | `idle` | 轮末折叠模式:`off` / `idle`(默认)/ `handoff`(实验性)。设置卡直接写这个键,切换立即生效 |
230
+ | `handoffAt` | `0.85` | 交接提醒的准备点,作为**折叠点**的比例(不是窗口比例) |
231
+ | `handoffDir` | `''` | 交接档目录;空=`$DSH_HOME/handoffs`,相对路径也落在 `$DSH_HOME` 下,绝不进工作区 |
232
+ | `handoffReminders` | `3` | 每个周期最多提醒几次(含轮末唤醒) |
233
+ | `foldAtIdle` | `false` | 旧开关,等价于 `foldMode: idle`;显式 `false` 等价于 `off`,只对没写过 `foldMode` 的配置生效 |
234
+ | `foldAtIdleMarginPercent` | `5` | 余量 ≤ 窗口的百分之几时触发(1M 窗口 = 50K) |
235
+ | `foldAtIdleMethod` | `auto` | 折叠请求通道:`auto`=先走该会话的 `/compact`(realm 视图)再回退到服务候选链;`command`/`service` 强制其一。`service` 是最可预测的一档(本 profile 用它) |
236
+ | `foldAtIdleCooldownMs` | `60000` | 两次尝试之间的最小间隔(失败也不会反复撞引擎) |
237
+
238
+ **配置写在 profile patch 里**(`subagent` 的 `maxDepth`、`bash-terminal` 的 `defaultShell` 都是这样生效的):
239
+
240
+ ```yaml
241
+ - id: context-truth # 与 bundle patch 里的行 id 相同
242
+ name: dsh-context-truth
243
+ config:
244
+ foldMode: idle # off / idle(默认)/ handoff(实验性)
245
+ foldAtIdleMarginPercent: 5
246
+ ```
247
+
248
+ 改动**立即生效**:宿主的 volatile 机制把新值直接写进运行中的配置引用(`loader._commitVolatile`),
249
+ 不重载插件;插件因此每次使用时才解析选项,而不是挂载时快照。实测:改完 patch 无需重启,运行中的
250
+ `foldMode` 立刻变成新模式(见上文"切换模式立即生效")。
251
+
252
+ > **设置卡不是自动生成的,但这个插件自己带了一张。** 这个 DSH 版本不会按 `Config` schema 自动生成
253
+ > 插件设置表单:官方插件都是各自客户端包手写的卡片,宿主只负责把 `plugins.bundle.config` /
254
+ > `plugins.row.config` 这些插槽的**注册**接进插件页。本包自 0.3.0 起带 `lib/client.js`
255
+ > (`package.json` 里声明 `dsh.client` + `exports["./client"]`),注册的是
256
+ > `plugins.bundle.config`(key = 包名 `dsh-context-truth`),渲染一个"折叠模式"下拉框,
257
+ > 读写走 `settings.describe()` / `settings.mutate()`。它出现在插件页 dsh-context-truth 的详情里。
258
+ > 没有这张卡时,只能改 profile patch(上面那种写法)。
259
+
260
+ `enabled`(总开关)用**插件列表里的开关**即可——那一个会重载插件。
112
261
 
113
262
  ## 代价(照实说)
114
263
 
@@ -124,7 +273,8 @@ runtime-context 快照**字节不变就不会重发**,所以读数按台阶量
124
273
  ## 兼容性与边界
125
274
 
126
275
  * 在 **dsh 0.2.0-rc.2** 上实测;只用公开接缝(`systemPrompt.variable/context`、`llm/stream` 瀑布、
127
- `tokenMeter` / `sessionProjections` 服务),不读私有字段。
276
+ `tokenMeter` / `sessionProjections` 服务)。唯一例外:节奏估算读宿主的 `agent.phase.{turn,step}`
277
+ 实例字段(未文档化)——拿不到时该子句**整段不出现**,行文本退回 0.1.3 的样子,绝不猜一个数。
128
278
  * 若某个 agent preset 设置了 `includeRuntimeContext: false`(例如 `liangshen`),运行时会抑制
129
279
  **所有** runtime-context 贡献,此时第 1 个能力不生效(第 2 个不受影响)。
130
280
  * 若宿主把请求信封冻结(**本版没有**——已通过抓取真实压缩请求验证),第 2 个能力会打一条
@@ -133,12 +283,17 @@ runtime-context 快照**字节不变就不会重发**,所以读数按台阶量
133
283
  * **同一作用域挂载两次不会失败**:bundle 装配 + 运行时注入是同一插件的两条装配路径,
134
284
  第二个实例检测到重名后保持静默(只记一条 info),由第一个实例继续服务——不会变成
135
285
  一行 failed 的插件记录。
136
- * 本插件不注册任何工具、不改工具目录,因此不增加首轮 prefill。
286
+ * 本插件注册 **1 个工具**:`handoff_ready`(交接档登记)。它在所有模式下都会出现在工具目录里
287
+ (设置卡需要能随时切换模式),不产生额外调用;只有 handoff 模式会用它。工具定义很小,但仍算
288
+ **一次首轮 prefill** 的成本——这是本插件唯一改工具目录的地方。折叠本身不经过模型工具调用
289
+ (插件直接调 `compaction.compactNow()`),所以 `off`/`idle` 模式下模型侧看不到任何折叠活动。
290
+ * 本插件带 **1 个客户端模块**(`lib/client.js`,插件页的设置卡)。它只读 `settings.describe()`、
291
+ 写 `settings.mutate()`,不碰工作区、不发网络请求。
137
292
 
138
293
  ## 验证
139
294
 
140
295
  ```sh
141
- npm test # 28 项单测:分档/迟滞/量化/不足一档的渲染/降级/摘要改写/形似请求排除/幂等/重复挂载
296
+ npm test # 69 项单测:分档/迟滞/量化/自由窗口/折叠定义/空闲折叠与护栏/配置热更新/schema 默认值一致性/节奏估算/降级/摘要改写/形似请求排除/幂等/交接式折叠(提醒、登记、轮末折叠、单次激活、重启恢复、回收、轮末唤醒)/客户端设置卡结构
142
297
  ```
143
298
 
144
299
  装好后开一个新会话发一条消息,展开该轮的 runtime context 块应看到
@@ -147,7 +302,8 @@ npm test # 28 项单测:分档/迟滞/量化/不足一档的渲染/
147
302
 
148
303
  ## 卸载
149
304
 
150
- 从 profile patch / bundles 里删掉那一行即可,重启即净——没有工具、没有客户端、没有落盘状态。
305
+ 从 profile patch / bundles 里删掉那一行即可,重启即净——没有落盘状态(例外:handoff 模式在
306
+ `$DSH_HOME/handoffs/<sessionId>/` 下写交接档和一份状态文件,删掉那个目录即净)。
151
307
 
152
308
  ## License
153
309
 
package/lib/client.js ADDED
@@ -0,0 +1,154 @@
1
+ /**
2
+ * Browser half of dsh-context-truth: the fold-mode panel on the plugin's page.
3
+ *
4
+ * Why this file exists: DSH does not auto-render a plugin's `Config` as a settings
5
+ * form. A plugin row gets a configure panel only when a client module registers a
6
+ * `plugins.bundle.config` (bundle level) or `plugins.row.config` slot key — see
7
+ * `dsh-client-ui-plugin-manager`'s config ledger. `dsh-auto-retry` and the official
8
+ * cot-translation bundle both ship a `./client` module for exactly that reason, so
9
+ * this plugin needs one too, otherwise its 29-field schema is unreachable from the UI.
10
+ *
11
+ * The panel talks to the settings Remote directly:
12
+ * settings.describe() -> { ok, value: { namespaces: [{ ns, revision, value, ... }] } }
13
+ * settings.mutate(ns, ops, expectedRevision)
14
+ * Both are the same calls the built-in settings page makes.
15
+ */
16
+ window.__ModuleLoader__.load({
17
+ id: 'dsh-context-truth',
18
+ factory: (require) => {
19
+ const module = { exports: {} }
20
+ const exports = module.exports
21
+ const React = require('react')
22
+
23
+ const NS = 'context-truth'
24
+ const LABEL = {
25
+ title: '折叠模式 / Fold mode',
26
+ hint:
27
+ '默认 idle:到点后在模型自己的轮次边界折叠。' +
28
+ ' handoff 为实验特性:先写交接档、折叠后自动回读一次。' +
29
+ ' 切换立即生效,不需要重启;但切换本身不会触发折叠。',
30
+ off: 'off — 只报告,不折叠',
31
+ idle: 'idle — 自动闲时压缩(默认)',
32
+ handoff: 'handoff — 交接式折叠(实验性)',
33
+ saving: '保存中…',
34
+ saved: '已保存',
35
+ }
36
+
37
+ const messageOf = (error) =>
38
+ error === null || error === undefined ? 'unknown error' : error.message ?? String(error)
39
+
40
+ /** One row: a mode select bound to the `foldMode` field of the live config. */
41
+ function FoldModePanel(props) {
42
+ const [state, setState] = React.useState({ status: 'loading', revision: 0, mode: undefined, note: null })
43
+
44
+ const load = React.useCallback(async () => {
45
+ try {
46
+ const response = await props.settings.describe()
47
+ if (!response.ok) throw new Error(`settings.describe failed: ${messageOf(response.error)}`)
48
+ const view = (response.value.namespaces || []).find((row) => row.ns === NS)
49
+ if (view === undefined) throw new Error(`settings namespace "${NS}" is not served`)
50
+ setState({
51
+ status: 'ready',
52
+ revision: view.revision,
53
+ mode: view.value === undefined ? undefined : view.value.foldMode,
54
+ note: null,
55
+ })
56
+ } catch (error) {
57
+ setState((previous) => ({ ...previous, status: 'error', note: messageOf(error) }))
58
+ }
59
+ }, [props.settings])
60
+
61
+ React.useEffect(() => {
62
+ load()
63
+ }, [load])
64
+
65
+ const choose = React.useCallback(
66
+ async (event) => {
67
+ const value = event.target.value
68
+ setState((previous) => ({ ...previous, status: 'saving', note: LABEL.saving }))
69
+ try {
70
+ const ops = [{ op: 'set', path: ['foldMode'], value }]
71
+ const response = await props.settings.mutate(NS, ops, state.revision)
72
+ if (!response.ok) throw new Error(`settings.mutate failed: ${messageOf(response.error)}`)
73
+ // On success the Remote returns the fresh namespace view, so no second
74
+ // describe() is needed (the built-in form controller relies on the same).
75
+ const view = response.value
76
+ setState({
77
+ status: 'ready',
78
+ revision: view === undefined ? state.revision : view.revision,
79
+ mode: view === undefined || view.value === undefined ? undefined : view.value.foldMode,
80
+ note: LABEL.saved,
81
+ })
82
+ } catch (error) {
83
+ setState((previous) => ({ ...previous, status: 'error', note: messageOf(error) }))
84
+ }
85
+ },
86
+ [props.settings, state.revision],
87
+ )
88
+
89
+ const current = state.mode === undefined ? 'idle' : state.mode
90
+ const busy = state.status === 'saving'
91
+ const note = state.note
92
+ return React.createElement(
93
+ 'div',
94
+ { style: { display: 'flex', flexDirection: 'column', gap: '6px', padding: '4px 0' } },
95
+ React.createElement(
96
+ 'label',
97
+ { style: { display: 'flex', alignItems: 'center', gap: '8px', fontSize: '13px' } },
98
+ React.createElement('span', { style: { fontWeight: 600 } }, LABEL.title),
99
+ React.createElement(
100
+ 'select',
101
+ {
102
+ value: current,
103
+ disabled: busy,
104
+ onChange: choose,
105
+ 'aria-label': LABEL.title,
106
+ style: { minWidth: '220px', padding: '2px 4px' },
107
+ },
108
+ React.createElement('option', { value: 'off' }, LABEL.off),
109
+ React.createElement('option', { value: 'idle' }, LABEL.idle),
110
+ React.createElement('option', { value: 'handoff' }, LABEL.handoff),
111
+ ),
112
+ ),
113
+ React.createElement('span', { style: { fontSize: '12px', opacity: 0.65 } }, LABEL.hint),
114
+ note === null
115
+ ? null
116
+ : React.createElement(
117
+ 'span',
118
+ {
119
+ role: state.status === 'error' ? 'alert' : 'status',
120
+ style: { fontSize: '12px', color: state.status === 'error' ? '#e5534b' : 'inherit', opacity: state.status === 'error' ? 1 : 0.75 },
121
+ },
122
+ note,
123
+ ),
124
+ )
125
+ }
126
+
127
+ /** Client services: slots to register the panel, remote.settings to read/write it. */
128
+ const inject = ['slots', 'remote', 'remote.settings']
129
+
130
+ function apply(ctx) {
131
+ ctx.effect(
132
+ () =>
133
+ ctx.slots.inject('plugins.bundle.config', () =>
134
+ ctx.slots.register(
135
+ {
136
+ name: 'plugins.bundle.config',
137
+ id: 'context-truth-fold',
138
+ // The ledger matches this key against the bundle package name.
139
+ key: 'dsh-context-truth',
140
+ order: 10,
141
+ inject: () => ({ settings: ctx.remote.settings }),
142
+ },
143
+ FoldModePanel,
144
+ ),
145
+ ),
146
+ 'context-truth: fold mode panel',
147
+ )
148
+ }
149
+
150
+ exports.apply = apply
151
+ exports.inject = inject
152
+ return module.exports
153
+ },
154
+ })