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
@@ -1,482 +1,482 @@
1
- import type { Plugin } from '@nocobase/server';
2
- import { asObject, currentUserId, isAdminUser, toPlain, trimText } from '../utils/ctx-utils';
3
- import { makeNativeRunId, NATIVE_SOURCE } from '../services/NativeSubAgentObserver';
4
-
5
- function normalizeString(value: unknown) {
6
- return typeof value === 'string' ? value.trim() : '';
7
- }
8
-
9
- function readValue(record: unknown, key: string) {
10
- const model = record as { get?: (name: string) => unknown; [key: string]: unknown };
11
- return typeof model?.get === 'function' ? model.get(key) : model?.[key];
12
- }
13
-
14
- function isAdmin(ctx: unknown) {
15
- const context = ctx as { state?: { currentRoles?: string[] } };
16
- if (isAdminUser(ctx)) return true;
17
- const roles = context?.state?.currentRoles;
18
- return Array.isArray(roles) && roles.some((role) => role === 'root' || role === 'admin');
19
- }
20
-
21
- function statusFromNative(status: unknown) {
22
- if (status === 'completed' || status === 'done' || status === 'success') return 'success';
23
- if (status === 'error' || status === 'failed') return 'error';
24
- return 'running';
25
- }
26
-
27
- function formatDuration(ms: unknown) {
28
- const value = Number(ms);
29
- if (!Number.isFinite(value) || value <= 0) return null;
30
- return value;
31
- }
32
-
33
- function formatSpanListRow(raw: unknown) {
34
- const row = toPlain(raw);
35
- const input = asObject(row?.input);
36
- const metadata = asObject(row?.metadata);
37
- return {
38
- id: row?.id,
39
- rootRunId: row?.rootRunId,
40
- source: row?.source || metadata.source,
41
- parentSessionId: row?.parentSessionId || metadata.parentSessionId,
42
- subSessionId: row?.subSessionId || metadata.subSessionId,
43
- toolCallId: row?.toolCallId || metadata.toolCallId,
44
- leaderUsername: row?.leaderUsername,
45
- employeeUsername: row?.employeeUsername,
46
- subAgentUsername: row?.employeeUsername,
47
- toolName: row?.toolName || 'dispatch-sub-agent-task',
48
- task: input.question || input.task || row?.title || '',
49
- status: row?.status,
50
- durationMs: row?.durationMs,
51
- error: row?.error,
52
- userId: row?.userId,
53
- memoryContextApplied: Boolean(metadata.memoryContextApplied),
54
- memoryScopes: metadata.memoryScopes || [],
55
- harnessTag: metadata.harnessTag || 'default',
56
- createdAt: row?.createdAt || row?.startedAt,
57
- startedAt: row?.startedAt,
58
- endedAt: row?.endedAt,
59
- };
60
- }
61
-
62
- function buildSpanTree(rows: unknown[]) {
63
- const byId = new Map<string, Record<string, unknown> & { children: unknown[] }>();
64
- const roots: Array<Record<string, unknown> & { children: unknown[] }> = [];
65
-
66
- for (const raw of rows) {
67
- const row = toPlain(raw);
68
- byId.set(String(row.id), { ...row, children: [] });
69
- }
70
-
71
- for (const row of byId.values()) {
72
- const parentSpanId = normalizeString(row.parentSpanId);
73
- if (parentSpanId && byId.has(parentSpanId)) {
74
- byId.get(parentSpanId)?.children.push(row);
75
- } else {
76
- roots.push(row);
77
- }
78
- }
79
-
80
- const sort = (items: Array<Record<string, unknown> & { children: unknown[] }>) => {
81
- items.sort(
82
- (a, b) =>
83
- new Date(String(a.startedAt || a.createdAt || 0)).getTime() -
84
- new Date(String(b.startedAt || b.createdAt || 0)).getTime(),
85
- );
86
- for (const item of items) sort(item.children as Array<Record<string, unknown> & { children: unknown[] }>);
87
- };
88
- sort(roots);
89
- return roots;
90
- }
91
-
92
- function flattenTimeline(rows: unknown[]) {
93
- return rows
94
- .map(toPlain)
95
- .sort(
96
- (a, b) =>
97
- new Date(String(a.startedAt || a.createdAt || 0)).getTime() -
98
- new Date(String(b.startedAt || b.createdAt || 0)).getTime(),
99
- )
100
- .map((row) => ({
101
- id: row.id,
102
- type: row.type,
103
- at: row.startedAt || row.createdAt,
104
- title: row.title || row.toolName || row.type,
105
- toolName: row.toolName,
106
- status: row.status,
107
- durationMs: row.durationMs,
108
- content: row.output || row.error || asObject(row.input).question || '',
109
- parentSpanId: row.parentSpanId,
110
- input: row.input,
111
- output: row.output,
112
- error: row.error,
113
- }));
114
- }
115
-
116
- async function findConversation(ctx: any, sessionId?: string) {
117
- if (!sessionId) return null;
118
- try {
119
- return toPlain(
120
- await ctx.db.getRepository('aiConversations').findOne({
121
- filter: { sessionId },
122
- }),
123
- );
124
- } catch {
125
- return null;
126
- }
127
- }
128
-
129
- async function findToolMessages(ctx: any, sessionIds: string[]) {
130
- const repo = ctx.db.getRepository('aiToolMessages');
131
- const rows: unknown[] = [];
132
- for (const sessionId of Array.from(new Set(sessionIds.filter(Boolean)))) {
133
- try {
134
- const list = await repo.find({
135
- filter: { sessionId },
136
- sort: ['messageId', 'id'],
137
- });
138
- rows.push(...list);
139
- } catch {
140
- // Keep monitor read-only and best-effort across plugin-ai versions.
141
- }
142
- }
143
- return rows.map(toPlain);
144
- }
145
-
146
- async function findNativeMessages(ctx: any, parentSessionId?: string, subSessionId?: string) {
147
- const repo = ctx.db.getRepository('aiMessages');
148
- const rows: unknown[] = [];
149
- for (const sessionId of [parentSessionId, subSessionId].filter(Boolean)) {
150
- try {
151
- const list = await repo.find({
152
- filter: { sessionId },
153
- sort: ['messageId'],
154
- limit: 200,
155
- });
156
- rows.push(...list);
157
- } catch {
158
- // Optional native details only.
159
- }
160
- }
161
- return rows.map(toPlain);
162
- }
163
-
164
- async function backfillFromMetadata(ctx: any, spanRepo: any, limit: number) {
165
- const messageRepo = ctx.db.getRepository('aiMessages');
166
- const toolRepo = ctx.db.getRepository('aiToolMessages');
167
- const conversationRepo = ctx.db.getRepository('aiConversations');
168
- const messages = await messageRepo.find({
169
- sort: ['-messageId'],
170
- limit,
171
- });
172
- let created = 0;
173
- let skipped = 0;
174
-
175
- for (const rawMessage of messages) {
176
- const message = toPlain(rawMessage);
177
- const conversations = asObject(message.metadata).subAgentConversations;
178
- if (!Array.isArray(conversations)) continue;
179
-
180
- for (const item of conversations) {
181
- const subSessionId = normalizeString(item?.sessionId);
182
- const toolCallId = normalizeString(item?.toolCallId);
183
- if (!subSessionId || !toolCallId) {
184
- skipped += 1;
185
- continue;
186
- }
187
-
188
- const existing = await spanRepo.findOne({
189
- filter: {
190
- source: NATIVE_SOURCE,
191
- subSessionId,
192
- toolCallId,
193
- type: 'sub_agent',
194
- },
195
- });
196
- if (existing) {
197
- skipped += 1;
198
- continue;
199
- }
200
-
201
- const toolMessage = toPlain(
202
- await toolRepo.findOne({
203
- filter: { toolCallId },
204
- }),
205
- );
206
- const parentSessionId = normalizeString(toolMessage?.sessionId) || normalizeString(message.sessionId);
207
- const parentConversation = parentSessionId
208
- ? toPlain(await conversationRepo.findOne({ filter: { sessionId: parentSessionId } }))
209
- : null;
210
- const subConversation = toPlain(await conversationRepo.findOne({ filter: { sessionId: subSessionId } }));
211
- const invokeStart = Number(toolMessage?.invokeStartTime);
212
- const invokeEnd = Number(toolMessage?.invokeEndTime);
213
- const durationMs =
214
- Number.isFinite(invokeStart) && Number.isFinite(invokeEnd) && invokeEnd >= invokeStart
215
- ? invokeEnd - invokeStart
216
- : undefined;
217
- const rootRunId = makeNativeRunId([
218
- parentSessionId,
219
- subSessionId,
220
- toolCallId,
221
- subConversation?.aiEmployeeUsername,
222
- ]);
223
- const content = asObject(toolMessage?.content);
224
-
225
- await spanRepo.create({
226
- values: {
227
- rootRunId,
228
- parentSpanId: null,
229
- source: NATIVE_SOURCE,
230
- parentSessionId: parentSessionId || undefined,
231
- subSessionId: subSessionId || undefined,
232
- toolCallId,
233
- type: 'sub_agent',
234
- status: statusFromNative(item?.status || toolMessage?.status),
235
- leaderUsername: parentConversation?.aiEmployeeUsername,
236
- employeeUsername: subConversation?.aiEmployeeUsername,
237
- toolName: 'dispatch-sub-agent-task',
238
- title:
239
- subConversation?.title ||
240
- `${parentConversation?.aiEmployeeUsername || 'main'} -> ${
241
- subConversation?.aiEmployeeUsername || 'sub-agent'
242
- }`,
243
- input: {
244
- question: subConversation?.title,
245
- parentSessionId: parentSessionId || undefined,
246
- subSessionId: subSessionId || undefined,
247
- },
248
- output: trimText(content.answer || toolMessage?.content, 20000),
249
- durationMs: formatDuration(durationMs),
250
- startedAt: invokeStart ? new Date(invokeStart) : new Date(),
251
- endedAt: invokeEnd ? new Date(invokeEnd) : undefined,
252
- metadata: {
253
- source: NATIVE_SOURCE,
254
- backfilled: true,
255
- messageId: message.messageId,
256
- toolMessageId: toolMessage?.id,
257
- nativeStatus: item?.status,
258
- },
259
- userId: parentConversation?.userId || subConversation?.userId,
260
- createdAt: new Date(),
261
- },
262
- });
263
- created += 1;
264
- }
265
- }
266
-
267
- return { created, skipped };
268
- }
269
-
270
- async function backfillFromToolMessages(ctx: any, spanRepo: any, limit: number) {
271
- const toolRepo = ctx.db.getRepository('aiToolMessages');
272
- const toolMessages = await toolRepo.find({
273
- filter: { toolName: 'dispatch-sub-agent-task' },
274
- sort: ['-id'],
275
- limit,
276
- });
277
- let created = 0;
278
- let skipped = 0;
279
-
280
- for (const rawToolMessage of toolMessages) {
281
- const toolMessage = toPlain(rawToolMessage);
282
- const content = asObject(toolMessage.content);
283
- const subSessionId = normalizeString(content.sessionId);
284
- const toolCallId = normalizeString(toolMessage.toolCallId);
285
- if (!subSessionId || !toolCallId) {
286
- skipped += 1;
287
- continue;
288
- }
289
-
290
- const existing = await spanRepo.findOne({
291
- filter: {
292
- source: NATIVE_SOURCE,
293
- subSessionId,
294
- toolCallId,
295
- type: 'sub_agent',
296
- },
297
- });
298
- if (existing) {
299
- skipped += 1;
300
- continue;
301
- }
302
-
303
- const parentSessionId = normalizeString(toolMessage.sessionId);
304
- const parentConversation = await findConversation(ctx, parentSessionId);
305
- const subConversation = await findConversation(ctx, subSessionId);
306
- const invokeStart = Number(toolMessage.invokeStartTime);
307
- const invokeEnd = Number(toolMessage.invokeEndTime);
308
- const rootRunId = makeNativeRunId([parentSessionId, subSessionId, toolCallId, subConversation?.aiEmployeeUsername]);
309
-
310
- await spanRepo.create({
311
- values: {
312
- rootRunId,
313
- parentSpanId: null,
314
- source: NATIVE_SOURCE,
315
- parentSessionId: parentSessionId || undefined,
316
- subSessionId: subSessionId || undefined,
317
- toolCallId,
318
- type: 'sub_agent',
319
- status: statusFromNative(toolMessage.status),
320
- leaderUsername: parentConversation?.aiEmployeeUsername,
321
- employeeUsername: subConversation?.aiEmployeeUsername,
322
- toolName: 'dispatch-sub-agent-task',
323
- title:
324
- subConversation?.title ||
325
- `${parentConversation?.aiEmployeeUsername || 'main'} -> ${
326
- subConversation?.aiEmployeeUsername || 'sub-agent'
327
- }`,
328
- input: {
329
- question: subConversation?.title,
330
- parentSessionId: parentSessionId || undefined,
331
- subSessionId: subSessionId || undefined,
332
- },
333
- output: trimText(content.answer || toolMessage.content, 20000),
334
- durationMs:
335
- Number.isFinite(invokeStart) && Number.isFinite(invokeEnd) && invokeEnd >= invokeStart
336
- ? invokeEnd - invokeStart
337
- : undefined,
338
- startedAt: invokeStart ? new Date(invokeStart) : new Date(),
339
- endedAt: invokeEnd ? new Date(invokeEnd) : undefined,
340
- metadata: {
341
- source: NATIVE_SOURCE,
342
- backfilled: true,
343
- toolMessageId: toolMessage.id,
344
- },
345
- userId: parentConversation?.userId || subConversation?.userId,
346
- createdAt: new Date(),
347
- },
348
- });
349
- created += 1;
350
- }
351
-
352
- return { created, skipped };
353
- }
354
-
355
- export function registerAgentMonitorResource(plugin: Plugin) {
356
- plugin.app.resource({
357
- name: 'agentMonitor',
358
- actions: {
359
- async list(ctx, next) {
360
- const { page = 1, pageSize = 20, sort = ['-createdAt'], filter = {} } = ctx.action.params;
361
- const requestedFilter = asObject(filter);
362
- const spanFilter: Record<string, unknown> = {
363
- source: NATIVE_SOURCE,
364
- type: 'sub_agent',
365
- parentSpanId: null,
366
- };
367
-
368
- for (const key of [
369
- 'leaderUsername',
370
- 'employeeUsername',
371
- 'status',
372
- 'parentSessionId',
373
- 'subSessionId',
374
- 'toolCallId',
375
- ]) {
376
- if (requestedFilter[key]) spanFilter[key] = requestedFilter[key];
377
- }
378
- if (requestedFilter.subAgentUsername) spanFilter.employeeUsername = requestedFilter.subAgentUsername;
379
- if (requestedFilter.sessionId) spanFilter.parentSessionId = requestedFilter.sessionId;
380
-
381
- if (!isAdmin(ctx)) {
382
- const userId = currentUserId(ctx);
383
- if (!userId) ctx.throw(401, 'Not authenticated');
384
- spanFilter.userId = userId;
385
- } else if (requestedFilter.userId) {
386
- spanFilter.userId = requestedFilter.userId;
387
- }
388
-
389
- const repo = ctx.db.getRepository('agentExecutionSpans');
390
- const [rows, count] = await repo.findAndCount({
391
- filter: spanFilter,
392
- sort,
393
- offset: (Number(page) - 1) * Number(pageSize),
394
- limit: Number(pageSize),
395
- });
396
-
397
- ctx.body = {
398
- data: rows.map(formatSpanListRow),
399
- meta: {
400
- count,
401
- page: Number(page),
402
- pageSize: Number(pageSize),
403
- totalPage: Math.ceil(count / Number(pageSize)),
404
- },
405
- };
406
- await next();
407
- },
408
-
409
- async get(ctx, next) {
410
- const { filterByTk } = ctx.action.params;
411
- if (!filterByTk) {
412
- ctx.throw(400, 'span id is required');
413
- return;
414
- }
415
-
416
- const repo = ctx.db.getRepository('agentExecutionSpans');
417
- const span = toPlain(
418
- await repo.findOne({
419
- filter: { id: filterByTk },
420
- }),
421
- );
422
- if (!span) {
423
- ctx.throw(404, 'span not found');
424
- return;
425
- }
426
-
427
- if (!isAdmin(ctx) && String(span.userId || '') !== String(currentUserId(ctx) || '')) {
428
- ctx.throw(403, 'You cannot view this agent run.');
429
- return;
430
- }
431
-
432
- const rows = await repo.find({
433
- filter: { rootRunId: span.rootRunId },
434
- sort: ['createdAt'],
435
- });
436
- const parentSessionId = normalizeString(span.parentSessionId || asObject(span.metadata).parentSessionId);
437
- const subSessionId = normalizeString(span.subSessionId || asObject(span.metadata).subSessionId);
438
-
439
- ctx.body = {
440
- data: {
441
- ...formatSpanListRow(span),
442
- input: span.input,
443
- output: span.output,
444
- metadata: span.metadata || {},
445
- children: buildSpanTree(rows),
446
- trace: flattenTimeline(rows),
447
- nativeConversations: {
448
- parent: await findConversation(ctx, parentSessionId),
449
- subAgent: await findConversation(ctx, subSessionId),
450
- },
451
- nativeMessages: await findNativeMessages(ctx, parentSessionId, subSessionId),
452
- toolMessages: await findToolMessages(ctx, [parentSessionId, subSessionId]),
453
- },
454
- };
455
- await next();
456
- },
457
-
458
- async sync(ctx, next) {
459
- if (!isAdmin(ctx)) {
460
- ctx.throw(403, 'Admin role is required to sync native agent monitor spans.');
461
- return;
462
- }
463
-
464
- const values = asObject(ctx.action.params?.values);
465
- const limit = Math.min(Math.max(Number(values.limit || ctx.action.params?.limit || 200), 1), 1000);
466
- const spanRepo = ctx.db.getRepository('agentExecutionSpans');
467
- const metadataResult = await backfillFromMetadata(ctx, spanRepo, limit);
468
- const toolResult = await backfillFromToolMessages(ctx, spanRepo, limit);
469
-
470
- ctx.body = {
471
- data: {
472
- created: metadataResult.created + toolResult.created,
473
- skipped: metadataResult.skipped + toolResult.skipped,
474
- metadata: metadataResult,
475
- toolMessages: toolResult,
476
- },
477
- };
478
- await next();
479
- },
480
- },
481
- });
482
- }
1
+ import type { Plugin } from '@nocobase/server';
2
+ import { asObject, currentUserId, isAdminUser, toPlain, trimText } from '../utils/ctx-utils';
3
+ import { makeNativeRunId, NATIVE_SOURCE } from '../services/NativeSubAgentObserver';
4
+
5
+ function normalizeString(value: unknown) {
6
+ return typeof value === 'string' ? value.trim() : '';
7
+ }
8
+
9
+ function readValue(record: unknown, key: string) {
10
+ const model = record as { get?: (name: string) => unknown; [key: string]: unknown };
11
+ return typeof model?.get === 'function' ? model.get(key) : model?.[key];
12
+ }
13
+
14
+ function isAdmin(ctx: unknown) {
15
+ const context = ctx as { state?: { currentRoles?: string[] } };
16
+ if (isAdminUser(ctx)) return true;
17
+ const roles = context?.state?.currentRoles;
18
+ return Array.isArray(roles) && roles.some((role) => role === 'root' || role === 'admin');
19
+ }
20
+
21
+ function statusFromNative(status: unknown) {
22
+ if (status === 'completed' || status === 'done' || status === 'success') return 'success';
23
+ if (status === 'error' || status === 'failed') return 'error';
24
+ return 'running';
25
+ }
26
+
27
+ function formatDuration(ms: unknown) {
28
+ const value = Number(ms);
29
+ if (!Number.isFinite(value) || value <= 0) return null;
30
+ return value;
31
+ }
32
+
33
+ function formatSpanListRow(raw: unknown) {
34
+ const row = toPlain(raw);
35
+ const input = asObject(row?.input);
36
+ const metadata = asObject(row?.metadata);
37
+ return {
38
+ id: row?.id,
39
+ rootRunId: row?.rootRunId,
40
+ source: row?.source || metadata.source,
41
+ parentSessionId: row?.parentSessionId || metadata.parentSessionId,
42
+ subSessionId: row?.subSessionId || metadata.subSessionId,
43
+ toolCallId: row?.toolCallId || metadata.toolCallId,
44
+ leaderUsername: row?.leaderUsername,
45
+ employeeUsername: row?.employeeUsername,
46
+ subAgentUsername: row?.employeeUsername,
47
+ toolName: row?.toolName || 'dispatch-sub-agent-task',
48
+ task: input.question || input.task || row?.title || '',
49
+ status: row?.status,
50
+ durationMs: row?.durationMs,
51
+ error: row?.error,
52
+ userId: row?.userId,
53
+ memoryContextApplied: Boolean(metadata.memoryContextApplied),
54
+ memoryScopes: metadata.memoryScopes || [],
55
+ harnessTag: metadata.harnessTag || 'default',
56
+ createdAt: row?.createdAt || row?.startedAt,
57
+ startedAt: row?.startedAt,
58
+ endedAt: row?.endedAt,
59
+ };
60
+ }
61
+
62
+ function buildSpanTree(rows: unknown[]) {
63
+ const byId = new Map<string, Record<string, unknown> & { children: unknown[] }>();
64
+ const roots: Array<Record<string, unknown> & { children: unknown[] }> = [];
65
+
66
+ for (const raw of rows) {
67
+ const row = toPlain(raw);
68
+ byId.set(String(row.id), { ...row, children: [] });
69
+ }
70
+
71
+ for (const row of byId.values()) {
72
+ const parentSpanId = normalizeString(row.parentSpanId);
73
+ if (parentSpanId && byId.has(parentSpanId)) {
74
+ byId.get(parentSpanId)?.children.push(row);
75
+ } else {
76
+ roots.push(row);
77
+ }
78
+ }
79
+
80
+ const sort = (items: Array<Record<string, unknown> & { children: unknown[] }>) => {
81
+ items.sort(
82
+ (a, b) =>
83
+ new Date(String(a.startedAt || a.createdAt || 0)).getTime() -
84
+ new Date(String(b.startedAt || b.createdAt || 0)).getTime(),
85
+ );
86
+ for (const item of items) sort(item.children as Array<Record<string, unknown> & { children: unknown[] }>);
87
+ };
88
+ sort(roots);
89
+ return roots;
90
+ }
91
+
92
+ function flattenTimeline(rows: unknown[]) {
93
+ return rows
94
+ .map(toPlain)
95
+ .sort(
96
+ (a, b) =>
97
+ new Date(String(a.startedAt || a.createdAt || 0)).getTime() -
98
+ new Date(String(b.startedAt || b.createdAt || 0)).getTime(),
99
+ )
100
+ .map((row) => ({
101
+ id: row.id,
102
+ type: row.type,
103
+ at: row.startedAt || row.createdAt,
104
+ title: row.title || row.toolName || row.type,
105
+ toolName: row.toolName,
106
+ status: row.status,
107
+ durationMs: row.durationMs,
108
+ content: row.output || row.error || asObject(row.input).question || '',
109
+ parentSpanId: row.parentSpanId,
110
+ input: row.input,
111
+ output: row.output,
112
+ error: row.error,
113
+ }));
114
+ }
115
+
116
+ async function findConversation(ctx: any, sessionId?: string) {
117
+ if (!sessionId) return null;
118
+ try {
119
+ return toPlain(
120
+ await ctx.db.getRepository('aiConversations').findOne({
121
+ filter: { sessionId },
122
+ }),
123
+ );
124
+ } catch {
125
+ return null;
126
+ }
127
+ }
128
+
129
+ async function findToolMessages(ctx: any, sessionIds: string[]) {
130
+ const repo = ctx.db.getRepository('aiToolMessages');
131
+ const rows: unknown[] = [];
132
+ for (const sessionId of Array.from(new Set(sessionIds.filter(Boolean)))) {
133
+ try {
134
+ const list = await repo.find({
135
+ filter: { sessionId },
136
+ sort: ['messageId', 'id'],
137
+ });
138
+ rows.push(...list);
139
+ } catch {
140
+ // Keep monitor read-only and best-effort across plugin-ai versions.
141
+ }
142
+ }
143
+ return rows.map(toPlain);
144
+ }
145
+
146
+ async function findNativeMessages(ctx: any, parentSessionId?: string, subSessionId?: string) {
147
+ const repo = ctx.db.getRepository('aiMessages');
148
+ const rows: unknown[] = [];
149
+ for (const sessionId of [parentSessionId, subSessionId].filter(Boolean)) {
150
+ try {
151
+ const list = await repo.find({
152
+ filter: { sessionId },
153
+ sort: ['messageId'],
154
+ limit: 200,
155
+ });
156
+ rows.push(...list);
157
+ } catch {
158
+ // Optional native details only.
159
+ }
160
+ }
161
+ return rows.map(toPlain);
162
+ }
163
+
164
+ async function backfillFromMetadata(ctx: any, spanRepo: any, limit: number) {
165
+ const messageRepo = ctx.db.getRepository('aiMessages');
166
+ const toolRepo = ctx.db.getRepository('aiToolMessages');
167
+ const conversationRepo = ctx.db.getRepository('aiConversations');
168
+ const messages = await messageRepo.find({
169
+ sort: ['-messageId'],
170
+ limit,
171
+ });
172
+ let created = 0;
173
+ let skipped = 0;
174
+
175
+ for (const rawMessage of messages) {
176
+ const message = toPlain(rawMessage);
177
+ const conversations = asObject(message.metadata).subAgentConversations;
178
+ if (!Array.isArray(conversations)) continue;
179
+
180
+ for (const item of conversations) {
181
+ const subSessionId = normalizeString(item?.sessionId);
182
+ const toolCallId = normalizeString(item?.toolCallId);
183
+ if (!subSessionId || !toolCallId) {
184
+ skipped += 1;
185
+ continue;
186
+ }
187
+
188
+ const existing = await spanRepo.findOne({
189
+ filter: {
190
+ source: NATIVE_SOURCE,
191
+ subSessionId,
192
+ toolCallId,
193
+ type: 'sub_agent',
194
+ },
195
+ });
196
+ if (existing) {
197
+ skipped += 1;
198
+ continue;
199
+ }
200
+
201
+ const toolMessage = toPlain(
202
+ await toolRepo.findOne({
203
+ filter: { toolCallId },
204
+ }),
205
+ );
206
+ const parentSessionId = normalizeString(toolMessage?.sessionId) || normalizeString(message.sessionId);
207
+ const parentConversation = parentSessionId
208
+ ? toPlain(await conversationRepo.findOne({ filter: { sessionId: parentSessionId } }))
209
+ : null;
210
+ const subConversation = toPlain(await conversationRepo.findOne({ filter: { sessionId: subSessionId } }));
211
+ const invokeStart = Number(toolMessage?.invokeStartTime);
212
+ const invokeEnd = Number(toolMessage?.invokeEndTime);
213
+ const durationMs =
214
+ Number.isFinite(invokeStart) && Number.isFinite(invokeEnd) && invokeEnd >= invokeStart
215
+ ? invokeEnd - invokeStart
216
+ : undefined;
217
+ const rootRunId = makeNativeRunId([
218
+ parentSessionId,
219
+ subSessionId,
220
+ toolCallId,
221
+ subConversation?.aiEmployeeUsername,
222
+ ]);
223
+ const content = asObject(toolMessage?.content);
224
+
225
+ await spanRepo.create({
226
+ values: {
227
+ rootRunId,
228
+ parentSpanId: null,
229
+ source: NATIVE_SOURCE,
230
+ parentSessionId: parentSessionId || undefined,
231
+ subSessionId: subSessionId || undefined,
232
+ toolCallId,
233
+ type: 'sub_agent',
234
+ status: statusFromNative(item?.status || toolMessage?.status),
235
+ leaderUsername: parentConversation?.aiEmployeeUsername,
236
+ employeeUsername: subConversation?.aiEmployeeUsername,
237
+ toolName: 'dispatch-sub-agent-task',
238
+ title:
239
+ subConversation?.title ||
240
+ `${parentConversation?.aiEmployeeUsername || 'main'} -> ${
241
+ subConversation?.aiEmployeeUsername || 'sub-agent'
242
+ }`,
243
+ input: {
244
+ question: subConversation?.title,
245
+ parentSessionId: parentSessionId || undefined,
246
+ subSessionId: subSessionId || undefined,
247
+ },
248
+ output: trimText(content.answer || toolMessage?.content, 20000),
249
+ durationMs: formatDuration(durationMs),
250
+ startedAt: invokeStart ? new Date(invokeStart) : new Date(),
251
+ endedAt: invokeEnd ? new Date(invokeEnd) : undefined,
252
+ metadata: {
253
+ source: NATIVE_SOURCE,
254
+ backfilled: true,
255
+ messageId: message.messageId,
256
+ toolMessageId: toolMessage?.id,
257
+ nativeStatus: item?.status,
258
+ },
259
+ userId: parentConversation?.userId || subConversation?.userId,
260
+ createdAt: new Date(),
261
+ },
262
+ });
263
+ created += 1;
264
+ }
265
+ }
266
+
267
+ return { created, skipped };
268
+ }
269
+
270
+ async function backfillFromToolMessages(ctx: any, spanRepo: any, limit: number) {
271
+ const toolRepo = ctx.db.getRepository('aiToolMessages');
272
+ const toolMessages = await toolRepo.find({
273
+ filter: { toolName: 'dispatch-sub-agent-task' },
274
+ sort: ['-id'],
275
+ limit,
276
+ });
277
+ let created = 0;
278
+ let skipped = 0;
279
+
280
+ for (const rawToolMessage of toolMessages) {
281
+ const toolMessage = toPlain(rawToolMessage);
282
+ const content = asObject(toolMessage.content);
283
+ const subSessionId = normalizeString(content.sessionId);
284
+ const toolCallId = normalizeString(toolMessage.toolCallId);
285
+ if (!subSessionId || !toolCallId) {
286
+ skipped += 1;
287
+ continue;
288
+ }
289
+
290
+ const existing = await spanRepo.findOne({
291
+ filter: {
292
+ source: NATIVE_SOURCE,
293
+ subSessionId,
294
+ toolCallId,
295
+ type: 'sub_agent',
296
+ },
297
+ });
298
+ if (existing) {
299
+ skipped += 1;
300
+ continue;
301
+ }
302
+
303
+ const parentSessionId = normalizeString(toolMessage.sessionId);
304
+ const parentConversation = await findConversation(ctx, parentSessionId);
305
+ const subConversation = await findConversation(ctx, subSessionId);
306
+ const invokeStart = Number(toolMessage.invokeStartTime);
307
+ const invokeEnd = Number(toolMessage.invokeEndTime);
308
+ const rootRunId = makeNativeRunId([parentSessionId, subSessionId, toolCallId, subConversation?.aiEmployeeUsername]);
309
+
310
+ await spanRepo.create({
311
+ values: {
312
+ rootRunId,
313
+ parentSpanId: null,
314
+ source: NATIVE_SOURCE,
315
+ parentSessionId: parentSessionId || undefined,
316
+ subSessionId: subSessionId || undefined,
317
+ toolCallId,
318
+ type: 'sub_agent',
319
+ status: statusFromNative(toolMessage.status),
320
+ leaderUsername: parentConversation?.aiEmployeeUsername,
321
+ employeeUsername: subConversation?.aiEmployeeUsername,
322
+ toolName: 'dispatch-sub-agent-task',
323
+ title:
324
+ subConversation?.title ||
325
+ `${parentConversation?.aiEmployeeUsername || 'main'} -> ${
326
+ subConversation?.aiEmployeeUsername || 'sub-agent'
327
+ }`,
328
+ input: {
329
+ question: subConversation?.title,
330
+ parentSessionId: parentSessionId || undefined,
331
+ subSessionId: subSessionId || undefined,
332
+ },
333
+ output: trimText(content.answer || toolMessage.content, 20000),
334
+ durationMs:
335
+ Number.isFinite(invokeStart) && Number.isFinite(invokeEnd) && invokeEnd >= invokeStart
336
+ ? invokeEnd - invokeStart
337
+ : undefined,
338
+ startedAt: invokeStart ? new Date(invokeStart) : new Date(),
339
+ endedAt: invokeEnd ? new Date(invokeEnd) : undefined,
340
+ metadata: {
341
+ source: NATIVE_SOURCE,
342
+ backfilled: true,
343
+ toolMessageId: toolMessage.id,
344
+ },
345
+ userId: parentConversation?.userId || subConversation?.userId,
346
+ createdAt: new Date(),
347
+ },
348
+ });
349
+ created += 1;
350
+ }
351
+
352
+ return { created, skipped };
353
+ }
354
+
355
+ export function registerAgentMonitorResource(plugin: Plugin) {
356
+ plugin.app.resource({
357
+ name: 'agentMonitor',
358
+ actions: {
359
+ async list(ctx, next) {
360
+ const { page = 1, pageSize = 20, sort = ['-createdAt'], filter = {} } = ctx.action.params;
361
+ const requestedFilter = asObject(filter);
362
+ const spanFilter: Record<string, unknown> = {
363
+ source: NATIVE_SOURCE,
364
+ type: 'sub_agent',
365
+ parentSpanId: null,
366
+ };
367
+
368
+ for (const key of [
369
+ 'leaderUsername',
370
+ 'employeeUsername',
371
+ 'status',
372
+ 'parentSessionId',
373
+ 'subSessionId',
374
+ 'toolCallId',
375
+ ]) {
376
+ if (requestedFilter[key]) spanFilter[key] = requestedFilter[key];
377
+ }
378
+ if (requestedFilter.subAgentUsername) spanFilter.employeeUsername = requestedFilter.subAgentUsername;
379
+ if (requestedFilter.sessionId) spanFilter.parentSessionId = requestedFilter.sessionId;
380
+
381
+ if (!isAdmin(ctx)) {
382
+ const userId = currentUserId(ctx);
383
+ if (!userId) ctx.throw(401, 'Not authenticated');
384
+ spanFilter.userId = userId;
385
+ } else if (requestedFilter.userId) {
386
+ spanFilter.userId = requestedFilter.userId;
387
+ }
388
+
389
+ const repo = ctx.db.getRepository('agentExecutionSpans');
390
+ const [rows, count] = await repo.findAndCount({
391
+ filter: spanFilter,
392
+ sort,
393
+ offset: (Number(page) - 1) * Number(pageSize),
394
+ limit: Number(pageSize),
395
+ });
396
+
397
+ ctx.body = {
398
+ data: rows.map(formatSpanListRow),
399
+ meta: {
400
+ count,
401
+ page: Number(page),
402
+ pageSize: Number(pageSize),
403
+ totalPage: Math.ceil(count / Number(pageSize)),
404
+ },
405
+ };
406
+ await next();
407
+ },
408
+
409
+ async get(ctx, next) {
410
+ const { filterByTk } = ctx.action.params;
411
+ if (!filterByTk) {
412
+ ctx.throw(400, 'span id is required');
413
+ return;
414
+ }
415
+
416
+ const repo = ctx.db.getRepository('agentExecutionSpans');
417
+ const span = toPlain(
418
+ await repo.findOne({
419
+ filter: { id: filterByTk },
420
+ }),
421
+ );
422
+ if (!span) {
423
+ ctx.throw(404, 'span not found');
424
+ return;
425
+ }
426
+
427
+ if (!isAdmin(ctx) && String(span.userId || '') !== String(currentUserId(ctx) || '')) {
428
+ ctx.throw(403, 'You cannot view this agent run.');
429
+ return;
430
+ }
431
+
432
+ const rows = await repo.find({
433
+ filter: { rootRunId: span.rootRunId },
434
+ sort: ['createdAt'],
435
+ });
436
+ const parentSessionId = normalizeString(span.parentSessionId || asObject(span.metadata).parentSessionId);
437
+ const subSessionId = normalizeString(span.subSessionId || asObject(span.metadata).subSessionId);
438
+
439
+ ctx.body = {
440
+ data: {
441
+ ...formatSpanListRow(span),
442
+ input: span.input,
443
+ output: span.output,
444
+ metadata: span.metadata || {},
445
+ children: buildSpanTree(rows),
446
+ trace: flattenTimeline(rows),
447
+ nativeConversations: {
448
+ parent: await findConversation(ctx, parentSessionId),
449
+ subAgent: await findConversation(ctx, subSessionId),
450
+ },
451
+ nativeMessages: await findNativeMessages(ctx, parentSessionId, subSessionId),
452
+ toolMessages: await findToolMessages(ctx, [parentSessionId, subSessionId]),
453
+ },
454
+ };
455
+ await next();
456
+ },
457
+
458
+ async sync(ctx, next) {
459
+ if (!isAdmin(ctx)) {
460
+ ctx.throw(403, 'Admin role is required to sync native agent monitor spans.');
461
+ return;
462
+ }
463
+
464
+ const values = asObject(ctx.action.params?.values);
465
+ const limit = Math.min(Math.max(Number(values.limit || ctx.action.params?.limit || 200), 1), 1000);
466
+ const spanRepo = ctx.db.getRepository('agentExecutionSpans');
467
+ const metadataResult = await backfillFromMetadata(ctx, spanRepo, limit);
468
+ const toolResult = await backfillFromToolMessages(ctx, spanRepo, limit);
469
+
470
+ ctx.body = {
471
+ data: {
472
+ created: metadataResult.created + toolResult.created,
473
+ skipped: metadataResult.skipped + toolResult.skipped,
474
+ metadata: metadataResult,
475
+ toolMessages: toolResult,
476
+ },
477
+ };
478
+ await next();
479
+ },
480
+ },
481
+ });
482
+ }