@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,453 @@
1
+ /**
2
+ * 契约分域:snapshot
3
+ *
4
+ * 从 `src/contract.ts` 拆出来的一个域(纯搬移,逐字未改)。调用方照旧 import
5
+ * `../contract.js`——那份文件现在只做转出,导出面一个没少。
6
+ *
7
+ * @module dsc/contract/snapshot
8
+ */
9
+ import type { ApprovalAnswer } from './approval.js';
10
+ import type { ApprovalPolicy, ApprovalReviewer, CollaborationMode, EffortLevel } from './mode.js';
11
+ import type { MarketBrowseResult, MarketSource, ModelChoiceView, PluginInfoView, SessionForkResult, SkillInfoView, SkillLoadResult, TeammateView, UiCommandView, UiTrustView } from './plugin.js';
12
+ import type { PermissionPresetSurface, PresetDraft, PresetFileView, PresetSurface, RuntimeSurfaces, StatusView, ToolEntryView } from './runtime.js';
13
+ import type { ArchivedPage, SessionSummary, UiPrefsView } from './session.js';
14
+ import type { ConnectionTestView, ModelConfigView, ProviderDraft, SettingsMutation, SettingsSectionView, SettingsValue, SettingsValues } from './settings.js';
15
+ import type { BackgroundOutputView, PlanDecision } from './task.js';
16
+ import type { TranscriptEntry } from './transcript.js';
17
+ import type { UserFileAttachment } from '../core/attachments.js';
18
+ import type { SideAskView, UsageStatsView } from './usage.js';
19
+ /**
20
+ * 跨会话运行状态(T21):侧栏会话行状态点的值域。
21
+ * working = 那个会话正在跑(当前回合进行中,或它是干着活的队友);
22
+ * awaiting-approval = 挂着等用户批;
23
+ * just-finished = 后台跑完时你没在看(0.6.48 常驻多 agent),点开即熄。
24
+ */
25
+ export type SessionRunState = 'working' | 'awaiting-approval' | 'just-finished';
26
+ /** UI 每帧读取的运行时快照(useSyncExternalStore 的 getSnapshot 返回)。 */
27
+ export interface RuntimeSnapshot {
28
+ entries: TranscriptEntry[];
29
+ status: StatusView;
30
+ /** 各功能点自己贡献的界面片段(见 {@link RuntimeSurfaces})。 */
31
+ surfaces: RuntimeSurfaces;
32
+ /** refreshSessions() 填充的会话列表缓存。 */
33
+ sessions: SessionSummary[];
34
+ sessionsLoading: boolean;
35
+ /**
36
+ * 跨会话运行状态面(T21):会话 jsonl 路径 → 运行状态,侧栏状态点的数据源。
37
+ * 收录当前会话(按 turnState)、后台常驻 agent(dsc/agent-status 事件喂进来的,
38
+ * 含「已完成未读」徽标)与正干着活的队友会话;不在场/收工已看的会话不出现。
39
+ */
40
+ sessionStates: Record<string, SessionRunState>;
41
+ /**
42
+ * 状态栏右下角的子代理 chip(0.6.65):只收当前查看会话、还在干活的队友。
43
+ * 别的会话的动态不进状态栏——出口是 /resume 行内状态点(sessionStates)与
44
+ * /agents 浮层;任务收工(settle)或切走会话即从这里消失。
45
+ */
46
+ subagents: Array<{
47
+ sessionPath: string;
48
+ state: SessionRunState;
49
+ }>;
50
+ /**
51
+ * 排队中的**用户**输入(0.6.67):回合跑动中提交、还没被这一轮认领的那些。
52
+ * 输入框下方的队列条照它画(可以编辑 / 撤掉 / 插话);空数组 = 不画那条。
53
+ *
54
+ * 只含用户来源(`InboxOrigin` 的 `'user'`)——机器发起的唤醒不进这里,见 `notices`。
55
+ */
56
+ queued: QueuedMessageView[];
57
+ /**
58
+ * 待投递的**非用户**通知:回合跑动中到达、还没落到对话历史的机器唤醒
59
+ * (队友汇报、后台作业完成、目标续跑、定时补投……)。输入框**上方**的只读
60
+ * 「待投递通知」条照它画——这些不是人打的字,不给人编辑 / 撤掉 / 插话,
61
+ * 也不把原始标记(`<teammate-report …>` 之类)直接上屏,压成一句含来源的人话。
62
+ * 空数组 = 不画那条。
63
+ *
64
+ * 与 `queued` 同源(会话的 `async-inbox` 状态条目):出账(drainInbox)后两者
65
+ * 都清掉、落成对话里的一条 user 消息,模型侧对来源无感知。
66
+ */
67
+ notices: NoticeMessageView[];
68
+ }
69
+ /**
70
+ * 一条排队中的用户输入(对照 dsh 的 InboxState `next-turn` 行)。
71
+ *
72
+ * 它在会话日志里只以 `async-inbox` 状态条目存在,落库(drainInbox)之后才算对话条目——
73
+ * 所以界面不画气泡,画队列条。
74
+ */
75
+ export interface QueuedMessageView {
76
+ /** 在收件箱里的位置(0 在最前):编辑 / 删除 / 插话都按它定位。 */
77
+ index: number;
78
+ text: string;
79
+ /** 随消息一起排队的图片(引用或老式 data URL)。 */
80
+ images?: string[];
81
+ /** 随消息一起排队的视频 / 通用文件。 */
82
+ files?: UserFileAttachment[];
83
+ }
84
+ /**
85
+ * 一条待投递的非用户通知(对照 dsh 带来源的持久消息,落进对话流前的样子)。
86
+ *
87
+ * 与 {@link QueuedMessageView} 同源同生命周期,差别只在**只读**:机器唤醒没有
88
+ * 「编辑 / 撤掉 / 插话」这三件事(它不代表人的意图),界面只显示一句摘要。
89
+ * 刻意单开一个面而不是给 `QueuedMessageView` 加 `origin` 字段:两条带的组件、
90
+ * 动作、样式完全不同(一条可交互、一条只读),分面后壳的两处渲染各自只读自己
91
+ * 那一份,不会在「这条到底能不能编辑」上再判一次来源。
92
+ */
93
+ export interface NoticeMessageView {
94
+ /** 在收件箱里的位置(渲染层当 key 用;不用于动作定位)。 */
95
+ index: number;
96
+ /** 通知原文(含宿主投递的标记文本);界面负责压成一行摘要,不直接上屏原文。 */
97
+ text: string;
98
+ }
99
+ /**
100
+ * adapter 实现、UI 消费的唯一运行期接口。
101
+ *
102
+ * 约定:
103
+ * - subscribe/getSnapshot 遵循 useSyncExternalStore 语义(快照引用在两次
104
+ * notify 之间稳定);
105
+ * - 所有方法不得抛出未捕获异常到 UI;失败经 entries 追加 kind:'system'
106
+ * 条目报告;
107
+ * - openSession(undefined) 新建会话并切换;openSession(id) 恢复之;
108
+ * newSessionIn(cwd) 在指定目录新建(目录是会话自己的数据,与宿主进程目录无关);
109
+ * 切换时清空 entries。
110
+ * - 0.6.48 起:切换会话**不打断**原来那个会话正在跑的回合(它转入后台
111
+ * 继续跑完,侧栏亮状态点与「已完成」徽标);打断只发生在显式 interrupt()。
112
+ */
113
+ export interface DscRuntime {
114
+ subscribe(listener: () => void): () => void;
115
+ getSnapshot(): RuntimeSnapshot;
116
+ /**
117
+ * 提交一条用户消息(走 agent.followup)。
118
+ * @param images - 随消息发送的图片引用(`/api/attachments/<sha>`;老调用点给 data URL);
119
+ * 当前模型没勾「照片」时发送方要先拦住。
120
+ * @param files - 视频 / 通用文件的落盘元数据(模型侧只看到路径句柄;界面画文件卡)。
121
+ */
122
+ submit(text: string, images?: string[], files?: UserFileAttachment[]): void;
123
+ /**
124
+ * 取消在跑的回合。缺省停当前查看的会话;指定会话 jsonl 路径时停那个**后台**
125
+ * 会话(0.6.49:侧栏行右键「停止」)——回合以 aborted 收尾,挂着的审批卡
126
+ * 随信号兜底成 reject。
127
+ */
128
+ interrupt(filePath?: string): void;
129
+ /**
130
+ * 改一条排队中的输入(`RuntimeSnapshot.queued` 里的第 index 条)。
131
+ * @returns 是否改到;那条已经出账(越界)时返回 false,界面据此给一句提示。
132
+ */
133
+ editQueued(index: number, text: string): boolean;
134
+ /** 撤掉一条排队中的输入:它还没进对话,撤了就等于没发过。 */
135
+ removeQueued(index: number): boolean;
136
+ /**
137
+ * 插话(对照 dsh 的 steer):把第 index 条提到队首并**打断**当前回合,
138
+ * 收尾出账后它作为新一轮的第一条发出去。
139
+ * @param index - 省略则保持原顺序把整队送进去。
140
+ * @returns 是否真的插上了;agent 没在跑(队列马上会自己出账)时返回 false。
141
+ */
142
+ steerQueued(index?: number): boolean;
143
+ /**
144
+ * 打开一条会话;不给 id = 新建(落在**当前会话的目录**里)。
145
+ * @param id - 要恢复的会话 jsonl 路径;省略 = 新建。
146
+ */
147
+ openSession(id?: string): Promise<void>;
148
+ /**
149
+ * 在指定目录里新建一条会话并切过去。
150
+ *
151
+ * 目录是**会话自己的数据**(宿主把它写进 jsonl 的 meta 行),所以这只是「在那个
152
+ * 目录开一条会话」——不切宿主的工作目录、不重启宿主、不重载页面。工作区行上那颗
153
+ * 「在此新建会话」钮走的就是这条路(早先它走切目录 + 重启宿主,整个界面会闪一下)。
154
+ * @param cwd - 绝对路径,必须存在且是目录;不合法时**抛错**(调用方提示用户)。
155
+ */
156
+ newSessionIn(cwd: string): Promise<void>;
157
+ compact(): Promise<void>;
158
+ setModel(model: string): Promise<void>;
159
+ setEffort(effort: EffortLevel): Promise<void>;
160
+ /** 异步刷新 sessions 列表(结果写回快照的 sessions/sessionsLoading)。 */
161
+ refreshSessions(): Promise<void>;
162
+ /** 归档一批会话(会话行与工作区行「归档全部」共用一条通道)。 */
163
+ archiveSessions(paths: string[]): Promise<SettingsMutation>;
164
+ /** 归档页数据(设置 → 归档;按归档时间倒序,带回收站目录与文件数)。 */
165
+ listArchivedSessions(): Promise<ArchivedPage>;
166
+ /** 用量统计(设置「用量统计」分区数据源;聚合 ~/.dsc/usage/usage.jsonl)。 */
167
+ usageStats(): Promise<UsageStatsView>;
168
+ /**
169
+ * 旁问:只读的一次性问答(不建会话、不落盘、不带工具),实现见 core/side-ask.ts。
170
+ *
171
+ * @param question 问题(≤ core/side-ask 的 SIDE_ASK_MAX_QUESTION)
172
+ * @param quote 会话里选中的原文(可省;超长由宿主截断)
173
+ * @param requestId 取消用的票据;同一张票据只能取消这一次
174
+ */
175
+ sideAsk(question: string, quote: string, requestId: string, provider: string, model: string): Promise<SideAskView>;
176
+ /** 取消一次正在进行中的旁问(票据不认识就什么都不做)。 */
177
+ sideAskCancel(requestId: string): Promise<boolean>;
178
+ /** 从归档区恢复一批会话。 */
179
+ restoreSessions(paths: string[]): Promise<SettingsMutation>;
180
+ /** 永久删除一批会话:移进 `~/.dsc/.trash/`,30 天后自动清。 */
181
+ purgeSessions(paths: string[]): Promise<SettingsMutation>;
182
+ /** 改会话显示名(写 meta.json,不动 jsonl 本体)。 */
183
+ renameSession(path: string, title: string): Promise<SettingsMutation>;
184
+ /** 置顶或取消置顶一个会话。 */
185
+ setSessionPinned(path: string, pinned: boolean): Promise<SettingsMutation>;
186
+ /** 分叉菜单的数据源:这个会话里的用户消息(数组下标就是分叉位置)。 */
187
+ listUserMessages(path: string): Promise<string[]>;
188
+ /** 分叉会话:把日志复制到第 index 条用户消息之前,返回新会话路径。 */
189
+ forkSession(path: string, index: number): Promise<SessionForkResult>;
190
+ /**
191
+ * 作废第 keep 条用户消息及其之后的内容(「编辑并重发」):留在**当前会话**里截断重来,
192
+ * 日志追加一条 `rewind` 记录(append-only,原文仍在,可回查)。
193
+ */
194
+ rewindSession(path: string, keep: number, text?: string): Promise<SettingsMutation>;
195
+ /** 侧栏界面偏好(排序方式、工作区顺序与别名)。 */
196
+ getUiPrefs(): UiPrefsView;
197
+ /** 改侧栏界面偏好(写 `~/.dsc/settings.json`)。 */
198
+ setUiPrefs(patch: Partial<UiPrefsView>): Promise<SettingsMutation>;
199
+ /** 可切换的模型列表(进程内静态,UI 可在挂载时取一次)。 */
200
+ listModels(): ModelChoiceView[];
201
+ /** 插件清单(内置 + 外部;宿主启动时扫描的快照)。 */
202
+ listPlugins(): PluginInfoView[];
203
+ /** 更新外部插件启用状态(热生效:热挂载/卸载,写 ~/.dsc/plugins.json 持久化)。 */
204
+ setPluginEnabled(file: string, enabled: boolean): void;
205
+ /** 第三方界面插件的信任状态清单(插件中心信任卡的数据源)。 */
206
+ listUiTrust(): UiTrustView[];
207
+ /** 落一条第三方界面插件的信任记录(确认动作的终点;写 plugins.json 的 uiTrust 段)。 */
208
+ setUiTrust(name: string): SettingsMutation;
209
+ /**
210
+ * 队友清单(智能体团队开着才有内容;关着返回空数组)。
211
+ * UI 在「队友」这一档开着时轮询它。
212
+ */
213
+ listTeammates(): TeammateView[];
214
+ /**
215
+ * 收掉一个队友(用户从界面上动手;等价于 `subagent` 工具的 stop)。
216
+ * 队友名字不存在时返回的那句话就是明确的错误说明,不抛错。
217
+ */
218
+ stopTeammate(name: string): Promise<string>;
219
+ /**
220
+ * 给队友投一句话(用户从界面上传话;等价于 `subagent` 工具的 message)。
221
+ * 名字不存在或话是空的,返回的那句话就是明确的错误说明,不抛错。
222
+ */
223
+ messageTeammate(name: string, text: string): Promise<string>;
224
+ /**
225
+ * 把一个收工的队友从名册移除(运行记录文件一并删除,名字随之释放)。
226
+ * 还在干活的队友会被拒绝(先停止);名字不存在时返回的那句话就是明确的错误说明,不抛错。
227
+ */
228
+ removeTeammate(name: string): Promise<string>;
229
+ /**
230
+ * 收掉一个正在跑的后台作业(`job-N`)或持久终端会话(`term-N`)——用户在状态面板
231
+ * 的「终端」区按停止时走它。等价于 `job_kill` / `terminal close` 的簿记与进程收尾,
232
+ * 但目标是我们自己的后台表,**不过审批**(与 `stopTeammate` 同一条理由:收自己起的
233
+ * 后台活不是新增动作面,是叫停)。id 不认识时返回的那句话就是明确的错误说明,不抛错。
234
+ */
235
+ stopBackground(id: string): Promise<string>;
236
+ /**
237
+ * 只读读一次后台作业 / 终端会话的输出快照(状态面板「终端」区点开输出面后按秒轮询它)。
238
+ * 与 {@link stopBackground} 同一档归属校验:只读当前查看会话起的那条;id 不认识或
239
+ * 属于别的会话时 reject(消息可直接展示)。它**不动**模型的增量读游标(见
240
+ * {@link BackgroundOutputView} 的说明)。
241
+ */
242
+ readBackground(id: string): Promise<BackgroundOutputView>;
243
+ /**
244
+ * 只读重放一个会话文件的对话条目(看队友在干什么用)。
245
+ * 它不改那个文件,也不能归档/删除/分叉——校验在 core/session.ts。
246
+ */
247
+ peekTranscript(file: string): Promise<TranscriptEntry[]>;
248
+ /**
249
+ * 技能清单(全部来源合并、重名按 rank 裁决、含被停用的条目)。
250
+ * 工作目录取当前会话的 cwd,项目级技能因此随会话变化。
251
+ */
252
+ listSkills(): SkillInfoView[];
253
+ /** 读一个技能的正文(技能中心详情用;不存在返回 ok:false)。 */
254
+ readSkill(name: string): Promise<SkillLoadResult>;
255
+ /** 启停技能(写 ~/.dsc/skills.json,下一次请求生效)。 */
256
+ setSkillEnabled(name: string, enabled: boolean): SettingsMutation;
257
+ /** 浏览技能市场(source 省略时用第一个源)。 */
258
+ browseMarket(source?: string): Promise<MarketBrowseResult>;
259
+ /** 从市场源安装一个技能到 ~/.dsc/skills/。 */
260
+ installMarketSkill(source: string, name: string): Promise<SettingsMutation>;
261
+ /** 覆盖市场源清单(写 ~/.dsc/settings.json)。 */
262
+ setMarketSources(sources: MarketSource[]): SettingsMutation;
263
+ /** 设置分区清单(内置 + 插件贡献,按 order 排序)。 */
264
+ getSettingsSections(): SettingsSectionView[];
265
+ /** 读一个分区当前控件值。 */
266
+ getSectionValues(id: string): Promise<SettingsValues>;
267
+ /** 写一个控件的值(分区自己的 save 回调校验;失败原因回 UI)。 */
268
+ setSettingValue(id: string, key: string, value: SettingsValue): Promise<SettingsMutation>;
269
+ /** 执行分区的按钮动作(返回值里的 notice 由插件给出)。 */
270
+ runSettingAction(id: string, action: string): Promise<SettingsMutation>;
271
+ /** 模型配置全貌(设置「模型」分区数据源)。 */
272
+ getModelConfig(): ModelConfigView;
273
+ /**
274
+ * 拉一个端点线上可用的模型清单(T23,设置 → 模型里「拉取清单」用)。
275
+ * 连不上或应答认不得时 reject(消息可直接展示)。
276
+ */
277
+ discoverModels(provider: string): Promise<string[]>;
278
+ /**
279
+ * 测一次端点连接(设置 → 模型里「测试连接」用):拿这个端点**真发一次**最小的
280
+ * 对话请求,走与正常对话同一条链路(同协议适配器、同一份归因头)。
281
+ *
282
+ * 与 `discoverModels` 的分工:那个只证明地址可达(GET /models),这个证明
283
+ * 「key / 模型 id / 协议 / 端点要的头」这一整套现在能用。
284
+ *
285
+ * 端点不存在、这个端点还没有模型时 reject;请求本身失败**不** reject——
286
+ * 折成 `{ ok: false, error }` 返回,界面就近展示(点一次按钮不该弹两次错)。
287
+ * `model` 缺省用「这个端点平时会用到的那个模型」。
288
+ */
289
+ testConnection(provider: string, model?: string): Promise<ConnectionTestView>;
290
+ /** 新增或编辑端点(写 config.yaml;当前会话正在用的端点同步热更新)。 */
291
+ saveProvider(draft: ProviderDraft): Promise<SettingsMutation>;
292
+ /** 删除端点(写 config.yaml;默认端点被删时自动改指第一个可用端点)。 */
293
+ removeProvider(name: string): Promise<SettingsMutation>;
294
+ /** 写入或清除端点的 API key(写 ~/.dsc/credentials.yaml 的 refs)。 */
295
+ setProviderKey(name: string, apiKey: string | null): Promise<SettingsMutation>;
296
+ /** 设为默认端点/模型(写 config.yaml 并对当前会话立即生效)。 */
297
+ setDefaultModel(provider: string, model: string): Promise<SettingsMutation>;
298
+ /**
299
+ * 换一份配置文件用(写 settings.json 的 configFile 字段,空串 = 回到出厂那份 ~/.dsc/config.yaml)。
300
+ *
301
+ * 只在原生桥开放(与 saveProvider 那三件同一先例:写类入口不进界面通道)。文件本身不动,
302
+ * 端点清单、模型编辑与后续写入全部改到这一份上;传进来的路径由设置页经系统文件对话框选,
303
+ * 宿主这边仍按「存在 + 是文件 + 能解析出 providers」三道校验把关。
304
+ */
305
+ setConfigFile(path: string): Promise<SettingsMutation>;
306
+ /** 切换权限模式(readonly / auto-edit / full-access)。 */
307
+ setPolicy(policy: ApprovalPolicy): void;
308
+ /** 切换审阅者(user = 本人点卡 / auto-review = 先给模型判官看一眼)。 */
309
+ setReviewer(reviewer: ApprovalReviewer): void;
310
+ /** 打包权限预设投影(沙箱 + 权限模式 + 审阅者三合一)。 */
311
+ listPermissionPresets(): PermissionPresetSurface;
312
+ /** 切到某个打包预设:一次写三个旋钮(沙箱 / 权限模式 / 审阅者)。 */
313
+ usePermissionPreset(name: string): SettingsMutation;
314
+ /** 设为新会话默认的打包预设(写 `~/.dsc/settings.json`)。 */
315
+ setDefaultPermissionPreset(name: string): SettingsMutation;
316
+ /** 派发一条 / 命令到宿主命令注册表(内置 + 外部插件命令统一)。 */
317
+ runCommand(input: string): boolean;
318
+ /**
319
+ * 壳 `/` 菜单的数据源:标了 `shell: true` 那批命令的元数据
320
+ * (清单单一真源在 `core/commands-completion.ts`,理由也写在那里)。
321
+ */
322
+ listUiCommands(): UiCommandView[];
323
+ /**
324
+ * 壳的 `/` 命令派发:同一条注册表(内置 + 外部插件),但只放行
325
+ * {@link DscRuntime.listUiCommands} 里那批,其余名字明确报错——界面通道与页面里的
326
+ * 第三方插件都够不着权限旋钮、写文件、落信任、退出这些动作(`runCommand` 仍不进
327
+ * 界面白名单,见 core/ui-methods.ts 的 UI_EXCLUDED)。
328
+ */
329
+ runUiCommand(input: string): boolean;
330
+ /**
331
+ * 桌面端 dock 面板的工作区能力(desktop-dock 服务透传):
332
+ * fs-list / fs-read / git-status / git-stage / git-unstage / git-commit / git-log / git-diff。
333
+ */
334
+ dock(op: string, payload?: Record<string, unknown>): Promise<unknown>;
335
+ /**
336
+ * 回答审批(四种决定;scope 语义见 ApprovalAnswer)。
337
+ * @param source - 这个答案从哪儿点下来的:省略 = 宿主界面(桌面端 / 终端),
338
+ * `'web'` = 手机浏览器(远程控制)。只影响审计记录里那一栏。
339
+ */
340
+ answerApproval(answer: ApprovalAnswer, source?: 'app' | 'web'): void;
341
+ /** 回答模型发起的提问(ask_user);文本就是答案,一批多题时按题序一次交一题。 */
342
+ answerQuestion(answer: string): void;
343
+ /** 回答计划评审卡(批准 = 切回执行模式开工);拒绝时可附反馈原话,模型按它改方案。 */
344
+ answerPlan(decision: PlanDecision, feedback?: string): void;
345
+ /** 切换协作模式(执行 / 计划 / 探索 / 免打扰),写进会话记录。 */
346
+ setMode(mode: CollaborationMode): void;
347
+ /**
348
+ * 模式(预设)投影:当前会话用的、新会话默认用的、全部可选。
349
+ * 输入框那颗模式旋钮与设置页「模式」分区都读它。
350
+ */
351
+ listPresets(): PresetSurface;
352
+ /** 读一个模式的原文(「查看配置」只读用);不存在时 ok:false 带一句话。 */
353
+ readPreset(name: string): Promise<PresetFileView>;
354
+ /** 切换当前会话的模式(写会话记录,恢复会话时一起恢复)。 */
355
+ usePreset(name: string): SettingsMutation;
356
+ /** 新建或覆盖一个模式(写 `~/.dsc/presets/<名字>.md`)。 */
357
+ savePreset(draft: PresetDraft): SettingsMutation;
358
+ /** 删掉一个自定义模式(内置四个删不掉)。 */
359
+ removePreset(name: string): SettingsMutation;
360
+ /** 设为新会话默认模式(写 `~/.dsc/settings.json`)。 */
361
+ setDefaultPreset(name: string): SettingsMutation;
362
+ /**
363
+ * 全部已注册工具(名字 / 风险 / 一行说明 / 归属模式)。
364
+ * 设置 → 模式 的工具多选读它;这也是界面第一次能看见完整工具目录。
365
+ */
366
+ listTools(): ToolEntryView[];
367
+ /** 用户侧目标动作:暂停 / 继续 / 清空 / 放宽轮次上限。 */
368
+ goalAction(action: 'pause' | 'resume' | 'clear' | 'extend'): SettingsMutation;
369
+ /** 手动清空任务清单(清单条上的小按钮)。 */
370
+ clearTodos(): void;
371
+ /** 退出应用(dispose → 进程结束)。 */
372
+ exit(): void;
373
+ /** 释放全部资源(dispose agent、退订);集成层在 ink unmount 后调用。 */
374
+ dispose(): void;
375
+ }
376
+ /**
377
+ * 一个动作的目标。两种二选一(判别字段 `type`,与 ZCode 的 target 语义一致):
378
+ * - `coordinate`:最近一张返回栅格上的整数像素(`frame_id` 用于对账是哪张图);
379
+ * - `element`:该窗口最近一次无障碍观察里的控件索引(`state_id` 用于对账是哪次观察)。
380
+ * 元素索引在该窗口的**最近一次观察**作用域内有效;元素消失必须 fail-closed(报错,绝不退化到坐标)。
381
+ */
382
+ export type DesktopTarget = {
383
+ type: 'coordinate';
384
+ x: number;
385
+ y: number;
386
+ frame_id?: string;
387
+ } | {
388
+ type: 'element';
389
+ index: number;
390
+ state_id?: string;
391
+ };
392
+ /** 一次无障碍(UIA)观察里的一个控件。 */
393
+ export interface DesktopElement {
394
+ /** 该次观察内的下标;元素作用域 = 该窗口最近一次观察。 */
395
+ index: number;
396
+ /** 控件类型(UIA ControlType,去掉 `ControlType.` 前缀,例如 Button / Edit)。 */
397
+ controlType: string;
398
+ /** 无障碍名称(按钮文案、输入框标签这类)。 */
399
+ title: string;
400
+ /** UIA AutomationId(开发者给的稳定标识,可能为空)。 */
401
+ automaid: string;
402
+ /** 控件的值(ValuePattern 可读时;否则空串)。 */
403
+ value: string;
404
+ /** 屏幕物理像素矩形;读不到时为 null。 */
405
+ bounds: {
406
+ x: number;
407
+ y: number;
408
+ width: number;
409
+ height: number;
410
+ } | null;
411
+ /** 支持的 UIA 模式名(Invoke / Toggle / SelectionItem / ExpandCollapse / Value / Scroll / RangeValue / Text)。 */
412
+ patterns: string[];
413
+ /** 是否可用(灰掉的控件为 false)。 */
414
+ enabled: boolean;
415
+ /** 是否在屏外(最小化/滚动出视口)。 */
416
+ offscreen: boolean;
417
+ }
418
+ /** 观察绑定的窗口。 */
419
+ export interface DesktopWindowRef {
420
+ /** 顶层窗口句柄(list_windows 里的 window_id 就是它)。 */
421
+ id: number;
422
+ title: string;
423
+ bounds: {
424
+ x: number;
425
+ y: number;
426
+ width: number;
427
+ height: number;
428
+ } | null;
429
+ }
430
+ /** 一次无障碍观察的完整结果。 */
431
+ export interface DesktopFrame {
432
+ /** 这次观察的编号(element 目标的 state_id 对账用)。 */
433
+ state_id: string;
434
+ /** 窗口归属进程名。 */
435
+ app: string;
436
+ window: DesktopWindowRef;
437
+ /** 观察到的控件(按遍历顺序,index 与数组下标一致)。 */
438
+ elements: DesktopElement[];
439
+ /** 文本树(缩进的 `[index] ControlType "title" = "value"` 行)。 */
440
+ text: string;
441
+ /** full = 全树;diff = 相对 base_state_id 的增量。 */
442
+ snapshot_mode: 'full' | 'diff';
443
+ /** diff 模式下的基线观察编号。 */
444
+ base_state_id?: string;
445
+ /** diff 模式的增量结论(索引仍按基线有效)。 */
446
+ diff?: {
447
+ removed: number[];
448
+ added: number[];
449
+ changed: number[];
450
+ };
451
+ }
452
+ /** 电脑操作的危险分级:只读观察 / 输入动作 / 系统级动作。 */
453
+ export type DesktopRiskTier = 'read' | 'input' | 'system';
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,189 @@
1
+ /**
2
+ * 契约分域:task
3
+ *
4
+ * 从 `src/contract.ts` 拆出来的一个域(纯搬移,逐字未改)。调用方照旧 import
5
+ * `../contract.js`——那份文件现在只做转出,导出面一个没少。
6
+ *
7
+ * @module dsc/contract/task
8
+ */
9
+ /**
10
+ * 任务清单条目的状态。
11
+ * core/todo.ts 直接用它(不再另写一遍四个字符串),界面与存储因此不可能各说一套。
12
+ */
13
+ export type TodoStatus = 'pending' | 'in_progress' | 'completed' | 'cancelled';
14
+ /** 任务清单里的一条(界面渲染用;正文已被截到 300 字以内)。 */
15
+ export interface TodoItemView {
16
+ id: string;
17
+ content: string;
18
+ status: TodoStatus;
19
+ /** 父任务 id;有值表示它是上一条的子任务,界面缩进一级。 */
20
+ parent?: string;
21
+ }
22
+ /** 任务清单投影:整表 + 版本号 + 进度,界面靠 revision 丢掉过期帧。 */
23
+ export interface TodoView {
24
+ items: TodoItemView[];
25
+ revision: number;
26
+ /** 已完成数(cancelled 不计入分母)。 */
27
+ done: number;
28
+ /** 有效任务总数。 */
29
+ total: number;
30
+ /** 当前在做的那条正文(清单条上直接显示)。 */
31
+ active: string | null;
32
+ }
33
+ /** 计划评审卡的状态。 */
34
+ export type PlanDecision = 'pending' | 'approved' | 'rejected';
35
+ /** 一份待批的计划。 */
36
+ export interface PlanView {
37
+ /** 计划落盘的文件(相对工作目录显示由界面决定)。 */
38
+ file: string;
39
+ title: string;
40
+ /** 计划全文(markdown)。 */
41
+ text: string;
42
+ /** 用户批没批;pending = 评审卡还挂着。 */
43
+ decision: PlanDecision;
44
+ }
45
+ /**
46
+ * 一张「提交过的计划」的目录项(状态面板的「计划」区)。
47
+ *
48
+ * 与 {@link PlanView} 的区别:PlanView 是**正挂着等批**的那一张(含全文),
49
+ * 这份只是目录里的一行读数。dsc 的计划在提交时就落盘(`.dsc/plans/`),
50
+ * 条目只是「哪份文件、什么标题」的账——这份账按会话记(见 {@link PlanHistoryItem}),
51
+ * 面板只列本会话提交过的计划(与参考实现「计划目录 = 会话自己的终态计划」同一口径)。
52
+ */
53
+ export interface PlanEntryView {
54
+ /** 计划文件的绝对路径(点一行在右侧栏打开它)。 */
55
+ file: string;
56
+ /** 计划标题(提交时从正文首个 # 标题算好)。 */
57
+ title: string;
58
+ /** 提交时刻(目录按它倒序)。 */
59
+ at: number;
60
+ }
61
+ /**
62
+ * 会话计划目录里的一条账(plan 插件的 `plans` 状态条目的元素)。
63
+ *
64
+ * 为什么要这份账:面板的「计划」区只出**本会话**提交过的计划(对齐参考实现:
65
+ * 计划目录是会话投影里的终态计划行,切会话互不可见)。文件系统里的 `.dsc/plans/`
66
+ * 是所有会话共享的回看口、没有归属信息,扫盘分不出谁的——归属只能记在会话自己
67
+ * 的日志里(appendState 追加进 jsonl,跨重启都在)。
68
+ */
69
+ export interface PlanHistoryItem extends PlanEntryView {
70
+ /** 这份计划的评审结果(落账用;面板行不显示——参考实现的面板行同样只有标题)。 */
71
+ decision: PlanDecision;
72
+ }
73
+ /**
74
+ * 一项正在跑的后台工作(状态面板的「终端」区):后台作业或持久终端会话。
75
+ *
76
+ * 只出**运行中**的,且只出**当前查看会话**起的那些(对齐参考实现:后台工作清单
77
+ * 挂在会话快照上、按会话寻址,切会话互不可见)。收工的由通知与台账负责,
78
+ * 面板不摆历史。
79
+ */
80
+ export interface BackgroundWorkView {
81
+ /** 作业 id(job-N)/ 终端会话 id(term-N)。 */
82
+ id: string;
83
+ kind: 'job' | 'terminal';
84
+ /** 行上的标题:作业 = 命令首行;终端 = 最近发进去的一条命令。 */
85
+ title: string;
86
+ startedAt: number;
87
+ }
88
+ /**
89
+ * 一条后台活输出的**只读快照**(状态面板「终端」区点开的那一页)。
90
+ *
91
+ * 形状对准 core/tools/bash.ts 的 `JobOutputView` / `TerminalOutputView`(两者同族),
92
+ * 只保留界面要画的那几个字段。口径与「模型的读口」分开:这是**尾部窗口快照**,
93
+ * 不动模型的增量读游标(见 `JobTable.peek` 的说明),所以界面按秒轮询不会把模型
94
+ * 该读到的输出吃掉。
95
+ *
96
+ * 头部丢字要能报出来(对照参考实现的 `truncated` / `outputPath`):缓冲是环形的,
97
+ * 超上限时从头部丢;`droppedChars > 0` 就说明现在看到的开头已经不是最初那个开头,
98
+ * 界面据此显示一条「头部已丢弃 N 字符」的提示。
99
+ */
100
+ export interface BackgroundOutputView {
101
+ /** 作业 / 终端会话 id(与 {@link BackgroundWorkView.id} 同口径)。 */
102
+ id: string;
103
+ kind: 'job' | 'terminal';
104
+ /** 运行状态:作业 running/completed/failed/killed;终端 running/closed。 */
105
+ status: string;
106
+ /** 这次快照给到的文本(已遮红)。 */
107
+ text: string;
108
+ /** 输出绝对总长(含已丢弃头部)。 */
109
+ totalChars: number;
110
+ /** 这次快照文本的绝对起点。 */
111
+ from: number;
112
+ /** 头部被环形缓冲丢掉的字符数;0 = 从头都在。 */
113
+ droppedChars: number;
114
+ /** true = 这次快照已经追上现存输出的末尾(在跑的活会继续长)。 */
115
+ atEnd: boolean;
116
+ }
117
+ /**
118
+ * 一条定点任务(状态面板的「工作流」区;schedule 插件贡献)。
119
+ *
120
+ * dsc 没有工作流引擎,这一区绑的是最接近的「按规则自动跑一轮」——定时任务。
121
+ * 插件默认关着,关着时这份投影整个缺席(界面按空处理,整区不渲染)。
122
+ */
123
+ export interface ScheduledTaskView {
124
+ id: string;
125
+ title: string;
126
+ enabled: boolean;
127
+ /** 下一次该跑的绝对时刻;null = 不再跑(一次性任务已跑过 / 还没排期)。 */
128
+ nextRunAt: number | null;
129
+ /** 最近一次执行结果:never / running / ok / failed / blocked / skipped / done。 */
130
+ lastStatus: string;
131
+ /** 最近一次失败 / 阻塞的原因原文(行上的提示词用它)。 */
132
+ lastError: string | null;
133
+ }
134
+ /**
135
+ * 目标阶段。
136
+ * `core/goal.ts` 直接 import 这个类型(那里只留别名),界面与存储因此共用一份声明。
137
+ */
138
+ export type GoalPhaseView = 'active' | 'paused' | 'blocked' | 'complete';
139
+ /** 会话目标投影(界面顶部那条 goal 条的数据源)。 */
140
+ export interface GoalView {
141
+ objective: string;
142
+ phase: GoalPhaseView;
143
+ rounds: number;
144
+ maxRounds: number;
145
+ /** phase=blocked 时说明卡在哪。 */
146
+ blockedReason?: string;
147
+ /** 自动续跑开关(进程本地;重启后为 false)。 */
148
+ armed: boolean;
149
+ }
150
+ /** 模型问用户的一个问题(ask_user 工具的数据)。 */
151
+ export interface AskOptionView {
152
+ label: string;
153
+ description?: string;
154
+ }
155
+ /**
156
+ * 一批提问里的一题:字段与单题视图完全相同,只是没有 `id`——
157
+ * 题目在自己那一批里的位置就是它的标识。
158
+ */
159
+ export interface AskQuestionItem {
160
+ question: string;
161
+ header?: string;
162
+ options: AskOptionView[];
163
+ multiSelect: boolean;
164
+ /** 「其他」自由输入是否允许。 */
165
+ allowFreeText: boolean;
166
+ }
167
+ /**
168
+ * 模型发起的一次提问;界面渲染成带按钮的卡片,答案回给模型。
169
+ *
170
+ * 一次提问可以带好几题:`questions` 有内容时界面按「一张卡列出全部题目」渲染
171
+ * (逐题作答、统一提交,一次调用把全部答案交回);界面不认 `questions` 时
172
+ * 就退回下面那几个单题字段,仍然能渲染出第 1 题。
173
+ *
174
+ * 单题字段因此是「第 1 题的投影」,和 `questions[0]` 必须同源:
175
+ * 老会话回放里存下的单题视图没有 `questions`,也不需要迁移。
176
+ */
177
+ export interface AskUserView {
178
+ id: string;
179
+ question: string;
180
+ header?: string;
181
+ options: AskOptionView[];
182
+ multiSelect: boolean;
183
+ /** 「其他」自由输入是否允许。 */
184
+ allowFreeText: boolean;
185
+ /** 这一批的全部题目(含第 1 题);单题提问可以不写,写了就必须与单题字段一致。 */
186
+ questions?: AskQuestionItem[];
187
+ }
188
+ /** 提一个单题提问的入参:`id` 由服务发,`questions` 由服务按这一题的字段补出来。 */
189
+ export type AskUserViewInput = Omit<AskUserView, 'id' | 'questions'>;
@@ -0,0 +1,10 @@
1
+ /**
2
+ * 契约分域:task
3
+ *
4
+ * 从 `src/contract.ts` 拆出来的一个域(纯搬移,逐字未改)。调用方照旧 import
5
+ * `../contract.js`——那份文件现在只做转出,导出面一个没少。
6
+ *
7
+ * @module dsc/contract/task
8
+ */
9
+ // @@imports@@
10
+ export {};