@waq666/pneuma 0.0.0-stage → 0.7.0

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 (687) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +144 -2
  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 +13 -0
  16. package/lib/app/App.js +1498 -0
  17. package/lib/app/ApprovalCard.d.ts +12 -0
  18. package/lib/app/ApprovalCard.js +76 -0
  19. package/lib/app/AskCard.d.ts +20 -0
  20. package/lib/app/AskCard.js +45 -0
  21. package/lib/app/ChatView.d.ts +32 -0
  22. package/lib/app/ChatView.js +198 -0
  23. package/lib/app/Composer.d.ts +50 -0
  24. package/lib/app/Composer.js +282 -0
  25. package/lib/app/DiffBlock.d.ts +6 -0
  26. package/lib/app/DiffBlock.js +37 -0
  27. package/lib/app/MarkdownView.d.ts +6 -0
  28. package/lib/app/MarkdownView.js +99 -0
  29. package/lib/app/ModelPicker.d.ts +7 -0
  30. package/lib/app/ModelPicker.js +18 -0
  31. package/lib/app/PlanReviewCard.d.ts +13 -0
  32. package/lib/app/PlanReviewCard.js +54 -0
  33. package/lib/app/PresetPicker.d.ts +11 -0
  34. package/lib/app/PresetPicker.js +19 -0
  35. package/lib/app/PreviewOverlay.d.ts +14 -0
  36. package/lib/app/PreviewOverlay.js +22 -0
  37. package/lib/app/SessionPicker.d.ts +43 -0
  38. package/lib/app/SessionPicker.js +56 -0
  39. package/lib/app/SettingsOverlay.d.ts +32 -0
  40. package/lib/app/SettingsOverlay.js +157 -0
  41. package/lib/app/SkillsPicker.d.ts +7 -0
  42. package/lib/app/SkillsPicker.js +19 -0
  43. package/lib/app/StatusBar.d.ts +22 -0
  44. package/lib/app/StatusBar.js +272 -0
  45. package/lib/app/TaskStrips.d.ts +13 -0
  46. package/lib/app/TaskStrips.js +40 -0
  47. package/lib/app/ToolCard.d.ts +5 -0
  48. package/lib/app/ToolCard.js +40 -0
  49. package/lib/app/TranscriptOverlay.d.ts +12 -0
  50. package/lib/app/TranscriptOverlay.js +17 -0
  51. package/lib/app/Welcome.d.ts +6 -0
  52. package/lib/app/Welcome.js +66 -0
  53. package/lib/app/attach.d.ts +16 -0
  54. package/lib/app/attach.js +58 -0
  55. package/lib/app/click.d.ts +27 -0
  56. package/lib/app/click.js +89 -0
  57. package/lib/app/clipboard-image.d.ts +11 -0
  58. package/lib/app/clipboard-image.js +66 -0
  59. package/lib/app/cursor.d.ts +4 -0
  60. package/lib/app/cursor.js +24 -0
  61. package/lib/app/hello.d.ts +11 -0
  62. package/lib/app/hello.js +8 -0
  63. package/lib/app/history-store.d.ts +4 -0
  64. package/lib/app/history-store.js +41 -0
  65. package/lib/app/image-blocks.d.ts +12 -0
  66. package/lib/app/image-blocks.js +125 -0
  67. package/lib/app/markdown.d.ts +54 -0
  68. package/lib/app/markdown.js +189 -0
  69. package/lib/app/settings-model.d.ts +69 -0
  70. package/lib/app/settings-model.js +114 -0
  71. package/lib/app/theme.d.ts +166 -0
  72. package/lib/app/theme.js +141 -0
  73. package/lib/boot.d.ts +1 -0
  74. package/lib/boot.js +34 -0
  75. package/lib/commands.d.ts +49 -0
  76. package/lib/commands.js +115 -0
  77. package/lib/contract.d.ts +1973 -0
  78. package/lib/contract.js +36 -0
  79. package/lib/core/agent-roles.d.ts +52 -0
  80. package/lib/core/agent-roles.js +274 -0
  81. package/lib/core/approval-floor.d.ts +183 -0
  82. package/lib/core/approval-floor.js +679 -0
  83. package/lib/core/approval.d.ts +42 -0
  84. package/lib/core/approval.js +8 -0
  85. package/lib/core/audit.d.ts +61 -0
  86. package/lib/core/audit.js +59 -0
  87. package/lib/core/boot-notices.d.ts +6 -0
  88. package/lib/core/boot-notices.js +61 -0
  89. package/lib/core/cdp/actions.d.ts +182 -0
  90. package/lib/core/cdp/actions.js +649 -0
  91. package/lib/core/cdp/launch.d.ts +192 -0
  92. package/lib/core/cdp/launch.js +491 -0
  93. package/lib/core/cdp/snapshot.d.ts +139 -0
  94. package/lib/core/cdp/snapshot.js +316 -0
  95. package/lib/core/cdp/transport.d.ts +160 -0
  96. package/lib/core/cdp/transport.js +359 -0
  97. package/lib/core/command-policy.d.ts +108 -0
  98. package/lib/core/command-policy.js +580 -0
  99. package/lib/core/commands-completion.d.ts +78 -0
  100. package/lib/core/commands-completion.js +167 -0
  101. package/lib/core/compact-anchors.d.ts +76 -0
  102. package/lib/core/compact-anchors.js +284 -0
  103. package/lib/core/compact.d.ts +110 -0
  104. package/lib/core/compact.js +210 -0
  105. package/lib/core/config-store.d.ts +38 -0
  106. package/lib/core/config-store.js +307 -0
  107. package/lib/core/config.d.ts +36 -0
  108. package/lib/core/config.js +124 -0
  109. package/lib/core/connection-test.d.ts +60 -0
  110. package/lib/core/connection-test.js +84 -0
  111. package/lib/core/desktop-control.d.ts +298 -0
  112. package/lib/core/desktop-control.js +1311 -0
  113. package/lib/core/diff-text.d.ts +74 -0
  114. package/lib/core/diff-text.js +257 -0
  115. package/lib/core/dock-browser.d.ts +137 -0
  116. package/lib/core/dock-browser.js +146 -0
  117. package/lib/core/dock-ops.d.ts +59 -0
  118. package/lib/core/dock-ops.js +104 -0
  119. package/lib/core/dock-session.d.ts +39 -0
  120. package/lib/core/dock-session.js +28 -0
  121. package/lib/core/dsh-compat/hook.d.ts +18 -0
  122. package/lib/core/dsh-compat/hook.js +52 -0
  123. package/lib/core/dsh-compat/resolve-hook.d.ts +5 -0
  124. package/lib/core/dsh-compat/resolve-hook.js +59 -0
  125. package/lib/core/dsh-compat/tools-facade.d.ts +47 -0
  126. package/lib/core/dsh-compat/tools-facade.js +108 -0
  127. package/lib/core/err-text.d.ts +13 -0
  128. package/lib/core/err-text.js +15 -0
  129. package/lib/core/events.d.ts +149 -0
  130. package/lib/core/events.js +1 -0
  131. package/lib/core/git-exec.d.ts +23 -0
  132. package/lib/core/git-exec.js +72 -0
  133. package/lib/core/git-info.d.ts +47 -0
  134. package/lib/core/git-info.js +157 -0
  135. package/lib/core/goal.d.ts +89 -0
  136. package/lib/core/goal.js +189 -0
  137. package/lib/core/hooks.d.ts +272 -0
  138. package/lib/core/hooks.js +818 -0
  139. package/lib/core/host-browser-link.d.ts +59 -0
  140. package/lib/core/host-browser-link.js +9 -0
  141. package/lib/core/host-methods.d.ts +25 -0
  142. package/lib/core/host-methods.js +103 -0
  143. package/lib/core/image-diet.d.ts +77 -0
  144. package/lib/core/image-diet.js +127 -0
  145. package/lib/core/learnings/ledger.d.ts +73 -0
  146. package/lib/core/learnings/ledger.js +273 -0
  147. package/lib/core/learnings/skill-write.d.ts +250 -0
  148. package/lib/core/learnings/skill-write.js +854 -0
  149. package/lib/core/learnings/store.d.ts +102 -0
  150. package/lib/core/learnings/store.js +266 -0
  151. package/lib/core/lifecycle-hooks.d.ts +189 -0
  152. package/lib/core/lifecycle-hooks.js +576 -0
  153. package/lib/core/llm.d.ts +272 -0
  154. package/lib/core/llm.js +548 -0
  155. package/lib/core/lockfile.d.ts +17 -0
  156. package/lib/core/lockfile.js +110 -0
  157. package/lib/core/loop.d.ts +185 -0
  158. package/lib/core/loop.js +587 -0
  159. package/lib/core/lsp/client.d.ts +189 -0
  160. package/lib/core/lsp/client.js +690 -0
  161. package/lib/core/lsp/framing.d.ts +84 -0
  162. package/lib/core/lsp/framing.js +181 -0
  163. package/lib/core/lsp/line-shift.d.ts +28 -0
  164. package/lib/core/lsp/line-shift.js +127 -0
  165. package/lib/core/lsp/manager.d.ts +93 -0
  166. package/lib/core/lsp/manager.js +418 -0
  167. package/lib/core/lsp/normalize.d.ts +32 -0
  168. package/lib/core/lsp/normalize.js +139 -0
  169. package/lib/core/lsp/servers.d.ts +106 -0
  170. package/lib/core/lsp/servers.js +352 -0
  171. package/lib/core/lsp/uri.d.ts +76 -0
  172. package/lib/core/lsp/uri.js +179 -0
  173. package/lib/core/market.d.ts +51 -0
  174. package/lib/core/market.js +358 -0
  175. package/lib/core/mcp.d.ts +201 -0
  176. package/lib/core/mcp.js +836 -0
  177. package/lib/core/memory-eval.d.ts +158 -0
  178. package/lib/core/memory-eval.js +215 -0
  179. package/lib/core/memory.d.ts +266 -0
  180. package/lib/core/memory.js +703 -0
  181. package/lib/core/mention.d.ts +57 -0
  182. package/lib/core/mention.js +129 -0
  183. package/lib/core/microcompact.d.ts +48 -0
  184. package/lib/core/microcompact.js +79 -0
  185. package/lib/core/migrate.d.ts +56 -0
  186. package/lib/core/migrate.js +134 -0
  187. package/lib/core/model-caps.d.ts +83 -0
  188. package/lib/core/model-caps.js +150 -0
  189. package/lib/core/model-discovery.d.ts +19 -0
  190. package/lib/core/model-discovery.js +69 -0
  191. package/lib/core/modes.d.ts +72 -0
  192. package/lib/core/modes.js +152 -0
  193. package/lib/core/native-bridge.d.ts +135 -0
  194. package/lib/core/native-bridge.js +563 -0
  195. package/lib/core/path-policy.d.ts +32 -0
  196. package/lib/core/path-policy.js +248 -0
  197. package/lib/core/permission-presets.d.ts +67 -0
  198. package/lib/core/permission-presets.js +75 -0
  199. package/lib/core/plugin-loader.d.ts +36 -0
  200. package/lib/core/plugin-loader.js +294 -0
  201. package/lib/core/plugin-registry.d.ts +113 -0
  202. package/lib/core/plugin-registry.js +256 -0
  203. package/lib/core/prefs.d.ts +82 -0
  204. package/lib/core/prefs.js +372 -0
  205. package/lib/core/presets.d.ts +80 -0
  206. package/lib/core/presets.js +373 -0
  207. package/lib/core/pricing.d.ts +90 -0
  208. package/lib/core/pricing.js +126 -0
  209. package/lib/core/prompt.d.ts +92 -0
  210. package/lib/core/prompt.js +339 -0
  211. package/lib/core/ptc.d.ts +66 -0
  212. package/lib/core/ptc.js +70 -0
  213. package/lib/core/remote/frames.d.ts +91 -0
  214. package/lib/core/remote/frames.js +174 -0
  215. package/lib/core/remote/notify.d.ts +54 -0
  216. package/lib/core/remote/notify.js +77 -0
  217. package/lib/core/remote/owner.d.ts +32 -0
  218. package/lib/core/remote/owner.js +75 -0
  219. package/lib/core/remote/pairing.d.ts +104 -0
  220. package/lib/core/remote/pairing.js +261 -0
  221. package/lib/core/remote/push.d.ts +80 -0
  222. package/lib/core/remote/push.js +222 -0
  223. package/lib/core/remote/store.d.ts +18 -0
  224. package/lib/core/remote/store.js +59 -0
  225. package/lib/core/remote/tickets.d.ts +20 -0
  226. package/lib/core/remote/tickets.js +49 -0
  227. package/lib/core/remote/uploads.d.ts +63 -0
  228. package/lib/core/remote/uploads.js +161 -0
  229. package/lib/core/request-attribution.d.ts +26 -0
  230. package/lib/core/request-attribution.js +86 -0
  231. package/lib/core/request-invariant.d.ts +61 -0
  232. package/lib/core/request-invariant.js +199 -0
  233. package/lib/core/sandbox/backends.d.ts +64 -0
  234. package/lib/core/sandbox/backends.js +194 -0
  235. package/lib/core/sandbox/execpolicy.d.ts +93 -0
  236. package/lib/core/sandbox/execpolicy.js +452 -0
  237. package/lib/core/sandbox/net-proxy.d.ts +31 -0
  238. package/lib/core/sandbox/net-proxy.js +162 -0
  239. package/lib/core/sandbox/policy.d.ts +211 -0
  240. package/lib/core/sandbox/policy.js +559 -0
  241. package/lib/core/sandbox/win/abi.d.ts +161 -0
  242. package/lib/core/sandbox/win/abi.js +169 -0
  243. package/lib/core/sandbox/win/account.d.ts +71 -0
  244. package/lib/core/sandbox/win/account.js +206 -0
  245. package/lib/core/sandbox/win/acl.d.ts +54 -0
  246. package/lib/core/sandbox/win/acl.js +339 -0
  247. package/lib/core/sandbox/win/backend.d.ts +61 -0
  248. package/lib/core/sandbox/win/backend.js +249 -0
  249. package/lib/core/sandbox/win/doctor.d.ts +24 -0
  250. package/lib/core/sandbox/win/doctor.js +272 -0
  251. package/lib/core/sandbox/win/ffi.d.ts +107 -0
  252. package/lib/core/sandbox/win/ffi.js +166 -0
  253. package/lib/core/sandbox/win/net-abi.d.ts +154 -0
  254. package/lib/core/sandbox/win/net-abi.js +316 -0
  255. package/lib/core/sandbox/win/runner-entry.d.ts +35 -0
  256. package/lib/core/sandbox/win/runner-entry.js +391 -0
  257. package/lib/core/sandbox/win/setup.d.ts +60 -0
  258. package/lib/core/sandbox/win/setup.js +986 -0
  259. package/lib/core/sandbox/win/token.d.ts +35 -0
  260. package/lib/core/sandbox/win/token.js +238 -0
  261. package/lib/core/sandbox/win/wfp.d.ts +41 -0
  262. package/lib/core/sandbox/win/wfp.js +200 -0
  263. package/lib/core/sandbox/win/workspace-sid.d.ts +9 -0
  264. package/lib/core/sandbox/win/workspace-sid.js +45 -0
  265. package/lib/core/schedule/rule.d.ts +184 -0
  266. package/lib/core/schedule/rule.js +745 -0
  267. package/lib/core/schedule/runner.d.ts +185 -0
  268. package/lib/core/schedule/runner.js +678 -0
  269. package/lib/core/schedule/store.d.ts +182 -0
  270. package/lib/core/schedule/store.js +455 -0
  271. package/lib/core/secrets.d.ts +41 -0
  272. package/lib/core/secrets.js +150 -0
  273. package/lib/core/session-export.d.ts +18 -0
  274. package/lib/core/session-export.js +73 -0
  275. package/lib/core/session-index.d.ts +159 -0
  276. package/lib/core/session-index.js +683 -0
  277. package/lib/core/session-meta.d.ts +41 -0
  278. package/lib/core/session-meta.js +97 -0
  279. package/lib/core/session.d.ts +356 -0
  280. package/lib/core/session.js +998 -0
  281. package/lib/core/skills.d.ts +60 -0
  282. package/lib/core/skills.js +171 -0
  283. package/lib/core/spill.d.ts +159 -0
  284. package/lib/core/spill.js +329 -0
  285. package/lib/core/surface-registry.d.ts +45 -0
  286. package/lib/core/surface-registry.js +67 -0
  287. package/lib/core/team-board.d.ts +95 -0
  288. package/lib/core/team-board.js +316 -0
  289. package/lib/core/throughput.d.ts +46 -0
  290. package/lib/core/throughput.js +40 -0
  291. package/lib/core/todo-reminder.d.ts +44 -0
  292. package/lib/core/todo-reminder.js +55 -0
  293. package/lib/core/todo.d.ts +81 -0
  294. package/lib/core/todo.js +222 -0
  295. package/lib/core/token-estimate.d.ts +55 -0
  296. package/lib/core/token-estimate.js +82 -0
  297. package/lib/core/tool-guards.d.ts +103 -0
  298. package/lib/core/tool-guards.js +77 -0
  299. package/lib/core/tool-search.d.ts +152 -0
  300. package/lib/core/tool-search.js +311 -0
  301. package/lib/core/tools/bash.d.ts +281 -0
  302. package/lib/core/tools/bash.js +871 -0
  303. package/lib/core/tools/command-runner.d.ts +84 -0
  304. package/lib/core/tools/command-runner.js +68 -0
  305. package/lib/core/tools/fs-tools.d.ts +23 -0
  306. package/lib/core/tools/fs-tools.js +247 -0
  307. package/lib/core/tools/index.d.ts +8 -0
  308. package/lib/core/tools/index.js +4 -0
  309. package/lib/core/tools/sandbox-args.d.ts +51 -0
  310. package/lib/core/tools/sandbox-args.js +90 -0
  311. package/lib/core/tools/search-tools.d.ts +3 -0
  312. package/lib/core/tools/search-tools.js +153 -0
  313. package/lib/core/tools.d.ts +96 -0
  314. package/lib/core/tools.js +53 -0
  315. package/lib/core/ui-boot-source.d.ts +71 -0
  316. package/lib/core/ui-boot-source.js +121 -0
  317. package/lib/core/ui-bundles.d.ts +249 -0
  318. package/lib/core/ui-bundles.js +830 -0
  319. package/lib/core/ui-combo.d.ts +49 -0
  320. package/lib/core/ui-combo.js +55 -0
  321. package/lib/core/ui-events.d.ts +81 -0
  322. package/lib/core/ui-events.js +364 -0
  323. package/lib/core/ui-hmr.d.ts +36 -0
  324. package/lib/core/ui-hmr.js +128 -0
  325. package/lib/core/ui-methods.d.ts +69 -0
  326. package/lib/core/ui-methods.js +341 -0
  327. package/lib/core/ui-route.d.ts +69 -0
  328. package/lib/core/ui-route.js +122 -0
  329. package/lib/core/ui-server.d.ts +75 -0
  330. package/lib/core/ui-server.js +369 -0
  331. package/lib/core/ui-trust.d.ts +47 -0
  332. package/lib/core/ui-trust.js +164 -0
  333. package/lib/core/untrusted.d.ts +30 -0
  334. package/lib/core/untrusted.js +48 -0
  335. package/lib/core/update-check.d.ts +81 -0
  336. package/lib/core/update-check.js +177 -0
  337. package/lib/core/usage-log.d.ts +82 -0
  338. package/lib/core/usage-log.js +306 -0
  339. package/lib/core/version.d.ts +1 -0
  340. package/lib/core/version.js +37 -0
  341. package/lib/core/web-http.d.ts +57 -0
  342. package/lib/core/web-http.js +137 -0
  343. package/lib/core/web-static.d.ts +31 -0
  344. package/lib/core/web-static.js +75 -0
  345. package/lib/headless.d.ts +1 -0
  346. package/lib/headless.js +31 -0
  347. package/lib/host/kernel.d.ts +33 -0
  348. package/lib/host/kernel.js +451 -0
  349. package/lib/index.d.ts +41 -0
  350. package/lib/index.js +35 -0
  351. package/lib/plugins/agent.d.ts +2 -0
  352. package/lib/plugins/agent.js +274 -0
  353. package/lib/plugins/approval-floor.d.ts +2 -0
  354. package/lib/plugins/approval-floor.js +223 -0
  355. package/lib/plugins/approval.d.ts +16 -0
  356. package/lib/plugins/approval.js +674 -0
  357. package/lib/plugins/ask.d.ts +2 -0
  358. package/lib/plugins/ask.js +245 -0
  359. package/lib/plugins/browser.d.ts +68 -0
  360. package/lib/plugins/browser.js +1341 -0
  361. package/lib/plugins/commands.d.ts +23 -0
  362. package/lib/plugins/commands.js +498 -0
  363. package/lib/plugins/compact.d.ts +21 -0
  364. package/lib/plugins/compact.js +274 -0
  365. package/lib/plugins/computer-use.d.ts +47 -0
  366. package/lib/plugins/computer-use.js +539 -0
  367. package/lib/plugins/desktop-dock.d.ts +2 -0
  368. package/lib/plugins/desktop-dock.js +626 -0
  369. package/lib/plugins/dock-browser.d.ts +34 -0
  370. package/lib/plugins/dock-browser.js +765 -0
  371. package/lib/plugins/dsh-compat.d.ts +25 -0
  372. package/lib/plugins/dsh-compat.js +37 -0
  373. package/lib/plugins/file-review.d.ts +108 -0
  374. package/lib/plugins/file-review.js +393 -0
  375. package/lib/plugins/git.d.ts +26 -0
  376. package/lib/plugins/git.js +132 -0
  377. package/lib/plugins/goal.d.ts +20 -0
  378. package/lib/plugins/goal.js +245 -0
  379. package/lib/plugins/guards.d.ts +14 -0
  380. package/lib/plugins/guards.js +18 -0
  381. package/lib/plugins/hooks.d.ts +19 -0
  382. package/lib/plugins/hooks.js +583 -0
  383. package/lib/plugins/host-stdio.d.ts +88 -0
  384. package/lib/plugins/host-stdio.js +317 -0
  385. package/lib/plugins/image-diet.d.ts +17 -0
  386. package/lib/plugins/image-diet.js +85 -0
  387. package/lib/plugins/lifecycle-hooks.d.ts +26 -0
  388. package/lib/plugins/lifecycle-hooks.js +338 -0
  389. package/lib/plugins/llm.d.ts +13 -0
  390. package/lib/plugins/llm.js +215 -0
  391. package/lib/plugins/lsp.d.ts +54 -0
  392. package/lib/plugins/lsp.js +608 -0
  393. package/lib/plugins/mcp.d.ts +16 -0
  394. package/lib/plugins/mcp.js +673 -0
  395. package/lib/plugins/memory.d.ts +17 -0
  396. package/lib/plugins/memory.js +858 -0
  397. package/lib/plugins/microcompact.d.ts +18 -0
  398. package/lib/plugins/microcompact.js +119 -0
  399. package/lib/plugins/mode.d.ts +18 -0
  400. package/lib/plugins/mode.js +115 -0
  401. package/lib/plugins/permission-presets.d.ts +18 -0
  402. package/lib/plugins/permission-presets.js +135 -0
  403. package/lib/plugins/plan.d.ts +2 -0
  404. package/lib/plugins/plan.js +192 -0
  405. package/lib/plugins/plugin-manager.d.ts +2 -0
  406. package/lib/plugins/plugin-manager.js +165 -0
  407. package/lib/plugins/presets.d.ts +2 -0
  408. package/lib/plugins/presets.js +182 -0
  409. package/lib/plugins/prompt.d.ts +2 -0
  410. package/lib/plugins/prompt.js +264 -0
  411. package/lib/plugins/ptc.d.ts +2 -0
  412. package/lib/plugins/ptc.js +272 -0
  413. package/lib/plugins/remote/http.d.ts +11 -0
  414. package/lib/plugins/remote/http.js +11 -0
  415. package/lib/plugins/remote/routes.d.ts +24 -0
  416. package/lib/plugins/remote/routes.js +384 -0
  417. package/lib/plugins/remote/types.d.ts +135 -0
  418. package/lib/plugins/remote/types.js +87 -0
  419. package/lib/plugins/remote.d.ts +17 -0
  420. package/lib/plugins/remote.js +1028 -0
  421. package/lib/plugins/runtime-api.d.ts +16 -0
  422. package/lib/plugins/runtime-api.js +99 -0
  423. package/lib/plugins/runtime.d.ts +10 -0
  424. package/lib/plugins/runtime.js +451 -0
  425. package/lib/plugins/sandbox.d.ts +2 -0
  426. package/lib/plugins/sandbox.js +761 -0
  427. package/lib/plugins/schedule.d.ts +26 -0
  428. package/lib/plugins/schedule.js +538 -0
  429. package/lib/plugins/self-improve.d.ts +61 -0
  430. package/lib/plugins/self-improve.js +953 -0
  431. package/lib/plugins/session-search.d.ts +16 -0
  432. package/lib/plugins/session-search.js +308 -0
  433. package/lib/plugins/session-title.d.ts +19 -0
  434. package/lib/plugins/session-title.js +109 -0
  435. package/lib/plugins/session.d.ts +7 -0
  436. package/lib/plugins/session.js +296 -0
  437. package/lib/plugins/settings.d.ts +3 -0
  438. package/lib/plugins/settings.js +705 -0
  439. package/lib/plugins/skills.d.ts +2 -0
  440. package/lib/plugins/skills.js +360 -0
  441. package/lib/plugins/spill.d.ts +16 -0
  442. package/lib/plugins/spill.js +200 -0
  443. package/lib/plugins/subagent.d.ts +2 -0
  444. package/lib/plugins/subagent.js +862 -0
  445. package/lib/plugins/surfaces.d.ts +11 -0
  446. package/lib/plugins/surfaces.js +20 -0
  447. package/lib/plugins/team.d.ts +16 -0
  448. package/lib/plugins/team.js +149 -0
  449. package/lib/plugins/todo.d.ts +19 -0
  450. package/lib/plugins/todo.js +188 -0
  451. package/lib/plugins/tool-search.d.ts +2 -0
  452. package/lib/plugins/tool-search.js +425 -0
  453. package/lib/plugins/tools-default.d.ts +12 -0
  454. package/lib/plugins/tools-default.js +275 -0
  455. package/lib/plugins/tools.d.ts +16 -0
  456. package/lib/plugins/tools.js +62 -0
  457. package/lib/plugins/transcript.d.ts +15 -0
  458. package/lib/plugins/transcript.js +311 -0
  459. package/lib/plugins/tui.d.ts +2 -0
  460. package/lib/plugins/tui.js +98 -0
  461. package/lib/plugins/waiting.d.ts +12 -0
  462. package/lib/plugins/waiting.js +34 -0
  463. package/lib/plugins/web-search.d.ts +14 -0
  464. package/lib/plugins/web-search.js +263 -0
  465. package/lib/plugins/webserver.d.ts +48 -0
  466. package/lib/plugins/webserver.js +228 -0
  467. package/lib/remote/assets/app-DAcUCOEn.js +14 -0
  468. package/lib/remote/assets/icon-192.png +0 -0
  469. package/lib/remote/assets/icon-512.png +0 -0
  470. package/lib/remote/assets/index.html +34 -0
  471. package/lib/remote/assets/manifest.json +27 -0
  472. package/lib/remote/assets/style-DIB6729x.css +1 -0
  473. package/lib/remote/assets/sw.js +66 -0
  474. package/lib/services/types.d.ts +1228 -0
  475. package/lib/services/types.js +1 -0
  476. package/lib/tools/config-cli.d.ts +1 -0
  477. package/lib/tools/config-cli.js +89 -0
  478. package/lib/ui/arrival.d.ts +72 -0
  479. package/lib/ui/arrival.js +105 -0
  480. package/lib/ui/assets/app-B70nVIKd.js +69 -0
  481. package/lib/ui/assets/chunk-2UxHyX5q.js +1 -0
  482. package/lib/ui/assets/chunk-B1dDrJ26.js +1 -0
  483. package/lib/ui/assets/chunk-B6aJPvgy.js +1 -0
  484. package/lib/ui/assets/chunk-BEwlwnbL.js +1 -0
  485. package/lib/ui/assets/chunk-BGcgwlCI.js +12 -0
  486. package/lib/ui/assets/chunk-BIGW1oBm.js +1 -0
  487. package/lib/ui/assets/chunk-BPQ3VLAy.js +1 -0
  488. package/lib/ui/assets/chunk-BRH0KZbk.js +141 -0
  489. package/lib/ui/assets/chunk-BX6H_ySx.js +1 -0
  490. package/lib/ui/assets/chunk-B_P3UbPa.js +1 -0
  491. package/lib/ui/assets/chunk-B_TYUkTI.js +1 -0
  492. package/lib/ui/assets/chunk-B_vNuMnf.js +1 -0
  493. package/lib/ui/assets/chunk-BajyYBss.js +10 -0
  494. package/lib/ui/assets/chunk-BdnUsdx6.js +1 -0
  495. package/lib/ui/assets/chunk-Buea-lGh.js +1 -0
  496. package/lib/ui/assets/chunk-C0PvZCCE.js +1 -0
  497. package/lib/ui/assets/chunk-C0m74zRD.js +1 -0
  498. package/lib/ui/assets/chunk-C27-OAKa.js +1 -0
  499. package/lib/ui/assets/chunk-C2oV4EkX.js +1 -0
  500. package/lib/ui/assets/chunk-C7zT0LnQ.js +1 -0
  501. package/lib/ui/assets/chunk-C9GSunVT.js +1 -0
  502. package/lib/ui/assets/chunk-C9tS-k6U.js +1 -0
  503. package/lib/ui/assets/chunk-CHLpvVh8.js +1 -0
  504. package/lib/ui/assets/chunk-CLxacb5B.js +1 -0
  505. package/lib/ui/assets/chunk-COt5Ahok.js +1 -0
  506. package/lib/ui/assets/chunk-CPTIWCL2.js +1 -0
  507. package/lib/ui/assets/chunk-CQLl-L-p.js +1 -0
  508. package/lib/ui/assets/chunk-CUWRgxuq.js +55 -0
  509. package/lib/ui/assets/chunk-CWanVSXC.js +1 -0
  510. package/lib/ui/assets/chunk-Cf5RLm7j.js +1 -0
  511. package/lib/ui/assets/chunk-CickPsom.js +1 -0
  512. package/lib/ui/assets/chunk-Cj5Yp3dK.js +1 -0
  513. package/lib/ui/assets/chunk-Cmh6b_Ma.js +1 -0
  514. package/lib/ui/assets/chunk-Cp-IABpG.js +1 -0
  515. package/lib/ui/assets/chunk-CqE71os6.js +1 -0
  516. package/lib/ui/assets/chunk-CtKP3W-j.js +1 -0
  517. package/lib/ui/assets/chunk-Cvjx9yec.js +1 -0
  518. package/lib/ui/assets/chunk-CxGP3dtY.js +1 -0
  519. package/lib/ui/assets/chunk-CylS5w8V.js +1 -0
  520. package/lib/ui/assets/chunk-D38fbIBN.js +1 -0
  521. package/lib/ui/assets/chunk-D97Zzqfu.js +1 -0
  522. package/lib/ui/assets/chunk-DAi9KRSo.js +1 -0
  523. package/lib/ui/assets/chunk-DHK4yRfg.js +1 -0
  524. package/lib/ui/assets/chunk-DJeabLx-.js +1 -0
  525. package/lib/ui/assets/chunk-DNRxmY5a.js +1 -0
  526. package/lib/ui/assets/chunk-DNSN1z5r.js +1 -0
  527. package/lib/ui/assets/chunk-DNasK_ZG.js +1 -0
  528. package/lib/ui/assets/chunk-DPvrY3IQ.js +1 -0
  529. package/lib/ui/assets/chunk-DXmwc3jG.js +1 -0
  530. package/lib/ui/assets/chunk-Dd0kTxKP.js +1 -0
  531. package/lib/ui/assets/chunk-De0Btta0.js +1 -0
  532. package/lib/ui/assets/chunk-Des-eS-w.js +1 -0
  533. package/lib/ui/assets/chunk-Df6bDoY_.js +1 -0
  534. package/lib/ui/assets/chunk-DijEV5ha.js +1 -0
  535. package/lib/ui/assets/chunk-DkvoVjww.js +1 -0
  536. package/lib/ui/assets/chunk-DlC-OlHO.js +1 -0
  537. package/lib/ui/assets/chunk-DnzrXTVv.js +1 -0
  538. package/lib/ui/assets/chunk-Dualf0xi.js +1 -0
  539. package/lib/ui/assets/chunk-EXT84bkm.js +1 -0
  540. package/lib/ui/assets/chunk-GwR3hkPK.js +1 -0
  541. package/lib/ui/assets/chunk-P80f7IUj.js +1 -0
  542. package/lib/ui/assets/chunk-VOosw3JB.js +1 -0
  543. package/lib/ui/assets/chunk-YQ4lDkt_.js +140 -0
  544. package/lib/ui/assets/chunk-Yzrsuije.js +1 -0
  545. package/lib/ui/assets/chunk-Z72CF80r.js +1 -0
  546. package/lib/ui/assets/chunk-g9-lgVsj.js +1 -0
  547. package/lib/ui/assets/chunk-vGWfd6FD.js +1 -0
  548. package/lib/ui/assets/chunk-wDzz0qaB.js +1 -0
  549. package/lib/ui/assets/chunk-ySF7HWmS.js +1 -0
  550. package/lib/ui/assets/icon.png +0 -0
  551. package/lib/ui/assets/index.html +14 -0
  552. package/lib/ui/assets/pdf.worker.min-CjEcRF4W.mjs +28 -0
  553. package/lib/ui/assets/style-Bq01xH_b.css +1 -0
  554. package/lib/ui/frames.d.ts +67 -0
  555. package/lib/ui/frames.js +146 -0
  556. package/lib/ui/index.d.ts +59 -0
  557. package/lib/ui/index.js +50 -0
  558. package/lib/ui/manifest.d.ts +172 -0
  559. package/lib/ui/manifest.js +158 -0
  560. package/lib/ui/plugin.d.ts +161 -0
  561. package/lib/ui/plugin.js +7 -0
  562. package/lib/ui/plugins/browser/client.js +290 -0
  563. package/lib/ui/plugins/browser/icon.png +0 -0
  564. package/lib/ui/plugins/composer/client.js +1843 -0
  565. package/lib/ui/plugins/composer/icon.png +0 -0
  566. package/lib/ui/plugins/files/client.js +646 -0
  567. package/lib/ui/plugins/files/icon.png +0 -0
  568. package/lib/ui/plugins/manifest.json +107 -0
  569. package/lib/ui/plugins/plugins/client.js +682 -0
  570. package/lib/ui/plugins/plugins/icon.png +0 -0
  571. package/lib/ui/plugins/preview/client.js +197 -0
  572. package/lib/ui/plugins/preview/icon.png +0 -0
  573. package/lib/ui/plugins/prompt/client.js +653 -0
  574. package/lib/ui/plugins/prompt/icon.png +0 -0
  575. package/lib/ui/plugins/sessions/client.js +1577 -0
  576. package/lib/ui/plugins/sessions/icon.png +0 -0
  577. package/lib/ui/plugins/settings/client.js +5470 -0
  578. package/lib/ui/plugins/settings/icon.png +0 -0
  579. package/lib/ui/plugins/skills/client.js +485 -0
  580. package/lib/ui/plugins/skills/icon.png +0 -0
  581. package/lib/ui/plugins/status/client.js +1420 -0
  582. package/lib/ui/plugins/status/icon.png +0 -0
  583. package/lib/ui/plugins/statusbar/client.js +504 -0
  584. package/lib/ui/plugins/statusbar/icon.png +0 -0
  585. package/lib/ui/plugins/tasks/client.js +52 -0
  586. package/lib/ui/plugins/tasks/icon.png +0 -0
  587. package/lib/ui/plugins/team/client.js +527 -0
  588. package/lib/ui/plugins/team/icon.png +0 -0
  589. package/lib/ui/plugins/terminal/client.js +232 -0
  590. package/lib/ui/plugins/terminal/icon.png +0 -0
  591. package/lib/ui/plugins/trace/client.js +1376 -0
  592. package/lib/ui/plugins/trace/icon.png +0 -0
  593. package/lib/ui/plugins/transcript/client.js +2661 -0
  594. package/lib/ui/plugins/transcript/icon.png +0 -0
  595. package/lib/ui/scoped-slots.d.ts +20 -0
  596. package/lib/ui/scoped-slots.js +21 -0
  597. package/lib/ui/sdk/@dsc/ui/index.d.ts +242 -0
  598. package/lib/ui/sdk/@dsc/ui/package.json +16 -0
  599. package/lib/ui/sdk/@dsc/ui-core/contract.d.ts +1973 -0
  600. package/lib/ui/sdk/@dsc/ui-core/core/diff-text.d.ts +74 -0
  601. package/lib/ui/sdk/@dsc/ui-core/core/dock-browser.d.ts +137 -0
  602. package/lib/ui/sdk/@dsc/ui-core/core/dock-ops.d.ts +59 -0
  603. package/lib/ui/sdk/@dsc/ui-core/core/model-caps.d.ts +83 -0
  604. package/lib/ui/sdk/@dsc/ui-core/core/native-bridge.d.ts +135 -0
  605. package/lib/ui/sdk/@dsc/ui-core/core/token-estimate.d.ts +55 -0
  606. package/lib/ui/sdk/@dsc/ui-core/package.json +16 -0
  607. package/lib/ui/sdk/@dsc/ui-core/ui/arrival.d.ts +72 -0
  608. package/lib/ui/sdk/@dsc/ui-core/ui/frames.d.ts +67 -0
  609. package/lib/ui/sdk/@dsc/ui-core/ui/index.d.ts +59 -0
  610. package/lib/ui/sdk/@dsc/ui-core/ui/manifest.d.ts +172 -0
  611. package/lib/ui/sdk/@dsc/ui-core/ui/plugin.d.ts +161 -0
  612. package/lib/ui/sdk/@dsc/ui-core/ui/scoped-slots.d.ts +20 -0
  613. package/lib/ui/sdk/@dsc/ui-core/ui/services-react.d.ts +27 -0
  614. package/lib/ui/sdk/@dsc/ui-core/ui/services.d.ts +63 -0
  615. package/lib/ui/sdk/@dsc/ui-core/ui/slots-react.d.ts +28 -0
  616. package/lib/ui/sdk/@dsc/ui-core/ui/slots.d.ts +481 -0
  617. package/lib/ui/sdk/@dsc/ui-core/ui/store.d.ts +89 -0
  618. package/lib/ui/sdk/@dsc/ui-dockkit/dock-model.d.ts +238 -0
  619. package/lib/ui/sdk/@dsc/ui-dockkit/dock-state.d.ts +163 -0
  620. package/lib/ui/sdk/@dsc/ui-dockkit/dock.d.ts +24 -0
  621. package/lib/ui/sdk/@dsc/ui-dockkit/index.d.ts +15 -0
  622. package/lib/ui/sdk/@dsc/ui-dockkit/package.json +16 -0
  623. package/lib/ui/sdk/@dsc/ui-layout/app.d.ts +74 -0
  624. package/lib/ui/sdk/@dsc/ui-layout/appearance.d.ts +70 -0
  625. package/lib/ui/sdk/@dsc/ui-layout/host-channel.d.ts +112 -0
  626. package/lib/ui/sdk/@dsc/ui-layout/index.d.ts +34 -0
  627. package/lib/ui/sdk/@dsc/ui-layout/package.json +16 -0
  628. package/lib/ui/sdk/@dsc/ui-layout/page-state.d.ts +14 -0
  629. package/lib/ui/sdk/@dsc/ui-layout/review-pane.d.ts +21 -0
  630. package/lib/ui/sdk/@dsc/ui-layout/runtime-context.d.ts +44 -0
  631. package/lib/ui/sdk/@dsc/ui-layout/thread-view.d.ts +28 -0
  632. package/lib/ui/sdk/@dsc/ui-layout/update-button.d.ts +21 -0
  633. package/lib/ui/sdk/@dsc/ui-primitives/code-file-icon-artwork.d.ts +53 -0
  634. package/lib/ui/sdk/@dsc/ui-primitives/code-view.d.ts +15 -0
  635. package/lib/ui/sdk/@dsc/ui-primitives/compat.d.ts +27 -0
  636. package/lib/ui/sdk/@dsc/ui-primitives/completion-sound.d.ts +24 -0
  637. package/lib/ui/sdk/@dsc/ui-primitives/confirm.d.ts +33 -0
  638. package/lib/ui/sdk/@dsc/ui-primitives/css.d.ts +47 -0
  639. package/lib/ui/sdk/@dsc/ui-primitives/diff-rows.d.ts +20 -0
  640. package/lib/ui/sdk/@dsc/ui-primitives/file-icons.d.ts +38 -0
  641. package/lib/ui/sdk/@dsc/ui-primitives/file-type-classify.d.ts +66 -0
  642. package/lib/ui/sdk/@dsc/ui-primitives/file-type-icon.d.ts +57 -0
  643. package/lib/ui/sdk/@dsc/ui-primitives/highlight.d.ts +24 -0
  644. package/lib/ui/sdk/@dsc/ui-primitives/hover-delay.d.ts +17 -0
  645. package/lib/ui/sdk/@dsc/ui-primitives/icons.d.ts +109 -0
  646. package/lib/ui/sdk/@dsc/ui-primitives/index.d.ts +55 -0
  647. package/lib/ui/sdk/@dsc/ui-primitives/lang-table.d.ts +10 -0
  648. package/lib/ui/sdk/@dsc/ui-primitives/markdown.d.ts +20 -0
  649. package/lib/ui/sdk/@dsc/ui-primitives/native.d.ts +41 -0
  650. package/lib/ui/sdk/@dsc/ui-primitives/package.json +16 -0
  651. package/lib/ui/sdk/@dsc/ui-primitives/panels.d.ts +86 -0
  652. package/lib/ui/sdk/@dsc/ui-primitives/paths.d.ts +11 -0
  653. package/lib/ui/sdk/@dsc/ui-primitives/pdf-view.d.ts +13 -0
  654. package/lib/ui/sdk/@dsc/ui-primitives/plugin-text.d.ts +15 -0
  655. package/lib/ui/sdk/@dsc/ui-primitives/select.d.ts +35 -0
  656. package/lib/ui/sdk/@dsc/ui-primitives/table-view.d.ts +23 -0
  657. package/lib/ui/sdk/@dsc/ui-primitives/thread-resizer.d.ts +22 -0
  658. package/lib/ui/sdk/@dsc/ui-primitives/time.d.ts +33 -0
  659. package/lib/ui/sdk/@dsc/ui-primitives/toast.d.ts +16 -0
  660. package/lib/ui/sdk/@dsc/ui-primitives/tokens.d.ts +14 -0
  661. package/lib/ui/sdk/@dsc/ui-primitives/tool-args.d.ts +49 -0
  662. package/lib/ui/sdk/@dsc/ui-primitives/tool-summary.d.ts +64 -0
  663. package/lib/ui/sdk/@dsc/ui-renderer/boot.d.ts +121 -0
  664. package/lib/ui/sdk/@dsc/ui-renderer/hmr.d.ts +43 -0
  665. package/lib/ui/sdk/@dsc/ui-renderer/index.d.ts +20 -0
  666. package/lib/ui/sdk/@dsc/ui-renderer/package.json +16 -0
  667. package/lib/ui/sdk/@dsc/ui-slots/index.d.ts +19 -0
  668. package/lib/ui/sdk/@dsc/ui-slots/package.json +16 -0
  669. package/lib/ui/sdk/@dsc/ui-slots/slots-react.d.ts +48 -0
  670. package/lib/ui/sdk/@dsc/ui-slots/slots.d.ts +102 -0
  671. package/lib/ui/services-react.d.ts +27 -0
  672. package/lib/ui/services-react.js +32 -0
  673. package/lib/ui/services.d.ts +63 -0
  674. package/lib/ui/services.js +121 -0
  675. package/lib/ui/slots-ink.d.ts +26 -0
  676. package/lib/ui/slots-ink.js +78 -0
  677. package/lib/ui/slots-react.d.ts +28 -0
  678. package/lib/ui/slots-react.js +88 -0
  679. package/lib/ui/slots.d.ts +481 -0
  680. package/lib/ui/slots.js +550 -0
  681. package/lib/ui/store.d.ts +89 -0
  682. package/lib/ui/store.js +62 -0
  683. package/lib/ui/tui-plugin-api.d.ts +23 -0
  684. package/lib/ui/tui-plugin-api.js +23 -0
  685. package/lib/ui/tui-plugins.d.ts +47 -0
  686. package/lib/ui/tui-plugins.js +220 -0
  687. package/package.json +58 -6
@@ -0,0 +1,49 @@
1
+ /**
2
+ * combo 的**宿主侧精确表**:一个批一条地址,地址即内容。
3
+ *
4
+ * 与参考实现同一形状(也是不解析请求的原因之一):宿主在组图时把每个批的
5
+ * 「URL → 惰性体」登记进表,路由只按 `pathname + search` 精确命中;**未登记的组合一律 404**。
6
+ * 不做通用 combo 解析除了与参考实现同口径,还顺手焊死一条缝:请求里的 id 列表永远不会
7
+ * 决定读哪些文件(否则 `??../../x/client.js` 就是一条任意文件读取),成员集合只能来自
8
+ * `collectUiArtifactsForPlatform` 这唯一口子。
9
+ *
10
+ * 为什么保留「上一代」:批地址带 rev,插件重建后已经打开、还没刷新的页面手上还是旧批地址,
11
+ * 它的下一次请求必须还能拿到旧字节(与单资源的旧一代同一纪律,见 `core/ui-route.ts` 头注释)。
12
+ * 单资源的旧字节靠产物表里「当初服务过就留着」,批成员没有单资源记录——所以批体只能在换代时
13
+ * 由宿主把上一代表整份留一代(内存里几百 KB,可接受)。
14
+ *
15
+ * @module dsc/core/ui-combo
16
+ */
17
+ /** 一个批登记进表的东西:绝对路由 URL + 批 rev + 拼好的字节。 */
18
+ export interface UiComboBatchBody {
19
+ /** 绝对路由地址(`/plugins/??…&rev=…`),不是图里那份 document-relative。 */
20
+ url: string;
21
+ rev: string;
22
+ body: Buffer;
23
+ }
24
+ /** 一次 combo 命中的结果。 */
25
+ export interface UiComboLookup {
26
+ /** `current` = 当下这一代;`previous` = 刚被换掉的那一代。 */
27
+ hit: 'current' | 'previous';
28
+ size: number;
29
+ body: Buffer | null;
30
+ }
31
+ /** 拼批体:成员字节顺序拼接。每段 bundle 自带 `;\n` 结尾,中间插一个换行纯属防御。 */
32
+ export declare function joinComboParts(parts: readonly Buffer[]): Buffer;
33
+ /** 批与单资源共用的「当前代 + 上一代」表。 */
34
+ export declare class UiComboTable {
35
+ private current;
36
+ private previous;
37
+ /**
38
+ * 换上一代:旧的当前代整份挪进「上一代」(只留一代,与参考实现同口径),
39
+ * 更早的那一代就此作废。
40
+ */
41
+ replace(batches: readonly UiComboBatchBody[]): void;
42
+ /** 按精确 URL 查(缺地址就是未登记的组合)。 */
43
+ lookup(url: string, wantBody: boolean): UiComboLookup | null;
44
+ /** 现在登记的批地址(诊断与探针读数)。 */
45
+ urls(): {
46
+ url: string;
47
+ rev: string;
48
+ }[];
49
+ }
@@ -0,0 +1,55 @@
1
+ /**
2
+ * combo 的**宿主侧精确表**:一个批一条地址,地址即内容。
3
+ *
4
+ * 与参考实现同一形状(也是不解析请求的原因之一):宿主在组图时把每个批的
5
+ * 「URL → 惰性体」登记进表,路由只按 `pathname + search` 精确命中;**未登记的组合一律 404**。
6
+ * 不做通用 combo 解析除了与参考实现同口径,还顺手焊死一条缝:请求里的 id 列表永远不会
7
+ * 决定读哪些文件(否则 `??../../x/client.js` 就是一条任意文件读取),成员集合只能来自
8
+ * `collectUiArtifactsForPlatform` 这唯一口子。
9
+ *
10
+ * 为什么保留「上一代」:批地址带 rev,插件重建后已经打开、还没刷新的页面手上还是旧批地址,
11
+ * 它的下一次请求必须还能拿到旧字节(与单资源的旧一代同一纪律,见 `core/ui-route.ts` 头注释)。
12
+ * 单资源的旧字节靠产物表里「当初服务过就留着」,批成员没有单资源记录——所以批体只能在换代时
13
+ * 由宿主把上一代表整份留一代(内存里几百 KB,可接受)。
14
+ *
15
+ * @module dsc/core/ui-combo
16
+ */
17
+ /** 拼批体:成员字节顺序拼接。每段 bundle 自带 `;\n` 结尾,中间插一个换行纯属防御。 */
18
+ export function joinComboParts(parts) {
19
+ const chunks = [];
20
+ for (const part of parts) {
21
+ if (chunks.length > 0)
22
+ chunks.push(Buffer.from('\n'));
23
+ chunks.push(part);
24
+ }
25
+ return Buffer.concat(chunks);
26
+ }
27
+ /** 批与单资源共用的「当前代 + 上一代」表。 */
28
+ export class UiComboTable {
29
+ current = new Map();
30
+ previous = new Map();
31
+ /**
32
+ * 换上一代:旧的当前代整份挪进「上一代」(只留一代,与参考实现同口径),
33
+ * 更早的那一代就此作废。
34
+ */
35
+ replace(batches) {
36
+ this.previous = this.current;
37
+ this.current = new Map(batches.map((batch) => [batch.url, batch]));
38
+ }
39
+ /** 按精确 URL 查(缺地址就是未登记的组合)。 */
40
+ lookup(url, wantBody) {
41
+ const current = this.current.get(url);
42
+ if (current !== undefined) {
43
+ return { hit: 'current', size: current.body.length, body: wantBody ? current.body : null };
44
+ }
45
+ const previous = this.previous.get(url);
46
+ if (previous !== undefined) {
47
+ return { hit: 'previous', size: previous.body.length, body: wantBody ? previous.body : null };
48
+ }
49
+ return null;
50
+ }
51
+ /** 现在登记的批地址(诊断与探针读数)。 */
52
+ urls() {
53
+ return [...this.current.values()].map((batch) => ({ url: batch.url, rev: batch.rev }));
54
+ }
55
+ }
@@ -0,0 +1,81 @@
1
+ /**
2
+ * 本机界面壳的数据通道:SSE 推帧 + POST 调方法。
3
+ *
4
+ * 为什么不用 WebSocket(遥控端那条路):这条链路只需要「宿主 → 页面」单向推 + 一问一答,
5
+ * 而 SSE 自带两件我们本来要手写的东西——**浏览器自动重连**,以及重连时带上
6
+ * `Last-Event-ID`。那正好是帧 hub 的补帧语义(`resume(after)`),接起来不用自己维护重连状态机。
7
+ * invoke 走普通 POST,复用 HTTP 层已有的请求体读取与 Host 校验。
8
+ *
9
+ * 与遥控端共用的是**帧的产生与缓冲**(`core/remote/frames.ts` 的 RemoteFrameHub):
10
+ * seq 全局单调、增量 diff、120 帧环形缓冲补帧,两边一套口径。**可调用面不同**:本机界面走
11
+ * `core/ui-methods.ts` 那份界面子集(凭据写入、破坏性删除、任意命令执行、审批策略一律不放),
12
+ * 实参还要过 `validateUiArgs`;遥控端另一份更小的子集。理由都一样——页面里跑着第三方 bundle。
13
+ *
14
+ * 与遥控端(`plugins/remote.ts`)对齐的三条纪律,别在改动里丢掉:
15
+ *
16
+ * 1. **一条连接都没有的期间变过 = 漏过变化**(`missedWhileIdle`)。那时不造帧,hub 的
17
+ * seq 不前进,重连时 `resume(after)` 返回的是**空数组**而不是 null——只看
18
+ * 「replay 是不是 null」会把这种情况当成「补上了」,界面就永远停在旧状态。
19
+ * 2. **hub 是所有连接共用的一份**:`build(forceFull)` 会把共享的 diff 基准重挂并推进全局
20
+ * seq。所以一帧全量必须广播给全体(含刚接上的那条),只写给新连接会让老连接永久少条目。
21
+ * 3. **广播要管背压与死连接**:SSE 是长连接,socket 级错误是异步事件(try/catch 接不住),
22
+ * 而 `res.write()` 返回 false 之后一直等不到 `drain`,说明对端压根不读了——不管就会把帧
23
+ * 堆在宿主的写缓冲里。
24
+ *
25
+ * 鉴权**不在这里**:调用方(`core/ui-server.ts`)先过 Host 头与 Cookie 两道闸,
26
+ * 再把请求交给这里。这样这个模块不依赖 cordis、也不认识凭据,能单独起真服务来测。
27
+ *
28
+ * @module dsc/core/ui-events
29
+ */
30
+ import type { IncomingMessage, ServerResponse } from 'node:http';
31
+ import { type FrameInput } from './remote/frames.js';
32
+ /** 造这个通道要给的几样东西。 */
33
+ export interface UiEventsOptions {
34
+ /** 取当前快照(每次推送都重新取)。 */
35
+ snapshot(): FrameInput & Record<string, unknown>;
36
+ /** 执行一个方法(白名单已由调用方校验过;这里只负责执行与包错误)。 */
37
+ invoke(method: string, args: unknown[]): Promise<unknown>;
38
+ /** 允许的方法名(握手报给客户端,派发前再校验一次)。 */
39
+ methods: readonly string[];
40
+ /** 握手帧内容(宿主身份、协议版本)。 */
41
+ hello(): Record<string, unknown>;
42
+ /** 订阅宿主变化;返回退订函数。 */
43
+ subscribe(onChange: () => void): () => void;
44
+ /**
45
+ * 启动图热更源(可选):连接建立即发一帧当前图,之后有变更就推。
46
+ *
47
+ * 为什么另开 `event: plugins` 而不塞进 `frame`:`frame` 帧参与帧 hub 的 seq/全量不变量
48
+ * (跳号要重开连接、首帧必须全量),把插件图混进去会破坏那套判定(`ui-events-test.mjs`
49
+ * 钉着它)。新事件名对旧壳向前兼容——浏览器对没监听的事件名直接忽略。
50
+ */
51
+ plugins?: {
52
+ /** 握手后立刻发的那一帧(当前图;`changed`/`removed` 为空)。 */
53
+ initial(): unknown;
54
+ /** 订阅变更帧;返回退订函数。 */
55
+ subscribe(listener: (frame: unknown) => void): () => void;
56
+ };
57
+ throttleMs?: number;
58
+ heartbeatMs?: number;
59
+ /** 同时最多几条 SSE,缺省 8。 */
60
+ maxClients?: number;
61
+ /** 日志(缺省写 stderr,与 `core/ui-server.ts` 同一个口径)。 */
62
+ log?(line: string): void;
63
+ }
64
+ /** 交给 HTTP 服务挂上去的两个入口。 */
65
+ export interface UiEventsHandle {
66
+ /** `GET /api/events`:SSE。 */
67
+ handleEvents(req: IncomingMessage, res: ServerResponse): void;
68
+ /** `POST /api/invoke`:`{method, args}` → `{ok, value|error}`。 */
69
+ handleInvoke(req: IncomingMessage, res: ServerResponse): Promise<void>;
70
+ /** 当前连着几个页面(诊断)。 */
71
+ readonly clients: number;
72
+ /** 退订并断开所有连接(插件卸载时调)。 */
73
+ stop(): void;
74
+ }
75
+ /**
76
+ * 造数据通道。
77
+ * @param options - 快照来源、派发器、白名单与握手内容
78
+ */
79
+ export declare function createUiEvents(options: UiEventsOptions): UiEventsHandle;
80
+ /** 没凭据时的回话(与 ui-server 的 401 一致,独立成量是因为它也被测试直接比对)。 */
81
+ export declare function sendUnauthorized(res: ServerResponse): void;
@@ -0,0 +1,364 @@
1
+ import { RemoteFrameHub } from './remote/frames.js';
2
+ import { readBody, sendJson, sendText } from './web-http.js';
3
+ /** 默认推送节流(与 host-stdio / remote 同一个口径)。 */
4
+ const DEFAULT_THROTTLE_MS = 80;
5
+ /** 心跳间隔:写注释行防中间设备掐掉空闲连接,也顺便发现死连接。 */
6
+ const DEFAULT_HEARTBEAT_MS = 15_000;
7
+ /**
8
+ * 断线后浏览器该等多久再连(写进流的 `retry:`)。
9
+ *
10
+ * 500 毫秒太急:宿主重启或网络抖一下,所有页面会以每半秒一轮打成重连风暴,
11
+ * 而这段时间里每次重连都要走一遍握手 + 补帧。3 秒既不让用户等太久,也给宿主留出恢复时间。
12
+ */
13
+ const RECONNECT_RETRY_MS = 3_000;
14
+ /**
15
+ * 同时最多挂几条 SSE。
16
+ *
17
+ * 每条连接都占一份写缓冲与一个 socket;页面开太多(脚本刷、标签页忘了关)会把宿主内存吃光。
18
+ * 超限回 503 而不是静默丢弃,这样客户端知道该关掉多余的页面。
19
+ */
20
+ const DEFAULT_MAX_CLIENTS = 8;
21
+ /**
22
+ * 一条连接连续多少帧「上一帧还没排空」就断开它。
23
+ *
24
+ * 判据不能是「`res.write()` 返回了 false」——帧比写缓冲的高水位大时(一次几 MB 的快照),
25
+ * 一条完全健康的连接也会每帧都返回 false。真正的落后是**跨帧还没排空**:
26
+ * 上一次 false 之后一直没等到 `drain` 事件,说明对端压根没在读。
27
+ *
28
+ * 断开反而是安全的:浏览器会带 `Last-Event-ID` 重连,而重连有补帧,所以断开不等于丢数据。
29
+ */
30
+ const MAX_WRITE_LAG = 3;
31
+ /** 写一条 SSE 事件;返回 `res.write` 的结果(false = 对端跟不上,写进缓冲了)。 */
32
+ function writeEvent(res, event, data, id) {
33
+ const head = `${id === undefined ? '' : `id: ${String(id)}\n`}event: ${event}\n`;
34
+ return res.write(`${head}data: ${data}\n\n`);
35
+ }
36
+ /** 从帧文本里挑出 seq(补发时当 `id:` 用,浏览器下次重连才能把号带回来)。 */
37
+ function frameSeqOf(text) {
38
+ try {
39
+ const parsed = JSON.parse(text);
40
+ const candidate = parsed.seq;
41
+ return typeof candidate === 'number' && Number.isFinite(candidate) ? candidate : undefined;
42
+ }
43
+ catch {
44
+ // 缓冲里存的就是自己序列化出来的文本,理论上不会解析失败;真坏了就不带 id 发。
45
+ return undefined;
46
+ }
47
+ }
48
+ /**
49
+ * 造数据通道。
50
+ * @param options - 快照来源、派发器、白名单与握手内容
51
+ */
52
+ export function createUiEvents(options) {
53
+ const throttleMs = options.throttleMs ?? DEFAULT_THROTTLE_MS;
54
+ const heartbeatMs = options.heartbeatMs ?? DEFAULT_HEARTBEAT_MS;
55
+ const maxClients = options.maxClients ?? DEFAULT_MAX_CLIENTS;
56
+ const log = options.log ??
57
+ ((line) => {
58
+ process.stderr.write(`${line}\n`);
59
+ });
60
+ const hub = new RemoteFrameHub();
61
+ /** 连着的页面:hub 只有一份,每一帧广播给这里每一条。 */
62
+ const clients = new Set();
63
+ /** 每条连接连续几次「跨帧还没排空」;排空了就清掉。 */
64
+ const lag = new Map();
65
+ /** 正在等 `drain`(上一次写返回 false 之后就进这里)。 */
66
+ const draining = new Set();
67
+ /**
68
+ * 「一条连接都没有的那段时间里,宿主变过」。
69
+ * 必须记:那时不造帧,hub 的 seq 不前进,重连时补帧补不出这段变化,得补一帧全量。
70
+ */
71
+ let missedWhileIdle = false;
72
+ /** 上一次造帧失败的原因:同一个原因只报一次,别把日志和页面刷爆。 */
73
+ let lastBuildError = null;
74
+ /** 把一条连接从表里摘掉(断开、写失败、报错都走这里)。 */
75
+ const forget = (res) => {
76
+ clients.delete(res);
77
+ lag.delete(res);
78
+ draining.delete(res);
79
+ };
80
+ /**
81
+ * 给一条连接写一帧。
82
+ *
83
+ * 写不进去(`res.write()` 返回 false)时要盯着 `drain`:连着几帧都等不到 drain 就说明
84
+ * 对端真的不读了,断开它并等它重连(重连有补帧,所以断开不丢数据)。只看单次返回值
85
+ * 会把「帧比写缓冲大」误判成落后——那是每一帧都返回 false 的正常情况。
86
+ */
87
+ const writeFrame = (res, frame) => {
88
+ if (res.writableEnded || res.destroyed) {
89
+ forget(res);
90
+ return;
91
+ }
92
+ let flushed;
93
+ try {
94
+ flushed = writeEvent(res, 'frame', frame.text, frame.seq);
95
+ }
96
+ catch {
97
+ // 写到一半对端没了:这条连接不用再管
98
+ forget(res);
99
+ return;
100
+ }
101
+ if (flushed) {
102
+ lag.delete(res);
103
+ draining.delete(res);
104
+ return;
105
+ }
106
+ const missed = draining.has(res) ? (lag.get(res) ?? 0) + 1 : 1;
107
+ lag.set(res, missed);
108
+ if (!draining.has(res)) {
109
+ draining.add(res);
110
+ res.once('drain', () => {
111
+ draining.delete(res);
112
+ lag.delete(res);
113
+ });
114
+ }
115
+ if (missed >= MAX_WRITE_LAG) {
116
+ log(`[ui-events] 这个页面连续 ${String(missed)} 帧等不到写缓冲排空,断开它等它带着 Last-Event-ID 重连`);
117
+ try {
118
+ res.end();
119
+ }
120
+ catch {
121
+ // 已经断了
122
+ }
123
+ forget(res);
124
+ }
125
+ };
126
+ /**
127
+ * 把造帧失败报给所有页面(同一原因只报一次),并记日志。
128
+ *
129
+ * 为什么不能像以前那样静默 return:界面停在最后一帧、宿主这边一声不吭,
130
+ * 「快照形状意外」这种最好查的故障会变成最难查的(用户只看到界面不动了)。
131
+ */
132
+ const reportBuildFailure = (reason) => {
133
+ if (reason === lastBuildError)
134
+ return;
135
+ lastBuildError = reason;
136
+ log(`[ui-events] 造帧失败,界面会停在最后一帧:${reason}`);
137
+ const data = JSON.stringify({ error: reason });
138
+ for (const res of [...clients]) {
139
+ try {
140
+ writeEvent(res, 'error', data);
141
+ }
142
+ catch {
143
+ forget(res);
144
+ }
145
+ }
146
+ };
147
+ /**
148
+ * 造一帧并广播给所有连接(含刚接上的那一条)。
149
+ *
150
+ * 为什么必须广播而不是只写给某一条:全量帧会把 hub 共享的 diff 基准重挂到当前快照。
151
+ * 只写给新连接的话,老连接之后的增量是相对新基准算的,「已发生但还没进帧流」的变化
152
+ * 在增量里根本不出现——老标签页永久少条目,而且不报任何错。
153
+ *
154
+ * @returns 造出来的帧;造帧失败时 null(已经报过错了)
155
+ */
156
+ const emitFrame = (forceFull) => {
157
+ let frame;
158
+ try {
159
+ frame = hub.build(options.snapshot(), forceFull);
160
+ }
161
+ catch (error) {
162
+ reportBuildFailure(error instanceof Error ? error.message : String(error));
163
+ // 造帧失败不该把已经连上的页面弄断:跳过这一帧,等下一次变化。
164
+ return null;
165
+ }
166
+ lastBuildError = null;
167
+ for (const res of [...clients])
168
+ writeFrame(res, frame);
169
+ // 这一帧已经把所有连接(含漏过变化的那些)对齐到当前快照了
170
+ missedWhileIdle = false;
171
+ return frame;
172
+ };
173
+ // 宿主变化 → 节流 → 推一帧。
174
+ let timer = null;
175
+ let dirty = false;
176
+ const scheduleFrame = () => {
177
+ if (clients.size === 0) {
178
+ // 没人连着:不造帧(造了也没人收),但要记住这段时间变过——
179
+ // seq 不前进意味着重连补帧是空数组,不补全量就永远对不上。
180
+ missedWhileIdle = true;
181
+ return;
182
+ }
183
+ dirty = true;
184
+ if (timer !== null)
185
+ return;
186
+ timer = setTimeout(() => {
187
+ timer = null;
188
+ if (!dirty)
189
+ return;
190
+ dirty = false;
191
+ if (clients.size === 0) {
192
+ // 攒的这一段时间里页面全走了:同样按「漏过变化」记账
193
+ missedWhileIdle = true;
194
+ return;
195
+ }
196
+ emitFrame(false);
197
+ }, throttleMs);
198
+ };
199
+ const unsubscribe = options.subscribe(scheduleFrame);
200
+ /**
201
+ * 启动图帧的广播面:与快照帧共用连接集合,但**不进帧 hub**——没有 seq/id、不参与补帧,
202
+ * 断线期间漏掉的帧靠重连时那一帧 `initial()` 重新对齐(图是幂等的全量)。
203
+ */
204
+ const writePlugins = (res, data) => {
205
+ if (res.writableEnded || res.destroyed) {
206
+ forget(res);
207
+ return;
208
+ }
209
+ try {
210
+ writeEvent(res, 'plugins', data);
211
+ }
212
+ catch {
213
+ forget(res);
214
+ }
215
+ };
216
+ const unsubscribePlugins = options.plugins?.subscribe((frame) => {
217
+ let data;
218
+ try {
219
+ data = JSON.stringify(frame);
220
+ }
221
+ catch (error) {
222
+ log(`[ui-events] 启动图帧序列化失败,丢弃这一帧:${error instanceof Error ? error.message : String(error)}`);
223
+ return;
224
+ }
225
+ for (const res of [...clients])
226
+ writePlugins(res, data);
227
+ });
228
+ const heartbeat = setInterval(() => {
229
+ for (const res of [...clients]) {
230
+ if (res.writableEnded || res.destroyed) {
231
+ forget(res);
232
+ continue;
233
+ }
234
+ try {
235
+ res.write(': keep-alive\n\n');
236
+ }
237
+ catch {
238
+ forget(res);
239
+ }
240
+ }
241
+ }, heartbeatMs);
242
+ heartbeat.unref?.();
243
+ return {
244
+ get clients() {
245
+ return clients.size;
246
+ },
247
+ handleEvents(req, res) {
248
+ if (clients.size >= maxClients) {
249
+ log(`[ui-events] SSE 连接数已达上限 ${String(maxClients)},拒绝新连接`);
250
+ sendText(res, 503, '界面数据通道的连接数已满,请关掉多余的页面再刷新');
251
+ return;
252
+ }
253
+ res.writeHead(200, {
254
+ 'content-type': 'text/event-stream; charset=utf-8',
255
+ 'cache-control': 'no-cache, no-transform',
256
+ connection: 'keep-alive',
257
+ // 反向代理(有人把它挂出去时)不要缓冲这个流
258
+ 'x-accel-buffering': 'no',
259
+ });
260
+ res.write(`retry: ${String(RECONNECT_RETRY_MS)}\n\n`);
261
+ writeEvent(res, 'hello', JSON.stringify(options.hello()));
262
+ // socket 级错误(ECONNRESET 之类)是异步事件,try/catch 接不住:靠 error/close 摘连接。
263
+ res.on('error', () => {
264
+ forget(res);
265
+ });
266
+ req.on('close', () => {
267
+ forget(res);
268
+ });
269
+ // 先登记再补帧:接不上缓冲时那一帧全量是广播出去的,新连接也得在那一次广播里。
270
+ clients.add(res);
271
+ // 启动图:紧跟 hello 之后发一帧当前图(重连也一样),壳据此对齐 HMR 的起点。
272
+ if (options.plugins !== undefined) {
273
+ try {
274
+ writePlugins(res, JSON.stringify(options.plugins.initial()));
275
+ }
276
+ catch (error) {
277
+ log(`[ui-events] 启动图初始帧序列化失败:${error instanceof Error ? error.message : String(error)}`);
278
+ }
279
+ }
280
+ // 重连补帧:浏览器会把上一帧的 id 放进 Last-Event-ID(手工接的客户端可以用 ?lastSeq=)。
281
+ const url = new URL(req.url ?? '/', 'http://127.0.0.1');
282
+ const rawAfter = req.headers['last-event-id'] ?? url.searchParams.get('lastSeq') ?? '0';
283
+ const after = Number(Array.isArray(rawAfter) ? rawAfter[0] : rawAfter);
284
+ const replay = Number.isFinite(after) ? hub.resume(after) : null;
285
+ if (replay === null) {
286
+ // 接不上缓冲(第一次连、漏的帧已滚出窗口、或宿主重启过):立刻补一帧全量。
287
+ emitFrame(true);
288
+ }
289
+ else {
290
+ // 只补这条连接漏掉的帧(缓冲里存的是原样文本,直接照发)
291
+ for (const text of replay) {
292
+ try {
293
+ writeEvent(res, 'frame', text, frameSeqOf(text));
294
+ }
295
+ catch {
296
+ forget(res);
297
+ break;
298
+ }
299
+ }
300
+ // 一条连接都没有的期间发生的变化不在补帧里(那时根本没造帧):再补一帧全量把它对上。
301
+ if (missedWhileIdle)
302
+ emitFrame(true);
303
+ }
304
+ },
305
+ async handleInvoke(req, res) {
306
+ let parsed;
307
+ try {
308
+ const text = await readBody(req);
309
+ parsed = JSON.parse(text === '' ? '{}' : text);
310
+ }
311
+ catch (error) {
312
+ sendJson(res, 400, { ok: false, error: `请求体不是 JSON:${error instanceof Error ? error.message : String(error)}` });
313
+ return;
314
+ }
315
+ if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
316
+ sendJson(res, 400, { ok: false, error: '请求体必须是对象' });
317
+ return;
318
+ }
319
+ const record = parsed;
320
+ const method = record['method'];
321
+ if (typeof method !== 'string' || method === '') {
322
+ sendJson(res, 400, { ok: false, error: '缺少 method' });
323
+ return;
324
+ }
325
+ if (!options.methods.includes(method)) {
326
+ sendJson(res, 403, { ok: false, error: `协议不允许调用的方法:${method}` });
327
+ return;
328
+ }
329
+ const args = Array.isArray(record['args']) ? record['args'] : [];
330
+ try {
331
+ const value = (await options.invoke(method, args)) ?? null;
332
+ sendJson(res, 200, { ok: true, value });
333
+ }
334
+ catch (error) {
335
+ // 执行失败照 host-stdio 的口径回一条结果(HTTP 200 + ok:false),
336
+ // 客户端只需看 ok,不必区分「协议错」与「方法抛错」两条路。
337
+ sendJson(res, 200, { ok: false, error: error instanceof Error ? error.message : String(error) });
338
+ }
339
+ },
340
+ stop() {
341
+ clearInterval(heartbeat);
342
+ if (timer !== null)
343
+ clearTimeout(timer);
344
+ timer = null;
345
+ unsubscribe();
346
+ unsubscribePlugins?.();
347
+ for (const res of [...clients]) {
348
+ try {
349
+ res.end();
350
+ }
351
+ catch {
352
+ // 已经断了的连接不用管
353
+ }
354
+ }
355
+ clients.clear();
356
+ lag.clear();
357
+ draining.clear();
358
+ },
359
+ };
360
+ }
361
+ /** 没凭据时的回话(与 ui-server 的 401 一致,独立成量是因为它也被测试直接比对)。 */
362
+ export function sendUnauthorized(res) {
363
+ sendText(res, 401, '需要界面凭据');
364
+ }
@@ -0,0 +1,36 @@
1
+ import type { UiBootGraph } from '../ui/manifest.js';
2
+ /** 要轮询的一个文件。 */
3
+ export interface UiHmrWatch {
4
+ /** 身份(插件 id,或 `manifest` 这类目录级信号)。 */
5
+ id: string;
6
+ path: string;
7
+ }
8
+ /** 宿主推给页面的帧:`changed` 换装、`removed` 卸载、`graph` 是新图(壳据此对齐)。 */
9
+ export interface UiHmrFrame {
10
+ rev: string;
11
+ changed: string[];
12
+ removed: string[];
13
+ graph: UiBootGraph;
14
+ }
15
+ /** 造轮询器要给的几样东西。 */
16
+ export interface UiHmrOptions {
17
+ /** 要轮询的文件(每次调用现取,新增行下一轮自动纳入)。 */
18
+ watches(): UiHmrWatch[];
19
+ /** 当前这一代的图(换代前后各取一次做 diff)。 */
20
+ graph(): UiBootGraph;
21
+ /** 强制重收产物表 + 重组图 + 换 combo 表(`core/ui-boot-source.ts` 的 refresh)。 */
22
+ refresh(): void;
23
+ /** 有真实变更时叫一次。 */
24
+ onFrame(frame: UiHmrFrame): void;
25
+ /** 轮询间隔(毫秒),缺省 500(与参考实现的默认一致)。 */
26
+ pollIntervalMs?: number;
27
+ log?(line: string): void;
28
+ }
29
+ /** 轮询器句柄。 */
30
+ export interface UiHmrHandle {
31
+ /** 立刻跑一轮(测试与「保存后马上推」用;正常靠定时器)。 */
32
+ pollNow(): void;
33
+ stop(): void;
34
+ }
35
+ /** 造一个开发态轮询器。 */
36
+ export declare function createUiHmr(options: UiHmrOptions): UiHmrHandle;