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,229 @@
1
+ import { classify } from './agent/permission.js';
2
+ import { runWithStreamResumption, STREAM_CONTINUATION_NOTICE } from './agent/stream-resumption.js';
3
+ import { describeRetryWait } from './agent/model-retry.js';
4
+ import { isRefusalStop, REFUSAL_EMPTY_REPLY_ERROR, REFUSAL_NOTICE } from './agent/refusal.js';
5
+ import { usageBuckets } from './agent/usage.js';
6
+ import { describePricingSource, modelCostFields } from './agent/cost.js';
7
+ import { averageRequestInputTokens } from './agent/call-stats.js';
8
+ const FIELD_LIMIT = 240;
9
+ /**
10
+ * The parent's pending model-retry wait (SER-067), read where a failed
11
+ * `afterModelCallEvent` arrives — the runtime publishes it before that event reaches the
12
+ * driver. `undefined` when there is none, when the runtime cannot say, or when reading
13
+ * throws: progress reporting never fails the turn it reports on.
14
+ */
15
+ export function pendingRetryWait(runtime) {
16
+ try {
17
+ return typeof runtime.retryWait === 'function' ? runtime.retryWait() : undefined;
18
+ }
19
+ catch {
20
+ return undefined;
21
+ }
22
+ }
23
+ /** Stable startup diagnostic for the effective post-override permission mode. */
24
+ export function formatHeadlessPermissionMode(mode) {
25
+ return `permission-mode: ${mode}`;
26
+ }
27
+ /** One-line, Unicode-safe and bounded text for script-facing progress records. */
28
+ export function headlessField(value, limit = FIELD_LIMIT) {
29
+ const normalized = value.replace(/\s+/gu, ' ').trim();
30
+ const points = [...normalized];
31
+ if (points.length <= limit)
32
+ return normalized;
33
+ return `${points.slice(0, Math.max(0, limit - 1)).join('')}…`;
34
+ }
35
+ /**
36
+ * The single machine-parseable token record a headless run writes before exit,
37
+ * matching `^usage: ...$` and sitting alongside the existing `session: <id>`
38
+ * convention.
39
+ *
40
+ * The four numeric fields are mutually exclusive cost buckets: `input` always
41
+ * excludes reported cache reads and writes, even when a provider includes those
42
+ * subsets in its native input total. A metric the provider never reported is
43
+ * written as `-`, never as `0`, and field order stays fixed for supervisors.
44
+ */
45
+ export function formatHeadlessUsage(usage, config) {
46
+ const buckets = usageBuckets(usage, config);
47
+ const metric = (value) => (value === undefined ? '-' : String(value));
48
+ return (`usage: input=${metric(buckets.input)} output=${metric(buckets.output)}` +
49
+ ` cacheRead=${metric(buckets.cacheRead)} cacheWrite=${metric(buckets.cacheWrite)}`);
50
+ }
51
+ /**
52
+ * The child-spend record, written only when at least one dispatch reported
53
+ * usage (`runtime.childUsage`), so a run without delegation keeps its exact
54
+ * historical stderr. Mirrors {@link formatHeadlessUsage} — same buckets, same
55
+ * fixed field order, same `-` for a metric no child's provider reported — plus
56
+ * the count of dispatches whose meters the sum actually includes.
57
+ */
58
+ export function formatHeadlessChildUsage(child, config) {
59
+ const buckets = usageBuckets(child.usage, config);
60
+ const metric = (value) => (value === undefined ? '-' : String(value));
61
+ return (`usage-children: input=${metric(buckets.input)} output=${metric(buckets.output)}` +
62
+ ` cacheRead=${metric(buckets.cacheRead)} cacheWrite=${metric(buckets.cacheWrite)}` +
63
+ ` dispatches=${child.dispatches}`);
64
+ }
65
+ /**
66
+ * The session-total record (parent meter plus children), emitted beside
67
+ * {@link formatHeadlessChildUsage} under the same only-when-children-reported
68
+ * condition; `usage:` alone remains the whole story otherwise.
69
+ */
70
+ export function formatHeadlessTotalUsage(total, config) {
71
+ const buckets = usageBuckets(total, config);
72
+ const metric = (value) => (value === undefined ? '-' : String(value));
73
+ return (`usage-total: input=${metric(buckets.input)} output=${metric(buckets.output)}` +
74
+ ` cacheRead=${metric(buckets.cacheRead)} cacheWrite=${metric(buckets.cacheWrite)}`);
75
+ }
76
+ /**
77
+ * The cost record, written right after the usage records in text mode:
78
+ * `cost: total=<usd|-> input=<usd|-> output=<usd|-> cacheRead=<usd|-> cacheWrite=<usd|-> model=<id> pricing=<litellmKey|unavailable|none>`.
79
+ *
80
+ * Prices the same parent buckets `usage:` reports, per model at its own rates —
81
+ * `runtime.modelShares`, the one projection `/status` and `/usage` share. Every
82
+ * figure is four-decimal USD at LiteLLM base rates; `-` is unknown, never `0` — and
83
+ * `total` is `-` whenever any bucket is unknown, because a floor written into
84
+ * `total=` would be read as the total. `pricing` names the LiteLLM key the rates
85
+ * came from (auditable), or why there are none. A single-model run — every run that
86
+ * never switched models — renders exactly as before; when several models
87
+ * contributed the record cannot name one, so it says how many (`model=2-models
88
+ * pricing=mixed`, both still one `\S+` token for the supervisor's capture) and a
89
+ * bucket any share left unknown is `-`. A separate record so the anchored `usage:`
90
+ * line stays byte-identical.
91
+ */
92
+ export function formatHeadlessCost(shares) {
93
+ const fields = modelCostFields(shares);
94
+ const single = shares.length === 1 ? shares[0] : undefined;
95
+ const model = single === undefined ? `${shares.length}-models` : single.config.model;
96
+ const pricing = single === undefined ? 'mixed' : describePricingSource(single.lookup);
97
+ return (`cost: total=${fields.total} input=${fields.input} output=${fields.output}` +
98
+ ` cacheRead=${fields.cacheRead} cacheWrite=${fields.cacheWrite}` +
99
+ ` model=${headlessField(model)} pricing=${headlessField(pricing)}`);
100
+ }
101
+ /**
102
+ * The per-call efficiency record, written only when at least one completed model
103
+ * call was observed (`runtime.callStats`), so a run that never reached the model
104
+ * keeps its exact historical stderr — the `usage-children:` convention. Field
105
+ * order is fixed for supervisors, and `avgRequestInput` is `-` when no call was
106
+ * metered — never `0`. The `usage:` record itself stays untouched either way.
107
+ */
108
+ export function formatHeadlessCallStats(stats, config) {
109
+ const average = averageRequestInputTokens(stats, config);
110
+ return (`model-calls: calls=${stats.calls} avgRequestInput=${average === undefined ? '-' : String(average)}` +
111
+ ` noTool=${stats.noTool} singleTool=${stats.singleTool} multiTool=${stats.multiTool}`);
112
+ }
113
+ /** A bridge for runs where nobody is present to answer a permission prompt. */
114
+ export function createHeadlessPermissionBridge(writeStderr) {
115
+ return async (request) => {
116
+ writeStderr(`permission denied — ${headlessField(request.summary)}\n`);
117
+ return { allowed: false };
118
+ };
119
+ }
120
+ /**
121
+ * One bounded stderr record when the trajectory could not be recorded, or
122
+ * `undefined` when there is nothing to say.
123
+ *
124
+ * Reported because a supervisor that later runs `darwin trajectory replay` on this
125
+ * session needs to know the record is short — and stays a diagnostic, never an exit
126
+ * status: recording is an observer, so its failure cannot fail a turn that worked.
127
+ */
128
+ export function formatHeadlessTrajectoryProblem(status) {
129
+ if (status?.problem === undefined)
130
+ return undefined;
131
+ return `trajectory: ${headlessField(status.problem)}`;
132
+ }
133
+ /**
134
+ * The same, one record, for the opt-in diagnostics log — or `undefined`, which is
135
+ * what a run that never asked for one always gets.
136
+ *
137
+ * A separate function rather than a shared "observer problem" helper: the two labels
138
+ * are the two artifacts, and a supervisor grepping for `^diagnostics:` should not have
139
+ * to know that recording and logging happen to degrade the same way.
140
+ */
141
+ export function formatHeadlessDiagnosticsProblem(status) {
142
+ if (status?.problem === undefined)
143
+ return undefined;
144
+ return `diagnostics: ${headlessField(status.problem)}`;
145
+ }
146
+ /**
147
+ * Consumes exactly one SDK turn and returns its assembled reply. The process
148
+ * orchestrator withholds stdout until runtime cleanup and pointer persistence
149
+ * also succeed, so no failed invocation leaves a plausible partial answer.
150
+ */
151
+ export async function runHeadlessTurn(runtime, prompt, writeStderr) {
152
+ const expanded = await runtime.expandSlashCommand(prompt);
153
+ const input = expanded?.message ?? prompt;
154
+ return runWithStreamResumption(input, (turnInput) => runOneHeadlessTurn(runtime, turnInput, prompt, writeStderr), () => writeStderr(`notice: ${STREAM_CONTINUATION_NOTICE}\n`));
155
+ }
156
+ /** One ordinary recorded SDK turn; resumption deliberately composes above this seam. */
157
+ async function runOneHeadlessTurn(runtime, input, userInput, writeStderr) {
158
+ const answer = [];
159
+ let completed = false;
160
+ let cancelled = false;
161
+ let refused = false;
162
+ // Same channel the tool lines use, one bounded record per wait (SER-067); the state
163
+ // object is unique per decided wait, so identity dedupes it.
164
+ let announcedWait;
165
+ for await (const event of runtime.send(input, userInput)) {
166
+ consumeEvent(event, answer, writeStderr);
167
+ if (event.type === 'afterModelCallEvent' && event.error !== undefined) {
168
+ const wait = pendingRetryWait(runtime);
169
+ if (wait !== undefined && wait !== announcedWait) {
170
+ announcedWait = wait;
171
+ writeStderr(`model ${describeRetryWait(wait, Date.now())} — ${headlessField(wait.reason)}\n`);
172
+ }
173
+ }
174
+ if (event.type === 'agentResultEvent') {
175
+ completed = true;
176
+ cancelled = event.result.stopReason === 'cancelled';
177
+ refused = isRefusalStop(event.result.stopReason);
178
+ }
179
+ }
180
+ if (!completed)
181
+ throw new Error('The agent turn ended without a final result.');
182
+ if (cancelled)
183
+ throw new Error('Interrupted.');
184
+ const reply = answer.join('').replace(/\n+$/u, '');
185
+ if (refused && reply.trim() === '')
186
+ throw new Error(REFUSAL_EMPTY_REPLY_ERROR);
187
+ if (refused)
188
+ writeStderr(`${REFUSAL_NOTICE}\n`);
189
+ if (reply.trim() === '')
190
+ throw new Error('The agent turn completed without an assistant reply.');
191
+ return reply;
192
+ }
193
+ function consumeEvent(event, answer, writeStderr) {
194
+ switch (event.type) {
195
+ case 'contentBlockEvent':
196
+ if (event.contentBlock.type === 'textBlock')
197
+ answer.push(event.contentBlock.text);
198
+ return;
199
+ case 'beforeToolCallEvent': {
200
+ const name = headlessField(event.toolUse.name);
201
+ const summary = headlessField(classify(event.toolUse.name, event.toolUse.input).summary);
202
+ writeStderr(`tool ${name} — ${summary}\n`);
203
+ return;
204
+ }
205
+ case 'afterToolCallEvent': {
206
+ const name = headlessField(event.toolUse.name);
207
+ const denied = event.result.status === 'error' && toolResultText(event.result.content).startsWith('DENIED:');
208
+ const status = denied ? 'denied' : event.result.status === 'error' ? 'failed' : 'ok';
209
+ writeStderr(`tool ${name} — ${status}\n`);
210
+ return;
211
+ }
212
+ default:
213
+ return;
214
+ }
215
+ }
216
+ function toolResultText(content) {
217
+ return content
218
+ .flatMap((block) => {
219
+ if (typeof block !== 'object' || block === null)
220
+ return [];
221
+ const candidate = block;
222
+ return candidate.type === 'textBlock' && typeof candidate.text === 'string'
223
+ ? [candidate.text]
224
+ : [];
225
+ })
226
+ .join('\n')
227
+ .trim();
228
+ }
229
+ //# sourceMappingURL=headless.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"headless.js","sourceRoot":"","sources":["../../src/headless.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,92 @@
1
+ import type { ApprovalMode } from '../agent/permission.js';
2
+ import type { AppConfig } from '../config.js';
3
+ import { type CodexHookGroup, type CodexHooksConfig } from './codex-hooks.js';
4
+ import { HookProcessManager } from './hook-process.js';
5
+ export type CodexSessionStartSource = 'startup' | 'resume' | 'clear';
6
+ export type CodexStopOutcome = 'success' | 'failure' | 'cancelled';
7
+ export interface CodexPreToolResult {
8
+ readonly allowed: boolean;
9
+ readonly input: unknown;
10
+ readonly reason?: string;
11
+ }
12
+ export interface CodexPromptResult {
13
+ readonly allowed: boolean;
14
+ readonly context?: string;
15
+ readonly reason?: string;
16
+ }
17
+ export interface CodexCompactResult {
18
+ readonly allowed: boolean;
19
+ readonly reason?: string;
20
+ }
21
+ export interface CodexHookRunnerOptions {
22
+ projectRoot: string;
23
+ hooks: CodexHooksConfig;
24
+ sessionId: string;
25
+ config: AppConfig;
26
+ permissionMode: () => ApprovalMode;
27
+ processManager?: HookProcessManager;
28
+ problem?: (message: string) => void;
29
+ }
30
+ export declare class CodexHookRunner {
31
+ private readonly options;
32
+ private readonly processes;
33
+ private config;
34
+ private pendingParentContext;
35
+ private problems;
36
+ private droppedProblems;
37
+ private readonly observations;
38
+ private sessionEnded;
39
+ private closed;
40
+ constructor(options: CodexHookRunnerOptions);
41
+ /** Child lifecycle commands need independent cancellation without duplicating policy. */
42
+ fork(): CodexHookRunner;
43
+ /** A live `/model` switch changes truthful payload metadata for later events. */
44
+ updateConfig(config: AppConfig): void;
45
+ sessionStart(source: CodexSessionStartSource): Promise<void>;
46
+ userPromptSubmit(prompt: string): Promise<CodexPromptResult>;
47
+ preToolUse(event: {
48
+ toolName: string;
49
+ toolUseId: string;
50
+ toolInput: unknown;
51
+ signal?: AbortSignal;
52
+ }, groups?: readonly CodexHookGroup[]): Promise<CodexPreToolResult>;
53
+ postToolUse(event: {
54
+ toolName: string;
55
+ toolUseId: string;
56
+ toolInput: unknown;
57
+ toolResponse: unknown;
58
+ }, groups?: readonly CodexHookGroup[]): Promise<void>;
59
+ permissionRequest(event: {
60
+ source: string;
61
+ toolName: string;
62
+ toolInput: unknown;
63
+ }, groups?: readonly CodexHookGroup[]): void;
64
+ preCompact(trigger: 'manual'): Promise<CodexCompactResult>;
65
+ postCompact(trigger: 'manual'): Promise<void>;
66
+ subagentStart(agent: {
67
+ id: string;
68
+ name: string;
69
+ }): Promise<string | undefined>;
70
+ subagentStop(agent: {
71
+ id: string;
72
+ name: string;
73
+ outcome: string;
74
+ }): Promise<void>;
75
+ stop(outcome: CodexStopOutcome): void;
76
+ sessionEnd(reason?: string): Promise<void>;
77
+ takePendingParentContext(): string[];
78
+ cancel(): void;
79
+ close(): Promise<void>;
80
+ takeProblems(): string[];
81
+ private controllingContextEvent;
82
+ private contextEvent;
83
+ private collect;
84
+ private observe;
85
+ private matching;
86
+ private payload;
87
+ private run;
88
+ private stageParent;
89
+ private readonly problemSink;
90
+ private problem;
91
+ }
92
+ export declare function injectCodexContext(text: string, context: string | undefined): string;