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.
- package/README.md +204 -114
- package/dist/client/index.js +1 -1
- package/dist/client-v2/117.7565cff57c39318a.js +10 -0
- package/dist/client-v2/214.106635011859dede.js +10 -0
- package/dist/client-v2/418.41ed200e7d6da332.js +10 -0
- package/dist/client-v2/53.349fff8db80b19d4.js +10 -0
- package/dist/client-v2/981.e4a1f41cfc94a856.js +10 -0
- package/dist/client-v2/index.js +1 -1
- package/dist/externalVersion.js +7 -8
- package/dist/locale/en-US.json +226 -170
- package/dist/locale/vi-VN.json +226 -170
- package/dist/locale/zh-CN.json +226 -170
- package/dist/server/collections/agent-execution-spans.js +8 -0
- package/dist/server/collections/agent-loop-action-approvals.js +1 -0
- package/dist/server/collections/agent-loop-runs.js +7 -1
- package/dist/server/collections/agent-loop-steps.js +7 -0
- package/dist/server/collections/skill-executions.js +8 -0
- package/dist/server/plugin.js +3 -1
- package/dist/server/resources/agent-harness-profile.js +117 -0
- package/dist/server/resources/agent-knowledge-insights.js +1 -3
- package/dist/server/resources/agent-loop-approval.js +25 -0
- package/dist/server/resources/agent-loop.js +3 -1
- package/dist/server/services/AgentMemoryContextService.js +34 -0
- package/dist/server/services/HarnessCompiler.js +35 -2
- package/dist/server/services/HarnessProfileService.js +74 -9
- package/dist/server/services/HarnessSchema.js +30 -3
- package/dist/server/services/LoopPatternSchema.js +16 -1
- package/dist/server/services/LoopRunRepository.js +80 -0
- package/dist/server/services/LoopRunStateMachine.js +92 -3
- package/dist/server/services/LoopTriggerService.js +37 -0
- package/dist/server/services/LoopWorkerService.js +261 -23
- package/dist/server/services/NativeSubAgentObserver.js +165 -23
- package/dist/server/services/PluginAiRuntimeAdapter.js +16 -5
- package/dist/server/services/ToolLoopDetectionService.js +210 -0
- package/dist/server/services/VerificationService.js +66 -0
- package/dist/server/services/harness-runtime-policy.js +139 -0
- package/dist/server/skill-hub/plugin.js +36 -3
- package/dist/server/skill-hub/tasks/SkillExecutionTask.js +29 -0
- package/package.json +53 -53
- package/src/client/ApprovalsTab.tsx +2 -0
- package/src/client/OrchestratorSettings.tsx +11 -0
- package/src/client/skill-hub/components/GitSkillImport.tsx +3 -3
- package/src/client/skill-hub/components/SkillMetrics.tsx +15 -10
- package/src/client/skill-hub/index.tsx +0 -52
- package/src/client-v2/components/AgentRunsTab.tsx +576 -576
- package/src/client-v2/components/ApprovalsTab.tsx +337 -0
- package/src/client-v2/components/HarnessProfilesTab.tsx +385 -105
- package/src/client-v2/components/MemoryInspectorTab.tsx +141 -141
- package/src/client-v2/components/TracingTab.tsx +515 -515
- package/src/client-v2/hooks/useApiRequest.ts +141 -141
- package/src/client-v2/pages/ApprovalsPage.tsx +10 -0
- package/src/client-v2/plugin.tsx +6 -6
- package/src/client-v2/skill-hub/components/SkillMetrics.tsx +5 -2
- package/src/locale/en-US.json +226 -174
- package/src/locale/vi-VN.json +226 -174
- package/src/locale/zh-CN.json +226 -174
- package/src/server/__tests__/circuit-breaker.test.ts +248 -248
- package/src/server/__tests__/harness-compiler.test.ts +83 -0
- package/src/server/__tests__/harness-profile-service.test.ts +51 -0
- package/src/server/__tests__/harness-runtime-policy.test.ts +293 -0
- package/src/server/__tests__/harness-tool-plan.test.ts +24 -0
- package/src/server/__tests__/loop-approval-decision.test.ts +512 -0
- package/src/server/__tests__/loop-approval-expiry.test.ts +258 -0
- package/src/server/__tests__/loop-budget-service.test.ts +255 -255
- package/src/server/__tests__/loop-control-plane-backfill.test.ts +266 -266
- package/src/server/__tests__/loop-pattern-schema.test.ts +18 -1
- package/src/server/__tests__/loop-pattern-service.test.ts +148 -148
- package/src/server/__tests__/loop-run-state-machine.test.ts +11 -0
- package/src/server/__tests__/loop-trigger-service.test.ts +148 -0
- package/src/server/__tests__/loop-worker-claim.test.ts +341 -341
- package/src/server/__tests__/loop-worker-execution.test.ts +82 -1
- package/src/server/__tests__/native-sub-agent-observer.test.ts +288 -4
- package/src/server/__tests__/path-lock-service.test.ts +254 -254
- package/src/server/__tests__/skill-execution-task-policy.test.ts +140 -0
- package/src/server/__tests__/smoke.test.ts +162 -162
- package/src/server/__tests__/tool-loop-detection.test.ts +275 -0
- package/src/server/collections/agent-execution-spans.ts +8 -0
- package/src/server/collections/agent-harness-profile-versions.ts +26 -26
- package/src/server/collections/agent-harness-profiles.ts +71 -71
- package/src/server/collections/agent-loop-action-approvals.ts +1 -0
- package/src/server/collections/agent-loop-artifacts.ts +25 -25
- package/src/server/collections/agent-loop-circuit-states.ts +23 -23
- package/src/server/collections/agent-loop-control-settings.ts +21 -21
- package/src/server/collections/agent-loop-events.ts +98 -98
- package/src/server/collections/agent-loop-path-locks.ts +27 -27
- package/src/server/collections/agent-loop-patterns.ts +42 -42
- package/src/server/collections/agent-loop-runs.ts +7 -1
- package/src/server/collections/agent-loop-steps.ts +7 -0
- package/src/server/collections/agent-loop-usage-buckets.ts +22 -22
- package/src/server/collections/agent-loop-worktrees.ts +25 -25
- package/src/server/collections/skill-executions.ts +8 -0
- package/src/server/migrations/20260427000002-change-packages-to-text.ts +52 -52
- package/src/server/migrations/20260429000000-add-llm-fields.ts +47 -47
- package/src/server/migrations/20260429000001-fix-inputargs-json-to-text.ts +45 -45
- package/src/server/migrations/20260503000000-add-orchestrator-trace-fields.ts +33 -33
- package/src/server/migrations/20260524000000-add-agent-loop-fields-to-skill-executions.ts +31 -31
- package/src/server/migrations/20260803010000-backfill-loop-control-plane-data.ts +293 -293
- package/src/server/plugin.ts +3 -1
- package/src/server/resources/agent-harness-profile.ts +94 -0
- package/src/server/resources/agent-knowledge-insights.ts +5 -3
- package/src/server/resources/agent-loop-approval.ts +32 -0
- package/src/server/resources/agent-loop-artifact.ts +56 -56
- package/src/server/resources/agent-loop-events-stream.ts +105 -105
- package/src/server/resources/agent-loop.ts +3 -1
- package/src/server/resources/resource-helpers.ts +33 -33
- package/src/server/resources/tracing.ts +266 -266
- package/src/server/services/AgentMemoryContextService.ts +44 -0
- package/src/server/services/DurableCircuitBreakerService.ts +239 -239
- package/src/server/services/ExecutionSpanService.ts +2 -0
- package/src/server/services/HarnessCompiler.ts +37 -0
- package/src/server/services/HarnessProfileService.ts +92 -10
- package/src/server/services/HarnessSchema.ts +31 -0
- package/src/server/services/LoopBudgetService.ts +275 -275
- package/src/server/services/LoopControlService.ts +124 -124
- package/src/server/services/LoopPatternSchema.ts +19 -1
- package/src/server/services/LoopPatternService.ts +143 -143
- package/src/server/services/LoopRunRepository.ts +99 -0
- package/src/server/services/LoopRunStateMachine.ts +100 -3
- package/src/server/services/LoopSchedulerService.ts +199 -199
- package/src/server/services/LoopTriggerService.ts +42 -0
- package/src/server/services/LoopWorkerService.ts +327 -27
- package/src/server/services/NativeSubAgentObserver.ts +186 -21
- package/src/server/services/PathLockService.ts +321 -321
- package/src/server/services/PluginAiRuntimeAdapter.ts +24 -7
- package/src/server/services/ToolLoopDetectionService.ts +213 -0
- package/src/server/services/VerificationSchema.ts +31 -31
- package/src/server/services/VerificationService.ts +81 -2
- package/src/server/services/harness-runtime-policy.ts +141 -0
- package/src/server/skill-hub/plugin.ts +41 -3
- package/src/server/skill-hub/services/RegistrySkillSnapshotService.ts +235 -235
- package/src/server/skill-hub/services/__tests__/RegistrySkillSnapshotService.test.ts +61 -61
- package/src/server/skill-hub/tasks/SkillExecutionTask.ts +43 -2
- package/src/server/utils/ensure-indexes.ts +96 -96
- package/src/server/utils/logging.ts +62 -62
- package/src/server/utils/loop-pattern-context.ts +20 -20
- package/dist/client-v2/214.b063f33ba044a808.js +0 -10
- package/dist/client-v2/373.f5d5292e53c4e832.js +0 -10
- package/dist/client-v2/418.58fa350f5496efd3.js +0 -10
- package/dist/client-v2/53.9a10455323390f14.js +0 -10
- package/dist/client-v2/677.a991ce0250ff5c77.js +0 -10
- package/dist/client-v2/925.e5925bf21ed68e7a.js +0 -10
- package/src/client/AIEmployeeSelect.tsx +0 -47
- package/src/client/AIEmployeesContext.tsx +0 -102
- package/src/client/RulesTab.tsx +0 -2
- package/src/client/TracingTab.tsx +0 -436
- package/src/client/skill-hub/components/ExecutionProgress.tsx +0 -51
- package/src/client-v2/components/RulesTab.tsx +0 -2
- 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(
|
|
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
|
-
|
|
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
|
-
|
|
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,
|
|
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,
|