@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,576 @@
1
+ /**
2
+ * 生命周期钩子引擎:按 codex 的事件名读一份外部配置,跑外部命令,把结论交回插件落位。
3
+ *
4
+ * 与 `core/hooks.ts`(安全钩子)的分工:那个管 dsc 自己的四个事件、配置在
5
+ * `~/.dsc/hooks.json`;这一份管 codex 那十二个事件名、配置在
6
+ * `~/.dsc/lifecycle-hooks.json`。**两份配置各读各的**,不共用文件,免得两个插件抢同一份配置。
7
+ *
8
+ * 三件事在这里定死,插件那边只负责挂扩展点:
9
+ * 1. 十二个事件各自的档位(wired / partial / unwired)与不能接通的理由,见
10
+ * {@link LIFECYCLE_CAPABILITIES}——`unwired` 的事件配了钩子也不执行,只进 `problems`;
11
+ * 2. 外部命令怎么跑、跑不成怎么算(默认按拒,`failClosed: false` 才转放行),
12
+ * 执行器自带一份,因为 codex 的载荷契约(snake_case、无结尾换行)与
13
+ * `core/hooks.ts` 的 `runHookScript` 不一样;
14
+ * 3. 钩子说的话进模型之前一律过 `wrapUntrusted`,来源写 `hook:<事件名>`。
15
+ *
16
+ * 复用的是判定那一半:`matcherHits` 匹配工具名、`judgeScriptRun` 折裁决与失败方向、
17
+ * 超时下限上限沿用 `HOOK_TIMEOUT_*`,这样两个钩子插件的失败语义不会各说各话。
18
+ *
19
+ * @module dsc/core/lifecycle-hooks
20
+ */
21
+ import { spawn } from 'node:child_process';
22
+ import { existsSync, readFileSync } from 'node:fs';
23
+ import { homedir } from 'node:os';
24
+ import { join } from 'node:path';
25
+ import { HOOK_STDERR_MAX, HOOK_STDOUT_MAX, HOOK_TIMEOUT_DEFAULT, HOOK_TIMEOUT_MAX, HOOK_TIMEOUT_MIN, judgeScriptRun, matcherHits, } from './hooks.js';
26
+ import { resolvePluginConfig } from './plugin-registry.js';
27
+ import { scrubChildEnv, redact } from './secrets.js';
28
+ import { wrapUntrusted } from './untrusted.js';
29
+ import { dscPath } from './path-policy.js';
30
+ // ── 十二个事件与它们的档位 ───────────────────────────────────────────────────
31
+ /**
32
+ * codex 的十二个生命周期事件名,照抄 `codex/codex-rs/hooks/src/lib.rs:23-36`。
33
+ * 名字保持 codex 原样(大驼峰),用户手上的 hooks.json 不用改一个字。
34
+ */
35
+ export const LIFECYCLE_EVENTS = [
36
+ 'PreToolUse',
37
+ 'PermissionRequest',
38
+ 'PostToolUse',
39
+ 'PreCompact',
40
+ 'PostCompact',
41
+ 'SessionStart',
42
+ 'SessionEnd',
43
+ 'UserPromptSubmit',
44
+ 'SubagentStart',
45
+ 'SubagentStop',
46
+ 'Stop',
47
+ 'Interrupt',
48
+ ];
49
+ /**
50
+ * 能力清单(显式声明,别让用户猜哪些事件真的会跑)。
51
+ * 档位是按 dsc 现有扩展点核实过的,改扩展点就要连带改这张表。
52
+ */
53
+ export const LIFECYCLE_CAPABILITIES = [
54
+ {
55
+ event: 'PreToolUse',
56
+ tier: 'wired',
57
+ extension: 'ctx.guards.register(order 25)',
58
+ note: '排在协作模式 10 之后、审批 30 之前。钩子返回 deny 就当场上报,拒绝理由原样回给模型。',
59
+ },
60
+ {
61
+ event: 'PostToolUse',
62
+ tier: 'partial',
63
+ extension: 'ctx.guards.registerObserver(order 45)',
64
+ note: '观察位是同步的纯文本加工(core/tool-guards.ts:115-119),等不了外部命令,所以钩子挂在后台跑,它说的话只能进下一次请求,改不了这次工具结果。',
65
+ },
66
+ {
67
+ event: 'SessionStart',
68
+ tier: 'wired',
69
+ extension: "ctx.on('dsc/session-open') + ctx.prompt.transformMessages",
70
+ note: '钩子的输出攒起来,在下一次请求末尾补一条 system;llm.ts 发送前会把散落的 system 并进头部,所以这么补是安全的。',
71
+ },
72
+ {
73
+ event: 'PostCompact',
74
+ tier: 'wired',
75
+ extension: "ctx.on('dsc/compacted')",
76
+ note: '压缩完成即触发,输出同样攒进下一次请求。',
77
+ },
78
+ {
79
+ event: 'SessionEnd',
80
+ tier: 'partial',
81
+ extension: "ctx.on('dsc/exit')",
82
+ note: '退出流程发完 dsc/exit 就收拾进程,不等钩子跑完,所以命令可能跑到一半被进程结束打断。',
83
+ },
84
+ {
85
+ event: 'UserPromptSubmit',
86
+ tier: 'partial',
87
+ extension: 'ctx.prompt.transformMessages',
88
+ note: '请求组装是同步点,等不了外部命令,做不到 codex 的「当场拒掉这条提问」;钩子的结论只能进下一次请求。',
89
+ },
90
+ {
91
+ event: 'Stop',
92
+ tier: 'partial',
93
+ extension: "ctx.on('dsc/turn-end')(reason === 'completed')",
94
+ note: '能把话留下给下一轮,但 dsc 没有「钩子强制续跑」这个扩展点(续跑归会话目标插件管)。',
95
+ },
96
+ {
97
+ event: 'Interrupt',
98
+ tier: 'partial',
99
+ extension: "ctx.on('dsc/turn-end')(reason === 'aborted')",
100
+ note: '同上:只留话,不改变打断这件事本身。',
101
+ },
102
+ {
103
+ event: 'PermissionRequest',
104
+ tier: 'unwired',
105
+ extension: '无',
106
+ note: '审批卡只在 approval 插件内部挂起与应答,waiting 登记表只有查询没有变更通知(plugins/waiting.ts:19-42),外面看不到「有人正等着批」,也就没有可以挂钩的时刻。',
107
+ },
108
+ {
109
+ event: 'PreCompact',
110
+ tier: 'unwired',
111
+ extension: '无',
112
+ note: 'compact 插件直接调 compactSession,压缩之前没有任何事件或扩展点,想拦在压缩前得先加扩展点。',
113
+ },
114
+ {
115
+ event: 'SubagentStart',
116
+ tier: 'unwired',
117
+ extension: '无',
118
+ note: 'subagent 插件不广播子智能体启动,team 服务只有名册与回放,外面收不到这个时刻。',
119
+ },
120
+ {
121
+ event: 'SubagentStop',
122
+ tier: 'unwired',
123
+ extension: '无',
124
+ note: '同 SubagentStart:队友什么时候收工没有广播,只有事后能重放它的记录。',
125
+ },
126
+ ];
127
+ /**
128
+ * matcher 字段拿什么去比:只有这三个事件在 dsc 里有比对对象。
129
+ * 其余事件的 matcher 会被忽略(配了也会记一条 problems,不静默吞掉)。
130
+ */
131
+ export const LIFECYCLE_MATCHER_EVENTS = ['PreToolUse', 'PostToolUse', 'SessionStart'];
132
+ /** 这个事件支持 matcher 比对(不支持时 matcher 字段被忽略)。 */
133
+ export function matcherSupported(event) {
134
+ return LIFECYCLE_MATCHER_EVENTS.includes(event);
135
+ }
136
+ // ── 配置 ─────────────────────────────────────────────────────────────────────
137
+ /** 钩子条数上限、命令与 matcher 的字数上限。 */
138
+ export const LIFECYCLE_MAX_HOOKS = 50;
139
+ export const LIFECYCLE_COMMAND_MAX = 1000;
140
+ export const LIFECYCLE_MATCHER_MAX = 120;
141
+ /** 缺省值。放着让用户改,不是硬编码的裁决。 */
142
+ export const LIFECYCLE_DEFAULTS = {
143
+ enabled: true,
144
+ configPath: dscPath('lifecycle-hooks.json'),
145
+ timeoutMs: HOOK_TIMEOUT_DEFAULT,
146
+ failClosed: true,
147
+ commandAllowlist: '',
148
+ };
149
+ /** `~` 展开成用户目录;相对路径原样返回(交给 spawn 的 cwd 去解析)。 */
150
+ function expandPath(text) {
151
+ if (text === '~')
152
+ return homedir();
153
+ if (text.startsWith('~/') || text.startsWith('~\\'))
154
+ return join(homedir(), text.slice(2));
155
+ return text;
156
+ }
157
+ function clampNumber(value, min, max, fallback) {
158
+ const num = Number(value);
159
+ return Number.isFinite(num) ? Math.min(Math.max(Math.round(num), min), max) : fallback;
160
+ }
161
+ function asText(value, fallback) {
162
+ return typeof value === 'string' && value.trim() !== '' ? value.trim() : fallback;
163
+ }
164
+ /**
165
+ * 取这个插件此刻该用的配置:装配时传进来的那份作底,`~/.dsc/plugins.json` 上那份覆盖它。
166
+ * 每次用值都现调,所以设置里改完不必重启宿主。
167
+ *
168
+ * @param passed - 插件 `apply(ctx, passed)` 的第二参数;不是对象就当没给。
169
+ */
170
+ export function resolveLifecycleConfig(passed) {
171
+ const raw = resolvePluginConfig('lifecycle-hooks', passed);
172
+ return {
173
+ enabled: raw.enabled !== false && raw.enabled !== 'false',
174
+ configPath: expandPath(asText(raw.configPath, LIFECYCLE_DEFAULTS.configPath)),
175
+ timeoutMs: clampNumber(raw.timeoutMs, HOOK_TIMEOUT_MIN, HOOK_TIMEOUT_MAX, LIFECYCLE_DEFAULTS.timeoutMs),
176
+ failClosed: raw.failClosed !== false && raw.failClosed !== 'false',
177
+ commandAllowlist: typeof raw.commandAllowlist === 'string' ? raw.commandAllowlist : LIFECYCLE_DEFAULTS.commandAllowlist,
178
+ };
179
+ }
180
+ function isRecord(value) {
181
+ return value !== null && typeof value === 'object' && !Array.isArray(value);
182
+ }
183
+ /**
184
+ * 把磁盘上的内容按 codex 的形态读成钩子表。
185
+ *
186
+ * 认两种外形:`{ hooks: { PreToolUse: [...] } }`(codex 的包装形态)与直接的事件表
187
+ * `{ PreToolUse: [...] }`。每个事件下是一组 `{ matcher, hooks: [{ type, command, timeout }] }`;
188
+ * 只跑同步的 `command` 钩子,`type` 不是 command 或写了 `async: true` 的照样列进 problems
189
+ * 而不是悄悄丢掉。`timeout` 与 `timeoutSec` 都按**秒**读(codex 的约定),0 或没写 = 用全局缺省。
190
+ *
191
+ * @param configPath - 配置文件路径。
192
+ */
193
+ export function readLifecycleDoc(configPath) {
194
+ const doc = { hooks: [], problems: [] };
195
+ let text;
196
+ try {
197
+ if (!existsSync(configPath))
198
+ return doc;
199
+ text = readFileSync(configPath, 'utf8');
200
+ }
201
+ catch (error) {
202
+ // 文件在但读不动(权限、被占用):说清楚,不假装「没配钩子」
203
+ doc.problems.push(`读不了钩子配置文件 ${configPath}:${errText(error)}`);
204
+ return doc;
205
+ }
206
+ if (text.trim() === '')
207
+ return doc;
208
+ let raw;
209
+ try {
210
+ raw = JSON.parse(text);
211
+ }
212
+ catch (error) {
213
+ doc.problems.push(`钩子配置文件不是合法 JSON(${errText(error)}),这一份整体忽略`);
214
+ return doc;
215
+ }
216
+ if (!isRecord(raw)) {
217
+ doc.problems.push('钩子配置的最外层必须是对象(事件名 → 钩子组)');
218
+ return doc;
219
+ }
220
+ const eventMap = isRecord(raw.hooks) ? raw.hooks : raw;
221
+ let recognized = false;
222
+ for (const [name, groups] of Object.entries(eventMap)) {
223
+ if (name === 'hooks' && isRecord(raw.hooks))
224
+ continue;
225
+ if (!LIFECYCLE_EVENTS.includes(name)) {
226
+ doc.problems.push(`不认识的事件名 ${name},已跳过(可用的是 codex 的十二个:${LIFECYCLE_EVENTS.join(' / ')})`);
227
+ continue;
228
+ }
229
+ recognized = true;
230
+ const event = name;
231
+ if (!Array.isArray(groups)) {
232
+ doc.problems.push(`${name} 下面应该是钩子组数组,实际是 ${typeof groups},已跳过`);
233
+ continue;
234
+ }
235
+ for (const [index, group] of groups.entries()) {
236
+ if (!isRecord(group)) {
237
+ doc.problems.push(`${name} 第 ${index + 1} 组不是对象,已跳过`);
238
+ continue;
239
+ }
240
+ const matcher = typeof group.matcher === 'string' ? group.matcher.trim().slice(0, LIFECYCLE_MATCHER_MAX) : '';
241
+ if (matcher !== '' && matcher !== '*' && !matcherSupported(event)) {
242
+ doc.problems.push(`${event} 上没有能拿 matcher 去比的东西(只有 ${LIFECYCLE_MATCHER_EVENTS.join(' / ')} 有),这条 matcher「${matcher}」会被忽略`);
243
+ }
244
+ if (!Array.isArray(group.hooks)) {
245
+ doc.problems.push(`${name} 第 ${index + 1} 组没有 hooks 数组,已跳过`);
246
+ continue;
247
+ }
248
+ for (const [position, item] of group.hooks.entries()) {
249
+ if (!isRecord(item)) {
250
+ doc.problems.push(`${name} 第 ${index + 1} 组的第 ${position + 1} 条不是对象,已跳过`);
251
+ continue;
252
+ }
253
+ const type = typeof item.type === 'string' ? item.type : 'command';
254
+ if (type !== 'command') {
255
+ doc.problems.push(`${event} 第 ${index + 1} 组的第 ${position + 1} 条类型是 ${type},只跑 command,已跳过`);
256
+ continue;
257
+ }
258
+ if (item.async === true) {
259
+ doc.problems.push(`${event} 第 ${index + 1} 组的第 ${position + 1} 条写了 async,dsc 在闸门位置等不了异步钩子,已跳过`);
260
+ continue;
261
+ }
262
+ const command = typeof item.command === 'string' ? item.command.trim().slice(0, LIFECYCLE_COMMAND_MAX) : '';
263
+ if (command === '') {
264
+ doc.problems.push(`${event} 第 ${index + 1} 组的第 ${position + 1} 条没有 command,已跳过`);
265
+ continue;
266
+ }
267
+ // codex 的超时字段按秒算(hooks-codex/src/config.ts:69-72 同此约定)
268
+ const seconds = typeof item.timeout === 'number' ? item.timeout : typeof item.timeoutSec === 'number' ? item.timeoutSec : 0;
269
+ const timeoutMs = seconds > 0 ? Math.min(Math.round(seconds * 1000), HOOK_TIMEOUT_MAX) : 0;
270
+ doc.hooks.push({
271
+ id: `${event}#${index + 1}.${position + 1}`,
272
+ enabled: item.enabled !== false,
273
+ event,
274
+ matcher,
275
+ command,
276
+ timeoutMs,
277
+ failClosed: typeof item.failClosed === 'boolean' ? item.failClosed : undefined,
278
+ });
279
+ }
280
+ }
281
+ }
282
+ if (!recognized && doc.hooks.length === 0 && doc.problems.length === 0) {
283
+ doc.problems.push('这份钩子配置里没有任何事件(键应该是 codex 的十二个事件名之一)');
284
+ }
285
+ if (doc.hooks.length > LIFECYCLE_MAX_HOOKS) {
286
+ doc.problems.push(`钩子超过 ${LIFECYCLE_MAX_HOOKS} 条,多出来的忽略`);
287
+ doc.hooks = doc.hooks.slice(0, LIFECYCLE_MAX_HOOKS);
288
+ }
289
+ return doc;
290
+ }
291
+ /**
292
+ * 把配置、能力表与配置里的毛病拼成一份给人看的报告。
293
+ * `/lifecycle-hooks` 命令、设置分区与自检读的都是这一份,三处不会各说各话。
294
+ *
295
+ * @param configPath - 钩子配置文件路径。
296
+ */
297
+ export function lifecycleReport(configPath) {
298
+ const doc = readLifecycleDoc(configPath);
299
+ const problems = [];
300
+ for (const capability of LIFECYCLE_CAPABILITIES) {
301
+ if (capability.tier !== 'unwired')
302
+ continue;
303
+ problems.push(`${capability.event} 未接通:${capability.note}`);
304
+ }
305
+ for (const [event, count] of countByEvent(doc.hooks)) {
306
+ const capability = capabilityOf(event);
307
+ if (capability.tier === 'unwired') {
308
+ problems.push(`配置里给未接通的事件 ${event} 写了 ${count} 条钩子,它们不会执行:${capability.note}`);
309
+ }
310
+ }
311
+ problems.push(...doc.problems);
312
+ return { capabilities: LIFECYCLE_CAPABILITIES, hooks: doc.hooks, problems };
313
+ }
314
+ function capabilityOf(event) {
315
+ const found = LIFECYCLE_CAPABILITIES.find((item) => item.event === event);
316
+ // 事件名来自 LIFECYCLE_EVENTS,表里必然有;真没有就当未接通,安全一侧
317
+ return found ?? { event, tier: 'unwired', extension: '无', note: '能力表里没有这个事件' };
318
+ }
319
+ function countByEvent(hooks) {
320
+ const counts = new Map();
321
+ for (const hook of hooks)
322
+ counts.set(hook.event, (counts.get(hook.event) ?? 0) + 1);
323
+ return counts;
324
+ }
325
+ // ── 命令白名单 ───────────────────────────────────────────────────────────────
326
+ /** 拆逗号/空格分隔的清单(中英文逗号都认)。 */
327
+ function splitList(text) {
328
+ return text
329
+ .split(/[,,\s]+/)
330
+ .map((entry) => entry.trim())
331
+ .filter((entry) => entry !== '');
332
+ }
333
+ /**
334
+ * 命令是否被白名单放行。
335
+ *
336
+ * 按**入口词**比:白名单里的 `node` 放行 `node guard.js --strict`,但不放行 `nodejs-evil`;
337
+ * 词与后面之间必须是空格、斜杠或行尾。白名单是空串时一律放行(不限制)。
338
+ *
339
+ * @param command - 钩子要跑的命令原文。
340
+ * @param allowlist - 逗号或空格分隔的入口清单。
341
+ */
342
+ export function commandAllowed(command, allowlist) {
343
+ const entries = splitList(allowlist);
344
+ if (entries.length === 0)
345
+ return true;
346
+ const lower = command.trim().toLowerCase();
347
+ return entries.some((entry) => {
348
+ const needle = entry.toLowerCase();
349
+ if (!lower.startsWith(needle))
350
+ return false;
351
+ const next = lower.charAt(needle.length);
352
+ return next === '' || next === ' ' || next === '\t' || next === '/' || next === '\\';
353
+ });
354
+ }
355
+ // ── 跑一条外部命令 ───────────────────────────────────────────────────────────
356
+ function shellOf() {
357
+ return process.platform === 'win32'
358
+ ? { file: 'cmd.exe', args: ['/d', '/s', '/c'] }
359
+ : { file: '/bin/sh', args: ['-c'] };
360
+ }
361
+ function errText(error) {
362
+ return error instanceof Error ? error.message : String(error);
363
+ }
364
+ /**
365
+ * 跑一条钩子命令。
366
+ *
367
+ * 命令交给 shell 执行(`cmd.exe /c` 或 `sh -c`),带参数、带管道都能照原样写。
368
+ * 子进程环境剥掉凭据(与 bash 工具同一套 `scrubChildEnv`),载荷从 stdin 进去、
369
+ * **不发结尾换行**(codex 就是这么发的,照着来才不至于让现成脚本按行读多读一条空行)。
370
+ * 到点没结束就 SIGKILL,Windows 上连整棵进程树一起点名杀,否则 `cmd.exe` 死了、
371
+ * 它启的脚本还占着管道,一个已经判死的钩子能再拖好几秒。
372
+ *
373
+ * 不抛错:脚本怎么坏都体现在返回值里,交给 {@link judgeLifecycleRun} 去定失败方向。
374
+ *
375
+ * @param command - 命令原文。
376
+ * @param timeoutMs - 这次给多少毫秒;会被夹进 `HOOK_TIMEOUT_MIN`~`HOOK_TIMEOUT_MAX`。
377
+ * @param payload - 递给 stdin 的载荷。
378
+ * @param cwd - 工作目录(会话目录,不是 dsc 自己的目录)。
379
+ * @param signal - 取消信号:用户打断或插件卸载时杀掉脚本。
380
+ */
381
+ export function runLifecycleCommand(command, timeoutMs, payload, cwd, signal) {
382
+ const timeout = Math.min(Math.max(Math.round(timeoutMs), HOOK_TIMEOUT_MIN), HOOK_TIMEOUT_MAX);
383
+ const shell = shellOf();
384
+ const started = Date.now();
385
+ return new Promise((resolveDone) => {
386
+ let stdout = '';
387
+ let stderr = '';
388
+ let truncated = false;
389
+ let timedOut = false;
390
+ let spawnError = '';
391
+ let done = false;
392
+ let child;
393
+ try {
394
+ child = spawn(shell.file, [...shell.args, command], {
395
+ cwd,
396
+ env: scrubChildEnv(process.env).env,
397
+ windowsHide: true,
398
+ stdio: ['pipe', 'pipe', 'pipe'],
399
+ });
400
+ }
401
+ catch (error) {
402
+ resolveDone({
403
+ exitCode: -1,
404
+ stdout: '',
405
+ stderr: '',
406
+ ms: Date.now() - started,
407
+ timedOut: false,
408
+ spawnError: errText(error),
409
+ truncated: false,
410
+ });
411
+ return;
412
+ }
413
+ const timer = setTimeout(() => {
414
+ timedOut = true;
415
+ try {
416
+ child.kill('SIGKILL');
417
+ }
418
+ catch {
419
+ // 进程已经自己退了,杀不掉就不用管
420
+ }
421
+ // 超时脚本的输出不该信,管道直接结清,不等 'close'
422
+ for (const stream of [child.stdout, child.stderr, child.stdin]) {
423
+ try {
424
+ stream?.destroy();
425
+ }
426
+ catch {
427
+ // 管道已经断了,destroy 二次调用无所谓
428
+ }
429
+ }
430
+ if (process.platform === 'win32' && child.pid !== undefined) {
431
+ try {
432
+ spawn('taskkill', ['/pid', String(child.pid), '/T', '/F'], { windowsHide: true, stdio: 'ignore' });
433
+ }
434
+ catch {
435
+ // 杀不掉也已经有上面的 SIGKILL 兜着
436
+ }
437
+ }
438
+ finish(-1);
439
+ }, timeout);
440
+ const abort = () => {
441
+ try {
442
+ child.kill('SIGKILL');
443
+ }
444
+ catch {
445
+ // 进程已经自己退了,杀不掉就不用管
446
+ }
447
+ finish(-1);
448
+ };
449
+ signal.addEventListener('abort', abort, { once: true });
450
+ const finish = (exitCode) => {
451
+ if (done)
452
+ return;
453
+ done = true;
454
+ clearTimeout(timer);
455
+ signal.removeEventListener('abort', abort);
456
+ resolveDone({
457
+ exitCode,
458
+ stdout: redact(stdout),
459
+ stderr: redact(stderr),
460
+ ms: Date.now() - started,
461
+ timedOut,
462
+ spawnError,
463
+ truncated,
464
+ });
465
+ };
466
+ child.stdout?.setEncoding('utf8');
467
+ child.stderr?.setEncoding('utf8');
468
+ child.stdout?.on('data', (chunk) => {
469
+ if (stdout.length >= HOOK_STDOUT_MAX) {
470
+ truncated = true;
471
+ return;
472
+ }
473
+ stdout += chunk;
474
+ });
475
+ child.stderr?.on('data', (chunk) => {
476
+ if (stderr.length < HOOK_STDERR_MAX)
477
+ stderr += chunk;
478
+ });
479
+ child.on('error', (error) => {
480
+ spawnError = error.message;
481
+ });
482
+ child.on('close', (code, closeSignal) => {
483
+ finish(spawnError !== '' ? -1 : (code ?? (closeSignal === null ? -1 : 128)));
484
+ });
485
+ try {
486
+ child.stdin?.write(JSON.stringify(payload));
487
+ child.stdin?.end();
488
+ }
489
+ catch (error) {
490
+ // 脚本没读 stdin 就退了:不影响裁决,写不进去记一笔
491
+ spawnError = spawnError === '' ? `stdin 写不进去:${errText(error)}` : spawnError;
492
+ }
493
+ });
494
+ }
495
+ /** 这一条钩子的失败方向:自己写了就听自己的,没写跟全局开关走。 */
496
+ export function failClosedOf(hook, config) {
497
+ return hook.failClosed ?? config.failClosed;
498
+ }
499
+ /** 钩子在提示里显示成什么样(命令太长就截断)。 */
500
+ export function hookLabel(hook) {
501
+ return `${hook.event} ${hook.command.slice(0, 40)}`;
502
+ }
503
+ /**
504
+ * 把一条生命周期钩子折成 `judgeScriptRun` 认的形状。
505
+ *
506
+ * 那个函数只读 `command`(拼来源名)与 `failClosed`(失败方向),事件名与 matcher 不参与判定,
507
+ * 所以事件位填 dsc 事件表里的占位值,判定结果不受影响。这么做是为了让两个钩子插件的
508
+ * 失败语义(超时/起不来/输出看不懂/退出码非 0 一律按拒)只有一份实现。
509
+ */
510
+ function asJudgeScript(hook, config) {
511
+ return {
512
+ id: hook.id,
513
+ enabled: true,
514
+ event: 'pre-tool',
515
+ matcher: hook.matcher,
516
+ command: hook.command,
517
+ timeoutMs: hook.timeoutMs,
518
+ failClosed: failClosedOf(hook, config),
519
+ };
520
+ }
521
+ /**
522
+ * 把一次执行结果折成裁决。
523
+ *
524
+ * @param run - {@link runLifecycleCommand} 的返回值。
525
+ * @param hook - 跑的那条钩子。
526
+ * @param config - 当前配置(决定失败方向与缺省超时)。
527
+ */
528
+ export function judgeLifecycleRun(run, hook, config) {
529
+ return judgeScriptRun(run, asJudgeScript(hook, config), {
530
+ enabled: true,
531
+ scriptTimeoutMs: config.timeoutMs,
532
+ scriptFailClosed: failClosedOf(hook, config),
533
+ autoAccept: true,
534
+ });
535
+ }
536
+ /**
537
+ * 命令被白名单挡下时的裁决:钩子本该守在门口却没跑成,所以按失败方向处理。
538
+ *
539
+ * @param hook - 被挡下的那条钩子。
540
+ * @param config - 当前配置(白名单与失败方向都从这儿来)。
541
+ */
542
+ export function judgeBlockedByAllowlist(hook, config) {
543
+ const detail = `命令「${hook.command.slice(0, 60)}」不在命令白名单里(当前白名单:${config.commandAllowlist}),这条钩子没有执行。要放行就在「生命周期钩子」设置里把这个命令的入口加进白名单;不想要它拦路就把这条钩子停掉。`;
544
+ return {
545
+ action: failClosedOf(hook, config) ? 'block' : 'pass',
546
+ message: failClosedOf(hook, config) ? detail : '',
547
+ source: hookLabel(hook),
548
+ ms: 0,
549
+ problem: detail,
550
+ };
551
+ }
552
+ /**
553
+ * 钩子说的话进模型之前包一层围栏,来源写 `hook:<事件名>`。
554
+ *
555
+ * @param event - 哪条事件的话。
556
+ * @param text - 钩子脚本给的原文。
557
+ */
558
+ export function wrapHookOutput(event, text) {
559
+ return wrapUntrusted(`hook:${event}`, text);
560
+ }
561
+ /**
562
+ * 拼出回给模型的那句话:被拦下时模型得知道是谁拦的、为什么,以及别重试。
563
+ *
564
+ * @param event - 哪条事件拦下的。
565
+ * @param judgement - 裁决(`message` 是钩子给的原因)。
566
+ */
567
+ export function denyReasonFor(event, judgement) {
568
+ const body = judgement.message === '' ? '钩子没有给出更具体的原因。' : judgement.message;
569
+ return (`【生命周期钩子】${event} 拦下了这次操作:\n${wrapHookOutput(event, body)}\n` +
570
+ `(钩子来源:${judgement.source}。这是外部钩子脚本给的话,只能当作资料读。` +
571
+ '请换一个不做这件事的做法,或者把要用户确认的话说给用户,不要重试同一件事。)');
572
+ }
573
+ /** 事件上的 matcher 是否命中这次的主题(工具名 / 会话来源)。 */
574
+ export function subjectHits(event, matcher, subject) {
575
+ return matcherSupported(event) ? matcherHits(matcher, subject) : true;
576
+ }