@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,294 @@
1
+ /**
2
+ * 外部插件热挂载管理器(对应 dsh 的 HMR:启停即时生效,无需重启宿主)。
3
+ *
4
+ * 外部插件是 cordis object plugin(命名导出 inject/apply,可选 name/apiVersion/
5
+ * description),经 `root.plugin(mod, config)` 挂载为独立 Fiber;卸载 =
6
+ * `fiber.dispose()`(自动运行插件 apply 返回的 disposer)。文件变更后的重载
7
+ * 通过 mtime 查询参数破坏 ESM 缓存。
8
+ *
9
+ * 版本管理:插件声明 `export const apiVersion = N` 时与内核 KERNEL_API_VERSION
10
+ * 比对,高于内核 → 拒绝挂载并自动停用(回滚到可用状态),避免每次启动报错。
11
+ *
12
+ * @module dsc/core/plugin-loader
13
+ */
14
+ import { readdirSync, statSync } from 'node:fs';
15
+ import { basename, join } from 'node:path';
16
+ import { pathToFileURL } from 'node:url';
17
+ import { ensureResolveHook } from './dsh-compat/resolve-hook.js';
18
+ import { dshToolsFacade } from './dsh-compat/tools-facade.js';
19
+ import { checkApiVersion, getPluginConfig, getPluginMeta, isPluginEnabled, readPluginEntries, registerPluginMeta, writePluginEnabled, KERNEL_API_VERSION, } from './plugin-registry.js';
20
+ import { errText as err } from './err-text.js';
21
+ import { dscPath } from './path-policy.js';
22
+ /** 内核插件 API 版本(重导出,供宿主/文档引用)。 */
23
+ export { KERNEL_API_VERSION };
24
+ /**
25
+ * dsc 自己的全部服务名(services/types.ts 的 Context 声明)。外部插件 inject 里
26
+ * 出现这张表之外的名字,就认定是 dsh 风格的插件,走兼容层挂载路径。
27
+ */
28
+ const DSC_SERVICE_NAMES = new Set([
29
+ 'llm', 'session', 'approval', 'mode', 'todo', 'plan', 'ask', 'goal', 'tools', 'transcript',
30
+ 'commands', 'compact', 'agent', 'prompt', 'guards', 'surfaces', 'waiting', 'skills', 'settings',
31
+ 'hooks', 'memory', 'dock', 'ui', 'team', 'mcp', 'sessionSearch', 'approvalFloor', 'interactive',
32
+ 'sandbox', 'logger',
33
+ ]);
34
+ /** 兼容层开着的判定与说明文案在挂载路径里;这里只留服务名清单。 */
35
+ /** 已挂载的外部插件:文件名 → cordis Fiber(dispose 即卸载)。 */
36
+ const mounted = new Map();
37
+ /**
38
+ * 内置但可停用的官方插件(智能体团队、电脑操作):这里登记它们的插件对象,
39
+ * 于是「打开开关」不必去找 `~/.dsc/plugins/` 下的文件,热挂载直接挂内置对象。
40
+ */
41
+ const builtinMounts = new Map();
42
+ /**
43
+ * 登记一个内置官方插件的挂载对象(宿主装配时调用一次)。
44
+ * @param file - 开关键,与 `registerPluginMeta` 用的名字一致。
45
+ */
46
+ export function registerBuiltinMount(file, plugin) {
47
+ builtinMounts.set(basename(file), plugin);
48
+ }
49
+ /** 初始化(宿主启动时调用一次,传入内核 root)。 */
50
+ let rootRef = null;
51
+ export function initPluginRuntime(root) {
52
+ rootRef = root;
53
+ }
54
+ /**
55
+ * 读取插件模块(按 mtime 破坏 ESM 缓存,保证文件变更后重载新代码)。
56
+ * @returns null = 模块不可用(错误已写入 meta.problem)。
57
+ */
58
+ async function importPluginModule(file, meta) {
59
+ let mtime = 0;
60
+ try {
61
+ mtime = statSync(file).mtimeMs;
62
+ }
63
+ catch {
64
+ meta.problem = '文件不存在或不可读';
65
+ return null;
66
+ }
67
+ const url = `${pathToFileURL(file).href}?t=${mtime}`;
68
+ try {
69
+ return (await import(url));
70
+ }
71
+ catch (error) {
72
+ meta.problem = `模块导入失败:${err(error)}`;
73
+ return null;
74
+ }
75
+ }
76
+ /**
77
+ * 挂载一个外部插件(热;已挂载时先卸载旧 fiber)。
78
+ * 失败路径:apiVersion 不兼容 / 模块损坏 / 缺 apply → 元数据记 problem,
79
+ * 自动停用(写盘回滚到可用状态),返回 false。
80
+ */
81
+ export async function mountExternalPlugin(file) {
82
+ const root = rootRef;
83
+ if (root === null)
84
+ throw new Error('plugin runtime 未初始化');
85
+ const base = basename(file);
86
+ // 内置官方插件:对象已在宿主装配时登记,不必读文件;与内核同源,跳过 apiVersion 检查。
87
+ const builtin = builtinMounts.get(base);
88
+ if (builtin !== undefined) {
89
+ await unmountExternalPlugin(base);
90
+ try {
91
+ const fiber = root.plugin(builtin, getPluginConfig(base));
92
+ await fiber;
93
+ mounted.set(base, fiber);
94
+ const own = getPluginMeta(base);
95
+ if (own !== undefined)
96
+ own.problem = undefined;
97
+ return true;
98
+ }
99
+ catch (error) {
100
+ const own = getPluginMeta(base);
101
+ if (own !== undefined)
102
+ own.problem = `挂载失败:${err(error)}`;
103
+ await disableSilently(base);
104
+ return false;
105
+ }
106
+ }
107
+ const meta = { file: base, name: base.replace(/\.js$/, ''), description: '', source: 'external' };
108
+ registerPluginMeta(meta);
109
+ const mod = await importPluginModule(file, meta);
110
+ if (mod === null) {
111
+ await disableSilently(base);
112
+ return false;
113
+ }
114
+ if (typeof mod.name === 'string' && mod.name !== '')
115
+ meta.name = mod.name;
116
+ if (typeof mod.description === 'string' && mod.description !== '')
117
+ meta.description = mod.description;
118
+ if (typeof mod.apiVersion === 'number')
119
+ meta.apiVersion = mod.apiVersion;
120
+ // ---- 版本管理:不兼容自动回滚(停用并写盘) ----
121
+ const problem = checkApiVersion(meta.apiVersion);
122
+ if (problem !== null) {
123
+ meta.problem = problem;
124
+ await disableSilently(base);
125
+ return false;
126
+ }
127
+ if (typeof mod.apply !== 'function') {
128
+ meta.problem = '缺少 apply 导出(不是 cordis object plugin)';
129
+ await disableSilently(base);
130
+ return false;
131
+ }
132
+ // ---- dsh 风格识别 ----
133
+ // inject 里有 dsc 不认识的服务名 = dsh 生态的插件。兼容层没开就提示先开它;开了也
134
+ // 垫不起的(sessionProjections、agents 这类要整个 dsh 会话语义的),话说明白再回滚。
135
+ const injectNames = Array.isArray(mod.inject) ? mod.inject.filter((n) => typeof n === 'string') : [];
136
+ const foreign = injectNames.filter((n) => !DSC_SERVICE_NAMES.has(n));
137
+ if (foreign.length > 0) {
138
+ if (!isPluginEnabled('dsh-compat')) {
139
+ meta.problem =
140
+ `插件需要 dsc 不认识的服务:${foreign.join('、')}。若这是 dsh(DeepSeek Harness)风格的插件,` +
141
+ '请先在插件中心启用「dsh 兼容层」(dsh-compat)再打开本插件';
142
+ }
143
+ else {
144
+ meta.problem =
145
+ `这个 dsh 插件需要 ${foreign.join('、')} 服务,超出 dsc 兼容层的支持范围。` +
146
+ '依赖 dsh 会话语义(投影、agent、目标)的插件个人版不兼容';
147
+ }
148
+ await disableSilently(base);
149
+ return false;
150
+ }
151
+ // ---- 配置校验(dsh 插件用 schemastery 导出 Config;有就调一次,失败响亮回滚) ----
152
+ let configForApply = getPluginConfig(base);
153
+ if (typeof mod.Config === 'function') {
154
+ try {
155
+ const validated = mod.Config(configForApply);
156
+ if (validated !== null && typeof validated === 'object')
157
+ configForApply = validated;
158
+ }
159
+ catch (error) {
160
+ meta.problem = `插件配置校验失败:${err(error)}(检查 ~/.dsc/plugins.json 里这条目目的 config)`;
161
+ await disableSilently(base);
162
+ return false;
163
+ }
164
+ }
165
+ // ---- 挂载 ----
166
+ await unmountExternalPlugin(base);
167
+ // 兼容层开着:外部插件的 ctx.tools 换成双形状兼容面(dsc ToolEntry 与 dsh
168
+ // ToolDefinition 都收),dsh 插件 inject ['tools'] 时不再需要任何特判。
169
+ // 解析钩子同步注册(registerHooks),这里先确保它在,插件导入 @deepseek-ai/* 才走得通。
170
+ const needsCompat = isPluginEnabled('dsh-compat');
171
+ if (needsCompat)
172
+ ensureResolveHook([DSC_PLUGINS_DIR]);
173
+ try {
174
+ const pluginObject = {
175
+ name: meta.name,
176
+ inject: mod.inject,
177
+ apply: (innerCtx, config) => mod.apply(needsCompat ? compatCtx(innerCtx, base) : innerCtx, config),
178
+ };
179
+ const fiber = root.plugin(pluginObject, configForApply);
180
+ await fiber;
181
+ mounted.set(base, fiber);
182
+ meta.problem = undefined;
183
+ return true;
184
+ }
185
+ catch (error) {
186
+ meta.problem = `挂载失败:${err(error)}`;
187
+ await disableSilently(base);
188
+ return false;
189
+ }
190
+ }
191
+ /**
192
+ * dsh 兼容的 ctx 视图:`ctx.tools` 换成双形状的兼容面(risk 的映射每次 register
193
+ * 时现读插件条目配置),其余服务原样透传。logger 是 cordis 内置服务,不用垫。
194
+ */
195
+ function compatCtx(innerCtx, file) {
196
+ return new Proxy(innerCtx, {
197
+ get(target, prop, receiver) {
198
+ if (prop === 'tools') {
199
+ return dshToolsFacade((entry) => target.tools.register(entry), () => resolveRiskConfig(file));
200
+ }
201
+ return Reflect.get(target, prop, receiver);
202
+ },
203
+ });
204
+ }
205
+ /** 从条目树现读 risk 映射:`risk` 是这份插件全部工具的缺省,`risks` 按工具名覆盖。 */
206
+ function resolveRiskConfig(file) {
207
+ const raw = getPluginConfig(file);
208
+ return { risk: raw.risk, risks: raw.risks };
209
+ }
210
+ /** 卸载外部插件(未挂载时静默)。 */
211
+ export async function unmountExternalPlugin(file) {
212
+ const fiber = mounted.get(file);
213
+ if (fiber === undefined)
214
+ return;
215
+ mounted.delete(file);
216
+ try {
217
+ await fiber.dispose();
218
+ }
219
+ catch {
220
+ // 卸载失败不阻塞流程(插件 disposer 的错误由 cordis 记录)
221
+ }
222
+ }
223
+ /** 自动停用:卸载 + 写盘(保留原 config),宿主下次启动也不再加载。 */
224
+ async function disableSilently(file) {
225
+ await unmountExternalPlugin(file);
226
+ writePluginEnabled(file, false);
227
+ }
228
+ /**
229
+ * 热启停:enabled = 挂载,否则卸载;结果写盘持久化。
230
+ * @returns ok=false 时 problem 说明原因(UI / system 条目展示)。
231
+ */
232
+ export async function setPluginEnabledHot(file, enabled) {
233
+ if (enabled) {
234
+ // 内置官方插件没有磁盘文件,登记过的对象直接挂;其余仍按 ~/.dsc/plugins/ 里的文件找。
235
+ const entryFile = builtinMounts.has(basename(file)) ? file : resolveEntryPath(file);
236
+ if (entryFile === null)
237
+ return { ok: false, problem: `找不到插件文件 ${file}(检查 ~/.dsc/plugins/)` };
238
+ const ok = await mountExternalPlugin(entryFile);
239
+ if (!ok)
240
+ return { ok: false, problem: getPluginMeta(file)?.problem ?? '挂载失败' };
241
+ // 挂载成功后确保条目树里是启用状态
242
+ writePluginEnabled(file, true);
243
+ return { ok: true };
244
+ }
245
+ await unmountExternalPlugin(file);
246
+ writePluginEnabled(file, false);
247
+ return { ok: true };
248
+ }
249
+ /** 外部插件目录(桌面端「添加插件」的复制目标,也是这里发现 `.js` 的地方)。 */
250
+ export const DSC_PLUGINS_DIR = dscPath('plugins');
251
+ /** 加载全部外部插件(宿主启动时调用):条目树驱动,含热挂载与回滚语义。 */
252
+ export async function mountAllExternalPlugins(root, extraPaths) {
253
+ initPluginRuntime(root);
254
+ const dir = DSC_PLUGINS_DIR;
255
+ const files = new Map();
256
+ try {
257
+ for (const name of readdirSync(dir).sort()) {
258
+ if (name.endsWith('.js'))
259
+ files.set(name, join(dir, name));
260
+ }
261
+ }
262
+ catch {
263
+ // 目录不存在:只有 extraPaths
264
+ }
265
+ for (const extra of extraPaths)
266
+ files.set(basename(extra), extra);
267
+ const failures = [];
268
+ for (const [base, file] of files) {
269
+ if (isDisabledByEntry(base))
270
+ continue;
271
+ const ok = await mountExternalPlugin(file);
272
+ if (!ok) {
273
+ const meta = getPluginMeta(base);
274
+ if (meta?.problem !== undefined)
275
+ failures.push({ file: base, name: meta.name, problem: meta.problem });
276
+ }
277
+ }
278
+ return failures;
279
+ }
280
+ function isDisabledByEntry(file) {
281
+ return readPluginEntries().find((entry) => entry.file === file)?.disabled ?? false;
282
+ }
283
+ /** 解析条目树里的文件名 → 绝对路径(仅 ~/.dsc/plugins/ 下的外部插件)。 */
284
+ function resolveEntryPath(file) {
285
+ const candidate = dscPath('plugins', file);
286
+ try {
287
+ if (statSync(candidate).isFile())
288
+ return candidate;
289
+ }
290
+ catch {
291
+ // fallthrough
292
+ }
293
+ return null;
294
+ }
@@ -0,0 +1,113 @@
1
+ import type { PluginInfoView } from '../contract.js';
2
+ /** 目录里的一项(不含运行时 enabled——它由条目树决定)。 */
3
+ export interface PluginMeta {
4
+ /** 开关键:外部插件为文件名,内置为插件名。 */
5
+ file: string;
6
+ name: string;
7
+ description: string;
8
+ source: 'builtin' | 'external';
9
+ /** 插件声明的内核 API 版本;未声明时 undefined。 */
10
+ apiVersion?: number;
11
+ /** 加载失败/被自动停用的原因(回滚说明),正常时 undefined。 */
12
+ problem?: string;
13
+ /**
14
+ * true = 内置但可停用(官方插件,例如智能体团队、电脑操作)。
15
+ * 缺省 false 且 source='builtin' 的就是运行内核,不提供开关。
16
+ */
17
+ toggleable?: boolean;
18
+ /**
19
+ * 这个插件贡献的设置分区 id;插件中心据此在详情页渲染它的配置表单。
20
+ * 内置插件在 kernel 清单里声明;外部插件用 `export const settingsSection` 声明。
21
+ */
22
+ settingsSection?: string;
23
+ /**
24
+ * true = 条目树还没有这条记录时,默认按「停用」处理。
25
+ * 危险一点的官方插件(电脑操作)用它,装完不主动拿到桌面控制权。
26
+ */
27
+ defaultDisabled?: boolean;
28
+ }
29
+ /** 注册(或覆盖)一条插件元数据。 */
30
+ export declare function registerPluginMeta(meta: PluginMeta): void;
31
+ /** 读取某文件的元数据(无则 undefined)。 */
32
+ export declare function getPluginMeta(file: string): PluginMeta | undefined;
33
+ /**
34
+ * 内核插件 API 版本:外部插件用 `export const apiVersion` 声明兼容的目标版本。
35
+ * 2 = 增加设置分区(`ctx.settings.registerSection`)与技能来源
36
+ * (`ctx.skills.registerProvider` / `registerMarket`)两个扩展点;
37
+ * 3 = 增加请求组装扩展点(`ctx.prompt.register` 附加系统提示、
38
+ * `ctx.prompt.registerProjection` 命名纯投影改写发给模型的消息),并允许外部插件用
39
+ * `export const settingsSection` 声明自己的设置分区 id(插件中心据此在详情页画它的配置表单);
40
+ * 4 = 增加三个内核扩展点:工具守卫链(`ctx.guards.register` / `registerObserver`,
41
+ * 工具动手之前的闸门与工具输出的改写)、快照片段(`ctx.surfaces.register`,界面每块状态
42
+ * 由那个功能点自己登记)、等人登记(`ctx.waiting.register`,哪张卡片正挂着等用户);
43
+ * 会话记录也在此版多了按 id 存取状态这一对(`ctx.session.appendState` / `session.state`)。
44
+ * 5 = 新增一个可选服务 `sandbox`(当前档位、强制执行等级、可写根与路径判定;
45
+ * 插件关着时不存在,读它要用 `ctx.get('sandbox')`),并把「命令执行器缝」开给随包发布的
46
+ * 内置插件(`src/core/tools/command-runner.ts`:沙箱的容器后端靠它把本机 shell 换成容器)。
47
+ * 6 = 模型层开两条缝:协议适配器(`ctx.llm.registerAdapter` + 端点配置的 `api` 字段 +
48
+ * `ctx.llm.stream` 派发)与命名投影(`ctx.prompt.registerProjection` 接替 v3 的匿名改写,
49
+ * 内置 fold-system / drop-images 是保留名);会话多了 `appendNote`(投影往请求里注入的
50
+ * 日志外内容必须落一条,模型可见 ⟺ 已记录)。
51
+ * 1 到 5 的插件照常挂载(版本检查只拦「高于内核」的声明)。
52
+ */
53
+ export declare const KERNEL_API_VERSION = 6;
54
+ /** 条目树的一项。 */
55
+ export interface PluginEntry {
56
+ file: string;
57
+ disabled: boolean;
58
+ /** 透传给插件 apply(ctx, config) 的配置对象。 */
59
+ config: Record<string, unknown>;
60
+ }
61
+ /** 一条界面插件信任记录。 */
62
+ export interface UiPluginTrustEntry {
63
+ /** 答应的时刻(毫秒)。 */
64
+ trustedAt: number;
65
+ }
66
+ /** 读全部界面插件信任记录(文件缺失/损坏/形状不对按空处理)。 */
67
+ export declare function readUiPluginTrust(): Record<string, UiPluginTrustEntry>;
68
+ /** 查一个第三方界面插件有没有被信任过。 */
69
+ export declare function isUiPluginTrusted(fileKey: string): boolean;
70
+ /** 落一条信任记录(信任确认动作的终点;重复信任无害)。 */
71
+ export declare function trustUiPlugin(fileKey: string): void;
72
+ /** 读取条目树(文件缺失/损坏按空处理;兼容旧版 disabled 数组格式)。 */
73
+ export declare function readPluginEntries(): PluginEntry[];
74
+ /** 写入条目树(原子性不追求——个人版单写者)。 */
75
+ export declare function writePluginEntries(entries: PluginEntry[]): void;
76
+ export declare function getPluginConfig(file: string): Record<string, unknown>;
77
+ /**
78
+ * 合并写一个插件的配置对象(插件中心「配置」分区与插件自己共用这一个入口,
79
+ * 落 `~/.dsc/plugins.json` 的条目树)。值传 null 表示删掉这个键,回到插件默认值。
80
+ */
81
+ export declare function writePluginConfig(file: string, patch: Record<string, unknown | null>): Record<string, unknown>;
82
+ /**
83
+ * 取一个插件此刻该用的配置:装配时传进来的那份作底,磁盘上那份覆盖它。
84
+ * 为什么要覆盖——设置分区保存走 {@link writePluginConfig} 改的是磁盘,
85
+ * 插件每次用值时现调这个函数,改完配置就不必重启宿主。
86
+ * @param file - 条目树里的插件 file(内置插件就是插件名,例如 `goal`)。
87
+ * @param passed - 装配时传进来的第二参数;不是对象就当没给。
88
+ */
89
+ export declare function resolvePluginConfig(file: string, passed?: unknown): Record<string, unknown>;
90
+ /**
91
+ * 这个插件该不该挂载。条目树没记录时回落到元数据声明的默认值
92
+ * (`defaultDisabled` 为 true 的官方插件在用户主动打开之前不挂载)。
93
+ */
94
+ export declare function isPluginEnabled(file: string): boolean;
95
+ /**
96
+ * 更新条目树的 disabled 标记并写盘。
97
+ * @returns false = 该插件不可停用(属于运行内核,即 source='builtin' 且没标 toggleable)。
98
+ */
99
+ export declare function writePluginEnabled(file: string, enabled: boolean): boolean;
100
+ /**
101
+ * 一次性迁移(0.6.17 拆分):原来的「智能体团队」插件拆成「子智能体」(subagent)+
102
+ * 「智能体团队」(team)两档。已在用团队的用户(subagent 开着、team 开关从未动过)
103
+ * 自动把 team 也打开,否则升级后他们的 team_task 工具会凭空消失。
104
+ * 用户明确关过 team(条目树里有记录)就尊重那个选择,不再多事。
105
+ */
106
+ export declare function migrateTeamSplit(): void;
107
+ /**
108
+ * 版本管理:检查插件声明的 apiVersion 与内核是否兼容。
109
+ * @returns null = 兼容(或插件未声明);字符串 = 不兼容的原因。
110
+ */
111
+ export declare function checkApiVersion(apiVersion: number | undefined): string | null;
112
+ /** 目录快照 + 条目树合并成 UI 投影(运行内核那一档恒启用)。 */
113
+ export declare function listPluginInfos(): PluginInfoView[];
@@ -0,0 +1,256 @@
1
+ /**
2
+ * 插件注册表:目录快照 + 条目树持久化 + 热挂载(runtime 插件与 host 装配层共享)。
3
+ *
4
+ * - 目录(catalog):宿主装配时注册——内置插件集 + 外部插件扫描结果;
5
+ * - 条目树(~/.dsc/plugins.json):`{ version, entries: [{ file, disabled, config }] }`,
6
+ * 参照 dsh 的声明式装配(dsh 为 cordis.patch.yml)。兼容旧版
7
+ * `{ disabled: string[] }` 格式(读取时自动转换);
8
+ * - 热挂载:外部插件经 cordis `root.plugin(mod, config)` 挂载为独立 Fiber,
9
+ * 启停 = Fiber.dispose() / 重新挂载,无需重启宿主(详见 core/plugin-loader.ts)。
10
+ *
11
+ * @module dsc/core/plugin-registry
12
+ */
13
+ import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
14
+ import { dscPath } from './path-policy.js';
15
+ const catalog = new Map();
16
+ /** 注册(或覆盖)一条插件元数据。 */
17
+ export function registerPluginMeta(meta) {
18
+ catalog.set(meta.file, meta);
19
+ }
20
+ /** 读取某文件的元数据(无则 undefined)。 */
21
+ export function getPluginMeta(file) {
22
+ return catalog.get(file);
23
+ }
24
+ /**
25
+ * 内核插件 API 版本:外部插件用 `export const apiVersion` 声明兼容的目标版本。
26
+ * 2 = 增加设置分区(`ctx.settings.registerSection`)与技能来源
27
+ * (`ctx.skills.registerProvider` / `registerMarket`)两个扩展点;
28
+ * 3 = 增加请求组装扩展点(`ctx.prompt.register` 附加系统提示、
29
+ * `ctx.prompt.registerProjection` 命名纯投影改写发给模型的消息),并允许外部插件用
30
+ * `export const settingsSection` 声明自己的设置分区 id(插件中心据此在详情页画它的配置表单);
31
+ * 4 = 增加三个内核扩展点:工具守卫链(`ctx.guards.register` / `registerObserver`,
32
+ * 工具动手之前的闸门与工具输出的改写)、快照片段(`ctx.surfaces.register`,界面每块状态
33
+ * 由那个功能点自己登记)、等人登记(`ctx.waiting.register`,哪张卡片正挂着等用户);
34
+ * 会话记录也在此版多了按 id 存取状态这一对(`ctx.session.appendState` / `session.state`)。
35
+ * 5 = 新增一个可选服务 `sandbox`(当前档位、强制执行等级、可写根与路径判定;
36
+ * 插件关着时不存在,读它要用 `ctx.get('sandbox')`),并把「命令执行器缝」开给随包发布的
37
+ * 内置插件(`src/core/tools/command-runner.ts`:沙箱的容器后端靠它把本机 shell 换成容器)。
38
+ * 6 = 模型层开两条缝:协议适配器(`ctx.llm.registerAdapter` + 端点配置的 `api` 字段 +
39
+ * `ctx.llm.stream` 派发)与命名投影(`ctx.prompt.registerProjection` 接替 v3 的匿名改写,
40
+ * 内置 fold-system / drop-images 是保留名);会话多了 `appendNote`(投影往请求里注入的
41
+ * 日志外内容必须落一条,模型可见 ⟺ 已记录)。
42
+ * 1 到 5 的插件照常挂载(版本检查只拦「高于内核」的声明)。
43
+ */
44
+ export const KERNEL_API_VERSION = 6;
45
+ const PLUGINS_JSON = dscPath('plugins.json');
46
+ /** 读全部界面插件信任记录(文件缺失/损坏/形状不对按空处理)。 */
47
+ export function readUiPluginTrust() {
48
+ try {
49
+ if (!existsSync(PLUGINS_JSON))
50
+ return {};
51
+ const doc = JSON.parse(readFileSync(PLUGINS_JSON, 'utf8'));
52
+ if (doc.uiTrust === null || typeof doc.uiTrust !== 'object' || Array.isArray(doc.uiTrust))
53
+ return {};
54
+ const out = {};
55
+ for (const [key, value] of Object.entries(doc.uiTrust)) {
56
+ if (typeof value !== 'object' || value === null)
57
+ continue;
58
+ const trustedAt = value.trustedAt;
59
+ if (typeof trustedAt === 'number')
60
+ out[key] = { trustedAt };
61
+ }
62
+ return out;
63
+ }
64
+ catch {
65
+ return {};
66
+ }
67
+ }
68
+ /** 查一个第三方界面插件有没有被信任过。 */
69
+ export function isUiPluginTrusted(fileKey) {
70
+ return readUiPluginTrust()[fileKey] !== undefined;
71
+ }
72
+ /** 落一条信任记录(信任确认动作的终点;重复信任无害)。 */
73
+ export function trustUiPlugin(fileKey) {
74
+ mkdirSync(dscPath(), { recursive: true });
75
+ const doc = (() => {
76
+ try {
77
+ if (!existsSync(PLUGINS_JSON))
78
+ return { version: 1, entries: [], uiTrust: {} };
79
+ return JSON.parse(readFileSync(PLUGINS_JSON, 'utf8'));
80
+ }
81
+ catch {
82
+ return { version: 1, entries: [], uiTrust: {} };
83
+ }
84
+ })();
85
+ const uiTrust = doc.uiTrust !== null && typeof doc.uiTrust === 'object' && !Array.isArray(doc.uiTrust) ? doc.uiTrust : {};
86
+ uiTrust[fileKey] = { trustedAt: Date.now() };
87
+ writeFileSync(PLUGINS_JSON, `${JSON.stringify({ version: 1, entries: doc.entries ?? [], uiTrust }, null, 2)}\n`, 'utf8');
88
+ }
89
+ /** 读取条目树(文件缺失/损坏按空处理;兼容旧版 disabled 数组格式)。 */
90
+ export function readPluginEntries() {
91
+ try {
92
+ if (!existsSync(PLUGINS_JSON))
93
+ return [];
94
+ const doc = JSON.parse(readFileSync(PLUGINS_JSON, 'utf8'));
95
+ if (Array.isArray(doc.entries)) {
96
+ return doc.entries
97
+ .filter((entry) => entry !== null && typeof entry === 'object')
98
+ .map((entry) => ({
99
+ file: String(entry.file ?? ''),
100
+ disabled: entry.disabled === true,
101
+ config: entry.config !== null && typeof entry.config === 'object' && !Array.isArray(entry.config)
102
+ ? entry.config
103
+ : {},
104
+ }))
105
+ .filter((entry) => entry.file !== '');
106
+ }
107
+ // 旧版:{ disabled: string[] } → 全部条目 disabled=false,仅按列表标记
108
+ if (Array.isArray(doc.disabled)) {
109
+ const disabled = new Set(doc.disabled.filter((entry) => typeof entry === 'string'));
110
+ return [...disabled].sort().map((file) => ({ file, disabled: true, config: {} }));
111
+ }
112
+ return [];
113
+ }
114
+ catch {
115
+ return [];
116
+ }
117
+ }
118
+ /** 写入条目树(原子性不追求——个人版单写者)。 */
119
+ export function writePluginEntries(entries) {
120
+ mkdirSync(dscPath(), { recursive: true });
121
+ // 保留文件里其他顶层段(uiTrust 等)——这份文件被多条体系共用,各写各的段。
122
+ const previousUiTrust = (() => {
123
+ try {
124
+ const doc = JSON.parse(readFileSync(PLUGINS_JSON, 'utf8'));
125
+ return doc.uiTrust !== null && typeof doc.uiTrust === 'object' && !Array.isArray(doc.uiTrust) ? doc.uiTrust : undefined;
126
+ }
127
+ catch {
128
+ return undefined;
129
+ }
130
+ })();
131
+ writeFileSync(PLUGINS_JSON, `${JSON.stringify({ version: 1, entries, ...(previousUiTrust === undefined ? {} : { uiTrust: previousUiTrust }) }, null, 2)}\n`, 'utf8');
132
+ }
133
+ export function getPluginConfig(file) {
134
+ const entry = readPluginEntries().find((candidate) => candidate.file === file);
135
+ return entry?.config ?? {};
136
+ }
137
+ /**
138
+ * 合并写一个插件的配置对象(插件中心「配置」分区与插件自己共用这一个入口,
139
+ * 落 `~/.dsc/plugins.json` 的条目树)。值传 null 表示删掉这个键,回到插件默认值。
140
+ */
141
+ export function writePluginConfig(file, patch) {
142
+ const entries = readPluginEntries();
143
+ const index = entries.findIndex((entry) => entry.file === file);
144
+ const config = index >= 0 ? { ...entries[index].config } : {};
145
+ for (const [key, value] of Object.entries(patch)) {
146
+ if (key === '')
147
+ continue;
148
+ if (value === null)
149
+ delete config[key];
150
+ else
151
+ config[key] = value;
152
+ }
153
+ if (index >= 0)
154
+ entries[index] = { ...entries[index], config };
155
+ // 新建条目时沿用元数据声明的默认开关:只改配置值不该顺手把插件点亮
156
+ else
157
+ entries.push({ file, disabled: catalog.get(file)?.defaultDisabled === true, config });
158
+ writePluginEntries(entries);
159
+ return config;
160
+ }
161
+ /**
162
+ * 取一个插件此刻该用的配置:装配时传进来的那份作底,磁盘上那份覆盖它。
163
+ * 为什么要覆盖——设置分区保存走 {@link writePluginConfig} 改的是磁盘,
164
+ * 插件每次用值时现调这个函数,改完配置就不必重启宿主。
165
+ * @param file - 条目树里的插件 file(内置插件就是插件名,例如 `goal`)。
166
+ * @param passed - 装配时传进来的第二参数;不是对象就当没给。
167
+ */
168
+ export function resolvePluginConfig(file, passed) {
169
+ const fromDisk = getPluginConfig(file);
170
+ if (passed === null || typeof passed !== 'object' || Array.isArray(passed))
171
+ return fromDisk;
172
+ return { ...passed, ...fromDisk };
173
+ }
174
+ /**
175
+ * 这个插件该不该挂载。条目树没记录时回落到元数据声明的默认值
176
+ * (`defaultDisabled` 为 true 的官方插件在用户主动打开之前不挂载)。
177
+ */
178
+ export function isPluginEnabled(file) {
179
+ const entry = readPluginEntries().find((candidate) => candidate.file === file);
180
+ if (entry === undefined)
181
+ return catalog.get(file)?.defaultDisabled !== true;
182
+ return !entry.disabled;
183
+ }
184
+ /**
185
+ * 更新条目树的 disabled 标记并写盘。
186
+ * @returns false = 该插件不可停用(属于运行内核,即 source='builtin' 且没标 toggleable)。
187
+ */
188
+ export function writePluginEnabled(file, enabled) {
189
+ const meta = catalog.get(file);
190
+ const canToggle = meta === undefined || meta.source === 'external' || meta.toggleable === true;
191
+ if (!canToggle)
192
+ return false;
193
+ const entries = readPluginEntries();
194
+ const index = entries.findIndex((entry) => entry.file === file);
195
+ if (index >= 0) {
196
+ entries[index] = { ...entries[index], disabled: !enabled };
197
+ }
198
+ else {
199
+ entries.push({ file, disabled: !enabled, config: {} });
200
+ }
201
+ writePluginEntries(entries);
202
+ return true;
203
+ }
204
+ /**
205
+ * 一次性迁移(0.6.17 拆分):原来的「智能体团队」插件拆成「子智能体」(subagent)+
206
+ * 「智能体团队」(team)两档。已在用团队的用户(subagent 开着、team 开关从未动过)
207
+ * 自动把 team 也打开,否则升级后他们的 team_task 工具会凭空消失。
208
+ * 用户明确关过 team(条目树里有记录)就尊重那个选择,不再多事。
209
+ */
210
+ export function migrateTeamSplit() {
211
+ const entries = readPluginEntries();
212
+ if (entries.some((entry) => entry.file === 'team'))
213
+ return;
214
+ const subagent = entries.find((entry) => entry.file === 'subagent');
215
+ if (subagent === undefined || subagent.disabled)
216
+ return;
217
+ writePluginEnabled('team', true);
218
+ }
219
+ /**
220
+ * 版本管理:检查插件声明的 apiVersion 与内核是否兼容。
221
+ * @returns null = 兼容(或插件未声明);字符串 = 不兼容的原因。
222
+ */
223
+ export function checkApiVersion(apiVersion) {
224
+ if (apiVersion === undefined)
225
+ return null;
226
+ if (typeof apiVersion !== 'number' || !Number.isInteger(apiVersion)) {
227
+ return `apiVersion 非法(${String(apiVersion)}),应为整数`;
228
+ }
229
+ if (apiVersion > KERNEL_API_VERSION) {
230
+ return `插件要求内核 API v${apiVersion},当前内核 v${KERNEL_API_VERSION}(请升级 Pneuma)`;
231
+ }
232
+ if (apiVersion < 1) {
233
+ return `apiVersion 必须为正整数,收到 ${apiVersion}`;
234
+ }
235
+ return null;
236
+ }
237
+ /** 目录快照 + 条目树合并成 UI 投影(运行内核那一档恒启用)。 */
238
+ export function listPluginInfos() {
239
+ const entries = new Map(readPluginEntries().map((entry) => [entry.file, entry]));
240
+ return [...catalog.values()].map((meta) => {
241
+ const entry = entries.get(meta.file);
242
+ const canToggle = meta.source === 'external' || meta.toggleable === true;
243
+ const disabled = canToggle ? (entry?.disabled ?? meta.defaultDisabled === true) : false;
244
+ return {
245
+ file: meta.file,
246
+ name: meta.name,
247
+ description: meta.description,
248
+ enabled: !disabled,
249
+ source: meta.source,
250
+ toggleable: canToggle,
251
+ settingsSection: meta.settingsSection,
252
+ apiVersion: meta.apiVersion,
253
+ problem: meta.problem,
254
+ };
255
+ });
256
+ }