@google/gemini-cli-core 0.30.0-nightly.20260212.099aa9621 → 0.30.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 (380) hide show
  1. package/README.md +3 -4
  2. package/dist/docs/CONTRIBUTING.md +7 -6
  3. package/dist/docs/admin/enterprise-controls.md +115 -0
  4. package/dist/docs/cli/checkpointing.md +2 -3
  5. package/dist/docs/cli/cli-reference.md +4 -5
  6. package/dist/docs/cli/commands.md +358 -325
  7. package/dist/docs/cli/custom-commands.md +3 -0
  8. package/dist/docs/cli/enterprise.md +1 -1
  9. package/dist/docs/cli/gemini-md.md +20 -12
  10. package/dist/docs/cli/headless.md +34 -372
  11. package/dist/docs/cli/index.md +111 -55
  12. package/dist/docs/cli/keyboard-shortcuts.md +41 -34
  13. package/dist/docs/cli/plan-mode.md +6 -2
  14. package/dist/docs/cli/rewind.md +11 -11
  15. package/dist/docs/cli/sandbox.md +3 -2
  16. package/dist/docs/cli/session-management.md +61 -44
  17. package/dist/docs/cli/settings.md +1 -0
  18. package/dist/docs/cli/skills.md +15 -8
  19. package/dist/docs/cli/telemetry.md +18 -4
  20. package/dist/docs/cli/themes.md +85 -51
  21. package/dist/docs/cli/tutorials/automation.md +187 -0
  22. package/dist/docs/cli/tutorials/file-management.md +142 -0
  23. package/dist/docs/cli/tutorials/mcp-setup.md +105 -0
  24. package/dist/docs/cli/tutorials/memory-management.md +126 -0
  25. package/dist/docs/cli/tutorials/session-management.md +105 -0
  26. package/dist/docs/cli/tutorials/shell-commands.md +107 -0
  27. package/dist/docs/cli/tutorials/skills-getting-started.md +36 -31
  28. package/dist/docs/cli/tutorials/task-planning.md +93 -0
  29. package/dist/docs/cli/tutorials/web-tools.md +78 -0
  30. package/dist/docs/core/concepts.md +137 -0
  31. package/dist/docs/core/policy-engine.md +4 -2
  32. package/dist/docs/extensions/best-practices.md +102 -53
  33. package/dist/docs/extensions/index.md +37 -21
  34. package/dist/docs/extensions/reference.md +148 -216
  35. package/dist/docs/extensions/releasing.md +93 -122
  36. package/dist/docs/extensions/writing-extensions.md +87 -76
  37. package/dist/docs/get-started/configuration.md +37 -5
  38. package/dist/docs/get-started/examples.md +39 -119
  39. package/dist/docs/get-started/index.md +6 -4
  40. package/dist/docs/get-started/installation.md +110 -77
  41. package/dist/docs/index.md +133 -108
  42. package/dist/docs/releases.md +2 -2
  43. package/dist/docs/sidebar.json +96 -60
  44. package/dist/docs/tools/activate-skill.md +43 -0
  45. package/dist/docs/tools/ask-user.md +1 -1
  46. package/dist/docs/tools/file-system.md +43 -133
  47. package/dist/docs/tools/index.md +92 -91
  48. package/dist/docs/tools/internal-docs.md +46 -0
  49. package/dist/docs/tools/mcp-server.md +2 -2
  50. package/dist/docs/tools/memory.md +21 -40
  51. package/dist/docs/tools/shell.md +39 -84
  52. package/dist/docs/tools/todos.md +22 -44
  53. package/dist/docs/tools/web-fetch.md +22 -46
  54. package/dist/docs/tools/web-search.md +19 -29
  55. package/dist/src/agents/codebase-investigator.js +5 -5
  56. package/dist/src/agents/codebase-investigator.js.map +1 -1
  57. package/dist/src/agents/local-executor.js +3 -1
  58. package/dist/src/agents/local-executor.js.map +1 -1
  59. package/dist/src/agents/local-executor.test.js +3 -2
  60. package/dist/src/agents/local-executor.test.js.map +1 -1
  61. package/dist/src/code_assist/codeAssist.js +1 -1
  62. package/dist/src/code_assist/codeAssist.js.map +1 -1
  63. package/dist/src/code_assist/codeAssist.test.js +2 -2
  64. package/dist/src/code_assist/codeAssist.test.js.map +1 -1
  65. package/dist/src/code_assist/oauth2.test.js +7 -0
  66. package/dist/src/code_assist/oauth2.test.js.map +1 -1
  67. package/dist/src/code_assist/server.d.ts +3 -2
  68. package/dist/src/code_assist/server.js +6 -2
  69. package/dist/src/code_assist/server.js.map +1 -1
  70. package/dist/src/code_assist/server.test.js +6 -5
  71. package/dist/src/code_assist/server.test.js.map +1 -1
  72. package/dist/src/code_assist/setup.d.ts +2 -1
  73. package/dist/src/code_assist/setup.js +2 -2
  74. package/dist/src/code_assist/setup.js.map +1 -1
  75. package/dist/src/code_assist/setup.test.js +13 -0
  76. package/dist/src/code_assist/setup.test.js.map +1 -1
  77. package/dist/src/config/config.d.ts +7 -1
  78. package/dist/src/config/config.js +19 -7
  79. package/dist/src/config/config.js.map +1 -1
  80. package/dist/src/config/config.test.js +9 -3
  81. package/dist/src/config/config.test.js.map +1 -1
  82. package/dist/src/config/defaultModelConfigs.js +13 -0
  83. package/dist/src/config/defaultModelConfigs.js.map +1 -1
  84. package/dist/src/config/models.d.ts +15 -0
  85. package/dist/src/config/models.js +22 -0
  86. package/dist/src/config/models.js.map +1 -1
  87. package/dist/src/config/models.test.js +38 -1
  88. package/dist/src/config/models.test.js.map +1 -1
  89. package/dist/src/config/storage.d.ts +3 -1
  90. package/dist/src/config/storage.js +12 -1
  91. package/dist/src/config/storage.js.map +1 -1
  92. package/dist/src/config/storage.test.js +12 -1
  93. package/dist/src/config/storage.test.js.map +1 -1
  94. package/dist/src/confirmation-bus/types.d.ts +3 -3
  95. package/dist/src/core/baseLlmClient.d.ts +9 -0
  96. package/dist/src/core/baseLlmClient.js +7 -6
  97. package/dist/src/core/baseLlmClient.js.map +1 -1
  98. package/dist/src/core/baseLlmClient.test.js +17 -6
  99. package/dist/src/core/baseLlmClient.test.js.map +1 -1
  100. package/dist/src/core/client.d.ts +2 -1
  101. package/dist/src/core/client.js +6 -3
  102. package/dist/src/core/client.js.map +1 -1
  103. package/dist/src/core/client.test.js +16 -14
  104. package/dist/src/core/client.test.js.map +1 -1
  105. package/dist/src/core/contentGenerator.d.ts +12 -2
  106. package/dist/src/core/contentGenerator.js +20 -0
  107. package/dist/src/core/contentGenerator.js.map +1 -1
  108. package/dist/src/core/coreToolScheduler.js +89 -66
  109. package/dist/src/core/coreToolScheduler.js.map +1 -1
  110. package/dist/src/core/coreToolScheduler.test.js +122 -55
  111. package/dist/src/core/coreToolScheduler.test.js.map +1 -1
  112. package/dist/src/core/fakeContentGenerator.d.ts +3 -2
  113. package/dist/src/core/fakeContentGenerator.js +6 -2
  114. package/dist/src/core/fakeContentGenerator.js.map +1 -1
  115. package/dist/src/core/fakeContentGenerator.test.js +8 -7
  116. package/dist/src/core/fakeContentGenerator.test.js.map +1 -1
  117. package/dist/src/core/geminiChat.d.ts +2 -1
  118. package/dist/src/core/geminiChat.js +6 -6
  119. package/dist/src/core/geminiChat.js.map +1 -1
  120. package/dist/src/core/geminiChat.test.js +54 -49
  121. package/dist/src/core/geminiChat.test.js.map +1 -1
  122. package/dist/src/core/geminiChat_network_retry.test.js +8 -7
  123. package/dist/src/core/geminiChat_network_retry.test.js.map +1 -1
  124. package/dist/src/core/loggingContentGenerator.d.ts +3 -2
  125. package/dist/src/core/loggingContentGenerator.js +19 -19
  126. package/dist/src/core/loggingContentGenerator.js.map +1 -1
  127. package/dist/src/core/loggingContentGenerator.test.js +9 -9
  128. package/dist/src/core/loggingContentGenerator.test.js.map +1 -1
  129. package/dist/src/core/prompts.test.js +9 -1
  130. package/dist/src/core/prompts.test.js.map +1 -1
  131. package/dist/src/core/recordingContentGenerator.d.ts +3 -2
  132. package/dist/src/core/recordingContentGenerator.js +4 -4
  133. package/dist/src/core/recordingContentGenerator.js.map +1 -1
  134. package/dist/src/core/recordingContentGenerator.test.js +5 -4
  135. package/dist/src/core/recordingContentGenerator.test.js.map +1 -1
  136. package/dist/src/core/turn.d.ts +2 -1
  137. package/dist/src/core/turn.js +3 -2
  138. package/dist/src/core/turn.js.map +1 -1
  139. package/dist/src/core/turn.test.js +2 -1
  140. package/dist/src/core/turn.test.js.map +1 -1
  141. package/dist/src/generated/git-commit.d.ts +2 -2
  142. package/dist/src/generated/git-commit.js +2 -2
  143. package/dist/src/generated/git-commit.js.map +1 -1
  144. package/dist/src/hooks/hookRunner.js +12 -18
  145. package/dist/src/hooks/hookRunner.js.map +1 -1
  146. package/dist/src/index.d.ts +6 -0
  147. package/dist/src/index.js +5 -0
  148. package/dist/src/index.js.map +1 -1
  149. package/dist/src/mcp/token-storage/hybrid-token-storage.js +4 -0
  150. package/dist/src/mcp/token-storage/hybrid-token-storage.js.map +1 -1
  151. package/dist/src/mcp/token-storage/hybrid-token-storage.test.js +12 -0
  152. package/dist/src/mcp/token-storage/hybrid-token-storage.test.js.map +1 -1
  153. package/dist/src/mcp/token-storage/keychain-token-storage.js +5 -0
  154. package/dist/src/mcp/token-storage/keychain-token-storage.js.map +1 -1
  155. package/dist/src/mcp/token-storage/keychain-token-storage.test.js +10 -5
  156. package/dist/src/mcp/token-storage/keychain-token-storage.test.js.map +1 -1
  157. package/dist/src/output/json-formatter.test.js +2 -0
  158. package/dist/src/output/json-formatter.test.js.map +1 -1
  159. package/dist/src/output/stream-json-formatter.test.js +4 -0
  160. package/dist/src/output/stream-json-formatter.test.js.map +1 -1
  161. package/dist/src/policy/config.d.ts +5 -3
  162. package/dist/src/policy/config.js +27 -12
  163. package/dist/src/policy/config.js.map +1 -1
  164. package/dist/src/policy/config.test.js +110 -6
  165. package/dist/src/policy/config.test.js.map +1 -1
  166. package/dist/src/policy/policies/plan.toml +1 -1
  167. package/dist/src/policy/policy-engine.js +3 -1
  168. package/dist/src/policy/policy-engine.js.map +1 -1
  169. package/dist/src/policy/policy-engine.test.js +105 -8
  170. package/dist/src/policy/policy-engine.test.js.map +1 -1
  171. package/dist/src/policy/toml-loader.d.ts +5 -5
  172. package/dist/src/policy/toml-loader.js +28 -18
  173. package/dist/src/policy/toml-loader.js.map +1 -1
  174. package/dist/src/policy/toml-loader.test.js +31 -8
  175. package/dist/src/policy/toml-loader.test.js.map +1 -1
  176. package/dist/src/policy/types.d.ts +1 -0
  177. package/dist/src/policy/types.js.map +1 -1
  178. package/dist/src/prompts/promptProvider.js +9 -11
  179. package/dist/src/prompts/promptProvider.js.map +1 -1
  180. package/dist/src/prompts/snippets.d.ts +0 -2
  181. package/dist/src/prompts/snippets.js +67 -96
  182. package/dist/src/prompts/snippets.js.map +1 -1
  183. package/dist/src/routing/strategies/classifierStrategy.js +2 -0
  184. package/dist/src/routing/strategies/classifierStrategy.js.map +1 -1
  185. package/dist/src/routing/strategies/numericalClassifierStrategy.js +2 -0
  186. package/dist/src/routing/strategies/numericalClassifierStrategy.js.map +1 -1
  187. package/dist/src/scheduler/confirmation.d.ts +1 -1
  188. package/dist/src/scheduler/confirmation.js +2 -1
  189. package/dist/src/scheduler/confirmation.js.map +1 -1
  190. package/dist/src/scheduler/confirmation.test.js +22 -37
  191. package/dist/src/scheduler/confirmation.test.js.map +1 -1
  192. package/dist/src/scheduler/scheduler.js +37 -26
  193. package/dist/src/scheduler/scheduler.js.map +1 -1
  194. package/dist/src/scheduler/scheduler.test.js +61 -45
  195. package/dist/src/scheduler/scheduler.test.js.map +1 -1
  196. package/dist/src/scheduler/state-manager.d.ts +7 -6
  197. package/dist/src/scheduler/state-manager.js +34 -24
  198. package/dist/src/scheduler/state-manager.js.map +1 -1
  199. package/dist/src/scheduler/state-manager.test.js +45 -41
  200. package/dist/src/scheduler/state-manager.test.js.map +1 -1
  201. package/dist/src/scheduler/tool-executor.js +5 -4
  202. package/dist/src/scheduler/tool-executor.js.map +1 -1
  203. package/dist/src/scheduler/tool-executor.test.js +14 -13
  204. package/dist/src/scheduler/tool-executor.test.js.map +1 -1
  205. package/dist/src/scheduler/tool-modifier.test.js +2 -1
  206. package/dist/src/scheduler/tool-modifier.test.js.map +1 -1
  207. package/dist/src/scheduler/types.d.ts +27 -7
  208. package/dist/src/scheduler/types.js +14 -0
  209. package/dist/src/scheduler/types.js.map +1 -1
  210. package/dist/src/services/chatCompressionService.js +3 -0
  211. package/dist/src/services/chatCompressionService.js.map +1 -1
  212. package/dist/src/services/chatRecordingService.test.js +6 -5
  213. package/dist/src/services/chatRecordingService.test.js.map +1 -1
  214. package/dist/src/services/loopDetectionService.js +18 -1
  215. package/dist/src/services/loopDetectionService.js.map +1 -1
  216. package/dist/src/services/loopDetectionService.test.js +14 -0
  217. package/dist/src/services/loopDetectionService.test.js.map +1 -1
  218. package/dist/src/services/modelConfigService.d.ts +1 -0
  219. package/dist/src/services/modelConfigService.js +13 -2
  220. package/dist/src/services/modelConfigService.js.map +1 -1
  221. package/dist/src/services/modelConfigService.test.js +59 -0
  222. package/dist/src/services/modelConfigService.test.js.map +1 -1
  223. package/dist/src/services/sessionSummaryService.js +2 -0
  224. package/dist/src/services/sessionSummaryService.js.map +1 -1
  225. package/dist/src/services/test-data/resolved-aliases-retry.golden.json +11 -0
  226. package/dist/src/services/test-data/resolved-aliases.golden.json +11 -0
  227. package/dist/src/skills/skillManager.d.ts +4 -0
  228. package/dist/src/skills/skillManager.js +6 -0
  229. package/dist/src/skills/skillManager.js.map +1 -1
  230. package/dist/src/telemetry/clearcut-logger/clearcut-logger.d.ts +6 -2
  231. package/dist/src/telemetry/clearcut-logger/clearcut-logger.js +52 -0
  232. package/dist/src/telemetry/clearcut-logger/clearcut-logger.js.map +1 -1
  233. package/dist/src/telemetry/clearcut-logger/clearcut-logger.test.js +74 -0
  234. package/dist/src/telemetry/clearcut-logger/clearcut-logger.test.js.map +1 -1
  235. package/dist/src/telemetry/clearcut-logger/event-metadata-key.d.ts +8 -1
  236. package/dist/src/telemetry/clearcut-logger/event-metadata-key.js +20 -1
  237. package/dist/src/telemetry/clearcut-logger/event-metadata-key.js.map +1 -1
  238. package/dist/src/telemetry/file-exporters.js +2 -1
  239. package/dist/src/telemetry/file-exporters.js.map +1 -1
  240. package/dist/src/telemetry/file-exporters.test.d.ts +6 -0
  241. package/dist/src/telemetry/file-exporters.test.js +142 -0
  242. package/dist/src/telemetry/file-exporters.test.js.map +1 -0
  243. package/dist/src/telemetry/index.d.ts +1 -0
  244. package/dist/src/telemetry/index.js +1 -0
  245. package/dist/src/telemetry/index.js.map +1 -1
  246. package/dist/src/telemetry/llmRole.d.ts +18 -0
  247. package/dist/src/telemetry/llmRole.js +20 -0
  248. package/dist/src/telemetry/llmRole.js.map +1 -0
  249. package/dist/src/telemetry/loggers.d.ts +3 -1
  250. package/dist/src/telemetry/loggers.js +25 -1
  251. package/dist/src/telemetry/loggers.js.map +1 -1
  252. package/dist/src/telemetry/loggers.test.circular.js +3 -2
  253. package/dist/src/telemetry/loggers.test.circular.js.map +1 -1
  254. package/dist/src/telemetry/loggers.test.js +93 -14
  255. package/dist/src/telemetry/loggers.test.js.map +1 -1
  256. package/dist/src/telemetry/metrics.d.ts +26 -1
  257. package/dist/src/telemetry/metrics.js +41 -0
  258. package/dist/src/telemetry/metrics.js.map +1 -1
  259. package/dist/src/telemetry/metrics.test.js +52 -1
  260. package/dist/src/telemetry/metrics.test.js.map +1 -1
  261. package/dist/src/telemetry/sdk.js +24 -0
  262. package/dist/src/telemetry/sdk.js.map +1 -1
  263. package/dist/src/telemetry/types.d.ts +36 -11
  264. package/dist/src/telemetry/types.js +77 -7
  265. package/dist/src/telemetry/types.js.map +1 -1
  266. package/dist/src/telemetry/uiTelemetry.d.ts +16 -0
  267. package/dist/src/telemetry/uiTelemetry.js +39 -0
  268. package/dist/src/telemetry/uiTelemetry.js.map +1 -1
  269. package/dist/src/telemetry/uiTelemetry.test.js +29 -0
  270. package/dist/src/telemetry/uiTelemetry.test.js.map +1 -1
  271. package/dist/src/tools/activate-skill.d.ts +1 -0
  272. package/dist/src/tools/activate-skill.js +9 -20
  273. package/dist/src/tools/activate-skill.js.map +1 -1
  274. package/dist/src/tools/ask-user.d.ts +6 -0
  275. package/dist/src/tools/ask-user.js +43 -60
  276. package/dist/src/tools/ask-user.js.map +1 -1
  277. package/dist/src/tools/ask-user.test.js +108 -11
  278. package/dist/src/tools/ask-user.test.js.map +1 -1
  279. package/dist/src/tools/definitions/base-declarations.d.ts +26 -0
  280. package/dist/src/tools/definitions/base-declarations.js +30 -0
  281. package/dist/src/tools/definitions/base-declarations.js.map +1 -0
  282. package/dist/src/tools/definitions/coreTools.d.ts +25 -18
  283. package/dist/src/tools/definitions/coreTools.js +113 -235
  284. package/dist/src/tools/definitions/coreTools.js.map +1 -1
  285. package/dist/src/tools/definitions/coreToolsModelSnapshots.test.js +27 -1
  286. package/dist/src/tools/definitions/coreToolsModelSnapshots.test.js.map +1 -1
  287. package/dist/src/tools/definitions/dynamic-declaration-helpers.d.ts +30 -0
  288. package/dist/src/tools/definitions/dynamic-declaration-helpers.js +135 -0
  289. package/dist/src/tools/definitions/dynamic-declaration-helpers.js.map +1 -0
  290. package/dist/src/tools/definitions/model-family-sets/default-legacy.d.ts +11 -0
  291. package/dist/src/tools/definitions/model-family-sets/default-legacy.js +575 -0
  292. package/dist/src/tools/definitions/model-family-sets/default-legacy.js.map +1 -0
  293. package/dist/src/tools/definitions/model-family-sets/gemini-3.d.ts +14 -0
  294. package/dist/src/tools/definitions/model-family-sets/gemini-3.js +578 -0
  295. package/dist/src/tools/definitions/model-family-sets/gemini-3.js.map +1 -0
  296. package/dist/src/tools/definitions/modelFamilyService.d.ts +14 -0
  297. package/dist/src/tools/definitions/modelFamilyService.js +29 -0
  298. package/dist/src/tools/definitions/modelFamilyService.js.map +1 -0
  299. package/dist/src/tools/definitions/types.d.ts +27 -0
  300. package/dist/src/tools/edit.d.ts +1 -0
  301. package/dist/src/tools/edit.js +9 -54
  302. package/dist/src/tools/edit.js.map +1 -1
  303. package/dist/src/tools/enter-plan-mode.d.ts +1 -0
  304. package/dist/src/tools/enter-plan-mode.js +6 -9
  305. package/dist/src/tools/enter-plan-mode.js.map +1 -1
  306. package/dist/src/tools/exit-plan-mode.d.ts +1 -0
  307. package/dist/src/tools/exit-plan-mode.js +8 -10
  308. package/dist/src/tools/exit-plan-mode.js.map +1 -1
  309. package/dist/src/tools/get-internal-docs.d.ts +1 -0
  310. package/dist/src/tools/get-internal-docs.js +6 -9
  311. package/dist/src/tools/get-internal-docs.js.map +1 -1
  312. package/dist/src/tools/glob.js +2 -2
  313. package/dist/src/tools/glob.js.map +1 -1
  314. package/dist/src/tools/memoryTool.d.ts +1 -0
  315. package/dist/src/tools/memoryTool.js +6 -20
  316. package/dist/src/tools/memoryTool.js.map +1 -1
  317. package/dist/src/tools/read-file.js +2 -2
  318. package/dist/src/tools/read-file.js.map +1 -1
  319. package/dist/src/tools/read-many-files.d.ts +1 -0
  320. package/dist/src/tools/read-many-files.js +6 -58
  321. package/dist/src/tools/read-many-files.js.map +1 -1
  322. package/dist/src/tools/ripGrep.d.ts +1 -0
  323. package/dist/src/tools/ripGrep.js +6 -62
  324. package/dist/src/tools/ripGrep.js.map +1 -1
  325. package/dist/src/tools/tool-names.d.ts +7 -14
  326. package/dist/src/tools/tool-names.js +10 -16
  327. package/dist/src/tools/tool-names.js.map +1 -1
  328. package/dist/src/tools/web-fetch.d.ts +1 -0
  329. package/dist/src/tools/web-fetch.js +10 -12
  330. package/dist/src/tools/web-fetch.js.map +1 -1
  331. package/dist/src/tools/web-search.d.ts +1 -0
  332. package/dist/src/tools/web-search.js +8 -11
  333. package/dist/src/tools/web-search.js.map +1 -1
  334. package/dist/src/tools/write-file.js +2 -2
  335. package/dist/src/tools/write-file.js.map +1 -1
  336. package/dist/src/tools/write-todos.d.ts +1 -30
  337. package/dist/src/tools/write-todos.js +5 -123
  338. package/dist/src/tools/write-todos.js.map +1 -1
  339. package/dist/src/utils/editCorrector.js +5 -0
  340. package/dist/src/utils/editCorrector.js.map +1 -1
  341. package/dist/src/utils/environmentContext.js +3 -1
  342. package/dist/src/utils/environmentContext.js.map +1 -1
  343. package/dist/src/utils/environmentContext.test.js +13 -0
  344. package/dist/src/utils/environmentContext.test.js.map +1 -1
  345. package/dist/src/utils/events.d.ts +20 -1
  346. package/dist/src/utils/events.js +13 -0
  347. package/dist/src/utils/events.js.map +1 -1
  348. package/dist/src/utils/fastAckHelper.d.ts +30 -0
  349. package/dist/src/utils/fastAckHelper.js +142 -0
  350. package/dist/src/utils/fastAckHelper.js.map +1 -0
  351. package/dist/src/utils/fastAckHelper.test.d.ts +6 -0
  352. package/dist/src/utils/fastAckHelper.test.js +115 -0
  353. package/dist/src/utils/fastAckHelper.test.js.map +1 -0
  354. package/dist/src/utils/getPty.js +3 -0
  355. package/dist/src/utils/getPty.js.map +1 -1
  356. package/dist/src/utils/headless.js +2 -2
  357. package/dist/src/utils/headless.js.map +1 -1
  358. package/dist/src/utils/headless.test.js +3 -3
  359. package/dist/src/utils/headless.test.js.map +1 -1
  360. package/dist/src/utils/llm-edit-fixer.js +2 -0
  361. package/dist/src/utils/llm-edit-fixer.js.map +1 -1
  362. package/dist/src/utils/nextSpeakerChecker.js +2 -0
  363. package/dist/src/utils/nextSpeakerChecker.js.map +1 -1
  364. package/dist/src/utils/paths.d.ts +10 -11
  365. package/dist/src/utils/paths.js +33 -34
  366. package/dist/src/utils/paths.js.map +1 -1
  367. package/dist/src/utils/paths.test.js +161 -118
  368. package/dist/src/utils/paths.test.js.map +1 -1
  369. package/dist/src/utils/summarizer.js +2 -1
  370. package/dist/src/utils/summarizer.js.map +1 -1
  371. package/dist/src/utils/tool-utils.d.ts +26 -0
  372. package/dist/src/utils/tool-utils.js +35 -0
  373. package/dist/src/utils/tool-utils.js.map +1 -1
  374. package/dist/src/utils/tool-utils.test.js +68 -2
  375. package/dist/src/utils/tool-utils.test.js.map +1 -1
  376. package/dist/tsconfig.tsbuildinfo +1 -1
  377. package/package.json +1 -1
  378. package/dist/docs/cli/authentication.md +0 -3
  379. package/dist/docs/cli/tutorials.md +0 -87
  380. package/dist/google-gemini-cli-core-0.30.0-nightly.20260210.a2174751d.tgz +0 -0
package/README.md CHANGED
@@ -29,10 +29,9 @@ Learn all about Gemini CLI in our [documentation](https://geminicli.com/docs/).
29
29
 
30
30
  ## 📦 Installation
31
31
 
32
- ### Pre-requisites before installation
33
-
34
- - Node.js version 20 or higher
35
- - macOS, Linux, or Windows
32
+ See
33
+ [Gemini CLI installation, execution, and releases](./docs/get-started/installation.md)
34
+ for recommended system specifications and a detailed installation guide.
36
35
 
37
36
  ### Quick Install
38
37
 
@@ -408,12 +408,13 @@ On macOS, `gemini` uses Seatbelt (`sandbox-exec`) under a `permissive-open`
408
408
  profile (see `packages/cli/src/utils/sandbox-macos-permissive-open.sb`) that
409
409
  restricts writes to the project folder but otherwise allows all other operations
410
410
  and outbound network traffic ("open") by default. You can switch to a
411
- `restrictive-closed` profile (see
412
- `packages/cli/src/utils/sandbox-macos-restrictive-closed.sb`) that declines all
413
- operations and outbound network traffic ("closed") by default by setting
414
- `SEATBELT_PROFILE=restrictive-closed` in your environment or `.env` file.
415
- Available built-in profiles are `{permissive,restrictive}-{open,closed,proxied}`
416
- (see below for proxied networking). You can also switch to a custom profile
411
+ `strict-open` profile (see
412
+ `packages/cli/src/utils/sandbox-macos-strict-open.sb`) that restricts both reads
413
+ and writes to the working directory while allowing outbound network traffic by
414
+ setting `SEATBELT_PROFILE=strict-open` in your environment or `.env` file.
415
+ Available built-in profiles are `permissive-{open,proxied}`,
416
+ `restrictive-{open,proxied}`, and `strict-{open,proxied}` (see below for proxied
417
+ networking). You can also switch to a custom profile
417
418
  `SEATBELT_PROFILE=<profile>` if you also create a file
418
419
  `.gemini/sandbox-macos-<profile>.sb` under your project settings directory
419
420
  `.gemini`.
@@ -0,0 +1,115 @@
1
+ # Enterprise Admin Controls
2
+
3
+ Gemini CLI empowers enterprise administrators to manage and enforce security
4
+ policies and configuration settings across their entire organization. Secure
5
+ defaults are enabled automatically for all enterprise users, but can be
6
+ customized via the [Management Console](https://goo.gle/manage-gemini-cli).
7
+
8
+ **Enterprise Admin Controls are enforced globally and cannot be overridden by
9
+ users locally**, ensuring a consistent security posture.
10
+
11
+ ## Admin Controls vs. System Settings
12
+
13
+ While [System-wide settings](../cli/settings.md) act as convenient configuration
14
+ overrides, they can still be modified by users with sufficient privileges. In
15
+ contrast, admin controls are immutable at the local level, making them the
16
+ preferred method for enforcing policy.
17
+
18
+ ## Available Controls
19
+
20
+ ### Strict Mode
21
+
22
+ **Enabled/Disabled** | Default: enabled
23
+
24
+ If enabled, users will not be able to enter yolo mode.
25
+
26
+ ### Extensions
27
+
28
+ **Enabled/Disabled** | Default: disabled
29
+
30
+ If disabled, users will not be able to use or install extensions. See
31
+ [Extensions](../extensions/index.md) for more details.
32
+
33
+ ### MCP
34
+
35
+ #### Enabled/Disabled
36
+
37
+ **Enabled/Disabled** | Default: disabled
38
+
39
+ If disabled, users will not be able to use MCP servers. See
40
+ [MCP Server Integration](../tools/mcp-server.md) for more details.
41
+
42
+ #### MCP Servers (preview)
43
+
44
+ **Default**: empty
45
+
46
+ Allows administrators to define an explicit allowlist of MCP servers. This
47
+ guarantees that users can only connect to trusted MCP servers defined by the
48
+ organization.
49
+
50
+ **Allowlist Format:**
51
+
52
+ ```json
53
+ {
54
+ "mcpServers": {
55
+ "external-provider": {
56
+ "url": "https://api.mcp-provider.com",
57
+ "type": "sse",
58
+ "trust": true,
59
+ "includeTools": ["toolA", "toolB"],
60
+ "excludeTools": []
61
+ },
62
+ "internal-corp-tool": {
63
+ "url": "https://mcp.internal-tool.corp",
64
+ "type": "http",
65
+ "includeTools": [],
66
+ "excludeTools": ["adminTool"]
67
+ }
68
+ }
69
+ }
70
+ ```
71
+
72
+ **Supported Fields:**
73
+
74
+ - `url`: (Required) The full URL of the MCP server endpoint.
75
+ - `type`: (Required) The connection type (e.g., `sse` or `http`).
76
+ - `trust`: (Optional) If set to `true`, the server is trusted and tool execution
77
+ will not require user approval.
78
+ - `includeTools`: (Optional) An explicit list of tool names to allow. If
79
+ specified, only these tools will be available.
80
+ - `excludeTools`: (Optional) A list of tool names to hide. These tools will be
81
+ blocked.
82
+
83
+ **Client Enforcement Logic:**
84
+
85
+ - **Empty Allowlist**: If the admin allowlist is empty, the client uses the
86
+ user’s local configuration as is (unless the MCP toggle above is disabled).
87
+ - **Active Allowlist**: If the allowlist contains one or more servers, **all
88
+ locally configured servers not present in the allowlist are ignored**.
89
+ - **Configuration Merging**: For a server to be active, it must exist in
90
+ **both** the admin allowlist and the user’s local configuration (matched by
91
+ name). The client merges these definitions as follows:
92
+ - **Override Fields**: The `url`, `type`, & `trust` are always taken from the
93
+ admin allowlist, overriding any local values.
94
+ - **Tools Filtering**: If `includeTools` or `excludeTools` are defined in the
95
+ allowlist, the admin’s rules are used exclusively. If both are undefined in
96
+ the admin allowlist, the client falls back to the user’s local tool
97
+ settings.
98
+ - **Cleared Fields**: To ensure security and consistency, the client
99
+ automatically clears local execution fields (`command`, `args`, `env`,
100
+ `cwd`, `httpUrl`, `tcp`). This prevents users from overriding the connection
101
+ method.
102
+ - **Other Fields**: All other MCP fields are pulled from the user’s local
103
+ configuration.
104
+ - **Missing Allowlisted Servers**: If a server appears in the admin allowlist
105
+ but is missing from the local configuration, it will not be initialized. This
106
+ ensures users maintain final control over which permitted servers are actually
107
+ active in their environment.
108
+
109
+ ### Unmanaged Capabilities
110
+
111
+ **Enabled/Disabled** | Default: disabled
112
+
113
+ If disabled, users will not be able to use certain features. Currently, this
114
+ control disables Agent Skills. See [Agent Skills](../cli/skills.md) for more
115
+ details.
@@ -2,9 +2,8 @@
2
2
 
3
3
  The Gemini CLI includes a Checkpointing feature that automatically saves a
4
4
  snapshot of your project's state before any file modifications are made by
5
- AI-powered tools. This allows you to safely experiment with and apply code
6
- changes, knowing you can instantly revert back to the state before the tool was
7
- run.
5
+ AI-powered tools. This lets you safely experiment with and apply code changes,
6
+ knowing you can instantly revert back to the state before the tool was run.
8
7
 
9
8
  ## How it works
10
9
 
@@ -1,4 +1,4 @@
1
- # CLI cheatsheet
1
+ # Gemini CLI cheatsheet
2
2
 
3
3
  This page provides a reference for commonly used Gemini CLI commands, options,
4
4
  and parameters.
@@ -9,8 +9,7 @@ and parameters.
9
9
  | ---------------------------------- | ---------------------------------- | --------------------------------------------------- |
10
10
  | `gemini` | Start interactive REPL | `gemini` |
11
11
  | `gemini "query"` | Query non-interactively, then exit | `gemini "explain this project"` |
12
- | `gemini -p "query"` | Query via SDK, then exit | `gemini -p "explain this function"` |
13
- | `cat file \| gemini -p "query"` | Process piped content | `cat logs.txt \| gemini -p "explain"` |
12
+ | `cat file \| gemini` | Process piped content | `cat logs.txt \| gemini` |
14
13
  | `gemini -i "query"` | Execute and continue interactively | `gemini -i "What is the purpose of this project?"` |
15
14
  | `gemini -r "latest"` | Continue most recent session | `gemini -r "latest"` |
16
15
  | `gemini -r "latest" "query"` | Continue session with a new prompt | `gemini -r "latest" "Check for type errors"` |
@@ -53,8 +52,8 @@ and parameters.
53
52
 
54
53
  ## Model selection
55
54
 
56
- The `--model` (or `-m`) flag allows you to specify which Gemini model to use.
57
- You can use either model aliases (user-friendly names) or concrete model names.
55
+ The `--model` (or `-m`) flag lets you specify which Gemini model to use. You can
56
+ use either model aliases (user-friendly names) or concrete model names.
58
57
 
59
58
  ### Model aliases
60
59