@office-ai/aioncli-core 0.18.6 → 0.24.0-preview.1

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 (893) hide show
  1. package/dist/docs/CONTRIBUTING.md +546 -0
  2. package/dist/docs/architecture.md +80 -0
  3. package/dist/docs/assets/connected_devtools.png +0 -0
  4. package/dist/docs/assets/gemini-screenshot.png +0 -0
  5. package/dist/docs/assets/release_patch.png +0 -0
  6. package/dist/docs/assets/theme-ansi-light.png +0 -0
  7. package/dist/docs/assets/theme-ansi.png +0 -0
  8. package/dist/docs/assets/theme-atom-one.png +0 -0
  9. package/dist/docs/assets/theme-ayu-light.png +0 -0
  10. package/dist/docs/assets/theme-ayu.png +0 -0
  11. package/dist/docs/assets/theme-custom.png +0 -0
  12. package/dist/docs/assets/theme-default-light.png +0 -0
  13. package/dist/docs/assets/theme-default.png +0 -0
  14. package/dist/docs/assets/theme-dracula.png +0 -0
  15. package/dist/docs/assets/theme-github-light.png +0 -0
  16. package/dist/docs/assets/theme-github.png +0 -0
  17. package/dist/docs/assets/theme-google-light.png +0 -0
  18. package/dist/docs/assets/theme-xcode-light.png +0 -0
  19. package/dist/docs/changelogs/index.md +592 -0
  20. package/dist/docs/changelogs/latest.md +225 -0
  21. package/dist/docs/changelogs/preview.md +129 -0
  22. package/dist/docs/changelogs/releases.md +896 -0
  23. package/dist/docs/cli/authentication.md +3 -0
  24. package/dist/docs/cli/checkpointing.md +94 -0
  25. package/dist/docs/cli/commands.md +354 -0
  26. package/dist/docs/cli/configuration.md +780 -0
  27. package/dist/docs/cli/custom-commands.md +315 -0
  28. package/dist/docs/cli/enterprise.md +565 -0
  29. package/dist/docs/cli/gemini-ignore.md +71 -0
  30. package/dist/docs/cli/gemini-md.md +108 -0
  31. package/dist/docs/cli/generation-settings.md +210 -0
  32. package/dist/docs/cli/headless.md +388 -0
  33. package/dist/docs/cli/index.md +63 -0
  34. package/dist/docs/cli/keyboard-shortcuts.md +143 -0
  35. package/dist/docs/cli/model-routing.md +37 -0
  36. package/dist/docs/cli/model.md +62 -0
  37. package/dist/docs/cli/sandbox.md +171 -0
  38. package/dist/docs/cli/session-management.md +158 -0
  39. package/dist/docs/cli/settings.md +114 -0
  40. package/dist/docs/cli/skills.md +156 -0
  41. package/dist/docs/cli/system-prompt.md +93 -0
  42. package/dist/docs/cli/telemetry.md +791 -0
  43. package/dist/docs/cli/themes.md +237 -0
  44. package/dist/docs/cli/token-caching.md +20 -0
  45. package/dist/docs/cli/trusted-folders.md +95 -0
  46. package/dist/docs/cli/tutorials/skills-getting-started.md +124 -0
  47. package/dist/docs/cli/tutorials.md +87 -0
  48. package/dist/docs/cli/uninstall.md +47 -0
  49. package/dist/docs/core/index.md +101 -0
  50. package/dist/docs/core/memport.md +244 -0
  51. package/dist/docs/core/policy-engine.md +267 -0
  52. package/dist/docs/core/tools-api.md +131 -0
  53. package/dist/docs/examples/proxy-script.md +83 -0
  54. package/dist/docs/extension.md +160 -0
  55. package/dist/docs/extensions/extension-releasing.md +183 -0
  56. package/dist/docs/extensions/getting-started-extensions.md +245 -0
  57. package/dist/docs/extensions/index.md +293 -0
  58. package/dist/docs/faq.md +154 -0
  59. package/dist/docs/get-started/authentication.md +321 -0
  60. package/dist/docs/get-started/configuration-v1.md +888 -0
  61. package/dist/docs/get-started/configuration.md +1536 -0
  62. package/dist/docs/get-started/deployment.md +143 -0
  63. package/dist/docs/get-started/examples.md +219 -0
  64. package/dist/docs/get-started/gemini-3.md +116 -0
  65. package/dist/docs/get-started/index.md +71 -0
  66. package/dist/docs/get-started/installation.md +141 -0
  67. package/dist/docs/hooks/best-practices.md +856 -0
  68. package/dist/docs/hooks/index.md +687 -0
  69. package/dist/docs/hooks/reference.md +168 -0
  70. package/dist/docs/hooks/writing-hooks.md +1026 -0
  71. package/dist/docs/ide-integration/ide-companion-spec.md +267 -0
  72. package/dist/docs/ide-integration/index.md +202 -0
  73. package/dist/docs/index.md +147 -0
  74. package/dist/docs/integration-tests.md +211 -0
  75. package/dist/docs/issue-and-pr-automation.md +134 -0
  76. package/dist/docs/local-development.md +128 -0
  77. package/dist/docs/mermaid/context.mmd +103 -0
  78. package/dist/docs/mermaid/render-path.mmd +64 -0
  79. package/dist/docs/npm.md +62 -0
  80. package/dist/docs/quota-and-pricing.md +158 -0
  81. package/dist/docs/release-confidence.md +164 -0
  82. package/dist/docs/releases.md +540 -0
  83. package/dist/docs/sidebar.json +301 -0
  84. package/dist/docs/tools/file-system.md +217 -0
  85. package/dist/docs/tools/index.md +95 -0
  86. package/dist/docs/tools/mcp-server.md +1044 -0
  87. package/dist/docs/tools/memory.md +54 -0
  88. package/dist/docs/tools/shell.md +260 -0
  89. package/dist/docs/tools/todos.md +57 -0
  90. package/dist/docs/tools/web-fetch.md +59 -0
  91. package/dist/docs/tools/web-search.md +42 -0
  92. package/dist/docs/tos-privacy.md +96 -0
  93. package/dist/docs/troubleshooting.md +158 -0
  94. package/dist/index.d.ts +1 -1
  95. package/dist/index.js +1 -1
  96. package/dist/index.js.map +1 -1
  97. package/dist/src/agents/a2a-client-manager.d.ts +78 -0
  98. package/dist/src/agents/a2a-client-manager.js +295 -0
  99. package/dist/src/agents/a2a-client-manager.js.map +1 -0
  100. package/dist/src/agents/a2a-client-manager.test.d.ts +6 -0
  101. package/dist/src/agents/a2a-client-manager.test.js +237 -0
  102. package/dist/src/agents/a2a-client-manager.test.js.map +1 -0
  103. package/dist/src/agents/a2aUtils.d.ts +28 -0
  104. package/dist/src/agents/a2aUtils.js +111 -0
  105. package/dist/src/agents/a2aUtils.js.map +1 -0
  106. package/dist/src/agents/a2aUtils.test.d.ts +6 -0
  107. package/dist/src/agents/a2aUtils.test.js +147 -0
  108. package/dist/src/agents/a2aUtils.test.js.map +1 -0
  109. package/dist/src/agents/codebase-investigator.d.ts +2 -2
  110. package/dist/src/agents/codebase-investigator.js +5 -4
  111. package/dist/src/agents/codebase-investigator.js.map +1 -1
  112. package/dist/src/agents/delegate-to-agent-tool.d.ts +19 -0
  113. package/dist/src/agents/delegate-to-agent-tool.js +115 -0
  114. package/dist/src/agents/delegate-to-agent-tool.js.map +1 -0
  115. package/dist/src/agents/delegate-to-agent-tool.test.d.ts +6 -0
  116. package/dist/src/agents/delegate-to-agent-tool.test.js +165 -0
  117. package/dist/src/agents/delegate-to-agent-tool.test.js.map +1 -0
  118. package/dist/src/agents/introspection-agent.d.ts +23 -0
  119. package/dist/src/agents/introspection-agent.js +72 -0
  120. package/dist/src/agents/introspection-agent.js.map +1 -0
  121. package/dist/src/agents/introspection-agent.test.d.ts +6 -0
  122. package/dist/src/agents/introspection-agent.test.js +47 -0
  123. package/dist/src/agents/introspection-agent.test.js.map +1 -0
  124. package/dist/src/agents/local-executor.d.ts +108 -0
  125. package/dist/src/agents/local-executor.js +801 -0
  126. package/dist/src/agents/local-executor.js.map +1 -0
  127. package/dist/src/agents/local-executor.test.d.ts +6 -0
  128. package/dist/src/agents/local-executor.test.js +1380 -0
  129. package/dist/src/agents/local-executor.test.js.map +1 -0
  130. package/dist/src/agents/local-invocation.d.ts +45 -0
  131. package/dist/src/agents/local-invocation.js +101 -0
  132. package/dist/src/agents/local-invocation.js.map +1 -0
  133. package/dist/src/agents/local-invocation.test.d.ts +6 -0
  134. package/dist/src/agents/local-invocation.test.js +218 -0
  135. package/dist/src/agents/local-invocation.test.js.map +1 -0
  136. package/dist/src/agents/registry.d.ts +25 -1
  137. package/dist/src/agents/registry.js +149 -5
  138. package/dist/src/agents/registry.js.map +1 -1
  139. package/dist/src/agents/registry.test.js +247 -25
  140. package/dist/src/agents/registry.test.js.map +1 -1
  141. package/dist/src/agents/remote-invocation.d.ts +35 -0
  142. package/dist/src/agents/remote-invocation.js +129 -0
  143. package/dist/src/agents/remote-invocation.js.map +1 -0
  144. package/dist/src/agents/remote-invocation.test.d.ts +6 -0
  145. package/dist/src/agents/remote-invocation.test.js +201 -0
  146. package/dist/src/agents/remote-invocation.test.js.map +1 -0
  147. package/dist/src/agents/subagent-tool-wrapper.d.ts +2 -2
  148. package/dist/src/agents/subagent-tool-wrapper.js +11 -6
  149. package/dist/src/agents/subagent-tool-wrapper.js.map +1 -1
  150. package/dist/src/agents/subagent-tool-wrapper.test.js +25 -17
  151. package/dist/src/agents/subagent-tool-wrapper.test.js.map +1 -1
  152. package/dist/src/agents/toml-loader.d.ts +74 -0
  153. package/dist/src/agents/toml-loader.js +248 -0
  154. package/dist/src/agents/toml-loader.js.map +1 -0
  155. package/dist/src/agents/toml-loader.test.d.ts +6 -0
  156. package/dist/src/agents/toml-loader.test.js +309 -0
  157. package/dist/src/agents/toml-loader.test.js.map +1 -0
  158. package/dist/src/agents/types.d.ts +18 -4
  159. package/dist/src/availability/errorClassification.d.ts +7 -0
  160. package/dist/src/availability/errorClassification.js +20 -0
  161. package/dist/src/availability/errorClassification.js.map +1 -0
  162. package/dist/src/availability/modelAvailabilityService.d.ts +36 -0
  163. package/dist/src/availability/modelAvailabilityService.js +87 -0
  164. package/dist/src/availability/modelAvailabilityService.js.map +1 -0
  165. package/dist/src/availability/modelAvailabilityService.test.d.ts +6 -0
  166. package/dist/src/availability/modelAvailabilityService.test.js +140 -0
  167. package/dist/src/availability/modelAvailabilityService.test.js.map +1 -0
  168. package/dist/src/availability/modelPolicy.d.ts +49 -0
  169. package/dist/src/availability/modelPolicy.js +7 -0
  170. package/dist/src/availability/modelPolicy.js.map +1 -0
  171. package/dist/src/availability/policyCatalog.d.ts +23 -0
  172. package/dist/src/availability/policyCatalog.js +82 -0
  173. package/dist/src/availability/policyCatalog.js.map +1 -0
  174. package/dist/src/availability/policyCatalog.test.d.ts +6 -0
  175. package/dist/src/availability/policyCatalog.test.js +70 -0
  176. package/dist/src/availability/policyCatalog.test.js.map +1 -0
  177. package/dist/src/availability/policyHelpers.d.ts +52 -0
  178. package/dist/src/availability/policyHelpers.js +136 -0
  179. package/dist/src/availability/policyHelpers.js.map +1 -0
  180. package/dist/src/availability/policyHelpers.test.d.ts +6 -0
  181. package/dist/src/availability/policyHelpers.test.js +182 -0
  182. package/dist/src/availability/policyHelpers.test.js.map +1 -0
  183. package/dist/src/availability/testUtils.d.ts +10 -0
  184. package/dist/src/availability/testUtils.js +22 -0
  185. package/dist/src/availability/testUtils.js.map +1 -0
  186. package/dist/src/code_assist/experiments/client_metadata.js +3 -2
  187. package/dist/src/code_assist/experiments/client_metadata.js.map +1 -1
  188. package/dist/src/code_assist/experiments/client_metadata.test.js +7 -10
  189. package/dist/src/code_assist/experiments/client_metadata.test.js.map +1 -1
  190. package/dist/src/code_assist/experiments/experiments.js +2 -2
  191. package/dist/src/code_assist/experiments/experiments.js.map +1 -1
  192. package/dist/src/code_assist/oauth2.d.ts +2 -0
  193. package/dist/src/code_assist/oauth2.js +73 -17
  194. package/dist/src/code_assist/oauth2.js.map +1 -1
  195. package/dist/src/code_assist/oauth2.test.js +195 -18
  196. package/dist/src/code_assist/oauth2.test.js.map +1 -1
  197. package/dist/src/code_assist/server.d.ts +10 -1
  198. package/dist/src/code_assist/server.js +81 -15
  199. package/dist/src/code_assist/server.js.map +1 -1
  200. package/dist/src/code_assist/server.test.js +221 -25
  201. package/dist/src/code_assist/server.test.js.map +1 -1
  202. package/dist/src/code_assist/setup.js +6 -4
  203. package/dist/src/code_assist/setup.js.map +1 -1
  204. package/dist/src/code_assist/setup.test.js +63 -0
  205. package/dist/src/code_assist/setup.test.js.map +1 -1
  206. package/dist/src/code_assist/telemetry.d.ts +14 -0
  207. package/dist/src/code_assist/telemetry.js +156 -0
  208. package/dist/src/code_assist/telemetry.js.map +1 -0
  209. package/dist/src/code_assist/telemetry.test.d.ts +6 -0
  210. package/dist/src/code_assist/telemetry.test.js +300 -0
  211. package/dist/src/code_assist/telemetry.test.js.map +1 -0
  212. package/dist/src/code_assist/types.d.ts +84 -1
  213. package/dist/src/code_assist/types.js +21 -0
  214. package/dist/src/code_assist/types.js.map +1 -1
  215. package/dist/src/commands/init.d.ts +7 -0
  216. package/dist/src/commands/init.js +53 -0
  217. package/dist/src/commands/init.js.map +1 -0
  218. package/dist/src/commands/init.test.d.ts +6 -0
  219. package/dist/src/commands/init.test.js +25 -0
  220. package/dist/src/commands/init.test.js.map +1 -0
  221. package/dist/src/commands/restore.d.ts +9 -0
  222. package/dist/src/commands/restore.js +46 -0
  223. package/dist/src/commands/restore.js.map +1 -0
  224. package/dist/src/commands/restore.test.d.ts +6 -0
  225. package/dist/src/commands/restore.test.js +137 -0
  226. package/dist/src/commands/restore.test.js.map +1 -0
  227. package/dist/src/commands/types.d.ts +41 -0
  228. package/dist/src/commands/types.js +7 -0
  229. package/dist/src/commands/types.js.map +1 -0
  230. package/dist/src/config/config.d.ts +120 -23
  231. package/dist/src/config/config.js +336 -116
  232. package/dist/src/config/config.js.map +1 -1
  233. package/dist/src/config/config.test.js +373 -95
  234. package/dist/src/config/config.test.js.map +1 -1
  235. package/dist/src/config/defaultModelConfigs.js +46 -0
  236. package/dist/src/config/defaultModelConfigs.js.map +1 -1
  237. package/dist/src/config/flashFallback.test.js +11 -35
  238. package/dist/src/config/flashFallback.test.js.map +1 -1
  239. package/dist/src/config/models.d.ts +29 -15
  240. package/dist/src/config/models.js +78 -28
  241. package/dist/src/config/models.js.map +1 -1
  242. package/dist/src/config/models.test.js +91 -77
  243. package/dist/src/config/models.test.js.map +1 -1
  244. package/dist/src/config/storage.d.ts +4 -0
  245. package/dist/src/config/storage.js +12 -0
  246. package/dist/src/config/storage.js.map +1 -1
  247. package/dist/src/config/storage.test.js +16 -0
  248. package/dist/src/config/storage.test.js.map +1 -1
  249. package/dist/src/confirmation-bus/message-bus.d.ts +6 -0
  250. package/dist/src/confirmation-bus/message-bus.js +66 -3
  251. package/dist/src/confirmation-bus/message-bus.js.map +1 -1
  252. package/dist/src/confirmation-bus/types.d.ts +29 -2
  253. package/dist/src/confirmation-bus/types.js +3 -0
  254. package/dist/src/confirmation-bus/types.js.map +1 -1
  255. package/dist/src/core/baseLlmClient.d.ts +30 -2
  256. package/dist/src/core/baseLlmClient.js +107 -49
  257. package/dist/src/core/baseLlmClient.js.map +1 -1
  258. package/dist/src/core/baseLlmClient.test.js +271 -13
  259. package/dist/src/core/baseLlmClient.test.js.map +1 -1
  260. package/dist/src/core/client.d.ts +5 -1
  261. package/dist/src/core/client.js +241 -63
  262. package/dist/src/core/client.js.map +1 -1
  263. package/dist/src/core/client.test.js +462 -72
  264. package/dist/src/core/client.test.js.map +1 -1
  265. package/dist/src/core/clientHookTriggers.d.ts +36 -0
  266. package/dist/src/core/clientHookTriggers.js +76 -0
  267. package/dist/src/core/clientHookTriggers.js.map +1 -0
  268. package/dist/src/core/contentGenerator.js +17 -4
  269. package/dist/src/core/contentGenerator.js.map +1 -1
  270. package/dist/src/core/contentGenerator.test.js +132 -3
  271. package/dist/src/core/contentGenerator.test.js.map +1 -1
  272. package/dist/src/core/coreToolHookTriggers.d.ts +55 -0
  273. package/dist/src/core/coreToolHookTriggers.js +304 -0
  274. package/dist/src/core/coreToolHookTriggers.js.map +1 -0
  275. package/dist/src/core/coreToolHookTriggers.test.d.ts +6 -0
  276. package/dist/src/core/coreToolHookTriggers.test.js +191 -0
  277. package/dist/src/core/coreToolHookTriggers.test.js.map +1 -0
  278. package/dist/src/core/coreToolScheduler.d.ts +6 -85
  279. package/dist/src/core/coreToolScheduler.js +69 -267
  280. package/dist/src/core/coreToolScheduler.js.map +1 -1
  281. package/dist/src/core/coreToolScheduler.test.js +161 -346
  282. package/dist/src/core/coreToolScheduler.test.js.map +1 -1
  283. package/dist/src/core/geminiChat.js +132 -76
  284. package/dist/src/core/geminiChat.js.map +1 -1
  285. package/dist/src/core/geminiChat.test.js +240 -257
  286. package/dist/src/core/geminiChat.test.js.map +1 -1
  287. package/dist/src/core/geminiChatHookTriggers.d.ts +64 -0
  288. package/dist/src/core/geminiChatHookTriggers.js +136 -0
  289. package/dist/src/core/geminiChatHookTriggers.js.map +1 -0
  290. package/dist/src/core/geminiChat_network_retry.test.d.ts +6 -0
  291. package/dist/src/core/geminiChat_network_retry.test.js +196 -0
  292. package/dist/src/core/geminiChat_network_retry.test.js.map +1 -0
  293. package/dist/src/core/logger.js.map +1 -1
  294. package/dist/src/core/loggingContentGenerator.js +23 -6
  295. package/dist/src/core/loggingContentGenerator.js.map +1 -1
  296. package/dist/src/core/nonInteractiveToolExecutor.test.js +13 -8
  297. package/dist/src/core/nonInteractiveToolExecutor.test.js.map +1 -1
  298. package/dist/src/core/openaiContentGenerator.d.ts +25 -0
  299. package/dist/src/core/openaiContentGenerator.js +243 -14
  300. package/dist/src/core/openaiContentGenerator.js.map +1 -1
  301. package/dist/src/core/prompts.js +82 -26
  302. package/dist/src/core/prompts.js.map +1 -1
  303. package/dist/src/core/prompts.test.js +102 -3
  304. package/dist/src/core/prompts.test.js.map +1 -1
  305. package/dist/src/core/sessionHookTriggers.d.ts +29 -0
  306. package/dist/src/core/sessionHookTriggers.js +75 -0
  307. package/dist/src/core/sessionHookTriggers.js.map +1 -0
  308. package/dist/src/core/turn.d.ts +34 -21
  309. package/dist/src/core/turn.js +33 -13
  310. package/dist/src/core/turn.js.map +1 -1
  311. package/dist/src/core/turn.test.js +0 -5
  312. package/dist/src/core/turn.test.js.map +1 -1
  313. package/dist/src/fallback/handler.js +101 -93
  314. package/dist/src/fallback/handler.js.map +1 -1
  315. package/dist/src/fallback/handler.test.js +186 -173
  316. package/dist/src/fallback/handler.test.js.map +1 -1
  317. package/dist/src/fallback/types.d.ts +8 -0
  318. package/dist/src/generated/git-commit.d.ts +3 -3
  319. package/dist/src/generated/git-commit.js +3 -3
  320. package/dist/src/generated/git-commit.js.map +1 -1
  321. package/dist/src/hooks/hookAggregator.js +7 -0
  322. package/dist/src/hooks/hookAggregator.js.map +1 -1
  323. package/dist/src/hooks/hookEventHandler.d.ts +113 -0
  324. package/dist/src/hooks/hookEventHandler.js +571 -0
  325. package/dist/src/hooks/hookEventHandler.js.map +1 -0
  326. package/dist/src/hooks/hookEventHandler.test.d.ts +6 -0
  327. package/dist/src/hooks/hookEventHandler.test.js +461 -0
  328. package/dist/src/hooks/hookEventHandler.test.js.map +1 -0
  329. package/dist/src/hooks/hookPlanner.d.ts +1 -5
  330. package/dist/src/hooks/hookPlanner.js +2 -7
  331. package/dist/src/hooks/hookPlanner.js.map +1 -1
  332. package/dist/src/hooks/hookPlanner.test.js +62 -2
  333. package/dist/src/hooks/hookPlanner.test.js.map +1 -1
  334. package/dist/src/hooks/hookRegistry.d.ts +6 -18
  335. package/dist/src/hooks/hookRegistry.js +49 -35
  336. package/dist/src/hooks/hookRegistry.js.map +1 -1
  337. package/dist/src/hooks/hookRegistry.test.js +167 -8
  338. package/dist/src/hooks/hookRegistry.test.js.map +1 -1
  339. package/dist/src/hooks/hookRunner.d.ts +5 -3
  340. package/dist/src/hooks/hookRunner.js +74 -18
  341. package/dist/src/hooks/hookRunner.js.map +1 -1
  342. package/dist/src/hooks/hookRunner.test.js +174 -36
  343. package/dist/src/hooks/hookRunner.test.js.map +1 -1
  344. package/dist/src/hooks/hookSystem.d.ts +40 -0
  345. package/dist/src/hooks/hookSystem.js +65 -0
  346. package/dist/src/hooks/hookSystem.js.map +1 -0
  347. package/dist/src/hooks/hookSystem.test.d.ts +6 -0
  348. package/dist/src/hooks/hookSystem.test.js +319 -0
  349. package/dist/src/hooks/hookSystem.test.js.map +1 -0
  350. package/dist/src/hooks/index.d.ts +17 -0
  351. package/dist/src/hooks/index.js +18 -0
  352. package/dist/src/hooks/index.js.map +1 -0
  353. package/dist/src/hooks/trustedHooks.d.ts +28 -0
  354. package/dist/src/hooks/trustedHooks.js +90 -0
  355. package/dist/src/hooks/trustedHooks.js.map +1 -0
  356. package/dist/src/hooks/trustedHooks.test.d.ts +6 -0
  357. package/dist/src/hooks/trustedHooks.test.js +154 -0
  358. package/dist/src/hooks/trustedHooks.test.js.map +1 -0
  359. package/dist/src/hooks/types.d.ts +21 -11
  360. package/dist/src/hooks/types.js +31 -27
  361. package/dist/src/hooks/types.js.map +1 -1
  362. package/dist/src/hooks/types.test.js +5 -24
  363. package/dist/src/hooks/types.test.js.map +1 -1
  364. package/dist/src/ide/detect-ide.test.js +32 -1
  365. package/dist/src/ide/detect-ide.test.js.map +1 -1
  366. package/dist/src/ide/ide-client.js +9 -4
  367. package/dist/src/ide/ide-client.js.map +1 -1
  368. package/dist/src/ide/ide-client.test.js +17 -0
  369. package/dist/src/ide/ide-client.test.js.map +1 -1
  370. package/dist/src/ide/ide-installer.test.js +1 -1
  371. package/dist/src/ide/ide-installer.test.js.map +1 -1
  372. package/dist/src/ide/types.d.ts +4 -4
  373. package/dist/src/index.d.ts +17 -1
  374. package/dist/src/index.js +18 -2
  375. package/dist/src/index.js.map +1 -1
  376. package/dist/src/mcp/auth-provider.d.ts +16 -0
  377. package/dist/src/mcp/auth-provider.js +7 -0
  378. package/dist/src/mcp/auth-provider.js.map +1 -0
  379. package/dist/src/mcp/google-auth-provider.d.ts +10 -2
  380. package/dist/src/mcp/google-auth-provider.js +28 -0
  381. package/dist/src/mcp/google-auth-provider.js.map +1 -1
  382. package/dist/src/mcp/google-auth-provider.test.js +45 -0
  383. package/dist/src/mcp/google-auth-provider.test.js.map +1 -1
  384. package/dist/src/mcp/oauth-provider.js +6 -2
  385. package/dist/src/mcp/oauth-provider.js.map +1 -1
  386. package/dist/src/mcp/oauth-provider.test.js +4 -1
  387. package/dist/src/mcp/oauth-provider.test.js.map +1 -1
  388. package/dist/src/mcp/oauth-utils.d.ts +8 -1
  389. package/dist/src/mcp/oauth-utils.js +31 -2
  390. package/dist/src/mcp/oauth-utils.js.map +1 -1
  391. package/dist/src/mcp/oauth-utils.test.js +42 -0
  392. package/dist/src/mcp/oauth-utils.test.js.map +1 -1
  393. package/dist/src/mcp/sa-impersonation-provider.d.ts +2 -2
  394. package/dist/src/mcp/sa-impersonation-provider.js.map +1 -1
  395. package/dist/src/mcp/token-storage/hybrid-token-storage.js +1 -1
  396. package/dist/src/mcp/token-storage/hybrid-token-storage.js.map +1 -1
  397. package/dist/src/mcp/token-storage/keychain-token-storage.js +1 -1
  398. package/dist/src/mcp/token-storage/keychain-token-storage.js.map +1 -1
  399. package/dist/src/output/json-formatter.d.ts +2 -2
  400. package/dist/src/output/json-formatter.js +6 -3
  401. package/dist/src/output/json-formatter.js.map +1 -1
  402. package/dist/src/output/json-formatter.test.js +37 -9
  403. package/dist/src/output/json-formatter.test.js.map +1 -1
  404. package/dist/src/output/stream-json-formatter.js +6 -0
  405. package/dist/src/output/stream-json-formatter.js.map +1 -1
  406. package/dist/src/output/stream-json-formatter.test.js +98 -100
  407. package/dist/src/output/stream-json-formatter.test.js.map +1 -1
  408. package/dist/src/output/types.d.ts +3 -0
  409. package/dist/src/output/types.js.map +1 -1
  410. package/dist/src/policy/config.js +140 -15
  411. package/dist/src/policy/config.js.map +1 -1
  412. package/dist/src/policy/config.test.js +21 -0
  413. package/dist/src/policy/config.test.js.map +1 -1
  414. package/dist/src/policy/persistence.test.d.ts +6 -0
  415. package/dist/src/policy/persistence.test.js +154 -0
  416. package/dist/src/policy/persistence.test.js.map +1 -0
  417. package/dist/src/policy/policies/agent.toml +31 -0
  418. package/dist/src/policy/policies/read-only.toml +5 -0
  419. package/dist/src/policy/policies/write.toml +5 -0
  420. package/dist/src/policy/policies/yolo.toml +1 -0
  421. package/dist/src/policy/policy-engine.d.ts +30 -1
  422. package/dist/src/policy/policy-engine.js +192 -5
  423. package/dist/src/policy/policy-engine.js.map +1 -1
  424. package/dist/src/policy/policy-engine.test.js +520 -3
  425. package/dist/src/policy/policy-engine.test.js.map +1 -1
  426. package/dist/src/policy/policy-updater.test.d.ts +6 -0
  427. package/dist/src/policy/policy-updater.test.js +116 -0
  428. package/dist/src/policy/policy-updater.test.js.map +1 -0
  429. package/dist/src/policy/shell-safety.test.d.ts +6 -0
  430. package/dist/src/policy/shell-safety.test.js +75 -0
  431. package/dist/src/policy/shell-safety.test.js.map +1 -0
  432. package/dist/src/policy/toml-loader.d.ts +3 -5
  433. package/dist/src/policy/toml-loader.js +12 -60
  434. package/dist/src/policy/toml-loader.js.map +1 -1
  435. package/dist/src/policy/toml-loader.test.js +38 -7
  436. package/dist/src/policy/toml-loader.test.js.map +1 -1
  437. package/dist/src/policy/types.d.ts +72 -1
  438. package/dist/src/policy/types.js +21 -0
  439. package/dist/src/policy/types.js.map +1 -1
  440. package/dist/src/policy/utils.d.ts +21 -0
  441. package/dist/src/policy/utils.js +42 -0
  442. package/dist/src/policy/utils.js.map +1 -0
  443. package/dist/src/policy/utils.test.d.ts +6 -0
  444. package/dist/src/policy/utils.test.js +64 -0
  445. package/dist/src/policy/utils.test.js.map +1 -0
  446. package/dist/src/resources/resource-registry.d.ts +30 -0
  447. package/dist/src/resources/resource-registry.js +57 -0
  448. package/dist/src/resources/resource-registry.js.map +1 -0
  449. package/dist/src/resources/resource-registry.test.d.ts +6 -0
  450. package/dist/src/resources/resource-registry.test.js +54 -0
  451. package/dist/src/resources/resource-registry.test.js.map +1 -0
  452. package/dist/src/routing/modelRouterService.js +0 -15
  453. package/dist/src/routing/modelRouterService.js.map +1 -1
  454. package/dist/src/routing/modelRouterService.test.js +0 -62
  455. package/dist/src/routing/modelRouterService.test.js.map +1 -1
  456. package/dist/src/routing/strategies/classifierStrategy.js +10 -21
  457. package/dist/src/routing/strategies/classifierStrategy.js.map +1 -1
  458. package/dist/src/routing/strategies/classifierStrategy.test.js +2 -1
  459. package/dist/src/routing/strategies/classifierStrategy.test.js.map +1 -1
  460. package/dist/src/routing/strategies/compositeStrategy.js +4 -2
  461. package/dist/src/routing/strategies/compositeStrategy.js.map +1 -1
  462. package/dist/src/routing/strategies/compositeStrategy.test.js +11 -10
  463. package/dist/src/routing/strategies/compositeStrategy.test.js.map +1 -1
  464. package/dist/src/routing/strategies/fallbackStrategy.js +20 -12
  465. package/dist/src/routing/strategies/fallbackStrategy.js.map +1 -1
  466. package/dist/src/routing/strategies/fallbackStrategy.test.js +63 -39
  467. package/dist/src/routing/strategies/fallbackStrategy.test.js.map +1 -1
  468. package/dist/src/routing/strategies/overrideStrategy.js +3 -2
  469. package/dist/src/routing/strategies/overrideStrategy.js.map +1 -1
  470. package/dist/src/safety/checker-runner.js +17 -6
  471. package/dist/src/safety/checker-runner.js.map +1 -1
  472. package/dist/src/scheduler/tool-executor.d.ts +22 -0
  473. package/dist/src/scheduler/tool-executor.js +198 -0
  474. package/dist/src/scheduler/tool-executor.js.map +1 -0
  475. package/dist/src/scheduler/tool-executor.test.d.ts +6 -0
  476. package/dist/src/scheduler/tool-executor.test.js +231 -0
  477. package/dist/src/scheduler/tool-executor.test.js.map +1 -0
  478. package/dist/src/scheduler/types.d.ts +95 -0
  479. package/dist/src/scheduler/types.js +7 -0
  480. package/dist/src/scheduler/types.js.map +1 -0
  481. package/dist/src/services/chatCompressionService.d.ts +1 -0
  482. package/dist/src/services/chatCompressionService.js +38 -8
  483. package/dist/src/services/chatCompressionService.js.map +1 -1
  484. package/dist/src/services/chatCompressionService.test.js +35 -31
  485. package/dist/src/services/chatCompressionService.test.js.map +1 -1
  486. package/dist/src/services/chatRecordingService.d.ts +14 -0
  487. package/dist/src/services/chatRecordingService.js +37 -0
  488. package/dist/src/services/chatRecordingService.js.map +1 -1
  489. package/dist/src/services/contextManager.d.ts +29 -0
  490. package/dist/src/services/contextManager.js +71 -0
  491. package/dist/src/services/contextManager.js.map +1 -0
  492. package/dist/src/services/contextManager.test.d.ts +6 -0
  493. package/dist/src/services/contextManager.test.js +104 -0
  494. package/dist/src/services/contextManager.test.js.map +1 -0
  495. package/dist/src/services/environmentSanitization.d.ts +15 -0
  496. package/dist/src/services/environmentSanitization.js +141 -0
  497. package/dist/src/services/environmentSanitization.js.map +1 -0
  498. package/dist/src/services/environmentSanitization.test.d.ts +6 -0
  499. package/dist/src/services/environmentSanitization.test.js +284 -0
  500. package/dist/src/services/environmentSanitization.test.js.map +1 -0
  501. package/dist/src/services/fileSystemService.d.ts +0 -9
  502. package/dist/src/services/fileSystemService.js +0 -11
  503. package/dist/src/services/fileSystemService.js.map +1 -1
  504. package/dist/src/services/gitService.js +18 -2
  505. package/dist/src/services/gitService.js.map +1 -1
  506. package/dist/src/services/gitService.test.js +56 -0
  507. package/dist/src/services/gitService.test.js.map +1 -1
  508. package/dist/src/services/loopDetectionService.js +5 -4
  509. package/dist/src/services/loopDetectionService.js.map +1 -1
  510. package/dist/src/services/loopDetectionService.test.js +14 -8
  511. package/dist/src/services/loopDetectionService.test.js.map +1 -1
  512. package/dist/src/services/modelConfig.golden.test.js +32 -0
  513. package/dist/src/services/modelConfig.golden.test.js.map +1 -1
  514. package/dist/src/services/modelConfig.integration.test.js +1 -1
  515. package/dist/src/services/modelConfig.integration.test.js.map +1 -1
  516. package/dist/src/services/modelConfigService.d.ts +4 -0
  517. package/dist/src/services/modelConfigService.js +8 -3
  518. package/dist/src/services/modelConfigService.js.map +1 -1
  519. package/dist/src/services/modelConfigService.test.js +221 -0
  520. package/dist/src/services/modelConfigService.test.js.map +1 -1
  521. package/dist/src/services/modelConfigServiceTestUtils.d.ts +10 -0
  522. package/dist/src/services/modelConfigServiceTestUtils.js +17 -0
  523. package/dist/src/services/modelConfigServiceTestUtils.js.map +1 -0
  524. package/dist/src/services/sessionSummaryService.d.ts +28 -0
  525. package/dist/src/services/sessionSummaryService.js +131 -0
  526. package/dist/src/services/sessionSummaryService.js.map +1 -0
  527. package/dist/src/services/sessionSummaryService.test.d.ts +6 -0
  528. package/dist/src/services/sessionSummaryService.test.js +785 -0
  529. package/dist/src/services/sessionSummaryService.test.js.map +1 -0
  530. package/dist/src/services/sessionSummaryUtils.d.ts +16 -0
  531. package/dist/src/services/sessionSummaryUtils.js +129 -0
  532. package/dist/src/services/sessionSummaryUtils.js.map +1 -0
  533. package/dist/src/services/sessionSummaryUtils.test.d.ts +6 -0
  534. package/dist/src/services/sessionSummaryUtils.test.js +137 -0
  535. package/dist/src/services/sessionSummaryUtils.test.js.map +1 -0
  536. package/dist/src/services/shellExecutionService.d.ts +4 -0
  537. package/dist/src/services/shellExecutionService.js +45 -27
  538. package/dist/src/services/shellExecutionService.js.map +1 -1
  539. package/dist/src/services/shellExecutionService.test.js +240 -8
  540. package/dist/src/services/shellExecutionService.test.js.map +1 -1
  541. package/dist/src/services/test-data/resolved-aliases-retry.golden.json +238 -0
  542. package/dist/src/services/test-data/resolved-aliases.golden.json +36 -0
  543. package/dist/src/skills/skillLoader.d.ts +28 -0
  544. package/dist/src/skills/skillLoader.js +77 -0
  545. package/dist/src/skills/skillLoader.js.map +1 -0
  546. package/dist/src/skills/skillLoader.test.d.ts +1 -0
  547. package/dist/src/skills/skillLoader.test.js +2 -0
  548. package/dist/src/skills/skillLoader.test.js.map +1 -0
  549. package/dist/src/skills/skillManager.d.ts +51 -0
  550. package/dist/src/skills/skillManager.js +89 -0
  551. package/dist/src/skills/skillManager.js.map +1 -0
  552. package/dist/src/skills/skillManager.test.d.ts +6 -0
  553. package/dist/src/skills/skillManager.test.js +128 -0
  554. package/dist/src/skills/skillManager.test.js.map +1 -0
  555. package/dist/src/telemetry/activity-detector.test.js.map +1 -1
  556. package/dist/src/telemetry/clearcut-logger/clearcut-logger.d.ts +11 -7
  557. package/dist/src/telemetry/clearcut-logger/clearcut-logger.js +127 -47
  558. package/dist/src/telemetry/clearcut-logger/clearcut-logger.js.map +1 -1
  559. package/dist/src/telemetry/clearcut-logger/clearcut-logger.test.js +105 -18
  560. package/dist/src/telemetry/clearcut-logger/clearcut-logger.test.js.map +1 -1
  561. package/dist/src/telemetry/clearcut-logger/event-metadata-key.d.ts +9 -3
  562. package/dist/src/telemetry/clearcut-logger/event-metadata-key.js +20 -5
  563. package/dist/src/telemetry/clearcut-logger/event-metadata-key.js.map +1 -1
  564. package/dist/src/telemetry/config.js +2 -0
  565. package/dist/src/telemetry/config.js.map +1 -1
  566. package/dist/src/telemetry/config.test.js +25 -0
  567. package/dist/src/telemetry/config.test.js.map +1 -1
  568. package/dist/src/telemetry/gcp-exporters.d.ts +4 -3
  569. package/dist/src/telemetry/gcp-exporters.js +8 -4
  570. package/dist/src/telemetry/gcp-exporters.js.map +1 -1
  571. package/dist/src/telemetry/index.d.ts +2 -1
  572. package/dist/src/telemetry/index.js +2 -1
  573. package/dist/src/telemetry/index.js.map +1 -1
  574. package/dist/src/telemetry/loggers.d.ts +5 -3
  575. package/dist/src/telemetry/loggers.js +353 -334
  576. package/dist/src/telemetry/loggers.js.map +1 -1
  577. package/dist/src/telemetry/loggers.test.circular.js +1 -0
  578. package/dist/src/telemetry/loggers.test.circular.js.map +1 -1
  579. package/dist/src/telemetry/loggers.test.js +238 -31
  580. package/dist/src/telemetry/loggers.test.js.map +1 -1
  581. package/dist/src/telemetry/metrics.d.ts +22 -0
  582. package/dist/src/telemetry/metrics.js +32 -0
  583. package/dist/src/telemetry/metrics.js.map +1 -1
  584. package/dist/src/telemetry/metrics.test.js +64 -0
  585. package/dist/src/telemetry/metrics.test.js.map +1 -1
  586. package/dist/src/telemetry/sanitize.d.ts +25 -0
  587. package/dist/src/telemetry/sanitize.js +48 -0
  588. package/dist/src/telemetry/sanitize.js.map +1 -0
  589. package/dist/src/telemetry/sanitize.test.d.ts +6 -0
  590. package/dist/src/telemetry/sanitize.test.js +279 -0
  591. package/dist/src/telemetry/sanitize.test.js.map +1 -0
  592. package/dist/src/telemetry/sdk.d.ts +9 -2
  593. package/dist/src/telemetry/sdk.js +142 -17
  594. package/dist/src/telemetry/sdk.js.map +1 -1
  595. package/dist/src/telemetry/sdk.test.js +130 -28
  596. package/dist/src/telemetry/sdk.test.js.map +1 -1
  597. package/dist/src/telemetry/semantic.js +1 -1
  598. package/dist/src/telemetry/semantic.js.map +1 -1
  599. package/dist/src/telemetry/startupProfiler.d.ts +51 -0
  600. package/dist/src/telemetry/startupProfiler.js +170 -0
  601. package/dist/src/telemetry/startupProfiler.js.map +1 -0
  602. package/dist/src/telemetry/startupProfiler.test.d.ts +6 -0
  603. package/dist/src/telemetry/startupProfiler.test.js +285 -0
  604. package/dist/src/telemetry/startupProfiler.test.js.map +1 -0
  605. package/dist/src/telemetry/telemetry.test.js +10 -3
  606. package/dist/src/telemetry/telemetry.test.js.map +1 -1
  607. package/dist/src/telemetry/trace.js +2 -2
  608. package/dist/src/telemetry/trace.js.map +1 -1
  609. package/dist/src/telemetry/types.d.ts +62 -16
  610. package/dist/src/telemetry/types.js +157 -27
  611. package/dist/src/telemetry/types.js.map +1 -1
  612. package/dist/src/telemetry/uiTelemetry.d.ts +1 -0
  613. package/dist/src/telemetry/uiTelemetry.js +2 -0
  614. package/dist/src/telemetry/uiTelemetry.js.map +1 -1
  615. package/dist/src/telemetry/uiTelemetry.test.js +4 -0
  616. package/dist/src/telemetry/uiTelemetry.test.js.map +1 -1
  617. package/dist/src/test-utils/mock-message-bus.d.ts +61 -0
  618. package/dist/src/test-utils/mock-message-bus.js +160 -0
  619. package/dist/src/test-utils/mock-message-bus.js.map +1 -0
  620. package/dist/src/test-utils/mock-tool.d.ts +5 -3
  621. package/dist/src/test-utils/mock-tool.js +12 -11
  622. package/dist/src/test-utils/mock-tool.js.map +1 -1
  623. package/dist/src/tools/activate-skill.d.ts +27 -0
  624. package/dist/src/tools/activate-skill.js +120 -0
  625. package/dist/src/tools/activate-skill.js.map +1 -0
  626. package/dist/src/tools/activate-skill.test.d.ts +6 -0
  627. package/dist/src/tools/activate-skill.test.js +95 -0
  628. package/dist/src/tools/activate-skill.test.js.map +1 -0
  629. package/dist/src/tools/confirmation-policy.test.d.ts +6 -0
  630. package/dist/src/tools/confirmation-policy.test.js +142 -0
  631. package/dist/src/tools/confirmation-policy.test.js.map +1 -0
  632. package/dist/src/tools/edit.d.ts +27 -5
  633. package/dist/src/tools/edit.js +449 -137
  634. package/dist/src/tools/edit.js.map +1 -1
  635. package/dist/src/tools/edit.test.js +258 -526
  636. package/dist/src/tools/edit.test.js.map +1 -1
  637. package/dist/src/tools/get-internal-docs.d.ts +27 -0
  638. package/dist/src/tools/get-internal-docs.js +129 -0
  639. package/dist/src/tools/get-internal-docs.js.map +1 -0
  640. package/dist/src/tools/get-internal-docs.test.d.ts +6 -0
  641. package/dist/src/tools/get-internal-docs.test.js +57 -0
  642. package/dist/src/tools/get-internal-docs.test.js.map +1 -0
  643. package/dist/src/tools/glob.d.ts +2 -2
  644. package/dist/src/tools/glob.js +1 -1
  645. package/dist/src/tools/glob.js.map +1 -1
  646. package/dist/src/tools/glob.test.js +2 -1
  647. package/dist/src/tools/glob.test.js.map +1 -1
  648. package/dist/src/tools/grep.d.ts +2 -2
  649. package/dist/src/tools/grep.js +1 -1
  650. package/dist/src/tools/grep.js.map +1 -1
  651. package/dist/src/tools/grep.test.js +5 -4
  652. package/dist/src/tools/grep.test.js.map +1 -1
  653. package/dist/src/tools/ls.d.ts +2 -2
  654. package/dist/src/tools/ls.js +2 -2
  655. package/dist/src/tools/ls.js.map +1 -1
  656. package/dist/src/tools/ls.test.js +2 -1
  657. package/dist/src/tools/ls.test.js.map +1 -1
  658. package/dist/src/tools/mcp-client-manager.d.ts +3 -1
  659. package/dist/src/tools/mcp-client-manager.js +42 -9
  660. package/dist/src/tools/mcp-client-manager.js.map +1 -1
  661. package/dist/src/tools/mcp-client-manager.test.js +66 -10
  662. package/dist/src/tools/mcp-client-manager.test.js.map +1 -1
  663. package/dist/src/tools/mcp-client.d.ts +44 -6
  664. package/dist/src/tools/mcp-client.js +476 -176
  665. package/dist/src/tools/mcp-client.js.map +1 -1
  666. package/dist/src/tools/mcp-client.test.js +633 -36
  667. package/dist/src/tools/mcp-client.test.js.map +1 -1
  668. package/dist/src/tools/mcp-tool.d.ts +2 -2
  669. package/dist/src/tools/mcp-tool.js +20 -7
  670. package/dist/src/tools/mcp-tool.js.map +1 -1
  671. package/dist/src/tools/mcp-tool.test.js +35 -5
  672. package/dist/src/tools/mcp-tool.test.js.map +1 -1
  673. package/dist/src/tools/memoryTool.d.ts +3 -3
  674. package/dist/src/tools/memoryTool.js +3 -4
  675. package/dist/src/tools/memoryTool.js.map +1 -1
  676. package/dist/src/tools/memoryTool.test.js +5 -2
  677. package/dist/src/tools/memoryTool.test.js.map +1 -1
  678. package/dist/src/tools/message-bus-integration.test.js +10 -37
  679. package/dist/src/tools/message-bus-integration.test.js.map +1 -1
  680. package/dist/src/tools/modifiable-tool.js.map +1 -1
  681. package/dist/src/tools/modifiable-tool.test.js +22 -13
  682. package/dist/src/tools/modifiable-tool.test.js.map +1 -1
  683. package/dist/src/tools/read-file.d.ts +2 -2
  684. package/dist/src/tools/read-file.js +2 -2
  685. package/dist/src/tools/read-file.js.map +1 -1
  686. package/dist/src/tools/read-file.test.js +3 -2
  687. package/dist/src/tools/read-file.test.js.map +1 -1
  688. package/dist/src/tools/read-many-files.d.ts +2 -2
  689. package/dist/src/tools/read-many-files.js +7 -6
  690. package/dist/src/tools/read-many-files.js.map +1 -1
  691. package/dist/src/tools/read-many-files.test.js +4 -3
  692. package/dist/src/tools/read-many-files.test.js.map +1 -1
  693. package/dist/src/tools/ripGrep.d.ts +3 -2
  694. package/dist/src/tools/ripGrep.js +18 -7
  695. package/dist/src/tools/ripGrep.js.map +1 -1
  696. package/dist/src/tools/ripGrep.test.js +60 -4
  697. package/dist/src/tools/ripGrep.test.js.map +1 -1
  698. package/dist/src/tools/shell.d.ts +5 -7
  699. package/dist/src/tools/shell.js +77 -51
  700. package/dist/src/tools/shell.js.map +1 -1
  701. package/dist/src/tools/shell.test.js +59 -63
  702. package/dist/src/tools/shell.test.js.map +1 -1
  703. package/dist/src/tools/tool-error.d.ts +2 -1
  704. package/dist/src/tools/tool-error.js +2 -0
  705. package/dist/src/tools/tool-error.js.map +1 -1
  706. package/dist/src/tools/tool-names.d.ts +17 -0
  707. package/dist/src/tools/tool-names.js +59 -0
  708. package/dist/src/tools/tool-names.js.map +1 -1
  709. package/dist/src/tools/tool-names.test.d.ts +6 -0
  710. package/dist/src/tools/tool-names.test.js +43 -0
  711. package/dist/src/tools/tool-names.test.js.map +1 -0
  712. package/dist/src/tools/tool-registry.d.ts +11 -7
  713. package/dist/src/tools/tool-registry.js +15 -10
  714. package/dist/src/tools/tool-registry.js.map +1 -1
  715. package/dist/src/tools/tool-registry.test.js +16 -11
  716. package/dist/src/tools/tool-registry.test.js.map +1 -1
  717. package/dist/src/tools/tools.d.ts +25 -6
  718. package/dist/src/tools/tools.js +44 -25
  719. package/dist/src/tools/tools.js.map +1 -1
  720. package/dist/src/tools/tools.test.js +3 -1
  721. package/dist/src/tools/tools.test.js.map +1 -1
  722. package/dist/src/tools/web-fetch.d.ts +2 -2
  723. package/dist/src/tools/web-fetch.js +22 -9
  724. package/dist/src/tools/web-fetch.js.map +1 -1
  725. package/dist/src/tools/web-fetch.test.js +18 -19
  726. package/dist/src/tools/web-fetch.test.js.map +1 -1
  727. package/dist/src/tools/web-search.d.ts +2 -2
  728. package/dist/src/tools/web-search.js +5 -5
  729. package/dist/src/tools/web-search.js.map +1 -1
  730. package/dist/src/tools/web-search.test.js +2 -1
  731. package/dist/src/tools/web-search.test.js.map +1 -1
  732. package/dist/src/tools/write-file.d.ts +2 -2
  733. package/dist/src/tools/write-file.js +10 -4
  734. package/dist/src/tools/write-file.js.map +1 -1
  735. package/dist/src/tools/write-file.test.js +4 -1
  736. package/dist/src/tools/write-file.test.js.map +1 -1
  737. package/dist/src/tools/write-todos.d.ts +2 -2
  738. package/dist/src/tools/write-todos.js +5 -4
  739. package/dist/src/tools/write-todos.js.map +1 -1
  740. package/dist/src/tools/write-todos.test.js +2 -1
  741. package/dist/src/tools/write-todos.test.js.map +1 -1
  742. package/dist/src/utils/bfsFileSearch.d.ts +8 -0
  743. package/dist/src/utils/bfsFileSearch.js +63 -23
  744. package/dist/src/utils/bfsFileSearch.js.map +1 -1
  745. package/dist/src/utils/bfsFileSearch.test.js +65 -1
  746. package/dist/src/utils/bfsFileSearch.test.js.map +1 -1
  747. package/dist/src/utils/checkpointUtils.d.ts +82 -0
  748. package/dist/src/utils/checkpointUtils.js +117 -0
  749. package/dist/src/utils/checkpointUtils.js.map +1 -0
  750. package/dist/src/utils/checkpointUtils.test.d.ts +6 -0
  751. package/dist/src/utils/checkpointUtils.test.js +229 -0
  752. package/dist/src/utils/checkpointUtils.test.js.map +1 -0
  753. package/dist/src/utils/customHeaderUtils.d.ts +9 -0
  754. package/dist/src/utils/customHeaderUtils.js +34 -0
  755. package/dist/src/utils/customHeaderUtils.js.map +1 -0
  756. package/dist/src/utils/customHeaderUtils.test.d.ts +6 -0
  757. package/dist/src/utils/customHeaderUtils.test.js +77 -0
  758. package/dist/src/utils/customHeaderUtils.test.js.map +1 -0
  759. package/dist/src/utils/debugLogger.d.ts +3 -0
  760. package/dist/src/utils/debugLogger.js +28 -0
  761. package/dist/src/utils/debugLogger.js.map +1 -1
  762. package/dist/src/utils/editCorrector.js +6 -5
  763. package/dist/src/utils/editCorrector.js.map +1 -1
  764. package/dist/src/utils/editCorrector.test.js +7 -3
  765. package/dist/src/utils/editCorrector.test.js.map +1 -1
  766. package/dist/src/utils/editor.d.ts +9 -1
  767. package/dist/src/utils/editor.js +23 -14
  768. package/dist/src/utils/editor.js.map +1 -1
  769. package/dist/src/utils/environmentContext.d.ts +1 -0
  770. package/dist/src/utils/environmentContext.js +4 -0
  771. package/dist/src/utils/environmentContext.js.map +1 -1
  772. package/dist/src/utils/environmentContext.test.js +2 -0
  773. package/dist/src/utils/environmentContext.test.js.map +1 -1
  774. package/dist/src/utils/errorReporting.d.ts +1 -1
  775. package/dist/src/utils/errorReporting.js +13 -12
  776. package/dist/src/utils/errorReporting.js.map +1 -1
  777. package/dist/src/utils/errorReporting.test.js +17 -14
  778. package/dist/src/utils/errorReporting.test.js.map +1 -1
  779. package/dist/src/utils/errors.d.ts +8 -0
  780. package/dist/src/utils/errors.js +39 -2
  781. package/dist/src/utils/errors.js.map +1 -1
  782. package/dist/src/utils/errors.test.d.ts +6 -0
  783. package/dist/src/utils/errors.test.js +155 -0
  784. package/dist/src/utils/errors.test.js.map +1 -0
  785. package/dist/src/utils/events.d.ts +49 -19
  786. package/dist/src/utils/events.js +21 -9
  787. package/dist/src/utils/events.js.map +1 -1
  788. package/dist/src/utils/events.test.js +25 -0
  789. package/dist/src/utils/events.test.js.map +1 -1
  790. package/dist/src/utils/exitCodes.d.ts +12 -0
  791. package/dist/src/utils/exitCodes.js +13 -0
  792. package/dist/src/utils/exitCodes.js.map +1 -0
  793. package/dist/src/utils/extensionLoader.d.ts +2 -2
  794. package/dist/src/utils/extensionLoader.js +5 -6
  795. package/dist/src/utils/extensionLoader.js.map +1 -1
  796. package/dist/src/utils/extensionLoader.test.js +11 -0
  797. package/dist/src/utils/extensionLoader.test.js.map +1 -1
  798. package/dist/src/utils/fetch.d.ts +1 -1
  799. package/dist/src/utils/fetch.js +3 -3
  800. package/dist/src/utils/fetch.js.map +1 -1
  801. package/dist/src/utils/fileUtils.d.ts +4 -0
  802. package/dist/src/utils/fileUtils.js +53 -0
  803. package/dist/src/utils/fileUtils.js.map +1 -1
  804. package/dist/src/utils/fileUtils.test.js +127 -1
  805. package/dist/src/utils/fileUtils.test.js.map +1 -1
  806. package/dist/src/utils/filesearch/crawlCache.js.map +1 -1
  807. package/dist/src/utils/filesearch/fileSearch.js.map +1 -1
  808. package/dist/src/utils/flashFallback.test.js +1 -1
  809. package/dist/src/utils/flashFallback.test.js.map +1 -1
  810. package/dist/src/utils/geminiIgnoreParser.d.ts +11 -0
  811. package/dist/src/utils/geminiIgnoreParser.js +20 -0
  812. package/dist/src/utils/geminiIgnoreParser.js.map +1 -1
  813. package/dist/src/utils/geminiIgnoreParser.test.js +48 -0
  814. package/dist/src/utils/geminiIgnoreParser.test.js.map +1 -1
  815. package/dist/src/utils/generateContentResponseUtilities.d.ts +3 -1
  816. package/dist/src/utils/generateContentResponseUtilities.js +106 -0
  817. package/dist/src/utils/generateContentResponseUtilities.js.map +1 -1
  818. package/dist/src/utils/generateContentResponseUtilities.test.js +279 -2
  819. package/dist/src/utils/generateContentResponseUtilities.test.js.map +1 -1
  820. package/dist/src/utils/getFolderStructure.js +7 -2
  821. package/dist/src/utils/getFolderStructure.js.map +1 -1
  822. package/dist/src/utils/googleErrors.js +31 -18
  823. package/dist/src/utils/googleErrors.js.map +1 -1
  824. package/dist/src/utils/googleErrors.test.js +10 -2
  825. package/dist/src/utils/googleErrors.test.js.map +1 -1
  826. package/dist/src/utils/googleQuotaErrors.d.ts +3 -3
  827. package/dist/src/utils/googleQuotaErrors.js +32 -6
  828. package/dist/src/utils/googleQuotaErrors.js.map +1 -1
  829. package/dist/src/utils/googleQuotaErrors.test.js +94 -2
  830. package/dist/src/utils/googleQuotaErrors.test.js.map +1 -1
  831. package/dist/src/utils/memoryDiscovery.d.ts +5 -0
  832. package/dist/src/utils/memoryDiscovery.js +9 -5
  833. package/dist/src/utils/memoryDiscovery.js.map +1 -1
  834. package/dist/src/utils/memoryDiscovery.test.js +31 -1
  835. package/dist/src/utils/memoryDiscovery.test.js.map +1 -1
  836. package/dist/src/utils/nextSpeakerChecker.test.js +4 -0
  837. package/dist/src/utils/nextSpeakerChecker.test.js.map +1 -1
  838. package/dist/src/utils/package.d.ts +14 -0
  839. package/dist/src/utils/package.js +15 -2
  840. package/dist/src/utils/package.js.map +1 -1
  841. package/dist/src/utils/pathCorrector.js +12 -2
  842. package/dist/src/utils/pathCorrector.js.map +1 -1
  843. package/dist/src/utils/pathCorrector.test.js +6 -2
  844. package/dist/src/utils/pathCorrector.test.js.map +1 -1
  845. package/dist/src/utils/retry.d.ts +11 -0
  846. package/dist/src/utils/retry.js +62 -21
  847. package/dist/src/utils/retry.js.map +1 -1
  848. package/dist/src/utils/retry.test.js +170 -10
  849. package/dist/src/utils/retry.test.js.map +1 -1
  850. package/dist/src/utils/schemaValidator.d.ts +1 -1
  851. package/dist/src/utils/schemaValidator.js +1 -1
  852. package/dist/src/utils/shell-permissions.d.ts +52 -0
  853. package/dist/src/utils/shell-permissions.js +188 -0
  854. package/dist/src/utils/shell-permissions.js.map +1 -0
  855. package/dist/src/utils/shell-permissions.test.d.ts +6 -0
  856. package/dist/src/utils/shell-permissions.test.js +369 -0
  857. package/dist/src/utils/shell-permissions.test.js.map +1 -0
  858. package/dist/src/utils/shell-utils.d.ts +16 -47
  859. package/dist/src/utils/shell-utils.js +99 -195
  860. package/dist/src/utils/shell-utils.js.map +1 -1
  861. package/dist/src/utils/shell-utils.test.js +99 -288
  862. package/dist/src/utils/shell-utils.test.js.map +1 -1
  863. package/dist/src/utils/stdio.d.ts +2 -2
  864. package/dist/src/utils/stdio.js +2 -2
  865. package/dist/src/utils/stdio.js.map +1 -1
  866. package/dist/src/utils/stdio.test.js +5 -5
  867. package/dist/src/utils/stdio.test.js.map +1 -1
  868. package/dist/src/utils/summarizer.test.js +3 -2
  869. package/dist/src/utils/summarizer.test.js.map +1 -1
  870. package/dist/src/utils/terminal.d.ts +4 -0
  871. package/dist/src/utils/terminal.js +12 -0
  872. package/dist/src/utils/terminal.js.map +1 -1
  873. package/dist/src/utils/terminalSerializer.test.js +17 -0
  874. package/dist/src/utils/terminalSerializer.test.js.map +1 -1
  875. package/dist/src/utils/tokenCalculation.d.ts +19 -0
  876. package/dist/src/utils/tokenCalculation.js +85 -0
  877. package/dist/src/utils/tokenCalculation.js.map +1 -0
  878. package/dist/src/utils/tokenCalculation.test.d.ts +6 -0
  879. package/dist/src/utils/tokenCalculation.test.js +87 -0
  880. package/dist/src/utils/tokenCalculation.test.js.map +1 -0
  881. package/dist/src/utils/tool-utils.d.ts +9 -0
  882. package/dist/src/utils/tool-utils.js +29 -0
  883. package/dist/src/utils/tool-utils.js.map +1 -1
  884. package/dist/src/utils/tool-utils.test.js +17 -2
  885. package/dist/src/utils/tool-utils.test.js.map +1 -1
  886. package/dist/src/utils/version.d.ts +6 -0
  887. package/dist/src/utils/version.js +15 -0
  888. package/dist/src/utils/version.js.map +1 -0
  889. package/dist/src/utils/version.test.d.ts +6 -0
  890. package/dist/src/utils/version.test.js +39 -0
  891. package/dist/src/utils/version.test.js.map +1 -0
  892. package/dist/tsconfig.tsbuildinfo +1 -1
  893. package/package.json +8 -7
@@ -0,0 +1,53 @@
1
+ /**
2
+ * @license
3
+ * Copyright 2025 Google LLC
4
+ * SPDX-License-Identifier: Apache-2.0
5
+ */
6
+ export function performInit(doesGeminiMdExist) {
7
+ if (doesGeminiMdExist) {
8
+ return {
9
+ type: 'message',
10
+ messageType: 'info',
11
+ content: 'A GEMINI.md file already exists in this directory. No changes were made.',
12
+ };
13
+ }
14
+ return {
15
+ type: 'submit_prompt',
16
+ content: `
17
+ You are an AI agent that brings the power of Gemini directly into the terminal. Your task is to analyze the current directory and generate a comprehensive GEMINI.md file to be used as instructional context for future interactions.
18
+
19
+ **Analysis Process:**
20
+
21
+ 1. **Initial Exploration:**
22
+ * Start by listing the files and directories to get a high-level overview of the structure.
23
+ * Read the README file (e.g., \`README.md\`, \`README.txt\`) if it exists. This is often the best place to start.
24
+
25
+ 2. **Iterative Deep Dive (up to 10 files):**
26
+ * Based on your initial findings, select a few files that seem most important (e.g., configuration files, main source files, documentation).
27
+ * Read them. As you learn more, refine your understanding and decide which files to read next. You don't need to decide all 10 files at once. Let your discoveries guide your exploration.
28
+
29
+ 3. **Identify Project Type:**
30
+ * **Code Project:** Look for clues like \`package.json\`, \`requirements.txt\`, \`pom.xml\`, \`go.mod\`, \`Cargo.toml\`, \`build.gradle\`, or a \`src\` directory. If you find them, this is likely a software project.
31
+ * **Non-Code Project:** If you don't find code-related files, this might be a directory for documentation, research papers, notes, or something else.
32
+
33
+ **GEMINI.md Content Generation:**
34
+
35
+ **For a Code Project:**
36
+
37
+ * **Project Overview:** Write a clear and concise summary of the project's purpose, main technologies, and architecture.
38
+ * **Building and Running:** Document the key commands for building, running, and testing the project. Infer these from the files you've read (e.g., \`scripts\` in \`package.json\`, \`Makefile\`, etc.). If you can't find explicit commands, provide a placeholder with a TODO.
39
+ * **Development Conventions:** Describe any coding styles, testing practices, or contribution guidelines you can infer from the codebase.
40
+
41
+ **For a Non-Code Project:**
42
+
43
+ * **Directory Overview:** Describe the purpose and contents of the directory. What is it for? What kind of information does it hold?
44
+ * **Key Files:** List the most important files and briefly explain what they contain.
45
+ * **Usage:** Explain how the contents of this directory are intended to be used.
46
+
47
+ **Final Output:**
48
+
49
+ Write the complete content to the \`GEMINI.md\` file. The output must be well-formatted Markdown.
50
+ `,
51
+ };
52
+ }
53
+ //# sourceMappingURL=init.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"init.js","sourceRoot":"","sources":["../../../src/commands/init.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,UAAU,WAAW,CAAC,iBAA0B;IACpD,IAAI,iBAAiB,EAAE,CAAC;QACtB,OAAO;YACL,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,MAAM;YACnB,OAAO,EACL,0EAA0E;SAC7E,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkCZ;KACE,CAAC;AACJ,CAAC"}
@@ -0,0 +1,6 @@
1
+ /**
2
+ * @license
3
+ * Copyright 2025 Google LLC
4
+ * SPDX-License-Identifier: Apache-2.0
5
+ */
6
+ export {};
@@ -0,0 +1,25 @@
1
+ /**
2
+ * @license
3
+ * Copyright 2025 Google LLC
4
+ * SPDX-License-Identifier: Apache-2.0
5
+ */
6
+ import { expect, describe, it } from 'vitest';
7
+ import { performInit } from './init.js';
8
+ describe('performInit', () => {
9
+ it('returns info if GEMINI.md already exists', () => {
10
+ const result = performInit(true);
11
+ expect(result.type).toBe('message');
12
+ if (result.type === 'message') {
13
+ expect(result.messageType).toBe('info');
14
+ expect(result.content).toContain('already exists');
15
+ }
16
+ });
17
+ it('returns submit_prompt if GEMINI.md does not exist', () => {
18
+ const result = performInit(false);
19
+ expect(result.type).toBe('submit_prompt');
20
+ if (result.type === 'submit_prompt') {
21
+ expect(result.content).toContain('You are an AI agent');
22
+ }
23
+ });
24
+ });
25
+ //# sourceMappingURL=init.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"init.test.js","sourceRoot":"","sources":["../../../src/commands/init.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QAEjC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACpC,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC9B,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACxC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;QACrD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;QAClC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAE1C,IAAI,MAAM,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;YACpC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,qBAAqB,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
@@ -0,0 +1,9 @@
1
+ /**
2
+ * @license
3
+ * Copyright 2025 Google LLC
4
+ * SPDX-License-Identifier: Apache-2.0
5
+ */
6
+ import type { GitService } from '../services/gitService.js';
7
+ import type { CommandActionReturn } from './types.js';
8
+ import { type ToolCallData } from '../utils/checkpointUtils.js';
9
+ export declare function performRestore<HistoryType = unknown, ArgsType = unknown>(toolCallData: ToolCallData<HistoryType, ArgsType>, gitService: GitService | undefined): AsyncGenerator<CommandActionReturn<HistoryType>>;
@@ -0,0 +1,46 @@
1
+ /**
2
+ * @license
3
+ * Copyright 2025 Google LLC
4
+ * SPDX-License-Identifier: Apache-2.0
5
+ */
6
+ import {} from '../utils/checkpointUtils.js';
7
+ export async function* performRestore(toolCallData, gitService) {
8
+ if (toolCallData.history && toolCallData.clientHistory) {
9
+ yield {
10
+ type: 'load_history',
11
+ history: toolCallData.history,
12
+ clientHistory: toolCallData.clientHistory,
13
+ };
14
+ }
15
+ if (toolCallData.commitHash) {
16
+ if (!gitService) {
17
+ yield {
18
+ type: 'message',
19
+ messageType: 'error',
20
+ content: 'Git service is not available, cannot restore checkpoint. Please ensure you are in a git repository.',
21
+ };
22
+ return;
23
+ }
24
+ try {
25
+ await gitService.restoreProjectFromSnapshot(toolCallData.commitHash);
26
+ yield {
27
+ type: 'message',
28
+ messageType: 'info',
29
+ content: 'Restored project to the state before the tool call.',
30
+ };
31
+ }
32
+ catch (e) {
33
+ const error = e;
34
+ if (error.message.includes('unable to read tree')) {
35
+ yield {
36
+ type: 'message',
37
+ messageType: 'error',
38
+ content: `The commit hash '${toolCallData.commitHash}' associated with this checkpoint could not be found in your Git repository. This can happen if the repository has been re-cloned, reset, or if old commits have been garbage collected. This checkpoint cannot be restored.`,
39
+ };
40
+ return;
41
+ }
42
+ throw e;
43
+ }
44
+ }
45
+ }
46
+ //# sourceMappingURL=restore.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"restore.js","sourceRoot":"","sources":["../../../src/commands/restore.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAqB,MAAM,6BAA6B,CAAC;AAEhE,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,cAAc,CAInC,YAAiD,EACjD,UAAkC;IAElC,IAAI,YAAY,CAAC,OAAO,IAAI,YAAY,CAAC,aAAa,EAAE,CAAC;QACvD,MAAM;YACJ,IAAI,EAAE,cAAc;YACpB,OAAO,EAAE,YAAY,CAAC,OAAO;YAC7B,aAAa,EAAE,YAAY,CAAC,aAAa;SAC1C,CAAC;IACJ,CAAC;IAED,IAAI,YAAY,CAAC,UAAU,EAAE,CAAC;QAC5B,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM;gBACJ,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,OAAO;gBACpB,OAAO,EACL,qGAAqG;aACxG,CAAC;YACF,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,MAAM,UAAU,CAAC,0BAA0B,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;YACrE,MAAM;gBACJ,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,MAAM;gBACnB,OAAO,EAAE,qDAAqD;aAC/D,CAAC;QACJ,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,KAAK,GAAG,CAAU,CAAC;YACzB,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,CAAC;gBAClD,MAAM;oBACJ,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,OAAO;oBACpB,OAAO,EAAE,oBAAoB,YAAY,CAAC,UAAU,8NAA8N;iBACnR,CAAC;gBACF,OAAO;YACT,CAAC;YACD,MAAM,CAAC,CAAC;QACV,CAAC;IACH,CAAC;AACH,CAAC"}
@@ -0,0 +1,6 @@
1
+ /**
2
+ * @license
3
+ * Copyright 2025 Google LLC
4
+ * SPDX-License-Identifier: Apache-2.0
5
+ */
6
+ export {};
@@ -0,0 +1,137 @@
1
+ /**
2
+ * @license
3
+ * Copyright 2025 Google LLC
4
+ * SPDX-License-Identifier: Apache-2.0
5
+ */
6
+ import { describe, it, expect, vi, beforeEach } from 'vitest';
7
+ import { performRestore } from './restore.js';
8
+ import {} from '../utils/checkpointUtils.js';
9
+ describe('performRestore', () => {
10
+ let mockGitService;
11
+ beforeEach(() => {
12
+ mockGitService = {
13
+ initialize: vi.fn(),
14
+ verifyGitAvailability: vi.fn(),
15
+ setupShadowGitRepository: vi.fn(),
16
+ getCurrentCommitHash: vi.fn(),
17
+ createFileSnapshot: vi.fn(),
18
+ restoreProjectFromSnapshot: vi.fn(),
19
+ storage: {},
20
+ getHistoryDir: vi.fn().mockReturnValue('mock-history-dir'),
21
+ shadowGitRepository: {},
22
+ };
23
+ });
24
+ it('should yield load_history if history and clientHistory are present', async () => {
25
+ const toolCallData = {
26
+ toolCall: { name: 'test', args: {} },
27
+ history: [{ some: 'history' }],
28
+ clientHistory: [{ role: 'user', parts: [{ text: 'hello' }] }],
29
+ };
30
+ const generator = performRestore(toolCallData, undefined);
31
+ const result = await generator.next();
32
+ expect(result.value).toEqual({
33
+ type: 'load_history',
34
+ history: toolCallData.history,
35
+ clientHistory: toolCallData.clientHistory,
36
+ });
37
+ expect(result.done).toBe(false);
38
+ const nextResult = await generator.next();
39
+ expect(nextResult.done).toBe(true);
40
+ });
41
+ it('should call restoreProjectFromSnapshot and yield a message if commitHash and gitService are present', async () => {
42
+ const toolCallData = {
43
+ toolCall: { name: 'test', args: {} },
44
+ commitHash: 'test-commit-hash',
45
+ };
46
+ const spy = vi
47
+ .spyOn(mockGitService, 'restoreProjectFromSnapshot')
48
+ .mockResolvedValue(undefined);
49
+ const generator = performRestore(toolCallData, mockGitService);
50
+ const result = await generator.next();
51
+ expect(spy).toHaveBeenCalledWith('test-commit-hash');
52
+ expect(result.value).toEqual({
53
+ type: 'message',
54
+ messageType: 'info',
55
+ content: 'Restored project to the state before the tool call.',
56
+ });
57
+ expect(result.done).toBe(false);
58
+ const nextResult = await generator.next();
59
+ expect(nextResult.done).toBe(true);
60
+ });
61
+ it('should yield an error message if restoreProjectFromSnapshot throws "unable to read tree" error', async () => {
62
+ const toolCallData = {
63
+ toolCall: { name: 'test', args: {} },
64
+ commitHash: 'invalid-commit-hash',
65
+ };
66
+ const spy = vi
67
+ .spyOn(mockGitService, 'restoreProjectFromSnapshot')
68
+ .mockRejectedValue(new Error('fatal: unable to read tree invalid-commit-hash'));
69
+ const generator = performRestore(toolCallData, mockGitService);
70
+ const result = await generator.next();
71
+ expect(spy).toHaveBeenCalledWith('invalid-commit-hash');
72
+ expect(result.value).toEqual({
73
+ type: 'message',
74
+ messageType: 'error',
75
+ content: "The commit hash 'invalid-commit-hash' associated with this checkpoint could not be found in your Git repository. This can happen if the repository has been re-cloned, reset, or if old commits have been garbage collected. This checkpoint cannot be restored.",
76
+ });
77
+ expect(result.done).toBe(false);
78
+ const nextResult = await generator.next();
79
+ expect(nextResult.done).toBe(true);
80
+ });
81
+ it('should re-throw other errors from restoreProjectFromSnapshot', async () => {
82
+ const toolCallData = {
83
+ toolCall: { name: 'test', args: {} },
84
+ commitHash: 'some-commit-hash',
85
+ };
86
+ const testError = new Error('something went wrong');
87
+ vi.spyOn(mockGitService, 'restoreProjectFromSnapshot').mockRejectedValue(testError);
88
+ const generator = performRestore(toolCallData, mockGitService);
89
+ await expect(generator.next()).rejects.toThrow(testError);
90
+ });
91
+ it('should yield load_history then a message if both are present', async () => {
92
+ const toolCallData = {
93
+ toolCall: { name: 'test', args: {} },
94
+ history: [{ some: 'history' }],
95
+ clientHistory: [{ role: 'user', parts: [{ text: 'hello' }] }],
96
+ commitHash: 'test-commit-hash',
97
+ };
98
+ const spy = vi
99
+ .spyOn(mockGitService, 'restoreProjectFromSnapshot')
100
+ .mockResolvedValue(undefined);
101
+ const generator = performRestore(toolCallData, mockGitService);
102
+ const historyResult = await generator.next();
103
+ expect(historyResult.value).toEqual({
104
+ type: 'load_history',
105
+ history: toolCallData.history,
106
+ clientHistory: toolCallData.clientHistory,
107
+ });
108
+ expect(historyResult.done).toBe(false);
109
+ const messageResult = await generator.next();
110
+ expect(spy).toHaveBeenCalledWith('test-commit-hash');
111
+ expect(messageResult.value).toEqual({
112
+ type: 'message',
113
+ messageType: 'info',
114
+ content: 'Restored project to the state before the tool call.',
115
+ });
116
+ expect(messageResult.done).toBe(false);
117
+ const nextResult = await generator.next();
118
+ expect(nextResult.done).toBe(true);
119
+ });
120
+ it('should yield error message if commitHash is present but gitService is undefined', async () => {
121
+ const toolCallData = {
122
+ toolCall: { name: 'test', args: {} },
123
+ commitHash: 'test-commit-hash',
124
+ };
125
+ const generator = performRestore(toolCallData, undefined);
126
+ const result = await generator.next();
127
+ expect(result.value).toEqual({
128
+ type: 'message',
129
+ messageType: 'error',
130
+ content: 'Git service is not available, cannot restore checkpoint. Please ensure you are in a git repository.',
131
+ });
132
+ expect(result.done).toBe(false);
133
+ const nextResult = await generator.next();
134
+ expect(nextResult.done).toBe(true);
135
+ });
136
+ });
137
+ //# sourceMappingURL=restore.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"restore.test.js","sourceRoot":"","sources":["../../../src/commands/restore.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,41 @@
1
+ /**
2
+ * @license
3
+ * Copyright 2025 Google LLC
4
+ * SPDX-License-Identifier: Apache-2.0
5
+ */
6
+ import type { Content, PartListUnion } from '@google/genai';
7
+ /**
8
+ * The return type for a command action that results in scheduling a tool call.
9
+ */
10
+ export interface ToolActionReturn {
11
+ type: 'tool';
12
+ toolName: string;
13
+ toolArgs: Record<string, unknown>;
14
+ }
15
+ /**
16
+ * The return type for a command action that results in a simple message
17
+ * being displayed to the user.
18
+ */
19
+ export interface MessageActionReturn {
20
+ type: 'message';
21
+ messageType: 'info' | 'error';
22
+ content: string;
23
+ }
24
+ /**
25
+ * The return type for a command action that results in replacing
26
+ * the entire conversation history.
27
+ */
28
+ export interface LoadHistoryActionReturn<HistoryType = unknown> {
29
+ type: 'load_history';
30
+ history: HistoryType;
31
+ clientHistory: Content[];
32
+ }
33
+ /**
34
+ * The return type for a command action that should immediately submit
35
+ * content as a prompt to the Gemini model.
36
+ */
37
+ export interface SubmitPromptActionReturn {
38
+ type: 'submit_prompt';
39
+ content: PartListUnion;
40
+ }
41
+ export type CommandActionReturn<HistoryType = unknown> = ToolActionReturn | MessageActionReturn | LoadHistoryActionReturn<HistoryType> | SubmitPromptActionReturn;
@@ -0,0 +1,7 @@
1
+ /**
2
+ * @license
3
+ * Copyright 2025 Google LLC
4
+ * SPDX-License-Identifier: Apache-2.0
5
+ */
6
+ export {};
7
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/commands/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}