plugin-agent-orchestrator 1.0.22 → 1.0.23

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 (96) hide show
  1. package/client-v2.d.ts +2 -0
  2. package/client-v2.js +1 -0
  3. package/dist/client/index.js +1 -1
  4. package/dist/client-v2/214.723affb37c13bf7a.js +10 -0
  5. package/dist/client-v2/264.0533912e6c5ea2d7.js +10 -0
  6. package/dist/client-v2/41.1805b2edfaa4afe2.js +10 -0
  7. package/dist/client-v2/418.5ae055abf141820e.js +10 -0
  8. package/dist/client-v2/619.d99d3c9e61c99064.js +10 -0
  9. package/dist/client-v2/70.a15d7fcec7c41768.js +10 -0
  10. package/dist/client-v2/892.72db4161511c8a16.js +10 -0
  11. package/dist/client-v2/926.87f660b670d85bcc.js +10 -0
  12. package/dist/client-v2/index.js +10 -0
  13. package/dist/externalVersion.js +7 -6
  14. package/dist/locale/en-US.json +7 -0
  15. package/dist/locale/vi-VN.json +7 -0
  16. package/dist/locale/zh-CN.json +27 -0
  17. package/dist/server/migrations/20260615000000-normalize-ai-employee-tool-bindings.js +63 -0
  18. package/dist/server/plugin.js +32 -1
  19. package/dist/server/services/AgentHarness.js +52 -27
  20. package/dist/server/services/AgentLoopController.js +8 -2
  21. package/dist/server/services/AgentLoopService.js +1 -1
  22. package/dist/server/services/AgentRegistryService.js +53 -42
  23. package/dist/server/services/CircuitBreaker.js +7 -2
  24. package/dist/server/services/CodeValidator.js +48 -14
  25. package/dist/server/services/SandboxRunner.js +18 -14
  26. package/dist/server/skill-hub/plugin.js +44 -17
  27. package/dist/server/tools/delegate-task.js +7 -2
  28. package/dist/server/tools/skill-execute.js +33 -2
  29. package/dist/server/utils/ai-manager.js +51 -0
  30. package/dist/server/utils/ctx-utils.js +11 -0
  31. package/dist/server/utils/skill-settings.js +122 -0
  32. package/package.json +49 -45
  33. package/src/client/AIEmployeesContext.tsx +51 -14
  34. package/src/client/AgentRunsTab.tsx +767 -764
  35. package/src/client/HarnessProfilesTab.tsx +254 -247
  36. package/src/client/RulesTab.tsx +780 -716
  37. package/src/client/TracingTab.tsx +1 -0
  38. package/src/client/plugin.tsx +34 -27
  39. package/src/client/skill-hub/components/GitSkillImport.tsx +10 -3
  40. package/src/client/skill-hub/components/SkillMetrics.tsx +157 -124
  41. package/src/client/skill-hub/index.tsx +58 -51
  42. package/src/client/skill-hub/tools/InteractionSchemasProvider.tsx +132 -99
  43. package/src/client/skill-hub/tools/registerSkillLoopCards.ts +71 -58
  44. package/src/client/tools/registerOrchestratorCards.ts +17 -7
  45. package/src/client-v2/components/AIEmployeeSelect.tsx +47 -0
  46. package/src/client-v2/components/AIEmployeesContext.tsx +110 -0
  47. package/src/client-v2/components/AgentRunsTab.tsx +767 -0
  48. package/src/client-v2/components/HarnessProfilesTab.tsx +254 -0
  49. package/src/client-v2/components/RulesTab.tsx +782 -0
  50. package/src/client-v2/components/TracingTab.tsx +432 -0
  51. package/src/client-v2/hooks/useApiRequest.ts +114 -0
  52. package/src/client-v2/index.tsx +1 -0
  53. package/src/client-v2/pages/AgentRunsPage.tsx +13 -0
  54. package/src/client-v2/pages/ExecutionHistoryPage.tsx +10 -0
  55. package/src/client-v2/pages/HarnessProfilesPage.tsx +10 -0
  56. package/src/client-v2/pages/LoopSettingsPage.tsx +10 -0
  57. package/src/client-v2/pages/RulesPage.tsx +13 -0
  58. package/src/client-v2/pages/SkillDefinitionsPage.tsx +10 -0
  59. package/src/client-v2/pages/SkillMetricsPage.tsx +10 -0
  60. package/src/client-v2/pages/TracingPage.tsx +13 -0
  61. package/src/client-v2/plugin.tsx +70 -0
  62. package/src/client-v2/skill-hub/components/ExecutionHistory.tsx +196 -0
  63. package/src/client-v2/skill-hub/components/FileLinkList.tsx +37 -0
  64. package/src/client-v2/skill-hub/components/GitSkillImport.tsx +539 -0
  65. package/src/client-v2/skill-hub/components/LoopSettings.tsx +331 -0
  66. package/src/client-v2/skill-hub/components/SkillEditor.tsx +453 -0
  67. package/src/client-v2/skill-hub/components/SkillManager.tsx +174 -0
  68. package/src/client-v2/skill-hub/components/SkillMetrics.tsx +157 -0
  69. package/src/client-v2/skill-hub/components/SkillTestPanel.tsx +135 -0
  70. package/src/client-v2/skill-hub/locale.ts +13 -0
  71. package/src/client-v2/skill-hub/tools/loopTemplates.ts +52 -0
  72. package/src/client-v2/skill-hub/utils/jsonFields.ts +41 -0
  73. package/src/client-v2/utils/jsonFields.ts +41 -0
  74. package/src/locale/en-US.json +7 -0
  75. package/src/locale/vi-VN.json +7 -0
  76. package/src/locale/zh-CN.json +27 -0
  77. package/src/server/__tests__/agent-registry-service.test.ts +147 -0
  78. package/src/server/__tests__/code-validator.test.ts +63 -0
  79. package/src/server/__tests__/skill-execute.test.ts +33 -0
  80. package/src/server/__tests__/skill-settings.test.ts +63 -0
  81. package/src/server/migrations/20260615000000-normalize-ai-employee-tool-bindings.ts +39 -0
  82. package/src/server/plugin.ts +62 -21
  83. package/src/server/services/AgentHarness.ts +49 -22
  84. package/src/server/services/AgentLoopController.ts +17 -6
  85. package/src/server/services/AgentLoopService.ts +1 -1
  86. package/src/server/services/AgentPlannerService.ts +10 -0
  87. package/src/server/services/AgentRegistryService.ts +89 -47
  88. package/src/server/services/CircuitBreaker.ts +10 -0
  89. package/src/server/services/CodeValidator.ts +237 -159
  90. package/src/server/services/SandboxRunner.ts +203 -189
  91. package/src/server/skill-hub/plugin.ts +933 -898
  92. package/src/server/tools/delegate-task.ts +12 -9
  93. package/src/server/tools/skill-execute.ts +194 -160
  94. package/src/server/utils/ai-manager.ts +24 -0
  95. package/src/server/utils/ctx-utils.ts +14 -0
  96. package/src/server/utils/skill-settings.ts +116 -0
@@ -0,0 +1,782 @@
1
+ import React, { useState } from 'react';
2
+ import {
3
+ Table,
4
+ Button,
5
+ Drawer,
6
+ Form,
7
+ InputNumber,
8
+ Switch,
9
+ Space,
10
+ Popconfirm,
11
+ Card,
12
+ message,
13
+ Tag,
14
+ Typography,
15
+ Alert,
16
+ Collapse,
17
+ Empty,
18
+ Select,
19
+ } from 'antd';
20
+ import {
21
+ PlusOutlined,
22
+ EditOutlined,
23
+ DeleteOutlined,
24
+ SwapRightOutlined,
25
+ WarningOutlined,
26
+ ThunderboltOutlined,
27
+ } from '@ant-design/icons';
28
+ import { useApiClient as useAPIClient, useRequest } from '../hooks/useApiRequest';
29
+ import { AIEmployeeSelect } from './AIEmployeeSelect';
30
+ import { useAIEmployees } from './AIEmployeesContext';
31
+
32
+ const { Text } = Typography;
33
+
34
+ /**
35
+ * Mirrors server-side `sanitizeToolPart` in delegate-task.ts so we can compute
36
+ * the expected delegation tool names here and detect when the leader hasn't
37
+ * added them to its skillSettings.tools.
38
+ */
39
+ const sanitizeToolPart = (value: string) => (value || '').replace(/[^a-zA-Z0-9_-]/g, '_');
40
+ const expectedDelegateToolName = (leader: string, sub: string) =>
41
+ `delegate_${sanitizeToolPart(leader)}_to_${sanitizeToolPart(sub)}`;
42
+ const expectedDispatchToolName = (leader: string) => `dispatch_subagents_${sanitizeToolPart(leader)}`;
43
+ const controllerToolNames = [
44
+ 'orchestrator_plan_goal',
45
+ 'orchestrator_execute_plan',
46
+ 'orchestrator_status',
47
+ 'orchestrator_cancel',
48
+ ];
49
+ const toolLikeNames = new Set([...controllerToolNames, 'external_rag_search', 'skill_hub_execute']);
50
+
51
+ const isToolLikeName = (name: string) =>
52
+ toolLikeNames.has(name) ||
53
+ name.startsWith('delegate_') ||
54
+ name.startsWith('dispatch_subagents_') ||
55
+ name.startsWith('skill_hub_') ||
56
+ name.startsWith('browser_') ||
57
+ name.startsWith('drawio-');
58
+
59
+ const normalizeToolBinding = (value: any) => {
60
+ const name = typeof value === 'string' ? value : value?.name;
61
+ if (typeof name !== 'string' || !name.trim()) return null;
62
+ return {
63
+ name: name.trim(),
64
+ autoCall: value?.autoCall === true,
65
+ };
66
+ };
67
+
68
+ const normalizeSkillSettingsForTools = (skillSettings: any) => {
69
+ const source = skillSettings && typeof skillSettings === 'object' ? skillSettings : {};
70
+ const toolsByName = new Map<string, { name: string; autoCall: boolean }>();
71
+ const addTool = (tool: { name: string; autoCall: boolean } | null) => {
72
+ if (!tool || toolsByName.has(tool.name)) return;
73
+ toolsByName.set(tool.name, tool);
74
+ };
75
+
76
+ if (Array.isArray(source.tools)) {
77
+ for (const item of source.tools) {
78
+ addTool(normalizeToolBinding(item));
79
+ }
80
+ }
81
+
82
+ const nextSkills: string[] = [];
83
+ if (Array.isArray(source.skills)) {
84
+ for (const item of source.skills) {
85
+ if (typeof item === 'string') {
86
+ const name = item.trim();
87
+ if (!name) continue;
88
+ if (isToolLikeName(name)) {
89
+ addTool({ name, autoCall: false });
90
+ } else {
91
+ nextSkills.push(name);
92
+ }
93
+ continue;
94
+ }
95
+ addTool(normalizeToolBinding(item));
96
+ }
97
+ }
98
+
99
+ return {
100
+ ...source,
101
+ skills: nextSkills,
102
+ tools: Array.from(toolsByName.values()),
103
+ };
104
+ };
105
+
106
+ export const RulesTab: React.FC = () => {
107
+ const api = useAPIClient();
108
+ const [visible, setVisible] = useState(false);
109
+ const [editingRecord, setEditingRecord] = useState<any>(null);
110
+ const [form] = Form.useForm();
111
+
112
+ const { data, loading, refresh } = useRequest({
113
+ url: 'orchestratorConfig:list',
114
+ params: {
115
+ sort: ['-createdAt'],
116
+ },
117
+ });
118
+
119
+ const { data: llmServicesData, loading: llmLoading } = useRequest({
120
+ url: 'ai:listAllEnabledModels',
121
+ });
122
+
123
+ const { data: harnessProfilesData, loading: harnessLoading } = useRequest({
124
+ url: 'agentHarnessProfiles:list',
125
+ params: {
126
+ filter: { enabled: true },
127
+ sort: ['tag'],
128
+ pageSize: 100,
129
+ },
130
+ });
131
+
132
+ const llmServices = React.useMemo(() => {
133
+ const raw = (llmServicesData as any)?.data ?? llmServicesData;
134
+ if (Array.isArray(raw)) return raw;
135
+ return Array.isArray(raw?.data) ? raw.data : [];
136
+ }, [llmServicesData]);
137
+
138
+ const harnessProfiles = React.useMemo(() => {
139
+ const raw = (harnessProfilesData as any)?.data ?? harnessProfilesData;
140
+ if (Array.isArray(raw)) return raw;
141
+ return Array.isArray(raw?.data) ? raw.data : [];
142
+ }, [harnessProfilesData]);
143
+
144
+ // P3 FIX: Use shared context instead of duplicate API call
145
+ const { employeeMap, toolNamesMap, refresh: refreshEmployees } = useAIEmployees();
146
+ const rules = React.useMemo(() => {
147
+ const rows = (data as any)?.data;
148
+ return Array.isArray(rows) ? rows : [];
149
+ }, [data]);
150
+
151
+ const handleAddToolsToEmployee = async (employeeUsername: string, toolNames: string[]) => {
152
+ try {
153
+ // Re-fetch the leader to merge current tools and clean up legacy skillSettings.skills tool entries.
154
+ const leaderResp = await api.request({
155
+ url: 'aiEmployees:get',
156
+ params: { filterByTk: employeeUsername },
157
+ });
158
+ const leader = (leaderResp as any)?.data?.data;
159
+ if (!leader) {
160
+ message.error('Could not load AI employee.');
161
+ return;
162
+ }
163
+ const normalizedSkillSettings = normalizeSkillSettingsForTools(leader.skillSettings);
164
+ const existingNames = new Set(normalizedSkillSettings.tools.map((tool: { name: string }) => tool.name));
165
+ const missing = toolNames.filter((toolName) => !existingNames.has(toolName));
166
+ const hadLegacyToolBindings =
167
+ JSON.stringify(normalizedSkillSettings) !== JSON.stringify(leader.skillSettings || {});
168
+ if (!missing.length && !hadLegacyToolBindings) {
169
+ message.info('Tools already present.');
170
+ await refreshEmployees();
171
+ return;
172
+ }
173
+ const nextTools = [...normalizedSkillSettings.tools, ...missing.map((name) => ({ name, autoCall: false }))];
174
+ await api.request({
175
+ url: 'aiEmployees:update',
176
+ method: 'put',
177
+ params: { filterByTk: employeeUsername },
178
+ data: { skillSettings: { ...normalizedSkillSettings, tools: nextTools } },
179
+ });
180
+ message.success(
181
+ missing.length
182
+ ? `Added ${missing.length} tool${missing.length > 1 ? 's' : ''} to ${employeeUsername}.`
183
+ : `Normalized tool bindings for ${employeeUsername}.`,
184
+ );
185
+ await refreshEmployees();
186
+ } catch (e: any) {
187
+ message.error(`Auto-assign failed: ${e?.message || 'unknown error'}`);
188
+ }
189
+ };
190
+
191
+ const handleAddToolToEmployee = async (employeeUsername: string, toolName: string) => {
192
+ await handleAddToolsToEmployee(employeeUsername, [toolName]);
193
+ };
194
+
195
+ const handleAutoAssignTool = async (record: any) => {
196
+ await handleAddToolToEmployee(
197
+ record.leaderUsername,
198
+ expectedDelegateToolName(record.leaderUsername, record.subAgentUsername),
199
+ );
200
+ };
201
+
202
+ const handleAutoAssignDispatchTool = async (leaderUsername: string) => {
203
+ await handleAddToolToEmployee(leaderUsername, expectedDispatchToolName(leaderUsername));
204
+ };
205
+
206
+ const subAgentLeaderCount = React.useMemo(() => {
207
+ const counts = new Map<string, Set<string>>();
208
+ for (const rule of rules) {
209
+ const set = counts.get(rule.subAgentUsername) || new Set<string>();
210
+ set.add(rule.leaderUsername);
211
+ counts.set(rule.subAgentUsername, set);
212
+ }
213
+ return counts;
214
+ }, [rules]);
215
+
216
+ const aliasConflicts = React.useMemo(() => {
217
+ return Array.from(subAgentLeaderCount.entries())
218
+ .filter(([, leaders]) => leaders.size > 1)
219
+ .map(([sub, leaders]) => ({ sub, leaders: Array.from(leaders) }));
220
+ }, [subAgentLeaderCount]);
221
+
222
+ const groupedRules = React.useMemo(() => {
223
+ const groups = new Map<string, any[]>();
224
+ for (const rule of rules) {
225
+ const key = rule.leaderUsername || 'unknown';
226
+ let items = groups.get(key);
227
+ if (!items) {
228
+ items = [];
229
+ groups.set(key, items);
230
+ }
231
+ items.push(rule);
232
+ }
233
+
234
+ return Array.from(groups.entries()).map(([leaderUsername, items]) => ({
235
+ leaderUsername,
236
+ items,
237
+ }));
238
+ }, [rules]);
239
+
240
+ const handleOpen = (record?: any) => {
241
+ setEditingRecord(record);
242
+ if (record) {
243
+ form.setFieldsValue(record);
244
+ } else {
245
+ form.resetFields();
246
+ form.setFieldsValue({ enabled: true, maxDepth: 1, timeout: 120000, recursionLimit: 50, harnessTag: 'default' });
247
+ }
248
+ setVisible(true);
249
+ };
250
+
251
+ const handleClose = () => {
252
+ setVisible(false);
253
+ setEditingRecord(null);
254
+ };
255
+
256
+ const handleSave = async (values: any) => {
257
+ // Validate: leader !== subAgent
258
+ if (values.leaderUsername === values.subAgentUsername) {
259
+ message.error('Leader and Sub-Agent cannot be the same employee.');
260
+ return;
261
+ }
262
+
263
+ try {
264
+ if (editingRecord) {
265
+ await api.request({
266
+ url: 'orchestratorConfig:update',
267
+ method: 'put',
268
+ params: { filterByTk: editingRecord.id },
269
+ data: values,
270
+ });
271
+ message.success('Rule updated');
272
+ } else {
273
+ await api.request({
274
+ url: 'orchestratorConfig:create',
275
+ method: 'post',
276
+ data: values,
277
+ });
278
+ message.success('Rule created');
279
+ }
280
+ handleClose();
281
+ refresh();
282
+ } catch (e: any) {
283
+ const msg = e?.response?.data?.errors?.[0]?.message || e.message;
284
+ message.error(`Save failed: ${msg}`);
285
+ }
286
+ };
287
+
288
+ const handleDelete = async (id: string) => {
289
+ try {
290
+ await api.request({
291
+ url: 'orchestratorConfig:destroy',
292
+ method: 'delete',
293
+ params: { filterByTk: id },
294
+ });
295
+ message.success('Rule deleted');
296
+ refresh();
297
+ } catch (e: any) {
298
+ message.error(`Delete failed: ${e.message}`);
299
+ }
300
+ };
301
+
302
+ const columns = [
303
+ {
304
+ title: 'Leader (Orchestrator)',
305
+ dataIndex: 'leaderUsername',
306
+ key: 'leaderUsername',
307
+ render: (username: string) => <Tag color="blue">{employeeMap.get(username) || username}</Tag>,
308
+ },
309
+ {
310
+ title: '',
311
+ key: 'arrow',
312
+ width: 50,
313
+ render: () => <SwapRightOutlined style={{ color: '#999', fontSize: 18 }} />,
314
+ },
315
+ {
316
+ title: 'Sub-Agent',
317
+ dataIndex: 'subAgentUsername',
318
+ key: 'subAgentUsername',
319
+ render: (username: string) => <Tag color="green">{employeeMap.get(username) || username}</Tag>,
320
+ },
321
+ {
322
+ title: 'Harness',
323
+ dataIndex: 'harnessTag',
324
+ key: 'harnessTag',
325
+ width: 120,
326
+ render: (tag: string) => <Tag color="purple">{tag || 'default'}</Tag>,
327
+ },
328
+ {
329
+ title: 'Max Depth',
330
+ dataIndex: 'maxDepth',
331
+ key: 'maxDepth',
332
+ width: 100,
333
+ render: (v: number) => v ?? 1,
334
+ },
335
+ {
336
+ title: 'Timeout',
337
+ dataIndex: 'timeout',
338
+ key: 'timeout',
339
+ width: 100,
340
+ render: (v: number) => `${((v ?? 120000) / 1000).toFixed(0)}s`,
341
+ },
342
+ {
343
+ title: 'LLM Override',
344
+ key: 'llmOverride',
345
+ width: 140,
346
+ render: (_: any, record: any) => {
347
+ if (record.llmService && record.model) {
348
+ const svc = llmServices.find((s: any) => s.llmService === record.llmService);
349
+ const svcName = svc ? svc.llmServiceTitle : record.llmService;
350
+ return (
351
+ <Space direction="vertical" size={0}>
352
+ <Text style={{ fontSize: 12 }}>{svcName}</Text>
353
+ <Text type="secondary" style={{ fontSize: 12 }}>
354
+ {record.model}
355
+ </Text>
356
+ </Space>
357
+ );
358
+ }
359
+ return (
360
+ <Text type="secondary" style={{ fontSize: 12 }}>
361
+ Inherited
362
+ </Text>
363
+ );
364
+ },
365
+ },
366
+ {
367
+ title: 'Enabled',
368
+ dataIndex: 'enabled',
369
+ key: 'enabled',
370
+ width: 80,
371
+ render: (enabled: boolean, record: any) => (
372
+ <Switch
373
+ checked={enabled}
374
+ size="small"
375
+ onChange={async (checked) => {
376
+ await api.request({
377
+ url: 'orchestratorConfig:update',
378
+ method: 'put',
379
+ params: { filterByTk: record.id },
380
+ data: { enabled: checked },
381
+ });
382
+ refresh();
383
+ }}
384
+ />
385
+ ),
386
+ },
387
+ {
388
+ title: 'Tool',
389
+ key: 'tool',
390
+ width: 150,
391
+ render: (_: any, record: any) => {
392
+ const expected = expectedDelegateToolName(record.leaderUsername, record.subAgentUsername);
393
+ const leaderTools = toolNamesMap.get(record.leaderUsername);
394
+ if (!leaderTools) {
395
+ return (
396
+ <Text type="secondary" style={{ fontSize: 12 }}>
397
+
398
+ </Text>
399
+ );
400
+ }
401
+ const present = leaderTools.has(expected);
402
+ if (present) {
403
+ return <Tag color="success">Assigned</Tag>;
404
+ }
405
+ return (
406
+ <Space size={4}>
407
+ <Tag icon={<WarningOutlined />} color="warning">
408
+ Missing
409
+ </Tag>
410
+ <Button
411
+ type="link"
412
+ size="small"
413
+ icon={<ThunderboltOutlined />}
414
+ onClick={() => handleAutoAssignTool(record)}
415
+ >
416
+ Auto-add
417
+ </Button>
418
+ </Space>
419
+ );
420
+ },
421
+ },
422
+ {
423
+ title: 'Actions',
424
+ key: 'actions',
425
+ width: 160,
426
+ render: (_: any, record: any) => (
427
+ <Space>
428
+ <Button type="link" size="small" icon={<EditOutlined />} onClick={() => handleOpen(record)}>
429
+ Edit
430
+ </Button>
431
+ <Popconfirm title="Delete this rule?" onConfirm={() => handleDelete(record.id)}>
432
+ <Button type="link" size="small" danger icon={<DeleteOutlined />}>
433
+ Delete
434
+ </Button>
435
+ </Popconfirm>
436
+ </Space>
437
+ ),
438
+ },
439
+ ];
440
+
441
+ const leaderUsername = Form.useWatch('leaderUsername', form);
442
+
443
+ const missingToolCount = React.useMemo(() => {
444
+ return rules.reduce((acc: number, r: any) => {
445
+ const leaderTools = toolNamesMap.get(r.leaderUsername);
446
+ if (!leaderTools) return acc;
447
+ const expected = expectedDelegateToolName(r.leaderUsername, r.subAgentUsername);
448
+ return leaderTools.has(expected) ? acc : acc + 1;
449
+ }, 0);
450
+ }, [rules, toolNamesMap]);
451
+
452
+ const missingDispatchTools = React.useMemo(() => {
453
+ return groupedRules
454
+ .map((group) => {
455
+ const leaderTools = toolNamesMap.get(group.leaderUsername);
456
+ if (!leaderTools) return null;
457
+ const toolName = expectedDispatchToolName(group.leaderUsername);
458
+ return leaderTools.has(toolName)
459
+ ? null
460
+ : { leaderUsername: group.leaderUsername, toolName, count: group.items.length };
461
+ })
462
+ .filter(Boolean) as Array<{ leaderUsername: string; toolName: string; count: number }>;
463
+ }, [groupedRules, toolNamesMap]);
464
+
465
+ const missingControllerTools = React.useMemo(() => {
466
+ return groupedRules
467
+ .map((group) => {
468
+ const leaderTools = toolNamesMap.get(group.leaderUsername);
469
+ if (!leaderTools) return null;
470
+ const missing = controllerToolNames.filter((toolName) => !leaderTools.has(toolName));
471
+ return missing.length ? { leaderUsername: group.leaderUsername, missing } : null;
472
+ })
473
+ .filter(Boolean) as Array<{ leaderUsername: string; missing: string[] }>;
474
+ }, [groupedRules, toolNamesMap]);
475
+
476
+ return (
477
+ <div>
478
+ <Alert
479
+ type="info"
480
+ showIcon
481
+ style={{ marginBottom: 16 }}
482
+ message="Orchestration Rules"
483
+ description={
484
+ <Text type="secondary">
485
+ Configure which AI Employees can act as Leaders (Orchestrators) and which ones they can delegate tasks to.
486
+ Each rule creates a callable tool for the Leader to invoke the Sub-Agent.
487
+ </Text>
488
+ }
489
+ />
490
+
491
+ {missingToolCount > 0 && (
492
+ <Alert
493
+ type="warning"
494
+ showIcon
495
+ style={{ marginBottom: 16 }}
496
+ message={`${missingToolCount} rule${missingToolCount > 1 ? 's' : ''} missing required tool assignment`}
497
+ description={
498
+ <Text type="secondary">
499
+ The Leader employee hasn&apos;t added the corresponding{' '}
500
+ <Text code>delegate_&lt;leader&gt;_to_&lt;sub&gt;</Text> tool to its skillSettings.tools, so the LLM
501
+ cannot actually call these sub-agents. Use the <b>Auto-add</b> button in the Tool column to fix.
502
+ </Text>
503
+ }
504
+ />
505
+ )}
506
+
507
+ {missingControllerTools.length > 0 && (
508
+ <Alert
509
+ type="warning"
510
+ showIcon
511
+ style={{ marginBottom: 16 }}
512
+ message={`${missingControllerTools.length} leader${
513
+ missingControllerTools.length > 1 ? 's' : ''
514
+ } missing orchestrator controller tools`}
515
+ description={
516
+ <Space direction="vertical" size={6}>
517
+ <Text type="secondary">
518
+ Leaders need the orchestrator controller tools to create an approval-first plan and execute it after the
519
+ user accepts the card.
520
+ </Text>
521
+ {missingControllerTools.map(({ leaderUsername, missing }) => (
522
+ <Space key={leaderUsername} size={8} wrap>
523
+ <Tag color="blue">{employeeMap.get(leaderUsername) || leaderUsername}</Tag>
524
+ <Text type="secondary">{missing.length} missing</Text>
525
+ <Button
526
+ type="link"
527
+ size="small"
528
+ icon={<ThunderboltOutlined />}
529
+ onClick={() => handleAddToolsToEmployee(leaderUsername, missing)}
530
+ >
531
+ Auto-add
532
+ </Button>
533
+ </Space>
534
+ ))}
535
+ </Space>
536
+ }
537
+ />
538
+ )}
539
+
540
+ {missingDispatchTools.length > 0 && (
541
+ <Alert
542
+ type="warning"
543
+ showIcon
544
+ style={{ marginBottom: 16 }}
545
+ message={`${missingDispatchTools.length} leader${
546
+ missingDispatchTools.length > 1 ? 's' : ''
547
+ } missing dispatch tool assignment`}
548
+ description={
549
+ <Space direction="vertical" size={6}>
550
+ <Text type="secondary">
551
+ The fan-out tool lets a Leader dispatch multiple independent sub-tasks in one call. Add it to the
552
+ Leader&apos;s tools to enable the new multi-agent flow.
553
+ </Text>
554
+ {missingDispatchTools.map(({ leaderUsername, toolName, count }) => (
555
+ <Space key={leaderUsername} size={8} wrap>
556
+ <Tag color="blue">{employeeMap.get(leaderUsername) || leaderUsername}</Tag>
557
+ <Text type="secondary">
558
+ {count} sub-agent{count > 1 ? 's' : ''}
559
+ </Text>
560
+ <Text code>{toolName}</Text>
561
+ <Button
562
+ type="link"
563
+ size="small"
564
+ icon={<ThunderboltOutlined />}
565
+ onClick={() => handleAutoAssignDispatchTool(leaderUsername)}
566
+ >
567
+ Auto-add
568
+ </Button>
569
+ </Space>
570
+ ))}
571
+ </Space>
572
+ }
573
+ />
574
+ )}
575
+
576
+ {aliasConflicts.length > 0 && (
577
+ <Alert
578
+ type="warning"
579
+ showIcon
580
+ style={{ marginBottom: 16 }}
581
+ message="Legacy delegate_to_<sub> alias is no longer registered for these sub-agents"
582
+ description={
583
+ <Space direction="vertical" size={2}>
584
+ {aliasConflicts.map(({ sub, leaders }) => (
585
+ <Text key={sub} type="secondary">
586
+ <Tag color="green">{employeeMap.get(sub) || sub}</Tag>
587
+ has multiple leaders ({leaders.map((l) => employeeMap.get(l) || l).join(', ')}). The legacy alias is
588
+ dropped to avoid ambiguity — leaders must use <Text code>delegate_&lt;leader&gt;_to_&lt;sub&gt;</Text>{' '}
589
+ in their tools.
590
+ </Text>
591
+ ))}
592
+ </Space>
593
+ }
594
+ />
595
+ )}
596
+
597
+ <Card bordered={false}>
598
+ <div style={{ marginBottom: 16, display: 'flex', justifyContent: 'flex-end' }}>
599
+ <Button type="primary" icon={<PlusOutlined />} onClick={() => handleOpen()}>
600
+ New Rule
601
+ </Button>
602
+ </div>
603
+ {groupedRules.length ? (
604
+ <Collapse
605
+ bordered={false}
606
+ defaultActiveKey={groupedRules.map((group) => group.leaderUsername)}
607
+ items={groupedRules.map((group) => ({
608
+ key: group.leaderUsername,
609
+ label: (
610
+ <Space>
611
+ <Tag color="blue">{employeeMap.get(group.leaderUsername) || group.leaderUsername}</Tag>
612
+ <Text type="secondary">
613
+ {group.items.length} sub-agent{group.items.length > 1 ? 's' : ''}
614
+ </Text>
615
+ {missingDispatchTools.some((item) => item.leaderUsername === group.leaderUsername) && (
616
+ <Tag color="warning">Dispatch missing</Tag>
617
+ )}
618
+ </Space>
619
+ ),
620
+ children: (
621
+ <Table
622
+ rowKey="id"
623
+ loading={loading}
624
+ dataSource={group.items}
625
+ columns={columns}
626
+ pagination={false}
627
+ size="middle"
628
+ scroll={{ x: 'max-content' }}
629
+ />
630
+ ),
631
+ }))}
632
+ />
633
+ ) : (
634
+ <Table
635
+ rowKey="id"
636
+ loading={loading}
637
+ dataSource={[]}
638
+ columns={columns}
639
+ pagination={false}
640
+ size="middle"
641
+ scroll={{ x: 'max-content' }}
642
+ locale={{ emptyText: <Empty description="No orchestration rules yet" /> }}
643
+ />
644
+ )}
645
+ </Card>
646
+
647
+ <Drawer
648
+ title={editingRecord ? 'Edit Orchestration Rule' : 'New Orchestration Rule'}
649
+ width={480}
650
+ onClose={handleClose}
651
+ open={visible}
652
+ styles={{ body: { paddingBottom: 80 } }}
653
+ extra={
654
+ <Space>
655
+ <Button onClick={handleClose}>Cancel</Button>
656
+ <Button onClick={() => form.submit()} type="primary">
657
+ Save
658
+ </Button>
659
+ </Space>
660
+ }
661
+ >
662
+ <Form form={form} layout="vertical" onFinish={handleSave}>
663
+ <Form.Item
664
+ name="leaderUsername"
665
+ label="Leader (Orchestrator)"
666
+ rules={[{ required: true, message: 'Please select a Leader' }]}
667
+ tooltip="The AI Employee that will be able to delegate tasks to the Sub-Agent"
668
+ >
669
+ <AIEmployeeSelect placeholder="Select Leader AI Employee..." />
670
+ </Form.Item>
671
+
672
+ <Form.Item
673
+ name="subAgentUsername"
674
+ label="Sub-Agent"
675
+ rules={[{ required: true, message: 'Please select a Sub-Agent' }]}
676
+ tooltip="The AI Employee that will receive delegated tasks"
677
+ >
678
+ <AIEmployeeSelect placeholder="Select Sub-Agent AI Employee..." exclude={leaderUsername} />
679
+ </Form.Item>
680
+
681
+ <Form.Item
682
+ name="maxDepth"
683
+ label="Max Delegation Depth"
684
+ tooltip="How many layers of delegation are allowed (1 = leader calls sub-agent, sub-agent cannot delegate further)"
685
+ >
686
+ <InputNumber min={1} max={3} style={{ width: '100%' }} />
687
+ </Form.Item>
688
+
689
+ <Form.Item
690
+ name="timeout"
691
+ label="Timeout (ms)"
692
+ tooltip="Maximum time in milliseconds for the sub-agent to complete its task"
693
+ >
694
+ <InputNumber min={10000} max={600000} step={10000} style={{ width: '100%' }} />
695
+ </Form.Item>
696
+
697
+ <Form.Item
698
+ name="recursionLimit"
699
+ label="Recursion Limit"
700
+ tooltip="Max LangGraph reasoning steps per delegation. Higher = more complex multi-step tasks; lower = stricter cap on token usage. Default 50."
701
+ >
702
+ <InputNumber min={5} max={200} step={5} style={{ width: '100%' }} />
703
+ </Form.Item>
704
+
705
+ <Form.Item
706
+ name="harnessTag"
707
+ label="Harness Profile"
708
+ tooltip="Profile tag used by plan approval, controller limits, and orchestration policy."
709
+ >
710
+ <Select
711
+ loading={harnessLoading}
712
+ options={[
713
+ { label: 'default', value: 'default' },
714
+ ...harnessProfiles
715
+ .filter((profile: any) => profile.tag !== 'default')
716
+ .map((profile: any) => ({
717
+ label: profile.title ? `${profile.tag} - ${profile.title}` : profile.tag,
718
+ value: profile.tag,
719
+ })),
720
+ ]}
721
+ />
722
+ </Form.Item>
723
+
724
+ <Form.Item
725
+ name="llmService"
726
+ label="Override LLM Service"
727
+ tooltip="Optional: Provider name. Leave empty to inherit from Leader."
728
+ >
729
+ <Select
730
+ allowClear
731
+ placeholder="Inherit from Leader"
732
+ loading={llmLoading}
733
+ options={llmServices.map((svc: any) => ({
734
+ label: svc.llmServiceTitle || svc.llmService,
735
+ value: svc.llmService,
736
+ }))}
737
+ onChange={() => form.setFieldValue('model', undefined)}
738
+ />
739
+ </Form.Item>
740
+
741
+ <Form.Item
742
+ noStyle
743
+ shouldUpdate={(prevValues, currentValues) => prevValues.llmService !== currentValues.llmService}
744
+ >
745
+ {() => {
746
+ const selectedServiceId = form.getFieldValue('llmService');
747
+ const selectedService = llmServices.find((s: any) => s.llmService === selectedServiceId);
748
+ const availableModels = Array.isArray(selectedService?.enabledModels)
749
+ ? selectedService.enabledModels
750
+ : [];
751
+
752
+ return (
753
+ <Form.Item
754
+ name="model"
755
+ label="Override Model"
756
+ tooltip="Optional: Model name. Leave empty to inherit from Leader."
757
+ rules={[{ required: !!selectedServiceId, message: 'Please select a model' }]}
758
+ >
759
+ <Select
760
+ allowClear
761
+ placeholder={selectedServiceId ? 'Select a model' : 'Inherit from Leader'}
762
+ disabled={!selectedServiceId}
763
+ options={availableModels.map((m: any) => ({
764
+ label: m.label,
765
+ value: m.value,
766
+ }))}
767
+ />
768
+ </Form.Item>
769
+ );
770
+ }}
771
+ </Form.Item>
772
+
773
+ <Form.Item name="enabled" label="Enabled" valuePropName="checked">
774
+ <Switch />
775
+ </Form.Item>
776
+ </Form>
777
+ </Drawer>
778
+ </div>
779
+ );
780
+ };
781
+
782
+ export default RulesTab;