@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,818 @@
1
+ /**
2
+ * 钩子引擎:用户在工具动手之前自己加的一道闸,用来挡住「模型这次手滑」。
3
+ *
4
+ * 两种钩子:
5
+ * 1. 规则——界面里填的一行字:管哪个工具、看哪个字段、命中什么模式、是拦下来还是问人。
6
+ * 不启动任何进程,日常够用。
7
+ * 2. 脚本——一条外部命令。它的 stdin 收到这次调用的 JSON,用退出码或 stdout 的 JSON 回话。
8
+ * 要跑自己那套检查逻辑(比如「本项目禁止碰 migrations 目录」)才需要它。
9
+ *
10
+ * 与 `~/.dsc/policy.rules` 的分工:那份文件管「这条命令算几危险」,只认 bash 的命令文本,
11
+ * 结论是给审批环节参考的 allow/ask/deny;这里的规则管**所有**工具(读、写、改、执行都算),
12
+ * 并且只有加严的本事——它没有「自动放行」这一档,要放宽请回 policy.rules 写前缀规则。
13
+ *
14
+ * 配置在 `~/.dsc/hooks.json`(读到哪算哪、每次写全量)。脚本第一次要执行时得用户批准一次,
15
+ * 批准记在 `~/.dsc/hooks-trusted.json`,批准时记下脚本文件的修改时间,脚本改动后停止执行并要求重批。
16
+ *
17
+ * 失败方向刻意与 dsh / Hermes 相反:那两家遇到脚本超时、命令起不来、输出看不懂时一律放行
18
+ * (`agent/shell_hooks.py:388-395` 的 fail open)。dsc 默认按「拦下来」处理,
19
+ * 因为这道闸存在的意义就是挡意外,一扇坏了的门不该等于没有门;想退回放行有开关
20
+ * (`settings.scriptFailClosed`)。
21
+ *
22
+ * @module dsc/core/hooks
23
+ */
24
+ import { spawn } from 'node:child_process';
25
+ import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from 'node:fs';
26
+ import { randomUUID } from 'node:crypto';
27
+ import { redact, scrubChildEnv } from './secrets.js';
28
+ import { dscPath } from './path-policy.js';
29
+ /** 钩子配置文件(与 settings.json、audit.jsonl 同级)。 */
30
+ export const HOOKS_FILE = dscPath('hooks.json');
31
+ /** 脚本钩子的批准名单(与配置文件分开存:批准是「人对某条命令表过态」,不该跟着配置一起被覆盖)。 */
32
+ export const HOOK_TRUST_FILE = dscPath('hooks-trusted.json');
33
+ /**
34
+ * 钩子事件。只有 `pre-tool` 有裁决权,其余三个是观察者:
35
+ * 它们的脚本照样跑、照样能把话留在会话里,但改不了已经发生或即将发生的事。
36
+ */
37
+ export const HOOK_EVENTS = ['pre-tool', 'post-tool', 'session-start', 'turn-end'];
38
+ /** 规则拿去比对的字段:命令原文、写目标路径、参数 JSON,或者三者全看。 */
39
+ export const HOOK_RULE_FIELDS = ['command', 'target', 'args', 'any'];
40
+ /** 规则命中后的动作。刻意没有 allow:钩子只能加严,放宽归 `policy.rules` 管。 */
41
+ export const HOOK_RULE_ACTIONS = ['deny', 'ask'];
42
+ /** 脚本单次执行的缺省超时、下限、上限(毫秒)。脚本是闸门,不是后台任务。 */
43
+ export const HOOK_TIMEOUT_DEFAULT = 10_000;
44
+ export const HOOK_TIMEOUT_MIN = 500;
45
+ export const HOOK_TIMEOUT_MAX = 120_000;
46
+ /** 规则与脚本的条数上限、正则与理由的字数上限。 */
47
+ export const HOOK_MAX_RULES = 200;
48
+ export const HOOK_MAX_SCRIPTS = 50;
49
+ export const HOOK_PATTERN_MAX = 300;
50
+ export const HOOK_REASON_MAX = 200;
51
+ /** 脚本的 stderr 有多少字可以当成阻断理由。 */
52
+ export const HOOK_STDERR_MAX = 400;
53
+ /** 回到模型跟审批卡上的那句理由最长多少字(与 Hermes 进上下文的夹取一致)。 */
54
+ export const HOOK_MESSAGE_MAX = 2048;
55
+ /** 脚本 stdout 最多读多少字(再多就是拿用户的内存换没用的输出)。 */
56
+ export const HOOK_STDOUT_MAX = 64 * 1024;
57
+ const DEFAULT_SETTINGS = {
58
+ enabled: true,
59
+ scriptTimeoutMs: HOOK_TIMEOUT_DEFAULT,
60
+ scriptFailClosed: true,
61
+ autoAccept: false,
62
+ };
63
+ const EMPTY_DOC = { settings: { ...DEFAULT_SETTINGS }, rules: [], scripts: [], problems: [] };
64
+ // ── 读写配置文件 ─────────────────────────────────────────────────────────────
65
+ /** 配置文件的缓存(按 mtime + 大小判新,免得每次工具调用都重读重解析一遍磁盘)。 */
66
+ let cache = null;
67
+ function clamp(value, min, max, fallback) {
68
+ const num = Number(value);
69
+ return Number.isFinite(num) ? Math.min(Math.max(Math.round(num), min), max) : fallback;
70
+ }
71
+ function asString(value, max) {
72
+ return typeof value === 'string' ? value.slice(0, max).trim() : '';
73
+ }
74
+ function newId() {
75
+ return randomUUID().slice(0, 8);
76
+ }
77
+ /** 把磁盘上的任意内容读成一份能用的配置;坏掉的条目跳过并把原因记进 `problems`。 */
78
+ function normalize(raw) {
79
+ const doc = { settings: { ...DEFAULT_SETTINGS }, rules: [], scripts: [], problems: [] };
80
+ if (raw === null || typeof raw !== 'object')
81
+ return doc;
82
+ const source = raw;
83
+ const settings = (source.settings ?? {});
84
+ doc.settings.enabled = settings.enabled !== false;
85
+ doc.settings.scriptTimeoutMs = clamp(settings.scriptTimeoutMs, HOOK_TIMEOUT_MIN, HOOK_TIMEOUT_MAX, HOOK_TIMEOUT_DEFAULT);
86
+ doc.settings.scriptFailClosed = settings.scriptFailClosed !== false;
87
+ doc.settings.autoAccept = settings.autoAccept === true;
88
+ if (Array.isArray(source.rules)) {
89
+ for (const item of source.rules) {
90
+ const rule = normalizeRule(item);
91
+ if (rule === null)
92
+ doc.problems.push('有一条规则不是可识别的样子,已跳过(缺 pattern 或动作不认)');
93
+ else if (rule.pattern !== '')
94
+ doc.rules.push(rule);
95
+ else
96
+ doc.problems.push(`规则 ${rule.id} 没有填模式,已跳过(空模式会命中一切,太危险)`);
97
+ }
98
+ if (doc.rules.length > HOOK_MAX_RULES) {
99
+ doc.problems.push(`规则条数超过 ${HOOK_MAX_RULES} 条,多出来的已忽略`);
100
+ doc.rules = doc.rules.slice(0, HOOK_MAX_RULES);
101
+ }
102
+ }
103
+ if (Array.isArray(source.scripts)) {
104
+ for (const item of source.scripts) {
105
+ const script = normalizeScript(item);
106
+ if (script === null)
107
+ doc.problems.push('有一条脚本钩子不是可识别的样子,已跳过(缺 command 或事件名不认)');
108
+ else
109
+ doc.scripts.push(script);
110
+ }
111
+ if (doc.scripts.length > HOOK_MAX_SCRIPTS) {
112
+ doc.problems.push(`脚本条数超过 ${HOOK_MAX_SCRIPTS} 条,多出来的已忽略`);
113
+ doc.scripts = doc.scripts.slice(0, HOOK_MAX_SCRIPTS);
114
+ }
115
+ }
116
+ return doc;
117
+ }
118
+ function normalizeRule(item) {
119
+ if (item === null || typeof item !== 'object')
120
+ return null;
121
+ const raw = item;
122
+ const pattern = asString(raw.pattern, HOOK_PATTERN_MAX);
123
+ const action = asString(raw.action, 16).toLowerCase();
124
+ if (pattern === '' || (action !== 'deny' && action !== 'ask'))
125
+ return null;
126
+ return {
127
+ id: asString(raw.id, 32) === '' ? newId() : asString(raw.id, 32),
128
+ enabled: raw.enabled !== false,
129
+ tool: asString(raw.tool, 120) === '' ? '*' : asString(raw.tool, 120),
130
+ field: HOOK_RULE_FIELDS.includes(asString(raw.field, 16))
131
+ ? asString(raw.field, 16)
132
+ : 'any',
133
+ pattern,
134
+ action: action,
135
+ reason: asString(raw.reason, HOOK_REASON_MAX),
136
+ };
137
+ }
138
+ function normalizeScript(item) {
139
+ if (item === null || typeof item !== 'object')
140
+ return null;
141
+ const raw = item;
142
+ const command = asString(raw.command, 1000);
143
+ const event = asString(raw.event, 24);
144
+ if (command === '' || !HOOK_EVENTS.includes(event))
145
+ return null;
146
+ return {
147
+ id: asString(raw.id, 32) === '' ? newId() : asString(raw.id, 32),
148
+ enabled: raw.enabled !== false,
149
+ event: event,
150
+ matcher: asString(raw.matcher, 120) === '' ? '*' : asString(raw.matcher, 120),
151
+ command,
152
+ timeoutMs: clamp(raw.timeoutMs, 0, HOOK_TIMEOUT_MAX, 0),
153
+ failClosed: raw.failClosed !== false,
154
+ };
155
+ }
156
+ /**
157
+ * 读钩子配置(缓存命中就直接返回旧份)。
158
+ *
159
+ * 文件读不出来或不是合法 JSON 时返回空配置并把原因带回去:
160
+ * 配置文件写坏不该让工具调用崩掉,但必须看得见为什么没生效。
161
+ */
162
+ export function readHooks() {
163
+ let stat = null;
164
+ try {
165
+ stat = existsSync(HOOKS_FILE) ? statSync(HOOKS_FILE) : null;
166
+ }
167
+ catch (error) {
168
+ const doc = { ...EMPTY_DOC, settings: { ...DEFAULT_SETTINGS }, problems: [] };
169
+ doc.problems.push(`钩子配置读不到:${error instanceof Error ? error.message : String(error)}`);
170
+ return doc;
171
+ }
172
+ if (stat === null)
173
+ return { ...EMPTY_DOC, settings: { ...DEFAULT_SETTINGS }, rules: [], scripts: [], problems: [] };
174
+ if (cache !== null && cache.mtime === stat.mtimeMs && cache.size === stat.size)
175
+ return cache.doc;
176
+ let doc;
177
+ try {
178
+ doc = normalize(JSON.parse(readFileSync(HOOKS_FILE, 'utf8')));
179
+ }
180
+ catch (error) {
181
+ doc = { ...EMPTY_DOC, settings: { ...DEFAULT_SETTINGS }, rules: [], scripts: [] };
182
+ doc.problems.push(`钩子配置不是合法 JSON,这一份没生效:${error instanceof Error ? error.message : String(error)}`);
183
+ }
184
+ cache = { mtime: stat.mtimeMs, size: stat.size, doc };
185
+ return doc;
186
+ }
187
+ /** 全量写配置(写完让缓存失效,下一次判定立刻用新内容)。 */
188
+ function writeHooks(doc) {
189
+ const body = { version: 1, settings: doc.settings, rules: doc.rules, scripts: doc.scripts };
190
+ mkdirSync(dscPath(), { recursive: true });
191
+ writeFileSync(HOOKS_FILE, `${JSON.stringify(body, null, 2)}\n`, 'utf8');
192
+ cache = null;
193
+ }
194
+ /** 带着新内容重写配置的公共入口(增删改都从这里过,避免多处各自拼 JSON)。 */
195
+ function mutate(fn) {
196
+ const doc = readHooks();
197
+ const draft = {
198
+ settings: { ...doc.settings },
199
+ rules: doc.rules.map((rule) => ({ ...rule })),
200
+ scripts: doc.scripts.map((script) => ({ ...script })),
201
+ problems: [...doc.problems],
202
+ };
203
+ const problem = fn(draft);
204
+ if (problem !== undefined && problem !== null)
205
+ return problem;
206
+ writeHooks(draft);
207
+ return undefined;
208
+ }
209
+ /**
210
+ * 加一条规则。
211
+ * @param input - 规则内容(`id` 由这里生成)。
212
+ * @returns 成功给新 id,失败给用户看得懂的原因。
213
+ */
214
+ export function addRule(input) {
215
+ const pattern = input.pattern.trim();
216
+ if (pattern === '')
217
+ return { ok: false, error: '模式不能空着:空模式会命中所有工具' };
218
+ if (pattern.length > HOOK_PATTERN_MAX)
219
+ return { ok: false, error: `模式最长 ${HOOK_PATTERN_MAX} 字` };
220
+ try {
221
+ new RegExp(pattern, 'i');
222
+ }
223
+ catch (error) {
224
+ return { ok: false, error: `这个正则用不了:${error instanceof Error ? error.message : String(error)}` };
225
+ }
226
+ if (!HOOK_RULE_ACTIONS.includes(input.action)) {
227
+ return { ok: false, error: '动作只认「拦下来」或「问人」' };
228
+ }
229
+ const rule = {
230
+ id: newId(),
231
+ enabled: true,
232
+ tool: input.tool.trim() === '' ? '*' : input.tool.trim(),
233
+ field: HOOK_RULE_FIELDS.includes(input.field) ? input.field : 'any',
234
+ pattern,
235
+ action: input.action,
236
+ reason: input.reason.trim().slice(0, HOOK_REASON_MAX),
237
+ };
238
+ const failure = mutate((draft) => {
239
+ if (draft.rules.length >= HOOK_MAX_RULES)
240
+ return `规则最多 ${HOOK_MAX_RULES} 条,先删几条`;
241
+ draft.rules.push(rule);
242
+ });
243
+ return failure === undefined || failure === null ? { ok: true, id: rule.id } : { ok: false, error: failure };
244
+ }
245
+ /** 删一条规则(不存在时静默返回,界面上的选择会自动跟上)。 */
246
+ export function removeRule(id) {
247
+ mutate((draft) => {
248
+ draft.rules = draft.rules.filter((rule) => rule.id !== id);
249
+ });
250
+ }
251
+ /** 启停一条规则。 */
252
+ export function setRuleEnabled(id, enabled) {
253
+ mutate((draft) => {
254
+ const rule = draft.rules.find((item) => item.id === id);
255
+ if (rule !== undefined)
256
+ rule.enabled = enabled;
257
+ });
258
+ }
259
+ /**
260
+ * 加一条脚本钩子。
261
+ *
262
+ * 新加的脚本默认不执行:要么它已经在批准名单里,要么 `settings.autoAccept` 开着,
263
+ * 否则得在界面上点一次「批准」。
264
+ *
265
+ * @param input - 脚本内容。
266
+ * @returns 成功给新 id,失败给原因。
267
+ */
268
+ export function addScript(input) {
269
+ const command = input.command.trim();
270
+ if (command === '')
271
+ return { ok: false, error: '命令不能空着' };
272
+ if (command.length > 1000)
273
+ return { ok: false, error: '命令最长 1000 字' };
274
+ if (!HOOK_EVENTS.includes(input.event))
275
+ return { ok: false, error: '事件名不认' };
276
+ const script = {
277
+ id: newId(),
278
+ enabled: true,
279
+ event: input.event,
280
+ matcher: input.matcher.trim() === '' ? '*' : input.matcher.trim().slice(0, 120),
281
+ command,
282
+ timeoutMs: input.timeoutMs === undefined ? 0 : clamp(input.timeoutMs, 0, HOOK_TIMEOUT_MAX, 0),
283
+ failClosed: input.failClosed === undefined ? true : input.failClosed,
284
+ };
285
+ const failure = mutate((draft) => {
286
+ if (draft.scripts.length >= HOOK_MAX_SCRIPTS)
287
+ return `脚本钩子最多 ${HOOK_MAX_SCRIPTS} 条,先删几条`;
288
+ draft.scripts.push(script);
289
+ });
290
+ return failure === undefined || failure === null ? { ok: true, id: script.id } : { ok: false, error: failure };
291
+ }
292
+ /** 删一条脚本钩子。 */
293
+ export function removeScript(id) {
294
+ mutate((draft) => {
295
+ draft.scripts = draft.scripts.filter((script) => script.id !== id);
296
+ });
297
+ }
298
+ /** 启停一条脚本钩子。 */
299
+ export function setScriptEnabled(id, enabled) {
300
+ mutate((draft) => {
301
+ const script = draft.scripts.find((item) => item.id === id);
302
+ if (script !== undefined)
303
+ script.enabled = enabled;
304
+ });
305
+ }
306
+ /** 改全局可调项,返回改完之后的值(非法数字会被夹回区间)。 */
307
+ export function patchHookSettings(patch) {
308
+ let current = readHooks().settings;
309
+ mutate((draft) => {
310
+ if (patch.enabled !== undefined)
311
+ draft.settings.enabled = patch.enabled;
312
+ if (patch.scriptTimeoutMs !== undefined) {
313
+ draft.settings.scriptTimeoutMs = clamp(patch.scriptTimeoutMs, HOOK_TIMEOUT_MIN, HOOK_TIMEOUT_MAX, current.scriptTimeoutMs);
314
+ }
315
+ if (patch.scriptFailClosed !== undefined)
316
+ draft.settings.scriptFailClosed = patch.scriptFailClosed;
317
+ if (patch.autoAccept !== undefined)
318
+ draft.settings.autoAccept = patch.autoAccept;
319
+ current = draft.settings;
320
+ });
321
+ return current;
322
+ }
323
+ /** 带扩展名才算「可能是脚本」的后缀(批准时只对这些文件盯修改时间)。 */
324
+ const SCRIPT_SUFFIXES = ['.js', '.mjs', '.cjs', '.ts', '.py', '.sh', '.bash', '.ps1', '.cmd', '.bat', '.exe', '.rb', '.pl'];
325
+ /** 把命令串按空格切开,尊重双引号与单引号(够用了:钩子命令都是「解释器 脚本 参数」这一类)。 */
326
+ function tokenize(command) {
327
+ const out = [];
328
+ const pattern = /"([^"]*)"|'([^']*)'|(\S+)/g;
329
+ let match;
330
+ while ((match = pattern.exec(command)) !== null)
331
+ out.push((match[1] ?? match[2] ?? match[3] ?? '').trim());
332
+ return out.filter((token) => token !== '');
333
+ }
334
+ /**
335
+ * 从命令里认出被执行的脚本文件。
336
+ *
337
+ * 取第一个「带脚本后缀且真的存在」的词;认不出来返回空串(表示没有可盯的文件,改不了就不算漂移)。
338
+ *
339
+ * @param command - 命令原文。
340
+ */
341
+ export function scriptFileOf(command) {
342
+ for (const token of tokenize(command)) {
343
+ const lower = token.toLowerCase();
344
+ if (!SCRIPT_SUFFIXES.some((suffix) => lower.endsWith(suffix)))
345
+ continue;
346
+ try {
347
+ if (existsSync(token) && statSync(token).isFile())
348
+ return token;
349
+ }
350
+ catch {
351
+ // 路径里有非法字符就跳过这个词,认不出脚本文件顶多是少了漂移检查
352
+ }
353
+ }
354
+ return '';
355
+ }
356
+ function readTrust() {
357
+ try {
358
+ if (!existsSync(HOOK_TRUST_FILE))
359
+ return { trusted: [] };
360
+ const raw = JSON.parse(readFileSync(HOOK_TRUST_FILE, 'utf8'));
361
+ const list = Array.isArray(raw.trusted) ? raw.trusted : [];
362
+ const trusted = [];
363
+ for (const item of list) {
364
+ if (item === null || typeof item !== 'object')
365
+ continue;
366
+ const entry = item;
367
+ const event = typeof entry.event === 'string' ? entry.event : '';
368
+ const command = typeof entry.command === 'string' ? entry.command : '';
369
+ if (!HOOK_EVENTS.includes(event) || command === '')
370
+ continue;
371
+ trusted.push({
372
+ event: event,
373
+ command,
374
+ trustedAt: Number(entry.trustedAt) || 0,
375
+ scriptPath: typeof entry.scriptPath === 'string' ? entry.scriptPath : '',
376
+ scriptMtime: Number(entry.scriptMtime) || 0,
377
+ });
378
+ }
379
+ return { trusted };
380
+ }
381
+ catch {
382
+ // 名单读坏就当没批准过:宁可多问一次,也不要在读不出来的名单上放行任意脚本
383
+ return { trusted: [] };
384
+ }
385
+ }
386
+ function writeTrust(doc) {
387
+ mkdirSync(dscPath(), { recursive: true });
388
+ writeFileSync(HOOK_TRUST_FILE, `${JSON.stringify({ version: 1, trusted: doc.trusted }, null, 2)}\n`, 'utf8');
389
+ }
390
+ /**
391
+ * 查一条脚本钩子现在能不能执行。
392
+ *
393
+ * Hermes 只提示「脚本自批准后被改过」照样跑(`hooks.md:1911`);dsc 选择停跑并要求重批——
394
+ * 批准的对象是那一份脚本内容,内容换了就是另一件事。
395
+ *
396
+ * @param script - 要查的脚本钩子。
397
+ * @param autoAccept - 设置里的「新脚本不询问」是否开着:开着就不拦执行,但状态仍然照实报,
398
+ * 界面上看得见这条还没被人点过头。
399
+ */
400
+ export function trustOf(script, autoAccept = false) {
401
+ const scriptPath = scriptFileOf(script.command);
402
+ const entry = readTrust().trusted.find((item) => item.event === script.event && item.command === script.command);
403
+ if (entry === undefined) {
404
+ return {
405
+ state: 'untrusted',
406
+ detail: autoAccept
407
+ ? '没人批准过,但设置里开了「新脚本不询问」,会直接执行'
408
+ : '没批准过,不会执行(在详情里点「批准这条脚本」)',
409
+ scriptPath,
410
+ trustedAt: 0,
411
+ runnable: autoAccept,
412
+ };
413
+ }
414
+ let mtime = entry.scriptMtime;
415
+ if (scriptPath !== '') {
416
+ try {
417
+ mtime = statSync(scriptPath).mtimeMs;
418
+ }
419
+ catch {
420
+ // 脚本文件不见了:按漂移处理(脚本被换掉或删掉都不该继续当成批准过的那份)
421
+ mtime = Number.POSITIVE_INFINITY;
422
+ }
423
+ }
424
+ if (mtime > entry.scriptMtime) {
425
+ return {
426
+ state: 'changed',
427
+ detail: `脚本自 ${new Date(entry.trustedAt).toLocaleString()} 批准之后被改动过,已停止执行,请重新批准`,
428
+ scriptPath,
429
+ trustedAt: entry.trustedAt,
430
+ runnable: false,
431
+ };
432
+ }
433
+ return { state: 'trusted', detail: '已批准', scriptPath, trustedAt: entry.trustedAt, runnable: true };
434
+ }
435
+ /**
436
+ * 批准一条脚本(记当前脚本文件的修改时间)。
437
+ * @param id - 脚本 id。
438
+ * @returns 成功给空,失败给原因(找不到这条脚本时)。
439
+ */
440
+ export function trustScript(id) {
441
+ const doc = readHooks();
442
+ const script = doc.scripts.find((item) => item.id === id);
443
+ if (script === undefined)
444
+ return '没有这条脚本钩子(可能刚被删掉)';
445
+ const trust = readTrust();
446
+ const scriptPath = scriptFileOf(script.command);
447
+ let scriptMtime = 0;
448
+ if (scriptPath !== '') {
449
+ try {
450
+ scriptMtime = statSync(scriptPath).mtimeMs;
451
+ }
452
+ catch (error) {
453
+ return `脚本文件读不到:${error instanceof Error ? error.message : String(error)}`;
454
+ }
455
+ }
456
+ trust.trusted = trust.trusted.filter((item) => !(item.event === script.event && item.command === script.command));
457
+ trust.trusted.push({ event: script.event, command: script.command, trustedAt: Date.now(), scriptPath, scriptMtime });
458
+ writeTrust(trust);
459
+ }
460
+ /** 撤销一条脚本的批准(下一次执行前得重新批准)。 */
461
+ export function untrustScript(id) {
462
+ const doc = readHooks();
463
+ const script = doc.scripts.find((item) => item.id === id);
464
+ if (script === undefined)
465
+ return;
466
+ const trust = readTrust();
467
+ trust.trusted = trust.trusted.filter((item) => !(item.event === script.event && item.command === script.command));
468
+ writeTrust(trust);
469
+ }
470
+ // ── 规则匹配 ─────────────────────────────────────────────────────────────────
471
+ /** 正则缓存(同一条规则每次工具调用都重新编译正则是白费的)。 */
472
+ const patternCache = new Map();
473
+ /** 工具名是否落在这份清单里:`*`/空 = 全部,否则 `|` 或 `,` 分隔的字面量,不区分大小写。 */
474
+ function toolListHit(list, toolName) {
475
+ const trimmed = list.trim();
476
+ if (trimmed === '' || trimmed === '*')
477
+ return true;
478
+ const wanted = toolName.toLowerCase();
479
+ return trimmed
480
+ .split(/[|,]/)
481
+ .map((item) => item.trim().toLowerCase())
482
+ .filter((item) => item !== '')
483
+ .includes(wanted);
484
+ }
485
+ /** 拿到规则用的正则;正则写坏了就退化成字面量子串(记一条毛病,不让整条链崩掉)。 */
486
+ function ruleRegex(pattern) {
487
+ if (patternCache.has(pattern)) {
488
+ const cached = patternCache.get(pattern);
489
+ return { regex: cached ?? null, literal: pattern };
490
+ }
491
+ let regex = null;
492
+ try {
493
+ regex = new RegExp(pattern, 'i');
494
+ }
495
+ catch {
496
+ regex = null;
497
+ }
498
+ patternCache.set(pattern, regex);
499
+ return { regex, literal: pattern };
500
+ }
501
+ /** 把一次守卫入参摊开成规则要比对的三个文本。 */
502
+ export function hookFacts(input) {
503
+ return {
504
+ toolName: input.toolName,
505
+ command: input.command ?? '',
506
+ target: input.target ?? '',
507
+ argsText: JSON.stringify(input.args ?? {}),
508
+ };
509
+ }
510
+ /** 一条规则是否命中这次调用。 */
511
+ export function ruleHits(rule, facts) {
512
+ if (!toolListHit(rule.tool, facts.toolName))
513
+ return false;
514
+ const { regex, literal } = ruleRegex(rule.pattern);
515
+ const fields = rule.field === 'any' ? ['command', 'target', 'args'] : [rule.field];
516
+ for (const field of fields) {
517
+ const text = field === 'command' ? facts.command : field === 'target' ? facts.target : facts.argsText;
518
+ if (text === '')
519
+ continue;
520
+ if (regex !== null ? regex.test(text) : text.toLowerCase().includes(literal.toLowerCase()))
521
+ return true;
522
+ }
523
+ return false;
524
+ }
525
+ /** 工具名是否被脚本的 matcher 命中(不锚定的正则;写坏了退化成字面量)。 */
526
+ export function matcherHits(matcher, toolName) {
527
+ const trimmed = matcher.trim();
528
+ if (trimmed === '' || trimmed === '*')
529
+ return true;
530
+ const { regex, literal } = ruleRegex(trimmed);
531
+ return regex !== null ? regex.test(toolName) : toolName.toLowerCase().includes(literal.toLowerCase());
532
+ }
533
+ function shellOf() {
534
+ return process.platform === 'win32'
535
+ ? { file: 'cmd.exe', args: ['/d', '/s', '/c'] }
536
+ : { file: '/bin/sh', args: ['-c'] };
537
+ }
538
+ /**
539
+ * 跑一条脚本钩子。
540
+ *
541
+ * 命令交给 shell 执行(`cmd.exe /c` 或 `sh -c`),这样「`node guard.js --strict`」这种
542
+ * 带参数、带管道的命令都能照原样写。子进程环境剥过凭据(同 bash 工具),
543
+ * stdin 是唯一事实来源,超时就直接杀进程。
544
+ *
545
+ * @param script - 要跑的脚本钩子。
546
+ * @param payload - 递给 stdin 的载荷(一行 JSON)。
547
+ * @param cwd - 用哪个目录当工作目录(会话目录,不是 dsc 自己的目录)。
548
+ * @param signal - 这一轮的取消信号:用户按打断时杀掉脚本。
549
+ * @param defaultTimeoutMs - 这条脚本没写超时时给多少毫秒。
550
+ * @returns 执行结果(不抛错:脚本怎么坏都体现在返回值里,交给裁决去判)。
551
+ */
552
+ export function runHookScript(script, payload, cwd, signal, defaultTimeoutMs) {
553
+ const timeout = script.timeoutMs > 0 ? script.timeoutMs : defaultTimeoutMs;
554
+ const shell = shellOf();
555
+ const started = Date.now();
556
+ return new Promise((resolveDone) => {
557
+ let stdout = '';
558
+ let stderr = '';
559
+ let truncated = false;
560
+ let timedOut = false;
561
+ let spawnError = '';
562
+ let done = false;
563
+ let child;
564
+ try {
565
+ child = spawn(shell.file, [...shell.args, script.command], {
566
+ cwd,
567
+ env: scrubChildEnv(process.env).env,
568
+ windowsHide: true,
569
+ stdio: ['pipe', 'pipe', 'pipe'],
570
+ });
571
+ }
572
+ catch (error) {
573
+ resolveDone({
574
+ exitCode: -1,
575
+ stdout: '',
576
+ stderr: '',
577
+ ms: Date.now() - started,
578
+ timedOut: false,
579
+ spawnError: error instanceof Error ? error.message : String(error),
580
+ truncated: false,
581
+ });
582
+ return;
583
+ }
584
+ const timer = setTimeout(() => {
585
+ timedOut = true;
586
+ try {
587
+ child.kill('SIGKILL');
588
+ }
589
+ catch {
590
+ // 进程已经自己退了,杀不掉就不用管
591
+ }
592
+ // Windows 上 `cmd.exe /c` 被杀掉之后,它启动的那个脚本还占着管道,等 'close'
593
+ // 就把一个已经判死的脚本等成了好几秒。超时的输出本来就不该信,直接结清。
594
+ for (const stream of [child.stdout, child.stderr, child.stdin]) {
595
+ try {
596
+ stream?.destroy();
597
+ }
598
+ catch {
599
+ // 管道已经断了, destroy 二次调用无所谓
600
+ }
601
+ }
602
+ if (process.platform === 'win32' && child.pid !== undefined) {
603
+ // shell 启的那个脚本不归 cmd.exe 的死管,得连整棵进程树一起点名杀
604
+ try {
605
+ spawn('taskkill', ['/pid', String(child.pid), '/T', '/F'], { windowsHide: true, stdio: 'ignore' });
606
+ }
607
+ catch {
608
+ // 杀不掉也已经有上面的 SIGKILL 兜着
609
+ }
610
+ }
611
+ finish(-1);
612
+ }, timeout);
613
+ const abort = () => {
614
+ try {
615
+ child.kill('SIGKILL');
616
+ }
617
+ catch {
618
+ // 同上
619
+ }
620
+ };
621
+ signal.addEventListener('abort', abort, { once: true });
622
+ const finish = (exitCode) => {
623
+ if (done)
624
+ return;
625
+ done = true;
626
+ clearTimeout(timer);
627
+ signal.removeEventListener('abort', abort);
628
+ resolveDone({
629
+ exitCode,
630
+ stdout: redact(stdout),
631
+ stderr: redact(stderr),
632
+ ms: Date.now() - started,
633
+ timedOut,
634
+ spawnError,
635
+ truncated,
636
+ });
637
+ };
638
+ child.stdout?.setEncoding('utf8');
639
+ child.stderr?.setEncoding('utf8');
640
+ child.stdout?.on('data', (chunk) => {
641
+ if (stdout.length >= HOOK_STDOUT_MAX) {
642
+ truncated = true;
643
+ return;
644
+ }
645
+ stdout += chunk;
646
+ });
647
+ child.stderr?.on('data', (chunk) => {
648
+ if (stderr.length < HOOK_STDOUT_MAX)
649
+ stderr += chunk;
650
+ });
651
+ child.on('error', (error) => {
652
+ spawnError = error.message;
653
+ });
654
+ child.on('close', (code, closeSignal) => {
655
+ finish(spawnError !== '' ? -1 : (code ?? (closeSignal === null ? -1 : 128)));
656
+ });
657
+ try {
658
+ child.stdin?.write(`${JSON.stringify(payload)}\n`);
659
+ child.stdin?.end();
660
+ }
661
+ catch (error) {
662
+ // 脚本自己没读 stdin 就退出了:不影响裁决,写不进去记一笔
663
+ spawnError = spawnError === '' ? `stdin 写不进去:${error instanceof Error ? error.message : String(error)}` : spawnError;
664
+ }
665
+ });
666
+ }
667
+ /**
668
+ * 把脚本的 stdout 解析成结论。
669
+ *
670
+ * 三套写法都认,因为要让用户手上的现成钩子脚本直接能用:
671
+ * 1. dsc 自己的写法:`{"action":"deny","message":"..."}`,动作认 `deny|block|ask|note|pass`。
672
+ * 2. Claude Code 的写法:`{"decision":"block","reason":"..."}` 或
673
+ * `{"hookSpecificOutput":{"permissionDecision":"deny"}}`。它的 `approve` 是「自动放行」,
674
+ * 在 dsc 里按「不表态」处理(想表达「交给人确认」请写 `ask`)。
675
+ * 3. Hermes 的写法:`{"action":"approve"}` 表示**交给人确认**,与上面第 2 条意思相反,
676
+ * 所以按用了哪个键来区分(`action` 走 Hermes 语义,`decision` 走 Claude 语义)。
677
+ *
678
+ * @param stdout - 脚本的标准输出。
679
+ * @returns 结论;解析不出来返回 null(由退出码与 failClosed 兜底)。
680
+ */
681
+ export function parseScriptVerdict(stdout) {
682
+ const text = stdout.trim();
683
+ if (!text.startsWith('{'))
684
+ return null;
685
+ let raw;
686
+ try {
687
+ const parsed = JSON.parse(text);
688
+ if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed))
689
+ return null;
690
+ raw = parsed;
691
+ }
692
+ catch {
693
+ return null;
694
+ }
695
+ const messageOf = (...keys) => {
696
+ for (const key of keys) {
697
+ const value = raw[key];
698
+ if (typeof value === 'string' && value.trim() !== '')
699
+ return value.trim().slice(0, HOOK_MESSAGE_MAX);
700
+ }
701
+ return '';
702
+ };
703
+ const map = (action, message) => {
704
+ const lower = action.toLowerCase();
705
+ if (lower === 'deny' || lower === 'block' || lower === 'prevent' || lower === 'reject')
706
+ return { action: 'block', message };
707
+ if (lower === 'ask' || lower === 'approve_hermes')
708
+ return { action: 'ask', message };
709
+ if (lower === 'note' || lower === 'context')
710
+ return { action: 'note', message };
711
+ return { action: 'pass', message };
712
+ };
713
+ const action = typeof raw.action === 'string' ? raw.action : typeof raw.decision === 'string' ? raw.decision : '';
714
+ if (action !== '') {
715
+ // 同一个词在两家意思相反:`action` 键按 Hermes 读(approve = 交给人批),
716
+ // `decision` 键按 Claude 读(approve = 自动放行)。写清楚,别拿用户的脚本猜。
717
+ const key = typeof raw.action === 'string' ? 'action' : 'decision';
718
+ const normalized = key === 'action' && action.toLowerCase() === 'approve' ? 'approve_hermes' : action;
719
+ return map(normalized, messageOf('message', 'reason', 'reasonMessage'));
720
+ }
721
+ const specific = raw.hookSpecificOutput;
722
+ if (specific !== null && typeof specific === 'object') {
723
+ const inner = specific;
724
+ const permission = inner.permissionDecision;
725
+ if (typeof permission === 'string') {
726
+ const reasonOf = () => {
727
+ const value = inner.permissionDecisionReason;
728
+ return typeof value === 'string' && value.trim() !== '' ? value.trim().slice(0, HOOK_MESSAGE_MAX) : '';
729
+ };
730
+ const lower = permission.toLowerCase();
731
+ if (lower === 'deny')
732
+ return { action: 'block', message: reasonOf() };
733
+ if (lower === 'ask')
734
+ return { action: 'ask', message: reasonOf() };
735
+ if (lower === 'allow')
736
+ return { action: 'pass', message: '' };
737
+ }
738
+ }
739
+ return { action: 'pass', message: '' };
740
+ }
741
+ /** 把一次执行结果折成结论(这里决定 fail-closed 的三种失败形态)。 */
742
+ export function judgeScriptRun(run, script, settings) {
743
+ const source = `脚本 ${script.command.slice(0, 40)}`;
744
+ const failClosed = script.failClosed && settings.scriptFailClosed;
745
+ const verdict = parseScriptVerdict(run.stdout);
746
+ const note = (problem, action = 'pass', message = '') => ({
747
+ action,
748
+ message,
749
+ source,
750
+ ms: run.ms,
751
+ problem,
752
+ });
753
+ if (run.spawnError !== '') {
754
+ const problem = `脚本没能启动:${run.spawnError}`;
755
+ return failClosed
756
+ ? note(problem, 'block', `钩子脚本没能启动(${run.spawnError})。按「脚本没跑成就算拦」处理;不想要这条规矩就把这条脚本停掉或关掉那个开关。`)
757
+ : note(problem);
758
+ }
759
+ if (run.timedOut) {
760
+ const problem = `脚本超时被杀(${run.ms}ms)`;
761
+ return failClosed
762
+ ? note(problem, 'block', `钩子脚本没在期限内给出结论,按「脚本没跑成就算拦」处理。`)
763
+ : note(problem);
764
+ }
765
+ if (run.exitCode === 2) {
766
+ if (verdict !== null && verdict.action === 'block')
767
+ return note('', 'block', verdict.message);
768
+ const reason = run.stderr.trim().slice(0, HOOK_STDERR_MAX);
769
+ return note('', 'block', reason === '' ? '被钩子拦下(脚本以 2 退出,没给原因)' : reason);
770
+ }
771
+ if (verdict !== null) {
772
+ if (verdict.action === 'block')
773
+ return note('', 'block', verdict.message);
774
+ if (verdict.action === 'ask')
775
+ return note('', 'ask', verdict.message);
776
+ if (verdict.action === 'note')
777
+ return note('', 'note', verdict.message);
778
+ if (run.exitCode === 0)
779
+ return note('');
780
+ return failClosed
781
+ ? note(`脚本以 ${run.exitCode} 退出但给出了放行结论`, 'block', `钩子脚本退出码是 ${run.exitCode},按「脚本没跑成就算拦」处理。`)
782
+ : note(`脚本以 ${run.exitCode} 退出,仍按它的结论放行`);
783
+ }
784
+ if (run.exitCode === 0) {
785
+ if (run.stdout.trim() === '')
786
+ return note('');
787
+ const problem = '脚本输出不是能看懂的 JSON';
788
+ return failClosed
789
+ ? note(problem, 'block', '钩子脚本的输出读不懂(既不是 JSON 也没用退出码 2 表达阻断)。按「脚本没跑成就算拦」处理。')
790
+ : note(problem);
791
+ }
792
+ const problem = `脚本以 ${run.exitCode} 退出,没有给出结论`;
793
+ return failClosed
794
+ ? note(problem, 'block', `钩子脚本失败(退出码 ${run.exitCode})。按「脚本没跑成就算拦」处理。`)
795
+ : note(problem);
796
+ }
797
+ /** 结论的优先次序:拦 > 问人 > 只留话 > 不表态(与注册顺序无关,多条命中全部跑完再比)。 */
798
+ const ACTION_RANK = { block: 3, ask: 2, note: 1, pass: 0 };
799
+ /** 从多条结论里挑最终结论(并列时保留先给出的那条原因)。 */
800
+ export function strongestJudgement(list) {
801
+ let best = null;
802
+ for (const item of list) {
803
+ if (best === null || ACTION_RANK[item.action] > ACTION_RANK[best.action])
804
+ best = item;
805
+ }
806
+ return best;
807
+ }
808
+ /** 拼出回给模型的那句话(规则与脚本的原因都会原样到模型眼前,模型才知道该改道)。 */
809
+ export function hookReasonForModel(judgement, what) {
810
+ const body = judgement.message === '' ? '安全钩子拦下了这次操作,没有给出更具体的原因。' : judgement.message;
811
+ return `【安全钩子】${what}:${body}(钩子来源:${judgement.source}。请换一个不做这件事的做法,或者把要用户确认的话说给用户,不要重试同一件事。)`;
812
+ }
813
+ /** 规则命中时给的那条结论。 */
814
+ export function ruleJudgement(rule) {
815
+ const source = `规则 /${rule.pattern}/(${rule.tool})`;
816
+ const message = rule.reason === '' ? (rule.action === 'deny' ? '这条操作被用户登记的规则禁止' : '用户登记的规则要求这次必须有人确认') : rule.reason;
817
+ return { action: rule.action === 'deny' ? 'block' : 'ask', message, source, ms: 0, problem: '' };
818
+ }