@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
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/agents/auth-provider/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}
@@ -0,0 +1,29 @@
1
+ /**
2
+ * @license
3
+ * Copyright 2026 Google LLC
4
+ * SPDX-License-Identifier: Apache-2.0
5
+ */
6
+ /**
7
+ * Resolves a value that may be an environment variable reference,
8
+ * a shell command, or a literal value.
9
+ *
10
+ * Supported formats:
11
+ * - `$ENV_VAR`: Read from environment variable
12
+ * - `!command`: Execute shell command and use output (trimmed)
13
+ * - `$$` or `!!`: Escape prefix, returns rest as literal
14
+ * - Any other string: Use as literal value
15
+ *
16
+ * @param value The value to resolve
17
+ * @returns The resolved value
18
+ * @throws Error if environment variable is not set or command fails
19
+ */
20
+ export declare function resolveAuthValue(value: string): Promise<string>;
21
+ /**
22
+ * Check if a value needs resolution (is an env var or command reference).
23
+ */
24
+ export declare function needsResolution(value: string): boolean;
25
+ /**
26
+ * Mask a sensitive value for logging purposes.
27
+ * Shows the first and last 2 characters with asterisks in between.
28
+ */
29
+ export declare function maskSensitiveValue(value: string): string;
@@ -0,0 +1,85 @@
1
+ /**
2
+ * @license
3
+ * Copyright 2026 Google LLC
4
+ * SPDX-License-Identifier: Apache-2.0
5
+ */
6
+ import { debugLogger } from '../../utils/debugLogger.js';
7
+ import { getShellConfiguration, spawnAsync } from '../../utils/shell-utils.js';
8
+ const COMMAND_TIMEOUT_MS = 60_000;
9
+ /**
10
+ * Resolves a value that may be an environment variable reference,
11
+ * a shell command, or a literal value.
12
+ *
13
+ * Supported formats:
14
+ * - `$ENV_VAR`: Read from environment variable
15
+ * - `!command`: Execute shell command and use output (trimmed)
16
+ * - `$$` or `!!`: Escape prefix, returns rest as literal
17
+ * - Any other string: Use as literal value
18
+ *
19
+ * @param value The value to resolve
20
+ * @returns The resolved value
21
+ * @throws Error if environment variable is not set or command fails
22
+ */
23
+ export async function resolveAuthValue(value) {
24
+ // Support escaping with double prefix (e.g. $$ or !!).
25
+ // Strips one prefix char: $$FOO → $FOO, !!cmd → !cmd (literal, not resolved).
26
+ if (value.startsWith('$$') || value.startsWith('!!')) {
27
+ return value.slice(1);
28
+ }
29
+ // Environment variable: $MY_VAR
30
+ if (value.startsWith('$')) {
31
+ const envVar = value.slice(1);
32
+ const resolved = process.env[envVar];
33
+ if (resolved === undefined || resolved === '') {
34
+ throw new Error(`Environment variable '${envVar}' is not set or is empty. ` +
35
+ `Please set it before using this agent.`);
36
+ }
37
+ debugLogger.debug(`[AuthValueResolver] Resolved env var: ${envVar}`);
38
+ return resolved;
39
+ }
40
+ // Shell command: !command arg1 arg2
41
+ if (value.startsWith('!')) {
42
+ const command = value.slice(1).trim();
43
+ if (!command) {
44
+ throw new Error('Empty command in auth value. Expected format: !command');
45
+ }
46
+ debugLogger.debug(`[AuthValueResolver] Executing command for auth value`);
47
+ const shellConfig = getShellConfiguration();
48
+ try {
49
+ const { stdout } = await spawnAsync(shellConfig.executable, [...shellConfig.argsPrefix, command], {
50
+ signal: AbortSignal.timeout(COMMAND_TIMEOUT_MS),
51
+ windowsHide: true,
52
+ });
53
+ const trimmed = stdout.trim();
54
+ if (!trimmed) {
55
+ throw new Error(`Command '${command}' returned empty output`);
56
+ }
57
+ return trimmed;
58
+ }
59
+ catch (error) {
60
+ if (error instanceof Error && error.name === 'AbortError') {
61
+ throw new Error(`Command '${command}' timed out after ${COMMAND_TIMEOUT_MS / 1000} seconds`);
62
+ }
63
+ throw error;
64
+ }
65
+ }
66
+ // Literal value - return as-is
67
+ return value;
68
+ }
69
+ /**
70
+ * Check if a value needs resolution (is an env var or command reference).
71
+ */
72
+ export function needsResolution(value) {
73
+ return value.startsWith('$') || value.startsWith('!');
74
+ }
75
+ /**
76
+ * Mask a sensitive value for logging purposes.
77
+ * Shows the first and last 2 characters with asterisks in between.
78
+ */
79
+ export function maskSensitiveValue(value) {
80
+ if (value.length <= 12) {
81
+ return '****';
82
+ }
83
+ return `${value.slice(0, 2)}****${value.slice(-2)}`;
84
+ }
85
+ //# sourceMappingURL=value-resolver.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"value-resolver.js","sourceRoot":"","sources":["../../../../src/agents/auth-provider/value-resolver.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,6 @@
1
+ /**
2
+ * @license
3
+ * Copyright 2026 Google LLC
4
+ * SPDX-License-Identifier: Apache-2.0
5
+ */
6
+ export {};
@@ -0,0 +1,100 @@
1
+ /**
2
+ * @license
3
+ * Copyright 2026 Google LLC
4
+ * SPDX-License-Identifier: Apache-2.0
5
+ */
6
+ import { describe, it, expect, afterEach, vi } from 'vitest';
7
+ import { resolveAuthValue, needsResolution, maskSensitiveValue, } from './value-resolver.js';
8
+ describe('value-resolver', () => {
9
+ describe('resolveAuthValue', () => {
10
+ describe('environment variables', () => {
11
+ afterEach(() => {
12
+ vi.unstubAllEnvs();
13
+ });
14
+ it('should resolve environment variable with $ prefix', async () => {
15
+ vi.stubEnv('TEST_API_KEY', 'secret-key-123');
16
+ const result = await resolveAuthValue('$TEST_API_KEY');
17
+ expect(result).toBe('secret-key-123');
18
+ });
19
+ it('should throw error for unset environment variable', async () => {
20
+ await expect(resolveAuthValue('$UNSET_VAR_12345')).rejects.toThrow("Environment variable 'UNSET_VAR_12345' is not set or is empty");
21
+ });
22
+ it('should throw error for empty environment variable', async () => {
23
+ vi.stubEnv('EMPTY_VAR', '');
24
+ await expect(resolveAuthValue('$EMPTY_VAR')).rejects.toThrow("Environment variable 'EMPTY_VAR' is not set or is empty");
25
+ });
26
+ });
27
+ describe('shell commands', () => {
28
+ it('should execute shell command with ! prefix', async () => {
29
+ const result = await resolveAuthValue('!echo hello');
30
+ expect(result).toBe('hello');
31
+ });
32
+ it('should trim whitespace from command output', async () => {
33
+ const result = await resolveAuthValue('!echo " hello "');
34
+ expect(result).toBe('hello');
35
+ });
36
+ it('should throw error for empty command', async () => {
37
+ await expect(resolveAuthValue('!')).rejects.toThrow('Empty command in auth value');
38
+ });
39
+ it('should throw error for command that returns empty output', async () => {
40
+ await expect(resolveAuthValue('!echo -n ""')).rejects.toThrow('returned empty output');
41
+ });
42
+ it('should throw error for failed command', async () => {
43
+ await expect(resolveAuthValue('!nonexistent-command-12345')).rejects.toThrow(/Command.*failed/);
44
+ });
45
+ });
46
+ describe('literal values', () => {
47
+ it('should return literal value as-is', async () => {
48
+ const result = await resolveAuthValue('literal-api-key');
49
+ expect(result).toBe('literal-api-key');
50
+ });
51
+ it('should return empty string as-is', async () => {
52
+ const result = await resolveAuthValue('');
53
+ expect(result).toBe('');
54
+ });
55
+ it('should not treat values starting with other characters as special', async () => {
56
+ const result = await resolveAuthValue('api-key-123');
57
+ expect(result).toBe('api-key-123');
58
+ });
59
+ });
60
+ describe('escaped literals', () => {
61
+ it('should return $ literal when value starts with $$', async () => {
62
+ const result = await resolveAuthValue('$$LITERAL');
63
+ expect(result).toBe('$LITERAL');
64
+ });
65
+ it('should return ! literal when value starts with !!', async () => {
66
+ const result = await resolveAuthValue('!!not-a-command');
67
+ expect(result).toBe('!not-a-command');
68
+ });
69
+ });
70
+ });
71
+ describe('needsResolution', () => {
72
+ it('should return true for environment variable reference', () => {
73
+ expect(needsResolution('$ENV_VAR')).toBe(true);
74
+ });
75
+ it('should return true for command reference', () => {
76
+ expect(needsResolution('!command')).toBe(true);
77
+ });
78
+ it('should return false for literal value', () => {
79
+ expect(needsResolution('literal')).toBe(false);
80
+ });
81
+ it('should return false for empty string', () => {
82
+ expect(needsResolution('')).toBe(false);
83
+ });
84
+ });
85
+ describe('maskSensitiveValue', () => {
86
+ it('should mask value longer than 12 characters', () => {
87
+ expect(maskSensitiveValue('1234567890abcd')).toBe('12****cd');
88
+ });
89
+ it('should return **** for short values', () => {
90
+ expect(maskSensitiveValue('short')).toBe('****');
91
+ });
92
+ it('should return **** for exactly 12 characters', () => {
93
+ expect(maskSensitiveValue('123456789012')).toBe('****');
94
+ });
95
+ it('should return **** for empty string', () => {
96
+ expect(maskSensitiveValue('')).toBe('****');
97
+ });
98
+ });
99
+ });
100
+ //# sourceMappingURL=value-resolver.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"value-resolver.test.js","sourceRoot":"","sources":["../../../../src/agents/auth-provider/value-resolver.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,24 @@
1
+ /**
2
+ * @license
3
+ * Copyright 2025 Google LLC
4
+ * SPDX-License-Identifier: Apache-2.0
5
+ */
6
+ import type { AgentDefinition } from './types.js';
7
+ import { z } from 'zod';
8
+ import type { Config } from '../config/config.js';
9
+ declare const CliHelpReportSchema: z.ZodObject<{
10
+ answer: z.ZodString;
11
+ sources: z.ZodArray<z.ZodString, "many">;
12
+ }, "strip", z.ZodTypeAny, {
13
+ sources: string[];
14
+ answer: string;
15
+ }, {
16
+ sources: string[];
17
+ answer: string;
18
+ }>;
19
+ /**
20
+ * An agent specialized in answering questions about Gemini CLI itself,
21
+ * using its own documentation and runtime state.
22
+ */
23
+ export declare const CliHelpAgent: (config: Config) => AgentDefinition<typeof CliHelpReportSchema>;
24
+ export {};
@@ -0,0 +1,80 @@
1
+ /**
2
+ * @license
3
+ * Copyright 2025 Google LLC
4
+ * SPDX-License-Identifier: Apache-2.0
5
+ */
6
+ import { GEMINI_MODEL_ALIAS_FLASH } from '../config/models.js';
7
+ import { z } from 'zod';
8
+ import { GetInternalDocsTool } from '../tools/get-internal-docs.js';
9
+ const CliHelpReportSchema = z.object({
10
+ answer: z
11
+ .string()
12
+ .describe('The detailed answer to the user question about Gemini CLI.'),
13
+ sources: z
14
+ .array(z.string())
15
+ .describe('The documentation files used to answer the question.'),
16
+ });
17
+ /**
18
+ * An agent specialized in answering questions about Gemini CLI itself,
19
+ * using its own documentation and runtime state.
20
+ */
21
+ export const CliHelpAgent = (config) => ({
22
+ name: 'cli_help',
23
+ kind: 'local',
24
+ displayName: 'CLI Help Agent',
25
+ description: 'Specialized in answering questions about how users use you, (Gemini CLI): features, documentation, and current runtime configuration.',
26
+ inputConfig: {
27
+ inputSchema: {
28
+ type: 'object',
29
+ properties: {
30
+ question: {
31
+ type: 'string',
32
+ description: 'The specific question about Gemini CLI.',
33
+ },
34
+ },
35
+ required: ['question'],
36
+ },
37
+ },
38
+ outputConfig: {
39
+ outputName: 'report',
40
+ description: 'The final answer and sources as a JSON object.',
41
+ schema: CliHelpReportSchema,
42
+ },
43
+ processOutput: (output) => JSON.stringify(output, null, 2),
44
+ modelConfig: {
45
+ model: GEMINI_MODEL_ALIAS_FLASH,
46
+ generateContentConfig: {
47
+ temperature: 0.1,
48
+ topP: 0.95,
49
+ thinkingConfig: {
50
+ includeThoughts: true,
51
+ thinkingBudget: -1,
52
+ },
53
+ },
54
+ },
55
+ runConfig: {
56
+ maxTimeMinutes: 3,
57
+ maxTurns: 10,
58
+ },
59
+ toolConfig: {
60
+ tools: [new GetInternalDocsTool(config.getMessageBus())],
61
+ },
62
+ promptConfig: {
63
+ query: 'Your task is to answer the following question about Gemini CLI:\n' +
64
+ '<question>\n' +
65
+ '${question}\n' +
66
+ '</question>',
67
+ systemPrompt: "You are **CLI Help Agent**, an expert on Gemini CLI. Your purpose is to provide accurate information about Gemini CLI's features, configuration, and current state.\n\n" +
68
+ '### Runtime Context\n' +
69
+ '- **CLI Version:** ${cliVersion}\n' +
70
+ '- **Active Model:** ${activeModel}\n' +
71
+ "- **Today's Date:** ${today}\n\n" +
72
+ '### Instructions\n' +
73
+ "1. **Explore Documentation**: Use the `get_internal_docs` tool to find answers. If you don't know where to start, call `get_internal_docs()` without arguments to see the full list of available documentation files.\n" +
74
+ '2. **Be Precise**: Use the provided runtime context and documentation to give exact answers.\n' +
75
+ '3. **Cite Sources**: Always include the specific documentation files you used in your final report.\n' +
76
+ '4. **Non-Interactive**: You operate in a loop and cannot ask the user for more info. If the question is ambiguous, answer as best as you can with the information available.\n\n' +
77
+ 'You MUST call `complete_task` with a JSON report containing your `answer` and the `sources` you used.',
78
+ },
79
+ });
80
+ //# sourceMappingURL=cli-help-agent.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cli-help-agent.js","sourceRoot":"","sources":["../../../src/agents/cli-help-agent.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAEpE,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,QAAQ,CAAC,4DAA4D,CAAC;IACzE,OAAO,EAAE,CAAC;SACP,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,CAAC,sDAAsD,CAAC;CACpE,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,MAAc,EAC+B,EAAE,CAAC,CAAC;IACjD,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,OAAO;IACb,WAAW,EAAE,gBAAgB;IAC7B,WAAW,EACT,uIAAuI;IACzI,WAAW,EAAE;QACX,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,yCAAyC;iBACvD;aACF;YACD,QAAQ,EAAE,CAAC,UAAU,CAAC;SACvB;KACF;IACD,YAAY,EAAE;QACZ,UAAU,EAAE,QAAQ;QACpB,WAAW,EAAE,gDAAgD;QAC7D,MAAM,EAAE,mBAAmB;KAC5B;IAED,aAAa,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAE1D,WAAW,EAAE;QACX,KAAK,EAAE,wBAAwB;QAC/B,qBAAqB,EAAE;YACrB,WAAW,EAAE,GAAG;YAChB,IAAI,EAAE,IAAI;YACV,cAAc,EAAE;gBACd,eAAe,EAAE,IAAI;gBACrB,cAAc,EAAE,CAAC,CAAC;aACnB;SACF;KACF;IAED,SAAS,EAAE;QACT,cAAc,EAAE,CAAC;QACjB,QAAQ,EAAE,EAAE;KACb;IAED,UAAU,EAAE;QACV,KAAK,EAAE,CAAC,IAAI,mBAAmB,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC;KACzD;IAED,YAAY,EAAE;QACZ,KAAK,EACH,mEAAmE;YACnE,cAAc;YACd,eAAe;YACf,aAAa;QACf,YAAY,EACV,yKAAyK;YACzK,uBAAuB;YACvB,oCAAoC;YACpC,sCAAsC;YACtC,kCAAkC;YAClC,oBAAoB;YACpB,yNAAyN;YACzN,gGAAgG;YAChG,uGAAuG;YACvG,kLAAkL;YAClL,uGAAuG;KAC1G;CACF,CAAC,CAAC"}
@@ -0,0 +1,6 @@
1
+ /**
2
+ * @license
3
+ * Copyright 2025 Google LLC
4
+ * SPDX-License-Identifier: Apache-2.0
5
+ */
6
+ export {};
@@ -0,0 +1,53 @@
1
+ /**
2
+ * @license
3
+ * Copyright 2025 Google LLC
4
+ * SPDX-License-Identifier: Apache-2.0
5
+ */
6
+ import { describe, it, expect } from 'vitest';
7
+ import { CliHelpAgent } from './cli-help-agent.js';
8
+ import { GET_INTERNAL_DOCS_TOOL_NAME } from '../tools/tool-names.js';
9
+ import { GEMINI_MODEL_ALIAS_FLASH } from '../config/models.js';
10
+ describe('CliHelpAgent', () => {
11
+ const fakeConfig = {
12
+ getMessageBus: () => ({}),
13
+ isAgentsEnabled: () => false,
14
+ };
15
+ const localAgent = CliHelpAgent(fakeConfig);
16
+ it('should have the correct agent definition metadata', () => {
17
+ expect(localAgent.name).toBe('cli_help');
18
+ expect(localAgent.kind).toBe('local');
19
+ expect(localAgent.displayName).toBe('CLI Help Agent');
20
+ expect(localAgent.description).toContain('Gemini CLI');
21
+ });
22
+ it('should have correctly configured inputs and outputs', () => {
23
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
24
+ const inputSchema = localAgent.inputConfig.inputSchema;
25
+ expect(inputSchema.properties['question']).toBeDefined();
26
+ expect(inputSchema.required).toContain('question');
27
+ expect(localAgent.outputConfig?.outputName).toBe('report');
28
+ expect(localAgent.outputConfig?.description).toBeDefined();
29
+ });
30
+ it('should use the correct model and tools', () => {
31
+ expect(localAgent.modelConfig?.model).toBe(GEMINI_MODEL_ALIAS_FLASH);
32
+ const tools = localAgent.toolConfig?.tools || [];
33
+ const hasInternalDocsTool = tools.some((t) => typeof t !== 'string' && t.name === GET_INTERNAL_DOCS_TOOL_NAME);
34
+ expect(hasInternalDocsTool).toBe(true);
35
+ });
36
+ it('should have expected prompt placeholders', () => {
37
+ const systemPrompt = localAgent.promptConfig.systemPrompt || '';
38
+ expect(systemPrompt).toContain('${cliVersion}');
39
+ expect(systemPrompt).toContain('${activeModel}');
40
+ expect(systemPrompt).toContain('${today}');
41
+ const query = localAgent.promptConfig.query || '';
42
+ expect(query).toContain('${question}');
43
+ });
44
+ it('should process output to a formatted JSON string', () => {
45
+ const mockOutput = {
46
+ answer: 'This is the answer.',
47
+ sources: ['file1.md', 'file2.md'],
48
+ };
49
+ const processed = localAgent.processOutput?.(mockOutput);
50
+ expect(processed).toBe(JSON.stringify(mockOutput, null, 2));
51
+ });
52
+ });
53
+ //# sourceMappingURL=cli-help-agent.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cli-help-agent.test.js","sourceRoot":"","sources":["../../../src/agents/cli-help-agent.test.ts"],"names":[],"mappings":"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"}
@@ -5,6 +5,7 @@
5
5
  */
6
6
  import type { LocalAgentDefinition } from './types.js';
7
7
  import { z } from 'zod';
8
+ import type { Config } from '../config/config.js';
8
9
  declare const CodebaseInvestigationReportSchema: z.ZodObject<{
9
10
  SummaryOfFindings: z.ZodString;
10
11
  ExplorationTrace: z.ZodArray<z.ZodString, "many">;
@@ -42,5 +43,5 @@ declare const CodebaseInvestigationReportSchema: z.ZodObject<{
42
43
  * A Proof-of-Concept subagent specialized in analyzing codebase structure,
43
44
  * dependencies, and technologies.
44
45
  */
45
- export declare const CodebaseInvestigatorAgent: LocalAgentDefinition<typeof CodebaseInvestigationReportSchema>;
46
+ export declare const CodebaseInvestigatorAgent: (config: Config) => LocalAgentDefinition<typeof CodebaseInvestigationReportSchema>;
46
47
  export {};
@@ -4,8 +4,9 @@
4
4
  * SPDX-License-Identifier: Apache-2.0
5
5
  */
6
6
  import { GLOB_TOOL_NAME, GREP_TOOL_NAME, LS_TOOL_NAME, READ_FILE_TOOL_NAME, } from '../tools/tool-names.js';
7
- import { DEFAULT_GEMINI_MODEL } from '../config/models.js';
7
+ import { DEFAULT_THINKING_MODE, DEFAULT_GEMINI_MODEL, PREVIEW_GEMINI_FLASH_MODEL, supportsModernFeatures, } from '../config/models.js';
8
8
  import { z } from 'zod';
9
+ import { ThinkingLevel } from '@google/genai';
9
10
  // Define a type that matches the outputConfig schema for type safety.
10
11
  const CodebaseInvestigationReportSchema = z.object({
11
12
  SummaryOfFindings: z
@@ -26,50 +27,77 @@ const CodebaseInvestigationReportSchema = z.object({
26
27
  * A Proof-of-Concept subagent specialized in analyzing codebase structure,
27
28
  * dependencies, and technologies.
28
29
  */
29
- export const CodebaseInvestigatorAgent = {
30
- name: 'codebase_investigator',
31
- kind: 'local',
32
- displayName: 'Codebase Investigator Agent',
33
- description: `The specialized tool for codebase analysis, architectural mapping, and understanding system-wide dependencies.
30
+ export const CodebaseInvestigatorAgent = (config) => {
31
+ // Use Preview Flash model if the main model supports modern features.
32
+ // If the main model is not a modern model, use the default pro model.
33
+ const model = supportsModernFeatures(config.getModel())
34
+ ? PREVIEW_GEMINI_FLASH_MODEL
35
+ : DEFAULT_GEMINI_MODEL;
36
+ const listCommand = process.platform === 'win32'
37
+ ? '`dir /s` (CMD) or `Get-ChildItem -Recurse` (PowerShell)'
38
+ : '`ls -R`';
39
+ return {
40
+ name: 'codebase_investigator',
41
+ kind: 'local',
42
+ displayName: 'Codebase Investigator Agent',
43
+ description: `The specialized tool for codebase analysis, architectural mapping, and understanding system-wide dependencies.
34
44
  Invoke this tool for tasks like vague requests, bug root-cause analysis, system refactoring, comprehensive feature implementation or to answer questions about the codebase that require investigation.
35
45
  It returns a structured report with key file paths, symbols, and actionable architectural insights.`,
36
- inputConfig: {
37
- inputs: {
38
- objective: {
39
- description: `A comprehensive and detailed description of the user's ultimate goal.
46
+ inputConfig: {
47
+ inputSchema: {
48
+ type: 'object',
49
+ properties: {
50
+ objective: {
51
+ type: 'string',
52
+ description: `A comprehensive and detailed description of the user's ultimate goal.
40
53
  You must include original user's objective as well as questions and any extra context and questions you may have.`,
41
- type: 'string',
42
- required: true,
54
+ },
55
+ },
56
+ required: ['objective'],
43
57
  },
44
58
  },
45
- },
46
- outputConfig: {
47
- outputName: 'report',
48
- description: 'The final investigation report as a JSON object.',
49
- schema: CodebaseInvestigationReportSchema,
50
- },
51
- // The 'output' parameter is now strongly typed as CodebaseInvestigationReportSchema
52
- processOutput: (output) => JSON.stringify(output, null, 2),
53
- modelConfig: {
54
- model: DEFAULT_GEMINI_MODEL,
55
- temp: 0.1,
56
- top_p: 0.95,
57
- thinkingBudget: -1,
58
- },
59
- runConfig: {
60
- max_time_minutes: 5,
61
- max_turns: 15,
62
- },
63
- toolConfig: {
64
- // Grant access only to read-only tools.
65
- tools: [LS_TOOL_NAME, READ_FILE_TOOL_NAME, GLOB_TOOL_NAME, GREP_TOOL_NAME],
66
- },
67
- promptConfig: {
68
- query: `Your task is to do a deep investigation of the codebase to find all relevant files, code locations, architectural mental map and insights to solve for the following user objective:
59
+ outputConfig: {
60
+ outputName: 'report',
61
+ description: 'The final investigation report as a JSON object.',
62
+ schema: CodebaseInvestigationReportSchema,
63
+ },
64
+ // The 'output' parameter is now strongly typed as CodebaseInvestigationReportSchema
65
+ processOutput: (output) => JSON.stringify(output, null, 2),
66
+ modelConfig: {
67
+ model,
68
+ generateContentConfig: {
69
+ temperature: 0.1,
70
+ topP: 0.95,
71
+ thinkingConfig: supportsModernFeatures(model)
72
+ ? {
73
+ includeThoughts: true,
74
+ thinkingLevel: ThinkingLevel.HIGH,
75
+ }
76
+ : {
77
+ includeThoughts: true,
78
+ thinkingBudget: DEFAULT_THINKING_MODE,
79
+ },
80
+ },
81
+ },
82
+ runConfig: {
83
+ maxTimeMinutes: 3,
84
+ maxTurns: 10,
85
+ },
86
+ toolConfig: {
87
+ // Grant access only to read-only tools.
88
+ tools: [
89
+ LS_TOOL_NAME,
90
+ READ_FILE_TOOL_NAME,
91
+ GLOB_TOOL_NAME,
92
+ GREP_TOOL_NAME,
93
+ ],
94
+ },
95
+ promptConfig: {
96
+ query: `Your task is to do a deep investigation of the codebase to find all relevant files, code locations, architectural mental map and insights to solve for the following user objective:
69
97
  <objective>
70
98
  \${objective}
71
99
  </objective>`,
72
- systemPrompt: `You are **Codebase Investigator**, a hyper-specialized AI agent and an expert in reverse-engineering complex software projects. You are a sub-agent within a larger development system.
100
+ systemPrompt: `You are **Codebase Investigator**, a hyper-specialized AI agent and an expert in reverse-engineering complex software projects. You are a sub-agent within a larger development system.
73
101
  Your **SOLE PURPOSE** is to build a complete mental model of the code relevant to a given investigation. You must identify all relevant files, understand their roles, and foresee the direct architectural consequences of potential changes.
74
102
  You are a sub-agent in a larger system. Your only responsibility is to provide deep, actionable context.
75
103
  - **DO:** Find the key modules, classes, and functions that are part of the problem and its solution.
@@ -110,7 +138,7 @@ When you are finished, you **MUST** call the \`complete_task\` tool. The \`repor
110
138
  "ExplorationTrace": [
111
139
  "Used \`grep\` to search for \`updateUser\` to locate the primary function.",
112
140
  "Read the file \`src/controllers/userController.js\` to understand the function's logic.",
113
- "Used \`ls -R\` to look for related files, such as services or database models.",
141
+ "Used ${listCommand} to look for related files, such as services or database models.",
114
142
  "Read \`src/services/userService.js\` and \`src/models/User.js\` to understand the data flow and how state is managed."
115
143
  ],
116
144
  "RelevantLocations": [
@@ -128,6 +156,7 @@ When you are finished, you **MUST** call the \`complete_task\` tool. The \`repor
128
156
  }
129
157
  \`\`\`
130
158
  `,
131
- },
159
+ },
160
+ };
132
161
  };
133
162
  //# sourceMappingURL=codebase-investigator.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"codebase-investigator.js","sourceRoot":"","sources":["../../../src/agents/codebase-investigator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,cAAc,EACd,cAAc,EACd,YAAY,EACZ,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,sEAAsE;AACtE,MAAM,iCAAiC,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,iBAAiB,EAAE,CAAC;SACjB,MAAM,EAAE;SACR,QAAQ,CACP,+EAA+E,CAChF;IACH,gBAAgB,EAAE,CAAC;SAChB,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,CACP,yEAAyE,CAC1E;IACH,iBAAiB,EAAE,CAAC;SACjB,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;QACP,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;KAChC,CAAC,CACH;SACA,QAAQ,CAAC,2DAA2D,CAAC;CACzE,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAElC;IACF,IAAI,EAAE,uBAAuB;IAC7B,IAAI,EAAE,OAAO;IACb,WAAW,EAAE,6BAA6B;IAC1C,WAAW,EAAE;;wGAEyF;IACtG,WAAW,EAAE;QACX,MAAM,EAAE;YACN,SAAS,EAAE;gBACT,WAAW,EAAE;4HACuG;gBACpH,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,IAAI;aACf;SACF;KACF;IACD,YAAY,EAAE;QACZ,UAAU,EAAE,QAAQ;QACpB,WAAW,EAAE,kDAAkD;QAC/D,MAAM,EAAE,iCAAiC;KAC1C;IAED,oFAAoF;IACpF,aAAa,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAE1D,WAAW,EAAE;QACX,KAAK,EAAE,oBAAoB;QAC3B,IAAI,EAAE,GAAG;QACT,KAAK,EAAE,IAAI;QACX,cAAc,EAAE,CAAC,CAAC;KACnB;IAED,SAAS,EAAE;QACT,gBAAgB,EAAE,CAAC;QACnB,SAAS,EAAE,EAAE;KACd;IAED,UAAU,EAAE;QACV,wCAAwC;QACxC,KAAK,EAAE,CAAC,YAAY,EAAE,mBAAmB,EAAE,cAAc,EAAE,cAAc,CAAC;KAC3E;IAED,YAAY,EAAE;QACZ,KAAK,EAAE;;;aAGE;QACT,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0DjB;KACE;CACF,CAAC"}
1
+ {"version":3,"file":"codebase-investigator.js","sourceRoot":"","sources":["../../../src/agents/codebase-investigator.ts"],"names":[],"mappings":"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"}