@office-ai/aioncli-core 0.2.2 → 0.8.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 (758) hide show
  1. package/dist/index.d.ts +10 -3
  2. package/dist/index.js +10 -3
  3. package/dist/index.js.map +1 -1
  4. package/dist/src/agents/codebase-investigator.d.ts +11 -0
  5. package/dist/src/agents/codebase-investigator.js +73 -0
  6. package/dist/src/agents/codebase-investigator.js.map +1 -0
  7. package/dist/src/agents/executor.d.ts +88 -0
  8. package/dist/src/agents/executor.js +417 -0
  9. package/dist/src/agents/executor.js.map +1 -0
  10. package/dist/src/agents/executor.test.js +419 -0
  11. package/dist/src/agents/executor.test.js.map +1 -0
  12. package/dist/src/agents/invocation.d.ts +43 -0
  13. package/dist/src/agents/invocation.js +100 -0
  14. package/dist/src/agents/invocation.js.map +1 -0
  15. package/dist/src/agents/invocation.test.js +206 -0
  16. package/dist/src/agents/invocation.test.js.map +1 -0
  17. package/dist/src/agents/registry.d.ts +35 -0
  18. package/dist/src/agents/registry.js +58 -0
  19. package/dist/src/agents/registry.js.map +1 -0
  20. package/dist/src/agents/registry.test.js +146 -0
  21. package/dist/src/agents/registry.test.js.map +1 -0
  22. package/dist/src/agents/schema-utils.d.ts +39 -0
  23. package/dist/src/agents/schema-utils.js +57 -0
  24. package/dist/src/agents/schema-utils.js.map +1 -0
  25. package/dist/src/agents/schema-utils.test.d.ts +6 -0
  26. package/dist/src/agents/schema-utils.test.js +144 -0
  27. package/dist/src/agents/schema-utils.test.js.map +1 -0
  28. package/dist/src/agents/subagent-tool-wrapper.d.ts +36 -0
  29. package/dist/src/agents/subagent-tool-wrapper.js +47 -0
  30. package/dist/src/agents/subagent-tool-wrapper.js.map +1 -0
  31. package/dist/src/agents/subagent-tool-wrapper.test.d.ts +6 -0
  32. package/dist/src/agents/subagent-tool-wrapper.test.js +105 -0
  33. package/dist/src/agents/subagent-tool-wrapper.test.js.map +1 -0
  34. package/dist/src/agents/types.d.ts +116 -0
  35. package/dist/src/agents/types.js +17 -0
  36. package/dist/src/agents/types.js.map +1 -0
  37. package/dist/src/agents/utils.d.ts +15 -0
  38. package/dist/src/agents/utils.js +29 -0
  39. package/dist/src/agents/utils.js.map +1 -0
  40. package/dist/src/agents/utils.test.d.ts +6 -0
  41. package/dist/src/agents/utils.test.js +87 -0
  42. package/dist/src/agents/utils.test.js.map +1 -0
  43. package/dist/src/code_assist/codeAssist.d.ts +6 -3
  44. package/dist/src/code_assist/codeAssist.js +12 -0
  45. package/dist/src/code_assist/codeAssist.js.map +1 -1
  46. package/dist/src/code_assist/converter.d.ts +4 -1
  47. package/dist/src/code_assist/converter.js +38 -5
  48. package/dist/src/code_assist/converter.js.map +1 -1
  49. package/dist/src/code_assist/converter.test.js +93 -0
  50. package/dist/src/code_assist/converter.test.js.map +1 -1
  51. package/dist/src/code_assist/oauth-credential-storage.d.ts +25 -0
  52. package/dist/src/code_assist/oauth-credential-storage.js +109 -0
  53. package/dist/src/code_assist/oauth-credential-storage.js.map +1 -0
  54. package/dist/src/code_assist/oauth-credential-storage.test.d.ts +6 -0
  55. package/dist/src/code_assist/oauth-credential-storage.test.js +136 -0
  56. package/dist/src/code_assist/oauth-credential-storage.test.js.map +1 -0
  57. package/dist/src/code_assist/oauth2.d.ts +1 -1
  58. package/dist/src/code_assist/oauth2.js +107 -48
  59. package/dist/src/code_assist/oauth2.js.map +1 -1
  60. package/dist/src/code_assist/oauth2.test.js +735 -343
  61. package/dist/src/code_assist/oauth2.test.js.map +1 -1
  62. package/dist/src/code_assist/server.d.ts +4 -4
  63. package/dist/src/code_assist/server.js +25 -2
  64. package/dist/src/code_assist/server.js.map +1 -1
  65. package/dist/src/code_assist/server.test.js +25 -0
  66. package/dist/src/code_assist/server.test.js.map +1 -1
  67. package/dist/src/code_assist/setup.d.ts +1 -1
  68. package/dist/src/code_assist/setup.js +1 -1
  69. package/dist/src/code_assist/setup.js.map +1 -1
  70. package/dist/src/code_assist/setup.test.js.map +1 -1
  71. package/dist/src/code_assist/types.d.ts +17 -2
  72. package/dist/src/config/config.d.ts +121 -25
  73. package/dist/src/config/config.js +298 -87
  74. package/dist/src/config/config.js.map +1 -1
  75. package/dist/src/config/config.test.js +370 -131
  76. package/dist/src/config/config.test.js.map +1 -1
  77. package/dist/src/config/constants.d.ts +11 -0
  78. package/dist/src/config/constants.js +16 -0
  79. package/dist/src/config/constants.js.map +1 -0
  80. package/dist/src/config/models.d.ts +16 -0
  81. package/dist/src/config/models.js +29 -0
  82. package/dist/src/config/models.js.map +1 -1
  83. package/dist/src/config/models.test.d.ts +6 -0
  84. package/dist/src/config/models.test.js +55 -0
  85. package/dist/src/config/models.test.js.map +1 -0
  86. package/dist/src/config/storage.d.ts +34 -0
  87. package/dist/src/config/storage.js +95 -0
  88. package/dist/src/config/storage.js.map +1 -0
  89. package/dist/src/config/storage.test.d.ts +6 -0
  90. package/dist/src/config/storage.test.js +47 -0
  91. package/dist/src/config/storage.test.js.map +1 -0
  92. package/dist/src/confirmation-bus/index.d.ts +7 -0
  93. package/dist/src/confirmation-bus/index.js +8 -0
  94. package/dist/src/confirmation-bus/index.js.map +1 -0
  95. package/dist/src/confirmation-bus/message-bus.d.ts +17 -0
  96. package/dist/src/confirmation-bus/message-bus.js +81 -0
  97. package/dist/src/confirmation-bus/message-bus.js.map +1 -0
  98. package/dist/src/confirmation-bus/message-bus.test.d.ts +6 -0
  99. package/dist/src/confirmation-bus/message-bus.test.js +164 -0
  100. package/dist/src/confirmation-bus/message-bus.test.js.map +1 -0
  101. package/dist/src/confirmation-bus/types.d.ts +38 -0
  102. package/dist/src/confirmation-bus/types.js +15 -0
  103. package/dist/src/confirmation-bus/types.js.map +1 -0
  104. package/dist/src/core/baseLlmClient.d.ts +54 -0
  105. package/dist/src/core/baseLlmClient.js +190 -0
  106. package/dist/src/core/baseLlmClient.js.map +1 -0
  107. package/dist/src/core/baseLlmClient.test.d.ts +6 -0
  108. package/dist/src/core/baseLlmClient.test.js +316 -0
  109. package/dist/src/core/baseLlmClient.test.js.map +1 -0
  110. package/dist/src/core/client.d.ts +28 -28
  111. package/dist/src/core/client.js +187 -333
  112. package/dist/src/core/client.js.map +1 -1
  113. package/dist/src/core/client.test.js +745 -500
  114. package/dist/src/core/client.test.js.map +1 -1
  115. package/dist/src/core/contentGenerator.d.ts +4 -4
  116. package/dist/src/core/contentGenerator.js +6 -7
  117. package/dist/src/core/contentGenerator.js.map +1 -1
  118. package/dist/src/core/contentGenerator.test.js +1 -3
  119. package/dist/src/core/contentGenerator.test.js.map +1 -1
  120. package/dist/src/core/coreToolScheduler.d.ts +20 -7
  121. package/dist/src/core/coreToolScheduler.js +216 -53
  122. package/dist/src/core/coreToolScheduler.js.map +1 -1
  123. package/dist/src/core/coreToolScheduler.test.js +564 -88
  124. package/dist/src/core/coreToolScheduler.test.js.map +1 -1
  125. package/dist/src/core/geminiChat.d.ts +54 -43
  126. package/dist/src/core/geminiChat.js +298 -280
  127. package/dist/src/core/geminiChat.js.map +1 -1
  128. package/dist/src/core/geminiChat.test.js +1255 -321
  129. package/dist/src/core/geminiChat.test.js.map +1 -1
  130. package/dist/src/core/geminiRequest.js +1 -0
  131. package/dist/src/core/geminiRequest.js.map +1 -1
  132. package/dist/src/core/logger.d.ts +4 -2
  133. package/dist/src/core/logger.js +4 -3
  134. package/dist/src/core/logger.js.map +1 -1
  135. package/dist/src/core/logger.test.js +17 -16
  136. package/dist/src/core/logger.test.js.map +1 -1
  137. package/dist/src/core/loggingContentGenerator.d.ts +3 -3
  138. package/dist/src/core/loggingContentGenerator.js +15 -16
  139. package/dist/src/core/loggingContentGenerator.js.map +1 -1
  140. package/dist/src/core/nonInteractiveToolExecutor.d.ts +3 -5
  141. package/dist/src/core/nonInteractiveToolExecutor.js +14 -122
  142. package/dist/src/core/nonInteractiveToolExecutor.js.map +1 -1
  143. package/dist/src/core/nonInteractiveToolExecutor.test.js +158 -78
  144. package/dist/src/core/nonInteractiveToolExecutor.test.js.map +1 -1
  145. package/dist/src/core/openaiContentGenerator.d.ts +4 -3
  146. package/dist/src/core/openaiContentGenerator.js +21 -14
  147. package/dist/src/core/openaiContentGenerator.js.map +1 -1
  148. package/dist/src/core/openaiContentGenerator.test.js +1 -0
  149. package/dist/src/core/openaiContentGenerator.test.js.map +1 -1
  150. package/dist/src/core/prompts.d.ts +5 -0
  151. package/dist/src/core/prompts.js +66 -44
  152. package/dist/src/core/prompts.js.map +1 -1
  153. package/dist/src/core/prompts.test.js +130 -1
  154. package/dist/src/core/prompts.test.js.map +1 -1
  155. package/dist/src/core/subagent.d.ts +24 -18
  156. package/dist/src/core/subagent.js +125 -90
  157. package/dist/src/core/subagent.js.map +1 -1
  158. package/dist/src/core/subagent.test.js +59 -44
  159. package/dist/src/core/subagent.test.js.map +1 -1
  160. package/dist/src/core/turn.d.ts +37 -13
  161. package/dist/src/core/turn.js +63 -28
  162. package/dist/src/core/turn.js.map +1 -1
  163. package/dist/src/core/turn.test.js +359 -100
  164. package/dist/src/core/turn.test.js.map +1 -1
  165. package/dist/src/fallback/handler.d.ts +7 -0
  166. package/dist/src/fallback/handler.js +129 -0
  167. package/dist/src/fallback/handler.js.map +1 -0
  168. package/dist/src/fallback/handler.test.d.ts +6 -0
  169. package/dist/src/fallback/handler.test.js +130 -0
  170. package/dist/src/fallback/handler.test.js.map +1 -0
  171. package/dist/src/fallback/types.d.ts +14 -0
  172. package/dist/src/fallback/types.js +7 -0
  173. package/dist/src/fallback/types.js.map +1 -0
  174. package/dist/src/generated/git-commit.d.ts +1 -1
  175. package/dist/src/generated/git-commit.js +1 -1
  176. package/dist/src/ide/constants.d.ts +3 -0
  177. package/dist/src/ide/constants.js +3 -0
  178. package/dist/src/ide/constants.js.map +1 -1
  179. package/dist/src/ide/detect-ide.d.ts +48 -12
  180. package/dist/src/ide/detect-ide.js +47 -66
  181. package/dist/src/ide/detect-ide.js.map +1 -1
  182. package/dist/src/ide/detect-ide.test.js +79 -52
  183. package/dist/src/ide/detect-ide.test.js.map +1 -1
  184. package/dist/src/ide/ide-client.d.ts +69 -23
  185. package/dist/src/ide/ide-client.js +372 -78
  186. package/dist/src/ide/ide-client.js.map +1 -1
  187. package/dist/src/ide/ide-client.test.js +375 -30
  188. package/dist/src/ide/ide-client.test.js.map +1 -1
  189. package/dist/src/ide/ide-installer.d.ts +2 -2
  190. package/dist/src/ide/ide-installer.js +37 -24
  191. package/dist/src/ide/ide-installer.js.map +1 -1
  192. package/dist/src/ide/ide-installer.test.js +104 -26
  193. package/dist/src/ide/ide-installer.test.js.map +1 -1
  194. package/dist/src/ide/ideContext.d.ts +35 -365
  195. package/dist/src/ide/ideContext.js +60 -106
  196. package/dist/src/ide/ideContext.js.map +1 -1
  197. package/dist/src/ide/ideContext.test.js +152 -24
  198. package/dist/src/ide/ideContext.test.js.map +1 -1
  199. package/dist/src/ide/process-utils.d.ts +7 -5
  200. package/dist/src/ide/process-utils.js +81 -50
  201. package/dist/src/ide/process-utils.js.map +1 -1
  202. package/dist/src/ide/process-utils.test.d.ts +6 -0
  203. package/dist/src/ide/process-utils.test.js +158 -0
  204. package/dist/src/ide/process-utils.test.js.map +1 -0
  205. package/dist/src/ide/types.d.ts +486 -0
  206. package/dist/src/ide/types.js +138 -0
  207. package/dist/src/ide/types.js.map +1 -0
  208. package/dist/src/index.d.ts +20 -2
  209. package/dist/src/index.js +20 -2
  210. package/dist/src/index.js.map +1 -1
  211. package/dist/src/mcp/google-auth-provider.d.ts +3 -3
  212. package/dist/src/mcp/google-auth-provider.test.js.map +1 -1
  213. package/dist/src/mcp/oauth-provider.d.ts +17 -13
  214. package/dist/src/mcp/oauth-provider.js +81 -69
  215. package/dist/src/mcp/oauth-provider.js.map +1 -1
  216. package/dist/src/mcp/oauth-provider.test.js +212 -37
  217. package/dist/src/mcp/oauth-provider.test.js.map +1 -1
  218. package/dist/src/mcp/oauth-token-storage.d.ts +14 -32
  219. package/dist/src/mcp/oauth-token-storage.js +54 -25
  220. package/dist/src/mcp/oauth-token-storage.js.map +1 -1
  221. package/dist/src/mcp/oauth-token-storage.test.js +256 -162
  222. package/dist/src/mcp/oauth-token-storage.test.js.map +1 -1
  223. package/dist/src/mcp/oauth-utils.d.ts +9 -1
  224. package/dist/src/mcp/oauth-utils.js +42 -27
  225. package/dist/src/mcp/oauth-utils.js.map +1 -1
  226. package/dist/src/mcp/oauth-utils.test.js +41 -1
  227. package/dist/src/mcp/oauth-utils.test.js.map +1 -1
  228. package/dist/src/mcp/sa-impersonation-provider.d.ts +33 -0
  229. package/dist/src/mcp/sa-impersonation-provider.js +130 -0
  230. package/dist/src/mcp/sa-impersonation-provider.js.map +1 -0
  231. package/dist/src/mcp/sa-impersonation-provider.test.d.ts +6 -0
  232. package/dist/src/mcp/sa-impersonation-provider.test.js +117 -0
  233. package/dist/src/mcp/sa-impersonation-provider.test.js.map +1 -0
  234. package/dist/src/mcp/token-storage/base-token-storage.d.ts +19 -0
  235. package/dist/src/mcp/token-storage/base-token-storage.js +36 -0
  236. package/dist/src/mcp/token-storage/base-token-storage.js.map +1 -0
  237. package/dist/src/mcp/token-storage/base-token-storage.test.d.ts +6 -0
  238. package/dist/src/mcp/token-storage/base-token-storage.test.js +160 -0
  239. package/dist/src/mcp/token-storage/base-token-storage.test.js.map +1 -0
  240. package/dist/src/mcp/token-storage/file-token-storage.d.ts +24 -0
  241. package/dist/src/mcp/token-storage/file-token-storage.js +144 -0
  242. package/dist/src/mcp/token-storage/file-token-storage.js.map +1 -0
  243. package/dist/src/mcp/token-storage/file-token-storage.test.d.ts +6 -0
  244. package/dist/src/mcp/token-storage/file-token-storage.test.js +235 -0
  245. package/dist/src/mcp/token-storage/file-token-storage.test.js.map +1 -0
  246. package/dist/src/mcp/token-storage/hybrid-token-storage.d.ts +23 -0
  247. package/dist/src/mcp/token-storage/hybrid-token-storage.js +78 -0
  248. package/dist/src/mcp/token-storage/hybrid-token-storage.js.map +1 -0
  249. package/dist/src/mcp/token-storage/hybrid-token-storage.test.d.ts +6 -0
  250. package/dist/src/mcp/token-storage/hybrid-token-storage.test.js +193 -0
  251. package/dist/src/mcp/token-storage/hybrid-token-storage.test.js.map +1 -0
  252. package/dist/src/mcp/token-storage/index.d.ts +11 -0
  253. package/dist/src/mcp/token-storage/index.js +12 -0
  254. package/dist/src/mcp/token-storage/index.js.map +1 -0
  255. package/dist/src/mcp/token-storage/keychain-token-storage.d.ts +31 -0
  256. package/dist/src/mcp/token-storage/keychain-token-storage.js +190 -0
  257. package/dist/src/mcp/token-storage/keychain-token-storage.js.map +1 -0
  258. package/dist/src/mcp/token-storage/keychain-token-storage.test.d.ts +6 -0
  259. package/dist/src/mcp/token-storage/keychain-token-storage.test.js +254 -0
  260. package/dist/src/mcp/token-storage/keychain-token-storage.test.js.map +1 -0
  261. package/dist/src/mcp/token-storage/types.d.ts +38 -0
  262. package/dist/src/mcp/token-storage/types.js +11 -0
  263. package/dist/src/mcp/token-storage/types.js.map +1 -0
  264. package/dist/src/output/json-formatter.d.ts +11 -0
  265. package/dist/src/output/json-formatter.js +30 -0
  266. package/dist/src/output/json-formatter.js.map +1 -0
  267. package/dist/src/output/json-formatter.test.d.ts +6 -0
  268. package/dist/src/output/json-formatter.test.js +266 -0
  269. package/dist/src/output/json-formatter.test.js.map +1 -0
  270. package/dist/src/output/types.d.ts +20 -0
  271. package/dist/src/output/types.js +11 -0
  272. package/dist/src/output/types.js.map +1 -0
  273. package/dist/src/policy/index.d.ts +7 -0
  274. package/dist/src/policy/index.js +8 -0
  275. package/dist/src/policy/index.js.map +1 -0
  276. package/dist/src/policy/policy-engine.d.ts +30 -0
  277. package/dist/src/policy/policy-engine.js +92 -0
  278. package/dist/src/policy/policy-engine.js.map +1 -0
  279. package/dist/src/policy/policy-engine.test.d.ts +6 -0
  280. package/dist/src/policy/policy-engine.test.js +515 -0
  281. package/dist/src/policy/policy-engine.test.js.map +1 -0
  282. package/dist/src/policy/stable-stringify.d.ts +58 -0
  283. package/dist/src/policy/stable-stringify.js +122 -0
  284. package/dist/src/policy/stable-stringify.js.map +1 -0
  285. package/dist/src/policy/types.d.ts +47 -0
  286. package/dist/src/policy/types.js +12 -0
  287. package/dist/src/policy/types.js.map +1 -0
  288. package/dist/src/prompts/mcp-prompts.d.ts +2 -2
  289. package/dist/src/prompts/prompt-registry.d.ts +1 -1
  290. package/dist/src/routing/modelRouterService.d.ts +23 -0
  291. package/dist/src/routing/modelRouterService.js +70 -0
  292. package/dist/src/routing/modelRouterService.js.map +1 -0
  293. package/dist/src/routing/modelRouterService.test.d.ts +6 -0
  294. package/dist/src/routing/modelRouterService.test.js +98 -0
  295. package/dist/src/routing/modelRouterService.test.js.map +1 -0
  296. package/dist/src/routing/routingStrategy.d.ts +62 -0
  297. package/dist/src/routing/routingStrategy.js +7 -0
  298. package/dist/src/routing/routingStrategy.js.map +1 -0
  299. package/dist/src/routing/strategies/classifierStrategy.d.ts +12 -0
  300. package/dist/src/routing/strategies/classifierStrategy.js +173 -0
  301. package/dist/src/routing/strategies/classifierStrategy.js.map +1 -0
  302. package/dist/src/routing/strategies/classifierStrategy.test.d.ts +6 -0
  303. package/dist/src/routing/strategies/classifierStrategy.test.js +192 -0
  304. package/dist/src/routing/strategies/classifierStrategy.test.js.map +1 -0
  305. package/dist/src/routing/strategies/compositeStrategy.d.ts +26 -0
  306. package/dist/src/routing/strategies/compositeStrategy.js +68 -0
  307. package/dist/src/routing/strategies/compositeStrategy.js.map +1 -0
  308. package/dist/src/routing/strategies/compositeStrategy.test.d.ts +6 -0
  309. package/dist/src/routing/strategies/compositeStrategy.test.js +123 -0
  310. package/dist/src/routing/strategies/compositeStrategy.test.js.map +1 -0
  311. package/dist/src/routing/strategies/defaultStrategy.d.ts +12 -0
  312. package/dist/src/routing/strategies/defaultStrategy.js +20 -0
  313. package/dist/src/routing/strategies/defaultStrategy.js.map +1 -0
  314. package/dist/src/routing/strategies/defaultStrategy.test.d.ts +6 -0
  315. package/dist/src/routing/strategies/defaultStrategy.test.js +26 -0
  316. package/dist/src/routing/strategies/defaultStrategy.test.js.map +1 -0
  317. package/dist/src/routing/strategies/fallbackStrategy.d.ts +12 -0
  318. package/dist/src/routing/strategies/fallbackStrategy.js +25 -0
  319. package/dist/src/routing/strategies/fallbackStrategy.js.map +1 -0
  320. package/dist/src/routing/strategies/fallbackStrategy.test.d.ts +6 -0
  321. package/dist/src/routing/strategies/fallbackStrategy.test.js +55 -0
  322. package/dist/src/routing/strategies/fallbackStrategy.test.js.map +1 -0
  323. package/dist/src/routing/strategies/overrideStrategy.d.ts +15 -0
  324. package/dist/src/routing/strategies/overrideStrategy.js +28 -0
  325. package/dist/src/routing/strategies/overrideStrategy.js.map +1 -0
  326. package/dist/src/routing/strategies/overrideStrategy.test.d.ts +6 -0
  327. package/dist/src/routing/strategies/overrideStrategy.test.js +42 -0
  328. package/dist/src/routing/strategies/overrideStrategy.test.js.map +1 -0
  329. package/dist/src/services/chatRecordingService.d.ts +8 -14
  330. package/dist/src/services/chatRecordingService.js +33 -21
  331. package/dist/src/services/chatRecordingService.js.map +1 -1
  332. package/dist/src/services/chatRecordingService.test.js +69 -25
  333. package/dist/src/services/chatRecordingService.test.js.map +1 -1
  334. package/dist/src/services/fileDiscoveryService.d.ts +10 -0
  335. package/dist/src/services/fileDiscoveryService.js +32 -18
  336. package/dist/src/services/fileDiscoveryService.js.map +1 -1
  337. package/dist/src/services/fileDiscoveryService.test.js +3 -3
  338. package/dist/src/services/fileDiscoveryService.test.js.map +1 -1
  339. package/dist/src/services/fileSystemService.d.ts +9 -0
  340. package/dist/src/services/fileSystemService.js +12 -1
  341. package/dist/src/services/fileSystemService.js.map +1 -1
  342. package/dist/src/services/fileSystemService.test.js +1 -1
  343. package/dist/src/services/fileSystemService.test.js.map +1 -1
  344. package/dist/src/services/gitService.d.ts +3 -1
  345. package/dist/src/services/gitService.js +30 -24
  346. package/dist/src/services/gitService.js.map +1 -1
  347. package/dist/src/services/gitService.test.js +30 -37
  348. package/dist/src/services/gitService.test.js.map +1 -1
  349. package/dist/src/services/loopDetectionService.d.ts +8 -2
  350. package/dist/src/services/loopDetectionService.js +64 -24
  351. package/dist/src/services/loopDetectionService.js.map +1 -1
  352. package/dist/src/services/loopDetectionService.test.js +64 -13
  353. package/dist/src/services/loopDetectionService.test.js.map +1 -1
  354. package/dist/src/services/shellExecutionService.d.ts +36 -2
  355. package/dist/src/services/shellExecutionService.js +238 -47
  356. package/dist/src/services/shellExecutionService.js.map +1 -1
  357. package/dist/src/services/shellExecutionService.test.js +197 -58
  358. package/dist/src/services/shellExecutionService.test.js.map +1 -1
  359. package/dist/src/telemetry/activity-detector.d.ts +41 -0
  360. package/dist/src/telemetry/activity-detector.js +61 -0
  361. package/dist/src/telemetry/activity-detector.js.map +1 -0
  362. package/dist/src/telemetry/activity-detector.test.d.ts +6 -0
  363. package/dist/src/telemetry/activity-detector.test.js +136 -0
  364. package/dist/src/telemetry/activity-detector.test.js.map +1 -0
  365. package/dist/src/telemetry/activity-types.d.ts +19 -0
  366. package/dist/src/telemetry/activity-types.js +21 -0
  367. package/dist/src/telemetry/activity-types.js.map +1 -0
  368. package/dist/src/telemetry/clearcut-logger/clearcut-logger.d.ts +34 -4
  369. package/dist/src/telemetry/clearcut-logger/clearcut-logger.js +322 -15
  370. package/dist/src/telemetry/clearcut-logger/clearcut-logger.js.map +1 -1
  371. package/dist/src/telemetry/clearcut-logger/clearcut-logger.test.d.ts +1 -0
  372. package/dist/src/telemetry/clearcut-logger/clearcut-logger.test.js +321 -11
  373. package/dist/src/telemetry/clearcut-logger/clearcut-logger.test.js.map +1 -1
  374. package/dist/src/telemetry/clearcut-logger/event-metadata-key.d.ts +51 -2
  375. package/dist/src/telemetry/clearcut-logger/event-metadata-key.js +124 -2
  376. package/dist/src/telemetry/clearcut-logger/event-metadata-key.js.map +1 -1
  377. package/dist/src/telemetry/config.d.ts +31 -0
  378. package/dist/src/telemetry/config.js +76 -0
  379. package/dist/src/telemetry/config.js.map +1 -0
  380. package/dist/src/telemetry/config.test.d.ts +6 -0
  381. package/dist/src/telemetry/config.test.js +124 -0
  382. package/dist/src/telemetry/config.test.js.map +1 -0
  383. package/dist/src/telemetry/constants.d.ts +17 -7
  384. package/dist/src/telemetry/constants.js +18 -7
  385. package/dist/src/telemetry/constants.js.map +1 -1
  386. package/dist/src/telemetry/file-exporters.d.ts +5 -4
  387. package/dist/src/telemetry/file-exporters.js +1 -1
  388. package/dist/src/telemetry/file-exporters.js.map +1 -1
  389. package/dist/src/telemetry/gcp-exporters.d.ts +34 -0
  390. package/dist/src/telemetry/gcp-exporters.js +117 -0
  391. package/dist/src/telemetry/gcp-exporters.js.map +1 -0
  392. package/dist/src/telemetry/gcp-exporters.test.d.ts +6 -0
  393. package/dist/src/telemetry/gcp-exporters.test.js +318 -0
  394. package/dist/src/telemetry/gcp-exporters.test.js.map +1 -0
  395. package/dist/src/telemetry/high-water-mark-tracker.d.ts +43 -0
  396. package/dist/src/telemetry/high-water-mark-tracker.js +88 -0
  397. package/dist/src/telemetry/high-water-mark-tracker.js.map +1 -0
  398. package/dist/src/telemetry/high-water-mark-tracker.test.d.ts +6 -0
  399. package/dist/src/telemetry/high-water-mark-tracker.test.js +152 -0
  400. package/dist/src/telemetry/high-water-mark-tracker.test.js.map +1 -0
  401. package/dist/src/telemetry/index.d.ts +12 -2
  402. package/dist/src/telemetry/index.js +16 -2
  403. package/dist/src/telemetry/index.js.map +1 -1
  404. package/dist/src/telemetry/loggers.d.ts +17 -2
  405. package/dist/src/telemetry/loggers.js +316 -14
  406. package/dist/src/telemetry/loggers.js.map +1 -1
  407. package/dist/src/telemetry/loggers.test.circular.js +3 -3
  408. package/dist/src/telemetry/loggers.test.circular.js.map +1 -1
  409. package/dist/src/telemetry/loggers.test.js +452 -48
  410. package/dist/src/telemetry/loggers.test.js.map +1 -1
  411. package/dist/src/telemetry/metrics.d.ts +323 -12
  412. package/dist/src/telemetry/metrics.js +464 -83
  413. package/dist/src/telemetry/metrics.js.map +1 -1
  414. package/dist/src/telemetry/metrics.test.js +583 -38
  415. package/dist/src/telemetry/metrics.test.js.map +1 -1
  416. package/dist/src/telemetry/rate-limiter.d.ts +48 -0
  417. package/dist/src/telemetry/rate-limiter.js +100 -0
  418. package/dist/src/telemetry/rate-limiter.js.map +1 -0
  419. package/dist/src/telemetry/rate-limiter.test.d.ts +6 -0
  420. package/dist/src/telemetry/rate-limiter.test.js +207 -0
  421. package/dist/src/telemetry/rate-limiter.test.js.map +1 -0
  422. package/dist/src/telemetry/sdk.d.ts +1 -1
  423. package/dist/src/telemetry/sdk.js +20 -2
  424. package/dist/src/telemetry/sdk.js.map +1 -1
  425. package/dist/src/telemetry/sdk.test.js +108 -0
  426. package/dist/src/telemetry/sdk.test.js.map +1 -1
  427. package/dist/src/telemetry/telemetry-utils.d.ts +6 -0
  428. package/dist/src/telemetry/telemetry-utils.js +14 -0
  429. package/dist/src/telemetry/telemetry-utils.js.map +1 -0
  430. package/dist/src/telemetry/telemetry-utils.test.d.ts +6 -0
  431. package/dist/src/telemetry/telemetry-utils.test.js +40 -0
  432. package/dist/src/telemetry/telemetry-utils.test.js.map +1 -0
  433. package/dist/src/telemetry/types.d.ts +136 -8
  434. package/dist/src/telemetry/types.js +233 -11
  435. package/dist/src/telemetry/types.js.map +1 -1
  436. package/dist/src/telemetry/uiTelemetry.d.ts +3 -3
  437. package/dist/src/telemetry/uiTelemetry.js +7 -8
  438. package/dist/src/telemetry/uiTelemetry.js.map +1 -1
  439. package/dist/src/telemetry/uiTelemetry.test.js +33 -29
  440. package/dist/src/telemetry/uiTelemetry.test.js.map +1 -1
  441. package/dist/src/test-utils/config.d.ts +2 -1
  442. package/dist/src/test-utils/config.js.map +1 -1
  443. package/dist/src/test-utils/index.d.ts +6 -0
  444. package/dist/src/test-utils/index.js +7 -0
  445. package/dist/src/test-utils/index.js.map +1 -0
  446. package/dist/src/test-utils/mock-tool.d.ts +66 -0
  447. package/dist/src/test-utils/{tools.js → mock-tool.js} +45 -29
  448. package/dist/src/test-utils/mock-tool.js.map +1 -0
  449. package/dist/src/test-utils/mockWorkspaceContext.d.ts +1 -1
  450. package/dist/src/tools/diffOptions.d.ts +1 -1
  451. package/dist/src/tools/diffOptions.js +21 -13
  452. package/dist/src/tools/diffOptions.js.map +1 -1
  453. package/dist/src/tools/diffOptions.test.js +58 -22
  454. package/dist/src/tools/diffOptions.test.js.map +1 -1
  455. package/dist/src/tools/edit.d.ts +6 -5
  456. package/dist/src/tools/edit.js +58 -40
  457. package/dist/src/tools/edit.js.map +1 -1
  458. package/dist/src/tools/edit.test.js +192 -16
  459. package/dist/src/tools/edit.test.js.map +1 -1
  460. package/dist/src/tools/glob.d.ts +7 -2
  461. package/dist/src/tools/glob.js +42 -23
  462. package/dist/src/tools/glob.js.map +1 -1
  463. package/dist/src/tools/glob.test.js +80 -4
  464. package/dist/src/tools/glob.test.js.map +1 -1
  465. package/dist/src/tools/grep.d.ts +3 -2
  466. package/dist/src/tools/grep.js +35 -15
  467. package/dist/src/tools/grep.js.map +1 -1
  468. package/dist/src/tools/grep.test.js +26 -3
  469. package/dist/src/tools/grep.test.js.map +1 -1
  470. package/dist/src/tools/ls.d.ts +3 -2
  471. package/dist/src/tools/ls.js +31 -39
  472. package/dist/src/tools/ls.js.map +1 -1
  473. package/dist/src/tools/ls.test.js +145 -280
  474. package/dist/src/tools/ls.test.js.map +1 -1
  475. package/dist/src/tools/mcp-client-manager.d.ts +8 -6
  476. package/dist/src/tools/mcp-client-manager.js +13 -4
  477. package/dist/src/tools/mcp-client-manager.js.map +1 -1
  478. package/dist/src/tools/mcp-client-manager.test.js +20 -1
  479. package/dist/src/tools/mcp-client-manager.test.js.map +1 -1
  480. package/dist/src/tools/mcp-client.d.ts +18 -21
  481. package/dist/src/tools/mcp-client.js +87 -120
  482. package/dist/src/tools/mcp-client.js.map +1 -1
  483. package/dist/src/tools/mcp-client.test.js +32 -152
  484. package/dist/src/tools/mcp-client.test.js.map +1 -1
  485. package/dist/src/tools/mcp-tool.d.ts +6 -4
  486. package/dist/src/tools/mcp-tool.js +51 -13
  487. package/dist/src/tools/mcp-tool.js.map +1 -1
  488. package/dist/src/tools/mcp-tool.test.js +166 -12
  489. package/dist/src/tools/mcp-tool.test.js.map +1 -1
  490. package/dist/src/tools/memoryTool.d.ts +3 -2
  491. package/dist/src/tools/memoryTool.js +14 -37
  492. package/dist/src/tools/memoryTool.js.map +1 -1
  493. package/dist/src/tools/memoryTool.test.js +16 -4
  494. package/dist/src/tools/memoryTool.test.js.map +1 -1
  495. package/dist/src/tools/message-bus-integration.test.d.ts +6 -0
  496. package/dist/src/tools/message-bus-integration.test.js +183 -0
  497. package/dist/src/tools/message-bus-integration.test.js.map +1 -0
  498. package/dist/src/tools/modifiable-tool.d.ts +2 -2
  499. package/dist/src/tools/modifiable-tool.js +3 -3
  500. package/dist/src/tools/modifiable-tool.js.map +1 -1
  501. package/dist/src/tools/modifiable-tool.test.js +4 -4
  502. package/dist/src/tools/modifiable-tool.test.js.map +1 -1
  503. package/dist/src/tools/read-file.d.ts +3 -2
  504. package/dist/src/tools/read-file.js +33 -43
  505. package/dist/src/tools/read-file.js.map +1 -1
  506. package/dist/src/tools/read-file.test.js +39 -7
  507. package/dist/src/tools/read-file.test.js.map +1 -1
  508. package/dist/src/tools/read-many-files.d.ts +3 -2
  509. package/dist/src/tools/read-many-files.js +52 -107
  510. package/dist/src/tools/read-many-files.js.map +1 -1
  511. package/dist/src/tools/read-many-files.test.js +64 -11
  512. package/dist/src/tools/read-many-files.test.js.map +1 -1
  513. package/dist/src/tools/ripGrep.d.ts +55 -0
  514. package/dist/src/tools/ripGrep.js +393 -0
  515. package/dist/src/tools/ripGrep.js.map +1 -0
  516. package/dist/src/tools/ripGrep.test.d.ts +6 -0
  517. package/dist/src/tools/ripGrep.test.js +976 -0
  518. package/dist/src/tools/ripGrep.test.js.map +1 -0
  519. package/dist/src/tools/shell.d.ts +13 -2
  520. package/dist/src/tools/shell.js +42 -32
  521. package/dist/src/tools/shell.js.map +1 -1
  522. package/dist/src/tools/shell.test.js +57 -75
  523. package/dist/src/tools/shell.test.js.map +1 -1
  524. package/dist/src/tools/smart-edit.d.ts +91 -0
  525. package/dist/src/tools/smart-edit.js +702 -0
  526. package/dist/src/tools/smart-edit.js.map +1 -0
  527. package/dist/src/tools/smart-edit.test.d.ts +6 -0
  528. package/dist/src/tools/smart-edit.test.js +542 -0
  529. package/dist/src/tools/smart-edit.test.js.map +1 -0
  530. package/dist/src/tools/tool-error.d.ts +18 -1
  531. package/dist/src/tools/tool-error.js +27 -0
  532. package/dist/src/tools/tool-error.js.map +1 -1
  533. package/dist/src/tools/tool-registry.d.ts +10 -4
  534. package/dist/src/tools/tool-registry.js +20 -7
  535. package/dist/src/tools/tool-registry.js.map +1 -1
  536. package/dist/src/tools/tool-registry.test.js +93 -10
  537. package/dist/src/tools/tool-registry.test.js.map +1 -1
  538. package/dist/src/tools/tools.d.ts +33 -16
  539. package/dist/src/tools/tools.js +115 -5
  540. package/dist/src/tools/tools.js.map +1 -1
  541. package/dist/src/tools/tools.test.js +1 -2
  542. package/dist/src/tools/tools.test.js.map +1 -1
  543. package/dist/src/tools/web-fetch.d.ts +3 -2
  544. package/dist/src/tools/web-fetch.js +14 -10
  545. package/dist/src/tools/web-fetch.js.map +1 -1
  546. package/dist/src/tools/web-fetch.test.js +55 -16
  547. package/dist/src/tools/web-fetch.test.js.map +1 -1
  548. package/dist/src/tools/web-search.d.ts +4 -3
  549. package/dist/src/tools/web-search.js +31 -8
  550. package/dist/src/tools/web-search.js.map +1 -1
  551. package/dist/src/tools/web-search.test.js +69 -1
  552. package/dist/src/tools/web-search.test.js.map +1 -1
  553. package/dist/src/tools/write-file.d.ts +4 -3
  554. package/dist/src/tools/write-file.js +17 -18
  555. package/dist/src/tools/write-file.js.map +1 -1
  556. package/dist/src/tools/write-file.test.js +108 -24
  557. package/dist/src/tools/write-file.test.js.map +1 -1
  558. package/dist/src/tools/write-todos.d.ts +25 -0
  559. package/dist/src/tools/write-todos.js +150 -0
  560. package/dist/src/tools/write-todos.js.map +1 -0
  561. package/dist/src/tools/write-todos.test.d.ts +6 -0
  562. package/dist/src/tools/write-todos.test.js +89 -0
  563. package/dist/src/tools/write-todos.test.js.map +1 -0
  564. package/dist/src/utils/bfsFileSearch.d.ts +2 -2
  565. package/dist/src/utils/bfsFileSearch.js +13 -7
  566. package/dist/src/utils/bfsFileSearch.js.map +1 -1
  567. package/dist/src/utils/bfsFileSearch.test.js +3 -3
  568. package/dist/src/utils/bfsFileSearch.test.js.map +1 -1
  569. package/dist/src/utils/editCorrector.d.ts +9 -8
  570. package/dist/src/utils/editCorrector.js +62 -19
  571. package/dist/src/utils/editCorrector.js.map +1 -1
  572. package/dist/src/utils/editCorrector.test.js +33 -82
  573. package/dist/src/utils/editCorrector.test.js.map +1 -1
  574. package/dist/src/utils/editor.js +32 -45
  575. package/dist/src/utils/editor.js.map +1 -1
  576. package/dist/src/utils/editor.test.js +62 -76
  577. package/dist/src/utils/editor.test.js.map +1 -1
  578. package/dist/src/utils/environmentContext.d.ts +2 -2
  579. package/dist/src/utils/errorParsing.js +2 -2
  580. package/dist/src/utils/errorParsing.js.map +1 -1
  581. package/dist/src/utils/errorParsing.test.js +7 -7
  582. package/dist/src/utils/errorParsing.test.js.map +1 -1
  583. package/dist/src/utils/errorReporting.d.ts +1 -1
  584. package/dist/src/utils/errors.d.ts +25 -0
  585. package/dist/src/utils/errors.js +42 -0
  586. package/dist/src/utils/errors.js.map +1 -1
  587. package/dist/src/utils/fetch.js +1 -1
  588. package/dist/src/utils/fetch.js.map +1 -1
  589. package/dist/src/utils/fileUtils.d.ts +24 -12
  590. package/dist/src/utils/fileUtils.js +170 -79
  591. package/dist/src/utils/fileUtils.js.map +1 -1
  592. package/dist/src/utils/fileUtils.test.js +347 -29
  593. package/dist/src/utils/fileUtils.test.js.map +1 -1
  594. package/dist/src/utils/filesearch/crawler.d.ts +1 -1
  595. package/dist/src/utils/filesearch/crawler.test.js +2 -2
  596. package/dist/src/utils/filesearch/crawler.test.js.map +1 -1
  597. package/dist/src/utils/filesearch/fileSearch.d.ts +1 -0
  598. package/dist/src/utils/filesearch/fileSearch.js +14 -9
  599. package/dist/src/utils/filesearch/fileSearch.js.map +1 -1
  600. package/dist/src/utils/filesearch/fileSearch.test.js +90 -0
  601. package/dist/src/utils/filesearch/fileSearch.test.js.map +1 -1
  602. package/dist/src/utils/flashFallback.test.d.ts +6 -0
  603. package/dist/src/utils/{flashFallback.integration.test.js → flashFallback.test.js} +33 -29
  604. package/dist/src/utils/flashFallback.test.js.map +1 -0
  605. package/dist/src/utils/geminiIgnoreParser.d.ts +18 -0
  606. package/dist/src/utils/geminiIgnoreParser.js +61 -0
  607. package/dist/src/utils/geminiIgnoreParser.js.map +1 -0
  608. package/dist/src/utils/geminiIgnoreParser.test.d.ts +6 -0
  609. package/dist/src/utils/geminiIgnoreParser.test.js +50 -0
  610. package/dist/src/utils/geminiIgnoreParser.test.js.map +1 -0
  611. package/dist/src/utils/generateContentResponseUtilities.d.ts +1 -2
  612. package/dist/src/utils/generateContentResponseUtilities.js +1 -13
  613. package/dist/src/utils/generateContentResponseUtilities.js.map +1 -1
  614. package/dist/src/utils/generateContentResponseUtilities.test.js +2 -40
  615. package/dist/src/utils/generateContentResponseUtilities.test.js.map +1 -1
  616. package/dist/src/utils/getFolderStructure.d.ts +2 -2
  617. package/dist/src/utils/getFolderStructure.js +3 -3
  618. package/dist/src/utils/getFolderStructure.js.map +1 -1
  619. package/dist/src/utils/getFolderStructure.test.js +4 -4
  620. package/dist/src/utils/getFolderStructure.test.js.map +1 -1
  621. package/dist/src/utils/gitIgnoreParser.d.ts +3 -7
  622. package/dist/src/utils/gitIgnoreParser.js +126 -35
  623. package/dist/src/utils/gitIgnoreParser.js.map +1 -1
  624. package/dist/src/utils/gitIgnoreParser.test.js +69 -38
  625. package/dist/src/utils/gitIgnoreParser.test.js.map +1 -1
  626. package/dist/src/utils/gitUtils.js +2 -2
  627. package/dist/src/utils/gitUtils.js.map +1 -1
  628. package/dist/src/utils/ignorePatterns.d.ts +103 -0
  629. package/dist/src/utils/ignorePatterns.js +220 -0
  630. package/dist/src/utils/ignorePatterns.js.map +1 -0
  631. package/dist/src/utils/ignorePatterns.test.d.ts +6 -0
  632. package/dist/src/utils/ignorePatterns.test.js +250 -0
  633. package/dist/src/utils/ignorePatterns.test.js.map +1 -0
  634. package/dist/src/utils/installationManager.d.ts +16 -0
  635. package/dist/src/utils/installationManager.js +50 -0
  636. package/dist/src/utils/installationManager.js.map +1 -0
  637. package/dist/src/utils/installationManager.test.d.ts +6 -0
  638. package/dist/src/utils/installationManager.test.js +83 -0
  639. package/dist/src/utils/installationManager.test.js.map +1 -0
  640. package/dist/src/utils/language-detection.d.ts +6 -0
  641. package/dist/src/utils/language-detection.js +101 -0
  642. package/dist/src/utils/language-detection.js.map +1 -0
  643. package/dist/src/utils/llm-edit-fixer.d.ts +26 -0
  644. package/dist/src/utils/llm-edit-fixer.js +131 -0
  645. package/dist/src/utils/llm-edit-fixer.js.map +1 -0
  646. package/dist/src/utils/llm-edit-fixer.test.d.ts +6 -0
  647. package/dist/src/utils/llm-edit-fixer.test.js +186 -0
  648. package/dist/src/utils/llm-edit-fixer.test.js.map +1 -0
  649. package/dist/src/utils/memoryDiscovery.d.ts +7 -6
  650. package/dist/src/utils/memoryDiscovery.js +68 -33
  651. package/dist/src/utils/memoryDiscovery.js.map +1 -1
  652. package/dist/src/utils/memoryDiscovery.test.js +88 -26
  653. package/dist/src/utils/memoryDiscovery.test.js.map +1 -1
  654. package/dist/src/utils/memoryImportProcessor.js +15 -22
  655. package/dist/src/utils/memoryImportProcessor.js.map +1 -1
  656. package/dist/src/utils/memoryImportProcessor.test.js +16 -141
  657. package/dist/src/utils/memoryImportProcessor.test.js.map +1 -1
  658. package/dist/src/utils/messageInspectors.d.ts +1 -1
  659. package/dist/src/utils/nextSpeakerChecker.d.ts +3 -3
  660. package/dist/src/utils/nextSpeakerChecker.js +8 -2
  661. package/dist/src/utils/nextSpeakerChecker.js.map +1 -1
  662. package/dist/src/utils/nextSpeakerChecker.test.js +75 -64
  663. package/dist/src/utils/nextSpeakerChecker.test.js.map +1 -1
  664. package/dist/src/utils/partUtils.d.ts +22 -1
  665. package/dist/src/utils/partUtils.js +68 -0
  666. package/dist/src/utils/partUtils.js.map +1 -1
  667. package/dist/src/utils/partUtils.test.js +112 -1
  668. package/dist/src/utils/partUtils.test.js.map +1 -1
  669. package/dist/src/utils/pathReader.d.ts +17 -0
  670. package/dist/src/utils/pathReader.js +92 -0
  671. package/dist/src/utils/pathReader.js.map +1 -0
  672. package/dist/src/utils/pathReader.test.d.ts +6 -0
  673. package/dist/src/utils/pathReader.test.js +363 -0
  674. package/dist/src/utils/pathReader.test.js.map +1 -0
  675. package/dist/src/utils/paths.d.ts +0 -17
  676. package/dist/src/utils/paths.js +2 -28
  677. package/dist/src/utils/paths.js.map +1 -1
  678. package/dist/src/utils/promptIdContext.d.ts +7 -0
  679. package/dist/src/utils/promptIdContext.js +8 -0
  680. package/dist/src/utils/promptIdContext.js.map +1 -0
  681. package/dist/src/utils/quotaErrorDetection.d.ts +1 -1
  682. package/dist/src/utils/retry.d.ts +3 -1
  683. package/dist/src/utils/retry.js +60 -5
  684. package/dist/src/utils/retry.js.map +1 -1
  685. package/dist/src/utils/retry.test.js +35 -3
  686. package/dist/src/utils/retry.test.js.map +1 -1
  687. package/dist/src/utils/schemaValidator.js +15 -1
  688. package/dist/src/utils/schemaValidator.js.map +1 -1
  689. package/dist/src/utils/schemaValidator.test.d.ts +6 -0
  690. package/dist/src/utils/schemaValidator.test.js +113 -0
  691. package/dist/src/utils/schemaValidator.test.js.map +1 -0
  692. package/dist/src/utils/session.js +1 -1
  693. package/dist/src/utils/session.js.map +1 -1
  694. package/dist/src/utils/shell-utils.d.ts +6 -1
  695. package/dist/src/utils/shell-utils.js +51 -30
  696. package/dist/src/utils/shell-utils.js.map +1 -1
  697. package/dist/src/utils/shell-utils.test.js +9 -0
  698. package/dist/src/utils/shell-utils.test.js.map +1 -1
  699. package/dist/src/utils/summarizer.d.ts +2 -2
  700. package/dist/src/utils/summarizer.test.js.map +1 -1
  701. package/dist/src/utils/systemEncoding.js +2 -2
  702. package/dist/src/utils/systemEncoding.js.map +1 -1
  703. package/dist/src/utils/systemEncoding.test.js +2 -2
  704. package/dist/src/utils/systemEncoding.test.js.map +1 -1
  705. package/dist/src/utils/terminalSerializer.d.ts +25 -0
  706. package/dist/src/utils/terminalSerializer.js +432 -0
  707. package/dist/src/utils/terminalSerializer.js.map +1 -0
  708. package/dist/src/utils/terminalSerializer.test.d.ts +6 -0
  709. package/dist/src/utils/terminalSerializer.test.js +176 -0
  710. package/dist/src/utils/terminalSerializer.test.js.map +1 -0
  711. package/dist/src/utils/textUtils.d.ts +5 -0
  712. package/dist/src/utils/textUtils.js +14 -0
  713. package/dist/src/utils/textUtils.js.map +1 -1
  714. package/dist/src/utils/textUtils.test.d.ts +6 -0
  715. package/dist/src/utils/textUtils.test.js +59 -0
  716. package/dist/src/utils/textUtils.test.js.map +1 -0
  717. package/dist/src/utils/thoughtUtils.d.ts +21 -0
  718. package/dist/src/utils/thoughtUtils.js +39 -0
  719. package/dist/src/utils/thoughtUtils.js.map +1 -0
  720. package/dist/src/utils/thoughtUtils.test.d.ts +6 -0
  721. package/dist/src/utils/thoughtUtils.test.js +78 -0
  722. package/dist/src/utils/thoughtUtils.test.js.map +1 -0
  723. package/dist/src/utils/tool-utils.d.ts +19 -0
  724. package/dist/src/utils/tool-utils.js +58 -0
  725. package/dist/src/utils/tool-utils.js.map +1 -0
  726. package/dist/src/utils/tool-utils.test.d.ts +6 -0
  727. package/dist/src/utils/tool-utils.test.js +61 -0
  728. package/dist/src/utils/tool-utils.test.js.map +1 -0
  729. package/dist/src/utils/userAccountManager.d.ts +20 -0
  730. package/dist/src/utils/userAccountManager.js +114 -0
  731. package/dist/src/utils/userAccountManager.js.map +1 -0
  732. package/dist/src/utils/userAccountManager.test.d.ts +6 -0
  733. package/dist/src/utils/{user_account.test.js → userAccountManager.test.js} +33 -30
  734. package/dist/src/utils/userAccountManager.test.js.map +1 -0
  735. package/dist/src/utils/workspaceContext.js +13 -7
  736. package/dist/src/utils/workspaceContext.js.map +1 -1
  737. package/dist/src/utils/workspaceContext.test.js +41 -16
  738. package/dist/src/utils/workspaceContext.test.js.map +1 -1
  739. package/dist/tsconfig.tsbuildinfo +1 -1
  740. package/package.json +18 -9
  741. package/dist/src/core/modelCheck.d.ts +0 -14
  742. package/dist/src/core/modelCheck.js +0 -62
  743. package/dist/src/core/modelCheck.js.map +0 -1
  744. package/dist/src/test-utils/tools.d.ts +0 -44
  745. package/dist/src/test-utils/tools.js.map +0 -1
  746. package/dist/src/utils/flashFallback.integration.test.js.map +0 -1
  747. package/dist/src/utils/user_account.d.ts +0 -9
  748. package/dist/src/utils/user_account.js +0 -109
  749. package/dist/src/utils/user_account.js.map +0 -1
  750. package/dist/src/utils/user_account.test.js.map +0 -1
  751. package/dist/src/utils/user_id.d.ts +0 -11
  752. package/dist/src/utils/user_id.js +0 -49
  753. package/dist/src/utils/user_id.js.map +0 -1
  754. package/dist/src/utils/user_id.test.js +0 -21
  755. package/dist/src/utils/user_id.test.js.map +0 -1
  756. /package/dist/src/{utils/flashFallback.integration.test.d.ts → agents/executor.test.d.ts} +0 -0
  757. /package/dist/src/{utils/user_account.test.d.ts → agents/invocation.test.d.ts} +0 -0
  758. /package/dist/src/{utils/user_id.test.d.ts → agents/registry.test.d.ts} +0 -0
@@ -0,0 +1,515 @@
1
+ /**
2
+ * @license
3
+ * Copyright 2025 Google LLC
4
+ * SPDX-License-Identifier: Apache-2.0
5
+ */
6
+ import { describe, it, expect, beforeEach } from 'vitest';
7
+ import { PolicyEngine } from './policy-engine.js';
8
+ import { PolicyDecision, } from './types.js';
9
+ describe('PolicyEngine', () => {
10
+ let engine;
11
+ beforeEach(() => {
12
+ engine = new PolicyEngine();
13
+ });
14
+ describe('constructor', () => {
15
+ it('should use default config when none provided', () => {
16
+ const decision = engine.check({ name: 'test' });
17
+ expect(decision).toBe(PolicyDecision.ASK_USER);
18
+ });
19
+ it('should respect custom default decision', () => {
20
+ engine = new PolicyEngine({ defaultDecision: PolicyDecision.DENY });
21
+ const decision = engine.check({ name: 'test' });
22
+ expect(decision).toBe(PolicyDecision.DENY);
23
+ });
24
+ it('should sort rules by priority', () => {
25
+ const rules = [
26
+ { toolName: 'tool1', decision: PolicyDecision.DENY, priority: 1 },
27
+ { toolName: 'tool2', decision: PolicyDecision.ALLOW, priority: 10 },
28
+ { toolName: 'tool3', decision: PolicyDecision.ASK_USER, priority: 5 },
29
+ ];
30
+ engine = new PolicyEngine({ rules });
31
+ const sortedRules = engine.getRules();
32
+ expect(sortedRules[0].priority).toBe(10);
33
+ expect(sortedRules[1].priority).toBe(5);
34
+ expect(sortedRules[2].priority).toBe(1);
35
+ });
36
+ });
37
+ describe('check', () => {
38
+ it('should match tool by name', () => {
39
+ const rules = [
40
+ { toolName: 'shell', decision: PolicyDecision.ALLOW },
41
+ { toolName: 'edit', decision: PolicyDecision.DENY },
42
+ ];
43
+ engine = new PolicyEngine({ rules });
44
+ expect(engine.check({ name: 'shell' })).toBe(PolicyDecision.ALLOW);
45
+ expect(engine.check({ name: 'edit' })).toBe(PolicyDecision.DENY);
46
+ expect(engine.check({ name: 'other' })).toBe(PolicyDecision.ASK_USER);
47
+ });
48
+ it('should match by args pattern', () => {
49
+ const rules = [
50
+ {
51
+ toolName: 'shell',
52
+ argsPattern: /rm -rf/,
53
+ decision: PolicyDecision.DENY,
54
+ },
55
+ {
56
+ toolName: 'shell',
57
+ decision: PolicyDecision.ALLOW,
58
+ },
59
+ ];
60
+ engine = new PolicyEngine({ rules });
61
+ const dangerousCall = {
62
+ name: 'shell',
63
+ args: { command: 'rm -rf /' },
64
+ };
65
+ const safeCall = {
66
+ name: 'shell',
67
+ args: { command: 'ls -la' },
68
+ };
69
+ expect(engine.check(dangerousCall)).toBe(PolicyDecision.DENY);
70
+ expect(engine.check(safeCall)).toBe(PolicyDecision.ALLOW);
71
+ });
72
+ it('should apply rules by priority', () => {
73
+ const rules = [
74
+ { toolName: 'shell', decision: PolicyDecision.DENY, priority: 1 },
75
+ { toolName: 'shell', decision: PolicyDecision.ALLOW, priority: 10 },
76
+ ];
77
+ engine = new PolicyEngine({ rules });
78
+ // Higher priority rule (ALLOW) should win
79
+ expect(engine.check({ name: 'shell' })).toBe(PolicyDecision.ALLOW);
80
+ });
81
+ it('should apply wildcard rules (no toolName)', () => {
82
+ const rules = [
83
+ { decision: PolicyDecision.DENY }, // Applies to all tools
84
+ { toolName: 'safe-tool', decision: PolicyDecision.ALLOW, priority: 10 },
85
+ ];
86
+ engine = new PolicyEngine({ rules });
87
+ expect(engine.check({ name: 'safe-tool' })).toBe(PolicyDecision.ALLOW);
88
+ expect(engine.check({ name: 'any-other-tool' })).toBe(PolicyDecision.DENY);
89
+ });
90
+ it('should handle non-interactive mode', () => {
91
+ const config = {
92
+ nonInteractive: true,
93
+ rules: [
94
+ { toolName: 'interactive-tool', decision: PolicyDecision.ASK_USER },
95
+ { toolName: 'allowed-tool', decision: PolicyDecision.ALLOW },
96
+ ],
97
+ };
98
+ engine = new PolicyEngine(config);
99
+ // ASK_USER should become DENY in non-interactive mode
100
+ expect(engine.check({ name: 'interactive-tool' })).toBe(PolicyDecision.DENY);
101
+ // ALLOW should remain ALLOW
102
+ expect(engine.check({ name: 'allowed-tool' })).toBe(PolicyDecision.ALLOW);
103
+ // Default ASK_USER should also become DENY
104
+ expect(engine.check({ name: 'unknown-tool' })).toBe(PolicyDecision.DENY);
105
+ });
106
+ });
107
+ describe('addRule', () => {
108
+ it('should add a new rule and maintain priority order', () => {
109
+ engine.addRule({
110
+ toolName: 'tool1',
111
+ decision: PolicyDecision.ALLOW,
112
+ priority: 5,
113
+ });
114
+ engine.addRule({
115
+ toolName: 'tool2',
116
+ decision: PolicyDecision.DENY,
117
+ priority: 10,
118
+ });
119
+ engine.addRule({
120
+ toolName: 'tool3',
121
+ decision: PolicyDecision.ASK_USER,
122
+ priority: 1,
123
+ });
124
+ const rules = engine.getRules();
125
+ expect(rules).toHaveLength(3);
126
+ expect(rules[0].priority).toBe(10);
127
+ expect(rules[1].priority).toBe(5);
128
+ expect(rules[2].priority).toBe(1);
129
+ });
130
+ it('should apply newly added rules', () => {
131
+ expect(engine.check({ name: 'new-tool' })).toBe(PolicyDecision.ASK_USER);
132
+ engine.addRule({ toolName: 'new-tool', decision: PolicyDecision.ALLOW });
133
+ expect(engine.check({ name: 'new-tool' })).toBe(PolicyDecision.ALLOW);
134
+ });
135
+ });
136
+ describe('removeRulesForTool', () => {
137
+ it('should remove rules for specific tool', () => {
138
+ engine.addRule({ toolName: 'tool1', decision: PolicyDecision.ALLOW });
139
+ engine.addRule({ toolName: 'tool2', decision: PolicyDecision.DENY });
140
+ engine.addRule({
141
+ toolName: 'tool1',
142
+ decision: PolicyDecision.ASK_USER,
143
+ priority: 10,
144
+ });
145
+ expect(engine.getRules()).toHaveLength(3);
146
+ engine.removeRulesForTool('tool1');
147
+ const remainingRules = engine.getRules();
148
+ expect(remainingRules).toHaveLength(1);
149
+ expect(remainingRules.some((r) => r.toolName === 'tool1')).toBe(false);
150
+ expect(remainingRules.some((r) => r.toolName === 'tool2')).toBe(true);
151
+ });
152
+ it('should handle removing non-existent tool', () => {
153
+ engine.addRule({ toolName: 'existing', decision: PolicyDecision.ALLOW });
154
+ expect(() => engine.removeRulesForTool('non-existent')).not.toThrow();
155
+ expect(engine.getRules()).toHaveLength(1);
156
+ });
157
+ });
158
+ describe('getRules', () => {
159
+ it('should return readonly array of rules', () => {
160
+ const rules = [
161
+ { toolName: 'tool1', decision: PolicyDecision.ALLOW },
162
+ { toolName: 'tool2', decision: PolicyDecision.DENY },
163
+ ];
164
+ engine = new PolicyEngine({ rules });
165
+ const retrievedRules = engine.getRules();
166
+ expect(retrievedRules).toHaveLength(2);
167
+ expect(retrievedRules[0].toolName).toBe('tool1');
168
+ expect(retrievedRules[1].toolName).toBe('tool2');
169
+ });
170
+ });
171
+ describe('MCP server wildcard patterns', () => {
172
+ it('should match MCP server wildcard patterns', () => {
173
+ const rules = [
174
+ {
175
+ toolName: 'my-server__*',
176
+ decision: PolicyDecision.ALLOW,
177
+ priority: 10,
178
+ },
179
+ {
180
+ toolName: 'blocked-server__*',
181
+ decision: PolicyDecision.DENY,
182
+ priority: 20,
183
+ },
184
+ ];
185
+ engine = new PolicyEngine({ rules });
186
+ // Should match my-server tools
187
+ expect(engine.check({ name: 'my-server__tool1' })).toBe(PolicyDecision.ALLOW);
188
+ expect(engine.check({ name: 'my-server__another_tool' })).toBe(PolicyDecision.ALLOW);
189
+ // Should match blocked-server tools
190
+ expect(engine.check({ name: 'blocked-server__tool1' })).toBe(PolicyDecision.DENY);
191
+ expect(engine.check({ name: 'blocked-server__dangerous' })).toBe(PolicyDecision.DENY);
192
+ // Should not match other patterns
193
+ expect(engine.check({ name: 'other-server__tool' })).toBe(PolicyDecision.ASK_USER);
194
+ expect(engine.check({ name: 'my-server-tool' })).toBe(PolicyDecision.ASK_USER); // No __ separator
195
+ expect(engine.check({ name: 'my-server' })).toBe(PolicyDecision.ASK_USER); // No tool name
196
+ });
197
+ it('should prioritize specific tool rules over server wildcards', () => {
198
+ const rules = [
199
+ {
200
+ toolName: 'my-server__*',
201
+ decision: PolicyDecision.ALLOW,
202
+ priority: 10,
203
+ },
204
+ {
205
+ toolName: 'my-server__dangerous-tool',
206
+ decision: PolicyDecision.DENY,
207
+ priority: 20,
208
+ },
209
+ ];
210
+ engine = new PolicyEngine({ rules });
211
+ // Specific tool deny should override server allow
212
+ expect(engine.check({ name: 'my-server__dangerous-tool' })).toBe(PolicyDecision.DENY);
213
+ expect(engine.check({ name: 'my-server__safe-tool' })).toBe(PolicyDecision.ALLOW);
214
+ });
215
+ });
216
+ describe('complex scenarios', () => {
217
+ it('should handle multiple matching rules with different priorities', () => {
218
+ const rules = [
219
+ { decision: PolicyDecision.DENY, priority: 0 }, // Default deny all
220
+ { toolName: 'shell', decision: PolicyDecision.ASK_USER, priority: 5 },
221
+ {
222
+ toolName: 'shell',
223
+ argsPattern: /"command":"ls/,
224
+ decision: PolicyDecision.ALLOW,
225
+ priority: 10,
226
+ },
227
+ ];
228
+ engine = new PolicyEngine({ rules });
229
+ // Matches highest priority rule (ls command)
230
+ expect(engine.check({ name: 'shell', args: { command: 'ls -la' } })).toBe(PolicyDecision.ALLOW);
231
+ // Matches middle priority rule (shell without ls)
232
+ expect(engine.check({ name: 'shell', args: { command: 'pwd' } })).toBe(PolicyDecision.ASK_USER);
233
+ // Matches lowest priority rule (not shell)
234
+ expect(engine.check({ name: 'edit' })).toBe(PolicyDecision.DENY);
235
+ });
236
+ it('should handle tools with no args', () => {
237
+ const rules = [
238
+ {
239
+ toolName: 'read',
240
+ argsPattern: /secret/,
241
+ decision: PolicyDecision.DENY,
242
+ },
243
+ ];
244
+ engine = new PolicyEngine({ rules });
245
+ // Tool call without args should not match pattern
246
+ expect(engine.check({ name: 'read' })).toBe(PolicyDecision.ASK_USER);
247
+ // Tool call with args not matching pattern
248
+ expect(engine.check({ name: 'read', args: { file: 'public.txt' } })).toBe(PolicyDecision.ASK_USER);
249
+ // Tool call with args matching pattern
250
+ expect(engine.check({ name: 'read', args: { file: 'secret.txt' } })).toBe(PolicyDecision.DENY);
251
+ });
252
+ it('should match args pattern regardless of property order', () => {
253
+ const rules = [
254
+ {
255
+ toolName: 'shell',
256
+ // Pattern matches the stable stringified format
257
+ argsPattern: /"command":"rm[^"]*-rf/,
258
+ decision: PolicyDecision.DENY,
259
+ },
260
+ ];
261
+ engine = new PolicyEngine({ rules });
262
+ // Same args with different property order should both match
263
+ const args1 = { command: 'rm -rf /', path: '/home' };
264
+ const args2 = { path: '/home', command: 'rm -rf /' };
265
+ expect(engine.check({ name: 'shell', args: args1 })).toBe(PolicyDecision.DENY);
266
+ expect(engine.check({ name: 'shell', args: args2 })).toBe(PolicyDecision.DENY);
267
+ // Verify safe command doesn't match
268
+ const safeArgs = { command: 'ls -la', path: '/home' };
269
+ expect(engine.check({ name: 'shell', args: safeArgs })).toBe(PolicyDecision.ASK_USER);
270
+ });
271
+ it('should handle nested objects in args with stable stringification', () => {
272
+ const rules = [
273
+ {
274
+ toolName: 'api',
275
+ argsPattern: /"sensitive":true/,
276
+ decision: PolicyDecision.DENY,
277
+ },
278
+ ];
279
+ engine = new PolicyEngine({ rules });
280
+ // Nested objects with different key orders should match consistently
281
+ const args1 = {
282
+ data: { sensitive: true, value: 'secret' },
283
+ method: 'POST',
284
+ };
285
+ const args2 = {
286
+ method: 'POST',
287
+ data: { value: 'secret', sensitive: true },
288
+ };
289
+ expect(engine.check({ name: 'api', args: args1 })).toBe(PolicyDecision.DENY);
290
+ expect(engine.check({ name: 'api', args: args2 })).toBe(PolicyDecision.DENY);
291
+ });
292
+ it('should handle circular references without stack overflow', () => {
293
+ const rules = [
294
+ {
295
+ toolName: 'test',
296
+ argsPattern: /\[Circular\]/,
297
+ decision: PolicyDecision.DENY,
298
+ },
299
+ ];
300
+ engine = new PolicyEngine({ rules });
301
+ const circularArgs = {
302
+ name: 'test',
303
+ data: {},
304
+ };
305
+ // Create circular reference - TypeScript allows this since data is Record<string, unknown>
306
+ circularArgs.data['self'] =
307
+ circularArgs.data;
308
+ // Should not throw stack overflow error
309
+ expect(() => engine.check({ name: 'test', args: circularArgs })).not.toThrow();
310
+ // Should detect the circular reference pattern
311
+ expect(engine.check({ name: 'test', args: circularArgs })).toBe(PolicyDecision.DENY);
312
+ // Non-circular object should not match
313
+ const normalArgs = { name: 'test', data: { value: 'normal' } };
314
+ expect(engine.check({ name: 'test', args: normalArgs })).toBe(PolicyDecision.ASK_USER);
315
+ });
316
+ it('should handle deep circular references', () => {
317
+ const rules = [
318
+ {
319
+ toolName: 'deep',
320
+ argsPattern: /\[Circular\]/,
321
+ decision: PolicyDecision.DENY,
322
+ },
323
+ ];
324
+ engine = new PolicyEngine({ rules });
325
+ const deepCircular = {
326
+ level1: {
327
+ level2: {
328
+ level3: {},
329
+ },
330
+ },
331
+ };
332
+ // Create circular reference with proper type assertions
333
+ const level3 = deepCircular.level1.level2.level3;
334
+ level3['back'] = deepCircular.level1;
335
+ // Should handle without stack overflow
336
+ expect(() => engine.check({ name: 'deep', args: deepCircular })).not.toThrow();
337
+ // Should detect the circular reference
338
+ expect(engine.check({ name: 'deep', args: deepCircular })).toBe(PolicyDecision.DENY);
339
+ });
340
+ it('should handle repeated non-circular objects correctly', () => {
341
+ const rules = [
342
+ {
343
+ toolName: 'test',
344
+ argsPattern: /\[Circular\]/,
345
+ decision: PolicyDecision.DENY,
346
+ },
347
+ {
348
+ toolName: 'test',
349
+ argsPattern: /"value":"shared"/,
350
+ decision: PolicyDecision.ALLOW,
351
+ priority: 10,
352
+ },
353
+ ];
354
+ engine = new PolicyEngine({ rules });
355
+ // Create an object with repeated references but no cycles
356
+ const sharedObj = { value: 'shared' };
357
+ const args = {
358
+ first: sharedObj,
359
+ second: sharedObj,
360
+ third: { nested: sharedObj },
361
+ };
362
+ // Should NOT mark repeated objects as circular, and should match the shared value pattern
363
+ expect(engine.check({ name: 'test', args })).toBe(PolicyDecision.ALLOW);
364
+ });
365
+ it('should omit undefined and function values from objects', () => {
366
+ const rules = [
367
+ {
368
+ toolName: 'test',
369
+ argsPattern: /"definedValue":"test"/,
370
+ decision: PolicyDecision.ALLOW,
371
+ },
372
+ ];
373
+ engine = new PolicyEngine({ rules });
374
+ const args = {
375
+ definedValue: 'test',
376
+ undefinedValue: undefined,
377
+ functionValue: () => 'hello',
378
+ nullValue: null,
379
+ };
380
+ // Should match pattern with defined value, undefined and functions omitted
381
+ expect(engine.check({ name: 'test', args })).toBe(PolicyDecision.ALLOW);
382
+ // Check that the pattern would NOT match if undefined was included
383
+ const rulesWithUndefined = [
384
+ {
385
+ toolName: 'test',
386
+ argsPattern: /undefinedValue/,
387
+ decision: PolicyDecision.DENY,
388
+ },
389
+ ];
390
+ engine = new PolicyEngine({ rules: rulesWithUndefined });
391
+ expect(engine.check({ name: 'test', args })).toBe(PolicyDecision.ASK_USER);
392
+ // Check that the pattern would NOT match if function was included
393
+ const rulesWithFunction = [
394
+ {
395
+ toolName: 'test',
396
+ argsPattern: /functionValue/,
397
+ decision: PolicyDecision.DENY,
398
+ },
399
+ ];
400
+ engine = new PolicyEngine({ rules: rulesWithFunction });
401
+ expect(engine.check({ name: 'test', args })).toBe(PolicyDecision.ASK_USER);
402
+ });
403
+ it('should convert undefined and functions to null in arrays', () => {
404
+ const rules = [
405
+ {
406
+ toolName: 'test',
407
+ argsPattern: /\["value",null,null,null\]/,
408
+ decision: PolicyDecision.ALLOW,
409
+ },
410
+ ];
411
+ engine = new PolicyEngine({ rules });
412
+ const args = {
413
+ array: ['value', undefined, () => 'hello', null],
414
+ };
415
+ // Should match pattern with undefined and functions converted to null
416
+ expect(engine.check({ name: 'test', args })).toBe(PolicyDecision.ALLOW);
417
+ });
418
+ it('should produce valid JSON for all inputs', () => {
419
+ const testCases = [
420
+ { input: { simple: 'string' }, desc: 'simple object' },
421
+ {
422
+ input: { nested: { deep: { value: 123 } } },
423
+ desc: 'nested object',
424
+ },
425
+ { input: { data: [1, 2, 3] }, desc: 'simple array' },
426
+ { input: { mixed: [1, { a: 'b' }, null] }, desc: 'mixed array' },
427
+ {
428
+ input: { undef: undefined, func: () => { }, normal: 'value' },
429
+ desc: 'object with undefined and function',
430
+ },
431
+ {
432
+ input: { data: ['a', undefined, () => { }, null] },
433
+ desc: 'array with undefined and function',
434
+ },
435
+ ];
436
+ for (const { input } of testCases) {
437
+ const rules = [
438
+ {
439
+ toolName: 'test',
440
+ argsPattern: /.*/,
441
+ decision: PolicyDecision.ALLOW,
442
+ },
443
+ ];
444
+ engine = new PolicyEngine({ rules });
445
+ // Should not throw when checking (which internally uses stableStringify)
446
+ expect(() => engine.check({ name: 'test', args: input })).not.toThrow();
447
+ // The check should succeed
448
+ expect(engine.check({ name: 'test', args: input })).toBe(PolicyDecision.ALLOW);
449
+ }
450
+ });
451
+ it('should respect toJSON methods on objects', () => {
452
+ const rules = [
453
+ {
454
+ toolName: 'test',
455
+ argsPattern: /"sanitized":"safe"/,
456
+ decision: PolicyDecision.ALLOW,
457
+ },
458
+ {
459
+ toolName: 'test',
460
+ argsPattern: /"dangerous":"data"/,
461
+ decision: PolicyDecision.DENY,
462
+ },
463
+ ];
464
+ engine = new PolicyEngine({ rules });
465
+ // Object with toJSON that sanitizes output
466
+ const args = {
467
+ data: {
468
+ dangerous: 'data',
469
+ toJSON: () => ({ sanitized: 'safe' }),
470
+ },
471
+ };
472
+ // Should match the sanitized pattern, not the dangerous one
473
+ expect(engine.check({ name: 'test', args })).toBe(PolicyDecision.ALLOW);
474
+ });
475
+ it('should handle toJSON that returns primitives', () => {
476
+ const rules = [
477
+ {
478
+ toolName: 'test',
479
+ argsPattern: /"value":"string-value"/,
480
+ decision: PolicyDecision.ALLOW,
481
+ },
482
+ ];
483
+ engine = new PolicyEngine({ rules });
484
+ const args = {
485
+ value: {
486
+ complex: 'object',
487
+ toJSON: () => 'string-value',
488
+ },
489
+ };
490
+ // toJSON returns a string, which should be properly stringified
491
+ expect(engine.check({ name: 'test', args })).toBe(PolicyDecision.ALLOW);
492
+ });
493
+ it('should handle toJSON that throws an error', () => {
494
+ const rules = [
495
+ {
496
+ toolName: 'test',
497
+ argsPattern: /"fallback":"value"/,
498
+ decision: PolicyDecision.ALLOW,
499
+ },
500
+ ];
501
+ engine = new PolicyEngine({ rules });
502
+ const args = {
503
+ data: {
504
+ fallback: 'value',
505
+ toJSON: () => {
506
+ throw new Error('toJSON error');
507
+ },
508
+ },
509
+ };
510
+ // Should fall back to regular object serialization when toJSON throws
511
+ expect(engine.check({ name: 'test', args })).toBe(PolicyDecision.ALLOW);
512
+ });
513
+ });
514
+ });
515
+ //# sourceMappingURL=policy-engine.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"policy-engine.test.js","sourceRoot":"","sources":["../../../src/policy/policy-engine.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,58 @@
1
+ /**
2
+ * @license
3
+ * Copyright 2025 Google LLC
4
+ * SPDX-License-Identifier: Apache-2.0
5
+ */
6
+ /**
7
+ * Produces a stable, deterministic JSON string representation with sorted keys.
8
+ *
9
+ * This method is critical for security policy matching. It ensures that the same
10
+ * object always produces the same string representation, regardless of property
11
+ * insertion order, which could vary across different JavaScript engines or
12
+ * runtime conditions.
13
+ *
14
+ * Key behaviors:
15
+ * 1. **Sorted Keys**: Object properties are always serialized in alphabetical order,
16
+ * ensuring deterministic output for pattern matching.
17
+ *
18
+ * 2. **Circular Reference Protection**: Uses ancestor chain tracking (not just
19
+ * object identity) to detect true circular references while correctly handling
20
+ * repeated non-circular object references. Circular references are replaced
21
+ * with "[Circular]" to prevent stack overflow attacks.
22
+ *
23
+ * 3. **JSON Spec Compliance**:
24
+ * - undefined values: Omitted from objects, converted to null in arrays
25
+ * - Functions: Omitted from objects, converted to null in arrays
26
+ * - toJSON methods: Respected and called when present (per JSON.stringify spec)
27
+ *
28
+ * 4. **Security Considerations**:
29
+ * - Prevents DoS via circular references that would cause infinite recursion
30
+ * - Ensures consistent policy rule matching by normalizing property order
31
+ * - Respects toJSON for objects that sanitize their output
32
+ * - Handles toJSON methods that throw errors gracefully
33
+ *
34
+ * @param obj - The object to stringify (typically toolCall.args)
35
+ * @returns A deterministic JSON string representation
36
+ *
37
+ * @example
38
+ * // Different property orders produce the same output:
39
+ * stableStringify({b: 2, a: 1}) === stableStringify({a: 1, b: 2})
40
+ * // Returns: '{"a":1,"b":2}'
41
+ *
42
+ * @example
43
+ * // Circular references are handled safely:
44
+ * const obj = {a: 1};
45
+ * obj.self = obj;
46
+ * stableStringify(obj)
47
+ * // Returns: '{"a":1,"self":"[Circular]"}'
48
+ *
49
+ * @example
50
+ * // toJSON methods are respected:
51
+ * const obj = {
52
+ * sensitive: 'secret',
53
+ * toJSON: () => ({ safe: 'data' })
54
+ * };
55
+ * stableStringify(obj)
56
+ * // Returns: '{"safe":"data"}'
57
+ */
58
+ export declare function stableStringify(obj: unknown): string;