@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,608 @@
1
+ import { readFileSync } from 'node:fs';
2
+ import { wrapUntrusted } from '../core/untrusted.js';
3
+ import { resolvePluginConfig, writePluginConfig } from '../core/plugin-registry.js';
4
+ import { LSP_OPERATIONS, } from '../core/lsp/client.js';
5
+ import { LspManager } from '../core/lsp/manager.js';
6
+ import { buildLineShift, shiftDiagnostics } from '../core/lsp/line-shift.js';
7
+ import { diagnosticKey } from '../core/lsp/normalize.js';
8
+ import { BUILTIN_SERVERS, installHint, mergeServers, parseServerOverrides, } from '../core/lsp/servers.js';
9
+ import { displayPath, toDisplayCharacter, toDisplayLine, toProtocolPosition } from '../core/lsp/uri.js';
10
+ /** 插件在条目树里的键(设置分区 id 也是它)。 */
11
+ const CONFIG_KEY = 'lsp';
12
+ /** 单次结果条数上限的缺省与夹取范围。 */
13
+ const MAX_LOCATIONS_DEFAULT = 100;
14
+ const MAX_LOCATIONS_MIN = 1;
15
+ const MAX_LOCATIONS_MAX = 1000;
16
+ /** 单次结果字符上限(条数截断之后再截它)。 */
17
+ const MAX_RESULT_CHARS = 16_000;
18
+ /** idle 回收秒数的缺省与夹取范围(下限 30:比任何单次请求预算都长,免得杀到飞行中的查询)。 */
19
+ const IDLE_SECONDS_DEFAULT = 600;
20
+ const IDLE_SECONDS_MIN = 30;
21
+ const IDLE_SECONDS_MAX = 86_400;
22
+ /** 诊断块的三个上限(照 hermes 的 reporter:每文件 20 条、总 4000 字符、字段各自截断)。 */
23
+ const DIAGNOSTIC_MAX_PER_FILE = 20;
24
+ const DIAGNOSTIC_MAX_TOTAL_CHARS = 4_000;
25
+ const DIAGNOSTIC_MESSAGE_MAX = 300;
26
+ const DIAGNOSTIC_CODE_MAX = 80;
27
+ const DIAGNOSTIC_SOURCE_MAX = 80;
28
+ /** 诊断注入只报 ERROR(1)——WARN/INFO/HINT 全进上下文会把真正的报错淹掉。 */
29
+ const DIAGNOSTIC_ERROR_SEVERITY = 1;
30
+ /** 严重度文案(服务器没给 severity 时按 ERROR 算)。 */
31
+ const SEVERITY_NAMES = {
32
+ 1: 'ERROR',
33
+ 2: 'WARN',
34
+ 3: 'INFO',
35
+ 4: 'HINT',
36
+ };
37
+ /** 诊断注入盯的工具:只有这两个会改文件内容。 */
38
+ const WRITE_TOOLS = new Set(['write', 'edit']);
39
+ /** 不拦截(交给下一位守卫)。 */
40
+ const DEFER = { action: 'defer' };
41
+ /** 缺省值。 */
42
+ const DEFAULTS = {
43
+ enabled: true,
44
+ servers: '',
45
+ idleSeconds: IDLE_SECONDS_DEFAULT,
46
+ diagnostics: true,
47
+ maxLocations: MAX_LOCATIONS_DEFAULT,
48
+ };
49
+ export const lspPlugin = {
50
+ name: 'lsp',
51
+ inject: ['tools', 'settings', 'transcript', 'guards', 'prompt', 'session'],
52
+ apply(ctx, passed) {
53
+ /** 服务器表的解析缓存(key = 那一行 JSON 原文)。 */
54
+ let serversCache;
55
+ const manager = new LspManager({
56
+ servers: () => currentServers().defs,
57
+ idleTimeoutMs: () => readConfig(passed).idleSeconds * 1000,
58
+ // 解析「相对路径写的服务器命令」的基准:会话目录(拿进程目录既会把别的会话的
59
+ // 合法命令解析错,还会报出「PATH 里找不到」这种看着像环境问题的假故障)。
60
+ baseCwd: () => sessionCwd(),
61
+ });
62
+ /** 最近一次写操作留的底(观察者只能从这里知道写的是哪个文件)。 */
63
+ let lastWrite;
64
+ /** 攒着等下一次请求补进去的诊断块。 */
65
+ let pendingDiagnostics = [];
66
+ // ── 注册与退订 ──────────────────────────────────────────────────────────
67
+ // 宿主退出时只发事件就退进程,不走 cordis 卸载:子进程得在这一步收掉,
68
+ // 否则每退一次 dsc 就留一群语言服务器在后台(照 plugins/mcp.ts:151-155 的理由)。
69
+ const offExit = ctx.on('dsc/exit', () => {
70
+ manager.dispose();
71
+ });
72
+ const offTool = ctx.tools.register(buildTool());
73
+ const offGuard = ctx.guards.register({
74
+ id: 'lsp-observe',
75
+ // 排在协作模式(10)与审批(30)之前:这里只记一份写前留底,不做任何拦阻。
76
+ order: 7,
77
+ decide: (input) => captureBaseline(input),
78
+ });
79
+ const offObserver = ctx.guards.registerObserver(buildObserver());
80
+ // 诊断不在会话日志里,塞进请求的同时必须落一条 note(Model-visible ⟺ logged):
81
+ // 只投给主会话——队友的请求不走投影链,不会错拿主会话的 pending。
82
+ const offProjection = ctx.prompt.registerProjection('lsp-write-diagnostics', (messages) => {
83
+ if (pendingDiagnostics.length === 0)
84
+ return messages;
85
+ const blocks = pendingDiagnostics;
86
+ pendingDiagnostics = [];
87
+ // 补在末尾、user 角色(2026-10-03):原先补 system 段会被 fold-system 并进头部那一条,
88
+ // 头部字节一变,服务端前缀缓存从变化点之后整段失效(下一次请求诊断消失、头部还原,
89
+ // 再失效一次)。user 角色只往历史尾巴追加,前缀原样命中缓存——codex 的
90
+ // environment_context、dsh 的运行时快照都是这个形状;点明出处防模型误认作用户发言。
91
+ const text = `【LSP 诊断】以下诊断由程序在刚才写入文件后自动附上(不是用户发言):\n\n${blocks.join('\n\n')}`;
92
+ ctx.session.current().appendNote('lsp-write-diagnostics', text);
93
+ return [...messages, { role: 'user', content: text }];
94
+ });
95
+ const offSection = ctx.settings.registerSection(buildSection());
96
+ const offPrompt = ctx.prompt.register('lsp', () => {
97
+ if (!readConfig(passed).enabled)
98
+ return '';
99
+ return LSP_PROMPT_TEXT;
100
+ }, { order: 42 });
101
+ // 服务先挂上:晚一步就有人会读到 undefined。
102
+ const offService = ctx.provide('lsp', buildService());
103
+ return () => {
104
+ offExit();
105
+ offService();
106
+ offPrompt();
107
+ offSection();
108
+ offProjection();
109
+ offObserver();
110
+ offGuard();
111
+ offTool();
112
+ // 语言服务器子进程必须在这里收掉:不退就是一群孤儿进程。
113
+ manager.dispose();
114
+ };
115
+ // ── 配置与服务器表 ──────────────────────────────────────────────────────
116
+ /** 读配置:装配时传进来的那份作底,磁盘上那份覆盖它(改完设置不必重启宿主)。 */
117
+ function readConfig(raw) {
118
+ const source = resolvePluginConfig(CONFIG_KEY, raw);
119
+ return {
120
+ enabled: typeof source.enabled === 'boolean' ? source.enabled : DEFAULTS.enabled,
121
+ servers: typeof source.servers === 'string' ? source.servers : DEFAULTS.servers,
122
+ idleSeconds: clamp(source.idleSeconds, IDLE_SECONDS_MIN, IDLE_SECONDS_MAX, DEFAULTS.idleSeconds),
123
+ diagnostics: typeof source.diagnostics === 'boolean' ? source.diagnostics : DEFAULTS.diagnostics,
124
+ maxLocations: clamp(source.maxLocations, MAX_LOCATIONS_MIN, MAX_LOCATIONS_MAX, DEFAULTS.maxLocations),
125
+ };
126
+ }
127
+ /** 按那一行 JSON 现算服务器表;原文没变就用缓存(每次查询都会问一次)。 */
128
+ function currentServers() {
129
+ const text = readConfig(passed).servers;
130
+ if (serversCache?.text === text)
131
+ return serversCache;
132
+ const parsed = parseServerOverrides(text);
133
+ serversCache = {
134
+ text,
135
+ defs: mergeServers(BUILTIN_SERVERS, parsed.servers),
136
+ problem: parsed.problem,
137
+ };
138
+ return serversCache;
139
+ }
140
+ // ── 工具 ────────────────────────────────────────────────────────────────
141
+ function buildTool() {
142
+ return {
143
+ name: 'lsp',
144
+ description: '按符号位置向语言服务器查代码智能(LSP)。operation 四选一:goToDefinition(定义)、' +
145
+ 'findReferences(全部引用,**结果包含声明本身**)、goToImplementation(实现)、hover(类型与文档)。' +
146
+ 'line 与 character 都是**一基**(第一行 = 1、第一列 = 1,character 按 UTF-16 码元数),' +
147
+ '光标要落在符号上,落在空白处可能没有结果。返回的每条位置是 path:line:character(同样一基)。' +
148
+ '普通导航优先用 grep / glob / read;只有文本匹配有歧义(同名符号、重载、动态派发)、' +
149
+ '或改动前必须精确定位定义与引用时才用它。没装语言服务器时返回一句原因,不会报错。',
150
+ parameters: {
151
+ type: 'object',
152
+ properties: {
153
+ operation: {
154
+ type: 'string',
155
+ enum: [...LSP_OPERATIONS],
156
+ description: 'goToDefinition / findReferences / goToImplementation / hover',
157
+ },
158
+ file_path: {
159
+ type: 'string',
160
+ description: '要查询的源文件(相对会话工作目录或绝对路径)',
161
+ },
162
+ line: { type: 'integer', description: '一基行号(第一行 = 1)' },
163
+ character: { type: 'integer', description: '一基列号(第一列 = 1,按 UTF-16 码元数)' },
164
+ },
165
+ required: ['operation', 'file_path', 'line', 'character'],
166
+ },
167
+ // 只查询、不改文件:标 read 才能免审批直接放行。
168
+ risk: 'read',
169
+ run: (args, runCtx) => runQuery(args, runCtx),
170
+ };
171
+ }
172
+ /** 工具主体:**任何情况都返回文本**,绝不把异常抛给模型。 */
173
+ async function runQuery(args, runCtx) {
174
+ try {
175
+ const config = readConfig(passed);
176
+ if (!config.enabled) {
177
+ return degradation('LSP 代码智能关着(设置 → LSP 代码智能 → 总开关)');
178
+ }
179
+ const operation = args.operation;
180
+ if (typeof operation !== 'string' || !isOperation(operation)) {
181
+ return degradation(`没有数据:operation 只能是 ${LSP_OPERATIONS.join(' / ')},收到 ${JSON.stringify(args.operation)}`);
182
+ }
183
+ const filePath = args.file_path;
184
+ if (typeof filePath !== 'string' || filePath.trim() === '') {
185
+ return degradation('没有数据:file_path 要是非空字符串');
186
+ }
187
+ let position;
188
+ try {
189
+ position = toProtocolPosition(Number(args.line), Number(args.character));
190
+ }
191
+ catch (error) {
192
+ return degradation(`没有数据:${errorText(error)}`);
193
+ }
194
+ const outcome = await manager.query(operation, filePath, position, runCtx.cwd, runCtx.signal);
195
+ return renderOutcome(outcome, config, runCtx.cwd);
196
+ }
197
+ catch (error) {
198
+ return degradation(`LSP 查询出错:${errorText(error)}`);
199
+ }
200
+ }
201
+ /** 把查询结果渲染成给模型的文本(已经过围栏与两道上限)。 */
202
+ function renderOutcome(outcome, config, cwd) {
203
+ if (!outcome.ok) {
204
+ const stderr = outcome.stderr === undefined || outcome.stderr === '' ? '' : `\nstderr 尾巴:\n${outcome.stderr}`;
205
+ return wrapUntrusted(`lsp:${outcome.server ?? 'none'}`, `没有数据:${outcome.reason}${stderr}`);
206
+ }
207
+ if (outcome.kind === 'hover') {
208
+ return wrapUntrusted(`lsp:${outcome.server}`, boundResult(renderHover(outcome.hover, outcome.server, outcome.root, cwd), MAX_RESULT_CHARS, 'hover'));
209
+ }
210
+ return wrapUntrusted(`lsp:${outcome.server}`, boundResult(renderLocations(outcome.locations, outcome.server, outcome.root, cwd), MAX_RESULT_CHARS, '定位结果'));
211
+ }
212
+ /** locations:先按条数截断(附「还有 N 条未列出」),再按总字符截断;同一个文件的位置连在一起。 */
213
+ function renderLocations(locations, server, root, cwd) {
214
+ const header = `找到 ${locations.length} 处(${server}${rootHint(root, cwd)})`;
215
+ if (locations.length === 0) {
216
+ return `${header}\n没有结果:光标可能不在符号上,或者这个符号没有定义/引用。`;
217
+ }
218
+ const shown = locations.slice(0, readConfig(passed).maxLocations);
219
+ // 按文件分组:保持「文件第一次出现」的顺序,同一文件的条目连成一块。
220
+ const grouped = new Map();
221
+ for (const location of shown) {
222
+ const path = displayPath(location.uri, cwd);
223
+ const entry = `${path}:${toDisplayLine(location.range.start.line)}:${toDisplayCharacter(location.range.start.character)}`;
224
+ const list = grouped.get(path);
225
+ if (list === undefined)
226
+ grouped.set(path, [entry]);
227
+ else
228
+ list.push(entry);
229
+ }
230
+ const lines = [header];
231
+ for (const entries of grouped.values())
232
+ lines.push(...entries);
233
+ const omitted = locations.length - shown.length;
234
+ if (omitted > 0)
235
+ lines.push(`… 还有 ${omitted} 条未列出(单次上限 ${readConfig(passed).maxLocations} 条)`);
236
+ return lines.join('\n');
237
+ }
238
+ /** hover:把三种编码归并成一段文本;没有内容时给一句能自救的说明。 */
239
+ function renderHover(hover, server, root, cwd) {
240
+ const header = `悬停信息(${server}${rootHint(root, cwd)})`;
241
+ if (hover === null || hover.contents.trim() === '') {
242
+ return `${header}\n没有数据:这个位置没有悬停信息(光标可能不在符号上)。`;
243
+ }
244
+ return `${header}\n${hover.contents}`;
245
+ }
246
+ /** 项目根在文案里只出现一次,而且能在工作目录里显示成相对路径。 */
247
+ function rootHint(root, cwd) {
248
+ return `,根 ${displayPath(root, cwd)}`;
249
+ }
250
+ /** 降级文案:统一「没有数据:原因」,并且一样过围栏(stderr 与符号名都算外部文本)。 */
251
+ function degradation(reason) {
252
+ return wrapUntrusted('lsp:none', `没有数据:${reason}`);
253
+ }
254
+ // ── 诊断注入:守卫记底 + 观察者挂后台 ────────────────────────────────────
255
+ /**
256
+ * 守卫:只读工具的 target 不记;写类工具在**动手之前**把写前内容读下来,
257
+ * 并把基线诊断**同步入队**(不 await、不阻塞这一次写)。顺序由串行队列保证:
258
+ * 这里入队的基线一定排在观察者那次「写后查询」前面,所以差集是干净的。
259
+ */
260
+ async function captureBaseline(input) {
261
+ try {
262
+ if (!WRITE_TOOLS.has(input.toolName))
263
+ return DEFER;
264
+ const target = input.target;
265
+ if (target === undefined)
266
+ return DEFER;
267
+ const config = readConfig(passed);
268
+ if (!config.enabled || !config.diagnostics)
269
+ return DEFER;
270
+ // 这个文件现在就没有可用服务器(没装 / 没根 / 刚破键)时什么都别做,
271
+ // 免得每次写文件都白起一次进程、白等一次超时。
272
+ if (!manager.canServe(target, input.cwd))
273
+ return DEFER;
274
+ const preText = readText(target);
275
+ if (preText === undefined)
276
+ return DEFER;
277
+ const baseline = manager.diagnostics(target, input.cwd, preText);
278
+ lastWrite = {
279
+ path: target,
280
+ cwd: input.cwd,
281
+ preText,
282
+ baseline: baseline.then((outcome) => ({
283
+ ok: outcome.ok,
284
+ diagnostics: outcome.ok ? outcome.diagnostics : [],
285
+ })),
286
+ at: Date.now(),
287
+ };
288
+ }
289
+ catch {
290
+ // 守卫抛错会被链按 deny 处理——LSP 这点事绝不该拦住一次写,所以这里自己吞掉。
291
+ return DEFER;
292
+ }
293
+ return DEFER;
294
+ }
295
+ /**
296
+ * 观察者:拿到刚写的那个文件(守卫留的底),把「写后诊断对写前基线的差集」挂到后台算。
297
+ * 同步返回原文本——异步结果由 `transformMessages` 补进下一次请求。
298
+ */
299
+ function buildObserver() {
300
+ return {
301
+ id: 'lsp',
302
+ order: 46,
303
+ observe(toolName, text) {
304
+ try {
305
+ if (!WRITE_TOOLS.has(toolName))
306
+ return text;
307
+ const record = lastWrite;
308
+ lastWrite = undefined;
309
+ if (record === undefined)
310
+ return text;
311
+ void injectDiagnostics(record).catch(() => {
312
+ // 诊断注入是附赠信息,静默失败即可:绝不能让它的异常影响工具结果。
313
+ });
314
+ }
315
+ catch {
316
+ // 同上
317
+ }
318
+ return text;
319
+ },
320
+ };
321
+ }
322
+ /** 写后取数 → 行位移 → 集合差 → 攒进 pending(下一次请求带上)。 */
323
+ async function injectDiagnostics(record) {
324
+ const config = readConfig(passed);
325
+ if (!config.enabled || !config.diagnostics)
326
+ return;
327
+ const postText = readText(record.path);
328
+ if (postText === undefined)
329
+ return;
330
+ const baseline = await record.baseline;
331
+ if (!baseline.ok)
332
+ return;
333
+ const post = await manager.diagnostics(record.path, record.cwd, postText);
334
+ if (!post.ok)
335
+ return;
336
+ const shift = buildLineShift(record.preText, postText);
337
+ const seen = new Set(shiftDiagnostics(baseline.diagnostics, shift).map(diagnosticKey));
338
+ const fresh = post.diagnostics.filter((item) => item.severity === DIAGNOSTIC_ERROR_SEVERITY && !seen.has(diagnosticKey(item)));
339
+ if (fresh.length === 0)
340
+ return;
341
+ const block = formatDiagnosticBlock(record.path, fresh, record.cwd);
342
+ pendingDiagnostics.push(block);
343
+ ctx.transcript.system(`lsp:${displayPath(record.path, record.cwd)} 这次改动新引入 ${fresh.length} 条 ERROR` +
344
+ '(明细附在下一次请求里)');
345
+ }
346
+ /** 一个 `<diagnostics file=…>` 段:每行 `ERROR [行:列] 消息 [code] (source)`,字段全部转义 + 截断。 */
347
+ function formatDiagnosticBlock(filePath, diagnostics, cwd) {
348
+ const header = `<diagnostics file="${escapeText(displayPath(filePath, cwd), true)}">`;
349
+ const footer = '</diagnostics>';
350
+ // 4000 字符是**整块**的预算,所以先把头尾与「还有 N 条」的位置留出来,再逐条塞。
351
+ const budget = DIAGNOSTIC_MAX_TOTAL_CHARS - header.length - footer.length - 1;
352
+ const lines = [];
353
+ let used = 0;
354
+ let listed = 0;
355
+ for (const item of diagnostics.slice(0, DIAGNOSTIC_MAX_PER_FILE)) {
356
+ const line = renderDiagnostic(item);
357
+ if (used + line.length + 1 > budget)
358
+ break;
359
+ lines.push(line);
360
+ used += line.length + 1;
361
+ listed += 1;
362
+ }
363
+ const dropped = diagnostics.length - listed;
364
+ if (dropped > 0)
365
+ lines.push(`… 还有 ${dropped} 条未列出`);
366
+ return `${header}\n${lines.join('\n')}\n${footer}`;
367
+ }
368
+ /** 一条诊断压成一行(字段截断 + HTML 转义:消息与标识符都来自用户代码,属外部文本)。 */
369
+ function renderDiagnostic(item) {
370
+ const severity = SEVERITY_NAMES[item.severity] ?? 'ERROR';
371
+ const line = toDisplayLine(item.range.start.line);
372
+ const column = toDisplayCharacter(item.range.start.character);
373
+ const message = sanitizeField(item.message, DIAGNOSTIC_MESSAGE_MAX);
374
+ const code = item.code === undefined ? '' : ` [${sanitizeField(item.code, DIAGNOSTIC_CODE_MAX)}]`;
375
+ const source = item.source === undefined ? '' : ` (${sanitizeField(item.source, DIAGNOSTIC_SOURCE_MAX)})`;
376
+ return `${severity} [${line}:${column}] ${message}${code}${source}`;
377
+ }
378
+ // ── 设置分区 ────────────────────────────────────────────────────────────
379
+ function buildSection() {
380
+ const fields = () => {
381
+ const problem = currentServers().problem;
382
+ return [
383
+ {
384
+ type: 'switch',
385
+ key: 'enabled',
386
+ label: '启用 LSP 代码智能',
387
+ help: '关掉之后 lsp 工具只回一句说明,也不做编辑后诊断注入(不必停用整个插件)。',
388
+ },
389
+ {
390
+ type: 'text',
391
+ key: 'servers',
392
+ label: '服务器清单(一行 JSON)',
393
+ mono: true,
394
+ placeholder: '[{"id":"python","command":"pylsp","extensions":[".py"],"markers":["pyproject.toml"]}]',
395
+ help: '留空就用内置表(typescript / pyright / rust / go / clangd / json / yaml)。' +
396
+ '一项一个服务器:id + command 必填,extensions 必填(认领的扩展名),' +
397
+ 'args / markers / languageId 可省。同 id 覆盖内置项,新 id 排在内置项前面(先认领扩展名)。' +
398
+ (problem === null ? '' : ` 现在这份读不了:${problem}`),
399
+ },
400
+ {
401
+ type: 'number',
402
+ key: 'idleSeconds',
403
+ label: '空闲多久回收语言服务器(秒)',
404
+ min: IDLE_SECONDS_MIN,
405
+ max: IDLE_SECONDS_MAX,
406
+ step: 30,
407
+ help: '下限 30 秒:比单次请求预算还短的话会杀到正在跑的查询。',
408
+ },
409
+ {
410
+ type: 'switch',
411
+ key: 'diagnostics',
412
+ label: '编辑后注入新引入的报错',
413
+ help: '写文件前取一次基线,写后再取一次,只报本次新引入的 ERROR(明细附在下一次请求里)。',
414
+ },
415
+ {
416
+ type: 'number',
417
+ key: 'maxLocations',
418
+ label: '单次结果条数上限',
419
+ min: MAX_LOCATIONS_MIN,
420
+ max: MAX_LOCATIONS_MAX,
421
+ step: 10,
422
+ help: '超过就截断并注明「还有 N 条未列出」;之后还会按 16000 字符再截一次。',
423
+ },
424
+ { type: 'button', action: 'status', label: '看服务器状态', style: 'ghost' },
425
+ { type: 'info', label: '现在的情况', text: statusText(), mono: true, copyable: true },
426
+ ];
427
+ };
428
+ return {
429
+ id: CONFIG_KEY,
430
+ title: 'LSP 代码智能',
431
+ subtitle: '连语言服务器查定义与引用,并把本次编辑新引入的报错附在下一次请求里',
432
+ order: 33,
433
+ fields,
434
+ values: () => {
435
+ const config = readConfig(passed);
436
+ return {
437
+ enabled: config.enabled,
438
+ servers: config.servers,
439
+ idleSeconds: config.idleSeconds,
440
+ diagnostics: config.diagnostics,
441
+ maxLocations: config.maxLocations,
442
+ };
443
+ },
444
+ // 校验不过一律抛错:settings 服务把「返回字符串」当成成功提示,
445
+ // 只有抛出去才会变成界面上那条红色的「保存失败:原因」。
446
+ save: (key, value) => {
447
+ switch (key) {
448
+ case 'enabled':
449
+ writePluginConfig(CONFIG_KEY, { enabled: value === true || value === 'true' });
450
+ break;
451
+ case 'diagnostics':
452
+ writePluginConfig(CONFIG_KEY, { diagnostics: value === true || value === 'true' });
453
+ break;
454
+ case 'servers': {
455
+ const text = String(value);
456
+ // 先试解析:存进去的东西必须是能用的,半份清单不如不存。
457
+ const parsed = parseServerOverrides(text);
458
+ if (parsed.problem !== null)
459
+ throw new Error(parsed.problem);
460
+ writePluginConfig(CONFIG_KEY, { servers: text.trim() });
461
+ break;
462
+ }
463
+ case 'idleSeconds': {
464
+ const seconds = Number(value);
465
+ if (!Number.isFinite(seconds))
466
+ throw new Error('idleSeconds 要填数字');
467
+ writePluginConfig(CONFIG_KEY, {
468
+ idleSeconds: Math.round(Math.min(Math.max(seconds, IDLE_SECONDS_MIN), IDLE_SECONDS_MAX)),
469
+ });
470
+ break;
471
+ }
472
+ case 'maxLocations': {
473
+ const count = Number(value);
474
+ if (!Number.isFinite(count))
475
+ throw new Error('maxLocations 要填数字');
476
+ writePluginConfig(CONFIG_KEY, {
477
+ maxLocations: Math.round(Math.min(Math.max(count, MAX_LOCATIONS_MIN), MAX_LOCATIONS_MAX)),
478
+ });
479
+ break;
480
+ }
481
+ default:
482
+ throw new Error(`这个分区没有这项:${key}`);
483
+ }
484
+ serversCache = undefined;
485
+ },
486
+ action: (name) => {
487
+ if (name !== 'status')
488
+ throw new Error(`这个分区没有这个按钮:${name}`);
489
+ return statusText();
490
+ },
491
+ };
492
+ }
493
+ /** 「看服务器状态」与 info 那一行共用的一句文案。 */
494
+ function statusText() {
495
+ const parsed = currentServers();
496
+ if (parsed.problem !== null)
497
+ return `服务器清单读不了:${parsed.problem}`;
498
+ const entries = manager.status();
499
+ if (entries.length === 0)
500
+ return '服务器表是空的(把内建表也覆盖没了?)';
501
+ const parts = entries.map((entry) => describeEntry(entry));
502
+ const ready = entries.filter((entry) => entry.available && entry.brokenSeconds === null).length;
503
+ return `${entries.length} 个服务器,${ready} 个可用:${parts.join(';')}`;
504
+ }
505
+ /** 一个服务器在状态文案里的说法。 */
506
+ function describeEntry(entry) {
507
+ if (!entry.available) {
508
+ const hint = installHint(entry.id);
509
+ return `${entry.id} 没装(PATH 里没有 ${entry.command}${hint === undefined ? '' : `,${hint}`})`;
510
+ }
511
+ if (entry.brokenSeconds !== null) {
512
+ return `${entry.id} 最近起不来(${entry.brokenSeconds} 秒后重试${entry.problem === undefined ? '' : `:${entry.problem}`})`;
513
+ }
514
+ if (entry.instances === 0)
515
+ return `${entry.id} 可用,还没起进程`;
516
+ return `${entry.id} 有 ${entry.instances} 个实例`;
517
+ }
518
+ // ── 对外服务(别的插件用 ctx.get('lsp') 读)──────────────────────────────
519
+ function buildService() {
520
+ return {
521
+ query: async (operation, filePath, line, character) => {
522
+ const cwd = sessionCwd();
523
+ try {
524
+ if (!isOperation(operation)) {
525
+ return degradation(`没有数据:operation 只能是 ${LSP_OPERATIONS.join(' / ')}`);
526
+ }
527
+ const position = toProtocolPosition(line, character);
528
+ const outcome = await manager.query(operation, filePath, position, cwd, undefined);
529
+ return renderOutcome(outcome, readConfig(passed), cwd);
530
+ }
531
+ catch (error) {
532
+ return degradation(`LSP 查询出错:${errorText(error)}`);
533
+ }
534
+ },
535
+ status: () => manager.status(),
536
+ servers: () => manager.servers(),
537
+ };
538
+ }
539
+ /** 会话工作目录(服务这条路上没有工具上下文,只能问会话)。 */
540
+ function sessionCwd() {
541
+ try {
542
+ return ctx.session.current().meta.cwd;
543
+ }
544
+ catch {
545
+ return process.cwd();
546
+ }
547
+ }
548
+ },
549
+ };
550
+ /** 系统提示那一段:把「什么时候才该用它」与坐标基写清楚。 */
551
+ const LSP_PROMPT_TEXT = [
552
+ 'LSP 代码智能(lsp 工具):普通导航优先用 grep / glob / read;',
553
+ '只有文本匹配有歧义(同名符号、重载、动态派发),或者动手改之前需要精确定位定义与引用时,才用 lsp 工具。',
554
+ 'operation 四选一:goToDefinition / findReferences(结果包含声明本身)/ goToImplementation / hover。',
555
+ '坐标是**一基**:line 与 character 都从 1 数(character 按 UTF-16 码元),光标要落在符号上;',
556
+ '返回的 path:line:character 同样是一基,可以直接拿去 read。',
557
+ '没装语言服务器时它会回一句原因,不要反复重试同一个查询。',
558
+ ].join('\n');
559
+ /** 操作名的运行时校验。 */
560
+ function isOperation(value) {
561
+ return LSP_OPERATIONS.includes(value);
562
+ }
563
+ /** 数字类配置的兜底:不是有限数就用缺省,否则夹进范围。 */
564
+ function clamp(value, min, max, fallback) {
565
+ const num = Number(value);
566
+ if (!Number.isFinite(num))
567
+ return fallback;
568
+ return Math.min(Math.max(Math.round(num), min), max);
569
+ }
570
+ /** 错误对象取一句话。 */
571
+ function errorText(error) {
572
+ return error instanceof Error ? error.message : String(error);
573
+ }
574
+ /** 读文件为文本;读不到(不存在 / 权限)给 undefined,由调用方跳过这一步。 */
575
+ function readText(filePath) {
576
+ try {
577
+ // 同步读是必须的:守卫要拿到「写前那一刻」的内容,异步读会和紧接着的写抢时间。
578
+ return readFileSync(filePath, 'utf8');
579
+ }
580
+ catch {
581
+ return undefined;
582
+ }
583
+ }
584
+ /** 按字符数截断一段完整结果(把说明本身也留在预算里)。 */
585
+ function boundResult(text, maxChars, label) {
586
+ if (text.length <= maxChars)
587
+ return text;
588
+ const notice = `\n… ${label}超过 ${maxChars} 字符,已截断`;
589
+ if (notice.length >= maxChars)
590
+ return notice.slice(0, maxChars);
591
+ return `${text.slice(0, maxChars - notice.length)}${notice}`;
592
+ }
593
+ /** HTML 转义(`<` `>` `&`,属性里连引号一起转):别让用户代码里的记号把诊断块提前闭合。 */
594
+ function escapeText(value, attribute) {
595
+ const escaped = value.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
596
+ return attribute ? escaped.replace(/"/g, '&quot;') : escaped;
597
+ }
598
+ /** 单行化 + 去控制字符 + 截断 + 转义:语言服务器给的每一个字段都要过这一道。 */
599
+ function sanitizeField(value, limit) {
600
+ const flat = value.replace(/[\r\n\t]+/g, ' ');
601
+ let printable = '';
602
+ for (const char of flat) {
603
+ const code = char.codePointAt(0) ?? 0;
604
+ if (code >= 0x20 && code !== 0x7f)
605
+ printable += char;
606
+ }
607
+ return escapeText(printable.trim().slice(0, limit), false);
608
+ }
@@ -0,0 +1,16 @@
1
+ /**
2
+ * MCP 客户端(官方插件):把配置里的 MCP server 接进来,工具挂成
3
+ * `mcp__<server>__<tool>` 注册进 `ctx.tools`,返回值一律先过防注入围栏。
4
+ *
5
+ * **连接全在后台跑**:`src/host/kernel.ts` 是 `await root.plugin(...)`,
6
+ * 一个起不来的 server 如果在 apply 里等它,会把整个 createKernel 一起拖住。
7
+ * 所以状态经 `servers()` 暴露,失败写一条会话流说明,并按退避重连;
8
+ * 一个 server 连不上不影响其它 server,也不影响宿主。
9
+ *
10
+ * 服务器清单只能在设置里存成一行 JSON(设置控件只有单行 text,摆不下多行结构),
11
+ * 保存时整份解析校验,任何一项不合法就整份拒收并指出第几项哪里不对。
12
+ *
13
+ * @module dsc/plugins/mcp
14
+ */
15
+ import type { Plugin } from '@deepseek-ai/cordis';
16
+ export declare const mcpPlugin: Plugin.Object;