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,482 +1,208 @@
1
- import type { Plugin } from '@nocobase/server';
2
- import { asObject, currentUserId, isAdminUser, toPlain, trimText } from '../utils/ctx-utils';
3
- import { makeNativeRunId, NATIVE_SOURCE } from '../services/NativeSubAgentObserver';
4
-
5
- function normalizeString(value: unknown) {
6
- return typeof value === 'string' ? value.trim() : '';
7
- }
8
-
9
- function readValue(record: unknown, key: string) {
10
- const model = record as { get?: (name: string) => unknown; [key: string]: unknown };
11
- return typeof model?.get === 'function' ? model.get(key) : model?.[key];
12
- }
13
-
14
- function isAdmin(ctx: unknown) {
15
- const context = ctx as { state?: { currentRoles?: string[] } };
16
- if (isAdminUser(ctx)) return true;
17
- const roles = context?.state?.currentRoles;
18
- return Array.isArray(roles) && roles.some((role) => role === 'root' || role === 'admin');
19
- }
20
-
21
- function statusFromNative(status: unknown) {
22
- if (status === 'completed' || status === 'done' || status === 'success') return 'success';
23
- if (status === 'error' || status === 'failed') return 'error';
24
- return 'running';
25
- }
26
-
27
- function formatDuration(ms: unknown) {
28
- const value = Number(ms);
29
- if (!Number.isFinite(value) || value <= 0) return null;
30
- return value;
31
- }
32
-
33
- function formatSpanListRow(raw: unknown) {
34
- const row = toPlain(raw);
35
- const input = asObject(row?.input);
36
- const metadata = asObject(row?.metadata);
37
- return {
38
- id: row?.id,
39
- rootRunId: row?.rootRunId,
40
- source: row?.source || metadata.source,
41
- parentSessionId: row?.parentSessionId || metadata.parentSessionId,
42
- subSessionId: row?.subSessionId || metadata.subSessionId,
43
- toolCallId: row?.toolCallId || metadata.toolCallId,
44
- leaderUsername: row?.leaderUsername,
45
- employeeUsername: row?.employeeUsername,
46
- subAgentUsername: row?.employeeUsername,
47
- toolName: row?.toolName || 'dispatch-sub-agent-task',
48
- task: input.question || input.task || row?.title || '',
49
- status: row?.status,
50
- durationMs: row?.durationMs,
51
- error: row?.error,
52
- userId: row?.userId,
53
- memoryContextApplied: Boolean(metadata.memoryContextApplied),
54
- memoryScopes: metadata.memoryScopes || [],
55
- harnessTag: metadata.harnessTag || 'default',
56
- createdAt: row?.createdAt || row?.startedAt,
57
- startedAt: row?.startedAt,
58
- endedAt: row?.endedAt,
59
- };
60
- }
61
-
62
- function buildSpanTree(rows: unknown[]) {
63
- const byId = new Map<string, Record<string, unknown> & { children: unknown[] }>();
64
- const roots: Array<Record<string, unknown> & { children: unknown[] }> = [];
65
-
66
- for (const raw of rows) {
67
- const row = toPlain(raw);
68
- byId.set(String(row.id), { ...row, children: [] });
69
- }
70
-
71
- for (const row of byId.values()) {
72
- const parentSpanId = normalizeString(row.parentSpanId);
73
- if (parentSpanId && byId.has(parentSpanId)) {
74
- byId.get(parentSpanId)?.children.push(row);
75
- } else {
76
- roots.push(row);
77
- }
78
- }
79
-
80
- const sort = (items: Array<Record<string, unknown> & { children: unknown[] }>) => {
81
- items.sort(
82
- (a, b) =>
83
- new Date(String(a.startedAt || a.createdAt || 0)).getTime() -
84
- new Date(String(b.startedAt || b.createdAt || 0)).getTime(),
85
- );
86
- for (const item of items) sort(item.children as Array<Record<string, unknown> & { children: unknown[] }>);
87
- };
88
- sort(roots);
89
- return roots;
90
- }
91
-
92
- function flattenTimeline(rows: unknown[]) {
93
- return rows
94
- .map(toPlain)
95
- .sort(
96
- (a, b) =>
97
- new Date(String(a.startedAt || a.createdAt || 0)).getTime() -
98
- new Date(String(b.startedAt || b.createdAt || 0)).getTime(),
99
- )
100
- .map((row) => ({
101
- id: row.id,
102
- type: row.type,
103
- at: row.startedAt || row.createdAt,
104
- title: row.title || row.toolName || row.type,
105
- toolName: row.toolName,
106
- status: row.status,
107
- durationMs: row.durationMs,
108
- content: row.output || row.error || asObject(row.input).question || '',
109
- parentSpanId: row.parentSpanId,
110
- input: row.input,
111
- output: row.output,
112
- error: row.error,
113
- }));
114
- }
115
-
116
- async function findConversation(ctx: any, sessionId?: string) {
117
- if (!sessionId) return null;
118
- try {
119
- return toPlain(
120
- await ctx.db.getRepository('aiConversations').findOne({
121
- filter: { sessionId },
122
- }),
123
- );
124
- } catch {
125
- return null;
126
- }
127
- }
128
-
129
- async function findToolMessages(ctx: any, sessionIds: string[]) {
130
- const repo = ctx.db.getRepository('aiToolMessages');
131
- const rows: unknown[] = [];
132
- for (const sessionId of Array.from(new Set(sessionIds.filter(Boolean)))) {
133
- try {
134
- const list = await repo.find({
135
- filter: { sessionId },
136
- sort: ['messageId', 'id'],
137
- });
138
- rows.push(...list);
139
- } catch {
140
- // Keep monitor read-only and best-effort across plugin-ai versions.
141
- }
142
- }
143
- return rows.map(toPlain);
144
- }
145
-
146
- async function findNativeMessages(ctx: any, parentSessionId?: string, subSessionId?: string) {
147
- const repo = ctx.db.getRepository('aiMessages');
148
- const rows: unknown[] = [];
149
- for (const sessionId of [parentSessionId, subSessionId].filter(Boolean)) {
150
- try {
151
- const list = await repo.find({
152
- filter: { sessionId },
153
- sort: ['messageId'],
154
- limit: 200,
155
- });
156
- rows.push(...list);
157
- } catch {
158
- // Optional native details only.
159
- }
160
- }
161
- return rows.map(toPlain);
162
- }
163
-
164
- async function backfillFromMetadata(ctx: any, spanRepo: any, limit: number) {
165
- const messageRepo = ctx.db.getRepository('aiMessages');
166
- const toolRepo = ctx.db.getRepository('aiToolMessages');
167
- const conversationRepo = ctx.db.getRepository('aiConversations');
168
- const messages = await messageRepo.find({
169
- sort: ['-messageId'],
170
- limit,
171
- });
172
- let created = 0;
173
- let skipped = 0;
174
-
175
- for (const rawMessage of messages) {
176
- const message = toPlain(rawMessage);
177
- const conversations = asObject(message.metadata).subAgentConversations;
178
- if (!Array.isArray(conversations)) continue;
179
-
180
- for (const item of conversations) {
181
- const subSessionId = normalizeString(item?.sessionId);
182
- const toolCallId = normalizeString(item?.toolCallId);
183
- if (!subSessionId || !toolCallId) {
184
- skipped += 1;
185
- continue;
186
- }
187
-
188
- const existing = await spanRepo.findOne({
189
- filter: {
190
- source: NATIVE_SOURCE,
191
- subSessionId,
192
- toolCallId,
193
- type: 'sub_agent',
194
- },
195
- });
196
- if (existing) {
197
- skipped += 1;
198
- continue;
199
- }
200
-
201
- const toolMessage = toPlain(
202
- await toolRepo.findOne({
203
- filter: { toolCallId },
204
- }),
205
- );
206
- const parentSessionId = normalizeString(toolMessage?.sessionId) || normalizeString(message.sessionId);
207
- const parentConversation = parentSessionId
208
- ? toPlain(await conversationRepo.findOne({ filter: { sessionId: parentSessionId } }))
209
- : null;
210
- const subConversation = toPlain(await conversationRepo.findOne({ filter: { sessionId: subSessionId } }));
211
- const invokeStart = Number(toolMessage?.invokeStartTime);
212
- const invokeEnd = Number(toolMessage?.invokeEndTime);
213
- const durationMs =
214
- Number.isFinite(invokeStart) && Number.isFinite(invokeEnd) && invokeEnd >= invokeStart
215
- ? invokeEnd - invokeStart
216
- : undefined;
217
- const rootRunId = makeNativeRunId([
218
- parentSessionId,
219
- subSessionId,
220
- toolCallId,
221
- subConversation?.aiEmployeeUsername,
222
- ]);
223
- const content = asObject(toolMessage?.content);
224
-
225
- await spanRepo.create({
226
- values: {
227
- rootRunId,
228
- parentSpanId: null,
229
- source: NATIVE_SOURCE,
230
- parentSessionId: parentSessionId || undefined,
231
- subSessionId: subSessionId || undefined,
232
- toolCallId,
233
- type: 'sub_agent',
234
- status: statusFromNative(item?.status || toolMessage?.status),
235
- leaderUsername: parentConversation?.aiEmployeeUsername,
236
- employeeUsername: subConversation?.aiEmployeeUsername,
237
- toolName: 'dispatch-sub-agent-task',
238
- title:
239
- subConversation?.title ||
240
- `${parentConversation?.aiEmployeeUsername || 'main'} -> ${
241
- subConversation?.aiEmployeeUsername || 'sub-agent'
242
- }`,
243
- input: {
244
- question: subConversation?.title,
245
- parentSessionId: parentSessionId || undefined,
246
- subSessionId: subSessionId || undefined,
247
- },
248
- output: trimText(content.answer || toolMessage?.content, 20000),
249
- durationMs: formatDuration(durationMs),
250
- startedAt: invokeStart ? new Date(invokeStart) : new Date(),
251
- endedAt: invokeEnd ? new Date(invokeEnd) : undefined,
252
- metadata: {
253
- source: NATIVE_SOURCE,
254
- backfilled: true,
255
- messageId: message.messageId,
256
- toolMessageId: toolMessage?.id,
257
- nativeStatus: item?.status,
258
- },
259
- userId: parentConversation?.userId || subConversation?.userId,
260
- createdAt: new Date(),
261
- },
262
- });
263
- created += 1;
264
- }
265
- }
266
-
267
- return { created, skipped };
268
- }
269
-
270
- async function backfillFromToolMessages(ctx: any, spanRepo: any, limit: number) {
271
- const toolRepo = ctx.db.getRepository('aiToolMessages');
272
- const toolMessages = await toolRepo.find({
273
- filter: { toolName: 'dispatch-sub-agent-task' },
274
- sort: ['-id'],
275
- limit,
276
- });
277
- let created = 0;
278
- let skipped = 0;
279
-
280
- for (const rawToolMessage of toolMessages) {
281
- const toolMessage = toPlain(rawToolMessage);
282
- const content = asObject(toolMessage.content);
283
- const subSessionId = normalizeString(content.sessionId);
284
- const toolCallId = normalizeString(toolMessage.toolCallId);
285
- if (!subSessionId || !toolCallId) {
286
- skipped += 1;
287
- continue;
288
- }
289
-
290
- const existing = await spanRepo.findOne({
291
- filter: {
292
- source: NATIVE_SOURCE,
293
- subSessionId,
294
- toolCallId,
295
- type: 'sub_agent',
296
- },
297
- });
298
- if (existing) {
299
- skipped += 1;
300
- continue;
301
- }
302
-
303
- const parentSessionId = normalizeString(toolMessage.sessionId);
304
- const parentConversation = await findConversation(ctx, parentSessionId);
305
- const subConversation = await findConversation(ctx, subSessionId);
306
- const invokeStart = Number(toolMessage.invokeStartTime);
307
- const invokeEnd = Number(toolMessage.invokeEndTime);
308
- const rootRunId = makeNativeRunId([parentSessionId, subSessionId, toolCallId, subConversation?.aiEmployeeUsername]);
309
-
310
- await spanRepo.create({
311
- values: {
312
- rootRunId,
313
- parentSpanId: null,
314
- source: NATIVE_SOURCE,
315
- parentSessionId: parentSessionId || undefined,
316
- subSessionId: subSessionId || undefined,
317
- toolCallId,
318
- type: 'sub_agent',
319
- status: statusFromNative(toolMessage.status),
320
- leaderUsername: parentConversation?.aiEmployeeUsername,
321
- employeeUsername: subConversation?.aiEmployeeUsername,
322
- toolName: 'dispatch-sub-agent-task',
323
- title:
324
- subConversation?.title ||
325
- `${parentConversation?.aiEmployeeUsername || 'main'} -> ${
326
- subConversation?.aiEmployeeUsername || 'sub-agent'
327
- }`,
328
- input: {
329
- question: subConversation?.title,
330
- parentSessionId: parentSessionId || undefined,
331
- subSessionId: subSessionId || undefined,
332
- },
333
- output: trimText(content.answer || toolMessage.content, 20000),
334
- durationMs:
335
- Number.isFinite(invokeStart) && Number.isFinite(invokeEnd) && invokeEnd >= invokeStart
336
- ? invokeEnd - invokeStart
337
- : undefined,
338
- startedAt: invokeStart ? new Date(invokeStart) : new Date(),
339
- endedAt: invokeEnd ? new Date(invokeEnd) : undefined,
340
- metadata: {
341
- source: NATIVE_SOURCE,
342
- backfilled: true,
343
- toolMessageId: toolMessage.id,
344
- },
345
- userId: parentConversation?.userId || subConversation?.userId,
346
- createdAt: new Date(),
347
- },
348
- });
349
- created += 1;
350
- }
351
-
352
- return { created, skipped };
353
- }
354
-
355
- export function registerAgentMonitorResource(plugin: Plugin) {
356
- plugin.app.resource({
357
- name: 'agentMonitor',
358
- actions: {
359
- async list(ctx, next) {
360
- const { page = 1, pageSize = 20, sort = ['-createdAt'], filter = {} } = ctx.action.params;
361
- const requestedFilter = asObject(filter);
362
- const spanFilter: Record<string, unknown> = {
363
- source: NATIVE_SOURCE,
364
- type: 'sub_agent',
365
- parentSpanId: null,
366
- };
367
-
368
- for (const key of [
369
- 'leaderUsername',
370
- 'employeeUsername',
371
- 'status',
372
- 'parentSessionId',
373
- 'subSessionId',
374
- 'toolCallId',
375
- ]) {
376
- if (requestedFilter[key]) spanFilter[key] = requestedFilter[key];
377
- }
378
- if (requestedFilter.subAgentUsername) spanFilter.employeeUsername = requestedFilter.subAgentUsername;
379
- if (requestedFilter.sessionId) spanFilter.parentSessionId = requestedFilter.sessionId;
380
-
381
- if (!isAdmin(ctx)) {
382
- const userId = currentUserId(ctx);
383
- if (!userId) ctx.throw(401, 'Not authenticated');
384
- spanFilter.userId = userId;
385
- } else if (requestedFilter.userId) {
386
- spanFilter.userId = requestedFilter.userId;
387
- }
388
-
389
- const repo = ctx.db.getRepository('agentExecutionSpans');
390
- const [rows, count] = await repo.findAndCount({
391
- filter: spanFilter,
392
- sort,
393
- offset: (Number(page) - 1) * Number(pageSize),
394
- limit: Number(pageSize),
395
- });
396
-
397
- ctx.body = {
398
- data: rows.map(formatSpanListRow),
399
- meta: {
400
- count,
401
- page: Number(page),
402
- pageSize: Number(pageSize),
403
- totalPage: Math.ceil(count / Number(pageSize)),
404
- },
405
- };
406
- await next();
407
- },
408
-
409
- async get(ctx, next) {
410
- const { filterByTk } = ctx.action.params;
411
- if (!filterByTk) {
412
- ctx.throw(400, 'span id is required');
413
- return;
414
- }
415
-
416
- const repo = ctx.db.getRepository('agentExecutionSpans');
417
- const span = toPlain(
418
- await repo.findOne({
419
- filter: { id: filterByTk },
420
- }),
421
- );
422
- if (!span) {
423
- ctx.throw(404, 'span not found');
424
- return;
425
- }
426
-
427
- if (!isAdmin(ctx) && String(span.userId || '') !== String(currentUserId(ctx) || '')) {
428
- ctx.throw(403, 'You cannot view this agent run.');
429
- return;
430
- }
431
-
432
- const rows = await repo.find({
433
- filter: { rootRunId: span.rootRunId },
434
- sort: ['createdAt'],
435
- });
436
- const parentSessionId = normalizeString(span.parentSessionId || asObject(span.metadata).parentSessionId);
437
- const subSessionId = normalizeString(span.subSessionId || asObject(span.metadata).subSessionId);
438
-
439
- ctx.body = {
440
- data: {
441
- ...formatSpanListRow(span),
442
- input: span.input,
443
- output: span.output,
444
- metadata: span.metadata || {},
445
- children: buildSpanTree(rows),
446
- trace: flattenTimeline(rows),
447
- nativeConversations: {
448
- parent: await findConversation(ctx, parentSessionId),
449
- subAgent: await findConversation(ctx, subSessionId),
450
- },
451
- nativeMessages: await findNativeMessages(ctx, parentSessionId, subSessionId),
452
- toolMessages: await findToolMessages(ctx, [parentSessionId, subSessionId]),
453
- },
454
- };
455
- await next();
456
- },
457
-
458
- async sync(ctx, next) {
459
- if (!isAdmin(ctx)) {
460
- ctx.throw(403, 'Admin role is required to sync native agent monitor spans.');
461
- return;
462
- }
463
-
464
- const values = asObject(ctx.action.params?.values);
465
- const limit = Math.min(Math.max(Number(values.limit || ctx.action.params?.limit || 200), 1), 1000);
466
- const spanRepo = ctx.db.getRepository('agentExecutionSpans');
467
- const metadataResult = await backfillFromMetadata(ctx, spanRepo, limit);
468
- const toolResult = await backfillFromToolMessages(ctx, spanRepo, limit);
469
-
470
- ctx.body = {
471
- data: {
472
- created: metadataResult.created + toolResult.created,
473
- skipped: metadataResult.skipped + toolResult.skipped,
474
- metadata: metadataResult,
475
- toolMessages: toolResult,
476
- },
477
- };
478
- await next();
479
- },
480
- },
481
- });
482
- }
1
+ // SPDX-License-Identifier: Apache-2.0
2
+
3
+ import type { Plugin } from '@nocobase/server';
4
+ import { Op, Sequelize } from 'sequelize';
5
+ import { asObject, currentUserId, isAdminUser, toPlain } from '../utils/ctx-utils';
6
+ import { NATIVE_SOURCE } from '../services/NativeSubAgentObserver';
7
+ import { NativeAgentMonitorSyncService } from '../services/NativeAgentMonitorSyncService';
8
+ import { safeNativeSpan, selectNativeSubtree, summarizeNativeUsage } from './native-monitor-format';
9
+
10
+ const MAX_DETAIL_SPANS = 5000;
11
+ const MAX_FILTER_DEPTH = 32;
12
+ type QueryGenerator = {
13
+ quoteIdentifier: (value: string) => string;
14
+ quoteTable: (value: unknown) => string;
15
+ escape: (value: string | number) => string;
16
+ };
17
+
18
+ function isAdmin(ctx: unknown) {
19
+ if (isAdminUser(ctx)) return true;
20
+ const roles = (ctx as { state?: { currentRoles?: unknown } })?.state?.currentRoles;
21
+ return Array.isArray(roles) && roles.some((role) => role === 'root' || role === 'admin');
22
+ }
23
+
24
+ function formatSpanListRow(raw: unknown) {
25
+ const row = safeNativeSpan(raw);
26
+ return {
27
+ ...row,
28
+ subAgentUsername: row.employeeUsername,
29
+ task: row.title,
30
+ createdAt: row.startedAt || row.createdAt,
31
+ };
32
+ }
33
+
34
+ function buildSpanTree(rows: Record<string, unknown>[]) {
35
+ const byId = new Map<string, Record<string, unknown> & { children: unknown[] }>();
36
+ const roots: Array<Record<string, unknown> & { children: unknown[] }> = [];
37
+ for (const row of rows) byId.set(String(row.id), { ...row, children: [] });
38
+ for (const row of byId.values()) {
39
+ const parent = row.parentSpanId ? byId.get(String(row.parentSpanId)) : undefined;
40
+ if (parent) parent.children.push(row);
41
+ else roots.push(row);
42
+ }
43
+ const sort = (items: Array<Record<string, unknown> & { children: unknown[] }>) => {
44
+ items.sort(
45
+ (a, b) =>
46
+ new Date(String(a.startedAt || a.createdAt || 0)).getTime() -
47
+ new Date(String(b.startedAt || b.createdAt || 0)).getTime(),
48
+ );
49
+ for (const item of items) sort(item.children as Array<Record<string, unknown> & { children: unknown[] }>);
50
+ };
51
+ sort(roots);
52
+ return roots;
53
+ }
54
+
55
+ function flattenTimeline(rows: Record<string, unknown>[]) {
56
+ return rows
57
+ .slice()
58
+ .sort(
59
+ (a, b) =>
60
+ new Date(String(a.startedAt || a.createdAt || 0)).getTime() -
61
+ new Date(String(b.startedAt || b.createdAt || 0)).getTime(),
62
+ )
63
+ .map((row) => ({ ...row, at: row.startedAt || row.createdAt }));
64
+ }
65
+
66
+ export function registerAgentMonitorResource(plugin: Plugin) {
67
+ const sync = new NativeAgentMonitorSyncService(plugin);
68
+ plugin.app.resource({
69
+ name: 'agentMonitor',
70
+ actions: {
71
+ async list(ctx, next) {
72
+ const { page = 1, pageSize = 20, sort = ['-startedAt'], filter = {} } = ctx.action?.params || {};
73
+ const requestedFilter = asObject(filter);
74
+ const spanFilter: Record<string, unknown> = {
75
+ source: NATIVE_SOURCE,
76
+ type: { [Op.in]: ['main_agent', 'sub_agent'] },
77
+ parentSpanId: null,
78
+ };
79
+ for (const key of ['leaderUsername', 'parentSessionId']) {
80
+ if (requestedFilter[key]) spanFilter[key] = requestedFilter[key];
81
+ }
82
+ if (requestedFilter.sessionId) spanFilter.parentSessionId = requestedFilter.sessionId;
83
+ const admin = isAdmin(ctx);
84
+ if (!admin) {
85
+ const userId = currentUserId(ctx);
86
+ if (!userId) ctx.throw(401, 'Not authenticated');
87
+ spanFilter.userId = userId;
88
+ } else if (requestedFilter.userId) {
89
+ spanFilter.userId = requestedFilter.userId;
90
+ }
91
+ const currentPage = Math.max(1, Math.trunc(Number(page) || 1));
92
+ const size = Math.min(100, Math.max(1, Math.trunc(Number(pageSize) || 20)));
93
+ const repo = ctx.db.getRepository('agentExecutionSpans');
94
+ const childFilter: Record<string, unknown> = {};
95
+ for (const key of ['status', 'subSessionId', 'toolCallId', 'toolName']) {
96
+ if (requestedFilter[key]) childFilter[key] = requestedFilter[key];
97
+ }
98
+ if (requestedFilter.subAgentUsername || requestedFilter.employeeUsername) {
99
+ childFilter.employeeUsername = requestedFilter.subAgentUsername || requestedFilter.employeeUsername;
100
+ childFilter.type = 'sub_agent';
101
+ }
102
+ if (Object.keys(childFilter).length) {
103
+ // Legacy sessions can share a rootRunId. Follow parentSpanId from each accessible
104
+ // root so a matching sibling session cannot cause a false positive.
105
+ const model = repo.model;
106
+ const query = ctx.db.sequelize.getQueryInterface().queryGenerator as unknown as QueryGenerator;
107
+ const column = (alias: string, name: string) =>
108
+ `${alias}.${query.quoteIdentifier(model.rawAttributes[name]?.field || name)}`;
109
+ const predicate = (alias: string, [name, value]: [string, unknown]) => {
110
+ if (typeof value !== 'string' && typeof value !== 'number') ctx.throw(400, 'Invalid monitor filter value.');
111
+ return `${column(alias, name)} = ${query.escape(value as string | number)}`;
112
+ };
113
+ const table = query.quoteTable(model.getTableName());
114
+ const roots = [
115
+ predicate('monitor_root', ['source', NATIVE_SOURCE]),
116
+ `${column('monitor_root', 'type')} IN (${query.escape('main_agent')}, ${query.escape('sub_agent')})`,
117
+ `${column('monitor_root', 'parentSpanId')} IS NULL`,
118
+ ...['userId', 'leaderUsername', 'parentSessionId']
119
+ .filter((key) => spanFilter[key] !== undefined)
120
+ .map((key) => predicate('monitor_root', [key, spanFilter[key]])),
121
+ ];
122
+ const matches = Object.entries(childFilter).map((entry) => predicate('monitor_match', entry));
123
+ const owner = admin ? '' : ` AND ${predicate('monitor_child', ['userId', spanFilter.userId])}`;
124
+ const castType = ['mysql', 'mariadb'].includes(ctx.db.sequelize.getDialect()) ? 'CHAR' : 'TEXT';
125
+ const sql = `(WITH RECURSIVE monitor_tree(root_id, span_id, depth) AS (
126
+ SELECT ${column('monitor_root', 'id')}, ${column('monitor_root', 'id')}, 0
127
+ FROM ${table} AS monitor_root WHERE ${roots.join(' AND ')}
128
+ UNION ALL
129
+ SELECT monitor_tree.root_id, ${column('monitor_child', 'id')}, monitor_tree.depth + 1
130
+ FROM ${table} AS monitor_child JOIN monitor_tree
131
+ ON ${column('monitor_child', 'parentSpanId')} = CAST(monitor_tree.span_id AS ${castType})
132
+ WHERE monitor_tree.depth < ${MAX_FILTER_DEPTH}${owner}
133
+ ) SELECT DISTINCT monitor_tree.root_id FROM monitor_tree
134
+ JOIN ${table} AS monitor_match ON ${column('monitor_match', 'id')} = monitor_tree.span_id
135
+ WHERE ${matches.join(' AND ')})`;
136
+ spanFilter.id = { [Op.in]: Sequelize.literal(sql) };
137
+ }
138
+ const [rows, count] = await repo.findAndCount({
139
+ where: spanFilter,
140
+ sort,
141
+ offset: (currentPage - 1) * size,
142
+ limit: size,
143
+ });
144
+ ctx.body = {
145
+ data: rows.map(formatSpanListRow),
146
+ meta: {
147
+ count,
148
+ page: currentPage,
149
+ pageSize: size,
150
+ totalPage: Math.ceil(count / size),
151
+ ...(Object.keys(childFilter).length ? { filterDepthLimit: MAX_FILTER_DEPTH } : {}),
152
+ },
153
+ };
154
+ await next();
155
+ },
156
+ async get(ctx, next) {
157
+ const { filterByTk } = ctx.action?.params || {};
158
+ if (!filterByTk) ctx.throw(400, 'span id is required');
159
+ const repo = ctx.db.getRepository('agentExecutionSpans');
160
+ const span = toPlain(await repo.findOne({ filter: { id: filterByTk, source: NATIVE_SOURCE } }));
161
+ if (!span) ctx.throw(404, 'span not found');
162
+ const userId = currentUserId(ctx);
163
+ if (!isAdmin(ctx) && (!userId || String(span.userId || '') !== String(userId))) {
164
+ ctx.throw(403, 'You cannot view this agent run.');
165
+ }
166
+ const filter = isAdmin(ctx) ? { rootRunId: span.rootRunId } : { rootRunId: span.rootRunId, userId };
167
+ const rawRows = await repo.find({ filter, sort: ['createdAt'], limit: MAX_DETAIL_SPANS + 1 });
168
+ const truncated = rawRows.length > MAX_DETAIL_SPANS;
169
+ const rows = selectNativeSubtree(rawRows.slice(0, MAX_DETAIL_SPANS), span).map(safeNativeSpan);
170
+ const usage = summarizeNativeUsage(rows);
171
+ ctx.body = {
172
+ data: {
173
+ ...formatSpanListRow(span),
174
+ children: buildSpanTree(rows),
175
+ trace: flattenTimeline(rows),
176
+ usage: truncated ? { ...usage, inputTokens: null, outputTokens: null, cost: null } : usage,
177
+ coverage: {
178
+ granularity: 'session',
179
+ contentCapture: 'omitted-without-invocation-policy-snapshot',
180
+ truncated,
181
+ },
182
+ // Keep response keys compatible without exposing native content or bypassing native ACL.
183
+ nativeConversations: { parent: null, subAgent: null },
184
+ nativeMessages: [],
185
+ toolMessages: [],
186
+ },
187
+ };
188
+ await next();
189
+ },
190
+ async sync(ctx, next) {
191
+ if (!isAdmin(ctx)) ctx.throw(403, 'Admin role is required to sync native agent monitor spans.');
192
+ const values = asObject(ctx.action?.params?.values || ctx.request?.body);
193
+ try {
194
+ ctx.body = await sync.sync({
195
+ limit: Number(values.limit || ctx.action?.params?.limit || 200),
196
+ cursor: values.cursor,
197
+ });
198
+ } catch (error) {
199
+ if (error instanceof Error && /^(Invalid|Unsupported) native monitor cursor/.test(error.message)) {
200
+ ctx.throw(400, error.message);
201
+ }
202
+ throw error;
203
+ }
204
+ await next();
205
+ },
206
+ },
207
+ });
208
+ }