plugin-agent-orchestrator 1.1.3 → 1.1.4

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