@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,122 @@
1
+ import { lookupUiPluginBundle, lookupThirdPartyUiBundle, uiPluginsDir } from './ui-bundles.js';
2
+ /** 插件资源的路由前缀。 */
3
+ export const UI_BUNDLE_ROUTE = '/plugins/';
4
+ /** 内容寻址的命中给一年不可变缓存(地址里带内容指纹,同一地址的内容永不改变)。 */
5
+ const IMMUTABLE_CACHE = 'public, max-age=31536000, immutable';
6
+ /** 这个路径是不是插件资源请求。 */
7
+ export function isUiBundleRequest(pathname) {
8
+ return pathname.startsWith(UI_BUNDLE_ROUTE);
9
+ }
10
+ /**
11
+ * 解析一个插件资源请求。
12
+ *
13
+ * @param pathname - 请求路径(`/plugins/@scope/name/client.js`)
14
+ * @param rev - 查询参数里的版本;缺省(null / 空串)一律 404——地址不带指纹就不是内容寻址
15
+ * @param dir - 插件目录,缺省 `lib/ui/plugins`
16
+ * @param method - 请求方法,缺省 GET;非 GET / HEAD 回 405
17
+ */
18
+ export function resolveUiBundleRequest(pathname, rev, dir = uiPluginsDir(), method = 'GET') {
19
+ if (method !== 'GET' && method !== 'HEAD') {
20
+ return { status: 405, headers: { allow: 'GET, HEAD' }, reason: '插件资源只认 GET 与 HEAD' };
21
+ }
22
+ const rest = pathname.slice(UI_BUNDLE_ROUTE.length);
23
+ // 最后一个 `/` 之前全是 id(`@scope/name` 这类多段 id 因此成立),之后是文件名。
24
+ const slash = rest.lastIndexOf('/');
25
+ if (slash <= 0)
26
+ return { status: 404, reason: '没有这个插件资源' };
27
+ let id;
28
+ try {
29
+ id = decodeURIComponent(rest.slice(0, slash));
30
+ }
31
+ catch {
32
+ return { status: 404, reason: '插件 id 编码不对' };
33
+ }
34
+ const file = rest.slice(slash + 1);
35
+ if (file === '' || file.includes('/') || file.includes('\\')) {
36
+ return { status: 404, reason: '没有这个插件资源' };
37
+ }
38
+ if (rev === null || rev === '') {
39
+ return { status: 404, reason: '插件地址缺少 rev:内容寻址的地址必须带版本' };
40
+ }
41
+ const wantBody = method !== 'HEAD';
42
+ const found = lookupUiPluginBundle(id, file, rev, dir, wantBody);
43
+ if (!found.known) {
44
+ // 内置清单里没有 → 查第三方(~/.dsc/plugins/ 的界面半边)。两边同一份回话口径。
45
+ const third = lookupThirdPartyUiBundle(id, file, rev, undefined, wantBody);
46
+ if (third.known && (third.current || third.previous)) {
47
+ const headers = {
48
+ 'content-type': 'text/javascript; charset=utf-8',
49
+ 'content-length': String(third.size ?? 0),
50
+ 'cache-control': IMMUTABLE_CACHE,
51
+ };
52
+ if (!wantBody || third.body === null)
53
+ return { status: 200, headers };
54
+ return { status: 200, headers, body: third.body };
55
+ }
56
+ return { status: 404, reason: third.known ? '插件版本对不上' : '没有这个插件' };
57
+ }
58
+ if (!found.current && !found.previous)
59
+ return { status: 404, reason: '插件版本对不上' };
60
+ if (found.size === null || (wantBody && found.body === null)) {
61
+ return {
62
+ status: 404,
63
+ // 旧代字节没留下(宿主重启过之类):说清楚怎么办,别让用户对着 404 猜。
64
+ reason: found.previous ? '插件已经重建,上一代的字节不再保留,刷新页面即可' : '插件文件读不出来',
65
+ };
66
+ }
67
+ const headers = {
68
+ 'content-type': 'text/javascript; charset=utf-8',
69
+ 'content-length': String(found.size),
70
+ 'cache-control': IMMUTABLE_CACHE,
71
+ };
72
+ if (!wantBody || found.body === null)
73
+ return { status: 200, headers };
74
+ return { status: 200, headers, body: found.body };
75
+ }
76
+ /** 这个请求是不是 combo(判据:pathname 恰为前缀,search 以 `??` 开头——不是 pathname 里有 `??`)。 */
77
+ export function isUiComboRequest(pathname, search) {
78
+ return pathname === UI_BUNDLE_ROUTE && search.startsWith('??');
79
+ }
80
+ /**
81
+ * 一个 /plugins 请求的**唯一**解析口子:combo 走精确表,单资源走内容寻址。
82
+ * 本机界面服务与远程控制都调这一份(两处口径分叉是 `ui-route.ts` 头注释里说的老病)。
83
+ *
84
+ * @param pathname - 请求路径
85
+ * @param search - 原始查询串(含前导 `?`;combo 的 `??` 就是它的一部分)
86
+ * @param dir - 内置插件目录,缺省 `lib/ui/plugins`
87
+ * @param method - 请求方法,缺省 GET
88
+ * @param combo - 当前代的 combo 精确表;不给则 combo 一律 404(纯静态探测场景)
89
+ */
90
+ export function resolveUiResourceRequest(pathname, search, dir = uiPluginsDir(), method = 'GET', combo) {
91
+ if (isUiComboRequest(pathname, search))
92
+ return resolveUiComboRequest(pathname, search, combo, method);
93
+ return resolveUiBundleRequest(pathname, new URLSearchParams(search).get('rev'), dir, method);
94
+ }
95
+ /**
96
+ * 解析一个 combo 请求:`/plugins/??<id>/client.js,…&rev=<批 rev>`。
97
+ *
98
+ * 只查表不解析:未登记的组合(含「批已换代、页面还拿旧地址」过了保留窗口的)一律 404,
99
+ * 客户端据此按「批 → 单资源」回退(`@dsc/ui-core` 的 arrival 协议)。
100
+ */
101
+ export function resolveUiComboRequest(pathname, search, combo, method = 'GET') {
102
+ if (method !== 'GET' && method !== 'HEAD') {
103
+ return { status: 405, headers: { allow: 'GET, HEAD' }, reason: '插件资源只认 GET 与 HEAD' };
104
+ }
105
+ if (!isUiComboRequest(pathname, search))
106
+ return { status: 404, reason: '不是组合资源地址' };
107
+ const hit = combo?.lookup(`${pathname}${search}`, method !== 'HEAD') ?? null;
108
+ if (hit === null) {
109
+ return {
110
+ status: 404,
111
+ reason: combo === undefined ? '组合资源表还没建立' : '没有这个插件资源组合(地址没通告过,或批已经换代)',
112
+ };
113
+ }
114
+ const headers = {
115
+ 'content-type': 'text/javascript; charset=utf-8',
116
+ 'content-length': String(hit.size),
117
+ 'cache-control': IMMUTABLE_CACHE,
118
+ };
119
+ if (method === 'HEAD' || hit.body === null)
120
+ return { status: 200, headers };
121
+ return { status: 200, headers, body: hit.body };
122
+ }
@@ -0,0 +1,75 @@
1
+ import type { UiBootGraph } from '../ui/manifest.js';
2
+ import { type UiBootRequestStats, type UiBootWatchRow } from './ui-boot-source.js';
3
+ import type { UiEventsHandle } from './ui-events.js';
4
+ /** 会话 Cookie 名。 */
5
+ export declare const UI_COOKIE = "dsc_ui";
6
+ /** 会话 Cookie 的有效期:30 天(与参考实现同口径)。 */
7
+ export declare const UI_COOKIE_MAX_AGE_MS: number;
8
+ /** 签名密钥文件(`<DSC_HOME>/ui-secret`),只放本机、权限 0600,绝不进日志。 */
9
+ export declare const UI_SECRET_FILE = "ui-secret";
10
+ /** 启动图注入页面时用的全局名(与 dsh 的 `window.__DSH_BOOT__` 对应)。 */
11
+ export declare const BOOT_GLOBAL = "__DSC_BOOT__";
12
+ /** 造服务时要给的参数。 */
13
+ export interface UiServerOptions {
14
+ /** 宿主身份(页面上要显示产品名与版本)。 */
15
+ host: {
16
+ name: string;
17
+ version: string;
18
+ };
19
+ /** 界面产物目录,缺省 `lib/ui/assets`。 */
20
+ assetsDir?: string;
21
+ /** 插件目录,缺省 `lib/ui/plugins`。 */
22
+ pluginsDir?: string;
23
+ /**
24
+ * 数据通道(`/api/events` 与 `/api/invoke`)。不给就是纯静态界面服务——
25
+ * 单元测试与「只发页面不带数据」的场景都用得着。
26
+ */
27
+ events?: UiEventsHandle;
28
+ /** 监听端口,0 = 让系统分配(缺省 0)。 */
29
+ port?: number;
30
+ /** 一次性令牌有效期,缺省 10 分钟。 */
31
+ tokenTtlMs?: number;
32
+ /** 日志(缺省写 stderr)。 */
33
+ log?(line: string): void;
34
+ }
35
+ /** 拿到的服务句柄。 */
36
+ export interface UiServerHandle {
37
+ readonly port: number;
38
+ /** 本机根地址(不带令牌)。 */
39
+ readonly origin: string;
40
+ /** 入口地址:带一次性令牌,给用户或桌面窗口用一次。 */
41
+ readonly url: string;
42
+ /** 当前启动图(清单没变就不重算)。 */
43
+ boot(): UiBootGraph;
44
+ /** 重新扫插件目录(界面壳重新构建后不必重启宿主)。 */
45
+ refresh(): {
46
+ entries: number;
47
+ problems: string[];
48
+ };
49
+ /** 当前积累的装载问题(第三方没信任、api 不匹配、bundle 缺失…),给调用方转成会话流。 */
50
+ problems(): string[];
51
+ /** HMR 轮询要的行(id + 磁盘路径 + 当下 rev)。 */
52
+ watchRows(): UiBootWatchRow[];
53
+ /** 插件请求计数(探针读数面:一次页面加载的物化请求数就是它)。 */
54
+ stats(): UiBootRequestStats;
55
+ /** 清零请求计数(探针分段读数用)。 */
56
+ resetStats(): void;
57
+ /** 关服务(幂等)。 */
58
+ close(): Promise<void>;
59
+ }
60
+ /**
61
+ * 壳文档的内容安全策略。启动图走同源外链 `/boot.js`(见 {@link injectBootScriptTag}),
62
+ * 脚本面才能收成 `'self'`——内联注入就得配 nonce,多一套机制不值得。
63
+ * `'unsafe-inline'` 只留给 style:React 的行内样式与 xterm 的运行期样式都是
64
+ * style 属性,收掉会全线破相;`img-src` 放开 `data:` 是预览插件的 base64 图片。
65
+ *
66
+ * 导出给远程控制复用:手机端切壳后伺服的也是这一份文档,同一套策略不该抄第二遍。
67
+ */
68
+ export declare const UI_CONTENT_SECURITY_POLICY: string;
69
+ /**
70
+ * 把启动图外链标签插进 `</head>` 之前(本机界面服务与远程壳两份伺服共用这一份实现)。
71
+ * 页面脚本跑起来时 `window.__DSC_BOOT__` 已就位,而 CSP 的 script-src 才能收成 `'self'`。
72
+ */
73
+ export declare function injectBootScriptTag(html: string): string;
74
+ /** 启动服务并把入口地址算出来。 */
75
+ export declare function createUiServer(options: UiServerOptions): Promise<UiServerHandle>;
@@ -0,0 +1,369 @@
1
+ /**
2
+ * 本机界面服务:把插件版界面伺服给浏览器(桌面窗口与远程设备看的是同一份)。
3
+ *
4
+ * 这是 C-真 路线里"宿主常驻的那半个 web 服务"。它比远程控制那套简单得多,因为它只服务
5
+ * **本机回环**:没有配对码、没有设备令牌、没有推送,只有一道一次性令牌换 Cookie 的门。
6
+ * 带得走的东西(信任闸、静态伺服、内容寻址的 bundle 地址)都从 core 共用。
7
+ *
8
+ * 五件事:
9
+ *
10
+ * 1. **进来要先换票**:宿主启动时生成一枚一次性令牌,打印成
11
+ * `http://127.0.0.1:<port>/?token=xxx`。浏览器带着它访问 `/`,服务下一条 HttpOnly
12
+ * Cookie 并 303 到 `/`——令牌就此作废(用一次),之后的 `/api/*` 与 `/plugins/*`
13
+ * 都靠这条 Cookie。为什么不用 URL 里的令牌直接当凭据:它会被写进历史记录、
14
+ * 被 Referer 带出去、被日志记下来;换 Cookie 只用一次,暴露面小一圈。
15
+ * 换票响应带 `cache-control: no-store` 与 `referrer-policy: no-referrer`:这条带令牌的
16
+ * 响应不该进任何缓存,跳转后的地址也不该把令牌漏给下一页。用 303 而不是 302:
17
+ * 303 明确要求后续请求改用 GET,语义上不会让带体的请求被"重放"。
18
+ *
19
+ * 2. **三道闸收在 `core/ui-trust.ts`**:Host(防 DNS rebinding,所有路由的总闸)、
20
+ * `sec-fetch-site: cross-site`、以及"带了 Origin 就必须等于本服务 authority"。
21
+ * 后两道是补充,理由与边界都写在那份文件的头注释里。
22
+ *
23
+ * 3. **会话 Cookie 是签名过的**:值是 `authority + 过期时间` 的 HMAC-SHA256,密钥落盘在
24
+ * `<DSC_HOME>/ui-secret`(0600)。为什么要落盘:原来 Cookie 值每次进程启动重新随机,
25
+ * 宿主一重启页面就 401;密钥落盘后,同 authority(同端口)下的旧页面重启后仍然有效。
26
+ * 为什么要签 authority:Cookie 的作用域不含端口,签上 authority 之后,"另一个回环端口
27
+ * 反射回来的 Cookie"送到本服务也不成立。密钥本身绝不进日志。
28
+ *
29
+ * 4. **插件 bundle 走内容寻址**:地址里带 `?rev=<字节摘要>`;命中当下这一代或上一代才 200,
30
+ * 其余 404(旧地址不该拿到新代码,新地址也不该拿到旧代码),命中给一年不可变缓存。
31
+ * HEAD 复用 GET 的头但不给体;非 GET / HEAD 回 405。解析口径在 `core/ui-route.ts`;
32
+ * 批 combo(`/plugins/??…&rev=`)与单资源共用那一份,批体在组图快照里登记
33
+ * (`core/ui-boot-source.ts`,含上一代保留)。
34
+ *
35
+ * 5. **启动清单注进页面**:送 index.html 之前把启动图塞进 `window.__DSC_BOOT__`
36
+ * (与参考实现同一个位置、同一个名字),界面壳一进来就有,不必再发一次请求。
37
+ * 图、批体、问题记录读的是同一个**当前代快照**:`/api/boot`、`/boot.js`、`/plugins/??…`
38
+ * 因此天然同一代;HMR 轮询换代也换这一份(见 `core/ui-hmr.ts`)。
39
+ *
40
+ * @module dsc/core/ui-server
41
+ */
42
+ import { randomBytes } from 'node:crypto';
43
+ import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
44
+ import { createServer } from 'node:http';
45
+ import { dirname } from 'node:path';
46
+ import { createUiBootSource } from './ui-boot-source.js';
47
+ import { dscPath } from './path-policy.js';
48
+ import { uiAssetsDir, uiPluginsDir } from './ui-bundles.js';
49
+ import { isUiBundleRequest, isUiComboRequest, resolveUiResourceRequest } from './ui-route.js';
50
+ import { checkUiRequestTrust, issueUiCookie, requestAuthority, timingSafeEqualText, verifyUiCookie } from './ui-trust.js';
51
+ import { readCookie, sendJson, sendText } from './web-http.js';
52
+ import { serveStatic } from './web-static.js';
53
+ /** 会话 Cookie 名。 */
54
+ export const UI_COOKIE = 'dsc_ui';
55
+ /** 一进来给的那条 `/?token=` 的有效期(毫秒):够用户从终端复制到浏览器。 */
56
+ const DEFAULT_TOKEN_TTL_MS = 10 * 60 * 1000;
57
+ /** 会话 Cookie 的有效期:30 天(与参考实现同口径)。 */
58
+ export const UI_COOKIE_MAX_AGE_MS = 30 * 24 * 60 * 60 * 1000;
59
+ /** 签名密钥文件(`<DSC_HOME>/ui-secret`),只放本机、权限 0600,绝不进日志。 */
60
+ export const UI_SECRET_FILE = 'ui-secret';
61
+ /** 签名密钥长度(字节)。 */
62
+ const SECRET_BYTES = 32;
63
+ /** 启动图注入页面时用的全局名(与 dsh 的 `window.__DSH_BOOT__` 对应)。 */
64
+ export const BOOT_GLOBAL = '__DSC_BOOT__';
65
+ /** 产物目录不存在时的占位页。 */
66
+ const PLACEHOLDER_HTML = `<!doctype html>
67
+ <html lang="zh-CN">
68
+ <head><meta charset="utf-8" /><title>Pneuma 界面</title></head>
69
+ <body style="font-family: system-ui, sans-serif; margin: 0; padding: 24px; line-height: 1.7">
70
+ <h1 style="font-size: 20px">界面服务已就绪,但界面资产未构建</h1>
71
+ <p>宿主这一半(HTTP + 插件下发)已经起来了,缺的是界面壳的页面文件。</p>
72
+ <p>在仓库的 <code>ui-shell/</code> 下执行 <code>pnpm install &amp;&amp; pnpm build</code>,
73
+ 产物会落到 <code>lib/ui/assets</code> 与 <code>lib/ui/plugins/</code>,刷新本页即可。</p>
74
+ </body>
75
+ </html>
76
+ `;
77
+ /** 没带(或带错)凭据时的回话。刻意不回令牌信息,只说去哪拿。 */
78
+ const UNAUTHORIZED_HTML = `<!doctype html>
79
+ <html lang="zh-CN">
80
+ <head><meta charset="utf-8" /><title>需要凭据</title></head>
81
+ <body style="font-family: system-ui, sans-serif; margin: 0; padding: 24px; line-height: 1.7">
82
+ <h1 style="font-size: 20px">这个地址需要一次性令牌</h1>
83
+ <p>请用宿主启动时打印的那条带 <code>?token=</code> 的地址访问(令牌用一次就作废)。</p>
84
+ </body>
85
+ </html>
86
+ `;
87
+ /**
88
+ * 取(或首次生成)界面会话的签名密钥。
89
+ *
90
+ * 读取时先按形状校验:文件在但内容不成形(被截断、被改坏)就重新生成一份覆盖它——
91
+ * 那会让已下发的 Cookie 全部失效(用户重新换一次票),但比拿一段坏密钥签名安全得多。
92
+ *
93
+ * 落盘失败(只读盘、权限不足)不致命:退回进程内随机密钥,只是宿主重启后旧页面要重新
94
+ * 换票。这种情况会写一行日志(**只说事、不打印密钥**)。
95
+ */
96
+ function loadUiSigningKey(log) {
97
+ const file = dscPath(UI_SECRET_FILE);
98
+ let corrupt = false;
99
+ try {
100
+ const text = readFileSync(file, 'utf8').trim();
101
+ if (/^[A-Za-z0-9_-]{43}$/.test(text)) {
102
+ const key = Buffer.from(text.replaceAll('-', '+').replaceAll('_', '/'), 'base64');
103
+ if (key.byteLength === SECRET_BYTES)
104
+ return key;
105
+ }
106
+ corrupt = true;
107
+ }
108
+ catch {
109
+ // 首次运行:文件还没有。不算异常。
110
+ }
111
+ const key = randomBytes(SECRET_BYTES);
112
+ try {
113
+ mkdirSync(dirname(file), { recursive: true });
114
+ writeFileSync(file, `${key.toString('base64url')}\n`, { mode: 0o600 });
115
+ if (corrupt)
116
+ log(`[ui-server] 签名密钥文件形状不对,已重新生成(${file})`);
117
+ return key;
118
+ }
119
+ catch (error) {
120
+ log(`[ui-server] 签名密钥没法落盘(${error instanceof Error ? error.message : String(error)}):`
121
+ + '本次会话的 Cookie 只在内存里有效,宿主重启后页面要重新换票');
122
+ return key;
123
+ }
124
+ }
125
+ /** 把 bundle 解析结果写出去:200 给头(与体),其余给状态码 + 理由 + Allow 之类的头。 */
126
+ function sendBundleResponse(res, resolved) {
127
+ if (resolved.status === 200) {
128
+ res.writeHead(200, resolved.headers ?? {});
129
+ res.end(resolved.body);
130
+ return;
131
+ }
132
+ res.writeHead(resolved.status, { 'content-type': 'text/plain; charset=utf-8', ...(resolved.headers ?? {}) });
133
+ res.end(resolved.reason ?? '没有这个插件资源');
134
+ }
135
+ /**
136
+ * 壳文档的内容安全策略。启动图走同源外链 `/boot.js`(见 {@link injectBootScriptTag}),
137
+ * 脚本面才能收成 `'self'`——内联注入就得配 nonce,多一套机制不值得。
138
+ * `'unsafe-inline'` 只留给 style:React 的行内样式与 xterm 的运行期样式都是
139
+ * style 属性,收掉会全线破相;`img-src` 放开 `data:` 是预览插件的 base64 图片。
140
+ *
141
+ * 导出给远程控制复用:手机端切壳后伺服的也是这一份文档,同一套策略不该抄第二遍。
142
+ */
143
+ export const UI_CONTENT_SECURITY_POLICY = [
144
+ "default-src 'self'",
145
+ "script-src 'self'",
146
+ "style-src 'self' 'unsafe-inline'",
147
+ "img-src 'self' data:",
148
+ "font-src 'self'",
149
+ "connect-src 'self'",
150
+ "object-src 'none'",
151
+ "base-uri 'none'",
152
+ "frame-ancestors 'none'",
153
+ "form-action 'self'",
154
+ ].join('; ');
155
+ /**
156
+ * 把启动图外链标签插进 `</head>` 之前(本机界面服务与远程壳两份伺服共用这一份实现)。
157
+ * 页面脚本跑起来时 `window.__DSC_BOOT__` 已就位,而 CSP 的 script-src 才能收成 `'self'`。
158
+ */
159
+ export function injectBootScriptTag(html) {
160
+ const tag = '<script src="/boot.js"></script>';
161
+ const head = html.indexOf('</head>');
162
+ return head < 0 ? `${tag}${html}` : `${html.slice(0, head)}${tag}${html.slice(head)}`;
163
+ }
164
+ /** 启动服务并把入口地址算出来。 */
165
+ export async function createUiServer(options) {
166
+ const assetsDir = options.assetsDir ?? uiAssetsDir();
167
+ const pluginsDir = options.pluginsDir ?? uiPluginsDir();
168
+ const events = options.events ?? null;
169
+ const log = options.log ?? ((line) => { process.stderr.write(`${line}\n`); });
170
+ const ttl = options.tokenTtlMs ?? DEFAULT_TOKEN_TTL_MS;
171
+ // 一次性令牌:换到 Cookie 就作废;过期也作废。比对用定长时间(时序侧信道)。
172
+ const token = randomBytes(24).toString('base64url');
173
+ const tokenExpiresAt = Date.now() + ttl;
174
+ let tokenUsed = false;
175
+ // 会话 Cookie 的签名密钥:落盘复用,于是同 authority 下宿主重启后旧页面仍然有效。
176
+ const signingKey = loadUiSigningKey(log);
177
+ // 启动图快照:清单 → 图 → combo 批体一起换代(HMR 也换这一份)。请求路径上不再现算。
178
+ const source = createUiBootSource({
179
+ host: options.host,
180
+ builtinDir: pluginsDir,
181
+ });
182
+ const manifest = source.artifacts().entries;
183
+ /**
184
+ * 监听端口:listen 之后才知道(port=0 时由系统分配)。
185
+ * 必须在造请求处理器之前声明——处理器闭包要用它做 Host 头校验,
186
+ * 而这个绑定是在 await 之后才赋值的,声明放到 await 后面会掉进暂时性死区。
187
+ */
188
+ let currentPort = 0;
189
+ /** 现在这一刻的启动图。 */
190
+ const buildBoot = () => source.graph();
191
+ /** 启动图求值一次给注入用(页面每次请求都注入当下的那一份)。 */
192
+ const bootJson = (graph) => JSON.stringify(graph).replace(/</g, '\\u003c');
193
+ const server = createServer((req, res) => {
194
+ handleRequest(req, res).catch((error) => {
195
+ const reason = error instanceof Error ? error.message : String(error);
196
+ log(`[ui-server] 请求处理失败:${reason}`);
197
+ if (!res.headersSent)
198
+ sendText(res, 500, '内部错误');
199
+ else
200
+ res.end();
201
+ });
202
+ });
203
+ async function handleRequest(req, res) {
204
+ const port = currentPort;
205
+ // 总闸:Host / Sec-Fetch-Site / Origin 三道,**所有**路由(含换票、静态、/api/*)都从这里进。
206
+ const denial = checkUiRequestTrust(req.headers, port);
207
+ if (denial !== null) {
208
+ sendText(res, denial.status, denial.reason);
209
+ return;
210
+ }
211
+ const url = new URL(req.url ?? '/', `http://127.0.0.1:${String(port)}`);
212
+ const method = req.method ?? 'GET';
213
+ // Host 已经过闸,这里的 authority 一定成形;Cookie 的签名与校验都绑在它上面。
214
+ const authority = requestAuthority(req.headers.host);
215
+ const tokens = url.searchParams.getAll('token');
216
+ // 凭据闸:带一次性令牌访问根路径 = 换 Cookie 并跳转(令牌就此作废)。
217
+ if (url.pathname === '/' && tokens.length > 0) {
218
+ if (method !== 'GET') {
219
+ sendText(res, 405, '换票只认 GET');
220
+ return;
221
+ }
222
+ const valid = tokens.length === 1
223
+ && !tokenUsed
224
+ && Date.now() <= tokenExpiresAt
225
+ && timingSafeEqualText(tokens[0], token);
226
+ if (!valid) {
227
+ sendText(res, 403, '令牌无效或已用过,请用宿主最新打印的地址');
228
+ return;
229
+ }
230
+ tokenUsed = true;
231
+ const expiresAt = Date.now() + UI_COOKIE_MAX_AGE_MS;
232
+ res.writeHead(303, {
233
+ 'cache-control': 'no-store',
234
+ location: '/',
235
+ 'referrer-policy': 'no-referrer',
236
+ 'set-cookie': [
237
+ `${UI_COOKIE}=${issueUiCookie(signingKey, authority, expiresAt)}`,
238
+ `Max-Age=${String(Math.floor(UI_COOKIE_MAX_AGE_MS / 1000))}`,
239
+ `Expires=${new Date(expiresAt).toUTCString()}`,
240
+ 'Path=/',
241
+ 'HttpOnly',
242
+ 'SameSite=Strict',
243
+ ].join('; '),
244
+ });
245
+ res.end();
246
+ return;
247
+ }
248
+ if (!verifyUiCookie(signingKey, authority, readCookie(req.headers.cookie, UI_COOKIE), Date.now())) {
249
+ res.writeHead(401, { 'cache-control': 'no-store', 'content-type': 'text/html; charset=utf-8' });
250
+ res.end(UNAUTHORIZED_HTML);
251
+ return;
252
+ }
253
+ // 插件 bundle:内容寻址 + 批 combo;HEAD 复用 GET 的头,非 GET/HEAD 405。
254
+ // 解析口径与远程控制共用 core/ui-route.ts 那一份;combo 只认快照里登记过的精确地址。
255
+ if (isUiBundleRequest(url.pathname)) {
256
+ const resolved = resolveUiResourceRequest(url.pathname, url.search, pluginsDir, method, source.combos());
257
+ // 探针的请求计数面:只数 /plugins 请求,命中类别分开记(回退探针按 id 读)。
258
+ if (resolved.status === 200) {
259
+ if (isUiComboRequest(url.pathname, url.search))
260
+ source.countRequest('combo');
261
+ else {
262
+ const rest = url.pathname.slice('/plugins/'.length);
263
+ const slash = rest.lastIndexOf('/');
264
+ source.countRequest('single', slash > 0 ? decodeURIComponent(rest.slice(0, slash)) : undefined);
265
+ }
266
+ }
267
+ sendBundleResponse(res, resolved);
268
+ return;
269
+ }
270
+ if (url.pathname === '/api/boot') {
271
+ if (method !== 'GET' && method !== 'HEAD') {
272
+ sendText(res, 405, '启动图只认 GET 与 HEAD');
273
+ return;
274
+ }
275
+ // HEAD 不用特殊处理:node 对 HEAD 只发头、不发体(content-length 照给)。
276
+ sendJson(res, 200, buildBoot());
277
+ return;
278
+ }
279
+ // 启动图的外链脚本:与昔日内联注入等价(</head> 前同步执行完,页面脚本跑起来时
280
+ // 全局已就位),但 CSP 的 script-src 才能收成 'self'。同样在 Cookie 闸之后。
281
+ if (url.pathname === '/boot.js') {
282
+ if (method !== 'GET' && method !== 'HEAD') {
283
+ sendText(res, 405, '启动图脚本只认 GET 与 HEAD');
284
+ return;
285
+ }
286
+ const body = `globalThis.${BOOT_GLOBAL}=${bootJson(buildBoot())}`;
287
+ res.writeHead(200, {
288
+ 'content-type': 'text/javascript; charset=utf-8',
289
+ 'content-length': Buffer.byteLength(body),
290
+ 'cache-control': 'no-cache',
291
+ });
292
+ res.end(method === 'HEAD' ? undefined : body);
293
+ return;
294
+ }
295
+ // 数据通道:SSE 推帧 + POST 调方法(通道本体在 core/ui-events.ts,鉴权在这一层)。
296
+ if (events !== null && url.pathname === '/api/events') {
297
+ if (method !== 'GET') {
298
+ // SSE 是一条长连接,HEAD 没有意义,因此这里连 HEAD 也拒(只认 GET)。
299
+ sendText(res, 405, '事件流只认 GET');
300
+ return;
301
+ }
302
+ events.handleEvents(req, res);
303
+ return;
304
+ }
305
+ if (events !== null && url.pathname === '/api/invoke') {
306
+ if (method !== 'POST') {
307
+ sendText(res, 405, '调用只认 POST');
308
+ return;
309
+ }
310
+ await events.handleInvoke(req, res);
311
+ return;
312
+ }
313
+ if (method === 'GET' || method === 'HEAD') {
314
+ const served = serveStatic(res, url.pathname, assetsDir, {
315
+ placeholderHtml: PLACEHOLDER_HTML,
316
+ transformHtml: injectBootScriptTag,
317
+ contentSecurityPolicy: UI_CONTENT_SECURITY_POLICY,
318
+ });
319
+ if (!served)
320
+ log(`[ui-server] 未命中静态文件:${url.pathname}`);
321
+ return;
322
+ }
323
+ sendText(res, 405, '不支持这个请求方法');
324
+ }
325
+ /** 监听:port=0 时由系统分配,绑完才知道端口。 */
326
+ await new Promise((resolveListen, rejectListen) => {
327
+ server.once('error', rejectListen);
328
+ server.listen(options.port ?? 0, '127.0.0.1', () => {
329
+ const address = server.address();
330
+ if (address === null || typeof address === 'string') {
331
+ rejectListen(new Error('界面服务监听失败:拿不到端口'));
332
+ return;
333
+ }
334
+ currentPort = address.port;
335
+ resolveListen();
336
+ });
337
+ });
338
+ const handle = {
339
+ get port() {
340
+ return currentPort;
341
+ },
342
+ get origin() {
343
+ return `http://127.0.0.1:${String(currentPort)}`;
344
+ },
345
+ get url() {
346
+ return `http://127.0.0.1:${String(currentPort)}/?token=${token}`;
347
+ },
348
+ boot: () => buildBoot(),
349
+ problems: () => source.problems(),
350
+ refresh: () => source.refresh(),
351
+ watchRows: () => source.watchRows(),
352
+ stats: () => source.stats(),
353
+ resetStats: () => source.resetStats(),
354
+ close: () => new Promise((resolveClose) => {
355
+ server.close(() => resolveClose());
356
+ server.closeAllConnections();
357
+ }),
358
+ };
359
+ // 清单为空也要说清楚:多半是界面壳还没构建,不是插件写错了。
360
+ if (manifest.length === 0) {
361
+ log(`[ui-server] 插件目录里没有可下发的界面插件(${pluginsDir});界面壳构建过了吗`);
362
+ }
363
+ else {
364
+ log(`[ui-server] 已登记 ${String(manifest.length)} 个界面插件`);
365
+ }
366
+ for (const problem of source.problems())
367
+ log(`[ui-server] ${problem}`);
368
+ return handle;
369
+ }
@@ -0,0 +1,47 @@
1
+ import type { IncomingHttpHeaders } from 'node:http';
2
+ /** 被拒时的回话:状态码 + 一句话理由(理由只进日志/响应体,不泄露任何凭据)。 */
3
+ export interface UiTrustDenial {
4
+ status: number;
5
+ reason: string;
6
+ }
7
+ /**
8
+ * Host 头归一化成本服务的 authority(`127.0.0.1:17321`、`[::1]:17321`)。
9
+ * 解析不了给空串——空串与任何真实 authority 都不等,凭据校验因此必然不过(失败关闭)。
10
+ */
11
+ export declare function requestAuthority(host: string | undefined): string;
12
+ /**
13
+ * 三道闸。通过给 `null`,被拒给状态码与理由。
14
+ *
15
+ * @param headers - 请求头
16
+ * @param port - 本服务真正在听的端口(Host 闸要比对它)
17
+ */
18
+ export declare function checkUiRequestTrust(headers: IncomingHttpHeaders, port: number): UiTrustDenial | null;
19
+ /**
20
+ * 定长时间比较两段文本(令牌、签名都用它)。
21
+ *
22
+ * 为什么不能用 `!==`:字符串比较在第一个不同的字节就返回,逐字节的耗时差能被
23
+ * 本机进程用统计手法读出来,从而一个字节一个字节地试出令牌。长度不等直接返回 false
24
+ * ——`timingSafeEqual` 对不等长的入参会抛异常,而长度本身不是秘密。
25
+ */
26
+ export declare function timingSafeEqualText(actual: string, expected: string): boolean;
27
+ /**
28
+ * 签一条会话 Cookie 的值。
29
+ *
30
+ * @param key - 宿主持有的签名密钥
31
+ * @param authority - 本服务的 authority(从 Host 头取,已过信任闸)
32
+ * @param expiresAt - 过期时刻(毫秒时间戳)
33
+ */
34
+ export declare function issueUiCookie(key: Buffer, authority: string, expiresAt: number): string;
35
+ /**
36
+ * 校验一条会话 Cookie 的值。
37
+ *
38
+ * 四件事都要成立:版本对得上、过期时间还没到、签名是密钥算出来的、且它签的 authority
39
+ * 就是这次请求的 authority。签名校验用定长时间比较;过期时间戳按 Cookie 里的**原文**
40
+ * 重新拼签名体,所以改写成 `1e3` 这类等价但不同文本的形式也会因签名不符而失败。
41
+ *
42
+ * @param key - 宿主持有的签名密钥
43
+ * @param authority - 这次请求的 authority
44
+ * @param value - Cookie 里的值(没带给 null)
45
+ * @param now - 现在(毫秒时间戳,测试可注入)
46
+ */
47
+ export declare function verifyUiCookie(key: Buffer, authority: string, value: string | null, now: number): boolean;