@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,179 @@
1
+ /**
2
+ * LSP 的 URI ↔ 路径与坐标换算(全是纯函数,自检重点覆盖)。
3
+ *
4
+ * ## 为什么必须「先解码成路径再比内外」
5
+ *
6
+ * 实测(Node v24,Windows):
7
+ * ```
8
+ * pathToFileURL('C:\\dsc\\src\\a b#c%20.ts').href
9
+ * === 'file:///C:/dsc/src/a%20b%23c%2520.ts' // 盘符不编码,空格/#/% 都编码
10
+ * fileURLToPath('file:///c%3A/dsc/src/a.ts', {windows:true}) === 'c:\\dsc\\src\\a.ts'
11
+ * ```
12
+ * 也就是说同一条路径可以有好几种合法写法:`C:` 与 `c:`、`%3A` 与 `:`、UNC 的
13
+ * `file://server/share`、以及大小写不同的盘符。拿 URI 字符串做前缀比较(`uri.startsWith(rootUri)`)
14
+ * 会在「服务器回 `file:///c%3A/...`,我们手里是 `file:///C:/...`」这种情况下判成「不在工作区里」。
15
+ * 所以本模块统一的做法是:**双方都 `fileURLToPath` 解码成路径,规范化后再比**。
16
+ *
17
+ * 另一个坑:`fileURLToPath` 对畸形转义会直接抛(`%2F`、Windows 下的 `%5C`、`%00`),
18
+ * 而 POSIX 世界下 `%00` 不抛、会返回带 NUL 的路径。所以解码后还要查一遍 NUL,
19
+ * 拿不准就返回 `undefined`,由调用方退回「原样显示 URI」。
20
+ *
21
+ * ## 列偏移为什么不用换算
22
+ *
23
+ * LSP 的 `character` 是 **UTF-16 code unit** 偏移。JS 字符串的长度天然就是这个单位:
24
+ * `'a😀b'.length === 4`(emoji 占两个 code unit)。所以工具层把一基列减一就完事,
25
+ * 不需要码点换算,**前提是文本和解码都按 UTF-16 理解**——`fs.readFileSync(..., 'utf8')`
26
+ * 给的正是 JS 字符串,两边一致。(本文件只做一基/零基换算;这个前提在自检里验一次。)
27
+ *
28
+ * @module dsc/core/lsp/uri
29
+ */
30
+ import { isAbsolute, relative, resolve, sep } from 'node:path';
31
+ import { fileURLToPath, pathToFileURL } from 'node:url';
32
+ /** 本机是不是 Windows 世界(URI 解码要按它选规则;自检可以显式传 world 覆盖)。 */
33
+ export function hostWorld() {
34
+ return process.platform === 'win32';
35
+ }
36
+ /**
37
+ * 路径 → `file://` URI。
38
+ *
39
+ * @param path - 文件路径(相对路径按当前工作目录展开)。
40
+ * @returns `file://` URI;盘符不编码,空格/`#`/`%` 按 RFC 3986 编码。
41
+ */
42
+ export function pathToUri(path) {
43
+ try {
44
+ return pathToFileURL(resolve(path)).href;
45
+ }
46
+ catch {
47
+ // 畸形路径(例如空 UNC 服务器名)会让 pathToFileURL 抛;这里手工拼一个仍合法的 URI。
48
+ const normalized = resolve(path).replace(/\\/g, '/');
49
+ const rooted = normalized.startsWith('/') ? normalized : `/${normalized}`;
50
+ const encoded = rooted
51
+ .split('/')
52
+ .map((segment, index) => (index === 0 ? '' : encodeURIComponent(segment)))
53
+ .join('/');
54
+ return `file://${encoded}`;
55
+ }
56
+ }
57
+ /**
58
+ * `file://` URI → 路径。
59
+ *
60
+ * 四条已知的畸形/歧义情况都在这里收口(返回 `undefined` 表示「解不出来」,调用方原样显示 URI):
61
+ * - 非 `file:` 协议(`jdt://`、`untitled:` 这类虚拟文档);
62
+ * - `%2F`(编码的斜杠)与 Windows 下的 `%5C`:`fileURLToPath` 会抛;
63
+ * - 解出来带 NUL(POSIX 世界下 `file:///dsc/a%00b.ts` 能解成功):路径里带 NUL 没有任何用处;
64
+ * - 主机名不是本机的 UNC(POSIX 世界下 `file://server/share/x` 会抛 ERR_INVALID_FILE_URL_HOST)。
65
+ *
66
+ * @param uri - 待解码的 URI(通常来自语言服务器)。
67
+ * @param windows - 按哪个世界解;缺省跟随本机平台。
68
+ */
69
+ export function uriToPath(uri, windows = hostWorld()) {
70
+ if (!uri.startsWith('file:'))
71
+ return undefined;
72
+ try {
73
+ const path = fileURLToPath(uri, { windows });
74
+ return path.includes('\0') ? undefined : path;
75
+ }
76
+ catch {
77
+ return undefined;
78
+ }
79
+ }
80
+ /** URI 或路径统一成「用来比较的路径」:绝对化 + Windows 上折成小写、去掉末尾分隔符。 */
81
+ function comparablePath(value, windows) {
82
+ const decoded = value.startsWith('file:') ? uriToPath(value, windows) : value;
83
+ if (decoded === undefined || decoded.includes('\0'))
84
+ return undefined;
85
+ const absolute = resolve(decoded);
86
+ if (!windows)
87
+ return absolute;
88
+ // Windows 上盘符与文件名都不分大小写;末尾分隔符也不该让两个同目录判成不同。
89
+ const trimmed = absolute.replace(/[\\/]+$/, '');
90
+ return (trimmed === '' ? absolute : trimmed).toLowerCase();
91
+ }
92
+ /**
93
+ * 两个 URI/路径指的是不是同一个文件(先解码、再绝对化、再按平台折大小写)。
94
+ *
95
+ * @param left - URI 或路径。
96
+ * @param right - URI 或路径。
97
+ * @param windows - 按哪个世界比;缺省跟随本机平台。
98
+ */
99
+ export function samePath(left, right, windows = hostWorld()) {
100
+ const a = comparablePath(left, windows);
101
+ const b = comparablePath(right, windows);
102
+ if (a === undefined || b === undefined)
103
+ return false;
104
+ return a === b;
105
+ }
106
+ /**
107
+ * `candidate` 是不是在 `root` 里面(含相等)。
108
+ *
109
+ * 为什么不用字符串前缀:`.../src2` 会以 `.../src` 为前缀,判错了会让不属于这个 root 的文件
110
+ * 被当成同一个语言服务器实例的文档。这里走 `path.relative`(Windows 下它自己就不分大小写)。
111
+ *
112
+ * @param root - 根目录路径(或 URI)。
113
+ * @param candidate - 待判定的路径(或 URI)。
114
+ * @param windows - 按哪个世界判;缺省跟随本机平台。
115
+ */
116
+ export function pathWithin(root, candidate, windows = hostWorld()) {
117
+ const rootPath = comparablePath(root, windows);
118
+ const candidatePath = comparablePath(candidate, windows);
119
+ if (rootPath === undefined || candidatePath === undefined)
120
+ return false;
121
+ if (rootPath === candidatePath)
122
+ return true;
123
+ const rel = relative(rootPath, candidatePath);
124
+ if (rel === '')
125
+ return true;
126
+ return !rel.startsWith('..') && !isAbsolute(rel);
127
+ }
128
+ /**
129
+ * 把 URI 或路径渲染成给模型看的路径:在工作目录里的给相对路径,外面的给绝对路径,
130
+ * 解不出来的(非 `file:` 协议、畸形转义)原样返回。Windows 上分隔符统一成 `/`——
131
+ * 模型会把这些字符串拷回 `file_path` 参数,两种分隔符 `fs` 都认,正斜杠更不容易被 JSON 转义搅乱。
132
+ *
133
+ * @param uriOrPath - 语言服务器回的 URI,或本来就是路径。
134
+ * @param cwd - 会话工作目录。
135
+ * @param windows - 按哪个世界解;缺省跟随本机平台。
136
+ */
137
+ export function displayPath(uriOrPath, cwd, windows = hostWorld()) {
138
+ // 非 file: 的 URI(jdt:// 这类虚拟文档)解不出来:原样返回。它没有对应的磁盘路径,
139
+ // 再往下 resolve/relative 只会被当成相对路径搅成一串假路径。
140
+ // 单字母 + 冒号是 Windows 盘符(C:\…),不算 scheme,继续按路径走。
141
+ if (!uriOrPath.startsWith('file:')) {
142
+ const scheme = /^[a-zA-Z][a-zA-Z0-9+.-]*:/.exec(uriOrPath);
143
+ if (scheme !== null && uriOrPath[1] !== ':')
144
+ return uriOrPath;
145
+ }
146
+ const decoded = uriOrPath.startsWith('file:') ? uriToPath(uriOrPath, windows) : uriOrPath;
147
+ if (decoded === undefined)
148
+ return uriOrPath;
149
+ const absolute = resolve(decoded);
150
+ const inside = pathWithin(cwd, absolute, windows);
151
+ const shown = inside ? relative(resolve(cwd), absolute) || '.' : absolute;
152
+ return windows ? shown.replaceAll(sep, '/') : shown;
153
+ }
154
+ /**
155
+ * 工具层的**一基**行列 → LSP 的**零基**坐标。
156
+ *
157
+ * 列不做码点换算:LSP 的 `character` 就是 UTF-16 code unit 偏移,而 JS 字符串长度就是这个单位
158
+ * (`'a😀b'.length === 4`),所以「一基减一」即正确。
159
+ *
160
+ * @param line - 一基行号(第一行 = 1)。
161
+ * @param character - 一基列号(第一列 = 1)。
162
+ * @throws Error - 不是正整数时抛(调用方负责转成给模型的降级文案)。
163
+ */
164
+ export function toProtocolPosition(line, character) {
165
+ if (!Number.isInteger(line) || line < 1)
166
+ throw new Error(`line 要是一基正整数(第一行 = 1),收到 ${String(line)}`);
167
+ if (!Number.isInteger(character) || character < 1) {
168
+ throw new Error(`character 要是一基正整数(第一列 = 1),收到 ${String(character)}`);
169
+ }
170
+ return { line: line - 1, character: character - 1 };
171
+ }
172
+ /** 零基行号 → 一基(回给模型时用)。 */
173
+ export function toDisplayLine(line) {
174
+ return line + 1;
175
+ }
176
+ /** 零基列号 → 一基(回给模型时用)。 */
177
+ export function toDisplayCharacter(character) {
178
+ return character + 1;
179
+ }
@@ -0,0 +1,51 @@
1
+ import type { MarketSkillView, MarketSource } from '../contract.js';
2
+ /** 安装所需的内部条目(UI 只看 MarketSkillView)。 */
3
+ export interface MarketEntry {
4
+ name: string;
5
+ description: string;
6
+ version?: string;
7
+ source: string;
8
+ /** dir = 目录包(内含 mainFile);flat = 单个 markdown 文件。 */
9
+ kind: 'dir' | 'flat';
10
+ /** 取文件的根:rawBase 存在时它是相对 raw 根的路径,否则本身就是绝对 URL。 */
11
+ root: string;
12
+ /** 主文件名(dir 是 `SKILL.md`,flat 是 `<name>.md`)。 */
13
+ mainFile: string;
14
+ /** 附属文件(相对 root,如 `references/x.md`)。 */
15
+ files: string[];
16
+ /** GitHub raw 根(`https://raw.githubusercontent.com/<owner>/<repo>/<ref>`)。 */
17
+ rawBase?: string;
18
+ }
19
+ interface GitHubRef {
20
+ owner: string;
21
+ repo: string;
22
+ ref: string;
23
+ dir: string;
24
+ }
25
+ /** 解析 GitHub 目录链接(`/tree/<ref>/<dir>`,省略 dir 表示仓库根)。 */
26
+ export declare function parseGitHubTree(url: string): GitHubRef | null;
27
+ /** 浏览一个源(1 小时内命中缓存不联网)。 */
28
+ export declare function browseMarketSource(source: MarketSource, options?: {
29
+ refresh?: boolean;
30
+ }): Promise<MarketEntry[]>;
31
+ /** 拉取一个条目并写进技能目录;返回落盘位置与文件数。 */
32
+ export declare function installMarketEntry(entry: MarketEntry, destRoot: string): Promise<{
33
+ target: string;
34
+ files: number;
35
+ }>;
36
+ /** 内部条目 → UI 条目。 */
37
+ export declare function toMarketSkillView(entry: MarketEntry, installedNames: ReadonlySet<string>): MarketSkillView;
38
+ /**
39
+ * 浏览一个插件市场源,返回可安装的**单文件 .js 插件**条目:
40
+ * - GitHub 目录链接(`https://github.com/…/tree/<ref>/<dir>`):目录下(递归)的
41
+ * `*.js` blob 各算一个插件;
42
+ * - 索引 JSON(`.json` 结尾):`[{ "name", "file", "description?", "version?" }]`,
43
+ * file 缺省按 `<name>.js` 相对索引地址解析。
44
+ */
45
+ export declare function browsePluginMarketSource(source: MarketSource): Promise<MarketEntry[]>;
46
+ /**
47
+ * 安装一个远程插件条目:只拉 mainFile(单文件 .js)写进目标目录,
48
+ * 返回落盘路径。热挂载由调用方(plugin-manager 插件)自己做。
49
+ */
50
+ export declare function installPluginMarketEntry(entry: MarketEntry, pluginsDir: string): Promise<string>;
51
+ export {};
@@ -0,0 +1,358 @@
1
+ /**
2
+ * 技能市场:从一个源浏览并安装技能。
3
+ *
4
+ * 支持两类源(源清单在 `~/.dsc/settings.json`,见 core/prefs.ts):
5
+ * 1. GitHub 目录链接,如 `https://github.com/<owner>/<repo>/tree/<ref>/<dir>`
6
+ * —— 用一次 `git/trees?recursive=1` 列出目录,正文与附属文件走 raw 域名;
7
+ * 2. 索引 JSON,如 `https://example.com/skills/index.json`
8
+ * —— 形状 `{ skills: [{ name, description, version?, path?, files? }] }`(也接受裸数组)。
9
+ *
10
+ * 三条约束:条目清单缓存 1 小时(`~/.dsc/cache/`);GitHub 匿名限额低,
11
+ * 有 `GITHUB_TOKEN` 就用;单文件超过 1.5 MB 或单技能附属文件超过 40 个不拉,
12
+ * 免得一次安装把家目录灌满。
13
+ *
14
+ * @module dsc/core/market
15
+ */
16
+ import { createHash } from 'node:crypto';
17
+ import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
18
+ import { basename, dirname, join } from 'node:path';
19
+ import { parseSkillMarkdown } from './skills.js';
20
+ import { dscPath } from './path-policy.js';
21
+ const CACHE_DIR = dscPath('cache');
22
+ const CACHE_TTL_MS = 60 * 60 * 1000;
23
+ const FETCH_TIMEOUT_MS = 15_000;
24
+ const MAX_EXTRA_FILES = 40;
25
+ const MAX_FILE_BYTES = 1_500_000;
26
+ const BROWSE_CONCURRENCY = 6;
27
+ async function fetchBytes(url, headers = {}) {
28
+ const response = await fetch(url, {
29
+ headers: { 'user-agent': 'dsc-skill-market', ...headers },
30
+ signal: AbortSignal.timeout(FETCH_TIMEOUT_MS),
31
+ });
32
+ if (!response.ok)
33
+ throw new Error(`${response.status} ${response.statusText}(${url})`);
34
+ return new Uint8Array(await response.arrayBuffer());
35
+ }
36
+ async function fetchText(url) {
37
+ return new TextDecoder().decode(await fetchBytes(url));
38
+ }
39
+ /** 一个条目的某个文件该从哪儿取。 */
40
+ function fileUrl(entry, relative) {
41
+ const base = entry.rawBase !== undefined && !entry.root.startsWith('http')
42
+ ? `${entry.rawBase}/${entry.root}`
43
+ : entry.root;
44
+ return `${base}/${relative}`;
45
+ }
46
+ /** 并发受限的 map(结果按输入顺序返回)。 */
47
+ async function mapLimit(items, limit, work) {
48
+ const results = new Array(items.length);
49
+ let cursor = 0;
50
+ const runners = Array.from({ length: Math.min(limit, items.length) }, async () => {
51
+ for (;;) {
52
+ const index = cursor++;
53
+ if (index >= items.length)
54
+ return;
55
+ results[index] = await work(items[index]);
56
+ }
57
+ });
58
+ await Promise.all(runners);
59
+ return results;
60
+ }
61
+ /** 解析 GitHub 目录链接(`/tree/<ref>/<dir>`,省略 dir 表示仓库根)。 */
62
+ export function parseGitHubTree(url) {
63
+ const match = /^https?:\/\/github\.com\/([^/]+)\/([^/]+)\/tree\/([^/]+)(?:\/(.+?))?\/?$/i.exec(url.trim());
64
+ if (match === null)
65
+ return null;
66
+ const [, owner, repo, ref, dir] = match;
67
+ if (owner === undefined || repo === undefined || ref === undefined)
68
+ return null;
69
+ return { owner, repo, ref, dir: (dir ?? '').replace(/^\/+|\/+$/g, '') };
70
+ }
71
+ function githubHeaders() {
72
+ const token = process.env.GITHUB_TOKEN ?? process.env.GH_TOKEN ?? '';
73
+ return token === '' ? {} : { authorization: `Bearer ${token}` };
74
+ }
75
+ /** GitHub 源:一次递归 trees 列目录,再并发取各 SKILL.md 的 frontmatter。 */
76
+ async function browseGitHub(source) {
77
+ const ref = parseGitHubTree(source.url);
78
+ if (ref === null) {
79
+ throw new Error('源地址既不是 GitHub 目录链接,也不是 .json 索引(形如 https://github.com/owner/repo/tree/main/skills)');
80
+ }
81
+ const api = `https://api.github.com/repos/${ref.owner}/${ref.repo}/git/trees/${encodeURIComponent(ref.ref)}?recursive=1`;
82
+ const response = await fetch(api, {
83
+ headers: { accept: 'application/vnd.github+json', 'user-agent': 'dsc-skill-market', ...githubHeaders() },
84
+ signal: AbortSignal.timeout(FETCH_TIMEOUT_MS),
85
+ });
86
+ if (!response.ok) {
87
+ if (response.status === 403 || response.status === 422) {
88
+ throw new Error(`GitHub API 拒绝(${response.status}):匿名限额较低,设置 GITHUB_TOKEN 后重试`);
89
+ }
90
+ throw new Error(`GitHub API ${response.status} ${response.statusText}(${api})`);
91
+ }
92
+ const payload = (await response.json());
93
+ const prefix = ref.dir === '' ? '' : `${ref.dir}/`;
94
+ const rawBase = `https://raw.githubusercontent.com/${ref.owner}/${ref.repo}/${ref.ref}`;
95
+ const dirSkills = new Map();
96
+ const flatSkills = [];
97
+ for (const node of payload.tree ?? []) {
98
+ const path = node.path ?? '';
99
+ if (node.type !== 'blob')
100
+ continue;
101
+ if (prefix !== '' && !path.startsWith(prefix))
102
+ continue;
103
+ const relative = prefix === '' ? path : path.slice(prefix.length);
104
+ const segments = relative.split('/');
105
+ if (segments.length === 1) {
106
+ if (relative.endsWith('.md') && relative.toLowerCase() !== 'readme.md')
107
+ flatSkills.push(relative);
108
+ continue;
109
+ }
110
+ const skillName = segments[0];
111
+ const inside = segments.slice(1).join('/');
112
+ const extras = dirSkills.get(skillName);
113
+ if (extras === undefined)
114
+ dirSkills.set(skillName, inside === 'SKILL.md' ? [] : [inside]);
115
+ else if (inside !== 'SKILL.md' && extras.length < MAX_EXTRA_FILES)
116
+ extras.push(inside);
117
+ }
118
+ // 只有确实含 SKILL.md 的目录才算技能;上面一遍没记录 mainFile,这里按路径复查
119
+ const blobs = new Set((payload.tree ?? []).map((node) => node.path ?? ''));
120
+ const entries = [];
121
+ const dirs = [...dirSkills.keys()].sort();
122
+ entries.push(...(await mapLimit(dirs, BROWSE_CONCURRENCY, async (name) => {
123
+ const entry = {
124
+ name,
125
+ description: '未提供描述,安装后本地解析',
126
+ source: source.name,
127
+ kind: 'dir',
128
+ root: `${prefix}${name}`,
129
+ mainFile: 'SKILL.md',
130
+ files: (dirSkills.get(name) ?? []).filter((file) => blobs.has(`${prefix}${name}/${file}`)),
131
+ rawBase,
132
+ };
133
+ try {
134
+ entry.description = describe(parseSkillMarkdown(await fetchText(fileUrl(entry, 'SKILL.md'))));
135
+ }
136
+ catch {
137
+ // 取不到 frontmatter 就保留占位描述,安装时再本地解析
138
+ }
139
+ return entry;
140
+ })));
141
+ entries.push(...(await mapLimit(flatSkills.sort(), BROWSE_CONCURRENCY, async (path) => {
142
+ const entry = {
143
+ name: basename(path, '.md'),
144
+ description: '未提供描述,安装后本地解析',
145
+ source: source.name,
146
+ kind: 'flat',
147
+ root: path.slice(0, Math.max(0, path.lastIndexOf('/'))),
148
+ mainFile: basename(path),
149
+ files: [],
150
+ rawBase,
151
+ };
152
+ try {
153
+ entry.description = describe(parseSkillMarkdown(await fetchText(fileUrl(entry, entry.mainFile))));
154
+ }
155
+ catch {
156
+ // 同上
157
+ }
158
+ return entry;
159
+ })));
160
+ return entries;
161
+ }
162
+ /** 索引 JSON 源。 */
163
+ async function browseIndex(source) {
164
+ const doc = JSON.parse(await fetchText(source.url));
165
+ const list = Array.isArray(doc) ? doc : (doc.skills ?? doc.items);
166
+ if (!Array.isArray(list))
167
+ throw new Error('索引里找不到 skills 数组');
168
+ const dirUrl = source.url.replace(/[^/]*$/, '');
169
+ const entries = [];
170
+ for (const raw of list) {
171
+ if (raw === null || typeof raw !== 'object')
172
+ continue;
173
+ const item = raw;
174
+ const name = typeof item.name === 'string' ? item.name.trim() : '';
175
+ if (name === '')
176
+ continue;
177
+ const path = typeof item.path === 'string' && item.path !== '' ? item.path : `${name}/SKILL.md`;
178
+ const absolute = new URL(path, dirUrl).toString();
179
+ const isFlat = /\.md$/i.test(absolute);
180
+ entries.push({
181
+ name,
182
+ description: typeof item.description === 'string' ? item.description : '',
183
+ version: typeof item.version === 'string' ? item.version : undefined,
184
+ source: source.name,
185
+ kind: isFlat ? 'flat' : 'dir',
186
+ root: isFlat ? absolute.replace(/\/[^/]*$/, '') : absolute,
187
+ mainFile: basename(absolute),
188
+ files: Array.isArray(item.files)
189
+ ? item.files.filter((file) => typeof file === 'string')
190
+ : [],
191
+ });
192
+ }
193
+ return entries;
194
+ }
195
+ /** 描述行:有 when-to-use 就拼在后面,技能卡片一行放得下。 */
196
+ function describe(parsed) {
197
+ if (parsed.description === '')
198
+ return '(frontmatter 没写 description)';
199
+ return parsed.whenToUse === undefined
200
+ ? parsed.description
201
+ : `${parsed.description} · 何时用:${parsed.whenToUse}`;
202
+ }
203
+ function cachePath(url) {
204
+ return join(CACHE_DIR, `market-${createHash('sha1').update(url.trim()).digest('hex').slice(0, 16)}.json`);
205
+ }
206
+ /** 浏览一个源(1 小时内命中缓存不联网)。 */
207
+ export async function browseMarketSource(source, options = {}) {
208
+ const file = cachePath(source.url);
209
+ if (options.refresh !== true && existsSync(file)) {
210
+ try {
211
+ const doc = JSON.parse(readFileSync(file, 'utf8'));
212
+ if (typeof doc.at === 'number' && Date.now() - doc.at < CACHE_TTL_MS && Array.isArray(doc.entries)) {
213
+ return doc.entries;
214
+ }
215
+ }
216
+ catch {
217
+ // 缓存坏了就重新拉
218
+ }
219
+ }
220
+ const entries = /\.json(\?|$)/i.test(source.url.trim()) ? await browseIndex(source) : await browseGitHub(source);
221
+ mkdirSync(dirname(file), { recursive: true });
222
+ writeFileSync(file, JSON.stringify({ at: Date.now(), entries }), 'utf8');
223
+ return entries;
224
+ }
225
+ /** 拉取一个条目并写进技能目录;返回落盘位置与文件数。 */
226
+ export async function installMarketEntry(entry, destRoot) {
227
+ const target = join(destRoot, entry.kind === 'dir' ? entry.name : `${entry.name}.md`);
228
+ if (existsSync(target))
229
+ throw new Error(`本地已有 ${entry.name},先在技能中心删掉旧文件再装`);
230
+ const write = (relative) => fetchBytes(fileUrl(entry, relative)).then((bytes) => {
231
+ if (bytes.byteLength > MAX_FILE_BYTES)
232
+ return false;
233
+ const path = join(destRoot, entry.kind === 'dir' ? entry.name : '', relative);
234
+ mkdirSync(dirname(path), { recursive: true });
235
+ writeFileSync(path, bytes);
236
+ return true;
237
+ });
238
+ let written = (await write(entry.mainFile)) ? 1 : 0;
239
+ if (written === 0)
240
+ throw new Error(`拉取 ${entry.mainFile} 失败(文件超过 ${Math.round(MAX_FILE_BYTES / 1_048_576)} MB 上限)`);
241
+ if (entry.kind === 'dir') {
242
+ for (const relative of entry.files) {
243
+ try {
244
+ if (await write(relative))
245
+ written += 1;
246
+ }
247
+ catch {
248
+ // 附属文件取不到不阻塞安装:正文里引用的话本地会报找不到,用户可重装
249
+ }
250
+ }
251
+ }
252
+ return { target, files: written };
253
+ }
254
+ /** 内部条目 → UI 条目。 */
255
+ export function toMarketSkillView(entry, installedNames) {
256
+ return {
257
+ name: entry.name,
258
+ description: entry.description,
259
+ source: entry.source,
260
+ version: entry.version,
261
+ installed: installedNames.has(entry.name),
262
+ };
263
+ }
264
+ // ── T28:插件市场(外部插件的远程安装,机制照技能市场的两类源)────────────────
265
+ /**
266
+ * 浏览一个插件市场源,返回可安装的**单文件 .js 插件**条目:
267
+ * - GitHub 目录链接(`https://github.com/…/tree/<ref>/<dir>`):目录下(递归)的
268
+ * `*.js` blob 各算一个插件;
269
+ * - 索引 JSON(`.json` 结尾):`[{ "name", "file", "description?", "version?" }]`,
270
+ * file 缺省按 `<name>.js` 相对索引地址解析。
271
+ */
272
+ export async function browsePluginMarketSource(source) {
273
+ if (/\.json(\?|$)/i.test(source.url.trim())) {
274
+ const doc = JSON.parse(await fetchText(source.url));
275
+ const list = Array.isArray(doc) ? doc : (doc.plugins ?? doc.items);
276
+ if (!Array.isArray(list))
277
+ throw new Error('索引里找不到 plugins 数组');
278
+ const dirUrl = source.url.replace(/[^/]*$/, '');
279
+ const entries = [];
280
+ for (const raw of list) {
281
+ if (raw === null || typeof raw !== 'object')
282
+ continue;
283
+ const item = raw;
284
+ const name = typeof item.name === 'string' ? item.name.trim() : '';
285
+ if (name === '')
286
+ continue;
287
+ const path = typeof item.file === 'string' && item.file !== '' ? item.file : `${name}.js`;
288
+ const absolute = new URL(path, dirUrl).toString();
289
+ if (!absolute.endsWith('.js'))
290
+ continue;
291
+ entries.push({
292
+ name,
293
+ description: typeof item.description === 'string' ? item.description : '',
294
+ version: typeof item.version === 'string' ? item.version : undefined,
295
+ source: source.name,
296
+ kind: 'flat',
297
+ root: absolute.replace(/\/[^/]*$/, ''),
298
+ mainFile: basename(absolute),
299
+ files: [],
300
+ });
301
+ }
302
+ return entries;
303
+ }
304
+ const ref = parseGitHubTree(source.url);
305
+ if (ref === null) {
306
+ throw new Error('源地址既不是 GitHub 目录链接,也不是 .json 索引(形如 https://github.com/owner/repo/tree/main/plugins)');
307
+ }
308
+ const api = `https://api.github.com/repos/${ref.owner}/${ref.repo}/git/trees/${encodeURIComponent(ref.ref)}?recursive=1`;
309
+ const response = await fetch(api, {
310
+ headers: { accept: 'application/vnd.github+json', 'user-agent': 'dsc-plugin-market', ...githubHeaders() },
311
+ signal: AbortSignal.timeout(FETCH_TIMEOUT_MS),
312
+ });
313
+ if (!response.ok) {
314
+ if (response.status === 403 || response.status === 422) {
315
+ throw new Error(`GitHub API 拒绝(${response.status}):匿名限额较低,设置 GITHUB_TOKEN 后重试`);
316
+ }
317
+ throw new Error(`GitHub API ${response.status} ${response.statusText}(${api})`);
318
+ }
319
+ const payload = (await response.json());
320
+ const prefix = ref.dir === '' ? '' : `${ref.dir}/`;
321
+ const rawBase = `https://raw.githubusercontent.com/${ref.owner}/${ref.repo}/${ref.ref}`;
322
+ const entries = [];
323
+ for (const node of payload.tree ?? []) {
324
+ const path = node.path ?? '';
325
+ if (node.type !== 'blob' || !path.endsWith('.js'))
326
+ continue;
327
+ if (prefix !== '' && !path.startsWith(prefix))
328
+ continue;
329
+ if (node.size !== undefined && node.size > MAX_FILE_BYTES)
330
+ continue;
331
+ const relative = prefix === '' ? path : path.slice(prefix.length);
332
+ const name = basename(relative).replace(/\.js$/i, '');
333
+ entries.push({
334
+ name,
335
+ description: '远程插件(安装时整份拉取,装前会过审批)',
336
+ source: source.name,
337
+ kind: 'flat',
338
+ root: rawBase,
339
+ mainFile: relative,
340
+ files: [],
341
+ });
342
+ }
343
+ return entries.sort((a, b) => a.name.localeCompare(b.name));
344
+ }
345
+ /**
346
+ * 安装一个远程插件条目:只拉 mainFile(单文件 .js)写进目标目录,
347
+ * 返回落盘路径。热挂载由调用方(plugin-manager 插件)自己做。
348
+ */
349
+ export async function installPluginMarketEntry(entry, pluginsDir) {
350
+ const bytes = await fetchBytes(fileUrl(entry, entry.mainFile));
351
+ if (bytes.byteLength > MAX_FILE_BYTES) {
352
+ throw new Error(`插件文件超过 ${Math.round(MAX_FILE_BYTES / 1_048_576)} MB 上限`);
353
+ }
354
+ const target = join(pluginsDir, basename(entry.mainFile));
355
+ mkdirSync(pluginsDir, { recursive: true });
356
+ writeFileSync(target, bytes);
357
+ return target;
358
+ }