plugin-agent-orchestrator 1.1.4 → 1.1.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (148) hide show
  1. package/README.md +204 -114
  2. package/dist/client/index.js +1 -1
  3. package/dist/client-v2/117.7565cff57c39318a.js +10 -0
  4. package/dist/client-v2/214.106635011859dede.js +10 -0
  5. package/dist/client-v2/418.41ed200e7d6da332.js +10 -0
  6. package/dist/client-v2/53.349fff8db80b19d4.js +10 -0
  7. package/dist/client-v2/981.e4a1f41cfc94a856.js +10 -0
  8. package/dist/client-v2/index.js +1 -1
  9. package/dist/externalVersion.js +7 -8
  10. package/dist/locale/en-US.json +226 -170
  11. package/dist/locale/vi-VN.json +226 -170
  12. package/dist/locale/zh-CN.json +226 -170
  13. package/dist/server/collections/agent-execution-spans.js +8 -0
  14. package/dist/server/collections/agent-loop-action-approvals.js +1 -0
  15. package/dist/server/collections/agent-loop-runs.js +7 -1
  16. package/dist/server/collections/agent-loop-steps.js +7 -0
  17. package/dist/server/collections/skill-executions.js +8 -0
  18. package/dist/server/plugin.js +3 -1
  19. package/dist/server/resources/agent-harness-profile.js +117 -0
  20. package/dist/server/resources/agent-knowledge-insights.js +1 -3
  21. package/dist/server/resources/agent-loop-approval.js +25 -0
  22. package/dist/server/resources/agent-loop.js +3 -1
  23. package/dist/server/services/AgentMemoryContextService.js +34 -0
  24. package/dist/server/services/HarnessCompiler.js +35 -2
  25. package/dist/server/services/HarnessProfileService.js +74 -9
  26. package/dist/server/services/HarnessSchema.js +30 -3
  27. package/dist/server/services/LoopPatternSchema.js +16 -1
  28. package/dist/server/services/LoopRunRepository.js +80 -0
  29. package/dist/server/services/LoopRunStateMachine.js +92 -3
  30. package/dist/server/services/LoopTriggerService.js +37 -0
  31. package/dist/server/services/LoopWorkerService.js +261 -23
  32. package/dist/server/services/NativeSubAgentObserver.js +165 -23
  33. package/dist/server/services/PluginAiRuntimeAdapter.js +16 -5
  34. package/dist/server/services/ToolLoopDetectionService.js +210 -0
  35. package/dist/server/services/VerificationService.js +66 -0
  36. package/dist/server/services/harness-runtime-policy.js +139 -0
  37. package/dist/server/skill-hub/plugin.js +36 -3
  38. package/dist/server/skill-hub/tasks/SkillExecutionTask.js +29 -0
  39. package/package.json +53 -53
  40. package/src/client/ApprovalsTab.tsx +2 -0
  41. package/src/client/OrchestratorSettings.tsx +11 -0
  42. package/src/client/skill-hub/components/GitSkillImport.tsx +3 -3
  43. package/src/client/skill-hub/components/SkillMetrics.tsx +15 -10
  44. package/src/client/skill-hub/index.tsx +0 -52
  45. package/src/client-v2/components/AgentRunsTab.tsx +576 -576
  46. package/src/client-v2/components/ApprovalsTab.tsx +337 -0
  47. package/src/client-v2/components/HarnessProfilesTab.tsx +385 -105
  48. package/src/client-v2/components/MemoryInspectorTab.tsx +141 -141
  49. package/src/client-v2/components/TracingTab.tsx +515 -515
  50. package/src/client-v2/hooks/useApiRequest.ts +141 -141
  51. package/src/client-v2/pages/ApprovalsPage.tsx +10 -0
  52. package/src/client-v2/plugin.tsx +6 -6
  53. package/src/client-v2/skill-hub/components/SkillMetrics.tsx +5 -2
  54. package/src/locale/en-US.json +226 -174
  55. package/src/locale/vi-VN.json +226 -174
  56. package/src/locale/zh-CN.json +226 -174
  57. package/src/server/__tests__/circuit-breaker.test.ts +248 -248
  58. package/src/server/__tests__/harness-compiler.test.ts +83 -0
  59. package/src/server/__tests__/harness-profile-service.test.ts +51 -0
  60. package/src/server/__tests__/harness-runtime-policy.test.ts +293 -0
  61. package/src/server/__tests__/harness-tool-plan.test.ts +24 -0
  62. package/src/server/__tests__/loop-approval-decision.test.ts +512 -0
  63. package/src/server/__tests__/loop-approval-expiry.test.ts +258 -0
  64. package/src/server/__tests__/loop-budget-service.test.ts +255 -255
  65. package/src/server/__tests__/loop-control-plane-backfill.test.ts +266 -266
  66. package/src/server/__tests__/loop-pattern-schema.test.ts +18 -1
  67. package/src/server/__tests__/loop-pattern-service.test.ts +148 -148
  68. package/src/server/__tests__/loop-run-state-machine.test.ts +11 -0
  69. package/src/server/__tests__/loop-trigger-service.test.ts +148 -0
  70. package/src/server/__tests__/loop-worker-claim.test.ts +341 -341
  71. package/src/server/__tests__/loop-worker-execution.test.ts +82 -1
  72. package/src/server/__tests__/native-sub-agent-observer.test.ts +288 -4
  73. package/src/server/__tests__/path-lock-service.test.ts +254 -254
  74. package/src/server/__tests__/skill-execution-task-policy.test.ts +140 -0
  75. package/src/server/__tests__/smoke.test.ts +162 -162
  76. package/src/server/__tests__/tool-loop-detection.test.ts +275 -0
  77. package/src/server/collections/agent-execution-spans.ts +8 -0
  78. package/src/server/collections/agent-harness-profile-versions.ts +26 -26
  79. package/src/server/collections/agent-harness-profiles.ts +71 -71
  80. package/src/server/collections/agent-loop-action-approvals.ts +1 -0
  81. package/src/server/collections/agent-loop-artifacts.ts +25 -25
  82. package/src/server/collections/agent-loop-circuit-states.ts +23 -23
  83. package/src/server/collections/agent-loop-control-settings.ts +21 -21
  84. package/src/server/collections/agent-loop-events.ts +98 -98
  85. package/src/server/collections/agent-loop-path-locks.ts +27 -27
  86. package/src/server/collections/agent-loop-patterns.ts +42 -42
  87. package/src/server/collections/agent-loop-runs.ts +7 -1
  88. package/src/server/collections/agent-loop-steps.ts +7 -0
  89. package/src/server/collections/agent-loop-usage-buckets.ts +22 -22
  90. package/src/server/collections/agent-loop-worktrees.ts +25 -25
  91. package/src/server/collections/skill-executions.ts +8 -0
  92. package/src/server/migrations/20260427000002-change-packages-to-text.ts +52 -52
  93. package/src/server/migrations/20260429000000-add-llm-fields.ts +47 -47
  94. package/src/server/migrations/20260429000001-fix-inputargs-json-to-text.ts +45 -45
  95. package/src/server/migrations/20260503000000-add-orchestrator-trace-fields.ts +33 -33
  96. package/src/server/migrations/20260524000000-add-agent-loop-fields-to-skill-executions.ts +31 -31
  97. package/src/server/migrations/20260803010000-backfill-loop-control-plane-data.ts +293 -293
  98. package/src/server/plugin.ts +3 -1
  99. package/src/server/resources/agent-harness-profile.ts +94 -0
  100. package/src/server/resources/agent-knowledge-insights.ts +5 -3
  101. package/src/server/resources/agent-loop-approval.ts +32 -0
  102. package/src/server/resources/agent-loop-artifact.ts +56 -56
  103. package/src/server/resources/agent-loop-events-stream.ts +105 -105
  104. package/src/server/resources/agent-loop.ts +3 -1
  105. package/src/server/resources/resource-helpers.ts +33 -33
  106. package/src/server/resources/tracing.ts +266 -266
  107. package/src/server/services/AgentMemoryContextService.ts +44 -0
  108. package/src/server/services/DurableCircuitBreakerService.ts +239 -239
  109. package/src/server/services/ExecutionSpanService.ts +2 -0
  110. package/src/server/services/HarnessCompiler.ts +37 -0
  111. package/src/server/services/HarnessProfileService.ts +92 -10
  112. package/src/server/services/HarnessSchema.ts +31 -0
  113. package/src/server/services/LoopBudgetService.ts +275 -275
  114. package/src/server/services/LoopControlService.ts +124 -124
  115. package/src/server/services/LoopPatternSchema.ts +19 -1
  116. package/src/server/services/LoopPatternService.ts +143 -143
  117. package/src/server/services/LoopRunRepository.ts +99 -0
  118. package/src/server/services/LoopRunStateMachine.ts +100 -3
  119. package/src/server/services/LoopSchedulerService.ts +199 -199
  120. package/src/server/services/LoopTriggerService.ts +42 -0
  121. package/src/server/services/LoopWorkerService.ts +327 -27
  122. package/src/server/services/NativeSubAgentObserver.ts +186 -21
  123. package/src/server/services/PathLockService.ts +321 -321
  124. package/src/server/services/PluginAiRuntimeAdapter.ts +24 -7
  125. package/src/server/services/ToolLoopDetectionService.ts +213 -0
  126. package/src/server/services/VerificationSchema.ts +31 -31
  127. package/src/server/services/VerificationService.ts +81 -2
  128. package/src/server/services/harness-runtime-policy.ts +141 -0
  129. package/src/server/skill-hub/plugin.ts +41 -3
  130. package/src/server/skill-hub/services/RegistrySkillSnapshotService.ts +235 -235
  131. package/src/server/skill-hub/services/__tests__/RegistrySkillSnapshotService.test.ts +61 -61
  132. package/src/server/skill-hub/tasks/SkillExecutionTask.ts +43 -2
  133. package/src/server/utils/ensure-indexes.ts +96 -96
  134. package/src/server/utils/logging.ts +62 -62
  135. package/src/server/utils/loop-pattern-context.ts +20 -20
  136. package/dist/client-v2/214.b063f33ba044a808.js +0 -10
  137. package/dist/client-v2/373.f5d5292e53c4e832.js +0 -10
  138. package/dist/client-v2/418.58fa350f5496efd3.js +0 -10
  139. package/dist/client-v2/53.9a10455323390f14.js +0 -10
  140. package/dist/client-v2/677.a991ce0250ff5c77.js +0 -10
  141. package/dist/client-v2/925.e5925bf21ed68e7a.js +0 -10
  142. package/src/client/AIEmployeeSelect.tsx +0 -47
  143. package/src/client/AIEmployeesContext.tsx +0 -102
  144. package/src/client/RulesTab.tsx +0 -2
  145. package/src/client/TracingTab.tsx +0 -436
  146. package/src/client/skill-hub/components/ExecutionProgress.tsx +0 -51
  147. package/src/client-v2/components/RulesTab.tsx +0 -2
  148. package/src/client-v2/pages/AgentRunsPage.tsx +0 -13
@@ -1,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'));