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,266 @@
1
+ import { describe, expect, it } from 'vitest';
2
+ import { backfillLoopControlPlaneData } from '../migrations/20260803010000-backfill-loop-control-plane-data';
3
+
4
+ type Row = Record<string, unknown>;
5
+
6
+ function matches(row: Row, filter: Row) {
7
+ return Object.entries(filter).every(([key, value]) => row[key] === value);
8
+ }
9
+
10
+ class MemoryRepository {
11
+ private nextId: number;
12
+
13
+ constructor(readonly rows: Row[] = []) {
14
+ this.nextId = rows.reduce((maximum, row) => Math.max(maximum, Number(row.id) || 0), 0) + 1;
15
+ }
16
+
17
+ async find(options: Row = {}) {
18
+ const filter = (options.filter as Row | undefined) || {};
19
+ return this.rows.filter((row) => matches(row, filter));
20
+ }
21
+
22
+ async findOne(options: Row) {
23
+ const filter = (options.filter as Row | undefined) || {};
24
+ return this.rows.find((row) => matches(row, filter)) || null;
25
+ }
26
+
27
+ async create(options: Row) {
28
+ const values = { ...((options.values as Row | undefined) || {}) };
29
+ const row = { id: this.nextId++, ...values };
30
+ this.rows.push(row);
31
+ return row;
32
+ }
33
+
34
+ async update(options: Row) {
35
+ const filterByTk = options.filterByTk;
36
+ const filter = (options.filter as Row | undefined) || null;
37
+ const values = (options.values as Row | undefined) || {};
38
+ for (const row of this.rows) {
39
+ if ((filterByTk !== undefined && row.id === filterByTk) || (filter && matches(row, filter))) {
40
+ Object.assign(row, values);
41
+ }
42
+ }
43
+ }
44
+ }
45
+
46
+ function createDatabase() {
47
+ const repositories = new Map<string, MemoryRepository>([
48
+ [
49
+ 'agentHarnessProfiles',
50
+ new MemoryRepository([
51
+ { id: 1, tag: 'default', schemaVersion: 1, settings: { tools: { deny: ['shell'] } } },
52
+ { id: 2, tag: 'draft-only', schemaVersion: 1, settings: { tools: { allow: ['read_file'] } } },
53
+ {
54
+ id: 3,
55
+ tag: 'published-current',
56
+ schemaVersion: 1,
57
+ currentVersionId: 30,
58
+ settings: { tools: { deny: ['legacy'] } },
59
+ },
60
+ ]),
61
+ ],
62
+ [
63
+ 'agentHarnessProfileVersions',
64
+ new MemoryRepository([
65
+ { id: 20, profileId: 2, version: 1, status: 'draft', settings: { tools: { allow: ['read_file'] } } },
66
+ { id: 30, profileId: 3, version: 4, status: 'published', settings: { tools: { deny: ['published'] } } },
67
+ ]),
68
+ ],
69
+ [
70
+ 'agentLoopRuns',
71
+ new MemoryRepository([
72
+ { id: 10, status: 'running', metadata: { source: 'legacy' }, lockedBy: 'worker-1' },
73
+ { id: 11, status: 'succeeded', metadata: {} },
74
+ {
75
+ id: 12,
76
+ rootRunId: 'loop-v2',
77
+ runtimeVersion: 'control-plane-v2',
78
+ recordMode: 'observed-execution',
79
+ patternId: 7,
80
+ status: 'queued',
81
+ policySnapshot: { maxConcurrency: 1 },
82
+ metadata: { source: 'control-plane' },
83
+ },
84
+ {
85
+ id: 13,
86
+ runtimeVersion: 'control-plane-v2',
87
+ recordMode: 'observed-execution',
88
+ status: 'planning',
89
+ patternId: 7,
90
+ policySnapshot: { maxConcurrency: 1 },
91
+ planSource: 'legacy-planner',
92
+ },
93
+ {
94
+ id: 14,
95
+ runtimeVersion: 'control-plane-v2',
96
+ recordMode: 'observed-execution',
97
+ status: 'queued',
98
+ patternId: 7,
99
+ policySnapshot: { malformed: true },
100
+ },
101
+ {
102
+ id: 15,
103
+ runtimeVersion: 'legacy-plan-v1',
104
+ recordMode: 'legacy-plan',
105
+ status: 'blocked',
106
+ metadata: { legacyStatus: 'running', legacyRuntimeRetired: true },
107
+ },
108
+ ]),
109
+ ],
110
+ [
111
+ 'agentLoopSteps',
112
+ new MemoryRepository([
113
+ { id: 20, runId: 10, status: 'running' },
114
+ { id: 21, runId: 11, status: 'succeeded' },
115
+ { id: 22, runId: 12, status: 'pending', runtimeVersion: 'control-plane-v2' },
116
+ ]),
117
+ ],
118
+ ['agentLoopEvents', new MemoryRepository()],
119
+ [
120
+ 'agentExecutionSpans',
121
+ new MemoryRepository([
122
+ { id: 30, metadata: { agentLoopRunId: '10' } },
123
+ { id: 31, agentLoopRunId: 11, metadata: { agentLoopRunId: 10 } },
124
+ ]),
125
+ ],
126
+ ['agentLoopControlSettings', new MemoryRepository()],
127
+ ]);
128
+
129
+ const database = {
130
+ getRepository(name: string) {
131
+ return repositories.get(name);
132
+ },
133
+ sequelize: {
134
+ async transaction<T>(callback: (transaction: unknown) => Promise<T>) {
135
+ return callback({});
136
+ },
137
+ },
138
+ };
139
+
140
+ return { database, repositories };
141
+ }
142
+
143
+ describe('Loop Control Plane data backfill', () => {
144
+ it('publishes legacy harness settings and converts plan-era records safely', async () => {
145
+ const { database, repositories } = createDatabase();
146
+
147
+ await backfillLoopControlPlaneData(database);
148
+
149
+ const profiles = repositories.get('agentHarnessProfiles')?.rows || [];
150
+ const versions = repositories.get('agentHarnessProfileVersions')?.rows || [];
151
+ expect(versions).toHaveLength(4);
152
+ expect(versions).toContainEqual(
153
+ expect.objectContaining({
154
+ profileId: 1,
155
+ version: 1,
156
+ status: 'published',
157
+ }),
158
+ );
159
+ expect(versions.find((version) => version.profileId === 1)?.settings).toMatchObject({
160
+ tools: { deny: ['shell'] },
161
+ });
162
+ expect(versions).toContainEqual(
163
+ expect.objectContaining({
164
+ profileId: 2,
165
+ version: 2,
166
+ status: 'published',
167
+ }),
168
+ );
169
+ expect(versions.find((version) => version.profileId === 2)?.settings).toMatchObject({
170
+ tools: { allow: ['read_file'] },
171
+ });
172
+ expect(profiles.find((profile) => profile.id === 1)?.currentVersionId).toBeGreaterThan(30);
173
+ expect(profiles.find((profile) => profile.id === 2)?.currentVersionId).toBeGreaterThan(30);
174
+ expect(profiles.find((profile) => profile.id === 3)?.currentVersionId).toBe(30);
175
+ expect(versions.find((version) => version.id === 20)?.status).toBe('draft');
176
+
177
+ const runs = repositories.get('agentLoopRuns')?.rows || [];
178
+ expect(runs[0]).toMatchObject({
179
+ runtimeVersion: 'legacy-plan-v1',
180
+ recordMode: 'legacy-plan',
181
+ status: 'blocked',
182
+ lockedBy: null,
183
+ lockedUntil: null,
184
+ metadata: {
185
+ source: 'legacy',
186
+ legacyStatus: 'running',
187
+ legacyRuntimeRetired: true,
188
+ },
189
+ });
190
+ expect(runs[1]).toMatchObject({
191
+ runtimeVersion: 'legacy-plan-v1',
192
+ recordMode: 'legacy-plan',
193
+ status: 'succeeded',
194
+ metadata: {
195
+ legacyStatus: 'succeeded',
196
+ legacyRuntimeRetired: true,
197
+ },
198
+ });
199
+ expect(runs[2]).toMatchObject({
200
+ runtimeVersion: 'control-plane-v2',
201
+ recordMode: 'observed-execution',
202
+ status: 'queued',
203
+ patternId: 7,
204
+ policySnapshot: { maxConcurrency: 1 },
205
+ metadata: { source: 'control-plane' },
206
+ });
207
+ expect(runs[3]).toMatchObject({
208
+ runtimeVersion: 'legacy-plan-v1',
209
+ recordMode: 'legacy-plan',
210
+ status: 'blocked',
211
+ blockedReason: 'The legacy plan runtime was retired. This historical run is read-only.',
212
+ metadata: { legacyStatus: 'planning', legacyRuntimeRetired: true },
213
+ });
214
+ expect(runs[4]).toMatchObject({
215
+ runtimeVersion: 'legacy-plan-v1',
216
+ recordMode: 'legacy-plan',
217
+ status: 'blocked',
218
+ metadata: { legacyStatus: 'queued', legacyRuntimeRetired: true },
219
+ });
220
+ expect(runs[5]).toMatchObject({
221
+ runtimeVersion: 'legacy-plan-v1',
222
+ recordMode: 'legacy-plan',
223
+ status: 'blocked',
224
+ metadata: { legacyStatus: 'running', legacyRuntimeRetired: true },
225
+ });
226
+
227
+ expect(repositories.get('agentLoopSteps')?.rows).toEqual([
228
+ { id: 20, runId: 10, status: 'running', runtimeVersion: 'legacy-plan-v1' },
229
+ { id: 21, runId: 11, status: 'succeeded', runtimeVersion: 'legacy-plan-v1' },
230
+ { id: 22, runId: 12, status: 'pending', runtimeVersion: 'control-plane-v2' },
231
+ ]);
232
+ expect(repositories.get('agentLoopEvents')?.rows).toHaveLength(3);
233
+ expect(repositories.get('agentLoopEvents')?.rows).toEqual(
234
+ expect.arrayContaining([
235
+ expect.objectContaining({ runId: 10, type: 'legacy_runtime_retired', status: 'blocked' }),
236
+ expect.objectContaining({ runId: 13, type: 'legacy_runtime_retired', status: 'blocked' }),
237
+ expect.objectContaining({ runId: 14, type: 'legacy_runtime_retired', status: 'blocked' }),
238
+ ]),
239
+ );
240
+
241
+ expect(repositories.get('agentExecutionSpans')?.rows).toMatchObject([
242
+ { id: 30, agentLoopRunId: 10 },
243
+ { id: 31, agentLoopRunId: 11 },
244
+ ]);
245
+ expect(repositories.get('agentLoopControlSettings')?.rows).toMatchObject([
246
+ { key: 'global', acceptNewRuns: true, state: 'running', globalMaxConcurrency: 5 },
247
+ ]);
248
+ });
249
+
250
+ it('is idempotent for profile versions, retirement events, and global control', async () => {
251
+ const { database, repositories } = createDatabase();
252
+
253
+ await backfillLoopControlPlaneData(database);
254
+ const versionsAfterFirstRun = structuredClone(repositories.get('agentHarnessProfileVersions')?.rows || []);
255
+ const runsAfterFirstRun = structuredClone(repositories.get('agentLoopRuns')?.rows || []);
256
+ const eventsAfterFirstRun = structuredClone(repositories.get('agentLoopEvents')?.rows || []);
257
+ const controlsAfterFirstRun = structuredClone(repositories.get('agentLoopControlSettings')?.rows || []);
258
+
259
+ await backfillLoopControlPlaneData(database);
260
+
261
+ expect(repositories.get('agentHarnessProfileVersions')?.rows).toEqual(versionsAfterFirstRun);
262
+ expect(repositories.get('agentLoopRuns')?.rows).toEqual(runsAfterFirstRun);
263
+ expect(repositories.get('agentLoopEvents')?.rows).toEqual(eventsAfterFirstRun);
264
+ expect(repositories.get('agentLoopControlSettings')?.rows).toEqual(controlsAfterFirstRun);
265
+ });
266
+ });
@@ -0,0 +1,73 @@
1
+ import { describe, expect, it } from 'vitest';
2
+ import { loopPatternPolicySchema, validateLoopPattern } from '../services/LoopPatternSchema';
3
+
4
+ const basePattern = {
5
+ key: 'dependency-audit',
6
+ title: 'Dependency audit',
7
+ goalTemplate: 'Audit dependencies and report risks.',
8
+ autonomyLevel: 'L1',
9
+ triggerType: 'manual',
10
+ leaderUsername: 'leader',
11
+ makerUsernames: ['maker'],
12
+ verifierUsername: 'verifier',
13
+ };
14
+
15
+ describe('LoopPatternSchema', () => {
16
+ it('accepts a manual L1 read-only pattern without repository isolation', () => {
17
+ const result = validateLoopPattern(basePattern);
18
+ expect(result.success).toBe(true);
19
+ });
20
+
21
+ it('requires independent role identities', () => {
22
+ const result = validateLoopPattern({ ...basePattern, verifierUsername: 'maker' });
23
+ expect(result.success).toBe(false);
24
+ if (!result.success) {
25
+ expect(result.error.issues.some((issue) => issue.path.join('.') === 'verifierUsername')).toBe(true);
26
+ }
27
+ });
28
+
29
+ it('requires an explicit valid timezone for cron patterns', () => {
30
+ expect(
31
+ validateLoopPattern({ ...basePattern, triggerType: 'cron', cronExpression: '0 * * * *', timezone: null }).success,
32
+ ).toBe(false);
33
+ expect(
34
+ validateLoopPattern({
35
+ ...basePattern,
36
+ triggerType: 'cron',
37
+ cronExpression: '0 * * * *',
38
+ timezone: 'Asia/Ho_Chi_Minh',
39
+ }).success,
40
+ ).toBe(true);
41
+ });
42
+
43
+ it('requires repository paths and worktree isolation for L2 and L3', () => {
44
+ expect(validateLoopPattern({ ...basePattern, autonomyLevel: 'L2' }).success).toBe(false);
45
+ expect(
46
+ validateLoopPattern({
47
+ ...basePattern,
48
+ autonomyLevel: 'L2',
49
+ repositoryKey: 'main-repository',
50
+ repositoryRoot: 'C:/workspace/repository',
51
+ actingOn: ['packages/plugins/**'],
52
+ policy: { harness: { isolation: { mode: 'worktree', requireWorktree: true } } },
53
+ }).success,
54
+ ).toBe(true);
55
+ });
56
+ });
57
+
58
+ describe('LoopPatternSchema loop detection policy', () => {
59
+ it('defaults the tool loop thresholds', () => {
60
+ const policy = loopPatternPolicySchema.parse({});
61
+ expect(policy.loopDetection).toEqual({ enabled: true, warnAt: 3, blockAt: 5, escalateAt: 8 });
62
+ });
63
+
64
+ it('requires warnAt < blockAt < escalateAt', () => {
65
+ expect(loopPatternPolicySchema.safeParse({ loopDetection: { warnAt: 5, blockAt: 5 } }).success).toBe(false);
66
+ expect(loopPatternPolicySchema.safeParse({ loopDetection: { warnAt: 6, blockAt: 5, escalateAt: 8 } }).success).toBe(
67
+ false,
68
+ );
69
+ expect(loopPatternPolicySchema.safeParse({ loopDetection: { warnAt: 2, blockAt: 4, escalateAt: 6 } }).success).toBe(
70
+ true,
71
+ );
72
+ });
73
+ });
@@ -0,0 +1,148 @@
1
+ import type { Database } from '@nocobase/database';
2
+ import { describe, expect, it } from 'vitest';
3
+ import { LoopPatternService } from '../services/LoopPatternService';
4
+
5
+ type Row = Record<string, unknown>;
6
+
7
+ class MemoryRepository {
8
+ constructor(readonly rows: Row[] = []) {}
9
+
10
+ async find(options: Row = {}) {
11
+ const filter = (options.filter as Row | undefined) || {};
12
+ return this.rows.filter((row) => Object.entries(filter).every(([key, value]) => row[key] === value));
13
+ }
14
+
15
+ async findOne(options: Row) {
16
+ if (options.filterByTk !== undefined) {
17
+ return this.rows.find((row) => String(row.id) === String(options.filterByTk)) || null;
18
+ }
19
+ return (await this.find(options))[0] || null;
20
+ }
21
+ }
22
+
23
+ function pattern(values: Row = {}) {
24
+ return {
25
+ id: 1,
26
+ key: 'nightly-report',
27
+ title: 'Nightly report',
28
+ goalTemplate: 'Summarize yesterday.',
29
+ enabled: true,
30
+ autonomyLevel: 'L1',
31
+ triggerType: 'manual',
32
+ leaderUsername: 'leader',
33
+ makerUsernames: ['maker-a', 'maker-b'],
34
+ verifierUsername: 'verifier',
35
+ leaderHarnessTag: 'default',
36
+ makerHarnessTag: 'default',
37
+ verifierHarnessTag: 'safe',
38
+ ...values,
39
+ };
40
+ }
41
+
42
+ function createService(input: { patterns: Row[]; employeeHarnesses?: Record<string, unknown> }) {
43
+ const repositories = new Map<string, MemoryRepository>([
44
+ ['agentLoopPatterns', new MemoryRepository(input.patterns)],
45
+ [
46
+ 'agentHarnessProfiles',
47
+ new MemoryRepository([
48
+ { id: 1, tag: 'default', enabled: true, currentVersionId: 1 },
49
+ { id: 2, tag: 'safe', enabled: true, currentVersionId: 2 },
50
+ ]),
51
+ ],
52
+ [
53
+ 'agentHarnessProfileVersions',
54
+ new MemoryRepository([
55
+ {
56
+ id: 1,
57
+ profileId: 1,
58
+ version: 3,
59
+ schemaVersion: 1,
60
+ status: 'published',
61
+ settings: { tools: { allow: ['read_file'] } },
62
+ },
63
+ {
64
+ id: 2,
65
+ profileId: 2,
66
+ version: 1,
67
+ schemaVersion: 1,
68
+ status: 'published',
69
+ settings: { tools: { allow: ['read_file'], deny: ['write_file'] } },
70
+ },
71
+ ]),
72
+ ],
73
+ ]);
74
+ const database = {
75
+ getRepository(name: string) {
76
+ const repository = repositories.get(name);
77
+ if (!repository) throw new Error(`Unexpected repository ${name}`);
78
+ return repository;
79
+ },
80
+ };
81
+ const employeeHarnesses = input.employeeHarnesses || {};
82
+ return new LoopPatternService(
83
+ database as unknown as Database,
84
+ async (username: string) => employeeHarnesses[username],
85
+ async () => ({ available: false }),
86
+ );
87
+ }
88
+
89
+ describe('LoopPatternService compilation', () => {
90
+ it('compiles a distinct harness snapshot for every maker', async () => {
91
+ const service = createService({
92
+ patterns: [pattern()],
93
+ employeeHarnesses: {
94
+ // Employee-level overrides differ per username, so reusing the first maker's
95
+ // compilation would grant or deny the wrong tools for the second maker.
96
+ 'maker-b': { tools: { deny: ['read_file'], ask: ['run_tests'] } },
97
+ },
98
+ });
99
+
100
+ const compiled = await service.compile(1);
101
+
102
+ expect(Object.keys(compiled.makerHarnesses)).toEqual(['maker-a', 'maker-b']);
103
+ expect(compiled.makerHarnesses['maker-a'].effective.tools.deny).toEqual([]);
104
+ expect(compiled.makerHarnesses['maker-a'].effective.tools.allow).toContain('read_file');
105
+ expect(compiled.makerHarnesses['maker-b'].effective.tools.deny).toEqual(['read_file']);
106
+ expect(compiled.makerHarnesses['maker-b'].effective.tools.ask).toEqual(['run_tests']);
107
+ expect(compiled.makerHarnesses['maker-a'].effective.sources).not.toContain('employee:maker-b');
108
+ expect(compiled.makerHarnesses['maker-b'].effective.sources).toContain('employee:maker-b');
109
+ expect(compiled.roleBindings).toMatchObject({
110
+ leader: 'leader',
111
+ makers: ['maker-a', 'maker-b'],
112
+ verifier: 'verifier',
113
+ });
114
+ });
115
+
116
+ it('falls back to the leader when a pattern declares no makers', async () => {
117
+ const service = createService({ patterns: [pattern({ makerUsernames: [] })] });
118
+
119
+ const compiled = await service.compile(1);
120
+
121
+ // The worker iterates `roleBindings.makers`, so returning the raw empty array here made it run
122
+ // zero makers while `makerHarnesses` held a leader snapshot: the whole execution phase was
123
+ // skipped and the verifier only ever saw the leader's plan.
124
+ expect(Object.keys(compiled.makerHarnesses)).toEqual(['leader']);
125
+ expect(compiled.roleBindings.makers).toEqual(['leader']);
126
+ });
127
+
128
+ it('refuses to compile a disabled pattern', async () => {
129
+ const service = createService({ patterns: [pattern({ enabled: false })] });
130
+ await expect(service.compile(1)).rejects.toThrow('is disabled');
131
+ });
132
+
133
+ it('blocks L2 patterns when no worktree provider is available', async () => {
134
+ const service = createService({
135
+ patterns: [
136
+ pattern({
137
+ autonomyLevel: 'L2',
138
+ repositoryKey: 'repo',
139
+ repositoryRoot: '/srv/repo',
140
+ actingOn: ['src/**'],
141
+ policy: { harness: { isolation: { mode: 'worktree', requireWorktree: true } } },
142
+ }),
143
+ ],
144
+ });
145
+
146
+ await expect(service.compile(1)).rejects.toThrow('worktree provider');
147
+ });
148
+ });
@@ -0,0 +1,101 @@
1
+ import { describe, expect, it } from 'vitest';
2
+ import { assertRunTransition } from '../services/LoopRunStateMachine';
3
+
4
+ const passingEvidence = {
5
+ verdict: 'pass',
6
+ summary: 'All required checks passed.',
7
+ checks: [{ name: 'tests', status: 'pass', evidenceArtifactIds: [1] }],
8
+ residualRisks: [],
9
+ };
10
+
11
+ describe('LoopRunStateMachine transition guard', () => {
12
+ it('accepts the normal queued-to-verification lifecycle', () => {
13
+ expect(() =>
14
+ assertRunTransition({ from: 'queued', to: 'preparing', runtimeVersion: 'control-plane-v2' }),
15
+ ).not.toThrow();
16
+ expect(() =>
17
+ assertRunTransition({ from: 'preparing', to: 'running', runtimeVersion: 'control-plane-v2' }),
18
+ ).not.toThrow();
19
+ expect(() =>
20
+ assertRunTransition({ from: 'running', to: 'verifying', runtimeVersion: 'control-plane-v2' }),
21
+ ).not.toThrow();
22
+ expect(() =>
23
+ assertRunTransition({
24
+ from: 'verifying',
25
+ to: 'succeeded',
26
+ runtimeVersion: 'control-plane-v2',
27
+ verifierEvidence: passingEvidence,
28
+ }),
29
+ ).not.toThrow();
30
+ });
31
+
32
+ it('rejects illegal transitions and mutations of historical runs', () => {
33
+ expect(() => assertRunTransition({ from: 'queued', to: 'succeeded', verifierEvidence: passingEvidence })).toThrow(
34
+ 'Illegal',
35
+ );
36
+ expect(() => assertRunTransition({ from: 'running', to: 'verifying', runtimeVersion: 'legacy-plan-v1' })).toThrow(
37
+ 'read-only',
38
+ );
39
+ });
40
+
41
+ it('cannot succeed without a structured passing verifier verdict', () => {
42
+ expect(() => assertRunTransition({ from: 'verifying', to: 'succeeded' })).toThrow('verifier verdict');
43
+ expect(() =>
44
+ assertRunTransition({
45
+ from: 'verifying',
46
+ to: 'succeeded',
47
+ verifierEvidence: {
48
+ ...passingEvidence,
49
+ verdict: 'reject',
50
+ checks: [{ name: 'tests', status: 'fail', evidenceArtifactIds: [1] }],
51
+ },
52
+ }),
53
+ ).toThrow('verifier verdict');
54
+ expect(() =>
55
+ assertRunTransition({
56
+ from: 'verifying',
57
+ to: 'succeeded',
58
+ verifierEvidence: { verdict: 'pass', summary: 'Missing checks', checks: [], residualRisks: [] },
59
+ }),
60
+ ).toThrow('verifier verdict');
61
+ });
62
+
63
+ it('accepts a pause from every active execution status', () => {
64
+ // The resource transitions to `paused` before it aborts the run. A missing edge here does not
65
+ // just reject the pause: `abortRunEverywhere()` is never reached, so the in-flight verifier
66
+ // keeps calling tools after the operator pressed Pause.
67
+ for (const from of ['preparing', 'running', 'verifying'] as const) {
68
+ expect(() => assertRunTransition({ from, to: 'paused', runtimeVersion: 'control-plane-v2' })).not.toThrow();
69
+ expect(() => assertRunTransition({ from: 'paused', to: from, runtimeVersion: 'control-plane-v2' })).not.toThrow();
70
+ }
71
+ });
72
+
73
+ it('requires explicit human acceptance after the human review gate', () => {
74
+ expect(() =>
75
+ assertRunTransition({
76
+ from: 'waiting_human',
77
+ to: 'succeeded',
78
+ verifierEvidence: passingEvidence,
79
+ }),
80
+ ).toThrow('Human acceptance');
81
+ expect(() =>
82
+ assertRunTransition({
83
+ from: 'waiting_human',
84
+ to: 'succeeded',
85
+ verifierEvidence: passingEvidence,
86
+ humanAccepted: true,
87
+ }),
88
+ ).not.toThrow();
89
+ });
90
+
91
+ it('allows a behavioral guard to escalate straight from the active statuses', () => {
92
+ // Tool loop detection escalates an in-flight run to a human; routing it through `blocked`
93
+ // first would mislabel the run as mechanically retryable.
94
+ for (const from of ['running', 'verifying'] as const) {
95
+ expect(() =>
96
+ assertRunTransition({ from, to: 'waiting_human', runtimeVersion: 'control-plane-v2' }),
97
+ ).not.toThrow();
98
+ expect(() => assertRunTransition({ from, to: 'blocked', runtimeVersion: 'control-plane-v2' })).not.toThrow();
99
+ }
100
+ });
101
+ });