@google/gemini-cli-core 0.30.0-preview.6 → 0.31.0-preview.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 (687) hide show
  1. package/README.md +1 -1
  2. package/dist/docs/CONTRIBUTING.md +6 -7
  3. package/dist/docs/changelogs/index.md +22 -2
  4. package/dist/docs/changelogs/latest.md +359 -293
  5. package/dist/docs/changelogs/preview.md +300 -349
  6. package/dist/docs/cli/cli-reference.md +23 -23
  7. package/dist/docs/cli/enterprise.md +7 -7
  8. package/dist/docs/cli/gemini-md.md +1 -1
  9. package/dist/docs/cli/model.md +1 -1
  10. package/dist/docs/cli/plan-mode.md +180 -80
  11. package/dist/docs/cli/sandbox.md +3 -3
  12. package/dist/docs/cli/settings.md +59 -51
  13. package/dist/docs/cli/telemetry.md +4 -1
  14. package/dist/docs/cli/themes.md +3 -3
  15. package/dist/docs/cli/trusted-folders.md +31 -0
  16. package/dist/docs/cli/tutorials/memory-management.md +2 -2
  17. package/dist/docs/cli/tutorials/session-management.md +1 -1
  18. package/dist/docs/core/index.md +7 -7
  19. package/dist/docs/core/subagents.md +155 -39
  20. package/dist/docs/extensions/reference.md +38 -14
  21. package/dist/docs/get-started/authentication.md +4 -4
  22. package/dist/docs/get-started/examples.md +2 -2
  23. package/dist/docs/get-started/gemini-3.md +17 -3
  24. package/dist/docs/get-started/index.md +11 -2
  25. package/dist/docs/hooks/best-practices.md +1 -1
  26. package/dist/docs/hooks/reference.md +8 -0
  27. package/dist/docs/ide-integration/index.md +14 -0
  28. package/dist/docs/index.md +62 -67
  29. package/dist/docs/redirects.json +19 -0
  30. package/dist/docs/{cli → reference}/commands.md +67 -11
  31. package/dist/docs/{get-started → reference}/configuration.md +93 -24
  32. package/dist/docs/{cli → reference}/keyboard-shortcuts.md +3 -3
  33. package/dist/docs/{core → reference}/policy-engine.md +63 -27
  34. package/dist/docs/{faq.md → resources/faq.md} +1 -1
  35. package/dist/docs/{quota-and-pricing.md → resources/quota-and-pricing.md} +12 -5
  36. package/dist/docs/{tos-privacy.md → resources/tos-privacy.md} +2 -2
  37. package/dist/docs/{troubleshooting.md → resources/troubleshooting.md} +1 -1
  38. package/dist/docs/sidebar.json +203 -166
  39. package/dist/docs/tools/file-system.md +7 -4
  40. package/dist/docs/tools/index.md +5 -2
  41. package/dist/docs/tools/internal-docs.md +5 -5
  42. package/dist/docs/tools/mcp-server.md +62 -2
  43. package/dist/docs/tools/planning.md +2 -0
  44. package/dist/docs/tools/shell.md +3 -3
  45. package/dist/src/agents/a2a-client-manager.test.js +1 -2
  46. package/dist/src/agents/a2a-client-manager.test.js.map +1 -1
  47. package/dist/src/agents/a2aUtils.d.ts +1 -5
  48. package/dist/src/agents/a2aUtils.js +1 -1
  49. package/dist/src/agents/a2aUtils.js.map +1 -1
  50. package/dist/src/agents/acknowledgedAgents.js +1 -0
  51. package/dist/src/agents/acknowledgedAgents.js.map +1 -1
  52. package/dist/src/agents/agent-scheduler.js +1 -0
  53. package/dist/src/agents/agent-scheduler.js.map +1 -1
  54. package/dist/src/agents/agentLoader.d.ts +0 -1
  55. package/dist/src/agents/agentLoader.js +22 -21
  56. package/dist/src/agents/agentLoader.js.map +1 -1
  57. package/dist/src/agents/agentLoader.test.js +1 -5
  58. package/dist/src/agents/agentLoader.test.js.map +1 -1
  59. package/dist/src/agents/auth-provider/api-key-provider.d.ts +30 -0
  60. package/dist/src/agents/auth-provider/api-key-provider.js +66 -0
  61. package/dist/src/agents/auth-provider/api-key-provider.js.map +1 -0
  62. package/dist/src/agents/auth-provider/api-key-provider.test.d.ts +6 -0
  63. package/dist/src/agents/auth-provider/api-key-provider.test.js +130 -0
  64. package/dist/src/agents/auth-provider/api-key-provider.test.js.map +1 -0
  65. package/dist/src/agents/auth-provider/base-provider.d.ts +2 -2
  66. package/dist/src/agents/auth-provider/base-provider.js.map +1 -1
  67. package/dist/src/agents/auth-provider/factory.js +6 -3
  68. package/dist/src/agents/auth-provider/factory.js.map +1 -1
  69. package/dist/src/agents/auth-provider/factory.test.js +12 -0
  70. package/dist/src/agents/auth-provider/factory.test.js.map +1 -1
  71. package/dist/src/agents/auth-provider/types.d.ts +2 -4
  72. package/dist/src/agents/browser/analyzeScreenshot.d.ts +35 -0
  73. package/dist/src/agents/browser/analyzeScreenshot.js +183 -0
  74. package/dist/src/agents/browser/analyzeScreenshot.js.map +1 -0
  75. package/dist/src/agents/browser/analyzeScreenshot.test.d.ts +6 -0
  76. package/dist/src/agents/browser/analyzeScreenshot.test.js +161 -0
  77. package/dist/src/agents/browser/analyzeScreenshot.test.js.map +1 -0
  78. package/dist/src/agents/browser/browserAgentDefinition.d.ts +50 -0
  79. package/dist/src/agents/browser/browserAgentDefinition.js +141 -0
  80. package/dist/src/agents/browser/browserAgentDefinition.js.map +1 -0
  81. package/dist/src/agents/browser/browserAgentFactory.d.ts +42 -0
  82. package/dist/src/agents/browser/browserAgentFactory.js +107 -0
  83. package/dist/src/agents/browser/browserAgentFactory.js.map +1 -0
  84. package/dist/src/agents/browser/browserAgentFactory.test.d.ts +6 -0
  85. package/dist/src/agents/browser/browserAgentFactory.test.js +186 -0
  86. package/dist/src/agents/browser/browserAgentFactory.test.js.map +1 -0
  87. package/dist/src/agents/browser/browserAgentInvocation.d.ts +44 -0
  88. package/dist/src/agents/browser/browserAgentInvocation.js +109 -0
  89. package/dist/src/agents/browser/browserAgentInvocation.js.map +1 -0
  90. package/dist/src/agents/browser/browserAgentInvocation.test.d.ts +6 -0
  91. package/dist/src/agents/browser/browserAgentInvocation.test.js +87 -0
  92. package/dist/src/agents/browser/browserAgentInvocation.test.js.map +1 -0
  93. package/dist/src/agents/browser/browserManager.d.ts +110 -0
  94. package/dist/src/agents/browser/browserManager.js +323 -0
  95. package/dist/src/agents/browser/browserManager.js.map +1 -0
  96. package/dist/src/agents/browser/browserManager.test.d.ts +6 -0
  97. package/dist/src/agents/browser/browserManager.test.js +314 -0
  98. package/dist/src/agents/browser/browserManager.test.js.map +1 -0
  99. package/dist/src/agents/browser/mcpToolWrapper.d.ts +45 -0
  100. package/dist/src/agents/browser/mcpToolWrapper.js +356 -0
  101. package/dist/src/agents/browser/mcpToolWrapper.js.map +1 -0
  102. package/dist/src/agents/browser/mcpToolWrapper.test.d.ts +6 -0
  103. package/dist/src/agents/browser/mcpToolWrapper.test.js +126 -0
  104. package/dist/src/agents/browser/mcpToolWrapper.test.js.map +1 -0
  105. package/dist/src/agents/browser/mcpToolWrapperConfirmation.test.d.ts +6 -0
  106. package/dist/src/agents/browser/mcpToolWrapperConfirmation.test.js +57 -0
  107. package/dist/src/agents/browser/mcpToolWrapperConfirmation.test.js.map +1 -0
  108. package/dist/src/agents/browser/modelAvailability.d.ts +23 -0
  109. package/dist/src/agents/browser/modelAvailability.js +23 -0
  110. package/dist/src/agents/browser/modelAvailability.js.map +1 -0
  111. package/dist/src/agents/local-executor.js +73 -31
  112. package/dist/src/agents/local-executor.js.map +1 -1
  113. package/dist/src/agents/local-executor.test.js +157 -4
  114. package/dist/src/agents/local-executor.test.js.map +1 -1
  115. package/dist/src/agents/local-invocation.test.js.map +1 -1
  116. package/dist/src/agents/registry.js +8 -0
  117. package/dist/src/agents/registry.js.map +1 -1
  118. package/dist/src/agents/registry.test.js.map +1 -1
  119. package/dist/src/agents/remote-invocation.d.ts +2 -1
  120. package/dist/src/agents/remote-invocation.js +3 -3
  121. package/dist/src/agents/remote-invocation.js.map +1 -1
  122. package/dist/src/agents/subagent-tool-wrapper.js +6 -0
  123. package/dist/src/agents/subagent-tool-wrapper.js.map +1 -1
  124. package/dist/src/agents/subagent-tool.d.ts +3 -0
  125. package/dist/src/agents/subagent-tool.js +62 -3
  126. package/dist/src/agents/subagent-tool.js.map +1 -1
  127. package/dist/src/agents/subagent-tool.test.js +143 -0
  128. package/dist/src/agents/subagent-tool.test.js.map +1 -1
  129. package/dist/src/availability/fallbackIntegration.test.js +4 -1
  130. package/dist/src/availability/fallbackIntegration.test.js.map +1 -1
  131. package/dist/src/availability/policyHelpers.js +3 -1
  132. package/dist/src/availability/policyHelpers.js.map +1 -1
  133. package/dist/src/availability/policyHelpers.test.js +51 -5
  134. package/dist/src/availability/policyHelpers.test.js.map +1 -1
  135. package/dist/src/code_assist/admin/admin_controls.js +1 -0
  136. package/dist/src/code_assist/admin/admin_controls.js.map +1 -1
  137. package/dist/src/code_assist/converter.js +8 -2
  138. package/dist/src/code_assist/converter.js.map +1 -1
  139. package/dist/src/code_assist/converter.test.js.map +1 -1
  140. package/dist/src/code_assist/experiments/experiments.js +1 -1
  141. package/dist/src/code_assist/experiments/experiments.js.map +1 -1
  142. package/dist/src/code_assist/oauth-credential-storage.js +1 -1
  143. package/dist/src/code_assist/oauth-credential-storage.js.map +1 -1
  144. package/dist/src/code_assist/oauth-credential-storage.test.js +5 -0
  145. package/dist/src/code_assist/oauth-credential-storage.test.js.map +1 -1
  146. package/dist/src/code_assist/oauth2.js +11 -8
  147. package/dist/src/code_assist/oauth2.js.map +1 -1
  148. package/dist/src/code_assist/oauth2.test.js +55 -0
  149. package/dist/src/code_assist/oauth2.test.js.map +1 -1
  150. package/dist/src/code_assist/server.js +22 -13
  151. package/dist/src/code_assist/server.js.map +1 -1
  152. package/dist/src/code_assist/server.test.js +26 -0
  153. package/dist/src/code_assist/server.test.js.map +1 -1
  154. package/dist/src/code_assist/telemetry.js +16 -3
  155. package/dist/src/code_assist/telemetry.js.map +1 -1
  156. package/dist/src/code_assist/telemetry.test.js +10 -0
  157. package/dist/src/code_assist/telemetry.test.js.map +1 -1
  158. package/dist/src/code_assist/types.d.ts +13 -12
  159. package/dist/src/code_assist/types.js.map +1 -1
  160. package/dist/src/config/config.d.ts +83 -8
  161. package/dist/src/config/config.js +127 -23
  162. package/dist/src/config/config.js.map +1 -1
  163. package/dist/src/config/config.test.js +285 -10
  164. package/dist/src/config/config.test.js.map +1 -1
  165. package/dist/src/config/projectRegistry.js +1 -0
  166. package/dist/src/config/projectRegistry.js.map +1 -1
  167. package/dist/src/config/storage.d.ts +17 -1
  168. package/dist/src/config/storage.js +82 -2
  169. package/dist/src/config/storage.js.map +1 -1
  170. package/dist/src/config/storage.test.js +149 -2
  171. package/dist/src/config/storage.test.js.map +1 -1
  172. package/dist/src/config/userHintService.d.ts +46 -0
  173. package/dist/src/config/userHintService.js +81 -0
  174. package/dist/src/config/userHintService.js.map +1 -0
  175. package/dist/src/config/userHintService.test.d.ts +6 -0
  176. package/dist/src/config/userHintService.test.js +62 -0
  177. package/dist/src/config/userHintService.test.js.map +1 -0
  178. package/dist/src/confirmation-bus/message-bus.js +15 -3
  179. package/dist/src/confirmation-bus/message-bus.js.map +1 -1
  180. package/dist/src/confirmation-bus/message-bus.test.js +15 -0
  181. package/dist/src/confirmation-bus/message-bus.test.js.map +1 -1
  182. package/dist/src/confirmation-bus/types.d.ts +7 -0
  183. package/dist/src/confirmation-bus/types.js.map +1 -1
  184. package/dist/src/core/baseLlmClient.d.ts +2 -3
  185. package/dist/src/core/baseLlmClient.js +7 -5
  186. package/dist/src/core/baseLlmClient.js.map +1 -1
  187. package/dist/src/core/baseLlmClient.test.js +45 -20
  188. package/dist/src/core/baseLlmClient.test.js.map +1 -1
  189. package/dist/src/core/client.js +18 -7
  190. package/dist/src/core/client.js.map +1 -1
  191. package/dist/src/core/coreToolHookTriggers.d.ts +2 -3
  192. package/dist/src/core/coreToolHookTriggers.js +8 -3
  193. package/dist/src/core/coreToolHookTriggers.js.map +1 -1
  194. package/dist/src/core/coreToolScheduler.js +2 -1
  195. package/dist/src/core/coreToolScheduler.js.map +1 -1
  196. package/dist/src/core/coreToolScheduler.test.js +10 -3
  197. package/dist/src/core/coreToolScheduler.test.js.map +1 -1
  198. package/dist/src/core/fakeContentGenerator.js +2 -0
  199. package/dist/src/core/fakeContentGenerator.js.map +1 -1
  200. package/dist/src/core/geminiChat.d.ts +1 -1
  201. package/dist/src/core/geminiChat.js +5 -5
  202. package/dist/src/core/geminiChat.js.map +1 -1
  203. package/dist/src/core/geminiChat.test.js +1 -0
  204. package/dist/src/core/geminiChat.test.js.map +1 -1
  205. package/dist/src/core/geminiChat_network_retry.test.js +1 -0
  206. package/dist/src/core/geminiChat_network_retry.test.js.map +1 -1
  207. package/dist/src/core/logger.js +2 -0
  208. package/dist/src/core/logger.js.map +1 -1
  209. package/dist/src/core/loggingContentGenerator.d.ts +14 -2
  210. package/dist/src/core/loggingContentGenerator.js +98 -4
  211. package/dist/src/core/loggingContentGenerator.js.map +1 -1
  212. package/dist/src/core/loggingContentGenerator.test.js +275 -1
  213. package/dist/src/core/loggingContentGenerator.test.js.map +1 -1
  214. package/dist/src/core/prompts.test.js +55 -27
  215. package/dist/src/core/prompts.test.js.map +1 -1
  216. package/dist/src/core/recordingContentGenerator.test.js +5 -0
  217. package/dist/src/core/recordingContentGenerator.test.js.map +1 -1
  218. package/dist/src/core/turn.d.ts +4 -2
  219. package/dist/src/core/turn.js +2 -0
  220. package/dist/src/core/turn.js.map +1 -1
  221. package/dist/src/core/turn.test.js +4 -1
  222. package/dist/src/core/turn.test.js.map +1 -1
  223. package/dist/src/generated/git-commit.d.ts +2 -2
  224. package/dist/src/generated/git-commit.js +2 -2
  225. package/dist/src/hooks/hookAggregator.d.ts +1 -2
  226. package/dist/src/hooks/hookAggregator.js +1 -2
  227. package/dist/src/hooks/hookAggregator.js.map +1 -1
  228. package/dist/src/hooks/hookEventHandler.d.ts +2 -2
  229. package/dist/src/hooks/hookEventHandler.js +13 -4
  230. package/dist/src/hooks/hookEventHandler.js.map +1 -1
  231. package/dist/src/hooks/hookEventHandler.test.js +1 -2
  232. package/dist/src/hooks/hookEventHandler.test.js.map +1 -1
  233. package/dist/src/hooks/hookPlanner.d.ts +1 -2
  234. package/dist/src/hooks/hookPlanner.js.map +1 -1
  235. package/dist/src/hooks/hookRegistry.d.ts +8 -0
  236. package/dist/src/hooks/hookRegistry.js +31 -3
  237. package/dist/src/hooks/hookRegistry.js.map +1 -1
  238. package/dist/src/hooks/hookRegistry.test.js.map +1 -1
  239. package/dist/src/hooks/hookRunner.d.ts +5 -2
  240. package/dist/src/hooks/hookRunner.js +52 -2
  241. package/dist/src/hooks/hookRunner.js.map +1 -1
  242. package/dist/src/hooks/hookRunner.test.js.map +1 -1
  243. package/dist/src/hooks/hookSystem.d.ts +11 -3
  244. package/dist/src/hooks/hookSystem.js +10 -4
  245. package/dist/src/hooks/hookSystem.js.map +1 -1
  246. package/dist/src/hooks/hookSystem.test.js +1 -0
  247. package/dist/src/hooks/hookSystem.test.js.map +1 -1
  248. package/dist/src/hooks/runtimeHooks.test.d.ts +6 -0
  249. package/dist/src/hooks/runtimeHooks.test.js +100 -0
  250. package/dist/src/hooks/runtimeHooks.test.js.map +1 -0
  251. package/dist/src/hooks/trustedHooks.js +6 -1
  252. package/dist/src/hooks/trustedHooks.js.map +1 -1
  253. package/dist/src/hooks/trustedHooks.test.js +17 -9
  254. package/dist/src/hooks/trustedHooks.test.js.map +1 -1
  255. package/dist/src/hooks/types.d.ts +49 -8
  256. package/dist/src/hooks/types.js +20 -1
  257. package/dist/src/hooks/types.js.map +1 -1
  258. package/dist/src/ide/detect-ide.d.ts +0 -1
  259. package/dist/src/ide/detect-ide.js +1 -1
  260. package/dist/src/ide/detect-ide.js.map +1 -1
  261. package/dist/src/ide/ide-client.js +3 -2
  262. package/dist/src/ide/ide-client.js.map +1 -1
  263. package/dist/src/ide/ide-connection-utils.js +90 -14
  264. package/dist/src/ide/ide-connection-utils.js.map +1 -1
  265. package/dist/src/ide/ide-connection-utils.test.js +78 -0
  266. package/dist/src/ide/ide-connection-utils.test.js.map +1 -1
  267. package/dist/src/ide/ide-installer.test.js +1 -2
  268. package/dist/src/ide/ide-installer.test.js.map +1 -1
  269. package/dist/src/ide/process-utils.d.ts +7 -0
  270. package/dist/src/ide/process-utils.js +20 -0
  271. package/dist/src/ide/process-utils.js.map +1 -1
  272. package/dist/src/ide/process-utils.test.js +30 -0
  273. package/dist/src/ide/process-utils.test.js.map +1 -1
  274. package/dist/src/index.d.ts +6 -1
  275. package/dist/src/index.js +6 -1
  276. package/dist/src/index.js.map +1 -1
  277. package/dist/src/mcp/oauth-provider.d.ts +1 -1
  278. package/dist/src/mcp/oauth-provider.js +8 -7
  279. package/dist/src/mcp/oauth-provider.js.map +1 -1
  280. package/dist/src/mcp/oauth-provider.test.js +34 -2
  281. package/dist/src/mcp/oauth-provider.test.js.map +1 -1
  282. package/dist/src/mcp/oauth-utils.js +2 -0
  283. package/dist/src/mcp/oauth-utils.js.map +1 -1
  284. package/dist/src/mcp/oauth-utils.test.js +12 -0
  285. package/dist/src/mcp/oauth-utils.test.js.map +1 -1
  286. package/dist/src/mcp/token-storage/file-token-storage.js +4 -1
  287. package/dist/src/mcp/token-storage/file-token-storage.js.map +1 -1
  288. package/dist/src/mcp/token-storage/file-token-storage.test.js +40 -2
  289. package/dist/src/mcp/token-storage/file-token-storage.test.js.map +1 -1
  290. package/dist/src/mcp/token-storage/keychain-token-storage.js +2 -0
  291. package/dist/src/mcp/token-storage/keychain-token-storage.js.map +1 -1
  292. package/dist/src/policy/config.d.ts +18 -9
  293. package/dist/src/policy/config.js +75 -54
  294. package/dist/src/policy/config.js.map +1 -1
  295. package/dist/src/policy/config.test.js +26 -26
  296. package/dist/src/policy/integrity.d.ts +45 -0
  297. package/dist/src/policy/integrity.js +121 -0
  298. package/dist/src/policy/integrity.js.map +1 -0
  299. package/dist/src/policy/integrity.test.d.ts +6 -0
  300. package/dist/src/policy/integrity.test.js +132 -0
  301. package/dist/src/policy/integrity.test.js.map +1 -0
  302. package/dist/src/policy/persistence.test.js +29 -19
  303. package/dist/src/policy/persistence.test.js.map +1 -1
  304. package/dist/src/policy/policies/conseca.toml +6 -0
  305. package/dist/src/policy/policies/plan.toml +28 -12
  306. package/dist/src/policy/policies/read-only.toml +11 -10
  307. package/dist/src/policy/policies/write.toml +11 -10
  308. package/dist/src/policy/policies/yolo.toml +11 -10
  309. package/dist/src/policy/policy-engine.d.ts +16 -3
  310. package/dist/src/policy/policy-engine.js +154 -29
  311. package/dist/src/policy/policy-engine.js.map +1 -1
  312. package/dist/src/policy/policy-engine.test.js +480 -9
  313. package/dist/src/policy/policy-engine.test.js.map +1 -1
  314. package/dist/src/policy/policy-updater.test.js +11 -6
  315. package/dist/src/policy/policy-updater.test.js.map +1 -1
  316. package/dist/src/policy/toml-loader.d.ts +13 -2
  317. package/dist/src/policy/toml-loader.js +55 -34
  318. package/dist/src/policy/toml-loader.js.map +1 -1
  319. package/dist/src/policy/toml-loader.test.js +115 -7
  320. package/dist/src/policy/toml-loader.test.js.map +1 -1
  321. package/dist/src/policy/types.d.ts +18 -1
  322. package/dist/src/policy/types.js +1 -0
  323. package/dist/src/policy/types.js.map +1 -1
  324. package/dist/src/policy/workspace-policy.test.d.ts +6 -0
  325. package/dist/src/policy/workspace-policy.test.js +231 -0
  326. package/dist/src/policy/workspace-policy.test.js.map +1 -0
  327. package/dist/src/prompts/promptProvider.js +11 -13
  328. package/dist/src/prompts/promptProvider.js.map +1 -1
  329. package/dist/src/prompts/promptProvider.test.js +64 -3
  330. package/dist/src/prompts/promptProvider.test.js.map +1 -1
  331. package/dist/src/prompts/snippets.js +41 -10
  332. package/dist/src/prompts/snippets.js.map +1 -1
  333. package/dist/src/prompts/snippets.legacy.js +1 -0
  334. package/dist/src/prompts/snippets.legacy.js.map +1 -1
  335. package/dist/src/routing/modelRouterService.js +3 -1
  336. package/dist/src/routing/modelRouterService.js.map +1 -1
  337. package/dist/src/routing/modelRouterService.test.js +12 -6
  338. package/dist/src/routing/modelRouterService.test.js.map +1 -1
  339. package/dist/src/routing/strategies/approvalModeStrategy.d.ts +18 -0
  340. package/dist/src/routing/strategies/approvalModeStrategy.js +58 -0
  341. package/dist/src/routing/strategies/approvalModeStrategy.js.map +1 -0
  342. package/dist/src/routing/strategies/approvalModeStrategy.test.d.ts +6 -0
  343. package/dist/src/routing/strategies/approvalModeStrategy.test.js +110 -0
  344. package/dist/src/routing/strategies/approvalModeStrategy.test.js.map +1 -0
  345. package/dist/src/safety/checker-runner.js +1 -0
  346. package/dist/src/safety/checker-runner.js.map +1 -1
  347. package/dist/src/safety/conseca/conseca.d.ts +31 -0
  348. package/dist/src/safety/conseca/conseca.js +105 -0
  349. package/dist/src/safety/conseca/conseca.js.map +1 -0
  350. package/dist/src/safety/conseca/conseca.test.d.ts +6 -0
  351. package/dist/src/safety/conseca/conseca.test.js +226 -0
  352. package/dist/src/safety/conseca/conseca.test.js.map +1 -0
  353. package/dist/src/safety/conseca/integration.test.d.ts +6 -0
  354. package/dist/src/safety/conseca/integration.test.js +19 -0
  355. package/dist/src/safety/conseca/integration.test.js.map +1 -0
  356. package/dist/src/safety/conseca/policy-enforcer.d.ts +13 -0
  357. package/dist/src/safety/conseca/policy-enforcer.js +135 -0
  358. package/dist/src/safety/conseca/policy-enforcer.js.map +1 -0
  359. package/dist/src/safety/conseca/policy-enforcer.test.d.ts +6 -0
  360. package/dist/src/safety/conseca/policy-enforcer.test.js +141 -0
  361. package/dist/src/safety/conseca/policy-enforcer.test.js.map +1 -0
  362. package/dist/src/safety/conseca/policy-generator.d.ts +15 -0
  363. package/dist/src/safety/conseca/policy-generator.js +144 -0
  364. package/dist/src/safety/conseca/policy-generator.js.map +1 -0
  365. package/dist/src/safety/conseca/policy-generator.test.d.ts +6 -0
  366. package/dist/src/safety/conseca/policy-generator.test.js +84 -0
  367. package/dist/src/safety/conseca/policy-generator.test.js.map +1 -0
  368. package/dist/src/safety/conseca/types.d.ts +15 -0
  369. package/dist/src/safety/conseca/types.js +7 -0
  370. package/dist/src/safety/conseca/types.js.map +1 -0
  371. package/dist/src/safety/context-builder.d.ts +3 -3
  372. package/dist/src/safety/context-builder.js +60 -4
  373. package/dist/src/safety/context-builder.js.map +1 -1
  374. package/dist/src/safety/context-builder.test.js +98 -18
  375. package/dist/src/safety/context-builder.test.js.map +1 -1
  376. package/dist/src/safety/protocol.d.ts +4 -0
  377. package/dist/src/safety/registry.d.ts +2 -1
  378. package/dist/src/safety/registry.js +14 -4
  379. package/dist/src/safety/registry.js.map +1 -1
  380. package/dist/src/safety/registry.test.js +5 -2
  381. package/dist/src/safety/registry.test.js.map +1 -1
  382. package/dist/src/scheduler/confirmation.d.ts +0 -13
  383. package/dist/src/scheduler/confirmation.js +1 -1
  384. package/dist/src/scheduler/confirmation.js.map +1 -1
  385. package/dist/src/scheduler/policy.js +6 -2
  386. package/dist/src/scheduler/policy.js.map +1 -1
  387. package/dist/src/scheduler/policy.test.js +4 -3
  388. package/dist/src/scheduler/policy.test.js.map +1 -1
  389. package/dist/src/scheduler/scheduler.d.ts +3 -1
  390. package/dist/src/scheduler/scheduler.js +148 -28
  391. package/dist/src/scheduler/scheduler.js.map +1 -1
  392. package/dist/src/scheduler/scheduler.test.js +341 -242
  393. package/dist/src/scheduler/scheduler.test.js.map +1 -1
  394. package/dist/src/scheduler/scheduler_parallel.test.d.ts +6 -0
  395. package/dist/src/scheduler/scheduler_parallel.test.js +309 -0
  396. package/dist/src/scheduler/scheduler_parallel.test.js.map +1 -0
  397. package/dist/src/scheduler/state-manager.d.ts +8 -0
  398. package/dist/src/scheduler/state-manager.js +30 -2
  399. package/dist/src/scheduler/state-manager.js.map +1 -1
  400. package/dist/src/scheduler/state-manager.test.js +61 -0
  401. package/dist/src/scheduler/state-manager.test.js.map +1 -1
  402. package/dist/src/scheduler/tool-executor.js +15 -7
  403. package/dist/src/scheduler/tool-executor.js.map +1 -1
  404. package/dist/src/scheduler/tool-executor.test.js +1 -1
  405. package/dist/src/scheduler/tool-executor.test.js.map +1 -1
  406. package/dist/src/scheduler/types.d.ts +23 -0
  407. package/dist/src/services/FolderTrustDiscoveryService.d.ts +32 -0
  408. package/dist/src/services/FolderTrustDiscoveryService.js +167 -0
  409. package/dist/src/services/FolderTrustDiscoveryService.js.map +1 -0
  410. package/dist/src/services/FolderTrustDiscoveryService.test.d.ts +6 -0
  411. package/dist/src/services/FolderTrustDiscoveryService.test.js +118 -0
  412. package/dist/src/services/FolderTrustDiscoveryService.test.js.map +1 -0
  413. package/dist/src/services/chatCompressionService.d.ts +0 -14
  414. package/dist/src/services/chatCompressionService.js +29 -7
  415. package/dist/src/services/chatCompressionService.js.map +1 -1
  416. package/dist/src/services/chatCompressionService.test.js +3 -1
  417. package/dist/src/services/chatCompressionService.test.js.map +1 -1
  418. package/dist/src/services/chatRecordingService.d.ts +7 -1
  419. package/dist/src/services/chatRecordingService.js +12 -1
  420. package/dist/src/services/chatRecordingService.js.map +1 -1
  421. package/dist/src/services/chatRecordingService.test.js +34 -0
  422. package/dist/src/services/chatRecordingService.test.js.map +1 -1
  423. package/dist/src/services/loopDetectionService.js +1 -2
  424. package/dist/src/services/loopDetectionService.js.map +1 -1
  425. package/dist/src/services/sessionSummaryUtils.js +3 -0
  426. package/dist/src/services/sessionSummaryUtils.js.map +1 -1
  427. package/dist/src/services/shellExecutionService.js +6 -0
  428. package/dist/src/services/shellExecutionService.js.map +1 -1
  429. package/dist/src/skills/skillLoader.js +2 -2
  430. package/dist/src/skills/skillLoader.js.map +1 -1
  431. package/dist/src/telemetry/clearcut-logger/clearcut-logger.d.ts +3 -1
  432. package/dist/src/telemetry/clearcut-logger/clearcut-logger.js +35 -4
  433. package/dist/src/telemetry/clearcut-logger/clearcut-logger.js.map +1 -1
  434. package/dist/src/telemetry/clearcut-logger/clearcut-logger.test.d.ts +0 -1
  435. package/dist/src/telemetry/clearcut-logger/clearcut-logger.test.js +19 -5
  436. package/dist/src/telemetry/clearcut-logger/clearcut-logger.test.js.map +1 -1
  437. package/dist/src/telemetry/clearcut-logger/event-metadata-key.d.ts +14 -1
  438. package/dist/src/telemetry/clearcut-logger/event-metadata-key.js +29 -1
  439. package/dist/src/telemetry/clearcut-logger/event-metadata-key.js.map +1 -1
  440. package/dist/src/telemetry/conseca-logger.d.ts +9 -0
  441. package/dist/src/telemetry/conseca-logger.js +91 -0
  442. package/dist/src/telemetry/conseca-logger.js.map +1 -0
  443. package/dist/src/telemetry/conseca-logger.test.d.ts +6 -0
  444. package/dist/src/telemetry/conseca-logger.test.js +89 -0
  445. package/dist/src/telemetry/conseca-logger.test.js.map +1 -0
  446. package/dist/src/telemetry/gcp-exporters.js +1 -2
  447. package/dist/src/telemetry/gcp-exporters.js.map +1 -1
  448. package/dist/src/telemetry/index.d.ts +2 -1
  449. package/dist/src/telemetry/index.js +2 -1
  450. package/dist/src/telemetry/index.js.map +1 -1
  451. package/dist/src/telemetry/integration.test.circular.js +3 -0
  452. package/dist/src/telemetry/integration.test.circular.js.map +1 -1
  453. package/dist/src/telemetry/loggers.d.ts +1 -2
  454. package/dist/src/telemetry/loggers.js +3 -13
  455. package/dist/src/telemetry/loggers.js.map +1 -1
  456. package/dist/src/telemetry/loggers.test.circular.js +3 -0
  457. package/dist/src/telemetry/loggers.test.circular.js.map +1 -1
  458. package/dist/src/telemetry/loggers.test.js +6 -5
  459. package/dist/src/telemetry/loggers.test.js.map +1 -1
  460. package/dist/src/telemetry/metrics.d.ts +1 -3
  461. package/dist/src/telemetry/metrics.js +3 -2
  462. package/dist/src/telemetry/metrics.js.map +1 -1
  463. package/dist/src/telemetry/metrics.test.js +7 -3
  464. package/dist/src/telemetry/metrics.test.js.map +1 -1
  465. package/dist/src/telemetry/sanitize.test.js +19 -18
  466. package/dist/src/telemetry/sanitize.test.js.map +1 -1
  467. package/dist/src/telemetry/semantic.d.ts +7 -9
  468. package/dist/src/telemetry/semantic.js +8 -8
  469. package/dist/src/telemetry/semantic.js.map +1 -1
  470. package/dist/src/telemetry/types.d.ts +42 -4
  471. package/dist/src/telemetry/types.js +87 -2
  472. package/dist/src/telemetry/types.js.map +1 -1
  473. package/dist/src/telemetry/uiTelemetry.d.ts +1 -2
  474. package/dist/src/telemetry/uiTelemetry.js.map +1 -1
  475. package/dist/src/telemetry/uiTelemetry.test.js +1 -2
  476. package/dist/src/telemetry/uiTelemetry.test.js.map +1 -1
  477. package/dist/src/tools/ask-user.test.js +1 -19
  478. package/dist/src/tools/ask-user.test.js.map +1 -1
  479. package/dist/src/tools/confirmation-policy.test.js +14 -17
  480. package/dist/src/tools/confirmation-policy.test.js.map +1 -1
  481. package/dist/src/tools/definitions/dynamic-declaration-helpers.js +1 -1
  482. package/dist/src/tools/definitions/dynamic-declaration-helpers.js.map +1 -1
  483. package/dist/src/tools/definitions/model-family-sets/default-legacy.js +14 -16
  484. package/dist/src/tools/definitions/model-family-sets/default-legacy.js.map +1 -1
  485. package/dist/src/tools/definitions/model-family-sets/gemini-3.js +24 -59
  486. package/dist/src/tools/definitions/model-family-sets/gemini-3.js.map +1 -1
  487. package/dist/src/tools/diff-utils.d.ts +9 -0
  488. package/dist/src/tools/diff-utils.js +66 -0
  489. package/dist/src/tools/diff-utils.js.map +1 -0
  490. package/dist/src/tools/diff-utils.test.d.ts +6 -0
  491. package/dist/src/tools/diff-utils.test.js +53 -0
  492. package/dist/src/tools/diff-utils.test.js.map +1 -0
  493. package/dist/src/tools/edit.d.ts +9 -4
  494. package/dist/src/tools/edit.js +203 -34
  495. package/dist/src/tools/edit.js.map +1 -1
  496. package/dist/src/tools/edit.test.js +225 -10
  497. package/dist/src/tools/edit.test.js.map +1 -1
  498. package/dist/src/tools/enter-plan-mode.js +1 -1
  499. package/dist/src/tools/enter-plan-mode.js.map +1 -1
  500. package/dist/src/tools/enter-plan-mode.test.js +1 -1
  501. package/dist/src/tools/enter-plan-mode.test.js.map +1 -1
  502. package/dist/src/tools/exit-plan-mode.js +10 -24
  503. package/dist/src/tools/exit-plan-mode.js.map +1 -1
  504. package/dist/src/tools/exit-plan-mode.test.js +1 -1
  505. package/dist/src/tools/exit-plan-mode.test.js.map +1 -1
  506. package/dist/src/tools/grep-utils.d.ts +49 -0
  507. package/dist/src/tools/grep-utils.js +139 -0
  508. package/dist/src/tools/grep-utils.js.map +1 -0
  509. package/dist/src/tools/grep.js +4 -44
  510. package/dist/src/tools/grep.js.map +1 -1
  511. package/dist/src/tools/grep.test.js +21 -2
  512. package/dist/src/tools/grep.test.js.map +1 -1
  513. package/dist/src/tools/ls.js +6 -1
  514. package/dist/src/tools/ls.js.map +1 -1
  515. package/dist/src/tools/ls.test.js +2 -2
  516. package/dist/src/tools/ls.test.js.map +1 -1
  517. package/dist/src/tools/mcp-client-manager.js +16 -18
  518. package/dist/src/tools/mcp-client-manager.js.map +1 -1
  519. package/dist/src/tools/mcp-client-manager.test.js +51 -0
  520. package/dist/src/tools/mcp-client-manager.test.js.map +1 -1
  521. package/dist/src/tools/mcp-client.d.ts +22 -1
  522. package/dist/src/tools/mcp-client.js +95 -36
  523. package/dist/src/tools/mcp-client.js.map +1 -1
  524. package/dist/src/tools/mcp-client.test.js +148 -20
  525. package/dist/src/tools/mcp-client.test.js.map +1 -1
  526. package/dist/src/tools/mcp-tool.d.ts +15 -5
  527. package/dist/src/tools/mcp-tool.js +36 -8
  528. package/dist/src/tools/mcp-tool.js.map +1 -1
  529. package/dist/src/tools/memoryTool.js +1 -1
  530. package/dist/src/tools/memoryTool.js.map +1 -1
  531. package/dist/src/tools/memoryTool.test.js +5 -0
  532. package/dist/src/tools/memoryTool.test.js.map +1 -1
  533. package/dist/src/tools/omissionPlaceholderDetector.d.ts +15 -0
  534. package/dist/src/tools/omissionPlaceholderDetector.js +90 -0
  535. package/dist/src/tools/omissionPlaceholderDetector.js.map +1 -0
  536. package/dist/src/tools/omissionPlaceholderDetector.test.d.ts +6 -0
  537. package/dist/src/tools/omissionPlaceholderDetector.test.js +49 -0
  538. package/dist/src/tools/omissionPlaceholderDetector.test.js.map +1 -0
  539. package/dist/src/tools/read-file.d.ts +4 -4
  540. package/dist/src/tools/read-file.js +17 -10
  541. package/dist/src/tools/read-file.js.map +1 -1
  542. package/dist/src/tools/read-file.test.js +20 -10
  543. package/dist/src/tools/read-file.test.js.map +1 -1
  544. package/dist/src/tools/ripGrep.js +49 -46
  545. package/dist/src/tools/ripGrep.js.map +1 -1
  546. package/dist/src/tools/ripGrep.test.js +52 -37
  547. package/dist/src/tools/ripGrep.test.js.map +1 -1
  548. package/dist/src/tools/shell.d.ts +2 -2
  549. package/dist/src/tools/shell.js +2 -2
  550. package/dist/src/tools/shell.js.map +1 -1
  551. package/dist/src/tools/shell.test.js +1 -2
  552. package/dist/src/tools/shell.test.js.map +1 -1
  553. package/dist/src/tools/tool-names.d.ts +0 -6
  554. package/dist/src/tools/tool-names.js +0 -15
  555. package/dist/src/tools/tool-names.js.map +1 -1
  556. package/dist/src/tools/tool-registry.d.ts +1 -0
  557. package/dist/src/tools/tool-registry.js +33 -6
  558. package/dist/src/tools/tool-registry.js.map +1 -1
  559. package/dist/src/tools/tool-registry.test.js +47 -0
  560. package/dist/src/tools/tool-registry.test.js.map +1 -1
  561. package/dist/src/tools/tools.d.ts +21 -1
  562. package/dist/src/tools/tools.js +19 -3
  563. package/dist/src/tools/tools.js.map +1 -1
  564. package/dist/src/tools/tools.test.js +24 -0
  565. package/dist/src/tools/tools.test.js.map +1 -1
  566. package/dist/src/tools/web-fetch.d.ts +9 -1
  567. package/dist/src/tools/web-fetch.js +273 -34
  568. package/dist/src/tools/web-fetch.js.map +1 -1
  569. package/dist/src/tools/web-fetch.test.js +303 -30
  570. package/dist/src/tools/web-fetch.test.js.map +1 -1
  571. package/dist/src/tools/write-file.js +14 -10
  572. package/dist/src/tools/write-file.js.map +1 -1
  573. package/dist/src/tools/write-file.test.js +75 -0
  574. package/dist/src/tools/write-file.test.js.map +1 -1
  575. package/dist/src/tools/write-todos.d.ts +2 -2
  576. package/dist/src/tools/write-todos.js +1 -1
  577. package/dist/src/tools/write-todos.js.map +1 -1
  578. package/dist/src/tools/xcode-mcp-fix-transport.js +4 -1
  579. package/dist/src/tools/xcode-mcp-fix-transport.js.map +1 -1
  580. package/dist/src/utils/approvalModeUtils.d.ts +14 -0
  581. package/dist/src/utils/approvalModeUtils.js +35 -0
  582. package/dist/src/utils/approvalModeUtils.js.map +1 -0
  583. package/dist/src/utils/approvalModeUtils.test.d.ts +6 -0
  584. package/dist/src/utils/approvalModeUtils.test.js +36 -0
  585. package/dist/src/utils/approvalModeUtils.test.js.map +1 -0
  586. package/dist/src/utils/authConsent.d.ts +1 -1
  587. package/dist/src/utils/authConsent.js +10 -8
  588. package/dist/src/utils/authConsent.js.map +1 -1
  589. package/dist/src/utils/authConsent.test.js +89 -44
  590. package/dist/src/utils/authConsent.test.js.map +1 -1
  591. package/dist/src/utils/compatibility.d.ts +41 -0
  592. package/dist/src/utils/compatibility.js +112 -0
  593. package/dist/src/utils/compatibility.js.map +1 -0
  594. package/dist/src/utils/compatibility.test.d.ts +6 -0
  595. package/dist/src/utils/compatibility.test.js +233 -0
  596. package/dist/src/utils/compatibility.test.js.map +1 -0
  597. package/dist/src/utils/editCorrector.js +22 -29
  598. package/dist/src/utils/editCorrector.js.map +1 -1
  599. package/dist/src/utils/editCorrector.test.js.map +1 -1
  600. package/dist/src/utils/envExpansion.d.ts +18 -0
  601. package/dist/src/utils/envExpansion.js +46 -0
  602. package/dist/src/utils/envExpansion.js.map +1 -0
  603. package/dist/src/utils/envExpansion.test.d.ts +6 -0
  604. package/dist/src/utils/envExpansion.test.js +110 -0
  605. package/dist/src/utils/envExpansion.test.js.map +1 -0
  606. package/dist/src/utils/errors.d.ts +1 -0
  607. package/dist/src/utils/errors.js +55 -10
  608. package/dist/src/utils/errors.js.map +1 -1
  609. package/dist/src/utils/errors.test.js +27 -1
  610. package/dist/src/utils/errors.test.js.map +1 -1
  611. package/dist/src/utils/events.d.ts +17 -0
  612. package/dist/src/utils/events.js +12 -0
  613. package/dist/src/utils/events.js.map +1 -1
  614. package/dist/src/utils/events.test.d.ts +1 -1
  615. package/dist/src/utils/events.test.js +50 -3
  616. package/dist/src/utils/events.test.js.map +1 -1
  617. package/dist/src/utils/fastAckHelper.js +2 -1
  618. package/dist/src/utils/fastAckHelper.js.map +1 -1
  619. package/dist/src/utils/fetch.d.ts +1 -1
  620. package/dist/src/utils/fetch.js +15 -2
  621. package/dist/src/utils/fetch.js.map +1 -1
  622. package/dist/src/utils/fileDiffUtils.d.ts +2 -2
  623. package/dist/src/utils/fileDiffUtils.js +1 -2
  624. package/dist/src/utils/fileDiffUtils.js.map +1 -1
  625. package/dist/src/utils/fileUtils.d.ts +5 -3
  626. package/dist/src/utils/fileUtils.js +25 -16
  627. package/dist/src/utils/fileUtils.js.map +1 -1
  628. package/dist/src/utils/fileUtils.test.js +14 -13
  629. package/dist/src/utils/fileUtils.test.js.map +1 -1
  630. package/dist/src/utils/filesearch/fileSearch.js +4 -1
  631. package/dist/src/utils/filesearch/fileSearch.js.map +1 -1
  632. package/dist/src/utils/getFolderStructure.test.js +4 -5
  633. package/dist/src/utils/getFolderStructure.test.js.map +1 -1
  634. package/dist/src/utils/getPty.js +4 -0
  635. package/dist/src/utils/getPty.js.map +1 -1
  636. package/dist/src/utils/googleErrors.js +29 -5
  637. package/dist/src/utils/googleErrors.js.map +1 -1
  638. package/dist/src/utils/googleQuotaErrors.js +10 -0
  639. package/dist/src/utils/googleQuotaErrors.js.map +1 -1
  640. package/dist/src/utils/googleQuotaErrors.test.js +16 -1
  641. package/dist/src/utils/googleQuotaErrors.test.js.map +1 -1
  642. package/dist/src/utils/memoryDiscovery.js +2 -0
  643. package/dist/src/utils/memoryDiscovery.js.map +1 -1
  644. package/dist/src/utils/memoryDiscovery.test.js +1 -2
  645. package/dist/src/utils/memoryDiscovery.test.js.map +1 -1
  646. package/dist/src/utils/retry.d.ts +1 -1
  647. package/dist/src/utils/retry.js +9 -4
  648. package/dist/src/utils/retry.js.map +1 -1
  649. package/dist/src/utils/retry.test.js +15 -12
  650. package/dist/src/utils/retry.test.js.map +1 -1
  651. package/dist/src/utils/safeJsonStringify.js +3 -0
  652. package/dist/src/utils/safeJsonStringify.js.map +1 -1
  653. package/dist/src/utils/schemaValidator.js +5 -3
  654. package/dist/src/utils/schemaValidator.js.map +1 -1
  655. package/dist/src/utils/session.d.ts +1 -0
  656. package/dist/src/utils/session.js +3 -0
  657. package/dist/src/utils/session.js.map +1 -1
  658. package/dist/src/utils/sessionUtils.d.ts +14 -0
  659. package/dist/src/utils/sessionUtils.js +113 -0
  660. package/dist/src/utils/sessionUtils.js.map +1 -0
  661. package/dist/src/utils/sessionUtils.test.d.ts +1 -0
  662. package/dist/src/utils/sessionUtils.test.js +137 -0
  663. package/dist/src/utils/sessionUtils.test.js.map +1 -0
  664. package/dist/src/utils/shell-utils.js +1 -0
  665. package/dist/src/utils/shell-utils.js.map +1 -1
  666. package/dist/src/utils/stdio.js +6 -0
  667. package/dist/src/utils/stdio.js.map +1 -1
  668. package/dist/src/utils/textUtils.d.ts +9 -0
  669. package/dist/src/utils/textUtils.js +15 -0
  670. package/dist/src/utils/textUtils.js.map +1 -1
  671. package/dist/src/utils/textUtils.test.js +42 -1
  672. package/dist/src/utils/textUtils.test.js.map +1 -1
  673. package/dist/src/utils/toolCallContext.d.ts +0 -5
  674. package/dist/src/utils/toolCallContext.js +1 -1
  675. package/dist/src/utils/toolCallContext.js.map +1 -1
  676. package/dist/src/utils/userAccountManager.js +3 -0
  677. package/dist/src/utils/userAccountManager.js.map +1 -1
  678. package/dist/tsconfig.tsbuildinfo +1 -1
  679. package/package.json +6 -3
  680. package/dist/docs/architecture.md +0 -80
  681. package/dist/docs/cli/index.md +0 -123
  682. package/dist/docs/core/concepts.md +0 -137
  683. package/dist/docs/get-started/configuration-v1.md +0 -882
  684. package/dist/google-gemini-cli-core-0.30.0-preview.5.tgz +0 -0
  685. /package/dist/docs/{core → reference}/memport.md +0 -0
  686. /package/dist/docs/{core → reference}/tools-api.md +0 -0
  687. /package/dist/docs/{cli → resources}/uninstall.md +0 -0
@@ -0,0 +1,109 @@
1
+ /**
2
+ * @license
3
+ * Copyright 2026 Google LLC
4
+ * SPDX-License-Identifier: Apache-2.0
5
+ */
6
+ import { LocalAgentExecutor } from '../local-executor.js';
7
+ import { BaseToolInvocation } from '../../tools/tools.js';
8
+ import { ToolErrorType } from '../../tools/tool-error.js';
9
+ import { createBrowserAgentDefinition, cleanupBrowserAgent, } from './browserAgentFactory.js';
10
+ const INPUT_PREVIEW_MAX_LENGTH = 50;
11
+ const DESCRIPTION_MAX_LENGTH = 200;
12
+ /**
13
+ * Browser agent invocation with async tool setup.
14
+ *
15
+ * This invocation handles the browser agent's special requirements:
16
+ * - MCP connection and tool wrapping at invocation time
17
+ * - Browser cleanup after execution
18
+ */
19
+ export class BrowserAgentInvocation extends BaseToolInvocation {
20
+ config;
21
+ constructor(config, params, messageBus, _toolName, _toolDisplayName) {
22
+ // Note: BrowserAgentDefinition is a factory function, so we use hardcoded names
23
+ super(params, messageBus, _toolName ?? 'browser_agent', _toolDisplayName ?? 'Browser Agent');
24
+ this.config = config;
25
+ }
26
+ /**
27
+ * Returns a concise, human-readable description of the invocation.
28
+ */
29
+ getDescription() {
30
+ const inputSummary = Object.entries(this.params)
31
+ .map(([key, value]) => `${key}: ${String(value).slice(0, INPUT_PREVIEW_MAX_LENGTH)}`)
32
+ .join(', ');
33
+ const description = `Running browser agent with inputs: { ${inputSummary} }`;
34
+ return description.slice(0, DESCRIPTION_MAX_LENGTH);
35
+ }
36
+ /**
37
+ * Executes the browser agent.
38
+ *
39
+ * This method:
40
+ * 1. Creates browser manager and MCP connection
41
+ * 2. Wraps MCP tools for the isolated registry
42
+ * 3. Runs the agent via LocalAgentExecutor
43
+ * 4. Cleans up browser resources
44
+ */
45
+ async execute(signal, updateOutput) {
46
+ let browserManager;
47
+ try {
48
+ if (updateOutput) {
49
+ updateOutput('🌐 Starting browser agent...\n');
50
+ }
51
+ // Create definition with MCP tools
52
+ const printOutput = updateOutput
53
+ ? (msg) => updateOutput(`🌐 ${msg}\n`)
54
+ : undefined;
55
+ const result = await createBrowserAgentDefinition(this.config, this.messageBus, printOutput);
56
+ const { definition } = result;
57
+ browserManager = result.browserManager;
58
+ if (updateOutput) {
59
+ updateOutput(`🌐 Browser connected. Tools: ${definition.toolConfig?.tools.length ?? 0}\n`);
60
+ }
61
+ // Create activity callback for streaming output
62
+ const onActivity = (activity) => {
63
+ if (!updateOutput)
64
+ return;
65
+ if (activity.type === 'THOUGHT_CHUNK' &&
66
+ typeof activity.data['text'] === 'string') {
67
+ updateOutput(`🌐💭 ${activity.data['text']}`);
68
+ }
69
+ };
70
+ // Create and run executor with the configured definition
71
+ const executor = await LocalAgentExecutor.create(definition, this.config, onActivity);
72
+ const output = await executor.run(this.params, signal);
73
+ const resultContent = `Browser agent finished.
74
+ Termination Reason: ${output.terminate_reason}
75
+ Result:
76
+ ${output.result}`;
77
+ const displayContent = `
78
+ Browser Agent Finished
79
+
80
+ Termination Reason: ${output.terminate_reason}
81
+
82
+ Result:
83
+ ${output.result}
84
+ `;
85
+ return {
86
+ llmContent: [{ text: resultContent }],
87
+ returnDisplay: displayContent,
88
+ };
89
+ }
90
+ catch (error) {
91
+ const errorMessage = error instanceof Error ? error.message : String(error);
92
+ return {
93
+ llmContent: `Browser agent failed. Error: ${errorMessage}`,
94
+ returnDisplay: `Browser Agent Failed\nError: ${errorMessage}`,
95
+ error: {
96
+ message: errorMessage,
97
+ type: ToolErrorType.EXECUTION_FAILED,
98
+ },
99
+ };
100
+ }
101
+ finally {
102
+ // Always cleanup browser resources
103
+ if (browserManager) {
104
+ await cleanupBrowserAgent(browserManager);
105
+ }
106
+ }
107
+ }
108
+ }
109
+ //# sourceMappingURL=browserAgentInvocation.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"browserAgentInvocation.js","sourceRoot":"","sources":["../../../../src/agents/browser/browserAgentInvocation.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,87 @@
1
+ /**
2
+ * @license
3
+ * Copyright 2026 Google LLC
4
+ * SPDX-License-Identifier: Apache-2.0
5
+ */
6
+ import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
7
+ import { BrowserAgentInvocation } from './browserAgentInvocation.js';
8
+ import { makeFakeConfig } from '../../test-utils/config.js';
9
+ // Mock dependencies before imports
10
+ vi.mock('../../utils/debugLogger.js', () => ({
11
+ debugLogger: {
12
+ log: vi.fn(),
13
+ error: vi.fn(),
14
+ },
15
+ }));
16
+ describe('BrowserAgentInvocation', () => {
17
+ let mockConfig;
18
+ let mockMessageBus;
19
+ let mockParams;
20
+ beforeEach(() => {
21
+ vi.clearAllMocks();
22
+ mockConfig = makeFakeConfig({
23
+ agents: {
24
+ overrides: {
25
+ browser_agent: {
26
+ enabled: true,
27
+ },
28
+ },
29
+ browser: {
30
+ headless: false,
31
+ sessionMode: 'isolated',
32
+ },
33
+ },
34
+ });
35
+ mockMessageBus = {
36
+ publish: vi.fn().mockResolvedValue(undefined),
37
+ subscribe: vi.fn(),
38
+ unsubscribe: vi.fn(),
39
+ };
40
+ mockParams = {
41
+ task: 'Navigate to example.com and click the button',
42
+ };
43
+ });
44
+ afterEach(() => {
45
+ vi.restoreAllMocks();
46
+ });
47
+ describe('constructor', () => {
48
+ it('should create invocation with params', () => {
49
+ const invocation = new BrowserAgentInvocation(mockConfig, mockParams, mockMessageBus);
50
+ expect(invocation.params).toEqual(mockParams);
51
+ });
52
+ it('should use browser_agent as default tool name', () => {
53
+ const invocation = new BrowserAgentInvocation(mockConfig, mockParams, mockMessageBus);
54
+ expect(invocation['_toolName']).toBe('browser_agent');
55
+ });
56
+ it('should use custom tool name if provided', () => {
57
+ const invocation = new BrowserAgentInvocation(mockConfig, mockParams, mockMessageBus, 'custom_name', 'Custom Display Name');
58
+ expect(invocation['_toolName']).toBe('custom_name');
59
+ expect(invocation['_toolDisplayName']).toBe('Custom Display Name');
60
+ });
61
+ });
62
+ describe('getDescription', () => {
63
+ it('should return description with input summary', () => {
64
+ const invocation = new BrowserAgentInvocation(mockConfig, mockParams, mockMessageBus);
65
+ const description = invocation.getDescription();
66
+ expect(description).toContain('browser agent');
67
+ expect(description).toContain('task');
68
+ });
69
+ it('should truncate long input values', () => {
70
+ const longParams = {
71
+ task: 'A'.repeat(100),
72
+ };
73
+ const invocation = new BrowserAgentInvocation(mockConfig, longParams, mockMessageBus);
74
+ const description = invocation.getDescription();
75
+ // Should be truncated to max length
76
+ expect(description.length).toBeLessThanOrEqual(200);
77
+ });
78
+ });
79
+ describe('toolLocations', () => {
80
+ it('should return empty array by default', () => {
81
+ const invocation = new BrowserAgentInvocation(mockConfig, mockParams, mockMessageBus);
82
+ const locations = invocation.toolLocations();
83
+ expect(locations).toEqual([]);
84
+ });
85
+ });
86
+ });
87
+ //# sourceMappingURL=browserAgentInvocation.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"browserAgentInvocation.test.js","sourceRoot":"","sources":["../../../../src/agents/browser/browserAgentInvocation.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,110 @@
1
+ /**
2
+ * @license
3
+ * Copyright 2026 Google LLC
4
+ * SPDX-License-Identifier: Apache-2.0
5
+ */
6
+ /**
7
+ * @fileoverview Manages browser lifecycle for the Browser Agent.
8
+ *
9
+ * Handles:
10
+ * - Browser management via chrome-devtools-mcp with --isolated mode
11
+ * - CDP connection via raw MCP SDK Client (NOT registered in main registry)
12
+ * - Visual tools via --experimental-vision flag
13
+ *
14
+ * IMPORTANT: The MCP client here is ISOLATED from the main agent's tool registry.
15
+ * Tools discovered from chrome-devtools-mcp are NOT registered in the main registry.
16
+ * They are wrapped as DeclarativeTools and passed directly to the browser agent.
17
+ */
18
+ import { Client } from '@modelcontextprotocol/sdk/client/index.js';
19
+ import type { Tool as McpTool } from '@modelcontextprotocol/sdk/types.js';
20
+ import type { Config } from '../../config/config.js';
21
+ /**
22
+ * Content item from an MCP tool call response.
23
+ * Can be text or image (for take_screenshot).
24
+ */
25
+ export interface McpContentItem {
26
+ type: 'text' | 'image';
27
+ text?: string;
28
+ /** Base64-encoded image data (for type='image') */
29
+ data?: string;
30
+ /** MIME type of the image (e.g., 'image/png') */
31
+ mimeType?: string;
32
+ }
33
+ /**
34
+ * Result from an MCP tool call.
35
+ */
36
+ export interface McpToolCallResult {
37
+ content?: McpContentItem[];
38
+ isError?: boolean;
39
+ }
40
+ /**
41
+ * Manages browser lifecycle and ISOLATED MCP client for the Browser Agent.
42
+ *
43
+ * The browser is launched and managed by chrome-devtools-mcp in --isolated mode.
44
+ * Visual tools (click_at, etc.) are enabled via --experimental-vision flag.
45
+ *
46
+ * Key isolation property: The MCP client here does NOT register tools
47
+ * in the main ToolRegistry. Tools are kept local to the browser agent.
48
+ */
49
+ export declare class BrowserManager {
50
+ private config;
51
+ private rawMcpClient;
52
+ private mcpTransport;
53
+ private discoveredTools;
54
+ constructor(config: Config);
55
+ /**
56
+ * Gets the raw MCP SDK Client for direct tool calls.
57
+ * This client is ISOLATED from the main tool registry.
58
+ */
59
+ getRawMcpClient(): Promise<Client>;
60
+ /**
61
+ * Gets the tool definitions discovered from the MCP server.
62
+ * These are dynamically fetched from chrome-devtools-mcp.
63
+ */
64
+ getDiscoveredTools(): Promise<McpTool[]>;
65
+ /**
66
+ * Calls a tool on the MCP server.
67
+ *
68
+ * @param toolName The name of the tool to call
69
+ * @param args Arguments to pass to the tool
70
+ * @param signal Optional AbortSignal to cancel the call
71
+ * @returns The result from the MCP server
72
+ */
73
+ callTool(toolName: string, args: Record<string, unknown>, signal?: AbortSignal): Promise<McpToolCallResult>;
74
+ /**
75
+ * Safely maps a raw MCP SDK callTool response to our typed McpToolCallResult
76
+ * without using unsafe type assertions.
77
+ */
78
+ private toResult;
79
+ /**
80
+ * Ensures browser and MCP client are connected.
81
+ */
82
+ ensureConnection(): Promise<void>;
83
+ /**
84
+ * Closes browser and cleans up connections.
85
+ * The browser process is managed by chrome-devtools-mcp, so closing
86
+ * the transport will terminate the browser.
87
+ */
88
+ close(): Promise<void>;
89
+ /**
90
+ * Connects to chrome-devtools-mcp which manages the browser process.
91
+ *
92
+ * Spawns npx chrome-devtools-mcp with:
93
+ * - --isolated: Manages its own browser instance
94
+ * - --experimental-vision: Enables visual tools (click_at, etc.)
95
+ *
96
+ * IMPORTANT: This does NOT use McpClientManager and does NOT register
97
+ * tools in the main ToolRegistry. The connection is isolated to this
98
+ * BrowserManager instance.
99
+ */
100
+ private connectMcp;
101
+ /**
102
+ * Creates an Error with context-specific remediation based on the actual
103
+ * error message and the current sessionMode.
104
+ */
105
+ private createConnectionError;
106
+ /**
107
+ * Discovers tools from the connected MCP server.
108
+ */
109
+ private discoverTools;
110
+ }
@@ -0,0 +1,323 @@
1
+ /**
2
+ * @license
3
+ * Copyright 2026 Google LLC
4
+ * SPDX-License-Identifier: Apache-2.0
5
+ */
6
+ /**
7
+ * @fileoverview Manages browser lifecycle for the Browser Agent.
8
+ *
9
+ * Handles:
10
+ * - Browser management via chrome-devtools-mcp with --isolated mode
11
+ * - CDP connection via raw MCP SDK Client (NOT registered in main registry)
12
+ * - Visual tools via --experimental-vision flag
13
+ *
14
+ * IMPORTANT: The MCP client here is ISOLATED from the main agent's tool registry.
15
+ * Tools discovered from chrome-devtools-mcp are NOT registered in the main registry.
16
+ * They are wrapped as DeclarativeTools and passed directly to the browser agent.
17
+ */
18
+ import { Client } from '@modelcontextprotocol/sdk/client/index.js';
19
+ import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
20
+ import { debugLogger } from '../../utils/debugLogger.js';
21
+ import { Storage } from '../../config/storage.js';
22
+ import * as path from 'node:path';
23
+ // Pin chrome-devtools-mcp version for reproducibility.
24
+ const CHROME_DEVTOOLS_MCP_VERSION = '0.17.1';
25
+ // Default browser profile directory name within ~/.gemini/
26
+ const BROWSER_PROFILE_DIR = 'cli-browser-profile';
27
+ // Default timeout for MCP operations
28
+ const MCP_TIMEOUT_MS = 60_000;
29
+ /**
30
+ * Manages browser lifecycle and ISOLATED MCP client for the Browser Agent.
31
+ *
32
+ * The browser is launched and managed by chrome-devtools-mcp in --isolated mode.
33
+ * Visual tools (click_at, etc.) are enabled via --experimental-vision flag.
34
+ *
35
+ * Key isolation property: The MCP client here does NOT register tools
36
+ * in the main ToolRegistry. Tools are kept local to the browser agent.
37
+ */
38
+ export class BrowserManager {
39
+ config;
40
+ // Raw MCP SDK Client - NOT the wrapper McpClient
41
+ rawMcpClient;
42
+ mcpTransport;
43
+ discoveredTools = [];
44
+ constructor(config) {
45
+ this.config = config;
46
+ }
47
+ /**
48
+ * Gets the raw MCP SDK Client for direct tool calls.
49
+ * This client is ISOLATED from the main tool registry.
50
+ */
51
+ async getRawMcpClient() {
52
+ if (this.rawMcpClient) {
53
+ return this.rawMcpClient;
54
+ }
55
+ await this.ensureConnection();
56
+ if (!this.rawMcpClient) {
57
+ throw new Error('Failed to initialize chrome-devtools MCP client');
58
+ }
59
+ return this.rawMcpClient;
60
+ }
61
+ /**
62
+ * Gets the tool definitions discovered from the MCP server.
63
+ * These are dynamically fetched from chrome-devtools-mcp.
64
+ */
65
+ async getDiscoveredTools() {
66
+ await this.ensureConnection();
67
+ return this.discoveredTools;
68
+ }
69
+ /**
70
+ * Calls a tool on the MCP server.
71
+ *
72
+ * @param toolName The name of the tool to call
73
+ * @param args Arguments to pass to the tool
74
+ * @param signal Optional AbortSignal to cancel the call
75
+ * @returns The result from the MCP server
76
+ */
77
+ async callTool(toolName, args, signal) {
78
+ if (signal?.aborted) {
79
+ throw signal.reason ?? new Error('Operation cancelled');
80
+ }
81
+ const client = await this.getRawMcpClient();
82
+ const callPromise = client.callTool({ name: toolName, arguments: args }, undefined, { timeout: MCP_TIMEOUT_MS });
83
+ // If no signal, just await directly
84
+ if (!signal) {
85
+ return this.toResult(await callPromise);
86
+ }
87
+ // Race the call against the abort signal
88
+ let onAbort;
89
+ try {
90
+ const result = await Promise.race([
91
+ callPromise,
92
+ new Promise((_resolve, reject) => {
93
+ onAbort = () => reject(signal.reason ?? new Error('Operation cancelled'));
94
+ signal.addEventListener('abort', onAbort, { once: true });
95
+ }),
96
+ ]);
97
+ return this.toResult(result);
98
+ }
99
+ finally {
100
+ if (onAbort) {
101
+ signal.removeEventListener('abort', onAbort);
102
+ }
103
+ }
104
+ }
105
+ /**
106
+ * Safely maps a raw MCP SDK callTool response to our typed McpToolCallResult
107
+ * without using unsafe type assertions.
108
+ */
109
+ toResult(raw) {
110
+ return {
111
+ content: Array.isArray(raw.content)
112
+ ? raw.content.map((item) => ({
113
+ type: item.type === 'image' ? 'image' : 'text',
114
+ text: item.text,
115
+ data: item.data,
116
+ mimeType: item.mimeType,
117
+ }))
118
+ : undefined,
119
+ isError: raw.isError === true,
120
+ };
121
+ }
122
+ /**
123
+ * Ensures browser and MCP client are connected.
124
+ */
125
+ async ensureConnection() {
126
+ if (this.rawMcpClient) {
127
+ return;
128
+ }
129
+ await this.connectMcp();
130
+ }
131
+ /**
132
+ * Closes browser and cleans up connections.
133
+ * The browser process is managed by chrome-devtools-mcp, so closing
134
+ * the transport will terminate the browser.
135
+ */
136
+ async close() {
137
+ // Close MCP client first
138
+ if (this.rawMcpClient) {
139
+ try {
140
+ await this.rawMcpClient.close();
141
+ }
142
+ catch (error) {
143
+ debugLogger.error(`Error closing MCP client: ${error instanceof Error ? error.message : String(error)}`);
144
+ }
145
+ this.rawMcpClient = undefined;
146
+ }
147
+ // Close transport (this terminates the npx process and browser)
148
+ if (this.mcpTransport) {
149
+ try {
150
+ await this.mcpTransport.close();
151
+ }
152
+ catch (error) {
153
+ debugLogger.error(`Error closing MCP transport: ${error instanceof Error ? error.message : String(error)}`);
154
+ }
155
+ this.mcpTransport = undefined;
156
+ }
157
+ this.discoveredTools = [];
158
+ }
159
+ /**
160
+ * Connects to chrome-devtools-mcp which manages the browser process.
161
+ *
162
+ * Spawns npx chrome-devtools-mcp with:
163
+ * - --isolated: Manages its own browser instance
164
+ * - --experimental-vision: Enables visual tools (click_at, etc.)
165
+ *
166
+ * IMPORTANT: This does NOT use McpClientManager and does NOT register
167
+ * tools in the main ToolRegistry. The connection is isolated to this
168
+ * BrowserManager instance.
169
+ */
170
+ async connectMcp() {
171
+ debugLogger.log('Connecting isolated MCP client to chrome-devtools-mcp...');
172
+ // Create raw MCP SDK Client (not the wrapper McpClient)
173
+ this.rawMcpClient = new Client({
174
+ name: 'gemini-cli-browser-agent',
175
+ version: '1.0.0',
176
+ }, {
177
+ capabilities: {},
178
+ });
179
+ // Build args for chrome-devtools-mcp
180
+ const browserConfig = this.config.getBrowserAgentConfig();
181
+ const sessionMode = browserConfig.customConfig.sessionMode ?? 'persistent';
182
+ const mcpArgs = [
183
+ '-y',
184
+ `chrome-devtools-mcp@${CHROME_DEVTOOLS_MCP_VERSION}`,
185
+ '--experimental-vision',
186
+ ];
187
+ // Session mode determines how the browser is managed:
188
+ // - "isolated": Temp profile, cleaned up after session (--isolated)
189
+ // - "persistent": Persistent profile at ~/.gemini/cli-browser-profile/ (default)
190
+ // - "existing": Connect to already-running Chrome (--autoConnect, requires
191
+ // remote debugging enabled at chrome://inspect/#remote-debugging)
192
+ if (sessionMode === 'isolated') {
193
+ mcpArgs.push('--isolated');
194
+ }
195
+ else if (sessionMode === 'existing') {
196
+ mcpArgs.push('--autoConnect');
197
+ }
198
+ // Add optional settings from config
199
+ if (browserConfig.customConfig.headless) {
200
+ mcpArgs.push('--headless');
201
+ }
202
+ if (browserConfig.customConfig.profilePath) {
203
+ mcpArgs.push('--userDataDir', browserConfig.customConfig.profilePath);
204
+ }
205
+ else if (sessionMode === 'persistent') {
206
+ // Default persistent profile lives under ~/.gemini/cli-browser-profile
207
+ const defaultProfilePath = path.join(Storage.getGlobalGeminiDir(), BROWSER_PROFILE_DIR);
208
+ mcpArgs.push('--userDataDir', defaultProfilePath);
209
+ }
210
+ debugLogger.log(`Launching chrome-devtools-mcp (${sessionMode} mode) with args: ${mcpArgs.join(' ')}`);
211
+ // Create stdio transport to npx chrome-devtools-mcp.
212
+ // stderr is piped (not inherited) to prevent MCP server banners and
213
+ // warnings from corrupting the UI in alternate buffer mode.
214
+ this.mcpTransport = new StdioClientTransport({
215
+ command: 'npx',
216
+ args: mcpArgs,
217
+ stderr: 'pipe',
218
+ });
219
+ // Forward piped stderr to debugLogger so it's visible with --debug.
220
+ const stderrStream = this.mcpTransport.stderr;
221
+ if (stderrStream) {
222
+ stderrStream.on('data', (chunk) => {
223
+ debugLogger.log(`[chrome-devtools-mcp stderr] ${chunk.toString().trimEnd()}`);
224
+ });
225
+ }
226
+ this.mcpTransport.onclose = () => {
227
+ debugLogger.error('chrome-devtools-mcp transport closed unexpectedly. ' +
228
+ 'The MCP server process may have crashed.');
229
+ this.rawMcpClient = undefined;
230
+ };
231
+ this.mcpTransport.onerror = (error) => {
232
+ debugLogger.error(`chrome-devtools-mcp transport error: ${error.message}`);
233
+ };
234
+ // Connect to MCP server — use a shorter timeout for 'existing' mode
235
+ // since it should connect quickly if remote debugging is enabled.
236
+ const connectTimeoutMs = sessionMode === 'existing' ? 15_000 : MCP_TIMEOUT_MS;
237
+ let timeoutId;
238
+ try {
239
+ await Promise.race([
240
+ (async () => {
241
+ await this.rawMcpClient.connect(this.mcpTransport);
242
+ debugLogger.log('MCP client connected to chrome-devtools-mcp');
243
+ await this.discoverTools();
244
+ })(),
245
+ new Promise((_, reject) => {
246
+ timeoutId = setTimeout(() => reject(new Error(`Timed out connecting to chrome-devtools-mcp (${connectTimeoutMs}ms)`)), connectTimeoutMs);
247
+ }),
248
+ ]);
249
+ }
250
+ catch (error) {
251
+ await this.close();
252
+ // Provide error-specific, session-mode-aware remediation
253
+ throw this.createConnectionError(error instanceof Error ? error.message : String(error), sessionMode);
254
+ }
255
+ finally {
256
+ if (timeoutId !== undefined) {
257
+ clearTimeout(timeoutId);
258
+ }
259
+ }
260
+ }
261
+ /**
262
+ * Creates an Error with context-specific remediation based on the actual
263
+ * error message and the current sessionMode.
264
+ */
265
+ createConnectionError(message, sessionMode) {
266
+ const lowerMessage = message.toLowerCase();
267
+ // "already running for the current profile" — persistent mode profile lock
268
+ if (lowerMessage.includes('already running')) {
269
+ if (sessionMode === 'persistent' || sessionMode === 'isolated') {
270
+ return new Error(`Could not connect to Chrome: ${message}\n\n` +
271
+ `The Chrome profile is locked by another running instance.\n` +
272
+ `To fix this:\n` +
273
+ ` 1. Close all Chrome windows using this profile, OR\n` +
274
+ ` 2. Set sessionMode to "isolated" in settings.json to use a temporary profile, OR\n` +
275
+ ` 3. Set profilePath in settings.json to use a different profile directory`);
276
+ }
277
+ // existing mode — shouldn't normally hit this, but handle gracefully
278
+ return new Error(`Could not connect to Chrome: ${message}\n\n` +
279
+ `The Chrome profile is locked.\n` +
280
+ `Close other Chrome instances and try again.`);
281
+ }
282
+ // Timeout errors
283
+ if (lowerMessage.includes('timed out')) {
284
+ if (sessionMode === 'existing') {
285
+ return new Error(`Timed out connecting to Chrome: ${message}\n\n` +
286
+ `To use sessionMode "existing", you must:\n` +
287
+ ` 1. Open Chrome (version 144+)\n` +
288
+ ` 2. Navigate to chrome://inspect/#remote-debugging\n` +
289
+ ` 3. Enable remote debugging\n\n` +
290
+ `Alternatively, set sessionMode to "persistent" (default) in settings.json to launch a dedicated browser.`);
291
+ }
292
+ return new Error(`Timed out connecting to Chrome: ${message}\n\n` +
293
+ `Possible causes:\n` +
294
+ ` 1. Chrome is not installed or not in PATH\n` +
295
+ ` 2. npx cannot download chrome-devtools-mcp (check network/proxy)\n` +
296
+ ` 3. Chrome failed to start (try setting headless: true in settings.json)`);
297
+ }
298
+ // Generic "existing" mode failures (connection refused, etc.)
299
+ if (sessionMode === 'existing') {
300
+ return new Error(`Failed to connect to existing Chrome instance: ${message}\n\n` +
301
+ `To use sessionMode "existing", you must:\n` +
302
+ ` 1. Open Chrome (version 144+)\n` +
303
+ ` 2. Navigate to chrome://inspect/#remote-debugging\n` +
304
+ ` 3. Enable remote debugging\n\n` +
305
+ `Alternatively, set sessionMode to "persistent" (default) in settings.json to launch a dedicated browser.`);
306
+ }
307
+ // Generic fallback — include sessionMode for debugging context
308
+ return new Error(`Failed to connect to Chrome (sessionMode: ${sessionMode}): ${message}`);
309
+ }
310
+ /**
311
+ * Discovers tools from the connected MCP server.
312
+ */
313
+ async discoverTools() {
314
+ if (!this.rawMcpClient) {
315
+ throw new Error('MCP client not connected');
316
+ }
317
+ const response = await this.rawMcpClient.listTools();
318
+ this.discoveredTools = response.tools;
319
+ debugLogger.log(`Discovered ${this.discoveredTools.length} tools from chrome-devtools-mcp: ` +
320
+ this.discoveredTools.map((t) => t.name).join(', '));
321
+ }
322
+ }
323
+ //# sourceMappingURL=browserManager.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"browserManager.js","sourceRoot":"","sources":["../../../../src/agents/browser/browserManager.ts"],"names":[],"mappings":"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"}