@waq666/pneuma 0.0.0-stage → 0.7.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (708) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +206 -3
  3. package/bin/dsc.js +91 -0
  4. package/bin/headless.cjs +40 -0
  5. package/lib/adapter/core-runtime.d.ts +11 -0
  6. package/lib/adapter/core-runtime.js +259 -0
  7. package/lib/adapter/host.d.ts +18 -0
  8. package/lib/adapter/host.js +14 -0
  9. package/lib/adapter/runtime.d.ts +15 -0
  10. package/lib/adapter/runtime.js +290 -0
  11. package/lib/adapter/transcript.d.ts +184 -0
  12. package/lib/adapter/transcript.js +605 -0
  13. package/lib/app/AgentsOverlay.d.ts +18 -0
  14. package/lib/app/AgentsOverlay.js +63 -0
  15. package/lib/app/App.d.ts +15 -0
  16. package/lib/app/App.js +1650 -0
  17. package/lib/app/App.js.nv-backup +1650 -0
  18. package/lib/app/ApprovalCard.d.ts +12 -0
  19. package/lib/app/ApprovalCard.js +76 -0
  20. package/lib/app/AskCard.d.ts +20 -0
  21. package/lib/app/AskCard.js +45 -0
  22. package/lib/app/ChatView.d.ts +63 -0
  23. package/lib/app/ChatView.js +310 -0
  24. package/lib/app/Composer.d.ts +50 -0
  25. package/lib/app/Composer.js +282 -0
  26. package/lib/app/DiffBlock.d.ts +6 -0
  27. package/lib/app/DiffBlock.js +37 -0
  28. package/lib/app/MarkdownView.d.ts +6 -0
  29. package/lib/app/MarkdownView.js +99 -0
  30. package/lib/app/ModelPicker.d.ts +7 -0
  31. package/lib/app/ModelPicker.js +18 -0
  32. package/lib/app/PlanReviewCard.d.ts +13 -0
  33. package/lib/app/PlanReviewCard.js +54 -0
  34. package/lib/app/PresetPicker.d.ts +11 -0
  35. package/lib/app/PresetPicker.js +19 -0
  36. package/lib/app/PreviewOverlay.d.ts +14 -0
  37. package/lib/app/PreviewOverlay.js +22 -0
  38. package/lib/app/SessionPicker.d.ts +43 -0
  39. package/lib/app/SessionPicker.js +56 -0
  40. package/lib/app/SettingsOverlay.d.ts +32 -0
  41. package/lib/app/SettingsOverlay.js +157 -0
  42. package/lib/app/SkillsPicker.d.ts +7 -0
  43. package/lib/app/SkillsPicker.js +19 -0
  44. package/lib/app/StatusBar.d.ts +22 -0
  45. package/lib/app/StatusBar.js +201 -0
  46. package/lib/app/TaskStrips.d.ts +13 -0
  47. package/lib/app/TaskStrips.js +40 -0
  48. package/lib/app/TimelineRail.d.ts +22 -0
  49. package/lib/app/TimelineRail.js +160 -0
  50. package/lib/app/TimelineRail.js.negbak +98 -0
  51. package/lib/app/TimelineRail.js.nv-backup +160 -0
  52. package/lib/app/ToolCard.d.ts +11 -0
  53. package/lib/app/ToolCard.js +64 -0
  54. package/lib/app/ToolCard.js.nv-backup +64 -0
  55. package/lib/app/TranscriptOverlay.d.ts +27 -0
  56. package/lib/app/TranscriptOverlay.js +36 -0
  57. package/lib/app/TranscriptViewport.d.ts +78 -0
  58. package/lib/app/TranscriptViewport.js +218 -0
  59. package/lib/app/Welcome.d.ts +6 -0
  60. package/lib/app/Welcome.js +71 -0
  61. package/lib/app/attach.d.ts +16 -0
  62. package/lib/app/attach.js +58 -0
  63. package/lib/app/click.d.ts +40 -0
  64. package/lib/app/click.js +103 -0
  65. package/lib/app/clipboard-image.d.ts +11 -0
  66. package/lib/app/clipboard-image.js +66 -0
  67. package/lib/app/cursor.d.ts +4 -0
  68. package/lib/app/cursor.js +24 -0
  69. package/lib/app/hello.d.ts +11 -0
  70. package/lib/app/hello.js +8 -0
  71. package/lib/app/history-store.d.ts +4 -0
  72. package/lib/app/history-store.js +41 -0
  73. package/lib/app/image-blocks.d.ts +12 -0
  74. package/lib/app/image-blocks.js +125 -0
  75. package/lib/app/keymap.d.ts +56 -0
  76. package/lib/app/keymap.js +56 -0
  77. package/lib/app/markdown.d.ts +54 -0
  78. package/lib/app/markdown.js +189 -0
  79. package/lib/app/mouse.d.ts +33 -0
  80. package/lib/app/mouse.js +35 -0
  81. package/lib/app/pointer.d.ts +16 -0
  82. package/lib/app/pointer.js +60 -0
  83. package/lib/app/scroll-model.d.ts +240 -0
  84. package/lib/app/scroll-model.js +347 -0
  85. package/lib/app/settings-model.d.ts +69 -0
  86. package/lib/app/settings-model.js +114 -0
  87. package/lib/app/snapshot-subscribe.d.ts +34 -0
  88. package/lib/app/snapshot-subscribe.js +110 -0
  89. package/lib/app/theme.d.ts +194 -0
  90. package/lib/app/theme.js +186 -0
  91. package/lib/app/ticker.d.ts +7 -0
  92. package/lib/app/ticker.js +53 -0
  93. package/lib/boot.d.ts +1 -0
  94. package/lib/boot.js +34 -0
  95. package/lib/commands.d.ts +49 -0
  96. package/lib/commands.js +115 -0
  97. package/lib/contract.d.ts +1973 -0
  98. package/lib/contract.js +36 -0
  99. package/lib/core/agent-roles.d.ts +52 -0
  100. package/lib/core/agent-roles.js +274 -0
  101. package/lib/core/approval-floor.d.ts +183 -0
  102. package/lib/core/approval-floor.js +679 -0
  103. package/lib/core/approval.d.ts +42 -0
  104. package/lib/core/approval.js +8 -0
  105. package/lib/core/audit.d.ts +61 -0
  106. package/lib/core/audit.js +59 -0
  107. package/lib/core/boot-notices.d.ts +6 -0
  108. package/lib/core/boot-notices.js +61 -0
  109. package/lib/core/cdp/actions.d.ts +182 -0
  110. package/lib/core/cdp/actions.js +649 -0
  111. package/lib/core/cdp/launch.d.ts +192 -0
  112. package/lib/core/cdp/launch.js +491 -0
  113. package/lib/core/cdp/snapshot.d.ts +139 -0
  114. package/lib/core/cdp/snapshot.js +316 -0
  115. package/lib/core/cdp/transport.d.ts +160 -0
  116. package/lib/core/cdp/transport.js +359 -0
  117. package/lib/core/command-policy.d.ts +108 -0
  118. package/lib/core/command-policy.js +580 -0
  119. package/lib/core/commands-completion.d.ts +78 -0
  120. package/lib/core/commands-completion.js +167 -0
  121. package/lib/core/compact-anchors.d.ts +76 -0
  122. package/lib/core/compact-anchors.js +284 -0
  123. package/lib/core/compact.d.ts +110 -0
  124. package/lib/core/compact.js +210 -0
  125. package/lib/core/config-store.d.ts +38 -0
  126. package/lib/core/config-store.js +307 -0
  127. package/lib/core/config.d.ts +36 -0
  128. package/lib/core/config.js +124 -0
  129. package/lib/core/connection-test.d.ts +60 -0
  130. package/lib/core/connection-test.js +84 -0
  131. package/lib/core/desktop-control.d.ts +298 -0
  132. package/lib/core/desktop-control.js +1311 -0
  133. package/lib/core/diff-text.d.ts +74 -0
  134. package/lib/core/diff-text.js +257 -0
  135. package/lib/core/dock-browser.d.ts +137 -0
  136. package/lib/core/dock-browser.js +146 -0
  137. package/lib/core/dock-ops.d.ts +59 -0
  138. package/lib/core/dock-ops.js +104 -0
  139. package/lib/core/dock-session.d.ts +39 -0
  140. package/lib/core/dock-session.js +28 -0
  141. package/lib/core/dsh-compat/hook.d.ts +18 -0
  142. package/lib/core/dsh-compat/hook.js +52 -0
  143. package/lib/core/dsh-compat/resolve-hook.d.ts +5 -0
  144. package/lib/core/dsh-compat/resolve-hook.js +59 -0
  145. package/lib/core/dsh-compat/tools-facade.d.ts +47 -0
  146. package/lib/core/dsh-compat/tools-facade.js +108 -0
  147. package/lib/core/err-text.d.ts +13 -0
  148. package/lib/core/err-text.js +15 -0
  149. package/lib/core/events.d.ts +149 -0
  150. package/lib/core/events.js +1 -0
  151. package/lib/core/git-exec.d.ts +23 -0
  152. package/lib/core/git-exec.js +72 -0
  153. package/lib/core/git-info.d.ts +47 -0
  154. package/lib/core/git-info.js +157 -0
  155. package/lib/core/goal.d.ts +89 -0
  156. package/lib/core/goal.js +189 -0
  157. package/lib/core/hooks.d.ts +272 -0
  158. package/lib/core/hooks.js +818 -0
  159. package/lib/core/host-browser-link.d.ts +59 -0
  160. package/lib/core/host-browser-link.js +9 -0
  161. package/lib/core/host-methods.d.ts +25 -0
  162. package/lib/core/host-methods.js +103 -0
  163. package/lib/core/image-diet.d.ts +77 -0
  164. package/lib/core/image-diet.js +127 -0
  165. package/lib/core/learnings/ledger.d.ts +73 -0
  166. package/lib/core/learnings/ledger.js +273 -0
  167. package/lib/core/learnings/skill-write.d.ts +250 -0
  168. package/lib/core/learnings/skill-write.js +854 -0
  169. package/lib/core/learnings/store.d.ts +102 -0
  170. package/lib/core/learnings/store.js +266 -0
  171. package/lib/core/lifecycle-hooks.d.ts +189 -0
  172. package/lib/core/lifecycle-hooks.js +576 -0
  173. package/lib/core/llm.d.ts +283 -0
  174. package/lib/core/llm.js +565 -0
  175. package/lib/core/lockfile.d.ts +17 -0
  176. package/lib/core/lockfile.js +110 -0
  177. package/lib/core/loop.d.ts +185 -0
  178. package/lib/core/loop.js +587 -0
  179. package/lib/core/lsp/client.d.ts +189 -0
  180. package/lib/core/lsp/client.js +690 -0
  181. package/lib/core/lsp/framing.d.ts +84 -0
  182. package/lib/core/lsp/framing.js +181 -0
  183. package/lib/core/lsp/line-shift.d.ts +28 -0
  184. package/lib/core/lsp/line-shift.js +127 -0
  185. package/lib/core/lsp/manager.d.ts +93 -0
  186. package/lib/core/lsp/manager.js +418 -0
  187. package/lib/core/lsp/normalize.d.ts +32 -0
  188. package/lib/core/lsp/normalize.js +139 -0
  189. package/lib/core/lsp/servers.d.ts +106 -0
  190. package/lib/core/lsp/servers.js +352 -0
  191. package/lib/core/lsp/uri.d.ts +76 -0
  192. package/lib/core/lsp/uri.js +179 -0
  193. package/lib/core/market.d.ts +51 -0
  194. package/lib/core/market.js +358 -0
  195. package/lib/core/mcp.d.ts +201 -0
  196. package/lib/core/mcp.js +836 -0
  197. package/lib/core/memory-eval.d.ts +158 -0
  198. package/lib/core/memory-eval.js +215 -0
  199. package/lib/core/memory.d.ts +266 -0
  200. package/lib/core/memory.js +703 -0
  201. package/lib/core/mention.d.ts +57 -0
  202. package/lib/core/mention.js +129 -0
  203. package/lib/core/microcompact.d.ts +48 -0
  204. package/lib/core/microcompact.js +79 -0
  205. package/lib/core/migrate.d.ts +56 -0
  206. package/lib/core/migrate.js +134 -0
  207. package/lib/core/model-caps.d.ts +83 -0
  208. package/lib/core/model-caps.js +150 -0
  209. package/lib/core/model-discovery.d.ts +19 -0
  210. package/lib/core/model-discovery.js +69 -0
  211. package/lib/core/modes.d.ts +72 -0
  212. package/lib/core/modes.js +152 -0
  213. package/lib/core/native-bridge.d.ts +135 -0
  214. package/lib/core/native-bridge.js +563 -0
  215. package/lib/core/path-policy.d.ts +32 -0
  216. package/lib/core/path-policy.js +248 -0
  217. package/lib/core/permission-presets.d.ts +67 -0
  218. package/lib/core/permission-presets.js +75 -0
  219. package/lib/core/plugin-loader.d.ts +36 -0
  220. package/lib/core/plugin-loader.js +294 -0
  221. package/lib/core/plugin-registry.d.ts +113 -0
  222. package/lib/core/plugin-registry.js +256 -0
  223. package/lib/core/prefs.d.ts +82 -0
  224. package/lib/core/prefs.js +372 -0
  225. package/lib/core/presets.d.ts +80 -0
  226. package/lib/core/presets.js +373 -0
  227. package/lib/core/pricing.d.ts +90 -0
  228. package/lib/core/pricing.js +126 -0
  229. package/lib/core/prompt.d.ts +92 -0
  230. package/lib/core/prompt.js +339 -0
  231. package/lib/core/ptc.d.ts +66 -0
  232. package/lib/core/ptc.js +70 -0
  233. package/lib/core/remote/frames.d.ts +91 -0
  234. package/lib/core/remote/frames.js +174 -0
  235. package/lib/core/remote/notify.d.ts +54 -0
  236. package/lib/core/remote/notify.js +77 -0
  237. package/lib/core/remote/owner.d.ts +32 -0
  238. package/lib/core/remote/owner.js +75 -0
  239. package/lib/core/remote/pairing.d.ts +104 -0
  240. package/lib/core/remote/pairing.js +261 -0
  241. package/lib/core/remote/push.d.ts +80 -0
  242. package/lib/core/remote/push.js +222 -0
  243. package/lib/core/remote/store.d.ts +18 -0
  244. package/lib/core/remote/store.js +59 -0
  245. package/lib/core/remote/tickets.d.ts +20 -0
  246. package/lib/core/remote/tickets.js +49 -0
  247. package/lib/core/remote/uploads.d.ts +63 -0
  248. package/lib/core/remote/uploads.js +161 -0
  249. package/lib/core/request-attribution.d.ts +26 -0
  250. package/lib/core/request-attribution.js +86 -0
  251. package/lib/core/request-invariant.d.ts +61 -0
  252. package/lib/core/request-invariant.js +199 -0
  253. package/lib/core/sandbox/backends.d.ts +64 -0
  254. package/lib/core/sandbox/backends.js +194 -0
  255. package/lib/core/sandbox/execpolicy.d.ts +93 -0
  256. package/lib/core/sandbox/execpolicy.js +452 -0
  257. package/lib/core/sandbox/net-proxy.d.ts +31 -0
  258. package/lib/core/sandbox/net-proxy.js +162 -0
  259. package/lib/core/sandbox/policy.d.ts +211 -0
  260. package/lib/core/sandbox/policy.js +559 -0
  261. package/lib/core/sandbox/win/abi.d.ts +161 -0
  262. package/lib/core/sandbox/win/abi.js +169 -0
  263. package/lib/core/sandbox/win/account.d.ts +71 -0
  264. package/lib/core/sandbox/win/account.js +206 -0
  265. package/lib/core/sandbox/win/acl.d.ts +54 -0
  266. package/lib/core/sandbox/win/acl.js +339 -0
  267. package/lib/core/sandbox/win/backend.d.ts +61 -0
  268. package/lib/core/sandbox/win/backend.js +249 -0
  269. package/lib/core/sandbox/win/doctor.d.ts +24 -0
  270. package/lib/core/sandbox/win/doctor.js +272 -0
  271. package/lib/core/sandbox/win/ffi.d.ts +107 -0
  272. package/lib/core/sandbox/win/ffi.js +166 -0
  273. package/lib/core/sandbox/win/net-abi.d.ts +154 -0
  274. package/lib/core/sandbox/win/net-abi.js +316 -0
  275. package/lib/core/sandbox/win/runner-entry.d.ts +35 -0
  276. package/lib/core/sandbox/win/runner-entry.js +391 -0
  277. package/lib/core/sandbox/win/setup.d.ts +60 -0
  278. package/lib/core/sandbox/win/setup.js +986 -0
  279. package/lib/core/sandbox/win/token.d.ts +35 -0
  280. package/lib/core/sandbox/win/token.js +238 -0
  281. package/lib/core/sandbox/win/wfp.d.ts +41 -0
  282. package/lib/core/sandbox/win/wfp.js +200 -0
  283. package/lib/core/sandbox/win/workspace-sid.d.ts +9 -0
  284. package/lib/core/sandbox/win/workspace-sid.js +45 -0
  285. package/lib/core/schedule/rule.d.ts +184 -0
  286. package/lib/core/schedule/rule.js +745 -0
  287. package/lib/core/schedule/runner.d.ts +185 -0
  288. package/lib/core/schedule/runner.js +678 -0
  289. package/lib/core/schedule/store.d.ts +182 -0
  290. package/lib/core/schedule/store.js +455 -0
  291. package/lib/core/secrets.d.ts +41 -0
  292. package/lib/core/secrets.js +150 -0
  293. package/lib/core/session-export.d.ts +18 -0
  294. package/lib/core/session-export.js +73 -0
  295. package/lib/core/session-index.d.ts +159 -0
  296. package/lib/core/session-index.js +683 -0
  297. package/lib/core/session-meta.d.ts +41 -0
  298. package/lib/core/session-meta.js +97 -0
  299. package/lib/core/session.d.ts +356 -0
  300. package/lib/core/session.js +998 -0
  301. package/lib/core/skills.d.ts +60 -0
  302. package/lib/core/skills.js +171 -0
  303. package/lib/core/spill.d.ts +159 -0
  304. package/lib/core/spill.js +329 -0
  305. package/lib/core/surface-registry.d.ts +45 -0
  306. package/lib/core/surface-registry.js +67 -0
  307. package/lib/core/team-board.d.ts +95 -0
  308. package/lib/core/team-board.js +316 -0
  309. package/lib/core/throughput.d.ts +46 -0
  310. package/lib/core/throughput.js +40 -0
  311. package/lib/core/todo-reminder.d.ts +44 -0
  312. package/lib/core/todo-reminder.js +55 -0
  313. package/lib/core/todo.d.ts +81 -0
  314. package/lib/core/todo.js +222 -0
  315. package/lib/core/token-estimate.d.ts +55 -0
  316. package/lib/core/token-estimate.js +82 -0
  317. package/lib/core/tool-guards.d.ts +103 -0
  318. package/lib/core/tool-guards.js +77 -0
  319. package/lib/core/tool-search.d.ts +152 -0
  320. package/lib/core/tool-search.js +311 -0
  321. package/lib/core/tools/bash.d.ts +281 -0
  322. package/lib/core/tools/bash.js +871 -0
  323. package/lib/core/tools/command-runner.d.ts +84 -0
  324. package/lib/core/tools/command-runner.js +68 -0
  325. package/lib/core/tools/fs-tools.d.ts +23 -0
  326. package/lib/core/tools/fs-tools.js +247 -0
  327. package/lib/core/tools/index.d.ts +8 -0
  328. package/lib/core/tools/index.js +4 -0
  329. package/lib/core/tools/sandbox-args.d.ts +51 -0
  330. package/lib/core/tools/sandbox-args.js +90 -0
  331. package/lib/core/tools/search-tools.d.ts +3 -0
  332. package/lib/core/tools/search-tools.js +153 -0
  333. package/lib/core/tools.d.ts +96 -0
  334. package/lib/core/tools.js +53 -0
  335. package/lib/core/ui-boot-source.d.ts +71 -0
  336. package/lib/core/ui-boot-source.js +121 -0
  337. package/lib/core/ui-bundles.d.ts +249 -0
  338. package/lib/core/ui-bundles.js +830 -0
  339. package/lib/core/ui-combo.d.ts +49 -0
  340. package/lib/core/ui-combo.js +55 -0
  341. package/lib/core/ui-events.d.ts +81 -0
  342. package/lib/core/ui-events.js +364 -0
  343. package/lib/core/ui-hmr.d.ts +36 -0
  344. package/lib/core/ui-hmr.js +128 -0
  345. package/lib/core/ui-methods.d.ts +69 -0
  346. package/lib/core/ui-methods.js +341 -0
  347. package/lib/core/ui-route.d.ts +69 -0
  348. package/lib/core/ui-route.js +122 -0
  349. package/lib/core/ui-server.d.ts +75 -0
  350. package/lib/core/ui-server.js +369 -0
  351. package/lib/core/ui-trust.d.ts +47 -0
  352. package/lib/core/ui-trust.js +164 -0
  353. package/lib/core/untrusted.d.ts +30 -0
  354. package/lib/core/untrusted.js +48 -0
  355. package/lib/core/update-check.d.ts +81 -0
  356. package/lib/core/update-check.js +177 -0
  357. package/lib/core/usage-log.d.ts +82 -0
  358. package/lib/core/usage-log.js +306 -0
  359. package/lib/core/version.d.ts +1 -0
  360. package/lib/core/version.js +37 -0
  361. package/lib/core/web-http.d.ts +57 -0
  362. package/lib/core/web-http.js +137 -0
  363. package/lib/core/web-static.d.ts +31 -0
  364. package/lib/core/web-static.js +75 -0
  365. package/lib/headless.d.ts +1 -0
  366. package/lib/headless.js +31 -0
  367. package/lib/host/kernel.d.ts +33 -0
  368. package/lib/host/kernel.js +451 -0
  369. package/lib/index.d.ts +41 -0
  370. package/lib/index.js +35 -0
  371. package/lib/plugins/agent.d.ts +2 -0
  372. package/lib/plugins/agent.js +274 -0
  373. package/lib/plugins/approval-floor.d.ts +2 -0
  374. package/lib/plugins/approval-floor.js +223 -0
  375. package/lib/plugins/approval.d.ts +16 -0
  376. package/lib/plugins/approval.js +674 -0
  377. package/lib/plugins/ask.d.ts +2 -0
  378. package/lib/plugins/ask.js +245 -0
  379. package/lib/plugins/browser.d.ts +68 -0
  380. package/lib/plugins/browser.js +1341 -0
  381. package/lib/plugins/commands.d.ts +23 -0
  382. package/lib/plugins/commands.js +498 -0
  383. package/lib/plugins/compact.d.ts +21 -0
  384. package/lib/plugins/compact.js +274 -0
  385. package/lib/plugins/computer-use.d.ts +47 -0
  386. package/lib/plugins/computer-use.js +539 -0
  387. package/lib/plugins/desktop-dock.d.ts +2 -0
  388. package/lib/plugins/desktop-dock.js +626 -0
  389. package/lib/plugins/dock-browser.d.ts +34 -0
  390. package/lib/plugins/dock-browser.js +765 -0
  391. package/lib/plugins/dsh-compat.d.ts +25 -0
  392. package/lib/plugins/dsh-compat.js +37 -0
  393. package/lib/plugins/file-review.d.ts +108 -0
  394. package/lib/plugins/file-review.js +393 -0
  395. package/lib/plugins/git.d.ts +26 -0
  396. package/lib/plugins/git.js +132 -0
  397. package/lib/plugins/goal.d.ts +20 -0
  398. package/lib/plugins/goal.js +245 -0
  399. package/lib/plugins/guards.d.ts +14 -0
  400. package/lib/plugins/guards.js +18 -0
  401. package/lib/plugins/hooks.d.ts +19 -0
  402. package/lib/plugins/hooks.js +583 -0
  403. package/lib/plugins/host-stdio.d.ts +88 -0
  404. package/lib/plugins/host-stdio.js +317 -0
  405. package/lib/plugins/image-diet.d.ts +17 -0
  406. package/lib/plugins/image-diet.js +85 -0
  407. package/lib/plugins/lifecycle-hooks.d.ts +26 -0
  408. package/lib/plugins/lifecycle-hooks.js +338 -0
  409. package/lib/plugins/llm.d.ts +13 -0
  410. package/lib/plugins/llm.js +215 -0
  411. package/lib/plugins/lsp.d.ts +54 -0
  412. package/lib/plugins/lsp.js +608 -0
  413. package/lib/plugins/mcp.d.ts +16 -0
  414. package/lib/plugins/mcp.js +673 -0
  415. package/lib/plugins/memory.d.ts +17 -0
  416. package/lib/plugins/memory.js +858 -0
  417. package/lib/plugins/microcompact.d.ts +18 -0
  418. package/lib/plugins/microcompact.js +119 -0
  419. package/lib/plugins/mode.d.ts +18 -0
  420. package/lib/plugins/mode.js +115 -0
  421. package/lib/plugins/permission-presets.d.ts +18 -0
  422. package/lib/plugins/permission-presets.js +135 -0
  423. package/lib/plugins/plan.d.ts +2 -0
  424. package/lib/plugins/plan.js +192 -0
  425. package/lib/plugins/plugin-manager.d.ts +2 -0
  426. package/lib/plugins/plugin-manager.js +165 -0
  427. package/lib/plugins/presets.d.ts +2 -0
  428. package/lib/plugins/presets.js +182 -0
  429. package/lib/plugins/prompt.d.ts +2 -0
  430. package/lib/plugins/prompt.js +264 -0
  431. package/lib/plugins/ptc.d.ts +2 -0
  432. package/lib/plugins/ptc.js +272 -0
  433. package/lib/plugins/remote/http.d.ts +11 -0
  434. package/lib/plugins/remote/http.js +11 -0
  435. package/lib/plugins/remote/routes.d.ts +24 -0
  436. package/lib/plugins/remote/routes.js +384 -0
  437. package/lib/plugins/remote/types.d.ts +135 -0
  438. package/lib/plugins/remote/types.js +87 -0
  439. package/lib/plugins/remote.d.ts +17 -0
  440. package/lib/plugins/remote.js +1028 -0
  441. package/lib/plugins/runtime-api.d.ts +16 -0
  442. package/lib/plugins/runtime-api.js +99 -0
  443. package/lib/plugins/runtime.d.ts +10 -0
  444. package/lib/plugins/runtime.js +451 -0
  445. package/lib/plugins/sandbox.d.ts +2 -0
  446. package/lib/plugins/sandbox.js +761 -0
  447. package/lib/plugins/schedule.d.ts +26 -0
  448. package/lib/plugins/schedule.js +538 -0
  449. package/lib/plugins/self-improve.d.ts +61 -0
  450. package/lib/plugins/self-improve.js +953 -0
  451. package/lib/plugins/session-search.d.ts +16 -0
  452. package/lib/plugins/session-search.js +308 -0
  453. package/lib/plugins/session-title.d.ts +19 -0
  454. package/lib/plugins/session-title.js +109 -0
  455. package/lib/plugins/session.d.ts +7 -0
  456. package/lib/plugins/session.js +296 -0
  457. package/lib/plugins/settings.d.ts +3 -0
  458. package/lib/plugins/settings.js +705 -0
  459. package/lib/plugins/skills.d.ts +2 -0
  460. package/lib/plugins/skills.js +360 -0
  461. package/lib/plugins/spill.d.ts +16 -0
  462. package/lib/plugins/spill.js +200 -0
  463. package/lib/plugins/subagent.d.ts +2 -0
  464. package/lib/plugins/subagent.js +896 -0
  465. package/lib/plugins/surfaces.d.ts +11 -0
  466. package/lib/plugins/surfaces.js +20 -0
  467. package/lib/plugins/team.d.ts +16 -0
  468. package/lib/plugins/team.js +149 -0
  469. package/lib/plugins/todo.d.ts +19 -0
  470. package/lib/plugins/todo.js +188 -0
  471. package/lib/plugins/tool-search.d.ts +2 -0
  472. package/lib/plugins/tool-search.js +434 -0
  473. package/lib/plugins/tool-search.js.nv-backup +434 -0
  474. package/lib/plugins/tools-default.d.ts +12 -0
  475. package/lib/plugins/tools-default.js +275 -0
  476. package/lib/plugins/tools.d.ts +16 -0
  477. package/lib/plugins/tools.js +62 -0
  478. package/lib/plugins/transcript.d.ts +15 -0
  479. package/lib/plugins/transcript.js +311 -0
  480. package/lib/plugins/tui.d.ts +2 -0
  481. package/lib/plugins/tui.js +98 -0
  482. package/lib/plugins/waiting.d.ts +12 -0
  483. package/lib/plugins/waiting.js +34 -0
  484. package/lib/plugins/web-search.d.ts +14 -0
  485. package/lib/plugins/web-search.js +263 -0
  486. package/lib/plugins/webserver.d.ts +48 -0
  487. package/lib/plugins/webserver.js +228 -0
  488. package/lib/remote/assets/app-DAcUCOEn.js +14 -0
  489. package/lib/remote/assets/icon-192.png +0 -0
  490. package/lib/remote/assets/icon-512.png +0 -0
  491. package/lib/remote/assets/index.html +34 -0
  492. package/lib/remote/assets/manifest.json +27 -0
  493. package/lib/remote/assets/style-DIB6729x.css +1 -0
  494. package/lib/remote/assets/sw.js +66 -0
  495. package/lib/services/types.d.ts +1228 -0
  496. package/lib/services/types.js +1 -0
  497. package/lib/tools/config-cli.d.ts +1 -0
  498. package/lib/tools/config-cli.js +89 -0
  499. package/lib/ui/arrival.d.ts +72 -0
  500. package/lib/ui/arrival.js +105 -0
  501. package/lib/ui/assets/app-B70nVIKd.js +69 -0
  502. package/lib/ui/assets/chunk-2UxHyX5q.js +1 -0
  503. package/lib/ui/assets/chunk-B1dDrJ26.js +1 -0
  504. package/lib/ui/assets/chunk-B6aJPvgy.js +1 -0
  505. package/lib/ui/assets/chunk-BEwlwnbL.js +1 -0
  506. package/lib/ui/assets/chunk-BGcgwlCI.js +12 -0
  507. package/lib/ui/assets/chunk-BIGW1oBm.js +1 -0
  508. package/lib/ui/assets/chunk-BPQ3VLAy.js +1 -0
  509. package/lib/ui/assets/chunk-BRH0KZbk.js +141 -0
  510. package/lib/ui/assets/chunk-BX6H_ySx.js +1 -0
  511. package/lib/ui/assets/chunk-B_P3UbPa.js +1 -0
  512. package/lib/ui/assets/chunk-B_TYUkTI.js +1 -0
  513. package/lib/ui/assets/chunk-B_vNuMnf.js +1 -0
  514. package/lib/ui/assets/chunk-BajyYBss.js +10 -0
  515. package/lib/ui/assets/chunk-BdnUsdx6.js +1 -0
  516. package/lib/ui/assets/chunk-Buea-lGh.js +1 -0
  517. package/lib/ui/assets/chunk-C0PvZCCE.js +1 -0
  518. package/lib/ui/assets/chunk-C0m74zRD.js +1 -0
  519. package/lib/ui/assets/chunk-C27-OAKa.js +1 -0
  520. package/lib/ui/assets/chunk-C2oV4EkX.js +1 -0
  521. package/lib/ui/assets/chunk-C7zT0LnQ.js +1 -0
  522. package/lib/ui/assets/chunk-C9GSunVT.js +1 -0
  523. package/lib/ui/assets/chunk-C9tS-k6U.js +1 -0
  524. package/lib/ui/assets/chunk-CHLpvVh8.js +1 -0
  525. package/lib/ui/assets/chunk-CLxacb5B.js +1 -0
  526. package/lib/ui/assets/chunk-COt5Ahok.js +1 -0
  527. package/lib/ui/assets/chunk-CPTIWCL2.js +1 -0
  528. package/lib/ui/assets/chunk-CQLl-L-p.js +1 -0
  529. package/lib/ui/assets/chunk-CUWRgxuq.js +55 -0
  530. package/lib/ui/assets/chunk-CWanVSXC.js +1 -0
  531. package/lib/ui/assets/chunk-Cf5RLm7j.js +1 -0
  532. package/lib/ui/assets/chunk-CickPsom.js +1 -0
  533. package/lib/ui/assets/chunk-Cj5Yp3dK.js +1 -0
  534. package/lib/ui/assets/chunk-Cmh6b_Ma.js +1 -0
  535. package/lib/ui/assets/chunk-Cp-IABpG.js +1 -0
  536. package/lib/ui/assets/chunk-CqE71os6.js +1 -0
  537. package/lib/ui/assets/chunk-CtKP3W-j.js +1 -0
  538. package/lib/ui/assets/chunk-Cvjx9yec.js +1 -0
  539. package/lib/ui/assets/chunk-CxGP3dtY.js +1 -0
  540. package/lib/ui/assets/chunk-CylS5w8V.js +1 -0
  541. package/lib/ui/assets/chunk-D38fbIBN.js +1 -0
  542. package/lib/ui/assets/chunk-D97Zzqfu.js +1 -0
  543. package/lib/ui/assets/chunk-DAi9KRSo.js +1 -0
  544. package/lib/ui/assets/chunk-DHK4yRfg.js +1 -0
  545. package/lib/ui/assets/chunk-DJeabLx-.js +1 -0
  546. package/lib/ui/assets/chunk-DNRxmY5a.js +1 -0
  547. package/lib/ui/assets/chunk-DNSN1z5r.js +1 -0
  548. package/lib/ui/assets/chunk-DNasK_ZG.js +1 -0
  549. package/lib/ui/assets/chunk-DPvrY3IQ.js +1 -0
  550. package/lib/ui/assets/chunk-DXmwc3jG.js +1 -0
  551. package/lib/ui/assets/chunk-Dd0kTxKP.js +1 -0
  552. package/lib/ui/assets/chunk-De0Btta0.js +1 -0
  553. package/lib/ui/assets/chunk-Des-eS-w.js +1 -0
  554. package/lib/ui/assets/chunk-Df6bDoY_.js +1 -0
  555. package/lib/ui/assets/chunk-DijEV5ha.js +1 -0
  556. package/lib/ui/assets/chunk-DkvoVjww.js +1 -0
  557. package/lib/ui/assets/chunk-DlC-OlHO.js +1 -0
  558. package/lib/ui/assets/chunk-DnzrXTVv.js +1 -0
  559. package/lib/ui/assets/chunk-Dualf0xi.js +1 -0
  560. package/lib/ui/assets/chunk-EXT84bkm.js +1 -0
  561. package/lib/ui/assets/chunk-GwR3hkPK.js +1 -0
  562. package/lib/ui/assets/chunk-P80f7IUj.js +1 -0
  563. package/lib/ui/assets/chunk-VOosw3JB.js +1 -0
  564. package/lib/ui/assets/chunk-YQ4lDkt_.js +140 -0
  565. package/lib/ui/assets/chunk-Yzrsuije.js +1 -0
  566. package/lib/ui/assets/chunk-Z72CF80r.js +1 -0
  567. package/lib/ui/assets/chunk-g9-lgVsj.js +1 -0
  568. package/lib/ui/assets/chunk-vGWfd6FD.js +1 -0
  569. package/lib/ui/assets/chunk-wDzz0qaB.js +1 -0
  570. package/lib/ui/assets/chunk-ySF7HWmS.js +1 -0
  571. package/lib/ui/assets/icon.png +0 -0
  572. package/lib/ui/assets/index.html +14 -0
  573. package/lib/ui/assets/pdf.worker.min-CjEcRF4W.mjs +28 -0
  574. package/lib/ui/assets/style-Bq01xH_b.css +1 -0
  575. package/lib/ui/frames.d.ts +67 -0
  576. package/lib/ui/frames.js +146 -0
  577. package/lib/ui/index.d.ts +59 -0
  578. package/lib/ui/index.js +50 -0
  579. package/lib/ui/manifest.d.ts +172 -0
  580. package/lib/ui/manifest.js +158 -0
  581. package/lib/ui/plugin.d.ts +161 -0
  582. package/lib/ui/plugin.js +7 -0
  583. package/lib/ui/plugins/browser/client.js +290 -0
  584. package/lib/ui/plugins/browser/icon.png +0 -0
  585. package/lib/ui/plugins/composer/client.js +1843 -0
  586. package/lib/ui/plugins/composer/icon.png +0 -0
  587. package/lib/ui/plugins/files/client.js +646 -0
  588. package/lib/ui/plugins/files/icon.png +0 -0
  589. package/lib/ui/plugins/manifest.json +107 -0
  590. package/lib/ui/plugins/plugins/client.js +682 -0
  591. package/lib/ui/plugins/plugins/icon.png +0 -0
  592. package/lib/ui/plugins/preview/client.js +197 -0
  593. package/lib/ui/plugins/preview/icon.png +0 -0
  594. package/lib/ui/plugins/prompt/client.js +653 -0
  595. package/lib/ui/plugins/prompt/icon.png +0 -0
  596. package/lib/ui/plugins/sessions/client.js +1577 -0
  597. package/lib/ui/plugins/sessions/icon.png +0 -0
  598. package/lib/ui/plugins/settings/client.js +5470 -0
  599. package/lib/ui/plugins/settings/icon.png +0 -0
  600. package/lib/ui/plugins/skills/client.js +485 -0
  601. package/lib/ui/plugins/skills/icon.png +0 -0
  602. package/lib/ui/plugins/status/client.js +1420 -0
  603. package/lib/ui/plugins/status/icon.png +0 -0
  604. package/lib/ui/plugins/statusbar/client.js +504 -0
  605. package/lib/ui/plugins/statusbar/icon.png +0 -0
  606. package/lib/ui/plugins/tasks/client.js +52 -0
  607. package/lib/ui/plugins/tasks/icon.png +0 -0
  608. package/lib/ui/plugins/team/client.js +527 -0
  609. package/lib/ui/plugins/team/icon.png +0 -0
  610. package/lib/ui/plugins/terminal/client.js +232 -0
  611. package/lib/ui/plugins/terminal/icon.png +0 -0
  612. package/lib/ui/plugins/trace/client.js +1376 -0
  613. package/lib/ui/plugins/trace/icon.png +0 -0
  614. package/lib/ui/plugins/transcript/client.js +2661 -0
  615. package/lib/ui/plugins/transcript/icon.png +0 -0
  616. package/lib/ui/scoped-slots.d.ts +20 -0
  617. package/lib/ui/scoped-slots.js +21 -0
  618. package/lib/ui/sdk/@dsc/ui/index.d.ts +242 -0
  619. package/lib/ui/sdk/@dsc/ui/package.json +16 -0
  620. package/lib/ui/sdk/@dsc/ui-core/contract.d.ts +1973 -0
  621. package/lib/ui/sdk/@dsc/ui-core/core/diff-text.d.ts +74 -0
  622. package/lib/ui/sdk/@dsc/ui-core/core/dock-browser.d.ts +137 -0
  623. package/lib/ui/sdk/@dsc/ui-core/core/dock-ops.d.ts +59 -0
  624. package/lib/ui/sdk/@dsc/ui-core/core/model-caps.d.ts +83 -0
  625. package/lib/ui/sdk/@dsc/ui-core/core/native-bridge.d.ts +135 -0
  626. package/lib/ui/sdk/@dsc/ui-core/core/token-estimate.d.ts +55 -0
  627. package/lib/ui/sdk/@dsc/ui-core/package.json +16 -0
  628. package/lib/ui/sdk/@dsc/ui-core/ui/arrival.d.ts +72 -0
  629. package/lib/ui/sdk/@dsc/ui-core/ui/frames.d.ts +67 -0
  630. package/lib/ui/sdk/@dsc/ui-core/ui/index.d.ts +59 -0
  631. package/lib/ui/sdk/@dsc/ui-core/ui/manifest.d.ts +172 -0
  632. package/lib/ui/sdk/@dsc/ui-core/ui/plugin.d.ts +161 -0
  633. package/lib/ui/sdk/@dsc/ui-core/ui/scoped-slots.d.ts +20 -0
  634. package/lib/ui/sdk/@dsc/ui-core/ui/services-react.d.ts +27 -0
  635. package/lib/ui/sdk/@dsc/ui-core/ui/services.d.ts +63 -0
  636. package/lib/ui/sdk/@dsc/ui-core/ui/slots-react.d.ts +28 -0
  637. package/lib/ui/sdk/@dsc/ui-core/ui/slots.d.ts +481 -0
  638. package/lib/ui/sdk/@dsc/ui-core/ui/store.d.ts +89 -0
  639. package/lib/ui/sdk/@dsc/ui-dockkit/dock-model.d.ts +238 -0
  640. package/lib/ui/sdk/@dsc/ui-dockkit/dock-state.d.ts +163 -0
  641. package/lib/ui/sdk/@dsc/ui-dockkit/dock.d.ts +24 -0
  642. package/lib/ui/sdk/@dsc/ui-dockkit/index.d.ts +15 -0
  643. package/lib/ui/sdk/@dsc/ui-dockkit/package.json +16 -0
  644. package/lib/ui/sdk/@dsc/ui-layout/app.d.ts +74 -0
  645. package/lib/ui/sdk/@dsc/ui-layout/appearance.d.ts +70 -0
  646. package/lib/ui/sdk/@dsc/ui-layout/host-channel.d.ts +112 -0
  647. package/lib/ui/sdk/@dsc/ui-layout/index.d.ts +34 -0
  648. package/lib/ui/sdk/@dsc/ui-layout/package.json +16 -0
  649. package/lib/ui/sdk/@dsc/ui-layout/page-state.d.ts +14 -0
  650. package/lib/ui/sdk/@dsc/ui-layout/review-pane.d.ts +21 -0
  651. package/lib/ui/sdk/@dsc/ui-layout/runtime-context.d.ts +44 -0
  652. package/lib/ui/sdk/@dsc/ui-layout/thread-view.d.ts +28 -0
  653. package/lib/ui/sdk/@dsc/ui-layout/update-button.d.ts +21 -0
  654. package/lib/ui/sdk/@dsc/ui-primitives/code-file-icon-artwork.d.ts +53 -0
  655. package/lib/ui/sdk/@dsc/ui-primitives/code-view.d.ts +15 -0
  656. package/lib/ui/sdk/@dsc/ui-primitives/compat.d.ts +27 -0
  657. package/lib/ui/sdk/@dsc/ui-primitives/completion-sound.d.ts +24 -0
  658. package/lib/ui/sdk/@dsc/ui-primitives/confirm.d.ts +33 -0
  659. package/lib/ui/sdk/@dsc/ui-primitives/css.d.ts +47 -0
  660. package/lib/ui/sdk/@dsc/ui-primitives/diff-rows.d.ts +20 -0
  661. package/lib/ui/sdk/@dsc/ui-primitives/file-icons.d.ts +38 -0
  662. package/lib/ui/sdk/@dsc/ui-primitives/file-type-classify.d.ts +66 -0
  663. package/lib/ui/sdk/@dsc/ui-primitives/file-type-icon.d.ts +57 -0
  664. package/lib/ui/sdk/@dsc/ui-primitives/highlight.d.ts +24 -0
  665. package/lib/ui/sdk/@dsc/ui-primitives/hover-delay.d.ts +17 -0
  666. package/lib/ui/sdk/@dsc/ui-primitives/icons.d.ts +109 -0
  667. package/lib/ui/sdk/@dsc/ui-primitives/index.d.ts +55 -0
  668. package/lib/ui/sdk/@dsc/ui-primitives/lang-table.d.ts +10 -0
  669. package/lib/ui/sdk/@dsc/ui-primitives/markdown.d.ts +20 -0
  670. package/lib/ui/sdk/@dsc/ui-primitives/native.d.ts +41 -0
  671. package/lib/ui/sdk/@dsc/ui-primitives/package.json +16 -0
  672. package/lib/ui/sdk/@dsc/ui-primitives/panels.d.ts +86 -0
  673. package/lib/ui/sdk/@dsc/ui-primitives/paths.d.ts +11 -0
  674. package/lib/ui/sdk/@dsc/ui-primitives/pdf-view.d.ts +13 -0
  675. package/lib/ui/sdk/@dsc/ui-primitives/plugin-text.d.ts +15 -0
  676. package/lib/ui/sdk/@dsc/ui-primitives/select.d.ts +35 -0
  677. package/lib/ui/sdk/@dsc/ui-primitives/table-view.d.ts +23 -0
  678. package/lib/ui/sdk/@dsc/ui-primitives/thread-resizer.d.ts +22 -0
  679. package/lib/ui/sdk/@dsc/ui-primitives/time.d.ts +33 -0
  680. package/lib/ui/sdk/@dsc/ui-primitives/toast.d.ts +16 -0
  681. package/lib/ui/sdk/@dsc/ui-primitives/tokens.d.ts +14 -0
  682. package/lib/ui/sdk/@dsc/ui-primitives/tool-args.d.ts +49 -0
  683. package/lib/ui/sdk/@dsc/ui-primitives/tool-summary.d.ts +64 -0
  684. package/lib/ui/sdk/@dsc/ui-renderer/boot.d.ts +121 -0
  685. package/lib/ui/sdk/@dsc/ui-renderer/hmr.d.ts +43 -0
  686. package/lib/ui/sdk/@dsc/ui-renderer/index.d.ts +20 -0
  687. package/lib/ui/sdk/@dsc/ui-renderer/package.json +16 -0
  688. package/lib/ui/sdk/@dsc/ui-slots/index.d.ts +19 -0
  689. package/lib/ui/sdk/@dsc/ui-slots/package.json +16 -0
  690. package/lib/ui/sdk/@dsc/ui-slots/slots-react.d.ts +48 -0
  691. package/lib/ui/sdk/@dsc/ui-slots/slots.d.ts +102 -0
  692. package/lib/ui/services-react.d.ts +27 -0
  693. package/lib/ui/services-react.js +32 -0
  694. package/lib/ui/services.d.ts +63 -0
  695. package/lib/ui/services.js +121 -0
  696. package/lib/ui/slots-ink.d.ts +26 -0
  697. package/lib/ui/slots-ink.js +78 -0
  698. package/lib/ui/slots-react.d.ts +28 -0
  699. package/lib/ui/slots-react.js +88 -0
  700. package/lib/ui/slots.d.ts +481 -0
  701. package/lib/ui/slots.js +550 -0
  702. package/lib/ui/store.d.ts +89 -0
  703. package/lib/ui/store.js +62 -0
  704. package/lib/ui/tui-plugin-api.d.ts +23 -0
  705. package/lib/ui/tui-plugin-api.js +23 -0
  706. package/lib/ui/tui-plugins.d.ts +47 -0
  707. package/lib/ui/tui-plugins.js +220 -0
  708. package/package.json +58 -6
@@ -0,0 +1,830 @@
1
+ /**
2
+ * 界面插件包的发现与取字节(宿主半边)。
3
+ *
4
+ * 谁产出这些文件:界面壳的构建(`ui-shell/`)把插件 bundle 写进
5
+ * `lib/ui/plugins/<id>/client.js`,并同时写一份 `manifest.json` 说明有哪些、
6
+ * 依赖谁。宿主只认这份清单——**产物版本由宿主自己读字节算内容摘要**,不信构建时写下的值,
7
+ * 这样插件文件被换掉(重新构建、手工替换)时地址跟着变,浏览器缓存不会骗人;
8
+ * 而字节没变的重写(构建的增量写盘、touch 文件)不会换地址,HMR 才不会全量换装。
9
+ *
10
+ * 外部插件(第三方的界面半边)走同一份清单:将来它们由插件安装流程写进同一个目录,
11
+ * 这里不用分内置还是第三方,只认文件在不在。第三方插件是真 npm 包,包名是
12
+ * `@scope/name` 形状,所以 id 放开了 `/`;落盘一侧的路径围栏(`inside()`)照旧兜底。
13
+ *
14
+ * 三件事在这里定:
15
+ *
16
+ * 1. **清单的失败方向**:不认识的载体(`platform`)一律**丢弃并记进 problems**,不猜也不
17
+ * 当 web 发出去——把一份给别的壳写的 bundle 塞进浏览器,表现是界面里某个插件"莫名报错",
18
+ * 比当场少一个插件难查得多。合法项的字段(`inject` / `external` / `file` / `id`)写坏了
19
+ * 同样记 problems,不静默跳过。
20
+ * 2. **产物表缓存**:`manifest.json` 的 mtime+size 是这张表的钥匙,没换就不重算,于是
21
+ * N 个 bundle 请求不再是 O(N²) 次 stat(原来每次请求都要读清单 + 逐个 stat 全目录)。
22
+ * 页面每次加载与 `refresh()` 走 `force`,手工换掉文件也能立刻反映。
23
+ * 3. **上一代响应表**:插件重建后,**已经打开、还没刷新的页面**手上还是旧 `?rev=` 地址,
24
+ * 它的下一次请求必须还能拿到旧字节(内容寻址的地址,旧地址就该给旧内容),
25
+ * 否则那个插件当场加载失败,用户只能手动刷新。所以换代时把旧 rev 与它的字节留下来
26
+ * (只留一代,与参考实现同口径)。
27
+ *
28
+ * @module dsc/core/ui-bundles
29
+ */
30
+ import { readFileSync, statSync } from 'node:fs';
31
+ import { createHash } from 'node:crypto';
32
+ import { dirname, resolve } from 'node:path';
33
+ import { fileURLToPath } from 'node:url';
34
+ import { satisfies, validRange } from 'semver';
35
+ import { inside } from './web-static.js';
36
+ /** 清单文件名(界面壳构建时写在插件目录根部)。 */
37
+ export const UI_PLUGIN_MANIFEST = 'manifest.json';
38
+ /**
39
+ * 认得的载体取值:`UiPlatform` 的那两个,一字不差。
40
+ * 不在这张表里的值(写错、或将来别的壳)一律丢弃并记问题——失败关闭。
41
+ */
42
+ const KNOWN_PLATFORMS = new Set(['web', 'tui']);
43
+ /**
44
+ * id 的合法形状:npm 包名(可带 `@scope/` 前缀),每个 `/` 分隔的段都字母数字起步,
45
+ * 段内允许 `.` `_` `-`。
46
+ *
47
+ * 为什么放开 `/`:第三方界面插件就是 npm 包,`@scope/name` 是它的真名,禁掉 `/` 它们进不来。
48
+ * 为什么放开之后仍然安全:每段必须**字母数字起步**,于是 `..`、`.`(段以点开头)、
49
+ * 绝对路径(段以 `/` 开头)、`-flag` 这类形状都不成形;真正的围栏还有两处——
50
+ * `readUiPluginBundle` 与 `collectUiPluginArtifacts` 里的 `inside()` 会再确认拼出来的
51
+ * 路径没跑出插件目录。
52
+ */
53
+ const ID_SEGMENT = '[A-Za-z0-9][A-Za-z0-9._-]*';
54
+ const PLUGIN_ID = new RegExp(`^(?:@${ID_SEGMENT}/)?${ID_SEGMENT}(?:/${ID_SEGMENT})*$`);
55
+ /** 界面壳的静态产物目录(编译产物是 `lib/core/ui-bundles.js`,往上一级就是 `lib/ui`)。 */
56
+ export function uiAssetsDir() {
57
+ return resolve(dirname(fileURLToPath(import.meta.url)), '..', 'ui', 'assets');
58
+ }
59
+ /**
60
+ * 内置 bundle 的 rev:**内容摘要**(sha256 前 12 位,与短哈希的形状一致)。
61
+ *
62
+ * 为什么不是文件指纹(mtime/ctime/size):构建每轮都会重写产物,mtime 全变 → 只改一个插件
63
+ * 也会让全部 rev 变 → HMR 会把 16 个插件一起换装(React 状态全丢)。内容摘要让 rev 成为
64
+ * 真正的「地址即内容」:字节没变地址就不变,换代只剩真实变更。
65
+ *
66
+ * 为什么 12 位:地址形状与既有探针(`[0-9a-f]{12}`)从 mtime 指纹时代就定成 12 位;
67
+ * 第三方条目保持 16 位(既有约定不动)。两者语义相同,只是截断长度不同。
68
+ */
69
+ function builtinContentRev(bytes) {
70
+ return createHash('sha256').update(bytes).digest('hex').slice(0, 12);
71
+ }
72
+ /** 插件 bundle 目录。 */
73
+ export function uiPluginsDir() {
74
+ return resolve(dirname(fileURLToPath(import.meta.url)), '..', 'ui', 'plugins');
75
+ }
76
+ /** 读一个第三方 bundle 的字节(`<root>/<id>/ui/client.js`;不存在给 null)。 */
77
+ export function readThirdPartyUiPluginBundle(id, dir = thirdPartyUiRoot()) {
78
+ if (!PLUGIN_ID.test(id))
79
+ return null;
80
+ const path = resolve(dir, id, 'ui', 'client.js');
81
+ if (!inside(dir, path))
82
+ return null;
83
+ try {
84
+ return readFileSync(path);
85
+ }
86
+ catch {
87
+ return null;
88
+ }
89
+ }
90
+ /**
91
+ * API 门禁(阶段 7):判断一个插件条目能不能对着「当前壳的 `@dsc/ui` 契约版本」加载。
92
+ * 通过给 `null`;拒绝给一句**给人看的原因**(进 problems,界面诊断区原样画出来)。
93
+ *
94
+ * 规则(对齐 ui-plugin-parity-plan §5.1 拍板的六条):
95
+ * - 内置清单(顶层带 `apiVersion`,即构建产物)的条目没写 `api` 视为与壳同源,放行;
96
+ * - 第三方清单(没有 `apiVersion`)的条目**必须**声明区间,缺失即拒(失败关闭);
97
+ * - `workspace:` 前缀与解析不了的区间直接拒——请写具体版本区间,不做「等于当前」的猜法;
98
+ * - `satisfies(壳版本, 区间)` 不满足(含预发布版)即拒。
99
+ */
100
+ export function evaluateUiApiGate(api, apiVersion) {
101
+ if (apiVersion === undefined) {
102
+ if (api === undefined) {
103
+ return null; // 兼容旧清单(尚无 apiVersion 的构建产物):没有声明依据,不拦
104
+ }
105
+ return matchGate(api, '(清单未声明 apiVersion)');
106
+ }
107
+ if (api === undefined)
108
+ return null; // 内置条目:与壳同源
109
+ return matchGate(api, apiVersion);
110
+ }
111
+ /** 拿插件的声明区间对壳版本判一次;给拒绝理由或 null。 */
112
+ function matchGate(api, shellVersion) {
113
+ if (api.startsWith('workspace:')) {
114
+ return `插件声明的 api 区间是「${api}」——请写具体的 semver 区间(如 ^1.0.0),这里不做「等于当前」的猜法`;
115
+ }
116
+ const range = validRange(api);
117
+ if (range === null) {
118
+ return `插件声明的 api 区间「${api}」不是合法的 semver 区间(要像 ^1.0.0 / 1.x 这样)`;
119
+ }
120
+ if (!satisfies(shellVersion, range, { includePrerelease: true })) {
121
+ return `插件要求 @dsc/ui ${api},当前壳 ${shellVersion},已跳过加载`;
122
+ }
123
+ return null;
124
+ }
125
+ /**
126
+ * 读插件清单,并把所有被丢掉的行/字段记成问题。
127
+ *
128
+ * 文件缺失/整个 JSON 坏掉一律按空处理(界面壳还没构建就是这样,与 remote 的
129
+ * "资产未构建"占位页同一套待遇:能起来,但没有插件);但**坏掉的清单要说话**,
130
+ * 不然"插件怎么不见了"只能靠猜。
131
+ */
132
+ export function readUiPluginManifestReport(dir = uiPluginsDir()) {
133
+ const entries = [];
134
+ const problems = [];
135
+ let text;
136
+ try {
137
+ text = readFileSync(resolve(dir, UI_PLUGIN_MANIFEST), 'utf8');
138
+ }
139
+ catch {
140
+ return { entries, problems };
141
+ }
142
+ let doc;
143
+ try {
144
+ doc = JSON.parse(text);
145
+ }
146
+ catch (error) {
147
+ problems.push(`${UI_PLUGIN_MANIFEST}: 不是合法 JSON(${error instanceof Error ? error.message : String(error)}),整份清单作废`);
148
+ return { entries, problems };
149
+ }
150
+ const plugins = doc.plugins;
151
+ if (!Array.isArray(plugins)) {
152
+ problems.push(`${UI_PLUGIN_MANIFEST}: 顶层没有 plugins 数组,整份清单作废`);
153
+ return { entries, problems };
154
+ }
155
+ // 顶层 apiVersion:构建产物写下「这份清单对着哪个 @dsc/ui 版本」。有它 = 内置清单,
156
+ // 条目无需逐条声明 api;没有(第三方清单)则条目必须逐条带 api(门禁见 evaluateUiApiGate)。
157
+ const rawApiVersion = doc.apiVersion;
158
+ const apiVersion = typeof rawApiVersion === 'string' && rawApiVersion.trim() !== '' ? rawApiVersion.trim() : undefined;
159
+ if (rawApiVersion !== undefined && apiVersion === undefined) {
160
+ problems.push(`${UI_PLUGIN_MANIFEST}: 顶层 apiVersion 不是非空字符串(${JSON.stringify(rawApiVersion)}),当没写处理`);
161
+ }
162
+ for (let index = 0; index < plugins.length; index += 1) {
163
+ const raw = plugins[index];
164
+ const where = `${UI_PLUGIN_MANIFEST} 第 ${String(index + 1)} 条`;
165
+ if (raw === null || typeof raw !== 'object' || Array.isArray(raw)) {
166
+ problems.push(`${where}: 不是对象,丢弃`);
167
+ continue;
168
+ }
169
+ const record = raw;
170
+ const id = typeof record['id'] === 'string' ? record['id'] : '';
171
+ const file = typeof record['file'] === 'string' ? record['file'] : '';
172
+ if (!PLUGIN_ID.test(id)) {
173
+ problems.push(`${where}: id 不成形(${JSON.stringify(record['id'])}),丢弃`);
174
+ continue;
175
+ }
176
+ if (file === '' || file.includes('/') || file.includes('\\')) {
177
+ problems.push(`${id}: 文件名不成形(${JSON.stringify(record['file'])}),丢弃`);
178
+ continue;
179
+ }
180
+ // 载体:认识的只有 web / tui 两个取值;别的(写错、或别的壳的取值)不当客户端行。
181
+ const platform = record['platform'];
182
+ if (platform !== undefined && (typeof platform !== 'string' || !KNOWN_PLATFORMS.has(platform))) {
183
+ problems.push(`${id}: 载体(platform)不认识(${JSON.stringify(platform)}),丢弃`);
184
+ continue;
185
+ }
186
+ const inject = readNameList(record['inject'], id, 'inject', problems);
187
+ const external = readNameList(record['external'], id, 'external', problems);
188
+ // api:插件声明的 @dsc/ui 区间(第三方必需;形状校验放门禁判定,这里只管类型)。
189
+ const rawApi = record['api'];
190
+ const api = typeof rawApi === 'string' && rawApi.trim() !== '' ? rawApi.trim() : undefined;
191
+ if (rawApi !== undefined && api === undefined) {
192
+ problems.push(`${id}: api 不是非空字符串(${JSON.stringify(rawApi)}),当没声明处理`);
193
+ }
194
+ // phase:调度档位。坏值记问题并**当没声明**(按 application),方向与 api 一致——
195
+ // 一个拼错的 phase 不该让整个插件消失,但也不能静默当 early 发出去。
196
+ const rawPhase = record['phase'];
197
+ const phase = rawPhase === 'early' || rawPhase === 'application' ? rawPhase : undefined;
198
+ if (rawPhase !== undefined && phase === undefined) {
199
+ problems.push(`${id}: phase 只能是 'early' / 'application'(${JSON.stringify(rawPhase)}),当没声明处理`);
200
+ }
201
+ entries.push({
202
+ id,
203
+ file,
204
+ ...(inject === undefined ? {} : { inject }),
205
+ ...(external === undefined ? {} : { external }),
206
+ ...(record['immediately'] === true ? { immediately: true } : {}),
207
+ ...(phase === undefined ? {} : { phase }),
208
+ ...(api === undefined ? {} : { api }),
209
+ ...(platform === undefined ? {} : { platform: platform }),
210
+ });
211
+ }
212
+ return { entries, problems, ...(apiVersion === undefined ? {} : { apiVersion }) };
213
+ }
214
+ /**
215
+ * 读一个字符串数组字段(`inject` / `external`)。
216
+ *
217
+ * 字段整个没写 → undefined("没声明",与空数组分开);
218
+ * 字段不是数组 → 记问题,当没声明;
219
+ * 数组里混了非字符串 → 记问题,**留下合法的那些**:字段写坏是字段的错,不该让整个插件消失。
220
+ */
221
+ function readNameList(value, id, field, problems) {
222
+ if (value === undefined)
223
+ return undefined;
224
+ if (!Array.isArray(value)) {
225
+ problems.push(`${id}: ${field} 不是数组(${JSON.stringify(value)}),当没声明处理`);
226
+ return undefined;
227
+ }
228
+ const out = [];
229
+ for (const item of value) {
230
+ if (typeof item === 'string' && item !== '')
231
+ out.push(item);
232
+ else
233
+ problems.push(`${id}: ${field} 里有非字符串项(${JSON.stringify(item)}),已丢弃`);
234
+ }
235
+ return out;
236
+ }
237
+ /** 读清单(只要条目;问题记录见 `readUiPluginManifestReport`)。 */
238
+ export function readUiPluginManifest(dir = uiPluginsDir()) {
239
+ return readUiPluginManifestReport(dir).entries;
240
+ }
241
+ /** 定位一条缓存用的键(id 与文件名都可能含 `.` `-`,用不会出现的 NUL 分隔)。 */
242
+ function cacheKey(id, file) {
243
+ return `${id}\u0000${file}`;
244
+ }
245
+ /** 诊断计数(测试与排障用,不参与业务判断)。 */
246
+ const CACHE_COUNTERS = { manifestStats: 0, fileStats: 0, tableBuilds: 0 };
247
+ /** 读一次诊断计数(副本,改不动内部)。 */
248
+ export function uiArtifactCacheCounters() {
249
+ return { ...CACHE_COUNTERS };
250
+ }
251
+ /** 清零诊断计数(测试用)。 */
252
+ export function resetUiArtifactCacheCounters() {
253
+ CACHE_COUNTERS.manifestStats = 0;
254
+ CACHE_COUNTERS.fileStats = 0;
255
+ CACHE_COUNTERS.tableBuilds = 0;
256
+ }
257
+ /**
258
+ * 一个插件目录的产物表 + 上一代表 + 字节缓存。
259
+ *
260
+ * 为什么要缓存:`manifest.json` 加逐文件 stat 原来是**每个 bundle 请求**都跑一遍,
261
+ * 页面上 N 个插件就是 O(N²) 次同步 stat,全发生在请求路径上、阻塞事件循环。
262
+ * 现在钥匙是清单的 mtime+size:清单没换就直接用表,请求路径上只剩一次清单 stat。
263
+ */
264
+ class UiArtifactCache {
265
+ dir;
266
+ platform;
267
+ /** 上一次建表时的清单指纹;null = 还没建过。 */
268
+ manifestKey = null;
269
+ entries = [];
270
+ problems = [];
271
+ apiVersion = undefined;
272
+ byKey = new Map();
273
+ /** `${id}\0${file}\0${rev}` → 字节(服务过一次才在)。 */
274
+ bytes = new Map();
275
+ /** `${id}\0${file}` → 上一代(重建换掉的那一代)。 */
276
+ previous = new Map();
277
+ constructor(dir, platform) {
278
+ this.dir = dir;
279
+ this.platform = platform;
280
+ }
281
+ /** 现在的清单指纹;清单还没有(没构建)也是指纹的一种取值。 */
282
+ fingerprint() {
283
+ CACHE_COUNTERS.manifestStats += 1;
284
+ try {
285
+ const stat = statSync(resolve(this.dir, UI_PLUGIN_MANIFEST));
286
+ return `${String(Math.trunc(stat.mtimeMs))}:${String(stat.size)}`;
287
+ }
288
+ catch {
289
+ return 'missing';
290
+ }
291
+ }
292
+ /** 建表(读清单 + 逐文件算版本)。清单没换且没要求强制,就直接返回。 */
293
+ rebuild(force) {
294
+ const fingerprint = this.fingerprint();
295
+ if (!force && this.manifestKey === fingerprint)
296
+ return;
297
+ CACHE_COUNTERS.tableBuilds += 1;
298
+ const report = readUiPluginManifestReport(this.dir);
299
+ const problems = [...report.problems];
300
+ const nextByKey = new Map();
301
+ /** 建表时读出来的字节:这一代顺手留在缓存里,第一次请求不再读盘。 */
302
+ const nextBytes = new Map();
303
+ for (const entry of report.entries) {
304
+ if ((entry.platform ?? 'web') !== this.platform)
305
+ continue;
306
+ // API 门禁(阶段 7):插件声明的 @dsc/ui 区间对不上这份清单的契约版本就不进产物表,
307
+ // 原因写进 problems——「不匹配就不进启动图,壳只负责把原因画出来」。带上 id:
308
+ // 多个插件被拒时诊断区要能对上号。
309
+ const denied = evaluateUiApiGate(entry.api, report.apiVersion);
310
+ if (denied !== null) {
311
+ problems.push(`${entry.id}: ${denied}`);
312
+ continue;
313
+ }
314
+ const path = resolve(this.dir, entry.id, entry.file);
315
+ if (!inside(this.dir, path)) {
316
+ problems.push(`${entry.id}: 文件跑到目录外了(${entry.file})`);
317
+ continue;
318
+ }
319
+ try {
320
+ // rev = 内容摘要(读字节算),不是 stat 指纹:构建重写但字节没变时 rev 不变。
321
+ CACHE_COUNTERS.fileStats += 1;
322
+ const bytes = readFileSync(path);
323
+ const rev = builtinContentRev(bytes);
324
+ nextByKey.set(cacheKey(entry.id, entry.file), { row: { ...entry, rev }, size: bytes.length });
325
+ nextBytes.set(`${cacheKey(entry.id, entry.file)}\u0000${rev}`, bytes);
326
+ }
327
+ catch {
328
+ problems.push(`${entry.id}: 读不到 ${entry.file}(界面壳构建过了吗)`);
329
+ }
330
+ }
331
+ // 换代:这一代变了或被删掉的,整条挪进上一代表(旧窗口可能还拿着它的地址)。
332
+ // 没变的保持原样——上一代仍然是最早那一代,别把它顶掉。
333
+ const nextPrevious = new Map();
334
+ for (const [key, cached] of this.byKey) {
335
+ const fresh = nextByKey.get(key);
336
+ if (fresh !== undefined && fresh.row.rev === cached.row.rev) {
337
+ const kept = this.previous.get(key);
338
+ if (kept !== undefined)
339
+ nextPrevious.set(key, kept);
340
+ continue;
341
+ }
342
+ nextPrevious.set(key, { rev: cached.row.rev, size: cached.size });
343
+ }
344
+ // 字节缓存只留"当下这一代 + 上一代"用得着的,别让它随重建无限长大。
345
+ const keep = new Set();
346
+ for (const [key, cached] of nextByKey)
347
+ keep.add(`${key}\u0000${cached.row.rev}`);
348
+ for (const [key, generation] of nextPrevious)
349
+ keep.add(`${key}\u0000${generation.rev}`);
350
+ for (const key of [...this.bytes.keys()]) {
351
+ if (!keep.has(key))
352
+ this.bytes.delete(key);
353
+ }
354
+ this.manifestKey = fingerprint;
355
+ this.entries = [...nextByKey.values()].map((cached) => cached.row);
356
+ this.problems = problems;
357
+ this.apiVersion = report.apiVersion;
358
+ this.byKey.clear();
359
+ for (const [key, cached] of nextByKey)
360
+ this.byKey.set(key, cached);
361
+ this.previous.clear();
362
+ for (const [key, generation] of nextPrevious)
363
+ this.previous.set(key, generation);
364
+ // 内容摘要 rev 是建表时读出来的:把这一代的字节留在内存里,第一次请求直接给。
365
+ for (const [key, bytes] of nextBytes) {
366
+ if (!this.bytes.has(key))
367
+ this.bytes.set(key, bytes);
368
+ }
369
+ }
370
+ /** 现在的产物表(清单没换就不重算)。 */
371
+ table() {
372
+ this.rebuild(false);
373
+ return { entries: [...this.entries], problems: [...this.problems], ...(this.apiVersion === undefined ? {} : { apiVersion: this.apiVersion }) };
374
+ }
375
+ /** 强制重算(页面每次加载、`refresh()` 用:文件被手工换掉也立刻反映)。 */
376
+ refresh() {
377
+ this.rebuild(true);
378
+ return { entries: [...this.entries], problems: [...this.problems], ...(this.apiVersion === undefined ? {} : { apiVersion: this.apiVersion }) };
379
+ }
380
+ /**
381
+ * 按 id + 文件名 + 版本取字节。
382
+ *
383
+ * @param wantBody - false(HEAD)时不读盘:长度从 stat 来,头照给、体不给。
384
+ */
385
+ lookup(id, file, rev, wantBody) {
386
+ this.rebuild(false);
387
+ const key = cacheKey(id, file);
388
+ const current = this.byKey.get(key);
389
+ if (current !== undefined && current.row.rev === rev) {
390
+ const body = wantBody ? this.readBytes(key, id, file, rev) : null;
391
+ return { known: true, current: true, previous: false, size: current.size, body };
392
+ }
393
+ const generation = this.previous.get(key);
394
+ if (generation !== undefined && generation.rev === rev) {
395
+ // 旧代只在当初服务过时才有字节(已经打开的页面必然取过一次,所以这条路走得通)。
396
+ return {
397
+ known: true,
398
+ current: false,
399
+ previous: true,
400
+ size: generation.size,
401
+ body: wantBody ? (this.bytes.get(`${key}\u0000${rev}`) ?? null) : null,
402
+ };
403
+ }
404
+ return { known: current !== undefined || generation !== undefined, current: false, previous: false, size: null, body: null };
405
+ }
406
+ /** 读当前代的字节(读过就留在内存里,下一次直接给)。 */
407
+ readBytes(key, id, file, rev) {
408
+ const cacheKeyText = `${key}\u0000${rev}`;
409
+ const hit = this.bytes.get(cacheKeyText);
410
+ if (hit !== undefined)
411
+ return hit;
412
+ const body = readUiPluginBundle(id, file, this.dir);
413
+ if (body !== null)
414
+ this.bytes.set(cacheKeyText, body);
415
+ return body;
416
+ }
417
+ }
418
+ /** 目录 + 载体 → 缓存(模块级:本机界面服务与远程控制共用同一份产物视图)。 */
419
+ const CACHES = new Map();
420
+ /** 取某个插件目录的产物缓存。 */
421
+ export function uiArtifactCache(dir, platform = 'web') {
422
+ const absolute = resolve(dir);
423
+ const key = `${absolute}\u0000${platform}`;
424
+ const existing = CACHES.get(key);
425
+ if (existing !== undefined)
426
+ return existing;
427
+ const created = new UiArtifactCache(absolute, platform);
428
+ CACHES.set(key, created);
429
+ return created;
430
+ }
431
+ /**
432
+ * 清单 + 文件现状 = 可下发的条目。缺文件的不进清单,但要单独报出来。
433
+ *
434
+ * @param dir - 插件目录,缺省 `lib/ui/plugins`
435
+ * @param platform - 只取这个载体的插件(浏览器壳要 web,TUI 壳要 tui)
436
+ * @param options - `force: true` 时无视清单指纹重算(页面加载与 refresh 用)
437
+ */
438
+ export function collectUiPluginArtifacts(dir = uiPluginsDir(), platform = 'web', options = {}) {
439
+ const cache = uiArtifactCache(dir, platform);
440
+ return options.force === true ? cache.refresh() : cache.table();
441
+ }
442
+ /**
443
+ * 按内容寻址的地址取字节(含上一代)。
444
+ *
445
+ * @param wantBody - HEAD 请求传 false:只问长度,不读盘
446
+ */
447
+ export function lookupUiPluginBundle(id, file, rev, dir = uiPluginsDir(), wantBody = true) {
448
+ return uiArtifactCache(dir, 'web').lookup(id, file, rev, wantBody);
449
+ }
450
+ /** 取一个插件的 bundle 字节;不存在给 null。 */
451
+ export function readUiPluginBundle(id, file, dir = uiPluginsDir()) {
452
+ if (!PLUGIN_ID.test(id))
453
+ return null;
454
+ const path = resolve(dir, id, file);
455
+ if (!inside(dir, path))
456
+ return null;
457
+ try {
458
+ return readFileSync(path);
459
+ }
460
+ catch {
461
+ return null;
462
+ }
463
+ }
464
+ // ── 第三方界面插件(阶段 7)────────────────────────────────────────────────────
465
+ //
466
+ // 住 `~/.dsc/plugins/<目录名>/`:`ui/client.js` 是界面半边,`plugin.json` 声明
467
+ // `api`(必填,@dsc/ui 区间)与可选的 `platforms`。发现、启停(plugins.json 的
468
+ // entries,键 `<目录名>/ui/client.js`)、信任(plugins.json 顶层 `uiTrust`)与
469
+ // 内置插件合成为同一张产物表——「不用分内置还是第三方,只认文件在不在」。
470
+ import { readdirSync } from 'node:fs';
471
+ import { dscPath } from './path-policy.js';
472
+ import { isPluginEnabled, isUiPluginTrusted, readUiPluginTrust, trustUiPlugin } from './plugin-registry.js';
473
+ /** 第三方 bundle 的 rev:**内容摘要**(sha256 前 16 位)。与内置档同一套语义(见
474
+ * `builtinContentRev`),只是长度不同:第三方的字节是「别人放进来的一份代码」,
475
+ * rev 一直按 16 位落盘并进了既有断言,不动。 */
476
+ function contentRev(bytes) {
477
+ return createHash('sha256').update(bytes).digest('hex').slice(0, 16);
478
+ }
479
+ /** 第三方插件目录(宿主插件与界面半边同住 `~/.dsc/plugins/`)。 */
480
+ export function thirdPartyUiRoot() {
481
+ return dscPath('plugins');
482
+ }
483
+ /** 模块级缓存:目录 → 表。进程内只有宿主这一个写者。 */
484
+ const thirdPartyCaches = new Map();
485
+ function thirdPartyCache(dir) {
486
+ const existing = thirdPartyCaches.get(dir);
487
+ if (existing !== undefined)
488
+ return existing;
489
+ const created = new Map();
490
+ thirdPartyCaches.set(dir, created);
491
+ return created;
492
+ }
493
+ /**
494
+ * 扫第三方插件目录,合成界面半边的发现清单。
495
+ *
496
+ * 每一步失败/拒绝都记进 problems 并跳过那一条,不静默:
497
+ * 目录名不成形、`plugin.json` 缺失或坏、`api` 没声明、被停用(plugins.json)、
498
+ * 没有信任记录(首次安装要答一次)、api 区间对不上当前壳、与内置 id 撞名。
499
+ *
500
+ * @param shellApiVersion - 当前壳的 `@dsc/ui` 契约版本(内置清单顶层那个)
501
+ * @param builtinIds - 内置清单里已有的 id(撞名时第三方让路)
502
+ * @param dir - 第三方根目录,缺省 `~/.dsc/plugins`
503
+ */
504
+ export function discoverThirdPartyUiArtifacts(shellApiVersion, builtinIds, dir = thirdPartyUiRoot()) {
505
+ const entries = [];
506
+ const problems = [];
507
+ let names;
508
+ try {
509
+ names = readdirSync(dir, { withFileTypes: true }).filter((e) => e.isDirectory() && !e.name.startsWith('.')).map((e) => e.name);
510
+ }
511
+ catch {
512
+ return { entries, problems }; // 目录还没有 = 还没装过第三方,正常态
513
+ }
514
+ const cache = thirdPartyCache(dir);
515
+ const trusted = readUiPluginTrust();
516
+ for (const name of names) {
517
+ const where = `${name}/ui/client.js`;
518
+ const manifestPath = resolve(dir, name, 'plugin.json');
519
+ let doc;
520
+ try {
521
+ doc = JSON.parse(readFileSync(manifestPath, 'utf8'));
522
+ }
523
+ catch {
524
+ // 没有 plugin.json 的目录可能是宿主插件的资料目录:只在没有界面半边时当没看见。
525
+ if (!existsClient(dir, name))
526
+ problems.push(`${where}: 没有 plugin.json(第三方界面插件必须声明 api 区间)`);
527
+ continue;
528
+ }
529
+ const rawApi = doc['api'];
530
+ const api = typeof rawApi === 'string' && rawApi.trim() !== '' ? rawApi.trim() : undefined;
531
+ if (api === undefined) {
532
+ problems.push(`${where}: plugin.json 没写 api(@dsc/ui 的版本区间,如 "^1.0.0")——第三方必须声明`);
533
+ continue;
534
+ }
535
+ const rawPlatforms = doc['platforms'];
536
+ const platforms = Array.isArray(rawPlatforms)
537
+ ? rawPlatforms.filter((value) => value === 'web' || value === 'tui')
538
+ : ['web'];
539
+ if (rawPlatforms !== undefined && platforms.length === 0) {
540
+ problems.push(`${where}: platforms 不认识(${JSON.stringify(rawPlatforms)}),只认 web / tui`);
541
+ continue;
542
+ }
543
+ // phase:调度档位(内置与第三方同一张词表);坏值记问题并按 application,不进图。
544
+ const rawPhase = doc['phase'];
545
+ const phase = rawPhase === 'early' || rawPhase === 'application' ? rawPhase : undefined;
546
+ if (rawPhase !== undefined && phase === undefined) {
547
+ problems.push(`${where}: phase 只能是 'early' / 'application'(${JSON.stringify(rawPhase)}),当没声明处理`);
548
+ }
549
+ const fileKey = `${name}/ui/client.js`;
550
+ // 先判「这份代码装不装得上」(撞名、门禁),再问用户要不要信任——
551
+ // 别让人信任一个注定进不了启动图的东西。
552
+ if (builtinIds.has(name)) {
553
+ problems.push(`${where}: id 与内置插件撞名,第三方这份被跳过`);
554
+ continue;
555
+ }
556
+ const gate = evaluateUiApiGate(api, shellApiVersion);
557
+ if (gate !== null) {
558
+ problems.push(`${name}: ${gate}`);
559
+ continue;
560
+ }
561
+ if (!isPluginEnabled(fileKey)) {
562
+ continue; // 停用不是问题:启停是用户的开关,不进 problems
563
+ }
564
+ if (trusted[fileKey] === undefined) {
565
+ problems.push(`${where}: 还没有信任记录——首次安装需要在插件中心确认一次(它将能调用宿主的界面方法)`);
566
+ continue;
567
+ }
568
+ const bytes = readFileSyncSafe(resolve(dir, name, 'ui', 'client.js'));
569
+ if (bytes === null) {
570
+ problems.push(`${where}: plugin.json 在,但 ui/client.js 读不到`);
571
+ continue;
572
+ }
573
+ const rev = contentRev(bytes);
574
+ const cached = cache.get(fileKey);
575
+ const fingerprint = `${rev}`;
576
+ const row = {
577
+ id: name,
578
+ file: 'client.js',
579
+ rev,
580
+ api,
581
+ origin: 'third-party',
582
+ source: name,
583
+ ...(phase === undefined ? {} : { phase }),
584
+ };
585
+ // 双平台插件进两个平台视图:web 行缺省(无 platform 字段),tui 行显式写。
586
+ // origin 标记第三方:装载器按它去 ui/ 子目录读字节(磁盘布局与内置不同)。
587
+ for (const platform of platforms) {
588
+ entries.push({ ...row, origin: 'third-party', ...(platform === 'web' ? {} : { platform }) });
589
+ }
590
+ if (cached === undefined || cached.fingerprint !== fingerprint) {
591
+ cache.set(fileKey, {
592
+ row,
593
+ bytes,
594
+ fingerprint,
595
+ previous: cached === undefined ? null : { rev: cached.row.rev, bytes: cached.bytes },
596
+ });
597
+ }
598
+ }
599
+ return { entries, problems };
600
+ }
601
+ function existsClient(dir, name) {
602
+ try {
603
+ statSync(resolve(dir, name, 'ui', 'client.js'));
604
+ return true;
605
+ }
606
+ catch {
607
+ return false;
608
+ }
609
+ }
610
+ /**
611
+ * 第三方界面插件的信任卡视图:把 `~/.dsc/plugins/` 扫一遍,逐条给出「能不能装、
612
+ * 信没信、启没启」。判定与 {@link discoverThirdPartyUiArtifacts} 同一套(目录形状 /
613
+ * api 门禁 / 撞名 / 停用 / 信任),差别只在输出形状:那边是「装得上的条目 + 一句句
614
+ * 问题」,这边是**每一条的状态**——插件中心的信任卡要把没信任的那些摊出来给用户确认。
615
+ *
616
+ * 有 `problem` 的行同时标上 `problemKind`(manifest / clash / version / artifact):界面
617
+ * 按档画「下一步做什么」(补声明 / 改名 / 升壳 / 查产物路径),不去猜人话句子里有没有某个词。
618
+ *
619
+ * 既没有 plugin.json 也没有界面半边的目录(宿主插件的资料目录)不出现。
620
+ *
621
+ * @param shellApiVersion - 当前壳的 `@dsc/ui` 契约版本(内置清单顶层那个)
622
+ * @param builtinIds - 内置清单里已有的 id(撞名时第三方让路)
623
+ * @param dir - 第三方根目录,缺省 `~/.dsc/plugins`
624
+ */
625
+ export function scanThirdPartyUiTrusts(shellApiVersion, builtinIds, dir = thirdPartyUiRoot()) {
626
+ const out = [];
627
+ let names;
628
+ try {
629
+ names = readdirSync(dir, { withFileTypes: true })
630
+ .filter((entry) => entry.isDirectory() && !entry.name.startsWith('.'))
631
+ .map((entry) => entry.name);
632
+ }
633
+ catch {
634
+ return out; // 目录还没有 = 还没装过第三方,正常态
635
+ }
636
+ const trusted = readUiPluginTrust();
637
+ for (const name of names) {
638
+ const hasClient = existsClient(dir, name);
639
+ let doc;
640
+ try {
641
+ doc = JSON.parse(readFileSync(resolve(dir, name, 'plugin.json'), 'utf8'));
642
+ }
643
+ catch {
644
+ doc = null;
645
+ }
646
+ if (doc === null && !hasClient)
647
+ continue;
648
+ const fileKey = `${name}/ui/client.js`;
649
+ const trust = trusted[fileKey];
650
+ const row = {
651
+ name,
652
+ platforms: ['web'],
653
+ trusted: trust !== undefined,
654
+ enabled: isPluginEnabled(fileKey),
655
+ ...(trust === undefined ? {} : { trustedAt: trust.trustedAt }),
656
+ };
657
+ if (doc === null) {
658
+ row.problem = '没有 plugin.json(第三方界面插件必须声明 api 区间)';
659
+ row.problemKind = 'manifest';
660
+ out.push(row);
661
+ continue;
662
+ }
663
+ const rawApi = doc['api'];
664
+ const api = typeof rawApi === 'string' && rawApi.trim() !== '' ? rawApi.trim() : undefined;
665
+ if (api !== undefined)
666
+ row.api = api;
667
+ const rawPlatforms = doc['platforms'];
668
+ if (Array.isArray(rawPlatforms)) {
669
+ const platforms = rawPlatforms.filter((value) => value === 'web' || value === 'tui');
670
+ if (platforms.length > 0)
671
+ row.platforms = platforms;
672
+ }
673
+ if (api === undefined) {
674
+ row.problem = 'plugin.json 没写 api(@dsc/ui 的版本区间,如 "^1.0.0")——第三方必须声明';
675
+ row.problemKind = 'manifest';
676
+ }
677
+ else if (builtinIds.has(name)) {
678
+ row.problem = 'id 与内置插件撞名,这份会被跳过';
679
+ row.problemKind = 'clash';
680
+ }
681
+ else {
682
+ const gate = evaluateUiApiGate(api, shellApiVersion);
683
+ if (gate !== null) {
684
+ row.problem = gate;
685
+ row.problemKind = 'version';
686
+ }
687
+ else if (!hasClient) {
688
+ row.problem = 'plugin.json 在,但 ui/client.js 读不到';
689
+ row.problemKind = 'artifact';
690
+ }
691
+ }
692
+ out.push(row);
693
+ }
694
+ return out;
695
+ }
696
+ /**
697
+ * 落一条信任记录(信任卡「确认信任」的终点):先按发现层的同一批判定复核一遍,
698
+ * 全过才写 plugins.json 的 `uiTrust` 段。
699
+ *
700
+ * 目录名在这里**先钉死形状**:它会拼成路径(`<dir>/<name>/ui/client.js`),
701
+ * 带分隔符或 `..` 的名字要在拼路径之前挡住(路径穿越)。
702
+ */
703
+ export function trustThirdPartyUiPlugin(name, shellApiVersion, builtinIds, dir = thirdPartyUiRoot()) {
704
+ if (name === '' || name.length > 200)
705
+ return { ok: false, error: '插件目录名不合法' };
706
+ if (/[\\/]/.test(name) || name === '.' || name === '..') {
707
+ return { ok: false, error: '插件目录名不合法(不能带路径分隔符)' };
708
+ }
709
+ let doc;
710
+ try {
711
+ doc = JSON.parse(readFileSync(resolve(dir, name, 'plugin.json'), 'utf8'));
712
+ }
713
+ catch {
714
+ return { ok: false, error: `读不到 ${name}/plugin.json——目录名对吗?(要的是 ~/.dsc/plugins/<目录名>)` };
715
+ }
716
+ const rawApi = doc['api'];
717
+ const api = typeof rawApi === 'string' && rawApi.trim() !== '' ? rawApi.trim() : undefined;
718
+ if (api === undefined)
719
+ return { ok: false, error: `${name}: plugin.json 没写 api(@dsc/ui 的版本区间),装不上` };
720
+ if (builtinIds.has(name))
721
+ return { ok: false, error: `${name}: id 与内置插件撞名,这份会被跳过` };
722
+ const gate = evaluateUiApiGate(api, shellApiVersion);
723
+ if (gate !== null)
724
+ return { ok: false, error: `${name}: ${gate}` };
725
+ if (!existsClient(dir, name))
726
+ return { ok: false, error: `${name}: ui/client.js 读不到,装不上` };
727
+ if (isUiPluginTrusted(`${name}/ui/client.js`)) {
728
+ return { ok: true, notice: `「${name}」早就信任过了——重启宿主(或刷新页面)后装载` };
729
+ }
730
+ trustUiPlugin(`${name}/ui/client.js`);
731
+ return { ok: true, notice: `已信任「${name}」——重启宿主(或刷新页面)后装载` };
732
+ }
733
+ function readFileSyncSafe(path) {
734
+ try {
735
+ return readFileSync(path);
736
+ }
737
+ catch {
738
+ return null;
739
+ }
740
+ }
741
+ /**
742
+ * 这个启停键是不是第三方界面插件(`<目录名>/ui/client.js`,住 `~/.dsc/plugins/<目录名>/ui/`)。
743
+ *
744
+ * 热启停(plugin-loader 的 setPluginEnabledHot)只认**宿主半边**的 .js 文件;界面半边
745
+ * 在页面加载时按 plugins.json 的启停现场合成,没有「热挂载」这回事。runtime 用这个
746
+ * 判定把界面半边的开关导向「写盘 + 提示刷新」,而不是去挂一个不存在的宿主插件。
747
+ */
748
+ export function isThirdPartyUiEntry(file) {
749
+ const at = file.indexOf('/ui/');
750
+ if (at <= 0)
751
+ return false;
752
+ const name = file.slice(0, at);
753
+ if (/[\\/]/.test(name))
754
+ return false;
755
+ return existsClient(thirdPartyUiRoot(), name);
756
+ }
757
+ /**
758
+ * 第三方 bundle 的内容寻址查询:rev 对上当前给字节,对上上一代给旧字节,都没有 404。
759
+ * 形状与内置的 `lookupUiPluginBundle` 同一份 `UiBundleLookup`——伺服路由先查内置、
760
+ * 再查这里,两边口径一致。
761
+ */
762
+ export function lookupThirdPartyUiBundle(id, file, rev, dir = thirdPartyUiRoot(), wantBody = true) {
763
+ void file; // 第三方的文件名固定 client.js;file 参与 key 但查询按 id 定位
764
+ const empty = { known: false, current: false, previous: false, size: null, body: null };
765
+ if (!PLUGIN_ID.test(id))
766
+ return empty;
767
+ const cache = thirdPartyCaches.get(dir);
768
+ const cached = cache?.get(`${id}/ui/client.js`);
769
+ if (cached === undefined)
770
+ return { ...empty, known: false };
771
+ if (cached.row.rev === rev) {
772
+ return { known: true, current: true, previous: false, size: cached.bytes.length, body: wantBody ? cached.bytes : null };
773
+ }
774
+ if (cached.previous !== null && cached.previous.rev === rev) {
775
+ return { known: true, current: false, previous: true, size: cached.previous.bytes.length, body: wantBody ? cached.previous.bytes : null };
776
+ }
777
+ return { known: true, current: false, previous: false, size: null, body: null };
778
+ }
779
+ /**
780
+ * 一个平台视图下的**全部**界面插件:内置(构建产物清单)+ 第三方(`~/.dsc/plugins/`
781
+ * 里带界面半边的目录)。启动图(web)与终端装载器(tui)都从这一个口子取,
782
+ * 谁也不许自己再拼一份——口径分叉就是从这里开始的。
783
+ */
784
+ export function collectUiArtifactsForPlatform(platform, options = {}) {
785
+ const builtin = collectUiPluginArtifacts(options.builtinDir, platform, { force: options.force });
786
+ const third = discoverThirdPartyUiArtifacts(builtin.apiVersion, new Set(builtin.entries.map((entry) => entry.id)), options.thirdPartyDir);
787
+ const entries = [
788
+ ...builtin.entries,
789
+ ...third.entries.filter((entry) => (entry.platform ?? 'web') === platform),
790
+ ];
791
+ const problems = [...builtin.problems, ...third.problems];
792
+ return { entries, problems, ...(builtin.apiVersion === undefined ? {} : { apiVersion: builtin.apiVersion }) };
793
+ }
794
+ /**
795
+ * 一条产物条目对应的磁盘路径(内置 `<dir>/<id>/<file>`;第三方 `<root>/<id>/ui/client.js`)。
796
+ *
797
+ * HMR 轮询要按图行 stat 文件、组 combo 要按图行读字节——两处都要这份「id → 路径」的换算,
798
+ * 放在这里与发现层同一口径;拼出来的路径同样过 `inside()` 围栏。
799
+ */
800
+ export function uiArtifactFilePath(entry, dirs = {}) {
801
+ if (entry.origin === 'third-party') {
802
+ const root = dirs.thirdPartyDir ?? thirdPartyUiRoot();
803
+ if (!PLUGIN_ID.test(entry.id))
804
+ return null;
805
+ const path = resolve(root, entry.id, 'ui', 'client.js');
806
+ return inside(root, path) ? path : null;
807
+ }
808
+ const root = dirs.builtinDir ?? uiPluginsDir();
809
+ const path = resolve(root, entry.id, entry.file);
810
+ return inside(root, path) ? path : null;
811
+ }
812
+ /** 读一条产物条目的字节(路径按 {@link uiArtifactFilePath};读不到给 null)。 */
813
+ export function readUiArtifactBytes(entry, dirs = {}) {
814
+ const path = uiArtifactFilePath(entry, dirs);
815
+ return path === null ? null : readFileSyncSafe(path);
816
+ }
817
+ /**
818
+ * 产物条目 → 启动图行。宿主两个组图点(本机界面服务与远程壳)共用这一份:
819
+ * 以前两边手抄字段,加一个字段就要记得改两处——漂移过一次,收敛在这里。
820
+ */
821
+ export function toUiPluginRows(entries) {
822
+ return entries.map((entry) => ({
823
+ id: entry.id,
824
+ rev: entry.rev,
825
+ ...(entry.inject === undefined ? {} : { inject: entry.inject }),
826
+ ...(entry.external === undefined ? {} : { external: entry.external }),
827
+ ...(entry.immediately === true ? { immediately: true } : {}),
828
+ ...(entry.phase === undefined ? {} : { phase: entry.phase }),
829
+ }));
830
+ }