@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
package/lib/contract.d.ts CHANGED
@@ -1,1973 +1,25 @@
1
1
  /**
2
- * UI ⇄ adapter 的共享契约(单一真源)。
2
+ * UI ⇄ adapter 的共享契约(单一真源)。**本文件只做转出**,实体按域放在 `src/contract/`。
3
3
  *
4
4
  * 边界规则(对齐 dsh-TUI 的 adapter 边界实践):
5
5
  * - `src/adapter/**` 是唯一允许 import `@deepseek-ai/*` 运行期包的层;
6
- * - UI 层(src/app/**、src/state/**、src/commands.ts)只依赖本文件的
6
+ * - UI 层(`src/app/**`、`src/state/**`、`src/commands.ts`)只依赖这里的
7
7
  * 中立类型,通过 DscRuntime 与宿主世界交互;
8
- * - 本文件自身不得 import 任何 @deepseek-ai/*。
9
- */
10
- /** deepseek adapter 的思考强度档位。default = 不声明思考字段(跟随端点默认)。 */
11
- export type EffortLevel = 'default' | 'off' | 'low' | 'high' | 'max';
12
- /** 思考强度档位里可被模型声明的四档(default 不是模型能力,是「不发字段」)。 */
13
- export type ThinkingLevel = Exclude<EffortLevel, 'default'>;
14
- /**
15
- * 思考档位用哪个请求字段发给端点:
16
- * thinking —— DeepSeek / GLM 的 `thinking:{type}`,只有开关,低/高/最大都发 enabled;
17
- * reasoning-effort —— OpenAI 与多数网关的 `reasoning_effort`,按档位发线上值(见 EffortMap);
18
- * none —— 端点没有思考参数,选哪档都不发字段。
19
- */
20
- export type ThinkingParam = 'thinking' | 'reasoning-effort' | 'none';
21
- /** 模型能接受的输入类型(text 恒含;video 目前只作声明,dsc 还没有发视频的通道)。 */
22
- export type Modality = 'text' | 'image' | 'video';
23
- /** `reasoning-effort` 下每档要发的线上值;null = 该档不发字段。 */
24
- export type EffortMap = Partial<Record<ThinkingLevel, string | null>>;
25
- /**
26
- * 权限模式——「问出来的那些事,怎么裁」。**只决定自动放行集**:
27
- * readonly —— 仅查看:读类命令放行,write/exec 类一律拒绝(连卡都不弹);
28
- * auto-edit —— 工作区自动编辑:工作目录内的 write/edit 与只读命令自动放行,
29
- * 其余(工作区外写入、exec 类)成为「要问的事」;
30
- * full-access —— 完全访问:全部工具自动放行(灾难地板仍拒)。
31
- *
32
- * 「要问的事」交给谁答,是**另一根轴**({@link ApprovalReviewer}),不再混在这一档里:
33
- * 上一版把「AI 审查」做成第四档,逼出的是四个互相排斥的选项——「只读 + AI 复核」
34
- * 这种用户真实想要的组合根本表达不出来。codex 的 `approvals_reviewer` 与参考实现的
35
- * `auto` 都是把「谁来审」抽出来的做法,这里跟齐。
36
- */
37
- export type ApprovalPolicy = 'readonly' | 'auto-edit' | 'full-access';
38
- /**
39
- * 审批审阅者——「要问的事,先给谁看」:
40
- * user —— 本人:弹审批卡等用户点(出厂默认);
41
- * auto-review —— AI 复核:先给模型判官看一眼,判 allow 就放行,判 deny 或判不出来
42
- * 再落回人工卡。复核**发生在自动放行之前**,所以「完全访问 + AI 复核」
43
- * 等价于旧版的「AI 审查」档(每一次调用都过模型,codex 的
44
- * `strict_auto_review` 同义)。
45
- *
46
- * 与权限模式正交:任何一档都能配上这两位中的任何一位(只读档下没有事情可问,
47
- * 复核者自然不会被问到——这不是特例,是「无可问之事」的正常结果)。
48
- */
49
- export type ApprovalReviewer = 'user' | 'auto-review';
50
- /**
51
- * 沙箱档位(「能不能写」这一轴;形制照 codex 的 `sandbox_mode`,与参考实现逐字相同):
52
- * read-only 只读:任何写盘与越界命令都拒;
53
- * workspace-write 工作区可写:工作区 + 沙箱私有临时目录可写,越界拒(默认档);
54
- * danger-full-access 不设围栏(等同关掉沙箱)。
55
- *
56
- * 定义住这里而不是 `services/types.ts`:打包权限预设({@link PermissionPresetView})
57
- * 要把它和权限模式一起投影给界面,而界面只依赖契约模块——两边各写一份迟早会漂。
58
- */
59
- export type SandboxMode = 'read-only' | 'workspace-write' | 'danger-full-access';
60
- /**
61
- * 协作模式(这一轮允许模型把手伸多远)。与权限模式是两根独立的旋钮:
62
- * 模式决定要不要问、能问什么;权限模式决定问出来之后怎么裁。
63
- * build 执行 —— 默认档,闸门不拦,全交给权限模式与审批卡;
64
- * plan 计划 —— 只读 + 只读命令,产出 .dsc/plans 下的计划文件等用户批;
65
- * explore 探索 —— 只读答疑,任何改动当场拒;
66
- * quiet 免打扰 —— 不弹审批卡:工作区内写自动放行,需要问的一律当场拒。
67
- */
68
- export type CollaborationMode = 'build' | 'plan' | 'explore' | 'quiet';
69
- /**
70
- * 任务清单条目的状态。
71
- * core/todo.ts 直接用它(不再另写一遍四个字符串),界面与存储因此不可能各说一套。
72
- */
73
- export type TodoStatus = 'pending' | 'in_progress' | 'completed' | 'cancelled';
74
- /** 任务清单里的一条(界面渲染用;正文已被截到 300 字以内)。 */
75
- export interface TodoItemView {
76
- id: string;
77
- content: string;
78
- status: TodoStatus;
79
- /** 父任务 id;有值表示它是上一条的子任务,界面缩进一级。 */
80
- parent?: string;
81
- }
82
- /** 任务清单投影:整表 + 版本号 + 进度,界面靠 revision 丢掉过期帧。 */
83
- export interface TodoView {
84
- items: TodoItemView[];
85
- revision: number;
86
- /** 已完成数(cancelled 不计入分母)。 */
87
- done: number;
88
- /** 有效任务总数。 */
89
- total: number;
90
- /** 当前在做的那条正文(清单条上直接显示)。 */
91
- active: string | null;
92
- }
93
- /** 计划评审卡的状态。 */
94
- export type PlanDecision = 'pending' | 'approved' | 'rejected';
95
- /** 一份待批的计划。 */
96
- export interface PlanView {
97
- /** 计划落盘的文件(相对工作目录显示由界面决定)。 */
98
- file: string;
99
- title: string;
100
- /** 计划全文(markdown)。 */
101
- text: string;
102
- /** 用户批没批;pending = 评审卡还挂着。 */
103
- decision: PlanDecision;
104
- }
105
- /**
106
- * 一张「提交过的计划」的目录项(状态面板的「计划」区)。
107
- *
108
- * 与 {@link PlanView} 的区别:PlanView 是**正挂着等批**的那一张(含全文),
109
- * 这份只是目录里的一行读数。dsc 的计划在提交时就落盘(`.dsc/plans/`),
110
- * 条目只是「哪份文件、什么标题」的账——这份账按会话记(见 {@link PlanHistoryItem}),
111
- * 面板只列本会话提交过的计划(与参考实现「计划目录 = 会话自己的终态计划」同一口径)。
112
- */
113
- export interface PlanEntryView {
114
- /** 计划文件的绝对路径(点一行在右侧栏打开它)。 */
115
- file: string;
116
- /** 计划标题(提交时从正文首个 # 标题算好)。 */
117
- title: string;
118
- /** 提交时刻(目录按它倒序)。 */
119
- at: number;
120
- }
121
- /**
122
- * 会话计划目录里的一条账(plan 插件的 `plans` 状态条目的元素)。
123
- *
124
- * 为什么要这份账:面板的「计划」区只出**本会话**提交过的计划(对齐参考实现:
125
- * 计划目录是会话投影里的终态计划行,切会话互不可见)。文件系统里的 `.dsc/plans/`
126
- * 是所有会话共享的回看口、没有归属信息,扫盘分不出谁的——归属只能记在会话自己
127
- * 的日志里(appendState 追加进 jsonl,跨重启都在)。
128
- */
129
- export interface PlanHistoryItem extends PlanEntryView {
130
- /** 这份计划的评审结果(落账用;面板行不显示——参考实现的面板行同样只有标题)。 */
131
- decision: PlanDecision;
132
- }
133
- /**
134
- * 一项正在跑的后台工作(状态面板的「终端」区):后台作业或持久终端会话。
135
- *
136
- * 只出**运行中**的,且只出**当前查看会话**起的那些(对齐参考实现:后台工作清单
137
- * 挂在会话快照上、按会话寻址,切会话互不可见)。收工的由通知与台账负责,
138
- * 面板不摆历史。
139
- */
140
- export interface BackgroundWorkView {
141
- /** 作业 id(job-N)/ 终端会话 id(term-N)。 */
142
- id: string;
143
- kind: 'job' | 'terminal';
144
- /** 行上的标题:作业 = 命令首行;终端 = 最近发进去的一条命令。 */
145
- title: string;
146
- startedAt: number;
147
- }
148
- /**
149
- * 一条后台活输出的**只读快照**(状态面板「终端」区点开的那一页)。
150
- *
151
- * 形状对准 core/tools/bash.ts 的 `JobOutputView` / `TerminalOutputView`(两者同族),
152
- * 只保留界面要画的那几个字段。口径与「模型的读口」分开:这是**尾部窗口快照**,
153
- * 不动模型的增量读游标(见 `JobTable.peek` 的说明),所以界面按秒轮询不会把模型
154
- * 该读到的输出吃掉。
155
- *
156
- * 头部丢字要能报出来(对照参考实现的 `truncated` / `outputPath`):缓冲是环形的,
157
- * 超上限时从头部丢;`droppedChars > 0` 就说明现在看到的开头已经不是最初那个开头,
158
- * 界面据此显示一条「头部已丢弃 N 字符」的提示。
159
- */
160
- export interface BackgroundOutputView {
161
- /** 作业 / 终端会话 id(与 {@link BackgroundWorkView.id} 同口径)。 */
162
- id: string;
163
- kind: 'job' | 'terminal';
164
- /** 运行状态:作业 running/completed/failed/killed;终端 running/closed。 */
165
- status: string;
166
- /** 这次快照给到的文本(已遮红)。 */
167
- text: string;
168
- /** 输出绝对总长(含已丢弃头部)。 */
169
- totalChars: number;
170
- /** 这次快照文本的绝对起点。 */
171
- from: number;
172
- /** 头部被环形缓冲丢掉的字符数;0 = 从头都在。 */
173
- droppedChars: number;
174
- /** true = 这次快照已经追上现存输出的末尾(在跑的活会继续长)。 */
175
- atEnd: boolean;
176
- }
177
- /**
178
- * 一条定点任务(状态面板的「工作流」区;schedule 插件贡献)。
179
- *
180
- * dsc 没有工作流引擎,这一区绑的是最接近的「按规则自动跑一轮」——定时任务。
181
- * 插件默认关着,关着时这份投影整个缺席(界面按空处理,整区不渲染)。
182
- */
183
- export interface ScheduledTaskView {
184
- id: string;
185
- title: string;
186
- enabled: boolean;
187
- /** 下一次该跑的绝对时刻;null = 不再跑(一次性任务已跑过 / 还没排期)。 */
188
- nextRunAt: number | null;
189
- /** 最近一次执行结果:never / running / ok / failed / blocked / skipped / done。 */
190
- lastStatus: string;
191
- /** 最近一次失败 / 阻塞的原因原文(行上的提示词用它)。 */
192
- lastError: string | null;
193
- }
194
- /**
195
- * 目标阶段。
196
- * `core/goal.ts` 直接 import 这个类型(那里只留别名),界面与存储因此共用一份声明。
197
- */
198
- export type GoalPhaseView = 'active' | 'paused' | 'blocked' | 'complete';
199
- /** 会话目标投影(界面顶部那条 goal 条的数据源)。 */
200
- export interface GoalView {
201
- objective: string;
202
- phase: GoalPhaseView;
203
- rounds: number;
204
- maxRounds: number;
205
- /** phase=blocked 时说明卡在哪。 */
206
- blockedReason?: string;
207
- /** 自动续跑开关(进程本地;重启后为 false)。 */
208
- armed: boolean;
209
- }
210
- /** 模型问用户的一个问题(ask_user 工具的数据)。 */
211
- export interface AskOptionView {
212
- label: string;
213
- description?: string;
214
- }
215
- /**
216
- * 一批提问里的一题:字段与单题视图完全相同,只是没有 `id`——
217
- * 题目在自己那一批里的位置就是它的标识。
218
- */
219
- export interface AskQuestionItem {
220
- question: string;
221
- header?: string;
222
- options: AskOptionView[];
223
- multiSelect: boolean;
224
- /** 「其他」自由输入是否允许。 */
225
- allowFreeText: boolean;
226
- }
227
- /**
228
- * 模型发起的一次提问;界面渲染成带按钮的卡片,答案回给模型。
229
- *
230
- * 一次提问可以带好几题:`questions` 有内容时界面按「一张卡列出全部题目」渲染
231
- * (逐题作答、统一提交,一次调用把全部答案交回);界面不认 `questions` 时
232
- * 就退回下面那几个单题字段,仍然能渲染出第 1 题。
233
- *
234
- * 单题字段因此是「第 1 题的投影」,和 `questions[0]` 必须同源:
235
- * 老会话回放里存下的单题视图没有 `questions`,也不需要迁移。
236
- */
237
- export interface AskUserView {
238
- id: string;
239
- question: string;
240
- header?: string;
241
- options: AskOptionView[];
242
- multiSelect: boolean;
243
- /** 「其他」自由输入是否允许。 */
244
- allowFreeText: boolean;
245
- /** 这一批的全部题目(含第 1 题);单题提问可以不写,写了就必须与单题字段一致。 */
246
- questions?: AskQuestionItem[];
247
- }
248
- /** 提一个单题提问的入参:`id` 由服务发,`questions` 由服务按这一题的字段补出来。 */
249
- export type AskUserViewInput = Omit<AskUserView, 'id' | 'questions'>;
250
- /**
251
- * 一次工具调用的展示状态。
252
- *
253
- * `preparing` = 模型已经开始吐这个工具的名字、参数还没到齐(对照 dsh 的 `preparing` 阶段)。
254
- * 那一行不解析参数、不可展开,只是告诉用户「接下来要干这件事」。它随后会被升级成 `running`。
255
- */
256
- export type ToolStatus = 'preparing' | 'running' | 'done' | 'failed' | 'rejected';
257
- /** 工具卡片视图:参数原文 +(完成后的)结果摘要。 */
258
- export interface ToolCallView {
259
- callId: string;
260
- name: string;
261
- /** 模型产出的原始 arguments JSON 字符串(截断由 UI 决定)。 */
262
- argsText: string;
263
- /** 工具结果文本(可能为空:无结果或尚未完成)。 */
264
- resultText?: string;
265
- status: ToolStatus;
266
- /**
267
- * 这次调用发起的时刻(epoch ms):宿主收到 `tool/call` 那一刻。
268
- *
269
- * 为什么不复用条目上的 `ts`:`ts` 的口径是「这条条目最后一次被写入的时刻」,
270
- * 拿到结果时会被刷成结果时刻(见 adapter/transcript.ts 的 `tool/result` 分支),
271
- * 光凭它算不出这次调用从头到尾花了多久。发起时刻因此单独存一份,只写一次不再改。
272
- *
273
- * 为什么是可选的:2026-09 之前的会话日志没记时间,重放老会话时拿不到——
274
- * 界面据此不显示耗时,绝不拿「现在」冒充历史时刻。
275
- */
276
- startedAt?: number;
277
- /**
278
- * 这次调用从发起到结果回来花掉的毫秒数(结果到达时刻 − `startedAt`)。
279
- *
280
- * 口径:`done` / `failed` / `rejected` 一视同仁都算——跑挂了、被审批拒掉、用户中途
281
- * 打断的工具调用同样占用了这段时间,轨迹页的时间线要如实显示。只有还停在 `running`
282
- * (结果没回来)时才没有这个数。
283
- *
284
- * 为什么是可选的:① 老会话没有 `startedAt`,算不出来;② 日志时间乱序(手改过、
285
- * 跨机器拷过)导致结果时刻早于发起时刻时也不写——宁可让界面不显示,也不编一个 0 秒。
286
- */
287
- durationMs?: number;
288
- /**
289
- * 这次调用对文件的**实际改动**(write / edit 成功落盘后才有):与轮尾「文件已更改」
290
- * 卡同一份数据(`tool/changes` 事件里那个 `change`,形状就是 {@link ChangedFileView})。
291
- *
292
- * 为什么挂到工具卡上:卡上的文件名现在要能点开**这一刀改了什么**的补丁视图
293
- * (diff-viewer 那条路),而逐刀改动原本只以独立 `changes` 条目存在、与调用对不上号。
294
- * 这里按 callId 缝回去,工具卡读 `call.change` 即可,不必再去猜条目间的对应关系。
295
- * 执行失败、或还在跑没有结果时没有这一项。
296
- */
297
- change?: ChangedFileView;
298
- }
299
- /**
300
- * 压缩落点标记:条目带上它,就说明「从这一刻起,模型看到的历史已经是压缩后的」。
301
- * 轨迹页据此把压缩历史渲染成独立区段(对照 dsh 的 Between turns),不必去猜正文。
302
- *
303
- * `count` = 本会话累计到这一条为止发生过的压缩次数(也就是「第几次压缩」),1 基。
304
- * 为什么用次数而不是「折进去多少条消息」:实时路径算得出条数,但会话日志里只记了
305
- * 保留了多少条(见 core/session.ts 的 `replaceWithSummary`,只写 `keep`),重放时
306
- * 反推不回来——同一个字段两条路径给不出同一个口径,索性不带。
307
- *
308
- * 压缩有两个落点,各自留在原本的 kind 上:
309
- * - 实时:compact 插件经 `dsc/notice(text, 'compaction')` 写下的 **system** 条目;
310
- * - 重放:摘要自己在内存里就是一条 `role: 'user'` 的消息(core/compact.ts 造的),
311
- * 正文固定以 `SUMMARY_BANNER` 开头,adapter 靠这个前缀把它认出来,仍是 **user** 条目。
312
- * 没有换成专属 kind,是因为「对话」页现在把摘要当用户气泡渲染——换 kind 会让摘要
313
- * 正文当场从对话页和终端界面消失。
314
- *
315
- * 老会话(日志里只有那条摘要消息)重放照样认得出,只是日志里只留最后一条摘要
316
- * (core/session.ts 的 `case 'summary'` 会把更早的记录换掉),所以重放路径的 `count`
317
- * 永远是 1。
318
- */
319
- export interface CompactionMark {
320
- /** 本会话里这是第几次压缩,1 基。 */
321
- count: number;
322
- }
323
- /**
324
- * 会话流里的一条可渲染条目。adapter 把 session/event 折叠成这个序列,
325
- * UI 只读消费;`id` 单调递增、仅在本会话生命周期内唯一。
326
- *
327
- * 每个条目都可以带 `ts`:毫秒 epoch,含义是「这条条目最后一次被写入的时刻」
328
- * (用户条目就是发消息那一刻,工具卡是最后一次更新那一刻)。界面按它显示
329
- * 「这条消息几点发的」「这一轮花了多久」。
330
- *
331
- * 为什么是可选的:2026-09 之前的会话日志里没有这个字段,重放老会话时拿不到时间。
332
- * 那时候界面降级为不显示时间与用时——绝不拿「现在」冒充历史时刻,也不显示 NaN。
333
- *
334
- * text / tool 条目还可以带 `usage`:从最近一条 user 条目算起,**这一轮**每一次模型
335
- * 请求的 prompt_tokens(含系统提示词与全部上下文)与 completion_tokens 全部累加之和。
336
- * 多步工具轮每次请求都重发整份上下文,所以这个和就是本轮的 API 真实计费量,
337
- * 而不是按正文字数估出来的。
338
- * 同一轮里靠前的条目挂的是「到那一刻为止」的累计,界面取轮内最后一条就是整轮真值。
339
- * 为什么是可选的:① 一次用量事件都没上报过(没有 usage 事件的老会话)时没有这个数;
340
- * ② 重放历史日志造不出这个数——会话日志只存消息,不存每次请求的用量。
341
- */
342
- export type TranscriptEntry =
343
- /**
344
- * images 是 data URL 清单(用户贴进来的图);界面渲染成缩略图。
345
- * `compaction` 只出现在重放出来的压缩摘要上(见 {@link CompactionMark})。
346
- * `steering` = 这条消息是在助手回合**还没跑完**时插进来的(对照 dsh 的 steering 节点)。
347
- * `internal` = 这条消息不是人打的字,是运行时投递进来的(目前只有队友干完活的
348
- * `<teammate-report>` 汇报)。模型照常看得到全文,界面不拿它当用户气泡渲染——
349
- * 对话页把它画成一行「子任务状态更新」(对照 dsh 的 turn-trigger 节点:
350
- * TurnTriggerNodeView 默认收起,展开才看得到通知正文)。
351
- */
352
- {
353
- kind: 'user';
354
- id: number;
355
- text: string;
356
- images?: string[];
357
- ts?: number;
358
- compaction?: CompactionMark;
359
- steering?: boolean;
360
- internal?: boolean;
361
- }
362
- /**
363
- * durationMs 是这段思考从第一口 reasoning delta 到定稿的耗时(≥1s 界面才显示)。
364
- * 为什么可选:重放历史日志造不出它(日志只存定稿文本),老会话回看就降级不显示。
365
- */
366
- | {
367
- kind: 'thinking';
368
- id: number;
369
- text: string;
370
- ts?: number;
371
- durationMs?: number;
372
- }
373
- /**
374
- * 子代理内联卡(实时条目,不落盘):队友在跑的时候长在转录里,收工折成一行头。
375
- * 由 subagent 插件把队友的事件流转成 SubagentCardView 推进来(dsc/subagent 事件),
376
- * 同名原位更新(React key 不换,卡片就地刷新)。
377
- */
378
- | {
379
- kind: 'subagent';
380
- id: number;
381
- sub: SubagentCardView;
382
- ts?: number;
383
- }
384
- /** usage 是整轮累计口径,见本类型头部的说明。 */
385
- | {
386
- kind: 'text';
387
- id: number;
388
- text: string;
389
- ts?: number;
390
- usage?: {
391
- inputTokens: number;
392
- outputTokens: number;
393
- };
394
- }
395
- /** usage 同上(一轮以工具结果收尾、没有最终正文时,数字落在这张卡上)。 */
396
- | {
397
- kind: 'tool';
398
- id: number;
399
- call: ToolCallView;
400
- ts?: number;
401
- usage?: {
402
- inputTokens: number;
403
- outputTokens: number;
404
- };
405
- }
406
- /** 计划卡:exit_plan_mode 交上来的计划,带用户批没批。 */
407
- | {
408
- kind: 'plan';
409
- id: number;
410
- plan: PlanView;
411
- ts?: number;
412
- }
413
- /** `compaction` 只出现在压缩插件写下的那条通知上(见 {@link CompactionMark})。 */
414
- | {
415
- kind: 'system';
416
- id: number;
417
- text: string;
418
- ts?: number;
419
- compaction?: CompactionMark;
420
- }
421
- /** 轮尾标记:这一轮为什么结束,见 {@link TurnEndReason}。 */
422
- | {
423
- kind: 'turn-end';
424
- id: number;
425
- reason: TurnEndReason;
426
- ts?: number;
427
- }
428
- /** 这一轮的输出撞上了长度上限(对照 dsh 的 `turn-max-tokens` 节点)。 */
429
- | {
430
- kind: 'turn-max-tokens';
431
- id: number;
432
- ts?: number;
433
- }
434
- /**
435
- * 模型这次请求失败、正在重试(对照 dsh 的 `model-retry` 节点)。
436
- *
437
- * 它是二级分组的**边界**(前后两段过程被它切开),但**不属于**整轮折叠要放过的那些
438
- * 独立节点——dsh 的规矩是「二级分组把模型重试视为分隔节点,但整轮折叠仍包含重试行」。
439
- */
440
- | {
441
- kind: 'model-retry';
442
- id: number;
443
- attempt: number;
444
- text: string;
445
- ts?: number;
446
- }
447
- /**
448
- * 一次成功的 write / edit 落盘后的实际改动(对照 dsh deliverables 的 produced 文件)。
449
- * 界面把同一轮里的这些条目聚合成轮尾一张「文件已更改」卡;`hunks` 是算好的
450
- * unified 差异段(结构见 {@link DiffHunkView}),审查面板直接渲染。
451
- */
452
- | {
453
- kind: 'changes';
454
- id: number;
455
- file: ChangedFileView;
456
- ts?: number;
457
- }
458
- /**
459
- * 回合收尾的聚合改动(codex `turn/diff/updated` 的同位条目):本回合动过的每个文件
460
- * 一份「回合基线 vs 盘上终态」的差异,同文件多刀合一。纯内存条目——不落 jsonl,
461
- * 重启恢复后界面回退逐刀合并显示(`kind: 'changes'` 照常重放)。
462
- */
463
- | {
464
- kind: 'turnDiff';
465
- id: number;
466
- files: ChangedFileView[];
467
- ts?: number;
468
- };
469
- /**
470
- * 一轮对话为什么结束(口径就是宿主 `turn/end` 事件的 reason,见 core/events.ts)。
471
- *
472
- * 为什么要有它:dsh 的整轮折叠有一条规矩——**中断或失败的轮不折整轮**,开关行还要把
473
- * 「已停止 / 过程失败」显示出来(`contract/turn-process.ts` 的 `turnProcessAlwaysOpen`
474
- * 与 `chat/TurnProcessNodeView.tsx:26-28`)。dsc 的宿主一直知道这个原因,只是 adapter
475
- * 从事件折条目时把它丢了,于是界面上「跑挂了的一轮」和「好好答完的一轮」长得一模一样。
476
- */
477
- export type TurnEndReason = 'completed' | 'aborted' | 'error';
478
- /**
479
- * 子代理内联卡的数据(dsh SubagentMessage 同位物):头行「状态点 + 任务 + 轮数/工具数/
480
- * 耗时/token + 状态词」,跑动时再加当前工具行与输出瀑布。数据是插件侧的实时快照,
481
- * 每次事件整体替换。
482
- */
483
- export interface SubagentCardView {
484
- /** 队友名(同会话内唯一,卡片按它原位更新)。 */
485
- name: string;
486
- /** 角色名(工牌冻结的那份)。 */
487
- role: string;
488
- /** 派给它的任务原文(界面自己截断)。 */
489
- task: string;
490
- /** 运行状态;`idle` = 正常收工,`stopped` = 被打断,`failed` = 过程失败。 */
491
- state: 'working' | 'idle' | 'failed' | 'stopped';
492
- /** 用的模型(`端点/模型`;跟随主会话模型时填当时的模型)。 */
493
- model?: string;
494
- /** 已发起的模型请求轮数。 */
495
- rounds: number;
496
- /** 已执行的工具调用次数。 */
497
- toolCalls: number;
498
- /** 开工时刻(毫秒 epoch;名册种子卡才有,实时转发必有)。 */
499
- startedAt?: number;
500
- /** 收工时刻;还在跑就没有。 */
501
- finishedAt?: number;
502
- /** 当前(或最后一把)工具:跑动时画「当前工具行」。 */
503
- lastTool?: {
504
- name: string;
505
- args: string;
506
- status: 'running' | 'done' | 'failed';
507
- };
508
- /** 输出瀑布的行池(最新在后;界面只取最后几行,每行硬截单行宽)。 */
509
- outputLines?: string[];
510
- /** 累计 token(输入+输出,端点真值;一次都没回过用量时缺省)。 */
511
- tokens?: number;
512
- /** 过程失败的原因(state=failed 时界面画一条错误行)。 */
513
- error?: string;
514
- /** 队友会话的 jsonl 路径(点卡片开只读转录浮层)。 */
515
- file?: string;
516
- }
517
- /** context 条按内容类型的分段(token 估算值,只描述占用段的颜色组成)。 */
518
- export interface ContextSegmentsView {
519
- system: number;
520
- prompt: number;
521
- assistant: number;
522
- thinking: number;
523
- tools: number;
524
- }
525
- /** 差异里的一行(与 core/diff-text.ts 的 DiffLine 同构,视图层零宿主依赖)。 */
526
- export interface DiffLineView {
527
- kind: 'context' | 'remove' | 'add';
528
- text: string;
529
- /** 这一行在旧文件里的行号;`add` 行为 null。 */
530
- oldLine: number | null;
531
- /** 这一行在新文件里的行号;`remove` 行为 null。 */
532
- newLine: number | null;
533
- }
534
- /** 一段 hunk:`@@ -oldStart,oldCount +newStart,newCount @@` 加上它包含的行(同构 DiffHunk)。 */
535
- export interface DiffHunkView {
536
- oldStart: number;
537
- oldCount: number;
538
- newStart: number;
539
- newCount: number;
540
- lines: DiffLineView[];
541
- }
542
- /** 一次成功的 write / edit 的实际改动(轮尾「文件已更改」卡与审查面板的数据)。 */
543
- export interface ChangedFileView {
544
- /** 文件的绝对路径(打开预览用)。 */
545
- path: string;
546
- /** 新增行数。 */
547
- added: number;
548
- /** 删除行数。 */
549
- removed: number;
550
- /** 算好的 unified 差异段;审查面板直接渲染,不再碰文件系统。 */
551
- hunks: DiffHunkView[];
552
- /** true = hunks 超过行数上限被砍过(面板据此提示「只显示前一部分」)。 */
553
- truncated?: boolean;
554
- /** `added` = 新建文件(改前不存在);`modified` = 改已有文件。 */
555
- status: 'added' | 'modified';
556
- }
557
- /**
558
- * 会话累计 token 用量。
559
- * 缓存命中两项只在端点上报过明细的请求上累计(命中率 = 命中 /(命中 + 未命中)),
560
- * 没上报明细的请求既不加命中也不加未命中——命中率才不会被稀释(口径与 usage-log 一致)。
561
- */
562
- export interface TokenUsageView {
563
- inputTokens: number;
564
- outputTokens: number;
565
- /** 输入里的前缀缓存命中 tokens 合计;端点从未上报过明细时缺省。 */
566
- cacheHitTokens?: number;
567
- /** 输入里的前缀缓存未命中 tokens 合计;同上。 */
568
- cacheMissTokens?: number;
569
- }
570
- /** 用量统计的单日投影(本地时区的自然日)。 */
571
- export interface UsageDayView {
572
- /** 本地时区的 YYYY-MM-DD。 */
573
- date: string;
574
- inputTokens: number;
575
- outputTokens: number;
576
- /** 这一天的模型请求轮数。 */
577
- turns: number;
578
- /** 按 `provider/model` 拆分的 token 总量(输入+输出)。 */
579
- byModel: Record<string, number>;
580
- }
581
- /** 一个模型的用量汇总。 */
582
- export interface UsageModelView {
583
- /** `provider/model`,与 daily byModel 的键一致。 */
584
- key: string;
585
- inputTokens: number;
586
- outputTokens: number;
587
- turns: number;
588
- /** 输入里的前缀缓存命中 / 未命中 tokens(端点没上报这项的记录按 0 计)。 */
589
- cacheHitTokens: number;
590
- cacheMissTokens: number;
591
- }
592
- /**
593
- * 用量统计(设置「用量统计」分区数据源)。
594
- * 宿主从 `~/.dsc/usage/usage.jsonl`(每次模型请求追加一条)聚合而来;
595
- * 这份日志从该功能上线那刻开始积累,更早的会话没有记录。
596
- */
597
- export interface UsageStatsView {
598
- /** 最早一条记录的时间戳;一条都没有时 null。 */
599
- sinceTs: number | null;
600
- totalInputTokens: number;
601
- totalOutputTokens: number;
602
- /**
603
- * 输入里的前缀缓存命中 / 未命中 tokens 合计(2026-10-03 起记录;更早的行没有这项,
604
- * 按 0 计)。两个数都只统计端点上报了明细的请求,命中率 = 前者 /(前者 + 后者)。
605
- */
606
- totalCacheHitTokens: number;
607
- totalCacheMissTokens: number;
608
- totalTurns: number;
609
- /** 有记录的自然日数。 */
610
- activeDays: number;
611
- /** 当前连续活跃天数(今天没活动就从昨天起算)。 */
612
- currentStreakDays: number;
613
- longestStreakDays: number;
614
- /** 单日 token 总量最高的那天;还没有记录时 null。 */
615
- peakDay: UsageDayView | null;
616
- /** 首条记录所在日到今天(含零日)的逐日投影,按日期升序;跨度封顶 370 天。 */
617
- days: UsageDayView[];
618
- /** 按模型汇总,总量降序。 */
619
- models: UsageModelView[];
620
- }
621
- /**
622
- * 单条会话的用量与耗时投影:壳进程读 `~/.dsc/usage/usage.jsonl` 后按会话 id 汇总
623
- * (折叠口径的唯一原件在 core/usage-log.ts 的 readSessionUsage,宿主与壳进程共用)。
624
- *
625
- * 为什么由壳进程读文件、而不是问宿主:这份日志本来就是纯数据文件,读它只多一次 IO,
626
- * 宿主忙着跑回合或正在重启时这段读数照样在。
627
- */
628
- export interface SessionUsageView {
629
- /** 这个会话的模型请求条数(含切到本进程之前的历史请求)。 */
630
- requests: number;
631
- inputTokens: number;
632
- outputTokens: number;
633
- /**
634
- * 前缀缓存读取(日志的 ch)与未缓存输入(日志的 cm)。
635
- *
636
- * 只有 0.6.46 起、且服务端真回了缓存明细的请求进这两个数:老行没有这两栏,
637
- * 把它们塞进分母会把命中率算低——宁缺不假(与设置页「前缀缓存命中」同口径)。
638
- */
639
- cacheHitTokens: number;
640
- cacheMissTokens: number;
641
- /**
642
- * 最后一次请求的输入 token:每次请求都会重发完整上下文,
643
- * 所以这就是此刻的上下文占用(服务端真值,不是估算)。
644
- */
645
- lastInputTokens: number;
646
- /** 最后一次请求落盘的时刻(毫秒);没有时间戳的行记 0。 */
647
- lastAt: number;
648
- /**
649
- * 这一步的墙钟读数(毫秒,日志的 lm/ft/d,0.6.67 起;口径见 core/throughput.ts):
650
- * `llmMs` 发出 → 定稿、`ttftMs` 首字延迟(配 `ttftSteps` 算平均)、
651
- * `decodeMs` 纯解码时间、`decodeTokens` 与它成对的那批请求的输出 token。
652
- *
653
- * 输出速度 = decodeTokens ÷ (decodeMs / 1000),整个会话累计——不是「本轮」。
654
- * 老行没这三项:它们既不进分子也不进分母(宁缺不假)。
655
- */
656
- llmMs: number;
657
- ttftMs: number;
658
- ttftSteps: number;
659
- decodeMs: number;
660
- decodeTokens: number;
661
- /** 工具调用的累计耗时与次数(日志的 `k: 'tool'` 行)。 */
662
- toolMs: number;
663
- toolCalls: number;
664
- }
665
- /**
666
- * 底部状态行数据:只放对话引擎自己的事实(哪条会话、哪个模型、这一轮在干什么)。
667
- * 某个功能点的状态(权限模式、协作模式、审批卡……)不进这里,由那个功能点自己
668
- * 往 {@link RuntimeSnapshot.surfaces} 里贡献自己那一块。
669
- */
670
- export interface StatusView {
671
- sessionId: string | null;
672
- /** 当前模型名;未知时 'unknown'。**裸名**(不带端点前缀)——它属于哪个端点看 {@link provider}。 */
673
- model: string;
674
- /**
675
- * 当前模型属于哪个端点(config.yaml 里那一节的 `name`)。
676
- *
677
- * 为什么界面需要它:`model` 是裸名,而同一个模型 id 可以挂在两个端点下(`value` 才是
678
- * `端点/模型`)。光有裸名,界面既画不出「这个模型是从哪来的」,也分不清清单里哪一条
679
- * 才该打勾——0.6.71 输入区模型菜单的勾选基本不出现,根子就在这儿。
680
- * 端点信息拿不到时是 undefined:这类值一律原样显示,不猜。
681
- */
682
- provider?: string;
683
- effort: EffortLevel;
684
- turnState: 'idle' | 'thinking' | 'working' | 'awaiting-approval';
685
- usage: TokenUsageView | null;
686
- /** 当前模型的上下文窗口(状态栏 context 进度条的分母;未知 0 = 不画刻度)。 */
687
- contextWindow: number;
688
- /**
689
- * 最近一次请求的 prompt_tokens(权威占用读数,读数与空闲段按它算)。
690
- * 为什么不用 usage 累计:那是整会话的计费和,多轮会把早已滚出窗口的内容也算进去,
691
- * 条只会虚胖。还没有任何请求回过用量时为 0。
692
- */
693
- contextUsed: number;
694
- /** 最近一次请求组装的内容类型分段(估算;没有请求记录时全 0 = 条上只有空闲段)。 */
695
- contextSegments: ContextSegmentsView;
696
- /**
697
- * 会话费用估算(人民币):只有当 provider 是 DeepSeek 官方且模型在价目表里、
698
- * 且至少回过一笔用量时才有。峰谷按北京时段分桶计价(见 core/pricing)。
699
- */
700
- cost?: {
701
- total: number;
702
- peakNow: boolean;
703
- };
704
- /** 当前会话的工作目录(状态栏显示;快照组装自 session.meta.cwd)。 */
705
- cwd?: string;
706
- /**
707
- * 当前会话的 jsonl 绝对路径。sessionId 是 uuid,拿它当文件用会按进程 cwd
708
- * 解析出 ENOENT(/fork 0.6.65 实锤)——需要落盘路径的命令一律用这个。
709
- */
710
- sessionPath?: string;
711
- /**
712
- * 当前会话一条消息都还没发过(日志还没落盘)。
713
- *
714
- * 为什么界面要知道:这种会话没有稳定身份——它一旦不是当前会话就既不进侧栏、路径也换新的,
715
- * 输入框的草稿按路径分坑就会跟着丢(0.6.70 报障)。壳据此把这类会话的草稿记在工作区名下
716
- * (见 ui-shell 的 plugins/composer/draft.ts)。
717
- */
718
- sessionUnsaved?: boolean;
719
- }
720
- /** 档位按钮的一项:档位 id + 按钮文字 + 悬浮说明。 */
721
- export interface TierOption<T extends string> {
722
- id: T;
723
- label: string;
724
- hint: string;
725
- }
726
- /**
727
- * 协作模式投影:当前档位 + 可切的档位清单。
728
- * 清单由 mode 插件给出,界面因此不必自己抄一份四档表。
729
- */
730
- export interface ModeSurface {
731
- current: CollaborationMode;
732
- options: TierOption<CollaborationMode>[];
733
- }
734
- /**
735
- * 权限投影:当前档位 + 可切档位清单 + 当前审阅者 + 可切审阅者清单。
736
- * 两根轴各给一份清单,界面因此不必自己抄一份档位表(清单只在 approval 插件里有一份)。
737
- */
738
- export interface PolicySurface {
739
- current: ApprovalPolicy;
740
- options: TierOption<ApprovalPolicy>[];
741
- /** 「要问的事」现在给谁答。 */
742
- reviewer: ApprovalReviewer;
743
- reviewerOptions: TierOption<ApprovalReviewer>[];
744
- }
745
- /**
746
- * 一个打包权限预设:把**沙箱档位**与**权限模式 + 审阅者**捆成一组,
747
- * 界面上是「一颗旋钮同时管三件事」——分开选就会出现「完全访问 + 沙箱仍 workspace-write」
748
- * 这种自相矛盾的组合(参考实现里预设 = 沙箱 + 审批 一对,此处再加上审阅者这一轴)。
749
- */
750
- export interface PermissionPresetView {
751
- /** 预设标识(小写字母数字连字符)。 */
752
- name: string;
753
- /** 界面上的显示名。 */
754
- label: string;
755
- description: string;
756
- /** 捆进来的沙箱档位。 */
757
- sandbox: SandboxMode;
758
- /** 捆进来的权限模式。 */
759
- policy: ApprovalPolicy;
760
- /** 捆进来的审阅者。 */
761
- reviewer: ApprovalReviewer;
762
- /** 出厂自带(删不掉,改不了)。 */
763
- builtin: boolean;
764
- }
765
- /** 打包权限预设投影:当前生效的 + 新会话默认的 + 全部可选。 */
766
- export interface PermissionPresetSurface {
767
- /**
768
- * 当前生效的预设名;两个旋钮的组合不匹配任何预设时为 `'custom'`
769
- * (推导出来的状态,可以离开它,但不能选它——参考实现同义)。
770
- */
771
- current: string;
772
- /** 新会话默认的预设名。 */
773
- defaultName: string;
774
- options: PermissionPresetView[];
775
- }
776
- /**
777
- * 一个模式(预设)的投影:`~/.dsc/presets/<名字>.md` 一个文件读出来的那份声明。
778
- * 界面上「查看配置」看的是文件原文(`readPreset`),这份投影只给卡片要用的字段。
779
- */
780
- export interface PresetView {
781
- /** 模式标识(小写字母数字连字符)。 */
782
- name: string;
783
- /** 界面上的显示名。 */
784
- label: string;
785
- description: string;
786
- /** 工具白名单;null = 全量,空数组 = 一个工具都不给。 */
787
- tools: string[] | null;
788
- /** 要去掉的骨架提示段 id。 */
789
- drop: string[];
790
- /** 正文 = 这个模式追加给模型的提示词(编辑表单要拿它当初始值)。 */
791
- prompt: string;
792
- /** 出厂自带的四个之一(界面标「内置」,删不掉)。 */
793
- builtin: boolean;
794
- /** 文件有问题时的说明(例如 frontmatter 坏了、drop 里写了不认识的段)。 */
795
- problem?: string;
796
- }
797
- /**
798
- * 模式投影:当前会话用的 + 新会话默认用的 + 全部可选。
799
- * 清单由 presets 插件给出,界面因此不必自己抄一份四个模式的名字。
800
- */
801
- export interface PresetSurface {
802
- /** 当前会话用的模式名。 */
803
- current: string;
804
- /** 新会话默认用的模式名。 */
805
- defaultName: string;
806
- options: PresetView[];
807
- /** 允许模式去掉的骨架提示段(界面画勾选框):名单只在 core/presets.ts 里有一份。 */
808
- droppable: Array<{
809
- id: string;
810
- label: string;
811
- }>;
812
- }
813
- /** 一个工具在界面上的投影(设置 → 模式 的工具多选;只读,不带 run)。 */
814
- export interface ToolEntryView {
815
- name: string;
816
- /** 风险档:read 自动放行,write / exec 要过审批。 */
817
- risk: 'read' | 'write' | 'exec';
818
- description: string;
819
- /** 只在列出的模式里露面;不写 = 所有模式都能看见它。 */
820
- presets?: string[];
821
- }
822
- /** 读一个模式文件原文的结果(「查看配置」用;失败时 error 是给用户看的一句话)。 */
823
- export type PresetFileView = {
824
- ok: true;
825
- name: string;
826
- text: string;
827
- } | {
828
- ok: false;
829
- error: string;
830
- };
831
- /** 新建或编辑一个模式的入参。 */
832
- export interface PresetDraft {
833
- /** null = 新建;否则是被编辑模式的原名(支持改名)。 */
834
- oldName: string | null;
835
- name: string;
836
- label: string;
837
- description: string;
838
- /** 工具白名单;null = 全量。 */
839
- tools: string[] | null;
840
- drop: string[];
841
- /** 正文 = 这个模式追加给模型的提示词。 */
842
- prompt: string;
843
- }
844
- /**
845
- * 当前工作区的 git 读数(git 插件贡献):在哪个分支、脏不脏。
846
- *
847
- * 输入框上那颗分支钮(壳 `plugins/composer`)与状态面板的分支行都读它。宿主**轻读**
848
- * (一条分支名 + 一条 `git status --porcelain -z` 数条数);状态面板那条重读(每文件
849
- * 增删行数、未跟踪文件按内容数行)留在壳里自己按更松的节奏走。
850
- */
851
- export interface GitSurface {
852
- /** 当前会话工作目录是不是 git 仓库。false 时其余字段按空处理,界面整块不画。 */
853
- repo: boolean;
854
- /** 分支名;HEAD 分离时给短 hash;仓库里一次提交都还没有时给 `(无提交)`。 */
855
- branch: string;
856
- /** true = HEAD 分离(`branch` 那一栏是 hash,不是分支名)。 */
857
- detached: boolean;
858
- /** 工作目录内有改动的文件数(含未跟踪;口径与「变更」页签一致)。 */
859
- dirtyFileCount: number;
860
- }
861
- /**
862
- * 快照里由各功能点贡献的界面片段。
863
- *
864
- * 内置那几项由对应插件自己登记(`ctx.surfaces.register`),组装快照的那一层不认识任何具体功能。
865
- * 外部插件要加自己那一块就用声明合并,不要往上面塞字段:
866
- * `declare module '@dsc/runtime/contract.js' { interface RuntimeSurfaces { memory: MyView } }`。
867
- */
868
- export interface RuntimeSurfaces {
869
- /** 当前分支与改动计数(git 贡献);输入框那颗分支钮与状态面板的分支行读它。 */
870
- git: GitSurface;
871
- /** 挂起的审批卡(approval 贡献);同一时刻至多一张。 */
872
- pendingApproval: ApprovalRequestView | null;
873
- /** 权限模式与可切档位(approval 贡献)。 */
874
- policy: PolicySurface;
875
- /**
876
- * 打包权限预设(permission-presets 贡献):沙箱 + 权限模式 + 审阅者 三合一。
877
- * 输入框那颗权限旋钮与设置页都读它——分开选会出现「完全访问 + 沙箱仍工作区可写」
878
- * 这种自相矛盾的组合,预设把它们锁在一起。
879
- */
880
- permissionPresets: PermissionPresetSurface;
881
- /** 协作模式与可切档位(mode 贡献)。 */
882
- mode: ModeSurface;
883
- /** 模式(预设)与可切清单(presets 贡献)。 */
884
- preset: PresetSurface;
885
- /** 任务清单(todo 贡献);没有任务时 items 为空数组。 */
886
- todos: TodoView;
887
- /** 挂着等用户批的计划(plan 贡献);null = 无。 */
888
- pendingPlan: PlanView | null;
889
- /** 会话目标(goal 贡献);null = 没设目标。 */
890
- goal: GoalView | null;
891
- /** 模型发起的提问(ask 贡献);同一时刻至多一个,它自己可能带一批题目(见 AskUserView.questions)。 */
892
- pendingQuestion: AskUserView | null;
893
- /** 正在跑的后台作业与终端会话(tools-default 贡献):只出当前查看会话起的,没有就是空数组。 */
894
- backgroundWorks: BackgroundWorkView[];
895
- /** 本会话提交过的计划目录(plan 贡献):最新在前,上限 12;待批的那份不在其中。 */
896
- planDirectory: PlanEntryView[];
897
- /**
898
- * 定点任务(schedule 贡献)。**可选**:schedule 插件默认关着,
899
- * 关着时这份投影整个缺席(界面按空处理,与「未登记的键缺席」同一约定)。
900
- */
901
- scheduled?: ScheduledTaskView[];
902
- }
903
- /**
904
- * 审批卡内嵌的「将做的改动」(codex 审批弹窗内嵌 diff 的同位能力):宿主在弹卡前
905
- * 读盘上现值、按工具语义推演出这次 write / edit 将产生的差异。
906
- * 算不出来(非 write/edit、参数不齐)时整个字段缺省。
907
- */
908
- export interface ApprovalDiffView {
909
- /** 目标绝对路径。 */
910
- path: string;
911
- added: number;
912
- removed: number;
913
- /** 推演出的差异段(与 ChangedFileView.hunks 同一形状,审批卡直接渲染)。 */
914
- hunks: DiffHunkView[];
915
- /** true = hunks 超行数预算被砍过尾。 */
916
- truncated?: boolean;
917
- /** `added` = 新建文件(改前不存在 / 从空串起算);`modified` = 改已有文件。 */
918
- status: 'added' | 'modified';
919
- /** true = 盘上现值没读到(工作区外 / 文件还不存在),差异是从参数推算的。 */
920
- fellBack?: boolean;
921
- /** 仅 edit:old 在盘上匹配不到 / 匹配多处——照参数执行会失败,卡片要提示。 */
922
- mismatch?: 'missing' | 'ambiguous';
923
- }
924
- /**
925
- * 模型这次在请求「放宽沙箱」(工具参数里带了成对的 sandbox_permissions + justification)。
926
- * 卡片上要摊开说清批的是什么——不然「这次允许」批下去的是一句看不懂的话。
927
- */
928
- export interface ApprovalEscalationView {
929
- /** 请求放宽到哪一档。 */
930
- permission: 'workspace-write' | 'danger-full-access';
931
- /** 模型填的持续意图(once / session);真正生效的授权档位永远是用户在卡上点的那个。 */
932
- scope: 'once' | 'session';
933
- /** 为什么必须写到范围之外(模型给的一句话)。 */
934
- justification: string;
935
- /** 这一档的人话说明(「留在沙箱内,只放宽这一次的写边界」这类)。 */
936
- effect: string;
937
- }
938
- /** 待用户决定的工具审批请求(视图投影)。 */
939
- export interface ApprovalRequestView {
940
- /** adapter 内部关联 id;answerApproval 不需要它(同一时刻至多一个挂起审批)。 */
941
- id: string;
942
- toolName: string;
943
- /** 参数摘要(单行、已截断、已遮红)。 */
944
- argsSummary: string;
945
- /** 为什么要问:命中的危险模式或规则,中文一句话。 */
946
- reason: string;
947
- /** 风险档位:critical 表示只有它不会被任何自动档带走。 */
948
- risk: 'low' | 'medium' | 'high' | 'critical';
949
- /** 「永久允许」将往 `~/.dsc/policy.rules` 写的前缀;null = 这个动作不许持久化。 */
950
- suggestedRule: string[] | null;
951
- /** true = 命中硬地板,界面不该给出任何放行按钮。 */
952
- hardline: boolean;
953
- /** 这张卡允许哪些授权档位(危险动作会把 always 摘掉)。 */
954
- scopes: Array<'once' | 'session' | 'always'>;
955
- /** 当前权限模式、审阅者与协作模式(卡片上说明现在是哪一档、谁来审)。 */
956
- policy: ApprovalPolicy;
957
- reviewer: ApprovalReviewer;
958
- mode: CollaborationMode;
959
- /** 发起审批的会话 jsonl 路径(0.6.49):后台会话的卡弹到当前视图时,界面据此标注「来自哪个会话」。 */
960
- sessionPath?: string;
961
- /** write / edit 的「将做的改动」;其他工具或推演不出时缺省。 */
962
- diff?: ApprovalDiffView;
963
- /** 模型这次在请求放宽沙箱;没请求时缺省(卡片上就不画那一段)。 */
964
- escalation?: ApprovalEscalationView;
965
- }
966
- /**
967
- * 审批应答。
968
- * allow-once 只放过这一次;
969
- * allow-session 同一会话内同类动作不再问(按会话 id 键控,切会话失效);
970
- * allow-always 往 `~/.dsc/policy.rules` 追加一条前缀规则(危险动作不给这个选项);
971
- * reject 拒。
972
- */
973
- export type ApprovalAnswer = 'allow-once' | 'allow-session' | 'allow-always' | 'reject';
974
- /** /resume 会话选择器与侧栏的一行。 */
975
- export interface SessionSummary {
976
- /** jsonl 的绝对路径(UI 侧的会话标识就是它)。 */
977
- id: string;
978
- cwd: string;
979
- createdAt: number;
980
- /** 最后一次写入日志的时间(文件 mtime),「按最近使用」排序的键。 */
981
- updatedAt: number;
982
- /** 会话标题:用户改名 → 自动生成(T16)→ 首条用户消息截断;都没有时 undefined。 */
983
- title?: string;
984
- /** 置顶时间;undefined = 未置顶。 */
985
- pinnedAt?: number;
986
- /** 归档时间;undefined = 还在活动区。归档不等于删除,恢复后回到列表。 */
987
- archivedAt?: number;
988
- }
989
- /** 归档列表的一行(设置 → 归档)。 */
990
- export interface ArchivedSessionView {
991
- /** 归档区里那个 jsonl 的绝对路径(恢复与永久删除都以它为准)。 */
992
- path: string;
993
- cwd: string;
994
- title?: string;
995
- createdAt: number;
996
- updatedAt: number;
997
- /** 归档时间;老数据没记过就退化成文件时间。 */
998
- archivedAt: number;
999
- }
1000
- /** 归档页的一页数据:条目 + 回收站情况。 */
1001
- export interface ArchivedPage {
1002
- items: ArchivedSessionView[];
1003
- /** 回收站目录:永久删除的会话先进这里,保留 30 天。 */
1004
- trashDir: string;
1005
- /** 回收站里现有的文件数(超过 30 天的在下一次读归档页时清掉)。 */
1006
- trashCount: number;
1007
- }
1008
- /** 会话排序方式:手动(工作区按拖动顺序)、按最近写入时间,或按创建时间。 */
1009
- export type SessionSortKey = 'manual' | 'recent' | 'created';
1010
- /** 列表分组方式:按工作区分组、按工作区目录树嵌套,或平铺成单列表。 */
1011
- export type SessionGroupKey = 'workspace' | 'tree' | 'flat';
1012
- /** 已归档会话在侧栏里的显隐:隐藏(默认)、并入列表一起看,或只看归档。 */
1013
- export type ArchivedFilter = 'hide' | 'show' | 'only';
1014
- /** 主题模式:固定深色、固定浅色,或跟着系统的浅色偏好走。 */
1015
- export type ThemeMode = 'dark' | 'light' | 'system';
1016
- /**
1017
- * 全局字号缩放倍数(1 = 正文 13px 基准)。桌面端把它直接写成 `--dsc-font-scale`。
1018
- *
1019
- * 0.6 之前的存档里这里是 `'sm' | 'md' | 'lg'` 三档字符串,读档时迁移成
1020
- * 0.92 / 1 / 1.12(见 core/prefs.ts 的 readPrefs)。
1021
- */
1022
- export type UiFontSize = number;
1023
- /** 密度档位:行高与纵向内距的整体缩放(紧凑 / 标准 / 宽松)。 */
1024
- export type UiDensity = 'compact' | 'standard' | 'roomy';
1025
- /**
1026
- * 过程折叠程度:对话流里「思考 / 工具调用」这些过程条目的展示档位。
1027
- *
1028
- * 四档与 dsh 的展示档位一一对应(packages/client/ui-chat/src/client/presentation-policy.ts:24-53),
1029
- * 每档开哪几项能力见 desktop/src/renderer/appearance.ts 的 PROCESS_FOLD_POLICIES:
1030
- *
1031
- * - `compact`:整轮折叠 + 阶段分组 + 不显示思考行摘要 + 组头不带实时详情;
1032
- * - `standard`:整轮折叠 + 阶段分组 + 摘要 + 组头带实时详情(默认);
1033
- * - `detailed`:整轮折叠,但**只有历史轮**才分组——正在跑的那一轮直接摊开;
1034
- * - `verbose`:整轮不折、阶段也不分组,过程条目逐条摊开。
1035
- *
1036
- * 为什么 `detailed` 和 `verbose` 都要有:dsh 里 `detailed` 是桌面端的实际默认档
1037
- * (ui-chat/src/client/apply.ts 里非 dsh 桌面端走 detailed),它的意思是「想看细节,但不想
1038
- * 每次都把历史摊开」——整轮照折,只有运行中的那一轮摊着。`verbose` 才是「什么都不折」。
1039
- * dsc 0.6.3 的三档里 `detailed` 曾经等于现在的 `verbose`,本次按 dsh 的语义改回
1040
- * 「折叠 + 只折历史轮」,原来那种「全摊开」的行为改由 `verbose` 承担。
1041
- */
1042
- export type UiProcessFold = 'compact' | 'standard' | 'detailed' | 'verbose';
1043
- /**
1044
- * TUI 底部状态栏各段的显隐(存在 `~/.dsc/settings.json` 的 `ui.statusBar`)。
1045
- * 全部必填:读档由 {@link normalizeStatusBarPrefs} 补齐,消费方不需要判缺。
1046
- * 出厂口径对齐 dsh 底栏设置的默认——只留「身份 + 在看什么」,effort/模式/
1047
- * Token 累计/会话 ID 这类设定完就不再看的默认收掉,要的在 设置 → 终端界面 →
1048
- * 状态栏 子页里打开。
1049
- */
1050
- export interface StatusBarPrefsView {
1051
- /** 模型名。 */
1052
- model: boolean;
1053
- /** 思考强度(effort 档位)。 */
1054
- effort: boolean;
1055
- /** 缓存命中率。 */
1056
- cache: boolean;
1057
- /** Token 累计(input/output)。 */
1058
- tokens: boolean;
1059
- /** 本会话费用估算(仅 DeepSeek 官方端点有数据)。 */
1060
- cost: boolean;
1061
- /** 会话模式(执行/计划/探索/免打扰)。 */
1062
- mode: boolean;
1063
- /** 权限模式。 */
1064
- policy: boolean;
1065
- /** 上下文用量百分比。 */
1066
- ctx: boolean;
1067
- /** 工作目录。 */
1068
- cwd: boolean;
1069
- /** 当前会话短 id。 */
1070
- session: boolean;
1071
- }
1072
- /** 侧栏界面偏好,存在 `~/.dsc/settings.json`,桌面端与以后别的界面共用。 */
1073
- export interface UiPrefsView {
1074
- sessionSort: SessionSortKey;
1075
- /** 侧栏会话列表的分组方式。 */
1076
- sessionGroup: SessionGroupKey;
1077
- /** 已归档会话在侧栏里的显隐。 */
1078
- archivedFilter: ArchivedFilter;
1079
- /** 手动拖出来的工作区顺序(cwd 绝对路径);没拖过是空数组。 */
1080
- workspaceOrder: string[];
1081
- /** 工作区显示名别名:cwd → 想要的名字。 */
1082
- workspaceAliases: Record<string, string>;
1083
- /** 主题模式。 */
1084
- themeMode: ThemeMode;
1085
- /** 字号缩放倍数(设置页滑杆可调范围 0.85–1.35)。 */
1086
- fontSize: UiFontSize;
1087
- /** 按钮缩放倍数(设置页滑杆可调范围 0.9–1.5),桌面端把它写成 `--dsc-btn-scale`。 */
1088
- buttonScale: number;
1089
- /** 密度档位。 */
1090
- density: UiDensity;
1091
- /** 过程折叠程度(紧凑 / 标准 / 详细 / 逐条摊开),默认 standard。 */
1092
- processFold: UiProcessFold;
1093
- /**
1094
- * 定稿的思考行默认展开吗(默认 false = 折叠成一行「思考过程」)。
1095
- *
1096
- * 为什么与 {@link processFold} 分成两套:档位管的是「整轮折不折、阶段要不要分组」这一层
1097
- * 结构,这两项管的是最里层「单条思考 / 单张工具卡默认长什么样」。dsh 没有这两项——它的
1098
- * 可选性只体现在四个档位加上每层手动开合,所以这是 dsc 自己的增量(用户要求「可选折叠
1099
- * 思考、工具调用」)。两条轴正交:档位是粗档,这两项是在档位之上的默认态微调。
1100
- *
1101
- * 只管**定稿**条目:跑动中的那一段思考永远是展开的(它是「现在在干什么」的唯一线索,
1102
- * 见 ThinkingBlock 的 showPreview 那条同样的理由)。用户手点的展开态优先于这里的默认值。
1103
- */
1104
- reasoningDefaultOpen: boolean;
1105
- /** 工具卡默认展开吗(默认 false = 只显示一行「工具名 + 状态」)。口径同 {@link reasoningDefaultOpen}。 */
1106
- toolDefaultOpen: boolean;
1107
- /**
1108
- * 侧栏各工作区分组的展开状态(cwd → 展开?),对齐 dsh 的 groupExpansion:
1109
- * 点工作区行只切换它自己,别的组不跟着动;关掉再开也记得住。
1110
- * 键缺失 = 用默认(活动组与树模式父组展开,其余收起)。
1111
- */
1112
- sessionExpansion: Record<string, boolean>;
1113
- /**
1114
- * 「手动排序」档下各工作区里会话行的顺序(cwd → 会话 jsonl 路径序列),
1115
- * 对齐 dsh 的 sessionOrderByAccount:会话行拖完落在这里,置顶块照旧排最前。
1116
- * 键缺失或表里没有的会话按最近使用排在后面。
1117
- */
1118
- sessionOrder: Record<string, string[]>;
1119
- /**
1120
- * 一轮干完(跑动 → 空闲)时播一声完成提示音吗(默认开)。桌面端行为偏好:
1121
- * 声音由桌面渲染层用 Web Audio 现场合成,远程界面(手机浏览器)不消费这几项。
1122
- */
1123
- turnCompleteSound: boolean;
1124
- /** 完成提示音的音色编号(1–14,设置里选中即试听);读档越界时夹回。 */
1125
- turnCompleteSoundVariant: number;
1126
- /**
1127
- * 窗口不在前台(最小化 / 缩托盘 / 失焦)时,一轮干完弹一条系统通知吗(默认开)。
1128
- * 通知由桌面主进程创建,点击唤回主窗口;前台时不弹——那时提示音已经足够。
1129
- */
1130
- turnCompleteNotify: boolean;
1131
- /** TUI 底部状态栏各段的显隐;读档缺键由 {@link normalizeStatusBarPrefs} 回落默认。 */
1132
- statusBar: StatusBarPrefsView;
1133
- }
1134
- /** 状态栏段显隐的出厂默认(口径见 {@link StatusBarPrefsView})。 */
1135
- export declare const DEFAULT_STATUS_BAR_PREFS: StatusBarPrefsView;
1136
- /**
1137
- * 把老存档 / 老宿主 / 手改坏档里的 `ui.statusBar` 归一成全键视图:对象缺失或
1138
- * 单键缺失都回落出厂默认(与 prefs.ts 的读档白名单同一口径,坏档不拦启动)。
1139
- * 桌面渲染层与 TUI 共用这一份——prefs.ts 带着 node 内置模块,渲染层 import 不得。
1140
- */
1141
- export declare function normalizeStatusBarPrefs(value: unknown): StatusBarPrefsView;
1142
- /** 分叉结果:成功时带新会话的 jsonl 路径,UI 拿它直接切过去。 */
1143
- export type SessionForkResult = {
1144
- ok: true;
1145
- path: string;
1146
- } | {
1147
- ok: false;
1148
- error: string;
1149
- };
1150
- /** 插件管理页的一行(内置/外部统一投影;宿主启动时扫描的快照)。 */
1151
- export interface PluginInfoView {
1152
- /** 开关键:外部插件为文件名,内置为插件名。 */
1153
- file: string;
1154
- /** 显示名(外部插件取其 name 导出,缺省为去后缀文件名)。 */
1155
- name: string;
1156
- description: string;
1157
- enabled: boolean;
1158
- source: 'builtin' | 'external';
1159
- /** true = 有开关可拨(外部插件 + 官方可开关插件);false = 运行内核,不可停用。 */
1160
- toggleable: boolean;
1161
- /** 这个插件贡献的设置分区 id;undefined = 没有可配置项,详情页不画配置表单。 */
1162
- settingsSection?: string;
1163
- /** 插件声明的内核 API 版本;未声明时 undefined。 */
1164
- apiVersion?: number;
1165
- /** 加载失败/被自动停用的原因(回滚说明),正常时 undefined。 */
1166
- problem?: string;
1167
- }
1168
- /**
1169
- * 第三方界面插件「装不上」的原因分档(`UiTrustView.problem` 的机器可读标签):
1170
- *
1171
- * - `manifest`:plugin.json 缺失、或没写 api(第三方必须声明区间);
1172
- * - `clash`:id 与内置插件撞名(第三方这份让路);
1173
- * - `version`:api 区间与当前壳不符(含 workspace: 前缀与非法区间);
1174
- * - `artifact`:plugin.json 声明齐了,但 ui/client.js 读不到。
1175
- *
1176
- * 为什么要有这一项:`problem` 是给人看的句子,界面按档画「下一步做什么」时**不许去猜
1177
- * 句子里有没有某个词**——档位在判定现场就知道,由判定的人标出来,两处文案才不互相绑架。
1178
- */
1179
- export type UiTrustProblemKind = 'manifest' | 'clash' | 'version' | 'artifact';
1180
- /**
1181
- * 第三方界面插件的一条状态(插件中心「第三方界面插件」信任卡)。
1182
- *
1183
- * 与宿主插件(`PluginInfoView`)不是一回事:那些住 `~/.dsc/plugins/*.js`,这边是
1184
- * `<目录名>/{plugin.json, ui/client.js}` 的界面半边——首次发现要答一次信任才装载
1185
- *(`UiTrustView` 就是那张卡的数据源)。
1186
- */
1187
- export interface UiTrustView {
1188
- /** 目录名(`~/.dsc/plugins/<name>`;信任记录与启停键的前半段)。 */
1189
- name: string;
1190
- /** plugin.json 声明的 `@dsc/ui` 版本区间;没写/读不到时 undefined。 */
1191
- api?: string;
1192
- /** 声明的载体(web/tui);缺省 `['web']`。 */
1193
- platforms: string[];
1194
- /** 有没有信任记录(plugins.json 顶层 `uiTrust`)。 */
1195
- trusted: boolean;
1196
- /** 答应的时刻(毫秒);未信任时 undefined。 */
1197
- trustedAt?: number;
1198
- /** 启停开关(plugins.json entries,键 `<name>/ui/client.js`)。 */
1199
- enabled: boolean;
1200
- /** 现在装不上的原因(缺 plugin.json / 没写 api / 与内置撞名 / api 区间不匹配 / client.js 读不到);能装时 undefined。 */
1201
- problem?: string;
1202
- /** `problem` 属于哪一档;没有 problem 时 undefined(界面按档给下一步动作)。 */
1203
- problemKind?: UiTrustProblemKind;
1204
- }
1205
- /** 一个队友(智能体团队派出去的子智能体);侧栏「队友」这一档看到的行。 */
1206
- export interface TeammateView {
1207
- /** 队友名,例如 writer-1。 */
1208
- name: string;
1209
- /** 角色名,例如 writer。 */
1210
- role: string;
1211
- /** working = 正在干;idle = 干完待命;stopped = 被打断;failed = 出错。 */
1212
- state: 'working' | 'idle' | 'stopped' | 'failed';
1213
- /** 派给它的任务(截短了的)。 */
1214
- task: string;
1215
- /** 它的运行记录文件(只读查看用)。 */
1216
- file: string;
1217
- /** 谁派了它:'lead' = 主会话派的。 */
1218
- parent: string;
1219
- /** 第几层:1 = Lead 的直属队友。 */
1220
- depth: number;
1221
- /** 已发起的模型请求轮数。 */
1222
- rounds: number;
1223
- startedAt: number;
1224
- finishedAt?: number;
1225
- /**
1226
- * 出生会话 id(派它的那个会话,名册持久化下来的)。
1227
- * roster.json 是跨重启的台账,字段后加;老记录没有这一项,读档时按 undefined 处理。
1228
- */
1229
- sessionId?: string;
1230
- }
1231
- /** 可切换的模型(/model 补全与校验的数据源)。 */
1232
- export interface ModelChoiceView {
1233
- /** 可直接传给 /model 的完整值:`[端点/]模型名`。 */
1234
- value: string;
1235
- provider: string;
1236
- /** 端点的显示名(`displayName`;用户没填时等于 `provider`)——选择器的一级行画它。 */
1237
- providerDisplayName: string;
1238
- model: string;
1239
- /** 面板展示用说明(端点显示名 · 上下文窗口)。 */
1240
- description: string;
1241
- /** 上下文窗口(面板右侧标注用)。 */
1242
- contextWindow: number;
1243
- /** 这个模型支持的思考档位;思考面板据此收起不支持的档位。 */
1244
- thinkingLevels: ThinkingLevel[];
1245
- /** 这个模型能接受的输入类型。 */
1246
- modalities: Modality[];
1247
- }
1248
- /**
1249
- * 壳 `/` 菜单的一行。
1250
- *
1251
- * 只带元数据(名字 / 参数占位 / 说明 / 回合中能否用),handler 留在宿主注册表里——
1252
- * 壳不需要、也拿不到执行的实现,它只把名字回给 {@link DscRuntime.runUiCommand}。
1253
- */
1254
- export interface UiCommandView {
1255
- name: string;
1256
- /** 参数占位提示(空串 = 无参数)。 */
1257
- args: string;
1258
- description: string;
1259
- /** 回合跑着时能不能用(`deny` 的行在菜单里标出来,派发那一步也由宿主再挡一次)。 */
1260
- duringTask: 'allow' | 'deny';
1261
- }
1262
- /** 技能来源标签(rank 小者赢得重名)。 */
1263
- export type SkillSourceLabel = 'project-dsc' | 'project-agents' | 'custom' | 'user-dsc' | (string & {});
1264
- /** 技能清单一行(技能中心页与设置「技能」分区共用)。 */
1265
- export interface SkillInfoView {
1266
- /** kebab-case 名,同时是启停键。 */
1267
- name: string;
1268
- description: string;
1269
- /** frontmatter when-to-use(技能卡片第二行)。 */
1270
- whenToUse?: string;
1271
- source: SkillSourceLabel;
1272
- /** SKILL.md 绝对路径;插件注册的虚拟技能没有路径。 */
1273
- path?: string;
1274
- enabled: boolean;
1275
- /** 是否出现在模型可见目录里。 */
1276
- modelInvocable: boolean;
1277
- /** 是否注册成 `/技能名` 命令。 */
1278
- userInvocable: boolean;
1279
- /** false = 由插件注册、不可启停。 */
1280
- toggleable: boolean;
1281
- /** 发现或解析问题(名字非法、frontmatter 缺字段等),正常时 undefined。 */
1282
- problem?: string;
1283
- }
1284
- /** 技能详情(正文按需读,不进模型目录)。 */
1285
- export interface SkillDetail extends SkillInfoView {
1286
- /** SKILL.md 去掉 frontmatter 之后的 markdown 正文。 */
1287
- content: string;
1288
- }
1289
- /** 技能读取结果。 */
1290
- export type SkillLoadResult = {
1291
- ok: true;
1292
- skill: SkillDetail;
1293
- } | {
1294
- ok: false;
1295
- error: string;
1296
- };
1297
- /** 一个技能市场源。 */
1298
- export interface MarketSource {
1299
- name: string;
1300
- url: string;
1301
- }
1302
- /** 市场源的健康投影(失败源保留错误原因,UI 才看得见为什么空)。 */
1303
- export interface MarketSourceView extends MarketSource {
1304
- ok: boolean;
1305
- error?: string;
1306
- }
1307
- /** 市场里的一条可安装技能。 */
1308
- export interface MarketSkillView {
1309
- name: string;
1310
- description: string;
1311
- /** 所属市场源名。 */
1312
- source: string;
1313
- version?: string;
1314
- /** 本地 ~/.dsc/skills 里是否已有同名技能。 */
1315
- installed: boolean;
1316
- }
1317
- /** 一次市场浏览的结果(当前源的条目 + 全部源的状态)。 */
1318
- export interface MarketBrowseResult {
1319
- sources: MarketSourceView[];
1320
- /** 本次条目来自哪个源。 */
1321
- source: string;
1322
- items: MarketSkillView[];
1323
- error?: string;
1324
- }
1325
- /** 设置项的值类型(要过 IPC,只能是这三类)。 */
1326
- export type SettingsValue = string | number | boolean;
1327
- /** 下拉选项。 */
1328
- export interface SettingsOption {
1329
- value: string;
1330
- label: string;
1331
- }
1332
- /**
1333
- * 设置分区里的一个控件。内置分区与外部插件声明的分区共用这一张渲染表,
1334
- * 所以字段必须可 JSON 序列化——插件给的是声明和回调,不是 React 组件。
1335
- */
1336
- export type SettingsField = {
1337
- type: 'text';
1338
- key: string;
1339
- label: string;
1340
- placeholder?: string;
1341
- help?: string;
1342
- mono?: boolean;
1343
- group?: string;
1344
- } | {
1345
- type: 'number';
1346
- key: string;
1347
- label: string;
1348
- min?: number;
1349
- max?: number;
1350
- step?: number;
1351
- help?: string;
1352
- group?: string;
1353
- }
1354
- /**
1355
- * 下拉。`derivedLabelKey` 是给**派生值**用的:当前值不在 `options` 里时(如权限预设的
1356
- * `custom`——它是三根旋钮拼出来的状态,不是可选项),壳去 `values[derivedLabelKey]` 读
1357
- * 显示名,并把这一行渲染成**置灰只读**。派生值本来就选不了(宿主 `use('custom')` 会当场拒),
1358
- * 画成能点的下拉只会让人以为能选、点了还报错。
1359
- */
1360
- | {
1361
- type: 'select';
1362
- key: string;
1363
- label: string;
1364
- options: SettingsOption[];
1365
- derivedLabelKey?: string;
1366
- help?: string;
1367
- group?: string;
1368
- } | {
1369
- type: 'switch';
1370
- key: string;
1371
- label: string;
1372
- help?: string;
1373
- group?: string;
1374
- } | {
1375
- type: 'info';
1376
- label?: string;
1377
- text: string;
1378
- mono?: boolean;
1379
- copyable?: boolean;
1380
- /**
1381
- * 行内动作(画在「复制 / 打开」右边)。**壳认得 id 才画**,认不出的整条跳过——
1382
- * 这样宿主多声明一条不会让旧壳画出点不动的按钮。
1383
- *
1384
- * 现有的两个:`switch-config-file`(选一份配置文件当活动配置)、
1385
- * `reset-config-file`(改回出厂那份)。它们要在桌面端开系统文件对话框,
1386
- * 所以由壳就地处理(不经宿主动作表)。
1387
- */
1388
- actions?: readonly SettingsInfoAction[];
1389
- help?: string;
1390
- group?: string;
1391
- } | {
1392
- type: 'button';
1393
- action: string;
1394
- label: string;
1395
- style?: 'primary' | 'ghost';
1396
- help?: string;
1397
- group?: string;
1398
- };
1399
- /** 信息行上的一个动作按钮(见 `SettingsField` 的 info 分支)。 */
1400
- export interface SettingsInfoAction {
1401
- /** 壳认得的动作 id;认不出的不画。 */
1402
- id: string;
1403
- /** 按钮文字(2–4 字动词,无标点)。 */
1404
- label: string;
1405
- /** 悬浮说明。 */
1406
- tip?: string;
1407
- }
1408
- /**
1409
- * 分区内的一个分组(dsh 同款机制):`fields` 里带 `group: id` 的字段收进这组,
1410
- * TUI 在根页只画一行「组标题 … ›」,Enter 进子页才见到组内字段;桌面端不做
1411
- * 子页导航,渲染成组头(相邻同组字段聚在一张组标题下)。组的 key 仍是分区里
1412
- * 的扁平键,values/save 链路与顶层字段零差别。
1413
- */
1414
- export interface SettingsGroupView {
1415
- id: string;
1416
- title: string;
1417
- /** 聚焦组行时提示条里的一句话说明。 */
1418
- description?: string;
1419
- }
1420
- /** 一个设置分区的投影(顺序由 order 决定,小者在前)。 */
1421
- export interface SettingsSectionView {
1422
- id: string;
1423
- title: string;
1424
- /** nav 行下方的一句话说明。 */
1425
- subtitle?: string;
1426
- order: number;
1427
- /** 分组声明(display 顺序);字段按 `group` id 归组,没进组的字段留在根页。 */
1428
- groups?: SettingsGroupView[];
1429
- /**
1430
- * 内核内置分区,或声明了 inSettings 的插件代管分区(插件里的内核级功能,
1431
- * 例如远程控制:它登记在插件上,但界面归设置页)。
1432
- */
1433
- builtin: boolean;
1434
- /**
1435
- * true = 内容要由桌面端自己画(模型、技能这类结构化界面),
1436
- * 此时 fields 为空,数据走 getModelConfig / listSkills 等专门的方法。
1437
- */
1438
- custom: boolean;
1439
- fields: SettingsField[];
1440
- }
1441
- /** 分区控件的值表。 */
1442
- export type SettingsValues = Record<string, SettingsValue>;
1443
- /**
1444
- * 配对数据的结构化载荷:桌面端据此弹「连接手机」弹窗(画码与二维码),
1445
- * 手机端也可以扫 {@link PairShareData.url} 直接把码带进登录框。
1446
- *
1447
- * 为什么不是只给一句 notice 文案:文案里的码一闪就没了,用户错过就得重新生成;
1448
- * 弹窗要一直挂在屏幕上,界面就必须拿到「码 + 可扫地址 + 过期时刻」这三个字段。
1449
- */
1450
- export interface PairShareData {
1451
- /** 载荷种类;今天只有配对码这一种,将来加别的一起收在这条判别位上。 */
1452
- kind: 'pair-code';
1453
- /** 8 位配对码。明文只在宿主内存与这条载荷里出现,绝不落盘、不进日志。 */
1454
- code: string;
1455
- /** 带 `?code=` 的完整访问地址:手机扫码打开即带上码,也可以整串复制。 */
1456
- url: string;
1457
- /** 过期时刻(epoch 毫秒);到点这张码就用不了了。 */
1458
- expiresAt: number;
1459
- }
1460
- /**
1461
- * 「用系统浏览器打开一个链接」的载荷:检查更新发现新版时随回执带给桌面端,
1462
- * 界面据此打开发布页(宿主自己够不着 shell)。
1463
- */
1464
- export interface LinkShareData {
1465
- kind: 'url';
1466
- /** 要打开的地址;桌面端只放行 http/https。 */
1467
- url: string;
1468
- }
1469
- /**
1470
- * 「有一个能就地装的新版」的载荷:检查更新发现新版、且发布资产里挑得出安装器时随回执带给界面,
1471
- * 界面据此在行内给一颗「立即更新」。
1472
- *
1473
- * 与 {@link LinkShareData} 的分工:挑得出安装器就就地更新(下载与启动安装程序由桌面主进程做,
1474
- * 见原生桥的 `installUpdate`);挑不出安装器才退回打开发布页。
1475
- */
1476
- export interface UpdateShareData {
1477
- kind: 'update';
1478
- /** 更新源上的新版本号(原样,可能带 `v` 前缀)。 */
1479
- version: string;
1480
- }
1481
- /** 写入或动作成功时的载荷:提示条文案之外,还可以带一份结构化数据给界面画弹窗。 */
1482
- export interface SettingsMutationOk {
1483
- notice?: string;
1484
- data?: PairShareData | LinkShareData | UpdateShareData;
1485
- }
1486
- /** 写入或动作的结果:失败原因直接显示在控件下方。 */
1487
- export type SettingsMutation = ({
1488
- ok: true;
1489
- } & SettingsMutationOk) | {
1490
- ok: false;
1491
- error: string;
1492
- };
1493
- /** 端点里的一个模型。 */
1494
- export interface ProviderModelView {
1495
- id: string;
1496
- name: string;
1497
- contextWindow: number;
1498
- maxTokens: number;
1499
- /** 这个模型支持的思考档位;空数组 = 没有思考开关,界面只留「默认」。 */
1500
- thinkingLevels: ThinkingLevel[];
1501
- /** 档位走哪个请求字段(见 {@link ThinkingParam})。 */
1502
- thinkingParam: ThinkingParam;
1503
- /** `reasoning-effort` 时档位 → 线上值;没写的档用内置缺省值。 */
1504
- effortMap: EffortMap;
1505
- /** 能接受的输入类型;没勾照片就不能往这个模型发图。 */
1506
- modalities: Modality[];
1507
- }
1508
- /** 一个端点(API key 只报告状态,永不回传值)。 */
1509
- export interface ProviderView {
1510
- name: string;
1511
- displayName: string;
1512
- baseUrl: string;
1513
- /** config.yaml 里 apiKeyEnv 指向的环境变量名 / 凭据库 key 名。 */
1514
- keyRef: string;
1515
- /** 该 key 是否已取得(环境变量或凭据库)。 */
1516
- keyConfigured: boolean;
1517
- models: ProviderModelView[];
1518
- }
1519
- /** 模型配置全貌。 */
1520
- export interface ModelConfigView {
1521
- providers: ProviderView[];
1522
- defaultProvider: string;
1523
- defaultModel: string;
1524
- /** 采样温度;null = 跟随端点默认。 */
1525
- temperature: number | null;
1526
- /** 配置文件绝对路径(关于分区与错误提示都要用)。 */
1527
- configFile: string;
1528
- credentialsFile: string;
1529
- }
1530
- /**
1531
- * 一次端点连接测试的结果(设置 → 模型每张卡上的「测试连接」)。
1532
- *
1533
- * 判定口径在 core/connection-test:**流正常收尾即通**;失败一律带一句可直接展示的
1534
- * 说明(永不包含 key)。
1535
- */
1536
- export interface ConnectionTestOutcome {
1537
- ok: boolean;
1538
- /** 从发出到收尾花了多久(毫秒)。失败时也报——「等 20 秒才断」本身有诊断价值。 */
1539
- ms: number;
1540
- /** 模型回的话(单行、截断到 80 字;可能为空:输出被预算截断时就是这样)。 */
1541
- reply: string;
1542
- /** 失败原因(可直接展示)。 */
1543
- error?: string;
1544
- }
1545
- /** 连接测试结果 + 测的是哪个模型(界面要把它写在那张卡上)。 */
1546
- export interface ConnectionTestView extends ConnectionTestOutcome {
1547
- model: string;
1548
- }
1549
- /** 新增或编辑一个端点的入参(apiKey 单独走 setProviderKey)。 */
1550
- export interface ProviderDraft {
1551
- /** null = 新增;否则为被编辑端点的原名字(支持改名)。 */
1552
- oldName: string | null;
1553
- name: string;
1554
- displayName: string;
1555
- baseUrl: string;
1556
- models: ProviderModelView[];
1557
- }
1558
- /**
1559
- * 跨会话运行状态(T21):侧栏会话行状态点的值域。
1560
- * working = 那个会话正在跑(当前回合进行中,或它是干着活的队友);
1561
- * awaiting-approval = 挂着等用户批;
1562
- * just-finished = 后台跑完时你没在看(0.6.48 常驻多 agent),点开即熄。
1563
- */
1564
- export type SessionRunState = 'working' | 'awaiting-approval' | 'just-finished';
1565
- /** UI 每帧读取的运行时快照(useSyncExternalStore 的 getSnapshot 返回)。 */
1566
- export interface RuntimeSnapshot {
1567
- entries: TranscriptEntry[];
1568
- status: StatusView;
1569
- /** 各功能点自己贡献的界面片段(见 {@link RuntimeSurfaces})。 */
1570
- surfaces: RuntimeSurfaces;
1571
- /** refreshSessions() 填充的会话列表缓存。 */
1572
- sessions: SessionSummary[];
1573
- sessionsLoading: boolean;
1574
- /**
1575
- * 跨会话运行状态面(T21):会话 jsonl 路径 → 运行状态,侧栏状态点的数据源。
1576
- * 收录当前会话(按 turnState)、后台常驻 agent(dsc/agent-status 事件喂进来的,
1577
- * 含「已完成未读」徽标)与正干着活的队友会话;不在场/收工已看的会话不出现。
1578
- */
1579
- sessionStates: Record<string, SessionRunState>;
1580
- /**
1581
- * 状态栏右下角的子代理 chip(0.6.65):只收当前查看会话、还在干活的队友。
1582
- * 别的会话的动态不进状态栏——出口是 /resume 行内状态点(sessionStates)与
1583
- * /agents 浮层;任务收工(settle)或切走会话即从这里消失。
1584
- */
1585
- subagents: Array<{
1586
- sessionPath: string;
1587
- state: SessionRunState;
1588
- }>;
1589
- /**
1590
- * 排队中的**用户**输入(0.6.67):回合跑动中提交、还没被这一轮认领的那些。
1591
- * 输入框下方的队列条照它画(可以编辑 / 撤掉 / 插话);空数组 = 不画那条。
1592
- *
1593
- * 只含用户来源(`InboxOrigin` 的 `'user'`)——机器发起的唤醒不进这里,见 `notices`。
1594
- */
1595
- queued: QueuedMessageView[];
1596
- /**
1597
- * 待投递的**非用户**通知:回合跑动中到达、还没落到对话历史的机器唤醒
1598
- * (队友汇报、后台作业完成、目标续跑、定时补投……)。输入框**上方**的只读
1599
- * 「待投递通知」条照它画——这些不是人打的字,不给人编辑 / 撤掉 / 插话,
1600
- * 也不把原始标记(`<teammate-report …>` 之类)直接上屏,压成一句含来源的人话。
1601
- * 空数组 = 不画那条。
1602
- *
1603
- * 与 `queued` 同源(会话的 `async-inbox` 状态条目):出账(drainInbox)后两者
1604
- * 都清掉、落成对话里的一条 user 消息,模型侧对来源无感知。
1605
- */
1606
- notices: NoticeMessageView[];
1607
- }
1608
- /**
1609
- * 一条排队中的用户输入(对照 dsh 的 InboxState `next-turn` 行)。
1610
- *
1611
- * 它在会话日志里只以 `async-inbox` 状态条目存在,落库(drainInbox)之后才算对话条目——
1612
- * 所以界面不画气泡,画队列条。
1613
- */
1614
- export interface QueuedMessageView {
1615
- /** 在收件箱里的位置(0 在最前):编辑 / 删除 / 插话都按它定位。 */
1616
- index: number;
1617
- text: string;
1618
- /** 随消息一起排队的图片(data URL 清单)。 */
1619
- images?: string[];
1620
- }
1621
- /**
1622
- * 一条待投递的非用户通知(对照 dsh 带来源的持久消息,落进对话流前的样子)。
1623
- *
1624
- * 与 {@link QueuedMessageView} 同源同生命周期,差别只在**只读**:机器唤醒没有
1625
- * 「编辑 / 撤掉 / 插话」这三件事(它不代表人的意图),界面只显示一句摘要。
1626
- * 刻意单开一个面而不是给 `QueuedMessageView` 加 `origin` 字段:两条带的组件、
1627
- * 动作、样式完全不同(一条可交互、一条只读),分面后壳的两处渲染各自只读自己
1628
- * 那一份,不会在「这条到底能不能编辑」上再判一次来源。
1629
- */
1630
- export interface NoticeMessageView {
1631
- /** 在收件箱里的位置(渲染层当 key 用;不用于动作定位)。 */
1632
- index: number;
1633
- /** 通知原文(含宿主投递的标记文本);界面负责压成一行摘要,不直接上屏原文。 */
1634
- text: string;
1635
- }
1636
- /**
1637
- * adapter 实现、UI 消费的唯一运行期接口。
1638
- *
1639
- * 约定:
1640
- * - subscribe/getSnapshot 遵循 useSyncExternalStore 语义(快照引用在两次
1641
- * notify 之间稳定);
1642
- * - 所有方法不得抛出未捕获异常到 UI;失败经 entries 追加 kind:'system'
1643
- * 条目报告;
1644
- * - openSession(undefined) 新建会话并切换;openSession(id) 恢复之;
1645
- * newSessionIn(cwd) 在指定目录新建(目录是会话自己的数据,与宿主进程目录无关);
1646
- * 切换时清空 entries。
1647
- * - 0.6.48 起:切换会话**不打断**原来那个会话正在跑的回合(它转入后台
1648
- * 继续跑完,侧栏亮状态点与「已完成」徽标);打断只发生在显式 interrupt()。
1649
- */
1650
- export interface DscRuntime {
1651
- subscribe(listener: () => void): () => void;
1652
- getSnapshot(): RuntimeSnapshot;
1653
- /**
1654
- * 提交一条用户消息(走 agent.followup)。
1655
- * @param images - 随消息发送的图片(data URL 清单);当前模型没勾「照片」时发送方要先拦住。
1656
- */
1657
- submit(text: string, images?: string[]): void;
1658
- /**
1659
- * 取消在跑的回合。缺省停当前查看的会话;指定会话 jsonl 路径时停那个**后台**
1660
- * 会话(0.6.49:侧栏行右键「停止」)——回合以 aborted 收尾,挂着的审批卡
1661
- * 随信号兜底成 reject。
1662
- */
1663
- interrupt(filePath?: string): void;
1664
- /**
1665
- * 改一条排队中的输入(`RuntimeSnapshot.queued` 里的第 index 条)。
1666
- * @returns 是否改到;那条已经出账(越界)时返回 false,界面据此给一句提示。
1667
- */
1668
- editQueued(index: number, text: string): boolean;
1669
- /** 撤掉一条排队中的输入:它还没进对话,撤了就等于没发过。 */
1670
- removeQueued(index: number): boolean;
1671
- /**
1672
- * 插话(对照 dsh 的 steer):把第 index 条提到队首并**打断**当前回合,
1673
- * 收尾出账后它作为新一轮的第一条发出去。
1674
- * @param index - 省略则保持原顺序把整队送进去。
1675
- * @returns 是否真的插上了;agent 没在跑(队列马上会自己出账)时返回 false。
1676
- */
1677
- steerQueued(index?: number): boolean;
1678
- /**
1679
- * 打开一条会话;不给 id = 新建(落在**当前会话的目录**里)。
1680
- * @param id - 要恢复的会话 jsonl 路径;省略 = 新建。
1681
- */
1682
- openSession(id?: string): Promise<void>;
1683
- /**
1684
- * 在指定目录里新建一条会话并切过去。
1685
- *
1686
- * 目录是**会话自己的数据**(宿主把它写进 jsonl 的 meta 行),所以这只是「在那个
1687
- * 目录开一条会话」——不切宿主的工作目录、不重启宿主、不重载页面。工作区行上那颗
1688
- * 「在此新建会话」钮走的就是这条路(早先它走切目录 + 重启宿主,整个界面会闪一下)。
1689
- * @param cwd - 绝对路径,必须存在且是目录;不合法时**抛错**(调用方提示用户)。
1690
- */
1691
- newSessionIn(cwd: string): Promise<void>;
1692
- compact(): Promise<void>;
1693
- setModel(model: string): Promise<void>;
1694
- setEffort(effort: EffortLevel): Promise<void>;
1695
- /** 异步刷新 sessions 列表(结果写回快照的 sessions/sessionsLoading)。 */
1696
- refreshSessions(): Promise<void>;
1697
- /** 归档一批会话(会话行与工作区行「归档全部」共用一条通道)。 */
1698
- archiveSessions(paths: string[]): Promise<SettingsMutation>;
1699
- /** 归档页数据(设置 → 归档;按归档时间倒序,带回收站目录与文件数)。 */
1700
- listArchivedSessions(): Promise<ArchivedPage>;
1701
- /** 用量统计(设置「用量统计」分区数据源;聚合 ~/.dsc/usage/usage.jsonl)。 */
1702
- usageStats(): Promise<UsageStatsView>;
1703
- /** 从归档区恢复一批会话。 */
1704
- restoreSessions(paths: string[]): Promise<SettingsMutation>;
1705
- /** 永久删除一批会话:移进 `~/.dsc/.trash/`,30 天后自动清。 */
1706
- purgeSessions(paths: string[]): Promise<SettingsMutation>;
1707
- /** 改会话显示名(写 meta.json,不动 jsonl 本体)。 */
1708
- renameSession(path: string, title: string): Promise<SettingsMutation>;
1709
- /** 置顶或取消置顶一个会话。 */
1710
- setSessionPinned(path: string, pinned: boolean): Promise<SettingsMutation>;
1711
- /** 分叉菜单的数据源:这个会话里的用户消息(数组下标就是分叉位置)。 */
1712
- listUserMessages(path: string): Promise<string[]>;
1713
- /** 分叉会话:把日志复制到第 index 条用户消息之前,返回新会话路径。 */
1714
- forkSession(path: string, index: number): Promise<SessionForkResult>;
1715
- /** 侧栏界面偏好(排序方式、工作区顺序与别名)。 */
1716
- getUiPrefs(): UiPrefsView;
1717
- /** 改侧栏界面偏好(写 `~/.dsc/settings.json`)。 */
1718
- setUiPrefs(patch: Partial<UiPrefsView>): Promise<SettingsMutation>;
1719
- /** 可切换的模型列表(进程内静态,UI 可在挂载时取一次)。 */
1720
- listModels(): ModelChoiceView[];
1721
- /** 插件清单(内置 + 外部;宿主启动时扫描的快照)。 */
1722
- listPlugins(): PluginInfoView[];
1723
- /** 更新外部插件启用状态(热生效:热挂载/卸载,写 ~/.dsc/plugins.json 持久化)。 */
1724
- setPluginEnabled(file: string, enabled: boolean): void;
1725
- /** 第三方界面插件的信任状态清单(插件中心信任卡的数据源)。 */
1726
- listUiTrust(): UiTrustView[];
1727
- /** 落一条第三方界面插件的信任记录(确认动作的终点;写 plugins.json 的 uiTrust 段)。 */
1728
- setUiTrust(name: string): SettingsMutation;
1729
- /**
1730
- * 队友清单(智能体团队开着才有内容;关着返回空数组)。
1731
- * UI 在「队友」这一档开着时轮询它。
1732
- */
1733
- listTeammates(): TeammateView[];
1734
- /**
1735
- * 收掉一个队友(用户从界面上动手;等价于 `subagent` 工具的 stop)。
1736
- * 队友名字不存在时返回的那句话就是明确的错误说明,不抛错。
1737
- */
1738
- stopTeammate(name: string): Promise<string>;
1739
- /**
1740
- * 给队友投一句话(用户从界面上传话;等价于 `subagent` 工具的 message)。
1741
- * 名字不存在或话是空的,返回的那句话就是明确的错误说明,不抛错。
1742
- */
1743
- messageTeammate(name: string, text: string): Promise<string>;
1744
- /**
1745
- * 把一个收工的队友从名册移除(运行记录文件一并删除,名字随之释放)。
1746
- * 还在干活的队友会被拒绝(先停止);名字不存在时返回的那句话就是明确的错误说明,不抛错。
1747
- */
1748
- removeTeammate(name: string): Promise<string>;
1749
- /**
1750
- * 收掉一个正在跑的后台作业(`job-N`)或持久终端会话(`term-N`)——用户在状态面板
1751
- * 的「终端」区按停止时走它。等价于 `job_kill` / `terminal close` 的簿记与进程收尾,
1752
- * 但目标是我们自己的后台表,**不过审批**(与 `stopTeammate` 同一条理由:收自己起的
1753
- * 后台活不是新增动作面,是叫停)。id 不认识时返回的那句话就是明确的错误说明,不抛错。
1754
- */
1755
- stopBackground(id: string): Promise<string>;
1756
- /**
1757
- * 只读读一次后台作业 / 终端会话的输出快照(状态面板「终端」区点开输出面后按秒轮询它)。
1758
- * 与 {@link stopBackground} 同一档归属校验:只读当前查看会话起的那条;id 不认识或
1759
- * 属于别的会话时 reject(消息可直接展示)。它**不动**模型的增量读游标(见
1760
- * {@link BackgroundOutputView} 的说明)。
1761
- */
1762
- readBackground(id: string): Promise<BackgroundOutputView>;
1763
- /**
1764
- * 只读重放一个会话文件的对话条目(看队友在干什么用)。
1765
- * 它不改那个文件,也不能归档/删除/分叉——校验在 core/session.ts。
1766
- */
1767
- peekTranscript(file: string): Promise<TranscriptEntry[]>;
1768
- /**
1769
- * 技能清单(全部来源合并、重名按 rank 裁决、含被停用的条目)。
1770
- * 工作目录取当前会话的 cwd,项目级技能因此随会话变化。
1771
- */
1772
- listSkills(): SkillInfoView[];
1773
- /** 读一个技能的正文(技能中心详情用;不存在返回 ok:false)。 */
1774
- readSkill(name: string): Promise<SkillLoadResult>;
1775
- /** 启停技能(写 ~/.dsc/skills.json,下一次请求生效)。 */
1776
- setSkillEnabled(name: string, enabled: boolean): SettingsMutation;
1777
- /** 浏览技能市场(source 省略时用第一个源)。 */
1778
- browseMarket(source?: string): Promise<MarketBrowseResult>;
1779
- /** 从市场源安装一个技能到 ~/.dsc/skills/。 */
1780
- installMarketSkill(source: string, name: string): Promise<SettingsMutation>;
1781
- /** 覆盖市场源清单(写 ~/.dsc/settings.json)。 */
1782
- setMarketSources(sources: MarketSource[]): SettingsMutation;
1783
- /** 设置分区清单(内置 + 插件贡献,按 order 排序)。 */
1784
- getSettingsSections(): SettingsSectionView[];
1785
- /** 读一个分区当前控件值。 */
1786
- getSectionValues(id: string): Promise<SettingsValues>;
1787
- /** 写一个控件的值(分区自己的 save 回调校验;失败原因回 UI)。 */
1788
- setSettingValue(id: string, key: string, value: SettingsValue): Promise<SettingsMutation>;
1789
- /** 执行分区的按钮动作(返回值里的 notice 由插件给出)。 */
1790
- runSettingAction(id: string, action: string): Promise<SettingsMutation>;
1791
- /** 模型配置全貌(设置「模型」分区数据源)。 */
1792
- getModelConfig(): ModelConfigView;
1793
- /**
1794
- * 拉一个端点线上可用的模型清单(T23,设置 → 模型里「拉取清单」用)。
1795
- * 连不上或应答认不得时 reject(消息可直接展示)。
1796
- */
1797
- discoverModels(provider: string): Promise<string[]>;
1798
- /**
1799
- * 测一次端点连接(设置 → 模型里「测试连接」用):拿这个端点**真发一次**最小的
1800
- * 对话请求,走与正常对话同一条链路(同协议适配器、同一份归因头)。
1801
- *
1802
- * 与 `discoverModels` 的分工:那个只证明地址可达(GET /models),这个证明
1803
- * 「key / 模型 id / 协议 / 端点要的头」这一整套现在能用。
1804
- *
1805
- * 端点不存在、这个端点还没有模型时 reject;请求本身失败**不** reject——
1806
- * 折成 `{ ok: false, error }` 返回,界面就近展示(点一次按钮不该弹两次错)。
1807
- * `model` 缺省用「这个端点平时会用到的那个模型」。
1808
- */
1809
- testConnection(provider: string, model?: string): Promise<ConnectionTestView>;
1810
- /** 新增或编辑端点(写 config.yaml;当前会话正在用的端点同步热更新)。 */
1811
- saveProvider(draft: ProviderDraft): Promise<SettingsMutation>;
1812
- /** 删除端点(写 config.yaml;默认端点被删时自动改指第一个可用端点)。 */
1813
- removeProvider(name: string): Promise<SettingsMutation>;
1814
- /** 写入或清除端点的 API key(写 ~/.dsc/credentials.yaml 的 refs)。 */
1815
- setProviderKey(name: string, apiKey: string | null): Promise<SettingsMutation>;
1816
- /** 设为默认端点/模型(写 config.yaml 并对当前会话立即生效)。 */
1817
- setDefaultModel(provider: string, model: string): Promise<SettingsMutation>;
1818
- /**
1819
- * 换一份配置文件用(写 settings.json 的 configFile 字段,空串 = 回到出厂那份 ~/.dsc/config.yaml)。
1820
- *
1821
- * 只在原生桥开放(与 saveProvider 那三件同一先例:写类入口不进界面通道)。文件本身不动,
1822
- * 端点清单、模型编辑与后续写入全部改到这一份上;传进来的路径由设置页经系统文件对话框选,
1823
- * 宿主这边仍按「存在 + 是文件 + 能解析出 providers」三道校验把关。
1824
- */
1825
- setConfigFile(path: string): Promise<SettingsMutation>;
1826
- /** 切换权限模式(readonly / auto-edit / full-access)。 */
1827
- setPolicy(policy: ApprovalPolicy): void;
1828
- /** 切换审阅者(user = 本人点卡 / auto-review = 先给模型判官看一眼)。 */
1829
- setReviewer(reviewer: ApprovalReviewer): void;
1830
- /** 打包权限预设投影(沙箱 + 权限模式 + 审阅者三合一)。 */
1831
- listPermissionPresets(): PermissionPresetSurface;
1832
- /** 切到某个打包预设:一次写三个旋钮(沙箱 / 权限模式 / 审阅者)。 */
1833
- usePermissionPreset(name: string): SettingsMutation;
1834
- /** 设为新会话默认的打包预设(写 `~/.dsc/settings.json`)。 */
1835
- setDefaultPermissionPreset(name: string): SettingsMutation;
1836
- /** 派发一条 / 命令到宿主命令注册表(内置 + 外部插件命令统一)。 */
1837
- runCommand(input: string): boolean;
1838
- /**
1839
- * 壳 `/` 菜单的数据源:标了 `shell: true` 那批命令的元数据
1840
- * (清单单一真源在 `core/commands-completion.ts`,理由也写在那里)。
1841
- */
1842
- listUiCommands(): UiCommandView[];
1843
- /**
1844
- * 壳的 `/` 命令派发:同一条注册表(内置 + 外部插件),但只放行
1845
- * {@link DscRuntime.listUiCommands} 里那批,其余名字明确报错——界面通道与页面里的
1846
- * 第三方插件都够不着权限旋钮、写文件、落信任、退出这些动作(`runCommand` 仍不进
1847
- * 界面白名单,见 core/ui-methods.ts 的 UI_EXCLUDED)。
1848
- */
1849
- runUiCommand(input: string): boolean;
1850
- /**
1851
- * 桌面端 dock 面板的工作区能力(desktop-dock 服务透传):
1852
- * fs-list / fs-read / git-status / git-stage / git-unstage / git-commit / git-log / git-diff。
1853
- */
1854
- dock(op: string, payload?: Record<string, unknown>): Promise<unknown>;
1855
- /**
1856
- * 回答审批(四种决定;scope 语义见 ApprovalAnswer)。
1857
- * @param source - 这个答案从哪儿点下来的:省略 = 宿主界面(桌面端 / 终端),
1858
- * `'web'` = 手机浏览器(远程控制)。只影响审计记录里那一栏。
1859
- */
1860
- answerApproval(answer: ApprovalAnswer, source?: 'app' | 'web'): void;
1861
- /** 回答模型发起的提问(ask_user);文本就是答案,一批多题时按题序一次交一题。 */
1862
- answerQuestion(answer: string): void;
1863
- /** 回答计划评审卡(批准 = 切回执行模式开工);拒绝时可附反馈原话,模型按它改方案。 */
1864
- answerPlan(decision: PlanDecision, feedback?: string): void;
1865
- /** 切换协作模式(执行 / 计划 / 探索 / 免打扰),写进会话记录。 */
1866
- setMode(mode: CollaborationMode): void;
1867
- /**
1868
- * 模式(预设)投影:当前会话用的、新会话默认用的、全部可选。
1869
- * 输入框那颗模式旋钮与设置页「模式」分区都读它。
1870
- */
1871
- listPresets(): PresetSurface;
1872
- /** 读一个模式的原文(「查看配置」只读用);不存在时 ok:false 带一句话。 */
1873
- readPreset(name: string): Promise<PresetFileView>;
1874
- /** 切换当前会话的模式(写会话记录,恢复会话时一起恢复)。 */
1875
- usePreset(name: string): SettingsMutation;
1876
- /** 新建或覆盖一个模式(写 `~/.dsc/presets/<名字>.md`)。 */
1877
- savePreset(draft: PresetDraft): SettingsMutation;
1878
- /** 删掉一个自定义模式(内置四个删不掉)。 */
1879
- removePreset(name: string): SettingsMutation;
1880
- /** 设为新会话默认模式(写 `~/.dsc/settings.json`)。 */
1881
- setDefaultPreset(name: string): SettingsMutation;
1882
- /**
1883
- * 全部已注册工具(名字 / 风险 / 一行说明 / 归属模式)。
1884
- * 设置 → 模式 的工具多选读它;这也是界面第一次能看见完整工具目录。
1885
- */
1886
- listTools(): ToolEntryView[];
1887
- /** 用户侧目标动作:暂停 / 继续 / 清空 / 放宽轮次上限。 */
1888
- goalAction(action: 'pause' | 'resume' | 'clear' | 'extend'): SettingsMutation;
1889
- /** 手动清空任务清单(清单条上的小按钮)。 */
1890
- clearTodos(): void;
1891
- /** 退出应用(dispose → 进程结束)。 */
1892
- exit(): void;
1893
- /** 释放全部资源(dispose agent、退订);集成层在 ink unmount 后调用。 */
1894
- dispose(): void;
1895
- }
1896
- /**
1897
- * 一个动作的目标。两种二选一(判别字段 `type`,与 ZCode 的 target 语义一致):
1898
- * - `coordinate`:最近一张返回栅格上的整数像素(`frame_id` 用于对账是哪张图);
1899
- * - `element`:该窗口最近一次无障碍观察里的控件索引(`state_id` 用于对账是哪次观察)。
1900
- * 元素索引在该窗口的**最近一次观察**作用域内有效;元素消失必须 fail-closed(报错,绝不退化到坐标)。
1901
- */
1902
- export type DesktopTarget = {
1903
- type: 'coordinate';
1904
- x: number;
1905
- y: number;
1906
- frame_id?: string;
1907
- } | {
1908
- type: 'element';
1909
- index: number;
1910
- state_id?: string;
1911
- };
1912
- /** 一次无障碍(UIA)观察里的一个控件。 */
1913
- export interface DesktopElement {
1914
- /** 该次观察内的下标;元素作用域 = 该窗口最近一次观察。 */
1915
- index: number;
1916
- /** 控件类型(UIA ControlType,去掉 `ControlType.` 前缀,例如 Button / Edit)。 */
1917
- controlType: string;
1918
- /** 无障碍名称(按钮文案、输入框标签这类)。 */
1919
- title: string;
1920
- /** UIA AutomationId(开发者给的稳定标识,可能为空)。 */
1921
- automaid: string;
1922
- /** 控件的值(ValuePattern 可读时;否则空串)。 */
1923
- value: string;
1924
- /** 屏幕物理像素矩形;读不到时为 null。 */
1925
- bounds: {
1926
- x: number;
1927
- y: number;
1928
- width: number;
1929
- height: number;
1930
- } | null;
1931
- /** 支持的 UIA 模式名(Invoke / Toggle / SelectionItem / ExpandCollapse / Value / Scroll / RangeValue / Text)。 */
1932
- patterns: string[];
1933
- /** 是否可用(灰掉的控件为 false)。 */
1934
- enabled: boolean;
1935
- /** 是否在屏外(最小化/滚动出视口)。 */
1936
- offscreen: boolean;
1937
- }
1938
- /** 观察绑定的窗口。 */
1939
- export interface DesktopWindowRef {
1940
- /** 顶层窗口句柄(list_windows 里的 window_id 就是它)。 */
1941
- id: number;
1942
- title: string;
1943
- bounds: {
1944
- x: number;
1945
- y: number;
1946
- width: number;
1947
- height: number;
1948
- } | null;
1949
- }
1950
- /** 一次无障碍观察的完整结果。 */
1951
- export interface DesktopFrame {
1952
- /** 这次观察的编号(element 目标的 state_id 对账用)。 */
1953
- state_id: string;
1954
- /** 窗口归属进程名。 */
1955
- app: string;
1956
- window: DesktopWindowRef;
1957
- /** 观察到的控件(按遍历顺序,index 与数组下标一致)。 */
1958
- elements: DesktopElement[];
1959
- /** 文本树(缩进的 `[index] ControlType "title" = "value"` 行)。 */
1960
- text: string;
1961
- /** full = 全树;diff = 相对 base_state_id 的增量。 */
1962
- snapshot_mode: 'full' | 'diff';
1963
- /** diff 模式下的基线观察编号。 */
1964
- base_state_id?: string;
1965
- /** diff 模式的增量结论(索引仍按基线有效)。 */
1966
- diff?: {
1967
- removed: number[];
1968
- added: number[];
1969
- changed: number[];
1970
- };
1971
- }
1972
- /** 电脑操作的危险分级:只读观察 / 输入动作 / 系统级动作。 */
1973
- export type DesktopRiskTier = 'read' | 'input' | 'system';
8
+ * - 本文件与 `src/contract/**` 自身不得 import 任何 `@deepseek-ai/*`。
9
+ *
10
+ * 为什么分家:一份 2,093 行的契约文件里改「设置」的一个字段,要在 2,093 行里找位置;
11
+ * 十来个人同时动的话每次都是冲突。分成十域之后每域一两百行,改设置只看 `settings.ts`。
12
+ * 导出面一个没变——调用方照旧 `import type { … } from '../contract.js'`。
13
+ *
14
+ * @module dsc/contract
15
+ */
16
+ export * from './contract/mode.js';
17
+ export * from './contract/task.js';
18
+ export * from './contract/transcript.js';
19
+ export * from './contract/usage.js';
20
+ export * from './contract/runtime.js';
21
+ export * from './contract/approval.js';
22
+ export * from './contract/session.js';
23
+ export * from './contract/plugin.js';
24
+ export * from './contract/settings.js';
25
+ export * from './contract/snapshot.js';