plugin-agent-orchestrator 1.1.7 → 1.2.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 (413) hide show
  1. package/README.md +207 -204
  2. package/client-v2.d.ts +2 -2
  3. package/client-v2.js +1 -1
  4. package/client.d.ts +2 -2
  5. package/client.js +1 -1
  6. package/dist/client/117.2e4cb0477da3db1f.js +10 -0
  7. package/dist/client/253.93deb9e0192e76a5.js +10 -0
  8. package/dist/client/325.8f7f509bdb35e142.js +10 -0
  9. package/dist/client/404.498d2d9516dd1dce.js +10 -0
  10. package/dist/client/418.6f01da17774a5a25.js +10 -0
  11. package/dist/client/53.774ff07505d521fa.js +10 -0
  12. package/dist/client/619.e342b0fa467d39ca.js +10 -0
  13. package/dist/client/627.fdd60bcc0f3a9cf6.js +10 -0
  14. package/dist/client/652.477e21bfff67bc1c.js +10 -0
  15. package/dist/client/981.e0546ffc34afedcd.js +10 -0
  16. package/dist/client/993.5d04b510835ab0d2.js +10 -0
  17. package/dist/client/index.js +1 -1
  18. package/dist/client-v2/117.ccf43ae8631f7d74.js +10 -0
  19. package/dist/client-v2/214.cdf76752053a8990.js +10 -0
  20. package/dist/client-v2/253.1198df22f5baf304.js +10 -0
  21. package/dist/client-v2/264.78887ff88f969467.js +10 -0
  22. package/dist/client-v2/325.fafe5a6e83ba9cb3.js +10 -0
  23. package/dist/client-v2/404.9ba964c28a151c81.js +10 -0
  24. package/dist/client-v2/{41.3deb9e57a0f64fc4.js → 41.b28cf7a675a603d1.js} +1 -1
  25. package/dist/client-v2/418.55b6b28cda8bb5f3.js +10 -0
  26. package/dist/client-v2/{53.349fff8db80b19d4.js → 53.282081f97e4308c6.js} +1 -1
  27. package/dist/client-v2/{619.0a2144aaffefe018.js → 619.8c03913873785fb6.js} +1 -1
  28. package/dist/client-v2/627.e16f4a0dd596c3e6.js +10 -0
  29. package/dist/client-v2/652.1a48364774d5383a.js +10 -0
  30. package/dist/client-v2/{70.ffff2997c10fd4b0.js → 70.9166ed70906d041f.js} +1 -1
  31. package/dist/client-v2/{981.e4a1f41cfc94a856.js → 981.a81521f0296c7db8.js} +1 -1
  32. package/dist/client-v2/993.ca5b28f1e2b4c1ef.js +10 -0
  33. package/dist/client-v2/index.js +1 -1
  34. package/dist/externalVersion.js +10 -7
  35. package/dist/locale/en-US.json +229 -1
  36. package/dist/locale/zh-CN.json +229 -1
  37. package/dist/node_modules/adm-zip/adm-zip.js +1 -1
  38. package/dist/node_modules/adm-zip/package.json +1 -1
  39. package/dist/node_modules/ajv/package.json +1 -1
  40. package/dist/node_modules/zod/index.cjs +1 -1
  41. package/dist/node_modules/zod/package.json +1 -1
  42. package/dist/server/collections/agent-execution-spans.js +145 -6
  43. package/dist/server/collections/agent-governance-audit-events.js +47 -0
  44. package/dist/server/collections/agent-governance-policies.js +47 -0
  45. package/dist/server/collections/agent-governance-policy-versions.js +48 -0
  46. package/dist/server/collections/agent-governance-prompt-bindings.js +50 -0
  47. package/dist/server/collections/agent-loop-runs.js +23 -5
  48. package/dist/server/migrations/20261110000000-add-usage-pricing-snapshots.js +117 -0
  49. package/dist/server/migrations/20261110010000-add-usage-department-attribution.js +54 -0
  50. package/dist/server/plugin.js +114 -33
  51. package/dist/server/resources/agent-governance.js +192 -0
  52. package/dist/server/resources/agent-harness-profile.js +11 -3
  53. package/dist/server/resources/agent-monitor.js +109 -339
  54. package/dist/server/resources/agent-usage.js +423 -0
  55. package/dist/server/resources/native-monitor-format.js +179 -0
  56. package/dist/server/resources/tracing.js +35 -12
  57. package/dist/server/services/AgentGovernanceService.js +500 -0
  58. package/dist/server/services/DepartmentAttribution.js +65 -0
  59. package/dist/server/services/ExecutionSpanService.js +96 -3
  60. package/dist/server/services/GovernanceAdmission.js +211 -0
  61. package/dist/server/services/HarnessCapabilities.js +118 -0
  62. package/dist/server/services/LoopBudgetService.js +29 -11
  63. package/dist/server/services/LoopRunRepository.js +15 -6
  64. package/dist/server/services/LoopRunStateMachine.js +18 -7
  65. package/dist/server/services/LoopTriggerService.js +1 -1
  66. package/dist/server/services/LoopWorkerService.js +66 -32
  67. package/dist/server/services/ManagedPromptProtection.js +99 -0
  68. package/dist/server/services/NativeAgentMonitorSyncService.js +584 -0
  69. package/dist/server/services/NativeSubAgentObserver.js +141 -508
  70. package/dist/server/services/NativeUsageAttribution.js +97 -0
  71. package/dist/server/services/TokenTracker.js +787 -104
  72. package/dist/server/services/TracingRetentionPolicy.js +66 -0
  73. package/dist/server/services/VerificationService.js +18 -8
  74. package/dist/server/skill-hub/sandbox-config.json +6 -6
  75. package/dist/server/utils/ensure-indexes.js +14 -5
  76. package/package.json +63 -53
  77. package/server.d.ts +2 -2
  78. package/server.js +1 -1
  79. package/src/client/AgentRunsTab.tsx +2 -2
  80. package/src/client/ApprovalsTab.tsx +2 -2
  81. package/src/client/HarnessProfilesTab.tsx +2 -2
  82. package/src/client/OrchestratorSettings.tsx +152 -152
  83. package/src/client/SkillPages.tsx +41 -0
  84. package/src/client/__tests__/embedded-settings.test.tsx +232 -0
  85. package/src/client/hooks/useRunEventStream.ts +76 -76
  86. package/src/client/index.tsx +2 -2
  87. package/src/client/plugin.tsx +76 -32
  88. package/src/client/skill-hub/components/ExecutionHistory.tsx +200 -200
  89. package/src/client/skill-hub/components/GitSkillImport.tsx +562 -562
  90. package/src/client/skill-hub/components/LoopSettings.tsx +331 -331
  91. package/src/client/skill-hub/components/SkillEditor.tsx +460 -460
  92. package/src/client/skill-hub/components/SkillManager.tsx +194 -194
  93. package/src/client/skill-hub/components/SkillMetrics.tsx +162 -162
  94. package/src/client/skill-hub/components/SkillTestPanel.tsx +141 -141
  95. package/src/client/skill-hub/index.tsx +6 -6
  96. package/src/client/skill-hub/locale.ts +16 -16
  97. package/src/client/skill-hub/tools/InteractionSchemasProvider.tsx +132 -132
  98. package/src/client/skill-hub/tools/SkillHubCard.tsx +104 -104
  99. package/src/client/skill-hub/tools/loopTemplates.ts +52 -52
  100. package/src/client/skill-hub/tools/registerSkillLoopCards.ts +71 -71
  101. package/src/client/skill-hub/utils/jsonFields.ts +41 -41
  102. package/src/client-v2/__tests__/embedded-settings.test.tsx +193 -0
  103. package/src/client-v2/components/AIEmployeeSelect.tsx +47 -47
  104. package/src/client-v2/components/AIEmployeesContext.tsx +97 -97
  105. package/src/client-v2/components/AgentBindingsTab.tsx +269 -269
  106. package/src/client-v2/components/AgentRunsTab.tsx +92 -83
  107. package/src/client-v2/components/ApprovalsTab.tsx +337 -337
  108. package/src/client-v2/components/EmployeeGovernanceTab.tsx +702 -0
  109. package/src/client-v2/components/HarnessProfilesTab.tsx +704 -541
  110. package/src/client-v2/components/KnowledgeAccessTab.tsx +116 -116
  111. package/src/client-v2/components/RetrievalTraceTab.tsx +162 -162
  112. package/src/client-v2/components/UsageGovernanceTab.tsx +386 -0
  113. package/src/client-v2/index.tsx +1 -1
  114. package/src/client-v2/pages/AgentBindingsPage.tsx +22 -13
  115. package/src/client-v2/pages/ApprovalsPage.tsx +19 -10
  116. package/src/client-v2/pages/EmployeeGovernancePage.tsx +22 -0
  117. package/src/client-v2/pages/ExecutionHistoryPage.tsx +19 -10
  118. package/src/client-v2/pages/HarnessProfilesPage.tsx +19 -10
  119. package/src/client-v2/pages/KnowledgeAccessPage.tsx +19 -10
  120. package/src/client-v2/pages/LoopSettingsPage.tsx +19 -10
  121. package/src/client-v2/pages/MemoryInspectorPage.tsx +22 -13
  122. package/src/client-v2/pages/RetrievalTracePage.tsx +19 -10
  123. package/src/client-v2/pages/RulesPage.tsx +22 -13
  124. package/src/client-v2/pages/SkillDefinitionsPage.tsx +19 -10
  125. package/src/client-v2/pages/SkillMetricsPage.tsx +19 -10
  126. package/src/client-v2/pages/TracingPage.tsx +22 -13
  127. package/src/client-v2/pages/UsageGovernancePage.tsx +22 -0
  128. package/src/client-v2/plugin.tsx +139 -99
  129. package/src/client-v2/skill-hub/components/ExecutionHistory.tsx +196 -196
  130. package/src/client-v2/skill-hub/components/FileLinkList.tsx +37 -37
  131. package/src/client-v2/skill-hub/components/GitSkillImport.tsx +539 -539
  132. package/src/client-v2/skill-hub/components/LoopSettings.tsx +331 -331
  133. package/src/client-v2/skill-hub/components/SkillEditor.tsx +453 -453
  134. package/src/client-v2/skill-hub/components/SkillManager.tsx +191 -174
  135. package/src/client-v2/skill-hub/components/SkillMetrics.tsx +162 -162
  136. package/src/client-v2/skill-hub/components/SkillTestPanel.tsx +135 -135
  137. package/src/client-v2/skill-hub/locale.ts +13 -13
  138. package/src/client-v2/skill-hub/tools/InteractionSchemasProvider.tsx +62 -0
  139. package/src/client-v2/skill-hub/tools/SkillHubCard.tsx +104 -0
  140. package/src/client-v2/skill-hub/tools/__tests__/interactions.test.ts +110 -0
  141. package/src/client-v2/skill-hub/tools/interactions.ts +128 -0
  142. package/src/client-v2/skill-hub/tools/loopTemplates.ts +52 -52
  143. package/src/client-v2/skill-hub/utils/jsonFields.ts +41 -41
  144. package/src/client-v2/utils/jsonFields.ts +41 -41
  145. package/src/index.ts +2 -2
  146. package/src/locale/en-US.json +229 -1
  147. package/src/locale/zh-CN.json +229 -1
  148. package/src/server/__tests__/agent-execution-context.test.ts +18 -18
  149. package/src/server/__tests__/agent-governance.integration.test.ts +392 -0
  150. package/src/server/__tests__/agent-knowledge-insights.test.ts +123 -123
  151. package/src/server/__tests__/agent-monitor-acl.integration.test.ts +274 -0
  152. package/src/server/__tests__/agent-registry-service.test.ts +147 -147
  153. package/src/server/__tests__/agent-runtime-lifecycle.test.ts +46 -46
  154. package/src/server/__tests__/agent-usage-report.integration.test.ts +342 -0
  155. package/src/server/__tests__/code-validator.test.ts +63 -63
  156. package/src/server/__tests__/external-rag-search.test.ts +107 -107
  157. package/src/server/__tests__/harness-capabilities.test.ts +95 -0
  158. package/src/server/__tests__/harness-compiler.test.ts +214 -214
  159. package/src/server/__tests__/harness-profile-service.test.ts +167 -167
  160. package/src/server/__tests__/harness-runtime-policy.test.ts +293 -293
  161. package/src/server/__tests__/harness-tool-plan.test.ts +182 -172
  162. package/src/server/__tests__/input-schema-validator.test.ts +26 -26
  163. package/src/server/__tests__/loop-approval-decision.test.ts +577 -512
  164. package/src/server/__tests__/loop-approval-expiry.test.ts +258 -258
  165. package/src/server/__tests__/loop-budget-service.test.ts +36 -0
  166. package/src/server/__tests__/loop-pattern-schema.test.ts +73 -73
  167. package/src/server/__tests__/loop-run-repository.test.ts +32 -0
  168. package/src/server/__tests__/loop-run-state-machine.test.ts +101 -101
  169. package/src/server/__tests__/loop-trigger-service.test.ts +192 -148
  170. package/src/server/__tests__/loop-worker-claim.test.ts +72 -9
  171. package/src/server/__tests__/loop-worker-execution.test.ts +382 -317
  172. package/src/server/__tests__/native-agent-monitor-sync.test.ts +350 -0
  173. package/src/server/__tests__/native-sub-agent-observer.test.ts +470 -662
  174. package/src/server/__tests__/native-usage-attribution.integration.test.ts +175 -0
  175. package/src/server/__tests__/skill-access-service.test.ts +64 -64
  176. package/src/server/__tests__/skill-execute.test.ts +70 -70
  177. package/src/server/__tests__/skill-execution-task-policy.test.ts +140 -140
  178. package/src/server/__tests__/skill-sandbox-worker-mode.test.ts +15 -15
  179. package/src/server/__tests__/skill-settings.test.ts +63 -63
  180. package/src/server/__tests__/skill-tool-name.test.ts +23 -23
  181. package/src/server/__tests__/token-tracker.test.ts +639 -0
  182. package/src/server/__tests__/tool-loop-detection.test.ts +276 -276
  183. package/src/server/__tests__/tracing-retention-policy.test.ts +37 -0
  184. package/src/server/__tests__/usage-ledger.integration.test.ts +194 -0
  185. package/src/server/collections/agent-execution-spans.ts +393 -245
  186. package/src/server/collections/agent-governance-audit-events.ts +26 -0
  187. package/src/server/collections/agent-governance-policies.ts +26 -0
  188. package/src/server/collections/agent-governance-policy-versions.ts +27 -0
  189. package/src/server/collections/agent-governance-prompt-bindings.ts +29 -0
  190. package/src/server/collections/agent-loop-action-approvals.ts +39 -39
  191. package/src/server/collections/agent-loop-runs.ts +396 -369
  192. package/src/server/collections/agent-loop-steps.ts +220 -220
  193. package/src/server/collections/agent-memory-contexts.ts +95 -95
  194. package/src/server/collections/orchestrator-config.ts +87 -87
  195. package/src/server/collections/orchestrator-logs.ts +116 -116
  196. package/src/server/collections/skill-definitions.ts +159 -159
  197. package/src/server/collections/skill-executions.ts +154 -154
  198. package/src/server/collections/skill-loop-configs.ts +65 -65
  199. package/src/server/collections/skill-metrics.ts +36 -36
  200. package/src/server/collections/skill-registry-installations.ts +41 -41
  201. package/src/server/collections/skill-worker-configs.ts +86 -86
  202. package/src/server/index.ts +1 -1
  203. package/src/server/migrations/20260423000000-add-progress-fields.ts +50 -50
  204. package/src/server/migrations/20260425000000-add-interaction-schema.ts +37 -37
  205. package/src/server/migrations/20260427000000-add-tracing-detail-fields.ts +41 -41
  206. package/src/server/migrations/20260427000001-change-other-json-to-text.ts +61 -61
  207. package/src/server/migrations/20260524001000-add-plan-approval-and-harness-profiles.ts +145 -145
  208. package/src/server/migrations/20260601000000-add-token-fields.ts +89 -89
  209. package/src/server/migrations/20260615000000-normalize-ai-employee-tool-bindings.ts +39 -39
  210. package/src/server/migrations/20260621000000-native-policy-profile-defaults.ts +190 -190
  211. package/src/server/migrations/20260727000000-remove-unused-knowledge-scopes.ts +25 -25
  212. package/src/server/migrations/20260727010000-backfill-skill-tool-names.ts +45 -45
  213. package/src/server/migrations/20261110000000-add-usage-pricing-snapshots.ts +117 -0
  214. package/src/server/migrations/20261110010000-add-usage-department-attribution.ts +35 -0
  215. package/src/server/plugin.ts +674 -573
  216. package/src/server/resources/agent-governance.ts +168 -0
  217. package/src/server/resources/agent-harness-profile.ts +110 -94
  218. package/src/server/resources/agent-knowledge-insights.ts +306 -306
  219. package/src/server/resources/agent-loop-approval.ts +84 -84
  220. package/src/server/resources/agent-loop-events-stream.ts +108 -108
  221. package/src/server/resources/agent-loop.ts +252 -252
  222. package/src/server/resources/agent-monitor.ts +215 -482
  223. package/src/server/resources/agent-usage.ts +420 -0
  224. package/src/server/resources/native-monitor-format.ts +157 -0
  225. package/src/server/resources/tracing.ts +303 -267
  226. package/src/server/services/AgentExecutionContext.ts +23 -23
  227. package/src/server/services/AgentGovernanceService.ts +548 -0
  228. package/src/server/services/AgentMemoryContextService.ts +344 -344
  229. package/src/server/services/AgentRegistryService.ts +220 -220
  230. package/src/server/services/AgentRuntimeLifecycle.ts +64 -64
  231. package/src/server/services/CodeValidator.ts +238 -238
  232. package/src/server/services/DepartmentAttribution.ts +54 -0
  233. package/src/server/services/DurableCircuitBreakerService.ts +235 -235
  234. package/src/server/services/ExecutionSpanService.ts +278 -146
  235. package/src/server/services/FileManager.ts +159 -159
  236. package/src/server/services/GovernanceAdmission.ts +239 -0
  237. package/src/server/services/HarnessCapabilities.ts +119 -0
  238. package/src/server/services/HarnessCompiler.ts +170 -170
  239. package/src/server/services/HarnessProfileService.ts +235 -235
  240. package/src/server/services/HarnessSchema.ts +194 -194
  241. package/src/server/services/InputSchemaValidator.ts +44 -44
  242. package/src/server/services/LoopBudgetService.ts +332 -271
  243. package/src/server/services/LoopControlService.ts +120 -120
  244. package/src/server/services/LoopPatternSchema.ts +231 -231
  245. package/src/server/services/LoopPatternService.ts +171 -171
  246. package/src/server/services/LoopRunRepository.ts +350 -332
  247. package/src/server/services/LoopRunStateMachine.ts +545 -525
  248. package/src/server/services/LoopSchedulerService.ts +195 -195
  249. package/src/server/services/LoopTriggerService.ts +169 -159
  250. package/src/server/services/LoopWorkerService.ts +986 -912
  251. package/src/server/services/ManagedPromptProtection.ts +88 -0
  252. package/src/server/services/NativeAgentMonitorSyncService.ts +691 -0
  253. package/src/server/services/NativeSubAgentObserver.ts +331 -757
  254. package/src/server/services/NativeUsageAttribution.ts +98 -0
  255. package/src/server/services/PathLockService.ts +317 -317
  256. package/src/server/services/PluginAiRuntimeAdapter.ts +387 -387
  257. package/src/server/services/RunEventBus.ts +58 -58
  258. package/src/server/services/SandboxRunner.ts +492 -492
  259. package/src/server/services/SkillAccessService.ts +175 -175
  260. package/src/server/services/SkillManager.ts +585 -585
  261. package/src/server/services/SkillRepositoryService.ts +236 -236
  262. package/src/server/services/TokenTracker.ts +1158 -287
  263. package/src/server/services/ToolLoopDetectionService.ts +210 -210
  264. package/src/server/services/TracingRetentionPolicy.ts +56 -0
  265. package/src/server/services/VerificationSchema.ts +31 -31
  266. package/src/server/services/VerificationService.ts +332 -313
  267. package/src/server/services/WorkerEnvManager.ts +198 -198
  268. package/src/server/services/__tests__/SkillRepositoryService.test.ts +33 -33
  269. package/src/server/services/harness-runtime-policy.ts +134 -134
  270. package/src/server/services/pythonGuardTemplate.ts +87 -87
  271. package/src/server/services/sandboxCapabilities.ts +348 -348
  272. package/src/server/skill-hub/actions/__tests__/git-import.test.ts +563 -563
  273. package/src/server/skill-hub/actions/git-import.ts +936 -936
  274. package/src/server/skill-hub/mcp/McpController.ts +107 -107
  275. package/src/server/skill-hub/middlewares/git-import-request-method-policy.ts +51 -51
  276. package/src/server/skill-hub/plugin.ts +1232 -1232
  277. package/src/server/skill-hub/sandbox-config.json +6 -6
  278. package/src/server/skill-hub/services/RegistrySkillInstallationService.ts +281 -281
  279. package/src/server/skill-hub/services/__tests__/RegistrySkillInstallationService.test.ts +295 -295
  280. package/src/server/skill-hub/tasks/SkillExecutionTask.ts +568 -568
  281. package/src/server/skill-hub/utils/json-fields.ts +57 -57
  282. package/src/server/tools/delegate-task.ts +30 -30
  283. package/src/server/tools/external-rag-search.ts +329 -329
  284. package/src/server/tools/skill-execute.ts +216 -216
  285. package/src/server/types.ts +21 -21
  286. package/src/server/utils/ai-manager.ts +24 -24
  287. package/src/server/utils/ctx-utils.ts +132 -132
  288. package/src/server/utils/ensure-indexes.ts +119 -96
  289. package/src/server/utils/ha-lock.ts +80 -80
  290. package/src/server/utils/loop-pattern-context.ts +84 -84
  291. package/src/server/utils/record-utils.ts +19 -19
  292. package/src/server/utils/skill-settings.ts +135 -135
  293. package/src/server/utils/skill-tool-name.ts +58 -58
  294. package/dist/client-v2/117.7565cff57c39318a.js +0 -10
  295. package/dist/client-v2/214.106635011859dede.js +0 -10
  296. package/dist/client-v2/253.59577b40d9875be0.js +0 -10
  297. package/dist/client-v2/264.7ed8bee71fa5935c.js +0 -10
  298. package/dist/client-v2/418.41ed200e7d6da332.js +0 -10
  299. package/dist/client-v2/794.a67a2614405ba627.js +0 -10
  300. package/dist/client-v2/993.b0688fdc5ccb000a.js +0 -10
  301. package/dist/node_modules/simple-git/dist/cjs/index.js +0 -7399
  302. package/dist/node_modules/simple-git/dist/esm/index.js +0 -4745
  303. package/dist/node_modules/simple-git/dist/esm/package.json +0 -3
  304. package/dist/node_modules/simple-git/dist/src/lib/api.d.ts +0 -13
  305. package/dist/node_modules/simple-git/dist/src/lib/args/log-format.d.ts +0 -9
  306. package/dist/node_modules/simple-git/dist/src/lib/errors/git-construct-error.d.ts +0 -15
  307. package/dist/node_modules/simple-git/dist/src/lib/errors/git-error.d.ts +0 -30
  308. package/dist/node_modules/simple-git/dist/src/lib/errors/git-plugin-error.d.ts +0 -7
  309. package/dist/node_modules/simple-git/dist/src/lib/errors/git-response-error.d.ts +0 -32
  310. package/dist/node_modules/simple-git/dist/src/lib/errors/task-configuration-error.d.ts +0 -12
  311. package/dist/node_modules/simple-git/dist/src/lib/git-factory.d.ts +0 -15
  312. package/dist/node_modules/simple-git/dist/src/lib/git-logger.d.ts +0 -21
  313. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-branch-delete.d.ts +0 -5
  314. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-branch.d.ts +0 -2
  315. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-commit.d.ts +0 -2
  316. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-diff-summary.d.ts +0 -3
  317. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-fetch.d.ts +0 -2
  318. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-list-log-summary.d.ts +0 -6
  319. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-merge.d.ts +0 -11
  320. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-move.d.ts +0 -2
  321. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-pull.d.ts +0 -6
  322. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-push.d.ts +0 -4
  323. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-remote-messages.d.ts +0 -5
  324. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-remote-objects.d.ts +0 -3
  325. package/dist/node_modules/simple-git/dist/src/lib/plugins/abort-plugin.d.ts +0 -3
  326. package/dist/node_modules/simple-git/dist/src/lib/plugins/block-unsafe-operations-plugin.d.ts +0 -3
  327. package/dist/node_modules/simple-git/dist/src/lib/plugins/command-config-prefixing-plugin.d.ts +0 -2
  328. package/dist/node_modules/simple-git/dist/src/lib/plugins/completion-detection.plugin.d.ts +0 -3
  329. package/dist/node_modules/simple-git/dist/src/lib/plugins/custom-binary.plugin.d.ts +0 -3
  330. package/dist/node_modules/simple-git/dist/src/lib/plugins/error-detection.plugin.d.ts +0 -7
  331. package/dist/node_modules/simple-git/dist/src/lib/plugins/index.d.ts +0 -11
  332. package/dist/node_modules/simple-git/dist/src/lib/plugins/plugin-store.d.ts +0 -11
  333. package/dist/node_modules/simple-git/dist/src/lib/plugins/progress-monitor-plugin.d.ts +0 -3
  334. package/dist/node_modules/simple-git/dist/src/lib/plugins/simple-git-plugin.d.ts +0 -48
  335. package/dist/node_modules/simple-git/dist/src/lib/plugins/spawn-options-plugin.d.ts +0 -3
  336. package/dist/node_modules/simple-git/dist/src/lib/plugins/suffix-paths.plugin.d.ts +0 -2
  337. package/dist/node_modules/simple-git/dist/src/lib/plugins/timout-plugin.d.ts +0 -3
  338. package/dist/node_modules/simple-git/dist/src/lib/responses/BranchDeleteSummary.d.ts +0 -12
  339. package/dist/node_modules/simple-git/dist/src/lib/responses/BranchSummary.d.ts +0 -14
  340. package/dist/node_modules/simple-git/dist/src/lib/responses/CheckIgnore.d.ts +0 -4
  341. package/dist/node_modules/simple-git/dist/src/lib/responses/CleanSummary.d.ts +0 -9
  342. package/dist/node_modules/simple-git/dist/src/lib/responses/ConfigList.d.ts +0 -13
  343. package/dist/node_modules/simple-git/dist/src/lib/responses/DiffSummary.d.ts +0 -10
  344. package/dist/node_modules/simple-git/dist/src/lib/responses/FileStatusSummary.d.ts +0 -9
  345. package/dist/node_modules/simple-git/dist/src/lib/responses/GetRemoteSummary.d.ts +0 -11
  346. package/dist/node_modules/simple-git/dist/src/lib/responses/InitSummary.d.ts +0 -9
  347. package/dist/node_modules/simple-git/dist/src/lib/responses/MergeSummary.d.ts +0 -16
  348. package/dist/node_modules/simple-git/dist/src/lib/responses/PullSummary.d.ts +0 -25
  349. package/dist/node_modules/simple-git/dist/src/lib/responses/StatusSummary.d.ts +0 -19
  350. package/dist/node_modules/simple-git/dist/src/lib/responses/TagList.d.ts +0 -7
  351. package/dist/node_modules/simple-git/dist/src/lib/runners/git-executor-chain.d.ts +0 -25
  352. package/dist/node_modules/simple-git/dist/src/lib/runners/git-executor.d.ts +0 -14
  353. package/dist/node_modules/simple-git/dist/src/lib/runners/promise-wrapped.d.ts +0 -2
  354. package/dist/node_modules/simple-git/dist/src/lib/runners/scheduler.d.ts +0 -11
  355. package/dist/node_modules/simple-git/dist/src/lib/runners/tasks-pending-queue.d.ts +0 -23
  356. package/dist/node_modules/simple-git/dist/src/lib/simple-git-api.d.ts +0 -20
  357. package/dist/node_modules/simple-git/dist/src/lib/task-callback.d.ts +0 -2
  358. package/dist/node_modules/simple-git/dist/src/lib/tasks/apply-patch.d.ts +0 -3
  359. package/dist/node_modules/simple-git/dist/src/lib/tasks/branch.d.ts +0 -7
  360. package/dist/node_modules/simple-git/dist/src/lib/tasks/change-working-directory.d.ts +0 -2
  361. package/dist/node_modules/simple-git/dist/src/lib/tasks/check-ignore.d.ts +0 -2
  362. package/dist/node_modules/simple-git/dist/src/lib/tasks/check-is-repo.d.ts +0 -9
  363. package/dist/node_modules/simple-git/dist/src/lib/tasks/checkout.d.ts +0 -2
  364. package/dist/node_modules/simple-git/dist/src/lib/tasks/clean.d.ts +0 -25
  365. package/dist/node_modules/simple-git/dist/src/lib/tasks/clone.d.ts +0 -9
  366. package/dist/node_modules/simple-git/dist/src/lib/tasks/commit.d.ts +0 -4
  367. package/dist/node_modules/simple-git/dist/src/lib/tasks/config.d.ts +0 -8
  368. package/dist/node_modules/simple-git/dist/src/lib/tasks/count-objects.d.ts +0 -12
  369. package/dist/node_modules/simple-git/dist/src/lib/tasks/diff-name-status.d.ts +0 -12
  370. package/dist/node_modules/simple-git/dist/src/lib/tasks/diff.d.ts +0 -5
  371. package/dist/node_modules/simple-git/dist/src/lib/tasks/fetch.d.ts +0 -4
  372. package/dist/node_modules/simple-git/dist/src/lib/tasks/first-commit.d.ts +0 -2
  373. package/dist/node_modules/simple-git/dist/src/lib/tasks/grep.d.ts +0 -12
  374. package/dist/node_modules/simple-git/dist/src/lib/tasks/hash-object.d.ts +0 -5
  375. package/dist/node_modules/simple-git/dist/src/lib/tasks/init.d.ts +0 -3
  376. package/dist/node_modules/simple-git/dist/src/lib/tasks/log.d.ts +0 -32
  377. package/dist/node_modules/simple-git/dist/src/lib/tasks/merge.d.ts +0 -4
  378. package/dist/node_modules/simple-git/dist/src/lib/tasks/move.d.ts +0 -3
  379. package/dist/node_modules/simple-git/dist/src/lib/tasks/pull.d.ts +0 -3
  380. package/dist/node_modules/simple-git/dist/src/lib/tasks/push.d.ts +0 -9
  381. package/dist/node_modules/simple-git/dist/src/lib/tasks/remote.d.ts +0 -8
  382. package/dist/node_modules/simple-git/dist/src/lib/tasks/reset.d.ts +0 -11
  383. package/dist/node_modules/simple-git/dist/src/lib/tasks/show.d.ts +0 -2
  384. package/dist/node_modules/simple-git/dist/src/lib/tasks/stash-list.d.ts +0 -4
  385. package/dist/node_modules/simple-git/dist/src/lib/tasks/status.d.ts +0 -3
  386. package/dist/node_modules/simple-git/dist/src/lib/tasks/sub-module.d.ts +0 -5
  387. package/dist/node_modules/simple-git/dist/src/lib/tasks/tag.d.ts +0 -18
  388. package/dist/node_modules/simple-git/dist/src/lib/tasks/task.d.ts +0 -14
  389. package/dist/node_modules/simple-git/dist/src/lib/tasks/version.d.ts +0 -9
  390. package/dist/node_modules/simple-git/dist/src/lib/types/handlers.d.ts +0 -21
  391. package/dist/node_modules/simple-git/dist/src/lib/types/index.d.ts +0 -136
  392. package/dist/node_modules/simple-git/dist/src/lib/types/tasks.d.ts +0 -19
  393. package/dist/node_modules/simple-git/dist/src/lib/utils/argument-filters.d.ts +0 -14
  394. package/dist/node_modules/simple-git/dist/src/lib/utils/exit-codes.d.ts +0 -10
  395. package/dist/node_modules/simple-git/dist/src/lib/utils/git-output-streams.d.ts +0 -7
  396. package/dist/node_modules/simple-git/dist/src/lib/utils/index.d.ts +0 -8
  397. package/dist/node_modules/simple-git/dist/src/lib/utils/line-parser.d.ts +0 -15
  398. package/dist/node_modules/simple-git/dist/src/lib/utils/simple-git-options.d.ts +0 -2
  399. package/dist/node_modules/simple-git/dist/src/lib/utils/task-options.d.ts +0 -13
  400. package/dist/node_modules/simple-git/dist/src/lib/utils/task-parser.d.ts +0 -5
  401. package/dist/node_modules/simple-git/dist/src/lib/utils/util.d.ts +0 -47
  402. package/dist/node_modules/simple-git/dist/typings/errors.d.ts +0 -5
  403. package/dist/node_modules/simple-git/dist/typings/index.d.ts +0 -14
  404. package/dist/node_modules/simple-git/dist/typings/response.d.ts +0 -556
  405. package/dist/node_modules/simple-git/dist/typings/simple-git.d.ts +0 -1033
  406. package/dist/node_modules/simple-git/dist/typings/types.d.ts +0 -22
  407. package/dist/node_modules/simple-git/node_modules/debug/package.json +0 -64
  408. package/dist/node_modules/simple-git/node_modules/debug/src/browser.js +0 -272
  409. package/dist/node_modules/simple-git/node_modules/debug/src/common.js +0 -292
  410. package/dist/node_modules/simple-git/node_modules/debug/src/index.js +0 -10
  411. package/dist/node_modules/simple-git/node_modules/debug/src/node.js +0 -263
  412. package/dist/node_modules/simple-git/package.json +0 -1
  413. package/dist/node_modules/simple-git/promise.js +0 -17
@@ -1,276 +1,276 @@
1
- import { describe, expect, it } from 'vitest';
2
- import type { Database } from '@nocobase/database';
3
- import { loopPatternPolicySchema } from '../services/LoopPatternSchema';
4
- import { getRunEventBus } from '../services/RunEventBus';
5
- import {
6
- ToolLoopDetectionService,
7
- countToolRepetitions,
8
- toolCallSignature,
9
- toolLoopLevel,
10
- } from '../services/ToolLoopDetectionService';
11
- import type { ToolLoopFinding } from '../services/ToolLoopDetectionService';
12
-
13
- type Row = Record<string, unknown>;
14
-
15
- const defaultPolicy = loopPatternPolicySchema.parse({});
16
-
17
- function matches(row: Row, filter: Row): boolean {
18
- return Object.entries(filter).every(([key, value]) => {
19
- if (value && typeof value === 'object' && Array.isArray((value as Row).$in)) {
20
- return ((value as Row).$in as unknown[]).includes(row[key]);
21
- }
22
- return row[key] === value;
23
- });
24
- }
25
-
26
- function mockDatabase(options: { steps?: Row[]; messages?: Row[] } = {}) {
27
- const steps: Row[] = [...(options.steps ?? [])];
28
- const events: Row[] = [];
29
- let nextId = 1;
30
- const database = {
31
- getRepository(name: string) {
32
- if (name === 'agentLoopSteps') {
33
- return {
34
- find: async ({ filter }: { filter: Row }) => steps.filter((row) => matches(row, filter)),
35
- findOne: async ({ filter }: { filter: Row }) => steps.find((row) => matches(row, filter)) ?? null,
36
- count: async ({ filter }: { filter: Row }) => steps.filter((row) => matches(row, filter)).length,
37
- create: async ({ values }: { values: Row }) => {
38
- const row = { id: nextId++, ...values };
39
- steps.push(row);
40
- return row;
41
- },
42
- };
43
- }
44
- if (name === 'aiMessages') {
45
- return {
46
- find: async ({ filter }: { filter: Row }) => (options.messages ?? []).filter((row) => matches(row, filter)),
47
- };
48
- }
49
- if (name === 'agentLoopEvents') {
50
- return {
51
- create: async ({ values }: { values: Row }) => {
52
- const row = { id: nextId++, ...values };
53
- events.push(row);
54
- return row;
55
- },
56
- };
57
- }
58
- throw new Error(`Unexpected repository ${name}`);
59
- },
60
- } as unknown as Database;
61
- return { database, steps, events };
62
- }
63
-
64
- function message(sessionId: string, calls: Array<{ id: string; name: string; args: unknown }>): Row {
65
- return { sessionId, role: 'assistant', toolCalls: calls };
66
- }
67
-
68
- function finding(overrides: Partial<ToolLoopFinding> = {}): ToolLoopFinding {
69
- return {
70
- level: 'warn',
71
- toolName: 'searchDocs',
72
- signature: toolCallSignature('searchDocs', { query: 'loop' }),
73
- count: 3,
74
- sampleArgs: { query: 'loop' },
75
- ...overrides,
76
- };
77
- }
78
-
79
- describe('toolCallSignature', () => {
80
- it('is stable across object key order', () => {
81
- expect(toolCallSignature('search', { a: 1, b: 2 })).toBe(toolCallSignature('search', { b: 2, a: 1 }));
82
- });
83
-
84
- it('separates the tool name from its arguments', () => {
85
- expect(toolCallSignature('a 1', null)).not.toBe(toolCallSignature('a', '1 null'));
86
- expect(toolCallSignature('search', { a: 1 })).not.toBe(toolCallSignature('search', { a: 2 }));
87
- });
88
-
89
- it('treats missing args the same as null', () => {
90
- expect(toolCallSignature('ping', undefined)).toBe(toolCallSignature('ping', null));
91
- });
92
- });
93
-
94
- describe('countToolRepetitions', () => {
95
- it('counts identical calls and separates differing args', () => {
96
- const counts = countToolRepetitions([
97
- { name: 'search', args: { q: 'x' } },
98
- { name: 'search', args: { q: 'x' } },
99
- { name: 'search', args: { q: 'y' } },
100
- { name: 'write', args: { q: 'x' } },
101
- { name: '', args: {} },
102
- ]);
103
-
104
- expect(counts.size).toBe(3);
105
- const repeated = [...counts.values()].find((entry) => entry.count === 2);
106
- expect(repeated?.toolName).toBe('search');
107
- expect(repeated?.sampleArgs).toEqual({ q: 'x' });
108
- });
109
- });
110
-
111
- describe('toolLoopLevel', () => {
112
- it('maps counts onto the policy thresholds', () => {
113
- const detection = defaultPolicy.loopDetection;
114
- expect(toolLoopLevel(2, detection)).toBe('none');
115
- expect(toolLoopLevel(3, detection)).toBe('warn');
116
- expect(toolLoopLevel(5, detection)).toBe('block');
117
- expect(toolLoopLevel(8, detection)).toBe('escalate');
118
- expect(toolLoopLevel(100, detection)).toBe('escalate');
119
- });
120
-
121
- it('returns none when detection is disabled', () => {
122
- expect(toolLoopLevel(100, { ...defaultPolicy.loopDetection, enabled: false })).toBe('none');
123
- });
124
- });
125
-
126
- describe('ToolLoopDetectionService.scanRun', () => {
127
- it('returns the most repeated signature across every pass session of the run', async () => {
128
- const { database } = mockDatabase({
129
- steps: [
130
- { runId: 1, sessionId: 's1' },
131
- { runId: 1, sessionId: 's2' },
132
- { runId: 2, sessionId: 'other-run' },
133
- ],
134
- messages: [
135
- message('s1', [
136
- { id: 'c1', name: 'searchDocs', args: { query: 'loop' } },
137
- { id: 'c2', name: 'searchDocs', args: { query: 'loop' } },
138
- ]),
139
- message('s2', [
140
- { id: 'c3', name: 'searchDocs', args: { query: 'loop' } },
141
- { id: 'c4', name: 'readFile', args: { path: '/tmp/a' } },
142
- ]),
143
- message('other-run', [
144
- { id: 'c5', name: 'searchDocs', args: { query: 'loop' } },
145
- { id: 'c6', name: 'searchDocs', args: { query: 'loop' } },
146
- ]),
147
- ],
148
- });
149
- const service = new ToolLoopDetectionService(database);
150
-
151
- const result = await service.scanRun(1, defaultPolicy);
152
-
153
- expect(result).toMatchObject({ level: 'warn', toolName: 'searchDocs', count: 3 });
154
- });
155
-
156
- it('returns null while the run stays under the warn threshold', async () => {
157
- const { database } = mockDatabase({
158
- steps: [{ runId: 1, sessionId: 's1' }],
159
- messages: [
160
- message('s1', [
161
- { id: 'c1', name: 'searchDocs', args: { query: 'loop' } },
162
- { id: 'c2', name: 'searchDocs', args: { query: 'loop' } },
163
- ]),
164
- ],
165
- });
166
- const service = new ToolLoopDetectionService(database);
167
-
168
- expect(await service.scanRun(1, defaultPolicy)).toBeNull();
169
- });
170
-
171
- it('returns null when detection is disabled', async () => {
172
- const { database } = mockDatabase({
173
- steps: [{ runId: 1, sessionId: 's1' }],
174
- messages: [
175
- message('s1', [
176
- { id: 'c1', name: 'searchDocs', args: { query: 'loop' } },
177
- { id: 'c2', name: 'searchDocs', args: { query: 'loop' } },
178
- { id: 'c3', name: 'searchDocs', args: { query: 'loop' } },
179
- ]),
180
- ],
181
- });
182
- const service = new ToolLoopDetectionService(database);
183
- const policy = loopPatternPolicySchema.parse({ loopDetection: { enabled: false } });
184
-
185
- expect(await service.scanRun(1, policy)).toBeNull();
186
- });
187
-
188
- it('returns null when no pass session recorded tool calls', async () => {
189
- const { database } = mockDatabase({ steps: [{ runId: 1, sessionId: 's1' }], messages: [] });
190
- const service = new ToolLoopDetectionService(database);
191
-
192
- expect(await service.scanRun(1, defaultPolicy)).toBeNull();
193
- expect(await service.scanRun(99, defaultPolicy)).toBeNull();
194
- });
195
-
196
- it('ignores malformed tool call entries', async () => {
197
- const { database } = mockDatabase({
198
- steps: [{ runId: 1, sessionId: 's1' }],
199
- messages: [
200
- {
201
- sessionId: 's1',
202
- role: 'assistant',
203
- toolCalls: [
204
- { id: 'c1', args: { query: 'loop' } },
205
- { id: 'c2', name: 'searchDocs', args: { query: 'loop' } },
206
- 'not-an-object',
207
- ],
208
- },
209
- ],
210
- });
211
- const service = new ToolLoopDetectionService(database);
212
-
213
- expect(await service.scanRun(1, defaultPolicy)).toBeNull();
214
- });
215
- });
216
-
217
- describe('ToolLoopDetectionService.recordFinding', () => {
218
- it('records one guard step and one event per signature and emits on the run bus', async () => {
219
- const { database, steps, events } = mockDatabase({ steps: [{ runId: 42, sessionId: 's1' }] });
220
- const service = new ToolLoopDetectionService(database);
221
- const seen: unknown[] = [];
222
- const unsubscribe = getRunEventBus().subscribe(42, (event) => seen.push(event));
223
- const context = {
224
- runId: 42,
225
- role: 'leader',
226
- username: 'lead',
227
- runStatus: 'running',
228
- actorType: 'worker',
229
- actorIdentity: 'worker-a',
230
- };
231
-
232
- try {
233
- expect(await service.recordFinding(context, finding())).toBe(true);
234
- expect(await service.recordFinding(context, finding())).toBe(false);
235
- } finally {
236
- unsubscribe();
237
- }
238
-
239
- const guardSteps = steps.filter((step) => step.kind === 'guard');
240
- expect(guardSteps).toHaveLength(1);
241
- expect(guardSteps[0]).toMatchObject({
242
- runId: 42,
243
- type: 'tool_loop',
244
- toolName: 'searchDocs',
245
- status: 'succeeded',
246
- });
247
- expect(events).toHaveLength(1);
248
- expect(events[0]).toMatchObject({ runId: 42, type: 'tool_loop_detected', status: 'running' });
249
- expect(seen).toHaveLength(1);
250
- });
251
- });
252
-
253
- describe('ToolLoopDetectionService.existingNotices', () => {
254
- it('rebuilds notices from recorded guard steps', async () => {
255
- const { database } = mockDatabase({
256
- steps: [
257
- {
258
- runId: 7,
259
- kind: 'guard',
260
- toolName: 'searchDocs',
261
- metadata: { level: 'warn', count: 3 },
262
- },
263
- { runId: 7, kind: 'guard', toolName: '', metadata: { count: 5 } },
264
- { runId: 7, kind: 'invocation', toolName: 'other', metadata: {} },
265
- ],
266
- });
267
- const service = new ToolLoopDetectionService(database);
268
-
269
- const notices = await service.existingNotices(7);
270
-
271
- expect(notices).toHaveLength(1);
272
- expect(notices[0]).toContain('<tool_loop_warning>');
273
- expect(notices[0]).toContain('searchDocs');
274
- expect(notices[0]).toContain('3 times');
275
- });
276
- });
1
+ import { describe, expect, it } from 'vitest';
2
+ import type { Database } from '@nocobase/database';
3
+ import { loopPatternPolicySchema } from '../services/LoopPatternSchema';
4
+ import { getRunEventBus } from '../services/RunEventBus';
5
+ import {
6
+ ToolLoopDetectionService,
7
+ countToolRepetitions,
8
+ toolCallSignature,
9
+ toolLoopLevel,
10
+ } from '../services/ToolLoopDetectionService';
11
+ import type { ToolLoopFinding } from '../services/ToolLoopDetectionService';
12
+
13
+ type Row = Record<string, unknown>;
14
+
15
+ const defaultPolicy = loopPatternPolicySchema.parse({});
16
+
17
+ function matches(row: Row, filter: Row): boolean {
18
+ return Object.entries(filter).every(([key, value]) => {
19
+ if (value && typeof value === 'object' && Array.isArray((value as Row).$in)) {
20
+ return ((value as Row).$in as unknown[]).includes(row[key]);
21
+ }
22
+ return row[key] === value;
23
+ });
24
+ }
25
+
26
+ function mockDatabase(options: { steps?: Row[]; messages?: Row[] } = {}) {
27
+ const steps: Row[] = [...(options.steps ?? [])];
28
+ const events: Row[] = [];
29
+ let nextId = 1;
30
+ const database = {
31
+ getRepository(name: string) {
32
+ if (name === 'agentLoopSteps') {
33
+ return {
34
+ find: async ({ filter }: { filter: Row }) => steps.filter((row) => matches(row, filter)),
35
+ findOne: async ({ filter }: { filter: Row }) => steps.find((row) => matches(row, filter)) ?? null,
36
+ count: async ({ filter }: { filter: Row }) => steps.filter((row) => matches(row, filter)).length,
37
+ create: async ({ values }: { values: Row }) => {
38
+ const row = { id: nextId++, ...values };
39
+ steps.push(row);
40
+ return row;
41
+ },
42
+ };
43
+ }
44
+ if (name === 'aiMessages') {
45
+ return {
46
+ find: async ({ filter }: { filter: Row }) => (options.messages ?? []).filter((row) => matches(row, filter)),
47
+ };
48
+ }
49
+ if (name === 'agentLoopEvents') {
50
+ return {
51
+ create: async ({ values }: { values: Row }) => {
52
+ const row = { id: nextId++, ...values };
53
+ events.push(row);
54
+ return row;
55
+ },
56
+ };
57
+ }
58
+ throw new Error(`Unexpected repository ${name}`);
59
+ },
60
+ } as unknown as Database;
61
+ return { database, steps, events };
62
+ }
63
+
64
+ function message(sessionId: string, calls: Array<{ id: string; name: string; args: unknown }>): Row {
65
+ return { sessionId, role: 'assistant', toolCalls: calls };
66
+ }
67
+
68
+ function finding(overrides: Partial<ToolLoopFinding> = {}): ToolLoopFinding {
69
+ return {
70
+ level: 'warn',
71
+ toolName: 'searchDocs',
72
+ signature: toolCallSignature('searchDocs', { query: 'loop' }),
73
+ count: 3,
74
+ sampleArgs: { query: 'loop' },
75
+ ...overrides,
76
+ };
77
+ }
78
+
79
+ describe('toolCallSignature', () => {
80
+ it('is stable across object key order', () => {
81
+ expect(toolCallSignature('search', { a: 1, b: 2 })).toBe(toolCallSignature('search', { b: 2, a: 1 }));
82
+ });
83
+
84
+ it('separates the tool name from its arguments', () => {
85
+ expect(toolCallSignature('a 1', null)).not.toBe(toolCallSignature('a', '1 null'));
86
+ expect(toolCallSignature('search', { a: 1 })).not.toBe(toolCallSignature('search', { a: 2 }));
87
+ });
88
+
89
+ it('treats missing args the same as null', () => {
90
+ expect(toolCallSignature('ping', undefined)).toBe(toolCallSignature('ping', null));
91
+ });
92
+ });
93
+
94
+ describe('countToolRepetitions', () => {
95
+ it('counts identical calls and separates differing args', () => {
96
+ const counts = countToolRepetitions([
97
+ { name: 'search', args: { q: 'x' } },
98
+ { name: 'search', args: { q: 'x' } },
99
+ { name: 'search', args: { q: 'y' } },
100
+ { name: 'write', args: { q: 'x' } },
101
+ { name: '', args: {} },
102
+ ]);
103
+
104
+ expect(counts.size).toBe(3);
105
+ const repeated = [...counts.values()].find((entry) => entry.count === 2);
106
+ expect(repeated?.toolName).toBe('search');
107
+ expect(repeated?.sampleArgs).toEqual({ q: 'x' });
108
+ });
109
+ });
110
+
111
+ describe('toolLoopLevel', () => {
112
+ it('maps counts onto the policy thresholds', () => {
113
+ const detection = defaultPolicy.loopDetection;
114
+ expect(toolLoopLevel(2, detection)).toBe('none');
115
+ expect(toolLoopLevel(3, detection)).toBe('warn');
116
+ expect(toolLoopLevel(5, detection)).toBe('block');
117
+ expect(toolLoopLevel(8, detection)).toBe('escalate');
118
+ expect(toolLoopLevel(100, detection)).toBe('escalate');
119
+ });
120
+
121
+ it('returns none when detection is disabled', () => {
122
+ expect(toolLoopLevel(100, { ...defaultPolicy.loopDetection, enabled: false })).toBe('none');
123
+ });
124
+ });
125
+
126
+ describe('ToolLoopDetectionService.scanRun', () => {
127
+ it('returns the most repeated signature across every pass session of the run', async () => {
128
+ const { database } = mockDatabase({
129
+ steps: [
130
+ { runId: 1, sessionId: 's1' },
131
+ { runId: 1, sessionId: 's2' },
132
+ { runId: 2, sessionId: 'other-run' },
133
+ ],
134
+ messages: [
135
+ message('s1', [
136
+ { id: 'c1', name: 'searchDocs', args: { query: 'loop' } },
137
+ { id: 'c2', name: 'searchDocs', args: { query: 'loop' } },
138
+ ]),
139
+ message('s2', [
140
+ { id: 'c3', name: 'searchDocs', args: { query: 'loop' } },
141
+ { id: 'c4', name: 'readFile', args: { path: '/tmp/a' } },
142
+ ]),
143
+ message('other-run', [
144
+ { id: 'c5', name: 'searchDocs', args: { query: 'loop' } },
145
+ { id: 'c6', name: 'searchDocs', args: { query: 'loop' } },
146
+ ]),
147
+ ],
148
+ });
149
+ const service = new ToolLoopDetectionService(database);
150
+
151
+ const result = await service.scanRun(1, defaultPolicy);
152
+
153
+ expect(result).toMatchObject({ level: 'warn', toolName: 'searchDocs', count: 3 });
154
+ });
155
+
156
+ it('returns null while the run stays under the warn threshold', async () => {
157
+ const { database } = mockDatabase({
158
+ steps: [{ runId: 1, sessionId: 's1' }],
159
+ messages: [
160
+ message('s1', [
161
+ { id: 'c1', name: 'searchDocs', args: { query: 'loop' } },
162
+ { id: 'c2', name: 'searchDocs', args: { query: 'loop' } },
163
+ ]),
164
+ ],
165
+ });
166
+ const service = new ToolLoopDetectionService(database);
167
+
168
+ expect(await service.scanRun(1, defaultPolicy)).toBeNull();
169
+ });
170
+
171
+ it('returns null when detection is disabled', async () => {
172
+ const { database } = mockDatabase({
173
+ steps: [{ runId: 1, sessionId: 's1' }],
174
+ messages: [
175
+ message('s1', [
176
+ { id: 'c1', name: 'searchDocs', args: { query: 'loop' } },
177
+ { id: 'c2', name: 'searchDocs', args: { query: 'loop' } },
178
+ { id: 'c3', name: 'searchDocs', args: { query: 'loop' } },
179
+ ]),
180
+ ],
181
+ });
182
+ const service = new ToolLoopDetectionService(database);
183
+ const policy = loopPatternPolicySchema.parse({ loopDetection: { enabled: false } });
184
+
185
+ expect(await service.scanRun(1, policy)).toBeNull();
186
+ });
187
+
188
+ it('returns null when no pass session recorded tool calls', async () => {
189
+ const { database } = mockDatabase({ steps: [{ runId: 1, sessionId: 's1' }], messages: [] });
190
+ const service = new ToolLoopDetectionService(database);
191
+
192
+ expect(await service.scanRun(1, defaultPolicy)).toBeNull();
193
+ expect(await service.scanRun(99, defaultPolicy)).toBeNull();
194
+ });
195
+
196
+ it('ignores malformed tool call entries', async () => {
197
+ const { database } = mockDatabase({
198
+ steps: [{ runId: 1, sessionId: 's1' }],
199
+ messages: [
200
+ {
201
+ sessionId: 's1',
202
+ role: 'assistant',
203
+ toolCalls: [
204
+ { id: 'c1', args: { query: 'loop' } },
205
+ { id: 'c2', name: 'searchDocs', args: { query: 'loop' } },
206
+ 'not-an-object',
207
+ ],
208
+ },
209
+ ],
210
+ });
211
+ const service = new ToolLoopDetectionService(database);
212
+
213
+ expect(await service.scanRun(1, defaultPolicy)).toBeNull();
214
+ });
215
+ });
216
+
217
+ describe('ToolLoopDetectionService.recordFinding', () => {
218
+ it('records one guard step and one event per signature and emits on the run bus', async () => {
219
+ const { database, steps, events } = mockDatabase({ steps: [{ runId: 42, sessionId: 's1' }] });
220
+ const service = new ToolLoopDetectionService(database);
221
+ const seen: unknown[] = [];
222
+ const unsubscribe = getRunEventBus().subscribe(42, (event) => seen.push(event));
223
+ const context = {
224
+ runId: 42,
225
+ role: 'leader',
226
+ username: 'lead',
227
+ runStatus: 'running',
228
+ actorType: 'worker',
229
+ actorIdentity: 'worker-a',
230
+ };
231
+
232
+ try {
233
+ expect(await service.recordFinding(context, finding())).toBe(true);
234
+ expect(await service.recordFinding(context, finding())).toBe(false);
235
+ } finally {
236
+ unsubscribe();
237
+ }
238
+
239
+ const guardSteps = steps.filter((step) => step.kind === 'guard');
240
+ expect(guardSteps).toHaveLength(1);
241
+ expect(guardSteps[0]).toMatchObject({
242
+ runId: 42,
243
+ type: 'tool_loop',
244
+ toolName: 'searchDocs',
245
+ status: 'succeeded',
246
+ });
247
+ expect(events).toHaveLength(1);
248
+ expect(events[0]).toMatchObject({ runId: 42, type: 'tool_loop_detected', status: 'running' });
249
+ expect(seen).toHaveLength(1);
250
+ });
251
+ });
252
+
253
+ describe('ToolLoopDetectionService.existingNotices', () => {
254
+ it('rebuilds notices from recorded guard steps', async () => {
255
+ const { database } = mockDatabase({
256
+ steps: [
257
+ {
258
+ runId: 7,
259
+ kind: 'guard',
260
+ toolName: 'searchDocs',
261
+ metadata: { level: 'warn', count: 3 },
262
+ },
263
+ { runId: 7, kind: 'guard', toolName: '', metadata: { count: 5 } },
264
+ { runId: 7, kind: 'invocation', toolName: 'other', metadata: {} },
265
+ ],
266
+ });
267
+ const service = new ToolLoopDetectionService(database);
268
+
269
+ const notices = await service.existingNotices(7);
270
+
271
+ expect(notices).toHaveLength(1);
272
+ expect(notices[0]).toContain('<tool_loop_warning>');
273
+ expect(notices[0]).toContain('searchDocs');
274
+ expect(notices[0]).toContain('3 times');
275
+ });
276
+ });
@@ -0,0 +1,37 @@
1
+ /**
2
+ * This file is part of the NocoBase (R) project.
3
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
4
+ * Authors: NocoBase Team.
5
+ *
6
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
7
+ * For more information, please refer to: https://www.nocobase.com/agreement.
8
+ */
9
+
10
+ import { describe, expect, it } from 'vitest';
11
+ import { getHarnessProfileRetentionDays } from '../services/TracingRetentionPolicy';
12
+
13
+ describe('getHarnessProfileRetentionDays', () => {
14
+ it('prefers the canonical nested observability setting', () => {
15
+ expect(
16
+ getHarnessProfileRetentionDays({
17
+ observability: { tracingRetentionDays: 14 },
18
+ tracingRetentionDays: 90,
19
+ }),
20
+ ).toBe(14);
21
+ });
22
+
23
+ it('falls back to the legacy top-level setting when the canonical value is absent or invalid', () => {
24
+ expect(getHarnessProfileRetentionDays({ tracingRetentionDays: 21 })).toBe(21);
25
+ expect(
26
+ getHarnessProfileRetentionDays({
27
+ observability: { tracingRetentionDays: 0 },
28
+ tracingRetentionDays: 21,
29
+ }),
30
+ ).toBe(21);
31
+ });
32
+
33
+ it('returns null when neither setting is a positive finite number', () => {
34
+ expect(getHarnessProfileRetentionDays({ observability: { tracingRetentionDays: 'invalid' } })).toBeNull();
35
+ expect(getHarnessProfileRetentionDays(null)).toBeNull();
36
+ });
37
+ });