@waq666/pneuma 0.0.0-stage → 0.7.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (708) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +206 -3
  3. package/bin/dsc.js +91 -0
  4. package/bin/headless.cjs +40 -0
  5. package/lib/adapter/core-runtime.d.ts +11 -0
  6. package/lib/adapter/core-runtime.js +259 -0
  7. package/lib/adapter/host.d.ts +18 -0
  8. package/lib/adapter/host.js +14 -0
  9. package/lib/adapter/runtime.d.ts +15 -0
  10. package/lib/adapter/runtime.js +290 -0
  11. package/lib/adapter/transcript.d.ts +184 -0
  12. package/lib/adapter/transcript.js +605 -0
  13. package/lib/app/AgentsOverlay.d.ts +18 -0
  14. package/lib/app/AgentsOverlay.js +63 -0
  15. package/lib/app/App.d.ts +15 -0
  16. package/lib/app/App.js +1650 -0
  17. package/lib/app/App.js.nv-backup +1650 -0
  18. package/lib/app/ApprovalCard.d.ts +12 -0
  19. package/lib/app/ApprovalCard.js +76 -0
  20. package/lib/app/AskCard.d.ts +20 -0
  21. package/lib/app/AskCard.js +45 -0
  22. package/lib/app/ChatView.d.ts +63 -0
  23. package/lib/app/ChatView.js +310 -0
  24. package/lib/app/Composer.d.ts +50 -0
  25. package/lib/app/Composer.js +282 -0
  26. package/lib/app/DiffBlock.d.ts +6 -0
  27. package/lib/app/DiffBlock.js +37 -0
  28. package/lib/app/MarkdownView.d.ts +6 -0
  29. package/lib/app/MarkdownView.js +99 -0
  30. package/lib/app/ModelPicker.d.ts +7 -0
  31. package/lib/app/ModelPicker.js +18 -0
  32. package/lib/app/PlanReviewCard.d.ts +13 -0
  33. package/lib/app/PlanReviewCard.js +54 -0
  34. package/lib/app/PresetPicker.d.ts +11 -0
  35. package/lib/app/PresetPicker.js +19 -0
  36. package/lib/app/PreviewOverlay.d.ts +14 -0
  37. package/lib/app/PreviewOverlay.js +22 -0
  38. package/lib/app/SessionPicker.d.ts +43 -0
  39. package/lib/app/SessionPicker.js +56 -0
  40. package/lib/app/SettingsOverlay.d.ts +32 -0
  41. package/lib/app/SettingsOverlay.js +157 -0
  42. package/lib/app/SkillsPicker.d.ts +7 -0
  43. package/lib/app/SkillsPicker.js +19 -0
  44. package/lib/app/StatusBar.d.ts +22 -0
  45. package/lib/app/StatusBar.js +201 -0
  46. package/lib/app/TaskStrips.d.ts +13 -0
  47. package/lib/app/TaskStrips.js +40 -0
  48. package/lib/app/TimelineRail.d.ts +22 -0
  49. package/lib/app/TimelineRail.js +160 -0
  50. package/lib/app/TimelineRail.js.negbak +98 -0
  51. package/lib/app/TimelineRail.js.nv-backup +160 -0
  52. package/lib/app/ToolCard.d.ts +11 -0
  53. package/lib/app/ToolCard.js +64 -0
  54. package/lib/app/ToolCard.js.nv-backup +64 -0
  55. package/lib/app/TranscriptOverlay.d.ts +27 -0
  56. package/lib/app/TranscriptOverlay.js +36 -0
  57. package/lib/app/TranscriptViewport.d.ts +78 -0
  58. package/lib/app/TranscriptViewport.js +218 -0
  59. package/lib/app/Welcome.d.ts +6 -0
  60. package/lib/app/Welcome.js +71 -0
  61. package/lib/app/attach.d.ts +16 -0
  62. package/lib/app/attach.js +58 -0
  63. package/lib/app/click.d.ts +40 -0
  64. package/lib/app/click.js +103 -0
  65. package/lib/app/clipboard-image.d.ts +11 -0
  66. package/lib/app/clipboard-image.js +66 -0
  67. package/lib/app/cursor.d.ts +4 -0
  68. package/lib/app/cursor.js +24 -0
  69. package/lib/app/hello.d.ts +11 -0
  70. package/lib/app/hello.js +8 -0
  71. package/lib/app/history-store.d.ts +4 -0
  72. package/lib/app/history-store.js +41 -0
  73. package/lib/app/image-blocks.d.ts +12 -0
  74. package/lib/app/image-blocks.js +125 -0
  75. package/lib/app/keymap.d.ts +56 -0
  76. package/lib/app/keymap.js +56 -0
  77. package/lib/app/markdown.d.ts +54 -0
  78. package/lib/app/markdown.js +189 -0
  79. package/lib/app/mouse.d.ts +33 -0
  80. package/lib/app/mouse.js +35 -0
  81. package/lib/app/pointer.d.ts +16 -0
  82. package/lib/app/pointer.js +60 -0
  83. package/lib/app/scroll-model.d.ts +240 -0
  84. package/lib/app/scroll-model.js +347 -0
  85. package/lib/app/settings-model.d.ts +69 -0
  86. package/lib/app/settings-model.js +114 -0
  87. package/lib/app/snapshot-subscribe.d.ts +34 -0
  88. package/lib/app/snapshot-subscribe.js +110 -0
  89. package/lib/app/theme.d.ts +194 -0
  90. package/lib/app/theme.js +186 -0
  91. package/lib/app/ticker.d.ts +7 -0
  92. package/lib/app/ticker.js +53 -0
  93. package/lib/boot.d.ts +1 -0
  94. package/lib/boot.js +34 -0
  95. package/lib/commands.d.ts +49 -0
  96. package/lib/commands.js +115 -0
  97. package/lib/contract.d.ts +1973 -0
  98. package/lib/contract.js +36 -0
  99. package/lib/core/agent-roles.d.ts +52 -0
  100. package/lib/core/agent-roles.js +274 -0
  101. package/lib/core/approval-floor.d.ts +183 -0
  102. package/lib/core/approval-floor.js +679 -0
  103. package/lib/core/approval.d.ts +42 -0
  104. package/lib/core/approval.js +8 -0
  105. package/lib/core/audit.d.ts +61 -0
  106. package/lib/core/audit.js +59 -0
  107. package/lib/core/boot-notices.d.ts +6 -0
  108. package/lib/core/boot-notices.js +61 -0
  109. package/lib/core/cdp/actions.d.ts +182 -0
  110. package/lib/core/cdp/actions.js +649 -0
  111. package/lib/core/cdp/launch.d.ts +192 -0
  112. package/lib/core/cdp/launch.js +491 -0
  113. package/lib/core/cdp/snapshot.d.ts +139 -0
  114. package/lib/core/cdp/snapshot.js +316 -0
  115. package/lib/core/cdp/transport.d.ts +160 -0
  116. package/lib/core/cdp/transport.js +359 -0
  117. package/lib/core/command-policy.d.ts +108 -0
  118. package/lib/core/command-policy.js +580 -0
  119. package/lib/core/commands-completion.d.ts +78 -0
  120. package/lib/core/commands-completion.js +167 -0
  121. package/lib/core/compact-anchors.d.ts +76 -0
  122. package/lib/core/compact-anchors.js +284 -0
  123. package/lib/core/compact.d.ts +110 -0
  124. package/lib/core/compact.js +210 -0
  125. package/lib/core/config-store.d.ts +38 -0
  126. package/lib/core/config-store.js +307 -0
  127. package/lib/core/config.d.ts +36 -0
  128. package/lib/core/config.js +124 -0
  129. package/lib/core/connection-test.d.ts +60 -0
  130. package/lib/core/connection-test.js +84 -0
  131. package/lib/core/desktop-control.d.ts +298 -0
  132. package/lib/core/desktop-control.js +1311 -0
  133. package/lib/core/diff-text.d.ts +74 -0
  134. package/lib/core/diff-text.js +257 -0
  135. package/lib/core/dock-browser.d.ts +137 -0
  136. package/lib/core/dock-browser.js +146 -0
  137. package/lib/core/dock-ops.d.ts +59 -0
  138. package/lib/core/dock-ops.js +104 -0
  139. package/lib/core/dock-session.d.ts +39 -0
  140. package/lib/core/dock-session.js +28 -0
  141. package/lib/core/dsh-compat/hook.d.ts +18 -0
  142. package/lib/core/dsh-compat/hook.js +52 -0
  143. package/lib/core/dsh-compat/resolve-hook.d.ts +5 -0
  144. package/lib/core/dsh-compat/resolve-hook.js +59 -0
  145. package/lib/core/dsh-compat/tools-facade.d.ts +47 -0
  146. package/lib/core/dsh-compat/tools-facade.js +108 -0
  147. package/lib/core/err-text.d.ts +13 -0
  148. package/lib/core/err-text.js +15 -0
  149. package/lib/core/events.d.ts +149 -0
  150. package/lib/core/events.js +1 -0
  151. package/lib/core/git-exec.d.ts +23 -0
  152. package/lib/core/git-exec.js +72 -0
  153. package/lib/core/git-info.d.ts +47 -0
  154. package/lib/core/git-info.js +157 -0
  155. package/lib/core/goal.d.ts +89 -0
  156. package/lib/core/goal.js +189 -0
  157. package/lib/core/hooks.d.ts +272 -0
  158. package/lib/core/hooks.js +818 -0
  159. package/lib/core/host-browser-link.d.ts +59 -0
  160. package/lib/core/host-browser-link.js +9 -0
  161. package/lib/core/host-methods.d.ts +25 -0
  162. package/lib/core/host-methods.js +103 -0
  163. package/lib/core/image-diet.d.ts +77 -0
  164. package/lib/core/image-diet.js +127 -0
  165. package/lib/core/learnings/ledger.d.ts +73 -0
  166. package/lib/core/learnings/ledger.js +273 -0
  167. package/lib/core/learnings/skill-write.d.ts +250 -0
  168. package/lib/core/learnings/skill-write.js +854 -0
  169. package/lib/core/learnings/store.d.ts +102 -0
  170. package/lib/core/learnings/store.js +266 -0
  171. package/lib/core/lifecycle-hooks.d.ts +189 -0
  172. package/lib/core/lifecycle-hooks.js +576 -0
  173. package/lib/core/llm.d.ts +283 -0
  174. package/lib/core/llm.js +565 -0
  175. package/lib/core/lockfile.d.ts +17 -0
  176. package/lib/core/lockfile.js +110 -0
  177. package/lib/core/loop.d.ts +185 -0
  178. package/lib/core/loop.js +587 -0
  179. package/lib/core/lsp/client.d.ts +189 -0
  180. package/lib/core/lsp/client.js +690 -0
  181. package/lib/core/lsp/framing.d.ts +84 -0
  182. package/lib/core/lsp/framing.js +181 -0
  183. package/lib/core/lsp/line-shift.d.ts +28 -0
  184. package/lib/core/lsp/line-shift.js +127 -0
  185. package/lib/core/lsp/manager.d.ts +93 -0
  186. package/lib/core/lsp/manager.js +418 -0
  187. package/lib/core/lsp/normalize.d.ts +32 -0
  188. package/lib/core/lsp/normalize.js +139 -0
  189. package/lib/core/lsp/servers.d.ts +106 -0
  190. package/lib/core/lsp/servers.js +352 -0
  191. package/lib/core/lsp/uri.d.ts +76 -0
  192. package/lib/core/lsp/uri.js +179 -0
  193. package/lib/core/market.d.ts +51 -0
  194. package/lib/core/market.js +358 -0
  195. package/lib/core/mcp.d.ts +201 -0
  196. package/lib/core/mcp.js +836 -0
  197. package/lib/core/memory-eval.d.ts +158 -0
  198. package/lib/core/memory-eval.js +215 -0
  199. package/lib/core/memory.d.ts +266 -0
  200. package/lib/core/memory.js +703 -0
  201. package/lib/core/mention.d.ts +57 -0
  202. package/lib/core/mention.js +129 -0
  203. package/lib/core/microcompact.d.ts +48 -0
  204. package/lib/core/microcompact.js +79 -0
  205. package/lib/core/migrate.d.ts +56 -0
  206. package/lib/core/migrate.js +134 -0
  207. package/lib/core/model-caps.d.ts +83 -0
  208. package/lib/core/model-caps.js +150 -0
  209. package/lib/core/model-discovery.d.ts +19 -0
  210. package/lib/core/model-discovery.js +69 -0
  211. package/lib/core/modes.d.ts +72 -0
  212. package/lib/core/modes.js +152 -0
  213. package/lib/core/native-bridge.d.ts +135 -0
  214. package/lib/core/native-bridge.js +563 -0
  215. package/lib/core/path-policy.d.ts +32 -0
  216. package/lib/core/path-policy.js +248 -0
  217. package/lib/core/permission-presets.d.ts +67 -0
  218. package/lib/core/permission-presets.js +75 -0
  219. package/lib/core/plugin-loader.d.ts +36 -0
  220. package/lib/core/plugin-loader.js +294 -0
  221. package/lib/core/plugin-registry.d.ts +113 -0
  222. package/lib/core/plugin-registry.js +256 -0
  223. package/lib/core/prefs.d.ts +82 -0
  224. package/lib/core/prefs.js +372 -0
  225. package/lib/core/presets.d.ts +80 -0
  226. package/lib/core/presets.js +373 -0
  227. package/lib/core/pricing.d.ts +90 -0
  228. package/lib/core/pricing.js +126 -0
  229. package/lib/core/prompt.d.ts +92 -0
  230. package/lib/core/prompt.js +339 -0
  231. package/lib/core/ptc.d.ts +66 -0
  232. package/lib/core/ptc.js +70 -0
  233. package/lib/core/remote/frames.d.ts +91 -0
  234. package/lib/core/remote/frames.js +174 -0
  235. package/lib/core/remote/notify.d.ts +54 -0
  236. package/lib/core/remote/notify.js +77 -0
  237. package/lib/core/remote/owner.d.ts +32 -0
  238. package/lib/core/remote/owner.js +75 -0
  239. package/lib/core/remote/pairing.d.ts +104 -0
  240. package/lib/core/remote/pairing.js +261 -0
  241. package/lib/core/remote/push.d.ts +80 -0
  242. package/lib/core/remote/push.js +222 -0
  243. package/lib/core/remote/store.d.ts +18 -0
  244. package/lib/core/remote/store.js +59 -0
  245. package/lib/core/remote/tickets.d.ts +20 -0
  246. package/lib/core/remote/tickets.js +49 -0
  247. package/lib/core/remote/uploads.d.ts +63 -0
  248. package/lib/core/remote/uploads.js +161 -0
  249. package/lib/core/request-attribution.d.ts +26 -0
  250. package/lib/core/request-attribution.js +86 -0
  251. package/lib/core/request-invariant.d.ts +61 -0
  252. package/lib/core/request-invariant.js +199 -0
  253. package/lib/core/sandbox/backends.d.ts +64 -0
  254. package/lib/core/sandbox/backends.js +194 -0
  255. package/lib/core/sandbox/execpolicy.d.ts +93 -0
  256. package/lib/core/sandbox/execpolicy.js +452 -0
  257. package/lib/core/sandbox/net-proxy.d.ts +31 -0
  258. package/lib/core/sandbox/net-proxy.js +162 -0
  259. package/lib/core/sandbox/policy.d.ts +211 -0
  260. package/lib/core/sandbox/policy.js +559 -0
  261. package/lib/core/sandbox/win/abi.d.ts +161 -0
  262. package/lib/core/sandbox/win/abi.js +169 -0
  263. package/lib/core/sandbox/win/account.d.ts +71 -0
  264. package/lib/core/sandbox/win/account.js +206 -0
  265. package/lib/core/sandbox/win/acl.d.ts +54 -0
  266. package/lib/core/sandbox/win/acl.js +339 -0
  267. package/lib/core/sandbox/win/backend.d.ts +61 -0
  268. package/lib/core/sandbox/win/backend.js +249 -0
  269. package/lib/core/sandbox/win/doctor.d.ts +24 -0
  270. package/lib/core/sandbox/win/doctor.js +272 -0
  271. package/lib/core/sandbox/win/ffi.d.ts +107 -0
  272. package/lib/core/sandbox/win/ffi.js +166 -0
  273. package/lib/core/sandbox/win/net-abi.d.ts +154 -0
  274. package/lib/core/sandbox/win/net-abi.js +316 -0
  275. package/lib/core/sandbox/win/runner-entry.d.ts +35 -0
  276. package/lib/core/sandbox/win/runner-entry.js +391 -0
  277. package/lib/core/sandbox/win/setup.d.ts +60 -0
  278. package/lib/core/sandbox/win/setup.js +986 -0
  279. package/lib/core/sandbox/win/token.d.ts +35 -0
  280. package/lib/core/sandbox/win/token.js +238 -0
  281. package/lib/core/sandbox/win/wfp.d.ts +41 -0
  282. package/lib/core/sandbox/win/wfp.js +200 -0
  283. package/lib/core/sandbox/win/workspace-sid.d.ts +9 -0
  284. package/lib/core/sandbox/win/workspace-sid.js +45 -0
  285. package/lib/core/schedule/rule.d.ts +184 -0
  286. package/lib/core/schedule/rule.js +745 -0
  287. package/lib/core/schedule/runner.d.ts +185 -0
  288. package/lib/core/schedule/runner.js +678 -0
  289. package/lib/core/schedule/store.d.ts +182 -0
  290. package/lib/core/schedule/store.js +455 -0
  291. package/lib/core/secrets.d.ts +41 -0
  292. package/lib/core/secrets.js +150 -0
  293. package/lib/core/session-export.d.ts +18 -0
  294. package/lib/core/session-export.js +73 -0
  295. package/lib/core/session-index.d.ts +159 -0
  296. package/lib/core/session-index.js +683 -0
  297. package/lib/core/session-meta.d.ts +41 -0
  298. package/lib/core/session-meta.js +97 -0
  299. package/lib/core/session.d.ts +356 -0
  300. package/lib/core/session.js +998 -0
  301. package/lib/core/skills.d.ts +60 -0
  302. package/lib/core/skills.js +171 -0
  303. package/lib/core/spill.d.ts +159 -0
  304. package/lib/core/spill.js +329 -0
  305. package/lib/core/surface-registry.d.ts +45 -0
  306. package/lib/core/surface-registry.js +67 -0
  307. package/lib/core/team-board.d.ts +95 -0
  308. package/lib/core/team-board.js +316 -0
  309. package/lib/core/throughput.d.ts +46 -0
  310. package/lib/core/throughput.js +40 -0
  311. package/lib/core/todo-reminder.d.ts +44 -0
  312. package/lib/core/todo-reminder.js +55 -0
  313. package/lib/core/todo.d.ts +81 -0
  314. package/lib/core/todo.js +222 -0
  315. package/lib/core/token-estimate.d.ts +55 -0
  316. package/lib/core/token-estimate.js +82 -0
  317. package/lib/core/tool-guards.d.ts +103 -0
  318. package/lib/core/tool-guards.js +77 -0
  319. package/lib/core/tool-search.d.ts +152 -0
  320. package/lib/core/tool-search.js +311 -0
  321. package/lib/core/tools/bash.d.ts +281 -0
  322. package/lib/core/tools/bash.js +871 -0
  323. package/lib/core/tools/command-runner.d.ts +84 -0
  324. package/lib/core/tools/command-runner.js +68 -0
  325. package/lib/core/tools/fs-tools.d.ts +23 -0
  326. package/lib/core/tools/fs-tools.js +247 -0
  327. package/lib/core/tools/index.d.ts +8 -0
  328. package/lib/core/tools/index.js +4 -0
  329. package/lib/core/tools/sandbox-args.d.ts +51 -0
  330. package/lib/core/tools/sandbox-args.js +90 -0
  331. package/lib/core/tools/search-tools.d.ts +3 -0
  332. package/lib/core/tools/search-tools.js +153 -0
  333. package/lib/core/tools.d.ts +96 -0
  334. package/lib/core/tools.js +53 -0
  335. package/lib/core/ui-boot-source.d.ts +71 -0
  336. package/lib/core/ui-boot-source.js +121 -0
  337. package/lib/core/ui-bundles.d.ts +249 -0
  338. package/lib/core/ui-bundles.js +830 -0
  339. package/lib/core/ui-combo.d.ts +49 -0
  340. package/lib/core/ui-combo.js +55 -0
  341. package/lib/core/ui-events.d.ts +81 -0
  342. package/lib/core/ui-events.js +364 -0
  343. package/lib/core/ui-hmr.d.ts +36 -0
  344. package/lib/core/ui-hmr.js +128 -0
  345. package/lib/core/ui-methods.d.ts +69 -0
  346. package/lib/core/ui-methods.js +341 -0
  347. package/lib/core/ui-route.d.ts +69 -0
  348. package/lib/core/ui-route.js +122 -0
  349. package/lib/core/ui-server.d.ts +75 -0
  350. package/lib/core/ui-server.js +369 -0
  351. package/lib/core/ui-trust.d.ts +47 -0
  352. package/lib/core/ui-trust.js +164 -0
  353. package/lib/core/untrusted.d.ts +30 -0
  354. package/lib/core/untrusted.js +48 -0
  355. package/lib/core/update-check.d.ts +81 -0
  356. package/lib/core/update-check.js +177 -0
  357. package/lib/core/usage-log.d.ts +82 -0
  358. package/lib/core/usage-log.js +306 -0
  359. package/lib/core/version.d.ts +1 -0
  360. package/lib/core/version.js +37 -0
  361. package/lib/core/web-http.d.ts +57 -0
  362. package/lib/core/web-http.js +137 -0
  363. package/lib/core/web-static.d.ts +31 -0
  364. package/lib/core/web-static.js +75 -0
  365. package/lib/headless.d.ts +1 -0
  366. package/lib/headless.js +31 -0
  367. package/lib/host/kernel.d.ts +33 -0
  368. package/lib/host/kernel.js +451 -0
  369. package/lib/index.d.ts +41 -0
  370. package/lib/index.js +35 -0
  371. package/lib/plugins/agent.d.ts +2 -0
  372. package/lib/plugins/agent.js +274 -0
  373. package/lib/plugins/approval-floor.d.ts +2 -0
  374. package/lib/plugins/approval-floor.js +223 -0
  375. package/lib/plugins/approval.d.ts +16 -0
  376. package/lib/plugins/approval.js +674 -0
  377. package/lib/plugins/ask.d.ts +2 -0
  378. package/lib/plugins/ask.js +245 -0
  379. package/lib/plugins/browser.d.ts +68 -0
  380. package/lib/plugins/browser.js +1341 -0
  381. package/lib/plugins/commands.d.ts +23 -0
  382. package/lib/plugins/commands.js +498 -0
  383. package/lib/plugins/compact.d.ts +21 -0
  384. package/lib/plugins/compact.js +274 -0
  385. package/lib/plugins/computer-use.d.ts +47 -0
  386. package/lib/plugins/computer-use.js +539 -0
  387. package/lib/plugins/desktop-dock.d.ts +2 -0
  388. package/lib/plugins/desktop-dock.js +626 -0
  389. package/lib/plugins/dock-browser.d.ts +34 -0
  390. package/lib/plugins/dock-browser.js +765 -0
  391. package/lib/plugins/dsh-compat.d.ts +25 -0
  392. package/lib/plugins/dsh-compat.js +37 -0
  393. package/lib/plugins/file-review.d.ts +108 -0
  394. package/lib/plugins/file-review.js +393 -0
  395. package/lib/plugins/git.d.ts +26 -0
  396. package/lib/plugins/git.js +132 -0
  397. package/lib/plugins/goal.d.ts +20 -0
  398. package/lib/plugins/goal.js +245 -0
  399. package/lib/plugins/guards.d.ts +14 -0
  400. package/lib/plugins/guards.js +18 -0
  401. package/lib/plugins/hooks.d.ts +19 -0
  402. package/lib/plugins/hooks.js +583 -0
  403. package/lib/plugins/host-stdio.d.ts +88 -0
  404. package/lib/plugins/host-stdio.js +317 -0
  405. package/lib/plugins/image-diet.d.ts +17 -0
  406. package/lib/plugins/image-diet.js +85 -0
  407. package/lib/plugins/lifecycle-hooks.d.ts +26 -0
  408. package/lib/plugins/lifecycle-hooks.js +338 -0
  409. package/lib/plugins/llm.d.ts +13 -0
  410. package/lib/plugins/llm.js +215 -0
  411. package/lib/plugins/lsp.d.ts +54 -0
  412. package/lib/plugins/lsp.js +608 -0
  413. package/lib/plugins/mcp.d.ts +16 -0
  414. package/lib/plugins/mcp.js +673 -0
  415. package/lib/plugins/memory.d.ts +17 -0
  416. package/lib/plugins/memory.js +858 -0
  417. package/lib/plugins/microcompact.d.ts +18 -0
  418. package/lib/plugins/microcompact.js +119 -0
  419. package/lib/plugins/mode.d.ts +18 -0
  420. package/lib/plugins/mode.js +115 -0
  421. package/lib/plugins/permission-presets.d.ts +18 -0
  422. package/lib/plugins/permission-presets.js +135 -0
  423. package/lib/plugins/plan.d.ts +2 -0
  424. package/lib/plugins/plan.js +192 -0
  425. package/lib/plugins/plugin-manager.d.ts +2 -0
  426. package/lib/plugins/plugin-manager.js +165 -0
  427. package/lib/plugins/presets.d.ts +2 -0
  428. package/lib/plugins/presets.js +182 -0
  429. package/lib/plugins/prompt.d.ts +2 -0
  430. package/lib/plugins/prompt.js +264 -0
  431. package/lib/plugins/ptc.d.ts +2 -0
  432. package/lib/plugins/ptc.js +272 -0
  433. package/lib/plugins/remote/http.d.ts +11 -0
  434. package/lib/plugins/remote/http.js +11 -0
  435. package/lib/plugins/remote/routes.d.ts +24 -0
  436. package/lib/plugins/remote/routes.js +384 -0
  437. package/lib/plugins/remote/types.d.ts +135 -0
  438. package/lib/plugins/remote/types.js +87 -0
  439. package/lib/plugins/remote.d.ts +17 -0
  440. package/lib/plugins/remote.js +1028 -0
  441. package/lib/plugins/runtime-api.d.ts +16 -0
  442. package/lib/plugins/runtime-api.js +99 -0
  443. package/lib/plugins/runtime.d.ts +10 -0
  444. package/lib/plugins/runtime.js +451 -0
  445. package/lib/plugins/sandbox.d.ts +2 -0
  446. package/lib/plugins/sandbox.js +761 -0
  447. package/lib/plugins/schedule.d.ts +26 -0
  448. package/lib/plugins/schedule.js +538 -0
  449. package/lib/plugins/self-improve.d.ts +61 -0
  450. package/lib/plugins/self-improve.js +953 -0
  451. package/lib/plugins/session-search.d.ts +16 -0
  452. package/lib/plugins/session-search.js +308 -0
  453. package/lib/plugins/session-title.d.ts +19 -0
  454. package/lib/plugins/session-title.js +109 -0
  455. package/lib/plugins/session.d.ts +7 -0
  456. package/lib/plugins/session.js +296 -0
  457. package/lib/plugins/settings.d.ts +3 -0
  458. package/lib/plugins/settings.js +705 -0
  459. package/lib/plugins/skills.d.ts +2 -0
  460. package/lib/plugins/skills.js +360 -0
  461. package/lib/plugins/spill.d.ts +16 -0
  462. package/lib/plugins/spill.js +200 -0
  463. package/lib/plugins/subagent.d.ts +2 -0
  464. package/lib/plugins/subagent.js +896 -0
  465. package/lib/plugins/surfaces.d.ts +11 -0
  466. package/lib/plugins/surfaces.js +20 -0
  467. package/lib/plugins/team.d.ts +16 -0
  468. package/lib/plugins/team.js +149 -0
  469. package/lib/plugins/todo.d.ts +19 -0
  470. package/lib/plugins/todo.js +188 -0
  471. package/lib/plugins/tool-search.d.ts +2 -0
  472. package/lib/plugins/tool-search.js +434 -0
  473. package/lib/plugins/tool-search.js.nv-backup +434 -0
  474. package/lib/plugins/tools-default.d.ts +12 -0
  475. package/lib/plugins/tools-default.js +275 -0
  476. package/lib/plugins/tools.d.ts +16 -0
  477. package/lib/plugins/tools.js +62 -0
  478. package/lib/plugins/transcript.d.ts +15 -0
  479. package/lib/plugins/transcript.js +311 -0
  480. package/lib/plugins/tui.d.ts +2 -0
  481. package/lib/plugins/tui.js +98 -0
  482. package/lib/plugins/waiting.d.ts +12 -0
  483. package/lib/plugins/waiting.js +34 -0
  484. package/lib/plugins/web-search.d.ts +14 -0
  485. package/lib/plugins/web-search.js +263 -0
  486. package/lib/plugins/webserver.d.ts +48 -0
  487. package/lib/plugins/webserver.js +228 -0
  488. package/lib/remote/assets/app-DAcUCOEn.js +14 -0
  489. package/lib/remote/assets/icon-192.png +0 -0
  490. package/lib/remote/assets/icon-512.png +0 -0
  491. package/lib/remote/assets/index.html +34 -0
  492. package/lib/remote/assets/manifest.json +27 -0
  493. package/lib/remote/assets/style-DIB6729x.css +1 -0
  494. package/lib/remote/assets/sw.js +66 -0
  495. package/lib/services/types.d.ts +1228 -0
  496. package/lib/services/types.js +1 -0
  497. package/lib/tools/config-cli.d.ts +1 -0
  498. package/lib/tools/config-cli.js +89 -0
  499. package/lib/ui/arrival.d.ts +72 -0
  500. package/lib/ui/arrival.js +105 -0
  501. package/lib/ui/assets/app-B70nVIKd.js +69 -0
  502. package/lib/ui/assets/chunk-2UxHyX5q.js +1 -0
  503. package/lib/ui/assets/chunk-B1dDrJ26.js +1 -0
  504. package/lib/ui/assets/chunk-B6aJPvgy.js +1 -0
  505. package/lib/ui/assets/chunk-BEwlwnbL.js +1 -0
  506. package/lib/ui/assets/chunk-BGcgwlCI.js +12 -0
  507. package/lib/ui/assets/chunk-BIGW1oBm.js +1 -0
  508. package/lib/ui/assets/chunk-BPQ3VLAy.js +1 -0
  509. package/lib/ui/assets/chunk-BRH0KZbk.js +141 -0
  510. package/lib/ui/assets/chunk-BX6H_ySx.js +1 -0
  511. package/lib/ui/assets/chunk-B_P3UbPa.js +1 -0
  512. package/lib/ui/assets/chunk-B_TYUkTI.js +1 -0
  513. package/lib/ui/assets/chunk-B_vNuMnf.js +1 -0
  514. package/lib/ui/assets/chunk-BajyYBss.js +10 -0
  515. package/lib/ui/assets/chunk-BdnUsdx6.js +1 -0
  516. package/lib/ui/assets/chunk-Buea-lGh.js +1 -0
  517. package/lib/ui/assets/chunk-C0PvZCCE.js +1 -0
  518. package/lib/ui/assets/chunk-C0m74zRD.js +1 -0
  519. package/lib/ui/assets/chunk-C27-OAKa.js +1 -0
  520. package/lib/ui/assets/chunk-C2oV4EkX.js +1 -0
  521. package/lib/ui/assets/chunk-C7zT0LnQ.js +1 -0
  522. package/lib/ui/assets/chunk-C9GSunVT.js +1 -0
  523. package/lib/ui/assets/chunk-C9tS-k6U.js +1 -0
  524. package/lib/ui/assets/chunk-CHLpvVh8.js +1 -0
  525. package/lib/ui/assets/chunk-CLxacb5B.js +1 -0
  526. package/lib/ui/assets/chunk-COt5Ahok.js +1 -0
  527. package/lib/ui/assets/chunk-CPTIWCL2.js +1 -0
  528. package/lib/ui/assets/chunk-CQLl-L-p.js +1 -0
  529. package/lib/ui/assets/chunk-CUWRgxuq.js +55 -0
  530. package/lib/ui/assets/chunk-CWanVSXC.js +1 -0
  531. package/lib/ui/assets/chunk-Cf5RLm7j.js +1 -0
  532. package/lib/ui/assets/chunk-CickPsom.js +1 -0
  533. package/lib/ui/assets/chunk-Cj5Yp3dK.js +1 -0
  534. package/lib/ui/assets/chunk-Cmh6b_Ma.js +1 -0
  535. package/lib/ui/assets/chunk-Cp-IABpG.js +1 -0
  536. package/lib/ui/assets/chunk-CqE71os6.js +1 -0
  537. package/lib/ui/assets/chunk-CtKP3W-j.js +1 -0
  538. package/lib/ui/assets/chunk-Cvjx9yec.js +1 -0
  539. package/lib/ui/assets/chunk-CxGP3dtY.js +1 -0
  540. package/lib/ui/assets/chunk-CylS5w8V.js +1 -0
  541. package/lib/ui/assets/chunk-D38fbIBN.js +1 -0
  542. package/lib/ui/assets/chunk-D97Zzqfu.js +1 -0
  543. package/lib/ui/assets/chunk-DAi9KRSo.js +1 -0
  544. package/lib/ui/assets/chunk-DHK4yRfg.js +1 -0
  545. package/lib/ui/assets/chunk-DJeabLx-.js +1 -0
  546. package/lib/ui/assets/chunk-DNRxmY5a.js +1 -0
  547. package/lib/ui/assets/chunk-DNSN1z5r.js +1 -0
  548. package/lib/ui/assets/chunk-DNasK_ZG.js +1 -0
  549. package/lib/ui/assets/chunk-DPvrY3IQ.js +1 -0
  550. package/lib/ui/assets/chunk-DXmwc3jG.js +1 -0
  551. package/lib/ui/assets/chunk-Dd0kTxKP.js +1 -0
  552. package/lib/ui/assets/chunk-De0Btta0.js +1 -0
  553. package/lib/ui/assets/chunk-Des-eS-w.js +1 -0
  554. package/lib/ui/assets/chunk-Df6bDoY_.js +1 -0
  555. package/lib/ui/assets/chunk-DijEV5ha.js +1 -0
  556. package/lib/ui/assets/chunk-DkvoVjww.js +1 -0
  557. package/lib/ui/assets/chunk-DlC-OlHO.js +1 -0
  558. package/lib/ui/assets/chunk-DnzrXTVv.js +1 -0
  559. package/lib/ui/assets/chunk-Dualf0xi.js +1 -0
  560. package/lib/ui/assets/chunk-EXT84bkm.js +1 -0
  561. package/lib/ui/assets/chunk-GwR3hkPK.js +1 -0
  562. package/lib/ui/assets/chunk-P80f7IUj.js +1 -0
  563. package/lib/ui/assets/chunk-VOosw3JB.js +1 -0
  564. package/lib/ui/assets/chunk-YQ4lDkt_.js +140 -0
  565. package/lib/ui/assets/chunk-Yzrsuije.js +1 -0
  566. package/lib/ui/assets/chunk-Z72CF80r.js +1 -0
  567. package/lib/ui/assets/chunk-g9-lgVsj.js +1 -0
  568. package/lib/ui/assets/chunk-vGWfd6FD.js +1 -0
  569. package/lib/ui/assets/chunk-wDzz0qaB.js +1 -0
  570. package/lib/ui/assets/chunk-ySF7HWmS.js +1 -0
  571. package/lib/ui/assets/icon.png +0 -0
  572. package/lib/ui/assets/index.html +14 -0
  573. package/lib/ui/assets/pdf.worker.min-CjEcRF4W.mjs +28 -0
  574. package/lib/ui/assets/style-Bq01xH_b.css +1 -0
  575. package/lib/ui/frames.d.ts +67 -0
  576. package/lib/ui/frames.js +146 -0
  577. package/lib/ui/index.d.ts +59 -0
  578. package/lib/ui/index.js +50 -0
  579. package/lib/ui/manifest.d.ts +172 -0
  580. package/lib/ui/manifest.js +158 -0
  581. package/lib/ui/plugin.d.ts +161 -0
  582. package/lib/ui/plugin.js +7 -0
  583. package/lib/ui/plugins/browser/client.js +290 -0
  584. package/lib/ui/plugins/browser/icon.png +0 -0
  585. package/lib/ui/plugins/composer/client.js +1843 -0
  586. package/lib/ui/plugins/composer/icon.png +0 -0
  587. package/lib/ui/plugins/files/client.js +646 -0
  588. package/lib/ui/plugins/files/icon.png +0 -0
  589. package/lib/ui/plugins/manifest.json +107 -0
  590. package/lib/ui/plugins/plugins/client.js +682 -0
  591. package/lib/ui/plugins/plugins/icon.png +0 -0
  592. package/lib/ui/plugins/preview/client.js +197 -0
  593. package/lib/ui/plugins/preview/icon.png +0 -0
  594. package/lib/ui/plugins/prompt/client.js +653 -0
  595. package/lib/ui/plugins/prompt/icon.png +0 -0
  596. package/lib/ui/plugins/sessions/client.js +1577 -0
  597. package/lib/ui/plugins/sessions/icon.png +0 -0
  598. package/lib/ui/plugins/settings/client.js +5470 -0
  599. package/lib/ui/plugins/settings/icon.png +0 -0
  600. package/lib/ui/plugins/skills/client.js +485 -0
  601. package/lib/ui/plugins/skills/icon.png +0 -0
  602. package/lib/ui/plugins/status/client.js +1420 -0
  603. package/lib/ui/plugins/status/icon.png +0 -0
  604. package/lib/ui/plugins/statusbar/client.js +504 -0
  605. package/lib/ui/plugins/statusbar/icon.png +0 -0
  606. package/lib/ui/plugins/tasks/client.js +52 -0
  607. package/lib/ui/plugins/tasks/icon.png +0 -0
  608. package/lib/ui/plugins/team/client.js +527 -0
  609. package/lib/ui/plugins/team/icon.png +0 -0
  610. package/lib/ui/plugins/terminal/client.js +232 -0
  611. package/lib/ui/plugins/terminal/icon.png +0 -0
  612. package/lib/ui/plugins/trace/client.js +1376 -0
  613. package/lib/ui/plugins/trace/icon.png +0 -0
  614. package/lib/ui/plugins/transcript/client.js +2661 -0
  615. package/lib/ui/plugins/transcript/icon.png +0 -0
  616. package/lib/ui/scoped-slots.d.ts +20 -0
  617. package/lib/ui/scoped-slots.js +21 -0
  618. package/lib/ui/sdk/@dsc/ui/index.d.ts +242 -0
  619. package/lib/ui/sdk/@dsc/ui/package.json +16 -0
  620. package/lib/ui/sdk/@dsc/ui-core/contract.d.ts +1973 -0
  621. package/lib/ui/sdk/@dsc/ui-core/core/diff-text.d.ts +74 -0
  622. package/lib/ui/sdk/@dsc/ui-core/core/dock-browser.d.ts +137 -0
  623. package/lib/ui/sdk/@dsc/ui-core/core/dock-ops.d.ts +59 -0
  624. package/lib/ui/sdk/@dsc/ui-core/core/model-caps.d.ts +83 -0
  625. package/lib/ui/sdk/@dsc/ui-core/core/native-bridge.d.ts +135 -0
  626. package/lib/ui/sdk/@dsc/ui-core/core/token-estimate.d.ts +55 -0
  627. package/lib/ui/sdk/@dsc/ui-core/package.json +16 -0
  628. package/lib/ui/sdk/@dsc/ui-core/ui/arrival.d.ts +72 -0
  629. package/lib/ui/sdk/@dsc/ui-core/ui/frames.d.ts +67 -0
  630. package/lib/ui/sdk/@dsc/ui-core/ui/index.d.ts +59 -0
  631. package/lib/ui/sdk/@dsc/ui-core/ui/manifest.d.ts +172 -0
  632. package/lib/ui/sdk/@dsc/ui-core/ui/plugin.d.ts +161 -0
  633. package/lib/ui/sdk/@dsc/ui-core/ui/scoped-slots.d.ts +20 -0
  634. package/lib/ui/sdk/@dsc/ui-core/ui/services-react.d.ts +27 -0
  635. package/lib/ui/sdk/@dsc/ui-core/ui/services.d.ts +63 -0
  636. package/lib/ui/sdk/@dsc/ui-core/ui/slots-react.d.ts +28 -0
  637. package/lib/ui/sdk/@dsc/ui-core/ui/slots.d.ts +481 -0
  638. package/lib/ui/sdk/@dsc/ui-core/ui/store.d.ts +89 -0
  639. package/lib/ui/sdk/@dsc/ui-dockkit/dock-model.d.ts +238 -0
  640. package/lib/ui/sdk/@dsc/ui-dockkit/dock-state.d.ts +163 -0
  641. package/lib/ui/sdk/@dsc/ui-dockkit/dock.d.ts +24 -0
  642. package/lib/ui/sdk/@dsc/ui-dockkit/index.d.ts +15 -0
  643. package/lib/ui/sdk/@dsc/ui-dockkit/package.json +16 -0
  644. package/lib/ui/sdk/@dsc/ui-layout/app.d.ts +74 -0
  645. package/lib/ui/sdk/@dsc/ui-layout/appearance.d.ts +70 -0
  646. package/lib/ui/sdk/@dsc/ui-layout/host-channel.d.ts +112 -0
  647. package/lib/ui/sdk/@dsc/ui-layout/index.d.ts +34 -0
  648. package/lib/ui/sdk/@dsc/ui-layout/package.json +16 -0
  649. package/lib/ui/sdk/@dsc/ui-layout/page-state.d.ts +14 -0
  650. package/lib/ui/sdk/@dsc/ui-layout/review-pane.d.ts +21 -0
  651. package/lib/ui/sdk/@dsc/ui-layout/runtime-context.d.ts +44 -0
  652. package/lib/ui/sdk/@dsc/ui-layout/thread-view.d.ts +28 -0
  653. package/lib/ui/sdk/@dsc/ui-layout/update-button.d.ts +21 -0
  654. package/lib/ui/sdk/@dsc/ui-primitives/code-file-icon-artwork.d.ts +53 -0
  655. package/lib/ui/sdk/@dsc/ui-primitives/code-view.d.ts +15 -0
  656. package/lib/ui/sdk/@dsc/ui-primitives/compat.d.ts +27 -0
  657. package/lib/ui/sdk/@dsc/ui-primitives/completion-sound.d.ts +24 -0
  658. package/lib/ui/sdk/@dsc/ui-primitives/confirm.d.ts +33 -0
  659. package/lib/ui/sdk/@dsc/ui-primitives/css.d.ts +47 -0
  660. package/lib/ui/sdk/@dsc/ui-primitives/diff-rows.d.ts +20 -0
  661. package/lib/ui/sdk/@dsc/ui-primitives/file-icons.d.ts +38 -0
  662. package/lib/ui/sdk/@dsc/ui-primitives/file-type-classify.d.ts +66 -0
  663. package/lib/ui/sdk/@dsc/ui-primitives/file-type-icon.d.ts +57 -0
  664. package/lib/ui/sdk/@dsc/ui-primitives/highlight.d.ts +24 -0
  665. package/lib/ui/sdk/@dsc/ui-primitives/hover-delay.d.ts +17 -0
  666. package/lib/ui/sdk/@dsc/ui-primitives/icons.d.ts +109 -0
  667. package/lib/ui/sdk/@dsc/ui-primitives/index.d.ts +55 -0
  668. package/lib/ui/sdk/@dsc/ui-primitives/lang-table.d.ts +10 -0
  669. package/lib/ui/sdk/@dsc/ui-primitives/markdown.d.ts +20 -0
  670. package/lib/ui/sdk/@dsc/ui-primitives/native.d.ts +41 -0
  671. package/lib/ui/sdk/@dsc/ui-primitives/package.json +16 -0
  672. package/lib/ui/sdk/@dsc/ui-primitives/panels.d.ts +86 -0
  673. package/lib/ui/sdk/@dsc/ui-primitives/paths.d.ts +11 -0
  674. package/lib/ui/sdk/@dsc/ui-primitives/pdf-view.d.ts +13 -0
  675. package/lib/ui/sdk/@dsc/ui-primitives/plugin-text.d.ts +15 -0
  676. package/lib/ui/sdk/@dsc/ui-primitives/select.d.ts +35 -0
  677. package/lib/ui/sdk/@dsc/ui-primitives/table-view.d.ts +23 -0
  678. package/lib/ui/sdk/@dsc/ui-primitives/thread-resizer.d.ts +22 -0
  679. package/lib/ui/sdk/@dsc/ui-primitives/time.d.ts +33 -0
  680. package/lib/ui/sdk/@dsc/ui-primitives/toast.d.ts +16 -0
  681. package/lib/ui/sdk/@dsc/ui-primitives/tokens.d.ts +14 -0
  682. package/lib/ui/sdk/@dsc/ui-primitives/tool-args.d.ts +49 -0
  683. package/lib/ui/sdk/@dsc/ui-primitives/tool-summary.d.ts +64 -0
  684. package/lib/ui/sdk/@dsc/ui-renderer/boot.d.ts +121 -0
  685. package/lib/ui/sdk/@dsc/ui-renderer/hmr.d.ts +43 -0
  686. package/lib/ui/sdk/@dsc/ui-renderer/index.d.ts +20 -0
  687. package/lib/ui/sdk/@dsc/ui-renderer/package.json +16 -0
  688. package/lib/ui/sdk/@dsc/ui-slots/index.d.ts +19 -0
  689. package/lib/ui/sdk/@dsc/ui-slots/package.json +16 -0
  690. package/lib/ui/sdk/@dsc/ui-slots/slots-react.d.ts +48 -0
  691. package/lib/ui/sdk/@dsc/ui-slots/slots.d.ts +102 -0
  692. package/lib/ui/services-react.d.ts +27 -0
  693. package/lib/ui/services-react.js +32 -0
  694. package/lib/ui/services.d.ts +63 -0
  695. package/lib/ui/services.js +121 -0
  696. package/lib/ui/slots-ink.d.ts +26 -0
  697. package/lib/ui/slots-ink.js +78 -0
  698. package/lib/ui/slots-react.d.ts +28 -0
  699. package/lib/ui/slots-react.js +88 -0
  700. package/lib/ui/slots.d.ts +481 -0
  701. package/lib/ui/slots.js +550 -0
  702. package/lib/ui/store.d.ts +89 -0
  703. package/lib/ui/store.js +62 -0
  704. package/lib/ui/tui-plugin-api.d.ts +23 -0
  705. package/lib/ui/tui-plugin-api.js +23 -0
  706. package/lib/ui/tui-plugins.d.ts +47 -0
  707. package/lib/ui/tui-plugins.js +220 -0
  708. package/package.json +58 -6
@@ -0,0 +1,146 @@
1
+ /**
2
+ * 界面壳侧的帧归并:把宿主推来的全量/增量帧并进一份快照。
3
+ *
4
+ * 线协议与遥控端(`remote-web/src/lib/reduce.ts`)是**同一份**(`core/remote/frames.ts` 定的
5
+ * 契约:全量 `{type:'snapshot', seq, full:true, ...字段铺平}`、增量
6
+ * `{type:'delta', seq, full:false, meta, added, updated, removedIds, liveEntries}`)。
7
+ *
8
+ * 与遥控端那份的区别只有一个,而且是有意的:**这里是严格版**。遥控端要容忍版本漂移
9
+ * (客户端的页面可能是旧构建、宿主可能是旧版本,字段形状对不上也得画出来),所以它有一整套
10
+ * `normalize*` 兜底;界面壳与宿主永远同一次构建一起发(壳就是从宿主的 `/` 里取回来的),
11
+ * 认不出的帧直接当错误处理——把「容忍」换成「早暴露」,省掉的兜底代码不再需要维护两遍口径。
12
+ *
13
+ * 条目按 id 合并后统一按 id 升序:宿主发号递增,id 序就是时间序,比维护插入序少一处状态。
14
+ *
15
+ * 另外这里**认帧号**(`seq`):首帧必须是全量、游标只许前进、增量不许跳号。
16
+ * 遥控端那份只看内容不看序号,所以漏帧要等下一帧全量锚才发现;壳这边当场就能发现。
17
+ *
18
+ * @module dsc/ui/frames
19
+ */
20
+ /** 认不出的帧抛这个(严格版:宁可报错也不要画出一份半对不对的状态)。 */
21
+ export class HostFrameError extends Error {
22
+ }
23
+ /**
24
+ * 帧号中间缺了几帧抛这个。
25
+ *
26
+ * 为什么单独成一个类型:缺口的处理方式与「帧认不出」不同——认不出的帧扔掉就行,缺口却
27
+ * 永远补不回来(增量是相对上一帧的差),只能整条通道重开去换一帧全量。调用方
28
+ * (`ui-shell/src/host-channel.ts`)据此主动断开 EventSource 触发干净重连。
29
+ *
30
+ * 继承 HostFrameError:只判「帧有问题」的调用方不必改。
31
+ */
32
+ export class HostFrameGapError extends HostFrameError {
33
+ }
34
+ function asRecord(value) {
35
+ return typeof value === 'object' && value !== null && !Array.isArray(value) ? value : null;
36
+ }
37
+ /** 帧顶层是不是全量(先看 `full`,再看 `type`)。 */
38
+ export function isFullFrame(raw) {
39
+ const frame = asRecord(raw);
40
+ if (frame === null)
41
+ return false;
42
+ if (frame['full'] === true)
43
+ return true;
44
+ if (frame['full'] === false)
45
+ return false;
46
+ return frame['type'] === 'snapshot';
47
+ }
48
+ /** 帧顶层的 seq。 */
49
+ export function readFrameSeq(raw) {
50
+ const frame = asRecord(raw);
51
+ if (frame === null)
52
+ return null;
53
+ const value = frame['seq'];
54
+ return typeof value === 'number' && Number.isFinite(value) ? value : null;
55
+ }
56
+ /** 收下一段条目:只认带有限数字 id 的对象。 */
57
+ function readEntries(raw) {
58
+ if (raw === undefined)
59
+ return [];
60
+ if (!Array.isArray(raw))
61
+ throw new HostFrameError('条目字段不是数组');
62
+ const out = [];
63
+ for (const item of raw) {
64
+ const entry = asRecord(item);
65
+ const id = entry?.['id'];
66
+ if (entry === null || typeof id !== 'number' || !Number.isFinite(id)) {
67
+ throw new HostFrameError('条目缺少数字 id');
68
+ }
69
+ out.push(entry);
70
+ }
71
+ return out;
72
+ }
73
+ /** 收下 removedIds:只认有限数字。 */
74
+ function readRemovedIds(raw) {
75
+ if (raw === undefined)
76
+ return [];
77
+ if (!Array.isArray(raw))
78
+ throw new HostFrameError('removedIds 不是数组');
79
+ const out = [];
80
+ for (const item of raw) {
81
+ if (typeof item === 'number' && Number.isFinite(item))
82
+ out.push(item);
83
+ }
84
+ return out;
85
+ }
86
+ /**
87
+ * 把一帧并进当前快照。
88
+ *
89
+ * 三条序号不变量(对齐 `packages/api/gateway/src/client/snapshot-stream.ts` 的语义:
90
+ * 每一代(一次连接)的第一帧必须是全量,游标只许前进):
91
+ *
92
+ * 1. `previous === null` 时只收全量帧:增量是相对上一帧的差,没有基准可并;
93
+ * 2. `seq <= previous.seq`(重复帧、回退帧)直接丢掉,返回原状态——重连补帧会重发;
94
+ * 3. 增量帧 `seq > previous.seq + 1`(缺口)抛 {@link HostFrameGapError}。
95
+ * 全量帧不查缺口:它自带完整状态,跳多远都能直接顶上(跨窗口重连给的正是这种)。
96
+ *
97
+ * @param previous - 当前快照(首帧传 null)
98
+ * @param raw - 宿主推来的一帧(已 JSON 解析)
99
+ * @returns 新的快照;回退/重复帧返回传入的 `previous`(引用不变)
100
+ * @throws {HostFrameGapError} 增量帧跳号(缺口)
101
+ * @throws {HostFrameError} 帧认不出(不是对象、缺 seq、首帧不是全量、条目形状不对)
102
+ */
103
+ export function applyHostFrame(previous, raw) {
104
+ const frame = asRecord(raw);
105
+ if (frame === null)
106
+ throw new HostFrameError('帧不是对象');
107
+ const seq = readFrameSeq(frame);
108
+ if (seq === null)
109
+ throw new HostFrameError('帧缺少 seq');
110
+ const full = isFullFrame(frame);
111
+ if (previous === null && !full)
112
+ throw new HostFrameError('第一帧必须是全量帧');
113
+ if (previous !== null) {
114
+ // 回退或重复:丢弃而不是报错——重连补帧本来就可能重发,报错会把正常重连打成故障。
115
+ if (seq <= previous.seq)
116
+ return previous;
117
+ if (!full && seq > previous.seq + 1) {
118
+ throw new HostFrameGapError(`帧号跳号:手上有 seq ${String(previous.seq)},收到 seq ${String(seq)}`);
119
+ }
120
+ }
121
+ if (full) {
122
+ const meta = {};
123
+ for (const [key, value] of Object.entries(frame)) {
124
+ if (key === 'entries' || key === 'liveEntries' || key === 'type' || key === 'full')
125
+ continue;
126
+ meta[key] = value;
127
+ }
128
+ return { ...meta, seq, entries: readEntries(frame['entries']), liveEntries: readEntries(frame['liveEntries']) };
129
+ }
130
+ const meta = asRecord(frame['meta']);
131
+ if (meta === null)
132
+ throw new HostFrameError('增量帧缺少 meta');
133
+ const byId = new Map();
134
+ for (const entry of previous?.entries ?? [])
135
+ byId.set(entry.id, entry);
136
+ for (const id of readRemovedIds(frame['removedIds']))
137
+ byId.delete(id);
138
+ for (const entry of readEntries(frame['updated']))
139
+ byId.set(entry.id, entry);
140
+ for (const entry of readEntries(frame['added']))
141
+ byId.set(entry.id, entry);
142
+ const entries = [...byId.values()].sort((left, right) => left.id - right.id);
143
+ // liveEntries 每帧全量给:缺这个字段时保留旧值(兜底,契约里不缺)。
144
+ const liveEntries = 'liveEntries' in frame ? readEntries(frame['liveEntries']) : (previous?.liveEntries ?? []);
145
+ return { ...(previous ?? {}), ...meta, seq, entries, liveEntries };
146
+ }
@@ -0,0 +1,59 @@
1
+ /**
2
+ * 插件版界面的共用核心:宿主(组清单、发 bundle)与界面壳(建注册表、装插件)
3
+ * 共用这一份,浏览器安全——不 import 任何 node 内置模块。
4
+ *
5
+ * @module dsc/ui
6
+ */
7
+ export * from './frames.js';
8
+ export * from './manifest.js';
9
+ export * from './arrival.js';
10
+ export * from './plugin.js';
11
+ export * from './slots.js';
12
+ export * from './store.js';
13
+ export * from './scoped-slots.js';
14
+ export * from './services.js';
15
+ /**
16
+ * 服务表的 React 订阅面(`ServicesProvider` / `useService`):壳把装载出来的服务表
17
+ * 经 context 交给条目组件,插件跟着服务的出现/消失换数据源。
18
+ */
19
+ export * from './services-react.js';
20
+ /**
21
+ * 槽位注册表的 React 订阅面(useSlot / useSlotFaults):浏览器壳与终端壳共用。
22
+ * 为什么在共享层:两个壳的「组件」都是 React 组件,订阅语义只有一份;
23
+ * 渲染出口(SlotOutlet)各壳自持——条目外层的包装是载体自己的事。
24
+ */
25
+ export * from './slots-react.js';
26
+ /**
27
+ * 原生桥的规格(操作名 + 实参形状 + 校验)也从这里转出去。
28
+ *
29
+ * 为什么宿主侧的一份 `core` 模块能进界面壳的入口:`core/native-bridge.ts` 与上面几份
30
+ * 守同一个约束——**零 node 依赖、浏览器安全**。桌面主进程与界面壳因此读的是同一份规格:
31
+ * 加一个原生操作,两侧同时知道;漂移在编译期就暴露(而不是等线上某个插件调到 undefined)。
32
+ */
33
+ export * from '../core/native-bridge.js';
34
+ /**
35
+ * 正文 token 粗估(`core/token-estimate.ts`)也进共享面:消息流的「~N tok」回落读数
36
+ * 与宿主自动压缩的阈值必须同源。它与 native-bridge 守同一条约束——纯函数、零 node 依赖、
37
+ * 浏览器安全,所以界面壳可以直接拿这一份,不必在壳里再抄一个口径。
38
+ */
39
+ export * from '../core/token-estimate.js';
40
+ /**
41
+ * 模型能力枚举(`core/model-caps.ts`):设置 → 模型页的思考档位 / 档位字段 / 输入模态
42
+ * 三组勾选与这里一字不差——档位清单、中文标签、线上值提示只有一份,宿主发请求的口径
43
+ * 与界面上勾的东西才不会各说各话。同一条约束(type-only import,浏览器安全)。
44
+ */
45
+ export * from '../core/model-caps.js';
46
+ /**
47
+ * 文本差异算法(`core/diff-text.ts`)同理进共享面:工具卡的「将做的改动」在界面侧
48
+ * 从参数 + 盘上现值推演 diff,用的就是宿主算轮尾差异的同一份算法。
49
+ */
50
+ export * from '../core/diff-text.js';
51
+ /**
52
+ * 宿主那些**界面要读的**视图类型的再导出。
53
+ *
54
+ * 为什么全是 `export type`:编译期就擦掉了,浏览器壳不会因为这一行把 `contract.ts`
55
+ * 拉进包里,也就不引入任何运行期耦合。为什么值得这么做:消息流要按条目种类分别渲染,
56
+ * 靠 `unknown` 手写类型收窄的话,宿主改一个字段名壳这边不会报错——那恰好是最该被
57
+ * 编译器抓住的一类改动。
58
+ */
59
+ export type { ApprovalAnswer, ArchivedPage, ArchivedSessionView, ApprovalDiffView, ApprovalPolicy, ApprovalReviewer, PermissionPresetSurface, PermissionPresetView, ApprovalRequestView, AskOptionView, AskUserView, BackgroundOutputView, BackgroundWorkView, ChangedFileView, CollaborationMode, ConnectionTestOutcome, ConnectionTestView, ContextSegmentsView, DiffHunkView, DiffLineView, EffortLevel, EffortMap, GitSurface, GoalView, LinkShareData, ModeSurface, ModelChoiceView, ModelConfigView, Modality, NoticeMessageView, PairShareData, PlanDecision, PlanEntryView, PlanView, PolicySurface, PresetDraft, PresetFileView, PresetSurface, PresetView, ProviderDraft, ProviderModelView, ProviderView, QueuedMessageView, RuntimeSnapshot, ScheduledTaskView, SessionRunState, SessionSummary, SettingsField, SettingsGroupView, SettingsMutation, SettingsSectionView, SettingsValue, SettingsValues, StatusView, SubagentCardView, TeammateView, ThemeMode, ThinkingLevel, ThinkingParam, TierOption, TodoItemView, TodoStatus, TodoView, TokenUsageView, ToolCallView, ToolEntryView, ToolStatus, TranscriptEntry, TurnEndReason, UiDensity, UiFontSize, UiCommandView, UiPrefsView, UsageDayView, UsageModelView, UsageStatsView, } from '../contract.js';
@@ -0,0 +1,50 @@
1
+ /**
2
+ * 插件版界面的共用核心:宿主(组清单、发 bundle)与界面壳(建注册表、装插件)
3
+ * 共用这一份,浏览器安全——不 import 任何 node 内置模块。
4
+ *
5
+ * @module dsc/ui
6
+ */
7
+ export * from './frames.js';
8
+ export * from './manifest.js';
9
+ export * from './arrival.js';
10
+ export * from './plugin.js';
11
+ export * from './slots.js';
12
+ export * from './store.js';
13
+ export * from './scoped-slots.js';
14
+ export * from './services.js';
15
+ /**
16
+ * 服务表的 React 订阅面(`ServicesProvider` / `useService`):壳把装载出来的服务表
17
+ * 经 context 交给条目组件,插件跟着服务的出现/消失换数据源。
18
+ */
19
+ export * from './services-react.js';
20
+ /**
21
+ * 槽位注册表的 React 订阅面(useSlot / useSlotFaults):浏览器壳与终端壳共用。
22
+ * 为什么在共享层:两个壳的「组件」都是 React 组件,订阅语义只有一份;
23
+ * 渲染出口(SlotOutlet)各壳自持——条目外层的包装是载体自己的事。
24
+ */
25
+ export * from './slots-react.js';
26
+ /**
27
+ * 原生桥的规格(操作名 + 实参形状 + 校验)也从这里转出去。
28
+ *
29
+ * 为什么宿主侧的一份 `core` 模块能进界面壳的入口:`core/native-bridge.ts` 与上面几份
30
+ * 守同一个约束——**零 node 依赖、浏览器安全**。桌面主进程与界面壳因此读的是同一份规格:
31
+ * 加一个原生操作,两侧同时知道;漂移在编译期就暴露(而不是等线上某个插件调到 undefined)。
32
+ */
33
+ export * from '../core/native-bridge.js';
34
+ /**
35
+ * 正文 token 粗估(`core/token-estimate.ts`)也进共享面:消息流的「~N tok」回落读数
36
+ * 与宿主自动压缩的阈值必须同源。它与 native-bridge 守同一条约束——纯函数、零 node 依赖、
37
+ * 浏览器安全,所以界面壳可以直接拿这一份,不必在壳里再抄一个口径。
38
+ */
39
+ export * from '../core/token-estimate.js';
40
+ /**
41
+ * 模型能力枚举(`core/model-caps.ts`):设置 → 模型页的思考档位 / 档位字段 / 输入模态
42
+ * 三组勾选与这里一字不差——档位清单、中文标签、线上值提示只有一份,宿主发请求的口径
43
+ * 与界面上勾的东西才不会各说各话。同一条约束(type-only import,浏览器安全)。
44
+ */
45
+ export * from '../core/model-caps.js';
46
+ /**
47
+ * 文本差异算法(`core/diff-text.ts`)同理进共享面:工具卡的「将做的改动」在界面侧
48
+ * 从参数 + 盘上现值推演 diff,用的就是宿主算轮尾差异的同一份算法。
49
+ */
50
+ export * from '../core/diff-text.js';
@@ -0,0 +1,172 @@
1
+ /**
2
+ * 插件版界面的启动清单(boot graph):宿主告诉界面壳「要加载哪几个插件包、
3
+ * 按什么顺序、每个包从哪个地址取」。
4
+ *
5
+ * 这一份是宿主与浏览器壳之间的**唯一契约**(对齐 dsh 的 `window.__DSH_BOOT__`
6
+ * 与它的 WebBootEntry / WebBootGraph)。
7
+ *
8
+ * 为什么顺序要算而不是照抄声明顺序:插件包之间有依赖(A 的组件要 import B 的槽),
9
+ * 顺序错了 A 会在 B 的槽还没声明时去注册,当场报错。所以这里做一次拓扑排序,
10
+ * 并且在成环时**报出来是哪几个包成环**而不是死循环。
11
+ *
12
+ * @module dsc/ui/manifest
13
+ */
14
+ /** 插件包能跑在哪种壳里。web = 浏览器壳(桌面与远程共用),tui = 终端壳(同进程)。 */
15
+ export type UiPlatform = 'web' | 'tui';
16
+ /**
17
+ * 一个批的调度档位:`early` 是首屏批(壳装完它才画第一帧),`application` 是其余全部。
18
+ *
19
+ * 为什么不用参考实现的 `'bootstrap' | 'application'`:它的 bootstrap 批是**页面里的模块系统
20
+ * 本身**(parser-blocking、先于壳执行);dsc 的壳就是普通 ESM app,没有这一层。照抄会得到一个
21
+ * 永远为空的批或一个误导性的词。只对齐「批描述符 + 每 entry 恰属一批」的不变量,词表用我们自己的。
22
+ *
23
+ * 这是**页面加载级**的属性:HMR 重更一条插件不会改它的 phase,改 phase 要刷新页面。
24
+ */
25
+ export type UiBootPhase = 'early' | 'application';
26
+ /**
27
+ * 一个启动批:一次取数覆盖的一组成员。
28
+ *
29
+ * 批 URL 是 combo(`plugins/??<id>/client.js,…&rev=<批 rev>`,A3 起由
30
+ * {@link uiComboBatchUrl} 生成);`url`/`rev` 可选是为了向前兼容——旧宿主(或探针手工组图)不给
31
+ * 这两个字段时,界面壳按 entries 逐条走单资源 URL。
32
+ */
33
+ export interface UiBootBatch {
34
+ phase: UiBootPhase;
35
+ /** 批脚本的地址(document-relative,形状同 {@link UiPluginEntry.url})。 */
36
+ url?: string;
37
+ /** 批内容的版本锚:任一成员 rev 变则它变(与 url 同生共死)。 */
38
+ rev?: string;
39
+ /** 本批要注册工厂的 entry id,按执行顺序。 */
40
+ entries: string[];
41
+ }
42
+ /** 宿主发现的一个插件包(还没算地址)。 */
43
+ export interface UiPluginRow {
44
+ /** 稳定 id,也是 /plugins/<id>/client.js 里的那一段。 */
45
+ id: string;
46
+ /** 允许它 import 的额外模块名;其余一律拒绝(白名单,见界面壳的加载器)。 */
47
+ external?: string[];
48
+ /**
49
+ * 依赖名单。**双关**:先按「清单里另一个插件的 id」解(拓扑排序用的就是它),
50
+ * 再按「服务名」解(A1 的服务表里有没有提供者)。
51
+ *
52
+ * 顺序上的意义只是优化(被依赖的排前面);硬语义在装载器:两条路都解不到时这个插件
53
+ * **不 apply**,报告里留一行中文原因(「插件 X 没装上:…」或「服务 X 还没有提供者」)。
54
+ * 提供者缺席要软降级(有回落实现)的插件不要写进来,用 `ui.consume` 在渲染期读。
55
+ */
56
+ inject?: string[];
57
+ /** 第一档预取:需要尽早出现的插件(大小药丸、状态条之类)。与 phase 正交。 */
58
+ immediately?: boolean;
59
+ /** 调度档位;缺省 application。只对 web 载体的批有意义(TUI 是同进程顺序装载)。 */
60
+ phase?: UiBootPhase;
61
+ /** 缺省 web。 */
62
+ platform?: UiPlatform;
63
+ /**
64
+ * 插件声明的 `@dsc/ui` 契约版本区间(semver,如 `^1.0.0`)。宿主拿它对壳的
65
+ * `apiVersion` 做门禁:不满足就不进启动图,原因写进 problems——
66
+ * 判定在宿主侧,浏览器产物里不需要 semver。内置清单(构建产物自带
67
+ * `apiVersion`)的条目没有这一项,视为与壳同源、总是满足。
68
+ */
69
+ api?: string;
70
+ }
71
+ /** 清单里的一条(已经算好地址与版本)。 */
72
+ export interface UiPluginEntry {
73
+ id: string;
74
+ /** 相对页面的地址,形如 `plugins/hello/client.js?rev=abc123`。 */
75
+ url: string;
76
+ /** 产物版本:文件内容的短哈希,换字节就换地址。 */
77
+ rev: string;
78
+ inject?: string[];
79
+ external?: string[];
80
+ immediately?: boolean;
81
+ }
82
+ /** 宿主注入页面的启动图。 */
83
+ export interface UiBootGraph {
84
+ /** 整图的一致性锚:任一条(含声明的 phase)变了它就变。 */
85
+ rev: string;
86
+ entries: UiPluginEntry[];
87
+ /**
88
+ * 启动批,按执行顺序(early 在前)。每个 entry 恰好属于一个批;
89
+ * 没有 `phase` 声明的条目全部进 application 批——零声明的现状就是单批一行。
90
+ */
91
+ batches: UiBootBatch[];
92
+ /** 界面壳要显示的宿主身份(哪台机器、哪个版本)。 */
93
+ host: {
94
+ name: string;
95
+ version: string;
96
+ };
97
+ }
98
+ /** 摘要函数:把若干字段拼成一个短哈希。默认那份不依赖 node,浏览器壳也能算。 */
99
+ export type HashFn = (...parts: readonly string[]) => string;
100
+ /**
101
+ * 一个插件包的地址。相对路径:页面挂在 `/` 或子路径下都成立。
102
+ * @param id - 插件 id
103
+ * @param rev - 产物版本
104
+ */
105
+ export declare function pluginBundleUrl(id: string, rev: string): string;
106
+ /**
107
+ * 一个批的 combo 地址:`plugins/??<id>/client.js,<id>/client.js&rev=<批 rev>`。
108
+ *
109
+ * 形状对齐参考实现(每个资源带 `/client.js` 后缀、`rev` 用 `&` 分隔);批的 rev 是
110
+ * 成员 rev 的派生({@link uiComboBatchRev}),所以任一成员换字节整个批地址就换。
111
+ * 这是**路由地址**,不是产物路径——`??` 是宿主路由的判据。
112
+ *
113
+ * id 单段编码:第三方 id 可能是 `@scope/name`,`/` 在 query 里合法但编码最省心;
114
+ * 宿主按精确 URL 查表,浏览器原样转述这里生成的串,两边不会分叉。
115
+ */
116
+ export declare function uiComboBatchUrl(ids: readonly string[], rev: string): string;
117
+ /** 批 rev:成员 rev 的有序派生(任一成员变则变)。 */
118
+ export declare function uiComboBatchRev(members: readonly {
119
+ id: string;
120
+ rev: string;
121
+ }[]): string;
122
+ /** 把若干字段拼成短哈希;字段间加长度前缀,防止内容在字段边界上搬家。 */
123
+ export declare function shortHash(...parts: readonly string[]): string;
124
+ /** 文件系统指纹:mtime / ctime / 大小三项,够判「文件换了没有」。 */
125
+ export interface ArtifactStat {
126
+ mtimeMs: number;
127
+ ctimeMs: number;
128
+ size: number;
129
+ }
130
+ /**
131
+ * 由文件指纹算产物版本(不读文件内容,构建后立刻能算)。
132
+ *
133
+ * 指纹取毫秒原值而不是取整:同一毫秒内、大小又恰好相同的重写会算出同一个版本,
134
+ * 那样浏览器一年内都不会回源拿新字节。
135
+ * @param stat - 文件指纹
136
+ * @param hash - 摘要函数;宿主侧传 sha256 那份(浏览器壳用不到这个函数)
137
+ */
138
+ export declare function artifactRev(stat: ArtifactStat, hash?: HashFn): string;
139
+ /**
140
+ * 拓扑排序:被依赖的排在依赖者前面。
141
+ *
142
+ * 快照顺序来自宿主的扫描顺序(调用方传进来的顺序),只有依赖边会改变它,
143
+ * 所以同一批插件每次算出来的顺序都一样,界面不会重排。
144
+ *
145
+ * 顺序只是**优化**不是正确性前提:插件要往别人声明的槽里放东西,用
146
+ * `slots.injectSlot` 等声明出现即可,排不排都能成。
147
+ *
148
+ * @param rows - 宿主发现的插件包
149
+ * @returns 排好序的一份新数组
150
+ * @throws {Error} 成环或 id 重复时抛出(后者会让界面静默少一块,不能放过)
151
+ */
152
+ export declare function orderUiPlugins<T extends UiPluginRow>(rows: readonly T[]): T[];
153
+ /**
154
+ * 由「插件 id + 产物版本」拼出启动图。顺序与分批在这里定,地址在这里算。
155
+ *
156
+ * 整图 rev 对**整条 entry**(含 inject / external / immediately)与**批结构**
157
+ * (含每条声明的 phase)做摘要:只改清单里的声明(不动 bundle)时整图 rev 也必须跟着变,
158
+ * 否则「靠 rev 判断要不要重载」的那一侧会漏掉声明类变更。
159
+ *
160
+ * 分批规则:按 phase 切片(early 在前),批内保持 `orderUiPlugins` 之后的相对顺序;
161
+ * 没写 phase 的条目全部进 application——零声明的现状等于「单批」,与今天的加载顺序等价。
162
+ * 空批不发(entries 非空不变量)。
163
+ *
164
+ * @param host - 宿主身份
165
+ * @param artifacts - 已算出 rev 的插件包(顺序即扫描顺序)
166
+ */
167
+ export declare function composeUiBootGraph(host: {
168
+ name: string;
169
+ version: string;
170
+ }, artifacts: readonly (UiPluginRow & {
171
+ rev: string;
172
+ })[]): UiBootGraph;
@@ -0,0 +1,158 @@
1
+ /**
2
+ * 插件版界面的启动清单(boot graph):宿主告诉界面壳「要加载哪几个插件包、
3
+ * 按什么顺序、每个包从哪个地址取」。
4
+ *
5
+ * 这一份是宿主与浏览器壳之间的**唯一契约**(对齐 dsh 的 `window.__DSH_BOOT__`
6
+ * 与它的 WebBootEntry / WebBootGraph)。
7
+ *
8
+ * 为什么顺序要算而不是照抄声明顺序:插件包之间有依赖(A 的组件要 import B 的槽),
9
+ * 顺序错了 A 会在 B 的槽还没声明时去注册,当场报错。所以这里做一次拓扑排序,
10
+ * 并且在成环时**报出来是哪几个包成环**而不是死循环。
11
+ *
12
+ * @module dsc/ui/manifest
13
+ */
14
+ /** 短哈希长度(与 dsh 的 12 位一致:够短不撞,也够眼睛扫)。 */
15
+ const HASH_LENGTH = 12;
16
+ /**
17
+ * 一个插件包的地址。相对路径:页面挂在 `/` 或子路径下都成立。
18
+ * @param id - 插件 id
19
+ * @param rev - 产物版本
20
+ */
21
+ export function pluginBundleUrl(id, rev) {
22
+ return `plugins/${encodeURIComponent(id)}/client.js?rev=${rev}`;
23
+ }
24
+ /**
25
+ * 一个批的 combo 地址:`plugins/??<id>/client.js,<id>/client.js&rev=<批 rev>`。
26
+ *
27
+ * 形状对齐参考实现(每个资源带 `/client.js` 后缀、`rev` 用 `&` 分隔);批的 rev 是
28
+ * 成员 rev 的派生({@link uiComboBatchRev}),所以任一成员换字节整个批地址就换。
29
+ * 这是**路由地址**,不是产物路径——`??` 是宿主路由的判据。
30
+ *
31
+ * id 单段编码:第三方 id 可能是 `@scope/name`,`/` 在 query 里合法但编码最省心;
32
+ * 宿主按精确 URL 查表,浏览器原样转述这里生成的串,两边不会分叉。
33
+ */
34
+ export function uiComboBatchUrl(ids, rev) {
35
+ const resources = ids.map((id) => `${encodeURIComponent(id)}/client.js`).join(',');
36
+ return `plugins/??${resources}&rev=${rev}`;
37
+ }
38
+ /** 批 rev:成员 rev 的有序派生(任一成员变则变)。 */
39
+ export function uiComboBatchRev(members) {
40
+ return shortHash('uicombo', ...members.flatMap((member) => [member.id, member.rev]));
41
+ }
42
+ /** 把若干字段拼成短哈希;字段间加长度前缀,防止内容在字段边界上搬家。 */
43
+ export function shortHash(...parts) {
44
+ // FNV-1a 32 位,重复四轮拼成 48 位——比 sha1 省一次 crypto 依赖(浏览器壳里没有 node:crypto),
45
+ // 用途只是「换文件就换地址」,不承担安全职责。
46
+ let out = '';
47
+ for (let round = 0; round < 4; round += 1) {
48
+ let hash = 0x811c9dc5 ^ round;
49
+ for (const part of parts) {
50
+ const text = `${part.length}:${part}`;
51
+ for (let index = 0; index < text.length; index += 1) {
52
+ hash ^= text.charCodeAt(index);
53
+ hash = Math.imul(hash, 0x01000193) >>> 0;
54
+ }
55
+ }
56
+ out += hash.toString(16).padStart(8, '0');
57
+ }
58
+ return out.slice(0, HASH_LENGTH);
59
+ }
60
+ /**
61
+ * 由文件指纹算产物版本(不读文件内容,构建后立刻能算)。
62
+ *
63
+ * 指纹取毫秒原值而不是取整:同一毫秒内、大小又恰好相同的重写会算出同一个版本,
64
+ * 那样浏览器一年内都不会回源拿新字节。
65
+ * @param stat - 文件指纹
66
+ * @param hash - 摘要函数;宿主侧传 sha256 那份(浏览器壳用不到这个函数)
67
+ */
68
+ export function artifactRev(stat, hash = shortHash) {
69
+ return hash('artifact', String(stat.mtimeMs), String(stat.ctimeMs), String(stat.size));
70
+ }
71
+ /**
72
+ * 拓扑排序:被依赖的排在依赖者前面。
73
+ *
74
+ * 快照顺序来自宿主的扫描顺序(调用方传进来的顺序),只有依赖边会改变它,
75
+ * 所以同一批插件每次算出来的顺序都一样,界面不会重排。
76
+ *
77
+ * 顺序只是**优化**不是正确性前提:插件要往别人声明的槽里放东西,用
78
+ * `slots.injectSlot` 等声明出现即可,排不排都能成。
79
+ *
80
+ * @param rows - 宿主发现的插件包
81
+ * @returns 排好序的一份新数组
82
+ * @throws {Error} 成环或 id 重复时抛出(后者会让界面静默少一块,不能放过)
83
+ */
84
+ export function orderUiPlugins(rows) {
85
+ const byId = new Map();
86
+ for (const row of rows) {
87
+ if (byId.has(row.id)) {
88
+ throw new Error(`启动清单里有两个 id 相同的界面插件:${row.id}(按 id 去重会静默少装一个)`);
89
+ }
90
+ byId.set(row.id, row);
91
+ }
92
+ const ordered = [];
93
+ const placed = new Set();
94
+ const open = [];
95
+ const visit = (row) => {
96
+ if (placed.has(row.id))
97
+ return;
98
+ const cycleStart = open.indexOf(row.id);
99
+ if (cycleStart >= 0) {
100
+ throw new Error(`界面插件依赖成环:${[...open.slice(cycleStart), row.id].join(' -> ')}`
101
+ + '(inject 是「先注册工厂」的边,不能互相等)');
102
+ }
103
+ open.push(row.id);
104
+ for (const name of row.inject ?? []) {
105
+ if (name === row.id)
106
+ throw new Error(`界面插件 ${row.id} 把自己写进了 inject`);
107
+ const dependency = byId.get(name);
108
+ if (dependency !== undefined)
109
+ visit(dependency);
110
+ }
111
+ open.pop();
112
+ placed.add(row.id);
113
+ ordered.push(row);
114
+ };
115
+ for (const row of rows)
116
+ visit(row);
117
+ return ordered;
118
+ }
119
+ /**
120
+ * 由「插件 id + 产物版本」拼出启动图。顺序与分批在这里定,地址在这里算。
121
+ *
122
+ * 整图 rev 对**整条 entry**(含 inject / external / immediately)与**批结构**
123
+ * (含每条声明的 phase)做摘要:只改清单里的声明(不动 bundle)时整图 rev 也必须跟着变,
124
+ * 否则「靠 rev 判断要不要重载」的那一侧会漏掉声明类变更。
125
+ *
126
+ * 分批规则:按 phase 切片(early 在前),批内保持 `orderUiPlugins` 之后的相对顺序;
127
+ * 没写 phase 的条目全部进 application——零声明的现状等于「单批」,与今天的加载顺序等价。
128
+ * 空批不发(entries 非空不变量)。
129
+ *
130
+ * @param host - 宿主身份
131
+ * @param artifacts - 已算出 rev 的插件包(顺序即扫描顺序)
132
+ */
133
+ export function composeUiBootGraph(host, artifacts) {
134
+ const ordered = orderUiPlugins(artifacts);
135
+ const entries = ordered.map((artifact) => ({
136
+ id: artifact.id,
137
+ url: pluginBundleUrl(artifact.id, artifact.rev),
138
+ rev: artifact.rev,
139
+ ...(artifact.inject === undefined ? {} : { inject: artifact.inject }),
140
+ ...(artifact.external === undefined ? {} : { external: artifact.external }),
141
+ ...(artifact.immediately === true ? { immediately: true } : {}),
142
+ }));
143
+ const batches = [];
144
+ for (const phase of ['early', 'application']) {
145
+ const members = ordered.filter((artifact) => (artifact.phase ?? 'application') === phase);
146
+ if (members.length === 0)
147
+ continue;
148
+ const rev = uiComboBatchRev(members.map((member) => ({ id: member.id, rev: member.rev })));
149
+ batches.push({
150
+ phase,
151
+ entries: members.map((member) => member.id),
152
+ rev,
153
+ url: uiComboBatchUrl(members.map((member) => member.id), rev),
154
+ });
155
+ }
156
+ const rev = shortHash('uiboot', JSON.stringify(entries), JSON.stringify(batches));
157
+ return { rev, entries, batches, host };
158
+ }