@qduc/term2 0.1.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 (621) hide show
  1. package/LICENSE +21 -0
  2. package/dist/agent.d.ts +19 -0
  3. package/dist/agent.d.ts.map +1 -0
  4. package/dist/agent.js +143 -0
  5. package/dist/agent.js.map +1 -0
  6. package/dist/app.d.ts +22 -0
  7. package/dist/app.d.ts.map +1 -0
  8. package/dist/app.js +403 -0
  9. package/dist/app.js.map +1 -0
  10. package/dist/app.model-command-feedback.test.d.ts +2 -0
  11. package/dist/app.model-command-feedback.test.d.ts.map +1 -0
  12. package/dist/app.model-command-feedback.test.js +19 -0
  13. package/dist/app.model-command-feedback.test.js.map +1 -0
  14. package/dist/app.parseInput.test.d.ts +2 -0
  15. package/dist/app.parseInput.test.d.ts.map +1 -0
  16. package/dist/app.parseInput.test.js +97 -0
  17. package/dist/app.parseInput.test.js.map +1 -0
  18. package/dist/cli.d.ts +3 -0
  19. package/dist/cli.d.ts.map +1 -0
  20. package/dist/cli.js +241 -0
  21. package/dist/cli.js.map +1 -0
  22. package/dist/components/ApprovalPrompt.d.ts +10 -0
  23. package/dist/components/ApprovalPrompt.d.ts.map +1 -0
  24. package/dist/components/ApprovalPrompt.js +163 -0
  25. package/dist/components/ApprovalPrompt.js.map +1 -0
  26. package/dist/components/Banner.d.ts +9 -0
  27. package/dist/components/Banner.d.ts.map +1 -0
  28. package/dist/components/Banner.js +86 -0
  29. package/dist/components/Banner.js.map +1 -0
  30. package/dist/components/BottomArea.d.ts +33 -0
  31. package/dist/components/BottomArea.d.ts.map +1 -0
  32. package/dist/components/BottomArea.js +31 -0
  33. package/dist/components/BottomArea.js.map +1 -0
  34. package/dist/components/BottomArea.test.d.ts +2 -0
  35. package/dist/components/BottomArea.test.d.ts.map +1 -0
  36. package/dist/components/BottomArea.test.js +73 -0
  37. package/dist/components/BottomArea.test.js.map +1 -0
  38. package/dist/components/ChatMessage.d.ts +7 -0
  39. package/dist/components/ChatMessage.d.ts.map +1 -0
  40. package/dist/components/ChatMessage.js +10 -0
  41. package/dist/components/ChatMessage.js.map +1 -0
  42. package/dist/components/CommandMessage.d.ts +15 -0
  43. package/dist/components/CommandMessage.d.ts.map +1 -0
  44. package/dist/components/CommandMessage.js +188 -0
  45. package/dist/components/CommandMessage.js.map +1 -0
  46. package/dist/components/CommandMessage.test.d.ts +2 -0
  47. package/dist/components/CommandMessage.test.d.ts.map +1 -0
  48. package/dist/components/CommandMessage.test.js +35 -0
  49. package/dist/components/CommandMessage.test.js.map +1 -0
  50. package/dist/components/ErrorBoundary.d.ts +27 -0
  51. package/dist/components/ErrorBoundary.d.ts.map +1 -0
  52. package/dist/components/ErrorBoundary.js +77 -0
  53. package/dist/components/ErrorBoundary.js.map +1 -0
  54. package/dist/components/ErrorBoundary.test.d.ts +2 -0
  55. package/dist/components/ErrorBoundary.test.d.ts.map +1 -0
  56. package/dist/components/ErrorBoundary.test.js +32 -0
  57. package/dist/components/ErrorBoundary.test.js.map +1 -0
  58. package/dist/components/Input/PopupManager.d.ts +42 -0
  59. package/dist/components/Input/PopupManager.d.ts.map +1 -0
  60. package/dist/components/Input/PopupManager.js +13 -0
  61. package/dist/components/Input/PopupManager.js.map +1 -0
  62. package/dist/components/InputBox.d.ts +18 -0
  63. package/dist/components/InputBox.d.ts.map +1 -0
  64. package/dist/components/InputBox.js +384 -0
  65. package/dist/components/InputBox.js.map +1 -0
  66. package/dist/components/InputBox.menu-logic.test.d.ts +2 -0
  67. package/dist/components/InputBox.menu-logic.test.d.ts.map +1 -0
  68. package/dist/components/InputBox.menu-logic.test.js +151 -0
  69. package/dist/components/InputBox.menu-logic.test.js.map +1 -0
  70. package/dist/components/InputBox.test.d.ts +2 -0
  71. package/dist/components/InputBox.test.d.ts.map +1 -0
  72. package/dist/components/InputBox.test.js +91 -0
  73. package/dist/components/InputBox.test.js.map +1 -0
  74. package/dist/components/LiveResponse.d.ts +13 -0
  75. package/dist/components/LiveResponse.d.ts.map +1 -0
  76. package/dist/components/LiveResponse.js +16 -0
  77. package/dist/components/LiveResponse.js.map +1 -0
  78. package/dist/components/MarkdownRenderer.d.ts +8 -0
  79. package/dist/components/MarkdownRenderer.d.ts.map +1 -0
  80. package/dist/components/MarkdownRenderer.js +225 -0
  81. package/dist/components/MarkdownRenderer.js.map +1 -0
  82. package/dist/components/MentorMode.test.d.ts +2 -0
  83. package/dist/components/MentorMode.test.d.ts.map +1 -0
  84. package/dist/components/MentorMode.test.js.map +1 -0
  85. package/dist/components/MessageList.d.ts +7 -0
  86. package/dist/components/MessageList.d.ts.map +1 -0
  87. package/dist/components/MessageList.js +29 -0
  88. package/dist/components/MessageList.js.map +1 -0
  89. package/dist/components/MessageList.test.d.ts +2 -0
  90. package/dist/components/MessageList.test.d.ts.map +1 -0
  91. package/dist/components/MessageList.test.js +15 -0
  92. package/dist/components/MessageList.test.js.map +1 -0
  93. package/dist/components/ModelSelectionMenu.d.ts +18 -0
  94. package/dist/components/ModelSelectionMenu.d.ts.map +1 -0
  95. package/dist/components/ModelSelectionMenu.js +91 -0
  96. package/dist/components/ModelSelectionMenu.js.map +1 -0
  97. package/dist/components/ModelSelectionMenu.test.d.ts +2 -0
  98. package/dist/components/ModelSelectionMenu.test.d.ts.map +1 -0
  99. package/dist/components/ModelSelectionMenu.test.js +83 -0
  100. package/dist/components/ModelSelectionMenu.test.js.map +1 -0
  101. package/dist/components/PathSelectionMenu.d.ts +12 -0
  102. package/dist/components/PathSelectionMenu.d.ts.map +1 -0
  103. package/dist/components/PathSelectionMenu.js +42 -0
  104. package/dist/components/PathSelectionMenu.js.map +1 -0
  105. package/dist/components/SettingsSelectionMenu.d.ts +9 -0
  106. package/dist/components/SettingsSelectionMenu.d.ts.map +1 -0
  107. package/dist/components/SettingsSelectionMenu.js +21 -0
  108. package/dist/components/SettingsSelectionMenu.js.map +1 -0
  109. package/dist/components/SlashCommandMenu.d.ts +15 -0
  110. package/dist/components/SlashCommandMenu.d.ts.map +1 -0
  111. package/dist/components/SlashCommandMenu.js +20 -0
  112. package/dist/components/SlashCommandMenu.js.map +1 -0
  113. package/dist/components/StatusBar.d.ts +11 -0
  114. package/dist/components/StatusBar.d.ts.map +1 -0
  115. package/dist/components/StatusBar.js +59 -0
  116. package/dist/components/StatusBar.js.map +1 -0
  117. package/dist/components/TextInput.d.ts +42 -0
  118. package/dist/components/TextInput.d.ts.map +1 -0
  119. package/dist/components/TextInput.js +397 -0
  120. package/dist/components/TextInput.js.map +1 -0
  121. package/dist/components/TextInput.test.d.ts +2 -0
  122. package/dist/components/TextInput.test.d.ts.map +1 -0
  123. package/dist/components/TextInput.test.js +75 -0
  124. package/dist/components/TextInput.test.js.map +1 -0
  125. package/dist/context/InputContext.d.ts +31 -0
  126. package/dist/context/InputContext.d.ts.map +1 -0
  127. package/dist/context/InputContext.js +36 -0
  128. package/dist/context/InputContext.js.map +1 -0
  129. package/dist/context/InputContext.stability.test.d.ts +2 -0
  130. package/dist/context/InputContext.stability.test.d.ts.map +1 -0
  131. package/dist/context/InputContext.stability.test.js +28 -0
  132. package/dist/context/InputContext.stability.test.js.map +1 -0
  133. package/dist/context/InputContext.test.d.ts +2 -0
  134. package/dist/context/InputContext.test.d.ts.map +1 -0
  135. package/dist/context/InputContext.test.js +168 -0
  136. package/dist/context/InputContext.test.js.map +1 -0
  137. package/dist/debug-schema.d.ts +2 -0
  138. package/dist/debug-schema.d.ts.map +1 -0
  139. package/dist/debug-schema.js +22 -0
  140. package/dist/debug-schema.js.map +1 -0
  141. package/dist/hooks/use-conversation.d.ts +78 -0
  142. package/dist/hooks/use-conversation.d.ts.map +1 -0
  143. package/dist/hooks/use-conversation.js +1017 -0
  144. package/dist/hooks/use-conversation.js.map +1 -0
  145. package/dist/hooks/use-input-history.d.ts +16 -0
  146. package/dist/hooks/use-input-history.d.ts.map +1 -0
  147. package/dist/hooks/use-input-history.js +71 -0
  148. package/dist/hooks/use-input-history.js.map +1 -0
  149. package/dist/hooks/use-model-selection.d.ts +27 -0
  150. package/dist/hooks/use-model-selection.d.ts.map +1 -0
  151. package/dist/hooks/use-model-selection.js +187 -0
  152. package/dist/hooks/use-model-selection.js.map +1 -0
  153. package/dist/hooks/use-model-selection.test.d.ts +2 -0
  154. package/dist/hooks/use-model-selection.test.d.ts.map +1 -0
  155. package/dist/hooks/use-model-selection.test.js +28 -0
  156. package/dist/hooks/use-model-selection.test.js.map +1 -0
  157. package/dist/hooks/use-path-completion.d.ts +22 -0
  158. package/dist/hooks/use-path-completion.d.ts.map +1 -0
  159. package/dist/hooks/use-path-completion.js +153 -0
  160. package/dist/hooks/use-path-completion.js.map +1 -0
  161. package/dist/hooks/use-path-completion.test.d.ts +2 -0
  162. package/dist/hooks/use-path-completion.test.d.ts.map +1 -0
  163. package/dist/hooks/use-path-completion.test.js +29 -0
  164. package/dist/hooks/use-path-completion.test.js.map +1 -0
  165. package/dist/hooks/use-setting.d.ts +7 -0
  166. package/dist/hooks/use-setting.d.ts.map +1 -0
  167. package/dist/hooks/use-setting.js +35 -0
  168. package/dist/hooks/use-setting.js.map +1 -0
  169. package/dist/hooks/use-settings-completion.d.ts +23 -0
  170. package/dist/hooks/use-settings-completion.d.ts.map +1 -0
  171. package/dist/hooks/use-settings-completion.js +164 -0
  172. package/dist/hooks/use-settings-completion.js.map +1 -0
  173. package/dist/hooks/use-settings-completion.test.d.ts +2 -0
  174. package/dist/hooks/use-settings-completion.test.d.ts.map +1 -0
  175. package/dist/hooks/use-settings-completion.test.js +334 -0
  176. package/dist/hooks/use-settings-completion.test.js.map +1 -0
  177. package/dist/hooks/use-slash-commands.d.ts +21 -0
  178. package/dist/hooks/use-slash-commands.d.ts.map +1 -0
  179. package/dist/hooks/use-slash-commands.js +87 -0
  180. package/dist/hooks/use-slash-commands.js.map +1 -0
  181. package/dist/hooks/use-slash-commands.test.d.ts +2 -0
  182. package/dist/hooks/use-slash-commands.test.d.ts.map +1 -0
  183. package/dist/hooks/use-slash-commands.test.js +246 -0
  184. package/dist/hooks/use-slash-commands.test.js.map +1 -0
  185. package/dist/lib/editor-impl.d.ts +23 -0
  186. package/dist/lib/editor-impl.d.ts.map +1 -0
  187. package/dist/lib/editor-impl.js +235 -0
  188. package/dist/lib/editor-impl.js.map +1 -0
  189. package/dist/lib/openai-agent-client.chat.test.d.ts +2 -0
  190. package/dist/lib/openai-agent-client.chat.test.d.ts.map +1 -0
  191. package/dist/lib/openai-agent-client.chat.test.js +68 -0
  192. package/dist/lib/openai-agent-client.chat.test.js.map +1 -0
  193. package/dist/lib/openai-agent-client.d.ts +48 -0
  194. package/dist/lib/openai-agent-client.d.ts.map +1 -0
  195. package/dist/lib/openai-agent-client.js +653 -0
  196. package/dist/lib/openai-agent-client.js.map +1 -0
  197. package/dist/lib/openai-agent-client.test.d.ts +2 -0
  198. package/dist/lib/openai-agent-client.test.d.ts.map +1 -0
  199. package/dist/lib/openai-agent-client.test.js +181 -0
  200. package/dist/lib/openai-agent-client.test.js.map +1 -0
  201. package/dist/lib/shell.d.ts +7 -0
  202. package/dist/lib/shell.d.ts.map +1 -0
  203. package/dist/lib/shell.js +56 -0
  204. package/dist/lib/shell.js.map +1 -0
  205. package/dist/lib/tool-invoke.d.ts +4 -0
  206. package/dist/lib/tool-invoke.d.ts.map +1 -0
  207. package/dist/lib/tool-invoke.js +26 -0
  208. package/dist/lib/tool-invoke.js.map +1 -0
  209. package/dist/lib/tool-invoke.test.d.ts +2 -0
  210. package/dist/lib/tool-invoke.test.d.ts.map +1 -0
  211. package/dist/lib/tool-invoke.test.js +19 -0
  212. package/dist/lib/tool-invoke.test.js.map +1 -0
  213. package/dist/no-singleton-imports.test.d.ts +2 -0
  214. package/dist/no-singleton-imports.test.d.ts.map +1 -0
  215. package/dist/no-singleton-imports.test.js +30 -0
  216. package/dist/no-singleton-imports.test.js.map +1 -0
  217. package/dist/prompts/anthropic.md +79 -0
  218. package/dist/prompts/codex.md +97 -0
  219. package/dist/prompts/default.md +77 -0
  220. package/dist/prompts/default.md.bak +77 -0
  221. package/dist/prompts/gpt-5.md +318 -0
  222. package/dist/prompts/lite.md +29 -0
  223. package/dist/prompts/simple-mentor.md +207 -0
  224. package/dist/prompts/simple.md +189 -0
  225. package/dist/providers/index.d.ts +5 -0
  226. package/dist/providers/index.d.ts.map +1 -0
  227. package/dist/providers/index.js +8 -0
  228. package/dist/providers/index.js.map +1 -0
  229. package/dist/providers/openai-compatible/api.d.ts +17 -0
  230. package/dist/providers/openai-compatible/api.d.ts.map +1 -0
  231. package/dist/providers/openai-compatible/api.js +58 -0
  232. package/dist/providers/openai-compatible/api.js.map +1 -0
  233. package/dist/providers/openai-compatible/model.d.ts +17 -0
  234. package/dist/providers/openai-compatible/model.d.ts.map +1 -0
  235. package/dist/providers/openai-compatible/model.js +435 -0
  236. package/dist/providers/openai-compatible/model.js.map +1 -0
  237. package/dist/providers/openai-compatible/provider.d.ts +22 -0
  238. package/dist/providers/openai-compatible/provider.d.ts.map +1 -0
  239. package/dist/providers/openai-compatible/provider.js +43 -0
  240. package/dist/providers/openai-compatible/provider.js.map +1 -0
  241. package/dist/providers/openai-compatible/utils.d.ts +3 -0
  242. package/dist/providers/openai-compatible/utils.d.ts.map +1 -0
  243. package/dist/providers/openai-compatible/utils.js +11 -0
  244. package/dist/providers/openai-compatible/utils.js.map +1 -0
  245. package/dist/providers/openai-compatible.provider.d.ts +8 -0
  246. package/dist/providers/openai-compatible.provider.d.ts.map +1 -0
  247. package/dist/providers/openai-compatible.provider.js +71 -0
  248. package/dist/providers/openai-compatible.provider.js.map +1 -0
  249. package/dist/providers/openai.provider.d.ts +2 -0
  250. package/dist/providers/openai.provider.d.ts.map +1 -0
  251. package/dist/providers/openai.provider.js +36 -0
  252. package/dist/providers/openai.provider.js.map +1 -0
  253. package/dist/providers/openrouter/api.d.ts +39 -0
  254. package/dist/providers/openrouter/api.d.ts.map +1 -0
  255. package/dist/providers/openrouter/api.js +172 -0
  256. package/dist/providers/openrouter/api.js.map +1 -0
  257. package/dist/providers/openrouter/converters.d.ts +8 -0
  258. package/dist/providers/openrouter/converters.d.ts.map +1 -0
  259. package/dist/providers/openrouter/converters.js +382 -0
  260. package/dist/providers/openrouter/converters.js.map +1 -0
  261. package/dist/providers/openrouter/converters.test.d.ts +2 -0
  262. package/dist/providers/openrouter/converters.test.d.ts.map +1 -0
  263. package/dist/providers/openrouter/converters.test.js +158 -0
  264. package/dist/providers/openrouter/converters.test.js.map +1 -0
  265. package/dist/providers/openrouter/index.d.ts +4 -0
  266. package/dist/providers/openrouter/index.d.ts.map +1 -0
  267. package/dist/providers/openrouter/index.js +4 -0
  268. package/dist/providers/openrouter/index.js.map +1 -0
  269. package/dist/providers/openrouter/model.d.ts +14 -0
  270. package/dist/providers/openrouter/model.d.ts.map +1 -0
  271. package/dist/providers/openrouter/model.js +485 -0
  272. package/dist/providers/openrouter/model.js.map +1 -0
  273. package/dist/providers/openrouter/provider.d.ts +15 -0
  274. package/dist/providers/openrouter/provider.d.ts.map +1 -0
  275. package/dist/providers/openrouter/provider.js +21 -0
  276. package/dist/providers/openrouter/provider.js.map +1 -0
  277. package/dist/providers/openrouter/utils.d.ts +10 -0
  278. package/dist/providers/openrouter/utils.d.ts.map +1 -0
  279. package/dist/providers/openrouter/utils.js +27 -0
  280. package/dist/providers/openrouter/utils.js.map +1 -0
  281. package/dist/providers/openrouter.api.retry.test.d.ts +2 -0
  282. package/dist/providers/openrouter.api.retry.test.d.ts.map +1 -0
  283. package/dist/providers/openrouter.api.retry.test.js +148 -0
  284. package/dist/providers/openrouter.api.retry.test.js.map +1 -0
  285. package/dist/providers/openrouter.d.ts +2 -0
  286. package/dist/providers/openrouter.d.ts.map +1 -0
  287. package/dist/providers/openrouter.history.test.d.ts +2 -0
  288. package/dist/providers/openrouter.history.test.d.ts.map +1 -0
  289. package/dist/providers/openrouter.history.test.js +533 -0
  290. package/dist/providers/openrouter.history.test.js.map +1 -0
  291. package/dist/providers/openrouter.js +4 -0
  292. package/dist/providers/openrouter.js.map +1 -0
  293. package/dist/providers/openrouter.provider.createRunner.test.d.ts +2 -0
  294. package/dist/providers/openrouter.provider.createRunner.test.d.ts.map +1 -0
  295. package/dist/providers/openrouter.provider.createRunner.test.js +23 -0
  296. package/dist/providers/openrouter.provider.createRunner.test.js.map +1 -0
  297. package/dist/providers/openrouter.provider.d.ts +2 -0
  298. package/dist/providers/openrouter.provider.d.ts.map +1 -0
  299. package/dist/providers/openrouter.provider.js +56 -0
  300. package/dist/providers/openrouter.provider.js.map +1 -0
  301. package/dist/providers/openrouter.test.d.ts +2 -0
  302. package/dist/providers/openrouter.test.d.ts.map +1 -0
  303. package/dist/providers/openrouter.test.js +1382 -0
  304. package/dist/providers/openrouter.test.js.map +1 -0
  305. package/dist/providers/registry.d.ts +65 -0
  306. package/dist/providers/registry.d.ts.map +1 -0
  307. package/dist/providers/registry.js +44 -0
  308. package/dist/providers/registry.js.map +1 -0
  309. package/dist/providers/registry.test.d.ts +2 -0
  310. package/dist/providers/registry.test.d.ts.map +1 -0
  311. package/dist/providers/registry.test.js +76 -0
  312. package/dist/providers/registry.test.js.map +1 -0
  313. package/dist/providers/web-search/index.d.ts +8 -0
  314. package/dist/providers/web-search/index.d.ts.map +1 -0
  315. package/dist/providers/web-search/index.js +9 -0
  316. package/dist/providers/web-search/index.js.map +1 -0
  317. package/dist/providers/web-search/registry.d.ts +35 -0
  318. package/dist/providers/web-search/registry.d.ts.map +1 -0
  319. package/dist/providers/web-search/registry.js +56 -0
  320. package/dist/providers/web-search/registry.js.map +1 -0
  321. package/dist/providers/web-search/registry.test.d.ts +2 -0
  322. package/dist/providers/web-search/registry.test.d.ts.map +1 -0
  323. package/dist/providers/web-search/registry.test.js +105 -0
  324. package/dist/providers/web-search/registry.test.js.map +1 -0
  325. package/dist/providers/web-search/tavily.provider.d.ts +15 -0
  326. package/dist/providers/web-search/tavily.provider.d.ts.map +1 -0
  327. package/dist/providers/web-search/tavily.provider.js +69 -0
  328. package/dist/providers/web-search/tavily.provider.js.map +1 -0
  329. package/dist/providers/web-search/tavily.provider.test.d.ts +2 -0
  330. package/dist/providers/web-search/tavily.provider.test.d.ts.map +1 -0
  331. package/dist/providers/web-search/tavily.provider.test.js +67 -0
  332. package/dist/providers/web-search/tavily.provider.test.js.map +1 -0
  333. package/dist/providers/web-search/types.d.ts +55 -0
  334. package/dist/providers/web-search/types.d.ts.map +1 -0
  335. package/dist/providers/web-search/types.js +6 -0
  336. package/dist/providers/web-search/types.js.map +1 -0
  337. package/dist/safety-checker.js +57 -0
  338. package/dist/services/conversation-events.d.ts +76 -0
  339. package/dist/services/conversation-events.d.ts.map +1 -0
  340. package/dist/services/conversation-events.js +2 -0
  341. package/dist/services/conversation-events.js.map +1 -0
  342. package/dist/services/conversation-service.d.ts +31 -0
  343. package/dist/services/conversation-service.d.ts.map +1 -0
  344. package/dist/services/conversation-service.js +46 -0
  345. package/dist/services/conversation-service.js.map +1 -0
  346. package/dist/services/conversation-service.test.js +190 -0
  347. package/dist/services/conversation-session.d.ts +99 -0
  348. package/dist/services/conversation-session.d.ts.map +1 -0
  349. package/dist/services/conversation-session.js +978 -0
  350. package/dist/services/conversation-session.js.map +1 -0
  351. package/dist/services/conversation-store.d.ts +24 -0
  352. package/dist/services/conversation-store.d.ts.map +1 -0
  353. package/dist/services/conversation-store.js +216 -0
  354. package/dist/services/conversation-store.js.map +1 -0
  355. package/dist/services/conversation-store.test.d.ts +2 -0
  356. package/dist/services/conversation-store.test.d.ts.map +1 -0
  357. package/dist/services/conversation-store.test.js +167 -0
  358. package/dist/services/conversation-store.test.js.map +1 -0
  359. package/dist/services/execution-context.d.ts +10 -0
  360. package/dist/services/execution-context.d.ts.map +1 -0
  361. package/dist/services/execution-context.js +22 -0
  362. package/dist/services/execution-context.js.map +1 -0
  363. package/dist/services/execution-context.test.d.ts +2 -0
  364. package/dist/services/execution-context.test.d.ts.map +1 -0
  365. package/dist/services/execution-context.test.js +49 -0
  366. package/dist/services/execution-context.test.js.map +1 -0
  367. package/dist/services/file-service.d.ts +12 -0
  368. package/dist/services/file-service.d.ts.map +1 -0
  369. package/dist/services/file-service.js +90 -0
  370. package/dist/services/file-service.js.map +1 -0
  371. package/dist/services/history-service.d.ts +39 -0
  372. package/dist/services/history-service.d.ts.map +1 -0
  373. package/dist/services/history-service.js +152 -0
  374. package/dist/services/history-service.js.map +1 -0
  375. package/dist/services/logging-service.d.ts +75 -0
  376. package/dist/services/logging-service.d.ts.map +1 -0
  377. package/dist/services/logging-service.js +343 -0
  378. package/dist/services/logging-service.js.map +1 -0
  379. package/dist/services/model-service.d.ts +15 -0
  380. package/dist/services/model-service.d.ts.map +1 -0
  381. package/dist/services/model-service.js +46 -0
  382. package/dist/services/model-service.js.map +1 -0
  383. package/dist/services/model-service.test.d.ts +2 -0
  384. package/dist/services/model-service.test.d.ts.map +1 -0
  385. package/dist/services/model-service.test.js +128 -0
  386. package/dist/services/model-service.test.js.map +1 -0
  387. package/dist/services/service-interfaces.d.ts +33 -0
  388. package/dist/services/service-interfaces.d.ts.map +1 -0
  389. package/dist/services/service-interfaces.js +2 -0
  390. package/dist/services/service-interfaces.js.map +1 -0
  391. package/dist/services/settings-service.d.ts +316 -0
  392. package/dist/services/settings-service.d.ts.map +1 -0
  393. package/dist/services/settings-service.js +1128 -0
  394. package/dist/services/settings-service.js.map +1 -0
  395. package/dist/services/settings-service.mock.d.ts +20 -0
  396. package/dist/services/settings-service.mock.d.ts.map +1 -0
  397. package/dist/services/settings-service.mock.js +55 -0
  398. package/dist/services/settings-service.mock.js.map +1 -0
  399. package/dist/services/singleton-deprecation.test.d.ts +2 -0
  400. package/dist/services/singleton-deprecation.test.d.ts.map +1 -0
  401. package/dist/services/singleton-deprecation.test.js +59 -0
  402. package/dist/services/singleton-deprecation.test.js.map +1 -0
  403. package/dist/services/ssh-service.d.ts +32 -0
  404. package/dist/services/ssh-service.d.ts.map +1 -0
  405. package/dist/services/ssh-service.js +119 -0
  406. package/dist/services/ssh-service.js.map +1 -0
  407. package/dist/services/ssh-service.test.d.ts +2 -0
  408. package/dist/services/ssh-service.test.d.ts.map +1 -0
  409. package/dist/services/ssh-service.test.js +269 -0
  410. package/dist/services/ssh-service.test.js.map +1 -0
  411. package/dist/test-search-tool.d.ts +2 -0
  412. package/dist/test-search-tool.d.ts.map +1 -0
  413. package/dist/test-search-tool.js +36 -0
  414. package/dist/test-search-tool.js.map +1 -0
  415. package/dist/tools/apply-patch.d.ts +28 -0
  416. package/dist/tools/apply-patch.d.ts.map +1 -0
  417. package/dist/tools/apply-patch.js +399 -0
  418. package/dist/tools/apply-patch.js.map +1 -0
  419. package/dist/tools/apply-patch.test.d.ts +2 -0
  420. package/dist/tools/apply-patch.test.d.ts.map +1 -0
  421. package/dist/tools/apply-patch.test.js +155 -0
  422. package/dist/tools/apply-patch.test.js.map +1 -0
  423. package/dist/tools/ask-mentor.d.ts +11 -0
  424. package/dist/tools/ask-mentor.d.ts.map +1 -0
  425. package/dist/tools/ask-mentor.js +52 -0
  426. package/dist/tools/ask-mentor.js.map +1 -0
  427. package/dist/tools/ask-mentor.test.d.ts +2 -0
  428. package/dist/tools/ask-mentor.test.d.ts.map +1 -0
  429. package/dist/tools/ask-mentor.test.js +47 -0
  430. package/dist/tools/ask-mentor.test.js.map +1 -0
  431. package/dist/tools/bash.d.ts +10 -0
  432. package/dist/tools/bash.d.ts.map +1 -0
  433. package/dist/tools/bash.js +55 -0
  434. package/dist/tools/bash.js.map +1 -0
  435. package/dist/tools/find-files.d.ts +15 -0
  436. package/dist/tools/find-files.d.ts.map +1 -0
  437. package/dist/tools/find-files.js +179 -0
  438. package/dist/tools/find-files.js.map +1 -0
  439. package/dist/tools/find-files.test.d.ts +2 -0
  440. package/dist/tools/find-files.test.d.ts.map +1 -0
  441. package/dist/tools/find-files.test.js +131 -0
  442. package/dist/tools/find-files.test.js.map +1 -0
  443. package/dist/tools/format-helpers.d.ts +34 -0
  444. package/dist/tools/format-helpers.d.ts.map +1 -0
  445. package/dist/tools/format-helpers.js +131 -0
  446. package/dist/tools/format-helpers.js.map +1 -0
  447. package/dist/tools/grep.d.ts +16 -0
  448. package/dist/tools/grep.d.ts.map +1 -0
  449. package/dist/tools/grep.js +211 -0
  450. package/dist/tools/grep.js.map +1 -0
  451. package/dist/tools/read-file.d.ts +15 -0
  452. package/dist/tools/read-file.d.ts.map +1 -0
  453. package/dist/tools/read-file.js +114 -0
  454. package/dist/tools/read-file.js.map +1 -0
  455. package/dist/tools/read-file.test.d.ts +2 -0
  456. package/dist/tools/read-file.test.d.ts.map +1 -0
  457. package/dist/tools/read-file.test.js +122 -0
  458. package/dist/tools/read-file.test.js.map +1 -0
  459. package/dist/tools/search-replace.d.ts +19 -0
  460. package/dist/tools/search-replace.d.ts.map +1 -0
  461. package/dist/tools/search-replace.js +411 -0
  462. package/dist/tools/search-replace.js.map +1 -0
  463. package/dist/tools/search-replace.test.d.ts +2 -0
  464. package/dist/tools/search-replace.test.d.ts.map +1 -0
  465. package/dist/tools/search-replace.test.js +302 -0
  466. package/dist/tools/search-replace.test.js.map +1 -0
  467. package/dist/tools/search.d.ts +15 -0
  468. package/dist/tools/search.d.ts.map +1 -0
  469. package/dist/tools/search.js +143 -0
  470. package/dist/tools/search.js.map +1 -0
  471. package/dist/tools/shell.d.ts +19 -0
  472. package/dist/tools/shell.d.ts.map +1 -0
  473. package/dist/tools/shell.js +278 -0
  474. package/dist/tools/shell.js.map +1 -0
  475. package/dist/tools/tool-execution-context.d.ts +7 -0
  476. package/dist/tools/tool-execution-context.d.ts.map +1 -0
  477. package/dist/tools/tool-execution-context.js +7 -0
  478. package/dist/tools/tool-execution-context.js.map +1 -0
  479. package/dist/tools/types.d.ts +30 -0
  480. package/dist/tools/types.d.ts.map +1 -0
  481. package/dist/tools/types.js +2 -0
  482. package/dist/tools/types.js.map +1 -0
  483. package/dist/tools/utils.d.ts +12 -0
  484. package/dist/tools/utils.d.ts.map +1 -0
  485. package/dist/tools/utils.js +19 -0
  486. package/dist/tools/utils.js.map +1 -0
  487. package/dist/tools/web-search.d.ts +29 -0
  488. package/dist/tools/web-search.d.ts.map +1 -0
  489. package/dist/tools/web-search.js +106 -0
  490. package/dist/tools/web-search.js.map +1 -0
  491. package/dist/tools/web-search.test.d.ts +2 -0
  492. package/dist/tools/web-search.test.d.ts.map +1 -0
  493. package/dist/tools/web-search.test.js +176 -0
  494. package/dist/tools/web-search.test.js.map +1 -0
  495. package/dist/utils/command-logger.d.ts +11 -0
  496. package/dist/utils/command-logger.d.ts.map +1 -0
  497. package/dist/utils/command-logger.js +34 -0
  498. package/dist/utils/command-logger.js.map +1 -0
  499. package/dist/utils/command-safety/constants.d.ts +21 -0
  500. package/dist/utils/command-safety/constants.d.ts.map +1 -0
  501. package/dist/utils/command-safety/constants.js +245 -0
  502. package/dist/utils/command-safety/constants.js.map +1 -0
  503. package/dist/utils/command-safety/find-helpers.d.ts +15 -0
  504. package/dist/utils/command-safety/find-helpers.d.ts.map +1 -0
  505. package/dist/utils/command-safety/find-helpers.js +218 -0
  506. package/dist/utils/command-safety/find-helpers.js.map +1 -0
  507. package/dist/utils/command-safety/handlers/find-handler.d.ts +6 -0
  508. package/dist/utils/command-safety/handlers/find-handler.d.ts.map +1 -0
  509. package/dist/utils/command-safety/handlers/find-handler.js +113 -0
  510. package/dist/utils/command-safety/handlers/find-handler.js.map +1 -0
  511. package/dist/utils/command-safety/handlers/git-handler.d.ts +6 -0
  512. package/dist/utils/command-safety/handlers/git-handler.d.ts.map +1 -0
  513. package/dist/utils/command-safety/handlers/git-handler.js +68 -0
  514. package/dist/utils/command-safety/handlers/git-handler.js.map +1 -0
  515. package/dist/utils/command-safety/handlers/index.d.ts +13 -0
  516. package/dist/utils/command-safety/handlers/index.d.ts.map +1 -0
  517. package/dist/utils/command-safety/handlers/index.js +20 -0
  518. package/dist/utils/command-safety/handlers/index.js.map +1 -0
  519. package/dist/utils/command-safety/handlers/sed-handler.d.ts +6 -0
  520. package/dist/utils/command-safety/handlers/sed-handler.d.ts.map +1 -0
  521. package/dist/utils/command-safety/handlers/sed-handler.js +94 -0
  522. package/dist/utils/command-safety/handlers/sed-handler.js.map +1 -0
  523. package/dist/utils/command-safety/handlers/types.d.ts +36 -0
  524. package/dist/utils/command-safety/handlers/types.d.ts.map +1 -0
  525. package/dist/utils/command-safety/handlers/types.js +2 -0
  526. package/dist/utils/command-safety/handlers/types.js.map +1 -0
  527. package/dist/utils/command-safety/index.d.ts +14 -0
  528. package/dist/utils/command-safety/index.d.ts.map +1 -0
  529. package/dist/utils/command-safety/index.js +183 -0
  530. package/dist/utils/command-safety/index.js.map +1 -0
  531. package/dist/utils/command-safety/path-analysis.d.ts +4 -0
  532. package/dist/utils/command-safety/path-analysis.d.ts.map +1 -0
  533. package/dist/utils/command-safety/path-analysis.js +153 -0
  534. package/dist/utils/command-safety/path-analysis.js.map +1 -0
  535. package/dist/utils/command-safety/utils.d.ts +2 -0
  536. package/dist/utils/command-safety/utils.d.ts.map +1 -0
  537. package/dist/utils/command-safety/utils.js +22 -0
  538. package/dist/utils/command-safety/utils.js.map +1 -0
  539. package/dist/utils/command-safety.d.ts +21 -0
  540. package/dist/utils/command-safety.d.ts.map +1 -0
  541. package/dist/utils/command-safety.find.test.d.ts +2 -0
  542. package/dist/utils/command-safety.find.test.d.ts.map +1 -0
  543. package/dist/utils/command-safety.find.test.js +342 -0
  544. package/dist/utils/command-safety.find.test.js.map +1 -0
  545. package/dist/utils/command-safety.js +702 -0
  546. package/dist/utils/command-safety.js.map +1 -0
  547. package/dist/utils/command-safety.path.test.d.ts +2 -0
  548. package/dist/utils/command-safety.path.test.d.ts.map +1 -0
  549. package/dist/utils/command-safety.path.test.js +360 -0
  550. package/dist/utils/command-safety.path.test.js.map +1 -0
  551. package/dist/utils/diff.d.ts +2 -0
  552. package/dist/utils/diff.d.ts.map +1 -0
  553. package/dist/utils/diff.js +44 -0
  554. package/dist/utils/diff.js.map +1 -0
  555. package/dist/utils/diff.test.d.ts +2 -0
  556. package/dist/utils/diff.test.d.ts.map +1 -0
  557. package/dist/utils/diff.test.js +85 -0
  558. package/dist/utils/diff.test.js.map +1 -0
  559. package/dist/utils/error-helpers.d.ts +6 -0
  560. package/dist/utils/error-helpers.d.ts.map +1 -0
  561. package/dist/utils/error-helpers.js +46 -0
  562. package/dist/utils/error-helpers.js.map +1 -0
  563. package/dist/utils/error-helpers.test.d.ts +2 -0
  564. package/dist/utils/error-helpers.test.d.ts.map +1 -0
  565. package/dist/utils/error-helpers.test.js +152 -0
  566. package/dist/utils/error-helpers.test.js.map +1 -0
  567. package/dist/utils/execute-shell.d.ts +15 -0
  568. package/dist/utils/execute-shell.d.ts.map +1 -0
  569. package/dist/utils/execute-shell.js +34 -0
  570. package/dist/utils/execute-shell.js.map +1 -0
  571. package/dist/utils/execute-shell.test.d.ts +2 -0
  572. package/dist/utils/execute-shell.test.d.ts.map +1 -0
  573. package/dist/utils/execute-shell.test.js +20 -0
  574. package/dist/utils/execute-shell.test.js.map +1 -0
  575. package/dist/utils/extract-command-messages.d.ts +5 -0
  576. package/dist/utils/extract-command-messages.d.ts.map +1 -0
  577. package/dist/utils/extract-command-messages.js +140 -0
  578. package/dist/utils/extract-command-messages.js.map +1 -0
  579. package/dist/utils/extract-command-messages.repro.test.d.ts +2 -0
  580. package/dist/utils/extract-command-messages.repro.test.d.ts.map +1 -0
  581. package/dist/utils/extract-command-messages.repro.test.js +31 -0
  582. package/dist/utils/extract-command-messages.repro.test.js.map +1 -0
  583. package/dist/utils/extract-command-messages.test.js +57 -0
  584. package/dist/utils/message-buffer.d.ts +2 -0
  585. package/dist/utils/message-buffer.d.ts.map +1 -0
  586. package/dist/utils/message-buffer.js +15 -0
  587. package/dist/utils/message-buffer.js.map +1 -0
  588. package/dist/utils/message-buffer.test.d.ts +2 -0
  589. package/dist/utils/message-buffer.test.d.ts.map +1 -0
  590. package/dist/utils/message-buffer.test.js +17 -0
  591. package/dist/utils/message-buffer.test.js.map +1 -0
  592. package/dist/utils/output-trim.d.ts +31 -0
  593. package/dist/utils/output-trim.d.ts.map +1 -0
  594. package/dist/utils/output-trim.js +71 -0
  595. package/dist/utils/output-trim.js.map +1 -0
  596. package/dist/utils/provider-credentials.d.ts +10 -0
  597. package/dist/utils/provider-credentials.d.ts.map +1 -0
  598. package/dist/utils/provider-credentials.js +22 -0
  599. package/dist/utils/provider-credentials.js.map +1 -0
  600. package/dist/utils/settings-command.d.ts +13 -0
  601. package/dist/utils/settings-command.d.ts.map +1 -0
  602. package/dist/utils/settings-command.js +173 -0
  603. package/dist/utils/settings-command.js.map +1 -0
  604. package/dist/utils/ssh-config-parser.d.ts +21 -0
  605. package/dist/utils/ssh-config-parser.d.ts.map +1 -0
  606. package/dist/utils/ssh-config-parser.js +89 -0
  607. package/dist/utils/ssh-config-parser.js.map +1 -0
  608. package/dist/utils/ssh-config-parser.test.d.ts +2 -0
  609. package/dist/utils/ssh-config-parser.test.d.ts.map +1 -0
  610. package/dist/utils/ssh-config-parser.test.js +153 -0
  611. package/dist/utils/ssh-config-parser.test.js.map +1 -0
  612. package/dist/utils/streaming-updater.d.ts +7 -0
  613. package/dist/utils/streaming-updater.d.ts.map +1 -0
  614. package/dist/utils/streaming-updater.js +41 -0
  615. package/dist/utils/streaming-updater.js.map +1 -0
  616. package/dist/utils/throttle.d.ts +7 -0
  617. package/dist/utils/throttle.d.ts.map +1 -0
  618. package/dist/utils/throttle.js +49 -0
  619. package/dist/utils/throttle.js.map +1 -0
  620. package/package.json +108 -0
  621. package/readme.md +428 -0
@@ -0,0 +1,278 @@
1
+ import { z } from 'zod';
2
+ import process from 'process';
3
+ import path from 'path';
4
+ import { randomUUID } from 'node:crypto';
5
+ import { relaxedNumber } from './utils.js';
6
+ import { validateCommandSafety } from '../utils/command-safety/index.js';
7
+ import { logValidationError as logValidationErrorUtil } from '../utils/command-logger.js';
8
+ import { executeShellCommand } from '../utils/execute-shell.js';
9
+ import { trimOutput, setTrimConfig, getTrimConfig, DEFAULT_TRIM_CONFIG, } from '../utils/output-trim.js';
10
+ import { coerceToText, getOutputText, normalizeToolArguments, createBaseMessage, getCallIdFromItem, } from './format-helpers.js';
11
+ const shellParametersSchema = z.object({
12
+ command: z.string().min(1).describe('Single shell command to execute.'),
13
+ timeout_ms: relaxedNumber
14
+ .int()
15
+ .positive()
16
+ .optional()
17
+ .nullable()
18
+ .describe('Optional timeout in milliseconds for each command. Defaults to 120000 ms (2 minutes) if not specified.'),
19
+ max_output_length: relaxedNumber
20
+ .int()
21
+ .positive()
22
+ .optional()
23
+ .nullable()
24
+ .describe('Optional maximum output length in characters for each command. Outputs exceeding this length will be trimmed. Defaults to 10000 characters if not specified.'),
25
+ });
26
+ // Re-export trim utilities for backwards compatibility
27
+ export { setTrimConfig, getTrimConfig, DEFAULT_TRIM_CONFIG, };
28
+ /**
29
+ * Strip redundant 'cd <path> &&' prefix if it targets the current working directory
30
+ */
31
+ function stripRedundantCd(command, cwd) {
32
+ const cdPattern = /^cd\s+([^\s&]+)\s+&&\s+(.+)$/;
33
+ const match = command.match(cdPattern);
34
+ if (match) {
35
+ const [, targetPath, restOfCommand] = match;
36
+ // Resolve the target path to absolute
37
+ const absoluteTargetPath = path.resolve(cwd, targetPath);
38
+ // If target path is same as cwd, strip the cd part
39
+ if (absoluteTargetPath === cwd) {
40
+ return restOfCommand;
41
+ }
42
+ }
43
+ return command;
44
+ }
45
+ const coerceCommandText = (value) => {
46
+ if (typeof value === 'string') {
47
+ return value;
48
+ }
49
+ if (Array.isArray(value)) {
50
+ return value
51
+ .map(part => coerceToText(part))
52
+ .filter(Boolean)
53
+ .join('\n');
54
+ }
55
+ return coerceToText(value);
56
+ };
57
+ export const formatShellCommandMessage = (item, index, toolCallArgumentsById) => {
58
+ const callId = getCallIdFromItem(item);
59
+ const fallbackArgs = callId && toolCallArgumentsById.has(callId)
60
+ ? toolCallArgumentsById.get(callId)
61
+ : null;
62
+ const normalizedArgs = item?.rawItem?.arguments ?? item?.arguments;
63
+ const args = normalizeToolArguments(normalizedArgs) ??
64
+ normalizeToolArguments(fallbackArgs) ??
65
+ {};
66
+ const command = (() => {
67
+ if (typeof args === 'string') {
68
+ return args;
69
+ }
70
+ const directCommand = coerceCommandText(args?.command);
71
+ if (directCommand) {
72
+ return directCommand;
73
+ }
74
+ const commandsValue = args?.commands;
75
+ if (typeof commandsValue === 'string') {
76
+ return commandsValue;
77
+ }
78
+ if (Array.isArray(commandsValue)) {
79
+ const commands = commandsValue
80
+ .map(entry => typeof entry === 'string'
81
+ ? entry
82
+ : entry &&
83
+ typeof entry === 'object' &&
84
+ 'command' in entry
85
+ ? coerceCommandText(entry.command)
86
+ : coerceCommandText(entry))
87
+ .filter(Boolean)
88
+ .join('\n');
89
+ if (commands) {
90
+ return commands;
91
+ }
92
+ }
93
+ return 'Unknown command';
94
+ })();
95
+ const outputText = getOutputText(item);
96
+ // Check if this is an error message (doesn't start with expected status formats)
97
+ const firstLine = outputText.split('\n')[0]?.trim() || '';
98
+ const isErrorMessage = firstLine.includes('error') ||
99
+ firstLine.includes('Error') ||
100
+ firstLine.includes('failed') ||
101
+ firstLine.includes('Failed') ||
102
+ (!firstLine.startsWith('exit ') &&
103
+ firstLine !== 'timeout' &&
104
+ outputText &&
105
+ !outputText.includes('\n'));
106
+ let output;
107
+ let success;
108
+ let failureReason;
109
+ if (isErrorMessage &&
110
+ !firstLine.startsWith('exit ') &&
111
+ firstLine !== 'timeout') {
112
+ // For error messages, use the entire output
113
+ output = outputText || 'No output';
114
+ success = false;
115
+ failureReason = 'error';
116
+ }
117
+ else {
118
+ // For normal shell output, parse status line and body
119
+ const [statusLineRaw, ...bodyLines] = outputText.split('\n');
120
+ const statusLine = (statusLineRaw ?? '').trim();
121
+ const bodyText = bodyLines.join('\n').trim();
122
+ output = bodyText || 'No output';
123
+ if (statusLine === 'timeout') {
124
+ success = false;
125
+ failureReason = 'timeout';
126
+ }
127
+ else if (statusLine.startsWith('exit ')) {
128
+ const parsedExitCode = Number(statusLine.slice(5).trim());
129
+ success = Number.isFinite(parsedExitCode)
130
+ ? parsedExitCode === 0
131
+ : undefined;
132
+ }
133
+ }
134
+ return [
135
+ createBaseMessage(item, index, 0, false, {
136
+ command,
137
+ output,
138
+ success,
139
+ failureReason,
140
+ }),
141
+ ];
142
+ };
143
+ export function createShellToolDefinition(deps) {
144
+ const { loggingService, settingsService, executionContext } = deps;
145
+ // Create command logger function with dependencies
146
+ const logValidationError = (message) => logValidationErrorUtil(settingsService, message);
147
+ return {
148
+ name: 'shell',
149
+ description: 'Execute a single shell command. Use this to run a terminal command. Assert the safety of the command; if it does not change system state or read sensitive data, set needsApproval to false. Otherwise set needsApproval to true and wait for user approval before executing.',
150
+ parameters: shellParametersSchema,
151
+ needsApproval: async (params) => {
152
+ try {
153
+ const cwd = executionContext?.getCwd() || process.cwd();
154
+ const optimizedCommand = stripRedundantCd(params.command, cwd);
155
+ const isDangerous = validateCommandSafety(optimizedCommand, loggingService);
156
+ // Log security event for all shell commands with dangerous flag
157
+ loggingService.security('Shell tool needsApproval check', {
158
+ commands: [params.command.substring(0, 100)], // Truncate for safety
159
+ optimizedCommand: optimizedCommand.substring(0, 100),
160
+ isDangerous,
161
+ });
162
+ return isDangerous;
163
+ }
164
+ catch (error) {
165
+ const errorMessage = error instanceof Error ? error.message : String(error);
166
+ logValidationError(`Validation failed: ${errorMessage}`);
167
+ loggingService.error('Shell tool validation error', {
168
+ error: errorMessage,
169
+ commands: [params.command.substring(0, 100)],
170
+ });
171
+ return true; // fail-safe: require approval on validation errors
172
+ }
173
+ },
174
+ execute: async ({ command, timeout_ms, max_output_length }) => {
175
+ const cwd = executionContext?.getCwd() || process.cwd();
176
+ const sshService = executionContext?.getSSHService();
177
+ const correlationId = randomUUID();
178
+ // Set correlation ID for tracking related operations
179
+ loggingService.setCorrelationId(correlationId);
180
+ try {
181
+ // Use provided values or settings defaults or hardcoded defaults
182
+ const timeoutValue = timeout_ms ?? settingsService.get('shell.timeout');
183
+ const timeout = timeoutValue != null ? timeoutValue : undefined;
184
+ const maxOutputLengthValue = max_output_length ??
185
+ settingsService.get('shell.maxOutputChars');
186
+ const maxOutputLength = maxOutputLengthValue != null
187
+ ? maxOutputLengthValue
188
+ : undefined;
189
+ loggingService.info('Shell command execution started', {
190
+ commandCount: 1,
191
+ commands: [command],
192
+ timeout,
193
+ workingDirectory: cwd,
194
+ maxOutputLength,
195
+ });
196
+ // Strip redundant 'cd <path> &&' if it targets the current directory
197
+ const optimizedCommand = stripRedundantCd(command, cwd);
198
+ if (optimizedCommand !== command) {
199
+ loggingService.debug('Stripped redundant cd command', {
200
+ original: command,
201
+ optimized: optimizedCommand,
202
+ cwd,
203
+ });
204
+ }
205
+ const result = await executeShellCommand(optimizedCommand, {
206
+ cwd,
207
+ timeout,
208
+ maxBuffer: 1024 * 1024, // 1MB max buffer
209
+ sshService,
210
+ });
211
+ const stdout = result.stdout ?? '';
212
+ const stderr = result.stderr ?? '';
213
+ const exitCode = result.exitCode ?? null;
214
+ const outcome = result.timedOut
215
+ ? { type: 'timeout' }
216
+ : { type: 'exit', exitCode };
217
+ if (result.timedOut) {
218
+ loggingService.warn('Shell command timeout', {
219
+ command: optimizedCommand.substring(0, 100),
220
+ timeout,
221
+ });
222
+ }
223
+ else if (exitCode === 0) {
224
+ loggingService.debug('Shell command executed successfully', {
225
+ command: optimizedCommand.substring(0, 100),
226
+ exitCode: 0,
227
+ stdoutLength: stdout.length,
228
+ stderrLength: stderr.length,
229
+ });
230
+ }
231
+ else {
232
+ loggingService.debug('Shell command execution failed', {
233
+ command: optimizedCommand.substring(0, 100),
234
+ exitCode,
235
+ stderrLength: stderr.length,
236
+ });
237
+ }
238
+ loggingService.info('Shell command execution completed', {
239
+ commandCount: 1,
240
+ successCount: outcome.type === 'exit' && outcome.exitCode === 0
241
+ ? 1
242
+ : 0,
243
+ failureCount: outcome.type === 'exit' && outcome.exitCode !== 0
244
+ ? 1
245
+ : 0,
246
+ timeoutCount: outcome.type === 'timeout' ? 1 : 0,
247
+ });
248
+ const stdoutTrimmed = trimOutput(stdout, undefined, maxOutputLength).trimEnd();
249
+ const stderrTrimmed = trimOutput(stderr, undefined, maxOutputLength).trimEnd();
250
+ const combinedOutput = [stdoutTrimmed, stderrTrimmed]
251
+ .filter(Boolean)
252
+ .join('\n')
253
+ .trimEnd();
254
+ const statusLine = outcome.type === 'timeout'
255
+ ? 'timeout'
256
+ : `exit ${outcome.exitCode ?? 'null'}`;
257
+ const noteLine = optimizedCommand !== command
258
+ ? 'note: stripped redundant cd prefix'
259
+ : '';
260
+ // Add helpful note when command succeeds with no output
261
+ const emptyOutputNote = combinedOutput === '' &&
262
+ outcome.type === 'exit' &&
263
+ outcome.exitCode === 0
264
+ ? 'note: command succeeded with no output'
265
+ : '';
266
+ return [statusLine, combinedOutput, noteLine, emptyOutputNote]
267
+ .filter(Boolean)
268
+ .join('\n');
269
+ }
270
+ finally {
271
+ // Always clear correlation ID
272
+ loggingService.clearCorrelationId();
273
+ }
274
+ },
275
+ formatCommandMessage: formatShellCommandMessage,
276
+ };
277
+ }
278
+ //# sourceMappingURL=shell.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"shell.js","sourceRoot":"","sources":["../../source/tools/shell.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,7 @@
1
+ export {};
2
+ /**
3
+ * This file has been deprecated.
4
+ * The fake execution workaround has been replaced with an instance-based interceptor pattern.
5
+ * See OpenAIAgentClient.addToolInterceptor() and clearToolInterceptors().
6
+ */
7
+ //# sourceMappingURL=tool-execution-context.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tool-execution-context.d.ts","sourceRoot":"","sources":["../../source/tools/tool-execution-context.ts"],"names":[],"mappings":";AAAA;;;;GAIG"}
@@ -0,0 +1,7 @@
1
+ export {};
2
+ /**
3
+ * This file has been deprecated.
4
+ * The fake execution workaround has been replaced with an instance-based interceptor pattern.
5
+ * See OpenAIAgentClient.addToolInterceptor() and clearToolInterceptors().
6
+ */
7
+ //# sourceMappingURL=tool-execution-context.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tool-execution-context.js","sourceRoot":"","sources":["../../source/tools/tool-execution-context.ts"],"names":[],"mappings":";AAAA;;;;GAIG"}
@@ -0,0 +1,30 @@
1
+ import type { ZodTypeAny } from 'zod';
2
+ export interface CommandMessage {
3
+ id: string;
4
+ sender: 'command';
5
+ status: 'pending' | 'running' | 'completed' | 'failed';
6
+ command: string;
7
+ output: string;
8
+ success?: boolean;
9
+ failureReason?: string;
10
+ isApprovalRejection?: boolean;
11
+ toolName?: string;
12
+ toolArgs?: any;
13
+ callId?: string;
14
+ }
15
+ export interface ToolDefinition<Params = any> {
16
+ name: string;
17
+ description: string;
18
+ parameters: ZodTypeAny;
19
+ needsApproval: (params: Params, context?: unknown) => Promise<boolean> | boolean;
20
+ execute: (params: Params, context?: unknown) => Promise<any> | any;
21
+ /**
22
+ * Formats tool execution results into command messages for display.
23
+ * @param item - The raw tool execution item from the conversation
24
+ * @param index - The index of this item in the items array
25
+ * @param toolCallArgumentsById - Map of call IDs to their arguments for fallback lookup
26
+ * @returns Array of CommandMessage objects to display to the user
27
+ */
28
+ formatCommandMessage: (item: any, index: number, toolCallArgumentsById: Map<string, unknown>) => CommandMessage[];
29
+ }
30
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../source/tools/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,KAAK,CAAC;AAEpC,MAAM,WAAW,cAAc;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,GAAG,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc,CAAC,MAAM,GAAG,GAAG;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,UAAU,CAAC;IACvB,aAAa,EAAE,CACX,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,OAAO,KAChB,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IAChC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IACnE;;;;;;OAMG;IACH,oBAAoB,EAAE,CAClB,IAAI,EAAE,GAAG,EACT,KAAK,EAAE,MAAM,EACb,qBAAqB,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,KAC1C,cAAc,EAAE,CAAC;CACzB"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../source/tools/types.ts"],"names":[],"mappings":""}
@@ -0,0 +1,12 @@
1
+ import { z } from 'zod';
2
+ /**
3
+ * Resolves a relative path and ensures it's within the workspace
4
+ */
5
+ export declare function resolveWorkspacePath(relativePath: string, baseDir?: string): string;
6
+ /**
7
+ * A Zod schema that allows either a number or a string that can be parsed as a number.
8
+ * Useful for tool parameters that might be passed as strings from the LLM.
9
+ * Use with .int(), .positive(), etc. to add further constraints.
10
+ */
11
+ export declare const relaxedNumber: z.ZodCoercedNumber<unknown>;
12
+ //# sourceMappingURL=utils.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../source/tools/utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAEtB;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,GAAE,MAAsB,GAAG,MAAM,CAQlG;AAED;;;;GAIG;AACH,eAAO,MAAM,aAAa,6BAAoB,CAAC"}
@@ -0,0 +1,19 @@
1
+ import path from 'path';
2
+ import { z } from 'zod';
3
+ /**
4
+ * Resolves a relative path and ensures it's within the workspace
5
+ */
6
+ export function resolveWorkspacePath(relativePath, baseDir = process.cwd()) {
7
+ const resolved = path.resolve(baseDir, relativePath);
8
+ if (!resolved.startsWith(baseDir)) {
9
+ throw new Error(`Operation outside workspace: ${relativePath}`);
10
+ }
11
+ return resolved;
12
+ }
13
+ /**
14
+ * A Zod schema that allows either a number or a string that can be parsed as a number.
15
+ * Useful for tool parameters that might be passed as strings from the LLM.
16
+ * Use with .int(), .positive(), etc. to add further constraints.
17
+ */
18
+ export const relaxedNumber = z.coerce.number();
19
+ //# sourceMappingURL=utils.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"utils.js","sourceRoot":"","sources":["../../source/tools/utils.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAEtB;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,YAAoB,EAAE,UAAkB,OAAO,CAAC,GAAG,EAAE;IACtF,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAErD,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,gCAAgC,YAAY,EAAE,CAAC,CAAC;IACpE,CAAC;IAED,OAAO,QAAQ,CAAC;AACpB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC"}
@@ -0,0 +1,29 @@
1
+ /**
2
+ * Web search tool for the terminal assistant.
3
+ * Uses pluggable web search providers (default: Tavily) to fetch current information from the web.
4
+ */
5
+ import { z } from 'zod';
6
+ import type { ToolDefinition, CommandMessage } from './types.js';
7
+ import { type WebSearchResponse } from '../providers/web-search/index.js';
8
+ import type { ISettingsService, ILoggingService } from '../services/service-interfaces.js';
9
+ declare const webSearchSchema: z.ZodObject<{
10
+ query: z.ZodString;
11
+ }, z.core.$strip>;
12
+ export type WebSearchParams = z.infer<typeof webSearchSchema>;
13
+ /**
14
+ * Convert web search results to a markdown-formatted string
15
+ */
16
+ export declare function formatResultsAsMarkdown(response: WebSearchResponse): string;
17
+ /**
18
+ * Format command message for display in the terminal
19
+ */
20
+ export declare const formatWebSearchCommandMessage: (item: any, index: number, toolCallArgumentsById: Map<string, unknown>) => CommandMessage[];
21
+ /**
22
+ * Factory function to create the web_search tool definition
23
+ */
24
+ export declare const createWebSearchToolDefinition: (deps: {
25
+ settingsService: ISettingsService;
26
+ loggingService: ILoggingService;
27
+ }) => ToolDefinition<WebSearchParams>;
28
+ export {};
29
+ //# sourceMappingURL=web-search.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"web-search.d.ts","sourceRoot":"","sources":["../../source/tools/web-search.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAOjE,OAAO,EAEH,KAAK,iBAAiB,EACzB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EACR,gBAAgB,EAChB,eAAe,EAClB,MAAM,mCAAmC,CAAC;AAE3C,QAAA,MAAM,eAAe;;iBAEnB,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,CA4B3E;AAED;;GAEG;AACH,eAAO,MAAM,6BAA6B,GACtC,MAAM,GAAG,EACT,OAAO,MAAM,EACb,uBAAuB,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,KAC5C,cAAc,EA0BhB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,6BAA6B,GAAI,MAAM;IAChD,eAAe,EAAE,gBAAgB,CAAC;IAClC,cAAc,EAAE,eAAe,CAAC;CACnC,KAAG,cAAc,CAAC,eAAe,CA0CjC,CAAC"}
@@ -0,0 +1,106 @@
1
+ /**
2
+ * Web search tool for the terminal assistant.
3
+ * Uses pluggable web search providers (default: Tavily) to fetch current information from the web.
4
+ */
5
+ import { z } from 'zod';
6
+ import { getOutputText, normalizeToolArguments, createBaseMessage, getCallIdFromItem, } from './format-helpers.js';
7
+ import { getConfiguredWebSearchProvider, } from '../providers/web-search/index.js';
8
+ const webSearchSchema = z.object({
9
+ query: z.string().min(1).describe('The search query to look up on the web.'),
10
+ });
11
+ /**
12
+ * Convert web search results to a markdown-formatted string
13
+ */
14
+ export function formatResultsAsMarkdown(response) {
15
+ const parts = [];
16
+ // Add answer box if available (Tavily's synthesized answer)
17
+ if (response.answerBox) {
18
+ parts.push('## Answer\n');
19
+ parts.push(response.answerBox);
20
+ parts.push('\n');
21
+ }
22
+ // Add search results
23
+ if (response.results.length > 0) {
24
+ parts.push('## Search Results\n');
25
+ response.results.forEach((result, index) => {
26
+ parts.push(`### ${index + 1}. ${result.title}\n`);
27
+ parts.push(`**URL:** ${result.url}\n`);
28
+ if (result.publishedDate) {
29
+ parts.push(`**Published:** ${result.publishedDate}\n`);
30
+ }
31
+ parts.push(`\n${result.content}\n`);
32
+ parts.push('\n---\n');
33
+ });
34
+ }
35
+ else {
36
+ parts.push('No results found for this query.\n');
37
+ }
38
+ return parts.join('\n');
39
+ }
40
+ /**
41
+ * Format command message for display in the terminal
42
+ */
43
+ export const formatWebSearchCommandMessage = (item, index, toolCallArgumentsById) => {
44
+ const callId = getCallIdFromItem(item);
45
+ const fallbackArgs = callId && toolCallArgumentsById.has(callId)
46
+ ? toolCallArgumentsById.get(callId)
47
+ : null;
48
+ const normalizedArgs = item?.rawItem?.arguments ?? item?.arguments;
49
+ const args = normalizeToolArguments(normalizedArgs) ??
50
+ normalizeToolArguments(fallbackArgs) ??
51
+ {};
52
+ const query = args?.query ?? 'unknown query';
53
+ const command = `web_search: "${query}"`;
54
+ const output = getOutputText(item) || 'No results';
55
+ const success = !output.startsWith('Error:');
56
+ return [
57
+ createBaseMessage(item, index, 0, false, {
58
+ command,
59
+ output,
60
+ success,
61
+ toolName: 'web_search',
62
+ toolArgs: args,
63
+ }),
64
+ ];
65
+ };
66
+ /**
67
+ * Factory function to create the web_search tool definition
68
+ */
69
+ export const createWebSearchToolDefinition = (deps) => {
70
+ const { settingsService, loggingService } = deps;
71
+ return {
72
+ name: 'web_search',
73
+ description: 'Search the web for current information. Use this when you need up-to-date information ' +
74
+ 'that may not be in your training data, such as recent news, current events, ' +
75
+ 'documentation updates, or any time-sensitive information.',
76
+ parameters: webSearchSchema,
77
+ needsApproval: () => false, // Web search is read-only, safe operation
78
+ execute: async (params) => {
79
+ const { query } = params;
80
+ try {
81
+ const provider = getConfiguredWebSearchProvider({ settingsService });
82
+ if (!provider) {
83
+ return 'Error: No web search provider is configured.';
84
+ }
85
+ if (!provider.isConfigured({ settingsService })) {
86
+ return `Error: Web search provider '${provider.id}' is not properly configured. ` +
87
+ `Please set the required API key (e.g., TAVILY_API_KEY environment variable).`;
88
+ }
89
+ const response = await provider.search(query, {
90
+ settingsService,
91
+ loggingService,
92
+ });
93
+ return formatResultsAsMarkdown(response);
94
+ }
95
+ catch (error) {
96
+ loggingService.error('Web search failed', {
97
+ query,
98
+ error: error.message || String(error),
99
+ });
100
+ return `Error: ${error.message || String(error)}`;
101
+ }
102
+ },
103
+ formatCommandMessage: formatWebSearchCommandMessage,
104
+ };
105
+ };
106
+ //# sourceMappingURL=web-search.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"web-search.js","sourceRoot":"","sources":["../../source/tools/web-search.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=web-search.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"web-search.test.d.ts","sourceRoot":"","sources":["../../source/tools/web-search.test.ts"],"names":[],"mappings":""}