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.
- package/README.md +204 -114
- package/dist/client/index.js +1 -1
- package/dist/client-v2/117.7565cff57c39318a.js +10 -0
- package/dist/client-v2/214.106635011859dede.js +10 -0
- package/dist/client-v2/418.41ed200e7d6da332.js +10 -0
- package/dist/client-v2/53.349fff8db80b19d4.js +10 -0
- package/dist/client-v2/981.e4a1f41cfc94a856.js +10 -0
- package/dist/client-v2/index.js +1 -1
- package/dist/externalVersion.js +7 -8
- package/dist/locale/en-US.json +226 -170
- package/dist/locale/vi-VN.json +226 -170
- package/dist/locale/zh-CN.json +226 -170
- package/dist/server/collections/agent-execution-spans.js +8 -0
- package/dist/server/collections/agent-loop-action-approvals.js +1 -0
- package/dist/server/collections/agent-loop-runs.js +7 -1
- package/dist/server/collections/agent-loop-steps.js +7 -0
- package/dist/server/collections/skill-executions.js +8 -0
- package/dist/server/plugin.js +3 -1
- package/dist/server/resources/agent-harness-profile.js +117 -0
- package/dist/server/resources/agent-knowledge-insights.js +1 -3
- package/dist/server/resources/agent-loop-approval.js +25 -0
- package/dist/server/resources/agent-loop.js +3 -1
- package/dist/server/services/AgentMemoryContextService.js +34 -0
- package/dist/server/services/HarnessCompiler.js +35 -2
- package/dist/server/services/HarnessProfileService.js +74 -9
- package/dist/server/services/HarnessSchema.js +30 -3
- package/dist/server/services/LoopPatternSchema.js +16 -1
- package/dist/server/services/LoopRunRepository.js +80 -0
- package/dist/server/services/LoopRunStateMachine.js +92 -3
- package/dist/server/services/LoopTriggerService.js +37 -0
- package/dist/server/services/LoopWorkerService.js +261 -23
- package/dist/server/services/NativeSubAgentObserver.js +165 -23
- package/dist/server/services/PluginAiRuntimeAdapter.js +16 -5
- package/dist/server/services/ToolLoopDetectionService.js +210 -0
- package/dist/server/services/VerificationService.js +66 -0
- package/dist/server/services/harness-runtime-policy.js +139 -0
- package/dist/server/skill-hub/plugin.js +36 -3
- package/dist/server/skill-hub/tasks/SkillExecutionTask.js +29 -0
- package/package.json +53 -53
- package/src/client/ApprovalsTab.tsx +2 -0
- package/src/client/OrchestratorSettings.tsx +11 -0
- package/src/client/skill-hub/components/GitSkillImport.tsx +3 -3
- package/src/client/skill-hub/components/SkillMetrics.tsx +15 -10
- package/src/client/skill-hub/index.tsx +0 -52
- package/src/client-v2/components/AgentRunsTab.tsx +576 -576
- package/src/client-v2/components/ApprovalsTab.tsx +337 -0
- package/src/client-v2/components/HarnessProfilesTab.tsx +385 -105
- package/src/client-v2/components/MemoryInspectorTab.tsx +141 -141
- package/src/client-v2/components/TracingTab.tsx +515 -515
- package/src/client-v2/hooks/useApiRequest.ts +141 -141
- package/src/client-v2/pages/ApprovalsPage.tsx +10 -0
- package/src/client-v2/plugin.tsx +6 -6
- package/src/client-v2/skill-hub/components/SkillMetrics.tsx +5 -2
- package/src/locale/en-US.json +226 -174
- package/src/locale/vi-VN.json +226 -174
- package/src/locale/zh-CN.json +226 -174
- package/src/server/__tests__/circuit-breaker.test.ts +248 -248
- package/src/server/__tests__/harness-compiler.test.ts +83 -0
- package/src/server/__tests__/harness-profile-service.test.ts +51 -0
- package/src/server/__tests__/harness-runtime-policy.test.ts +293 -0
- package/src/server/__tests__/harness-tool-plan.test.ts +24 -0
- package/src/server/__tests__/loop-approval-decision.test.ts +512 -0
- package/src/server/__tests__/loop-approval-expiry.test.ts +258 -0
- package/src/server/__tests__/loop-budget-service.test.ts +255 -255
- package/src/server/__tests__/loop-control-plane-backfill.test.ts +266 -266
- package/src/server/__tests__/loop-pattern-schema.test.ts +18 -1
- package/src/server/__tests__/loop-pattern-service.test.ts +148 -148
- package/src/server/__tests__/loop-run-state-machine.test.ts +11 -0
- package/src/server/__tests__/loop-trigger-service.test.ts +148 -0
- package/src/server/__tests__/loop-worker-claim.test.ts +341 -341
- package/src/server/__tests__/loop-worker-execution.test.ts +82 -1
- package/src/server/__tests__/native-sub-agent-observer.test.ts +288 -4
- package/src/server/__tests__/path-lock-service.test.ts +254 -254
- package/src/server/__tests__/skill-execution-task-policy.test.ts +140 -0
- package/src/server/__tests__/smoke.test.ts +162 -162
- package/src/server/__tests__/tool-loop-detection.test.ts +275 -0
- package/src/server/collections/agent-execution-spans.ts +8 -0
- package/src/server/collections/agent-harness-profile-versions.ts +26 -26
- package/src/server/collections/agent-harness-profiles.ts +71 -71
- package/src/server/collections/agent-loop-action-approvals.ts +1 -0
- package/src/server/collections/agent-loop-artifacts.ts +25 -25
- package/src/server/collections/agent-loop-circuit-states.ts +23 -23
- package/src/server/collections/agent-loop-control-settings.ts +21 -21
- package/src/server/collections/agent-loop-events.ts +98 -98
- package/src/server/collections/agent-loop-path-locks.ts +27 -27
- package/src/server/collections/agent-loop-patterns.ts +42 -42
- package/src/server/collections/agent-loop-runs.ts +7 -1
- package/src/server/collections/agent-loop-steps.ts +7 -0
- package/src/server/collections/agent-loop-usage-buckets.ts +22 -22
- package/src/server/collections/agent-loop-worktrees.ts +25 -25
- package/src/server/collections/skill-executions.ts +8 -0
- package/src/server/migrations/20260427000002-change-packages-to-text.ts +52 -52
- package/src/server/migrations/20260429000000-add-llm-fields.ts +47 -47
- package/src/server/migrations/20260429000001-fix-inputargs-json-to-text.ts +45 -45
- package/src/server/migrations/20260503000000-add-orchestrator-trace-fields.ts +33 -33
- package/src/server/migrations/20260524000000-add-agent-loop-fields-to-skill-executions.ts +31 -31
- package/src/server/migrations/20260803010000-backfill-loop-control-plane-data.ts +293 -293
- package/src/server/plugin.ts +3 -1
- package/src/server/resources/agent-harness-profile.ts +94 -0
- package/src/server/resources/agent-knowledge-insights.ts +5 -3
- package/src/server/resources/agent-loop-approval.ts +32 -0
- package/src/server/resources/agent-loop-artifact.ts +56 -56
- package/src/server/resources/agent-loop-events-stream.ts +105 -105
- package/src/server/resources/agent-loop.ts +3 -1
- package/src/server/resources/resource-helpers.ts +33 -33
- package/src/server/resources/tracing.ts +266 -266
- package/src/server/services/AgentMemoryContextService.ts +44 -0
- package/src/server/services/DurableCircuitBreakerService.ts +239 -239
- package/src/server/services/ExecutionSpanService.ts +2 -0
- package/src/server/services/HarnessCompiler.ts +37 -0
- package/src/server/services/HarnessProfileService.ts +92 -10
- package/src/server/services/HarnessSchema.ts +31 -0
- package/src/server/services/LoopBudgetService.ts +275 -275
- package/src/server/services/LoopControlService.ts +124 -124
- package/src/server/services/LoopPatternSchema.ts +19 -1
- package/src/server/services/LoopPatternService.ts +143 -143
- package/src/server/services/LoopRunRepository.ts +99 -0
- package/src/server/services/LoopRunStateMachine.ts +100 -3
- package/src/server/services/LoopSchedulerService.ts +199 -199
- package/src/server/services/LoopTriggerService.ts +42 -0
- package/src/server/services/LoopWorkerService.ts +327 -27
- package/src/server/services/NativeSubAgentObserver.ts +186 -21
- package/src/server/services/PathLockService.ts +321 -321
- package/src/server/services/PluginAiRuntimeAdapter.ts +24 -7
- package/src/server/services/ToolLoopDetectionService.ts +213 -0
- package/src/server/services/VerificationSchema.ts +31 -31
- package/src/server/services/VerificationService.ts +81 -2
- package/src/server/services/harness-runtime-policy.ts +141 -0
- package/src/server/skill-hub/plugin.ts +41 -3
- package/src/server/skill-hub/services/RegistrySkillSnapshotService.ts +235 -235
- package/src/server/skill-hub/services/__tests__/RegistrySkillSnapshotService.test.ts +61 -61
- package/src/server/skill-hub/tasks/SkillExecutionTask.ts +43 -2
- package/src/server/utils/ensure-indexes.ts +96 -96
- package/src/server/utils/logging.ts +62 -62
- package/src/server/utils/loop-pattern-context.ts +20 -20
- package/dist/client-v2/214.b063f33ba044a808.js +0 -10
- package/dist/client-v2/373.f5d5292e53c4e832.js +0 -10
- package/dist/client-v2/418.58fa350f5496efd3.js +0 -10
- package/dist/client-v2/53.9a10455323390f14.js +0 -10
- package/dist/client-v2/677.a991ce0250ff5c77.js +0 -10
- package/dist/client-v2/925.e5925bf21ed68e7a.js +0 -10
- package/src/client/AIEmployeeSelect.tsx +0 -47
- package/src/client/AIEmployeesContext.tsx +0 -102
- package/src/client/RulesTab.tsx +0 -2
- package/src/client/TracingTab.tsx +0 -436
- package/src/client/skill-hub/components/ExecutionProgress.tsx +0 -51
- package/src/client-v2/components/RulesTab.tsx +0 -2
- package/src/client-v2/pages/AgentRunsPage.tsx +0 -13
|
@@ -1,293 +1,293 @@
|
|
|
1
|
-
import { Migration } from '@nocobase/server';
|
|
2
|
-
import { validateHarnessSettings } from '../services/HarnessSchema';
|
|
3
|
-
import { loopPatternPolicySchema } from '../services/LoopPatternSchema';
|
|
4
|
-
import { ensureAgentOrchestratorIndexes } from '../utils/ensure-indexes';
|
|
5
|
-
|
|
6
|
-
type MigrationRecord = Record<string, unknown> & {
|
|
7
|
-
get?: (key: string) => unknown;
|
|
8
|
-
toJSON?: () => Record<string, unknown>;
|
|
9
|
-
};
|
|
10
|
-
|
|
11
|
-
type MigrationRepository = {
|
|
12
|
-
find(options?: Record<string, unknown>): Promise<MigrationRecord[]>;
|
|
13
|
-
findOne(options: Record<string, unknown>): Promise<MigrationRecord | null>;
|
|
14
|
-
create(options: Record<string, unknown>): Promise<MigrationRecord>;
|
|
15
|
-
update(options: Record<string, unknown>): Promise<unknown>;
|
|
16
|
-
};
|
|
17
|
-
|
|
18
|
-
type MigrationDatabase = {
|
|
19
|
-
getRepository(name: string): MigrationRepository | undefined;
|
|
20
|
-
sequelize: {
|
|
21
|
-
transaction<T>(callback: (transaction: unknown) => Promise<T>): Promise<T>;
|
|
22
|
-
};
|
|
23
|
-
};
|
|
24
|
-
|
|
25
|
-
const LEGACY_TERMINAL_STATUSES = new Set(['succeeded', 'failed', 'rejected', 'canceled']);
|
|
26
|
-
const CONTROL_PLANE_STATUSES = new Set([
|
|
27
|
-
'queued',
|
|
28
|
-
'preparing',
|
|
29
|
-
'waiting_lock',
|
|
30
|
-
'running',
|
|
31
|
-
'waiting_approval',
|
|
32
|
-
'verifying',
|
|
33
|
-
'waiting_human',
|
|
34
|
-
'paused',
|
|
35
|
-
'blocked',
|
|
36
|
-
'succeeded',
|
|
37
|
-
'failed',
|
|
38
|
-
'canceled',
|
|
39
|
-
]);
|
|
40
|
-
const LEGACY_PLAN_STATUSES = new Set([
|
|
41
|
-
'planning',
|
|
42
|
-
'waiting_plan_approval',
|
|
43
|
-
'approved',
|
|
44
|
-
'waiting_user',
|
|
45
|
-
'needs_replan',
|
|
46
|
-
'rejected',
|
|
47
|
-
]);
|
|
48
|
-
|
|
49
|
-
const BACKFILL_BATCH_SIZE = 500;
|
|
50
|
-
|
|
51
|
-
async function* iterateInBatches(
|
|
52
|
-
repository: MigrationRepository,
|
|
53
|
-
options: Record<string, unknown> = {},
|
|
54
|
-
): AsyncGenerator<MigrationRecord> {
|
|
55
|
-
let page = 1;
|
|
56
|
-
for (;;) {
|
|
57
|
-
const batch = await repository.find({ ...options, sort: ['id'], page, pageSize: BACKFILL_BATCH_SIZE });
|
|
58
|
-
if (!batch.length) return;
|
|
59
|
-
for (const record of batch) {
|
|
60
|
-
yield record;
|
|
61
|
-
}
|
|
62
|
-
if (batch.length < BACKFILL_BATCH_SIZE) return;
|
|
63
|
-
page += 1;
|
|
64
|
-
}
|
|
65
|
-
}
|
|
66
|
-
|
|
67
|
-
function readValue(record: MigrationRecord, key: string) {
|
|
68
|
-
return typeof record.get === 'function' ? record.get(key) : record[key];
|
|
69
|
-
}
|
|
70
|
-
|
|
71
|
-
function asObject(value: unknown): Record<string, unknown> {
|
|
72
|
-
return value && typeof value === 'object' && !Array.isArray(value) ? (value as Record<string, unknown>) : {};
|
|
73
|
-
}
|
|
74
|
-
|
|
75
|
-
function positiveInteger(value: unknown) {
|
|
76
|
-
const parsed = typeof value === 'number' ? value : Number(value);
|
|
77
|
-
return Number.isSafeInteger(parsed) && parsed > 0 ? parsed : null;
|
|
78
|
-
}
|
|
79
|
-
|
|
80
|
-
function stringValue(value: unknown) {
|
|
81
|
-
return typeof value === 'string' ? value : '';
|
|
82
|
-
}
|
|
83
|
-
|
|
84
|
-
function isPublishedValidVersion(version: MigrationRecord) {
|
|
85
|
-
return (
|
|
86
|
-
readValue(version, 'status') === 'published' && validateHarnessSettings(readValue(version, 'settings')).success
|
|
87
|
-
);
|
|
88
|
-
}
|
|
89
|
-
|
|
90
|
-
async function backfillHarnessProfiles(db: MigrationDatabase) {
|
|
91
|
-
const profiles = db.getRepository('agentHarnessProfiles');
|
|
92
|
-
const versions = db.getRepository('agentHarnessProfileVersions');
|
|
93
|
-
if (!profiles || !versions) return;
|
|
94
|
-
|
|
95
|
-
for await (const profile of iterateInBatches(profiles)) {
|
|
96
|
-
const profileId = positiveInteger(readValue(profile, 'id'));
|
|
97
|
-
if (!profileId) continue;
|
|
98
|
-
|
|
99
|
-
await db.sequelize.transaction(async (transaction) => {
|
|
100
|
-
const allVersions = await versions.find({ filter: { profileId }, sort: ['-version'], transaction });
|
|
101
|
-
const currentVersionId = positiveInteger(readValue(profile, 'currentVersionId'));
|
|
102
|
-
const current = currentVersionId ? await versions.findOne({ filterByTk: currentVersionId, transaction }) : null;
|
|
103
|
-
if (current && isPublishedValidVersion(current)) return;
|
|
104
|
-
|
|
105
|
-
const published = allVersions.find(isPublishedValidVersion);
|
|
106
|
-
if (published) {
|
|
107
|
-
const publishedId = positiveInteger(readValue(published, 'id'));
|
|
108
|
-
if (publishedId && currentVersionId !== publishedId) {
|
|
109
|
-
await profiles.update({
|
|
110
|
-
filterByTk: profileId,
|
|
111
|
-
values: { currentVersionId: publishedId },
|
|
112
|
-
transaction,
|
|
113
|
-
});
|
|
114
|
-
}
|
|
115
|
-
return;
|
|
116
|
-
}
|
|
117
|
-
|
|
118
|
-
const settingsResult = validateHarnessSettings(readValue(profile, 'settings'));
|
|
119
|
-
if (!settingsResult.success) return;
|
|
120
|
-
const settings = settingsResult.data;
|
|
121
|
-
const nextVersion =
|
|
122
|
-
allVersions.reduce((maximum, version) => Math.max(maximum, Number(readValue(version, 'version')) || 0), 0) + 1;
|
|
123
|
-
const version = await versions.create({
|
|
124
|
-
values: {
|
|
125
|
-
profileId,
|
|
126
|
-
version: nextVersion,
|
|
127
|
-
schemaVersion: positiveInteger(readValue(profile, 'schemaVersion')) || 1,
|
|
128
|
-
status: 'published',
|
|
129
|
-
settings,
|
|
130
|
-
publishedAt: readValue(profile, 'updatedAt') || readValue(profile, 'createdAt') || new Date(),
|
|
131
|
-
},
|
|
132
|
-
transaction,
|
|
133
|
-
});
|
|
134
|
-
const versionId = positiveInteger(readValue(version, 'id'));
|
|
135
|
-
if (versionId) {
|
|
136
|
-
await profiles.update({
|
|
137
|
-
filterByTk: profileId,
|
|
138
|
-
values: { currentVersionId: versionId },
|
|
139
|
-
transaction,
|
|
140
|
-
});
|
|
141
|
-
}
|
|
142
|
-
});
|
|
143
|
-
}
|
|
144
|
-
}
|
|
145
|
-
|
|
146
|
-
function hasLegacyPlanFields(run: MigrationRecord, status: string) {
|
|
147
|
-
const metadata = asObject(readValue(run, 'metadata'));
|
|
148
|
-
return (
|
|
149
|
-
LEGACY_PLAN_STATUSES.has(status) ||
|
|
150
|
-
Boolean(stringValue(readValue(run, 'planSource')).trim()) ||
|
|
151
|
-
Boolean(stringValue(readValue(run, 'plannerModel')).trim()) ||
|
|
152
|
-
Boolean(stringValue(metadata.planSource).trim()) ||
|
|
153
|
-
Boolean(stringValue(metadata.plannerModel).trim()) ||
|
|
154
|
-
Boolean(stringValue(metadata.approvalMode).trim())
|
|
155
|
-
);
|
|
156
|
-
}
|
|
157
|
-
|
|
158
|
-
function isValidControlPlaneRun(run: MigrationRecord) {
|
|
159
|
-
const runtimeVersion = stringValue(readValue(run, 'runtimeVersion'));
|
|
160
|
-
const status = stringValue(readValue(run, 'status'));
|
|
161
|
-
const patternId = positiveInteger(readValue(run, 'patternId'));
|
|
162
|
-
return (
|
|
163
|
-
runtimeVersion === 'control-plane-v2' &&
|
|
164
|
-
CONTROL_PLANE_STATUSES.has(status) &&
|
|
165
|
-
!hasLegacyPlanFields(run, status) &&
|
|
166
|
-
patternId !== null &&
|
|
167
|
-
loopPatternPolicySchema.safeParse(readValue(run, 'policySnapshot')).success
|
|
168
|
-
);
|
|
169
|
-
}
|
|
170
|
-
|
|
171
|
-
async function backfillLegacyRuns(db: MigrationDatabase) {
|
|
172
|
-
const runs = db.getRepository('agentLoopRuns');
|
|
173
|
-
const steps = db.getRepository('agentLoopSteps');
|
|
174
|
-
const events = db.getRepository('agentLoopEvents');
|
|
175
|
-
if (!runs || !steps || !events) return;
|
|
176
|
-
|
|
177
|
-
for await (const run of iterateInBatches(runs)) {
|
|
178
|
-
const runId = positiveInteger(readValue(run, 'id'));
|
|
179
|
-
if (!runId || isValidControlPlaneRun(run)) continue;
|
|
180
|
-
|
|
181
|
-
const metadata = asObject(readValue(run, 'metadata'));
|
|
182
|
-
const statusValue = stringValue(readValue(run, 'status'));
|
|
183
|
-
const preservedLegacyStatus = stringValue(metadata.legacyStatus);
|
|
184
|
-
const legacyStatus = preservedLegacyStatus || statusValue || 'unknown';
|
|
185
|
-
const isTerminal = LEGACY_TERMINAL_STATUSES.has(legacyStatus);
|
|
186
|
-
const correlationKey = `legacy-runtime-retired:${runId}`;
|
|
187
|
-
if (readValue(run, 'runtimeVersion') === 'legacy-plan-v1' && metadata.legacyRuntimeRetired === true) continue;
|
|
188
|
-
|
|
189
|
-
await db.sequelize.transaction(async (transaction) => {
|
|
190
|
-
await runs.update({
|
|
191
|
-
filterByTk: runId,
|
|
192
|
-
values: {
|
|
193
|
-
runtimeVersion: 'legacy-plan-v1',
|
|
194
|
-
recordMode: 'legacy-plan',
|
|
195
|
-
...(isTerminal
|
|
196
|
-
? {}
|
|
197
|
-
: {
|
|
198
|
-
status: 'blocked',
|
|
199
|
-
blockedReason: 'The legacy plan runtime was retired. This historical run is read-only.',
|
|
200
|
-
lockedBy: null,
|
|
201
|
-
lockedUntil: null,
|
|
202
|
-
}),
|
|
203
|
-
metadata: {
|
|
204
|
-
...metadata,
|
|
205
|
-
legacyStatus,
|
|
206
|
-
legacyRuntimeRetired: true,
|
|
207
|
-
},
|
|
208
|
-
},
|
|
209
|
-
transaction,
|
|
210
|
-
});
|
|
211
|
-
await steps.update({
|
|
212
|
-
filter: { runId },
|
|
213
|
-
values: { runtimeVersion: 'legacy-plan-v1' },
|
|
214
|
-
transaction,
|
|
215
|
-
});
|
|
216
|
-
|
|
217
|
-
if (!isTerminal) {
|
|
218
|
-
const existingEvent = await events.findOne({
|
|
219
|
-
filter: { runId, type: 'legacy_runtime_retired', correlationKey },
|
|
220
|
-
transaction,
|
|
221
|
-
});
|
|
222
|
-
if (!existingEvent) {
|
|
223
|
-
await events.create({
|
|
224
|
-
values: {
|
|
225
|
-
runId,
|
|
226
|
-
type: 'legacy_runtime_retired',
|
|
227
|
-
title: 'Legacy runtime retired',
|
|
228
|
-
content: 'The nonterminal plan-era run was blocked during the Loop Control Plane cutover.',
|
|
229
|
-
status: 'blocked',
|
|
230
|
-
payload: { legacyStatus },
|
|
231
|
-
actorType: 'system',
|
|
232
|
-
actorIdentity: 'loop-control-plane-migration',
|
|
233
|
-
correlationKey,
|
|
234
|
-
createdAt: new Date(),
|
|
235
|
-
},
|
|
236
|
-
transaction,
|
|
237
|
-
});
|
|
238
|
-
}
|
|
239
|
-
}
|
|
240
|
-
});
|
|
241
|
-
}
|
|
242
|
-
}
|
|
243
|
-
|
|
244
|
-
async function backfillSpanRunLinks(db: MigrationDatabase) {
|
|
245
|
-
const spans = db.getRepository('agentExecutionSpans');
|
|
246
|
-
if (!spans) return;
|
|
247
|
-
|
|
248
|
-
for await (const span of iterateInBatches(spans)) {
|
|
249
|
-
if (positiveInteger(readValue(span, 'agentLoopRunId'))) continue;
|
|
250
|
-
const runId = positiveInteger(asObject(readValue(span, 'metadata')).agentLoopRunId);
|
|
251
|
-
const spanId = positiveInteger(readValue(span, 'id'));
|
|
252
|
-
if (!runId || !spanId) continue;
|
|
253
|
-
|
|
254
|
-
await spans.update({
|
|
255
|
-
filterByTk: spanId,
|
|
256
|
-
values: { agentLoopRunId: runId },
|
|
257
|
-
});
|
|
258
|
-
}
|
|
259
|
-
}
|
|
260
|
-
|
|
261
|
-
async function ensureGlobalControl(db: MigrationDatabase) {
|
|
262
|
-
const controls = db.getRepository('agentLoopControlSettings');
|
|
263
|
-
if (!controls) return;
|
|
264
|
-
const existing = await controls.findOne({ filter: { key: 'global' } });
|
|
265
|
-
if (existing) return;
|
|
266
|
-
await controls.create({
|
|
267
|
-
values: {
|
|
268
|
-
key: 'global',
|
|
269
|
-
acceptNewRuns: true,
|
|
270
|
-
state: 'running',
|
|
271
|
-
globalMaxConcurrency: 5,
|
|
272
|
-
createdAt: new Date(),
|
|
273
|
-
updatedAt: new Date(),
|
|
274
|
-
},
|
|
275
|
-
});
|
|
276
|
-
}
|
|
277
|
-
|
|
278
|
-
export async function backfillLoopControlPlaneData(db: MigrationDatabase) {
|
|
279
|
-
await backfillHarnessProfiles(db);
|
|
280
|
-
await backfillLegacyRuns(db);
|
|
281
|
-
await backfillSpanRunLinks(db);
|
|
282
|
-
await ensureGlobalControl(db);
|
|
283
|
-
}
|
|
284
|
-
|
|
285
|
-
export default class BackfillLoopControlPlaneData extends Migration {
|
|
286
|
-
on = 'afterLoad';
|
|
287
|
-
appVersion = '>=0.1.0';
|
|
288
|
-
|
|
289
|
-
async up() {
|
|
290
|
-
await backfillLoopControlPlaneData(this.db as unknown as MigrationDatabase);
|
|
291
|
-
await ensureAgentOrchestratorIndexes(this.db);
|
|
292
|
-
}
|
|
293
|
-
}
|
|
1
|
+
import { Migration } from '@nocobase/server';
|
|
2
|
+
import { validateHarnessSettings } from '../services/HarnessSchema';
|
|
3
|
+
import { loopPatternPolicySchema } from '../services/LoopPatternSchema';
|
|
4
|
+
import { ensureAgentOrchestratorIndexes } from '../utils/ensure-indexes';
|
|
5
|
+
|
|
6
|
+
type MigrationRecord = Record<string, unknown> & {
|
|
7
|
+
get?: (key: string) => unknown;
|
|
8
|
+
toJSON?: () => Record<string, unknown>;
|
|
9
|
+
};
|
|
10
|
+
|
|
11
|
+
type MigrationRepository = {
|
|
12
|
+
find(options?: Record<string, unknown>): Promise<MigrationRecord[]>;
|
|
13
|
+
findOne(options: Record<string, unknown>): Promise<MigrationRecord | null>;
|
|
14
|
+
create(options: Record<string, unknown>): Promise<MigrationRecord>;
|
|
15
|
+
update(options: Record<string, unknown>): Promise<unknown>;
|
|
16
|
+
};
|
|
17
|
+
|
|
18
|
+
type MigrationDatabase = {
|
|
19
|
+
getRepository(name: string): MigrationRepository | undefined;
|
|
20
|
+
sequelize: {
|
|
21
|
+
transaction<T>(callback: (transaction: unknown) => Promise<T>): Promise<T>;
|
|
22
|
+
};
|
|
23
|
+
};
|
|
24
|
+
|
|
25
|
+
const LEGACY_TERMINAL_STATUSES = new Set(['succeeded', 'failed', 'rejected', 'canceled']);
|
|
26
|
+
const CONTROL_PLANE_STATUSES = new Set([
|
|
27
|
+
'queued',
|
|
28
|
+
'preparing',
|
|
29
|
+
'waiting_lock',
|
|
30
|
+
'running',
|
|
31
|
+
'waiting_approval',
|
|
32
|
+
'verifying',
|
|
33
|
+
'waiting_human',
|
|
34
|
+
'paused',
|
|
35
|
+
'blocked',
|
|
36
|
+
'succeeded',
|
|
37
|
+
'failed',
|
|
38
|
+
'canceled',
|
|
39
|
+
]);
|
|
40
|
+
const LEGACY_PLAN_STATUSES = new Set([
|
|
41
|
+
'planning',
|
|
42
|
+
'waiting_plan_approval',
|
|
43
|
+
'approved',
|
|
44
|
+
'waiting_user',
|
|
45
|
+
'needs_replan',
|
|
46
|
+
'rejected',
|
|
47
|
+
]);
|
|
48
|
+
|
|
49
|
+
const BACKFILL_BATCH_SIZE = 500;
|
|
50
|
+
|
|
51
|
+
async function* iterateInBatches(
|
|
52
|
+
repository: MigrationRepository,
|
|
53
|
+
options: Record<string, unknown> = {},
|
|
54
|
+
): AsyncGenerator<MigrationRecord> {
|
|
55
|
+
let page = 1;
|
|
56
|
+
for (;;) {
|
|
57
|
+
const batch = await repository.find({ ...options, sort: ['id'], page, pageSize: BACKFILL_BATCH_SIZE });
|
|
58
|
+
if (!batch.length) return;
|
|
59
|
+
for (const record of batch) {
|
|
60
|
+
yield record;
|
|
61
|
+
}
|
|
62
|
+
if (batch.length < BACKFILL_BATCH_SIZE) return;
|
|
63
|
+
page += 1;
|
|
64
|
+
}
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
function readValue(record: MigrationRecord, key: string) {
|
|
68
|
+
return typeof record.get === 'function' ? record.get(key) : record[key];
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
function asObject(value: unknown): Record<string, unknown> {
|
|
72
|
+
return value && typeof value === 'object' && !Array.isArray(value) ? (value as Record<string, unknown>) : {};
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
function positiveInteger(value: unknown) {
|
|
76
|
+
const parsed = typeof value === 'number' ? value : Number(value);
|
|
77
|
+
return Number.isSafeInteger(parsed) && parsed > 0 ? parsed : null;
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
function stringValue(value: unknown) {
|
|
81
|
+
return typeof value === 'string' ? value : '';
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
function isPublishedValidVersion(version: MigrationRecord) {
|
|
85
|
+
return (
|
|
86
|
+
readValue(version, 'status') === 'published' && validateHarnessSettings(readValue(version, 'settings')).success
|
|
87
|
+
);
|
|
88
|
+
}
|
|
89
|
+
|
|
90
|
+
async function backfillHarnessProfiles(db: MigrationDatabase) {
|
|
91
|
+
const profiles = db.getRepository('agentHarnessProfiles');
|
|
92
|
+
const versions = db.getRepository('agentHarnessProfileVersions');
|
|
93
|
+
if (!profiles || !versions) return;
|
|
94
|
+
|
|
95
|
+
for await (const profile of iterateInBatches(profiles)) {
|
|
96
|
+
const profileId = positiveInteger(readValue(profile, 'id'));
|
|
97
|
+
if (!profileId) continue;
|
|
98
|
+
|
|
99
|
+
await db.sequelize.transaction(async (transaction) => {
|
|
100
|
+
const allVersions = await versions.find({ filter: { profileId }, sort: ['-version'], transaction });
|
|
101
|
+
const currentVersionId = positiveInteger(readValue(profile, 'currentVersionId'));
|
|
102
|
+
const current = currentVersionId ? await versions.findOne({ filterByTk: currentVersionId, transaction }) : null;
|
|
103
|
+
if (current && isPublishedValidVersion(current)) return;
|
|
104
|
+
|
|
105
|
+
const published = allVersions.find(isPublishedValidVersion);
|
|
106
|
+
if (published) {
|
|
107
|
+
const publishedId = positiveInteger(readValue(published, 'id'));
|
|
108
|
+
if (publishedId && currentVersionId !== publishedId) {
|
|
109
|
+
await profiles.update({
|
|
110
|
+
filterByTk: profileId,
|
|
111
|
+
values: { currentVersionId: publishedId },
|
|
112
|
+
transaction,
|
|
113
|
+
});
|
|
114
|
+
}
|
|
115
|
+
return;
|
|
116
|
+
}
|
|
117
|
+
|
|
118
|
+
const settingsResult = validateHarnessSettings(readValue(profile, 'settings'));
|
|
119
|
+
if (!settingsResult.success) return;
|
|
120
|
+
const settings = settingsResult.data;
|
|
121
|
+
const nextVersion =
|
|
122
|
+
allVersions.reduce((maximum, version) => Math.max(maximum, Number(readValue(version, 'version')) || 0), 0) + 1;
|
|
123
|
+
const version = await versions.create({
|
|
124
|
+
values: {
|
|
125
|
+
profileId,
|
|
126
|
+
version: nextVersion,
|
|
127
|
+
schemaVersion: positiveInteger(readValue(profile, 'schemaVersion')) || 1,
|
|
128
|
+
status: 'published',
|
|
129
|
+
settings,
|
|
130
|
+
publishedAt: readValue(profile, 'updatedAt') || readValue(profile, 'createdAt') || new Date(),
|
|
131
|
+
},
|
|
132
|
+
transaction,
|
|
133
|
+
});
|
|
134
|
+
const versionId = positiveInteger(readValue(version, 'id'));
|
|
135
|
+
if (versionId) {
|
|
136
|
+
await profiles.update({
|
|
137
|
+
filterByTk: profileId,
|
|
138
|
+
values: { currentVersionId: versionId },
|
|
139
|
+
transaction,
|
|
140
|
+
});
|
|
141
|
+
}
|
|
142
|
+
});
|
|
143
|
+
}
|
|
144
|
+
}
|
|
145
|
+
|
|
146
|
+
function hasLegacyPlanFields(run: MigrationRecord, status: string) {
|
|
147
|
+
const metadata = asObject(readValue(run, 'metadata'));
|
|
148
|
+
return (
|
|
149
|
+
LEGACY_PLAN_STATUSES.has(status) ||
|
|
150
|
+
Boolean(stringValue(readValue(run, 'planSource')).trim()) ||
|
|
151
|
+
Boolean(stringValue(readValue(run, 'plannerModel')).trim()) ||
|
|
152
|
+
Boolean(stringValue(metadata.planSource).trim()) ||
|
|
153
|
+
Boolean(stringValue(metadata.plannerModel).trim()) ||
|
|
154
|
+
Boolean(stringValue(metadata.approvalMode).trim())
|
|
155
|
+
);
|
|
156
|
+
}
|
|
157
|
+
|
|
158
|
+
function isValidControlPlaneRun(run: MigrationRecord) {
|
|
159
|
+
const runtimeVersion = stringValue(readValue(run, 'runtimeVersion'));
|
|
160
|
+
const status = stringValue(readValue(run, 'status'));
|
|
161
|
+
const patternId = positiveInteger(readValue(run, 'patternId'));
|
|
162
|
+
return (
|
|
163
|
+
runtimeVersion === 'control-plane-v2' &&
|
|
164
|
+
CONTROL_PLANE_STATUSES.has(status) &&
|
|
165
|
+
!hasLegacyPlanFields(run, status) &&
|
|
166
|
+
patternId !== null &&
|
|
167
|
+
loopPatternPolicySchema.safeParse(readValue(run, 'policySnapshot')).success
|
|
168
|
+
);
|
|
169
|
+
}
|
|
170
|
+
|
|
171
|
+
async function backfillLegacyRuns(db: MigrationDatabase) {
|
|
172
|
+
const runs = db.getRepository('agentLoopRuns');
|
|
173
|
+
const steps = db.getRepository('agentLoopSteps');
|
|
174
|
+
const events = db.getRepository('agentLoopEvents');
|
|
175
|
+
if (!runs || !steps || !events) return;
|
|
176
|
+
|
|
177
|
+
for await (const run of iterateInBatches(runs)) {
|
|
178
|
+
const runId = positiveInteger(readValue(run, 'id'));
|
|
179
|
+
if (!runId || isValidControlPlaneRun(run)) continue;
|
|
180
|
+
|
|
181
|
+
const metadata = asObject(readValue(run, 'metadata'));
|
|
182
|
+
const statusValue = stringValue(readValue(run, 'status'));
|
|
183
|
+
const preservedLegacyStatus = stringValue(metadata.legacyStatus);
|
|
184
|
+
const legacyStatus = preservedLegacyStatus || statusValue || 'unknown';
|
|
185
|
+
const isTerminal = LEGACY_TERMINAL_STATUSES.has(legacyStatus);
|
|
186
|
+
const correlationKey = `legacy-runtime-retired:${runId}`;
|
|
187
|
+
if (readValue(run, 'runtimeVersion') === 'legacy-plan-v1' && metadata.legacyRuntimeRetired === true) continue;
|
|
188
|
+
|
|
189
|
+
await db.sequelize.transaction(async (transaction) => {
|
|
190
|
+
await runs.update({
|
|
191
|
+
filterByTk: runId,
|
|
192
|
+
values: {
|
|
193
|
+
runtimeVersion: 'legacy-plan-v1',
|
|
194
|
+
recordMode: 'legacy-plan',
|
|
195
|
+
...(isTerminal
|
|
196
|
+
? {}
|
|
197
|
+
: {
|
|
198
|
+
status: 'blocked',
|
|
199
|
+
blockedReason: 'The legacy plan runtime was retired. This historical run is read-only.',
|
|
200
|
+
lockedBy: null,
|
|
201
|
+
lockedUntil: null,
|
|
202
|
+
}),
|
|
203
|
+
metadata: {
|
|
204
|
+
...metadata,
|
|
205
|
+
legacyStatus,
|
|
206
|
+
legacyRuntimeRetired: true,
|
|
207
|
+
},
|
|
208
|
+
},
|
|
209
|
+
transaction,
|
|
210
|
+
});
|
|
211
|
+
await steps.update({
|
|
212
|
+
filter: { runId },
|
|
213
|
+
values: { runtimeVersion: 'legacy-plan-v1' },
|
|
214
|
+
transaction,
|
|
215
|
+
});
|
|
216
|
+
|
|
217
|
+
if (!isTerminal) {
|
|
218
|
+
const existingEvent = await events.findOne({
|
|
219
|
+
filter: { runId, type: 'legacy_runtime_retired', correlationKey },
|
|
220
|
+
transaction,
|
|
221
|
+
});
|
|
222
|
+
if (!existingEvent) {
|
|
223
|
+
await events.create({
|
|
224
|
+
values: {
|
|
225
|
+
runId,
|
|
226
|
+
type: 'legacy_runtime_retired',
|
|
227
|
+
title: 'Legacy runtime retired',
|
|
228
|
+
content: 'The nonterminal plan-era run was blocked during the Loop Control Plane cutover.',
|
|
229
|
+
status: 'blocked',
|
|
230
|
+
payload: { legacyStatus },
|
|
231
|
+
actorType: 'system',
|
|
232
|
+
actorIdentity: 'loop-control-plane-migration',
|
|
233
|
+
correlationKey,
|
|
234
|
+
createdAt: new Date(),
|
|
235
|
+
},
|
|
236
|
+
transaction,
|
|
237
|
+
});
|
|
238
|
+
}
|
|
239
|
+
}
|
|
240
|
+
});
|
|
241
|
+
}
|
|
242
|
+
}
|
|
243
|
+
|
|
244
|
+
async function backfillSpanRunLinks(db: MigrationDatabase) {
|
|
245
|
+
const spans = db.getRepository('agentExecutionSpans');
|
|
246
|
+
if (!spans) return;
|
|
247
|
+
|
|
248
|
+
for await (const span of iterateInBatches(spans)) {
|
|
249
|
+
if (positiveInteger(readValue(span, 'agentLoopRunId'))) continue;
|
|
250
|
+
const runId = positiveInteger(asObject(readValue(span, 'metadata')).agentLoopRunId);
|
|
251
|
+
const spanId = positiveInteger(readValue(span, 'id'));
|
|
252
|
+
if (!runId || !spanId) continue;
|
|
253
|
+
|
|
254
|
+
await spans.update({
|
|
255
|
+
filterByTk: spanId,
|
|
256
|
+
values: { agentLoopRunId: runId },
|
|
257
|
+
});
|
|
258
|
+
}
|
|
259
|
+
}
|
|
260
|
+
|
|
261
|
+
async function ensureGlobalControl(db: MigrationDatabase) {
|
|
262
|
+
const controls = db.getRepository('agentLoopControlSettings');
|
|
263
|
+
if (!controls) return;
|
|
264
|
+
const existing = await controls.findOne({ filter: { key: 'global' } });
|
|
265
|
+
if (existing) return;
|
|
266
|
+
await controls.create({
|
|
267
|
+
values: {
|
|
268
|
+
key: 'global',
|
|
269
|
+
acceptNewRuns: true,
|
|
270
|
+
state: 'running',
|
|
271
|
+
globalMaxConcurrency: 5,
|
|
272
|
+
createdAt: new Date(),
|
|
273
|
+
updatedAt: new Date(),
|
|
274
|
+
},
|
|
275
|
+
});
|
|
276
|
+
}
|
|
277
|
+
|
|
278
|
+
export async function backfillLoopControlPlaneData(db: MigrationDatabase) {
|
|
279
|
+
await backfillHarnessProfiles(db);
|
|
280
|
+
await backfillLegacyRuns(db);
|
|
281
|
+
await backfillSpanRunLinks(db);
|
|
282
|
+
await ensureGlobalControl(db);
|
|
283
|
+
}
|
|
284
|
+
|
|
285
|
+
export default class BackfillLoopControlPlaneData extends Migration {
|
|
286
|
+
on = 'afterLoad';
|
|
287
|
+
appVersion = '>=0.1.0';
|
|
288
|
+
|
|
289
|
+
async up() {
|
|
290
|
+
await backfillLoopControlPlaneData(this.db as unknown as MigrationDatabase);
|
|
291
|
+
await ensureAgentOrchestratorIndexes(this.db);
|
|
292
|
+
}
|
|
293
|
+
}
|
package/src/server/plugin.ts
CHANGED
|
@@ -5,6 +5,7 @@ import { registerTracingResource } from './resources/tracing';
|
|
|
5
5
|
import { registerAgentMonitorResource } from './resources/agent-monitor';
|
|
6
6
|
import { registerAgentLoopResource } from './resources/agent-loop';
|
|
7
7
|
import { registerAgentLoopApprovalResource } from './resources/agent-loop-approval';
|
|
8
|
+
import { registerAgentHarnessProfileResource } from './resources/agent-harness-profile';
|
|
8
9
|
import { registerAgentLoopArtifactResource } from './resources/agent-loop-artifact';
|
|
9
10
|
import { registerAgentLoopEventsStreamResource } from './resources/agent-loop-events-stream';
|
|
10
11
|
import { registerAgentKnowledgeInsightsResource } from './resources/agent-knowledge-insights';
|
|
@@ -249,7 +250,7 @@ export class PluginAgentOrchestratorServer extends Plugin {
|
|
|
249
250
|
['list', 'get', 'runNow', 'pause', 'resume', 'cancel', 'retry', 'escalate', 'acceptResult', 'status'],
|
|
250
251
|
'loggedIn',
|
|
251
252
|
);
|
|
252
|
-
this.app.acl.allow('agentLoopApprovals', ['list', 'get'], 'loggedIn');
|
|
253
|
+
this.app.acl.allow('agentLoopApprovals', ['list', 'get', 'decide'], 'loggedIn');
|
|
253
254
|
this.app.acl.allow('agentLoopArtifactsView', ['list', 'get'], 'loggedIn');
|
|
254
255
|
this.app.acl.allow('agentLoopEventsStream', ['stream'], 'loggedIn');
|
|
255
256
|
|
|
@@ -371,6 +372,7 @@ export class PluginAgentOrchestratorServer extends Plugin {
|
|
|
371
372
|
registerAgentLoopApprovalResource(this);
|
|
372
373
|
registerAgentLoopArtifactResource(this);
|
|
373
374
|
registerAgentLoopEventsStreamResource(this);
|
|
375
|
+
registerAgentHarnessProfileResource(this);
|
|
374
376
|
|
|
375
377
|
// --- Native plugin-ai Monitor Resource ---
|
|
376
378
|
registerAgentMonitorResource(this);
|