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.
- 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,266 +1,266 @@
|
|
|
1
|
-
import type { Plugin } from '@nocobase/server';
|
|
2
|
-
import { LoopRunAccessError, LoopRunRepository } from '../services/LoopRunRepository';
|
|
3
|
-
import { requestActor, throwResourceError } from './resource-helpers';
|
|
4
|
-
|
|
5
|
-
type TraceRecord = Record<string, unknown>;
|
|
6
|
-
|
|
7
|
-
function plainRecord(raw: unknown): TraceRecord {
|
|
8
|
-
if (!raw || typeof raw !== 'object') return {};
|
|
9
|
-
const record = raw as { toJSON?: () => TraceRecord };
|
|
10
|
-
return typeof record.toJSON === 'function' ? record.toJSON() : (raw as TraceRecord);
|
|
11
|
-
}
|
|
12
|
-
|
|
13
|
-
function normalizeSpanFilter(filter: Record<string, unknown> = {}) {
|
|
14
|
-
const next = { ...filter };
|
|
15
|
-
if (next.subAgentUsername) {
|
|
16
|
-
next.employeeUsername = next.subAgentUsername;
|
|
17
|
-
delete next.subAgentUsername;
|
|
18
|
-
}
|
|
19
|
-
return next;
|
|
20
|
-
}
|
|
21
|
-
|
|
22
|
-
function mergeFilter(filter: Record<string, unknown>, required: Record<string, unknown>) {
|
|
23
|
-
return Object.keys(filter).length > 0 ? { $and: [filter, required] } : required;
|
|
24
|
-
}
|
|
25
|
-
|
|
26
|
-
function asObject(value: unknown): Record<string, unknown> {
|
|
27
|
-
return value && typeof value === 'object' && !Array.isArray(value) ? (value as Record<string, unknown>) : {};
|
|
28
|
-
}
|
|
29
|
-
|
|
30
|
-
function asArray(value: unknown) {
|
|
31
|
-
return Array.isArray(value) ? value : [];
|
|
32
|
-
}
|
|
33
|
-
|
|
34
|
-
function positiveId(value: unknown) {
|
|
35
|
-
const parsed = Number(value);
|
|
36
|
-
return Number.isSafeInteger(parsed) && parsed > 0 ? parsed : null;
|
|
37
|
-
}
|
|
38
|
-
|
|
39
|
-
function spanTitle(row: TraceRecord) {
|
|
40
|
-
if (typeof row.title === 'string' && row.title) return row.title;
|
|
41
|
-
if (row.type === 'sub_agent') return `${String(row.leaderUsername || '-')} -> ${String(row.employeeUsername || '-')}`;
|
|
42
|
-
return String(row.toolName || row.type || 'span');
|
|
43
|
-
}
|
|
44
|
-
|
|
45
|
-
function formatSpanListRow(raw: unknown) {
|
|
46
|
-
const row = plainRecord(raw);
|
|
47
|
-
const metadata = asObject(row.metadata);
|
|
48
|
-
const input = asObject(row.input);
|
|
49
|
-
return {
|
|
50
|
-
id: row.id,
|
|
51
|
-
rootRunId: row.rootRunId,
|
|
52
|
-
parentSpanId: row.parentSpanId,
|
|
53
|
-
type: row.type,
|
|
54
|
-
leaderUsername: row.leaderUsername,
|
|
55
|
-
subAgentUsername: row.employeeUsername,
|
|
56
|
-
employeeUsername: row.employeeUsername,
|
|
57
|
-
toolName: row.toolName,
|
|
58
|
-
task: input.task || metadata.task || row.title || '',
|
|
59
|
-
context: input.context || '',
|
|
60
|
-
result: row.output,
|
|
61
|
-
status: row.status,
|
|
62
|
-
depth: metadata.depth ?? 0,
|
|
63
|
-
durationMs: row.durationMs,
|
|
64
|
-
error: row.error,
|
|
65
|
-
userId: row.userId,
|
|
66
|
-
createdAt: row.createdAt || row.startedAt,
|
|
67
|
-
traceCount: metadata.traceCount || 0,
|
|
68
|
-
messageCount: Array.isArray(metadata.messages) ? metadata.messages.length : metadata.messageCount || 0,
|
|
69
|
-
hasUnifiedTrace: true,
|
|
70
|
-
};
|
|
71
|
-
}
|
|
72
|
-
|
|
73
|
-
function buildSpanTree(rows: unknown[]) {
|
|
74
|
-
const byId = new Map<string, TraceRecord & { children: TraceRecord[] }>();
|
|
75
|
-
const roots: Array<TraceRecord & { children: TraceRecord[] }> = [];
|
|
76
|
-
|
|
77
|
-
for (const raw of rows) {
|
|
78
|
-
const row = plainRecord(raw);
|
|
79
|
-
byId.set(String(row.id), { ...row, children: [] });
|
|
80
|
-
}
|
|
81
|
-
|
|
82
|
-
for (const row of byId.values()) {
|
|
83
|
-
const parent = row.parentSpanId ? byId.get(String(row.parentSpanId)) : undefined;
|
|
84
|
-
if (parent) parent.children.push(row);
|
|
85
|
-
else roots.push(row);
|
|
86
|
-
}
|
|
87
|
-
|
|
88
|
-
const sortTree = (items: Array<TraceRecord & { children: TraceRecord[] }>) => {
|
|
89
|
-
items.sort(
|
|
90
|
-
(left, right) =>
|
|
91
|
-
new Date(String(left.startedAt || left.createdAt || 0)).getTime() -
|
|
92
|
-
new Date(String(right.startedAt || right.createdAt || 0)).getTime(),
|
|
93
|
-
);
|
|
94
|
-
for (const item of items) sortTree(item.children as Array<TraceRecord & { children: TraceRecord[] }>);
|
|
95
|
-
};
|
|
96
|
-
sortTree(roots);
|
|
97
|
-
return roots;
|
|
98
|
-
}
|
|
99
|
-
|
|
100
|
-
function flattenSpanTimeline(rows: unknown[]) {
|
|
101
|
-
return rows
|
|
102
|
-
.map(plainRecord)
|
|
103
|
-
.sort(
|
|
104
|
-
(left, right) =>
|
|
105
|
-
new Date(String(left.startedAt || left.createdAt || 0)).getTime() -
|
|
106
|
-
new Date(String(right.startedAt || right.createdAt || 0)).getTime(),
|
|
107
|
-
)
|
|
108
|
-
.map((row) => {
|
|
109
|
-
const input = asObject(row.input);
|
|
110
|
-
const metadata = asObject(row.metadata);
|
|
111
|
-
return {
|
|
112
|
-
type: row.type,
|
|
113
|
-
at: row.startedAt || row.createdAt,
|
|
114
|
-
title: spanTitle(row),
|
|
115
|
-
toolName: row.toolName,
|
|
116
|
-
args: row.type === 'tool' || row.type === 'skill' ? input : undefined,
|
|
117
|
-
status: row.status,
|
|
118
|
-
content: row.output || row.error || input.task || metadata.summary || '',
|
|
119
|
-
spanId: row.id,
|
|
120
|
-
parentSpanId: row.parentSpanId,
|
|
121
|
-
skillExecutionId: row.skillExecutionId,
|
|
122
|
-
};
|
|
123
|
-
});
|
|
124
|
-
}
|
|
125
|
-
|
|
126
|
-
export function registerTracingResource(plugin: Plugin) {
|
|
127
|
-
const runs = new LoopRunRepository(plugin.db);
|
|
128
|
-
|
|
129
|
-
plugin.app.resource({
|
|
130
|
-
name: 'orchestratorTracing',
|
|
131
|
-
actions: {
|
|
132
|
-
async list(ctx, next) {
|
|
133
|
-
try {
|
|
134
|
-
const actor = requestActor(ctx);
|
|
135
|
-
const { page = 1, pageSize = 50, sort = ['-createdAt'], filter = {} } = ctx.action.params;
|
|
136
|
-
const ownedRunIds = actor.isAdmin ? [] : await runs.listOwnedRunIds(actor.userId, false);
|
|
137
|
-
const spanAccess = actor.isAdmin
|
|
138
|
-
? {}
|
|
139
|
-
: {
|
|
140
|
-
$or: [
|
|
141
|
-
{ agentLoopRunId: { $in: ownedRunIds.length > 0 ? ownedRunIds : [-1] } },
|
|
142
|
-
{ agentLoopRunId: null, userId: actor.userId },
|
|
143
|
-
],
|
|
144
|
-
};
|
|
145
|
-
const spanFilter = mergeFilter(
|
|
146
|
-
{ ...normalizeSpanFilter(filter), parentSpanId: null, type: 'sub_agent' },
|
|
147
|
-
spanAccess,
|
|
148
|
-
);
|
|
149
|
-
const spanRepo = ctx.db.getRepository('agentExecutionSpans');
|
|
150
|
-
const [spanRows, spanCount] = await spanRepo.findAndCount({
|
|
151
|
-
filter: spanFilter,
|
|
152
|
-
sort,
|
|
153
|
-
offset: (Number(page) - 1) * Number(pageSize),
|
|
154
|
-
limit: Number(pageSize),
|
|
155
|
-
});
|
|
156
|
-
|
|
157
|
-
if (spanCount > 0) {
|
|
158
|
-
ctx.body = {
|
|
159
|
-
data: spanRows.map(formatSpanListRow),
|
|
160
|
-
meta: {
|
|
161
|
-
count: spanCount,
|
|
162
|
-
page: Number(page),
|
|
163
|
-
pageSize: Number(pageSize),
|
|
164
|
-
totalPage: Math.ceil(spanCount / Number(pageSize)),
|
|
165
|
-
},
|
|
166
|
-
};
|
|
167
|
-
await next();
|
|
168
|
-
return;
|
|
169
|
-
}
|
|
170
|
-
|
|
171
|
-
const logFilter = actor.isAdmin ? filter : mergeFilter(filter, { userId: actor.userId });
|
|
172
|
-
const [rows, count] = await ctx.db.getRepository('orchestratorLogs').findAndCount({
|
|
173
|
-
filter: logFilter,
|
|
174
|
-
sort,
|
|
175
|
-
offset: (Number(page) - 1) * Number(pageSize),
|
|
176
|
-
limit: Number(pageSize),
|
|
177
|
-
});
|
|
178
|
-
|
|
179
|
-
ctx.body = {
|
|
180
|
-
data: rows.map((raw) => {
|
|
181
|
-
const row = plainRecord(raw);
|
|
182
|
-
return {
|
|
183
|
-
id: row.id,
|
|
184
|
-
leaderUsername: row.leaderUsername,
|
|
185
|
-
subAgentUsername: row.subAgentUsername,
|
|
186
|
-
toolName: row.toolName,
|
|
187
|
-
task: row.task,
|
|
188
|
-
context: row.context,
|
|
189
|
-
result: row.result,
|
|
190
|
-
status: row.status,
|
|
191
|
-
depth: row.depth,
|
|
192
|
-
durationMs: row.durationMs,
|
|
193
|
-
error: row.error,
|
|
194
|
-
userId: row.userId,
|
|
195
|
-
createdAt: row.createdAt,
|
|
196
|
-
traceCount: asArray(row.trace).length,
|
|
197
|
-
messageCount: asArray(row.messages).length,
|
|
198
|
-
hasUnifiedTrace: false,
|
|
199
|
-
};
|
|
200
|
-
}),
|
|
201
|
-
meta: {
|
|
202
|
-
count,
|
|
203
|
-
page: Number(page),
|
|
204
|
-
pageSize: Number(pageSize),
|
|
205
|
-
totalPage: Math.ceil(count / Number(pageSize)),
|
|
206
|
-
},
|
|
207
|
-
};
|
|
208
|
-
} catch (error) {
|
|
209
|
-
throwResourceError(ctx, error);
|
|
210
|
-
}
|
|
211
|
-
await next();
|
|
212
|
-
},
|
|
213
|
-
|
|
214
|
-
async get(ctx, next) {
|
|
215
|
-
try {
|
|
216
|
-
const actor = requestActor(ctx);
|
|
217
|
-
const { filterByTk, source } = ctx.action.params;
|
|
218
|
-
if (!filterByTk) ctx.throw(400, 'id is required');
|
|
219
|
-
|
|
220
|
-
const spanRepo = ctx.db.getRepository('agentExecutionSpans');
|
|
221
|
-
if (source !== 'log') {
|
|
222
|
-
const span = await spanRepo.findOne({ filterByTk });
|
|
223
|
-
if (span) {
|
|
224
|
-
const plainSpan = plainRecord(span);
|
|
225
|
-
const runId = positiveId(plainSpan.agentLoopRunId);
|
|
226
|
-
if (runId) await runs.requireOwnedRun(runId, actor.userId, actor.isAdmin);
|
|
227
|
-
else if (!actor.isAdmin && Number(plainSpan.userId) !== actor.userId) {
|
|
228
|
-
throw new LoopRunAccessError(403, 'You cannot access this execution trace.');
|
|
229
|
-
}
|
|
230
|
-
|
|
231
|
-
const rows = await spanRepo.find({
|
|
232
|
-
filter: { rootRunId: plainSpan.rootRunId },
|
|
233
|
-
sort: ['createdAt'],
|
|
234
|
-
});
|
|
235
|
-
const metadata = asObject(plainSpan.metadata);
|
|
236
|
-
ctx.body = {
|
|
237
|
-
data: {
|
|
238
|
-
...formatSpanListRow(plainSpan),
|
|
239
|
-
input: plainSpan.input,
|
|
240
|
-
output: plainSpan.output,
|
|
241
|
-
metadata,
|
|
242
|
-
trace: flattenSpanTimeline(rows),
|
|
243
|
-
messages: asArray(metadata.messages),
|
|
244
|
-
children: buildSpanTree(rows),
|
|
245
|
-
},
|
|
246
|
-
};
|
|
247
|
-
await next();
|
|
248
|
-
return;
|
|
249
|
-
}
|
|
250
|
-
}
|
|
251
|
-
|
|
252
|
-
const log = source === 'span' ? null : await ctx.db.getRepository('orchestratorLogs').findOne({ filterByTk });
|
|
253
|
-
if (!log) throw new LoopRunAccessError(404, `Execution trace ${String(filterByTk)} was not found.`);
|
|
254
|
-
const plainLog = plainRecord(log);
|
|
255
|
-
if (!actor.isAdmin && Number(plainLog.userId) !== actor.userId) {
|
|
256
|
-
throw new LoopRunAccessError(403, 'You cannot access this execution trace.');
|
|
257
|
-
}
|
|
258
|
-
ctx.body = { data: { ...plainLog, hasUnifiedTrace: false } };
|
|
259
|
-
} catch (error) {
|
|
260
|
-
throwResourceError(ctx, error);
|
|
261
|
-
}
|
|
262
|
-
await next();
|
|
263
|
-
},
|
|
264
|
-
},
|
|
265
|
-
});
|
|
266
|
-
}
|
|
1
|
+
import type { Plugin } from '@nocobase/server';
|
|
2
|
+
import { LoopRunAccessError, LoopRunRepository } from '../services/LoopRunRepository';
|
|
3
|
+
import { requestActor, throwResourceError } from './resource-helpers';
|
|
4
|
+
|
|
5
|
+
type TraceRecord = Record<string, unknown>;
|
|
6
|
+
|
|
7
|
+
function plainRecord(raw: unknown): TraceRecord {
|
|
8
|
+
if (!raw || typeof raw !== 'object') return {};
|
|
9
|
+
const record = raw as { toJSON?: () => TraceRecord };
|
|
10
|
+
return typeof record.toJSON === 'function' ? record.toJSON() : (raw as TraceRecord);
|
|
11
|
+
}
|
|
12
|
+
|
|
13
|
+
function normalizeSpanFilter(filter: Record<string, unknown> = {}) {
|
|
14
|
+
const next = { ...filter };
|
|
15
|
+
if (next.subAgentUsername) {
|
|
16
|
+
next.employeeUsername = next.subAgentUsername;
|
|
17
|
+
delete next.subAgentUsername;
|
|
18
|
+
}
|
|
19
|
+
return next;
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
function mergeFilter(filter: Record<string, unknown>, required: Record<string, unknown>) {
|
|
23
|
+
return Object.keys(filter).length > 0 ? { $and: [filter, required] } : required;
|
|
24
|
+
}
|
|
25
|
+
|
|
26
|
+
function asObject(value: unknown): Record<string, unknown> {
|
|
27
|
+
return value && typeof value === 'object' && !Array.isArray(value) ? (value as Record<string, unknown>) : {};
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
function asArray(value: unknown) {
|
|
31
|
+
return Array.isArray(value) ? value : [];
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
function positiveId(value: unknown) {
|
|
35
|
+
const parsed = Number(value);
|
|
36
|
+
return Number.isSafeInteger(parsed) && parsed > 0 ? parsed : null;
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
function spanTitle(row: TraceRecord) {
|
|
40
|
+
if (typeof row.title === 'string' && row.title) return row.title;
|
|
41
|
+
if (row.type === 'sub_agent') return `${String(row.leaderUsername || '-')} -> ${String(row.employeeUsername || '-')}`;
|
|
42
|
+
return String(row.toolName || row.type || 'span');
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
function formatSpanListRow(raw: unknown) {
|
|
46
|
+
const row = plainRecord(raw);
|
|
47
|
+
const metadata = asObject(row.metadata);
|
|
48
|
+
const input = asObject(row.input);
|
|
49
|
+
return {
|
|
50
|
+
id: row.id,
|
|
51
|
+
rootRunId: row.rootRunId,
|
|
52
|
+
parentSpanId: row.parentSpanId,
|
|
53
|
+
type: row.type,
|
|
54
|
+
leaderUsername: row.leaderUsername,
|
|
55
|
+
subAgentUsername: row.employeeUsername,
|
|
56
|
+
employeeUsername: row.employeeUsername,
|
|
57
|
+
toolName: row.toolName,
|
|
58
|
+
task: input.task || metadata.task || row.title || '',
|
|
59
|
+
context: input.context || '',
|
|
60
|
+
result: row.output,
|
|
61
|
+
status: row.status,
|
|
62
|
+
depth: metadata.depth ?? 0,
|
|
63
|
+
durationMs: row.durationMs,
|
|
64
|
+
error: row.error,
|
|
65
|
+
userId: row.userId,
|
|
66
|
+
createdAt: row.createdAt || row.startedAt,
|
|
67
|
+
traceCount: metadata.traceCount || 0,
|
|
68
|
+
messageCount: Array.isArray(metadata.messages) ? metadata.messages.length : metadata.messageCount || 0,
|
|
69
|
+
hasUnifiedTrace: true,
|
|
70
|
+
};
|
|
71
|
+
}
|
|
72
|
+
|
|
73
|
+
function buildSpanTree(rows: unknown[]) {
|
|
74
|
+
const byId = new Map<string, TraceRecord & { children: TraceRecord[] }>();
|
|
75
|
+
const roots: Array<TraceRecord & { children: TraceRecord[] }> = [];
|
|
76
|
+
|
|
77
|
+
for (const raw of rows) {
|
|
78
|
+
const row = plainRecord(raw);
|
|
79
|
+
byId.set(String(row.id), { ...row, children: [] });
|
|
80
|
+
}
|
|
81
|
+
|
|
82
|
+
for (const row of byId.values()) {
|
|
83
|
+
const parent = row.parentSpanId ? byId.get(String(row.parentSpanId)) : undefined;
|
|
84
|
+
if (parent) parent.children.push(row);
|
|
85
|
+
else roots.push(row);
|
|
86
|
+
}
|
|
87
|
+
|
|
88
|
+
const sortTree = (items: Array<TraceRecord & { children: TraceRecord[] }>) => {
|
|
89
|
+
items.sort(
|
|
90
|
+
(left, right) =>
|
|
91
|
+
new Date(String(left.startedAt || left.createdAt || 0)).getTime() -
|
|
92
|
+
new Date(String(right.startedAt || right.createdAt || 0)).getTime(),
|
|
93
|
+
);
|
|
94
|
+
for (const item of items) sortTree(item.children as Array<TraceRecord & { children: TraceRecord[] }>);
|
|
95
|
+
};
|
|
96
|
+
sortTree(roots);
|
|
97
|
+
return roots;
|
|
98
|
+
}
|
|
99
|
+
|
|
100
|
+
function flattenSpanTimeline(rows: unknown[]) {
|
|
101
|
+
return rows
|
|
102
|
+
.map(plainRecord)
|
|
103
|
+
.sort(
|
|
104
|
+
(left, right) =>
|
|
105
|
+
new Date(String(left.startedAt || left.createdAt || 0)).getTime() -
|
|
106
|
+
new Date(String(right.startedAt || right.createdAt || 0)).getTime(),
|
|
107
|
+
)
|
|
108
|
+
.map((row) => {
|
|
109
|
+
const input = asObject(row.input);
|
|
110
|
+
const metadata = asObject(row.metadata);
|
|
111
|
+
return {
|
|
112
|
+
type: row.type,
|
|
113
|
+
at: row.startedAt || row.createdAt,
|
|
114
|
+
title: spanTitle(row),
|
|
115
|
+
toolName: row.toolName,
|
|
116
|
+
args: row.type === 'tool' || row.type === 'skill' ? input : undefined,
|
|
117
|
+
status: row.status,
|
|
118
|
+
content: row.output || row.error || input.task || metadata.summary || '',
|
|
119
|
+
spanId: row.id,
|
|
120
|
+
parentSpanId: row.parentSpanId,
|
|
121
|
+
skillExecutionId: row.skillExecutionId,
|
|
122
|
+
};
|
|
123
|
+
});
|
|
124
|
+
}
|
|
125
|
+
|
|
126
|
+
export function registerTracingResource(plugin: Plugin) {
|
|
127
|
+
const runs = new LoopRunRepository(plugin.db);
|
|
128
|
+
|
|
129
|
+
plugin.app.resource({
|
|
130
|
+
name: 'orchestratorTracing',
|
|
131
|
+
actions: {
|
|
132
|
+
async list(ctx, next) {
|
|
133
|
+
try {
|
|
134
|
+
const actor = requestActor(ctx);
|
|
135
|
+
const { page = 1, pageSize = 50, sort = ['-createdAt'], filter = {} } = ctx.action.params;
|
|
136
|
+
const ownedRunIds = actor.isAdmin ? [] : await runs.listOwnedRunIds(actor.userId, false);
|
|
137
|
+
const spanAccess = actor.isAdmin
|
|
138
|
+
? {}
|
|
139
|
+
: {
|
|
140
|
+
$or: [
|
|
141
|
+
{ agentLoopRunId: { $in: ownedRunIds.length > 0 ? ownedRunIds : [-1] } },
|
|
142
|
+
{ agentLoopRunId: null, userId: actor.userId },
|
|
143
|
+
],
|
|
144
|
+
};
|
|
145
|
+
const spanFilter = mergeFilter(
|
|
146
|
+
{ ...normalizeSpanFilter(filter), parentSpanId: null, type: 'sub_agent' },
|
|
147
|
+
spanAccess,
|
|
148
|
+
);
|
|
149
|
+
const spanRepo = ctx.db.getRepository('agentExecutionSpans');
|
|
150
|
+
const [spanRows, spanCount] = await spanRepo.findAndCount({
|
|
151
|
+
filter: spanFilter,
|
|
152
|
+
sort,
|
|
153
|
+
offset: (Number(page) - 1) * Number(pageSize),
|
|
154
|
+
limit: Number(pageSize),
|
|
155
|
+
});
|
|
156
|
+
|
|
157
|
+
if (spanCount > 0) {
|
|
158
|
+
ctx.body = {
|
|
159
|
+
data: spanRows.map(formatSpanListRow),
|
|
160
|
+
meta: {
|
|
161
|
+
count: spanCount,
|
|
162
|
+
page: Number(page),
|
|
163
|
+
pageSize: Number(pageSize),
|
|
164
|
+
totalPage: Math.ceil(spanCount / Number(pageSize)),
|
|
165
|
+
},
|
|
166
|
+
};
|
|
167
|
+
await next();
|
|
168
|
+
return;
|
|
169
|
+
}
|
|
170
|
+
|
|
171
|
+
const logFilter = actor.isAdmin ? filter : mergeFilter(filter, { userId: actor.userId });
|
|
172
|
+
const [rows, count] = await ctx.db.getRepository('orchestratorLogs').findAndCount({
|
|
173
|
+
filter: logFilter,
|
|
174
|
+
sort,
|
|
175
|
+
offset: (Number(page) - 1) * Number(pageSize),
|
|
176
|
+
limit: Number(pageSize),
|
|
177
|
+
});
|
|
178
|
+
|
|
179
|
+
ctx.body = {
|
|
180
|
+
data: rows.map((raw) => {
|
|
181
|
+
const row = plainRecord(raw);
|
|
182
|
+
return {
|
|
183
|
+
id: row.id,
|
|
184
|
+
leaderUsername: row.leaderUsername,
|
|
185
|
+
subAgentUsername: row.subAgentUsername,
|
|
186
|
+
toolName: row.toolName,
|
|
187
|
+
task: row.task,
|
|
188
|
+
context: row.context,
|
|
189
|
+
result: row.result,
|
|
190
|
+
status: row.status,
|
|
191
|
+
depth: row.depth,
|
|
192
|
+
durationMs: row.durationMs,
|
|
193
|
+
error: row.error,
|
|
194
|
+
userId: row.userId,
|
|
195
|
+
createdAt: row.createdAt,
|
|
196
|
+
traceCount: asArray(row.trace).length,
|
|
197
|
+
messageCount: asArray(row.messages).length,
|
|
198
|
+
hasUnifiedTrace: false,
|
|
199
|
+
};
|
|
200
|
+
}),
|
|
201
|
+
meta: {
|
|
202
|
+
count,
|
|
203
|
+
page: Number(page),
|
|
204
|
+
pageSize: Number(pageSize),
|
|
205
|
+
totalPage: Math.ceil(count / Number(pageSize)),
|
|
206
|
+
},
|
|
207
|
+
};
|
|
208
|
+
} catch (error) {
|
|
209
|
+
throwResourceError(ctx, error);
|
|
210
|
+
}
|
|
211
|
+
await next();
|
|
212
|
+
},
|
|
213
|
+
|
|
214
|
+
async get(ctx, next) {
|
|
215
|
+
try {
|
|
216
|
+
const actor = requestActor(ctx);
|
|
217
|
+
const { filterByTk, source } = ctx.action.params;
|
|
218
|
+
if (!filterByTk) ctx.throw(400, 'id is required');
|
|
219
|
+
|
|
220
|
+
const spanRepo = ctx.db.getRepository('agentExecutionSpans');
|
|
221
|
+
if (source !== 'log') {
|
|
222
|
+
const span = await spanRepo.findOne({ filterByTk });
|
|
223
|
+
if (span) {
|
|
224
|
+
const plainSpan = plainRecord(span);
|
|
225
|
+
const runId = positiveId(plainSpan.agentLoopRunId);
|
|
226
|
+
if (runId) await runs.requireOwnedRun(runId, actor.userId, actor.isAdmin);
|
|
227
|
+
else if (!actor.isAdmin && Number(plainSpan.userId) !== actor.userId) {
|
|
228
|
+
throw new LoopRunAccessError(403, 'You cannot access this execution trace.');
|
|
229
|
+
}
|
|
230
|
+
|
|
231
|
+
const rows = await spanRepo.find({
|
|
232
|
+
filter: { rootRunId: plainSpan.rootRunId },
|
|
233
|
+
sort: ['createdAt'],
|
|
234
|
+
});
|
|
235
|
+
const metadata = asObject(plainSpan.metadata);
|
|
236
|
+
ctx.body = {
|
|
237
|
+
data: {
|
|
238
|
+
...formatSpanListRow(plainSpan),
|
|
239
|
+
input: plainSpan.input,
|
|
240
|
+
output: plainSpan.output,
|
|
241
|
+
metadata,
|
|
242
|
+
trace: flattenSpanTimeline(rows),
|
|
243
|
+
messages: asArray(metadata.messages),
|
|
244
|
+
children: buildSpanTree(rows),
|
|
245
|
+
},
|
|
246
|
+
};
|
|
247
|
+
await next();
|
|
248
|
+
return;
|
|
249
|
+
}
|
|
250
|
+
}
|
|
251
|
+
|
|
252
|
+
const log = source === 'span' ? null : await ctx.db.getRepository('orchestratorLogs').findOne({ filterByTk });
|
|
253
|
+
if (!log) throw new LoopRunAccessError(404, `Execution trace ${String(filterByTk)} was not found.`);
|
|
254
|
+
const plainLog = plainRecord(log);
|
|
255
|
+
if (!actor.isAdmin && Number(plainLog.userId) !== actor.userId) {
|
|
256
|
+
throw new LoopRunAccessError(403, 'You cannot access this execution trace.');
|
|
257
|
+
}
|
|
258
|
+
ctx.body = { data: { ...plainLog, hasUnifiedTrace: false } };
|
|
259
|
+
} catch (error) {
|
|
260
|
+
throwResourceError(ctx, error);
|
|
261
|
+
}
|
|
262
|
+
await next();
|
|
263
|
+
},
|
|
264
|
+
},
|
|
265
|
+
});
|
|
266
|
+
}
|
|
@@ -1,4 +1,6 @@
|
|
|
1
1
|
import { asObject, toPlain, trimText } from '../utils/ctx-utils';
|
|
2
|
+
import { HarnessProfileService } from './HarnessProfileService';
|
|
3
|
+
import type { HarnessSettings } from './HarnessSchema';
|
|
2
4
|
|
|
3
5
|
type MemoryScope = 'public' | 'user' | 'agent_user';
|
|
4
6
|
|
|
@@ -49,6 +51,20 @@ function normalizeText(value: unknown) {
|
|
|
49
51
|
return typeof value === 'string' ? value.trim() : '';
|
|
50
52
|
}
|
|
51
53
|
|
|
54
|
+
// Published version settings are stored in the normalized nested shape, but the observer and the
|
|
55
|
+
// memory injection still read the legacy flat keys. Flatten the contract the consumers expect and
|
|
56
|
+
// keep the nested sections alongside them for the harness compiler (nested values win there).
|
|
57
|
+
function flattenPublishedSettings(settings: HarnessSettings): Record<string, unknown> {
|
|
58
|
+
return {
|
|
59
|
+
...settings,
|
|
60
|
+
nativeObserverEnabled: settings.observability.enabled,
|
|
61
|
+
memoryInjectionEnabled: settings.memory.enabled,
|
|
62
|
+
memoryScopes: settings.memory.scopes,
|
|
63
|
+
maxMemoryContextChars: settings.memory.maxChars,
|
|
64
|
+
tracingRetentionDays: settings.observability.tracingRetentionDays,
|
|
65
|
+
};
|
|
66
|
+
}
|
|
67
|
+
|
|
52
68
|
function formatRecordSection(record: ContextRecord) {
|
|
53
69
|
const content = normalizeText(record.contentMd);
|
|
54
70
|
const graph = normalizeText(record.graphMd);
|
|
@@ -76,6 +92,16 @@ export class AgentMemoryContextService {
|
|
|
76
92
|
(await this.resolveConfiguredHarnessTag(task)) ||
|
|
77
93
|
'default';
|
|
78
94
|
|
|
95
|
+
// The published version is the revision-controlled source of truth; raw row settings below
|
|
96
|
+
// only apply to legacy profiles that never went through draft/publish.
|
|
97
|
+
const published = await this.resolvePublishedSettings(requestedTag);
|
|
98
|
+
if (published) {
|
|
99
|
+
return {
|
|
100
|
+
...published.settings,
|
|
101
|
+
harnessTag: published.tag,
|
|
102
|
+
};
|
|
103
|
+
}
|
|
104
|
+
|
|
79
105
|
const profile = await this.findHarnessProfile(requestedTag);
|
|
80
106
|
const fallbackProfile = profile || (requestedTag === 'default' ? null : await this.findHarnessProfile('default'));
|
|
81
107
|
const profileSettings = asObject(fallbackProfile ? readModelValue(fallbackProfile, 'settings') : {});
|
|
@@ -167,6 +193,24 @@ export class AgentMemoryContextService {
|
|
|
167
193
|
}
|
|
168
194
|
}
|
|
169
195
|
|
|
196
|
+
private async resolvePublishedSettings(
|
|
197
|
+
requestedTag: string,
|
|
198
|
+
): Promise<{ tag: string; settings: Record<string, unknown> } | null> {
|
|
199
|
+
try {
|
|
200
|
+
const profiles = new HarnessProfileService(this.plugin.db);
|
|
201
|
+
const direct = await profiles.getPublishedByTag(requestedTag);
|
|
202
|
+
if (direct) return { tag: requestedTag, settings: flattenPublishedSettings(direct.settings) };
|
|
203
|
+
if (requestedTag !== 'default') {
|
|
204
|
+
const fallback = await profiles.getPublishedByTag('default');
|
|
205
|
+
if (fallback) return { tag: 'default', settings: flattenPublishedSettings(fallback.settings) };
|
|
206
|
+
}
|
|
207
|
+
return null;
|
|
208
|
+
} catch (error) {
|
|
209
|
+
this.plugin.app.logger?.warn?.('[AgentOrchestrator] Failed to load published policy profile', error);
|
|
210
|
+
return null;
|
|
211
|
+
}
|
|
212
|
+
}
|
|
213
|
+
|
|
170
214
|
private async resolveConfiguredHarnessTag(task?: { ctx?: unknown; employee?: unknown }) {
|
|
171
215
|
const values = asObject((task?.ctx as { action?: { params?: { values?: unknown } } })?.action?.params?.values);
|
|
172
216
|
const subAgentUsername = normalizeText(readModelValue(task?.employee, 'username'));
|