@office-ai/aioncli-core 0.18.7 → 0.24.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (890) 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 +91 -274
  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/prompts.js +82 -26
  299. package/dist/src/core/prompts.js.map +1 -1
  300. package/dist/src/core/prompts.test.js +102 -3
  301. package/dist/src/core/prompts.test.js.map +1 -1
  302. package/dist/src/core/sessionHookTriggers.d.ts +29 -0
  303. package/dist/src/core/sessionHookTriggers.js +75 -0
  304. package/dist/src/core/sessionHookTriggers.js.map +1 -0
  305. package/dist/src/core/turn.d.ts +34 -21
  306. package/dist/src/core/turn.js +33 -13
  307. package/dist/src/core/turn.js.map +1 -1
  308. package/dist/src/core/turn.test.js +0 -5
  309. package/dist/src/core/turn.test.js.map +1 -1
  310. package/dist/src/fallback/handler.js +101 -93
  311. package/dist/src/fallback/handler.js.map +1 -1
  312. package/dist/src/fallback/handler.test.js +186 -173
  313. package/dist/src/fallback/handler.test.js.map +1 -1
  314. package/dist/src/fallback/types.d.ts +8 -0
  315. package/dist/src/generated/git-commit.d.ts +3 -3
  316. package/dist/src/generated/git-commit.js +3 -3
  317. package/dist/src/generated/git-commit.js.map +1 -1
  318. package/dist/src/hooks/hookAggregator.js +7 -0
  319. package/dist/src/hooks/hookAggregator.js.map +1 -1
  320. package/dist/src/hooks/hookEventHandler.d.ts +113 -0
  321. package/dist/src/hooks/hookEventHandler.js +571 -0
  322. package/dist/src/hooks/hookEventHandler.js.map +1 -0
  323. package/dist/src/hooks/hookEventHandler.test.d.ts +6 -0
  324. package/dist/src/hooks/hookEventHandler.test.js +461 -0
  325. package/dist/src/hooks/hookEventHandler.test.js.map +1 -0
  326. package/dist/src/hooks/hookPlanner.d.ts +1 -5
  327. package/dist/src/hooks/hookPlanner.js +2 -7
  328. package/dist/src/hooks/hookPlanner.js.map +1 -1
  329. package/dist/src/hooks/hookPlanner.test.js +62 -2
  330. package/dist/src/hooks/hookPlanner.test.js.map +1 -1
  331. package/dist/src/hooks/hookRegistry.d.ts +6 -18
  332. package/dist/src/hooks/hookRegistry.js +49 -35
  333. package/dist/src/hooks/hookRegistry.js.map +1 -1
  334. package/dist/src/hooks/hookRegistry.test.js +167 -8
  335. package/dist/src/hooks/hookRegistry.test.js.map +1 -1
  336. package/dist/src/hooks/hookRunner.d.ts +5 -3
  337. package/dist/src/hooks/hookRunner.js +74 -18
  338. package/dist/src/hooks/hookRunner.js.map +1 -1
  339. package/dist/src/hooks/hookRunner.test.js +174 -36
  340. package/dist/src/hooks/hookRunner.test.js.map +1 -1
  341. package/dist/src/hooks/hookSystem.d.ts +40 -0
  342. package/dist/src/hooks/hookSystem.js +65 -0
  343. package/dist/src/hooks/hookSystem.js.map +1 -0
  344. package/dist/src/hooks/hookSystem.test.d.ts +6 -0
  345. package/dist/src/hooks/hookSystem.test.js +319 -0
  346. package/dist/src/hooks/hookSystem.test.js.map +1 -0
  347. package/dist/src/hooks/index.d.ts +17 -0
  348. package/dist/src/hooks/index.js +18 -0
  349. package/dist/src/hooks/index.js.map +1 -0
  350. package/dist/src/hooks/trustedHooks.d.ts +28 -0
  351. package/dist/src/hooks/trustedHooks.js +90 -0
  352. package/dist/src/hooks/trustedHooks.js.map +1 -0
  353. package/dist/src/hooks/trustedHooks.test.d.ts +6 -0
  354. package/dist/src/hooks/trustedHooks.test.js +154 -0
  355. package/dist/src/hooks/trustedHooks.test.js.map +1 -0
  356. package/dist/src/hooks/types.d.ts +21 -11
  357. package/dist/src/hooks/types.js +31 -27
  358. package/dist/src/hooks/types.js.map +1 -1
  359. package/dist/src/hooks/types.test.js +5 -24
  360. package/dist/src/hooks/types.test.js.map +1 -1
  361. package/dist/src/ide/detect-ide.test.js +32 -1
  362. package/dist/src/ide/detect-ide.test.js.map +1 -1
  363. package/dist/src/ide/ide-client.js +9 -4
  364. package/dist/src/ide/ide-client.js.map +1 -1
  365. package/dist/src/ide/ide-client.test.js +17 -0
  366. package/dist/src/ide/ide-client.test.js.map +1 -1
  367. package/dist/src/ide/ide-installer.test.js +1 -1
  368. package/dist/src/ide/ide-installer.test.js.map +1 -1
  369. package/dist/src/ide/types.d.ts +4 -4
  370. package/dist/src/index.d.ts +17 -1
  371. package/dist/src/index.js +18 -2
  372. package/dist/src/index.js.map +1 -1
  373. package/dist/src/mcp/auth-provider.d.ts +16 -0
  374. package/dist/src/mcp/auth-provider.js +7 -0
  375. package/dist/src/mcp/auth-provider.js.map +1 -0
  376. package/dist/src/mcp/google-auth-provider.d.ts +10 -2
  377. package/dist/src/mcp/google-auth-provider.js +28 -0
  378. package/dist/src/mcp/google-auth-provider.js.map +1 -1
  379. package/dist/src/mcp/google-auth-provider.test.js +45 -0
  380. package/dist/src/mcp/google-auth-provider.test.js.map +1 -1
  381. package/dist/src/mcp/oauth-provider.js +6 -2
  382. package/dist/src/mcp/oauth-provider.js.map +1 -1
  383. package/dist/src/mcp/oauth-provider.test.js +4 -1
  384. package/dist/src/mcp/oauth-provider.test.js.map +1 -1
  385. package/dist/src/mcp/oauth-utils.d.ts +8 -1
  386. package/dist/src/mcp/oauth-utils.js +31 -2
  387. package/dist/src/mcp/oauth-utils.js.map +1 -1
  388. package/dist/src/mcp/oauth-utils.test.js +42 -0
  389. package/dist/src/mcp/oauth-utils.test.js.map +1 -1
  390. package/dist/src/mcp/sa-impersonation-provider.d.ts +2 -2
  391. package/dist/src/mcp/sa-impersonation-provider.js.map +1 -1
  392. package/dist/src/mcp/token-storage/hybrid-token-storage.js +1 -1
  393. package/dist/src/mcp/token-storage/hybrid-token-storage.js.map +1 -1
  394. package/dist/src/mcp/token-storage/keychain-token-storage.js +1 -1
  395. package/dist/src/mcp/token-storage/keychain-token-storage.js.map +1 -1
  396. package/dist/src/output/json-formatter.d.ts +2 -2
  397. package/dist/src/output/json-formatter.js +6 -3
  398. package/dist/src/output/json-formatter.js.map +1 -1
  399. package/dist/src/output/json-formatter.test.js +37 -9
  400. package/dist/src/output/json-formatter.test.js.map +1 -1
  401. package/dist/src/output/stream-json-formatter.js +6 -0
  402. package/dist/src/output/stream-json-formatter.js.map +1 -1
  403. package/dist/src/output/stream-json-formatter.test.js +98 -100
  404. package/dist/src/output/stream-json-formatter.test.js.map +1 -1
  405. package/dist/src/output/types.d.ts +3 -0
  406. package/dist/src/output/types.js.map +1 -1
  407. package/dist/src/policy/config.js +140 -15
  408. package/dist/src/policy/config.js.map +1 -1
  409. package/dist/src/policy/config.test.js +21 -0
  410. package/dist/src/policy/config.test.js.map +1 -1
  411. package/dist/src/policy/persistence.test.d.ts +6 -0
  412. package/dist/src/policy/persistence.test.js +154 -0
  413. package/dist/src/policy/persistence.test.js.map +1 -0
  414. package/dist/src/policy/policies/agent.toml +31 -0
  415. package/dist/src/policy/policies/read-only.toml +5 -0
  416. package/dist/src/policy/policies/write.toml +5 -0
  417. package/dist/src/policy/policies/yolo.toml +1 -0
  418. package/dist/src/policy/policy-engine.d.ts +30 -1
  419. package/dist/src/policy/policy-engine.js +192 -5
  420. package/dist/src/policy/policy-engine.js.map +1 -1
  421. package/dist/src/policy/policy-engine.test.js +520 -3
  422. package/dist/src/policy/policy-engine.test.js.map +1 -1
  423. package/dist/src/policy/policy-updater.test.d.ts +6 -0
  424. package/dist/src/policy/policy-updater.test.js +116 -0
  425. package/dist/src/policy/policy-updater.test.js.map +1 -0
  426. package/dist/src/policy/shell-safety.test.d.ts +6 -0
  427. package/dist/src/policy/shell-safety.test.js +75 -0
  428. package/dist/src/policy/shell-safety.test.js.map +1 -0
  429. package/dist/src/policy/toml-loader.d.ts +3 -5
  430. package/dist/src/policy/toml-loader.js +12 -60
  431. package/dist/src/policy/toml-loader.js.map +1 -1
  432. package/dist/src/policy/toml-loader.test.js +38 -7
  433. package/dist/src/policy/toml-loader.test.js.map +1 -1
  434. package/dist/src/policy/types.d.ts +72 -1
  435. package/dist/src/policy/types.js +21 -0
  436. package/dist/src/policy/types.js.map +1 -1
  437. package/dist/src/policy/utils.d.ts +21 -0
  438. package/dist/src/policy/utils.js +42 -0
  439. package/dist/src/policy/utils.js.map +1 -0
  440. package/dist/src/policy/utils.test.d.ts +6 -0
  441. package/dist/src/policy/utils.test.js +64 -0
  442. package/dist/src/policy/utils.test.js.map +1 -0
  443. package/dist/src/resources/resource-registry.d.ts +30 -0
  444. package/dist/src/resources/resource-registry.js +57 -0
  445. package/dist/src/resources/resource-registry.js.map +1 -0
  446. package/dist/src/resources/resource-registry.test.d.ts +6 -0
  447. package/dist/src/resources/resource-registry.test.js +54 -0
  448. package/dist/src/resources/resource-registry.test.js.map +1 -0
  449. package/dist/src/routing/modelRouterService.js +0 -15
  450. package/dist/src/routing/modelRouterService.js.map +1 -1
  451. package/dist/src/routing/modelRouterService.test.js +0 -62
  452. package/dist/src/routing/modelRouterService.test.js.map +1 -1
  453. package/dist/src/routing/strategies/classifierStrategy.js +10 -21
  454. package/dist/src/routing/strategies/classifierStrategy.js.map +1 -1
  455. package/dist/src/routing/strategies/classifierStrategy.test.js +2 -1
  456. package/dist/src/routing/strategies/classifierStrategy.test.js.map +1 -1
  457. package/dist/src/routing/strategies/compositeStrategy.js +4 -2
  458. package/dist/src/routing/strategies/compositeStrategy.js.map +1 -1
  459. package/dist/src/routing/strategies/compositeStrategy.test.js +11 -10
  460. package/dist/src/routing/strategies/compositeStrategy.test.js.map +1 -1
  461. package/dist/src/routing/strategies/fallbackStrategy.js +20 -12
  462. package/dist/src/routing/strategies/fallbackStrategy.js.map +1 -1
  463. package/dist/src/routing/strategies/fallbackStrategy.test.js +63 -39
  464. package/dist/src/routing/strategies/fallbackStrategy.test.js.map +1 -1
  465. package/dist/src/routing/strategies/overrideStrategy.js +3 -2
  466. package/dist/src/routing/strategies/overrideStrategy.js.map +1 -1
  467. package/dist/src/safety/checker-runner.js +17 -6
  468. package/dist/src/safety/checker-runner.js.map +1 -1
  469. package/dist/src/scheduler/tool-executor.d.ts +22 -0
  470. package/dist/src/scheduler/tool-executor.js +198 -0
  471. package/dist/src/scheduler/tool-executor.js.map +1 -0
  472. package/dist/src/scheduler/tool-executor.test.d.ts +6 -0
  473. package/dist/src/scheduler/tool-executor.test.js +231 -0
  474. package/dist/src/scheduler/tool-executor.test.js.map +1 -0
  475. package/dist/src/scheduler/types.d.ts +95 -0
  476. package/dist/src/scheduler/types.js +7 -0
  477. package/dist/src/scheduler/types.js.map +1 -0
  478. package/dist/src/services/chatCompressionService.d.ts +1 -0
  479. package/dist/src/services/chatCompressionService.js +38 -8
  480. package/dist/src/services/chatCompressionService.js.map +1 -1
  481. package/dist/src/services/chatCompressionService.test.js +35 -31
  482. package/dist/src/services/chatCompressionService.test.js.map +1 -1
  483. package/dist/src/services/chatRecordingService.d.ts +14 -0
  484. package/dist/src/services/chatRecordingService.js +37 -0
  485. package/dist/src/services/chatRecordingService.js.map +1 -1
  486. package/dist/src/services/contextManager.d.ts +29 -0
  487. package/dist/src/services/contextManager.js +71 -0
  488. package/dist/src/services/contextManager.js.map +1 -0
  489. package/dist/src/services/contextManager.test.d.ts +6 -0
  490. package/dist/src/services/contextManager.test.js +104 -0
  491. package/dist/src/services/contextManager.test.js.map +1 -0
  492. package/dist/src/services/environmentSanitization.d.ts +15 -0
  493. package/dist/src/services/environmentSanitization.js +141 -0
  494. package/dist/src/services/environmentSanitization.js.map +1 -0
  495. package/dist/src/services/environmentSanitization.test.d.ts +6 -0
  496. package/dist/src/services/environmentSanitization.test.js +284 -0
  497. package/dist/src/services/environmentSanitization.test.js.map +1 -0
  498. package/dist/src/services/fileSystemService.d.ts +0 -9
  499. package/dist/src/services/fileSystemService.js +0 -11
  500. package/dist/src/services/fileSystemService.js.map +1 -1
  501. package/dist/src/services/gitService.js +18 -2
  502. package/dist/src/services/gitService.js.map +1 -1
  503. package/dist/src/services/gitService.test.js +56 -0
  504. package/dist/src/services/gitService.test.js.map +1 -1
  505. package/dist/src/services/loopDetectionService.js +5 -4
  506. package/dist/src/services/loopDetectionService.js.map +1 -1
  507. package/dist/src/services/loopDetectionService.test.js +14 -8
  508. package/dist/src/services/loopDetectionService.test.js.map +1 -1
  509. package/dist/src/services/modelConfig.golden.test.js +32 -0
  510. package/dist/src/services/modelConfig.golden.test.js.map +1 -1
  511. package/dist/src/services/modelConfig.integration.test.js +1 -1
  512. package/dist/src/services/modelConfig.integration.test.js.map +1 -1
  513. package/dist/src/services/modelConfigService.d.ts +4 -0
  514. package/dist/src/services/modelConfigService.js +8 -3
  515. package/dist/src/services/modelConfigService.js.map +1 -1
  516. package/dist/src/services/modelConfigService.test.js +221 -0
  517. package/dist/src/services/modelConfigService.test.js.map +1 -1
  518. package/dist/src/services/modelConfigServiceTestUtils.d.ts +10 -0
  519. package/dist/src/services/modelConfigServiceTestUtils.js +17 -0
  520. package/dist/src/services/modelConfigServiceTestUtils.js.map +1 -0
  521. package/dist/src/services/sessionSummaryService.d.ts +28 -0
  522. package/dist/src/services/sessionSummaryService.js +131 -0
  523. package/dist/src/services/sessionSummaryService.js.map +1 -0
  524. package/dist/src/services/sessionSummaryService.test.d.ts +6 -0
  525. package/dist/src/services/sessionSummaryService.test.js +785 -0
  526. package/dist/src/services/sessionSummaryService.test.js.map +1 -0
  527. package/dist/src/services/sessionSummaryUtils.d.ts +16 -0
  528. package/dist/src/services/sessionSummaryUtils.js +129 -0
  529. package/dist/src/services/sessionSummaryUtils.js.map +1 -0
  530. package/dist/src/services/sessionSummaryUtils.test.d.ts +6 -0
  531. package/dist/src/services/sessionSummaryUtils.test.js +137 -0
  532. package/dist/src/services/sessionSummaryUtils.test.js.map +1 -0
  533. package/dist/src/services/shellExecutionService.d.ts +4 -0
  534. package/dist/src/services/shellExecutionService.js +45 -27
  535. package/dist/src/services/shellExecutionService.js.map +1 -1
  536. package/dist/src/services/shellExecutionService.test.js +240 -8
  537. package/dist/src/services/shellExecutionService.test.js.map +1 -1
  538. package/dist/src/services/test-data/resolved-aliases-retry.golden.json +238 -0
  539. package/dist/src/services/test-data/resolved-aliases.golden.json +36 -0
  540. package/dist/src/skills/skillLoader.d.ts +28 -0
  541. package/dist/src/skills/skillLoader.js +77 -0
  542. package/dist/src/skills/skillLoader.js.map +1 -0
  543. package/dist/src/skills/skillLoader.test.d.ts +1 -0
  544. package/dist/src/skills/skillLoader.test.js +2 -0
  545. package/dist/src/skills/skillLoader.test.js.map +1 -0
  546. package/dist/src/skills/skillManager.d.ts +51 -0
  547. package/dist/src/skills/skillManager.js +89 -0
  548. package/dist/src/skills/skillManager.js.map +1 -0
  549. package/dist/src/skills/skillManager.test.d.ts +6 -0
  550. package/dist/src/skills/skillManager.test.js +128 -0
  551. package/dist/src/skills/skillManager.test.js.map +1 -0
  552. package/dist/src/telemetry/activity-detector.test.js.map +1 -1
  553. package/dist/src/telemetry/clearcut-logger/clearcut-logger.d.ts +11 -7
  554. package/dist/src/telemetry/clearcut-logger/clearcut-logger.js +127 -47
  555. package/dist/src/telemetry/clearcut-logger/clearcut-logger.js.map +1 -1
  556. package/dist/src/telemetry/clearcut-logger/clearcut-logger.test.js +105 -18
  557. package/dist/src/telemetry/clearcut-logger/clearcut-logger.test.js.map +1 -1
  558. package/dist/src/telemetry/clearcut-logger/event-metadata-key.d.ts +9 -3
  559. package/dist/src/telemetry/clearcut-logger/event-metadata-key.js +20 -5
  560. package/dist/src/telemetry/clearcut-logger/event-metadata-key.js.map +1 -1
  561. package/dist/src/telemetry/config.js +2 -0
  562. package/dist/src/telemetry/config.js.map +1 -1
  563. package/dist/src/telemetry/config.test.js +25 -0
  564. package/dist/src/telemetry/config.test.js.map +1 -1
  565. package/dist/src/telemetry/gcp-exporters.d.ts +4 -3
  566. package/dist/src/telemetry/gcp-exporters.js +8 -4
  567. package/dist/src/telemetry/gcp-exporters.js.map +1 -1
  568. package/dist/src/telemetry/index.d.ts +2 -1
  569. package/dist/src/telemetry/index.js +2 -1
  570. package/dist/src/telemetry/index.js.map +1 -1
  571. package/dist/src/telemetry/loggers.d.ts +5 -3
  572. package/dist/src/telemetry/loggers.js +353 -334
  573. package/dist/src/telemetry/loggers.js.map +1 -1
  574. package/dist/src/telemetry/loggers.test.circular.js +1 -0
  575. package/dist/src/telemetry/loggers.test.circular.js.map +1 -1
  576. package/dist/src/telemetry/loggers.test.js +238 -31
  577. package/dist/src/telemetry/loggers.test.js.map +1 -1
  578. package/dist/src/telemetry/metrics.d.ts +22 -0
  579. package/dist/src/telemetry/metrics.js +32 -0
  580. package/dist/src/telemetry/metrics.js.map +1 -1
  581. package/dist/src/telemetry/metrics.test.js +64 -0
  582. package/dist/src/telemetry/metrics.test.js.map +1 -1
  583. package/dist/src/telemetry/sanitize.d.ts +25 -0
  584. package/dist/src/telemetry/sanitize.js +48 -0
  585. package/dist/src/telemetry/sanitize.js.map +1 -0
  586. package/dist/src/telemetry/sanitize.test.d.ts +6 -0
  587. package/dist/src/telemetry/sanitize.test.js +279 -0
  588. package/dist/src/telemetry/sanitize.test.js.map +1 -0
  589. package/dist/src/telemetry/sdk.d.ts +9 -2
  590. package/dist/src/telemetry/sdk.js +142 -17
  591. package/dist/src/telemetry/sdk.js.map +1 -1
  592. package/dist/src/telemetry/sdk.test.js +130 -28
  593. package/dist/src/telemetry/sdk.test.js.map +1 -1
  594. package/dist/src/telemetry/semantic.js +1 -1
  595. package/dist/src/telemetry/semantic.js.map +1 -1
  596. package/dist/src/telemetry/startupProfiler.d.ts +51 -0
  597. package/dist/src/telemetry/startupProfiler.js +170 -0
  598. package/dist/src/telemetry/startupProfiler.js.map +1 -0
  599. package/dist/src/telemetry/startupProfiler.test.d.ts +6 -0
  600. package/dist/src/telemetry/startupProfiler.test.js +285 -0
  601. package/dist/src/telemetry/startupProfiler.test.js.map +1 -0
  602. package/dist/src/telemetry/telemetry.test.js +10 -3
  603. package/dist/src/telemetry/telemetry.test.js.map +1 -1
  604. package/dist/src/telemetry/trace.js +2 -2
  605. package/dist/src/telemetry/trace.js.map +1 -1
  606. package/dist/src/telemetry/types.d.ts +62 -16
  607. package/dist/src/telemetry/types.js +157 -27
  608. package/dist/src/telemetry/types.js.map +1 -1
  609. package/dist/src/telemetry/uiTelemetry.d.ts +1 -0
  610. package/dist/src/telemetry/uiTelemetry.js +2 -0
  611. package/dist/src/telemetry/uiTelemetry.js.map +1 -1
  612. package/dist/src/telemetry/uiTelemetry.test.js +4 -0
  613. package/dist/src/telemetry/uiTelemetry.test.js.map +1 -1
  614. package/dist/src/test-utils/mock-message-bus.d.ts +61 -0
  615. package/dist/src/test-utils/mock-message-bus.js +160 -0
  616. package/dist/src/test-utils/mock-message-bus.js.map +1 -0
  617. package/dist/src/test-utils/mock-tool.d.ts +5 -3
  618. package/dist/src/test-utils/mock-tool.js +12 -11
  619. package/dist/src/test-utils/mock-tool.js.map +1 -1
  620. package/dist/src/tools/activate-skill.d.ts +27 -0
  621. package/dist/src/tools/activate-skill.js +120 -0
  622. package/dist/src/tools/activate-skill.js.map +1 -0
  623. package/dist/src/tools/activate-skill.test.d.ts +6 -0
  624. package/dist/src/tools/activate-skill.test.js +95 -0
  625. package/dist/src/tools/activate-skill.test.js.map +1 -0
  626. package/dist/src/tools/confirmation-policy.test.d.ts +6 -0
  627. package/dist/src/tools/confirmation-policy.test.js +142 -0
  628. package/dist/src/tools/confirmation-policy.test.js.map +1 -0
  629. package/dist/src/tools/edit.d.ts +27 -5
  630. package/dist/src/tools/edit.js +449 -137
  631. package/dist/src/tools/edit.js.map +1 -1
  632. package/dist/src/tools/edit.test.js +258 -526
  633. package/dist/src/tools/edit.test.js.map +1 -1
  634. package/dist/src/tools/get-internal-docs.d.ts +27 -0
  635. package/dist/src/tools/get-internal-docs.js +129 -0
  636. package/dist/src/tools/get-internal-docs.js.map +1 -0
  637. package/dist/src/tools/get-internal-docs.test.d.ts +6 -0
  638. package/dist/src/tools/get-internal-docs.test.js +57 -0
  639. package/dist/src/tools/get-internal-docs.test.js.map +1 -0
  640. package/dist/src/tools/glob.d.ts +2 -2
  641. package/dist/src/tools/glob.js +1 -1
  642. package/dist/src/tools/glob.js.map +1 -1
  643. package/dist/src/tools/glob.test.js +2 -1
  644. package/dist/src/tools/glob.test.js.map +1 -1
  645. package/dist/src/tools/grep.d.ts +2 -2
  646. package/dist/src/tools/grep.js +1 -1
  647. package/dist/src/tools/grep.js.map +1 -1
  648. package/dist/src/tools/grep.test.js +5 -4
  649. package/dist/src/tools/grep.test.js.map +1 -1
  650. package/dist/src/tools/ls.d.ts +2 -2
  651. package/dist/src/tools/ls.js +2 -2
  652. package/dist/src/tools/ls.js.map +1 -1
  653. package/dist/src/tools/ls.test.js +2 -1
  654. package/dist/src/tools/ls.test.js.map +1 -1
  655. package/dist/src/tools/mcp-client-manager.d.ts +3 -1
  656. package/dist/src/tools/mcp-client-manager.js +42 -9
  657. package/dist/src/tools/mcp-client-manager.js.map +1 -1
  658. package/dist/src/tools/mcp-client-manager.test.js +66 -10
  659. package/dist/src/tools/mcp-client-manager.test.js.map +1 -1
  660. package/dist/src/tools/mcp-client.d.ts +44 -6
  661. package/dist/src/tools/mcp-client.js +476 -176
  662. package/dist/src/tools/mcp-client.js.map +1 -1
  663. package/dist/src/tools/mcp-client.test.js +633 -36
  664. package/dist/src/tools/mcp-client.test.js.map +1 -1
  665. package/dist/src/tools/mcp-tool.d.ts +2 -2
  666. package/dist/src/tools/mcp-tool.js +20 -7
  667. package/dist/src/tools/mcp-tool.js.map +1 -1
  668. package/dist/src/tools/mcp-tool.test.js +35 -5
  669. package/dist/src/tools/mcp-tool.test.js.map +1 -1
  670. package/dist/src/tools/memoryTool.d.ts +3 -3
  671. package/dist/src/tools/memoryTool.js +3 -4
  672. package/dist/src/tools/memoryTool.js.map +1 -1
  673. package/dist/src/tools/memoryTool.test.js +5 -2
  674. package/dist/src/tools/memoryTool.test.js.map +1 -1
  675. package/dist/src/tools/message-bus-integration.test.js +10 -37
  676. package/dist/src/tools/message-bus-integration.test.js.map +1 -1
  677. package/dist/src/tools/modifiable-tool.js.map +1 -1
  678. package/dist/src/tools/modifiable-tool.test.js +22 -13
  679. package/dist/src/tools/modifiable-tool.test.js.map +1 -1
  680. package/dist/src/tools/read-file.d.ts +2 -2
  681. package/dist/src/tools/read-file.js +2 -2
  682. package/dist/src/tools/read-file.js.map +1 -1
  683. package/dist/src/tools/read-file.test.js +3 -2
  684. package/dist/src/tools/read-file.test.js.map +1 -1
  685. package/dist/src/tools/read-many-files.d.ts +2 -2
  686. package/dist/src/tools/read-many-files.js +7 -6
  687. package/dist/src/tools/read-many-files.js.map +1 -1
  688. package/dist/src/tools/read-many-files.test.js +4 -3
  689. package/dist/src/tools/read-many-files.test.js.map +1 -1
  690. package/dist/src/tools/ripGrep.d.ts +3 -2
  691. package/dist/src/tools/ripGrep.js +18 -7
  692. package/dist/src/tools/ripGrep.js.map +1 -1
  693. package/dist/src/tools/ripGrep.test.js +60 -4
  694. package/dist/src/tools/ripGrep.test.js.map +1 -1
  695. package/dist/src/tools/shell.d.ts +5 -7
  696. package/dist/src/tools/shell.js +77 -51
  697. package/dist/src/tools/shell.js.map +1 -1
  698. package/dist/src/tools/shell.test.js +59 -63
  699. package/dist/src/tools/shell.test.js.map +1 -1
  700. package/dist/src/tools/tool-error.d.ts +2 -1
  701. package/dist/src/tools/tool-error.js +2 -0
  702. package/dist/src/tools/tool-error.js.map +1 -1
  703. package/dist/src/tools/tool-names.d.ts +17 -0
  704. package/dist/src/tools/tool-names.js +59 -0
  705. package/dist/src/tools/tool-names.js.map +1 -1
  706. package/dist/src/tools/tool-names.test.d.ts +6 -0
  707. package/dist/src/tools/tool-names.test.js +43 -0
  708. package/dist/src/tools/tool-names.test.js.map +1 -0
  709. package/dist/src/tools/tool-registry.d.ts +11 -7
  710. package/dist/src/tools/tool-registry.js +15 -10
  711. package/dist/src/tools/tool-registry.js.map +1 -1
  712. package/dist/src/tools/tool-registry.test.js +16 -11
  713. package/dist/src/tools/tool-registry.test.js.map +1 -1
  714. package/dist/src/tools/tools.d.ts +25 -6
  715. package/dist/src/tools/tools.js +44 -25
  716. package/dist/src/tools/tools.js.map +1 -1
  717. package/dist/src/tools/tools.test.js +3 -1
  718. package/dist/src/tools/tools.test.js.map +1 -1
  719. package/dist/src/tools/web-fetch.d.ts +2 -2
  720. package/dist/src/tools/web-fetch.js +22 -9
  721. package/dist/src/tools/web-fetch.js.map +1 -1
  722. package/dist/src/tools/web-fetch.test.js +18 -19
  723. package/dist/src/tools/web-fetch.test.js.map +1 -1
  724. package/dist/src/tools/web-search.d.ts +2 -2
  725. package/dist/src/tools/web-search.js +5 -5
  726. package/dist/src/tools/web-search.js.map +1 -1
  727. package/dist/src/tools/web-search.test.js +2 -1
  728. package/dist/src/tools/web-search.test.js.map +1 -1
  729. package/dist/src/tools/write-file.d.ts +2 -2
  730. package/dist/src/tools/write-file.js +10 -4
  731. package/dist/src/tools/write-file.js.map +1 -1
  732. package/dist/src/tools/write-file.test.js +4 -1
  733. package/dist/src/tools/write-file.test.js.map +1 -1
  734. package/dist/src/tools/write-todos.d.ts +2 -2
  735. package/dist/src/tools/write-todos.js +5 -4
  736. package/dist/src/tools/write-todos.js.map +1 -1
  737. package/dist/src/tools/write-todos.test.js +2 -1
  738. package/dist/src/tools/write-todos.test.js.map +1 -1
  739. package/dist/src/utils/bfsFileSearch.d.ts +8 -0
  740. package/dist/src/utils/bfsFileSearch.js +63 -23
  741. package/dist/src/utils/bfsFileSearch.js.map +1 -1
  742. package/dist/src/utils/bfsFileSearch.test.js +65 -1
  743. package/dist/src/utils/bfsFileSearch.test.js.map +1 -1
  744. package/dist/src/utils/checkpointUtils.d.ts +82 -0
  745. package/dist/src/utils/checkpointUtils.js +117 -0
  746. package/dist/src/utils/checkpointUtils.js.map +1 -0
  747. package/dist/src/utils/checkpointUtils.test.d.ts +6 -0
  748. package/dist/src/utils/checkpointUtils.test.js +229 -0
  749. package/dist/src/utils/checkpointUtils.test.js.map +1 -0
  750. package/dist/src/utils/customHeaderUtils.d.ts +9 -0
  751. package/dist/src/utils/customHeaderUtils.js +34 -0
  752. package/dist/src/utils/customHeaderUtils.js.map +1 -0
  753. package/dist/src/utils/customHeaderUtils.test.d.ts +6 -0
  754. package/dist/src/utils/customHeaderUtils.test.js +77 -0
  755. package/dist/src/utils/customHeaderUtils.test.js.map +1 -0
  756. package/dist/src/utils/debugLogger.d.ts +3 -0
  757. package/dist/src/utils/debugLogger.js +28 -0
  758. package/dist/src/utils/debugLogger.js.map +1 -1
  759. package/dist/src/utils/editCorrector.js +6 -5
  760. package/dist/src/utils/editCorrector.js.map +1 -1
  761. package/dist/src/utils/editCorrector.test.js +7 -3
  762. package/dist/src/utils/editCorrector.test.js.map +1 -1
  763. package/dist/src/utils/editor.d.ts +9 -1
  764. package/dist/src/utils/editor.js +23 -14
  765. package/dist/src/utils/editor.js.map +1 -1
  766. package/dist/src/utils/environmentContext.d.ts +1 -0
  767. package/dist/src/utils/environmentContext.js +4 -0
  768. package/dist/src/utils/environmentContext.js.map +1 -1
  769. package/dist/src/utils/environmentContext.test.js +2 -0
  770. package/dist/src/utils/environmentContext.test.js.map +1 -1
  771. package/dist/src/utils/errorReporting.d.ts +1 -1
  772. package/dist/src/utils/errorReporting.js +13 -12
  773. package/dist/src/utils/errorReporting.js.map +1 -1
  774. package/dist/src/utils/errorReporting.test.js +17 -14
  775. package/dist/src/utils/errorReporting.test.js.map +1 -1
  776. package/dist/src/utils/errors.d.ts +8 -0
  777. package/dist/src/utils/errors.js +39 -2
  778. package/dist/src/utils/errors.js.map +1 -1
  779. package/dist/src/utils/errors.test.d.ts +6 -0
  780. package/dist/src/utils/errors.test.js +155 -0
  781. package/dist/src/utils/errors.test.js.map +1 -0
  782. package/dist/src/utils/events.d.ts +49 -19
  783. package/dist/src/utils/events.js +21 -9
  784. package/dist/src/utils/events.js.map +1 -1
  785. package/dist/src/utils/events.test.js +25 -0
  786. package/dist/src/utils/events.test.js.map +1 -1
  787. package/dist/src/utils/exitCodes.d.ts +12 -0
  788. package/dist/src/utils/exitCodes.js +13 -0
  789. package/dist/src/utils/exitCodes.js.map +1 -0
  790. package/dist/src/utils/extensionLoader.d.ts +2 -2
  791. package/dist/src/utils/extensionLoader.js +5 -6
  792. package/dist/src/utils/extensionLoader.js.map +1 -1
  793. package/dist/src/utils/extensionLoader.test.js +11 -0
  794. package/dist/src/utils/extensionLoader.test.js.map +1 -1
  795. package/dist/src/utils/fetch.d.ts +1 -1
  796. package/dist/src/utils/fetch.js +3 -3
  797. package/dist/src/utils/fetch.js.map +1 -1
  798. package/dist/src/utils/fileUtils.d.ts +4 -0
  799. package/dist/src/utils/fileUtils.js +53 -0
  800. package/dist/src/utils/fileUtils.js.map +1 -1
  801. package/dist/src/utils/fileUtils.test.js +127 -1
  802. package/dist/src/utils/fileUtils.test.js.map +1 -1
  803. package/dist/src/utils/filesearch/crawlCache.js.map +1 -1
  804. package/dist/src/utils/filesearch/fileSearch.js.map +1 -1
  805. package/dist/src/utils/flashFallback.test.js +1 -1
  806. package/dist/src/utils/flashFallback.test.js.map +1 -1
  807. package/dist/src/utils/geminiIgnoreParser.d.ts +11 -0
  808. package/dist/src/utils/geminiIgnoreParser.js +20 -0
  809. package/dist/src/utils/geminiIgnoreParser.js.map +1 -1
  810. package/dist/src/utils/geminiIgnoreParser.test.js +48 -0
  811. package/dist/src/utils/geminiIgnoreParser.test.js.map +1 -1
  812. package/dist/src/utils/generateContentResponseUtilities.d.ts +3 -1
  813. package/dist/src/utils/generateContentResponseUtilities.js +106 -0
  814. package/dist/src/utils/generateContentResponseUtilities.js.map +1 -1
  815. package/dist/src/utils/generateContentResponseUtilities.test.js +279 -2
  816. package/dist/src/utils/generateContentResponseUtilities.test.js.map +1 -1
  817. package/dist/src/utils/getFolderStructure.js +7 -2
  818. package/dist/src/utils/getFolderStructure.js.map +1 -1
  819. package/dist/src/utils/googleErrors.js +31 -18
  820. package/dist/src/utils/googleErrors.js.map +1 -1
  821. package/dist/src/utils/googleErrors.test.js +10 -2
  822. package/dist/src/utils/googleErrors.test.js.map +1 -1
  823. package/dist/src/utils/googleQuotaErrors.d.ts +3 -3
  824. package/dist/src/utils/googleQuotaErrors.js +32 -6
  825. package/dist/src/utils/googleQuotaErrors.js.map +1 -1
  826. package/dist/src/utils/googleQuotaErrors.test.js +94 -2
  827. package/dist/src/utils/googleQuotaErrors.test.js.map +1 -1
  828. package/dist/src/utils/memoryDiscovery.d.ts +5 -0
  829. package/dist/src/utils/memoryDiscovery.js +9 -5
  830. package/dist/src/utils/memoryDiscovery.js.map +1 -1
  831. package/dist/src/utils/memoryDiscovery.test.js +31 -1
  832. package/dist/src/utils/memoryDiscovery.test.js.map +1 -1
  833. package/dist/src/utils/nextSpeakerChecker.test.js +4 -0
  834. package/dist/src/utils/nextSpeakerChecker.test.js.map +1 -1
  835. package/dist/src/utils/package.d.ts +14 -0
  836. package/dist/src/utils/package.js +15 -2
  837. package/dist/src/utils/package.js.map +1 -1
  838. package/dist/src/utils/pathCorrector.js +12 -2
  839. package/dist/src/utils/pathCorrector.js.map +1 -1
  840. package/dist/src/utils/pathCorrector.test.js +6 -2
  841. package/dist/src/utils/pathCorrector.test.js.map +1 -1
  842. package/dist/src/utils/retry.d.ts +11 -0
  843. package/dist/src/utils/retry.js +62 -21
  844. package/dist/src/utils/retry.js.map +1 -1
  845. package/dist/src/utils/retry.test.js +170 -10
  846. package/dist/src/utils/retry.test.js.map +1 -1
  847. package/dist/src/utils/schemaValidator.d.ts +1 -1
  848. package/dist/src/utils/schemaValidator.js +1 -1
  849. package/dist/src/utils/shell-permissions.d.ts +52 -0
  850. package/dist/src/utils/shell-permissions.js +188 -0
  851. package/dist/src/utils/shell-permissions.js.map +1 -0
  852. package/dist/src/utils/shell-permissions.test.d.ts +6 -0
  853. package/dist/src/utils/shell-permissions.test.js +369 -0
  854. package/dist/src/utils/shell-permissions.test.js.map +1 -0
  855. package/dist/src/utils/shell-utils.d.ts +16 -47
  856. package/dist/src/utils/shell-utils.js +99 -195
  857. package/dist/src/utils/shell-utils.js.map +1 -1
  858. package/dist/src/utils/shell-utils.test.js +99 -288
  859. package/dist/src/utils/shell-utils.test.js.map +1 -1
  860. package/dist/src/utils/stdio.d.ts +2 -2
  861. package/dist/src/utils/stdio.js +2 -2
  862. package/dist/src/utils/stdio.js.map +1 -1
  863. package/dist/src/utils/stdio.test.js +5 -5
  864. package/dist/src/utils/stdio.test.js.map +1 -1
  865. package/dist/src/utils/summarizer.test.js +3 -2
  866. package/dist/src/utils/summarizer.test.js.map +1 -1
  867. package/dist/src/utils/terminal.d.ts +4 -0
  868. package/dist/src/utils/terminal.js +12 -0
  869. package/dist/src/utils/terminal.js.map +1 -1
  870. package/dist/src/utils/terminalSerializer.test.js +17 -0
  871. package/dist/src/utils/terminalSerializer.test.js.map +1 -1
  872. package/dist/src/utils/tokenCalculation.d.ts +19 -0
  873. package/dist/src/utils/tokenCalculation.js +85 -0
  874. package/dist/src/utils/tokenCalculation.js.map +1 -0
  875. package/dist/src/utils/tokenCalculation.test.d.ts +6 -0
  876. package/dist/src/utils/tokenCalculation.test.js +87 -0
  877. package/dist/src/utils/tokenCalculation.test.js.map +1 -0
  878. package/dist/src/utils/tool-utils.d.ts +9 -0
  879. package/dist/src/utils/tool-utils.js +29 -0
  880. package/dist/src/utils/tool-utils.js.map +1 -1
  881. package/dist/src/utils/tool-utils.test.js +17 -2
  882. package/dist/src/utils/tool-utils.test.js.map +1 -1
  883. package/dist/src/utils/version.d.ts +6 -0
  884. package/dist/src/utils/version.js +15 -0
  885. package/dist/src/utils/version.js.map +1 -0
  886. package/dist/src/utils/version.test.d.ts +6 -0
  887. package/dist/src/utils/version.test.js +39 -0
  888. package/dist/src/utils/version.test.js.map +1 -0
  889. package/dist/tsconfig.tsbuildinfo +1 -1
  890. package/package.json +8 -7
@@ -0,0 +1,785 @@
1
+ /**
2
+ * @license
3
+ * Copyright 2025 Google LLC
4
+ * SPDX-License-Identifier: Apache-2.0
5
+ */
6
+ import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
7
+ import { SessionSummaryService } from './sessionSummaryService.js';
8
+ describe('SessionSummaryService', () => {
9
+ let service;
10
+ let mockBaseLlmClient;
11
+ let mockGenerateContent;
12
+ beforeEach(() => {
13
+ vi.clearAllMocks();
14
+ vi.useFakeTimers();
15
+ // Setup mock BaseLlmClient with generateContent
16
+ mockGenerateContent = vi.fn().mockResolvedValue({
17
+ candidates: [
18
+ {
19
+ content: {
20
+ parts: [{ text: 'Add dark mode to the app' }],
21
+ },
22
+ },
23
+ ],
24
+ });
25
+ mockBaseLlmClient = {
26
+ generateContent: mockGenerateContent,
27
+ };
28
+ service = new SessionSummaryService(mockBaseLlmClient);
29
+ });
30
+ afterEach(() => {
31
+ vi.useRealTimers();
32
+ vi.restoreAllMocks();
33
+ });
34
+ describe('Basic Functionality', () => {
35
+ it('should generate summary for valid conversation', async () => {
36
+ const messages = [
37
+ {
38
+ id: '1',
39
+ timestamp: '2025-12-03T00:00:00Z',
40
+ type: 'user',
41
+ content: [{ text: 'How do I add dark mode to my app?' }],
42
+ },
43
+ {
44
+ id: '2',
45
+ timestamp: '2025-12-03T00:01:00Z',
46
+ type: 'gemini',
47
+ content: [
48
+ {
49
+ text: 'To add dark mode, you need to create a theme provider and toggle state...',
50
+ },
51
+ ],
52
+ },
53
+ ];
54
+ const summary = await service.generateSummary({ messages });
55
+ expect(summary).toBe('Add dark mode to the app');
56
+ expect(mockGenerateContent).toHaveBeenCalledTimes(1);
57
+ expect(mockGenerateContent).toHaveBeenCalledWith(expect.objectContaining({
58
+ modelConfigKey: { model: 'summarizer-default' },
59
+ contents: expect.arrayContaining([
60
+ expect.objectContaining({
61
+ role: 'user',
62
+ parts: expect.arrayContaining([
63
+ expect.objectContaining({
64
+ text: expect.stringContaining('User: How do I add dark mode'),
65
+ }),
66
+ ]),
67
+ }),
68
+ ]),
69
+ promptId: 'session-summary-generation',
70
+ }));
71
+ });
72
+ it('should return null for empty messages array', async () => {
73
+ const summary = await service.generateSummary({ messages: [] });
74
+ expect(summary).toBeNull();
75
+ expect(mockGenerateContent).not.toHaveBeenCalled();
76
+ });
77
+ it('should return null when all messages have empty content', async () => {
78
+ const messages = [
79
+ {
80
+ id: '1',
81
+ timestamp: '2025-12-03T00:00:00Z',
82
+ type: 'user',
83
+ content: [{ text: ' ' }],
84
+ },
85
+ {
86
+ id: '2',
87
+ timestamp: '2025-12-03T00:01:00Z',
88
+ type: 'gemini',
89
+ content: [{ text: '' }],
90
+ },
91
+ ];
92
+ const summary = await service.generateSummary({ messages });
93
+ expect(summary).toBeNull();
94
+ expect(mockGenerateContent).not.toHaveBeenCalled();
95
+ });
96
+ it('should handle maxMessages limit correctly', async () => {
97
+ const messages = Array.from({ length: 30 }, (_, i) => ({
98
+ id: `${i}`,
99
+ timestamp: '2025-12-03T00:00:00Z',
100
+ type: i % 2 === 0 ? 'user' : 'gemini',
101
+ content: [{ text: `Message ${i}` }],
102
+ }));
103
+ await service.generateSummary({ messages, maxMessages: 10 });
104
+ expect(mockGenerateContent).toHaveBeenCalledTimes(1);
105
+ const callArgs = mockGenerateContent.mock.calls[0][0];
106
+ const promptText = callArgs.contents[0].parts[0].text;
107
+ // Count how many messages appear in the prompt (should be 10)
108
+ const messageCount = (promptText.match(/Message \d+/g) || []).length;
109
+ expect(messageCount).toBe(10);
110
+ });
111
+ });
112
+ describe('Message Type Filtering', () => {
113
+ it('should include only user and gemini messages', async () => {
114
+ const messages = [
115
+ {
116
+ id: '1',
117
+ timestamp: '2025-12-03T00:00:00Z',
118
+ type: 'user',
119
+ content: [{ text: 'User message' }],
120
+ },
121
+ {
122
+ id: '2',
123
+ timestamp: '2025-12-03T00:01:00Z',
124
+ type: 'gemini',
125
+ content: [{ text: 'Gemini response' }],
126
+ },
127
+ ];
128
+ await service.generateSummary({ messages });
129
+ expect(mockGenerateContent).toHaveBeenCalledTimes(1);
130
+ const callArgs = mockGenerateContent.mock.calls[0][0];
131
+ const promptText = callArgs.contents[0].parts[0].text;
132
+ expect(promptText).toContain('User: User message');
133
+ expect(promptText).toContain('Assistant: Gemini response');
134
+ });
135
+ it('should exclude info messages', async () => {
136
+ const messages = [
137
+ {
138
+ id: '1',
139
+ timestamp: '2025-12-03T00:00:00Z',
140
+ type: 'user',
141
+ content: [{ text: 'User message' }],
142
+ },
143
+ {
144
+ id: '2',
145
+ timestamp: '2025-12-03T00:01:00Z',
146
+ type: 'info',
147
+ content: [{ text: 'Info message should be excluded' }],
148
+ },
149
+ {
150
+ id: '3',
151
+ timestamp: '2025-12-03T00:02:00Z',
152
+ type: 'gemini',
153
+ content: [{ text: 'Gemini response' }],
154
+ },
155
+ ];
156
+ await service.generateSummary({ messages });
157
+ expect(mockGenerateContent).toHaveBeenCalledTimes(1);
158
+ const callArgs = mockGenerateContent.mock.calls[0][0];
159
+ const promptText = callArgs.contents[0].parts[0].text;
160
+ expect(promptText).toContain('User: User message');
161
+ expect(promptText).toContain('Assistant: Gemini response');
162
+ expect(promptText).not.toContain('Info message');
163
+ });
164
+ it('should exclude error messages', async () => {
165
+ const messages = [
166
+ {
167
+ id: '1',
168
+ timestamp: '2025-12-03T00:00:00Z',
169
+ type: 'user',
170
+ content: [{ text: 'User message' }],
171
+ },
172
+ {
173
+ id: '2',
174
+ timestamp: '2025-12-03T00:01:00Z',
175
+ type: 'error',
176
+ content: [{ text: 'Error: something went wrong' }],
177
+ },
178
+ {
179
+ id: '3',
180
+ timestamp: '2025-12-03T00:02:00Z',
181
+ type: 'gemini',
182
+ content: [{ text: 'Gemini response' }],
183
+ },
184
+ ];
185
+ await service.generateSummary({ messages });
186
+ expect(mockGenerateContent).toHaveBeenCalledTimes(1);
187
+ const callArgs = mockGenerateContent.mock.calls[0][0];
188
+ const promptText = callArgs.contents[0].parts[0].text;
189
+ expect(promptText).not.toContain('Error: something went wrong');
190
+ });
191
+ it('should exclude warning messages', async () => {
192
+ const messages = [
193
+ {
194
+ id: '1',
195
+ timestamp: '2025-12-03T00:00:00Z',
196
+ type: 'user',
197
+ content: [{ text: 'User message' }],
198
+ },
199
+ {
200
+ id: '2',
201
+ timestamp: '2025-12-03T00:01:00Z',
202
+ type: 'warning',
203
+ content: [{ text: 'Warning: deprecated API' }],
204
+ },
205
+ {
206
+ id: '3',
207
+ timestamp: '2025-12-03T00:02:00Z',
208
+ type: 'gemini',
209
+ content: [{ text: 'Gemini response' }],
210
+ },
211
+ ];
212
+ await service.generateSummary({ messages });
213
+ expect(mockGenerateContent).toHaveBeenCalledTimes(1);
214
+ const callArgs = mockGenerateContent.mock.calls[0][0];
215
+ const promptText = callArgs.contents[0].parts[0].text;
216
+ expect(promptText).not.toContain('Warning: deprecated API');
217
+ });
218
+ it('should handle mixed message types correctly', async () => {
219
+ const messages = [
220
+ {
221
+ id: '1',
222
+ timestamp: '2025-12-03T00:00:00Z',
223
+ type: 'info',
224
+ content: [{ text: 'System info' }],
225
+ },
226
+ {
227
+ id: '2',
228
+ timestamp: '2025-12-03T00:01:00Z',
229
+ type: 'user',
230
+ content: [{ text: 'User question' }],
231
+ },
232
+ {
233
+ id: '3',
234
+ timestamp: '2025-12-03T00:02:00Z',
235
+ type: 'error',
236
+ content: [{ text: 'Error occurred' }],
237
+ },
238
+ {
239
+ id: '4',
240
+ timestamp: '2025-12-03T00:03:00Z',
241
+ type: 'gemini',
242
+ content: [{ text: 'Gemini answer' }],
243
+ },
244
+ {
245
+ id: '5',
246
+ timestamp: '2025-12-03T00:04:00Z',
247
+ type: 'warning',
248
+ content: [{ text: 'Warning message' }],
249
+ },
250
+ ];
251
+ await service.generateSummary({ messages });
252
+ expect(mockGenerateContent).toHaveBeenCalledTimes(1);
253
+ const callArgs = mockGenerateContent.mock.calls[0][0];
254
+ const promptText = callArgs.contents[0].parts[0].text;
255
+ expect(promptText).toContain('User: User question');
256
+ expect(promptText).toContain('Assistant: Gemini answer');
257
+ expect(promptText).not.toContain('System info');
258
+ expect(promptText).not.toContain('Error occurred');
259
+ expect(promptText).not.toContain('Warning message');
260
+ });
261
+ it('should return null when only system messages present', async () => {
262
+ const messages = [
263
+ {
264
+ id: '1',
265
+ timestamp: '2025-12-03T00:00:00Z',
266
+ type: 'info',
267
+ content: [{ text: 'Info message' }],
268
+ },
269
+ {
270
+ id: '2',
271
+ timestamp: '2025-12-03T00:01:00Z',
272
+ type: 'error',
273
+ content: [{ text: 'Error message' }],
274
+ },
275
+ {
276
+ id: '3',
277
+ timestamp: '2025-12-03T00:02:00Z',
278
+ type: 'warning',
279
+ content: [{ text: 'Warning message' }],
280
+ },
281
+ ];
282
+ const summary = await service.generateSummary({ messages });
283
+ expect(summary).toBeNull();
284
+ expect(mockGenerateContent).not.toHaveBeenCalled();
285
+ });
286
+ });
287
+ describe('Timeout and Abort Handling', () => {
288
+ it('should timeout after specified duration', async () => {
289
+ // Mock implementation that respects abort signal
290
+ mockGenerateContent.mockImplementation(({ abortSignal }) => new Promise((resolve, reject) => {
291
+ const timeoutId = setTimeout(() => resolve({
292
+ candidates: [{ content: { parts: [{ text: 'Summary' }] } }],
293
+ }), 10000);
294
+ abortSignal?.addEventListener('abort', () => {
295
+ clearTimeout(timeoutId);
296
+ const abortError = new Error('This operation was aborted');
297
+ abortError.name = 'AbortError';
298
+ reject(abortError);
299
+ });
300
+ }));
301
+ const messages = [
302
+ {
303
+ id: '1',
304
+ timestamp: '2025-12-03T00:00:00Z',
305
+ type: 'user',
306
+ content: [{ text: 'Hello' }],
307
+ },
308
+ ];
309
+ const summaryPromise = service.generateSummary({
310
+ messages,
311
+ timeout: 100,
312
+ });
313
+ // Advance timers past the timeout to trigger abort
314
+ await vi.advanceTimersByTimeAsync(100);
315
+ const summary = await summaryPromise;
316
+ expect(summary).toBeNull();
317
+ });
318
+ it('should detect AbortError by name only (not message)', async () => {
319
+ const abortError = new Error('Different abort message');
320
+ abortError.name = 'AbortError';
321
+ mockGenerateContent.mockRejectedValue(abortError);
322
+ const messages = [
323
+ {
324
+ id: '1',
325
+ timestamp: '2025-12-03T00:00:00Z',
326
+ type: 'user',
327
+ content: [{ text: 'Hello' }],
328
+ },
329
+ ];
330
+ const summary = await service.generateSummary({ messages });
331
+ expect(summary).toBeNull();
332
+ // Should handle it gracefully without throwing
333
+ });
334
+ it('should handle API errors gracefully', async () => {
335
+ mockGenerateContent.mockRejectedValue(new Error('API Error'));
336
+ const messages = [
337
+ {
338
+ id: '1',
339
+ timestamp: '2025-12-03T00:00:00Z',
340
+ type: 'user',
341
+ content: [{ text: 'Hello' }],
342
+ },
343
+ ];
344
+ const summary = await service.generateSummary({ messages });
345
+ expect(summary).toBeNull();
346
+ });
347
+ it('should handle empty response from LLM', async () => {
348
+ mockGenerateContent.mockResolvedValue({
349
+ candidates: [
350
+ {
351
+ content: {
352
+ parts: [{ text: '' }],
353
+ },
354
+ },
355
+ ],
356
+ });
357
+ const messages = [
358
+ {
359
+ id: '1',
360
+ timestamp: '2025-12-03T00:00:00Z',
361
+ type: 'user',
362
+ content: [{ text: 'Hello' }],
363
+ },
364
+ ];
365
+ const summary = await service.generateSummary({ messages });
366
+ expect(summary).toBeNull();
367
+ });
368
+ });
369
+ describe('Text Processing', () => {
370
+ it('should clean newlines and extra whitespace', async () => {
371
+ mockGenerateContent.mockResolvedValue({
372
+ candidates: [
373
+ {
374
+ content: {
375
+ parts: [
376
+ {
377
+ text: 'Add dark mode\n\nto the app',
378
+ },
379
+ ],
380
+ },
381
+ },
382
+ ],
383
+ });
384
+ const messages = [
385
+ {
386
+ id: '1',
387
+ timestamp: '2025-12-03T00:00:00Z',
388
+ type: 'user',
389
+ content: [{ text: 'Hello' }],
390
+ },
391
+ ];
392
+ const summary = await service.generateSummary({ messages });
393
+ expect(summary).toBe('Add dark mode to the app');
394
+ });
395
+ it('should remove surrounding quotes', async () => {
396
+ mockGenerateContent.mockResolvedValue({
397
+ candidates: [
398
+ {
399
+ content: {
400
+ parts: [{ text: '"Add dark mode to the app"' }],
401
+ },
402
+ },
403
+ ],
404
+ });
405
+ const messages = [
406
+ {
407
+ id: '1',
408
+ timestamp: '2025-12-03T00:00:00Z',
409
+ type: 'user',
410
+ content: [{ text: 'Hello' }],
411
+ },
412
+ ];
413
+ const summary = await service.generateSummary({ messages });
414
+ expect(summary).toBe('Add dark mode to the app');
415
+ });
416
+ it('should handle messages longer than 500 chars', async () => {
417
+ const longMessage = 'a'.repeat(1000);
418
+ const messages = [
419
+ {
420
+ id: '1',
421
+ timestamp: '2025-12-03T00:00:00Z',
422
+ type: 'user',
423
+ content: [{ text: longMessage }],
424
+ },
425
+ {
426
+ id: '2',
427
+ timestamp: '2025-12-03T00:01:00Z',
428
+ type: 'gemini',
429
+ content: [{ text: 'Response' }],
430
+ },
431
+ ];
432
+ await service.generateSummary({ messages });
433
+ expect(mockGenerateContent).toHaveBeenCalledTimes(1);
434
+ const callArgs = mockGenerateContent.mock.calls[0][0];
435
+ const promptText = callArgs.contents[0].parts[0].text;
436
+ // Should be truncated to ~500 chars + "..."
437
+ expect(promptText).toContain('...');
438
+ expect(promptText).not.toContain('a'.repeat(600));
439
+ });
440
+ it('should preserve important content in truncation', async () => {
441
+ const messages = [
442
+ {
443
+ id: '1',
444
+ timestamp: '2025-12-03T00:00:00Z',
445
+ type: 'user',
446
+ content: [{ text: 'How do I add dark mode?' }],
447
+ },
448
+ {
449
+ id: '2',
450
+ timestamp: '2025-12-03T00:01:00Z',
451
+ type: 'gemini',
452
+ content: [
453
+ {
454
+ text: 'Here is a detailed explanation...',
455
+ },
456
+ ],
457
+ },
458
+ ];
459
+ await service.generateSummary({ messages });
460
+ expect(mockGenerateContent).toHaveBeenCalledTimes(1);
461
+ const callArgs = mockGenerateContent.mock.calls[0][0];
462
+ const promptText = callArgs.contents[0].parts[0].text;
463
+ // User question should be preserved
464
+ expect(promptText).toContain('User: How do I add dark mode?');
465
+ expect(promptText).toContain('Assistant: Here is a detailed explanation');
466
+ });
467
+ });
468
+ describe('Sliding Window Message Selection', () => {
469
+ it('should return all messages when fewer than 20 exist', async () => {
470
+ const messages = Array.from({ length: 5 }, (_, i) => ({
471
+ id: `${i}`,
472
+ timestamp: '2025-12-03T00:00:00Z',
473
+ type: i % 2 === 0 ? 'user' : 'gemini',
474
+ content: [{ text: `Message ${i}` }],
475
+ }));
476
+ await service.generateSummary({ messages });
477
+ const callArgs = mockGenerateContent.mock.calls[0][0];
478
+ const promptText = callArgs.contents[0].parts[0].text;
479
+ const messageCount = (promptText.match(/Message \d+/g) || []).length;
480
+ expect(messageCount).toBe(5);
481
+ });
482
+ it('should select first 10 + last 10 from 50 messages', async () => {
483
+ const messages = Array.from({ length: 50 }, (_, i) => ({
484
+ id: `${i}`,
485
+ timestamp: '2025-12-03T00:00:00Z',
486
+ type: i % 2 === 0 ? 'user' : 'gemini',
487
+ content: [{ text: `Message ${i}` }],
488
+ }));
489
+ await service.generateSummary({ messages });
490
+ const callArgs = mockGenerateContent.mock.calls[0][0];
491
+ const promptText = callArgs.contents[0].parts[0].text;
492
+ // Should include first 10
493
+ expect(promptText).toContain('Message 0');
494
+ expect(promptText).toContain('Message 9');
495
+ // Should skip middle
496
+ expect(promptText).not.toContain('Message 25');
497
+ // Should include last 10
498
+ expect(promptText).toContain('Message 40');
499
+ expect(promptText).toContain('Message 49');
500
+ const messageCount = (promptText.match(/Message \d+/g) || []).length;
501
+ expect(messageCount).toBe(20);
502
+ });
503
+ it('should return all messages when exactly 20 exist', async () => {
504
+ const messages = Array.from({ length: 20 }, (_, i) => ({
505
+ id: `${i}`,
506
+ timestamp: '2025-12-03T00:00:00Z',
507
+ type: i % 2 === 0 ? 'user' : 'gemini',
508
+ content: [{ text: `Message ${i}` }],
509
+ }));
510
+ await service.generateSummary({ messages });
511
+ const callArgs = mockGenerateContent.mock.calls[0][0];
512
+ const promptText = callArgs.contents[0].parts[0].text;
513
+ const messageCount = (promptText.match(/Message \d+/g) || []).length;
514
+ expect(messageCount).toBe(20);
515
+ });
516
+ it('should preserve message ordering in sliding window', async () => {
517
+ const messages = Array.from({ length: 30 }, (_, i) => ({
518
+ id: `${i}`,
519
+ timestamp: '2025-12-03T00:00:00Z',
520
+ type: i % 2 === 0 ? 'user' : 'gemini',
521
+ content: [{ text: `Message ${i}` }],
522
+ }));
523
+ await service.generateSummary({ messages });
524
+ const callArgs = mockGenerateContent.mock.calls[0][0];
525
+ const promptText = callArgs.contents[0].parts[0].text;
526
+ const matches = promptText.match(/Message (\d+)/g) || [];
527
+ const indices = matches.map((m) => parseInt(m.split(' ')[1], 10));
528
+ // Verify ordering is preserved
529
+ for (let i = 1; i < indices.length; i++) {
530
+ expect(indices[i]).toBeGreaterThan(indices[i - 1]);
531
+ }
532
+ });
533
+ it('should not count system messages when calculating window', async () => {
534
+ const messages = [
535
+ // First 10 user/gemini messages
536
+ ...Array.from({ length: 10 }, (_, i) => ({
537
+ id: `${i}`,
538
+ timestamp: '2025-12-03T00:00:00Z',
539
+ type: i % 2 === 0 ? 'user' : 'gemini',
540
+ content: [{ text: `Message ${i}` }],
541
+ })),
542
+ // System messages (should be filtered out)
543
+ {
544
+ id: 'info1',
545
+ timestamp: '2025-12-03T00:10:00Z',
546
+ type: 'info',
547
+ content: [{ text: 'Info' }],
548
+ },
549
+ {
550
+ id: 'warn1',
551
+ timestamp: '2025-12-03T00:11:00Z',
552
+ type: 'warning',
553
+ content: [{ text: 'Warning' }],
554
+ },
555
+ // Last 40 user/gemini messages
556
+ ...Array.from({ length: 40 }, (_, i) => ({
557
+ id: `${i + 10}`,
558
+ timestamp: '2025-12-03T00:12:00Z',
559
+ type: i % 2 === 0 ? 'user' : 'gemini',
560
+ content: [{ text: `Message ${i + 10}` }],
561
+ })),
562
+ ];
563
+ await service.generateSummary({ messages });
564
+ const callArgs = mockGenerateContent.mock.calls[0][0];
565
+ const promptText = callArgs.contents[0].parts[0].text;
566
+ // Should include early messages
567
+ expect(promptText).toContain('Message 0');
568
+ expect(promptText).toContain('Message 9');
569
+ // Should include late messages
570
+ expect(promptText).toContain('Message 40');
571
+ expect(promptText).toContain('Message 49');
572
+ // Should not include system messages
573
+ expect(promptText).not.toContain('Info');
574
+ expect(promptText).not.toContain('Warning');
575
+ });
576
+ });
577
+ describe('Edge Cases', () => {
578
+ it('should handle conversation with only user messages', async () => {
579
+ const messages = [
580
+ {
581
+ id: '1',
582
+ timestamp: '2025-12-03T00:00:00Z',
583
+ type: 'user',
584
+ content: [{ text: 'First question' }],
585
+ },
586
+ {
587
+ id: '2',
588
+ timestamp: '2025-12-03T00:01:00Z',
589
+ type: 'user',
590
+ content: [{ text: 'Second question' }],
591
+ },
592
+ ];
593
+ const summary = await service.generateSummary({ messages });
594
+ expect(summary).not.toBeNull();
595
+ expect(mockGenerateContent).toHaveBeenCalledTimes(1);
596
+ });
597
+ it('should handle conversation with only gemini messages', async () => {
598
+ const messages = [
599
+ {
600
+ id: '1',
601
+ timestamp: '2025-12-03T00:00:00Z',
602
+ type: 'gemini',
603
+ content: [{ text: 'First response' }],
604
+ },
605
+ {
606
+ id: '2',
607
+ timestamp: '2025-12-03T00:01:00Z',
608
+ type: 'gemini',
609
+ content: [{ text: 'Second response' }],
610
+ },
611
+ ];
612
+ const summary = await service.generateSummary({ messages });
613
+ expect(summary).not.toBeNull();
614
+ expect(mockGenerateContent).toHaveBeenCalledTimes(1);
615
+ });
616
+ it('should handle very long individual messages (>500 chars)', async () => {
617
+ const longMessage = `This is a very long message that contains a lot of text and definitely exceeds the 500 character limit. `.repeat(10);
618
+ const messages = [
619
+ {
620
+ id: '1',
621
+ timestamp: '2025-12-03T00:00:00Z',
622
+ type: 'user',
623
+ content: [{ text: longMessage }],
624
+ },
625
+ ];
626
+ await service.generateSummary({ messages });
627
+ expect(mockGenerateContent).toHaveBeenCalledTimes(1);
628
+ const callArgs = mockGenerateContent.mock.calls[0][0];
629
+ const promptText = callArgs.contents[0].parts[0].text;
630
+ // Should contain the truncation marker
631
+ expect(promptText).toContain('...');
632
+ });
633
+ it('should handle messages with special characters', async () => {
634
+ const messages = [
635
+ {
636
+ id: '1',
637
+ timestamp: '2025-12-03T00:00:00Z',
638
+ type: 'user',
639
+ content: [
640
+ {
641
+ text: 'How to use <Component> with props={value} & state?',
642
+ },
643
+ ],
644
+ },
645
+ ];
646
+ const summary = await service.generateSummary({ messages });
647
+ expect(summary).not.toBeNull();
648
+ expect(mockGenerateContent).toHaveBeenCalledTimes(1);
649
+ });
650
+ it('should handle malformed message content', async () => {
651
+ const messages = [
652
+ {
653
+ id: '1',
654
+ timestamp: '2025-12-03T00:00:00Z',
655
+ type: 'user',
656
+ content: [], // Empty parts array
657
+ },
658
+ {
659
+ id: '2',
660
+ timestamp: '2025-12-03T00:01:00Z',
661
+ type: 'gemini',
662
+ content: [{ text: 'Valid response' }],
663
+ },
664
+ ];
665
+ await service.generateSummary({ messages });
666
+ // Should handle gracefully and still process valid messages
667
+ expect(mockGenerateContent).toHaveBeenCalled();
668
+ });
669
+ });
670
+ describe('Internationalization Support', () => {
671
+ it('should preserve international characters (Chinese)', async () => {
672
+ mockGenerateContent.mockResolvedValue({
673
+ candidates: [
674
+ {
675
+ content: {
676
+ parts: [{ text: '添加深色模式到应用' }],
677
+ },
678
+ },
679
+ ],
680
+ });
681
+ const messages = [
682
+ {
683
+ id: '1',
684
+ timestamp: '2025-12-03T00:00:00Z',
685
+ type: 'user',
686
+ content: [{ text: 'How do I add dark mode?' }],
687
+ },
688
+ ];
689
+ const summary = await service.generateSummary({ messages });
690
+ expect(summary).toBe('添加深色模式到应用');
691
+ });
692
+ it('should preserve international characters (Arabic)', async () => {
693
+ mockGenerateContent.mockResolvedValue({
694
+ candidates: [
695
+ {
696
+ content: {
697
+ parts: [{ text: 'إضافة الوضع الداكن' }],
698
+ },
699
+ },
700
+ ],
701
+ });
702
+ const messages = [
703
+ {
704
+ id: '1',
705
+ timestamp: '2025-12-03T00:00:00Z',
706
+ type: 'user',
707
+ content: [{ text: 'How do I add dark mode?' }],
708
+ },
709
+ ];
710
+ const summary = await service.generateSummary({ messages });
711
+ expect(summary).toBe('إضافة الوضع الداكن');
712
+ });
713
+ it('should preserve accented characters', async () => {
714
+ mockGenerateContent.mockResolvedValue({
715
+ candidates: [
716
+ {
717
+ content: {
718
+ parts: [{ text: 'Añadir modo oscuro à la aplicación' }],
719
+ },
720
+ },
721
+ ],
722
+ });
723
+ const messages = [
724
+ {
725
+ id: '1',
726
+ timestamp: '2025-12-03T00:00:00Z',
727
+ type: 'user',
728
+ content: [{ text: 'How do I add dark mode?' }],
729
+ },
730
+ ];
731
+ const summary = await service.generateSummary({ messages });
732
+ expect(summary).toBe('Añadir modo oscuro à la aplicación');
733
+ });
734
+ it('should preserve emojis in summaries', async () => {
735
+ mockGenerateContent.mockResolvedValue({
736
+ candidates: [
737
+ {
738
+ content: {
739
+ parts: [{ text: '🌙 Add dark mode 🎨 to the app ✨' }],
740
+ },
741
+ },
742
+ ],
743
+ });
744
+ const messages = [
745
+ {
746
+ id: '1',
747
+ timestamp: '2025-12-03T00:00:00Z',
748
+ type: 'user',
749
+ content: [{ text: 'How do I add dark mode?' }],
750
+ },
751
+ ];
752
+ const summary = await service.generateSummary({ messages });
753
+ // Emojis are preserved
754
+ expect(summary).toBe('🌙 Add dark mode 🎨 to the app ✨');
755
+ expect(summary).toContain('🌙');
756
+ expect(summary).toContain('🎨');
757
+ expect(summary).toContain('✨');
758
+ });
759
+ it('should preserve zero-width characters for language rendering', async () => {
760
+ // Arabic with Zero-Width Joiner (ZWJ) for proper ligatures
761
+ mockGenerateContent.mockResolvedValue({
762
+ candidates: [
763
+ {
764
+ content: {
765
+ parts: [{ text: 'كلمة\u200Dمتصلة' }], // Contains ZWJ
766
+ },
767
+ },
768
+ ],
769
+ });
770
+ const messages = [
771
+ {
772
+ id: '1',
773
+ timestamp: '2025-12-03T00:00:00Z',
774
+ type: 'user',
775
+ content: [{ text: 'Test' }],
776
+ },
777
+ ];
778
+ const summary = await service.generateSummary({ messages });
779
+ // ZWJ is preserved (it's not considered whitespace)
780
+ expect(summary).toBe('كلمة\u200Dمتصلة');
781
+ expect(summary).toContain('\u200D'); // ZWJ should be preserved
782
+ });
783
+ });
784
+ });
785
+ //# sourceMappingURL=sessionSummaryService.test.js.map