@waq666/pneuma 0.0.0-stage → 0.7.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (708) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +206 -3
  3. package/bin/dsc.js +91 -0
  4. package/bin/headless.cjs +40 -0
  5. package/lib/adapter/core-runtime.d.ts +11 -0
  6. package/lib/adapter/core-runtime.js +259 -0
  7. package/lib/adapter/host.d.ts +18 -0
  8. package/lib/adapter/host.js +14 -0
  9. package/lib/adapter/runtime.d.ts +15 -0
  10. package/lib/adapter/runtime.js +290 -0
  11. package/lib/adapter/transcript.d.ts +184 -0
  12. package/lib/adapter/transcript.js +605 -0
  13. package/lib/app/AgentsOverlay.d.ts +18 -0
  14. package/lib/app/AgentsOverlay.js +63 -0
  15. package/lib/app/App.d.ts +15 -0
  16. package/lib/app/App.js +1650 -0
  17. package/lib/app/App.js.nv-backup +1650 -0
  18. package/lib/app/ApprovalCard.d.ts +12 -0
  19. package/lib/app/ApprovalCard.js +76 -0
  20. package/lib/app/AskCard.d.ts +20 -0
  21. package/lib/app/AskCard.js +45 -0
  22. package/lib/app/ChatView.d.ts +63 -0
  23. package/lib/app/ChatView.js +310 -0
  24. package/lib/app/Composer.d.ts +50 -0
  25. package/lib/app/Composer.js +282 -0
  26. package/lib/app/DiffBlock.d.ts +6 -0
  27. package/lib/app/DiffBlock.js +37 -0
  28. package/lib/app/MarkdownView.d.ts +6 -0
  29. package/lib/app/MarkdownView.js +99 -0
  30. package/lib/app/ModelPicker.d.ts +7 -0
  31. package/lib/app/ModelPicker.js +18 -0
  32. package/lib/app/PlanReviewCard.d.ts +13 -0
  33. package/lib/app/PlanReviewCard.js +54 -0
  34. package/lib/app/PresetPicker.d.ts +11 -0
  35. package/lib/app/PresetPicker.js +19 -0
  36. package/lib/app/PreviewOverlay.d.ts +14 -0
  37. package/lib/app/PreviewOverlay.js +22 -0
  38. package/lib/app/SessionPicker.d.ts +43 -0
  39. package/lib/app/SessionPicker.js +56 -0
  40. package/lib/app/SettingsOverlay.d.ts +32 -0
  41. package/lib/app/SettingsOverlay.js +157 -0
  42. package/lib/app/SkillsPicker.d.ts +7 -0
  43. package/lib/app/SkillsPicker.js +19 -0
  44. package/lib/app/StatusBar.d.ts +22 -0
  45. package/lib/app/StatusBar.js +201 -0
  46. package/lib/app/TaskStrips.d.ts +13 -0
  47. package/lib/app/TaskStrips.js +40 -0
  48. package/lib/app/TimelineRail.d.ts +22 -0
  49. package/lib/app/TimelineRail.js +160 -0
  50. package/lib/app/TimelineRail.js.negbak +98 -0
  51. package/lib/app/TimelineRail.js.nv-backup +160 -0
  52. package/lib/app/ToolCard.d.ts +11 -0
  53. package/lib/app/ToolCard.js +64 -0
  54. package/lib/app/ToolCard.js.nv-backup +64 -0
  55. package/lib/app/TranscriptOverlay.d.ts +27 -0
  56. package/lib/app/TranscriptOverlay.js +36 -0
  57. package/lib/app/TranscriptViewport.d.ts +78 -0
  58. package/lib/app/TranscriptViewport.js +218 -0
  59. package/lib/app/Welcome.d.ts +6 -0
  60. package/lib/app/Welcome.js +71 -0
  61. package/lib/app/attach.d.ts +16 -0
  62. package/lib/app/attach.js +58 -0
  63. package/lib/app/click.d.ts +40 -0
  64. package/lib/app/click.js +103 -0
  65. package/lib/app/clipboard-image.d.ts +11 -0
  66. package/lib/app/clipboard-image.js +66 -0
  67. package/lib/app/cursor.d.ts +4 -0
  68. package/lib/app/cursor.js +24 -0
  69. package/lib/app/hello.d.ts +11 -0
  70. package/lib/app/hello.js +8 -0
  71. package/lib/app/history-store.d.ts +4 -0
  72. package/lib/app/history-store.js +41 -0
  73. package/lib/app/image-blocks.d.ts +12 -0
  74. package/lib/app/image-blocks.js +125 -0
  75. package/lib/app/keymap.d.ts +56 -0
  76. package/lib/app/keymap.js +56 -0
  77. package/lib/app/markdown.d.ts +54 -0
  78. package/lib/app/markdown.js +189 -0
  79. package/lib/app/mouse.d.ts +33 -0
  80. package/lib/app/mouse.js +35 -0
  81. package/lib/app/pointer.d.ts +16 -0
  82. package/lib/app/pointer.js +60 -0
  83. package/lib/app/scroll-model.d.ts +240 -0
  84. package/lib/app/scroll-model.js +347 -0
  85. package/lib/app/settings-model.d.ts +69 -0
  86. package/lib/app/settings-model.js +114 -0
  87. package/lib/app/snapshot-subscribe.d.ts +34 -0
  88. package/lib/app/snapshot-subscribe.js +110 -0
  89. package/lib/app/theme.d.ts +194 -0
  90. package/lib/app/theme.js +186 -0
  91. package/lib/app/ticker.d.ts +7 -0
  92. package/lib/app/ticker.js +53 -0
  93. package/lib/boot.d.ts +1 -0
  94. package/lib/boot.js +34 -0
  95. package/lib/commands.d.ts +49 -0
  96. package/lib/commands.js +115 -0
  97. package/lib/contract.d.ts +1973 -0
  98. package/lib/contract.js +36 -0
  99. package/lib/core/agent-roles.d.ts +52 -0
  100. package/lib/core/agent-roles.js +274 -0
  101. package/lib/core/approval-floor.d.ts +183 -0
  102. package/lib/core/approval-floor.js +679 -0
  103. package/lib/core/approval.d.ts +42 -0
  104. package/lib/core/approval.js +8 -0
  105. package/lib/core/audit.d.ts +61 -0
  106. package/lib/core/audit.js +59 -0
  107. package/lib/core/boot-notices.d.ts +6 -0
  108. package/lib/core/boot-notices.js +61 -0
  109. package/lib/core/cdp/actions.d.ts +182 -0
  110. package/lib/core/cdp/actions.js +649 -0
  111. package/lib/core/cdp/launch.d.ts +192 -0
  112. package/lib/core/cdp/launch.js +491 -0
  113. package/lib/core/cdp/snapshot.d.ts +139 -0
  114. package/lib/core/cdp/snapshot.js +316 -0
  115. package/lib/core/cdp/transport.d.ts +160 -0
  116. package/lib/core/cdp/transport.js +359 -0
  117. package/lib/core/command-policy.d.ts +108 -0
  118. package/lib/core/command-policy.js +580 -0
  119. package/lib/core/commands-completion.d.ts +78 -0
  120. package/lib/core/commands-completion.js +167 -0
  121. package/lib/core/compact-anchors.d.ts +76 -0
  122. package/lib/core/compact-anchors.js +284 -0
  123. package/lib/core/compact.d.ts +110 -0
  124. package/lib/core/compact.js +210 -0
  125. package/lib/core/config-store.d.ts +38 -0
  126. package/lib/core/config-store.js +307 -0
  127. package/lib/core/config.d.ts +36 -0
  128. package/lib/core/config.js +124 -0
  129. package/lib/core/connection-test.d.ts +60 -0
  130. package/lib/core/connection-test.js +84 -0
  131. package/lib/core/desktop-control.d.ts +298 -0
  132. package/lib/core/desktop-control.js +1311 -0
  133. package/lib/core/diff-text.d.ts +74 -0
  134. package/lib/core/diff-text.js +257 -0
  135. package/lib/core/dock-browser.d.ts +137 -0
  136. package/lib/core/dock-browser.js +146 -0
  137. package/lib/core/dock-ops.d.ts +59 -0
  138. package/lib/core/dock-ops.js +104 -0
  139. package/lib/core/dock-session.d.ts +39 -0
  140. package/lib/core/dock-session.js +28 -0
  141. package/lib/core/dsh-compat/hook.d.ts +18 -0
  142. package/lib/core/dsh-compat/hook.js +52 -0
  143. package/lib/core/dsh-compat/resolve-hook.d.ts +5 -0
  144. package/lib/core/dsh-compat/resolve-hook.js +59 -0
  145. package/lib/core/dsh-compat/tools-facade.d.ts +47 -0
  146. package/lib/core/dsh-compat/tools-facade.js +108 -0
  147. package/lib/core/err-text.d.ts +13 -0
  148. package/lib/core/err-text.js +15 -0
  149. package/lib/core/events.d.ts +149 -0
  150. package/lib/core/events.js +1 -0
  151. package/lib/core/git-exec.d.ts +23 -0
  152. package/lib/core/git-exec.js +72 -0
  153. package/lib/core/git-info.d.ts +47 -0
  154. package/lib/core/git-info.js +157 -0
  155. package/lib/core/goal.d.ts +89 -0
  156. package/lib/core/goal.js +189 -0
  157. package/lib/core/hooks.d.ts +272 -0
  158. package/lib/core/hooks.js +818 -0
  159. package/lib/core/host-browser-link.d.ts +59 -0
  160. package/lib/core/host-browser-link.js +9 -0
  161. package/lib/core/host-methods.d.ts +25 -0
  162. package/lib/core/host-methods.js +103 -0
  163. package/lib/core/image-diet.d.ts +77 -0
  164. package/lib/core/image-diet.js +127 -0
  165. package/lib/core/learnings/ledger.d.ts +73 -0
  166. package/lib/core/learnings/ledger.js +273 -0
  167. package/lib/core/learnings/skill-write.d.ts +250 -0
  168. package/lib/core/learnings/skill-write.js +854 -0
  169. package/lib/core/learnings/store.d.ts +102 -0
  170. package/lib/core/learnings/store.js +266 -0
  171. package/lib/core/lifecycle-hooks.d.ts +189 -0
  172. package/lib/core/lifecycle-hooks.js +576 -0
  173. package/lib/core/llm.d.ts +283 -0
  174. package/lib/core/llm.js +565 -0
  175. package/lib/core/lockfile.d.ts +17 -0
  176. package/lib/core/lockfile.js +110 -0
  177. package/lib/core/loop.d.ts +185 -0
  178. package/lib/core/loop.js +587 -0
  179. package/lib/core/lsp/client.d.ts +189 -0
  180. package/lib/core/lsp/client.js +690 -0
  181. package/lib/core/lsp/framing.d.ts +84 -0
  182. package/lib/core/lsp/framing.js +181 -0
  183. package/lib/core/lsp/line-shift.d.ts +28 -0
  184. package/lib/core/lsp/line-shift.js +127 -0
  185. package/lib/core/lsp/manager.d.ts +93 -0
  186. package/lib/core/lsp/manager.js +418 -0
  187. package/lib/core/lsp/normalize.d.ts +32 -0
  188. package/lib/core/lsp/normalize.js +139 -0
  189. package/lib/core/lsp/servers.d.ts +106 -0
  190. package/lib/core/lsp/servers.js +352 -0
  191. package/lib/core/lsp/uri.d.ts +76 -0
  192. package/lib/core/lsp/uri.js +179 -0
  193. package/lib/core/market.d.ts +51 -0
  194. package/lib/core/market.js +358 -0
  195. package/lib/core/mcp.d.ts +201 -0
  196. package/lib/core/mcp.js +836 -0
  197. package/lib/core/memory-eval.d.ts +158 -0
  198. package/lib/core/memory-eval.js +215 -0
  199. package/lib/core/memory.d.ts +266 -0
  200. package/lib/core/memory.js +703 -0
  201. package/lib/core/mention.d.ts +57 -0
  202. package/lib/core/mention.js +129 -0
  203. package/lib/core/microcompact.d.ts +48 -0
  204. package/lib/core/microcompact.js +79 -0
  205. package/lib/core/migrate.d.ts +56 -0
  206. package/lib/core/migrate.js +134 -0
  207. package/lib/core/model-caps.d.ts +83 -0
  208. package/lib/core/model-caps.js +150 -0
  209. package/lib/core/model-discovery.d.ts +19 -0
  210. package/lib/core/model-discovery.js +69 -0
  211. package/lib/core/modes.d.ts +72 -0
  212. package/lib/core/modes.js +152 -0
  213. package/lib/core/native-bridge.d.ts +135 -0
  214. package/lib/core/native-bridge.js +563 -0
  215. package/lib/core/path-policy.d.ts +32 -0
  216. package/lib/core/path-policy.js +248 -0
  217. package/lib/core/permission-presets.d.ts +67 -0
  218. package/lib/core/permission-presets.js +75 -0
  219. package/lib/core/plugin-loader.d.ts +36 -0
  220. package/lib/core/plugin-loader.js +294 -0
  221. package/lib/core/plugin-registry.d.ts +113 -0
  222. package/lib/core/plugin-registry.js +256 -0
  223. package/lib/core/prefs.d.ts +82 -0
  224. package/lib/core/prefs.js +372 -0
  225. package/lib/core/presets.d.ts +80 -0
  226. package/lib/core/presets.js +373 -0
  227. package/lib/core/pricing.d.ts +90 -0
  228. package/lib/core/pricing.js +126 -0
  229. package/lib/core/prompt.d.ts +92 -0
  230. package/lib/core/prompt.js +339 -0
  231. package/lib/core/ptc.d.ts +66 -0
  232. package/lib/core/ptc.js +70 -0
  233. package/lib/core/remote/frames.d.ts +91 -0
  234. package/lib/core/remote/frames.js +174 -0
  235. package/lib/core/remote/notify.d.ts +54 -0
  236. package/lib/core/remote/notify.js +77 -0
  237. package/lib/core/remote/owner.d.ts +32 -0
  238. package/lib/core/remote/owner.js +75 -0
  239. package/lib/core/remote/pairing.d.ts +104 -0
  240. package/lib/core/remote/pairing.js +261 -0
  241. package/lib/core/remote/push.d.ts +80 -0
  242. package/lib/core/remote/push.js +222 -0
  243. package/lib/core/remote/store.d.ts +18 -0
  244. package/lib/core/remote/store.js +59 -0
  245. package/lib/core/remote/tickets.d.ts +20 -0
  246. package/lib/core/remote/tickets.js +49 -0
  247. package/lib/core/remote/uploads.d.ts +63 -0
  248. package/lib/core/remote/uploads.js +161 -0
  249. package/lib/core/request-attribution.d.ts +26 -0
  250. package/lib/core/request-attribution.js +86 -0
  251. package/lib/core/request-invariant.d.ts +61 -0
  252. package/lib/core/request-invariant.js +199 -0
  253. package/lib/core/sandbox/backends.d.ts +64 -0
  254. package/lib/core/sandbox/backends.js +194 -0
  255. package/lib/core/sandbox/execpolicy.d.ts +93 -0
  256. package/lib/core/sandbox/execpolicy.js +452 -0
  257. package/lib/core/sandbox/net-proxy.d.ts +31 -0
  258. package/lib/core/sandbox/net-proxy.js +162 -0
  259. package/lib/core/sandbox/policy.d.ts +211 -0
  260. package/lib/core/sandbox/policy.js +559 -0
  261. package/lib/core/sandbox/win/abi.d.ts +161 -0
  262. package/lib/core/sandbox/win/abi.js +169 -0
  263. package/lib/core/sandbox/win/account.d.ts +71 -0
  264. package/lib/core/sandbox/win/account.js +206 -0
  265. package/lib/core/sandbox/win/acl.d.ts +54 -0
  266. package/lib/core/sandbox/win/acl.js +339 -0
  267. package/lib/core/sandbox/win/backend.d.ts +61 -0
  268. package/lib/core/sandbox/win/backend.js +249 -0
  269. package/lib/core/sandbox/win/doctor.d.ts +24 -0
  270. package/lib/core/sandbox/win/doctor.js +272 -0
  271. package/lib/core/sandbox/win/ffi.d.ts +107 -0
  272. package/lib/core/sandbox/win/ffi.js +166 -0
  273. package/lib/core/sandbox/win/net-abi.d.ts +154 -0
  274. package/lib/core/sandbox/win/net-abi.js +316 -0
  275. package/lib/core/sandbox/win/runner-entry.d.ts +35 -0
  276. package/lib/core/sandbox/win/runner-entry.js +391 -0
  277. package/lib/core/sandbox/win/setup.d.ts +60 -0
  278. package/lib/core/sandbox/win/setup.js +986 -0
  279. package/lib/core/sandbox/win/token.d.ts +35 -0
  280. package/lib/core/sandbox/win/token.js +238 -0
  281. package/lib/core/sandbox/win/wfp.d.ts +41 -0
  282. package/lib/core/sandbox/win/wfp.js +200 -0
  283. package/lib/core/sandbox/win/workspace-sid.d.ts +9 -0
  284. package/lib/core/sandbox/win/workspace-sid.js +45 -0
  285. package/lib/core/schedule/rule.d.ts +184 -0
  286. package/lib/core/schedule/rule.js +745 -0
  287. package/lib/core/schedule/runner.d.ts +185 -0
  288. package/lib/core/schedule/runner.js +678 -0
  289. package/lib/core/schedule/store.d.ts +182 -0
  290. package/lib/core/schedule/store.js +455 -0
  291. package/lib/core/secrets.d.ts +41 -0
  292. package/lib/core/secrets.js +150 -0
  293. package/lib/core/session-export.d.ts +18 -0
  294. package/lib/core/session-export.js +73 -0
  295. package/lib/core/session-index.d.ts +159 -0
  296. package/lib/core/session-index.js +683 -0
  297. package/lib/core/session-meta.d.ts +41 -0
  298. package/lib/core/session-meta.js +97 -0
  299. package/lib/core/session.d.ts +356 -0
  300. package/lib/core/session.js +998 -0
  301. package/lib/core/skills.d.ts +60 -0
  302. package/lib/core/skills.js +171 -0
  303. package/lib/core/spill.d.ts +159 -0
  304. package/lib/core/spill.js +329 -0
  305. package/lib/core/surface-registry.d.ts +45 -0
  306. package/lib/core/surface-registry.js +67 -0
  307. package/lib/core/team-board.d.ts +95 -0
  308. package/lib/core/team-board.js +316 -0
  309. package/lib/core/throughput.d.ts +46 -0
  310. package/lib/core/throughput.js +40 -0
  311. package/lib/core/todo-reminder.d.ts +44 -0
  312. package/lib/core/todo-reminder.js +55 -0
  313. package/lib/core/todo.d.ts +81 -0
  314. package/lib/core/todo.js +222 -0
  315. package/lib/core/token-estimate.d.ts +55 -0
  316. package/lib/core/token-estimate.js +82 -0
  317. package/lib/core/tool-guards.d.ts +103 -0
  318. package/lib/core/tool-guards.js +77 -0
  319. package/lib/core/tool-search.d.ts +152 -0
  320. package/lib/core/tool-search.js +311 -0
  321. package/lib/core/tools/bash.d.ts +281 -0
  322. package/lib/core/tools/bash.js +871 -0
  323. package/lib/core/tools/command-runner.d.ts +84 -0
  324. package/lib/core/tools/command-runner.js +68 -0
  325. package/lib/core/tools/fs-tools.d.ts +23 -0
  326. package/lib/core/tools/fs-tools.js +247 -0
  327. package/lib/core/tools/index.d.ts +8 -0
  328. package/lib/core/tools/index.js +4 -0
  329. package/lib/core/tools/sandbox-args.d.ts +51 -0
  330. package/lib/core/tools/sandbox-args.js +90 -0
  331. package/lib/core/tools/search-tools.d.ts +3 -0
  332. package/lib/core/tools/search-tools.js +153 -0
  333. package/lib/core/tools.d.ts +96 -0
  334. package/lib/core/tools.js +53 -0
  335. package/lib/core/ui-boot-source.d.ts +71 -0
  336. package/lib/core/ui-boot-source.js +121 -0
  337. package/lib/core/ui-bundles.d.ts +249 -0
  338. package/lib/core/ui-bundles.js +830 -0
  339. package/lib/core/ui-combo.d.ts +49 -0
  340. package/lib/core/ui-combo.js +55 -0
  341. package/lib/core/ui-events.d.ts +81 -0
  342. package/lib/core/ui-events.js +364 -0
  343. package/lib/core/ui-hmr.d.ts +36 -0
  344. package/lib/core/ui-hmr.js +128 -0
  345. package/lib/core/ui-methods.d.ts +69 -0
  346. package/lib/core/ui-methods.js +341 -0
  347. package/lib/core/ui-route.d.ts +69 -0
  348. package/lib/core/ui-route.js +122 -0
  349. package/lib/core/ui-server.d.ts +75 -0
  350. package/lib/core/ui-server.js +369 -0
  351. package/lib/core/ui-trust.d.ts +47 -0
  352. package/lib/core/ui-trust.js +164 -0
  353. package/lib/core/untrusted.d.ts +30 -0
  354. package/lib/core/untrusted.js +48 -0
  355. package/lib/core/update-check.d.ts +81 -0
  356. package/lib/core/update-check.js +177 -0
  357. package/lib/core/usage-log.d.ts +82 -0
  358. package/lib/core/usage-log.js +306 -0
  359. package/lib/core/version.d.ts +1 -0
  360. package/lib/core/version.js +37 -0
  361. package/lib/core/web-http.d.ts +57 -0
  362. package/lib/core/web-http.js +137 -0
  363. package/lib/core/web-static.d.ts +31 -0
  364. package/lib/core/web-static.js +75 -0
  365. package/lib/headless.d.ts +1 -0
  366. package/lib/headless.js +31 -0
  367. package/lib/host/kernel.d.ts +33 -0
  368. package/lib/host/kernel.js +451 -0
  369. package/lib/index.d.ts +41 -0
  370. package/lib/index.js +35 -0
  371. package/lib/plugins/agent.d.ts +2 -0
  372. package/lib/plugins/agent.js +274 -0
  373. package/lib/plugins/approval-floor.d.ts +2 -0
  374. package/lib/plugins/approval-floor.js +223 -0
  375. package/lib/plugins/approval.d.ts +16 -0
  376. package/lib/plugins/approval.js +674 -0
  377. package/lib/plugins/ask.d.ts +2 -0
  378. package/lib/plugins/ask.js +245 -0
  379. package/lib/plugins/browser.d.ts +68 -0
  380. package/lib/plugins/browser.js +1341 -0
  381. package/lib/plugins/commands.d.ts +23 -0
  382. package/lib/plugins/commands.js +498 -0
  383. package/lib/plugins/compact.d.ts +21 -0
  384. package/lib/plugins/compact.js +274 -0
  385. package/lib/plugins/computer-use.d.ts +47 -0
  386. package/lib/plugins/computer-use.js +539 -0
  387. package/lib/plugins/desktop-dock.d.ts +2 -0
  388. package/lib/plugins/desktop-dock.js +626 -0
  389. package/lib/plugins/dock-browser.d.ts +34 -0
  390. package/lib/plugins/dock-browser.js +765 -0
  391. package/lib/plugins/dsh-compat.d.ts +25 -0
  392. package/lib/plugins/dsh-compat.js +37 -0
  393. package/lib/plugins/file-review.d.ts +108 -0
  394. package/lib/plugins/file-review.js +393 -0
  395. package/lib/plugins/git.d.ts +26 -0
  396. package/lib/plugins/git.js +132 -0
  397. package/lib/plugins/goal.d.ts +20 -0
  398. package/lib/plugins/goal.js +245 -0
  399. package/lib/plugins/guards.d.ts +14 -0
  400. package/lib/plugins/guards.js +18 -0
  401. package/lib/plugins/hooks.d.ts +19 -0
  402. package/lib/plugins/hooks.js +583 -0
  403. package/lib/plugins/host-stdio.d.ts +88 -0
  404. package/lib/plugins/host-stdio.js +317 -0
  405. package/lib/plugins/image-diet.d.ts +17 -0
  406. package/lib/plugins/image-diet.js +85 -0
  407. package/lib/plugins/lifecycle-hooks.d.ts +26 -0
  408. package/lib/plugins/lifecycle-hooks.js +338 -0
  409. package/lib/plugins/llm.d.ts +13 -0
  410. package/lib/plugins/llm.js +215 -0
  411. package/lib/plugins/lsp.d.ts +54 -0
  412. package/lib/plugins/lsp.js +608 -0
  413. package/lib/plugins/mcp.d.ts +16 -0
  414. package/lib/plugins/mcp.js +673 -0
  415. package/lib/plugins/memory.d.ts +17 -0
  416. package/lib/plugins/memory.js +858 -0
  417. package/lib/plugins/microcompact.d.ts +18 -0
  418. package/lib/plugins/microcompact.js +119 -0
  419. package/lib/plugins/mode.d.ts +18 -0
  420. package/lib/plugins/mode.js +115 -0
  421. package/lib/plugins/permission-presets.d.ts +18 -0
  422. package/lib/plugins/permission-presets.js +135 -0
  423. package/lib/plugins/plan.d.ts +2 -0
  424. package/lib/plugins/plan.js +192 -0
  425. package/lib/plugins/plugin-manager.d.ts +2 -0
  426. package/lib/plugins/plugin-manager.js +165 -0
  427. package/lib/plugins/presets.d.ts +2 -0
  428. package/lib/plugins/presets.js +182 -0
  429. package/lib/plugins/prompt.d.ts +2 -0
  430. package/lib/plugins/prompt.js +264 -0
  431. package/lib/plugins/ptc.d.ts +2 -0
  432. package/lib/plugins/ptc.js +272 -0
  433. package/lib/plugins/remote/http.d.ts +11 -0
  434. package/lib/plugins/remote/http.js +11 -0
  435. package/lib/plugins/remote/routes.d.ts +24 -0
  436. package/lib/plugins/remote/routes.js +384 -0
  437. package/lib/plugins/remote/types.d.ts +135 -0
  438. package/lib/plugins/remote/types.js +87 -0
  439. package/lib/plugins/remote.d.ts +17 -0
  440. package/lib/plugins/remote.js +1028 -0
  441. package/lib/plugins/runtime-api.d.ts +16 -0
  442. package/lib/plugins/runtime-api.js +99 -0
  443. package/lib/plugins/runtime.d.ts +10 -0
  444. package/lib/plugins/runtime.js +451 -0
  445. package/lib/plugins/sandbox.d.ts +2 -0
  446. package/lib/plugins/sandbox.js +761 -0
  447. package/lib/plugins/schedule.d.ts +26 -0
  448. package/lib/plugins/schedule.js +538 -0
  449. package/lib/plugins/self-improve.d.ts +61 -0
  450. package/lib/plugins/self-improve.js +953 -0
  451. package/lib/plugins/session-search.d.ts +16 -0
  452. package/lib/plugins/session-search.js +308 -0
  453. package/lib/plugins/session-title.d.ts +19 -0
  454. package/lib/plugins/session-title.js +109 -0
  455. package/lib/plugins/session.d.ts +7 -0
  456. package/lib/plugins/session.js +296 -0
  457. package/lib/plugins/settings.d.ts +3 -0
  458. package/lib/plugins/settings.js +705 -0
  459. package/lib/plugins/skills.d.ts +2 -0
  460. package/lib/plugins/skills.js +360 -0
  461. package/lib/plugins/spill.d.ts +16 -0
  462. package/lib/plugins/spill.js +200 -0
  463. package/lib/plugins/subagent.d.ts +2 -0
  464. package/lib/plugins/subagent.js +896 -0
  465. package/lib/plugins/surfaces.d.ts +11 -0
  466. package/lib/plugins/surfaces.js +20 -0
  467. package/lib/plugins/team.d.ts +16 -0
  468. package/lib/plugins/team.js +149 -0
  469. package/lib/plugins/todo.d.ts +19 -0
  470. package/lib/plugins/todo.js +188 -0
  471. package/lib/plugins/tool-search.d.ts +2 -0
  472. package/lib/plugins/tool-search.js +434 -0
  473. package/lib/plugins/tool-search.js.nv-backup +434 -0
  474. package/lib/plugins/tools-default.d.ts +12 -0
  475. package/lib/plugins/tools-default.js +275 -0
  476. package/lib/plugins/tools.d.ts +16 -0
  477. package/lib/plugins/tools.js +62 -0
  478. package/lib/plugins/transcript.d.ts +15 -0
  479. package/lib/plugins/transcript.js +311 -0
  480. package/lib/plugins/tui.d.ts +2 -0
  481. package/lib/plugins/tui.js +98 -0
  482. package/lib/plugins/waiting.d.ts +12 -0
  483. package/lib/plugins/waiting.js +34 -0
  484. package/lib/plugins/web-search.d.ts +14 -0
  485. package/lib/plugins/web-search.js +263 -0
  486. package/lib/plugins/webserver.d.ts +48 -0
  487. package/lib/plugins/webserver.js +228 -0
  488. package/lib/remote/assets/app-DAcUCOEn.js +14 -0
  489. package/lib/remote/assets/icon-192.png +0 -0
  490. package/lib/remote/assets/icon-512.png +0 -0
  491. package/lib/remote/assets/index.html +34 -0
  492. package/lib/remote/assets/manifest.json +27 -0
  493. package/lib/remote/assets/style-DIB6729x.css +1 -0
  494. package/lib/remote/assets/sw.js +66 -0
  495. package/lib/services/types.d.ts +1228 -0
  496. package/lib/services/types.js +1 -0
  497. package/lib/tools/config-cli.d.ts +1 -0
  498. package/lib/tools/config-cli.js +89 -0
  499. package/lib/ui/arrival.d.ts +72 -0
  500. package/lib/ui/arrival.js +105 -0
  501. package/lib/ui/assets/app-B70nVIKd.js +69 -0
  502. package/lib/ui/assets/chunk-2UxHyX5q.js +1 -0
  503. package/lib/ui/assets/chunk-B1dDrJ26.js +1 -0
  504. package/lib/ui/assets/chunk-B6aJPvgy.js +1 -0
  505. package/lib/ui/assets/chunk-BEwlwnbL.js +1 -0
  506. package/lib/ui/assets/chunk-BGcgwlCI.js +12 -0
  507. package/lib/ui/assets/chunk-BIGW1oBm.js +1 -0
  508. package/lib/ui/assets/chunk-BPQ3VLAy.js +1 -0
  509. package/lib/ui/assets/chunk-BRH0KZbk.js +141 -0
  510. package/lib/ui/assets/chunk-BX6H_ySx.js +1 -0
  511. package/lib/ui/assets/chunk-B_P3UbPa.js +1 -0
  512. package/lib/ui/assets/chunk-B_TYUkTI.js +1 -0
  513. package/lib/ui/assets/chunk-B_vNuMnf.js +1 -0
  514. package/lib/ui/assets/chunk-BajyYBss.js +10 -0
  515. package/lib/ui/assets/chunk-BdnUsdx6.js +1 -0
  516. package/lib/ui/assets/chunk-Buea-lGh.js +1 -0
  517. package/lib/ui/assets/chunk-C0PvZCCE.js +1 -0
  518. package/lib/ui/assets/chunk-C0m74zRD.js +1 -0
  519. package/lib/ui/assets/chunk-C27-OAKa.js +1 -0
  520. package/lib/ui/assets/chunk-C2oV4EkX.js +1 -0
  521. package/lib/ui/assets/chunk-C7zT0LnQ.js +1 -0
  522. package/lib/ui/assets/chunk-C9GSunVT.js +1 -0
  523. package/lib/ui/assets/chunk-C9tS-k6U.js +1 -0
  524. package/lib/ui/assets/chunk-CHLpvVh8.js +1 -0
  525. package/lib/ui/assets/chunk-CLxacb5B.js +1 -0
  526. package/lib/ui/assets/chunk-COt5Ahok.js +1 -0
  527. package/lib/ui/assets/chunk-CPTIWCL2.js +1 -0
  528. package/lib/ui/assets/chunk-CQLl-L-p.js +1 -0
  529. package/lib/ui/assets/chunk-CUWRgxuq.js +55 -0
  530. package/lib/ui/assets/chunk-CWanVSXC.js +1 -0
  531. package/lib/ui/assets/chunk-Cf5RLm7j.js +1 -0
  532. package/lib/ui/assets/chunk-CickPsom.js +1 -0
  533. package/lib/ui/assets/chunk-Cj5Yp3dK.js +1 -0
  534. package/lib/ui/assets/chunk-Cmh6b_Ma.js +1 -0
  535. package/lib/ui/assets/chunk-Cp-IABpG.js +1 -0
  536. package/lib/ui/assets/chunk-CqE71os6.js +1 -0
  537. package/lib/ui/assets/chunk-CtKP3W-j.js +1 -0
  538. package/lib/ui/assets/chunk-Cvjx9yec.js +1 -0
  539. package/lib/ui/assets/chunk-CxGP3dtY.js +1 -0
  540. package/lib/ui/assets/chunk-CylS5w8V.js +1 -0
  541. package/lib/ui/assets/chunk-D38fbIBN.js +1 -0
  542. package/lib/ui/assets/chunk-D97Zzqfu.js +1 -0
  543. package/lib/ui/assets/chunk-DAi9KRSo.js +1 -0
  544. package/lib/ui/assets/chunk-DHK4yRfg.js +1 -0
  545. package/lib/ui/assets/chunk-DJeabLx-.js +1 -0
  546. package/lib/ui/assets/chunk-DNRxmY5a.js +1 -0
  547. package/lib/ui/assets/chunk-DNSN1z5r.js +1 -0
  548. package/lib/ui/assets/chunk-DNasK_ZG.js +1 -0
  549. package/lib/ui/assets/chunk-DPvrY3IQ.js +1 -0
  550. package/lib/ui/assets/chunk-DXmwc3jG.js +1 -0
  551. package/lib/ui/assets/chunk-Dd0kTxKP.js +1 -0
  552. package/lib/ui/assets/chunk-De0Btta0.js +1 -0
  553. package/lib/ui/assets/chunk-Des-eS-w.js +1 -0
  554. package/lib/ui/assets/chunk-Df6bDoY_.js +1 -0
  555. package/lib/ui/assets/chunk-DijEV5ha.js +1 -0
  556. package/lib/ui/assets/chunk-DkvoVjww.js +1 -0
  557. package/lib/ui/assets/chunk-DlC-OlHO.js +1 -0
  558. package/lib/ui/assets/chunk-DnzrXTVv.js +1 -0
  559. package/lib/ui/assets/chunk-Dualf0xi.js +1 -0
  560. package/lib/ui/assets/chunk-EXT84bkm.js +1 -0
  561. package/lib/ui/assets/chunk-GwR3hkPK.js +1 -0
  562. package/lib/ui/assets/chunk-P80f7IUj.js +1 -0
  563. package/lib/ui/assets/chunk-VOosw3JB.js +1 -0
  564. package/lib/ui/assets/chunk-YQ4lDkt_.js +140 -0
  565. package/lib/ui/assets/chunk-Yzrsuije.js +1 -0
  566. package/lib/ui/assets/chunk-Z72CF80r.js +1 -0
  567. package/lib/ui/assets/chunk-g9-lgVsj.js +1 -0
  568. package/lib/ui/assets/chunk-vGWfd6FD.js +1 -0
  569. package/lib/ui/assets/chunk-wDzz0qaB.js +1 -0
  570. package/lib/ui/assets/chunk-ySF7HWmS.js +1 -0
  571. package/lib/ui/assets/icon.png +0 -0
  572. package/lib/ui/assets/index.html +14 -0
  573. package/lib/ui/assets/pdf.worker.min-CjEcRF4W.mjs +28 -0
  574. package/lib/ui/assets/style-Bq01xH_b.css +1 -0
  575. package/lib/ui/frames.d.ts +67 -0
  576. package/lib/ui/frames.js +146 -0
  577. package/lib/ui/index.d.ts +59 -0
  578. package/lib/ui/index.js +50 -0
  579. package/lib/ui/manifest.d.ts +172 -0
  580. package/lib/ui/manifest.js +158 -0
  581. package/lib/ui/plugin.d.ts +161 -0
  582. package/lib/ui/plugin.js +7 -0
  583. package/lib/ui/plugins/browser/client.js +290 -0
  584. package/lib/ui/plugins/browser/icon.png +0 -0
  585. package/lib/ui/plugins/composer/client.js +1843 -0
  586. package/lib/ui/plugins/composer/icon.png +0 -0
  587. package/lib/ui/plugins/files/client.js +646 -0
  588. package/lib/ui/plugins/files/icon.png +0 -0
  589. package/lib/ui/plugins/manifest.json +107 -0
  590. package/lib/ui/plugins/plugins/client.js +682 -0
  591. package/lib/ui/plugins/plugins/icon.png +0 -0
  592. package/lib/ui/plugins/preview/client.js +197 -0
  593. package/lib/ui/plugins/preview/icon.png +0 -0
  594. package/lib/ui/plugins/prompt/client.js +653 -0
  595. package/lib/ui/plugins/prompt/icon.png +0 -0
  596. package/lib/ui/plugins/sessions/client.js +1577 -0
  597. package/lib/ui/plugins/sessions/icon.png +0 -0
  598. package/lib/ui/plugins/settings/client.js +5470 -0
  599. package/lib/ui/plugins/settings/icon.png +0 -0
  600. package/lib/ui/plugins/skills/client.js +485 -0
  601. package/lib/ui/plugins/skills/icon.png +0 -0
  602. package/lib/ui/plugins/status/client.js +1420 -0
  603. package/lib/ui/plugins/status/icon.png +0 -0
  604. package/lib/ui/plugins/statusbar/client.js +504 -0
  605. package/lib/ui/plugins/statusbar/icon.png +0 -0
  606. package/lib/ui/plugins/tasks/client.js +52 -0
  607. package/lib/ui/plugins/tasks/icon.png +0 -0
  608. package/lib/ui/plugins/team/client.js +527 -0
  609. package/lib/ui/plugins/team/icon.png +0 -0
  610. package/lib/ui/plugins/terminal/client.js +232 -0
  611. package/lib/ui/plugins/terminal/icon.png +0 -0
  612. package/lib/ui/plugins/trace/client.js +1376 -0
  613. package/lib/ui/plugins/trace/icon.png +0 -0
  614. package/lib/ui/plugins/transcript/client.js +2661 -0
  615. package/lib/ui/plugins/transcript/icon.png +0 -0
  616. package/lib/ui/scoped-slots.d.ts +20 -0
  617. package/lib/ui/scoped-slots.js +21 -0
  618. package/lib/ui/sdk/@dsc/ui/index.d.ts +242 -0
  619. package/lib/ui/sdk/@dsc/ui/package.json +16 -0
  620. package/lib/ui/sdk/@dsc/ui-core/contract.d.ts +1973 -0
  621. package/lib/ui/sdk/@dsc/ui-core/core/diff-text.d.ts +74 -0
  622. package/lib/ui/sdk/@dsc/ui-core/core/dock-browser.d.ts +137 -0
  623. package/lib/ui/sdk/@dsc/ui-core/core/dock-ops.d.ts +59 -0
  624. package/lib/ui/sdk/@dsc/ui-core/core/model-caps.d.ts +83 -0
  625. package/lib/ui/sdk/@dsc/ui-core/core/native-bridge.d.ts +135 -0
  626. package/lib/ui/sdk/@dsc/ui-core/core/token-estimate.d.ts +55 -0
  627. package/lib/ui/sdk/@dsc/ui-core/package.json +16 -0
  628. package/lib/ui/sdk/@dsc/ui-core/ui/arrival.d.ts +72 -0
  629. package/lib/ui/sdk/@dsc/ui-core/ui/frames.d.ts +67 -0
  630. package/lib/ui/sdk/@dsc/ui-core/ui/index.d.ts +59 -0
  631. package/lib/ui/sdk/@dsc/ui-core/ui/manifest.d.ts +172 -0
  632. package/lib/ui/sdk/@dsc/ui-core/ui/plugin.d.ts +161 -0
  633. package/lib/ui/sdk/@dsc/ui-core/ui/scoped-slots.d.ts +20 -0
  634. package/lib/ui/sdk/@dsc/ui-core/ui/services-react.d.ts +27 -0
  635. package/lib/ui/sdk/@dsc/ui-core/ui/services.d.ts +63 -0
  636. package/lib/ui/sdk/@dsc/ui-core/ui/slots-react.d.ts +28 -0
  637. package/lib/ui/sdk/@dsc/ui-core/ui/slots.d.ts +481 -0
  638. package/lib/ui/sdk/@dsc/ui-core/ui/store.d.ts +89 -0
  639. package/lib/ui/sdk/@dsc/ui-dockkit/dock-model.d.ts +238 -0
  640. package/lib/ui/sdk/@dsc/ui-dockkit/dock-state.d.ts +163 -0
  641. package/lib/ui/sdk/@dsc/ui-dockkit/dock.d.ts +24 -0
  642. package/lib/ui/sdk/@dsc/ui-dockkit/index.d.ts +15 -0
  643. package/lib/ui/sdk/@dsc/ui-dockkit/package.json +16 -0
  644. package/lib/ui/sdk/@dsc/ui-layout/app.d.ts +74 -0
  645. package/lib/ui/sdk/@dsc/ui-layout/appearance.d.ts +70 -0
  646. package/lib/ui/sdk/@dsc/ui-layout/host-channel.d.ts +112 -0
  647. package/lib/ui/sdk/@dsc/ui-layout/index.d.ts +34 -0
  648. package/lib/ui/sdk/@dsc/ui-layout/package.json +16 -0
  649. package/lib/ui/sdk/@dsc/ui-layout/page-state.d.ts +14 -0
  650. package/lib/ui/sdk/@dsc/ui-layout/review-pane.d.ts +21 -0
  651. package/lib/ui/sdk/@dsc/ui-layout/runtime-context.d.ts +44 -0
  652. package/lib/ui/sdk/@dsc/ui-layout/thread-view.d.ts +28 -0
  653. package/lib/ui/sdk/@dsc/ui-layout/update-button.d.ts +21 -0
  654. package/lib/ui/sdk/@dsc/ui-primitives/code-file-icon-artwork.d.ts +53 -0
  655. package/lib/ui/sdk/@dsc/ui-primitives/code-view.d.ts +15 -0
  656. package/lib/ui/sdk/@dsc/ui-primitives/compat.d.ts +27 -0
  657. package/lib/ui/sdk/@dsc/ui-primitives/completion-sound.d.ts +24 -0
  658. package/lib/ui/sdk/@dsc/ui-primitives/confirm.d.ts +33 -0
  659. package/lib/ui/sdk/@dsc/ui-primitives/css.d.ts +47 -0
  660. package/lib/ui/sdk/@dsc/ui-primitives/diff-rows.d.ts +20 -0
  661. package/lib/ui/sdk/@dsc/ui-primitives/file-icons.d.ts +38 -0
  662. package/lib/ui/sdk/@dsc/ui-primitives/file-type-classify.d.ts +66 -0
  663. package/lib/ui/sdk/@dsc/ui-primitives/file-type-icon.d.ts +57 -0
  664. package/lib/ui/sdk/@dsc/ui-primitives/highlight.d.ts +24 -0
  665. package/lib/ui/sdk/@dsc/ui-primitives/hover-delay.d.ts +17 -0
  666. package/lib/ui/sdk/@dsc/ui-primitives/icons.d.ts +109 -0
  667. package/lib/ui/sdk/@dsc/ui-primitives/index.d.ts +55 -0
  668. package/lib/ui/sdk/@dsc/ui-primitives/lang-table.d.ts +10 -0
  669. package/lib/ui/sdk/@dsc/ui-primitives/markdown.d.ts +20 -0
  670. package/lib/ui/sdk/@dsc/ui-primitives/native.d.ts +41 -0
  671. package/lib/ui/sdk/@dsc/ui-primitives/package.json +16 -0
  672. package/lib/ui/sdk/@dsc/ui-primitives/panels.d.ts +86 -0
  673. package/lib/ui/sdk/@dsc/ui-primitives/paths.d.ts +11 -0
  674. package/lib/ui/sdk/@dsc/ui-primitives/pdf-view.d.ts +13 -0
  675. package/lib/ui/sdk/@dsc/ui-primitives/plugin-text.d.ts +15 -0
  676. package/lib/ui/sdk/@dsc/ui-primitives/select.d.ts +35 -0
  677. package/lib/ui/sdk/@dsc/ui-primitives/table-view.d.ts +23 -0
  678. package/lib/ui/sdk/@dsc/ui-primitives/thread-resizer.d.ts +22 -0
  679. package/lib/ui/sdk/@dsc/ui-primitives/time.d.ts +33 -0
  680. package/lib/ui/sdk/@dsc/ui-primitives/toast.d.ts +16 -0
  681. package/lib/ui/sdk/@dsc/ui-primitives/tokens.d.ts +14 -0
  682. package/lib/ui/sdk/@dsc/ui-primitives/tool-args.d.ts +49 -0
  683. package/lib/ui/sdk/@dsc/ui-primitives/tool-summary.d.ts +64 -0
  684. package/lib/ui/sdk/@dsc/ui-renderer/boot.d.ts +121 -0
  685. package/lib/ui/sdk/@dsc/ui-renderer/hmr.d.ts +43 -0
  686. package/lib/ui/sdk/@dsc/ui-renderer/index.d.ts +20 -0
  687. package/lib/ui/sdk/@dsc/ui-renderer/package.json +16 -0
  688. package/lib/ui/sdk/@dsc/ui-slots/index.d.ts +19 -0
  689. package/lib/ui/sdk/@dsc/ui-slots/package.json +16 -0
  690. package/lib/ui/sdk/@dsc/ui-slots/slots-react.d.ts +48 -0
  691. package/lib/ui/sdk/@dsc/ui-slots/slots.d.ts +102 -0
  692. package/lib/ui/services-react.d.ts +27 -0
  693. package/lib/ui/services-react.js +32 -0
  694. package/lib/ui/services.d.ts +63 -0
  695. package/lib/ui/services.js +121 -0
  696. package/lib/ui/slots-ink.d.ts +26 -0
  697. package/lib/ui/slots-ink.js +78 -0
  698. package/lib/ui/slots-react.d.ts +28 -0
  699. package/lib/ui/slots-react.js +88 -0
  700. package/lib/ui/slots.d.ts +481 -0
  701. package/lib/ui/slots.js +550 -0
  702. package/lib/ui/store.d.ts +89 -0
  703. package/lib/ui/store.js +62 -0
  704. package/lib/ui/tui-plugin-api.d.ts +23 -0
  705. package/lib/ui/tui-plugin-api.js +23 -0
  706. package/lib/ui/tui-plugins.d.ts +47 -0
  707. package/lib/ui/tui-plugins.js +220 -0
  708. package/package.json +58 -6
@@ -0,0 +1,690 @@
1
+ /**
2
+ * LSP 客户端:一个 (服务器, 项目根) 一个进程,外加该根的**串行队列**。
3
+ *
4
+ * ## 三个关键决定(都有教训在后面)
5
+ *
6
+ * 1. **文档同步走无状态路线**:每次查询「读盘 → `didOpen`(全量文本)→ 请求 → `didClose`」,
7
+ * 没有 `didChange`、不缓存文档。代价是每次多两个通知;换来的是**天然没有脏文档**——
8
+ * 模型刚用 `write`/`edit` 改完文件,语言服务器看到的必然是磁盘上那一刻的内容,
9
+ * 不存在「服务器手里还是旧版本,诊断和定位全是幽灵」这一类 bug(hermes 在
10
+ * `client.py` 顶部专门记过这个坑)。同一个 uri 的 `didOpen` 版本号单调递增,
11
+ * 这样上一轮迟到的 `publishDiagnostics` 能被认出来丢掉。
12
+ *
13
+ * 2. **握手只声明 utf-16**:`general.positionEncodings: ['utf-16']`。服务器回了别的编码
14
+ * (`utf-8` / `utf-32`)就直接失败——列偏移的算法完全不同(见 `uri.ts` 的模块注释),
15
+ * 悄悄按 utf-16 算只会把列定位错到别处。也不声明任何动态注册:本客户端不会处理
16
+ * `client/registerCapability` 之后的方法,声明了就是给自己挖坑。
17
+ *
18
+ * 3. **取消是「先礼后兵」**:请求超时或调用方中止时先发 `$/cancelRequest`;服务器不理会
19
+ * (宽限期后请求还挂着)就**杀掉整个实例**。因为那个请求还在服务器里跑,它随时会吐
20
+ * `publishDiagnostics` 或占着文档生命周期,留着它下一次查询的结果就说不清是谁的。
21
+ *
22
+ * 实例的池化与调度(idle 回收、串行队列、破键退避)在同目录 `manager.ts`;应答归并的
23
+ * 纯函数在 `normalize.ts`,诊断的行号对齐在 `line-shift.ts`——本文件只留「一个连接怎么
24
+ * 说话」:spawn、握手、JSON-RPC、请求超时取消、无状态文档生命周期。
25
+ *
26
+ * @module dsc/core/lsp/client
27
+ */
28
+ import { spawn } from 'node:child_process';
29
+ import { readFileSync } from 'node:fs';
30
+ import { MAX_MESSAGE_BYTES, MAX_STDERR_TAIL_BYTES, MessageDecoder, StderrTail, encodeMessage, } from './framing.js';
31
+ import { asRecord, normalizeDiagnostics, normalizeHover, normalizeLocations } from './normalize.js';
32
+ import { languageIdFor } from './servers.js';
33
+ import { pathToUri } from './uri.js';
34
+ /** 操作清单(工具 schema 的 enum 与自检共用一份)。 */
35
+ export const LSP_OPERATIONS = [
36
+ 'goToDefinition',
37
+ 'findReferences',
38
+ 'goToImplementation',
39
+ 'hover',
40
+ ];
41
+ /** 操作 → LSP 请求方法。 */
42
+ const REQUEST_METHOD = {
43
+ goToDefinition: 'textDocument/definition',
44
+ findReferences: 'textDocument/references',
45
+ goToImplementation: 'textDocument/implementation',
46
+ hover: 'textDocument/hover',
47
+ };
48
+ /** 操作 → 服务器 capabilities 里对应的字段(判定支不支持)。 */
49
+ const CAPABILITY_FIELD = {
50
+ goToDefinition: 'definitionProvider',
51
+ findReferences: 'referencesProvider',
52
+ goToImplementation: 'implementationProvider',
53
+ hover: 'hoverProvider',
54
+ };
55
+ /** 缺省预算。 */
56
+ export function defaultRuntimeValues() {
57
+ return {
58
+ requestTimeoutMs: 60_000,
59
+ initializeTimeoutMs: 30_000,
60
+ diagnosticsWaitMs: 8_000,
61
+ pushSettleMs: 150,
62
+ cancelGraceMs: 1_000,
63
+ shutdownGraceMs: 2_000,
64
+ brokenRetryMs: 5 * 60_000,
65
+ };
66
+ }
67
+ /** 查询/启动失败的分类:`fatal` 为真说明实例已经不能用了,要杀掉并按破键退避。 */
68
+ export class LspQueryError extends Error {
69
+ fatal;
70
+ stderr;
71
+ constructor(message, fatal, stderr) {
72
+ super(message);
73
+ this.fatal = fatal;
74
+ this.stderr = stderr;
75
+ this.name = 'LspQueryError';
76
+ }
77
+ }
78
+ /**
79
+ * 一个语言服务器进程上的 JSON-RPC 端点:id 配对、发请求/通知、回服务器的反向请求、
80
+ * 结账与强杀、stderr 尾巴。
81
+ */
82
+ class LspConnection {
83
+ options;
84
+ child;
85
+ decoder = new MessageDecoder(MAX_MESSAGE_BYTES);
86
+ tail = new StderrTail(MAX_STDERR_TAIL_BYTES);
87
+ pending = new Map();
88
+ nextId = 1;
89
+ /** 这条连接为什么废了(进程退出、管道写失败、取消没人理会……)。 */
90
+ closeReason;
91
+ killTimer;
92
+ exited = false;
93
+ closedPromise;
94
+ resolveClosed;
95
+ /** 服务器推来的诊断(按 uri 存最近一次)。 */
96
+ pushes = new Map();
97
+ pushListeners = new Set();
98
+ constructor(options) {
99
+ this.options = options;
100
+ this.closedPromise = new Promise((done) => {
101
+ this.resolveClosed = done;
102
+ });
103
+ const args = options.target.shell ? options.server.args.map(quoteForCmd) : options.server.args;
104
+ this.child = spawn(options.target.file, args, {
105
+ cwd: options.root,
106
+ env: options.env,
107
+ stdio: ['pipe', 'pipe', 'pipe'],
108
+ windowsHide: true,
109
+ shell: options.target.shell,
110
+ });
111
+ this.child.stdout?.on('data', (chunk) => {
112
+ this.onStdout(chunk);
113
+ });
114
+ this.child.stderr?.on('data', (chunk) => {
115
+ this.tail.push(chunk);
116
+ });
117
+ this.child.on('error', (error) => {
118
+ this.fail(new Error(`语言服务器进程起不来:${error.message}`));
119
+ this.finish();
120
+ });
121
+ // stdin 出错说明管道断了,紧跟着就是 exit;这里不重复报,交给 exit 那条路。
122
+ this.child.stdin?.on('error', () => { });
123
+ this.child.on('exit', (code, signal) => {
124
+ const tail = this.stderrTail();
125
+ const how = signal ?? (code === null ? '未知' : String(code));
126
+ // 尾巴单独挂在 LspQueryError.stderr 上,不要拼进 message:启动失败的原因由
127
+ // startFailure 按「消息 + stderr 尾巴」组装,并把 stderr 透传给调用方——
128
+ // 拼在 message 里,outcome 就丢了结构化的 stderr 字段,模型看不出为什么起不来。
129
+ this.fail(new LspQueryError(`语言服务器进程退出(${how})`, true, tail === '' ? undefined : tail));
130
+ this.finish();
131
+ });
132
+ }
133
+ /** 进程退没退(close 事件之后恒为 true)。 */
134
+ get failed() {
135
+ return this.closeReason !== undefined;
136
+ }
137
+ /** 进程已经退出的信号。 */
138
+ get closed() {
139
+ return this.closedPromise;
140
+ }
141
+ /** stderr 末尾 30 行(给模型的降级文案用)。 */
142
+ stderrTail() {
143
+ return this.tail.tailLines(30);
144
+ }
145
+ /**
146
+ * 发一条请求等结果。
147
+ *
148
+ * @param method - JSON-RPC 方法。
149
+ * @param params - 参数。
150
+ * @param signal - 调用方的取消信号(工具被中断时用它)。
151
+ * @param timeoutMs - 这次请求的预算。
152
+ */
153
+ request(method, params, signal, timeoutMs) {
154
+ const id = this.nextId;
155
+ this.nextId += 1;
156
+ return new Promise((resolveValue, rejectValue) => {
157
+ if (this.closeReason !== undefined) {
158
+ rejectValue(this.closeReason);
159
+ return;
160
+ }
161
+ const signals = [AbortSignal.timeout(timeoutMs)];
162
+ if (signal !== undefined)
163
+ signals.push(signal);
164
+ const gate = AbortSignal.any(signals);
165
+ let graceTimer;
166
+ const onAbort = () => {
167
+ if (!this.pending.has(id))
168
+ return;
169
+ const why = signal?.aborted === true
170
+ ? `LSP 请求被取消:${method}`
171
+ : `LSP 请求超过 ${timeoutMs}ms 没回:${method}`;
172
+ // 先礼:标准取消通知,认它的服务器会回一个 RequestCancelled 错误响应。
173
+ this.write({ jsonrpc: '2.0', method: '$/cancelRequest', params: { id } });
174
+ // 后兵:宽限期里还没结账,说明它不理会取消——连实例一起收掉。
175
+ graceTimer = setTimeout(() => {
176
+ if (!this.pending.has(id))
177
+ return;
178
+ this.fail(new Error(`${why};服务器没理会 $/cancelRequest,已把这个语言服务器收掉`));
179
+ this.terminate();
180
+ }, this.options.killGraceMs);
181
+ graceTimer.unref();
182
+ };
183
+ const entry = {
184
+ method,
185
+ settled: false,
186
+ settle: (error, value) => {
187
+ // 幂等闸门必须用本地标记,不能用「表里还有没有这条」:
188
+ // fail() 收掉整个实例时是先清空 pending 再逐个 settle(见下方 fail),
189
+ // 若在这里先 delete 再判返回值,批量结账的每一次都会因为表已空而提前返回,
190
+ // 挂着的请求就永远不落地——事件循环排空,进程直接以 code 13 退出。
191
+ if (entry.settled)
192
+ return;
193
+ entry.settled = true;
194
+ this.pending.delete(id);
195
+ gate.removeEventListener('abort', onAbort);
196
+ if (graceTimer !== undefined)
197
+ clearTimeout(graceTimer);
198
+ if (error === null)
199
+ resolveValue(value);
200
+ else
201
+ rejectValue(error);
202
+ },
203
+ };
204
+ this.pending.set(id, entry);
205
+ if (gate.aborted) {
206
+ onAbort();
207
+ return;
208
+ }
209
+ gate.addEventListener('abort', onAbort, { once: true });
210
+ this.write({ jsonrpc: '2.0', id, method, params });
211
+ });
212
+ }
213
+ /** 发一条通知(不等回应)。写失败就按连接废掉处理:后面的请求会以同样的原因失败。 */
214
+ notify(method, params) {
215
+ this.write({ jsonrpc: '2.0', method, params });
216
+ }
217
+ /** 挂一位诊断监听(用 `didOpen` 打开文档之后才注册,避开上一轮迟到的 push)。 */
218
+ onPush(listener) {
219
+ this.pushListeners.add(listener);
220
+ return () => {
221
+ this.pushListeners.delete(listener);
222
+ };
223
+ }
224
+ /** 最近一次 push(按 uri)。 */
225
+ latestPush(uri) {
226
+ return this.pushes.get(uri);
227
+ }
228
+ /** 清掉某个 uri 的旧 push(新一轮 didOpen 之前调用)。 */
229
+ forgetPush(uri) {
230
+ this.pushes.delete(uri);
231
+ }
232
+ /** 先 SIGTERM,宽限期内没退就 SIGKILL。幂等。 */
233
+ terminate() {
234
+ if (this.exited)
235
+ return;
236
+ const child = this.child;
237
+ try {
238
+ if (process.platform === 'win32')
239
+ child.kill();
240
+ else
241
+ child.kill('SIGTERM');
242
+ }
243
+ catch {
244
+ // 已经退了的进程再 kill 会抛,无害
245
+ }
246
+ if (this.exited)
247
+ return;
248
+ this.killTimer = setTimeout(() => {
249
+ if (this.exited)
250
+ return;
251
+ try {
252
+ child.kill('SIGKILL');
253
+ }
254
+ catch {
255
+ // 同上
256
+ }
257
+ }, this.options.killGraceMs);
258
+ this.killTimer.unref();
259
+ }
260
+ /** 记下致命原因并让所有挂着的请求当场结账。 */
261
+ fail(error) {
262
+ if (this.closeReason === undefined)
263
+ this.closeReason = error;
264
+ const waiting = [...this.pending.values()];
265
+ this.pending.clear();
266
+ for (const entry of waiting)
267
+ entry.settle(error);
268
+ }
269
+ finish() {
270
+ this.exited = true;
271
+ if (this.killTimer !== undefined) {
272
+ clearTimeout(this.killTimer);
273
+ this.killTimer = undefined;
274
+ }
275
+ this.pushListeners.clear();
276
+ const reason = this.closeReason?.message ?? '语言服务器进程结束';
277
+ this.options.onExit(reason);
278
+ this.resolveClosed?.();
279
+ }
280
+ write(message) {
281
+ if (this.closeReason !== undefined)
282
+ return;
283
+ const stdin = this.child.stdin;
284
+ if (stdin === null || stdin.destroyed) {
285
+ this.fail(new Error('语言服务器的输入口已经关了'));
286
+ return;
287
+ }
288
+ let framed;
289
+ try {
290
+ framed = encodeMessage(message);
291
+ }
292
+ catch (error) {
293
+ this.fail(error instanceof Error ? error : new Error(String(error)));
294
+ return;
295
+ }
296
+ stdin.write(framed, (error) => {
297
+ if (error !== null && error !== undefined)
298
+ this.fail(new Error(`往语言服务器写消息失败:${error.message}`));
299
+ });
300
+ }
301
+ onStdout(chunk) {
302
+ let messages;
303
+ try {
304
+ messages = this.decoder.push(chunk);
305
+ }
306
+ catch (error) {
307
+ // 分帧坏了以后流位置就再也对不上了:整条连接按废掉处理,把进程收掉。
308
+ this.fail(error instanceof Error ? error : new Error(String(error)));
309
+ this.terminate();
310
+ return;
311
+ }
312
+ for (const message of messages)
313
+ this.dispatch(message);
314
+ }
315
+ dispatch(message) {
316
+ const frame = asRecord(message);
317
+ if (frame === null)
318
+ return;
319
+ const method = frame.method;
320
+ const id = frame.id;
321
+ // 服务器发来的请求:得回一个响应,不然它可能一直等。
322
+ if (typeof method === 'string' && (typeof id === 'number' || typeof id === 'string')) {
323
+ this.answerServerRequest(id, method);
324
+ return;
325
+ }
326
+ if (typeof method === 'string') {
327
+ this.onNotification(method, frame.params);
328
+ return;
329
+ }
330
+ if (typeof id === 'number')
331
+ this.settleResponse(id, frame);
332
+ }
333
+ settleResponse(id, frame) {
334
+ const entry = this.pending.get(id);
335
+ if (entry === undefined)
336
+ return;
337
+ const error = asRecord(frame.error);
338
+ if (error !== null) {
339
+ const message = typeof error.message === 'string' ? error.message : '语言服务器报了错';
340
+ const code = typeof error.code === 'number' ? `(code ${error.code})` : '';
341
+ entry.settle(new Error(`${message}${code}`));
342
+ return;
343
+ }
344
+ entry.settle(null, frame.result);
345
+ }
346
+ onNotification(method, params) {
347
+ if (method !== 'textDocument/publishDiagnostics')
348
+ return;
349
+ const doc = asRecord(params);
350
+ const uri = typeof doc?.uri === 'string' ? doc.uri : undefined;
351
+ if (uri === undefined)
352
+ return;
353
+ const push = {
354
+ uri,
355
+ version: typeof doc?.version === 'number' ? doc.version : undefined,
356
+ items: normalizeDiagnostics(doc?.diagnostics),
357
+ };
358
+ this.pushes.set(uri, push);
359
+ for (const listener of [...this.pushListeners])
360
+ listener(push);
361
+ }
362
+ /**
363
+ * 回服务器的反向请求。本客户端**不声明动态注册**,所以这里只兜住几个必须应答的方法:
364
+ * 生命周期类回 null,`workspace/configuration` 回一无所知,`workspace/applyEdit` 直接拒
365
+ * (这个宿主从不替用户改文件)。
366
+ */
367
+ answerServerRequest(id, method) {
368
+ if (method === 'workspace/applyEdit') {
369
+ this.write({
370
+ jsonrpc: '2.0',
371
+ id,
372
+ error: { code: -32601, message: '本客户端不允许语言服务器直接改文件' },
373
+ });
374
+ return;
375
+ }
376
+ this.write({ jsonrpc: '2.0', id, result: null });
377
+ }
378
+ }
379
+ /** shell 那条路上参数由 cmd.exe 解析,带空格或元字符的要自己加引号(照 `core/mcp.ts`)。 */
380
+ function quoteForCmd(arg) {
381
+ return /[\s"&|<>^()]/.test(arg) ? `"${arg.replace(/"/g, '\\"')}"` : arg;
382
+ }
383
+ /** 一个已经握过手的语言服务器实例。串行化在管理器那一层(按 key 排队)。 */
384
+ export class LspInstance {
385
+ options;
386
+ connection;
387
+ capabilities = {};
388
+ /** 握手落地(失败就 reject);管理器等它一次,之后池子里的实例都是握过手的。 */
389
+ ready;
390
+ disposed = false;
391
+ /** 同一个 uri 的 didOpen 版本号:单调递增,用来认掉上一轮迟到的诊断。 */
392
+ docVersions = new Map();
393
+ waiter;
394
+ constructor(options) {
395
+ this.options = options;
396
+ this.connection = new LspConnection({
397
+ server: options.server,
398
+ target: options.target,
399
+ root: options.root,
400
+ env: options.env,
401
+ killGraceMs: options.values.cancelGraceMs,
402
+ onExit: options.onExit,
403
+ });
404
+ this.ready = this.initialize();
405
+ // 握手失败不能让它在第一个 await 之前变成未处理的 rejection。
406
+ this.ready.catch(() => { });
407
+ }
408
+ /** 进程退没退 / 有没有被废掉。 */
409
+ get dead() {
410
+ return this.disposed || this.connection.failed;
411
+ }
412
+ /** stderr 末尾 30 行(降级文案用)。 */
413
+ stderrTail() {
414
+ return this.connection.stderrTail();
415
+ }
416
+ async initialize() {
417
+ const result = await this.connection.request('initialize', {
418
+ // 不报宿主 PID:进程可能不在同一个命名空间里,报了只会让服务器去监控一个不相干的进程。
419
+ processId: null,
420
+ rootUri: pathToUri(this.options.root),
421
+ workspaceFolders: [{ uri: pathToUri(this.options.root), name: 'workspace' }],
422
+ capabilities: CLIENT_CAPABILITIES,
423
+ initializationOptions: null,
424
+ }, undefined, this.options.values.initializeTimeoutMs);
425
+ const caps = asRecord(asRecord(result)?.capabilities) ?? {};
426
+ // 缺省就是 utf-16;回别的编码直接失败——列偏移算法完全不同,不能将就。
427
+ const encoding = caps.positionEncoding;
428
+ if (encoding !== undefined && encoding !== 'utf-16') {
429
+ throw new LspQueryError(`服务器要用 ${String(encoding)} 位置编码,本客户端只支持 utf-16(列偏移按 UTF-16 码元算)`, true, this.connection.stderrTail());
430
+ }
431
+ this.capabilities = caps;
432
+ this.connection.notify('initialized', {});
433
+ }
434
+ /** 等握手落地;调用方的中止与握手超时都要能提前退出。 */
435
+ async awaitReady(signal) {
436
+ if (this.disposed)
437
+ throw new LspQueryError('这个语言服务器实例已经收掉了', true);
438
+ if (signal === undefined) {
439
+ await this.ready;
440
+ return;
441
+ }
442
+ if (signal.aborted)
443
+ throw new LspQueryError('LSP 请求被取消', false);
444
+ await Promise.race([
445
+ this.ready,
446
+ new Promise((_resolve, reject) => {
447
+ signal.addEventListener('abort', () => reject(new LspQueryError('LSP 请求被取消', true)), { once: true });
448
+ }),
449
+ ]);
450
+ }
451
+ /**
452
+ * 跑一次查询:读盘 → didOpen → 请求 → didClose。
453
+ *
454
+ * @param operation - 四个操作之一。
455
+ * @param filePath - 目标文件(绝对路径,调用方已确认存在)。
456
+ * @param position - 零基坐标。
457
+ * @param signal - 调用方的取消信号。
458
+ */
459
+ async query(operation, filePath, position, signal) {
460
+ await this.awaitReady(signal);
461
+ if (!supportsOperation(this.capabilities, operation)) {
462
+ throw new LspQueryError(`${this.options.server.id} 语言服务器没声明支持 ${operation}(capabilities 里没有 ${CAPABILITY_FIELD[operation]})`, false);
463
+ }
464
+ const uri = pathToUri(filePath);
465
+ const text = readText(filePath);
466
+ const version = this.nextVersion(uri);
467
+ this.connection.notify('textDocument/didOpen', {
468
+ textDocument: { uri, languageId: languageIdFor(this.options.server, filePath), version, text },
469
+ });
470
+ try {
471
+ const params = {
472
+ textDocument: { uri },
473
+ position: { line: position.line, character: position.character },
474
+ // findReferences 一律带上声明:调用方没有开关,影响面分析里「定义处」不能少。
475
+ ...(operation === 'findReferences' ? { context: { includeDeclaration: true } } : {}),
476
+ };
477
+ const payload = await this.connection.request(REQUEST_METHOD[operation], params, signal, this.options.values.requestTimeoutMs);
478
+ return operation === 'hover'
479
+ ? { kind: 'hover', hover: normalizeHover(payload) }
480
+ : { kind: 'locations', locations: normalizeLocations(payload) };
481
+ }
482
+ finally {
483
+ // 已经废掉的连接别再写:didClose 会和正在进行的收尾抢管道。
484
+ if (!this.dead)
485
+ this.connection.notify('textDocument/didClose', { textDocument: { uri } });
486
+ }
487
+ }
488
+ /**
489
+ * 取一个文件此刻的诊断。
490
+ *
491
+ * 两条路同时走:等 `publishDiagnostics` 推(多数服务器),以及(声明了 `diagnosticProvider`
492
+ * 时)主动 `textDocument/diagnostic` 拉。谁先给出非空结果就用谁,都没有就返回 null
493
+ * ——「服务器还没给结论」和「这个文件没问题」是两件不同的事,不能混。
494
+ *
495
+ * @param filePath - 绝对路径。
496
+ * @param content - 想让它看到的文本;缺省读盘(写前基线就靠这个参数喂写前的内容)。
497
+ * @param signal - 取消信号。
498
+ */
499
+ async diagnostics(filePath, content, signal) {
500
+ await this.awaitReady(signal);
501
+ const uri = pathToUri(filePath);
502
+ const text = content ?? readText(filePath);
503
+ const version = this.nextVersion(uri);
504
+ this.connection.forgetPush(uri);
505
+ this.dropWaiter();
506
+ this.connection.notify('textDocument/didOpen', {
507
+ textDocument: { uri, languageId: languageIdFor(this.options.server, filePath), version, text },
508
+ });
509
+ try {
510
+ const pushed = this.waitForPush(uri, version, signal);
511
+ const pulled = this.supportsPull() ? this.pullDiagnostics(uri, signal) : Promise.resolve(null);
512
+ const items = await firstNonNull([pushed, pulled]);
513
+ return items;
514
+ }
515
+ finally {
516
+ this.dropWaiter();
517
+ if (!this.dead)
518
+ this.connection.notify('textDocument/didClose', { textDocument: { uri } });
519
+ }
520
+ }
521
+ /** 服务器声明了拉模式诊断吗。 */
522
+ supportsPull() {
523
+ return this.capabilities.diagnosticProvider !== undefined && this.capabilities.diagnosticProvider !== null;
524
+ }
525
+ /** 主动拉一次文档诊断(服务器不支持/报错都当没有,不抛)。 */
526
+ async pullDiagnostics(uri, signal) {
527
+ try {
528
+ const result = await this.connection.request('textDocument/diagnostic', { textDocument: { uri } }, signal, this.options.values.diagnosticsWaitMs);
529
+ const doc = asRecord(result);
530
+ if (doc === null || !Array.isArray(doc.items))
531
+ return null;
532
+ return normalizeDiagnostics(doc.items);
533
+ }
534
+ catch {
535
+ return null;
536
+ }
537
+ }
538
+ /**
539
+ * 等这个 uri 的 push 诊断:等到第一条之后,再等 `pushSettleMs` 把分几次到的收齐。
540
+ * 版本比这次 didOpen 老的一律丢掉(那是上一轮迟到的推送)。
541
+ */
542
+ async waitForPush(uri, version, signal) {
543
+ return await new Promise((done) => {
544
+ let finished = false;
545
+ let settleTimer;
546
+ const timeoutTimer = setTimeout(() => finish(null), this.options.values.diagnosticsWaitMs);
547
+ timeoutTimer.unref();
548
+ const finish = (items) => {
549
+ if (finished)
550
+ return;
551
+ finished = true;
552
+ clearTimeout(timeoutTimer);
553
+ if (settleTimer !== undefined)
554
+ clearTimeout(settleTimer);
555
+ offPush();
556
+ signal?.removeEventListener('abort', onAbort);
557
+ if (this.waiter?.uri === uri)
558
+ this.waiter = undefined;
559
+ done(items);
560
+ };
561
+ const collect = () => {
562
+ if (finished)
563
+ return;
564
+ if (settleTimer !== undefined)
565
+ clearTimeout(settleTimer);
566
+ settleTimer = setTimeout(() => {
567
+ const latest = this.connection.latestPush(uri);
568
+ if (latest === undefined) {
569
+ finish(null);
570
+ return;
571
+ }
572
+ if (latest.version !== undefined && latest.version < version) {
573
+ finish(null);
574
+ return;
575
+ }
576
+ finish(latest.items);
577
+ }, this.options.values.pushSettleMs);
578
+ settleTimer.unref();
579
+ };
580
+ const onAbort = () => finish(null);
581
+ const offPush = this.connection.onPush((push) => {
582
+ if (push.uri !== uri)
583
+ return;
584
+ if (push.version !== undefined && push.version < version)
585
+ return;
586
+ collect();
587
+ });
588
+ this.waiter = { uri, cancel: () => finish(null) };
589
+ if (signal !== undefined) {
590
+ if (signal.aborted) {
591
+ finish(null);
592
+ return;
593
+ }
594
+ signal.addEventListener('abort', onAbort, { once: true });
595
+ }
596
+ });
597
+ }
598
+ /** 掐掉还挂着的等待(新一轮诊断之前调用)。 */
599
+ dropWaiter() {
600
+ const current = this.waiter;
601
+ this.waiter = undefined;
602
+ current?.cancel();
603
+ }
604
+ /** 这个 uri 的下一个 didOpen 版本号。 */
605
+ nextVersion(uri) {
606
+ const next = (this.docVersions.get(uri) ?? 0) + 1;
607
+ this.docVersions.set(uri, next);
608
+ return next;
609
+ }
610
+ /** 优雅收尾:shutdown → exit → (超时或失败就)强杀。 */
611
+ async shutdown() {
612
+ if (this.disposed)
613
+ return;
614
+ this.disposed = true;
615
+ try {
616
+ await this.connection.request('shutdown', null, undefined, this.options.values.shutdownGraceMs);
617
+ this.connection.notify('exit', null);
618
+ await Promise.race([
619
+ this.connection.closed,
620
+ new Promise((done) => {
621
+ const timer = setTimeout(done, this.options.values.shutdownGraceMs);
622
+ timer.unref();
623
+ }),
624
+ ]);
625
+ }
626
+ catch {
627
+ // 优雅收不掉(进程已经死了 / 不理会 shutdown)就走下面的强杀
628
+ }
629
+ this.connection.terminate();
630
+ this.docVersions.clear();
631
+ }
632
+ /** 立刻收(宿主退出、插件卸载时用,不等优雅流程)。 */
633
+ terminateNow() {
634
+ this.disposed = true;
635
+ this.connection.terminate();
636
+ }
637
+ }
638
+ /** 握手时声明的客户端能力:只声明 utf-16、hover markdown/plaintext、definition/implementation 的 linkSupport,不声明动态注册。 */
639
+ const CLIENT_CAPABILITIES = {
640
+ general: { positionEncodings: ['utf-16'] },
641
+ // workspace 这两项如实声明:服务器(pyright 之类)会来问 workspace/configuration,
642
+ // 我们一律回 null(见 answerServerRequest),比它自己去猜配置要好。
643
+ workspace: { workspaceFolders: true, configuration: true },
644
+ textDocument: {
645
+ synchronization: { dynamicRegistration: false },
646
+ hover: { contentFormat: ['markdown', 'plaintext'] },
647
+ definition: { linkSupport: true },
648
+ implementation: { linkSupport: true },
649
+ references: {},
650
+ },
651
+ };
652
+ // ── 连接/实例侧的小工具 ──────────────────────────────────────────────────────
653
+ /** 读文件为 UTF-16 字符串(LSP 的列偏移就是这个单位,见 uri.ts)。 */
654
+ function readText(filePath) {
655
+ return readFileSync(filePath, 'utf8');
656
+ }
657
+ /** 服务器声明的能力是不是「有」。 */
658
+ function supportsOperation(capabilities, operation) {
659
+ const value = capabilities[CAPABILITY_FIELD[operation]];
660
+ if (value === undefined || value === null || value === false)
661
+ return false;
662
+ return true;
663
+ }
664
+ /** 谁先给出非空结果就用谁;全是 null 才返回 null。 */
665
+ async function firstNonNull(sources) {
666
+ return await new Promise((done) => {
667
+ let remaining = sources.length;
668
+ let finished = false;
669
+ if (remaining === 0) {
670
+ done(null);
671
+ return;
672
+ }
673
+ for (const source of sources) {
674
+ void source.then((items) => {
675
+ remaining -= 1;
676
+ if (finished)
677
+ return;
678
+ if (items !== null) {
679
+ finished = true;
680
+ done(items);
681
+ return;
682
+ }
683
+ if (remaining === 0) {
684
+ finished = true;
685
+ done(null);
686
+ }
687
+ });
688
+ }
689
+ });
690
+ }