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,375 +0,0 @@
1
- import { describe, expect, it, vi } from 'vitest';
2
- import { AgentLoopController } from '../services/AgentLoopController';
3
-
4
- // --- Mocks ---
5
- function createMockRepository() {
6
- const runs = new Map<number, any>();
7
- const steps = new Map<number, any>();
8
- const events: any[] = [];
9
- let runIdCounter = 1;
10
- let stepIdCounter = 1;
11
-
12
- return {
13
- _runs: runs,
14
- _steps: steps,
15
- _events: events,
16
-
17
- requireRun: vi.fn(async (id: number) => {
18
- const run = runs.get(Number(id));
19
- if (!run) throw new Error(`Run ${id} not found`);
20
- return { ...run };
21
- }),
22
-
23
- getRun: vi.fn(async (id: number) => {
24
- const run = runs.get(Number(id));
25
- return run ? { ...run } : null;
26
- }),
27
-
28
- createRun: vi.fn(async (values: any) => {
29
- const id = runIdCounter++;
30
- const run = { id, ...values, createdAt: new Date(), updatedAt: new Date() };
31
- runs.set(id, run);
32
- return { ...run };
33
- }),
34
-
35
- updateRun: vi.fn(async (id: number, values: any) => {
36
- const existing = runs.get(Number(id));
37
- if (existing) {
38
- const updated = { ...existing, ...values, updatedAt: new Date() };
39
- runs.set(Number(id), updated);
40
- }
41
- }),
42
-
43
- requireStep: vi.fn(async (id: number) => {
44
- const step = steps.get(Number(id));
45
- if (!step) throw new Error(`Step ${id} not found`);
46
- return { ...step };
47
- }),
48
-
49
- getStep: vi.fn(async (id: number) => {
50
- const step = steps.get(Number(id));
51
- return step ? { ...step } : null;
52
- }),
53
-
54
- createStep: vi.fn(async (values: any) => {
55
- const id = stepIdCounter++;
56
- const step = { id, ...values, createdAt: new Date(), updatedAt: new Date() };
57
- steps.set(id, step);
58
- return { ...step };
59
- }),
60
-
61
- updateStep: vi.fn(async (id: number, values: any) => {
62
- const existing = steps.get(Number(id));
63
- if (existing) {
64
- steps.set(Number(id), { ...existing, ...values, updatedAt: new Date() });
65
- }
66
- }),
67
-
68
- getSteps: vi.fn(async (runId: number) => {
69
- return Array.from(steps.values())
70
- .filter((s) => s.runId === runId)
71
- .map((s) => ({ ...s }))
72
- .sort((a, b) => (a.index || 0) - (b.index || 0));
73
- }),
74
-
75
- createEvent: vi.fn(async (values: any) => {
76
- const event = { id: events.length + 1, ...values, createdAt: new Date() };
77
- events.push(event);
78
- return event;
79
- }),
80
-
81
- getEvents: vi.fn(async () => []),
82
- getLinkedSpans: vi.fn(async () => []),
83
- getLinkedSkillExecutions: vi.fn(async () => []),
84
- lockRun: vi.fn(async () => true),
85
- unlockRun: vi.fn(async () => {}),
86
- };
87
- }
88
-
89
- function createMockServices() {
90
- return {
91
- registryService: {
92
- getHarnessProfile: vi.fn(async () => ({ settings: { allowSubAgents: true, allowToolCalls: true } })),
93
- },
94
- plannerService: {
95
- buildPlan: vi.fn((goal, plan) => plan || [{ title: 'Default step', type: 'skill' }]),
96
- },
97
- validator: {
98
- validate: vi.fn(),
99
- },
100
- repository: createMockRepository(),
101
- harness: {
102
- executeStep: vi.fn(async (_run: any, step: any) => ({
103
- summary: `Executed ${step.title}`,
104
- })),
105
- },
106
- tokenTracker: {
107
- checkBudget: vi.fn(async () => ({ allowed: true })),
108
- },
109
- };
110
- }
111
-
112
- function createController(mocks = createMockServices()) {
113
- const controller = new AgentLoopController(
114
- mocks.registryService as any,
115
- mocks.plannerService as any,
116
- mocks.validator as any,
117
- mocks.repository as any,
118
- mocks.harness as any,
119
- mocks.tokenTracker as any,
120
- );
121
- return { controller, mocks };
122
- }
123
-
124
- describe('AgentLoopController', () => {
125
- describe('pickNextSteps', () => {
126
- it('returns empty array for empty steps', () => {
127
- const { controller } = createController();
128
- expect(controller.pickNextSteps([])).toEqual([]);
129
- });
130
-
131
- it('returns pending steps with no dependencies', () => {
132
- const { controller } = createController();
133
- const steps = [
134
- { id: 1, planKey: 'step_1', status: 'pending', dependsOn: [], index: 0 },
135
- { id: 2, planKey: 'step_2', status: 'succeeded', dependsOn: [], index: 1 },
136
- ];
137
- const result = controller.pickNextSteps(steps);
138
- expect(result).toHaveLength(1);
139
- expect(result[0].id).toBe(1);
140
- });
141
-
142
- it('returns step when dependency is satisfied', () => {
143
- const { controller } = createController();
144
- const steps = [
145
- { id: 1, planKey: 'step_1', status: 'succeeded', dependsOn: [], index: 0 },
146
- { id: 2, planKey: 'step_2', status: 'pending', dependsOn: ['step_1'], index: 1 },
147
- ];
148
- const result = controller.pickNextSteps(steps);
149
- expect(result).toHaveLength(1);
150
- expect(result[0].id).toBe(2);
151
- });
152
-
153
- it('does not return step when dependency is pending', () => {
154
- const { controller } = createController();
155
- const steps = [
156
- { id: 1, planKey: 'step_1', status: 'pending', dependsOn: [], index: 0 },
157
- { id: 2, planKey: 'step_2', status: 'pending', dependsOn: ['step_1'], index: 1 },
158
- ];
159
- const result = controller.pickNextSteps(steps);
160
- expect(result).toHaveLength(1);
161
- expect(result[0].id).toBe(1);
162
- });
163
-
164
- it('handles allow_skipped dependency policy', () => {
165
- const { controller } = createController();
166
- const steps = [
167
- { id: 1, planKey: 'step_1', status: 'skipped', dependsOn: [], index: 0 },
168
- {
169
- id: 2,
170
- planKey: 'step_2',
171
- status: 'pending',
172
- dependsOn: ['step_1'],
173
- dependencyPolicy: 'allow_skipped',
174
- index: 1,
175
- },
176
- ];
177
- const result = controller.pickNextSteps(steps);
178
- expect(result).toHaveLength(1);
179
- expect(result[0].id).toBe(2);
180
- });
181
-
182
- it('does not return step when allow_skipped dependency is skipped but policy is require_success', () => {
183
- const { controller } = createController();
184
- const steps = [
185
- { id: 1, planKey: 'step_1', status: 'skipped', dependsOn: [], index: 0 },
186
- {
187
- id: 2,
188
- planKey: 'step_2',
189
- status: 'pending',
190
- dependsOn: ['step_1'],
191
- dependencyPolicy: 'require_success',
192
- index: 1,
193
- },
194
- ];
195
- const result = controller.pickNextSteps(steps);
196
- expect(result).toHaveLength(0);
197
- });
198
-
199
- it('returns multiple independent steps', () => {
200
- const { controller } = createController();
201
- const steps = [
202
- { id: 1, planKey: 'step_1', status: 'pending', dependsOn: [], index: 0 },
203
- { id: 2, planKey: 'step_2', status: 'pending', dependsOn: [], index: 1 },
204
- { id: 3, planKey: 'step_3', status: 'pending', dependsOn: ['step_1'], index: 2 },
205
- ];
206
- const result = controller.pickNextSteps(steps);
207
- expect(result).toHaveLength(2);
208
- expect(result.map((s: any) => s.id)).toEqual([1, 2]);
209
- });
210
-
211
- it('returns failed step that is retryable', () => {
212
- const { controller } = createController();
213
- const steps = [
214
- { id: 1, planKey: 'step_1', status: 'failed', dependsOn: [], index: 0, attempt: 1, maxAttempts: 3 },
215
- ];
216
- const result = controller.pickNextSteps(steps);
217
- expect(result).toHaveLength(1);
218
- expect(result[0].id).toBe(1);
219
- });
220
-
221
- it('does not return failed step that exhausted attempts', () => {
222
- const { controller } = createController();
223
- const steps = [
224
- { id: 1, planKey: 'step_1', status: 'failed', dependsOn: [], index: 0, attempt: 3, maxAttempts: 3 },
225
- ];
226
- const result = controller.pickNextSteps(steps);
227
- expect(result).toHaveLength(0);
228
- });
229
- });
230
-
231
- describe('createRun', () => {
232
- it('creates a run with a goal', async () => {
233
- const { controller, mocks } = createController();
234
- const snapshot = await controller.createRun({ goal: 'Test goal' });
235
- expect(snapshot.run).toBeTruthy();
236
- expect(snapshot.run.goal).toBe('Test goal');
237
- expect(snapshot.run.status).toBe('planning');
238
- expect(snapshot.run.rootRunId).toMatch(/^loop_/);
239
- });
240
-
241
- it('throws for empty goal', async () => {
242
- const { controller } = createController();
243
- await expect(controller.createRun({ goal: '' })).rejects.toThrow('goal is required');
244
- });
245
-
246
- it('creates steps when plan is provided', async () => {
247
- const { controller, mocks } = createController();
248
- const snapshot = await controller.createRun({
249
- goal: 'Test with plan',
250
- plan: [
251
- { title: 'Step 1', type: 'reasoning' },
252
- { title: 'Step 2', type: 'skill', target: 'search' },
253
- ],
254
- });
255
- expect(snapshot.steps).toHaveLength(2);
256
- expect(snapshot.steps[0].title).toBe('Step 1');
257
- expect(snapshot.steps[1].title).toBe('Step 2');
258
- });
259
- });
260
-
261
- describe('step lifecycle', () => {
262
- it('completeStep succeeds when step is running', async () => {
263
- const { controller, mocks } = createController();
264
- // Create a run and step
265
- const run = await mocks.repository.createRun({ goal: 'test', rootRunId: 'r1', status: 'running' });
266
- await mocks.repository.createStep({ runId: run.id, planKey: 'step_1', status: 'running', attempt: 1 });
267
-
268
- const snapshot = await controller.completeStep(1, { result: 'done' });
269
- const step = snapshot.steps.find((s: any) => s.id === 1);
270
- expect(step.status).toBe('succeeded');
271
- });
272
-
273
- it('completeStep throws when step is not running', async () => {
274
- const { controller, mocks } = createController();
275
- await mocks.repository.createRun({ goal: 'test', rootRunId: 'r2', status: 'running' });
276
- await mocks.repository.createStep({ runId: 1, planKey: 'step_1', status: 'pending' });
277
-
278
- await expect(controller.completeStep(1, {})).rejects.toThrow('cannot complete');
279
- });
280
-
281
- it('failStep throws when step is not running', async () => {
282
- const { controller, mocks } = createController();
283
- await mocks.repository.createRun({ goal: 'test', rootRunId: 'r3', status: 'running' });
284
- await mocks.repository.createStep({ runId: 1, planKey: 'step_1', status: 'pending' });
285
-
286
- await expect(controller.failStep(1, 'error')).rejects.toThrow('cannot fail');
287
- });
288
-
289
- it('skipStep succeeds for pending or running steps', async () => {
290
- const { controller, mocks } = createController();
291
- await mocks.repository.createRun({ goal: 'test', rootRunId: 'r4', status: 'running' });
292
- await mocks.repository.createStep({ runId: 1, planKey: 'step_1', status: 'pending' });
293
-
294
- const snapshot = await controller.skipStep(1, 'Not needed');
295
- const step = snapshot.steps.find((s: any) => s.id === 1);
296
- expect(step.status).toBe('skipped');
297
- });
298
-
299
- it('retryStep resets failed step to pending', async () => {
300
- const { controller, mocks } = createController();
301
- await mocks.repository.createRun({
302
- goal: 'test',
303
- rootRunId: 'r5',
304
- status: 'running',
305
- policy: { maxStepAttempts: 3 },
306
- });
307
- await mocks.repository.createStep({ runId: 1, planKey: 'step_1', status: 'failed', attempt: 1, maxAttempts: 3 });
308
-
309
- const snapshot = await controller.retryStep(1);
310
- const step = snapshot.steps.find((s: any) => s.id === 1);
311
- expect(step.status).toBe('pending');
312
- });
313
-
314
- it('retryStep throws when maxAttempts exceeded', async () => {
315
- const { controller, mocks } = createController();
316
- await mocks.repository.createRun({ goal: 'test', rootRunId: 'r6', status: 'running' });
317
- await mocks.repository.createStep({ runId: 1, planKey: 'step_1', status: 'failed', attempt: 5, maxAttempts: 3 });
318
-
319
- await expect(controller.retryStep(1)).rejects.toThrow('maxAttempts');
320
- });
321
- });
322
-
323
- describe('approval flow', () => {
324
- it('requestApproval sets step to waiting_user', async () => {
325
- const { controller, mocks } = createController();
326
- await mocks.repository.createRun({ goal: 'test', rootRunId: 'r7', status: 'running' });
327
- await mocks.repository.createStep({ runId: 1, planKey: 'step_1', status: 'running' });
328
-
329
- const snapshot = await controller.requestApproval(1, { prompt: 'OK?' });
330
- const step = snapshot.steps.find((s: any) => s.id === 1);
331
- expect(step.status).toBe('waiting_user');
332
- });
333
-
334
- it('resumeRun with approved=true resumes to pending', async () => {
335
- const { controller, mocks } = createController();
336
- await mocks.repository.createRun({
337
- id: 1,
338
- goal: 'test',
339
- rootRunId: 'r8',
340
- status: 'waiting_user',
341
- currentStepId: 1,
342
- policy: { requireVerification: false },
343
- });
344
- await mocks.repository.createStep({ runId: 1, planKey: 'step_1', status: 'waiting_user', approval: {} });
345
-
346
- const snapshot = await controller.resumeRun(1, { approved: true });
347
- expect(snapshot).toBeTruthy();
348
- // skip further assertions — the run may have attempted execution
349
- });
350
- });
351
-
352
- describe('finishRun', () => {
353
- it('finishes a succeeded run where all steps complete', async () => {
354
- const { controller, mocks } = createController();
355
- await mocks.repository.createRun({
356
- goal: 'test',
357
- rootRunId: 'r9',
358
- status: 'running',
359
- policy: { requireVerification: false },
360
- });
361
- await mocks.repository.createStep({ runId: 1, planKey: 'step_1', status: 'succeeded', type: 'reasoning' });
362
-
363
- const snapshot = await controller.finishRun(1, 'All done', { status: 'succeeded' });
364
- expect(snapshot.run.status).toBe('succeeded');
365
- });
366
-
367
- it('throws when succeeded run has unfinished steps', async () => {
368
- const { controller, mocks } = createController();
369
- await mocks.repository.createRun({ goal: 'test', rootRunId: 'r10', status: 'running' });
370
- await mocks.repository.createStep({ runId: 1, planKey: 'step_1', status: 'pending' });
371
-
372
- await expect(controller.finishRun(1, 'Done', { status: 'succeeded' })).rejects.toThrow('are not complete');
373
- });
374
- });
375
- });
@@ -1,222 +0,0 @@
1
- import { describe, expect, it, vi } from 'vitest';
2
- import { ContextAggregator } from '../services/ContextAggregator';
3
-
4
- function createMockPlugin() {
5
- const stepIdCounter = 1;
6
- const stepsStore: any[] = [];
7
- const runsStore: any[] = [];
8
-
9
- const mockRepo = {
10
- find: vi.fn(async ({ filter }: any) => {
11
- if (filter?.runId) {
12
- return stepsStore.filter((s) => s.runId === filter.runId);
13
- }
14
- return stepsStore;
15
- }),
16
- findOne: vi.fn(async ({ filter }: any) => {
17
- if (filter?.id) {
18
- return runsStore.find((r) => r.id === filter.id) || null;
19
- }
20
- return runsStore[0] || null;
21
- }),
22
- };
23
-
24
- return {
25
- db: {
26
- getRepository: vi.fn((name: string) => {
27
- if (name === 'agentLoopSteps') return mockRepo;
28
- if (name === 'agentLoopRuns') return mockRepo;
29
- return null;
30
- }),
31
- },
32
- app: { log: { warn: vi.fn() } },
33
- _stepsStore: stepsStore,
34
- _runsStore: runsStore,
35
- _repo: mockRepo,
36
- _stepIdCounter: stepIdCounter,
37
- };
38
- }
39
-
40
- function addStep(plugin: any, overrides: any = {}) {
41
- const id = plugin._stepIdCounter++;
42
- const step = {
43
- id,
44
- runId: overrides.runId || 1,
45
- planKey: overrides.planKey || `step_${id}`,
46
- index: overrides.index ?? id - 1,
47
- title: overrides.title || `Step ${id}`,
48
- description: overrides.description || '',
49
- type: overrides.type || 'reasoning',
50
- target: overrides.target || '',
51
- status: overrides.status || 'succeeded',
52
- output: overrides.output || {},
53
- error: overrides.error || '',
54
- metadata: overrides.metadata || {},
55
- ...overrides,
56
- };
57
- plugin._stepsStore.push(step);
58
- return step;
59
- }
60
-
61
- function addRun(plugin: any, overrides: any = {}) {
62
- const run = {
63
- id: overrides.id || 1,
64
- policy: overrides.policy || {},
65
- ...overrides,
66
- };
67
- plugin._runsStore.push(run);
68
- return run;
69
- }
70
-
71
- describe('ContextAggregator', () => {
72
- describe('buildStepContext', () => {
73
- it('returns empty string when there are no steps', async () => {
74
- const plugin = createMockPlugin();
75
- const aggregator = new ContextAggregator(plugin);
76
- const result = await aggregator.buildStepContext(1);
77
- expect(result).toBe('');
78
- });
79
-
80
- it('returns empty string when all steps are pending', async () => {
81
- const plugin = createMockPlugin();
82
- addStep(plugin, { status: 'pending' });
83
- addStep(plugin, { status: 'running' });
84
- const aggregator = new ContextAggregator(plugin);
85
- const result = await aggregator.buildStepContext(1);
86
- expect(result).toBe('');
87
- });
88
-
89
- it('builds XML for completed steps', async () => {
90
- const plugin = createMockPlugin();
91
- addStep(plugin, {
92
- planKey: 'step_1',
93
- title: 'Research topic',
94
- type: 'sub_agent',
95
- status: 'succeeded',
96
- output: { summary: 'Found data' },
97
- });
98
- const aggregator = new ContextAggregator(plugin);
99
- const result = await aggregator.buildStepContext(1);
100
-
101
- expect(result).toContain('<previous_steps>');
102
- expect(result).toContain('<step key="step_1"');
103
- expect(result).toContain('<title>Research topic</title>');
104
- expect(result).toContain('<output>');
105
- expect(result).toContain('Found data');
106
- expect(result).toContain('</previous_steps>');
107
- });
108
-
109
- it('includes error information for failed steps', async () => {
110
- const plugin = createMockPlugin();
111
- addStep(plugin, { planKey: 'step_1', status: 'failed', error: 'Something went wrong' });
112
- const aggregator = new ContextAggregator(plugin);
113
- const result = await aggregator.buildStepContext(1);
114
-
115
- expect(result).toContain('<error>');
116
- expect(result).toContain('Something went wrong');
117
- });
118
-
119
- it('respects last_n strategy', async () => {
120
- const plugin = createMockPlugin();
121
- for (let i = 1; i <= 15; i++) {
122
- addStep(plugin, { planKey: `step_${i}`, title: `Step ${i}`, status: 'succeeded' });
123
- }
124
- const aggregator = new ContextAggregator(plugin);
125
- const result = await aggregator.buildStepContext(1, 4000, { strategy: 'last_n' });
126
-
127
- // Should only include last 10
128
- expect(result).toContain('step_6');
129
- expect(result).not.toContain('planKey="step_1"');
130
- });
131
-
132
- it('omits output when includeStepOutputs is false', async () => {
133
- const plugin = createMockPlugin();
134
- addStep(plugin, { planKey: 'step_1', status: 'succeeded', output: { secret: 'data' } });
135
- const aggregator = new ContextAggregator(plugin);
136
- const result = await aggregator.buildStepContext(1, 4000, { includeStepOutputs: false });
137
-
138
- expect(result).not.toContain('<output>');
139
- });
140
-
141
- it('includes tool_results when includeToolResults is true', async () => {
142
- const plugin = createMockPlugin();
143
- addStep(plugin, {
144
- planKey: 'step_1',
145
- status: 'succeeded',
146
- metadata: { toolResults: [{ tool: 'search', result: 'found' }] },
147
- });
148
- const aggregator = new ContextAggregator(plugin);
149
- const result = await aggregator.buildStepContext(1, 4000, { includeToolResults: true });
150
-
151
- expect(result).toContain('<tool_results>');
152
- });
153
-
154
- it('escapes XML special characters', async () => {
155
- const plugin = createMockPlugin();
156
- addStep(plugin, { planKey: 'step_1', status: 'succeeded', title: 'Test & "Hello" <World>' });
157
- const aggregator = new ContextAggregator(plugin);
158
- const result = await aggregator.buildStepContext(1);
159
-
160
- expect(result).toContain('&amp;');
161
- expect(result).toContain('&lt;');
162
- expect(result).toContain('&quot;');
163
- expect(result).not.toContain('<World>');
164
- });
165
-
166
- it('truncates text exceeding maxTokens', async () => {
167
- const plugin = createMockPlugin();
168
- // Add many steps to force truncation
169
- for (let i = 1; i <= 20; i++) {
170
- addStep(plugin, { planKey: `step_${i}`, status: 'succeeded', description: 'A'.repeat(500) });
171
- }
172
- const aggregator = new ContextAggregator(plugin);
173
- const result = await aggregator.buildStepContext(1, 500); // very low token limit
174
-
175
- expect(result).toContain('intermediate step(s) omitted');
176
- expect(result.length).toBeLessThan(3000);
177
- });
178
-
179
- it('handles repository errors gracefully', async () => {
180
- const plugin = createMockPlugin();
181
- plugin.db.getRepository = vi.fn(() => null);
182
- const aggregator = new ContextAggregator(plugin);
183
- const result = await aggregator.buildStepContext(1);
184
- expect(result).toBe('');
185
- });
186
- });
187
-
188
- describe('enrichSystemPrompt', () => {
189
- it('returns base prompt when no run exists', async () => {
190
- const plugin = createMockPlugin();
191
- const aggregator = new ContextAggregator(plugin);
192
- const result = await aggregator.enrichSystemPrompt('You are a helpful assistant.', 999);
193
- expect(result).toBe('You are a helpful assistant.');
194
- });
195
-
196
- it('enriches prompt with step context', async () => {
197
- const plugin = createMockPlugin();
198
- addRun(plugin, { id: 1, policy: { maxContextTokens: 4000 } });
199
- addStep(plugin, { planKey: 'step_1', title: 'Research', status: 'succeeded', output: { data: 'results' } });
200
- const aggregator = new ContextAggregator(plugin);
201
- const result = await aggregator.enrichSystemPrompt('You are a helpful assistant.', 1);
202
-
203
- expect(result).toContain('You are a helpful assistant.');
204
- expect(result).toContain('<previous_steps_context>');
205
- expect(result).toContain('Research');
206
- });
207
-
208
- it('reads policy settings from run', async () => {
209
- const plugin = createMockPlugin();
210
- addRun(plugin, {
211
- id: 1,
212
- policy: { maxContextTokens: 100, contextSummaryStrategy: 'last_n', includeStepOutputs: false },
213
- });
214
- addStep(plugin, { planKey: 'step_1', status: 'succeeded', output: { data: 'results' } });
215
- addStep(plugin, { planKey: 'step_2', status: 'succeeded', output: { data: 'more' } });
216
- const aggregator = new ContextAggregator(plugin);
217
- const result = await aggregator.enrichSystemPrompt('Base prompt.', 1);
218
-
219
- expect(result).not.toContain('<output>');
220
- });
221
- });
222
- });