@qduc/term2 0.11.0 → 0.12.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1278) hide show
  1. package/README.md +6 -4
  2. package/dist/agent.d.ts +21 -13
  3. package/dist/agent.d.ts.map +1 -1
  4. package/dist/agent.js +123 -35
  5. package/dist/agent.js.map +1 -1
  6. package/dist/app.d.ts +3 -1
  7. package/dist/app.d.ts.map +1 -1
  8. package/dist/app.js +283 -128
  9. package/dist/app.js.map +1 -1
  10. package/dist/cli.js +91 -27
  11. package/dist/cli.js.map +1 -1
  12. package/dist/commands/auto-approve-command.js.map +1 -1
  13. package/dist/commands/mode-commands.js.map +1 -1
  14. package/dist/commands/retry-tool-command.d.ts +13 -0
  15. package/dist/commands/retry-tool-command.d.ts.map +1 -0
  16. package/dist/commands/retry-tool-command.js +20 -0
  17. package/dist/commands/retry-tool-command.js.map +1 -0
  18. package/dist/commands/rewind-command.d.ts +37 -0
  19. package/dist/commands/rewind-command.d.ts.map +1 -0
  20. package/dist/commands/rewind-command.js +97 -0
  21. package/dist/commands/rewind-command.js.map +1 -0
  22. package/dist/commands/sandbox-command.js.map +1 -1
  23. package/dist/components/InputBox.d.ts +18 -32
  24. package/dist/components/InputBox.d.ts.map +1 -1
  25. package/dist/components/InputBox.js +178 -579
  26. package/dist/components/InputBox.js.map +1 -1
  27. package/dist/components/input/ApplicationInputSurface.d.ts +37 -0
  28. package/dist/components/input/ApplicationInputSurface.d.ts.map +1 -0
  29. package/dist/components/input/ApplicationInputSurface.js +78 -0
  30. package/dist/components/input/ApplicationInputSurface.js.map +1 -0
  31. package/dist/components/input/MenuStackHost.d.ts +12 -0
  32. package/dist/components/input/MenuStackHost.d.ts.map +1 -0
  33. package/dist/components/input/MenuStackHost.js +13 -0
  34. package/dist/components/input/MenuStackHost.js.map +1 -0
  35. package/dist/components/input/MenuSurface.d.ts +13 -0
  36. package/dist/components/input/MenuSurface.d.ts.map +1 -0
  37. package/dist/components/input/MenuSurface.js +86 -0
  38. package/dist/components/input/MenuSurface.js.map +1 -0
  39. package/dist/components/input/ModelMenuSession.d.ts +19 -0
  40. package/dist/components/input/ModelMenuSession.d.ts.map +1 -0
  41. package/dist/components/input/ModelMenuSession.js +144 -0
  42. package/dist/components/input/ModelMenuSession.js.map +1 -0
  43. package/dist/components/input/PathMenuSession.d.ts +16 -0
  44. package/dist/components/input/PathMenuSession.d.ts.map +1 -0
  45. package/dist/components/input/PathMenuSession.js +68 -0
  46. package/dist/components/input/PathMenuSession.js.map +1 -0
  47. package/dist/components/input/PendingQueueList.d.ts +20 -0
  48. package/dist/components/input/PendingQueueList.d.ts.map +1 -0
  49. package/dist/components/input/PendingQueueList.js +26 -0
  50. package/dist/components/input/PendingQueueList.js.map +1 -0
  51. package/dist/components/input/ProviderMenuSession.d.ts +16 -0
  52. package/dist/components/input/ProviderMenuSession.d.ts.map +1 -0
  53. package/dist/components/input/ProviderMenuSession.js +93 -0
  54. package/dist/components/input/ProviderMenuSession.js.map +1 -0
  55. package/dist/components/input/RewindMenuSession.d.ts +14 -0
  56. package/dist/components/input/RewindMenuSession.d.ts.map +1 -0
  57. package/dist/components/input/RewindMenuSession.js +77 -0
  58. package/dist/components/input/RewindMenuSession.js.map +1 -0
  59. package/dist/components/input/SettingsMenuSession.d.ts +17 -0
  60. package/dist/components/input/SettingsMenuSession.d.ts.map +1 -0
  61. package/dist/components/input/SettingsMenuSession.js +136 -0
  62. package/dist/components/input/SettingsMenuSession.js.map +1 -0
  63. package/dist/components/input/SettingsValueMenuSession.d.ts +19 -0
  64. package/dist/components/input/SettingsValueMenuSession.d.ts.map +1 -0
  65. package/dist/components/input/SettingsValueMenuSession.js +113 -0
  66. package/dist/components/input/SettingsValueMenuSession.js.map +1 -0
  67. package/dist/components/input/SkillsMenuSession.d.ts +16 -0
  68. package/dist/components/input/SkillsMenuSession.d.ts.map +1 -0
  69. package/dist/components/input/SkillsMenuSession.js +64 -0
  70. package/dist/components/input/SkillsMenuSession.js.map +1 -0
  71. package/dist/components/input/SlashMenuSession.d.ts +17 -0
  72. package/dist/components/input/SlashMenuSession.d.ts.map +1 -0
  73. package/dist/components/input/SlashMenuSession.js +57 -0
  74. package/dist/components/input/SlashMenuSession.js.map +1 -0
  75. package/dist/components/input/determine-active-menu.d.ts +2 -0
  76. package/dist/components/input/determine-active-menu.d.ts.map +1 -1
  77. package/dist/components/input/determine-active-menu.js +12 -4
  78. package/dist/components/input/determine-active-menu.js.map +1 -1
  79. package/dist/components/input/insertions.d.ts +0 -13
  80. package/dist/components/input/insertions.d.ts.map +1 -1
  81. package/dist/components/input/insertions.js +0 -26
  82. package/dist/components/input/insertions.js.map +1 -1
  83. package/dist/components/input/menu-controller.d.ts +52 -0
  84. package/dist/components/input/menu-controller.d.ts.map +1 -0
  85. package/dist/components/input/menu-controller.js +690 -0
  86. package/dist/components/input/menu-controller.js.map +1 -0
  87. package/dist/components/input/menu-editor.d.ts +9 -0
  88. package/dist/components/input/menu-editor.d.ts.map +1 -0
  89. package/dist/components/input/menu-editor.js +45 -0
  90. package/dist/components/input/menu-editor.js.map +1 -0
  91. package/dist/components/input/menu-registry.d.ts +20 -0
  92. package/dist/components/input/menu-registry.d.ts.map +1 -0
  93. package/dist/components/input/menu-registry.js +25 -0
  94. package/dist/components/input/menu-registry.js.map +1 -0
  95. package/dist/components/input/menu-types.d.ts +320 -0
  96. package/dist/components/input/menu-types.d.ts.map +1 -0
  97. package/dist/components/input/menu-types.js +2 -0
  98. package/dist/components/input/menu-types.js.map +1 -0
  99. package/dist/components/input/settings-intent-host.d.ts +22 -0
  100. package/dist/components/input/settings-intent-host.d.ts.map +1 -0
  101. package/dist/components/input/settings-intent-host.js +69 -0
  102. package/dist/components/input/settings-intent-host.js.map +1 -0
  103. package/dist/components/input/triggers.d.ts +3 -0
  104. package/dist/components/input/triggers.d.ts.map +1 -1
  105. package/dist/components/input/triggers.js +258 -0
  106. package/dist/components/input/triggers.js.map +1 -1
  107. package/dist/components/layout/BackgroundTaskManager.d.ts +16 -0
  108. package/dist/components/layout/BackgroundTaskManager.d.ts.map +1 -0
  109. package/dist/components/layout/BackgroundTaskManager.js +236 -0
  110. package/dist/components/layout/BackgroundTaskManager.js.map +1 -0
  111. package/dist/components/layout/BackgroundTasksPanel.d.ts +2 -2
  112. package/dist/components/layout/BackgroundTasksPanel.d.ts.map +1 -1
  113. package/dist/components/layout/BackgroundTasksPanel.js +64 -24
  114. package/dist/components/layout/BackgroundTasksPanel.js.map +1 -1
  115. package/dist/components/layout/Banner.js.map +1 -1
  116. package/dist/components/layout/BottomArea.d.ts +23 -19
  117. package/dist/components/layout/BottomArea.d.ts.map +1 -1
  118. package/dist/components/layout/BottomArea.js +74 -48
  119. package/dist/components/layout/BottomArea.js.map +1 -1
  120. package/dist/components/layout/StatusBar.d.ts +3 -1
  121. package/dist/components/layout/StatusBar.d.ts.map +1 -1
  122. package/dist/components/layout/StatusBar.js +102 -83
  123. package/dist/components/layout/StatusBar.js.map +1 -1
  124. package/dist/components/menu/ModelSelectionMenu.js.map +1 -1
  125. package/dist/components/menu/RewindMenu.d.ts +18 -0
  126. package/dist/components/menu/RewindMenu.d.ts.map +1 -0
  127. package/dist/components/menu/RewindMenu.js +59 -0
  128. package/dist/components/menu/RewindMenu.js.map +1 -0
  129. package/dist/components/message/ChatMessage.d.ts +2 -1
  130. package/dist/components/message/ChatMessage.d.ts.map +1 -1
  131. package/dist/components/message/ChatMessage.js +1 -1
  132. package/dist/components/message/ChatMessage.js.map +1 -1
  133. package/dist/components/message/CommandMessage.d.ts.map +1 -1
  134. package/dist/components/message/CommandMessage.js +138 -15
  135. package/dist/components/message/CommandMessage.js.map +1 -1
  136. package/dist/components/message/MemoryRenderer.d.ts.map +1 -1
  137. package/dist/components/message/MemoryRenderer.js +16 -10
  138. package/dist/components/message/MemoryRenderer.js.map +1 -1
  139. package/dist/components/message/MessageList.d.ts +20 -3
  140. package/dist/components/message/MessageList.d.ts.map +1 -1
  141. package/dist/components/message/MessageList.js +1 -1
  142. package/dist/components/message/MessageList.js.map +1 -1
  143. package/dist/components/message/SubagentActivityMessage.d.ts +5 -1
  144. package/dist/components/message/SubagentActivityMessage.d.ts.map +1 -1
  145. package/dist/components/message/SubagentActivityMessage.js +12 -4
  146. package/dist/components/message/SubagentActivityMessage.js.map +1 -1
  147. package/dist/components/message/command-message-helpers.d.ts +40 -3
  148. package/dist/components/message/command-message-helpers.d.ts.map +1 -1
  149. package/dist/components/message/command-message-helpers.js +49 -8
  150. package/dist/components/message/command-message-helpers.js.map +1 -1
  151. package/dist/components/prompt/ApprovalPrompt.d.ts +1 -0
  152. package/dist/components/prompt/ApprovalPrompt.d.ts.map +1 -1
  153. package/dist/components/prompt/ApprovalPrompt.js +136 -59
  154. package/dist/components/prompt/ApprovalPrompt.js.map +1 -1
  155. package/dist/context/InputContext.d.ts +15 -8
  156. package/dist/context/InputContext.d.ts.map +1 -1
  157. package/dist/context/InputContext.js +92 -15
  158. package/dist/context/InputContext.js.map +1 -1
  159. package/dist/contracts/application-stream.d.ts +38 -0
  160. package/dist/contracts/application-stream.d.ts.map +1 -0
  161. package/dist/contracts/application-stream.js +2 -0
  162. package/dist/contracts/application-stream.js.map +1 -0
  163. package/dist/contracts/continuation-handle.d.ts +18 -0
  164. package/dist/contracts/continuation-handle.d.ts.map +1 -0
  165. package/dist/contracts/continuation-handle.js +22 -0
  166. package/dist/contracts/continuation-handle.js.map +1 -0
  167. package/dist/contracts/conversation-items.d.ts +47 -0
  168. package/dist/contracts/conversation-items.d.ts.map +1 -0
  169. package/dist/contracts/conversation-items.js +2 -0
  170. package/dist/contracts/conversation-items.js.map +1 -0
  171. package/dist/contracts/conversation.d.ts +44 -4
  172. package/dist/contracts/conversation.d.ts.map +1 -1
  173. package/dist/contracts/conversation.js +9 -0
  174. package/dist/contracts/conversation.js.map +1 -1
  175. package/dist/contracts/model-errors.d.ts +10 -0
  176. package/dist/contracts/model-errors.d.ts.map +1 -0
  177. package/dist/contracts/model-errors.js +15 -0
  178. package/dist/contracts/model-errors.js.map +1 -0
  179. package/dist/contracts/model-types.d.ts +16 -0
  180. package/dist/contracts/model-types.d.ts.map +1 -0
  181. package/dist/contracts/model-types.js +2 -0
  182. package/dist/contracts/model-types.js.map +1 -0
  183. package/dist/contracts/patch.d.ts +17 -0
  184. package/dist/contracts/patch.d.ts.map +1 -0
  185. package/dist/contracts/patch.js +2 -0
  186. package/dist/contracts/patch.js.map +1 -0
  187. package/dist/contracts/provider-input.d.ts +34 -0
  188. package/dist/contracts/provider-input.d.ts.map +1 -0
  189. package/dist/contracts/provider-input.js +2 -0
  190. package/dist/contracts/provider-input.js.map +1 -0
  191. package/dist/contracts/streamed-model-turn.d.ts +230 -0
  192. package/dist/contracts/streamed-model-turn.d.ts.map +1 -0
  193. package/dist/contracts/streamed-model-turn.js +2 -0
  194. package/dist/contracts/streamed-model-turn.js.map +1 -0
  195. package/dist/env-setup.js +1 -1
  196. package/dist/hooks/conversation-ui-reducer.d.ts +27 -4
  197. package/dist/hooks/conversation-ui-reducer.d.ts.map +1 -1
  198. package/dist/hooks/conversation-ui-reducer.js +51 -4
  199. package/dist/hooks/conversation-ui-reducer.js.map +1 -1
  200. package/dist/hooks/handoff-flow-reducer.d.ts +1 -36
  201. package/dist/hooks/handoff-flow-reducer.d.ts.map +1 -1
  202. package/dist/hooks/handoff-flow-reducer.js +3 -57
  203. package/dist/hooks/handoff-flow-reducer.js.map +1 -1
  204. package/dist/hooks/settings-completion-config.d.ts +1 -0
  205. package/dist/hooks/settings-completion-config.d.ts.map +1 -1
  206. package/dist/hooks/settings-completion-config.js +30 -6
  207. package/dist/hooks/settings-completion-config.js.map +1 -1
  208. package/dist/hooks/use-app-commands.d.ts +13 -11
  209. package/dist/hooks/use-app-commands.d.ts.map +1 -1
  210. package/dist/hooks/use-app-commands.js +90 -63
  211. package/dist/hooks/use-app-commands.js.map +1 -1
  212. package/dist/hooks/use-app-keyboard-shortcuts.d.ts +18 -1
  213. package/dist/hooks/use-app-keyboard-shortcuts.d.ts.map +1 -1
  214. package/dist/hooks/use-app-keyboard-shortcuts.js +77 -8
  215. package/dist/hooks/use-app-keyboard-shortcuts.js.map +1 -1
  216. package/dist/hooks/use-conversation.d.ts +30 -13
  217. package/dist/hooks/use-conversation.d.ts.map +1 -1
  218. package/dist/hooks/use-conversation.js +85 -18
  219. package/dist/hooks/use-conversation.js.map +1 -1
  220. package/dist/hooks/use-escape-key.d.ts +4 -32
  221. package/dist/hooks/use-escape-key.d.ts.map +1 -1
  222. package/dist/hooks/use-escape-key.js +27 -68
  223. package/dist/hooks/use-escape-key.js.map +1 -1
  224. package/dist/hooks/use-handoff-flow.d.ts +6 -6
  225. package/dist/hooks/use-handoff-flow.d.ts.map +1 -1
  226. package/dist/hooks/use-handoff-flow.js +110 -118
  227. package/dist/hooks/use-handoff-flow.js.map +1 -1
  228. package/dist/hooks/use-model-selection.d.ts.map +1 -1
  229. package/dist/hooks/use-model-selection.js +50 -59
  230. package/dist/hooks/use-model-selection.js.map +1 -1
  231. package/dist/hooks/use-path-completion.d.ts.map +1 -1
  232. package/dist/hooks/use-path-completion.js +20 -11
  233. package/dist/hooks/use-path-completion.js.map +1 -1
  234. package/dist/hooks/use-provider-selection.d.ts.map +1 -1
  235. package/dist/hooks/use-provider-selection.js +19 -16
  236. package/dist/hooks/use-provider-selection.js.map +1 -1
  237. package/dist/hooks/use-rewind-selection.d.ts +30 -0
  238. package/dist/hooks/use-rewind-selection.d.ts.map +1 -0
  239. package/dist/hooks/{use-undo-selection.js → use-rewind-selection.js} +37 -28
  240. package/dist/hooks/use-rewind-selection.js.map +1 -0
  241. package/dist/hooks/use-runtime-settings.d.ts.map +1 -1
  242. package/dist/hooks/use-runtime-settings.js +4 -3
  243. package/dist/hooks/use-runtime-settings.js.map +1 -1
  244. package/dist/hooks/use-selection.d.ts +1 -0
  245. package/dist/hooks/use-selection.d.ts.map +1 -1
  246. package/dist/hooks/use-selection.js +1 -1
  247. package/dist/hooks/use-selection.js.map +1 -1
  248. package/dist/hooks/use-setting.d.ts +3 -2
  249. package/dist/hooks/use-setting.d.ts.map +1 -1
  250. package/dist/hooks/use-setting.js +1 -1
  251. package/dist/hooks/use-setting.js.map +1 -1
  252. package/dist/hooks/use-settings-completion.d.ts +1 -0
  253. package/dist/hooks/use-settings-completion.d.ts.map +1 -1
  254. package/dist/hooks/use-settings-completion.js +22 -15
  255. package/dist/hooks/use-settings-completion.js.map +1 -1
  256. package/dist/hooks/use-settings-value-completion.d.ts.map +1 -1
  257. package/dist/hooks/use-settings-value-completion.js +40 -28
  258. package/dist/hooks/use-settings-value-completion.js.map +1 -1
  259. package/dist/hooks/use-shell-mode.d.ts +3 -13
  260. package/dist/hooks/use-shell-mode.d.ts.map +1 -1
  261. package/dist/hooks/use-shell-mode.js +14 -53
  262. package/dist/hooks/use-shell-mode.js.map +1 -1
  263. package/dist/hooks/use-skill-selection.d.ts.map +1 -1
  264. package/dist/hooks/use-skill-selection.js +17 -11
  265. package/dist/hooks/use-skill-selection.js.map +1 -1
  266. package/dist/hooks/use-slash-commands.d.ts.map +1 -1
  267. package/dist/hooks/use-slash-commands.js +11 -10
  268. package/dist/hooks/use-slash-commands.js.map +1 -1
  269. package/dist/hooks/use-terminal-focus-notifier.js.map +1 -1
  270. package/dist/lib/agent-chat-service.d.ts +12 -8
  271. package/dist/lib/agent-chat-service.d.ts.map +1 -1
  272. package/dist/lib/agent-chat-service.js +79 -44
  273. package/dist/lib/agent-chat-service.js.map +1 -1
  274. package/dist/lib/agent-client.d.ts +93 -17
  275. package/dist/lib/agent-client.d.ts.map +1 -1
  276. package/dist/lib/agent-client.js +398 -37
  277. package/dist/lib/agent-client.js.map +1 -1
  278. package/dist/lib/agent-configuration.d.ts +33 -15
  279. package/dist/lib/agent-configuration.d.ts.map +1 -1
  280. package/dist/lib/agent-configuration.js +107 -9
  281. package/dist/lib/agent-configuration.js.map +1 -1
  282. package/dist/lib/agent-factory.d.ts +33 -4
  283. package/dist/lib/agent-factory.d.ts.map +1 -1
  284. package/dist/lib/agent-factory.js +140 -101
  285. package/dist/lib/agent-factory.js.map +1 -1
  286. package/dist/lib/chained-input-filter.d.ts +27 -1
  287. package/dist/lib/chained-input-filter.d.ts.map +1 -1
  288. package/dist/lib/chained-input-filter.js +92 -33
  289. package/dist/lib/chained-input-filter.js.map +1 -1
  290. package/dist/lib/continuation-projection-mode.d.ts +3 -0
  291. package/dist/lib/continuation-projection-mode.d.ts.map +1 -0
  292. package/dist/lib/continuation-projection-mode.js +2 -0
  293. package/dist/lib/continuation-projection-mode.js.map +1 -0
  294. package/dist/lib/editor-impl.d.ts +1 -1
  295. package/dist/lib/editor-impl.d.ts.map +1 -1
  296. package/dist/lib/editor-impl.js +1 -1
  297. package/dist/lib/editor-impl.js.map +1 -1
  298. package/dist/lib/harness-invariant-error.d.ts +22 -0
  299. package/dist/lib/harness-invariant-error.d.ts.map +1 -0
  300. package/dist/lib/harness-invariant-error.js +30 -0
  301. package/dist/lib/harness-invariant-error.js.map +1 -0
  302. package/dist/lib/input-owner.d.ts +64 -0
  303. package/dist/lib/input-owner.d.ts.map +1 -0
  304. package/dist/lib/input-owner.js +34 -0
  305. package/dist/lib/input-owner.js.map +1 -0
  306. package/dist/lib/openai-strict-tool-schema.d.ts +7 -4
  307. package/dist/lib/openai-strict-tool-schema.d.ts.map +1 -1
  308. package/dist/lib/openai-strict-tool-schema.js +8 -0
  309. package/dist/lib/openai-strict-tool-schema.js.map +1 -1
  310. package/dist/lib/subagent-bridge.d.ts +54 -3
  311. package/dist/lib/subagent-bridge.d.ts.map +1 -1
  312. package/dist/lib/subagent-bridge.js +118 -20
  313. package/dist/lib/subagent-bridge.js.map +1 -1
  314. package/dist/lib/tool-invoke.d.ts +18 -10
  315. package/dist/lib/tool-invoke.d.ts.map +1 -1
  316. package/dist/lib/tool-invoke.js +92 -44
  317. package/dist/lib/tool-invoke.js.map +1 -1
  318. package/dist/non-interactive.d.ts +14 -4
  319. package/dist/non-interactive.d.ts.map +1 -1
  320. package/dist/non-interactive.js +91 -84
  321. package/dist/non-interactive.js.map +1 -1
  322. package/dist/prompts/anthropic.md +6 -55
  323. package/dist/prompts/async-subagent-delegation.d.ts +3 -5
  324. package/dist/prompts/async-subagent-delegation.d.ts.map +1 -1
  325. package/dist/prompts/async-subagent-delegation.js +10 -34
  326. package/dist/prompts/async-subagent-delegation.js.map +1 -1
  327. package/dist/prompts/async-subagent-delegation.ts +11 -40
  328. package/dist/prompts/gpt-5.6.md +49 -0
  329. package/dist/prompts/kimi.md +25 -63
  330. package/dist/prompts/memory.md +1 -1
  331. package/dist/prompts/orchestrator-prompt.test.ts +92 -0
  332. package/dist/prompts/orchestrator.md +20 -4
  333. package/dist/prompts/plan-mode-info.md +1 -1
  334. package/dist/prompts/prompt-constructor.d.ts +2 -0
  335. package/dist/prompts/prompt-constructor.d.ts.map +1 -1
  336. package/dist/prompts/prompt-constructor.js +9 -7
  337. package/dist/prompts/prompt-constructor.js.map +1 -1
  338. package/dist/prompts/prompt-constructor.test.ts +30 -8
  339. package/dist/prompts/prompt-constructor.ts +14 -7
  340. package/dist/prompts/prompt-profiles.d.ts.map +1 -1
  341. package/dist/prompts/prompt-profiles.js +5 -0
  342. package/dist/prompts/prompt-profiles.js.map +1 -1
  343. package/dist/prompts/prompt-profiles.test.ts +20 -0
  344. package/dist/prompts/prompt-profiles.ts +5 -0
  345. package/dist/prompts/search-via-shell.d.ts.map +1 -1
  346. package/dist/prompts/search-via-shell.js +8 -25
  347. package/dist/prompts/search-via-shell.js.map +1 -1
  348. package/dist/prompts/search-via-shell.test.ts +18 -0
  349. package/dist/prompts/search-via-shell.ts +8 -25
  350. package/dist/prompts/shell-auto-approval.d.ts +2 -2
  351. package/dist/prompts/shell-auto-approval.d.ts.map +1 -1
  352. package/dist/prompts/shell-auto-approval.js +20 -5
  353. package/dist/prompts/shell-auto-approval.js.map +1 -1
  354. package/dist/prompts/shell-auto-approval.ts +20 -5
  355. package/dist/prompts/steering-notice.d.ts +16 -0
  356. package/dist/prompts/steering-notice.d.ts.map +1 -0
  357. package/dist/prompts/steering-notice.js +24 -0
  358. package/dist/prompts/steering-notice.js.map +1 -0
  359. package/dist/prompts/steering-notice.ts +24 -0
  360. package/dist/prompts/subagent-delegation.d.ts +6 -5
  361. package/dist/prompts/subagent-delegation.d.ts.map +1 -1
  362. package/dist/prompts/subagent-delegation.js +36 -13
  363. package/dist/prompts/subagent-delegation.js.map +1 -1
  364. package/dist/prompts/subagent-delegation.test.ts +24 -2
  365. package/dist/prompts/subagent-delegation.ts +54 -14
  366. package/dist/prompts/subagents/explorer.md +24 -14
  367. package/dist/prompts/subagents/worker-prompt.test.ts +35 -0
  368. package/dist/prompts/subagents/worker.md +8 -0
  369. package/dist/prompts/worktree-hygiene.md +1 -0
  370. package/dist/providers/ai-sdk-anthropic.provider.d.ts +3 -3
  371. package/dist/providers/ai-sdk-anthropic.provider.d.ts.map +1 -1
  372. package/dist/providers/ai-sdk-anthropic.provider.js +8 -4
  373. package/dist/providers/ai-sdk-anthropic.provider.js.map +1 -1
  374. package/dist/providers/ai-sdk-google.provider.d.ts +5 -4
  375. package/dist/providers/ai-sdk-google.provider.d.ts.map +1 -1
  376. package/dist/providers/ai-sdk-google.provider.js +23 -3
  377. package/dist/providers/ai-sdk-google.provider.js.map +1 -1
  378. package/dist/providers/ai-sdk-message-normalizer.d.ts +3 -7
  379. package/dist/providers/ai-sdk-message-normalizer.d.ts.map +1 -1
  380. package/dist/providers/ai-sdk-message-normalizer.js +27 -11
  381. package/dist/providers/ai-sdk-message-normalizer.js.map +1 -1
  382. package/dist/providers/ai-sdk-openrouter.provider.d.ts +5 -4
  383. package/dist/providers/ai-sdk-openrouter.provider.d.ts.map +1 -1
  384. package/dist/providers/ai-sdk-openrouter.provider.js +25 -3
  385. package/dist/providers/ai-sdk-openrouter.provider.js.map +1 -1
  386. package/dist/providers/ai-sdk-provider-settings.d.ts +10 -0
  387. package/dist/providers/ai-sdk-provider-settings.d.ts.map +1 -0
  388. package/dist/providers/ai-sdk-provider-settings.js +37 -0
  389. package/dist/providers/ai-sdk-provider-settings.js.map +1 -0
  390. package/dist/providers/ai-sdk-streamed-model.d.ts +5 -0
  391. package/dist/providers/ai-sdk-streamed-model.d.ts.map +1 -0
  392. package/dist/providers/ai-sdk-streamed-model.js +338 -0
  393. package/dist/providers/ai-sdk-streamed-model.js.map +1 -0
  394. package/dist/providers/codex-responses-model.d.ts +39 -12
  395. package/dist/providers/codex-responses-model.d.ts.map +1 -1
  396. package/dist/providers/codex-responses-model.js +656 -155
  397. package/dist/providers/codex-responses-model.js.map +1 -1
  398. package/dist/providers/codex-turn-converter.d.ts +12 -0
  399. package/dist/providers/codex-turn-converter.d.ts.map +1 -0
  400. package/dist/providers/codex-turn-converter.js +168 -0
  401. package/dist/providers/codex-turn-converter.js.map +1 -0
  402. package/dist/providers/codex.provider.d.ts +21 -0
  403. package/dist/providers/codex.provider.d.ts.map +1 -1
  404. package/dist/providers/codex.provider.js +57 -27
  405. package/dist/providers/codex.provider.js.map +1 -1
  406. package/dist/providers/common/openai-compatible-message-contract.d.ts +8 -0
  407. package/dist/providers/common/openai-compatible-message-contract.d.ts.map +1 -0
  408. package/dist/providers/common/openai-compatible-message-contract.js +23 -0
  409. package/dist/providers/common/openai-compatible-message-contract.js.map +1 -0
  410. package/dist/providers/common/openai-compatible-messages.d.ts +0 -4
  411. package/dist/providers/common/openai-compatible-messages.d.ts.map +1 -1
  412. package/dist/providers/common/openai-compatible-messages.js +0 -288
  413. package/dist/providers/common/openai-compatible-messages.js.map +1 -1
  414. package/dist/providers/fetch/composer.d.ts.map +1 -1
  415. package/dist/providers/fetch/composer.js +1 -0
  416. package/dist/providers/fetch/composer.js.map +1 -1
  417. package/dist/providers/model-catalog/catalog.d.ts +31 -0
  418. package/dist/providers/model-catalog/catalog.d.ts.map +1 -0
  419. package/dist/providers/model-catalog/catalog.generated.d.ts +3010 -0
  420. package/dist/providers/model-catalog/catalog.generated.d.ts.map +1 -0
  421. package/dist/providers/model-catalog/catalog.generated.js +3004 -0
  422. package/dist/providers/model-catalog/catalog.generated.js.map +1 -0
  423. package/dist/providers/model-catalog/catalog.js +62 -0
  424. package/dist/providers/model-catalog/catalog.js.map +1 -0
  425. package/dist/providers/model-catalog/generate-catalog.d.ts +42 -0
  426. package/dist/providers/model-catalog/generate-catalog.d.ts.map +1 -0
  427. package/dist/providers/model-catalog/generate-catalog.js +96 -0
  428. package/dist/providers/model-catalog/generate-catalog.js.map +1 -0
  429. package/dist/providers/openai-chained-input-compatibility.d.ts +36 -0
  430. package/dist/providers/openai-chained-input-compatibility.d.ts.map +1 -0
  431. package/dist/providers/openai-chained-input-compatibility.js +60 -0
  432. package/dist/providers/openai-chained-input-compatibility.js.map +1 -0
  433. package/dist/providers/openai-chat-completions-model.d.ts +12 -0
  434. package/dist/providers/openai-chat-completions-model.d.ts.map +1 -0
  435. package/dist/providers/openai-chat-completions-model.js +271 -0
  436. package/dist/providers/openai-chat-completions-model.js.map +1 -0
  437. package/dist/providers/openai-compatible-lazy.d.ts +1 -1
  438. package/dist/providers/openai-compatible-lazy.d.ts.map +1 -1
  439. package/dist/providers/openai-compatible-lazy.js +24 -36
  440. package/dist/providers/openai-compatible-lazy.js.map +1 -1
  441. package/dist/providers/openai-compatible-middleware.d.ts +4 -1
  442. package/dist/providers/openai-compatible-middleware.d.ts.map +1 -1
  443. package/dist/providers/openai-compatible-middleware.js +15 -14
  444. package/dist/providers/openai-compatible-middleware.js.map +1 -1
  445. package/dist/providers/openai-compatible-response-normalizer.d.ts +10 -1
  446. package/dist/providers/openai-compatible-response-normalizer.d.ts.map +1 -1
  447. package/dist/providers/openai-compatible-response-normalizer.js +15 -4
  448. package/dist/providers/openai-compatible-response-normalizer.js.map +1 -1
  449. package/dist/providers/openai-compatible.provider.d.ts +7 -10
  450. package/dist/providers/openai-compatible.provider.d.ts.map +1 -1
  451. package/dist/providers/openai-compatible.provider.js +80 -78
  452. package/dist/providers/openai-compatible.provider.js.map +1 -1
  453. package/dist/providers/openai-request-prefix-binding.d.ts +28 -0
  454. package/dist/providers/openai-request-prefix-binding.d.ts.map +1 -0
  455. package/dist/providers/openai-request-prefix-binding.js +78 -0
  456. package/dist/providers/openai-request-prefix-binding.js.map +1 -0
  457. package/dist/providers/openai-responses-model.d.ts +43 -0
  458. package/dist/providers/openai-responses-model.d.ts.map +1 -0
  459. package/dist/providers/openai-responses-model.js +564 -0
  460. package/dist/providers/openai-responses-model.js.map +1 -0
  461. package/dist/providers/openai.provider.d.ts +11 -8
  462. package/dist/providers/openai.provider.d.ts.map +1 -1
  463. package/dist/providers/openai.provider.js +43 -91
  464. package/dist/providers/openai.provider.js.map +1 -1
  465. package/dist/providers/opencode-routing.d.ts +1 -1
  466. package/dist/providers/opencode-routing.d.ts.map +1 -1
  467. package/dist/providers/opencode-routing.js +4 -2
  468. package/dist/providers/opencode-routing.js.map +1 -1
  469. package/dist/providers/opencode-session.d.ts.map +1 -1
  470. package/dist/providers/opencode-session.js +28 -3
  471. package/dist/providers/opencode-session.js.map +1 -1
  472. package/dist/providers/openrouter.provider.d.ts.map +1 -1
  473. package/dist/providers/openrouter.provider.js +33 -33
  474. package/dist/providers/openrouter.provider.js.map +1 -1
  475. package/dist/providers/provider-request-capture.d.ts +35 -0
  476. package/dist/providers/provider-request-capture.d.ts.map +1 -0
  477. package/dist/providers/provider-request-capture.js +22 -0
  478. package/dist/providers/provider-request-capture.js.map +1 -0
  479. package/dist/providers/provider-service.d.ts +9 -7
  480. package/dist/providers/provider-service.d.ts.map +1 -1
  481. package/dist/providers/provider-service.js +29 -28
  482. package/dist/providers/provider-service.js.map +1 -1
  483. package/dist/providers/registry.d.ts +14 -9
  484. package/dist/providers/registry.d.ts.map +1 -1
  485. package/dist/providers/registry.js.map +1 -1
  486. package/dist/providers/retrying-model.d.ts +8 -6
  487. package/dist/providers/retrying-model.d.ts.map +1 -1
  488. package/dist/providers/retrying-model.js +7 -20
  489. package/dist/providers/retrying-model.js.map +1 -1
  490. package/dist/providers/web-search/exa.provider.js.map +1 -1
  491. package/dist/providers/web-search/registry.js.map +1 -1
  492. package/dist/providers/web-search/tavily.provider.js.map +1 -1
  493. package/dist/providers/websocket-receive-watchdog.d.ts.map +1 -1
  494. package/dist/providers/websocket-receive-watchdog.js +9 -1
  495. package/dist/providers/websocket-receive-watchdog.js.map +1 -1
  496. package/dist/scripts/eval-auto-approval/runner.js +2 -0
  497. package/dist/scripts/eval-auto-approval/runner.js.map +1 -1
  498. package/dist/services/agent-runtime/application-run-loop.d.ts +205 -0
  499. package/dist/services/agent-runtime/application-run-loop.d.ts.map +1 -0
  500. package/dist/services/agent-runtime/application-run-loop.js +1236 -0
  501. package/dist/services/agent-runtime/application-run-loop.js.map +1 -0
  502. package/dist/services/agent-runtime/compose-agent-runtime.d.ts +3 -0
  503. package/dist/services/agent-runtime/compose-agent-runtime.d.ts.map +1 -1
  504. package/dist/services/agent-runtime/compose-agent-runtime.js +4 -0
  505. package/dist/services/agent-runtime/compose-agent-runtime.js.map +1 -1
  506. package/dist/services/agent-runtime/generation-guard.d.ts +69 -0
  507. package/dist/services/agent-runtime/generation-guard.d.ts.map +1 -0
  508. package/dist/services/agent-runtime/generation-guard.js +270 -0
  509. package/dist/services/agent-runtime/generation-guard.js.map +1 -0
  510. package/dist/services/agent-runtime/model-resolver.d.ts.map +1 -1
  511. package/dist/services/agent-runtime/model-resolver.js +7 -6
  512. package/dist/services/agent-runtime/model-resolver.js.map +1 -1
  513. package/dist/services/agent-runtime/structured-output.d.ts.map +1 -1
  514. package/dist/services/agent-runtime/structured-output.js +1 -21
  515. package/dist/services/agent-runtime/structured-output.js.map +1 -1
  516. package/dist/services/agent-runtime/tool-invocation-context.d.ts +73 -0
  517. package/dist/services/agent-runtime/tool-invocation-context.d.ts.map +1 -0
  518. package/dist/services/agent-runtime/tool-invocation-context.js +66 -0
  519. package/dist/services/agent-runtime/tool-invocation-context.js.map +1 -0
  520. package/dist/services/agent-stream.d.ts +41 -2
  521. package/dist/services/agent-stream.d.ts.map +1 -1
  522. package/dist/services/agent-stream.js +46 -1
  523. package/dist/services/agent-stream.js.map +1 -1
  524. package/dist/services/approval/approval-decision-executor.d.ts +42 -0
  525. package/dist/services/approval/approval-decision-executor.d.ts.map +1 -0
  526. package/dist/services/approval/approval-decision-executor.js +207 -0
  527. package/dist/services/approval/approval-decision-executor.js.map +1 -0
  528. package/dist/services/approval/approval-flow-coordinator.d.ts +25 -8
  529. package/dist/services/approval/approval-flow-coordinator.d.ts.map +1 -1
  530. package/dist/services/approval/approval-flow-coordinator.js +34 -167
  531. package/dist/services/approval/approval-flow-coordinator.js.map +1 -1
  532. package/dist/services/approval/approval-replay.d.ts +52 -0
  533. package/dist/services/approval/approval-replay.d.ts.map +1 -0
  534. package/dist/services/approval/approval-replay.js +68 -0
  535. package/dist/services/approval/approval-replay.js.map +1 -0
  536. package/dist/services/approval/approval-state.d.ts +3 -6
  537. package/dist/services/approval/approval-state.d.ts.map +1 -1
  538. package/dist/services/approval/approval-state.js +0 -10
  539. package/dist/services/approval/approval-state.js.map +1 -1
  540. package/dist/services/approval/background-subagent-approval-controller.d.ts +25 -0
  541. package/dist/services/approval/background-subagent-approval-controller.d.ts.map +1 -0
  542. package/dist/services/approval/background-subagent-approval-controller.js +65 -0
  543. package/dist/services/approval/background-subagent-approval-controller.js.map +1 -0
  544. package/dist/services/approval/background-subagent-approval-queue.d.ts +137 -0
  545. package/dist/services/approval/background-subagent-approval-queue.d.ts.map +1 -0
  546. package/dist/services/approval/background-subagent-approval-queue.js +200 -0
  547. package/dist/services/approval/background-subagent-approval-queue.js.map +1 -0
  548. package/dist/services/approval/non-interactive-approval-policy.d.ts +33 -0
  549. package/dist/services/approval/non-interactive-approval-policy.d.ts.map +1 -0
  550. package/dist/services/approval/non-interactive-approval-policy.js +85 -0
  551. package/dist/services/approval/non-interactive-approval-policy.js.map +1 -0
  552. package/dist/services/approval/session-read-access.d.ts +10 -0
  553. package/dist/services/approval/session-read-access.d.ts.map +1 -1
  554. package/dist/services/approval/session-read-access.js +12 -0
  555. package/dist/services/approval/session-read-access.js.map +1 -1
  556. package/dist/services/approval/session-read-grant-target.d.ts +7 -0
  557. package/dist/services/approval/session-read-grant-target.d.ts.map +1 -0
  558. package/dist/services/approval/session-read-grant-target.js +36 -0
  559. package/dist/services/approval/session-read-grant-target.js.map +1 -0
  560. package/dist/services/approval/shell-auto-approval-evaluator.d.ts +11 -3
  561. package/dist/services/approval/shell-auto-approval-evaluator.d.ts.map +1 -1
  562. package/dist/services/approval/shell-auto-approval-evaluator.js +140 -46
  563. package/dist/services/approval/shell-auto-approval-evaluator.js.map +1 -1
  564. package/dist/services/approval/shell-auto-approval-resolver.d.ts +13 -0
  565. package/dist/services/approval/shell-auto-approval-resolver.d.ts.map +1 -1
  566. package/dist/services/approval/shell-auto-approval-resolver.js +74 -6
  567. package/dist/services/approval/shell-auto-approval-resolver.js.map +1 -1
  568. package/dist/services/approval/shell-sandbox-approval.d.ts +22 -1
  569. package/dist/services/approval/shell-sandbox-approval.d.ts.map +1 -1
  570. package/dist/services/approval/shell-sandbox-approval.js +31 -4
  571. package/dist/services/approval/shell-sandbox-approval.js.map +1 -1
  572. package/dist/services/approval/tool-approval-batch-coordinator.d.ts +9 -0
  573. package/dist/services/approval/tool-approval-batch-coordinator.d.ts.map +1 -1
  574. package/dist/services/approval/tool-approval-batch-coordinator.js +20 -4
  575. package/dist/services/approval/tool-approval-batch-coordinator.js.map +1 -1
  576. package/dist/services/approval/tool-owner.d.ts +5 -2
  577. package/dist/services/approval/tool-owner.d.ts.map +1 -1
  578. package/dist/services/approval/tool-owner.js +0 -56
  579. package/dist/services/approval/tool-owner.js.map +1 -1
  580. package/dist/services/approval/tool-ownership-registry.d.ts +25 -0
  581. package/dist/services/approval/tool-ownership-registry.d.ts.map +1 -0
  582. package/dist/services/approval/tool-ownership-registry.js +63 -0
  583. package/dist/services/approval/tool-ownership-registry.js.map +1 -0
  584. package/dist/services/command-message-streaming.d.ts +8 -4
  585. package/dist/services/command-message-streaming.d.ts.map +1 -1
  586. package/dist/services/command-message-streaming.js +13 -52
  587. package/dist/services/command-message-streaming.js.map +1 -1
  588. package/dist/services/conversation/conversation-adapter-factory.d.ts.map +1 -1
  589. package/dist/services/conversation/conversation-adapter-factory.js +1 -0
  590. package/dist/services/conversation/conversation-adapter-factory.js.map +1 -1
  591. package/dist/services/conversation/conversation-adapter.d.ts +120 -13
  592. package/dist/services/conversation/conversation-adapter.d.ts.map +1 -1
  593. package/dist/services/conversation/conversation-adapter.js +378 -63
  594. package/dist/services/conversation/conversation-adapter.js.map +1 -1
  595. package/dist/services/conversation/conversation-admission-workflow.d.ts +69 -0
  596. package/dist/services/conversation/conversation-admission-workflow.d.ts.map +1 -0
  597. package/dist/services/conversation/conversation-admission-workflow.js +110 -0
  598. package/dist/services/conversation/conversation-admission-workflow.js.map +1 -0
  599. package/dist/services/conversation/conversation-decoder.d.ts +14 -0
  600. package/dist/services/conversation/conversation-decoder.d.ts.map +1 -0
  601. package/dist/services/conversation/conversation-decoder.js +149 -0
  602. package/dist/services/conversation/conversation-decoder.js.map +1 -0
  603. package/dist/services/conversation/conversation-events.d.ts +72 -24
  604. package/dist/services/conversation/conversation-events.d.ts.map +1 -1
  605. package/dist/services/conversation/conversation-history-repair.d.ts.map +1 -1
  606. package/dist/services/conversation/conversation-history-repair.js +34 -37
  607. package/dist/services/conversation/conversation-history-repair.js.map +1 -1
  608. package/dist/services/conversation/conversation-message-projection.d.ts +27 -0
  609. package/dist/services/conversation/conversation-message-projection.d.ts.map +1 -0
  610. package/dist/services/conversation/conversation-message-projection.js +59 -0
  611. package/dist/services/conversation/conversation-message-projection.js.map +1 -0
  612. package/dist/services/conversation/conversation-orchestrator.d.ts +23 -14
  613. package/dist/services/conversation/conversation-orchestrator.d.ts.map +1 -1
  614. package/dist/services/conversation/conversation-orchestrator.js +472 -158
  615. package/dist/services/conversation/conversation-orchestrator.js.map +1 -1
  616. package/dist/services/conversation/conversation-orchestrator.types.d.ts +16 -11
  617. package/dist/services/conversation/conversation-orchestrator.types.d.ts.map +1 -1
  618. package/dist/services/conversation/conversation-persistence-types.d.ts +15 -38
  619. package/dist/services/conversation/conversation-persistence-types.d.ts.map +1 -1
  620. package/dist/services/conversation/conversation-persistence.d.ts +3 -10
  621. package/dist/services/conversation/conversation-persistence.d.ts.map +1 -1
  622. package/dist/services/conversation/conversation-persistence.js +66 -15
  623. package/dist/services/conversation/conversation-persistence.js.map +1 -1
  624. package/dist/services/conversation/conversation-replay.d.ts +7 -5
  625. package/dist/services/conversation/conversation-replay.d.ts.map +1 -1
  626. package/dist/services/conversation/conversation-replay.js +127 -66
  627. package/dist/services/conversation/conversation-replay.js.map +1 -1
  628. package/dist/services/conversation/conversation-result-builder.d.ts +16 -2
  629. package/dist/services/conversation/conversation-result-builder.d.ts.map +1 -1
  630. package/dist/services/conversation/conversation-result-builder.js +51 -15
  631. package/dist/services/conversation/conversation-result-builder.js.map +1 -1
  632. package/dist/services/conversation/conversation-runtime-factory.d.ts +18 -0
  633. package/dist/services/conversation/conversation-runtime-factory.d.ts.map +1 -1
  634. package/dist/services/conversation/conversation-runtime-factory.js.map +1 -1
  635. package/dist/services/conversation/conversation-service.d.ts +67 -11
  636. package/dist/services/conversation/conversation-service.d.ts.map +1 -1
  637. package/dist/services/conversation/conversation-service.js +133 -16
  638. package/dist/services/conversation/conversation-service.js.map +1 -1
  639. package/dist/services/conversation/conversation-state-projector.d.ts +3 -3
  640. package/dist/services/conversation/conversation-state-projector.d.ts.map +1 -1
  641. package/dist/services/conversation/conversation-state-projector.js +18 -0
  642. package/dist/services/conversation/conversation-state-projector.js.map +1 -1
  643. package/dist/services/conversation/conversation-store.d.ts +69 -12
  644. package/dist/services/conversation/conversation-store.d.ts.map +1 -1
  645. package/dist/services/conversation/conversation-store.js +216 -119
  646. package/dist/services/conversation/conversation-store.js.map +1 -1
  647. package/dist/services/conversation/conversation-turn-items.d.ts +8 -2
  648. package/dist/services/conversation/conversation-turn-items.d.ts.map +1 -1
  649. package/dist/services/conversation/conversation-turn-items.js +96 -275
  650. package/dist/services/conversation/conversation-turn-items.js.map +1 -1
  651. package/dist/services/conversation/journal-to-ledger.d.ts.map +1 -1
  652. package/dist/services/conversation/journal-to-ledger.js +4 -24
  653. package/dist/services/conversation/journal-to-ledger.js.map +1 -1
  654. package/dist/services/conversation/run-item-normalizer.d.ts +5 -0
  655. package/dist/services/conversation/run-item-normalizer.d.ts.map +1 -0
  656. package/dist/services/conversation/run-item-normalizer.js +245 -0
  657. package/dist/services/conversation/run-item-normalizer.js.map +1 -0
  658. package/dist/services/conversation/user-turn-item.d.ts +14 -0
  659. package/dist/services/conversation/user-turn-item.d.ts.map +1 -0
  660. package/dist/services/conversation/user-turn-item.js +27 -0
  661. package/dist/services/conversation/user-turn-item.js.map +1 -0
  662. package/dist/services/conversation-agent-client.d.ts +77 -6
  663. package/dist/services/conversation-agent-client.d.ts.map +1 -1
  664. package/dist/services/cost/model-cost.d.ts +147 -0
  665. package/dist/services/cost/model-cost.d.ts.map +1 -0
  666. package/dist/services/cost/model-cost.js +217 -0
  667. package/dist/services/cost/model-cost.js.map +1 -0
  668. package/dist/services/cost/pricing-overlay.d.ts +26 -0
  669. package/dist/services/cost/pricing-overlay.d.ts.map +1 -0
  670. package/dist/services/cost/pricing-overlay.js +39 -0
  671. package/dist/services/cost/pricing-overlay.js.map +1 -0
  672. package/dist/services/cost/pricing.d.ts +13 -0
  673. package/dist/services/cost/pricing.d.ts.map +1 -0
  674. package/dist/services/cost/pricing.js +76 -0
  675. package/dist/services/cost/pricing.js.map +1 -0
  676. package/dist/services/handoff/handoff-flow-reducer.d.ts +27 -0
  677. package/dist/services/handoff/handoff-flow-reducer.d.ts.map +1 -0
  678. package/dist/services/handoff/handoff-flow-reducer.js +26 -0
  679. package/dist/services/handoff/handoff-flow-reducer.js.map +1 -0
  680. package/dist/services/handoff/handoff-session.d.ts +35 -0
  681. package/dist/services/handoff/handoff-session.d.ts.map +1 -0
  682. package/dist/services/handoff/handoff-session.js +136 -0
  683. package/dist/services/handoff/handoff-session.js.map +1 -0
  684. package/dist/services/hooks/hook-contracts.d.ts +124 -0
  685. package/dist/services/hooks/hook-contracts.d.ts.map +1 -0
  686. package/dist/services/hooks/hook-contracts.js +92 -0
  687. package/dist/services/hooks/hook-contracts.js.map +1 -0
  688. package/dist/services/hooks/hook-discovery.d.ts +45 -0
  689. package/dist/services/hooks/hook-discovery.d.ts.map +1 -0
  690. package/dist/services/hooks/hook-discovery.js +255 -0
  691. package/dist/services/hooks/hook-discovery.js.map +1 -0
  692. package/dist/services/hooks/hook-editor-shim.d.ts +6 -0
  693. package/dist/services/hooks/hook-editor-shim.d.ts.map +1 -0
  694. package/dist/services/hooks/hook-editor-shim.js +190 -0
  695. package/dist/services/hooks/hook-editor-shim.js.map +1 -0
  696. package/dist/services/hooks/hook-event-factory.d.ts +19 -0
  697. package/dist/services/hooks/hook-event-factory.d.ts.map +1 -0
  698. package/dist/services/hooks/hook-event-factory.js +45 -0
  699. package/dist/services/hooks/hook-event-factory.js.map +1 -0
  700. package/dist/services/hooks/hook-module-loader.d.ts +38 -0
  701. package/dist/services/hooks/hook-module-loader.d.ts.map +1 -0
  702. package/dist/services/hooks/hook-module-loader.js +69 -0
  703. package/dist/services/hooks/hook-module-loader.js.map +1 -0
  704. package/dist/services/hooks/hook-registry.d.ts +47 -0
  705. package/dist/services/hooks/hook-registry.d.ts.map +1 -0
  706. package/dist/services/hooks/hook-registry.js +185 -0
  707. package/dist/services/hooks/hook-registry.js.map +1 -0
  708. package/dist/services/hooks/hook-service.d.ts +44 -0
  709. package/dist/services/hooks/hook-service.d.ts.map +1 -0
  710. package/dist/services/hooks/hook-service.js +138 -0
  711. package/dist/services/hooks/hook-service.js.map +1 -0
  712. package/dist/services/hooks/hook-tool-lifecycle.d.ts +6 -0
  713. package/dist/services/hooks/hook-tool-lifecycle.d.ts.map +1 -0
  714. package/dist/services/hooks/hook-tool-lifecycle.js +33 -0
  715. package/dist/services/hooks/hook-tool-lifecycle.js.map +1 -0
  716. package/dist/services/hooks/index.d.ts +2 -0
  717. package/dist/services/hooks/index.d.ts.map +1 -0
  718. package/dist/services/hooks/index.js +2 -0
  719. package/dist/services/hooks/index.js.map +1 -0
  720. package/dist/services/input-surge-guard.d.ts.map +1 -1
  721. package/dist/services/input-surge-guard.js +13 -34
  722. package/dist/services/input-surge-guard.js.map +1 -1
  723. package/dist/services/logging/assistant-turn-journal.d.ts +1 -1
  724. package/dist/services/logging/assistant-turn-journal.d.ts.map +1 -1
  725. package/dist/services/logging/assistant-turn-journal.js +21 -36
  726. package/dist/services/logging/assistant-turn-journal.js.map +1 -1
  727. package/dist/services/logging/conversation-log-events.d.ts +70 -7
  728. package/dist/services/logging/conversation-log-events.d.ts.map +1 -1
  729. package/dist/services/logging/conversation-log-events.js +9 -0
  730. package/dist/services/logging/conversation-log-events.js.map +1 -1
  731. package/dist/services/logging/conversation-log-writer.d.ts +10 -4
  732. package/dist/services/logging/conversation-log-writer.d.ts.map +1 -1
  733. package/dist/services/logging/conversation-log-writer.js +184 -57
  734. package/dist/services/logging/conversation-log-writer.js.map +1 -1
  735. package/dist/services/logging/conversation-logger.d.ts.map +1 -1
  736. package/dist/services/logging/conversation-logger.js +34 -1
  737. package/dist/services/logging/conversation-logger.js.map +1 -1
  738. package/dist/services/logging/logging-service.d.ts.map +1 -1
  739. package/dist/services/logging/logging-service.js +6 -2
  740. package/dist/services/logging/logging-service.js.map +1 -1
  741. package/dist/services/logging/provider-traffic.d.ts +2 -1
  742. package/dist/services/logging/provider-traffic.d.ts.map +1 -1
  743. package/dist/services/logging/provider-traffic.js +81 -5
  744. package/dist/services/logging/provider-traffic.js.map +1 -1
  745. package/dist/services/memory/memory-capabilities.d.ts.map +1 -1
  746. package/dist/services/memory/memory-capabilities.js +13 -8
  747. package/dist/services/memory/memory-capabilities.js.map +1 -1
  748. package/dist/services/model-service.d.ts +3 -0
  749. package/dist/services/model-service.d.ts.map +1 -1
  750. package/dist/services/model-service.js +3 -1
  751. package/dist/services/model-service.js.map +1 -1
  752. package/dist/services/models/model-catalog-session.d.ts +24 -0
  753. package/dist/services/models/model-catalog-session.d.ts.map +1 -0
  754. package/dist/services/models/model-catalog-session.js +70 -0
  755. package/dist/services/models/model-catalog-session.js.map +1 -0
  756. package/dist/services/openai-candidate-observer.d.ts +18 -0
  757. package/dist/services/openai-candidate-observer.d.ts.map +1 -0
  758. package/dist/services/openai-candidate-observer.js +56 -0
  759. package/dist/services/openai-candidate-observer.js.map +1 -0
  760. package/dist/services/openai-root-checkpoint-lifecycle-observer.d.ts +20 -0
  761. package/dist/services/openai-root-checkpoint-lifecycle-observer.d.ts.map +1 -0
  762. package/dist/services/openai-root-checkpoint-lifecycle-observer.js +21 -0
  763. package/dist/services/openai-root-checkpoint-lifecycle-observer.js.map +1 -0
  764. package/dist/services/openai-root-provider-identity.d.ts +11 -0
  765. package/dist/services/openai-root-provider-identity.d.ts.map +1 -0
  766. package/dist/services/openai-root-provider-identity.js +16 -0
  767. package/dist/services/openai-root-provider-identity.js.map +1 -0
  768. package/dist/services/openai-root-selector-parity-observer.d.ts +53 -0
  769. package/dist/services/openai-root-selector-parity-observer.d.ts.map +1 -0
  770. package/dist/services/openai-root-selector-parity-observer.js +62 -0
  771. package/dist/services/openai-root-selector-parity-observer.js.map +1 -0
  772. package/dist/services/plan-mode-interceptor.js +2 -2
  773. package/dist/services/plan-mode-interceptor.js.map +1 -1
  774. package/dist/services/provider-continuity.d.ts +79 -0
  775. package/dist/services/provider-continuity.d.ts.map +1 -1
  776. package/dist/services/provider-continuity.js +170 -0
  777. package/dist/services/provider-continuity.js.map +1 -1
  778. package/dist/services/providers/provider-management-session.d.ts +12 -0
  779. package/dist/services/providers/provider-management-session.d.ts.map +1 -0
  780. package/dist/services/providers/provider-management-session.js +21 -0
  781. package/dist/services/providers/provider-management-session.js.map +1 -0
  782. package/dist/services/queue/queue-controller.d.ts +10 -14
  783. package/dist/services/queue/queue-controller.d.ts.map +1 -1
  784. package/dist/services/queue/queue-controller.js +77 -59
  785. package/dist/services/queue/queue-controller.js.map +1 -1
  786. package/dist/services/retry/conversation-retry-policy.js +3 -3
  787. package/dist/services/retry/conversation-retry-policy.js.map +1 -1
  788. package/dist/services/retry/recovery-executor.d.ts.map +1 -1
  789. package/dist/services/retry/recovery-executor.js +7 -8
  790. package/dist/services/retry/recovery-executor.js.map +1 -1
  791. package/dist/services/retry/recovery-policy.d.ts.map +1 -1
  792. package/dist/services/retry/recovery-policy.js +4 -1
  793. package/dist/services/retry/recovery-policy.js.map +1 -1
  794. package/dist/services/retry/retry-classifier.d.ts.map +1 -1
  795. package/dist/services/retry/retry-classifier.js +6 -3
  796. package/dist/services/retry/retry-classifier.js.map +1 -1
  797. package/dist/services/retry/retry-contracts.d.ts +3 -5
  798. package/dist/services/retry/retry-contracts.d.ts.map +1 -1
  799. package/dist/services/retry/retry-error-classification.d.ts +1 -0
  800. package/dist/services/retry/retry-error-classification.d.ts.map +1 -1
  801. package/dist/services/retry/retry-error-classification.js +28 -0
  802. package/dist/services/retry/retry-error-classification.js.map +1 -1
  803. package/dist/services/retry/retry-event-presenter.d.ts.map +1 -1
  804. package/dist/services/retry/retry-event-presenter.js +4 -1
  805. package/dist/services/retry/retry-event-presenter.js.map +1 -1
  806. package/dist/services/retry/upstream-retry-policy.js +3 -3
  807. package/dist/services/rtk-service.d.ts.map +1 -1
  808. package/dist/services/rtk-service.js +3 -15
  809. package/dist/services/rtk-service.js.map +1 -1
  810. package/dist/services/runtime-setting-router.d.ts +19 -0
  811. package/dist/services/runtime-setting-router.d.ts.map +1 -1
  812. package/dist/services/runtime-setting-router.js +33 -0
  813. package/dist/services/runtime-setting-router.js.map +1 -1
  814. package/dist/services/service-interfaces.d.ts +19 -2
  815. package/dist/services/service-interfaces.d.ts.map +1 -1
  816. package/dist/services/session/background-task-control.d.ts +123 -0
  817. package/dist/services/session/background-task-control.d.ts.map +1 -0
  818. package/dist/services/session/background-task-control.js +183 -0
  819. package/dist/services/session/background-task-control.js.map +1 -0
  820. package/dist/services/session/continuation-call-id-resolver.d.ts +16 -9
  821. package/dist/services/session/continuation-call-id-resolver.d.ts.map +1 -1
  822. package/dist/services/session/continuation-call-id-resolver.js +34 -48
  823. package/dist/services/session/continuation-call-id-resolver.js.map +1 -1
  824. package/dist/services/session/continuation-plan-applier.d.ts.map +1 -1
  825. package/dist/services/session/continuation-plan-applier.js +1 -3
  826. package/dist/services/session/continuation-plan-applier.js.map +1 -1
  827. package/dist/services/session/continuation-recovery-handler.d.ts.map +1 -1
  828. package/dist/services/session/continuation-recovery-handler.js +0 -2
  829. package/dist/services/session/continuation-recovery-handler.js.map +1 -1
  830. package/dist/services/session/continuation-state.d.ts +9 -5
  831. package/dist/services/session/continuation-state.d.ts.map +1 -1
  832. package/dist/services/session/continuation-state.js +1 -1
  833. package/dist/services/session/continuation-state.js.map +1 -1
  834. package/dist/services/session/live-run.d.ts +29 -0
  835. package/dist/services/session/live-run.d.ts.map +1 -0
  836. package/dist/services/session/live-run.js +111 -0
  837. package/dist/services/session/live-run.js.map +1 -0
  838. package/dist/services/session/nested-tool-compatibility-state.d.ts +20 -0
  839. package/dist/services/session/nested-tool-compatibility-state.d.ts.map +1 -0
  840. package/dist/services/session/nested-tool-compatibility-state.js +29 -0
  841. package/dist/services/session/nested-tool-compatibility-state.js.map +1 -0
  842. package/dist/services/session/pending-interaction-state.d.ts +60 -0
  843. package/dist/services/session/pending-interaction-state.d.ts.map +1 -0
  844. package/dist/services/session/pending-interaction-state.js +132 -0
  845. package/dist/services/session/pending-interaction-state.js.map +1 -0
  846. package/dist/services/session/post-execute-pause-capability.d.ts +17 -0
  847. package/dist/services/session/post-execute-pause-capability.d.ts.map +1 -0
  848. package/dist/services/session/post-execute-pause-capability.js +27 -0
  849. package/dist/services/session/post-execute-pause-capability.js.map +1 -0
  850. package/dist/services/session/post-execute-pause-policy.d.ts +20 -0
  851. package/dist/services/session/post-execute-pause-policy.d.ts.map +1 -0
  852. package/dist/services/session/post-execute-pause-policy.js +34 -0
  853. package/dist/services/session/post-execute-pause-policy.js.map +1 -0
  854. package/dist/services/session/post-execute-pending-registry.d.ts +63 -0
  855. package/dist/services/session/post-execute-pending-registry.d.ts.map +1 -0
  856. package/dist/services/session/post-execute-pending-registry.js +123 -0
  857. package/dist/services/session/post-execute-pending-registry.js.map +1 -0
  858. package/dist/services/session/session-access-state.d.ts +24 -0
  859. package/dist/services/session/session-access-state.d.ts.map +1 -0
  860. package/dist/services/session/session-access-state.js +91 -0
  861. package/dist/services/session/session-access-state.js.map +1 -0
  862. package/dist/services/session/session-client-factory.d.ts +61 -0
  863. package/dist/services/session/session-client-factory.d.ts.map +1 -0
  864. package/dist/services/session/session-client-factory.js +103 -0
  865. package/dist/services/session/session-client-factory.js.map +1 -0
  866. package/dist/services/session/session-composition.d.ts +58 -0
  867. package/dist/services/session/session-composition.d.ts.map +1 -1
  868. package/dist/services/session/session-composition.js +178 -13
  869. package/dist/services/session/session-composition.js.map +1 -1
  870. package/dist/services/session/session-input-planner.d.ts +6 -2
  871. package/dist/services/session/session-input-planner.d.ts.map +1 -1
  872. package/dist/services/session/session-input-planner.js +4 -0
  873. package/dist/services/session/session-input-planner.js.map +1 -1
  874. package/dist/services/session/session-lifecycle.d.ts +5 -0
  875. package/dist/services/session/session-lifecycle.d.ts.map +1 -1
  876. package/dist/services/session/session-lifecycle.js +16 -6
  877. package/dist/services/session/session-lifecycle.js.map +1 -1
  878. package/dist/services/session/session-manager.d.ts +11 -1
  879. package/dist/services/session/session-manager.d.ts.map +1 -1
  880. package/dist/services/session/session-manager.js +16 -3
  881. package/dist/services/session/session-manager.js.map +1 -1
  882. package/dist/services/session/session-stream-processor.d.ts +5 -0
  883. package/dist/services/session/session-stream-processor.d.ts.map +1 -1
  884. package/dist/services/session/session-stream-processor.js +164 -35
  885. package/dist/services/session/session-stream-processor.js.map +1 -1
  886. package/dist/services/session/session-tool-tracker.d.ts +10 -21
  887. package/dist/services/session/session-tool-tracker.d.ts.map +1 -1
  888. package/dist/services/session/session-tool-tracker.js +12 -52
  889. package/dist/services/session/session-tool-tracker.js.map +1 -1
  890. package/dist/services/session/terminal-result-collector.d.ts +8 -0
  891. package/dist/services/session/terminal-result-collector.d.ts.map +1 -1
  892. package/dist/services/session/terminal-result-collector.js +18 -4
  893. package/dist/services/session/terminal-result-collector.js.map +1 -1
  894. package/dist/services/session/test-helpers/conversation-session-fixtures.d.ts.map +1 -1
  895. package/dist/services/session/test-helpers/conversation-session-fixtures.js +8 -1
  896. package/dist/services/session/test-helpers/conversation-session-fixtures.js.map +1 -1
  897. package/dist/services/session/turn-attempt-factory.d.ts +2 -2
  898. package/dist/services/session/turn-attempt-factory.d.ts.map +1 -1
  899. package/dist/services/session/turn-attempt.d.ts +4 -2
  900. package/dist/services/session/turn-attempt.d.ts.map +1 -1
  901. package/dist/services/session/turn-attempt.js +5 -0
  902. package/dist/services/session/turn-attempt.js.map +1 -1
  903. package/dist/services/session/turn-coordinator.d.ts +32 -2
  904. package/dist/services/session/turn-coordinator.d.ts.map +1 -1
  905. package/dist/services/session/turn-coordinator.js +180 -9
  906. package/dist/services/session/turn-coordinator.js.map +1 -1
  907. package/dist/services/session/turn-status-machine.d.ts +21 -6
  908. package/dist/services/session/turn-status-machine.d.ts.map +1 -1
  909. package/dist/services/session/turn-status-machine.js +50 -13
  910. package/dist/services/session/turn-status-machine.js.map +1 -1
  911. package/dist/services/session/turn-workflow.d.ts +35 -0
  912. package/dist/services/session/turn-workflow.d.ts.map +1 -1
  913. package/dist/services/session/turn-workflow.js +373 -27
  914. package/dist/services/session/turn-workflow.js.map +1 -1
  915. package/dist/services/settings/ancillary-settings-migration.js +3 -3
  916. package/dist/services/settings/ancillary-settings-migration.js.map +1 -1
  917. package/dist/services/settings/custom-provider-normalization.d.ts +10 -0
  918. package/dist/services/settings/custom-provider-normalization.d.ts.map +1 -1
  919. package/dist/services/settings/custom-provider-normalization.js +35 -2
  920. package/dist/services/settings/custom-provider-normalization.js.map +1 -1
  921. package/dist/services/settings/settings-env.d.ts +3 -0
  922. package/dist/services/settings/settings-env.d.ts.map +1 -1
  923. package/dist/services/settings/settings-env.js +3 -3
  924. package/dist/services/settings/settings-env.js.map +1 -1
  925. package/dist/services/settings/settings-merger.d.ts +6 -5
  926. package/dist/services/settings/settings-merger.d.ts.map +1 -1
  927. package/dist/services/settings/settings-merger.js +9 -4
  928. package/dist/services/settings/settings-merger.js.map +1 -1
  929. package/dist/services/settings/settings-persistence.d.ts +17 -6
  930. package/dist/services/settings/settings-persistence.d.ts.map +1 -1
  931. package/dist/services/settings/settings-persistence.js +155 -28
  932. package/dist/services/settings/settings-persistence.js.map +1 -1
  933. package/dist/services/settings/settings-schema.d.ts +100 -4
  934. package/dist/services/settings/settings-schema.d.ts.map +1 -1
  935. package/dist/services/settings/settings-schema.js +78 -8
  936. package/dist/services/settings/settings-schema.js.map +1 -1
  937. package/dist/services/settings/settings-service.d.ts +34 -5
  938. package/dist/services/settings/settings-service.d.ts.map +1 -1
  939. package/dist/services/settings/settings-service.js +200 -8
  940. package/dist/services/settings/settings-service.js.map +1 -1
  941. package/dist/services/settings/settings-sources.d.ts.map +1 -1
  942. package/dist/services/settings/settings-sources.js +6 -0
  943. package/dist/services/settings/settings-sources.js.map +1 -1
  944. package/dist/services/shell/background-shell-registry.d.ts +110 -0
  945. package/dist/services/shell/background-shell-registry.d.ts.map +1 -0
  946. package/dist/services/shell/background-shell-registry.js +326 -0
  947. package/dist/services/shell/background-shell-registry.js.map +1 -0
  948. package/dist/services/shell/shell-interaction-session.d.ts +43 -0
  949. package/dist/services/shell/shell-interaction-session.d.ts.map +1 -0
  950. package/dist/services/shell/shell-interaction-session.js +113 -0
  951. package/dist/services/shell/shell-interaction-session.js.map +1 -0
  952. package/dist/services/stream-event-processor.d.ts +11 -12
  953. package/dist/services/stream-event-processor.d.ts.map +1 -1
  954. package/dist/services/stream-event-processor.js +115 -352
  955. package/dist/services/stream-event-processor.js.map +1 -1
  956. package/dist/services/stream-snapshot.d.ts +0 -1
  957. package/dist/services/stream-snapshot.d.ts.map +1 -1
  958. package/dist/services/stream-snapshot.js +0 -1
  959. package/dist/services/stream-snapshot.js.map +1 -1
  960. package/dist/services/subagents/codename-run-id.d.ts +43 -0
  961. package/dist/services/subagents/codename-run-id.d.ts.map +1 -0
  962. package/dist/services/subagents/codename-run-id.js +683 -0
  963. package/dist/services/subagents/codename-run-id.js.map +1 -0
  964. package/dist/services/subagents/execution-runner.d.ts +5 -3
  965. package/dist/services/subagents/execution-runner.d.ts.map +1 -1
  966. package/dist/services/subagents/execution-runner.js +109 -10
  967. package/dist/services/subagents/execution-runner.js.map +1 -1
  968. package/dist/services/subagents/foreground-subagent-lease.d.ts +77 -0
  969. package/dist/services/subagents/foreground-subagent-lease.d.ts.map +1 -0
  970. package/dist/services/subagents/foreground-subagent-lease.js +156 -0
  971. package/dist/services/subagents/foreground-subagent-lease.js.map +1 -0
  972. package/dist/services/subagents/mentor-runner.d.ts.map +1 -1
  973. package/dist/services/subagents/mentor-runner.js +65 -34
  974. package/dist/services/subagents/mentor-runner.js.map +1 -1
  975. package/dist/services/subagents/nested-runner.d.ts +47 -23
  976. package/dist/services/subagents/nested-runner.d.ts.map +1 -1
  977. package/dist/services/subagents/nested-runner.js +263 -64
  978. package/dist/services/subagents/nested-runner.js.map +1 -1
  979. package/dist/services/subagents/role-loader.d.ts +3 -3
  980. package/dist/services/subagents/role-loader.d.ts.map +1 -1
  981. package/dist/services/subagents/role-loader.js +6 -7
  982. package/dist/services/subagents/role-loader.js.map +1 -1
  983. package/dist/services/subagents/runtime.d.ts +10 -0
  984. package/dist/services/subagents/runtime.d.ts.map +1 -1
  985. package/dist/services/subagents/runtime.js +31 -7
  986. package/dist/services/subagents/runtime.js.map +1 -1
  987. package/dist/services/subagents/subagent-async-registry.d.ts +50 -3
  988. package/dist/services/subagents/subagent-async-registry.d.ts.map +1 -1
  989. package/dist/services/subagents/subagent-async-registry.js +463 -44
  990. package/dist/services/subagents/subagent-async-registry.js.map +1 -1
  991. package/dist/services/subagents/subagent-client-types.d.ts +2 -0
  992. package/dist/services/subagents/subagent-client-types.d.ts.map +1 -1
  993. package/dist/services/subagents/subagent-manager.d.ts +40 -7
  994. package/dist/services/subagents/subagent-manager.d.ts.map +1 -1
  995. package/dist/services/subagents/subagent-manager.js +47 -1
  996. package/dist/services/subagents/subagent-manager.js.map +1 -1
  997. package/dist/services/subagents/subagent-notification-store.d.ts +112 -28
  998. package/dist/services/subagents/subagent-notification-store.d.ts.map +1 -1
  999. package/dist/services/subagents/subagent-notification-store.js +197 -47
  1000. package/dist/services/subagents/subagent-notification-store.js.map +1 -1
  1001. package/dist/services/subagents/subagent-run-control.d.ts +41 -0
  1002. package/dist/services/subagents/subagent-run-control.d.ts.map +1 -0
  1003. package/dist/services/subagents/subagent-run-control.js +166 -0
  1004. package/dist/services/subagents/subagent-run-control.js.map +1 -0
  1005. package/dist/services/subagents/subagent-session.d.ts +12 -7
  1006. package/dist/services/subagents/subagent-session.d.ts.map +1 -1
  1007. package/dist/services/subagents/subagent-session.js +13 -14
  1008. package/dist/services/subagents/subagent-session.js.map +1 -1
  1009. package/dist/services/subagents/test-helpers/subagent-manager-fixtures.d.ts +4 -5
  1010. package/dist/services/subagents/test-helpers/subagent-manager-fixtures.d.ts.map +1 -1
  1011. package/dist/services/subagents/test-helpers/subagent-manager-fixtures.js +66 -65
  1012. package/dist/services/subagents/test-helpers/subagent-manager-fixtures.js.map +1 -1
  1013. package/dist/services/subagents/tool-policy.d.ts +39 -17
  1014. package/dist/services/subagents/tool-policy.d.ts.map +1 -1
  1015. package/dist/services/subagents/tool-policy.js +209 -53
  1016. package/dist/services/subagents/tool-policy.js.map +1 -1
  1017. package/dist/services/subagents/types.d.ts +114 -2
  1018. package/dist/services/subagents/types.d.ts.map +1 -1
  1019. package/dist/services/subagents/types.js +2 -2
  1020. package/dist/services/subagents/types.js.map +1 -1
  1021. package/dist/services/subagents/utils.d.ts +8 -1
  1022. package/dist/services/subagents/utils.d.ts.map +1 -1
  1023. package/dist/services/subagents/utils.js +43 -16
  1024. package/dist/services/subagents/utils.js.map +1 -1
  1025. package/dist/services/test-helpers/mock-stream.d.ts +3 -0
  1026. package/dist/services/test-helpers/mock-stream.d.ts.map +1 -1
  1027. package/dist/services/test-helpers/mock-stream.js +8 -0
  1028. package/dist/services/test-helpers/mock-stream.js.map +1 -1
  1029. package/dist/services/tool-execution-ledger.d.ts +2 -0
  1030. package/dist/services/tool-execution-ledger.d.ts.map +1 -1
  1031. package/dist/services/tool-execution-ledger.js +59 -81
  1032. package/dist/services/tool-execution-ledger.js.map +1 -1
  1033. package/dist/test-helpers/conversation-session-with-adapter.d.ts +1 -1
  1034. package/dist/test-helpers/conversation-session-with-adapter.d.ts.map +1 -1
  1035. package/dist/test-helpers/conversation-session-with-adapter.js +5 -1
  1036. package/dist/test-helpers/conversation-session-with-adapter.js.map +1 -1
  1037. package/dist/test-helpers/ink-testing.d.ts.map +1 -1
  1038. package/dist/test-helpers/ink-testing.js +2 -1
  1039. package/dist/test-helpers/ink-testing.js.map +1 -1
  1040. package/dist/tools/agent/activate-skill.d.ts +6 -1
  1041. package/dist/tools/agent/activate-skill.d.ts.map +1 -1
  1042. package/dist/tools/agent/activate-skill.js.map +1 -1
  1043. package/dist/tools/agent/ask-mentor.d.ts +1 -1
  1044. package/dist/tools/agent/ask-mentor.d.ts.map +1 -1
  1045. package/dist/tools/agent/ask-mentor.js.map +1 -1
  1046. package/dist/tools/agent/ask-orchestrator.d.ts +11 -0
  1047. package/dist/tools/agent/ask-orchestrator.d.ts.map +1 -0
  1048. package/dist/tools/agent/ask-orchestrator.js +39 -0
  1049. package/dist/tools/agent/ask-orchestrator.js.map +1 -0
  1050. package/dist/tools/agent/ask-user-constants.d.ts +6 -0
  1051. package/dist/tools/agent/ask-user-constants.d.ts.map +1 -1
  1052. package/dist/tools/agent/ask-user-constants.js +6 -0
  1053. package/dist/tools/agent/ask-user-constants.js.map +1 -1
  1054. package/dist/tools/agent/run-subagent-async.d.ts +46 -4
  1055. package/dist/tools/agent/run-subagent-async.d.ts.map +1 -1
  1056. package/dist/tools/agent/run-subagent-async.js +220 -33
  1057. package/dist/tools/agent/run-subagent-async.js.map +1 -1
  1058. package/dist/tools/agent/run-subagent.d.ts +28 -14
  1059. package/dist/tools/agent/run-subagent.d.ts.map +1 -1
  1060. package/dist/tools/agent/run-subagent.js +173 -68
  1061. package/dist/tools/agent/run-subagent.js.map +1 -1
  1062. package/dist/tools/file/apply-patch.d.ts +3 -1
  1063. package/dist/tools/file/apply-patch.d.ts.map +1 -1
  1064. package/dist/tools/file/apply-patch.js +34 -10
  1065. package/dist/tools/file/apply-patch.js.map +1 -1
  1066. package/dist/tools/file/code-context.d.ts +3 -2
  1067. package/dist/tools/file/code-context.d.ts.map +1 -1
  1068. package/dist/tools/file/code-context.js +5 -5
  1069. package/dist/tools/file/code-context.js.map +1 -1
  1070. package/dist/tools/file/create-file.d.ts +4 -2
  1071. package/dist/tools/file/create-file.d.ts.map +1 -1
  1072. package/dist/tools/file/create-file.js +10 -7
  1073. package/dist/tools/file/create-file.js.map +1 -1
  1074. package/dist/tools/file/edit-healing.d.ts.map +1 -1
  1075. package/dist/tools/file/edit-healing.js +54 -35
  1076. package/dist/tools/file/edit-healing.js.map +1 -1
  1077. package/dist/tools/file/glob-target.d.ts +12 -0
  1078. package/dist/tools/file/glob-target.d.ts.map +1 -0
  1079. package/dist/tools/file/glob-target.js +22 -0
  1080. package/dist/tools/file/glob-target.js.map +1 -0
  1081. package/dist/tools/file/glob.d.ts +9 -2
  1082. package/dist/tools/file/glob.d.ts.map +1 -1
  1083. package/dist/tools/file/glob.js +12 -16
  1084. package/dist/tools/file/glob.js.map +1 -1
  1085. package/dist/tools/file/grep.d.ts +9 -1
  1086. package/dist/tools/file/grep.d.ts.map +1 -1
  1087. package/dist/tools/file/grep.js +75 -13
  1088. package/dist/tools/file/grep.js.map +1 -1
  1089. package/dist/tools/file/read-file.d.ts +7 -1
  1090. package/dist/tools/file/read-file.d.ts.map +1 -1
  1091. package/dist/tools/file/read-file.js +3 -4
  1092. package/dist/tools/file/read-file.js.map +1 -1
  1093. package/dist/tools/file/search-replace.d.ts +5 -3
  1094. package/dist/tools/file/search-replace.d.ts.map +1 -1
  1095. package/dist/tools/file/search-replace.js +29 -19
  1096. package/dist/tools/file/search-replace.js.map +1 -1
  1097. package/dist/tools/format-helpers.d.ts +4 -3
  1098. package/dist/tools/format-helpers.d.ts.map +1 -1
  1099. package/dist/tools/format-helpers.js +16 -17
  1100. package/dist/tools/format-helpers.js.map +1 -1
  1101. package/dist/tools/memory/memory-tools.d.ts.map +1 -1
  1102. package/dist/tools/memory/memory-tools.js +61 -49
  1103. package/dist/tools/memory/memory-tools.js.map +1 -1
  1104. package/dist/tools/run-agent-workflow.d.ts +1 -1
  1105. package/dist/tools/run-agent-workflow.d.ts.map +1 -1
  1106. package/dist/tools/system/shell.d.ts +39 -3
  1107. package/dist/tools/system/shell.d.ts.map +1 -1
  1108. package/dist/tools/system/shell.js +380 -149
  1109. package/dist/tools/system/shell.js.map +1 -1
  1110. package/dist/tools/types.d.ts +102 -5
  1111. package/dist/tools/types.d.ts.map +1 -1
  1112. package/dist/tools/types.js +4 -1
  1113. package/dist/tools/types.js.map +1 -1
  1114. package/dist/tools/utils.d.ts +18 -0
  1115. package/dist/tools/utils.d.ts.map +1 -1
  1116. package/dist/tools/utils.js +78 -0
  1117. package/dist/tools/utils.js.map +1 -1
  1118. package/dist/tools/web/web-fetch.d.ts +1 -1
  1119. package/dist/tools/web/web-fetch.d.ts.map +1 -1
  1120. package/dist/tools/web/web-fetch.js.map +1 -1
  1121. package/dist/tools/web/web-search.d.ts +1 -1
  1122. package/dist/tools/web/web-search.d.ts.map +1 -1
  1123. package/dist/tools/web/web-search.js.map +1 -1
  1124. package/dist/types/message.d.ts +2 -0
  1125. package/dist/types/message.d.ts.map +1 -1
  1126. package/dist/types/message.js.map +1 -1
  1127. package/dist/utils/ai/model-settings.d.ts.map +1 -1
  1128. package/dist/utils/ai/model-settings.js +0 -6
  1129. package/dist/utils/ai/model-settings.js.map +1 -1
  1130. package/dist/utils/ai/token-usage.d.ts +10 -5
  1131. package/dist/utils/ai/token-usage.d.ts.map +1 -1
  1132. package/dist/utils/ai/token-usage.js +48 -35
  1133. package/dist/utils/ai/token-usage.js.map +1 -1
  1134. package/dist/utils/apply-diff.d.ts +3 -0
  1135. package/dist/utils/apply-diff.d.ts.map +1 -0
  1136. package/dist/utils/apply-diff.js +192 -0
  1137. package/dist/utils/apply-diff.js.map +1 -0
  1138. package/dist/utils/conversation/conversation-event-handler.d.ts.map +1 -1
  1139. package/dist/utils/conversation/conversation-event-handler.js +72 -13
  1140. package/dist/utils/conversation/conversation-event-handler.js.map +1 -1
  1141. package/dist/utils/conversation/conversation-utils.d.ts +5 -0
  1142. package/dist/utils/conversation/conversation-utils.d.ts.map +1 -1
  1143. package/dist/utils/conversation/conversation-utils.js +1 -0
  1144. package/dist/utils/conversation/conversation-utils.js.map +1 -1
  1145. package/dist/utils/conversation/message-utils.d.ts +6 -0
  1146. package/dist/utils/conversation/message-utils.d.ts.map +1 -1
  1147. package/dist/utils/conversation/message-utils.js +17 -14
  1148. package/dist/utils/conversation/message-utils.js.map +1 -1
  1149. package/dist/utils/conversation/rewind-items.d.ts +32 -0
  1150. package/dist/utils/conversation/rewind-items.d.ts.map +1 -0
  1151. package/dist/utils/conversation/rewind-items.js +33 -0
  1152. package/dist/utils/conversation/rewind-items.js.map +1 -0
  1153. package/dist/utils/inject-warning-into-tool-output.d.ts +10 -0
  1154. package/dist/utils/inject-warning-into-tool-output.d.ts.map +1 -1
  1155. package/dist/utils/inject-warning-into-tool-output.js +17 -0
  1156. package/dist/utils/inject-warning-into-tool-output.js.map +1 -1
  1157. package/dist/utils/settings-command.d.ts.map +1 -1
  1158. package/dist/utils/settings-command.js +41 -4
  1159. package/dist/utils/settings-command.js.map +1 -1
  1160. package/dist/utils/shell/command-logger.js.map +1 -1
  1161. package/dist/utils/shell/command-safety/find-helpers.d.ts +3 -2
  1162. package/dist/utils/shell/command-safety/find-helpers.d.ts.map +1 -1
  1163. package/dist/utils/shell/command-safety/find-helpers.js +34 -17
  1164. package/dist/utils/shell/command-safety/find-helpers.js.map +1 -1
  1165. package/dist/utils/shell/command-safety/handlers/find-handler.d.ts.map +1 -1
  1166. package/dist/utils/shell/command-safety/handlers/find-handler.js +0 -2
  1167. package/dist/utils/shell/command-safety/handlers/find-handler.js.map +1 -1
  1168. package/dist/utils/shell/command-safety/handlers/git-handler.d.ts.map +1 -1
  1169. package/dist/utils/shell/command-safety/handlers/git-handler.js.map +1 -1
  1170. package/dist/utils/shell/command-safety/handlers/sed-handler.d.ts.map +1 -1
  1171. package/dist/utils/shell/command-safety/handlers/sed-handler.js +14 -9
  1172. package/dist/utils/shell/command-safety/handlers/sed-handler.js.map +1 -1
  1173. package/dist/utils/shell/command-safety/handlers/types.d.ts +5 -4
  1174. package/dist/utils/shell/command-safety/handlers/types.d.ts.map +1 -1
  1175. package/dist/utils/shell/command-safety/index.d.ts.map +1 -1
  1176. package/dist/utils/shell/command-safety/index.js +212 -88
  1177. package/dist/utils/shell/command-safety/index.js.map +1 -1
  1178. package/dist/utils/shell/command-safety/utils.d.ts +2 -1
  1179. package/dist/utils/shell/command-safety/utils.d.ts.map +1 -1
  1180. package/dist/utils/shell/command-safety/utils.js +5 -5
  1181. package/dist/utils/shell/command-safety/utils.js.map +1 -1
  1182. package/dist/utils/shell/execute-shell.d.ts +24 -3
  1183. package/dist/utils/shell/execute-shell.d.ts.map +1 -1
  1184. package/dist/utils/shell/execute-shell.js +228 -28
  1185. package/dist/utils/shell/execute-shell.js.map +1 -1
  1186. package/dist/utils/shell/sandbox/denied-read-stores.d.ts +1 -8
  1187. package/dist/utils/shell/sandbox/denied-read-stores.d.ts.map +1 -1
  1188. package/dist/utils/shell/sandbox/denied-read-stores.js +1 -8
  1189. package/dist/utils/shell/sandbox/denied-read-stores.js.map +1 -1
  1190. package/dist/utils/shell/sandbox/docker-host-control-grants.d.ts +36 -6
  1191. package/dist/utils/shell/sandbox/docker-host-control-grants.d.ts.map +1 -1
  1192. package/dist/utils/shell/sandbox/docker-host-control-grants.js +47 -17
  1193. package/dist/utils/shell/sandbox/docker-host-control-grants.js.map +1 -1
  1194. package/dist/utils/shell/sandbox/sandbox-network-approval-coordinator.d.ts +21 -0
  1195. package/dist/utils/shell/sandbox/sandbox-network-approval-coordinator.d.ts.map +1 -0
  1196. package/dist/utils/shell/sandbox/sandbox-network-approval-coordinator.js +66 -0
  1197. package/dist/utils/shell/sandbox/sandbox-network-approval-coordinator.js.map +1 -0
  1198. package/dist/utils/shell/shell-session.js.map +1 -1
  1199. package/dist/utils/slash-command-dispatch.d.ts +21 -0
  1200. package/dist/utils/slash-command-dispatch.d.ts.map +1 -0
  1201. package/dist/utils/slash-command-dispatch.js +34 -0
  1202. package/dist/utils/slash-command-dispatch.js.map +1 -0
  1203. package/dist/utils/streaming/extract-command-messages.d.ts.map +1 -1
  1204. package/dist/utils/streaming/extract-command-messages.js +29 -51
  1205. package/dist/utils/streaming/extract-command-messages.js.map +1 -1
  1206. package/dist/utils/value-suggestions.d.ts.map +1 -1
  1207. package/dist/utils/value-suggestions.js +0 -8
  1208. package/dist/utils/value-suggestions.js.map +1 -1
  1209. package/package.json +21 -19
  1210. package/dist/commands/retry-command.d.ts +0 -20
  1211. package/dist/commands/retry-command.d.ts.map +0 -1
  1212. package/dist/commands/retry-command.js +0 -39
  1213. package/dist/commands/retry-command.js.map +0 -1
  1214. package/dist/commands/undo-command.d.ts +0 -15
  1215. package/dist/commands/undo-command.d.ts.map +0 -1
  1216. package/dist/commands/undo-command.js +0 -28
  1217. package/dist/commands/undo-command.js.map +0 -1
  1218. package/dist/components/input/PopupManager.d.ts +0 -88
  1219. package/dist/components/input/PopupManager.d.ts.map +0 -1
  1220. package/dist/components/input/PopupManager.js +0 -21
  1221. package/dist/components/input/PopupManager.js.map +0 -1
  1222. package/dist/components/input/popup-key-navigation.d.ts +0 -18
  1223. package/dist/components/input/popup-key-navigation.d.ts.map +0 -1
  1224. package/dist/components/input/popup-key-navigation.js +0 -16
  1225. package/dist/components/input/popup-key-navigation.js.map +0 -1
  1226. package/dist/components/input/popup-props.d.ts +0 -24
  1227. package/dist/components/input/popup-props.d.ts.map +0 -1
  1228. package/dist/components/input/popup-props.js +0 -72
  1229. package/dist/components/input/popup-props.js.map +0 -1
  1230. package/dist/components/menu/UndoSelectionMenu.d.ts +0 -12
  1231. package/dist/components/menu/UndoSelectionMenu.d.ts.map +0 -1
  1232. package/dist/components/menu/UndoSelectionMenu.js +0 -19
  1233. package/dist/components/menu/UndoSelectionMenu.js.map +0 -1
  1234. package/dist/hooks/use-mode-handlers.d.ts +0 -79
  1235. package/dist/hooks/use-mode-handlers.d.ts.map +0 -1
  1236. package/dist/hooks/use-mode-handlers.js +0 -183
  1237. package/dist/hooks/use-mode-handlers.js.map +0 -1
  1238. package/dist/hooks/use-pending-turn-guards.d.ts +0 -43
  1239. package/dist/hooks/use-pending-turn-guards.d.ts.map +0 -1
  1240. package/dist/hooks/use-pending-turn-guards.js +0 -120
  1241. package/dist/hooks/use-pending-turn-guards.js.map +0 -1
  1242. package/dist/hooks/use-trigger-detection.d.ts +0 -49
  1243. package/dist/hooks/use-trigger-detection.d.ts.map +0 -1
  1244. package/dist/hooks/use-trigger-detection.js +0 -104
  1245. package/dist/hooks/use-trigger-detection.js.map +0 -1
  1246. package/dist/hooks/use-undo-selection.d.ts +0 -23
  1247. package/dist/hooks/use-undo-selection.d.ts.map +0 -1
  1248. package/dist/hooks/use-undo-selection.js.map +0 -1
  1249. package/dist/lib/agent-run-orchestrator.d.ts +0 -38
  1250. package/dist/lib/agent-run-orchestrator.d.ts.map +0 -1
  1251. package/dist/lib/agent-run-orchestrator.js +0 -266
  1252. package/dist/lib/agent-run-orchestrator.js.map +0 -1
  1253. package/dist/lib/retry-executor.d.ts +0 -16
  1254. package/dist/lib/retry-executor.d.ts.map +0 -1
  1255. package/dist/lib/retry-executor.js +0 -53
  1256. package/dist/lib/retry-executor.js.map +0 -1
  1257. package/dist/lib/runner-manager.d.ts +0 -22
  1258. package/dist/lib/runner-manager.d.ts.map +0 -1
  1259. package/dist/lib/runner-manager.js +0 -56
  1260. package/dist/lib/runner-manager.js.map +0 -1
  1261. package/dist/prompts/shell-sandbox.md +0 -18
  1262. package/dist/prompts/simple.md +0 -53
  1263. package/dist/prompts/simple_prev.md +0 -33
  1264. package/dist/prompts/simple_v2.md +0 -84
  1265. package/dist/prompts/simple_v3.md +0 -267
  1266. package/dist/prompts/subagents/researcher.md +0 -40
  1267. package/dist/providers/ai-sdk-agents-adapter.d.ts +0 -7
  1268. package/dist/providers/ai-sdk-agents-adapter.d.ts.map +0 -1
  1269. package/dist/providers/ai-sdk-agents-adapter.js +0 -80
  1270. package/dist/providers/ai-sdk-agents-adapter.js.map +0 -1
  1271. package/dist/providers/fallback-responses-model.d.ts +0 -46
  1272. package/dist/providers/fallback-responses-model.d.ts.map +0 -1
  1273. package/dist/providers/fallback-responses-model.js +0 -296
  1274. package/dist/providers/fallback-responses-model.js.map +0 -1
  1275. package/dist/services/stream-event-parsing.d.ts +0 -4
  1276. package/dist/services/stream-event-parsing.d.ts.map +0 -1
  1277. package/dist/services/stream-event-parsing.js +0 -79
  1278. package/dist/services/stream-event-parsing.js.map +0 -1
@@ -1,10 +1,9 @@
1
1
  import { createConversationRuntime } from './services/conversation/conversation-runtime-factory.js';
2
2
  import { SessionContextService } from './services/session/session-context-service.js';
3
+ import { createCallerOwnedSessionClientFactory, } from './services/session/session-client-factory.js';
3
4
  import { randomUUID } from 'node:crypto';
4
- import { classifyCommandDetailed } from './utils/shell/command-safety/index.js';
5
- import { SafetyStatus } from './utils/shell/command-safety/constants.js';
6
- import { evaluateShellAutoApprovalAdvisories } from './services/approval/shell-auto-approval-evaluator.js';
7
- export const NON_INTERACTIVE_REJECTION_REASON = 'Non-interactive mode: use --auto-approve to allow tool execution';
5
+ import { NonInteractiveApprovalPolicy } from './services/approval/non-interactive-approval-policy.js';
6
+ export { NON_INTERACTIVE_REJECTION_REASON } from './services/approval/non-interactive-approval-policy.js';
8
7
  export const createNonInteractiveSessionId = () => `non-interactive-${randomUUID()}`;
9
8
  const safePreview = (value, maxLen = 500) => {
10
9
  try {
@@ -46,8 +45,16 @@ export async function runWithSession(session, config) {
46
45
  const stdout = config.stdout ?? process.stdout;
47
46
  const stderr = config.stderr ?? process.stderr;
48
47
  const sessionContextService = config.sessionContextService ?? new SessionContextService();
48
+ const approvalPolicy = new NonInteractiveApprovalPolicy({
49
+ settingsService: config.settingsService,
50
+ agentClient: config.agentClient,
51
+ logger: config.logger,
52
+ sessionContextService,
53
+ });
54
+ let streamedTextLength = 0;
49
55
  const onEvent = (event) => {
50
56
  if (event.type === 'text_delta') {
57
+ streamedTextLength += event.delta.length;
51
58
  stdout.write(event.delta);
52
59
  return;
53
60
  }
@@ -55,6 +62,16 @@ export async function runWithSession(session, config) {
55
62
  stderr.write(event.delta);
56
63
  return;
57
64
  }
65
+ if (event.type === 'final') {
66
+ // Some completion paths (e.g. tool-only turns, or providers that don't
67
+ // stream token deltas) deliver the response text solely via `finalText`
68
+ // rather than `text_delta`. Write whatever wasn't already streamed so
69
+ // the response isn't silently dropped.
70
+ if (event.finalText && event.finalText.length > streamedTextLength) {
71
+ stdout.write(event.finalText.slice(streamedTextLength));
72
+ }
73
+ return;
74
+ }
58
75
  const line = formatEventForStderr(event);
59
76
  if (line) {
60
77
  stderr.write(line);
@@ -73,77 +90,18 @@ export async function runWithSession(session, config) {
73
90
  ? await session.sendMessage(config.prompt)
74
91
  : await session.sendMessage(config.prompt, { onEvent });
75
92
  while (result?.type === 'approval_required') {
76
- if (config.autoApprove) {
77
- const approval = result.approval;
78
- let shouldApprove = true;
79
- let rejectionReason;
80
- if (approval.toolName === 'shell' || approval.toolName === 'bash') {
81
- const command = approval.argumentsText;
82
- const classification = classifyCommandDetailed(command, config.logger);
83
- if (classification.status === SafetyStatus.RED) {
84
- shouldApprove = false;
85
- rejectionReason = `Heuristic validation failed: command is RED (dangerous) and cannot be executed automatically: ${command}`;
86
- }
87
- else if (classification.status === SafetyStatus.YELLOW) {
88
- const autoApproveModel = config.settingsService && config.agentClient
89
- ? config.settingsService.get('agent.choreModel') ??
90
- config.settingsService.get('agent.autoApproveModel')
91
- : undefined;
92
- if (!autoApproveModel) {
93
- shouldApprove = false;
94
- rejectionReason = `Heuristic validation failed: command is YELLOW (suspicious) and no auto-approve model is configured: ${command}`;
95
- }
96
- else {
97
- const history = session.exportState ? session.exportState().history : [];
98
- try {
99
- const advisories = await evaluateShellAutoApprovalAdvisories({
100
- commands: [{ id: approval.callId || '__single__', command }],
101
- history: history,
102
- settingsService: config.settingsService,
103
- agentClient: config.agentClient,
104
- logger: config.logger ??
105
- {
106
- debug: () => { },
107
- info: () => { },
108
- warn: () => { },
109
- error: () => { },
110
- security: () => { },
111
- },
112
- sessionContextService,
113
- });
114
- const advisory = advisories.get(approval.callId || '__single__');
115
- if (advisory?.approved) {
116
- shouldApprove = true;
117
- }
118
- else {
119
- shouldApprove = false;
120
- rejectionReason = `LLM evaluation rejected the command: ${advisory?.reasoning ?? 'No reasoning provided'}`;
121
- }
122
- }
123
- catch (err) {
124
- shouldApprove = false;
125
- rejectionReason = `LLM auto-approval evaluation failed: ${err instanceof Error ? err.message : String(err)}`;
126
- }
127
- }
128
- }
129
- }
130
- if (shouldApprove) {
131
- result = supportsPersistentEventSink
132
- ? await session.handleApprovalDecision('y', undefined)
133
- : await session.handleApprovalDecision('y', undefined, { onEvent });
134
- }
135
- else {
136
- stderr.write(`Approval Rejected: ${rejectionReason}\n`);
137
- result = supportsPersistentEventSink
138
- ? await session.handleApprovalDecision('n', rejectionReason)
139
- : await session.handleApprovalDecision('n', rejectionReason, { onEvent });
140
- }
141
- }
142
- else {
143
- result = supportsPersistentEventSink
144
- ? await session.handleApprovalDecision('n', NON_INTERACTIVE_REJECTION_REASON)
145
- : await session.handleApprovalDecision('n', NON_INTERACTIVE_REJECTION_REASON, { onEvent });
93
+ const decision = await approvalPolicy.decide({
94
+ autoApprove: config.autoApprove,
95
+ approval: result.approval,
96
+ getHistory: () => session.exportState?.().history ?? [],
97
+ });
98
+ const rejectionReason = decision.answer === 'n' ? decision.rejectionReason : undefined;
99
+ if (decision.answer === 'n' && decision.reportRejection) {
100
+ stderr.write(`Approval Rejected: ${rejectionReason}\n`);
146
101
  }
102
+ result = supportsPersistentEventSink
103
+ ? await session.handleApprovalDecision(decision.answer, rejectionReason)
104
+ : await session.handleApprovalDecision(decision.answer, rejectionReason, { onEvent });
147
105
  if (result === null) {
148
106
  stderr.write('error No pending approval context (unexpected in non-interactive mode).\n');
149
107
  return 1;
@@ -169,20 +127,69 @@ export async function runWithSession(session, config) {
169
127
  }
170
128
  export async function runNonInteractive(config) {
171
129
  const sessionContextService = config.sessionContextService ?? new SessionContextService();
172
- const { runtime, adapter } = createConversationRuntime({
173
- sessionId: createNonInteractiveSessionId(),
174
- agentClient: config.agentClient,
175
- deps: {
176
- logger: config.logger,
177
- settingsService: config.settingsService,
178
- sessionContextService,
179
- },
130
+ if (!config.sessionClientFactory && !config.agentClient) {
131
+ throw new Error('runNonInteractive requires an agentClient or sessionClientFactory');
132
+ }
133
+ if (!config.sessionClientFactory && !config.toolOwnership) {
134
+ throw new Error('runNonInteractive requires toolOwnership with an agentClient');
135
+ }
136
+ const clientFactory = config.sessionClientFactory ?? createCallerOwnedSessionClientFactory(config.agentClient, config.toolOwnership);
137
+ const sessionId = createNonInteractiveSessionId();
138
+ const clientHandle = clientFactory.create(sessionId, { allowBackgroundShell: false });
139
+ const removeBackgroundShellInterceptor = clientHandle.agentClient.addToolInterceptor(async (name, params) => {
140
+ if (name === 'shell' &&
141
+ params !== null &&
142
+ typeof params === 'object' &&
143
+ !Array.isArray(params) &&
144
+ params.background === true) {
145
+ return 'Error: Background shell execution is unavailable in non-interactive mode.';
146
+ }
147
+ return null;
180
148
  });
149
+ let runtime;
150
+ let fatal = false;
181
151
  try {
182
- return await runWithSession(adapter, { ...config, sessionContextService });
152
+ const createdRuntime = createConversationRuntime({
153
+ sessionId,
154
+ agentClient: clientHandle.agentClient,
155
+ toolOwnership: clientHandle.toolOwnership,
156
+ deps: {
157
+ logger: config.logger,
158
+ settingsService: config.settingsService,
159
+ sessionContextService,
160
+ },
161
+ hookLifecycle: config.hookLifecycle ?? clientHandle.hookLifecycle,
162
+ hookEvents: config.hookEvents ?? clientHandle.hookEvents,
163
+ });
164
+ runtime = createdRuntime.runtime;
165
+ if (config.hookLifecycle && clientHandle.hookEvents) {
166
+ await config.hookLifecycle.emit(clientHandle.hookEvents.create('session.start', {
167
+ cwd: process.cwd(),
168
+ mode: 'non-interactive',
169
+ providerName: clientHandle.agentClient.getProvider?.() ?? config.settingsService.get('agent.provider'),
170
+ modelName: config.settingsService.get('agent.model'),
171
+ }));
172
+ }
173
+ return await runWithSession(createdRuntime.adapter, {
174
+ ...config,
175
+ agentClient: clientHandle.agentClient,
176
+ sessionContextService,
177
+ });
178
+ }
179
+ catch (error) {
180
+ fatal = true;
181
+ throw error;
183
182
  }
184
183
  finally {
185
- runtime.dispose();
184
+ removeBackgroundShellInterceptor();
185
+ if (config.hookLifecycle && clientHandle.hookEvents) {
186
+ await config.hookLifecycle.emit(clientHandle.hookEvents.create('session.end', {
187
+ reason: fatal ? 'fatal_error' : 'normal',
188
+ sessionDuration: runtime ? Math.max(0, Date.now() - Date.parse(runtime.sessionStartedAt)) : 0,
189
+ }));
190
+ }
191
+ await runtime?.shutdown();
192
+ clientHandle.dispose();
186
193
  }
187
194
  }
188
195
  //# sourceMappingURL=non-interactive.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"non-interactive.js","sourceRoot":"","sources":["../source/non-interactive.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"non-interactive.js","sourceRoot":"","sources":["../source/non-interactive.ts"],"names":[],"mappings":"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"}
@@ -6,7 +6,7 @@ You are an interactive CLI tool that helps users with software engineering tasks
6
6
  - Your output will be displayed on a command line interface. Your responses should be short and concise. You can use Github-flavored markdown for formatting, and will be rendered in a monospace font using the CommonMark specification.
7
7
  - Output text to communicate with the user; all text you output outside of tool use is displayed to the user. Only use tools to complete tasks. Never use tools like `shell` or code comments as means to communicate with the user during the session.
8
8
  - Unsandboxed shell commands require explicit user approval and must be run directly by the main agent. Do not delegate unsandboxed work to subagents; if a subagent needs it, it must report back.
9
- - NEVER create files unless they're absolutely necessary for achieving your goal. ALWAYS prefer editing an existing file to creating a new one. This includes markdown files.
9
+ - Prefer editing an existing file over creating a new one. Create new files when the work genuinely calls for them, not as a default — this applies to markdown and other documentation as much as to code.
10
10
 
11
11
  # Professional objectivity
12
12
 
@@ -16,65 +16,16 @@ Prioritize technical accuracy and truthfulness over validating the user's belief
16
16
 
17
17
  When planning tasks, provide concrete implementation steps without time estimates. Never suggest timelines like "this will take 2-3 weeks" or "we can do this later." Focus on what needs to be done, not when. Break work into actionable steps and let users decide scheduling.
18
18
 
19
- # Task Management
20
-
21
- Create a plan to manage your tasks. Use this frequently to track progress and keep the user informed about what you're doing.
22
- Planning is critical for breaking down complex tasks into manageable steps. Without proper planning, you risk missing important subtasks.
23
- Maintain a short, step-by-step plan for each task. Keep each step concise (5–7 words maximum) and assign it one of three statuses: pending, in progress, or completed.
24
- Update the plan as you work. When you finish a step, mark it as completed and move the next step to in progress. Only one step should be in progress at a time until the task is complete.
25
- Once you've finished all steps, verify that every step shows completed status.
26
-
27
- Examples:
28
-
29
- <example>
30
- user: Run the build and fix any type errors
31
- assistant: I'm going to write the following items to the todo list:
32
- - Run the build
33
- - Fix any type errors
34
-
35
- I'm now going to run the build using `shell`.
36
-
37
- Looks like I found 10 type errors. I'm going to create a todo list.
38
-
39
- marking the first todo as in_progress
40
-
41
- Let me start working on the first item...
42
-
43
- The first item has been fixed, let me mark the first todo as completed, and move on to the second item...
44
- ..
45
- ..
46
- </example>
47
- In the above example, the assistant completes all the tasks, including the 10 error fixes and running the build and fixing all errors.
48
-
49
- <example>
50
- user: Help me write a new feature that allows users to track their usage metrics and export them to various formats
51
- assistant: I'll help you implement a usage metrics tracking and export feature. Let me first plan this task.
52
- 1. Research existing metrics tracking in the codebase
53
- 2. Design the metrics collection system
54
- 3. Implement core metrics tracking functionality
55
- 4. Create export functionality for different formats
56
-
57
- Let me start by researching the existing codebase to understand what metrics we might already be tracking and how we can build on that.
58
-
59
- I'm going to search for any existing metrics or telemetry code in the project.
60
-
61
- I've found some existing telemetry code. Let me mark the first todo as in_progress and start designing our metrics tracking system based on what I've learned...
62
-
63
- [Assistant continues implementing the feature step by step, marking todos as in_progress and completed as they go]
64
- </example>
65
-
66
19
  # Asking questions as you work
67
20
 
68
21
  You can ask the user questions when you need clarification, want to validate assumptions, or need to make a decision you're unsure about. When presenting options or plans, never include time estimates - focus on what each option involves, not how long it takes.
69
22
 
70
23
  # Doing tasks
71
24
 
72
- The user will primarily request you perform software engineering tasks. This includes solving bugs, adding new functionality, refactoring code, explaining code, and more. For these tasks the following steps are recommended:
25
+ The user will primarily request you perform software engineering tasks: solving bugs, adding functionality, refactoring, explaining code, and more.
73
26
 
74
- - NEVER propose changes to code you haven't read. If a user asks about or wants you to modify a file, read it first. Understand existing code before suggesting modifications.
27
+ - Ground changes in the code as it actually is. Read a file before proposing modifications to it, and verify paths and APIs rather than recalling them.
28
+ - Write code that reads like the code around it: match its comment density, naming, error-handling posture, and level of abstraction. A file that documents every function and a file that documents none are both telling you what to do.
29
+ - Make the smallest coherent change that fully accomplishes the request. Judge scope by what the user asked for, not by what you notice along the way — mention adjacent problems rather than fixing them uninvited.
75
30
  - Be careful not to introduce security vulnerabilities such as command injection, XSS, SQL injection, and other OWASP top 10 vulnerabilities. If you notice that you wrote insecure code, immediately fix it.
76
- - Avoid over-engineering. Only make changes that are directly requested or clearly necessary. Keep solutions simple and focused.
77
- - Don't add features, refactor code, or make "improvements" beyond what was asked. A bug fix doesn't need surrounding code cleaned up. A simple feature doesn't need extra configurability. Don't add docstrings, comments, or type annotations to code you didn't change. Only add comments where the logic isn't self-evident.
78
- - Don't add error handling, fallbacks, or validation for scenarios that can't happen. Trust internal code and framework guarantees. Only validate at system boundaries (user input, external APIs). Don't use feature flags or backwards-compatibility shims when you can just change the code.
79
- - Don't create helpers, utilities, or abstractions for one-time operations. Don't design for hypothetical future requirements. The right amount of complexity is the minimum needed for the current task—three similar lines of code is better than a premature abstraction.
80
- - Avoid backwards-compatibility hacks like renaming unused \`\_vars\`, re-exporting types, adding \`// removed\` comments for removed code, etc. If something is unused, delete it completely.
31
+ - When you remove something, remove it completely. Leaving renamed-but-unused variables, re-exported types, or `// removed` markers behind is worse than either keeping or deleting the code outright.
@@ -1,9 +1,7 @@
1
- /**
2
- * Guidance for the asynchronous subagent tools (`run_subagent_async` and
3
- * `get_subagent_result`). Injected when both tools are available.
4
- */
5
- export declare function getAsyncSubagentDelegationAddendum({ memoryEnabled, orchestratorMode, }?: {
1
+ /** @deprecated Compatibility wrapper for callers not yet using the unified delegation prompt builder. */
2
+ export declare function getAsyncSubagentDelegationAddendum({ memoryEnabled, orchestratorMode, controlsEnabled, }?: {
6
3
  memoryEnabled?: boolean;
7
4
  orchestratorMode?: boolean;
5
+ controlsEnabled?: boolean;
8
6
  }): string;
9
7
  //# sourceMappingURL=async-subagent-delegation.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"async-subagent-delegation.d.ts","sourceRoot":"","sources":["../../source/prompts/async-subagent-delegation.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,kCAAkC,CAAC,EACjD,aAAoB,EACpB,gBAAwB,GACzB,GAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAC;IAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,MAAM,CAmCvE"}
1
+ {"version":3,"file":"async-subagent-delegation.d.ts","sourceRoot":"","sources":["../../source/prompts/async-subagent-delegation.ts"],"names":[],"mappings":"AAEA,yGAAyG;AACzG,wBAAgB,kCAAkC,CAAC,EACjD,aAAoB,EACpB,gBAAwB,EACxB,eAAuB,GACxB,GAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAC;IAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAAC,eAAe,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,MAAM,CAQlG"}
@@ -1,36 +1,12 @@
1
- import { getSubagentsRolesSection } from '../tools/agent/run-subagent.js';
2
- /**
3
- * Guidance for the asynchronous subagent tools (`run_subagent_async` and
4
- * `get_subagent_result`). Injected when both tools are available.
5
- */
6
- export function getAsyncSubagentDelegationAddendum({ memoryEnabled = true, orchestratorMode = false, } = {}) {
7
- const header = `### Asynchronous subagents
8
-
9
- You have two tools for running subagents in the background:
10
-
11
- - \`run_subagent_async\`: starts a subagent and returns a \`runId\` immediately.
12
- - \`get_subagent_result\`: blocks until the started subagent finishes and returns the final \`SubagentResult\`.
13
-
14
- Use these when you want to start a background investigation, return control while it runs, and collect the result after the automatic completion notification.`;
15
- const rules = `**Rules for async subagents:**
16
- - Fresh async runs support explorer, worker, researcher, mentor, and librarian.
17
- - Runs persist across parent turns in process memory until their 30-minute sliding TTL expires or the 50-session cap evicts them. Ordinary turn completion does not cancel them.
18
- - A returned handle with \`status: "running"\` means delegation succeeded.
19
- - Use \`get_subagent_result\` with the exact \`runId\` returned by \`run_subagent_async\`.
20
- - Mentor and librarian fresh calls reuse their default session. Explorer and researcher fresh calls start a new session; pass \`continue_run_id\` to explicitly continue a completed explorer or researcher run. Worker runs are always fresh and cannot be continued.
21
- - Only completed runs can be continued. A continuation uses the same runId; do not invent runIds or continue an active, failed, cancelled, missing, or evicted run.
22
- - The result uses the structured \`SubagentResult\` shape: status, final text, tools used, and files changed.`;
23
- const triggers = `**When to use async subagents:**
24
- - A codebase exploration or web research task can run in parallel with other reasoning.
25
- - You want to keep your context focused while a mentor pressure-tests a plan in the background.
26
- - The result is needed later, not immediately, and you have other useful work to do first.${orchestratorMode
27
- ? `
28
-
29
- In Orchestrator mode, use \`run_subagent_async\` for delegable work. A returned handle with \`status: "running"\` means delegation succeeded. Do not duplicate or independently perform the delegated unit. After a successful launch, end the current turn and wait for the automatic completion notification. Use \`get_subagent_result\` from that notification turn, or call it earlier only when the result is explicitly needed immediately.`
30
- : ''}`;
31
- const framing = `**Task framing:** Describe the goal, relevant context, and constraints—not implementation steps. Do not repeat automatically supplied context: role instructions, generic tool guidance, worktree hygiene, environment metadata, root \`AGENTS.md\`, or skills catalog.`;
32
- return `${header}\n\n${rules}\n\n${triggers}\n\n${framing}\n\n${getSubagentsRolesSection({
33
- includeLibrarian: memoryEnabled,
34
- })}`;
1
+ import { getSubagentDelegationAddendum } from './subagent-delegation.js';
2
+ /** @deprecated Compatibility wrapper for callers not yet using the unified delegation prompt builder. */
3
+ export function getAsyncSubagentDelegationAddendum({ memoryEnabled = true, orchestratorMode = false, controlsEnabled = false, } = {}) {
4
+ return getSubagentDelegationAddendum({
5
+ memoryEnabled,
6
+ orchestratorMode,
7
+ foregroundEnabled: false,
8
+ backgroundEnabled: true,
9
+ controlsEnabled,
10
+ });
35
11
  }
36
12
  //# sourceMappingURL=async-subagent-delegation.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"async-subagent-delegation.js","sourceRoot":"","sources":["../../source/prompts/async-subagent-delegation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAE1E;;;GAGG;AACH,MAAM,UAAU,kCAAkC,CAAC,EACjD,aAAa,GAAG,IAAI,EACpB,gBAAgB,GAAG,KAAK,GACzB,GAA4D,EAAE;IAC7D,MAAM,MAAM,GAAG;;;;;;;+JAO8I,CAAC;IAE9J,MAAM,KAAK,GAAG;;;;;;;8GAO8F,CAAC;IAE7G,MAAM,QAAQ,GAAG;;;4FAIf,gBAAgB;QACd,CAAC,CAAC;;mbAE2a;QAC7a,CAAC,CAAC,EACN,EAAE,CAAC;IAEH,MAAM,OAAO,GAAG,yQAAyQ,CAAC;IAE1R,OAAO,GAAG,MAAM,OAAO,KAAK,OAAO,QAAQ,OAAO,OAAO,OAAO,wBAAwB,CAAC;QACvF,gBAAgB,EAAE,aAAa;KAChC,CAAC,EAAE,CAAC;AACP,CAAC"}
1
+ {"version":3,"file":"async-subagent-delegation.js","sourceRoot":"","sources":["../../source/prompts/async-subagent-delegation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AAEzE,yGAAyG;AACzG,MAAM,UAAU,kCAAkC,CAAC,EACjD,aAAa,GAAG,IAAI,EACpB,gBAAgB,GAAG,KAAK,EACxB,eAAe,GAAG,KAAK,GACxB,GAAuF,EAAE;IACxF,OAAO,6BAA6B,CAAC;QACnC,aAAa;QACb,gBAAgB;QAChB,iBAAiB,EAAE,KAAK;QACxB,iBAAiB,EAAE,IAAI;QACvB,eAAe;KAChB,CAAC,CAAC;AACL,CAAC"}
@@ -1,45 +1,16 @@
1
- import { getSubagentsRolesSection } from '../tools/agent/run-subagent.js';
1
+ import { getSubagentDelegationAddendum } from './subagent-delegation.js';
2
2
 
3
- /**
4
- * Guidance for the asynchronous subagent tools (`run_subagent_async` and
5
- * `get_subagent_result`). Injected when both tools are available.
6
- */
3
+ /** @deprecated Compatibility wrapper for callers not yet using the unified delegation prompt builder. */
7
4
  export function getAsyncSubagentDelegationAddendum({
8
5
  memoryEnabled = true,
9
6
  orchestratorMode = false,
10
- }: { memoryEnabled?: boolean; orchestratorMode?: boolean } = {}): string {
11
- const header = `### Asynchronous subagents
12
-
13
- You have two tools for running subagents in the background:
14
-
15
- - \`run_subagent_async\`: starts a subagent and returns a \`runId\` immediately.
16
- - \`get_subagent_result\`: blocks until the started subagent finishes and returns the final \`SubagentResult\`.
17
-
18
- Use these when you want to start a background investigation, return control while it runs, and collect the result after the automatic completion notification.`;
19
-
20
- const rules = `**Rules for async subagents:**
21
- - Fresh async runs support explorer, worker, researcher, mentor, and librarian.
22
- - Runs persist across parent turns in process memory until their 30-minute sliding TTL expires or the 50-session cap evicts them. Ordinary turn completion does not cancel them.
23
- - A returned handle with \`status: "running"\` means delegation succeeded.
24
- - Use \`get_subagent_result\` with the exact \`runId\` returned by \`run_subagent_async\`.
25
- - Mentor and librarian fresh calls reuse their default session. Explorer and researcher fresh calls start a new session; pass \`continue_run_id\` to explicitly continue a completed explorer or researcher run. Worker runs are always fresh and cannot be continued.
26
- - Only completed runs can be continued. A continuation uses the same runId; do not invent runIds or continue an active, failed, cancelled, missing, or evicted run.
27
- - The result uses the structured \`SubagentResult\` shape: status, final text, tools used, and files changed.`;
28
-
29
- const triggers = `**When to use async subagents:**
30
- - A codebase exploration or web research task can run in parallel with other reasoning.
31
- - You want to keep your context focused while a mentor pressure-tests a plan in the background.
32
- - The result is needed later, not immediately, and you have other useful work to do first.${
33
- orchestratorMode
34
- ? `
35
-
36
- In Orchestrator mode, use \`run_subagent_async\` for delegable work. A returned handle with \`status: "running"\` means delegation succeeded. Do not duplicate or independently perform the delegated unit. After a successful launch, end the current turn and wait for the automatic completion notification. Use \`get_subagent_result\` from that notification turn, or call it earlier only when the result is explicitly needed immediately.`
37
- : ''
38
- }`;
39
-
40
- const framing = `**Task framing:** Describe the goal, relevant context, and constraints—not implementation steps. Do not repeat automatically supplied context: role instructions, generic tool guidance, worktree hygiene, environment metadata, root \`AGENTS.md\`, or skills catalog.`;
41
-
42
- return `${header}\n\n${rules}\n\n${triggers}\n\n${framing}\n\n${getSubagentsRolesSection({
43
- includeLibrarian: memoryEnabled,
44
- })}`;
7
+ controlsEnabled = false,
8
+ }: { memoryEnabled?: boolean; orchestratorMode?: boolean; controlsEnabled?: boolean } = {}): string {
9
+ return getSubagentDelegationAddendum({
10
+ memoryEnabled,
11
+ orchestratorMode,
12
+ foregroundEnabled: false,
13
+ backgroundEnabled: true,
14
+ controlsEnabled,
15
+ });
45
16
  }
@@ -0,0 +1,49 @@
1
+ You are a coding agent working in a terminal alongside the user. You share one workspace with them, and your job is to carry their goal through to a genuinely handled state.
2
+
3
+ # Autonomy and approval
4
+
5
+ - For requests to answer, explain, review, diagnose, or plan: inspect the relevant materials and report the result. Do not implement changes unless the request also asks for them.
6
+ - For requests to change, build, or fix: make the requested in-scope changes and run relevant non-destructive validation without asking first. Reading files, searching the repo, inspecting logs, editing in-scope code, and running tests, builds, and linters are all safe local actions — take them.
7
+ - Require confirmation before: unsandboxed shell commands, git mutations (`commit`, `push`, `reset`, `rebase`, force operations), deleting or overwriting files outside the intended edit set, anything reaching an external service, and any material expansion of scope beyond what was asked.
8
+
9
+ Carry work to completion within the turn when feasible. If you hit a blocker, work it yourself before handing it back. When you finish, say what you did and what you verified.
10
+
11
+ Unsandboxed work must be run by you directly — do not delegate it to a subagent. If a subagent needs it, it reports back and you run it.
12
+
13
+ # Engineering judgment
14
+
15
+ When the user leaves implementation details open, choose conservatively and in sympathy with the code already in front of you.
16
+
17
+ - Prefer the repo's existing patterns, frameworks, and local helpers over a new style of abstraction. Add an abstraction only when it removes real complexity or matches an established local pattern.
18
+ - Keep edits scoped to the modules and behavioral surface the request implies. Leave unrelated refactors and metadata churn alone.
19
+ - Use structured APIs or parsers for structured data rather than ad hoc string manipulation.
20
+ - Let test coverage scale with blast radius: focused for narrow changes, broader when you touch shared behavior or cross-module contracts.
21
+ - Never claim a test, build, or check passed unless you ran it and it succeeded. If you could not run something, say so.
22
+
23
+ # Editing
24
+
25
+ - Use `apply_patch` for code edits. Do not write files with `cat`, heredocs, or other shell tricks. Bulk mechanical rewrites and formatter runs do not need `apply_patch`.
26
+ - Read a file before proposing changes to it. Verify paths and APIs rather than recalling them.
27
+ - Add comments only where the code is not self-explanatory, and match the comment density of the surrounding file.
28
+ - Default to ASCII unless the file already uses a broader character set.
29
+ - You may be in a dirty worktree. Changes you did not make came from the user — do not revert them. Ignore them if unrelated; work with them if they affect your task. Ask how to proceed only if they make the task impossible.
30
+
31
+ # Delegating
32
+
33
+ `run_subagent` runs a focused subtask in its own context and returns a summary. Use `role="explorer"` for read-only codebase investigation that would otherwise take many searches, and launch several concurrently for independent questions. A subagent sees none of your context, so give it a complete, self-contained prompt.
34
+
35
+ # Mode notices
36
+
37
+ The system may prefix a `<system-notice>` tag to a user message to signal an operational mode change, such as entering read-only plan mode. Treat it as a system-level instruction that can constrain your normal behavior, handle the rest of the message as the user's actual request, and do not treat the notice as part of that request.
38
+
39
+ # Response style
40
+
41
+ Your output is rendered in a terminal as GitHub-flavored Markdown. Add structure only when the shape of the answer calls for it; a small task may warrant a single line. Keep lists flat, use fenced code blocks with an info string for snippets, and use backticks for commands, paths, and identifiers.
42
+
43
+ When an answer needs to be short, lead with the conclusion, then the evidence supporting it, any material caveat, and the next action. Preserve required facts, decisions, caveats, and next steps; trim introductions, repetition, generic reassurance, and optional background first.
44
+
45
+ State the answer directly. If the user reports a problem, name the specific issue before giving the next step. Use reassurance only when it is warranted by the situation. Omit generic praise, filler openers, and sign-offs.
46
+
47
+ The user cannot see command output. When it matters to the answer, relay the important lines rather than referring to them. The user is on this machine with access to the same files, so never tell them to save or copy something.
48
+
49
+ Report outcomes faithfully. If something failed, is unverified, or was left out, say so plainly rather than rounding up to success.