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,269 +1,541 @@
1
- import React, { useMemo, useState } from 'react';
2
- import { DeleteOutlined, EditOutlined, PlusOutlined } from '@ant-design/icons';
3
- import {
4
- Button,
5
- Card,
6
- Drawer,
7
- Form,
8
- InputNumber,
9
- Popconfirm,
10
- Select,
11
- Space,
12
- Switch,
13
- Table,
14
- Tag,
15
- Typography,
16
- message,
17
- } from 'antd';
18
- import { AIEmployeeSelect } from './AIEmployeeSelect';
19
- import { useAIEmployees } from './AIEmployeesContext';
20
- import { useApiClient, useRequest } from '../hooks/useApiRequest';
21
- import { useT } from '../skill-hub/locale';
22
-
23
- type BindingRecord = {
24
- id: string | number;
25
- leaderUsername: string;
26
- subAgentUsername: string;
27
- harnessTag?: string;
28
- enabled?: boolean;
29
- maxDepth?: number;
30
- timeout?: number;
31
- };
32
-
33
- type ProfileRecord = { tag: string; title?: string; enabled?: boolean };
34
-
35
- type BindingForm = Omit<BindingRecord, 'id'>;
36
-
37
- function rowsFromResponse<T>(value: unknown): T[] {
38
- const response = value as { data?: unknown } | undefined;
39
- return Array.isArray(response?.data) ? (response.data as T[]) : [];
40
- }
41
-
42
- function errorText(error: unknown): string {
43
- const response = error as { response?: { data?: { errors?: Array<{ message?: string }> } }; message?: string };
44
- return response.response?.data?.errors?.[0]?.message || response.message || 'Unknown error';
45
- }
46
-
47
- export const AgentBindingsTab: React.FC = () => {
48
- const api = useApiClient();
49
- const t = useT();
50
- const { employeeMap } = useAIEmployees();
51
- const [form] = Form.useForm<BindingForm>();
52
- const [drawerOpen, setDrawerOpen] = useState(false);
53
- const [editing, setEditing] = useState<BindingRecord | null>(null);
54
-
55
- const bindingsRequest = useRequest({
56
- url: 'orchestratorConfig:list',
57
- params: { sort: ['leaderUsername', 'subAgentUsername'], pageSize: 200 },
58
- });
59
- const profilesRequest = useRequest({
60
- url: 'agentHarnessProfiles:list',
61
- params: { sort: ['tag'], pageSize: 100 },
62
- });
63
-
64
- const bindings = useMemo(() => rowsFromResponse<BindingRecord>(bindingsRequest.data), [bindingsRequest.data]);
65
- const profiles = useMemo(() => rowsFromResponse<ProfileRecord>(profilesRequest.data), [profilesRequest.data]);
66
- const profileOptions = useMemo(
67
- () =>
68
- profiles
69
- .filter((profile) => profile.enabled !== false)
70
- .map((profile) => ({
71
- label: profile.title ? `${profile.title} (${profile.tag})` : profile.tag,
72
- value: profile.tag,
73
- })),
74
- [profiles],
75
- );
76
-
77
- const closeDrawer = () => {
78
- setDrawerOpen(false);
79
- setEditing(null);
80
- form.resetFields();
81
- };
82
-
83
- const openDrawer = (binding?: BindingRecord) => {
84
- setEditing(binding || null);
85
- form.setFieldsValue(
86
- binding || {
87
- enabled: true,
88
- harnessTag: 'default',
89
- maxDepth: 1,
90
- timeout: 120000,
91
- },
92
- );
93
- setDrawerOpen(true);
94
- };
95
-
96
- const saveBinding = async (values: BindingForm) => {
97
- const payload = {
98
- ...values,
99
- leaderUsername: values.leaderUsername?.trim(),
100
- subAgentUsername: values.subAgentUsername?.trim(),
101
- harnessTag: values.harnessTag || 'default',
102
- enabled: values.enabled !== false,
103
- };
104
- try {
105
- if (editing) {
106
- await api.request({
107
- url: 'orchestratorConfig:update',
108
- method: 'put',
109
- params: { filterByTk: editing.id },
110
- data: payload,
111
- });
112
- message.success(t('Agent binding updated'));
113
- } else {
114
- await api.request({ url: 'orchestratorConfig:create', method: 'post', data: payload });
115
- message.success(t('Agent binding created'));
116
- }
117
- closeDrawer();
118
- bindingsRequest.refresh();
119
- } catch (error) {
120
- message.error(t('Save failed: {{message}}', { message: errorText(error) }));
121
- }
122
- };
123
-
124
- const removeBinding = async (id: string | number) => {
125
- try {
126
- await api.request({
127
- url: 'orchestratorConfig:destroy',
128
- method: 'delete',
129
- params: { filterByTk: id },
130
- });
131
- message.success(t('Agent binding deleted'));
132
- bindingsRequest.refresh();
133
- } catch (error) {
134
- message.error(t('Delete failed: {{message}}', { message: errorText(error) }));
135
- }
136
- };
137
-
138
- const columns = [
139
- {
140
- title: t('Leader (Orchestrator)'),
141
- dataIndex: 'leaderUsername',
142
- key: 'leaderUsername',
143
- render: (username: string) => <Tag color="blue">{employeeMap.get(username) || username}</Tag>,
144
- },
145
- {
146
- title: t('Sub-Agent'),
147
- dataIndex: 'subAgentUsername',
148
- key: 'subAgentUsername',
149
- render: (username: string) => <Tag color="green">{employeeMap.get(username) || username}</Tag>,
150
- },
151
- {
152
- title: t('Policy Profile'),
153
- dataIndex: 'harnessTag',
154
- key: 'harnessTag',
155
- render: (tag: string) => <Tag color="purple">{tag || 'default'}</Tag>,
156
- },
157
- { title: t('Max Delegation Depth'), dataIndex: 'maxDepth', key: 'maxDepth', width: 140 },
158
- {
159
- title: t('Enabled'),
160
- dataIndex: 'enabled',
161
- key: 'enabled',
162
- width: 100,
163
- render: (enabled: boolean, binding: BindingRecord) => (
164
- <Switch
165
- size="small"
166
- checked={enabled !== false}
167
- aria-label={t('Enabled')}
168
- onChange={async (checked) => {
169
- await api.request({
170
- url: 'orchestratorConfig:update',
171
- method: 'put',
172
- params: { filterByTk: binding.id },
173
- data: { enabled: checked },
174
- });
175
- bindingsRequest.refresh();
176
- }}
177
- />
178
- ),
179
- },
180
- {
181
- title: t('Actions'),
182
- key: 'actions',
183
- width: 150,
184
- render: (_: unknown, binding: BindingRecord) => (
185
- <Space>
186
- <Button type="link" size="small" icon={<EditOutlined />} onClick={() => openDrawer(binding)}>
187
- {t('Edit')}
188
- </Button>
189
- <Popconfirm title={t('Delete this binding?')} onConfirm={() => removeBinding(binding.id)}>
190
- <Button type="link" size="small" danger icon={<DeleteOutlined />}>
191
- {t('Delete')}
192
- </Button>
193
- </Popconfirm>
194
- </Space>
195
- ),
196
- },
197
- ];
198
-
199
- return (
200
- <Card bordered={false}>
201
- <Space direction="vertical" size={16} style={{ width: '100%' }}>
202
- <div style={{ display: 'flex', alignItems: 'center', justifyContent: 'space-between', gap: 16 }}>
203
- <Typography.Text type="secondary">
204
- {t('Bind each leader/sub-agent pair to the profile that controls memory and tracing policy.')}
205
- </Typography.Text>
206
- <Button type="primary" icon={<PlusOutlined />} onClick={() => openDrawer()}>
207
- {t('New Agent Binding')}
208
- </Button>
209
- </div>
210
- <Table
211
- rowKey="id"
212
- dataSource={bindings}
213
- loading={bindingsRequest.loading || profilesRequest.loading}
214
- columns={columns}
215
- pagination={false}
216
- scroll={{ x: 'max-content' }}
217
- />
218
- </Space>
219
-
220
- <Drawer
221
- open={drawerOpen}
222
- onClose={closeDrawer}
223
- width={560}
224
- title={editing ? t('Edit Agent Binding') : t('New Agent Binding')}
225
- extra={
226
- <Space>
227
- <Button onClick={closeDrawer}>{t('Cancel')}</Button>
228
- <Button type="primary" onClick={() => form.submit()}>
229
- {t('Save')}
230
- </Button>
231
- </Space>
232
- }
233
- >
234
- <Form form={form} layout="vertical" onFinish={saveBinding}>
235
- <Form.Item
236
- label={t('Leader (Orchestrator)')}
237
- name="leaderUsername"
238
- rules={[{ required: true, message: t('Leader is required') }]}
239
- >
240
- <AIEmployeeSelect placeholder={t('Select leader')} />
241
- </Form.Item>
242
- <Form.Item
243
- label={t('Sub-Agent')}
244
- name="subAgentUsername"
245
- rules={[{ required: true, message: t('Sub-agent is required') }]}
246
- >
247
- <AIEmployeeSelect placeholder={t('Select sub-agent')} />
248
- </Form.Item>
249
- <Form.Item
250
- label={t('Policy Profile')}
251
- name="harnessTag"
252
- rules={[{ required: true, message: t('Policy profile is required') }]}
253
- >
254
- <Select options={profileOptions} placeholder={t('Select policy profile')} />
255
- </Form.Item>
256
- <Form.Item label={t('Max Delegation Depth')} name="maxDepth">
257
- <InputNumber min={1} max={10} style={{ width: '100%' }} />
258
- </Form.Item>
259
- <Form.Item label={t('Timeout (ms)')} name="timeout">
260
- <InputNumber min={1000} max={600000} step={1000} style={{ width: '100%' }} />
261
- </Form.Item>
262
- <Form.Item label={t('Enabled')} name="enabled" valuePropName="checked">
263
- <Switch />
264
- </Form.Item>
265
- </Form>
266
- </Drawer>
267
- </Card>
268
- );
269
- };
1
+ /**
2
+ * This file is part of the NocoBase (R) project.
3
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
4
+ * Authors: NocoBase Team.
5
+ *
6
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
7
+ * For more information, please refer to: https://www.nocobase.com/agreement.
8
+ */
9
+
10
+ import React, { useMemo, useRef, useState } from 'react';
11
+ import { DeleteOutlined, EditOutlined, PlusOutlined } from '@ant-design/icons';
12
+ import {
13
+ Button,
14
+ Alert,
15
+ Card,
16
+ Descriptions,
17
+ Divider,
18
+ Drawer,
19
+ Form,
20
+ Input,
21
+ InputNumber,
22
+ Popconfirm,
23
+ Select,
24
+ Space,
25
+ Switch,
26
+ Table,
27
+ Tag,
28
+ Typography,
29
+ message,
30
+ } from 'antd';
31
+ import { AIEmployeeSelect } from './AIEmployeeSelect';
32
+ import { useAIEmployees } from './AIEmployeesContext';
33
+ import { useApiClient, useRequest } from '../hooks/useApiRequest';
34
+ import { useT } from '../skill-hub/locale';
35
+
36
+ type BindingRecord = {
37
+ id: string | number;
38
+ leaderUsername: string;
39
+ subAgentUsername: string;
40
+ harnessTag?: string;
41
+ enabled?: boolean;
42
+ maxDepth?: number;
43
+ timeout?: number;
44
+ routingEnabled?: boolean;
45
+ routingRole?: 'specialist' | 'worker' | null;
46
+ routingPrompt?: string | null;
47
+ llmService?: string | null;
48
+ model?: string | null;
49
+ };
50
+
51
+ type ProfileRecord = { tag: string; title?: string; enabled?: boolean };
52
+ type ModelService = {
53
+ llmService: string;
54
+ llmServiceTitle?: string;
55
+ enabledModels: Array<{ value: string; label?: string }>;
56
+ };
57
+ type RoutingPreview = {
58
+ username: string;
59
+ role: 'specialist' | 'worker';
60
+ model: { llmService: string; model: string };
61
+ fallback: boolean;
62
+ profile: { tag: string; version: number };
63
+ specialist?: {
64
+ username: string;
65
+ model: { llmService: string; model: string };
66
+ fallback: boolean;
67
+ profile: { tag: string; version: number };
68
+ };
69
+ };
70
+
71
+ type BindingForm = Omit<BindingRecord, 'id'>;
72
+
73
+ function rowsFromResponse<T>(value: unknown): T[] {
74
+ if (Array.isArray(value)) return value as T[];
75
+ const response = value as { data?: unknown } | undefined;
76
+ return Array.isArray(response?.data) ? (response.data as T[]) : [];
77
+ }
78
+
79
+ function errorText(error: unknown): string {
80
+ const response = error as { response?: { data?: { errors?: Array<{ message?: string }> } }; message?: string };
81
+ return response?.response?.data?.errors?.[0]?.message || response?.message || 'Unknown error';
82
+ }
83
+
84
+ export const AgentBindingsTab: React.FC = () => {
85
+ const api = useApiClient();
86
+ const t = useT();
87
+ const { employeeMap } = useAIEmployees();
88
+ const [form] = Form.useForm<BindingForm>();
89
+ const routingEnabled = Form.useWatch('routingEnabled', form);
90
+ const llmService = Form.useWatch('llmService', form);
91
+ const [drawerOpen, setDrawerOpen] = useState(false);
92
+ const [editing, setEditing] = useState<BindingRecord | null>(null);
93
+ const [previewSessionId, setPreviewSessionId] = useState('');
94
+ const [preview, setPreview] = useState<RoutingPreview | null>(null);
95
+ const [previewLoading, setPreviewLoading] = useState(false);
96
+ const [previewError, setPreviewError] = useState('');
97
+ const previewRequest = useRef(0);
98
+
99
+ const bindingsRequest = useRequest({
100
+ url: 'orchestratorConfig:list',
101
+ params: { sort: ['leaderUsername', 'subAgentUsername'], pageSize: 200 },
102
+ });
103
+ const profilesRequest = useRequest({
104
+ url: 'agentHarnessProfiles:list',
105
+ params: { sort: ['tag'], pageSize: 100 },
106
+ });
107
+ const modelsRequest = useRequest({ url: 'ai:listAllEnabledModels' });
108
+
109
+ const bindings = useMemo(() => rowsFromResponse<BindingRecord>(bindingsRequest.data), [bindingsRequest.data]);
110
+ const profiles = useMemo(() => rowsFromResponse<ProfileRecord>(profilesRequest.data), [profilesRequest.data]);
111
+ const services = useMemo(() => rowsFromResponse<ModelService>(modelsRequest.data), [modelsRequest.data]);
112
+ const selectedService = services.find((service) => service.llmService === llmService);
113
+ const profileOptions = useMemo(
114
+ () =>
115
+ profiles
116
+ .filter((profile) => profile.enabled !== false)
117
+ .map((profile) => ({
118
+ label: profile.title ? `${profile.title} (${profile.tag})` : profile.tag,
119
+ value: profile.tag,
120
+ })),
121
+ [profiles],
122
+ );
123
+
124
+ const closeDrawer = () => {
125
+ setDrawerOpen(false);
126
+ setEditing(null);
127
+ form.resetFields();
128
+ setPreview(null);
129
+ setPreviewError('');
130
+ previewRequest.current += 1;
131
+ setPreviewLoading(false);
132
+ setPreviewSessionId('');
133
+ };
134
+
135
+ const openDrawer = (binding?: BindingRecord) => {
136
+ setEditing(binding || null);
137
+ form.resetFields();
138
+ setPreview(null);
139
+ setPreviewError('');
140
+ previewRequest.current += 1;
141
+ setPreviewLoading(false);
142
+ setPreviewSessionId('');
143
+ form.setFieldsValue(
144
+ binding || {
145
+ enabled: true,
146
+ harnessTag: 'default',
147
+ maxDepth: 1,
148
+ timeout: 120000,
149
+ routingEnabled: false,
150
+ },
151
+ );
152
+ setDrawerOpen(true);
153
+ };
154
+
155
+ const previewBinding = async () => {
156
+ if (!editing || !previewSessionId.trim()) return;
157
+ setPreviewLoading(true);
158
+ setPreview(null);
159
+ setPreviewError('');
160
+ const requestId = ++previewRequest.current;
161
+ try {
162
+ const response = await api.request({
163
+ url: 'agentHierarchy:preview',
164
+ method: 'post',
165
+ data: {
166
+ sessionId: previewSessionId.trim(),
167
+ username: editing.subAgentUsername,
168
+ ...(editing.routingRole === 'worker' ? { specialistUsername: editing.leaderUsername } : {}),
169
+ },
170
+ });
171
+ const result = response?.data as { data?: { data?: RoutingPreview } } | undefined;
172
+ if (previewRequest.current === requestId) setPreview(result?.data?.data || null);
173
+ } catch (error) {
174
+ if (previewRequest.current === requestId) setPreviewError(t(errorText(error)));
175
+ } finally {
176
+ if (previewRequest.current === requestId) setPreviewLoading(false);
177
+ }
178
+ };
179
+
180
+ const saveBinding = async (values: BindingForm) => {
181
+ const payload = {
182
+ ...values,
183
+ leaderUsername: values.leaderUsername?.trim(),
184
+ subAgentUsername: values.subAgentUsername?.trim(),
185
+ harnessTag: values.harnessTag || 'default',
186
+ enabled: values.enabled !== false,
187
+ routingEnabled: values.routingEnabled === true,
188
+ ...(values.routingEnabled
189
+ ? {
190
+ routingRole: values.routingRole,
191
+ routingPrompt: values.routingPrompt?.trim() || null,
192
+ llmService: values.llmService || null,
193
+ model: values.model || null,
194
+ }
195
+ : {}),
196
+ };
197
+ try {
198
+ if (editing) {
199
+ await api.request({
200
+ url: 'orchestratorConfig:update',
201
+ method: 'put',
202
+ params: { filterByTk: editing.id },
203
+ data: payload,
204
+ });
205
+ message.success(t('Agent binding updated'));
206
+ } else {
207
+ await api.request({ url: 'orchestratorConfig:create', method: 'post', data: payload });
208
+ message.success(t('Agent binding created'));
209
+ }
210
+ closeDrawer();
211
+ bindingsRequest.refresh();
212
+ } catch (error) {
213
+ message.error(t('Save failed: {{message}}', { message: errorText(error) }));
214
+ }
215
+ };
216
+
217
+ const removeBinding = async (id: string | number) => {
218
+ try {
219
+ await api.request({
220
+ url: 'orchestratorConfig:destroy',
221
+ method: 'delete',
222
+ params: { filterByTk: id },
223
+ });
224
+ message.success(t('Agent binding deleted'));
225
+ bindingsRequest.refresh();
226
+ } catch (error) {
227
+ message.error(t('Delete failed: {{message}}', { message: errorText(error) }));
228
+ }
229
+ };
230
+
231
+ const columns = [
232
+ {
233
+ title: t('Leader (Orchestrator)'),
234
+ dataIndex: 'leaderUsername',
235
+ key: 'leaderUsername',
236
+ render: (username: string) => <Tag color="blue">{employeeMap.get(username) || username}</Tag>,
237
+ },
238
+ {
239
+ title: t('Sub-Agent'),
240
+ dataIndex: 'subAgentUsername',
241
+ key: 'subAgentUsername',
242
+ render: (username: string) => <Tag color="green">{employeeMap.get(username) || username}</Tag>,
243
+ },
244
+ {
245
+ title: t('Policy Profile'),
246
+ dataIndex: 'harnessTag',
247
+ key: 'harnessTag',
248
+ render: (tag: string) => <Tag color="purple">{tag || 'default'}</Tag>,
249
+ },
250
+ { title: t('Max Delegation Depth'), dataIndex: 'maxDepth', key: 'maxDepth', width: 140 },
251
+ {
252
+ title: t('Hierarchical routing'),
253
+ dataIndex: 'routingRole',
254
+ key: 'routingRole',
255
+ render: (role: BindingRecord['routingRole'], binding: BindingRecord) =>
256
+ binding.routingEnabled ? (
257
+ <Tag color="blue">{role === 'specialist' ? t('Specialist') : role === 'worker' ? t('Worker') : '-'}</Tag>
258
+ ) : (
259
+ <Tag>{t('Disabled')}</Tag>
260
+ ),
261
+ },
262
+ {
263
+ title: t('Enabled'),
264
+ dataIndex: 'enabled',
265
+ key: 'enabled',
266
+ width: 100,
267
+ render: (enabled: boolean, binding: BindingRecord) => (
268
+ <Switch
269
+ size="small"
270
+ checked={enabled !== false}
271
+ aria-label={t('Enabled')}
272
+ onChange={async (checked) => {
273
+ await api.request({
274
+ url: 'orchestratorConfig:update',
275
+ method: 'put',
276
+ params: { filterByTk: binding.id },
277
+ data: { enabled: checked },
278
+ });
279
+ bindingsRequest.refresh();
280
+ }}
281
+ />
282
+ ),
283
+ },
284
+ {
285
+ title: t('Actions'),
286
+ key: 'actions',
287
+ width: 150,
288
+ render: (_: unknown, binding: BindingRecord) => (
289
+ <Space>
290
+ <Button type="link" size="small" icon={<EditOutlined />} onClick={() => openDrawer(binding)}>
291
+ {t('Edit')}
292
+ </Button>
293
+ <Popconfirm title={t('Delete this binding?')} onConfirm={() => removeBinding(binding.id)}>
294
+ <Button type="link" size="small" danger icon={<DeleteOutlined />}>
295
+ {t('Delete')}
296
+ </Button>
297
+ </Popconfirm>
298
+ </Space>
299
+ ),
300
+ },
301
+ ];
302
+
303
+ return (
304
+ <Card bordered={false}>
305
+ <Space direction="vertical" size={16} style={{ width: '100%' }}>
306
+ <div style={{ display: 'flex', alignItems: 'center', justifyContent: 'space-between', gap: 16 }}>
307
+ <Typography.Text type="secondary">
308
+ {t('Bind employees to profiles and opt in to hierarchical delegation.')}
309
+ </Typography.Text>
310
+ <Button type="primary" icon={<PlusOutlined />} onClick={() => openDrawer()}>
311
+ {t('New Agent Binding')}
312
+ </Button>
313
+ </div>
314
+ <Table
315
+ rowKey="id"
316
+ dataSource={bindings}
317
+ loading={bindingsRequest.loading || profilesRequest.loading}
318
+ columns={columns}
319
+ pagination={false}
320
+ scroll={{ x: 'max-content' }}
321
+ />
322
+ </Space>
323
+
324
+ <Drawer
325
+ open={drawerOpen}
326
+ onClose={closeDrawer}
327
+ width={560}
328
+ title={editing ? t('Edit Agent Binding') : t('New Agent Binding')}
329
+ extra={
330
+ <Space>
331
+ <Button onClick={closeDrawer}>{t('Cancel')}</Button>
332
+ <Button type="primary" onClick={() => form.submit()}>
333
+ {t('Save')}
334
+ </Button>
335
+ </Space>
336
+ }
337
+ >
338
+ <Form form={form} layout="vertical" onFinish={saveBinding}>
339
+ <Form.Item
340
+ label={t('Leader (Orchestrator)')}
341
+ name="leaderUsername"
342
+ rules={[{ required: true, message: t('Leader is required') }]}
343
+ >
344
+ <AIEmployeeSelect placeholder={t('Select leader')} />
345
+ </Form.Item>
346
+ <Form.Item
347
+ label={t('Sub-Agent')}
348
+ name="subAgentUsername"
349
+ rules={[{ required: true, message: t('Sub-agent is required') }]}
350
+ >
351
+ <AIEmployeeSelect placeholder={t('Select sub-agent')} />
352
+ </Form.Item>
353
+ <Form.Item
354
+ label={t('Policy Profile')}
355
+ name="harnessTag"
356
+ rules={[{ required: true, message: t('Policy profile is required') }]}
357
+ >
358
+ <Select options={profileOptions} placeholder={t('Select policy profile')} />
359
+ </Form.Item>
360
+ <Form.Item label={t('Max Delegation Depth')} name="maxDepth">
361
+ <InputNumber min={1} max={10} style={{ width: '100%' }} />
362
+ </Form.Item>
363
+ <Form.Item label={t('Timeout (ms)')} name="timeout">
364
+ <InputNumber min={1000} max={600000} step={1000} style={{ width: '100%' }} />
365
+ </Form.Item>
366
+ <Form.Item
367
+ label={t('Enable hierarchical routing')}
368
+ name="routingEnabled"
369
+ valuePropName="checked"
370
+ extra={t('Applies to delegation through the hierarchical routing tool.')}
371
+ >
372
+ <Switch aria-label={t('Enable hierarchical routing')} />
373
+ </Form.Item>
374
+ {routingEnabled && (
375
+ <>
376
+ <Form.Item
377
+ label={t('Target role')}
378
+ name="routingRole"
379
+ rules={[{ required: true, message: t('Choose a routing role for the target employee.') }]}
380
+ >
381
+ <Select
382
+ options={[
383
+ { value: 'specialist', label: t('Specialist') },
384
+ { value: 'worker', label: t('Worker') },
385
+ ]}
386
+ />
387
+ </Form.Item>
388
+ <Form.Item
389
+ label={t('When to delegate')}
390
+ name="routingPrompt"
391
+ extra={t('Describe the tasks this employee is suited to handle.')}
392
+ >
393
+ <Input.TextArea maxLength={4000} showCount rows={3} />
394
+ </Form.Item>
395
+ <Form.Item
396
+ label={t('LLM service override')}
397
+ name="llmService"
398
+ dependencies={['model']}
399
+ extra={t('Leave both model fields empty to use the target employee model.')}
400
+ rules={[
401
+ ({ getFieldValue }) => ({
402
+ validator(_, value) {
403
+ return Boolean(value) === Boolean(getFieldValue('model'))
404
+ ? Promise.resolve()
405
+ : Promise.reject(new Error(t('Select both an LLM service and a model, or leave both empty.')));
406
+ },
407
+ }),
408
+ ]}
409
+ >
410
+ <Select
411
+ allowClear
412
+ showSearch
413
+ optionFilterProp="label"
414
+ loading={modelsRequest.loading}
415
+ options={services.map((service) => ({
416
+ value: service.llmService,
417
+ label: service.llmServiceTitle || service.llmService,
418
+ }))}
419
+ onChange={() => form.setFieldValue('model', undefined)}
420
+ />
421
+ </Form.Item>
422
+ <Form.Item
423
+ label={t('Model override')}
424
+ name="model"
425
+ dependencies={['llmService']}
426
+ rules={[
427
+ ({ getFieldValue }) => ({
428
+ validator(_, value) {
429
+ return Boolean(value) === Boolean(getFieldValue('llmService'))
430
+ ? Promise.resolve()
431
+ : Promise.reject(new Error(t('Select both an LLM service and a model, or leave both empty.')));
432
+ },
433
+ }),
434
+ ]}
435
+ >
436
+ <Select
437
+ allowClear
438
+ showSearch
439
+ optionFilterProp="label"
440
+ loading={modelsRequest.loading}
441
+ disabled={!llmService}
442
+ options={(selectedService?.enabledModels || []).map((model) => ({
443
+ value: model.value,
444
+ label: model.label || model.value,
445
+ }))}
446
+ />
447
+ </Form.Item>
448
+ {modelsRequest.error && (
449
+ <Typography.Text type="danger">{t('Unable to load enabled models.')}</Typography.Text>
450
+ )}
451
+ </>
452
+ )}
453
+ <Form.Item label={t('Enabled')} name="enabled" valuePropName="checked">
454
+ <Switch />
455
+ </Form.Item>
456
+ </Form>
457
+ {editing?.routingEnabled && (editing.routingRole === 'specialist' || editing.routingRole === 'worker') && (
458
+ <>
459
+ <Divider orientation="left">{t('Preview effective routing')}</Divider>
460
+ <Typography.Paragraph type="secondary">
461
+ {t('Preview uses the saved binding, published profile and a conversation owned by your user.')}
462
+ </Typography.Paragraph>
463
+ {editing.routingRole === 'worker' && (
464
+ <>
465
+ <Typography.Paragraph type="secondary">
466
+ {t('The conversation must belong to an orchestrator bound to this worker’s specialist.')}
467
+ </Typography.Paragraph>
468
+ <Typography.Paragraph type="secondary">
469
+ {t('Preview does not check worker tools that depend on a child session.')}
470
+ </Typography.Paragraph>
471
+ </>
472
+ )}
473
+ <Input
474
+ value={previewSessionId}
475
+ onChange={(event) => {
476
+ setPreviewSessionId(event.target.value);
477
+ setPreview(null);
478
+ setPreviewError('');
479
+ previewRequest.current += 1;
480
+ setPreviewLoading(false);
481
+ }}
482
+ aria-label={t('Conversation ID')}
483
+ placeholder={t('Conversation ID')}
484
+ />
485
+ <Button
486
+ style={{ marginTop: 12 }}
487
+ loading={previewLoading}
488
+ disabled={!previewSessionId.trim()}
489
+ onClick={previewBinding}
490
+ >
491
+ {t('Preview effective routing')}
492
+ </Button>
493
+ {previewError && (
494
+ <Alert
495
+ type="error"
496
+ showIcon
497
+ style={{ marginTop: 12 }}
498
+ message={t('Preview failed: {{message}}', { message: previewError })}
499
+ />
500
+ )}
501
+ {preview && (
502
+ <>
503
+ {preview.specialist && (
504
+ <Descriptions title={t('Specialist')} size="small" column={1} style={{ marginTop: 12 }}>
505
+ <Descriptions.Item label={t('Sub-Agent')}>{preview.specialist.username}</Descriptions.Item>
506
+ <Descriptions.Item label={t('Policy Profile')}>
507
+ {preview.specialist.profile.tag} v{preview.specialist.profile.version}
508
+ </Descriptions.Item>
509
+ <Descriptions.Item label={t('Effective model')}>
510
+ {preview.specialist.model.llmService} / {preview.specialist.model.model}
511
+ </Descriptions.Item>
512
+ <Descriptions.Item label={t('Fallback model selected')}>
513
+ {preview.specialist.fallback ? t('Yes') : t('No')}
514
+ </Descriptions.Item>
515
+ </Descriptions>
516
+ )}
517
+ <Descriptions
518
+ title={preview.specialist ? t('Worker') : undefined}
519
+ size="small"
520
+ column={1}
521
+ style={{ marginTop: 12 }}
522
+ >
523
+ <Descriptions.Item label={t('Sub-Agent')}>{preview.username}</Descriptions.Item>
524
+ <Descriptions.Item label={t('Policy Profile')}>
525
+ {preview.profile.tag} v{preview.profile.version}
526
+ </Descriptions.Item>
527
+ <Descriptions.Item label={t('Effective model')}>
528
+ {preview.model.llmService} / {preview.model.model}
529
+ </Descriptions.Item>
530
+ <Descriptions.Item label={t('Fallback model selected')}>
531
+ {preview.fallback ? t('Yes') : t('No')}
532
+ </Descriptions.Item>
533
+ </Descriptions>
534
+ </>
535
+ )}
536
+ </>
537
+ )}
538
+ </Drawer>
539
+ </Card>
540
+ );
541
+ };