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,342 @@
1
+ // SPDX-License-Identifier: Apache-2.0
2
+
3
+ import { AIEmployee } from '@nocobase/plugin-ai/server';
4
+ import { AIMessage, BaseMessage } from '@langchain/core/messages';
5
+ import { BaseChatModel, type BaseChatModelCallOptions } from '@langchain/core/language_models/chat_models';
6
+ import type { ChatResult } from '@langchain/core/outputs';
7
+ import { tool } from '@langchain/core/tools';
8
+ import { Command, MemorySaver } from '@langchain/langgraph';
9
+ import { createAgent, humanInTheLoopMiddleware } from 'langchain';
10
+ import { afterEach, describe, expect, it, vi } from 'vitest';
11
+ import { z } from 'zod';
12
+ import {
13
+ installParallelInterruptActionsPatch,
14
+ toInterruptActionsFixed,
15
+ type InterruptAction,
16
+ type InterruptPayload,
17
+ } from '../services/ParallelInterruptActionsPatch';
18
+
19
+ type PrivateAIEmployeeProto = {
20
+ toInterruptActions: (interrupt?: InterruptPayload) => Map<string, InterruptAction>;
21
+ handleInterruptedToolCalls: (
22
+ interrupt: { id?: string; value?: InterruptPayload } | undefined,
23
+ getMessageId: (sessionId: string) => string | undefined,
24
+ onInterrupted?: (params: {
25
+ messageId: string;
26
+ interruptId: string;
27
+ interruptAction: InterruptAction;
28
+ toolCall: { id: string; name: string };
29
+ currentConversation: { sessionId: string; from: string; username: string };
30
+ }) => Promise<void> | void,
31
+ ) => Promise<void>;
32
+ };
33
+
34
+ function makeDescription(params: {
35
+ toolCallId: string;
36
+ toolCallName: string;
37
+ sessionId?: string;
38
+ from?: string;
39
+ username?: string;
40
+ }): string {
41
+ return JSON.stringify({
42
+ toolCallId: params.toolCallId,
43
+ toolCallName: params.toolCallName,
44
+ sessionId: params.sessionId ?? 'session-1',
45
+ from: params.from ?? 'main-agent',
46
+ username: params.username ?? 'dex',
47
+ });
48
+ }
49
+
50
+ class ParallelSameToolMockChatModel extends BaseChatModel {
51
+ private callCount = 0;
52
+
53
+ constructor() {
54
+ super({});
55
+ }
56
+
57
+ _llmType(): string {
58
+ return 'parallel-same-tool-mock';
59
+ }
60
+
61
+ bindTools() {
62
+ return this;
63
+ }
64
+
65
+ async _generate(_messages: BaseMessage[], _options: BaseChatModelCallOptions): Promise<ChatResult> {
66
+ this.callCount += 1;
67
+ if (this.callCount === 1) {
68
+ return {
69
+ generations: [
70
+ {
71
+ text: '',
72
+ message: new AIMessage({
73
+ content: '',
74
+ tool_calls: [
75
+ {
76
+ id: 'tooluse_first_call',
77
+ name: 'mcp-rpa-portainer-docker_proxy',
78
+ args: { container: 'web-1' },
79
+ },
80
+ {
81
+ id: 'tooluse_second_call',
82
+ name: 'mcp-rpa-portainer-docker_proxy',
83
+ args: { container: 'api-2' },
84
+ },
85
+ ],
86
+ }),
87
+ },
88
+ ],
89
+ };
90
+ }
91
+ return {
92
+ generations: [
93
+ {
94
+ text: 'Both containers inspected.',
95
+ message: new AIMessage({ content: 'Both containers inspected.' }),
96
+ },
97
+ ],
98
+ };
99
+ }
100
+ }
101
+
102
+ describe('ParallelInterruptActionsPatch', () => {
103
+ const cleanups: Array<() => void> = [];
104
+
105
+ afterEach(() => {
106
+ while (cleanups.length > 0) {
107
+ cleanups.pop()?.();
108
+ }
109
+ });
110
+
111
+ it('preserves all parallel calls to the same tool name in exact actionRequests order', () => {
112
+ const toolName = 'mcp-rpa-portainer-docker_proxy';
113
+ const payload: InterruptPayload = {
114
+ actionRequests: [
115
+ {
116
+ name: toolName,
117
+ args: { container: 'c1' },
118
+ description: makeDescription({ toolCallId: 'tooluse_1', toolCallName: toolName }),
119
+ },
120
+ {
121
+ name: toolName,
122
+ args: { container: 'c2' },
123
+ description: makeDescription({ toolCallId: 'tooluse_2', toolCallName: toolName }),
124
+ },
125
+ {
126
+ name: toolName,
127
+ args: { container: 'c3' },
128
+ description: makeDescription({ toolCallId: 'tooluse_3', toolCallName: toolName }),
129
+ },
130
+ ],
131
+ reviewConfigs: [
132
+ { actionName: toolName, allowedDecisions: ['approve', 'reject'] },
133
+ { actionName: toolName, allowedDecisions: ['approve', 'reject'] },
134
+ { actionName: toolName, allowedDecisions: ['approve', 'reject'] },
135
+ ],
136
+ };
137
+
138
+ const result = toInterruptActionsFixed(payload);
139
+ expect(result.size).toBe(3);
140
+ expect([...result.keys()]).toEqual(['tooluse_1', 'tooluse_2', 'tooluse_3']);
141
+ expect([...result.values()].map((entry) => ({ order: entry.order, id: entry.toolCall?.id }))).toEqual([
142
+ { order: 0, id: 'tooluse_1' },
143
+ { order: 1, id: 'tooluse_2' },
144
+ { order: 2, id: 'tooluse_3' },
145
+ ]);
146
+ for (const entry of result.values()) {
147
+ expect(entry.allowedDecisions).toEqual(['approve', 'reject']);
148
+ expect(entry.currentConversation).toEqual({
149
+ sessionId: 'session-1',
150
+ from: 'main-agent',
151
+ username: 'dex',
152
+ });
153
+ }
154
+ });
155
+
156
+ it('preserves mixed parallel calls and per-action allowedDecisions', () => {
157
+ const payload: InterruptPayload = {
158
+ actionRequests: [
159
+ {
160
+ name: 'tool_a',
161
+ description: makeDescription({ toolCallId: 'call_a1', toolCallName: 'tool_a' }),
162
+ },
163
+ {
164
+ name: 'tool_b',
165
+ description: makeDescription({ toolCallId: 'call_b1', toolCallName: 'tool_b' }),
166
+ },
167
+ {
168
+ name: 'tool_a',
169
+ description: makeDescription({ toolCallId: 'call_a2', toolCallName: 'tool_a' }),
170
+ },
171
+ ],
172
+ reviewConfigs: [
173
+ { actionName: 'tool_a', allowedDecisions: ['approve', 'reject'] },
174
+ { actionName: 'tool_b', allowedDecisions: ['approve', 'edit', 'reject'] },
175
+ ],
176
+ };
177
+
178
+ const result = toInterruptActionsFixed(payload);
179
+ expect(result.size).toBe(3);
180
+ expect(result.get('call_a1')?.order).toBe(0);
181
+ expect(result.get('call_a1')?.allowedDecisions).toEqual(['approve', 'reject']);
182
+ expect(result.get('call_b1')?.order).toBe(1);
183
+ expect(result.get('call_b1')?.allowedDecisions).toEqual(['approve', 'edit', 'reject']);
184
+ expect(result.get('call_a2')?.order).toBe(2);
185
+ expect(result.get('call_a2')?.allowedDecisions).toEqual(['approve', 'reject']);
186
+ });
187
+
188
+ it('handles malformed or missing descriptions safely without throwing', () => {
189
+ const payload: InterruptPayload = {
190
+ actionRequests: [{ name: 'broken_tool', description: '{not-valid-json' }, { name: 'empty_tool' }],
191
+ reviewConfigs: [{ actionName: 'broken_tool', allowedDecisions: ['approve', 'reject'] }],
192
+ };
193
+
194
+ const result = toInterruptActionsFixed(payload);
195
+ expect(result.size).toBe(2);
196
+ const values = [...result.values()];
197
+ expect(values[0].order).toBe(0);
198
+ expect(values[0].toolCall).toBeUndefined();
199
+ expect(values[0].currentConversation).toBeUndefined();
200
+ expect(values[1].order).toBe(1);
201
+ expect(values[1].toolCall).toBeUndefined();
202
+ });
203
+
204
+ it('returns an empty map for undefined or empty payloads', () => {
205
+ expect(toInterruptActionsFixed(undefined).size).toBe(0);
206
+ expect(toInterruptActionsFixed({ actionRequests: [], reviewConfigs: [] }).size).toBe(0);
207
+ });
208
+
209
+ it('patches AIEmployee.prototype with ref-counted install/uninstall and restores upstream method cleanly', () => {
210
+ const proto = AIEmployee.prototype as unknown as PrivateAIEmployeeProto;
211
+ const originalMethod = proto.toInterruptActions;
212
+
213
+ const sameToolPayload: InterruptPayload = {
214
+ actionRequests: [
215
+ {
216
+ name: 'mcp-rpa-portainer-docker_proxy',
217
+ description: makeDescription({ toolCallId: 'tooluse_1', toolCallName: 'mcp-rpa-portainer-docker_proxy' }),
218
+ },
219
+ {
220
+ name: 'mcp-rpa-portainer-docker_proxy',
221
+ description: makeDescription({ toolCallId: 'tooluse_2', toolCallName: 'mcp-rpa-portainer-docker_proxy' }),
222
+ },
223
+ ],
224
+ reviewConfigs: [{ actionName: 'mcp-rpa-portainer-docker_proxy', allowedDecisions: ['approve', 'reject'] }],
225
+ };
226
+
227
+ // Baseline check: upstream collapses duplicate tool names into a single entry.
228
+ expect(originalMethod.call({}, sameToolPayload).size).toBe(1);
229
+
230
+ const disposeA = installParallelInterruptActionsPatch();
231
+ cleanups.push(disposeA);
232
+ const disposeB = installParallelInterruptActionsPatch();
233
+ cleanups.push(disposeB);
234
+
235
+ expect(proto.toInterruptActions).not.toBe(originalMethod);
236
+ expect(proto.toInterruptActions.call({}, sameToolPayload).size).toBe(2);
237
+
238
+ // First dispose keeps patch active while a second owner remains; double-disposing owner A is a no-op.
239
+ disposeA();
240
+ disposeA();
241
+ expect(proto.toInterruptActions).not.toBe(originalMethod);
242
+ expect(proto.toInterruptActions.call({}, sameToolPayload).size).toBe(2);
243
+
244
+ // Last dispose restores the original upstream method.
245
+ disposeB();
246
+ expect(proto.toInterruptActions).toBe(originalMethod);
247
+ });
248
+
249
+ it('marks every parallel same-tool call interrupted in handleInterruptedToolCalls and resumes both calls via LangChain HITL', async () => {
250
+ const dispose = installParallelInterruptActionsPatch();
251
+ cleanups.push(dispose);
252
+
253
+ const executedContainers: string[] = [];
254
+ const dockerProxyTool = tool(
255
+ async ({ container }) => {
256
+ executedContainers.push(container);
257
+ return `inspected:${container}`;
258
+ },
259
+ {
260
+ name: 'mcp-rpa-portainer-docker_proxy',
261
+ description: 'Inspect a docker container',
262
+ schema: z.object({ container: z.string() }),
263
+ },
264
+ );
265
+
266
+ const sessionId = 'session-parallel-hitl';
267
+ const agent = createAgent({
268
+ model: new ParallelSameToolMockChatModel(),
269
+ tools: [dockerProxyTool],
270
+ checkpointer: new MemorySaver(),
271
+ middleware: [
272
+ humanInTheLoopMiddleware({
273
+ interruptOn: {
274
+ 'mcp-rpa-portainer-docker_proxy': {
275
+ allowedDecisions: ['approve', 'reject'],
276
+ description: (toolCall) =>
277
+ makeDescription({
278
+ toolCallId: toolCall.id ?? '',
279
+ toolCallName: toolCall.name,
280
+ sessionId,
281
+ }),
282
+ },
283
+ },
284
+ }),
285
+ ],
286
+ });
287
+
288
+ const config = { configurable: { thread_id: sessionId } };
289
+ const firstResult = (await agent.invoke(
290
+ { messages: [{ role: 'user', content: 'Inspect web-1 and api-2 in parallel.' }] },
291
+ config,
292
+ )) as { __interrupt__?: Array<{ id?: string; value?: InterruptPayload }> };
293
+
294
+ const interrupts = firstResult.__interrupt__ ?? [];
295
+ expect(interrupts).toHaveLength(1);
296
+ const interrupt = interrupts[0];
297
+ expect(interrupt.id).toBeTruthy();
298
+
299
+ const updateToolCallInterrupted = vi.fn().mockResolvedValue(undefined);
300
+ const onInterrupted = vi.fn().mockResolvedValue(undefined);
301
+ const fakeEmployeeInstance = {
302
+ toInterruptActions: (AIEmployee.prototype as unknown as PrivateAIEmployeeProto).toInterruptActions,
303
+ updateToolCallInterrupted,
304
+ logger: { warn: vi.fn() },
305
+ };
306
+
307
+ await (AIEmployee.prototype as unknown as PrivateAIEmployeeProto).handleInterruptedToolCalls.call(
308
+ fakeEmployeeInstance,
309
+ interrupt,
310
+ () => 'msg-148557048269798400',
311
+ onInterrupted,
312
+ );
313
+
314
+ expect(updateToolCallInterrupted).toHaveBeenCalledTimes(2);
315
+ expect(updateToolCallInterrupted.mock.calls.map((call) => ({ id: call[2], order: call[4].order }))).toEqual([
316
+ { id: 'tooluse_first_call', order: 0 },
317
+ { id: 'tooluse_second_call', order: 1 },
318
+ ]);
319
+ expect(onInterrupted).toHaveBeenCalledTimes(2);
320
+ expect(onInterrupted.mock.calls.map((call) => call[0].toolCall.id)).toEqual([
321
+ 'tooluse_first_call',
322
+ 'tooluse_second_call',
323
+ ]);
324
+
325
+ // Simulate getUserDecisions() ordering by interruptActionOrder ASC and resuming the graph.
326
+ const interruptId = String(interrupt.id);
327
+ const resumed = (await agent.invoke(
328
+ new Command({
329
+ resume: {
330
+ [interruptId]: {
331
+ decisions: [{ type: 'approve' }, { type: 'approve' }],
332
+ },
333
+ },
334
+ }),
335
+ config,
336
+ )) as { messages?: BaseMessage[] };
337
+
338
+ expect(executedContainers).toEqual(['web-1', 'api-2']);
339
+ const lastMessage = resumed.messages?.[resumed.messages.length - 1];
340
+ expect(lastMessage?.content).toBe('Both containers inspected.');
341
+ });
342
+ });