@waq666/pneuma 0.7.1 → 0.8.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 (416) hide show
  1. package/README.md +242 -206
  2. package/bin/dsc.js +9 -3
  3. package/bin/headless.cjs +1 -1
  4. package/lib/adapter/transcript.d.ts +19 -2
  5. package/lib/adapter/transcript.js +71 -14
  6. package/lib/app/AgentsOverlay.js +7 -6
  7. package/lib/app/App.js +1 -1
  8. package/lib/app/ApprovalCard.js +15 -9
  9. package/lib/app/ChatView.d.ts +3 -1
  10. package/lib/app/ChatView.js +21 -17
  11. package/lib/app/Composer.js +22 -4
  12. package/lib/app/MarkdownView.js +2 -1
  13. package/lib/app/ModelPicker.js +7 -6
  14. package/lib/app/PickerFrame.d.ts +4 -0
  15. package/lib/app/PickerFrame.js +18 -0
  16. package/lib/app/PlanReviewCard.js +2 -1
  17. package/lib/app/PresetPicker.js +8 -7
  18. package/lib/app/SessionPicker.js +21 -20
  19. package/lib/app/SettingsOverlay.js +1 -1
  20. package/lib/app/SkillsPicker.js +7 -6
  21. package/lib/app/StatusBar.js +3 -15
  22. package/lib/app/TaskStrips.js +1 -4
  23. package/lib/app/TimelineRail.js +2 -1
  24. package/lib/app/ToolCard.js +2 -6
  25. package/lib/app/Welcome.d.ts +1 -0
  26. package/lib/app/Welcome.js +1 -4
  27. package/lib/app/click.d.ts +0 -2
  28. package/lib/app/click.js +2 -21
  29. package/lib/app/display-width.d.ts +16 -0
  30. package/lib/app/display-width.js +33 -0
  31. package/lib/app/markdown.d.ts +1 -3
  32. package/lib/app/markdown.js +2 -19
  33. package/lib/app/scroll-model.js +1 -1
  34. package/lib/contract/approval.d.ts +91 -0
  35. package/lib/contract/approval.js +1 -0
  36. package/lib/contract/mode.d.ts +69 -0
  37. package/lib/contract/mode.js +1 -0
  38. package/lib/contract/plugin.d.ts +240 -0
  39. package/lib/contract/plugin.js +1 -0
  40. package/lib/contract/runtime.d.ts +282 -0
  41. package/lib/contract/runtime.js +1 -0
  42. package/lib/contract/session.d.ts +208 -0
  43. package/lib/contract/session.js +36 -0
  44. package/lib/contract/settings.d.ts +242 -0
  45. package/lib/contract/settings.js +1 -0
  46. package/lib/contract/snapshot.d.ts +453 -0
  47. package/lib/contract/snapshot.js +1 -0
  48. package/lib/contract/task.d.ts +189 -0
  49. package/lib/contract/task.js +10 -0
  50. package/lib/contract/transcript.d.ts +358 -0
  51. package/lib/contract/transcript.js +1 -0
  52. package/lib/contract/usage.d.ts +132 -0
  53. package/lib/contract/usage.js +10 -0
  54. package/lib/contract.d.ts +20 -1968
  55. package/lib/contract.js +19 -30
  56. package/lib/core/agent-roles.d.ts +1 -1
  57. package/lib/core/agent-roles.js +6 -5
  58. package/lib/core/approval-floor.d.ts +9 -0
  59. package/lib/core/approval-floor.js +152 -25
  60. package/lib/core/attachments.d.ts +185 -0
  61. package/lib/core/attachments.js +425 -0
  62. package/lib/core/bytes.d.ts +14 -0
  63. package/lib/core/bytes.js +28 -0
  64. package/lib/core/call-meaning.d.ts +20 -0
  65. package/lib/core/call-meaning.js +347 -0
  66. package/lib/core/cdp/actions.js +6 -0
  67. package/lib/core/cdp/launch.js +2 -2
  68. package/lib/core/cdp/report.d.ts +27 -0
  69. package/lib/core/cdp/report.js +50 -0
  70. package/lib/core/cdp/ring-buffer.d.ts +25 -0
  71. package/lib/core/cdp/ring-buffer.js +44 -0
  72. package/lib/core/cdp/snapshot.js +5 -9
  73. package/lib/core/cdp/transport.js +1 -1
  74. package/lib/core/clamp.d.ts +20 -0
  75. package/lib/core/clamp.js +24 -0
  76. package/lib/core/clock.d.ts +16 -0
  77. package/lib/core/clock.js +20 -0
  78. package/lib/core/command-policy.js +33 -1
  79. package/lib/core/commands-completion.d.ts +28 -0
  80. package/lib/core/commands-completion.js +108 -30
  81. package/lib/core/compact.d.ts +36 -6
  82. package/lib/core/compact.js +89 -17
  83. package/lib/core/desktop-control.js +1 -3
  84. package/lib/core/dsh-compat/llm-usage-event.d.ts +78 -0
  85. package/lib/core/dsh-compat/llm-usage-event.js +91 -0
  86. package/lib/core/dsh-compat/presentation.d.ts +84 -0
  87. package/lib/core/dsh-compat/presentation.js +105 -0
  88. package/lib/core/dsh-compat/resolve-hook.d.ts +3 -3
  89. package/lib/core/dsh-compat/resolve-hook.js +41 -13
  90. package/lib/core/dsh-compat/service-map.d.ts +52 -0
  91. package/lib/core/dsh-compat/service-map.js +87 -0
  92. package/lib/core/dsh-compat/session-bridge.d.ts +107 -0
  93. package/lib/core/dsh-compat/session-bridge.js +376 -0
  94. package/lib/core/dsh-compat/session-events.d.ts +54 -0
  95. package/lib/core/dsh-compat/session-events.js +297 -0
  96. package/lib/core/dsh-compat/shims/credentials.d.ts +62 -0
  97. package/lib/core/dsh-compat/shims/credentials.js +86 -0
  98. package/lib/core/dsh-compat/shims/home-paths.d.ts +77 -0
  99. package/lib/core/dsh-compat/shims/home-paths.js +143 -0
  100. package/lib/core/dsh-compat/tools-facade.d.ts +31 -1
  101. package/lib/core/dsh-compat/tools-facade.js +207 -3
  102. package/lib/core/err-text.d.ts +5 -0
  103. package/lib/core/err-text.js +5 -0
  104. package/lib/core/events.d.ts +31 -2
  105. package/lib/core/git-info.d.ts +127 -15
  106. package/lib/core/git-info.js +315 -34
  107. package/lib/core/git-surface.d.ts +17 -0
  108. package/lib/core/git-surface.js +7 -0
  109. package/lib/core/hooks.d.ts +19 -2
  110. package/lib/core/hooks.js +57 -13
  111. package/lib/core/host-methods.d.ts +1 -1
  112. package/lib/core/host-methods.js +4 -0
  113. package/lib/core/image-diet.js +1 -4
  114. package/lib/core/json-text.d.ts +11 -0
  115. package/lib/core/json-text.js +18 -0
  116. package/lib/core/learnings/skill-write.d.ts +1 -7
  117. package/lib/core/learnings/skill-write.js +3 -37
  118. package/lib/core/lifecycle-hooks.d.ts +11 -3
  119. package/lib/core/lifecycle-hooks.js +33 -42
  120. package/lib/core/llm.d.ts +42 -0
  121. package/lib/core/llm.js +40 -25
  122. package/lib/core/loop.d.ts +11 -1
  123. package/lib/core/loop.js +95 -28
  124. package/lib/core/lsp/client.js +30 -17
  125. package/lib/core/lsp/normalize.d.ts +0 -2
  126. package/lib/core/lsp/normalize.js +1 -6
  127. package/lib/core/lsp/servers.js +1 -4
  128. package/lib/core/mcp.d.ts +18 -0
  129. package/lib/core/mcp.js +60 -16
  130. package/lib/core/microcompact.d.ts +45 -0
  131. package/lib/core/microcompact.js +128 -0
  132. package/lib/core/native-bridge.js +2 -10
  133. package/lib/core/path-policy.d.ts +13 -1
  134. package/lib/core/path-policy.js +87 -18
  135. package/lib/core/permission-presets.d.ts +9 -5
  136. package/lib/core/permission-presets.js +14 -7
  137. package/lib/core/permission-scope.d.ts +65 -0
  138. package/lib/core/permission-scope.js +109 -0
  139. package/lib/core/plugin-bundle.d.ts +95 -0
  140. package/lib/core/plugin-bundle.js +137 -0
  141. package/lib/core/plugin-loader.d.ts +36 -1
  142. package/lib/core/plugin-loader.js +336 -12
  143. package/lib/core/plugin-patch.d.ts +64 -0
  144. package/lib/core/plugin-patch.js +146 -0
  145. package/lib/core/plugin-registry.d.ts +14 -0
  146. package/lib/core/plugin-registry.js +2 -0
  147. package/lib/core/prefs.js +40 -2
  148. package/lib/core/presets.d.ts +11 -0
  149. package/lib/core/presets.js +61 -22
  150. package/lib/core/profile-dir.d.ts +5 -0
  151. package/lib/core/profile-dir.js +40 -0
  152. package/lib/core/prompt.js +55 -19
  153. package/lib/core/ptc.d.ts +8 -2
  154. package/lib/core/ptc.js +18 -4
  155. package/lib/core/records.d.ts +16 -0
  156. package/lib/core/records.js +22 -0
  157. package/lib/core/remote/notify.js +1 -3
  158. package/lib/core/remote/push.js +2 -6
  159. package/lib/core/sandbox/execpolicy.js +27 -3
  160. package/lib/core/sandbox/net-proxy.js +2 -2
  161. package/lib/core/sandbox/policy.d.ts +1 -1
  162. package/lib/core/sandbox/policy.js +21 -15
  163. package/lib/core/sandbox/win/account.js +1 -4
  164. package/lib/core/sandbox/win/acl.js +1 -6
  165. package/lib/core/sandbox/win/backend.d.ts +24 -3
  166. package/lib/core/sandbox/win/backend.js +73 -23
  167. package/lib/core/sandbox/win/doctor.js +1 -4
  168. package/lib/core/sandbox/win/runner-entry.js +1 -6
  169. package/lib/core/sandbox/win/setup.js +1 -4
  170. package/lib/core/sandbox/win/utf16.d.ts +11 -0
  171. package/lib/core/sandbox/win/utf16.js +15 -0
  172. package/lib/core/sandbox/win/wfp.js +1 -4
  173. package/lib/core/schedule/rule.d.ts +0 -17
  174. package/lib/core/schedule/rule.js +1 -3
  175. package/lib/core/schedule/runner.d.ts +5 -2
  176. package/lib/core/schedule/runner.js +32 -9
  177. package/lib/core/schedule/store.d.ts +0 -2
  178. package/lib/core/schedule/store.js +2 -9
  179. package/lib/core/session-index.d.ts +50 -0
  180. package/lib/core/session-index.js +169 -3
  181. package/lib/core/session.d.ts +89 -13
  182. package/lib/core/session.js +385 -32
  183. package/lib/core/shell-quote.d.ts +21 -0
  184. package/lib/core/shell-quote.js +24 -0
  185. package/lib/core/side-ask.d.ts +52 -0
  186. package/lib/core/side-ask.js +89 -0
  187. package/lib/core/skills.d.ts +16 -0
  188. package/lib/core/skills.js +45 -8
  189. package/lib/core/snapshot-throttle.d.ts +8 -0
  190. package/lib/core/snapshot-throttle.js +24 -0
  191. package/lib/core/spill.d.ts +11 -5
  192. package/lib/core/spill.js +35 -36
  193. package/lib/core/strings.d.ts +21 -0
  194. package/lib/core/strings.js +33 -0
  195. package/lib/core/terminal-env.d.ts +61 -0
  196. package/lib/core/terminal-env.js +327 -0
  197. package/lib/core/text-format.d.ts +17 -0
  198. package/lib/core/text-format.js +26 -0
  199. package/lib/core/todo-reminder.d.ts +19 -14
  200. package/lib/core/todo-reminder.js +14 -23
  201. package/lib/core/token-estimate.d.ts +18 -2
  202. package/lib/core/token-estimate.js +10 -2
  203. package/lib/core/tool-result-prune.d.ts +42 -0
  204. package/lib/core/tool-result-prune.js +47 -0
  205. package/lib/core/tool-search.d.ts +3 -2
  206. package/lib/core/tool-search.js +3 -2
  207. package/lib/core/tools/bash.d.ts +35 -3
  208. package/lib/core/tools/bash.js +168 -41
  209. package/lib/core/tools/fs-tools.js +18 -17
  210. package/lib/core/tools/image-tool.d.ts +2 -0
  211. package/lib/core/tools/image-tool.js +59 -0
  212. package/lib/core/tools/path-args.d.ts +4 -0
  213. package/lib/core/tools/path-args.js +22 -0
  214. package/lib/core/tools/search-tools.d.ts +30 -0
  215. package/lib/core/tools/search-tools.js +321 -34
  216. package/lib/core/tools.d.ts +82 -0
  217. package/lib/core/tools.js +21 -0
  218. package/lib/core/transcript-text.d.ts +19 -0
  219. package/lib/core/transcript-text.js +44 -0
  220. package/lib/core/ui-boot-source.d.ts +5 -0
  221. package/lib/core/ui-boot-source.js +10 -3
  222. package/lib/core/ui-bundles.d.ts +80 -6
  223. package/lib/core/ui-bundles.js +700 -76
  224. package/lib/core/ui-events.d.ts +10 -0
  225. package/lib/core/ui-events.js +25 -0
  226. package/lib/core/ui-methods.d.ts +1 -1
  227. package/lib/core/ui-methods.js +42 -13
  228. package/lib/core/ui-route.js +11 -7
  229. package/lib/core/ui-server.d.ts +6 -0
  230. package/lib/core/ui-server.js +106 -1
  231. package/lib/core/unified-diff.d.ts +35 -0
  232. package/lib/core/unified-diff.js +86 -0
  233. package/lib/core/usage-log.js +39 -0
  234. package/lib/core/web-http.d.ts +1 -1
  235. package/lib/core/web-http.js +1 -3
  236. package/lib/host/kernel.js +57 -41
  237. package/lib/plugins/agent.js +101 -20
  238. package/lib/plugins/approval-floor.js +12 -8
  239. package/lib/plugins/approval.js +252 -80
  240. package/lib/plugins/ask.js +60 -8
  241. package/lib/plugins/browser.js +32 -84
  242. package/lib/plugins/commands.js +167 -57
  243. package/lib/plugins/compact.d.ts +2 -2
  244. package/lib/plugins/compact.js +200 -30
  245. package/lib/plugins/computer-use.js +34 -18
  246. package/lib/plugins/dock-browser.js +24 -65
  247. package/lib/plugins/dsh-compat.js +7 -0
  248. package/lib/plugins/file-review.js +59 -15
  249. package/lib/plugins/git.js +16 -8
  250. package/lib/plugins/goal.js +9 -8
  251. package/lib/plugins/hooks.js +4 -2
  252. package/lib/plugins/host-stdio.js +14 -16
  253. package/lib/plugins/lifecycle-hooks.d.ts +5 -4
  254. package/lib/plugins/lifecycle-hooks.js +12 -10
  255. package/lib/plugins/llm.js +74 -33
  256. package/lib/plugins/lsp.js +22 -27
  257. package/lib/plugins/mcp.js +16 -17
  258. package/lib/plugins/memory.js +3 -24
  259. package/lib/plugins/microcompact.d.ts +4 -1
  260. package/lib/plugins/microcompact.js +117 -19
  261. package/lib/plugins/mode.js +30 -11
  262. package/lib/plugins/permission-presets.d.ts +2 -1
  263. package/lib/plugins/permission-presets.js +55 -35
  264. package/lib/plugins/plugin-manager.js +4 -6
  265. package/lib/plugins/presets.js +56 -27
  266. package/lib/plugins/prompt.js +54 -11
  267. package/lib/plugins/ptc.d.ts +13 -0
  268. package/lib/plugins/ptc.js +121 -24
  269. package/lib/plugins/remote/types.d.ts +1 -1
  270. package/lib/plugins/remote/types.js +11 -0
  271. package/lib/plugins/remote.js +14 -15
  272. package/lib/plugins/runtime.js +91 -14
  273. package/lib/plugins/sandbox.js +181 -60
  274. package/lib/plugins/schedule.js +12 -11
  275. package/lib/plugins/self-improve.js +28 -18
  276. package/lib/plugins/session-search.js +18 -13
  277. package/lib/plugins/session-title.js +1 -1
  278. package/lib/plugins/session.js +103 -25
  279. package/lib/plugins/settings.js +16 -40
  280. package/lib/plugins/skills.js +18 -1
  281. package/lib/plugins/spill.js +18 -11
  282. package/lib/plugins/subagent.js +208 -42
  283. package/lib/plugins/team.js +11 -5
  284. package/lib/plugins/todo.d.ts +1 -1
  285. package/lib/plugins/todo.js +25 -19
  286. package/lib/plugins/tool-search.js +47 -28
  287. package/lib/plugins/tools-default.js +89 -5
  288. package/lib/plugins/tools.js +3 -3
  289. package/lib/plugins/transcript.js +116 -9
  290. package/lib/plugins/web-search.d.ts +1 -1
  291. package/lib/plugins/web-search.js +25 -16
  292. package/lib/plugins/webserver.js +40 -7
  293. package/lib/remote/assets/app-B3Id1EBq.js +14 -0
  294. package/lib/remote/assets/index.html +2 -2
  295. package/lib/remote/assets/{style-DIB6729x.css → style-NtlpbKOI.css} +1 -1
  296. package/lib/services/types.d.ts +247 -29
  297. package/lib/tools/plugin-cli.d.ts +1 -0
  298. package/lib/tools/plugin-cli.js +209 -0
  299. package/lib/ui/assets/app-B-Jx5dnh.js +90 -0
  300. package/lib/ui/assets/{chunk-BajyYBss.js → chunk-Bfdlo8Me.js} +1 -1
  301. package/lib/ui/assets/chunk-DGX-i4eb.js +12 -0
  302. package/lib/ui/assets/index.html +62 -14
  303. package/lib/ui/assets/style-WzxwEPaE.css +1 -0
  304. package/lib/ui/frames.js +1 -3
  305. package/lib/ui/index.d.ts +30 -1
  306. package/lib/ui/index.js +29 -0
  307. package/lib/ui/manifest.d.ts +24 -6
  308. package/lib/ui/manifest.js +3 -2
  309. package/lib/ui/plugins/actions/bundle.json +8 -0
  310. package/lib/ui/plugins/actions/client.js +43 -0
  311. package/lib/ui/plugins/ask/bundle.json +8 -0
  312. package/lib/ui/plugins/ask/client.js +415 -0
  313. package/lib/ui/plugins/browser/bundle.json +8 -0
  314. package/lib/ui/plugins/composer/bundle.json +9 -0
  315. package/lib/ui/plugins/composer/client.js +1806 -1087
  316. package/lib/ui/plugins/files/bundle.json +8 -0
  317. package/lib/ui/plugins/files/client.js +13 -98
  318. package/lib/ui/plugins/manifest.json +1 -104
  319. package/lib/ui/plugins/palette/bundle.json +8 -0
  320. package/lib/ui/plugins/palette/client.js +360 -0
  321. package/lib/ui/plugins/plugins/bundle.json +8 -0
  322. package/lib/ui/plugins/plugins/client.js +116 -38
  323. package/lib/ui/plugins/preview/bundle.json +8 -0
  324. package/lib/ui/plugins/preview/client.js +6 -16
  325. package/lib/ui/plugins/prompt/bundle.json +8 -0
  326. package/lib/ui/plugins/prompt/client.js +81 -47
  327. package/lib/ui/plugins/sessions/bundle.json +8 -0
  328. package/lib/ui/plugins/sessions/client.js +157 -111
  329. package/lib/ui/plugins/settings/bundle.json +8 -0
  330. package/lib/ui/plugins/settings/client.js +184 -170
  331. package/lib/ui/plugins/skills/bundle.json +8 -0
  332. package/lib/ui/plugins/skills/client.js +161 -79
  333. package/lib/ui/plugins/status/bundle.json +8 -0
  334. package/lib/ui/plugins/status/client.js +165 -26
  335. package/lib/ui/plugins/statusbar/bundle.json +9 -0
  336. package/lib/ui/plugins/statusbar/client.js +100 -144
  337. package/lib/ui/plugins/tasks/bundle.json +8 -0
  338. package/lib/ui/plugins/team/bundle.json +8 -0
  339. package/lib/ui/plugins/team/client.js +60 -58
  340. package/lib/ui/plugins/terminal/bundle.json +8 -0
  341. package/lib/ui/plugins/terminal/client.js +1 -7
  342. package/lib/ui/plugins/trace/bundle.json +11 -0
  343. package/lib/ui/plugins/trace/client.js +86 -179
  344. package/lib/ui/plugins/transcript/bundle.json +8 -0
  345. package/lib/ui/plugins/transcript/client.js +1608 -1243
  346. package/lib/ui/sdk/@dsc/ui/index.d.ts +54 -16
  347. package/lib/ui/sdk/@dsc/ui/package.json +1 -1
  348. package/lib/ui/sdk/@dsc/ui-core/contract.d.ts +20 -1968
  349. package/lib/ui/sdk/@dsc/ui-core/core/attachments.d.ts +185 -0
  350. package/lib/ui/sdk/@dsc/ui-core/core/bytes.d.ts +14 -0
  351. package/lib/ui/sdk/@dsc/ui-core/core/err-text.d.ts +18 -0
  352. package/lib/ui/sdk/@dsc/ui-core/core/git-surface.d.ts +17 -0
  353. package/lib/ui/sdk/@dsc/ui-core/core/json-text.d.ts +11 -0
  354. package/lib/ui/sdk/@dsc/ui-core/core/path-policy.d.ts +44 -0
  355. package/lib/ui/sdk/@dsc/ui-core/core/records.d.ts +16 -0
  356. package/lib/ui/sdk/@dsc/ui-core/core/throughput.d.ts +46 -0
  357. package/lib/ui/sdk/@dsc/ui-core/core/token-estimate.d.ts +18 -2
  358. package/lib/ui/sdk/@dsc/ui-core/core/unified-diff.d.ts +35 -0
  359. package/lib/ui/sdk/@dsc/ui-core/package.json +1 -1
  360. package/lib/ui/sdk/@dsc/ui-core/ui/index.d.ts +30 -1
  361. package/lib/ui/sdk/@dsc/ui-core/ui/manifest.d.ts +24 -6
  362. package/lib/ui/sdk/@dsc/ui-core/ui/services.d.ts +19 -8
  363. package/lib/ui/sdk/@dsc/ui-core/ui/signal.d.ts +49 -0
  364. package/lib/ui/sdk/@dsc/ui-dockkit/dock-model.d.ts +17 -3
  365. package/lib/ui/sdk/@dsc/ui-dockkit/dock-state.d.ts +1 -1
  366. package/lib/ui/sdk/@dsc/ui-dockkit/package.json +1 -1
  367. package/lib/ui/sdk/@dsc/ui-layout/app.d.ts +4 -0
  368. package/lib/ui/sdk/@dsc/ui-layout/appearance.d.ts +6 -1
  369. package/lib/ui/sdk/@dsc/ui-layout/host-channel.d.ts +21 -0
  370. package/lib/ui/sdk/@dsc/ui-layout/index.d.ts +1 -0
  371. package/lib/ui/sdk/@dsc/ui-layout/package.json +1 -1
  372. package/lib/ui/sdk/@dsc/ui-layout/page-state.d.ts +1 -1
  373. package/lib/ui/sdk/@dsc/ui-layout/runtime-context.d.ts +10 -1
  374. package/lib/ui/sdk/@dsc/ui-layout/thread-view.d.ts +1 -1
  375. package/lib/ui/sdk/@dsc/ui-layout/usage-today.d.ts +11 -0
  376. package/lib/ui/sdk/@dsc/ui-primitives/dialog-focus.d.ts +30 -0
  377. package/lib/ui/sdk/@dsc/ui-primitives/error-text.d.ts +12 -0
  378. package/lib/ui/sdk/@dsc/ui-primitives/git-surface.d.ts +9 -0
  379. package/lib/ui/sdk/@dsc/ui-primitives/highlight.d.ts +23 -0
  380. package/lib/ui/sdk/@dsc/ui-primitives/humanize-error.d.ts +35 -0
  381. package/lib/ui/sdk/@dsc/ui-primitives/icons-workspace.d.ts +33 -0
  382. package/lib/ui/sdk/@dsc/ui-primitives/icons.d.ts +21 -3
  383. package/lib/ui/sdk/@dsc/ui-primitives/image-lightbox.d.ts +21 -0
  384. package/lib/ui/sdk/@dsc/ui-primitives/index.d.ts +16 -0
  385. package/lib/ui/sdk/@dsc/ui-primitives/markdown.d.ts +10 -14
  386. package/lib/ui/sdk/@dsc/ui-primitives/package.json +1 -1
  387. package/lib/ui/sdk/@dsc/ui-primitives/panels.d.ts +31 -8
  388. package/lib/ui/sdk/@dsc/ui-primitives/paths.d.ts +2 -0
  389. package/lib/ui/sdk/@dsc/ui-primitives/review-findings-card.d.ts +25 -0
  390. package/lib/ui/sdk/@dsc/ui-primitives/review-findings.d.ts +64 -0
  391. package/lib/ui/sdk/@dsc/ui-primitives/review-notice-card.d.ts +27 -0
  392. package/lib/ui/sdk/@dsc/ui-primitives/review-notice.d.ts +80 -0
  393. package/lib/ui/sdk/@dsc/ui-primitives/signal.d.ts +9 -0
  394. package/lib/ui/sdk/@dsc/ui-primitives/sizes.d.ts +15 -0
  395. package/lib/ui/sdk/@dsc/ui-primitives/skeleton.d.ts +39 -0
  396. package/lib/ui/sdk/@dsc/ui-primitives/snapshot.d.ts +46 -0
  397. package/lib/ui/sdk/@dsc/ui-primitives/thread-resizer.d.ts +3 -3
  398. package/lib/ui/sdk/@dsc/ui-primitives/throughput.d.ts +13 -0
  399. package/lib/ui/sdk/@dsc/ui-primitives/tokens.d.ts +9 -0
  400. package/lib/ui/sdk/@dsc/ui-primitives/tool-args.d.ts +1 -1
  401. package/lib/ui/sdk/@dsc/ui-primitives/tool-summary.d.ts +30 -6
  402. package/lib/ui/sdk/@dsc/ui-primitives/unified-diff.d.ts +10 -0
  403. package/lib/ui/sdk/@dsc/ui-renderer/boot.d.ts +10 -1
  404. package/lib/ui/sdk/@dsc/ui-renderer/cordis-host.d.ts +113 -0
  405. package/lib/ui/sdk/@dsc/ui-renderer/package.json +1 -1
  406. package/lib/ui/sdk/@dsc/ui-slots/package.json +1 -1
  407. package/lib/ui/services.d.ts +19 -8
  408. package/lib/ui/services.js +20 -12
  409. package/lib/ui/signal.d.ts +49 -0
  410. package/lib/ui/signal.js +57 -0
  411. package/lib/ui/tui-plugins.js +36 -16
  412. package/package.json +71 -58
  413. package/lib/remote/assets/app-DAcUCOEn.js +0 -14
  414. package/lib/ui/assets/app-B70nVIKd.js +0 -69
  415. package/lib/ui/assets/chunk-BGcgwlCI.js +0 -12
  416. package/lib/ui/assets/style-Bq01xH_b.css +0 -1
@@ -0,0 +1,185 @@
1
+ /**
2
+ * 附件仓库:把用户贴进来的图片、视频与其它文件存成本机对象,消息里只留引用。
3
+ *
4
+ * ## 为什么不再往消息里塞 base64
5
+ *
6
+ * 原来界面把图片压成 data URL,经 `/api/invoke` 的 64KB 请求体塞进 `submit` 的第二参
7
+ * (`core/web-http.ts` 的 `MAX_BODY_BYTES`),所以单图只能有 32KB——普通截图压到那个
8
+ * 档位已经看不清了(这正是「贴图这一版还不支持」的根因)。会话 jsonl 也把 base64 原样
9
+ * 写进去,一个会话文件会膨胀到几十 MB。
10
+ *
11
+ * 现在照 dsh `dsh-attachment-local` 的做法拆成两步:
12
+ *
13
+ * 1. 字节先经 `POST /api/attachments` 落到这里,内容寻址(sha256),同字节只存一份;
14
+ * 2. 消息里带引用 `/api/attachments/<sha>`,**组装模型请求时**再读成 data URL。
15
+ *
16
+ * 于是请求体只装几个短引用,会话日志也只记引用;界面 `<img>` / `<video>` 直接吃同源
17
+ * 路由,不必再传 base64。
18
+ *
19
+ * ## 与 dsh 的口径对齐与差异
20
+ *
21
+ * 对齐:目录形状 `<DSC_HOME>/attachments/v1/objects/<sha 前 2 位>/<sha>`、内容寻址去重、
22
+ * 只收 PNG / JPEG / WebP / GIF 四类图片、非图片文件按字节原样存、单图 20MiB。
23
+ *
24
+ * 差异:dsh 在服务端用 sharp 做像素级规范化(EXIF、色彩空间、长边、质量阶梯)。本仓库
25
+ * 没有原生图像依赖,**规范化放在界面层**(`ui-shell/src/plugins/composer/attachments.ts`
26
+ * 用 canvas 做同样的事),落到这里的已经是 8-bit sRGB 光栅。所以这里的校验只看字节与
27
+ * 魔数:信不信扩展名/`Content-Type` 一律不信。
28
+ *
29
+ * ## 安全边界
30
+ *
31
+ * - sha 只认 64 位小写十六进制,路径拼接不接用户输入;
32
+ * - 文件名只用于展示,落盘名永远是 sha;
33
+ * - 单文件上限按类别分开(图片 20MiB、视频与其它文件 200MiB),上限在**写入过程中**
34
+ * 就生效,不会先写满盘再判;
35
+ * - 读取前校验对象仍是普通文件,长度与摘要由调用方(会话投影)自行决定要不要复核。
36
+ *
37
+ * @module dsc/core/attachments
38
+ */
39
+ import type { IncomingMessage } from 'node:http';
40
+ /** 单张图片上限(与 dsh `maxImageBytes` 的默认值一致)。 */
41
+ export declare const MAX_IMAGE_BYTES: number;
42
+ /** 单个视频 / 其它文件上限。比 dsh 的「通用文件不设限」保守,理由是本机磁盘不是仓库。 */
43
+ export declare const MAX_MEDIA_BYTES: number;
44
+ /** 一条消息最多带多少张图片(dsh 默认 20;这里按请求体与上下文成本收到 20)。 */
45
+ export declare const MAX_IMAGES_PER_MESSAGE = 20;
46
+ /** 附件类别:图片进模型请求的 image 块,视频与文件以「路径 + 元数据」交给模型。 */
47
+ export type AttachmentKind = 'image' | 'video' | 'file';
48
+ /** 一次落盘的结果:会话与界面只认这份元数据。 */
49
+ export interface AttachmentMeta {
50
+ /** sha256 十六进制(64 位小写)。 */
51
+ sha: string;
52
+ kind: AttachmentKind;
53
+ /** 用户看到的原始文件名(已安全化,仅用于展示)。 */
54
+ name: string;
55
+ /** 实际类型(按魔数判定,不信扩展名)。 */
56
+ mime: string;
57
+ /** 字节数。 */
58
+ bytes: number;
59
+ /** 同源读取地址(可直接塞进 `<img src>` / `<video src>`)。 */
60
+ url: string;
61
+ /** 本机绝对路径:交给模型用工具读,或给桌面端做原生播放。 */
62
+ path: string;
63
+ }
64
+ /** 会话与界面之间传的文件引用(视频 / 通用文件,图片走 `images` 那一列)。 */
65
+ export interface UserFileAttachment {
66
+ sha: string;
67
+ kind: 'video' | 'file';
68
+ name: string;
69
+ mime: string;
70
+ bytes: number;
71
+ path: string;
72
+ url?: string;
73
+ /**
74
+ * 视频抽出来的关键帧(已上传成图片附件的引用)。
75
+ *
76
+ * 与 `url` 一样只给请求投影用:模型看到这些图,界面只画一张视频卡——帧是「怎么让模型
77
+ * 看见视频」的手段,不是用户要多看六张图。日志里存引用,重放时照样能还原。
78
+ */
79
+ frames?: string[];
80
+ }
81
+ /** 落盘失败(上限 / 空文件 / 写盘错误)。 */
82
+ export declare class AttachmentError extends Error {
83
+ constructor(message: string);
84
+ }
85
+ /** 文件头魔数 sniff 的结果。 */
86
+ export interface SniffedMedia {
87
+ kind: AttachmentKind;
88
+ mime: string;
89
+ }
90
+ /**
91
+ * 按文件头认类型。
92
+ *
93
+ * 只认常见、能给模型或播放器直接用的格式;认不出的按 `file` 原样存(模型拿路径自己看)。
94
+ * 图片四类与 dsh 一致:PNG / JPEG / WebP / GIF。
95
+ */
96
+ export declare function sniffMedia(head: Buffer): SniffedMedia;
97
+ /** 按魔数结果判断一个对象是不是可渲染图片。 */
98
+ export declare function isImageMime(mime: string): boolean;
99
+ /** 类别对应的单文件上限。 */
100
+ export declare function limitFor(kind: AttachmentKind): number;
101
+ /** 把原始文件名洗成可展示的一段(只展示,不参与落盘路径)。 */
102
+ export declare function displayName(raw: string): string;
103
+ /** 附件在界面通道里的读取地址。 */
104
+ export declare function attachmentUrl(sha: string, name?: string): string;
105
+ /** 从任意字符串里认出附件引用;不是引用就回 null。 */
106
+ export declare function parseAttachmentUrl(value: string): string | null;
107
+ /** 造仓库时要给的东西(自检换成临时目录)。 */
108
+ export interface AttachmentStoreOptions {
109
+ /** 根目录,缺省 `<DSC_HOME>/attachments/v1`。 */
110
+ root?: string;
111
+ }
112
+ /**
113
+ * 内容寻址附件仓库。
114
+ *
115
+ * 目录形状:`<root>/objects/<sha 前两位>/<sha>`,临时文件在 `<root>/tmp/`。
116
+ * 同一个字节序列落两次是同一个对象(第二次直接复用,不重写)。
117
+ */
118
+ export declare class AttachmentStore {
119
+ private readonly root;
120
+ constructor(options?: AttachmentStoreOptions);
121
+ /** 仓库根目录。 */
122
+ get dir(): string;
123
+ /** 对象的绝对路径(只接受合法 sha,别的一律抛)。 */
124
+ pathOf(sha: string): string;
125
+ /** 对象是否已经在仓库里。 */
126
+ has(sha: string): boolean;
127
+ /** 落盘一段已知字节(浏览器上传的小文件、自检都走这条)。 */
128
+ save(name: string, bytes: Buffer): AttachmentMeta;
129
+ /**
130
+ * 把一条 HTTP 请求体流式落盘。
131
+ *
132
+ * 为什么要流式:视频动辄几十 MB,先 `readBodyBytes` 攒进内存会顶出一整份缓冲。
133
+ * 边写边算 sha,超限时立刻停写并删临时文件,客户端拿到 413。
134
+ */
135
+ saveStream(req: IncomingMessage, name: string): Promise<AttachmentMeta>;
136
+ /** 读整段字节(组装模型请求时用;只给图片,视频不走这条)。 */
137
+ read(sha: string): Buffer;
138
+ /** 对象的字节数与修改时间;对象不存在时回 null。 */
139
+ stat(sha: string): {
140
+ size: number;
141
+ mtimeMs: number;
142
+ } | null;
143
+ /** 给 HTTP 路由用的类型判定:只读文件头。 */
144
+ mimeOf(sha: string): Promise<{
145
+ mime: string;
146
+ size: number;
147
+ } | null>;
148
+ /** 元数据组装(路径与 url 一处生成,避免两边漂移)。 */
149
+ private meta;
150
+ /** 把临时文件发布成正式对象:临时文件与目标同盘,改名是原子的。 */
151
+ private publish;
152
+ }
153
+ /** 取(首次创建)默认仓库。 */
154
+ export declare function attachmentStore(): AttachmentStore;
155
+ /** 自检替换默认仓库(只给测试脚本用)。 */
156
+ export declare function setAttachmentStoreForTest(store: AttachmentStore | null): void;
157
+ /**
158
+ * 把一条图片引用读成 data URL(组装模型请求时用)。
159
+ *
160
+ * - `data:` 开头的老写法原样返回(老会话兼容);
161
+ * - `/api/attachments/<sha>` 读成 base64;文件不在了就抛错,让这一轮明确失败,
162
+ * 而不是把一条坏链接发给端点;
163
+ * - 其它字符串(远端 http 图)原样返回。
164
+ */
165
+ export declare function resolveImageForRequest(url: string): string;
166
+ /**
167
+ * 文件类附件给模型看的那一段文字。
168
+ *
169
+ * 形状照 dsh 的文件句柄:一行说清「是什么、多大、摘要前缀、在哪」。模型拿到路径后
170
+ * 用文件工具自己读(视频自己没有解码能力的端点也读不懂,所以这里不承诺「能看画面」)。
171
+ */
172
+ export declare function fileHandleText(files: readonly UserFileAttachment[]): string;
173
+ /** 按扩展名给一个「像不像图片」的提示(只用于界面提前选路,不参与安全判断)。 */
174
+ export declare function looksLikeImage(name: string): boolean;
175
+ /** 按扩展名给一个「像不像视频」的提示(同上)。 */
176
+ export declare function looksLikeVideo(name: string): boolean;
177
+ /**
178
+ * 校验并洗白「页面传来的文件引用」。
179
+ *
180
+ * 为什么必须在入口洗:界面通道的实参来自网络,页面(含第三方插件)可以编任意
181
+ * `path`——把 `C:\Users\…\credentials.yaml` 塞进来,宿主就会把那条路径写进模型
182
+ * 看得到的句柄里,等于把「模型可读范围」交给页面决定。所以路径一律不信:只认
183
+ * 仓库按 sha 算出来的那一条;其它字段只做类型与长度收口。
184
+ */
185
+ export declare function sanitizeFileRefs(value: unknown): UserFileAttachment[];
@@ -0,0 +1,14 @@
1
+ /**
2
+ * 字节数的人话读法(宿主侧唯一一份)。
3
+ *
4
+ * 同一件事此前散在五处,差异只在单位、标点与小数位:附件的「512 B」、暂存清理的
5
+ * 「1536 字节」、输入区附件的「1.2 MB」(把 `.0` 抹掉了)、对话流附件行自己又抄的一份、
6
+ * 文件树的「512B」(没有空格)。合并成两份:宿主这一份,与壳里 `ui-primitives/sizes.ts`
7
+ * 的同名函数——**层级上两边不许互相 import**(壳只经 `@dsc/ui*` 拿宿主的类型,不拿运行期
8
+ * 实现),所以各存一份实现,由 `scripts/ui-bytes-test.mjs` 逐字比对两份函数体,漂了要红。
9
+ *
10
+ * @module dsc/core/bytes
11
+ */
12
+ /** 1024 进制(KB / MB / GB):不到 1KB 给整数 B,一位小数但抹掉 `.0`,两位数以上取整;
13
+ * 非有限数或负数给破折号(界面上不显示 NaN)。 */
14
+ export declare function formatBytes(bytes: number): string;
@@ -0,0 +1,18 @@
1
+ /**
2
+ * error → 文案(全仓库唯一一份)。
3
+ *
4
+ * 为什么在 core 单独放这么小的一个模块:这句话此前抄了五份(adapter/transcript、
5
+ * core/loop、core/market、core/plugin-loader、渲染层 SettingsModal 各一份)。内核层
6
+ * 不能反向 import adapter,渲染层只能 import 纯 core 模块——放 core 两头都够得着
7
+ * (渲染层照 diff-text 的先例经 `@dsc/runtime/err-text.js` 取用;adapter/transcript
8
+ * 保留同名 re-export,既有 18 处 import 不断)。
9
+ *
10
+ * 2026-10-28 第三批复审:另有十处把它叫成 `errorText` 各写一遍(core/mcp、core 的
11
+ * sandbox/win 四份、core/remote 两份、core/schedule/store、plugins/lsp、plugins/mcp)。
12
+ * 那些地方已改成 `import { errText as errorText }`——名字留着是为了不动调用点,
13
+ * 实现只能有这一份。
14
+ *
15
+ * @module dsc/core/err-text
16
+ */
17
+ /** 把抛出来的东西压成一句话(Error 取 message,其余 String 化)。 */
18
+ export declare function errText(error: unknown): string;
@@ -0,0 +1,17 @@
1
+ /**
2
+ * 工作区 git 读数的相等判断(全仓库唯一一份)。
3
+ *
4
+ * 同一份读数有两个地方要「比一比」:
5
+ * - 宿主侧 `plugins/git.ts`:读数没变就别推帧(干净仓库每 30 秒白推一帧是纯浪费);
6
+ * - 界面侧 `composer/ui.tsx`:读数没变就别重画输入区底栏。
7
+ * 两处原先各写一份四字段比较。它们**必须**同口径:一边认为变了、另一边认为没变,
8
+ * 界面就会停在旧分支名上且再也不刷新——这类 bug 只在分支切换时出现,最难查。
9
+ *
10
+ * 只比 `GitSurface` 这四个字段(repo / branch / detached / dirtyFileCount)。
11
+ * 状态栏那份 `GitSummary`(branch / added / removed / files)是另一种读数,不在这里合并。
12
+ *
13
+ * @module dsc/core/git-surface
14
+ */
15
+ import type { GitSurface } from '../contract.js';
16
+ /** 两份读数是不是同一份(四个字段逐个比,比让界面每帧重画便宜)。 */
17
+ export declare function sameGitSurface(left: GitSurface, right: GitSurface): boolean;
@@ -0,0 +1,11 @@
1
+ /**
2
+ * 安全序列化(全仓库唯一一份)。
3
+ *
4
+ * `JSON.stringify` 遇到循环引用、BigInt、函数会抛;这条路上抛出来会连累整个
5
+ * 界面帧或原生命令的应答。两处(原生桥、界面方法)此前各包了一个 try/catch,
6
+ * 合并到这里,口径固定成「序列化不了就 null」。
7
+ *
8
+ * @module dsc/core/json-text
9
+ */
10
+ /** 一段 JSON 文本;序列化不了(循环引用、BigInt、函数)给 null。 */
11
+ export declare function jsonText(value: unknown): string | null;
@@ -0,0 +1,44 @@
1
+ /** dsc 自己的配置目录(config.yaml / credentials.yaml 住这里)。 */
2
+ export declare const DSC_HOME: string;
3
+ /** dsc 自有存储下的绝对路径(config、会话、用量、插件……隔离测试与迁移的单一坐标)。 */
4
+ export declare function dscPath(...parts: string[]): string;
5
+ /** `.env.xxx` 这一族(.env.production、.env.staging…)也拒读,只放行 .env.example。 */
6
+ export declare function isEnvFamily(name: string): boolean;
7
+ /** 判定结果:null = 允许;字符串 = 拒绝原因(会原样进工具结果,模型看得见)。 */
8
+ export type PathVerdict = string | null;
9
+ /** 目标是不是在工作目录内(跟着 symlink 判,堵住「建个软链指到工作区外」这条路)。 */
10
+ export declare function isInsideCwd(cwd: string, target: string): boolean;
11
+ /** 读这个路径要不要拒。 */
12
+ export declare function readBlockReason(target: string): PathVerdict;
13
+ /** 写这个路径要不要硬拒(硬拒 = 任何模式都不放行,包括审批)。 */
14
+ export declare function writeHardBlockReason(target: string): PathVerdict;
15
+ /**
16
+ * 这个写操作是不是「说明书」类改动(永远要弹一次卡,不受权限模式影响)。
17
+ *
18
+ * 字面路径与真实路径各判一次:软链/junction 指到 dsc 的配置文件时,只判字面路径会漏。
19
+ */
20
+ export declare function isProtectedInstruction(target: string, cwd: string): PathVerdict;
21
+ /** 记录一次读取(read 工具执行后调用),带上当时的修改时间。按会话记账(0.6.48)。 */
22
+ export declare function noteRead(target: string, sessionId: string): void;
23
+ /** 记录一次写入(write/edit 成功后调用),免得刚写完的文件被自己拦成「已变」。 */
24
+ export declare function noteWrite(target: string, sessionId: string): void;
25
+ /**
26
+ * 整写覆盖前的检查:没读过 / 读之后文件又变了,都不许整写。
27
+ * 只针对已存在的文件;新建文件直接放行。
28
+ */
29
+ export declare function staleOverwriteReason(target: string, sessionId: string): PathVerdict;
30
+ /**
31
+ * edit 定点替换前的检查(T35):只拦「模型读过、之后又被第三方改过」这一半——
32
+ * edit 自己会现读盘上现值,没读过的文件也允许直接改(这是它与整写覆盖的语义差别)。
33
+ */
34
+ export declare function staleEditReason(target: string, sessionId: string): PathVerdict;
35
+ /** 清掉某个会话的读取台账(agent 收摊时调用,防长会话窗口里台账无界增长)。 */
36
+ export declare function clearReadLedger(sessionId: string): void;
37
+ /** `~` 开头展开成用户目录;其余原样返回(相对路径交给后续文件操作按 cwd 解析)。
38
+ *
39
+ * 为什么放这里:此前 `core/spill.ts` 与 `core/lifecycle-hooks.ts` 各写了一份逐字相同的
40
+ * `expandHome` / `expandPath`,而「用户写的路径怎么解释」本来就是本模块的事。
41
+ */
42
+ export declare function expandHome(text: string): string;
43
+ /** 主目录(测试与提示词用)。 */
44
+ export declare function userHome(): string;
@@ -0,0 +1,16 @@
1
+ /**
2
+ * 「这是不是一个普通对象」的判定(全仓库唯一一份)。
3
+ *
4
+ * 为什么单独放一个模块:`asRecord` / `isRecord` 这对判断此前在 core/mcp、plugins/mcp、
5
+ * ui/frames、core/lsp/normalize、core/lifecycle-hooks、core/remote/push、core/web-http
6
+ * 各写一遍,写法一样、注释各说各话,改一处口径(比如要不要排除数组)得靠人肉搜。
7
+ *
8
+ * 两个名字是同一件事的两种用法:返回对象的用于取值(取不到就 null),返回布尔的用于
9
+ * 类型守卫(if 之后 TS 自动收窄)。
10
+ *
11
+ * @module dsc/core/records
12
+ */
13
+ /** 认得出是个普通对象就返回它,否则 null。 */
14
+ export declare function asRecord(value: unknown): Record<string, unknown> | null;
15
+ /** 类型守卫版:认得出是个普通对象就 true。 */
16
+ export declare function isRecord(value: unknown): value is Record<string, unknown>;
@@ -0,0 +1,46 @@
1
+ /**
2
+ * 输出速度(tok/s)与首字延迟的口径:唯一原件,界面与测试都从这里取。
3
+ *
4
+ * 算法照 dsh 的 sessionStats 投影(packages/session/session-stats/src/projection.ts:130-170):
5
+ * - 首字延迟 = 每次请求「发出 → 第一口输出」的墙钟,只在真拿到第一口的请求上累计;
6
+ * - 分子分母**成对**取:同一次请求既要有第一口输出的时刻、又要有服务端上报的输出 token,
7
+ * 才同时算进 decodeTokens 与 decodeMs——不能拿一部分请求的时间去除另一部分请求的 token;
8
+ * - 分母是**纯解码时间**(第一口输出 → 定稿),首字等待、工具执行、等下一个请求的空转
9
+ * 都不在里面;整个会话累计,不是「本轮」。
10
+ *
11
+ * 为什么单开一个文件:桌面状态栏、终端界面、测试必须同口径,谁也不许自己再写一遍除法。
12
+ * 渲染层经 `@dsc/runtime/core/throughput.js` 转出口取用(desktop/src/renderer/token-estimate.ts)。
13
+ *
14
+ * @module dsc/core/throughput
15
+ */
16
+ /**
17
+ * 一次会话(或一次测量窗口)的墙钟累计与样本数。
18
+ *
19
+ * 全部只累计「有真值」的那部分:缺样本的请求不占分子也不占分母(宁缺不假)。
20
+ */
21
+ export interface ThroughputTotals {
22
+ /** 首字延迟的样本数:拿到第一口输出的请求数。 */
23
+ ttftSteps: number;
24
+ /** 这些请求「发出 → 第一口输出」的累计毫秒。 */
25
+ ttftMs: number;
26
+ /** 已定稿请求「发出 → 定稿」的累计毫秒(含内部重试与首字等待)。 */
27
+ llmMs: number;
28
+ /** 解码期的累计毫秒(第一口输出 → 定稿),分母样本与 decodeTokens 同一批请求。 */
29
+ decodeMs: number;
30
+ /** 与 decodeMs 同一批请求的服务端输出 token 之和。 */
31
+ decodeTokens: number;
32
+ }
33
+ /**
34
+ * 输出速度(token/秒):整个会话累计,除以纯解码时间。
35
+ *
36
+ * 解码期为 0(老日志没记时刻、或这一会话还没请求定稿)时返回 null——
37
+ * 界面据此整段省略,绝不去除一个 0 印出天文数字。
38
+ */
39
+ export declare function tokensPerSecond(totals: Pick<ThroughputTotals, 'decodeMs' | 'decodeTokens'>): number | null;
40
+ /** 首字延迟平均(毫秒):没有样本时返回 null,界面据此省略这一行。 */
41
+ export declare function averageTtftMs(totals: Pick<ThroughputTotals, 'ttftMs' | 'ttftSteps'>): number | null;
42
+ /**
43
+ * 速度读数格式(对照 dsh 的 formatTokensPerSecond):
44
+ * 10 以上给整数,10 以下给一位小数——8.4 / 12,不写 8.40 / 11.7。
45
+ */
46
+ export declare function formatTokensPerSecond(tps: number): string;
@@ -32,13 +32,22 @@ export interface SegmentMessage {
32
32
  };
33
33
  }[];
34
34
  }
35
- /** 请求按内容类型的 token 估算分段(context 进度条占用段的组成,dsh 同款五段)。 */
35
+ /** 请求按内容类型的 token 估算分段(context 进度条占用段的组成)。 */
36
36
  export interface RequestSegments {
37
37
  system: number;
38
38
  prompt: number;
39
39
  assistant: number;
40
40
  thinking: number;
41
+ /**
42
+ * 工具**结果**(tool 消息的正文)。
43
+ *
44
+ * 名字容易误解(2026-10-30 追查):它不是工具定义,是模型读完工具输出之后留在历史里的
45
+ * 那一段。以前界面把这一段标成「工具定义」,用户看到 41.8K 以为工具描述太肥,实际是
46
+ * 62 条 run_code 的返回原文。工具定义见下面的 {@link RequestSegments.schema}。
47
+ */
41
48
  tools: number;
49
+ /** 工具**定义**(每次请求随 requests 一起发出去的 schema 文本;也算输入 token)。 */
50
+ schema: number;
42
51
  }
43
52
  /** 全零分段(新会话 / 尚无请求记录)。 */
44
53
  export declare function emptySegments(): RequestSegments;
@@ -52,4 +61,11 @@ export declare function emptySegments(): RequestSegments;
52
61
  * 这些零头体现在权威读数(真实 prompt_tokens)与分段之和的差上,界面只拿分段画颜色,
53
62
  * 读数永远用服务端数字。
54
63
  */
55
- export declare function estimateRequestSegments(messages: readonly SegmentMessage[]): RequestSegments;
64
+ export declare function estimateRequestSegments(messages: readonly SegmentMessage[],
65
+ /**
66
+ * 这次请求携带的工具定义(已序列化的 schema 文本)。空串 = 不发工具(压缩摘要调用那种)。
67
+ *
68
+ * 为什么单独一项(2026-10-30):工具定义同样占输入 token、同样被每次都发一遍,但以前
69
+ * 完全没进分段——界面把「工具结果」标成「工具定义」,真·定义反而一分钱都不显示。
70
+ */
71
+ toolSchema?: string): RequestSegments;
@@ -0,0 +1,35 @@
1
+ /**
2
+ * git unified diff 文本 → 结构化 hunk(全仓唯一一份解析)。
3
+ *
4
+ * 为什么会有一份「渲染用」的解析:dock 通道的 `git-diff` 回的是 diff 文本,
5
+ * 而审查面板与差异区只认结构化 hunk,这一层补上缺口。算法原先只长在旧渲染层
6
+ * (`desktop/src/renderer/unified-diff.ts`),界面壳又照它逐字搬了一份——两份
7
+ * 各自「以实际行数为准」的容错写在同一段注释里,改一处忘另一处就会表现成
8
+ * 「同一段 diff 在两个界面里行数不一样」。
9
+ *
10
+ * 现在实现只有这一份,两边的入口都只是转出:
11
+ * `@dsc/ui` → `@dsc/ui-primitives`(界面壳与插件),`@dsc/runtime/core/unified-diff.js`
12
+ * (旧渲染层,等它整体退役)。
13
+ *
14
+ * 只做渲染用解析:对不认识的行跳过、hunk 计数以实际行数为准(git 在文件末尾没换行等
15
+ * 场景下 `@@` 头的计数与实际行会差一),解析失败宁可少一段也不抛错。
16
+ *
17
+ * 零运行期依赖(只有 `import type`):`scripts/review-approval-test.mjs` 按 Node 的
18
+ * 类型擦除直读本文件逐条钉。
19
+ *
20
+ * @module dsc/core/unified-diff
21
+ */
22
+ import type { DiffHunkView, DiffLineView } from '../contract.js';
23
+ export type { DiffHunkView, DiffLineView };
24
+ /** 从单文件(或全量)的 unified diff 文本解析出全部 hunk;没有 hunk 就给空数组。 */
25
+ export declare function parseUnifiedDiff(text: string): DiffHunkView[];
26
+ /** 全量 git diff 按文件切段后的每一段:git 相对路径 + 该文件的 hunk。 */
27
+ export interface UnifiedFileDiff {
28
+ /** git 报出的相对仓库根路径(`b/` 侧;rename 时也是新路径)。 */
29
+ path: string;
30
+ added: number;
31
+ removed: number;
32
+ hunks: DiffHunkView[];
33
+ }
34
+ /** 把全量 git diff 文本按 `diff --git` 行切成每文件一段;没有 diff 体(全是 clean)就给空数组。 */
35
+ export declare function splitUnifiedDiffByFile(text: string): UnifiedFileDiff[];
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@dsc/ui-core",
3
- "version": "1.2.0",
3
+ "version": "0.8.1",
4
4
  "private": true,
5
5
  "description": "插件版界面的共用核心(槽位 + 清单 + 原生桥规格):宿主与界面壳同一份源码,故意不下发给插件。",
6
6
  "type": "module",
@@ -48,6 +48,35 @@ export * from '../core/model-caps.js';
48
48
  * 从参数 + 盘上现值推演 diff,用的就是宿主算轮尾差异的同一份算法。
49
49
  */
50
50
  export * from '../core/diff-text.js';
51
+ /**
52
+ * 错误文案(`core/err-text.ts`)也进共享面:界面侧到处要写「失败:<一句话>」,
53
+ * 这份实现全仓只能有一份,壳与第三方插件经 `@dsc/ui-primitives` 拿。
54
+ */
55
+ export * from '../core/err-text.js';
56
+ /**
57
+ * 吞吐读数(`core/throughput.ts`):速度与首字延迟的口径,界面侧照它算,
58
+ * 免得状态栏各写一份。`@dsc/ui-primitives` 再转出一手给插件。
59
+ */
60
+ export * from '../core/throughput.js';
61
+ /**
62
+ * git 读数的相等判断(`core/git-surface.ts`):宿主判断「要不要推这一帧」与输入区判断
63
+ * 「要不要重画」必须是同一条口径——一边认为变了、另一边认为没变,界面就停在旧分支名上。
64
+ * `@dsc/ui-primitives` 再转出一手给插件。
65
+ */
66
+ export * from '../core/git-surface.js';
67
+ /**
68
+ * git diff 文本的解析(`core/unified-diff.ts`)也进共享面:审查面板与差异区都要把
69
+ * diff 文本读成结构化 hunk,旧渲染层与界面壳此前各有一份逐字相同的实现。
70
+ * `@dsc/ui-primitives` 再转出一手给插件。
71
+ */
72
+ export * from '../core/unified-diff.js';
73
+ /**
74
+ * 模块级信号(`signal.ts`):`Set<() => void>` + `subscribe` + 通知这套写法原先在壳里
75
+ * 手抄七遍,抄漏「复制订阅者再遍历」「没变就不通知」这类语义不会报错,只会表现成
76
+ * 「界面停在旧值上」。多字段状态写成**一个对象**、一次 `set` 发出,避免半套新值先渲染。
77
+ * `@dsc/ui-primitives` 再转出一手给插件。
78
+ */
79
+ export * from './signal.js';
51
80
  /**
52
81
  * 宿主那些**界面要读的**视图类型的再导出。
53
82
  *
@@ -56,4 +85,4 @@ export * from '../core/diff-text.js';
56
85
  * 靠 `unknown` 手写类型收窄的话,宿主改一个字段名壳这边不会报错——那恰好是最该被
57
86
  * 编译器抓住的一类改动。
58
87
  */
59
- export type { ApprovalAnswer, ArchivedPage, ArchivedSessionView, ApprovalDiffView, ApprovalPolicy, ApprovalReviewer, PermissionPresetSurface, PermissionPresetView, ApprovalRequestView, AskOptionView, AskUserView, BackgroundOutputView, BackgroundWorkView, ChangedFileView, CollaborationMode, ConnectionTestOutcome, ConnectionTestView, ContextSegmentsView, DiffHunkView, DiffLineView, EffortLevel, EffortMap, GitSurface, GoalView, LinkShareData, ModeSurface, ModelChoiceView, ModelConfigView, Modality, NoticeMessageView, PairShareData, PlanDecision, PlanEntryView, PlanView, PolicySurface, PresetDraft, PresetFileView, PresetSurface, PresetView, ProviderDraft, ProviderModelView, ProviderView, QueuedMessageView, RuntimeSnapshot, ScheduledTaskView, SessionRunState, SessionSummary, SettingsField, SettingsGroupView, SettingsMutation, SettingsSectionView, SettingsValue, SettingsValues, StatusView, SubagentCardView, TeammateView, ThemeMode, ThinkingLevel, ThinkingParam, TierOption, TodoItemView, TodoStatus, TodoView, TokenUsageView, ToolCallView, ToolEntryView, ToolStatus, TranscriptEntry, TurnEndReason, UiDensity, UiFontSize, UiCommandView, UiPrefsView, UsageDayView, UsageModelView, UsageStatsView, } from '../contract.js';
88
+ export type { ApprovalAnswer, ArchivedPage, ArchivedSessionView, ApprovalDiffView, ApprovalPolicy, ApprovalReviewer, PermissionPresetSurface, PermissionPresetView, ApprovalRequestView, AskOptionView, AskUserView, BackgroundOutputView, BackgroundWorkView, ChangedFileView, CollaborationMode, ConnectionTestOutcome, ConnectionTestView, ContextSegmentsView, DiffHunkView, DiffLineView, EffortLevel, EffortMap, GitSurface, GoalView, LinkShareData, ModeSurface, ModelChoiceView, ModelConfigView, Modality, NoticeMessageView, PairShareData, PlanDecision, PlanEntryView, PlanView, PolicySurface, PresetDraft, PresetFileView, PresetSurface, PresetView, ProviderDraft, ProviderModelView, ProviderView, QueuedMessageView, RuntimeSnapshot, ScheduledTaskView, SessionRunState, SessionSummary, SettingsField, SettingsGroupView, SettingsMutation, SettingsSectionView, SettingsValue, SettingsValues, StatusView, SubagentCardView, TeammateView, ThemeMode, ThinkingLevel, ThinkingParam, TierOption, TodoItemView, TodoStatus, TodoView, TokenUsageView, ToolCallView, ToolEntryView, ToolStatus, TranscriptEntry, TurnEndReason, UiDensity, UiFontSize, UiCommandView, UiPrefsView, UsageDayView, UsageModelView, UsageStatsView, UserFileAttachment, } from '../contract.js';
@@ -46,14 +46,21 @@ export interface UiPluginRow {
46
46
  /** 允许它 import 的额外模块名;其余一律拒绝(白名单,见界面壳的加载器)。 */
47
47
  external?: string[];
48
48
  /**
49
- * 依赖名单。**双关**:先按「清单里另一个插件的 id」解(拓扑排序用的就是它),
50
- * 再按「服务名」解(A1 的服务表里有没有提供者)。
49
+ * 依赖的**插件 id**(拓扑排序用的就是它)。
51
50
  *
52
- * 顺序上的意义只是优化(被依赖的排前面);硬语义在装载器:两条路都解不到时这个插件
53
- * **不 apply**,报告里留一行中文原因(「插件 X 没装上:…」或「服务 X 还没有提供者」)。
54
- * 提供者缺席要软降级(有回落实现)的插件不要写进来,用 `ui.consume` 在渲染期读。
51
+ * 2.0 起不再兼职服务名:服务依赖写 {@link services}。2.0 之前这一个字段两种含义
52
+ * 混着用,装错时只能靠「这个 id 不在清单里」猜——那种猜法在插件改名后必然出错。
53
+ *
54
+ * 硬语义在装载器:依赖的插件没装成时这个插件**不 apply**,报告里留一行中文原因。
55
55
  */
56
56
  inject?: string[];
57
+ /**
58
+ * 依赖的**服务名**(`ui.provide` 登记的那些)。
59
+ *
60
+ * 提供者缺席就等待,报告里写「服务 X 还没有提供者」。要软降级的(有回落实现)
61
+ * 不要写进来,用 `ui.consume` 在渲染期读。
62
+ */
63
+ services?: string[];
57
64
  /** 第一档预取:需要尽早出现的插件(大小药丸、状态条之类)。与 phase 正交。 */
58
65
  immediately?: boolean;
59
66
  /** 调度档位;缺省 application。只对 web 载体的批有意义(TUI 是同进程顺序装载)。 */
@@ -75,7 +82,10 @@ export interface UiPluginEntry {
75
82
  url: string;
76
83
  /** 产物版本:文件内容的短哈希,换字节就换地址。 */
77
84
  rev: string;
85
+ /** 依赖的插件 id(见 {@link UiPluginRow.inject})。 */
78
86
  inject?: string[];
87
+ /** 依赖的服务名(见 {@link UiPluginRow.services})。 */
88
+ services?: string[];
79
89
  external?: string[];
80
90
  immediately?: boolean;
81
91
  }
@@ -94,6 +104,13 @@ export interface UiBootGraph {
94
104
  name: string;
95
105
  version: string;
96
106
  };
107
+ /**
108
+ * 声明了、装得上、但被用户停用的插件 id(不在这张图里)。
109
+ *
110
+ * 为什么图里要带这一项:装载器报「依赖没满足」时要区分「被停用」与「没有这个插件」,
111
+ * 前者翻一下开关就好,后者要去装。不进 rev——它不影响要装什么,只是解释口径。
112
+ */
113
+ disabled?: string[];
97
114
  }
98
115
  /** 摘要函数:把若干字段拼成一个短哈希。默认那份不依赖 node,浏览器壳也能算。 */
99
116
  export type HashFn = (...parts: readonly string[]) => string;
@@ -163,10 +180,11 @@ export declare function orderUiPlugins<T extends UiPluginRow>(rows: readonly T[]
163
180
  *
164
181
  * @param host - 宿主身份
165
182
  * @param artifacts - 已算出 rev 的插件包(顺序即扫描顺序)
183
+ * @param disabled - 声明了但被停用的 id(只随图带出去,不参与组图与 rev)
166
184
  */
167
185
  export declare function composeUiBootGraph(host: {
168
186
  name: string;
169
187
  version: string;
170
188
  }, artifacts: readonly (UiPluginRow & {
171
189
  rev: string;
172
- })[]): UiBootGraph;
190
+ })[], disabled?: readonly string[]): UiBootGraph;
@@ -3,7 +3,7 @@
3
3
  *
4
4
  * 与参考实现的语义差,如实写清:dsh 的客户端服务是 cordis 的 `Service`(挂 fiber 生命周期、
5
5
  * `ctx.inject` 动态等待);dsc 这份是**装载期的值表**——没有 fiber,等待语义在装载循环里
6
- * 实现(`inject` 名单解析 + 失败重试一轮,两个装载器共用 {@link unmetInjections})。
6
+ * 实现(依赖解析 {@link unmetDependencies} + 失败重试一轮,两个装载器共用)。
7
7
  * 表本身只负责三件事:提供、读取、订阅(服务出现/消失时让界面换数据源)。
8
8
  *
9
9
  * 一个名字只能有一个提供者:第二次 `provide` 抛 {@link ServiceConflictError}(人话里带
@@ -47,17 +47,28 @@ export declare class ServiceRegistry {
47
47
  subscribe(listener: () => void): () => void;
48
48
  private notify;
49
49
  }
50
+ /** 一条插件声明里的依赖,两种各走各的路(2.0 起不再双关)。 */
51
+ export interface PluginDeps {
52
+ /** 依赖的插件 id。 */
53
+ plugins?: readonly string[];
54
+ /** 依赖的服务名。 */
55
+ services?: readonly string[];
56
+ }
50
57
  /**
51
- * 解析一条 `inject` 名单,返回未满足的原因(空数组 = 可以装)。
58
+ * 解析一条插件的依赖,返回未满足的原因(空数组 = 可以装)。
59
+ *
60
+ * 插件 id 与服务名分开查:以前一个 `inject` 字段先按插件 id 解、解不到再当服务名,
61
+ * 于是「插件改名」与「服务没提供」在报告里长得一样。现在三档文案各说各的:
62
+ * 「插件 X 没装上:…」「插件 X 被停用了」「服务 Y 还没有提供者」。
52
63
  *
53
- * `inject` 是**双关**:先按「清单里另一个插件的 id」解(既有拓扑排序用的就是它),
54
- * 再按「服务名」解(提供者还没装上/被停用)。两档失败文案分开——没有提供者 vs
55
- * 提供者没装上;插件 id 在清单里时以它为准(见 `manifest.ts` 的注释)。
56
- * @param names - 插件声明的 inject 名单
64
+ * 第三档为什么单列:被停用的插件不在装载清单里,若混进「不在清单里」,用户会去装一个
65
+ * 已经装好的插件——下一步被指错了。停用是开关,翻回来就好。
66
+ * @param deps - 插件声明的两类依赖
57
67
  * @param reportOf - 查另一个插件的装载报告(按插件 id)
58
68
  * @param services - 当前的服务表
69
+ * @param disabled - 声明了但被用户停用的插件 id(不传就当没有停用的)
59
70
  */
60
- export declare function unmetInjections(names: readonly string[] | undefined, reportOf: (id: string) => {
71
+ export declare function unmetDependencies(deps: PluginDeps, reportOf: (id: string) => {
61
72
  ok: boolean;
62
73
  error?: string;
63
- } | undefined, services: ServiceRegistry): string[];
74
+ } | undefined, services: ServiceRegistry, disabled?: ReadonlySet<string>): string[];