plugin-agent-orchestrator 1.2.0 → 1.2.2

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 (223) hide show
  1. package/LICENSE +201 -0
  2. package/dist/client/{117.2e4cb0477da3db1f.js → 117.6c69b6a87751dd18.js} +1 -1
  3. package/dist/client/{253.93deb9e0192e76a5.js → 253.52f62e1bc0e9520a.js} +1 -1
  4. package/dist/client/{404.498d2d9516dd1dce.js → 404.86593f98c9768ed5.js} +1 -1
  5. package/dist/client/{627.fdd60bcc0f3a9cf6.js → 453.fa2d169576262213.js} +1 -1
  6. package/dist/client/{53.774ff07505d521fa.js → 53.567db3ae078650c6.js} +1 -1
  7. package/dist/client/{619.e342b0fa467d39ca.js → 619.01713281e5e951d3.js} +1 -1
  8. package/dist/client/652.69da1598312b3a3f.js +10 -0
  9. package/dist/client/773.648965568ff476f9.js +10 -0
  10. package/dist/client/{981.e0546ffc34afedcd.js → 981.37e7aeecdb1ef6fa.js} +1 -1
  11. package/dist/client/{993.5d04b510835ab0d2.js → 993.ac89f3852990918d.js} +1 -1
  12. package/dist/client/index.js +1 -1
  13. package/dist/client-v2/{117.ccf43ae8631f7d74.js → 117.c982d79ff68738f5.js} +1 -1
  14. package/dist/client-v2/{214.cdf76752053a8990.js → 214.94c4257bf2838577.js} +1 -1
  15. package/dist/client-v2/{253.1198df22f5baf304.js → 253.8e19956d2a44dfb8.js} +1 -1
  16. package/dist/client-v2/{264.78887ff88f969467.js → 264.80e8e358c8c6c2e5.js} +1 -1
  17. package/dist/client-v2/{404.9ba964c28a151c81.js → 404.ab032b79c95dab6f.js} +1 -1
  18. package/dist/client-v2/{41.b28cf7a675a603d1.js → 41.cd5610fcf7446127.js} +1 -1
  19. package/dist/client-v2/{627.e16f4a0dd596c3e6.js → 453.42c6d70628d56cc2.js} +1 -1
  20. package/dist/client-v2/{53.282081f97e4308c6.js → 53.37c08089a648f89a.js} +1 -1
  21. package/dist/client-v2/{619.8c03913873785fb6.js → 619.6e9618550101e819.js} +1 -1
  22. package/dist/client-v2/652.eeba4e0c38367321.js +10 -0
  23. package/dist/client-v2/{70.9166ed70906d041f.js → 70.332698e53eb59677.js} +1 -1
  24. package/dist/client-v2/773.4de2ba5acb07318c.js +10 -0
  25. package/dist/client-v2/981.76060f466e6f7c11.js +10 -0
  26. package/dist/client-v2/{993.ca5b28f1e2b4c1ef.js → 993.f8cdb5172566ce75.js} +1 -1
  27. package/dist/client-v2/index.js +1 -1
  28. package/dist/externalVersion.js +4 -1
  29. package/dist/locale/en-US.json +80 -1
  30. package/dist/locale/vi-VN.json +5 -1
  31. package/dist/locale/zh-CN.json +80 -1
  32. package/dist/node_modules/acorn/LICENSE +21 -0
  33. package/dist/node_modules/acorn/bin/acorn +4 -0
  34. package/dist/node_modules/acorn/dist/acorn.d.mts +857 -0
  35. package/dist/node_modules/acorn/dist/acorn.d.ts +857 -0
  36. package/dist/node_modules/acorn/dist/acorn.js +1 -0
  37. package/dist/node_modules/acorn/dist/bin.js +90 -0
  38. package/dist/node_modules/acorn/package.json +1 -0
  39. package/dist/node_modules/acorn-walk/LICENSE +21 -0
  40. package/dist/node_modules/acorn-walk/dist/walk.d.mts +177 -0
  41. package/dist/node_modules/acorn-walk/dist/walk.d.ts +177 -0
  42. package/dist/node_modules/acorn-walk/dist/walk.js +1 -0
  43. package/dist/node_modules/acorn-walk/node_modules/.bin/acorn +15 -0
  44. package/dist/node_modules/acorn-walk/node_modules/.bin/acorn.cmd +7 -0
  45. package/dist/node_modules/acorn-walk/node_modules/acorn/bin/acorn +4 -0
  46. package/dist/node_modules/acorn-walk/node_modules/acorn/dist/acorn.d.mts +866 -0
  47. package/dist/node_modules/acorn-walk/node_modules/acorn/dist/acorn.d.ts +866 -0
  48. package/dist/node_modules/acorn-walk/node_modules/acorn/dist/acorn.js +6174 -0
  49. package/dist/node_modules/acorn-walk/node_modules/acorn/dist/bin.js +90 -0
  50. package/dist/node_modules/acorn-walk/node_modules/acorn/package.json +50 -0
  51. package/dist/node_modules/acorn-walk/package.json +1 -0
  52. package/dist/node_modules/adm-zip/package.json +1 -1
  53. package/dist/node_modules/ajv/package.json +1 -1
  54. package/dist/node_modules/zod/package.json +1 -1
  55. package/dist/server/collections/agent-auto-approval-checkpoints.js +47 -0
  56. package/dist/server/collections/agent-execution-spans.js +3 -3
  57. package/dist/server/collections/agent-hierarchy-invocations.js +59 -0
  58. package/dist/server/collections/agent-routing-graph-locks.js +40 -0
  59. package/dist/server/collections/agent-session-auto-approvals.js +45 -0
  60. package/dist/server/collections/orchestrator-config.js +17 -0
  61. package/dist/server/migrations/20261119000000-widen-native-employee-identifiers.js +59 -0
  62. package/dist/server/plugin.js +80 -12
  63. package/dist/server/resources/agent-auto-approval.js +80 -0
  64. package/dist/server/resources/hierarchical-routing.js +60 -0
  65. package/dist/server/services/AutoApprovalCheckpoint.js +133 -0
  66. package/dist/server/services/CodeValidator.js +8 -4
  67. package/dist/server/services/GovernanceAdmission.js +60 -0
  68. package/dist/server/services/HarnessCompiler.js +3 -0
  69. package/dist/server/services/HarnessSchema.js +13 -1
  70. package/dist/server/services/HierarchicalAgentRuntime.js +925 -0
  71. package/dist/server/services/HierarchyEnrollmentGuard.js +216 -0
  72. package/dist/server/services/HierarchyInvocationJournal.js +157 -0
  73. package/dist/server/services/HierarchyRequestCancellation.js +150 -0
  74. package/dist/server/services/LoopRunRepository.js +1 -1
  75. package/dist/server/services/LoopRunStateMachine.js +2 -2
  76. package/dist/server/services/LoopWorkerService.js +7 -7
  77. package/dist/server/services/ParallelInterruptActionsPatch.js +132 -0
  78. package/dist/server/services/PluginAiRuntimeAdapter.js +107 -9
  79. package/dist/server/services/RoutingBindingRepository.js +156 -0
  80. package/dist/server/services/RoutingBindingValidation.js +161 -0
  81. package/dist/server/services/SandboxRunner.js +19 -0
  82. package/dist/server/services/SessionAutoApproval.js +173 -0
  83. package/dist/server/services/VerificationService.js +2 -2
  84. package/dist/server/skill-hub/plugin.js +17 -0
  85. package/dist/server/skill-hub/services/RegistrySkillInstallationService.js +2 -2
  86. package/dist/server/skill-hub/services/registry-node-package.js +191 -0
  87. package/dist/server/skill-hub/tasks/SkillExecutionTask.js +21 -6
  88. package/dist/server/tools/skill-execute.js +1 -0
  89. package/dist/server/utils/ensure-indexes.js +1 -0
  90. package/package.json +5 -2
  91. package/src/client/SkillPages.tsx +1 -8
  92. package/src/client/__tests__/embedded-settings.test.tsx +1 -8
  93. package/src/client/plugin.tsx +3 -8
  94. package/src/client/skill-hub/tools/InteractionSchemasProvider.tsx +21 -6
  95. package/src/client/skill-hub/tools/SkillHubCard.tsx +22 -16
  96. package/src/client/skill-hub/tools/__tests__/skill-hub-card.test.tsx +255 -0
  97. package/src/client/skill-hub/tools/registerSkillLoopCards.ts +12 -3
  98. package/src/client-v2/__tests__/embedded-settings.test.tsx +20 -11
  99. package/src/client-v2/__tests__/hierarchical-routing-settings.test.tsx +350 -0
  100. package/src/client-v2/auto-approval/AutoApprovalBridge.tsx +513 -0
  101. package/src/client-v2/auto-approval/AutoApprovalProvider.tsx +399 -0
  102. package/src/client-v2/auto-approval/__tests__/session-auto-approval.test.tsx +1676 -0
  103. package/src/client-v2/components/AgentBindingsTab.tsx +275 -3
  104. package/src/client-v2/components/AgentRunsTab.tsx +1 -8
  105. package/src/client-v2/components/EmployeeGovernanceTab.tsx +1 -8
  106. package/src/client-v2/components/HarnessProfilesTab.tsx +4 -8
  107. package/src/client-v2/components/HarnessSettingsForm.tsx +221 -0
  108. package/src/client-v2/components/UsageGovernanceTab.tsx +1 -8
  109. package/src/client-v2/pages/AgentBindingsPage.tsx +1 -8
  110. package/src/client-v2/pages/ApprovalsPage.tsx +1 -8
  111. package/src/client-v2/pages/EmployeeGovernancePage.tsx +1 -8
  112. package/src/client-v2/pages/ExecutionHistoryPage.tsx +1 -8
  113. package/src/client-v2/pages/HarnessProfilesPage.tsx +1 -8
  114. package/src/client-v2/pages/KnowledgeAccessPage.tsx +1 -8
  115. package/src/client-v2/pages/LoopSettingsPage.tsx +1 -8
  116. package/src/client-v2/pages/MemoryInspectorPage.tsx +1 -8
  117. package/src/client-v2/pages/RetrievalTracePage.tsx +1 -8
  118. package/src/client-v2/pages/RulesPage.tsx +1 -8
  119. package/src/client-v2/pages/SkillDefinitionsPage.tsx +1 -8
  120. package/src/client-v2/pages/SkillMetricsPage.tsx +1 -8
  121. package/src/client-v2/pages/TracingPage.tsx +1 -8
  122. package/src/client-v2/pages/UsageGovernancePage.tsx +1 -8
  123. package/src/client-v2/plugin.tsx +3 -8
  124. package/src/client-v2/skill-hub/tools/__tests__/interactions.test.ts +17 -1
  125. package/src/client-v2/skill-hub/tools/interactions.ts +12 -3
  126. package/src/locale/en-US.json +80 -1
  127. package/src/locale/vi-VN.json +5 -1
  128. package/src/locale/zh-CN.json +80 -1
  129. package/src/server/__tests__/agent-governance.integration.test.ts +1 -8
  130. package/src/server/__tests__/agent-monitor-acl.integration.test.ts +1 -8
  131. package/src/server/__tests__/agent-usage-report.integration.test.ts +1 -8
  132. package/src/server/__tests__/auto-approval-checkpoint.integration.test.ts +295 -0
  133. package/src/server/__tests__/harness-capabilities.test.ts +1 -8
  134. package/src/server/__tests__/harness-compiler.test.ts +64 -0
  135. package/src/server/__tests__/harness-tool-plan.test.ts +1 -8
  136. package/src/server/__tests__/hierarchical-routing.integration.test.ts +2318 -0
  137. package/src/server/__tests__/hierarchy-invocation-journal.integration.test.ts +119 -0
  138. package/src/server/__tests__/loop-approval-decision.test.ts +59 -12
  139. package/src/server/__tests__/loop-budget-service.test.ts +1 -8
  140. package/src/server/__tests__/loop-run-repository.test.ts +1 -8
  141. package/src/server/__tests__/loop-trigger-service.test.ts +1 -8
  142. package/src/server/__tests__/loop-worker-claim.test.ts +46 -9
  143. package/src/server/__tests__/loop-worker-execution.test.ts +1 -8
  144. package/src/server/__tests__/native-agent-monitor-sync.test.ts +1 -8
  145. package/src/server/__tests__/native-hierarchy-probe.integration.test.ts +527 -0
  146. package/src/server/__tests__/native-sub-agent-observer.test.ts +1 -8
  147. package/src/server/__tests__/native-usage-attribution.integration.test.ts +1 -8
  148. package/src/server/__tests__/parallel-interrupt-actions.test.ts +342 -0
  149. package/src/server/__tests__/plugin-ai-runtime-adapter.test.ts +403 -0
  150. package/src/server/__tests__/registry-node-package.test.ts +299 -0
  151. package/src/server/__tests__/routing-binding-graph.integration.test.ts +217 -0
  152. package/src/server/__tests__/routing-binding-validation.test.ts +256 -0
  153. package/src/server/__tests__/session-auto-approval.integration.test.ts +329 -0
  154. package/src/server/__tests__/skill-execute.test.ts +11 -0
  155. package/src/server/__tests__/skill-review-guard.test.ts +171 -0
  156. package/src/server/__tests__/token-tracker.test.ts +1 -8
  157. package/src/server/__tests__/tracing-retention-policy.test.ts +1 -8
  158. package/src/server/__tests__/usage-ledger.integration.test.ts +1 -8
  159. package/src/server/collections/agent-auto-approval-checkpoints.ts +18 -0
  160. package/src/server/collections/agent-execution-spans.ts +4 -11
  161. package/src/server/collections/agent-governance-audit-events.ts +1 -8
  162. package/src/server/collections/agent-governance-policies.ts +1 -8
  163. package/src/server/collections/agent-governance-policy-versions.ts +1 -8
  164. package/src/server/collections/agent-governance-prompt-bindings.ts +1 -8
  165. package/src/server/collections/agent-hierarchy-invocations.ts +30 -0
  166. package/src/server/collections/agent-loop-runs.ts +1 -8
  167. package/src/server/collections/agent-routing-graph-locks.ts +11 -0
  168. package/src/server/collections/agent-session-auto-approvals.ts +16 -0
  169. package/src/server/collections/orchestrator-config.ts +26 -0
  170. package/src/server/migrations/20261110000000-add-usage-pricing-snapshots.ts +1 -8
  171. package/src/server/migrations/20261110010000-add-usage-department-attribution.ts +1 -8
  172. package/src/server/migrations/20261119000000-widen-native-employee-identifiers.ts +37 -0
  173. package/src/server/plugin.ts +72 -8
  174. package/src/server/resources/agent-auto-approval.ts +51 -0
  175. package/src/server/resources/agent-governance.ts +1 -8
  176. package/src/server/resources/agent-harness-profile.ts +1 -8
  177. package/src/server/resources/agent-monitor.ts +1 -8
  178. package/src/server/resources/agent-usage.ts +1 -8
  179. package/src/server/resources/hierarchical-routing.ts +39 -0
  180. package/src/server/resources/native-monitor-format.ts +1 -8
  181. package/src/server/resources/tracing.ts +1 -8
  182. package/src/server/services/AgentGovernanceService.ts +1 -8
  183. package/src/server/services/AutoApprovalCheckpoint.ts +140 -0
  184. package/src/server/services/CodeValidator.ts +23 -4
  185. package/src/server/services/DepartmentAttribution.ts +1 -8
  186. package/src/server/services/ExecutionSpanService.ts +1 -8
  187. package/src/server/services/GovernanceAdmission.ts +83 -8
  188. package/src/server/services/HarnessCapabilities.ts +1 -8
  189. package/src/server/services/HarnessCompiler.ts +12 -0
  190. package/src/server/services/HarnessSchema.ts +30 -0
  191. package/src/server/services/HierarchicalAgentRuntime.ts +1052 -0
  192. package/src/server/services/HierarchyEnrollmentGuard.ts +211 -0
  193. package/src/server/services/HierarchyInvocationJournal.ts +172 -0
  194. package/src/server/services/HierarchyRequestCancellation.ts +132 -0
  195. package/src/server/services/LoopBudgetService.ts +1 -8
  196. package/src/server/services/LoopRunRepository.ts +2 -9
  197. package/src/server/services/LoopRunStateMachine.ts +3 -10
  198. package/src/server/services/LoopTriggerService.ts +1 -8
  199. package/src/server/services/LoopWorkerService.ts +8 -19
  200. package/src/server/services/ManagedPromptProtection.ts +1 -8
  201. package/src/server/services/NativeAgentMonitorSyncService.ts +1 -8
  202. package/src/server/services/NativeSubAgentObserver.ts +1 -8
  203. package/src/server/services/NativeUsageAttribution.ts +1 -8
  204. package/src/server/services/ParallelInterruptActionsPatch.ts +164 -0
  205. package/src/server/services/PluginAiRuntimeAdapter.ts +140 -9
  206. package/src/server/services/RoutingBindingRepository.ts +146 -0
  207. package/src/server/services/RoutingBindingValidation.ts +161 -0
  208. package/src/server/services/SandboxRunner.ts +35 -1
  209. package/src/server/services/SessionAutoApproval.ts +167 -0
  210. package/src/server/services/TokenTracker.ts +1 -8
  211. package/src/server/services/TracingRetentionPolicy.ts +1 -8
  212. package/src/server/services/VerificationService.ts +3 -10
  213. package/src/server/skill-hub/plugin.ts +40 -0
  214. package/src/server/skill-hub/services/RegistrySkillInstallationService.ts +11 -1
  215. package/src/server/skill-hub/services/registry-node-package.ts +191 -0
  216. package/src/server/skill-hub/tasks/SkillExecutionTask.ts +34 -5
  217. package/src/server/tools/skill-execute.ts +10 -0
  218. package/src/server/utils/ensure-indexes.ts +2 -8
  219. package/dist/client/418.6f01da17774a5a25.js +0 -10
  220. package/dist/client/652.477e21bfff67bc1c.js +0 -10
  221. package/dist/client-v2/418.55b6b28cda8bb5f3.js +0 -10
  222. package/dist/client-v2/652.1a48364774d5383a.js +0 -10
  223. package/dist/client-v2/981.a81521f0296c7db8.js +0 -10
@@ -0,0 +1,527 @@
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 { AIMessage, BaseMessage, HumanMessage, ToolMessage } from '@langchain/core/messages';
11
+ import { FakeChatModel } from '@langchain/core/utils/testing';
12
+ import type { Model } from '@nocobase/database';
13
+ import { createMockServer, type MockServer } from '@nocobase/test';
14
+ import { LLMProvider, type LLMProviderOptions } from '@nocobase/plugin-ai/server';
15
+ import type { ToolsOptions } from '@nocobase/ai';
16
+ import { randomUUID } from 'node:crypto';
17
+ import { afterAll, beforeAll, describe, expect, it, vi } from 'vitest';
18
+ import { z } from 'zod';
19
+
20
+ const nativeModel = { llmService: 'native-probe-service', model: 'one-native-model' };
21
+ const readToolName = 'native_hierarchy_probe_read';
22
+ const allowReadToolName = 'native_hierarchy_probe_allow_read';
23
+ let nativeProbeModelStates: Map<string, SessionModelState> | undefined;
24
+
25
+ type ModelRef = typeof nativeModel;
26
+ type ModelRequest = { sessionId: string | undefined; llmService: string; model: string };
27
+ type ConversationTask =
28
+ | 'ALLOW_READ_ONE_TASK'
29
+ | 'ALLOW_READ_TWO_TASK'
30
+ | 'DIRECT_TASK'
31
+ | 'ROOT_TASK'
32
+ | 'SPECIALIST_TASK'
33
+ | 'WORKER_TASK'
34
+ | 'unknown';
35
+
36
+ type SessionModelState = {
37
+ sessionId: string;
38
+ calls: number;
39
+ bindings: Set<string>;
40
+ toolResultSnapshots: string[][];
41
+ };
42
+
43
+ type NativeSubAgentConversation = { sessionId?: string; status?: string; toolCallId?: string };
44
+ type NativeAIMessageMetadata = { subAgentConversations?: NativeSubAgentConversation[] };
45
+
46
+ type ProbeAIPlugin = {
47
+ aiManager: {
48
+ getLLMService: (
49
+ options: ModelRef,
50
+ requestContext?: { sessionId?: string },
51
+ ) => Promise<{
52
+ provider: LLMProvider;
53
+ model: string;
54
+ service: { provider: string; get: (name: string) => string | undefined };
55
+ }>;
56
+ };
57
+ aiEmployeesManager: { resolveModel: (employee: Model, model?: ModelRef | null) => Promise<ModelRef> };
58
+ };
59
+
60
+ type ProbeHost = MockServer & {
61
+ aiManager: {
62
+ toolsManager: {
63
+ getTools: (name: string) => Promise<ToolsOptions>;
64
+ registerTools: (options: ToolsOptions | ToolsOptions[]) => void;
65
+ };
66
+ };
67
+ };
68
+
69
+ function messageText(message: BaseMessage): string {
70
+ if (typeof message.content === 'string') return message.content;
71
+ if (!Array.isArray(message.content)) return '';
72
+ return message.content
73
+ .map((block) => {
74
+ if (block && typeof block === 'object' && 'text' in block && typeof block.text === 'string') {
75
+ return block.text;
76
+ }
77
+ return '';
78
+ })
79
+ .join('');
80
+ }
81
+
82
+ function identifyTask(messages: BaseMessage[]): ConversationTask {
83
+ const text = messages.filter(HumanMessage.isInstance).map(messageText).join('\n');
84
+ if (text.includes('ALLOW_READ_TWO_TASK')) return 'ALLOW_READ_TWO_TASK';
85
+ if (text.includes('ALLOW_READ_ONE_TASK')) return 'ALLOW_READ_ONE_TASK';
86
+ if (text.includes('DIRECT_TASK')) return 'DIRECT_TASK';
87
+ if (text.includes('ROOT_TASK')) return 'ROOT_TASK';
88
+ if (text.includes('SPECIALIST_TASK')) return 'SPECIALIST_TASK';
89
+ if (text.includes('WORKER_TASK')) return 'WORKER_TASK';
90
+ return 'unknown';
91
+ }
92
+
93
+ class NativeHierarchyProbeModel extends FakeChatModel {
94
+ constructor(private readonly state: SessionModelState) {
95
+ super({});
96
+ }
97
+
98
+ bindTools(tools: unknown[]) {
99
+ for (const tool of tools) {
100
+ if (tool && typeof tool === 'object' && 'name' in tool && typeof tool.name === 'string') {
101
+ this.state.bindings.add(tool.name);
102
+ }
103
+ }
104
+ return this;
105
+ }
106
+
107
+ async _generate(messages: BaseMessage[]) {
108
+ const task = identifyTask(messages);
109
+ const toolMessages = messages.filter(ToolMessage.isInstance);
110
+ const hasToolResult = toolMessages.length > 0;
111
+ this.state.calls += 1;
112
+ this.state.toolResultSnapshots.push(
113
+ toolMessages.map((message) =>
114
+ typeof message.content === 'string' ? message.content : JSON.stringify(message.content) ?? '',
115
+ ),
116
+ );
117
+
118
+ let message: AIMessage;
119
+ if (task === 'ALLOW_READ_ONE_TASK' || task === 'ALLOW_READ_TWO_TASK') {
120
+ const readCount = task === 'ALLOW_READ_ONE_TASK' ? 1 : 2;
121
+ if (toolMessages.length < readCount) {
122
+ const nextRead = toolMessages.length + 1;
123
+ message = new AIMessage({
124
+ content: '',
125
+ tool_calls: [
126
+ {
127
+ id: `native-allow-read-${this.state.sessionId}-${nextRead}`,
128
+ name: allowReadToolName,
129
+ args: { key: `fixture-${nextRead}` },
130
+ type: 'tool_call',
131
+ },
132
+ ],
133
+ });
134
+ } else {
135
+ message = new AIMessage(`${task} completed`);
136
+ }
137
+ } else if (task === 'ROOT_TASK' && !hasToolResult) {
138
+ message = new AIMessage({
139
+ content: '',
140
+ tool_calls: [
141
+ {
142
+ id: 'native-root-dispatch',
143
+ name: 'dispatch-sub-agent-task',
144
+ args: { username: NativeHierarchyProbe.specialistUsername, question: 'SPECIALIST_TASK' },
145
+ type: 'tool_call',
146
+ },
147
+ ],
148
+ });
149
+ } else if (task === 'SPECIALIST_TASK' && !hasToolResult) {
150
+ message = new AIMessage({
151
+ content: '',
152
+ tool_calls: [
153
+ {
154
+ id: 'native-specialist-dispatch',
155
+ name: 'dispatch-sub-agent-task',
156
+ args: { username: NativeHierarchyProbe.workerUsername, question: 'WORKER_TASK' },
157
+ type: 'tool_call',
158
+ },
159
+ ],
160
+ });
161
+ } else if (task === 'WORKER_TASK' && !hasToolResult) {
162
+ message = new AIMessage({
163
+ content: '',
164
+ tool_calls: [
165
+ {
166
+ id: 'native-worker-ask',
167
+ name: readToolName,
168
+ args: { key: 'fixture-value' },
169
+ type: 'tool_call',
170
+ },
171
+ ],
172
+ });
173
+ } else {
174
+ message = new AIMessage(`${task} completed`);
175
+ }
176
+
177
+ return { generations: [{ text: messageText(message), message }] };
178
+ }
179
+ }
180
+
181
+ class NativeHierarchyProbeProvider extends LLMProvider {
182
+ createModel() {
183
+ const sessionId = this.requestContext.sessionId ?? 'missing-session-id';
184
+ if (!nativeProbeModelStates) throw new Error('Native hierarchy model fixture state is unavailable.');
185
+ const state = nativeProbeModelStates.get(sessionId) ?? {
186
+ sessionId,
187
+ calls: 0,
188
+ bindings: new Set<string>(),
189
+ toolResultSnapshots: [],
190
+ };
191
+ nativeProbeModelStates.set(sessionId, state);
192
+ return new NativeHierarchyProbeModel(state);
193
+ }
194
+ }
195
+
196
+ class NativeHierarchyProbe {
197
+ static specialistUsername = '';
198
+ static workerUsername = '';
199
+
200
+ app: MockServer;
201
+ rootAgent: ReturnType<MockServer['agent']>;
202
+ rootUserId = 0;
203
+ rootUsername: string;
204
+ rootSessionId: string;
205
+ modelRequests: ModelRequest[] = [];
206
+ modelStates = new Map<string, SessionModelState>();
207
+ readInvocations: Array<{ key: string }> = [];
208
+ allowReadInvocations: Array<{ key: string }> = [];
209
+
210
+ private constructor(
211
+ app: MockServer,
212
+ rootAgent: ReturnType<MockServer['agent']>,
213
+ rootUserId: number,
214
+ rootUsername: string,
215
+ rootSessionId: string,
216
+ ) {
217
+ this.app = app;
218
+ this.rootAgent = rootAgent;
219
+ this.rootUserId = rootUserId;
220
+ this.rootUsername = rootUsername;
221
+ this.rootSessionId = rootSessionId;
222
+ }
223
+
224
+ static async create() {
225
+ const suffix = `${process.pid}-${Date.now()}`;
226
+ const app = await createMockServer({
227
+ plugins: ['nocobase'],
228
+ name: `native-hierarchy-probe-${suffix}`,
229
+ acl: true,
230
+ skipSupervisor: true,
231
+ });
232
+ const root = await app.db.getRepository('users').findOne({ filter: { 'roles.name': 'root' } });
233
+ if (!root) throw new Error('Mock server did not seed a root user.');
234
+ const rootUsername = `native-probe-root-${suffix}`;
235
+ const specialistUsername = `native-probe-specialist-${suffix}`;
236
+ const workerUsername = `native-probe-worker-${suffix}`;
237
+ NativeHierarchyProbe.specialistUsername = specialistUsername;
238
+ NativeHierarchyProbe.workerUsername = workerUsername;
239
+
240
+ const employees = app.db.getRepository('aiEmployees');
241
+ const employeeSettings = (username: string, dispatch: boolean) => ({
242
+ username,
243
+ nickname: username,
244
+ about: 'Deterministic native hierarchy probe fixture.',
245
+ enabled: true,
246
+ builtIn: false,
247
+ category: 'business',
248
+ deprecated: false,
249
+ modelSettings: nativeModel,
250
+ chatSettings: { enableSkills: false, enableTools: true, systemPromptMode: 'none' },
251
+ skillSettings: {
252
+ tools: dispatch ? [{ name: 'dispatch-sub-agent-task', autoCall: true }] : [],
253
+ },
254
+ });
255
+ await employees.create({ values: employeeSettings(rootUsername, true) });
256
+ await employees.create({ values: employeeSettings(specialistUsername, true) });
257
+ await employees.create({ values: employeeSettings(workerUsername, false) });
258
+
259
+ const rootSessionId = randomUUID();
260
+ await app.db.getRepository('aiConversations').create({
261
+ values: {
262
+ sessionId: rootSessionId,
263
+ userId: Number(root.id),
264
+ aiEmployeeUsername: rootUsername,
265
+ thread: 1,
266
+ title: 'Native hierarchy probe',
267
+ },
268
+ });
269
+
270
+ const probe = new NativeHierarchyProbe(
271
+ app,
272
+ await app.agent().login(root),
273
+ Number(root.id),
274
+ rootUsername,
275
+ rootSessionId,
276
+ );
277
+ nativeProbeModelStates = probe.modelStates;
278
+ const ai = app.pm.get('ai') as unknown as ProbeAIPlugin;
279
+ const toolsManager = (app as ProbeHost).aiManager.toolsManager;
280
+ toolsManager.registerTools({
281
+ scope: 'GENERAL',
282
+ defaultPermission: 'ASK',
283
+ definition: {
284
+ name: readToolName,
285
+ description: 'Read one deterministic fixture value.',
286
+ schema: z.object({ key: z.string() }),
287
+ },
288
+ invoke: async (_ctx, args: { key: string }) => {
289
+ probe.readInvocations.push(args);
290
+ return { key: args.key, value: 'fixture-value' };
291
+ },
292
+ });
293
+ toolsManager.registerTools({
294
+ scope: 'GENERAL',
295
+ defaultPermission: 'ALLOW',
296
+ definition: {
297
+ name: allowReadToolName,
298
+ description: 'Read one deterministic fixture value without approval.',
299
+ schema: z.object({ key: z.string() }),
300
+ },
301
+ invoke: async (_ctx, args: { key: string }) => {
302
+ probe.allowReadInvocations.push(args);
303
+ return { key: args.key, value: `native-sentinel:${args.key}` };
304
+ },
305
+ });
306
+
307
+ vi.spyOn(ai.aiEmployeesManager, 'resolveModel').mockResolvedValue(nativeModel);
308
+ vi.spyOn(ai.aiManager, 'getLLMService').mockImplementation(async (options, requestContext) => {
309
+ probe.modelRequests.push({
310
+ sessionId: requestContext?.sessionId,
311
+ llmService: options.llmService,
312
+ model: options.model,
313
+ });
314
+ return {
315
+ provider: new NativeHierarchyProbeProvider({ app, modelOptions: options, requestContext }),
316
+ model: options.model,
317
+ service: {
318
+ provider: 'native-hierarchy-probe',
319
+ get: (name) => (name === 'name' ? options.llmService : undefined),
320
+ },
321
+ };
322
+ });
323
+
324
+ return probe;
325
+ }
326
+
327
+ async sendRootMessage() {
328
+ return this.sendMessage(this.rootSessionId, 'ROOT_TASK');
329
+ }
330
+
331
+ async createRootSession() {
332
+ const sessionId = randomUUID();
333
+ await this.app.db.getRepository('aiConversations').create({
334
+ values: {
335
+ sessionId,
336
+ userId: this.rootUserId,
337
+ aiEmployeeUsername: this.rootUsername,
338
+ thread: 1,
339
+ title: 'Native direct baseline probe',
340
+ },
341
+ });
342
+ return sessionId;
343
+ }
344
+
345
+ async sendMessage(sessionId: string, task: string) {
346
+ return this.rootAgent.resource('aiConversations').sendMessages({
347
+ values: {
348
+ sessionId,
349
+ aiEmployee: this.rootUsername,
350
+ model: nativeModel,
351
+ messages: [{ role: 'user', content: { type: 'text', content: task } }],
352
+ stream: false,
353
+ },
354
+ });
355
+ }
356
+ }
357
+
358
+ describe('native AIEmployee hierarchy baseline probe', () => {
359
+ let probe: NativeHierarchyProbe | undefined;
360
+
361
+ beforeAll(async () => {
362
+ probe = await NativeHierarchyProbe.create();
363
+ });
364
+
365
+ afterAll(async () => {
366
+ vi.restoreAllMocks();
367
+ await probe?.app.destroy();
368
+ });
369
+
370
+ it('dispatches root → specialist → worker on one model and leaves the worker ASK tool unexecuted', async () => {
371
+ if (!probe) throw new Error('Native hierarchy probe fixture was not initialized.');
372
+
373
+ const toolsManager = (probe.app as ProbeHost).aiManager.toolsManager;
374
+ const dispatchTool = await toolsManager.getTools('dispatch-sub-agent-task');
375
+ const readTool = await toolsManager.getTools(readToolName);
376
+ expect(readTool).toMatchObject({ scope: 'GENERAL', defaultPermission: 'ASK' });
377
+ const response = await probe.sendRootMessage();
378
+
379
+ expect(response.status).toBe(200);
380
+ expect(probe.modelRequests).toHaveLength(3);
381
+ expect(probe.modelRequests.map(({ llmService, model }) => ({ llmService, model }))).toEqual(
382
+ probe.modelRequests.map(() => nativeModel),
383
+ );
384
+
385
+ const conversations = await probe.app.db.getRepository('aiConversations').find({
386
+ filter: { userId: probe.rootUserId },
387
+ sort: ['createdAt'],
388
+ });
389
+ const childSessions = conversations
390
+ .filter((conversation) => conversation.get('from') === 'sub-agent')
391
+ .map((conversation) => ({
392
+ sessionId: String(conversation.get('sessionId')),
393
+ username: String(conversation.get('aiEmployeeUsername')),
394
+ }));
395
+ const specialistSession = childSessions.find(
396
+ (session) => session.username === NativeHierarchyProbe.specialistUsername,
397
+ );
398
+ const workerSession = childSessions.find((session) => session.username === NativeHierarchyProbe.workerUsername);
399
+
400
+ expect(specialistSession).toBeDefined();
401
+ expect(workerSession).toBeDefined();
402
+ if (!specialistSession || !workerSession) throw new Error('Native dispatch did not create both child sessions.');
403
+ expect(probe.modelRequests.map((request) => request.sessionId)).toEqual(
404
+ expect.arrayContaining([probe.rootSessionId, specialistSession.sessionId, workerSession.sessionId]),
405
+ );
406
+ expect(probe.modelStates.get(probe.rootSessionId)?.calls).toBe(1);
407
+ expect(probe.modelStates.get(specialistSession.sessionId)?.calls).toBe(1);
408
+ expect(probe.modelStates.get(workerSession.sessionId)?.calls).toBe(1);
409
+ expect(probe.modelStates.get(probe.rootSessionId)?.bindings).toContain('dispatch-sub-agent-task');
410
+ expect(probe.modelStates.get(specialistSession.sessionId)?.bindings).toContain('dispatch-sub-agent-task');
411
+ expect(probe.modelStates.get(workerSession.sessionId)?.bindings).toContain(readToolName);
412
+ expect(probe.readInvocations).toEqual([]);
413
+
414
+ const workerAsk = await probe.app.db.getRepository('aiToolMessages').findOne({
415
+ filter: { sessionId: workerSession.sessionId, toolName: readToolName },
416
+ });
417
+ const rootDispatch = await probe.app.db.getRepository('aiToolMessages').findOne({
418
+ filter: { sessionId: probe.rootSessionId, toolName: 'dispatch-sub-agent-task' },
419
+ });
420
+ const specialistDispatch = await probe.app.db.getRepository('aiToolMessages').findOne({
421
+ filter: { sessionId: specialistSession.sessionId, toolName: 'dispatch-sub-agent-task' },
422
+ });
423
+ const rootDispatchMessage = rootDispatch
424
+ ? await probe.app.db.getRepository('aiMessages').findOne({
425
+ filter: { sessionId: probe.rootSessionId, messageId: rootDispatch.get('messageId') },
426
+ })
427
+ : null;
428
+ const specialistDispatchMessage = specialistDispatch
429
+ ? await probe.app.db.getRepository('aiMessages').findOne({
430
+ filter: { sessionId: specialistSession.sessionId, messageId: specialistDispatch.get('messageId') },
431
+ })
432
+ : null;
433
+ const rootMetadata = rootDispatchMessage?.get('metadata') as NativeAIMessageMetadata | undefined;
434
+ expect(workerAsk?.get('invokeStatus')).toBe('init');
435
+ expect(workerAsk?.get('auto')).toBe(false);
436
+ expect(workerAsk?.get('interruptAction')).toBeFalsy();
437
+ expect(dispatchTool).toMatchObject({ scope: 'SPECIFIED', defaultPermission: 'ALLOW' });
438
+ expect(rootDispatch?.get('invokeStatus')).toBe('pending');
439
+ expect(rootDispatch?.get('interruptAction')).toBeFalsy();
440
+ expect(rootMetadata?.subAgentConversations).toContainEqual(
441
+ expect.objectContaining({ sessionId: specialistSession.sessionId, status: 'pending' }),
442
+ );
443
+ expect(specialistDispatch?.get('invokeStatus')).toBe('pending');
444
+ expect(specialistDispatch?.get('interruptAction')).toBeFalsy();
445
+ expect(specialistDispatchMessage?.get('metadata')).not.toHaveProperty('subAgentConversations');
446
+ });
447
+
448
+ it('answers a direct root request with one model call and no child sessions', async () => {
449
+ if (!probe) throw new Error('Native hierarchy probe fixture was not initialized.');
450
+
451
+ const sessionId = await probe.createRootSession();
452
+ const existingChildSessions = await probe.app.db.getRepository('aiConversations').count({
453
+ filter: { userId: probe.rootUserId, from: 'sub-agent' },
454
+ });
455
+ const requestCount = probe.modelRequests.length;
456
+ const response = await probe.sendMessage(sessionId, 'DIRECT_TASK');
457
+
458
+ expect(response.status).toBe(200);
459
+ expect(probe.modelRequests).toHaveLength(requestCount + 1);
460
+ expect(probe.modelRequests.at(-1)).toMatchObject({
461
+ sessionId,
462
+ llmService: nativeModel.llmService,
463
+ model: nativeModel.model,
464
+ });
465
+ expect(probe.modelStates.get(sessionId)?.calls).toBe(1);
466
+ expect(probe.modelStates.get(sessionId)?.bindings).toContain('dispatch-sub-agent-task');
467
+ expect(
468
+ await probe.app.db.getRepository('aiConversations').count({
469
+ filter: { userId: probe.rootUserId, from: 'sub-agent' },
470
+ }),
471
+ ).toBe(existingChildSessions);
472
+ expect(await probe.app.db.getRepository('aiToolMessages').count({ filter: { sessionId } })).toBe(0);
473
+ });
474
+
475
+ it.each([
476
+ { task: 'ALLOW_READ_ONE_TASK', expectedReads: 1, expectedModelCalls: 2 },
477
+ { task: 'ALLOW_READ_TWO_TASK', expectedReads: 2, expectedModelCalls: 3 },
478
+ ])('runs $expectedReads ALLOW read(s) on the selected root model', async (scenario) => {
479
+ if (!probe) throw new Error('Native hierarchy probe fixture was not initialized.');
480
+
481
+ const toolsManager = (probe.app as ProbeHost).aiManager.toolsManager;
482
+ expect(await toolsManager.getTools(allowReadToolName)).toMatchObject({
483
+ scope: 'GENERAL',
484
+ defaultPermission: 'ALLOW',
485
+ });
486
+
487
+ const sessionId = await probe.createRootSession();
488
+ const requestCount = probe.modelRequests.length;
489
+ const invocationCount = probe.allowReadInvocations.length;
490
+ const childSessionCount = await probe.app.db.getRepository('aiConversations').count({
491
+ filter: { userId: probe.rootUserId, from: 'sub-agent' },
492
+ });
493
+ const response = await probe.sendMessage(sessionId, scenario.task);
494
+
495
+ expect(response.status).toBe(200);
496
+ expect(probe.modelRequests.slice(requestCount)).toEqual([
497
+ { sessionId, llmService: nativeModel.llmService, model: nativeModel.model },
498
+ ]);
499
+ expect(probe.modelStates.get(sessionId)?.calls).toBe(scenario.expectedModelCalls);
500
+ expect(probe.modelStates.get(sessionId)?.bindings).toContain(allowReadToolName);
501
+ expect(probe.allowReadInvocations.slice(invocationCount)).toEqual(
502
+ Array.from({ length: scenario.expectedReads }, (_value, index) => ({ key: `fixture-${index + 1}` })),
503
+ );
504
+ expect(probe.modelStates.get(sessionId)?.toolResultSnapshots.at(-1)).toEqual(
505
+ expect.arrayContaining(
506
+ Array.from({ length: scenario.expectedReads }, (_value, index) =>
507
+ expect.stringContaining(`native-sentinel:fixture-${index + 1}`),
508
+ ),
509
+ ),
510
+ );
511
+
512
+ const toolMessages = await probe.app.db.getRepository('aiToolMessages').find({
513
+ filter: { sessionId, toolName: allowReadToolName },
514
+ sort: ['id'],
515
+ });
516
+ expect(toolMessages).toHaveLength(scenario.expectedReads);
517
+ for (const toolMessage of toolMessages) {
518
+ expect(toolMessage.get('status')).toBe('success');
519
+ expect(['confirmed', 'done']).toContain(toolMessage.get('invokeStatus'));
520
+ }
521
+ expect(
522
+ await probe.app.db.getRepository('aiConversations').count({
523
+ filter: { userId: probe.rootUserId, from: 'sub-agent' },
524
+ }),
525
+ ).toBe(childSessionCount);
526
+ });
527
+ });
@@ -1,11 +1,4 @@
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
- */
1
+ // SPDX-License-Identifier: Apache-2.0
9
2
 
10
3
  import { describe, expect, it, vi } from 'vitest';
11
4
  import { AgentMemoryContextService } from '../services/AgentMemoryContextService';
@@ -1,11 +1,4 @@
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
- */
1
+ // SPDX-License-Identifier: Apache-2.0
9
2
 
10
3
  import { createMockServer, type MockServer } from '@nocobase/test';
11
4
  import type { Plugin } from '@nocobase/server';