plugin-agent-orchestrator 1.1.4 → 1.1.6

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 (148) hide show
  1. package/README.md +204 -114
  2. package/dist/client/index.js +1 -1
  3. package/dist/client-v2/117.7565cff57c39318a.js +10 -0
  4. package/dist/client-v2/214.106635011859dede.js +10 -0
  5. package/dist/client-v2/418.41ed200e7d6da332.js +10 -0
  6. package/dist/client-v2/53.349fff8db80b19d4.js +10 -0
  7. package/dist/client-v2/981.e4a1f41cfc94a856.js +10 -0
  8. package/dist/client-v2/index.js +1 -1
  9. package/dist/externalVersion.js +7 -8
  10. package/dist/locale/en-US.json +226 -170
  11. package/dist/locale/vi-VN.json +226 -170
  12. package/dist/locale/zh-CN.json +226 -170
  13. package/dist/server/collections/agent-execution-spans.js +8 -0
  14. package/dist/server/collections/agent-loop-action-approvals.js +1 -0
  15. package/dist/server/collections/agent-loop-runs.js +7 -1
  16. package/dist/server/collections/agent-loop-steps.js +7 -0
  17. package/dist/server/collections/skill-executions.js +8 -0
  18. package/dist/server/plugin.js +3 -1
  19. package/dist/server/resources/agent-harness-profile.js +117 -0
  20. package/dist/server/resources/agent-knowledge-insights.js +1 -3
  21. package/dist/server/resources/agent-loop-approval.js +25 -0
  22. package/dist/server/resources/agent-loop.js +3 -1
  23. package/dist/server/services/AgentMemoryContextService.js +34 -0
  24. package/dist/server/services/HarnessCompiler.js +35 -2
  25. package/dist/server/services/HarnessProfileService.js +74 -9
  26. package/dist/server/services/HarnessSchema.js +30 -3
  27. package/dist/server/services/LoopPatternSchema.js +16 -1
  28. package/dist/server/services/LoopRunRepository.js +80 -0
  29. package/dist/server/services/LoopRunStateMachine.js +92 -3
  30. package/dist/server/services/LoopTriggerService.js +37 -0
  31. package/dist/server/services/LoopWorkerService.js +261 -23
  32. package/dist/server/services/NativeSubAgentObserver.js +165 -23
  33. package/dist/server/services/PluginAiRuntimeAdapter.js +16 -5
  34. package/dist/server/services/ToolLoopDetectionService.js +210 -0
  35. package/dist/server/services/VerificationService.js +66 -0
  36. package/dist/server/services/harness-runtime-policy.js +139 -0
  37. package/dist/server/skill-hub/plugin.js +36 -3
  38. package/dist/server/skill-hub/tasks/SkillExecutionTask.js +29 -0
  39. package/package.json +53 -53
  40. package/src/client/ApprovalsTab.tsx +2 -0
  41. package/src/client/OrchestratorSettings.tsx +11 -0
  42. package/src/client/skill-hub/components/GitSkillImport.tsx +3 -3
  43. package/src/client/skill-hub/components/SkillMetrics.tsx +15 -10
  44. package/src/client/skill-hub/index.tsx +0 -52
  45. package/src/client-v2/components/AgentRunsTab.tsx +576 -576
  46. package/src/client-v2/components/ApprovalsTab.tsx +337 -0
  47. package/src/client-v2/components/HarnessProfilesTab.tsx +385 -105
  48. package/src/client-v2/components/MemoryInspectorTab.tsx +141 -141
  49. package/src/client-v2/components/TracingTab.tsx +515 -515
  50. package/src/client-v2/hooks/useApiRequest.ts +141 -141
  51. package/src/client-v2/pages/ApprovalsPage.tsx +10 -0
  52. package/src/client-v2/plugin.tsx +6 -6
  53. package/src/client-v2/skill-hub/components/SkillMetrics.tsx +5 -2
  54. package/src/locale/en-US.json +226 -174
  55. package/src/locale/vi-VN.json +226 -174
  56. package/src/locale/zh-CN.json +226 -174
  57. package/src/server/__tests__/circuit-breaker.test.ts +248 -248
  58. package/src/server/__tests__/harness-compiler.test.ts +83 -0
  59. package/src/server/__tests__/harness-profile-service.test.ts +51 -0
  60. package/src/server/__tests__/harness-runtime-policy.test.ts +293 -0
  61. package/src/server/__tests__/harness-tool-plan.test.ts +24 -0
  62. package/src/server/__tests__/loop-approval-decision.test.ts +512 -0
  63. package/src/server/__tests__/loop-approval-expiry.test.ts +258 -0
  64. package/src/server/__tests__/loop-budget-service.test.ts +255 -255
  65. package/src/server/__tests__/loop-control-plane-backfill.test.ts +266 -266
  66. package/src/server/__tests__/loop-pattern-schema.test.ts +18 -1
  67. package/src/server/__tests__/loop-pattern-service.test.ts +148 -148
  68. package/src/server/__tests__/loop-run-state-machine.test.ts +11 -0
  69. package/src/server/__tests__/loop-trigger-service.test.ts +148 -0
  70. package/src/server/__tests__/loop-worker-claim.test.ts +341 -341
  71. package/src/server/__tests__/loop-worker-execution.test.ts +82 -1
  72. package/src/server/__tests__/native-sub-agent-observer.test.ts +288 -4
  73. package/src/server/__tests__/path-lock-service.test.ts +254 -254
  74. package/src/server/__tests__/skill-execution-task-policy.test.ts +140 -0
  75. package/src/server/__tests__/smoke.test.ts +162 -162
  76. package/src/server/__tests__/tool-loop-detection.test.ts +275 -0
  77. package/src/server/collections/agent-execution-spans.ts +8 -0
  78. package/src/server/collections/agent-harness-profile-versions.ts +26 -26
  79. package/src/server/collections/agent-harness-profiles.ts +71 -71
  80. package/src/server/collections/agent-loop-action-approvals.ts +1 -0
  81. package/src/server/collections/agent-loop-artifacts.ts +25 -25
  82. package/src/server/collections/agent-loop-circuit-states.ts +23 -23
  83. package/src/server/collections/agent-loop-control-settings.ts +21 -21
  84. package/src/server/collections/agent-loop-events.ts +98 -98
  85. package/src/server/collections/agent-loop-path-locks.ts +27 -27
  86. package/src/server/collections/agent-loop-patterns.ts +42 -42
  87. package/src/server/collections/agent-loop-runs.ts +7 -1
  88. package/src/server/collections/agent-loop-steps.ts +7 -0
  89. package/src/server/collections/agent-loop-usage-buckets.ts +22 -22
  90. package/src/server/collections/agent-loop-worktrees.ts +25 -25
  91. package/src/server/collections/skill-executions.ts +8 -0
  92. package/src/server/migrations/20260427000002-change-packages-to-text.ts +52 -52
  93. package/src/server/migrations/20260429000000-add-llm-fields.ts +47 -47
  94. package/src/server/migrations/20260429000001-fix-inputargs-json-to-text.ts +45 -45
  95. package/src/server/migrations/20260503000000-add-orchestrator-trace-fields.ts +33 -33
  96. package/src/server/migrations/20260524000000-add-agent-loop-fields-to-skill-executions.ts +31 -31
  97. package/src/server/migrations/20260803010000-backfill-loop-control-plane-data.ts +293 -293
  98. package/src/server/plugin.ts +3 -1
  99. package/src/server/resources/agent-harness-profile.ts +94 -0
  100. package/src/server/resources/agent-knowledge-insights.ts +5 -3
  101. package/src/server/resources/agent-loop-approval.ts +32 -0
  102. package/src/server/resources/agent-loop-artifact.ts +56 -56
  103. package/src/server/resources/agent-loop-events-stream.ts +105 -105
  104. package/src/server/resources/agent-loop.ts +3 -1
  105. package/src/server/resources/resource-helpers.ts +33 -33
  106. package/src/server/resources/tracing.ts +266 -266
  107. package/src/server/services/AgentMemoryContextService.ts +44 -0
  108. package/src/server/services/DurableCircuitBreakerService.ts +239 -239
  109. package/src/server/services/ExecutionSpanService.ts +2 -0
  110. package/src/server/services/HarnessCompiler.ts +37 -0
  111. package/src/server/services/HarnessProfileService.ts +92 -10
  112. package/src/server/services/HarnessSchema.ts +31 -0
  113. package/src/server/services/LoopBudgetService.ts +275 -275
  114. package/src/server/services/LoopControlService.ts +124 -124
  115. package/src/server/services/LoopPatternSchema.ts +19 -1
  116. package/src/server/services/LoopPatternService.ts +143 -143
  117. package/src/server/services/LoopRunRepository.ts +99 -0
  118. package/src/server/services/LoopRunStateMachine.ts +100 -3
  119. package/src/server/services/LoopSchedulerService.ts +199 -199
  120. package/src/server/services/LoopTriggerService.ts +42 -0
  121. package/src/server/services/LoopWorkerService.ts +327 -27
  122. package/src/server/services/NativeSubAgentObserver.ts +186 -21
  123. package/src/server/services/PathLockService.ts +321 -321
  124. package/src/server/services/PluginAiRuntimeAdapter.ts +24 -7
  125. package/src/server/services/ToolLoopDetectionService.ts +213 -0
  126. package/src/server/services/VerificationSchema.ts +31 -31
  127. package/src/server/services/VerificationService.ts +81 -2
  128. package/src/server/services/harness-runtime-policy.ts +141 -0
  129. package/src/server/skill-hub/plugin.ts +41 -3
  130. package/src/server/skill-hub/services/RegistrySkillSnapshotService.ts +235 -235
  131. package/src/server/skill-hub/services/__tests__/RegistrySkillSnapshotService.test.ts +61 -61
  132. package/src/server/skill-hub/tasks/SkillExecutionTask.ts +43 -2
  133. package/src/server/utils/ensure-indexes.ts +96 -96
  134. package/src/server/utils/logging.ts +62 -62
  135. package/src/server/utils/loop-pattern-context.ts +20 -20
  136. package/dist/client-v2/214.b063f33ba044a808.js +0 -10
  137. package/dist/client-v2/373.f5d5292e53c4e832.js +0 -10
  138. package/dist/client-v2/418.58fa350f5496efd3.js +0 -10
  139. package/dist/client-v2/53.9a10455323390f14.js +0 -10
  140. package/dist/client-v2/677.a991ce0250ff5c77.js +0 -10
  141. package/dist/client-v2/925.e5925bf21ed68e7a.js +0 -10
  142. package/src/client/AIEmployeeSelect.tsx +0 -47
  143. package/src/client/AIEmployeesContext.tsx +0 -102
  144. package/src/client/RulesTab.tsx +0 -2
  145. package/src/client/TracingTab.tsx +0 -436
  146. package/src/client/skill-hub/components/ExecutionProgress.tsx +0 -51
  147. package/src/client-v2/components/RulesTab.tsx +0 -2
  148. package/src/client-v2/pages/AgentRunsPage.tsx +0 -13
@@ -1,515 +1,515 @@
1
- import React, { useMemo, useRef, useState } from 'react';
2
- import type { Dayjs } from 'dayjs';
3
- import {
4
- Table,
5
- Card,
6
- Tag,
7
- Typography,
8
- Drawer,
9
- Descriptions,
10
- Alert,
11
- Button,
12
- Empty,
13
- Space,
14
- Timeline,
15
- Collapse,
16
- Spin,
17
- Select,
18
- DatePicker,
19
- Form,
20
- message,
21
- } from 'antd';
22
- import {
23
- EyeOutlined,
24
- CheckCircleOutlined,
25
- CloseCircleOutlined,
26
- SyncOutlined,
27
- ClockCircleOutlined,
28
- ReloadOutlined,
29
- } from '@ant-design/icons';
30
- import { useApiClient as useAPIClient, useRequest } from '../hooks/useApiRequest';
31
- import { useAIEmployees } from './AIEmployeesContext';
32
- import { useT } from '../skill-hub/locale';
33
-
34
- const { Text, Paragraph } = Typography;
35
- const { RangePicker } = DatePicker;
36
-
37
- type TraceItem = {
38
- type?: string;
39
- at?: string;
40
- title?: string;
41
- toolName?: string;
42
- status?: string;
43
- content?: string;
44
- args?: unknown;
45
- skillExecutionId?: number;
46
- };
47
-
48
- type TraceMessage = {
49
- index: number;
50
- type?: string;
51
- content?: string;
52
- toolCalls?: unknown[];
53
- };
54
-
55
- type TracingLog = {
56
- id: number | string;
57
- createdAt?: string;
58
- leaderUsername?: string;
59
- subAgentUsername?: string;
60
- toolName?: string;
61
- task?: string;
62
- context?: string;
63
- status?: string;
64
- durationMs?: number;
65
- depth?: number;
66
- result?: string;
67
- error?: string;
68
- hasUnifiedTrace?: boolean;
69
- trace?: TraceItem[];
70
- messages?: TraceMessage[];
71
- };
72
-
73
- type FilterState = {
74
- leader?: string;
75
- subAgent?: string;
76
- status?: string;
77
- range?: [Dayjs | null, Dayjs | null] | null;
78
- };
79
-
80
- function statusIcon(status?: string) {
81
- if (status === 'success') return <CheckCircleOutlined />;
82
- if (status === 'error') return <CloseCircleOutlined />;
83
- if (status === 'running') return <SyncOutlined spin />;
84
- return <ClockCircleOutlined />;
85
- }
86
-
87
- function statusColor(status?: string) {
88
- if (status === 'success') return 'success';
89
- if (status === 'error') return 'error';
90
- if (status === 'running') return 'processing';
91
- return 'default';
92
- }
93
-
94
- export const TracingTab: React.FC = () => {
95
- const api = useAPIClient();
96
- const t = useT();
97
- const [selectedLog, setSelectedLog] = useState<TracingLog | null>(null);
98
- const [detailLoading, setDetailLoading] = useState(false);
99
- // Guards the detail drawer against out-of-order responses when the user
100
- // switches rows quickly: only the newest request may commit its result.
101
- const detailRequestId = useRef(0);
102
-
103
- const [page, setPage] = useState(1);
104
- const [pageSize, setPageSize] = useState(20);
105
- const [filters, setFilters] = useState<FilterState>({});
106
-
107
- const { employees, employeeMap } = useAIEmployees();
108
-
109
- const requestParams = useMemo(() => {
110
- const filter: Record<string, unknown> = {};
111
- if (filters.leader) filter.leaderUsername = filters.leader;
112
- if (filters.subAgent) filter.subAgentUsername = filters.subAgent;
113
- if (filters.status) filter.status = filters.status;
114
- if (filters.range && (filters.range[0] || filters.range[1])) {
115
- const createdAt: Record<string, string> = {};
116
- if (filters.range[0]) createdAt.$gte = filters.range[0].toDate().toISOString();
117
- if (filters.range[1]) createdAt.$lte = filters.range[1].toDate().toISOString();
118
- filter.createdAt = createdAt;
119
- }
120
- return {
121
- sort: ['-createdAt'],
122
- page,
123
- pageSize,
124
- filter,
125
- };
126
- }, [page, pageSize, filters]);
127
-
128
- const { data, loading, refresh } = useRequest<{ data?: TracingLog[]; meta?: { count?: number } }>(
129
- {
130
- url: 'orchestratorTracing:list',
131
- params: requestParams,
132
- },
133
- {
134
- refreshDeps: [requestParams],
135
- },
136
- );
137
-
138
- // Server returns { data: rows, meta: { count } }; useRequest unwraps to that shape.
139
- const logs = useMemo(() => {
140
- const rows = data?.data;
141
- return Array.isArray(rows) ? rows : [];
142
- }, [data]);
143
-
144
- const total = useMemo(() => {
145
- const count = data?.meta?.count;
146
- return typeof count === 'number' ? count : 0;
147
- }, [data]);
148
-
149
- const formatDuration = (ms?: number) => {
150
- if (!ms) return '-';
151
- return ms >= 1000 ? `${(ms / 1000).toFixed(1)}s` : `${ms}ms`;
152
- };
153
-
154
- const handleOpenLog = async (record: TracingLog) => {
155
- const requestId = ++detailRequestId.current;
156
- setSelectedLog(record);
157
- setDetailLoading(true);
158
- try {
159
- const res = await api.request({
160
- url: 'orchestratorTracing:get',
161
- params: { filterByTk: record.id, source: record.hasUnifiedTrace ? 'span' : 'log' },
162
- });
163
- if (requestId !== detailRequestId.current) return;
164
- const payload = res as { data?: { data?: { data?: TracingLog } | TracingLog } };
165
- const detail =
166
- (payload?.data?.data as { data?: TracingLog })?.data || (payload?.data?.data as TracingLog) || record;
167
- setSelectedLog(detail);
168
- } catch (error) {
169
- if (requestId !== detailRequestId.current) return;
170
- const text =
171
- (error as { response?: { data?: { errors?: Array<{ message?: string }> } }; message?: string })?.response?.data
172
- ?.errors?.[0]?.message ||
173
- (error as { message?: string })?.message ||
174
- t('Failed to load execution detail');
175
- message.error(text);
176
- } finally {
177
- if (requestId === detailRequestId.current) {
178
- setDetailLoading(false);
179
- }
180
- }
181
- };
182
-
183
- const updateFilter = (patch: Partial<FilterState>) => {
184
- setFilters((prev) => ({ ...prev, ...patch }));
185
- setPage(1);
186
- };
187
-
188
- const resetFilters = () => {
189
- setFilters({});
190
- setPage(1);
191
- };
192
-
193
- const employeeOptions = useMemo(
194
- () =>
195
- employees.map((e) => ({
196
- label: e.nickname || e.username,
197
- value: e.username,
198
- })),
199
- [employees],
200
- );
201
-
202
- const hasFilters = Boolean(
203
- filters.leader || filters.subAgent || filters.status || (filters.range && (filters.range[0] || filters.range[1])),
204
- );
205
-
206
- const columns = [
207
- {
208
- title: t('Time'),
209
- dataIndex: 'createdAt',
210
- key: 'createdAt',
211
- width: 170,
212
- render: (v: string) => (v ? new Date(v).toLocaleString() : '-'),
213
- },
214
- {
215
- title: t('Leader'),
216
- dataIndex: 'leaderUsername',
217
- key: 'leaderUsername',
218
- render: (username: string) => <Tag color="blue">{employeeMap.get(username) || username}</Tag>,
219
- },
220
- {
221
- title: t('Sub-Agent'),
222
- dataIndex: 'subAgentUsername',
223
- key: 'subAgentUsername',
224
- render: (username: string) => <Tag color="green">{employeeMap.get(username) || username}</Tag>,
225
- },
226
- {
227
- title: t('Task'),
228
- dataIndex: 'task',
229
- key: 'task',
230
- render: (task: string) => (
231
- <Text ellipsis style={{ maxWidth: 280 }}>
232
- {task?.substring(0, 100) || '-'}
233
- </Text>
234
- ),
235
- },
236
- {
237
- title: t('Status'),
238
- dataIndex: 'status',
239
- key: 'status',
240
- width: 90,
241
- render: (status: string) => (
242
- <Tag icon={statusIcon(status)} color={statusColor(status)}>
243
- {status ? t(status) : '-'}
244
- </Tag>
245
- ),
246
- },
247
- {
248
- title: t('Duration'),
249
- dataIndex: 'durationMs',
250
- key: 'durationMs',
251
- width: 90,
252
- render: formatDuration,
253
- },
254
- {
255
- title: t('Depth'),
256
- dataIndex: 'depth',
257
- key: 'depth',
258
- width: 60,
259
- render: (v: number) => v ?? 0,
260
- },
261
- {
262
- title: '',
263
- key: 'actions',
264
- width: 80,
265
- render: (_: unknown, record: TracingLog) => (
266
- <Button type="link" size="small" icon={<EyeOutlined />} onClick={() => handleOpenLog(record)}>
267
- {t('Detail')}
268
- </Button>
269
- ),
270
- },
271
- ];
272
-
273
- return (
274
- <div>
275
- <Alert
276
- type="info"
277
- showIcon
278
- style={{ marginBottom: 16 }}
279
- message={t('Execution Tracing')}
280
- description={
281
- <Text type="secondary">
282
- {t(
283
- 'View orchestration execution logs. Each row represents one sub-agent invocation, with child tool and Skill Hub executions shown in the detail flow.',
284
- )}
285
- </Text>
286
- }
287
- />
288
-
289
- <Card bordered={false}>
290
- <Form layout="inline" style={{ marginBottom: 16, rowGap: 8, flexWrap: 'wrap' }}>
291
- <Form.Item label={t('Leader')}>
292
- <Select
293
- allowClear
294
- placeholder={t('Any leader')}
295
- style={{ minWidth: 180 }}
296
- options={employeeOptions}
297
- value={filters.leader}
298
- onChange={(v) => updateFilter({ leader: v })}
299
- showSearch
300
- optionFilterProp="label"
301
- />
302
- </Form.Item>
303
- <Form.Item label={t('Sub-Agent')}>
304
- <Select
305
- allowClear
306
- placeholder={t('Any sub-agent')}
307
- style={{ minWidth: 180 }}
308
- options={employeeOptions}
309
- value={filters.subAgent}
310
- onChange={(v) => updateFilter({ subAgent: v })}
311
- showSearch
312
- optionFilterProp="label"
313
- />
314
- </Form.Item>
315
- <Form.Item label={t('Status')}>
316
- <Select
317
- allowClear
318
- placeholder={t('Any status')}
319
- style={{ minWidth: 140 }}
320
- options={[
321
- { label: t('Success'), value: 'success' },
322
- { label: t('Error'), value: 'error' },
323
- { label: t('Running'), value: 'running' },
324
- ]}
325
- value={filters.status}
326
- onChange={(v) => updateFilter({ status: v })}
327
- />
328
- </Form.Item>
329
- <Form.Item label={t('Time')}>
330
- <RangePicker
331
- showTime
332
- value={filters.range}
333
- onChange={(v) => updateFilter({ range: v as [Dayjs | null, Dayjs | null] | null })}
334
- />
335
- </Form.Item>
336
- <Form.Item>
337
- <Space>
338
- <Button onClick={resetFilters} disabled={!hasFilters}>
339
- {t('Reset')}
340
- </Button>
341
- <Button icon={<ReloadOutlined />} onClick={refresh}>
342
- {t('Refresh')}
343
- </Button>
344
- </Space>
345
- </Form.Item>
346
- </Form>
347
-
348
- <Table
349
- rowKey="id"
350
- loading={loading}
351
- dataSource={logs}
352
- columns={columns}
353
- size="middle"
354
- scroll={{ x: 'max-content' }}
355
- pagination={{
356
- current: page,
357
- pageSize,
358
- total,
359
- showSizeChanger: true,
360
- pageSizeOptions: [10, 20, 50, 100],
361
- showTotal: (count) => t('{{count}} executions', { count }),
362
- onChange: (nextPage, nextSize) => {
363
- setPage(nextPage);
364
- if (nextSize && nextSize !== pageSize) setPageSize(nextSize);
365
- },
366
- }}
367
- locale={{
368
- emptyText: (
369
- <Empty
370
- description={
371
- hasFilters ? t('No executions match the current filters') : t('No delegation executions yet')
372
- }
373
- />
374
- ),
375
- }}
376
- />
377
- </Card>
378
-
379
- <Drawer title={t('Execution Detail')} width={820} onClose={() => setSelectedLog(null)} open={!!selectedLog}>
380
- {selectedLog && (
381
- <Spin spinning={detailLoading}>
382
- <>
383
- <Descriptions column={1} bordered size="small" style={{ marginBottom: 16 }}>
384
- <Descriptions.Item label={t('Status')}>
385
- <Tag icon={statusIcon(selectedLog.status)} color={statusColor(selectedLog.status)}>
386
- {selectedLog.status ? t(selectedLog.status) : '-'}
387
- </Tag>
388
- </Descriptions.Item>
389
- <Descriptions.Item label={t('Leader')}>
390
- <Tag color="blue">{employeeMap.get(selectedLog.leaderUsername) || selectedLog.leaderUsername}</Tag>
391
- </Descriptions.Item>
392
- <Descriptions.Item label={t('Sub-Agent')}>
393
- <Tag color="green">
394
- {employeeMap.get(selectedLog.subAgentUsername) || selectedLog.subAgentUsername}
395
- </Tag>
396
- </Descriptions.Item>
397
- <Descriptions.Item label={t('Tool')}>
398
- <Text code>{selectedLog.toolName}</Text>
399
- </Descriptions.Item>
400
- <Descriptions.Item label={t('Depth')}>{selectedLog.depth ?? 0}</Descriptions.Item>
401
- <Descriptions.Item label={t('Duration')}>{formatDuration(selectedLog.durationMs)}</Descriptions.Item>
402
- <Descriptions.Item label={t('Time')}>
403
- {selectedLog.createdAt ? new Date(selectedLog.createdAt).toLocaleString() : '-'}
404
- </Descriptions.Item>
405
- </Descriptions>
406
-
407
- <Card title={t('Task')} size="small" style={{ marginBottom: 16 }}>
408
- <Paragraph style={{ whiteSpace: 'pre-wrap', margin: 0, fontSize: 13 }}>
409
- {selectedLog.task || t('No task description')}
410
- </Paragraph>
411
- </Card>
412
-
413
- {selectedLog.context && (
414
- <Card title={t('Context')} size="small" style={{ marginBottom: 16 }}>
415
- <Paragraph style={{ whiteSpace: 'pre-wrap', margin: 0, fontSize: 13 }}>
416
- {selectedLog.context}
417
- </Paragraph>
418
- </Card>
419
- )}
420
-
421
- <Card title={t('Execution Flow')} size="small" style={{ marginBottom: 16 }}>
422
- {Array.isArray(selectedLog.trace) && selectedLog.trace.length ? (
423
- <Timeline
424
- items={selectedLog.trace.map((item, index) => ({
425
- key: item.skillExecutionId ?? `${item.type ?? 'step'}-${item.at ?? index}`,
426
- color: item.status === 'error' ? 'red' : item.type === 'tool_call' ? 'blue' : 'green',
427
- children: (
428
- <div>
429
- <Space direction="vertical" size={2} style={{ width: '100%' }}>
430
- <Text strong>{item.title || item.type}</Text>
431
- <Text type="secondary">{item.at ? new Date(item.at).toLocaleString() : ''}</Text>
432
- {item.toolName && <Text code>{item.toolName}</Text>}
433
- {item.skillExecutionId && (
434
- <Text type="secondary">
435
- {t('Skill execution #{{id}}', { id: item.skillExecutionId })}
436
- </Text>
437
- )}
438
- {item.content && (
439
- <Paragraph style={{ whiteSpace: 'pre-wrap', margin: 0, fontSize: 13 }}>
440
- {item.content}
441
- </Paragraph>
442
- )}
443
- {item.args && (
444
- <Paragraph style={{ whiteSpace: 'pre-wrap', margin: 0, fontSize: 12 }}>
445
- {JSON.stringify(item.args, null, 2)}
446
- </Paragraph>
447
- )}
448
- </Space>
449
- </div>
450
- ),
451
- }))}
452
- />
453
- ) : (
454
- <Empty description={t('No execution flow captured')} />
455
- )}
456
- </Card>
457
-
458
- {Array.isArray(selectedLog.messages) && selectedLog.messages.length > 0 && (
459
- <Collapse
460
- style={{ marginBottom: 16 }}
461
- items={[
462
- {
463
- key: 'messages',
464
- label: t('Raw messages ({{count}})', { count: selectedLog.messages.length }),
465
- children: (
466
- <Space direction="vertical" style={{ width: '100%' }}>
467
- {selectedLog.messages.map((msg) => (
468
- <Card key={msg.index} size="small" title={`${msg.index + 1}. ${msg.type}`}>
469
- <Paragraph style={{ whiteSpace: 'pre-wrap', margin: 0, fontSize: 12 }}>
470
- {msg.content || JSON.stringify(msg.toolCalls || msg, null, 2)}
471
- </Paragraph>
472
- {(msg.toolCalls?.length ?? 0) > 0 && (
473
- <Paragraph style={{ whiteSpace: 'pre-wrap', margin: '8px 0 0', fontSize: 12 }}>
474
- {JSON.stringify(msg.toolCalls, null, 2)}
475
- </Paragraph>
476
- )}
477
- </Card>
478
- ))}
479
- </Space>
480
- ),
481
- },
482
- ]}
483
- />
484
- )}
485
-
486
- <Card
487
- title={t('Result')}
488
- size="small"
489
- style={{
490
- marginBottom: 16,
491
- borderColor: selectedLog.status === 'success' ? '#b7eb8f' : '#ffa39e',
492
- }}
493
- >
494
- <Paragraph
495
- style={{ whiteSpace: 'pre-wrap', margin: 0, fontSize: 13 }}
496
- ellipsis={{ rows: 20, expandable: true }}
497
- >
498
- {selectedLog.result || selectedLog.error || t('No result')}
499
- </Paragraph>
500
- </Card>
501
-
502
- {selectedLog.error && (
503
- <Card title={t('Error')} size="small" style={{ borderColor: '#ffa39e' }}>
504
- <Paragraph type="danger" style={{ whiteSpace: 'pre-wrap', margin: 0, fontSize: 13 }}>
505
- {selectedLog.error}
506
- </Paragraph>
507
- </Card>
508
- )}
509
- </>
510
- </Spin>
511
- )}
512
- </Drawer>
513
- </div>
514
- );
515
- };
1
+ import React, { useMemo, useRef, useState } from 'react';
2
+ import type { Dayjs } from 'dayjs';
3
+ import {
4
+ Table,
5
+ Card,
6
+ Tag,
7
+ Typography,
8
+ Drawer,
9
+ Descriptions,
10
+ Alert,
11
+ Button,
12
+ Empty,
13
+ Space,
14
+ Timeline,
15
+ Collapse,
16
+ Spin,
17
+ Select,
18
+ DatePicker,
19
+ Form,
20
+ message,
21
+ } from 'antd';
22
+ import {
23
+ EyeOutlined,
24
+ CheckCircleOutlined,
25
+ CloseCircleOutlined,
26
+ SyncOutlined,
27
+ ClockCircleOutlined,
28
+ ReloadOutlined,
29
+ } from '@ant-design/icons';
30
+ import { useApiClient as useAPIClient, useRequest } from '../hooks/useApiRequest';
31
+ import { useAIEmployees } from './AIEmployeesContext';
32
+ import { useT } from '../skill-hub/locale';
33
+
34
+ const { Text, Paragraph } = Typography;
35
+ const { RangePicker } = DatePicker;
36
+
37
+ type TraceItem = {
38
+ type?: string;
39
+ at?: string;
40
+ title?: string;
41
+ toolName?: string;
42
+ status?: string;
43
+ content?: string;
44
+ args?: unknown;
45
+ skillExecutionId?: number;
46
+ };
47
+
48
+ type TraceMessage = {
49
+ index: number;
50
+ type?: string;
51
+ content?: string;
52
+ toolCalls?: unknown[];
53
+ };
54
+
55
+ type TracingLog = {
56
+ id: number | string;
57
+ createdAt?: string;
58
+ leaderUsername?: string;
59
+ subAgentUsername?: string;
60
+ toolName?: string;
61
+ task?: string;
62
+ context?: string;
63
+ status?: string;
64
+ durationMs?: number;
65
+ depth?: number;
66
+ result?: string;
67
+ error?: string;
68
+ hasUnifiedTrace?: boolean;
69
+ trace?: TraceItem[];
70
+ messages?: TraceMessage[];
71
+ };
72
+
73
+ type FilterState = {
74
+ leader?: string;
75
+ subAgent?: string;
76
+ status?: string;
77
+ range?: [Dayjs | null, Dayjs | null] | null;
78
+ };
79
+
80
+ function statusIcon(status?: string) {
81
+ if (status === 'success') return <CheckCircleOutlined />;
82
+ if (status === 'error') return <CloseCircleOutlined />;
83
+ if (status === 'running') return <SyncOutlined spin />;
84
+ return <ClockCircleOutlined />;
85
+ }
86
+
87
+ function statusColor(status?: string) {
88
+ if (status === 'success') return 'success';
89
+ if (status === 'error') return 'error';
90
+ if (status === 'running') return 'processing';
91
+ return 'default';
92
+ }
93
+
94
+ export const TracingTab: React.FC = () => {
95
+ const api = useAPIClient();
96
+ const t = useT();
97
+ const [selectedLog, setSelectedLog] = useState<TracingLog | null>(null);
98
+ const [detailLoading, setDetailLoading] = useState(false);
99
+ // Guards the detail drawer against out-of-order responses when the user
100
+ // switches rows quickly: only the newest request may commit its result.
101
+ const detailRequestId = useRef(0);
102
+
103
+ const [page, setPage] = useState(1);
104
+ const [pageSize, setPageSize] = useState(20);
105
+ const [filters, setFilters] = useState<FilterState>({});
106
+
107
+ const { employees, employeeMap } = useAIEmployees();
108
+
109
+ const requestParams = useMemo(() => {
110
+ const filter: Record<string, unknown> = {};
111
+ if (filters.leader) filter.leaderUsername = filters.leader;
112
+ if (filters.subAgent) filter.subAgentUsername = filters.subAgent;
113
+ if (filters.status) filter.status = filters.status;
114
+ if (filters.range && (filters.range[0] || filters.range[1])) {
115
+ const createdAt: Record<string, string> = {};
116
+ if (filters.range[0]) createdAt.$gte = filters.range[0].toDate().toISOString();
117
+ if (filters.range[1]) createdAt.$lte = filters.range[1].toDate().toISOString();
118
+ filter.createdAt = createdAt;
119
+ }
120
+ return {
121
+ sort: ['-createdAt'],
122
+ page,
123
+ pageSize,
124
+ filter,
125
+ };
126
+ }, [page, pageSize, filters]);
127
+
128
+ const { data, loading, refresh } = useRequest<{ data?: TracingLog[]; meta?: { count?: number } }>(
129
+ {
130
+ url: 'orchestratorTracing:list',
131
+ params: requestParams,
132
+ },
133
+ {
134
+ refreshDeps: [requestParams],
135
+ },
136
+ );
137
+
138
+ // Server returns { data: rows, meta: { count } }; useRequest unwraps to that shape.
139
+ const logs = useMemo(() => {
140
+ const rows = data?.data;
141
+ return Array.isArray(rows) ? rows : [];
142
+ }, [data]);
143
+
144
+ const total = useMemo(() => {
145
+ const count = data?.meta?.count;
146
+ return typeof count === 'number' ? count : 0;
147
+ }, [data]);
148
+
149
+ const formatDuration = (ms?: number) => {
150
+ if (!ms) return '-';
151
+ return ms >= 1000 ? `${(ms / 1000).toFixed(1)}s` : `${ms}ms`;
152
+ };
153
+
154
+ const handleOpenLog = async (record: TracingLog) => {
155
+ const requestId = ++detailRequestId.current;
156
+ setSelectedLog(record);
157
+ setDetailLoading(true);
158
+ try {
159
+ const res = await api.request({
160
+ url: 'orchestratorTracing:get',
161
+ params: { filterByTk: record.id, source: record.hasUnifiedTrace ? 'span' : 'log' },
162
+ });
163
+ if (requestId !== detailRequestId.current) return;
164
+ const payload = res as { data?: { data?: { data?: TracingLog } | TracingLog } };
165
+ const detail =
166
+ (payload?.data?.data as { data?: TracingLog })?.data || (payload?.data?.data as TracingLog) || record;
167
+ setSelectedLog(detail);
168
+ } catch (error) {
169
+ if (requestId !== detailRequestId.current) return;
170
+ const text =
171
+ (error as { response?: { data?: { errors?: Array<{ message?: string }> } }; message?: string })?.response?.data
172
+ ?.errors?.[0]?.message ||
173
+ (error as { message?: string })?.message ||
174
+ t('Failed to load execution detail');
175
+ message.error(text);
176
+ } finally {
177
+ if (requestId === detailRequestId.current) {
178
+ setDetailLoading(false);
179
+ }
180
+ }
181
+ };
182
+
183
+ const updateFilter = (patch: Partial<FilterState>) => {
184
+ setFilters((prev) => ({ ...prev, ...patch }));
185
+ setPage(1);
186
+ };
187
+
188
+ const resetFilters = () => {
189
+ setFilters({});
190
+ setPage(1);
191
+ };
192
+
193
+ const employeeOptions = useMemo(
194
+ () =>
195
+ employees.map((e) => ({
196
+ label: e.nickname || e.username,
197
+ value: e.username,
198
+ })),
199
+ [employees],
200
+ );
201
+
202
+ const hasFilters = Boolean(
203
+ filters.leader || filters.subAgent || filters.status || (filters.range && (filters.range[0] || filters.range[1])),
204
+ );
205
+
206
+ const columns = [
207
+ {
208
+ title: t('Time'),
209
+ dataIndex: 'createdAt',
210
+ key: 'createdAt',
211
+ width: 170,
212
+ render: (v: string) => (v ? new Date(v).toLocaleString() : '-'),
213
+ },
214
+ {
215
+ title: t('Leader'),
216
+ dataIndex: 'leaderUsername',
217
+ key: 'leaderUsername',
218
+ render: (username: string) => <Tag color="blue">{employeeMap.get(username) || username}</Tag>,
219
+ },
220
+ {
221
+ title: t('Sub-Agent'),
222
+ dataIndex: 'subAgentUsername',
223
+ key: 'subAgentUsername',
224
+ render: (username: string) => <Tag color="green">{employeeMap.get(username) || username}</Tag>,
225
+ },
226
+ {
227
+ title: t('Task'),
228
+ dataIndex: 'task',
229
+ key: 'task',
230
+ render: (task: string) => (
231
+ <Text ellipsis style={{ maxWidth: 280 }}>
232
+ {task?.substring(0, 100) || '-'}
233
+ </Text>
234
+ ),
235
+ },
236
+ {
237
+ title: t('Status'),
238
+ dataIndex: 'status',
239
+ key: 'status',
240
+ width: 90,
241
+ render: (status: string) => (
242
+ <Tag icon={statusIcon(status)} color={statusColor(status)}>
243
+ {status ? t(status) : '-'}
244
+ </Tag>
245
+ ),
246
+ },
247
+ {
248
+ title: t('Duration'),
249
+ dataIndex: 'durationMs',
250
+ key: 'durationMs',
251
+ width: 90,
252
+ render: formatDuration,
253
+ },
254
+ {
255
+ title: t('Depth'),
256
+ dataIndex: 'depth',
257
+ key: 'depth',
258
+ width: 60,
259
+ render: (v: number) => v ?? 0,
260
+ },
261
+ {
262
+ title: '',
263
+ key: 'actions',
264
+ width: 80,
265
+ render: (_: unknown, record: TracingLog) => (
266
+ <Button type="link" size="small" icon={<EyeOutlined />} onClick={() => handleOpenLog(record)}>
267
+ {t('Detail')}
268
+ </Button>
269
+ ),
270
+ },
271
+ ];
272
+
273
+ return (
274
+ <div>
275
+ <Alert
276
+ type="info"
277
+ showIcon
278
+ style={{ marginBottom: 16 }}
279
+ message={t('Execution Tracing')}
280
+ description={
281
+ <Text type="secondary">
282
+ {t(
283
+ 'View orchestration execution logs. Each row represents one sub-agent invocation, with child tool and Skill Hub executions shown in the detail flow.',
284
+ )}
285
+ </Text>
286
+ }
287
+ />
288
+
289
+ <Card bordered={false}>
290
+ <Form layout="inline" style={{ marginBottom: 16, rowGap: 8, flexWrap: 'wrap' }}>
291
+ <Form.Item label={t('Leader')}>
292
+ <Select
293
+ allowClear
294
+ placeholder={t('Any leader')}
295
+ style={{ minWidth: 180 }}
296
+ options={employeeOptions}
297
+ value={filters.leader}
298
+ onChange={(v) => updateFilter({ leader: v })}
299
+ showSearch
300
+ optionFilterProp="label"
301
+ />
302
+ </Form.Item>
303
+ <Form.Item label={t('Sub-Agent')}>
304
+ <Select
305
+ allowClear
306
+ placeholder={t('Any sub-agent')}
307
+ style={{ minWidth: 180 }}
308
+ options={employeeOptions}
309
+ value={filters.subAgent}
310
+ onChange={(v) => updateFilter({ subAgent: v })}
311
+ showSearch
312
+ optionFilterProp="label"
313
+ />
314
+ </Form.Item>
315
+ <Form.Item label={t('Status')}>
316
+ <Select
317
+ allowClear
318
+ placeholder={t('Any status')}
319
+ style={{ minWidth: 140 }}
320
+ options={[
321
+ { label: t('Success'), value: 'success' },
322
+ { label: t('Error'), value: 'error' },
323
+ { label: t('Running'), value: 'running' },
324
+ ]}
325
+ value={filters.status}
326
+ onChange={(v) => updateFilter({ status: v })}
327
+ />
328
+ </Form.Item>
329
+ <Form.Item label={t('Time')}>
330
+ <RangePicker
331
+ showTime
332
+ value={filters.range}
333
+ onChange={(v) => updateFilter({ range: v as [Dayjs | null, Dayjs | null] | null })}
334
+ />
335
+ </Form.Item>
336
+ <Form.Item>
337
+ <Space>
338
+ <Button onClick={resetFilters} disabled={!hasFilters}>
339
+ {t('Reset')}
340
+ </Button>
341
+ <Button icon={<ReloadOutlined />} onClick={refresh}>
342
+ {t('Refresh')}
343
+ </Button>
344
+ </Space>
345
+ </Form.Item>
346
+ </Form>
347
+
348
+ <Table
349
+ rowKey="id"
350
+ loading={loading}
351
+ dataSource={logs}
352
+ columns={columns}
353
+ size="middle"
354
+ scroll={{ x: 'max-content' }}
355
+ pagination={{
356
+ current: page,
357
+ pageSize,
358
+ total,
359
+ showSizeChanger: true,
360
+ pageSizeOptions: [10, 20, 50, 100],
361
+ showTotal: (count) => t('{{count}} executions', { count }),
362
+ onChange: (nextPage, nextSize) => {
363
+ setPage(nextPage);
364
+ if (nextSize && nextSize !== pageSize) setPageSize(nextSize);
365
+ },
366
+ }}
367
+ locale={{
368
+ emptyText: (
369
+ <Empty
370
+ description={
371
+ hasFilters ? t('No executions match the current filters') : t('No delegation executions yet')
372
+ }
373
+ />
374
+ ),
375
+ }}
376
+ />
377
+ </Card>
378
+
379
+ <Drawer title={t('Execution Detail')} width={820} onClose={() => setSelectedLog(null)} open={!!selectedLog}>
380
+ {selectedLog && (
381
+ <Spin spinning={detailLoading}>
382
+ <>
383
+ <Descriptions column={1} bordered size="small" style={{ marginBottom: 16 }}>
384
+ <Descriptions.Item label={t('Status')}>
385
+ <Tag icon={statusIcon(selectedLog.status)} color={statusColor(selectedLog.status)}>
386
+ {selectedLog.status ? t(selectedLog.status) : '-'}
387
+ </Tag>
388
+ </Descriptions.Item>
389
+ <Descriptions.Item label={t('Leader')}>
390
+ <Tag color="blue">{employeeMap.get(selectedLog.leaderUsername) || selectedLog.leaderUsername}</Tag>
391
+ </Descriptions.Item>
392
+ <Descriptions.Item label={t('Sub-Agent')}>
393
+ <Tag color="green">
394
+ {employeeMap.get(selectedLog.subAgentUsername) || selectedLog.subAgentUsername}
395
+ </Tag>
396
+ </Descriptions.Item>
397
+ <Descriptions.Item label={t('Tool')}>
398
+ <Text code>{selectedLog.toolName}</Text>
399
+ </Descriptions.Item>
400
+ <Descriptions.Item label={t('Depth')}>{selectedLog.depth ?? 0}</Descriptions.Item>
401
+ <Descriptions.Item label={t('Duration')}>{formatDuration(selectedLog.durationMs)}</Descriptions.Item>
402
+ <Descriptions.Item label={t('Time')}>
403
+ {selectedLog.createdAt ? new Date(selectedLog.createdAt).toLocaleString() : '-'}
404
+ </Descriptions.Item>
405
+ </Descriptions>
406
+
407
+ <Card title={t('Task')} size="small" style={{ marginBottom: 16 }}>
408
+ <Paragraph style={{ whiteSpace: 'pre-wrap', margin: 0, fontSize: 13 }}>
409
+ {selectedLog.task || t('No task description')}
410
+ </Paragraph>
411
+ </Card>
412
+
413
+ {selectedLog.context && (
414
+ <Card title={t('Context')} size="small" style={{ marginBottom: 16 }}>
415
+ <Paragraph style={{ whiteSpace: 'pre-wrap', margin: 0, fontSize: 13 }}>
416
+ {selectedLog.context}
417
+ </Paragraph>
418
+ </Card>
419
+ )}
420
+
421
+ <Card title={t('Execution Flow')} size="small" style={{ marginBottom: 16 }}>
422
+ {Array.isArray(selectedLog.trace) && selectedLog.trace.length ? (
423
+ <Timeline
424
+ items={selectedLog.trace.map((item, index) => ({
425
+ key: item.skillExecutionId ?? `${item.type ?? 'step'}-${item.at ?? index}`,
426
+ color: item.status === 'error' ? 'red' : item.type === 'tool_call' ? 'blue' : 'green',
427
+ children: (
428
+ <div>
429
+ <Space direction="vertical" size={2} style={{ width: '100%' }}>
430
+ <Text strong>{item.title || item.type}</Text>
431
+ <Text type="secondary">{item.at ? new Date(item.at).toLocaleString() : ''}</Text>
432
+ {item.toolName && <Text code>{item.toolName}</Text>}
433
+ {item.skillExecutionId && (
434
+ <Text type="secondary">
435
+ {t('Skill execution #{{id}}', { id: item.skillExecutionId })}
436
+ </Text>
437
+ )}
438
+ {item.content && (
439
+ <Paragraph style={{ whiteSpace: 'pre-wrap', margin: 0, fontSize: 13 }}>
440
+ {item.content}
441
+ </Paragraph>
442
+ )}
443
+ {item.args && (
444
+ <Paragraph style={{ whiteSpace: 'pre-wrap', margin: 0, fontSize: 12 }}>
445
+ {JSON.stringify(item.args, null, 2)}
446
+ </Paragraph>
447
+ )}
448
+ </Space>
449
+ </div>
450
+ ),
451
+ }))}
452
+ />
453
+ ) : (
454
+ <Empty description={t('No execution flow captured')} />
455
+ )}
456
+ </Card>
457
+
458
+ {Array.isArray(selectedLog.messages) && selectedLog.messages.length > 0 && (
459
+ <Collapse
460
+ style={{ marginBottom: 16 }}
461
+ items={[
462
+ {
463
+ key: 'messages',
464
+ label: t('Raw messages ({{count}})', { count: selectedLog.messages.length }),
465
+ children: (
466
+ <Space direction="vertical" style={{ width: '100%' }}>
467
+ {selectedLog.messages.map((msg) => (
468
+ <Card key={msg.index} size="small" title={`${msg.index + 1}. ${msg.type}`}>
469
+ <Paragraph style={{ whiteSpace: 'pre-wrap', margin: 0, fontSize: 12 }}>
470
+ {msg.content || JSON.stringify(msg.toolCalls || msg, null, 2)}
471
+ </Paragraph>
472
+ {(msg.toolCalls?.length ?? 0) > 0 && (
473
+ <Paragraph style={{ whiteSpace: 'pre-wrap', margin: '8px 0 0', fontSize: 12 }}>
474
+ {JSON.stringify(msg.toolCalls, null, 2)}
475
+ </Paragraph>
476
+ )}
477
+ </Card>
478
+ ))}
479
+ </Space>
480
+ ),
481
+ },
482
+ ]}
483
+ />
484
+ )}
485
+
486
+ <Card
487
+ title={t('Result')}
488
+ size="small"
489
+ style={{
490
+ marginBottom: 16,
491
+ borderColor: selectedLog.status === 'success' ? '#b7eb8f' : '#ffa39e',
492
+ }}
493
+ >
494
+ <Paragraph
495
+ style={{ whiteSpace: 'pre-wrap', margin: 0, fontSize: 13 }}
496
+ ellipsis={{ rows: 20, expandable: true }}
497
+ >
498
+ {selectedLog.result || selectedLog.error || t('No result')}
499
+ </Paragraph>
500
+ </Card>
501
+
502
+ {selectedLog.error && (
503
+ <Card title={t('Error')} size="small" style={{ borderColor: '#ffa39e' }}>
504
+ <Paragraph type="danger" style={{ whiteSpace: 'pre-wrap', margin: 0, fontSize: 13 }}>
505
+ {selectedLog.error}
506
+ </Paragraph>
507
+ </Card>
508
+ )}
509
+ </>
510
+ </Spin>
511
+ )}
512
+ </Drawer>
513
+ </div>
514
+ );
515
+ };