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.
- package/README.md +204 -114
- package/dist/client/index.js +1 -1
- package/dist/client-v2/117.7565cff57c39318a.js +10 -0
- package/dist/client-v2/214.106635011859dede.js +10 -0
- package/dist/client-v2/253.59577b40d9875be0.js +10 -0
- package/dist/client-v2/264.7ed8bee71fa5935c.js +10 -0
- package/dist/client-v2/{41.ba6e080cc0488143.js → 41.3deb9e57a0f64fc4.js} +1 -1
- package/dist/client-v2/418.41ed200e7d6da332.js +10 -0
- package/dist/client-v2/53.349fff8db80b19d4.js +10 -0
- package/dist/client-v2/619.0a2144aaffefe018.js +10 -0
- package/dist/client-v2/{70.bda9518881c05360.js → 70.ffff2997c10fd4b0.js} +1 -1
- package/dist/client-v2/{794.9bbb8d3a61b2bdf2.js → 794.a67a2614405ba627.js} +1 -1
- package/dist/client-v2/981.e4a1f41cfc94a856.js +10 -0
- package/dist/client-v2/{993.82778b6fd6db3cb1.js → 993.b0688fdc5ccb000a.js} +1 -1
- package/dist/client-v2/index.js +1 -1
- package/dist/externalVersion.js +8 -7
- package/dist/locale/en-US.json +199 -123
- package/dist/locale/vi-VN.json +199 -123
- package/dist/locale/zh-CN.json +199 -123
- package/dist/server/collections/agent-execution-spans.js +55 -0
- package/dist/server/collections/agent-harness-profile-versions.js +56 -0
- package/dist/server/collections/agent-harness-profiles.js +12 -0
- package/dist/server/collections/agent-loop-action-approvals.js +69 -0
- package/dist/server/collections/agent-loop-artifacts.js +55 -0
- package/dist/server/collections/agent-loop-circuit-states.js +53 -0
- package/dist/server/collections/agent-loop-control-settings.js +51 -0
- package/dist/server/collections/agent-loop-events.js +27 -0
- package/dist/server/collections/agent-loop-path-locks.js +57 -0
- package/dist/server/collections/agent-loop-patterns.js +72 -0
- package/dist/server/collections/agent-loop-runs.js +170 -3
- package/dist/server/collections/agent-loop-steps.js +76 -0
- package/dist/server/collections/agent-loop-usage-buckets.js +52 -0
- package/dist/server/collections/agent-loop-worktrees.js +55 -0
- package/dist/server/collections/skill-executions.js +8 -0
- package/dist/server/migrations/{20260427000000-change-packages-to-text.js → 20260427000002-change-packages-to-text.js} +2 -0
- package/dist/server/migrations/20260429000000-add-llm-fields.js +3 -2
- package/dist/server/migrations/{20260429000000-fix-inputargs-json-to-text.js → 20260429000001-fix-inputargs-json-to-text.js} +14 -6
- package/dist/server/migrations/20260503000000-add-orchestrator-trace-fields.js +2 -1
- package/dist/server/migrations/20260524000000-add-agent-loop-fields-to-skill-executions.js +2 -1
- package/dist/server/migrations/20260803010000-backfill-loop-control-plane-data.js +262 -0
- package/dist/server/plugin.js +54 -150
- package/dist/server/resources/agent-harness-profile.js +117 -0
- package/dist/server/resources/agent-knowledge-insights.js +1 -3
- package/dist/server/resources/agent-loop-approval.js +108 -0
- package/dist/server/resources/agent-loop-artifact.js +86 -0
- package/dist/server/resources/agent-loop-events-stream.js +130 -0
- package/dist/server/resources/agent-loop.js +183 -139
- package/dist/server/resources/resource-helpers.js +63 -0
- package/dist/server/resources/tracing.js +121 -107
- package/dist/server/services/AgentMemoryContextService.js +34 -0
- package/dist/server/services/DurableCircuitBreakerService.js +229 -0
- package/dist/server/services/HarnessCompiler.js +175 -0
- package/dist/server/services/HarnessProfileService.js +233 -0
- package/dist/server/services/HarnessSchema.js +194 -0
- package/dist/server/services/LoopBudgetService.js +269 -0
- package/dist/server/services/LoopControlService.js +139 -0
- package/dist/server/services/LoopPatternSchema.js +195 -0
- package/dist/server/services/LoopPatternService.js +132 -0
- package/dist/server/services/LoopRunRepository.js +285 -0
- package/dist/server/services/LoopRunStateMachine.js +478 -0
- package/dist/server/services/LoopSchedulerService.js +193 -0
- package/dist/server/services/LoopTriggerService.js +165 -0
- package/dist/server/services/LoopWorkerService.js +699 -0
- package/dist/server/services/NativeSubAgentObserver.js +165 -23
- package/dist/server/services/PathLockService.js +288 -0
- package/dist/server/services/PluginAiRuntimeAdapter.js +226 -0
- package/dist/server/services/ToolLoopDetectionService.js +210 -0
- package/dist/server/services/VerificationSchema.js +59 -0
- package/dist/server/services/VerificationService.js +235 -0
- package/dist/server/services/harness-runtime-policy.js +139 -0
- package/dist/server/skill-hub/actions/git-import.js +13 -7
- package/dist/server/skill-hub/plugin.js +36 -3
- package/dist/server/skill-hub/services/RegistrySkillSnapshotService.js +1 -5
- package/dist/server/skill-hub/tasks/SkillExecutionTask.js +29 -0
- package/dist/server/utils/ensure-indexes.js +111 -0
- package/dist/server/utils/loop-pattern-context.js +56 -0
- package/package.json +53 -53
- package/src/client/ApprovalsTab.tsx +2 -0
- package/src/client/OrchestratorSettings.tsx +55 -0
- package/src/client/skill-hub/components/GitSkillImport.tsx +3 -3
- package/src/client/skill-hub/components/SkillMetrics.tsx +15 -10
- package/src/client/skill-hub/index.tsx +0 -52
- package/src/client-v2/components/AgentRunsTab.tsx +100 -18
- package/src/client-v2/components/ApprovalsTab.tsx +337 -0
- package/src/client-v2/components/HarnessProfilesTab.tsx +385 -100
- package/src/client-v2/components/MemoryInspectorTab.tsx +141 -125
- package/src/client-v2/components/TracingTab.tsx +160 -77
- package/src/client-v2/hooks/useApiRequest.ts +28 -8
- package/src/client-v2/pages/ApprovalsPage.tsx +10 -0
- package/src/client-v2/plugin.tsx +6 -6
- package/src/client-v2/skill-hub/components/SkillMetrics.tsx +11 -6
- package/src/locale/en-US.json +199 -123
- package/src/locale/vi-VN.json +199 -123
- package/src/locale/zh-CN.json +199 -123
- package/src/server/__tests__/circuit-breaker.test.ts +248 -169
- package/src/server/__tests__/harness-compiler.test.ts +214 -0
- package/src/server/__tests__/harness-profile-service.test.ts +167 -0
- package/src/server/__tests__/harness-runtime-policy.test.ts +293 -0
- package/src/server/__tests__/harness-tool-plan.test.ts +172 -0
- package/src/server/__tests__/loop-approval-decision.test.ts +512 -0
- package/src/server/__tests__/loop-approval-expiry.test.ts +258 -0
- package/src/server/__tests__/loop-budget-service.test.ts +255 -0
- package/src/server/__tests__/loop-control-plane-backfill.test.ts +266 -0
- package/src/server/__tests__/loop-pattern-schema.test.ts +73 -0
- package/src/server/__tests__/loop-pattern-service.test.ts +148 -0
- package/src/server/__tests__/loop-run-state-machine.test.ts +101 -0
- package/src/server/__tests__/loop-trigger-service.test.ts +148 -0
- package/src/server/__tests__/loop-worker-claim.test.ts +341 -0
- package/src/server/__tests__/loop-worker-execution.test.ts +317 -0
- package/src/server/__tests__/native-sub-agent-observer.test.ts +288 -4
- package/src/server/__tests__/path-lock-service.test.ts +254 -0
- package/src/server/__tests__/skill-execution-task-policy.test.ts +140 -0
- package/src/server/__tests__/smoke.test.ts +162 -121
- package/src/server/__tests__/tool-loop-detection.test.ts +275 -0
- package/src/server/collections/agent-execution-spans.ts +55 -0
- package/src/server/collections/agent-harness-profile-versions.ts +26 -0
- package/src/server/collections/agent-harness-profiles.ts +71 -59
- package/src/server/collections/agent-loop-action-approvals.ts +39 -0
- package/src/server/collections/agent-loop-artifacts.ts +25 -0
- package/src/server/collections/agent-loop-circuit-states.ts +23 -0
- package/src/server/collections/agent-loop-control-settings.ts +21 -0
- package/src/server/collections/agent-loop-events.ts +98 -71
- package/src/server/collections/agent-loop-path-locks.ts +27 -0
- package/src/server/collections/agent-loop-patterns.ts +42 -0
- package/src/server/collections/agent-loop-runs.ts +170 -3
- package/src/server/collections/agent-loop-steps.ts +76 -0
- package/src/server/collections/agent-loop-usage-buckets.ts +22 -0
- package/src/server/collections/agent-loop-worktrees.ts +25 -0
- package/src/server/collections/skill-executions.ts +8 -0
- package/src/server/migrations/{20260427000000-change-packages-to-text.ts → 20260427000002-change-packages-to-text.ts} +52 -49
- package/src/server/migrations/20260429000000-add-llm-fields.ts +47 -46
- package/src/server/migrations/{20260429000000-fix-inputargs-json-to-text.ts → 20260429000001-fix-inputargs-json-to-text.ts} +45 -38
- package/src/server/migrations/20260503000000-add-orchestrator-trace-fields.ts +33 -32
- package/src/server/migrations/20260524000000-add-agent-loop-fields-to-skill-executions.ts +31 -30
- package/src/server/migrations/20260803010000-backfill-loop-control-plane-data.ts +293 -0
- package/src/server/plugin.ts +55 -167
- package/src/server/resources/agent-harness-profile.ts +94 -0
- package/src/server/resources/agent-knowledge-insights.ts +5 -3
- package/src/server/resources/agent-loop-approval.ts +84 -0
- package/src/server/resources/agent-loop-artifact.ts +56 -0
- package/src/server/resources/agent-loop-events-stream.ts +105 -0
- package/src/server/resources/agent-loop.ts +204 -143
- package/src/server/resources/agent-monitor.ts +482 -482
- package/src/server/resources/resource-helpers.ts +33 -0
- package/src/server/resources/tracing.ts +266 -258
- package/src/server/services/AgentMemoryContextService.ts +44 -0
- package/src/server/services/DurableCircuitBreakerService.ts +239 -0
- package/src/server/services/ExecutionSpanService.ts +2 -0
- package/src/server/services/HarnessCompiler.ts +170 -0
- package/src/server/services/HarnessProfileService.ts +239 -0
- package/src/server/services/HarnessSchema.ts +194 -0
- package/src/server/services/LoopBudgetService.ts +275 -0
- package/src/server/services/LoopControlService.ts +124 -0
- package/src/server/services/LoopPatternSchema.ts +185 -0
- package/src/server/services/LoopPatternService.ts +143 -0
- package/src/server/services/LoopRunRepository.ts +336 -0
- package/src/server/services/LoopRunStateMachine.ts +529 -0
- package/src/server/services/LoopSchedulerService.ts +199 -0
- package/src/server/services/LoopTriggerService.ts +157 -0
- package/src/server/services/LoopWorkerService.ts +822 -0
- package/src/server/services/NativeSubAgentObserver.ts +186 -21
- package/src/server/services/PathLockService.ts +321 -0
- package/src/server/services/PluginAiRuntimeAdapter.ts +332 -0
- package/src/server/services/ToolLoopDetectionService.ts +213 -0
- package/src/server/services/VerificationSchema.ts +31 -0
- package/src/server/services/VerificationService.ts +264 -0
- package/src/server/services/harness-runtime-policy.ts +141 -0
- package/src/server/skill-hub/actions/__tests__/git-import.test.ts +15 -1
- package/src/server/skill-hub/actions/git-import.ts +9 -3
- package/src/server/skill-hub/plugin.ts +41 -3
- package/src/server/skill-hub/services/RegistrySkillSnapshotService.ts +235 -239
- package/src/server/skill-hub/services/__tests__/RegistrySkillSnapshotService.test.ts +61 -63
- package/src/server/skill-hub/tasks/SkillExecutionTask.ts +43 -2
- package/src/server/utils/ensure-indexes.ts +96 -0
- package/src/server/utils/logging.ts +62 -63
- package/src/server/utils/loop-pattern-context.ts +20 -0
- package/dist/client-v2/214.79650a549273f163.js +0 -10
- package/dist/client-v2/253.9f0537713cee9e6c.js +0 -10
- package/dist/client-v2/264.718a107e43fc163c.js +0 -10
- package/dist/client-v2/373.f5d5292e53c4e832.js +0 -10
- package/dist/client-v2/418.ce8f5b2b8a229d1d.js +0 -10
- package/dist/client-v2/53.7c29c28043e9112d.js +0 -10
- package/dist/client-v2/619.bd3c5698b40705c3.js +0 -10
- package/dist/client-v2/677.a991ce0250ff5c77.js +0 -10
- package/dist/client-v2/925.f5370de8f6632d65.js +0 -10
- package/dist/server/services/AgentHarness.js +0 -81
- package/dist/server/services/AgentLoopController.js +0 -1023
- package/dist/server/services/AgentLoopRepository.js +0 -192
- package/dist/server/services/AgentLoopService.js +0 -142
- package/dist/server/services/AgentPlanValidator.js +0 -99
- package/dist/server/services/AgentPlannerService.js +0 -99
- package/dist/server/services/CircuitBreaker.js +0 -125
- package/dist/server/services/ContextAggregator.js +0 -201
- package/dist/server/services/PlanningPromptService.js +0 -95
- package/dist/server/tools/agent-loop.js +0 -373
- package/dist/server/tools/orchestrator-plan.js +0 -254
- package/src/client/AIEmployeeSelect.tsx +0 -47
- package/src/client/AIEmployeesContext.tsx +0 -102
- package/src/client/RulesTab.tsx +0 -2
- package/src/client/TracingTab.tsx +0 -436
- package/src/client/skill-hub/components/ExecutionProgress.tsx +0 -51
- package/src/client-v2/components/RulesTab.tsx +0 -2
- package/src/client-v2/pages/AgentRunsPage.tsx +0 -13
- package/src/server/__tests__/agent-loop-controller.test.ts +0 -375
- package/src/server/__tests__/context-aggregator.test.ts +0 -222
- package/src/server/__tests__/parallel-execution.test.ts +0 -318
- package/src/server/__tests__/planning-prompt-service.test.ts +0 -23
- package/src/server/services/AgentHarness.ts +0 -67
- package/src/server/services/AgentLoopController.ts +0 -1263
- package/src/server/services/AgentLoopRepository.ts +0 -178
- package/src/server/services/AgentLoopService.ts +0 -177
- package/src/server/services/AgentPlanValidator.ts +0 -73
- package/src/server/services/AgentPlannerService.ts +0 -80
- package/src/server/services/CircuitBreaker.ts +0 -126
- package/src/server/services/ContextAggregator.ts +0 -239
- package/src/server/services/PlanningPromptService.ts +0 -72
- package/src/server/tools/agent-loop.ts +0 -360
- 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('&');
|
|
161
|
-
expect(result).toContain('<');
|
|
162
|
-
expect(result).toContain('"');
|
|
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
|
-
});
|