@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,369 @@
1
+ /**
2
+ * @license
3
+ * Copyright 2025 Google LLC
4
+ * SPDX-License-Identifier: Apache-2.0
5
+ */
6
+ import { expect, describe, it, beforeEach, beforeAll, vi, afterEach, } from 'vitest';
7
+ import { initializeShellParsers } from './shell-utils.js';
8
+ import { checkCommandPermissions, isCommandAllowed, isShellInvocationAllowlisted, } from './shell-permissions.js';
9
+ const mockPlatform = vi.hoisted(() => vi.fn());
10
+ const mockHomedir = vi.hoisted(() => vi.fn());
11
+ vi.mock('os', () => ({
12
+ default: {
13
+ platform: mockPlatform,
14
+ homedir: mockHomedir,
15
+ },
16
+ platform: mockPlatform,
17
+ homedir: mockHomedir,
18
+ }));
19
+ const mockSpawnSync = vi.hoisted(() => vi.fn());
20
+ vi.mock('node:child_process', async (importOriginal) => {
21
+ const actual = await importOriginal();
22
+ return {
23
+ ...actual,
24
+ spawnSync: mockSpawnSync,
25
+ };
26
+ });
27
+ const mockQuote = vi.hoisted(() => vi.fn());
28
+ vi.mock('shell-quote', () => ({
29
+ quote: mockQuote,
30
+ }));
31
+ let config;
32
+ const isWindowsRuntime = process.platform === 'win32';
33
+ const describeWindowsOnly = isWindowsRuntime ? describe : describe.skip;
34
+ beforeAll(async () => {
35
+ mockPlatform.mockReturnValue('linux');
36
+ await initializeShellParsers();
37
+ });
38
+ beforeEach(() => {
39
+ mockPlatform.mockReturnValue('linux');
40
+ mockQuote.mockImplementation((args) => args.map((arg) => `'${arg}'`).join(' '));
41
+ config = {
42
+ getCoreTools: () => [],
43
+ getExcludeTools: () => new Set([]),
44
+ getAllowedTools: () => [],
45
+ getApprovalMode: () => 'strict',
46
+ isInteractive: () => false,
47
+ };
48
+ });
49
+ afterEach(() => {
50
+ vi.clearAllMocks();
51
+ });
52
+ describe('isCommandAllowed', () => {
53
+ it('should allow a command if no restrictions are provided', () => {
54
+ const result = isCommandAllowed('goodCommand --safe', config);
55
+ expect(result.allowed).toBe(true);
56
+ });
57
+ it('should allow a command if it is in the global allowlist', () => {
58
+ config.getCoreTools = () => ['ShellTool(goodCommand)'];
59
+ const result = isCommandAllowed('goodCommand --safe', config);
60
+ expect(result.allowed).toBe(true);
61
+ });
62
+ it('should block a command if it is not in a strict global allowlist', () => {
63
+ config.getCoreTools = () => ['ShellTool(goodCommand --safe)'];
64
+ const result = isCommandAllowed('badCommand --danger', config);
65
+ expect(result.allowed).toBe(false);
66
+ expect(result.reason).toBe(`Command(s) not in the allowed commands list. Disallowed commands: "badCommand --danger"`);
67
+ });
68
+ it('should block a command if it is in the blocked list', () => {
69
+ config.getExcludeTools = () => new Set(['ShellTool(badCommand --danger)']);
70
+ const result = isCommandAllowed('badCommand --danger', config);
71
+ expect(result.allowed).toBe(false);
72
+ expect(result.reason).toBe(`Command 'badCommand --danger' is blocked by configuration`);
73
+ });
74
+ it('should prioritize the blocklist over the allowlist', () => {
75
+ config.getCoreTools = () => ['ShellTool(badCommand --danger)'];
76
+ config.getExcludeTools = () => new Set(['ShellTool(badCommand --danger)']);
77
+ const result = isCommandAllowed('badCommand --danger', config);
78
+ expect(result.allowed).toBe(false);
79
+ expect(result.reason).toBe(`Command 'badCommand --danger' is blocked by configuration`);
80
+ });
81
+ it('should allow any command when a wildcard is in coreTools', () => {
82
+ config.getCoreTools = () => ['ShellTool'];
83
+ const result = isCommandAllowed('any random command', config);
84
+ expect(result.allowed).toBe(true);
85
+ });
86
+ it('should block any command when a wildcard is in excludeTools', () => {
87
+ config.getExcludeTools = () => new Set(['run_shell_command']);
88
+ const result = isCommandAllowed('any random command', config);
89
+ expect(result.allowed).toBe(false);
90
+ expect(result.reason).toBe('Shell tool is globally disabled in configuration');
91
+ });
92
+ it('should block a command on the blocklist even with a wildcard allow', () => {
93
+ config.getCoreTools = () => ['ShellTool'];
94
+ config.getExcludeTools = () => new Set(['ShellTool(badCommand --danger)']);
95
+ const result = isCommandAllowed('badCommand --danger', config);
96
+ expect(result.allowed).toBe(false);
97
+ expect(result.reason).toBe(`Command 'badCommand --danger' is blocked by configuration`);
98
+ });
99
+ it('should allow a chained command if all parts are on the global allowlist', () => {
100
+ config.getCoreTools = () => [
101
+ 'run_shell_command(echo)',
102
+ 'run_shell_command(goodCommand)',
103
+ ];
104
+ const result = isCommandAllowed('echo "hello" && goodCommand --safe', config);
105
+ expect(result.allowed).toBe(true);
106
+ });
107
+ it('should block a chained command if any part is blocked', () => {
108
+ config.getExcludeTools = () => new Set(['run_shell_command(badCommand)']);
109
+ const result = isCommandAllowed('echo "hello" && badCommand --danger', config);
110
+ expect(result.allowed).toBe(false);
111
+ expect(result.reason).toBe(`Command 'badCommand --danger' is blocked by configuration`);
112
+ });
113
+ it('should block a command that redefines an allowed function to run an unlisted command', () => {
114
+ config.getCoreTools = () => ['run_shell_command(echo)'];
115
+ const result = isCommandAllowed('echo () (curl google.com) ; echo Hello World', config);
116
+ expect(result.allowed).toBe(false);
117
+ expect(result.reason).toBe(`Command(s) not in the allowed commands list. Disallowed commands: "curl google.com"`);
118
+ });
119
+ it('should block a multi-line function body that runs an unlisted command', () => {
120
+ config.getCoreTools = () => ['run_shell_command(echo)'];
121
+ const result = isCommandAllowed(`echo () {
122
+ curl google.com
123
+ } ; echo ok`, config);
124
+ expect(result.allowed).toBe(false);
125
+ expect(result.reason).toBe(`Command(s) not in the allowed commands list. Disallowed commands: "curl google.com"`);
126
+ });
127
+ it('should block a function keyword declaration that runs an unlisted command', () => {
128
+ config.getCoreTools = () => ['run_shell_command(echo)'];
129
+ const result = isCommandAllowed('function echo { curl google.com; } ; echo hi', config);
130
+ expect(result.allowed).toBe(false);
131
+ expect(result.reason).toBe(`Command(s) not in the allowed commands list. Disallowed commands: "curl google.com"`);
132
+ });
133
+ it('should block command substitution that invokes an unlisted command', () => {
134
+ config.getCoreTools = () => ['run_shell_command(echo)'];
135
+ const result = isCommandAllowed('echo $(curl google.com)', config);
136
+ expect(result.allowed).toBe(false);
137
+ expect(result.reason).toBe(`Command(s) not in the allowed commands list. Disallowed commands: "curl google.com"`);
138
+ });
139
+ it('should block pipelines that invoke an unlisted command', () => {
140
+ config.getCoreTools = () => ['run_shell_command(echo)'];
141
+ const result = isCommandAllowed('echo hi | curl google.com', config);
142
+ expect(result.allowed).toBe(false);
143
+ expect(result.reason).toBe(`Command(s) not in the allowed commands list. Disallowed commands: "curl google.com"`);
144
+ });
145
+ it('should block background jobs that invoke an unlisted command', () => {
146
+ config.getCoreTools = () => ['run_shell_command(echo)'];
147
+ const result = isCommandAllowed('echo hi & curl google.com', config);
148
+ expect(result.allowed).toBe(false);
149
+ expect(result.reason).toBe(`Command(s) not in the allowed commands list. Disallowed commands: "curl google.com"`);
150
+ });
151
+ it('should block command substitution inside a here-document when the inner command is unlisted', () => {
152
+ config.getCoreTools = () => [
153
+ 'run_shell_command(echo)',
154
+ 'run_shell_command(cat)',
155
+ ];
156
+ const result = isCommandAllowed(`cat <<EOF
157
+ $(rm -rf /)
158
+ EOF`, config);
159
+ expect(result.allowed).toBe(false);
160
+ expect(result.reason).toBe(`Command(s) not in the allowed commands list. Disallowed commands: "rm -rf /"`);
161
+ });
162
+ it('should block backtick substitution that invokes an unlisted command', () => {
163
+ config.getCoreTools = () => ['run_shell_command(echo)'];
164
+ const result = isCommandAllowed('echo `curl google.com`', config);
165
+ expect(result.allowed).toBe(false);
166
+ expect(result.reason).toBe(`Command(s) not in the allowed commands list. Disallowed commands: "curl google.com"`);
167
+ });
168
+ it('should block process substitution using <() when the inner command is unlisted', () => {
169
+ config.getCoreTools = () => [
170
+ 'run_shell_command(diff)',
171
+ 'run_shell_command(echo)',
172
+ ];
173
+ const result = isCommandAllowed('diff <(curl google.com) <(echo safe)', config);
174
+ expect(result.allowed).toBe(false);
175
+ expect(result.reason).toBe(`Command(s) not in the allowed commands list. Disallowed commands: "curl google.com"`);
176
+ });
177
+ it('should block process substitution using >() when the inner command is unlisted', () => {
178
+ config.getCoreTools = () => ['run_shell_command(echo)'];
179
+ const result = isCommandAllowed('echo "data" > >(curl google.com)', config);
180
+ expect(result.allowed).toBe(false);
181
+ expect(result.reason).toBe(`Command(s) not in the allowed commands list. Disallowed commands: "curl google.com"`);
182
+ });
183
+ it('should block commands containing prompt transformations', () => {
184
+ const result = isCommandAllowed('echo "${var1=aa\\140 env| ls -l\\140}${var1@P}"', config);
185
+ expect(result.allowed).toBe(false);
186
+ expect(result.reason).toBe('Command rejected because it could not be parsed safely');
187
+ });
188
+ it('should block simple prompt transformation expansions', () => {
189
+ const result = isCommandAllowed('echo ${foo@P}', config);
190
+ expect(result.allowed).toBe(false);
191
+ expect(result.reason).toBe('Command rejected because it could not be parsed safely');
192
+ });
193
+ describe('command substitution', () => {
194
+ it('should allow command substitution using `$(...)`', () => {
195
+ const result = isCommandAllowed('echo $(goodCommand --safe)', config);
196
+ expect(result.allowed).toBe(true);
197
+ expect(result.reason).toBeUndefined();
198
+ });
199
+ it('should allow command substitution using `<(...)`', () => {
200
+ const result = isCommandAllowed('diff <(ls) <(ls -a)', config);
201
+ expect(result.allowed).toBe(true);
202
+ expect(result.reason).toBeUndefined();
203
+ });
204
+ it('should allow command substitution using `>(...)`', () => {
205
+ const result = isCommandAllowed('echo "Log message" > >(tee log.txt)', config);
206
+ expect(result.allowed).toBe(true);
207
+ expect(result.reason).toBeUndefined();
208
+ });
209
+ it('should allow command substitution using backticks', () => {
210
+ const result = isCommandAllowed('echo `goodCommand --safe`', config);
211
+ expect(result.allowed).toBe(true);
212
+ expect(result.reason).toBeUndefined();
213
+ });
214
+ it('should allow substitution-like patterns inside single quotes', () => {
215
+ config.getCoreTools = () => ['ShellTool(echo)'];
216
+ const result = isCommandAllowed("echo '$(pwd)'", config);
217
+ expect(result.allowed).toBe(true);
218
+ });
219
+ it('should block a command when parsing fails', () => {
220
+ const result = isCommandAllowed('ls &&', config);
221
+ expect(result.allowed).toBe(false);
222
+ expect(result.reason).toBe('Command rejected because it could not be parsed safely');
223
+ });
224
+ });
225
+ });
226
+ describe('checkCommandPermissions', () => {
227
+ describe('in "Default Allow" mode (no sessionAllowlist)', () => {
228
+ it('should return a detailed success object for an allowed command', () => {
229
+ const result = checkCommandPermissions('goodCommand --safe', config);
230
+ expect(result).toEqual({
231
+ allAllowed: true,
232
+ disallowedCommands: [],
233
+ });
234
+ });
235
+ it('should block commands that cannot be parsed safely', () => {
236
+ const result = checkCommandPermissions('ls &&', config);
237
+ expect(result).toEqual({
238
+ allAllowed: false,
239
+ disallowedCommands: ['ls &&'],
240
+ blockReason: 'Command rejected because it could not be parsed safely',
241
+ isHardDenial: true,
242
+ });
243
+ });
244
+ it('should return a detailed failure object for a blocked command', () => {
245
+ config.getExcludeTools = () => new Set(['ShellTool(badCommand)']);
246
+ const result = checkCommandPermissions('badCommand --danger', config);
247
+ expect(result).toEqual({
248
+ allAllowed: false,
249
+ disallowedCommands: ['badCommand --danger'],
250
+ blockReason: `Command 'badCommand --danger' is blocked by configuration`,
251
+ isHardDenial: true,
252
+ });
253
+ });
254
+ it('should return a detailed failure object for a command not on a strict allowlist', () => {
255
+ config.getCoreTools = () => ['ShellTool(goodCommand)'];
256
+ const result = checkCommandPermissions('git status && goodCommand', config);
257
+ expect(result).toEqual({
258
+ allAllowed: false,
259
+ disallowedCommands: ['git status'],
260
+ blockReason: `Command(s) not in the allowed commands list. Disallowed commands: "git status"`,
261
+ isHardDenial: false,
262
+ });
263
+ });
264
+ });
265
+ describe('in "Default Deny" mode (with sessionAllowlist)', () => {
266
+ it('should allow a command on the sessionAllowlist', () => {
267
+ const result = checkCommandPermissions('goodCommand --safe', config, new Set(['goodCommand --safe']));
268
+ expect(result.allAllowed).toBe(true);
269
+ });
270
+ it('should block a command not on the sessionAllowlist or global allowlist', () => {
271
+ const result = checkCommandPermissions('badCommand --danger', config, new Set(['goodCommand --safe']));
272
+ expect(result.allAllowed).toBe(false);
273
+ expect(result.blockReason).toContain('not on the global or session allowlist');
274
+ expect(result.disallowedCommands).toEqual(['badCommand --danger']);
275
+ });
276
+ it('should allow a command on the global allowlist even if not on the session allowlist', () => {
277
+ config.getCoreTools = () => ['ShellTool(git status)'];
278
+ const result = checkCommandPermissions('git status', config, new Set(['goodCommand --safe']));
279
+ expect(result.allAllowed).toBe(true);
280
+ });
281
+ it('should allow a chained command if parts are on different allowlists', () => {
282
+ config.getCoreTools = () => ['ShellTool(git status)'];
283
+ const result = checkCommandPermissions('git status && git commit', config, new Set(['git commit']));
284
+ expect(result.allAllowed).toBe(true);
285
+ });
286
+ it('should block a command on the sessionAllowlist if it is also globally blocked', () => {
287
+ config.getExcludeTools = () => new Set(['run_shell_command(badCommand)']);
288
+ const result = checkCommandPermissions('badCommand --danger', config, new Set(['badCommand --danger']));
289
+ expect(result.allAllowed).toBe(false);
290
+ expect(result.blockReason).toContain('is blocked by configuration');
291
+ });
292
+ it('should block a chained command if one part is not on any allowlist', () => {
293
+ config.getCoreTools = () => ['run_shell_command(echo)'];
294
+ const result = checkCommandPermissions('echo "hello" && badCommand --danger', config, new Set(['echo']));
295
+ expect(result.allAllowed).toBe(false);
296
+ expect(result.disallowedCommands).toEqual(['badCommand --danger']);
297
+ });
298
+ });
299
+ });
300
+ describeWindowsOnly('PowerShell integration', () => {
301
+ const originalComSpec = process.env['ComSpec'];
302
+ beforeEach(() => {
303
+ mockPlatform.mockReturnValue('win32');
304
+ const systemRoot = process.env['SystemRoot'] || 'C:\\Windows';
305
+ process.env['ComSpec'] =
306
+ `${systemRoot}\\System32\\WindowsPowerShell\\v1.0\\powershell.exe`;
307
+ });
308
+ afterEach(() => {
309
+ if (originalComSpec === undefined) {
310
+ delete process.env['ComSpec'];
311
+ }
312
+ else {
313
+ process.env['ComSpec'] = originalComSpec;
314
+ }
315
+ });
316
+ it('should block commands when PowerShell parser reports errors', () => {
317
+ // Mock spawnSync to avoid the overhead of spawning a real PowerShell process,
318
+ // which can lead to timeouts in CI environments even on Windows.
319
+ mockSpawnSync.mockReturnValue({
320
+ status: 0,
321
+ stdout: JSON.stringify({ success: false }),
322
+ });
323
+ const { allowed, reason } = isCommandAllowed('Get-ChildItem |', config);
324
+ expect(allowed).toBe(false);
325
+ expect(reason).toBe('Command rejected because it could not be parsed safely');
326
+ });
327
+ it('should allow valid commands through PowerShell parser', () => {
328
+ // Mock spawnSync to avoid the overhead of spawning a real PowerShell process,
329
+ // which can lead to timeouts in CI environments even on Windows.
330
+ mockSpawnSync.mockReturnValue({
331
+ status: 0,
332
+ stdout: JSON.stringify({
333
+ success: true,
334
+ commands: [{ name: 'Get-ChildItem', text: 'Get-ChildItem' }],
335
+ }),
336
+ });
337
+ const { allowed } = isCommandAllowed('Get-ChildItem', config);
338
+ expect(allowed).toBe(true);
339
+ });
340
+ });
341
+ describe('isShellInvocationAllowlisted', () => {
342
+ function createInvocation(command) {
343
+ return { params: { command } };
344
+ }
345
+ it('should return false when any chained command segment is not allowlisted', () => {
346
+ const invocation = createInvocation('git status && rm -rf /tmp/should-not-run');
347
+ expect(isShellInvocationAllowlisted(invocation, ['run_shell_command(git)'])).toBe(false);
348
+ });
349
+ it('should return true when every segment is explicitly allowlisted', () => {
350
+ const invocation = createInvocation('git status && rm -rf /tmp/should-run && git diff');
351
+ expect(isShellInvocationAllowlisted(invocation, [
352
+ 'run_shell_command(git)',
353
+ 'run_shell_command(rm -rf)',
354
+ ])).toBe(true);
355
+ });
356
+ it('should return true when the allowlist contains a wildcard shell entry', () => {
357
+ const invocation = createInvocation('git status && rm -rf /tmp/should-run');
358
+ expect(isShellInvocationAllowlisted(invocation, ['run_shell_command'])).toBe(true);
359
+ });
360
+ it('should treat piped commands as separate segments that must be allowlisted', () => {
361
+ const invocation = createInvocation('git status | tail -n 1');
362
+ expect(isShellInvocationAllowlisted(invocation, ['run_shell_command(git)'])).toBe(false);
363
+ expect(isShellInvocationAllowlisted(invocation, [
364
+ 'run_shell_command(git)',
365
+ 'run_shell_command(tail)',
366
+ ])).toBe(true);
367
+ });
368
+ });
369
+ //# sourceMappingURL=shell-permissions.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"shell-permissions.test.js","sourceRoot":"","sources":["../../../src/utils/shell-permissions.test.ts"],"names":[],"mappings":"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"}
@@ -3,8 +3,6 @@
3
3
  * Copyright 2025 Google LLC
4
4
  * SPDX-License-Identifier: Apache-2.0
5
5
  */
6
- import type { AnyToolInvocation } from '../index.js';
7
- import type { Config } from '../config/config.js';
8
6
  import { type SpawnOptionsWithoutStdio } from 'node:child_process';
9
7
  export declare const SHELL_TOOL_NAMES: string[];
10
8
  /**
@@ -25,6 +23,16 @@ export interface ShellConfiguration {
25
23
  shell: ShellType;
26
24
  }
27
25
  export declare function initializeShellParsers(): Promise<void>;
26
+ export interface ParsedCommandDetail {
27
+ name: string;
28
+ text: string;
29
+ }
30
+ interface CommandParseResult {
31
+ details: ParsedCommandDetail[];
32
+ hasError: boolean;
33
+ hasRedirection?: boolean;
34
+ }
35
+ export declare function parseCommandDetails(command: string): CommandParseResult | null;
28
36
  /**
29
37
  * Determines the appropriate shell configuration for the current platform.
30
38
  *
@@ -53,6 +61,11 @@ export declare function escapeShellArg(arg: string, shell: ShellType): string;
53
61
  * @param command The shell command string to parse
54
62
  * @returns An array of individual command strings
55
63
  */
64
+ /**
65
+ * Checks if a command contains redirection operators.
66
+ * Uses shell-specific parsers where possible, falling back to a broad regex check.
67
+ */
68
+ export declare function hasRedirection(command: string): boolean;
56
69
  export declare function splitCommands(command: string): string[];
57
70
  /**
58
71
  * Extracts the root command from a given shell command string.
@@ -73,36 +86,6 @@ export declare function stripShellWrapper(command: string): string;
73
86
  * @param command The shell command string to check
74
87
  * @returns true if command substitution would be executed by bash
75
88
  */
76
- /**
77
- * Checks a shell command against security policies and allowlists.
78
- *
79
- * This function operates in one of two modes depending on the presence of
80
- * the `sessionAllowlist` parameter:
81
- *
82
- * 1. **"Default Deny" Mode (sessionAllowlist is provided):** This is the
83
- * strictest mode, used for user-defined scripts like custom commands.
84
- * A command is only permitted if it is found on the global `coreTools`
85
- * allowlist OR the provided `sessionAllowlist`. It must not be on the
86
- * global `excludeTools` blocklist.
87
- *
88
- * 2. **"Default Allow" Mode (sessionAllowlist is NOT provided):** This mode
89
- * is used for direct tool invocations (e.g., by the model). If a strict
90
- * global `coreTools` allowlist exists, commands must be on it. Otherwise,
91
- * any command is permitted as long as it is not on the `excludeTools`
92
- * blocklist.
93
- *
94
- * @param command The shell command string to validate.
95
- * @param config The application configuration.
96
- * @param sessionAllowlist A session-level list of approved commands. Its
97
- * presence activates "Default Deny" mode.
98
- * @returns An object detailing which commands are not allowed.
99
- */
100
- export declare function checkCommandPermissions(command: string, config: Config, sessionAllowlist?: Set<string>): {
101
- allAllowed: boolean;
102
- disallowedCommands: string[];
103
- blockReason?: string;
104
- isHardDenial?: boolean;
105
- };
106
89
  /**
107
90
  * Determines whether a given shell command is allowed to execute based on
108
91
  * the tool's configuration including allowlists and blocklists.
@@ -118,18 +101,4 @@ export declare const spawnAsync: (command: string, args: string[], options?: Spa
118
101
  stdout: string;
119
102
  stderr: string;
120
103
  }>;
121
- export declare function isCommandAllowed(command: string, config: Config): {
122
- allowed: boolean;
123
- reason?: string;
124
- };
125
- /**
126
- * Determines whether a shell invocation should be auto-approved based on an allowlist.
127
- *
128
- * This reuses the same parsing logic as command-permission enforcement so that
129
- * chained commands must be individually covered by the allowlist.
130
- *
131
- * @param invocation The shell tool invocation being evaluated.
132
- * @param allowedPatterns The configured allowlist patterns (e.g. `run_shell_command(git)`).
133
- * @returns True if every parsed command segment is allowed by the patterns; false otherwise.
134
- */
135
- export declare function isShellInvocationAllowlisted(invocation: AnyToolInvocation, allowedPatterns: string[]): boolean;
104
+ export {};