plugin-agent-orchestrator 1.1.3 → 1.1.5

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 (218) 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/253.59577b40d9875be0.js +10 -0
  6. package/dist/client-v2/264.7ed8bee71fa5935c.js +10 -0
  7. package/dist/client-v2/{41.ba6e080cc0488143.js → 41.3deb9e57a0f64fc4.js} +1 -1
  8. package/dist/client-v2/418.41ed200e7d6da332.js +10 -0
  9. package/dist/client-v2/53.349fff8db80b19d4.js +10 -0
  10. package/dist/client-v2/619.0a2144aaffefe018.js +10 -0
  11. package/dist/client-v2/{70.bda9518881c05360.js → 70.ffff2997c10fd4b0.js} +1 -1
  12. package/dist/client-v2/{794.9bbb8d3a61b2bdf2.js → 794.a67a2614405ba627.js} +1 -1
  13. package/dist/client-v2/981.e4a1f41cfc94a856.js +10 -0
  14. package/dist/client-v2/{993.82778b6fd6db3cb1.js → 993.b0688fdc5ccb000a.js} +1 -1
  15. package/dist/client-v2/index.js +1 -1
  16. package/dist/externalVersion.js +8 -7
  17. package/dist/locale/en-US.json +199 -123
  18. package/dist/locale/vi-VN.json +199 -123
  19. package/dist/locale/zh-CN.json +199 -123
  20. package/dist/server/collections/agent-execution-spans.js +55 -0
  21. package/dist/server/collections/agent-harness-profile-versions.js +56 -0
  22. package/dist/server/collections/agent-harness-profiles.js +12 -0
  23. package/dist/server/collections/agent-loop-action-approvals.js +69 -0
  24. package/dist/server/collections/agent-loop-artifacts.js +55 -0
  25. package/dist/server/collections/agent-loop-circuit-states.js +53 -0
  26. package/dist/server/collections/agent-loop-control-settings.js +51 -0
  27. package/dist/server/collections/agent-loop-events.js +27 -0
  28. package/dist/server/collections/agent-loop-path-locks.js +57 -0
  29. package/dist/server/collections/agent-loop-patterns.js +72 -0
  30. package/dist/server/collections/agent-loop-runs.js +170 -3
  31. package/dist/server/collections/agent-loop-steps.js +76 -0
  32. package/dist/server/collections/agent-loop-usage-buckets.js +52 -0
  33. package/dist/server/collections/agent-loop-worktrees.js +55 -0
  34. package/dist/server/collections/skill-executions.js +8 -0
  35. package/dist/server/migrations/{20260427000000-change-packages-to-text.js → 20260427000002-change-packages-to-text.js} +2 -0
  36. package/dist/server/migrations/20260429000000-add-llm-fields.js +3 -2
  37. package/dist/server/migrations/{20260429000000-fix-inputargs-json-to-text.js → 20260429000001-fix-inputargs-json-to-text.js} +14 -6
  38. package/dist/server/migrations/20260503000000-add-orchestrator-trace-fields.js +2 -1
  39. package/dist/server/migrations/20260524000000-add-agent-loop-fields-to-skill-executions.js +2 -1
  40. package/dist/server/migrations/20260803010000-backfill-loop-control-plane-data.js +262 -0
  41. package/dist/server/plugin.js +54 -150
  42. package/dist/server/resources/agent-harness-profile.js +117 -0
  43. package/dist/server/resources/agent-knowledge-insights.js +1 -3
  44. package/dist/server/resources/agent-loop-approval.js +108 -0
  45. package/dist/server/resources/agent-loop-artifact.js +86 -0
  46. package/dist/server/resources/agent-loop-events-stream.js +130 -0
  47. package/dist/server/resources/agent-loop.js +183 -139
  48. package/dist/server/resources/resource-helpers.js +63 -0
  49. package/dist/server/resources/tracing.js +121 -107
  50. package/dist/server/services/AgentMemoryContextService.js +34 -0
  51. package/dist/server/services/DurableCircuitBreakerService.js +229 -0
  52. package/dist/server/services/HarnessCompiler.js +175 -0
  53. package/dist/server/services/HarnessProfileService.js +233 -0
  54. package/dist/server/services/HarnessSchema.js +194 -0
  55. package/dist/server/services/LoopBudgetService.js +269 -0
  56. package/dist/server/services/LoopControlService.js +139 -0
  57. package/dist/server/services/LoopPatternSchema.js +195 -0
  58. package/dist/server/services/LoopPatternService.js +132 -0
  59. package/dist/server/services/LoopRunRepository.js +285 -0
  60. package/dist/server/services/LoopRunStateMachine.js +478 -0
  61. package/dist/server/services/LoopSchedulerService.js +193 -0
  62. package/dist/server/services/LoopTriggerService.js +165 -0
  63. package/dist/server/services/LoopWorkerService.js +699 -0
  64. package/dist/server/services/NativeSubAgentObserver.js +165 -23
  65. package/dist/server/services/PathLockService.js +288 -0
  66. package/dist/server/services/PluginAiRuntimeAdapter.js +226 -0
  67. package/dist/server/services/ToolLoopDetectionService.js +210 -0
  68. package/dist/server/services/VerificationSchema.js +59 -0
  69. package/dist/server/services/VerificationService.js +235 -0
  70. package/dist/server/services/harness-runtime-policy.js +139 -0
  71. package/dist/server/skill-hub/actions/git-import.js +13 -7
  72. package/dist/server/skill-hub/plugin.js +36 -3
  73. package/dist/server/skill-hub/services/RegistrySkillSnapshotService.js +1 -5
  74. package/dist/server/skill-hub/tasks/SkillExecutionTask.js +29 -0
  75. package/dist/server/utils/ensure-indexes.js +111 -0
  76. package/dist/server/utils/loop-pattern-context.js +56 -0
  77. package/package.json +53 -53
  78. package/src/client/ApprovalsTab.tsx +2 -0
  79. package/src/client/OrchestratorSettings.tsx +55 -0
  80. package/src/client/skill-hub/components/GitSkillImport.tsx +3 -3
  81. package/src/client/skill-hub/components/SkillMetrics.tsx +15 -10
  82. package/src/client/skill-hub/index.tsx +0 -52
  83. package/src/client-v2/components/AgentRunsTab.tsx +100 -18
  84. package/src/client-v2/components/ApprovalsTab.tsx +337 -0
  85. package/src/client-v2/components/HarnessProfilesTab.tsx +385 -100
  86. package/src/client-v2/components/MemoryInspectorTab.tsx +141 -125
  87. package/src/client-v2/components/TracingTab.tsx +160 -77
  88. package/src/client-v2/hooks/useApiRequest.ts +28 -8
  89. package/src/client-v2/pages/ApprovalsPage.tsx +10 -0
  90. package/src/client-v2/plugin.tsx +6 -6
  91. package/src/client-v2/skill-hub/components/SkillMetrics.tsx +11 -6
  92. package/src/locale/en-US.json +199 -123
  93. package/src/locale/vi-VN.json +199 -123
  94. package/src/locale/zh-CN.json +199 -123
  95. package/src/server/__tests__/circuit-breaker.test.ts +248 -169
  96. package/src/server/__tests__/harness-compiler.test.ts +214 -0
  97. package/src/server/__tests__/harness-profile-service.test.ts +167 -0
  98. package/src/server/__tests__/harness-runtime-policy.test.ts +293 -0
  99. package/src/server/__tests__/harness-tool-plan.test.ts +172 -0
  100. package/src/server/__tests__/loop-approval-decision.test.ts +512 -0
  101. package/src/server/__tests__/loop-approval-expiry.test.ts +258 -0
  102. package/src/server/__tests__/loop-budget-service.test.ts +255 -0
  103. package/src/server/__tests__/loop-control-plane-backfill.test.ts +266 -0
  104. package/src/server/__tests__/loop-pattern-schema.test.ts +73 -0
  105. package/src/server/__tests__/loop-pattern-service.test.ts +148 -0
  106. package/src/server/__tests__/loop-run-state-machine.test.ts +101 -0
  107. package/src/server/__tests__/loop-trigger-service.test.ts +148 -0
  108. package/src/server/__tests__/loop-worker-claim.test.ts +341 -0
  109. package/src/server/__tests__/loop-worker-execution.test.ts +317 -0
  110. package/src/server/__tests__/native-sub-agent-observer.test.ts +288 -4
  111. package/src/server/__tests__/path-lock-service.test.ts +254 -0
  112. package/src/server/__tests__/skill-execution-task-policy.test.ts +140 -0
  113. package/src/server/__tests__/smoke.test.ts +162 -121
  114. package/src/server/__tests__/tool-loop-detection.test.ts +275 -0
  115. package/src/server/collections/agent-execution-spans.ts +55 -0
  116. package/src/server/collections/agent-harness-profile-versions.ts +26 -0
  117. package/src/server/collections/agent-harness-profiles.ts +71 -59
  118. package/src/server/collections/agent-loop-action-approvals.ts +39 -0
  119. package/src/server/collections/agent-loop-artifacts.ts +25 -0
  120. package/src/server/collections/agent-loop-circuit-states.ts +23 -0
  121. package/src/server/collections/agent-loop-control-settings.ts +21 -0
  122. package/src/server/collections/agent-loop-events.ts +98 -71
  123. package/src/server/collections/agent-loop-path-locks.ts +27 -0
  124. package/src/server/collections/agent-loop-patterns.ts +42 -0
  125. package/src/server/collections/agent-loop-runs.ts +170 -3
  126. package/src/server/collections/agent-loop-steps.ts +76 -0
  127. package/src/server/collections/agent-loop-usage-buckets.ts +22 -0
  128. package/src/server/collections/agent-loop-worktrees.ts +25 -0
  129. package/src/server/collections/skill-executions.ts +8 -0
  130. package/src/server/migrations/{20260427000000-change-packages-to-text.ts → 20260427000002-change-packages-to-text.ts} +52 -49
  131. package/src/server/migrations/20260429000000-add-llm-fields.ts +47 -46
  132. package/src/server/migrations/{20260429000000-fix-inputargs-json-to-text.ts → 20260429000001-fix-inputargs-json-to-text.ts} +45 -38
  133. package/src/server/migrations/20260503000000-add-orchestrator-trace-fields.ts +33 -32
  134. package/src/server/migrations/20260524000000-add-agent-loop-fields-to-skill-executions.ts +31 -30
  135. package/src/server/migrations/20260803010000-backfill-loop-control-plane-data.ts +293 -0
  136. package/src/server/plugin.ts +55 -167
  137. package/src/server/resources/agent-harness-profile.ts +94 -0
  138. package/src/server/resources/agent-knowledge-insights.ts +5 -3
  139. package/src/server/resources/agent-loop-approval.ts +84 -0
  140. package/src/server/resources/agent-loop-artifact.ts +56 -0
  141. package/src/server/resources/agent-loop-events-stream.ts +105 -0
  142. package/src/server/resources/agent-loop.ts +204 -143
  143. package/src/server/resources/agent-monitor.ts +482 -482
  144. package/src/server/resources/resource-helpers.ts +33 -0
  145. package/src/server/resources/tracing.ts +266 -258
  146. package/src/server/services/AgentMemoryContextService.ts +44 -0
  147. package/src/server/services/DurableCircuitBreakerService.ts +239 -0
  148. package/src/server/services/ExecutionSpanService.ts +2 -0
  149. package/src/server/services/HarnessCompiler.ts +170 -0
  150. package/src/server/services/HarnessProfileService.ts +239 -0
  151. package/src/server/services/HarnessSchema.ts +194 -0
  152. package/src/server/services/LoopBudgetService.ts +275 -0
  153. package/src/server/services/LoopControlService.ts +124 -0
  154. package/src/server/services/LoopPatternSchema.ts +185 -0
  155. package/src/server/services/LoopPatternService.ts +143 -0
  156. package/src/server/services/LoopRunRepository.ts +336 -0
  157. package/src/server/services/LoopRunStateMachine.ts +529 -0
  158. package/src/server/services/LoopSchedulerService.ts +199 -0
  159. package/src/server/services/LoopTriggerService.ts +157 -0
  160. package/src/server/services/LoopWorkerService.ts +822 -0
  161. package/src/server/services/NativeSubAgentObserver.ts +186 -21
  162. package/src/server/services/PathLockService.ts +321 -0
  163. package/src/server/services/PluginAiRuntimeAdapter.ts +332 -0
  164. package/src/server/services/ToolLoopDetectionService.ts +213 -0
  165. package/src/server/services/VerificationSchema.ts +31 -0
  166. package/src/server/services/VerificationService.ts +264 -0
  167. package/src/server/services/harness-runtime-policy.ts +141 -0
  168. package/src/server/skill-hub/actions/__tests__/git-import.test.ts +15 -1
  169. package/src/server/skill-hub/actions/git-import.ts +9 -3
  170. package/src/server/skill-hub/plugin.ts +41 -3
  171. package/src/server/skill-hub/services/RegistrySkillSnapshotService.ts +235 -239
  172. package/src/server/skill-hub/services/__tests__/RegistrySkillSnapshotService.test.ts +61 -63
  173. package/src/server/skill-hub/tasks/SkillExecutionTask.ts +43 -2
  174. package/src/server/utils/ensure-indexes.ts +96 -0
  175. package/src/server/utils/logging.ts +62 -63
  176. package/src/server/utils/loop-pattern-context.ts +20 -0
  177. package/dist/client-v2/214.79650a549273f163.js +0 -10
  178. package/dist/client-v2/253.9f0537713cee9e6c.js +0 -10
  179. package/dist/client-v2/264.718a107e43fc163c.js +0 -10
  180. package/dist/client-v2/373.f5d5292e53c4e832.js +0 -10
  181. package/dist/client-v2/418.ce8f5b2b8a229d1d.js +0 -10
  182. package/dist/client-v2/53.7c29c28043e9112d.js +0 -10
  183. package/dist/client-v2/619.bd3c5698b40705c3.js +0 -10
  184. package/dist/client-v2/677.a991ce0250ff5c77.js +0 -10
  185. package/dist/client-v2/925.f5370de8f6632d65.js +0 -10
  186. package/dist/server/services/AgentHarness.js +0 -81
  187. package/dist/server/services/AgentLoopController.js +0 -1023
  188. package/dist/server/services/AgentLoopRepository.js +0 -192
  189. package/dist/server/services/AgentLoopService.js +0 -142
  190. package/dist/server/services/AgentPlanValidator.js +0 -99
  191. package/dist/server/services/AgentPlannerService.js +0 -99
  192. package/dist/server/services/CircuitBreaker.js +0 -125
  193. package/dist/server/services/ContextAggregator.js +0 -201
  194. package/dist/server/services/PlanningPromptService.js +0 -95
  195. package/dist/server/tools/agent-loop.js +0 -373
  196. package/dist/server/tools/orchestrator-plan.js +0 -254
  197. package/src/client/AIEmployeeSelect.tsx +0 -47
  198. package/src/client/AIEmployeesContext.tsx +0 -102
  199. package/src/client/RulesTab.tsx +0 -2
  200. package/src/client/TracingTab.tsx +0 -436
  201. package/src/client/skill-hub/components/ExecutionProgress.tsx +0 -51
  202. package/src/client-v2/components/RulesTab.tsx +0 -2
  203. package/src/client-v2/pages/AgentRunsPage.tsx +0 -13
  204. package/src/server/__tests__/agent-loop-controller.test.ts +0 -375
  205. package/src/server/__tests__/context-aggregator.test.ts +0 -222
  206. package/src/server/__tests__/parallel-execution.test.ts +0 -318
  207. package/src/server/__tests__/planning-prompt-service.test.ts +0 -23
  208. package/src/server/services/AgentHarness.ts +0 -67
  209. package/src/server/services/AgentLoopController.ts +0 -1263
  210. package/src/server/services/AgentLoopRepository.ts +0 -178
  211. package/src/server/services/AgentLoopService.ts +0 -177
  212. package/src/server/services/AgentPlanValidator.ts +0 -73
  213. package/src/server/services/AgentPlannerService.ts +0 -80
  214. package/src/server/services/CircuitBreaker.ts +0 -126
  215. package/src/server/services/ContextAggregator.ts +0 -239
  216. package/src/server/services/PlanningPromptService.ts +0 -72
  217. package/src/server/tools/agent-loop.ts +0 -360
  218. package/src/server/tools/orchestrator-plan.ts +0 -255
@@ -1,4 +1,4 @@
1
- import React, { useMemo, useState } from 'react';
1
+ import React, { useMemo, useRef, useState } from 'react';
2
2
  import {
3
3
  Alert,
4
4
  Button,
@@ -30,6 +30,68 @@ type FilterState = {
30
30
  status?: string;
31
31
  };
32
32
 
33
+ type TraceItem = {
34
+ id?: number | string;
35
+ type?: string;
36
+ title?: string;
37
+ status?: string;
38
+ toolName?: string;
39
+ durationMs?: number;
40
+ at?: string;
41
+ content?: unknown;
42
+ };
43
+
44
+ type ToolMessage = {
45
+ sessionId?: string;
46
+ toolCallId?: string;
47
+ toolName?: string;
48
+ status?: string;
49
+ invokeStatus?: string;
50
+ content?: unknown;
51
+ };
52
+
53
+ type NativeMessage = {
54
+ sessionId?: string;
55
+ messageId?: string | number;
56
+ role?: string;
57
+ content?: unknown;
58
+ metadata?: unknown;
59
+ };
60
+
61
+ type RunRecord = {
62
+ id: number | string;
63
+ createdAt?: string;
64
+ startedAt?: string;
65
+ endedAt?: string;
66
+ leaderUsername?: string;
67
+ subAgentUsername?: string;
68
+ task?: string;
69
+ status?: string;
70
+ durationMs?: number;
71
+ memoryContextApplied?: boolean;
72
+ harnessTag?: string;
73
+ parentSessionId?: string;
74
+ subSessionId?: string;
75
+ toolCallId?: string;
76
+ input?: { question?: string };
77
+ output?: unknown;
78
+ error?: unknown;
79
+ metadata?: unknown;
80
+ trace?: TraceItem[];
81
+ toolMessages?: ToolMessage[];
82
+ nativeMessages?: NativeMessage[];
83
+ };
84
+
85
+ type ListResponse = {
86
+ data?: RunRecord[];
87
+ meta?: { count?: number };
88
+ };
89
+
90
+ type RequestError = {
91
+ response?: { data?: { errors?: Array<{ message?: string }> } };
92
+ message?: string;
93
+ };
94
+
33
95
  function statusColor(status?: string) {
34
96
  switch (status) {
35
97
  case 'success':
@@ -98,9 +160,12 @@ export const AgentRunsTab: React.FC = () => {
98
160
  const [filters, setFilters] = useState<FilterState>({});
99
161
  const [page, setPage] = useState(1);
100
162
  const [pageSize, setPageSize] = useState(20);
101
- const [selectedRun, setSelectedRun] = useState<any>(null);
163
+ const [selectedRun, setSelectedRun] = useState<RunRecord | null>(null);
102
164
  const [detailLoading, setDetailLoading] = useState(false);
103
165
  const [syncLoading, setSyncLoading] = useState(false);
166
+ // Guards the detail drawer against out-of-order responses when the user
167
+ // switches rows quickly: only the newest request may commit its result.
168
+ const detailRequestId = useRef(0);
104
169
 
105
170
  const requestParams = useMemo(() => {
106
171
  const filter: Record<string, string> = {};
@@ -115,7 +180,7 @@ export const AgentRunsTab: React.FC = () => {
115
180
  };
116
181
  }, [filters, page, pageSize]);
117
182
 
118
- const { data, loading, refresh } = useRequest(
183
+ const { data, loading, refresh } = useRequest<ListResponse>(
119
184
  {
120
185
  url: 'agentMonitor:list',
121
186
  params: requestParams,
@@ -126,12 +191,12 @@ export const AgentRunsTab: React.FC = () => {
126
191
  );
127
192
 
128
193
  const runs = useMemo(() => {
129
- const rows = (data as any)?.data;
194
+ const rows = data?.data;
130
195
  return Array.isArray(rows) ? rows : [];
131
196
  }, [data]);
132
197
 
133
198
  const total = useMemo(() => {
134
- const count = (data as any)?.meta?.count;
199
+ const count = data?.meta?.count;
135
200
  return typeof count === 'number' ? count : 0;
136
201
  }, [data]);
137
202
 
@@ -154,7 +219,8 @@ export const AgentRunsTab: React.FC = () => {
154
219
  setPage(1);
155
220
  };
156
221
 
157
- const fetchDetail = async (record: any) => {
222
+ const fetchDetail = async (record: RunRecord) => {
223
+ const requestId = ++detailRequestId.current;
158
224
  setSelectedRun(record);
159
225
  setDetailLoading(true);
160
226
  try {
@@ -162,9 +228,22 @@ export const AgentRunsTab: React.FC = () => {
162
228
  url: 'agentMonitor:get',
163
229
  params: { filterByTk: record.id },
164
230
  });
165
- setSelectedRun((res as any)?.data?.data?.data || (res as any)?.data?.data || record);
231
+ if (requestId !== detailRequestId.current) return;
232
+ const payload = res as { data?: { data?: { data?: RunRecord } | RunRecord } };
233
+ const detail =
234
+ (payload?.data?.data as { data?: RunRecord })?.data || (payload?.data?.data as RunRecord) || record;
235
+ setSelectedRun(detail);
236
+ } catch (error) {
237
+ if (requestId !== detailRequestId.current) return;
238
+ const text =
239
+ (error as RequestError)?.response?.data?.errors?.[0]?.message ||
240
+ (error as RequestError)?.message ||
241
+ t('Failed to load run detail');
242
+ message.error(text);
166
243
  } finally {
167
- setDetailLoading(false);
244
+ if (requestId === detailRequestId.current) {
245
+ setDetailLoading(false);
246
+ }
168
247
  }
169
248
  };
170
249
 
@@ -176,11 +255,14 @@ export const AgentRunsTab: React.FC = () => {
176
255
  method: 'post',
177
256
  data: { limit: 500 },
178
257
  });
179
- const result = (res as any)?.data?.data || {};
258
+ const result = (res as { data?: { data?: { created?: number } } })?.data?.data || {};
180
259
  message.success(t('Synced {{count}} native runs', { count: result.created || 0 }));
181
260
  refresh();
182
- } catch (error: any) {
183
- const text = error?.response?.data?.errors?.[0]?.message || error?.message || t('Sync failed');
261
+ } catch (error) {
262
+ const text =
263
+ (error as RequestError)?.response?.data?.errors?.[0]?.message ||
264
+ (error as RequestError)?.message ||
265
+ t('Sync failed');
184
266
  message.error(text);
185
267
  } finally {
186
268
  setSyncLoading(false);
@@ -188,9 +270,9 @@ export const AgentRunsTab: React.FC = () => {
188
270
  };
189
271
 
190
272
  const hasFilters = Boolean(filters.leader || filters.subAgent || filters.status);
191
- const trace = Array.isArray(selectedRun?.trace) ? selectedRun.trace : [];
192
- const toolMessages = Array.isArray(selectedRun?.toolMessages) ? selectedRun.toolMessages : [];
193
- const nativeMessages = Array.isArray(selectedRun?.nativeMessages) ? selectedRun.nativeMessages : [];
273
+ const trace: TraceItem[] = Array.isArray(selectedRun?.trace) ? selectedRun.trace : [];
274
+ const toolMessages: ToolMessage[] = Array.isArray(selectedRun?.toolMessages) ? selectedRun.toolMessages : [];
275
+ const nativeMessages: NativeMessage[] = Array.isArray(selectedRun?.nativeMessages) ? selectedRun.nativeMessages : [];
194
276
 
195
277
  const columns = [
196
278
  {
@@ -249,7 +331,7 @@ export const AgentRunsTab: React.FC = () => {
249
331
  title: '',
250
332
  key: 'actions',
251
333
  width: 90,
252
- render: (_: unknown, record: any) => (
334
+ render: (_: unknown, record: RunRecord) => (
253
335
  <Button type="link" size="small" icon={<EyeOutlined />} onClick={() => fetchDetail(record)}>
254
336
  {t('Detail')}
255
337
  </Button>
@@ -396,7 +478,7 @@ export const AgentRunsTab: React.FC = () => {
396
478
  <Card title={t('Execution Flow')} size="small">
397
479
  {trace.length ? (
398
480
  <Timeline
399
- items={trace.map((item: any) => ({
481
+ items={trace.map((item: TraceItem) => ({
400
482
  key: item.id,
401
483
  color: item.status === 'error' ? 'red' : item.status === 'running' ? 'blue' : 'green',
402
484
  children: (
@@ -426,7 +508,7 @@ export const AgentRunsTab: React.FC = () => {
426
508
  label: t('Native tool messages ({{count}})', { count: toolMessages.length }),
427
509
  children: toolMessages.length ? (
428
510
  <Table
429
- rowKey={(record: any) => `${record.sessionId}:${record.toolCallId}`}
511
+ rowKey={(record: ToolMessage) => `${record.sessionId}:${record.toolCallId}`}
430
512
  size="small"
431
513
  pagination={false}
432
514
  dataSource={toolMessages}
@@ -458,7 +540,7 @@ export const AgentRunsTab: React.FC = () => {
458
540
  label: t('Native messages ({{count}})', { count: nativeMessages.length }),
459
541
  children: nativeMessages.length ? (
460
542
  <Space direction="vertical" size={8} style={{ width: '100%' }}>
461
- {nativeMessages.map((item: any) => (
543
+ {nativeMessages.map((item: NativeMessage) => (
462
544
  <Card
463
545
  key={`${item.sessionId}:${item.messageId}`}
464
546
  size="small"
@@ -0,0 +1,337 @@
1
+ import React from 'react';
2
+ import { Button, Card, Descriptions, Drawer, Input, Radio, Space, Table, Tag, Typography, message } from 'antd';
3
+ import { CheckOutlined, CloseOutlined, EyeOutlined } from '@ant-design/icons';
4
+ import { useApiClient as useAPIClient, useRequest } from '../hooks/useApiRequest';
5
+ import { useT } from '../skill-hub/locale';
6
+
7
+ const { Text, Paragraph } = Typography;
8
+
9
+ type ApprovalRow = {
10
+ id: number;
11
+ runId: number;
12
+ toolCallId: string;
13
+ toolName: string;
14
+ actionType?: string | null;
15
+ proposedInput?: Record<string, unknown> | null;
16
+ editedInput?: Record<string, unknown> | null;
17
+ reason?: string | null;
18
+ decisionNote?: string | null;
19
+ status: string;
20
+ assignedToId?: number | null;
21
+ requestedAt?: string | null;
22
+ decidedAt?: string | null;
23
+ expiresAt?: string | null;
24
+ createdAt?: string | null;
25
+ };
26
+
27
+ const formatDate = (value?: string | null) => (value ? new Date(value).toLocaleString() : '-');
28
+
29
+ const isExpired = (row: ApprovalRow) =>
30
+ row.status === 'pending' && Boolean(row.expiresAt) && new Date(String(row.expiresAt)).getTime() <= Date.now();
31
+
32
+ function errorMessage(error: unknown, fallback: string) {
33
+ const response = error as { response?: { data?: { errors?: { message?: string }[] } } };
34
+ return response?.response?.data?.errors?.[0]?.message || (error as Error)?.message || fallback;
35
+ }
36
+
37
+ function statusTag(t: (key: string) => string, status: string) {
38
+ if (status === 'pending') return <Tag color="gold">{t('Pending')}</Tag>;
39
+ if (status === 'approved') return <Tag color="green">{t('Approved')}</Tag>;
40
+ if (status === 'rejected') return <Tag color="red">{t('Rejected')}</Tag>;
41
+ if (status === 'expired') return <Tag>{t('Expired')}</Tag>;
42
+ return <Tag>{status}</Tag>;
43
+ }
44
+
45
+ export const ApprovalsTab: React.FC = () => {
46
+ const api = useAPIClient();
47
+ const t = useT();
48
+ const [scope, setScope] = React.useState<'pending' | 'all'>('pending');
49
+ const [page, setPage] = React.useState(1);
50
+ const [reviewing, setReviewing] = React.useState<ApprovalRow | null>(null);
51
+ const [note, setNote] = React.useState('');
52
+ const [editedInputText, setEditedInputText] = React.useState('');
53
+ const [deciding, setDeciding] = React.useState<'approve' | 'reject' | null>(null);
54
+
55
+ const requestParams = React.useMemo(
56
+ () => ({
57
+ sort: ['-createdAt'],
58
+ page,
59
+ pageSize: 20,
60
+ filter: scope === 'pending' ? { status: 'pending' } : {},
61
+ }),
62
+ [scope, page],
63
+ );
64
+
65
+ const { data, loading, refresh } = useRequest<{ data?: ApprovalRow[]; meta?: { count?: number } }>(
66
+ {
67
+ url: 'agentLoopApprovals:list',
68
+ params: requestParams,
69
+ },
70
+ { refreshDeps: [requestParams] },
71
+ );
72
+
73
+ const rows = React.useMemo(() => {
74
+ const raw = data?.data;
75
+ return Array.isArray(raw) ? raw : [];
76
+ }, [data]);
77
+ const total = data?.meta?.count || 0;
78
+
79
+ const openReview = (row: ApprovalRow) => {
80
+ setReviewing(row);
81
+ setNote('');
82
+ setEditedInputText(JSON.stringify(row.proposedInput || {}, null, 2));
83
+ };
84
+
85
+ const closeReview = () => {
86
+ setReviewing(null);
87
+ setDeciding(null);
88
+ };
89
+
90
+ const decide = async (decision: 'approve' | 'reject') => {
91
+ if (!reviewing) return;
92
+ let editedInput: unknown;
93
+ if (decision === 'approve' && editedInputText.trim()) {
94
+ try {
95
+ editedInput = JSON.parse(editedInputText);
96
+ } catch (error) {
97
+ message.error(t('Edited input JSON is invalid: {{message}}', { message: (error as Error).message }));
98
+ return;
99
+ }
100
+ }
101
+ setDeciding(decision);
102
+ try {
103
+ await api.request({
104
+ url: 'agentLoopApprovals:decide',
105
+ method: 'post',
106
+ params: { filterByTk: reviewing.id },
107
+ data: {
108
+ decision,
109
+ note: note.trim(),
110
+ ...(editedInput !== undefined ? { editedInput } : {}),
111
+ },
112
+ });
113
+ message.success(t('Approval recorded'));
114
+ closeReview();
115
+ refresh();
116
+ } catch (error) {
117
+ message.error(t('Decision failed: {{message}}', { message: errorMessage(error, t('unknown error')) }));
118
+ setDeciding(null);
119
+ }
120
+ };
121
+
122
+ const columns = [
123
+ {
124
+ title: t('Run'),
125
+ dataIndex: 'runId',
126
+ key: 'runId',
127
+ width: 80,
128
+ render: (runId: number) => <Text>#{String(runId)}</Text>,
129
+ },
130
+ {
131
+ title: t('Tool'),
132
+ dataIndex: 'toolName',
133
+ key: 'toolName',
134
+ width: 180,
135
+ render: (toolName: string) => <Text code>{toolName}</Text>,
136
+ },
137
+ {
138
+ title: t('Type'),
139
+ dataIndex: 'actionType',
140
+ key: 'actionType',
141
+ width: 120,
142
+ render: (actionType?: string | null) =>
143
+ actionType === 'escalation' ? <Tag color="orange">{t('Escalation')}</Tag> : <Tag>{t('Tool call')}</Tag>,
144
+ },
145
+ {
146
+ title: t('Reason'),
147
+ dataIndex: 'reason',
148
+ key: 'reason',
149
+ ellipsis: true,
150
+ },
151
+ {
152
+ title: t('Requested'),
153
+ dataIndex: 'requestedAt',
154
+ key: 'requestedAt',
155
+ width: 170,
156
+ render: (value?: string | null) => formatDate(value),
157
+ },
158
+ {
159
+ title: t('Expires'),
160
+ dataIndex: 'expiresAt',
161
+ key: 'expiresAt',
162
+ width: 170,
163
+ render: (value: string | null | undefined, record: ApprovalRow) =>
164
+ isExpired(record) ? <Text type="danger">{formatDate(value)}</Text> : formatDate(value),
165
+ },
166
+ {
167
+ title: t('Status'),
168
+ dataIndex: 'status',
169
+ key: 'status',
170
+ width: 110,
171
+ render: (status: string) => statusTag(t, status),
172
+ },
173
+ {
174
+ title: t('Actions'),
175
+ key: 'actions',
176
+ width: 110,
177
+ render: (_: unknown, record: ApprovalRow) =>
178
+ record.status === 'pending' ? (
179
+ <Button type="link" size="small" icon={<EyeOutlined />} onClick={() => openReview(record)}>
180
+ {t('Review')}
181
+ </Button>
182
+ ) : null,
183
+ },
184
+ ];
185
+
186
+ const reviewExpired = reviewing ? isExpired(reviewing) : false;
187
+
188
+ return (
189
+ <div>
190
+ <Card bordered={false}>
191
+ <Space direction="vertical" size={16} style={{ width: '100%' }}>
192
+ <div style={{ display: 'flex', justifyContent: 'space-between', gap: 16 }}>
193
+ <Text type="secondary">
194
+ {t('Tool calls and escalations that need a human decision before the run continues.')}
195
+ </Text>
196
+ <Radio.Group
197
+ value={scope}
198
+ onChange={(event) => {
199
+ setScope(event.target.value);
200
+ setPage(1);
201
+ }}
202
+ >
203
+ <Radio.Button value="pending">{t('Pending')}</Radio.Button>
204
+ <Radio.Button value="all">{t('All')}</Radio.Button>
205
+ </Radio.Group>
206
+ </div>
207
+ <Table
208
+ rowKey="id"
209
+ loading={loading}
210
+ dataSource={rows}
211
+ columns={columns}
212
+ scroll={{ x: 'max-content' }}
213
+ pagination={{
214
+ current: page,
215
+ pageSize: 20,
216
+ total,
217
+ onChange: (next) => setPage(next),
218
+ showSizeChanger: false,
219
+ }}
220
+ />
221
+ </Space>
222
+ </Card>
223
+
224
+ <Drawer
225
+ title={t('Review approval')}
226
+ width={620}
227
+ open={Boolean(reviewing)}
228
+ onClose={closeReview}
229
+ footer={
230
+ reviewing && reviewing.status === 'pending' ? (
231
+ <Space style={{ display: 'flex', justifyContent: 'flex-end' }}>
232
+ <Button
233
+ danger
234
+ icon={<CloseOutlined />}
235
+ loading={deciding === 'reject'}
236
+ disabled={reviewExpired}
237
+ onClick={() => decide('reject')}
238
+ >
239
+ {t('Reject')}
240
+ </Button>
241
+ <Button
242
+ type="primary"
243
+ icon={<CheckOutlined />}
244
+ loading={deciding === 'approve'}
245
+ disabled={reviewExpired}
246
+ onClick={() => decide('approve')}
247
+ >
248
+ {t('Approve')}
249
+ </Button>
250
+ </Space>
251
+ ) : null
252
+ }
253
+ >
254
+ {reviewing && (
255
+ <Space direction="vertical" size={16} style={{ width: '100%' }}>
256
+ <Descriptions column={1} size="small" bordered>
257
+ <Descriptions.Item label={t('Run')}>#{String(reviewing.runId)}</Descriptions.Item>
258
+ <Descriptions.Item label={t('Tool')}>
259
+ <Text code>{reviewing.toolName}</Text>
260
+ </Descriptions.Item>
261
+ <Descriptions.Item label={t('Type')}>
262
+ {reviewing.actionType === 'escalation' ? (
263
+ <Tag color="orange">{t('Escalation')}</Tag>
264
+ ) : (
265
+ <Tag>{t('Tool call')}</Tag>
266
+ )}
267
+ </Descriptions.Item>
268
+ <Descriptions.Item label={t('Requested')}>{formatDate(reviewing.requestedAt)}</Descriptions.Item>
269
+ <Descriptions.Item label={t('Expires')}>
270
+ {reviewExpired ? (
271
+ <Text type="danger">{formatDate(reviewing.expiresAt)}</Text>
272
+ ) : (
273
+ formatDate(reviewing.expiresAt)
274
+ )}
275
+ </Descriptions.Item>
276
+ <Descriptions.Item label={t('Status')}>{statusTag(t, reviewing.status)}</Descriptions.Item>
277
+ </Descriptions>
278
+
279
+ {reviewing.reason && <Paragraph style={{ marginBottom: 0 }}>{reviewing.reason}</Paragraph>}
280
+ {reviewExpired && (
281
+ <Text type="danger">
282
+ {t('The approval window has expired. Retry the run to request approval again.')}
283
+ </Text>
284
+ )}
285
+
286
+ <div>
287
+ <Text strong>{t('Proposed input')}</Text>
288
+ <Input.TextArea
289
+ aria-label={t('Proposed input')}
290
+ rows={6}
291
+ readOnly
292
+ value={JSON.stringify(reviewing.proposedInput || {}, null, 2)}
293
+ spellCheck={false}
294
+ style={{ marginTop: 8 }}
295
+ />
296
+ </div>
297
+
298
+ {reviewing.status === 'pending' && (
299
+ <>
300
+ <div>
301
+ <Text strong>{t('Edited input (optional)')}</Text>
302
+ <Text type="secondary" style={{ display: 'block', marginBottom: 8 }}>
303
+ {t('Approving sends this input to the tool instead of the proposed one.')}
304
+ </Text>
305
+ <Input.TextArea
306
+ aria-label={t('Edited input (optional)')}
307
+ rows={6}
308
+ spellCheck={false}
309
+ value={editedInputText}
310
+ onChange={(event) => setEditedInputText(event.target.value)}
311
+ />
312
+ </div>
313
+ <div>
314
+ <Text strong>{t('Decision note')}</Text>
315
+ <Input.TextArea
316
+ aria-label={t('Decision note')}
317
+ rows={2}
318
+ value={note}
319
+ onChange={(event) => setNote(event.target.value)}
320
+ style={{ marginTop: 8 }}
321
+ />
322
+ </div>
323
+ </>
324
+ )}
325
+
326
+ {reviewing.status !== 'pending' && reviewing.decisionNote && (
327
+ <div>
328
+ <Text strong>{t('Decision note')}</Text>
329
+ <Paragraph style={{ marginBottom: 0, marginTop: 8 }}>{reviewing.decisionNote}</Paragraph>
330
+ </div>
331
+ )}
332
+ </Space>
333
+ )}
334
+ </Drawer>
335
+ </div>
336
+ );
337
+ };