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,573 +1,674 @@
1
- import { Plugin } from '@nocobase/server';
2
- import path from 'path';
3
- import { createExternalRagSearchTool } from './tools/external-rag-search';
4
- import { registerTracingResource } from './resources/tracing';
5
- import { registerAgentMonitorResource } from './resources/agent-monitor';
6
- import { registerAgentLoopResource } from './resources/agent-loop';
7
- import { registerAgentLoopApprovalResource } from './resources/agent-loop-approval';
8
- import { registerAgentHarnessProfileResource } from './resources/agent-harness-profile';
9
- import { registerAgentLoopArtifactResource } from './resources/agent-loop-artifact';
10
- import { registerAgentLoopEventsStreamResource } from './resources/agent-loop-events-stream';
11
- import { registerAgentKnowledgeInsightsResource } from './resources/agent-knowledge-insights';
12
- import SkillHubSubFeature from './skill-hub/plugin';
13
- import { NativeSubAgentObserver } from './services/NativeSubAgentObserver';
14
- import { RegistrySkillSnapshotService } from './skill-hub/services/RegistrySkillSnapshotService';
15
- import { RegistrySkillInstallationService } from './skill-hub/services/RegistrySkillInstallationService';
16
- import { LoopPatternService } from './services/LoopPatternService';
17
- import { LoopSchedulerService } from './services/LoopSchedulerService';
18
- import { LoopTriggerService } from './services/LoopTriggerService';
19
- import { LoopWorkerService } from './services/LoopWorkerService';
20
- import { asObject, isAdminUser, currentUserId } from './utils/ctx-utils';
21
- import { employeeHarnessResolver, worktreeCapability } from './utils/loop-pattern-context';
22
- import { getAIToolsManager } from './utils/ai-manager';
23
- import { AgentRuntimeLifecycle } from './services/AgentRuntimeLifecycle';
24
- import { validateInputSchemaDefinition } from './services/InputSchemaValidator';
25
- import { assertSkillToolNameAvailable, buildSkillToolName, getSkillToolName } from './utils/skill-tool-name';
26
- import { ensureAgentOrchestratorIndexes } from './utils/ensure-indexes';
27
- import { resetRunEventBus } from './services/RunEventBus';
28
-
29
- function normalizeOptionalString(value: unknown) {
30
- return typeof value === 'string' ? value.trim() : '';
31
- }
32
-
33
- function readModelValue(record: unknown, key: string) {
34
- const model = record as { get?: (name: string) => unknown; [key: string]: unknown };
35
- return typeof model?.get === 'function' ? model.get(key) : model?.[key];
36
- }
37
-
38
- const PRIVATE_SKILL_FIELDS = ['codeTemplate', 'instructions', 'storageUrl', 'packages', 'fileId'] as const;
39
-
40
- function redactSkillRecord(record: unknown): unknown {
41
- if (!record || typeof record !== 'object') return record;
42
- const source =
43
- (record as { toJSON?: () => Record<string, unknown> }).toJSON?.() || (record as Record<string, unknown>);
44
- const result = { ...source };
45
- for (const field of PRIVATE_SKILL_FIELDS) {
46
- delete result[field];
47
- }
48
- return result;
49
- }
50
-
51
- function redactSkillResponse(body: unknown): unknown {
52
- if (Array.isArray(body)) return body.map(redactSkillRecord);
53
- if (!body || typeof body !== 'object') return body;
54
-
55
- const value = body as Record<string, unknown>;
56
- if (Array.isArray(value.rows)) return { ...value, rows: value.rows.map(redactSkillRecord) };
57
- if (Object.prototype.hasOwnProperty.call(value, 'data')) {
58
- return {
59
- ...value,
60
- data: Array.isArray(value.data) ? value.data.map(redactSkillRecord) : redactSkillRecord(value.data),
61
- };
62
- }
63
- return redactSkillRecord(value);
64
- }
65
-
66
- function buildAgentMemoryContextKey(values: { scope: string; userId?: unknown; aiEmployeeUsername?: string }) {
67
- const userPart = values.scope === 'public' ? 'public' : String(values.userId || '');
68
- const agentPart = values.aiEmployeeUsername || '*';
69
- return `${values.scope}:${userPart}:${agentPart}`;
70
- }
71
-
72
- async function validateAgentMemoryContextValues(ctx: any) {
73
- const actionName = ctx.action?.actionName;
74
- const values = ctx.action?.params?.values || {};
75
- let nextValues = values;
76
- let currentId = ctx.action?.params?.filterByTk;
77
-
78
- if (actionName === 'update' && ctx.action?.params?.filterByTk) {
79
- const existing = await ctx.db.getRepository('agentMemoryContexts').findOne({
80
- filter: { id: ctx.action.params.filterByTk },
81
- });
82
- currentId = readModelValue(existing, 'id') || currentId;
83
- nextValues = {
84
- ...(existing?.toJSON?.() || existing || {}),
85
- ...values,
86
- };
87
- }
88
-
89
- const scope = normalizeOptionalString(nextValues.scope);
90
- const userId = nextValues.userId;
91
- const aiEmployeeUsername = normalizeOptionalString(nextValues.aiEmployeeUsername);
92
-
93
- if (!['public', 'user', 'agent_user'].includes(scope)) {
94
- ctx.throw(400, 'scope must be one of: public, user, agent_user.');
95
- return;
96
- }
97
-
98
- if (scope === 'public' && userId != null && userId !== '') {
99
- ctx.throw(400, 'scope="public" requires userId to be empty.');
100
- return;
101
- }
102
-
103
- if ((scope === 'user' || scope === 'agent_user') && (userId == null || userId === '')) {
104
- ctx.throw(400, `scope="${scope}" requires userId.`);
105
- return;
106
- }
107
-
108
- if (scope === 'agent_user' && !aiEmployeeUsername) {
109
- ctx.throw(400, 'scope="agent_user" requires aiEmployeeUsername.');
110
- return;
111
- }
112
-
113
- const normalizedValues = {
114
- ...values,
115
- scope,
116
- userId: scope === 'public' ? null : userId,
117
- aiEmployeeUsername,
118
- contextKey: buildAgentMemoryContextKey({
119
- scope,
120
- userId: scope === 'public' ? null : userId,
121
- aiEmployeeUsername,
122
- }),
123
- };
124
-
125
- const repo = ctx.db.getRepository('agentMemoryContexts');
126
- const duplicate =
127
- (await repo.findOne({
128
- filter: { contextKey: normalizedValues.contextKey },
129
- })) ||
130
- (await repo.findOne({
131
- filter: {
132
- scope,
133
- userId: normalizedValues.userId,
134
- aiEmployeeUsername,
135
- },
136
- }));
137
- const duplicateId = readModelValue(duplicate, 'id');
138
- if (duplicateId && String(duplicateId) !== String(currentId || '')) {
139
- ctx.throw(400, 'An agent memory context already exists for this scope, user, and AI employee.');
140
- return;
141
- }
142
-
143
- ctx.action.params.values = normalizedValues;
144
- }
145
-
146
- async function resolveTracingRetentionDays(plugin: { db: any; app: any }) {
147
- const envDays = Number(process.env.ORCHESTRATOR_LOG_RETENTION_DAYS);
148
- if (Number.isFinite(envDays) && envDays > 0) return envDays;
149
-
150
- try {
151
- const defaultProfile = await plugin.db.getRepository('agentHarnessProfiles').findOne({
152
- filter: {
153
- tag: 'default',
154
- enabled: true,
155
- },
156
- });
157
- const settings = asObject(readModelValue(defaultProfile, 'settings'));
158
- const profileDays = Number(settings.tracingRetentionDays);
159
- if (Number.isFinite(profileDays) && profileDays > 0) {
160
- return profileDays;
161
- }
162
- } catch (error) {
163
- plugin.app.logger?.warn?.('[AgentOrchestrator] Failed to load tracing retention policy', error);
164
- }
165
-
166
- return 30;
167
- }
168
-
169
- export class PluginAgentOrchestratorServer extends Plugin {
170
- skillHub: SkillHubSubFeature;
171
- registrySkillSnapshotService: RegistrySkillSnapshotService;
172
- registrySkillInstallationService: RegistrySkillInstallationService;
173
- nativeObserver: NativeSubAgentObserver;
174
- agentRuntimeLifecycle: AgentRuntimeLifecycle;
175
- loopScheduler: LoopSchedulerService;
176
- loopWorker: LoopWorkerService;
177
- private readonly installNativeObserver = () => {
178
- this.nativeObserver?.install();
179
- };
180
-
181
- async afterAdd() {
182
- this.skillHub = new SkillHubSubFeature(this);
183
- this.registrySkillSnapshotService = new RegistrySkillSnapshotService(this.db);
184
- this.registrySkillInstallationService = new RegistrySkillInstallationService(this.db, () =>
185
- this.skillHub.getSkillRepositoryService(),
186
- );
187
- this.nativeObserver = new NativeSubAgentObserver(this);
188
- this.agentRuntimeLifecycle = new AgentRuntimeLifecycle((hookType, name, error) => {
189
- this.app.logger.warn(`[AgentOrchestrator] ${hookType} hook "${name}" failed; continuing agent execution.`, {
190
- error,
191
- });
192
- });
193
- (this.app as typeof this.app & { agentRuntimeLifecycle: AgentRuntimeLifecycle }).agentRuntimeLifecycle =
194
- this.agentRuntimeLifecycle;
195
- }
196
-
197
- async beforeLoad() {
198
- // Import collection definitions
199
- this.db.import({ directory: path.resolve(__dirname, 'collections') });
200
-
201
- this.db.addMigrations({
202
- namespace: this.name,
203
- directory: path.resolve(__dirname, 'migrations'),
204
- context: { plugin: this },
205
- });
206
- }
207
-
208
- async load() {
209
- await this.skillHub.load();
210
-
211
- // --- ACL ---
212
- this.app.acl.registerSnippet({
213
- name: `pm.${this.name}`,
214
- actions: [
215
- 'orchestratorConfig:*',
216
- 'orchestratorTracing:*',
217
- 'agentMonitor:*',
218
- 'agentKnowledgeInsights:*',
219
- 'agentMemoryContexts:*',
220
- 'agentLoopRuns:*',
221
- 'agentLoopSteps:*',
222
- 'agentLoopEvents:*',
223
- 'agentHarnessProfiles:*',
224
- 'agentExecutionSpans:*',
225
- 'skillDefinitions:*',
226
- 'skillExecutions:*',
227
- 'skillLoopConfigs:*',
228
- 'skillHub:*',
229
- 'skillWorkerConfigs:*',
230
- ],
231
- });
232
-
233
- // Allow any logged-in user to read available skills and loop configs.
234
- // This mirrors the plugin-ai pattern (acl.allow with 'loggedIn')
235
- // so that non-admin users with AI roles can use skills without
236
- // requiring manual snippet assignment per role.
237
- // Create/update/destroy remain restricted to admin roles via the snippet above.
238
- this.app.acl.allow('skillDefinitions', 'list', 'loggedIn');
239
- this.app.acl.allow('skillDefinitions', 'get', 'loggedIn');
240
- this.app.acl.allow('skillLoopConfigs', 'list', 'loggedIn');
241
- this.app.acl.allow('skillLoopConfigs', 'get', 'loggedIn');
242
- this.app.acl.allow('skillExecutions', 'list', 'loggedIn');
243
- this.app.acl.allow('skillExecutions', 'get', 'loggedIn');
244
- this.app.acl.allow('skillHub', 'download', 'loggedIn');
245
- this.app.acl.allow('skillHub', 'listTemplates', 'loggedIn');
246
- this.app.acl.allow('agentMonitor', ['list', 'get'], 'loggedIn');
247
- // ACL runs before the resource handler, so every owner-facing loop action must be listed
248
- // here; ownership itself is enforced inside each handler by LoopRunRepository.
249
- this.app.acl.allow(
250
- 'agentLoops',
251
- ['list', 'get', 'runNow', 'pause', 'resume', 'cancel', 'retry', 'escalate', 'acceptResult', 'status'],
252
- 'loggedIn',
253
- );
254
- this.app.acl.allow('agentLoopApprovals', ['list', 'get', 'decide'], 'loggedIn');
255
- this.app.acl.allow('agentLoopArtifactsView', ['list', 'get'], 'loggedIn');
256
- this.app.acl.allow('agentLoopEventsStream', ['stream'], 'loggedIn');
257
-
258
- // Data scoping for skillExecutions: a logged-in non-admin user may only
259
- // read their own executions. Rows hold inputArgs / stdout / output files,
260
- // so an unscoped list/get would leak one user's data to another. Admins
261
- // (root/admin roles) keep full visibility. This mirrors the owner/admin
262
- // check enforced by skillHub:download.
263
- this.app.resourceManager.use(
264
- async (ctx, next) => {
265
- const { resourceName, actionName } = ctx.action || {};
266
- if (resourceName === 'skillExecutions' && (actionName === 'list' || actionName === 'get')) {
267
- if (!isAdminUser(ctx)) {
268
- const userId = currentUserId(ctx);
269
- const ownerFilter = userId ? { triggeredById: userId } : { triggeredById: null };
270
- ctx.action.mergeParams({ filter: ownerFilter });
271
- }
272
- }
273
- await next();
274
- },
275
- { tag: 'orchestrator-skill-executions-scope', after: 'acl' },
276
- );
277
-
278
- this.app.resourceManager.use(
279
- async (ctx, next) => {
280
- const { resourceName, actionName } = ctx.action || {};
281
- if (resourceName !== 'skillDefinitions') {
282
- await next();
283
- return;
284
- }
285
-
286
- const values = ctx.action?.params?.values || {};
287
- if (actionName === 'create' || actionName === 'update') {
288
- try {
289
- if (Object.prototype.hasOwnProperty.call(values, 'inputSchema')) {
290
- validateInputSchemaDefinition(values.inputSchema);
291
- }
292
-
293
- if (actionName === 'create') {
294
- const toolName = buildSkillToolName(values.name);
295
- await assertSkillToolNameAvailable(ctx.db, toolName);
296
- values.toolName = toolName;
297
- } else {
298
- const existing = await ctx.db.getRepository('skillDefinitions').findOne({
299
- filterByTk: ctx.action?.params?.filterByTk,
300
- });
301
- if (existing) {
302
- const stableToolName = getSkillToolName(existing);
303
- if (values.toolName && values.toolName !== stableToolName) {
304
- ctx.throw(400, 'toolName is immutable after a skill is created.');
305
- return;
306
- }
307
- values.toolName = stableToolName;
308
- }
309
- }
310
- } catch (error) {
311
- ctx.throw(400, error instanceof Error ? error.message : String(error));
312
- return;
313
- }
314
- }
315
-
316
- if (actionName === 'destroy') {
317
- const existing = await ctx.db.getRepository('skillDefinitions').findOne({
318
- filterByTk: ctx.action?.params?.filterByTk,
319
- });
320
- if (existing) {
321
- const toolName = getSkillToolName(existing);
322
- const agentUsernames = await this.skillHub.skillAccessService.findAgentUsernamesUsingTool(toolName);
323
- if (agentUsernames.length > 0) {
324
- ctx.throw(
325
- 409,
326
- `Skill tool "${toolName}" is still bound to AI employees: ${agentUsernames.join(
327
- ', ',
328
- )}. Disable or unbind it before deletion.`,
329
- );
330
- return;
331
- }
332
- }
333
- }
334
-
335
- await next();
336
-
337
- // When a skill is disabled via update, cascade-remove its tool from all AI employee
338
- // bindings. This prevents stale bindings from allowing execution of disabled skills.
339
- if (actionName === 'update' && values.enabled === false) {
340
- const tk = ctx.action?.params?.filterByTk;
341
- if (tk) {
342
- const skillRecord = await ctx.db.getRepository('skillDefinitions').findOne({ filterByTk: tk });
343
- if (skillRecord) {
344
- const toolName = getSkillToolName(skillRecord);
345
- if (toolName) {
346
- await this.skillHub.skillAccessService.cascadeDisableSkill(toolName);
347
- }
348
- }
349
- }
350
- }
351
-
352
- if ((actionName === 'list' || actionName === 'get') && !isAdminUser(ctx)) {
353
- ctx.body = redactSkillResponse(ctx.body);
354
- }
355
- },
356
- { tag: 'orchestrator-skill-definition-policy', after: 'acl' },
357
- );
358
-
359
- this.app.resourceManager.use(
360
- async (ctx, next) => {
361
- const { resourceName, actionName } = ctx.action || {};
362
- if (resourceName === 'agentMemoryContexts' && (actionName === 'create' || actionName === 'update')) {
363
- await validateAgentMemoryContextValues(ctx);
364
- }
365
- await next();
366
- },
367
- { tag: 'orchestrator-agent-memory-context-policy', after: 'acl' },
368
- );
369
-
370
- // --- Register External Tool Only ---
371
- // Native @nocobase/plugin-ai owns reasoning, planning/replanning and sub-agent dispatch.
372
- // The orchestrator no longer injects planning prompts or registers self-state AI tools; it
373
- // drives work through the Loop Control Plane (trigger → durable run → worker → verifier).
374
- const toolsManager = getAIToolsManager(this.app);
375
- toolsManager.registerTools(createExternalRagSearchTool(this));
376
-
377
- // --- Loop Control Plane runtime ---
378
- const patterns = new LoopPatternService(this.db, employeeHarnessResolver(this), async () =>
379
- worktreeCapability(this),
380
- );
381
- const triggers = new LoopTriggerService(this.db, patterns, this.app.log);
382
- this.loopScheduler = new LoopSchedulerService(this, patterns, triggers);
383
- this.loopWorker = new LoopWorkerService(this.app, this.db);
384
- this.loopScheduler.install();
385
- this.app.on?.('afterStart', this.startLoopWorker);
386
-
387
- registerAgentLoopResource(this);
388
- registerAgentLoopApprovalResource(this);
389
- registerAgentLoopArtifactResource(this);
390
- registerAgentLoopEventsStreamResource(this);
391
- registerAgentHarnessProfileResource(this);
392
-
393
- // --- Native plugin-ai Monitor Resource ---
394
- registerAgentMonitorResource(this);
395
- registerAgentKnowledgeInsightsResource(this);
396
- this.installNativeObserver();
397
- this.app.on?.('afterStart', this.installNativeObserver);
398
-
399
- // --- Register Tracing Resource (Phase 5) ---
400
- // Custom read-only resource for the Swarm Tracing admin page.
401
- registerTracingResource(this);
402
-
403
- // --- Log Retention ---
404
- // Daily prune of orchestratorLogs / agentExecutionSpans to keep tables bounded.
405
- // Override window via env: ORCHESTRATOR_LOG_RETENTION_DAYS (default 30).
406
- this.app.cronJobManager.addJob({
407
- cronTime: '0 30 2 * * *',
408
- onTick: async () => {
409
- try {
410
- const days = await resolveTracingRetentionDays(this);
411
- const cutoff = new Date(Date.now() - days * 86400000);
412
- const repo = this.db.getRepository('orchestratorLogs');
413
- const spansRepo = this.db.getRepository('agentExecutionSpans');
414
- const deletedLogs = repo
415
- ? await repo.destroy({
416
- filter: { createdAt: { $lt: cutoff.toISOString() } },
417
- })
418
- : 0;
419
- const deletedSpans = spansRepo
420
- ? await spansRepo.destroy({
421
- filter: { createdAt: { $lt: cutoff.toISOString() } },
422
- })
423
- : 0;
424
- this.app.log.info(
425
- `[AgentOrchestrator] Pruned ${deletedLogs} orchestratorLogs and ${deletedSpans} agentExecutionSpans rows older than ${days} day(s).`,
426
- );
427
- } catch (e) {
428
- this.app.log.error('[AgentOrchestrator] Log retention job failed', e);
429
- }
430
- },
431
- });
432
-
433
- // --- Skill Metrics Aggregation ---
434
- // Daily roll-up of skillExecutions into per-skill/per-employee metrics for
435
- // operational dashboards. Override schedule via env: SKILL_METRICS_CRON (default 03:00).
436
- this.app.cronJobManager.addJob({
437
- cronTime: process.env.SKILL_METRICS_CRON || '0 0 3 * * *',
438
- onTick: async () => {
439
- try {
440
- await this.aggregateSkillMetrics();
441
- } catch (e) {
442
- this.app.log.error('[AgentOrchestrator] Skill metrics aggregation job failed', e);
443
- }
444
- },
445
- });
446
-
447
- // Native sub-agent conversations are owned by @nocobase/plugin-ai. This
448
- // plugin only observes their execution spans and policy context.
449
- }
450
-
451
- private async aggregateSkillMetrics() {
452
- const yesterday = new Date(Date.now() - 86400000);
453
- yesterday.setUTCHours(0, 0, 0, 0);
454
- const today = new Date(yesterday.getTime() + 86400000);
455
-
456
- const repo = this.db.getRepository('skillExecutions');
457
- if (!repo) return;
458
-
459
- const rows = await repo.find({
460
- filter: {
461
- createdAt: {
462
- $gte: yesterday.toISOString(),
463
- $lt: today.toISOString(),
464
- },
465
- },
466
- fields: ['skillId', 'aiEmployeeUsername', 'status', 'durationMs'],
467
- });
468
-
469
- type MetricKey = string;
470
- interface MetricBucket {
471
- executions: number;
472
- successes: number;
473
- failures: number;
474
- timeouts: number;
475
- durations: number[];
476
- }
477
-
478
- const buckets = new Map<MetricKey, MetricBucket>();
479
-
480
- for (const row of rows) {
481
- const skillId = String(row.get?.('skillId') || '');
482
- const username = String(row.get?.('aiEmployeeUsername') || '');
483
- const status = String(row.get?.('status') || '');
484
- const durationMs = Number(row.get?.('durationMs') || 0);
485
- if (!skillId) continue;
486
-
487
- const key = `${skillId}:${username}`;
488
- if (!buckets.has(key)) {
489
- buckets.set(key, { executions: 0, successes: 0, failures: 0, timeouts: 0, durations: [] });
490
- }
491
- const bucket = buckets.get(key) ?? { executions: 0, successes: 0, failures: 0, timeouts: 0, durations: [] };
492
- bucket.executions += 1;
493
- if (status === 'succeeded') bucket.successes += 1;
494
- else if (status === 'timeout') bucket.timeouts += 1;
495
- else if (status === 'failed') bucket.failures += 1;
496
- if (durationMs > 0) bucket.durations.push(durationMs);
497
- }
498
-
499
- const metricsRepo = this.db.getRepository('skillMetrics');
500
- if (!metricsRepo) return;
501
-
502
- let upserted = 0;
503
- for (const [key, bucket] of buckets) {
504
- const firstColon = key.indexOf(':');
505
- const skillId = key.substring(0, firstColon);
506
- const employeeUsername = key.substring(firstColon + 1);
507
- const sortedDurations = [...bucket.durations].sort((a, b) => a - b);
508
- const p95Index = Math.max(0, Math.ceil(sortedDurations.length * 0.95) - 1);
509
- const totalDuration = sortedDurations.reduce((sum, d) => sum + d, 0);
510
-
511
- await metricsRepo.updateOrCreate({
512
- filterKeys: ['skillId', 'employeeUsername', 'period'],
513
- values: {
514
- skillId: skillId,
515
- employeeUsername,
516
- period: yesterday.toISOString(),
517
- executions: bucket.executions,
518
- successes: bucket.successes,
519
- failures: bucket.failures,
520
- timeouts: bucket.timeouts,
521
- avgDurationMs: bucket.durations.length ? Math.round(totalDuration / bucket.durations.length) : 0,
522
- p95DurationMs: sortedDurations.length > 1 ? sortedDurations[p95Index] : sortedDurations[0] || 0,
523
- totalDurationMs: totalDuration,
524
- },
525
- });
526
- upserted += 1;
527
- }
528
-
529
- this.app.log.info(
530
- `[AgentOrchestrator] Skill metrics aggregated for ${yesterday
531
- .toISOString()
532
- .slice(0, 10)}: ${upserted} metric row(s).`,
533
- );
534
- }
535
-
536
- async install() {
537
- await this.skillHub.install();
538
- await ensureAgentOrchestratorIndexes(this.db);
539
- }
540
-
541
- async upgrade() {
542
- await ensureAgentOrchestratorIndexes(this.db);
543
- }
544
-
545
- async afterEnable() {}
546
- async afterDisable() {
547
- this.nativeObserver?.uninstall();
548
- }
549
- async remove() {}
550
-
551
- async beforeStop() {
552
- this.app.off?.('afterStart', this.installNativeObserver);
553
- this.app.removeListener?.('afterStart', this.installNativeObserver);
554
- this.app.off?.('afterStart', this.startLoopWorker);
555
- this.app.removeListener?.('afterStart', this.startLoopWorker);
556
- await this.loopWorker?.stop();
557
- await this.loopScheduler?.dispose();
558
- this.nativeObserver?.uninstall();
559
- await this.skillHub.beforeStop();
560
- resetRunEventBus();
561
- }
562
-
563
- async handleSyncMessage(message: unknown) {
564
- await this.loopScheduler?.handleSyncMessage(message);
565
- await this.loopWorker?.handleSyncMessage(message);
566
- }
567
-
568
- private readonly startLoopWorker = () => {
569
- this.loopWorker?.start();
570
- };
571
- }
572
-
573
- export default PluginAgentOrchestratorServer;
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 { Plugin } from '@nocobase/server';
11
+ import type { Context } from '@nocobase/actions';
12
+ import path from 'path';
13
+ import { createExternalRagSearchTool } from './tools/external-rag-search';
14
+ import { registerTracingResource } from './resources/tracing';
15
+ import { registerAgentMonitorResource } from './resources/agent-monitor';
16
+ import { registerAgentLoopResource } from './resources/agent-loop';
17
+ import { registerAgentLoopApprovalResource } from './resources/agent-loop-approval';
18
+ import { registerAgentHarnessProfileResource } from './resources/agent-harness-profile';
19
+ import { registerAgentLoopArtifactResource } from './resources/agent-loop-artifact';
20
+ import { registerAgentLoopEventsStreamResource } from './resources/agent-loop-events-stream';
21
+ import { registerAgentKnowledgeInsightsResource } from './resources/agent-knowledge-insights';
22
+ import { registerAgentGovernanceResource } from './resources/agent-governance';
23
+ import { registerAgentUsageResource } from './resources/agent-usage';
24
+ import SkillHubSubFeature from './skill-hub/plugin';
25
+ import { NativeSubAgentObserver } from './services/NativeSubAgentObserver';
26
+ import { NativeAgentMonitorSyncService } from './services/NativeAgentMonitorSyncService';
27
+ import { RegistrySkillSnapshotService } from './skill-hub/services/RegistrySkillSnapshotService';
28
+ import { RegistrySkillInstallationService } from './skill-hub/services/RegistrySkillInstallationService';
29
+ import { LoopPatternService } from './services/LoopPatternService';
30
+ import { LoopSchedulerService } from './services/LoopSchedulerService';
31
+ import { LoopTriggerService } from './services/LoopTriggerService';
32
+ import { LoopWorkerService } from './services/LoopWorkerService';
33
+ import { asObject, isAdminUser, currentUserId } from './utils/ctx-utils';
34
+ import { employeeHarnessResolver, worktreeCapability } from './utils/loop-pattern-context';
35
+ import { getAIToolsManager } from './utils/ai-manager';
36
+ import { AgentRuntimeLifecycle } from './services/AgentRuntimeLifecycle';
37
+ import { validateInputSchemaDefinition } from './services/InputSchemaValidator';
38
+ import { assertSkillToolNameAvailable, buildSkillToolName, getSkillToolName } from './utils/skill-tool-name';
39
+ import { ensureAgentOrchestratorIndexes } from './utils/ensure-indexes';
40
+ import { resetRunEventBus } from './services/RunEventBus';
41
+ import { resolveTracingRetentionDays } from './services/TracingRetentionPolicy';
42
+ import { createGovernanceAdmission } from './services/GovernanceAdmission';
43
+ import { installManagedPromptProtection, ManagedPromptError } from './services/ManagedPromptProtection';
44
+ import { installNativeUsageAttribution } from './services/NativeUsageAttribution';
45
+
46
+ function normalizeOptionalString(value: unknown) {
47
+ return typeof value === 'string' ? value.trim() : '';
48
+ }
49
+
50
+ function readModelValue(record: unknown, key: string) {
51
+ const model = record as { get?: (name: string) => unknown; [key: string]: unknown };
52
+ return typeof model?.get === 'function' ? model.get(key) : model?.[key];
53
+ }
54
+
55
+ const PRIVATE_SKILL_FIELDS = ['codeTemplate', 'instructions', 'storageUrl', 'packages', 'fileId'] as const;
56
+
57
+ function redactSkillRecord(record: unknown): unknown {
58
+ if (!record || typeof record !== 'object') return record;
59
+ const source =
60
+ (record as { toJSON?: () => Record<string, unknown> }).toJSON?.() || (record as Record<string, unknown>);
61
+ const result = { ...source };
62
+ for (const field of PRIVATE_SKILL_FIELDS) {
63
+ delete result[field];
64
+ }
65
+ return result;
66
+ }
67
+
68
+ function redactSkillResponse(body: unknown): unknown {
69
+ if (Array.isArray(body)) return body.map(redactSkillRecord);
70
+ if (!body || typeof body !== 'object') return body;
71
+
72
+ const value = body as Record<string, unknown>;
73
+ if (Array.isArray(value.rows)) return { ...value, rows: value.rows.map(redactSkillRecord) };
74
+ if (Object.prototype.hasOwnProperty.call(value, 'data')) {
75
+ return {
76
+ ...value,
77
+ data: Array.isArray(value.data) ? value.data.map(redactSkillRecord) : redactSkillRecord(value.data),
78
+ };
79
+ }
80
+ return redactSkillRecord(value);
81
+ }
82
+
83
+ function buildAgentMemoryContextKey(values: { scope: string; userId?: unknown; aiEmployeeUsername?: string }) {
84
+ const userPart = values.scope === 'public' ? 'public' : String(values.userId || '');
85
+ const agentPart = values.aiEmployeeUsername || '*';
86
+ return `${values.scope}:${userPart}:${agentPart}`;
87
+ }
88
+
89
+ async function validateAgentMemoryContextValues(ctx: any) {
90
+ const actionName = ctx.action?.actionName;
91
+ const values = ctx.action?.params?.values || {};
92
+ let nextValues = values;
93
+ let currentId = ctx.action?.params?.filterByTk;
94
+
95
+ if (actionName === 'update' && ctx.action?.params?.filterByTk) {
96
+ const existing = await ctx.db.getRepository('agentMemoryContexts').findOne({
97
+ filter: { id: ctx.action.params.filterByTk },
98
+ });
99
+ currentId = readModelValue(existing, 'id') || currentId;
100
+ nextValues = {
101
+ ...(existing?.toJSON?.() || existing || {}),
102
+ ...values,
103
+ };
104
+ }
105
+
106
+ const scope = normalizeOptionalString(nextValues.scope);
107
+ const userId = nextValues.userId;
108
+ const aiEmployeeUsername = normalizeOptionalString(nextValues.aiEmployeeUsername);
109
+
110
+ if (!['public', 'user', 'agent_user'].includes(scope)) {
111
+ ctx.throw(400, 'scope must be one of: public, user, agent_user.');
112
+ return;
113
+ }
114
+
115
+ if (scope === 'public' && userId != null && userId !== '') {
116
+ ctx.throw(400, 'scope="public" requires userId to be empty.');
117
+ return;
118
+ }
119
+
120
+ if ((scope === 'user' || scope === 'agent_user') && (userId == null || userId === '')) {
121
+ ctx.throw(400, `scope="${scope}" requires userId.`);
122
+ return;
123
+ }
124
+
125
+ if (scope === 'agent_user' && !aiEmployeeUsername) {
126
+ ctx.throw(400, 'scope="agent_user" requires aiEmployeeUsername.');
127
+ return;
128
+ }
129
+
130
+ const normalizedValues = {
131
+ ...values,
132
+ scope,
133
+ userId: scope === 'public' ? null : userId,
134
+ aiEmployeeUsername,
135
+ contextKey: buildAgentMemoryContextKey({
136
+ scope,
137
+ userId: scope === 'public' ? null : userId,
138
+ aiEmployeeUsername,
139
+ }),
140
+ };
141
+
142
+ const repo = ctx.db.getRepository('agentMemoryContexts');
143
+ const duplicate =
144
+ (await repo.findOne({
145
+ filter: { contextKey: normalizedValues.contextKey },
146
+ })) ||
147
+ (await repo.findOne({
148
+ filter: {
149
+ scope,
150
+ userId: normalizedValues.userId,
151
+ aiEmployeeUsername,
152
+ },
153
+ }));
154
+ const duplicateId = readModelValue(duplicate, 'id');
155
+ if (duplicateId && String(duplicateId) !== String(currentId || '')) {
156
+ ctx.throw(400, 'An agent memory context already exists for this scope, user, and AI employee.');
157
+ return;
158
+ }
159
+
160
+ ctx.action.params.values = normalizedValues;
161
+ }
162
+
163
+ export class PluginAgentOrchestratorServer extends Plugin {
164
+ skillHub: SkillHubSubFeature;
165
+ registrySkillSnapshotService: RegistrySkillSnapshotService;
166
+ registrySkillInstallationService: RegistrySkillInstallationService;
167
+ nativeObserver: NativeSubAgentObserver;
168
+ agentRuntimeLifecycle: AgentRuntimeLifecycle;
169
+ private nativeMonitorSyncService!: NativeAgentMonitorSyncService;
170
+ private removeNativeMonitorHook?: () => void;
171
+ private removeManagedPromptProtection?: () => void;
172
+ private removeNativeUsageAttribution?: () => void;
173
+ private governanceEnabled = true;
174
+ loopScheduler: LoopSchedulerService;
175
+ loopWorker: LoopWorkerService;
176
+ private readonly installNativeObserver = () => {
177
+ this.nativeObserver?.install();
178
+ };
179
+
180
+ async afterAdd() {
181
+ this.skillHub = new SkillHubSubFeature(this);
182
+ this.registrySkillSnapshotService = new RegistrySkillSnapshotService(this.db);
183
+ this.registrySkillInstallationService = new RegistrySkillInstallationService(this.db, () =>
184
+ this.skillHub.getSkillRepositoryService(),
185
+ );
186
+ this.nativeObserver = new NativeSubAgentObserver(this);
187
+ this.agentRuntimeLifecycle = new AgentRuntimeLifecycle((hookType, name, error) => {
188
+ this.app.logger.warn(`[AgentOrchestrator] ${hookType} hook "${name}" failed; continuing agent execution.`, {
189
+ error,
190
+ });
191
+ });
192
+ this.nativeMonitorSyncService = new NativeAgentMonitorSyncService(this);
193
+ this.installNativeMonitorHook();
194
+ (this.app as typeof this.app & { agentRuntimeLifecycle: AgentRuntimeLifecycle }).agentRuntimeLifecycle =
195
+ this.agentRuntimeLifecycle;
196
+ }
197
+
198
+ async beforeLoad() {
199
+ // Import collection definitions
200
+ this.db.import({ directory: path.resolve(__dirname, 'collections') });
201
+
202
+ this.db.addMigrations({
203
+ namespace: this.name,
204
+ directory: path.resolve(__dirname, 'migrations'),
205
+ context: { plugin: this },
206
+ });
207
+ }
208
+
209
+ async load() {
210
+ await this.skillHub.load();
211
+
212
+ // --- ACL ---
213
+ this.app.acl.registerSnippet({
214
+ name: `pm.${this.name}`,
215
+ actions: [
216
+ 'orchestratorConfig:*',
217
+ 'orchestratorTracing:*',
218
+ 'agentMonitor:*',
219
+ 'agentUsage:*',
220
+ 'agentGovernance:*',
221
+ 'agentKnowledgeInsights:*',
222
+ 'agentMemoryContexts:*',
223
+ 'agentLoopRuns:*',
224
+ 'agentLoopSteps:*',
225
+ 'agentLoopEvents:*',
226
+ 'agentHarnessProfiles:*',
227
+ 'agentExecutionSpans:*',
228
+ 'skillDefinitions:*',
229
+ 'skillExecutions:*',
230
+ 'skillLoopConfigs:*',
231
+ 'skillHub:*',
232
+ 'skillWorkerConfigs:*',
233
+ ],
234
+ });
235
+
236
+ // Allow any logged-in user to read available skills and loop configs.
237
+ // This mirrors the plugin-ai pattern (acl.allow with 'loggedIn')
238
+ // so that non-admin users with AI roles can use skills without
239
+ // requiring manual snippet assignment per role.
240
+ // Create/update/destroy remain restricted to admin roles via the snippet above.
241
+ this.app.acl.allow('skillDefinitions', 'list', 'loggedIn');
242
+ this.app.acl.allow('skillDefinitions', 'get', 'loggedIn');
243
+ this.app.acl.allow('skillLoopConfigs', 'list', 'loggedIn');
244
+ this.app.acl.allow('skillLoopConfigs', 'get', 'loggedIn');
245
+ this.app.acl.allow('skillExecutions', 'list', 'loggedIn');
246
+ this.app.acl.allow('skillExecutions', 'get', 'loggedIn');
247
+ this.app.acl.allow('skillHub', 'download', 'loggedIn');
248
+ this.app.acl.allow('skillHub', 'listTemplates', 'loggedIn');
249
+ this.app.acl.allow('agentMonitor', ['list', 'get'], 'loggedIn');
250
+ // ACL runs before the resource handler, so every owner-facing loop action must be listed
251
+ // here; ownership itself is enforced inside each handler by LoopRunRepository.
252
+ this.app.acl.allow(
253
+ 'agentLoops',
254
+ ['list', 'get', 'runNow', 'pause', 'resume', 'cancel', 'retry', 'escalate', 'acceptResult', 'status'],
255
+ 'loggedIn',
256
+ );
257
+ this.app.acl.allow('agentLoopApprovals', ['list', 'get', 'decide'], 'loggedIn');
258
+ this.app.acl.allow('agentLoopArtifactsView', ['list', 'get'], 'loggedIn');
259
+ this.app.acl.allow('agentLoopEventsStream', ['stream'], 'loggedIn');
260
+
261
+ this.installGovernanceHooks();
262
+ this.app.resourceManager.use(
263
+ async (ctx, next) => {
264
+ const { resourceName, actionName } = ctx.action || {};
265
+ if (
266
+ this.governanceEnabled &&
267
+ typeof resourceName === 'string' &&
268
+ [
269
+ 'agentGovernancePolicies',
270
+ 'agentGovernancePolicyVersions',
271
+ 'agentGovernancePromptBindings',
272
+ 'agentGovernanceAuditEvents',
273
+ ].includes(resourceName) &&
274
+ actionName
275
+ ) {
276
+ return ctx.throw(403, ctx.t('Governance records are only available through governance actions.'));
277
+ }
278
+ try {
279
+ await next();
280
+ } catch (error) {
281
+ if (error instanceof ManagedPromptError) return ctx.throw(403, ctx.t(error.message));
282
+ throw error;
283
+ }
284
+ },
285
+ { tag: 'orchestrator-governance-record-protection', after: 'acl' },
286
+ );
287
+ const governanceAdmission = createGovernanceAdmission(this, () => this.governanceEnabled);
288
+ this.app.resourceManager.use(async (ctx, next) => governanceAdmission(ctx as Context, next), {
289
+ tag: 'orchestrator-governance-admission',
290
+ after: 'acl',
291
+ });
292
+
293
+ // Data scoping for skillExecutions: a logged-in non-admin user may only
294
+ // read their own executions. Rows hold inputArgs / stdout / output files,
295
+ // so an unscoped list/get would leak one user's data to another. Admins
296
+ // (root/admin roles) keep full visibility. This mirrors the owner/admin
297
+ // check enforced by skillHub:download.
298
+ this.app.resourceManager.use(
299
+ async (ctx, next) => {
300
+ const { resourceName, actionName } = ctx.action || {};
301
+ if (resourceName === 'skillExecutions' && (actionName === 'list' || actionName === 'get')) {
302
+ if (!isAdminUser(ctx)) {
303
+ const userId = currentUserId(ctx);
304
+ const ownerFilter = userId ? { triggeredById: userId } : { triggeredById: null };
305
+ ctx.action.mergeParams({ filter: ownerFilter });
306
+ }
307
+ }
308
+ await next();
309
+ },
310
+ { tag: 'orchestrator-skill-executions-scope', after: 'acl' },
311
+ );
312
+
313
+ this.app.resourceManager.use(
314
+ async (ctx, next) => {
315
+ const { resourceName, actionName } = ctx.action || {};
316
+ if (resourceName !== 'skillDefinitions') {
317
+ await next();
318
+ return;
319
+ }
320
+
321
+ const values = ctx.action?.params?.values || {};
322
+ if (actionName === 'create' || actionName === 'update') {
323
+ try {
324
+ if (Object.prototype.hasOwnProperty.call(values, 'inputSchema')) {
325
+ validateInputSchemaDefinition(values.inputSchema);
326
+ }
327
+
328
+ if (actionName === 'create') {
329
+ const toolName = buildSkillToolName(values.name);
330
+ await assertSkillToolNameAvailable(ctx.db, toolName);
331
+ values.toolName = toolName;
332
+ } else {
333
+ const existing = await ctx.db.getRepository('skillDefinitions').findOne({
334
+ filterByTk: ctx.action?.params?.filterByTk,
335
+ });
336
+ if (existing) {
337
+ const stableToolName = getSkillToolName(existing);
338
+ if (values.toolName && values.toolName !== stableToolName) {
339
+ ctx.throw(400, 'toolName is immutable after a skill is created.');
340
+ return;
341
+ }
342
+ values.toolName = stableToolName;
343
+ }
344
+ }
345
+ } catch (error) {
346
+ ctx.throw(400, error instanceof Error ? error.message : String(error));
347
+ return;
348
+ }
349
+ }
350
+
351
+ if (actionName === 'destroy') {
352
+ const existing = await ctx.db.getRepository('skillDefinitions').findOne({
353
+ filterByTk: ctx.action?.params?.filterByTk,
354
+ });
355
+ if (existing) {
356
+ const toolName = getSkillToolName(existing);
357
+ const agentUsernames = await this.skillHub.skillAccessService.findAgentUsernamesUsingTool(toolName);
358
+ if (agentUsernames.length > 0) {
359
+ ctx.throw(
360
+ 409,
361
+ `Skill tool "${toolName}" is still bound to AI employees: ${agentUsernames.join(
362
+ ', ',
363
+ )}. Disable or unbind it before deletion.`,
364
+ );
365
+ return;
366
+ }
367
+ }
368
+ }
369
+
370
+ await next();
371
+
372
+ // When a skill is disabled via update, cascade-remove its tool from all AI employee
373
+ // bindings. This prevents stale bindings from allowing execution of disabled skills.
374
+ if (actionName === 'update' && values.enabled === false) {
375
+ const tk = ctx.action?.params?.filterByTk;
376
+ if (tk) {
377
+ const skillRecord = await ctx.db.getRepository('skillDefinitions').findOne({ filterByTk: tk });
378
+ if (skillRecord) {
379
+ const toolName = getSkillToolName(skillRecord);
380
+ if (toolName) {
381
+ await this.skillHub.skillAccessService.cascadeDisableSkill(toolName);
382
+ }
383
+ }
384
+ }
385
+ }
386
+
387
+ if ((actionName === 'list' || actionName === 'get') && !isAdminUser(ctx)) {
388
+ ctx.body = redactSkillResponse(ctx.body);
389
+ }
390
+ },
391
+ { tag: 'orchestrator-skill-definition-policy', after: 'acl' },
392
+ );
393
+
394
+ this.app.resourceManager.use(
395
+ async (ctx, next) => {
396
+ const { resourceName, actionName } = ctx.action || {};
397
+ if (resourceName === 'agentMemoryContexts' && (actionName === 'create' || actionName === 'update')) {
398
+ await validateAgentMemoryContextValues(ctx);
399
+ }
400
+ await next();
401
+ },
402
+ { tag: 'orchestrator-agent-memory-context-policy', after: 'acl' },
403
+ );
404
+
405
+ // --- Register External Tool Only ---
406
+ // Native @nocobase/plugin-ai owns reasoning, planning/replanning and sub-agent dispatch.
407
+ // The orchestrator no longer injects planning prompts or registers self-state AI tools; it
408
+ // drives work through the Loop Control Plane (trigger → durable run → worker → verifier).
409
+ const toolsManager = getAIToolsManager(this.app);
410
+ toolsManager.registerTools(createExternalRagSearchTool(this));
411
+
412
+ // --- Loop Control Plane runtime ---
413
+ const patterns = new LoopPatternService(this.db, employeeHarnessResolver(this), async () =>
414
+ worktreeCapability(this),
415
+ );
416
+ const triggers = new LoopTriggerService(this.db, patterns, this.app.log);
417
+ this.loopScheduler = new LoopSchedulerService(this, patterns, triggers);
418
+ this.loopWorker = new LoopWorkerService(this.app, this.db);
419
+ this.loopScheduler.install();
420
+ this.app.on?.('afterStart', this.startLoopWorker);
421
+
422
+ registerAgentLoopResource(this);
423
+ registerAgentLoopApprovalResource(this);
424
+ registerAgentLoopArtifactResource(this);
425
+ registerAgentLoopEventsStreamResource(this);
426
+ registerAgentHarnessProfileResource(this);
427
+ registerAgentGovernanceResource(this);
428
+ registerAgentUsageResource(this);
429
+
430
+ // --- Native plugin-ai Monitor Resource ---
431
+ registerAgentMonitorResource(this);
432
+ registerAgentKnowledgeInsightsResource(this);
433
+ this.installNativeObserver();
434
+ this.app.on?.('afterStart', this.installNativeObserver);
435
+
436
+ // --- Register Tracing Resource (Phase 5) ---
437
+ // Custom read-only resource for the Swarm Tracing admin page.
438
+ registerTracingResource(this);
439
+
440
+ // --- Log Retention ---
441
+ // Daily prune of orchestratorLogs / agentExecutionSpans to keep tables bounded.
442
+ // Override window via env: ORCHESTRATOR_LOG_RETENTION_DAYS (default 30).
443
+ this.app.cronJobManager.addJob({
444
+ cronTime: '0 30 2 * * *',
445
+ onTick: async () => {
446
+ try {
447
+ const days = await resolveTracingRetentionDays(this);
448
+ const cutoff = new Date(Date.now() - days * 86400000);
449
+ const repo = this.db.getRepository('orchestratorLogs');
450
+ const spansRepo = this.db.getRepository('agentExecutionSpans');
451
+ const deletedLogs = repo
452
+ ? await repo.destroy({
453
+ filter: { createdAt: { $lt: cutoff.toISOString() } },
454
+ })
455
+ : 0;
456
+ const deletedSpans = spansRepo
457
+ ? await spansRepo.destroy({
458
+ // Model-call rows are the accounting ledger; trace retention must not remove
459
+ // usage needed for future totals and historical price snapshots.
460
+ filter: {
461
+ $and: [
462
+ { $or: [{ type: { $ne: 'model_call' } }, { type: null }] },
463
+ {
464
+ $or: [
465
+ { source: 'native-plugin-ai', nativeActivityAt: { $lt: cutoff.toISOString() } },
466
+ {
467
+ source: 'native-plugin-ai',
468
+ nativeActivityAt: null,
469
+ startedAt: { $lt: cutoff.toISOString() },
470
+ },
471
+ {
472
+ source: 'native-plugin-ai',
473
+ nativeActivityAt: null,
474
+ startedAt: null,
475
+ createdAt: { $lt: cutoff.toISOString() },
476
+ },
477
+ { source: { $ne: 'native-plugin-ai' }, createdAt: { $lt: cutoff.toISOString() } },
478
+ { source: null, createdAt: { $lt: cutoff.toISOString() } },
479
+ ],
480
+ },
481
+ ],
482
+ },
483
+ })
484
+ : 0;
485
+ this.app.log.info(
486
+ `[AgentOrchestrator] Pruned ${deletedLogs} orchestratorLogs and ${deletedSpans} agentExecutionSpans rows older than ${days} day(s).`,
487
+ );
488
+ } catch (e) {
489
+ this.app.log.error('[AgentOrchestrator] Log retention job failed', e);
490
+ }
491
+ },
492
+ });
493
+
494
+ // --- Skill Metrics Aggregation ---
495
+ // Daily roll-up of skillExecutions into per-skill/per-employee metrics for
496
+ // operational dashboards. Override schedule via env: SKILL_METRICS_CRON (default 03:00).
497
+ this.app.cronJobManager.addJob({
498
+ cronTime: process.env.SKILL_METRICS_CRON || '0 0 3 * * *',
499
+ onTick: async () => {
500
+ try {
501
+ await this.aggregateSkillMetrics();
502
+ } catch (e) {
503
+ this.app.log.error('[AgentOrchestrator] Skill metrics aggregation job failed', e);
504
+ }
505
+ },
506
+ });
507
+
508
+ // Native sub-agent conversations are owned by @nocobase/plugin-ai. This
509
+ // plugin only observes their execution spans and policy context.
510
+ }
511
+
512
+ private async aggregateSkillMetrics() {
513
+ const yesterday = new Date(Date.now() - 86400000);
514
+ yesterday.setUTCHours(0, 0, 0, 0);
515
+ const today = new Date(yesterday.getTime() + 86400000);
516
+
517
+ const repo = this.db.getRepository('skillExecutions');
518
+ if (!repo) return;
519
+
520
+ const rows = await repo.find({
521
+ filter: {
522
+ createdAt: {
523
+ $gte: yesterday.toISOString(),
524
+ $lt: today.toISOString(),
525
+ },
526
+ },
527
+ fields: ['skillId', 'aiEmployeeUsername', 'status', 'durationMs'],
528
+ });
529
+
530
+ type MetricKey = string;
531
+ interface MetricBucket {
532
+ executions: number;
533
+ successes: number;
534
+ failures: number;
535
+ timeouts: number;
536
+ durations: number[];
537
+ }
538
+
539
+ const buckets = new Map<MetricKey, MetricBucket>();
540
+
541
+ for (const row of rows) {
542
+ const skillId = String(row.get?.('skillId') || '');
543
+ const username = String(row.get?.('aiEmployeeUsername') || '');
544
+ const status = String(row.get?.('status') || '');
545
+ const durationMs = Number(row.get?.('durationMs') || 0);
546
+ if (!skillId) continue;
547
+
548
+ const key = `${skillId}:${username}`;
549
+ if (!buckets.has(key)) {
550
+ buckets.set(key, { executions: 0, successes: 0, failures: 0, timeouts: 0, durations: [] });
551
+ }
552
+ const bucket = buckets.get(key) ?? { executions: 0, successes: 0, failures: 0, timeouts: 0, durations: [] };
553
+ bucket.executions += 1;
554
+ if (status === 'succeeded') bucket.successes += 1;
555
+ else if (status === 'timeout') bucket.timeouts += 1;
556
+ else if (status === 'failed') bucket.failures += 1;
557
+ if (durationMs > 0) bucket.durations.push(durationMs);
558
+ }
559
+
560
+ const metricsRepo = this.db.getRepository('skillMetrics');
561
+ if (!metricsRepo) return;
562
+
563
+ let upserted = 0;
564
+ for (const [key, bucket] of buckets) {
565
+ const firstColon = key.indexOf(':');
566
+ const skillId = key.substring(0, firstColon);
567
+ const employeeUsername = key.substring(firstColon + 1);
568
+ const sortedDurations = [...bucket.durations].sort((a, b) => a - b);
569
+ const p95Index = Math.max(0, Math.ceil(sortedDurations.length * 0.95) - 1);
570
+ const totalDuration = sortedDurations.reduce((sum, d) => sum + d, 0);
571
+
572
+ await metricsRepo.updateOrCreate({
573
+ filterKeys: ['skillId', 'employeeUsername', 'period'],
574
+ values: {
575
+ skillId: skillId,
576
+ employeeUsername,
577
+ period: yesterday.toISOString(),
578
+ executions: bucket.executions,
579
+ successes: bucket.successes,
580
+ failures: bucket.failures,
581
+ timeouts: bucket.timeouts,
582
+ avgDurationMs: bucket.durations.length ? Math.round(totalDuration / bucket.durations.length) : 0,
583
+ p95DurationMs: sortedDurations.length > 1 ? sortedDurations[p95Index] : sortedDurations[0] || 0,
584
+ totalDurationMs: totalDuration,
585
+ },
586
+ });
587
+ upserted += 1;
588
+ }
589
+
590
+ this.app.log.info(
591
+ `[AgentOrchestrator] Skill metrics aggregated for ${yesterday
592
+ .toISOString()
593
+ .slice(0, 10)}: ${upserted} metric row(s).`,
594
+ );
595
+ }
596
+
597
+ async install() {
598
+ await this.skillHub.install();
599
+ await ensureAgentOrchestratorIndexes(this.db);
600
+ }
601
+
602
+ async upgrade() {
603
+ await ensureAgentOrchestratorIndexes(this.db);
604
+ }
605
+
606
+ async afterEnable() {
607
+ this.governanceEnabled = true;
608
+ this.installGovernanceHooks();
609
+ this.installNativeMonitorHook();
610
+ }
611
+ async afterDisable() {
612
+ this.governanceEnabled = false;
613
+ this.removeManagedPromptProtection?.();
614
+ this.removeManagedPromptProtection = undefined;
615
+ this.removeNativeUsageAttribution?.();
616
+ this.removeNativeUsageAttribution = undefined;
617
+ this.nativeObserver?.uninstall();
618
+ this.removeNativeMonitorHook?.();
619
+ this.removeNativeMonitorHook = undefined;
620
+ }
621
+ async remove() {}
622
+
623
+ async beforeStop() {
624
+ this.governanceEnabled = false;
625
+ this.removeManagedPromptProtection?.();
626
+ this.removeManagedPromptProtection = undefined;
627
+ this.removeNativeUsageAttribution?.();
628
+ this.removeNativeUsageAttribution = undefined;
629
+ this.app.off?.('afterStart', this.installNativeObserver);
630
+ this.app.removeListener?.('afterStart', this.installNativeObserver);
631
+ this.app.off?.('afterStart', this.startLoopWorker);
632
+ this.app.removeListener?.('afterStart', this.startLoopWorker);
633
+ await this.loopWorker?.stop();
634
+ await this.loopScheduler?.dispose();
635
+ this.nativeObserver?.uninstall();
636
+ this.removeNativeMonitorHook?.();
637
+ this.removeNativeMonitorHook = undefined;
638
+ await this.skillHub.beforeStop();
639
+ resetRunEventBus();
640
+ }
641
+
642
+ async handleSyncMessage(message: unknown) {
643
+ await this.loopScheduler?.handleSyncMessage(message);
644
+ await this.loopWorker?.handleSyncMessage(message);
645
+ }
646
+
647
+ private readonly startLoopWorker = () => {
648
+ this.loopWorker?.start();
649
+ };
650
+
651
+ private installGovernanceHooks() {
652
+ if (!this.removeManagedPromptProtection)
653
+ this.removeManagedPromptProtection = installManagedPromptProtection(this.db);
654
+ if (!this.removeNativeUsageAttribution) this.removeNativeUsageAttribution = installNativeUsageAttribution(this);
655
+ }
656
+
657
+ private installNativeMonitorHook() {
658
+ if (this.removeNativeMonitorHook || !this.agentRuntimeLifecycle || !this.nativeMonitorSyncService) return;
659
+ this.removeNativeMonitorHook = this.agentRuntimeLifecycle.registerAfterRunHook('native-monitor', (context) => {
660
+ if (context.source !== 'api' || !context.sessionId) return;
661
+ // The custom API lifecycle is best effort, not a global core hook. A detached bounded
662
+ // page avoids delaying the response; durable usage events support later reconciliation.
663
+ this.nativeMonitorSyncService.syncSession(context.sessionId).catch((error: unknown) => {
664
+ try {
665
+ this.app.logger.warn('[AgentOrchestrator] Failed to sync API agent telemetry.', { error });
666
+ } catch {
667
+ // Telemetry logging cannot affect native agent execution.
668
+ }
669
+ });
670
+ });
671
+ }
672
+ }
673
+
674
+ export default PluginAgentOrchestratorServer;