plugin-agent-orchestrator 1.1.4 → 1.1.6

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 (148) 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/418.41ed200e7d6da332.js +10 -0
  6. package/dist/client-v2/53.349fff8db80b19d4.js +10 -0
  7. package/dist/client-v2/981.e4a1f41cfc94a856.js +10 -0
  8. package/dist/client-v2/index.js +1 -1
  9. package/dist/externalVersion.js +7 -8
  10. package/dist/locale/en-US.json +226 -170
  11. package/dist/locale/vi-VN.json +226 -170
  12. package/dist/locale/zh-CN.json +226 -170
  13. package/dist/server/collections/agent-execution-spans.js +8 -0
  14. package/dist/server/collections/agent-loop-action-approvals.js +1 -0
  15. package/dist/server/collections/agent-loop-runs.js +7 -1
  16. package/dist/server/collections/agent-loop-steps.js +7 -0
  17. package/dist/server/collections/skill-executions.js +8 -0
  18. package/dist/server/plugin.js +3 -1
  19. package/dist/server/resources/agent-harness-profile.js +117 -0
  20. package/dist/server/resources/agent-knowledge-insights.js +1 -3
  21. package/dist/server/resources/agent-loop-approval.js +25 -0
  22. package/dist/server/resources/agent-loop.js +3 -1
  23. package/dist/server/services/AgentMemoryContextService.js +34 -0
  24. package/dist/server/services/HarnessCompiler.js +35 -2
  25. package/dist/server/services/HarnessProfileService.js +74 -9
  26. package/dist/server/services/HarnessSchema.js +30 -3
  27. package/dist/server/services/LoopPatternSchema.js +16 -1
  28. package/dist/server/services/LoopRunRepository.js +80 -0
  29. package/dist/server/services/LoopRunStateMachine.js +92 -3
  30. package/dist/server/services/LoopTriggerService.js +37 -0
  31. package/dist/server/services/LoopWorkerService.js +261 -23
  32. package/dist/server/services/NativeSubAgentObserver.js +165 -23
  33. package/dist/server/services/PluginAiRuntimeAdapter.js +16 -5
  34. package/dist/server/services/ToolLoopDetectionService.js +210 -0
  35. package/dist/server/services/VerificationService.js +66 -0
  36. package/dist/server/services/harness-runtime-policy.js +139 -0
  37. package/dist/server/skill-hub/plugin.js +36 -3
  38. package/dist/server/skill-hub/tasks/SkillExecutionTask.js +29 -0
  39. package/package.json +53 -53
  40. package/src/client/ApprovalsTab.tsx +2 -0
  41. package/src/client/OrchestratorSettings.tsx +11 -0
  42. package/src/client/skill-hub/components/GitSkillImport.tsx +3 -3
  43. package/src/client/skill-hub/components/SkillMetrics.tsx +15 -10
  44. package/src/client/skill-hub/index.tsx +0 -52
  45. package/src/client-v2/components/AgentRunsTab.tsx +576 -576
  46. package/src/client-v2/components/ApprovalsTab.tsx +337 -0
  47. package/src/client-v2/components/HarnessProfilesTab.tsx +385 -105
  48. package/src/client-v2/components/MemoryInspectorTab.tsx +141 -141
  49. package/src/client-v2/components/TracingTab.tsx +515 -515
  50. package/src/client-v2/hooks/useApiRequest.ts +141 -141
  51. package/src/client-v2/pages/ApprovalsPage.tsx +10 -0
  52. package/src/client-v2/plugin.tsx +6 -6
  53. package/src/client-v2/skill-hub/components/SkillMetrics.tsx +5 -2
  54. package/src/locale/en-US.json +226 -174
  55. package/src/locale/vi-VN.json +226 -174
  56. package/src/locale/zh-CN.json +226 -174
  57. package/src/server/__tests__/circuit-breaker.test.ts +248 -248
  58. package/src/server/__tests__/harness-compiler.test.ts +83 -0
  59. package/src/server/__tests__/harness-profile-service.test.ts +51 -0
  60. package/src/server/__tests__/harness-runtime-policy.test.ts +293 -0
  61. package/src/server/__tests__/harness-tool-plan.test.ts +24 -0
  62. package/src/server/__tests__/loop-approval-decision.test.ts +512 -0
  63. package/src/server/__tests__/loop-approval-expiry.test.ts +258 -0
  64. package/src/server/__tests__/loop-budget-service.test.ts +255 -255
  65. package/src/server/__tests__/loop-control-plane-backfill.test.ts +266 -266
  66. package/src/server/__tests__/loop-pattern-schema.test.ts +18 -1
  67. package/src/server/__tests__/loop-pattern-service.test.ts +148 -148
  68. package/src/server/__tests__/loop-run-state-machine.test.ts +11 -0
  69. package/src/server/__tests__/loop-trigger-service.test.ts +148 -0
  70. package/src/server/__tests__/loop-worker-claim.test.ts +341 -341
  71. package/src/server/__tests__/loop-worker-execution.test.ts +82 -1
  72. package/src/server/__tests__/native-sub-agent-observer.test.ts +288 -4
  73. package/src/server/__tests__/path-lock-service.test.ts +254 -254
  74. package/src/server/__tests__/skill-execution-task-policy.test.ts +140 -0
  75. package/src/server/__tests__/smoke.test.ts +162 -162
  76. package/src/server/__tests__/tool-loop-detection.test.ts +275 -0
  77. package/src/server/collections/agent-execution-spans.ts +8 -0
  78. package/src/server/collections/agent-harness-profile-versions.ts +26 -26
  79. package/src/server/collections/agent-harness-profiles.ts +71 -71
  80. package/src/server/collections/agent-loop-action-approvals.ts +1 -0
  81. package/src/server/collections/agent-loop-artifacts.ts +25 -25
  82. package/src/server/collections/agent-loop-circuit-states.ts +23 -23
  83. package/src/server/collections/agent-loop-control-settings.ts +21 -21
  84. package/src/server/collections/agent-loop-events.ts +98 -98
  85. package/src/server/collections/agent-loop-path-locks.ts +27 -27
  86. package/src/server/collections/agent-loop-patterns.ts +42 -42
  87. package/src/server/collections/agent-loop-runs.ts +7 -1
  88. package/src/server/collections/agent-loop-steps.ts +7 -0
  89. package/src/server/collections/agent-loop-usage-buckets.ts +22 -22
  90. package/src/server/collections/agent-loop-worktrees.ts +25 -25
  91. package/src/server/collections/skill-executions.ts +8 -0
  92. package/src/server/migrations/20260427000002-change-packages-to-text.ts +52 -52
  93. package/src/server/migrations/20260429000000-add-llm-fields.ts +47 -47
  94. package/src/server/migrations/20260429000001-fix-inputargs-json-to-text.ts +45 -45
  95. package/src/server/migrations/20260503000000-add-orchestrator-trace-fields.ts +33 -33
  96. package/src/server/migrations/20260524000000-add-agent-loop-fields-to-skill-executions.ts +31 -31
  97. package/src/server/migrations/20260803010000-backfill-loop-control-plane-data.ts +293 -293
  98. package/src/server/plugin.ts +3 -1
  99. package/src/server/resources/agent-harness-profile.ts +94 -0
  100. package/src/server/resources/agent-knowledge-insights.ts +5 -3
  101. package/src/server/resources/agent-loop-approval.ts +32 -0
  102. package/src/server/resources/agent-loop-artifact.ts +56 -56
  103. package/src/server/resources/agent-loop-events-stream.ts +105 -105
  104. package/src/server/resources/agent-loop.ts +3 -1
  105. package/src/server/resources/resource-helpers.ts +33 -33
  106. package/src/server/resources/tracing.ts +266 -266
  107. package/src/server/services/AgentMemoryContextService.ts +44 -0
  108. package/src/server/services/DurableCircuitBreakerService.ts +239 -239
  109. package/src/server/services/ExecutionSpanService.ts +2 -0
  110. package/src/server/services/HarnessCompiler.ts +37 -0
  111. package/src/server/services/HarnessProfileService.ts +92 -10
  112. package/src/server/services/HarnessSchema.ts +31 -0
  113. package/src/server/services/LoopBudgetService.ts +275 -275
  114. package/src/server/services/LoopControlService.ts +124 -124
  115. package/src/server/services/LoopPatternSchema.ts +19 -1
  116. package/src/server/services/LoopPatternService.ts +143 -143
  117. package/src/server/services/LoopRunRepository.ts +99 -0
  118. package/src/server/services/LoopRunStateMachine.ts +100 -3
  119. package/src/server/services/LoopSchedulerService.ts +199 -199
  120. package/src/server/services/LoopTriggerService.ts +42 -0
  121. package/src/server/services/LoopWorkerService.ts +327 -27
  122. package/src/server/services/NativeSubAgentObserver.ts +186 -21
  123. package/src/server/services/PathLockService.ts +321 -321
  124. package/src/server/services/PluginAiRuntimeAdapter.ts +24 -7
  125. package/src/server/services/ToolLoopDetectionService.ts +213 -0
  126. package/src/server/services/VerificationSchema.ts +31 -31
  127. package/src/server/services/VerificationService.ts +81 -2
  128. package/src/server/services/harness-runtime-policy.ts +141 -0
  129. package/src/server/skill-hub/plugin.ts +41 -3
  130. package/src/server/skill-hub/services/RegistrySkillSnapshotService.ts +235 -235
  131. package/src/server/skill-hub/services/__tests__/RegistrySkillSnapshotService.test.ts +61 -61
  132. package/src/server/skill-hub/tasks/SkillExecutionTask.ts +43 -2
  133. package/src/server/utils/ensure-indexes.ts +96 -96
  134. package/src/server/utils/logging.ts +62 -62
  135. package/src/server/utils/loop-pattern-context.ts +20 -20
  136. package/dist/client-v2/214.b063f33ba044a808.js +0 -10
  137. package/dist/client-v2/373.f5d5292e53c4e832.js +0 -10
  138. package/dist/client-v2/418.58fa350f5496efd3.js +0 -10
  139. package/dist/client-v2/53.9a10455323390f14.js +0 -10
  140. package/dist/client-v2/677.a991ce0250ff5c77.js +0 -10
  141. package/dist/client-v2/925.e5925bf21ed68e7a.js +0 -10
  142. package/src/client/AIEmployeeSelect.tsx +0 -47
  143. package/src/client/AIEmployeesContext.tsx +0 -102
  144. package/src/client/RulesTab.tsx +0 -2
  145. package/src/client/TracingTab.tsx +0 -436
  146. package/src/client/skill-hub/components/ExecutionProgress.tsx +0 -51
  147. package/src/client-v2/components/RulesTab.tsx +0 -2
  148. package/src/client-v2/pages/AgentRunsPage.tsx +0 -13
@@ -46,12 +46,46 @@ export class HarnessProfileService {
46
46
  return validateHarnessSettings(settings);
47
47
  }
48
48
 
49
- async createDraft(input: { profileId: number; settings: unknown; schemaVersion?: number }) {
49
+ async createDraft(
50
+ input: { profileId: number; settings: unknown; schemaVersion?: number },
51
+ transaction?: Transaction,
52
+ ) {
50
53
  const profileId = positiveId(input.profileId, 'Harness profile id');
51
54
  const schemaVersion = positiveId(input.schemaVersion || 1, 'Harness schema version');
52
55
  const settings = parseHarnessSettings(input.settings);
53
56
 
54
- return this.database.sequelize.transaction(async (transaction) => {
57
+ const create = async (active: Transaction) => {
58
+ await this.lockProfile(profileId, active);
59
+ const versions = this.database.getRepository('agentHarnessProfileVersions');
60
+ const latest = await versions.findOne({
61
+ filter: { profileId },
62
+ sort: ['-version'],
63
+ transaction: active,
64
+ });
65
+ const nextVersion = latest ? positiveId(read(latest, 'version'), 'Harness profile version') + 1 : 1;
66
+ const draft = await versions.create({
67
+ values: {
68
+ profileId,
69
+ version: nextVersion,
70
+ schemaVersion,
71
+ status: 'draft',
72
+ settings,
73
+ },
74
+ transaction: active,
75
+ });
76
+ return versionRecord(draft);
77
+ };
78
+ return transaction ? create(transaction) : this.database.sequelize.transaction(create);
79
+ }
80
+
81
+ // One open draft per profile: editing saves into the latest draft when it has not been
82
+ // published yet, and only starts a new version once the previous one shipped. This keeps the
83
+ // version history a clean publish trail instead of accumulating abandoned drafts.
84
+ async saveDraft(input: { profileId: number; settings: unknown }) {
85
+ const profileId = positiveId(input.profileId, 'Harness profile id');
86
+ const settings = parseHarnessSettings(input.settings);
87
+
88
+ return this.database.sequelize.transaction(async (transaction: Transaction) => {
55
89
  await this.lockProfile(profileId, transaction);
56
90
  const versions = this.database.getRepository('agentHarnessProfileVersions');
57
91
  const latest = await versions.findOne({
@@ -59,7 +93,14 @@ export class HarnessProfileService {
59
93
  sort: ['-version'],
60
94
  transaction,
61
95
  });
96
+ if (latest && read(latest, 'status') !== 'published') {
97
+ await versions.update({ filterByTk: read(latest, 'id'), values: { settings }, transaction });
98
+ const updated = await versions.findOne({ filterByTk: read(latest, 'id'), transaction });
99
+ if (!updated) throw new Error(`Harness profile version ${read(latest, 'id')} was not found after update.`);
100
+ return versionRecord(updated);
101
+ }
62
102
  const nextVersion = latest ? positiveId(read(latest, 'version'), 'Harness profile version') + 1 : 1;
103
+ const schemaVersion = latest ? positiveId(read(latest, 'schemaVersion') || 1, 'Harness schema version') : 1;
63
104
  const draft = await versions.create({
64
105
  values: {
65
106
  profileId,
@@ -89,16 +130,17 @@ export class HarnessProfileService {
89
130
  return versionRecord(updated);
90
131
  }
91
132
 
92
- async publish(versionId: number, publishedById?: number) {
133
+ async publish(versionId: number, publishedById?: number, transaction?: Transaction) {
93
134
  const id = positiveId(versionId, 'Harness profile version id');
94
- return this.database.sequelize.transaction(async (transaction) => {
135
+
136
+ const publishVersion = async (active: Transaction) => {
95
137
  const versions = this.database.getRepository('agentHarnessProfileVersions');
96
- const candidate = await versions.findOne({ filterByTk: id, transaction });
138
+ const candidate = await versions.findOne({ filterByTk: id, transaction: active });
97
139
  if (!candidate) throw new Error(`Harness profile version ${id} was not found.`);
98
140
  const profileId = positiveId(read(candidate, 'profileId'), 'Harness profile id');
99
- await this.lockProfile(profileId, transaction);
141
+ await this.lockProfile(profileId, active);
100
142
 
101
- const current = await versions.findOne({ filterByTk: id, transaction });
143
+ const current = await versions.findOne({ filterByTk: id, transaction: active });
102
144
  if (!current) throw new Error(`Harness profile version ${id} was not found.`);
103
145
  if (read(current, 'status') === 'published') {
104
146
  return versionRecord(current);
@@ -114,7 +156,7 @@ export class HarnessProfileService {
114
156
  publishedById: publishedById ? positiveId(publishedById, 'Publisher id') : null,
115
157
  publishedAt: now,
116
158
  },
117
- transaction,
159
+ transaction: active,
118
160
  });
119
161
  await this.database.getRepository('agentHarnessProfiles').update({
120
162
  filterByTk: profileId,
@@ -122,11 +164,51 @@ export class HarnessProfileService {
122
164
  currentVersionId: id,
123
165
  schemaVersion: positiveId(read(current, 'schemaVersion'), 'Harness schema version'),
124
166
  },
125
- transaction,
167
+ transaction: active,
126
168
  });
127
- const published = await versions.findOne({ filterByTk: id, transaction });
169
+ const published = await versions.findOne({ filterByTk: id, transaction: active });
128
170
  if (!published) throw new Error(`Harness profile version ${id} was not found after publish.`);
129
171
  return versionRecord(published);
172
+ };
173
+ return transaction ? publishVersion(transaction) : this.database.sequelize.transaction(publishVersion);
174
+ }
175
+
176
+ // Atomic bootstrap: the profile row and its first published version are created together, so a
177
+ // profile can never exist in a state where the row promises settings no version accounts for.
178
+ async createProfile(input: {
179
+ tag: string;
180
+ title?: string;
181
+ description?: string;
182
+ enabled?: boolean;
183
+ settings: unknown;
184
+ publishedById?: number;
185
+ }) {
186
+ const tag = input.tag.trim();
187
+ if (!tag) throw new Error('Harness profile tag is required.');
188
+ // Validate before opening the transaction: a rejected settings payload must never leave a
189
+ // profile row behind, even on connections without rollback guarantees.
190
+ const settings = parseHarnessSettings(input.settings);
191
+
192
+ return this.database.sequelize.transaction(async (transaction: Transaction) => {
193
+ const profile = await this.database.getRepository('agentHarnessProfiles').create({
194
+ values: {
195
+ tag,
196
+ title: input.title || '',
197
+ description: input.description || '',
198
+ enabled: input.enabled !== false,
199
+ schemaVersion: 1,
200
+ },
201
+ transaction,
202
+ });
203
+ const profileId = positiveId(read(profile, 'id'), 'Harness profile id');
204
+ const draft = await this.createDraft({ profileId, settings }, transaction);
205
+ const published = await this.publish(draft.id, input.publishedById, transaction);
206
+ const created = await this.database.getRepository('agentHarnessProfiles').findOne({
207
+ filterByTk: profileId,
208
+ transaction,
209
+ });
210
+ if (!created) throw new Error(`Harness profile ${profileId} was not found after create.`);
211
+ return { profile: created, version: published };
130
212
  });
131
213
  }
132
214
 
@@ -13,8 +13,15 @@ export const harnessSettingsSchema = z
13
13
  allow: z.array(z.string().min(1)).default([]),
14
14
  ask: z.array(z.string().min(1)).default([]),
15
15
  deny: z.array(z.string().min(1)).default([]),
16
+ // Tools the harness does not grant but may be requested for a single call: invoking one
17
+ // interrupts exactly like `ask` and parks the run, but the approval row is tagged as an
18
+ // escalation. Approving widens authority for that one call only; the harness is unchanged.
19
+ escalate: z.array(z.string().min(1)).default([]),
16
20
  effects: z.record(toolEffectSchema).default({}),
17
21
  trustedPreHandlerTools: z.array(z.string().min(1)).default([]),
22
+ // Per-tool wall-clock caps in milliseconds. Only enforceable where this plugin owns the
23
+ // execution pipeline (skill hub sandbox); elsewhere it is advisory observability data.
24
+ timeouts: z.record(z.number().int().positive()).default({}),
18
25
  })
19
26
  .default({}),
20
27
  memory: z
@@ -43,6 +50,17 @@ export const harnessSettingsSchema = z
43
50
  maxCost: nullableLimit,
44
51
  })
45
52
  .default({}),
53
+ context: z
54
+ .object({
55
+ spill: z
56
+ .object({
57
+ // Tool/sub-agent outputs larger than this many UTF-8 bytes are stored on disk and
58
+ // replaced inline by a head/tail preview plus a locator. null keeps everything inline.
59
+ maxInlineBytes: z.number().int().positive().nullable().default(null),
60
+ })
61
+ .default({}),
62
+ })
63
+ .default({}),
46
64
  isolation: z
47
65
  .object({
48
66
  mode: z.enum(['none', 'worktree']).default('none'),
@@ -57,6 +75,12 @@ export const harnessSettingsSchema = z
57
75
  tracingRetentionDays: z.number().int().positive().max(3650).default(30),
58
76
  captureInputs: z.boolean().default(true),
59
77
  captureOutputs: z.boolean().default(true),
78
+ // Scrub values whose key names look secret-bearing (KEY/SECRET/TOKEN/PASSWORD/CREDENTIAL)
79
+ // before span inputs are persisted. Defaults on: telemetry must never be the leak vector.
80
+ redactSecrets: z.boolean().default(true),
81
+ // Who span content may be shared with: full = inputs+outputs, feedback-only = outputs
82
+ // only, disabled = no span content persisted at all.
83
+ sharing: z.enum(['full', 'feedback-only', 'disabled']).default('full'),
60
84
  })
61
85
  .default({}),
62
86
  })
@@ -87,6 +111,7 @@ export function normalizeHarnessSettings(value: unknown): unknown {
87
111
  const memory = isRecord(source.memory) ? source.memory : {};
88
112
  const delegation = isRecord(source.delegation) ? source.delegation : {};
89
113
  const limits = isRecord(source.limits) ? source.limits : {};
114
+ const context = isRecord(source.context) ? source.context : {};
90
115
  const isolation = isRecord(source.isolation) ? source.isolation : {};
91
116
  const observability = isRecord(source.observability) ? source.observability : {};
92
117
  const knownKeys = new Set([
@@ -120,8 +145,10 @@ export function normalizeHarnessSettings(value: unknown): unknown {
120
145
  allow: stringArray(tools.allow),
121
146
  ask: stringArray(tools.ask),
122
147
  deny: stringArray(tools.deny),
148
+ escalate: stringArray(tools.escalate),
123
149
  effects: isRecord(tools.effects) ? tools.effects : {},
124
150
  trustedPreHandlerTools: stringArray(tools.trustedPreHandlerTools),
151
+ timeouts: isRecord(tools.timeouts) ? tools.timeouts : {},
125
152
  },
126
153
  memory: {
127
154
  ...memory,
@@ -139,6 +166,10 @@ export function normalizeHarnessSettings(value: unknown): unknown {
139
166
  allowedEmployees: stringArray(delegation.allowedEmployees),
140
167
  },
141
168
  limits,
169
+ context: {
170
+ ...context,
171
+ spill: isRecord(context.spill) ? context.spill : {},
172
+ },
142
173
  isolation,
143
174
  observability: {
144
175
  ...observability,