@office-ai/aioncli-core 0.26.0 → 0.30.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 (1152) hide show
  1. package/dist/docs/CONTRIBUTING.md +19 -10
  2. package/dist/docs/admin/enterprise-controls.md +115 -0
  3. package/dist/docs/architecture.md +3 -3
  4. package/dist/docs/assets/monitoring-dashboard-logs.png +0 -0
  5. package/dist/docs/assets/monitoring-dashboard-metrics.png +0 -0
  6. package/dist/docs/assets/monitoring-dashboard-overview.png +0 -0
  7. package/dist/docs/bedrock-integration-plan.md +595 -0
  8. package/dist/docs/changelogs/index.md +187 -0
  9. package/dist/docs/changelogs/latest.md +299 -209
  10. package/dist/docs/changelogs/preview.md +353 -115
  11. package/dist/docs/cli/checkpointing.md +2 -3
  12. package/dist/docs/cli/cli-reference.md +115 -0
  13. package/dist/docs/cli/commands.md +360 -247
  14. package/dist/docs/cli/creating-skills.md +80 -0
  15. package/dist/docs/cli/custom-commands.md +12 -9
  16. package/dist/docs/cli/enterprise.md +25 -5
  17. package/dist/docs/cli/gemini-md.md +20 -12
  18. package/dist/docs/cli/headless.md +34 -372
  19. package/dist/docs/cli/index.md +123 -63
  20. package/dist/docs/cli/keyboard-shortcuts.md +95 -84
  21. package/dist/docs/cli/model-routing.md +7 -2
  22. package/dist/docs/cli/model.md +1 -1
  23. package/dist/docs/cli/plan-mode.md +190 -0
  24. package/dist/docs/cli/rewind.md +51 -0
  25. package/dist/docs/cli/sandbox.md +4 -3
  26. package/dist/docs/cli/session-management.md +61 -44
  27. package/dist/docs/cli/settings.md +95 -61
  28. package/dist/docs/cli/skills.md +49 -71
  29. package/dist/docs/cli/system-prompt.md +32 -0
  30. package/dist/docs/cli/telemetry.md +75 -4
  31. package/dist/docs/cli/themes.md +85 -53
  32. package/dist/docs/cli/tutorials/automation.md +187 -0
  33. package/dist/docs/cli/tutorials/file-management.md +142 -0
  34. package/dist/docs/cli/tutorials/mcp-setup.md +105 -0
  35. package/dist/docs/cli/tutorials/memory-management.md +126 -0
  36. package/dist/docs/cli/tutorials/session-management.md +105 -0
  37. package/dist/docs/cli/tutorials/shell-commands.md +107 -0
  38. package/dist/docs/cli/tutorials/skills-getting-started.md +36 -58
  39. package/dist/docs/cli/tutorials/task-planning.md +93 -0
  40. package/dist/docs/cli/tutorials/web-tools.md +78 -0
  41. package/dist/docs/cli/uninstall.md +18 -0
  42. package/dist/docs/core/concepts.md +137 -0
  43. package/dist/docs/core/index.md +6 -0
  44. package/dist/docs/core/memport.md +2 -0
  45. package/dist/docs/core/policy-engine.md +57 -7
  46. package/dist/docs/core/remote-agents.md +84 -0
  47. package/dist/docs/core/subagents.md +191 -0
  48. package/dist/docs/extensions/best-practices.md +188 -0
  49. package/dist/docs/extensions/index.md +38 -270
  50. package/dist/docs/extensions/reference.md +265 -0
  51. package/dist/docs/extensions/releasing.md +154 -0
  52. package/dist/docs/extensions/writing-extensions.md +292 -0
  53. package/dist/docs/get-started/authentication.md +162 -0
  54. package/dist/docs/get-started/configuration-v1.md +5 -11
  55. package/dist/docs/get-started/configuration.md +228 -99
  56. package/dist/docs/get-started/examples.md +39 -119
  57. package/dist/docs/get-started/gemini-3.md +2 -17
  58. package/dist/docs/get-started/index.md +6 -4
  59. package/dist/docs/get-started/installation.md +110 -77
  60. package/dist/docs/hooks/best-practices.md +219 -398
  61. package/dist/docs/hooks/index.md +99 -622
  62. package/dist/docs/hooks/reference.md +269 -115
  63. package/dist/docs/hooks/writing-hooks.md +203 -779
  64. package/dist/docs/index.md +146 -147
  65. package/dist/docs/local-development.md +1 -1
  66. package/dist/docs/releases.md +3 -3
  67. package/dist/docs/sidebar.json +105 -217
  68. package/dist/docs/tools/activate-skill.md +43 -0
  69. package/dist/docs/tools/ask-user.md +95 -0
  70. package/dist/docs/tools/file-system.md +48 -139
  71. package/dist/docs/tools/index.md +92 -85
  72. package/dist/docs/tools/internal-docs.md +46 -0
  73. package/dist/docs/tools/mcp-server.md +29 -5
  74. package/dist/docs/tools/memory.md +21 -40
  75. package/dist/docs/tools/planning.md +55 -0
  76. package/dist/docs/tools/shell.md +45 -89
  77. package/dist/docs/tools/todos.md +22 -44
  78. package/dist/docs/tools/web-fetch.md +22 -46
  79. package/dist/docs/tools/web-search.md +19 -29
  80. package/dist/docs/tos-privacy.md +1 -1
  81. package/dist/docs/troubleshooting.md +20 -5
  82. package/dist/index.d.ts +2 -1
  83. package/dist/index.js +2 -1
  84. package/dist/index.js.map +1 -1
  85. package/dist/src/agents/a2a-client-manager.d.ts +4 -5
  86. package/dist/src/agents/a2a-client-manager.js +9 -131
  87. package/dist/src/agents/a2a-client-manager.js.map +1 -1
  88. package/dist/src/agents/a2a-client-manager.test.js +10 -27
  89. package/dist/src/agents/a2a-client-manager.test.js.map +1 -1
  90. package/dist/src/agents/a2aUtils.d.ts +3 -2
  91. package/dist/src/agents/a2aUtils.js +28 -26
  92. package/dist/src/agents/a2aUtils.js.map +1 -1
  93. package/dist/src/agents/a2aUtils.test.js +9 -9
  94. package/dist/src/agents/a2aUtils.test.js.map +1 -1
  95. package/dist/src/agents/acknowledgedAgents.d.ts +18 -0
  96. package/dist/src/agents/acknowledgedAgents.js +58 -0
  97. package/dist/src/agents/acknowledgedAgents.js.map +1 -0
  98. package/dist/src/agents/acknowledgedAgents.test.d.ts +6 -0
  99. package/dist/src/agents/acknowledgedAgents.test.js +70 -0
  100. package/dist/src/agents/acknowledgedAgents.test.js.map +1 -0
  101. package/dist/src/agents/agent-scheduler.d.ts +35 -0
  102. package/dist/src/agents/agent-scheduler.js +30 -0
  103. package/dist/src/agents/agent-scheduler.js.map +1 -0
  104. package/dist/src/agents/agent-scheduler.test.d.ts +6 -0
  105. package/dist/src/agents/agent-scheduler.test.js +56 -0
  106. package/dist/src/agents/agent-scheduler.test.js.map +1 -0
  107. package/dist/src/agents/agentLoader.d.ts +88 -0
  108. package/dist/src/agents/agentLoader.js +394 -0
  109. package/dist/src/agents/agentLoader.js.map +1 -0
  110. package/dist/src/agents/agentLoader.test.d.ts +6 -0
  111. package/dist/src/agents/agentLoader.test.js +458 -0
  112. package/dist/src/agents/agentLoader.test.js.map +1 -0
  113. package/dist/src/agents/auth-provider/base-provider.d.ts +40 -0
  114. package/dist/src/agents/auth-provider/base-provider.js +43 -0
  115. package/dist/src/agents/auth-provider/base-provider.js.map +1 -0
  116. package/dist/src/agents/auth-provider/base-provider.test.d.ts +6 -0
  117. package/dist/src/agents/auth-provider/base-provider.test.js +107 -0
  118. package/dist/src/agents/auth-provider/base-provider.test.js.map +1 -0
  119. package/dist/src/agents/auth-provider/factory.d.ts +27 -0
  120. package/dist/src/agents/auth-provider/factory.js +161 -0
  121. package/dist/src/agents/auth-provider/factory.js.map +1 -0
  122. package/dist/src/agents/auth-provider/factory.test.d.ts +6 -0
  123. package/dist/src/agents/auth-provider/factory.test.js +344 -0
  124. package/dist/src/agents/auth-provider/factory.test.js.map +1 -0
  125. package/dist/src/agents/auth-provider/types.d.ts +74 -0
  126. package/dist/src/agents/auth-provider/types.js +7 -0
  127. package/dist/src/agents/auth-provider/types.js.map +1 -0
  128. package/dist/src/agents/auth-provider/value-resolver.d.ts +29 -0
  129. package/dist/src/agents/auth-provider/value-resolver.js +85 -0
  130. package/dist/src/agents/auth-provider/value-resolver.js.map +1 -0
  131. package/dist/src/agents/auth-provider/value-resolver.test.d.ts +6 -0
  132. package/dist/src/agents/auth-provider/value-resolver.test.js +100 -0
  133. package/dist/src/agents/auth-provider/value-resolver.test.js.map +1 -0
  134. package/dist/src/agents/cli-help-agent.d.ts +24 -0
  135. package/dist/src/agents/cli-help-agent.js +80 -0
  136. package/dist/src/agents/cli-help-agent.js.map +1 -0
  137. package/dist/src/agents/cli-help-agent.test.d.ts +6 -0
  138. package/dist/src/agents/cli-help-agent.test.js +53 -0
  139. package/dist/src/agents/cli-help-agent.test.js.map +1 -0
  140. package/dist/src/agents/codebase-investigator.d.ts +2 -1
  141. package/dist/src/agents/codebase-investigator.js +68 -39
  142. package/dist/src/agents/codebase-investigator.js.map +1 -1
  143. package/dist/src/agents/codebase-investigator.test.js +37 -9
  144. package/dist/src/agents/codebase-investigator.test.js.map +1 -1
  145. package/dist/src/agents/generalist-agent.d.ts +21 -0
  146. package/dist/src/agents/generalist-agent.js +60 -0
  147. package/dist/src/agents/generalist-agent.js.map +1 -0
  148. package/dist/src/agents/generalist-agent.test.d.ts +6 -0
  149. package/dist/src/agents/generalist-agent.test.js +32 -0
  150. package/dist/src/agents/generalist-agent.test.js.map +1 -0
  151. package/dist/src/agents/introspection-agent.d.ts +2 -2
  152. package/dist/src/agents/local-executor.d.ts +2 -0
  153. package/dist/src/agents/local-executor.js +186 -90
  154. package/dist/src/agents/local-executor.js.map +1 -1
  155. package/dist/src/agents/local-executor.test.js +431 -256
  156. package/dist/src/agents/local-executor.test.js.map +1 -1
  157. package/dist/src/agents/local-invocation.test.js +15 -5
  158. package/dist/src/agents/local-invocation.test.js.map +1 -1
  159. package/dist/src/agents/registry.d.ts +24 -8
  160. package/dist/src/agents/registry.js +193 -96
  161. package/dist/src/agents/registry.js.map +1 -1
  162. package/dist/src/agents/registry.test.js +509 -58
  163. package/dist/src/agents/registry.test.js.map +1 -1
  164. package/dist/src/agents/registry_acknowledgement.test.d.ts +6 -0
  165. package/dist/src/agents/registry_acknowledgement.test.js +130 -0
  166. package/dist/src/agents/registry_acknowledgement.test.js.map +1 -0
  167. package/dist/src/agents/remote-invocation.js +12 -14
  168. package/dist/src/agents/remote-invocation.js.map +1 -1
  169. package/dist/src/agents/remote-invocation.test.js +16 -4
  170. package/dist/src/agents/remote-invocation.test.js.map +1 -1
  171. package/dist/src/agents/subagent-tool-wrapper.js +1 -3
  172. package/dist/src/agents/subagent-tool-wrapper.js.map +1 -1
  173. package/dist/src/agents/subagent-tool-wrapper.test.js +18 -27
  174. package/dist/src/agents/subagent-tool-wrapper.test.js.map +1 -1
  175. package/dist/src/agents/subagent-tool.d.ts +15 -0
  176. package/dist/src/agents/subagent-tool.js +57 -0
  177. package/dist/src/agents/subagent-tool.js.map +1 -0
  178. package/dist/src/agents/subagent-tool.test.d.ts +6 -0
  179. package/dist/src/agents/subagent-tool.test.js +97 -0
  180. package/dist/src/agents/subagent-tool.test.js.map +1 -0
  181. package/dist/src/agents/types.d.ts +37 -22
  182. package/dist/src/agents/types.js +12 -0
  183. package/dist/src/agents/types.js.map +1 -1
  184. package/dist/src/availability/fallbackIntegration.test.d.ts +6 -0
  185. package/dist/src/availability/fallbackIntegration.test.js +57 -0
  186. package/dist/src/availability/fallbackIntegration.test.js.map +1 -0
  187. package/dist/src/availability/policyCatalog.d.ts +3 -0
  188. package/dist/src/availability/policyCatalog.js +29 -5
  189. package/dist/src/availability/policyCatalog.js.map +1 -1
  190. package/dist/src/availability/policyCatalog.test.js +20 -1
  191. package/dist/src/availability/policyCatalog.test.js.map +1 -1
  192. package/dist/src/availability/policyHelpers.js +40 -11
  193. package/dist/src/availability/policyHelpers.js.map +1 -1
  194. package/dist/src/availability/policyHelpers.test.js +72 -2
  195. package/dist/src/availability/policyHelpers.test.js.map +1 -1
  196. package/dist/src/availability/testUtils.js +1 -0
  197. package/dist/src/availability/testUtils.js.map +1 -1
  198. package/dist/src/code_assist/admin/admin_controls.d.ts +49 -0
  199. package/dist/src/code_assist/admin/admin_controls.js +197 -0
  200. package/dist/src/code_assist/admin/admin_controls.js.map +1 -0
  201. package/dist/src/code_assist/admin/admin_controls.test.d.ts +6 -0
  202. package/dist/src/code_assist/admin/admin_controls.test.js +589 -0
  203. package/dist/src/code_assist/admin/admin_controls.test.js.map +1 -0
  204. package/dist/src/code_assist/admin/mcpUtils.d.ts +22 -0
  205. package/dist/src/code_assist/admin/mcpUtils.js +53 -0
  206. package/dist/src/code_assist/admin/mcpUtils.js.map +1 -0
  207. package/dist/src/code_assist/admin/mcpUtils.test.d.ts +6 -0
  208. package/dist/src/code_assist/admin/mcpUtils.test.js +101 -0
  209. package/dist/src/code_assist/admin/mcpUtils.test.js.map +1 -0
  210. package/dist/src/code_assist/codeAssist.js +2 -2
  211. package/dist/src/code_assist/codeAssist.js.map +1 -1
  212. package/dist/src/code_assist/codeAssist.test.d.ts +1 -1
  213. package/dist/src/code_assist/codeAssist.test.js +10 -6
  214. package/dist/src/code_assist/codeAssist.test.js.map +1 -1
  215. package/dist/src/code_assist/converter.js +8 -3
  216. package/dist/src/code_assist/converter.js.map +1 -1
  217. package/dist/src/code_assist/converter.test.js +8 -0
  218. package/dist/src/code_assist/converter.test.js.map +1 -1
  219. package/dist/src/code_assist/experiments/experiments.d.ts +1 -1
  220. package/dist/src/code_assist/experiments/experiments.js +22 -0
  221. package/dist/src/code_assist/experiments/experiments.js.map +1 -1
  222. package/dist/src/code_assist/experiments/experiments.test.js +1 -0
  223. package/dist/src/code_assist/experiments/experiments.test.js.map +1 -1
  224. package/dist/src/code_assist/experiments/experiments_local.test.d.ts +6 -0
  225. package/dist/src/code_assist/experiments/experiments_local.test.js +115 -0
  226. package/dist/src/code_assist/experiments/experiments_local.test.js.map +1 -0
  227. package/dist/src/code_assist/experiments/flagNames.d.ts +7 -0
  228. package/dist/src/code_assist/experiments/flagNames.js +7 -0
  229. package/dist/src/code_assist/experiments/flagNames.js.map +1 -1
  230. package/dist/src/code_assist/oauth-credential-storage.js +4 -4
  231. package/dist/src/code_assist/oauth-credential-storage.js.map +1 -1
  232. package/dist/src/code_assist/oauth2.test.js +10 -3
  233. package/dist/src/code_assist/oauth2.test.js.map +1 -1
  234. package/dist/src/code_assist/server.d.ts +7 -4
  235. package/dist/src/code_assist/server.js +20 -4
  236. package/dist/src/code_assist/server.js.map +1 -1
  237. package/dist/src/code_assist/server.test.js +18 -5
  238. package/dist/src/code_assist/server.test.js.map +1 -1
  239. package/dist/src/code_assist/setup.d.ts +35 -3
  240. package/dist/src/code_assist/setup.js +98 -16
  241. package/dist/src/code_assist/setup.js.map +1 -1
  242. package/dist/src/code_assist/setup.test.js +322 -5
  243. package/dist/src/code_assist/setup.test.js.map +1 -1
  244. package/dist/src/code_assist/telemetry.js +2 -1
  245. package/dist/src/code_assist/telemetry.js.map +1 -1
  246. package/dist/src/code_assist/telemetry.test.js +2 -1
  247. package/dist/src/code_assist/telemetry.test.js.map +1 -1
  248. package/dist/src/code_assist/types.d.ts +255 -24
  249. package/dist/src/code_assist/types.js +57 -7
  250. package/dist/src/code_assist/types.js.map +1 -1
  251. package/dist/src/commands/memory.d.ts +11 -0
  252. package/dist/src/commands/memory.js +81 -0
  253. package/dist/src/commands/memory.js.map +1 -0
  254. package/dist/src/commands/memory.test.d.ts +6 -0
  255. package/dist/src/commands/memory.test.js +155 -0
  256. package/dist/src/commands/memory.test.js.map +1 -0
  257. package/dist/src/commands/restore.js +1 -0
  258. package/dist/src/commands/restore.js.map +1 -1
  259. package/dist/src/config/config.d.ts +267 -58
  260. package/dist/src/config/config.js +663 -164
  261. package/dist/src/config/config.js.map +1 -1
  262. package/dist/src/config/config.test.d.ts +1 -1
  263. package/dist/src/config/config.test.js +585 -166
  264. package/dist/src/config/config.test.js.map +1 -1
  265. package/dist/src/config/constants.d.ts +4 -0
  266. package/dist/src/config/constants.js +8 -0
  267. package/dist/src/config/constants.js.map +1 -1
  268. package/dist/src/config/defaultModelConfigs.js +27 -8
  269. package/dist/src/config/defaultModelConfigs.js.map +1 -1
  270. package/dist/src/config/memory.d.ts +14 -0
  271. package/dist/src/config/memory.js +28 -0
  272. package/dist/src/config/memory.js.map +1 -0
  273. package/dist/src/config/memory.test.d.ts +6 -0
  274. package/dist/src/config/memory.test.js +82 -0
  275. package/dist/src/config/memory.test.js.map +1 -0
  276. package/dist/src/config/models.d.ts +77 -6
  277. package/dist/src/config/models.js +240 -23
  278. package/dist/src/config/models.js.map +1 -1
  279. package/dist/src/config/models.test.js +153 -47
  280. package/dist/src/config/models.test.js.map +1 -1
  281. package/dist/src/config/projectRegistry.d.ts +36 -0
  282. package/dist/src/config/projectRegistry.js +262 -0
  283. package/dist/src/config/projectRegistry.js.map +1 -0
  284. package/dist/src/config/projectRegistry.test.d.ts +6 -0
  285. package/dist/src/config/projectRegistry.test.js +219 -0
  286. package/dist/src/config/projectRegistry.test.js.map +1 -0
  287. package/dist/src/config/storage.d.ts +23 -1
  288. package/dist/src/config/storage.js +104 -15
  289. package/dist/src/config/storage.js.map +1 -1
  290. package/dist/src/config/storage.test.js +118 -2
  291. package/dist/src/config/storage.test.js.map +1 -1
  292. package/dist/src/config/storageMigration.d.ts +16 -0
  293. package/dist/src/config/storageMigration.js +42 -0
  294. package/dist/src/config/storageMigration.js.map +1 -0
  295. package/dist/src/config/storageMigration.test.d.ts +6 -0
  296. package/dist/src/config/storageMigration.test.js +70 -0
  297. package/dist/src/config/storageMigration.test.js.map +1 -0
  298. package/dist/src/confirmation-bus/message-bus.js +3 -33
  299. package/dist/src/confirmation-bus/message-bus.js.map +1 -1
  300. package/dist/src/confirmation-bus/types.d.ts +95 -20
  301. package/dist/src/confirmation-bus/types.js +9 -3
  302. package/dist/src/confirmation-bus/types.js.map +1 -1
  303. package/dist/src/core/anthropicContentGenerator.d.ts +3 -2
  304. package/dist/src/core/anthropicContentGenerator.js +2 -2
  305. package/dist/src/core/anthropicContentGenerator.js.map +1 -1
  306. package/dist/src/core/baseLlmClient.d.ts +9 -0
  307. package/dist/src/core/baseLlmClient.js +9 -8
  308. package/dist/src/core/baseLlmClient.js.map +1 -1
  309. package/dist/src/core/baseLlmClient.test.js +17 -7
  310. package/dist/src/core/baseLlmClient.test.js.map +1 -1
  311. package/dist/src/core/bedrockContentGenerator.d.ts +73 -0
  312. package/dist/src/core/bedrockContentGenerator.js +628 -0
  313. package/dist/src/core/bedrockContentGenerator.js.map +1 -0
  314. package/dist/src/core/client.d.ts +13 -4
  315. package/dist/src/core/client.js +132 -41
  316. package/dist/src/core/client.js.map +1 -1
  317. package/dist/src/core/client.test.js +333 -79
  318. package/dist/src/core/client.test.js.map +1 -1
  319. package/dist/src/core/contentGenerator.d.ts +16 -3
  320. package/dist/src/core/contentGenerator.js +56 -2
  321. package/dist/src/core/contentGenerator.js.map +1 -1
  322. package/dist/src/core/contentGenerator.test.d.ts +1 -1
  323. package/dist/src/core/contentGenerator.test.js +127 -24
  324. package/dist/src/core/contentGenerator.test.js.map +1 -1
  325. package/dist/src/core/coreToolHookTriggers.d.ts +4 -36
  326. package/dist/src/core/coreToolHookTriggers.js +42 -150
  327. package/dist/src/core/coreToolHookTriggers.js.map +1 -1
  328. package/dist/src/core/coreToolHookTriggers.test.js +62 -94
  329. package/dist/src/core/coreToolHookTriggers.test.js.map +1 -1
  330. package/dist/src/core/coreToolScheduler.d.ts +1 -8
  331. package/dist/src/core/coreToolScheduler.js +160 -125
  332. package/dist/src/core/coreToolScheduler.js.map +1 -1
  333. package/dist/src/core/coreToolScheduler.test.js +480 -62
  334. package/dist/src/core/coreToolScheduler.test.js.map +1 -1
  335. package/dist/src/core/fakeContentGenerator.d.ts +4 -2
  336. package/dist/src/core/fakeContentGenerator.js +9 -2
  337. package/dist/src/core/fakeContentGenerator.js.map +1 -1
  338. package/dist/src/core/fakeContentGenerator.test.js +8 -7
  339. package/dist/src/core/fakeContentGenerator.test.js.map +1 -1
  340. package/dist/src/core/geminiChat.d.ts +31 -3
  341. package/dist/src/core/geminiChat.js +144 -34
  342. package/dist/src/core/geminiChat.js.map +1 -1
  343. package/dist/src/core/geminiChat.test.js +175 -50
  344. package/dist/src/core/geminiChat.test.js.map +1 -1
  345. package/dist/src/core/geminiChat_network_retry.test.js +146 -16
  346. package/dist/src/core/geminiChat_network_retry.test.js.map +1 -1
  347. package/dist/src/core/logger.js +11 -0
  348. package/dist/src/core/logger.js.map +1 -1
  349. package/dist/src/core/logger.test.js +2 -4
  350. package/dist/src/core/logger.test.js.map +1 -1
  351. package/dist/src/core/loggingContentGenerator.d.ts +7 -3
  352. package/dist/src/core/loggingContentGenerator.js +40 -21
  353. package/dist/src/core/loggingContentGenerator.js.map +1 -1
  354. package/dist/src/core/loggingContentGenerator.test.d.ts +1 -1
  355. package/dist/src/core/loggingContentGenerator.test.js +50 -8
  356. package/dist/src/core/loggingContentGenerator.test.js.map +1 -1
  357. package/dist/src/core/openaiContentGenerator.d.ts +3 -2
  358. package/dist/src/core/openaiContentGenerator.js +18 -10
  359. package/dist/src/core/openaiContentGenerator.js.map +1 -1
  360. package/dist/src/core/openaiContentGenerator.test.js +57 -4
  361. package/dist/src/core/openaiContentGenerator.test.js.map +1 -1
  362. package/dist/src/core/prompts-substitution.test.d.ts +6 -0
  363. package/dist/src/core/prompts-substitution.test.js +109 -0
  364. package/dist/src/core/prompts-substitution.test.js.map +1 -0
  365. package/dist/src/core/prompts.d.ts +11 -9
  366. package/dist/src/core/prompts.js +14 -405
  367. package/dist/src/core/prompts.js.map +1 -1
  368. package/dist/src/core/prompts.test.js +290 -56
  369. package/dist/src/core/prompts.test.js.map +1 -1
  370. package/dist/src/core/recordingContentGenerator.d.ts +5 -3
  371. package/dist/src/core/recordingContentGenerator.js +12 -5
  372. package/dist/src/core/recordingContentGenerator.js.map +1 -1
  373. package/dist/src/core/recordingContentGenerator.test.js +5 -4
  374. package/dist/src/core/recordingContentGenerator.test.js.map +1 -1
  375. package/dist/src/core/tokenLimits.js +6 -10
  376. package/dist/src/core/tokenLimits.js.map +1 -1
  377. package/dist/src/core/tokenLimits.test.js +8 -4
  378. package/dist/src/core/tokenLimits.test.js.map +1 -1
  379. package/dist/src/core/turn.d.ts +10 -2
  380. package/dist/src/core/turn.js +36 -17
  381. package/dist/src/core/turn.js.map +1 -1
  382. package/dist/src/core/turn.test.js +82 -2
  383. package/dist/src/core/turn.test.js.map +1 -1
  384. package/dist/src/fallback/handler.js +1 -1
  385. package/dist/src/fallback/handler.js.map +1 -1
  386. package/dist/src/fallback/handler.test.js +10 -12
  387. package/dist/src/fallback/handler.test.js.map +1 -1
  388. package/dist/src/fallback/types.d.ts +9 -0
  389. package/dist/src/generated/git-commit.d.ts +2 -2
  390. package/dist/src/generated/git-commit.js +2 -2
  391. package/dist/src/hooks/hookAggregator.js +16 -4
  392. package/dist/src/hooks/hookAggregator.js.map +1 -1
  393. package/dist/src/hooks/hookEventHandler.d.ts +10 -16
  394. package/dist/src/hooks/hookEventHandler.js +35 -281
  395. package/dist/src/hooks/hookEventHandler.js.map +1 -1
  396. package/dist/src/hooks/hookEventHandler.test.js +189 -4
  397. package/dist/src/hooks/hookEventHandler.test.js.map +1 -1
  398. package/dist/src/hooks/hookRegistry.js +8 -3
  399. package/dist/src/hooks/hookRegistry.js.map +1 -1
  400. package/dist/src/hooks/hookRegistry.test.js +31 -2
  401. package/dist/src/hooks/hookRegistry.test.js.map +1 -1
  402. package/dist/src/hooks/hookRunner.js +21 -18
  403. package/dist/src/hooks/hookRunner.js.map +1 -1
  404. package/dist/src/hooks/hookSystem.d.ts +59 -0
  405. package/dist/src/hooks/hookSystem.js +206 -6
  406. package/dist/src/hooks/hookSystem.js.map +1 -1
  407. package/dist/src/hooks/hookSystem.test.js +20 -9
  408. package/dist/src/hooks/hookSystem.test.js.map +1 -1
  409. package/dist/src/hooks/hookTranslator.js +13 -6
  410. package/dist/src/hooks/hookTranslator.js.map +1 -1
  411. package/dist/src/hooks/index.d.ts +0 -1
  412. package/dist/src/hooks/index.js +0 -2
  413. package/dist/src/hooks/index.js.map +1 -1
  414. package/dist/src/hooks/trustedHooks.js +2 -0
  415. package/dist/src/hooks/trustedHooks.js.map +1 -1
  416. package/dist/src/hooks/types.d.ts +49 -1
  417. package/dist/src/hooks/types.js +43 -19
  418. package/dist/src/hooks/types.js.map +1 -1
  419. package/dist/src/hooks/types.test.js +13 -29
  420. package/dist/src/hooks/types.test.js.map +1 -1
  421. package/dist/src/ide/detect-ide.d.ts +49 -0
  422. package/dist/src/ide/detect-ide.js +56 -3
  423. package/dist/src/ide/detect-ide.js.map +1 -1
  424. package/dist/src/ide/detect-ide.test.js +70 -0
  425. package/dist/src/ide/detect-ide.test.js.map +1 -1
  426. package/dist/src/ide/ide-client.d.ts +0 -10
  427. package/dist/src/ide/ide-client.js +31 -199
  428. package/dist/src/ide/ide-client.js.map +1 -1
  429. package/dist/src/ide/ide-client.test.js +39 -191
  430. package/dist/src/ide/ide-client.test.js.map +1 -1
  431. package/dist/src/ide/ide-connection-utils.d.ts +27 -0
  432. package/dist/src/ide/ide-connection-utils.js +195 -0
  433. package/dist/src/ide/ide-connection-utils.js.map +1 -0
  434. package/dist/src/ide/ide-connection-utils.test.d.ts +6 -0
  435. package/dist/src/ide/ide-connection-utils.test.js +372 -0
  436. package/dist/src/ide/ide-connection-utils.test.js.map +1 -0
  437. package/dist/src/ide/ide-installer.js +76 -5
  438. package/dist/src/ide/ide-installer.js.map +1 -1
  439. package/dist/src/ide/ide-installer.test.js +40 -2
  440. package/dist/src/ide/ide-installer.test.js.map +1 -1
  441. package/dist/src/ide/types.d.ts +46 -46
  442. package/dist/src/index.d.ts +30 -2
  443. package/dist/src/index.js +31 -2
  444. package/dist/src/index.js.map +1 -1
  445. package/dist/src/mcp/oauth-provider.d.ts +10 -3
  446. package/dist/src/mcp/oauth-provider.js +49 -14
  447. package/dist/src/mcp/oauth-provider.js.map +1 -1
  448. package/dist/src/mcp/oauth-provider.test.js +180 -1
  449. package/dist/src/mcp/oauth-provider.test.js.map +1 -1
  450. package/dist/src/mcp/oauth-token-storage.js +3 -0
  451. package/dist/src/mcp/oauth-token-storage.js.map +1 -1
  452. package/dist/src/mcp/oauth-utils.d.ts +13 -4
  453. package/dist/src/mcp/oauth-utils.js +25 -19
  454. package/dist/src/mcp/oauth-utils.js.map +1 -1
  455. package/dist/src/mcp/oauth-utils.test.js +13 -8
  456. package/dist/src/mcp/oauth-utils.test.js.map +1 -1
  457. package/dist/src/mcp/sa-impersonation-provider.js +3 -1
  458. package/dist/src/mcp/sa-impersonation-provider.js.map +1 -1
  459. package/dist/src/mcp/token-storage/file-token-storage.js +6 -2
  460. package/dist/src/mcp/token-storage/file-token-storage.js.map +1 -1
  461. package/dist/src/mcp/token-storage/hybrid-token-storage.js +4 -0
  462. package/dist/src/mcp/token-storage/hybrid-token-storage.js.map +1 -1
  463. package/dist/src/mcp/token-storage/hybrid-token-storage.test.js +12 -0
  464. package/dist/src/mcp/token-storage/hybrid-token-storage.test.js.map +1 -1
  465. package/dist/src/mcp/token-storage/keychain-token-storage.js +8 -0
  466. package/dist/src/mcp/token-storage/keychain-token-storage.js.map +1 -1
  467. package/dist/src/mcp/token-storage/keychain-token-storage.test.js +10 -5
  468. package/dist/src/mcp/token-storage/keychain-token-storage.test.js.map +1 -1
  469. package/dist/src/output/json-formatter.test.js +2 -0
  470. package/dist/src/output/json-formatter.test.js.map +1 -1
  471. package/dist/src/output/stream-json-formatter.test.js +4 -0
  472. package/dist/src/output/stream-json-formatter.test.js.map +1 -1
  473. package/dist/src/policy/config.d.ts +5 -3
  474. package/dist/src/policy/config.js +137 -64
  475. package/dist/src/policy/config.js.map +1 -1
  476. package/dist/src/policy/config.test.js +218 -12
  477. package/dist/src/policy/config.test.js.map +1 -1
  478. package/dist/src/policy/persistence.test.js +31 -11
  479. package/dist/src/policy/persistence.test.js.map +1 -1
  480. package/dist/src/policy/policies/plan.toml +56 -0
  481. package/dist/src/policy/policies/read-only.toml +1 -11
  482. package/dist/src/policy/policies/yolo.toml +13 -2
  483. package/dist/src/policy/policy-engine.d.ts +16 -11
  484. package/dist/src/policy/policy-engine.js +208 -101
  485. package/dist/src/policy/policy-engine.js.map +1 -1
  486. package/dist/src/policy/policy-engine.test.js +538 -199
  487. package/dist/src/policy/policy-engine.test.js.map +1 -1
  488. package/dist/src/policy/policy-updater.test.js +20 -6
  489. package/dist/src/policy/policy-updater.test.js.map +1 -1
  490. package/dist/src/policy/shell-safety.test.js +371 -8
  491. package/dist/src/policy/shell-safety.test.js.map +1 -1
  492. package/dist/src/policy/stable-stringify.js +1 -0
  493. package/dist/src/policy/stable-stringify.js.map +1 -1
  494. package/dist/src/policy/toml-loader.d.ts +5 -5
  495. package/dist/src/policy/toml-loader.js +65 -22
  496. package/dist/src/policy/toml-loader.js.map +1 -1
  497. package/dist/src/policy/toml-loader.test.js +88 -9
  498. package/dist/src/policy/toml-loader.test.js.map +1 -1
  499. package/dist/src/policy/types.d.ts +26 -1
  500. package/dist/src/policy/types.js +8 -0
  501. package/dist/src/policy/types.js.map +1 -1
  502. package/dist/src/policy/utils.d.ts +5 -0
  503. package/dist/src/policy/utils.js +32 -1
  504. package/dist/src/policy/utils.js.map +1 -1
  505. package/dist/src/policy/utils.test.js +67 -7
  506. package/dist/src/policy/utils.test.js.map +1 -1
  507. package/dist/src/prompts/promptProvider.d.ts +19 -0
  508. package/dist/src/prompts/promptProvider.js +174 -0
  509. package/dist/src/prompts/promptProvider.js.map +1 -0
  510. package/dist/src/prompts/promptProvider.test.d.ts +6 -0
  511. package/dist/src/prompts/promptProvider.test.js +71 -0
  512. package/dist/src/prompts/promptProvider.test.js.map +1 -0
  513. package/dist/src/prompts/snippets.d.ts +86 -0
  514. package/dist/src/prompts/snippets.js +573 -0
  515. package/dist/src/prompts/snippets.js.map +1 -0
  516. package/dist/src/prompts/snippets.legacy.d.ts +91 -0
  517. package/dist/src/prompts/snippets.legacy.js +573 -0
  518. package/dist/src/prompts/snippets.legacy.js.map +1 -0
  519. package/dist/src/prompts/utils.d.ts +23 -0
  520. package/dist/src/prompts/utils.js +82 -0
  521. package/dist/src/prompts/utils.js.map +1 -0
  522. package/dist/src/routing/modelRouterService.js +18 -8
  523. package/dist/src/routing/modelRouterService.js.map +1 -1
  524. package/dist/src/routing/modelRouterService.test.js +14 -6
  525. package/dist/src/routing/modelRouterService.test.js.map +1 -1
  526. package/dist/src/routing/routingStrategy.d.ts +2 -0
  527. package/dist/src/routing/strategies/classifierStrategy.js +14 -9
  528. package/dist/src/routing/strategies/classifierStrategy.js.map +1 -1
  529. package/dist/src/routing/strategies/classifierStrategy.test.js +72 -7
  530. package/dist/src/routing/strategies/classifierStrategy.test.js.map +1 -1
  531. package/dist/src/routing/strategies/compositeStrategy.js +1 -0
  532. package/dist/src/routing/strategies/compositeStrategy.js.map +1 -1
  533. package/dist/src/routing/strategies/defaultStrategy.d.ts +1 -1
  534. package/dist/src/routing/strategies/defaultStrategy.js +5 -4
  535. package/dist/src/routing/strategies/defaultStrategy.js.map +1 -1
  536. package/dist/src/routing/strategies/defaultStrategy.test.js +58 -4
  537. package/dist/src/routing/strategies/defaultStrategy.test.js.map +1 -1
  538. package/dist/src/routing/strategies/fallbackStrategy.d.ts +1 -1
  539. package/dist/src/routing/strategies/fallbackStrategy.js +3 -3
  540. package/dist/src/routing/strategies/fallbackStrategy.js.map +1 -1
  541. package/dist/src/routing/strategies/fallbackStrategy.test.js +13 -1
  542. package/dist/src/routing/strategies/fallbackStrategy.test.js.map +1 -1
  543. package/dist/src/routing/strategies/numericalClassifierStrategy.d.ts +13 -0
  544. package/dist/src/routing/strategies/numericalClassifierStrategy.js +188 -0
  545. package/dist/src/routing/strategies/numericalClassifierStrategy.js.map +1 -0
  546. package/dist/src/routing/strategies/numericalClassifierStrategy.test.d.ts +6 -0
  547. package/dist/src/routing/strategies/numericalClassifierStrategy.test.js +401 -0
  548. package/dist/src/routing/strategies/numericalClassifierStrategy.test.js.map +1 -0
  549. package/dist/src/routing/strategies/overrideStrategy.d.ts +1 -1
  550. package/dist/src/routing/strategies/overrideStrategy.js +6 -6
  551. package/dist/src/routing/strategies/overrideStrategy.js.map +1 -1
  552. package/dist/src/routing/strategies/overrideStrategy.test.js +13 -3
  553. package/dist/src/routing/strategies/overrideStrategy.test.js.map +1 -1
  554. package/dist/src/safety/built-in.js +1 -0
  555. package/dist/src/safety/built-in.js.map +1 -1
  556. package/dist/src/safety/context-builder.js +3 -1
  557. package/dist/src/safety/context-builder.js.map +1 -1
  558. package/dist/src/scheduler/confirmation.d.ts +50 -0
  559. package/dist/src/scheduler/confirmation.js +204 -0
  560. package/dist/src/scheduler/confirmation.js.map +1 -0
  561. package/dist/src/scheduler/confirmation.test.d.ts +6 -0
  562. package/dist/src/scheduler/confirmation.test.js +310 -0
  563. package/dist/src/scheduler/confirmation.test.js.map +1 -0
  564. package/dist/src/scheduler/policy.d.ts +33 -0
  565. package/dist/src/scheduler/policy.js +119 -0
  566. package/dist/src/scheduler/policy.js.map +1 -0
  567. package/dist/src/scheduler/policy.test.d.ts +6 -0
  568. package/dist/src/scheduler/policy.test.js +419 -0
  569. package/dist/src/scheduler/policy.test.js.map +1 -0
  570. package/dist/src/scheduler/scheduler.d.ts +63 -0
  571. package/dist/src/scheduler/scheduler.js +371 -0
  572. package/dist/src/scheduler/scheduler.js.map +1 -0
  573. package/dist/src/scheduler/scheduler.test.d.ts +6 -0
  574. package/dist/src/scheduler/scheduler.test.js +937 -0
  575. package/dist/src/scheduler/scheduler.test.js.map +1 -0
  576. package/dist/src/scheduler/scheduler_waiting_callback.test.d.ts +6 -0
  577. package/dist/src/scheduler/scheduler_waiting_callback.test.js +62 -0
  578. package/dist/src/scheduler/scheduler_waiting_callback.test.js.map +1 -0
  579. package/dist/src/scheduler/state-manager.d.ts +74 -0
  580. package/dist/src/scheduler/state-manager.js +368 -0
  581. package/dist/src/scheduler/state-manager.js.map +1 -0
  582. package/dist/src/scheduler/state-manager.test.d.ts +6 -0
  583. package/dist/src/scheduler/state-manager.test.js +433 -0
  584. package/dist/src/scheduler/state-manager.test.js.map +1 -0
  585. package/dist/src/scheduler/tool-executor.js +25 -27
  586. package/dist/src/scheduler/tool-executor.js.map +1 -1
  587. package/dist/src/scheduler/tool-executor.test.js +26 -25
  588. package/dist/src/scheduler/tool-executor.test.js.map +1 -1
  589. package/dist/src/scheduler/tool-modifier.d.ts +23 -0
  590. package/dist/src/scheduler/tool-modifier.js +53 -0
  591. package/dist/src/scheduler/tool-modifier.js.map +1 -0
  592. package/dist/src/scheduler/tool-modifier.test.d.ts +6 -0
  593. package/dist/src/scheduler/tool-modifier.test.js +179 -0
  594. package/dist/src/scheduler/tool-modifier.test.js.map +1 -0
  595. package/dist/src/scheduler/types.d.ts +51 -8
  596. package/dist/src/scheduler/types.js +15 -1
  597. package/dist/src/scheduler/types.js.map +1 -1
  598. package/dist/src/services/chatCompressionService.d.ts +5 -1
  599. package/dist/src/services/chatCompressionService.js +169 -23
  600. package/dist/src/services/chatCompressionService.js.map +1 -1
  601. package/dist/src/services/chatCompressionService.test.js +382 -18
  602. package/dist/src/services/chatCompressionService.test.js.map +1 -1
  603. package/dist/src/services/chatRecordingService.d.ts +23 -3
  604. package/dist/src/services/chatRecordingService.js +137 -7
  605. package/dist/src/services/chatRecordingService.js.map +1 -1
  606. package/dist/src/services/chatRecordingService.test.js +450 -186
  607. package/dist/src/services/chatRecordingService.test.js.map +1 -1
  608. package/dist/src/services/contextManager.d.ts +7 -4
  609. package/dist/src/services/contextManager.js +43 -18
  610. package/dist/src/services/contextManager.js.map +1 -1
  611. package/dist/src/services/contextManager.test.js +54 -27
  612. package/dist/src/services/contextManager.test.js.map +1 -1
  613. package/dist/src/services/environmentSanitization.js +4 -3
  614. package/dist/src/services/environmentSanitization.js.map +1 -1
  615. package/dist/src/services/fileDiscoveryService.d.ts +14 -2
  616. package/dist/src/services/fileDiscoveryService.js +79 -7
  617. package/dist/src/services/fileDiscoveryService.js.map +1 -1
  618. package/dist/src/services/fileDiscoveryService.test.js +142 -10
  619. package/dist/src/services/fileDiscoveryService.test.js.map +1 -1
  620. package/dist/src/services/gitService.d.ts +2 -1
  621. package/dist/src/services/gitService.js +16 -6
  622. package/dist/src/services/gitService.js.map +1 -1
  623. package/dist/src/services/gitService.test.js +26 -10
  624. package/dist/src/services/gitService.test.js.map +1 -1
  625. package/dist/src/services/loopDetectionService.js +23 -4
  626. package/dist/src/services/loopDetectionService.js.map +1 -1
  627. package/dist/src/services/loopDetectionService.test.js +24 -0
  628. package/dist/src/services/loopDetectionService.test.js.map +1 -1
  629. package/dist/src/services/modelConfig.integration.test.js +2 -2
  630. package/dist/src/services/modelConfig.integration.test.js.map +1 -1
  631. package/dist/src/services/modelConfigService.d.ts +39 -4
  632. package/dist/src/services/modelConfigService.js +153 -76
  633. package/dist/src/services/modelConfigService.js.map +1 -1
  634. package/dist/src/services/modelConfigService.test.js +175 -0
  635. package/dist/src/services/modelConfigService.test.js.map +1 -1
  636. package/dist/src/services/modelConfigServiceTestUtils.js +3 -1
  637. package/dist/src/services/modelConfigServiceTestUtils.js.map +1 -1
  638. package/dist/src/services/sessionSummaryService.js +2 -0
  639. package/dist/src/services/sessionSummaryService.js.map +1 -1
  640. package/dist/src/services/sessionSummaryService.test.js +1 -1
  641. package/dist/src/services/sessionSummaryService.test.js.map +1 -1
  642. package/dist/src/services/shellExecutionService.d.ts +48 -0
  643. package/dist/src/services/shellExecutionService.js +339 -97
  644. package/dist/src/services/shellExecutionService.js.map +1 -1
  645. package/dist/src/services/shellExecutionService.test.js +132 -17
  646. package/dist/src/services/shellExecutionService.test.js.map +1 -1
  647. package/dist/src/services/test-data/resolved-aliases-retry.golden.json +26 -8
  648. package/dist/src/services/test-data/resolved-aliases.golden.json +26 -8
  649. package/dist/src/services/toolOutputMaskingService.d.ts +43 -0
  650. package/dist/src/services/toolOutputMaskingService.js +286 -0
  651. package/dist/src/services/toolOutputMaskingService.js.map +1 -0
  652. package/dist/src/services/toolOutputMaskingService.test.d.ts +6 -0
  653. package/dist/src/services/toolOutputMaskingService.test.js +546 -0
  654. package/dist/src/services/toolOutputMaskingService.test.js.map +1 -0
  655. package/dist/src/skills/builtin/skill-creator/SKILL.md +382 -0
  656. package/dist/src/skills/builtin/skill-creator/scripts/init_skill.cjs +239 -0
  657. package/dist/src/skills/builtin/skill-creator/scripts/package_skill.cjs +106 -0
  658. package/dist/src/skills/builtin/skill-creator/scripts/validate_skill.cjs +131 -0
  659. package/dist/src/skills/skillLoader.d.ts +3 -0
  660. package/dist/src/skills/skillLoader.js +73 -12
  661. package/dist/src/skills/skillLoader.js.map +1 -1
  662. package/dist/src/skills/skillLoader.test.d.ts +5 -0
  663. package/dist/src/skills/skillLoader.test.js +195 -1
  664. package/dist/src/skills/skillLoader.test.js.map +1 -1
  665. package/dist/src/skills/skillManager.d.ts +25 -3
  666. package/dist/src/skills/skillManager.js +76 -11
  667. package/dist/src/skills/skillManager.js.map +1 -1
  668. package/dist/src/skills/skillManager.test.js +209 -9
  669. package/dist/src/skills/skillManager.test.js.map +1 -1
  670. package/dist/src/skills/skillManagerAlias.test.d.ts +6 -0
  671. package/dist/src/skills/skillManagerAlias.test.js +140 -0
  672. package/dist/src/skills/skillManagerAlias.test.js.map +1 -0
  673. package/dist/src/telemetry/activity-monitor.js +1 -0
  674. package/dist/src/telemetry/activity-monitor.js.map +1 -1
  675. package/dist/src/telemetry/clearcut-logger/clearcut-logger.d.ts +25 -4
  676. package/dist/src/telemetry/clearcut-logger/clearcut-logger.js +207 -12
  677. package/dist/src/telemetry/clearcut-logger/clearcut-logger.js.map +1 -1
  678. package/dist/src/telemetry/clearcut-logger/clearcut-logger.test.js +210 -6
  679. package/dist/src/telemetry/clearcut-logger/clearcut-logger.test.js.map +1 -1
  680. package/dist/src/telemetry/clearcut-logger/event-metadata-key.d.ts +23 -1
  681. package/dist/src/telemetry/clearcut-logger/event-metadata-key.js +61 -1
  682. package/dist/src/telemetry/clearcut-logger/event-metadata-key.js.map +1 -1
  683. package/dist/src/telemetry/file-exporters.js +2 -1
  684. package/dist/src/telemetry/file-exporters.js.map +1 -1
  685. package/dist/src/telemetry/file-exporters.test.d.ts +6 -0
  686. package/dist/src/telemetry/file-exporters.test.js +142 -0
  687. package/dist/src/telemetry/file-exporters.test.js.map +1 -0
  688. package/dist/src/telemetry/gcp-exporters.js +1 -0
  689. package/dist/src/telemetry/gcp-exporters.js.map +1 -1
  690. package/dist/src/telemetry/index.d.ts +3 -2
  691. package/dist/src/telemetry/index.js +3 -2
  692. package/dist/src/telemetry/index.js.map +1 -1
  693. package/dist/src/telemetry/integration.test.circular.js +2 -1
  694. package/dist/src/telemetry/integration.test.circular.js.map +1 -1
  695. package/dist/src/telemetry/llmRole.d.ts +18 -0
  696. package/dist/src/telemetry/llmRole.js +20 -0
  697. package/dist/src/telemetry/llmRole.js.map +1 -0
  698. package/dist/src/telemetry/loggers.d.ts +8 -1
  699. package/dist/src/telemetry/loggers.js +113 -10
  700. package/dist/src/telemetry/loggers.js.map +1 -1
  701. package/dist/src/telemetry/loggers.test.circular.js +5 -2
  702. package/dist/src/telemetry/loggers.test.circular.js.map +1 -1
  703. package/dist/src/telemetry/loggers.test.js +169 -19
  704. package/dist/src/telemetry/loggers.test.js.map +1 -1
  705. package/dist/src/telemetry/memory-monitor.test.js +1 -0
  706. package/dist/src/telemetry/memory-monitor.test.js.map +1 -1
  707. package/dist/src/telemetry/metrics.d.ts +39 -1
  708. package/dist/src/telemetry/metrics.js +105 -4
  709. package/dist/src/telemetry/metrics.js.map +1 -1
  710. package/dist/src/telemetry/metrics.test.js +84 -4
  711. package/dist/src/telemetry/metrics.test.js.map +1 -1
  712. package/dist/src/telemetry/sanitize.test.js +2 -0
  713. package/dist/src/telemetry/sanitize.test.js.map +1 -1
  714. package/dist/src/telemetry/sdk.js +24 -0
  715. package/dist/src/telemetry/sdk.js.map +1 -1
  716. package/dist/src/telemetry/sdk.test.js +5 -1
  717. package/dist/src/telemetry/sdk.test.js.map +1 -1
  718. package/dist/src/telemetry/semantic.js +92 -0
  719. package/dist/src/telemetry/semantic.js.map +1 -1
  720. package/dist/src/telemetry/semantic.truncation.test.d.ts +1 -0
  721. package/dist/src/telemetry/semantic.truncation.test.js +92 -0
  722. package/dist/src/telemetry/semantic.truncation.test.js.map +1 -0
  723. package/dist/src/telemetry/telemetryAttributes.js +5 -0
  724. package/dist/src/telemetry/telemetryAttributes.js.map +1 -1
  725. package/dist/src/telemetry/types.d.ts +98 -15
  726. package/dist/src/telemetry/types.js +227 -16
  727. package/dist/src/telemetry/types.js.map +1 -1
  728. package/dist/src/telemetry/uiTelemetry.d.ts +16 -0
  729. package/dist/src/telemetry/uiTelemetry.js +39 -0
  730. package/dist/src/telemetry/uiTelemetry.js.map +1 -1
  731. package/dist/src/telemetry/uiTelemetry.test.js +29 -0
  732. package/dist/src/telemetry/uiTelemetry.test.js.map +1 -1
  733. package/dist/src/test-utils/mock-message-bus.d.ts +1 -19
  734. package/dist/src/test-utils/mock-message-bus.js +5 -65
  735. package/dist/src/test-utils/mock-message-bus.js.map +1 -1
  736. package/dist/src/test-utils/mock-tool.d.ts +1 -0
  737. package/dist/src/test-utils/mock-tool.js +1 -0
  738. package/dist/src/test-utils/mock-tool.js.map +1 -1
  739. package/dist/src/test-utils/mockWorkspaceContext.js +1 -0
  740. package/dist/src/test-utils/mockWorkspaceContext.js.map +1 -1
  741. package/dist/src/tools/activate-skill.d.ts +1 -0
  742. package/dist/src/tools/activate-skill.js +28 -25
  743. package/dist/src/tools/activate-skill.js.map +1 -1
  744. package/dist/src/tools/activate-skill.test.js +24 -6
  745. package/dist/src/tools/activate-skill.test.js.map +1 -1
  746. package/dist/src/tools/ask-user.d.ts +29 -0
  747. package/dist/src/tools/ask-user.js +141 -0
  748. package/dist/src/tools/ask-user.js.map +1 -0
  749. package/dist/src/tools/ask-user.test.d.ts +6 -0
  750. package/dist/src/tools/ask-user.test.js +446 -0
  751. package/dist/src/tools/ask-user.test.js.map +1 -0
  752. package/dist/src/tools/confirmation-policy.test.js +21 -0
  753. package/dist/src/tools/confirmation-policy.test.js.map +1 -1
  754. package/dist/src/tools/constants.d.ts +7 -0
  755. package/dist/src/tools/constants.js +8 -0
  756. package/dist/src/tools/constants.js.map +1 -0
  757. package/dist/src/tools/definitions/base-declarations.d.ts +26 -0
  758. package/dist/src/tools/definitions/base-declarations.js +30 -0
  759. package/dist/src/tools/definitions/base-declarations.js.map +1 -0
  760. package/dist/src/tools/definitions/coreTools.d.ts +36 -0
  761. package/dist/src/tools/definitions/coreTools.js +143 -0
  762. package/dist/src/tools/definitions/coreTools.js.map +1 -0
  763. package/dist/src/tools/definitions/coreToolsModelSnapshots.test.d.ts +6 -0
  764. package/dist/src/tools/definitions/coreToolsModelSnapshots.test.js +82 -0
  765. package/dist/src/tools/definitions/coreToolsModelSnapshots.test.js.map +1 -0
  766. package/dist/src/tools/definitions/dynamic-declaration-helpers.d.ts +30 -0
  767. package/dist/src/tools/definitions/dynamic-declaration-helpers.js +135 -0
  768. package/dist/src/tools/definitions/dynamic-declaration-helpers.js.map +1 -0
  769. package/dist/src/tools/definitions/model-family-sets/default-legacy.d.ts +11 -0
  770. package/dist/src/tools/definitions/model-family-sets/default-legacy.js +575 -0
  771. package/dist/src/tools/definitions/model-family-sets/default-legacy.js.map +1 -0
  772. package/dist/src/tools/definitions/model-family-sets/gemini-3.d.ts +14 -0
  773. package/dist/src/tools/definitions/model-family-sets/gemini-3.js +578 -0
  774. package/dist/src/tools/definitions/model-family-sets/gemini-3.js.map +1 -0
  775. package/dist/src/tools/definitions/modelFamilyService.d.ts +14 -0
  776. package/dist/src/tools/definitions/modelFamilyService.js +29 -0
  777. package/dist/src/tools/definitions/modelFamilyService.js.map +1 -0
  778. package/dist/src/tools/definitions/resolver.d.ts +15 -0
  779. package/dist/src/tools/definitions/resolver.js +27 -0
  780. package/dist/src/tools/definitions/resolver.js.map +1 -0
  781. package/dist/src/tools/definitions/resolver.test.d.ts +6 -0
  782. package/dist/src/tools/definitions/resolver.test.js +58 -0
  783. package/dist/src/tools/definitions/resolver.test.js.map +1 -0
  784. package/dist/src/tools/definitions/types.d.ts +44 -0
  785. package/dist/src/tools/definitions/types.js +7 -0
  786. package/dist/src/tools/definitions/types.js.map +1 -0
  787. package/dist/src/tools/diffOptions.d.ts +1 -1
  788. package/dist/src/tools/diffOptions.js +7 -3
  789. package/dist/src/tools/diffOptions.js.map +1 -1
  790. package/dist/src/tools/diffOptions.test.js +17 -0
  791. package/dist/src/tools/diffOptions.test.js.map +1 -1
  792. package/dist/src/tools/edit.d.ts +1 -0
  793. package/dist/src/tools/edit.js +52 -82
  794. package/dist/src/tools/edit.js.map +1 -1
  795. package/dist/src/tools/edit.test.js +96 -1
  796. package/dist/src/tools/edit.test.js.map +1 -1
  797. package/dist/src/tools/enter-plan-mode.d.ts +25 -0
  798. package/dist/src/tools/enter-plan-mode.js +69 -0
  799. package/dist/src/tools/enter-plan-mode.js.map +1 -0
  800. package/dist/src/tools/enter-plan-mode.test.d.ts +6 -0
  801. package/dist/src/tools/enter-plan-mode.test.js +102 -0
  802. package/dist/src/tools/enter-plan-mode.test.js.map +1 -0
  803. package/dist/src/tools/exit-plan-mode.d.ts +33 -0
  804. package/dist/src/tools/exit-plan-mode.js +173 -0
  805. package/dist/src/tools/exit-plan-mode.js.map +1 -0
  806. package/dist/src/tools/exit-plan-mode.test.d.ts +6 -0
  807. package/dist/src/tools/exit-plan-mode.test.js +311 -0
  808. package/dist/src/tools/exit-plan-mode.test.js.map +1 -0
  809. package/dist/src/tools/get-internal-docs.d.ts +1 -0
  810. package/dist/src/tools/get-internal-docs.js +17 -27
  811. package/dist/src/tools/get-internal-docs.js.map +1 -1
  812. package/dist/src/tools/glob.d.ts +1 -0
  813. package/dist/src/tools/glob.js +15 -36
  814. package/dist/src/tools/glob.js.map +1 -1
  815. package/dist/src/tools/glob.test.js +219 -280
  816. package/dist/src/tools/glob.test.js.map +1 -1
  817. package/dist/src/tools/grep.d.ts +18 -8
  818. package/dist/src/tools/grep.js +273 -247
  819. package/dist/src/tools/grep.js.map +1 -1
  820. package/dist/src/tools/grep.test.js +165 -16
  821. package/dist/src/tools/grep.test.js.map +1 -1
  822. package/dist/src/tools/line-endings.test.d.ts +6 -0
  823. package/dist/src/tools/line-endings.test.js +209 -0
  824. package/dist/src/tools/line-endings.test.js.map +1 -0
  825. package/dist/src/tools/ls.d.ts +1 -0
  826. package/dist/src/tools/ls.js +18 -37
  827. package/dist/src/tools/ls.js.map +1 -1
  828. package/dist/src/tools/ls.test.js +25 -3
  829. package/dist/src/tools/ls.test.js.map +1 -1
  830. package/dist/src/tools/mcp-client-manager.d.ts +18 -5
  831. package/dist/src/tools/mcp-client-manager.js +118 -37
  832. package/dist/src/tools/mcp-client-manager.js.map +1 -1
  833. package/dist/src/tools/mcp-client-manager.test.js +124 -16
  834. package/dist/src/tools/mcp-client-manager.test.js.map +1 -1
  835. package/dist/src/tools/mcp-client.d.ts +18 -7
  836. package/dist/src/tools/mcp-client.js +137 -42
  837. package/dist/src/tools/mcp-client.js.map +1 -1
  838. package/dist/src/tools/mcp-client.test.js +248 -29
  839. package/dist/src/tools/mcp-client.test.js.map +1 -1
  840. package/dist/src/tools/mcp-tool.d.ts +26 -4
  841. package/dist/src/tools/mcp-tool.js +17 -5
  842. package/dist/src/tools/mcp-tool.js.map +1 -1
  843. package/dist/src/tools/mcp-tool.test.js +5 -5
  844. package/dist/src/tools/mcp-tool.test.js.map +1 -1
  845. package/dist/src/tools/memoryTool.d.ts +2 -7
  846. package/dist/src/tools/memoryTool.js +54 -80
  847. package/dist/src/tools/memoryTool.js.map +1 -1
  848. package/dist/src/tools/memoryTool.test.js +62 -114
  849. package/dist/src/tools/memoryTool.test.js.map +1 -1
  850. package/dist/src/tools/modifiable-tool.test.js +3 -3
  851. package/dist/src/tools/modifiable-tool.test.js.map +1 -1
  852. package/dist/src/tools/read-file.d.ts +2 -0
  853. package/dist/src/tools/read-file.js +26 -30
  854. package/dist/src/tools/read-file.js.map +1 -1
  855. package/dist/src/tools/read-file.test.js +90 -3
  856. package/dist/src/tools/read-file.test.js.map +1 -1
  857. package/dist/src/tools/read-many-files.d.ts +1 -0
  858. package/dist/src/tools/read-many-files.js +21 -63
  859. package/dist/src/tools/read-many-files.js.map +1 -1
  860. package/dist/src/tools/read-many-files.test.js +43 -1
  861. package/dist/src/tools/read-many-files.test.js.map +1 -1
  862. package/dist/src/tools/ripGrep.d.ts +20 -3
  863. package/dist/src/tools/ripGrep.js +217 -189
  864. package/dist/src/tools/ripGrep.js.map +1 -1
  865. package/dist/src/tools/ripGrep.test.js +745 -567
  866. package/dist/src/tools/ripGrep.test.js.map +1 -1
  867. package/dist/src/tools/shell.d.ts +1 -0
  868. package/dist/src/tools/shell.js +8 -3
  869. package/dist/src/tools/shell.js.map +1 -1
  870. package/dist/src/tools/shell.test.js +248 -11
  871. package/dist/src/tools/shell.test.js.map +1 -1
  872. package/dist/src/tools/tool-error.d.ts +4 -0
  873. package/dist/src/tools/tool-error.js +4 -0
  874. package/dist/src/tools/tool-error.js.map +1 -1
  875. package/dist/src/tools/tool-names.d.ts +27 -17
  876. package/dist/src/tools/tool-names.js +59 -20
  877. package/dist/src/tools/tool-names.js.map +1 -1
  878. package/dist/src/tools/tool-names.test.js +55 -2
  879. package/dist/src/tools/tool-names.test.js.map +1 -1
  880. package/dist/src/tools/tool-registry.d.ts +10 -2
  881. package/dist/src/tools/tool-registry.js +58 -11
  882. package/dist/src/tools/tool-registry.js.map +1 -1
  883. package/dist/src/tools/tool-registry.test.js +113 -1
  884. package/dist/src/tools/tool-registry.test.js.map +1 -1
  885. package/dist/src/tools/tools.d.ts +52 -5
  886. package/dist/src/tools/tools.js +35 -18
  887. package/dist/src/tools/tools.js.map +1 -1
  888. package/dist/src/tools/web-fetch.d.ts +1 -0
  889. package/dist/src/tools/web-fetch.js +12 -12
  890. package/dist/src/tools/web-fetch.js.map +1 -1
  891. package/dist/src/tools/web-search.d.ts +1 -0
  892. package/dist/src/tools/web-search.js +9 -11
  893. package/dist/src/tools/web-search.js.map +1 -1
  894. package/dist/src/tools/write-file.d.ts +1 -4
  895. package/dist/src/tools/write-file.js +42 -35
  896. package/dist/src/tools/write-file.js.map +1 -1
  897. package/dist/src/tools/write-file.test.js +105 -18
  898. package/dist/src/tools/write-file.test.js.map +1 -1
  899. package/dist/src/tools/write-todos.d.ts +1 -30
  900. package/dist/src/tools/write-todos.js +5 -123
  901. package/dist/src/tools/write-todos.js.map +1 -1
  902. package/dist/src/tools/xcode-mcp-fix-transport.d.ts +30 -0
  903. package/dist/src/tools/xcode-mcp-fix-transport.js +82 -0
  904. package/dist/src/tools/xcode-mcp-fix-transport.js.map +1 -0
  905. package/dist/src/tools/xcode-mcp-fix-transport.test.d.ts +1 -0
  906. package/dist/src/tools/xcode-mcp-fix-transport.test.js +98 -0
  907. package/dist/src/tools/xcode-mcp-fix-transport.test.js.map +1 -0
  908. package/dist/src/utils/apiConversionUtils.d.ts +12 -0
  909. package/dist/src/utils/apiConversionUtils.js +46 -0
  910. package/dist/src/utils/apiConversionUtils.js.map +1 -0
  911. package/dist/src/utils/apiConversionUtils.test.d.ts +6 -0
  912. package/dist/src/utils/apiConversionUtils.test.js +150 -0
  913. package/dist/src/utils/apiConversionUtils.test.js.map +1 -0
  914. package/dist/src/utils/authConsent.d.ts +10 -0
  915. package/dist/src/utils/authConsent.js +52 -0
  916. package/dist/src/utils/authConsent.js.map +1 -0
  917. package/dist/src/utils/authConsent.test.d.ts +6 -0
  918. package/dist/src/utils/authConsent.test.js +74 -0
  919. package/dist/src/utils/authConsent.test.js.map +1 -0
  920. package/dist/src/utils/bfsFileSearch.js +2 -0
  921. package/dist/src/utils/bfsFileSearch.js.map +1 -1
  922. package/dist/src/utils/bfsFileSearch.test.js +6 -1
  923. package/dist/src/utils/bfsFileSearch.test.js.map +1 -1
  924. package/dist/src/utils/checkpointUtils.d.ts +2 -2
  925. package/dist/src/utils/checkpointUtils.js +2 -0
  926. package/dist/src/utils/checkpointUtils.js.map +1 -1
  927. package/dist/src/utils/checks.d.ts +19 -0
  928. package/dist/src/utils/checks.js +24 -0
  929. package/dist/src/utils/checks.js.map +1 -0
  930. package/dist/src/utils/checks.test.d.ts +6 -0
  931. package/dist/src/utils/checks.test.js +29 -0
  932. package/dist/src/utils/checks.test.js.map +1 -0
  933. package/dist/src/utils/constants.d.ts +7 -0
  934. package/dist/src/utils/constants.js +8 -0
  935. package/dist/src/utils/constants.js.map +1 -0
  936. package/dist/src/utils/deadlineTimer.d.ts +36 -0
  937. package/dist/src/utils/deadlineTimer.js +87 -0
  938. package/dist/src/utils/deadlineTimer.js.map +1 -0
  939. package/dist/src/utils/deadlineTimer.test.d.ts +6 -0
  940. package/dist/src/utils/deadlineTimer.test.js +64 -0
  941. package/dist/src/utils/deadlineTimer.test.js.map +1 -0
  942. package/dist/src/utils/editCorrector.d.ts +3 -3
  943. package/dist/src/utils/editCorrector.js +37 -10
  944. package/dist/src/utils/editCorrector.js.map +1 -1
  945. package/dist/src/utils/editCorrector.test.js +49 -20
  946. package/dist/src/utils/editCorrector.test.js.map +1 -1
  947. package/dist/src/utils/editor.d.ts +17 -3
  948. package/dist/src/utils/editor.js +84 -15
  949. package/dist/src/utils/editor.js.map +1 -1
  950. package/dist/src/utils/editor.test.js +160 -17
  951. package/dist/src/utils/editor.test.js.map +1 -1
  952. package/dist/src/utils/environmentContext.js +9 -20
  953. package/dist/src/utils/environmentContext.js.map +1 -1
  954. package/dist/src/utils/environmentContext.test.js +31 -14
  955. package/dist/src/utils/environmentContext.test.js.map +1 -1
  956. package/dist/src/utils/errors.d.ts +3 -0
  957. package/dist/src/utils/errors.js +13 -3
  958. package/dist/src/utils/errors.js.map +1 -1
  959. package/dist/src/utils/errors.test.js +23 -1
  960. package/dist/src/utils/errors.test.js.map +1 -1
  961. package/dist/src/utils/events.d.ts +107 -3
  962. package/dist/src/utils/events.js +65 -1
  963. package/dist/src/utils/events.js.map +1 -1
  964. package/dist/src/utils/events.test.js +43 -0
  965. package/dist/src/utils/events.test.js.map +1 -1
  966. package/dist/src/utils/extensionLoader.js +2 -0
  967. package/dist/src/utils/extensionLoader.js.map +1 -1
  968. package/dist/src/utils/extensionLoader.test.js +21 -0
  969. package/dist/src/utils/extensionLoader.test.js.map +1 -1
  970. package/dist/src/utils/fastAckHelper.d.ts +30 -0
  971. package/dist/src/utils/fastAckHelper.js +142 -0
  972. package/dist/src/utils/fastAckHelper.js.map +1 -0
  973. package/dist/src/utils/fastAckHelper.test.d.ts +6 -0
  974. package/dist/src/utils/fastAckHelper.test.js +115 -0
  975. package/dist/src/utils/fastAckHelper.test.js.map +1 -0
  976. package/dist/src/utils/fileDiffUtils.d.ts +18 -0
  977. package/dist/src/utils/fileDiffUtils.js +37 -0
  978. package/dist/src/utils/fileDiffUtils.js.map +1 -0
  979. package/dist/src/utils/fileDiffUtils.test.d.ts +6 -0
  980. package/dist/src/utils/fileDiffUtils.test.js +84 -0
  981. package/dist/src/utils/fileDiffUtils.test.js.map +1 -0
  982. package/dist/src/utils/fileUtils.d.ts +27 -3
  983. package/dist/src/utils/fileUtils.js +104 -60
  984. package/dist/src/utils/fileUtils.js.map +1 -1
  985. package/dist/src/utils/fileUtils.test.js +129 -109
  986. package/dist/src/utils/fileUtils.test.js.map +1 -1
  987. package/dist/src/utils/filesearch/crawler.d.ts +1 -0
  988. package/dist/src/utils/filesearch/crawler.js +18 -1
  989. package/dist/src/utils/filesearch/crawler.js.map +1 -1
  990. package/dist/src/utils/filesearch/crawler.test.js +101 -82
  991. package/dist/src/utils/filesearch/crawler.test.js.map +1 -1
  992. package/dist/src/utils/filesearch/fileSearch.d.ts +4 -3
  993. package/dist/src/utils/filesearch/fileSearch.js +5 -4
  994. package/dist/src/utils/filesearch/fileSearch.js.map +1 -1
  995. package/dist/src/utils/filesearch/fileSearch.test.js +172 -84
  996. package/dist/src/utils/filesearch/fileSearch.test.js.map +1 -1
  997. package/dist/src/utils/filesearch/ignore.d.ts +2 -7
  998. package/dist/src/utils/filesearch/ignore.js +7 -14
  999. package/dist/src/utils/filesearch/ignore.js.map +1 -1
  1000. package/dist/src/utils/filesearch/ignore.test.js +30 -32
  1001. package/dist/src/utils/filesearch/ignore.test.js.map +1 -1
  1002. package/dist/src/utils/formatters.d.ts +1 -1
  1003. package/dist/src/utils/formatters.js +1 -1
  1004. package/dist/src/utils/formatters.js.map +1 -1
  1005. package/dist/src/utils/formatters.test.js +5 -5
  1006. package/dist/src/utils/formatters.test.js.map +1 -1
  1007. package/dist/src/utils/generateContentResponseUtilities.js +3 -0
  1008. package/dist/src/utils/generateContentResponseUtilities.js.map +1 -1
  1009. package/dist/src/utils/getFolderStructure.test.js +5 -2
  1010. package/dist/src/utils/getFolderStructure.test.js.map +1 -1
  1011. package/dist/src/utils/getPty.js +3 -0
  1012. package/dist/src/utils/getPty.js.map +1 -1
  1013. package/dist/src/utils/gitIgnoreParser.js +10 -11
  1014. package/dist/src/utils/gitIgnoreParser.js.map +1 -1
  1015. package/dist/src/utils/googleErrors.js +4 -0
  1016. package/dist/src/utils/googleErrors.js.map +1 -1
  1017. package/dist/src/utils/googleQuotaErrors.d.ts +23 -9
  1018. package/dist/src/utils/googleQuotaErrors.js +90 -23
  1019. package/dist/src/utils/googleQuotaErrors.js.map +1 -1
  1020. package/dist/src/utils/googleQuotaErrors.test.js +168 -23
  1021. package/dist/src/utils/googleQuotaErrors.test.js.map +1 -1
  1022. package/dist/src/utils/headless.d.ts +26 -0
  1023. package/dist/src/utils/headless.js +33 -0
  1024. package/dist/src/utils/headless.js.map +1 -0
  1025. package/dist/src/utils/headless.test.d.ts +6 -0
  1026. package/dist/src/utils/headless.test.js +167 -0
  1027. package/dist/src/utils/headless.test.js.map +1 -0
  1028. package/dist/src/utils/httpErrors.js +4 -1
  1029. package/dist/src/utils/httpErrors.js.map +1 -1
  1030. package/dist/src/utils/ignoreFileParser.d.ts +30 -0
  1031. package/dist/src/utils/ignoreFileParser.js +100 -0
  1032. package/dist/src/utils/ignoreFileParser.js.map +1 -0
  1033. package/dist/src/utils/ignoreFileParser.test.d.ts +6 -0
  1034. package/dist/src/utils/ignoreFileParser.test.js +167 -0
  1035. package/dist/src/utils/ignoreFileParser.test.js.map +1 -0
  1036. package/dist/src/utils/installationManager.test.js +11 -3
  1037. package/dist/src/utils/installationManager.test.js.map +1 -1
  1038. package/dist/src/utils/llm-edit-fixer.js +9 -9
  1039. package/dist/src/utils/llm-edit-fixer.js.map +1 -1
  1040. package/dist/src/utils/llm-edit-fixer.test.js +2 -2
  1041. package/dist/src/utils/llm-edit-fixer.test.js.map +1 -1
  1042. package/dist/src/utils/memoryDiscovery.d.ts +11 -3
  1043. package/dist/src/utils/memoryDiscovery.js +122 -102
  1044. package/dist/src/utils/memoryDiscovery.js.map +1 -1
  1045. package/dist/src/utils/memoryDiscovery.test.js +163 -109
  1046. package/dist/src/utils/memoryDiscovery.test.js.map +1 -1
  1047. package/dist/src/utils/memoryImportProcessor.js +7 -24
  1048. package/dist/src/utils/memoryImportProcessor.js.map +1 -1
  1049. package/dist/src/utils/nextSpeakerChecker.js +3 -0
  1050. package/dist/src/utils/nextSpeakerChecker.js.map +1 -1
  1051. package/dist/src/utils/package.js +10 -3
  1052. package/dist/src/utils/package.js.map +1 -1
  1053. package/dist/src/utils/package.test.d.ts +6 -0
  1054. package/dist/src/utils/package.test.js +57 -0
  1055. package/dist/src/utils/package.test.js.map +1 -0
  1056. package/dist/src/utils/partUtils.js +2 -1
  1057. package/dist/src/utils/partUtils.js.map +1 -1
  1058. package/dist/src/utils/paths.d.ts +33 -9
  1059. package/dist/src/utils/paths.js +88 -29
  1060. package/dist/src/utils/paths.js.map +1 -1
  1061. package/dist/src/utils/paths.test.js +206 -110
  1062. package/dist/src/utils/paths.test.js.map +1 -1
  1063. package/dist/src/utils/planUtils.d.ts +29 -0
  1064. package/dist/src/utils/planUtils.js +55 -0
  1065. package/dist/src/utils/planUtils.js.map +1 -0
  1066. package/dist/src/utils/planUtils.test.d.ts +6 -0
  1067. package/dist/src/utils/planUtils.test.js +76 -0
  1068. package/dist/src/utils/planUtils.test.js.map +1 -0
  1069. package/dist/src/utils/process-utils.d.ts +32 -0
  1070. package/dist/src/utils/process-utils.js +88 -0
  1071. package/dist/src/utils/process-utils.js.map +1 -0
  1072. package/dist/src/utils/process-utils.test.d.ts +6 -0
  1073. package/dist/src/utils/process-utils.test.js +103 -0
  1074. package/dist/src/utils/process-utils.test.js.map +1 -0
  1075. package/dist/src/utils/promptIdContext.d.ts +6 -0
  1076. package/dist/src/utils/promptIdContext.js +15 -0
  1077. package/dist/src/utils/promptIdContext.js.map +1 -1
  1078. package/dist/src/utils/quotaErrorDetection.js +3 -0
  1079. package/dist/src/utils/quotaErrorDetection.js.map +1 -1
  1080. package/dist/src/utils/retry.d.ts +4 -0
  1081. package/dist/src/utils/retry.js +84 -5
  1082. package/dist/src/utils/retry.js.map +1 -1
  1083. package/dist/src/utils/retry.test.js +70 -3
  1084. package/dist/src/utils/retry.test.js.map +1 -1
  1085. package/dist/src/utils/safeJsonStringify.js +1 -0
  1086. package/dist/src/utils/safeJsonStringify.js.map +1 -1
  1087. package/dist/src/utils/schemaValidator.d.ts +8 -1
  1088. package/dist/src/utils/schemaValidator.js +78 -11
  1089. package/dist/src/utils/schemaValidator.js.map +1 -1
  1090. package/dist/src/utils/schemaValidator.test.js +77 -0
  1091. package/dist/src/utils/schemaValidator.test.js.map +1 -1
  1092. package/dist/src/utils/security.d.ts +16 -0
  1093. package/dist/src/utils/security.js +91 -0
  1094. package/dist/src/utils/security.js.map +1 -0
  1095. package/dist/src/utils/security.test.d.ts +1 -0
  1096. package/dist/src/utils/security.test.js +121 -0
  1097. package/dist/src/utils/security.test.js.map +1 -0
  1098. package/dist/src/utils/shell-utils.d.ts +14 -0
  1099. package/dist/src/utils/shell-utils.integration.test.d.ts +1 -0
  1100. package/dist/src/utils/shell-utils.integration.test.js +58 -0
  1101. package/dist/src/utils/shell-utils.integration.test.js.map +1 -0
  1102. package/dist/src/utils/shell-utils.js +191 -30
  1103. package/dist/src/utils/shell-utils.js.map +1 -1
  1104. package/dist/src/utils/shell-utils.test.js +108 -1
  1105. package/dist/src/utils/shell-utils.test.js.map +1 -1
  1106. package/dist/src/utils/summarizer.js +2 -1
  1107. package/dist/src/utils/summarizer.js.map +1 -1
  1108. package/dist/src/utils/terminal.d.ts +4 -0
  1109. package/dist/src/utils/terminal.js +12 -0
  1110. package/dist/src/utils/terminal.js.map +1 -1
  1111. package/dist/src/utils/terminalSerializer.d.ts +1 -1
  1112. package/dist/src/utils/terminalSerializer.js +25 -13
  1113. package/dist/src/utils/terminalSerializer.js.map +1 -1
  1114. package/dist/src/utils/testUtils.js +1 -0
  1115. package/dist/src/utils/testUtils.js.map +1 -1
  1116. package/dist/src/utils/textUtils.d.ts +14 -0
  1117. package/dist/src/utils/textUtils.js +23 -0
  1118. package/dist/src/utils/textUtils.js.map +1 -1
  1119. package/dist/src/utils/textUtils.test.js +18 -1
  1120. package/dist/src/utils/textUtils.test.js.map +1 -1
  1121. package/dist/src/utils/tokenCalculation.d.ts +2 -2
  1122. package/dist/src/utils/tokenCalculation.js +87 -21
  1123. package/dist/src/utils/tokenCalculation.js.map +1 -1
  1124. package/dist/src/utils/tokenCalculation.test.js +189 -76
  1125. package/dist/src/utils/tokenCalculation.test.js.map +1 -1
  1126. package/dist/src/utils/tool-utils.d.ts +26 -0
  1127. package/dist/src/utils/tool-utils.js +36 -0
  1128. package/dist/src/utils/tool-utils.js.map +1 -1
  1129. package/dist/src/utils/tool-utils.test.js +73 -3
  1130. package/dist/src/utils/tool-utils.test.js.map +1 -1
  1131. package/dist/src/utils/toolCallContext.d.ts +35 -0
  1132. package/dist/src/utils/toolCallContext.js +29 -0
  1133. package/dist/src/utils/toolCallContext.js.map +1 -0
  1134. package/dist/src/utils/toolCallContext.test.d.ts +6 -0
  1135. package/dist/src/utils/toolCallContext.test.js +68 -0
  1136. package/dist/src/utils/toolCallContext.test.js.map +1 -0
  1137. package/dist/src/utils/userAccountManager.js +1 -0
  1138. package/dist/src/utils/userAccountManager.js.map +1 -1
  1139. package/dist/src/utils/userAccountManager.test.js +5 -5
  1140. package/dist/src/utils/userAccountManager.test.js.map +1 -1
  1141. package/dist/src/utils/version.d.ts +2 -0
  1142. package/dist/src/utils/version.js +14 -3
  1143. package/dist/src/utils/version.js.map +1 -1
  1144. package/dist/src/utils/version.test.js +15 -1
  1145. package/dist/src/utils/version.test.js.map +1 -1
  1146. package/dist/src/utils/workspaceContext.d.ts +28 -0
  1147. package/dist/src/utils/workspaceContext.js +74 -9
  1148. package/dist/src/utils/workspaceContext.js.map +1 -1
  1149. package/dist/src/utils/workspaceContext.test.js +56 -1
  1150. package/dist/src/utils/workspaceContext.test.js.map +1 -1
  1151. package/dist/tsconfig.tsbuildinfo +1 -1
  1152. package/package.json +25 -15
@@ -6,9 +6,10 @@
6
6
  import fs from 'node:fs';
7
7
  import fsPromises from 'node:fs/promises';
8
8
  import path from 'node:path';
9
- import { EOL } from 'node:os';
10
9
  import { spawn } from 'node:child_process';
11
10
  import { globStream } from 'glob';
11
+ import { execStreaming } from '../utils/shell-utils.js';
12
+ import { DEFAULT_TOTAL_MAX_MATCHES, DEFAULT_SEARCH_TIMEOUT_MS, } from './constants.js';
12
13
  import { BaseDeclarativeTool, BaseToolInvocation, Kind } from './tools.js';
13
14
  import { makeRelative, shortenPath } from '../utils/paths.js';
14
15
  import { getErrorMessage, isNodeError } from '../utils/errors.js';
@@ -16,6 +17,8 @@ import { isGitRepository } from '../utils/gitUtils.js';
16
17
  import { ToolErrorType } from './tool-error.js';
17
18
  import { GREP_TOOL_NAME } from './tool-names.js';
18
19
  import { debugLogger } from '../utils/debugLogger.js';
20
+ import { GREP_DEFINITION } from './definitions/coreTools.js';
21
+ import { resolveToolDeclaration } from './definitions/resolver.js';
19
22
  class GrepToolInvocation extends BaseToolInvocation {
20
23
  config;
21
24
  fileExclusions;
@@ -25,43 +28,94 @@ class GrepToolInvocation extends BaseToolInvocation {
25
28
  this.fileExclusions = config.getFileExclusions();
26
29
  }
27
30
  /**
28
- * Checks if a path is within the root directory and resolves it.
29
- * @param relativePath Path relative to the root directory (or undefined for root).
30
- * @returns The absolute path if valid and exists, or null if no path specified (to search all directories).
31
- * @throws {Error} If path is outside root, doesn't exist, or isn't a directory.
31
+ * Parses a single line of grep-like output (git grep, system grep).
32
+ * Expects format: filePath:lineNumber:lineContent
33
+ * @param {string} line The line to parse.
34
+ * @param {string} basePath The absolute directory for path resolution.
35
+ * @returns {GrepMatch | null} Parsed match or null if malformed.
32
36
  */
33
- resolveAndValidatePath(relativePath) {
34
- // If no path specified, return null to indicate searching all workspace directories
35
- if (!relativePath) {
37
+ parseGrepLine(line, basePath) {
38
+ if (!line.trim())
36
39
  return null;
37
- }
38
- const targetPath = path.resolve(this.config.getTargetDir(), relativePath);
39
- // Security Check: Ensure the resolved path is within workspace boundaries
40
- const workspaceContext = this.config.getWorkspaceContext();
41
- if (!workspaceContext.isPathWithinWorkspace(targetPath)) {
42
- const directories = workspaceContext.getDirectories();
43
- throw new Error(`Path validation failed: Attempted path "${relativePath}" resolves outside the allowed workspace directories: ${directories.join(', ')}`);
44
- }
45
- // Check existence and type after resolving
46
- try {
47
- const stats = fs.statSync(targetPath);
48
- if (!stats.isDirectory()) {
49
- throw new Error(`Path is not a directory: ${targetPath}`);
50
- }
51
- }
52
- catch (error) {
53
- if (isNodeError(error) && error.code !== 'ENOENT') {
54
- throw new Error(`Path does not exist: ${targetPath}`);
40
+ // Use regex to locate the first occurrence of :<digits>:
41
+ // This allows filenames to contain colons, as long as they don't look like :<digits>:
42
+ // Note: This regex assumes filenames do not contain colons, or at least not followed by digits.
43
+ const match = line.match(/^(.+?):(\d+):(.*)$/);
44
+ if (!match)
45
+ return null;
46
+ const [, filePathRaw, lineNumberStr, lineContent] = match;
47
+ const lineNumber = parseInt(lineNumberStr, 10);
48
+ if (!isNaN(lineNumber)) {
49
+ const absoluteFilePath = path.resolve(basePath, filePathRaw);
50
+ const relativeCheck = path.relative(basePath, absoluteFilePath);
51
+ if (relativeCheck === '..' ||
52
+ relativeCheck.startsWith(`..${path.sep}`) ||
53
+ path.isAbsolute(relativeCheck)) {
54
+ return null;
55
55
  }
56
- throw new Error(`Failed to access path stats for ${targetPath}: ${error}`);
56
+ const relativeFilePath = path.relative(basePath, absoluteFilePath);
57
+ return {
58
+ filePath: relativeFilePath || path.basename(absoluteFilePath),
59
+ lineNumber,
60
+ line: lineContent,
61
+ };
57
62
  }
58
- return targetPath;
63
+ return null;
59
64
  }
60
65
  async execute(signal) {
61
66
  try {
62
67
  const workspaceContext = this.config.getWorkspaceContext();
63
- const searchDirAbs = this.resolveAndValidatePath(this.params.dir_path);
64
- const searchDirDisplay = this.params.dir_path || '.';
68
+ const pathParam = this.params.dir_path;
69
+ let searchDirAbs = null;
70
+ if (pathParam) {
71
+ searchDirAbs = path.resolve(this.config.getTargetDir(), pathParam);
72
+ const validationError = this.config.validatePathAccess(searchDirAbs, 'read');
73
+ if (validationError) {
74
+ return {
75
+ llmContent: validationError,
76
+ returnDisplay: 'Error: Path not in workspace.',
77
+ error: {
78
+ message: validationError,
79
+ type: ToolErrorType.PATH_NOT_IN_WORKSPACE,
80
+ },
81
+ };
82
+ }
83
+ try {
84
+ const stats = await fsPromises.stat(searchDirAbs);
85
+ if (!stats.isDirectory()) {
86
+ return {
87
+ llmContent: `Path is not a directory: ${searchDirAbs}`,
88
+ returnDisplay: 'Error: Path is not a directory.',
89
+ error: {
90
+ message: `Path is not a directory: ${searchDirAbs}`,
91
+ type: ToolErrorType.PATH_IS_NOT_A_DIRECTORY,
92
+ },
93
+ };
94
+ }
95
+ }
96
+ catch (error) {
97
+ if (isNodeError(error) && error.code === 'ENOENT') {
98
+ return {
99
+ llmContent: `Path does not exist: ${searchDirAbs}`,
100
+ returnDisplay: 'Error: Path does not exist.',
101
+ error: {
102
+ message: `Path does not exist: ${searchDirAbs}`,
103
+ type: ToolErrorType.FILE_NOT_FOUND,
104
+ },
105
+ };
106
+ }
107
+ const errorMessage = getErrorMessage(error);
108
+ return {
109
+ llmContent: `Failed to access path stats for ${searchDirAbs}: ${errorMessage}`,
110
+ returnDisplay: 'Error: Failed to access path.',
111
+ error: {
112
+ message: `Failed to access path stats for ${searchDirAbs}: ${errorMessage}`,
113
+ type: ToolErrorType.GREP_EXECUTION_ERROR,
114
+ },
115
+ };
116
+ }
117
+ }
118
+ const searchDirDisplay = pathParam || '.';
65
119
  // Determine which directories to search
66
120
  let searchDirectories;
67
121
  if (searchDirAbs === null) {
@@ -74,21 +128,47 @@ class GrepToolInvocation extends BaseToolInvocation {
74
128
  }
75
129
  // Collect matches from all search directories
76
130
  let allMatches = [];
77
- for (const searchDir of searchDirectories) {
78
- const matches = await this.performGrepSearch({
79
- pattern: this.params.pattern,
80
- path: searchDir,
81
- include: this.params.include,
82
- signal,
83
- });
84
- // Add directory prefix if searching multiple directories
85
- if (searchDirectories.length > 1) {
86
- const dirName = path.basename(searchDir);
87
- matches.forEach((match) => {
88
- match.filePath = path.join(dirName, match.filePath);
131
+ const totalMaxMatches = this.params.total_max_matches ?? DEFAULT_TOTAL_MAX_MATCHES;
132
+ // Create a timeout controller to prevent indefinitely hanging searches
133
+ const timeoutController = new AbortController();
134
+ const timeoutId = setTimeout(() => {
135
+ timeoutController.abort();
136
+ }, DEFAULT_SEARCH_TIMEOUT_MS);
137
+ // Link the passed signal to our timeout controller
138
+ const onAbort = () => timeoutController.abort();
139
+ if (signal.aborted) {
140
+ onAbort();
141
+ }
142
+ else {
143
+ signal.addEventListener('abort', onAbort, { once: true });
144
+ }
145
+ try {
146
+ for (const searchDir of searchDirectories) {
147
+ const remainingLimit = totalMaxMatches - allMatches.length;
148
+ if (remainingLimit <= 0)
149
+ break;
150
+ const matches = await this.performGrepSearch({
151
+ pattern: this.params.pattern,
152
+ path: searchDir,
153
+ include: this.params.include,
154
+ exclude_pattern: this.params.exclude_pattern,
155
+ maxMatches: remainingLimit,
156
+ max_matches_per_file: this.params.max_matches_per_file,
157
+ signal: timeoutController.signal,
89
158
  });
159
+ // Add directory prefix if searching multiple directories
160
+ if (searchDirectories.length > 1) {
161
+ const dirName = path.basename(searchDir);
162
+ matches.forEach((match) => {
163
+ match.filePath = path.join(dirName, match.filePath);
164
+ });
165
+ }
166
+ allMatches = allMatches.concat(matches);
90
167
  }
91
- allMatches = allMatches.concat(matches);
168
+ }
169
+ finally {
170
+ clearTimeout(timeoutId);
171
+ signal.removeEventListener('abort', onAbort);
92
172
  }
93
173
  let searchLocationDescription;
94
174
  if (searchDirAbs === null) {
@@ -105,6 +185,7 @@ class GrepToolInvocation extends BaseToolInvocation {
105
185
  const noMatchMsg = `No matches found for pattern "${this.params.pattern}" ${searchLocationDescription}${this.params.include ? ` (filter: "${this.params.include}")` : ''}.`;
106
186
  return { llmContent: noMatchMsg, returnDisplay: `No matches found` };
107
187
  }
188
+ const wasTruncated = allMatches.length >= totalMaxMatches;
108
189
  // Group matches by file
109
190
  const matchesByFile = allMatches.reduce((acc, match) => {
110
191
  const fileKey = match.filePath;
@@ -117,11 +198,23 @@ class GrepToolInvocation extends BaseToolInvocation {
117
198
  }, {});
118
199
  const matchCount = allMatches.length;
119
200
  const matchTerm = matchCount === 1 ? 'match' : 'matches';
120
- let llmContent = `Found ${matchCount} ${matchTerm} for pattern "${this.params.pattern}" ${searchLocationDescription}${this.params.include ? ` (filter: "${this.params.include}")` : ''}:
121
- ---
122
- `;
201
+ if (this.params.names_only) {
202
+ const filePaths = Object.keys(matchesByFile).sort();
203
+ let llmContent = `Found ${filePaths.length} files with matches for pattern "${this.params.pattern}" ${searchLocationDescription}${this.params.include ? ` (filter: "${this.params.include}")` : ''}${wasTruncated ? ` (results limited to ${totalMaxMatches} matches for performance)` : ''}:\n`;
204
+ llmContent += filePaths.join('\n');
205
+ return {
206
+ llmContent: llmContent.trim(),
207
+ returnDisplay: `Found ${filePaths.length} files${wasTruncated ? ' (limited)' : ''}`,
208
+ };
209
+ }
210
+ let llmContent = `Found ${matchCount} ${matchTerm} for pattern "${this.params.pattern}" ${searchLocationDescription}${this.params.include ? ` (filter: "${this.params.include}")` : ''}`;
211
+ if (wasTruncated) {
212
+ llmContent += ` (results limited to ${totalMaxMatches} matches for performance)`;
213
+ }
214
+ llmContent += `:\n---\n`;
123
215
  for (const filePath in matchesByFile) {
124
- llmContent += `File: ${filePath}\n`;
216
+ llmContent += `File: ${filePath}
217
+ `;
125
218
  matchesByFile[filePath].forEach((match) => {
126
219
  const trimmedLine = match.line.trim();
127
220
  llmContent += `L${match.lineNumber}: ${trimmedLine}\n`;
@@ -130,7 +223,7 @@ class GrepToolInvocation extends BaseToolInvocation {
130
223
  }
131
224
  return {
132
225
  llmContent: llmContent.trim(),
133
- returnDisplay: `Found ${matchCount} ${matchTerm}`,
226
+ returnDisplay: `Found ${matchCount} ${matchTerm}${wasTruncated ? ' (limited)' : ''}`,
134
227
  };
135
228
  }
136
229
  catch (error) {
@@ -171,86 +264,19 @@ class GrepToolInvocation extends BaseToolInvocation {
171
264
  }
172
265
  });
173
266
  }
174
- /**
175
- * Parses the standard output of grep-like commands (git grep, system grep).
176
- * Expects format: filePath:lineNumber:lineContent
177
- * Handles colons within file paths and line content correctly.
178
- * @param {string} output The raw stdout string.
179
- * @param {string} basePath The absolute directory the search was run from, for relative paths.
180
- * @returns {GrepMatch[]} Array of match objects.
181
- */
182
- parseGrepOutput(output, basePath) {
183
- const results = [];
184
- if (!output)
185
- return results;
186
- const lines = output.split(EOL); // Use OS-specific end-of-line
187
- for (const line of lines) {
188
- if (!line.trim())
189
- continue;
190
- // Find the index of the first colon.
191
- const firstColonIndex = line.indexOf(':');
192
- if (firstColonIndex === -1)
193
- continue; // Malformed
194
- // Find the index of the second colon, searching *after* the first one.
195
- const secondColonIndex = line.indexOf(':', firstColonIndex + 1);
196
- if (secondColonIndex === -1)
197
- continue; // Malformed
198
- // Extract parts based on the found colon indices
199
- const filePathRaw = line.substring(0, firstColonIndex);
200
- const lineNumberStr = line.substring(firstColonIndex + 1, secondColonIndex);
201
- const lineContent = line.substring(secondColonIndex + 1);
202
- const lineNumber = parseInt(lineNumberStr, 10);
203
- if (!isNaN(lineNumber)) {
204
- const absoluteFilePath = path.resolve(basePath, filePathRaw);
205
- const relativeFilePath = path.relative(basePath, absoluteFilePath);
206
- results.push({
207
- filePath: relativeFilePath || path.basename(absoluteFilePath),
208
- lineNumber,
209
- line: lineContent,
210
- });
211
- }
212
- }
213
- return results;
214
- }
215
- /**
216
- * Gets a description of the grep operation
217
- * @returns A string describing the grep
218
- */
219
- getDescription() {
220
- let description = `'${this.params.pattern}'`;
221
- if (this.params.include) {
222
- description += ` in ${this.params.include}`;
223
- }
224
- if (this.params.dir_path) {
225
- const resolvedPath = path.resolve(this.config.getTargetDir(), this.params.dir_path);
226
- if (resolvedPath === this.config.getTargetDir() ||
227
- this.params.dir_path === '.') {
228
- description += ` within ./`;
229
- }
230
- else {
231
- const relativePath = makeRelative(resolvedPath, this.config.getTargetDir());
232
- description += ` within ${shortenPath(relativePath)}`;
233
- }
234
- }
235
- else {
236
- // When no path is specified, indicate searching all workspace directories
237
- const workspaceContext = this.config.getWorkspaceContext();
238
- const directories = workspaceContext.getDirectories();
239
- if (directories.length > 1) {
240
- description += ` across all workspace directories`;
241
- }
242
- }
243
- return description;
244
- }
245
267
  /**
246
268
  * Performs the actual search using the prioritized strategies.
247
269
  * @param options Search options including pattern, absolute path, and include glob.
248
270
  * @returns A promise resolving to an array of match objects.
249
271
  */
250
272
  async performGrepSearch(options) {
251
- const { pattern, path: absolutePath, include } = options;
273
+ const { pattern, path: absolutePath, include, exclude_pattern, maxMatches, max_matches_per_file, } = options;
252
274
  let strategyUsed = 'none';
253
275
  try {
276
+ let excludeRegex = null;
277
+ if (exclude_pattern) {
278
+ excludeRegex = new RegExp(exclude_pattern, 'i');
279
+ }
254
280
  // --- Strategy 1: git grep ---
255
281
  const isGit = isGitRepository(absolutePath);
256
282
  const gitAvailable = isGit && (await this.isCommandAvailable('git'));
@@ -264,32 +290,32 @@ class GrepToolInvocation extends BaseToolInvocation {
264
290
  '--ignore-case',
265
291
  pattern,
266
292
  ];
293
+ if (max_matches_per_file) {
294
+ gitArgs.push('--max-count', max_matches_per_file.toString());
295
+ }
267
296
  if (include) {
268
297
  gitArgs.push('--', include);
269
298
  }
270
299
  try {
271
- const output = await new Promise((resolve, reject) => {
272
- const child = spawn('git', gitArgs, {
273
- cwd: absolutePath,
274
- windowsHide: true,
275
- });
276
- const stdoutChunks = [];
277
- const stderrChunks = [];
278
- child.stdout.on('data', (chunk) => stdoutChunks.push(chunk));
279
- child.stderr.on('data', (chunk) => stderrChunks.push(chunk));
280
- child.on('error', (err) => reject(new Error(`Failed to start git grep: ${err.message}`)));
281
- child.on('close', (code) => {
282
- const stdoutData = Buffer.concat(stdoutChunks).toString('utf8');
283
- const stderrData = Buffer.concat(stderrChunks).toString('utf8');
284
- if (code === 0)
285
- resolve(stdoutData);
286
- else if (code === 1)
287
- resolve(''); // No matches
288
- else
289
- reject(new Error(`git grep exited with code ${code}: ${stderrData}`));
290
- });
300
+ const generator = execStreaming('git', gitArgs, {
301
+ cwd: absolutePath,
302
+ signal: options.signal,
303
+ allowedExitCodes: [0, 1],
291
304
  });
292
- return this.parseGrepOutput(output, absolutePath);
305
+ const results = [];
306
+ for await (const line of generator) {
307
+ const match = this.parseGrepLine(line, absolutePath);
308
+ if (match) {
309
+ if (excludeRegex && excludeRegex.test(match.line)) {
310
+ continue;
311
+ }
312
+ results.push(match);
313
+ if (results.length >= maxMatches) {
314
+ break;
315
+ }
316
+ }
317
+ }
318
+ return results;
293
319
  }
294
320
  catch (gitError) {
295
321
  debugLogger.debug(`GrepLogic: git grep failed: ${getErrorMessage(gitError)}. Falling back...`);
@@ -323,66 +349,40 @@ class GrepToolInvocation extends BaseToolInvocation {
323
349
  })
324
350
  .filter((dir) => !!dir);
325
351
  commonExcludes.forEach((dir) => grepArgs.push(`--exclude-dir=${dir}`));
352
+ if (max_matches_per_file) {
353
+ grepArgs.push('--max-count', max_matches_per_file.toString());
354
+ }
326
355
  if (include) {
327
356
  grepArgs.push(`--include=${include}`);
328
357
  }
329
358
  grepArgs.push(pattern);
330
359
  grepArgs.push('.');
360
+ const results = [];
331
361
  try {
332
- const output = await new Promise((resolve, reject) => {
333
- const child = spawn('grep', grepArgs, {
334
- cwd: absolutePath,
335
- windowsHide: true,
336
- });
337
- const stdoutChunks = [];
338
- const stderrChunks = [];
339
- const onData = (chunk) => stdoutChunks.push(chunk);
340
- const onStderr = (chunk) => {
341
- const stderrStr = chunk.toString();
342
- // Suppress common harmless stderr messages
343
- if (!stderrStr.includes('Permission denied') &&
344
- !/grep:.*: Is a directory/i.test(stderrStr)) {
345
- stderrChunks.push(chunk);
346
- }
347
- };
348
- const onError = (err) => {
349
- cleanup();
350
- reject(new Error(`Failed to start system grep: ${err.message}`));
351
- };
352
- const onClose = (code) => {
353
- const stdoutData = Buffer.concat(stdoutChunks).toString('utf8');
354
- const stderrData = Buffer.concat(stderrChunks)
355
- .toString('utf8')
356
- .trim();
357
- cleanup();
358
- if (code === 0)
359
- resolve(stdoutData);
360
- else if (code === 1)
361
- resolve(''); // No matches
362
- else {
363
- if (stderrData)
364
- reject(new Error(`System grep exited with code ${code}: ${stderrData}`));
365
- else
366
- resolve(''); // Exit code > 1 but no stderr, likely just suppressed errors
362
+ const generator = execStreaming('grep', grepArgs, {
363
+ cwd: absolutePath,
364
+ signal: options.signal,
365
+ allowedExitCodes: [0, 1],
366
+ });
367
+ for await (const line of generator) {
368
+ const match = this.parseGrepLine(line, absolutePath);
369
+ if (match) {
370
+ if (excludeRegex && excludeRegex.test(match.line)) {
371
+ continue;
367
372
  }
368
- };
369
- const cleanup = () => {
370
- child.stdout.removeListener('data', onData);
371
- child.stderr.removeListener('data', onStderr);
372
- child.removeListener('error', onError);
373
- child.removeListener('close', onClose);
374
- if (child.connected) {
375
- child.disconnect();
373
+ results.push(match);
374
+ if (results.length >= maxMatches) {
375
+ break;
376
376
  }
377
- };
378
- child.stdout.on('data', onData);
379
- child.stderr.on('data', onStderr);
380
- child.on('error', onError);
381
- child.on('close', onClose);
382
- });
383
- return this.parseGrepOutput(output, absolutePath);
377
+ }
378
+ }
379
+ return results;
384
380
  }
385
381
  catch (grepError) {
382
+ if (grepError instanceof Error &&
383
+ /Permission denied|Is a directory/i.test(grepError.message)) {
384
+ return results;
385
+ }
386
386
  debugLogger.debug(`GrepLogic: System grep failed: ${getErrorMessage(grepError)}. Falling back...`);
387
387
  }
388
388
  }
@@ -402,20 +402,40 @@ class GrepToolInvocation extends BaseToolInvocation {
402
402
  const regex = new RegExp(pattern, 'i');
403
403
  const allMatches = [];
404
404
  for await (const filePath of filesStream) {
405
+ if (allMatches.length >= maxMatches)
406
+ break;
405
407
  const fileAbsolutePath = filePath;
408
+ // security check
409
+ const relativePath = path.relative(absolutePath, fileAbsolutePath);
410
+ if (relativePath === '..' ||
411
+ relativePath.startsWith(`..${path.sep}`) ||
412
+ path.isAbsolute(relativePath))
413
+ continue;
406
414
  try {
407
415
  const content = await fsPromises.readFile(fileAbsolutePath, 'utf8');
408
416
  const lines = content.split(/\r?\n/);
409
- lines.forEach((line, index) => {
417
+ let matchesInFile = 0;
418
+ for (let index = 0; index < lines.length; index++) {
419
+ const line = lines[index];
410
420
  if (regex.test(line)) {
421
+ if (excludeRegex && excludeRegex.test(line)) {
422
+ continue;
423
+ }
411
424
  allMatches.push({
412
425
  filePath: path.relative(absolutePath, fileAbsolutePath) ||
413
426
  path.basename(fileAbsolutePath),
414
427
  lineNumber: index + 1,
415
428
  line,
416
429
  });
430
+ matchesInFile++;
431
+ if (allMatches.length >= maxMatches)
432
+ break;
433
+ if (max_matches_per_file &&
434
+ matchesInFile >= max_matches_per_file) {
435
+ break;
436
+ }
417
437
  }
418
- });
438
+ }
419
439
  }
420
440
  catch (readError) {
421
441
  // Ignore errors like permission denied or file gone during read
@@ -431,8 +451,33 @@ class GrepToolInvocation extends BaseToolInvocation {
431
451
  throw error; // Re-throw
432
452
  }
433
453
  }
454
+ getDescription() {
455
+ let description = `'${this.params.pattern}'`;
456
+ if (this.params.include) {
457
+ description += ` in ${this.params.include}`;
458
+ }
459
+ if (this.params.dir_path) {
460
+ const resolvedPath = path.resolve(this.config.getTargetDir(), this.params.dir_path);
461
+ if (resolvedPath === this.config.getTargetDir() ||
462
+ this.params.dir_path === '.') {
463
+ description += ` within ./`;
464
+ }
465
+ else {
466
+ const relativePath = makeRelative(resolvedPath, this.config.getTargetDir());
467
+ description += ` within ${shortenPath(relativePath)}`;
468
+ }
469
+ }
470
+ else {
471
+ // When no path is specified, indicate searching all workspace directories
472
+ const workspaceContext = this.config.getWorkspaceContext();
473
+ const directories = workspaceContext.getDirectories();
474
+ if (directories.length > 1) {
475
+ description += ` across all workspace directories`;
476
+ }
477
+ }
478
+ return description;
479
+ }
434
480
  }
435
- // --- GrepLogic Class ---
436
481
  /**
437
482
  * Implementation of the Grep tool logic (moved from CLI)
438
483
  */
@@ -440,59 +485,9 @@ export class GrepTool extends BaseDeclarativeTool {
440
485
  config;
441
486
  static Name = GREP_TOOL_NAME;
442
487
  constructor(config, messageBus) {
443
- super(GrepTool.Name, 'SearchText', 'Searches for a regular expression pattern within the content of files in a specified directory (or current working directory). Can filter files by a glob pattern. Returns the lines containing matches, along with their file paths and line numbers.', Kind.Search, {
444
- properties: {
445
- pattern: {
446
- description: "The regular expression (regex) pattern to search for within file contents (e.g., 'function\\s+myFunction', 'import\\s+\\{.*\\}\\s+from\\s+.*').",
447
- type: 'string',
448
- },
449
- dir_path: {
450
- description: 'Optional: The absolute path to the directory to search within. If omitted, searches the current working directory.',
451
- type: 'string',
452
- },
453
- include: {
454
- description: "Optional: A glob pattern to filter which files are searched (e.g., '*.js', '*.{ts,tsx}', 'src/**'). If omitted, searches all files (respecting potential global ignores).",
455
- type: 'string',
456
- },
457
- },
458
- required: ['pattern'],
459
- type: 'object',
460
- }, messageBus, true, false);
488
+ super(GrepTool.Name, 'SearchText', GREP_DEFINITION.base.description, Kind.Search, GREP_DEFINITION.base.parametersJsonSchema, messageBus, true, false);
461
489
  this.config = config;
462
490
  }
463
- /**
464
- * Checks if a path is within the root directory and resolves it.
465
- * @param relativePath Path relative to the root directory (or undefined for root).
466
- * @returns The absolute path if valid and exists, or null if no path specified (to search all directories).
467
- * @throws {Error} If path is outside root, doesn't exist, or isn't a directory.
468
- */
469
- resolveAndValidatePath(relativePath) {
470
- // If no path specified, return null to indicate searching all workspace directories
471
- if (!relativePath) {
472
- return null;
473
- }
474
- const targetPath = path.resolve(this.config.getTargetDir(), relativePath);
475
- // Security Check: Ensure the resolved path is within workspace boundaries
476
- const workspaceContext = this.config.getWorkspaceContext();
477
- if (!workspaceContext.isPathWithinWorkspace(targetPath)) {
478
- const directories = workspaceContext.getDirectories();
479
- throw new Error(`Path validation failed: Attempted path "${relativePath}" resolves outside the allowed workspace directories: ${directories.join(', ')}`);
480
- }
481
- // Check existence and type after resolving
482
- try {
483
- const stats = fs.statSync(targetPath);
484
- if (!stats.isDirectory()) {
485
- throw new Error(`Path is not a directory: ${targetPath}`);
486
- }
487
- }
488
- catch (error) {
489
- if (isNodeError(error) && error.code !== 'ENOENT') {
490
- throw new Error(`Path does not exist: ${targetPath}`);
491
- }
492
- throw new Error(`Failed to access path stats for ${targetPath}: ${error}`);
493
- }
494
- return targetPath;
495
- }
496
491
  /**
497
492
  * Validates the parameters for the tool
498
493
  * @param params Parameters to validate
@@ -505,13 +500,41 @@ export class GrepTool extends BaseDeclarativeTool {
505
500
  catch (error) {
506
501
  return `Invalid regular expression pattern provided: ${params.pattern}. Error: ${getErrorMessage(error)}`;
507
502
  }
503
+ if (params.exclude_pattern) {
504
+ try {
505
+ new RegExp(params.exclude_pattern);
506
+ }
507
+ catch (error) {
508
+ return `Invalid exclude regular expression pattern provided: ${params.exclude_pattern}. Error: ${getErrorMessage(error)}`;
509
+ }
510
+ }
511
+ if (params.max_matches_per_file !== undefined &&
512
+ params.max_matches_per_file < 1) {
513
+ return 'max_matches_per_file must be at least 1.';
514
+ }
515
+ if (params.total_max_matches !== undefined &&
516
+ params.total_max_matches < 1) {
517
+ return 'total_max_matches must be at least 1.';
518
+ }
508
519
  // Only validate dir_path if one is provided
509
520
  if (params.dir_path) {
521
+ const resolvedPath = path.resolve(this.config.getTargetDir(), params.dir_path);
522
+ const validationError = this.config.validatePathAccess(resolvedPath, 'read');
523
+ if (validationError) {
524
+ return validationError;
525
+ }
526
+ // We still want to check if it's a directory
510
527
  try {
511
- this.resolveAndValidatePath(params.dir_path);
528
+ const stats = fs.statSync(resolvedPath);
529
+ if (!stats.isDirectory()) {
530
+ return `Path is not a directory: ${resolvedPath}`;
531
+ }
512
532
  }
513
533
  catch (error) {
514
- return getErrorMessage(error);
534
+ if (isNodeError(error) && error.code === 'ENOENT') {
535
+ return `Path does not exist: ${resolvedPath}`;
536
+ }
537
+ return `Failed to access path stats for ${resolvedPath}: ${getErrorMessage(error)}`;
515
538
  }
516
539
  }
517
540
  return null; // Parameters are valid
@@ -519,5 +542,8 @@ export class GrepTool extends BaseDeclarativeTool {
519
542
  createInvocation(params, messageBus, _toolName, _toolDisplayName) {
520
543
  return new GrepToolInvocation(this.config, params, messageBus, _toolName, _toolDisplayName);
521
544
  }
545
+ getSchema(modelId) {
546
+ return resolveToolDeclaration(GREP_DEFINITION, modelId);
547
+ }
522
548
  }
523
549
  //# sourceMappingURL=grep.js.map