plugin-agent-orchestrator 1.1.8 → 1.2.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 (495) hide show
  1. package/LICENSE +201 -0
  2. package/README.md +207 -204
  3. package/client-v2.d.ts +2 -2
  4. package/client-v2.js +1 -1
  5. package/client.d.ts +2 -2
  6. package/client.js +1 -1
  7. package/dist/client/117.6c69b6a87751dd18.js +10 -0
  8. package/dist/client/253.52f62e1bc0e9520a.js +10 -0
  9. package/dist/client/325.8f7f509bdb35e142.js +10 -0
  10. package/dist/client/404.86593f98c9768ed5.js +10 -0
  11. package/dist/client/453.fa2d169576262213.js +10 -0
  12. package/dist/client/53.567db3ae078650c6.js +10 -0
  13. package/dist/client/619.01713281e5e951d3.js +10 -0
  14. package/dist/client/652.69da1598312b3a3f.js +10 -0
  15. package/dist/client/773.648965568ff476f9.js +10 -0
  16. package/dist/client/981.37e7aeecdb1ef6fa.js +10 -0
  17. package/dist/client/993.ac89f3852990918d.js +10 -0
  18. package/dist/client/index.js +1 -1
  19. package/dist/client-v2/117.c982d79ff68738f5.js +10 -0
  20. package/dist/client-v2/214.94c4257bf2838577.js +10 -0
  21. package/dist/client-v2/253.8e19956d2a44dfb8.js +10 -0
  22. package/dist/client-v2/264.80e8e358c8c6c2e5.js +10 -0
  23. package/dist/client-v2/325.fafe5a6e83ba9cb3.js +10 -0
  24. package/dist/client-v2/404.ab032b79c95dab6f.js +10 -0
  25. package/dist/client-v2/{41.3deb9e57a0f64fc4.js → 41.cd5610fcf7446127.js} +1 -1
  26. package/dist/client-v2/453.42c6d70628d56cc2.js +10 -0
  27. package/dist/client-v2/{53.349fff8db80b19d4.js → 53.37c08089a648f89a.js} +1 -1
  28. package/dist/client-v2/{619.0a2144aaffefe018.js → 619.6e9618550101e819.js} +1 -1
  29. package/dist/client-v2/652.eeba4e0c38367321.js +10 -0
  30. package/dist/client-v2/{70.ffff2997c10fd4b0.js → 70.332698e53eb59677.js} +1 -1
  31. package/dist/client-v2/773.4de2ba5acb07318c.js +10 -0
  32. package/dist/client-v2/981.76060f466e6f7c11.js +10 -0
  33. package/dist/client-v2/993.f8cdb5172566ce75.js +10 -0
  34. package/dist/client-v2/index.js +1 -1
  35. package/dist/externalVersion.js +13 -7
  36. package/dist/locale/en-US.json +308 -1
  37. package/dist/locale/vi-VN.json +5 -1
  38. package/dist/locale/zh-CN.json +308 -1
  39. package/dist/node_modules/acorn/LICENSE +21 -0
  40. package/dist/node_modules/acorn/bin/acorn +4 -0
  41. package/dist/node_modules/acorn/dist/acorn.d.mts +857 -0
  42. package/dist/node_modules/acorn/dist/acorn.d.ts +857 -0
  43. package/dist/node_modules/acorn/dist/acorn.js +1 -0
  44. package/dist/node_modules/acorn/dist/bin.js +90 -0
  45. package/dist/node_modules/acorn/package.json +1 -0
  46. package/dist/node_modules/acorn-walk/LICENSE +21 -0
  47. package/dist/node_modules/acorn-walk/dist/walk.d.mts +177 -0
  48. package/dist/node_modules/acorn-walk/dist/walk.d.ts +177 -0
  49. package/dist/node_modules/acorn-walk/dist/walk.js +1 -0
  50. package/dist/node_modules/acorn-walk/node_modules/.bin/acorn +15 -0
  51. package/dist/node_modules/acorn-walk/node_modules/.bin/acorn.cmd +7 -0
  52. package/dist/node_modules/acorn-walk/node_modules/acorn/bin/acorn +4 -0
  53. package/dist/node_modules/acorn-walk/node_modules/acorn/dist/acorn.d.mts +866 -0
  54. package/dist/node_modules/acorn-walk/node_modules/acorn/dist/acorn.d.ts +866 -0
  55. package/dist/node_modules/acorn-walk/node_modules/acorn/dist/acorn.js +6174 -0
  56. package/dist/node_modules/acorn-walk/node_modules/acorn/dist/bin.js +90 -0
  57. package/dist/node_modules/acorn-walk/node_modules/acorn/package.json +50 -0
  58. package/dist/node_modules/acorn-walk/package.json +1 -0
  59. package/dist/node_modules/adm-zip/adm-zip.js +1 -1
  60. package/dist/node_modules/adm-zip/package.json +1 -1
  61. package/dist/node_modules/ajv/package.json +1 -1
  62. package/dist/node_modules/zod/index.cjs +1 -1
  63. package/dist/node_modules/zod/package.json +1 -1
  64. package/dist/server/collections/agent-auto-approval-checkpoints.js +47 -0
  65. package/dist/server/collections/agent-execution-spans.js +148 -9
  66. package/dist/server/collections/agent-governance-audit-events.js +47 -0
  67. package/dist/server/collections/agent-governance-policies.js +47 -0
  68. package/dist/server/collections/agent-governance-policy-versions.js +48 -0
  69. package/dist/server/collections/agent-governance-prompt-bindings.js +50 -0
  70. package/dist/server/collections/agent-hierarchy-invocations.js +59 -0
  71. package/dist/server/collections/agent-loop-runs.js +23 -5
  72. package/dist/server/collections/agent-routing-graph-locks.js +40 -0
  73. package/dist/server/collections/agent-session-auto-approvals.js +45 -0
  74. package/dist/server/collections/orchestrator-config.js +17 -0
  75. package/dist/server/migrations/20261110000000-add-usage-pricing-snapshots.js +117 -0
  76. package/dist/server/migrations/20261110010000-add-usage-department-attribution.js +54 -0
  77. package/dist/server/migrations/20261119000000-widen-native-employee-identifiers.js +59 -0
  78. package/dist/server/plugin.js +169 -33
  79. package/dist/server/resources/agent-auto-approval.js +80 -0
  80. package/dist/server/resources/agent-governance.js +192 -0
  81. package/dist/server/resources/agent-harness-profile.js +11 -3
  82. package/dist/server/resources/agent-monitor.js +109 -339
  83. package/dist/server/resources/agent-usage.js +423 -0
  84. package/dist/server/resources/hierarchical-routing.js +60 -0
  85. package/dist/server/resources/native-monitor-format.js +179 -0
  86. package/dist/server/resources/tracing.js +35 -12
  87. package/dist/server/services/AgentGovernanceService.js +500 -0
  88. package/dist/server/services/AutoApprovalCheckpoint.js +133 -0
  89. package/dist/server/services/CodeValidator.js +8 -4
  90. package/dist/server/services/DepartmentAttribution.js +65 -0
  91. package/dist/server/services/ExecutionSpanService.js +96 -3
  92. package/dist/server/services/GovernanceAdmission.js +271 -0
  93. package/dist/server/services/HarnessCapabilities.js +118 -0
  94. package/dist/server/services/HarnessCompiler.js +3 -0
  95. package/dist/server/services/HarnessSchema.js +13 -1
  96. package/dist/server/services/HierarchicalAgentRuntime.js +925 -0
  97. package/dist/server/services/HierarchyEnrollmentGuard.js +216 -0
  98. package/dist/server/services/HierarchyInvocationJournal.js +157 -0
  99. package/dist/server/services/HierarchyRequestCancellation.js +150 -0
  100. package/dist/server/services/LoopBudgetService.js +29 -11
  101. package/dist/server/services/LoopRunRepository.js +16 -7
  102. package/dist/server/services/LoopRunStateMachine.js +20 -9
  103. package/dist/server/services/LoopTriggerService.js +1 -1
  104. package/dist/server/services/LoopWorkerService.js +71 -37
  105. package/dist/server/services/ManagedPromptProtection.js +99 -0
  106. package/dist/server/services/NativeAgentMonitorSyncService.js +584 -0
  107. package/dist/server/services/NativeSubAgentObserver.js +141 -508
  108. package/dist/server/services/NativeUsageAttribution.js +97 -0
  109. package/dist/server/services/PluginAiRuntimeAdapter.js +107 -9
  110. package/dist/server/services/RoutingBindingRepository.js +156 -0
  111. package/dist/server/services/RoutingBindingValidation.js +161 -0
  112. package/dist/server/services/SandboxRunner.js +19 -0
  113. package/dist/server/services/SessionAutoApproval.js +173 -0
  114. package/dist/server/services/TokenTracker.js +787 -104
  115. package/dist/server/services/TracingRetentionPolicy.js +66 -0
  116. package/dist/server/services/VerificationService.js +20 -10
  117. package/dist/server/skill-hub/plugin.js +17 -0
  118. package/dist/server/skill-hub/sandbox-config.json +6 -6
  119. package/dist/server/skill-hub/services/RegistrySkillInstallationService.js +2 -2
  120. package/dist/server/skill-hub/services/registry-node-package.js +191 -0
  121. package/dist/server/skill-hub/tasks/SkillExecutionTask.js +21 -6
  122. package/dist/server/tools/skill-execute.js +1 -0
  123. package/dist/server/utils/ensure-indexes.js +15 -5
  124. package/package.json +66 -53
  125. package/server.d.ts +2 -2
  126. package/server.js +1 -1
  127. package/src/client/AgentRunsTab.tsx +2 -2
  128. package/src/client/ApprovalsTab.tsx +2 -2
  129. package/src/client/HarnessProfilesTab.tsx +2 -2
  130. package/src/client/OrchestratorSettings.tsx +152 -152
  131. package/src/client/SkillPages.tsx +34 -0
  132. package/src/client/__tests__/embedded-settings.test.tsx +225 -0
  133. package/src/client/hooks/useRunEventStream.ts +76 -76
  134. package/src/client/index.tsx +2 -2
  135. package/src/client/plugin.tsx +71 -33
  136. package/src/client/skill-hub/components/ExecutionHistory.tsx +200 -200
  137. package/src/client/skill-hub/components/GitSkillImport.tsx +562 -562
  138. package/src/client/skill-hub/components/LoopSettings.tsx +331 -331
  139. package/src/client/skill-hub/components/SkillEditor.tsx +460 -460
  140. package/src/client/skill-hub/components/SkillManager.tsx +194 -194
  141. package/src/client/skill-hub/components/SkillMetrics.tsx +162 -162
  142. package/src/client/skill-hub/components/SkillTestPanel.tsx +141 -141
  143. package/src/client/skill-hub/index.tsx +6 -6
  144. package/src/client/skill-hub/locale.ts +16 -16
  145. package/src/client/skill-hub/tools/InteractionSchemasProvider.tsx +147 -132
  146. package/src/client/skill-hub/tools/SkillHubCard.tsx +110 -104
  147. package/src/client/skill-hub/tools/__tests__/skill-hub-card.test.tsx +255 -0
  148. package/src/client/skill-hub/tools/loopTemplates.ts +52 -52
  149. package/src/client/skill-hub/tools/registerSkillLoopCards.ts +80 -71
  150. package/src/client/skill-hub/utils/jsonFields.ts +41 -41
  151. package/src/client-v2/__tests__/embedded-settings.test.tsx +202 -0
  152. package/src/client-v2/__tests__/hierarchical-routing-settings.test.tsx +350 -0
  153. package/src/client-v2/auto-approval/AutoApprovalBridge.tsx +513 -0
  154. package/src/client-v2/auto-approval/AutoApprovalProvider.tsx +399 -0
  155. package/src/client-v2/auto-approval/__tests__/session-auto-approval.test.tsx +1676 -0
  156. package/src/client-v2/components/AIEmployeeSelect.tsx +47 -47
  157. package/src/client-v2/components/AIEmployeesContext.tsx +97 -97
  158. package/src/client-v2/components/AgentBindingsTab.tsx +541 -269
  159. package/src/client-v2/components/AgentRunsTab.tsx +85 -83
  160. package/src/client-v2/components/ApprovalsTab.tsx +337 -337
  161. package/src/client-v2/components/EmployeeGovernanceTab.tsx +695 -0
  162. package/src/client-v2/components/HarnessProfilesTab.tsx +700 -541
  163. package/src/client-v2/components/HarnessSettingsForm.tsx +221 -0
  164. package/src/client-v2/components/KnowledgeAccessTab.tsx +116 -116
  165. package/src/client-v2/components/RetrievalTraceTab.tsx +162 -162
  166. package/src/client-v2/components/UsageGovernanceTab.tsx +379 -0
  167. package/src/client-v2/index.tsx +1 -1
  168. package/src/client-v2/pages/AgentBindingsPage.tsx +15 -13
  169. package/src/client-v2/pages/ApprovalsPage.tsx +12 -10
  170. package/src/client-v2/pages/EmployeeGovernancePage.tsx +15 -0
  171. package/src/client-v2/pages/ExecutionHistoryPage.tsx +12 -10
  172. package/src/client-v2/pages/HarnessProfilesPage.tsx +12 -10
  173. package/src/client-v2/pages/KnowledgeAccessPage.tsx +12 -10
  174. package/src/client-v2/pages/LoopSettingsPage.tsx +12 -10
  175. package/src/client-v2/pages/MemoryInspectorPage.tsx +15 -13
  176. package/src/client-v2/pages/RetrievalTracePage.tsx +12 -10
  177. package/src/client-v2/pages/RulesPage.tsx +15 -13
  178. package/src/client-v2/pages/SkillDefinitionsPage.tsx +12 -10
  179. package/src/client-v2/pages/SkillMetricsPage.tsx +12 -10
  180. package/src/client-v2/pages/TracingPage.tsx +15 -13
  181. package/src/client-v2/pages/UsageGovernancePage.tsx +15 -0
  182. package/src/client-v2/plugin.tsx +134 -111
  183. package/src/client-v2/skill-hub/components/ExecutionHistory.tsx +196 -196
  184. package/src/client-v2/skill-hub/components/FileLinkList.tsx +37 -37
  185. package/src/client-v2/skill-hub/components/GitSkillImport.tsx +539 -539
  186. package/src/client-v2/skill-hub/components/LoopSettings.tsx +331 -331
  187. package/src/client-v2/skill-hub/components/SkillEditor.tsx +453 -453
  188. package/src/client-v2/skill-hub/components/SkillManager.tsx +191 -174
  189. package/src/client-v2/skill-hub/components/SkillMetrics.tsx +162 -162
  190. package/src/client-v2/skill-hub/components/SkillTestPanel.tsx +135 -135
  191. package/src/client-v2/skill-hub/locale.ts +13 -13
  192. package/src/client-v2/skill-hub/tools/InteractionSchemasProvider.tsx +62 -0
  193. package/src/client-v2/skill-hub/tools/SkillHubCard.tsx +104 -0
  194. package/src/client-v2/skill-hub/tools/__tests__/interactions.test.ts +126 -0
  195. package/src/client-v2/skill-hub/tools/interactions.ts +137 -0
  196. package/src/client-v2/skill-hub/tools/loopTemplates.ts +52 -52
  197. package/src/client-v2/skill-hub/utils/jsonFields.ts +41 -41
  198. package/src/client-v2/utils/jsonFields.ts +41 -41
  199. package/src/index.ts +2 -2
  200. package/src/locale/en-US.json +308 -1
  201. package/src/locale/vi-VN.json +5 -1
  202. package/src/locale/zh-CN.json +308 -1
  203. package/src/server/__tests__/agent-execution-context.test.ts +18 -18
  204. package/src/server/__tests__/agent-governance.integration.test.ts +385 -0
  205. package/src/server/__tests__/agent-knowledge-insights.test.ts +123 -123
  206. package/src/server/__tests__/agent-monitor-acl.integration.test.ts +267 -0
  207. package/src/server/__tests__/agent-registry-service.test.ts +147 -147
  208. package/src/server/__tests__/agent-runtime-lifecycle.test.ts +46 -46
  209. package/src/server/__tests__/agent-usage-report.integration.test.ts +335 -0
  210. package/src/server/__tests__/auto-approval-checkpoint.integration.test.ts +295 -0
  211. package/src/server/__tests__/code-validator.test.ts +63 -63
  212. package/src/server/__tests__/external-rag-search.test.ts +107 -107
  213. package/src/server/__tests__/harness-capabilities.test.ts +88 -0
  214. package/src/server/__tests__/harness-compiler.test.ts +278 -214
  215. package/src/server/__tests__/harness-profile-service.test.ts +167 -167
  216. package/src/server/__tests__/harness-runtime-policy.test.ts +293 -293
  217. package/src/server/__tests__/harness-tool-plan.test.ts +175 -172
  218. package/src/server/__tests__/hierarchical-routing.integration.test.ts +2318 -0
  219. package/src/server/__tests__/hierarchy-invocation-journal.integration.test.ts +119 -0
  220. package/src/server/__tests__/input-schema-validator.test.ts +26 -26
  221. package/src/server/__tests__/loop-approval-decision.test.ts +624 -512
  222. package/src/server/__tests__/loop-approval-expiry.test.ts +258 -258
  223. package/src/server/__tests__/loop-budget-service.test.ts +29 -0
  224. package/src/server/__tests__/loop-pattern-schema.test.ts +73 -73
  225. package/src/server/__tests__/loop-run-repository.test.ts +25 -0
  226. package/src/server/__tests__/loop-run-state-machine.test.ts +101 -101
  227. package/src/server/__tests__/loop-trigger-service.test.ts +185 -148
  228. package/src/server/__tests__/loop-worker-claim.test.ts +110 -10
  229. package/src/server/__tests__/loop-worker-execution.test.ts +375 -317
  230. package/src/server/__tests__/native-agent-monitor-sync.test.ts +343 -0
  231. package/src/server/__tests__/native-hierarchy-probe.integration.test.ts +527 -0
  232. package/src/server/__tests__/native-sub-agent-observer.test.ts +463 -662
  233. package/src/server/__tests__/native-usage-attribution.integration.test.ts +168 -0
  234. package/src/server/__tests__/plugin-ai-runtime-adapter.test.ts +403 -0
  235. package/src/server/__tests__/registry-node-package.test.ts +299 -0
  236. package/src/server/__tests__/routing-binding-graph.integration.test.ts +217 -0
  237. package/src/server/__tests__/routing-binding-validation.test.ts +256 -0
  238. package/src/server/__tests__/session-auto-approval.integration.test.ts +329 -0
  239. package/src/server/__tests__/skill-access-service.test.ts +64 -64
  240. package/src/server/__tests__/skill-execute.test.ts +81 -70
  241. package/src/server/__tests__/skill-execution-task-policy.test.ts +140 -140
  242. package/src/server/__tests__/skill-review-guard.test.ts +171 -0
  243. package/src/server/__tests__/skill-sandbox-worker-mode.test.ts +15 -15
  244. package/src/server/__tests__/skill-settings.test.ts +63 -63
  245. package/src/server/__tests__/skill-tool-name.test.ts +23 -23
  246. package/src/server/__tests__/token-tracker.test.ts +632 -0
  247. package/src/server/__tests__/tool-loop-detection.test.ts +276 -276
  248. package/src/server/__tests__/tracing-retention-policy.test.ts +30 -0
  249. package/src/server/__tests__/usage-ledger.integration.test.ts +187 -0
  250. package/src/server/collections/agent-auto-approval-checkpoints.ts +18 -0
  251. package/src/server/collections/agent-execution-spans.ts +386 -245
  252. package/src/server/collections/agent-governance-audit-events.ts +19 -0
  253. package/src/server/collections/agent-governance-policies.ts +19 -0
  254. package/src/server/collections/agent-governance-policy-versions.ts +20 -0
  255. package/src/server/collections/agent-governance-prompt-bindings.ts +22 -0
  256. package/src/server/collections/agent-hierarchy-invocations.ts +30 -0
  257. package/src/server/collections/agent-loop-action-approvals.ts +39 -39
  258. package/src/server/collections/agent-loop-runs.ts +389 -369
  259. package/src/server/collections/agent-loop-steps.ts +220 -220
  260. package/src/server/collections/agent-memory-contexts.ts +95 -95
  261. package/src/server/collections/agent-routing-graph-locks.ts +11 -0
  262. package/src/server/collections/agent-session-auto-approvals.ts +16 -0
  263. package/src/server/collections/orchestrator-config.ts +113 -87
  264. package/src/server/collections/orchestrator-logs.ts +116 -116
  265. package/src/server/collections/skill-definitions.ts +159 -159
  266. package/src/server/collections/skill-executions.ts +154 -154
  267. package/src/server/collections/skill-loop-configs.ts +65 -65
  268. package/src/server/collections/skill-metrics.ts +36 -36
  269. package/src/server/collections/skill-registry-installations.ts +41 -41
  270. package/src/server/collections/skill-worker-configs.ts +86 -86
  271. package/src/server/index.ts +1 -1
  272. package/src/server/migrations/20260423000000-add-progress-fields.ts +50 -50
  273. package/src/server/migrations/20260425000000-add-interaction-schema.ts +37 -37
  274. package/src/server/migrations/20260427000000-add-tracing-detail-fields.ts +41 -41
  275. package/src/server/migrations/20260427000001-change-other-json-to-text.ts +61 -61
  276. package/src/server/migrations/20260524001000-add-plan-approval-and-harness-profiles.ts +145 -145
  277. package/src/server/migrations/20260601000000-add-token-fields.ts +89 -89
  278. package/src/server/migrations/20260615000000-normalize-ai-employee-tool-bindings.ts +39 -39
  279. package/src/server/migrations/20260621000000-native-policy-profile-defaults.ts +190 -190
  280. package/src/server/migrations/20260727000000-remove-unused-knowledge-scopes.ts +25 -25
  281. package/src/server/migrations/20260727010000-backfill-skill-tool-names.ts +45 -45
  282. package/src/server/migrations/20261110000000-add-usage-pricing-snapshots.ts +110 -0
  283. package/src/server/migrations/20261110010000-add-usage-department-attribution.ts +28 -0
  284. package/src/server/migrations/20261119000000-widen-native-employee-identifiers.ts +37 -0
  285. package/src/server/plugin.ts +724 -573
  286. package/src/server/resources/agent-auto-approval.ts +51 -0
  287. package/src/server/resources/agent-governance.ts +161 -0
  288. package/src/server/resources/agent-harness-profile.ts +103 -94
  289. package/src/server/resources/agent-knowledge-insights.ts +306 -306
  290. package/src/server/resources/agent-loop-approval.ts +84 -84
  291. package/src/server/resources/agent-loop-events-stream.ts +108 -108
  292. package/src/server/resources/agent-loop.ts +252 -252
  293. package/src/server/resources/agent-monitor.ts +208 -482
  294. package/src/server/resources/agent-usage.ts +413 -0
  295. package/src/server/resources/hierarchical-routing.ts +39 -0
  296. package/src/server/resources/native-monitor-format.ts +150 -0
  297. package/src/server/resources/tracing.ts +296 -267
  298. package/src/server/services/AgentExecutionContext.ts +23 -23
  299. package/src/server/services/AgentGovernanceService.ts +541 -0
  300. package/src/server/services/AgentMemoryContextService.ts +344 -344
  301. package/src/server/services/AgentRegistryService.ts +220 -220
  302. package/src/server/services/AgentRuntimeLifecycle.ts +64 -64
  303. package/src/server/services/AutoApprovalCheckpoint.ts +140 -0
  304. package/src/server/services/CodeValidator.ts +257 -238
  305. package/src/server/services/DepartmentAttribution.ts +47 -0
  306. package/src/server/services/DurableCircuitBreakerService.ts +235 -235
  307. package/src/server/services/ExecutionSpanService.ts +271 -146
  308. package/src/server/services/FileManager.ts +159 -159
  309. package/src/server/services/GovernanceAdmission.ts +314 -0
  310. package/src/server/services/HarnessCapabilities.ts +112 -0
  311. package/src/server/services/HarnessCompiler.ts +182 -170
  312. package/src/server/services/HarnessProfileService.ts +235 -235
  313. package/src/server/services/HarnessSchema.ts +224 -194
  314. package/src/server/services/HierarchicalAgentRuntime.ts +1052 -0
  315. package/src/server/services/HierarchyEnrollmentGuard.ts +211 -0
  316. package/src/server/services/HierarchyInvocationJournal.ts +172 -0
  317. package/src/server/services/HierarchyRequestCancellation.ts +132 -0
  318. package/src/server/services/InputSchemaValidator.ts +44 -44
  319. package/src/server/services/LoopBudgetService.ts +325 -271
  320. package/src/server/services/LoopControlService.ts +120 -120
  321. package/src/server/services/LoopPatternSchema.ts +231 -231
  322. package/src/server/services/LoopPatternService.ts +171 -171
  323. package/src/server/services/LoopRunRepository.ts +343 -332
  324. package/src/server/services/LoopRunStateMachine.ts +538 -525
  325. package/src/server/services/LoopSchedulerService.ts +195 -195
  326. package/src/server/services/LoopTriggerService.ts +162 -159
  327. package/src/server/services/LoopWorkerService.ts +975 -912
  328. package/src/server/services/ManagedPromptProtection.ts +81 -0
  329. package/src/server/services/NativeAgentMonitorSyncService.ts +684 -0
  330. package/src/server/services/NativeSubAgentObserver.ts +324 -757
  331. package/src/server/services/NativeUsageAttribution.ts +91 -0
  332. package/src/server/services/PathLockService.ts +317 -317
  333. package/src/server/services/PluginAiRuntimeAdapter.ts +518 -387
  334. package/src/server/services/RoutingBindingRepository.ts +146 -0
  335. package/src/server/services/RoutingBindingValidation.ts +161 -0
  336. package/src/server/services/RunEventBus.ts +58 -58
  337. package/src/server/services/SandboxRunner.ts +526 -492
  338. package/src/server/services/SessionAutoApproval.ts +167 -0
  339. package/src/server/services/SkillAccessService.ts +175 -175
  340. package/src/server/services/SkillManager.ts +585 -585
  341. package/src/server/services/SkillRepositoryService.ts +236 -236
  342. package/src/server/services/TokenTracker.ts +1151 -287
  343. package/src/server/services/ToolLoopDetectionService.ts +210 -210
  344. package/src/server/services/TracingRetentionPolicy.ts +49 -0
  345. package/src/server/services/VerificationSchema.ts +31 -31
  346. package/src/server/services/VerificationService.ts +325 -313
  347. package/src/server/services/WorkerEnvManager.ts +198 -198
  348. package/src/server/services/__tests__/SkillRepositoryService.test.ts +33 -33
  349. package/src/server/services/harness-runtime-policy.ts +134 -134
  350. package/src/server/services/pythonGuardTemplate.ts +87 -87
  351. package/src/server/services/sandboxCapabilities.ts +348 -348
  352. package/src/server/skill-hub/actions/__tests__/git-import.test.ts +563 -563
  353. package/src/server/skill-hub/actions/git-import.ts +936 -936
  354. package/src/server/skill-hub/mcp/McpController.ts +107 -107
  355. package/src/server/skill-hub/middlewares/git-import-request-method-policy.ts +51 -51
  356. package/src/server/skill-hub/plugin.ts +1272 -1232
  357. package/src/server/skill-hub/sandbox-config.json +6 -6
  358. package/src/server/skill-hub/services/RegistrySkillInstallationService.ts +291 -281
  359. package/src/server/skill-hub/services/__tests__/RegistrySkillInstallationService.test.ts +295 -295
  360. package/src/server/skill-hub/services/registry-node-package.ts +191 -0
  361. package/src/server/skill-hub/tasks/SkillExecutionTask.ts +597 -568
  362. package/src/server/skill-hub/utils/json-fields.ts +57 -57
  363. package/src/server/tools/delegate-task.ts +30 -30
  364. package/src/server/tools/external-rag-search.ts +329 -329
  365. package/src/server/tools/skill-execute.ts +226 -216
  366. package/src/server/types.ts +21 -21
  367. package/src/server/utils/ai-manager.ts +24 -24
  368. package/src/server/utils/ctx-utils.ts +132 -132
  369. package/src/server/utils/ensure-indexes.ts +113 -96
  370. package/src/server/utils/ha-lock.ts +80 -80
  371. package/src/server/utils/loop-pattern-context.ts +84 -84
  372. package/src/server/utils/record-utils.ts +19 -19
  373. package/src/server/utils/skill-settings.ts +135 -135
  374. package/src/server/utils/skill-tool-name.ts +58 -58
  375. package/dist/client-v2/117.7565cff57c39318a.js +0 -10
  376. package/dist/client-v2/214.106635011859dede.js +0 -10
  377. package/dist/client-v2/253.59577b40d9875be0.js +0 -10
  378. package/dist/client-v2/264.7ed8bee71fa5935c.js +0 -10
  379. package/dist/client-v2/418.41ed200e7d6da332.js +0 -10
  380. package/dist/client-v2/794.a67a2614405ba627.js +0 -10
  381. package/dist/client-v2/981.e4a1f41cfc94a856.js +0 -10
  382. package/dist/client-v2/993.b0688fdc5ccb000a.js +0 -10
  383. package/dist/node_modules/simple-git/dist/cjs/index.js +0 -7399
  384. package/dist/node_modules/simple-git/dist/esm/index.js +0 -4745
  385. package/dist/node_modules/simple-git/dist/esm/package.json +0 -3
  386. package/dist/node_modules/simple-git/dist/src/lib/api.d.ts +0 -13
  387. package/dist/node_modules/simple-git/dist/src/lib/args/log-format.d.ts +0 -9
  388. package/dist/node_modules/simple-git/dist/src/lib/errors/git-construct-error.d.ts +0 -15
  389. package/dist/node_modules/simple-git/dist/src/lib/errors/git-error.d.ts +0 -30
  390. package/dist/node_modules/simple-git/dist/src/lib/errors/git-plugin-error.d.ts +0 -7
  391. package/dist/node_modules/simple-git/dist/src/lib/errors/git-response-error.d.ts +0 -32
  392. package/dist/node_modules/simple-git/dist/src/lib/errors/task-configuration-error.d.ts +0 -12
  393. package/dist/node_modules/simple-git/dist/src/lib/git-factory.d.ts +0 -15
  394. package/dist/node_modules/simple-git/dist/src/lib/git-logger.d.ts +0 -21
  395. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-branch-delete.d.ts +0 -5
  396. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-branch.d.ts +0 -2
  397. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-commit.d.ts +0 -2
  398. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-diff-summary.d.ts +0 -3
  399. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-fetch.d.ts +0 -2
  400. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-list-log-summary.d.ts +0 -6
  401. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-merge.d.ts +0 -11
  402. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-move.d.ts +0 -2
  403. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-pull.d.ts +0 -6
  404. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-push.d.ts +0 -4
  405. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-remote-messages.d.ts +0 -5
  406. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-remote-objects.d.ts +0 -3
  407. package/dist/node_modules/simple-git/dist/src/lib/plugins/abort-plugin.d.ts +0 -3
  408. package/dist/node_modules/simple-git/dist/src/lib/plugins/block-unsafe-operations-plugin.d.ts +0 -3
  409. package/dist/node_modules/simple-git/dist/src/lib/plugins/command-config-prefixing-plugin.d.ts +0 -2
  410. package/dist/node_modules/simple-git/dist/src/lib/plugins/completion-detection.plugin.d.ts +0 -3
  411. package/dist/node_modules/simple-git/dist/src/lib/plugins/custom-binary.plugin.d.ts +0 -3
  412. package/dist/node_modules/simple-git/dist/src/lib/plugins/error-detection.plugin.d.ts +0 -7
  413. package/dist/node_modules/simple-git/dist/src/lib/plugins/index.d.ts +0 -11
  414. package/dist/node_modules/simple-git/dist/src/lib/plugins/plugin-store.d.ts +0 -11
  415. package/dist/node_modules/simple-git/dist/src/lib/plugins/progress-monitor-plugin.d.ts +0 -3
  416. package/dist/node_modules/simple-git/dist/src/lib/plugins/simple-git-plugin.d.ts +0 -48
  417. package/dist/node_modules/simple-git/dist/src/lib/plugins/spawn-options-plugin.d.ts +0 -3
  418. package/dist/node_modules/simple-git/dist/src/lib/plugins/suffix-paths.plugin.d.ts +0 -2
  419. package/dist/node_modules/simple-git/dist/src/lib/plugins/timout-plugin.d.ts +0 -3
  420. package/dist/node_modules/simple-git/dist/src/lib/responses/BranchDeleteSummary.d.ts +0 -12
  421. package/dist/node_modules/simple-git/dist/src/lib/responses/BranchSummary.d.ts +0 -14
  422. package/dist/node_modules/simple-git/dist/src/lib/responses/CheckIgnore.d.ts +0 -4
  423. package/dist/node_modules/simple-git/dist/src/lib/responses/CleanSummary.d.ts +0 -9
  424. package/dist/node_modules/simple-git/dist/src/lib/responses/ConfigList.d.ts +0 -13
  425. package/dist/node_modules/simple-git/dist/src/lib/responses/DiffSummary.d.ts +0 -10
  426. package/dist/node_modules/simple-git/dist/src/lib/responses/FileStatusSummary.d.ts +0 -9
  427. package/dist/node_modules/simple-git/dist/src/lib/responses/GetRemoteSummary.d.ts +0 -11
  428. package/dist/node_modules/simple-git/dist/src/lib/responses/InitSummary.d.ts +0 -9
  429. package/dist/node_modules/simple-git/dist/src/lib/responses/MergeSummary.d.ts +0 -16
  430. package/dist/node_modules/simple-git/dist/src/lib/responses/PullSummary.d.ts +0 -25
  431. package/dist/node_modules/simple-git/dist/src/lib/responses/StatusSummary.d.ts +0 -19
  432. package/dist/node_modules/simple-git/dist/src/lib/responses/TagList.d.ts +0 -7
  433. package/dist/node_modules/simple-git/dist/src/lib/runners/git-executor-chain.d.ts +0 -25
  434. package/dist/node_modules/simple-git/dist/src/lib/runners/git-executor.d.ts +0 -14
  435. package/dist/node_modules/simple-git/dist/src/lib/runners/promise-wrapped.d.ts +0 -2
  436. package/dist/node_modules/simple-git/dist/src/lib/runners/scheduler.d.ts +0 -11
  437. package/dist/node_modules/simple-git/dist/src/lib/runners/tasks-pending-queue.d.ts +0 -23
  438. package/dist/node_modules/simple-git/dist/src/lib/simple-git-api.d.ts +0 -20
  439. package/dist/node_modules/simple-git/dist/src/lib/task-callback.d.ts +0 -2
  440. package/dist/node_modules/simple-git/dist/src/lib/tasks/apply-patch.d.ts +0 -3
  441. package/dist/node_modules/simple-git/dist/src/lib/tasks/branch.d.ts +0 -7
  442. package/dist/node_modules/simple-git/dist/src/lib/tasks/change-working-directory.d.ts +0 -2
  443. package/dist/node_modules/simple-git/dist/src/lib/tasks/check-ignore.d.ts +0 -2
  444. package/dist/node_modules/simple-git/dist/src/lib/tasks/check-is-repo.d.ts +0 -9
  445. package/dist/node_modules/simple-git/dist/src/lib/tasks/checkout.d.ts +0 -2
  446. package/dist/node_modules/simple-git/dist/src/lib/tasks/clean.d.ts +0 -25
  447. package/dist/node_modules/simple-git/dist/src/lib/tasks/clone.d.ts +0 -9
  448. package/dist/node_modules/simple-git/dist/src/lib/tasks/commit.d.ts +0 -4
  449. package/dist/node_modules/simple-git/dist/src/lib/tasks/config.d.ts +0 -8
  450. package/dist/node_modules/simple-git/dist/src/lib/tasks/count-objects.d.ts +0 -12
  451. package/dist/node_modules/simple-git/dist/src/lib/tasks/diff-name-status.d.ts +0 -12
  452. package/dist/node_modules/simple-git/dist/src/lib/tasks/diff.d.ts +0 -5
  453. package/dist/node_modules/simple-git/dist/src/lib/tasks/fetch.d.ts +0 -4
  454. package/dist/node_modules/simple-git/dist/src/lib/tasks/first-commit.d.ts +0 -2
  455. package/dist/node_modules/simple-git/dist/src/lib/tasks/grep.d.ts +0 -12
  456. package/dist/node_modules/simple-git/dist/src/lib/tasks/hash-object.d.ts +0 -5
  457. package/dist/node_modules/simple-git/dist/src/lib/tasks/init.d.ts +0 -3
  458. package/dist/node_modules/simple-git/dist/src/lib/tasks/log.d.ts +0 -32
  459. package/dist/node_modules/simple-git/dist/src/lib/tasks/merge.d.ts +0 -4
  460. package/dist/node_modules/simple-git/dist/src/lib/tasks/move.d.ts +0 -3
  461. package/dist/node_modules/simple-git/dist/src/lib/tasks/pull.d.ts +0 -3
  462. package/dist/node_modules/simple-git/dist/src/lib/tasks/push.d.ts +0 -9
  463. package/dist/node_modules/simple-git/dist/src/lib/tasks/remote.d.ts +0 -8
  464. package/dist/node_modules/simple-git/dist/src/lib/tasks/reset.d.ts +0 -11
  465. package/dist/node_modules/simple-git/dist/src/lib/tasks/show.d.ts +0 -2
  466. package/dist/node_modules/simple-git/dist/src/lib/tasks/stash-list.d.ts +0 -4
  467. package/dist/node_modules/simple-git/dist/src/lib/tasks/status.d.ts +0 -3
  468. package/dist/node_modules/simple-git/dist/src/lib/tasks/sub-module.d.ts +0 -5
  469. package/dist/node_modules/simple-git/dist/src/lib/tasks/tag.d.ts +0 -18
  470. package/dist/node_modules/simple-git/dist/src/lib/tasks/task.d.ts +0 -14
  471. package/dist/node_modules/simple-git/dist/src/lib/tasks/version.d.ts +0 -9
  472. package/dist/node_modules/simple-git/dist/src/lib/types/handlers.d.ts +0 -21
  473. package/dist/node_modules/simple-git/dist/src/lib/types/index.d.ts +0 -136
  474. package/dist/node_modules/simple-git/dist/src/lib/types/tasks.d.ts +0 -19
  475. package/dist/node_modules/simple-git/dist/src/lib/utils/argument-filters.d.ts +0 -14
  476. package/dist/node_modules/simple-git/dist/src/lib/utils/exit-codes.d.ts +0 -10
  477. package/dist/node_modules/simple-git/dist/src/lib/utils/git-output-streams.d.ts +0 -7
  478. package/dist/node_modules/simple-git/dist/src/lib/utils/index.d.ts +0 -8
  479. package/dist/node_modules/simple-git/dist/src/lib/utils/line-parser.d.ts +0 -15
  480. package/dist/node_modules/simple-git/dist/src/lib/utils/simple-git-options.d.ts +0 -2
  481. package/dist/node_modules/simple-git/dist/src/lib/utils/task-options.d.ts +0 -13
  482. package/dist/node_modules/simple-git/dist/src/lib/utils/task-parser.d.ts +0 -5
  483. package/dist/node_modules/simple-git/dist/src/lib/utils/util.d.ts +0 -47
  484. package/dist/node_modules/simple-git/dist/typings/errors.d.ts +0 -5
  485. package/dist/node_modules/simple-git/dist/typings/index.d.ts +0 -14
  486. package/dist/node_modules/simple-git/dist/typings/response.d.ts +0 -556
  487. package/dist/node_modules/simple-git/dist/typings/simple-git.d.ts +0 -1033
  488. package/dist/node_modules/simple-git/dist/typings/types.d.ts +0 -22
  489. package/dist/node_modules/simple-git/node_modules/debug/package.json +0 -64
  490. package/dist/node_modules/simple-git/node_modules/debug/src/browser.js +0 -272
  491. package/dist/node_modules/simple-git/node_modules/debug/src/common.js +0 -292
  492. package/dist/node_modules/simple-git/node_modules/debug/src/index.js +0 -10
  493. package/dist/node_modules/simple-git/node_modules/debug/src/node.js +0 -263
  494. package/dist/node_modules/simple-git/package.json +0 -1
  495. package/dist/node_modules/simple-git/promise.js +0 -17
@@ -0,0 +1,335 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+
3
+ import { createMockServer, type MockServer } from '@nocobase/test';
4
+ import { PluginAgentOrchestratorServer } from '../plugin';
5
+
6
+ const FROM = '2026-11-01T00:00:00.000Z';
7
+ const TO = '2026-11-11T00:00:00.000Z';
8
+
9
+ type UsageCall = {
10
+ id: number;
11
+ usageIdentity: string;
12
+ usageOccurredAt: Date;
13
+ model: string;
14
+ employeeUsername: string;
15
+ userId: number;
16
+ departmentId: string | number | null;
17
+ departmentAttribution?: string | null;
18
+ usageSource: 'actual' | 'estimated' | 'missing';
19
+ inputTokens: number | null;
20
+ outputTokens: number | null;
21
+ totalTokens: number | null;
22
+ cost: number | null;
23
+ priceCurrency: string | null;
24
+ pricingStatus: string;
25
+ };
26
+
27
+ describe('agent usage reporting over HTTP', () => {
28
+ let app: MockServer;
29
+ let adminAgent: ReturnType<MockServer['agent']>;
30
+ let memberAgent: ReturnType<MockServer['agent']>;
31
+ let departmentId: string;
32
+ let inferredUserId: number;
33
+ let unassignedUserId: number;
34
+ let callIds: Record<string, string>;
35
+
36
+ beforeAll(async () => {
37
+ app = await createMockServer({
38
+ plugins: ['nocobase', PluginAgentOrchestratorServer],
39
+ name: `agent-usage-report-${process.pid}`,
40
+ acl: true,
41
+ skipSupervisor: true,
42
+ });
43
+
44
+ const users = app.db.getRepository('users');
45
+ const admin = await users.findOne({ filter: { 'roles.name': 'root' } });
46
+ if (!admin) throw new Error('Mock server did not create its root user.');
47
+ const member = await users.create({
48
+ values: { username: `usage-report-member-${process.pid}`, roles: ['member'] },
49
+ });
50
+ const inferredUser = await users.create({
51
+ values: { username: `usage-report-inferred-${process.pid}`, roles: ['member'] },
52
+ });
53
+ const unassignedUser = await users.create({
54
+ values: { username: `usage-report-unassigned-${process.pid}`, roles: ['member'] },
55
+ });
56
+ adminAgent = await app.agent().login(admin);
57
+ memberAgent = await app.agent().login(member);
58
+ inferredUserId = Number(inferredUser.id);
59
+ unassignedUserId = Number(unassignedUser.id);
60
+
61
+ const userCollection = app.db.getCollection('users');
62
+ if (!userCollection.hasField('mainDepartmentId')) {
63
+ userCollection.addField('mainDepartmentId', { type: 'bigInt', allowNull: true });
64
+ await userCollection.sync();
65
+ }
66
+ departmentId = '9007199254740993';
67
+ const otherDepartmentId = (BigInt(departmentId) + 1n).toString();
68
+ const memberships = app.db.collection({
69
+ name: 'departmentsUsers',
70
+ fields: [
71
+ { name: 'userId', type: 'bigInt', allowNull: false },
72
+ { name: 'departmentId', type: 'bigInt', allowNull: false },
73
+ ],
74
+ });
75
+ await memberships.sync();
76
+ await app.db.getRepository('users').update({
77
+ filterByTk: inferredUserId,
78
+ values: { mainDepartmentId: departmentId },
79
+ });
80
+ await app.db.getRepository('departmentsUsers').create({
81
+ values: { userId: inferredUserId, departmentId },
82
+ });
83
+
84
+ const spans = app.db.getRepository('agentExecutionSpans');
85
+ const common = {
86
+ source: 'native-plugin-ai',
87
+ type: 'model_call',
88
+ status: 'success',
89
+ pricingStatus: 'configured',
90
+ createdAt: new Date('2026-11-05T00:00:00.000Z'),
91
+ updatedAt: new Date('2026-11-05T00:00:00.000Z'),
92
+ };
93
+ const calls: Array<Omit<UsageCall, 'id'> & { rootRunId: string; startedAt: Date }> = [
94
+ {
95
+ ...common,
96
+ rootRunId: 'usage-report-a',
97
+ startedAt: new Date('2026-11-09T12:00:00.000Z'),
98
+ usageIdentity: 'usage-report:a',
99
+ usageOccurredAt: new Date('2026-11-09T12:00:00.000Z'),
100
+ model: 'model-alpha',
101
+ employeeUsername: 'employee-alice',
102
+ userId: inferredUserId,
103
+ departmentId,
104
+ departmentAttribution: 'snapshot',
105
+ usageSource: 'actual',
106
+ inputTokens: 100,
107
+ outputTokens: 50,
108
+ totalTokens: 150,
109
+ cost: 0.2,
110
+ priceCurrency: 'USD',
111
+ },
112
+ {
113
+ ...common,
114
+ rootRunId: 'usage-report-b',
115
+ startedAt: new Date('2026-11-08T12:00:00.000Z'),
116
+ usageIdentity: 'usage-report:b',
117
+ usageOccurredAt: new Date('2026-11-08T12:00:00.000Z'),
118
+ model: 'model-beta',
119
+ employeeUsername: 'employee-bob',
120
+ userId: inferredUserId,
121
+ departmentId: null,
122
+ departmentAttribution: null,
123
+ usageSource: 'estimated',
124
+ inputTokens: 20,
125
+ outputTokens: 10,
126
+ totalTokens: 30,
127
+ cost: null,
128
+ priceCurrency: null,
129
+ pricingStatus: 'unpriced',
130
+ },
131
+ {
132
+ ...common,
133
+ rootRunId: 'usage-report-c',
134
+ startedAt: new Date('2026-11-07T12:00:00.000Z'),
135
+ usageIdentity: 'usage-report:c',
136
+ usageOccurredAt: new Date('2026-11-07T12:00:00.000Z'),
137
+ model: 'model-alpha',
138
+ employeeUsername: 'employee-alice',
139
+ userId: unassignedUserId,
140
+ departmentId: null,
141
+ departmentAttribution: null,
142
+ usageSource: 'missing',
143
+ inputTokens: null,
144
+ outputTokens: null,
145
+ totalTokens: null,
146
+ cost: null,
147
+ priceCurrency: null,
148
+ pricingStatus: 'unpriced',
149
+ },
150
+ {
151
+ ...common,
152
+ rootRunId: 'usage-report-d',
153
+ startedAt: new Date('2026-11-06T12:00:00.000Z'),
154
+ usageIdentity: 'usage-report:d',
155
+ usageOccurredAt: new Date('2026-11-06T12:00:00.000Z'),
156
+ model: 'model-gamma',
157
+ employeeUsername: 'employee-carol',
158
+ userId: unassignedUserId,
159
+ departmentId: otherDepartmentId,
160
+ departmentAttribution: 'snapshot',
161
+ usageSource: 'actual',
162
+ inputTokens: 200,
163
+ outputTokens: 100,
164
+ totalTokens: 300,
165
+ cost: 1.4,
166
+ priceCurrency: 'EUR',
167
+ },
168
+ {
169
+ ...common,
170
+ rootRunId: 'usage-report-e',
171
+ startedAt: new Date('2026-11-05T12:00:00.000Z'),
172
+ usageIdentity: 'usage-report:e',
173
+ usageOccurredAt: new Date('2026-11-05T12:00:00.000Z'),
174
+ model: 'model-gamma',
175
+ employeeUsername: 'employee-carol',
176
+ userId: inferredUserId,
177
+ departmentId,
178
+ departmentAttribution: 'snapshot',
179
+ usageSource: 'actual',
180
+ inputTokens: 50,
181
+ outputTokens: 25,
182
+ totalTokens: 75,
183
+ cost: 0.6,
184
+ priceCurrency: 'USD',
185
+ },
186
+ ];
187
+
188
+ callIds = {};
189
+ for (const call of calls) {
190
+ const { rootRunId, startedAt, ...values } = call;
191
+ const row = await spans.create({ values: { ...values, rootRunId, startedAt } });
192
+ callIds[rootRunId.slice(-1)] = String(row.id);
193
+ }
194
+ });
195
+
196
+ afterAll(async () => {
197
+ await app?.destroy();
198
+ });
199
+
200
+ it('allows administrators to query reports and denies authenticated members', async () => {
201
+ const adminResponse = await adminAgent.resource('agentUsage').summary({ from: FROM, to: TO });
202
+ expect(adminResponse.status).toBe(200);
203
+ expect(adminResponse.body.data.data.calls).toBe(5);
204
+
205
+ const memberResponse = await memberAgent.resource('agentUsage').summary({ from: FROM, to: TO });
206
+ expect(memberResponse.status).toBe(403);
207
+ await expect(memberAgent.resource('agentUsage').calls({ from: FROM, to: TO })).resolves.toMatchObject({
208
+ status: 403,
209
+ });
210
+ await expect(
211
+ memberAgent.resource('agentUsage').breakdown({ from: FROM, to: TO, groupBy: 'model' }),
212
+ ).resolves.toMatchObject({
213
+ status: 403,
214
+ });
215
+ });
216
+
217
+ it('filters calls by date, model, employee, user, and snapshot department', async () => {
218
+ const dateFilter = {
219
+ from: '2026-11-09T00:00:00.000Z',
220
+ to: '2026-11-10T00:00:00.000Z',
221
+ };
222
+ const individualFilters = [
223
+ { model: 'model-alpha' },
224
+ { employeeUsername: 'employee-alice' },
225
+ { userId: inferredUserId },
226
+ { departmentId },
227
+ ];
228
+ for (const filter of individualFilters) {
229
+ const filtered = await adminAgent.resource('agentUsage').calls({ ...dateFilter, ...filter });
230
+ expect(
231
+ filtered.body.data.data.map((row: UsageCall) => row.usageIdentity),
232
+ `Filter ${JSON.stringify(filter)} should retain the matching call.`,
233
+ ).toContain('usage-report:a');
234
+ }
235
+
236
+ const response = await adminAgent.resource('agentUsage').calls({
237
+ ...dateFilter,
238
+ model: 'model-alpha',
239
+ employeeUsername: 'employee-alice',
240
+ userId: inferredUserId,
241
+ departmentId,
242
+ page: 1,
243
+ pageSize: 10,
244
+ });
245
+
246
+ expect(response.status).toBe(200);
247
+ expect(response.body.data.data).toHaveLength(1);
248
+ expect(response.body.data.data[0]).toMatchObject({
249
+ id: callIds.a,
250
+ usageIdentity: 'usage-report:a',
251
+ departmentId,
252
+ departmentAttribution: 'snapshot',
253
+ });
254
+
255
+ const outsideRange = await adminAgent.resource('agentUsage').calls({
256
+ from: FROM,
257
+ to: '2026-11-09T00:00:00.000Z',
258
+ model: 'model-alpha',
259
+ });
260
+ expect(outsideRange.status).toBe(200);
261
+ expect(outsideRange.body.data.data.map((row: UsageCall) => row.usageIdentity)).toContain('usage-report:c');
262
+ expect(outsideRange.body.data.data.map((row: UsageCall) => row.usageIdentity)).not.toContain('usage-report:a');
263
+ });
264
+
265
+ it('reports missing and estimated usage, inferred and unknown departments, and currency-separated costs', async () => {
266
+ const response = await adminAgent.resource('agentUsage').summary({
267
+ from: FROM,
268
+ to: TO,
269
+ includeInferredDepartment: true,
270
+ });
271
+
272
+ expect(response.status).toBe(200);
273
+ expect(response.body.data.data).toMatchObject({
274
+ calls: 5,
275
+ actualCalls: 3,
276
+ estimatedCalls: 1,
277
+ missingCalls: 1,
278
+ unpricedCalls: 2,
279
+ snapshotCalls: 3,
280
+ inferredCalls: 1,
281
+ unattributedCalls: 1,
282
+ inputTokens: null,
283
+ outputTokens: null,
284
+ totalTokens: null,
285
+ });
286
+ expect(response.body.data.data.knownTotalTokens).toBe(555);
287
+ expect(response.body.data.data.totalTokensReportedCalls).toBe(4);
288
+ expect(response.body.data.data.coverage.departmentAttribution).toBe('snapshot-or-current-membership-inference');
289
+ expect(response.body.data.data.coverage.inferenceAvailable).toBe(true);
290
+ expect(response.body.data.data.costByCurrency).toEqual(
291
+ expect.arrayContaining([
292
+ expect.objectContaining({ currency: 'EUR', knownCost: 1.4 }),
293
+ expect.objectContaining({ currency: 'USD', knownCost: 0.8 }),
294
+ ]),
295
+ );
296
+
297
+ const breakdown = await adminAgent.resource('agentUsage').breakdown({
298
+ from: FROM,
299
+ to: TO,
300
+ groupBy: 'departmentId',
301
+ includeInferredDepartment: true,
302
+ page: 1,
303
+ pageSize: 100,
304
+ });
305
+ expect(breakdown.status).toBe(200);
306
+ expect(breakdown.body.data.data).toEqual(
307
+ expect.arrayContaining([
308
+ expect.objectContaining({ key: departmentId, departmentAttribution: 'snapshot', currency: 'USD' }),
309
+ expect.objectContaining({ key: departmentId, departmentAttribution: 'inferred', currency: null }),
310
+ expect.objectContaining({ key: null, departmentAttribution: 'unknown', currency: null }),
311
+ ]),
312
+ );
313
+ });
314
+
315
+ it('paginates persisted calls in stable time order and rejects invalid filters', async () => {
316
+ const first = await adminAgent.resource('agentUsage').calls({ from: FROM, to: TO, page: 1, pageSize: 2 });
317
+ const second = await adminAgent.resource('agentUsage').calls({ from: FROM, to: TO, page: 2, pageSize: 2 });
318
+ const third = await adminAgent.resource('agentUsage').calls({ from: FROM, to: TO, page: 3, pageSize: 2 });
319
+
320
+ expect(first.status).toBe(200);
321
+ expect(first.body.data.meta).toMatchObject({ count: 5, page: 1, pageSize: 2, totalPage: 3 });
322
+ expect(first.body.data.data.map((row: UsageCall) => row.usageIdentity)).toEqual([
323
+ 'usage-report:a',
324
+ 'usage-report:b',
325
+ ]);
326
+ expect(second.body.data.data.map((row: UsageCall) => row.usageIdentity)).toEqual([
327
+ 'usage-report:c',
328
+ 'usage-report:d',
329
+ ]);
330
+ expect(third.body.data.data.map((row: UsageCall) => row.usageIdentity)).toEqual(['usage-report:e']);
331
+
332
+ const invalid = await adminAgent.resource('agentUsage').calls({ from: TO, to: FROM });
333
+ expect(invalid.status).toBe(400);
334
+ });
335
+ });
@@ -0,0 +1,295 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ import { createMockServer, type MockServer } from '@nocobase/test';
3
+ import { randomUUID } from 'node:crypto';
4
+ import { afterAll, beforeAll, describe, expect, it } from 'vitest';
5
+ import { z } from 'zod';
6
+ import { PluginAgentOrchestratorServer } from '../plugin';
7
+ import { getAIToolsManager } from '../utils/ai-manager';
8
+
9
+ type InterruptCall = {
10
+ id: string;
11
+ name: string;
12
+ args: Record<string, unknown>;
13
+ interrupt: boolean;
14
+ };
15
+
16
+ describe('session auto-approval checkpoints', () => {
17
+ let app: MockServer;
18
+ let ownerAgent: ReturnType<MockServer['agent']>;
19
+ let ownerId: number;
20
+ let username: string;
21
+ let toolA: string;
22
+ let toolB: string;
23
+ let backendTool: string;
24
+ let messageSequence: number;
25
+
26
+ beforeAll(async () => {
27
+ const suffix = `${process.pid}-${Date.now()}`;
28
+ username = 'dex';
29
+ toolA = `checkpoint_tool_a_${suffix.replace(/-/g, '_')}`;
30
+ toolB = `checkpoint_tool_b_${suffix.replace(/-/g, '_')}`;
31
+ backendTool = `checkpoint_backend_${suffix.replace(/-/g, '_')}`;
32
+ messageSequence = Date.now() * 1000;
33
+ app = await createMockServer({
34
+ plugins: ['nocobase', PluginAgentOrchestratorServer],
35
+ name: `auto-approval-checkpoint-${suffix}`,
36
+ acl: true,
37
+ skipSupervisor: true,
38
+ });
39
+
40
+ const owner = await app.db.getRepository('users').findOne({ filter: { 'roles.name': 'root' } });
41
+ if (!owner) throw new Error('Mock server did not seed a root user.');
42
+ ownerId = Number(owner.id);
43
+ ownerAgent = await app.agent().login(owner);
44
+
45
+ const tools = getAIToolsManager(app);
46
+ for (const name of [toolA, toolB, backendTool]) {
47
+ tools.registerTools({
48
+ scope: 'CUSTOM',
49
+ execution: 'backend',
50
+ defaultPermission: 'ALLOW',
51
+ definition: {
52
+ name,
53
+ description: 'Tool fixture for automatic approval checkpoint tests.',
54
+ schema: z.object({ value: z.string().optional() }),
55
+ },
56
+ invoke: async (_ctx: unknown, input: { value?: string }) => ({
57
+ status: 'success',
58
+ content: input.value ?? 'ok',
59
+ }),
60
+ });
61
+ }
62
+ });
63
+
64
+ afterAll(async () => {
65
+ await app?.destroy();
66
+ });
67
+
68
+ const createCheckpointFixture = async (input: { calls?: InterruptCall[]; interruptId?: string } = {}) => {
69
+ const sessionId = randomUUID();
70
+ const messageId = ++messageSequence;
71
+ const interruptId = input.interruptId ?? `interrupt-${randomUUID()}`;
72
+ const calls = input.calls ?? [
73
+ { id: `call-a-${randomUUID()}`, name: toolA, args: { value: 'A' }, interrupt: true },
74
+ { id: `call-b-${randomUUID()}`, name: toolB, args: { value: 'B' }, interrupt: true },
75
+ { id: `call-backend-${randomUUID()}`, name: backendTool, args: { value: 'done' }, interrupt: false },
76
+ ];
77
+ await app.db.getRepository('aiConversations').create({
78
+ values: { sessionId, userId: ownerId, aiEmployeeUsername: username, title: 'Approval checkpoint fixture' },
79
+ });
80
+ const message = await app.db.getRepository(`aiConversations.messages`, sessionId).create({
81
+ values: {
82
+ messageId,
83
+ role: username,
84
+ content: { type: 'text', content: 'Approval checkpoint fixture.' },
85
+ toolCalls: calls.map(({ id, name, args }) => ({ id, name, args })),
86
+ metadata: { interruptId },
87
+ },
88
+ });
89
+ const toolMessages = app.db.getRepository('aiToolMessages');
90
+ for (const [index, call] of calls.entries()) {
91
+ const invokeStatus = call.interrupt ? 'interrupted' : 'done';
92
+ await toolMessages.create({
93
+ values: {
94
+ id: ++messageSequence,
95
+ sessionId,
96
+ messageId,
97
+ toolCallId: call.id,
98
+ toolName: call.name,
99
+ status: call.interrupt ? null : 'success',
100
+ content: call.interrupt ? null : 'previously completed',
101
+ invokeStatus,
102
+ auto: !call.interrupt,
103
+ execution: 'backend',
104
+ interruptActionOrder: index,
105
+ interruptAction: call.interrupt
106
+ ? {
107
+ order: index,
108
+ toolCall: { id: call.id, name: call.name, args: call.args },
109
+ allowedDecisions: ['approve', 'reject', 'edit'],
110
+ currentConversation: { sessionId, username, from: 'main-agent' },
111
+ }
112
+ : null,
113
+ },
114
+ });
115
+ }
116
+ await app.db.getRepository('agentSessionAutoApprovals').create({ values: { ownerId, sessionId, enabled: true } });
117
+ return { sessionId, messageId: String(messageId), interruptId, calls, message };
118
+ };
119
+
120
+ const decide = (
121
+ identity: { sessionId: string; messageId: string; toolCallId: string },
122
+ decision: 'approve' | 'reject',
123
+ automatic = false,
124
+ ) =>
125
+ ownerAgent.resource('aiConversations').updateUserDecision({
126
+ values: {
127
+ ...identity,
128
+ userDecision: { type: decision },
129
+ ...(automatic ? { agentAutoApproval: true } : {}),
130
+ },
131
+ });
132
+
133
+ it('lets one manual rejection finalize an enrolled checkpoint after automatic approval is disabled', async () => {
134
+ const fixture = await createCheckpointFixture();
135
+ const [callA, callB] = fixture.calls;
136
+ if (!callA || !callB) throw new Error('The multi-tool checkpoint fixture is incomplete.');
137
+ const first = await decide(
138
+ { sessionId: fixture.sessionId, messageId: fixture.messageId, toolCallId: callA.id },
139
+ 'approve',
140
+ true,
141
+ );
142
+ const firstData = first.body.data;
143
+ expect(first.status).toBe(200);
144
+ expect(firstData.updated).toBe(0);
145
+ expect(firstData.agentAutoApprovalCheckpoint).toMatchObject({
146
+ interruptId: fixture.interruptId,
147
+ decisionRecorded: true,
148
+ canFinalize: false,
149
+ validSnapshot: true,
150
+ });
151
+ expect(firstData.toolCalls).toHaveLength(3);
152
+ expect(firstData.toolCalls.find((call: { id: string }) => call.id === callA.id)).toMatchObject({
153
+ invokeStatus: 'waiting',
154
+ userDecision: { type: 'approve' },
155
+ willInterrupt: true,
156
+ });
157
+ expect(firstData.toolCalls.find((call: { id: string }) => call.id === callB.id)).toMatchObject({
158
+ invokeStatus: 'interrupted',
159
+ willInterrupt: true,
160
+ });
161
+ expect(firstData.toolCalls.find((call: { name: string }) => call.name === backendTool)).toMatchObject({
162
+ invokeStatus: 'done',
163
+ willInterrupt: false,
164
+ });
165
+
166
+ await ownerAgent.resource('agentAutoApproval').set({
167
+ values: { sessionId: fixture.sessionId, enabled: false },
168
+ });
169
+ const final = await decide(
170
+ { sessionId: fixture.sessionId, messageId: fixture.messageId, toolCallId: callB.id },
171
+ 'reject',
172
+ );
173
+ expect(final.status).toBe(200);
174
+ expect(final.body.data.updated).toBe(1);
175
+ expect(final.body.data.agentAutoApprovalCheckpoint).toMatchObject({
176
+ interruptId: fixture.interruptId,
177
+ decisionRecorded: true,
178
+ canFinalize: true,
179
+ validSnapshot: true,
180
+ });
181
+ expect(final.body.data.toolCalls).toHaveLength(3);
182
+ expect(final.body.data.toolCalls.map((call: { invokeStatus: string }) => call.invokeStatus)).toEqual([
183
+ 'waiting',
184
+ 'waiting',
185
+ 'done',
186
+ ]);
187
+ expect(final.body.data.toolCalls[1].userDecision).toEqual({ type: 'reject' });
188
+ expect(final.body.data.toolCalls[2].willInterrupt).toBe(false);
189
+
190
+ const duplicate = await decide(
191
+ { sessionId: fixture.sessionId, messageId: fixture.messageId, toolCallId: callB.id },
192
+ 'reject',
193
+ );
194
+ expect(duplicate.body.data.updated).toBe(0);
195
+ expect(duplicate.body.data.agentAutoApprovalCheckpoint.canFinalize).toBe(false);
196
+ expect(
197
+ await app.db.getRepository('agentAutoApprovalCheckpoints').count({
198
+ filter: { ownerId, sessionId: fixture.sessionId, interruptId: fixture.interruptId, status: 'issued' },
199
+ }),
200
+ ).toBe(1);
201
+ });
202
+
203
+ it('issues a checkpoint exactly once for concurrent native decisions', async () => {
204
+ const fixture = await createCheckpointFixture();
205
+ const [callA, callB] = fixture.calls;
206
+ if (!callA || !callB) throw new Error('The multi-tool checkpoint fixture is incomplete.');
207
+
208
+ const results = await Promise.all(
209
+ [callA, callB].map((call) =>
210
+ decide({ sessionId: fixture.sessionId, messageId: fixture.messageId, toolCallId: call.id }, 'approve', true),
211
+ ),
212
+ );
213
+
214
+ expect(results.filter((result) => result.body.data.updated === 1)).toHaveLength(1);
215
+ expect(results.filter((result) => result.body.data.agentAutoApprovalCheckpoint?.canFinalize === true)).toHaveLength(
216
+ 1,
217
+ );
218
+ expect(
219
+ await app.db.getRepository('agentAutoApprovalCheckpoints').count({
220
+ filter: { ownerId, sessionId: fixture.sessionId, interruptId: fixture.interruptId, status: 'issued' },
221
+ }),
222
+ ).toBe(1);
223
+ });
224
+
225
+ it('uses a fresh claim for a new interrupt and keeps single-tool approval on the native path', async () => {
226
+ const fixture = await createCheckpointFixture();
227
+ const callA = fixture.calls[0];
228
+ if (!callA) throw new Error('The checkpoint fixture has no first tool.');
229
+ const first = await decide(
230
+ { sessionId: fixture.sessionId, messageId: fixture.messageId, toolCallId: callA.id },
231
+ 'approve',
232
+ true,
233
+ );
234
+ expect(first.body.data.agentAutoApprovalCheckpoint.canFinalize).toBe(false);
235
+
236
+ const nextInterruptId = `interrupt-${randomUUID()}`;
237
+ await app.db
238
+ .getModel('aiMessages')
239
+ .update(
240
+ { metadata: { interruptId: nextInterruptId } },
241
+ { where: { sessionId: fixture.sessionId, messageId: Number(fixture.messageId) } },
242
+ );
243
+ await app.db
244
+ .getModel('aiToolMessages')
245
+ .update(
246
+ { invokeStatus: 'interrupted', status: null, content: null, userDecision: null, auto: false },
247
+ { where: { sessionId: fixture.sessionId, messageId: Number(fixture.messageId) } },
248
+ );
249
+ await ownerAgent.resource('agentAutoApproval').set({
250
+ values: { sessionId: fixture.sessionId, enabled: true },
251
+ });
252
+ const second = await decide(
253
+ { sessionId: fixture.sessionId, messageId: fixture.messageId, toolCallId: callA.id },
254
+ 'approve',
255
+ true,
256
+ );
257
+ expect(second.body.data.agentAutoApprovalCheckpoint.interruptId).toBe(nextInterruptId);
258
+ expect(second.body.data.agentAutoApprovalCheckpoint.canFinalize).toBe(false);
259
+ expect(
260
+ await app.db
261
+ .getRepository('agentAutoApprovalCheckpoints')
262
+ .count({ filter: { ownerId, sessionId: fixture.sessionId } }),
263
+ ).toBe(2);
264
+
265
+ const single = await createCheckpointFixture({
266
+ calls: [{ id: `call-single-${randomUUID()}`, name: toolA, args: { value: 'single' }, interrupt: true }],
267
+ });
268
+ const singleCall = single.calls[0];
269
+ if (!singleCall) throw new Error('The single-tool checkpoint fixture is incomplete.');
270
+ const singleResult = await decide(
271
+ { sessionId: single.sessionId, messageId: single.messageId, toolCallId: singleCall.id },
272
+ 'approve',
273
+ true,
274
+ );
275
+ expect(singleResult.body.data.updated).toBe(1);
276
+ expect(singleResult.body.data.agentAutoApprovalCheckpoint).toBeUndefined();
277
+ expect(
278
+ await app.db.getRepository('agentAutoApprovalCheckpoints').count({ filter: { sessionId: single.sessionId } }),
279
+ ).toBe(0);
280
+ });
281
+
282
+ it('rejects direct access to checkpoint records', async () => {
283
+ const result = await ownerAgent.resource('agentAutoApprovalCheckpoints').create({
284
+ values: {
285
+ checkpointKey: `manual-${randomUUID()}`,
286
+ ownerId,
287
+ sessionId: randomUUID(),
288
+ messageId: 'manual',
289
+ interruptId: 'manual',
290
+ status: 'pending',
291
+ },
292
+ });
293
+ expect(result.status).toBe(403);
294
+ });
295
+ });