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,198 @@
1
+ import { APPROVAL_MODES } from './agent/permission.js';
2
+ import { isValidSessionId } from './agent/session.js';
3
+ /** A command-line shape the user must correct before darwin can start. */
4
+ export class CliUsageError extends Error {
5
+ constructor(message) {
6
+ super(message);
7
+ this.name = 'CliUsageError';
8
+ }
9
+ }
10
+ export const HEADLESS_OUTPUT_FORMATS = ['text', 'json', 'stream-json'];
11
+ /**
12
+ * Removes the one conventional transport separator accepted at the process argv
13
+ * boundary. Domain parsers stay strict: a second or non-leading `--` is untouched.
14
+ */
15
+ export function normalizeLeadingArgvSeparator(argv) {
16
+ return argv[0] === '--' ? argv.slice(1) : argv;
17
+ }
18
+ /** Parses argv after the executable/script names. No I/O or runtime construction. */
19
+ export function parseCliArgs(argv) {
20
+ let prompt;
21
+ let sessionId;
22
+ let resumeIdSeen = false;
23
+ let permissionMode;
24
+ let permissionModeSeen = false;
25
+ let outputFormat = 'text';
26
+ let outputFormatSeen = false;
27
+ let maxModelCalls;
28
+ let maxModelCallsSeen = false;
29
+ let contextOffloadOverride;
30
+ let contextOffloadSeen = false;
31
+ let compactBefore = false;
32
+ let compactBeforeSeen = false;
33
+ let continueRequested = false;
34
+ let resumeRequested = false;
35
+ let yolo = argv.includes('--yolo');
36
+ for (let index = 0; index < argv.length; index += 1) {
37
+ const flag = argv[index];
38
+ switch (flag) {
39
+ case '-p':
40
+ case '--print': {
41
+ if (prompt !== undefined)
42
+ throw new CliUsageError('-p/--print may be specified only once.');
43
+ const value = argv[index + 1];
44
+ if (value === undefined || value.startsWith('-') || value.trim() === '') {
45
+ throw new CliUsageError(`${flag} expects a non-empty message.`);
46
+ }
47
+ prompt = value;
48
+ index += 1;
49
+ break;
50
+ }
51
+ case '--output-format': {
52
+ if (outputFormatSeen)
53
+ throw new CliUsageError('--output-format may be specified only once.');
54
+ outputFormatSeen = true;
55
+ const value = argv[index + 1];
56
+ if (value === undefined || value.startsWith('-')) {
57
+ throw new CliUsageError(`--output-format expects one of ${HEADLESS_OUTPUT_FORMATS.join(', ')}, got ${JSON.stringify('(nothing)')}.`);
58
+ }
59
+ if (!HEADLESS_OUTPUT_FORMATS.includes(value)) {
60
+ throw new CliUsageError(`--output-format expects one of ${HEADLESS_OUTPUT_FORMATS.join(', ')}, got ${JSON.stringify(value)}.`);
61
+ }
62
+ outputFormat = value;
63
+ index += 1;
64
+ break;
65
+ }
66
+ case '--max-model-calls': {
67
+ if (maxModelCallsSeen)
68
+ throw new CliUsageError('--max-model-calls may be specified only once.');
69
+ maxModelCallsSeen = true;
70
+ const value = argv[index + 1];
71
+ if (value === undefined || !/^[1-9]\d*$/u.test(value)) {
72
+ throw new CliUsageError(`--max-model-calls expects a positive integer, got ${JSON.stringify(value ?? '(nothing)')}.`);
73
+ }
74
+ maxModelCalls = Number(value);
75
+ if (!Number.isSafeInteger(maxModelCalls)) {
76
+ throw new CliUsageError(`--max-model-calls is too large: ${JSON.stringify(value)}.`);
77
+ }
78
+ index += 1;
79
+ break;
80
+ }
81
+ case '--context-offload':
82
+ if (contextOffloadSeen)
83
+ throw new CliUsageError('--context-offload may be specified only once.');
84
+ contextOffloadSeen = true;
85
+ contextOffloadOverride = true;
86
+ break;
87
+ case '--compact-before':
88
+ if (compactBeforeSeen)
89
+ throw new CliUsageError('--compact-before may be specified only once.');
90
+ compactBeforeSeen = true;
91
+ compactBefore = true;
92
+ break;
93
+ case '--session': {
94
+ if (resumeIdSeen) {
95
+ throw new CliUsageError('--resume <id> and --session may not both name a session.');
96
+ }
97
+ if (sessionId !== undefined)
98
+ throw new CliUsageError('--session may be specified only once.');
99
+ const value = argv[index + 1];
100
+ if (value === undefined || value.startsWith('-') || value === '') {
101
+ throw new CliUsageError('--session expects an id.');
102
+ }
103
+ if (!isValidSessionId(value)) {
104
+ throw new CliUsageError(`Invalid session id ${JSON.stringify(value)}; use lowercase letters, numbers, hyphens, and underscores.`);
105
+ }
106
+ sessionId = value;
107
+ index += 1;
108
+ break;
109
+ }
110
+ case '--permission-mode': {
111
+ if (permissionModeSeen)
112
+ throw new CliUsageError('--permission-mode may be specified only once.');
113
+ permissionModeSeen = true;
114
+ const value = argv[index + 1];
115
+ if (value === undefined) {
116
+ throw new CliUsageError(`--permission-mode expects one of ${APPROVAL_MODES.join(', ')}, got ${JSON.stringify('(nothing)')}.`);
117
+ }
118
+ if (value === '--yolo') {
119
+ index += 1;
120
+ break;
121
+ }
122
+ if (value.startsWith('--')) {
123
+ throw new CliUsageError(`--permission-mode expects one of ${APPROVAL_MODES.join(', ')}, got ${JSON.stringify('(nothing)')}.`);
124
+ }
125
+ // Preserve the original CLI contract: --yolo wins even when the
126
+ // redundant value flag is invalid, regardless of argument order.
127
+ if (!APPROVAL_MODES.includes(value) && !argv.includes('--yolo')) {
128
+ throw new CliUsageError(`--permission-mode expects one of ${APPROVAL_MODES.join(', ')}, got ${JSON.stringify(value)}.`);
129
+ }
130
+ if (APPROVAL_MODES.includes(value))
131
+ permissionMode = value;
132
+ index += 1;
133
+ break;
134
+ }
135
+ case '--continue':
136
+ continueRequested = true;
137
+ break;
138
+ case '--resume': {
139
+ resumeRequested = true;
140
+ // `--resume <id>` names the session to reopen; bare `--resume` (end of argv,
141
+ // or followed by another flag) keeps its original pointer-following meaning.
142
+ // A leading `-` is what separates "flag" from "id" here — the session-id
143
+ // alphabet has no `-` prefix, so nothing valid is ever mistaken for a flag.
144
+ const value = argv[index + 1];
145
+ if (value !== undefined && !value.startsWith('-') && value !== '') {
146
+ if (resumeIdSeen)
147
+ throw new CliUsageError('--resume <id> may be specified only once.');
148
+ if (sessionId !== undefined) {
149
+ throw new CliUsageError('--resume <id> and --session may not both name a session.');
150
+ }
151
+ if (!isValidSessionId(value)) {
152
+ throw new CliUsageError(`Invalid session id ${JSON.stringify(value)}; use lowercase letters, numbers, hyphens, and underscores.`);
153
+ }
154
+ sessionId = value;
155
+ resumeIdSeen = true;
156
+ index += 1;
157
+ }
158
+ break;
159
+ }
160
+ case '--yolo':
161
+ yolo = true;
162
+ break;
163
+ default:
164
+ throw new CliUsageError(`Unknown argument ${JSON.stringify(flag)}.`);
165
+ }
166
+ }
167
+ if (prompt === undefined && continueRequested) {
168
+ throw new CliUsageError('--continue is available only with -p/--print; use --resume for the TUI.');
169
+ }
170
+ if (prompt === undefined && outputFormatSeen) {
171
+ throw new CliUsageError('--output-format is available only with -p/--print.');
172
+ }
173
+ if (prompt === undefined && maxModelCallsSeen) {
174
+ throw new CliUsageError('--max-model-calls is available only with -p/--print.');
175
+ }
176
+ if (prompt === undefined && contextOffloadSeen) {
177
+ throw new CliUsageError('--context-offload is available only with -p/--print.');
178
+ }
179
+ if (prompt === undefined && compactBeforeSeen) {
180
+ throw new CliUsageError('--compact-before is available only with -p/--print.');
181
+ }
182
+ const session = sessionId !== undefined
183
+ ? { kind: 'id', sessionId }
184
+ : continueRequested || resumeRequested
185
+ ? { kind: 'continue' }
186
+ : { kind: 'new' };
187
+ return {
188
+ prompt,
189
+ outputFormat,
190
+ maxModelCalls,
191
+ contextOffloadOverride,
192
+ compactBefore,
193
+ session,
194
+ // Preserve the existing shorthand contract: --yolo wins over the value flag.
195
+ permissionModeOverride: yolo ? 'yolo' : permissionMode,
196
+ };
197
+ }
198
+ //# sourceMappingURL=cli-args.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cli-args.js","sourceRoot":"","sources":["../../src/cli-args.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,26 @@
1
+ export declare const DOCTOR_COMMAND = "doctor";
2
+ export declare const DOCTOR_USAGE = "Usage: darwin doctor\n\n Prints a read-only diagnostics report for this project: config, system prompt,\n project instructions, MCP config, skills, hooks and policy, permission rules,\n sessions store and versions. Starts no session, calls no model, spawns and\n connects nothing, writes nothing. Exit 0 when no problem was found, 1 otherwise.";
3
+ /** Marker every problem line starts with; the total at the end counts these. */
4
+ export declare const PROBLEM_MARKER = "! ";
5
+ /** Longest report line, in code points; longer lines end in `…`. */
6
+ export declare const MAX_DOCTOR_LINE_CHARS = 400;
7
+ /** Most entries one list (servers, skipped skills, hook files) prints before `… N more`. */
8
+ export declare const MAX_DOCTOR_LIST = 40;
9
+ /** True when argv asks for this subcommand at all, so `cli.ts` can route before anything else. */
10
+ export declare function isDoctorInvocation(argv: readonly string[]): boolean;
11
+ /** Parses argv *after* the `doctor` token. No I/O. */
12
+ export declare function parseDoctorArgs(argv: readonly string[]): void;
13
+ export interface DoctorIo {
14
+ projectRoot: string;
15
+ out: (text: string) => void;
16
+ err: (text: string) => void;
17
+ }
18
+ /** Runs the report and returns the process exit code. Never throws for a loader failure. */
19
+ export declare function runDoctorCommand(io: DoctorIo): Promise<number>;
20
+ /**
21
+ * A plain PATH lookup — `X_OK` on each candidate, never a spawn. A command with a
22
+ * path separator is checked where it points (relative to the current directory,
23
+ * as a shell would); a bare name is searched along `PATH`. Answers the first
24
+ * executable match, or `undefined`.
25
+ */
26
+ export declare function lookupOnPath(command: string, env?: NodeJS.ProcessEnv): string | undefined;
@@ -0,0 +1,398 @@
1
+ /**
2
+ * `darwin doctor` — an offline, read-only diagnostics report.
3
+ *
4
+ * Composed from the loaders startup already uses (`loadConfig`, `loadSystemPrompt`,
5
+ * `loadProjectInstructions`, `readMcpServerConfigs`, `scanSkills`, `loadProjectPolicy`,
6
+ * the sessions-store readers) so the report says what a session *would* load, not
7
+ * what a second parser thinks. The one rule that differs from startup: a loader
8
+ * that would refuse to start here becomes a marked problem line instead — the
9
+ * report always completes, and its exit code says whether anything was wrong.
10
+ *
11
+ * Zero mutation, by construction: no model call, no MCP process, no network, and no
12
+ * file, directory or pointer created or moved anywhere — including `~/.darwin` and
13
+ * the project's `.darwin/`. Every loader called from here is a pure reader
14
+ * (`loadConfig` / `loadProjectPolicy` derive the config path through
15
+ * `configFilePath()`, which unlike `configPath()` creates nothing; MCP servers are
16
+ * read through `readMcpServerConfigs`, the declarative half of the loader that
17
+ * never reaches the SDK's `loadServers`). The `sessions` precedent applies for the
18
+ * rest: readers only, `spike/verify-doctor-command.ts` proves HOME and the project
19
+ * byte-identical before and after.
20
+ *
21
+ * Exit codes follow the `sessions` / `trajectory` convention: 0 when no problem was
22
+ * found, 1 when at least one was, 2 for a usage error.
23
+ */
24
+ import { accessSync, constants as fsConstants, existsSync, statSync } from 'node:fs';
25
+ import os from 'node:os';
26
+ import path from 'node:path';
27
+ import process from 'node:process';
28
+ import { AGENTS_FILENAME, loadProjectInstructions, MAX_INSTRUCTIONS_BYTES } from './agent/instructions.js';
29
+ import { planPromptCache } from './agent/prompt-cache.js';
30
+ import { listSessionIds, readLastSessionId, sessionPaths } from './agent/session.js';
31
+ import { loadSystemPrompt } from './agent/system-prompt.js';
32
+ import { planThinking } from './agent/thinking.js';
33
+ import { CliUsageError } from './cli-args.js';
34
+ import { ConfigError, configFilePath, loadConfig, loadProjectPolicy, permissionRulesPath, resolveAnthropicBaseUrl, resolveRegion, } from './config.js';
35
+ import { mcpConfigCandidates, readMcpServerConfigs } from './mcp/registry.js';
36
+ import { extensionRoots } from './paths.js';
37
+ import { BUILTIN_SKILLS_DIR, REQUIRED_BUILTIN_SKILLS, scanSkills, SKILLS_DIRNAME } from './skills/loader.js';
38
+ import { DARWIN_VERSION } from './version.js';
39
+ export const DOCTOR_COMMAND = 'doctor';
40
+ export const DOCTOR_USAGE = `Usage: darwin ${DOCTOR_COMMAND}
41
+
42
+ Prints a read-only diagnostics report for this project: config, system prompt,
43
+ project instructions, MCP config, skills, hooks and policy, permission rules,
44
+ sessions store and versions. Starts no session, calls no model, spawns and
45
+ connects nothing, writes nothing. Exit 0 when no problem was found, 1 otherwise.`;
46
+ /** Marker every problem line starts with; the total at the end counts these. */
47
+ export const PROBLEM_MARKER = '! ';
48
+ /** Longest report line, in code points; longer lines end in `…`. */
49
+ export const MAX_DOCTOR_LINE_CHARS = 400;
50
+ /** Most entries one list (servers, skipped skills, hook files) prints before `… N more`. */
51
+ export const MAX_DOCTOR_LIST = 40;
52
+ /** True when argv asks for this subcommand at all, so `cli.ts` can route before anything else. */
53
+ export function isDoctorInvocation(argv) {
54
+ return argv[0] === DOCTOR_COMMAND;
55
+ }
56
+ /** Parses argv *after* the `doctor` token. No I/O. */
57
+ export function parseDoctorArgs(argv) {
58
+ if (argv.length > 0) {
59
+ throw new CliUsageError(`${DOCTOR_COMMAND} takes no arguments.\n${DOCTOR_USAGE}`);
60
+ }
61
+ }
62
+ /** Accumulates the report; problems are counted as they are written. */
63
+ class Report {
64
+ lines = [];
65
+ problems = 0;
66
+ section(title) {
67
+ if (this.lines.length > 0)
68
+ this.lines.push('');
69
+ this.lines.push(title);
70
+ }
71
+ info(text) {
72
+ this.lines.push(` ${boundLine(text)}`);
73
+ }
74
+ problem(text) {
75
+ this.problems += 1;
76
+ this.lines.push(` ${PROBLEM_MARKER}${boundLine(text)}`);
77
+ }
78
+ /** Prints at most {@link MAX_DOCTOR_LIST} entries; the rest is one `… N more` row, problems still counted. */
79
+ list(entries) {
80
+ const shown = entries.slice(0, MAX_DOCTOR_LIST);
81
+ for (const entry of shown) {
82
+ if (entry.problem)
83
+ this.problem(entry.text);
84
+ else
85
+ this.info(entry.text);
86
+ }
87
+ const hidden = entries.slice(MAX_DOCTOR_LIST);
88
+ if (hidden.length > 0) {
89
+ const hiddenProblems = hidden.filter((entry) => entry.problem).length;
90
+ this.problems += hiddenProblems;
91
+ this.info(`… ${hidden.length} more${hiddenProblems > 0 ? ` (${hiddenProblems} of them problems, counted)` : ''}`);
92
+ }
93
+ }
94
+ render() {
95
+ return `${this.lines.join('\n')}\n`;
96
+ }
97
+ }
98
+ /** Runs the report and returns the process exit code. Never throws for a loader failure. */
99
+ export async function runDoctorCommand(io) {
100
+ const report = new Report();
101
+ const projectRoot = path.resolve(io.projectRoot);
102
+ report.section(`darwin doctor — read-only diagnostics for ${projectRoot}`);
103
+ const config = await reportConfig(report, projectRoot);
104
+ await reportSystemPrompt(report, projectRoot, config);
105
+ await reportInstructions(report, projectRoot);
106
+ await reportMcp(report, projectRoot);
107
+ await reportSkills(report, projectRoot);
108
+ const policy = await reportHooks(report, projectRoot);
109
+ reportPermissionRules(report, projectRoot, policy);
110
+ await reportSessions(report, projectRoot);
111
+ reportVersions(report);
112
+ report.section(report.problems === 0
113
+ ? 'no problems found'
114
+ : `${report.problems} problem${report.problems === 1 ? '' : 's'} found (lines marked ${PROBLEM_MARKER.trim()})`);
115
+ io.out(report.render());
116
+ return report.problems === 0 ? 0 : 1;
117
+ }
118
+ // ---------------------------------------------------------------------------
119
+ // Sections
120
+ // ---------------------------------------------------------------------------
121
+ async function reportConfig(report, projectRoot) {
122
+ const file = configFilePath();
123
+ report.section('config');
124
+ const present = existsSync(file);
125
+ report.info(present ? `file ${file}` : `file ${file} — absent, built-in defaults apply`);
126
+ let config;
127
+ try {
128
+ // `loadConfig` reads through `configFilePath()`: nothing is created when
129
+ // `~/.darwin` does not exist. A ConfigError is this report's job, not a crash.
130
+ config = await loadConfig(projectRoot);
131
+ }
132
+ catch (error) {
133
+ report.problem(`config: ${error instanceof ConfigError ? error.message : `unexpected failure: ${describe(error)}`}`);
134
+ return undefined;
135
+ }
136
+ const label = config.name === undefined ? '' : ` (${config.name})`;
137
+ report.info(`provider ${config.provider} model ${config.model}${label}`);
138
+ if (config.modelChoices.length > 1) {
139
+ report.info(`models configured: ${config.modelChoices.length} (/model switches between them)`);
140
+ }
141
+ switch (config.provider) {
142
+ case 'bedrock':
143
+ report.info(`region ${resolveRegion(config.region)}`);
144
+ break;
145
+ case 'anthropic': {
146
+ const baseUrl = resolveAnthropicBaseUrl(config);
147
+ report.info(`base URL ${baseUrl ?? '(client default: https://api.anthropic.com)'}`);
148
+ break;
149
+ }
150
+ case 'openai':
151
+ if (config.bedrockMantle === true)
152
+ report.info(`bedrock mantle on region ${resolveRegion(config.region)}`);
153
+ if (config.openaiApi !== undefined)
154
+ report.info(`openai api ${config.openaiApi}`);
155
+ break;
156
+ }
157
+ if (config.apiKeyEnv !== undefined) {
158
+ // Never the value: only whether the named variable is set.
159
+ const value = process.env[config.apiKeyEnv];
160
+ report.info(`api key env ${config.apiKeyEnv}: ${value === undefined || value === '' ? 'not set' : 'set'}`);
161
+ }
162
+ const thinking = planThinking(config);
163
+ report.info(`effort ${thinking.requested}` +
164
+ (thinking.effective === thinking.requested ? '' : ` (effective ${thinking.effective ?? 'none'})`));
165
+ if (thinking.problem !== undefined)
166
+ report.info(`note: ${thinking.problem}`);
167
+ const cache = planPromptCache(config);
168
+ report.info(`prompt cache ${cache.enabled || cache.automatic ? 'on' : 'off'}` +
169
+ (cache.ttl === undefined ? '' : ` ttl ${cache.ttl}`));
170
+ if (cache.problem !== undefined)
171
+ report.info(`note: ${cache.problem}`);
172
+ report.info(`context offload ${config.contextOffload ? 'on' : 'off'}` +
173
+ (config.maxResultTokens === undefined ? '' : ` maxResultTokens ${config.maxResultTokens}`));
174
+ // The same effective readings the runtime applies (`trajectory !== false`,
175
+ // `diagnostics === true`, `memory === true`).
176
+ report.info(`trajectory ${config.trajectory === false ? 'off' : 'on'} ` +
177
+ `memory ${config.memory === true ? 'on' : 'off'} ` +
178
+ `diagnostics ${config.diagnostics === true ? 'on' : 'off'}`);
179
+ report.info(`permission mode ${config.permissionMode}`);
180
+ return config;
181
+ }
182
+ async function reportSystemPrompt(report, projectRoot, config) {
183
+ report.section('system prompt');
184
+ const load = await loadSystemPrompt(projectRoot, config?.systemPrompt);
185
+ switch (load.source) {
186
+ case 'default':
187
+ report.info('source built-in default');
188
+ break;
189
+ case 'config':
190
+ report.info('source config systemPrompt');
191
+ break;
192
+ case 'file':
193
+ report.info(`source file ${load.path ?? ''}`);
194
+ break;
195
+ }
196
+ if (load.problem !== undefined)
197
+ report.problem(`system prompt override skipped: ${load.problem}`);
198
+ }
199
+ async function reportInstructions(report, projectRoot) {
200
+ report.section('project instructions');
201
+ const load = await loadProjectInstructions(projectRoot);
202
+ if (load.problem !== undefined) {
203
+ report.problem(`${AGENTS_FILENAME} could not be used: ${load.problem}`);
204
+ return;
205
+ }
206
+ if (load.instructions === undefined) {
207
+ report.info(`${path.join(projectRoot, AGENTS_FILENAME)} — absent or empty (nothing preloaded)`);
208
+ return;
209
+ }
210
+ const { path: file, bytes, truncated } = load.instructions;
211
+ report.info(`${file} ${bytes.toLocaleString('en-US')} bytes (cap ${MAX_INSTRUCTIONS_BYTES.toLocaleString('en-US')})`);
212
+ if (truncated) {
213
+ report.problem(`${AGENTS_FILENAME} is over the cap: only the first ${MAX_INSTRUCTIONS_BYTES.toLocaleString('en-US')} bytes are preloaded, ` +
214
+ `${(bytes - MAX_INSTRUCTIONS_BYTES).toLocaleString('en-US')} bytes are invisible to the agent`);
215
+ }
216
+ }
217
+ async function reportMcp(report, projectRoot) {
218
+ report.section('mcp');
219
+ const candidates = mcpConfigCandidates(projectRoot);
220
+ let configs;
221
+ try {
222
+ // The declarative half only: nothing is spawned, nothing connects.
223
+ configs = await readMcpServerConfigs(projectRoot);
224
+ }
225
+ catch (error) {
226
+ report.problem(`mcp: ${error instanceof ConfigError ? error.message.split('\n')[0] : describe(error)}`);
227
+ return;
228
+ }
229
+ const used = new Set(configs.configPaths);
230
+ for (const [role, file] of [
231
+ ['global', candidates.global],
232
+ ['project', candidates.preferred],
233
+ ['project fallback', candidates.fallback],
234
+ ]) {
235
+ const state = used.has(file)
236
+ ? 'read'
237
+ : file === configs.ignoredConfigPath
238
+ ? 'ignored (.darwin/mcp.json takes precedence)'
239
+ : existsSync(file) ? 'present, not read' : 'absent';
240
+ report.info(`${role} ${file} — ${state}`);
241
+ }
242
+ if (configs.overriddenServerNames.length > 0) {
243
+ report.info(`overridden by the project layer: ${configs.overriddenServerNames.join(', ')}`);
244
+ }
245
+ if (configs.servers === undefined) {
246
+ report.info('no MCP servers configured');
247
+ return;
248
+ }
249
+ const names = Object.keys(configs.servers);
250
+ report.info(`${names.length} server${names.length === 1 ? '' : 's'} configured`);
251
+ report.list(names.map((name) => describeServer(name, configs.servers?.[name])));
252
+ }
253
+ function describeServer(name, server) {
254
+ if (server === undefined || typeof server !== 'object') {
255
+ return { text: `server ${name}: entry is not an object`, problem: true };
256
+ }
257
+ if (server.disabled === true)
258
+ return { text: `server ${name}: disabled`, problem: false };
259
+ const url = server.url;
260
+ const command = server.command;
261
+ if (typeof url === 'string' && (server.transport === undefined || server.transport !== 'stdio')) {
262
+ return { text: `server ${name}: ${server.transport ?? 'streamable-http'} ${url} — not connected (doctor never connects)`, problem: false };
263
+ }
264
+ if (typeof command !== 'string' || command === '') {
265
+ return { text: `server ${name}: neither "command" nor "url" is set`, problem: true };
266
+ }
267
+ if (command.includes('${')) {
268
+ return { text: `server ${name}: stdio ${command} — not checked (interpolated at connect time)`, problem: false };
269
+ }
270
+ const found = lookupOnPath(command);
271
+ return found === undefined
272
+ ? { text: `server ${name}: stdio command "${command}" not found on PATH`, problem: true }
273
+ : { text: `server ${name}: stdio command "${command}" found at ${found}`, problem: false };
274
+ }
275
+ /**
276
+ * A plain PATH lookup — `X_OK` on each candidate, never a spawn. A command with a
277
+ * path separator is checked where it points (relative to the current directory,
278
+ * as a shell would); a bare name is searched along `PATH`. Answers the first
279
+ * executable match, or `undefined`.
280
+ */
281
+ export function lookupOnPath(command, env = process.env) {
282
+ const candidates = command.includes('/') || (process.platform === 'win32' && command.includes('\\'))
283
+ ? [path.resolve(command)]
284
+ : (env['PATH'] ?? '').split(path.delimiter).filter((dir) => dir !== '').map((dir) => path.join(dir, command));
285
+ for (const candidate of candidates) {
286
+ try {
287
+ accessSync(candidate, fsConstants.X_OK);
288
+ if (statSync(candidate).isFile())
289
+ return candidate;
290
+ }
291
+ catch {
292
+ // Not here, or not executable: keep looking.
293
+ }
294
+ }
295
+ return undefined;
296
+ }
297
+ async function reportSkills(report, projectRoot) {
298
+ report.section('skills');
299
+ let scan;
300
+ try {
301
+ scan = await scanSkills(projectRoot);
302
+ }
303
+ catch (error) {
304
+ report.problem(`skills: ${describe(error)}`);
305
+ return;
306
+ }
307
+ const layers = [
308
+ { label: 'built-in', directory: BUILTIN_SKILLS_DIR },
309
+ ...extensionRoots(projectRoot).map((layer) => ({
310
+ label: `${layer.scope} ${path.basename(layer.root)}`,
311
+ directory: path.join(layer.root, SKILLS_DIRNAME),
312
+ })),
313
+ ];
314
+ for (const layer of layers) {
315
+ const count = scan.skills.filter((skill) => skill.path !== undefined && isInside(layer.directory, skill.path)).length;
316
+ const state = existsSync(layer.directory) ? `${count} skill${count === 1 ? '' : 's'}` : 'absent';
317
+ report.info(`${layer.label} ${layer.directory} — ${state}`);
318
+ }
319
+ // `scanSkills` throws when a required built-in is missing or broken, so reaching
320
+ // this line means every one of them loaded.
321
+ report.info(`required built-ins present: ${REQUIRED_BUILTIN_SKILLS.join(', ')}`);
322
+ report.list(scan.problems.map((problem) => ({ text: `skill skipped ${problem.directory}: ${problem.reason}`, problem: true })));
323
+ }
324
+ async function reportHooks(report, projectRoot) {
325
+ report.section('hooks and policy');
326
+ let policy;
327
+ try {
328
+ policy = await loadProjectPolicy(projectRoot);
329
+ }
330
+ catch (error) {
331
+ report.problem(`hooks/policy: ${error instanceof ConfigError ? error.message : describe(error)}`);
332
+ return undefined;
333
+ }
334
+ if (policy.toolHookLayers.length === 0) {
335
+ report.info('no hook files (native hooks/*.json or portable .agents/hooks.json)');
336
+ }
337
+ else {
338
+ report.list(policy.toolHookLayers.map((layer) => ({
339
+ text: `${layer.file} — ${layer.dialect === 'codex' ? 'Codex adapter dialect' : 'native dialect'}`,
340
+ problem: false,
341
+ })));
342
+ }
343
+ for (const notice of policy.hookShadowNotices) {
344
+ report.info(`shadowed in ${notice.layer} (${notice.directory} is authoritative): ${notice.shadowed.join(', ')}`);
345
+ }
346
+ return policy;
347
+ }
348
+ function reportPermissionRules(report, projectRoot, policy) {
349
+ report.section('permission rules');
350
+ const file = permissionRulesPath(projectRoot);
351
+ const present = existsSync(file);
352
+ if (policy === undefined) {
353
+ report.info(`${file} — ${present ? 'present' : 'absent'}, count unavailable (see the hooks/policy problem)`);
354
+ return;
355
+ }
356
+ const count = policy.allowRules.length;
357
+ const rules = `${count} allow rule${count === 1 ? '' : 's'}`;
358
+ if (policy.legacyRules) {
359
+ report.info(`${file} — absent; ${rules} read from the legacy project .darwin/config.json "permissionRules"`);
360
+ return;
361
+ }
362
+ report.info(present ? `${file} — ${rules}` : `${file} — absent (${rules})`);
363
+ }
364
+ async function reportSessions(report, projectRoot) {
365
+ report.section('sessions');
366
+ const paths = sessionPaths(projectRoot);
367
+ if (!existsSync(paths.sessionsDir)) {
368
+ report.info(`${paths.sessionsDir} — absent (no sessions yet)`);
369
+ return;
370
+ }
371
+ // Both readers: a directory listing and a pointer read, never a pointer write.
372
+ const ids = await listSessionIds(projectRoot);
373
+ const last = await readLastSessionId(projectRoot);
374
+ report.info(`${paths.sessionsDir} — ${ids.length} session${ids.length === 1 ? '' : 's'}`);
375
+ report.info(last === undefined ? 'resume pointer: none' : `resume pointer: ${last}`);
376
+ }
377
+ function reportVersions(report) {
378
+ report.section('versions');
379
+ report.info(`darwin ${DARWIN_VERSION}`);
380
+ report.info(`node ${process.version}`);
381
+ report.info(`platform ${os.platform()} ${os.release()} (${os.arch()})`);
382
+ }
383
+ // ---------------------------------------------------------------------------
384
+ // Helpers
385
+ // ---------------------------------------------------------------------------
386
+ function boundLine(text) {
387
+ const flat = text.replace(/\s*\n\s*/g, ' ');
388
+ const points = [...flat];
389
+ return points.length > MAX_DOCTOR_LINE_CHARS ? `${points.slice(0, MAX_DOCTOR_LINE_CHARS - 1).join('')}…` : flat;
390
+ }
391
+ function isInside(root, candidate) {
392
+ const relative = path.relative(root, candidate);
393
+ return relative === '' || (!relative.startsWith(`..${path.sep}`) && relative !== '..' && !path.isAbsolute(relative));
394
+ }
395
+ function describe(error) {
396
+ return error instanceof Error ? error.message : String(error);
397
+ }
398
+ //# sourceMappingURL=cli-doctor.js.map