@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,358 @@
1
+ /**
2
+ * 契约分域:transcript
3
+ *
4
+ * 从 `src/contract.ts` 拆出来的一个域(纯搬移,逐字未改)。调用方照旧 import
5
+ * `../contract.js`——那份文件现在只做转出,导出面一个没少。
6
+ *
7
+ * @module dsc/contract/transcript
8
+ */
9
+ import type { UserFileAttachment } from '../core/attachments.js';
10
+ import type { PlanView } from './task.js';
11
+ /**
12
+ * 一次工具调用的展示状态。
13
+ *
14
+ * `preparing` = 模型已经开始吐这个工具的名字、参数还没到齐(对照 dsh 的 `preparing` 阶段)。
15
+ * 那一行不解析参数、不可展开,只是告诉用户「接下来要干这件事」。它随后会被升级成 `running`。
16
+ */
17
+ export type ToolStatus = 'preparing' | 'running' | 'done' | 'failed' | 'rejected';
18
+ /** 工具卡片视图:参数原文 +(完成后的)结果摘要。 */
19
+ export interface ToolCallView {
20
+ callId: string;
21
+ name: string;
22
+ /** 模型产出的原始 arguments JSON 字符串(截断由 UI 决定)。 */
23
+ argsText: string;
24
+ /** 工具结果文本(可能为空:无结果或尚未完成)。 */
25
+ resultText?: string;
26
+ status: ToolStatus;
27
+ /**
28
+ * 这次调用发起的时刻(epoch ms):宿主收到 `tool/call` 那一刻。
29
+ *
30
+ * 为什么不复用条目上的 `ts`:`ts` 的口径是「这条条目最后一次被写入的时刻」,
31
+ * 拿到结果时会被刷成结果时刻(见 adapter/transcript.ts 的 `tool/result` 分支),
32
+ * 光凭它算不出这次调用从头到尾花了多久。发起时刻因此单独存一份,只写一次不再改。
33
+ *
34
+ * 为什么是可选的:2026-09 之前的会话日志没记时间,重放老会话时拿不到——
35
+ * 界面据此不显示耗时,绝不拿「现在」冒充历史时刻。
36
+ */
37
+ startedAt?: number;
38
+ /**
39
+ * 这次调用从发起到结果回来花掉的毫秒数(结果到达时刻 − `startedAt`)。
40
+ *
41
+ * 口径:`done` / `failed` / `rejected` 一视同仁都算——跑挂了、被审批拒掉、用户中途
42
+ * 打断的工具调用同样占用了这段时间,轨迹页的时间线要如实显示。只有还停在 `running`
43
+ * (结果没回来)时才没有这个数。
44
+ *
45
+ * 为什么是可选的:① 老会话没有 `startedAt`,算不出来;② 日志时间乱序(手改过、
46
+ * 跨机器拷过)导致结果时刻早于发起时刻时也不写——宁可让界面不显示,也不编一个 0 秒。
47
+ */
48
+ durationMs?: number;
49
+ /**
50
+ * 这次调用对文件的**实际改动**(write / edit 成功落盘后才有):与轮尾「文件已更改」
51
+ * 卡同一份数据(`tool/changes` 事件里那个 `change`,形状就是 {@link ChangedFileView})。
52
+ *
53
+ * 为什么挂到工具卡上:卡上的文件名现在要能点开**这一刀改了什么**的补丁视图
54
+ * (diff-viewer 那条路),而逐刀改动原本只以独立 `changes` 条目存在、与调用对不上号。
55
+ * 这里按 callId 缝回去,工具卡读 `call.change` 即可,不必再去猜条目间的对应关系。
56
+ * 执行失败、或还在跑没有结果时没有这一项。
57
+ */
58
+ change?: ChangedFileView;
59
+ /**
60
+ * 这次调用带给界面的**卡片数据**(dsh 插件才有)。
61
+ *
62
+ * dsh 的工具用 presentCall / presentResult 声明怎么画自己的卡(六种:generic /
63
+ * terminal / diff / search / read / web,字段见 `core/dsh-compat/presentation.ts`),
64
+ * 兼容层把产物原样带进来。界面按 `card` 标签挑形态,**认不出来的回落通用工具卡**
65
+ * (数据不丢,只是没画成专用形态)。Pneuma 自己的工具没有这一项。
66
+ */
67
+ presentation?: ToolPresentationView;
68
+ }
69
+ /** 一张卡片视图的界面镜像(字段宽收:认得 `card` 就够挑形态了)。 */
70
+ export interface ToolPresentationView {
71
+ /** 调用阶段的卡片。 */
72
+ call?: {
73
+ card: string;
74
+ } & Record<string, unknown>;
75
+ /** 完成阶段的卡片。 */
76
+ result?: {
77
+ card: string;
78
+ } & Record<string, unknown>;
79
+ /** 可重放的展示投影(与值无关的纯数据)。 */
80
+ meta?: unknown;
81
+ }
82
+ /**
83
+ * 压缩落点标记:条目带上它,就说明「从这一刻起,模型看到的历史已经是压缩后的」。
84
+ * 轨迹页据此把压缩历史渲染成独立区段(对照 dsh 的 Between turns),不必去猜正文。
85
+ *
86
+ * `count` = 本会话累计到这一条为止发生过的压缩次数(也就是「第几次压缩」),1 基。
87
+ * 为什么用次数而不是「折进去多少条消息」:实时路径算得出条数,但会话日志里只记了
88
+ * 保留了多少条(见 core/session.ts 的 `replaceWithSummary`,只写 `keep`),重放时
89
+ * 反推不回来——同一个字段两条路径给不出同一个口径,索性不带。
90
+ *
91
+ * 压缩有两个落点,各自留在原本的 kind 上:
92
+ * - 实时:compact 插件经 `dsc/notice(text, 'compaction')` 写下的 **system** 条目;
93
+ * - 重放:摘要自己在内存里就是一条 `role: 'user'` 的消息(core/compact.ts 造的),
94
+ * 正文固定以 `SUMMARY_BANNER` 开头,adapter 靠这个前缀把它认出来,仍是 **user** 条目。
95
+ * 没有换成专属 kind,是因为「对话」页现在把摘要当用户气泡渲染——换 kind 会让摘要
96
+ * 正文当场从对话页和终端界面消失。
97
+ *
98
+ * 老会话(日志里只有那条摘要消息)重放照样认得出,只是日志里只留最后一条摘要
99
+ * (core/session.ts 的 `case 'summary'` 会把更早的记录换掉),所以重放路径的 `count`
100
+ * 永远是 1。
101
+ */
102
+ export interface CompactionMark {
103
+ /** 本会话里这是第几次压缩,1 基。 */
104
+ count: number;
105
+ }
106
+ /**
107
+ * 会话流里的一条可渲染条目。adapter 把 session/event 折叠成这个序列,
108
+ * UI 只读消费;`id` 单调递增、仅在本会话生命周期内唯一。
109
+ *
110
+ * 每个条目都可以带 `ts`:毫秒 epoch,含义是「这条条目最后一次被写入的时刻」
111
+ * (用户条目就是发消息那一刻,工具卡是最后一次更新那一刻)。界面按它显示
112
+ * 「这条消息几点发的」「这一轮花了多久」。
113
+ *
114
+ * 为什么是可选的:2026-09 之前的会话日志里没有这个字段,重放老会话时拿不到时间。
115
+ * 那时候界面降级为不显示时间与用时——绝不拿「现在」冒充历史时刻,也不显示 NaN。
116
+ *
117
+ * text / tool 条目还可以带 `usage`:从最近一条 user 条目算起,**这一轮**每一次模型
118
+ * 请求的 prompt_tokens(含系统提示词与全部上下文)与 completion_tokens 全部累加之和。
119
+ * 多步工具轮每次请求都重发整份上下文,所以这个和就是本轮的 API 真实计费量,
120
+ * 而不是按正文字数估出来的。
121
+ * 同一轮里靠前的条目挂的是「到那一刻为止」的累计,界面取轮内最后一条就是整轮真值。
122
+ * 为什么是可选的:① 一次用量事件都没上报过(没有 usage 事件的老会话)时没有这个数;
123
+ * ② 重放历史日志造不出这个数——会话日志只存消息,不存每次请求的用量。
124
+ */
125
+ export type TranscriptEntry =
126
+ /**
127
+ * images 是图片引用(`/api/attachments/<sha>`,老会话是 data URL);界面渲染成缩略图。
128
+ * files 是视频 / 通用文件的落盘元数据;界面画文件卡,模型侧看到的是拼进正文的路径句柄。
129
+ * `compaction` 只出现在重放出来的压缩摘要上(见 {@link CompactionMark})。
130
+ * `steering` = 这条消息是在助手回合**还没跑完**时插进来的(对照 dsh 的 steering 节点)。
131
+ * `internal` = 这条消息不是人打的字,是运行时投递进来的(目前只有队友干完活的
132
+ * `<teammate-report>` 汇报)。模型照常看得到全文,界面不拿它当用户气泡渲染——
133
+ * 对话页把它画成一行「子任务状态更新」(对照 dsh 的 turn-trigger 节点:
134
+ * TurnTriggerNodeView 默认收起,展开才看得到通知正文)。
135
+ */
136
+ {
137
+ kind: 'user';
138
+ id: number;
139
+ text: string;
140
+ images?: string[];
141
+ files?: UserFileAttachment[];
142
+ ts?: number;
143
+ compaction?: CompactionMark;
144
+ steering?: boolean;
145
+ internal?: boolean;
146
+ }
147
+ /**
148
+ * durationMs 是这段思考从第一口 reasoning delta 到定稿的耗时(≥1s 界面才显示)。
149
+ * 为什么可选:重放历史日志造不出它(日志只存定稿文本),老会话回看就降级不显示。
150
+ */
151
+ | {
152
+ kind: 'thinking';
153
+ id: number;
154
+ text: string;
155
+ ts?: number;
156
+ durationMs?: number;
157
+ }
158
+ /**
159
+ * 子代理内联卡(实时条目,不落盘):队友在跑的时候长在转录里,收工折成一行头。
160
+ * 由 subagent 插件把队友的事件流转成 SubagentCardView 推进来(dsc/subagent 事件),
161
+ * 同名原位更新(React key 不换,卡片就地刷新)。
162
+ */
163
+ | {
164
+ kind: 'subagent';
165
+ id: number;
166
+ sub: SubagentCardView;
167
+ ts?: number;
168
+ }
169
+ /** usage 是整轮累计口径,见本类型头部的说明。 */
170
+ | {
171
+ kind: 'text';
172
+ id: number;
173
+ text: string;
174
+ ts?: number;
175
+ usage?: {
176
+ inputTokens: number;
177
+ outputTokens: number;
178
+ };
179
+ }
180
+ /** usage 同上(一轮以工具结果收尾、没有最终正文时,数字落在这张卡上)。 */
181
+ | {
182
+ kind: 'tool';
183
+ id: number;
184
+ call: ToolCallView;
185
+ ts?: number;
186
+ usage?: {
187
+ inputTokens: number;
188
+ outputTokens: number;
189
+ };
190
+ }
191
+ /** 计划卡:exit_plan_mode 交上来的计划,带用户批没批。 */
192
+ | {
193
+ kind: 'plan';
194
+ id: number;
195
+ plan: PlanView;
196
+ ts?: number;
197
+ }
198
+ /**
199
+ * `compaction` 只出现在压缩插件写下的那条通知上(见 {@link CompactionMark})。
200
+ *
201
+ * `level: 'error'` 表示这条是**要人处理**的启动/运行问题(没有可用的模型端点、插件加载失败),
202
+ * 界面把它从首屏的注脚里摘出来、改成一次弹窗;缺省(连同 `'info'`)只进日志与轨迹,不占首屏。
203
+ */
204
+ | {
205
+ kind: 'system';
206
+ id: number;
207
+ text: string;
208
+ ts?: number;
209
+ compaction?: CompactionMark;
210
+ level?: 'info' | 'error';
211
+ /**
212
+ * 来自输入框 `/` 命令的输出(`/help`、`/status`…)。
213
+ *
214
+ * 为什么要这个位:壳的「空会话欢迎态」会把首屏的 system 条目整批不画
215
+ * (只留写前预览卡),于是新会话里打第一条命令什么也看不到(2026-10-27 查账)。
216
+ * 命令输出属于用户主动要的东西,必须上屏;启动机位那种通知仍保持安静。
217
+ */
218
+ command?: boolean;
219
+ }
220
+ /** 轮尾标记:这一轮为什么结束,见 {@link TurnEndReason}。 */
221
+ | {
222
+ kind: 'turn-end';
223
+ id: number;
224
+ reason: TurnEndReason;
225
+ ts?: number;
226
+ }
227
+ /** 这一轮的输出撞上了长度上限(对照 dsh 的 `turn-max-tokens` 节点)。 */
228
+ | {
229
+ kind: 'turn-max-tokens';
230
+ id: number;
231
+ ts?: number;
232
+ }
233
+ /**
234
+ * 模型这次请求失败、正在重试(对照 dsh 的 `model-retry` 节点)。
235
+ *
236
+ * 它是二级分组的**边界**(前后两段过程被它切开),但**不属于**整轮折叠要放过的那些
237
+ * 独立节点——dsh 的规矩是「二级分组把模型重试视为分隔节点,但整轮折叠仍包含重试行」。
238
+ */
239
+ | {
240
+ kind: 'model-retry';
241
+ id: number;
242
+ attempt: number;
243
+ text: string;
244
+ ts?: number;
245
+ }
246
+ /**
247
+ * 一次成功的 write / edit 落盘后的实际改动(对照 dsh deliverables 的 produced 文件)。
248
+ * 界面把同一轮里的这些条目聚合成轮尾一张「文件已更改」卡;`hunks` 是算好的
249
+ * unified 差异段(结构见 {@link DiffHunkView}),审查面板直接渲染。
250
+ */
251
+ | {
252
+ kind: 'changes';
253
+ id: number;
254
+ file: ChangedFileView;
255
+ ts?: number;
256
+ }
257
+ /**
258
+ * 回合收尾的聚合改动(codex `turn/diff/updated` 的同位条目):本回合动过的每个文件
259
+ * 一份「回合基线 vs 盘上终态」的差异,同文件多刀合一。纯内存条目——不落 jsonl,
260
+ * 重启恢复后界面回退逐刀合并显示(`kind: 'changes'` 照常重放)。
261
+ */
262
+ | {
263
+ kind: 'turnDiff';
264
+ id: number;
265
+ files: ChangedFileView[];
266
+ ts?: number;
267
+ };
268
+ /**
269
+ * 一轮对话为什么结束(口径就是宿主 `turn/end` 事件的 reason,见 core/events.ts)。
270
+ *
271
+ * 为什么要有它:dsh 的整轮折叠有一条规矩——**中断或失败的轮不折整轮**,开关行还要把
272
+ * 「已停止 / 过程失败」显示出来(`contract/turn-process.ts` 的 `turnProcessAlwaysOpen`
273
+ * 与 `chat/TurnProcessNodeView.tsx:26-28`)。dsc 的宿主一直知道这个原因,只是 adapter
274
+ * 从事件折条目时把它丢了,于是界面上「跑挂了的一轮」和「好好答完的一轮」长得一模一样。
275
+ */
276
+ export type TurnEndReason = 'completed' | 'aborted' | 'error';
277
+ /**
278
+ * 子代理内联卡的数据(dsh SubagentMessage 同位物):头行「状态点 + 任务 + 轮数/工具数/
279
+ * 耗时/token + 状态词」,跑动时再加当前工具行与输出瀑布。数据是插件侧的实时快照,
280
+ * 每次事件整体替换。
281
+ */
282
+ export interface SubagentCardView {
283
+ /** 队友名(同会话内唯一,卡片按它原位更新)。 */
284
+ name: string;
285
+ /** 角色名(工牌冻结的那份)。 */
286
+ role: string;
287
+ /** 派给它的任务原文(界面自己截断)。 */
288
+ task: string;
289
+ /** 运行状态;`idle` = 正常收工,`stopped` = 被打断,`failed` = 过程失败。 */
290
+ state: 'working' | 'idle' | 'failed' | 'stopped';
291
+ /** 用的模型(`端点/模型`;跟随主会话模型时填当时的模型)。 */
292
+ model?: string;
293
+ /** 已发起的模型请求轮数。 */
294
+ rounds: number;
295
+ /** 已执行的工具调用次数。 */
296
+ toolCalls: number;
297
+ /** 开工时刻(毫秒 epoch;名册种子卡才有,实时转发必有)。 */
298
+ startedAt?: number;
299
+ /** 收工时刻;还在跑就没有。 */
300
+ finishedAt?: number;
301
+ /** 当前(或最后一把)工具:跑动时画「当前工具行」。 */
302
+ lastTool?: {
303
+ name: string;
304
+ args: string;
305
+ status: 'running' | 'done' | 'failed';
306
+ };
307
+ /** 输出瀑布的行池(最新在后;界面只取最后几行,每行硬截单行宽)。 */
308
+ outputLines?: string[];
309
+ /** 累计 token(输入+输出,端点真值;一次都没回过用量时缺省)。 */
310
+ tokens?: number;
311
+ /** 过程失败的原因(state=failed 时界面画一条错误行)。 */
312
+ error?: string;
313
+ /** 队友会话的 jsonl 路径(点卡片开只读转录浮层)。 */
314
+ file?: string;
315
+ }
316
+ /** context 条按内容类型的分段(token 估算值,只描述占用段的颜色组成)。 */
317
+ export interface ContextSegmentsView {
318
+ system: number;
319
+ prompt: number;
320
+ assistant: number;
321
+ thinking: number;
322
+ /** 工具**结果**(tool 消息正文)。 */
323
+ tools: number;
324
+ /** 工具**定义**(每次请求携带的 schema 文本)。老宿主不推这一项,界面按 0 处理。 */
325
+ schema?: number;
326
+ }
327
+ /** 差异里的一行(与 core/diff-text.ts 的 DiffLine 同构,视图层零宿主依赖)。 */
328
+ export interface DiffLineView {
329
+ kind: 'context' | 'remove' | 'add';
330
+ text: string;
331
+ /** 这一行在旧文件里的行号;`add` 行为 null。 */
332
+ oldLine: number | null;
333
+ /** 这一行在新文件里的行号;`remove` 行为 null。 */
334
+ newLine: number | null;
335
+ }
336
+ /** 一段 hunk:`@@ -oldStart,oldCount +newStart,newCount @@` 加上它包含的行(同构 DiffHunk)。 */
337
+ export interface DiffHunkView {
338
+ oldStart: number;
339
+ oldCount: number;
340
+ newStart: number;
341
+ newCount: number;
342
+ lines: DiffLineView[];
343
+ }
344
+ /** 一次成功的 write / edit 的实际改动(轮尾「文件已更改」卡与审查面板的数据)。 */
345
+ export interface ChangedFileView {
346
+ /** 文件的绝对路径(打开预览用)。 */
347
+ path: string;
348
+ /** 新增行数。 */
349
+ added: number;
350
+ /** 删除行数。 */
351
+ removed: number;
352
+ /** 算好的 unified 差异段;审查面板直接渲染,不再碰文件系统。 */
353
+ hunks: DiffHunkView[];
354
+ /** true = hunks 超过行数上限被砍过(面板据此提示「只显示前一部分」)。 */
355
+ truncated?: boolean;
356
+ /** `added` = 新建文件(改前不存在);`modified` = 改已有文件。 */
357
+ status: 'added' | 'modified';
358
+ }
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,132 @@
1
+ /**
2
+ * 契约分域:usage
3
+ *
4
+ * 从 `src/contract.ts` 拆出来的一个域(纯搬移,逐字未改)。调用方照旧 import
5
+ * `../contract.js`——那份文件现在只做转出,导出面一个没少。
6
+ *
7
+ * @module dsc/contract/usage
8
+ */
9
+ /**
10
+ * 会话累计 token 用量。
11
+ * 缓存命中两项只在端点上报过明细的请求上累计(命中率 = 命中 /(命中 + 未命中)),
12
+ * 没上报明细的请求既不加命中也不加未命中——命中率才不会被稀释(口径与 usage-log 一致)。
13
+ */
14
+ export interface TokenUsageView {
15
+ inputTokens: number;
16
+ outputTokens: number;
17
+ /** 输入里的前缀缓存命中 tokens 合计;端点从未上报过明细时缺省。 */
18
+ cacheHitTokens?: number;
19
+ /** 输入里的前缀缓存未命中 tokens 合计;同上。 */
20
+ cacheMissTokens?: number;
21
+ }
22
+ /** 用量统计的单日投影(本地时区的自然日)。 */
23
+ export interface UsageDayView {
24
+ /** 本地时区的 YYYY-MM-DD。 */
25
+ date: string;
26
+ inputTokens: number;
27
+ outputTokens: number;
28
+ /** 这一天的模型请求轮数。 */
29
+ turns: number;
30
+ /** 按 `provider/model` 拆分的 token 总量(输入+输出)。 */
31
+ byModel: Record<string, number>;
32
+ /**
33
+ * 这一天的估算花费(人民币元,按 DeepSeek 官方单价换算)。
34
+ *
35
+ * 只有至少一笔记录能计价(provider 是 DeepSeek、模型在价目表里)时才有值;
36
+ * 零日、以及用别家端点的日子都没有这一项——缺省表示「算不出来」,不是「花了 0 元」。
37
+ */
38
+ costCny?: number;
39
+ }
40
+ /** 一个模型的用量汇总。 */
41
+ export interface UsageModelView {
42
+ /** `provider/model`,与 daily byModel 的键一致。 */
43
+ key: string;
44
+ inputTokens: number;
45
+ outputTokens: number;
46
+ turns: number;
47
+ /** 输入里的前缀缓存命中 / 未命中 tokens(端点没上报这项的记录按 0 计)。 */
48
+ cacheHitTokens: number;
49
+ cacheMissTokens: number;
50
+ }
51
+ /**
52
+ * 用量统计(设置「用量统计」分区数据源)。
53
+ * 宿主从 `~/.dsc/usage/usage.jsonl`(每次模型请求追加一条)聚合而来;
54
+ * 这份日志从该功能上线那刻开始积累,更早的会话没有记录。
55
+ */
56
+ export interface SideAskView {
57
+ text: string;
58
+ model: string;
59
+ ms: number;
60
+ /** true = 用户按了停止(text 是半截)。 */
61
+ stopped: boolean;
62
+ }
63
+ export interface UsageStatsView {
64
+ /** 最早一条记录的时间戳;一条都没有时 null。 */
65
+ sinceTs: number | null;
66
+ totalInputTokens: number;
67
+ totalOutputTokens: number;
68
+ /**
69
+ * 输入里的前缀缓存命中 / 未命中 tokens 合计(2026-10-03 起记录;更早的行没有这项,
70
+ * 按 0 计)。两个数都只统计端点上报了明细的请求,命中率 = 前者 /(前者 + 后者)。
71
+ */
72
+ totalCacheHitTokens: number;
73
+ totalCacheMissTokens: number;
74
+ totalTurns: number;
75
+ /** 有记录的自然日数。 */
76
+ activeDays: number;
77
+ /** 当前连续活跃天数(今天没活动就从昨天起算)。 */
78
+ currentStreakDays: number;
79
+ longestStreakDays: number;
80
+ /** 单日 token 总量最高的那天;还没有记录时 null。 */
81
+ peakDay: UsageDayView | null;
82
+ /** 首条记录所在日到今天(含零日)的逐日投影,按日期升序;跨度封顶 370 天。 */
83
+ days: UsageDayView[];
84
+ /** 按模型汇总,总量降序。 */
85
+ models: UsageModelView[];
86
+ /** 全部记录的估算花费合计(人民币元);一笔都算不出来时缺省。 */
87
+ totalCostCny?: number;
88
+ }
89
+ /**
90
+ * 单条会话的用量与耗时投影:壳进程读 `~/.dsc/usage/usage.jsonl` 后按会话 id 汇总
91
+ * (折叠口径的唯一原件在 core/usage-log.ts 的 readSessionUsage,宿主与壳进程共用)。
92
+ *
93
+ * 为什么由壳进程读文件、而不是问宿主:这份日志本来就是纯数据文件,读它只多一次 IO,
94
+ * 宿主忙着跑回合或正在重启时这段读数照样在。
95
+ */
96
+ export interface SessionUsageView {
97
+ /** 这个会话的模型请求条数(含切到本进程之前的历史请求)。 */
98
+ requests: number;
99
+ inputTokens: number;
100
+ outputTokens: number;
101
+ /**
102
+ * 前缀缓存读取(日志的 ch)与未缓存输入(日志的 cm)。
103
+ *
104
+ * 只有 0.6.46 起、且服务端真回了缓存明细的请求进这两个数:老行没有这两栏,
105
+ * 把它们塞进分母会把命中率算低——宁缺不假(与设置页「前缀缓存命中」同口径)。
106
+ */
107
+ cacheHitTokens: number;
108
+ cacheMissTokens: number;
109
+ /**
110
+ * 最后一次请求的输入 token:每次请求都会重发完整上下文,
111
+ * 所以这就是此刻的上下文占用(服务端真值,不是估算)。
112
+ */
113
+ lastInputTokens: number;
114
+ /** 最后一次请求落盘的时刻(毫秒);没有时间戳的行记 0。 */
115
+ lastAt: number;
116
+ /**
117
+ * 这一步的墙钟读数(毫秒,日志的 lm/ft/d,0.6.67 起;口径见 core/throughput.ts):
118
+ * `llmMs` 发出 → 定稿、`ttftMs` 首字延迟(配 `ttftSteps` 算平均)、
119
+ * `decodeMs` 纯解码时间、`decodeTokens` 与它成对的那批请求的输出 token。
120
+ *
121
+ * 输出速度 = decodeTokens ÷ (decodeMs / 1000),整个会话累计——不是「本轮」。
122
+ * 老行没这三项:它们既不进分子也不进分母(宁缺不假)。
123
+ */
124
+ llmMs: number;
125
+ ttftMs: number;
126
+ ttftSteps: number;
127
+ decodeMs: number;
128
+ decodeTokens: number;
129
+ /** 工具调用的累计耗时与次数(日志的 `k: 'tool'` 行)。 */
130
+ toolMs: number;
131
+ toolCalls: number;
132
+ }
@@ -0,0 +1,10 @@
1
+ /**
2
+ * 契约分域:usage
3
+ *
4
+ * 从 `src/contract.ts` 拆出来的一个域(纯搬移,逐字未改)。调用方照旧 import
5
+ * `../contract.js`——那份文件现在只做转出,导出面一个没少。
6
+ *
7
+ * @module dsc/contract/usage
8
+ */
9
+ // @@imports@@
10
+ export {};