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,199 @@
1
+ import type { Database, Model, Transaction } from '@nocobase/database';
2
+ import type { Application, Plugin } from '@nocobase/server';
3
+ import type { LoopPattern } from './LoopPatternSchema';
4
+ import { LoopPatternService } from './LoopPatternService';
5
+ import { LoopTriggerService } from './LoopTriggerService';
6
+
7
+ type ManagedCronJob = ReturnType<Application['cronJobManager']['addJob']>;
8
+
9
+ type ScheduledPattern = {
10
+ job: ManagedCronJob;
11
+ signature: string;
12
+ };
13
+
14
+ type TransactionOptions = {
15
+ transaction?: Transaction;
16
+ };
17
+
18
+ export type LoopSchedulerSyncMessage = {
19
+ type: 'loop-pattern-schedule-changed';
20
+ patternId: number;
21
+ };
22
+
23
+ function read(record: Model | Record<string, unknown>, key: string) {
24
+ const model = record as Model & { get?: (name: string) => unknown };
25
+ return typeof model.get === 'function' ? model.get(key) : (record as Record<string, unknown>)[key];
26
+ }
27
+
28
+ function positiveInteger(value: unknown) {
29
+ const parsed = Number(value);
30
+ return Number.isSafeInteger(parsed) && parsed > 0 ? parsed : null;
31
+ }
32
+
33
+ function isLockAcquireError(error: unknown) {
34
+ return error instanceof Error && error.constructor.name === 'LockAcquireError';
35
+ }
36
+
37
+ function tickDate(pattern: LoopPattern, now: Date) {
38
+ const fields = pattern.cronExpression?.split(/\s+/).filter(Boolean).length || 5;
39
+ const interval = fields === 6 ? 1_000 : 60_000;
40
+ return new Date(Math.floor(now.getTime() / interval) * interval);
41
+ }
42
+
43
+ export class LoopSchedulerService {
44
+ private readonly scheduled = new Map<number, ScheduledPattern>();
45
+ private started = false;
46
+ private installed = false;
47
+
48
+ constructor(
49
+ private readonly plugin: Plugin,
50
+ private readonly patterns: LoopPatternService,
51
+ private readonly triggers: LoopTriggerService,
52
+ ) {}
53
+
54
+ install() {
55
+ if (this.installed) return;
56
+ this.installed = true;
57
+ this.plugin.db.on('agentLoopPatterns.afterCreate', this.onPatternChanged);
58
+ this.plugin.db.on('agentLoopPatterns.afterUpdate', this.onPatternChanged);
59
+ this.plugin.db.on('agentLoopPatterns.afterDestroy', this.onPatternChanged);
60
+ this.plugin.app.on('afterStart', this.start);
61
+ }
62
+
63
+ async dispose() {
64
+ if (!this.installed) return;
65
+ this.installed = false;
66
+ this.plugin.db.off('agentLoopPatterns.afterCreate', this.onPatternChanged);
67
+ this.plugin.db.off('agentLoopPatterns.afterUpdate', this.onPatternChanged);
68
+ this.plugin.db.off('agentLoopPatterns.afterDestroy', this.onPatternChanged);
69
+ this.plugin.app.off('afterStart', this.start);
70
+ this.stop();
71
+ }
72
+
73
+ readonly start = async () => {
74
+ if (this.started) return;
75
+ this.started = true;
76
+ await this.resyncAll();
77
+ };
78
+
79
+ stop() {
80
+ this.started = false;
81
+ for (const { job } of this.scheduled.values()) this.plugin.app.cronJobManager.removeJob(job);
82
+ this.scheduled.clear();
83
+ }
84
+
85
+ async handleSyncMessage(message: unknown) {
86
+ if (!message || typeof message !== 'object') return;
87
+ const value = message as Partial<LoopSchedulerSyncMessage>;
88
+ if (value.type !== 'loop-pattern-schedule-changed') return;
89
+ const patternId = positiveInteger(value.patternId);
90
+ if (!patternId) return;
91
+ await this.resyncPattern(patternId);
92
+ }
93
+
94
+ async resyncAll() {
95
+ if (!this.started) return;
96
+ const records = await this.plugin.db.getRepository('agentLoopPatterns').find({ fields: ['id'] });
97
+ const patternIds = new Set<number>();
98
+ for (const record of records) {
99
+ const patternId = positiveInteger(read(record, 'id'));
100
+ if (!patternId) continue;
101
+ patternIds.add(patternId);
102
+ await this.resyncPattern(patternId);
103
+ }
104
+ for (const patternId of this.scheduled.keys()) {
105
+ if (!patternIds.has(patternId)) this.remove(patternId);
106
+ }
107
+ }
108
+
109
+ async resyncPattern(patternId: number) {
110
+ if (!this.started) return;
111
+ const record = await this.plugin.db.getRepository('agentLoopPatterns').findOne({ filterByTk: patternId });
112
+ if (!record || read(record, 'enabled') !== true || read(record, 'triggerType') !== 'cron') {
113
+ this.remove(patternId);
114
+ return;
115
+ }
116
+
117
+ try {
118
+ const { pattern } = await this.patterns.get(patternId);
119
+ const signature = JSON.stringify([pattern.cronExpression, pattern.timezone]);
120
+ if (this.scheduled.get(patternId)?.signature === signature) return;
121
+ this.remove(patternId);
122
+ const job = this.plugin.app.cronJobManager.addJob({
123
+ cronTime: pattern.cronExpression as string,
124
+ timeZone: pattern.timezone as string,
125
+ onTick: () => this.onTick(patternId, pattern).catch((error) => this.logTickError(patternId, error)),
126
+ });
127
+ this.scheduled.set(patternId, { job, signature });
128
+ if (this.plugin.app.cronJobManager.started) job.start();
129
+ this.plugin.app.logger.info(`[AgentOrchestrator] Scheduled loop pattern ${pattern.key}.`, {
130
+ patternId,
131
+ cronExpression: pattern.cronExpression,
132
+ timezone: pattern.timezone,
133
+ });
134
+ } catch (error) {
135
+ this.remove(patternId);
136
+ this.plugin.app.logger.error(`[AgentOrchestrator] Loop pattern ${patternId} could not be scheduled.`, { error });
137
+ }
138
+ }
139
+
140
+ private readonly onPatternChanged = async (record: Model, options: TransactionOptions = {}) => {
141
+ const patternId = positiveInteger(read(record, 'id'));
142
+ if (!patternId) return;
143
+ const apply = async () => {
144
+ await this.resyncPattern(patternId);
145
+ await this.plugin.sendSyncMessage({ type: 'loop-pattern-schedule-changed', patternId });
146
+ };
147
+ if (options.transaction) {
148
+ // afterCommit does not await its callback, so a rejection here would be
149
+ // an unhandled promise. Catch and log so a failed resync/broadcast does
150
+ // not silently drop the schedule change.
151
+ options.transaction.afterCommit(() =>
152
+ apply().catch((error) =>
153
+ this.plugin.app.logger.error(
154
+ `[AgentOrchestrator] Failed to apply schedule change for loop pattern ${patternId} after commit.`,
155
+ { error },
156
+ ),
157
+ ),
158
+ );
159
+ return;
160
+ }
161
+ await apply();
162
+ };
163
+
164
+ private async onTick(patternId: number, pattern: LoopPattern) {
165
+ const scheduledAt = tickDate(pattern, new Date());
166
+ const triggerKey = `cron:${pattern.key}:${scheduledAt.toISOString()}`;
167
+ let lock;
168
+ try {
169
+ lock = await this.plugin.app.lockManager.tryAcquire(
170
+ `agent-loop:schedule:${this.plugin.app.name}:${patternId}:${triggerKey}`,
171
+ );
172
+ } catch (error) {
173
+ if (isLockAcquireError(error)) return;
174
+ throw error;
175
+ }
176
+
177
+ await lock.runExclusive(async () => {
178
+ await this.triggers.enqueue({
179
+ patternId,
180
+ triggerType: 'cron',
181
+ triggerKey,
182
+ triggerPayload: { scheduledAt: scheduledAt.toISOString(), timezone: pattern.timezone },
183
+ });
184
+ }, 60_000);
185
+ }
186
+
187
+ private remove(patternId: number) {
188
+ const existing = this.scheduled.get(patternId);
189
+ if (!existing) return;
190
+ this.plugin.app.cronJobManager.removeJob(existing.job);
191
+ this.scheduled.delete(patternId);
192
+ }
193
+
194
+ private logTickError(patternId: number, error: unknown) {
195
+ this.plugin.app.logger.error(`[AgentOrchestrator] Scheduled loop pattern ${patternId} failed to enqueue.`, {
196
+ error,
197
+ });
198
+ }
199
+ }
@@ -0,0 +1,157 @@
1
+ import { randomUUID } from 'node:crypto';
2
+ import type { Database, Model } from '@nocobase/database';
3
+ import { LoopControlService } from './LoopControlService';
4
+ import { LoopPatternService } from './LoopPatternService';
5
+ import type { CompiledPatternSnapshot, HarnessSnapshot } from './LoopPatternService';
6
+
7
+ type TriggerType = 'manual' | 'cron' | 'event';
8
+
9
+ function read(record: Model | Record<string, unknown>, key: string) {
10
+ const model = record as Model & { get?: (name: string) => unknown };
11
+ return typeof model.get === 'function' ? model.get(key) : (record as Record<string, unknown>)[key];
12
+ }
13
+
14
+ function plain(record: Model | Record<string, unknown>) {
15
+ return typeof (record as Model).toJSON === 'function'
16
+ ? ((record as Model).toJSON() as Record<string, unknown>)
17
+ : (record as Record<string, unknown>);
18
+ }
19
+
20
+ function isUniqueConstraintError(error: unknown) {
21
+ return error instanceof Error && error.name === 'SequelizeUniqueConstraintError';
22
+ }
23
+
24
+ // One audit row per role naming the exact profile version the run was frozen with. The snapshot
25
+ // on the run row is authoritative for execution; these events make the application itself auditable
26
+ // without diffing snapshots.
27
+ function harnessAppliedEvents(compiled: CompiledPatternSnapshot) {
28
+ const roles: Array<{ role: 'leader' | 'maker' | 'verifier'; username: string; snapshot: HarnessSnapshot }> = [
29
+ { role: 'leader', username: compiled.roleBindings.leader, snapshot: compiled.leaderHarness },
30
+ ...compiled.roleBindings.makers.map((username) => ({
31
+ role: 'maker' as const,
32
+ username,
33
+ snapshot: compiled.makerHarnesses[username],
34
+ })),
35
+ { role: 'verifier', username: compiled.roleBindings.verifier, snapshot: compiled.verifierHarness },
36
+ ];
37
+ return roles.filter((entry) => entry.snapshot);
38
+ }
39
+
40
+ export class LoopTriggerService {
41
+ private readonly control: LoopControlService;
42
+
43
+ constructor(
44
+ private readonly database: Database,
45
+ private readonly patterns: LoopPatternService,
46
+ ) {
47
+ this.control = new LoopControlService(database);
48
+ }
49
+
50
+ async enqueue(input: {
51
+ patternId: number;
52
+ triggerType: TriggerType;
53
+ triggerKey: string;
54
+ triggerPayload?: Record<string, unknown>;
55
+ userId?: number;
56
+ goal?: string;
57
+ perRunHarness?: unknown;
58
+ }) {
59
+ const triggerKey = input.triggerKey.trim();
60
+ if (!triggerKey) throw new Error('Trigger key is required.');
61
+ await this.control.assertCanEnqueue();
62
+ const compiled = await this.patterns.compile(input.patternId, input.perRunHarness);
63
+ if (compiled.pattern.triggerType !== input.triggerType && input.triggerType !== 'manual') {
64
+ throw new Error(
65
+ `Pattern ${compiled.pattern.key} expects ${compiled.pattern.triggerType} triggers, not ${input.triggerType}.`,
66
+ );
67
+ }
68
+ const goal = (input.goal || compiled.pattern.goalTemplate).trim();
69
+ if (!goal) throw new Error('Loop run goal is required.');
70
+
71
+ try {
72
+ return await this.database.sequelize.transaction(async (transaction) => {
73
+ await this.control.assertCanEnqueue(transaction);
74
+ const now = new Date();
75
+ const run = await this.database.getRepository('agentLoopRuns').create({
76
+ values: {
77
+ rootRunId: `loop_${randomUUID()}`,
78
+ runtimeVersion: 'control-plane-v2',
79
+ recordMode: 'observed-execution',
80
+ patternId: input.patternId,
81
+ triggerType: input.triggerType,
82
+ triggerKey,
83
+ triggerPayload: input.triggerPayload || {},
84
+ autonomyLevel: compiled.pattern.autonomyLevel,
85
+ roleBindingsSnapshot: compiled.roleBindings,
86
+ leaderHarnessSnapshot: compiled.leaderHarness,
87
+ makerHarnessSnapshot: compiled.makerHarnesses,
88
+ verifierHarnessSnapshot: compiled.verifierHarness,
89
+ policySnapshot: compiled.policy,
90
+ leaderUsername: compiled.roleBindings.leader,
91
+ verifierUsername: compiled.roleBindings.verifier,
92
+ goal,
93
+ status: 'queued',
94
+ repositoryKey: compiled.pattern.repositoryKey,
95
+ repositoryRoot: compiled.pattern.repositoryRoot,
96
+ baseRef: compiled.pattern.baseRef,
97
+ actingOn: [...compiled.pattern.actingOn],
98
+ userId: input.userId || null,
99
+ createdAt: now,
100
+ updatedAt: now,
101
+ },
102
+ transaction,
103
+ });
104
+ const runId = Number(read(run, 'id'));
105
+ await this.database.getRepository('agentLoopEvents').create({
106
+ values: {
107
+ runId,
108
+ type: 'run_queued',
109
+ title: 'Run queued',
110
+ content: `Pattern ${compiled.pattern.key} accepted ${input.triggerType} trigger ${triggerKey}.`,
111
+ status: 'queued',
112
+ payload: { patternKey: compiled.pattern.key, triggerType: input.triggerType },
113
+ actorType: input.triggerType === 'manual' ? 'user' : 'system',
114
+ actorIdentity: input.userId ? String(input.userId) : input.triggerType,
115
+ correlationKey: `queued:${triggerKey}`,
116
+ userId: input.userId || null,
117
+ createdAt: now,
118
+ },
119
+ transaction,
120
+ });
121
+ for (const entry of harnessAppliedEvents(compiled)) {
122
+ await this.database.getRepository('agentLoopEvents').create({
123
+ values: {
124
+ runId,
125
+ type: 'harness_applied',
126
+ title: `Harness ${entry.snapshot.tag}@v${entry.snapshot.version} applied to ${entry.role}`,
127
+ content: `${entry.role} ${entry.username} executes under harness profile ${entry.snapshot.tag} version ${entry.snapshot.version}.`,
128
+ status: 'queued',
129
+ payload: {
130
+ role: entry.role,
131
+ username: entry.username,
132
+ tag: entry.snapshot.tag,
133
+ version: entry.snapshot.version,
134
+ versionId: entry.snapshot.versionId,
135
+ schemaVersion: entry.snapshot.schemaVersion,
136
+ },
137
+ actorType: input.triggerType === 'manual' ? 'user' : 'system',
138
+ actorIdentity: input.userId ? String(input.userId) : input.triggerType,
139
+ correlationKey: `harness:${entry.role}:${entry.username}`,
140
+ userId: input.userId || null,
141
+ createdAt: now,
142
+ },
143
+ transaction,
144
+ });
145
+ }
146
+ return { created: true, run: plain(run) };
147
+ });
148
+ } catch (error) {
149
+ if (!isUniqueConstraintError(error)) throw error;
150
+ const existing = await this.database.getRepository('agentLoopRuns').findOne({
151
+ filter: { patternId: input.patternId, triggerKey },
152
+ });
153
+ if (!existing) throw error;
154
+ return { created: false, run: plain(existing) };
155
+ }
156
+ }
157
+ }