plugin-agent-orchestrator 1.1.8 → 1.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (495) hide show
  1. package/LICENSE +201 -0
  2. package/README.md +207 -204
  3. package/client-v2.d.ts +2 -2
  4. package/client-v2.js +1 -1
  5. package/client.d.ts +2 -2
  6. package/client.js +1 -1
  7. package/dist/client/117.6c69b6a87751dd18.js +10 -0
  8. package/dist/client/253.52f62e1bc0e9520a.js +10 -0
  9. package/dist/client/325.8f7f509bdb35e142.js +10 -0
  10. package/dist/client/404.86593f98c9768ed5.js +10 -0
  11. package/dist/client/453.fa2d169576262213.js +10 -0
  12. package/dist/client/53.567db3ae078650c6.js +10 -0
  13. package/dist/client/619.01713281e5e951d3.js +10 -0
  14. package/dist/client/652.69da1598312b3a3f.js +10 -0
  15. package/dist/client/773.648965568ff476f9.js +10 -0
  16. package/dist/client/981.37e7aeecdb1ef6fa.js +10 -0
  17. package/dist/client/993.ac89f3852990918d.js +10 -0
  18. package/dist/client/index.js +1 -1
  19. package/dist/client-v2/117.c982d79ff68738f5.js +10 -0
  20. package/dist/client-v2/214.94c4257bf2838577.js +10 -0
  21. package/dist/client-v2/253.8e19956d2a44dfb8.js +10 -0
  22. package/dist/client-v2/264.80e8e358c8c6c2e5.js +10 -0
  23. package/dist/client-v2/325.fafe5a6e83ba9cb3.js +10 -0
  24. package/dist/client-v2/404.ab032b79c95dab6f.js +10 -0
  25. package/dist/client-v2/{41.3deb9e57a0f64fc4.js → 41.cd5610fcf7446127.js} +1 -1
  26. package/dist/client-v2/453.42c6d70628d56cc2.js +10 -0
  27. package/dist/client-v2/{53.349fff8db80b19d4.js → 53.37c08089a648f89a.js} +1 -1
  28. package/dist/client-v2/{619.0a2144aaffefe018.js → 619.6e9618550101e819.js} +1 -1
  29. package/dist/client-v2/652.eeba4e0c38367321.js +10 -0
  30. package/dist/client-v2/{70.ffff2997c10fd4b0.js → 70.332698e53eb59677.js} +1 -1
  31. package/dist/client-v2/773.4de2ba5acb07318c.js +10 -0
  32. package/dist/client-v2/981.76060f466e6f7c11.js +10 -0
  33. package/dist/client-v2/993.f8cdb5172566ce75.js +10 -0
  34. package/dist/client-v2/index.js +1 -1
  35. package/dist/externalVersion.js +13 -7
  36. package/dist/locale/en-US.json +308 -1
  37. package/dist/locale/vi-VN.json +5 -1
  38. package/dist/locale/zh-CN.json +308 -1
  39. package/dist/node_modules/acorn/LICENSE +21 -0
  40. package/dist/node_modules/acorn/bin/acorn +4 -0
  41. package/dist/node_modules/acorn/dist/acorn.d.mts +857 -0
  42. package/dist/node_modules/acorn/dist/acorn.d.ts +857 -0
  43. package/dist/node_modules/acorn/dist/acorn.js +1 -0
  44. package/dist/node_modules/acorn/dist/bin.js +90 -0
  45. package/dist/node_modules/acorn/package.json +1 -0
  46. package/dist/node_modules/acorn-walk/LICENSE +21 -0
  47. package/dist/node_modules/acorn-walk/dist/walk.d.mts +177 -0
  48. package/dist/node_modules/acorn-walk/dist/walk.d.ts +177 -0
  49. package/dist/node_modules/acorn-walk/dist/walk.js +1 -0
  50. package/dist/node_modules/acorn-walk/node_modules/.bin/acorn +15 -0
  51. package/dist/node_modules/acorn-walk/node_modules/.bin/acorn.cmd +7 -0
  52. package/dist/node_modules/acorn-walk/node_modules/acorn/bin/acorn +4 -0
  53. package/dist/node_modules/acorn-walk/node_modules/acorn/dist/acorn.d.mts +866 -0
  54. package/dist/node_modules/acorn-walk/node_modules/acorn/dist/acorn.d.ts +866 -0
  55. package/dist/node_modules/acorn-walk/node_modules/acorn/dist/acorn.js +6174 -0
  56. package/dist/node_modules/acorn-walk/node_modules/acorn/dist/bin.js +90 -0
  57. package/dist/node_modules/acorn-walk/node_modules/acorn/package.json +50 -0
  58. package/dist/node_modules/acorn-walk/package.json +1 -0
  59. package/dist/node_modules/adm-zip/adm-zip.js +1 -1
  60. package/dist/node_modules/adm-zip/package.json +1 -1
  61. package/dist/node_modules/ajv/package.json +1 -1
  62. package/dist/node_modules/zod/index.cjs +1 -1
  63. package/dist/node_modules/zod/package.json +1 -1
  64. package/dist/server/collections/agent-auto-approval-checkpoints.js +47 -0
  65. package/dist/server/collections/agent-execution-spans.js +148 -9
  66. package/dist/server/collections/agent-governance-audit-events.js +47 -0
  67. package/dist/server/collections/agent-governance-policies.js +47 -0
  68. package/dist/server/collections/agent-governance-policy-versions.js +48 -0
  69. package/dist/server/collections/agent-governance-prompt-bindings.js +50 -0
  70. package/dist/server/collections/agent-hierarchy-invocations.js +59 -0
  71. package/dist/server/collections/agent-loop-runs.js +23 -5
  72. package/dist/server/collections/agent-routing-graph-locks.js +40 -0
  73. package/dist/server/collections/agent-session-auto-approvals.js +45 -0
  74. package/dist/server/collections/orchestrator-config.js +17 -0
  75. package/dist/server/migrations/20261110000000-add-usage-pricing-snapshots.js +117 -0
  76. package/dist/server/migrations/20261110010000-add-usage-department-attribution.js +54 -0
  77. package/dist/server/migrations/20261119000000-widen-native-employee-identifiers.js +59 -0
  78. package/dist/server/plugin.js +169 -33
  79. package/dist/server/resources/agent-auto-approval.js +80 -0
  80. package/dist/server/resources/agent-governance.js +192 -0
  81. package/dist/server/resources/agent-harness-profile.js +11 -3
  82. package/dist/server/resources/agent-monitor.js +109 -339
  83. package/dist/server/resources/agent-usage.js +423 -0
  84. package/dist/server/resources/hierarchical-routing.js +60 -0
  85. package/dist/server/resources/native-monitor-format.js +179 -0
  86. package/dist/server/resources/tracing.js +35 -12
  87. package/dist/server/services/AgentGovernanceService.js +500 -0
  88. package/dist/server/services/AutoApprovalCheckpoint.js +133 -0
  89. package/dist/server/services/CodeValidator.js +8 -4
  90. package/dist/server/services/DepartmentAttribution.js +65 -0
  91. package/dist/server/services/ExecutionSpanService.js +96 -3
  92. package/dist/server/services/GovernanceAdmission.js +271 -0
  93. package/dist/server/services/HarnessCapabilities.js +118 -0
  94. package/dist/server/services/HarnessCompiler.js +3 -0
  95. package/dist/server/services/HarnessSchema.js +13 -1
  96. package/dist/server/services/HierarchicalAgentRuntime.js +925 -0
  97. package/dist/server/services/HierarchyEnrollmentGuard.js +216 -0
  98. package/dist/server/services/HierarchyInvocationJournal.js +157 -0
  99. package/dist/server/services/HierarchyRequestCancellation.js +150 -0
  100. package/dist/server/services/LoopBudgetService.js +29 -11
  101. package/dist/server/services/LoopRunRepository.js +16 -7
  102. package/dist/server/services/LoopRunStateMachine.js +20 -9
  103. package/dist/server/services/LoopTriggerService.js +1 -1
  104. package/dist/server/services/LoopWorkerService.js +71 -37
  105. package/dist/server/services/ManagedPromptProtection.js +99 -0
  106. package/dist/server/services/NativeAgentMonitorSyncService.js +584 -0
  107. package/dist/server/services/NativeSubAgentObserver.js +141 -508
  108. package/dist/server/services/NativeUsageAttribution.js +97 -0
  109. package/dist/server/services/PluginAiRuntimeAdapter.js +107 -9
  110. package/dist/server/services/RoutingBindingRepository.js +156 -0
  111. package/dist/server/services/RoutingBindingValidation.js +161 -0
  112. package/dist/server/services/SandboxRunner.js +19 -0
  113. package/dist/server/services/SessionAutoApproval.js +173 -0
  114. package/dist/server/services/TokenTracker.js +787 -104
  115. package/dist/server/services/TracingRetentionPolicy.js +66 -0
  116. package/dist/server/services/VerificationService.js +20 -10
  117. package/dist/server/skill-hub/plugin.js +17 -0
  118. package/dist/server/skill-hub/sandbox-config.json +6 -6
  119. package/dist/server/skill-hub/services/RegistrySkillInstallationService.js +2 -2
  120. package/dist/server/skill-hub/services/registry-node-package.js +191 -0
  121. package/dist/server/skill-hub/tasks/SkillExecutionTask.js +21 -6
  122. package/dist/server/tools/skill-execute.js +1 -0
  123. package/dist/server/utils/ensure-indexes.js +15 -5
  124. package/package.json +66 -53
  125. package/server.d.ts +2 -2
  126. package/server.js +1 -1
  127. package/src/client/AgentRunsTab.tsx +2 -2
  128. package/src/client/ApprovalsTab.tsx +2 -2
  129. package/src/client/HarnessProfilesTab.tsx +2 -2
  130. package/src/client/OrchestratorSettings.tsx +152 -152
  131. package/src/client/SkillPages.tsx +34 -0
  132. package/src/client/__tests__/embedded-settings.test.tsx +225 -0
  133. package/src/client/hooks/useRunEventStream.ts +76 -76
  134. package/src/client/index.tsx +2 -2
  135. package/src/client/plugin.tsx +71 -33
  136. package/src/client/skill-hub/components/ExecutionHistory.tsx +200 -200
  137. package/src/client/skill-hub/components/GitSkillImport.tsx +562 -562
  138. package/src/client/skill-hub/components/LoopSettings.tsx +331 -331
  139. package/src/client/skill-hub/components/SkillEditor.tsx +460 -460
  140. package/src/client/skill-hub/components/SkillManager.tsx +194 -194
  141. package/src/client/skill-hub/components/SkillMetrics.tsx +162 -162
  142. package/src/client/skill-hub/components/SkillTestPanel.tsx +141 -141
  143. package/src/client/skill-hub/index.tsx +6 -6
  144. package/src/client/skill-hub/locale.ts +16 -16
  145. package/src/client/skill-hub/tools/InteractionSchemasProvider.tsx +147 -132
  146. package/src/client/skill-hub/tools/SkillHubCard.tsx +110 -104
  147. package/src/client/skill-hub/tools/__tests__/skill-hub-card.test.tsx +255 -0
  148. package/src/client/skill-hub/tools/loopTemplates.ts +52 -52
  149. package/src/client/skill-hub/tools/registerSkillLoopCards.ts +80 -71
  150. package/src/client/skill-hub/utils/jsonFields.ts +41 -41
  151. package/src/client-v2/__tests__/embedded-settings.test.tsx +202 -0
  152. package/src/client-v2/__tests__/hierarchical-routing-settings.test.tsx +350 -0
  153. package/src/client-v2/auto-approval/AutoApprovalBridge.tsx +513 -0
  154. package/src/client-v2/auto-approval/AutoApprovalProvider.tsx +399 -0
  155. package/src/client-v2/auto-approval/__tests__/session-auto-approval.test.tsx +1676 -0
  156. package/src/client-v2/components/AIEmployeeSelect.tsx +47 -47
  157. package/src/client-v2/components/AIEmployeesContext.tsx +97 -97
  158. package/src/client-v2/components/AgentBindingsTab.tsx +541 -269
  159. package/src/client-v2/components/AgentRunsTab.tsx +85 -83
  160. package/src/client-v2/components/ApprovalsTab.tsx +337 -337
  161. package/src/client-v2/components/EmployeeGovernanceTab.tsx +695 -0
  162. package/src/client-v2/components/HarnessProfilesTab.tsx +700 -541
  163. package/src/client-v2/components/HarnessSettingsForm.tsx +221 -0
  164. package/src/client-v2/components/KnowledgeAccessTab.tsx +116 -116
  165. package/src/client-v2/components/RetrievalTraceTab.tsx +162 -162
  166. package/src/client-v2/components/UsageGovernanceTab.tsx +379 -0
  167. package/src/client-v2/index.tsx +1 -1
  168. package/src/client-v2/pages/AgentBindingsPage.tsx +15 -13
  169. package/src/client-v2/pages/ApprovalsPage.tsx +12 -10
  170. package/src/client-v2/pages/EmployeeGovernancePage.tsx +15 -0
  171. package/src/client-v2/pages/ExecutionHistoryPage.tsx +12 -10
  172. package/src/client-v2/pages/HarnessProfilesPage.tsx +12 -10
  173. package/src/client-v2/pages/KnowledgeAccessPage.tsx +12 -10
  174. package/src/client-v2/pages/LoopSettingsPage.tsx +12 -10
  175. package/src/client-v2/pages/MemoryInspectorPage.tsx +15 -13
  176. package/src/client-v2/pages/RetrievalTracePage.tsx +12 -10
  177. package/src/client-v2/pages/RulesPage.tsx +15 -13
  178. package/src/client-v2/pages/SkillDefinitionsPage.tsx +12 -10
  179. package/src/client-v2/pages/SkillMetricsPage.tsx +12 -10
  180. package/src/client-v2/pages/TracingPage.tsx +15 -13
  181. package/src/client-v2/pages/UsageGovernancePage.tsx +15 -0
  182. package/src/client-v2/plugin.tsx +134 -111
  183. package/src/client-v2/skill-hub/components/ExecutionHistory.tsx +196 -196
  184. package/src/client-v2/skill-hub/components/FileLinkList.tsx +37 -37
  185. package/src/client-v2/skill-hub/components/GitSkillImport.tsx +539 -539
  186. package/src/client-v2/skill-hub/components/LoopSettings.tsx +331 -331
  187. package/src/client-v2/skill-hub/components/SkillEditor.tsx +453 -453
  188. package/src/client-v2/skill-hub/components/SkillManager.tsx +191 -174
  189. package/src/client-v2/skill-hub/components/SkillMetrics.tsx +162 -162
  190. package/src/client-v2/skill-hub/components/SkillTestPanel.tsx +135 -135
  191. package/src/client-v2/skill-hub/locale.ts +13 -13
  192. package/src/client-v2/skill-hub/tools/InteractionSchemasProvider.tsx +62 -0
  193. package/src/client-v2/skill-hub/tools/SkillHubCard.tsx +104 -0
  194. package/src/client-v2/skill-hub/tools/__tests__/interactions.test.ts +126 -0
  195. package/src/client-v2/skill-hub/tools/interactions.ts +137 -0
  196. package/src/client-v2/skill-hub/tools/loopTemplates.ts +52 -52
  197. package/src/client-v2/skill-hub/utils/jsonFields.ts +41 -41
  198. package/src/client-v2/utils/jsonFields.ts +41 -41
  199. package/src/index.ts +2 -2
  200. package/src/locale/en-US.json +308 -1
  201. package/src/locale/vi-VN.json +5 -1
  202. package/src/locale/zh-CN.json +308 -1
  203. package/src/server/__tests__/agent-execution-context.test.ts +18 -18
  204. package/src/server/__tests__/agent-governance.integration.test.ts +385 -0
  205. package/src/server/__tests__/agent-knowledge-insights.test.ts +123 -123
  206. package/src/server/__tests__/agent-monitor-acl.integration.test.ts +267 -0
  207. package/src/server/__tests__/agent-registry-service.test.ts +147 -147
  208. package/src/server/__tests__/agent-runtime-lifecycle.test.ts +46 -46
  209. package/src/server/__tests__/agent-usage-report.integration.test.ts +335 -0
  210. package/src/server/__tests__/auto-approval-checkpoint.integration.test.ts +295 -0
  211. package/src/server/__tests__/code-validator.test.ts +63 -63
  212. package/src/server/__tests__/external-rag-search.test.ts +107 -107
  213. package/src/server/__tests__/harness-capabilities.test.ts +88 -0
  214. package/src/server/__tests__/harness-compiler.test.ts +278 -214
  215. package/src/server/__tests__/harness-profile-service.test.ts +167 -167
  216. package/src/server/__tests__/harness-runtime-policy.test.ts +293 -293
  217. package/src/server/__tests__/harness-tool-plan.test.ts +175 -172
  218. package/src/server/__tests__/hierarchical-routing.integration.test.ts +2318 -0
  219. package/src/server/__tests__/hierarchy-invocation-journal.integration.test.ts +119 -0
  220. package/src/server/__tests__/input-schema-validator.test.ts +26 -26
  221. package/src/server/__tests__/loop-approval-decision.test.ts +624 -512
  222. package/src/server/__tests__/loop-approval-expiry.test.ts +258 -258
  223. package/src/server/__tests__/loop-budget-service.test.ts +29 -0
  224. package/src/server/__tests__/loop-pattern-schema.test.ts +73 -73
  225. package/src/server/__tests__/loop-run-repository.test.ts +25 -0
  226. package/src/server/__tests__/loop-run-state-machine.test.ts +101 -101
  227. package/src/server/__tests__/loop-trigger-service.test.ts +185 -148
  228. package/src/server/__tests__/loop-worker-claim.test.ts +110 -10
  229. package/src/server/__tests__/loop-worker-execution.test.ts +375 -317
  230. package/src/server/__tests__/native-agent-monitor-sync.test.ts +343 -0
  231. package/src/server/__tests__/native-hierarchy-probe.integration.test.ts +527 -0
  232. package/src/server/__tests__/native-sub-agent-observer.test.ts +463 -662
  233. package/src/server/__tests__/native-usage-attribution.integration.test.ts +168 -0
  234. package/src/server/__tests__/plugin-ai-runtime-adapter.test.ts +403 -0
  235. package/src/server/__tests__/registry-node-package.test.ts +299 -0
  236. package/src/server/__tests__/routing-binding-graph.integration.test.ts +217 -0
  237. package/src/server/__tests__/routing-binding-validation.test.ts +256 -0
  238. package/src/server/__tests__/session-auto-approval.integration.test.ts +329 -0
  239. package/src/server/__tests__/skill-access-service.test.ts +64 -64
  240. package/src/server/__tests__/skill-execute.test.ts +81 -70
  241. package/src/server/__tests__/skill-execution-task-policy.test.ts +140 -140
  242. package/src/server/__tests__/skill-review-guard.test.ts +171 -0
  243. package/src/server/__tests__/skill-sandbox-worker-mode.test.ts +15 -15
  244. package/src/server/__tests__/skill-settings.test.ts +63 -63
  245. package/src/server/__tests__/skill-tool-name.test.ts +23 -23
  246. package/src/server/__tests__/token-tracker.test.ts +632 -0
  247. package/src/server/__tests__/tool-loop-detection.test.ts +276 -276
  248. package/src/server/__tests__/tracing-retention-policy.test.ts +30 -0
  249. package/src/server/__tests__/usage-ledger.integration.test.ts +187 -0
  250. package/src/server/collections/agent-auto-approval-checkpoints.ts +18 -0
  251. package/src/server/collections/agent-execution-spans.ts +386 -245
  252. package/src/server/collections/agent-governance-audit-events.ts +19 -0
  253. package/src/server/collections/agent-governance-policies.ts +19 -0
  254. package/src/server/collections/agent-governance-policy-versions.ts +20 -0
  255. package/src/server/collections/agent-governance-prompt-bindings.ts +22 -0
  256. package/src/server/collections/agent-hierarchy-invocations.ts +30 -0
  257. package/src/server/collections/agent-loop-action-approvals.ts +39 -39
  258. package/src/server/collections/agent-loop-runs.ts +389 -369
  259. package/src/server/collections/agent-loop-steps.ts +220 -220
  260. package/src/server/collections/agent-memory-contexts.ts +95 -95
  261. package/src/server/collections/agent-routing-graph-locks.ts +11 -0
  262. package/src/server/collections/agent-session-auto-approvals.ts +16 -0
  263. package/src/server/collections/orchestrator-config.ts +113 -87
  264. package/src/server/collections/orchestrator-logs.ts +116 -116
  265. package/src/server/collections/skill-definitions.ts +159 -159
  266. package/src/server/collections/skill-executions.ts +154 -154
  267. package/src/server/collections/skill-loop-configs.ts +65 -65
  268. package/src/server/collections/skill-metrics.ts +36 -36
  269. package/src/server/collections/skill-registry-installations.ts +41 -41
  270. package/src/server/collections/skill-worker-configs.ts +86 -86
  271. package/src/server/index.ts +1 -1
  272. package/src/server/migrations/20260423000000-add-progress-fields.ts +50 -50
  273. package/src/server/migrations/20260425000000-add-interaction-schema.ts +37 -37
  274. package/src/server/migrations/20260427000000-add-tracing-detail-fields.ts +41 -41
  275. package/src/server/migrations/20260427000001-change-other-json-to-text.ts +61 -61
  276. package/src/server/migrations/20260524001000-add-plan-approval-and-harness-profiles.ts +145 -145
  277. package/src/server/migrations/20260601000000-add-token-fields.ts +89 -89
  278. package/src/server/migrations/20260615000000-normalize-ai-employee-tool-bindings.ts +39 -39
  279. package/src/server/migrations/20260621000000-native-policy-profile-defaults.ts +190 -190
  280. package/src/server/migrations/20260727000000-remove-unused-knowledge-scopes.ts +25 -25
  281. package/src/server/migrations/20260727010000-backfill-skill-tool-names.ts +45 -45
  282. package/src/server/migrations/20261110000000-add-usage-pricing-snapshots.ts +110 -0
  283. package/src/server/migrations/20261110010000-add-usage-department-attribution.ts +28 -0
  284. package/src/server/migrations/20261119000000-widen-native-employee-identifiers.ts +37 -0
  285. package/src/server/plugin.ts +724 -573
  286. package/src/server/resources/agent-auto-approval.ts +51 -0
  287. package/src/server/resources/agent-governance.ts +161 -0
  288. package/src/server/resources/agent-harness-profile.ts +103 -94
  289. package/src/server/resources/agent-knowledge-insights.ts +306 -306
  290. package/src/server/resources/agent-loop-approval.ts +84 -84
  291. package/src/server/resources/agent-loop-events-stream.ts +108 -108
  292. package/src/server/resources/agent-loop.ts +252 -252
  293. package/src/server/resources/agent-monitor.ts +208 -482
  294. package/src/server/resources/agent-usage.ts +413 -0
  295. package/src/server/resources/hierarchical-routing.ts +39 -0
  296. package/src/server/resources/native-monitor-format.ts +150 -0
  297. package/src/server/resources/tracing.ts +296 -267
  298. package/src/server/services/AgentExecutionContext.ts +23 -23
  299. package/src/server/services/AgentGovernanceService.ts +541 -0
  300. package/src/server/services/AgentMemoryContextService.ts +344 -344
  301. package/src/server/services/AgentRegistryService.ts +220 -220
  302. package/src/server/services/AgentRuntimeLifecycle.ts +64 -64
  303. package/src/server/services/AutoApprovalCheckpoint.ts +140 -0
  304. package/src/server/services/CodeValidator.ts +257 -238
  305. package/src/server/services/DepartmentAttribution.ts +47 -0
  306. package/src/server/services/DurableCircuitBreakerService.ts +235 -235
  307. package/src/server/services/ExecutionSpanService.ts +271 -146
  308. package/src/server/services/FileManager.ts +159 -159
  309. package/src/server/services/GovernanceAdmission.ts +314 -0
  310. package/src/server/services/HarnessCapabilities.ts +112 -0
  311. package/src/server/services/HarnessCompiler.ts +182 -170
  312. package/src/server/services/HarnessProfileService.ts +235 -235
  313. package/src/server/services/HarnessSchema.ts +224 -194
  314. package/src/server/services/HierarchicalAgentRuntime.ts +1052 -0
  315. package/src/server/services/HierarchyEnrollmentGuard.ts +211 -0
  316. package/src/server/services/HierarchyInvocationJournal.ts +172 -0
  317. package/src/server/services/HierarchyRequestCancellation.ts +132 -0
  318. package/src/server/services/InputSchemaValidator.ts +44 -44
  319. package/src/server/services/LoopBudgetService.ts +325 -271
  320. package/src/server/services/LoopControlService.ts +120 -120
  321. package/src/server/services/LoopPatternSchema.ts +231 -231
  322. package/src/server/services/LoopPatternService.ts +171 -171
  323. package/src/server/services/LoopRunRepository.ts +343 -332
  324. package/src/server/services/LoopRunStateMachine.ts +538 -525
  325. package/src/server/services/LoopSchedulerService.ts +195 -195
  326. package/src/server/services/LoopTriggerService.ts +162 -159
  327. package/src/server/services/LoopWorkerService.ts +975 -912
  328. package/src/server/services/ManagedPromptProtection.ts +81 -0
  329. package/src/server/services/NativeAgentMonitorSyncService.ts +684 -0
  330. package/src/server/services/NativeSubAgentObserver.ts +324 -757
  331. package/src/server/services/NativeUsageAttribution.ts +91 -0
  332. package/src/server/services/PathLockService.ts +317 -317
  333. package/src/server/services/PluginAiRuntimeAdapter.ts +518 -387
  334. package/src/server/services/RoutingBindingRepository.ts +146 -0
  335. package/src/server/services/RoutingBindingValidation.ts +161 -0
  336. package/src/server/services/RunEventBus.ts +58 -58
  337. package/src/server/services/SandboxRunner.ts +526 -492
  338. package/src/server/services/SessionAutoApproval.ts +167 -0
  339. package/src/server/services/SkillAccessService.ts +175 -175
  340. package/src/server/services/SkillManager.ts +585 -585
  341. package/src/server/services/SkillRepositoryService.ts +236 -236
  342. package/src/server/services/TokenTracker.ts +1151 -287
  343. package/src/server/services/ToolLoopDetectionService.ts +210 -210
  344. package/src/server/services/TracingRetentionPolicy.ts +49 -0
  345. package/src/server/services/VerificationSchema.ts +31 -31
  346. package/src/server/services/VerificationService.ts +325 -313
  347. package/src/server/services/WorkerEnvManager.ts +198 -198
  348. package/src/server/services/__tests__/SkillRepositoryService.test.ts +33 -33
  349. package/src/server/services/harness-runtime-policy.ts +134 -134
  350. package/src/server/services/pythonGuardTemplate.ts +87 -87
  351. package/src/server/services/sandboxCapabilities.ts +348 -348
  352. package/src/server/skill-hub/actions/__tests__/git-import.test.ts +563 -563
  353. package/src/server/skill-hub/actions/git-import.ts +936 -936
  354. package/src/server/skill-hub/mcp/McpController.ts +107 -107
  355. package/src/server/skill-hub/middlewares/git-import-request-method-policy.ts +51 -51
  356. package/src/server/skill-hub/plugin.ts +1272 -1232
  357. package/src/server/skill-hub/sandbox-config.json +6 -6
  358. package/src/server/skill-hub/services/RegistrySkillInstallationService.ts +291 -281
  359. package/src/server/skill-hub/services/__tests__/RegistrySkillInstallationService.test.ts +295 -295
  360. package/src/server/skill-hub/services/registry-node-package.ts +191 -0
  361. package/src/server/skill-hub/tasks/SkillExecutionTask.ts +597 -568
  362. package/src/server/skill-hub/utils/json-fields.ts +57 -57
  363. package/src/server/tools/delegate-task.ts +30 -30
  364. package/src/server/tools/external-rag-search.ts +329 -329
  365. package/src/server/tools/skill-execute.ts +226 -216
  366. package/src/server/types.ts +21 -21
  367. package/src/server/utils/ai-manager.ts +24 -24
  368. package/src/server/utils/ctx-utils.ts +132 -132
  369. package/src/server/utils/ensure-indexes.ts +113 -96
  370. package/src/server/utils/ha-lock.ts +80 -80
  371. package/src/server/utils/loop-pattern-context.ts +84 -84
  372. package/src/server/utils/record-utils.ts +19 -19
  373. package/src/server/utils/skill-settings.ts +135 -135
  374. package/src/server/utils/skill-tool-name.ts +58 -58
  375. package/dist/client-v2/117.7565cff57c39318a.js +0 -10
  376. package/dist/client-v2/214.106635011859dede.js +0 -10
  377. package/dist/client-v2/253.59577b40d9875be0.js +0 -10
  378. package/dist/client-v2/264.7ed8bee71fa5935c.js +0 -10
  379. package/dist/client-v2/418.41ed200e7d6da332.js +0 -10
  380. package/dist/client-v2/794.a67a2614405ba627.js +0 -10
  381. package/dist/client-v2/981.e4a1f41cfc94a856.js +0 -10
  382. package/dist/client-v2/993.b0688fdc5ccb000a.js +0 -10
  383. package/dist/node_modules/simple-git/dist/cjs/index.js +0 -7399
  384. package/dist/node_modules/simple-git/dist/esm/index.js +0 -4745
  385. package/dist/node_modules/simple-git/dist/esm/package.json +0 -3
  386. package/dist/node_modules/simple-git/dist/src/lib/api.d.ts +0 -13
  387. package/dist/node_modules/simple-git/dist/src/lib/args/log-format.d.ts +0 -9
  388. package/dist/node_modules/simple-git/dist/src/lib/errors/git-construct-error.d.ts +0 -15
  389. package/dist/node_modules/simple-git/dist/src/lib/errors/git-error.d.ts +0 -30
  390. package/dist/node_modules/simple-git/dist/src/lib/errors/git-plugin-error.d.ts +0 -7
  391. package/dist/node_modules/simple-git/dist/src/lib/errors/git-response-error.d.ts +0 -32
  392. package/dist/node_modules/simple-git/dist/src/lib/errors/task-configuration-error.d.ts +0 -12
  393. package/dist/node_modules/simple-git/dist/src/lib/git-factory.d.ts +0 -15
  394. package/dist/node_modules/simple-git/dist/src/lib/git-logger.d.ts +0 -21
  395. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-branch-delete.d.ts +0 -5
  396. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-branch.d.ts +0 -2
  397. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-commit.d.ts +0 -2
  398. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-diff-summary.d.ts +0 -3
  399. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-fetch.d.ts +0 -2
  400. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-list-log-summary.d.ts +0 -6
  401. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-merge.d.ts +0 -11
  402. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-move.d.ts +0 -2
  403. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-pull.d.ts +0 -6
  404. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-push.d.ts +0 -4
  405. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-remote-messages.d.ts +0 -5
  406. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-remote-objects.d.ts +0 -3
  407. package/dist/node_modules/simple-git/dist/src/lib/plugins/abort-plugin.d.ts +0 -3
  408. package/dist/node_modules/simple-git/dist/src/lib/plugins/block-unsafe-operations-plugin.d.ts +0 -3
  409. package/dist/node_modules/simple-git/dist/src/lib/plugins/command-config-prefixing-plugin.d.ts +0 -2
  410. package/dist/node_modules/simple-git/dist/src/lib/plugins/completion-detection.plugin.d.ts +0 -3
  411. package/dist/node_modules/simple-git/dist/src/lib/plugins/custom-binary.plugin.d.ts +0 -3
  412. package/dist/node_modules/simple-git/dist/src/lib/plugins/error-detection.plugin.d.ts +0 -7
  413. package/dist/node_modules/simple-git/dist/src/lib/plugins/index.d.ts +0 -11
  414. package/dist/node_modules/simple-git/dist/src/lib/plugins/plugin-store.d.ts +0 -11
  415. package/dist/node_modules/simple-git/dist/src/lib/plugins/progress-monitor-plugin.d.ts +0 -3
  416. package/dist/node_modules/simple-git/dist/src/lib/plugins/simple-git-plugin.d.ts +0 -48
  417. package/dist/node_modules/simple-git/dist/src/lib/plugins/spawn-options-plugin.d.ts +0 -3
  418. package/dist/node_modules/simple-git/dist/src/lib/plugins/suffix-paths.plugin.d.ts +0 -2
  419. package/dist/node_modules/simple-git/dist/src/lib/plugins/timout-plugin.d.ts +0 -3
  420. package/dist/node_modules/simple-git/dist/src/lib/responses/BranchDeleteSummary.d.ts +0 -12
  421. package/dist/node_modules/simple-git/dist/src/lib/responses/BranchSummary.d.ts +0 -14
  422. package/dist/node_modules/simple-git/dist/src/lib/responses/CheckIgnore.d.ts +0 -4
  423. package/dist/node_modules/simple-git/dist/src/lib/responses/CleanSummary.d.ts +0 -9
  424. package/dist/node_modules/simple-git/dist/src/lib/responses/ConfigList.d.ts +0 -13
  425. package/dist/node_modules/simple-git/dist/src/lib/responses/DiffSummary.d.ts +0 -10
  426. package/dist/node_modules/simple-git/dist/src/lib/responses/FileStatusSummary.d.ts +0 -9
  427. package/dist/node_modules/simple-git/dist/src/lib/responses/GetRemoteSummary.d.ts +0 -11
  428. package/dist/node_modules/simple-git/dist/src/lib/responses/InitSummary.d.ts +0 -9
  429. package/dist/node_modules/simple-git/dist/src/lib/responses/MergeSummary.d.ts +0 -16
  430. package/dist/node_modules/simple-git/dist/src/lib/responses/PullSummary.d.ts +0 -25
  431. package/dist/node_modules/simple-git/dist/src/lib/responses/StatusSummary.d.ts +0 -19
  432. package/dist/node_modules/simple-git/dist/src/lib/responses/TagList.d.ts +0 -7
  433. package/dist/node_modules/simple-git/dist/src/lib/runners/git-executor-chain.d.ts +0 -25
  434. package/dist/node_modules/simple-git/dist/src/lib/runners/git-executor.d.ts +0 -14
  435. package/dist/node_modules/simple-git/dist/src/lib/runners/promise-wrapped.d.ts +0 -2
  436. package/dist/node_modules/simple-git/dist/src/lib/runners/scheduler.d.ts +0 -11
  437. package/dist/node_modules/simple-git/dist/src/lib/runners/tasks-pending-queue.d.ts +0 -23
  438. package/dist/node_modules/simple-git/dist/src/lib/simple-git-api.d.ts +0 -20
  439. package/dist/node_modules/simple-git/dist/src/lib/task-callback.d.ts +0 -2
  440. package/dist/node_modules/simple-git/dist/src/lib/tasks/apply-patch.d.ts +0 -3
  441. package/dist/node_modules/simple-git/dist/src/lib/tasks/branch.d.ts +0 -7
  442. package/dist/node_modules/simple-git/dist/src/lib/tasks/change-working-directory.d.ts +0 -2
  443. package/dist/node_modules/simple-git/dist/src/lib/tasks/check-ignore.d.ts +0 -2
  444. package/dist/node_modules/simple-git/dist/src/lib/tasks/check-is-repo.d.ts +0 -9
  445. package/dist/node_modules/simple-git/dist/src/lib/tasks/checkout.d.ts +0 -2
  446. package/dist/node_modules/simple-git/dist/src/lib/tasks/clean.d.ts +0 -25
  447. package/dist/node_modules/simple-git/dist/src/lib/tasks/clone.d.ts +0 -9
  448. package/dist/node_modules/simple-git/dist/src/lib/tasks/commit.d.ts +0 -4
  449. package/dist/node_modules/simple-git/dist/src/lib/tasks/config.d.ts +0 -8
  450. package/dist/node_modules/simple-git/dist/src/lib/tasks/count-objects.d.ts +0 -12
  451. package/dist/node_modules/simple-git/dist/src/lib/tasks/diff-name-status.d.ts +0 -12
  452. package/dist/node_modules/simple-git/dist/src/lib/tasks/diff.d.ts +0 -5
  453. package/dist/node_modules/simple-git/dist/src/lib/tasks/fetch.d.ts +0 -4
  454. package/dist/node_modules/simple-git/dist/src/lib/tasks/first-commit.d.ts +0 -2
  455. package/dist/node_modules/simple-git/dist/src/lib/tasks/grep.d.ts +0 -12
  456. package/dist/node_modules/simple-git/dist/src/lib/tasks/hash-object.d.ts +0 -5
  457. package/dist/node_modules/simple-git/dist/src/lib/tasks/init.d.ts +0 -3
  458. package/dist/node_modules/simple-git/dist/src/lib/tasks/log.d.ts +0 -32
  459. package/dist/node_modules/simple-git/dist/src/lib/tasks/merge.d.ts +0 -4
  460. package/dist/node_modules/simple-git/dist/src/lib/tasks/move.d.ts +0 -3
  461. package/dist/node_modules/simple-git/dist/src/lib/tasks/pull.d.ts +0 -3
  462. package/dist/node_modules/simple-git/dist/src/lib/tasks/push.d.ts +0 -9
  463. package/dist/node_modules/simple-git/dist/src/lib/tasks/remote.d.ts +0 -8
  464. package/dist/node_modules/simple-git/dist/src/lib/tasks/reset.d.ts +0 -11
  465. package/dist/node_modules/simple-git/dist/src/lib/tasks/show.d.ts +0 -2
  466. package/dist/node_modules/simple-git/dist/src/lib/tasks/stash-list.d.ts +0 -4
  467. package/dist/node_modules/simple-git/dist/src/lib/tasks/status.d.ts +0 -3
  468. package/dist/node_modules/simple-git/dist/src/lib/tasks/sub-module.d.ts +0 -5
  469. package/dist/node_modules/simple-git/dist/src/lib/tasks/tag.d.ts +0 -18
  470. package/dist/node_modules/simple-git/dist/src/lib/tasks/task.d.ts +0 -14
  471. package/dist/node_modules/simple-git/dist/src/lib/tasks/version.d.ts +0 -9
  472. package/dist/node_modules/simple-git/dist/src/lib/types/handlers.d.ts +0 -21
  473. package/dist/node_modules/simple-git/dist/src/lib/types/index.d.ts +0 -136
  474. package/dist/node_modules/simple-git/dist/src/lib/types/tasks.d.ts +0 -19
  475. package/dist/node_modules/simple-git/dist/src/lib/utils/argument-filters.d.ts +0 -14
  476. package/dist/node_modules/simple-git/dist/src/lib/utils/exit-codes.d.ts +0 -10
  477. package/dist/node_modules/simple-git/dist/src/lib/utils/git-output-streams.d.ts +0 -7
  478. package/dist/node_modules/simple-git/dist/src/lib/utils/index.d.ts +0 -8
  479. package/dist/node_modules/simple-git/dist/src/lib/utils/line-parser.d.ts +0 -15
  480. package/dist/node_modules/simple-git/dist/src/lib/utils/simple-git-options.d.ts +0 -2
  481. package/dist/node_modules/simple-git/dist/src/lib/utils/task-options.d.ts +0 -13
  482. package/dist/node_modules/simple-git/dist/src/lib/utils/task-parser.d.ts +0 -5
  483. package/dist/node_modules/simple-git/dist/src/lib/utils/util.d.ts +0 -47
  484. package/dist/node_modules/simple-git/dist/typings/errors.d.ts +0 -5
  485. package/dist/node_modules/simple-git/dist/typings/index.d.ts +0 -14
  486. package/dist/node_modules/simple-git/dist/typings/response.d.ts +0 -556
  487. package/dist/node_modules/simple-git/dist/typings/simple-git.d.ts +0 -1033
  488. package/dist/node_modules/simple-git/dist/typings/types.d.ts +0 -22
  489. package/dist/node_modules/simple-git/node_modules/debug/package.json +0 -64
  490. package/dist/node_modules/simple-git/node_modules/debug/src/browser.js +0 -272
  491. package/dist/node_modules/simple-git/node_modules/debug/src/common.js +0 -292
  492. package/dist/node_modules/simple-git/node_modules/debug/src/index.js +0 -10
  493. package/dist/node_modules/simple-git/node_modules/debug/src/node.js +0 -263
  494. package/dist/node_modules/simple-git/package.json +0 -1
  495. package/dist/node_modules/simple-git/promise.js +0 -17
@@ -1,573 +1,724 @@
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
+ // SPDX-License-Identifier: Apache-2.0
2
+
3
+ import { Plugin } from '@nocobase/server';
4
+ import type { Context } from '@nocobase/actions';
5
+ import path from 'path';
6
+ import { createExternalRagSearchTool } from './tools/external-rag-search';
7
+ import { registerTracingResource } from './resources/tracing';
8
+ import { registerAgentMonitorResource } from './resources/agent-monitor';
9
+ import { registerAgentLoopResource } from './resources/agent-loop';
10
+ import { registerAgentLoopApprovalResource } from './resources/agent-loop-approval';
11
+ import { registerAgentHarnessProfileResource } from './resources/agent-harness-profile';
12
+ import { registerAgentLoopArtifactResource } from './resources/agent-loop-artifact';
13
+ import { registerAgentLoopEventsStreamResource } from './resources/agent-loop-events-stream';
14
+ import { registerAgentKnowledgeInsightsResource } from './resources/agent-knowledge-insights';
15
+ import { registerAgentGovernanceResource } from './resources/agent-governance';
16
+ import { registerAgentUsageResource } from './resources/agent-usage';
17
+ import { registerHierarchicalRoutingResource } from './resources/hierarchical-routing';
18
+ import { registerAgentAutoApprovalResource } from './resources/agent-auto-approval';
19
+ import { guardAutoApprovalDecision } from './services/SessionAutoApproval';
20
+ import SkillHubSubFeature from './skill-hub/plugin';
21
+ import { NativeSubAgentObserver } from './services/NativeSubAgentObserver';
22
+ import { NativeAgentMonitorSyncService } from './services/NativeAgentMonitorSyncService';
23
+ import { RegistrySkillSnapshotService } from './skill-hub/services/RegistrySkillSnapshotService';
24
+ import { RegistrySkillInstallationService } from './skill-hub/services/RegistrySkillInstallationService';
25
+ import { LoopPatternService } from './services/LoopPatternService';
26
+ import { LoopSchedulerService } from './services/LoopSchedulerService';
27
+ import { LoopTriggerService } from './services/LoopTriggerService';
28
+ import { LoopWorkerService } from './services/LoopWorkerService';
29
+ import { asObject, isAdminUser, currentUserId } from './utils/ctx-utils';
30
+ import { employeeHarnessResolver, worktreeCapability } from './utils/loop-pattern-context';
31
+ import { getAIToolsManager } from './utils/ai-manager';
32
+ import { AgentRuntimeLifecycle } from './services/AgentRuntimeLifecycle';
33
+ import { validateInputSchemaDefinition } from './services/InputSchemaValidator';
34
+ import { assertSkillToolNameAvailable, buildSkillToolName, getSkillToolName } from './utils/skill-tool-name';
35
+ import { ensureAgentOrchestratorIndexes } from './utils/ensure-indexes';
36
+ import { resetRunEventBus } from './services/RunEventBus';
37
+ import { resolveTracingRetentionDays } from './services/TracingRetentionPolicy';
38
+ import { createGovernanceAdmission } from './services/GovernanceAdmission';
39
+ import { installManagedPromptProtection, ManagedPromptError } from './services/ManagedPromptProtection';
40
+ import { installNativeUsageAttribution } from './services/NativeUsageAttribution';
41
+ import { createHierarchicalAgentTools } from './services/HierarchicalAgentRuntime';
42
+ import { validateRoutingBindingAction } from './services/RoutingBindingValidation';
43
+ import { initializeRoutingGraphLock, RoutingBindingRepository } from './services/RoutingBindingRepository';
44
+ import { guardHierarchyEnrollment, guardManagedChildActions } from './services/HierarchyEnrollmentGuard';
45
+ import { HierarchyRequestCancellation } from './services/HierarchyRequestCancellation';
46
+
47
+ function normalizeOptionalString(value: unknown) {
48
+ return typeof value === 'string' ? value.trim() : '';
49
+ }
50
+
51
+ function readModelValue(record: unknown, key: string) {
52
+ const model = record as { get?: (name: string) => unknown; [key: string]: unknown };
53
+ return typeof model?.get === 'function' ? model.get(key) : model?.[key];
54
+ }
55
+
56
+ const PRIVATE_SKILL_FIELDS = ['codeTemplate', 'instructions', 'storageUrl', 'packages', 'fileId'] as const;
57
+
58
+ function redactSkillRecord(record: unknown): unknown {
59
+ if (!record || typeof record !== 'object') return record;
60
+ const source =
61
+ (record as { toJSON?: () => Record<string, unknown> }).toJSON?.() || (record as Record<string, unknown>);
62
+ const result = { ...source };
63
+ for (const field of PRIVATE_SKILL_FIELDS) {
64
+ delete result[field];
65
+ }
66
+ return result;
67
+ }
68
+
69
+ function redactSkillResponse(body: unknown): unknown {
70
+ if (Array.isArray(body)) return body.map(redactSkillRecord);
71
+ if (!body || typeof body !== 'object') return body;
72
+
73
+ const value = body as Record<string, unknown>;
74
+ if (Array.isArray(value.rows)) return { ...value, rows: value.rows.map(redactSkillRecord) };
75
+ if (Object.prototype.hasOwnProperty.call(value, 'data')) {
76
+ return {
77
+ ...value,
78
+ data: Array.isArray(value.data) ? value.data.map(redactSkillRecord) : redactSkillRecord(value.data),
79
+ };
80
+ }
81
+ return redactSkillRecord(value);
82
+ }
83
+
84
+ function buildAgentMemoryContextKey(values: { scope: string; userId?: unknown; aiEmployeeUsername?: string }) {
85
+ const userPart = values.scope === 'public' ? 'public' : String(values.userId || '');
86
+ const agentPart = values.aiEmployeeUsername || '*';
87
+ return `${values.scope}:${userPart}:${agentPart}`;
88
+ }
89
+
90
+ async function validateAgentMemoryContextValues(ctx: any) {
91
+ const actionName = ctx.action?.actionName;
92
+ const values = ctx.action?.params?.values || {};
93
+ let nextValues = values;
94
+ let currentId = ctx.action?.params?.filterByTk;
95
+
96
+ if (actionName === 'update' && ctx.action?.params?.filterByTk) {
97
+ const existing = await ctx.db.getRepository('agentMemoryContexts').findOne({
98
+ filter: { id: ctx.action.params.filterByTk },
99
+ });
100
+ currentId = readModelValue(existing, 'id') || currentId;
101
+ nextValues = {
102
+ ...(existing?.toJSON?.() || existing || {}),
103
+ ...values,
104
+ };
105
+ }
106
+
107
+ const scope = normalizeOptionalString(nextValues.scope);
108
+ const userId = nextValues.userId;
109
+ const aiEmployeeUsername = normalizeOptionalString(nextValues.aiEmployeeUsername);
110
+
111
+ if (!['public', 'user', 'agent_user'].includes(scope)) {
112
+ ctx.throw(400, 'scope must be one of: public, user, agent_user.');
113
+ return;
114
+ }
115
+
116
+ if (scope === 'public' && userId != null && userId !== '') {
117
+ ctx.throw(400, 'scope="public" requires userId to be empty.');
118
+ return;
119
+ }
120
+
121
+ if ((scope === 'user' || scope === 'agent_user') && (userId == null || userId === '')) {
122
+ ctx.throw(400, `scope="${scope}" requires userId.`);
123
+ return;
124
+ }
125
+
126
+ if (scope === 'agent_user' && !aiEmployeeUsername) {
127
+ ctx.throw(400, 'scope="agent_user" requires aiEmployeeUsername.');
128
+ return;
129
+ }
130
+
131
+ const normalizedValues = {
132
+ ...values,
133
+ scope,
134
+ userId: scope === 'public' ? null : userId,
135
+ aiEmployeeUsername,
136
+ contextKey: buildAgentMemoryContextKey({
137
+ scope,
138
+ userId: scope === 'public' ? null : userId,
139
+ aiEmployeeUsername,
140
+ }),
141
+ };
142
+
143
+ const repo = ctx.db.getRepository('agentMemoryContexts');
144
+ const duplicate =
145
+ (await repo.findOne({
146
+ filter: { contextKey: normalizedValues.contextKey },
147
+ })) ||
148
+ (await repo.findOne({
149
+ filter: {
150
+ scope,
151
+ userId: normalizedValues.userId,
152
+ aiEmployeeUsername,
153
+ },
154
+ }));
155
+ const duplicateId = readModelValue(duplicate, 'id');
156
+ if (duplicateId && String(duplicateId) !== String(currentId || '')) {
157
+ ctx.throw(400, 'An agent memory context already exists for this scope, user, and AI employee.');
158
+ return;
159
+ }
160
+
161
+ ctx.action.params.values = normalizedValues;
162
+ }
163
+
164
+ export class PluginAgentOrchestratorServer extends Plugin {
165
+ private readonly hierarchyCancellation = new HierarchyRequestCancellation(this);
166
+ skillHub: SkillHubSubFeature;
167
+ registrySkillSnapshotService: RegistrySkillSnapshotService;
168
+ registrySkillInstallationService: RegistrySkillInstallationService;
169
+ nativeObserver: NativeSubAgentObserver;
170
+ agentRuntimeLifecycle: AgentRuntimeLifecycle;
171
+ private nativeMonitorSyncService!: NativeAgentMonitorSyncService;
172
+ private removeNativeMonitorHook?: () => void;
173
+ private removeManagedPromptProtection?: () => void;
174
+ private removeNativeUsageAttribution?: () => void;
175
+ private governanceEnabled = true;
176
+ loopScheduler: LoopSchedulerService;
177
+ loopWorker: LoopWorkerService;
178
+ private readonly installNativeObserver = () => {
179
+ this.nativeObserver?.install();
180
+ };
181
+
182
+ async afterAdd() {
183
+ this.skillHub = new SkillHubSubFeature(this);
184
+ this.registrySkillSnapshotService = new RegistrySkillSnapshotService(this.db);
185
+ this.registrySkillInstallationService = new RegistrySkillInstallationService(this.db, () =>
186
+ this.skillHub.getSkillRepositoryService(),
187
+ );
188
+ this.nativeObserver = new NativeSubAgentObserver(this);
189
+ this.agentRuntimeLifecycle = new AgentRuntimeLifecycle((hookType, name, error) => {
190
+ this.app.logger.warn(`[AgentOrchestrator] ${hookType} hook "${name}" failed; continuing agent execution.`, {
191
+ error,
192
+ });
193
+ });
194
+ this.nativeMonitorSyncService = new NativeAgentMonitorSyncService(this);
195
+ this.installNativeMonitorHook();
196
+ (this.app as typeof this.app & { agentRuntimeLifecycle: AgentRuntimeLifecycle }).agentRuntimeLifecycle =
197
+ this.agentRuntimeLifecycle;
198
+ }
199
+
200
+ async beforeLoad() {
201
+ this.db.registerRepositories({ RoutingBindingRepository });
202
+ // Import collection definitions
203
+ this.db.import({ directory: path.resolve(__dirname, 'collections') });
204
+
205
+ this.db.addMigrations({
206
+ namespace: this.name,
207
+ directory: path.resolve(__dirname, 'migrations'),
208
+ context: { plugin: this },
209
+ });
210
+ }
211
+
212
+ async load() {
213
+ await this.skillHub.load();
214
+
215
+ // --- ACL ---
216
+ this.app.acl.registerSnippet({
217
+ name: `pm.${this.name}`,
218
+ actions: [
219
+ 'orchestratorConfig:*',
220
+ 'orchestratorTracing:*',
221
+ 'agentMonitor:*',
222
+ 'agentUsage:*',
223
+ 'agentGovernance:*',
224
+ 'agentHierarchy:*',
225
+ 'agentKnowledgeInsights:*',
226
+ 'agentMemoryContexts:*',
227
+ 'agentLoopRuns:*',
228
+ 'agentLoopSteps:*',
229
+ 'agentLoopEvents:*',
230
+ 'agentHarnessProfiles:*',
231
+ 'agentExecutionSpans:*',
232
+ 'skillDefinitions:*',
233
+ 'skillExecutions:*',
234
+ 'skillLoopConfigs:*',
235
+ 'skillHub:*',
236
+ 'skillWorkerConfigs:*',
237
+ ],
238
+ });
239
+
240
+ // Allow any logged-in user to read available skills and loop configs.
241
+ // This mirrors the plugin-ai pattern (acl.allow with 'loggedIn')
242
+ // so that non-admin users with AI roles can use skills without
243
+ // requiring manual snippet assignment per role.
244
+ // Create/update/destroy remain restricted to admin roles via the snippet above.
245
+ this.app.acl.allow('skillDefinitions', 'list', 'loggedIn');
246
+ this.app.acl.allow('skillDefinitions', 'get', 'loggedIn');
247
+ this.app.acl.allow('skillLoopConfigs', 'list', 'loggedIn');
248
+ this.app.acl.allow('skillLoopConfigs', 'get', 'loggedIn');
249
+ this.app.acl.allow('skillExecutions', 'list', 'loggedIn');
250
+ this.app.acl.allow('skillExecutions', 'get', 'loggedIn');
251
+ this.app.acl.allow('skillHub', 'download', 'loggedIn');
252
+ this.app.acl.allow('skillHub', 'listTemplates', 'loggedIn');
253
+ this.app.acl.allow('agentMonitor', ['list', 'get'], 'loggedIn');
254
+ // ACL runs before the resource handler, so every owner-facing loop action must be listed
255
+ // here; ownership itself is enforced inside each handler by LoopRunRepository.
256
+ this.app.acl.allow(
257
+ 'agentLoops',
258
+ ['list', 'get', 'runNow', 'pause', 'resume', 'cancel', 'retry', 'escalate', 'acceptResult', 'status'],
259
+ 'loggedIn',
260
+ );
261
+ this.app.acl.allow('agentLoopApprovals', ['list', 'get', 'decide'], 'loggedIn');
262
+ this.app.acl.allow('agentLoopArtifactsView', ['list', 'get'], 'loggedIn');
263
+ this.app.acl.allow('agentLoopEventsStream', ['stream'], 'loggedIn');
264
+ this.app.acl.allow('agentAutoApproval', ['get', 'set', 'eligible'], 'loggedIn');
265
+
266
+ this.installGovernanceHooks();
267
+ this.app.resourceManager.use(
268
+ async (ctx, next) => {
269
+ if (
270
+ [
271
+ 'agentHierarchyInvocations',
272
+ 'agentSessionAutoApprovals',
273
+ 'agentAutoApprovalCheckpoints',
274
+ 'agentRoutingGraphLocks',
275
+ ].includes(ctx.action?.resourceName ?? '')
276
+ ) {
277
+ return ctx.throw(403, ctx.t('Hierarchy invocation records are not directly accessible.'));
278
+ }
279
+ return next();
280
+ },
281
+ { tag: 'orchestrator-hierarchy-record-protection', after: 'acl' },
282
+ );
283
+ this.app.resourceManager.use(
284
+ async (ctx, next) => {
285
+ const { resourceName, actionName } = ctx.action || {};
286
+ if (
287
+ this.governanceEnabled &&
288
+ typeof resourceName === 'string' &&
289
+ [
290
+ 'agentGovernancePolicies',
291
+ 'agentGovernancePolicyVersions',
292
+ 'agentGovernancePromptBindings',
293
+ 'agentGovernanceAuditEvents',
294
+ ].includes(resourceName) &&
295
+ actionName
296
+ ) {
297
+ return ctx.throw(403, ctx.t('Governance records are only available through governance actions.'));
298
+ }
299
+ try {
300
+ await next();
301
+ } catch (error) {
302
+ if (error instanceof ManagedPromptError) return ctx.throw(403, ctx.t(error.message));
303
+ throw error;
304
+ }
305
+ },
306
+ { tag: 'orchestrator-governance-record-protection', after: 'acl' },
307
+ );
308
+ const governanceAdmission = createGovernanceAdmission(this, () => this.governanceEnabled);
309
+ this.app.resourceManager.use(async (ctx, next) => governanceAdmission(ctx as Context, next), {
310
+ tag: 'orchestrator-governance-admission',
311
+ after: 'acl',
312
+ });
313
+
314
+ this.app.resourceManager.use(async (ctx, next) => validateRoutingBindingAction(ctx as Context, next), {
315
+ tag: 'orchestrator-routing-binding-validation',
316
+ after: 'acl',
317
+ });
318
+ this.app.resourceManager.use(async (ctx, next) => guardHierarchyEnrollment(ctx as Context, next), {
319
+ tag: 'orchestrator-hierarchy-enrollment',
320
+ after: 'acl',
321
+ });
322
+ this.app.resourceManager.use(async (ctx, next) => guardManagedChildActions(ctx as Context, next), {
323
+ tag: 'orchestrator-hierarchy-child-protection',
324
+ after: 'orchestrator-hierarchy-enrollment',
325
+ });
326
+ this.app.resourceManager.use(async (ctx, next) => guardAutoApprovalDecision(ctx as Context, next), {
327
+ tag: 'orchestrator-auto-approval-decision',
328
+ after: 'orchestrator-hierarchy-child-protection',
329
+ });
330
+ this.app.resourceManager.use(async (ctx, next) => this.hierarchyCancellation.middleware(ctx as Context, next), {
331
+ tag: 'orchestrator-hierarchy-cancellation',
332
+ after: 'orchestrator-hierarchy-child-protection',
333
+ });
334
+
335
+ // Data scoping for skillExecutions: a logged-in non-admin user may only
336
+ // read their own executions. Rows hold inputArgs / stdout / output files,
337
+ // so an unscoped list/get would leak one user's data to another. Admins
338
+ // (root/admin roles) keep full visibility. This mirrors the owner/admin
339
+ // check enforced by skillHub:download.
340
+ this.app.resourceManager.use(
341
+ async (ctx, next) => {
342
+ const { resourceName, actionName } = ctx.action || {};
343
+ if (resourceName === 'skillExecutions' && (actionName === 'list' || actionName === 'get')) {
344
+ if (!isAdminUser(ctx)) {
345
+ const userId = currentUserId(ctx);
346
+ const ownerFilter = userId ? { triggeredById: userId } : { triggeredById: null };
347
+ ctx.action.mergeParams({ filter: ownerFilter });
348
+ }
349
+ }
350
+ await next();
351
+ },
352
+ { tag: 'orchestrator-skill-executions-scope', after: 'acl' },
353
+ );
354
+
355
+ this.app.resourceManager.use(
356
+ async (ctx, next) => {
357
+ const { resourceName, actionName } = ctx.action || {};
358
+ if (resourceName !== 'skillDefinitions') {
359
+ await next();
360
+ return;
361
+ }
362
+
363
+ const values = ctx.action?.params?.values || {};
364
+ if (actionName === 'create' || actionName === 'update') {
365
+ try {
366
+ if (Object.prototype.hasOwnProperty.call(values, 'inputSchema')) {
367
+ validateInputSchemaDefinition(values.inputSchema);
368
+ }
369
+
370
+ if (actionName === 'create') {
371
+ const toolName = buildSkillToolName(values.name);
372
+ await assertSkillToolNameAvailable(ctx.db, toolName);
373
+ values.toolName = toolName;
374
+ } else {
375
+ const existing = await ctx.db.getRepository('skillDefinitions').findOne({
376
+ filterByTk: ctx.action?.params?.filterByTk,
377
+ });
378
+ if (existing) {
379
+ const stableToolName = getSkillToolName(existing);
380
+ if (values.toolName && values.toolName !== stableToolName) {
381
+ ctx.throw(400, 'toolName is immutable after a skill is created.');
382
+ return;
383
+ }
384
+ values.toolName = stableToolName;
385
+ }
386
+ }
387
+ } catch (error) {
388
+ ctx.throw(400, error instanceof Error ? error.message : String(error));
389
+ return;
390
+ }
391
+ }
392
+
393
+ if (actionName === 'destroy') {
394
+ const existing = await ctx.db.getRepository('skillDefinitions').findOne({
395
+ filterByTk: ctx.action?.params?.filterByTk,
396
+ });
397
+ if (existing) {
398
+ const toolName = getSkillToolName(existing);
399
+ const agentUsernames = await this.skillHub.skillAccessService.findAgentUsernamesUsingTool(toolName);
400
+ if (agentUsernames.length > 0) {
401
+ ctx.throw(
402
+ 409,
403
+ `Skill tool "${toolName}" is still bound to AI employees: ${agentUsernames.join(
404
+ ', ',
405
+ )}. Disable or unbind it before deletion.`,
406
+ );
407
+ return;
408
+ }
409
+ }
410
+ }
411
+
412
+ await next();
413
+
414
+ // When a skill is disabled via update, cascade-remove its tool from all AI employee
415
+ // bindings. This prevents stale bindings from allowing execution of disabled skills.
416
+ if (actionName === 'update' && values.enabled === false) {
417
+ const tk = ctx.action?.params?.filterByTk;
418
+ if (tk) {
419
+ const skillRecord = await ctx.db.getRepository('skillDefinitions').findOne({ filterByTk: tk });
420
+ if (skillRecord) {
421
+ const toolName = getSkillToolName(skillRecord);
422
+ if (toolName) {
423
+ await this.skillHub.skillAccessService.cascadeDisableSkill(toolName);
424
+ }
425
+ }
426
+ }
427
+ }
428
+
429
+ if ((actionName === 'list' || actionName === 'get') && !isAdminUser(ctx)) {
430
+ ctx.body = redactSkillResponse(ctx.body);
431
+ }
432
+ },
433
+ { tag: 'orchestrator-skill-definition-policy', after: 'acl' },
434
+ );
435
+
436
+ this.app.resourceManager.use(
437
+ async (ctx, next) => {
438
+ const { resourceName, actionName } = ctx.action || {};
439
+ if (resourceName === 'agentMemoryContexts' && (actionName === 'create' || actionName === 'update')) {
440
+ await validateAgentMemoryContextValues(ctx);
441
+ }
442
+ await next();
443
+ },
444
+ { tag: 'orchestrator-agent-memory-context-policy', after: 'acl' },
445
+ );
446
+
447
+ // --- Register External Tool Only ---
448
+ // Native @nocobase/plugin-ai owns reasoning, planning/replanning and sub-agent dispatch.
449
+ // The orchestrator no longer injects planning prompts or registers self-state AI tools; it
450
+ // drives work through the Loop Control Plane (trigger → durable run → worker → verifier).
451
+ const toolsManager = getAIToolsManager(this.app);
452
+ toolsManager.registerTools(createExternalRagSearchTool(this));
453
+ toolsManager.registerTools(createHierarchicalAgentTools(this));
454
+
455
+ // --- Loop Control Plane runtime ---
456
+ const patterns = new LoopPatternService(this.db, employeeHarnessResolver(this), async () =>
457
+ worktreeCapability(this),
458
+ );
459
+ const triggers = new LoopTriggerService(this.db, patterns, this.app.log);
460
+ this.loopScheduler = new LoopSchedulerService(this, patterns, triggers);
461
+ this.loopWorker = new LoopWorkerService(this.app, this.db);
462
+ this.loopScheduler.install();
463
+ this.app.on?.('afterStart', this.startLoopWorker);
464
+
465
+ registerAgentLoopResource(this);
466
+ registerAgentLoopApprovalResource(this);
467
+ registerAgentLoopArtifactResource(this);
468
+ registerAgentLoopEventsStreamResource(this);
469
+ registerAgentHarnessProfileResource(this);
470
+ registerAgentGovernanceResource(this);
471
+ registerHierarchicalRoutingResource(this);
472
+ registerAgentAutoApprovalResource(this);
473
+ registerAgentUsageResource(this);
474
+
475
+ // --- Native plugin-ai Monitor Resource ---
476
+ registerAgentMonitorResource(this);
477
+ registerAgentKnowledgeInsightsResource(this);
478
+ this.installNativeObserver();
479
+ this.app.on?.('afterStart', this.installNativeObserver);
480
+
481
+ // --- Register Tracing Resource (Phase 5) ---
482
+ // Custom read-only resource for the Swarm Tracing admin page.
483
+ registerTracingResource(this);
484
+
485
+ // --- Log Retention ---
486
+ // Daily prune of orchestratorLogs / agentExecutionSpans to keep tables bounded.
487
+ // Override window via env: ORCHESTRATOR_LOG_RETENTION_DAYS (default 30).
488
+ this.app.cronJobManager.addJob({
489
+ cronTime: '0 30 2 * * *',
490
+ onTick: async () => {
491
+ try {
492
+ const days = await resolveTracingRetentionDays(this);
493
+ const cutoff = new Date(Date.now() - days * 86400000);
494
+ const repo = this.db.getRepository('orchestratorLogs');
495
+ const spansRepo = this.db.getRepository('agentExecutionSpans');
496
+ const deletedLogs = repo
497
+ ? await repo.destroy({
498
+ filter: { createdAt: { $lt: cutoff.toISOString() } },
499
+ })
500
+ : 0;
501
+ const deletedSpans = spansRepo
502
+ ? await spansRepo.destroy({
503
+ // Model-call rows are the accounting ledger; trace retention must not remove
504
+ // usage needed for future totals and historical price snapshots.
505
+ filter: {
506
+ $and: [
507
+ { $or: [{ type: { $ne: 'model_call' } }, { type: null }] },
508
+ {
509
+ $or: [
510
+ { source: 'native-plugin-ai', nativeActivityAt: { $lt: cutoff.toISOString() } },
511
+ {
512
+ source: 'native-plugin-ai',
513
+ nativeActivityAt: null,
514
+ startedAt: { $lt: cutoff.toISOString() },
515
+ },
516
+ {
517
+ source: 'native-plugin-ai',
518
+ nativeActivityAt: null,
519
+ startedAt: null,
520
+ createdAt: { $lt: cutoff.toISOString() },
521
+ },
522
+ { source: { $ne: 'native-plugin-ai' }, createdAt: { $lt: cutoff.toISOString() } },
523
+ { source: null, createdAt: { $lt: cutoff.toISOString() } },
524
+ ],
525
+ },
526
+ ],
527
+ },
528
+ })
529
+ : 0;
530
+ this.app.log.info(
531
+ `[AgentOrchestrator] Pruned ${deletedLogs} orchestratorLogs and ${deletedSpans} agentExecutionSpans rows older than ${days} day(s).`,
532
+ );
533
+ } catch (e) {
534
+ this.app.log.error('[AgentOrchestrator] Log retention job failed', e);
535
+ }
536
+ },
537
+ });
538
+
539
+ // --- Skill Metrics Aggregation ---
540
+ // Daily roll-up of skillExecutions into per-skill/per-employee metrics for
541
+ // operational dashboards. Override schedule via env: SKILL_METRICS_CRON (default 03:00).
542
+ this.app.cronJobManager.addJob({
543
+ cronTime: process.env.SKILL_METRICS_CRON || '0 0 3 * * *',
544
+ onTick: async () => {
545
+ try {
546
+ await this.aggregateSkillMetrics();
547
+ } catch (e) {
548
+ this.app.log.error('[AgentOrchestrator] Skill metrics aggregation job failed', e);
549
+ }
550
+ },
551
+ });
552
+
553
+ // Native sub-agent conversations are owned by @nocobase/plugin-ai. This
554
+ // plugin only observes their execution spans and policy context.
555
+ }
556
+
557
+ private async aggregateSkillMetrics() {
558
+ const yesterday = new Date(Date.now() - 86400000);
559
+ yesterday.setUTCHours(0, 0, 0, 0);
560
+ const today = new Date(yesterday.getTime() + 86400000);
561
+
562
+ const repo = this.db.getRepository('skillExecutions');
563
+ if (!repo) return;
564
+
565
+ const rows = await repo.find({
566
+ filter: {
567
+ createdAt: {
568
+ $gte: yesterday.toISOString(),
569
+ $lt: today.toISOString(),
570
+ },
571
+ },
572
+ fields: ['skillId', 'aiEmployeeUsername', 'status', 'durationMs'],
573
+ });
574
+
575
+ type MetricKey = string;
576
+ interface MetricBucket {
577
+ executions: number;
578
+ successes: number;
579
+ failures: number;
580
+ timeouts: number;
581
+ durations: number[];
582
+ }
583
+
584
+ const buckets = new Map<MetricKey, MetricBucket>();
585
+
586
+ for (const row of rows) {
587
+ const skillId = String(row.get?.('skillId') || '');
588
+ const username = String(row.get?.('aiEmployeeUsername') || '');
589
+ const status = String(row.get?.('status') || '');
590
+ const durationMs = Number(row.get?.('durationMs') || 0);
591
+ if (!skillId) continue;
592
+
593
+ const key = `${skillId}:${username}`;
594
+ if (!buckets.has(key)) {
595
+ buckets.set(key, { executions: 0, successes: 0, failures: 0, timeouts: 0, durations: [] });
596
+ }
597
+ const bucket = buckets.get(key) ?? { executions: 0, successes: 0, failures: 0, timeouts: 0, durations: [] };
598
+ bucket.executions += 1;
599
+ if (status === 'succeeded') bucket.successes += 1;
600
+ else if (status === 'timeout') bucket.timeouts += 1;
601
+ else if (status === 'failed') bucket.failures += 1;
602
+ if (durationMs > 0) bucket.durations.push(durationMs);
603
+ }
604
+
605
+ const metricsRepo = this.db.getRepository('skillMetrics');
606
+ if (!metricsRepo) return;
607
+
608
+ let upserted = 0;
609
+ for (const [key, bucket] of buckets) {
610
+ const firstColon = key.indexOf(':');
611
+ const skillId = key.substring(0, firstColon);
612
+ const employeeUsername = key.substring(firstColon + 1);
613
+ const sortedDurations = [...bucket.durations].sort((a, b) => a - b);
614
+ const p95Index = Math.max(0, Math.ceil(sortedDurations.length * 0.95) - 1);
615
+ const totalDuration = sortedDurations.reduce((sum, d) => sum + d, 0);
616
+
617
+ await metricsRepo.updateOrCreate({
618
+ filterKeys: ['skillId', 'employeeUsername', 'period'],
619
+ values: {
620
+ skillId: skillId,
621
+ employeeUsername,
622
+ period: yesterday.toISOString(),
623
+ executions: bucket.executions,
624
+ successes: bucket.successes,
625
+ failures: bucket.failures,
626
+ timeouts: bucket.timeouts,
627
+ avgDurationMs: bucket.durations.length ? Math.round(totalDuration / bucket.durations.length) : 0,
628
+ p95DurationMs: sortedDurations.length > 1 ? sortedDurations[p95Index] : sortedDurations[0] || 0,
629
+ totalDurationMs: totalDuration,
630
+ },
631
+ });
632
+ upserted += 1;
633
+ }
634
+
635
+ this.app.log.info(
636
+ `[AgentOrchestrator] Skill metrics aggregated for ${yesterday
637
+ .toISOString()
638
+ .slice(0, 10)}: ${upserted} metric row(s).`,
639
+ );
640
+ }
641
+
642
+ async install() {
643
+ await this.skillHub.install();
644
+ await initializeRoutingGraphLock(this.db);
645
+ await ensureAgentOrchestratorIndexes(this.db);
646
+ }
647
+
648
+ async upgrade() {
649
+ await initializeRoutingGraphLock(this.db);
650
+ await ensureAgentOrchestratorIndexes(this.db);
651
+ }
652
+
653
+ async afterEnable() {
654
+ this.governanceEnabled = true;
655
+ this.installGovernanceHooks();
656
+ this.installNativeMonitorHook();
657
+ }
658
+ async afterDisable() {
659
+ this.governanceEnabled = false;
660
+ this.hierarchyCancellation.abortAll();
661
+ this.removeManagedPromptProtection?.();
662
+ this.removeManagedPromptProtection = undefined;
663
+ this.removeNativeUsageAttribution?.();
664
+ this.removeNativeUsageAttribution = undefined;
665
+ this.nativeObserver?.uninstall();
666
+ this.removeNativeMonitorHook?.();
667
+ this.removeNativeMonitorHook = undefined;
668
+ }
669
+ async remove() {}
670
+
671
+ async beforeStop() {
672
+ this.governanceEnabled = false;
673
+ this.hierarchyCancellation.abortAll();
674
+ this.removeManagedPromptProtection?.();
675
+ this.removeManagedPromptProtection = undefined;
676
+ this.removeNativeUsageAttribution?.();
677
+ this.removeNativeUsageAttribution = undefined;
678
+ this.app.off?.('afterStart', this.installNativeObserver);
679
+ this.app.removeListener?.('afterStart', this.installNativeObserver);
680
+ this.app.off?.('afterStart', this.startLoopWorker);
681
+ this.app.removeListener?.('afterStart', this.startLoopWorker);
682
+ await this.loopWorker?.stop();
683
+ await this.loopScheduler?.dispose();
684
+ this.nativeObserver?.uninstall();
685
+ this.removeNativeMonitorHook?.();
686
+ this.removeNativeMonitorHook = undefined;
687
+ await this.skillHub.beforeStop();
688
+ resetRunEventBus();
689
+ }
690
+
691
+ async handleSyncMessage(message: unknown) {
692
+ this.hierarchyCancellation.handleSyncMessage(message);
693
+ await this.loopScheduler?.handleSyncMessage(message);
694
+ await this.loopWorker?.handleSyncMessage(message);
695
+ }
696
+
697
+ private readonly startLoopWorker = () => {
698
+ this.loopWorker?.start();
699
+ };
700
+
701
+ private installGovernanceHooks() {
702
+ if (!this.removeManagedPromptProtection)
703
+ this.removeManagedPromptProtection = installManagedPromptProtection(this.db);
704
+ if (!this.removeNativeUsageAttribution) this.removeNativeUsageAttribution = installNativeUsageAttribution(this);
705
+ }
706
+
707
+ private installNativeMonitorHook() {
708
+ if (this.removeNativeMonitorHook || !this.agentRuntimeLifecycle || !this.nativeMonitorSyncService) return;
709
+ this.removeNativeMonitorHook = this.agentRuntimeLifecycle.registerAfterRunHook('native-monitor', (context) => {
710
+ if (context.source !== 'api' || !context.sessionId) return;
711
+ // The custom API lifecycle is best effort, not a global core hook. A detached bounded
712
+ // page avoids delaying the response; durable usage events support later reconciliation.
713
+ this.nativeMonitorSyncService.syncSession(context.sessionId).catch((error: unknown) => {
714
+ try {
715
+ this.app.logger.warn('[AgentOrchestrator] Failed to sync API agent telemetry.', { error });
716
+ } catch {
717
+ // Telemetry logging cannot affect native agent execution.
718
+ }
719
+ });
720
+ });
721
+ }
722
+ }
723
+
724
+ export default PluginAgentOrchestratorServer;