plugin-agent-orchestrator 1.1.4 → 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 (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
@@ -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
+ };