plugin-agent-orchestrator 1.1.3 → 1.1.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (218) hide show
  1. package/README.md +204 -114
  2. package/dist/client/index.js +1 -1
  3. package/dist/client-v2/117.7565cff57c39318a.js +10 -0
  4. package/dist/client-v2/214.106635011859dede.js +10 -0
  5. package/dist/client-v2/253.59577b40d9875be0.js +10 -0
  6. package/dist/client-v2/264.7ed8bee71fa5935c.js +10 -0
  7. package/dist/client-v2/{41.ba6e080cc0488143.js → 41.3deb9e57a0f64fc4.js} +1 -1
  8. package/dist/client-v2/418.41ed200e7d6da332.js +10 -0
  9. package/dist/client-v2/53.349fff8db80b19d4.js +10 -0
  10. package/dist/client-v2/619.0a2144aaffefe018.js +10 -0
  11. package/dist/client-v2/{70.bda9518881c05360.js → 70.ffff2997c10fd4b0.js} +1 -1
  12. package/dist/client-v2/{794.9bbb8d3a61b2bdf2.js → 794.a67a2614405ba627.js} +1 -1
  13. package/dist/client-v2/981.e4a1f41cfc94a856.js +10 -0
  14. package/dist/client-v2/{993.82778b6fd6db3cb1.js → 993.b0688fdc5ccb000a.js} +1 -1
  15. package/dist/client-v2/index.js +1 -1
  16. package/dist/externalVersion.js +8 -7
  17. package/dist/locale/en-US.json +199 -123
  18. package/dist/locale/vi-VN.json +199 -123
  19. package/dist/locale/zh-CN.json +199 -123
  20. package/dist/server/collections/agent-execution-spans.js +55 -0
  21. package/dist/server/collections/agent-harness-profile-versions.js +56 -0
  22. package/dist/server/collections/agent-harness-profiles.js +12 -0
  23. package/dist/server/collections/agent-loop-action-approvals.js +69 -0
  24. package/dist/server/collections/agent-loop-artifacts.js +55 -0
  25. package/dist/server/collections/agent-loop-circuit-states.js +53 -0
  26. package/dist/server/collections/agent-loop-control-settings.js +51 -0
  27. package/dist/server/collections/agent-loop-events.js +27 -0
  28. package/dist/server/collections/agent-loop-path-locks.js +57 -0
  29. package/dist/server/collections/agent-loop-patterns.js +72 -0
  30. package/dist/server/collections/agent-loop-runs.js +170 -3
  31. package/dist/server/collections/agent-loop-steps.js +76 -0
  32. package/dist/server/collections/agent-loop-usage-buckets.js +52 -0
  33. package/dist/server/collections/agent-loop-worktrees.js +55 -0
  34. package/dist/server/collections/skill-executions.js +8 -0
  35. package/dist/server/migrations/{20260427000000-change-packages-to-text.js → 20260427000002-change-packages-to-text.js} +2 -0
  36. package/dist/server/migrations/20260429000000-add-llm-fields.js +3 -2
  37. package/dist/server/migrations/{20260429000000-fix-inputargs-json-to-text.js → 20260429000001-fix-inputargs-json-to-text.js} +14 -6
  38. package/dist/server/migrations/20260503000000-add-orchestrator-trace-fields.js +2 -1
  39. package/dist/server/migrations/20260524000000-add-agent-loop-fields-to-skill-executions.js +2 -1
  40. package/dist/server/migrations/20260803010000-backfill-loop-control-plane-data.js +262 -0
  41. package/dist/server/plugin.js +54 -150
  42. package/dist/server/resources/agent-harness-profile.js +117 -0
  43. package/dist/server/resources/agent-knowledge-insights.js +1 -3
  44. package/dist/server/resources/agent-loop-approval.js +108 -0
  45. package/dist/server/resources/agent-loop-artifact.js +86 -0
  46. package/dist/server/resources/agent-loop-events-stream.js +130 -0
  47. package/dist/server/resources/agent-loop.js +183 -139
  48. package/dist/server/resources/resource-helpers.js +63 -0
  49. package/dist/server/resources/tracing.js +121 -107
  50. package/dist/server/services/AgentMemoryContextService.js +34 -0
  51. package/dist/server/services/DurableCircuitBreakerService.js +229 -0
  52. package/dist/server/services/HarnessCompiler.js +175 -0
  53. package/dist/server/services/HarnessProfileService.js +233 -0
  54. package/dist/server/services/HarnessSchema.js +194 -0
  55. package/dist/server/services/LoopBudgetService.js +269 -0
  56. package/dist/server/services/LoopControlService.js +139 -0
  57. package/dist/server/services/LoopPatternSchema.js +195 -0
  58. package/dist/server/services/LoopPatternService.js +132 -0
  59. package/dist/server/services/LoopRunRepository.js +285 -0
  60. package/dist/server/services/LoopRunStateMachine.js +478 -0
  61. package/dist/server/services/LoopSchedulerService.js +193 -0
  62. package/dist/server/services/LoopTriggerService.js +165 -0
  63. package/dist/server/services/LoopWorkerService.js +699 -0
  64. package/dist/server/services/NativeSubAgentObserver.js +165 -23
  65. package/dist/server/services/PathLockService.js +288 -0
  66. package/dist/server/services/PluginAiRuntimeAdapter.js +226 -0
  67. package/dist/server/services/ToolLoopDetectionService.js +210 -0
  68. package/dist/server/services/VerificationSchema.js +59 -0
  69. package/dist/server/services/VerificationService.js +235 -0
  70. package/dist/server/services/harness-runtime-policy.js +139 -0
  71. package/dist/server/skill-hub/actions/git-import.js +13 -7
  72. package/dist/server/skill-hub/plugin.js +36 -3
  73. package/dist/server/skill-hub/services/RegistrySkillSnapshotService.js +1 -5
  74. package/dist/server/skill-hub/tasks/SkillExecutionTask.js +29 -0
  75. package/dist/server/utils/ensure-indexes.js +111 -0
  76. package/dist/server/utils/loop-pattern-context.js +56 -0
  77. package/package.json +53 -53
  78. package/src/client/ApprovalsTab.tsx +2 -0
  79. package/src/client/OrchestratorSettings.tsx +55 -0
  80. package/src/client/skill-hub/components/GitSkillImport.tsx +3 -3
  81. package/src/client/skill-hub/components/SkillMetrics.tsx +15 -10
  82. package/src/client/skill-hub/index.tsx +0 -52
  83. package/src/client-v2/components/AgentRunsTab.tsx +100 -18
  84. package/src/client-v2/components/ApprovalsTab.tsx +337 -0
  85. package/src/client-v2/components/HarnessProfilesTab.tsx +385 -100
  86. package/src/client-v2/components/MemoryInspectorTab.tsx +141 -125
  87. package/src/client-v2/components/TracingTab.tsx +160 -77
  88. package/src/client-v2/hooks/useApiRequest.ts +28 -8
  89. package/src/client-v2/pages/ApprovalsPage.tsx +10 -0
  90. package/src/client-v2/plugin.tsx +6 -6
  91. package/src/client-v2/skill-hub/components/SkillMetrics.tsx +11 -6
  92. package/src/locale/en-US.json +199 -123
  93. package/src/locale/vi-VN.json +199 -123
  94. package/src/locale/zh-CN.json +199 -123
  95. package/src/server/__tests__/circuit-breaker.test.ts +248 -169
  96. package/src/server/__tests__/harness-compiler.test.ts +214 -0
  97. package/src/server/__tests__/harness-profile-service.test.ts +167 -0
  98. package/src/server/__tests__/harness-runtime-policy.test.ts +293 -0
  99. package/src/server/__tests__/harness-tool-plan.test.ts +172 -0
  100. package/src/server/__tests__/loop-approval-decision.test.ts +512 -0
  101. package/src/server/__tests__/loop-approval-expiry.test.ts +258 -0
  102. package/src/server/__tests__/loop-budget-service.test.ts +255 -0
  103. package/src/server/__tests__/loop-control-plane-backfill.test.ts +266 -0
  104. package/src/server/__tests__/loop-pattern-schema.test.ts +73 -0
  105. package/src/server/__tests__/loop-pattern-service.test.ts +148 -0
  106. package/src/server/__tests__/loop-run-state-machine.test.ts +101 -0
  107. package/src/server/__tests__/loop-trigger-service.test.ts +148 -0
  108. package/src/server/__tests__/loop-worker-claim.test.ts +341 -0
  109. package/src/server/__tests__/loop-worker-execution.test.ts +317 -0
  110. package/src/server/__tests__/native-sub-agent-observer.test.ts +288 -4
  111. package/src/server/__tests__/path-lock-service.test.ts +254 -0
  112. package/src/server/__tests__/skill-execution-task-policy.test.ts +140 -0
  113. package/src/server/__tests__/smoke.test.ts +162 -121
  114. package/src/server/__tests__/tool-loop-detection.test.ts +275 -0
  115. package/src/server/collections/agent-execution-spans.ts +55 -0
  116. package/src/server/collections/agent-harness-profile-versions.ts +26 -0
  117. package/src/server/collections/agent-harness-profiles.ts +71 -59
  118. package/src/server/collections/agent-loop-action-approvals.ts +39 -0
  119. package/src/server/collections/agent-loop-artifacts.ts +25 -0
  120. package/src/server/collections/agent-loop-circuit-states.ts +23 -0
  121. package/src/server/collections/agent-loop-control-settings.ts +21 -0
  122. package/src/server/collections/agent-loop-events.ts +98 -71
  123. package/src/server/collections/agent-loop-path-locks.ts +27 -0
  124. package/src/server/collections/agent-loop-patterns.ts +42 -0
  125. package/src/server/collections/agent-loop-runs.ts +170 -3
  126. package/src/server/collections/agent-loop-steps.ts +76 -0
  127. package/src/server/collections/agent-loop-usage-buckets.ts +22 -0
  128. package/src/server/collections/agent-loop-worktrees.ts +25 -0
  129. package/src/server/collections/skill-executions.ts +8 -0
  130. package/src/server/migrations/{20260427000000-change-packages-to-text.ts → 20260427000002-change-packages-to-text.ts} +52 -49
  131. package/src/server/migrations/20260429000000-add-llm-fields.ts +47 -46
  132. package/src/server/migrations/{20260429000000-fix-inputargs-json-to-text.ts → 20260429000001-fix-inputargs-json-to-text.ts} +45 -38
  133. package/src/server/migrations/20260503000000-add-orchestrator-trace-fields.ts +33 -32
  134. package/src/server/migrations/20260524000000-add-agent-loop-fields-to-skill-executions.ts +31 -30
  135. package/src/server/migrations/20260803010000-backfill-loop-control-plane-data.ts +293 -0
  136. package/src/server/plugin.ts +55 -167
  137. package/src/server/resources/agent-harness-profile.ts +94 -0
  138. package/src/server/resources/agent-knowledge-insights.ts +5 -3
  139. package/src/server/resources/agent-loop-approval.ts +84 -0
  140. package/src/server/resources/agent-loop-artifact.ts +56 -0
  141. package/src/server/resources/agent-loop-events-stream.ts +105 -0
  142. package/src/server/resources/agent-loop.ts +204 -143
  143. package/src/server/resources/agent-monitor.ts +482 -482
  144. package/src/server/resources/resource-helpers.ts +33 -0
  145. package/src/server/resources/tracing.ts +266 -258
  146. package/src/server/services/AgentMemoryContextService.ts +44 -0
  147. package/src/server/services/DurableCircuitBreakerService.ts +239 -0
  148. package/src/server/services/ExecutionSpanService.ts +2 -0
  149. package/src/server/services/HarnessCompiler.ts +170 -0
  150. package/src/server/services/HarnessProfileService.ts +239 -0
  151. package/src/server/services/HarnessSchema.ts +194 -0
  152. package/src/server/services/LoopBudgetService.ts +275 -0
  153. package/src/server/services/LoopControlService.ts +124 -0
  154. package/src/server/services/LoopPatternSchema.ts +185 -0
  155. package/src/server/services/LoopPatternService.ts +143 -0
  156. package/src/server/services/LoopRunRepository.ts +336 -0
  157. package/src/server/services/LoopRunStateMachine.ts +529 -0
  158. package/src/server/services/LoopSchedulerService.ts +199 -0
  159. package/src/server/services/LoopTriggerService.ts +157 -0
  160. package/src/server/services/LoopWorkerService.ts +822 -0
  161. package/src/server/services/NativeSubAgentObserver.ts +186 -21
  162. package/src/server/services/PathLockService.ts +321 -0
  163. package/src/server/services/PluginAiRuntimeAdapter.ts +332 -0
  164. package/src/server/services/ToolLoopDetectionService.ts +213 -0
  165. package/src/server/services/VerificationSchema.ts +31 -0
  166. package/src/server/services/VerificationService.ts +264 -0
  167. package/src/server/services/harness-runtime-policy.ts +141 -0
  168. package/src/server/skill-hub/actions/__tests__/git-import.test.ts +15 -1
  169. package/src/server/skill-hub/actions/git-import.ts +9 -3
  170. package/src/server/skill-hub/plugin.ts +41 -3
  171. package/src/server/skill-hub/services/RegistrySkillSnapshotService.ts +235 -239
  172. package/src/server/skill-hub/services/__tests__/RegistrySkillSnapshotService.test.ts +61 -63
  173. package/src/server/skill-hub/tasks/SkillExecutionTask.ts +43 -2
  174. package/src/server/utils/ensure-indexes.ts +96 -0
  175. package/src/server/utils/logging.ts +62 -63
  176. package/src/server/utils/loop-pattern-context.ts +20 -0
  177. package/dist/client-v2/214.79650a549273f163.js +0 -10
  178. package/dist/client-v2/253.9f0537713cee9e6c.js +0 -10
  179. package/dist/client-v2/264.718a107e43fc163c.js +0 -10
  180. package/dist/client-v2/373.f5d5292e53c4e832.js +0 -10
  181. package/dist/client-v2/418.ce8f5b2b8a229d1d.js +0 -10
  182. package/dist/client-v2/53.7c29c28043e9112d.js +0 -10
  183. package/dist/client-v2/619.bd3c5698b40705c3.js +0 -10
  184. package/dist/client-v2/677.a991ce0250ff5c77.js +0 -10
  185. package/dist/client-v2/925.f5370de8f6632d65.js +0 -10
  186. package/dist/server/services/AgentHarness.js +0 -81
  187. package/dist/server/services/AgentLoopController.js +0 -1023
  188. package/dist/server/services/AgentLoopRepository.js +0 -192
  189. package/dist/server/services/AgentLoopService.js +0 -142
  190. package/dist/server/services/AgentPlanValidator.js +0 -99
  191. package/dist/server/services/AgentPlannerService.js +0 -99
  192. package/dist/server/services/CircuitBreaker.js +0 -125
  193. package/dist/server/services/ContextAggregator.js +0 -201
  194. package/dist/server/services/PlanningPromptService.js +0 -95
  195. package/dist/server/tools/agent-loop.js +0 -373
  196. package/dist/server/tools/orchestrator-plan.js +0 -254
  197. package/src/client/AIEmployeeSelect.tsx +0 -47
  198. package/src/client/AIEmployeesContext.tsx +0 -102
  199. package/src/client/RulesTab.tsx +0 -2
  200. package/src/client/TracingTab.tsx +0 -436
  201. package/src/client/skill-hub/components/ExecutionProgress.tsx +0 -51
  202. package/src/client-v2/components/RulesTab.tsx +0 -2
  203. package/src/client-v2/pages/AgentRunsPage.tsx +0 -13
  204. package/src/server/__tests__/agent-loop-controller.test.ts +0 -375
  205. package/src/server/__tests__/context-aggregator.test.ts +0 -222
  206. package/src/server/__tests__/parallel-execution.test.ts +0 -318
  207. package/src/server/__tests__/planning-prompt-service.test.ts +0 -23
  208. package/src/server/services/AgentHarness.ts +0 -67
  209. package/src/server/services/AgentLoopController.ts +0 -1263
  210. package/src/server/services/AgentLoopRepository.ts +0 -178
  211. package/src/server/services/AgentLoopService.ts +0 -177
  212. package/src/server/services/AgentPlanValidator.ts +0 -73
  213. package/src/server/services/AgentPlannerService.ts +0 -80
  214. package/src/server/services/CircuitBreaker.ts +0 -126
  215. package/src/server/services/ContextAggregator.ts +0 -239
  216. package/src/server/services/PlanningPromptService.ts +0 -72
  217. package/src/server/tools/agent-loop.ts +0 -360
  218. package/src/server/tools/orchestrator-plan.ts +0 -255
@@ -0,0 +1,293 @@
1
+ import { Migration } from '@nocobase/server';
2
+ import { validateHarnessSettings } from '../services/HarnessSchema';
3
+ import { loopPatternPolicySchema } from '../services/LoopPatternSchema';
4
+ import { ensureAgentOrchestratorIndexes } from '../utils/ensure-indexes';
5
+
6
+ type MigrationRecord = Record<string, unknown> & {
7
+ get?: (key: string) => unknown;
8
+ toJSON?: () => Record<string, unknown>;
9
+ };
10
+
11
+ type MigrationRepository = {
12
+ find(options?: Record<string, unknown>): Promise<MigrationRecord[]>;
13
+ findOne(options: Record<string, unknown>): Promise<MigrationRecord | null>;
14
+ create(options: Record<string, unknown>): Promise<MigrationRecord>;
15
+ update(options: Record<string, unknown>): Promise<unknown>;
16
+ };
17
+
18
+ type MigrationDatabase = {
19
+ getRepository(name: string): MigrationRepository | undefined;
20
+ sequelize: {
21
+ transaction<T>(callback: (transaction: unknown) => Promise<T>): Promise<T>;
22
+ };
23
+ };
24
+
25
+ const LEGACY_TERMINAL_STATUSES = new Set(['succeeded', 'failed', 'rejected', 'canceled']);
26
+ const CONTROL_PLANE_STATUSES = new Set([
27
+ 'queued',
28
+ 'preparing',
29
+ 'waiting_lock',
30
+ 'running',
31
+ 'waiting_approval',
32
+ 'verifying',
33
+ 'waiting_human',
34
+ 'paused',
35
+ 'blocked',
36
+ 'succeeded',
37
+ 'failed',
38
+ 'canceled',
39
+ ]);
40
+ const LEGACY_PLAN_STATUSES = new Set([
41
+ 'planning',
42
+ 'waiting_plan_approval',
43
+ 'approved',
44
+ 'waiting_user',
45
+ 'needs_replan',
46
+ 'rejected',
47
+ ]);
48
+
49
+ const BACKFILL_BATCH_SIZE = 500;
50
+
51
+ async function* iterateInBatches(
52
+ repository: MigrationRepository,
53
+ options: Record<string, unknown> = {},
54
+ ): AsyncGenerator<MigrationRecord> {
55
+ let page = 1;
56
+ for (;;) {
57
+ const batch = await repository.find({ ...options, sort: ['id'], page, pageSize: BACKFILL_BATCH_SIZE });
58
+ if (!batch.length) return;
59
+ for (const record of batch) {
60
+ yield record;
61
+ }
62
+ if (batch.length < BACKFILL_BATCH_SIZE) return;
63
+ page += 1;
64
+ }
65
+ }
66
+
67
+ function readValue(record: MigrationRecord, key: string) {
68
+ return typeof record.get === 'function' ? record.get(key) : record[key];
69
+ }
70
+
71
+ function asObject(value: unknown): Record<string, unknown> {
72
+ return value && typeof value === 'object' && !Array.isArray(value) ? (value as Record<string, unknown>) : {};
73
+ }
74
+
75
+ function positiveInteger(value: unknown) {
76
+ const parsed = typeof value === 'number' ? value : Number(value);
77
+ return Number.isSafeInteger(parsed) && parsed > 0 ? parsed : null;
78
+ }
79
+
80
+ function stringValue(value: unknown) {
81
+ return typeof value === 'string' ? value : '';
82
+ }
83
+
84
+ function isPublishedValidVersion(version: MigrationRecord) {
85
+ return (
86
+ readValue(version, 'status') === 'published' && validateHarnessSettings(readValue(version, 'settings')).success
87
+ );
88
+ }
89
+
90
+ async function backfillHarnessProfiles(db: MigrationDatabase) {
91
+ const profiles = db.getRepository('agentHarnessProfiles');
92
+ const versions = db.getRepository('agentHarnessProfileVersions');
93
+ if (!profiles || !versions) return;
94
+
95
+ for await (const profile of iterateInBatches(profiles)) {
96
+ const profileId = positiveInteger(readValue(profile, 'id'));
97
+ if (!profileId) continue;
98
+
99
+ await db.sequelize.transaction(async (transaction) => {
100
+ const allVersions = await versions.find({ filter: { profileId }, sort: ['-version'], transaction });
101
+ const currentVersionId = positiveInteger(readValue(profile, 'currentVersionId'));
102
+ const current = currentVersionId ? await versions.findOne({ filterByTk: currentVersionId, transaction }) : null;
103
+ if (current && isPublishedValidVersion(current)) return;
104
+
105
+ const published = allVersions.find(isPublishedValidVersion);
106
+ if (published) {
107
+ const publishedId = positiveInteger(readValue(published, 'id'));
108
+ if (publishedId && currentVersionId !== publishedId) {
109
+ await profiles.update({
110
+ filterByTk: profileId,
111
+ values: { currentVersionId: publishedId },
112
+ transaction,
113
+ });
114
+ }
115
+ return;
116
+ }
117
+
118
+ const settingsResult = validateHarnessSettings(readValue(profile, 'settings'));
119
+ if (!settingsResult.success) return;
120
+ const settings = settingsResult.data;
121
+ const nextVersion =
122
+ allVersions.reduce((maximum, version) => Math.max(maximum, Number(readValue(version, 'version')) || 0), 0) + 1;
123
+ const version = await versions.create({
124
+ values: {
125
+ profileId,
126
+ version: nextVersion,
127
+ schemaVersion: positiveInteger(readValue(profile, 'schemaVersion')) || 1,
128
+ status: 'published',
129
+ settings,
130
+ publishedAt: readValue(profile, 'updatedAt') || readValue(profile, 'createdAt') || new Date(),
131
+ },
132
+ transaction,
133
+ });
134
+ const versionId = positiveInteger(readValue(version, 'id'));
135
+ if (versionId) {
136
+ await profiles.update({
137
+ filterByTk: profileId,
138
+ values: { currentVersionId: versionId },
139
+ transaction,
140
+ });
141
+ }
142
+ });
143
+ }
144
+ }
145
+
146
+ function hasLegacyPlanFields(run: MigrationRecord, status: string) {
147
+ const metadata = asObject(readValue(run, 'metadata'));
148
+ return (
149
+ LEGACY_PLAN_STATUSES.has(status) ||
150
+ Boolean(stringValue(readValue(run, 'planSource')).trim()) ||
151
+ Boolean(stringValue(readValue(run, 'plannerModel')).trim()) ||
152
+ Boolean(stringValue(metadata.planSource).trim()) ||
153
+ Boolean(stringValue(metadata.plannerModel).trim()) ||
154
+ Boolean(stringValue(metadata.approvalMode).trim())
155
+ );
156
+ }
157
+
158
+ function isValidControlPlaneRun(run: MigrationRecord) {
159
+ const runtimeVersion = stringValue(readValue(run, 'runtimeVersion'));
160
+ const status = stringValue(readValue(run, 'status'));
161
+ const patternId = positiveInteger(readValue(run, 'patternId'));
162
+ return (
163
+ runtimeVersion === 'control-plane-v2' &&
164
+ CONTROL_PLANE_STATUSES.has(status) &&
165
+ !hasLegacyPlanFields(run, status) &&
166
+ patternId !== null &&
167
+ loopPatternPolicySchema.safeParse(readValue(run, 'policySnapshot')).success
168
+ );
169
+ }
170
+
171
+ async function backfillLegacyRuns(db: MigrationDatabase) {
172
+ const runs = db.getRepository('agentLoopRuns');
173
+ const steps = db.getRepository('agentLoopSteps');
174
+ const events = db.getRepository('agentLoopEvents');
175
+ if (!runs || !steps || !events) return;
176
+
177
+ for await (const run of iterateInBatches(runs)) {
178
+ const runId = positiveInteger(readValue(run, 'id'));
179
+ if (!runId || isValidControlPlaneRun(run)) continue;
180
+
181
+ const metadata = asObject(readValue(run, 'metadata'));
182
+ const statusValue = stringValue(readValue(run, 'status'));
183
+ const preservedLegacyStatus = stringValue(metadata.legacyStatus);
184
+ const legacyStatus = preservedLegacyStatus || statusValue || 'unknown';
185
+ const isTerminal = LEGACY_TERMINAL_STATUSES.has(legacyStatus);
186
+ const correlationKey = `legacy-runtime-retired:${runId}`;
187
+ if (readValue(run, 'runtimeVersion') === 'legacy-plan-v1' && metadata.legacyRuntimeRetired === true) continue;
188
+
189
+ await db.sequelize.transaction(async (transaction) => {
190
+ await runs.update({
191
+ filterByTk: runId,
192
+ values: {
193
+ runtimeVersion: 'legacy-plan-v1',
194
+ recordMode: 'legacy-plan',
195
+ ...(isTerminal
196
+ ? {}
197
+ : {
198
+ status: 'blocked',
199
+ blockedReason: 'The legacy plan runtime was retired. This historical run is read-only.',
200
+ lockedBy: null,
201
+ lockedUntil: null,
202
+ }),
203
+ metadata: {
204
+ ...metadata,
205
+ legacyStatus,
206
+ legacyRuntimeRetired: true,
207
+ },
208
+ },
209
+ transaction,
210
+ });
211
+ await steps.update({
212
+ filter: { runId },
213
+ values: { runtimeVersion: 'legacy-plan-v1' },
214
+ transaction,
215
+ });
216
+
217
+ if (!isTerminal) {
218
+ const existingEvent = await events.findOne({
219
+ filter: { runId, type: 'legacy_runtime_retired', correlationKey },
220
+ transaction,
221
+ });
222
+ if (!existingEvent) {
223
+ await events.create({
224
+ values: {
225
+ runId,
226
+ type: 'legacy_runtime_retired',
227
+ title: 'Legacy runtime retired',
228
+ content: 'The nonterminal plan-era run was blocked during the Loop Control Plane cutover.',
229
+ status: 'blocked',
230
+ payload: { legacyStatus },
231
+ actorType: 'system',
232
+ actorIdentity: 'loop-control-plane-migration',
233
+ correlationKey,
234
+ createdAt: new Date(),
235
+ },
236
+ transaction,
237
+ });
238
+ }
239
+ }
240
+ });
241
+ }
242
+ }
243
+
244
+ async function backfillSpanRunLinks(db: MigrationDatabase) {
245
+ const spans = db.getRepository('agentExecutionSpans');
246
+ if (!spans) return;
247
+
248
+ for await (const span of iterateInBatches(spans)) {
249
+ if (positiveInteger(readValue(span, 'agentLoopRunId'))) continue;
250
+ const runId = positiveInteger(asObject(readValue(span, 'metadata')).agentLoopRunId);
251
+ const spanId = positiveInteger(readValue(span, 'id'));
252
+ if (!runId || !spanId) continue;
253
+
254
+ await spans.update({
255
+ filterByTk: spanId,
256
+ values: { agentLoopRunId: runId },
257
+ });
258
+ }
259
+ }
260
+
261
+ async function ensureGlobalControl(db: MigrationDatabase) {
262
+ const controls = db.getRepository('agentLoopControlSettings');
263
+ if (!controls) return;
264
+ const existing = await controls.findOne({ filter: { key: 'global' } });
265
+ if (existing) return;
266
+ await controls.create({
267
+ values: {
268
+ key: 'global',
269
+ acceptNewRuns: true,
270
+ state: 'running',
271
+ globalMaxConcurrency: 5,
272
+ createdAt: new Date(),
273
+ updatedAt: new Date(),
274
+ },
275
+ });
276
+ }
277
+
278
+ export async function backfillLoopControlPlaneData(db: MigrationDatabase) {
279
+ await backfillHarnessProfiles(db);
280
+ await backfillLegacyRuns(db);
281
+ await backfillSpanRunLinks(db);
282
+ await ensureGlobalControl(db);
283
+ }
284
+
285
+ export default class BackfillLoopControlPlaneData extends Migration {
286
+ on = 'afterLoad';
287
+ appVersion = '>=0.1.0';
288
+
289
+ async up() {
290
+ await backfillLoopControlPlaneData(this.db as unknown as MigrationDatabase);
291
+ await ensureAgentOrchestratorIndexes(this.db);
292
+ }
293
+ }
@@ -4,19 +4,26 @@ import { createExternalRagSearchTool } from './tools/external-rag-search';
4
4
  import { registerTracingResource } from './resources/tracing';
5
5
  import { registerAgentMonitorResource } from './resources/agent-monitor';
6
6
  import { registerAgentLoopResource } from './resources/agent-loop';
7
+ import { registerAgentLoopApprovalResource } from './resources/agent-loop-approval';
8
+ import { registerAgentHarnessProfileResource } from './resources/agent-harness-profile';
9
+ import { registerAgentLoopArtifactResource } from './resources/agent-loop-artifact';
10
+ import { registerAgentLoopEventsStreamResource } from './resources/agent-loop-events-stream';
7
11
  import { registerAgentKnowledgeInsightsResource } from './resources/agent-knowledge-insights';
8
12
  import SkillHubSubFeature from './skill-hub/plugin';
9
13
  import { NativeSubAgentObserver } from './services/NativeSubAgentObserver';
10
14
  import { RegistrySkillSnapshotService } from './skill-hub/services/RegistrySkillSnapshotService';
11
15
  import { RegistrySkillInstallationService } from './skill-hub/services/RegistrySkillInstallationService';
12
- import { AgentLoopService } from './services/AgentLoopService';
13
- import { createAgentLoopTools } from './tools/agent-loop';
14
- import { PlanningPromptService } from './services/PlanningPromptService';
16
+ import { LoopPatternService } from './services/LoopPatternService';
17
+ import { LoopSchedulerService } from './services/LoopSchedulerService';
18
+ import { LoopTriggerService } from './services/LoopTriggerService';
19
+ import { LoopWorkerService } from './services/LoopWorkerService';
15
20
  import { asObject, isAdminUser, currentUserId } from './utils/ctx-utils';
21
+ import { employeeHarnessResolver, worktreeCapability } from './utils/loop-pattern-context';
16
22
  import { getAIToolsManager } from './utils/ai-manager';
17
23
  import { AgentRuntimeLifecycle } from './services/AgentRuntimeLifecycle';
18
24
  import { validateInputSchemaDefinition } from './services/InputSchemaValidator';
19
25
  import { assertSkillToolNameAvailable, buildSkillToolName, getSkillToolName } from './utils/skill-tool-name';
26
+ import { ensureAgentOrchestratorIndexes } from './utils/ensure-indexes';
20
27
 
21
28
  function normalizeOptionalString(value: unknown) {
22
29
  return typeof value === 'string' ? value.trim() : '';
@@ -164,6 +171,8 @@ export class PluginAgentOrchestratorServer extends Plugin {
164
171
  registrySkillInstallationService: RegistrySkillInstallationService;
165
172
  nativeObserver: NativeSubAgentObserver;
166
173
  agentRuntimeLifecycle: AgentRuntimeLifecycle;
174
+ loopScheduler: LoopSchedulerService;
175
+ loopWorker: LoopWorkerService;
167
176
  private readonly installNativeObserver = () => {
168
177
  this.nativeObserver?.install();
169
178
  };
@@ -234,7 +243,16 @@ export class PluginAgentOrchestratorServer extends Plugin {
234
243
  this.app.acl.allow('skillHub', 'download', 'loggedIn');
235
244
  this.app.acl.allow('skillHub', 'listTemplates', 'loggedIn');
236
245
  this.app.acl.allow('agentMonitor', ['list', 'get'], 'loggedIn');
237
- this.app.acl.allow('agentLoops', ['list', 'get'], 'loggedIn');
246
+ // ACL runs before the resource handler, so every owner-facing loop action must be listed
247
+ // here; ownership itself is enforced inside each handler by LoopRunRepository.
248
+ this.app.acl.allow(
249
+ 'agentLoops',
250
+ ['list', 'get', 'runNow', 'pause', 'resume', 'cancel', 'retry', 'escalate', 'acceptResult', 'status'],
251
+ 'loggedIn',
252
+ );
253
+ this.app.acl.allow('agentLoopApprovals', ['list', 'get', 'decide'], 'loggedIn');
254
+ this.app.acl.allow('agentLoopArtifactsView', ['list', 'get'], 'loggedIn');
255
+ this.app.acl.allow('agentLoopEventsStream', ['stream'], 'loggedIn');
238
256
 
239
257
  // Data scoping for skillExecutions: a logged-in non-admin user may only
240
258
  // read their own executions. Rows hold inputArgs / stdout / output files,
@@ -333,69 +351,28 @@ export class PluginAgentOrchestratorServer extends Plugin {
333
351
  { tag: 'orchestrator-agent-memory-context-policy', after: 'acl' },
334
352
  );
335
353
 
336
- // --- Planning Prompt Injection ---
337
- // When a user message contains plan-related keywords, prepend planning
338
- // instructions so the AI agent creates a plan via agent_loop_start before
339
- // executing.
340
- const planningPrompt = new PlanningPromptService();
341
- this.agentRuntimeLifecycle.registerBeforeRunHook('orchestrator-planning', (context) => {
342
- if (planningPrompt.applyPlanningContext(context.messages)) {
343
- context.metadata.planningPromptInjected = true;
344
- }
345
- });
346
- this.app.resourceManager.use(
347
- async (ctx, next) => {
348
- const { resourceName, actionName } = ctx.action || {};
349
- if (resourceName === 'aiConversations' && actionName === 'sendMessages') {
350
- const values = ctx.action.params.values || {};
351
- const messages = values.messages;
352
- if (Array.isArray(messages)) {
353
- const runtimeContext = {
354
- ctx,
355
- source: 'chat-ui' as const,
356
- employee: undefined,
357
- sessionId: String(ctx.state?.sessionId || ''),
358
- userId: currentUserId(ctx),
359
- messages,
360
- metadata: {},
361
- };
362
- await this.agentRuntimeLifecycle.runBeforeHooks(runtimeContext);
363
- ctx.state.agentRuntimeContext = runtimeContext;
364
- }
365
- }
366
- const runtimeContext = ctx.state?.agentRuntimeContext;
367
- try {
368
- await next();
369
- if (runtimeContext) {
370
- await this.agentRuntimeLifecycle.runAfterHooks(runtimeContext, {
371
- succeeded: ctx.status < 400,
372
- value: ctx.body,
373
- });
374
- }
375
- } catch (error) {
376
- if (runtimeContext) {
377
- await this.agentRuntimeLifecycle.runAfterHooks(runtimeContext, {
378
- succeeded: false,
379
- error: error instanceof Error ? error : new Error(String(error)),
380
- });
381
- }
382
- throw error;
383
- }
384
- },
385
- { tag: 'orchestrator-planning-prompt', after: 'acl' },
386
- );
387
-
388
354
  // --- Register External Tool Only ---
389
- // Native @nocobase/plugin-ai owns sub-agent dispatch. The orchestrator no
390
- // longer registers delegate_* / dispatch_subagents_* tools or controller
391
- // plan tools; Skill Hub still registers its own AI tools from its subfeature.
355
+ // Native @nocobase/plugin-ai owns reasoning, planning/replanning and sub-agent dispatch.
356
+ // The orchestrator no longer injects planning prompts or registers self-state AI tools; it
357
+ // drives work through the Loop Control Plane (trigger → durable run → worker → verifier).
392
358
  const toolsManager = getAIToolsManager(this.app);
393
359
  toolsManager.registerTools(createExternalRagSearchTool(this));
394
360
 
395
- // --- Register Agent Loop Tools & Resource ---
396
- const agentLoopService = new AgentLoopService(this);
397
- toolsManager.registerTools(createAgentLoopTools(this, agentLoopService));
398
- registerAgentLoopResource(this, agentLoopService);
361
+ // --- Loop Control Plane runtime ---
362
+ const patterns = new LoopPatternService(this.db, employeeHarnessResolver(this), async () =>
363
+ worktreeCapability(this),
364
+ );
365
+ const triggers = new LoopTriggerService(this.db, patterns);
366
+ this.loopScheduler = new LoopSchedulerService(this, patterns, triggers);
367
+ this.loopWorker = new LoopWorkerService(this.app, this.db);
368
+ this.loopScheduler.install();
369
+ this.app.on?.('afterStart', this.startLoopWorker);
370
+
371
+ registerAgentLoopResource(this);
372
+ registerAgentLoopApprovalResource(this);
373
+ registerAgentLoopArtifactResource(this);
374
+ registerAgentLoopEventsStreamResource(this);
375
+ registerAgentHarnessProfileResource(this);
399
376
 
400
377
  // --- Native plugin-ai Monitor Resource ---
401
378
  registerAgentMonitorResource(this);
@@ -403,11 +380,6 @@ export class PluginAgentOrchestratorServer extends Plugin {
403
380
  this.installNativeObserver();
404
381
  this.app.on?.('afterStart', this.installNativeObserver);
405
382
 
406
- // --- Crash Recovery ---
407
- // On startup, scan for steps/runs left in "running" state from a previous
408
- // crash and reset them so they can be retried.
409
- this.app.on?.('afterStart', this.recoverAfterCrash);
410
-
411
383
  // --- Register Tracing Resource (Phase 5) ---
412
384
  // Custom read-only resource for the Swarm Tracing admin page.
413
385
  registerTracingResource(this);
@@ -448,6 +420,11 @@ export class PluginAgentOrchestratorServer extends Plugin {
448
420
 
449
421
  async install() {
450
422
  await this.skillHub.install();
423
+ await ensureAgentOrchestratorIndexes(this.db);
424
+ }
425
+
426
+ async upgrade() {
427
+ await ensureAgentOrchestratorIndexes(this.db);
451
428
  }
452
429
 
453
430
  async afterEnable() {}
@@ -459,110 +436,21 @@ export class PluginAgentOrchestratorServer extends Plugin {
459
436
  async beforeStop() {
460
437
  this.app.off?.('afterStart', this.installNativeObserver);
461
438
  this.app.removeListener?.('afterStart', this.installNativeObserver);
462
- this.app.off?.('afterStart', this.recoverAfterCrash);
463
- this.app.removeListener?.('afterStart', this.recoverAfterCrash);
439
+ this.app.off?.('afterStart', this.startLoopWorker);
440
+ this.app.removeListener?.('afterStart', this.startLoopWorker);
441
+ await this.loopWorker?.stop();
442
+ await this.loopScheduler?.dispose();
464
443
  this.nativeObserver?.uninstall();
465
444
  await this.skillHub.beforeStop();
466
445
  }
467
446
 
468
- // --- Crash Recovery ---
469
- // Scans for agentLoopSteps stuck in "running" status from a previous crash
470
- // and resets them to "pending". Also cleans up orphaned agentLoopRuns where
471
- // all steps have reached terminal states but the run itself wasn't finalized.
472
- private readonly recoverAfterCrash = async () => {
473
- const timeoutMs = Number(process.env.ORCHESTRATOR_CRASH_RECOVERY_TIMEOUT_MS || 600000); // 10 min default
474
- const cutoff = new Date(Date.now() - timeoutMs);
475
-
476
- try {
477
- const stepsRepo = this.db.getRepository('agentLoopSteps');
478
- const runsRepo = this.db.getRepository('agentLoopRuns');
479
-
480
- // 1. Reset stale running steps back to pending
481
- if (stepsRepo) {
482
- const staleSteps = await stepsRepo.find({
483
- filter: {
484
- status: 'running',
485
- startedAt: { $lt: cutoff.toISOString() },
486
- },
487
- });
488
-
489
- for (const step of staleSteps) {
490
- const stepId = readModelValue(step, 'id');
491
- const runId = readModelValue(step, 'runId');
492
- await stepsRepo.update({
493
- filterByTk: stepId,
494
- values: {
495
- status: 'pending',
496
- startedAt: null,
497
- error: `Recovered after crash at ${new Date().toISOString()}`,
498
- },
499
- });
500
- this.app.logger?.warn?.(
501
- `[AgentOrchestrator] Crash recovery: reset step ${stepId} (run ${runId}) from running to pending`,
502
- );
503
- }
504
-
505
- if (staleSteps.length > 0) {
506
- this.app.logger?.info?.(
507
- `[AgentOrchestrator] Crash recovery: reset ${staleSteps.length} stale running step(s)`,
508
- );
509
- }
510
- }
511
-
512
- // 2. Finalize orphaned runs — runs marked "running" where all steps are terminal
513
- if (runsRepo) {
514
- const runningRuns = await runsRepo.find({
515
- filter: { status: 'running' },
516
- });
517
-
518
- for (const run of runningRuns) {
519
- const runId = readModelValue(run, 'id');
520
- const steps = await stepsRepo?.find({
521
- filter: { runId },
522
- });
523
-
524
- if (!steps || steps.length === 0) {
525
- // No steps at all — orphaned, mark as failed
526
- await runsRepo.update({
527
- filterByTk: runId,
528
- values: {
529
- status: 'failed',
530
- endedAt: new Date(),
531
- summary: 'Run was orphaned after server crash (no steps found).',
532
- },
533
- });
534
- this.app.logger?.warn?.(
535
- `[AgentOrchestrator] Crash recovery: marked orphaned run ${runId} as failed (no steps)`,
536
- );
537
- continue;
538
- }
539
-
540
- const allTerminal = steps.every((s: any) => {
541
- const st = readModelValue(s, 'status');
542
- return st === 'succeeded' || st === 'failed' || st === 'skipped';
543
- });
544
-
545
- if (!allTerminal) continue;
546
-
547
- const anyFailed = steps.some((s: any) => readModelValue(s, 'status') === 'failed');
548
- const finalStatus = anyFailed ? 'failed' : 'succeeded';
447
+ async handleSyncMessage(message: unknown) {
448
+ await this.loopScheduler?.handleSyncMessage(message);
449
+ await this.loopWorker?.handleSyncMessage(message);
450
+ }
549
451
 
550
- await runsRepo.update({
551
- filterByTk: runId,
552
- values: {
553
- status: finalStatus,
554
- endedAt: new Date(),
555
- summary: `Run finalized as ${finalStatus} after server crash recovery.`,
556
- },
557
- });
558
- this.app.logger?.warn?.(
559
- `[AgentOrchestrator] Crash recovery: finalized orphaned run ${runId} as ${finalStatus}`,
560
- );
561
- }
562
- }
563
- } catch (error) {
564
- this.app.logger?.error?.('[AgentOrchestrator] Crash recovery scan failed', error);
565
- }
452
+ private readonly startLoopWorker = () => {
453
+ this.loopWorker?.start();
566
454
  };
567
455
  }
568
456
 
@@ -0,0 +1,94 @@
1
+ import type { Plugin } from '@nocobase/server';
2
+ import { HarnessProfileService } from '../services/HarnessProfileService';
3
+ import { valuesFromCtx } from '../utils/ctx-utils';
4
+ import { requestActor, throwResourceError } from './resource-helpers';
5
+
6
+ // Versioning surface for harness policy profiles. Draft/publish go through HarnessProfileService
7
+ // so the revision guards (validated settings, immutable published versions, row-locked version
8
+ // numbering) apply to HTTP callers exactly as they do to the loop compiler.
9
+ export function registerAgentHarnessProfileResource(plugin: Plugin) {
10
+ const service = new HarnessProfileService(plugin.db);
11
+
12
+ plugin.app.resource({
13
+ name: 'agentHarnessProfiles',
14
+ actions: {
15
+ async listVersions(ctx, next) {
16
+ try {
17
+ const profileId = ctx.action.params.filterByTk;
18
+ if (!profileId) ctx.throw(400, 'profile id is required');
19
+ const rows = await plugin.db.getRepository('agentHarnessProfileVersions').find({
20
+ filter: { profileId },
21
+ sort: ['-version'],
22
+ });
23
+ ctx.body = { data: rows };
24
+ } catch (error) {
25
+ throwResourceError(ctx, error);
26
+ }
27
+ await next();
28
+ },
29
+
30
+ async saveDraft(ctx, next) {
31
+ try {
32
+ const profileId = ctx.action.params.filterByTk;
33
+ if (!profileId) ctx.throw(400, 'profile id is required');
34
+ const values = valuesFromCtx(ctx);
35
+ ctx.body = {
36
+ data: await service.saveDraft({ profileId, settings: values.settings }),
37
+ };
38
+ } catch (error) {
39
+ throwResourceError(ctx, error);
40
+ }
41
+ await next();
42
+ },
43
+
44
+ async publish(ctx, next) {
45
+ try {
46
+ const actor = requestActor(ctx);
47
+ const values = valuesFromCtx(ctx);
48
+ const versionId = values.versionId ?? ctx.action.params.filterByTk;
49
+ if (!versionId) ctx.throw(400, 'version id is required');
50
+ ctx.body = {
51
+ data: await service.publish(versionId, actor.userId),
52
+ };
53
+ } catch (error) {
54
+ throwResourceError(ctx, error);
55
+ }
56
+ await next();
57
+ },
58
+
59
+ async createProfile(ctx, next) {
60
+ try {
61
+ const actor = requestActor(ctx);
62
+ const values = valuesFromCtx(ctx);
63
+ const result = await service.createProfile({
64
+ tag: typeof values.tag === 'string' ? values.tag : '',
65
+ title: typeof values.title === 'string' ? values.title : '',
66
+ description: typeof values.description === 'string' ? values.description : '',
67
+ enabled: values.enabled !== false,
68
+ settings: values.settings,
69
+ publishedById: actor.userId,
70
+ });
71
+ ctx.body = { data: result };
72
+ } catch (error) {
73
+ throwResourceError(ctx, error);
74
+ }
75
+ await next();
76
+ },
77
+
78
+ async validate(ctx, next) {
79
+ try {
80
+ const values = valuesFromCtx(ctx);
81
+ const result = service.validate(values.settings);
82
+ ctx.body = {
83
+ data: result.success
84
+ ? { success: true, issues: [] }
85
+ : { success: false, issues: result.error.issues.map((issue) => issue.message) },
86
+ };
87
+ } catch (error) {
88
+ throwResourceError(ctx, error);
89
+ }
90
+ await next();
91
+ },
92
+ },
93
+ });
94
+ }