plugin-agent-orchestrator 1.1.8 → 1.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (495) hide show
  1. package/LICENSE +201 -0
  2. package/README.md +207 -204
  3. package/client-v2.d.ts +2 -2
  4. package/client-v2.js +1 -1
  5. package/client.d.ts +2 -2
  6. package/client.js +1 -1
  7. package/dist/client/117.6c69b6a87751dd18.js +10 -0
  8. package/dist/client/253.52f62e1bc0e9520a.js +10 -0
  9. package/dist/client/325.8f7f509bdb35e142.js +10 -0
  10. package/dist/client/404.86593f98c9768ed5.js +10 -0
  11. package/dist/client/453.fa2d169576262213.js +10 -0
  12. package/dist/client/53.567db3ae078650c6.js +10 -0
  13. package/dist/client/619.01713281e5e951d3.js +10 -0
  14. package/dist/client/652.69da1598312b3a3f.js +10 -0
  15. package/dist/client/773.648965568ff476f9.js +10 -0
  16. package/dist/client/981.37e7aeecdb1ef6fa.js +10 -0
  17. package/dist/client/993.ac89f3852990918d.js +10 -0
  18. package/dist/client/index.js +1 -1
  19. package/dist/client-v2/117.c982d79ff68738f5.js +10 -0
  20. package/dist/client-v2/214.94c4257bf2838577.js +10 -0
  21. package/dist/client-v2/253.8e19956d2a44dfb8.js +10 -0
  22. package/dist/client-v2/264.80e8e358c8c6c2e5.js +10 -0
  23. package/dist/client-v2/325.fafe5a6e83ba9cb3.js +10 -0
  24. package/dist/client-v2/404.ab032b79c95dab6f.js +10 -0
  25. package/dist/client-v2/{41.3deb9e57a0f64fc4.js → 41.cd5610fcf7446127.js} +1 -1
  26. package/dist/client-v2/453.42c6d70628d56cc2.js +10 -0
  27. package/dist/client-v2/{53.349fff8db80b19d4.js → 53.37c08089a648f89a.js} +1 -1
  28. package/dist/client-v2/{619.0a2144aaffefe018.js → 619.6e9618550101e819.js} +1 -1
  29. package/dist/client-v2/652.eeba4e0c38367321.js +10 -0
  30. package/dist/client-v2/{70.ffff2997c10fd4b0.js → 70.332698e53eb59677.js} +1 -1
  31. package/dist/client-v2/773.4de2ba5acb07318c.js +10 -0
  32. package/dist/client-v2/981.76060f466e6f7c11.js +10 -0
  33. package/dist/client-v2/993.f8cdb5172566ce75.js +10 -0
  34. package/dist/client-v2/index.js +1 -1
  35. package/dist/externalVersion.js +13 -7
  36. package/dist/locale/en-US.json +308 -1
  37. package/dist/locale/vi-VN.json +5 -1
  38. package/dist/locale/zh-CN.json +308 -1
  39. package/dist/node_modules/acorn/LICENSE +21 -0
  40. package/dist/node_modules/acorn/bin/acorn +4 -0
  41. package/dist/node_modules/acorn/dist/acorn.d.mts +857 -0
  42. package/dist/node_modules/acorn/dist/acorn.d.ts +857 -0
  43. package/dist/node_modules/acorn/dist/acorn.js +1 -0
  44. package/dist/node_modules/acorn/dist/bin.js +90 -0
  45. package/dist/node_modules/acorn/package.json +1 -0
  46. package/dist/node_modules/acorn-walk/LICENSE +21 -0
  47. package/dist/node_modules/acorn-walk/dist/walk.d.mts +177 -0
  48. package/dist/node_modules/acorn-walk/dist/walk.d.ts +177 -0
  49. package/dist/node_modules/acorn-walk/dist/walk.js +1 -0
  50. package/dist/node_modules/acorn-walk/node_modules/.bin/acorn +15 -0
  51. package/dist/node_modules/acorn-walk/node_modules/.bin/acorn.cmd +7 -0
  52. package/dist/node_modules/acorn-walk/node_modules/acorn/bin/acorn +4 -0
  53. package/dist/node_modules/acorn-walk/node_modules/acorn/dist/acorn.d.mts +866 -0
  54. package/dist/node_modules/acorn-walk/node_modules/acorn/dist/acorn.d.ts +866 -0
  55. package/dist/node_modules/acorn-walk/node_modules/acorn/dist/acorn.js +6174 -0
  56. package/dist/node_modules/acorn-walk/node_modules/acorn/dist/bin.js +90 -0
  57. package/dist/node_modules/acorn-walk/node_modules/acorn/package.json +50 -0
  58. package/dist/node_modules/acorn-walk/package.json +1 -0
  59. package/dist/node_modules/adm-zip/adm-zip.js +1 -1
  60. package/dist/node_modules/adm-zip/package.json +1 -1
  61. package/dist/node_modules/ajv/package.json +1 -1
  62. package/dist/node_modules/zod/index.cjs +1 -1
  63. package/dist/node_modules/zod/package.json +1 -1
  64. package/dist/server/collections/agent-auto-approval-checkpoints.js +47 -0
  65. package/dist/server/collections/agent-execution-spans.js +148 -9
  66. package/dist/server/collections/agent-governance-audit-events.js +47 -0
  67. package/dist/server/collections/agent-governance-policies.js +47 -0
  68. package/dist/server/collections/agent-governance-policy-versions.js +48 -0
  69. package/dist/server/collections/agent-governance-prompt-bindings.js +50 -0
  70. package/dist/server/collections/agent-hierarchy-invocations.js +59 -0
  71. package/dist/server/collections/agent-loop-runs.js +23 -5
  72. package/dist/server/collections/agent-routing-graph-locks.js +40 -0
  73. package/dist/server/collections/agent-session-auto-approvals.js +45 -0
  74. package/dist/server/collections/orchestrator-config.js +17 -0
  75. package/dist/server/migrations/20261110000000-add-usage-pricing-snapshots.js +117 -0
  76. package/dist/server/migrations/20261110010000-add-usage-department-attribution.js +54 -0
  77. package/dist/server/migrations/20261119000000-widen-native-employee-identifiers.js +59 -0
  78. package/dist/server/plugin.js +169 -33
  79. package/dist/server/resources/agent-auto-approval.js +80 -0
  80. package/dist/server/resources/agent-governance.js +192 -0
  81. package/dist/server/resources/agent-harness-profile.js +11 -3
  82. package/dist/server/resources/agent-monitor.js +109 -339
  83. package/dist/server/resources/agent-usage.js +423 -0
  84. package/dist/server/resources/hierarchical-routing.js +60 -0
  85. package/dist/server/resources/native-monitor-format.js +179 -0
  86. package/dist/server/resources/tracing.js +35 -12
  87. package/dist/server/services/AgentGovernanceService.js +500 -0
  88. package/dist/server/services/AutoApprovalCheckpoint.js +133 -0
  89. package/dist/server/services/CodeValidator.js +8 -4
  90. package/dist/server/services/DepartmentAttribution.js +65 -0
  91. package/dist/server/services/ExecutionSpanService.js +96 -3
  92. package/dist/server/services/GovernanceAdmission.js +271 -0
  93. package/dist/server/services/HarnessCapabilities.js +118 -0
  94. package/dist/server/services/HarnessCompiler.js +3 -0
  95. package/dist/server/services/HarnessSchema.js +13 -1
  96. package/dist/server/services/HierarchicalAgentRuntime.js +925 -0
  97. package/dist/server/services/HierarchyEnrollmentGuard.js +216 -0
  98. package/dist/server/services/HierarchyInvocationJournal.js +157 -0
  99. package/dist/server/services/HierarchyRequestCancellation.js +150 -0
  100. package/dist/server/services/LoopBudgetService.js +29 -11
  101. package/dist/server/services/LoopRunRepository.js +16 -7
  102. package/dist/server/services/LoopRunStateMachine.js +20 -9
  103. package/dist/server/services/LoopTriggerService.js +1 -1
  104. package/dist/server/services/LoopWorkerService.js +71 -37
  105. package/dist/server/services/ManagedPromptProtection.js +99 -0
  106. package/dist/server/services/NativeAgentMonitorSyncService.js +584 -0
  107. package/dist/server/services/NativeSubAgentObserver.js +141 -508
  108. package/dist/server/services/NativeUsageAttribution.js +97 -0
  109. package/dist/server/services/PluginAiRuntimeAdapter.js +107 -9
  110. package/dist/server/services/RoutingBindingRepository.js +156 -0
  111. package/dist/server/services/RoutingBindingValidation.js +161 -0
  112. package/dist/server/services/SandboxRunner.js +19 -0
  113. package/dist/server/services/SessionAutoApproval.js +173 -0
  114. package/dist/server/services/TokenTracker.js +787 -104
  115. package/dist/server/services/TracingRetentionPolicy.js +66 -0
  116. package/dist/server/services/VerificationService.js +20 -10
  117. package/dist/server/skill-hub/plugin.js +17 -0
  118. package/dist/server/skill-hub/sandbox-config.json +6 -6
  119. package/dist/server/skill-hub/services/RegistrySkillInstallationService.js +2 -2
  120. package/dist/server/skill-hub/services/registry-node-package.js +191 -0
  121. package/dist/server/skill-hub/tasks/SkillExecutionTask.js +21 -6
  122. package/dist/server/tools/skill-execute.js +1 -0
  123. package/dist/server/utils/ensure-indexes.js +15 -5
  124. package/package.json +66 -53
  125. package/server.d.ts +2 -2
  126. package/server.js +1 -1
  127. package/src/client/AgentRunsTab.tsx +2 -2
  128. package/src/client/ApprovalsTab.tsx +2 -2
  129. package/src/client/HarnessProfilesTab.tsx +2 -2
  130. package/src/client/OrchestratorSettings.tsx +152 -152
  131. package/src/client/SkillPages.tsx +34 -0
  132. package/src/client/__tests__/embedded-settings.test.tsx +225 -0
  133. package/src/client/hooks/useRunEventStream.ts +76 -76
  134. package/src/client/index.tsx +2 -2
  135. package/src/client/plugin.tsx +71 -33
  136. package/src/client/skill-hub/components/ExecutionHistory.tsx +200 -200
  137. package/src/client/skill-hub/components/GitSkillImport.tsx +562 -562
  138. package/src/client/skill-hub/components/LoopSettings.tsx +331 -331
  139. package/src/client/skill-hub/components/SkillEditor.tsx +460 -460
  140. package/src/client/skill-hub/components/SkillManager.tsx +194 -194
  141. package/src/client/skill-hub/components/SkillMetrics.tsx +162 -162
  142. package/src/client/skill-hub/components/SkillTestPanel.tsx +141 -141
  143. package/src/client/skill-hub/index.tsx +6 -6
  144. package/src/client/skill-hub/locale.ts +16 -16
  145. package/src/client/skill-hub/tools/InteractionSchemasProvider.tsx +147 -132
  146. package/src/client/skill-hub/tools/SkillHubCard.tsx +110 -104
  147. package/src/client/skill-hub/tools/__tests__/skill-hub-card.test.tsx +255 -0
  148. package/src/client/skill-hub/tools/loopTemplates.ts +52 -52
  149. package/src/client/skill-hub/tools/registerSkillLoopCards.ts +80 -71
  150. package/src/client/skill-hub/utils/jsonFields.ts +41 -41
  151. package/src/client-v2/__tests__/embedded-settings.test.tsx +202 -0
  152. package/src/client-v2/__tests__/hierarchical-routing-settings.test.tsx +350 -0
  153. package/src/client-v2/auto-approval/AutoApprovalBridge.tsx +513 -0
  154. package/src/client-v2/auto-approval/AutoApprovalProvider.tsx +399 -0
  155. package/src/client-v2/auto-approval/__tests__/session-auto-approval.test.tsx +1676 -0
  156. package/src/client-v2/components/AIEmployeeSelect.tsx +47 -47
  157. package/src/client-v2/components/AIEmployeesContext.tsx +97 -97
  158. package/src/client-v2/components/AgentBindingsTab.tsx +541 -269
  159. package/src/client-v2/components/AgentRunsTab.tsx +85 -83
  160. package/src/client-v2/components/ApprovalsTab.tsx +337 -337
  161. package/src/client-v2/components/EmployeeGovernanceTab.tsx +695 -0
  162. package/src/client-v2/components/HarnessProfilesTab.tsx +700 -541
  163. package/src/client-v2/components/HarnessSettingsForm.tsx +221 -0
  164. package/src/client-v2/components/KnowledgeAccessTab.tsx +116 -116
  165. package/src/client-v2/components/RetrievalTraceTab.tsx +162 -162
  166. package/src/client-v2/components/UsageGovernanceTab.tsx +379 -0
  167. package/src/client-v2/index.tsx +1 -1
  168. package/src/client-v2/pages/AgentBindingsPage.tsx +15 -13
  169. package/src/client-v2/pages/ApprovalsPage.tsx +12 -10
  170. package/src/client-v2/pages/EmployeeGovernancePage.tsx +15 -0
  171. package/src/client-v2/pages/ExecutionHistoryPage.tsx +12 -10
  172. package/src/client-v2/pages/HarnessProfilesPage.tsx +12 -10
  173. package/src/client-v2/pages/KnowledgeAccessPage.tsx +12 -10
  174. package/src/client-v2/pages/LoopSettingsPage.tsx +12 -10
  175. package/src/client-v2/pages/MemoryInspectorPage.tsx +15 -13
  176. package/src/client-v2/pages/RetrievalTracePage.tsx +12 -10
  177. package/src/client-v2/pages/RulesPage.tsx +15 -13
  178. package/src/client-v2/pages/SkillDefinitionsPage.tsx +12 -10
  179. package/src/client-v2/pages/SkillMetricsPage.tsx +12 -10
  180. package/src/client-v2/pages/TracingPage.tsx +15 -13
  181. package/src/client-v2/pages/UsageGovernancePage.tsx +15 -0
  182. package/src/client-v2/plugin.tsx +134 -111
  183. package/src/client-v2/skill-hub/components/ExecutionHistory.tsx +196 -196
  184. package/src/client-v2/skill-hub/components/FileLinkList.tsx +37 -37
  185. package/src/client-v2/skill-hub/components/GitSkillImport.tsx +539 -539
  186. package/src/client-v2/skill-hub/components/LoopSettings.tsx +331 -331
  187. package/src/client-v2/skill-hub/components/SkillEditor.tsx +453 -453
  188. package/src/client-v2/skill-hub/components/SkillManager.tsx +191 -174
  189. package/src/client-v2/skill-hub/components/SkillMetrics.tsx +162 -162
  190. package/src/client-v2/skill-hub/components/SkillTestPanel.tsx +135 -135
  191. package/src/client-v2/skill-hub/locale.ts +13 -13
  192. package/src/client-v2/skill-hub/tools/InteractionSchemasProvider.tsx +62 -0
  193. package/src/client-v2/skill-hub/tools/SkillHubCard.tsx +104 -0
  194. package/src/client-v2/skill-hub/tools/__tests__/interactions.test.ts +126 -0
  195. package/src/client-v2/skill-hub/tools/interactions.ts +137 -0
  196. package/src/client-v2/skill-hub/tools/loopTemplates.ts +52 -52
  197. package/src/client-v2/skill-hub/utils/jsonFields.ts +41 -41
  198. package/src/client-v2/utils/jsonFields.ts +41 -41
  199. package/src/index.ts +2 -2
  200. package/src/locale/en-US.json +308 -1
  201. package/src/locale/vi-VN.json +5 -1
  202. package/src/locale/zh-CN.json +308 -1
  203. package/src/server/__tests__/agent-execution-context.test.ts +18 -18
  204. package/src/server/__tests__/agent-governance.integration.test.ts +385 -0
  205. package/src/server/__tests__/agent-knowledge-insights.test.ts +123 -123
  206. package/src/server/__tests__/agent-monitor-acl.integration.test.ts +267 -0
  207. package/src/server/__tests__/agent-registry-service.test.ts +147 -147
  208. package/src/server/__tests__/agent-runtime-lifecycle.test.ts +46 -46
  209. package/src/server/__tests__/agent-usage-report.integration.test.ts +335 -0
  210. package/src/server/__tests__/auto-approval-checkpoint.integration.test.ts +295 -0
  211. package/src/server/__tests__/code-validator.test.ts +63 -63
  212. package/src/server/__tests__/external-rag-search.test.ts +107 -107
  213. package/src/server/__tests__/harness-capabilities.test.ts +88 -0
  214. package/src/server/__tests__/harness-compiler.test.ts +278 -214
  215. package/src/server/__tests__/harness-profile-service.test.ts +167 -167
  216. package/src/server/__tests__/harness-runtime-policy.test.ts +293 -293
  217. package/src/server/__tests__/harness-tool-plan.test.ts +175 -172
  218. package/src/server/__tests__/hierarchical-routing.integration.test.ts +2318 -0
  219. package/src/server/__tests__/hierarchy-invocation-journal.integration.test.ts +119 -0
  220. package/src/server/__tests__/input-schema-validator.test.ts +26 -26
  221. package/src/server/__tests__/loop-approval-decision.test.ts +624 -512
  222. package/src/server/__tests__/loop-approval-expiry.test.ts +258 -258
  223. package/src/server/__tests__/loop-budget-service.test.ts +29 -0
  224. package/src/server/__tests__/loop-pattern-schema.test.ts +73 -73
  225. package/src/server/__tests__/loop-run-repository.test.ts +25 -0
  226. package/src/server/__tests__/loop-run-state-machine.test.ts +101 -101
  227. package/src/server/__tests__/loop-trigger-service.test.ts +185 -148
  228. package/src/server/__tests__/loop-worker-claim.test.ts +110 -10
  229. package/src/server/__tests__/loop-worker-execution.test.ts +375 -317
  230. package/src/server/__tests__/native-agent-monitor-sync.test.ts +343 -0
  231. package/src/server/__tests__/native-hierarchy-probe.integration.test.ts +527 -0
  232. package/src/server/__tests__/native-sub-agent-observer.test.ts +463 -662
  233. package/src/server/__tests__/native-usage-attribution.integration.test.ts +168 -0
  234. package/src/server/__tests__/plugin-ai-runtime-adapter.test.ts +403 -0
  235. package/src/server/__tests__/registry-node-package.test.ts +299 -0
  236. package/src/server/__tests__/routing-binding-graph.integration.test.ts +217 -0
  237. package/src/server/__tests__/routing-binding-validation.test.ts +256 -0
  238. package/src/server/__tests__/session-auto-approval.integration.test.ts +329 -0
  239. package/src/server/__tests__/skill-access-service.test.ts +64 -64
  240. package/src/server/__tests__/skill-execute.test.ts +81 -70
  241. package/src/server/__tests__/skill-execution-task-policy.test.ts +140 -140
  242. package/src/server/__tests__/skill-review-guard.test.ts +171 -0
  243. package/src/server/__tests__/skill-sandbox-worker-mode.test.ts +15 -15
  244. package/src/server/__tests__/skill-settings.test.ts +63 -63
  245. package/src/server/__tests__/skill-tool-name.test.ts +23 -23
  246. package/src/server/__tests__/token-tracker.test.ts +632 -0
  247. package/src/server/__tests__/tool-loop-detection.test.ts +276 -276
  248. package/src/server/__tests__/tracing-retention-policy.test.ts +30 -0
  249. package/src/server/__tests__/usage-ledger.integration.test.ts +187 -0
  250. package/src/server/collections/agent-auto-approval-checkpoints.ts +18 -0
  251. package/src/server/collections/agent-execution-spans.ts +386 -245
  252. package/src/server/collections/agent-governance-audit-events.ts +19 -0
  253. package/src/server/collections/agent-governance-policies.ts +19 -0
  254. package/src/server/collections/agent-governance-policy-versions.ts +20 -0
  255. package/src/server/collections/agent-governance-prompt-bindings.ts +22 -0
  256. package/src/server/collections/agent-hierarchy-invocations.ts +30 -0
  257. package/src/server/collections/agent-loop-action-approvals.ts +39 -39
  258. package/src/server/collections/agent-loop-runs.ts +389 -369
  259. package/src/server/collections/agent-loop-steps.ts +220 -220
  260. package/src/server/collections/agent-memory-contexts.ts +95 -95
  261. package/src/server/collections/agent-routing-graph-locks.ts +11 -0
  262. package/src/server/collections/agent-session-auto-approvals.ts +16 -0
  263. package/src/server/collections/orchestrator-config.ts +113 -87
  264. package/src/server/collections/orchestrator-logs.ts +116 -116
  265. package/src/server/collections/skill-definitions.ts +159 -159
  266. package/src/server/collections/skill-executions.ts +154 -154
  267. package/src/server/collections/skill-loop-configs.ts +65 -65
  268. package/src/server/collections/skill-metrics.ts +36 -36
  269. package/src/server/collections/skill-registry-installations.ts +41 -41
  270. package/src/server/collections/skill-worker-configs.ts +86 -86
  271. package/src/server/index.ts +1 -1
  272. package/src/server/migrations/20260423000000-add-progress-fields.ts +50 -50
  273. package/src/server/migrations/20260425000000-add-interaction-schema.ts +37 -37
  274. package/src/server/migrations/20260427000000-add-tracing-detail-fields.ts +41 -41
  275. package/src/server/migrations/20260427000001-change-other-json-to-text.ts +61 -61
  276. package/src/server/migrations/20260524001000-add-plan-approval-and-harness-profiles.ts +145 -145
  277. package/src/server/migrations/20260601000000-add-token-fields.ts +89 -89
  278. package/src/server/migrations/20260615000000-normalize-ai-employee-tool-bindings.ts +39 -39
  279. package/src/server/migrations/20260621000000-native-policy-profile-defaults.ts +190 -190
  280. package/src/server/migrations/20260727000000-remove-unused-knowledge-scopes.ts +25 -25
  281. package/src/server/migrations/20260727010000-backfill-skill-tool-names.ts +45 -45
  282. package/src/server/migrations/20261110000000-add-usage-pricing-snapshots.ts +110 -0
  283. package/src/server/migrations/20261110010000-add-usage-department-attribution.ts +28 -0
  284. package/src/server/migrations/20261119000000-widen-native-employee-identifiers.ts +37 -0
  285. package/src/server/plugin.ts +724 -573
  286. package/src/server/resources/agent-auto-approval.ts +51 -0
  287. package/src/server/resources/agent-governance.ts +161 -0
  288. package/src/server/resources/agent-harness-profile.ts +103 -94
  289. package/src/server/resources/agent-knowledge-insights.ts +306 -306
  290. package/src/server/resources/agent-loop-approval.ts +84 -84
  291. package/src/server/resources/agent-loop-events-stream.ts +108 -108
  292. package/src/server/resources/agent-loop.ts +252 -252
  293. package/src/server/resources/agent-monitor.ts +208 -482
  294. package/src/server/resources/agent-usage.ts +413 -0
  295. package/src/server/resources/hierarchical-routing.ts +39 -0
  296. package/src/server/resources/native-monitor-format.ts +150 -0
  297. package/src/server/resources/tracing.ts +296 -267
  298. package/src/server/services/AgentExecutionContext.ts +23 -23
  299. package/src/server/services/AgentGovernanceService.ts +541 -0
  300. package/src/server/services/AgentMemoryContextService.ts +344 -344
  301. package/src/server/services/AgentRegistryService.ts +220 -220
  302. package/src/server/services/AgentRuntimeLifecycle.ts +64 -64
  303. package/src/server/services/AutoApprovalCheckpoint.ts +140 -0
  304. package/src/server/services/CodeValidator.ts +257 -238
  305. package/src/server/services/DepartmentAttribution.ts +47 -0
  306. package/src/server/services/DurableCircuitBreakerService.ts +235 -235
  307. package/src/server/services/ExecutionSpanService.ts +271 -146
  308. package/src/server/services/FileManager.ts +159 -159
  309. package/src/server/services/GovernanceAdmission.ts +314 -0
  310. package/src/server/services/HarnessCapabilities.ts +112 -0
  311. package/src/server/services/HarnessCompiler.ts +182 -170
  312. package/src/server/services/HarnessProfileService.ts +235 -235
  313. package/src/server/services/HarnessSchema.ts +224 -194
  314. package/src/server/services/HierarchicalAgentRuntime.ts +1052 -0
  315. package/src/server/services/HierarchyEnrollmentGuard.ts +211 -0
  316. package/src/server/services/HierarchyInvocationJournal.ts +172 -0
  317. package/src/server/services/HierarchyRequestCancellation.ts +132 -0
  318. package/src/server/services/InputSchemaValidator.ts +44 -44
  319. package/src/server/services/LoopBudgetService.ts +325 -271
  320. package/src/server/services/LoopControlService.ts +120 -120
  321. package/src/server/services/LoopPatternSchema.ts +231 -231
  322. package/src/server/services/LoopPatternService.ts +171 -171
  323. package/src/server/services/LoopRunRepository.ts +343 -332
  324. package/src/server/services/LoopRunStateMachine.ts +538 -525
  325. package/src/server/services/LoopSchedulerService.ts +195 -195
  326. package/src/server/services/LoopTriggerService.ts +162 -159
  327. package/src/server/services/LoopWorkerService.ts +975 -912
  328. package/src/server/services/ManagedPromptProtection.ts +81 -0
  329. package/src/server/services/NativeAgentMonitorSyncService.ts +684 -0
  330. package/src/server/services/NativeSubAgentObserver.ts +324 -757
  331. package/src/server/services/NativeUsageAttribution.ts +91 -0
  332. package/src/server/services/PathLockService.ts +317 -317
  333. package/src/server/services/PluginAiRuntimeAdapter.ts +518 -387
  334. package/src/server/services/RoutingBindingRepository.ts +146 -0
  335. package/src/server/services/RoutingBindingValidation.ts +161 -0
  336. package/src/server/services/RunEventBus.ts +58 -58
  337. package/src/server/services/SandboxRunner.ts +526 -492
  338. package/src/server/services/SessionAutoApproval.ts +167 -0
  339. package/src/server/services/SkillAccessService.ts +175 -175
  340. package/src/server/services/SkillManager.ts +585 -585
  341. package/src/server/services/SkillRepositoryService.ts +236 -236
  342. package/src/server/services/TokenTracker.ts +1151 -287
  343. package/src/server/services/ToolLoopDetectionService.ts +210 -210
  344. package/src/server/services/TracingRetentionPolicy.ts +49 -0
  345. package/src/server/services/VerificationSchema.ts +31 -31
  346. package/src/server/services/VerificationService.ts +325 -313
  347. package/src/server/services/WorkerEnvManager.ts +198 -198
  348. package/src/server/services/__tests__/SkillRepositoryService.test.ts +33 -33
  349. package/src/server/services/harness-runtime-policy.ts +134 -134
  350. package/src/server/services/pythonGuardTemplate.ts +87 -87
  351. package/src/server/services/sandboxCapabilities.ts +348 -348
  352. package/src/server/skill-hub/actions/__tests__/git-import.test.ts +563 -563
  353. package/src/server/skill-hub/actions/git-import.ts +936 -936
  354. package/src/server/skill-hub/mcp/McpController.ts +107 -107
  355. package/src/server/skill-hub/middlewares/git-import-request-method-policy.ts +51 -51
  356. package/src/server/skill-hub/plugin.ts +1272 -1232
  357. package/src/server/skill-hub/sandbox-config.json +6 -6
  358. package/src/server/skill-hub/services/RegistrySkillInstallationService.ts +291 -281
  359. package/src/server/skill-hub/services/__tests__/RegistrySkillInstallationService.test.ts +295 -295
  360. package/src/server/skill-hub/services/registry-node-package.ts +191 -0
  361. package/src/server/skill-hub/tasks/SkillExecutionTask.ts +597 -568
  362. package/src/server/skill-hub/utils/json-fields.ts +57 -57
  363. package/src/server/tools/delegate-task.ts +30 -30
  364. package/src/server/tools/external-rag-search.ts +329 -329
  365. package/src/server/tools/skill-execute.ts +226 -216
  366. package/src/server/types.ts +21 -21
  367. package/src/server/utils/ai-manager.ts +24 -24
  368. package/src/server/utils/ctx-utils.ts +132 -132
  369. package/src/server/utils/ensure-indexes.ts +113 -96
  370. package/src/server/utils/ha-lock.ts +80 -80
  371. package/src/server/utils/loop-pattern-context.ts +84 -84
  372. package/src/server/utils/record-utils.ts +19 -19
  373. package/src/server/utils/skill-settings.ts +135 -135
  374. package/src/server/utils/skill-tool-name.ts +58 -58
  375. package/dist/client-v2/117.7565cff57c39318a.js +0 -10
  376. package/dist/client-v2/214.106635011859dede.js +0 -10
  377. package/dist/client-v2/253.59577b40d9875be0.js +0 -10
  378. package/dist/client-v2/264.7ed8bee71fa5935c.js +0 -10
  379. package/dist/client-v2/418.41ed200e7d6da332.js +0 -10
  380. package/dist/client-v2/794.a67a2614405ba627.js +0 -10
  381. package/dist/client-v2/981.e4a1f41cfc94a856.js +0 -10
  382. package/dist/client-v2/993.b0688fdc5ccb000a.js +0 -10
  383. package/dist/node_modules/simple-git/dist/cjs/index.js +0 -7399
  384. package/dist/node_modules/simple-git/dist/esm/index.js +0 -4745
  385. package/dist/node_modules/simple-git/dist/esm/package.json +0 -3
  386. package/dist/node_modules/simple-git/dist/src/lib/api.d.ts +0 -13
  387. package/dist/node_modules/simple-git/dist/src/lib/args/log-format.d.ts +0 -9
  388. package/dist/node_modules/simple-git/dist/src/lib/errors/git-construct-error.d.ts +0 -15
  389. package/dist/node_modules/simple-git/dist/src/lib/errors/git-error.d.ts +0 -30
  390. package/dist/node_modules/simple-git/dist/src/lib/errors/git-plugin-error.d.ts +0 -7
  391. package/dist/node_modules/simple-git/dist/src/lib/errors/git-response-error.d.ts +0 -32
  392. package/dist/node_modules/simple-git/dist/src/lib/errors/task-configuration-error.d.ts +0 -12
  393. package/dist/node_modules/simple-git/dist/src/lib/git-factory.d.ts +0 -15
  394. package/dist/node_modules/simple-git/dist/src/lib/git-logger.d.ts +0 -21
  395. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-branch-delete.d.ts +0 -5
  396. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-branch.d.ts +0 -2
  397. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-commit.d.ts +0 -2
  398. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-diff-summary.d.ts +0 -3
  399. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-fetch.d.ts +0 -2
  400. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-list-log-summary.d.ts +0 -6
  401. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-merge.d.ts +0 -11
  402. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-move.d.ts +0 -2
  403. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-pull.d.ts +0 -6
  404. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-push.d.ts +0 -4
  405. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-remote-messages.d.ts +0 -5
  406. package/dist/node_modules/simple-git/dist/src/lib/parsers/parse-remote-objects.d.ts +0 -3
  407. package/dist/node_modules/simple-git/dist/src/lib/plugins/abort-plugin.d.ts +0 -3
  408. package/dist/node_modules/simple-git/dist/src/lib/plugins/block-unsafe-operations-plugin.d.ts +0 -3
  409. package/dist/node_modules/simple-git/dist/src/lib/plugins/command-config-prefixing-plugin.d.ts +0 -2
  410. package/dist/node_modules/simple-git/dist/src/lib/plugins/completion-detection.plugin.d.ts +0 -3
  411. package/dist/node_modules/simple-git/dist/src/lib/plugins/custom-binary.plugin.d.ts +0 -3
  412. package/dist/node_modules/simple-git/dist/src/lib/plugins/error-detection.plugin.d.ts +0 -7
  413. package/dist/node_modules/simple-git/dist/src/lib/plugins/index.d.ts +0 -11
  414. package/dist/node_modules/simple-git/dist/src/lib/plugins/plugin-store.d.ts +0 -11
  415. package/dist/node_modules/simple-git/dist/src/lib/plugins/progress-monitor-plugin.d.ts +0 -3
  416. package/dist/node_modules/simple-git/dist/src/lib/plugins/simple-git-plugin.d.ts +0 -48
  417. package/dist/node_modules/simple-git/dist/src/lib/plugins/spawn-options-plugin.d.ts +0 -3
  418. package/dist/node_modules/simple-git/dist/src/lib/plugins/suffix-paths.plugin.d.ts +0 -2
  419. package/dist/node_modules/simple-git/dist/src/lib/plugins/timout-plugin.d.ts +0 -3
  420. package/dist/node_modules/simple-git/dist/src/lib/responses/BranchDeleteSummary.d.ts +0 -12
  421. package/dist/node_modules/simple-git/dist/src/lib/responses/BranchSummary.d.ts +0 -14
  422. package/dist/node_modules/simple-git/dist/src/lib/responses/CheckIgnore.d.ts +0 -4
  423. package/dist/node_modules/simple-git/dist/src/lib/responses/CleanSummary.d.ts +0 -9
  424. package/dist/node_modules/simple-git/dist/src/lib/responses/ConfigList.d.ts +0 -13
  425. package/dist/node_modules/simple-git/dist/src/lib/responses/DiffSummary.d.ts +0 -10
  426. package/dist/node_modules/simple-git/dist/src/lib/responses/FileStatusSummary.d.ts +0 -9
  427. package/dist/node_modules/simple-git/dist/src/lib/responses/GetRemoteSummary.d.ts +0 -11
  428. package/dist/node_modules/simple-git/dist/src/lib/responses/InitSummary.d.ts +0 -9
  429. package/dist/node_modules/simple-git/dist/src/lib/responses/MergeSummary.d.ts +0 -16
  430. package/dist/node_modules/simple-git/dist/src/lib/responses/PullSummary.d.ts +0 -25
  431. package/dist/node_modules/simple-git/dist/src/lib/responses/StatusSummary.d.ts +0 -19
  432. package/dist/node_modules/simple-git/dist/src/lib/responses/TagList.d.ts +0 -7
  433. package/dist/node_modules/simple-git/dist/src/lib/runners/git-executor-chain.d.ts +0 -25
  434. package/dist/node_modules/simple-git/dist/src/lib/runners/git-executor.d.ts +0 -14
  435. package/dist/node_modules/simple-git/dist/src/lib/runners/promise-wrapped.d.ts +0 -2
  436. package/dist/node_modules/simple-git/dist/src/lib/runners/scheduler.d.ts +0 -11
  437. package/dist/node_modules/simple-git/dist/src/lib/runners/tasks-pending-queue.d.ts +0 -23
  438. package/dist/node_modules/simple-git/dist/src/lib/simple-git-api.d.ts +0 -20
  439. package/dist/node_modules/simple-git/dist/src/lib/task-callback.d.ts +0 -2
  440. package/dist/node_modules/simple-git/dist/src/lib/tasks/apply-patch.d.ts +0 -3
  441. package/dist/node_modules/simple-git/dist/src/lib/tasks/branch.d.ts +0 -7
  442. package/dist/node_modules/simple-git/dist/src/lib/tasks/change-working-directory.d.ts +0 -2
  443. package/dist/node_modules/simple-git/dist/src/lib/tasks/check-ignore.d.ts +0 -2
  444. package/dist/node_modules/simple-git/dist/src/lib/tasks/check-is-repo.d.ts +0 -9
  445. package/dist/node_modules/simple-git/dist/src/lib/tasks/checkout.d.ts +0 -2
  446. package/dist/node_modules/simple-git/dist/src/lib/tasks/clean.d.ts +0 -25
  447. package/dist/node_modules/simple-git/dist/src/lib/tasks/clone.d.ts +0 -9
  448. package/dist/node_modules/simple-git/dist/src/lib/tasks/commit.d.ts +0 -4
  449. package/dist/node_modules/simple-git/dist/src/lib/tasks/config.d.ts +0 -8
  450. package/dist/node_modules/simple-git/dist/src/lib/tasks/count-objects.d.ts +0 -12
  451. package/dist/node_modules/simple-git/dist/src/lib/tasks/diff-name-status.d.ts +0 -12
  452. package/dist/node_modules/simple-git/dist/src/lib/tasks/diff.d.ts +0 -5
  453. package/dist/node_modules/simple-git/dist/src/lib/tasks/fetch.d.ts +0 -4
  454. package/dist/node_modules/simple-git/dist/src/lib/tasks/first-commit.d.ts +0 -2
  455. package/dist/node_modules/simple-git/dist/src/lib/tasks/grep.d.ts +0 -12
  456. package/dist/node_modules/simple-git/dist/src/lib/tasks/hash-object.d.ts +0 -5
  457. package/dist/node_modules/simple-git/dist/src/lib/tasks/init.d.ts +0 -3
  458. package/dist/node_modules/simple-git/dist/src/lib/tasks/log.d.ts +0 -32
  459. package/dist/node_modules/simple-git/dist/src/lib/tasks/merge.d.ts +0 -4
  460. package/dist/node_modules/simple-git/dist/src/lib/tasks/move.d.ts +0 -3
  461. package/dist/node_modules/simple-git/dist/src/lib/tasks/pull.d.ts +0 -3
  462. package/dist/node_modules/simple-git/dist/src/lib/tasks/push.d.ts +0 -9
  463. package/dist/node_modules/simple-git/dist/src/lib/tasks/remote.d.ts +0 -8
  464. package/dist/node_modules/simple-git/dist/src/lib/tasks/reset.d.ts +0 -11
  465. package/dist/node_modules/simple-git/dist/src/lib/tasks/show.d.ts +0 -2
  466. package/dist/node_modules/simple-git/dist/src/lib/tasks/stash-list.d.ts +0 -4
  467. package/dist/node_modules/simple-git/dist/src/lib/tasks/status.d.ts +0 -3
  468. package/dist/node_modules/simple-git/dist/src/lib/tasks/sub-module.d.ts +0 -5
  469. package/dist/node_modules/simple-git/dist/src/lib/tasks/tag.d.ts +0 -18
  470. package/dist/node_modules/simple-git/dist/src/lib/tasks/task.d.ts +0 -14
  471. package/dist/node_modules/simple-git/dist/src/lib/tasks/version.d.ts +0 -9
  472. package/dist/node_modules/simple-git/dist/src/lib/types/handlers.d.ts +0 -21
  473. package/dist/node_modules/simple-git/dist/src/lib/types/index.d.ts +0 -136
  474. package/dist/node_modules/simple-git/dist/src/lib/types/tasks.d.ts +0 -19
  475. package/dist/node_modules/simple-git/dist/src/lib/utils/argument-filters.d.ts +0 -14
  476. package/dist/node_modules/simple-git/dist/src/lib/utils/exit-codes.d.ts +0 -10
  477. package/dist/node_modules/simple-git/dist/src/lib/utils/git-output-streams.d.ts +0 -7
  478. package/dist/node_modules/simple-git/dist/src/lib/utils/index.d.ts +0 -8
  479. package/dist/node_modules/simple-git/dist/src/lib/utils/line-parser.d.ts +0 -15
  480. package/dist/node_modules/simple-git/dist/src/lib/utils/simple-git-options.d.ts +0 -2
  481. package/dist/node_modules/simple-git/dist/src/lib/utils/task-options.d.ts +0 -13
  482. package/dist/node_modules/simple-git/dist/src/lib/utils/task-parser.d.ts +0 -5
  483. package/dist/node_modules/simple-git/dist/src/lib/utils/util.d.ts +0 -47
  484. package/dist/node_modules/simple-git/dist/typings/errors.d.ts +0 -5
  485. package/dist/node_modules/simple-git/dist/typings/index.d.ts +0 -14
  486. package/dist/node_modules/simple-git/dist/typings/response.d.ts +0 -556
  487. package/dist/node_modules/simple-git/dist/typings/simple-git.d.ts +0 -1033
  488. package/dist/node_modules/simple-git/dist/typings/types.d.ts +0 -22
  489. package/dist/node_modules/simple-git/node_modules/debug/package.json +0 -64
  490. package/dist/node_modules/simple-git/node_modules/debug/src/browser.js +0 -272
  491. package/dist/node_modules/simple-git/node_modules/debug/src/common.js +0 -292
  492. package/dist/node_modules/simple-git/node_modules/debug/src/index.js +0 -10
  493. package/dist/node_modules/simple-git/node_modules/debug/src/node.js +0 -263
  494. package/dist/node_modules/simple-git/package.json +0 -1
  495. package/dist/node_modules/simple-git/promise.js +0 -17
@@ -0,0 +1,2318 @@
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 { createMockServer, type MockServer } from '@nocobase/test';
11
+ import { AIMessage, AIMessageChunk, BaseMessage, ToolMessage } from '@langchain/core/messages';
12
+ import { BaseChatModel } from '@langchain/core/language_models/chat_models';
13
+ import { ChatGenerationChunk } from '@langchain/core/outputs';
14
+ import { FakeChatModel } from '@langchain/core/utils/testing';
15
+ import type { Context } from '@nocobase/actions';
16
+ import { DataTypes, type Model } from '@nocobase/database';
17
+ import { LLMProvider, type LLMProviderMeta } from '@nocobase/plugin-ai/server';
18
+ import { randomUUID } from 'node:crypto';
19
+ import { afterAll, beforeAll, describe, expect, it, vi } from 'vitest';
20
+ import { z } from 'zod';
21
+ import { PluginAgentOrchestratorServer } from '../plugin';
22
+ import { guardHierarchyEnrollment } from '../services/HierarchyEnrollmentGuard';
23
+ import { HIERARCHY_DISPATCH_TOOL, HIERARCHY_LIST_TOOL } from '../services/HierarchicalAgentRuntime';
24
+ import { HarnessProfileService } from '../services/HarnessProfileService';
25
+ import { getAIToolsManager } from '../utils/ai-manager';
26
+ import WidenNativeEmployeeIdentifiers from '../migrations/20261119000000-widen-native-employee-identifiers';
27
+
28
+ type ModelRef = { llmService: string; model: string };
29
+ type EnabledModel = { llmService: string; enabledModels: Array<{ value: string }> };
30
+ type PluginAiProbe = {
31
+ aiManager: {
32
+ listAllEnabledModels: () => Promise<EnabledModel[]>;
33
+ registerLLMProvider: (name: string, meta: LLMProviderMeta) => void;
34
+ };
35
+ aiEmployeesManager: {
36
+ resolveModel: (employee: Model, model?: ModelRef | null) => Promise<ModelRef>;
37
+ conversationController: { get: (sessionId: string) => AbortController | undefined };
38
+ };
39
+ ai?: { skillsManager?: { getSkills: (names: string[]) => Promise<unknown[]> } };
40
+ };
41
+
42
+ type ProbeStep =
43
+ | { kind: 'tool'; name: string; args: Record<string, unknown> }
44
+ | {
45
+ kind: 'answer';
46
+ text: string;
47
+ requireContext?: string;
48
+ appendMarker?: string;
49
+ allowMissingToolResult?: boolean;
50
+ };
51
+ type ProbePromptMessage = { kind: 'tool' | 'other'; content: unknown; name?: unknown; toolCallId?: unknown };
52
+ type ProbeGenerationCounts = { generate: number; stream: number };
53
+
54
+ const probeScripts = new Map<string, ProbeStep[]>();
55
+ const probeCursors = new Map<string, number>();
56
+ const probeGenerationModes = new Map<string, ProbeGenerationCounts>();
57
+ const providerToolNames = new Map<string, string[]>();
58
+ const providerInputs = new Map<string, ProbePromptMessage[][]>();
59
+ const beforeProbeStep = new Map<string, (index: number) => Promise<void>>();
60
+ const workerEvidence = 'SENTINEL-HIERARCHY-EVIDENCE-7F3A';
61
+
62
+ function readToolName(value: unknown): string {
63
+ if (!value || typeof value !== 'object' || Array.isArray(value)) return '';
64
+ const item = value as { name?: unknown; function?: { name?: unknown } };
65
+ if (typeof item.name === 'string') return item.name;
66
+ return typeof item.function?.name === 'string' ? item.function.name : '';
67
+ }
68
+
69
+ function recordGeneration(modelName: string, method: keyof ProbeGenerationCounts) {
70
+ const counts = probeGenerationModes.get(modelName) ?? { generate: 0, stream: 0 };
71
+ counts[method] += 1;
72
+ probeGenerationModes.set(modelName, counts);
73
+ }
74
+
75
+ function generationModeSnapshot(): Map<string, ProbeGenerationCounts> {
76
+ return new Map([...probeGenerationModes].map(([name, counts]) => [name, { ...counts }]));
77
+ }
78
+
79
+ class HierarchyProbeModel extends FakeChatModel {
80
+ constructor(private readonly modelName: string) {
81
+ super({});
82
+ }
83
+
84
+ bindTools(...args: Parameters<FakeChatModel['bindTools']>) {
85
+ const rawTools: unknown = args[0];
86
+ providerToolNames.set(
87
+ this.modelName,
88
+ (Array.isArray(rawTools) ? rawTools : []).map(readToolName).filter(Boolean).sort(),
89
+ );
90
+ return this;
91
+ }
92
+
93
+ private async generateMessage(messages: BaseMessage[]): Promise<AIMessage> {
94
+ const script = probeScripts.get(this.modelName) ?? [];
95
+ const index = probeCursors.get(this.modelName) ?? 0;
96
+ await beforeProbeStep.get(this.modelName)?.(index);
97
+ const step = script[index];
98
+ if (
99
+ index > 0 &&
100
+ !messages.some(ToolMessage.isInstance) &&
101
+ !(step?.kind === 'answer' && step.allowMissingToolResult)
102
+ ) {
103
+ throw new Error(`Expected a completed tool result before step ${index} for ${this.modelName}.`);
104
+ }
105
+ const snapshot = messages.map((message) => {
106
+ const values = message as unknown as Record<string, unknown>;
107
+ return {
108
+ kind: ToolMessage.isInstance(message) ? ('tool' as const) : ('other' as const),
109
+ content: message.content,
110
+ name: values.name,
111
+ toolCallId: values.tool_call_id,
112
+ };
113
+ });
114
+ const inputs = providerInputs.get(this.modelName) ?? [];
115
+ inputs.push(snapshot);
116
+ providerInputs.set(this.modelName, inputs);
117
+ probeCursors.set(this.modelName, index + 1);
118
+ if (!step) throw new Error(`No scripted response remains for ${this.modelName} at step ${index}.`);
119
+ let answerText = step.kind === 'answer' ? step.text : '';
120
+ if (step.kind === 'answer' && step.requireContext && !JSON.stringify(snapshot).includes(step.requireContext)) {
121
+ throw new Error(`Expected delegated evidence in the model input for ${this.modelName}.`);
122
+ }
123
+ if (step.kind === 'answer' && step.appendMarker) {
124
+ const serialized = JSON.stringify(snapshot);
125
+ const markerIndex = serialized.indexOf(step.appendMarker);
126
+ if (markerIndex < 0) throw new Error(`Expected a synthesis marker in the model input for ${this.modelName}.`);
127
+ answerText += serialized.slice(markerIndex, markerIndex + step.appendMarker.length);
128
+ }
129
+ const message =
130
+ step.kind === 'tool'
131
+ ? new AIMessage({
132
+ content: '',
133
+ tool_calls: [
134
+ {
135
+ id: `${this.modelName}-call-${index + 1}`,
136
+ name: step.name,
137
+ args: step.args,
138
+ type: 'tool_call',
139
+ },
140
+ ],
141
+ })
142
+ : new AIMessage(answerText);
143
+ return message;
144
+ }
145
+
146
+ async _generate(messages: BaseMessage[], options: Parameters<BaseChatModel['_generate']>[1]) {
147
+ if (options.signal?.aborted) throw new Error('The deterministic provider call was cancelled.');
148
+ recordGeneration(this.modelName, 'generate');
149
+ const message = await this.generateMessage(messages);
150
+ return { generations: [{ text: String(message.content), message }] };
151
+ }
152
+
153
+ async *_streamResponseChunks(
154
+ messages: BaseMessage[],
155
+ options: Parameters<BaseChatModel['_streamResponseChunks']>[1],
156
+ ) {
157
+ if (options.signal?.aborted) throw new Error('The deterministic provider stream was cancelled.');
158
+ recordGeneration(this.modelName, 'stream');
159
+ const message = await this.generateMessage(messages);
160
+ const toolCallChunks = (message.tool_calls ?? []).map((call, index) => ({
161
+ id: call.id,
162
+ name: call.name,
163
+ args: JSON.stringify(call.args),
164
+ index,
165
+ }));
166
+ const chunk = new AIMessageChunk({ content: message.content, tool_call_chunks: toolCallChunks });
167
+ yield new ChatGenerationChunk({ message: chunk, text: String(message.content) });
168
+ }
169
+ }
170
+
171
+ class HierarchyProbeProvider extends LLMProvider {
172
+ createModel(): BaseChatModel {
173
+ return new HierarchyProbeModel(String(this.modelOptions?.model ?? 'unknown-model'));
174
+ }
175
+ }
176
+
177
+ function modelService(name: string, model: string) {
178
+ return {
179
+ name,
180
+ title: name,
181
+ provider: 'hierarchy-probe',
182
+ enabled: true,
183
+ options: {},
184
+ enabledModels: { mode: 'custom', models: [{ label: model, value: model }] },
185
+ modelOptions: {},
186
+ };
187
+ }
188
+
189
+ function object(value: unknown): Record<string, unknown> {
190
+ if (!value || typeof value !== 'object' || Array.isArray(value)) throw new Error('Expected an object response.');
191
+ return value as Record<string, unknown>;
192
+ }
193
+
194
+ function recordOrEmpty(value: unknown): Record<string, unknown> {
195
+ return value && typeof value === 'object' && !Array.isArray(value) ? (value as Record<string, unknown>) : {};
196
+ }
197
+
198
+ function responseData(response: { body: { data: { data: unknown } } }) {
199
+ return object(response.body.data.data);
200
+ }
201
+
202
+ function toolPayloadForCall(input: ProbePromptMessage[], toolCallId: string): Record<string, unknown> {
203
+ const message = input.find((item) => item.kind === 'tool' && item.toolCallId === toolCallId);
204
+ if (!message) throw new Error(`The model input did not include tool result ${toolCallId}.`);
205
+ const content = message.content;
206
+ return object(typeof content === 'string' ? JSON.parse(content) : content);
207
+ }
208
+
209
+ function within<T>(promise: Promise<T>, timeoutMs: number, message: string): Promise<T> {
210
+ let timer: ReturnType<typeof setTimeout> | undefined;
211
+ return Promise.race([
212
+ promise,
213
+ new Promise<never>((_resolve, reject) => {
214
+ timer = setTimeout(() => reject(new Error(message)), timeoutMs);
215
+ }),
216
+ ]).finally(() => {
217
+ if (timer) clearTimeout(timer);
218
+ });
219
+ }
220
+
221
+ function chatContext(app: MockServer, userId: number, sessionId: string, employee: string): Context {
222
+ return {
223
+ action: {
224
+ resourceName: 'aiConversations',
225
+ actionName: 'sendMessages',
226
+ params: { values: { sessionId, aiEmployee: employee } },
227
+ },
228
+ auth: { user: { id: userId } },
229
+ app,
230
+ db: app.db,
231
+ t: (message: string) => message,
232
+ throw: (_status: number, message: string) => {
233
+ throw new Error(message);
234
+ },
235
+ } as unknown as Context;
236
+ }
237
+
238
+ describe('hierarchical routing preview HTTP and policy resolution', () => {
239
+ let app: MockServer;
240
+ let adminAgent: ReturnType<MockServer['agent']>;
241
+ let memberAgent: ReturnType<MockServer['agent']>;
242
+ let adminId: number;
243
+ let memberId: number;
244
+ let leaderUsername: string;
245
+ let targetUsername: string;
246
+ let rootSessionId: string;
247
+ let memberSessionId: string;
248
+ let profileTag: string;
249
+ let workerProfileTag: string;
250
+ let profileVersion: number;
251
+ let workerUsername: string;
252
+ const workerInvocations: Array<{ path: string }> = [];
253
+ const sessionAskInvocations: Array<{ value: string }> = [];
254
+ const resolvedCandidates: Array<ModelRef | undefined> = [];
255
+ let afterWorkerInvoke: (() => Promise<void>) | undefined;
256
+
257
+ beforeAll(async () => {
258
+ const suffix = `${process.pid}-${Date.now()}`;
259
+ app = await createMockServer({
260
+ plugins: ['nocobase', PluginAgentOrchestratorServer],
261
+ name: `hierarchical-routing-${suffix}`,
262
+ acl: true,
263
+ skipSupervisor: true,
264
+ });
265
+ app.resourceManager.use(
266
+ async (ctx, next) => {
267
+ if (
268
+ ctx.action?.resourceName === 'aiConversations' &&
269
+ ['sendMessages', 'resendMessages', 'resumeToolCall'].includes(ctx.action.actionName)
270
+ ) {
271
+ if (!ctx.get('x-timezone')) ctx.req.headers['x-timezone'] = '+00:00';
272
+ if (!ctx.get('x-locale')) ctx.req.headers['x-locale'] = 'en-US';
273
+ }
274
+ await next();
275
+ },
276
+ { tag: 'hierarchy-test-request-context', after: 'auth' },
277
+ );
278
+
279
+ const users = app.db.getRepository('users');
280
+ const root = await users.findOne({ filter: { 'roles.name': 'root' } });
281
+ if (!root) throw new Error('Mock server did not seed a root user.');
282
+ const member = await users.create({ values: { username: `hierarchy-member-${suffix}`, roles: ['member'] } });
283
+ adminId = Number(root.id);
284
+ memberId = Number(member.id);
285
+ adminAgent = await app.agent().login(root);
286
+ memberAgent = await app.agent().login(member);
287
+
288
+ const employees = app.db.getRepository('aiEmployees');
289
+ const leader = await employees.findOne({ filter: { username: 'dex', enabled: true, category: 'business' } });
290
+ const target = await employees.findOne({ filter: { username: 'ellis', enabled: true, category: 'business' } });
291
+ if (!leader || !target) throw new Error('Mock server did not seed the expected business AI employees.');
292
+ leaderUsername = String(leader.get('username'));
293
+ targetUsername = String(target.get('username'));
294
+
295
+ rootSessionId = randomUUID();
296
+ await app.db.getRepository('aiConversations').create({
297
+ values: {
298
+ sessionId: rootSessionId,
299
+ userId: adminId,
300
+ aiEmployeeUsername: leaderUsername,
301
+ title: 'Hierarchy preview test',
302
+ },
303
+ });
304
+ memberSessionId = randomUUID();
305
+ await app.db.getRepository('aiConversations').create({
306
+ values: {
307
+ sessionId: memberSessionId,
308
+ userId: memberId,
309
+ aiEmployeeUsername: leaderUsername,
310
+ title: 'Unowned hierarchy preview test',
311
+ },
312
+ });
313
+
314
+ const profiles = new HarnessProfileService(app.db);
315
+ profileTag = `hierarchy-preview-${suffix}`;
316
+ const profile = await profiles.createProfile({
317
+ tag: profileTag,
318
+ settings: {
319
+ routing: {
320
+ models: {
321
+ primary: { llmService: 'mock-primary', model: 'strong-model' },
322
+ fallback: [{ llmService: 'mock-backup', model: 'lite-model' }],
323
+ },
324
+ },
325
+ tools: {
326
+ allow: [HIERARCHY_LIST_TOOL, HIERARCHY_DISPATCH_TOOL],
327
+ effects: { [HIERARCHY_LIST_TOOL]: 'read', [HIERARCHY_DISPATCH_TOOL]: 'read' },
328
+ },
329
+ limits: { timeoutMs: 40_000, maxInvocations: 4 },
330
+ observability: { enabled: true, sharing: 'full' },
331
+ },
332
+ });
333
+ profileVersion = profile.version.version;
334
+
335
+ await app.db.getRepository('orchestratorConfig').create({
336
+ values: {
337
+ leaderUsername,
338
+ subAgentUsername: targetUsername,
339
+ enabled: true,
340
+ harnessTag: profileTag,
341
+ routingEnabled: true,
342
+ routingRole: 'specialist',
343
+ routingPrompt: 'Use for technical evidence gathering.',
344
+ maxDepth: 2,
345
+ timeout: 120000,
346
+ },
347
+ });
348
+
349
+ workerUsername = `hierarchy-worker-${suffix}`;
350
+ await employees.create({
351
+ values: {
352
+ username: workerUsername,
353
+ nickname: 'Routing worker fixture',
354
+ enabled: true,
355
+ category: 'business',
356
+ deprecated: false,
357
+ chatSettings: { enableSkills: false },
358
+ skillSettings: { tools: [{ name: 'worker_read_tool', autoCall: true }] },
359
+ },
360
+ });
361
+ workerProfileTag = `hierarchy-worker-${suffix}`;
362
+ await profiles.createProfile({
363
+ tag: workerProfileTag,
364
+ settings: {
365
+ routing: { models: { primary: { llmService: 'mock-worker', model: 'worker-lite' }, fallback: [] } },
366
+ tools: { allow: ['worker_read_tool'], effects: { worker_read_tool: 'read' } },
367
+ limits: { timeoutMs: 40_000, maxInvocations: 4 },
368
+ observability: { enabled: true, sharing: 'full' },
369
+ },
370
+ });
371
+ await app.db.getRepository('orchestratorConfig').create({
372
+ values: {
373
+ leaderUsername: targetUsername,
374
+ subAgentUsername: workerUsername,
375
+ enabled: true,
376
+ harnessTag: workerProfileTag,
377
+ routingEnabled: true,
378
+ routingRole: 'worker',
379
+ routingPrompt: 'Use only for read-only tool work.',
380
+ maxDepth: 1,
381
+ timeout: 120000,
382
+ },
383
+ });
384
+
385
+ const ai = app.pm.get('ai') as unknown as PluginAiProbe;
386
+ ai.aiManager.registerLLMProvider('hierarchy-probe', {
387
+ title: 'Deterministic hierarchy test provider',
388
+ provider: HierarchyProbeProvider,
389
+ });
390
+ const services = app.db.getRepository('llmServices');
391
+ await services.create({ values: modelService('mock-root', 'strong-model') });
392
+ await services.create({ values: modelService('mock-backup', 'lite-model') });
393
+ await services.create({ values: modelService('mock-worker', 'worker-lite') });
394
+ getAIToolsManager(app).registerTools({
395
+ scope: 'CUSTOM',
396
+ execution: 'backend',
397
+ defaultPermission: 'ALLOW',
398
+ definition: {
399
+ name: 'worker_read_tool',
400
+ description: 'Read a deterministic fixture file.',
401
+ schema: z.object({ path: z.string() }),
402
+ },
403
+ invoke: async (_ctx, input: { path: string }) => {
404
+ workerInvocations.push({ path: input.path });
405
+ await afterWorkerInvoke?.();
406
+ return { status: 'success', content: input.path === 'fixture.txt' ? workerEvidence : `contents:${input.path}` };
407
+ },
408
+ });
409
+ getAIToolsManager(app).registerTools({
410
+ scope: 'CUSTOM',
411
+ execution: 'backend',
412
+ defaultPermission: 'ALLOW',
413
+ definition: {
414
+ name: 'session_ask_approval_probe',
415
+ description: 'Exercise an employee-specific Ask permission in a root conversation.',
416
+ schema: z.object({ value: z.string() }),
417
+ },
418
+ invoke: async (_ctx, input: { value: string }) => {
419
+ sessionAskInvocations.push(input);
420
+ return { status: 'success', content: `approved:${input.value}` };
421
+ },
422
+ });
423
+
424
+ const currentLeaderSettings = recordOrEmpty(leader.get('skillSettings'));
425
+ const currentLeaderChatSettings = recordOrEmpty(leader.get('chatSettings'));
426
+ await leader.update({
427
+ skillSettings: {
428
+ ...currentLeaderSettings,
429
+ tools: [
430
+ { name: HIERARCHY_LIST_TOOL, autoCall: true },
431
+ { name: HIERARCHY_DISPATCH_TOOL, autoCall: true },
432
+ { name: 'session_ask_approval_probe', autoCall: false },
433
+ ],
434
+ },
435
+ chatSettings: { ...currentLeaderChatSettings, enableSkills: false },
436
+ });
437
+ const roleBindings = app.db.getRepository('rolesAiEmployees');
438
+ for (const username of [leaderUsername, targetUsername, workerUsername]) {
439
+ const existing = await roleBindings.findOne({ filter: { roleName: 'member', aiEmployee: username } });
440
+ if (!existing) {
441
+ await roleBindings.create({ values: { roleName: 'member', aiEmployee: username } });
442
+ }
443
+ }
444
+ vi.spyOn(ai.aiEmployeesManager, 'resolveModel').mockImplementation(async (_employee, model) => {
445
+ resolvedCandidates.push(model ?? undefined);
446
+ if (!model) throw new Error('The fixture should always specify a candidate model.');
447
+ return model;
448
+ });
449
+ });
450
+
451
+ afterAll(async () => {
452
+ vi.restoreAllMocks();
453
+ await app?.destroy();
454
+ });
455
+
456
+ it('uses the same active binding/profile resolver and selects the first available fallback model', async () => {
457
+ const response = await adminAgent.resource('agentHierarchy').preview({
458
+ values: { sessionId: rootSessionId, username: targetUsername },
459
+ });
460
+
461
+ expect(response.status).toBe(200);
462
+ expect(responseData(response)).toMatchObject({
463
+ username: targetUsername,
464
+ role: 'specialist',
465
+ model: { llmService: 'mock-backup', model: 'lite-model' },
466
+ fallback: true,
467
+ profile: { tag: profileTag, version: profileVersion },
468
+ });
469
+ expect(resolvedCandidates).toEqual([
470
+ { llmService: 'mock-primary', model: 'strong-model' },
471
+ { llmService: 'mock-backup', model: 'lite-model' },
472
+ ]);
473
+ });
474
+
475
+ it('requires administrator access and rejects another user’s conversation', async () => {
476
+ expect(
477
+ (
478
+ await memberAgent.resource('agentHierarchy').preview({
479
+ values: { sessionId: rootSessionId, username: targetUsername },
480
+ })
481
+ ).status,
482
+ ).toBe(403);
483
+
484
+ expect(
485
+ (
486
+ await adminAgent.resource('agentHierarchy').preview({
487
+ values: { sessionId: memberSessionId, username: targetUsername },
488
+ })
489
+ ).status,
490
+ ).toBe(409);
491
+ });
492
+
493
+ it('previews a worker through its specialist, applies routing policy, and creates no execution records', async () => {
494
+ const profiles = new HarnessProfileService(app.db);
495
+ const rootBinding = await app.db
496
+ .getRepository('orchestratorConfig')
497
+ .findOne({ filter: { leaderUsername, subAgentUsername: targetUsername } });
498
+ const workerBinding = await app.db
499
+ .getRepository('orchestratorConfig')
500
+ .findOne({ filter: { leaderUsername: targetUsername, subAgentUsername: workerUsername } });
501
+ if (!rootBinding || !workerBinding) throw new Error('The hierarchy preview bindings were not created.');
502
+ const originalRootTag = String(rootBinding.get('harnessTag'));
503
+ const originalWorkerTag = String(workerBinding.get('harnessTag'));
504
+ const sourceProfile = await profiles.getPublishedByTag(profileTag);
505
+ const sourceWorkerProfile = await profiles.getPublishedByTag(workerProfileTag);
506
+ if (!sourceProfile || !sourceWorkerProfile) throw new Error('The hierarchy preview profiles were not published.');
507
+ const childCount = await app.db
508
+ .getRepository('aiConversations')
509
+ .count({ filter: { userId: adminId, from: 'sub-agent' } });
510
+ const invocationCount = await app.db
511
+ .getRepository('agentHierarchyInvocations')
512
+ .count({ filter: { ownerId: adminId } });
513
+ const cursorSnapshot = new Map(probeCursors);
514
+ const inputSnapshot = new Map([...providerInputs].map(([name, inputs]) => [name, inputs.length]));
515
+
516
+ const valid = await adminAgent.resource('agentHierarchy').preview({
517
+ values: { sessionId: rootSessionId, username: workerUsername, specialistUsername: targetUsername },
518
+ });
519
+ expect(valid.status).toBe(200);
520
+ expect(responseData(valid)).toMatchObject({
521
+ username: workerUsername,
522
+ role: 'worker',
523
+ model: { llmService: 'mock-worker', model: 'worker-lite' },
524
+ fallback: false,
525
+ profile: { tag: workerProfileTag },
526
+ specialist: {
527
+ username: targetUsername,
528
+ model: { llmService: 'mock-backup', model: 'lite-model' },
529
+ fallback: true,
530
+ profile: { tag: profileTag },
531
+ },
532
+ });
533
+
534
+ const users = app.db.getRepository('users');
535
+ const adminWithoutWorker = await users.create({
536
+ values: { username: `hierarchy-admin-no-worker-${Date.now()}`, roles: ['admin'] },
537
+ });
538
+ const noWorkerId = Number(adminWithoutWorker.id);
539
+ const noWorkerSessionId = randomUUID();
540
+ await app.db.getRepository('aiConversations').create({
541
+ values: {
542
+ sessionId: noWorkerSessionId,
543
+ userId: noWorkerId,
544
+ aiEmployeeUsername: leaderUsername,
545
+ title: 'Worker preview access test',
546
+ },
547
+ });
548
+ const adminWithoutWorkerAgent = await app.agent().login(adminWithoutWorker);
549
+ const roleBindings = app.db.getRepository('rolesAiEmployees');
550
+ for (const username of [leaderUsername, targetUsername]) {
551
+ const existing = await roleBindings.findOne({ filter: { roleName: 'admin', aiEmployee: username } });
552
+ if (!existing) await roleBindings.create({ values: { roleName: 'admin', aiEmployee: username } });
553
+ }
554
+ const adminWorkerBinding = await roleBindings.findOne({
555
+ filter: { roleName: 'admin', aiEmployee: workerUsername },
556
+ });
557
+ await adminWorkerBinding?.destroy();
558
+ try {
559
+ const inaccessibleWorkerPreview = await adminWithoutWorkerAgent.resource('agentHierarchy').preview({
560
+ values: { sessionId: noWorkerSessionId, username: workerUsername, specialistUsername: targetUsername },
561
+ });
562
+ expect(inaccessibleWorkerPreview.status).toBe(409);
563
+ } finally {
564
+ if (adminWorkerBinding) {
565
+ await roleBindings.create({ values: { roleName: 'admin', aiEmployee: workerUsername } });
566
+ }
567
+ }
568
+
569
+ await rootBinding.update({ maxDepth: 1 });
570
+ const depthDenied = await adminAgent.resource('agentHierarchy').preview({
571
+ values: { sessionId: rootSessionId, username: workerUsername, specialistUsername: targetUsername },
572
+ });
573
+ expect(depthDenied.status).toBe(409);
574
+ await rootBinding.update({ maxDepth: 2 });
575
+
576
+ await workerBinding.update({ enabled: false });
577
+ const missingBinding = await adminAgent.resource('agentHierarchy').preview({
578
+ values: { sessionId: rootSessionId, username: workerUsername, specialistUsername: targetUsername },
579
+ });
580
+ expect(missingBinding.status).toBe(409);
581
+ await workerBinding.update({ enabled: true });
582
+
583
+ const restrictedTag = `hierarchy-preview-restricted-${Date.now()}`;
584
+ const restrictedProfile = await profiles.createProfile({
585
+ tag: restrictedTag,
586
+ settings: {
587
+ ...sourceProfile.settings,
588
+ delegation: { ...sourceProfile.settings.delegation, allowedEmployees: [targetUsername] },
589
+ },
590
+ });
591
+ await rootBinding.update({ harnessTag: restrictedProfile.profile.tag });
592
+ const employeeDenied = await adminAgent.resource('agentHierarchy').preview({
593
+ values: { sessionId: rootSessionId, username: workerUsername, specialistUsername: targetUsername },
594
+ });
595
+ expect(employeeDenied.status).toBe(409);
596
+
597
+ const toolRestrictedTag = `hierarchy-preview-tools-${Date.now()}`;
598
+ const toolRestrictedProfile = await profiles.createProfile({
599
+ tag: toolRestrictedTag,
600
+ settings: {
601
+ ...sourceProfile.settings,
602
+ tools: {
603
+ ...sourceProfile.settings.tools,
604
+ allow: [HIERARCHY_LIST_TOOL],
605
+ effects: { ...sourceProfile.settings.tools.effects, [HIERARCHY_LIST_TOOL]: 'read' },
606
+ },
607
+ },
608
+ });
609
+ await rootBinding.update({ harnessTag: toolRestrictedProfile.profile.tag });
610
+ const specialistToolDenied = await adminAgent.resource('agentHierarchy').preview({
611
+ values: { sessionId: rootSessionId, username: workerUsername, specialistUsername: targetUsername },
612
+ });
613
+ expect(specialistToolDenied.status).toBe(409);
614
+ const directSpecialistToolDenied = await adminAgent.resource('agentHierarchy').preview({
615
+ values: { sessionId: rootSessionId, username: targetUsername },
616
+ });
617
+ expect(directSpecialistToolDenied.status).toBe(409);
618
+
619
+ await rootBinding.update({ harnessTag: originalRootTag });
620
+ const zeroInvocationProfile = await profiles.createProfile({
621
+ tag: `hierarchy-preview-zero-invocations-${Date.now()}`,
622
+ settings: {
623
+ ...sourceProfile.settings,
624
+ limits: { ...sourceProfile.settings.limits, maxInvocations: 0 },
625
+ },
626
+ });
627
+ await rootBinding.update({ harnessTag: zeroInvocationProfile.profile.tag });
628
+ const directZeroInvocations = await adminAgent.resource('agentHierarchy').preview({
629
+ values: { sessionId: rootSessionId, username: targetUsername },
630
+ });
631
+ expect(directZeroInvocations.status).toBe(409);
632
+ const nestedZeroInvocations = await adminAgent.resource('agentHierarchy').preview({
633
+ values: { sessionId: rootSessionId, username: workerUsername, specialistUsername: targetUsername },
634
+ });
635
+ expect(nestedZeroInvocations.status).toBe(409);
636
+
637
+ const oneInvocationProfile = await profiles.createProfile({
638
+ tag: `hierarchy-preview-one-invocation-${Date.now()}`,
639
+ settings: {
640
+ ...sourceProfile.settings,
641
+ limits: { ...sourceProfile.settings.limits, maxInvocations: 1 },
642
+ },
643
+ });
644
+ await rootBinding.update({ harnessTag: oneInvocationProfile.profile.tag });
645
+ const nestedOneInvocation = await adminAgent.resource('agentHierarchy').preview({
646
+ values: { sessionId: rootSessionId, username: workerUsername, specialistUsername: targetUsername },
647
+ });
648
+ expect(nestedOneInvocation.status).toBe(409);
649
+
650
+ const twoInvocationProfile = await profiles.createProfile({
651
+ tag: `hierarchy-preview-two-invocations-${Date.now()}`,
652
+ settings: {
653
+ ...sourceProfile.settings,
654
+ limits: { ...sourceProfile.settings.limits, maxInvocations: 2 },
655
+ },
656
+ });
657
+ await rootBinding.update({ harnessTag: twoInvocationProfile.profile.tag });
658
+ const nestedTwoInvocations = await adminAgent.resource('agentHierarchy').preview({
659
+ values: { sessionId: rootSessionId, username: workerUsername, specialistUsername: targetUsername },
660
+ });
661
+ expect(nestedTwoInvocations.status).toBe(200);
662
+
663
+ await rootBinding.update({ harnessTag: zeroInvocationProfile.profile.tag });
664
+ const missingToolManager = getAIToolsManager(app) as {
665
+ getTools: (name: string, options: { ctx: Context; sessionId: string }) => Promise<unknown>;
666
+ };
667
+ const originalGetTools = missingToolManager.getTools.bind(missingToolManager);
668
+ const getToolsSpy = vi.spyOn(missingToolManager, 'getTools').mockImplementation(async (name, options) => {
669
+ if (name === HIERARCHY_DISPATCH_TOOL) return undefined;
670
+ return originalGetTools(name, options);
671
+ });
672
+ try {
673
+ const unavailableTool = await adminAgent.resource('agentHierarchy').preview({
674
+ values: { sessionId: rootSessionId, username: workerUsername, specialistUsername: targetUsername },
675
+ });
676
+ expect(unavailableTool.status).toBe(409);
677
+ } finally {
678
+ getToolsSpy.mockRestore();
679
+ }
680
+ await rootBinding.update({ harnessTag: originalRootTag });
681
+
682
+ const fallbackTag = `hierarchy-preview-worker-fallback-${Date.now()}`;
683
+ const fallbackProfile = await profiles.createProfile({
684
+ tag: fallbackTag,
685
+ settings: {
686
+ ...sourceWorkerProfile.settings,
687
+ routing: {
688
+ models: {
689
+ primary: { llmService: 'mock-missing', model: 'missing-model' },
690
+ fallback: [{ llmService: 'mock-backup', model: 'lite-model' }],
691
+ },
692
+ },
693
+ },
694
+ });
695
+ await workerBinding.update({ harnessTag: fallbackProfile.profile.tag });
696
+ const fallback = await adminAgent.resource('agentHierarchy').preview({
697
+ values: { sessionId: rootSessionId, username: workerUsername, specialistUsername: targetUsername },
698
+ });
699
+ expect(fallback.status).toBe(200);
700
+ expect(responseData(fallback)).toMatchObject({
701
+ username: workerUsername,
702
+ role: 'worker',
703
+ model: { llmService: 'mock-backup', model: 'lite-model' },
704
+ fallback: true,
705
+ });
706
+
707
+ await workerBinding.update({ harnessTag: originalWorkerTag });
708
+ expect(
709
+ await app.db.getRepository('aiConversations').count({ filter: { userId: adminId, from: 'sub-agent' } }),
710
+ ).toBe(childCount);
711
+ expect(await app.db.getRepository('agentHierarchyInvocations').count({ filter: { ownerId: adminId } })).toBe(
712
+ invocationCount,
713
+ );
714
+ expect(probeCursors).toEqual(cursorSnapshot);
715
+ expect(new Map([...providerInputs].map(([name, inputs]) => [name, inputs.length]))).toEqual(inputSnapshot);
716
+ });
717
+
718
+ it('denies managed specialist dispatch when its published profile permits zero invocations', async () => {
719
+ const profiles = new HarnessProfileService(app.db);
720
+ const sourceProfile = await profiles.getPublishedByTag(profileTag);
721
+ const rootBinding = await app.db
722
+ .getRepository('orchestratorConfig')
723
+ .findOne({ filter: { leaderUsername, subAgentUsername: targetUsername } });
724
+ if (!sourceProfile || !rootBinding) throw new Error('The specialist binding or published profile is unavailable.');
725
+ const originalTag = String(rootBinding.get('harnessTag'));
726
+ const denyingProfile = await profiles.createProfile({
727
+ tag: `hierarchy-managed-zero-invocations-${Date.now()}`,
728
+ settings: {
729
+ ...sourceProfile.settings,
730
+ limits: { ...sourceProfile.settings.limits, maxInvocations: 0 },
731
+ },
732
+ });
733
+ const sessionId = randomUUID();
734
+ await app.db.getRepository('aiConversations').create({
735
+ values: { sessionId, userId: adminId, aiEmployeeUsername: leaderUsername, title: 'Denied specialist test' },
736
+ });
737
+ workerInvocations.length = 0;
738
+ probeCursors.clear();
739
+ probeScripts.clear();
740
+ probeScripts.set('strong-model', [
741
+ { kind: 'tool', name: HIERARCHY_LIST_TOOL, args: {} },
742
+ {
743
+ kind: 'tool',
744
+ name: HIERARCHY_DISPATCH_TOOL,
745
+ args: { username: targetUsername, question: 'This specialist has no invocation budget.' },
746
+ },
747
+ { kind: 'answer', text: 'The configured invocation limit denied the specialist.' },
748
+ ]);
749
+ probeScripts.set('lite-model', [{ kind: 'answer', text: 'This specialist model must not run.' }]);
750
+
751
+ try {
752
+ await rootBinding.update({ harnessTag: denyingProfile.profile.tag });
753
+ const preview = await adminAgent.resource('agentHierarchy').preview({
754
+ values: { sessionId: rootSessionId, username: targetUsername },
755
+ });
756
+ expect(preview.status).toBe(409);
757
+
758
+ const response = await adminAgent.resource('aiConversations').sendMessages({
759
+ values: {
760
+ sessionId,
761
+ aiEmployee: leaderUsername,
762
+ model: { llmService: 'mock-root', model: 'strong-model' },
763
+ messages: [{ role: 'user', content: { type: 'text', content: 'Use the specialist.' } }],
764
+ stream: false,
765
+ },
766
+ });
767
+
768
+ expect(response.status).toBe(200);
769
+ expect(probeCursors).toEqual(new Map([['strong-model', 3]]));
770
+ expect(workerInvocations).toEqual([]);
771
+ const childConversations = await app.db.getRepository('aiConversations').find({
772
+ filter: { userId: adminId, from: 'sub-agent' },
773
+ });
774
+ expect(
775
+ childConversations.filter((item) => recordOrEmpty(item.get('options')).hierarchyRootSessionId === sessionId),
776
+ ).toHaveLength(0);
777
+ } finally {
778
+ await rootBinding.update({ harnessTag: originalTag });
779
+ }
780
+ });
781
+
782
+ it('widens legacy usage identifiers without losing rows and accepts the complete employee username', async () => {
783
+ if (app.db.sequelize.getDialect() !== 'postgres') return;
784
+ const migrationSuffix = `${process.pid}-${Date.now()}`;
785
+ const spans = app.db.getRepository('agentExecutionSpans');
786
+ const collection = app.db.getCollection('agentExecutionSpans');
787
+ const table = collection.getTableNameWithSchema();
788
+ const queryInterface = app.db.sequelize.getQueryInterface();
789
+ const legacyValue = `legacy-role-${Date.now()}`;
790
+ const legacy = await spans.create({
791
+ values: {
792
+ rootRunId: `migration-legacy-${migrationSuffix}`,
793
+ type: 'model_call',
794
+ status: 'success',
795
+ role: legacyValue,
796
+ employeeUsername: legacyValue,
797
+ leaderUsername: 'legacy-leader',
798
+ },
799
+ });
800
+ const migration = Object.create(WidenNativeEmployeeIdentifiers.prototype) as WidenNativeEmployeeIdentifiers;
801
+ Object.defineProperty(migration, 'db', { value: app.db });
802
+
803
+ try {
804
+ for (const attribute of ['role', 'employeeUsername', 'leaderUsername']) {
805
+ const field = collection.model.rawAttributes[attribute]?.field || attribute;
806
+ const columns = await queryInterface.describeTable(table);
807
+ const column = columns[field];
808
+ if (!column) throw new Error(`The ${attribute} column is unavailable.`);
809
+ await queryInterface.changeColumn(table, field, {
810
+ type: DataTypes.STRING(30),
811
+ allowNull: column.allowNull,
812
+ ...(column.defaultValue == null ? {} : { defaultValue: column.defaultValue }),
813
+ });
814
+ }
815
+ await migration.up();
816
+ const preserved = await spans.findOne({ filterByTk: legacy.get('id') });
817
+ expect(preserved?.get('role')).toBe(legacyValue);
818
+ expect(preserved?.get('employeeUsername')).toBe(legacyValue);
819
+ expect(preserved?.get('leaderUsername')).toBe('legacy-leader');
820
+ await spans.create({
821
+ values: {
822
+ rootRunId: `migration-long-${migrationSuffix}`,
823
+ type: 'model_call',
824
+ status: 'success',
825
+ role: workerUsername,
826
+ employeeUsername: workerUsername,
827
+ leaderUsername,
828
+ },
829
+ });
830
+ const columns = await queryInterface.describeTable(table);
831
+ expect(String(columns.role?.type)).toMatch(/255/);
832
+ expect(String(columns.employeeUsername?.type)).toMatch(/255/);
833
+ expect(String(columns.leaderUsername?.type)).toMatch(/255/);
834
+ } finally {
835
+ await migration.up();
836
+ }
837
+ });
838
+
839
+ it('runs registered root, specialist, and worker agents through a deterministic provider and backend tool', async () => {
840
+ probeCursors.clear();
841
+ providerToolNames.clear();
842
+ providerInputs.clear();
843
+ workerInvocations.length = 0;
844
+ probeScripts.clear();
845
+ probeScripts.set('strong-model', [
846
+ { kind: 'tool', name: HIERARCHY_LIST_TOOL, args: {} },
847
+ {
848
+ kind: 'tool',
849
+ name: HIERARCHY_DISPATCH_TOOL,
850
+ args: { username: targetUsername, question: 'Read the fixture.' },
851
+ },
852
+ {
853
+ kind: 'answer',
854
+ text: 'Root synthesized verified evidence: ',
855
+ requireContext: workerEvidence,
856
+ appendMarker: workerEvidence,
857
+ },
858
+ ]);
859
+ probeScripts.set('lite-model', [
860
+ {
861
+ kind: 'tool',
862
+ name: HIERARCHY_DISPATCH_TOOL,
863
+ args: { username: workerUsername, question: 'Read fixture.txt.' },
864
+ },
865
+ {
866
+ kind: 'answer',
867
+ text: 'Specialist synthesized worker evidence: ',
868
+ requireContext: workerEvidence,
869
+ appendMarker: workerEvidence,
870
+ },
871
+ ]);
872
+ probeScripts.set('worker-lite', [
873
+ { kind: 'tool', name: 'worker_read_tool', args: { path: 'fixture.txt' } },
874
+ {
875
+ kind: 'answer',
876
+ text: 'Worker verified tool output: ',
877
+ requireContext: workerEvidence,
878
+ appendMarker: workerEvidence,
879
+ },
880
+ ]);
881
+
882
+ const response = await adminAgent.resource('aiConversations').sendMessages({
883
+ values: {
884
+ sessionId: rootSessionId,
885
+ aiEmployee: leaderUsername,
886
+ model: { llmService: 'mock-root', model: 'strong-model' },
887
+ messages: [{ role: 'user', content: { type: 'text', content: 'Read fixture.txt and summarize it.' } }],
888
+ stream: false,
889
+ },
890
+ });
891
+
892
+ expect(response.status).toBe(200);
893
+ expect(workerInvocations).toEqual([{ path: 'fixture.txt' }]);
894
+ expect(providerToolNames.get('lite-model')).toEqual([HIERARCHY_DISPATCH_TOOL, HIERARCHY_LIST_TOOL]);
895
+ expect(providerToolNames.get('worker-lite')).toEqual(['worker_read_tool']);
896
+ expect(providerToolNames.get('strong-model')).toContain(HIERARCHY_LIST_TOOL);
897
+ expect(providerToolNames.get('strong-model')).toContain(HIERARCHY_DISPATCH_TOOL);
898
+ expect(providerToolNames.get('strong-model')).not.toContain('worker_read_tool');
899
+ const specialistInputs = providerInputs.get('lite-model')?.[1] ?? [];
900
+ const specialistPrompt = JSON.stringify(specialistInputs);
901
+ expect(specialistPrompt).toContain(workerEvidence);
902
+ expect(specialistPrompt).toContain('worker_read_tool');
903
+ const specialistPayload = toolPayloadForCall(specialistInputs, 'lite-model-call-1');
904
+ expect(specialistPayload).toMatchObject({
905
+ username: workerUsername,
906
+ answer: expect.stringContaining(workerEvidence),
907
+ evidence: {
908
+ items: [
909
+ expect.objectContaining({
910
+ messageId: expect.any(String),
911
+ toolCallId: expect.any(String),
912
+ toolName: 'worker_read_tool',
913
+ excerpt: workerEvidence,
914
+ }),
915
+ ],
916
+ },
917
+ });
918
+ expect(specialistPayload).not.toHaveProperty('messages');
919
+ expect(specialistPayload).not.toHaveProperty('transcript');
920
+ const rootInputs = providerInputs.get('strong-model')?.[2] ?? [];
921
+ const rootSynthesisPrompt = JSON.stringify(rootInputs);
922
+ expect(rootSynthesisPrompt).toContain(workerEvidence);
923
+ expect(rootSynthesisPrompt).toContain('worker_read_tool');
924
+ const rootPayload = toolPayloadForCall(rootInputs, 'strong-model-call-2');
925
+ expect(rootPayload).toMatchObject({
926
+ username: targetUsername,
927
+ answer: expect.stringContaining(workerEvidence),
928
+ evidence: {
929
+ items: [expect.objectContaining({ toolName: 'worker_read_tool', excerpt: workerEvidence })],
930
+ },
931
+ });
932
+ expect(rootPayload).not.toHaveProperty('messages');
933
+ expect(rootPayload).not.toHaveProperty('transcript');
934
+
935
+ const childConversations = await app.db.getRepository('aiConversations').find({
936
+ filter: { userId: adminId, from: 'sub-agent' },
937
+ });
938
+ expect(childConversations).toHaveLength(2);
939
+ expect(childConversations.map((item) => item.get('aiEmployeeUsername')).sort()).toEqual(
940
+ [targetUsername, workerUsername].sort(),
941
+ );
942
+ const invocations = await app.db.getRepository('agentHierarchyInvocations').find({
943
+ filter: { rootSessionId, ownerId: adminId },
944
+ });
945
+ expect(invocations).toHaveLength(2);
946
+ expect(
947
+ invocations.map((item) => ({
948
+ parentEmployee: item.get('parentEmployee'),
949
+ employeeUsername: item.get('employeeUsername'),
950
+ role: item.get('role'),
951
+ status: item.get('status'),
952
+ snapshot: item.get('snapshot'),
953
+ })),
954
+ ).toEqual(
955
+ expect.arrayContaining([
956
+ expect.objectContaining({
957
+ parentEmployee: leaderUsername,
958
+ employeeUsername: targetUsername,
959
+ role: 'specialist',
960
+ status: 'succeeded',
961
+ snapshot: expect.objectContaining({ model: { llmService: 'mock-backup', model: 'lite-model' } }),
962
+ }),
963
+ expect.objectContaining({
964
+ parentEmployee: targetUsername,
965
+ employeeUsername: workerUsername,
966
+ role: 'worker',
967
+ status: 'succeeded',
968
+ snapshot: expect.objectContaining({ model: { llmService: 'mock-worker', model: 'worker-lite' } }),
969
+ }),
970
+ ]),
971
+ );
972
+ const hierarchySpans = await app.db.getRepository('agentExecutionSpans').find({
973
+ filter: { rootRunId: `hierarchy:${rootSessionId}`, type: 'sub_agent' },
974
+ });
975
+ expect(hierarchySpans).toHaveLength(2);
976
+ expect(hierarchySpans.map((item) => item.get('status'))).toEqual(['success', 'success']);
977
+ const workerConversation = childConversations.find((item) => item.get('aiEmployeeUsername') === workerUsername);
978
+ if (!workerConversation) throw new Error('The worker conversation was not persisted.');
979
+ const workerUsage = await app.db.getRepository('agentExecutionSpans').find({
980
+ filter: {
981
+ usageSessionId: workerConversation.get('sessionId'),
982
+ type: 'model_call',
983
+ source: 'native-plugin-ai',
984
+ model: 'worker-lite',
985
+ },
986
+ });
987
+ expect(workerUsage).toHaveLength(2);
988
+ expect(workerUsage.every((item) => item.get('role') === workerUsername)).toBe(true);
989
+ expect(workerUsage.every((item) => item.get('employeeUsername') === workerUsername)).toBe(true);
990
+ expect(probeCursors).toEqual(
991
+ new Map([
992
+ ['strong-model', 3],
993
+ ['lite-model', 2],
994
+ ['worker-lite', 2],
995
+ ]),
996
+ );
997
+ const rootAnswer = await app.db.getRepository('aiMessages').findOne({
998
+ filter: { sessionId: rootSessionId, role: leaderUsername },
999
+ sort: ['-messageId'],
1000
+ });
1001
+ expect(JSON.stringify(rootAnswer?.get('content'))).toContain(workerEvidence);
1002
+ });
1003
+
1004
+ it('blocks native conversation actions from bypassing a managed worker child', async () => {
1005
+ const conversations = await app.db.getRepository('aiConversations').find({
1006
+ filter: { userId: adminId, from: 'sub-agent', aiEmployeeUsername: workerUsername },
1007
+ });
1008
+ const workerConversation = conversations.find(
1009
+ (item) => recordOrEmpty(item.get('options')).hierarchyRootSessionId === rootSessionId,
1010
+ );
1011
+ if (!workerConversation) throw new Error('The managed worker conversation was not persisted.');
1012
+ const workerSessionId = String(workerConversation.get('sessionId'));
1013
+ const toolRows = await app.db.getRepository('aiToolMessages').find({
1014
+ filter: { sessionId: workerSessionId, toolName: 'worker_read_tool' },
1015
+ sort: ['id'],
1016
+ });
1017
+ if (toolRows.length !== 1) throw new Error('The managed worker tool call was not persisted.');
1018
+ const toolRow = toolRows[0];
1019
+ const messageId = Number(toolRow.get('messageId'));
1020
+ const toolCallId = String(toolRow.get('toolCallId'));
1021
+ if (!Number.isSafeInteger(messageId) || !toolCallId)
1022
+ throw new Error('The worker tool message identity is invalid.');
1023
+ const toolMessage = await app.db.getRepository('aiMessages').findOne({
1024
+ filter: { sessionId: workerSessionId, messageId },
1025
+ });
1026
+ if (!toolMessage) throw new Error('The worker tool call message was not persisted.');
1027
+ const originalToolCalls = toolMessage.get('toolCalls');
1028
+ const originalConversationOptions = workerConversation.get('options');
1029
+ const originalToolState = {
1030
+ status: toolRow.get('status'),
1031
+ invokeStatus: toolRow.get('invokeStatus'),
1032
+ userDecision: toolRow.get('userDecision'),
1033
+ };
1034
+ const cursorSnapshot = new Map(probeCursors);
1035
+ const invocationCount = workerInvocations.length;
1036
+
1037
+ const malformedSession = await adminAgent.resource('aiConversations').sendMessages({
1038
+ values: {
1039
+ sessionId: [workerSessionId] as unknown as string,
1040
+ aiEmployee: workerUsername,
1041
+ model: { llmService: 'mock-worker', model: 'worker-lite' },
1042
+ messages: [{ role: 'user', content: { type: 'text', content: 'Malformed child session ID.' } }],
1043
+ stream: false,
1044
+ },
1045
+ });
1046
+ expect(malformedSession.status).toBe(400);
1047
+ const malformedOptions = await adminAgent.resource('aiConversations').updateOptions({
1048
+ filterByTk: [workerSessionId] as unknown as string,
1049
+ values: { systemMessage: 'Malformed child session ID.' },
1050
+ });
1051
+ expect(malformedOptions.status).toBe(400);
1052
+ const malformedDecision = await adminAgent.resource('aiConversations').updateUserDecision({
1053
+ values: { sessionId: rootSessionId, messageId: { id: messageId }, toolCallId, userDecision: 'allow' },
1054
+ });
1055
+ expect(malformedDecision.status).toBe(400);
1056
+ const malformedArgs = await adminAgent.resource('aiConversations').updateToolArgs({
1057
+ values: {
1058
+ sessionId: rootSessionId,
1059
+ messageId: [messageId],
1060
+ tool: { id: toolCallId, args: { path: 'tampered.txt' } },
1061
+ },
1062
+ });
1063
+ expect(malformedArgs.status).toBe(400);
1064
+ const unchangedConversation = await app.db.getRepository('aiConversations').findOne({
1065
+ filter: { sessionId: workerSessionId, userId: adminId },
1066
+ });
1067
+ expect(unchangedConversation?.get('options')).toEqual(originalConversationOptions);
1068
+ const unchangedTool = await app.db.getRepository('aiToolMessages').findOne({ filterByTk: toolRow.get('id') });
1069
+ expect({
1070
+ status: unchangedTool?.get('status'),
1071
+ invokeStatus: unchangedTool?.get('invokeStatus'),
1072
+ userDecision: unchangedTool?.get('userDecision'),
1073
+ }).toEqual(originalToolState);
1074
+ const unchangedMessage = await app.db.getRepository('aiMessages').findOne({
1075
+ filter: { sessionId: workerSessionId, messageId },
1076
+ });
1077
+ expect(unchangedMessage?.get('toolCalls')).toEqual(originalToolCalls);
1078
+
1079
+ const directSend = await adminAgent.resource('aiConversations').sendMessages({
1080
+ values: {
1081
+ sessionId: workerSessionId,
1082
+ aiEmployee: workerUsername,
1083
+ model: { llmService: 'mock-worker', model: 'worker-lite' },
1084
+ messages: [{ role: 'user', content: { type: 'text', content: 'Call the worker tool directly.' } }],
1085
+ stream: false,
1086
+ },
1087
+ });
1088
+ expect(directSend.status).toBe(403);
1089
+ const directResend = await adminAgent.resource('aiConversations').resendMessages({
1090
+ values: { sessionId: workerSessionId, stream: false },
1091
+ });
1092
+ expect(directResend.status).toBe(403);
1093
+ const directResume = await adminAgent.resource('aiConversations').resumeToolCall({
1094
+ values: { sessionId: workerSessionId, messageId },
1095
+ });
1096
+ expect(directResume.status).toBe(403);
1097
+ const directAbort = await adminAgent.resource('aiConversations').abort({ values: { sessionId: workerSessionId } });
1098
+ expect(directAbort.status).toBe(403);
1099
+ const directOptions = await adminAgent.resource('aiConversations').updateOptions({
1100
+ filterByTk: workerSessionId,
1101
+ values: { systemMessage: 'Try to replace the managed prompt.' },
1102
+ });
1103
+ expect(directOptions.status).toBe(403);
1104
+ const childHistory = await adminAgent.resource('aiConversations').getMessages({ sessionId: workerSessionId });
1105
+ expect(childHistory.status).toBe(200);
1106
+ const crossSessionEdit = await adminAgent.resource('aiConversations').sendMessages({
1107
+ values: {
1108
+ sessionId: rootSessionId,
1109
+ aiEmployee: leaderUsername,
1110
+ editingMessageId: messageId,
1111
+ messages: [{ role: 'user', content: { type: 'text', content: 'Edit a managed child message.' } }],
1112
+ stream: false,
1113
+ },
1114
+ });
1115
+ expect(crossSessionEdit.status).toBe(403);
1116
+ const crossSessionResend = await adminAgent.resource('aiConversations').resendMessages({
1117
+ values: { sessionId: rootSessionId, messageId, stream: false },
1118
+ });
1119
+ expect(crossSessionResend.status).toBe(403);
1120
+ const crossSessionResume = await adminAgent.resource('aiConversations').resumeToolCall({
1121
+ values: { sessionId: rootSessionId, messageId },
1122
+ });
1123
+ expect(crossSessionResume.status).toBe(403);
1124
+
1125
+ await toolRow.update({ status: 'waiting', invokeStatus: 'interrupted', userDecision: null });
1126
+ try {
1127
+ const crossSessionDecision = await adminAgent.resource('aiConversations').updateUserDecision({
1128
+ values: { sessionId: rootSessionId, messageId, toolCallId, userDecision: 'allow' },
1129
+ });
1130
+ expect(crossSessionDecision.status).toBe(403);
1131
+ const crossSessionArgs = await adminAgent.resource('aiConversations').updateToolArgs({
1132
+ values: { sessionId: rootSessionId, messageId, tool: { id: toolCallId, args: { path: 'tampered.txt' } } },
1133
+ });
1134
+ expect(crossSessionArgs.status).toBe(403);
1135
+ const persistedTool = await app.db.getRepository('aiToolMessages').findOne({ filterByTk: toolRow.get('id') });
1136
+ expect(persistedTool?.get('invokeStatus')).toBe('interrupted');
1137
+ expect(persistedTool?.get('userDecision')).toBeNull();
1138
+ const persistedMessage = await app.db.getRepository('aiMessages').findOne({
1139
+ filter: { sessionId: workerSessionId, messageId },
1140
+ });
1141
+ expect(persistedMessage?.get('toolCalls')).toEqual(originalToolCalls);
1142
+ } finally {
1143
+ await toolRow.update({ status: 'success', invokeStatus: 'done', userDecision: null });
1144
+ }
1145
+
1146
+ expect(probeCursors).toEqual(cursorSnapshot);
1147
+ expect(workerInvocations).toHaveLength(invocationCount);
1148
+ });
1149
+
1150
+ it('lets the root answer directly without creating a delegated conversation', async () => {
1151
+ probeCursors.clear();
1152
+ providerToolNames.clear();
1153
+ workerInvocations.length = 0;
1154
+ probeScripts.clear();
1155
+ probeScripts.set('strong-model', [{ kind: 'answer', text: 'I can answer this directly.' }]);
1156
+ const conversations = app.db.getRepository('aiConversations');
1157
+ const previousChildren = await conversations.find({ filter: { userId: adminId, from: 'sub-agent' } });
1158
+ const previousChildIds = new Set(previousChildren.map((item) => String(item.get('sessionId'))));
1159
+ const sessionId = randomUUID();
1160
+ await conversations.create({
1161
+ values: { sessionId, userId: adminId, aiEmployeeUsername: leaderUsername, title: 'Direct answer test' },
1162
+ });
1163
+
1164
+ const response = await adminAgent.resource('aiConversations').sendMessages({
1165
+ values: {
1166
+ sessionId,
1167
+ aiEmployee: leaderUsername,
1168
+ model: { llmService: 'mock-root', model: 'strong-model' },
1169
+ messages: [{ role: 'user', content: { type: 'text', content: 'What is two plus two?' } }],
1170
+ stream: false,
1171
+ },
1172
+ });
1173
+
1174
+ expect(response.status).toBe(200);
1175
+ expect(probeCursors).toEqual(new Map([['strong-model', 1]]));
1176
+ expect(workerInvocations).toEqual([]);
1177
+ const allChildren = await conversations.find({ filter: { userId: adminId, from: 'sub-agent' } });
1178
+ expect(allChildren.filter((item) => !previousChildIds.has(String(item.get('sessionId'))))).toHaveLength(0);
1179
+ expect(
1180
+ await app.db.getRepository('agentHierarchyInvocations').find({ filter: { rootSessionId: sessionId } }),
1181
+ ).toHaveLength(0);
1182
+ });
1183
+
1184
+ it('keeps root model-call count unchanged when one worker reads two files in the same session', async () => {
1185
+ probeCursors.clear();
1186
+ providerInputs.clear();
1187
+ workerInvocations.length = 0;
1188
+ probeScripts.clear();
1189
+ probeScripts.set('strong-model', [
1190
+ { kind: 'tool', name: HIERARCHY_LIST_TOOL, args: {} },
1191
+ {
1192
+ kind: 'tool',
1193
+ name: HIERARCHY_DISPATCH_TOOL,
1194
+ args: { username: targetUsername, question: 'Read two files.' },
1195
+ },
1196
+ {
1197
+ kind: 'answer',
1198
+ text: 'Root synthesized the worker evidence: ',
1199
+ requireContext: workerEvidence,
1200
+ appendMarker: workerEvidence,
1201
+ },
1202
+ ]);
1203
+ probeScripts.set('lite-model', [
1204
+ {
1205
+ kind: 'tool',
1206
+ name: HIERARCHY_DISPATCH_TOOL,
1207
+ args: { username: workerUsername, question: 'Read fixture.txt and reference.txt.' },
1208
+ },
1209
+ {
1210
+ kind: 'answer',
1211
+ text: 'Specialist synthesized worker evidence: ',
1212
+ requireContext: workerEvidence,
1213
+ appendMarker: workerEvidence,
1214
+ },
1215
+ ]);
1216
+ probeScripts.set('worker-lite', [
1217
+ { kind: 'tool', name: 'worker_read_tool', args: { path: 'fixture.txt' } },
1218
+ { kind: 'tool', name: 'worker_read_tool', args: { path: 'reference.txt' } },
1219
+ {
1220
+ kind: 'answer',
1221
+ text: 'Worker synthesized both reads, including: ',
1222
+ requireContext: workerEvidence,
1223
+ appendMarker: workerEvidence,
1224
+ },
1225
+ ]);
1226
+ const sessionId = randomUUID();
1227
+ await app.db.getRepository('aiConversations').create({
1228
+ values: { sessionId, userId: adminId, aiEmployeeUsername: leaderUsername, title: 'Two reads test' },
1229
+ });
1230
+
1231
+ const response = await adminAgent.resource('aiConversations').sendMessages({
1232
+ values: {
1233
+ sessionId,
1234
+ aiEmployee: leaderUsername,
1235
+ model: { llmService: 'mock-root', model: 'strong-model' },
1236
+ messages: [{ role: 'user', content: { type: 'text', content: 'Read fixture.txt and reference.txt.' } }],
1237
+ stream: false,
1238
+ },
1239
+ });
1240
+
1241
+ expect(response.status).toBe(200);
1242
+ expect(workerInvocations).toEqual([{ path: 'fixture.txt' }, { path: 'reference.txt' }]);
1243
+ expect(probeCursors).toEqual(
1244
+ new Map([
1245
+ ['strong-model', 3],
1246
+ ['lite-model', 2],
1247
+ ['worker-lite', 3],
1248
+ ]),
1249
+ );
1250
+ const workers = await app.db.getRepository('aiConversations').find({
1251
+ filter: { userId: adminId, from: 'sub-agent', aiEmployeeUsername: workerUsername },
1252
+ });
1253
+ const worker = workers.find((item) => recordOrEmpty(item.get('options')).hierarchyRootSessionId === sessionId);
1254
+ if (!worker) throw new Error('The two-read worker conversation was not persisted.');
1255
+ expect(
1256
+ await app.db.getRepository('aiToolMessages').find({
1257
+ filter: { sessionId: worker.get('sessionId'), toolName: 'worker_read_tool', status: 'success' },
1258
+ }),
1259
+ ).toHaveLength(2);
1260
+ expect(JSON.stringify(providerInputs.get('strong-model')?.[2] ?? [])).toContain(workerEvidence);
1261
+ });
1262
+
1263
+ it('limits nested dispatch to the effective binding depth', async () => {
1264
+ const rootBinding = await app.db
1265
+ .getRepository('orchestratorConfig')
1266
+ .findOne({ filter: { leaderUsername, subAgentUsername: targetUsername } });
1267
+ if (!rootBinding) throw new Error('The specialist routing binding was not created.');
1268
+ await rootBinding.update({ maxDepth: 1 });
1269
+ workerInvocations.length = 0;
1270
+ probeCursors.clear();
1271
+ probeScripts.clear();
1272
+ probeScripts.set('strong-model', [
1273
+ { kind: 'tool', name: HIERARCHY_LIST_TOOL, args: {} },
1274
+ {
1275
+ kind: 'tool',
1276
+ name: HIERARCHY_DISPATCH_TOOL,
1277
+ args: { username: targetUsername, question: 'Delegate within the depth limit.' },
1278
+ },
1279
+ { kind: 'answer', text: 'Root received the specialist result.' },
1280
+ ]);
1281
+ probeScripts.set('lite-model', [
1282
+ {
1283
+ kind: 'tool',
1284
+ name: HIERARCHY_DISPATCH_TOOL,
1285
+ args: { username: workerUsername, question: 'This edge exceeds maxDepth=1.' },
1286
+ },
1287
+ { kind: 'answer', text: 'The nested delegation was denied by the configured depth.' },
1288
+ ]);
1289
+
1290
+ const conversations = app.db.getRepository('aiConversations');
1291
+ const previousChildren = await conversations.find({ filter: { userId: adminId, from: 'sub-agent' } });
1292
+ const previousChildIds = new Set(previousChildren.map((item) => String(item.get('sessionId'))));
1293
+ const sessionId = randomUUID();
1294
+ await conversations.create({
1295
+ values: { sessionId, userId: adminId, aiEmployeeUsername: leaderUsername, title: 'Depth limit test' },
1296
+ });
1297
+ const response = await adminAgent.resource('aiConversations').sendMessages({
1298
+ values: {
1299
+ sessionId,
1300
+ aiEmployee: leaderUsername,
1301
+ model: { llmService: 'mock-root', model: 'strong-model' },
1302
+ messages: [{ role: 'user', content: { type: 'text', content: 'Use a specialist.' } }],
1303
+ stream: false,
1304
+ },
1305
+ });
1306
+
1307
+ expect(response.status).toBe(200);
1308
+ expect(workerInvocations).toEqual([]);
1309
+ const allChildren = await conversations.find({ filter: { userId: adminId, from: 'sub-agent' } });
1310
+ const children = allChildren.filter((item) => !previousChildIds.has(String(item.get('sessionId'))));
1311
+ expect(children.map((item) => item.get('aiEmployeeUsername'))).toEqual([targetUsername]);
1312
+ const workerInvocationsJournal = await app.db.getRepository('agentHierarchyInvocations').find({
1313
+ filter: { rootSessionId: sessionId, employeeUsername: workerUsername },
1314
+ });
1315
+ expect(workerInvocationsJournal).toHaveLength(0);
1316
+ await rootBinding.update({ maxDepth: 2 });
1317
+ });
1318
+
1319
+ it('rejects a worker dispatch when the current user never had worker access', async () => {
1320
+ const roleBindings = app.db.getRepository('rolesAiEmployees');
1321
+ await roleBindings.destroy({ filter: { roleName: 'member', aiEmployee: workerUsername } });
1322
+ try {
1323
+ probeCursors.clear();
1324
+ probeScripts.clear();
1325
+ probeScripts.set('strong-model', [
1326
+ { kind: 'tool', name: HIERARCHY_LIST_TOOL, args: {} },
1327
+ {
1328
+ kind: 'tool',
1329
+ name: HIERARCHY_DISPATCH_TOOL,
1330
+ args: { username: targetUsername, question: 'Try the available specialist.' },
1331
+ },
1332
+ { kind: 'answer', text: 'The specialist returned its available result.' },
1333
+ ]);
1334
+ probeScripts.set('lite-model', [
1335
+ {
1336
+ kind: 'tool',
1337
+ name: HIERARCHY_DISPATCH_TOOL,
1338
+ args: { username: workerUsername, question: 'Read a file.' },
1339
+ },
1340
+ { kind: 'answer', text: 'The requested worker is not available to this user.' },
1341
+ ]);
1342
+ probeScripts.set('worker-lite', [{ kind: 'answer', text: 'This model must not run.' }]);
1343
+ workerInvocations.length = 0;
1344
+
1345
+ const conversations = app.db.getRepository('aiConversations');
1346
+ const previousChildren = await conversations.find({ filter: { userId: memberId, from: 'sub-agent' } });
1347
+ const previousChildIds = new Set(previousChildren.map((item) => String(item.get('sessionId'))));
1348
+ const sessionId = randomUUID();
1349
+ await conversations.create({
1350
+ values: { sessionId, userId: memberId, aiEmployeeUsername: leaderUsername, title: 'Initial access test' },
1351
+ });
1352
+
1353
+ const response = await memberAgent.resource('aiConversations').sendMessages({
1354
+ values: {
1355
+ sessionId,
1356
+ aiEmployee: leaderUsername,
1357
+ model: { llmService: 'mock-root', model: 'strong-model' },
1358
+ messages: [{ role: 'user', content: { type: 'text', content: 'Read a file using a worker.' } }],
1359
+ stream: false,
1360
+ },
1361
+ });
1362
+
1363
+ expect(response.status).toBe(200);
1364
+ expect(workerInvocations).toEqual([]);
1365
+ expect(probeCursors.get('worker-lite')).toBeUndefined();
1366
+ const allChildren = await conversations.find({ filter: { userId: memberId, from: 'sub-agent' } });
1367
+ expect(
1368
+ allChildren
1369
+ .filter((item) => !previousChildIds.has(String(item.get('sessionId'))))
1370
+ .map((item) => item.get('aiEmployeeUsername')),
1371
+ ).toEqual([targetUsername]);
1372
+ expect(
1373
+ await app.db.getRepository('agentHierarchyInvocations').find({
1374
+ filter: { rootSessionId: sessionId, employeeUsername: workerUsername },
1375
+ }),
1376
+ ).toHaveLength(0);
1377
+ } finally {
1378
+ const restored = await roleBindings.findOne({ filter: { roleName: 'member', aiEmployee: workerUsername } });
1379
+ if (!restored) await roleBindings.create({ values: { roleName: 'member', aiEmployee: workerUsername } });
1380
+ }
1381
+ });
1382
+
1383
+ it('rechecks employee authorization before each worker tool and blocks the second call after role mapping removal', async () => {
1384
+ workerInvocations.length = 0;
1385
+ probeCursors.clear();
1386
+ probeScripts.clear();
1387
+ probeScripts.set('strong-model', [
1388
+ { kind: 'tool', name: HIERARCHY_LIST_TOOL, args: {} },
1389
+ {
1390
+ kind: 'tool',
1391
+ name: HIERARCHY_DISPATCH_TOOL,
1392
+ args: { username: targetUsername, question: 'Read two files.' },
1393
+ },
1394
+ { kind: 'answer', text: 'Root reviewed the available evidence.' },
1395
+ ]);
1396
+ probeScripts.set('lite-model', [
1397
+ {
1398
+ kind: 'tool',
1399
+ name: HIERARCHY_DISPATCH_TOOL,
1400
+ args: { username: workerUsername, question: 'Read both files.' },
1401
+ },
1402
+ { kind: 'answer', text: 'The first file was read; access changed before the second.' },
1403
+ ]);
1404
+ probeScripts.set('worker-lite', [
1405
+ { kind: 'tool', name: 'worker_read_tool', args: { path: 'first.txt' } },
1406
+ { kind: 'tool', name: 'worker_read_tool', args: { path: 'second.txt' } },
1407
+ { kind: 'answer', text: 'I could read the first file before access changed.' },
1408
+ ]);
1409
+ afterWorkerInvoke = async () => {
1410
+ afterWorkerInvoke = undefined;
1411
+ await app.db
1412
+ .getRepository('rolesAiEmployees')
1413
+ .destroy({ filter: { roleName: 'member', aiEmployee: workerUsername } });
1414
+ };
1415
+
1416
+ const response = await memberAgent.resource('aiConversations').sendMessages({
1417
+ values: {
1418
+ sessionId: memberSessionId,
1419
+ aiEmployee: leaderUsername,
1420
+ model: { llmService: 'mock-root', model: 'strong-model' },
1421
+ messages: [{ role: 'user', content: { type: 'text', content: 'Read first.txt and second.txt.' } }],
1422
+ stream: false,
1423
+ },
1424
+ });
1425
+
1426
+ expect(response.status).toBe(200);
1427
+ expect(workerInvocations).toEqual([{ path: 'first.txt' }]);
1428
+ const workerConversation = await app.db.getRepository('aiConversations').findOne({
1429
+ filter: { userId: memberId, from: 'sub-agent', aiEmployeeUsername: workerUsername },
1430
+ });
1431
+ if (!workerConversation) throw new Error('The worker conversation was not persisted.');
1432
+ const toolRows = await app.db.getRepository('aiToolMessages').find({
1433
+ filter: { sessionId: workerConversation.get('sessionId'), toolName: 'worker_read_tool' },
1434
+ sort: ['id'],
1435
+ });
1436
+ expect(toolRows).toHaveLength(2);
1437
+ expect(toolRows[0].get('status')).toBe('success');
1438
+ expect(toolRows[1].get('status')).not.toBe('success');
1439
+ const workerJournal = await app.db.getRepository('agentHierarchyInvocations').findOne({
1440
+ filter: { rootSessionId: memberSessionId, employeeUsername: workerUsername },
1441
+ });
1442
+ expect(workerJournal?.get('status')).toBe('uncertain');
1443
+ });
1444
+
1445
+ it.each([true, false])(
1446
+ 'propagates the native conversation abort into an active worker read (stream=%s)',
1447
+ async (stream) => {
1448
+ probeCursors.clear();
1449
+ probeGenerationModes.clear();
1450
+ probeScripts.clear();
1451
+ probeScripts.set('strong-model', [
1452
+ { kind: 'tool', name: HIERARCHY_LIST_TOOL, args: {} },
1453
+ {
1454
+ kind: 'tool',
1455
+ name: HIERARCHY_DISPATCH_TOOL,
1456
+ args: { username: targetUsername, question: 'Read a file and stop if cancelled.' },
1457
+ },
1458
+ { kind: 'answer', text: 'The root finished after receiving the worker result.' },
1459
+ ]);
1460
+ probeScripts.set('lite-model', [
1461
+ {
1462
+ kind: 'tool',
1463
+ name: HIERARCHY_DISPATCH_TOOL,
1464
+ args: { username: workerUsername, question: 'Read cancel.txt.' },
1465
+ },
1466
+ { kind: 'answer', text: 'The specialist received the worker result.' },
1467
+ ]);
1468
+ probeScripts.set('worker-lite', [
1469
+ { kind: 'tool', name: 'worker_read_tool', args: { path: 'cancel.txt' } },
1470
+ { kind: 'answer', text: 'The worker received the read result.' },
1471
+ ]);
1472
+ workerInvocations.length = 0;
1473
+
1474
+ let signalWorkerStarted = () => undefined;
1475
+ let finishWorkerRead = () => undefined;
1476
+ const workerStarted = new Promise<void>((resolve) => {
1477
+ signalWorkerStarted = resolve;
1478
+ });
1479
+ const gatedRead = new Promise<void>((resolve) => {
1480
+ finishWorkerRead = resolve;
1481
+ });
1482
+ afterWorkerInvoke = async () => {
1483
+ signalWorkerStarted();
1484
+ await gatedRead;
1485
+ };
1486
+ const sessionId = randomUUID();
1487
+ await app.db.getRepository('aiConversations').create({
1488
+ values: { sessionId, userId: adminId, aiEmployeeUsername: leaderUsername, title: 'Cancel propagation test' },
1489
+ });
1490
+ const requestOutcome = Promise.resolve(
1491
+ adminAgent.resource('aiConversations').sendMessages({
1492
+ values: {
1493
+ sessionId,
1494
+ aiEmployee: leaderUsername,
1495
+ model: { llmService: 'mock-root', model: 'strong-model' },
1496
+ messages: [{ role: 'user', content: { type: 'text', content: 'Read cancel.txt.' } }],
1497
+ stream,
1498
+ },
1499
+ }),
1500
+ ).then(
1501
+ (response) => ({ kind: 'response' as const, response }),
1502
+ (error: unknown) => ({ kind: 'error' as const, error }),
1503
+ );
1504
+ let countsAtAbort: Map<string, number> | undefined;
1505
+ let generationMethodsAtAbort: Map<string, ProbeGenerationCounts> | undefined;
1506
+ let countsBeforeRelease: Map<string, number> | undefined;
1507
+ let generationMethodsBeforeRelease: Map<string, ProbeGenerationCounts> | undefined;
1508
+
1509
+ try {
1510
+ const start = await within(
1511
+ Promise.race([
1512
+ workerStarted.then(() => ({ kind: 'started' as const })),
1513
+ requestOutcome.then((outcome) => ({ kind: 'request' as const, outcome })),
1514
+ ]),
1515
+ 5000,
1516
+ 'Worker read did not start and the request did not return.',
1517
+ );
1518
+ if (start.kind === 'request') {
1519
+ throw new Error(
1520
+ start.outcome.kind === 'response'
1521
+ ? `The request returned status ${start.outcome.response.status} before the worker started.`
1522
+ : `The request failed before the worker started: ${String(start.outcome.error)}`,
1523
+ );
1524
+ }
1525
+ if (stream) {
1526
+ const ai = app.pm.get('ai') as unknown as PluginAiProbe;
1527
+ expect(ai.aiEmployeesManager.conversationController.get(sessionId)).toBeDefined();
1528
+ }
1529
+ countsAtAbort = new Map(probeCursors);
1530
+ generationMethodsAtAbort = generationModeSnapshot();
1531
+ expect(countsAtAbort).toEqual(
1532
+ new Map([
1533
+ ['strong-model', 2],
1534
+ ['lite-model', 1],
1535
+ ['worker-lite', 1],
1536
+ ]),
1537
+ );
1538
+ expect(generationMethodsAtAbort).toEqual(
1539
+ new Map<string, ProbeGenerationCounts>([
1540
+ ['strong-model', { generate: stream ? 0 : 2, stream: stream ? 2 : 0 }],
1541
+ ['lite-model', { generate: stream ? 0 : 1, stream: stream ? 1 : 0 }],
1542
+ ['worker-lite', { generate: stream ? 0 : 1, stream: stream ? 1 : 0 }],
1543
+ ]),
1544
+ );
1545
+ const abortResponse = await adminAgent.resource('aiConversations').abort({ values: { sessionId } });
1546
+ expect(abortResponse.status).toBe(200);
1547
+ const outcome = await within(requestOutcome, 5000, 'Aborted request did not return.');
1548
+ if (outcome.kind === 'error') throw outcome.error;
1549
+ if (stream) {
1550
+ expect(outcome.response.status).toBe(200);
1551
+ const streamText = String(outcome.response.text ?? '');
1552
+ expect(streamText).toContain('"type":"stream_start"');
1553
+ expect(streamText).toContain('"type":"tool_call_chunks"');
1554
+ expect(streamText).not.toContain('The root finished after receiving the worker result.');
1555
+ } else {
1556
+ expect(outcome.response.status).toBe(499);
1557
+ }
1558
+ countsBeforeRelease = new Map(probeCursors);
1559
+ generationMethodsBeforeRelease = generationModeSnapshot();
1560
+ expect(countsBeforeRelease).toEqual(
1561
+ new Map([
1562
+ ['strong-model', stream ? 2 : 3],
1563
+ ['lite-model', 1],
1564
+ ['worker-lite', 1],
1565
+ ]),
1566
+ );
1567
+ expect(generationMethodsBeforeRelease).toEqual(
1568
+ new Map<string, ProbeGenerationCounts>([
1569
+ ['strong-model', { generate: stream ? 0 : 3, stream: stream ? 2 : 0 }],
1570
+ ['lite-model', { generate: stream ? 0 : 1, stream: stream ? 1 : 0 }],
1571
+ ['worker-lite', { generate: stream ? 0 : 1, stream: stream ? 1 : 0 }],
1572
+ ]),
1573
+ );
1574
+ } finally {
1575
+ finishWorkerRead();
1576
+ afterWorkerInvoke = undefined;
1577
+ await within(requestOutcome, 5000, 'Cancelled request was not drained after releasing the worker read.');
1578
+ }
1579
+
1580
+ expect(probeCursors).toEqual(countsBeforeRelease);
1581
+ expect(countsAtAbort).toEqual(
1582
+ new Map([
1583
+ ['strong-model', 2],
1584
+ ['lite-model', 1],
1585
+ ['worker-lite', 1],
1586
+ ]),
1587
+ );
1588
+ expect(countsBeforeRelease).toEqual(probeCursors);
1589
+ expect(generationMethodsBeforeRelease).toEqual(generationModeSnapshot());
1590
+ await new Promise((resolve) => setTimeout(resolve, 50));
1591
+ expect(probeCursors).toEqual(countsBeforeRelease);
1592
+ expect(generationMethodsBeforeRelease).toEqual(generationModeSnapshot());
1593
+ expect(workerInvocations).toEqual([{ path: 'cancel.txt' }]);
1594
+ const workerJournal = await app.db.getRepository('agentHierarchyInvocations').findOne({
1595
+ filter: { rootSessionId: sessionId, employeeUsername: workerUsername },
1596
+ });
1597
+ expect(workerJournal?.get('status')).toBe('uncertain');
1598
+ const workers = await app.db.getRepository('aiConversations').find({
1599
+ filter: { userId: adminId, from: 'sub-agent', aiEmployeeUsername: workerUsername },
1600
+ });
1601
+ const worker = workers.find((item) => recordOrEmpty(item.get('options')).hierarchyRootSessionId === sessionId);
1602
+ if (!worker) throw new Error('The cancelled worker conversation was not persisted.');
1603
+ const toolRows = await app.db.getRepository('aiToolMessages').find({
1604
+ filter: { sessionId: worker.get('sessionId'), toolName: 'worker_read_tool' },
1605
+ });
1606
+ expect(toolRows).toHaveLength(1);
1607
+ expect(toolRows[0].get('status')).not.toBe('success');
1608
+ },
1609
+ );
1610
+
1611
+ it('bounds a non-cooperative worker read by binding timeout and discards its late result', async () => {
1612
+ const workerBinding = await app.db
1613
+ .getRepository('orchestratorConfig')
1614
+ .findOne({ filter: { leaderUsername: targetUsername, subAgentUsername: workerUsername } });
1615
+ if (!workerBinding) throw new Error('The worker routing binding was not created.');
1616
+ await workerBinding.update({ timeout: 1000 });
1617
+ workerInvocations.length = 0;
1618
+ probeCursors.clear();
1619
+ probeScripts.clear();
1620
+ probeScripts.set('strong-model', [
1621
+ { kind: 'tool', name: HIERARCHY_LIST_TOOL, args: {} },
1622
+ {
1623
+ kind: 'tool',
1624
+ name: HIERARCHY_DISPATCH_TOOL,
1625
+ args: { username: targetUsername, question: 'Read a slow file.' },
1626
+ },
1627
+ { kind: 'answer', text: 'The slow read exceeded its delegated time budget.' },
1628
+ ]);
1629
+ probeScripts.set('lite-model', [
1630
+ {
1631
+ kind: 'tool',
1632
+ name: HIERARCHY_DISPATCH_TOOL,
1633
+ args: { username: workerUsername, question: 'Read slow.txt.' },
1634
+ },
1635
+ { kind: 'answer', text: 'The worker operation did not finish in time.', allowMissingToolResult: true },
1636
+ ]);
1637
+ probeScripts.set('worker-lite', [
1638
+ { kind: 'tool', name: 'worker_read_tool', args: { path: 'slow.txt' } },
1639
+ { kind: 'answer', text: 'The late result must not be committed.' },
1640
+ ]);
1641
+ afterWorkerInvoke = async () => new Promise((resolve) => setTimeout(resolve, 1400));
1642
+
1643
+ const sessionId = randomUUID();
1644
+ await app.db.getRepository('aiConversations').create({
1645
+ values: { sessionId, userId: adminId, aiEmployeeUsername: leaderUsername, title: 'Timeout test' },
1646
+ });
1647
+ const startedAt = Date.now();
1648
+ const response = await adminAgent.resource('aiConversations').sendMessages({
1649
+ values: {
1650
+ sessionId,
1651
+ aiEmployee: leaderUsername,
1652
+ model: { llmService: 'mock-root', model: 'strong-model' },
1653
+ messages: [{ role: 'user', content: { type: 'text', content: 'Read slow.txt.' } }],
1654
+ stream: false,
1655
+ },
1656
+ });
1657
+ const elapsedMs = Date.now() - startedAt;
1658
+ await new Promise((resolve) => setTimeout(resolve, 700));
1659
+
1660
+ expect(response.status).toBe(200);
1661
+ expect(elapsedMs).toBeGreaterThanOrEqual(900);
1662
+ expect(elapsedMs).toBeLessThan(5000);
1663
+ expect(workerInvocations).toEqual([{ path: 'slow.txt' }]);
1664
+ const journal = await app.db.getRepository('agentHierarchyInvocations').find({
1665
+ filter: { rootSessionId: sessionId },
1666
+ });
1667
+ const workerJournal = journal.find((item) => item.get('employeeUsername') === workerUsername);
1668
+ expect(workerJournal?.get('status')).toBe('uncertain');
1669
+ const workerConversations = await app.db.getRepository('aiConversations').find({
1670
+ filter: { userId: adminId, from: 'sub-agent', aiEmployeeUsername: workerUsername },
1671
+ });
1672
+ const workerConversation = workerConversations.find(
1673
+ (item) => recordOrEmpty(item.get('options')).hierarchyRootSessionId === sessionId,
1674
+ );
1675
+ if (!workerConversation) throw new Error('The timed-out worker conversation was not persisted.');
1676
+ const lateToolResults = await app.db.getRepository('aiToolMessages').find({
1677
+ filter: {
1678
+ sessionId: workerConversation.get('sessionId'),
1679
+ toolName: 'worker_read_tool',
1680
+ status: 'success',
1681
+ },
1682
+ });
1683
+ expect(lateToolResults).toHaveLength(0);
1684
+ await workerBinding.update({ timeout: 120000 });
1685
+ afterWorkerInvoke = undefined;
1686
+ });
1687
+
1688
+ it('blocks native dispatch and tools loaded through a skill on an enrolled root, while legacy roots pass', async () => {
1689
+ const config = app.db.getRepository('orchestratorConfig');
1690
+ const rootBinding = await config.findOne({ filter: { leaderUsername, subAgentUsername: targetUsername } });
1691
+ if (!rootBinding) throw new Error('The specialist routing binding was not created.');
1692
+ const employee = await app.db.getRepository('aiEmployees').findOne({ filter: { username: leaderUsername } });
1693
+ if (!employee) throw new Error('The orchestrator employee was not found.');
1694
+
1695
+ await rootBinding.update({ routingEnabled: false });
1696
+ const legacyNext = vi.fn(async () => undefined);
1697
+ await guardHierarchyEnrollment(chatContext(app, adminId, rootSessionId, leaderUsername), legacyNext);
1698
+ expect(legacyNext).toHaveBeenCalledOnce();
1699
+ await rootBinding.update({ routingEnabled: true });
1700
+
1701
+ await employee.update({
1702
+ skillSettings: { tools: [{ name: 'dispatch-sub-agent-task', autoCall: true }] },
1703
+ chatSettings: { enableSkills: false },
1704
+ });
1705
+ await expect(
1706
+ guardHierarchyEnrollment(
1707
+ chatContext(app, adminId, rootSessionId, leaderUsername),
1708
+ vi.fn(async () => undefined),
1709
+ ),
1710
+ ).rejects.toThrow('Disable native AI employee dispatch');
1711
+
1712
+ await employee.update({ skillSettings: { tools: [] }, chatSettings: { enableSkills: false } });
1713
+ const aiToolId = Number(`${Date.now()}`);
1714
+ await app.db.getRepository('aiToolMessages').create({
1715
+ values: {
1716
+ id: aiToolId,
1717
+ sessionId: rootSessionId,
1718
+ messageId: aiToolId + 1,
1719
+ toolCallId: `loaded-skill-${aiToolId}`,
1720
+ toolName: 'getSkill',
1721
+ status: 'success',
1722
+ invokeStatus: 'confirmed',
1723
+ content: { skillName: 'loaded-worker-skill' },
1724
+ },
1725
+ });
1726
+ const ai = app.pm.get('ai') as unknown as PluginAiProbe;
1727
+ const skillsManager = ai.ai?.skillsManager;
1728
+ if (!skillsManager) throw new Error('The mock AI SkillsManager was not loaded.');
1729
+ vi.spyOn(skillsManager, 'getSkills').mockResolvedValue([
1730
+ { name: 'loaded-worker-skill', tools: ['worker_read_tool'] },
1731
+ ]);
1732
+
1733
+ await expect(
1734
+ guardHierarchyEnrollment(
1735
+ chatContext(app, adminId, rootSessionId, leaderUsername),
1736
+ vi.fn(async () => undefined),
1737
+ ),
1738
+ ).rejects.toThrow('Remove managed worker tools');
1739
+ });
1740
+
1741
+ it('auto-approves only an exact persisted root ASK after explicit session opt-in and preserves manual approval when off', async () => {
1742
+ const leader = await app.db.getRepository('aiEmployees').findOne({ filter: { username: leaderUsername } });
1743
+ if (!leader) throw new Error('The orchestrator employee was not found.');
1744
+ await leader.update({
1745
+ skillSettings: {
1746
+ tools: [
1747
+ { name: HIERARCHY_LIST_TOOL, autoCall: true },
1748
+ { name: HIERARCHY_DISPATCH_TOOL, autoCall: true },
1749
+ { name: 'session_ask_approval_probe', autoCall: false },
1750
+ ],
1751
+ },
1752
+ chatSettings: { enableSkills: false },
1753
+ });
1754
+ sessionAskInvocations.length = 0;
1755
+ const makeSession = async (title: string) => {
1756
+ const sessionId = randomUUID();
1757
+ await app.db.getRepository('aiConversations').create({
1758
+ values: { sessionId, userId: adminId, aiEmployeeUsername: leaderUsername, title },
1759
+ });
1760
+ return sessionId;
1761
+ };
1762
+ const askInSession = async (sessionId: string, value: string) => {
1763
+ probeCursors.clear();
1764
+ probeScripts.clear();
1765
+ probeScripts.set('strong-model', [
1766
+ { kind: 'tool', name: 'session_ask_approval_probe', args: { value } },
1767
+ { kind: 'answer', text: `Finished ${value}.` },
1768
+ ]);
1769
+ const response = await adminAgent.resource('aiConversations').sendMessages({
1770
+ values: {
1771
+ sessionId,
1772
+ aiEmployee: leaderUsername,
1773
+ model: { llmService: 'mock-root', model: 'strong-model' },
1774
+ messages: [{ role: 'user', content: { type: 'text', content: `Run the approved task ${value}.` } }],
1775
+ stream: true,
1776
+ },
1777
+ });
1778
+ expect(response.status).toBe(200);
1779
+ const message = await app.db.getRepository('aiMessages').findOne({
1780
+ filter: { sessionId, role: leaderUsername },
1781
+ sort: ['-messageId'],
1782
+ });
1783
+ if (!message) throw new Error('The interrupted root message was not persisted.');
1784
+ const messageId = String(message.get('messageId'));
1785
+ const calls = message.get('toolCalls') as Array<{ id?: unknown; name?: unknown }> | undefined;
1786
+ const call = calls?.find((item) => item.name === 'session_ask_approval_probe');
1787
+ if (typeof call?.id !== 'string') throw new Error('The expected ASK tool call was not persisted.');
1788
+ const toolMessage = await app.db.getRepository('aiToolMessages').findOne({
1789
+ filter: {
1790
+ sessionId,
1791
+ messageId: message.get('messageId'),
1792
+ toolCallId: call.id,
1793
+ toolName: 'session_ask_approval_probe',
1794
+ },
1795
+ });
1796
+ expect(toolMessage?.get('invokeStatus')).toBe('interrupted');
1797
+ expect(toolMessage?.get('auto')).toBe(false);
1798
+ expect(sessionAskInvocations).toEqual([]);
1799
+ return { sessionId, messageId, toolCallId: call.id };
1800
+ };
1801
+ const identityValues = (identity: { sessionId: string; messageId: string; toolCallId: string }) => ({
1802
+ sessionId: identity.sessionId,
1803
+ messageId: identity.messageId,
1804
+ toolCallId: identity.toolCallId,
1805
+ });
1806
+ const isEligible = (identity: { sessionId: string; messageId: string; toolCallId: string }) =>
1807
+ adminAgent.resource('agentAutoApproval').eligible({ values: identityValues(identity) });
1808
+ const decide = (
1809
+ identity: { sessionId: string; messageId: string; toolCallId: string },
1810
+ agentAutoApproval: boolean,
1811
+ decisionType: 'approve' | 'reject' | 'edit' = 'approve',
1812
+ ) =>
1813
+ adminAgent.resource('aiConversations').updateUserDecision({
1814
+ values: {
1815
+ ...identityValues(identity),
1816
+ userDecision:
1817
+ decisionType === 'reject'
1818
+ ? { type: 'reject', message: 'Keep this call paused.' }
1819
+ : decisionType === 'edit'
1820
+ ? { type: 'edit', editedAction: { name: 'session_ask_approval_probe', args: { value: 'edited' } } }
1821
+ : { type: 'approve' },
1822
+ ...(agentAutoApproval ? { agentAutoApproval: true } : {}),
1823
+ },
1824
+ });
1825
+ const resume = (identity: { sessionId: string; messageId: string }) =>
1826
+ adminAgent.resource('aiConversations').resumeToolCall({
1827
+ values: {
1828
+ sessionId: identity.sessionId,
1829
+ messageId: identity.messageId,
1830
+ aiEmployee: leaderUsername,
1831
+ model: { llmService: 'mock-root', model: 'strong-model' },
1832
+ },
1833
+ });
1834
+ const findToolMessage = (identity: { sessionId: string; messageId: string; toolCallId: string }) =>
1835
+ app.db.getRepository('aiToolMessages').findOne({ filter: identityValues(identity) });
1836
+
1837
+ const manualSession = await makeSession('Manual ASK while automatic approval is off');
1838
+ const manualCall = await askInSession(manualSession, 'manual');
1839
+ expect((await isEligible(manualCall)).body.data.eligible).toBe(false);
1840
+ const blockedAutoDecision = await decide(manualCall, true);
1841
+ expect(blockedAutoDecision.status).toBe(200);
1842
+ expect(blockedAutoDecision.body.data.updated).toBe(0);
1843
+ expect((await findToolMessage(manualCall))?.get('invokeStatus')).toBe('interrupted');
1844
+ const manualDecision = await decide(manualCall, false);
1845
+ expect(manualDecision.body.data.updated).toBe(1);
1846
+ const persistedManualDecision = await app.db.getRepository('aiToolMessages').findOne({
1847
+ filter: {
1848
+ sessionId: manualCall.sessionId,
1849
+ messageId: manualCall.messageId,
1850
+ toolCallId: manualCall.toolCallId,
1851
+ },
1852
+ });
1853
+ expect(persistedManualDecision?.get('invokeStatus')).toBe('waiting');
1854
+ expect(persistedManualDecision?.get('userDecision')).toEqual({ type: 'approve' });
1855
+ const ai = app.pm.get('ai') as unknown as {
1856
+ aiConversationsManager: {
1857
+ getUserDecisions: (messageId: string) => Promise<{ decisions: unknown[] } | undefined>;
1858
+ };
1859
+ };
1860
+ expect(await ai.aiConversationsManager.getUserDecisions(manualCall.messageId)).toEqual({
1861
+ interruptId: expect.any(String),
1862
+ decisions: [{ type: 'approve' }],
1863
+ });
1864
+ expect((await resume(manualCall)).status).toBe(200);
1865
+ expect(sessionAskInvocations).toEqual([{ value: 'manual' }]);
1866
+
1867
+ const automaticSession = await makeSession('Session with automatic ASK approval');
1868
+ sessionAskInvocations.length = 0;
1869
+ expect(
1870
+ (
1871
+ await adminAgent.resource('agentAutoApproval').set({
1872
+ values: { sessionId: automaticSession, enabled: true },
1873
+ })
1874
+ ).status,
1875
+ ).toBe(200);
1876
+ const automaticCall = await askInSession(automaticSession, 'automatic');
1877
+ expect((await isEligible(automaticCall)).body.data.eligible).toBe(true);
1878
+ expect((await isEligible({ ...automaticCall, sessionId: manualSession })).body.data.eligible).toBe(false);
1879
+ expect(
1880
+ (await memberAgent.resource('agentAutoApproval').eligible({ values: identityValues(automaticCall) })).status,
1881
+ ).toBe(404);
1882
+
1883
+ expect((await decide(automaticCall, true, 'reject')).body.data.updated).toBe(0);
1884
+ expect((await findToolMessage(automaticCall))?.get('invokeStatus')).toBe('interrupted');
1885
+ expect((await decide(automaticCall, true, 'edit')).body.data.updated).toBe(0);
1886
+ expect((await findToolMessage(automaticCall))?.get('invokeStatus')).toBe('interrupted');
1887
+
1888
+ await adminAgent.resource('agentAutoApproval').set({
1889
+ values: { sessionId: automaticSession, enabled: false },
1890
+ });
1891
+ const disabledDuringInterrupt = await decide(automaticCall, true);
1892
+ expect(disabledDuringInterrupt.body.data.updated).toBe(0);
1893
+ expect((await findToolMessage(automaticCall))?.get('invokeStatus')).toBe('interrupted');
1894
+
1895
+ await adminAgent.resource('agentAutoApproval').set({
1896
+ values: { sessionId: automaticSession, enabled: true },
1897
+ });
1898
+ const automaticDecision = await decide(automaticCall, true);
1899
+ expect(automaticDecision.body.data.updated).toBe(1);
1900
+ expect((await resume(automaticCall)).status).toBe(200);
1901
+ expect(sessionAskInvocations).toEqual([{ value: 'automatic' }]);
1902
+ const duplicateDecision = await decide(automaticCall, true);
1903
+ expect(duplicateDecision.body.data.updated).toBe(0);
1904
+ expect(sessionAskInvocations).toEqual([{ value: 'automatic' }]);
1905
+ });
1906
+
1907
+ it('gates both specialist hierarchy tools on session opt-in and rechecks consent between calls', async () => {
1908
+ const profiles = new HarnessProfileService(app.db);
1909
+ const sourceProfile = await profiles.getPublishedByTag(profileTag);
1910
+ const rootBinding = await app.db
1911
+ .getRepository('orchestratorConfig')
1912
+ .findOne({ filter: { leaderUsername, subAgentUsername: targetUsername } });
1913
+ const specialist = await app.db.getRepository('aiEmployees').findOne({ filter: { username: targetUsername } });
1914
+ if (!sourceProfile || !rootBinding || !specialist)
1915
+ throw new Error('The specialist approval fixtures are unavailable.');
1916
+
1917
+ const originalTag = String(rootBinding.get('harnessTag'));
1918
+ const originalSkillSettings = recordOrEmpty(specialist.get('skillSettings'));
1919
+ const originalChatSettings = recordOrEmpty(specialist.get('chatSettings'));
1920
+ const askTag = `hierarchy-specialist-ask-${Date.now()}`;
1921
+ const askProfile = await profiles.createProfile({
1922
+ tag: askTag,
1923
+ settings: {
1924
+ ...sourceProfile.settings,
1925
+ tools: {
1926
+ ...sourceProfile.settings.tools,
1927
+ allow: [],
1928
+ ask: [HIERARCHY_LIST_TOOL, HIERARCHY_DISPATCH_TOOL],
1929
+ effects: {
1930
+ ...sourceProfile.settings.tools.effects,
1931
+ [HIERARCHY_LIST_TOOL]: 'read',
1932
+ [HIERARCHY_DISPATCH_TOOL]: 'read',
1933
+ },
1934
+ },
1935
+ },
1936
+ });
1937
+ await rootBinding.update({ harnessTag: askProfile.profile.tag });
1938
+ await specialist.update({
1939
+ skillSettings: {
1940
+ ...originalSkillSettings,
1941
+ tools: [
1942
+ { name: HIERARCHY_LIST_TOOL, autoCall: false },
1943
+ { name: HIERARCHY_DISPATCH_TOOL, autoCall: false },
1944
+ ],
1945
+ },
1946
+ chatSettings: { ...originalChatSettings, enableSkills: false },
1947
+ });
1948
+
1949
+ const makeSession = async (title: string) => {
1950
+ const sessionId = randomUUID();
1951
+ await app.db.getRepository('aiConversations').create({
1952
+ values: { sessionId, userId: adminId, aiEmployeeUsername: leaderUsername, title },
1953
+ });
1954
+ return sessionId;
1955
+ };
1956
+ const setApproval = (sessionId: string, enabled: boolean) =>
1957
+ adminAgent.resource('agentAutoApproval').set({ values: { sessionId, enabled } });
1958
+ const setScripts = () => {
1959
+ beforeProbeStep.clear();
1960
+ probeCursors.clear();
1961
+ probeScripts.clear();
1962
+ workerInvocations.length = 0;
1963
+ probeScripts.set('strong-model', [
1964
+ { kind: 'tool', name: HIERARCHY_LIST_TOOL, args: {} },
1965
+ {
1966
+ kind: 'tool',
1967
+ name: HIERARCHY_DISPATCH_TOOL,
1968
+ args: { username: targetUsername, question: 'Use the specialist tools and read fixture.txt.' },
1969
+ },
1970
+ { kind: 'answer', text: 'The orchestrator reviewed the specialist result.' },
1971
+ ]);
1972
+ probeScripts.set('lite-model', [
1973
+ { kind: 'tool', name: HIERARCHY_LIST_TOOL, args: {} },
1974
+ {
1975
+ kind: 'tool',
1976
+ name: HIERARCHY_DISPATCH_TOOL,
1977
+ args: { username: workerUsername, question: 'Read fixture.txt.' },
1978
+ },
1979
+ { kind: 'answer', text: 'The specialist reviewed the worker result.' },
1980
+ ]);
1981
+ probeScripts.set('worker-lite', [
1982
+ { kind: 'tool', name: 'worker_read_tool', args: { path: 'fixture.txt' } },
1983
+ { kind: 'answer', text: `The worker verified ${workerEvidence}.`, requireContext: workerEvidence },
1984
+ ]);
1985
+ };
1986
+ const send = (sessionId: string) =>
1987
+ adminAgent.resource('aiConversations').sendMessages({
1988
+ values: {
1989
+ sessionId,
1990
+ aiEmployee: leaderUsername,
1991
+ model: { llmService: 'mock-root', model: 'strong-model' },
1992
+ messages: [{ role: 'user', content: { type: 'text', content: 'Delegate the read and summarize it.' } }],
1993
+ stream: false,
1994
+ },
1995
+ });
1996
+ const childForRootSession = async (sessionId: string) => {
1997
+ const children = await app.db.getRepository('aiConversations').find({
1998
+ filter: { userId: adminId, from: 'sub-agent', aiEmployeeUsername: targetUsername },
1999
+ });
2000
+ return children.find((item) => recordOrEmpty(item.get('options')).hierarchyRootSessionId === sessionId);
2001
+ };
2002
+
2003
+ try {
2004
+ const previewSession = await makeSession('Specialist ASK preview switch test');
2005
+ expect((await setApproval(previewSession, false)).status).toBe(200);
2006
+ expect(
2007
+ (
2008
+ await adminAgent.resource('agentHierarchy').preview({
2009
+ values: { sessionId: previewSession, username: targetUsername },
2010
+ })
2011
+ ).status,
2012
+ ).toBe(409);
2013
+ expect((await setApproval(previewSession, true)).status).toBe(200);
2014
+ expect(
2015
+ (
2016
+ await adminAgent.resource('agentHierarchy').preview({
2017
+ values: { sessionId: previewSession, username: targetUsername },
2018
+ })
2019
+ ).status,
2020
+ ).toBe(200);
2021
+
2022
+ const disabledSession = await makeSession('Specialist ASK disabled dispatch test');
2023
+ await setApproval(disabledSession, false);
2024
+ setScripts();
2025
+ expect((await send(disabledSession)).status).toBe(200);
2026
+ expect(workerInvocations).toEqual([]);
2027
+ expect(probeCursors.get('lite-model')).toBeUndefined();
2028
+
2029
+ const enabledSession = await makeSession('Specialist ASK enabled dispatch test');
2030
+ await setApproval(enabledSession, true);
2031
+ setScripts();
2032
+ expect((await send(enabledSession)).status).toBe(200);
2033
+ expect(workerInvocations).toEqual([{ path: 'fixture.txt' }]);
2034
+ const enabledChild = await childForRootSession(enabledSession);
2035
+ if (!enabledChild) throw new Error('The enabled specialist conversation was not persisted.');
2036
+ const enabledToolRows = await app.db.getRepository('aiToolMessages').find({
2037
+ filter: { sessionId: enabledChild.get('sessionId') },
2038
+ sort: ['id'],
2039
+ });
2040
+ for (const name of [HIERARCHY_LIST_TOOL, HIERARCHY_DISPATCH_TOOL]) {
2041
+ const row = enabledToolRows.find((item) => item.get('toolName') === name);
2042
+ expect(row?.get('auto')).toBe(true);
2043
+ expect(row?.get('status')).toBe('success');
2044
+ }
2045
+
2046
+ const revokedSession = await makeSession('Specialist ASK revoked during dispatch test');
2047
+ await setApproval(revokedSession, true);
2048
+ setScripts();
2049
+ beforeProbeStep.set('lite-model', async (index) => {
2050
+ if (index !== 1) return;
2051
+ beforeProbeStep.delete('lite-model');
2052
+ expect((await setApproval(revokedSession, false)).status).toBe(200);
2053
+ });
2054
+ expect((await send(revokedSession)).status).toBe(200);
2055
+ expect(workerInvocations).toEqual([]);
2056
+ const revokedChild = await childForRootSession(revokedSession);
2057
+ if (!revokedChild) throw new Error('The revoked specialist conversation was not persisted.');
2058
+ const revokedToolRows = await app.db.getRepository('aiToolMessages').find({
2059
+ filter: { sessionId: revokedChild.get('sessionId') },
2060
+ sort: ['id'],
2061
+ });
2062
+ expect(revokedToolRows.find((item) => item.get('toolName') === HIERARCHY_LIST_TOOL)?.get('status')).toBe(
2063
+ 'success',
2064
+ );
2065
+ expect(revokedToolRows.find((item) => item.get('toolName') === HIERARCHY_DISPATCH_TOOL)?.get('status')).not.toBe(
2066
+ 'success',
2067
+ );
2068
+ } finally {
2069
+ beforeProbeStep.delete('lite-model');
2070
+ afterWorkerInvoke = undefined;
2071
+ await rootBinding.update({ harnessTag: originalTag });
2072
+ await specialist.update({ skillSettings: originalSkillSettings, chatSettings: originalChatSettings });
2073
+ }
2074
+ });
2075
+
2076
+ it('allows an ASK worker read only for an opted-in root session and stops after revocation', async () => {
2077
+ const profiles = new HarnessProfileService(app.db);
2078
+ const sourceWorkerProfile = await profiles.getPublishedByTag(workerProfileTag);
2079
+ const workerBinding = await app.db
2080
+ .getRepository('orchestratorConfig')
2081
+ .findOne({ filter: { leaderUsername: targetUsername, subAgentUsername: workerUsername } });
2082
+ const worker = await app.db.getRepository('aiEmployees').findOne({ filter: { username: workerUsername } });
2083
+ if (!sourceWorkerProfile || !workerBinding || !worker)
2084
+ throw new Error('The managed worker ASK fixtures are unavailable.');
2085
+
2086
+ const originalTag = String(workerBinding.get('harnessTag'));
2087
+ const originalSkillSettings = recordOrEmpty(worker.get('skillSettings'));
2088
+ const originalChatSettings = recordOrEmpty(worker.get('chatSettings'));
2089
+ const askTag = `hierarchy-worker-ask-${Date.now()}`;
2090
+ const askProfile = await profiles.createProfile({
2091
+ tag: askTag,
2092
+ settings: {
2093
+ ...sourceWorkerProfile.settings,
2094
+ tools: {
2095
+ ...sourceWorkerProfile.settings.tools,
2096
+ allow: [],
2097
+ ask: ['worker_read_tool'],
2098
+ effects: { ...sourceWorkerProfile.settings.tools.effects, worker_read_tool: 'read' },
2099
+ },
2100
+ },
2101
+ });
2102
+ await workerBinding.update({ harnessTag: askProfile.profile.tag });
2103
+ await worker.update({
2104
+ skillSettings: { ...originalSkillSettings, tools: [{ name: 'worker_read_tool', autoCall: false }] },
2105
+ chatSettings: { ...originalChatSettings, enableSkills: false },
2106
+ });
2107
+
2108
+ const makeSession = async (title: string) => {
2109
+ const sessionId = randomUUID();
2110
+ await app.db.getRepository('aiConversations').create({
2111
+ values: { sessionId, userId: adminId, aiEmployeeUsername: leaderUsername, title },
2112
+ });
2113
+ return sessionId;
2114
+ };
2115
+ const setApproval = (sessionId: string, enabled: boolean) =>
2116
+ adminAgent.resource('agentAutoApproval').set({ values: { sessionId, enabled } });
2117
+ const setScripts = (paths: string[], requireEvidence = false) => {
2118
+ afterWorkerInvoke = undefined;
2119
+ probeCursors.clear();
2120
+ probeScripts.clear();
2121
+ providerInputs.clear();
2122
+ workerInvocations.length = 0;
2123
+ const evidenceExpectation = requireEvidence
2124
+ ? { requireContext: workerEvidence, appendMarker: workerEvidence }
2125
+ : {};
2126
+ probeScripts.set('strong-model', [
2127
+ { kind: 'tool', name: HIERARCHY_LIST_TOOL, args: {} },
2128
+ {
2129
+ kind: 'tool',
2130
+ name: HIERARCHY_DISPATCH_TOOL,
2131
+ args: { username: targetUsername, question: `Read ${paths.join(' and ')}.` },
2132
+ },
2133
+ { kind: 'answer', text: 'The orchestrator received the specialist result.', ...evidenceExpectation },
2134
+ ]);
2135
+ probeScripts.set('lite-model', [
2136
+ {
2137
+ kind: 'tool',
2138
+ name: HIERARCHY_DISPATCH_TOOL,
2139
+ args: { username: workerUsername, question: `Read ${paths.join(' and ')}.` },
2140
+ },
2141
+ { kind: 'answer', text: 'The specialist received the worker result.', ...evidenceExpectation },
2142
+ ]);
2143
+ probeScripts.set('worker-lite', [
2144
+ ...paths.map((path) => ({ kind: 'tool' as const, name: 'worker_read_tool', args: { path } })),
2145
+ { kind: 'answer', text: 'The worker reviewed the available files.', ...evidenceExpectation },
2146
+ ]);
2147
+ };
2148
+ const send = (sessionId: string) =>
2149
+ adminAgent.resource('aiConversations').sendMessages({
2150
+ values: {
2151
+ sessionId,
2152
+ aiEmployee: leaderUsername,
2153
+ model: { llmService: 'mock-root', model: 'strong-model' },
2154
+ messages: [{ role: 'user', content: { type: 'text', content: 'Delegate the read-only file task.' } }],
2155
+ stream: false,
2156
+ },
2157
+ });
2158
+ const workerChildForRootSession = async (sessionId: string) => {
2159
+ const children = await app.db.getRepository('aiConversations').find({
2160
+ filter: { userId: adminId, from: 'sub-agent', aiEmployeeUsername: workerUsername },
2161
+ });
2162
+ return children.find((item) => recordOrEmpty(item.get('options')).hierarchyRootSessionId === sessionId);
2163
+ };
2164
+
2165
+ try {
2166
+ const disabledSession = await makeSession('Managed worker ASK default-off test');
2167
+ setScripts(['fixture.txt']);
2168
+ expect((await send(disabledSession)).status).toBe(200);
2169
+ expect(workerInvocations).toEqual([]);
2170
+ expect(probeCursors.get('worker-lite')).toBeUndefined();
2171
+
2172
+ const enabledSession = await makeSession('Managed worker ASK opted-in test');
2173
+ expect((await setApproval(enabledSession, true)).status).toBe(200);
2174
+ setScripts(['fixture.txt']);
2175
+ expect((await send(enabledSession)).status).toBe(200);
2176
+ expect(workerInvocations).toEqual([{ path: 'fixture.txt' }]);
2177
+ const enabledChild = await workerChildForRootSession(enabledSession);
2178
+ if (!enabledChild) throw new Error('The enabled managed worker conversation was not persisted.');
2179
+ const enabledToolRows = await app.db.getRepository('aiToolMessages').find({
2180
+ filter: { sessionId: enabledChild.get('sessionId'), toolName: 'worker_read_tool' },
2181
+ sort: ['id'],
2182
+ });
2183
+ expect(enabledToolRows).toHaveLength(1);
2184
+ expect(enabledToolRows[0].get('auto')).toBe(true);
2185
+ expect(enabledToolRows[0].get('status')).toBe('success');
2186
+
2187
+ const deliveredSession = await makeSession('Managed worker result delivered after opt-out test');
2188
+ expect((await setApproval(deliveredSession, true)).status).toBe(200);
2189
+ setScripts(['fixture.txt'], true);
2190
+ afterWorkerInvoke = async () => {
2191
+ afterWorkerInvoke = undefined;
2192
+ expect((await setApproval(deliveredSession, false)).status).toBe(200);
2193
+ };
2194
+ expect((await send(deliveredSession)).status).toBe(200);
2195
+ expect(workerInvocations).toEqual([{ path: 'fixture.txt' }]);
2196
+ expect(probeCursors.get('worker-lite')).toBe(2);
2197
+ expect(JSON.stringify(providerInputs.get('worker-lite')?.[1] ?? [])).toContain(workerEvidence);
2198
+ expect(JSON.stringify(providerInputs.get('lite-model')?.[1] ?? [])).toContain(workerEvidence);
2199
+ expect(JSON.stringify(providerInputs.get('strong-model')?.[2] ?? [])).toContain(workerEvidence);
2200
+
2201
+ const revokedSession = await makeSession('Managed worker ASK revoked between calls test');
2202
+ expect((await setApproval(revokedSession, true)).status).toBe(200);
2203
+ setScripts(['fixture.txt', 'second.txt']);
2204
+ afterWorkerInvoke = async () => {
2205
+ afterWorkerInvoke = undefined;
2206
+ expect((await setApproval(revokedSession, false)).status).toBe(200);
2207
+ };
2208
+ expect((await send(revokedSession)).status).toBe(200);
2209
+ expect(workerInvocations).toEqual([{ path: 'fixture.txt' }]);
2210
+ const revokedChild = await workerChildForRootSession(revokedSession);
2211
+ if (!revokedChild) throw new Error('The revoked managed worker conversation was not persisted.');
2212
+ const revokedToolRows = await app.db.getRepository('aiToolMessages').find({
2213
+ filter: { sessionId: revokedChild.get('sessionId'), toolName: 'worker_read_tool' },
2214
+ sort: ['id'],
2215
+ });
2216
+ expect(revokedToolRows).toHaveLength(2);
2217
+ expect(revokedToolRows[0].get('status')).toBe('success');
2218
+ expect(revokedToolRows[1].get('status')).not.toBe('success');
2219
+ expect(JSON.stringify(providerInputs.get('worker-lite')?.[1] ?? [])).toContain(workerEvidence);
2220
+ } finally {
2221
+ afterWorkerInvoke = undefined;
2222
+ await workerBinding.update({ harnessTag: originalTag });
2223
+ await worker.update({ skillSettings: originalSkillSettings, chatSettings: originalChatSettings });
2224
+ }
2225
+ });
2226
+
2227
+ it('stops a later worker read when the published routing profile changes mid-run', async () => {
2228
+ const profiles = new HarnessProfileService(app.db);
2229
+ const sourceWorkerProfile = await profiles.getPublishedByTag(workerProfileTag);
2230
+ const workerBinding = await app.db
2231
+ .getRepository('orchestratorConfig')
2232
+ .findOne({ filter: { leaderUsername: targetUsername, subAgentUsername: workerUsername } });
2233
+ if (!sourceWorkerProfile || !workerBinding) throw new Error('The managed worker profile fixture is unavailable.');
2234
+
2235
+ const originalTag = String(workerBinding.get('harnessTag'));
2236
+ const deniedProfile = await profiles.createProfile({
2237
+ tag: `hierarchy-worker-denied-mid-run-${Date.now()}`,
2238
+ settings: {
2239
+ ...sourceWorkerProfile.settings,
2240
+ tools: {
2241
+ ...sourceWorkerProfile.settings.tools,
2242
+ allow: [],
2243
+ ask: [],
2244
+ deny: ['worker_read_tool'],
2245
+ },
2246
+ },
2247
+ });
2248
+ const sessionId = randomUUID();
2249
+ await app.db.getRepository('aiConversations').create({
2250
+ values: { sessionId, userId: adminId, aiEmployeeUsername: leaderUsername, title: 'Worker profile change test' },
2251
+ });
2252
+ probeCursors.clear();
2253
+ probeScripts.clear();
2254
+ providerInputs.clear();
2255
+ workerInvocations.length = 0;
2256
+ probeScripts.set('strong-model', [
2257
+ { kind: 'tool', name: HIERARCHY_LIST_TOOL, args: {} },
2258
+ {
2259
+ kind: 'tool',
2260
+ name: HIERARCHY_DISPATCH_TOOL,
2261
+ args: { username: targetUsername, question: 'Read one file, then recheck the worker profile.' },
2262
+ },
2263
+ { kind: 'answer', text: 'The routing policy changed; I will not use a stale worker result.' },
2264
+ ]);
2265
+ probeScripts.set('lite-model', [
2266
+ {
2267
+ kind: 'tool',
2268
+ name: HIERARCHY_DISPATCH_TOOL,
2269
+ args: { username: workerUsername, question: 'Read first.txt and second.txt.' },
2270
+ },
2271
+ { kind: 'answer', text: 'The specialist could not verify a worker result.' },
2272
+ ]);
2273
+ probeScripts.set('worker-lite', [
2274
+ { kind: 'tool', name: 'worker_read_tool', args: { path: 'fixture.txt' } },
2275
+ { kind: 'tool', name: 'worker_read_tool', args: { path: 'second.txt' } },
2276
+ { kind: 'answer', text: 'The worker saw the profile change before the second read.' },
2277
+ ]);
2278
+ afterWorkerInvoke = async () => {
2279
+ afterWorkerInvoke = undefined;
2280
+ await workerBinding.update({ harnessTag: deniedProfile.profile.tag });
2281
+ };
2282
+
2283
+ try {
2284
+ const response = await adminAgent.resource('aiConversations').sendMessages({
2285
+ values: {
2286
+ sessionId,
2287
+ aiEmployee: leaderUsername,
2288
+ model: { llmService: 'mock-root', model: 'strong-model' },
2289
+ messages: [{ role: 'user', content: { type: 'text', content: 'Read a file using the worker.' } }],
2290
+ stream: false,
2291
+ },
2292
+ });
2293
+
2294
+ expect(response.status).toBe(200);
2295
+ expect(workerInvocations).toEqual([{ path: 'fixture.txt' }]);
2296
+ const children = await app.db.getRepository('aiConversations').find({
2297
+ filter: { userId: adminId, from: 'sub-agent', aiEmployeeUsername: workerUsername },
2298
+ });
2299
+ const child = children.find((item) => recordOrEmpty(item.get('options')).hierarchyRootSessionId === sessionId);
2300
+ if (!child) throw new Error('The worker conversation was not persisted.');
2301
+ const toolRows = await app.db.getRepository('aiToolMessages').find({
2302
+ filter: { sessionId: child.get('sessionId'), toolName: 'worker_read_tool' },
2303
+ sort: ['id'],
2304
+ });
2305
+ expect(toolRows).toHaveLength(2);
2306
+ expect(toolRows[0].get('status')).toBe('success');
2307
+ expect(toolRows[1].get('status')).not.toBe('success');
2308
+ const journal = await app.db.getRepository('agentHierarchyInvocations').findOne({
2309
+ filter: { rootSessionId: sessionId, employeeUsername: workerUsername },
2310
+ });
2311
+ expect(journal?.get('status')).toBe('uncertain');
2312
+ expect(JSON.stringify(providerInputs.get('strong-model')?.[2] ?? [])).not.toContain(workerEvidence);
2313
+ } finally {
2314
+ afterWorkerInvoke = undefined;
2315
+ await workerBinding.update({ harnessTag: originalTag });
2316
+ }
2317
+ });
2318
+ });