@waq666/pneuma 0.0.0-stage → 0.7.1

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.
Files changed (708) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +206 -3
  3. package/bin/dsc.js +91 -0
  4. package/bin/headless.cjs +40 -0
  5. package/lib/adapter/core-runtime.d.ts +11 -0
  6. package/lib/adapter/core-runtime.js +259 -0
  7. package/lib/adapter/host.d.ts +18 -0
  8. package/lib/adapter/host.js +14 -0
  9. package/lib/adapter/runtime.d.ts +15 -0
  10. package/lib/adapter/runtime.js +290 -0
  11. package/lib/adapter/transcript.d.ts +184 -0
  12. package/lib/adapter/transcript.js +605 -0
  13. package/lib/app/AgentsOverlay.d.ts +18 -0
  14. package/lib/app/AgentsOverlay.js +63 -0
  15. package/lib/app/App.d.ts +15 -0
  16. package/lib/app/App.js +1650 -0
  17. package/lib/app/App.js.nv-backup +1650 -0
  18. package/lib/app/ApprovalCard.d.ts +12 -0
  19. package/lib/app/ApprovalCard.js +76 -0
  20. package/lib/app/AskCard.d.ts +20 -0
  21. package/lib/app/AskCard.js +45 -0
  22. package/lib/app/ChatView.d.ts +63 -0
  23. package/lib/app/ChatView.js +310 -0
  24. package/lib/app/Composer.d.ts +50 -0
  25. package/lib/app/Composer.js +282 -0
  26. package/lib/app/DiffBlock.d.ts +6 -0
  27. package/lib/app/DiffBlock.js +37 -0
  28. package/lib/app/MarkdownView.d.ts +6 -0
  29. package/lib/app/MarkdownView.js +99 -0
  30. package/lib/app/ModelPicker.d.ts +7 -0
  31. package/lib/app/ModelPicker.js +18 -0
  32. package/lib/app/PlanReviewCard.d.ts +13 -0
  33. package/lib/app/PlanReviewCard.js +54 -0
  34. package/lib/app/PresetPicker.d.ts +11 -0
  35. package/lib/app/PresetPicker.js +19 -0
  36. package/lib/app/PreviewOverlay.d.ts +14 -0
  37. package/lib/app/PreviewOverlay.js +22 -0
  38. package/lib/app/SessionPicker.d.ts +43 -0
  39. package/lib/app/SessionPicker.js +56 -0
  40. package/lib/app/SettingsOverlay.d.ts +32 -0
  41. package/lib/app/SettingsOverlay.js +157 -0
  42. package/lib/app/SkillsPicker.d.ts +7 -0
  43. package/lib/app/SkillsPicker.js +19 -0
  44. package/lib/app/StatusBar.d.ts +22 -0
  45. package/lib/app/StatusBar.js +201 -0
  46. package/lib/app/TaskStrips.d.ts +13 -0
  47. package/lib/app/TaskStrips.js +40 -0
  48. package/lib/app/TimelineRail.d.ts +22 -0
  49. package/lib/app/TimelineRail.js +160 -0
  50. package/lib/app/TimelineRail.js.negbak +98 -0
  51. package/lib/app/TimelineRail.js.nv-backup +160 -0
  52. package/lib/app/ToolCard.d.ts +11 -0
  53. package/lib/app/ToolCard.js +64 -0
  54. package/lib/app/ToolCard.js.nv-backup +64 -0
  55. package/lib/app/TranscriptOverlay.d.ts +27 -0
  56. package/lib/app/TranscriptOverlay.js +36 -0
  57. package/lib/app/TranscriptViewport.d.ts +78 -0
  58. package/lib/app/TranscriptViewport.js +218 -0
  59. package/lib/app/Welcome.d.ts +6 -0
  60. package/lib/app/Welcome.js +71 -0
  61. package/lib/app/attach.d.ts +16 -0
  62. package/lib/app/attach.js +58 -0
  63. package/lib/app/click.d.ts +40 -0
  64. package/lib/app/click.js +103 -0
  65. package/lib/app/clipboard-image.d.ts +11 -0
  66. package/lib/app/clipboard-image.js +66 -0
  67. package/lib/app/cursor.d.ts +4 -0
  68. package/lib/app/cursor.js +24 -0
  69. package/lib/app/hello.d.ts +11 -0
  70. package/lib/app/hello.js +8 -0
  71. package/lib/app/history-store.d.ts +4 -0
  72. package/lib/app/history-store.js +41 -0
  73. package/lib/app/image-blocks.d.ts +12 -0
  74. package/lib/app/image-blocks.js +125 -0
  75. package/lib/app/keymap.d.ts +56 -0
  76. package/lib/app/keymap.js +56 -0
  77. package/lib/app/markdown.d.ts +54 -0
  78. package/lib/app/markdown.js +189 -0
  79. package/lib/app/mouse.d.ts +33 -0
  80. package/lib/app/mouse.js +35 -0
  81. package/lib/app/pointer.d.ts +16 -0
  82. package/lib/app/pointer.js +60 -0
  83. package/lib/app/scroll-model.d.ts +240 -0
  84. package/lib/app/scroll-model.js +347 -0
  85. package/lib/app/settings-model.d.ts +69 -0
  86. package/lib/app/settings-model.js +114 -0
  87. package/lib/app/snapshot-subscribe.d.ts +34 -0
  88. package/lib/app/snapshot-subscribe.js +110 -0
  89. package/lib/app/theme.d.ts +194 -0
  90. package/lib/app/theme.js +186 -0
  91. package/lib/app/ticker.d.ts +7 -0
  92. package/lib/app/ticker.js +53 -0
  93. package/lib/boot.d.ts +1 -0
  94. package/lib/boot.js +34 -0
  95. package/lib/commands.d.ts +49 -0
  96. package/lib/commands.js +115 -0
  97. package/lib/contract.d.ts +1973 -0
  98. package/lib/contract.js +36 -0
  99. package/lib/core/agent-roles.d.ts +52 -0
  100. package/lib/core/agent-roles.js +274 -0
  101. package/lib/core/approval-floor.d.ts +183 -0
  102. package/lib/core/approval-floor.js +679 -0
  103. package/lib/core/approval.d.ts +42 -0
  104. package/lib/core/approval.js +8 -0
  105. package/lib/core/audit.d.ts +61 -0
  106. package/lib/core/audit.js +59 -0
  107. package/lib/core/boot-notices.d.ts +6 -0
  108. package/lib/core/boot-notices.js +61 -0
  109. package/lib/core/cdp/actions.d.ts +182 -0
  110. package/lib/core/cdp/actions.js +649 -0
  111. package/lib/core/cdp/launch.d.ts +192 -0
  112. package/lib/core/cdp/launch.js +491 -0
  113. package/lib/core/cdp/snapshot.d.ts +139 -0
  114. package/lib/core/cdp/snapshot.js +316 -0
  115. package/lib/core/cdp/transport.d.ts +160 -0
  116. package/lib/core/cdp/transport.js +359 -0
  117. package/lib/core/command-policy.d.ts +108 -0
  118. package/lib/core/command-policy.js +580 -0
  119. package/lib/core/commands-completion.d.ts +78 -0
  120. package/lib/core/commands-completion.js +167 -0
  121. package/lib/core/compact-anchors.d.ts +76 -0
  122. package/lib/core/compact-anchors.js +284 -0
  123. package/lib/core/compact.d.ts +110 -0
  124. package/lib/core/compact.js +210 -0
  125. package/lib/core/config-store.d.ts +38 -0
  126. package/lib/core/config-store.js +307 -0
  127. package/lib/core/config.d.ts +36 -0
  128. package/lib/core/config.js +124 -0
  129. package/lib/core/connection-test.d.ts +60 -0
  130. package/lib/core/connection-test.js +84 -0
  131. package/lib/core/desktop-control.d.ts +298 -0
  132. package/lib/core/desktop-control.js +1311 -0
  133. package/lib/core/diff-text.d.ts +74 -0
  134. package/lib/core/diff-text.js +257 -0
  135. package/lib/core/dock-browser.d.ts +137 -0
  136. package/lib/core/dock-browser.js +146 -0
  137. package/lib/core/dock-ops.d.ts +59 -0
  138. package/lib/core/dock-ops.js +104 -0
  139. package/lib/core/dock-session.d.ts +39 -0
  140. package/lib/core/dock-session.js +28 -0
  141. package/lib/core/dsh-compat/hook.d.ts +18 -0
  142. package/lib/core/dsh-compat/hook.js +52 -0
  143. package/lib/core/dsh-compat/resolve-hook.d.ts +5 -0
  144. package/lib/core/dsh-compat/resolve-hook.js +59 -0
  145. package/lib/core/dsh-compat/tools-facade.d.ts +47 -0
  146. package/lib/core/dsh-compat/tools-facade.js +108 -0
  147. package/lib/core/err-text.d.ts +13 -0
  148. package/lib/core/err-text.js +15 -0
  149. package/lib/core/events.d.ts +149 -0
  150. package/lib/core/events.js +1 -0
  151. package/lib/core/git-exec.d.ts +23 -0
  152. package/lib/core/git-exec.js +72 -0
  153. package/lib/core/git-info.d.ts +47 -0
  154. package/lib/core/git-info.js +157 -0
  155. package/lib/core/goal.d.ts +89 -0
  156. package/lib/core/goal.js +189 -0
  157. package/lib/core/hooks.d.ts +272 -0
  158. package/lib/core/hooks.js +818 -0
  159. package/lib/core/host-browser-link.d.ts +59 -0
  160. package/lib/core/host-browser-link.js +9 -0
  161. package/lib/core/host-methods.d.ts +25 -0
  162. package/lib/core/host-methods.js +103 -0
  163. package/lib/core/image-diet.d.ts +77 -0
  164. package/lib/core/image-diet.js +127 -0
  165. package/lib/core/learnings/ledger.d.ts +73 -0
  166. package/lib/core/learnings/ledger.js +273 -0
  167. package/lib/core/learnings/skill-write.d.ts +250 -0
  168. package/lib/core/learnings/skill-write.js +854 -0
  169. package/lib/core/learnings/store.d.ts +102 -0
  170. package/lib/core/learnings/store.js +266 -0
  171. package/lib/core/lifecycle-hooks.d.ts +189 -0
  172. package/lib/core/lifecycle-hooks.js +576 -0
  173. package/lib/core/llm.d.ts +283 -0
  174. package/lib/core/llm.js +565 -0
  175. package/lib/core/lockfile.d.ts +17 -0
  176. package/lib/core/lockfile.js +110 -0
  177. package/lib/core/loop.d.ts +185 -0
  178. package/lib/core/loop.js +587 -0
  179. package/lib/core/lsp/client.d.ts +189 -0
  180. package/lib/core/lsp/client.js +690 -0
  181. package/lib/core/lsp/framing.d.ts +84 -0
  182. package/lib/core/lsp/framing.js +181 -0
  183. package/lib/core/lsp/line-shift.d.ts +28 -0
  184. package/lib/core/lsp/line-shift.js +127 -0
  185. package/lib/core/lsp/manager.d.ts +93 -0
  186. package/lib/core/lsp/manager.js +418 -0
  187. package/lib/core/lsp/normalize.d.ts +32 -0
  188. package/lib/core/lsp/normalize.js +139 -0
  189. package/lib/core/lsp/servers.d.ts +106 -0
  190. package/lib/core/lsp/servers.js +352 -0
  191. package/lib/core/lsp/uri.d.ts +76 -0
  192. package/lib/core/lsp/uri.js +179 -0
  193. package/lib/core/market.d.ts +51 -0
  194. package/lib/core/market.js +358 -0
  195. package/lib/core/mcp.d.ts +201 -0
  196. package/lib/core/mcp.js +836 -0
  197. package/lib/core/memory-eval.d.ts +158 -0
  198. package/lib/core/memory-eval.js +215 -0
  199. package/lib/core/memory.d.ts +266 -0
  200. package/lib/core/memory.js +703 -0
  201. package/lib/core/mention.d.ts +57 -0
  202. package/lib/core/mention.js +129 -0
  203. package/lib/core/microcompact.d.ts +48 -0
  204. package/lib/core/microcompact.js +79 -0
  205. package/lib/core/migrate.d.ts +56 -0
  206. package/lib/core/migrate.js +134 -0
  207. package/lib/core/model-caps.d.ts +83 -0
  208. package/lib/core/model-caps.js +150 -0
  209. package/lib/core/model-discovery.d.ts +19 -0
  210. package/lib/core/model-discovery.js +69 -0
  211. package/lib/core/modes.d.ts +72 -0
  212. package/lib/core/modes.js +152 -0
  213. package/lib/core/native-bridge.d.ts +135 -0
  214. package/lib/core/native-bridge.js +563 -0
  215. package/lib/core/path-policy.d.ts +32 -0
  216. package/lib/core/path-policy.js +248 -0
  217. package/lib/core/permission-presets.d.ts +67 -0
  218. package/lib/core/permission-presets.js +75 -0
  219. package/lib/core/plugin-loader.d.ts +36 -0
  220. package/lib/core/plugin-loader.js +294 -0
  221. package/lib/core/plugin-registry.d.ts +113 -0
  222. package/lib/core/plugin-registry.js +256 -0
  223. package/lib/core/prefs.d.ts +82 -0
  224. package/lib/core/prefs.js +372 -0
  225. package/lib/core/presets.d.ts +80 -0
  226. package/lib/core/presets.js +373 -0
  227. package/lib/core/pricing.d.ts +90 -0
  228. package/lib/core/pricing.js +126 -0
  229. package/lib/core/prompt.d.ts +92 -0
  230. package/lib/core/prompt.js +339 -0
  231. package/lib/core/ptc.d.ts +66 -0
  232. package/lib/core/ptc.js +70 -0
  233. package/lib/core/remote/frames.d.ts +91 -0
  234. package/lib/core/remote/frames.js +174 -0
  235. package/lib/core/remote/notify.d.ts +54 -0
  236. package/lib/core/remote/notify.js +77 -0
  237. package/lib/core/remote/owner.d.ts +32 -0
  238. package/lib/core/remote/owner.js +75 -0
  239. package/lib/core/remote/pairing.d.ts +104 -0
  240. package/lib/core/remote/pairing.js +261 -0
  241. package/lib/core/remote/push.d.ts +80 -0
  242. package/lib/core/remote/push.js +222 -0
  243. package/lib/core/remote/store.d.ts +18 -0
  244. package/lib/core/remote/store.js +59 -0
  245. package/lib/core/remote/tickets.d.ts +20 -0
  246. package/lib/core/remote/tickets.js +49 -0
  247. package/lib/core/remote/uploads.d.ts +63 -0
  248. package/lib/core/remote/uploads.js +161 -0
  249. package/lib/core/request-attribution.d.ts +26 -0
  250. package/lib/core/request-attribution.js +86 -0
  251. package/lib/core/request-invariant.d.ts +61 -0
  252. package/lib/core/request-invariant.js +199 -0
  253. package/lib/core/sandbox/backends.d.ts +64 -0
  254. package/lib/core/sandbox/backends.js +194 -0
  255. package/lib/core/sandbox/execpolicy.d.ts +93 -0
  256. package/lib/core/sandbox/execpolicy.js +452 -0
  257. package/lib/core/sandbox/net-proxy.d.ts +31 -0
  258. package/lib/core/sandbox/net-proxy.js +162 -0
  259. package/lib/core/sandbox/policy.d.ts +211 -0
  260. package/lib/core/sandbox/policy.js +559 -0
  261. package/lib/core/sandbox/win/abi.d.ts +161 -0
  262. package/lib/core/sandbox/win/abi.js +169 -0
  263. package/lib/core/sandbox/win/account.d.ts +71 -0
  264. package/lib/core/sandbox/win/account.js +206 -0
  265. package/lib/core/sandbox/win/acl.d.ts +54 -0
  266. package/lib/core/sandbox/win/acl.js +339 -0
  267. package/lib/core/sandbox/win/backend.d.ts +61 -0
  268. package/lib/core/sandbox/win/backend.js +249 -0
  269. package/lib/core/sandbox/win/doctor.d.ts +24 -0
  270. package/lib/core/sandbox/win/doctor.js +272 -0
  271. package/lib/core/sandbox/win/ffi.d.ts +107 -0
  272. package/lib/core/sandbox/win/ffi.js +166 -0
  273. package/lib/core/sandbox/win/net-abi.d.ts +154 -0
  274. package/lib/core/sandbox/win/net-abi.js +316 -0
  275. package/lib/core/sandbox/win/runner-entry.d.ts +35 -0
  276. package/lib/core/sandbox/win/runner-entry.js +391 -0
  277. package/lib/core/sandbox/win/setup.d.ts +60 -0
  278. package/lib/core/sandbox/win/setup.js +986 -0
  279. package/lib/core/sandbox/win/token.d.ts +35 -0
  280. package/lib/core/sandbox/win/token.js +238 -0
  281. package/lib/core/sandbox/win/wfp.d.ts +41 -0
  282. package/lib/core/sandbox/win/wfp.js +200 -0
  283. package/lib/core/sandbox/win/workspace-sid.d.ts +9 -0
  284. package/lib/core/sandbox/win/workspace-sid.js +45 -0
  285. package/lib/core/schedule/rule.d.ts +184 -0
  286. package/lib/core/schedule/rule.js +745 -0
  287. package/lib/core/schedule/runner.d.ts +185 -0
  288. package/lib/core/schedule/runner.js +678 -0
  289. package/lib/core/schedule/store.d.ts +182 -0
  290. package/lib/core/schedule/store.js +455 -0
  291. package/lib/core/secrets.d.ts +41 -0
  292. package/lib/core/secrets.js +150 -0
  293. package/lib/core/session-export.d.ts +18 -0
  294. package/lib/core/session-export.js +73 -0
  295. package/lib/core/session-index.d.ts +159 -0
  296. package/lib/core/session-index.js +683 -0
  297. package/lib/core/session-meta.d.ts +41 -0
  298. package/lib/core/session-meta.js +97 -0
  299. package/lib/core/session.d.ts +356 -0
  300. package/lib/core/session.js +998 -0
  301. package/lib/core/skills.d.ts +60 -0
  302. package/lib/core/skills.js +171 -0
  303. package/lib/core/spill.d.ts +159 -0
  304. package/lib/core/spill.js +329 -0
  305. package/lib/core/surface-registry.d.ts +45 -0
  306. package/lib/core/surface-registry.js +67 -0
  307. package/lib/core/team-board.d.ts +95 -0
  308. package/lib/core/team-board.js +316 -0
  309. package/lib/core/throughput.d.ts +46 -0
  310. package/lib/core/throughput.js +40 -0
  311. package/lib/core/todo-reminder.d.ts +44 -0
  312. package/lib/core/todo-reminder.js +55 -0
  313. package/lib/core/todo.d.ts +81 -0
  314. package/lib/core/todo.js +222 -0
  315. package/lib/core/token-estimate.d.ts +55 -0
  316. package/lib/core/token-estimate.js +82 -0
  317. package/lib/core/tool-guards.d.ts +103 -0
  318. package/lib/core/tool-guards.js +77 -0
  319. package/lib/core/tool-search.d.ts +152 -0
  320. package/lib/core/tool-search.js +311 -0
  321. package/lib/core/tools/bash.d.ts +281 -0
  322. package/lib/core/tools/bash.js +871 -0
  323. package/lib/core/tools/command-runner.d.ts +84 -0
  324. package/lib/core/tools/command-runner.js +68 -0
  325. package/lib/core/tools/fs-tools.d.ts +23 -0
  326. package/lib/core/tools/fs-tools.js +247 -0
  327. package/lib/core/tools/index.d.ts +8 -0
  328. package/lib/core/tools/index.js +4 -0
  329. package/lib/core/tools/sandbox-args.d.ts +51 -0
  330. package/lib/core/tools/sandbox-args.js +90 -0
  331. package/lib/core/tools/search-tools.d.ts +3 -0
  332. package/lib/core/tools/search-tools.js +153 -0
  333. package/lib/core/tools.d.ts +96 -0
  334. package/lib/core/tools.js +53 -0
  335. package/lib/core/ui-boot-source.d.ts +71 -0
  336. package/lib/core/ui-boot-source.js +121 -0
  337. package/lib/core/ui-bundles.d.ts +249 -0
  338. package/lib/core/ui-bundles.js +830 -0
  339. package/lib/core/ui-combo.d.ts +49 -0
  340. package/lib/core/ui-combo.js +55 -0
  341. package/lib/core/ui-events.d.ts +81 -0
  342. package/lib/core/ui-events.js +364 -0
  343. package/lib/core/ui-hmr.d.ts +36 -0
  344. package/lib/core/ui-hmr.js +128 -0
  345. package/lib/core/ui-methods.d.ts +69 -0
  346. package/lib/core/ui-methods.js +341 -0
  347. package/lib/core/ui-route.d.ts +69 -0
  348. package/lib/core/ui-route.js +122 -0
  349. package/lib/core/ui-server.d.ts +75 -0
  350. package/lib/core/ui-server.js +369 -0
  351. package/lib/core/ui-trust.d.ts +47 -0
  352. package/lib/core/ui-trust.js +164 -0
  353. package/lib/core/untrusted.d.ts +30 -0
  354. package/lib/core/untrusted.js +48 -0
  355. package/lib/core/update-check.d.ts +81 -0
  356. package/lib/core/update-check.js +177 -0
  357. package/lib/core/usage-log.d.ts +82 -0
  358. package/lib/core/usage-log.js +306 -0
  359. package/lib/core/version.d.ts +1 -0
  360. package/lib/core/version.js +37 -0
  361. package/lib/core/web-http.d.ts +57 -0
  362. package/lib/core/web-http.js +137 -0
  363. package/lib/core/web-static.d.ts +31 -0
  364. package/lib/core/web-static.js +75 -0
  365. package/lib/headless.d.ts +1 -0
  366. package/lib/headless.js +31 -0
  367. package/lib/host/kernel.d.ts +33 -0
  368. package/lib/host/kernel.js +451 -0
  369. package/lib/index.d.ts +41 -0
  370. package/lib/index.js +35 -0
  371. package/lib/plugins/agent.d.ts +2 -0
  372. package/lib/plugins/agent.js +274 -0
  373. package/lib/plugins/approval-floor.d.ts +2 -0
  374. package/lib/plugins/approval-floor.js +223 -0
  375. package/lib/plugins/approval.d.ts +16 -0
  376. package/lib/plugins/approval.js +674 -0
  377. package/lib/plugins/ask.d.ts +2 -0
  378. package/lib/plugins/ask.js +245 -0
  379. package/lib/plugins/browser.d.ts +68 -0
  380. package/lib/plugins/browser.js +1341 -0
  381. package/lib/plugins/commands.d.ts +23 -0
  382. package/lib/plugins/commands.js +498 -0
  383. package/lib/plugins/compact.d.ts +21 -0
  384. package/lib/plugins/compact.js +274 -0
  385. package/lib/plugins/computer-use.d.ts +47 -0
  386. package/lib/plugins/computer-use.js +539 -0
  387. package/lib/plugins/desktop-dock.d.ts +2 -0
  388. package/lib/plugins/desktop-dock.js +626 -0
  389. package/lib/plugins/dock-browser.d.ts +34 -0
  390. package/lib/plugins/dock-browser.js +765 -0
  391. package/lib/plugins/dsh-compat.d.ts +25 -0
  392. package/lib/plugins/dsh-compat.js +37 -0
  393. package/lib/plugins/file-review.d.ts +108 -0
  394. package/lib/plugins/file-review.js +393 -0
  395. package/lib/plugins/git.d.ts +26 -0
  396. package/lib/plugins/git.js +132 -0
  397. package/lib/plugins/goal.d.ts +20 -0
  398. package/lib/plugins/goal.js +245 -0
  399. package/lib/plugins/guards.d.ts +14 -0
  400. package/lib/plugins/guards.js +18 -0
  401. package/lib/plugins/hooks.d.ts +19 -0
  402. package/lib/plugins/hooks.js +583 -0
  403. package/lib/plugins/host-stdio.d.ts +88 -0
  404. package/lib/plugins/host-stdio.js +317 -0
  405. package/lib/plugins/image-diet.d.ts +17 -0
  406. package/lib/plugins/image-diet.js +85 -0
  407. package/lib/plugins/lifecycle-hooks.d.ts +26 -0
  408. package/lib/plugins/lifecycle-hooks.js +338 -0
  409. package/lib/plugins/llm.d.ts +13 -0
  410. package/lib/plugins/llm.js +215 -0
  411. package/lib/plugins/lsp.d.ts +54 -0
  412. package/lib/plugins/lsp.js +608 -0
  413. package/lib/plugins/mcp.d.ts +16 -0
  414. package/lib/plugins/mcp.js +673 -0
  415. package/lib/plugins/memory.d.ts +17 -0
  416. package/lib/plugins/memory.js +858 -0
  417. package/lib/plugins/microcompact.d.ts +18 -0
  418. package/lib/plugins/microcompact.js +119 -0
  419. package/lib/plugins/mode.d.ts +18 -0
  420. package/lib/plugins/mode.js +115 -0
  421. package/lib/plugins/permission-presets.d.ts +18 -0
  422. package/lib/plugins/permission-presets.js +135 -0
  423. package/lib/plugins/plan.d.ts +2 -0
  424. package/lib/plugins/plan.js +192 -0
  425. package/lib/plugins/plugin-manager.d.ts +2 -0
  426. package/lib/plugins/plugin-manager.js +165 -0
  427. package/lib/plugins/presets.d.ts +2 -0
  428. package/lib/plugins/presets.js +182 -0
  429. package/lib/plugins/prompt.d.ts +2 -0
  430. package/lib/plugins/prompt.js +264 -0
  431. package/lib/plugins/ptc.d.ts +2 -0
  432. package/lib/plugins/ptc.js +272 -0
  433. package/lib/plugins/remote/http.d.ts +11 -0
  434. package/lib/plugins/remote/http.js +11 -0
  435. package/lib/plugins/remote/routes.d.ts +24 -0
  436. package/lib/plugins/remote/routes.js +384 -0
  437. package/lib/plugins/remote/types.d.ts +135 -0
  438. package/lib/plugins/remote/types.js +87 -0
  439. package/lib/plugins/remote.d.ts +17 -0
  440. package/lib/plugins/remote.js +1028 -0
  441. package/lib/plugins/runtime-api.d.ts +16 -0
  442. package/lib/plugins/runtime-api.js +99 -0
  443. package/lib/plugins/runtime.d.ts +10 -0
  444. package/lib/plugins/runtime.js +451 -0
  445. package/lib/plugins/sandbox.d.ts +2 -0
  446. package/lib/plugins/sandbox.js +761 -0
  447. package/lib/plugins/schedule.d.ts +26 -0
  448. package/lib/plugins/schedule.js +538 -0
  449. package/lib/plugins/self-improve.d.ts +61 -0
  450. package/lib/plugins/self-improve.js +953 -0
  451. package/lib/plugins/session-search.d.ts +16 -0
  452. package/lib/plugins/session-search.js +308 -0
  453. package/lib/plugins/session-title.d.ts +19 -0
  454. package/lib/plugins/session-title.js +109 -0
  455. package/lib/plugins/session.d.ts +7 -0
  456. package/lib/plugins/session.js +296 -0
  457. package/lib/plugins/settings.d.ts +3 -0
  458. package/lib/plugins/settings.js +705 -0
  459. package/lib/plugins/skills.d.ts +2 -0
  460. package/lib/plugins/skills.js +360 -0
  461. package/lib/plugins/spill.d.ts +16 -0
  462. package/lib/plugins/spill.js +200 -0
  463. package/lib/plugins/subagent.d.ts +2 -0
  464. package/lib/plugins/subagent.js +896 -0
  465. package/lib/plugins/surfaces.d.ts +11 -0
  466. package/lib/plugins/surfaces.js +20 -0
  467. package/lib/plugins/team.d.ts +16 -0
  468. package/lib/plugins/team.js +149 -0
  469. package/lib/plugins/todo.d.ts +19 -0
  470. package/lib/plugins/todo.js +188 -0
  471. package/lib/plugins/tool-search.d.ts +2 -0
  472. package/lib/plugins/tool-search.js +434 -0
  473. package/lib/plugins/tool-search.js.nv-backup +434 -0
  474. package/lib/plugins/tools-default.d.ts +12 -0
  475. package/lib/plugins/tools-default.js +275 -0
  476. package/lib/plugins/tools.d.ts +16 -0
  477. package/lib/plugins/tools.js +62 -0
  478. package/lib/plugins/transcript.d.ts +15 -0
  479. package/lib/plugins/transcript.js +311 -0
  480. package/lib/plugins/tui.d.ts +2 -0
  481. package/lib/plugins/tui.js +98 -0
  482. package/lib/plugins/waiting.d.ts +12 -0
  483. package/lib/plugins/waiting.js +34 -0
  484. package/lib/plugins/web-search.d.ts +14 -0
  485. package/lib/plugins/web-search.js +263 -0
  486. package/lib/plugins/webserver.d.ts +48 -0
  487. package/lib/plugins/webserver.js +228 -0
  488. package/lib/remote/assets/app-DAcUCOEn.js +14 -0
  489. package/lib/remote/assets/icon-192.png +0 -0
  490. package/lib/remote/assets/icon-512.png +0 -0
  491. package/lib/remote/assets/index.html +34 -0
  492. package/lib/remote/assets/manifest.json +27 -0
  493. package/lib/remote/assets/style-DIB6729x.css +1 -0
  494. package/lib/remote/assets/sw.js +66 -0
  495. package/lib/services/types.d.ts +1228 -0
  496. package/lib/services/types.js +1 -0
  497. package/lib/tools/config-cli.d.ts +1 -0
  498. package/lib/tools/config-cli.js +89 -0
  499. package/lib/ui/arrival.d.ts +72 -0
  500. package/lib/ui/arrival.js +105 -0
  501. package/lib/ui/assets/app-B70nVIKd.js +69 -0
  502. package/lib/ui/assets/chunk-2UxHyX5q.js +1 -0
  503. package/lib/ui/assets/chunk-B1dDrJ26.js +1 -0
  504. package/lib/ui/assets/chunk-B6aJPvgy.js +1 -0
  505. package/lib/ui/assets/chunk-BEwlwnbL.js +1 -0
  506. package/lib/ui/assets/chunk-BGcgwlCI.js +12 -0
  507. package/lib/ui/assets/chunk-BIGW1oBm.js +1 -0
  508. package/lib/ui/assets/chunk-BPQ3VLAy.js +1 -0
  509. package/lib/ui/assets/chunk-BRH0KZbk.js +141 -0
  510. package/lib/ui/assets/chunk-BX6H_ySx.js +1 -0
  511. package/lib/ui/assets/chunk-B_P3UbPa.js +1 -0
  512. package/lib/ui/assets/chunk-B_TYUkTI.js +1 -0
  513. package/lib/ui/assets/chunk-B_vNuMnf.js +1 -0
  514. package/lib/ui/assets/chunk-BajyYBss.js +10 -0
  515. package/lib/ui/assets/chunk-BdnUsdx6.js +1 -0
  516. package/lib/ui/assets/chunk-Buea-lGh.js +1 -0
  517. package/lib/ui/assets/chunk-C0PvZCCE.js +1 -0
  518. package/lib/ui/assets/chunk-C0m74zRD.js +1 -0
  519. package/lib/ui/assets/chunk-C27-OAKa.js +1 -0
  520. package/lib/ui/assets/chunk-C2oV4EkX.js +1 -0
  521. package/lib/ui/assets/chunk-C7zT0LnQ.js +1 -0
  522. package/lib/ui/assets/chunk-C9GSunVT.js +1 -0
  523. package/lib/ui/assets/chunk-C9tS-k6U.js +1 -0
  524. package/lib/ui/assets/chunk-CHLpvVh8.js +1 -0
  525. package/lib/ui/assets/chunk-CLxacb5B.js +1 -0
  526. package/lib/ui/assets/chunk-COt5Ahok.js +1 -0
  527. package/lib/ui/assets/chunk-CPTIWCL2.js +1 -0
  528. package/lib/ui/assets/chunk-CQLl-L-p.js +1 -0
  529. package/lib/ui/assets/chunk-CUWRgxuq.js +55 -0
  530. package/lib/ui/assets/chunk-CWanVSXC.js +1 -0
  531. package/lib/ui/assets/chunk-Cf5RLm7j.js +1 -0
  532. package/lib/ui/assets/chunk-CickPsom.js +1 -0
  533. package/lib/ui/assets/chunk-Cj5Yp3dK.js +1 -0
  534. package/lib/ui/assets/chunk-Cmh6b_Ma.js +1 -0
  535. package/lib/ui/assets/chunk-Cp-IABpG.js +1 -0
  536. package/lib/ui/assets/chunk-CqE71os6.js +1 -0
  537. package/lib/ui/assets/chunk-CtKP3W-j.js +1 -0
  538. package/lib/ui/assets/chunk-Cvjx9yec.js +1 -0
  539. package/lib/ui/assets/chunk-CxGP3dtY.js +1 -0
  540. package/lib/ui/assets/chunk-CylS5w8V.js +1 -0
  541. package/lib/ui/assets/chunk-D38fbIBN.js +1 -0
  542. package/lib/ui/assets/chunk-D97Zzqfu.js +1 -0
  543. package/lib/ui/assets/chunk-DAi9KRSo.js +1 -0
  544. package/lib/ui/assets/chunk-DHK4yRfg.js +1 -0
  545. package/lib/ui/assets/chunk-DJeabLx-.js +1 -0
  546. package/lib/ui/assets/chunk-DNRxmY5a.js +1 -0
  547. package/lib/ui/assets/chunk-DNSN1z5r.js +1 -0
  548. package/lib/ui/assets/chunk-DNasK_ZG.js +1 -0
  549. package/lib/ui/assets/chunk-DPvrY3IQ.js +1 -0
  550. package/lib/ui/assets/chunk-DXmwc3jG.js +1 -0
  551. package/lib/ui/assets/chunk-Dd0kTxKP.js +1 -0
  552. package/lib/ui/assets/chunk-De0Btta0.js +1 -0
  553. package/lib/ui/assets/chunk-Des-eS-w.js +1 -0
  554. package/lib/ui/assets/chunk-Df6bDoY_.js +1 -0
  555. package/lib/ui/assets/chunk-DijEV5ha.js +1 -0
  556. package/lib/ui/assets/chunk-DkvoVjww.js +1 -0
  557. package/lib/ui/assets/chunk-DlC-OlHO.js +1 -0
  558. package/lib/ui/assets/chunk-DnzrXTVv.js +1 -0
  559. package/lib/ui/assets/chunk-Dualf0xi.js +1 -0
  560. package/lib/ui/assets/chunk-EXT84bkm.js +1 -0
  561. package/lib/ui/assets/chunk-GwR3hkPK.js +1 -0
  562. package/lib/ui/assets/chunk-P80f7IUj.js +1 -0
  563. package/lib/ui/assets/chunk-VOosw3JB.js +1 -0
  564. package/lib/ui/assets/chunk-YQ4lDkt_.js +140 -0
  565. package/lib/ui/assets/chunk-Yzrsuije.js +1 -0
  566. package/lib/ui/assets/chunk-Z72CF80r.js +1 -0
  567. package/lib/ui/assets/chunk-g9-lgVsj.js +1 -0
  568. package/lib/ui/assets/chunk-vGWfd6FD.js +1 -0
  569. package/lib/ui/assets/chunk-wDzz0qaB.js +1 -0
  570. package/lib/ui/assets/chunk-ySF7HWmS.js +1 -0
  571. package/lib/ui/assets/icon.png +0 -0
  572. package/lib/ui/assets/index.html +14 -0
  573. package/lib/ui/assets/pdf.worker.min-CjEcRF4W.mjs +28 -0
  574. package/lib/ui/assets/style-Bq01xH_b.css +1 -0
  575. package/lib/ui/frames.d.ts +67 -0
  576. package/lib/ui/frames.js +146 -0
  577. package/lib/ui/index.d.ts +59 -0
  578. package/lib/ui/index.js +50 -0
  579. package/lib/ui/manifest.d.ts +172 -0
  580. package/lib/ui/manifest.js +158 -0
  581. package/lib/ui/plugin.d.ts +161 -0
  582. package/lib/ui/plugin.js +7 -0
  583. package/lib/ui/plugins/browser/client.js +290 -0
  584. package/lib/ui/plugins/browser/icon.png +0 -0
  585. package/lib/ui/plugins/composer/client.js +1843 -0
  586. package/lib/ui/plugins/composer/icon.png +0 -0
  587. package/lib/ui/plugins/files/client.js +646 -0
  588. package/lib/ui/plugins/files/icon.png +0 -0
  589. package/lib/ui/plugins/manifest.json +107 -0
  590. package/lib/ui/plugins/plugins/client.js +682 -0
  591. package/lib/ui/plugins/plugins/icon.png +0 -0
  592. package/lib/ui/plugins/preview/client.js +197 -0
  593. package/lib/ui/plugins/preview/icon.png +0 -0
  594. package/lib/ui/plugins/prompt/client.js +653 -0
  595. package/lib/ui/plugins/prompt/icon.png +0 -0
  596. package/lib/ui/plugins/sessions/client.js +1577 -0
  597. package/lib/ui/plugins/sessions/icon.png +0 -0
  598. package/lib/ui/plugins/settings/client.js +5470 -0
  599. package/lib/ui/plugins/settings/icon.png +0 -0
  600. package/lib/ui/plugins/skills/client.js +485 -0
  601. package/lib/ui/plugins/skills/icon.png +0 -0
  602. package/lib/ui/plugins/status/client.js +1420 -0
  603. package/lib/ui/plugins/status/icon.png +0 -0
  604. package/lib/ui/plugins/statusbar/client.js +504 -0
  605. package/lib/ui/plugins/statusbar/icon.png +0 -0
  606. package/lib/ui/plugins/tasks/client.js +52 -0
  607. package/lib/ui/plugins/tasks/icon.png +0 -0
  608. package/lib/ui/plugins/team/client.js +527 -0
  609. package/lib/ui/plugins/team/icon.png +0 -0
  610. package/lib/ui/plugins/terminal/client.js +232 -0
  611. package/lib/ui/plugins/terminal/icon.png +0 -0
  612. package/lib/ui/plugins/trace/client.js +1376 -0
  613. package/lib/ui/plugins/trace/icon.png +0 -0
  614. package/lib/ui/plugins/transcript/client.js +2661 -0
  615. package/lib/ui/plugins/transcript/icon.png +0 -0
  616. package/lib/ui/scoped-slots.d.ts +20 -0
  617. package/lib/ui/scoped-slots.js +21 -0
  618. package/lib/ui/sdk/@dsc/ui/index.d.ts +242 -0
  619. package/lib/ui/sdk/@dsc/ui/package.json +16 -0
  620. package/lib/ui/sdk/@dsc/ui-core/contract.d.ts +1973 -0
  621. package/lib/ui/sdk/@dsc/ui-core/core/diff-text.d.ts +74 -0
  622. package/lib/ui/sdk/@dsc/ui-core/core/dock-browser.d.ts +137 -0
  623. package/lib/ui/sdk/@dsc/ui-core/core/dock-ops.d.ts +59 -0
  624. package/lib/ui/sdk/@dsc/ui-core/core/model-caps.d.ts +83 -0
  625. package/lib/ui/sdk/@dsc/ui-core/core/native-bridge.d.ts +135 -0
  626. package/lib/ui/sdk/@dsc/ui-core/core/token-estimate.d.ts +55 -0
  627. package/lib/ui/sdk/@dsc/ui-core/package.json +16 -0
  628. package/lib/ui/sdk/@dsc/ui-core/ui/arrival.d.ts +72 -0
  629. package/lib/ui/sdk/@dsc/ui-core/ui/frames.d.ts +67 -0
  630. package/lib/ui/sdk/@dsc/ui-core/ui/index.d.ts +59 -0
  631. package/lib/ui/sdk/@dsc/ui-core/ui/manifest.d.ts +172 -0
  632. package/lib/ui/sdk/@dsc/ui-core/ui/plugin.d.ts +161 -0
  633. package/lib/ui/sdk/@dsc/ui-core/ui/scoped-slots.d.ts +20 -0
  634. package/lib/ui/sdk/@dsc/ui-core/ui/services-react.d.ts +27 -0
  635. package/lib/ui/sdk/@dsc/ui-core/ui/services.d.ts +63 -0
  636. package/lib/ui/sdk/@dsc/ui-core/ui/slots-react.d.ts +28 -0
  637. package/lib/ui/sdk/@dsc/ui-core/ui/slots.d.ts +481 -0
  638. package/lib/ui/sdk/@dsc/ui-core/ui/store.d.ts +89 -0
  639. package/lib/ui/sdk/@dsc/ui-dockkit/dock-model.d.ts +238 -0
  640. package/lib/ui/sdk/@dsc/ui-dockkit/dock-state.d.ts +163 -0
  641. package/lib/ui/sdk/@dsc/ui-dockkit/dock.d.ts +24 -0
  642. package/lib/ui/sdk/@dsc/ui-dockkit/index.d.ts +15 -0
  643. package/lib/ui/sdk/@dsc/ui-dockkit/package.json +16 -0
  644. package/lib/ui/sdk/@dsc/ui-layout/app.d.ts +74 -0
  645. package/lib/ui/sdk/@dsc/ui-layout/appearance.d.ts +70 -0
  646. package/lib/ui/sdk/@dsc/ui-layout/host-channel.d.ts +112 -0
  647. package/lib/ui/sdk/@dsc/ui-layout/index.d.ts +34 -0
  648. package/lib/ui/sdk/@dsc/ui-layout/package.json +16 -0
  649. package/lib/ui/sdk/@dsc/ui-layout/page-state.d.ts +14 -0
  650. package/lib/ui/sdk/@dsc/ui-layout/review-pane.d.ts +21 -0
  651. package/lib/ui/sdk/@dsc/ui-layout/runtime-context.d.ts +44 -0
  652. package/lib/ui/sdk/@dsc/ui-layout/thread-view.d.ts +28 -0
  653. package/lib/ui/sdk/@dsc/ui-layout/update-button.d.ts +21 -0
  654. package/lib/ui/sdk/@dsc/ui-primitives/code-file-icon-artwork.d.ts +53 -0
  655. package/lib/ui/sdk/@dsc/ui-primitives/code-view.d.ts +15 -0
  656. package/lib/ui/sdk/@dsc/ui-primitives/compat.d.ts +27 -0
  657. package/lib/ui/sdk/@dsc/ui-primitives/completion-sound.d.ts +24 -0
  658. package/lib/ui/sdk/@dsc/ui-primitives/confirm.d.ts +33 -0
  659. package/lib/ui/sdk/@dsc/ui-primitives/css.d.ts +47 -0
  660. package/lib/ui/sdk/@dsc/ui-primitives/diff-rows.d.ts +20 -0
  661. package/lib/ui/sdk/@dsc/ui-primitives/file-icons.d.ts +38 -0
  662. package/lib/ui/sdk/@dsc/ui-primitives/file-type-classify.d.ts +66 -0
  663. package/lib/ui/sdk/@dsc/ui-primitives/file-type-icon.d.ts +57 -0
  664. package/lib/ui/sdk/@dsc/ui-primitives/highlight.d.ts +24 -0
  665. package/lib/ui/sdk/@dsc/ui-primitives/hover-delay.d.ts +17 -0
  666. package/lib/ui/sdk/@dsc/ui-primitives/icons.d.ts +109 -0
  667. package/lib/ui/sdk/@dsc/ui-primitives/index.d.ts +55 -0
  668. package/lib/ui/sdk/@dsc/ui-primitives/lang-table.d.ts +10 -0
  669. package/lib/ui/sdk/@dsc/ui-primitives/markdown.d.ts +20 -0
  670. package/lib/ui/sdk/@dsc/ui-primitives/native.d.ts +41 -0
  671. package/lib/ui/sdk/@dsc/ui-primitives/package.json +16 -0
  672. package/lib/ui/sdk/@dsc/ui-primitives/panels.d.ts +86 -0
  673. package/lib/ui/sdk/@dsc/ui-primitives/paths.d.ts +11 -0
  674. package/lib/ui/sdk/@dsc/ui-primitives/pdf-view.d.ts +13 -0
  675. package/lib/ui/sdk/@dsc/ui-primitives/plugin-text.d.ts +15 -0
  676. package/lib/ui/sdk/@dsc/ui-primitives/select.d.ts +35 -0
  677. package/lib/ui/sdk/@dsc/ui-primitives/table-view.d.ts +23 -0
  678. package/lib/ui/sdk/@dsc/ui-primitives/thread-resizer.d.ts +22 -0
  679. package/lib/ui/sdk/@dsc/ui-primitives/time.d.ts +33 -0
  680. package/lib/ui/sdk/@dsc/ui-primitives/toast.d.ts +16 -0
  681. package/lib/ui/sdk/@dsc/ui-primitives/tokens.d.ts +14 -0
  682. package/lib/ui/sdk/@dsc/ui-primitives/tool-args.d.ts +49 -0
  683. package/lib/ui/sdk/@dsc/ui-primitives/tool-summary.d.ts +64 -0
  684. package/lib/ui/sdk/@dsc/ui-renderer/boot.d.ts +121 -0
  685. package/lib/ui/sdk/@dsc/ui-renderer/hmr.d.ts +43 -0
  686. package/lib/ui/sdk/@dsc/ui-renderer/index.d.ts +20 -0
  687. package/lib/ui/sdk/@dsc/ui-renderer/package.json +16 -0
  688. package/lib/ui/sdk/@dsc/ui-slots/index.d.ts +19 -0
  689. package/lib/ui/sdk/@dsc/ui-slots/package.json +16 -0
  690. package/lib/ui/sdk/@dsc/ui-slots/slots-react.d.ts +48 -0
  691. package/lib/ui/sdk/@dsc/ui-slots/slots.d.ts +102 -0
  692. package/lib/ui/services-react.d.ts +27 -0
  693. package/lib/ui/services-react.js +32 -0
  694. package/lib/ui/services.d.ts +63 -0
  695. package/lib/ui/services.js +121 -0
  696. package/lib/ui/slots-ink.d.ts +26 -0
  697. package/lib/ui/slots-ink.js +78 -0
  698. package/lib/ui/slots-react.d.ts +28 -0
  699. package/lib/ui/slots-react.js +88 -0
  700. package/lib/ui/slots.d.ts +481 -0
  701. package/lib/ui/slots.js +550 -0
  702. package/lib/ui/store.d.ts +89 -0
  703. package/lib/ui/store.js +62 -0
  704. package/lib/ui/tui-plugin-api.d.ts +23 -0
  705. package/lib/ui/tui-plugin-api.js +23 -0
  706. package/lib/ui/tui-plugins.d.ts +47 -0
  707. package/lib/ui/tui-plugins.js +220 -0
  708. package/package.json +58 -6
@@ -0,0 +1,347 @@
1
+ import { displayWidth } from './click.js';
2
+ /** 窗口上下各多渲染几行:滚动时不留白,也不至于把整篇都拉进来。 */
3
+ export const OVERSCAN_LINES = 8;
4
+ /** 行高表:条目 id → 显示行数。宽度变了(刻度栏出现/消失)就整体作废。 */
5
+ export class HeightCache {
6
+ table = new Map();
7
+ width = null;
8
+ /** 换宽度(含首次)就清表:折行变了,旧行数全是错的。 */
9
+ useWidth(width) {
10
+ if (this.width === width)
11
+ return;
12
+ this.width = width;
13
+ this.table.clear();
14
+ }
15
+ get(id) {
16
+ return this.table.get(id);
17
+ }
18
+ set(id, lines) {
19
+ if (lines > 0)
20
+ this.table.set(id, lines);
21
+ }
22
+ get size() {
23
+ return this.table.size;
24
+ }
25
+ }
26
+ /**
27
+ * 没量过的条目按**折叠态实际画出来的行数**估:一件卡片的估算误差不是小数字——它直接
28
+ * 变成「跳过的那段内容有多高」,跳过段的高度又决定视口顶落在内容坐标的哪一行。
29
+ *
30
+ * 曾经的口径(按最长字段数折行、卡片再补框架行)在工具卡上错得离谱:结果原文十四行,
31
+ * 卡片折叠态其实只画**一行**(「⚙ 调用 xx 工具 · 状态」,参数与结果要点开才给)。误差
32
+ * 14 行/张,一屏十几张就是两百行——滚轮往上滚时这些误差被真实测量逐条替换,内容坐标
33
+ * 整个缩水,于是「前几格滚轮不动、再滚一下突然弹回底部」(用户报的连滚回跳),长会话
34
+ * 还会因为跳过段虚高把视口顶推出正文(整片空白)。
35
+ *
36
+ * 所以这里逐类照着渲染器数行(只数结构行,文本按显示宽度折行),宁可与真实差一两行,
37
+ * 也不要差十几行。`text` 仍是「按原文折行」的近似——markdown 的块间距与代码围栏行
38
+ * 一增一减,量级上互相抵消(真值一旦被量到就永久进表,估算只管没滚到过的那段)。
39
+ */
40
+ export function estimateLines(entry, width, options) {
41
+ const usable = Math.max(8, width);
42
+ switch (entry.kind) {
43
+ // 题面:`❯ ` 前缀占两列,前缀与正文同行;前面还留一行空(见 ChatView 的 USER_TOP_GAP)
44
+ case 'user':
45
+ if (entry.internal === true)
46
+ return 1;
47
+ return 1 + folded(entry.text, usable, INDENT_DETAIL);
48
+ // markdown 正文:按原文折行(见上)
49
+ case 'text':
50
+ return folded(entry.text, usable);
51
+ // 思考块:折叠态 = 标签一行 + **恒定 3 行瀑布**(照 dsh 的 preview ticker:每行硬截到框宽、
52
+ // 不折行,所以行数与宽度、与流到哪一句都无关);展开态 = 标签一行 + 全文折行
53
+ case 'thinking':
54
+ if (options?.expandThinking === true) {
55
+ return 1 + folded(entry.text, usable, INDENT_DETAIL);
56
+ }
57
+ return entry.text === '' ? 1 : 1 + WATERFALL_ROWS;
58
+ // 工具行:**默认折叠成一行**「⚙ 调用 xx 工具 · 状态」(点击才展开参数与结果行)。
59
+ // 展开是用户手动触发的少数情形:估算按折叠态,展开后那一帧量到真值就顶上
60
+ // (行高表每次渲染都重量,见 TranscriptViewport 的量测循环)。
61
+ case 'tool':
62
+ return 1;
63
+ // 子代理卡:标题一行;跑动中再挂一行「当前工具」(有才挂)+ 三行瀑布;失败再挂一行原因
64
+ case 'subagent': {
65
+ const working = entry.sub.state === 'working';
66
+ const toolLine = working && entry.sub.lastTool !== undefined ? 1 : 0;
67
+ return (1 +
68
+ toolLine +
69
+ (working ? WATERFALL_ROWS : 0) +
70
+ (entry.sub.state === 'failed' && entry.sub.error !== undefined ? 1 : 0));
71
+ }
72
+ // 计划卡 / 系统说明:标题行 + 文件行;压缩通知多一行分隔线
73
+ case 'plan':
74
+ return 2;
75
+ case 'system':
76
+ return (entry.compaction === undefined ? 0 : 1) + Math.max(1, folded(entry.text, usable, INDENT_DETAIL));
77
+ // 以下都是一行平铺文字(轮尾标记、重试行、文件改动、截断提示)
78
+ default:
79
+ return 1;
80
+ }
81
+ }
82
+ /** 瀑布窗口的行数(子代理卡与思考块共用;与 `ChatView` 的 `WATERFALL_ROWS` 同口径)。 */
83
+ const WATERFALL_ROWS = 3;
84
+ /** 缩进列数(与 theme 的 `INDENT.detail` 同口径;本模块不引 UI 层,故复写常量)。 */
85
+ const INDENT_DETAIL = 2;
86
+ /** 多行文本折行总数(空行算一行,与 ink 的空行渲染一致;**空串算 0 行**)。 */
87
+ function folded(text, usable, indent = 0) {
88
+ // 空串必须是 0:`MarkdownView` 对空正文不产出任何行(`parseMarkdown('')` 是空块表),
89
+ // 而「直播尾还没吐字」的那一帧正是一条空 text 条目——按 1 行估会让整叠内容比真实
90
+ // 高一行,滚动时最后一行就少看一条(曾经在会话列表探针里抓到这个 ±1)。
91
+ if (text === '')
92
+ return 0;
93
+ let lines = 0;
94
+ for (const raw of text.split('\n')) {
95
+ lines += Math.max(1, Math.ceil((displayWidth(raw) + indent) / usable));
96
+ }
97
+ return lines;
98
+ }
99
+ /** 行号 → 锚点:落在那一条的第几行。到(或超过)尾部就是「跟尾」(null)。 */
100
+ export function anchorAtRow(rows, entries, row, maxTop) {
101
+ if (row >= maxTop)
102
+ return null;
103
+ const target = Math.max(0, row);
104
+ let walk = 0;
105
+ for (let index = 0; index < entries.length; index += 1) {
106
+ const height = rows[index] ?? 0;
107
+ if (target < walk + height) {
108
+ return { id: entries[index].id, index, offset: target - walk };
109
+ }
110
+ walk += height;
111
+ }
112
+ // 空会话(或行号落在末尾之外):没有可钉的条目
113
+ return null;
114
+ }
115
+ /** 锚点 → 行号(内容坐标)。`null`(跟尾)给 `totalLines`,调用方自己夹。 */
116
+ export function rowOfAnchor(rows, entries, anchor) {
117
+ let index = entries[anchor.index]?.id === anchor.id ? anchor.index : -1;
118
+ if (index === -1)
119
+ index = entries.findIndex((entry) => entry.id === anchor.id);
120
+ if (index === -1)
121
+ return Number.MAX_SAFE_INTEGER;
122
+ let walk = 0;
123
+ for (let at = 0; at < index; at += 1)
124
+ walk += rows[at] ?? 0;
125
+ return walk + Math.max(0, Math.min(anchor.offset, (rows[index] ?? 1) - 1));
126
+ }
127
+ /** 每条的显示行数:量过就用真值,没量过用估算。 */
128
+ function lineOf(entry, heights, width, options) {
129
+ const measured = heights.get(entry.id);
130
+ return measured ?? estimateLines(entry, width, options);
131
+ }
132
+ /**
133
+ * 算出视口布局。
134
+ *
135
+ * @param entries - 全量条目(顺序即时间序)。
136
+ * @param heights - 行高表(含已量到的真值)。
137
+ * @param options - 内容宽度、视口行数、视口顶锚点(null = 跟尾)。
138
+ */
139
+ export function layoutViewport(entries, heights, options) {
140
+ const { width, viewportLines } = options;
141
+ const viewport = Math.max(1, viewportLines);
142
+ const rows = entries.map((entry) => lineOf(entry, heights, width, options));
143
+ const totalLines = rows.reduce((sum, value) => sum + value, 0);
144
+ const maxShift = Math.max(0, totalLines - viewport);
145
+ const maxTop = Math.max(0, totalLines - viewport);
146
+ // 锚点 → 行号 → 从尾部退多少行;跟尾(null)就是 0
147
+ const wanted = options.anchor === null ? maxTop : rowOfAnchor(rows, entries, options.anchor);
148
+ const shift = Math.max(0, Math.min(maxShift, maxShift - Math.max(0, Math.min(wanted, maxTop))));
149
+ // 视口顶行(内容坐标):从尾部往上退 shift 行
150
+ const top = Math.max(0, totalLines - viewport - shift);
151
+ const windowFrom = top - OVERSCAN_LINES;
152
+ const wantedEnd = top + viewport + OVERSCAN_LINES;
153
+ let start = 0;
154
+ let above = 0;
155
+ while (start < entries.length && above + rows[start] <= windowFrom) {
156
+ above += rows[start];
157
+ start += 1;
158
+ }
159
+ let end = entries.length;
160
+ let cursor = above;
161
+ for (let index = start; index < entries.length; index += 1) {
162
+ cursor += rows[index];
163
+ if (cursor >= wantedEnd) {
164
+ end = index + 1;
165
+ break;
166
+ }
167
+ }
168
+ const windowLines = rows.slice(start, end).reduce((sum, value) => sum + value, 0);
169
+ const below = Math.max(0, totalLines - above - windowLines);
170
+ const turns = [];
171
+ let walk = 0;
172
+ for (let index = 0; index < entries.length; index += 1) {
173
+ const entry = entries[index];
174
+ if (entry.kind === 'user' && entry.internal !== true) {
175
+ turns.push({ id: entry.id, index, top: walk });
176
+ }
177
+ walk += rows[index];
178
+ }
179
+ return { start, end, aboveLines: above, belowLines: below, rows, totalLines, maxShift, shift, top: shift === 0 ? null : top, turns };
180
+ }
181
+ /** 跳到某一轮时该用的滚动量:让这一轮的题面正好落在视口顶上。 */
182
+ export function shiftForTurn(turn, layout, viewportLines) {
183
+ const viewport = Math.max(1, viewportLines);
184
+ return Math.max(0, Math.min(layout.maxShift, layout.totalLines - viewport - turn.top));
185
+ }
186
+ /** 当前视口顶上那一轮(= 拥有视口首行的那一轮;视口在内容头部时算第 0 轮)。 */
187
+ export function activeTurnIndex(turns, shift, layout, viewportLines) {
188
+ if (turns.length === 0)
189
+ return -1;
190
+ const top = Math.max(0, layout.totalLines - Math.max(1, viewportLines) - shift);
191
+ let active = 0;
192
+ for (let index = 0; index < turns.length; index += 1) {
193
+ if (turns[index].top <= top)
194
+ active = index;
195
+ else
196
+ break;
197
+ }
198
+ return active;
199
+ }
200
+ // ── 刻度栏几何 ──────────────────────────────────────────────────────────────
201
+ /** 刻度栏占的列数(dsh 同款 2 列:`━━` / ` ─` 对齐)。 */
202
+ export const RAIL_WIDTH = 2;
203
+ /** 窄于此不画(再窄正文就挤没了)。 */
204
+ export const RAIL_MIN_COLUMNS = 60;
205
+ /** 至少两轮才值得画。 */
206
+ export const RAIL_MIN_TURNS = 2;
207
+ /**
208
+ * 刻度栏的字形(照 dsh-TUI 的 TimelineRail 搬):当前轮 `━━` 重线、其余 ` ─` 短线
209
+ * (占满 2 列、右对齐,不靠测量对齐)、箭头 `▴`/`▾`。
210
+ */
211
+ export const RAIL_GLYPH = {
212
+ active: '━━',
213
+ idle: ' ─',
214
+ up: ' ▴',
215
+ down: ' ▾',
216
+ };
217
+ /** 画不画右侧那一列(轮数刻度)。 */
218
+ export function gutterEligible(options) {
219
+ if (options.columns < RAIL_MIN_COLUMNS)
220
+ return false;
221
+ // 一屏装得下、连一行都塞不进这列——画出来只是噪音
222
+ if (options.viewportLines < 3)
223
+ return false;
224
+ if (options.contentLines <= options.viewportLines)
225
+ return false;
226
+ return true;
227
+ }
228
+ /** 画不画**轮数刻度**(还要 ≥2 轮:一轮的刻度没有可跳的目标,整列就不画)。 */
229
+ export function railEligible(options) {
230
+ if (options.turnCount < RAIL_MIN_TURNS)
231
+ return false;
232
+ return gutterEligible(options);
233
+ }
234
+ /**
235
+ * 上/下一轮的跳转目标(刻度栏箭头与 `[`/`]` 键**共用这一条**,两边不可能对不上)。
236
+ *
237
+ * 两条 dsh 定的规矩:
238
+ * - ▲ 先对齐本轮的题面:读到本轮中段(视口顶在本轮题面之下)时,▲ 指的就是**本轮**
239
+ * ——再按一次才退到上一轮。少了这条,读到长回答中段按 ▲ 会直接跳过本轮的题面。
240
+ * - 名下的那一轮必须真能滚到视口顶(顶行号 ≤ 能滚到的最大顶行号):够不着的那一轮
241
+ * 点下去没反应,箭头却亮着,按几次都不动。够不着就不给目标(暗箭头 = 保证的空操作)。
242
+ *
243
+ * @param options - 轮数、当前轮、视口顶与最大顶行号(内容坐标)、每轮顶行号(可选)。
244
+ */
245
+ export function turnJumpTarget(options) {
246
+ const { turnCount, activeIndex, direction } = options;
247
+ if (turnCount === 0 || activeIndex < 0 || activeIndex >= turnCount)
248
+ return null;
249
+ const tops = options.turnTops;
250
+ if (direction === 'up') {
251
+ const activeTop = tops?.[activeIndex];
252
+ const midTurn = activeTop !== undefined && options.viewportTop !== undefined && options.viewportTop > activeTop;
253
+ const target = midTurn ? activeIndex : activeIndex - 1;
254
+ return target >= 0 ? target : null;
255
+ }
256
+ const next = activeIndex + 1;
257
+ if (next >= turnCount)
258
+ return null;
259
+ const nextTop = tops?.[next];
260
+ if (nextTop !== undefined && options.maxTop !== undefined && nextTop > options.maxTop)
261
+ return null;
262
+ return next;
263
+ }
264
+ /**
265
+ * 刻度栏几何(照 dsh-TUI 的 `computeRailGeometry`):一轮一格,▲ + 刻度 + ▼ 这一块在
266
+ * 列里**纵向居中**,两头没有目标时箭头照样画(暗色)——位置固定,视线才不用每帧重新找。
267
+ *
268
+ * 窗口:轮数多于格子(列高 − 2)时绕当前轮滑一格;贴尾时钉住最新的那几格(活动刻度
269
+ * 永远在窗口里,否则没有一格是高亮的)。行数不够画(列高 < 3)返回全空。
270
+ *
271
+ * **居中用的高度与窗口用的高度可以分开**(`centerRows` / `rows`),这不是冗余:聊天区
272
+ * 的可用高度会随「回到底部」胶囊、草稿变高这些**页脚**变化而少一行,块若按它居中,
273
+ * 一滚动整块就上下挪一格(用户报障「上下滑动时刻度会上下晃」)。所以调用方按**只在
274
+ * 改变终端尺寸时才变**的高度居中,窗口仍按真实列高算;`centerRows` 比列高大时夹住
275
+ * (块最矮也得整块留在列里,否则 ▼ 会被裁出去)。
276
+ *
277
+ * 每一行落什么还由 `rows` 数组直接给出(渲染与命中判定同源),`upRow`/`tickTop`/`downRow`
278
+ * 是给探针读的同一份几何。
279
+ *
280
+ * @param options - 轮数、当前轮、可用行数(= 视口行数)、是否贴尾、每轮顶行号等。
281
+ */
282
+ export function railGeometry(options) {
283
+ const rows = Math.max(1, options.rows);
284
+ const turnCount = Math.max(0, options.turnCount);
285
+ /** 上下各留一行给 ▲/▼(dsh 同款:箭头行永远存在,有没有目标只改颜色)。 */
286
+ const maxTicks = rows - 2;
287
+ // 轮数不到两轮、或列高装不下「▲ + 一格 + ▼」——整列空(与 dsh 的 null 同义)
288
+ if (turnCount < RAIL_MIN_TURNS || maxTicks < 1) {
289
+ return {
290
+ rows: Array.from({ length: rows }, () => null),
291
+ up: null,
292
+ down: null,
293
+ upRow: -1,
294
+ downRow: -1,
295
+ tickTop: -1,
296
+ windowStart: 0,
297
+ windowEnd: 0,
298
+ };
299
+ }
300
+ const activeIndex = Math.max(0, Math.min(options.activeIndex, turnCount - 1));
301
+ const shown = Math.min(turnCount, maxTicks);
302
+ let start = 0;
303
+ if (turnCount > maxTicks) {
304
+ const tailStart = turnCount - maxTicks;
305
+ start =
306
+ options.atBottom === true
307
+ ? Math.min(activeIndex, tailStart)
308
+ : Math.min(Math.max(0, activeIndex - Math.floor(maxTicks / 2)), tailStart);
309
+ }
310
+ const up = turnJumpTarget({ ...options, turnCount, activeIndex, direction: 'up' });
311
+ const down = turnJumpTarget({ ...options, turnCount, activeIndex, direction: 'down' });
312
+ // 纵向居中(对齐 dsh):▲ + 刻度 + ▼ 整块居中,剩下的行上下平分。
313
+ // 居中高度可以是「稳定高度」(见 `centerRows`),但块必须整块留在列里——夹住下界
314
+ const blockLines = shown + 2;
315
+ const blockTop = Math.max(0, Math.min(Math.floor((Math.max(1, options.centerRows ?? rows) - blockLines) / 2), rows - blockLines));
316
+ const upRow = blockTop;
317
+ const tickTop = blockTop + 1;
318
+ const downRow = tickTop + shown;
319
+ const output = Array.from({ length: rows }, () => null);
320
+ output[upRow] = { kind: 'up', enabled: up !== null };
321
+ for (let offset = 0; offset < shown; offset += 1) {
322
+ const turn = start + offset;
323
+ output[tickTop + offset] = { kind: 'tick', turn, active: turn === activeIndex };
324
+ }
325
+ output[downRow] = { kind: 'down', enabled: down !== null };
326
+ return {
327
+ rows: output,
328
+ up,
329
+ down,
330
+ upRow,
331
+ downRow,
332
+ tickTop,
333
+ windowStart: start,
334
+ windowEnd: start + shown,
335
+ };
336
+ }
337
+ /** 刻度栏某一行的命中判定:点到刻度给轮下标、箭头给 'up'/'down'、空行给 null。 */
338
+ export function railHitRow(geometry, row) {
339
+ const entry = geometry.rows[row];
340
+ if (entry === undefined || entry === null)
341
+ return null;
342
+ if (entry.kind === 'up')
343
+ return 'up';
344
+ if (entry.kind === 'down')
345
+ return 'down';
346
+ return entry.turn;
347
+ }
@@ -0,0 +1,69 @@
1
+ /**
2
+ * 设置页行模型:SettingsOverlay 画几行、App 的鼠标点击换算成哪一行,共用这一份
3
+ * 几何表——两边都从 buildSettingsRows 拿同一条 flat 行数组,行号永远不错位。
4
+ *
5
+ * 行高恒为 1:卡片顶边/底边各占一行、字段占一行、分区之间空一行,help 文案
6
+ * 不进卡片行(聚焦行的 help 走底部提示条,对齐 dsh 的布局)。
7
+ *
8
+ * 两级导航(0.6.64,把 0.6.62 的组子页机制上提一层):根页每分区只画一行导航
9
+ * (`❯ 标题 · 副标题 … ›`),Enter 进分区页——分区页渲染该分区的内容(custom
10
+ * 分区的指引行 / 普通分区块内字段,带组的分区画组导航行);组子页(0.6.62)原样
11
+ * 保留,恰好两级。Esc 由 App 逐级退栈:组 → 分区 → 根 → 关页。
12
+ *
13
+ * @module dsc-tui/app/settings-model
14
+ */
15
+ import type { SettingsSectionView } from '../contract.js';
16
+ /** 当前展开的组子页(null/缺省 = 不在组子页)。 */
17
+ export interface SettingsGroupRef {
18
+ sectionId: string;
19
+ groupId: string;
20
+ }
21
+ /** 设置页的一行;section/field/hint/group 可聚焦,其余是结构行。 */
22
+ export type SettingsRow = {
23
+ kind: 'card-top';
24
+ sectionId: string;
25
+ title: string;
26
+ subtitle?: string;
27
+ } | {
28
+ kind: 'card-bottom';
29
+ } | {
30
+ kind: 'spacer';
31
+ } | {
32
+ kind: 'section';
33
+ sectionId: string;
34
+ title: string;
35
+ subtitle?: string;
36
+ } | {
37
+ kind: 'field';
38
+ sectionId: string;
39
+ fieldIndex: number;
40
+ } | {
41
+ kind: 'group';
42
+ sectionId: string;
43
+ groupId: string;
44
+ title: string;
45
+ description?: string;
46
+ } | {
47
+ kind: 'hint';
48
+ sectionId: string;
49
+ text: string;
50
+ jump?: 'model-picker' | 'usage';
51
+ };
52
+ /**
53
+ * 分区列表 → flat 行数组。三种模式:
54
+ * group != null → 组子页(只渲染该组字段,卡片标题 = 组名、副标题 = 分区名);
55
+ * section != null → 分区页(该分区一张卡片:字段/组导航/指引行);
56
+ * 两者都空 → 根页(每分区一行导航,不画卡片——名字本身就是入口)。
57
+ * 分区/组没声明或没了就给空表(App 侧 Esc 兜底回上级,不会停在白屏)。
58
+ */
59
+ export declare function buildSettingsRows(sections: SettingsSectionView[], sectionId?: string | null, group?: SettingsGroupRef | null): SettingsRow[];
60
+ /** 该行能不能拿到焦点(有 Enter/←→ 动作才给焦点:info 仅 copyable 可聚焦,分区/组行恒可聚焦)。 */
61
+ export declare function isFocusableRow(row: SettingsRow, fields: SettingsSectionView['fields']): boolean;
62
+ /** 焦点可落的行号表(buildSettingsRows 顺序里的下标;↑↓ 与滚轮在其上移动)。 */
63
+ export declare function focusableRows(rows: SettingsRow[], sections: SettingsSectionView[]): number[];
64
+ /**
65
+ * 焦点跟随窗口(dsh windowStart 同语义):保证聚焦行落在视口内,越过下缘窗口
66
+ * 跟进一行、顶回上缘窗口钉住;行数不足一屏时窗口恒为 0。纯函数——组件与
67
+ * App 的鼠标映射各自调用,结果一致。
68
+ */
69
+ export declare function settingsWindowStart(focusRow: number, viewport: number, total: number): number;
@@ -0,0 +1,114 @@
1
+ /**
2
+ * custom 分区在 TUI 的指引内容:管理界面在桌面端自己画,TUI 只给入口与去处——
3
+ * 带 jump 的是可聚焦行(Enter 触发跳转),纯文案行只作说明。
4
+ */
5
+ const CUSTOM_HINTS = {
6
+ models: [
7
+ { text: '打开模型选择器', jump: 'model-picker' },
8
+ { text: '端点与 API key 在桌面端设置或 ~/.dsc/config.yaml 管理' },
9
+ ],
10
+ presets: [{ text: '会话内 /preset <名> 切换;默认模式在桌面端设置' }],
11
+ skills: [{ text: '技能目录 ~/.dsc/skills;开关管理在桌面端' }],
12
+ usage: [{ text: '查看用量统计', jump: 'usage' }],
13
+ archive: [{ text: '/resume 的已归档页可恢复会话' }],
14
+ };
15
+ /** 单个分区的正文行(卡片顶边之后、底边之前的那段);根页与分区页共用一份装配。 */
16
+ function sectionBodyRows(section) {
17
+ const rows = [];
18
+ const hints = CUSTOM_HINTS[section.id];
19
+ if (section.custom) {
20
+ for (const hint of hints ?? [])
21
+ rows.push({ kind: 'hint', sectionId: section.id, ...hint });
22
+ return rows;
23
+ }
24
+ // 带组的字段收进子页,组行在其第一个字段的位置就地出现(只出现一次);
25
+ // 组没声明或组内没字段就不画导航行。
26
+ const emitted = new Set();
27
+ section.fields.forEach((field, fieldIndex) => {
28
+ const spec = field.group === undefined ? undefined : section.groups?.find((entry) => entry.id === field.group);
29
+ if (spec === undefined) {
30
+ rows.push({ kind: 'field', sectionId: section.id, fieldIndex });
31
+ return;
32
+ }
33
+ if (emitted.has(spec.id))
34
+ return;
35
+ emitted.add(spec.id);
36
+ rows.push({ kind: 'group', sectionId: section.id, groupId: spec.id, title: spec.title, description: spec.description });
37
+ });
38
+ return rows;
39
+ }
40
+ /**
41
+ * 分区列表 → flat 行数组。三种模式:
42
+ * group != null → 组子页(只渲染该组字段,卡片标题 = 组名、副标题 = 分区名);
43
+ * section != null → 分区页(该分区一张卡片:字段/组导航/指引行);
44
+ * 两者都空 → 根页(每分区一行导航,不画卡片——名字本身就是入口)。
45
+ * 分区/组没声明或没了就给空表(App 侧 Esc 兜底回上级,不会停在白屏)。
46
+ */
47
+ export function buildSettingsRows(sections, sectionId, group) {
48
+ if (group != null) {
49
+ const section = sections.find((entry) => entry.id === group.sectionId);
50
+ const spec = section?.groups?.find((entry) => entry.id === group.groupId);
51
+ if (section === undefined || spec === undefined)
52
+ return [];
53
+ const rows = [{ kind: 'card-top', sectionId: section.id, title: spec.title, subtitle: section.title }];
54
+ section.fields.forEach((field, fieldIndex) => {
55
+ if (field.group === group.groupId)
56
+ rows.push({ kind: 'field', sectionId: section.id, fieldIndex });
57
+ });
58
+ rows.push({ kind: 'card-bottom' });
59
+ return rows;
60
+ }
61
+ if (sectionId != null) {
62
+ const section = sections.find((entry) => entry.id === sectionId);
63
+ if (section === undefined)
64
+ return [];
65
+ return [
66
+ { kind: 'card-top', sectionId: section.id, title: section.title, subtitle: section.subtitle },
67
+ ...sectionBodyRows(section),
68
+ { kind: 'card-bottom' },
69
+ ];
70
+ }
71
+ return sections.map((section) => ({
72
+ kind: 'section',
73
+ sectionId: section.id,
74
+ title: section.title,
75
+ ...(section.subtitle === undefined ? {} : { subtitle: section.subtitle }),
76
+ }));
77
+ }
78
+ /** 该行能不能拿到焦点(有 Enter/←→ 动作才给焦点:info 仅 copyable 可聚焦,分区/组行恒可聚焦)。 */
79
+ export function isFocusableRow(row, fields) {
80
+ if (row.kind === 'section' || row.kind === 'group')
81
+ return true;
82
+ if (row.kind === 'field') {
83
+ const field = fields[row.fieldIndex];
84
+ return field !== undefined && (field.type !== 'info' || field.copyable === true);
85
+ }
86
+ return row.kind === 'hint' && row.jump !== undefined;
87
+ }
88
+ /** 焦点可落的行号表(buildSettingsRows 顺序里的下标;↑↓ 与滚轮在其上移动)。 */
89
+ export function focusableRows(rows, sections) {
90
+ const byId = new Map(sections.map((section) => [section.id, section]));
91
+ const result = [];
92
+ rows.forEach((row, index) => {
93
+ if (row.kind === 'section' || row.kind === 'group') {
94
+ result.push(index);
95
+ return;
96
+ }
97
+ if (row.kind !== 'field' && row.kind !== 'hint')
98
+ return;
99
+ const fields = byId.get(row.sectionId)?.fields ?? [];
100
+ if (isFocusableRow(row, fields))
101
+ result.push(index);
102
+ });
103
+ return result;
104
+ }
105
+ /**
106
+ * 焦点跟随窗口(dsh windowStart 同语义):保证聚焦行落在视口内,越过下缘窗口
107
+ * 跟进一行、顶回上缘窗口钉住;行数不足一屏时窗口恒为 0。纯函数——组件与
108
+ * App 的鼠标映射各自调用,结果一致。
109
+ */
110
+ export function settingsWindowStart(focusRow, viewport, total) {
111
+ if (viewport <= 0 || total <= viewport)
112
+ return 0;
113
+ return Math.max(0, Math.min(focusRow - viewport + 1, focusRow, total - viewport));
114
+ }
@@ -0,0 +1,34 @@
1
+ /** 默认合并窗口:与桌面/远程同值(80ms ≈ 12.5 次/秒上限,肉眼仍连续)。 */
2
+ export declare const TUI_SNAPSHOT_MS = 80;
3
+ export interface CoalesceOptions {
4
+ /** 合并窗口毫秒;≤0 = 不合并(测试与排障用)。 */
5
+ ms: number;
6
+ /** 时间源(测试注入假时钟)。 */
7
+ now?: () => number;
8
+ }
9
+ export interface CoalescedStore<T> {
10
+ /** 交给 `useSyncExternalStore` 的 subscribe(多监听者共用一个窗口与一个定时器)。 */
11
+ subscribe: (onStoreChange: () => void) => () => void;
12
+ /** 交给 `useSyncExternalStore` 的 getSnapshot(窗口内引用冻结)。 */
13
+ getSnapshot: () => T;
14
+ /** 还有没有攒着没放出去的变更(探针用)。 */
15
+ pending: () => boolean;
16
+ }
17
+ /**
18
+ * 把「上游的同步通知 + 每次都变的上游取值」折成「窗口一次的稳定取值」。
19
+ *
20
+ * @param readUpstream - 上游取值(如 `runtime.getSnapshot`)。
21
+ * @param upstream - 上游 subscribe,返回退订函数。
22
+ * @param options - 合并窗口与时间源。
23
+ */
24
+ export declare function createCoalescedStore<T>(readUpstream: () => T, upstream: (listener: () => void) => () => void, options: CoalesceOptions): CoalescedStore<T>;
25
+ /**
26
+ * 给 App 用的快捷封装:按 runtime 缓存的合并存储。
27
+ *
28
+ * @param runtime - 提供 `subscribe` / `getSnapshot` 的运行时(TUI 里就是 runtime 服务)。
29
+ * @param ms - 合并窗口(测试注入 0 可以要一条直通路径做对照)。
30
+ */
31
+ export declare function useCoalescedSnapshot<T>(runtime: {
32
+ subscribe: (listener: () => void) => () => void;
33
+ getSnapshot: () => T;
34
+ }, ms?: number): CoalescedStore<T>;
@@ -0,0 +1,110 @@
1
+ /**
2
+ * TUI 快照存储:把「上游每个 delta 一次」的通知折成「一个窗口一次」的**取值**。
3
+ *
4
+ * 为什么需要(两笔账):
5
+ * 1. `transcript.invalidate()`(src/plugins/transcript.ts:54)是同步通知,TUI 又直接
6
+ * `useSyncExternalStore(runtime.subscribe, ...)` —— 队友流式跑起来时每个 text/
7
+ * reasoning delta 都要走一次 `forwardSubagent → transcript.emit → invalidate`
8
+ * (src/plugins/subagent.ts:459),也就是**一次全树 React reconcile**。三个队友叠
9
+ * 起来就是几十次/秒(ink 只把终端写入限在 30fps,CPU 是花在 React 上的,所以照样卡)。
10
+ * 桌面/远程早就有这道闸(host-stdio / remote 的 80ms 合并),TUI 是唯一没有的消费者。
11
+ * 2. 光节流通知还不够:上游每次 invalidate 都会把快照缓存清掉,`getSnapshot()` 于是
12
+ * 每次读都返回**新对象**;React 会在提交后的被动效果里复读一次做「快照有没有变」的
13
+ * 一致性检查,读到新对象就再提交一帧。实测 60 次变更里通知只落了 3 次,提交却有 10 次。
14
+ * 所以这个存储要在窗口内**冻结取值**:窗口里 React 读几次都拿到同一个引用。
15
+ *
16
+ * 语义(三条都不能丢):
17
+ * - **leading**:静默期后的第一个变更立刻取一次值——点一下、敲一句的响应不能等窗口;
18
+ * - **trailing**:窗口内的后续变更攒到窗口末尾一次性取值——稳态提交次数 ≈ 1000/ms;
19
+ * - **冻结**:两次取值之间 `getSnapshot()` 返回同一个引用,React 不会因为复读而重复提交。
20
+ *
21
+ * @module dsc-tui/app/snapshot-subscribe
22
+ */
23
+ import { useMemo } from 'react';
24
+ /** 默认合并窗口:与桌面/远程同值(80ms ≈ 12.5 次/秒上限,肉眼仍连续)。 */
25
+ export const TUI_SNAPSHOT_MS = 80;
26
+ /**
27
+ * 把「上游的同步通知 + 每次都变的上游取值」折成「窗口一次的稳定取值」。
28
+ *
29
+ * @param readUpstream - 上游取值(如 `runtime.getSnapshot`)。
30
+ * @param upstream - 上游 subscribe,返回退订函数。
31
+ * @param options - 合并窗口与时间源。
32
+ */
33
+ export function createCoalescedStore(readUpstream, upstream, options) {
34
+ const { ms } = options;
35
+ const now = options.now ?? Date.now;
36
+ const listeners = new Set();
37
+ let off = null;
38
+ let timer = null;
39
+ /** 窗口内还有没放出去过的变更。 */
40
+ let pending = false;
41
+ /** 上次放值的时刻(-Infinity = 从没放过,第一个变更走 leading)。 */
42
+ let lastFlush = Number.NEGATIVE_INFINITY;
43
+ /** 冻结的取值:只有放值那一刻才换引用。 */
44
+ let value = null;
45
+ /** 取一次上游值并换掉引用,然后通知下游。 */
46
+ const publish = () => {
47
+ value = { current: readUpstream() };
48
+ lastFlush = now();
49
+ pending = false;
50
+ for (const listener of [...listeners])
51
+ listener();
52
+ };
53
+ const flush = () => {
54
+ timer = null;
55
+ if (!pending)
56
+ return;
57
+ publish();
58
+ };
59
+ const cancelTimer = () => {
60
+ if (timer === null)
61
+ return;
62
+ clearTimeout(timer);
63
+ timer = null;
64
+ };
65
+ const onUpstreamChange = () => {
66
+ const at = now();
67
+ if (ms <= 0 || at - lastFlush >= ms) {
68
+ // 静默期已过(或压根不合并):立刻放值,窗口内的后续变更排到窗口末尾
69
+ cancelTimer();
70
+ publish();
71
+ return;
72
+ }
73
+ pending = true;
74
+ if (timer !== null)
75
+ return;
76
+ timer = setTimeout(flush, Math.max(1, ms - (at - lastFlush)));
77
+ timer.unref?.();
78
+ };
79
+ return {
80
+ pending: () => pending,
81
+ getSnapshot() {
82
+ value ??= { current: readUpstream() };
83
+ return value.current;
84
+ },
85
+ subscribe(onStoreChange) {
86
+ listeners.add(onStoreChange);
87
+ if (off === null)
88
+ off = upstream(onUpstreamChange);
89
+ return () => {
90
+ listeners.delete(onStoreChange);
91
+ if (listeners.size > 0)
92
+ return;
93
+ cancelTimer();
94
+ pending = false;
95
+ const stop = off;
96
+ off = null;
97
+ stop?.();
98
+ };
99
+ },
100
+ };
101
+ }
102
+ /**
103
+ * 给 App 用的快捷封装:按 runtime 缓存的合并存储。
104
+ *
105
+ * @param runtime - 提供 `subscribe` / `getSnapshot` 的运行时(TUI 里就是 runtime 服务)。
106
+ * @param ms - 合并窗口(测试注入 0 可以要一条直通路径做对照)。
107
+ */
108
+ export function useCoalescedSnapshot(runtime, ms = TUI_SNAPSHOT_MS) {
109
+ return useMemo(() => createCoalescedStore(() => runtime.getSnapshot(), (l) => runtime.subscribe(l), { ms }), [runtime, ms]);
110
+ }