@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,559 @@
1
+ /**
2
+ * 沙箱路径策略:把「这个路径能不能写」判成一串纯函数(不碰 ctx、不读设置服务)。
3
+ *
4
+ * 为什么独立成模块:沙箱的判定要能被单元自检直接 import 跑,
5
+ * 不必装配整个内核;判定逻辑一旦和注册(守卫/设置/命令)混在一个文件里,
6
+ * 「这条路径为什么被拒」就只能靠起宿主来验。
7
+ *
8
+ * 几处刻意的取舍,都写在对应函数上方:
9
+ * 1. NT 命名空间前缀(`\\?\`、`\\.\`、`\??\`、`GLOBALROOT`)在**任何解析之前**判原始串——
10
+ * 照 hermes `agent/file_safety.py` 的理由:把这种路径喂给 realpath/resolve 就可能
11
+ * 触发一次 SMB 认证,NTLM 哈希在握手阶段就泄出去了,判定本身成了攻击面。
12
+ * 所以这里的顺序是「先否认形状,再谈归属」。
13
+ * 2. 解析用 `realpathSync.native`(Windows 上顺便把 8.3 短名换成长期名),
14
+ * 文件还不存在时(write 工具建新文件是常态)逐级退到最近的存在祖先,再把剩下的段接回去;
15
+ * 接回去的那几段 realpath 验不了,于是**短名形状与符号链接只能在存在段上验证**——
16
+ * 验不了的形状(8.3 短名)保守拒掉,能验的(符号链接)按真实目标判。
17
+ * 3. 解析彻底失败(盘符不存在、权限不足)保守拒绝:判不清就不放行。
18
+ *
19
+ * @module dsc/core/sandbox/policy
20
+ */
21
+ import { realpathSync } from 'node:fs';
22
+ import { createHash } from 'node:crypto';
23
+ import { basename, dirname, isAbsolute, join, normalize, relative, resolve } from 'node:path';
24
+ /** 条目树里这个插件的键,同时是设置分区 id。 */
25
+ export const SANDBOX_CONFIG_KEY = 'sandbox';
26
+ /** 三档(形制照 codex 的 `sandbox_mode`)。 */
27
+ export const SANDBOX_MODES = ['read-only', 'workspace-write', 'danger-full-access'];
28
+ /**
29
+ * 强制后端:进程内策略围栏 / 容器 / Windows 受限令牌。
30
+ *
31
+ * `windows-token`(2026-10-xx 起提供)推翻了「受限令牌那一路不做」的旧决定:
32
+ * 当时拒绝它的理由是零 npm 依赖硬约束与「半可靠比明说 partial 更危险」。
33
+ * 用户已拍板引入 koffi(预构建 N-API FFI,dsh 同款路线)换真隔离——
34
+ * 文件系统效果由 ACL + 受限令牌强制,网络由「专用账号 + WFP + 白名单代理」强制,
35
+ * 且 enforcement 与缺口清单如实上报,旧的「半可靠装可靠」顾虑由诚实上报解决。
36
+ * 平台与依赖不可用时它不可选,不会悄悄回落成 policy。
37
+ */
38
+ export const SANDBOX_BACKENDS = ['policy', 'docker', 'windows-token'];
39
+ /**
40
+ * 选了要外部隔离的后端、但它建不起来时怎么办:
41
+ * degrade 按策略围栏降级继续干(`enforcement` 如实上报 partial,审批卡兜底)——出厂默认;
42
+ * fail-closed 写与执行类工具一律拒(读照常),理由是「你要的隔离没建起来」。
43
+ *
44
+ * 为什么要有这一档:dsh 要求「拿绝对保证的调用方对 partial 必须拒绝」,dsc 原来是**降级不拒**
45
+ * (自称与 dsh 最大的分歧点)。两种姿态都合理,取决于这台机器是干什么的,所以做成显式开关:
46
+ * 默认保持既有行为(不改老用户),要硬保证的人自己打开。
47
+ *
48
+ * 只对「用户主动选了 docker / windows-token 却没建成」生效:`policy` 后端的 partial
49
+ * 是**预期状态**(进程内策略围栏本来就是这个等级),不是降级,所以永远不触发 fail-closed。
50
+ */
51
+ export const SANDBOX_ON_UNAVAILABLE = ['degrade', 'fail-closed'];
52
+ /** 容器后端的默认镜像(小、带 sh,够跑构建与测试)。 */
53
+ export const DEFAULT_SANDBOX_IMAGE = 'alpine:3';
54
+ /** 默认档就是 workspace-write:正常的工作区读写/bash 全部照常。 */
55
+ export const DEFAULT_SANDBOX_CONFIG = {
56
+ mode: 'workspace-write',
57
+ networkAccess: false,
58
+ networkAllowlist: [],
59
+ extraWritableRoots: [],
60
+ readOnlySubpaths: [],
61
+ backend: 'policy',
62
+ image: DEFAULT_SANDBOX_IMAGE,
63
+ onUnavailable: 'degrade',
64
+ };
65
+ /**
66
+ * 校验一份配置。
67
+ *
68
+ * 与审批灾难地板的「坏配置一律拒」刻意不同:那里坏掉是安全边界不清,
69
+ * 这里坏掉只是**少了一层围栏**,所以照 codex 的姿态回落默认值 + 把问题说出来
70
+ * (设置分区里能看到、挂载时也会提示一次),而不是把用户的工作区写全禁掉。
71
+ */
72
+ export function resolveSandboxConfig(raw) {
73
+ if (raw === null || raw === undefined || typeof raw !== 'object' || Array.isArray(raw)) {
74
+ return { config: { ...DEFAULT_SANDBOX_CONFIG }, problems: [] };
75
+ }
76
+ const doc = raw;
77
+ const problems = [];
78
+ const config = { ...DEFAULT_SANDBOX_CONFIG };
79
+ if (doc.mode !== undefined) {
80
+ const mode = String(doc.mode);
81
+ if (SANDBOX_MODES.includes(mode))
82
+ config.mode = mode;
83
+ else
84
+ problems.push(`档位只能是 ${SANDBOX_MODES.join(' / ')},收到「${mode}」,已按默认 workspace-write 走`);
85
+ }
86
+ if (doc.networkAccess !== undefined) {
87
+ if (typeof doc.networkAccess === 'boolean')
88
+ config.networkAccess = doc.networkAccess;
89
+ else
90
+ problems.push(`网络开关要 true/false,收到「${String(doc.networkAccess)}」,已按关处理`);
91
+ }
92
+ for (const [key, target] of [
93
+ ['extraWritableRoots', 'extraWritableRoots'],
94
+ ['readOnlySubpaths', 'readOnlySubpaths'],
95
+ ]) {
96
+ const value = doc[key];
97
+ if (value === undefined)
98
+ continue;
99
+ if (Array.isArray(value))
100
+ config[target] = value.map((item) => String(item)).filter((item) => item.trim() !== '');
101
+ else if (typeof value === 'string')
102
+ config[target] = parsePathListText(value);
103
+ else
104
+ problems.push(`${key} 要一个字符串数组(设置页里是分号分隔的文本),已忽略`);
105
+ }
106
+ if (doc.networkAllowlist !== undefined) {
107
+ const value = doc.networkAllowlist;
108
+ if (Array.isArray(value)) {
109
+ const { domains, bad } = parseAllowlist(value.map((item) => String(item)));
110
+ config.networkAllowlist = domains;
111
+ if (bad.length > 0)
112
+ problems.push(`出网白名单里有不像域名的项,已忽略:${bad.join('、')}`);
113
+ }
114
+ else if (typeof value === 'string') {
115
+ const { domains, bad } = parseAllowlistText(value);
116
+ config.networkAllowlist = domains;
117
+ if (bad.length > 0)
118
+ problems.push(`出网白名单里有不像域名的项,已忽略:${bad.join('、')}`);
119
+ }
120
+ else
121
+ problems.push('networkAllowlist 要字符串数组或分号分隔的文本,已忽略');
122
+ }
123
+ if (doc.backend !== undefined) {
124
+ const backend = String(doc.backend);
125
+ if (SANDBOX_BACKENDS.includes(backend))
126
+ config.backend = backend;
127
+ else
128
+ problems.push(`后端只能是 ${SANDBOX_BACKENDS.join(' / ')},收到「${backend}」,已按 policy 走`);
129
+ }
130
+ if (doc.image !== undefined) {
131
+ const image = String(doc.image).trim();
132
+ if (image === '' || /\s/.test(image))
133
+ problems.push(`容器镜像名不能为空也不能带空格,收到「${image}」,已按 ${DEFAULT_SANDBOX_IMAGE} 走`);
134
+ else
135
+ config.image = image;
136
+ }
137
+ if (doc.onUnavailable !== undefined) {
138
+ const value = String(doc.onUnavailable);
139
+ if (SANDBOX_ON_UNAVAILABLE.includes(value))
140
+ config.onUnavailable = value;
141
+ else
142
+ problems.push(`「后端建不起来时」只能是 ${SANDBOX_ON_UNAVAILABLE.join(' / ')},收到「${value}」,已按 degrade 走`);
143
+ }
144
+ return { config, problems };
145
+ }
146
+ /** 设置页那个框(分号或换行分隔)→ 路径数组;去重保序。 */
147
+ export function parsePathListText(text) {
148
+ const seen = new Set();
149
+ const out = [];
150
+ for (const piece of text.split(/[;\n\r]+/)) {
151
+ const value = piece.trim();
152
+ if (value === '' || seen.has(value))
153
+ continue;
154
+ seen.add(value);
155
+ out.push(value);
156
+ }
157
+ return out;
158
+ }
159
+ /** 路径数组 → 设置页那个框的文本。 */
160
+ export function formatPathList(paths) {
161
+ return paths.join('; ');
162
+ }
163
+ /**
164
+ * 单个出网白名单条目的校验与归一:小写、去末尾点,接受 `example.com` 与
165
+ * `*.example.com`(通配只能整段,`*x.example.com` 这类不收)。
166
+ * 返回归一后的串;不像域名就给拒因。
167
+ */
168
+ export function normalizeAllowlistEntry(raw) {
169
+ const domain = raw.trim().toLowerCase().replace(/\.+$/, '');
170
+ if (domain === '')
171
+ return { ok: false, why: '空条目' };
172
+ if (/\s/.test(domain))
173
+ return { ok: false, why: `「${raw}」带了空格` };
174
+ if (domain.includes('/'))
175
+ return { ok: false, why: `「${raw}」是路径不是域名(白名单按域匹配,不带路径)` };
176
+ const host = domain.startsWith('*.') ? domain.slice(2) : domain;
177
+ if (host === '' || host.startsWith('.') || host.endsWith('.') || host.includes('..')) {
178
+ return { ok: false, why: `「${raw}」域名形状不对` };
179
+ }
180
+ // 逐段校验:字母数字与连字符,IDN 直接拒(让用户用 punycode 写,判定里少一层归一化歧义)
181
+ const label = /^[a-z0-9]([a-z0-9-]*[a-z0-9])?$/;
182
+ for (const part of host.split('.')) {
183
+ if (part === '' || !label.test(part))
184
+ return { ok: false, why: `「${raw}」里的「${part}」不是合法的域名字段(中文域名请用 punycode)` };
185
+ }
186
+ return { ok: true, domain };
187
+ }
188
+ /** 已拆好的条目数组 → 归一域名列表 + 拒因列表(保序去重)。 */
189
+ export function parseAllowlist(entries) {
190
+ const domains = [];
191
+ const bad = [];
192
+ const seen = new Set();
193
+ for (const raw of entries) {
194
+ const one = normalizeAllowlistEntry(raw);
195
+ if (!one.ok) {
196
+ bad.push(one.why);
197
+ continue;
198
+ }
199
+ if (seen.has(one.domain))
200
+ continue;
201
+ seen.add(one.domain);
202
+ domains.push(one.domain);
203
+ }
204
+ return { domains, bad };
205
+ }
206
+ /** 设置页那个框(分号或换行分隔)→ 白名单(带逐项拒因)。 */
207
+ export function parseAllowlistText(text) {
208
+ return parseAllowlist(text.split(/[;\n\r]+/));
209
+ }
210
+ /**
211
+ * host 是否被白名单放行:全等,或通配域(`*.example.com`)匹配「任意段后缀但至少一段」。
212
+ * 精确域不放行子域——`example.com` 不含 `api.example.com`;要连子域一起放就写 `*.example.com`。
213
+ */
214
+ export function allowlistMatches(host, list) {
215
+ const name = host.trim().toLowerCase().replace(/\.+$/, '');
216
+ if (name === '')
217
+ return false;
218
+ for (const entry of list) {
219
+ if (entry === name)
220
+ return true;
221
+ if (entry.startsWith('*.')) {
222
+ const suffix = entry.slice(1); // '.example.com'
223
+ if (name.endsWith(suffix) && name.length > suffix.length && !name.slice(0, -suffix.length).includes('.')) {
224
+ return true;
225
+ }
226
+ }
227
+ }
228
+ return false;
229
+ }
230
+ /** 沙箱私有临时目录:`<dscHome>/sandbox/tmp/<会话 id 或 cwd 哈希>`。 */
231
+ export function sandboxTmpDir(dscHome, cwd, sessionId) {
232
+ const safe = (sessionId ?? '').replace(/[^A-Za-z0-9_-]/g, '').slice(0, 64);
233
+ const slug = safe !== '' ? safe : createHash('sha256').update(cwd).digest('hex').slice(0, 12);
234
+ return join(dscHome, 'sandbox', 'tmp', slug);
235
+ }
236
+ // ---------------------------------------------------------------- 形状守卫(解析之前)
237
+ /** NT 命名空间前缀:命中就拒,且必须在任何 resolve/realpath 之前判。 */
238
+ const NT_NAMESPACE = /\\\\[?.]\\|\\\?\?\\/i;
239
+ /**
240
+ * 原始字符串是不是 NT 命名空间路径。
241
+ *
242
+ * 为什么判「出现在任意位置」而不是只看开头:`C:\x\\?\C:\Windows` 这类拼接串同样会被
243
+ * 解析器当成设备路径。代价是 POSIX 上文件名里含反斜杠的极少数情况会被误拒——
244
+ * 这是有意的:安全侧宁可误拒一次让人换普通路径。
245
+ */
246
+ export function ntNamespaceReason(raw) {
247
+ if (NT_NAMESPACE.test(raw)) {
248
+ return '路径里出现 Windows NT 命名空间前缀(\\\\?\\ / \\\\.\\ / \\??\\):光解析它就可能触发一次 SMB 认证并泄漏 NTLM 凭据,因此直接拒';
249
+ }
250
+ if (/globalroot/i.test(raw))
251
+ return '路径里出现 GLOBALROOT(NT 设备命名空间):绕过所有路径校验,直接拒';
252
+ return null;
253
+ }
254
+ /** 8.3 短名形状(只在其所在段无法用 realpath 验证时才拒)。 */
255
+ const SHORT_NAME = /^[^\\/]{1,6}~\d{1,3}(\.[^\\/]{1,3})?$/;
256
+ /**
257
+ * NTFS 备选数据流(ADS):`f.txt:stream` 会写到另一个「看不见的」文件里,
258
+ * `C:\ws\ok.txt:hidden` 的可见部分仍在可写根内,判定必须看真实落点。
259
+ * 我们不做流级判定,直接拒(Windows 上正常文件名不许带冒号)。
260
+ */
261
+ export function adsStreamReason(raw, win32) {
262
+ if (!win32)
263
+ return null;
264
+ const withoutDrive = raw.replace(/^[A-Za-z]:/, '');
265
+ if (withoutDrive.includes(':')) {
266
+ return '路径里带 NTFS 备选数据流(`文件:流名`):真实落点不是这个文件名,直接拒';
267
+ }
268
+ return null;
269
+ }
270
+ // ---------------------------------------------------------------- 规范化
271
+ /** 去掉末尾分隔符,但盘根(`C:\`、`/`)保留原样。 */
272
+ function stripTrailingSep(path) {
273
+ if (path === '' || path === '/' || path === '\\')
274
+ return path;
275
+ if (/^[A-Za-z]:[\\/]$/.test(path))
276
+ return path;
277
+ return path.replace(/[\\/]+$/, '');
278
+ }
279
+ /** realpath 两套都试一遍(native 在 Windows 上会把 8.3 短名换成长期名)。 */
280
+ function tryRealpath(path) {
281
+ try {
282
+ return realpathSync.native(path);
283
+ }
284
+ catch {
285
+ try {
286
+ return realpathSync(path);
287
+ }
288
+ catch {
289
+ return null;
290
+ }
291
+ }
292
+ }
293
+ /**
294
+ * 把一个路径规范化成可以互相比对的形式。
295
+ *
296
+ * 步骤:绝对化 → 逐级往上找到最近的存在祖先并 realpath 它 → 把不存在的尾段接回去。
297
+ * 尾段里的 8.3 短名无法验证(`PROGRA~1` 到底是哪个目录只有文件系统知道),一律拒;
298
+ * 尾段里的符号链接同样验证不了,但它的**父目录**已经 realpath 过,
299
+ * 所以「建个软链指到工作区外再写进去」这条最常用的绕法在存在段上就被拦住了。
300
+ */
301
+ export function canonicalizePath(raw, options) {
302
+ const absolute = stripTrailingSep(isAbsolute(raw) ? normalize(raw) : resolve(options.cwd, raw));
303
+ let candidate = absolute;
304
+ const tail = [];
305
+ for (;;) {
306
+ const real = tryRealpath(candidate);
307
+ if (real !== null) {
308
+ const base = stripTrailingSep(real);
309
+ const withTail = tail.length === 0 ? base : join(base, ...[...tail].reverse());
310
+ if (options.win32) {
311
+ const bad = [...tail].reverse().find((segment) => SHORT_NAME.test(segment));
312
+ if (bad !== undefined) {
313
+ return {
314
+ ok: false,
315
+ path: stripTrailingSep(withTail),
316
+ rule: 'short-name',
317
+ reason: `路径段「${bad}」像 8.3 短名(真实目录名只有文件系统知道):这个目标还不存在,无法验证它落在哪个目录里,保守拒绝`,
318
+ tail,
319
+ };
320
+ }
321
+ }
322
+ return { ok: true, path: stripTrailingSep(withTail), tail };
323
+ }
324
+ const parent = dirname(candidate);
325
+ if (parent === candidate) {
326
+ return {
327
+ ok: false,
328
+ path: absolute,
329
+ rule: 'unresolvable',
330
+ reason: `路径无法解析(盘符不存在、权限不足或被拒绝访问):判不清落点就不放行 → ${absolute}`,
331
+ tail,
332
+ };
333
+ }
334
+ tail.push(basename(candidate));
335
+ candidate = parent;
336
+ }
337
+ }
338
+ // ---------------------------------------------------------------- 受保护名
339
+ /** 命中即拒写的凭据/密钥文件名(不看扩展名)。 */
340
+ const CREDENTIAL_BASENAMES = new Set([
341
+ 'id_rsa',
342
+ 'id_dsa',
343
+ 'id_ecdsa',
344
+ 'id_ed25519',
345
+ 'authorized_keys',
346
+ 'known_hosts',
347
+ '.npmrc',
348
+ '.pypirc',
349
+ '.netrc',
350
+ '_netrc',
351
+ 'auth.json',
352
+ 'google_credentials.json',
353
+ ]);
354
+ /** 命中即拒写的扩展名(私钥/证书/密钥库)。 */
355
+ const CREDENTIAL_EXTENSIONS = ['.pem', '.key', '.pfx', '.p12', '.ppk', '.kdbx', '.keystore', '.jks', '.p8'];
356
+ /** dsc 自己家目录下的控制文件:它们决定沙箱与审批怎么跑,模型不该能写。 */
357
+ const DSC_CONTROL_FILES = new Set(['config.yaml', 'config.yml', 'credentials.yaml', 'credentials.yml', 'policy.rules', 'plugins.json']);
358
+ /** `.env` 家族(`.env.production` 这类都算);`.env.example` 一类模板放行。 */
359
+ function isEnvFamily(name) {
360
+ const base = name.toLowerCase();
361
+ return base.startsWith('.env') && !base.includes('example') && !base.includes('sample') && !base.includes('template');
362
+ }
363
+ /** 路径按比较口径归一:Windows 下大小写不敏感,分隔符统一成 `\`。 */
364
+ function compareKey(path, win32) {
365
+ const unified = path.replace(/[\\/]+/g, '\\');
366
+ return win32 ? unified.toLowerCase() : unified;
367
+ }
368
+ /**
369
+ * 这个路径是不是「即使在可写根内也拒写」的受保护名。
370
+ *
371
+ * 覆盖范围比规格列的多两处,都是有理由的补充:
372
+ * - `.git` **整棵树**(不只是 hooks/config/objects):`.git/config` 里放 core.hooksPath、
373
+ * `git` 自己写 `index`/`refs`,任何一处被改都能让「读一下仓库」变成执行任意代码;
374
+ * - `~/.dsc` 下的 `plugins.json` 与 `policy.rules`:它们分别是插件配置与命令规则,
375
+ * 能写这两个文件就能把沙箱自己关掉(config.yaml 与 credentials.yaml 在规格里已列)。
376
+ */
377
+ export function protectedWriteReason(absPath, dscHome, win32) {
378
+ const segments = compareKey(absPath, win32).split('\\').filter((segment) => segment !== '');
379
+ const name = basename(absPath);
380
+ const lowered = name.toLowerCase();
381
+ if (segments.includes('.git')) {
382
+ return 'Git 元数据目录(hooks/config/objects 都在里面):改它等于让之后的 git 命令随时执行你的代码';
383
+ }
384
+ if (segments.includes('.ssh'))
385
+ return 'SSH 凭据目录(私钥与 known_hosts)';
386
+ if (isEnvFamily(lowered)) {
387
+ return `${name} 是环境变量密钥文件(.env 家族;.env.example 一类模板除外)`;
388
+ }
389
+ if (CREDENTIAL_BASENAMES.has(lowered))
390
+ return `${name} 是凭据/私钥文件`;
391
+ if (CREDENTIAL_EXTENSIONS.some((ext) => lowered.endsWith(ext)))
392
+ return `${name} 是密钥/证书类文件`;
393
+ if (lowered === 'credentials.json' || lowered === 'secrets.yaml' || lowered === 'secrets.yml') {
394
+ return `${name} 是凭据文件`;
395
+ }
396
+ const home = compareKey(stripTrailingSep(dscHome), win32);
397
+ if (compareKey(absPath, win32).startsWith(`${home}\\`) && DSC_CONTROL_FILES.has(lowered)) {
398
+ return `dsc 自己的配置(${name}):改它等于改沙箱与审批自己的规则`;
399
+ }
400
+ return null;
401
+ }
402
+ /** 组一份策略快照。规范化失败的附加根会被丢掉并记进 `problems`。 */
403
+ export function createPolicy(input) {
404
+ const win32 = input.win32 ?? process.platform === 'win32';
405
+ const problems = [];
406
+ const opts = { win32, cwd: input.cwd };
407
+ const cwdPath = canonicalizePath(input.cwd, opts);
408
+ if (!cwdPath.ok)
409
+ problems.push(`工作目录用不了,本次一律不放行写:${cwdPath.reason ?? ''}`);
410
+ const cwd = cwdPath.ok ? cwdPath.path : resolve(input.cwd);
411
+ const tmpPath = canonicalizePath(input.tmpDir, opts);
412
+ const tmpDir = tmpPath.ok ? tmpPath.path : resolve(input.tmpDir);
413
+ const candidate = [cwd, tmpDir];
414
+ for (const raw of input.extraWritableRoots) {
415
+ const value = raw.trim();
416
+ if (value === '')
417
+ continue;
418
+ const one = canonicalizePath(value, { win32, cwd });
419
+ if (!one.ok) {
420
+ problems.push(`附加可写根「${raw}」用不了,已忽略:${one.reason ?? ''}`);
421
+ continue;
422
+ }
423
+ candidate.push(one.path);
424
+ }
425
+ const readOnlySubpaths = [];
426
+ for (const raw of input.readOnlySubpaths) {
427
+ const value = raw.trim();
428
+ if (value === '')
429
+ continue;
430
+ const one = canonicalizePath(value, { win32, cwd });
431
+ if (!one.ok) {
432
+ problems.push(`只读子路径「${raw}」用不了,已忽略:${one.reason ?? ''}`);
433
+ continue;
434
+ }
435
+ readOnlySubpaths.push(one.path);
436
+ }
437
+ return {
438
+ mode: input.mode,
439
+ win32,
440
+ cwd,
441
+ tmpDir,
442
+ dscHome: input.dscHome,
443
+ networkAccess: input.networkAccess,
444
+ // read-only 档没有可写根:判定的第一道就把它拦下,理由也更直白。
445
+ // danger-full-access 档保留候选根,只为显示与诊断——真正判定在 checkWrite 里直接放行。
446
+ roots: input.mode === 'read-only' ? [] : candidate,
447
+ candidateRoots: candidate,
448
+ readOnlySubpaths,
449
+ problems,
450
+ };
451
+ }
452
+ /** 目标是否落在某个根之内(Windows 下大小写不敏感,UNC 与盘符都按同一套算)。 */
453
+ export function insideRoot(child, root, win32) {
454
+ const a = win32 ? stripTrailingSep(root).toLowerCase() : stripTrailingSep(root);
455
+ const b = win32 ? stripTrailingSep(child).toLowerCase() : stripTrailingSep(child);
456
+ if (a === b)
457
+ return true;
458
+ const rel = relative(a, b);
459
+ if (rel === '')
460
+ return true;
461
+ // 跨盘符时 relative 会返回绝对路径;`..` 开头就是在外面
462
+ return !isAbsolute(rel) && !rel.startsWith('..');
463
+ }
464
+ /** 「怎么合法地做」的一句人话:拒因最后带上它,模型才有自救路径。 */
465
+ export function legalWay(rule) {
466
+ switch (rule) {
467
+ case 'outside-writable-roots':
468
+ return '把目标改到可写根内,或在「设置 → 沙箱」里把这个目录加进附加可写根;确实必须写到范围外时,在这一次调用里同时带上 sandbox_permissions 与 justification 重试(会照常弹审批卡让人点)';
469
+ case 'protected-metadata':
470
+ return '这类文件即便落在可写根内也拒写;确需改动请让用户手工执行,或换一个不受保护的路径';
471
+ case 'mode-read-only':
472
+ return '当前档位禁止一切写盘:在「设置 → 沙箱」把档位切到 workspace-write(工作区可写)或 danger-full-access,或改做只读的动作';
473
+ case 'read-only-subpath':
474
+ return '这条子路径被用户在「设置 → 沙箱」的只读清单里标了只读:改到别的路径,或请用户把它从清单里去掉';
475
+ case 'nt-namespace':
476
+ return '改用普通绝对路径(例如 C:\\Users\\me\\proj\\a.txt),不要带 \\\\?\\、\\\\.\\、\\??\\ 或 GLOBALROOT';
477
+ case 'ads-stream':
478
+ return '去掉文件名里的冒号:NTFS 备选数据流写不了,普通文件名照常';
479
+ case 'short-name':
480
+ return '把这个目标先建出来(或让用户确认它的长期名),再用完整的长名路径写一次';
481
+ case 'unresolvable':
482
+ return '先确认这个路径的父目录存在且当前用户有权访问,再用绝对路径写一次';
483
+ default:
484
+ return '换一个落在可写根内的目标';
485
+ }
486
+ }
487
+ /**
488
+ * 判一个路径能不能写。
489
+ *
490
+ * 顺序是刻意的:形状守卫 → 档位(不设围栏就直接放行)→ 受保护名 → 档位(只读)→
491
+ * 只读子路径 → 可写根归属。
492
+ * 形状守卫(NT 命名空间、ADS)排在档位之前:它们防的是「解析这个字符串」这件事本身的
493
+ * 副作用(SMB 认证泄漏、真实落点不是看到的那个文件),与档位无关。
494
+ * 受保护名放在只读判定之前,是为了让「为什么拒」一次说到最具体的那层;
495
+ * 只读档放在归属之前,是为了给出「档位不许写」这句话,而不是含糊的「不在可写根内」
496
+ * (那一档根本没有可写根)。
497
+ */
498
+ export function checkWrite(policy, raw) {
499
+ const nt = ntNamespaceReason(raw);
500
+ if (nt !== null)
501
+ return { allowed: false, rule: 'nt-namespace', reason: nt, resolved: raw };
502
+ const ads = adsStreamReason(raw, policy.win32);
503
+ if (ads !== null)
504
+ return { allowed: false, rule: 'ads-stream', reason: ads, resolved: raw };
505
+ const canon = canonicalizePath(raw, { win32: policy.win32, cwd: policy.cwd });
506
+ if (!canon.ok) {
507
+ return {
508
+ allowed: false,
509
+ rule: canon.rule === 'short-name' ? 'short-name' : 'unresolvable',
510
+ reason: canon.reason ?? '路径无法解析,保守拒绝',
511
+ resolved: canon.path,
512
+ };
513
+ }
514
+ const abs = canon.path;
515
+ if (policy.mode === 'danger-full-access') {
516
+ return { allowed: true, rule: 'allowed', reason: `档位 danger-full-access:沙箱不设围栏 → ${abs}`, resolved: abs };
517
+ }
518
+ const protectedWhy = protectedWriteReason(abs, policy.dscHome, policy.win32);
519
+ if (protectedWhy !== null)
520
+ return { allowed: false, rule: 'protected-metadata', reason: protectedWhy, resolved: abs };
521
+ if (policy.mode === 'read-only') {
522
+ return {
523
+ allowed: false,
524
+ rule: 'mode-read-only',
525
+ reason: `当前档位是 read-only(只读):只允许读,任何写盘都拒 → ${abs}`,
526
+ resolved: abs,
527
+ };
528
+ }
529
+ const readonly = policy.readOnlySubpaths.find((sub) => insideRoot(abs, sub, policy.win32));
530
+ if (readonly !== undefined) {
531
+ return {
532
+ allowed: false,
533
+ rule: 'read-only-subpath',
534
+ reason: `${readonly} 在只读清单里(可写根内的例外) → ${abs}`,
535
+ resolved: abs,
536
+ };
537
+ }
538
+ const root = policy.roots.find((one) => insideRoot(abs, one, policy.win32));
539
+ if (root === undefined) {
540
+ const list = policy.roots.length === 0 ? '(无)' : policy.roots.join('、');
541
+ return {
542
+ allowed: false,
543
+ rule: 'outside-writable-roots',
544
+ reason: `${abs} 不在任何可写根之内。可写根:${list}`,
545
+ resolved: abs,
546
+ };
547
+ }
548
+ return { allowed: true, rule: 'allowed', reason: `${abs} 落在可写根 ${root} 内`, resolved: abs, root };
549
+ }
550
+ /** 策略的一句话摘要(`SandboxService.describe()` 与设置页共用)。 */
551
+ export function describePolicy(policy) {
552
+ const roots = policy.mode === 'danger-full-access'
553
+ ? '围栏关闭(不限制)'
554
+ : policy.roots.length === 0
555
+ ? '(无,只读档不许写盘)'
556
+ : policy.roots.join('、');
557
+ const readonly = policy.readOnlySubpaths.length === 0 ? '(无)' : policy.readOnlySubpaths.join('、');
558
+ return `档位 ${policy.mode};可写根:${roots};只读子路径:${readonly};网络:${policy.networkAccess ? '开' : '关'}`;
559
+ }