plugin-agent-orchestrator 1.1.3 → 1.1.4

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 (173) hide show
  1. package/dist/client/index.js +1 -1
  2. package/dist/client-v2/214.b063f33ba044a808.js +10 -0
  3. package/dist/client-v2/253.59577b40d9875be0.js +10 -0
  4. package/dist/client-v2/264.7ed8bee71fa5935c.js +10 -0
  5. package/dist/client-v2/{41.ba6e080cc0488143.js → 41.3deb9e57a0f64fc4.js} +1 -1
  6. package/dist/client-v2/418.58fa350f5496efd3.js +10 -0
  7. package/dist/client-v2/{53.7c29c28043e9112d.js → 53.9a10455323390f14.js} +1 -1
  8. package/dist/client-v2/619.0a2144aaffefe018.js +10 -0
  9. package/dist/client-v2/{70.bda9518881c05360.js → 70.ffff2997c10fd4b0.js} +1 -1
  10. package/dist/client-v2/{794.9bbb8d3a61b2bdf2.js → 794.a67a2614405ba627.js} +1 -1
  11. package/dist/client-v2/925.e5925bf21ed68e7a.js +10 -0
  12. package/dist/client-v2/{993.82778b6fd6db3cb1.js → 993.b0688fdc5ccb000a.js} +1 -1
  13. package/dist/client-v2/index.js +1 -1
  14. package/dist/externalVersion.js +8 -6
  15. package/dist/locale/en-US.json +48 -28
  16. package/dist/locale/vi-VN.json +48 -28
  17. package/dist/locale/zh-CN.json +48 -28
  18. package/dist/server/collections/agent-execution-spans.js +47 -0
  19. package/dist/server/collections/agent-harness-profile-versions.js +56 -0
  20. package/dist/server/collections/agent-harness-profiles.js +12 -0
  21. package/dist/server/collections/agent-loop-action-approvals.js +68 -0
  22. package/dist/server/collections/agent-loop-artifacts.js +55 -0
  23. package/dist/server/collections/agent-loop-circuit-states.js +53 -0
  24. package/dist/server/collections/agent-loop-control-settings.js +51 -0
  25. package/dist/server/collections/agent-loop-events.js +27 -0
  26. package/dist/server/collections/agent-loop-path-locks.js +57 -0
  27. package/dist/server/collections/agent-loop-patterns.js +72 -0
  28. package/dist/server/collections/agent-loop-runs.js +163 -2
  29. package/dist/server/collections/agent-loop-steps.js +69 -0
  30. package/dist/server/collections/agent-loop-usage-buckets.js +52 -0
  31. package/dist/server/collections/agent-loop-worktrees.js +55 -0
  32. package/dist/server/migrations/{20260427000000-change-packages-to-text.js → 20260427000002-change-packages-to-text.js} +2 -0
  33. package/dist/server/migrations/20260429000000-add-llm-fields.js +3 -2
  34. package/dist/server/migrations/{20260429000000-fix-inputargs-json-to-text.js → 20260429000001-fix-inputargs-json-to-text.js} +14 -6
  35. package/dist/server/migrations/20260503000000-add-orchestrator-trace-fields.js +2 -1
  36. package/dist/server/migrations/20260524000000-add-agent-loop-fields-to-skill-executions.js +2 -1
  37. package/dist/server/migrations/20260803010000-backfill-loop-control-plane-data.js +262 -0
  38. package/dist/server/plugin.js +52 -150
  39. package/dist/server/resources/agent-loop-approval.js +83 -0
  40. package/dist/server/resources/agent-loop-artifact.js +86 -0
  41. package/dist/server/resources/agent-loop-events-stream.js +130 -0
  42. package/dist/server/resources/agent-loop.js +181 -139
  43. package/dist/server/resources/resource-helpers.js +63 -0
  44. package/dist/server/resources/tracing.js +121 -107
  45. package/dist/server/services/DurableCircuitBreakerService.js +229 -0
  46. package/dist/server/services/HarnessCompiler.js +142 -0
  47. package/dist/server/services/HarnessProfileService.js +168 -0
  48. package/dist/server/services/HarnessSchema.js +167 -0
  49. package/dist/server/services/LoopBudgetService.js +269 -0
  50. package/dist/server/services/LoopControlService.js +139 -0
  51. package/dist/server/services/LoopPatternSchema.js +180 -0
  52. package/dist/server/services/LoopPatternService.js +132 -0
  53. package/dist/server/services/LoopRunRepository.js +205 -0
  54. package/dist/server/services/LoopRunStateMachine.js +389 -0
  55. package/dist/server/services/LoopSchedulerService.js +193 -0
  56. package/dist/server/services/LoopTriggerService.js +128 -0
  57. package/dist/server/services/LoopWorkerService.js +461 -0
  58. package/dist/server/services/PathLockService.js +288 -0
  59. package/dist/server/services/PluginAiRuntimeAdapter.js +215 -0
  60. package/dist/server/services/VerificationSchema.js +59 -0
  61. package/dist/server/services/VerificationService.js +169 -0
  62. package/dist/server/skill-hub/actions/git-import.js +13 -7
  63. package/dist/server/skill-hub/services/RegistrySkillSnapshotService.js +1 -5
  64. package/dist/server/utils/ensure-indexes.js +111 -0
  65. package/dist/server/utils/loop-pattern-context.js +56 -0
  66. package/package.json +1 -1
  67. package/src/client/OrchestratorSettings.tsx +44 -0
  68. package/src/client-v2/components/AgentRunsTab.tsx +576 -494
  69. package/src/client-v2/components/HarnessProfilesTab.tsx +13 -8
  70. package/src/client-v2/components/MemoryInspectorTab.tsx +19 -3
  71. package/src/client-v2/components/TracingTab.tsx +515 -432
  72. package/src/client-v2/hooks/useApiRequest.ts +141 -121
  73. package/src/client-v2/skill-hub/components/SkillMetrics.tsx +8 -6
  74. package/src/locale/en-US.json +52 -28
  75. package/src/locale/vi-VN.json +52 -28
  76. package/src/locale/zh-CN.json +52 -28
  77. package/src/server/__tests__/circuit-breaker.test.ts +225 -146
  78. package/src/server/__tests__/harness-compiler.test.ts +131 -0
  79. package/src/server/__tests__/harness-profile-service.test.ts +116 -0
  80. package/src/server/__tests__/harness-tool-plan.test.ts +148 -0
  81. package/src/server/__tests__/loop-budget-service.test.ts +255 -0
  82. package/src/server/__tests__/loop-control-plane-backfill.test.ts +266 -0
  83. package/src/server/__tests__/loop-pattern-schema.test.ts +56 -0
  84. package/src/server/__tests__/loop-pattern-service.test.ts +148 -0
  85. package/src/server/__tests__/loop-run-state-machine.test.ts +90 -0
  86. package/src/server/__tests__/loop-worker-claim.test.ts +341 -0
  87. package/src/server/__tests__/loop-worker-execution.test.ts +236 -0
  88. package/src/server/__tests__/path-lock-service.test.ts +254 -0
  89. package/src/server/__tests__/smoke.test.ts +62 -21
  90. package/src/server/collections/agent-execution-spans.ts +47 -0
  91. package/src/server/collections/agent-harness-profile-versions.ts +26 -0
  92. package/src/server/collections/agent-harness-profiles.ts +12 -0
  93. package/src/server/collections/agent-loop-action-approvals.ts +38 -0
  94. package/src/server/collections/agent-loop-artifacts.ts +25 -0
  95. package/src/server/collections/agent-loop-circuit-states.ts +23 -0
  96. package/src/server/collections/agent-loop-control-settings.ts +21 -0
  97. package/src/server/collections/agent-loop-events.ts +27 -0
  98. package/src/server/collections/agent-loop-path-locks.ts +27 -0
  99. package/src/server/collections/agent-loop-patterns.ts +42 -0
  100. package/src/server/collections/agent-loop-runs.ts +163 -2
  101. package/src/server/collections/agent-loop-steps.ts +69 -0
  102. package/src/server/collections/agent-loop-usage-buckets.ts +22 -0
  103. package/src/server/collections/agent-loop-worktrees.ts +25 -0
  104. package/src/server/migrations/{20260427000000-change-packages-to-text.ts → 20260427000002-change-packages-to-text.ts} +3 -0
  105. package/src/server/migrations/20260429000000-add-llm-fields.ts +3 -2
  106. package/src/server/migrations/{20260429000000-fix-inputargs-json-to-text.ts → 20260429000001-fix-inputargs-json-to-text.ts} +13 -6
  107. package/src/server/migrations/20260503000000-add-orchestrator-trace-fields.ts +2 -1
  108. package/src/server/migrations/20260524000000-add-agent-loop-fields-to-skill-executions.ts +2 -1
  109. package/src/server/migrations/20260803010000-backfill-loop-control-plane-data.ts +293 -0
  110. package/src/server/plugin.ts +53 -167
  111. package/src/server/resources/agent-loop-approval.ts +52 -0
  112. package/src/server/resources/agent-loop-artifact.ts +56 -0
  113. package/src/server/resources/agent-loop-events-stream.ts +105 -0
  114. package/src/server/resources/agent-loop.ts +202 -143
  115. package/src/server/resources/agent-monitor.ts +482 -482
  116. package/src/server/resources/resource-helpers.ts +33 -0
  117. package/src/server/resources/tracing.ts +145 -137
  118. package/src/server/services/DurableCircuitBreakerService.ts +239 -0
  119. package/src/server/services/HarnessCompiler.ts +133 -0
  120. package/src/server/services/HarnessProfileService.ts +157 -0
  121. package/src/server/services/HarnessSchema.ts +163 -0
  122. package/src/server/services/LoopBudgetService.ts +275 -0
  123. package/src/server/services/LoopControlService.ts +124 -0
  124. package/src/server/services/LoopPatternSchema.ts +167 -0
  125. package/src/server/services/LoopPatternService.ts +143 -0
  126. package/src/server/services/LoopRunRepository.ts +237 -0
  127. package/src/server/services/LoopRunStateMachine.ts +432 -0
  128. package/src/server/services/LoopSchedulerService.ts +199 -0
  129. package/src/server/services/LoopTriggerService.ts +115 -0
  130. package/src/server/services/LoopWorkerService.ts +522 -0
  131. package/src/server/services/PathLockService.ts +321 -0
  132. package/src/server/services/PluginAiRuntimeAdapter.ts +315 -0
  133. package/src/server/services/VerificationSchema.ts +31 -0
  134. package/src/server/services/VerificationService.ts +185 -0
  135. package/src/server/skill-hub/actions/__tests__/git-import.test.ts +15 -1
  136. package/src/server/skill-hub/actions/git-import.ts +9 -3
  137. package/src/server/skill-hub/services/RegistrySkillSnapshotService.ts +1 -5
  138. package/src/server/skill-hub/services/__tests__/RegistrySkillSnapshotService.test.ts +1 -3
  139. package/src/server/utils/ensure-indexes.ts +96 -0
  140. package/src/server/utils/logging.ts +0 -1
  141. package/src/server/utils/loop-pattern-context.ts +20 -0
  142. package/dist/client-v2/214.79650a549273f163.js +0 -10
  143. package/dist/client-v2/253.9f0537713cee9e6c.js +0 -10
  144. package/dist/client-v2/264.718a107e43fc163c.js +0 -10
  145. package/dist/client-v2/418.ce8f5b2b8a229d1d.js +0 -10
  146. package/dist/client-v2/619.bd3c5698b40705c3.js +0 -10
  147. package/dist/client-v2/925.f5370de8f6632d65.js +0 -10
  148. package/dist/server/services/AgentHarness.js +0 -81
  149. package/dist/server/services/AgentLoopController.js +0 -1023
  150. package/dist/server/services/AgentLoopRepository.js +0 -192
  151. package/dist/server/services/AgentLoopService.js +0 -142
  152. package/dist/server/services/AgentPlanValidator.js +0 -99
  153. package/dist/server/services/AgentPlannerService.js +0 -99
  154. package/dist/server/services/CircuitBreaker.js +0 -125
  155. package/dist/server/services/ContextAggregator.js +0 -201
  156. package/dist/server/services/PlanningPromptService.js +0 -95
  157. package/dist/server/tools/agent-loop.js +0 -373
  158. package/dist/server/tools/orchestrator-plan.js +0 -254
  159. package/src/server/__tests__/agent-loop-controller.test.ts +0 -375
  160. package/src/server/__tests__/context-aggregator.test.ts +0 -222
  161. package/src/server/__tests__/parallel-execution.test.ts +0 -318
  162. package/src/server/__tests__/planning-prompt-service.test.ts +0 -23
  163. package/src/server/services/AgentHarness.ts +0 -67
  164. package/src/server/services/AgentLoopController.ts +0 -1263
  165. package/src/server/services/AgentLoopRepository.ts +0 -178
  166. package/src/server/services/AgentLoopService.ts +0 -177
  167. package/src/server/services/AgentPlanValidator.ts +0 -73
  168. package/src/server/services/AgentPlannerService.ts +0 -80
  169. package/src/server/services/CircuitBreaker.ts +0 -126
  170. package/src/server/services/ContextAggregator.ts +0 -239
  171. package/src/server/services/PlanningPromptService.ts +0 -72
  172. package/src/server/tools/agent-loop.ts +0 -360
  173. package/src/server/tools/orchestrator-plan.ts +0 -255
@@ -0,0 +1,143 @@
1
+ import type { Database, Model } from '@nocobase/database';
2
+ import { compileHarness } from './HarnessCompiler';
3
+ import type { CompiledHarness, HarnessLayer } from './HarnessCompiler';
4
+ import { HarnessProfileService } from './HarnessProfileService';
5
+ import { parseLoopPattern } from './LoopPatternSchema';
6
+ import type { LoopPattern } from './LoopPatternSchema';
7
+
8
+ export type WorktreeCapability = {
9
+ available: boolean;
10
+ provider?: string;
11
+ };
12
+
13
+ export type EmployeeHarnessResolver = (username: string) => Promise<unknown>;
14
+
15
+ export type HarnessSnapshot = {
16
+ tag: string;
17
+ versionId: number;
18
+ version: number;
19
+ schemaVersion: number;
20
+ effective: CompiledHarness;
21
+ };
22
+
23
+ export type CompiledPatternSnapshot = {
24
+ pattern: LoopPattern;
25
+ roleBindings: {
26
+ leader: string;
27
+ makers: string[];
28
+ verifier: string;
29
+ };
30
+ leaderHarness: HarnessSnapshot;
31
+ makerHarnesses: Record<string, HarnessSnapshot>;
32
+ verifierHarness: HarnessSnapshot;
33
+ policy: LoopPattern['policy'];
34
+ };
35
+
36
+ const platformHarness = {
37
+ tools: {},
38
+ memory: { maxChars: 20_000 },
39
+ delegation: { maxDepth: 8, maxCount: 100 },
40
+ limits: { timeoutMs: 3_600_000, recursionLimit: 100, maxTotalTokens: 1_000_000, maxCost: 1000 },
41
+ isolation: { networkAccess: 'allow' },
42
+ observability: { tracingRetentionDays: 3650 },
43
+ };
44
+
45
+ function read(record: Model | Record<string, unknown>, key: string) {
46
+ const model = record as Model & { get?: (name: string) => unknown };
47
+ return typeof model.get === 'function' ? model.get(key) : (record as Record<string, unknown>)[key];
48
+ }
49
+
50
+ function toPlain(record: Model | Record<string, unknown>) {
51
+ return typeof (record as Model).toJSON === 'function'
52
+ ? ((record as Model).toJSON() as Record<string, unknown>)
53
+ : (record as Record<string, unknown>);
54
+ }
55
+
56
+ export class LoopPatternService {
57
+ private readonly harnessProfiles: HarnessProfileService;
58
+
59
+ constructor(
60
+ private readonly database: Database,
61
+ private readonly resolveEmployeeHarness: EmployeeHarnessResolver,
62
+ private readonly worktreeCapability: () => Promise<WorktreeCapability>,
63
+ ) {
64
+ this.harnessProfiles = new HarnessProfileService(database);
65
+ }
66
+
67
+ async get(patternId: number) {
68
+ const record = await this.database.getRepository('agentLoopPatterns').findOne({ filterByTk: patternId });
69
+ if (!record) throw new Error(`Loop pattern ${patternId} was not found.`);
70
+ return { id: Number(read(record, 'id')), pattern: parseLoopPattern(toPlain(record)) };
71
+ }
72
+
73
+ async validate(value: unknown) {
74
+ const pattern = parseLoopPattern(value);
75
+ await this.assertCapabilities(pattern);
76
+ return pattern;
77
+ }
78
+
79
+ async compile(patternId: number, perRunHarness?: unknown): Promise<CompiledPatternSnapshot> {
80
+ const { pattern } = await this.get(patternId);
81
+ if (!pattern.enabled) throw new Error(`Loop pattern ${pattern.key} is disabled.`);
82
+ await this.assertCapabilities(pattern);
83
+
84
+ const makerUsernames = pattern.makerUsernames.length ? pattern.makerUsernames : [pattern.leaderUsername];
85
+ const [leaderHarness, verifierHarness, ...makerSnapshots] = await Promise.all([
86
+ this.compileRole(pattern.leaderHarnessTag, pattern.leaderUsername, pattern.policy.harness, perRunHarness),
87
+ this.compileRole(pattern.verifierHarnessTag, pattern.verifierUsername, pattern.policy.harness, perRunHarness),
88
+ // Every maker gets its own snapshot: employee-level harness overrides differ per username,
89
+ // so reusing the first maker's compilation would grant or deny the wrong tools.
90
+ ...makerUsernames.map((username) =>
91
+ this.compileRole(pattern.makerHarnessTag, username, pattern.policy.harness, perRunHarness),
92
+ ),
93
+ ]);
94
+ const makerHarnesses = Object.fromEntries(
95
+ makerUsernames.map((username, index) => [username, makerSnapshots[index]]),
96
+ );
97
+
98
+ return {
99
+ pattern,
100
+ roleBindings: {
101
+ leader: pattern.leaderUsername,
102
+ // The effective list, not the raw pattern array. A pattern with no makers falls back to the
103
+ // leader (line above), and `makerHarnesses` is keyed by that same list; returning the raw
104
+ // empty array here would make the worker iterate zero makers while the harness map holds one,
105
+ // so the execution phase would silently never run.
106
+ makers: [...makerUsernames],
107
+ verifier: pattern.verifierUsername,
108
+ },
109
+ leaderHarness,
110
+ makerHarnesses,
111
+ verifierHarness,
112
+ policy: structuredClone(pattern.policy),
113
+ };
114
+ }
115
+
116
+ private async compileRole(tag: string, username: string, patternHarness: unknown, perRunHarness?: unknown) {
117
+ const published = await this.harnessProfiles.getPublishedByTag(tag);
118
+ if (!published) throw new Error(`Harness profile "${tag}" has no published version.`);
119
+ const employeeHarness = await this.resolveEmployeeHarness(username);
120
+ const layers: HarnessLayer[] = [
121
+ { source: 'platform', settings: platformHarness },
122
+ { source: `profile:${tag}@${published.version}`, settings: published.settings },
123
+ { source: 'pattern', settings: patternHarness },
124
+ ];
125
+ if (employeeHarness) layers.push({ source: `employee:${username}`, settings: employeeHarness });
126
+ if (perRunHarness) layers.push({ source: 'run', settings: perRunHarness });
127
+ return {
128
+ tag,
129
+ versionId: published.id,
130
+ version: published.version,
131
+ schemaVersion: published.schemaVersion,
132
+ effective: compileHarness(layers),
133
+ };
134
+ }
135
+
136
+ private async assertCapabilities(pattern: LoopPattern) {
137
+ if (pattern.autonomyLevel === 'L1') return;
138
+ const capability = await this.worktreeCapability();
139
+ if (!capability.available) {
140
+ throw new Error('L2 and L3 patterns require an available worktree provider.');
141
+ }
142
+ }
143
+ }
@@ -0,0 +1,237 @@
1
+ import type { Database, Model } from '@nocobase/database';
2
+
3
+ export type LoopRunRecord = Record<string, unknown>;
4
+
5
+ export class LoopRunAccessError extends Error {
6
+ constructor(
7
+ public readonly status: 401 | 403 | 404 | 409,
8
+ message: string,
9
+ ) {
10
+ super(message);
11
+ this.name = 'LoopRunAccessError';
12
+ }
13
+ }
14
+
15
+ function read(record: Model | LoopRunRecord, key: string) {
16
+ const model = record as Model & { get?: (name: string) => unknown };
17
+ return typeof model.get === 'function' ? model.get(key) : (record as LoopRunRecord)[key];
18
+ }
19
+
20
+ function plain(record: Model | LoopRunRecord): LoopRunRecord {
21
+ return typeof (record as Model).toJSON === 'function'
22
+ ? ((record as Model).toJSON() as LoopRunRecord)
23
+ : structuredClone(record as LoopRunRecord);
24
+ }
25
+
26
+ function positiveId(value: unknown, label: string) {
27
+ const parsed = typeof value === 'number' ? value : Number(value);
28
+ if (!Number.isSafeInteger(parsed) || parsed <= 0) {
29
+ throw new LoopRunAccessError(404, `${label} was not found.`);
30
+ }
31
+ return parsed;
32
+ }
33
+
34
+ function requireUserId(userId: number | undefined) {
35
+ if (!Number.isSafeInteger(userId) || Number(userId) <= 0) {
36
+ throw new LoopRunAccessError(401, 'Authentication is required.');
37
+ }
38
+ return Number(userId);
39
+ }
40
+
41
+ function mergeFilter(filter: Record<string, unknown>, required: Record<string, unknown>) {
42
+ return Object.keys(filter).length > 0 ? { $and: [filter, required] } : required;
43
+ }
44
+
45
+ export class LoopRunRepository {
46
+ constructor(private readonly database: Database) {}
47
+
48
+ async requireRun(runId: string | number) {
49
+ const id = positiveId(runId, 'Agent loop run');
50
+ const record = await this.database.getRepository('agentLoopRuns').findOne({ filterByTk: id });
51
+ if (!record) throw new LoopRunAccessError(404, `Agent loop run ${id} was not found.`);
52
+ return plain(record);
53
+ }
54
+
55
+ async requireOwnedRun(runId: string | number, userId: number | undefined, isAdmin: boolean) {
56
+ const authenticatedUserId = requireUserId(userId);
57
+ const run = await this.requireRun(runId);
58
+ if (!isAdmin && Number(run.userId) !== authenticatedUserId) {
59
+ throw new LoopRunAccessError(403, 'You cannot access this agent loop run.');
60
+ }
61
+ return run;
62
+ }
63
+
64
+ async requireMutableV2Run(runId: string | number, userId: number | undefined, isAdmin: boolean) {
65
+ const run = await this.requireOwnedRun(runId, userId, isAdmin);
66
+ if (run.runtimeVersion !== 'control-plane-v2') {
67
+ throw new LoopRunAccessError(409, 'Historical plan-era runs are read-only.');
68
+ }
69
+ return run;
70
+ }
71
+
72
+ async listOwnedRuns(input: {
73
+ userId: number | undefined;
74
+ isAdmin: boolean;
75
+ filter?: Record<string, unknown>;
76
+ sort?: string[];
77
+ page?: number;
78
+ pageSize?: number;
79
+ }) {
80
+ const userId = requireUserId(input.userId);
81
+ const page = Number.isSafeInteger(input.page) && Number(input.page) > 0 ? Number(input.page) : 1;
82
+ const pageSize =
83
+ Number.isSafeInteger(input.pageSize) && Number(input.pageSize) > 0 ? Math.min(Number(input.pageSize), 100) : 20;
84
+ const requestedFilter = input.filter || {};
85
+ const filter = input.isAdmin ? requestedFilter : mergeFilter(requestedFilter, { userId });
86
+ const [rows, count] = await this.database.getRepository('agentLoopRuns').findAndCount({
87
+ filter,
88
+ sort: input.sort || ['-createdAt'],
89
+ offset: (page - 1) * pageSize,
90
+ limit: pageSize,
91
+ });
92
+ return {
93
+ rows: rows.map(plain),
94
+ count,
95
+ page,
96
+ pageSize,
97
+ totalPage: Math.ceil(count / pageSize),
98
+ };
99
+ }
100
+
101
+ async listOwnedRunIds(userId: number | undefined, isAdmin: boolean) {
102
+ const authenticatedUserId = requireUserId(userId);
103
+ const repository = this.database.getRepository('agentLoopRuns');
104
+ const filter = isAdmin ? {} : { userId: authenticatedUserId };
105
+ const pageSize = 5_000;
106
+ const ids: number[] = [];
107
+ for (let page = 1; ; page += 1) {
108
+ const rows = await repository.find({ filter, fields: ['id'], sort: ['id'], page, pageSize });
109
+ for (const row of rows) {
110
+ ids.push(positiveId(read(row, 'id'), 'Agent loop run'));
111
+ }
112
+ if (rows.length < pageSize) break;
113
+ }
114
+ return ids;
115
+ }
116
+
117
+ async getOwnedRunDetail(runId: string | number, userId: number | undefined, isAdmin: boolean) {
118
+ const run = await this.requireOwnedRun(runId, userId, isAdmin);
119
+ const id = positiveId(run.id, 'Agent loop run');
120
+ const rootRunId = typeof run.rootRunId === 'string' ? run.rootRunId : '';
121
+ const [steps, events, spans, artifacts, approvals, skillExecutions] = await Promise.all([
122
+ this.database.getRepository('agentLoopSteps').find({ filter: { runId: id }, sort: ['index', 'createdAt'] }),
123
+ this.database.getRepository('agentLoopEvents').find({ filter: { runId: id }, sort: ['id'], pageSize: 1000 }),
124
+ this.database
125
+ .getRepository('agentExecutionSpans')
126
+ .find({ filter: { agentLoopRunId: id }, sort: ['createdAt'], pageSize: 1000 }),
127
+ this.database.getRepository('agentLoopArtifacts').find({ filter: { runId: id }, sort: ['createdAt'] }),
128
+ this.database.getRepository('agentLoopActionApprovals').find({ filter: { runId: id }, sort: ['createdAt'] }),
129
+ this.database.getRepository('skillExecutions')
130
+ ? this.database
131
+ .getRepository('skillExecutions')
132
+ .find({ filter: { agentLoopRunId: String(id) }, sort: ['createdAt'], pageSize: 1000 })
133
+ : [],
134
+ ]);
135
+ return {
136
+ run: {
137
+ ...run,
138
+ historical: run.runtimeVersion !== 'control-plane-v2',
139
+ readOnly: run.runtimeVersion !== 'control-plane-v2',
140
+ },
141
+ steps: steps.map(plain),
142
+ events: events.map(plain),
143
+ spans: spans.map(plain),
144
+ artifacts: artifacts.map(plain),
145
+ approvals: approvals.map(plain),
146
+ skillExecutions: skillExecutions.map(plain),
147
+ rootRunId,
148
+ };
149
+ }
150
+
151
+ async listApprovals(input: {
152
+ userId: number | undefined;
153
+ isAdmin: boolean;
154
+ filter?: Record<string, unknown>;
155
+ sort?: string[];
156
+ page?: number;
157
+ pageSize?: number;
158
+ }) {
159
+ const userId = requireUserId(input.userId);
160
+ // Scope via the run association so ownership holds for any number of runs
161
+ // (a materialized id list would silently truncate for prolific users).
162
+ const accessible = input.isAdmin
163
+ ? {}
164
+ : {
165
+ $or: [{ assignedToId: userId }, { 'run.userId': userId }],
166
+ };
167
+ return this.findAndCount('agentLoopActionApprovals', input, accessible);
168
+ }
169
+
170
+ async requireAccessibleApproval(approvalId: string | number, userId: number | undefined, isAdmin: boolean) {
171
+ const authenticatedUserId = requireUserId(userId);
172
+ const id = positiveId(approvalId, 'Agent loop approval');
173
+ const record = await this.database.getRepository('agentLoopActionApprovals').findOne({ filterByTk: id });
174
+ if (!record) throw new LoopRunAccessError(404, `Agent loop approval ${id} was not found.`);
175
+ const approval = plain(record);
176
+ const run = await this.requireRun(positiveId(approval.runId, 'Agent loop run'));
177
+ if (
178
+ !isAdmin &&
179
+ Number(run.userId) !== authenticatedUserId &&
180
+ Number(approval.assignedToId) !== authenticatedUserId
181
+ ) {
182
+ throw new LoopRunAccessError(403, 'You cannot access this agent loop approval.');
183
+ }
184
+ return approval;
185
+ }
186
+
187
+ async listArtifacts(input: {
188
+ userId: number | undefined;
189
+ isAdmin: boolean;
190
+ filter?: Record<string, unknown>;
191
+ sort?: string[];
192
+ page?: number;
193
+ pageSize?: number;
194
+ }) {
195
+ const userId = requireUserId(input.userId);
196
+ const accessible = input.isAdmin ? {} : { 'run.userId': userId };
197
+ return this.findAndCount('agentLoopArtifacts', input, accessible);
198
+ }
199
+
200
+ async requireOwnedArtifact(artifactId: string | number, userId: number | undefined, isAdmin: boolean) {
201
+ const id = positiveId(artifactId, 'Agent loop artifact');
202
+ const record = await this.database.getRepository('agentLoopArtifacts').findOne({ filterByTk: id });
203
+ if (!record) throw new LoopRunAccessError(404, `Agent loop artifact ${id} was not found.`);
204
+ const artifact = plain(record);
205
+ await this.requireOwnedRun(positiveId(artifact.runId, 'Agent loop run'), userId, isAdmin);
206
+ return artifact;
207
+ }
208
+
209
+ private async findAndCount(
210
+ collection: string,
211
+ input: {
212
+ filter?: Record<string, unknown>;
213
+ sort?: string[];
214
+ page?: number;
215
+ pageSize?: number;
216
+ },
217
+ accessible: Record<string, unknown>,
218
+ ) {
219
+ const page = Number.isSafeInteger(input.page) && Number(input.page) > 0 ? Number(input.page) : 1;
220
+ const pageSize =
221
+ Number.isSafeInteger(input.pageSize) && Number(input.pageSize) > 0 ? Math.min(Number(input.pageSize), 100) : 20;
222
+ const filter = mergeFilter(input.filter || {}, accessible);
223
+ const [rows, count] = await this.database.getRepository(collection).findAndCount({
224
+ filter,
225
+ sort: input.sort || ['-createdAt'],
226
+ offset: (page - 1) * pageSize,
227
+ limit: pageSize,
228
+ });
229
+ return {
230
+ rows: rows.map(plain),
231
+ count,
232
+ page,
233
+ pageSize,
234
+ totalPage: Math.ceil(count / pageSize),
235
+ };
236
+ }
237
+ }