plugin-agent-orchestrator 1.1.3 → 1.1.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (218) hide show
  1. package/README.md +204 -114
  2. package/dist/client/index.js +1 -1
  3. package/dist/client-v2/117.7565cff57c39318a.js +10 -0
  4. package/dist/client-v2/214.106635011859dede.js +10 -0
  5. package/dist/client-v2/253.59577b40d9875be0.js +10 -0
  6. package/dist/client-v2/264.7ed8bee71fa5935c.js +10 -0
  7. package/dist/client-v2/{41.ba6e080cc0488143.js → 41.3deb9e57a0f64fc4.js} +1 -1
  8. package/dist/client-v2/418.41ed200e7d6da332.js +10 -0
  9. package/dist/client-v2/53.349fff8db80b19d4.js +10 -0
  10. package/dist/client-v2/619.0a2144aaffefe018.js +10 -0
  11. package/dist/client-v2/{70.bda9518881c05360.js → 70.ffff2997c10fd4b0.js} +1 -1
  12. package/dist/client-v2/{794.9bbb8d3a61b2bdf2.js → 794.a67a2614405ba627.js} +1 -1
  13. package/dist/client-v2/981.e4a1f41cfc94a856.js +10 -0
  14. package/dist/client-v2/{993.82778b6fd6db3cb1.js → 993.b0688fdc5ccb000a.js} +1 -1
  15. package/dist/client-v2/index.js +1 -1
  16. package/dist/externalVersion.js +8 -7
  17. package/dist/locale/en-US.json +199 -123
  18. package/dist/locale/vi-VN.json +199 -123
  19. package/dist/locale/zh-CN.json +199 -123
  20. package/dist/server/collections/agent-execution-spans.js +55 -0
  21. package/dist/server/collections/agent-harness-profile-versions.js +56 -0
  22. package/dist/server/collections/agent-harness-profiles.js +12 -0
  23. package/dist/server/collections/agent-loop-action-approvals.js +69 -0
  24. package/dist/server/collections/agent-loop-artifacts.js +55 -0
  25. package/dist/server/collections/agent-loop-circuit-states.js +53 -0
  26. package/dist/server/collections/agent-loop-control-settings.js +51 -0
  27. package/dist/server/collections/agent-loop-events.js +27 -0
  28. package/dist/server/collections/agent-loop-path-locks.js +57 -0
  29. package/dist/server/collections/agent-loop-patterns.js +72 -0
  30. package/dist/server/collections/agent-loop-runs.js +170 -3
  31. package/dist/server/collections/agent-loop-steps.js +76 -0
  32. package/dist/server/collections/agent-loop-usage-buckets.js +52 -0
  33. package/dist/server/collections/agent-loop-worktrees.js +55 -0
  34. package/dist/server/collections/skill-executions.js +8 -0
  35. package/dist/server/migrations/{20260427000000-change-packages-to-text.js → 20260427000002-change-packages-to-text.js} +2 -0
  36. package/dist/server/migrations/20260429000000-add-llm-fields.js +3 -2
  37. package/dist/server/migrations/{20260429000000-fix-inputargs-json-to-text.js → 20260429000001-fix-inputargs-json-to-text.js} +14 -6
  38. package/dist/server/migrations/20260503000000-add-orchestrator-trace-fields.js +2 -1
  39. package/dist/server/migrations/20260524000000-add-agent-loop-fields-to-skill-executions.js +2 -1
  40. package/dist/server/migrations/20260803010000-backfill-loop-control-plane-data.js +262 -0
  41. package/dist/server/plugin.js +54 -150
  42. package/dist/server/resources/agent-harness-profile.js +117 -0
  43. package/dist/server/resources/agent-knowledge-insights.js +1 -3
  44. package/dist/server/resources/agent-loop-approval.js +108 -0
  45. package/dist/server/resources/agent-loop-artifact.js +86 -0
  46. package/dist/server/resources/agent-loop-events-stream.js +130 -0
  47. package/dist/server/resources/agent-loop.js +183 -139
  48. package/dist/server/resources/resource-helpers.js +63 -0
  49. package/dist/server/resources/tracing.js +121 -107
  50. package/dist/server/services/AgentMemoryContextService.js +34 -0
  51. package/dist/server/services/DurableCircuitBreakerService.js +229 -0
  52. package/dist/server/services/HarnessCompiler.js +175 -0
  53. package/dist/server/services/HarnessProfileService.js +233 -0
  54. package/dist/server/services/HarnessSchema.js +194 -0
  55. package/dist/server/services/LoopBudgetService.js +269 -0
  56. package/dist/server/services/LoopControlService.js +139 -0
  57. package/dist/server/services/LoopPatternSchema.js +195 -0
  58. package/dist/server/services/LoopPatternService.js +132 -0
  59. package/dist/server/services/LoopRunRepository.js +285 -0
  60. package/dist/server/services/LoopRunStateMachine.js +478 -0
  61. package/dist/server/services/LoopSchedulerService.js +193 -0
  62. package/dist/server/services/LoopTriggerService.js +165 -0
  63. package/dist/server/services/LoopWorkerService.js +699 -0
  64. package/dist/server/services/NativeSubAgentObserver.js +165 -23
  65. package/dist/server/services/PathLockService.js +288 -0
  66. package/dist/server/services/PluginAiRuntimeAdapter.js +226 -0
  67. package/dist/server/services/ToolLoopDetectionService.js +210 -0
  68. package/dist/server/services/VerificationSchema.js +59 -0
  69. package/dist/server/services/VerificationService.js +235 -0
  70. package/dist/server/services/harness-runtime-policy.js +139 -0
  71. package/dist/server/skill-hub/actions/git-import.js +13 -7
  72. package/dist/server/skill-hub/plugin.js +36 -3
  73. package/dist/server/skill-hub/services/RegistrySkillSnapshotService.js +1 -5
  74. package/dist/server/skill-hub/tasks/SkillExecutionTask.js +29 -0
  75. package/dist/server/utils/ensure-indexes.js +111 -0
  76. package/dist/server/utils/loop-pattern-context.js +56 -0
  77. package/package.json +53 -53
  78. package/src/client/ApprovalsTab.tsx +2 -0
  79. package/src/client/OrchestratorSettings.tsx +55 -0
  80. package/src/client/skill-hub/components/GitSkillImport.tsx +3 -3
  81. package/src/client/skill-hub/components/SkillMetrics.tsx +15 -10
  82. package/src/client/skill-hub/index.tsx +0 -52
  83. package/src/client-v2/components/AgentRunsTab.tsx +100 -18
  84. package/src/client-v2/components/ApprovalsTab.tsx +337 -0
  85. package/src/client-v2/components/HarnessProfilesTab.tsx +385 -100
  86. package/src/client-v2/components/MemoryInspectorTab.tsx +141 -125
  87. package/src/client-v2/components/TracingTab.tsx +160 -77
  88. package/src/client-v2/hooks/useApiRequest.ts +28 -8
  89. package/src/client-v2/pages/ApprovalsPage.tsx +10 -0
  90. package/src/client-v2/plugin.tsx +6 -6
  91. package/src/client-v2/skill-hub/components/SkillMetrics.tsx +11 -6
  92. package/src/locale/en-US.json +199 -123
  93. package/src/locale/vi-VN.json +199 -123
  94. package/src/locale/zh-CN.json +199 -123
  95. package/src/server/__tests__/circuit-breaker.test.ts +248 -169
  96. package/src/server/__tests__/harness-compiler.test.ts +214 -0
  97. package/src/server/__tests__/harness-profile-service.test.ts +167 -0
  98. package/src/server/__tests__/harness-runtime-policy.test.ts +293 -0
  99. package/src/server/__tests__/harness-tool-plan.test.ts +172 -0
  100. package/src/server/__tests__/loop-approval-decision.test.ts +512 -0
  101. package/src/server/__tests__/loop-approval-expiry.test.ts +258 -0
  102. package/src/server/__tests__/loop-budget-service.test.ts +255 -0
  103. package/src/server/__tests__/loop-control-plane-backfill.test.ts +266 -0
  104. package/src/server/__tests__/loop-pattern-schema.test.ts +73 -0
  105. package/src/server/__tests__/loop-pattern-service.test.ts +148 -0
  106. package/src/server/__tests__/loop-run-state-machine.test.ts +101 -0
  107. package/src/server/__tests__/loop-trigger-service.test.ts +148 -0
  108. package/src/server/__tests__/loop-worker-claim.test.ts +341 -0
  109. package/src/server/__tests__/loop-worker-execution.test.ts +317 -0
  110. package/src/server/__tests__/native-sub-agent-observer.test.ts +288 -4
  111. package/src/server/__tests__/path-lock-service.test.ts +254 -0
  112. package/src/server/__tests__/skill-execution-task-policy.test.ts +140 -0
  113. package/src/server/__tests__/smoke.test.ts +162 -121
  114. package/src/server/__tests__/tool-loop-detection.test.ts +275 -0
  115. package/src/server/collections/agent-execution-spans.ts +55 -0
  116. package/src/server/collections/agent-harness-profile-versions.ts +26 -0
  117. package/src/server/collections/agent-harness-profiles.ts +71 -59
  118. package/src/server/collections/agent-loop-action-approvals.ts +39 -0
  119. package/src/server/collections/agent-loop-artifacts.ts +25 -0
  120. package/src/server/collections/agent-loop-circuit-states.ts +23 -0
  121. package/src/server/collections/agent-loop-control-settings.ts +21 -0
  122. package/src/server/collections/agent-loop-events.ts +98 -71
  123. package/src/server/collections/agent-loop-path-locks.ts +27 -0
  124. package/src/server/collections/agent-loop-patterns.ts +42 -0
  125. package/src/server/collections/agent-loop-runs.ts +170 -3
  126. package/src/server/collections/agent-loop-steps.ts +76 -0
  127. package/src/server/collections/agent-loop-usage-buckets.ts +22 -0
  128. package/src/server/collections/agent-loop-worktrees.ts +25 -0
  129. package/src/server/collections/skill-executions.ts +8 -0
  130. package/src/server/migrations/{20260427000000-change-packages-to-text.ts → 20260427000002-change-packages-to-text.ts} +52 -49
  131. package/src/server/migrations/20260429000000-add-llm-fields.ts +47 -46
  132. package/src/server/migrations/{20260429000000-fix-inputargs-json-to-text.ts → 20260429000001-fix-inputargs-json-to-text.ts} +45 -38
  133. package/src/server/migrations/20260503000000-add-orchestrator-trace-fields.ts +33 -32
  134. package/src/server/migrations/20260524000000-add-agent-loop-fields-to-skill-executions.ts +31 -30
  135. package/src/server/migrations/20260803010000-backfill-loop-control-plane-data.ts +293 -0
  136. package/src/server/plugin.ts +55 -167
  137. package/src/server/resources/agent-harness-profile.ts +94 -0
  138. package/src/server/resources/agent-knowledge-insights.ts +5 -3
  139. package/src/server/resources/agent-loop-approval.ts +84 -0
  140. package/src/server/resources/agent-loop-artifact.ts +56 -0
  141. package/src/server/resources/agent-loop-events-stream.ts +105 -0
  142. package/src/server/resources/agent-loop.ts +204 -143
  143. package/src/server/resources/agent-monitor.ts +482 -482
  144. package/src/server/resources/resource-helpers.ts +33 -0
  145. package/src/server/resources/tracing.ts +266 -258
  146. package/src/server/services/AgentMemoryContextService.ts +44 -0
  147. package/src/server/services/DurableCircuitBreakerService.ts +239 -0
  148. package/src/server/services/ExecutionSpanService.ts +2 -0
  149. package/src/server/services/HarnessCompiler.ts +170 -0
  150. package/src/server/services/HarnessProfileService.ts +239 -0
  151. package/src/server/services/HarnessSchema.ts +194 -0
  152. package/src/server/services/LoopBudgetService.ts +275 -0
  153. package/src/server/services/LoopControlService.ts +124 -0
  154. package/src/server/services/LoopPatternSchema.ts +185 -0
  155. package/src/server/services/LoopPatternService.ts +143 -0
  156. package/src/server/services/LoopRunRepository.ts +336 -0
  157. package/src/server/services/LoopRunStateMachine.ts +529 -0
  158. package/src/server/services/LoopSchedulerService.ts +199 -0
  159. package/src/server/services/LoopTriggerService.ts +157 -0
  160. package/src/server/services/LoopWorkerService.ts +822 -0
  161. package/src/server/services/NativeSubAgentObserver.ts +186 -21
  162. package/src/server/services/PathLockService.ts +321 -0
  163. package/src/server/services/PluginAiRuntimeAdapter.ts +332 -0
  164. package/src/server/services/ToolLoopDetectionService.ts +213 -0
  165. package/src/server/services/VerificationSchema.ts +31 -0
  166. package/src/server/services/VerificationService.ts +264 -0
  167. package/src/server/services/harness-runtime-policy.ts +141 -0
  168. package/src/server/skill-hub/actions/__tests__/git-import.test.ts +15 -1
  169. package/src/server/skill-hub/actions/git-import.ts +9 -3
  170. package/src/server/skill-hub/plugin.ts +41 -3
  171. package/src/server/skill-hub/services/RegistrySkillSnapshotService.ts +235 -239
  172. package/src/server/skill-hub/services/__tests__/RegistrySkillSnapshotService.test.ts +61 -63
  173. package/src/server/skill-hub/tasks/SkillExecutionTask.ts +43 -2
  174. package/src/server/utils/ensure-indexes.ts +96 -0
  175. package/src/server/utils/logging.ts +62 -63
  176. package/src/server/utils/loop-pattern-context.ts +20 -0
  177. package/dist/client-v2/214.79650a549273f163.js +0 -10
  178. package/dist/client-v2/253.9f0537713cee9e6c.js +0 -10
  179. package/dist/client-v2/264.718a107e43fc163c.js +0 -10
  180. package/dist/client-v2/373.f5d5292e53c4e832.js +0 -10
  181. package/dist/client-v2/418.ce8f5b2b8a229d1d.js +0 -10
  182. package/dist/client-v2/53.7c29c28043e9112d.js +0 -10
  183. package/dist/client-v2/619.bd3c5698b40705c3.js +0 -10
  184. package/dist/client-v2/677.a991ce0250ff5c77.js +0 -10
  185. package/dist/client-v2/925.f5370de8f6632d65.js +0 -10
  186. package/dist/server/services/AgentHarness.js +0 -81
  187. package/dist/server/services/AgentLoopController.js +0 -1023
  188. package/dist/server/services/AgentLoopRepository.js +0 -192
  189. package/dist/server/services/AgentLoopService.js +0 -142
  190. package/dist/server/services/AgentPlanValidator.js +0 -99
  191. package/dist/server/services/AgentPlannerService.js +0 -99
  192. package/dist/server/services/CircuitBreaker.js +0 -125
  193. package/dist/server/services/ContextAggregator.js +0 -201
  194. package/dist/server/services/PlanningPromptService.js +0 -95
  195. package/dist/server/tools/agent-loop.js +0 -373
  196. package/dist/server/tools/orchestrator-plan.js +0 -254
  197. package/src/client/AIEmployeeSelect.tsx +0 -47
  198. package/src/client/AIEmployeesContext.tsx +0 -102
  199. package/src/client/RulesTab.tsx +0 -2
  200. package/src/client/TracingTab.tsx +0 -436
  201. package/src/client/skill-hub/components/ExecutionProgress.tsx +0 -51
  202. package/src/client-v2/components/RulesTab.tsx +0 -2
  203. package/src/client-v2/pages/AgentRunsPage.tsx +0 -13
  204. package/src/server/__tests__/agent-loop-controller.test.ts +0 -375
  205. package/src/server/__tests__/context-aggregator.test.ts +0 -222
  206. package/src/server/__tests__/parallel-execution.test.ts +0 -318
  207. package/src/server/__tests__/planning-prompt-service.test.ts +0 -23
  208. package/src/server/services/AgentHarness.ts +0 -67
  209. package/src/server/services/AgentLoopController.ts +0 -1263
  210. package/src/server/services/AgentLoopRepository.ts +0 -178
  211. package/src/server/services/AgentLoopService.ts +0 -177
  212. package/src/server/services/AgentPlanValidator.ts +0 -73
  213. package/src/server/services/AgentPlannerService.ts +0 -80
  214. package/src/server/services/CircuitBreaker.ts +0 -126
  215. package/src/server/services/ContextAggregator.ts +0 -239
  216. package/src/server/services/PlanningPromptService.ts +0 -72
  217. package/src/server/tools/agent-loop.ts +0 -360
  218. package/src/server/tools/orchestrator-plan.ts +0 -255
@@ -0,0 +1,33 @@
1
+ import type { Context } from '@nocobase/actions';
2
+ import { ZodError } from 'zod';
3
+ import { currentUserId, isAdminUser } from '../utils/ctx-utils';
4
+ import { LoopRunAccessError } from '../services/LoopRunRepository';
5
+
6
+ export type RequestActor = {
7
+ userId: number;
8
+ isAdmin: boolean;
9
+ };
10
+
11
+ export function requestActor(ctx: Context): RequestActor {
12
+ const userId = Number(currentUserId(ctx));
13
+ if (!Number.isSafeInteger(userId) || userId <= 0) {
14
+ throw new LoopRunAccessError(401, 'Authentication is required.');
15
+ }
16
+ return { userId, isAdmin: isAdminUser(ctx) };
17
+ }
18
+
19
+ export function requireAdminActor(ctx: Context) {
20
+ const actor = requestActor(ctx);
21
+ if (!actor.isAdmin) throw new LoopRunAccessError(403, 'Administrator access is required.');
22
+ return actor;
23
+ }
24
+
25
+ export function throwResourceError(ctx: Context, error: unknown): never {
26
+ if (error instanceof LoopRunAccessError) {
27
+ ctx.throw(error.status, error.message);
28
+ }
29
+ if (error instanceof ZodError) {
30
+ ctx.throw(400, error.issues.map((issue) => issue.message).join(' '));
31
+ }
32
+ ctx.throw(409, error instanceof Error ? error.message : 'The requested operation could not be completed.');
33
+ }
@@ -1,258 +1,266 @@
1
- import { Plugin } from '@nocobase/server';
2
-
3
- import { toPlain } from '../utils/ctx-utils';
4
-
5
- function normalizeSpanFilter(filter: any = {}) {
6
- const next = { ...filter };
7
- if (next.subAgentUsername) {
8
- next.employeeUsername = next.subAgentUsername;
9
- delete next.subAgentUsername;
10
- }
11
- return next;
12
- }
13
-
14
- function spanTitle(row: any) {
15
- if (row.title) return row.title;
16
- if (row.type === 'sub_agent') return `${row.leaderUsername || '-'} -> ${row.employeeUsername || '-'}`;
17
- return row.toolName || row.type || 'span';
18
- }
19
-
20
- function formatSpanListRow(raw: any) {
21
- const row = toPlain(raw);
22
- const metadata = row.metadata || {};
23
- const input = row.input || {};
24
- return {
25
- id: row.id,
26
- rootRunId: row.rootRunId,
27
- parentSpanId: row.parentSpanId,
28
- type: row.type,
29
- leaderUsername: row.leaderUsername,
30
- subAgentUsername: row.employeeUsername,
31
- employeeUsername: row.employeeUsername,
32
- toolName: row.toolName,
33
- task: input.task || metadata.task || row.title || '',
34
- context: input.context || '',
35
- result: row.output,
36
- status: row.status,
37
- depth: metadata.depth ?? 0,
38
- durationMs: row.durationMs,
39
- error: row.error,
40
- userId: row.userId,
41
- createdAt: row.createdAt || row.startedAt,
42
- traceCount: metadata.traceCount || 0,
43
- messageCount: Array.isArray(metadata.messages) ? metadata.messages.length : metadata.messageCount || 0,
44
- hasUnifiedTrace: true,
45
- };
46
- }
47
-
48
- function buildSpanTree(rows: any[]) {
49
- const plainRows = rows.map(toPlain);
50
- const byId = new Map<string, any>();
51
- const roots: any[] = [];
52
-
53
- for (const row of plainRows) {
54
- const node = { ...row, children: [] };
55
- byId.set(String(row.id), node);
56
- }
57
-
58
- for (const row of byId.values()) {
59
- if (row.parentSpanId && byId.has(String(row.parentSpanId))) {
60
- byId.get(String(row.parentSpanId)).children.push(row);
61
- } else {
62
- roots.push(row);
63
- }
64
- }
65
-
66
- const sortTree = (items: any[]) => {
67
- items.sort(
68
- (a, b) =>
69
- new Date(a.startedAt || a.createdAt || 0).getTime() - new Date(b.startedAt || b.createdAt || 0).getTime(),
70
- );
71
- for (const item of items) sortTree(item.children || []);
72
- };
73
- sortTree(roots);
74
- return roots;
75
- }
76
-
77
- function flattenSpanTimeline(rows: any[]) {
78
- return rows
79
- .map(toPlain)
80
- .sort(
81
- (a, b) =>
82
- new Date(a.startedAt || a.createdAt || 0).getTime() - new Date(b.startedAt || b.createdAt || 0).getTime(),
83
- )
84
- .map((row) => {
85
- const input = row.input || {};
86
- const metadata = row.metadata || {};
87
- return {
88
- type: row.type,
89
- at: row.startedAt || row.createdAt,
90
- title: spanTitle(row),
91
- toolName: row.toolName,
92
- args: row.type === 'tool' || row.type === 'skill' ? input : undefined,
93
- status: row.status,
94
- content: row.output || row.error || input.task || metadata.summary || '',
95
- spanId: row.id,
96
- parentSpanId: row.parentSpanId,
97
- skillExecutionId: row.skillExecutionId,
98
- };
99
- });
100
- }
101
-
102
- /**
103
- * Custom resource for the Swarm Tracing admin UI (Phase 5).
104
- * Queries the dedicated orchestratorLogs collection instead of
105
- * filtering aiConversations by JSONB (P2 fix: DB-engine agnostic).
106
- */
107
- export function registerTracingResource(plugin: Plugin) {
108
- const app = plugin.app;
109
-
110
- app.resource({
111
- name: 'orchestratorTracing',
112
- actions: {
113
- /**
114
- * List all delegation execution logs.
115
- */
116
- async list(ctx, next) {
117
- const { page = 1, pageSize = 50, sort = ['-createdAt'], filter = {} } = ctx.action.params;
118
-
119
- try {
120
- const spanRepo = ctx.db.getRepository('agentExecutionSpans');
121
- if (spanRepo) {
122
- const spanFilter = {
123
- ...normalizeSpanFilter(filter),
124
- parentSpanId: null,
125
- type: 'sub_agent',
126
- };
127
- const [spanRows, spanCount] = await spanRepo.findAndCount({
128
- filter: spanFilter,
129
- sort,
130
- offset: (Number(page) - 1) * Number(pageSize),
131
- limit: Number(pageSize),
132
- });
133
-
134
- if (spanCount > 0) {
135
- ctx.body = {
136
- data: spanRows.map(formatSpanListRow),
137
- meta: {
138
- count: spanCount,
139
- page: Number(page),
140
- pageSize: Number(pageSize),
141
- totalPage: Math.ceil(spanCount / Number(pageSize)),
142
- },
143
- };
144
- await next();
145
- return;
146
- }
147
- }
148
-
149
- const repo = ctx.db.getRepository('orchestratorLogs');
150
- const [rows, count] = await repo.findAndCount({
151
- filter,
152
- sort,
153
- offset: (Number(page) - 1) * Number(pageSize),
154
- limit: Number(pageSize),
155
- });
156
-
157
- ctx.body = {
158
- data: rows.map((row: any) => ({
159
- id: row.id,
160
- leaderUsername: row.leaderUsername,
161
- subAgentUsername: row.subAgentUsername,
162
- toolName: row.toolName,
163
- task: row.task,
164
- context: row.context,
165
- result: row.result,
166
- status: row.status,
167
- depth: row.depth,
168
- durationMs: row.durationMs,
169
- error: row.error,
170
- userId: row.userId,
171
- createdAt: row.createdAt,
172
- traceCount: Array.isArray(row.trace) ? row.trace.length : 0,
173
- messageCount: Array.isArray(row.messages) ? row.messages.length : 0,
174
- hasUnifiedTrace: false,
175
- })),
176
- meta: {
177
- count,
178
- page: Number(page),
179
- pageSize: Number(pageSize),
180
- totalPage: Math.ceil(count / Number(pageSize)),
181
- },
182
- };
183
- } catch (e: any) {
184
- // Bubble up so the admin sees an error toast instead of an empty grid.
185
- ctx.log.error('[AgentOrchestrator] Tracing list error', e);
186
- ctx.throw(500, e?.message || 'Failed to load tracing logs');
187
- }
188
-
189
- await next();
190
- },
191
-
192
- /**
193
- * Get a single delegation log by ID.
194
- */
195
- async get(ctx, next) {
196
- const { filterByTk, source } = ctx.action.params;
197
-
198
- if (!filterByTk) {
199
- ctx.throw(400, 'id is required');
200
- return;
201
- }
202
-
203
- try {
204
- const spanRepo = ctx.db.getRepository('agentExecutionSpans');
205
- if (spanRepo && source !== 'log') {
206
- const span = await spanRepo.findOne({
207
- filter: { id: filterByTk },
208
- });
209
-
210
- if (span) {
211
- const plainSpan = toPlain(span);
212
- const rows = await spanRepo.find({
213
- filter: { rootRunId: plainSpan.rootRunId },
214
- sort: ['createdAt'],
215
- });
216
- const tree = buildSpanTree(rows);
217
- const timeline = flattenSpanTimeline(rows);
218
- const rootRow = formatSpanListRow(plainSpan);
219
- const metadata = plainSpan.metadata || {};
220
-
221
- ctx.body = {
222
- data: {
223
- ...rootRow,
224
- input: plainSpan.input,
225
- output: plainSpan.output,
226
- metadata,
227
- trace: timeline,
228
- messages: metadata.messages || [],
229
- children: tree,
230
- },
231
- };
232
- await next();
233
- return;
234
- }
235
- }
236
-
237
- const repo = ctx.db.getRepository('orchestratorLogs');
238
- const log =
239
- source === 'span'
240
- ? null
241
- : await repo.findOne({
242
- filter: { id: filterByTk },
243
- });
244
-
245
- const plainLog = log?.toJSON?.() || log;
246
- ctx.body = { data: plainLog ? { ...plainLog, hasUnifiedTrace: false } : null };
247
- } catch (e: any) {
248
- ctx.log.error('[AgentOrchestrator] Tracing get error', e);
249
- ctx.throw(500, e?.message || 'Failed to load tracing log');
250
- }
251
-
252
- await next();
253
- },
254
- },
255
- });
256
-
257
- // ACL: access is granted by the parent plugin's snippet (pm.plugin-agent-orchestrator → orchestratorTracing:*)
258
- }
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'));