@waq666/pneuma 0.0.0-stage → 0.7.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (708) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +206 -3
  3. package/bin/dsc.js +91 -0
  4. package/bin/headless.cjs +40 -0
  5. package/lib/adapter/core-runtime.d.ts +11 -0
  6. package/lib/adapter/core-runtime.js +259 -0
  7. package/lib/adapter/host.d.ts +18 -0
  8. package/lib/adapter/host.js +14 -0
  9. package/lib/adapter/runtime.d.ts +15 -0
  10. package/lib/adapter/runtime.js +290 -0
  11. package/lib/adapter/transcript.d.ts +184 -0
  12. package/lib/adapter/transcript.js +605 -0
  13. package/lib/app/AgentsOverlay.d.ts +18 -0
  14. package/lib/app/AgentsOverlay.js +63 -0
  15. package/lib/app/App.d.ts +15 -0
  16. package/lib/app/App.js +1650 -0
  17. package/lib/app/App.js.nv-backup +1650 -0
  18. package/lib/app/ApprovalCard.d.ts +12 -0
  19. package/lib/app/ApprovalCard.js +76 -0
  20. package/lib/app/AskCard.d.ts +20 -0
  21. package/lib/app/AskCard.js +45 -0
  22. package/lib/app/ChatView.d.ts +63 -0
  23. package/lib/app/ChatView.js +310 -0
  24. package/lib/app/Composer.d.ts +50 -0
  25. package/lib/app/Composer.js +282 -0
  26. package/lib/app/DiffBlock.d.ts +6 -0
  27. package/lib/app/DiffBlock.js +37 -0
  28. package/lib/app/MarkdownView.d.ts +6 -0
  29. package/lib/app/MarkdownView.js +99 -0
  30. package/lib/app/ModelPicker.d.ts +7 -0
  31. package/lib/app/ModelPicker.js +18 -0
  32. package/lib/app/PlanReviewCard.d.ts +13 -0
  33. package/lib/app/PlanReviewCard.js +54 -0
  34. package/lib/app/PresetPicker.d.ts +11 -0
  35. package/lib/app/PresetPicker.js +19 -0
  36. package/lib/app/PreviewOverlay.d.ts +14 -0
  37. package/lib/app/PreviewOverlay.js +22 -0
  38. package/lib/app/SessionPicker.d.ts +43 -0
  39. package/lib/app/SessionPicker.js +56 -0
  40. package/lib/app/SettingsOverlay.d.ts +32 -0
  41. package/lib/app/SettingsOverlay.js +157 -0
  42. package/lib/app/SkillsPicker.d.ts +7 -0
  43. package/lib/app/SkillsPicker.js +19 -0
  44. package/lib/app/StatusBar.d.ts +22 -0
  45. package/lib/app/StatusBar.js +201 -0
  46. package/lib/app/TaskStrips.d.ts +13 -0
  47. package/lib/app/TaskStrips.js +40 -0
  48. package/lib/app/TimelineRail.d.ts +22 -0
  49. package/lib/app/TimelineRail.js +160 -0
  50. package/lib/app/TimelineRail.js.negbak +98 -0
  51. package/lib/app/TimelineRail.js.nv-backup +160 -0
  52. package/lib/app/ToolCard.d.ts +11 -0
  53. package/lib/app/ToolCard.js +64 -0
  54. package/lib/app/ToolCard.js.nv-backup +64 -0
  55. package/lib/app/TranscriptOverlay.d.ts +27 -0
  56. package/lib/app/TranscriptOverlay.js +36 -0
  57. package/lib/app/TranscriptViewport.d.ts +78 -0
  58. package/lib/app/TranscriptViewport.js +218 -0
  59. package/lib/app/Welcome.d.ts +6 -0
  60. package/lib/app/Welcome.js +71 -0
  61. package/lib/app/attach.d.ts +16 -0
  62. package/lib/app/attach.js +58 -0
  63. package/lib/app/click.d.ts +40 -0
  64. package/lib/app/click.js +103 -0
  65. package/lib/app/clipboard-image.d.ts +11 -0
  66. package/lib/app/clipboard-image.js +66 -0
  67. package/lib/app/cursor.d.ts +4 -0
  68. package/lib/app/cursor.js +24 -0
  69. package/lib/app/hello.d.ts +11 -0
  70. package/lib/app/hello.js +8 -0
  71. package/lib/app/history-store.d.ts +4 -0
  72. package/lib/app/history-store.js +41 -0
  73. package/lib/app/image-blocks.d.ts +12 -0
  74. package/lib/app/image-blocks.js +125 -0
  75. package/lib/app/keymap.d.ts +56 -0
  76. package/lib/app/keymap.js +56 -0
  77. package/lib/app/markdown.d.ts +54 -0
  78. package/lib/app/markdown.js +189 -0
  79. package/lib/app/mouse.d.ts +33 -0
  80. package/lib/app/mouse.js +35 -0
  81. package/lib/app/pointer.d.ts +16 -0
  82. package/lib/app/pointer.js +60 -0
  83. package/lib/app/scroll-model.d.ts +240 -0
  84. package/lib/app/scroll-model.js +347 -0
  85. package/lib/app/settings-model.d.ts +69 -0
  86. package/lib/app/settings-model.js +114 -0
  87. package/lib/app/snapshot-subscribe.d.ts +34 -0
  88. package/lib/app/snapshot-subscribe.js +110 -0
  89. package/lib/app/theme.d.ts +194 -0
  90. package/lib/app/theme.js +186 -0
  91. package/lib/app/ticker.d.ts +7 -0
  92. package/lib/app/ticker.js +53 -0
  93. package/lib/boot.d.ts +1 -0
  94. package/lib/boot.js +34 -0
  95. package/lib/commands.d.ts +49 -0
  96. package/lib/commands.js +115 -0
  97. package/lib/contract.d.ts +1973 -0
  98. package/lib/contract.js +36 -0
  99. package/lib/core/agent-roles.d.ts +52 -0
  100. package/lib/core/agent-roles.js +274 -0
  101. package/lib/core/approval-floor.d.ts +183 -0
  102. package/lib/core/approval-floor.js +679 -0
  103. package/lib/core/approval.d.ts +42 -0
  104. package/lib/core/approval.js +8 -0
  105. package/lib/core/audit.d.ts +61 -0
  106. package/lib/core/audit.js +59 -0
  107. package/lib/core/boot-notices.d.ts +6 -0
  108. package/lib/core/boot-notices.js +61 -0
  109. package/lib/core/cdp/actions.d.ts +182 -0
  110. package/lib/core/cdp/actions.js +649 -0
  111. package/lib/core/cdp/launch.d.ts +192 -0
  112. package/lib/core/cdp/launch.js +491 -0
  113. package/lib/core/cdp/snapshot.d.ts +139 -0
  114. package/lib/core/cdp/snapshot.js +316 -0
  115. package/lib/core/cdp/transport.d.ts +160 -0
  116. package/lib/core/cdp/transport.js +359 -0
  117. package/lib/core/command-policy.d.ts +108 -0
  118. package/lib/core/command-policy.js +580 -0
  119. package/lib/core/commands-completion.d.ts +78 -0
  120. package/lib/core/commands-completion.js +167 -0
  121. package/lib/core/compact-anchors.d.ts +76 -0
  122. package/lib/core/compact-anchors.js +284 -0
  123. package/lib/core/compact.d.ts +110 -0
  124. package/lib/core/compact.js +210 -0
  125. package/lib/core/config-store.d.ts +38 -0
  126. package/lib/core/config-store.js +307 -0
  127. package/lib/core/config.d.ts +36 -0
  128. package/lib/core/config.js +124 -0
  129. package/lib/core/connection-test.d.ts +60 -0
  130. package/lib/core/connection-test.js +84 -0
  131. package/lib/core/desktop-control.d.ts +298 -0
  132. package/lib/core/desktop-control.js +1311 -0
  133. package/lib/core/diff-text.d.ts +74 -0
  134. package/lib/core/diff-text.js +257 -0
  135. package/lib/core/dock-browser.d.ts +137 -0
  136. package/lib/core/dock-browser.js +146 -0
  137. package/lib/core/dock-ops.d.ts +59 -0
  138. package/lib/core/dock-ops.js +104 -0
  139. package/lib/core/dock-session.d.ts +39 -0
  140. package/lib/core/dock-session.js +28 -0
  141. package/lib/core/dsh-compat/hook.d.ts +18 -0
  142. package/lib/core/dsh-compat/hook.js +52 -0
  143. package/lib/core/dsh-compat/resolve-hook.d.ts +5 -0
  144. package/lib/core/dsh-compat/resolve-hook.js +59 -0
  145. package/lib/core/dsh-compat/tools-facade.d.ts +47 -0
  146. package/lib/core/dsh-compat/tools-facade.js +108 -0
  147. package/lib/core/err-text.d.ts +13 -0
  148. package/lib/core/err-text.js +15 -0
  149. package/lib/core/events.d.ts +149 -0
  150. package/lib/core/events.js +1 -0
  151. package/lib/core/git-exec.d.ts +23 -0
  152. package/lib/core/git-exec.js +72 -0
  153. package/lib/core/git-info.d.ts +47 -0
  154. package/lib/core/git-info.js +157 -0
  155. package/lib/core/goal.d.ts +89 -0
  156. package/lib/core/goal.js +189 -0
  157. package/lib/core/hooks.d.ts +272 -0
  158. package/lib/core/hooks.js +818 -0
  159. package/lib/core/host-browser-link.d.ts +59 -0
  160. package/lib/core/host-browser-link.js +9 -0
  161. package/lib/core/host-methods.d.ts +25 -0
  162. package/lib/core/host-methods.js +103 -0
  163. package/lib/core/image-diet.d.ts +77 -0
  164. package/lib/core/image-diet.js +127 -0
  165. package/lib/core/learnings/ledger.d.ts +73 -0
  166. package/lib/core/learnings/ledger.js +273 -0
  167. package/lib/core/learnings/skill-write.d.ts +250 -0
  168. package/lib/core/learnings/skill-write.js +854 -0
  169. package/lib/core/learnings/store.d.ts +102 -0
  170. package/lib/core/learnings/store.js +266 -0
  171. package/lib/core/lifecycle-hooks.d.ts +189 -0
  172. package/lib/core/lifecycle-hooks.js +576 -0
  173. package/lib/core/llm.d.ts +283 -0
  174. package/lib/core/llm.js +565 -0
  175. package/lib/core/lockfile.d.ts +17 -0
  176. package/lib/core/lockfile.js +110 -0
  177. package/lib/core/loop.d.ts +185 -0
  178. package/lib/core/loop.js +587 -0
  179. package/lib/core/lsp/client.d.ts +189 -0
  180. package/lib/core/lsp/client.js +690 -0
  181. package/lib/core/lsp/framing.d.ts +84 -0
  182. package/lib/core/lsp/framing.js +181 -0
  183. package/lib/core/lsp/line-shift.d.ts +28 -0
  184. package/lib/core/lsp/line-shift.js +127 -0
  185. package/lib/core/lsp/manager.d.ts +93 -0
  186. package/lib/core/lsp/manager.js +418 -0
  187. package/lib/core/lsp/normalize.d.ts +32 -0
  188. package/lib/core/lsp/normalize.js +139 -0
  189. package/lib/core/lsp/servers.d.ts +106 -0
  190. package/lib/core/lsp/servers.js +352 -0
  191. package/lib/core/lsp/uri.d.ts +76 -0
  192. package/lib/core/lsp/uri.js +179 -0
  193. package/lib/core/market.d.ts +51 -0
  194. package/lib/core/market.js +358 -0
  195. package/lib/core/mcp.d.ts +201 -0
  196. package/lib/core/mcp.js +836 -0
  197. package/lib/core/memory-eval.d.ts +158 -0
  198. package/lib/core/memory-eval.js +215 -0
  199. package/lib/core/memory.d.ts +266 -0
  200. package/lib/core/memory.js +703 -0
  201. package/lib/core/mention.d.ts +57 -0
  202. package/lib/core/mention.js +129 -0
  203. package/lib/core/microcompact.d.ts +48 -0
  204. package/lib/core/microcompact.js +79 -0
  205. package/lib/core/migrate.d.ts +56 -0
  206. package/lib/core/migrate.js +134 -0
  207. package/lib/core/model-caps.d.ts +83 -0
  208. package/lib/core/model-caps.js +150 -0
  209. package/lib/core/model-discovery.d.ts +19 -0
  210. package/lib/core/model-discovery.js +69 -0
  211. package/lib/core/modes.d.ts +72 -0
  212. package/lib/core/modes.js +152 -0
  213. package/lib/core/native-bridge.d.ts +135 -0
  214. package/lib/core/native-bridge.js +563 -0
  215. package/lib/core/path-policy.d.ts +32 -0
  216. package/lib/core/path-policy.js +248 -0
  217. package/lib/core/permission-presets.d.ts +67 -0
  218. package/lib/core/permission-presets.js +75 -0
  219. package/lib/core/plugin-loader.d.ts +36 -0
  220. package/lib/core/plugin-loader.js +294 -0
  221. package/lib/core/plugin-registry.d.ts +113 -0
  222. package/lib/core/plugin-registry.js +256 -0
  223. package/lib/core/prefs.d.ts +82 -0
  224. package/lib/core/prefs.js +372 -0
  225. package/lib/core/presets.d.ts +80 -0
  226. package/lib/core/presets.js +373 -0
  227. package/lib/core/pricing.d.ts +90 -0
  228. package/lib/core/pricing.js +126 -0
  229. package/lib/core/prompt.d.ts +92 -0
  230. package/lib/core/prompt.js +339 -0
  231. package/lib/core/ptc.d.ts +66 -0
  232. package/lib/core/ptc.js +70 -0
  233. package/lib/core/remote/frames.d.ts +91 -0
  234. package/lib/core/remote/frames.js +174 -0
  235. package/lib/core/remote/notify.d.ts +54 -0
  236. package/lib/core/remote/notify.js +77 -0
  237. package/lib/core/remote/owner.d.ts +32 -0
  238. package/lib/core/remote/owner.js +75 -0
  239. package/lib/core/remote/pairing.d.ts +104 -0
  240. package/lib/core/remote/pairing.js +261 -0
  241. package/lib/core/remote/push.d.ts +80 -0
  242. package/lib/core/remote/push.js +222 -0
  243. package/lib/core/remote/store.d.ts +18 -0
  244. package/lib/core/remote/store.js +59 -0
  245. package/lib/core/remote/tickets.d.ts +20 -0
  246. package/lib/core/remote/tickets.js +49 -0
  247. package/lib/core/remote/uploads.d.ts +63 -0
  248. package/lib/core/remote/uploads.js +161 -0
  249. package/lib/core/request-attribution.d.ts +26 -0
  250. package/lib/core/request-attribution.js +86 -0
  251. package/lib/core/request-invariant.d.ts +61 -0
  252. package/lib/core/request-invariant.js +199 -0
  253. package/lib/core/sandbox/backends.d.ts +64 -0
  254. package/lib/core/sandbox/backends.js +194 -0
  255. package/lib/core/sandbox/execpolicy.d.ts +93 -0
  256. package/lib/core/sandbox/execpolicy.js +452 -0
  257. package/lib/core/sandbox/net-proxy.d.ts +31 -0
  258. package/lib/core/sandbox/net-proxy.js +162 -0
  259. package/lib/core/sandbox/policy.d.ts +211 -0
  260. package/lib/core/sandbox/policy.js +559 -0
  261. package/lib/core/sandbox/win/abi.d.ts +161 -0
  262. package/lib/core/sandbox/win/abi.js +169 -0
  263. package/lib/core/sandbox/win/account.d.ts +71 -0
  264. package/lib/core/sandbox/win/account.js +206 -0
  265. package/lib/core/sandbox/win/acl.d.ts +54 -0
  266. package/lib/core/sandbox/win/acl.js +339 -0
  267. package/lib/core/sandbox/win/backend.d.ts +61 -0
  268. package/lib/core/sandbox/win/backend.js +249 -0
  269. package/lib/core/sandbox/win/doctor.d.ts +24 -0
  270. package/lib/core/sandbox/win/doctor.js +272 -0
  271. package/lib/core/sandbox/win/ffi.d.ts +107 -0
  272. package/lib/core/sandbox/win/ffi.js +166 -0
  273. package/lib/core/sandbox/win/net-abi.d.ts +154 -0
  274. package/lib/core/sandbox/win/net-abi.js +316 -0
  275. package/lib/core/sandbox/win/runner-entry.d.ts +35 -0
  276. package/lib/core/sandbox/win/runner-entry.js +391 -0
  277. package/lib/core/sandbox/win/setup.d.ts +60 -0
  278. package/lib/core/sandbox/win/setup.js +986 -0
  279. package/lib/core/sandbox/win/token.d.ts +35 -0
  280. package/lib/core/sandbox/win/token.js +238 -0
  281. package/lib/core/sandbox/win/wfp.d.ts +41 -0
  282. package/lib/core/sandbox/win/wfp.js +200 -0
  283. package/lib/core/sandbox/win/workspace-sid.d.ts +9 -0
  284. package/lib/core/sandbox/win/workspace-sid.js +45 -0
  285. package/lib/core/schedule/rule.d.ts +184 -0
  286. package/lib/core/schedule/rule.js +745 -0
  287. package/lib/core/schedule/runner.d.ts +185 -0
  288. package/lib/core/schedule/runner.js +678 -0
  289. package/lib/core/schedule/store.d.ts +182 -0
  290. package/lib/core/schedule/store.js +455 -0
  291. package/lib/core/secrets.d.ts +41 -0
  292. package/lib/core/secrets.js +150 -0
  293. package/lib/core/session-export.d.ts +18 -0
  294. package/lib/core/session-export.js +73 -0
  295. package/lib/core/session-index.d.ts +159 -0
  296. package/lib/core/session-index.js +683 -0
  297. package/lib/core/session-meta.d.ts +41 -0
  298. package/lib/core/session-meta.js +97 -0
  299. package/lib/core/session.d.ts +356 -0
  300. package/lib/core/session.js +998 -0
  301. package/lib/core/skills.d.ts +60 -0
  302. package/lib/core/skills.js +171 -0
  303. package/lib/core/spill.d.ts +159 -0
  304. package/lib/core/spill.js +329 -0
  305. package/lib/core/surface-registry.d.ts +45 -0
  306. package/lib/core/surface-registry.js +67 -0
  307. package/lib/core/team-board.d.ts +95 -0
  308. package/lib/core/team-board.js +316 -0
  309. package/lib/core/throughput.d.ts +46 -0
  310. package/lib/core/throughput.js +40 -0
  311. package/lib/core/todo-reminder.d.ts +44 -0
  312. package/lib/core/todo-reminder.js +55 -0
  313. package/lib/core/todo.d.ts +81 -0
  314. package/lib/core/todo.js +222 -0
  315. package/lib/core/token-estimate.d.ts +55 -0
  316. package/lib/core/token-estimate.js +82 -0
  317. package/lib/core/tool-guards.d.ts +103 -0
  318. package/lib/core/tool-guards.js +77 -0
  319. package/lib/core/tool-search.d.ts +152 -0
  320. package/lib/core/tool-search.js +311 -0
  321. package/lib/core/tools/bash.d.ts +281 -0
  322. package/lib/core/tools/bash.js +871 -0
  323. package/lib/core/tools/command-runner.d.ts +84 -0
  324. package/lib/core/tools/command-runner.js +68 -0
  325. package/lib/core/tools/fs-tools.d.ts +23 -0
  326. package/lib/core/tools/fs-tools.js +247 -0
  327. package/lib/core/tools/index.d.ts +8 -0
  328. package/lib/core/tools/index.js +4 -0
  329. package/lib/core/tools/sandbox-args.d.ts +51 -0
  330. package/lib/core/tools/sandbox-args.js +90 -0
  331. package/lib/core/tools/search-tools.d.ts +3 -0
  332. package/lib/core/tools/search-tools.js +153 -0
  333. package/lib/core/tools.d.ts +96 -0
  334. package/lib/core/tools.js +53 -0
  335. package/lib/core/ui-boot-source.d.ts +71 -0
  336. package/lib/core/ui-boot-source.js +121 -0
  337. package/lib/core/ui-bundles.d.ts +249 -0
  338. package/lib/core/ui-bundles.js +830 -0
  339. package/lib/core/ui-combo.d.ts +49 -0
  340. package/lib/core/ui-combo.js +55 -0
  341. package/lib/core/ui-events.d.ts +81 -0
  342. package/lib/core/ui-events.js +364 -0
  343. package/lib/core/ui-hmr.d.ts +36 -0
  344. package/lib/core/ui-hmr.js +128 -0
  345. package/lib/core/ui-methods.d.ts +69 -0
  346. package/lib/core/ui-methods.js +341 -0
  347. package/lib/core/ui-route.d.ts +69 -0
  348. package/lib/core/ui-route.js +122 -0
  349. package/lib/core/ui-server.d.ts +75 -0
  350. package/lib/core/ui-server.js +369 -0
  351. package/lib/core/ui-trust.d.ts +47 -0
  352. package/lib/core/ui-trust.js +164 -0
  353. package/lib/core/untrusted.d.ts +30 -0
  354. package/lib/core/untrusted.js +48 -0
  355. package/lib/core/update-check.d.ts +81 -0
  356. package/lib/core/update-check.js +177 -0
  357. package/lib/core/usage-log.d.ts +82 -0
  358. package/lib/core/usage-log.js +306 -0
  359. package/lib/core/version.d.ts +1 -0
  360. package/lib/core/version.js +37 -0
  361. package/lib/core/web-http.d.ts +57 -0
  362. package/lib/core/web-http.js +137 -0
  363. package/lib/core/web-static.d.ts +31 -0
  364. package/lib/core/web-static.js +75 -0
  365. package/lib/headless.d.ts +1 -0
  366. package/lib/headless.js +31 -0
  367. package/lib/host/kernel.d.ts +33 -0
  368. package/lib/host/kernel.js +451 -0
  369. package/lib/index.d.ts +41 -0
  370. package/lib/index.js +35 -0
  371. package/lib/plugins/agent.d.ts +2 -0
  372. package/lib/plugins/agent.js +274 -0
  373. package/lib/plugins/approval-floor.d.ts +2 -0
  374. package/lib/plugins/approval-floor.js +223 -0
  375. package/lib/plugins/approval.d.ts +16 -0
  376. package/lib/plugins/approval.js +674 -0
  377. package/lib/plugins/ask.d.ts +2 -0
  378. package/lib/plugins/ask.js +245 -0
  379. package/lib/plugins/browser.d.ts +68 -0
  380. package/lib/plugins/browser.js +1341 -0
  381. package/lib/plugins/commands.d.ts +23 -0
  382. package/lib/plugins/commands.js +498 -0
  383. package/lib/plugins/compact.d.ts +21 -0
  384. package/lib/plugins/compact.js +274 -0
  385. package/lib/plugins/computer-use.d.ts +47 -0
  386. package/lib/plugins/computer-use.js +539 -0
  387. package/lib/plugins/desktop-dock.d.ts +2 -0
  388. package/lib/plugins/desktop-dock.js +626 -0
  389. package/lib/plugins/dock-browser.d.ts +34 -0
  390. package/lib/plugins/dock-browser.js +765 -0
  391. package/lib/plugins/dsh-compat.d.ts +25 -0
  392. package/lib/plugins/dsh-compat.js +37 -0
  393. package/lib/plugins/file-review.d.ts +108 -0
  394. package/lib/plugins/file-review.js +393 -0
  395. package/lib/plugins/git.d.ts +26 -0
  396. package/lib/plugins/git.js +132 -0
  397. package/lib/plugins/goal.d.ts +20 -0
  398. package/lib/plugins/goal.js +245 -0
  399. package/lib/plugins/guards.d.ts +14 -0
  400. package/lib/plugins/guards.js +18 -0
  401. package/lib/plugins/hooks.d.ts +19 -0
  402. package/lib/plugins/hooks.js +583 -0
  403. package/lib/plugins/host-stdio.d.ts +88 -0
  404. package/lib/plugins/host-stdio.js +317 -0
  405. package/lib/plugins/image-diet.d.ts +17 -0
  406. package/lib/plugins/image-diet.js +85 -0
  407. package/lib/plugins/lifecycle-hooks.d.ts +26 -0
  408. package/lib/plugins/lifecycle-hooks.js +338 -0
  409. package/lib/plugins/llm.d.ts +13 -0
  410. package/lib/plugins/llm.js +215 -0
  411. package/lib/plugins/lsp.d.ts +54 -0
  412. package/lib/plugins/lsp.js +608 -0
  413. package/lib/plugins/mcp.d.ts +16 -0
  414. package/lib/plugins/mcp.js +673 -0
  415. package/lib/plugins/memory.d.ts +17 -0
  416. package/lib/plugins/memory.js +858 -0
  417. package/lib/plugins/microcompact.d.ts +18 -0
  418. package/lib/plugins/microcompact.js +119 -0
  419. package/lib/plugins/mode.d.ts +18 -0
  420. package/lib/plugins/mode.js +115 -0
  421. package/lib/plugins/permission-presets.d.ts +18 -0
  422. package/lib/plugins/permission-presets.js +135 -0
  423. package/lib/plugins/plan.d.ts +2 -0
  424. package/lib/plugins/plan.js +192 -0
  425. package/lib/plugins/plugin-manager.d.ts +2 -0
  426. package/lib/plugins/plugin-manager.js +165 -0
  427. package/lib/plugins/presets.d.ts +2 -0
  428. package/lib/plugins/presets.js +182 -0
  429. package/lib/plugins/prompt.d.ts +2 -0
  430. package/lib/plugins/prompt.js +264 -0
  431. package/lib/plugins/ptc.d.ts +2 -0
  432. package/lib/plugins/ptc.js +272 -0
  433. package/lib/plugins/remote/http.d.ts +11 -0
  434. package/lib/plugins/remote/http.js +11 -0
  435. package/lib/plugins/remote/routes.d.ts +24 -0
  436. package/lib/plugins/remote/routes.js +384 -0
  437. package/lib/plugins/remote/types.d.ts +135 -0
  438. package/lib/plugins/remote/types.js +87 -0
  439. package/lib/plugins/remote.d.ts +17 -0
  440. package/lib/plugins/remote.js +1028 -0
  441. package/lib/plugins/runtime-api.d.ts +16 -0
  442. package/lib/plugins/runtime-api.js +99 -0
  443. package/lib/plugins/runtime.d.ts +10 -0
  444. package/lib/plugins/runtime.js +451 -0
  445. package/lib/plugins/sandbox.d.ts +2 -0
  446. package/lib/plugins/sandbox.js +761 -0
  447. package/lib/plugins/schedule.d.ts +26 -0
  448. package/lib/plugins/schedule.js +538 -0
  449. package/lib/plugins/self-improve.d.ts +61 -0
  450. package/lib/plugins/self-improve.js +953 -0
  451. package/lib/plugins/session-search.d.ts +16 -0
  452. package/lib/plugins/session-search.js +308 -0
  453. package/lib/plugins/session-title.d.ts +19 -0
  454. package/lib/plugins/session-title.js +109 -0
  455. package/lib/plugins/session.d.ts +7 -0
  456. package/lib/plugins/session.js +296 -0
  457. package/lib/plugins/settings.d.ts +3 -0
  458. package/lib/plugins/settings.js +705 -0
  459. package/lib/plugins/skills.d.ts +2 -0
  460. package/lib/plugins/skills.js +360 -0
  461. package/lib/plugins/spill.d.ts +16 -0
  462. package/lib/plugins/spill.js +200 -0
  463. package/lib/plugins/subagent.d.ts +2 -0
  464. package/lib/plugins/subagent.js +896 -0
  465. package/lib/plugins/surfaces.d.ts +11 -0
  466. package/lib/plugins/surfaces.js +20 -0
  467. package/lib/plugins/team.d.ts +16 -0
  468. package/lib/plugins/team.js +149 -0
  469. package/lib/plugins/todo.d.ts +19 -0
  470. package/lib/plugins/todo.js +188 -0
  471. package/lib/plugins/tool-search.d.ts +2 -0
  472. package/lib/plugins/tool-search.js +434 -0
  473. package/lib/plugins/tool-search.js.nv-backup +434 -0
  474. package/lib/plugins/tools-default.d.ts +12 -0
  475. package/lib/plugins/tools-default.js +275 -0
  476. package/lib/plugins/tools.d.ts +16 -0
  477. package/lib/plugins/tools.js +62 -0
  478. package/lib/plugins/transcript.d.ts +15 -0
  479. package/lib/plugins/transcript.js +311 -0
  480. package/lib/plugins/tui.d.ts +2 -0
  481. package/lib/plugins/tui.js +98 -0
  482. package/lib/plugins/waiting.d.ts +12 -0
  483. package/lib/plugins/waiting.js +34 -0
  484. package/lib/plugins/web-search.d.ts +14 -0
  485. package/lib/plugins/web-search.js +263 -0
  486. package/lib/plugins/webserver.d.ts +48 -0
  487. package/lib/plugins/webserver.js +228 -0
  488. package/lib/remote/assets/app-DAcUCOEn.js +14 -0
  489. package/lib/remote/assets/icon-192.png +0 -0
  490. package/lib/remote/assets/icon-512.png +0 -0
  491. package/lib/remote/assets/index.html +34 -0
  492. package/lib/remote/assets/manifest.json +27 -0
  493. package/lib/remote/assets/style-DIB6729x.css +1 -0
  494. package/lib/remote/assets/sw.js +66 -0
  495. package/lib/services/types.d.ts +1228 -0
  496. package/lib/services/types.js +1 -0
  497. package/lib/tools/config-cli.d.ts +1 -0
  498. package/lib/tools/config-cli.js +89 -0
  499. package/lib/ui/arrival.d.ts +72 -0
  500. package/lib/ui/arrival.js +105 -0
  501. package/lib/ui/assets/app-B70nVIKd.js +69 -0
  502. package/lib/ui/assets/chunk-2UxHyX5q.js +1 -0
  503. package/lib/ui/assets/chunk-B1dDrJ26.js +1 -0
  504. package/lib/ui/assets/chunk-B6aJPvgy.js +1 -0
  505. package/lib/ui/assets/chunk-BEwlwnbL.js +1 -0
  506. package/lib/ui/assets/chunk-BGcgwlCI.js +12 -0
  507. package/lib/ui/assets/chunk-BIGW1oBm.js +1 -0
  508. package/lib/ui/assets/chunk-BPQ3VLAy.js +1 -0
  509. package/lib/ui/assets/chunk-BRH0KZbk.js +141 -0
  510. package/lib/ui/assets/chunk-BX6H_ySx.js +1 -0
  511. package/lib/ui/assets/chunk-B_P3UbPa.js +1 -0
  512. package/lib/ui/assets/chunk-B_TYUkTI.js +1 -0
  513. package/lib/ui/assets/chunk-B_vNuMnf.js +1 -0
  514. package/lib/ui/assets/chunk-BajyYBss.js +10 -0
  515. package/lib/ui/assets/chunk-BdnUsdx6.js +1 -0
  516. package/lib/ui/assets/chunk-Buea-lGh.js +1 -0
  517. package/lib/ui/assets/chunk-C0PvZCCE.js +1 -0
  518. package/lib/ui/assets/chunk-C0m74zRD.js +1 -0
  519. package/lib/ui/assets/chunk-C27-OAKa.js +1 -0
  520. package/lib/ui/assets/chunk-C2oV4EkX.js +1 -0
  521. package/lib/ui/assets/chunk-C7zT0LnQ.js +1 -0
  522. package/lib/ui/assets/chunk-C9GSunVT.js +1 -0
  523. package/lib/ui/assets/chunk-C9tS-k6U.js +1 -0
  524. package/lib/ui/assets/chunk-CHLpvVh8.js +1 -0
  525. package/lib/ui/assets/chunk-CLxacb5B.js +1 -0
  526. package/lib/ui/assets/chunk-COt5Ahok.js +1 -0
  527. package/lib/ui/assets/chunk-CPTIWCL2.js +1 -0
  528. package/lib/ui/assets/chunk-CQLl-L-p.js +1 -0
  529. package/lib/ui/assets/chunk-CUWRgxuq.js +55 -0
  530. package/lib/ui/assets/chunk-CWanVSXC.js +1 -0
  531. package/lib/ui/assets/chunk-Cf5RLm7j.js +1 -0
  532. package/lib/ui/assets/chunk-CickPsom.js +1 -0
  533. package/lib/ui/assets/chunk-Cj5Yp3dK.js +1 -0
  534. package/lib/ui/assets/chunk-Cmh6b_Ma.js +1 -0
  535. package/lib/ui/assets/chunk-Cp-IABpG.js +1 -0
  536. package/lib/ui/assets/chunk-CqE71os6.js +1 -0
  537. package/lib/ui/assets/chunk-CtKP3W-j.js +1 -0
  538. package/lib/ui/assets/chunk-Cvjx9yec.js +1 -0
  539. package/lib/ui/assets/chunk-CxGP3dtY.js +1 -0
  540. package/lib/ui/assets/chunk-CylS5w8V.js +1 -0
  541. package/lib/ui/assets/chunk-D38fbIBN.js +1 -0
  542. package/lib/ui/assets/chunk-D97Zzqfu.js +1 -0
  543. package/lib/ui/assets/chunk-DAi9KRSo.js +1 -0
  544. package/lib/ui/assets/chunk-DHK4yRfg.js +1 -0
  545. package/lib/ui/assets/chunk-DJeabLx-.js +1 -0
  546. package/lib/ui/assets/chunk-DNRxmY5a.js +1 -0
  547. package/lib/ui/assets/chunk-DNSN1z5r.js +1 -0
  548. package/lib/ui/assets/chunk-DNasK_ZG.js +1 -0
  549. package/lib/ui/assets/chunk-DPvrY3IQ.js +1 -0
  550. package/lib/ui/assets/chunk-DXmwc3jG.js +1 -0
  551. package/lib/ui/assets/chunk-Dd0kTxKP.js +1 -0
  552. package/lib/ui/assets/chunk-De0Btta0.js +1 -0
  553. package/lib/ui/assets/chunk-Des-eS-w.js +1 -0
  554. package/lib/ui/assets/chunk-Df6bDoY_.js +1 -0
  555. package/lib/ui/assets/chunk-DijEV5ha.js +1 -0
  556. package/lib/ui/assets/chunk-DkvoVjww.js +1 -0
  557. package/lib/ui/assets/chunk-DlC-OlHO.js +1 -0
  558. package/lib/ui/assets/chunk-DnzrXTVv.js +1 -0
  559. package/lib/ui/assets/chunk-Dualf0xi.js +1 -0
  560. package/lib/ui/assets/chunk-EXT84bkm.js +1 -0
  561. package/lib/ui/assets/chunk-GwR3hkPK.js +1 -0
  562. package/lib/ui/assets/chunk-P80f7IUj.js +1 -0
  563. package/lib/ui/assets/chunk-VOosw3JB.js +1 -0
  564. package/lib/ui/assets/chunk-YQ4lDkt_.js +140 -0
  565. package/lib/ui/assets/chunk-Yzrsuije.js +1 -0
  566. package/lib/ui/assets/chunk-Z72CF80r.js +1 -0
  567. package/lib/ui/assets/chunk-g9-lgVsj.js +1 -0
  568. package/lib/ui/assets/chunk-vGWfd6FD.js +1 -0
  569. package/lib/ui/assets/chunk-wDzz0qaB.js +1 -0
  570. package/lib/ui/assets/chunk-ySF7HWmS.js +1 -0
  571. package/lib/ui/assets/icon.png +0 -0
  572. package/lib/ui/assets/index.html +14 -0
  573. package/lib/ui/assets/pdf.worker.min-CjEcRF4W.mjs +28 -0
  574. package/lib/ui/assets/style-Bq01xH_b.css +1 -0
  575. package/lib/ui/frames.d.ts +67 -0
  576. package/lib/ui/frames.js +146 -0
  577. package/lib/ui/index.d.ts +59 -0
  578. package/lib/ui/index.js +50 -0
  579. package/lib/ui/manifest.d.ts +172 -0
  580. package/lib/ui/manifest.js +158 -0
  581. package/lib/ui/plugin.d.ts +161 -0
  582. package/lib/ui/plugin.js +7 -0
  583. package/lib/ui/plugins/browser/client.js +290 -0
  584. package/lib/ui/plugins/browser/icon.png +0 -0
  585. package/lib/ui/plugins/composer/client.js +1843 -0
  586. package/lib/ui/plugins/composer/icon.png +0 -0
  587. package/lib/ui/plugins/files/client.js +646 -0
  588. package/lib/ui/plugins/files/icon.png +0 -0
  589. package/lib/ui/plugins/manifest.json +107 -0
  590. package/lib/ui/plugins/plugins/client.js +682 -0
  591. package/lib/ui/plugins/plugins/icon.png +0 -0
  592. package/lib/ui/plugins/preview/client.js +197 -0
  593. package/lib/ui/plugins/preview/icon.png +0 -0
  594. package/lib/ui/plugins/prompt/client.js +653 -0
  595. package/lib/ui/plugins/prompt/icon.png +0 -0
  596. package/lib/ui/plugins/sessions/client.js +1577 -0
  597. package/lib/ui/plugins/sessions/icon.png +0 -0
  598. package/lib/ui/plugins/settings/client.js +5470 -0
  599. package/lib/ui/plugins/settings/icon.png +0 -0
  600. package/lib/ui/plugins/skills/client.js +485 -0
  601. package/lib/ui/plugins/skills/icon.png +0 -0
  602. package/lib/ui/plugins/status/client.js +1420 -0
  603. package/lib/ui/plugins/status/icon.png +0 -0
  604. package/lib/ui/plugins/statusbar/client.js +504 -0
  605. package/lib/ui/plugins/statusbar/icon.png +0 -0
  606. package/lib/ui/plugins/tasks/client.js +52 -0
  607. package/lib/ui/plugins/tasks/icon.png +0 -0
  608. package/lib/ui/plugins/team/client.js +527 -0
  609. package/lib/ui/plugins/team/icon.png +0 -0
  610. package/lib/ui/plugins/terminal/client.js +232 -0
  611. package/lib/ui/plugins/terminal/icon.png +0 -0
  612. package/lib/ui/plugins/trace/client.js +1376 -0
  613. package/lib/ui/plugins/trace/icon.png +0 -0
  614. package/lib/ui/plugins/transcript/client.js +2661 -0
  615. package/lib/ui/plugins/transcript/icon.png +0 -0
  616. package/lib/ui/scoped-slots.d.ts +20 -0
  617. package/lib/ui/scoped-slots.js +21 -0
  618. package/lib/ui/sdk/@dsc/ui/index.d.ts +242 -0
  619. package/lib/ui/sdk/@dsc/ui/package.json +16 -0
  620. package/lib/ui/sdk/@dsc/ui-core/contract.d.ts +1973 -0
  621. package/lib/ui/sdk/@dsc/ui-core/core/diff-text.d.ts +74 -0
  622. package/lib/ui/sdk/@dsc/ui-core/core/dock-browser.d.ts +137 -0
  623. package/lib/ui/sdk/@dsc/ui-core/core/dock-ops.d.ts +59 -0
  624. package/lib/ui/sdk/@dsc/ui-core/core/model-caps.d.ts +83 -0
  625. package/lib/ui/sdk/@dsc/ui-core/core/native-bridge.d.ts +135 -0
  626. package/lib/ui/sdk/@dsc/ui-core/core/token-estimate.d.ts +55 -0
  627. package/lib/ui/sdk/@dsc/ui-core/package.json +16 -0
  628. package/lib/ui/sdk/@dsc/ui-core/ui/arrival.d.ts +72 -0
  629. package/lib/ui/sdk/@dsc/ui-core/ui/frames.d.ts +67 -0
  630. package/lib/ui/sdk/@dsc/ui-core/ui/index.d.ts +59 -0
  631. package/lib/ui/sdk/@dsc/ui-core/ui/manifest.d.ts +172 -0
  632. package/lib/ui/sdk/@dsc/ui-core/ui/plugin.d.ts +161 -0
  633. package/lib/ui/sdk/@dsc/ui-core/ui/scoped-slots.d.ts +20 -0
  634. package/lib/ui/sdk/@dsc/ui-core/ui/services-react.d.ts +27 -0
  635. package/lib/ui/sdk/@dsc/ui-core/ui/services.d.ts +63 -0
  636. package/lib/ui/sdk/@dsc/ui-core/ui/slots-react.d.ts +28 -0
  637. package/lib/ui/sdk/@dsc/ui-core/ui/slots.d.ts +481 -0
  638. package/lib/ui/sdk/@dsc/ui-core/ui/store.d.ts +89 -0
  639. package/lib/ui/sdk/@dsc/ui-dockkit/dock-model.d.ts +238 -0
  640. package/lib/ui/sdk/@dsc/ui-dockkit/dock-state.d.ts +163 -0
  641. package/lib/ui/sdk/@dsc/ui-dockkit/dock.d.ts +24 -0
  642. package/lib/ui/sdk/@dsc/ui-dockkit/index.d.ts +15 -0
  643. package/lib/ui/sdk/@dsc/ui-dockkit/package.json +16 -0
  644. package/lib/ui/sdk/@dsc/ui-layout/app.d.ts +74 -0
  645. package/lib/ui/sdk/@dsc/ui-layout/appearance.d.ts +70 -0
  646. package/lib/ui/sdk/@dsc/ui-layout/host-channel.d.ts +112 -0
  647. package/lib/ui/sdk/@dsc/ui-layout/index.d.ts +34 -0
  648. package/lib/ui/sdk/@dsc/ui-layout/package.json +16 -0
  649. package/lib/ui/sdk/@dsc/ui-layout/page-state.d.ts +14 -0
  650. package/lib/ui/sdk/@dsc/ui-layout/review-pane.d.ts +21 -0
  651. package/lib/ui/sdk/@dsc/ui-layout/runtime-context.d.ts +44 -0
  652. package/lib/ui/sdk/@dsc/ui-layout/thread-view.d.ts +28 -0
  653. package/lib/ui/sdk/@dsc/ui-layout/update-button.d.ts +21 -0
  654. package/lib/ui/sdk/@dsc/ui-primitives/code-file-icon-artwork.d.ts +53 -0
  655. package/lib/ui/sdk/@dsc/ui-primitives/code-view.d.ts +15 -0
  656. package/lib/ui/sdk/@dsc/ui-primitives/compat.d.ts +27 -0
  657. package/lib/ui/sdk/@dsc/ui-primitives/completion-sound.d.ts +24 -0
  658. package/lib/ui/sdk/@dsc/ui-primitives/confirm.d.ts +33 -0
  659. package/lib/ui/sdk/@dsc/ui-primitives/css.d.ts +47 -0
  660. package/lib/ui/sdk/@dsc/ui-primitives/diff-rows.d.ts +20 -0
  661. package/lib/ui/sdk/@dsc/ui-primitives/file-icons.d.ts +38 -0
  662. package/lib/ui/sdk/@dsc/ui-primitives/file-type-classify.d.ts +66 -0
  663. package/lib/ui/sdk/@dsc/ui-primitives/file-type-icon.d.ts +57 -0
  664. package/lib/ui/sdk/@dsc/ui-primitives/highlight.d.ts +24 -0
  665. package/lib/ui/sdk/@dsc/ui-primitives/hover-delay.d.ts +17 -0
  666. package/lib/ui/sdk/@dsc/ui-primitives/icons.d.ts +109 -0
  667. package/lib/ui/sdk/@dsc/ui-primitives/index.d.ts +55 -0
  668. package/lib/ui/sdk/@dsc/ui-primitives/lang-table.d.ts +10 -0
  669. package/lib/ui/sdk/@dsc/ui-primitives/markdown.d.ts +20 -0
  670. package/lib/ui/sdk/@dsc/ui-primitives/native.d.ts +41 -0
  671. package/lib/ui/sdk/@dsc/ui-primitives/package.json +16 -0
  672. package/lib/ui/sdk/@dsc/ui-primitives/panels.d.ts +86 -0
  673. package/lib/ui/sdk/@dsc/ui-primitives/paths.d.ts +11 -0
  674. package/lib/ui/sdk/@dsc/ui-primitives/pdf-view.d.ts +13 -0
  675. package/lib/ui/sdk/@dsc/ui-primitives/plugin-text.d.ts +15 -0
  676. package/lib/ui/sdk/@dsc/ui-primitives/select.d.ts +35 -0
  677. package/lib/ui/sdk/@dsc/ui-primitives/table-view.d.ts +23 -0
  678. package/lib/ui/sdk/@dsc/ui-primitives/thread-resizer.d.ts +22 -0
  679. package/lib/ui/sdk/@dsc/ui-primitives/time.d.ts +33 -0
  680. package/lib/ui/sdk/@dsc/ui-primitives/toast.d.ts +16 -0
  681. package/lib/ui/sdk/@dsc/ui-primitives/tokens.d.ts +14 -0
  682. package/lib/ui/sdk/@dsc/ui-primitives/tool-args.d.ts +49 -0
  683. package/lib/ui/sdk/@dsc/ui-primitives/tool-summary.d.ts +64 -0
  684. package/lib/ui/sdk/@dsc/ui-renderer/boot.d.ts +121 -0
  685. package/lib/ui/sdk/@dsc/ui-renderer/hmr.d.ts +43 -0
  686. package/lib/ui/sdk/@dsc/ui-renderer/index.d.ts +20 -0
  687. package/lib/ui/sdk/@dsc/ui-renderer/package.json +16 -0
  688. package/lib/ui/sdk/@dsc/ui-slots/index.d.ts +19 -0
  689. package/lib/ui/sdk/@dsc/ui-slots/package.json +16 -0
  690. package/lib/ui/sdk/@dsc/ui-slots/slots-react.d.ts +48 -0
  691. package/lib/ui/sdk/@dsc/ui-slots/slots.d.ts +102 -0
  692. package/lib/ui/services-react.d.ts +27 -0
  693. package/lib/ui/services-react.js +32 -0
  694. package/lib/ui/services.d.ts +63 -0
  695. package/lib/ui/services.js +121 -0
  696. package/lib/ui/slots-ink.d.ts +26 -0
  697. package/lib/ui/slots-ink.js +78 -0
  698. package/lib/ui/slots-react.d.ts +28 -0
  699. package/lib/ui/slots-react.js +88 -0
  700. package/lib/ui/slots.d.ts +481 -0
  701. package/lib/ui/slots.js +550 -0
  702. package/lib/ui/store.d.ts +89 -0
  703. package/lib/ui/store.js +62 -0
  704. package/lib/ui/tui-plugin-api.d.ts +23 -0
  705. package/lib/ui/tui-plugin-api.js +23 -0
  706. package/lib/ui/tui-plugins.d.ts +47 -0
  707. package/lib/ui/tui-plugins.js +220 -0
  708. package/package.json +58 -6
@@ -0,0 +1,580 @@
1
+ /**
2
+ * 命令策略引擎:把一条 shell 命令切成独立段,逐段判 allow / ask / deny。
3
+ *
4
+ * 形状抄两家成熟做法:
5
+ * - Codex 把命令按 `| ; && || ()` 切段,每段单独判,带重定向/变量赋值的段不许走
6
+ * 已授权规则(`prompts/templates/permissions/approval_policy/on_request.md:3-22`);
7
+ * 规则本身是前缀 DSL:`prefix_rule(pattern=[...], decision=allow|prompt|forbidden)`
8
+ * 外加加载期自检的 `match/not_match` 例子(`execpolicy/README.md:5-24`)。
9
+ * - Hermes 的求值顺序是硬地板 → 用户 deny → 危险模式 → 允许清单,
10
+ * 前面三层绕不过 yolo(`tools/approval_floors.py:5`、`approval_detection.py:52`)。
11
+ *
12
+ * dsc 的落地取舍:规则文件用 JSON(`~/.dsc/policy.rules`)而不是 Starlark,
13
+ * 少一个解析器依赖;危险模式内置在代码里,用户只能加严不能放宽。
14
+ *
15
+ * @module dsc/core/command-policy
16
+ */
17
+ import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
18
+ import { join } from 'node:path';
19
+ import { dscPath } from './path-policy.js';
20
+ /** 用户规则文件路径(和 config.yaml 同级;能手改,也允许审批卡往里追加)。 */
21
+ export const POLICY_RULES_FILE = dscPath('policy.rules');
22
+ const DECISION_SEVERITY = { allow: 0, ask: 1, deny: 2 };
23
+ /** 最严的那个决定就是整条命令的决定。 */
24
+ function strictest(a, b) {
25
+ return DECISION_SEVERITY[b] > DECISION_SEVERITY[a] ? b : a;
26
+ }
27
+ // ---------------------------------------------------------------- 命令切段
28
+ /**
29
+ * 切段点 = shell 真正的分隔符。`&&` `||` 是 2 字符操作符,要在单 `&` 之前认,否则切碎;
30
+ * 单字符认 `;` `|` 与换行(`\n` `\r`)——PowerShell 与 sh 都把换行当命令分隔符,
31
+ * 不切的话「第一行带已授权前缀、第二行干别的」的多行命令会被整段按前缀放行
32
+ * (2026-09-29 审查发现);孤立 `&` 在 POSIX 是后台执行,同样是分隔符,
33
+ * PowerShell 里整条本就是语法错误,切开判只会更严不会更松。
34
+ * `2>&1`(`&` 紧跟在 `>` 后)与 `&>文件`(`&` 后面是 `>`)是重定向,不是分隔符,不能切。
35
+ */
36
+ /**
37
+ * 把命令切成独立段。
38
+ *
39
+ * 不做完整 shell 语法解析(那是 shell 自己的事),只做「够判定」的切分:
40
+ * 认引号(含 PS 的单双引号)、认括号里的子命令、认续行符。
41
+ */
42
+ export function splitSegments(command) {
43
+ const src = command.replace(/\\\r?\n/g, ' ');
44
+ const segments = [];
45
+ let current = '';
46
+ let quote = null;
47
+ let depth = 0;
48
+ const push = () => {
49
+ const raw = current.trim();
50
+ current = '';
51
+ if (raw !== '')
52
+ segments.push(tokenize(raw));
53
+ };
54
+ for (let i = 0; i < src.length; i += 1) {
55
+ const ch = src[i];
56
+ if (quote !== null) {
57
+ current += ch;
58
+ // 单引号里的一切都是字面量(PowerShell 与 sh 一致);双引号/反引号里 \ 可转义。
59
+ if (quote !== "'" && ch === '\\' && i + 1 < src.length) {
60
+ current += src[i + 1];
61
+ i += 1;
62
+ }
63
+ else if (ch === quote)
64
+ quote = null;
65
+ continue;
66
+ }
67
+ if (ch === '"' || ch === "'") {
68
+ quote = ch;
69
+ current += ch;
70
+ continue;
71
+ }
72
+ // 反引号不进引号态:在 sh 里它是命令替换(内容照样执行),在 PowerShell 里行尾反引号是续行。
73
+ // 当引号处理会让替换内容里的 `;`、`|`、换行躲过切段——替换内容必须单独成段受审。
74
+ if (ch === '(' || ch === '$(') {
75
+ // 子 shell:整段留在这里判,但一旦因此判不清就不许走已授权规则。
76
+ depth += 1;
77
+ current += ch;
78
+ continue;
79
+ }
80
+ if (ch === ')') {
81
+ depth = Math.max(0, depth - 1);
82
+ current += ch;
83
+ continue;
84
+ }
85
+ if (depth > 0) {
86
+ current += ch;
87
+ continue;
88
+ }
89
+ const two = src.slice(i, i + 2);
90
+ let op = null;
91
+ if (two === '&&' || two === '||') {
92
+ op = two;
93
+ }
94
+ else if (ch === ';' || ch === '|' || ch === '\n' || ch === '\r') {
95
+ op = ch;
96
+ }
97
+ else if (ch === '&' && two !== '&>' && src[i - 1] !== '>') {
98
+ // 孤立 `&`:POSIX 后台执行分隔符;`2>&1`(前面是 `>`)与 `&>`(后面是 `>`)是重定向,不切。
99
+ op = ch;
100
+ }
101
+ if (op !== null) {
102
+ push();
103
+ if (op.length === 2)
104
+ i += 1;
105
+ continue;
106
+ }
107
+ current += ch;
108
+ }
109
+ push();
110
+ if (segments.length === 0)
111
+ segments.push(tokenize(command.trim()));
112
+ return segments;
113
+ }
114
+ /** 一段命令 → 词元(引号已剥)+ 是否带「不许走规则」的特性。 */
115
+ function tokenize(raw) {
116
+ const tokens = [];
117
+ let buf = '';
118
+ let quote = null;
119
+ let started = false;
120
+ let ruleUnfriendly = false;
121
+ let redirect = false;
122
+ let subst = false;
123
+ const flush = () => {
124
+ if (started)
125
+ tokens.push(buf);
126
+ buf = '';
127
+ started = false;
128
+ };
129
+ for (let i = 0; i < raw.length; i += 1) {
130
+ const ch = raw[i];
131
+ if (quote !== null) {
132
+ if (ch === quote) {
133
+ quote = null;
134
+ }
135
+ else {
136
+ // sh 的双引号里 `$()` 与反引号照样执行(PowerShell 的 `$()` 也是),替换内容得拦下;
137
+ // 单引号里两个 shell 都是字面量,不标记。
138
+ if (quote === '"' && ((ch === '$' && raw[i + 1] === '(') || ch === '`')) {
139
+ ruleUnfriendly = true;
140
+ subst = true;
141
+ }
142
+ buf += ch;
143
+ }
144
+ started = true;
145
+ continue;
146
+ }
147
+ if (ch === '"' || ch === "'" || ch === '`') {
148
+ if (ch === '`') {
149
+ // 引号外的反引号:sh 的命令替换(PowerShell 行尾是续行,从严处理不区分)。
150
+ ruleUnfriendly = true;
151
+ subst = true;
152
+ }
153
+ quote = ch;
154
+ started = true;
155
+ continue;
156
+ }
157
+ if (ch === ' ' || ch === '\t') {
158
+ flush();
159
+ continue;
160
+ }
161
+ // 重定向 / 通配符 / 变量赋值 / 命令替换:规则匹配一律不看这类段(抄 Codex 那段话)。
162
+ if (ch === '>' || ch === '<' || ch === '*' || ch === '?' || ch === '$')
163
+ ruleUnfriendly = true;
164
+ if (ch === '$' && raw[i + 1] === '(')
165
+ subst = true;
166
+ // `>文件` / `>>文件` 是往盘上写;`2>&1` 只是接文件描述符,不算写文件。
167
+ if (ch === '>' && raw[i + 1] !== '&')
168
+ redirect = true;
169
+ if (ch === '=' && buf.length > 0 && /^[A-Za-z_][A-Za-z0-9_]*$/.test(buf))
170
+ ruleUnfriendly = true;
171
+ buf += ch;
172
+ started = true;
173
+ }
174
+ flush();
175
+ return { tokens, raw, ruleUnfriendly, redirect, subst };
176
+ }
177
+ /** 灾难性动作:任何权限模式都拒(抄 Hermes 的 hardline 层)。 */
178
+ const HARDLINE = [
179
+ { name: 'rm-root', re: /\brm\s+(-[a-z]+\s+)*(\/|\/\*|"\/"|'\/')\s*$/i, decision: 'deny', reason: '删掉文件系统根目录' },
180
+ {
181
+ name: 'rm-home',
182
+ re: /\brm\s+-[a-z]*[rf][a-z]*\s+("?\$?\{?(HOME|USERPROFILE)\}?]?~?)"?\s*$/i,
183
+ decision: 'deny',
184
+ reason: '删掉整个用户主目录',
185
+ },
186
+ {
187
+ name: 'ps-remove-volume-root',
188
+ re: /remove-item\b[^|;]*-recur[a-z]*[^|;]*("?[a-z]:\\{1,2}"?|\\?\{1,2}[a-z]:\\)/i,
189
+ decision: 'deny',
190
+ reason: '递归删掉整个盘根目录',
191
+ },
192
+ {
193
+ name: 'ps-remove-windows',
194
+ re: /remove-item\b[^|;]*(windows|system32|program files)/i,
195
+ decision: 'deny',
196
+ reason: '递归删掉 Windows 系统目录或 Program Files',
197
+ },
198
+ {
199
+ // 末尾原来多写了一个 `\b`:`format C:` 的 `:` 后面就是行尾,`\b` 永远不成立,
200
+ // 于是这条 Windows 上最常见的毁盘命令一路漏到审批卡。驱动器号后面必须是空白或行尾,
201
+ // 这样 `dotnet format c:\proj` 这类参数不会被误伤。
202
+ name: 'mkfs',
203
+ re: /(?<![\w-])(mkfs(\.\w+)?\b|format\.com\b|format\s+(\/[\w:-]+\s+)*[a-z]:(\s|$))/i,
204
+ decision: 'deny',
205
+ reason: '格式化磁盘',
206
+ },
207
+ {
208
+ name: 'ps-wipe-disk',
209
+ re: /(?<![\w-])(format-volume|clear-disk|initialize-disk|remove-partition)\b/i,
210
+ decision: 'deny',
211
+ reason: '清空或重排磁盘分区(数据不可恢复)',
212
+ },
213
+ { name: 'diskpart-clean', re: /\bdiskpart\b|\bclean\s+(all|disks?)\b/i, decision: 'deny', reason: '用 diskpart 清盘' },
214
+ { name: 'dd-device', re: /\bdd\b[^\n|;]*of=\/dev\//i, decision: 'deny', reason: '把数据直接写进块设备' },
215
+ { name: 'redirect-device', re: />\s*\/dev\/(sd|nvme|hd|disk)/i, decision: 'deny', reason: '把输出重定向到物理磁盘设备' },
216
+ {
217
+ name: 'shadow-copy-delete',
218
+ re: /vssadmin\s+delete\s+shadows|wbadmin\s+delete\s+systemstate/i,
219
+ decision: 'deny',
220
+ reason: '删除卷影副本(等于关掉最后的回滚手段)',
221
+ },
222
+ { name: 'cipher-wipe', re: /\bcipher\s+\/w[:\s]/i, decision: 'deny', reason: '擦除空闲磁盘簇(不可恢复)' },
223
+ { name: 'nt-device-namespace', re: /\b\\\\[?.]\\/, decision: 'deny', reason: '访问 Windows NT 设备命名空间(绕过路径校验)' },
224
+ ];
225
+ /** 危险动作:弹审批卡,且不许建议持久化前缀。 */
226
+ const DANGEROUS = [
227
+ {
228
+ name: 'recursive-delete',
229
+ re: /\b(rm|rmdir|del|erase|rd|ri|remove-item)\b[^\n|;]*(\s-[a-z]*r[a-z]*\b|--recur[s]|-force)/i,
230
+ decision: 'ask',
231
+ reason: '递归删除(删错就是批量丢文件)',
232
+ },
233
+ { name: 'force-push', re: /\bgit\s+push\b[^\n|;]*(--force\b|-f\b(?!or))|(--force-with-lease)/i, decision: 'ask', reason: '强推会改写远端历史' },
234
+ { name: 'git-reset-hard', re: /\bgit\s+reset\s+--hard\b/i, decision: 'ask', reason: '丢弃未提交改动' },
235
+ { name: 'git-clean', re: /\bgit\s+clean\b[^\n|;]*-[a-z]*f/i, decision: 'ask', reason: '删掉未跟踪文件' },
236
+ { name: 'git-branch-d', re: /\bgit\s+branch\s+-[dD]\b/i, decision: 'ask', reason: '删除分支' },
237
+ {
238
+ name: 'download-pipe-shell',
239
+ re: /(\b(curl|wget|invoke-webrequest|iwr)\b[^\n|]*\|\s*(sudo\s+)?(sh|bash|zsh|pwsh|powershell|iex|invoke-expression))/i,
240
+ decision: 'ask',
241
+ reason: '把网上下载的东西直接当脚本执行',
242
+ },
243
+ {
244
+ name: 'encoded-command',
245
+ re: /(-enc(odedcommand)?\s+[a-z0-9+/=]{16,}|base64\s+(-d|--decode)\b[^\n|]*\|\s*(sh|bash|pwsh|python))/i,
246
+ decision: 'ask',
247
+ reason: '执行编码过的命令(看不清要跑什么)',
248
+ },
249
+ { name: 'powerShell-iex', re: /\b(iex|invoke-expression)\b\s*\(/i, decision: 'ask', reason: '把字符串当代码执行' },
250
+ { name: 'defender-off', re: /set-mppreference[^\n|;]*disable|remove-mppreference|set-mppreference[^\n|;]*exclusionpath/i, decision: 'ask', reason: '关闭或绕过杀毒/实时防护' },
251
+ { name: 'amsi-etw-bypass', re: /amsiutils|amsiscanresult|etw\s+disable|stop-etwtracelog/i, decision: 'ask', reason: '关掉安全监控通道' },
252
+ { name: 'account-or-task', re: /\b(net\s+user|schtasks\s+\/create|register-scheduledtask|New-LocalUser|Add-LocalGroupMember)\b/i, decision: 'ask', reason: '建账号或计划任务(常驻后门)' },
253
+ { name: 'registry-hklm', re: /(reg\s+(add|delete)\s+hklm|new-itemproperty\s+-path\s+.{0,12}hklm|remove-itemproperty\s+-path\s+.{0,12}hklm)/i, decision: 'ask', reason: '改机器级注册表' },
254
+ { name: 'perm-wide-open', re: /(\bchmod\s+(-\w+\s+)*777\b|icacls\b[^\n|;]*\b(everyone|users):(f|gi)\b|set-aclregistry|grant-citf)/i, decision: 'ask', reason: '把权限放开给所有人' },
255
+ { name: 'firewall-off', re: /(netsh\s+advfirewall\s+set[^\n|;]*state\s+off|set-netfirewallprofile[^\n|;]*disabledstate|disable-netfirewall)/i, decision: 'ask', reason: '关闭防火墙' },
256
+ { name: 'terraform-destroy', re: /\b(terraform|pulumi|cdk)\b[^\n|;]*(destroy|destroy\s+-auto)/i, decision: 'ask', reason: '销毁基础设施' },
257
+ { name: 'kubectl-delete', re: /\bkubectl\s+delete\b|\bhelm\s+delete\b|\bdocker\s+(system\s+prune|volume\s+prune|rm\s+-f|volume\s+rm)/i, decision: 'ask', reason: '删除集群资源或容器数据' },
258
+ { name: 'db-drop', re: /\b(drop\s+(table|database|schema)|truncate\s+table|delete\s+from\s+\w+\s*;?\s*$)/i, decision: 'ask', reason: '删表/删库/全表清空' },
259
+ { name: 'publish', re: /\b(npm|pnpm|yarn)\s+publish\b|\bcargo\s+publish\b|\btwine\s+publish\b|\bdocker\s+push\b/i, decision: 'ask', reason: '发布到公共仓库(撤回不了)' },
260
+ { name: 'ssh-key-write', re: /(ssh-keygen[^\n|;]*-f\s*\S|authorized_keys)/i, decision: 'ask', reason: '生成或改动 SSH 授权密钥' },
261
+ { name: 'self-runtime-delete', re: /(process\.execPath)/i, decision: 'ask', reason: '删正在跑的程序自己(下次就起不来了)' },
262
+ ];
263
+ /**
264
+ * 一段命令原文命中了哪条内置危险模式。
265
+ *
266
+ * 判定引擎自己用它({@link classifyCommand} 的第三个求值层:内置危险模式),
267
+ * 审批灾难地板也用它:地板要在模式闸门与审批卡之前先把危险命令认出来,
268
+ * 两边共用同一份清单,加一条危险模式不必改两处。
269
+ *
270
+ * @param segmentRaw - 一段命令的原文(`splitSegments` 的产物,未词元化)。
271
+ * @returns 命中的模式名与理由;没命中返回 null。
272
+ */
273
+ export function builtinDangerHit(segmentRaw) {
274
+ const hit = DANGEROUS.find((pattern) => pattern.re.test(segmentRaw));
275
+ return hit === undefined ? null : { name: hit.name, reason: hit.reason };
276
+ }
277
+ /** 明确安全的只读动作:允许在计划/探索模式跑,也允许在无头场景自动放行。 */
278
+ const READONLY_HEADS = new Set([
279
+ 'ls', 'dir', 'cat', 'type', 'head', 'tail', 'wc', 'pwd', 'get-location', 'echo', 'write-output',
280
+ 'which', 'where', 'whereis', 'file', 'stat', 'du', 'df', 'free', 'uname', 'ver', 'Get-ChildItem',
281
+ 'Get-Content', 'Get-Item', 'Test-Path', 'Get-Location', 'Get-Date', 'git', 'rg', 'grep', 'find',
282
+ 'node', 'python', 'python3', 'date', 'env', 'printenv', 'ps', 'tasklist', 'Get-Process', 'sort',
283
+ 'uniq', 'sed', 'awk', 'jq', 'Get-CimInstance', 'Resolve-Path', 'Get-Command', 'Select-String',
284
+ // 纯展示 / 纯查询的 PowerShell cmdlet:它们只加工管道里已有的对象,自己不碰盘、不起进程。
285
+ // 管道按段判定,右侧少一个名字就把整条只读命令判成 ask(用户看到的是「查看个目录也要审批」)。
286
+ 'Select-Object', 'Where-Object', 'Sort-Object', 'Measure-Object', 'Group-Object', 'Compare-Object',
287
+ 'Format-Table', 'Format-List', 'Format-Wide', 'Format-Custom', 'Out-String', 'Out-Host', 'Out-Null',
288
+ 'Get-Member', 'Get-Unique',
289
+ // 上面这些的常见纯别名(select=Select-Object、measure=Measure-Object、ft/fl/fw=三种 Format-*)。
290
+ 'select', 'measure', 'ft', 'fl', 'fw',
291
+ ]);
292
+ /**
293
+ * 明确不许进上面那份名单的 PowerShell 动作,写在这里存档,免得下次有人「顺手补全」:
294
+ * - `ForEach-Object` / `%` / `foreach`:它们的 scriptblock 能执行任意代码,
295
+ * `Get-ChildItem | ForEach-Object { Remove-Item $_ }` 头是只读的,刀在花括号里;
296
+ * - `Tee-Object` 与 `Out-File`:把输出落到盘上,落盘就是动手;重定向那道防线对它们不生效
297
+ * (写法里没有 `>`,`segment.redirect` 是 false),只能靠不进名单来拦;
298
+ * - 一切 `Set-*` / `Remove-*` / `Invoke-*` / `Start-*` / `Stop-*` / `New-*`:改状态、删东西、起进程,
299
+ * 它们落在「不在名单里 = 默认要问」这条路上,保持现状即可。
300
+ */
301
+ /** 这些一级子命令即便是 git/node 也算写操作。 */
302
+ const WRITING_SUBCOMMANDS = new Set([
303
+ 'commit', 'push', 'pull', 'merge', 'rebase', 'reset', 'checkout', 'switch', 'restore', 'clean',
304
+ 'stash', 'apply', 'am', 'tag', 'branch', 'remote', 'config', 'gc', 'filter-branch', 'worktree',
305
+ 'install', 'add', 'remove', 'uninstall', 'update', 'publish', 'link', 'prune', 'cache', 'run', 'exec', 'init',
306
+ ]);
307
+ /**
308
+ * 这些程序自己就能执行任意代码:只看第一个词就判只读,等于把审批面整个绕开。
309
+ * `node` 早就被单独排除(它的注释写着「什么都可能干」),同一个理由对其余解释器一样成立。
310
+ */
311
+ const CODE_EXEC_HEADS = new Set([
312
+ 'node', 'deno', 'bun', 'perl', 'ruby', 'php', 'lua', 'osascript', 'wscript', 'cscript', 'mshta',
313
+ ]);
314
+ /** python 解释器(单独有一份子命令判定,见 {@link isReadOnlyPython})。 */
315
+ const PYTHON_HEADS = new Set(['python', 'python2', 'python3', 'py']);
316
+ /**
317
+ * python 只有跑「明确安全的测试模块」才算只读:`-c`、脚本文件、`-`、裸解释器全不算。
318
+ * `pytest` 会执行仓库里的 conftest.py,属于「跑测试」这个明确意图,跟着白名单一起放行。
319
+ */
320
+ const READONLY_PYTHON_MODULES = new Set(['pytest', 'unittest', 'json.tool']);
321
+ /** `find` 带这些开关就会执行命令、删文件或写文件(`-fprint` 系列会落盘)。 */
322
+ const FIND_WRITES = /-(?:delete|exec|execdir|ok|okdir|fprint|fprint0|fprintf|fls)\b/;
323
+ /**
324
+ * `sed` 的 `e` 命令会执行外部命令、`w`/`-i` 会写文件;`awk` 的 `system()`/`popen()` 同理,
325
+ * `print > file` 也能落盘。命中这些就不再当只读。
326
+ */
327
+ const STREAM_EDITOR_WRITES = /(?:^|[\s'";|])(?:-i\b|--in-place)|(?:^|[\s;'"])(?:e|w|r|R|W)(?=[\s;'"]|$)|system\s*\(|popen\s*\(|\|\s*"|>\s*\S/;
328
+ // ---------------------------------------------------------------- 规则文件
329
+ /** 读规则文件;文件不存在 = 空规则集(正常情况,不是错误)。 */
330
+ export function readRules(file = POLICY_RULES_FILE) {
331
+ if (!existsSync(file))
332
+ return { rules: [], problems: [] };
333
+ const problems = [];
334
+ let raw;
335
+ try {
336
+ raw = JSON.parse(readFileSync(file, 'utf8'));
337
+ }
338
+ catch (error) {
339
+ return { rules: [], problems: [`规则文件不是合法 JSON,整份忽略:${error.message}`] };
340
+ }
341
+ const list = Array.isArray(raw.rules) ? raw.rules : [];
342
+ const rules = [];
343
+ for (const item of list) {
344
+ const rule = parseRule(item, problems, rules.length);
345
+ if (rule !== null)
346
+ rules.push(rule);
347
+ }
348
+ return { rules, problems };
349
+ }
350
+ function parseRule(item, problems, index) {
351
+ if (item === null || typeof item !== 'object') {
352
+ problems.push(`第 ${index + 1} 条规则不是对象,已跳过`);
353
+ return null;
354
+ }
355
+ const doc = item;
356
+ const pattern = Array.isArray(doc.pattern)
357
+ ? doc.pattern.map((token) => (Array.isArray(token) ? token.map(String) : String(token)))
358
+ : null;
359
+ if (pattern === null || pattern.length === 0) {
360
+ problems.push(`第 ${index + 1} 条规则缺 pattern(要一个非空的词元数组),已跳过`);
361
+ return null;
362
+ }
363
+ const decision = doc.decision;
364
+ if (decision !== 'allow' && decision !== 'ask' && decision !== 'deny') {
365
+ problems.push(`第 ${index + 1} 条规则的 decision 只能是 allow/ask/deny,已跳过`);
366
+ return null;
367
+ }
368
+ const rule = {
369
+ pattern: pattern,
370
+ decision,
371
+ ...(typeof doc.justification === 'string' ? { justification: doc.justification } : {}),
372
+ ...(Array.isArray(doc.match) ? { match: doc.match.map(String) } : {}),
373
+ ...(Array.isArray(doc.notMatch) ? { notMatch: doc.notMatch.map(String) } : {}),
374
+ };
375
+ // 加载期自检(Codex 的 match/not_match 就是规则自带的单元测试)。
376
+ for (const example of rule.match ?? []) {
377
+ if (matchRule(rule, splitSegments(example)[0] ?? { tokens: [], raw: example, ruleUnfriendly: true }) === null) {
378
+ problems.push(`规则 ${rule.pattern.join(' ')} 的 match 例子没命中:${example}`);
379
+ }
380
+ }
381
+ for (const example of rule.notMatch ?? []) {
382
+ if (matchRule(rule, splitSegments(example)[0] ?? { tokens: [], raw: example, ruleUnfriendly: true }) !== null) {
383
+ problems.push(`规则 ${rule.pattern.join(' ')} 的 notMatch 例子却命中了:${example}`);
384
+ }
385
+ }
386
+ return rule;
387
+ }
388
+ /** 追加一条规则(审批卡「永久允许」走这里);已有等价前缀就不重复写。 */
389
+ export function appendRule(rule, file = POLICY_RULES_FILE) {
390
+ const current = readRules(file);
391
+ const sameIndex = current.rules.findIndex((existing) => existing.pattern.join(' ') === rule.pattern.join(' ') && existing.decision === rule.decision);
392
+ const next = [...current.rules];
393
+ if (sameIndex >= 0)
394
+ next[sameIndex] = rule;
395
+ else
396
+ next.push(rule);
397
+ mkdirSync(join(file, '..'), { recursive: true });
398
+ writeFileSync(file, `${JSON.stringify({ rules: next }, null, 2)}\n`, 'utf8');
399
+ if (file === POLICY_RULES_FILE)
400
+ cached = null;
401
+ }
402
+ /** 进程内缓存的生效规则:审批与模式闸门共用同一份,避免两处判定不一致。 */
403
+ let cached = null;
404
+ /** 取生效规则(第一次调用时读盘)。 */
405
+ export function activeRules() {
406
+ if (cached === null)
407
+ cached = readRules().rules;
408
+ return cached;
409
+ }
410
+ /** 规则文件被改过之后重新读一次。 */
411
+ export function reloadActiveRules() {
412
+ const loaded = readRules();
413
+ cached = loaded.rules;
414
+ return loaded;
415
+ }
416
+ /** 规则匹配:pattern 是段词元的前缀;末尾 `*` 吃掉剩余;数组元素表示多选一。 */
417
+ function matchRule(rule, segment) {
418
+ if (segment.tokens.length === 0)
419
+ return null;
420
+ const matched = [];
421
+ for (let i = 0; i < rule.pattern.length; i += 1) {
422
+ const want = rule.pattern[i];
423
+ if (want === '*')
424
+ return [...matched, '*'];
425
+ const got = segment.tokens[i];
426
+ if (got === undefined)
427
+ return null;
428
+ const lowered = got.toLowerCase().replace(/\.exe$/, '');
429
+ const ok = Array.isArray(want) ? want.some((alt) => alt.toLowerCase() === lowered) : want.toLowerCase() === lowered;
430
+ if (!ok)
431
+ return null;
432
+ matched.push(got);
433
+ }
434
+ return matched;
435
+ }
436
+ /**
437
+ * 判定一条命令。
438
+ *
439
+ * 顺序:硬地板 → 用户 deny 规则 → 内置危险模式 → 用户 allow 规则 → 默认 ask。
440
+ * 前三层不受权限模式影响,所以「完全访问」也拦得住删库。
441
+ */
442
+ export function classifyCommand(command, options = {}) {
443
+ const rules = options.rules ?? [];
444
+ const segments = splitSegments(command);
445
+ let decision = 'allow';
446
+ const reasons = [];
447
+ let matchedRule = null;
448
+ let hardline = false;
449
+ let ruleFriendly = true;
450
+ let dangerousHit = false;
451
+ for (const segment of segments) {
452
+ if (segment.tokens.length === 0)
453
+ continue;
454
+ ruleFriendly &&= !segment.ruleUnfriendly;
455
+ const hardHit = HARDLINE.find((pattern) => pattern.re.test(segment.raw));
456
+ if (hardHit !== undefined) {
457
+ hardline = true;
458
+ decision = 'deny';
459
+ reasons.push(hardHit.reason);
460
+ continue;
461
+ }
462
+ // 用户 deny 规则排在危险模式之前:它比内置清单更具体。
463
+ const denyRule = rules.find((rule) => rule.decision === 'deny' && matchRule(rule, segment) !== null);
464
+ if (denyRule !== undefined) {
465
+ decision = strictest(decision, 'deny');
466
+ matchedRule = matchedRule ?? denyRule;
467
+ reasons.push(`规则禁止:${denyRule.justification ?? denyRule.pattern.join(' ')}`);
468
+ continue;
469
+ }
470
+ const dangerHit = builtinDangerHit(segment.raw);
471
+ if (dangerHit !== null) {
472
+ dangerousHit = true;
473
+ decision = strictest(decision, 'ask');
474
+ reasons.push(dangerHit.reason);
475
+ continue;
476
+ }
477
+ const allowRule = rules.find((rule) => rule.decision === 'allow' && matchRule(rule, segment) !== null);
478
+ // 已授权规则只替用户免掉「这一段本来要问」的判断,前提是这段就是用户批的那个样子:
479
+ // 带重定向、变量赋值或命令替换的段不给走规则——否则 `git status` 的授权会被
480
+ // 「git status⏎curl evil …」这类多行命令整个继承(2026-09-29 审查发现)。
481
+ if (allowRule !== undefined && !segment.redirect && !segment.ruleUnfriendly) {
482
+ matchedRule = matchedRule ?? allowRule;
483
+ continue;
484
+ }
485
+ // 只读命令默认放行(计划模式、无头子代理都靠这条),其余默认要问。
486
+ if (!isReadOnlySegment(segment))
487
+ decision = strictest(decision, 'ask');
488
+ }
489
+ if (reasons.length === 0 && decision === 'allow') {
490
+ reasons.push(matchedRule !== null ? `规则允许:${matchedRule.justification ?? matchedRule.pattern.join(' ')}` : '只读命令');
491
+ }
492
+ if (reasons.length === 0)
493
+ reasons.push('需要授权');
494
+ const selfHit = options.selfPaths?.some((path) => path !== '' && command.toLowerCase().includes(path.toLowerCase())) ?? false;
495
+ if (selfHit) {
496
+ decision = strictest(decision, 'ask');
497
+ reasons.push('命令目标包含 dsc 自己的程序文件');
498
+ }
499
+ const suggestable = decision !== 'deny' && !hardline && !dangerousHit && ruleFriendly && segments.length === 1;
500
+ return {
501
+ decision,
502
+ reason: reasons.join(';'),
503
+ matchedRule,
504
+ prefixRule: suggestable ? suggestPrefix(segments[0]) : null,
505
+ hardline,
506
+ };
507
+ }
508
+ /** python 只在跑明确的测试模块时算只读;`-c`、脚本文件、裸解释器都能跑任意代码。 */
509
+ function isReadOnlyPython(tokens) {
510
+ if (tokens[1] !== '-m')
511
+ return false;
512
+ const module = tokens[2];
513
+ return module !== undefined && READONLY_PYTHON_MODULES.has(module);
514
+ }
515
+ /**
516
+ * 剥掉「第一个词只是包装」的头部:`env python -c ...` 真正跑的是 python,
517
+ * 后面那串 `KEY=VALUE` 是环境变量,不是命令。
518
+ */
519
+ function unwrapHeads(tokens) {
520
+ let index = 0;
521
+ while (index < tokens.length && tokens[index].toLowerCase().replace(/\.exe$/, '') === 'env')
522
+ index += 1;
523
+ const wrapped = index > 0;
524
+ while (index < tokens.length && /^[A-Za-z_][A-Za-z0-9_]*=/.test(tokens[index]))
525
+ index += 1;
526
+ // 裸 `env`(后面没有命令)就是打印环境变量,仍然只读。
527
+ if (wrapped && index >= tokens.length)
528
+ return ['env'];
529
+ return tokens.slice(index);
530
+ }
531
+ /**
532
+ * 这一段是不是只读动作。
533
+ *
534
+ * 判据不止「第一个词在只读名单里」:还要排除把输出写进文件的重定向,排除自己能跑代码的
535
+ * 解释器,排除 `find -delete`、`sed` 的 `e`/`w` 这类会把只读程序变成写操作的参数。
536
+ */
537
+ function isReadOnlySegment(segment) {
538
+ // 往盘上写东西的段一律不算只读:跑的程序再安全,落盘也是动手。
539
+ if (segment.redirect)
540
+ return false;
541
+ // 命令替换($() 与反引号)会先把替换内容跑一遍再交给外面的命令:头是 echo 也拦不住替换里那把刀。
542
+ if (segment.subst)
543
+ return false;
544
+ const tokens = unwrapHeads(segment.tokens);
545
+ const head = tokens[0]?.toLowerCase().replace(/\.exe$/, '');
546
+ if (head === undefined)
547
+ return false;
548
+ if (!READONLY_HEADS.has(head)) {
549
+ // 大小写混排的命令名(Get-ChildItem)在 Set 里按原样存过,这里再比一次小写。
550
+ const known = [...READONLY_HEADS].some((name) => name.toLowerCase() === head);
551
+ if (!known)
552
+ return false;
553
+ }
554
+ if (CODE_EXEC_HEADS.has(head))
555
+ return false; // 解释器直接执行脚本 = 什么都可能干
556
+ if (PYTHON_HEADS.has(head))
557
+ return isReadOnlyPython(tokens);
558
+ if (head === 'find' && FIND_WRITES.test(segment.raw))
559
+ return false;
560
+ if (head === 'sed' || head === 'awk')
561
+ return !STREAM_EDITOR_WRITES.test(segment.raw);
562
+ if (head === 'git') {
563
+ const sub = tokens[1]?.toLowerCase();
564
+ if (sub !== undefined && WRITING_SUBCOMMANDS.has(sub))
565
+ return false;
566
+ }
567
+ return true;
568
+ }
569
+ /** 建议一个可持久化的前缀:取前 2-3 个词,别把整条命令塞进去(抄 Codex 的告诫)。 */
570
+ function suggestPrefix(segment) {
571
+ const head = segment.tokens[0];
572
+ if (head === undefined)
573
+ return null;
574
+ const sub = segment.tokens[1];
575
+ if (sub === undefined || sub.startsWith('-'))
576
+ return [head];
577
+ if (sub === 'run' || sub === 'test' || sub === 'check')
578
+ return [head, sub, segment.tokens[2] ?? '*'];
579
+ return [head, sub];
580
+ }
@@ -0,0 +1,78 @@
1
+ /**
2
+ * 斜杠命令的注册表与补全(/help 文本、命令与模型参数候选、唯一前缀展开)。
3
+ *
4
+ * 为什么独立成模块:渲染层 Composer 直接 import 这一份拿补全函数——vite 对
5
+ * `node:child_process` 之类内置模块是「externalize 即炸」(顶层 import 一求值就抛,
6
+ * 0.6.26 白屏教训),所以**这个模块的顶层不许出现任何 node 内置模块**。
7
+ * 插件(plugins/commands.ts)从这里 re-export,终端侧的入口不变。
8
+ *
9
+ * @module dsc/core/commands-completion
10
+ */
11
+ import type { CommandSpec, CompletionItem } from '../services/types.js';
12
+ import type { ModelChoiceView } from '../contract.js';
13
+ /**
14
+ * 内置命令表(spec 单一真源;handler 在插件 apply 时注册)。
15
+ *
16
+ * `shell: true` 那批是**桌面壳输入框里列得出来、也执行得了**的命令(界面通道的
17
+ * `listUiCommands` / `runUiCommand` 只认它们,见 core/ui-methods.ts)。挑的尺子两条,
18
+ * 缺一不可:
19
+ *
20
+ * 1. 动作不出界面通道已有的权力面:`/new` ≈ `openSession`、`/compact` ≈ `compact`、
21
+ * `/review` ≈ `submit`、`/diff` ≈ `dock` 读类,其余四条只往会话里写一条系统通知;
22
+ * 2. 壳里没有更顺手的替身:权限三根旋钮(`/policy` `/reviewer` `/permission`)与
23
+ * `/model` `/effort` 的旋钮就长在输入框底栏,`/resume` `/settings` `/agents`
24
+ * `/plugins` 各有常驻入口——在壳里再列一遍只会多出第二条真源。
25
+ *
26
+ * 硬理由不放的那几条:`/export`(往任意路径写文件)、`/ui-trust`(落第三方界面插件的
27
+ * 信任记录)、`/exit`(宿主生命周期)写完面一律留在原生桥(core/native-bridge.ts),
28
+ * 那是只对装了 preload 的桌面窗口开放的一条路;`/copy` 动的是**宿主**机器的剪贴板,
29
+ * 手机端看着像复制到自己手机上,语义错位。
30
+ */
31
+ export declare const BUILT_IN_COMMANDS: CommandSpec[];
32
+ /** 全量 spec:内置 + 外部插件注册的。 */
33
+ export declare const allSpecs: () => CommandSpec[];
34
+ /** 外部插件注册成功后把 spec 挂进来(registry 是唯一调用方)。 */
35
+ export declare function addExtraSpec(spec: CommandSpec): void;
36
+ /** 外部插件注销时摘掉。 */
37
+ export declare function removeExtraSpec(spec: CommandSpec): void;
38
+ /**
39
+ * 壳(桌面 / 手机那份插件化界面)可见也可执行的命令:`shell: true` 那批。
40
+ *
41
+ * 界面通道的 `listUiCommands`(菜单数据源)与 `runUiCommand`(派发闸)都读这一份,
42
+ * 所以「菜单里列出来的」与「真能执行的」不可能各说各话。外部插件默认不在里面
43
+ * (spec 不标 `shell` 就不进)——失败关闭;宿主侧插件本就有完整宿主权力,标了也只是
44
+ * 把它自己的命令摆到菜单里,不多给任何东西。
45
+ */
46
+ export declare const shellCommands: () => CommandSpec[];
47
+ /** 这个名字能不能从壳里执行(`runUiCommand` 的闸;大小写与展开后的名字比)。 */
48
+ export declare function isShellCommand(name: string): boolean;
49
+ /**
50
+ * 界面通道派发前的那道闸(`runUiCommand` 只做两件事:问它、照原样派发)。
51
+ *
52
+ * 独立成纯函数是为了能直测:它是「壳能跑什么」这句话的可执行版本,而 `runCommand`
53
+ * 那条路(终端与旧桌面渲染层用)**不过这道闸**——两边的差别只在这里。
54
+ *
55
+ * @returns null = 放行;字符串 = 给用户看的原因(调用方原样抛出去)。
56
+ */
57
+ export declare function shellCommandRejection(input: string): string | null;
58
+ /** /help 文本(命令表驱动)。 */
59
+ export declare function helpText(specs: readonly CommandSpec[]): string;
60
+ /** 兼容导出:v2 的 HELP_TEXT(内置表静态快照)。 */
61
+ export declare const HELP_TEXT: string;
62
+ /**
63
+ * 命令候选(输入 `/` 或 `/mo` 阶段)。
64
+ * 已进入参数阶段(含空格)或非命令输入返回空。
65
+ */
66
+ export declare function commandCompletions(input: string): CompletionItem[];
67
+ /**
68
+ * 模型候选(`/model ` 参数阶段):展示全部可切换模型的 `端点/模型名`。
69
+ * 补全到精确匹配后面板自动关闭;`model 名`本身也可前缀匹配(`/model deep`)。
70
+ */
71
+ export declare function modelCompletions(input: string, models: readonly ModelChoiceView[]): CompletionItem[];
72
+ /** 统一补全入口:model 参数阶段优先,否则按命令前缀。 */
73
+ export declare function completionsFor(input: string, models: readonly ModelChoiceView[]): CompletionItem[];
74
+ /**
75
+ * 命令名唯一前缀自动展开(`/ne` → `/new`);多候选或已精确匹配时原样返回。
76
+ * 供 Enter 提交前调用,避免"输了一半按回车报未知命令"。
77
+ */
78
+ export declare function expandCommand(input: string): string;