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,387 +1,518 @@
1
- import type { Model } from '@nocobase/database';
2
- import type { Application } from '@nocobase/server';
3
- import { AIEmployee } from '@nocobase/plugin-ai/server';
4
- import { listSystemTools } from '@nocobase/ai';
5
- import { estimateCost } from './TokenTracker';
6
- import { getAIToolsManager } from '../utils/ai-manager';
7
- import { decideTool } from './HarnessCompiler';
8
- import type { CompiledHarness } from './HarnessCompiler';
9
- import { read } from '../utils/record-utils';
10
-
11
- // plugin-ai keeps every tool whose name is in `listSystemTools()` regardless of the constructor
12
- // tool filter (ai-employee.ts getAIEmployeeTools). The harness `filter` cannot remove them, so a
13
- // denied system tool would still reach the model. The adapter neutralizes them at their source
14
- // instead: web search via the `webSearch` constructor flag, knowledge-base retrieval via the
15
- // in-memory `enableKnowledgeBase` employee flag. This maps each system tool to the switch that
16
- // stops plugin-ai from ever adding it.
17
- const SYSTEM_TOOL_WEB_SEARCH = 'subAgentWebSearch';
18
- const SYSTEM_TOOL_KNOWLEDGE_BASE = 'knowledge-base-retrieve';
19
-
20
- export type LoopRole = 'leader' | 'maker' | 'verifier';
21
-
22
- export type ToolCallDecision = {
23
- type: 'approve' | 'edit' | 'reject';
24
- message?: string;
25
- editedAction?: { name: string; args: unknown };
26
- };
27
-
28
- export type InterruptedToolCall = {
29
- toolCallId: string;
30
- toolName: string;
31
- args: unknown;
32
- interruptId: string;
33
- };
34
-
35
- export type TokenUsageReport = {
36
- inputTokens: number;
37
- outputTokens: number;
38
- totalTokens: number;
39
- cost: number;
40
- };
41
-
42
- export type InvocationOutcome = {
43
- sessionId: string;
44
- messageId: string;
45
- interrupted: InterruptedToolCall[];
46
- content: string;
47
- tokenUsage: TokenUsageReport | null;
48
- };
49
-
50
- type ConversationsManager = {
51
- create(input: {
52
- userId?: number;
53
- aiEmployee: { username: string };
54
- title?: string;
55
- options?: Record<string, unknown>;
56
- category?: string;
57
- }): Promise<Model>;
58
- getUserDecisions(messageId: string): Promise<{ interruptId?: string; decisions: unknown[] } | undefined>;
59
- };
60
-
61
- type EmployeesManager = {
62
- getEmployee(username: string): Promise<Model | null>;
63
- resolveModel(employee: Model, model?: unknown): Promise<{ llmService: string; model: string }>;
64
- };
65
-
66
- type PluginAi = {
67
- aiConversationsManager: ConversationsManager;
68
- aiEmployeesManager: EmployeesManager;
69
- };
70
-
71
- function extractTokenUsageFromResult(result: Record<string, unknown>): TokenUsageReport | null {
72
- // Try direct usage_metadata from the last AI message (LangChain standard)
73
- const messages = result.messages;
74
- if (Array.isArray(messages)) {
75
- let totalInput = 0;
76
- let totalOutput = 0;
77
- let totalAll = 0;
78
- for (const msg of messages) {
79
- const um = (msg as Record<string, unknown>)?.usage_metadata as Record<string, unknown> | undefined;
80
- if (um) {
81
- totalInput += Number(um.input_tokens || 0);
82
- totalOutput += Number(um.output_tokens || 0);
83
- totalAll += Number(um.total_tokens || 0);
84
- }
85
- }
86
- if (totalAll > 0) {
87
- return {
88
- inputTokens: totalInput,
89
- outputTokens: totalOutput,
90
- totalTokens: totalAll,
91
- cost: estimateCost(totalInput, totalOutput),
92
- };
93
- }
94
- }
95
-
96
- // Try usage field (some providers return this)
97
- const usage = result.usage as Record<string, unknown> | undefined;
98
- if (usage) {
99
- const inputTokens = Number(usage.prompt_tokens || usage.input_tokens || 0);
100
- const outputTokens = Number(usage.completion_tokens || usage.output_tokens || 0);
101
- const totalTokens = Number(usage.total_tokens || inputTokens + outputTokens);
102
- if (totalTokens > 0) {
103
- return {
104
- inputTokens,
105
- outputTokens,
106
- totalTokens,
107
- cost: estimateCost(inputTokens, outputTokens),
108
- };
109
- }
110
- }
111
-
112
- return null;
113
- }
114
-
115
- function textContent(messages: unknown): string {
116
- if (!Array.isArray(messages)) return '';
117
- const last = messages[messages.length - 1] as { content?: unknown } | undefined;
118
- if (typeof last?.content === 'string') return last.content;
119
- if (Array.isArray(last?.content)) {
120
- return last.content
121
- .map((part) =>
122
- typeof part === 'object' && part && 'text' in part ? String((part as { text: unknown }).text) : '',
123
- )
124
- .join('');
125
- }
126
- return '';
127
- }
128
-
129
- function interruptedFrom(result: Record<string, unknown>): InterruptedToolCall[] {
130
- const interrupts = result.__interrupt__;
131
- if (!Array.isArray(interrupts)) return [];
132
- const calls: InterruptedToolCall[] = [];
133
- for (const interrupt of interrupts) {
134
- const value = (interrupt as { value?: unknown }).value ?? interrupt;
135
- const record = value as Record<string, unknown>;
136
- const toolCallId = String(record.toolCallId || record.tool_call_id || '');
137
- if (!toolCallId) continue;
138
- calls.push({
139
- toolCallId,
140
- toolName: String(record.name || record.toolName || ''),
141
- args: record.args ?? record.input ?? {},
142
- interruptId: String((interrupt as { id?: unknown }).id || record.interruptId || ''),
143
- });
144
- }
145
- return calls;
146
- }
147
-
148
- // plugin-ai reads the compiled harness through two different channels, and they disagree on shape:
149
- //
150
- // 1. `skillSettings.tools` on the AIEmployee constructor is a `string[]` name filter once
151
- // `toolsVersion` is set (ai-employee.ts `getAIEmployeeTools`).
152
- // 2. `employee.skillSettings.tools` on the persisted record is a `{ name, autoCall }[]` that both
153
- // widens the candidate tool set and decides whether a call interrupts (`isAutoCall`).
154
- //
155
- // Passing objects to (1) silently filtered out every tool, because `string[].includes(object)` is
156
- // always false. Both channels are populated here, from the same decision, so a tool is exposed only
157
- // when the harness allows it and interrupts whenever the harness says `ask`.
158
- export type HarnessToolPlan = {
159
- filter: string[];
160
- employeeTools: Array<{ name: string; autoCall: boolean }>;
161
- withheld: Array<{ name: string; reason: string }>;
162
- // System tools the harness does not grant. They ignore `filter`, so the caller has to disable
163
- // the feature that injects them rather than relying on the filter to drop them.
164
- blockedSystemTools: string[];
165
- };
166
-
167
- type ToolEntry = { scope?: string; defaultPermission?: string } | undefined;
168
-
169
- // `isAutoCall` only consults the employee override for CUSTOM-scope tools; every other scope is
170
- // governed by the tool's own `defaultPermission`. So an `ask` decision is only enforceable when one
171
- // of those two is true. When it is not, the tool is withheld rather than exposed un-gated.
172
- function askIsEnforceable(entry: ToolEntry) {
173
- return entry?.scope === 'CUSTOM' || entry?.defaultPermission !== 'ALLOW';
174
- }
175
-
176
- // Tool discovery must run with the same context plugin-ai uses. `DefaultToolsManager.getTools`
177
- // only consults dynamic providers when a filter is supplied, and the MCP provider registers a
178
- // user's context-scoped tools solely when `filter.ctx` is present. Discovering without it reports
179
- // every MCP tool as unregistered even though `AIEmployee.getToolsMap()` would find it at call time.
180
- export async function planHarnessTools(
181
- app: Application,
182
- harness: CompiledHarness,
183
- discovery?: { ctx?: unknown; sessionId?: string },
184
- ): Promise<HarnessToolPlan> {
185
- const toolsManager = getAIToolsManager(app);
186
- // Escalatable tools join the plan as ask-gated candidates: the model can invoke them, but every
187
- // call interrupts and parks the run until a human approves that single call.
188
- const candidates = Array.from(new Set([...harness.tools.allow, ...harness.tools.ask, ...harness.tools.escalate]));
189
- const plan: HarnessToolPlan = { filter: [], employeeTools: [], withheld: [], blockedSystemTools: [] };
190
- const filter = discovery ? { ctx: discovery.ctx, sessionId: discovery.sessionId } : undefined;
191
-
192
- for (const name of candidates.sort()) {
193
- const decision = decideTool(harness, name);
194
- if (decision === 'deny') {
195
- plan.withheld.push({ name, reason: 'denied by harness' });
196
- continue;
197
- }
198
- const entry = (await toolsManager.getTools(name, filter)) as ToolEntry;
199
- if (!entry) {
200
- plan.withheld.push({ name, reason: 'not registered with plugin-ai' });
201
- continue;
202
- }
203
- if (decision === 'ask' && !askIsEnforceable(entry)) {
204
- plan.withheld.push({ name, reason: 'approval cannot be enforced for this tool' });
205
- continue;
206
- }
207
- plan.filter.push(name);
208
- plan.employeeTools.push({ name, autoCall: decision === 'allow' });
209
- }
210
-
211
- const granted = new Set(plan.filter);
212
- plan.blockedSystemTools = listSystemTools()
213
- .filter((name) => !granted.has(name))
214
- .sort();
215
- return plan;
216
- }
217
-
218
- export class PluginAiRuntimeAdapter {
219
- constructor(private readonly app: Application) {}
220
-
221
- private plugin(): PluginAi {
222
- const plugin = this.app.pm.get('ai') as unknown as PluginAi | undefined;
223
- if (!plugin?.aiEmployeesManager || !plugin?.aiConversationsManager) {
224
- throw new Error('The official @nocobase/plugin-ai plugin is required to execute Loop Control Plane runs.');
225
- }
226
- return plugin;
227
- }
228
-
229
- async createConversation(input: { username: string; userId?: number; runId: number; title: string }) {
230
- const conversation = await this.plugin().aiConversationsManager.create({
231
- userId: input.userId,
232
- aiEmployee: { username: input.username },
233
- title: input.title,
234
- category: 'task',
235
- options: { controlPlaneRunId: input.runId },
236
- });
237
- const sessionId = String(read(conversation, 'sessionId') || '');
238
- if (!sessionId) throw new Error('The AI conversation was created without a session identifier.');
239
- return sessionId;
240
- }
241
-
242
- async invoke(input: {
243
- username: string;
244
- sessionId: string;
245
- userId?: number;
246
- systemMessage: string;
247
- harness: CompiledHarness;
248
- prompt: string;
249
- signal: AbortSignal;
250
- }): Promise<InvocationOutcome> {
251
- const { aiEmployee } = await this.buildEmployee(input);
252
-
253
- const result = (await aiEmployee.invoke({
254
- userMessages: [{ role: 'user', content: input.prompt }],
255
- signal: input.signal,
256
- })) as Record<string, unknown>;
257
-
258
- return {
259
- sessionId: input.sessionId,
260
- messageId: String(result.messageId || ''),
261
- interrupted: interruptedFrom(result),
262
- content: textContent(result.messages),
263
- tokenUsage: extractTokenUsageFromResult(result),
264
- };
265
- }
266
-
267
- // Resume mirrors the official workflow employee node: flip the persisted tool call to
268
- // `waiting` with a decision, then re-invoke so plugin-ai resumes its own checkpoint.
269
- // Decisions are per tool call: plugin-ai stores one `userDecision` per interrupted row and
270
- // `getUserDecisions` only unblocks once every interrupted call of the message has one.
271
- async resume(input: {
272
- username: string;
273
- sessionId: string;
274
- messageId: string;
275
- userId?: number;
276
- systemMessage: string;
277
- harness: CompiledHarness;
278
- decisions: Array<{ toolCallId: string; decision: ToolCallDecision }>;
279
- signal: AbortSignal;
280
- }): Promise<InvocationOutcome> {
281
- const plugin = this.plugin();
282
-
283
- for (const entry of input.decisions) {
284
- await this.app.db.getModel('aiToolMessages').update(
285
- { userDecision: entry.decision, invokeStatus: 'waiting' },
286
- {
287
- where: {
288
- sessionId: input.sessionId,
289
- messageId: input.messageId,
290
- toolCallId: entry.toolCallId,
291
- invokeStatus: 'interrupted',
292
- },
293
- },
294
- );
295
- }
296
- const userDecisions = await plugin.aiConversationsManager.getUserDecisions(input.messageId);
297
- if (!userDecisions) throw new Error('The interrupted tool calls are not all ready to resume.');
298
-
299
- const { aiEmployee } = await this.buildEmployee(input);
300
-
301
- const result = (await aiEmployee.invoke({
302
- messageId: input.messageId,
303
- userDecisions: userDecisions as { interruptId?: string; decisions: never[] },
304
- signal: input.signal,
305
- })) as Record<string, unknown>;
306
-
307
- return {
308
- sessionId: input.sessionId,
309
- messageId: String(result.messageId || input.messageId),
310
- interrupted: interruptedFrom(result),
311
- content: textContent(result.messages),
312
- tokenUsage: extractTokenUsageFromResult(result),
313
- };
314
- }
315
-
316
- // The employee model is re-read per invocation and mutated only in memory. `isAutoCall` reads
317
- // `employee.skillSettings` off the Sequelize dataValues, so `set()` without `save()` gates this
318
- // run's tool calls without touching the shared employee configuration.
319
- private async buildEmployee(input: {
320
- username: string;
321
- sessionId: string;
322
- userId?: number;
323
- systemMessage: string;
324
- harness: CompiledHarness;
325
- }) {
326
- const plugin = this.plugin();
327
- const employee = await plugin.aiEmployeesManager.getEmployee(input.username);
328
- if (!employee) throw new Error(`AI employee "${input.username}" was not found.`);
329
- const model = await plugin.aiEmployeesManager.resolveModel(employee);
330
- const currentRoles = await this.rolesFor(input.userId);
331
-
332
- const ctx = {
333
- app: this.app,
334
- db: this.app.db,
335
- log: this.app.log,
336
- logger: this.app.log,
337
- state: {
338
- currentRoles,
339
- // Populate currentUser so currentUserId(ctx) resolves correctly.
340
- currentUser: input.userId ? { id: input.userId } : undefined,
341
- },
342
- auth: { user: { id: input.userId } },
343
- action: { params: { values: { sessionId: input.sessionId, model } } },
344
- };
345
-
346
- // Discovery runs with the same ctx the invocation will use, so context-scoped MCP tools
347
- // resolve here exactly as they will when plugin-ai builds its tool map.
348
- const plan = await planHarnessTools(this.app, input.harness, { ctx, sessionId: input.sessionId });
349
-
350
- if (plan.withheld.length) {
351
- this.app.logger.info(
352
- `[AgentOrchestrator] Harness withheld ${plan.withheld.length} tool(s) from ${input.username}.`,
353
- { withheld: plan.withheld },
354
- );
355
- }
356
-
357
- const persisted = (employee.get('skillSettings') || {}) as Record<string, unknown>;
358
- employee.set('skillSettings', { ...persisted, tools: plan.employeeTools });
359
-
360
- // plugin-ai adds `knowledge-base-retrieve` whenever the employee has knowledge base enabled,
361
- // and keeps it through the tool filter because it is a system tool. Clearing the in-memory flag
362
- // is the only way a harness that does not grant it actually keeps it out of the model's hands.
363
- const blockedSystemTools = new Set(plan.blockedSystemTools);
364
- if (blockedSystemTools.has(SYSTEM_TOOL_KNOWLEDGE_BASE)) {
365
- employee.set('enableKnowledgeBase', false);
366
- }
367
-
368
- const aiEmployee = new AIEmployee({
369
- ctx: ctx as never,
370
- employee,
371
- sessionId: input.sessionId,
372
- systemMessage: input.systemMessage,
373
- skillSettings: { skillsVersion: 2, toolsVersion: 2, skills: [], tools: plan.filter },
374
- // Same reasoning for web search: the flag is what injects the system tool, so it is only
375
- // ever enabled when the harness explicitly granted it.
376
- webSearch: !blockedSystemTools.has(SYSTEM_TOOL_WEB_SEARCH),
377
- model,
378
- });
379
- return { aiEmployee, plan };
380
- }
381
-
382
- private async rolesFor(userId?: number) {
383
- if (!userId) return [];
384
- const rows = await this.app.db.getRepository('rolesUsers').find({ filter: { userId } });
385
- return rows.map((row) => String(read(row, 'roleName') || '')).filter(Boolean);
386
- }
387
- }
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 type { Model } from '@nocobase/database';
11
+ import type { Application } from '@nocobase/server';
12
+ import { AIEmployee } from '@nocobase/plugin-ai/server';
13
+ import { listSystemTools } from '@nocobase/ai';
14
+ import { estimateCost } from './TokenTracker';
15
+ import { getAIToolsManager } from '../utils/ai-manager';
16
+ import { decideTool } from './HarnessCompiler';
17
+ import type { CompiledHarness } from './HarnessCompiler';
18
+ import { read } from '../utils/record-utils';
19
+
20
+ // plugin-ai keeps every tool whose name is in `listSystemTools()` regardless of the constructor
21
+ // tool filter (ai-employee.ts getAIEmployeeTools). The harness `filter` cannot remove them, so a
22
+ // denied system tool would still reach the model. The adapter neutralizes them at their source
23
+ // instead: web search via the `webSearch` constructor flag, knowledge-base retrieval via the
24
+ // in-memory `enableKnowledgeBase` employee flag. This maps each system tool to the switch that
25
+ // stops plugin-ai from ever adding it.
26
+ const SYSTEM_TOOL_WEB_SEARCH = 'subAgentWebSearch';
27
+ const SYSTEM_TOOL_KNOWLEDGE_BASE = 'knowledge-base-retrieve';
28
+
29
+ export type LoopRole = 'leader' | 'maker' | 'verifier';
30
+
31
+ export type ToolCallDecision = {
32
+ type: 'approve' | 'edit' | 'reject';
33
+ message?: string;
34
+ editedAction?: { name: string; args: unknown };
35
+ };
36
+
37
+ export type InterruptedToolCall = {
38
+ toolCallId: string;
39
+ toolName: string;
40
+ args: unknown;
41
+ interruptId: string;
42
+ };
43
+
44
+ export type TokenUsageReport = {
45
+ inputTokens: number;
46
+ outputTokens: number;
47
+ totalTokens: number;
48
+ cost: number;
49
+ };
50
+
51
+ export type InvocationOutcome = {
52
+ sessionId: string;
53
+ messageId: string;
54
+ interrupted: InterruptedToolCall[];
55
+ content: string;
56
+ tokenUsage: TokenUsageReport | null;
57
+ };
58
+
59
+ type ConversationsManager = {
60
+ create(input: {
61
+ userId?: number;
62
+ aiEmployee: { username: string };
63
+ title?: string;
64
+ options?: Record<string, unknown>;
65
+ category?: string;
66
+ }): Promise<Model>;
67
+ getUserDecisions(messageId: string): Promise<{ interruptId?: string; decisions: unknown[] } | undefined>;
68
+ };
69
+
70
+ type EmployeesManager = {
71
+ getEmployee(username: string): Promise<Model | null>;
72
+ resolveModel(employee: Model, model?: unknown): Promise<{ llmService: string; model: string }>;
73
+ };
74
+
75
+ type PluginAi = {
76
+ aiConversationsManager: ConversationsManager;
77
+ aiEmployeesManager: EmployeesManager;
78
+ };
79
+
80
+ function extractTokenUsageFromResult(result: Record<string, unknown>): TokenUsageReport | null {
81
+ // Try direct usage_metadata from the last AI message (LangChain standard)
82
+ const messages = result.messages;
83
+ if (Array.isArray(messages)) {
84
+ let totalInput = 0;
85
+ let totalOutput = 0;
86
+ let totalAll = 0;
87
+ for (const msg of messages) {
88
+ const um = (msg as Record<string, unknown>)?.usage_metadata as Record<string, unknown> | undefined;
89
+ if (um) {
90
+ totalInput += Number(um.input_tokens || 0);
91
+ totalOutput += Number(um.output_tokens || 0);
92
+ totalAll += Number(um.total_tokens || 0);
93
+ }
94
+ }
95
+ if (totalAll > 0) {
96
+ return {
97
+ inputTokens: totalInput,
98
+ outputTokens: totalOutput,
99
+ totalTokens: totalAll,
100
+ cost: estimateCost(totalInput, totalOutput),
101
+ };
102
+ }
103
+ }
104
+
105
+ // Try usage field (some providers return this)
106
+ const usage = result.usage as Record<string, unknown> | undefined;
107
+ if (usage) {
108
+ const inputTokens = Number(usage.prompt_tokens || usage.input_tokens || 0);
109
+ const outputTokens = Number(usage.completion_tokens || usage.output_tokens || 0);
110
+ const totalTokens = Number(usage.total_tokens || inputTokens + outputTokens);
111
+ if (totalTokens > 0) {
112
+ return {
113
+ inputTokens,
114
+ outputTokens,
115
+ totalTokens,
116
+ cost: estimateCost(inputTokens, outputTokens),
117
+ };
118
+ }
119
+ }
120
+
121
+ return null;
122
+ }
123
+
124
+ function textContent(messages: unknown): string {
125
+ if (!Array.isArray(messages)) return '';
126
+ const last = messages[messages.length - 1] as { content?: unknown } | undefined;
127
+ if (typeof last?.content === 'string') return last.content;
128
+ if (Array.isArray(last?.content)) {
129
+ return last.content
130
+ .map((part) =>
131
+ typeof part === 'object' && part && 'text' in part ? String((part as { text: unknown }).text) : '',
132
+ )
133
+ .join('');
134
+ }
135
+ return '';
136
+ }
137
+
138
+ function invalidInterrupt(app: Application) {
139
+ const message = 'Invalid AI tool interruption payload.';
140
+ return new Error(app.i18n?.t?.(message, { ns: 'plugin-agent-orchestrator' }) || message);
141
+ }
142
+
143
+ function interruptedFrom(result: Record<string, unknown>, app: Application): InterruptedToolCall[] {
144
+ const invalidPayload = () => invalidInterrupt(app);
145
+ const interrupts = result.__interrupt__;
146
+ if (interrupts == null) return [];
147
+ if (!Array.isArray(interrupts) || interrupts.length > 1) throw invalidPayload();
148
+ const calls: InterruptedToolCall[] = [];
149
+ for (const interrupt of interrupts) {
150
+ if (!interrupt || typeof interrupt !== 'object') throw invalidPayload();
151
+ const value = (interrupt as { value?: unknown }).value ?? interrupt;
152
+ if (!value || typeof value !== 'object') throw invalidPayload();
153
+ const record = value as Record<string, unknown>;
154
+ const interruptId = String((interrupt as { id?: unknown }).id || record.interruptId || '');
155
+ if (Array.isArray(record.actionRequests)) {
156
+ if (!record.actionRequests.length || !interruptId) throw invalidPayload();
157
+ for (const action of record.actionRequests) {
158
+ if (!action || typeof action !== 'object') throw invalidPayload();
159
+ const request = action as Record<string, unknown>;
160
+ let details: Record<string, unknown>;
161
+ try {
162
+ details = JSON.parse(String(request.description));
163
+ } catch {
164
+ throw invalidPayload();
165
+ }
166
+ if (
167
+ !details ||
168
+ typeof details !== 'object' ||
169
+ typeof details.toolCallId !== 'string' ||
170
+ !details.toolCallId ||
171
+ typeof details.toolCallName !== 'string' ||
172
+ !details.toolCallName ||
173
+ !('args' in request)
174
+ ) {
175
+ throw invalidPayload();
176
+ }
177
+ calls.push({ toolCallId: details.toolCallId, toolName: details.toolCallName, args: request.args, interruptId });
178
+ }
179
+ continue;
180
+ }
181
+ const toolCallId = String(record.toolCallId || record.tool_call_id || '');
182
+ const toolName = String(record.name || record.toolName || '');
183
+ if (!toolCallId || !toolName || !interruptId) throw invalidPayload();
184
+ calls.push({
185
+ toolCallId,
186
+ toolName,
187
+ args: record.args ?? record.input ?? {},
188
+ interruptId,
189
+ });
190
+ }
191
+ return calls;
192
+ }
193
+
194
+ // plugin-ai reads the compiled harness through two different channels, and they disagree on shape:
195
+ //
196
+ // 1. `skillSettings.tools` on the AIEmployee constructor is a `string[]` name filter once
197
+ // `toolsVersion` is set (ai-employee.ts `getAIEmployeeTools`).
198
+ // 2. `employee.skillSettings.tools` on the persisted record is a `{ name, autoCall }[]` that both
199
+ // widens the candidate tool set and decides whether a call interrupts (`isAutoCall`).
200
+ //
201
+ // Passing objects to (1) silently filtered out every tool, because `string[].includes(object)` is
202
+ // always false. Both channels are populated here, from the same decision, so a tool is exposed only
203
+ // when the harness allows it and interrupts whenever the harness says `ask`.
204
+ export type HarnessToolPlan = {
205
+ filter: string[];
206
+ employeeTools: Array<{ name: string; autoCall: boolean }>;
207
+ withheld: Array<{ name: string; reason: string }>;
208
+ // System tools the harness does not grant. They ignore `filter`, so the caller has to disable
209
+ // the feature that injects them rather than relying on the filter to drop them.
210
+ blockedSystemTools: string[];
211
+ };
212
+
213
+ type ToolEntry = { scope?: string; defaultPermission?: string } | undefined;
214
+
215
+ // `isAutoCall` only consults the employee override for CUSTOM-scope tools; every other scope is
216
+ // governed by the tool's own `defaultPermission`. So an `ask` decision is only enforceable when one
217
+ // of those two is true. When it is not, the tool is withheld rather than exposed un-gated.
218
+ function askIsEnforceable(entry: ToolEntry) {
219
+ return entry?.scope === 'CUSTOM' || entry?.defaultPermission !== 'ALLOW';
220
+ }
221
+
222
+ // Tool discovery must run with the same context plugin-ai uses. `DefaultToolsManager.getTools`
223
+ // only consults dynamic providers when a filter is supplied, and the MCP provider registers a
224
+ // user's context-scoped tools solely when `filter.ctx` is present. Discovering without it reports
225
+ // every MCP tool as unregistered even though `AIEmployee.getToolsMap()` would find it at call time.
226
+ export async function planHarnessTools(
227
+ app: Application,
228
+ harness: CompiledHarness,
229
+ discovery?: { ctx?: unknown; sessionId?: string },
230
+ ): Promise<HarnessToolPlan> {
231
+ const toolsManager = getAIToolsManager(app);
232
+ // Escalatable tools join the plan as ask-gated candidates: the model can invoke them, but every
233
+ // call interrupts and parks the run until a human approves that single call.
234
+ const candidates = Array.from(new Set([...harness.tools.allow, ...harness.tools.ask, ...harness.tools.escalate]));
235
+ const plan: HarnessToolPlan = { filter: [], employeeTools: [], withheld: [], blockedSystemTools: [] };
236
+ const filter = discovery ? { ctx: discovery.ctx, sessionId: discovery.sessionId } : undefined;
237
+
238
+ for (const name of candidates.sort()) {
239
+ const decision = decideTool(harness, name);
240
+ if (decision === 'deny') {
241
+ plan.withheld.push({ name, reason: 'denied by harness' });
242
+ continue;
243
+ }
244
+ const entry = (await toolsManager.getTools(name, filter)) as ToolEntry;
245
+ if (!entry) {
246
+ plan.withheld.push({ name, reason: 'not registered with plugin-ai' });
247
+ continue;
248
+ }
249
+ if (decision === 'ask' && !askIsEnforceable(entry)) {
250
+ plan.withheld.push({ name, reason: 'approval cannot be enforced for this tool' });
251
+ continue;
252
+ }
253
+ plan.filter.push(name);
254
+ plan.employeeTools.push({ name, autoCall: decision === 'allow' });
255
+ }
256
+
257
+ const granted = new Set(plan.filter);
258
+ plan.blockedSystemTools = listSystemTools()
259
+ .filter((name) => !granted.has(name))
260
+ .sort();
261
+ return plan;
262
+ }
263
+
264
+ export class PluginAiRuntimeAdapter {
265
+ constructor(private readonly app: Application) {}
266
+
267
+ private plugin(): PluginAi {
268
+ const plugin = this.app.pm.get('ai') as unknown as PluginAi | undefined;
269
+ if (!plugin?.aiEmployeesManager || !plugin?.aiConversationsManager) {
270
+ throw new Error('The official @nocobase/plugin-ai plugin is required to execute Loop Control Plane runs.');
271
+ }
272
+ return plugin;
273
+ }
274
+
275
+ async createConversation(input: { username: string; userId?: number; runId: number; title: string }) {
276
+ const conversation = await this.plugin().aiConversationsManager.create({
277
+ userId: input.userId,
278
+ aiEmployee: { username: input.username },
279
+ title: input.title,
280
+ category: 'task',
281
+ options: { controlPlaneRunId: input.runId },
282
+ });
283
+ const sessionId = String(read(conversation, 'sessionId') || '');
284
+ if (!sessionId) throw new Error('The AI conversation was created without a session identifier.');
285
+ return sessionId;
286
+ }
287
+
288
+ async invoke(input: {
289
+ username: string;
290
+ sessionId: string;
291
+ userId?: number;
292
+ systemMessage: string;
293
+ harness: CompiledHarness;
294
+ prompt: string;
295
+ signal: AbortSignal;
296
+ }): Promise<InvocationOutcome> {
297
+ const { aiEmployee } = await this.buildEmployee(input);
298
+
299
+ const result = (await aiEmployee.invoke({
300
+ userMessages: [{ role: 'user', content: { type: 'text', content: input.prompt } }],
301
+ signal: input.signal,
302
+ })) as Record<string, unknown>;
303
+
304
+ const interrupted = interruptedFrom(result, this.app);
305
+ await this.repairInterruptedCalls(input, result, interrupted);
306
+ return {
307
+ sessionId: input.sessionId,
308
+ messageId: String(result.messageId || ''),
309
+ interrupted,
310
+ content: textContent(result.messages),
311
+ tokenUsage: extractTokenUsageFromResult(result),
312
+ };
313
+ }
314
+
315
+ // Resume mirrors the official workflow employee node: flip the persisted tool call to
316
+ // `waiting` with a decision, then re-invoke so plugin-ai resumes its own checkpoint.
317
+ // Decisions are per tool call: plugin-ai stores one `userDecision` per interrupted row and
318
+ // `getUserDecisions` only unblocks once every interrupted call of the message has one.
319
+ async resume(input: {
320
+ username: string;
321
+ sessionId: string;
322
+ messageId: string;
323
+ userId?: number;
324
+ systemMessage: string;
325
+ harness: CompiledHarness;
326
+ decisions: Array<{ toolCallId: string; decision: ToolCallDecision }>;
327
+ signal: AbortSignal;
328
+ }): Promise<InvocationOutcome> {
329
+ const plugin = this.plugin();
330
+
331
+ for (const entry of input.decisions) {
332
+ await this.app.db.getModel('aiToolMessages').update(
333
+ { userDecision: entry.decision, invokeStatus: 'waiting' },
334
+ {
335
+ where: {
336
+ sessionId: input.sessionId,
337
+ messageId: input.messageId,
338
+ toolCallId: entry.toolCallId,
339
+ invokeStatus: 'interrupted',
340
+ },
341
+ },
342
+ );
343
+ }
344
+ const userDecisions = await plugin.aiConversationsManager.getUserDecisions(input.messageId);
345
+ if (!userDecisions) throw new Error('The interrupted tool calls are not all ready to resume.');
346
+
347
+ const { aiEmployee } = await this.buildEmployee(input);
348
+
349
+ const result = (await aiEmployee.invoke({
350
+ userDecisions: userDecisions as { interruptId?: string; decisions: never[] },
351
+ signal: input.signal,
352
+ })) as Record<string, unknown>;
353
+
354
+ const interrupted = interruptedFrom(result, this.app);
355
+ await this.repairInterruptedCalls(input, result, interrupted);
356
+ return {
357
+ sessionId: input.sessionId,
358
+ messageId: String(result.messageId || input.messageId),
359
+ interrupted,
360
+ content: textContent(result.messages),
361
+ tokenUsage: extractTokenUsageFromResult(result),
362
+ };
363
+ }
364
+
365
+ private async repairInterruptedCalls(
366
+ input: { sessionId: string; username: string },
367
+ result: Record<string, unknown>,
368
+ calls: InterruptedToolCall[],
369
+ ) {
370
+ if (new Set(calls.map((call) => call.toolName)).size === calls.length) return;
371
+
372
+ const invalidPayload = () => invalidInterrupt(this.app);
373
+ const interrupt = (result.__interrupt__ as Array<{ value?: Record<string, unknown> }>)[0];
374
+ const requests = interrupt.value?.actionRequests;
375
+ const reviews = interrupt.value?.reviewConfigs;
376
+ const messageId = String(result.messageId || '');
377
+ if (!Array.isArray(requests) || requests.length !== calls.length || !messageId) throw invalidPayload();
378
+ if (new Set(calls.map((call) => call.toolCallId)).size !== calls.length) throw invalidPayload();
379
+
380
+ await this.app.db.sequelize.transaction(async (transaction) => {
381
+ const messages = this.app.db.getModel('aiMessages');
382
+ const toolMessages = this.app.db.getModel('aiToolMessages');
383
+ const message = await messages.findOne({
384
+ where: { sessionId: input.sessionId, messageId, role: input.username },
385
+ transaction,
386
+ lock: transaction.LOCK.UPDATE,
387
+ });
388
+ const messageCalls = read(message, 'toolCalls');
389
+ if (!message || !Array.isArray(messageCalls)) throw invalidPayload();
390
+
391
+ for (const [order, call] of calls.entries()) {
392
+ const request = requests[order] as Record<string, unknown>;
393
+ const description = request.description;
394
+ const details = JSON.parse(String(description)) as Record<string, unknown>;
395
+ if (
396
+ request.name !== call.toolName ||
397
+ details.sessionId !== input.sessionId ||
398
+ details.username !== input.username ||
399
+ details.from !== 'main-agent' ||
400
+ !messageCalls.some((item) => read(item, 'id') === call.toolCallId && read(item, 'name') === call.toolName)
401
+ ) {
402
+ throw invalidPayload();
403
+ }
404
+ const where = {
405
+ sessionId: input.sessionId,
406
+ messageId,
407
+ toolCallId: call.toolCallId,
408
+ toolName: call.toolName,
409
+ };
410
+ const toolMessage = await toolMessages.findOne({ where, transaction, lock: transaction.LOCK.UPDATE });
411
+ const status = read(toolMessage, 'invokeStatus');
412
+ if (!toolMessage || (status !== 'init' && status !== 'interrupted') || read(toolMessage, 'userDecision')) {
413
+ throw invalidPayload();
414
+ }
415
+ const review = Array.isArray(reviews)
416
+ ? reviews.find((item) => read(item, 'actionName') === call.toolName)
417
+ : null;
418
+ const [updated] = await toolMessages.update(
419
+ {
420
+ invokeStatus: 'interrupted',
421
+ interruptActionOrder: order,
422
+ interruptAction: {
423
+ order,
424
+ description,
425
+ allowedDecisions: read(review, 'allowedDecisions'),
426
+ toolCall: { id: call.toolCallId, name: call.toolName },
427
+ currentConversation: { sessionId: input.sessionId, from: details.from, username: input.username },
428
+ },
429
+ },
430
+ { where: { ...where, invokeStatus: status }, transaction },
431
+ );
432
+ if (updated !== 1) throw invalidPayload();
433
+ }
434
+
435
+ const metadata = read(message, 'metadata');
436
+ const existingMetadata = metadata && typeof metadata === 'object' && !Array.isArray(metadata) ? metadata : {};
437
+ if (read(existingMetadata, 'interruptId') !== calls[0].interruptId) {
438
+ const [updated] = await messages.update(
439
+ { metadata: { ...existingMetadata, interruptId: calls[0].interruptId } },
440
+ { where: { sessionId: input.sessionId, messageId }, transaction },
441
+ );
442
+ if (updated !== 1) throw invalidPayload();
443
+ }
444
+ });
445
+ }
446
+
447
+ // The employee model is re-read per invocation and mutated only in memory. `isAutoCall` reads
448
+ // `employee.skillSettings` off the Sequelize dataValues, so `set()` without `save()` gates this
449
+ // run's tool calls without touching the shared employee configuration.
450
+ private async buildEmployee(input: {
451
+ username: string;
452
+ sessionId: string;
453
+ userId?: number;
454
+ systemMessage: string;
455
+ harness: CompiledHarness;
456
+ }) {
457
+ const plugin = this.plugin();
458
+ const employee = await plugin.aiEmployeesManager.getEmployee(input.username);
459
+ if (!employee) throw new Error(`AI employee "${input.username}" was not found.`);
460
+ const model = await plugin.aiEmployeesManager.resolveModel(employee);
461
+ const currentRoles = await this.rolesFor(input.userId);
462
+
463
+ const ctx = {
464
+ app: this.app,
465
+ db: this.app.db,
466
+ log: this.app.log,
467
+ logger: this.app.log,
468
+ state: {
469
+ currentRoles,
470
+ // Populate currentUser so currentUserId(ctx) resolves correctly.
471
+ currentUser: input.userId ? { id: input.userId } : undefined,
472
+ },
473
+ auth: { user: { id: input.userId } },
474
+ action: { params: { values: { sessionId: input.sessionId, model } } },
475
+ };
476
+
477
+ // Discovery runs with the same ctx the invocation will use, so context-scoped MCP tools
478
+ // resolve here exactly as they will when plugin-ai builds its tool map.
479
+ const plan = await planHarnessTools(this.app, input.harness, { ctx, sessionId: input.sessionId });
480
+
481
+ if (plan.withheld.length) {
482
+ this.app.logger.info(
483
+ `[AgentOrchestrator] Harness withheld ${plan.withheld.length} tool(s) from ${input.username}.`,
484
+ { withheld: plan.withheld },
485
+ );
486
+ }
487
+
488
+ const persisted = (employee.get('skillSettings') || {}) as Record<string, unknown>;
489
+ employee.set('skillSettings', { ...persisted, tools: plan.employeeTools });
490
+
491
+ // plugin-ai adds `knowledge-base-retrieve` whenever the employee has knowledge base enabled,
492
+ // and keeps it through the tool filter because it is a system tool. Clearing the in-memory flag
493
+ // is the only way a harness that does not grant it actually keeps it out of the model's hands.
494
+ const blockedSystemTools = new Set(plan.blockedSystemTools);
495
+ if (blockedSystemTools.has(SYSTEM_TOOL_KNOWLEDGE_BASE)) {
496
+ employee.set('enableKnowledgeBase', false);
497
+ }
498
+
499
+ const aiEmployee = new AIEmployee({
500
+ ctx: ctx as never,
501
+ employee,
502
+ sessionId: input.sessionId,
503
+ systemMessage: input.systemMessage,
504
+ skillSettings: { skillsVersion: 2, toolsVersion: 2, skills: [], tools: plan.filter },
505
+ // Same reasoning for web search: the flag is what injects the system tool, so it is only
506
+ // ever enabled when the harness explicitly granted it.
507
+ webSearch: !blockedSystemTools.has(SYSTEM_TOOL_WEB_SEARCH),
508
+ model,
509
+ });
510
+ return { aiEmployee, plan };
511
+ }
512
+
513
+ private async rolesFor(userId?: number) {
514
+ if (!userId) return [];
515
+ const rows = await this.app.db.getRepository('rolesUsers').find({ filter: { userId } });
516
+ return rows.map((row) => String(read(row, 'roleName') || '')).filter(Boolean);
517
+ }
518
+ }