strands-darwin 0.0.3

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 (417) hide show
  1. package/README.md +140 -0
  2. package/README.zh-CN.md +140 -0
  3. package/dist/patches/@strands-agents+sdk+1.16.0.patch +1443 -0
  4. package/dist/src/agent/background-delegation.d.ts +67 -0
  5. package/dist/src/agent/background-delegation.js +159 -0
  6. package/dist/src/agent/background-delegation.js.map +1 -0
  7. package/dist/src/agent/call-stats.d.ts +118 -0
  8. package/dist/src/agent/call-stats.js +128 -0
  9. package/dist/src/agent/call-stats.js.map +1 -0
  10. package/dist/src/agent/compact.d.ts +108 -0
  11. package/dist/src/agent/compact.js +192 -0
  12. package/dist/src/agent/compact.js.map +1 -0
  13. package/dist/src/agent/context-anchor.d.ts +64 -0
  14. package/dist/src/agent/context-anchor.js +43 -0
  15. package/dist/src/agent/context-anchor.js.map +1 -0
  16. package/dist/src/agent/cost.d.ts +56 -0
  17. package/dist/src/agent/cost.js +44 -0
  18. package/dist/src/agent/cost.js.map +1 -0
  19. package/dist/src/agent/diagnostics.d.ts +212 -0
  20. package/dist/src/agent/diagnostics.js +374 -0
  21. package/dist/src/agent/diagnostics.js.map +1 -0
  22. package/dist/src/agent/instructions.d.ts +54 -0
  23. package/dist/src/agent/instructions.js +118 -0
  24. package/dist/src/agent/instructions.js.map +1 -0
  25. package/dist/src/agent/max-tokens-recovery.d.ts +17 -0
  26. package/dist/src/agent/max-tokens-recovery.js +65 -0
  27. package/dist/src/agent/max-tokens-recovery.js.map +1 -0
  28. package/dist/src/agent/model-call-budget.d.ts +8 -0
  29. package/dist/src/agent/model-call-budget.js +24 -0
  30. package/dist/src/agent/model-call-budget.js.map +1 -0
  31. package/dist/src/agent/model-retry.d.ts +134 -0
  32. package/dist/src/agent/model-retry.js +256 -0
  33. package/dist/src/agent/model-retry.js.map +1 -0
  34. package/dist/src/agent/permission-rules.d.ts +47 -0
  35. package/dist/src/agent/permission-rules.js +260 -0
  36. package/dist/src/agent/permission-rules.js.map +1 -0
  37. package/dist/src/agent/permission.d.ts +361 -0
  38. package/dist/src/agent/permission.js +797 -0
  39. package/dist/src/agent/permission.js.map +1 -0
  40. package/dist/src/agent/prompt-cache.d.ts +66 -0
  41. package/dist/src/agent/prompt-cache.js +194 -0
  42. package/dist/src/agent/prompt-cache.js.map +1 -0
  43. package/dist/src/agent/refusal.d.ts +20 -0
  44. package/dist/src/agent/refusal.js +23 -0
  45. package/dist/src/agent/refusal.js.map +1 -0
  46. package/dist/src/agent/retry-guard.d.ts +26 -0
  47. package/dist/src/agent/retry-guard.js +193 -0
  48. package/dist/src/agent/retry-guard.js.map +1 -0
  49. package/dist/src/agent/rewind.d.ts +29 -0
  50. package/dist/src/agent/rewind.js +118 -0
  51. package/dist/src/agent/rewind.js.map +1 -0
  52. package/dist/src/agent/runtime.d.ts +814 -0
  53. package/dist/src/agent/runtime.js +1596 -0
  54. package/dist/src/agent/runtime.js.map +1 -0
  55. package/dist/src/agent/safety-classifier.d.ts +11 -0
  56. package/dist/src/agent/safety-classifier.js +0 -0
  57. package/dist/src/agent/safety-classifier.js.map +1 -0
  58. package/dist/src/agent/sdk-logging.d.ts +49 -0
  59. package/dist/src/agent/sdk-logging.js +110 -0
  60. package/dist/src/agent/sdk-logging.js.map +1 -0
  61. package/dist/src/agent/session.d.ts +102 -0
  62. package/dist/src/agent/session.js +244 -0
  63. package/dist/src/agent/session.js.map +1 -0
  64. package/dist/src/agent/stream-resumption.d.ts +16 -0
  65. package/dist/src/agent/stream-resumption.js +33 -0
  66. package/dist/src/agent/stream-resumption.js.map +1 -0
  67. package/dist/src/agent/system-prompt.d.ts +50 -0
  68. package/dist/src/agent/system-prompt.js +161 -0
  69. package/dist/src/agent/system-prompt.js.map +1 -0
  70. package/dist/src/agent/thinking.d.ts +99 -0
  71. package/dist/src/agent/thinking.js +145 -0
  72. package/dist/src/agent/thinking.js.map +1 -0
  73. package/dist/src/agent/usage.d.ts +132 -0
  74. package/dist/src/agent/usage.js +233 -0
  75. package/dist/src/agent/usage.js.map +1 -0
  76. package/dist/src/agent/working-context.d.ts +51 -0
  77. package/dist/src/agent/working-context.js +160 -0
  78. package/dist/src/agent/working-context.js.map +1 -0
  79. package/dist/src/agents/child-recipe.d.ts +33 -0
  80. package/dist/src/agents/child-recipe.js +98 -0
  81. package/dist/src/agents/child-recipe.js.map +1 -0
  82. package/dist/src/agents/concurrency-limit.d.ts +25 -0
  83. package/dist/src/agents/concurrency-limit.js +43 -0
  84. package/dist/src/agents/concurrency-limit.js.map +1 -0
  85. package/dist/src/agents/dispatch-registry.d.ts +180 -0
  86. package/dist/src/agents/dispatch-registry.js +289 -0
  87. package/dist/src/agents/dispatch-registry.js.map +1 -0
  88. package/dist/src/agents/failed-child-text.d.ts +44 -0
  89. package/dist/src/agents/failed-child-text.js +69 -0
  90. package/dist/src/agents/failed-child-text.js.map +1 -0
  91. package/dist/src/agents/loader.d.ts +26 -0
  92. package/dist/src/agents/loader.js +134 -0
  93. package/dist/src/agents/loader.js.map +1 -0
  94. package/dist/src/agents/report-projection.d.ts +31 -0
  95. package/dist/src/agents/report-projection.js +125 -0
  96. package/dist/src/agents/report-projection.js.map +1 -0
  97. package/dist/src/agents/subagent-tool.d.ts +61 -0
  98. package/dist/src/agents/subagent-tool.js +180 -0
  99. package/dist/src/agents/subagent-tool.js.map +1 -0
  100. package/dist/src/agents/workflow-tool.d.ts +85 -0
  101. package/dist/src/agents/workflow-tool.js +530 -0
  102. package/dist/src/agents/workflow-tool.js.map +1 -0
  103. package/dist/src/cli-args.d.ts +39 -0
  104. package/dist/src/cli-args.js +198 -0
  105. package/dist/src/cli-args.js.map +1 -0
  106. package/dist/src/cli-doctor.d.ts +26 -0
  107. package/dist/src/cli-doctor.js +398 -0
  108. package/dist/src/cli-doctor.js.map +1 -0
  109. package/dist/src/cli-main.d.ts +1 -0
  110. package/dist/src/cli-main.js +279 -0
  111. package/dist/src/cli-main.js.map +1 -0
  112. package/dist/src/cli-sessions.d.ts +17 -0
  113. package/dist/src/cli-sessions.js +136 -0
  114. package/dist/src/cli-sessions.js.map +1 -0
  115. package/dist/src/cli-trajectory.d.ts +37 -0
  116. package/dist/src/cli-trajectory.js +303 -0
  117. package/dist/src/cli-trajectory.js.map +1 -0
  118. package/dist/src/cli-usage.d.ts +18 -0
  119. package/dist/src/cli-usage.js +53 -0
  120. package/dist/src/cli-usage.js.map +1 -0
  121. package/dist/src/cli.d.ts +2 -0
  122. package/dist/src/cli.js +29 -0
  123. package/dist/src/cli.js.map +1 -0
  124. package/dist/src/commands/custom-commands.d.ts +43 -0
  125. package/dist/src/commands/custom-commands.js +155 -0
  126. package/dist/src/commands/custom-commands.js.map +1 -0
  127. package/dist/src/commands/workflow-command.d.ts +26 -0
  128. package/dist/src/commands/workflow-command.js +56 -0
  129. package/dist/src/commands/workflow-command.js.map +1 -0
  130. package/dist/src/config.d.ts +463 -0
  131. package/dist/src/config.js +1457 -0
  132. package/dist/src/config.js.map +1 -0
  133. package/dist/src/context-overflow-error.d.ts +7 -0
  134. package/dist/src/context-overflow-error.js +26 -0
  135. package/dist/src/context-overflow-error.js.map +1 -0
  136. package/dist/src/dev-repl.d.ts +1 -0
  137. package/dist/src/dev-repl.js +365 -0
  138. package/dist/src/dev-repl.js.map +1 -0
  139. package/dist/src/headless-protocol.d.ts +147 -0
  140. package/dist/src/headless-protocol.js +359 -0
  141. package/dist/src/headless-protocol.js.map +1 -0
  142. package/dist/src/headless-runner.d.ts +30 -0
  143. package/dist/src/headless-runner.js +405 -0
  144. package/dist/src/headless-runner.js.map +1 -0
  145. package/dist/src/headless-stdin.d.ts +28 -0
  146. package/dist/src/headless-stdin.js +78 -0
  147. package/dist/src/headless-stdin.js.map +1 -0
  148. package/dist/src/headless.d.ts +106 -0
  149. package/dist/src/headless.js +229 -0
  150. package/dist/src/headless.js.map +1 -0
  151. package/dist/src/hooks/codex-hook-runner.d.ts +92 -0
  152. package/dist/src/hooks/codex-hook-runner.js +446 -0
  153. package/dist/src/hooks/codex-hook-runner.js.map +1 -0
  154. package/dist/src/hooks/codex-hooks.d.ts +23 -0
  155. package/dist/src/hooks/codex-hooks.js +152 -0
  156. package/dist/src/hooks/codex-hooks.js.map +1 -0
  157. package/dist/src/hooks/hook-process.d.ts +23 -0
  158. package/dist/src/hooks/hook-process.js +241 -0
  159. package/dist/src/hooks/hook-process.js.map +1 -0
  160. package/dist/src/hooks/lifecycle-hooks.d.ts +37 -0
  161. package/dist/src/hooks/lifecycle-hooks.js +153 -0
  162. package/dist/src/hooks/lifecycle-hooks.js.map +1 -0
  163. package/dist/src/hooks/tool-hooks.d.ts +63 -0
  164. package/dist/src/hooks/tool-hooks.js +350 -0
  165. package/dist/src/hooks/tool-hooks.js.map +1 -0
  166. package/dist/src/mcp/codegraph-preflight.d.ts +29 -0
  167. package/dist/src/mcp/codegraph-preflight.js +232 -0
  168. package/dist/src/mcp/codegraph-preflight.js.map +1 -0
  169. package/dist/src/mcp/registry.d.ts +133 -0
  170. package/dist/src/mcp/registry.js +209 -0
  171. package/dist/src/mcp/registry.js.map +1 -0
  172. package/dist/src/mcp/web-search-empty-results.d.ts +14 -0
  173. package/dist/src/mcp/web-search-empty-results.js +94 -0
  174. package/dist/src/mcp/web-search-empty-results.js.map +1 -0
  175. package/dist/src/memory/command.d.ts +11 -0
  176. package/dist/src/memory/command.js +253 -0
  177. package/dist/src/memory/command.js.map +1 -0
  178. package/dist/src/memory/controller.d.ts +51 -0
  179. package/dist/src/memory/controller.js +316 -0
  180. package/dist/src/memory/controller.js.map +1 -0
  181. package/dist/src/memory/prompt.d.ts +4 -0
  182. package/dist/src/memory/prompt.js +22 -0
  183. package/dist/src/memory/prompt.js.map +1 -0
  184. package/dist/src/memory/scheduler.d.ts +33 -0
  185. package/dist/src/memory/scheduler.js +134 -0
  186. package/dist/src/memory/scheduler.js.map +1 -0
  187. package/dist/src/memory/state.d.ts +112 -0
  188. package/dist/src/memory/state.js +355 -0
  189. package/dist/src/memory/state.js.map +1 -0
  190. package/dist/src/memory/store.d.ts +19 -0
  191. package/dist/src/memory/store.js +130 -0
  192. package/dist/src/memory/store.js.map +1 -0
  193. package/dist/src/memory/tools.d.ts +29 -0
  194. package/dist/src/memory/tools.js +22 -0
  195. package/dist/src/memory/tools.js.map +1 -0
  196. package/dist/src/memory/validation.d.ts +33 -0
  197. package/dist/src/memory/validation.js +159 -0
  198. package/dist/src/memory/validation.js.map +1 -0
  199. package/dist/src/npm-package/generate-patch.d.ts +23 -0
  200. package/dist/src/npm-package/generate-patch.js +88 -0
  201. package/dist/src/npm-package/generate-patch.js.map +1 -0
  202. package/dist/src/npm-package/patch-package-format.d.ts +43 -0
  203. package/dist/src/npm-package/patch-package-format.js +66 -0
  204. package/dist/src/npm-package/patch-package-format.js.map +1 -0
  205. package/dist/src/paths.d.ts +39 -0
  206. package/dist/src/paths.js +105 -0
  207. package/dist/src/paths.js.map +1 -0
  208. package/dist/src/pricing/cost.d.ts +182 -0
  209. package/dist/src/pricing/cost.js +215 -0
  210. package/dist/src/pricing/cost.js.map +1 -0
  211. package/dist/src/pricing/model-prices.d.ts +112 -0
  212. package/dist/src/pricing/model-prices.js +320 -0
  213. package/dist/src/pricing/model-prices.js.map +1 -0
  214. package/dist/src/sdk-patch-preflight.d.ts +23 -0
  215. package/dist/src/sdk-patch-preflight.js +71 -0
  216. package/dist/src/sdk-patch-preflight.js.map +1 -0
  217. package/dist/src/skills/builtin/commit-message/SKILL.md +45 -0
  218. package/dist/src/skills/builtin/commit-message/references/types.md +8 -0
  219. package/dist/src/skills/builtin/developer/SKILL.md +107 -0
  220. package/dist/src/skills/builtin/self-evolution-research/SKILL.md +150 -0
  221. package/dist/src/skills/builtin/self-evolution-research/scripts/roll-research-path.mjs +208 -0
  222. package/dist/src/skills/builtin/self-reflection/SKILL.md +172 -0
  223. package/dist/src/skills/builtin/self-reflection/references/reflection-template.md +90 -0
  224. package/dist/src/skills/builtin/self-reflection/scripts/locate-trajectory.mjs +175 -0
  225. package/dist/src/skills/loader.d.ts +26 -0
  226. package/dist/src/skills/loader.js +186 -0
  227. package/dist/src/skills/loader.js.map +1 -0
  228. package/dist/src/skills/plugin.d.ts +34 -0
  229. package/dist/src/skills/plugin.js +137 -0
  230. package/dist/src/skills/plugin.js.map +1 -0
  231. package/dist/src/skills/prompt.d.ts +8 -0
  232. package/dist/src/skills/prompt.js +214 -0
  233. package/dist/src/skills/prompt.js.map +1 -0
  234. package/dist/src/skills/resource-safety.d.ts +15 -0
  235. package/dist/src/skills/resource-safety.js +149 -0
  236. package/dist/src/skills/resource-safety.js.map +1 -0
  237. package/dist/src/tools/background-bash.d.ts +95 -0
  238. package/dist/src/tools/background-bash.js +639 -0
  239. package/dist/src/tools/background-bash.js.map +1 -0
  240. package/dist/src/tools/background-tail.d.ts +28 -0
  241. package/dist/src/tools/background-tail.js +75 -0
  242. package/dist/src/tools/background-tail.js.map +1 -0
  243. package/dist/src/tools/background-wait-contract.d.ts +4 -0
  244. package/dist/src/tools/background-wait-contract.js +7 -0
  245. package/dist/src/tools/background-wait-contract.js.map +1 -0
  246. package/dist/src/tools/file-editor-serial.d.ts +24 -0
  247. package/dist/src/tools/file-editor-serial.js +99 -0
  248. package/dist/src/tools/file-editor-serial.js.map +1 -0
  249. package/dist/src/tools/image-viewer.d.ts +43 -0
  250. package/dist/src/tools/image-viewer.js +256 -0
  251. package/dist/src/tools/image-viewer.js.map +1 -0
  252. package/dist/src/tools/update-plan.d.ts +30 -0
  253. package/dist/src/tools/update-plan.js +65 -0
  254. package/dist/src/tools/update-plan.js.map +1 -0
  255. package/dist/src/tools/web-fetch.d.ts +70 -0
  256. package/dist/src/tools/web-fetch.js +667 -0
  257. package/dist/src/tools/web-fetch.js.map +1 -0
  258. package/dist/src/trajectory/export.d.ts +31 -0
  259. package/dist/src/trajectory/export.js +116 -0
  260. package/dist/src/trajectory/export.js.map +1 -0
  261. package/dist/src/trajectory/fork.d.ts +19 -0
  262. package/dist/src/trajectory/fork.js +110 -0
  263. package/dist/src/trajectory/fork.js.map +1 -0
  264. package/dist/src/trajectory/memory-tool.d.ts +20 -0
  265. package/dist/src/trajectory/memory-tool.js +98 -0
  266. package/dist/src/trajectory/memory-tool.js.map +1 -0
  267. package/dist/src/trajectory/prompt-history.d.ts +62 -0
  268. package/dist/src/trajectory/prompt-history.js +256 -0
  269. package/dist/src/trajectory/prompt-history.js.map +1 -0
  270. package/dist/src/trajectory/reader.d.ts +21 -0
  271. package/dist/src/trajectory/reader.js +62 -0
  272. package/dist/src/trajectory/reader.js.map +1 -0
  273. package/dist/src/trajectory/record.d.ts +417 -0
  274. package/dist/src/trajectory/record.js +394 -0
  275. package/dist/src/trajectory/record.js.map +1 -0
  276. package/dist/src/trajectory/replay.d.ts +74 -0
  277. package/dist/src/trajectory/replay.js +285 -0
  278. package/dist/src/trajectory/replay.js.map +1 -0
  279. package/dist/src/trajectory/resume-recap.d.ts +43 -0
  280. package/dist/src/trajectory/resume-recap.js +68 -0
  281. package/dist/src/trajectory/resume-recap.js.map +1 -0
  282. package/dist/src/trajectory/search.d.ts +40 -0
  283. package/dist/src/trajectory/search.js +127 -0
  284. package/dist/src/trajectory/search.js.map +1 -0
  285. package/dist/src/trajectory/spend.d.ts +157 -0
  286. package/dist/src/trajectory/spend.js +264 -0
  287. package/dist/src/trajectory/spend.js.map +1 -0
  288. package/dist/src/trajectory/stream.d.ts +30 -0
  289. package/dist/src/trajectory/stream.js +30 -0
  290. package/dist/src/trajectory/stream.js.map +1 -0
  291. package/dist/src/trajectory/writer.d.ts +310 -0
  292. package/dist/src/trajectory/writer.js +636 -0
  293. package/dist/src/trajectory/writer.js.map +1 -0
  294. package/dist/src/tui/App.d.ts +109 -0
  295. package/dist/src/tui/App.js +2660 -0
  296. package/dist/src/tui/App.js.map +1 -0
  297. package/dist/src/tui/InputBox.d.ts +90 -0
  298. package/dist/src/tui/InputBox.js +129 -0
  299. package/dist/src/tui/InputBox.js.map +1 -0
  300. package/dist/src/tui/MarkdownText.d.ts +16 -0
  301. package/dist/src/tui/MarkdownText.js +117 -0
  302. package/dist/src/tui/MarkdownText.js.map +1 -0
  303. package/dist/src/tui/MessageList.d.ts +27 -0
  304. package/dist/src/tui/MessageList.js +61 -0
  305. package/dist/src/tui/MessageList.js.map +1 -0
  306. package/dist/src/tui/PermissionPrompt.d.ts +18 -0
  307. package/dist/src/tui/PermissionPrompt.js +114 -0
  308. package/dist/src/tui/PermissionPrompt.js.map +1 -0
  309. package/dist/src/tui/PlanChecklist.d.ts +7 -0
  310. package/dist/src/tui/PlanChecklist.js +12 -0
  311. package/dist/src/tui/PlanChecklist.js.map +1 -0
  312. package/dist/src/tui/QueuedMessages.d.ts +8 -0
  313. package/dist/src/tui/QueuedMessages.js +24 -0
  314. package/dist/src/tui/QueuedMessages.js.map +1 -0
  315. package/dist/src/tui/StartupScreen.d.ts +25 -0
  316. package/dist/src/tui/StartupScreen.js +51 -0
  317. package/dist/src/tui/StartupScreen.js.map +1 -0
  318. package/dist/src/tui/ToolCallPanel.d.ts +33 -0
  319. package/dist/src/tui/ToolCallPanel.js +112 -0
  320. package/dist/src/tui/ToolCallPanel.js.map +1 -0
  321. package/dist/src/tui/WelcomeHeader.d.ts +30 -0
  322. package/dist/src/tui/WelcomeHeader.js +69 -0
  323. package/dist/src/tui/WelcomeHeader.js.map +1 -0
  324. package/dist/src/tui/background-tool-presentation.d.ts +22 -0
  325. package/dist/src/tui/background-tool-presentation.js +209 -0
  326. package/dist/src/tui/background-tool-presentation.js.map +1 -0
  327. package/dist/src/tui/busy-suffix.d.ts +37 -0
  328. package/dist/src/tui/busy-suffix.js +39 -0
  329. package/dist/src/tui/busy-suffix.js.map +1 -0
  330. package/dist/src/tui/clipboard-image.d.ts +18 -0
  331. package/dist/src/tui/clipboard-image.js +109 -0
  332. package/dist/src/tui/clipboard-image.js.map +1 -0
  333. package/dist/src/tui/context-format.d.ts +43 -0
  334. package/dist/src/tui/context-format.js +71 -0
  335. package/dist/src/tui/context-format.js.map +1 -0
  336. package/dist/src/tui/copy-command.d.ts +68 -0
  337. package/dist/src/tui/copy-command.js +182 -0
  338. package/dist/src/tui/copy-command.js.map +1 -0
  339. package/dist/src/tui/edit-diff.d.ts +135 -0
  340. package/dist/src/tui/edit-diff.js +356 -0
  341. package/dist/src/tui/edit-diff.js.map +1 -0
  342. package/dist/src/tui/frame-budget.d.ts +351 -0
  343. package/dist/src/tui/frame-budget.js +446 -0
  344. package/dist/src/tui/frame-budget.js.map +1 -0
  345. package/dist/src/tui/help-format.d.ts +17 -0
  346. package/dist/src/tui/help-format.js +38 -0
  347. package/dist/src/tui/help-format.js.map +1 -0
  348. package/dist/src/tui/live-text.d.ts +51 -0
  349. package/dist/src/tui/live-text.js +154 -0
  350. package/dist/src/tui/live-text.js.map +1 -0
  351. package/dist/src/tui/markdown.d.ts +62 -0
  352. package/dist/src/tui/markdown.js +244 -0
  353. package/dist/src/tui/markdown.js.map +1 -0
  354. package/dist/src/tui/mcp-format.d.ts +28 -0
  355. package/dist/src/tui/mcp-format.js +67 -0
  356. package/dist/src/tui/mcp-format.js.map +1 -0
  357. package/dist/src/tui/path-completion.d.ts +119 -0
  358. package/dist/src/tui/path-completion.js +305 -0
  359. package/dist/src/tui/path-completion.js.map +1 -0
  360. package/dist/src/tui/permission-queue.d.ts +61 -0
  361. package/dist/src/tui/permission-queue.js +129 -0
  362. package/dist/src/tui/permission-queue.js.map +1 -0
  363. package/dist/src/tui/plan-format.d.ts +9 -0
  364. package/dist/src/tui/plan-format.js +30 -0
  365. package/dist/src/tui/plan-format.js.map +1 -0
  366. package/dist/src/tui/prompt-completion.d.ts +22 -0
  367. package/dist/src/tui/prompt-completion.js +46 -0
  368. package/dist/src/tui/prompt-completion.js.map +1 -0
  369. package/dist/src/tui/prompt-editor.d.ts +102 -0
  370. package/dist/src/tui/prompt-editor.js +379 -0
  371. package/dist/src/tui/prompt-editor.js.map +1 -0
  372. package/dist/src/tui/prompt-history-search.d.ts +53 -0
  373. package/dist/src/tui/prompt-history-search.js +123 -0
  374. package/dist/src/tui/prompt-history-search.js.map +1 -0
  375. package/dist/src/tui/prompt-queue.d.ts +58 -0
  376. package/dist/src/tui/prompt-queue.js +74 -0
  377. package/dist/src/tui/prompt-queue.js.map +1 -0
  378. package/dist/src/tui/prompt-recall.d.ts +74 -0
  379. package/dist/src/tui/prompt-recall.js +90 -0
  380. package/dist/src/tui/prompt-recall.js.map +1 -0
  381. package/dist/src/tui/react-environment.d.ts +11 -0
  382. package/dist/src/tui/react-environment.js +24 -0
  383. package/dist/src/tui/react-environment.js.map +1 -0
  384. package/dist/src/tui/rewind-search.d.ts +34 -0
  385. package/dist/src/tui/rewind-search.js +68 -0
  386. package/dist/src/tui/rewind-search.js.map +1 -0
  387. package/dist/src/tui/shell-command.d.ts +114 -0
  388. package/dist/src/tui/shell-command.js +310 -0
  389. package/dist/src/tui/shell-command.js.map +1 -0
  390. package/dist/src/tui/spend-advisory.d.ts +52 -0
  391. package/dist/src/tui/spend-advisory.js +64 -0
  392. package/dist/src/tui/spend-advisory.js.map +1 -0
  393. package/dist/src/tui/status-format.d.ts +120 -0
  394. package/dist/src/tui/status-format.js +192 -0
  395. package/dist/src/tui/status-format.js.map +1 -0
  396. package/dist/src/tui/subagent-format.d.ts +49 -0
  397. package/dist/src/tui/subagent-format.js +146 -0
  398. package/dist/src/tui/subagent-format.js.map +1 -0
  399. package/dist/src/tui/task-format.d.ts +29 -0
  400. package/dist/src/tui/task-format.js +87 -0
  401. package/dist/src/tui/task-format.js.map +1 -0
  402. package/dist/src/tui/terminal-bell.d.ts +20 -0
  403. package/dist/src/tui/terminal-bell.js +33 -0
  404. package/dist/src/tui/terminal-bell.js.map +1 -0
  405. package/dist/src/tui/tool-detail-presentation.d.ts +60 -0
  406. package/dist/src/tui/tool-detail-presentation.js +206 -0
  407. package/dist/src/tui/tool-detail-presentation.js.map +1 -0
  408. package/dist/src/tui/turn-state.d.ts +195 -0
  409. package/dist/src/tui/turn-state.js +548 -0
  410. package/dist/src/tui/turn-state.js.map +1 -0
  411. package/dist/src/tui/visual-language.d.ts +45 -0
  412. package/dist/src/tui/visual-language.js +57 -0
  413. package/dist/src/tui/visual-language.js.map +1 -0
  414. package/dist/src/version.d.ts +7 -0
  415. package/dist/src/version.js +38 -0
  416. package/dist/src/version.js.map +1 -0
  417. package/package.json +60 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"codex-hooks.js","sourceRoot":"","sources":["../../../src/hooks/codex-hooks.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,23 @@
1
+ export declare const HOOK_PAYLOAD_MAX_BYTES: number;
2
+ export declare const HOOK_OUTPUT_MAX_BYTES: number;
3
+ export interface HookProcessResult {
4
+ readonly exitCode: number | null;
5
+ readonly signal: NodeJS.Signals | null;
6
+ readonly stdout: string;
7
+ readonly stderr: string;
8
+ readonly stdoutTruncated: boolean;
9
+ readonly stderrTruncated: boolean;
10
+ readonly timedOut: boolean;
11
+ readonly cancelled: boolean;
12
+ readonly error?: Error;
13
+ }
14
+ export declare class HookProcessManager {
15
+ private readonly projectRoot;
16
+ private readonly running;
17
+ private closed;
18
+ constructor(projectRoot: string);
19
+ run(command: string, commandWindows: string | undefined, payload: unknown, timeoutMs: number, signal?: AbortSignal): Promise<HookProcessResult>;
20
+ cancel(): void;
21
+ close(): Promise<void>;
22
+ private spawn;
23
+ }
@@ -0,0 +1,241 @@
1
+ import { spawn } from 'node:child_process';
2
+ import { StringDecoder } from 'node:string_decoder';
3
+ export const HOOK_PAYLOAD_MAX_BYTES = 64 * 1024;
4
+ // Capture enough for the adapter's 64 KiB per-handler context hard cap plus JSON
5
+ // escaping and bounded diagnostics. No hook output is ever spilled to disk.
6
+ export const HOOK_OUTPUT_MAX_BYTES = 128 * 1024;
7
+ const HOOK_OUTPUT_TOTAL_MAX_BYTES = HOOK_OUTPUT_MAX_BYTES;
8
+ const FORCE_KILL_AFTER_MS = 500;
9
+ export class HookProcessManager {
10
+ projectRoot;
11
+ running = new Set();
12
+ closed = false;
13
+ constructor(projectRoot) {
14
+ this.projectRoot = projectRoot;
15
+ }
16
+ run(command, commandWindows, payload, timeoutMs, signal) {
17
+ if (this.closed)
18
+ return Promise.resolve(failure(new Error('Hook process manager is closed.')));
19
+ let input;
20
+ try {
21
+ input = `${JSON.stringify(payload)}\n`;
22
+ }
23
+ catch (error) {
24
+ return Promise.resolve(failure(new Error(`Hook input could not be serialized: ${message(error)}`)));
25
+ }
26
+ if (Buffer.byteLength(input, 'utf8') > HOOK_PAYLOAD_MAX_BYTES) {
27
+ return Promise.resolve(failure(new Error(`Hook input exceeds ${HOOK_PAYLOAD_MAX_BYTES} bytes.`)));
28
+ }
29
+ const controller = new AbortController();
30
+ const onAbort = () => controller.abort();
31
+ signal?.addEventListener('abort', onAbort, { once: true });
32
+ if (signal?.aborted === true)
33
+ controller.abort();
34
+ const running = {};
35
+ running.controller = controller;
36
+ running.settled = this.spawn(command, commandWindows, input, timeoutMs, controller.signal)
37
+ .finally(() => {
38
+ signal?.removeEventListener('abort', onAbort);
39
+ this.running.delete(running);
40
+ });
41
+ this.running.add(running);
42
+ return running.settled;
43
+ }
44
+ cancel() {
45
+ for (const running of this.running)
46
+ running.controller.abort();
47
+ }
48
+ async close() {
49
+ if (this.closed)
50
+ return;
51
+ this.closed = true;
52
+ this.cancel();
53
+ await Promise.allSettled([...this.running].map((entry) => entry.settled));
54
+ }
55
+ spawn(command, commandWindows, input, timeoutMs, signal) {
56
+ return new Promise((resolve) => {
57
+ let child;
58
+ try {
59
+ const selected = process.platform === 'win32' ? commandWindows ?? command : command;
60
+ child = process.platform === 'win32'
61
+ ? spawn(selected, { cwd: this.projectRoot, env: process.env, stdio: 'pipe', shell: true, windowsHide: true })
62
+ : spawn('/bin/sh', ['-c', selected], {
63
+ cwd: this.projectRoot,
64
+ env: process.env,
65
+ stdio: 'pipe',
66
+ detached: true,
67
+ });
68
+ }
69
+ catch (error) {
70
+ resolve(failure(error instanceof Error ? error : new Error(String(error))));
71
+ return;
72
+ }
73
+ let stdout = Buffer.alloc(0);
74
+ let stderr = Buffer.alloc(0);
75
+ let stdoutTruncated = false;
76
+ let stderrTruncated = false;
77
+ let timedOut = false;
78
+ let cancelled = false;
79
+ let launchError;
80
+ let killTimer;
81
+ let reapTimer;
82
+ let timeout;
83
+ let terminating = false;
84
+ let closed = false;
85
+ let settled = false;
86
+ let cleanupDeadline = 0;
87
+ const append = (current, other, chunk, mark) => {
88
+ const available = HOOK_OUTPUT_TOTAL_MAX_BYTES - current.length - other.length;
89
+ if (available <= 0) {
90
+ mark();
91
+ return current;
92
+ }
93
+ if (chunk.length > available)
94
+ mark();
95
+ return Buffer.concat([current, chunk.subarray(0, available)]);
96
+ };
97
+ child.stdout.on('data', (chunk) => {
98
+ stdout = append(stdout, stderr, Buffer.from(chunk), () => { stdoutTruncated = true; });
99
+ });
100
+ child.stderr.on('data', (chunk) => {
101
+ stderr = append(stderr, stdout, Buffer.from(chunk), () => { stderrTruncated = true; });
102
+ });
103
+ child.stdin.on('error', () => undefined);
104
+ const finish = (exitCode, closeSignal) => {
105
+ if (settled)
106
+ return;
107
+ if ((terminating || launchError !== undefined) && !closed) {
108
+ // An `error` event is not guaranteed to be followed by `close`. Do not
109
+ // let a failed launch or cancellation keep runtime cleanup pending.
110
+ closed = true;
111
+ }
112
+ settled = true;
113
+ signal.removeEventListener('abort', onAbort);
114
+ if (timeout !== undefined)
115
+ clearTimeout(timeout);
116
+ if (killTimer !== undefined)
117
+ clearTimeout(killTimer);
118
+ if (reapTimer !== undefined)
119
+ clearTimeout(reapTimer);
120
+ resolve({
121
+ exitCode,
122
+ signal: closeSignal,
123
+ stdout: decodeUtf8(stdout),
124
+ stderr: decodeUtf8(stderr),
125
+ stdoutTruncated,
126
+ stderrTruncated,
127
+ timedOut,
128
+ cancelled,
129
+ ...(launchError === undefined ? {} : { error: launchError }),
130
+ });
131
+ };
132
+ child.once('error', (error) => {
133
+ launchError = error;
134
+ // Spawn failures have no process group to reap and may never emit close.
135
+ if (child.pid === undefined)
136
+ finish(null, null);
137
+ });
138
+ const waitForGroupExit = (pid, exitCode, closeSignal) => {
139
+ try {
140
+ process.kill(-pid, 0);
141
+ }
142
+ catch {
143
+ finish(exitCode, closeSignal);
144
+ return;
145
+ }
146
+ if (Date.now() >= cleanupDeadline) {
147
+ finish(exitCode, closeSignal);
148
+ return;
149
+ }
150
+ reapTimer = setTimeout(() => waitForGroupExit(pid, exitCode, closeSignal), 20);
151
+ };
152
+ const terminate = () => {
153
+ if (terminating)
154
+ return;
155
+ terminating = true;
156
+ cleanupDeadline = Date.now() + FORCE_KILL_AFTER_MS * 4;
157
+ const pid = child.pid;
158
+ try {
159
+ if (pid !== undefined && process.platform !== 'win32')
160
+ process.kill(-pid, 'SIGTERM');
161
+ else
162
+ child.kill('SIGTERM');
163
+ }
164
+ catch {
165
+ if (closed)
166
+ finish(null, null);
167
+ return;
168
+ }
169
+ killTimer = setTimeout(() => {
170
+ try {
171
+ if (pid !== undefined && process.platform !== 'win32')
172
+ process.kill(-pid, 'SIGKILL');
173
+ else
174
+ child.kill('SIGKILL');
175
+ }
176
+ catch {
177
+ if (closed)
178
+ finish(null, null);
179
+ return;
180
+ }
181
+ if (closed && pid !== undefined && process.platform !== 'win32')
182
+ waitForGroupExit(pid, null, null);
183
+ }, FORCE_KILL_AFTER_MS);
184
+ };
185
+ const onAbort = () => { cancelled = true; terminate(); };
186
+ signal.addEventListener('abort', onAbort, { once: true });
187
+ if (signal.aborted)
188
+ onAbort();
189
+ timeout = setTimeout(() => { timedOut = true; terminate(); }, timeoutMs);
190
+ timeout.unref?.();
191
+ child.once('close', (exitCode, closeSignal) => {
192
+ closed = true;
193
+ const pid = child.pid;
194
+ if (!terminating || process.platform === 'win32' || pid === undefined) {
195
+ finish(exitCode, closeSignal);
196
+ }
197
+ else {
198
+ // The shell leader can exit before a descendant that ignored TERM.
199
+ // Keep the KILL timer armed and settle only after the process group is gone.
200
+ if (killTimer === undefined)
201
+ waitForGroupExit(pid, exitCode, closeSignal);
202
+ else {
203
+ const existing = killTimer;
204
+ killTimer = setTimeout(() => {
205
+ clearTimeout(existing);
206
+ try {
207
+ process.kill(-pid, 'SIGKILL');
208
+ }
209
+ catch {
210
+ finish(exitCode, closeSignal);
211
+ return;
212
+ }
213
+ waitForGroupExit(pid, exitCode, closeSignal);
214
+ }, FORCE_KILL_AFTER_MS);
215
+ }
216
+ }
217
+ });
218
+ child.stdin.end(input);
219
+ });
220
+ }
221
+ }
222
+ function decodeUtf8(value) {
223
+ return new StringDecoder('utf8').write(value);
224
+ }
225
+ function failure(error) {
226
+ return {
227
+ exitCode: null,
228
+ signal: null,
229
+ stdout: '',
230
+ stderr: '',
231
+ stdoutTruncated: false,
232
+ stderrTruncated: false,
233
+ timedOut: false,
234
+ cancelled: false,
235
+ error,
236
+ };
237
+ }
238
+ function message(error) {
239
+ return error instanceof Error ? error.message : String(error);
240
+ }
241
+ //# sourceMappingURL=hook-process.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hook-process.js","sourceRoot":"","sources":["../../../src/hooks/hook-process.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,37 @@
1
+ import { type ToolHookGroup, type ToolHooksConfig } from './tool-hooks.js';
2
+ export declare const LIFECYCLE_HOOK_PAYLOAD_MAX_BYTES = 4096;
3
+ export type TurnCompleteOutcome = 'success' | 'failure' | 'cancelled';
4
+ export type TurnCompleteSource = 'interactive' | 'headless';
5
+ export type LifecycleHookEvent = {
6
+ readonly event: 'TurnComplete';
7
+ readonly outcome: TurnCompleteOutcome;
8
+ readonly source: TurnCompleteSource;
9
+ } | {
10
+ readonly event: 'PermissionRequest';
11
+ readonly source: string;
12
+ };
13
+ /**
14
+ * Runs configured lifecycle commands as bounded, output-free observers.
15
+ *
16
+ * Publishing is deliberately synchronous and returns no result: command launch,
17
+ * output and exit status cannot delay or alter the turn or permission decision
18
+ * that produced the observation. `close()` is only for process cleanup.
19
+ */
20
+ export declare class LifecycleHookRunner {
21
+ private readonly projectRoot;
22
+ private readonly hooks;
23
+ private readonly running;
24
+ private closed;
25
+ constructor(projectRoot: string, hooks: Pick<ToolHooksConfig, 'TurnComplete' | 'PermissionRequest'>);
26
+ publish(event: LifecycleHookEvent): void;
27
+ /** Publishes one source layer without changing the native payload or process path. */
28
+ publishGroups(event: LifecycleHookEvent, groups: readonly ToolHookGroup[] | undefined): void;
29
+ /** Requests bounded process-group cleanup without waiting for the grace period. */
30
+ cancel(): void;
31
+ /** Latches closed, terminates every owned group, and waits until each is reaped. */
32
+ close(): Promise<void>;
33
+ private spawn;
34
+ }
35
+ /** Returns undefined rather than emitting truncated or invalid JSON. */
36
+ export declare function serializeLifecycleHookEvent(event: LifecycleHookEvent): string | undefined;
37
+ export declare function lifecycleHooksFromConfig(hooks: ToolHooksConfig | undefined): Pick<ToolHooksConfig, 'TurnComplete' | 'PermissionRequest'> | undefined;
@@ -0,0 +1,153 @@
1
+ import { spawn } from 'node:child_process';
2
+ import { matchesToolGlob } from './tool-hooks.js';
3
+ export const LIFECYCLE_HOOK_PAYLOAD_MAX_BYTES = 4096;
4
+ const FORCE_KILL_AFTER_MS = 500;
5
+ /**
6
+ * Runs configured lifecycle commands as bounded, output-free observers.
7
+ *
8
+ * Publishing is deliberately synchronous and returns no result: command launch,
9
+ * output and exit status cannot delay or alter the turn or permission decision
10
+ * that produced the observation. `close()` is only for process cleanup.
11
+ */
12
+ export class LifecycleHookRunner {
13
+ projectRoot;
14
+ hooks;
15
+ running = new Set();
16
+ closed = false;
17
+ constructor(projectRoot, hooks) {
18
+ this.projectRoot = projectRoot;
19
+ this.hooks = hooks;
20
+ }
21
+ publish(event) {
22
+ if (this.closed)
23
+ return;
24
+ this.publishGroups(event, this.hooks[event.event]);
25
+ }
26
+ /** Publishes one source layer without changing the native payload or process path. */
27
+ publishGroups(event, groups) {
28
+ if (this.closed || groups === undefined)
29
+ return;
30
+ const payload = serializeLifecycleHookEvent(event);
31
+ if (payload === undefined)
32
+ return;
33
+ for (const group of groups) {
34
+ if (!matchesToolGlob(group.matcher, event.source))
35
+ continue;
36
+ for (const hook of group.hooks)
37
+ this.spawn(hook.command, payload);
38
+ }
39
+ }
40
+ /** Requests bounded process-group cleanup without waiting for the grace period. */
41
+ cancel() {
42
+ for (const running of this.running)
43
+ terminate(running);
44
+ }
45
+ /** Latches closed, terminates every owned group, and waits until each is reaped. */
46
+ async close() {
47
+ this.closed = true;
48
+ const running = [...this.running];
49
+ for (const entry of running)
50
+ terminate(entry);
51
+ await Promise.allSettled(running.map((entry) => entry.settled));
52
+ }
53
+ spawn(command, payload) {
54
+ let child;
55
+ try {
56
+ child = spawn('/bin/sh', ['-c', command], {
57
+ cwd: this.projectRoot,
58
+ env: process.env,
59
+ stdio: ['pipe', 'ignore', 'ignore'],
60
+ detached: true,
61
+ });
62
+ }
63
+ catch {
64
+ return;
65
+ }
66
+ let settle;
67
+ const running = {
68
+ child,
69
+ forceKillTimer: undefined,
70
+ reapTimer: undefined,
71
+ terminating: false,
72
+ cleanupDeadline: 0,
73
+ finish: () => undefined,
74
+ settled: new Promise((resolve) => {
75
+ settle = resolve;
76
+ }),
77
+ };
78
+ running.finish = () => {
79
+ if (!this.running.delete(running))
80
+ return;
81
+ if (running.forceKillTimer !== undefined)
82
+ clearTimeout(running.forceKillTimer);
83
+ if (running.reapTimer !== undefined)
84
+ clearTimeout(running.reapTimer);
85
+ settle();
86
+ };
87
+ this.running.add(running);
88
+ child.once('close', () => {
89
+ if (!running.terminating)
90
+ running.finish();
91
+ });
92
+ child.once('error', running.finish);
93
+ child.stdin?.on('error', () => undefined);
94
+ child.stdin?.end(payload);
95
+ // close() may have raced the spawn between the initial latch check and here.
96
+ if (this.closed)
97
+ terminate(running);
98
+ }
99
+ }
100
+ /** Returns undefined rather than emitting truncated or invalid JSON. */
101
+ export function serializeLifecycleHookEvent(event) {
102
+ const payload = `${JSON.stringify(event)}\n`;
103
+ return Buffer.byteLength(payload, 'utf8') <= LIFECYCLE_HOOK_PAYLOAD_MAX_BYTES
104
+ ? payload
105
+ : undefined;
106
+ }
107
+ export function lifecycleHooksFromConfig(hooks) {
108
+ if (hooks?.TurnComplete === undefined && hooks?.PermissionRequest === undefined)
109
+ return undefined;
110
+ return {
111
+ ...(hooks.TurnComplete === undefined ? {} : { TurnComplete: hooks.TurnComplete }),
112
+ ...(hooks.PermissionRequest === undefined ? {} : { PermissionRequest: hooks.PermissionRequest }),
113
+ };
114
+ }
115
+ function terminate(running) {
116
+ const pid = running.child.pid;
117
+ if (pid === undefined || running.terminating)
118
+ return;
119
+ running.terminating = true;
120
+ running.cleanupDeadline = Date.now() + FORCE_KILL_AFTER_MS * 4;
121
+ try {
122
+ process.kill(-pid, 'SIGTERM');
123
+ }
124
+ catch {
125
+ running.finish();
126
+ return;
127
+ }
128
+ running.forceKillTimer = setTimeout(() => {
129
+ try {
130
+ process.kill(-pid, 'SIGKILL');
131
+ }
132
+ catch {
133
+ running.finish();
134
+ return;
135
+ }
136
+ waitForProcessGroupExit(running, pid);
137
+ }, FORCE_KILL_AFTER_MS);
138
+ }
139
+ function waitForProcessGroupExit(running, pid) {
140
+ try {
141
+ process.kill(-pid, 0);
142
+ }
143
+ catch {
144
+ running.finish();
145
+ return;
146
+ }
147
+ if (Date.now() >= running.cleanupDeadline) {
148
+ running.finish();
149
+ return;
150
+ }
151
+ running.reapTimer = setTimeout(() => waitForProcessGroupExit(running, pid), 20);
152
+ }
153
+ //# sourceMappingURL=lifecycle-hooks.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lifecycle-hooks.js","sourceRoot":"","sources":["../../../src/hooks/lifecycle-hooks.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,63 @@
1
+ import { InterventionHandler, type AfterToolCallEvent, type BeforeInvocationEvent, type BeforeModelCallEvent, type BeforeToolCallEvent, type Tool } from '@strands-agents/sdk';
2
+ import type { PermissionGate } from '../agent/permission.js';
3
+ import { RepeatedFailureGuard } from '../agent/retry-guard.js';
4
+ import type { ToolHookPolicyLayer } from '../config.js';
5
+ import type { CodexHookRunner } from './codex-hook-runner.js';
6
+ export interface ToolHookCommand {
7
+ readonly type: 'command';
8
+ readonly command: string;
9
+ }
10
+ export interface ToolHookGroup {
11
+ readonly matcher: string;
12
+ readonly hooks: readonly ToolHookCommand[];
13
+ }
14
+ export interface ToolHooksConfig {
15
+ readonly PreToolUse?: readonly ToolHookGroup[];
16
+ readonly PostToolUse?: readonly ToolHookGroup[];
17
+ readonly TurnComplete?: readonly ToolHookGroup[];
18
+ readonly PermissionRequest?: readonly ToolHookGroup[];
19
+ }
20
+ export interface ToolHookResult {
21
+ readonly exitCode: number | null;
22
+ readonly stdout: string;
23
+ readonly stderr: string;
24
+ readonly error?: Error;
25
+ }
26
+ type InvocationAction = Awaited<ReturnType<InterventionHandler['beforeInvocation']>>;
27
+ type BeforeAction = Awaited<ReturnType<InterventionHandler['beforeToolCall']>>;
28
+ type AfterAction = Awaited<ReturnType<InterventionHandler['afterToolCall']>>;
29
+ type ModelAction = Awaited<ReturnType<InterventionHandler['beforeModelCall']>>;
30
+ /** Matches a complete, case-sensitive tool name using only `*` and `?` as wildcards. */
31
+ export declare function matchesToolGlob(pattern: string, toolName: string): boolean;
32
+ /** Runs one configured command in a real shell while keeping all output off the terminal. */
33
+ export declare function runToolHookCommand(projectRoot: string, command: string, toolName: string, toolInput: unknown, signal?: AbortSignal): Promise<ToolHookResult>;
34
+ /**
35
+ * Composes the retry guard and deterministic project hooks around permission.
36
+ *
37
+ * One intervention is intentional: After callbacks run in reverse handler order,
38
+ * and the SDK emits AfterToolCall even when Before denied a call. Only calls that
39
+ * passed the retry guard, Pre hooks and permission are eligible for Post hooks or
40
+ * repeated-failure observation.
41
+ */
42
+ export declare class ToolHookGate extends InterventionHandler {
43
+ private readonly projectRoot;
44
+ private readonly hooks;
45
+ private readonly permissionGate;
46
+ private readonly retryGuard;
47
+ private readonly codexHooks?;
48
+ private readonly policyLayers?;
49
+ private readonly toolForName?;
50
+ readonly name = "darwin:tool-hooks";
51
+ private readonly eligible;
52
+ constructor(projectRoot: string, hooks: ToolHooksConfig, permissionGate: PermissionGate, retryGuard?: RepeatedFailureGuard, codexHooks?: CodexHookRunner | undefined, policyLayers?: readonly ToolHookPolicyLayer[] | undefined, toolForName?: ((name: string) => Tool | undefined) | undefined);
53
+ beforeInvocation(event: BeforeInvocationEvent): InvocationAction;
54
+ beforeToolCall(event: BeforeToolCallEvent): Promise<BeforeAction>;
55
+ afterToolCall(event: AfterToolCallEvent): Promise<AfterAction>;
56
+ beforeModelCall(event: BeforeModelCallEvent): ModelAction;
57
+ private runNativePre;
58
+ private runPortablePost;
59
+ private runNativePost;
60
+ private markEligible;
61
+ private takeEligibility;
62
+ }
63
+ export {};