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,332 +1,350 @@
1
- import type { Database, Model } from '@nocobase/database';
2
- import { getRunEventBus } from './RunEventBus';
3
- import { read } from '../utils/record-utils';
4
-
5
- export type LoopRunRecord = Record<string, unknown>;
6
-
7
- export class LoopRunAccessError extends Error {
8
- constructor(
9
- public readonly status: 401 | 403 | 404 | 409,
10
- message: string,
11
- ) {
12
- super(message);
13
- this.name = 'LoopRunAccessError';
14
- }
15
- }
16
-
17
- function plain(record: Model | LoopRunRecord): LoopRunRecord {
18
- return typeof (record as Model).toJSON === 'function'
19
- ? ((record as Model).toJSON() as LoopRunRecord)
20
- : structuredClone(record as LoopRunRecord);
21
- }
22
-
23
- function positiveId(value: unknown, label: string) {
24
- const parsed = typeof value === 'number' ? value : Number(value);
25
- if (!Number.isSafeInteger(parsed) || parsed <= 0) {
26
- throw new LoopRunAccessError(404, `${label} was not found.`);
27
- }
28
- return parsed;
29
- }
30
-
31
- function requireUserId(userId: number | undefined) {
32
- if (!Number.isSafeInteger(userId) || Number(userId) <= 0) {
33
- throw new LoopRunAccessError(401, 'Authentication is required.');
34
- }
35
- return Number(userId);
36
- }
37
-
38
- function mergeFilter(filter: Record<string, unknown>, required: Record<string, unknown>) {
39
- return Object.keys(filter).length > 0 ? { $and: [filter, required] } : required;
40
- }
41
-
42
- export class LoopRunRepository {
43
- constructor(private readonly database: Database) {}
44
-
45
- async requireRun(runId: string | number) {
46
- const id = positiveId(runId, 'Agent loop run');
47
- const record = await this.database.getRepository('agentLoopRuns').findOne({ filterByTk: id });
48
- if (!record) throw new LoopRunAccessError(404, `Agent loop run ${id} was not found.`);
49
- return plain(record);
50
- }
51
-
52
- async requireOwnedRun(runId: string | number, userId: number | undefined, isAdmin: boolean) {
53
- const authenticatedUserId = requireUserId(userId);
54
- const run = await this.requireRun(runId);
55
- if (!isAdmin && Number(run.userId) !== authenticatedUserId) {
56
- throw new LoopRunAccessError(403, 'You cannot access this agent loop run.');
57
- }
58
- return run;
59
- }
60
-
61
- async requireMutableV2Run(runId: string | number, userId: number | undefined, isAdmin: boolean) {
62
- const run = await this.requireOwnedRun(runId, userId, isAdmin);
63
- if (run.runtimeVersion !== 'control-plane-v2') {
64
- throw new LoopRunAccessError(409, 'Historical plan-era runs are read-only.');
65
- }
66
- return run;
67
- }
68
-
69
- async listOwnedRuns(input: {
70
- userId: number | undefined;
71
- isAdmin: boolean;
72
- filter?: Record<string, unknown>;
73
- sort?: string[];
74
- page?: number;
75
- pageSize?: number;
76
- }) {
77
- const userId = requireUserId(input.userId);
78
- const page = Number.isSafeInteger(input.page) && Number(input.page) > 0 ? Number(input.page) : 1;
79
- const pageSize =
80
- Number.isSafeInteger(input.pageSize) && Number(input.pageSize) > 0 ? Math.min(Number(input.pageSize), 100) : 20;
81
- const requestedFilter = input.filter || {};
82
- const filter = input.isAdmin ? requestedFilter : mergeFilter(requestedFilter, { userId });
83
- const [rows, count] = await this.database.getRepository('agentLoopRuns').findAndCount({
84
- filter,
85
- sort: input.sort || ['-createdAt'],
86
- offset: (page - 1) * pageSize,
87
- limit: pageSize,
88
- });
89
- return {
90
- rows: rows.map(plain),
91
- count,
92
- page,
93
- pageSize,
94
- totalPage: Math.ceil(count / pageSize),
95
- };
96
- }
97
-
98
- async listOwnedRunIds(userId: number | undefined, isAdmin: boolean) {
99
- const authenticatedUserId = requireUserId(userId);
100
- const repository = this.database.getRepository('agentLoopRuns');
101
- const filter = isAdmin ? {} : { userId: authenticatedUserId };
102
- const pageSize = 5_000;
103
- const ids: number[] = [];
104
- for (let page = 1; ; page += 1) {
105
- const rows = await repository.find({ filter, fields: ['id'], sort: ['id'], page, pageSize });
106
- for (const row of rows) {
107
- ids.push(positiveId(read(row, 'id'), 'Agent loop run'));
108
- }
109
- if (rows.length < pageSize) break;
110
- }
111
- return ids;
112
- }
113
-
114
- async getOwnedRunDetail(runId: string | number, userId: number | undefined, isAdmin: boolean) {
115
- const run = await this.requireOwnedRun(runId, userId, isAdmin);
116
- const id = positiveId(run.id, 'Agent loop run');
117
- const rootRunId = typeof run.rootRunId === 'string' ? run.rootRunId : '';
118
- const [steps, events, spans, artifacts, approvals, skillExecutions] = await Promise.all([
119
- this.database.getRepository('agentLoopSteps').find({ filter: { runId: id }, sort: ['index', 'createdAt'] }),
120
- this.database.getRepository('agentLoopEvents').find({ filter: { runId: id }, sort: ['id'], pageSize: 1000 }),
121
- this.database
122
- .getRepository('agentExecutionSpans')
123
- .find({ filter: { agentLoopRunId: id }, sort: ['createdAt'], pageSize: 1000 }),
124
- this.database.getRepository('agentLoopArtifacts').find({ filter: { runId: id }, sort: ['createdAt'] }),
125
- this.database.getRepository('agentLoopActionApprovals').find({ filter: { runId: id }, sort: ['createdAt'] }),
126
- this.database.getRepository('skillExecutions')
127
- ? this.database
128
- .getRepository('skillExecutions')
129
- .find({ filter: { agentLoopRunId: String(id) }, sort: ['createdAt'], pageSize: 1000 })
130
- : [],
131
- ]);
132
- return {
133
- run: {
134
- ...run,
135
- historical: run.runtimeVersion !== 'control-plane-v2',
136
- readOnly: run.runtimeVersion !== 'control-plane-v2',
137
- },
138
- steps: steps.map(plain),
139
- events: events.map(plain),
140
- spans: spans.map(plain),
141
- artifacts: artifacts.map(plain),
142
- approvals: approvals.map(plain),
143
- skillExecutions: skillExecutions.map(plain),
144
- rootRunId,
145
- };
146
- }
147
-
148
- async listApprovals(input: {
149
- userId: number | undefined;
150
- isAdmin: boolean;
151
- filter?: Record<string, unknown>;
152
- sort?: string[];
153
- page?: number;
154
- pageSize?: number;
155
- }) {
156
- const userId = requireUserId(input.userId);
157
- // Scope via the run association so ownership holds for any number of runs
158
- // (a materialized id list would silently truncate for prolific users).
159
- const accessible = input.isAdmin
160
- ? {}
161
- : {
162
- $or: [{ assignedToId: userId }, { 'run.userId': userId }],
163
- };
164
- return this.findAndCount('agentLoopActionApprovals', input, accessible);
165
- }
166
-
167
- async requireAccessibleApproval(approvalId: string | number, userId: number | undefined, isAdmin: boolean) {
168
- const authenticatedUserId = requireUserId(userId);
169
- const id = positiveId(approvalId, 'Agent loop approval');
170
- const record = await this.database.getRepository('agentLoopActionApprovals').findOne({ filterByTk: id });
171
- if (!record) throw new LoopRunAccessError(404, `Agent loop approval ${id} was not found.`);
172
- const approval = plain(record);
173
- const run = await this.requireRun(positiveId(approval.runId, 'Agent loop run'));
174
- if (
175
- !isAdmin &&
176
- Number(run.userId) !== authenticatedUserId &&
177
- Number(approval.assignedToId) !== authenticatedUserId
178
- ) {
179
- throw new LoopRunAccessError(403, 'You cannot access this agent loop approval.');
180
- }
181
- return approval;
182
- }
183
-
184
- // Records a human decision on one approval and requeues the run once every pending approval of
185
- // the run has been decided. Fail-closed throughout: an expired window, a decided row, or a run
186
- // that moved on all reject the decision instead of guessing what the human meant.
187
- async decideApproval(input: {
188
- approvalId: string | number;
189
- userId: number | undefined;
190
- isAdmin: boolean;
191
- decision: 'approved' | 'rejected';
192
- note?: string;
193
- editedInput?: unknown;
194
- }) {
195
- const decidedById = requireUserId(input.userId);
196
- const id = positiveId(input.approvalId, 'Agent loop approval');
197
- // Fast access check before taking row locks; the transaction re-reads the rows anyway.
198
- await this.requireAccessibleApproval(id, input.userId, input.isAdmin);
199
-
200
- const committed = await this.database.sequelize.transaction(async (transaction) => {
201
- const approvals = this.database.getRepository('agentLoopActionApprovals');
202
- const runs = this.database.getRepository('agentLoopRuns');
203
- const record = await approvals.findOne({ filterByTk: id, transaction, lock: transaction.LOCK.UPDATE });
204
- if (!record) throw new LoopRunAccessError(404, `Agent loop approval ${id} was not found.`);
205
- const approval = plain(record);
206
-
207
- if (approval.status !== 'pending') {
208
- throw new LoopRunAccessError(409, `This approval has already been ${String(approval.status)}.`);
209
- }
210
- const expiresAt = approval.expiresAt ? new Date(String(approval.expiresAt)) : null;
211
- if (expiresAt && !Number.isNaN(expiresAt.getTime()) && expiresAt.getTime() <= Date.now()) {
212
- throw new LoopRunAccessError(409, 'The approval window has expired. Retry the run to request approval again.');
213
- }
214
-
215
- const runId = positiveId(approval.runId, 'Agent loop run');
216
- const runRecord = await runs.findOne({ filterByTk: runId, transaction, lock: transaction.LOCK.UPDATE });
217
- if (!runRecord) throw new LoopRunAccessError(404, `Agent loop run ${runId} was not found.`);
218
- const run = plain(runRecord);
219
- if (run.runtimeVersion !== 'control-plane-v2') {
220
- throw new LoopRunAccessError(409, 'Historical plan-era runs are read-only.');
221
- }
222
- // A paused run keeps its decisions; the human resume requeues it later. Any other status
223
- // means the run moved on and the decision can no longer be applied.
224
- if (run.status !== 'waiting_approval' && run.status !== 'paused') {
225
- throw new LoopRunAccessError(409, 'The run is no longer waiting for approval.');
226
- }
227
-
228
- const now = new Date();
229
- await approvals.update({
230
- filterByTk: id,
231
- values: {
232
- status: input.decision,
233
- decidedById,
234
- decidedAt: now,
235
- decisionNote: input.note || null,
236
- ...(input.decision === 'approved' && input.editedInput !== undefined
237
- ? { editedInput: input.editedInput }
238
- : {}),
239
- },
240
- transaction,
241
- });
242
-
243
- const remaining = await approvals.find({ filter: { runId, status: 'pending' }, transaction });
244
- let requeued = false;
245
- let event: LoopRunRecord | null = null;
246
- if (!remaining.length && run.status === 'waiting_approval') {
247
- await runs.update({
248
- filterByTk: runId,
249
- values: { status: 'queued', approvalStatus: 'decided' },
250
- transaction,
251
- });
252
- const created = await this.database.getRepository('agentLoopEvents').create({
253
- values: {
254
- runId,
255
- type: 'run_approval_decided',
256
- title: 'Approvals decided',
257
- content: 'All pending action approvals were decided. Run requeued to resume.',
258
- status: 'queued',
259
- payload: { decision: input.decision },
260
- actorType: 'human',
261
- actorIdentity: String(decidedById),
262
- correlationKey: `approval-decided:${runId}`,
263
- createdAt: now,
264
- },
265
- transaction,
266
- });
267
- event = typeof created.toJSON === 'function' ? created.toJSON() : created;
268
- requeued = true;
269
- }
270
- return { approval, runId, requeued, event };
271
- });
272
-
273
- if (committed.requeued && committed.event) getRunEventBus().emit(committed.runId, committed.event);
274
- return {
275
- ...committed.approval,
276
- status: input.decision,
277
- decidedById,
278
- requeued: committed.requeued,
279
- };
280
- }
281
-
282
- async listArtifacts(input: {
283
- userId: number | undefined;
284
- isAdmin: boolean;
285
- filter?: Record<string, unknown>;
286
- sort?: string[];
287
- page?: number;
288
- pageSize?: number;
289
- }) {
290
- const userId = requireUserId(input.userId);
291
- const accessible = input.isAdmin ? {} : { 'run.userId': userId };
292
- return this.findAndCount('agentLoopArtifacts', input, accessible);
293
- }
294
-
295
- async requireOwnedArtifact(artifactId: string | number, userId: number | undefined, isAdmin: boolean) {
296
- const id = positiveId(artifactId, 'Agent loop artifact');
297
- const record = await this.database.getRepository('agentLoopArtifacts').findOne({ filterByTk: id });
298
- if (!record) throw new LoopRunAccessError(404, `Agent loop artifact ${id} was not found.`);
299
- const artifact = plain(record);
300
- await this.requireOwnedRun(positiveId(artifact.runId, 'Agent loop run'), userId, isAdmin);
301
- return artifact;
302
- }
303
-
304
- private async findAndCount(
305
- collection: string,
306
- input: {
307
- filter?: Record<string, unknown>;
308
- sort?: string[];
309
- page?: number;
310
- pageSize?: number;
311
- },
312
- accessible: Record<string, unknown>,
313
- ) {
314
- const page = Number.isSafeInteger(input.page) && Number(input.page) > 0 ? Number(input.page) : 1;
315
- const pageSize =
316
- Number.isSafeInteger(input.pageSize) && Number(input.pageSize) > 0 ? Math.min(Number(input.pageSize), 100) : 20;
317
- const filter = mergeFilter(input.filter || {}, accessible);
318
- const [rows, count] = await this.database.getRepository(collection).findAndCount({
319
- filter,
320
- sort: input.sort || ['-createdAt'],
321
- offset: (page - 1) * pageSize,
322
- limit: pageSize,
323
- });
324
- return {
325
- rows: rows.map(plain),
326
- count,
327
- page,
328
- pageSize,
329
- totalPage: Math.ceil(count / pageSize),
330
- };
331
- }
332
- }
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 type { Database, Model } from '@nocobase/database';
11
+ import { getRunEventBus } from './RunEventBus';
12
+ import { read } from '../utils/record-utils';
13
+
14
+ export type LoopRunRecord = Record<string, unknown>;
15
+
16
+ export class LoopRunAccessError extends Error {
17
+ constructor(
18
+ public readonly status: 401 | 403 | 404 | 409,
19
+ message: string,
20
+ ) {
21
+ super(message);
22
+ this.name = 'LoopRunAccessError';
23
+ }
24
+ }
25
+
26
+ function plain(record: Model | LoopRunRecord): LoopRunRecord {
27
+ return typeof (record as Model).toJSON === 'function'
28
+ ? ((record as Model).toJSON() as LoopRunRecord)
29
+ : structuredClone(record as LoopRunRecord);
30
+ }
31
+
32
+ function positiveId(value: unknown, label: string) {
33
+ const parsed = typeof value === 'number' ? value : Number(value);
34
+ if (!Number.isSafeInteger(parsed) || parsed <= 0) {
35
+ throw new LoopRunAccessError(404, `${label} was not found.`);
36
+ }
37
+ return parsed;
38
+ }
39
+
40
+ function requireUserId(userId: number | undefined) {
41
+ if (!Number.isSafeInteger(userId) || Number(userId) <= 0) {
42
+ throw new LoopRunAccessError(401, 'Authentication is required.');
43
+ }
44
+ return Number(userId);
45
+ }
46
+
47
+ function mergeFilter(filter: Record<string, unknown>, required: Record<string, unknown>) {
48
+ return Object.keys(filter).length > 0 ? { $and: [filter, required] } : required;
49
+ }
50
+
51
+ export class LoopRunRepository {
52
+ constructor(private readonly database: Database) {}
53
+
54
+ async requireRun(runId: string | number) {
55
+ const id = positiveId(runId, 'Agent loop run');
56
+ const record = await this.database.getRepository('agentLoopRuns').findOne({ filterByTk: id });
57
+ if (!record) throw new LoopRunAccessError(404, `Agent loop run ${id} was not found.`);
58
+ return plain(record);
59
+ }
60
+
61
+ async requireOwnedRun(runId: string | number, userId: number | undefined, isAdmin: boolean) {
62
+ const authenticatedUserId = requireUserId(userId);
63
+ const run = await this.requireRun(runId);
64
+ if (!isAdmin && Number(run.userId) !== authenticatedUserId) {
65
+ throw new LoopRunAccessError(403, 'You cannot access this agent loop run.');
66
+ }
67
+ return run;
68
+ }
69
+
70
+ async requireMutableV2Run(runId: string | number, userId: number | undefined, isAdmin: boolean) {
71
+ const run = await this.requireOwnedRun(runId, userId, isAdmin);
72
+ if (run.runtimeVersion !== 'control-plane-v2') {
73
+ throw new LoopRunAccessError(409, 'Historical plan-era runs are read-only.');
74
+ }
75
+ return run;
76
+ }
77
+
78
+ async listOwnedRuns(input: {
79
+ userId: number | undefined;
80
+ isAdmin: boolean;
81
+ filter?: Record<string, unknown>;
82
+ sort?: string[];
83
+ page?: number;
84
+ pageSize?: number;
85
+ }) {
86
+ const userId = requireUserId(input.userId);
87
+ const page = Number.isSafeInteger(input.page) && Number(input.page) > 0 ? Number(input.page) : 1;
88
+ const pageSize =
89
+ Number.isSafeInteger(input.pageSize) && Number(input.pageSize) > 0 ? Math.min(Number(input.pageSize), 100) : 20;
90
+ const requestedFilter = input.filter || {};
91
+ const filter = input.isAdmin ? requestedFilter : mergeFilter(requestedFilter, { userId });
92
+ const [rows, count] = await this.database.getRepository('agentLoopRuns').findAndCount({
93
+ filter,
94
+ sort: input.sort || ['-createdAt'],
95
+ offset: (page - 1) * pageSize,
96
+ limit: pageSize,
97
+ });
98
+ return {
99
+ rows: rows.map(plain),
100
+ count,
101
+ page,
102
+ pageSize,
103
+ totalPage: Math.ceil(count / pageSize),
104
+ };
105
+ }
106
+
107
+ async listOwnedRunIds(userId: number | undefined, isAdmin: boolean) {
108
+ const authenticatedUserId = requireUserId(userId);
109
+ const repository = this.database.getRepository('agentLoopRuns');
110
+ const filter = isAdmin ? {} : { userId: authenticatedUserId };
111
+ const pageSize = 5_000;
112
+ const ids: number[] = [];
113
+ for (let page = 1; ; page += 1) {
114
+ const rows = await repository.find({
115
+ filter,
116
+ fields: ['id'],
117
+ sort: ['id'],
118
+ offset: (page - 1) * pageSize,
119
+ limit: pageSize,
120
+ });
121
+ for (const row of rows) {
122
+ ids.push(positiveId(read(row, 'id'), 'Agent loop run'));
123
+ }
124
+ if (rows.length < pageSize) break;
125
+ }
126
+ return ids;
127
+ }
128
+
129
+ async getOwnedRunDetail(runId: string | number, userId: number | undefined, isAdmin: boolean) {
130
+ const run = await this.requireOwnedRun(runId, userId, isAdmin);
131
+ const id = positiveId(run.id, 'Agent loop run');
132
+ const rootRunId = typeof run.rootRunId === 'string' ? run.rootRunId : '';
133
+ const [steps, events, spans, artifacts, approvals, skillExecutions] = await Promise.all([
134
+ this.database.getRepository('agentLoopSteps').find({ filter: { runId: id }, sort: ['index', 'createdAt'] }),
135
+ this.database.getRepository('agentLoopEvents').find({ filter: { runId: id }, sort: ['id'], limit: 1000 }),
136
+ this.database
137
+ .getRepository('agentExecutionSpans')
138
+ .find({ filter: { agentLoopRunId: id }, sort: ['createdAt'], limit: 1000 }),
139
+ this.database.getRepository('agentLoopArtifacts').find({ filter: { runId: id }, sort: ['createdAt'] }),
140
+ this.database.getRepository('agentLoopActionApprovals').find({ filter: { runId: id }, sort: ['createdAt'] }),
141
+ this.database.getRepository('skillExecutions')
142
+ ? this.database
143
+ .getRepository('skillExecutions')
144
+ .find({ filter: { agentLoopRunId: String(id) }, sort: ['createdAt'], limit: 1000 })
145
+ : [],
146
+ ]);
147
+ return {
148
+ run: {
149
+ ...run,
150
+ historical: run.runtimeVersion !== 'control-plane-v2',
151
+ readOnly: run.runtimeVersion !== 'control-plane-v2',
152
+ },
153
+ steps: steps.map(plain),
154
+ events: events.map(plain),
155
+ spans: spans.map(plain),
156
+ artifacts: artifacts.map(plain),
157
+ approvals: approvals.map(plain),
158
+ skillExecutions: skillExecutions.map(plain),
159
+ rootRunId,
160
+ };
161
+ }
162
+
163
+ async listApprovals(input: {
164
+ userId: number | undefined;
165
+ isAdmin: boolean;
166
+ filter?: Record<string, unknown>;
167
+ sort?: string[];
168
+ page?: number;
169
+ pageSize?: number;
170
+ }) {
171
+ const userId = requireUserId(input.userId);
172
+ // Scope via the run association so ownership holds for any number of runs
173
+ // (a materialized id list would silently truncate for prolific users).
174
+ const accessible = input.isAdmin
175
+ ? {}
176
+ : {
177
+ $or: [{ assignedToId: userId }, { 'run.userId': userId }],
178
+ };
179
+ return this.findAndCount('agentLoopActionApprovals', input, accessible);
180
+ }
181
+
182
+ async requireAccessibleApproval(approvalId: string | number, userId: number | undefined, isAdmin: boolean) {
183
+ const authenticatedUserId = requireUserId(userId);
184
+ const id = positiveId(approvalId, 'Agent loop approval');
185
+ const record = await this.database.getRepository('agentLoopActionApprovals').findOne({ filterByTk: id });
186
+ if (!record) throw new LoopRunAccessError(404, `Agent loop approval ${id} was not found.`);
187
+ const approval = plain(record);
188
+ const run = await this.requireRun(positiveId(approval.runId, 'Agent loop run'));
189
+ if (
190
+ !isAdmin &&
191
+ Number(run.userId) !== authenticatedUserId &&
192
+ Number(approval.assignedToId) !== authenticatedUserId
193
+ ) {
194
+ throw new LoopRunAccessError(403, 'You cannot access this agent loop approval.');
195
+ }
196
+ return approval;
197
+ }
198
+
199
+ // Records a human decision on one approval and requeues the run once every pending approval of
200
+ // the run has been decided. Fail-closed throughout: an expired window, a decided row, or a run
201
+ // that moved on all reject the decision instead of guessing what the human meant.
202
+ async decideApproval(input: {
203
+ approvalId: string | number;
204
+ userId: number | undefined;
205
+ isAdmin: boolean;
206
+ decision: 'approved' | 'rejected';
207
+ note?: string;
208
+ editedInput?: unknown;
209
+ }) {
210
+ const decidedById = requireUserId(input.userId);
211
+ const id = positiveId(input.approvalId, 'Agent loop approval');
212
+ // Fast access check before taking row locks; the transaction re-reads the rows anyway.
213
+ await this.requireAccessibleApproval(id, input.userId, input.isAdmin);
214
+
215
+ const committed = await this.database.sequelize.transaction(async (transaction) => {
216
+ const approvals = this.database.getRepository('agentLoopActionApprovals');
217
+ const runs = this.database.getRepository('agentLoopRuns');
218
+ const record = await approvals.findOne({ filterByTk: id, transaction, lock: transaction.LOCK.UPDATE });
219
+ if (!record) throw new LoopRunAccessError(404, `Agent loop approval ${id} was not found.`);
220
+ const approval = plain(record);
221
+
222
+ if (approval.status !== 'pending') {
223
+ throw new LoopRunAccessError(409, `This approval has already been ${String(approval.status)}.`);
224
+ }
225
+ const expiresAt = approval.expiresAt ? new Date(String(approval.expiresAt)) : null;
226
+ if (expiresAt && !Number.isNaN(expiresAt.getTime()) && expiresAt.getTime() <= Date.now()) {
227
+ throw new LoopRunAccessError(409, 'The approval window has expired. Retry the run to request approval again.');
228
+ }
229
+
230
+ const runId = positiveId(approval.runId, 'Agent loop run');
231
+ const runRecord = await runs.findOne({ filterByTk: runId, transaction, lock: transaction.LOCK.UPDATE });
232
+ if (!runRecord) throw new LoopRunAccessError(404, `Agent loop run ${runId} was not found.`);
233
+ const run = plain(runRecord);
234
+ if (run.runtimeVersion !== 'control-plane-v2') {
235
+ throw new LoopRunAccessError(409, 'Historical plan-era runs are read-only.');
236
+ }
237
+ // A paused run keeps its decisions; the human resume requeues it later. Any other status
238
+ // means the run moved on and the decision can no longer be applied.
239
+ if (run.status !== 'waiting_approval' && run.status !== 'paused') {
240
+ throw new LoopRunAccessError(409, 'The run is no longer waiting for approval.');
241
+ }
242
+
243
+ const now = new Date();
244
+ await approvals.update({
245
+ filterByTk: id,
246
+ values: {
247
+ status: input.decision,
248
+ decidedById,
249
+ decidedAt: now,
250
+ decisionNote: input.note || null,
251
+ ...(input.decision === 'approved' && input.editedInput !== undefined
252
+ ? { editedInput: input.editedInput }
253
+ : {}),
254
+ },
255
+ transaction,
256
+ });
257
+
258
+ const remaining = await approvals.find({ filter: { runId, status: 'pending' }, transaction });
259
+ let requeued = false;
260
+ let event: LoopRunRecord | null = null;
261
+ if (!remaining.length) {
262
+ await runs.update({
263
+ filterByTk: runId,
264
+ // A paused run keeps its pause but must be ready to consume decisions when the owner resumes it.
265
+ values: { approvalStatus: 'decided', ...(run.status === 'waiting_approval' ? { status: 'queued' } : {}) },
266
+ transaction,
267
+ });
268
+ }
269
+ if (!remaining.length && run.status === 'waiting_approval') {
270
+ const created = await this.database.getRepository('agentLoopEvents').create({
271
+ values: {
272
+ runId,
273
+ type: 'run_approval_decided',
274
+ title: 'Approvals decided',
275
+ content: 'All pending action approvals were decided. Run requeued to resume.',
276
+ status: 'queued',
277
+ payload: { decision: input.decision },
278
+ actorType: 'human',
279
+ actorIdentity: String(decidedById),
280
+ correlationKey: `approval-decided:${runId}`,
281
+ createdAt: now,
282
+ },
283
+ transaction,
284
+ });
285
+ event = typeof created.toJSON === 'function' ? created.toJSON() : created;
286
+ requeued = true;
287
+ }
288
+ return { approval, runId, requeued, event };
289
+ });
290
+
291
+ if (committed.requeued && committed.event) getRunEventBus().emit(committed.runId, committed.event);
292
+ return {
293
+ ...committed.approval,
294
+ status: input.decision,
295
+ decidedById,
296
+ requeued: committed.requeued,
297
+ };
298
+ }
299
+
300
+ async listArtifacts(input: {
301
+ userId: number | undefined;
302
+ isAdmin: boolean;
303
+ filter?: Record<string, unknown>;
304
+ sort?: string[];
305
+ page?: number;
306
+ pageSize?: number;
307
+ }) {
308
+ const userId = requireUserId(input.userId);
309
+ const accessible = input.isAdmin ? {} : { 'run.userId': userId };
310
+ return this.findAndCount('agentLoopArtifacts', input, accessible);
311
+ }
312
+
313
+ async requireOwnedArtifact(artifactId: string | number, userId: number | undefined, isAdmin: boolean) {
314
+ const id = positiveId(artifactId, 'Agent loop artifact');
315
+ const record = await this.database.getRepository('agentLoopArtifacts').findOne({ filterByTk: id });
316
+ if (!record) throw new LoopRunAccessError(404, `Agent loop artifact ${id} was not found.`);
317
+ const artifact = plain(record);
318
+ await this.requireOwnedRun(positiveId(artifact.runId, 'Agent loop run'), userId, isAdmin);
319
+ return artifact;
320
+ }
321
+
322
+ private async findAndCount(
323
+ collection: string,
324
+ input: {
325
+ filter?: Record<string, unknown>;
326
+ sort?: string[];
327
+ page?: number;
328
+ pageSize?: number;
329
+ },
330
+ accessible: Record<string, unknown>,
331
+ ) {
332
+ const page = Number.isSafeInteger(input.page) && Number(input.page) > 0 ? Number(input.page) : 1;
333
+ const pageSize =
334
+ Number.isSafeInteger(input.pageSize) && Number(input.pageSize) > 0 ? Math.min(Number(input.pageSize), 100) : 20;
335
+ const filter = mergeFilter(input.filter || {}, accessible);
336
+ const [rows, count] = await this.database.getRepository(collection).findAndCount({
337
+ filter,
338
+ sort: input.sort || ['-createdAt'],
339
+ offset: (page - 1) * pageSize,
340
+ limit: pageSize,
341
+ });
342
+ return {
343
+ rows: rows.map(plain),
344
+ count,
345
+ page,
346
+ pageSize,
347
+ totalPage: Math.ceil(count / pageSize),
348
+ };
349
+ }
350
+ }