@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,761 @@
1
+ /**
2
+ * sandbox 插件:给动手类工具套一层沙箱。**默认开**。
3
+ *
4
+ * 形制照 codex 的 `sandbox_mode` + 执行策略面,而不是 dsh 的 fail-closed:
5
+ * - 三档:read-only / workspace-write(默认)/ danger-full-access;
6
+ * - 策略面:可写根白名单(工作区 + 沙箱私有临时目录 + 附加根)、
7
+ * 可写根内的只读子路径、受保护元数据名(`.git`、`.ssh`、`.env*`、凭据文件、
8
+ * `~/.dsc` 自己的控制文件)、网络开关(默认关);
9
+ * - 命令前缀策略(codex 的 execpolicy):逐段判 allow / prompt / forbidden;
10
+ * - 一次性升权:模型带成对的 `sandbox_permissions` + `justification` 请求放宽,
11
+ * 只对这一次生效,且照常弹审批卡(见 `src/core/tools/sandbox-args.ts`);
12
+ * - **降级照 codex,不照 dsh**:强制后端不可用时不 fail-closed,改为
13
+ * 「照常执行 + 审批卡兜底」,并把 `enforcement: partial` 如实报给模型与用户。
14
+ *
15
+ * 职责边界(写在这里免得后来人搞混):**沙箱管「能不能」,审批管「要不要问」**。
16
+ * 所以本插件只 deny 两件事:越界写、以及「网络被关时还要联网」。
17
+ * read-only 档也**不**拒掉整个 exec(那是权限模式与审批卡的事),
18
+ * 只在命令里出现写目标时拒——两处都拒等于同一件事报两次错,模型会拿着两条理由不知道该改哪条。
19
+ *
20
+ * 挂载点:
21
+ * - 守卫链 order 8(早于协作模式 10):越界 deny,范围内 defer 让别人照常判;
22
+ * - 命令执行器缝(`src/core/tools/command-runner.ts`):只有「容器后端」用它;
23
+ * - `ctx.provide('sandbox', …)` 对外给查询与路径判定;
24
+ * - `ctx.prompt.register` 把当前档位与强制执行等级写进系统提示(降级必须可见);
25
+ * - 设置分区 id 'sandbox' 与 `/sandbox` 命令。
26
+ *
27
+ * 支撑模块(本插件独占,别的插件不碰):`src/core/sandbox/{policy,execpolicy,backends}.ts`
28
+ *
29
+ * @module dsc/plugins/sandbox
30
+ */
31
+ import { mkdirSync } from 'node:fs';
32
+ import { resolve } from 'node:path';
33
+ import { DSC_HOME } from '../core/path-policy.js';
34
+ import { bootNoticeOnce } from '../core/boot-notices.js';
35
+ import { resolvePluginConfig, writePluginConfig } from '../core/plugin-registry.js';
36
+ import { registerCommandRunner } from '../core/tools/command-runner.js';
37
+ import { readSandboxRequest } from '../core/tools/sandbox-args.js';
38
+ import { createDockerRunner, probeDocker } from '../core/sandbox/backends.js';
39
+ import { createWindowsTokenRunner, probeWindowsToken } from '../core/sandbox/win/backend.js';
40
+ import { readSetupState } from '../core/sandbox/win/account.js';
41
+ import { runSetupElevated } from '../core/sandbox/win/setup.js';
42
+ import { doctorWindowsNetwork } from '../core/sandbox/win/doctor.js';
43
+ import { evaluateCommand } from '../core/sandbox/execpolicy.js';
44
+ import { checkWrite, createPolicy, describePolicy, formatPathList, legalWay, parseAllowlistText, parsePathListText, resolveSandboxConfig, sandboxTmpDir, SANDBOX_CONFIG_KEY, SANDBOX_MODES, DEFAULT_SANDBOX_IMAGE, } from '../core/sandbox/policy.js';
45
+ /** 守卫刻度:灾难地板 5 < 沙箱 8 < 协作模式 10 < 安全钩子 20 < 审批 30。 */
46
+ const GUARD_ORDER = 8;
47
+ /** 系统提示段位置:模式条款(30)之后、插件默认(60)之前。 */
48
+ const PROMPT_ORDER = 40;
49
+ /** 设置分区位置:审批地板 33 之前,跟权限/模式相关的放前面。 */
50
+ const SECTION_ORDER = 31;
51
+ /** 内存里留最近几次拒绝给 `/sandbox` 看。 */
52
+ const DENY_BUFFER = 3;
53
+ const PASS = { allowed: true, rule: 'allowed', why: '', how: '' };
54
+ /** 时间戳 → `/sandbox` 里那行 `[12:03:44]`。 */
55
+ function clockOf(ts) {
56
+ const date = new Date(ts);
57
+ const pad = (value) => String(value).padStart(2, '0');
58
+ return `${pad(date.getHours())}:${pad(date.getMinutes())}:${pad(date.getSeconds())}`;
59
+ }
60
+ function errText(error) {
61
+ return error instanceof Error ? error.message : String(error);
62
+ }
63
+ export const sandboxPlugin = {
64
+ name: 'sandbox',
65
+ inject: ['guards', 'transcript', 'settings', 'prompt', 'commands', 'session'],
66
+ apply(ctx, passed) {
67
+ const readConfig = () => resolveSandboxConfig(resolvePluginConfig(SANDBOX_CONFIG_KEY, passed));
68
+ /** 最近几次拒绝(新的在后)。 */
69
+ const denials = [];
70
+ /** 强制执行等级与后端现状:探测/降级都会改它,系统提示与设置页都读它。 */
71
+ let enforcement = 'partial';
72
+ let backendDetail = '进程内策略围栏(默认后端,不依赖外部进程)';
73
+ /**
74
+ * 用户要的是外部隔离(docker / windows-token),但它没建起来、而配置又选了 fail-closed
75
+ * ——这时写与执行类一律拒(读照常)。`policy` 后端的 partial 是预期状态,不置这一位。
76
+ */
77
+ let degradedFailClosed = false;
78
+ /** 容器执行器的退订函数(换后端/停插件时要收回)。 */
79
+ let offRunner = null;
80
+ /** 受限令牌后端的收尾(回收私有临时目录的能力 ACE)。 */
81
+ let offWinDispose = null;
82
+ /** 网络第二级体检结论(doctor):布防完整 full / 任一项缺 partial。 */
83
+ let networkTier = 'partial';
84
+ /** 体检的逐项明细(√/× 每项一句话)。 */
85
+ let networkTierDetail = '尚未体检';
86
+ /** 探测代次:异步探测回来时后端已经又换过一次,那就作废这次结果。 */
87
+ let generation = 0;
88
+ let disposed = false;
89
+ const currentCwd = () => ctx.session.current().meta.cwd;
90
+ const currentSessionId = () => ctx.session.current().meta.id;
91
+ const currentSessionPath = () => ctx.session.current().filePath;
92
+ /**
93
+ * 组一份当前策略快照:设置与会话状态都现读,所以设置页改完立刻生效,不用重启宿主。
94
+ * 沙箱私有临时目录顺手建出来(建不出来也不抛:策略会把它当普通路径判)。
95
+ *
96
+ * @param cwdOverride - 显式指定工作目录(守卫拿到的是 `input.cwd`,服务是 `canWrite` 的
97
+ * 第二参)。为什么不直接用会话 cwd:可写根随「这次调用」走,同进程里可能同时有
98
+ * 多个工作目录在跑;调用方给哪个目录,就按哪个目录算根。
99
+ */
100
+ /**
101
+ * 本会话被用户逐次点头放宽出来的可写根:会话 jsonl 路径 → 绝对路径数组。
102
+ *
103
+ * 只有**审批卡上点「本会话允许」**这一条路能往里写(`grantSession`),
104
+ * 而卡上给不给这个选项由审批层判(写类工具才有,命令类没有——命令的写目标静态界定不出来)。
105
+ * 键是会话路径:一个会话放宽了,别的会话照旧被拦。
106
+ */
107
+ const sessionRoots = new Map();
108
+ const snapshot = (cwdOverride, sessionPath) => {
109
+ const { config, problems } = readConfig();
110
+ const cwd = cwdOverride ?? currentCwd();
111
+ const granted = sessionPath === undefined ? [] : (sessionRoots.get(sessionPath) ?? []);
112
+ const tmpDir = sandboxTmpDir(DSC_HOME, cwd, currentSessionId());
113
+ try {
114
+ mkdirSync(tmpDir, { recursive: true });
115
+ }
116
+ catch {
117
+ // 目录建不出来时写它就是失败的,不必在这里报错(工具自己会拿到真实错误)
118
+ }
119
+ const policy = createPolicy({
120
+ mode: config.mode,
121
+ cwd,
122
+ tmpDir,
123
+ extraWritableRoots: [...config.extraWritableRoots, ...granted],
124
+ readOnlySubpaths: config.readOnlySubpaths,
125
+ dscHome: DSC_HOME,
126
+ networkAccess: config.networkAccess,
127
+ });
128
+ return { config, policy, problems: [...problems, ...policy.problems] };
129
+ };
130
+ /** 规则名 → 「怎么合法地做」。 */
131
+ const howTo = (rule) => {
132
+ if (rule.startsWith('write-target:'))
133
+ return legalWay(rule.slice('write-target:'.length));
134
+ if (rule === 'network-off')
135
+ return '在「设置 → 沙箱」打开网络开关,或换成不需要联网的做法';
136
+ if (rule === 'malformed-request')
137
+ return '两个升权参数要么都给(sandbox_permissions + justification),要么都不给';
138
+ return '换一个不需要改机器配置的做法;确需执行这条命令请让用户手工跑';
139
+ };
140
+ /** 记一次拒绝 + 拼给模型看的那句话(带档位、可写根、命中规则、下一步怎么走)。 */
141
+ const refuse = (config, policy, tool, verdict) => {
142
+ denials.push({ at: Date.now(), tool, rule: verdict.rule, why: verdict.why });
143
+ if (denials.length > DENY_BUFFER)
144
+ denials.shift();
145
+ const roots = policy.roots.length === 0 ? '(无)' : policy.roots.join('、');
146
+ const reason = `沙箱拒绝这次 ${tool}:${verdict.why}。` +
147
+ `当前档位 ${config.mode}(可写根:${roots};网络:${config.networkAccess ? '开' : '关'}),` +
148
+ `命中规则「${verdict.rule}」。${verdict.how}`;
149
+ return { action: 'deny', reason };
150
+ };
151
+ /** 写类调用:没有可认的写目标就不判(那是审批卡的活,别在这里瞎猜)。 */
152
+ const writeVerdict = (policy, target) => {
153
+ if (target === undefined || target.trim() === '')
154
+ return PASS;
155
+ const check = checkWrite(policy, target);
156
+ if (check.allowed)
157
+ return PASS;
158
+ return { allowed: false, rule: check.rule, why: check.reason, how: legalWay(check.rule) };
159
+ };
160
+ /** 命令类调用:只有 forbidden 才拒;prompt/allow 都 defer(要不要问由审批层定)。 */
161
+ const execVerdict = (config, policy, command) => {
162
+ if (command === undefined || command.trim() === '')
163
+ return PASS;
164
+ const verdict = evaluateCommand(command, {
165
+ networkAccess: config.networkAccess,
166
+ checkWrite: (raw) => checkWrite(policy, raw),
167
+ });
168
+ if (verdict.decision !== 'forbidden')
169
+ return PASS;
170
+ return { allowed: false, rule: verdict.rule, why: verdict.reason, how: howTo(verdict.rule) };
171
+ };
172
+ // ── 守卫(order 8)────────────────────────────────────────────────────────
173
+ const guard = {
174
+ id: 'sandbox',
175
+ order: GUARD_ORDER,
176
+ decide(input) {
177
+ // 按这次调用的工作目录算可写根:input.cwd 就是循环传进来的会话目录,
178
+ // 显式优先于会话状态,同进程多工作目录时才不会拿错根。
179
+ const { config, policy } = snapshot(input.cwd, input.sessionPath);
180
+ // 不设围栏的档位:整档交出去(审批与权限模式照常管)
181
+ if (config.mode === 'danger-full-access')
182
+ return { action: 'defer' };
183
+ // 读限制不在本插件职责内:内核 path-policy 已经管凭据读取,这里再拒一次只会给两条理由
184
+ if (input.risk === 'read')
185
+ return { action: 'defer' };
186
+ // 要的外部隔离没建起来 + 配置选了 fail-closed:写与执行类直接拒(读在上面已经放行)。
187
+ // 这一条排在升权解析之前——升权是「放宽沙箱」,而此刻**沙箱本身不在**,
188
+ // 放宽一个不存在的围栏没有意义,只会让人以为有隔离。(dsh 对 partial 的保守姿态。)
189
+ if (degradedFailClosed) {
190
+ const verdict = {
191
+ allowed: false,
192
+ rule: 'backend-unavailable',
193
+ why: '你要的隔离后端(docker / Windows 受限令牌)没建起来,配置又选了「建不起来就拒」',
194
+ how: '两条路:在「设置 → 沙箱」把后端换成策略围栏(进程内那个,接受 partial),或把「后端建不起来时」改回 degrade;也可以先修好后端(docker 起得来 / 提权 setup 成功)',
195
+ };
196
+ return refuse(config, policy, input.toolName, verdict);
197
+ }
198
+ const request = readSandboxRequest(input.args);
199
+ // 半截的升权请求一律拒:单独一个 sandbox_permissions(想偷偷放宽)
200
+ // 或单独一个 justification,都不该放过去。
201
+ if (request.kind === 'malformed') {
202
+ const verdict = {
203
+ allowed: false,
204
+ rule: 'malformed-request',
205
+ why: `升权参数不完整:${request.reason}`,
206
+ how: howTo('malformed-request'),
207
+ };
208
+ return refuse(config, policy, input.toolName, verdict);
209
+ }
210
+ const verdict = input.risk === 'write'
211
+ ? writeVerdict(policy, input.target)
212
+ : input.risk === 'exec'
213
+ ? execVerdict(config, policy, input.command)
214
+ : PASS;
215
+ if (verdict.allowed)
216
+ return { action: 'defer' };
217
+ // 请求完整(成对)→ 按**它要的那一档**办(两档在这里才真正分家):
218
+ // danger-full-access 这一次跳过沙箱判定(defer 出去,卡上还会让用户点);
219
+ // workspace-write 留在沙箱里,只把这一次的目标并进可写根**重判一遍**——
220
+ // 网络开关、只读子路径、受保护路径照旧生效,所以它仍然可能被拒。
221
+ // 少了这一步,「留在沙箱内」与「整个出沙箱」就是同一件事(以前就是这样,两档是死的)。
222
+ if (request.kind === 'ok') {
223
+ if (request.permission === 'danger-full-access')
224
+ return { action: 'defer' };
225
+ const widened = input.risk === 'write' && input.target !== undefined
226
+ ? checkWrite({ ...policy, roots: [...policy.roots, resolve(input.target)] }, input.target)
227
+ : null;
228
+ // 写目标认不出来(命令类)时没法「按更宽的边界重判」:只能整条 defer 出去,
229
+ // 由审批卡兜底——这一条在卡片说明里写明了。
230
+ if (widened === null)
231
+ return { action: 'defer' };
232
+ if (widened.allowed)
233
+ return { action: 'defer' };
234
+ return refuse(config, policy, input.toolName, {
235
+ allowed: false,
236
+ rule: widened.rule,
237
+ why: `${widened.reason}(模型请求的是「留在沙箱内放宽写边界」,可写根放宽到这一次的目标后**仍然**不合法)`,
238
+ how: legalWay(widened.rule),
239
+ });
240
+ }
241
+ return refuse(config, policy, input.toolName, verdict);
242
+ },
243
+ };
244
+ const offGuard = ctx.guards.register(guard);
245
+ // ── 系统提示段(降级必须可见)─────────────────────────────────────────────
246
+ /** 强制等级 → 一句人话。 */
247
+ const enforcementText = () => {
248
+ switch (enforcement) {
249
+ case 'full':
250
+ return 'full:命令的执行体被换成了容器(网络与文件系统由容器隔离)';
251
+ case 'partial':
252
+ return 'partial:进程内策略围栏(拦得住 dsc 自己发起的工具调用,拦不住命令内部的任意写)';
253
+ default:
254
+ return 'none:当前档位不设围栏';
255
+ }
256
+ };
257
+ const promptText = () => {
258
+ const { config, policy, problems } = snapshot();
259
+ if (config.mode === 'danger-full-access') {
260
+ return '【沙箱】档位 danger-full-access:沙箱不设围栏,写盘与命令只受权限模式与审批卡约束。';
261
+ }
262
+ const lines = [];
263
+ lines.push(`【沙箱】档位 ${config.mode}|强制执行 ${enforcement}(${enforcementText()})`);
264
+ lines.push(`可写根:${policy.roots.length === 0 ? '(无,只读档不许写盘)' : policy.roots.join('、')};` +
265
+ `只读子路径:${policy.readOnlySubpaths.length === 0 ? '(无)' : policy.readOnlySubpaths.join('、')};` +
266
+ `网络:${config.networkAccess ? '开' : '关(要联网的命令会被直接拒)'}`);
267
+ if (config.backend === 'windows-token') {
268
+ lines.push(`当前后端是 Windows 受限令牌:命令内部的越界写(脚本里的 fs.writeFile 这类)会被系统层直接拒绝;读不受限;网络第二级体检 ${networkTier}(明细见 /sandbox)。`);
269
+ }
270
+ else {
271
+ lines.push('策略围栏拦得住 dsc 自己发起的工具调用,拦不住命令内部的任意写(脚本里的 fs.writeFile 这类);要真隔离,请在「设置 → 沙箱」把后端换成 Windows 受限令牌(本机即可,无需 docker)或容器。');
272
+ }
273
+ lines.push('要写到可写根之外(例如另一个盘的项目目录),只能在这一次调用里同时给 sandbox_permissions 与 justification,且照常会弹审批卡让用户点。');
274
+ if (degradedFailClosed) {
275
+ lines.push('⚠ 你要的隔离后端没建起来,且配置选了「后端建不起来就拒」:写与执行类工具现在会被沙箱直接拒(读照常)。修法见「设置 → 沙箱」。');
276
+ }
277
+ if (problems.length > 0)
278
+ lines.push(`⚠ 沙箱配置有问题(已按默认值兜底):${problems.join(';')}`);
279
+ return lines.join('\n');
280
+ };
281
+ const offPrompt = ctx.prompt.register('sandbox', promptText, { order: PROMPT_ORDER });
282
+ // ── 后端探测与降级 ────────────────────────────────────────────────────────
283
+ /**
284
+ * 按当前设置重新决定后端与强制执行等级。
285
+ *
286
+ * 三档结果:不设围栏(none)/ 策略围栏(partial)/ 容器(full)。
287
+ * 容器探测失败**不拒执行**,只是把「真隔离」降级成「审批卡兜底」并如实上报——
288
+ * 这是与 dsh 的 fail-closed 最大的分歧点,理由写在 backends.ts 文件头。
289
+ */
290
+ const refreshBackend = async () => {
291
+ generation += 1;
292
+ const mine = generation;
293
+ offRunner?.();
294
+ offRunner = null;
295
+ offWinDispose?.();
296
+ offWinDispose = null;
297
+ degradedFailClosed = false;
298
+ const { config } = readConfig();
299
+ if (config.mode === 'danger-full-access') {
300
+ enforcement = 'none';
301
+ backendDetail = '档位 danger-full-access:不设围栏';
302
+ ctx.emit('dsc/changed');
303
+ return backendDetail;
304
+ }
305
+ if (config.backend === 'policy') {
306
+ enforcement = 'partial';
307
+ backendDetail = '进程内策略围栏(默认后端,不需要外部进程)';
308
+ ctx.emit('dsc/changed');
309
+ return backendDetail;
310
+ }
311
+ if (config.backend === 'windows-token') {
312
+ const probe = probeWindowsToken();
313
+ if (!probe.available) {
314
+ enforcement = 'partial';
315
+ degradedFailClosed = config.onUnavailable === 'fail-closed';
316
+ backendDetail = degradedFailClosed
317
+ ? `Windows 受限令牌后端不可用,且配置选了「后端建不起来就拒」:写与执行类工具一律拒(读照常)。${probe.detail}`
318
+ : `Windows 受限令牌后端不可用,已降级为策略围栏:${probe.detail}`;
319
+ ctx.transcript.system(`沙箱:${backendDetail}`);
320
+ ctx.emit('dsc/changed');
321
+ return backendDetail;
322
+ }
323
+ // 账本在 = 提权 setup 成功过:走账号分支(runner 以专用账号跑命令,网络过白名单代理)
324
+ const setupState = readSetupState(DSC_HOME);
325
+ const account = setupState !== null && setupState.ok
326
+ ? { name: setupState.state.account, sid: setupState.state.sid, dscHome: DSC_HOME, proxyPort: setupState.state.proxyPort }
327
+ : undefined;
328
+ const handle = createWindowsTokenRunner({
329
+ mode: config.mode === 'read-only' ? 'read-only' : 'workspace-write',
330
+ cwd: currentCwd(),
331
+ tmpDir: sandboxTmpDir(DSC_HOME, currentCwd(), currentSessionId()),
332
+ extraRoots: config.extraWritableRoots,
333
+ networkAccess: () => readConfig().config.networkAccess,
334
+ networkAllowlist: () => readConfig().config.networkAllowlist,
335
+ ...(account === undefined ? {} : { account }),
336
+ onDetail: (message) => {
337
+ if (!disposed)
338
+ ctx.transcript.system(`沙箱:${message}`);
339
+ },
340
+ });
341
+ offRunner = registerCommandRunner(handle.runner);
342
+ offWinDispose = handle.dispose;
343
+ // 如实上报:账号分支在位 = FS 与网络双层锁死(full);只有受限令牌时
344
+ // 硬链接别名/读不受限是结构性缺口,网络只有软墙(partial),缺口在 detail 说透
345
+ enforcement = handle.networkEnforced ? 'full' : 'partial';
346
+ backendDetail = account === undefined
347
+ ? `Windows 受限令牌:命令内部越界写被系统层拦截(${handle.describe()})`
348
+ : `Windows 受限令牌 + 专用账号(${account.name}):越界写与越界出网都被系统层拦截(${handle.describe()})`;
349
+ ctx.emit('dsc/changed');
350
+ return backendDetail;
351
+ }
352
+ const probe = await probeDocker({});
353
+ if (disposed || mine !== generation)
354
+ return '后端被再次切换,这次探测结果作废';
355
+ if (!probe.available) {
356
+ enforcement = 'partial';
357
+ degradedFailClosed = config.onUnavailable === 'fail-closed';
358
+ backendDetail = degradedFailClosed
359
+ ? `容器后端不可用,且配置选了「后端建不起来就拒」:写与执行类工具一律拒(读照常)——${probe.detail}`
360
+ : `容器后端不可用,已降级为策略围栏:${probe.detail}`;
361
+ ctx.transcript.system(degradedFailClosed
362
+ ? `沙箱:选的容器后端用不了,按配置 fail-closed 处理,写与执行类工具一律拒——${probe.detail}`
363
+ : `沙箱:选的容器后端用不了,已降级为策略围栏(强制执行 partial,照常执行 + 审批卡兜底)——${probe.detail}`);
364
+ ctx.emit('dsc/changed');
365
+ return backendDetail;
366
+ }
367
+ const runner = createDockerRunner({
368
+ image: config.image,
369
+ networkAccess: () => readConfig().config.networkAccess,
370
+ readOnly: () => readConfig().config.mode === 'read-only',
371
+ });
372
+ offRunner = registerCommandRunner(runner);
373
+ enforcement = 'full';
374
+ backendDetail = `容器后端可用(${probe.detail}),命令在 ${config.image} 里跑`;
375
+ ctx.emit('dsc/changed');
376
+ return backendDetail;
377
+ };
378
+ /** 挂载时那条可见说明:只讲档位、强制等级与网络,明细(后端、可写根)在 /sandbox 与设置里。 */
379
+ const mountLine = () => {
380
+ const { config, problems } = snapshot();
381
+ const head = `沙箱已就绪:档位 ${config.mode}|强制执行 ${enforcement}|网络 ${config.networkAccess ? '开' : '关'}`;
382
+ const tail = enforcement === 'partial'
383
+ ? (config.backend === 'windows-token'
384
+ ? '。越界写已被系统层拦截;明细见 /sandbox。'
385
+ : '。策略围栏拦得住工具调用,拦不住命令内部的任意写,要真隔离请在「设置 → 沙箱」换后端。')
386
+ : '。';
387
+ const warn = problems.length === 0 ? '' : ` ⚠ 配置有问题(已按默认值兜底):${problems.join(';')}`;
388
+ return `${head}${tail}${warn}`;
389
+ };
390
+ /** 跑一次网络第二级体检(不抛:任何异常都变成明细里的一条)。 */
391
+ const refreshNetworkTier = async () => {
392
+ if (process.platform !== 'win32') {
393
+ networkTier = 'partial';
394
+ networkTierDetail = '非 Windows 平台:网络第二级不适用';
395
+ ctx.emit('dsc/changed');
396
+ return;
397
+ }
398
+ try {
399
+ const result = await doctorWindowsNetwork(DSC_HOME);
400
+ networkTier = result.tier;
401
+ networkTierDetail = result.details.join(';');
402
+ }
403
+ catch (error) {
404
+ networkTierDetail = `体检失败:${error instanceof Error ? error.message : String(error)}`;
405
+ }
406
+ ctx.emit('dsc/changed');
407
+ };
408
+ // ── 设置分区 ─────────────────────────────────────────────────────────────
409
+ /** `/sandbox` 与设置页共用的一份现状文本。 */
410
+ const report = () => {
411
+ const { config, policy, problems } = snapshot();
412
+ const lines = [];
413
+ lines.push(`沙箱现状:档位 ${config.mode}|强制执行 ${enforcement}`);
414
+ lines.push(`后端:${config.backend} —— ${backendDetail}`);
415
+ lines.push(`可写根(${String(policy.roots.length)}):`);
416
+ if (policy.roots.length === 0)
417
+ lines.push(' (无:只读档不许写盘)');
418
+ for (const root of policy.roots)
419
+ lines.push(` ${root}`);
420
+ lines.push(`只读子路径(${String(policy.readOnlySubpaths.length)}):${policy.readOnlySubpaths.length === 0 ? '无' : ''}`);
421
+ for (const sub of policy.readOnlySubpaths)
422
+ lines.push(` ${sub}`);
423
+ lines.push(`网络:${config.networkAccess ? '开' : '关'}|出网白名单 ${String(config.networkAllowlist.length)} 项|沙箱私有临时目录:${policy.tmpDir}`);
424
+ lines.push(`后端建不起来时:${config.onUnavailable}${degradedFailClosed ? '(当前正处在这个状态:写与执行类一律拒)' : ''}`);
425
+ // 本会话被「本会话允许」放宽出来的可写根:不列出来用户会以为自己的批次没生效(或以为放宽丢了)。
426
+ const granted = sessionRoots.get(currentSessionPath()) ?? [];
427
+ if (granted.length > 0) {
428
+ lines.push(`本会话放宽出来的可写根(${String(granted.length)}):`);
429
+ for (const root of granted)
430
+ lines.push(` ${root}`);
431
+ }
432
+ if (process.platform === 'win32')
433
+ lines.push(`网络第二级:${networkTier} —— ${networkTierDetail}`);
434
+ lines.push('最近 3 次拒绝:');
435
+ if (denials.length === 0)
436
+ lines.push(' (还没有)');
437
+ for (const one of denials)
438
+ lines.push(` [${clockOf(one.at)}] ${one.tool} · ${one.rule} —— ${one.why}`);
439
+ if (problems.length > 0)
440
+ lines.push(`⚠ 配置有问题(已按默认值兜底):${problems.join(';')}`);
441
+ return lines.join('\n');
442
+ };
443
+ const section = {
444
+ id: SANDBOX_CONFIG_KEY,
445
+ title: '沙箱',
446
+ subtitle: '档位、可写根、网络开关与强制后端:拦「能不能写」,不拦「要不要问」',
447
+ order: SECTION_ORDER,
448
+ fields() {
449
+ const { config, policy, problems } = snapshot();
450
+ const list = [
451
+ {
452
+ type: 'select',
453
+ key: 'mode',
454
+ label: '档位',
455
+ options: [
456
+ { value: 'read-only', label: '只读(任何写盘都拒)' },
457
+ { value: 'workspace-write', label: '工作区可写(默认)' },
458
+ { value: 'danger-full-access', label: '不设围栏(等同关掉沙箱)' },
459
+ ],
460
+ help: '默认档不挡正常的工作区读写与命令:只有越界写、受保护名与「网络关时的联网命令」会被拒。',
461
+ },
462
+ {
463
+ type: 'select',
464
+ key: 'onUnavailable',
465
+ label: '后端建不起来时',
466
+ options: [
467
+ { value: 'degrade', label: '降级为策略围栏(照常干,审批卡兜底)' },
468
+ { value: 'fail-closed', label: '拒绝:写与执行类一律拒(读照常)' },
469
+ ],
470
+ help: '只对 docker / windows-token 这两个「要真隔离」的后端生效:它们建不起来时按哪种姿态收场。策略围栏后端的 partial 是预期状态,不受这一项影响。',
471
+ },
472
+ {
473
+ type: 'switch',
474
+ key: 'networkAccess',
475
+ label: '网络访问',
476
+ help: '关时命中网络命令一律拒(curl / wget / npm install / git pull 这类)。开关只拦「写在命令里的」网络动作,脚本内部的请求拦不住。',
477
+ },
478
+ {
479
+ type: 'text',
480
+ key: 'networkAllowlist',
481
+ label: '出网白名单(分号分隔域名)',
482
+ mono: true,
483
+ placeholder: 'registry.npmjs.org; *.example.com',
484
+ help: 'windows-token 后端第二级(提权 setup 后)的代理按这份清单放行;*.example.com 匹配子域,精确域不含子域。清单为空 = 开着网也没放任何域名。',
485
+ },
486
+ {
487
+ type: 'text',
488
+ key: 'extraWritableRoots',
489
+ label: '附加可写根(分号分隔)',
490
+ mono: true,
491
+ placeholder: 'D:\\shared; /srv/cache',
492
+ help: '在工作区与私有临时目录之外再放行几个目录。相对路径按会话工作目录展开。',
493
+ },
494
+ {
495
+ type: 'text',
496
+ key: 'readOnlySubpaths',
497
+ label: '只读子路径(分号分隔)',
498
+ mono: true,
499
+ placeholder: 'D:\\proj\\generated',
500
+ help: '可写根内部的例外:这些子树即使落在可写根里也不许写。',
501
+ },
502
+ {
503
+ type: 'select',
504
+ key: 'backend',
505
+ label: '强制后端',
506
+ options: [
507
+ { value: 'policy', label: '进程内策略围栏(默认,强制执行 partial)' },
508
+ { value: 'windows-token', label: 'Windows 受限令牌(仅 Windows,越界写系统层拦截)' },
509
+ { value: 'docker', label: '容器(需要本机 docker,强制执行 full)' },
510
+ ],
511
+ help: '受限令牌后端把命令换进「受限令牌 + 工作区 ACL」的 runner 子进程里跑(无需 docker,命令内部的越界写会被系统直接拒绝;' +
512
+ '已知缺口:硬链接别名、读不受限、网络真管控需一次性提权 setup)。' +
513
+ '容器后端把命令换进 docker 里跑(只挂工作区,网络按上面的开关),适合跨平台构建命令。' +
514
+ '认不出 shell 形态的命令不会被换执行体,那一句仍会在宿主上跑。',
515
+ },
516
+ {
517
+ type: 'text',
518
+ key: 'image',
519
+ label: '容器镜像',
520
+ mono: true,
521
+ placeholder: DEFAULT_SANDBOX_IMAGE,
522
+ help: `容器后端用的镜像,默认 ${DEFAULT_SANDBOX_IMAGE}。镜像里得有你那条命令要用的工具(例如 node:20-alpine)。`,
523
+ },
524
+ { type: 'info', label: '强制执行等级', text: `${enforcement} —— ${enforcementText()}` },
525
+ { type: 'info', label: '后端现状', text: backendDetail },
526
+ { type: 'info', label: '沙箱私有临时目录', mono: true, copyable: true, text: policy.tmpDir },
527
+ { type: 'info', label: '当前生效', text: describePolicy(policy) },
528
+ {
529
+ type: 'info',
530
+ label: '最近 3 次拒绝',
531
+ text: denials.length === 0 ? '(还没有)' : denials.map((one) => `[${clockOf(one.at)}] ${one.tool} · ${one.rule} —— ${one.why}`).join('\n'),
532
+ },
533
+ {
534
+ type: 'button',
535
+ action: 'probe',
536
+ label: '立即探测后端',
537
+ style: 'ghost',
538
+ help: '按上面的后端选项现探一次:容器可不可用、降级到哪一档,结果就在按钮下面那句提示里。',
539
+ },
540
+ ];
541
+ if (process.platform === 'win32') {
542
+ list.push({ type: 'info', label: '网络第二级(提权布防)', text: `${networkTier} —— ${networkTierDetail}` }, {
543
+ type: 'button',
544
+ action: 'setup',
545
+ label: '提权安装网络管控(UAC 一次)',
546
+ style: 'ghost',
547
+ help: '创建专用离线账号、按账号 SID 出网阻断(防火墙 5 规则 + WFP 12 条持久 filter)、密码 DPAPI 落盘;账号先禁用、布防全部成功才解禁。需要你在 UAC 弹窗点一次允许。',
548
+ }, {
549
+ type: 'button',
550
+ action: 'doctor',
551
+ label: '体检网络第二级',
552
+ style: 'ghost',
553
+ help: '逐项核对:FFI、状态文件、账号、密码可解、防火墙规则、WFP 子层;全绿即 full。',
554
+ });
555
+ }
556
+ if (problems.length > 0) {
557
+ list.push({
558
+ type: 'info',
559
+ label: '配置有问题(已按默认值兜底)',
560
+ text: problems.join(';'),
561
+ help: '沙箱的坏配置不会把工作区写全禁掉——它只是少了一层围栏,所以这里回落默认值并如实列出来。',
562
+ });
563
+ }
564
+ return list;
565
+ },
566
+ values() {
567
+ const { config } = readConfig();
568
+ return {
569
+ mode: config.mode,
570
+ networkAccess: config.networkAccess,
571
+ networkAllowlist: formatPathList(config.networkAllowlist),
572
+ extraWritableRoots: formatPathList(config.extraWritableRoots),
573
+ readOnlySubpaths: formatPathList(config.readOnlySubpaths),
574
+ backend: config.backend,
575
+ image: config.image,
576
+ onUnavailable: config.onUnavailable,
577
+ };
578
+ },
579
+ async save(key, value) {
580
+ switch (key) {
581
+ case 'mode': {
582
+ const mode = String(value);
583
+ if (!SANDBOX_MODES.includes(mode))
584
+ return `档位只能是 ${SANDBOX_MODES.join(' / ')}`;
585
+ writePluginConfig(SANDBOX_CONFIG_KEY, { mode });
586
+ break;
587
+ }
588
+ case 'networkAccess':
589
+ writePluginConfig(SANDBOX_CONFIG_KEY, { networkAccess: value === true });
590
+ break;
591
+ case 'networkAllowlist': {
592
+ const { domains, bad } = parseAllowlistText(typeof value === 'string' ? value : String(value));
593
+ if (bad.length > 0)
594
+ return `白名单里有不像域名的项:${bad.join(';')}`;
595
+ writePluginConfig(SANDBOX_CONFIG_KEY, { networkAllowlist: domains });
596
+ break;
597
+ }
598
+ case 'onUnavailable': {
599
+ const mode = String(value);
600
+ if (mode !== 'degrade' && mode !== 'fail-closed')
601
+ return '「后端建不起来时」只能是 degrade(降级继续)或 fail-closed(写与执行一律拒)';
602
+ writePluginConfig(SANDBOX_CONFIG_KEY, { onUnavailable: mode });
603
+ break;
604
+ }
605
+ case 'extraWritableRoots':
606
+ writePluginConfig(SANDBOX_CONFIG_KEY, { extraWritableRoots: parsePathListText(typeof value === 'string' ? value : String(value)) });
607
+ break;
608
+ case 'readOnlySubpaths':
609
+ writePluginConfig(SANDBOX_CONFIG_KEY, { readOnlySubpaths: parsePathListText(typeof value === 'string' ? value : String(value)) });
610
+ break;
611
+ case 'backend': {
612
+ const backend = String(value);
613
+ if (backend !== 'policy' && backend !== 'docker' && backend !== 'windows-token') {
614
+ return '后端只能是 policy(策略围栏)/ docker(容器)/ windows-token(Windows 受限令牌)';
615
+ }
616
+ writePluginConfig(SANDBOX_CONFIG_KEY, { backend });
617
+ break;
618
+ }
619
+ case 'image': {
620
+ const image = String(value).trim();
621
+ if (image === '')
622
+ return '镜像名不能空着(要恢复默认就填 ' + DEFAULT_SANDBOX_IMAGE + ')';
623
+ if (/\s/.test(image))
624
+ return '镜像名不能带空格';
625
+ writePluginConfig(SANDBOX_CONFIG_KEY, { image });
626
+ break;
627
+ }
628
+ default:
629
+ return `这个分区没有这项:${key}`;
630
+ }
631
+ // 档位/后端/网络都可能改变强制等级,改完立刻重算一次
632
+ await refreshBackend();
633
+ ctx.emit('dsc/changed');
634
+ },
635
+ async action(name) {
636
+ if (name === 'probe')
637
+ return await refreshBackend();
638
+ if (name === 'doctor') {
639
+ await refreshNetworkTier();
640
+ return `网络第二级:${networkTier} —— ${networkTierDetail}`;
641
+ }
642
+ if (name === 'setup') {
643
+ if (process.platform !== 'win32')
644
+ return '网络第二级只适用于 Windows';
645
+ const result = await runSetupElevated(DSC_HOME);
646
+ await refreshNetworkTier();
647
+ const verdict = result.ok ? '提权 setup 完成' : '提权 setup 未完成';
648
+ return `${verdict}:${result.detail}|体检:${networkTier} —— ${networkTierDetail}`;
649
+ }
650
+ return `这个分区没有这个按钮:${name}`;
651
+ },
652
+ };
653
+ const offSection = ctx.settings.registerSection(section);
654
+ // ── /sandbox 命令 ─────────────────────────────────────────────────────────
655
+ const offCommand = ctx.commands.register({ name: 'sandbox', args: '', description: '看沙箱档位、强制执行等级、可写根、网络开关与最近 3 次拒绝' }, ({ ui }) => {
656
+ ui.notice(report());
657
+ });
658
+ // ── 对外服务 ─────────────────────────────────────────────────────────────
659
+ const service = {
660
+ get mode() {
661
+ return readConfig().config.mode;
662
+ },
663
+ get enforcement() {
664
+ return enforcement;
665
+ },
666
+ get writableRoots() {
667
+ return snapshot().policy.roots;
668
+ },
669
+ get networkAccess() {
670
+ return readConfig().config.networkAccess;
671
+ },
672
+ get tmpDir() {
673
+ return snapshot().policy.tmpDir;
674
+ },
675
+ canWrite(path, cwd) {
676
+ // cwd 省略时退回会话工作目录(接口约定见 src/services/types.ts 的 SandboxService)。
677
+ const { policy } = snapshot(cwd);
678
+ const check = checkWrite(policy, path);
679
+ const out = { allowed: check.allowed, reason: check.reason };
680
+ if (check.root !== undefined)
681
+ out.root = check.root;
682
+ return out;
683
+ },
684
+ describe() {
685
+ const { config, policy } = snapshot();
686
+ return `沙箱 ${config.mode}(强制执行 ${enforcement}):${describePolicy(policy)}`;
687
+ },
688
+ /**
689
+ * 切档位(打包权限预设的写入口;设置页那一格走的也是同一份写盘 + 重算)。
690
+ * 只写配置值并立刻广播,重算后端在后台跑——档位值当拍就对,强制等级下一拍跟上。
691
+ * @param next - 三档之一;写错当场抛错(预设表是常量,正常到不了这里)。
692
+ */
693
+ /**
694
+ * 记一条**本会话**的放宽:把几个绝对路径并进这个会话的可写根。
695
+ * 只有审批卡上「本会话允许」那一按会调它(调用方是 approval 插件)。
696
+ */
697
+ grantSession(sessionPath, roots) {
698
+ if (sessionPath === '' || roots.length === 0)
699
+ return;
700
+ const current = sessionRoots.get(sessionPath) ?? [];
701
+ const merged = [...current];
702
+ for (const root of roots)
703
+ if (root !== '' && !merged.includes(root))
704
+ merged.push(root);
705
+ sessionRoots.set(sessionPath, merged);
706
+ },
707
+ /** 读一个会话已经放宽出来的可写根(诊断与 `/sandbox` 用)。 */
708
+ sessionGrants(sessionPath) {
709
+ return sessionRoots.get(sessionPath) ?? [];
710
+ },
711
+ setMode(next) {
712
+ if (!SANDBOX_MODES.includes(next)) {
713
+ throw new Error(`沙箱档位只能是 ${SANDBOX_MODES.join(' / ')},收到「${next}」`);
714
+ }
715
+ writePluginConfig(SANDBOX_CONFIG_KEY, { mode: next });
716
+ ctx.emit('dsc/changed');
717
+ void refreshBackend().catch(() => {
718
+ // 重算失败维持现状:下一次工具调用会在 plan() 里自己降级并如实上报
719
+ });
720
+ },
721
+ };
722
+ const offService = ctx.provide('sandbox', service);
723
+ // 换会话 = 换工作目录:受限令牌后端的可写根必须跟着重建(授权按路径缓存,重复授权幂等)。
724
+ const offSession = ctx.on('dsc/session-open', () => {
725
+ void refreshBackend().catch(() => {
726
+ // 重建失败维持现状:下一次 plan() 会在授权失败时自己降级并如实上报
727
+ });
728
+ ctx.emit('dsc/changed');
729
+ });
730
+ // 挂载后立刻探一次后端,并把现状写进会话流:降级(partial)必须看得见。
731
+ // 启动提示只展示一次(0.6.64):档位/强制等级/网络没变就不重复说。
732
+ void refreshBackend()
733
+ .then(() => {
734
+ if (disposed)
735
+ return;
736
+ const line = mountLine();
737
+ if (bootNoticeOnce('sandbox.ready', line))
738
+ ctx.transcript.system(line);
739
+ })
740
+ .catch((error) => {
741
+ if (!disposed)
742
+ ctx.transcript.system(`沙箱后端探测失败(照常执行 + 审批卡兜底):${errText(error)}`);
743
+ });
744
+ // 网络第二级体检(异步,结论进设置页与 /sandbox;不写会话流,避免挂载信息过载)
745
+ void refreshNetworkTier();
746
+ return () => {
747
+ disposed = true;
748
+ generation += 1;
749
+ offRunner?.();
750
+ offRunner = null;
751
+ offWinDispose?.();
752
+ offWinDispose = null;
753
+ offSession();
754
+ offService();
755
+ offCommand();
756
+ offSection();
757
+ offPrompt();
758
+ offGuard();
759
+ };
760
+ },
761
+ };