plugin-agent-orchestrator 1.1.8 → 1.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (495) hide show
  1. package/LICENSE +201 -0
  2. package/README.md +207 -204
  3. package/client-v2.d.ts +2 -2
  4. package/client-v2.js +1 -1
  5. package/client.d.ts +2 -2
  6. package/client.js +1 -1
  7. package/dist/client/117.6c69b6a87751dd18.js +10 -0
  8. package/dist/client/253.52f62e1bc0e9520a.js +10 -0
  9. package/dist/client/325.8f7f509bdb35e142.js +10 -0
  10. package/dist/client/404.86593f98c9768ed5.js +10 -0
  11. package/dist/client/453.fa2d169576262213.js +10 -0
  12. package/dist/client/53.567db3ae078650c6.js +10 -0
  13. package/dist/client/619.01713281e5e951d3.js +10 -0
  14. package/dist/client/652.69da1598312b3a3f.js +10 -0
  15. package/dist/client/773.648965568ff476f9.js +10 -0
  16. package/dist/client/981.37e7aeecdb1ef6fa.js +10 -0
  17. package/dist/client/993.ac89f3852990918d.js +10 -0
  18. package/dist/client/index.js +1 -1
  19. package/dist/client-v2/117.c982d79ff68738f5.js +10 -0
  20. package/dist/client-v2/214.94c4257bf2838577.js +10 -0
  21. package/dist/client-v2/253.8e19956d2a44dfb8.js +10 -0
  22. package/dist/client-v2/264.80e8e358c8c6c2e5.js +10 -0
  23. package/dist/client-v2/325.fafe5a6e83ba9cb3.js +10 -0
  24. package/dist/client-v2/404.ab032b79c95dab6f.js +10 -0
  25. package/dist/client-v2/{41.3deb9e57a0f64fc4.js → 41.cd5610fcf7446127.js} +1 -1
  26. package/dist/client-v2/453.42c6d70628d56cc2.js +10 -0
  27. package/dist/client-v2/{53.349fff8db80b19d4.js → 53.37c08089a648f89a.js} +1 -1
  28. package/dist/client-v2/{619.0a2144aaffefe018.js → 619.6e9618550101e819.js} +1 -1
  29. package/dist/client-v2/652.eeba4e0c38367321.js +10 -0
  30. package/dist/client-v2/{70.ffff2997c10fd4b0.js → 70.332698e53eb59677.js} +1 -1
  31. package/dist/client-v2/773.4de2ba5acb07318c.js +10 -0
  32. package/dist/client-v2/981.76060f466e6f7c11.js +10 -0
  33. package/dist/client-v2/993.f8cdb5172566ce75.js +10 -0
  34. package/dist/client-v2/index.js +1 -1
  35. package/dist/externalVersion.js +13 -7
  36. package/dist/locale/en-US.json +308 -1
  37. package/dist/locale/vi-VN.json +5 -1
  38. package/dist/locale/zh-CN.json +308 -1
  39. package/dist/node_modules/acorn/LICENSE +21 -0
  40. package/dist/node_modules/acorn/bin/acorn +4 -0
  41. package/dist/node_modules/acorn/dist/acorn.d.mts +857 -0
  42. package/dist/node_modules/acorn/dist/acorn.d.ts +857 -0
  43. package/dist/node_modules/acorn/dist/acorn.js +1 -0
  44. package/dist/node_modules/acorn/dist/bin.js +90 -0
  45. package/dist/node_modules/acorn/package.json +1 -0
  46. package/dist/node_modules/acorn-walk/LICENSE +21 -0
  47. package/dist/node_modules/acorn-walk/dist/walk.d.mts +177 -0
  48. package/dist/node_modules/acorn-walk/dist/walk.d.ts +177 -0
  49. package/dist/node_modules/acorn-walk/dist/walk.js +1 -0
  50. package/dist/node_modules/acorn-walk/node_modules/.bin/acorn +15 -0
  51. package/dist/node_modules/acorn-walk/node_modules/.bin/acorn.cmd +7 -0
  52. package/dist/node_modules/acorn-walk/node_modules/acorn/bin/acorn +4 -0
  53. package/dist/node_modules/acorn-walk/node_modules/acorn/dist/acorn.d.mts +866 -0
  54. package/dist/node_modules/acorn-walk/node_modules/acorn/dist/acorn.d.ts +866 -0
  55. package/dist/node_modules/acorn-walk/node_modules/acorn/dist/acorn.js +6174 -0
  56. package/dist/node_modules/acorn-walk/node_modules/acorn/dist/bin.js +90 -0
  57. package/dist/node_modules/acorn-walk/node_modules/acorn/package.json +50 -0
  58. package/dist/node_modules/acorn-walk/package.json +1 -0
  59. package/dist/node_modules/adm-zip/adm-zip.js +1 -1
  60. package/dist/node_modules/adm-zip/package.json +1 -1
  61. package/dist/node_modules/ajv/package.json +1 -1
  62. package/dist/node_modules/zod/index.cjs +1 -1
  63. package/dist/node_modules/zod/package.json +1 -1
  64. package/dist/server/collections/agent-auto-approval-checkpoints.js +47 -0
  65. package/dist/server/collections/agent-execution-spans.js +148 -9
  66. package/dist/server/collections/agent-governance-audit-events.js +47 -0
  67. package/dist/server/collections/agent-governance-policies.js +47 -0
  68. package/dist/server/collections/agent-governance-policy-versions.js +48 -0
  69. package/dist/server/collections/agent-governance-prompt-bindings.js +50 -0
  70. package/dist/server/collections/agent-hierarchy-invocations.js +59 -0
  71. package/dist/server/collections/agent-loop-runs.js +23 -5
  72. package/dist/server/collections/agent-routing-graph-locks.js +40 -0
  73. package/dist/server/collections/agent-session-auto-approvals.js +45 -0
  74. package/dist/server/collections/orchestrator-config.js +17 -0
  75. package/dist/server/migrations/20261110000000-add-usage-pricing-snapshots.js +117 -0
  76. package/dist/server/migrations/20261110010000-add-usage-department-attribution.js +54 -0
  77. package/dist/server/migrations/20261119000000-widen-native-employee-identifiers.js +59 -0
  78. package/dist/server/plugin.js +169 -33
  79. package/dist/server/resources/agent-auto-approval.js +80 -0
  80. package/dist/server/resources/agent-governance.js +192 -0
  81. package/dist/server/resources/agent-harness-profile.js +11 -3
  82. package/dist/server/resources/agent-monitor.js +109 -339
  83. package/dist/server/resources/agent-usage.js +423 -0
  84. package/dist/server/resources/hierarchical-routing.js +60 -0
  85. package/dist/server/resources/native-monitor-format.js +179 -0
  86. package/dist/server/resources/tracing.js +35 -12
  87. package/dist/server/services/AgentGovernanceService.js +500 -0
  88. package/dist/server/services/AutoApprovalCheckpoint.js +133 -0
  89. package/dist/server/services/CodeValidator.js +8 -4
  90. package/dist/server/services/DepartmentAttribution.js +65 -0
  91. package/dist/server/services/ExecutionSpanService.js +96 -3
  92. package/dist/server/services/GovernanceAdmission.js +271 -0
  93. package/dist/server/services/HarnessCapabilities.js +118 -0
  94. package/dist/server/services/HarnessCompiler.js +3 -0
  95. package/dist/server/services/HarnessSchema.js +13 -1
  96. package/dist/server/services/HierarchicalAgentRuntime.js +925 -0
  97. package/dist/server/services/HierarchyEnrollmentGuard.js +216 -0
  98. package/dist/server/services/HierarchyInvocationJournal.js +157 -0
  99. package/dist/server/services/HierarchyRequestCancellation.js +150 -0
  100. package/dist/server/services/LoopBudgetService.js +29 -11
  101. package/dist/server/services/LoopRunRepository.js +16 -7
  102. package/dist/server/services/LoopRunStateMachine.js +20 -9
  103. package/dist/server/services/LoopTriggerService.js +1 -1
  104. package/dist/server/services/LoopWorkerService.js +71 -37
  105. package/dist/server/services/ManagedPromptProtection.js +99 -0
  106. package/dist/server/services/NativeAgentMonitorSyncService.js +584 -0
  107. package/dist/server/services/NativeSubAgentObserver.js +141 -508
  108. package/dist/server/services/NativeUsageAttribution.js +97 -0
  109. package/dist/server/services/PluginAiRuntimeAdapter.js +107 -9
  110. package/dist/server/services/RoutingBindingRepository.js +156 -0
  111. package/dist/server/services/RoutingBindingValidation.js +161 -0
  112. package/dist/server/services/SandboxRunner.js +19 -0
  113. package/dist/server/services/SessionAutoApproval.js +173 -0
  114. package/dist/server/services/TokenTracker.js +787 -104
  115. package/dist/server/services/TracingRetentionPolicy.js +66 -0
  116. package/dist/server/services/VerificationService.js +20 -10
  117. package/dist/server/skill-hub/plugin.js +17 -0
  118. package/dist/server/skill-hub/sandbox-config.json +6 -6
  119. package/dist/server/skill-hub/services/RegistrySkillInstallationService.js +2 -2
  120. package/dist/server/skill-hub/services/registry-node-package.js +191 -0
  121. package/dist/server/skill-hub/tasks/SkillExecutionTask.js +21 -6
  122. package/dist/server/tools/skill-execute.js +1 -0
  123. package/dist/server/utils/ensure-indexes.js +15 -5
  124. package/package.json +66 -53
  125. package/server.d.ts +2 -2
  126. package/server.js +1 -1
  127. package/src/client/AgentRunsTab.tsx +2 -2
  128. package/src/client/ApprovalsTab.tsx +2 -2
  129. package/src/client/HarnessProfilesTab.tsx +2 -2
  130. package/src/client/OrchestratorSettings.tsx +152 -152
  131. package/src/client/SkillPages.tsx +34 -0
  132. package/src/client/__tests__/embedded-settings.test.tsx +225 -0
  133. package/src/client/hooks/useRunEventStream.ts +76 -76
  134. package/src/client/index.tsx +2 -2
  135. package/src/client/plugin.tsx +71 -33
  136. package/src/client/skill-hub/components/ExecutionHistory.tsx +200 -200
  137. package/src/client/skill-hub/components/GitSkillImport.tsx +562 -562
  138. package/src/client/skill-hub/components/LoopSettings.tsx +331 -331
  139. package/src/client/skill-hub/components/SkillEditor.tsx +460 -460
  140. package/src/client/skill-hub/components/SkillManager.tsx +194 -194
  141. package/src/client/skill-hub/components/SkillMetrics.tsx +162 -162
  142. package/src/client/skill-hub/components/SkillTestPanel.tsx +141 -141
  143. package/src/client/skill-hub/index.tsx +6 -6
  144. package/src/client/skill-hub/locale.ts +16 -16
  145. package/src/client/skill-hub/tools/InteractionSchemasProvider.tsx +147 -132
  146. package/src/client/skill-hub/tools/SkillHubCard.tsx +110 -104
  147. package/src/client/skill-hub/tools/__tests__/skill-hub-card.test.tsx +255 -0
  148. package/src/client/skill-hub/tools/loopTemplates.ts +52 -52
  149. package/src/client/skill-hub/tools/registerSkillLoopCards.ts +80 -71
  150. package/src/client/skill-hub/utils/jsonFields.ts +41 -41
  151. package/src/client-v2/__tests__/embedded-settings.test.tsx +202 -0
  152. package/src/client-v2/__tests__/hierarchical-routing-settings.test.tsx +350 -0
  153. package/src/client-v2/auto-approval/AutoApprovalBridge.tsx +513 -0
  154. package/src/client-v2/auto-approval/AutoApprovalProvider.tsx +399 -0
  155. package/src/client-v2/auto-approval/__tests__/session-auto-approval.test.tsx +1676 -0
  156. package/src/client-v2/components/AIEmployeeSelect.tsx +47 -47
  157. package/src/client-v2/components/AIEmployeesContext.tsx +97 -97
  158. package/src/client-v2/components/AgentBindingsTab.tsx +541 -269
  159. package/src/client-v2/components/AgentRunsTab.tsx +85 -83
  160. package/src/client-v2/components/ApprovalsTab.tsx +337 -337
  161. package/src/client-v2/components/EmployeeGovernanceTab.tsx +695 -0
  162. package/src/client-v2/components/HarnessProfilesTab.tsx +700 -541
  163. package/src/client-v2/components/HarnessSettingsForm.tsx +221 -0
  164. package/src/client-v2/components/KnowledgeAccessTab.tsx +116 -116
  165. package/src/client-v2/components/RetrievalTraceTab.tsx +162 -162
  166. package/src/client-v2/components/UsageGovernanceTab.tsx +379 -0
  167. package/src/client-v2/index.tsx +1 -1
  168. package/src/client-v2/pages/AgentBindingsPage.tsx +15 -13
  169. package/src/client-v2/pages/ApprovalsPage.tsx +12 -10
  170. package/src/client-v2/pages/EmployeeGovernancePage.tsx +15 -0
  171. package/src/client-v2/pages/ExecutionHistoryPage.tsx +12 -10
  172. package/src/client-v2/pages/HarnessProfilesPage.tsx +12 -10
  173. package/src/client-v2/pages/KnowledgeAccessPage.tsx +12 -10
  174. package/src/client-v2/pages/LoopSettingsPage.tsx +12 -10
  175. package/src/client-v2/pages/MemoryInspectorPage.tsx +15 -13
  176. package/src/client-v2/pages/RetrievalTracePage.tsx +12 -10
  177. package/src/client-v2/pages/RulesPage.tsx +15 -13
  178. package/src/client-v2/pages/SkillDefinitionsPage.tsx +12 -10
  179. package/src/client-v2/pages/SkillMetricsPage.tsx +12 -10
  180. package/src/client-v2/pages/TracingPage.tsx +15 -13
  181. package/src/client-v2/pages/UsageGovernancePage.tsx +15 -0
  182. package/src/client-v2/plugin.tsx +134 -111
  183. package/src/client-v2/skill-hub/components/ExecutionHistory.tsx +196 -196
  184. package/src/client-v2/skill-hub/components/FileLinkList.tsx +37 -37
  185. package/src/client-v2/skill-hub/components/GitSkillImport.tsx +539 -539
  186. package/src/client-v2/skill-hub/components/LoopSettings.tsx +331 -331
  187. package/src/client-v2/skill-hub/components/SkillEditor.tsx +453 -453
  188. package/src/client-v2/skill-hub/components/SkillManager.tsx +191 -174
  189. package/src/client-v2/skill-hub/components/SkillMetrics.tsx +162 -162
  190. package/src/client-v2/skill-hub/components/SkillTestPanel.tsx +135 -135
  191. package/src/client-v2/skill-hub/locale.ts +13 -13
  192. package/src/client-v2/skill-hub/tools/InteractionSchemasProvider.tsx +62 -0
  193. package/src/client-v2/skill-hub/tools/SkillHubCard.tsx +104 -0
  194. package/src/client-v2/skill-hub/tools/__tests__/interactions.test.ts +126 -0
  195. package/src/client-v2/skill-hub/tools/interactions.ts +137 -0
  196. package/src/client-v2/skill-hub/tools/loopTemplates.ts +52 -52
  197. package/src/client-v2/skill-hub/utils/jsonFields.ts +41 -41
  198. package/src/client-v2/utils/jsonFields.ts +41 -41
  199. package/src/index.ts +2 -2
  200. package/src/locale/en-US.json +308 -1
  201. package/src/locale/vi-VN.json +5 -1
  202. package/src/locale/zh-CN.json +308 -1
  203. package/src/server/__tests__/agent-execution-context.test.ts +18 -18
  204. package/src/server/__tests__/agent-governance.integration.test.ts +385 -0
  205. package/src/server/__tests__/agent-knowledge-insights.test.ts +123 -123
  206. package/src/server/__tests__/agent-monitor-acl.integration.test.ts +267 -0
  207. package/src/server/__tests__/agent-registry-service.test.ts +147 -147
  208. package/src/server/__tests__/agent-runtime-lifecycle.test.ts +46 -46
  209. package/src/server/__tests__/agent-usage-report.integration.test.ts +335 -0
  210. package/src/server/__tests__/auto-approval-checkpoint.integration.test.ts +295 -0
  211. package/src/server/__tests__/code-validator.test.ts +63 -63
  212. package/src/server/__tests__/external-rag-search.test.ts +107 -107
  213. package/src/server/__tests__/harness-capabilities.test.ts +88 -0
  214. package/src/server/__tests__/harness-compiler.test.ts +278 -214
  215. package/src/server/__tests__/harness-profile-service.test.ts +167 -167
  216. package/src/server/__tests__/harness-runtime-policy.test.ts +293 -293
  217. package/src/server/__tests__/harness-tool-plan.test.ts +175 -172
  218. package/src/server/__tests__/hierarchical-routing.integration.test.ts +2318 -0
  219. package/src/server/__tests__/hierarchy-invocation-journal.integration.test.ts +119 -0
  220. package/src/server/__tests__/input-schema-validator.test.ts +26 -26
  221. package/src/server/__tests__/loop-approval-decision.test.ts +624 -512
  222. package/src/server/__tests__/loop-approval-expiry.test.ts +258 -258
  223. package/src/server/__tests__/loop-budget-service.test.ts +29 -0
  224. package/src/server/__tests__/loop-pattern-schema.test.ts +73 -73
  225. package/src/server/__tests__/loop-run-repository.test.ts +25 -0
  226. package/src/server/__tests__/loop-run-state-machine.test.ts +101 -101
  227. package/src/server/__tests__/loop-trigger-service.test.ts +185 -148
  228. package/src/server/__tests__/loop-worker-claim.test.ts +110 -10
  229. package/src/server/__tests__/loop-worker-execution.test.ts +375 -317
  230. package/src/server/__tests__/native-agent-monitor-sync.test.ts +343 -0
  231. package/src/server/__tests__/native-hierarchy-probe.integration.test.ts +527 -0
  232. package/src/server/__tests__/native-sub-agent-observer.test.ts +463 -662
  233. package/src/server/__tests__/native-usage-attribution.integration.test.ts +168 -0
  234. package/src/server/__tests__/plugin-ai-runtime-adapter.test.ts +403 -0
  235. package/src/server/__tests__/registry-node-package.test.ts +299 -0
  236. package/src/server/__tests__/routing-binding-graph.integration.test.ts +217 -0
  237. package/src/server/__tests__/routing-binding-validation.test.ts +256 -0
  238. package/src/server/__tests__/session-auto-approval.integration.test.ts +329 -0
  239. package/src/server/__tests__/skill-access-service.test.ts +64 -64
  240. package/src/server/__tests__/skill-execute.test.ts +81 -70
  241. package/src/server/__tests__/skill-execution-task-policy.test.ts +140 -140
  242. package/src/server/__tests__/skill-review-guard.test.ts +171 -0
  243. package/src/server/__tests__/skill-sandbox-worker-mode.test.ts +15 -15
  244. package/src/server/__tests__/skill-settings.test.ts +63 -63
  245. package/src/server/__tests__/skill-tool-name.test.ts +23 -23
  246. package/src/server/__tests__/token-tracker.test.ts +632 -0
  247. package/src/server/__tests__/tool-loop-detection.test.ts +276 -276
  248. package/src/server/__tests__/tracing-retention-policy.test.ts +30 -0
  249. package/src/server/__tests__/usage-ledger.integration.test.ts +187 -0
  250. package/src/server/collections/agent-auto-approval-checkpoints.ts +18 -0
  251. package/src/server/collections/agent-execution-spans.ts +386 -245
  252. package/src/server/collections/agent-governance-audit-events.ts +19 -0
  253. package/src/server/collections/agent-governance-policies.ts +19 -0
  254. package/src/server/collections/agent-governance-policy-versions.ts +20 -0
  255. package/src/server/collections/agent-governance-prompt-bindings.ts +22 -0
  256. package/src/server/collections/agent-hierarchy-invocations.ts +30 -0
  257. package/src/server/collections/agent-loop-action-approvals.ts +39 -39
  258. package/src/server/collections/agent-loop-runs.ts +389 -369
  259. package/src/server/collections/agent-loop-steps.ts +220 -220
  260. package/src/server/collections/agent-memory-contexts.ts +95 -95
  261. package/src/server/collections/agent-routing-graph-locks.ts +11 -0
  262. package/src/server/collections/agent-session-auto-approvals.ts +16 -0
  263. package/src/server/collections/orchestrator-config.ts +113 -87
  264. package/src/server/collections/orchestrator-logs.ts +116 -116
  265. package/src/server/collections/skill-definitions.ts +159 -159
  266. package/src/server/collections/skill-executions.ts +154 -154
  267. package/src/server/collections/skill-loop-configs.ts +65 -65
  268. package/src/server/collections/skill-metrics.ts +36 -36
  269. package/src/server/collections/skill-registry-installations.ts +41 -41
  270. package/src/server/collections/skill-worker-configs.ts +86 -86
  271. package/src/server/index.ts +1 -1
  272. package/src/server/migrations/20260423000000-add-progress-fields.ts +50 -50
  273. package/src/server/migrations/20260425000000-add-interaction-schema.ts +37 -37
  274. package/src/server/migrations/20260427000000-add-tracing-detail-fields.ts +41 -41
  275. package/src/server/migrations/20260427000001-change-other-json-to-text.ts +61 -61
  276. package/src/server/migrations/20260524001000-add-plan-approval-and-harness-profiles.ts +145 -145
  277. package/src/server/migrations/20260601000000-add-token-fields.ts +89 -89
  278. package/src/server/migrations/20260615000000-normalize-ai-employee-tool-bindings.ts +39 -39
  279. package/src/server/migrations/20260621000000-native-policy-profile-defaults.ts +190 -190
  280. package/src/server/migrations/20260727000000-remove-unused-knowledge-scopes.ts +25 -25
  281. package/src/server/migrations/20260727010000-backfill-skill-tool-names.ts +45 -45
  282. package/src/server/migrations/20261110000000-add-usage-pricing-snapshots.ts +110 -0
  283. package/src/server/migrations/20261110010000-add-usage-department-attribution.ts +28 -0
  284. package/src/server/migrations/20261119000000-widen-native-employee-identifiers.ts +37 -0
  285. package/src/server/plugin.ts +724 -573
  286. package/src/server/resources/agent-auto-approval.ts +51 -0
  287. package/src/server/resources/agent-governance.ts +161 -0
  288. package/src/server/resources/agent-harness-profile.ts +103 -94
  289. package/src/server/resources/agent-knowledge-insights.ts +306 -306
  290. package/src/server/resources/agent-loop-approval.ts +84 -84
  291. package/src/server/resources/agent-loop-events-stream.ts +108 -108
  292. package/src/server/resources/agent-loop.ts +252 -252
  293. package/src/server/resources/agent-monitor.ts +208 -482
  294. package/src/server/resources/agent-usage.ts +413 -0
  295. package/src/server/resources/hierarchical-routing.ts +39 -0
  296. package/src/server/resources/native-monitor-format.ts +150 -0
  297. package/src/server/resources/tracing.ts +296 -267
  298. package/src/server/services/AgentExecutionContext.ts +23 -23
  299. package/src/server/services/AgentGovernanceService.ts +541 -0
  300. package/src/server/services/AgentMemoryContextService.ts +344 -344
  301. package/src/server/services/AgentRegistryService.ts +220 -220
  302. package/src/server/services/AgentRuntimeLifecycle.ts +64 -64
  303. package/src/server/services/AutoApprovalCheckpoint.ts +140 -0
  304. package/src/server/services/CodeValidator.ts +257 -238
  305. package/src/server/services/DepartmentAttribution.ts +47 -0
  306. package/src/server/services/DurableCircuitBreakerService.ts +235 -235
  307. package/src/server/services/ExecutionSpanService.ts +271 -146
  308. package/src/server/services/FileManager.ts +159 -159
  309. package/src/server/services/GovernanceAdmission.ts +314 -0
  310. package/src/server/services/HarnessCapabilities.ts +112 -0
  311. package/src/server/services/HarnessCompiler.ts +182 -170
  312. package/src/server/services/HarnessProfileService.ts +235 -235
  313. package/src/server/services/HarnessSchema.ts +224 -194
  314. package/src/server/services/HierarchicalAgentRuntime.ts +1052 -0
  315. package/src/server/services/HierarchyEnrollmentGuard.ts +211 -0
  316. package/src/server/services/HierarchyInvocationJournal.ts +172 -0
  317. package/src/server/services/HierarchyRequestCancellation.ts +132 -0
  318. package/src/server/services/InputSchemaValidator.ts +44 -44
  319. package/src/server/services/LoopBudgetService.ts +325 -271
  320. package/src/server/services/LoopControlService.ts +120 -120
  321. package/src/server/services/LoopPatternSchema.ts +231 -231
  322. package/src/server/services/LoopPatternService.ts +171 -171
  323. package/src/server/services/LoopRunRepository.ts +343 -332
  324. package/src/server/services/LoopRunStateMachine.ts +538 -525
  325. package/src/server/services/LoopSchedulerService.ts +195 -195
  326. package/src/server/services/LoopTriggerService.ts +162 -159
  327. package/src/server/services/LoopWorkerService.ts +975 -912
  328. package/src/server/services/ManagedPromptProtection.ts +81 -0
  329. package/src/server/services/NativeAgentMonitorSyncService.ts +684 -0
  330. package/src/server/services/NativeSubAgentObserver.ts +324 -757
  331. package/src/server/services/NativeUsageAttribution.ts +91 -0
  332. package/src/server/services/PathLockService.ts +317 -317
  333. package/src/server/services/PluginAiRuntimeAdapter.ts +518 -387
  334. package/src/server/services/RoutingBindingRepository.ts +146 -0
  335. package/src/server/services/RoutingBindingValidation.ts +161 -0
  336. package/src/server/services/RunEventBus.ts +58 -58
  337. package/src/server/services/SandboxRunner.ts +526 -492
  338. package/src/server/services/SessionAutoApproval.ts +167 -0
  339. package/src/server/services/SkillAccessService.ts +175 -175
  340. package/src/server/services/SkillManager.ts +585 -585
  341. package/src/server/services/SkillRepositoryService.ts +236 -236
  342. package/src/server/services/TokenTracker.ts +1151 -287
  343. package/src/server/services/ToolLoopDetectionService.ts +210 -210
  344. package/src/server/services/TracingRetentionPolicy.ts +49 -0
  345. package/src/server/services/VerificationSchema.ts +31 -31
  346. package/src/server/services/VerificationService.ts +325 -313
  347. package/src/server/services/WorkerEnvManager.ts +198 -198
  348. package/src/server/services/__tests__/SkillRepositoryService.test.ts +33 -33
  349. package/src/server/services/harness-runtime-policy.ts +134 -134
  350. package/src/server/services/pythonGuardTemplate.ts +87 -87
  351. package/src/server/services/sandboxCapabilities.ts +348 -348
  352. package/src/server/skill-hub/actions/__tests__/git-import.test.ts +563 -563
  353. package/src/server/skill-hub/actions/git-import.ts +936 -936
  354. package/src/server/skill-hub/mcp/McpController.ts +107 -107
  355. package/src/server/skill-hub/middlewares/git-import-request-method-policy.ts +51 -51
  356. package/src/server/skill-hub/plugin.ts +1272 -1232
  357. package/src/server/skill-hub/sandbox-config.json +6 -6
  358. package/src/server/skill-hub/services/RegistrySkillInstallationService.ts +291 -281
  359. package/src/server/skill-hub/services/__tests__/RegistrySkillInstallationService.test.ts +295 -295
  360. package/src/server/skill-hub/services/registry-node-package.ts +191 -0
  361. package/src/server/skill-hub/tasks/SkillExecutionTask.ts +597 -568
  362. package/src/server/skill-hub/utils/json-fields.ts +57 -57
  363. package/src/server/tools/delegate-task.ts +30 -30
  364. package/src/server/tools/external-rag-search.ts +329 -329
  365. package/src/server/tools/skill-execute.ts +226 -216
  366. package/src/server/types.ts +21 -21
  367. package/src/server/utils/ai-manager.ts +24 -24
  368. package/src/server/utils/ctx-utils.ts +132 -132
  369. package/src/server/utils/ensure-indexes.ts +113 -96
  370. package/src/server/utils/ha-lock.ts +80 -80
  371. package/src/server/utils/loop-pattern-context.ts +84 -84
  372. package/src/server/utils/record-utils.ts +19 -19
  373. package/src/server/utils/skill-settings.ts +135 -135
  374. package/src/server/utils/skill-tool-name.ts +58 -58
  375. package/dist/client-v2/117.7565cff57c39318a.js +0 -10
  376. package/dist/client-v2/214.106635011859dede.js +0 -10
  377. package/dist/client-v2/253.59577b40d9875be0.js +0 -10
  378. package/dist/client-v2/264.7ed8bee71fa5935c.js +0 -10
  379. package/dist/client-v2/418.41ed200e7d6da332.js +0 -10
  380. package/dist/client-v2/794.a67a2614405ba627.js +0 -10
  381. package/dist/client-v2/981.e4a1f41cfc94a856.js +0 -10
  382. package/dist/client-v2/993.b0688fdc5ccb000a.js +0 -10
  383. package/dist/node_modules/simple-git/dist/cjs/index.js +0 -7399
  384. package/dist/node_modules/simple-git/dist/esm/index.js +0 -4745
  385. package/dist/node_modules/simple-git/dist/esm/package.json +0 -3
  386. package/dist/node_modules/simple-git/dist/src/lib/api.d.ts +0 -13
  387. package/dist/node_modules/simple-git/dist/src/lib/args/log-format.d.ts +0 -9
  388. package/dist/node_modules/simple-git/dist/src/lib/errors/git-construct-error.d.ts +0 -15
  389. package/dist/node_modules/simple-git/dist/src/lib/errors/git-error.d.ts +0 -30
  390. package/dist/node_modules/simple-git/dist/src/lib/errors/git-plugin-error.d.ts +0 -7
  391. package/dist/node_modules/simple-git/dist/src/lib/errors/git-response-error.d.ts +0 -32
  392. package/dist/node_modules/simple-git/dist/src/lib/errors/task-configuration-error.d.ts +0 -12
  393. package/dist/node_modules/simple-git/dist/src/lib/git-factory.d.ts +0 -15
  394. package/dist/node_modules/simple-git/dist/src/lib/git-logger.d.ts +0 -21
  395. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-branch-delete.d.ts +0 -5
  396. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-branch.d.ts +0 -2
  397. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-commit.d.ts +0 -2
  398. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-diff-summary.d.ts +0 -3
  399. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-fetch.d.ts +0 -2
  400. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-list-log-summary.d.ts +0 -6
  401. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-merge.d.ts +0 -11
  402. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-move.d.ts +0 -2
  403. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-pull.d.ts +0 -6
  404. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-push.d.ts +0 -4
  405. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-remote-messages.d.ts +0 -5
  406. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-remote-objects.d.ts +0 -3
  407. package/dist/node_modules/simple-git/dist/src/lib/plugins/abort-plugin.d.ts +0 -3
  408. package/dist/node_modules/simple-git/dist/src/lib/plugins/block-unsafe-operations-plugin.d.ts +0 -3
  409. package/dist/node_modules/simple-git/dist/src/lib/plugins/command-config-prefixing-plugin.d.ts +0 -2
  410. package/dist/node_modules/simple-git/dist/src/lib/plugins/completion-detection.plugin.d.ts +0 -3
  411. package/dist/node_modules/simple-git/dist/src/lib/plugins/custom-binary.plugin.d.ts +0 -3
  412. package/dist/node_modules/simple-git/dist/src/lib/plugins/error-detection.plugin.d.ts +0 -7
  413. package/dist/node_modules/simple-git/dist/src/lib/plugins/index.d.ts +0 -11
  414. package/dist/node_modules/simple-git/dist/src/lib/plugins/plugin-store.d.ts +0 -11
  415. package/dist/node_modules/simple-git/dist/src/lib/plugins/progress-monitor-plugin.d.ts +0 -3
  416. package/dist/node_modules/simple-git/dist/src/lib/plugins/simple-git-plugin.d.ts +0 -48
  417. package/dist/node_modules/simple-git/dist/src/lib/plugins/spawn-options-plugin.d.ts +0 -3
  418. package/dist/node_modules/simple-git/dist/src/lib/plugins/suffix-paths.plugin.d.ts +0 -2
  419. package/dist/node_modules/simple-git/dist/src/lib/plugins/timout-plugin.d.ts +0 -3
  420. package/dist/node_modules/simple-git/dist/src/lib/responses/BranchDeleteSummary.d.ts +0 -12
  421. package/dist/node_modules/simple-git/dist/src/lib/responses/BranchSummary.d.ts +0 -14
  422. package/dist/node_modules/simple-git/dist/src/lib/responses/CheckIgnore.d.ts +0 -4
  423. package/dist/node_modules/simple-git/dist/src/lib/responses/CleanSummary.d.ts +0 -9
  424. package/dist/node_modules/simple-git/dist/src/lib/responses/ConfigList.d.ts +0 -13
  425. package/dist/node_modules/simple-git/dist/src/lib/responses/DiffSummary.d.ts +0 -10
  426. package/dist/node_modules/simple-git/dist/src/lib/responses/FileStatusSummary.d.ts +0 -9
  427. package/dist/node_modules/simple-git/dist/src/lib/responses/GetRemoteSummary.d.ts +0 -11
  428. package/dist/node_modules/simple-git/dist/src/lib/responses/InitSummary.d.ts +0 -9
  429. package/dist/node_modules/simple-git/dist/src/lib/responses/MergeSummary.d.ts +0 -16
  430. package/dist/node_modules/simple-git/dist/src/lib/responses/PullSummary.d.ts +0 -25
  431. package/dist/node_modules/simple-git/dist/src/lib/responses/StatusSummary.d.ts +0 -19
  432. package/dist/node_modules/simple-git/dist/src/lib/responses/TagList.d.ts +0 -7
  433. package/dist/node_modules/simple-git/dist/src/lib/runners/git-executor-chain.d.ts +0 -25
  434. package/dist/node_modules/simple-git/dist/src/lib/runners/git-executor.d.ts +0 -14
  435. package/dist/node_modules/simple-git/dist/src/lib/runners/promise-wrapped.d.ts +0 -2
  436. package/dist/node_modules/simple-git/dist/src/lib/runners/scheduler.d.ts +0 -11
  437. package/dist/node_modules/simple-git/dist/src/lib/runners/tasks-pending-queue.d.ts +0 -23
  438. package/dist/node_modules/simple-git/dist/src/lib/simple-git-api.d.ts +0 -20
  439. package/dist/node_modules/simple-git/dist/src/lib/task-callback.d.ts +0 -2
  440. package/dist/node_modules/simple-git/dist/src/lib/tasks/apply-patch.d.ts +0 -3
  441. package/dist/node_modules/simple-git/dist/src/lib/tasks/branch.d.ts +0 -7
  442. package/dist/node_modules/simple-git/dist/src/lib/tasks/change-working-directory.d.ts +0 -2
  443. package/dist/node_modules/simple-git/dist/src/lib/tasks/check-ignore.d.ts +0 -2
  444. package/dist/node_modules/simple-git/dist/src/lib/tasks/check-is-repo.d.ts +0 -9
  445. package/dist/node_modules/simple-git/dist/src/lib/tasks/checkout.d.ts +0 -2
  446. package/dist/node_modules/simple-git/dist/src/lib/tasks/clean.d.ts +0 -25
  447. package/dist/node_modules/simple-git/dist/src/lib/tasks/clone.d.ts +0 -9
  448. package/dist/node_modules/simple-git/dist/src/lib/tasks/commit.d.ts +0 -4
  449. package/dist/node_modules/simple-git/dist/src/lib/tasks/config.d.ts +0 -8
  450. package/dist/node_modules/simple-git/dist/src/lib/tasks/count-objects.d.ts +0 -12
  451. package/dist/node_modules/simple-git/dist/src/lib/tasks/diff-name-status.d.ts +0 -12
  452. package/dist/node_modules/simple-git/dist/src/lib/tasks/diff.d.ts +0 -5
  453. package/dist/node_modules/simple-git/dist/src/lib/tasks/fetch.d.ts +0 -4
  454. package/dist/node_modules/simple-git/dist/src/lib/tasks/first-commit.d.ts +0 -2
  455. package/dist/node_modules/simple-git/dist/src/lib/tasks/grep.d.ts +0 -12
  456. package/dist/node_modules/simple-git/dist/src/lib/tasks/hash-object.d.ts +0 -5
  457. package/dist/node_modules/simple-git/dist/src/lib/tasks/init.d.ts +0 -3
  458. package/dist/node_modules/simple-git/dist/src/lib/tasks/log.d.ts +0 -32
  459. package/dist/node_modules/simple-git/dist/src/lib/tasks/merge.d.ts +0 -4
  460. package/dist/node_modules/simple-git/dist/src/lib/tasks/move.d.ts +0 -3
  461. package/dist/node_modules/simple-git/dist/src/lib/tasks/pull.d.ts +0 -3
  462. package/dist/node_modules/simple-git/dist/src/lib/tasks/push.d.ts +0 -9
  463. package/dist/node_modules/simple-git/dist/src/lib/tasks/remote.d.ts +0 -8
  464. package/dist/node_modules/simple-git/dist/src/lib/tasks/reset.d.ts +0 -11
  465. package/dist/node_modules/simple-git/dist/src/lib/tasks/show.d.ts +0 -2
  466. package/dist/node_modules/simple-git/dist/src/lib/tasks/stash-list.d.ts +0 -4
  467. package/dist/node_modules/simple-git/dist/src/lib/tasks/status.d.ts +0 -3
  468. package/dist/node_modules/simple-git/dist/src/lib/tasks/sub-module.d.ts +0 -5
  469. package/dist/node_modules/simple-git/dist/src/lib/tasks/tag.d.ts +0 -18
  470. package/dist/node_modules/simple-git/dist/src/lib/tasks/task.d.ts +0 -14
  471. package/dist/node_modules/simple-git/dist/src/lib/tasks/version.d.ts +0 -9
  472. package/dist/node_modules/simple-git/dist/src/lib/types/handlers.d.ts +0 -21
  473. package/dist/node_modules/simple-git/dist/src/lib/types/index.d.ts +0 -136
  474. package/dist/node_modules/simple-git/dist/src/lib/types/tasks.d.ts +0 -19
  475. package/dist/node_modules/simple-git/dist/src/lib/utils/argument-filters.d.ts +0 -14
  476. package/dist/node_modules/simple-git/dist/src/lib/utils/exit-codes.d.ts +0 -10
  477. package/dist/node_modules/simple-git/dist/src/lib/utils/git-output-streams.d.ts +0 -7
  478. package/dist/node_modules/simple-git/dist/src/lib/utils/index.d.ts +0 -8
  479. package/dist/node_modules/simple-git/dist/src/lib/utils/line-parser.d.ts +0 -15
  480. package/dist/node_modules/simple-git/dist/src/lib/utils/simple-git-options.d.ts +0 -2
  481. package/dist/node_modules/simple-git/dist/src/lib/utils/task-options.d.ts +0 -13
  482. package/dist/node_modules/simple-git/dist/src/lib/utils/task-parser.d.ts +0 -5
  483. package/dist/node_modules/simple-git/dist/src/lib/utils/util.d.ts +0 -47
  484. package/dist/node_modules/simple-git/dist/typings/errors.d.ts +0 -5
  485. package/dist/node_modules/simple-git/dist/typings/index.d.ts +0 -14
  486. package/dist/node_modules/simple-git/dist/typings/response.d.ts +0 -556
  487. package/dist/node_modules/simple-git/dist/typings/simple-git.d.ts +0 -1033
  488. package/dist/node_modules/simple-git/dist/typings/types.d.ts +0 -22
  489. package/dist/node_modules/simple-git/node_modules/debug/package.json +0 -64
  490. package/dist/node_modules/simple-git/node_modules/debug/src/browser.js +0 -272
  491. package/dist/node_modules/simple-git/node_modules/debug/src/common.js +0 -292
  492. package/dist/node_modules/simple-git/node_modules/debug/src/index.js +0 -10
  493. package/dist/node_modules/simple-git/node_modules/debug/src/node.js +0 -263
  494. package/dist/node_modules/simple-git/package.json +0 -1
  495. package/dist/node_modules/simple-git/promise.js +0 -17
@@ -0,0 +1,211 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+
3
+ import type { Context, Next } from '@nocobase/actions';
4
+ import type { Model } from '@nocobase/database';
5
+ import type PluginAIServer from '@nocobase/plugin-ai/server';
6
+ import { listSystemTools } from '@nocobase/ai';
7
+ import { getAIToolsManager } from '../utils/ai-manager';
8
+ import { asRecord, read } from '../utils/record-utils';
9
+ import { HarnessProfileService } from './HarnessProfileService';
10
+ import { sessionAutoApprovalEnabled } from './SessionAutoApproval';
11
+
12
+ function names(value: unknown): string[] {
13
+ if (!Array.isArray(value)) return [];
14
+ return value
15
+ .map((item) => (typeof item === 'string' ? item : asRecord(item).name))
16
+ .filter((item): item is string => typeof item === 'string' && item.length > 0);
17
+ }
18
+
19
+ /** Managed children must only execute through the restricted hierarchy runtime. */
20
+ export async function guardManagedChildActions(ctx: Context, next: Next) {
21
+ const action = ctx.action;
22
+ if (action?.resourceName !== 'aiConversations') return next();
23
+ const sessionActions = [
24
+ 'sendMessages',
25
+ 'resendMessages',
26
+ 'resumeToolCall',
27
+ 'updateUserDecision',
28
+ 'updateToolArgs',
29
+ 'updateOptions',
30
+ 'abort',
31
+ ];
32
+ if (!sessionActions.includes(action.actionName)) return next();
33
+ const userId = ctx.auth?.user?.id;
34
+ const values = action.params?.values ?? {};
35
+ if (typeof values !== 'object' || Array.isArray(values)) {
36
+ return ctx.throw(400, ctx.t('Invalid conversation action input.'));
37
+ }
38
+ const id = action.actionName === 'updateOptions' ? action.params?.filterByTk : values.sessionId;
39
+ if (typeof id !== 'string' || !id.trim()) {
40
+ return ctx.throw(400, ctx.t('A single conversation identifier is required.'));
41
+ }
42
+ const messageActions = ['sendMessages', 'resendMessages', 'resumeToolCall', 'updateUserDecision', 'updateToolArgs'];
43
+ const messageId = action.actionName === 'sendMessages' ? values.editingMessageId : values.messageId;
44
+ const messageRequired = ['updateUserDecision', 'updateToolArgs'].includes(action.actionName);
45
+ const messageAbsent = messageId == null || messageId === '';
46
+ const validMessage =
47
+ (typeof messageId === 'string' && Boolean(messageId.trim())) ||
48
+ (typeof messageId === 'number' && Number.isSafeInteger(messageId) && messageId > 0);
49
+ if (
50
+ messageActions.includes(action.actionName) &&
51
+ ((messageRequired && messageAbsent) || (!messageAbsent && !validMessage))
52
+ ) {
53
+ return ctx.throw(400, ctx.t('A single message identifier is required.'));
54
+ }
55
+ if (
56
+ action.actionName === 'updateUserDecision' &&
57
+ (typeof values.toolCallId !== 'string' || !values.toolCallId.trim())
58
+ ) {
59
+ return ctx.throw(400, ctx.t('A single tool call identifier is required.'));
60
+ }
61
+ if (action.actionName === 'updateToolArgs' && (typeof values.tool?.id !== 'string' || !values.tool.id.trim())) {
62
+ return ctx.throw(400, ctx.t('A single tool call identifier is required.'));
63
+ }
64
+ if (!userId) return next();
65
+
66
+ const conversations = ctx.db.getRepository('aiConversations');
67
+ const conversation = await conversations.findOne({ filter: { sessionId: id, userId } });
68
+ if (!conversation) return next();
69
+ const isManagedChild = async (record: Model) => {
70
+ if (read(record, 'from') !== 'sub-agent') return false;
71
+ const childSessionId = read(record, 'sessionId');
72
+ const options = asRecord(read(record, 'options'));
73
+ // The marker also covers a crash between creating the child and attaching it to the journal.
74
+ if (typeof options.hierarchyRootSessionId === 'string' && typeof options.hierarchyParentSessionId === 'string') {
75
+ return Boolean(options.hierarchyRootSessionId && options.hierarchyParentSessionId);
76
+ }
77
+ const invocation = await ctx.db.getRepository('agentHierarchyInvocations').findOne({
78
+ filter: { childSessionId, ownerId: userId },
79
+ });
80
+ return Boolean(invocation);
81
+ };
82
+ if (await isManagedChild(conversation)) {
83
+ return ctx.throw(403, ctx.t('Managed child conversations cannot be modified directly.'));
84
+ }
85
+ if (messageActions.includes(action.actionName) && messageId) {
86
+ const message = await ctx.db.getRepository('aiMessages').findOne({ filter: { messageId } });
87
+ const messageSessionId = read(message, 'sessionId');
88
+ if (typeof messageSessionId === 'string' && messageSessionId !== id) {
89
+ const messageConversation = await conversations.findOne({ filter: { sessionId: messageSessionId, userId } });
90
+ if (messageConversation && (await isManagedChild(messageConversation))) {
91
+ return ctx.throw(403, ctx.t('Managed child conversations cannot be modified directly.'));
92
+ }
93
+ }
94
+ }
95
+ return next();
96
+ }
97
+
98
+ /**
99
+ * Enrollment applies only to employees with an explicitly enabled hierarchy binding.
100
+ * Native tools bypass the managed routing policy, so refuse a configuration where
101
+ * the root could directly call a managed worker tool or native employee dispatch.
102
+ */
103
+ export async function guardHierarchyEnrollment(ctx: Context, next: Next) {
104
+ const action = ctx.action;
105
+ if (
106
+ action?.resourceName !== 'aiConversations' ||
107
+ !['sendMessages', 'resendMessages', 'resumeToolCall'].includes(action.actionName)
108
+ ) {
109
+ return next();
110
+ }
111
+ const userId = ctx.auth?.user?.id;
112
+ const values = action.params?.values ?? {};
113
+ const sessionId = typeof values.sessionId === 'string' ? values.sessionId : '';
114
+ if (!userId || !sessionId) return next();
115
+ const conversation = await ctx.db.getRepository('aiConversations').findOne({ filter: { sessionId, userId } });
116
+ if (!conversation || read(conversation, 'from') === 'sub-agent') return next();
117
+ const storedUsername = read(conversation, 'aiEmployeeUsername');
118
+ const requested = typeof values.aiEmployee === 'string' ? values.aiEmployee : storedUsername;
119
+ if (typeof requested !== 'string' || !requested) return next();
120
+ const roots = await ctx.db.getRepository('orchestratorConfig').find({
121
+ filter: { leaderUsername: requested, enabled: true, routingEnabled: true, routingRole: 'specialist' },
122
+ });
123
+ if (!roots.length) return next();
124
+ if (requested !== storedUsername) return ctx.throw(403, ctx.t('The employee does not match the conversation.'));
125
+ const employee = await ctx.db.getRepository('aiEmployees').findOne({ filter: { username: requested } });
126
+ if (!employee) return ctx.throw(403, ctx.t('The AI employee is unavailable.'));
127
+ const settings = asRecord(read(employee, 'skillSettings'));
128
+ const options = asRecord(read(conversation, 'options'));
129
+ const configuredTools = new Set([...names(settings.tools), ...names(options.tools)]);
130
+ const profiles = new HarnessProfileService(ctx.db);
131
+ const workerTools = new Set<string>();
132
+ const autoApprove = await sessionAutoApprovalEnabled(ctx, sessionId);
133
+ for (const root of roots as Model[]) {
134
+ const specialist = read(root, 'subAgentUsername');
135
+ const workerBindings = await ctx.db.getRepository('orchestratorConfig').find({
136
+ filter: { leaderUsername: specialist, enabled: true, routingEnabled: true, routingRole: 'worker' },
137
+ });
138
+ for (const binding of workerBindings as Model[]) {
139
+ const tag = typeof read(binding, 'harnessTag') === 'string' ? String(read(binding, 'harnessTag')) : 'default';
140
+ const profile = await profiles.getPublishedByTag(tag);
141
+ if (!profile) return ctx.throw(403, ctx.t('The delegation policy profile is unavailable.'));
142
+ for (const name of profile.settings.tools.allow) workerTools.add(name);
143
+ if (autoApprove) for (const name of profile.settings.tools.ask) workerTools.add(name);
144
+ }
145
+ }
146
+ const generalTools = await getAIToolsManager(ctx.app).listTools({ scope: 'GENERAL', ctx, sessionId });
147
+ for (const tool of generalTools as Array<{ definition?: { name?: string } }>) {
148
+ if (tool.definition?.name) configuredTools.add(tool.definition.name);
149
+ }
150
+ const conversationSettings = asRecord(options.skillSettings);
151
+ const toolFilter = names(conversationSettings.tools);
152
+ const hasToolFilter =
153
+ Array.isArray(conversationSettings.tools) && (Boolean(conversationSettings.toolsVersion) || toolFilter.length > 0);
154
+ if (hasToolFilter) {
155
+ const systemTools = new Set(listSystemTools());
156
+ for (const name of configuredTools) {
157
+ if (!systemTools.has(name) && !toolFilter.includes(name)) configuredTools.delete(name);
158
+ }
159
+ }
160
+ const chatSettings = asRecord(read(employee, 'chatSettings'));
161
+ const ai = ctx.app.pm.get('ai') as PluginAIServer | undefined;
162
+ if (!ai?.ai?.skillsManager) return ctx.throw(403, ctx.t('The AI employee skills are unavailable.'));
163
+ const skillsManager = ai.ai.skillsManager;
164
+ if (chatSettings.enableSkills !== false) {
165
+ const general = await skillsManager.listSkills({ scope: 'GENERAL' });
166
+ const selected = names(settings.skills);
167
+ const specified = selected.length ? await skillsManager.getSkills(selected) : [];
168
+ const skillFilter = names(conversationSettings.skills);
169
+ const hasSkillFilter =
170
+ Array.isArray(conversationSettings.skills) &&
171
+ (Boolean(conversationSettings.skillsVersion) || skillFilter.length > 0);
172
+ for (const skill of [...general, ...specified]) {
173
+ if (hasSkillFilter && !skillFilter.includes(skill.name)) continue;
174
+ for (const name of names(skill.tools)) configuredTools.add(name);
175
+ }
176
+ }
177
+ // Native middleware also honours skills loaded earlier in this session, even after
178
+ // the employee's current skill list changes.
179
+ const loaded = await ctx.db.getRepository('aiToolMessages').find({
180
+ filter: { sessionId, toolName: 'getSkill', status: 'success' },
181
+ });
182
+ const loadedNames = new Set<string>();
183
+ for (const call of loaded as Model[]) {
184
+ let content = read(call, 'content');
185
+ if (typeof content === 'string') {
186
+ try {
187
+ content = JSON.parse(content);
188
+ } catch {
189
+ continue;
190
+ }
191
+ }
192
+ const name = asRecord(content).skillName;
193
+ if (typeof name === 'string' && name) loadedNames.add(name);
194
+ }
195
+ if (loadedNames.size) {
196
+ const loadedSkills = await skillsManager.getSkills([...loadedNames]);
197
+ for (const skill of loadedSkills) {
198
+ for (const name of names(skill.tools)) configuredTools.add(name);
199
+ }
200
+ }
201
+ if (configuredTools.has('dispatch-sub-agent-task')) {
202
+ return ctx.throw(403, ctx.t('Disable native AI employee dispatch before using managed hierarchy routing.'));
203
+ }
204
+ if ([...workerTools].some((name) => configuredTools.has(name))) {
205
+ return ctx.throw(
206
+ 403,
207
+ ctx.t('Remove managed worker tools from the parent employee before using hierarchy routing.'),
208
+ );
209
+ }
210
+ return next();
211
+ }
@@ -0,0 +1,172 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+ import { createHash, randomUUID } from 'node:crypto';
3
+ import type { Database, Model } from '@nocobase/database';
4
+ import { read } from '../utils/record-utils';
5
+
6
+ export type HierarchyInvocationKey = {
7
+ ownerId: number;
8
+ parentSessionId: string;
9
+ parentToolCallId: string;
10
+ };
11
+
12
+ export type HierarchySnapshot = {
13
+ profileTag: string;
14
+ profileVersion: number;
15
+ profileVersionId: number;
16
+ policy: unknown;
17
+ model: { llmService: string; model: string };
18
+ provider?: string;
19
+ ancestors: string[];
20
+ bindingTimeout?: number;
21
+ bindingMaxDepth?: number;
22
+ };
23
+
24
+ export type ReserveHierarchyInvocation = HierarchyInvocationKey & {
25
+ rootSessionId: string;
26
+ parentEmployee: string;
27
+ employeeUsername: string;
28
+ role: 'specialist' | 'worker';
29
+ question: string;
30
+ snapshot: HierarchySnapshot;
31
+ };
32
+
33
+ function digest(question: string) {
34
+ return createHash('sha256').update(question, 'utf8').digest('hex');
35
+ }
36
+
37
+ function requireKey(key: HierarchyInvocationKey) {
38
+ if (!Number.isSafeInteger(key.ownerId) || key.ownerId <= 0 || !key.parentSessionId || !key.parentToolCallId) {
39
+ throw new Error('Invalid hierarchy invocation identity.');
40
+ }
41
+ }
42
+
43
+ /** Store for hierarchy invocations. It never reclaims uncertain in-flight work. */
44
+ export class HierarchyInvocationJournal {
45
+ constructor(private readonly database: Database) {}
46
+
47
+ private async findOwned(key: HierarchyInvocationKey) {
48
+ requireKey(key);
49
+ const row = await this.database.getRepository('agentHierarchyInvocations').findOne({
50
+ filter: { parentSessionId: key.parentSessionId, parentToolCallId: key.parentToolCallId, ownerId: key.ownerId },
51
+ });
52
+ if (!row) throw new Error('The hierarchy invocation is unavailable.');
53
+ return row;
54
+ }
55
+
56
+ async get(key: HierarchyInvocationKey) {
57
+ return this.findOwned(key);
58
+ }
59
+
60
+ private assertSame(row: Model, input: ReserveHierarchyInvocation) {
61
+ if (
62
+ Number(read(row, 'ownerId')) !== input.ownerId ||
63
+ read(row, 'rootSessionId') !== input.rootSessionId ||
64
+ read(row, 'parentEmployee') !== input.parentEmployee ||
65
+ read(row, 'employeeUsername') !== input.employeeUsername ||
66
+ read(row, 'role') !== input.role ||
67
+ read(row, 'questionHash') !== digest(input.question)
68
+ ) {
69
+ throw new Error('The hierarchy invocation identity does not match the existing request.');
70
+ }
71
+ return row;
72
+ }
73
+
74
+ async reserve(input: ReserveHierarchyInvocation): Promise<Model> {
75
+ requireKey(input);
76
+ if (!input.rootSessionId || !input.parentEmployee || !input.employeeUsername || !input.question) {
77
+ throw new Error('Incomplete hierarchy invocation.');
78
+ }
79
+ try {
80
+ return await this.database.getRepository('agentHierarchyInvocations').create({
81
+ values: {
82
+ ownerId: input.ownerId,
83
+ rootSessionId: input.rootSessionId,
84
+ parentSessionId: input.parentSessionId,
85
+ parentToolCallId: input.parentToolCallId,
86
+ parentEmployee: input.parentEmployee,
87
+ employeeUsername: input.employeeUsername,
88
+ role: input.role,
89
+ questionHash: digest(input.question),
90
+ snapshot: input.snapshot,
91
+ status: 'reserved',
92
+ },
93
+ });
94
+ } catch (error) {
95
+ if (!(error instanceof Error) || error.name !== 'SequelizeUniqueConstraintError') throw error;
96
+ return this.assertSame(await this.findOwned(input), input);
97
+ }
98
+ }
99
+
100
+ async claim(key: HierarchyInvocationKey) {
101
+ const row = await this.findOwned(key);
102
+ const status = read(row, 'status');
103
+ if (status !== 'reserved') throw new Error('The hierarchy invocation is not ready.');
104
+ const token = randomUUID();
105
+ const [updated] = await this.database
106
+ .getModel('agentHierarchyInvocations')
107
+ .update(
108
+ { status: 'running', claimToken: token },
109
+ { where: { id: read(row, 'id'), ownerId: key.ownerId, status } },
110
+ );
111
+ if (updated !== 1) throw new Error('The hierarchy invocation was claimed by another request.');
112
+ return { row, token };
113
+ }
114
+
115
+ private async updateClaim(key: HierarchyInvocationKey, token: string, values: Record<string, unknown>) {
116
+ requireKey(key);
117
+ if (!token) throw new Error('A hierarchy claim is required.');
118
+ const [updated] = await this.database.getModel('agentHierarchyInvocations').update(values, {
119
+ where: {
120
+ parentSessionId: key.parentSessionId,
121
+ parentToolCallId: key.parentToolCallId,
122
+ ownerId: key.ownerId,
123
+ status: 'running',
124
+ claimToken: token,
125
+ },
126
+ });
127
+ if (updated !== 1) throw new Error('The hierarchy claim is no longer active.');
128
+ }
129
+
130
+ async attachChild(key: HierarchyInvocationKey, token: string, childSessionId: string) {
131
+ if (!childSessionId) throw new Error('A child session is required.');
132
+ await this.updateClaim(key, token, { childSessionId });
133
+ }
134
+
135
+ async complete(key: HierarchyInvocationKey, token: string, result: unknown, signal?: AbortSignal) {
136
+ if (signal?.aborted) throw new Error('The hierarchy invocation was cancelled.');
137
+ await this.updateClaim(key, token, { status: 'succeeded', claimToken: null, result });
138
+ if (signal?.aborted) {
139
+ await this.database.getModel('agentHierarchyInvocations').update(
140
+ { status: 'uncertain', result: null },
141
+ {
142
+ where: {
143
+ parentSessionId: key.parentSessionId,
144
+ parentToolCallId: key.parentToolCallId,
145
+ ownerId: key.ownerId,
146
+ status: 'succeeded',
147
+ },
148
+ },
149
+ );
150
+ throw new Error('The hierarchy invocation was cancelled.');
151
+ }
152
+ }
153
+
154
+ async markUncertain(key: HierarchyInvocationKey, token: string) {
155
+ await this.updateClaim(key, token, { status: 'uncertain', claimToken: null });
156
+ }
157
+
158
+ async invalidateCompleted(key: HierarchyInvocationKey) {
159
+ requireKey(key);
160
+ await this.database.getModel('agentHierarchyInvocations').update(
161
+ { status: 'uncertain', result: null },
162
+ {
163
+ where: {
164
+ parentSessionId: key.parentSessionId,
165
+ parentToolCallId: key.parentToolCallId,
166
+ ownerId: key.ownerId,
167
+ status: 'succeeded',
168
+ },
169
+ },
170
+ );
171
+ }
172
+ }
@@ -0,0 +1,132 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+
3
+ import type { Context, Next } from '@nocobase/actions';
4
+ import type { Plugin } from '@nocobase/server';
5
+ import { asRecord, read } from '../utils/record-utils';
6
+
7
+ type ActiveRequest = {
8
+ ownerId: string;
9
+ sessionId: string;
10
+ controller: AbortController;
11
+ removeNativeListener?: () => void;
12
+ };
13
+
14
+ // The actual request Context is the capability; clients cannot supply it in a tool call.
15
+ const contextRequests = new WeakMap<object, ActiveRequest>();
16
+
17
+ export function hierarchyRequestSignal(ctx: Context, nativeSignal?: AbortSignal): AbortSignal | undefined {
18
+ const request = contextRequests.get(ctx);
19
+ if (!request) return nativeSignal;
20
+ if (nativeSignal && !request.removeNativeListener) {
21
+ const abort = () => request.controller.abort();
22
+ if (nativeSignal.aborted) abort();
23
+ else {
24
+ nativeSignal.addEventListener('abort', abort, { once: true });
25
+ request.removeNativeListener = () => nativeSignal.removeEventListener('abort', abort);
26
+ }
27
+ }
28
+ return request.controller.signal;
29
+ }
30
+
31
+ export function hasHierarchyRequest(ctx: Context) {
32
+ return contextRequests.has(ctx);
33
+ }
34
+
35
+ /** Cancellation is scoped to this plugin instance, authenticated owner, session, and actual request. */
36
+ export class HierarchyRequestCancellation {
37
+ private readonly active = new Map<string, Set<ActiveRequest>>();
38
+
39
+ constructor(private readonly plugin: Plugin) {}
40
+
41
+ private cancel(ownerId: string, sessionId: string) {
42
+ for (const request of this.active.get(sessionId) ?? []) {
43
+ if (request.ownerId === ownerId) request.controller.abort();
44
+ }
45
+ }
46
+
47
+ async middleware(ctx: Context, next: Next) {
48
+ const action = ctx.action;
49
+ if (action?.resourceName !== 'aiConversations') return next();
50
+ const userId = ctx.auth?.user?.id;
51
+ const values = action.params?.values ?? {};
52
+ const sessionId = typeof values.sessionId === 'string' ? values.sessionId : '';
53
+ if (!userId || !sessionId) return next();
54
+ const isAbort = action.actionName === 'abort';
55
+ if (!isAbort && !['sendMessages', 'resendMessages', 'resumeToolCall'].includes(action.actionName)) return next();
56
+ const conversation = await ctx.db.getRepository('aiConversations').findOne({ filter: { sessionId, userId } });
57
+ if (!conversation || read(conversation, 'from') === 'sub-agent') return next();
58
+ const ownerId = String(userId);
59
+ const username = read(conversation, 'aiEmployeeUsername');
60
+ if (typeof username !== 'string' || !username) return next();
61
+ const binding = await ctx.db.getRepository('orchestratorConfig').findOne({
62
+ filter: { leaderUsername: username, enabled: true, routingEnabled: true, routingRole: 'specialist' },
63
+ });
64
+ if (isAbort) {
65
+ const locallyManaged = [...(this.active.get(sessionId) ?? [])].some((request) => request.ownerId === ownerId);
66
+ if (!binding && !locallyManaged) {
67
+ const recorded = await ctx.db.getRepository('agentHierarchyInvocations').findOne({
68
+ filter: { rootSessionId: sessionId, ownerId: userId },
69
+ });
70
+ if (!recorded) return next();
71
+ }
72
+ this.cancel(ownerId, sessionId);
73
+ try {
74
+ if (!this.plugin.name) throw new Error('Plugin name is unavailable.');
75
+ await this.plugin.app.syncMessageManager.publish(this.plugin.name, {
76
+ type: 'hierarchy:abort',
77
+ ownerId,
78
+ sessionId,
79
+ });
80
+ } catch {
81
+ try {
82
+ this.plugin.app.logger.warn('[AgentOrchestrator] Could not synchronize managed request cancellation.');
83
+ } catch {
84
+ // Logging must not prevent the native cancellation action.
85
+ }
86
+ }
87
+ return next();
88
+ }
89
+ if (!binding) return next();
90
+
91
+ const request: ActiveRequest = { ownerId, sessionId, controller: new AbortController() };
92
+ let requests = this.active.get(sessionId);
93
+ if (!requests) this.active.set(sessionId, (requests = new Set()));
94
+ requests.add(request);
95
+ contextRequests.set(ctx, request);
96
+ const cleanup = () => {
97
+ request.removeNativeListener?.();
98
+ if (contextRequests.get(ctx) === request) contextRequests.delete(ctx);
99
+ requests.delete(request);
100
+ if (!requests.size && this.active.get(sessionId) === requests) this.active.delete(sessionId);
101
+ };
102
+ // Resume is always SSE in native AI. Normal streaming keeps the host's SSE lifecycle.
103
+ const nonStreaming = action.actionName !== 'resumeToolCall' && values.stream === false;
104
+ try {
105
+ const result = await next();
106
+ if (nonStreaming && request.controller.signal.aborted) {
107
+ return ctx.throw(499, ctx.t('The managed request was cancelled.'));
108
+ }
109
+ return result;
110
+ } catch (error) {
111
+ if (nonStreaming && request.controller.signal.aborted) {
112
+ return ctx.throw(499, ctx.t('The managed request was cancelled.'));
113
+ }
114
+ throw error;
115
+ } finally {
116
+ cleanup();
117
+ }
118
+ }
119
+
120
+ handleSyncMessage(message: unknown) {
121
+ const value = asRecord(message);
122
+ if (value.type !== 'hierarchy:abort') return;
123
+ if (typeof value.ownerId !== 'string' || typeof value.sessionId !== 'string') return;
124
+ this.cancel(value.ownerId, value.sessionId);
125
+ }
126
+
127
+ abortAll() {
128
+ for (const requests of this.active.values()) {
129
+ for (const request of requests) request.controller.abort();
130
+ }
131
+ }
132
+ }
@@ -1,44 +1,44 @@
1
- import Ajv from 'ajv';
2
- import { parseJsonText } from '../skill-hub/utils/json-fields';
3
-
4
- type JsonSchema = Record<string, unknown> | boolean;
5
-
6
- const ajv = new Ajv({
7
- allErrors: true,
8
- jsonPointers: true,
9
- });
10
-
11
- function parseSchema(value: unknown): JsonSchema | null {
12
- if (value === undefined || value === null || value === '') return null;
13
- const schema = parseJsonText<unknown>(value, undefined);
14
- if (typeof schema === 'boolean') return schema;
15
- if (schema && typeof schema === 'object' && !Array.isArray(schema)) {
16
- return schema as Record<string, unknown>;
17
- }
18
- throw new Error('Input Schema must be a valid JSON Schema object.');
19
- }
20
-
21
- export function validateInputSchemaDefinition(value: unknown): void {
22
- const schema = parseSchema(value);
23
- if (schema === null) return;
24
- try {
25
- ajv.compile(schema);
26
- } catch (error) {
27
- throw new Error(`Invalid Input Schema: ${error instanceof Error ? error.message : String(error)}`);
28
- }
29
- }
30
-
31
- export function validateSkillInput(schemaValue: unknown, input: unknown): void {
32
- const schema = parseSchema(schemaValue);
33
- if (schema === null) return;
34
-
35
- let validate;
36
- try {
37
- validate = ajv.compile(schema);
38
- } catch (error) {
39
- throw new Error(`Invalid Input Schema: ${error instanceof Error ? error.message : String(error)}`);
40
- }
41
-
42
- if (validate(input)) return;
43
- throw new Error(`Skill input validation failed: ${ajv.errorsText(validate.errors, { separator: '; ' })}`);
44
- }
1
+ import Ajv from 'ajv';
2
+ import { parseJsonText } from '../skill-hub/utils/json-fields';
3
+
4
+ type JsonSchema = Record<string, unknown> | boolean;
5
+
6
+ const ajv = new Ajv({
7
+ allErrors: true,
8
+ jsonPointers: true,
9
+ });
10
+
11
+ function parseSchema(value: unknown): JsonSchema | null {
12
+ if (value === undefined || value === null || value === '') return null;
13
+ const schema = parseJsonText<unknown>(value, undefined);
14
+ if (typeof schema === 'boolean') return schema;
15
+ if (schema && typeof schema === 'object' && !Array.isArray(schema)) {
16
+ return schema as Record<string, unknown>;
17
+ }
18
+ throw new Error('Input Schema must be a valid JSON Schema object.');
19
+ }
20
+
21
+ export function validateInputSchemaDefinition(value: unknown): void {
22
+ const schema = parseSchema(value);
23
+ if (schema === null) return;
24
+ try {
25
+ ajv.compile(schema);
26
+ } catch (error) {
27
+ throw new Error(`Invalid Input Schema: ${error instanceof Error ? error.message : String(error)}`);
28
+ }
29
+ }
30
+
31
+ export function validateSkillInput(schemaValue: unknown, input: unknown): void {
32
+ const schema = parseSchema(schemaValue);
33
+ if (schema === null) return;
34
+
35
+ let validate;
36
+ try {
37
+ validate = ajv.compile(schema);
38
+ } catch (error) {
39
+ throw new Error(`Invalid Input Schema: ${error instanceof Error ? error.message : String(error)}`);
40
+ }
41
+
42
+ if (validate(input)) return;
43
+ throw new Error(`Skill input validation failed: ${ajv.errorsText(validate.errors, { separator: '; ' })}`);
44
+ }