plugin-agent-orchestrator 1.1.2 → 1.1.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (173) hide show
  1. package/dist/client/index.js +1 -1
  2. package/dist/client-v2/214.b063f33ba044a808.js +10 -0
  3. package/dist/client-v2/253.59577b40d9875be0.js +10 -0
  4. package/dist/client-v2/264.7ed8bee71fa5935c.js +10 -0
  5. package/dist/client-v2/{41.ba6e080cc0488143.js → 41.3deb9e57a0f64fc4.js} +1 -1
  6. package/dist/client-v2/418.58fa350f5496efd3.js +10 -0
  7. package/dist/client-v2/{53.7c29c28043e9112d.js → 53.9a10455323390f14.js} +1 -1
  8. package/dist/client-v2/619.0a2144aaffefe018.js +10 -0
  9. package/dist/client-v2/{70.bda9518881c05360.js → 70.ffff2997c10fd4b0.js} +1 -1
  10. package/dist/client-v2/{794.9bbb8d3a61b2bdf2.js → 794.a67a2614405ba627.js} +1 -1
  11. package/dist/client-v2/925.e5925bf21ed68e7a.js +10 -0
  12. package/dist/client-v2/{993.82778b6fd6db3cb1.js → 993.b0688fdc5ccb000a.js} +1 -1
  13. package/dist/client-v2/index.js +1 -1
  14. package/dist/externalVersion.js +8 -6
  15. package/dist/locale/en-US.json +48 -28
  16. package/dist/locale/vi-VN.json +48 -28
  17. package/dist/locale/zh-CN.json +48 -28
  18. package/dist/server/collections/agent-execution-spans.js +47 -0
  19. package/dist/server/collections/agent-harness-profile-versions.js +56 -0
  20. package/dist/server/collections/agent-harness-profiles.js +12 -0
  21. package/dist/server/collections/agent-loop-action-approvals.js +68 -0
  22. package/dist/server/collections/agent-loop-artifacts.js +55 -0
  23. package/dist/server/collections/agent-loop-circuit-states.js +53 -0
  24. package/dist/server/collections/agent-loop-control-settings.js +51 -0
  25. package/dist/server/collections/agent-loop-events.js +27 -0
  26. package/dist/server/collections/agent-loop-path-locks.js +57 -0
  27. package/dist/server/collections/agent-loop-patterns.js +72 -0
  28. package/dist/server/collections/agent-loop-runs.js +163 -2
  29. package/dist/server/collections/agent-loop-steps.js +69 -0
  30. package/dist/server/collections/agent-loop-usage-buckets.js +52 -0
  31. package/dist/server/collections/agent-loop-worktrees.js +55 -0
  32. package/dist/server/migrations/{20260427000000-change-packages-to-text.js → 20260427000002-change-packages-to-text.js} +2 -0
  33. package/dist/server/migrations/20260429000000-add-llm-fields.js +3 -2
  34. package/dist/server/migrations/{20260429000000-fix-inputargs-json-to-text.js → 20260429000001-fix-inputargs-json-to-text.js} +14 -6
  35. package/dist/server/migrations/20260503000000-add-orchestrator-trace-fields.js +2 -1
  36. package/dist/server/migrations/20260524000000-add-agent-loop-fields-to-skill-executions.js +2 -1
  37. package/dist/server/migrations/20260803010000-backfill-loop-control-plane-data.js +262 -0
  38. package/dist/server/plugin.js +52 -150
  39. package/dist/server/resources/agent-loop-approval.js +83 -0
  40. package/dist/server/resources/agent-loop-artifact.js +86 -0
  41. package/dist/server/resources/agent-loop-events-stream.js +130 -0
  42. package/dist/server/resources/agent-loop.js +181 -139
  43. package/dist/server/resources/resource-helpers.js +63 -0
  44. package/dist/server/resources/tracing.js +121 -107
  45. package/dist/server/services/DurableCircuitBreakerService.js +229 -0
  46. package/dist/server/services/HarnessCompiler.js +142 -0
  47. package/dist/server/services/HarnessProfileService.js +168 -0
  48. package/dist/server/services/HarnessSchema.js +167 -0
  49. package/dist/server/services/LoopBudgetService.js +269 -0
  50. package/dist/server/services/LoopControlService.js +139 -0
  51. package/dist/server/services/LoopPatternSchema.js +180 -0
  52. package/dist/server/services/LoopPatternService.js +132 -0
  53. package/dist/server/services/LoopRunRepository.js +205 -0
  54. package/dist/server/services/LoopRunStateMachine.js +389 -0
  55. package/dist/server/services/LoopSchedulerService.js +193 -0
  56. package/dist/server/services/LoopTriggerService.js +128 -0
  57. package/dist/server/services/LoopWorkerService.js +461 -0
  58. package/dist/server/services/PathLockService.js +288 -0
  59. package/dist/server/services/PluginAiRuntimeAdapter.js +215 -0
  60. package/dist/server/services/VerificationSchema.js +59 -0
  61. package/dist/server/services/VerificationService.js +169 -0
  62. package/dist/server/skill-hub/actions/git-import.js +13 -7
  63. package/dist/server/skill-hub/services/RegistrySkillSnapshotService.js +1 -5
  64. package/dist/server/utils/ensure-indexes.js +111 -0
  65. package/dist/server/utils/loop-pattern-context.js +56 -0
  66. package/package.json +2 -2
  67. package/src/client/OrchestratorSettings.tsx +44 -0
  68. package/src/client-v2/components/AgentRunsTab.tsx +576 -494
  69. package/src/client-v2/components/HarnessProfilesTab.tsx +13 -8
  70. package/src/client-v2/components/MemoryInspectorTab.tsx +19 -3
  71. package/src/client-v2/components/TracingTab.tsx +515 -432
  72. package/src/client-v2/hooks/useApiRequest.ts +141 -121
  73. package/src/client-v2/skill-hub/components/SkillMetrics.tsx +8 -6
  74. package/src/locale/en-US.json +52 -28
  75. package/src/locale/vi-VN.json +52 -28
  76. package/src/locale/zh-CN.json +52 -28
  77. package/src/server/__tests__/circuit-breaker.test.ts +225 -146
  78. package/src/server/__tests__/harness-compiler.test.ts +131 -0
  79. package/src/server/__tests__/harness-profile-service.test.ts +116 -0
  80. package/src/server/__tests__/harness-tool-plan.test.ts +148 -0
  81. package/src/server/__tests__/loop-budget-service.test.ts +255 -0
  82. package/src/server/__tests__/loop-control-plane-backfill.test.ts +266 -0
  83. package/src/server/__tests__/loop-pattern-schema.test.ts +56 -0
  84. package/src/server/__tests__/loop-pattern-service.test.ts +148 -0
  85. package/src/server/__tests__/loop-run-state-machine.test.ts +90 -0
  86. package/src/server/__tests__/loop-worker-claim.test.ts +341 -0
  87. package/src/server/__tests__/loop-worker-execution.test.ts +236 -0
  88. package/src/server/__tests__/path-lock-service.test.ts +254 -0
  89. package/src/server/__tests__/smoke.test.ts +62 -21
  90. package/src/server/collections/agent-execution-spans.ts +47 -0
  91. package/src/server/collections/agent-harness-profile-versions.ts +26 -0
  92. package/src/server/collections/agent-harness-profiles.ts +12 -0
  93. package/src/server/collections/agent-loop-action-approvals.ts +38 -0
  94. package/src/server/collections/agent-loop-artifacts.ts +25 -0
  95. package/src/server/collections/agent-loop-circuit-states.ts +23 -0
  96. package/src/server/collections/agent-loop-control-settings.ts +21 -0
  97. package/src/server/collections/agent-loop-events.ts +27 -0
  98. package/src/server/collections/agent-loop-path-locks.ts +27 -0
  99. package/src/server/collections/agent-loop-patterns.ts +42 -0
  100. package/src/server/collections/agent-loop-runs.ts +163 -2
  101. package/src/server/collections/agent-loop-steps.ts +69 -0
  102. package/src/server/collections/agent-loop-usage-buckets.ts +22 -0
  103. package/src/server/collections/agent-loop-worktrees.ts +25 -0
  104. package/src/server/migrations/{20260427000000-change-packages-to-text.ts → 20260427000002-change-packages-to-text.ts} +3 -0
  105. package/src/server/migrations/20260429000000-add-llm-fields.ts +3 -2
  106. package/src/server/migrations/{20260429000000-fix-inputargs-json-to-text.ts → 20260429000001-fix-inputargs-json-to-text.ts} +13 -6
  107. package/src/server/migrations/20260503000000-add-orchestrator-trace-fields.ts +2 -1
  108. package/src/server/migrations/20260524000000-add-agent-loop-fields-to-skill-executions.ts +2 -1
  109. package/src/server/migrations/20260803010000-backfill-loop-control-plane-data.ts +293 -0
  110. package/src/server/plugin.ts +53 -167
  111. package/src/server/resources/agent-loop-approval.ts +52 -0
  112. package/src/server/resources/agent-loop-artifact.ts +56 -0
  113. package/src/server/resources/agent-loop-events-stream.ts +105 -0
  114. package/src/server/resources/agent-loop.ts +202 -143
  115. package/src/server/resources/agent-monitor.ts +482 -482
  116. package/src/server/resources/resource-helpers.ts +33 -0
  117. package/src/server/resources/tracing.ts +145 -137
  118. package/src/server/services/DurableCircuitBreakerService.ts +239 -0
  119. package/src/server/services/HarnessCompiler.ts +133 -0
  120. package/src/server/services/HarnessProfileService.ts +157 -0
  121. package/src/server/services/HarnessSchema.ts +163 -0
  122. package/src/server/services/LoopBudgetService.ts +275 -0
  123. package/src/server/services/LoopControlService.ts +124 -0
  124. package/src/server/services/LoopPatternSchema.ts +167 -0
  125. package/src/server/services/LoopPatternService.ts +143 -0
  126. package/src/server/services/LoopRunRepository.ts +237 -0
  127. package/src/server/services/LoopRunStateMachine.ts +432 -0
  128. package/src/server/services/LoopSchedulerService.ts +199 -0
  129. package/src/server/services/LoopTriggerService.ts +115 -0
  130. package/src/server/services/LoopWorkerService.ts +522 -0
  131. package/src/server/services/PathLockService.ts +321 -0
  132. package/src/server/services/PluginAiRuntimeAdapter.ts +315 -0
  133. package/src/server/services/VerificationSchema.ts +31 -0
  134. package/src/server/services/VerificationService.ts +185 -0
  135. package/src/server/skill-hub/actions/__tests__/git-import.test.ts +62 -0
  136. package/src/server/skill-hub/actions/git-import.ts +9 -3
  137. package/src/server/skill-hub/services/RegistrySkillSnapshotService.ts +1 -5
  138. package/src/server/skill-hub/services/__tests__/RegistrySkillSnapshotService.test.ts +1 -3
  139. package/src/server/utils/ensure-indexes.ts +96 -0
  140. package/src/server/utils/logging.ts +0 -1
  141. package/src/server/utils/loop-pattern-context.ts +20 -0
  142. package/dist/client-v2/214.79650a549273f163.js +0 -10
  143. package/dist/client-v2/253.9f0537713cee9e6c.js +0 -10
  144. package/dist/client-v2/264.718a107e43fc163c.js +0 -10
  145. package/dist/client-v2/418.ce8f5b2b8a229d1d.js +0 -10
  146. package/dist/client-v2/619.bd3c5698b40705c3.js +0 -10
  147. package/dist/client-v2/925.f5370de8f6632d65.js +0 -10
  148. package/dist/server/services/AgentHarness.js +0 -81
  149. package/dist/server/services/AgentLoopController.js +0 -1023
  150. package/dist/server/services/AgentLoopRepository.js +0 -192
  151. package/dist/server/services/AgentLoopService.js +0 -142
  152. package/dist/server/services/AgentPlanValidator.js +0 -99
  153. package/dist/server/services/AgentPlannerService.js +0 -99
  154. package/dist/server/services/CircuitBreaker.js +0 -125
  155. package/dist/server/services/ContextAggregator.js +0 -201
  156. package/dist/server/services/PlanningPromptService.js +0 -95
  157. package/dist/server/tools/agent-loop.js +0 -373
  158. package/dist/server/tools/orchestrator-plan.js +0 -254
  159. package/src/server/__tests__/agent-loop-controller.test.ts +0 -375
  160. package/src/server/__tests__/context-aggregator.test.ts +0 -222
  161. package/src/server/__tests__/parallel-execution.test.ts +0 -318
  162. package/src/server/__tests__/planning-prompt-service.test.ts +0 -23
  163. package/src/server/services/AgentHarness.ts +0 -67
  164. package/src/server/services/AgentLoopController.ts +0 -1263
  165. package/src/server/services/AgentLoopRepository.ts +0 -178
  166. package/src/server/services/AgentLoopService.ts +0 -177
  167. package/src/server/services/AgentPlanValidator.ts +0 -73
  168. package/src/server/services/AgentPlannerService.ts +0 -80
  169. package/src/server/services/CircuitBreaker.ts +0 -126
  170. package/src/server/services/ContextAggregator.ts +0 -239
  171. package/src/server/services/PlanningPromptService.ts +0 -72
  172. package/src/server/tools/agent-loop.ts +0 -360
  173. package/src/server/tools/orchestrator-plan.ts +0 -255
@@ -1,254 +0,0 @@
1
- /**
2
- * This file is part of the NocoBase (R) project.
3
- * Copyright (c) 2020-2024 NocoBase Co., Ltd.
4
- * Authors: NocoBase Team.
5
- *
6
- * This project is dual-licensed under AGPL-3.0 and NocoBase Commercial License.
7
- * For more information, please refer to: https://www.nocobase.com/agreement.
8
- */
9
-
10
- var __defProp = Object.defineProperty;
11
- var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
12
- var __getOwnPropNames = Object.getOwnPropertyNames;
13
- var __hasOwnProp = Object.prototype.hasOwnProperty;
14
- var __export = (target, all) => {
15
- for (var name in all)
16
- __defProp(target, name, { get: all[name], enumerable: true });
17
- };
18
- var __copyProps = (to, from, except, desc) => {
19
- if (from && typeof from === "object" || typeof from === "function") {
20
- for (let key of __getOwnPropNames(from))
21
- if (!__hasOwnProp.call(to, key) && key !== except)
22
- __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
23
- }
24
- return to;
25
- };
26
- var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
27
- var orchestrator_plan_exports = {};
28
- __export(orchestrator_plan_exports, {
29
- createOrchestratorPlanTools: () => createOrchestratorPlanTools
30
- });
31
- module.exports = __toCommonJS(orchestrator_plan_exports);
32
- var import_zod = require("zod");
33
- var import_ctx_utils = require("../utils/ctx-utils");
34
- const stepSchema = import_zod.z.object({
35
- id: import_zod.z.string().optional(),
36
- key: import_zod.z.string().optional(),
37
- planKey: import_zod.z.string().optional(),
38
- parentStepId: import_zod.z.union([import_zod.z.string(), import_zod.z.number()]).optional(),
39
- title: import_zod.z.string().optional(),
40
- description: import_zod.z.string().optional(),
41
- type: import_zod.z.enum(["reasoning", "skill", "tool", "sub_agent", "verification"]).optional(),
42
- target: import_zod.z.string().optional(),
43
- input: import_zod.z.any().optional(),
44
- dependsOn: import_zod.z.array(import_zod.z.string()).optional(),
45
- dependencyPolicy: import_zod.z.enum(["require_success", "allow_skipped"]).optional(),
46
- maxAttempts: import_zod.z.number().int().min(1).max(10).optional(),
47
- metadata: import_zod.z.any().optional()
48
- });
49
- const policySchema = import_zod.z.object({
50
- maxIterations: import_zod.z.number().int().min(1).max(100).optional(),
51
- maxStepAttempts: import_zod.z.number().int().min(1).max(10).optional(),
52
- allowReplan: import_zod.z.boolean().optional(),
53
- requireVerification: import_zod.z.boolean().optional(),
54
- stopOnApprovalRequired: import_zod.z.boolean().optional()
55
- }).optional();
56
- function toolResult(status, payload) {
57
- return {
58
- status,
59
- content: typeof payload === "string" ? payload : JSON.stringify(payload)
60
- };
61
- }
62
- function summarizePlan(steps) {
63
- return (steps || []).map((step) => ({
64
- id: step.id,
65
- planKey: step.planKey,
66
- title: step.title,
67
- description: step.description,
68
- type: step.type,
69
- target: step.target,
70
- dependsOn: step.dependsOn || [],
71
- status: step.status
72
- }));
73
- }
74
- function inferTargetAgent(args) {
75
- if (args == null ? void 0 : args.targetAgent) return args.targetAgent;
76
- const plan = Array.isArray(args == null ? void 0 : args.plan) ? args.plan : [];
77
- const subAgentStep = plan.find((step) => (step == null ? void 0 : step.type) === "sub_agent" && (step == null ? void 0 : step.target));
78
- return subAgentStep == null ? void 0 : subAgentStep.target;
79
- }
80
- async function resolveHarnessTag(plugin, leaderUsername, targetAgent, args) {
81
- var _a, _b;
82
- const direct = String((args == null ? void 0 : args.harnessTag) || ((_a = args == null ? void 0 : args.metadata) == null ? void 0 : _a.harnessTag) || "").trim();
83
- if (direct) return direct;
84
- if (!leaderUsername || !targetAgent) return "default";
85
- try {
86
- const repo = plugin.db.getRepository("orchestratorConfig");
87
- const config = await repo.findOne({
88
- filter: {
89
- leaderUsername,
90
- subAgentUsername: targetAgent,
91
- enabled: true
92
- }
93
- });
94
- return (config == null ? void 0 : config.harnessTag) || ((_b = config == null ? void 0 : config.get) == null ? void 0 : _b.call(config, "harnessTag")) || "default";
95
- } catch {
96
- return "default";
97
- }
98
- }
99
- function createOrchestratorPlanTools(plugin, service) {
100
- return [
101
- {
102
- scope: "CUSTOM",
103
- execution: "backend",
104
- defaultPermission: "ALLOW",
105
- introduction: {
106
- title: "Orchestrator - Plan Goal",
107
- about: "Create a draft plan and pause for explicit user approval before execution."
108
- },
109
- definition: {
110
- name: "orchestrator_plan_goal",
111
- description: "Create or revise a persistent orchestrator run in waiting_plan_approval state. Use this before any multi-step/sub-agent execution. Provide a concrete plan with small executable steps and stable planKey dependencies whenever possible. Pass runId only when revising after user-requested changes. This tool does not execute the plan.",
112
- schema: import_zod.z.object({
113
- goal: import_zod.z.string().min(1).describe("The user goal to complete."),
114
- runId: import_zod.z.union([import_zod.z.string(), import_zod.z.number()]).optional().describe("Existing run id to revise after the user requested plan changes. Omit for a new run."),
115
- leaderUsername: import_zod.z.string().optional().describe("Leader AI employee username. Usually omit; inferred from chat."),
116
- sessionId: import_zod.z.string().optional(),
117
- messageId: import_zod.z.string().optional(),
118
- harnessTag: import_zod.z.string().optional().default("default").describe("Harness profile tag, for example default, safe, or file-heavy."),
119
- targetAgent: import_zod.z.string().optional().describe("Optional sub-agent username for generated fallback plans."),
120
- plannerModel: import_zod.z.string().optional(),
121
- policy: policySchema,
122
- metadata: import_zod.z.any().optional(),
123
- plan: import_zod.z.array(stepSchema).optional().describe(
124
- "Draft plan steps. Tool/sub_agent steps should include target. Dependencies must reference planKey values."
125
- )
126
- })
127
- },
128
- invoke: async (ctx, args) => {
129
- try {
130
- const leaderUsername = await (0, import_ctx_utils.resolveLeaderUsername)(ctx, plugin, args);
131
- const targetAgent = inferTargetAgent(args);
132
- const harnessTag = await resolveHarnessTag(plugin, leaderUsername, targetAgent, args);
133
- const detail = await service.planGoal({
134
- goal: args.goal,
135
- runId: args.runId,
136
- leaderUsername,
137
- sessionId: (0, import_ctx_utils.resolveSessionId)(ctx, args),
138
- messageId: (0, import_ctx_utils.resolveMessageId)(ctx, args),
139
- userId: (0, import_ctx_utils.currentUserId)(ctx),
140
- policy: args.policy,
141
- metadata: args.metadata,
142
- plan: Array.isArray(args.plan) ? args.plan : void 0,
143
- plannerModel: args.plannerModel,
144
- harnessTag,
145
- targetAgent
146
- });
147
- return toolResult("success", {
148
- run: detail.run,
149
- plan: summarizePlan(detail.steps),
150
- approval: {
151
- required: true,
152
- nextTool: "orchestrator_execute_plan",
153
- args: {
154
- runId: detail.run.id,
155
- planVersion: detail.run.planVersion || 1,
156
- plan: summarizePlan(detail.steps)
157
- }
158
- }
159
- });
160
- } catch (error) {
161
- return toolResult("error", (error == null ? void 0 : error.message) || String(error));
162
- }
163
- }
164
- },
165
- {
166
- scope: "CUSTOM",
167
- execution: "backend",
168
- defaultPermission: "ASK",
169
- introduction: {
170
- title: "Orchestrator - Execute Approved Plan",
171
- about: "Execute a draft plan only after the user approves the plan card."
172
- },
173
- definition: {
174
- name: "orchestrator_execute_plan",
175
- description: "Execute a run created by orchestrator_plan_goal. This tool must be called with the runId after the user reviews the plan. The UI will ask the user to accept or reject the plan before invoke runs.",
176
- schema: import_zod.z.object({
177
- runId: import_zod.z.union([import_zod.z.string(), import_zod.z.number()]).describe("The agentLoopRuns id returned by orchestrator_plan_goal."),
178
- planVersion: import_zod.z.number().int().optional(),
179
- plan: import_zod.z.array(stepSchema).optional().describe("Optional copy of the displayed plan for the approval UI."),
180
- reason: import_zod.z.string().optional()
181
- })
182
- },
183
- invoke: async (ctx, args) => {
184
- try {
185
- const detail = await service.approvePlanAndExecute(args.runId, {
186
- userId: (0, import_ctx_utils.currentUserId)(ctx),
187
- ctx,
188
- reason: args.reason
189
- });
190
- return toolResult("success", detail);
191
- } catch (error) {
192
- return toolResult("error", (error == null ? void 0 : error.message) || String(error));
193
- }
194
- }
195
- },
196
- {
197
- scope: "CUSTOM",
198
- execution: "backend",
199
- defaultPermission: "ALLOW",
200
- introduction: {
201
- title: "Orchestrator - Status",
202
- about: "Read a run, its plan steps, events, and linked traces."
203
- },
204
- definition: {
205
- name: "orchestrator_status",
206
- description: "Read the current status of an orchestrator run without mutating it.",
207
- schema: import_zod.z.object({
208
- runId: import_zod.z.union([import_zod.z.string(), import_zod.z.number()])
209
- })
210
- },
211
- invoke: async (_ctx, args) => {
212
- try {
213
- return toolResult("success", await service.getRunDetail(args.runId));
214
- } catch (error) {
215
- return toolResult("error", (error == null ? void 0 : error.message) || String(error));
216
- }
217
- }
218
- },
219
- {
220
- scope: "CUSTOM",
221
- execution: "backend",
222
- defaultPermission: "ASK",
223
- introduction: {
224
- title: "Orchestrator - Cancel Run",
225
- about: "Cancel an orchestrator run with user approval."
226
- },
227
- definition: {
228
- name: "orchestrator_cancel",
229
- description: "Cancel an orchestrator run. This mutates run state and therefore requires user approval.",
230
- schema: import_zod.z.object({
231
- runId: import_zod.z.union([import_zod.z.string(), import_zod.z.number()]),
232
- reason: import_zod.z.string().optional()
233
- })
234
- },
235
- invoke: async (ctx, args) => {
236
- try {
237
- return toolResult(
238
- "success",
239
- await service.cancelRun(args.runId, {
240
- reason: args.reason,
241
- userId: (0, import_ctx_utils.currentUserId)(ctx)
242
- })
243
- );
244
- } catch (error) {
245
- return toolResult("error", (error == null ? void 0 : error.message) || String(error));
246
- }
247
- }
248
- }
249
- ];
250
- }
251
- // Annotate the CommonJS export names for ESM import in node:
252
- 0 && (module.exports = {
253
- createOrchestratorPlanTools
254
- });
@@ -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
- });