@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,161 @@
1
+ /**
2
+ * Win32 ABI 常量与 x64 结构体布局(全手工字节,不依赖 koffi 结构体)。
3
+ *
4
+ * 为什么手工打包:dsh 的同类实现实证过——koffi 的结构体对联合体/内联 SID 支持不牢,
5
+ * 且这些布局是一次性学完的固定知识。所有偏移按 x64 对齐,来源逐一注明;
6
+ * 移植到 ARM64 时必须重新核对(照 dsh 的 abi-probe.cpp 验法)。
7
+ *
8
+ * @module dsc/core/sandbox/win/abi
9
+ */
10
+ /** OpenProcessToken 要的权限:ASSIGN_PRIMARY|DUPLICATE|QUERY|ADJUST_DEFAULT。 */
11
+ export declare const TOKEN_ACCESS: number;
12
+ /** OpenProcess 要的权限:PROCESS_QUERY_INFORMATION。 */
13
+ export declare const PROCESS_QUERY_INFORMATION = 1024;
14
+ /** GetTokenInformation 信息类:组列表。 */
15
+ export declare const TokenGroups = 2;
16
+ /** GetTokenInformation 信息类:默认 DACL。 */
17
+ export declare const TokenDefaultDacl = 6;
18
+ /** GetTokenInformation 信息类:完整性级别。 */
19
+ export declare const TokenIntegrityLevel = 25;
20
+ /** CreateRestrictedToken 标志:禁用全部特权 + 合成受限用户 + 仅写受限(pass-2 只管写)。 */
21
+ export declare const CREATE_RESTRICTED_FLAGS: number;
22
+ /** 组属性:登录会话 SID 的标记(含 enabled/mandatory 位,比较时取高两位)。 */
23
+ export declare const SE_GROUP_LOGON_ID = 3221225472;
24
+ /** 强制标签 ACE 的属性位。 */
25
+ export declare const SE_GROUP_INTEGRITY = 32;
26
+ /** WellKnownSidType:Everyone(S-1-1-0)。 */
27
+ export declare const WinWorldSid = 1;
28
+ /** WellKnownSidType:低完整性标签(S-1-16-4096)。 */
29
+ export declare const WinLowLabelSid = 66;
30
+ /** SID 缓冲区的安全上限(最大 68 字节)。 */
31
+ export declare const SID_MAX_BYTES = 68;
32
+ /** SID_AND_ATTRIBUTES 在 x64 上的步长(指针 8 + uint32 4 + 补齐 4)。 */
33
+ export declare const SID_AND_ATTRIBUTES_SIZE = 16;
34
+ export declare const DELETE = 65536;
35
+ export declare const READ_CONTROL = 131072;
36
+ export declare const WRITE_DAC = 262144;
37
+ export declare const WRITE_OWNER = 524288;
38
+ /** FILE_GENERIC_WRITE(SYNCHRONIZE|READ_CONTROL|append|write_data|write_attr|write_ea)。 */
39
+ export declare const FILE_GENERIC_WRITE = 1179926;
40
+ /** FILE_GENERIC_READ(SYNCHRONIZE|READ_CONTROL|read_data|read_attr|read_ea)。 */
41
+ export declare const FILE_GENERIC_READ = 1179785;
42
+ /** FILE_GENERIC_EXECUTE(SYNCHRONIZE|READ_CONTROL|execute|read_attr|read_ea... 掩码 0x1200A0)。 */
43
+ export declare const FILE_GENERIC_EXECUTE = 1179808;
44
+ /** 目录上的「删除子项」位。 */
45
+ export declare const FILE_DELETE_CHILD = 64;
46
+ /** STANDARD_RIGHTS_WRITE = READ_CONTROL。 */
47
+ export declare const STANDARD_RIGHTS_WRITE = 131072;
48
+ /** STANDARD_RIGHTS_REQUIRED(DELETE|READ_CONTROL|WRITE_DAC|WRITE_OWNER|SYNCHRONIZE)。 */
49
+ export declare const STANDARD_RIGHTS_REQUIRED = 983040;
50
+ /** FILE_ALL_ACCESS(能力 SID 默认 DACL ACE 用)。 */
51
+ export declare const FILE_ALL_ACCESS: number;
52
+ /**
53
+ * 可写根授权掩码 = (FILE_GENERIC_WRITE|DELETE|FILE_DELETE_CHILD) & ~STANDARD_RIGHTS_WRITE。
54
+ *
55
+ * 三处刻意:带上 DELETE 与 FILE_DELETE_CHILD(沙箱里要能删自己创建的东西);
56
+ * 剥掉 READ_CONTROL(标准写本就带,剥掉避免与 deny 语义纠缠);
57
+ * 刻意**不带** WRITE_DAC/WRITE_OWNER——被沙箱的进程不许改 ACL 或夺所有权。
58
+ */
59
+ export declare const GRANT_MASK: number;
60
+ export declare const ACL_REVISION = 2;
61
+ /** ACE 类型:允许。 */
62
+ export declare const ACCESS_ALLOWED_ACE_TYPE = 0;
63
+ /** ACE 类型:拒绝。 */
64
+ export declare const ACCESS_DENIED_ACE_TYPE = 1;
65
+ /** ACE 类型:强制标签。 */
66
+ export declare const SYSTEM_MANDATORY_LABEL_ACE_TYPE = 17;
67
+ /** ACE 继承:子对象(文件)。 */
68
+ export declare const OBJECT_INHERIT_ACE = 1;
69
+ /** ACE 继承:子容器(目录)。 */
70
+ export declare const CONTAINER_INHERIT_ACE = 2;
71
+ /** 强制标签策略:低完整性不可写上来。 */
72
+ export declare const SYSTEM_MANDATORY_LABEL_NO_WRITE_UP = 1;
73
+ /** SECURITY_INFORMATION:DACL。 */
74
+ export declare const DACL_SECURITY_INFORMATION = 4;
75
+ /** SECURITY_INFORMATION:强制标签(SACL 的一部分)。 */
76
+ export declare const LABEL_SECURITY_INFORMATION = 16;
77
+ /** SetNamedSecurityInfoW / GetNamedSecurityInfoW 的对象类型:文件或目录。 */
78
+ export declare const SE_FILE_OBJECT = 1;
79
+ /** EXPLICIT_ACCESS 的模式。 */
80
+ export declare const GRANT_ACCESS = 2;
81
+ export declare const DENY_ACCESS = 3;
82
+ export declare const REVOKE_ACCESS = 4;
83
+ /** TrusteeForm:ptstrName 是 SID 字节。 */
84
+ export declare const TRUSTEE_IS_SID = 0;
85
+ /** TrusteeType:不指名类型。 */
86
+ export declare const TRUSTEE_IS_UNKNOWN = 0;
87
+ /** EXPLICIT_ACCESS_W 在 x64 上共 48 字节。 */
88
+ export declare const EXPLICIT_ACCESS_SIZE = 48;
89
+ /** EXPLICIT_ACCESS_W 字段偏移(x64 对齐;TRUSTEE 从 16 开始)。 */
90
+ export declare const EA_OFFSETS: {
91
+ readonly grfAccessPermissions: 0;
92
+ readonly grfAccessMode: 4;
93
+ readonly grfInheritance: 8;
94
+ readonly pMultipleTrustee: 16;
95
+ readonly MultipleTrusteeOperation: 24;
96
+ readonly TrusteeForm: 28;
97
+ readonly TrusteeType: 32;
98
+ readonly ptstrName: 40;
99
+ };
100
+ /** ACL 头里的 ACE 数量偏移(AclRevision@0, Sbz1@2, AclSize@2, AceCount@4)。 */
101
+ export declare const ACL_ACE_COUNT_OFFSET = 4;
102
+ /** 第一条 ACE 在 ACL 里的偏移。 */
103
+ export declare const ACL_FIRST_ACE_OFFSET = 8;
104
+ /** ACCESS_ALLOWED/DENIED_ACE 的掩码偏移(头 4 字节后)。 */
105
+ export declare const ACE_MASK_OFFSET = 4;
106
+ /** 各类 ACE 的内联 SID 偏移(头 4 + 掩码 4)。 */
107
+ export declare const ACE_SID_OFFSET = 8;
108
+ /** 挂起创建:先塞进 Job 再放行,杜绝「杀树前先跑起来」的窗口。 */
109
+ export declare const CREATE_SUSPENDED = 4;
110
+ export declare const STARTF_USESTDHANDLES = 256;
111
+ export declare const STARTF_USESHOWWINDOW = 1;
112
+ export declare const SW_HIDE = 0;
113
+ /**
114
+ * STARTUPINFOW 在 x64 上 104 字节(13 个 4 字节字段对齐到 8 后接三个句柄)。
115
+ * 注意 dwFlags 在 60 而不是 44——前三个指针字段把布局顶开了。
116
+ */
117
+ export declare const STARTUPINFOW_SIZE = 104;
118
+ export declare const SI_OFFSETS: {
119
+ readonly cb: 0;
120
+ readonly dwFlags: 60;
121
+ readonly wShowWindow: 64;
122
+ readonly hStdInput: 80;
123
+ readonly hStdOutput: 88;
124
+ readonly hStdError: 96;
125
+ };
126
+ /** PROCESS_INFORMATION 在 x64 上 24 字节。 */
127
+ export declare const PROCESS_INFORMATION_SIZE = 24;
128
+ export declare const PI_OFFSETS: {
129
+ readonly hProcess: 0;
130
+ readonly hThread: 8;
131
+ readonly dwProcessId: 16;
132
+ readonly dwThreadId: 20;
133
+ };
134
+ /** JobObjectExtendedLimitInformation 信息类。 */
135
+ export declare const JobObjectExtendedLimitInformation = 9;
136
+ /** 最后一个 Job 句柄关闭时终止全部成员:父进程死 = 子树死。 */
137
+ export declare const JOB_OBJECT_LIMIT_KILL_ON_JOB_CLOSE = 8192;
138
+ /** JOBOBJECT_EXTENDED_LIMIT_INFORMATION 在 x64 上 144 字节,LimitFlags 在 16。 */
139
+ export declare const JOBOBJECT_EXTENDED_LIMIT_SIZE = 144;
140
+ export declare const JOBOBJ_LIMIT_FLAGS_OFFSET = 16;
141
+ /** LogonUserW 的登录类型:交互式。 */
142
+ export declare const LOGON32_LOGON_INTERACTIVE = 2;
143
+ /** LogonUserW 的提供者:默认。 */
144
+ export declare const LOGON32_PROVIDER_DEFAULT = 0;
145
+ export declare const WAIT_OBJECT_0 = 0;
146
+ export declare const INFINITE = 4294967295;
147
+ export declare const ERROR_BROKEN_PIPE = 109;
148
+ export declare const ERROR_NO_DATA = 232;
149
+ export declare const ERROR_INVALID_PARAMETER = 87;
150
+ export declare const ERROR_ACCESS_DENIED = 5;
151
+ export declare const GENERIC_READ = 2147483648;
152
+ export declare const GENERIC_WRITE = 1073741824;
153
+ export declare const OPEN_ALWAYS = 4;
154
+ export declare const FILE_SHARE_READ = 1;
155
+ export declare const FILE_SHARE_WRITE = 2;
156
+ /** 刻意不带 FILE_SHARE_DELETE:防别人把锁文件换掉(照 dsh)。 */
157
+ export declare const FILE_ATTRIBUTE_NORMAL = 128;
158
+ export declare const LOCKFILE_FAIL_IMMEDIATELY = 1;
159
+ export declare const LOCKFILE_EXCLUSIVE_LOCK = 2;
160
+ /** LockFileEx 的 OVERLAPPED 在 x64 上 32 字节(koffi 3.1.1 传 NULL 会崩,给零块)。 */
161
+ export declare const OVERLAPPED_SIZE = 32;
@@ -0,0 +1,169 @@
1
+ /**
2
+ * Win32 ABI 常量与 x64 结构体布局(全手工字节,不依赖 koffi 结构体)。
3
+ *
4
+ * 为什么手工打包:dsh 的同类实现实证过——koffi 的结构体对联合体/内联 SID 支持不牢,
5
+ * 且这些布局是一次性学完的固定知识。所有偏移按 x64 对齐,来源逐一注明;
6
+ * 移植到 ARM64 时必须重新核对(照 dsh 的 abi-probe.cpp 验法)。
7
+ *
8
+ * @module dsc/core/sandbox/win/abi
9
+ */
10
+ // ── 令牌 ────────────────────────────────────────────────────────────────────
11
+ /** OpenProcessToken 要的权限:ASSIGN_PRIMARY|DUPLICATE|QUERY|ADJUST_DEFAULT。 */
12
+ export const TOKEN_ACCESS = 0x0001 | 0x0002 | 0x0008 | 0x0080;
13
+ /** OpenProcess 要的权限:PROCESS_QUERY_INFORMATION。 */
14
+ export const PROCESS_QUERY_INFORMATION = 0x0400;
15
+ /** GetTokenInformation 信息类:组列表。 */
16
+ export const TokenGroups = 2;
17
+ /** GetTokenInformation 信息类:默认 DACL。 */
18
+ export const TokenDefaultDacl = 6;
19
+ /** GetTokenInformation 信息类:完整性级别。 */
20
+ export const TokenIntegrityLevel = 25;
21
+ /** CreateRestrictedToken 标志:禁用全部特权 + 合成受限用户 + 仅写受限(pass-2 只管写)。 */
22
+ export const CREATE_RESTRICTED_FLAGS = 0x1 | 0x4 | 0x8;
23
+ /** 组属性:登录会话 SID 的标记(含 enabled/mandatory 位,比较时取高两位)。 */
24
+ export const SE_GROUP_LOGON_ID = 0xc0000000;
25
+ /** 强制标签 ACE 的属性位。 */
26
+ export const SE_GROUP_INTEGRITY = 0x20;
27
+ /** WellKnownSidType:Everyone(S-1-1-0)。 */
28
+ export const WinWorldSid = 1;
29
+ /** WellKnownSidType:低完整性标签(S-1-16-4096)。 */
30
+ export const WinLowLabelSid = 66;
31
+ /** SID 缓冲区的安全上限(最大 68 字节)。 */
32
+ export const SID_MAX_BYTES = 68;
33
+ /** SID_AND_ATTRIBUTES 在 x64 上的步长(指针 8 + uint32 4 + 补齐 4)。 */
34
+ export const SID_AND_ATTRIBUTES_SIZE = 16;
35
+ // ── 访问掩码 ────────────────────────────────────────────────────────────────
36
+ export const DELETE = 0x00010000;
37
+ export const READ_CONTROL = 0x00020000;
38
+ export const WRITE_DAC = 0x00040000;
39
+ export const WRITE_OWNER = 0x00080000;
40
+ /** FILE_GENERIC_WRITE(SYNCHRONIZE|READ_CONTROL|append|write_data|write_attr|write_ea)。 */
41
+ export const FILE_GENERIC_WRITE = 0x120116;
42
+ /** FILE_GENERIC_READ(SYNCHRONIZE|READ_CONTROL|read_data|read_attr|read_ea)。 */
43
+ export const FILE_GENERIC_READ = 0x120089;
44
+ /** FILE_GENERIC_EXECUTE(SYNCHRONIZE|READ_CONTROL|execute|read_attr|read_ea... 掩码 0x1200A0)。 */
45
+ export const FILE_GENERIC_EXECUTE = 0x1200a0;
46
+ /** 目录上的「删除子项」位。 */
47
+ export const FILE_DELETE_CHILD = 0x00000040;
48
+ /** STANDARD_RIGHTS_WRITE = READ_CONTROL。 */
49
+ export const STANDARD_RIGHTS_WRITE = READ_CONTROL;
50
+ /** STANDARD_RIGHTS_REQUIRED(DELETE|READ_CONTROL|WRITE_DAC|WRITE_OWNER|SYNCHRONIZE)。 */
51
+ export const STANDARD_RIGHTS_REQUIRED = 0x000f0000;
52
+ /** FILE_ALL_ACCESS(能力 SID 默认 DACL ACE 用)。 */
53
+ export const FILE_ALL_ACCESS = STANDARD_RIGHTS_REQUIRED | 0x1ff;
54
+ /**
55
+ * 可写根授权掩码 = (FILE_GENERIC_WRITE|DELETE|FILE_DELETE_CHILD) & ~STANDARD_RIGHTS_WRITE。
56
+ *
57
+ * 三处刻意:带上 DELETE 与 FILE_DELETE_CHILD(沙箱里要能删自己创建的东西);
58
+ * 剥掉 READ_CONTROL(标准写本就带,剥掉避免与 deny 语义纠缠);
59
+ * 刻意**不带** WRITE_DAC/WRITE_OWNER——被沙箱的进程不许改 ACL 或夺所有权。
60
+ */
61
+ export const GRANT_MASK = (FILE_GENERIC_WRITE | DELETE | FILE_DELETE_CHILD) & ~STANDARD_RIGHTS_WRITE;
62
+ // ── ACL / ACE ───────────────────────────────────────────────────────────────
63
+ export const ACL_REVISION = 2;
64
+ /** ACE 类型:允许。 */
65
+ export const ACCESS_ALLOWED_ACE_TYPE = 0x00;
66
+ /** ACE 类型:拒绝。 */
67
+ export const ACCESS_DENIED_ACE_TYPE = 0x01;
68
+ /** ACE 类型:强制标签。 */
69
+ export const SYSTEM_MANDATORY_LABEL_ACE_TYPE = 0x11;
70
+ /** ACE 继承:子对象(文件)。 */
71
+ export const OBJECT_INHERIT_ACE = 0x01;
72
+ /** ACE 继承:子容器(目录)。 */
73
+ export const CONTAINER_INHERIT_ACE = 0x02;
74
+ /** 强制标签策略:低完整性不可写上来。 */
75
+ export const SYSTEM_MANDATORY_LABEL_NO_WRITE_UP = 0x01;
76
+ /** SECURITY_INFORMATION:DACL。 */
77
+ export const DACL_SECURITY_INFORMATION = 0x00000004;
78
+ /** SECURITY_INFORMATION:强制标签(SACL 的一部分)。 */
79
+ export const LABEL_SECURITY_INFORMATION = 0x00000010;
80
+ /** SetNamedSecurityInfoW / GetNamedSecurityInfoW 的对象类型:文件或目录。 */
81
+ export const SE_FILE_OBJECT = 1;
82
+ /** EXPLICIT_ACCESS 的模式。 */
83
+ export const GRANT_ACCESS = 2;
84
+ export const DENY_ACCESS = 3;
85
+ export const REVOKE_ACCESS = 4;
86
+ /** TrusteeForm:ptstrName 是 SID 字节。 */
87
+ export const TRUSTEE_IS_SID = 0;
88
+ /** TrusteeType:不指名类型。 */
89
+ export const TRUSTEE_IS_UNKNOWN = 0;
90
+ /** EXPLICIT_ACCESS_W 在 x64 上共 48 字节。 */
91
+ export const EXPLICIT_ACCESS_SIZE = 48;
92
+ /** EXPLICIT_ACCESS_W 字段偏移(x64 对齐;TRUSTEE 从 16 开始)。 */
93
+ export const EA_OFFSETS = {
94
+ grfAccessPermissions: 0,
95
+ grfAccessMode: 4,
96
+ grfInheritance: 8,
97
+ pMultipleTrustee: 16,
98
+ MultipleTrusteeOperation: 24,
99
+ TrusteeForm: 28,
100
+ TrusteeType: 32,
101
+ ptstrName: 40,
102
+ };
103
+ /** ACL 头里的 ACE 数量偏移(AclRevision@0, Sbz1@2, AclSize@2, AceCount@4)。 */
104
+ export const ACL_ACE_COUNT_OFFSET = 4;
105
+ /** 第一条 ACE 在 ACL 里的偏移。 */
106
+ export const ACL_FIRST_ACE_OFFSET = 8;
107
+ /** ACCESS_ALLOWED/DENIED_ACE 的掩码偏移(头 4 字节后)。 */
108
+ export const ACE_MASK_OFFSET = 4;
109
+ /** 各类 ACE 的内联 SID 偏移(头 4 + 掩码 4)。 */
110
+ export const ACE_SID_OFFSET = 8;
111
+ // ── 进程创建 ────────────────────────────────────────────────────────────────
112
+ /** 挂起创建:先塞进 Job 再放行,杜绝「杀树前先跑起来」的窗口。 */
113
+ export const CREATE_SUSPENDED = 0x00000004;
114
+ export const STARTF_USESTDHANDLES = 0x00000100;
115
+ export const STARTF_USESHOWWINDOW = 0x00000001;
116
+ export const SW_HIDE = 0;
117
+ /**
118
+ * STARTUPINFOW 在 x64 上 104 字节(13 个 4 字节字段对齐到 8 后接三个句柄)。
119
+ * 注意 dwFlags 在 60 而不是 44——前三个指针字段把布局顶开了。
120
+ */
121
+ export const STARTUPINFOW_SIZE = 104;
122
+ export const SI_OFFSETS = {
123
+ cb: 0,
124
+ dwFlags: 60,
125
+ wShowWindow: 64,
126
+ hStdInput: 80,
127
+ hStdOutput: 88,
128
+ hStdError: 96,
129
+ };
130
+ /** PROCESS_INFORMATION 在 x64 上 24 字节。 */
131
+ export const PROCESS_INFORMATION_SIZE = 24;
132
+ export const PI_OFFSETS = {
133
+ hProcess: 0,
134
+ hThread: 8,
135
+ dwProcessId: 16,
136
+ dwThreadId: 20,
137
+ };
138
+ // ── Job Object ──────────────────────────────────────────────────────────────
139
+ /** JobObjectExtendedLimitInformation 信息类。 */
140
+ export const JobObjectExtendedLimitInformation = 9;
141
+ /** 最后一个 Job 句柄关闭时终止全部成员:父进程死 = 子树死。 */
142
+ export const JOB_OBJECT_LIMIT_KILL_ON_JOB_CLOSE = 0x2000;
143
+ /** JOBOBJECT_EXTENDED_LIMIT_INFORMATION 在 x64 上 144 字节,LimitFlags 在 16。 */
144
+ export const JOBOBJECT_EXTENDED_LIMIT_SIZE = 144;
145
+ export const JOBOBJ_LIMIT_FLAGS_OFFSET = 16;
146
+ // ── 账号登录(网络第二级:runner 以专用离线账号跑命令)────────────────────────
147
+ /** LogonUserW 的登录类型:交互式。 */
148
+ export const LOGON32_LOGON_INTERACTIVE = 2;
149
+ /** LogonUserW 的提供者:默认。 */
150
+ export const LOGON32_PROVIDER_DEFAULT = 0;
151
+ // ── 等待与错误 ──────────────────────────────────────────────────────────────
152
+ export const WAIT_OBJECT_0 = 0;
153
+ export const INFINITE = 0xffffffff;
154
+ export const ERROR_BROKEN_PIPE = 109;
155
+ export const ERROR_NO_DATA = 232;
156
+ export const ERROR_INVALID_PARAMETER = 87;
157
+ export const ERROR_ACCESS_DENIED = 5;
158
+ // ── 锁文件 ──────────────────────────────────────────────────────────────────
159
+ export const GENERIC_READ = 0x80000000;
160
+ export const GENERIC_WRITE = 0x40000000;
161
+ export const OPEN_ALWAYS = 4;
162
+ export const FILE_SHARE_READ = 0x00000001;
163
+ export const FILE_SHARE_WRITE = 0x00000002;
164
+ /** 刻意不带 FILE_SHARE_DELETE:防别人把锁文件换掉(照 dsh)。 */
165
+ export const FILE_ATTRIBUTE_NORMAL = 0x80;
166
+ export const LOCKFILE_FAIL_IMMEDIATELY = 0x00000001;
167
+ export const LOCKFILE_EXCLUSIVE_LOCK = 0x00000002;
168
+ /** LockFileEx 的 OVERLAPPED 在 x64 上 32 字节(koffi 3.1.1 传 NULL 会崩,给零块)。 */
169
+ export const OVERLAPPED_SIZE = 32;
@@ -0,0 +1,71 @@
1
+ /**
2
+ * 沙箱账号密码的 DPAPI 存取 + setup 状态文件的读写(外加这几个文件的路径口径)。
3
+ *
4
+ * 为什么用 DPAPI CurrentUser:提权 setup 是用**同一个真人用户**的令牌跑起来的(UAC 只是提升完整性),
5
+ * 所以 `CurrentUser` 作用域下加密的 blob,之后免提权跑 doctor / 启动沙箱时也能解开——
6
+ * 而沙箱账号自己的密码是随机 24 位、只存在这个 blob 里,落盘必须是密文。
7
+ *
8
+ * DPAPI 的 ABI 很朴素,但 DATA_BLOB 要手工打包(仓库统一口径:结构体一律手工,koffi struct 不用):
9
+ * typedef struct _DATA_BLOB { DWORD cbData; BYTE *pbData; } DATA_BLOB; // x64 = 16 字节
10
+ * 偏移:cbData@0(u32),pbData@8(指针,8 字节对齐所以中间有 4 字节填充)。
11
+ * 入参与出参都是同一个 16 字节布局,`CryptProtectData`/`CryptUnprotectData` 的最后一个参数是出参 blob,
12
+ * 里头 `pbData` 指向的缓冲是 API 自己 LocalAlloc 的,读完必须 LocalFree(ffi.ts 已绑)。
13
+ *
14
+ * @module dsc/core/sandbox/win/account
15
+ */
16
+ import { type BoundWin32 } from './ffi.js';
17
+ /** DPAPI 标志:禁止弹任何 UI(后台无人值守路径必须给,否则可能静默失败或卡住)。 */
18
+ export declare const CRYPTPROTECT_UI_FORBIDDEN = 1;
19
+ /** DATA_BLOB 的 x64 字节数:cbData(u32) + 4 字节填充 + pbData(指针)。 */
20
+ export declare const DATA_BLOB_SIZE = 16;
21
+ /**
22
+ * setup 状态文件的形状:它是「二级布防做了什么」的账本,doctor 全靠它对账。
23
+ * `wfpFilterCount` 是 dsc 额外记的诊断字段(脚本实际装上几条),不在最小必需集里。
24
+ */
25
+ export interface DscSetupState {
26
+ readonly version: number;
27
+ readonly account: string;
28
+ readonly sid: string;
29
+ readonly proxyPort: number;
30
+ readonly firewallRules: readonly string[];
31
+ readonly wfpProviderGuid: string;
32
+ readonly wfpSublayerGuid: string;
33
+ readonly at: string;
34
+ readonly wfpFilterCount?: number;
35
+ }
36
+ /** 读 setup 状态文件的三态结果:没文件是 `null`,有文件但坏了是 `{ok:false}`。 */
37
+ export type SetupStateRead = {
38
+ readonly ok: true;
39
+ readonly state: DscSetupState;
40
+ } | {
41
+ readonly ok: false;
42
+ readonly error: string;
43
+ } | null;
44
+ /** `~/.dsc/sandbox`。 */
45
+ export declare function sandboxDir(dscHome: string): string;
46
+ /** `~/.dsc/sandbox/setup-state.json`:布防账本。 */
47
+ export declare function setupStatePath(dscHome: string): string;
48
+ /** `~/.dsc/sandbox/account.bin`:DPAPI 保护的账号密码。 */
49
+ export declare function accountBlobPath(dscHome: string): string;
50
+ /** `~/.dsc/sandbox/setup.ps1`:生成的提权脚本落盘位置(审计用,也是 UAC 那条命令的 -File)。 */
51
+ export declare function setupScriptPath(dscHome: string): string;
52
+ /** `~/.dsc/sandbox/setup-error.txt`:提权脚本失败时写的失败原因。 */
53
+ export declare function setupErrorPath(dscHome: string): string;
54
+ /**
55
+ * 用 DPAPI CurrentUser 加密一段文本,返回可以直接落盘的密文。
56
+ *
57
+ * `bound` 是 ffi.ts 的绑定表(借它拿 koffi 与 LocalFree);`plaintext` 是账号密码。
58
+ */
59
+ export declare function protectSecret(bound: BoundWin32, plaintext: string): Buffer;
60
+ /** 解开 `protectSecret` 的产物。密文被截断/换过用户/换过机器都会在这里抛,带系统错误码。 */
61
+ export declare function unprotectSecret(bound: BoundWin32, blob: Buffer): string;
62
+ /**
63
+ * 读 `~/.dsc/sandbox/setup-state.json`。
64
+ *
65
+ * 返回:文件不存在 → `null`;解析/形状不对或读不动 → `{ok:false, error}`(带文件路径与原因);
66
+ * 正常 → `{ok:true, state}`。**不抛**——doctor 要的是一条明细,不是异常。
67
+ *
68
+ * PowerShell 5.1 的 `-Encoding UTF8` 会带 BOM,所以这里先剥 BOM 再 `JSON.parse`
69
+ * (不剥的话 node 的 JSON.parse 会直接报错,是个很容易踩的假故障)。
70
+ */
71
+ export declare function readSetupState(dscHome: string): SetupStateRead;
@@ -0,0 +1,206 @@
1
+ /**
2
+ * 沙箱账号密码的 DPAPI 存取 + setup 状态文件的读写(外加这几个文件的路径口径)。
3
+ *
4
+ * 为什么用 DPAPI CurrentUser:提权 setup 是用**同一个真人用户**的令牌跑起来的(UAC 只是提升完整性),
5
+ * 所以 `CurrentUser` 作用域下加密的 blob,之后免提权跑 doctor / 启动沙箱时也能解开——
6
+ * 而沙箱账号自己的密码是随机 24 位、只存在这个 blob 里,落盘必须是密文。
7
+ *
8
+ * DPAPI 的 ABI 很朴素,但 DATA_BLOB 要手工打包(仓库统一口径:结构体一律手工,koffi struct 不用):
9
+ * typedef struct _DATA_BLOB { DWORD cbData; BYTE *pbData; } DATA_BLOB; // x64 = 16 字节
10
+ * 偏移:cbData@0(u32),pbData@8(指针,8 字节对齐所以中间有 4 字节填充)。
11
+ * 入参与出参都是同一个 16 字节布局,`CryptProtectData`/`CryptUnprotectData` 的最后一个参数是出参 blob,
12
+ * 里头 `pbData` 指向的缓冲是 API 自己 LocalAlloc 的,读完必须 LocalFree(ffi.ts 已绑)。
13
+ *
14
+ * @module dsc/core/sandbox/win/account
15
+ */
16
+ import { readFileSync } from 'node:fs';
17
+ import { join } from 'node:path';
18
+ import { addressOf, throwLastError } from './ffi.js';
19
+ /** DPAPI 标志:禁止弹任何 UI(后台无人值守路径必须给,否则可能静默失败或卡住)。 */
20
+ export const CRYPTPROTECT_UI_FORBIDDEN = 0x1;
21
+ /** DATA_BLOB 的 x64 字节数:cbData(u32) + 4 字节填充 + pbData(指针)。 */
22
+ export const DATA_BLOB_SIZE = 16;
23
+ // ── 路径口径(setup.ts 生成脚本、doctor.ts 检查都从这里取,别各自拼)─────────────
24
+ /** `~/.dsc/sandbox`。 */
25
+ export function sandboxDir(dscHome) {
26
+ return join(dscHome, 'sandbox');
27
+ }
28
+ /** `~/.dsc/sandbox/setup-state.json`:布防账本。 */
29
+ export function setupStatePath(dscHome) {
30
+ return join(sandboxDir(dscHome), 'setup-state.json');
31
+ }
32
+ /** `~/.dsc/sandbox/account.bin`:DPAPI 保护的账号密码。 */
33
+ export function accountBlobPath(dscHome) {
34
+ return join(sandboxDir(dscHome), 'account.bin');
35
+ }
36
+ /** `~/.dsc/sandbox/setup.ps1`:生成的提权脚本落盘位置(审计用,也是 UAC 那条命令的 -File)。 */
37
+ export function setupScriptPath(dscHome) {
38
+ return join(sandboxDir(dscHome), 'setup.ps1');
39
+ }
40
+ /** `~/.dsc/sandbox/setup-error.txt`:提权脚本失败时写的失败原因。 */
41
+ export function setupErrorPath(dscHome) {
42
+ return join(sandboxDir(dscHome), 'setup-error.txt');
43
+ }
44
+ let cachedCrypt = null;
45
+ /** 绑 crypt32.dll;失败抛(调用方都是「要用密码」的路径,静默降级没意义)。 */
46
+ function loadCrypt32(bound) {
47
+ if (cachedCrypt !== null)
48
+ return cachedCrypt;
49
+ try {
50
+ const crypt32 = bound.koffi.load('crypt32.dll');
51
+ const bind = (name, args) => crypt32.func('__stdcall', name, 'int', args);
52
+ cachedCrypt = {
53
+ // BOOL CryptProtectData(DATA_BLOB *in, LPCWSTR descr, DATA_BLOB *entropy, PVOID reserved,
54
+ // CRYPTPROTECT_PROMPTSTRUCT *prompt, DWORD flags, DATA_BLOB *out)
55
+ protect: bind('CryptProtectData', ['void *', 'void *', 'void *', 'void *', 'void *', 'uint32', 'void *']),
56
+ // BOOL CryptUnprotectData(DATA_BLOB *in, LPWSTR *descr, DATA_BLOB *entropy, PVOID reserved,
57
+ // CRYPTPROTECT_PROMPTSTRUCT *prompt, DWORD flags, DATA_BLOB *out)
58
+ unprotect: bind('CryptUnprotectData', ['void *', 'void *', 'void *', 'void *', 'void *', 'uint32', 'void *']),
59
+ };
60
+ return cachedCrypt;
61
+ }
62
+ catch (error) {
63
+ throw new Error(`crypt32.dll 绑定失败(DPAPI 不可用):${errorText(error)}`);
64
+ }
65
+ }
66
+ /**
67
+ * 用 DPAPI CurrentUser 加密一段文本,返回可以直接落盘的密文。
68
+ *
69
+ * `bound` 是 ffi.ts 的绑定表(借它拿 koffi 与 LocalFree);`plaintext` 是账号密码。
70
+ */
71
+ export function protectSecret(bound, plaintext) {
72
+ const crypt = loadCrypt32(bound);
73
+ const input = Buffer.from(plaintext, 'utf8');
74
+ const inputBlob = packDataBlob(bound, input);
75
+ const outputBlob = Buffer.alloc(DATA_BLOB_SIZE);
76
+ const ok = Number(crypt.protect(inputBlob, null, null, null, null, CRYPTPROTECT_UI_FORBIDDEN, outputBlob));
77
+ if (ok === 0)
78
+ throwLastError(bound, 'CryptProtectData');
79
+ return readAndFreeBlob(bound, outputBlob, 'CryptProtectData');
80
+ }
81
+ /** 解开 `protectSecret` 的产物。密文被截断/换过用户/换过机器都会在这里抛,带系统错误码。 */
82
+ export function unprotectSecret(bound, blob) {
83
+ if (blob.length === 0)
84
+ throw new Error('CryptUnprotectData 拒绝空密文(account.bin 是 0 字节?)');
85
+ const crypt = loadCrypt32(bound);
86
+ const inputBlob = packDataBlob(bound, blob);
87
+ const outputBlob = Buffer.alloc(DATA_BLOB_SIZE);
88
+ const ok = Number(crypt.unprotect(inputBlob, null, null, null, null, CRYPTPROTECT_UI_FORBIDDEN, outputBlob));
89
+ if (ok === 0)
90
+ throwLastError(bound, 'CryptUnprotectData');
91
+ return readAndFreeBlob(bound, outputBlob, 'CryptUnprotectData').toString('utf8');
92
+ }
93
+ /**
94
+ * 打包 16 字节 DATA_BLOB:cbData 写在 0,pbData 指向 `data` 的首字节。
95
+ * 注意 `data` 必须在 API 调用期间活着(blob 里存的是裸地址)。
96
+ */
97
+ function packDataBlob(bound, data) {
98
+ const blob = Buffer.alloc(DATA_BLOB_SIZE);
99
+ blob.writeUInt32LE(data.length, 0);
100
+ blob.writeBigUInt64LE(BigInt(addressOf(bound, data)), 8);
101
+ return blob;
102
+ }
103
+ /** 读出参 blob 的内容并 LocalFree 掉 API 分配的缓冲。 */
104
+ function readAndFreeBlob(bound, outputBlob, api) {
105
+ const size = outputBlob.readUInt32LE(0);
106
+ const pointer = Number(outputBlob.readBigUInt64LE(8));
107
+ if (pointer === 0 || size === 0) {
108
+ throw new Error(`${api} 报成功但给出空 blob(size=${String(size)},pointer=${String(pointer)})`);
109
+ }
110
+ try {
111
+ const decoded = bound.koffi.decode(pointer, 'uint8', size);
112
+ const view = decoded instanceof Uint8Array ? decoded : new Uint8Array(decoded);
113
+ return Buffer.from(view); // 拷贝一份,随后就能安全 LocalFree
114
+ }
115
+ finally {
116
+ bound.localFree(pointer);
117
+ }
118
+ }
119
+ // ── setup 状态文件 ───────────────────────────────────────────────────────────
120
+ /**
121
+ * 读 `~/.dsc/sandbox/setup-state.json`。
122
+ *
123
+ * 返回:文件不存在 → `null`;解析/形状不对或读不动 → `{ok:false, error}`(带文件路径与原因);
124
+ * 正常 → `{ok:true, state}`。**不抛**——doctor 要的是一条明细,不是异常。
125
+ *
126
+ * PowerShell 5.1 的 `-Encoding UTF8` 会带 BOM,所以这里先剥 BOM 再 `JSON.parse`
127
+ * (不剥的话 node 的 JSON.parse 会直接报错,是个很容易踩的假故障)。
128
+ */
129
+ export function readSetupState(dscHome) {
130
+ const file = setupStatePath(dscHome);
131
+ let text;
132
+ try {
133
+ text = readFileSync(file, 'utf8');
134
+ }
135
+ catch (error) {
136
+ if (error.code === 'ENOENT')
137
+ return null;
138
+ return { ok: false, error: `读 setup 状态文件失败(${file}):${errorText(error)}` };
139
+ }
140
+ let parsed;
141
+ try {
142
+ parsed = JSON.parse(stripBom(text));
143
+ }
144
+ catch (error) {
145
+ return { ok: false, error: `setup 状态文件不是合法 JSON(${file}):${errorText(error)}` };
146
+ }
147
+ const shape = coerceSetupState(parsed);
148
+ if (!shape.ok)
149
+ return { ok: false, error: `setup 状态文件字段不对(${file}):${shape.error}` };
150
+ return { ok: true, state: shape.state };
151
+ }
152
+ /** 逐字段核对状态文件;坏在哪一条要说清楚(doctor 会把这句原样打给用户)。 */
153
+ function coerceSetupState(value) {
154
+ if (typeof value !== 'object' || value === null)
155
+ return { ok: false, error: '顶层不是对象' };
156
+ const record = value;
157
+ const version = record.version;
158
+ if (typeof version !== 'number' || !Number.isInteger(version))
159
+ return { ok: false, error: 'version 不是整数' };
160
+ const account = record.account;
161
+ if (typeof account !== 'string' || account === '')
162
+ return { ok: false, error: 'account 不是非空字符串' };
163
+ const sid = record.sid;
164
+ if (typeof sid !== 'string' || sid === '')
165
+ return { ok: false, error: 'sid 不是非空字符串' };
166
+ const proxyPort = record.proxyPort;
167
+ if (typeof proxyPort !== 'number' || !Number.isInteger(proxyPort) || proxyPort < 0 || proxyPort > 65535) {
168
+ return { ok: false, error: 'proxyPort 不是 0-65535 的整数' };
169
+ }
170
+ const rawRules = record.firewallRules;
171
+ if (!Array.isArray(rawRules) || rawRules.some((item) => typeof item !== 'string')) {
172
+ return { ok: false, error: 'firewallRules 不是字符串数组' };
173
+ }
174
+ const provider = record.wfpProviderGuid;
175
+ if (typeof provider !== 'string' || provider === '')
176
+ return { ok: false, error: 'wfpProviderGuid 不是非空字符串' };
177
+ const sublayer = record.wfpSublayerGuid;
178
+ if (typeof sublayer !== 'string' || sublayer === '')
179
+ return { ok: false, error: 'wfpSublayerGuid 不是非空字符串' };
180
+ const at = record.at;
181
+ if (typeof at !== 'string' || at === '')
182
+ return { ok: false, error: 'at 不是非空字符串' };
183
+ const rawCount = record.wfpFilterCount;
184
+ if (rawCount !== undefined && typeof rawCount !== 'number')
185
+ return { ok: false, error: 'wfpFilterCount 不是数字' };
186
+ const state = {
187
+ version,
188
+ account,
189
+ sid,
190
+ proxyPort,
191
+ firewallRules: rawRules,
192
+ wfpProviderGuid: provider,
193
+ wfpSublayerGuid: sublayer,
194
+ at,
195
+ ...(typeof rawCount === 'number' ? { wfpFilterCount: rawCount } : {}),
196
+ };
197
+ return { ok: true, state };
198
+ }
199
+ /** 去掉 UTF-8 BOM(PowerShell 5.1 的 `-Encoding UTF8` 会写)。 */
200
+ function stripBom(text) {
201
+ return text.charCodeAt(0) === 0xfeff ? text.slice(1) : text;
202
+ }
203
+ /** 异常转一句话。 */
204
+ function errorText(error) {
205
+ return error instanceof Error ? error.message : String(error);
206
+ }
@@ -0,0 +1,54 @@
1
+ import { type BoundWin32 } from './ffi.js';
2
+ /** ACL 里一条 ACE 的切片视图(`sid` 指向 ACL 内部的字节,别留着跨调用用)。 */
3
+ export interface AceView {
4
+ /** ACE 类型:0 Allow / 1 Deny / 0x11 强制标签。 */
5
+ type: number;
6
+ /** AceFlags:继承位等。 */
7
+ flags: number;
8
+ /** 访问掩码。 */
9
+ mask: number;
10
+ /** 内联 SID 的字节副本(视图,长度 = 8 + 子授权数*4)。 */
11
+ sid: Uint8Array;
12
+ }
13
+ /**
14
+ * 把一段 ACL 字节解开成 ACE 列表。
15
+ *
16
+ * SID **内联在 ACE+8** 处(不是指针),长度 = 8 + count*4,count 字节在 sid+1;
17
+ * 按 AceSize 步进。size 出现非法值(小于最小 ACE、越过 ACL 尾、装不下声明的 SID)
18
+ * 就停下——后面的字节已经不可信,继续步进只会走到别人的数据上。
19
+ */
20
+ export declare function walkAces(aclBytes: Uint8Array): AceView[];
21
+ /** 授权/回收的结果。 */
22
+ export interface GrantOutcome {
23
+ /** 是否真的动了 ACL(false = 幂等跳过,没写盘)。 */
24
+ applied: boolean;
25
+ /** 给用户与日志的一句话。 */
26
+ detail: string;
27
+ }
28
+ /**
29
+ * 给目录授权(幂等):三件套一次 SetNamedSecurityInfoW 打齐。
30
+ *
31
+ * @param path - 目标目录(调用方保证是 realpath 规范化后的绝对路径)。
32
+ * @param sid - 能力 SID 串(S-1-4-x-y,来自 workspace-sid.ts)。
33
+ * @param lockDir - 锁文件目录(调用方保证已存在)。
34
+ */
35
+ export declare function grantWrite(bound: BoundWin32, path: string, sid: string, lockDir: string): GrantOutcome;
36
+ /**
37
+ * 给目录补「账号 SID 的读写执行 Allow ACE」(网络第二级账号分支专用)。
38
+ *
39
+ * 为什么要它:专用离线账号没有当前用户的权限,工作区里它连**读**都不行——
40
+ * pass-1(普通 SID 检查)就过不去,命令在仓库里什么都干不了。假能力 SID 的
41
+ * 三件套只解决 pass-2(写受限交集),pass-1 得靠这条 ACE 补上。
42
+ *
43
+ * 掩码 = 读 + 执行 + GRANT_MASK(写/删),仍刻意不含 WRITE_DAC/WRITE_OWNER;
44
+ * 幂等口径与三件套一致(精确命中即跳过整树重传播)。
45
+ */
46
+ export declare function grantAccountAccess(bound: BoundWin32, path: string, accountSid: string, lockDir: string): GrantOutcome;
47
+ /**
48
+ * 回收目录上的能力 SID 授权(REVOKE_ACCESS 只摘我们自己的那条 ACE)。
49
+ *
50
+ * 刻意**不动** Low 标签:NO_WRITE_UP 只拦「比标签更低」的写,用户自己的中完整性
51
+ * 进程不受影响,留着它等于给这个目录留一道永久加固;摘标签反而要在「还有没有别的
52
+ * 能力授权」上做一堆判断,收益为负。
53
+ */
54
+ export declare function revokeWrite(bound: BoundWin32, path: string, sid: string, lockDir: string): GrantOutcome;