@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,152 @@
1
+ /**
2
+ * Tool Search(工具渐进披露)的纯逻辑层:分词、BM25 检索、延后判定与配置校验。
3
+ *
4
+ * 为什么要有这一层:模型每轮请求都拿得到注册表里的全部工具 schema,MCP 一接进来就是几十个
5
+ * 工具的参数表,其中这一轮用得上的常常只有一两条,其余 schema 白付 token。这里把
6
+ * 「哪些工具可以从台面上撤下、撤下之后怎么用中文或英文搜回来」判定收在一处,
7
+ * 插件那一层只管把它接到 `ctx.tools` / `ctx.guards` / `ctx.get('mcp')` 上。
8
+ *
9
+ * 中文为什么按 bigram 切:中文词之间没有空格,整串比对永远命不中,所以把相邻两字切成一项
10
+ * (「创建工单」→ 创建 / 建工 / 工单),单个汉字自成一项。英文与数字按标识符切
11
+ * (下划线与驼峰都拆开)再小写化,所以 `mcp__github__create_issue` 能用 github、issue 搜到。
12
+ *
13
+ * @module dsc/core/tool-search
14
+ */
15
+ import type { ToolRisk } from './tools.js';
16
+ /** 插件配置在 `~/.dsc/plugins.json` 里的条目键,同时是设置分区的 id。 */
17
+ export declare const TOOL_SEARCH_CONFIG_KEY = "tool-search";
18
+ /**
19
+ * 可调值的区间。设置分区的控件范围与加载时的校验都读它,
20
+ * 免得「界面允许填 30、插件只认 20」这种两处各写一遍的偏差。
21
+ */
22
+ export declare const TOOL_SEARCH_LIMITS: {
23
+ /** 一次检索最多返回几条。 */
24
+ readonly searchLimit: {
25
+ readonly min: 1;
26
+ readonly max: 20;
27
+ };
28
+ /** 渐进披露档位:1 只撤 MCP、2 再按规则撤、3 除保留名单外全撤。 */
29
+ readonly tier: {
30
+ readonly min: 1;
31
+ readonly max: 3;
32
+ };
33
+ };
34
+ /**
35
+ * 三档渐进披露。
36
+ * 1 = 只把 MCP 工具的 schema 撤下,注册表里的一条不动;
37
+ * 2 = 在 1 的基础上,再撤下命中 `deferRules` 的注册表工具;
38
+ * 3 = MCP 与全部 write / exec 注册表工具都撤,只有命中 `keepTools` 的留着。
39
+ */
40
+ export type ToolSearchTier = 1 | 2 | 3;
41
+ /** 插件配置。 */
42
+ export interface ToolSearchConfig {
43
+ /** 撤下 MCP 工具 schema(走 `mcp.deferSchemas()`)吗。 */
44
+ deferMcpSchemas: boolean;
45
+ /** 撤下的力度,见 {@link ToolSearchTier}。 */
46
+ tier: ToolSearchTier;
47
+ /** tier 2 用:命中这些 glob 的注册表工具撤下(`*` 匹配任意串)。 */
48
+ deferRules: string[];
49
+ /** 永远留在台面上的工具 glob,tier 2 / 3 都生效。 */
50
+ keepTools: string[];
51
+ /** 模型调 `tool_search` 没写 limit 时,一次返回几条。 */
52
+ searchLimit: number;
53
+ }
54
+ /** 缺省配置:只动 MCP(这是本轮最要紧的收益),注册表工具要用户点名才撤。 */
55
+ export declare const DEFAULT_TOOL_SEARCH_CONFIG: ToolSearchConfig;
56
+ /** 索引里的一篇文档:一个工具的真名与说明。 */
57
+ export interface ToolSearchDoc {
58
+ /** 工具真名,检索结果里回给模型的就是它。 */
59
+ name: string;
60
+ /** 一句话说明(结果列表里每条只占一行)。 */
61
+ summary: string;
62
+ /** 进索引的说明正文(工具名另按更高权重计入)。 */
63
+ description: string;
64
+ }
65
+ /** 一条检索命中:真名 + 一句话说明 + 分数(大的更相关)。 */
66
+ export interface ToolSearchHit {
67
+ name: string;
68
+ summary: string;
69
+ score: number;
70
+ }
71
+ /**
72
+ * 把一段文本切成检索词元。
73
+ *
74
+ * 汉字按相邻两字一项;英文与数字按标识符切(`_` 与驼峰都拆开)后小写化。
75
+ * 中文与英文混排时两类词元都进同一个词表,所以「创建 issue」这样的查询能同时命中文档里的两半。
76
+ *
77
+ * @param text - 要切的文本(工具名、说明、查询都走这一个函数,切法必须一致才能对上)。
78
+ * @returns 词元数组,顺序与出现顺序一致,允许重复(词频要用)。
79
+ */
80
+ export declare function tokenize(text: string): string[];
81
+ /**
82
+ * 把设置页那个多行文本框读成清单:一行一个名字,逗号、分号、中文逗号都能当分隔。
83
+ *
84
+ * @param text - 用户填的原文。
85
+ * @returns 去掉空行后的清单;条目里带空格时抛错(工具名与通配模式里不会出现空格,多半是填错了)。
86
+ */
87
+ export declare function parseNameListText(text: string): string[];
88
+ /**
89
+ * 按 glob(只认 `*`)匹配工具名,大小写不敏感。
90
+ *
91
+ * @param pattern - 模式,例如 `mcp__github__*`。
92
+ * @param name - 工具真名。
93
+ * @returns 命中为 true。
94
+ */
95
+ export declare function matchesToolGlob(pattern: string, name: string): boolean;
96
+ /**
97
+ * 这条工具允许被撤下吗。
98
+ *
99
+ * read 风险一律不许:撤下之后模型只能经 `tool_call` 调它,而 `tool_call` 自己是 exec 档、
100
+ * 每次都要过审批卡,「只读免审批」就变成了「每次只读都弹卡」。
101
+ *
102
+ * @param tool - 工具的名字与风险等级。
103
+ * @param config - 当前配置。
104
+ * @returns 允许撤下为 true。
105
+ */
106
+ export declare function shouldDeferTool(tool: {
107
+ name: string;
108
+ risk: ToolRisk;
109
+ }, config: ToolSearchConfig): boolean;
110
+ /**
111
+ * 取说明的第一句当「一句话说明」(结果列表里每条工具只占一行)。
112
+ *
113
+ * @param description - 工具的说明原文。
114
+ * @param maxLength - 最长字符数,超出截断并补省略号。
115
+ * @returns 压成一行的一句话;原文为空时给一句占位。
116
+ */
117
+ export declare function summarizeToolDescription(description: string, maxLength?: number): string;
118
+ /**
119
+ * 内存 BM25 索引(零依赖,几十条文档规模一次建表就够)。
120
+ *
121
+ * 手写而不引依赖:这里只要「按中文 bigram 与英文单词打分排序」这一件事,
122
+ * 引一个检索库带来的体积与版本面大于收益。
123
+ */
124
+ export declare class ToolSearchIndex {
125
+ private readonly docs;
126
+ private readonly docFreq;
127
+ private totalLength;
128
+ /**
129
+ * 加一篇文档。同一个名字重复加不查重,调用方自己保证(目录本身就是按名字唯一的)。
130
+ *
131
+ * @param doc - 工具的真名、一句话说明与说明正文。
132
+ */
133
+ add(doc: ToolSearchDoc): void;
134
+ /** 索引里有多少篇文档。 */
135
+ get size(): number;
136
+ /**
137
+ * 按查询词打分排序取前 limit 条。
138
+ *
139
+ * @param query - 查询原文(中文、英文混排都行)。
140
+ * @param limit - 最多返回几条;≤0 直接返回空。
141
+ * @returns 分数大于 0 的命中,分数降序;同分按名字升序,保证两次结果稳定。
142
+ */
143
+ search(query: string, limit: number): ToolSearchHit[];
144
+ }
145
+ /**
146
+ * 校验收到的配置,错了就抛错(加载时报错,别等模型调工具才发现)。
147
+ *
148
+ * @param raw - `resolvePluginConfig('tool-search', passed)` 合并出来的原始对象。
149
+ * @returns 每个字段都有值的配置。
150
+ * @throws 配置项类型不对、档位越界、条数越界、出现不认识的键时抛错,消息里说清错在哪、去哪儿改。
151
+ */
152
+ export declare function resolveToolSearchConfig(raw: unknown): ToolSearchConfig;
@@ -0,0 +1,311 @@
1
+ /** 插件配置在 `~/.dsc/plugins.json` 里的条目键,同时是设置分区的 id。 */
2
+ export const TOOL_SEARCH_CONFIG_KEY = 'tool-search';
3
+ /**
4
+ * 可调值的区间。设置分区的控件范围与加载时的校验都读它,
5
+ * 免得「界面允许填 30、插件只认 20」这种两处各写一遍的偏差。
6
+ */
7
+ export const TOOL_SEARCH_LIMITS = {
8
+ /** 一次检索最多返回几条。 */
9
+ searchLimit: { min: 1, max: 20 },
10
+ /** 渐进披露档位:1 只撤 MCP、2 再按规则撤、3 除保留名单外全撤。 */
11
+ tier: { min: 1, max: 3 },
12
+ };
13
+ /** 缺省配置:只动 MCP(这是本轮最要紧的收益),注册表工具要用户点名才撤。 */
14
+ export const DEFAULT_TOOL_SEARCH_CONFIG = {
15
+ deferMcpSchemas: true,
16
+ tier: 2,
17
+ deferRules: [],
18
+ keepTools: [],
19
+ searchLimit: 5,
20
+ };
21
+ /** 认得的配置项(写错的键名会被点名报错,不静默忽略)。 */
22
+ const CONFIG_KEYS = ['deferMcpSchemas', 'tier', 'deferRules', 'keepTools', 'searchLimit'];
23
+ /** 工具名命中比说明命中更能说明「要的就是它」,所以名字的词频按这个倍数计。 */
24
+ const NAME_WEIGHT = 3;
25
+ /** BM25 的词频饱和与长度归一参数:公式常量,不随部署变。 */
26
+ const BM25_K1 = 1.2;
27
+ const BM25_B = 0.75;
28
+ /** 汉字区块(基本区、扩展 A、兼容区)。 */
29
+ const CJK = /[\u3400-\u4dbf\u4e00-\u9fff\uf900-\ufaff]/;
30
+ /** 关键词词元字符(英文、数字、下划线)。 */
31
+ const WORD = /[A-Za-z0-9_]/;
32
+ /** 正则元字符转义,拼 glob 用。 */
33
+ const REGEX_SPECIAL = /[.*+?^${}()|[\]\\]/g;
34
+ /**
35
+ * 把一段文本切成检索词元。
36
+ *
37
+ * 汉字按相邻两字一项;英文与数字按标识符切(`_` 与驼峰都拆开)后小写化。
38
+ * 中文与英文混排时两类词元都进同一个词表,所以「创建 issue」这样的查询能同时命中文档里的两半。
39
+ *
40
+ * @param text - 要切的文本(工具名、说明、查询都走这一个函数,切法必须一致才能对上)。
41
+ * @returns 词元数组,顺序与出现顺序一致,允许重复(词频要用)。
42
+ */
43
+ export function tokenize(text) {
44
+ const out = [];
45
+ let index = 0;
46
+ while (index < text.length) {
47
+ const char = text[index];
48
+ if (CJK.test(char)) {
49
+ let end = index;
50
+ while (end < text.length && CJK.test(text[end]))
51
+ end += 1;
52
+ const run = text.slice(index, end);
53
+ if (run.length === 1)
54
+ out.push(run);
55
+ else
56
+ for (let start = 0; start + 1 < run.length; start += 1)
57
+ out.push(run.slice(start, start + 2));
58
+ index = end;
59
+ continue;
60
+ }
61
+ if (!WORD.test(char)) {
62
+ index += 1;
63
+ continue;
64
+ }
65
+ let end = index;
66
+ while (end < text.length && WORD.test(text[end]))
67
+ end += 1;
68
+ for (const part of splitIdentifier(text.slice(index, end)))
69
+ out.push(part);
70
+ index = end;
71
+ }
72
+ return out;
73
+ }
74
+ /**
75
+ * 把 `mcp__github__create_issue`、`readFile` 这类标识符拆成小写单词。
76
+ *
77
+ * @param raw - 一段连续的字母数字下划线。
78
+ * @returns 小写单词数组,空串被丢掉。
79
+ */
80
+ function splitIdentifier(raw) {
81
+ return raw
82
+ .replace(/([a-z0-9])([A-Z])/g, '$1 $2')
83
+ .split(/[^A-Za-z0-9]+/)
84
+ .map((part) => part.toLowerCase())
85
+ .filter((part) => part !== '');
86
+ }
87
+ /**
88
+ * 把设置页那个多行文本框读成清单:一行一个名字,逗号、分号、中文逗号都能当分隔。
89
+ *
90
+ * @param text - 用户填的原文。
91
+ * @returns 去掉空行后的清单;条目里带空格时抛错(工具名与通配模式里不会出现空格,多半是填错了)。
92
+ */
93
+ export function parseNameListText(text) {
94
+ const out = [];
95
+ for (const piece of text.split(/[\n,,;;]+/)) {
96
+ const name = piece.trim();
97
+ if (name === '')
98
+ continue;
99
+ if (/\s/.test(name))
100
+ throw new Error(`「${name}」中间有空格:一行写一个工具名或通配模式`);
101
+ out.push(name);
102
+ }
103
+ return out;
104
+ }
105
+ /**
106
+ * 按 glob(只认 `*`)匹配工具名,大小写不敏感。
107
+ *
108
+ * @param pattern - 模式,例如 `mcp__github__*`。
109
+ * @param name - 工具真名。
110
+ * @returns 命中为 true。
111
+ */
112
+ export function matchesToolGlob(pattern, name) {
113
+ const body = pattern
114
+ .split('*')
115
+ .map((piece) => piece.replace(REGEX_SPECIAL, '\\$&'))
116
+ .join('.*');
117
+ return new RegExp(`^${body}$`, 'i').test(name);
118
+ }
119
+ /**
120
+ * 这条工具允许被撤下吗。
121
+ *
122
+ * read 风险一律不许:撤下之后模型只能经 `tool_call` 调它,而 `tool_call` 自己是 exec 档、
123
+ * 每次都要过审批卡,「只读免审批」就变成了「每次只读都弹卡」。
124
+ *
125
+ * @param tool - 工具的名字与风险等级。
126
+ * @param config - 当前配置。
127
+ * @returns 允许撤下为 true。
128
+ */
129
+ export function shouldDeferTool(tool, config) {
130
+ if (tool.risk === 'read')
131
+ return false;
132
+ if (config.keepTools.some((pattern) => matchesToolGlob(pattern, tool.name)))
133
+ return false;
134
+ if (config.tier === 3)
135
+ return true;
136
+ if (config.tier === 1)
137
+ return false;
138
+ return config.deferRules.some((pattern) => matchesToolGlob(pattern, tool.name));
139
+ }
140
+ /**
141
+ * 取说明的第一句当「一句话说明」(结果列表里每条工具只占一行)。
142
+ *
143
+ * @param description - 工具的说明原文。
144
+ * @param maxLength - 最长字符数,超出截断并补省略号。
145
+ * @returns 压成一行的一句话;原文为空时给一句占位。
146
+ */
147
+ export function summarizeToolDescription(description, maxLength = 120) {
148
+ const flat = description.replace(/\s+/g, ' ').trim();
149
+ if (flat === '')
150
+ return '(没有说明)';
151
+ const head = (flat.split(/[。!?;]|\.\s/)[0] ?? '').trim();
152
+ const text = head === '' ? flat : head;
153
+ return text.length > maxLength ? `${text.slice(0, maxLength)}…` : text;
154
+ }
155
+ /**
156
+ * 内存 BM25 索引(零依赖,几十条文档规模一次建表就够)。
157
+ *
158
+ * 手写而不引依赖:这里只要「按中文 bigram 与英文单词打分排序」这一件事,
159
+ * 引一个检索库带来的体积与版本面大于收益。
160
+ */
161
+ export class ToolSearchIndex {
162
+ docs = [];
163
+ docFreq = new Map();
164
+ totalLength = 0;
165
+ /**
166
+ * 加一篇文档。同一个名字重复加不查重,调用方自己保证(目录本身就是按名字唯一的)。
167
+ *
168
+ * @param doc - 工具的真名、一句话说明与说明正文。
169
+ */
170
+ add(doc) {
171
+ const terms = new Map();
172
+ let length = 0;
173
+ const bump = (term, weight) => {
174
+ terms.set(term, (terms.get(term) ?? 0) + weight);
175
+ length += weight;
176
+ };
177
+ for (const term of tokenize(doc.name))
178
+ bump(term, NAME_WEIGHT);
179
+ for (const term of tokenize(doc.description))
180
+ bump(term, 1);
181
+ for (const term of terms.keys())
182
+ this.docFreq.set(term, (this.docFreq.get(term) ?? 0) + 1);
183
+ this.docs.push({ name: doc.name, summary: doc.summary, terms, length });
184
+ this.totalLength += length;
185
+ }
186
+ /** 索引里有多少篇文档。 */
187
+ get size() {
188
+ return this.docs.length;
189
+ }
190
+ /**
191
+ * 按查询词打分排序取前 limit 条。
192
+ *
193
+ * @param query - 查询原文(中文、英文混排都行)。
194
+ * @param limit - 最多返回几条;≤0 直接返回空。
195
+ * @returns 分数大于 0 的命中,分数降序;同分按名字升序,保证两次结果稳定。
196
+ */
197
+ search(query, limit) {
198
+ if (limit <= 0 || this.docs.length === 0)
199
+ return [];
200
+ const terms = [...new Set(tokenize(query))].filter((term) => this.docFreq.has(term));
201
+ if (terms.length === 0)
202
+ return [];
203
+ const total = this.docs.length;
204
+ const avgLength = this.totalLength > 0 ? this.totalLength / total : 1;
205
+ const scored = this.docs.map((doc) => {
206
+ let score = 0;
207
+ for (const term of terms) {
208
+ const tf = doc.terms.get(term) ?? 0;
209
+ if (tf === 0)
210
+ continue;
211
+ const df = this.docFreq.get(term) ?? 0;
212
+ const idf = Math.log(1 + (total - df + 0.5) / (df + 0.5));
213
+ score += (idf * tf * (BM25_K1 + 1)) / (tf + BM25_K1 * (1 - BM25_B + (BM25_B * doc.length) / avgLength));
214
+ }
215
+ return { doc, score };
216
+ });
217
+ return scored
218
+ .filter((hit) => hit.score > 0)
219
+ .sort((a, b) => (b.score === a.score ? a.doc.name.localeCompare(b.doc.name) : b.score - a.score))
220
+ .slice(0, limit)
221
+ .map((hit) => ({ name: hit.doc.name, summary: hit.doc.summary, score: hit.score }));
222
+ }
223
+ }
224
+ /**
225
+ * 校验收到的配置,错了就抛错(加载时报错,别等模型调工具才发现)。
226
+ *
227
+ * @param raw - `resolvePluginConfig('tool-search', passed)` 合并出来的原始对象。
228
+ * @returns 每个字段都有值的配置。
229
+ * @throws 配置项类型不对、档位越界、条数越界、出现不认识的键时抛错,消息里说清错在哪、去哪儿改。
230
+ */
231
+ export function resolveToolSearchConfig(raw) {
232
+ if (raw === null || typeof raw !== 'object' || Array.isArray(raw)) {
233
+ throw new Error(`${TOOL_SEARCH_CONFIG_KEY} 的配置要是一个对象;到 ~/.dsc/plugins.json 或设置页的「工具渐进披露」分区改`);
234
+ }
235
+ const doc = raw;
236
+ for (const key of Object.keys(doc)) {
237
+ if (!CONFIG_KEYS.includes(key)) {
238
+ throw new Error(`${TOOL_SEARCH_CONFIG_KEY} 不认识配置项「${key}」,它认得的是 ${CONFIG_KEYS.join('、')}`);
239
+ }
240
+ }
241
+ const config = { ...DEFAULT_TOOL_SEARCH_CONFIG };
242
+ if (doc.deferMcpSchemas !== undefined) {
243
+ if (typeof doc.deferMcpSchemas !== 'boolean') {
244
+ throw new Error(`deferMcpSchemas 只能是 true 或 false,收到 ${JSON.stringify(doc.deferMcpSchemas)}`);
245
+ }
246
+ config.deferMcpSchemas = doc.deferMcpSchemas;
247
+ }
248
+ if (doc.tier !== undefined) {
249
+ const tier = readInteger(doc.tier, TOOL_SEARCH_LIMITS.tier.min, TOOL_SEARCH_LIMITS.tier.max);
250
+ // 三档各自撤什么写在 ToolSearchTier 上,这里只点一遍,用户看报错就知道该填几
251
+ if (tier === undefined)
252
+ throw new Error('tier 只能是 1(只撤 MCP)、2(再按规则撤)或 3(除保留名单外全撤)');
253
+ config.tier = tier;
254
+ }
255
+ config.deferRules = readNameList(doc.deferRules, 'deferRules');
256
+ config.keepTools = readNameList(doc.keepTools, 'keepTools');
257
+ if (doc.searchLimit !== undefined) {
258
+ const { min, max } = TOOL_SEARCH_LIMITS.searchLimit;
259
+ const limit = readInteger(doc.searchLimit, min, max);
260
+ if (limit === undefined)
261
+ throw new Error(`searchLimit 要在 ${min}~${max} 之间,收到 ${JSON.stringify(doc.searchLimit)}`);
262
+ config.searchLimit = limit;
263
+ }
264
+ return config;
265
+ }
266
+ /**
267
+ * 读一个区间内的整数:数字直接用,数字字符串(设置页回的就是字符串)转过来。
268
+ *
269
+ * 为什么不用 `Number(value)` 一把梭:`Number(true)` 是 1、`Number('')` 是 0,
270
+ * 那样 `tier: true` 会被当成合法档位,配置写错却静默生效。
271
+ *
272
+ * @param value - 原始值。
273
+ * @param min - 下界(含)。
274
+ * @param max - 上界(含)。
275
+ * @returns 合法整数;不是整数或越界时 undefined。
276
+ */
277
+ function readInteger(value, min, max) {
278
+ const num = typeof value === 'number' ? value : typeof value === 'string' && value.trim() !== '' ? Number(value) : Number.NaN;
279
+ if (!Number.isInteger(num) || num < min || num > max)
280
+ return undefined;
281
+ return num;
282
+ }
283
+ /**
284
+ * 读一份名字清单:数组直接用,字符串按 {@link parseNameListText} 切(手改配置文件时常写成一行串)。
285
+ *
286
+ * @param value - 原始值,可以是 undefined(回落到空清单)。
287
+ * @param label - 出错时消息里点名的字段。
288
+ * @returns 名字清单。
289
+ */
290
+ function readNameList(value, label) {
291
+ if (value === undefined)
292
+ return [];
293
+ if (typeof value === 'string')
294
+ return parseNameListText(value);
295
+ if (Array.isArray(value)) {
296
+ const out = [];
297
+ for (const item of value) {
298
+ if (typeof item !== 'string') {
299
+ throw new Error(`${label} 只能是字符串数组,里面有 ${typeof item}`);
300
+ }
301
+ const name = item.trim();
302
+ if (name === '')
303
+ continue;
304
+ if (/\s/.test(name))
305
+ throw new Error(`${label} 里的「${name}」带空格:工具名与通配模式里不会出现空格`);
306
+ out.push(name);
307
+ }
308
+ return out;
309
+ }
310
+ throw new Error(`${label} 要么是多行文本,要么是字符串数组,收到 ${JSON.stringify(value)}`);
311
+ }