@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,35 @@
1
+ import { type BoundWin32 } from './ffi.js';
2
+ /** SID 串 → SID 字节副本(我们自己的 Buffer,地址可取、GC 可持)。 */
3
+ export declare function sidStringToBuffer(bound: BoundWin32, sid: string): Buffer;
4
+ /** Well-known SID → 字节副本(Everyone / 低完整性标签)。 */
5
+ export declare function wellKnownSidBuffer(bound: BoundWin32, kind: number): Buffer;
6
+ /** 单条 EXPLICIT_ACCESS_W(48 字节,偏移见 abi.EA_OFFSETS;SID 形式的 trustee)。 */
7
+ export declare function packExplicitAccessSid(bound: BoundWin32, options: {
8
+ mask: number;
9
+ mode: number;
10
+ inheritance: number;
11
+ sid: Buffer;
12
+ }): Buffer;
13
+ /** 构造入参:模式 + 已授权可写根的能力 SID(与 ACL 授权一一对应)。 */
14
+ export interface RestrictedTokenInput {
15
+ mode: 'read-only' | 'workspace-write';
16
+ /** 可写根(工作区/附加根/私用临时目录)的能力 SID 串;read-only 模式给空数组。 */
17
+ rootSids: readonly string[];
18
+ /**
19
+ * 基底令牌(网络第二级账号分支用):runner 已经 LogonUserW 拿到的专用账号令牌。
20
+ * 给了它就不再开「当前进程令牌」,受限化在账号令牌上做——pass-1 用账号的
21
+ * 普通权限(工作区靠账号 ACE),pass-2 照旧走能力 SID 交集。收尾时会连它一起关。
22
+ */
23
+ accountToken?: number;
24
+ }
25
+ export interface RestrictedToken {
26
+ /** 传给 CreateProcessAsUserW 的新令牌句柄(uintptr_t 数值)。 */
27
+ readonly handle: number;
28
+ /** 收尾:关受限令牌、原令牌与进程句柄。spawn 完成后必须调。 */
29
+ dispose(): void;
30
+ }
31
+ /**
32
+ * 建一把受限令牌。全程 fail-closed:任何一步失败都抛错,
33
+ * 调用方(runner)绝不回落成「未受限 spawn」。
34
+ */
35
+ export declare function buildRestrictedToken(bound: BoundWin32, input: RestrictedTokenInput): RestrictedToken;
@@ -0,0 +1,238 @@
1
+ /**
2
+ * 受限令牌构造:从 dsc 自己的进程令牌派生一把「写受限」令牌。
3
+ *
4
+ * 机制照 dsh `sandbox-windows-acl`(2026-08-08 设计笔记):
5
+ * - `CreateRestrictedToken(DISABLE_MAX_PRIVILEGE|LUA_TOKEN|WRITE_RESTRICTED)`,
6
+ * 禁用 SID 列表与删权限列表都为空——前两个标志已经合成「受限用户」效果;
7
+ * - restricting 列表 = [logon SID, Everyone, …可写根 SID]。
8
+ * **保活组 logon+Everyone 不能省**:CNG 密钥隔离文件与每登录会话的目录
9
+ * 只授给登录会话 SID,缺了它们 DLL 初始化直接 0xC0000142(pwsh 则 0xE0434352);
10
+ * - 完整性降到 Low(S-1-16-4096)。Untrusted 实测起不来 pwsh(BCrypt 0x8007045A),不用;
11
+ * - 顺手把新令牌的**默认 DACL** 塞一条能力 SID 的 FILE_ALL_ACCESS ACE:
12
+ * 沙箱进程自己建匿名管道时 pass-2 交集检查要过这条,否则孙进程 stdio 全断。
13
+ *
14
+ * 刻意**不进** restricting 列表的 SID(dsh 实测结论):Authenticated Users
15
+ * (WMI 0x80041003 且关掉 C:\ 根建树逃逸)、INTERACTIVE/LOCAL(Public 树可写)、
16
+ * S-1-2-1(同前)。
17
+ *
18
+ * WRITE_RESTRICTED 的语义边界(要背下来):pass-2 交集**只对写生效**——
19
+ * 读、网络、进程可见性跟普通用户一样,这不是 bug 是设计(读限制要换专用账号,
20
+ * 属提权 setup 那一层的事)。
21
+ *
22
+ * 句柄口径:全模块句柄都是 uintptr_t 数值(见 ffi.ts 文件头),Buffer 入参由
23
+ * koffi 取地址;被嵌进结构体的 Buffer 必须在调用期间被本模块的局部变量持有(防 GC)。
24
+ *
25
+ * @module dsc/core/sandbox/win/token
26
+ */
27
+ import { CREATE_RESTRICTED_FLAGS, FILE_ALL_ACCESS, GRANT_ACCESS, PROCESS_QUERY_INFORMATION, SE_GROUP_INTEGRITY, SE_GROUP_LOGON_ID, SID_AND_ATTRIBUTES_SIZE, SID_MAX_BYTES, TokenDefaultDacl, TokenGroups, TokenIntegrityLevel, TOKEN_ACCESS, WinLowLabelSid, WinWorldSid, EA_OFFSETS, TRUSTEE_IS_SID, TRUSTEE_IS_UNKNOWN, } from './abi.js';
28
+ import { slotUintPtr, slotUint32, byteArea, addressOf, readMemory, throwLastError, throwWin32 } from './ffi.js';
29
+ /** SID 串 → SID 字节副本(我们自己的 Buffer,地址可取、GC 可持)。 */
30
+ export function sidStringToBuffer(bound, sid) {
31
+ // str16 以 NUL 收尾:多留 2 字节写终止符
32
+ const name = Buffer.alloc(sid.length * 2 + 2);
33
+ name.write(sid, 0, 'utf16le');
34
+ const out = slotUintPtr(bound);
35
+ if (Number(bound.convertStringSidToSidW(name, out.slot)) === 0)
36
+ throwLastError(bound, 'ConvertStringSidToSidW');
37
+ const raw = out.get();
38
+ try {
39
+ const length = Number(bound.getLengthSid(raw));
40
+ const area = byteArea(bound, length);
41
+ if (Number(bound.copySid(length, area.ptr, raw)) === 0)
42
+ throwLastError(bound, 'CopySid');
43
+ return Buffer.from(area.bytes());
44
+ }
45
+ finally {
46
+ bound.localFree(raw);
47
+ }
48
+ }
49
+ /** Well-known SID → 字节副本(Everyone / 低完整性标签)。 */
50
+ export function wellKnownSidBuffer(bound, kind) {
51
+ const buffer = Buffer.alloc(SID_MAX_BYTES);
52
+ // cbSid 是进出的 uint32:必须用真 Buffer 当 'void *'(API 的回写才能读回;
53
+ // byteArea().bytes() 是 decode 出来的副本,写它到不了原生内存,API 会读到 0 报 122)
54
+ const cbSid = Buffer.alloc(4);
55
+ cbSid.writeUInt32LE(SID_MAX_BYTES, 0);
56
+ if (Number(bound.createWellKnownSid(kind, 0, buffer, cbSid)) === 0)
57
+ throwLastError(bound, 'CreateWellKnownSid');
58
+ return buffer.subarray(0, cbSid.readUInt32LE(0));
59
+ }
60
+ /** 令牌组列表里把登录会话 SID 找出来(属性高位 = SE_GROUP_LOGON_ID)。 */
61
+ function logonSidBuffer(bound, token) {
62
+ const probe = slotUint32(bound);
63
+ bound.getTokenInformation(token, TokenGroups, null, 0, probe.slot); // 第一叫只探长度,返回 0 也正常
64
+ const needed = probe.get();
65
+ if (needed === 0)
66
+ throwLastError(bound, 'GetTokenInformation(TokenGroups 探长)');
67
+ const area = byteArea(bound, needed);
68
+ if (Number(bound.getTokenInformation(token, TokenGroups, area.ptr, needed, probe.slot)) === 0) {
69
+ throwLastError(bound, 'GetTokenInformation(TokenGroups)');
70
+ }
71
+ // 组条目里的 SID 指针指向 koffi 分配块内部:基址必须是**原**块的地址
72
+ const base = Number(bound.koffi.address(area.ptr));
73
+ // 用 Buffer 自带方法读(内部算上 byteOffset);new DataView(Buffer.from().buffer)
74
+ // 会从共享池原点看,小块 byteOffset≠0 直接读歪(实测 RangeError)
75
+ const bytes = Buffer.from(area.bytes());
76
+ const count = bytes.readUInt32LE(0);
77
+ for (let index = 0; index < count; index += 1) {
78
+ const entry = 8 + index * SID_AND_ATTRIBUTES_SIZE;
79
+ const attributes = bytes.readUInt32LE(entry + 8) >>> 0;
80
+ // JS 位运算两侧转 int32:0xC0000007 & 0xC0000000 = 负数,必须 >>> 0 归一后再比
81
+ const logonBits = (attributes & SE_GROUP_LOGON_ID) >>> 0;
82
+ if (logonBits !== SE_GROUP_LOGON_ID)
83
+ continue;
84
+ const offset = Number(bytes.readBigUInt64LE(entry)) - base;
85
+ if (offset < 0 || offset >= needed)
86
+ continue;
87
+ const subAuthorityCount = bytes[offset + 1];
88
+ const length = 8 + subAuthorityCount * 4;
89
+ if (offset + length > needed)
90
+ continue;
91
+ return Buffer.from(area.bytes().subarray(offset, offset + length));
92
+ }
93
+ throw new Error('令牌组里找不到登录会话 SID(SE_GROUP_LOGON_ID):没有保活组就没法构造受限令牌');
94
+ }
95
+ /** 往手工打包的缓冲区里写一个无符号 64 位指针。 */
96
+ function putU64(buffer, offset, value) {
97
+ buffer.writeBigUInt64LE(BigInt(value), offset);
98
+ }
99
+ /** SID_AND_ATTRIBUTES 数组打包(16 字节步进,Attributes=0)。 */
100
+ function packRestrictingSids(bound, sidBuffers) {
101
+ const packed = Buffer.alloc(SID_AND_ATTRIBUTES_SIZE * sidBuffers.length);
102
+ for (let index = 0; index < sidBuffers.length; index += 1) {
103
+ putU64(packed, index * SID_AND_ATTRIBUTES_SIZE, addressOf(bound, sidBuffers[index]));
104
+ // Attributes 保持 0:受限 SID 不带 SE_GROUP 标志
105
+ }
106
+ return packed;
107
+ }
108
+ /** TOKEN_MANDATORY_LABEL 载荷:{ Sid 指针, SE_GROUP_INTEGRITY }。 */
109
+ function packIntegrityLabel(bound, lowSid) {
110
+ const payload = Buffer.alloc(8 + lowSid.length);
111
+ putU64(payload, 0, addressOf(bound, lowSid));
112
+ payload.writeUInt32LE(SE_GROUP_INTEGRITY, 8);
113
+ return payload;
114
+ }
115
+ /** 单条 EXPLICIT_ACCESS_W(48 字节,偏移见 abi.EA_OFFSETS;SID 形式的 trustee)。 */
116
+ export function packExplicitAccessSid(bound, options) {
117
+ const entry = Buffer.alloc(48);
118
+ entry.writeUInt32LE(options.mask >>> 0, EA_OFFSETS.grfAccessPermissions);
119
+ entry.writeUInt32LE(options.mode, EA_OFFSETS.grfAccessMode);
120
+ entry.writeUInt32LE(options.inheritance, EA_OFFSETS.grfInheritance);
121
+ // pMultipleTrustee=NULL、MultipleTrusteeOperation=NO_MULTIPLE_TRUSTEE(0)
122
+ entry.writeUInt32LE(TRUSTEE_IS_SID, EA_OFFSETS.TrusteeForm);
123
+ entry.writeUInt32LE(TRUSTEE_IS_UNKNOWN, EA_OFFSETS.TrusteeType);
124
+ putU64(entry, EA_OFFSETS.ptstrName, addressOf(bound, options.sid));
125
+ return entry;
126
+ }
127
+ /**
128
+ * 建一把受限令牌。全程 fail-closed:任何一步失败都抛错,
129
+ * 调用方(runner)绝不回落成「未受限 spawn」。
130
+ */
131
+ export function buildRestrictedToken(bound, input) {
132
+ // 1. 基底令牌:账号分支用 LogonUserW 拿到的令牌;默认分支开自己进程的令牌
133
+ // (koffi 拿不到伪句柄地址,老实 OpenProcess)
134
+ let processHandle = 0;
135
+ let token;
136
+ if (input.accountToken !== undefined) {
137
+ token = input.accountToken;
138
+ }
139
+ else {
140
+ processHandle = Number(bound.openProcess(PROCESS_QUERY_INFORMATION, 0, process.pid));
141
+ if (processHandle === 0)
142
+ throwLastError(bound, 'OpenProcess');
143
+ const tokenSlot = slotUintPtr(bound);
144
+ if (Number(bound.openProcessToken(processHandle, TOKEN_ACCESS, tokenSlot.slot)) === 0) {
145
+ throwLastError(bound, 'OpenProcessToken');
146
+ }
147
+ token = tokenSlot.get();
148
+ }
149
+ // 2. 保活组与能力组(顺序照 dsh:保活组在前)
150
+ const logon = logonSidBuffer(bound, token);
151
+ const everyone = wellKnownSidBuffer(bound, WinWorldSid);
152
+ const low = wellKnownSidBuffer(bound, WinLowLabelSid);
153
+ const capabilityBuffers = [];
154
+ if (input.mode === 'workspace-write') {
155
+ for (const sid of input.rootSids)
156
+ capabilityBuffers.push(sidStringToBuffer(bound, sid));
157
+ }
158
+ const restricting = [logon, everyone, ...capabilityBuffers];
159
+ const packed = packRestrictingSids(bound, restricting);
160
+ // 3. CreateRestrictedToken(disable/delete 两组刻意为空)
161
+ const newTokenSlot = slotUintPtr(bound);
162
+ const created = Number(bound.createRestrictedToken(token, CREATE_RESTRICTED_FLAGS, 0, 0, // 不禁用任何 SID
163
+ 0, 0, // 不删任何特权(DISABLE_MAX_PRIVILEGE 已等效)
164
+ restricting.length, packed, newTokenSlot.slot));
165
+ if (created === 0)
166
+ throwLastError(bound, 'CreateRestrictedToken');
167
+ const restricted = newTokenSlot.get();
168
+ // 4. 完整性 → Low
169
+ const labelPayload = packIntegrityLabel(bound, low);
170
+ if (Number(bound.setTokenInformation(restricted, TokenIntegrityLevel, labelPayload, labelPayload.length)) === 0) {
171
+ throwLastError(bound, 'SetTokenInformation(TokenIntegrityLevel)');
172
+ }
173
+ // 5. 默认 DACL 补一条能力 SID 全权 ACE(没有能力 SID 就用 Everyone:至少让管道建得出来)
174
+ patchDefaultDacl(bound, restricted, capabilityBuffers[0] ?? everyone);
175
+ return {
176
+ handle: restricted,
177
+ dispose() {
178
+ try {
179
+ bound.closeHandle(restricted);
180
+ }
181
+ catch { /* 收尾失败不遮真实结果 */ }
182
+ try {
183
+ bound.closeHandle(token);
184
+ }
185
+ catch { /* 同上 */ }
186
+ if (processHandle !== 0) {
187
+ try {
188
+ bound.closeHandle(processHandle);
189
+ }
190
+ catch { /* 同上(账号分支没开进程句柄,跳过) */ }
191
+ }
192
+ },
193
+ };
194
+ }
195
+ /**
196
+ * 把**受限令牌**的默认 DACL 换成「原 ACL + 能力 SID 全权 ACE」。
197
+ *
198
+ * 为什么 trustee 选能力 SID 而不是 Everyone:默认 DACL 决定沙箱进程**新建对象**
199
+ * 的落点,授 Everyone 等于把「pass-2 只认能力 SID」这道墙自己拆了;授能力 SID
200
+ * 则只有打算进本沙箱的孙进程能对上新 ACL,外部进程照旧拿不到。
201
+ */
202
+ function patchDefaultDacl(bound, restricted, capability) {
203
+ const probe = slotUint32(bound);
204
+ bound.getTokenInformation(restricted, TokenDefaultDacl, null, 0, probe.slot);
205
+ const needed = probe.get();
206
+ if (needed === 0)
207
+ throwLastError(bound, 'GetTokenInformation(TokenDefaultDacl 探长)');
208
+ const area = byteArea(bound, needed);
209
+ if (Number(bound.getTokenInformation(restricted, TokenDefaultDacl, area.ptr, needed, probe.slot)) === 0) {
210
+ throwLastError(bound, 'GetTokenInformation(TokenDefaultDacl)');
211
+ }
212
+ // 载荷 = TOKEN_DEFAULT_DACL { PACL }:可能为 NULL(空 DACL),NULL 时让
213
+ // SetEntriesInAclW 从零建(oldAcl 传 0)
214
+ const aclPointer = Number(Buffer.from(area.bytes()).readBigUInt64LE(0));
215
+ let oldAclPointer = 0;
216
+ if (aclPointer !== 0) {
217
+ const header = readMemory(bound, aclPointer, 8);
218
+ const size = header[2] | (header[3] << 8);
219
+ if (size < 8)
220
+ throw new Error('令牌默认 DACL 的 ACL 头尺寸不合法');
221
+ // oldAcl 直接把系统指针传回去(同一进程内存,Koffi 分配块活着就有效)
222
+ oldAclPointer = aclPointer;
223
+ void readMemory(bound, aclPointer, size);
224
+ }
225
+ const entry = packExplicitAccessSid(bound, { mask: FILE_ALL_ACCESS, mode: GRANT_ACCESS, inheritance: 0, sid: capability });
226
+ const newAclSlot = slotUintPtr(bound);
227
+ const code = Number(bound.setEntriesInAclW(1, entry, oldAclPointer, newAclSlot.slot));
228
+ if (code !== 0)
229
+ throwWin32(bound, 'SetEntriesInAclW(默认 DACL)', code);
230
+ // SetTokenInformation 要「指向 PACL 的指针」:把新 ACL 的数值地址打进 8 字节
231
+ const pointerBox = Buffer.alloc(8);
232
+ pointerBox.writeBigUInt64LE(BigInt(newAclSlot.get()), 0);
233
+ if (Number(bound.setTokenInformation(restricted, TokenDefaultDacl, pointerBox, 8)) === 0) {
234
+ throwLastError(bound, 'SetTokenInformation(TokenDefaultDacl)');
235
+ }
236
+ // 刻意不 LocalFree 新 ACL:令牌内核侧持有它的引用窗口(runner 是短命进程,
237
+ // 泄漏几百字节换掉一类 use-after-free,值)
238
+ }
@@ -0,0 +1,41 @@
1
+ /**
2
+ * WFP **只读探测**:koffi 绑 fwpuclnt.dll,查 dsc 的持久 sublayer 在不在。
3
+ *
4
+ * 这一层刻意只读、只免提权:装 filter 要走提权 PowerShell(见 setup.ts),
5
+ * 平时(doctor)只想知道「布防还在不在」,所以只用 FwpmEngineOpen0 + FwpmSubLayerGetByKey0
6
+ * 两个调用,任何一个都不抛异常——探测失败也要变成一句能读的 detail。
7
+ *
8
+ * 本机实测(非提权会话,很重要,决定了 detail 的写法):
9
+ * - `FwpmEngineOpen0` 在标准用户下**能**成功(返回 0);
10
+ * - 但标准用户会话**看不到任何内置 WFP 对象**:查内置层
11
+ * FWPM_LAYER_ALE_AUTH_CONNECT_V4 返回 FWP_E_LAYER_NOT_FOUND(0x80320004),
12
+ * 查一个不存在的子层返回 FWP_E_SUBLAYER_NOT_FOUND(0x80320007);
13
+ * - `netsh wfp show state` 同样直接拒绝(ERROR_ACCESS_DENIED,要求提权)。
14
+ * 所以「查不到子层」非提权时**不等于**「没布防」。这里的做法是再查一次内置层当哨兵:
15
+ * 哨兵也查不到 → 老实说结论不可信;哨兵查得到 → 结论才可信。
16
+ *
17
+ * API 签名(注意与题面口径的差异):`FwpmSubLayerGetByKey0` 是三个参数
18
+ * `(engine, const GUID *key, FWPM_SUBLAYER0 **out)`,没有第四个参数,本文件按真实签名绑。
19
+ *
20
+ * @module dsc/core/sandbox/win/wfp
21
+ */
22
+ /** 探测结论:`present` 只说「查到了没有」,`detail` 说清楚「这个结论可不可信」。 */
23
+ export interface WfpProbeResult {
24
+ readonly present: boolean;
25
+ readonly detail: string;
26
+ }
27
+ /**
28
+ * 把 `xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx` 写成 16 字节的 Windows GUID 内存布局:
29
+ * Data1 小端 4 字节、Data2 小端 2 字节、Data3 小端 2 字节、Data4 原样 8 字节。
30
+ *
31
+ * 例:`c38d57d1-05a7-4c33-904f-7fbceee60e82` → `d1578dc3a705334c904f7fbceee60e82`。
32
+ * (WFP 的所有 key 都是这个二进制形态,写成大端字符串字节序会查不到任何东西。)
33
+ */
34
+ export declare function guidStringToBuffer(guid: string): Buffer;
35
+ /**
36
+ * 探测 dsc 的持久 WFP 子层在不在(免提权、只读、不抛)。
37
+ *
38
+ * 传 `sublayerGuid` 而不是写死常量,是为了让调用方拿 setup-state.json 里记录的那个 GUID 来查
39
+ * (万一以后要换命名空间,探测跟着状态文件走)。默认值就是 dsc 自己的子层。
40
+ */
41
+ export declare function probeWfpSublayer(sublayerGuid?: string): WfpProbeResult;
@@ -0,0 +1,200 @@
1
+ /**
2
+ * WFP **只读探测**:koffi 绑 fwpuclnt.dll,查 dsc 的持久 sublayer 在不在。
3
+ *
4
+ * 这一层刻意只读、只免提权:装 filter 要走提权 PowerShell(见 setup.ts),
5
+ * 平时(doctor)只想知道「布防还在不在」,所以只用 FwpmEngineOpen0 + FwpmSubLayerGetByKey0
6
+ * 两个调用,任何一个都不抛异常——探测失败也要变成一句能读的 detail。
7
+ *
8
+ * 本机实测(非提权会话,很重要,决定了 detail 的写法):
9
+ * - `FwpmEngineOpen0` 在标准用户下**能**成功(返回 0);
10
+ * - 但标准用户会话**看不到任何内置 WFP 对象**:查内置层
11
+ * FWPM_LAYER_ALE_AUTH_CONNECT_V4 返回 FWP_E_LAYER_NOT_FOUND(0x80320004),
12
+ * 查一个不存在的子层返回 FWP_E_SUBLAYER_NOT_FOUND(0x80320007);
13
+ * - `netsh wfp show state` 同样直接拒绝(ERROR_ACCESS_DENIED,要求提权)。
14
+ * 所以「查不到子层」非提权时**不等于**「没布防」。这里的做法是再查一次内置层当哨兵:
15
+ * 哨兵也查不到 → 老实说结论不可信;哨兵查得到 → 结论才可信。
16
+ *
17
+ * API 签名(注意与题面口径的差异):`FwpmSubLayerGetByKey0` 是三个参数
18
+ * `(engine, const GUID *key, FWPM_SUBLAYER0 **out)`,没有第四个参数,本文件按真实签名绑。
19
+ *
20
+ * @module dsc/core/sandbox/win/wfp
21
+ */
22
+ import { bindAll, loadFfi, slotUintPtr } from './ffi.js';
23
+ import { DSC_WFP_SUBLAYER_GUID, FWPM_LAYER_ALE_AUTH_CONNECT_V4, FWP_E_ALREADY_EXISTS, FWP_E_FILTER_NOT_FOUND, FWP_E_IN_USE, FWP_E_LAYER_NOT_FOUND, FWP_E_LOOKUP_MISSING, FWP_E_NOT_FOUND, FWP_E_PROVIDER_NOT_FOUND, FWP_E_SUBLAYER_NOT_FOUND, RPC_C_AUTHN_WINNT, } from './net-abi.js';
24
+ let cachedBindings = null;
25
+ /** 装载绑定;失败返回 `{ok:false}`(探测路径不抛)。 */
26
+ function loadWfpBindings() {
27
+ if (cachedBindings !== null)
28
+ return { ok: true, bindings: cachedBindings };
29
+ try {
30
+ const bound = bindAll(loadFfi());
31
+ const fw = bound.koffi.load('fwpuclnt.dll');
32
+ const bind = (name, result, args) => fw.func('__stdcall', name, result, args);
33
+ cachedBindings = {
34
+ bound,
35
+ // FwpmEngineOpen0(serverName, authnService, authIdentity, session, HANDLE *engine)
36
+ engineOpen: bind('FwpmEngineOpen0', 'uint32', ['void *', 'uint32', 'void *', 'void *', 'void *']),
37
+ engineClose: bind('FwpmEngineClose0', 'void', ['uintptr_t']),
38
+ // FwpmSubLayerGetByKey0(engine, const GUID *key, FWPM_SUBLAYER0 **out)
39
+ subLayerGetByKey: bind('FwpmSubLayerGetByKey0', 'uint32', ['uintptr_t', 'void *', 'void *']),
40
+ // FwpmLayerGetByKey0(engine, const GUID *key, FWPM_LAYER0 **out):只当可见性哨兵用
41
+ layerGetByKey: bind('FwpmLayerGetByKey0', 'uint32', ['uintptr_t', 'void *', 'void *']),
42
+ freeMemory: bind('FwpmFreeMemory0', 'void', ['void *']),
43
+ };
44
+ return { ok: true, bindings: cachedBindings };
45
+ }
46
+ catch (error) {
47
+ return { ok: false, why: `fwpuclnt.dll 绑定失败:${errorText(error)}` };
48
+ }
49
+ }
50
+ /**
51
+ * 把 `xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx` 写成 16 字节的 Windows GUID 内存布局:
52
+ * Data1 小端 4 字节、Data2 小端 2 字节、Data3 小端 2 字节、Data4 原样 8 字节。
53
+ *
54
+ * 例:`c38d57d1-05a7-4c33-904f-7fbceee60e82` → `d1578dc3a705334c904f7fbceee60e82`。
55
+ * (WFP 的所有 key 都是这个二进制形态,写成大端字符串字节序会查不到任何东西。)
56
+ */
57
+ export function guidStringToBuffer(guid) {
58
+ const match = /^\{?([0-9a-fA-F]{8})-([0-9a-fA-F]{4})-([0-9a-fA-F]{4})-([0-9a-fA-F]{4})-([0-9a-fA-F]{12})\}?$/.exec(guid.trim());
59
+ if (match === null)
60
+ throw new Error(`GUID 字面量不合法(期望 8-4-4-4-12):${JSON.stringify(guid)}`);
61
+ const [, data1, data2, data3, data4a, data4b] = match;
62
+ const buffer = Buffer.alloc(16);
63
+ buffer.writeUInt32LE(Number.parseInt(data1, 16), 0);
64
+ buffer.writeUInt16LE(Number.parseInt(data2, 16), 4);
65
+ buffer.writeUInt16LE(Number.parseInt(data3, 16), 6);
66
+ buffer.write(`${data4a}${data4b}`, 8, 'hex');
67
+ return buffer;
68
+ }
69
+ /**
70
+ * 探测 dsc 的持久 WFP 子层在不在(免提权、只读、不抛)。
71
+ *
72
+ * 传 `sublayerGuid` 而不是写死常量,是为了让调用方拿 setup-state.json 里记录的那个 GUID 来查
73
+ * (万一以后要换命名空间,探测跟着状态文件走)。默认值就是 dsc 自己的子层。
74
+ */
75
+ export function probeWfpSublayer(sublayerGuid = DSC_WFP_SUBLAYER_GUID) {
76
+ let key;
77
+ try {
78
+ key = guidStringToBuffer(sublayerGuid);
79
+ }
80
+ catch (error) {
81
+ return { present: false, detail: `子层 GUID 无法解析:${errorText(error)}` };
82
+ }
83
+ const loaded = loadWfpBindings();
84
+ if (!loaded.ok)
85
+ return { present: false, detail: `${loaded.why}(探测不了 WFP 子层)` };
86
+ const { bound, engineOpen, engineClose, subLayerGetByKey, layerGetByKey, freeMemory } = loaded.bindings;
87
+ const engineSlot = slotUintPtr(bound);
88
+ let engine = 0;
89
+ try {
90
+ const openCode = Number(engineOpen(null, RPC_C_AUTHN_WINNT, null, null, engineSlot.slot)) >>> 0;
91
+ if (openCode !== 0) {
92
+ return {
93
+ present: false,
94
+ detail: `FwpmEngineOpen0 失败(${describeCode(bound, openCode)}):本进程打不开 WFP 引擎,查不到子层`,
95
+ };
96
+ }
97
+ engine = engineSlot.get();
98
+ if (engine === 0) {
99
+ return { present: false, detail: 'FwpmEngineOpen0 报成功但给出空句柄:探测无法继续' };
100
+ }
101
+ const outSlot = slotUintPtr(bound);
102
+ const code = Number(subLayerGetByKey(engine, key, outSlot.slot)) >>> 0;
103
+ if (code === 0) {
104
+ freeMemory(outSlot.slot);
105
+ return { present: true, detail: `查到 GUID ${sublayerGuid} 的持久子层,二级 WFP 布防在位` };
106
+ }
107
+ if (FWP_E_LOOKUP_MISSING.includes(code)) {
108
+ if (wfpNamespaceVisible(bound, layerGetByKey, freeMemory, engine)) {
109
+ return {
110
+ present: false,
111
+ detail: `未查到 GUID ${sublayerGuid} 的子层(同会话能查到内置 WFP 层,结论可信):二级 WFP 未布防或已被清理`,
112
+ };
113
+ }
114
+ return {
115
+ present: false,
116
+ detail: `未查到 GUID ${sublayerGuid} 的子层;但本会话连内置 WFP 层都查不到` +
117
+ `(非提权会话看不到 WFP 对象,本机实测如此),这条结论不可信,请以 setup-state.json 与提权 setup 的汇总输出为准`,
118
+ };
119
+ }
120
+ return {
121
+ present: false,
122
+ detail: `FwpmSubLayerGetByKey0 返回 ${describeCode(bound, code)}(不是「不存在」,属探测失败,不代表未布防)`,
123
+ };
124
+ }
125
+ catch (error) {
126
+ return { present: false, detail: `WFP 探测过程出错:${errorText(error)}` };
127
+ }
128
+ finally {
129
+ if (engine !== 0) {
130
+ try {
131
+ engineClose(engine);
132
+ }
133
+ catch {
134
+ // 句柄关不掉不影响已经算出来的结论;强杀进程也会回收。
135
+ }
136
+ }
137
+ }
138
+ }
139
+ /**
140
+ * 可见性哨兵:查一个**必然存在**的内置层(ALE_AUTH_CONNECT_V4)。
141
+ * 查到 → 这个会话有 WFP 读权限,子层查不到就是真没有;查不到 → 没读权限,结论不可信。
142
+ */
143
+ function wfpNamespaceVisible(bound, layerGetByKey, freeMemory, engine) {
144
+ try {
145
+ const outSlot = slotUintPtr(bound);
146
+ const code = Number(layerGetByKey(engine, guidStringToBuffer(FWPM_LAYER_ALE_AUTH_CONNECT_V4), outSlot.slot)) >>> 0;
147
+ if (code === 0) {
148
+ freeMemory(outSlot.slot);
149
+ return true;
150
+ }
151
+ return false;
152
+ }
153
+ catch {
154
+ return false;
155
+ }
156
+ }
157
+ /** WFP 返回码的名字表(只收己方核实过的那些;Probe 路径不抛,所以不走 ffi 的抛错口)。 */
158
+ const FWP_ERROR_NAMES = {
159
+ [FWP_E_FILTER_NOT_FOUND]: 'FWP_E_FILTER_NOT_FOUND',
160
+ [FWP_E_LAYER_NOT_FOUND]: 'FWP_E_LAYER_NOT_FOUND',
161
+ [FWP_E_PROVIDER_NOT_FOUND]: 'FWP_E_PROVIDER_NOT_FOUND',
162
+ [FWP_E_SUBLAYER_NOT_FOUND]: 'FWP_E_SUBLAYER_NOT_FOUND',
163
+ [FWP_E_NOT_FOUND]: 'FWP_E_NOT_FOUND',
164
+ [FWP_E_ALREADY_EXISTS]: 'FWP_E_ALREADY_EXISTS',
165
+ [FWP_E_IN_USE]: 'FWP_E_IN_USE',
166
+ };
167
+ /**
168
+ * 把返回码写成「0x80320007(FWP_E_SUBLAYER_NOT_FOUND)」这种能直接读的形状。
169
+ * FWP_E_* 是 HRESULT,FormatMessageW 解不出文本;Win32 错误码(如拒绝访问)能解出来,
170
+ * 所以两边都试:名字表命中就带名字,系统消息拿得到就再带一句。
171
+ */
172
+ function describeCode(bound, code) {
173
+ const hex = `0x${code.toString(16).padStart(8, '0')}`;
174
+ const name = FWP_ERROR_NAMES[code];
175
+ const systemText = win32ErrorText(bound, code);
176
+ const parts = [hex];
177
+ if (name !== undefined)
178
+ parts.push(name);
179
+ if (systemText !== '')
180
+ parts.push(systemText);
181
+ return parts.join(',');
182
+ }
183
+ /** 系统错误文本(拿不到就空串)。ffi.ts 里那份是私有的,这里只重写这一小段,不改 ffi.ts。 */
184
+ function win32ErrorText(bound, code) {
185
+ try {
186
+ const buffer = bound.koffi.alloc('uint16', 512);
187
+ const written = Number(bound.formatMessageW(0x00001000, null, code, 0, buffer, 512, null));
188
+ if (written <= 0)
189
+ return '';
190
+ const bytes = new Uint8Array(bound.koffi.decode(buffer, 'uint8', written * 2));
191
+ return Buffer.from(bytes.buffer, bytes.byteOffset, bytes.byteLength).toString('utf16le').trim();
192
+ }
193
+ catch {
194
+ return '';
195
+ }
196
+ }
197
+ /** 异常转一句话。 */
198
+ function errorText(error) {
199
+ return error instanceof Error ? error.message : String(error);
200
+ }
@@ -0,0 +1,9 @@
1
+ /** 可写根(工作区 / 附加根)的能力 SID:`S-1-4-x-y`。 */
2
+ export declare function rootWriteSid(canonicalRoot: string): string;
3
+ /** 私有临时目录的能力 SID:`S-1-4-x-y-1`(固定尾授权做域分隔)。 */
4
+ export declare function tempWriteSid(canonicalTemp: string): string;
5
+ /**
6
+ * 自检用的反算:给定 SID 与路径,验证派生关系成立(runner 启动时校验 argv,
7
+ * 防「SID 与路径对不上号」的调用方 bug 变成静默错授权)。
8
+ */
9
+ export declare function verifySidForPath(sid: string, canonicalPath: string, kind: 'root' | 'temp'): boolean;
@@ -0,0 +1,45 @@
1
+ /**
2
+ * 可写根的能力 SID 派生:`S-1-4-x-y`。
3
+ *
4
+ * 机制照 dsh `sandbox-windows-acl/src/workspace-sid.ts`:把「规范路径」哈希成两个
5
+ * 30 位以内的子授权,得到一个**稳定且可复算**的假 SID。它的用途是当 restricting
6
+ * SID 与 ACE 的 trustee:可写根的 ACL 上授这个 SID,受限令牌的 restricting 列表里
7
+ * 放这个 SID,于是「令牌能不能写这个根」变成一条纯 ACL 判定,根外面则全部被
8
+ * pass-2 交集拦死。
9
+ *
10
+ * 两个纪律(照 dsh 的实测教训):
11
+ * 1. 输入必须是 `realpathSync.native` 规范化后的路径——大小写、8.3 短名、符号链接
12
+ * 拼法的差异会派生出**第二个身份**,等于沙箱凭空多一个可写根;
13
+ * 2. temp 根用独立的消息前缀 + 固定子授权 `-1`,保证它和工作区永不派生同一条 SID
14
+ * (temp 会在会话结束回收 ACE,工作区是常驻的,两者混用会把常驻授权漏进临时身份)。
15
+ *
16
+ * @module dsc/core/sandbox/win/workspace-sid
17
+ */
18
+ import { createHash } from 'node:crypto';
19
+ /** 授权值上限:2^30-1。取模后 +1,避免派生出 0(0 号授权在 S-1-4 里另有含义)。 */
20
+ const AUTHORITY_MODULUS = 2 ** 30 - 1;
21
+ /** sha256 → 前 8 字节按小端拆成两个授权。 */
22
+ function derive(digest) {
23
+ const x = digest.readUInt32LE(0) % AUTHORITY_MODULUS + 1;
24
+ const y = digest.readUInt32LE(4) % AUTHORITY_MODULUS + 1;
25
+ return { x, y };
26
+ }
27
+ /** 可写根(工作区 / 附加根)的能力 SID:`S-1-4-x-y`。 */
28
+ export function rootWriteSid(canonicalRoot) {
29
+ const digest = createHash('sha256').update(Buffer.from(canonicalRoot, 'utf8')).digest();
30
+ const { x, y } = derive(digest);
31
+ return `S-1-4-${String(x)}-${String(y)}`;
32
+ }
33
+ /** 私有临时目录的能力 SID:`S-1-4-x-y-1`(固定尾授权做域分隔)。 */
34
+ export function tempWriteSid(canonicalTemp) {
35
+ const digest = createHash('sha256').update(Buffer.concat([Buffer.from('temp\0', 'utf8'), Buffer.from(canonicalTemp, 'utf8')])).digest();
36
+ const { x, y } = derive(digest);
37
+ return `S-1-4-${String(x)}-${String(y)}-1`;
38
+ }
39
+ /**
40
+ * 自检用的反算:给定 SID 与路径,验证派生关系成立(runner 启动时校验 argv,
41
+ * 防「SID 与路径对不上号」的调用方 bug 变成静默错授权)。
42
+ */
43
+ export function verifySidForPath(sid, canonicalPath, kind) {
44
+ return sid === (kind === 'root' ? rootWriteSid(canonicalPath) : tempWriteSid(canonicalPath));
45
+ }