plugin-agent-orchestrator 1.2.0 → 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 (220) 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 +55 -0
  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/PluginAiRuntimeAdapter.js +107 -9
  78. package/dist/server/services/RoutingBindingRepository.js +156 -0
  79. package/dist/server/services/RoutingBindingValidation.js +161 -0
  80. package/dist/server/services/SandboxRunner.js +19 -0
  81. package/dist/server/services/SessionAutoApproval.js +173 -0
  82. package/dist/server/services/VerificationService.js +2 -2
  83. package/dist/server/skill-hub/plugin.js +17 -0
  84. package/dist/server/skill-hub/services/RegistrySkillInstallationService.js +2 -2
  85. package/dist/server/skill-hub/services/registry-node-package.js +191 -0
  86. package/dist/server/skill-hub/tasks/SkillExecutionTask.js +21 -6
  87. package/dist/server/tools/skill-execute.js +1 -0
  88. package/dist/server/utils/ensure-indexes.js +1 -0
  89. package/package.json +5 -2
  90. package/src/client/SkillPages.tsx +1 -8
  91. package/src/client/__tests__/embedded-settings.test.tsx +1 -8
  92. package/src/client/plugin.tsx +3 -8
  93. package/src/client/skill-hub/tools/InteractionSchemasProvider.tsx +21 -6
  94. package/src/client/skill-hub/tools/SkillHubCard.tsx +22 -16
  95. package/src/client/skill-hub/tools/__tests__/skill-hub-card.test.tsx +255 -0
  96. package/src/client/skill-hub/tools/registerSkillLoopCards.ts +12 -3
  97. package/src/client-v2/__tests__/embedded-settings.test.tsx +20 -11
  98. package/src/client-v2/__tests__/hierarchical-routing-settings.test.tsx +350 -0
  99. package/src/client-v2/auto-approval/AutoApprovalBridge.tsx +513 -0
  100. package/src/client-v2/auto-approval/AutoApprovalProvider.tsx +399 -0
  101. package/src/client-v2/auto-approval/__tests__/session-auto-approval.test.tsx +1676 -0
  102. package/src/client-v2/components/AgentBindingsTab.tsx +275 -3
  103. package/src/client-v2/components/AgentRunsTab.tsx +1 -8
  104. package/src/client-v2/components/EmployeeGovernanceTab.tsx +1 -8
  105. package/src/client-v2/components/HarnessProfilesTab.tsx +4 -8
  106. package/src/client-v2/components/HarnessSettingsForm.tsx +221 -0
  107. package/src/client-v2/components/UsageGovernanceTab.tsx +1 -8
  108. package/src/client-v2/pages/AgentBindingsPage.tsx +1 -8
  109. package/src/client-v2/pages/ApprovalsPage.tsx +1 -8
  110. package/src/client-v2/pages/EmployeeGovernancePage.tsx +1 -8
  111. package/src/client-v2/pages/ExecutionHistoryPage.tsx +1 -8
  112. package/src/client-v2/pages/HarnessProfilesPage.tsx +1 -8
  113. package/src/client-v2/pages/KnowledgeAccessPage.tsx +1 -8
  114. package/src/client-v2/pages/LoopSettingsPage.tsx +1 -8
  115. package/src/client-v2/pages/MemoryInspectorPage.tsx +1 -8
  116. package/src/client-v2/pages/RetrievalTracePage.tsx +1 -8
  117. package/src/client-v2/pages/RulesPage.tsx +1 -8
  118. package/src/client-v2/pages/SkillDefinitionsPage.tsx +1 -8
  119. package/src/client-v2/pages/SkillMetricsPage.tsx +1 -8
  120. package/src/client-v2/pages/TracingPage.tsx +1 -8
  121. package/src/client-v2/pages/UsageGovernancePage.tsx +1 -8
  122. package/src/client-v2/plugin.tsx +3 -8
  123. package/src/client-v2/skill-hub/tools/__tests__/interactions.test.ts +17 -1
  124. package/src/client-v2/skill-hub/tools/interactions.ts +12 -3
  125. package/src/locale/en-US.json +80 -1
  126. package/src/locale/vi-VN.json +5 -1
  127. package/src/locale/zh-CN.json +80 -1
  128. package/src/server/__tests__/agent-governance.integration.test.ts +1 -8
  129. package/src/server/__tests__/agent-monitor-acl.integration.test.ts +1 -8
  130. package/src/server/__tests__/agent-usage-report.integration.test.ts +1 -8
  131. package/src/server/__tests__/auto-approval-checkpoint.integration.test.ts +295 -0
  132. package/src/server/__tests__/harness-capabilities.test.ts +1 -8
  133. package/src/server/__tests__/harness-compiler.test.ts +64 -0
  134. package/src/server/__tests__/harness-tool-plan.test.ts +1 -8
  135. package/src/server/__tests__/hierarchical-routing.integration.test.ts +2318 -0
  136. package/src/server/__tests__/hierarchy-invocation-journal.integration.test.ts +119 -0
  137. package/src/server/__tests__/loop-approval-decision.test.ts +59 -12
  138. package/src/server/__tests__/loop-budget-service.test.ts +1 -8
  139. package/src/server/__tests__/loop-run-repository.test.ts +1 -8
  140. package/src/server/__tests__/loop-trigger-service.test.ts +1 -8
  141. package/src/server/__tests__/loop-worker-claim.test.ts +46 -9
  142. package/src/server/__tests__/loop-worker-execution.test.ts +1 -8
  143. package/src/server/__tests__/native-agent-monitor-sync.test.ts +1 -8
  144. package/src/server/__tests__/native-hierarchy-probe.integration.test.ts +527 -0
  145. package/src/server/__tests__/native-sub-agent-observer.test.ts +1 -8
  146. package/src/server/__tests__/native-usage-attribution.integration.test.ts +1 -8
  147. package/src/server/__tests__/plugin-ai-runtime-adapter.test.ts +403 -0
  148. package/src/server/__tests__/registry-node-package.test.ts +299 -0
  149. package/src/server/__tests__/routing-binding-graph.integration.test.ts +217 -0
  150. package/src/server/__tests__/routing-binding-validation.test.ts +256 -0
  151. package/src/server/__tests__/session-auto-approval.integration.test.ts +329 -0
  152. package/src/server/__tests__/skill-execute.test.ts +11 -0
  153. package/src/server/__tests__/skill-review-guard.test.ts +171 -0
  154. package/src/server/__tests__/token-tracker.test.ts +1 -8
  155. package/src/server/__tests__/tracing-retention-policy.test.ts +1 -8
  156. package/src/server/__tests__/usage-ledger.integration.test.ts +1 -8
  157. package/src/server/collections/agent-auto-approval-checkpoints.ts +18 -0
  158. package/src/server/collections/agent-execution-spans.ts +4 -11
  159. package/src/server/collections/agent-governance-audit-events.ts +1 -8
  160. package/src/server/collections/agent-governance-policies.ts +1 -8
  161. package/src/server/collections/agent-governance-policy-versions.ts +1 -8
  162. package/src/server/collections/agent-governance-prompt-bindings.ts +1 -8
  163. package/src/server/collections/agent-hierarchy-invocations.ts +30 -0
  164. package/src/server/collections/agent-loop-runs.ts +1 -8
  165. package/src/server/collections/agent-routing-graph-locks.ts +11 -0
  166. package/src/server/collections/agent-session-auto-approvals.ts +16 -0
  167. package/src/server/collections/orchestrator-config.ts +26 -0
  168. package/src/server/migrations/20261110000000-add-usage-pricing-snapshots.ts +1 -8
  169. package/src/server/migrations/20261110010000-add-usage-department-attribution.ts +1 -8
  170. package/src/server/migrations/20261119000000-widen-native-employee-identifiers.ts +37 -0
  171. package/src/server/plugin.ts +58 -8
  172. package/src/server/resources/agent-auto-approval.ts +51 -0
  173. package/src/server/resources/agent-governance.ts +1 -8
  174. package/src/server/resources/agent-harness-profile.ts +1 -8
  175. package/src/server/resources/agent-monitor.ts +1 -8
  176. package/src/server/resources/agent-usage.ts +1 -8
  177. package/src/server/resources/hierarchical-routing.ts +39 -0
  178. package/src/server/resources/native-monitor-format.ts +1 -8
  179. package/src/server/resources/tracing.ts +1 -8
  180. package/src/server/services/AgentGovernanceService.ts +1 -8
  181. package/src/server/services/AutoApprovalCheckpoint.ts +140 -0
  182. package/src/server/services/CodeValidator.ts +23 -4
  183. package/src/server/services/DepartmentAttribution.ts +1 -8
  184. package/src/server/services/ExecutionSpanService.ts +1 -8
  185. package/src/server/services/GovernanceAdmission.ts +83 -8
  186. package/src/server/services/HarnessCapabilities.ts +1 -8
  187. package/src/server/services/HarnessCompiler.ts +12 -0
  188. package/src/server/services/HarnessSchema.ts +30 -0
  189. package/src/server/services/HierarchicalAgentRuntime.ts +1052 -0
  190. package/src/server/services/HierarchyEnrollmentGuard.ts +211 -0
  191. package/src/server/services/HierarchyInvocationJournal.ts +172 -0
  192. package/src/server/services/HierarchyRequestCancellation.ts +132 -0
  193. package/src/server/services/LoopBudgetService.ts +1 -8
  194. package/src/server/services/LoopRunRepository.ts +2 -9
  195. package/src/server/services/LoopRunStateMachine.ts +3 -10
  196. package/src/server/services/LoopTriggerService.ts +1 -8
  197. package/src/server/services/LoopWorkerService.ts +8 -19
  198. package/src/server/services/ManagedPromptProtection.ts +1 -8
  199. package/src/server/services/NativeAgentMonitorSyncService.ts +1 -8
  200. package/src/server/services/NativeSubAgentObserver.ts +1 -8
  201. package/src/server/services/NativeUsageAttribution.ts +1 -8
  202. package/src/server/services/PluginAiRuntimeAdapter.ts +140 -9
  203. package/src/server/services/RoutingBindingRepository.ts +146 -0
  204. package/src/server/services/RoutingBindingValidation.ts +161 -0
  205. package/src/server/services/SandboxRunner.ts +35 -1
  206. package/src/server/services/SessionAutoApproval.ts +167 -0
  207. package/src/server/services/TokenTracker.ts +1 -8
  208. package/src/server/services/TracingRetentionPolicy.ts +1 -8
  209. package/src/server/services/VerificationService.ts +3 -10
  210. package/src/server/skill-hub/plugin.ts +40 -0
  211. package/src/server/skill-hub/services/RegistrySkillInstallationService.ts +11 -1
  212. package/src/server/skill-hub/services/registry-node-package.ts +191 -0
  213. package/src/server/skill-hub/tasks/SkillExecutionTask.ts +34 -5
  214. package/src/server/tools/skill-execute.ts +10 -0
  215. package/src/server/utils/ensure-indexes.ts +2 -8
  216. package/dist/client/418.6f01da17774a5a25.js +0 -10
  217. package/dist/client/652.477e21bfff67bc1c.js +0 -10
  218. package/dist/client-v2/418.55b6b28cda8bb5f3.js +0 -10
  219. package/dist/client-v2/652.1a48364774d5383a.js +0 -10
  220. package/dist/client-v2/981.a81521f0296c7db8.js +0 -10
@@ -0,0 +1,403 @@
1
+ /**
2
+ * This file is part of the NocoBase (R) project.
3
+ * Copyright (c) 2020-2024 NocoBase Co., Ltd.
4
+ * Authors: NocoBase Team.
5
+ *
6
+ * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
7
+ * For more information, please refer to: https://www.nocobase.com/agreement.
8
+ */
9
+
10
+ import type { Database } from '@nocobase/database';
11
+ import type { Application } from '@nocobase/server';
12
+ import { beforeEach, describe, expect, it, vi } from 'vitest';
13
+ import { AIEmployee as NativeAIEmployee } from '../../../../../../packages/plugins/@nocobase/plugin-ai/src/server/ai-employees/ai-employee';
14
+ import { AIConversationsManager as NativeAIConversationsManager } from '../../../../../../packages/plugins/@nocobase/plugin-ai/src/server/ai-employees/ai-conversations';
15
+ import { compileHarness } from '../services/HarnessCompiler';
16
+ import { PluginAiRuntimeAdapter } from '../services/PluginAiRuntimeAdapter';
17
+
18
+ type RuntimeResult = Record<string, unknown>;
19
+
20
+ const runtime = vi.hoisted(() => ({
21
+ result: null as RuntimeResult | null,
22
+ calls: [] as Array<Record<string, unknown>>,
23
+ }));
24
+
25
+ vi.mock('@nocobase/plugin-ai/server', () => ({
26
+ AIEmployee: class {
27
+ async invoke(input: Record<string, unknown>) {
28
+ runtime.calls.push(input);
29
+ return runtime.result;
30
+ }
31
+ },
32
+ }));
33
+
34
+ const nativeInterrupt = {
35
+ messageId: 'message-1',
36
+ messages: [{ content: 'Waiting for a decision' }],
37
+ __interrupt__: [
38
+ {
39
+ id: 'interrupt-1',
40
+ value: {
41
+ actionRequests: [
42
+ {
43
+ name: 'skill_hub_report',
44
+ args: { input: { source: 'monthly.csv' } },
45
+ description: JSON.stringify({
46
+ toolCallId: 'call-1',
47
+ toolCallName: 'skill_hub_report',
48
+ sessionId: 'session-1',
49
+ from: 'main-agent',
50
+ username: 'review-agent',
51
+ }),
52
+ },
53
+ ],
54
+ reviewConfigs: [{ actionName: 'skill_hub_report', allowedDecisions: ['approve', 'edit', 'reject'] }],
55
+ },
56
+ },
57
+ ],
58
+ };
59
+
60
+ function createAdapter(
61
+ options: {
62
+ actualConversationManager?: boolean;
63
+ nativeMessage?: Record<string, unknown>;
64
+ nativeToolMessages?: Array<Record<string, unknown>>;
65
+ } = {},
66
+ ) {
67
+ const employee = {
68
+ skillSettings: { tools: [{ name: 'skill_hub_report', autoCall: true }] },
69
+ get(name: string) {
70
+ return name === 'skillSettings' ? this.skillSettings : undefined;
71
+ },
72
+ set(name: string, value: unknown) {
73
+ if (name === 'skillSettings') this.skillSettings = value as { tools: Array<{ name: string; autoCall: boolean }> };
74
+ },
75
+ };
76
+ const nativeToolMessages = options.nativeToolMessages ?? [];
77
+ const nativeMessage = options.nativeMessage;
78
+ const matches = (row: Record<string, unknown>, where: Record<string, unknown>) =>
79
+ Object.entries(where).every(([key, value]) => row[key] === value);
80
+ const updateToolMessage = vi
81
+ .fn()
82
+ .mockImplementation(async (values: Record<string, unknown>, query: { where: Record<string, unknown> }) => {
83
+ const rows = nativeToolMessages.filter((row) => matches(row, query.where));
84
+ rows.forEach((row) => Object.assign(row, values));
85
+ return [rows.length];
86
+ });
87
+ const messagesModel = {
88
+ findOne: vi.fn(async (query: { where: Record<string, unknown> }) => {
89
+ if (!nativeMessage || !matches(nativeMessage, query.where)) return null;
90
+ return { ...nativeMessage, get: (name: string) => nativeMessage[name] };
91
+ }),
92
+ update: vi.fn(async (values: Record<string, unknown>, query: { where: Record<string, unknown> }) => {
93
+ if (!nativeMessage || !matches(nativeMessage, query.where)) return [0];
94
+ Object.assign(nativeMessage, values);
95
+ return [1];
96
+ }),
97
+ };
98
+ const toolMessagesModel = {
99
+ findOne: vi.fn(
100
+ async (query: { where: Record<string, unknown> }) =>
101
+ nativeToolMessages.find((row) => matches(row, query.where)) ?? null,
102
+ ),
103
+ update: updateToolMessage,
104
+ };
105
+ const db = {
106
+ sequelize: {
107
+ transaction: async <T>(callback: (transaction: { LOCK: { UPDATE: string } }) => Promise<T>) =>
108
+ callback({ LOCK: { UPDATE: 'UPDATE' } }),
109
+ },
110
+ getModel: (name: string) => (name === 'aiMessages' ? messagesModel : toolMessagesModel),
111
+ getRepository: (name: string) => {
112
+ if (name === 'aiToolMessages') {
113
+ return {
114
+ find: async (query: { filter: { messageId: string } }) =>
115
+ nativeToolMessages
116
+ .filter((row) => row.messageId === query.filter.messageId && Number.isInteger(row.interruptActionOrder))
117
+ .sort((left, right) => Number(left.interruptActionOrder) - Number(right.interruptActionOrder)),
118
+ };
119
+ }
120
+ if (name === 'aiMessages') {
121
+ return {
122
+ findOne: async (query: { filter: { messageId: string } }) => {
123
+ if (nativeMessage?.messageId !== query.filter.messageId) return null;
124
+ return { ...nativeMessage, get: (name: string) => nativeMessage[name] };
125
+ },
126
+ };
127
+ }
128
+ return { find: async () => [] };
129
+ },
130
+ };
131
+ const aiConversationsManager = options.actualConversationManager
132
+ ? new NativeAIConversationsManager({ db } as unknown as ConstructorParameters<
133
+ typeof NativeAIConversationsManager
134
+ >[0])
135
+ : { getUserDecisions: vi.fn().mockResolvedValue({ interruptId: 'interrupt-1', decisions: [] }) };
136
+ const plugin = {
137
+ aiEmployeesManager: {
138
+ getEmployee: vi.fn().mockResolvedValue(employee),
139
+ resolveModel: vi.fn().mockResolvedValue({ llmService: 'mock', model: 'mock' }),
140
+ },
141
+ aiConversationsManager,
142
+ };
143
+ const app = {
144
+ pm: { get: vi.fn().mockReturnValue(plugin) },
145
+ aiManager: {
146
+ toolsManager: {
147
+ getTools: vi.fn(async (name: string) => ({
148
+ scope: 'CUSTOM',
149
+ defaultPermission: 'ALLOW',
150
+ definition: { name },
151
+ })),
152
+ },
153
+ },
154
+ db,
155
+ logger: { info: vi.fn() },
156
+ log: {},
157
+ } as unknown as Application;
158
+
159
+ return { adapter: new PluginAiRuntimeAdapter(app), employee, plugin, updateToolMessage };
160
+ }
161
+
162
+ function invokeInput() {
163
+ return {
164
+ username: 'review-agent',
165
+ sessionId: 'session-1',
166
+ userId: 7,
167
+ systemMessage: 'Review the requested report.',
168
+ harness: compileHarness([{ source: 'test', settings: { tools: { allow: ['skill_hub_report'] } } }]),
169
+ prompt: 'Build the report.',
170
+ signal: new AbortController().signal,
171
+ };
172
+ }
173
+
174
+ beforeEach(() => {
175
+ runtime.result = structuredClone(nativeInterrupt);
176
+ runtime.calls.length = 0;
177
+ });
178
+
179
+ describe('PluginAiRuntimeAdapter native review interrupts', () => {
180
+ it('formats the adapter prompt through the native AI employee message formatter', async () => {
181
+ const { adapter } = createAdapter();
182
+
183
+ await adapter.invoke(invokeInput());
184
+
185
+ const userMessages = runtime.calls[0]?.userMessages;
186
+ expect(userMessages).toEqual([{ role: 'user', content: { type: 'text', content: 'Build the report.' } }]);
187
+ if (!Array.isArray(userMessages)) throw new Error('The adapter did not send native user messages.');
188
+
189
+ type NativeFormatter = (
190
+ this: {
191
+ plugin: { workContextHandler: Record<string, never> };
192
+ ctx: Record<string, never>;
193
+ normalizeMessageAttachments: (messages: unknown[]) => Promise<unknown[]>;
194
+ },
195
+ input: { messages: unknown[]; provider: Record<string, never> },
196
+ ) => Promise<Array<{ content?: unknown }>>;
197
+ const nativeFormatter = Reflect.get(NativeAIEmployee.prototype, 'formatMessages') as NativeFormatter;
198
+ const formattedMessages = await nativeFormatter.call(
199
+ {
200
+ plugin: { workContextHandler: {} },
201
+ ctx: {},
202
+ normalizeMessageAttachments: async (messages) => messages,
203
+ },
204
+ { messages: userMessages, provider: {} },
205
+ );
206
+
207
+ expect(formattedMessages.map((message) => message.content)).toEqual(['<user_query>Build the report.</user_query>']);
208
+ });
209
+
210
+ it('decodes the native actionRequests envelope returned by plugin-ai', async () => {
211
+ const { adapter } = createAdapter();
212
+
213
+ const outcome = await adapter.invoke(invokeInput());
214
+
215
+ expect(outcome.interrupted).toEqual([
216
+ {
217
+ toolCallId: 'call-1',
218
+ toolName: 'skill_hub_report',
219
+ args: { input: { source: 'monthly.csv' } },
220
+ interruptId: 'interrupt-1',
221
+ },
222
+ ]);
223
+ });
224
+
225
+ it('preserves native decision order for a batch of same-name tool calls', async () => {
226
+ const toolName = 'skill_hub_report';
227
+ const requests = [
228
+ { toolCallId: 'call-a', args: { input: { section: 'summary' } } },
229
+ { toolCallId: 'call-b', args: { input: { section: 'details' } } },
230
+ { toolCallId: 'call-c', args: { input: { section: 'appendix' } } },
231
+ ];
232
+ const actions = requests.map((request) => ({
233
+ name: toolName,
234
+ args: request.args,
235
+ description: JSON.stringify({
236
+ toolCallId: request.toolCallId,
237
+ toolCallName: toolName,
238
+ sessionId: 'session-1',
239
+ from: 'main-agent',
240
+ username: 'review-agent',
241
+ }),
242
+ }));
243
+ runtime.result = {
244
+ messageId: 'message-1',
245
+ messages: [],
246
+ __interrupt__: [
247
+ {
248
+ id: 'interrupt-batch',
249
+ value: {
250
+ actionRequests: actions,
251
+ reviewConfigs: [{ actionName: toolName, allowedDecisions: ['approve', 'edit', 'reject'] }],
252
+ },
253
+ },
254
+ ],
255
+ };
256
+ const nativeMessage = {
257
+ sessionId: 'session-1',
258
+ messageId: 'message-1',
259
+ role: 'review-agent',
260
+ toolCalls: requests.map(({ toolCallId }) => ({ id: toolCallId, name: toolName })),
261
+ metadata: {},
262
+ };
263
+ const nativeToolMessages = requests.map(({ toolCallId }) => ({
264
+ sessionId: 'session-1',
265
+ messageId: 'message-1',
266
+ toolCallId,
267
+ toolName,
268
+ invokeStatus: 'init',
269
+ userDecision: null,
270
+ }));
271
+ const { adapter, updateToolMessage } = createAdapter({
272
+ actualConversationManager: true,
273
+ nativeMessage,
274
+ nativeToolMessages,
275
+ });
276
+
277
+ const firstOutcome = await adapter.invoke(invokeInput());
278
+
279
+ expect(firstOutcome.interrupted.map((call) => call.toolCallId)).toEqual(['call-a', 'call-b', 'call-c']);
280
+ expect(nativeToolMessages.map((call) => [call.invokeStatus, call.interruptActionOrder])).toEqual([
281
+ ['interrupted', 0],
282
+ ['interrupted', 1],
283
+ ['interrupted', 2],
284
+ ]);
285
+ expect(nativeMessage.metadata).toEqual({ interruptId: 'interrupt-batch' });
286
+
287
+ runtime.result = { messageId: 'message-2', messages: [] };
288
+ const decisions = [
289
+ { toolCallId: 'call-c', decision: { type: 'reject' as const, message: 'Skip the appendix.' } },
290
+ {
291
+ toolCallId: 'call-a',
292
+ decision: { type: 'approve' as const },
293
+ },
294
+ {
295
+ toolCallId: 'call-b',
296
+ decision: {
297
+ type: 'edit' as const,
298
+ editedAction: { name: toolName, args: { input: { section: 'details', format: 'brief' } } },
299
+ },
300
+ },
301
+ ];
302
+ await adapter.resume({
303
+ username: 'review-agent',
304
+ sessionId: 'session-1',
305
+ messageId: 'message-1',
306
+ userId: 7,
307
+ systemMessage: 'Review the requested report.',
308
+ harness: compileHarness([{ source: 'test', settings: { tools: { allow: [toolName] } } }]),
309
+ decisions,
310
+ signal: new AbortController().signal,
311
+ });
312
+
313
+ expect(updateToolMessage).toHaveBeenCalledTimes(6);
314
+ expect(runtime.calls[1]).not.toHaveProperty('messageId');
315
+ expect(runtime.calls[1]).toMatchObject({
316
+ userDecisions: {
317
+ interruptId: 'interrupt-batch',
318
+ decisions: [
319
+ { type: 'approve' },
320
+ { type: 'edit', editedAction: { name: toolName, args: { input: { section: 'details', format: 'brief' } } } },
321
+ { type: 'reject', message: 'Skip the appendix.' },
322
+ ],
323
+ },
324
+ });
325
+ });
326
+
327
+ it('applies persisted decisions and decodes the next native interrupt when resuming', async () => {
328
+ const { adapter, updateToolMessage, plugin } = createAdapter();
329
+
330
+ const outcome = await adapter.resume({
331
+ username: 'review-agent',
332
+ sessionId: 'session-1',
333
+ messageId: 'message-1',
334
+ userId: 7,
335
+ systemMessage: 'Review the requested report.',
336
+ harness: compileHarness([{ source: 'test', settings: { tools: { allow: ['skill_hub_report'] } } }]),
337
+ decisions: [{ toolCallId: 'call-before-resume', decision: { type: 'approve' } }],
338
+ signal: new AbortController().signal,
339
+ });
340
+
341
+ expect(updateToolMessage).toHaveBeenCalledWith(
342
+ { userDecision: { type: 'approve' }, invokeStatus: 'waiting' },
343
+ {
344
+ where: {
345
+ sessionId: 'session-1',
346
+ messageId: 'message-1',
347
+ toolCallId: 'call-before-resume',
348
+ invokeStatus: 'interrupted',
349
+ },
350
+ },
351
+ );
352
+ expect(plugin.aiConversationsManager.getUserDecisions).toHaveBeenCalledWith('message-1');
353
+ expect(runtime.calls).toHaveLength(1);
354
+ expect(runtime.calls[0]).not.toHaveProperty('messageId');
355
+ expect(outcome.interrupted).toEqual([
356
+ {
357
+ toolCallId: 'call-1',
358
+ toolName: 'skill_hub_report',
359
+ args: { input: { source: 'monthly.csv' } },
360
+ interruptId: 'interrupt-1',
361
+ },
362
+ ]);
363
+ });
364
+
365
+ it('continues to accept legacy direct interrupt records', async () => {
366
+ runtime.result = {
367
+ messageId: 'message-1',
368
+ messages: [],
369
+ __interrupt__: [
370
+ {
371
+ id: 'legacy-interrupt',
372
+ value: { toolCallId: 'legacy-call', name: 'legacy_tool', args: { value: 1 } },
373
+ },
374
+ ],
375
+ };
376
+ const { adapter } = createAdapter();
377
+
378
+ const outcome = await adapter.invoke(invokeInput());
379
+
380
+ expect(outcome.interrupted).toEqual([
381
+ { toolCallId: 'legacy-call', toolName: 'legacy_tool', args: { value: 1 }, interruptId: 'legacy-interrupt' },
382
+ ]);
383
+ });
384
+
385
+ it('fails closed for a malformed native action request', async () => {
386
+ runtime.result = {
387
+ messageId: 'message-1',
388
+ messages: [],
389
+ __interrupt__: [
390
+ {
391
+ id: 'bad-interrupt',
392
+ value: {
393
+ actionRequests: [{ name: 'skill_hub_report', args: {}, description: '{bad json' }],
394
+ reviewConfigs: [],
395
+ },
396
+ },
397
+ ],
398
+ };
399
+ const { adapter } = createAdapter();
400
+
401
+ await expect(adapter.invoke(invokeInput())).rejects.toThrow();
402
+ });
403
+ });