plugin-agent-orchestrator 1.1.2 → 1.1.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (173) hide show
  1. package/dist/client/index.js +1 -1
  2. package/dist/client-v2/214.b063f33ba044a808.js +10 -0
  3. package/dist/client-v2/253.59577b40d9875be0.js +10 -0
  4. package/dist/client-v2/264.7ed8bee71fa5935c.js +10 -0
  5. package/dist/client-v2/{41.ba6e080cc0488143.js → 41.3deb9e57a0f64fc4.js} +1 -1
  6. package/dist/client-v2/418.58fa350f5496efd3.js +10 -0
  7. package/dist/client-v2/{53.7c29c28043e9112d.js → 53.9a10455323390f14.js} +1 -1
  8. package/dist/client-v2/619.0a2144aaffefe018.js +10 -0
  9. package/dist/client-v2/{70.bda9518881c05360.js → 70.ffff2997c10fd4b0.js} +1 -1
  10. package/dist/client-v2/{794.9bbb8d3a61b2bdf2.js → 794.a67a2614405ba627.js} +1 -1
  11. package/dist/client-v2/925.e5925bf21ed68e7a.js +10 -0
  12. package/dist/client-v2/{993.82778b6fd6db3cb1.js → 993.b0688fdc5ccb000a.js} +1 -1
  13. package/dist/client-v2/index.js +1 -1
  14. package/dist/externalVersion.js +8 -6
  15. package/dist/locale/en-US.json +48 -28
  16. package/dist/locale/vi-VN.json +48 -28
  17. package/dist/locale/zh-CN.json +48 -28
  18. package/dist/server/collections/agent-execution-spans.js +47 -0
  19. package/dist/server/collections/agent-harness-profile-versions.js +56 -0
  20. package/dist/server/collections/agent-harness-profiles.js +12 -0
  21. package/dist/server/collections/agent-loop-action-approvals.js +68 -0
  22. package/dist/server/collections/agent-loop-artifacts.js +55 -0
  23. package/dist/server/collections/agent-loop-circuit-states.js +53 -0
  24. package/dist/server/collections/agent-loop-control-settings.js +51 -0
  25. package/dist/server/collections/agent-loop-events.js +27 -0
  26. package/dist/server/collections/agent-loop-path-locks.js +57 -0
  27. package/dist/server/collections/agent-loop-patterns.js +72 -0
  28. package/dist/server/collections/agent-loop-runs.js +163 -2
  29. package/dist/server/collections/agent-loop-steps.js +69 -0
  30. package/dist/server/collections/agent-loop-usage-buckets.js +52 -0
  31. package/dist/server/collections/agent-loop-worktrees.js +55 -0
  32. package/dist/server/migrations/{20260427000000-change-packages-to-text.js → 20260427000002-change-packages-to-text.js} +2 -0
  33. package/dist/server/migrations/20260429000000-add-llm-fields.js +3 -2
  34. package/dist/server/migrations/{20260429000000-fix-inputargs-json-to-text.js → 20260429000001-fix-inputargs-json-to-text.js} +14 -6
  35. package/dist/server/migrations/20260503000000-add-orchestrator-trace-fields.js +2 -1
  36. package/dist/server/migrations/20260524000000-add-agent-loop-fields-to-skill-executions.js +2 -1
  37. package/dist/server/migrations/20260803010000-backfill-loop-control-plane-data.js +262 -0
  38. package/dist/server/plugin.js +52 -150
  39. package/dist/server/resources/agent-loop-approval.js +83 -0
  40. package/dist/server/resources/agent-loop-artifact.js +86 -0
  41. package/dist/server/resources/agent-loop-events-stream.js +130 -0
  42. package/dist/server/resources/agent-loop.js +181 -139
  43. package/dist/server/resources/resource-helpers.js +63 -0
  44. package/dist/server/resources/tracing.js +121 -107
  45. package/dist/server/services/DurableCircuitBreakerService.js +229 -0
  46. package/dist/server/services/HarnessCompiler.js +142 -0
  47. package/dist/server/services/HarnessProfileService.js +168 -0
  48. package/dist/server/services/HarnessSchema.js +167 -0
  49. package/dist/server/services/LoopBudgetService.js +269 -0
  50. package/dist/server/services/LoopControlService.js +139 -0
  51. package/dist/server/services/LoopPatternSchema.js +180 -0
  52. package/dist/server/services/LoopPatternService.js +132 -0
  53. package/dist/server/services/LoopRunRepository.js +205 -0
  54. package/dist/server/services/LoopRunStateMachine.js +389 -0
  55. package/dist/server/services/LoopSchedulerService.js +193 -0
  56. package/dist/server/services/LoopTriggerService.js +128 -0
  57. package/dist/server/services/LoopWorkerService.js +461 -0
  58. package/dist/server/services/PathLockService.js +288 -0
  59. package/dist/server/services/PluginAiRuntimeAdapter.js +215 -0
  60. package/dist/server/services/VerificationSchema.js +59 -0
  61. package/dist/server/services/VerificationService.js +169 -0
  62. package/dist/server/skill-hub/actions/git-import.js +13 -7
  63. package/dist/server/skill-hub/services/RegistrySkillSnapshotService.js +1 -5
  64. package/dist/server/utils/ensure-indexes.js +111 -0
  65. package/dist/server/utils/loop-pattern-context.js +56 -0
  66. package/package.json +2 -2
  67. package/src/client/OrchestratorSettings.tsx +44 -0
  68. package/src/client-v2/components/AgentRunsTab.tsx +576 -494
  69. package/src/client-v2/components/HarnessProfilesTab.tsx +13 -8
  70. package/src/client-v2/components/MemoryInspectorTab.tsx +19 -3
  71. package/src/client-v2/components/TracingTab.tsx +515 -432
  72. package/src/client-v2/hooks/useApiRequest.ts +141 -121
  73. package/src/client-v2/skill-hub/components/SkillMetrics.tsx +8 -6
  74. package/src/locale/en-US.json +52 -28
  75. package/src/locale/vi-VN.json +52 -28
  76. package/src/locale/zh-CN.json +52 -28
  77. package/src/server/__tests__/circuit-breaker.test.ts +225 -146
  78. package/src/server/__tests__/harness-compiler.test.ts +131 -0
  79. package/src/server/__tests__/harness-profile-service.test.ts +116 -0
  80. package/src/server/__tests__/harness-tool-plan.test.ts +148 -0
  81. package/src/server/__tests__/loop-budget-service.test.ts +255 -0
  82. package/src/server/__tests__/loop-control-plane-backfill.test.ts +266 -0
  83. package/src/server/__tests__/loop-pattern-schema.test.ts +56 -0
  84. package/src/server/__tests__/loop-pattern-service.test.ts +148 -0
  85. package/src/server/__tests__/loop-run-state-machine.test.ts +90 -0
  86. package/src/server/__tests__/loop-worker-claim.test.ts +341 -0
  87. package/src/server/__tests__/loop-worker-execution.test.ts +236 -0
  88. package/src/server/__tests__/path-lock-service.test.ts +254 -0
  89. package/src/server/__tests__/smoke.test.ts +62 -21
  90. package/src/server/collections/agent-execution-spans.ts +47 -0
  91. package/src/server/collections/agent-harness-profile-versions.ts +26 -0
  92. package/src/server/collections/agent-harness-profiles.ts +12 -0
  93. package/src/server/collections/agent-loop-action-approvals.ts +38 -0
  94. package/src/server/collections/agent-loop-artifacts.ts +25 -0
  95. package/src/server/collections/agent-loop-circuit-states.ts +23 -0
  96. package/src/server/collections/agent-loop-control-settings.ts +21 -0
  97. package/src/server/collections/agent-loop-events.ts +27 -0
  98. package/src/server/collections/agent-loop-path-locks.ts +27 -0
  99. package/src/server/collections/agent-loop-patterns.ts +42 -0
  100. package/src/server/collections/agent-loop-runs.ts +163 -2
  101. package/src/server/collections/agent-loop-steps.ts +69 -0
  102. package/src/server/collections/agent-loop-usage-buckets.ts +22 -0
  103. package/src/server/collections/agent-loop-worktrees.ts +25 -0
  104. package/src/server/migrations/{20260427000000-change-packages-to-text.ts → 20260427000002-change-packages-to-text.ts} +3 -0
  105. package/src/server/migrations/20260429000000-add-llm-fields.ts +3 -2
  106. package/src/server/migrations/{20260429000000-fix-inputargs-json-to-text.ts → 20260429000001-fix-inputargs-json-to-text.ts} +13 -6
  107. package/src/server/migrations/20260503000000-add-orchestrator-trace-fields.ts +2 -1
  108. package/src/server/migrations/20260524000000-add-agent-loop-fields-to-skill-executions.ts +2 -1
  109. package/src/server/migrations/20260803010000-backfill-loop-control-plane-data.ts +293 -0
  110. package/src/server/plugin.ts +53 -167
  111. package/src/server/resources/agent-loop-approval.ts +52 -0
  112. package/src/server/resources/agent-loop-artifact.ts +56 -0
  113. package/src/server/resources/agent-loop-events-stream.ts +105 -0
  114. package/src/server/resources/agent-loop.ts +202 -143
  115. package/src/server/resources/agent-monitor.ts +482 -482
  116. package/src/server/resources/resource-helpers.ts +33 -0
  117. package/src/server/resources/tracing.ts +145 -137
  118. package/src/server/services/DurableCircuitBreakerService.ts +239 -0
  119. package/src/server/services/HarnessCompiler.ts +133 -0
  120. package/src/server/services/HarnessProfileService.ts +157 -0
  121. package/src/server/services/HarnessSchema.ts +163 -0
  122. package/src/server/services/LoopBudgetService.ts +275 -0
  123. package/src/server/services/LoopControlService.ts +124 -0
  124. package/src/server/services/LoopPatternSchema.ts +167 -0
  125. package/src/server/services/LoopPatternService.ts +143 -0
  126. package/src/server/services/LoopRunRepository.ts +237 -0
  127. package/src/server/services/LoopRunStateMachine.ts +432 -0
  128. package/src/server/services/LoopSchedulerService.ts +199 -0
  129. package/src/server/services/LoopTriggerService.ts +115 -0
  130. package/src/server/services/LoopWorkerService.ts +522 -0
  131. package/src/server/services/PathLockService.ts +321 -0
  132. package/src/server/services/PluginAiRuntimeAdapter.ts +315 -0
  133. package/src/server/services/VerificationSchema.ts +31 -0
  134. package/src/server/services/VerificationService.ts +185 -0
  135. package/src/server/skill-hub/actions/__tests__/git-import.test.ts +62 -0
  136. package/src/server/skill-hub/actions/git-import.ts +9 -3
  137. package/src/server/skill-hub/services/RegistrySkillSnapshotService.ts +1 -5
  138. package/src/server/skill-hub/services/__tests__/RegistrySkillSnapshotService.test.ts +1 -3
  139. package/src/server/utils/ensure-indexes.ts +96 -0
  140. package/src/server/utils/logging.ts +0 -1
  141. package/src/server/utils/loop-pattern-context.ts +20 -0
  142. package/dist/client-v2/214.79650a549273f163.js +0 -10
  143. package/dist/client-v2/253.9f0537713cee9e6c.js +0 -10
  144. package/dist/client-v2/264.718a107e43fc163c.js +0 -10
  145. package/dist/client-v2/418.ce8f5b2b8a229d1d.js +0 -10
  146. package/dist/client-v2/619.bd3c5698b40705c3.js +0 -10
  147. package/dist/client-v2/925.f5370de8f6632d65.js +0 -10
  148. package/dist/server/services/AgentHarness.js +0 -81
  149. package/dist/server/services/AgentLoopController.js +0 -1023
  150. package/dist/server/services/AgentLoopRepository.js +0 -192
  151. package/dist/server/services/AgentLoopService.js +0 -142
  152. package/dist/server/services/AgentPlanValidator.js +0 -99
  153. package/dist/server/services/AgentPlannerService.js +0 -99
  154. package/dist/server/services/CircuitBreaker.js +0 -125
  155. package/dist/server/services/ContextAggregator.js +0 -201
  156. package/dist/server/services/PlanningPromptService.js +0 -95
  157. package/dist/server/tools/agent-loop.js +0 -373
  158. package/dist/server/tools/orchestrator-plan.js +0 -254
  159. package/src/server/__tests__/agent-loop-controller.test.ts +0 -375
  160. package/src/server/__tests__/context-aggregator.test.ts +0 -222
  161. package/src/server/__tests__/parallel-execution.test.ts +0 -318
  162. package/src/server/__tests__/planning-prompt-service.test.ts +0 -23
  163. package/src/server/services/AgentHarness.ts +0 -67
  164. package/src/server/services/AgentLoopController.ts +0 -1263
  165. package/src/server/services/AgentLoopRepository.ts +0 -178
  166. package/src/server/services/AgentLoopService.ts +0 -177
  167. package/src/server/services/AgentPlanValidator.ts +0 -73
  168. package/src/server/services/AgentPlannerService.ts +0 -80
  169. package/src/server/services/CircuitBreaker.ts +0 -126
  170. package/src/server/services/ContextAggregator.ts +0 -239
  171. package/src/server/services/PlanningPromptService.ts +0 -72
  172. package/src/server/tools/agent-loop.ts +0 -360
  173. package/src/server/tools/orchestrator-plan.ts +0 -255
@@ -0,0 +1,133 @@
1
+ import { parseHarnessSettings } from './HarnessSchema';
2
+ import type { HarnessSettings, ToolDecision, ToolEffect } from './HarnessSchema';
3
+
4
+ export type HarnessLayer = {
5
+ source: string;
6
+ settings: unknown;
7
+ };
8
+
9
+ export type CompiledHarness = HarnessSettings & {
10
+ sources: string[];
11
+ };
12
+
13
+ const effectRisk: Record<ToolEffect, number> = {
14
+ read: 0,
15
+ write: 1,
16
+ external: 2,
17
+ };
18
+
19
+ const networkRisk: Record<HarnessSettings['isolation']['networkAccess'], number> = {
20
+ allow: 0,
21
+ restricted: 1,
22
+ deny: 2,
23
+ };
24
+
25
+ function unique(values: string[]) {
26
+ return Array.from(new Set(values)).sort();
27
+ }
28
+
29
+ function union(values: string[][]) {
30
+ return unique(values.flat());
31
+ }
32
+
33
+ function intersectRestrictions(values: string[][]) {
34
+ const restrictions = values.filter((items) => items.length > 0).map((items) => new Set(items));
35
+ if (!restrictions.length) return [];
36
+ return unique(
37
+ Array.from(restrictions[0]).filter((item) => restrictions.every((restriction) => restriction.has(item))),
38
+ );
39
+ }
40
+
41
+ function minimumNullable(values: Array<number | null>) {
42
+ const limits = values.filter((value): value is number => value !== null);
43
+ return limits.length ? Math.min(...limits) : null;
44
+ }
45
+
46
+ function strictestEffect(values: ToolEffect[]): ToolEffect {
47
+ return values.reduce((strictest, value) => (effectRisk[value] > effectRisk[strictest] ? value : strictest), 'read');
48
+ }
49
+
50
+ function strictestNetwork(values: HarnessSettings['isolation']['networkAccess'][]) {
51
+ return values.reduce<HarnessSettings['isolation']['networkAccess']>(
52
+ (strictest, value) => (networkRisk[value] > networkRisk[strictest] ? value : strictest),
53
+ 'allow',
54
+ );
55
+ }
56
+
57
+ export function compileHarness(layers: HarnessLayer[]): CompiledHarness {
58
+ if (!layers.length) {
59
+ throw new Error('At least one harness layer is required.');
60
+ }
61
+ const parsed = layers.map((layer) => ({ source: layer.source, settings: parseHarnessSettings(layer.settings) }));
62
+ const settings = parsed.map((layer) => layer.settings);
63
+ const effectNames = union(settings.map((layer) => Object.keys(layer.tools.effects)));
64
+ const effects = Object.fromEntries(
65
+ effectNames.map((name) => [
66
+ name,
67
+ strictestEffect(
68
+ settings
69
+ .map((layer) => layer.tools.effects[name])
70
+ .filter((effect): effect is ToolEffect => effect !== undefined),
71
+ ),
72
+ ]),
73
+ );
74
+
75
+ return {
76
+ sources: parsed.map((layer) => layer.source),
77
+ tools: {
78
+ allow: intersectRestrictions(settings.map((layer) => layer.tools.allow)),
79
+ ask: union(settings.map((layer) => layer.tools.ask)),
80
+ deny: union(settings.map((layer) => layer.tools.deny)),
81
+ effects,
82
+ trustedPreHandlerTools: intersectRestrictions(settings.map((layer) => layer.tools.trustedPreHandlerTools)),
83
+ },
84
+ memory: {
85
+ enabled: settings.every((layer) => layer.memory.enabled),
86
+ scopes: intersectRestrictions(
87
+ settings.map((layer) => layer.memory.scopes),
88
+ ) as HarnessSettings['memory']['scopes'],
89
+ maxChars: Math.min(...settings.map((layer) => layer.memory.maxChars)),
90
+ },
91
+ delegation: {
92
+ allowedEmployees: intersectRestrictions(settings.map((layer) => layer.delegation.allowedEmployees)),
93
+ maxDepth: minimumNullable(settings.map((layer) => layer.delegation.maxDepth)),
94
+ maxCount: minimumNullable(settings.map((layer) => layer.delegation.maxCount)),
95
+ },
96
+ limits: {
97
+ timeoutMs: minimumNullable(settings.map((layer) => layer.limits.timeoutMs)),
98
+ recursionLimit: minimumNullable(settings.map((layer) => layer.limits.recursionLimit)),
99
+ maxInvocations: minimumNullable(settings.map((layer) => layer.limits.maxInvocations)),
100
+ maxToolCalls: minimumNullable(settings.map((layer) => layer.limits.maxToolCalls)),
101
+ maxInputTokens: minimumNullable(settings.map((layer) => layer.limits.maxInputTokens)),
102
+ maxOutputTokens: minimumNullable(settings.map((layer) => layer.limits.maxOutputTokens)),
103
+ maxTotalTokens: minimumNullable(settings.map((layer) => layer.limits.maxTotalTokens)),
104
+ maxCost: minimumNullable(settings.map((layer) => layer.limits.maxCost)),
105
+ },
106
+ isolation: {
107
+ mode: settings.some((layer) => layer.isolation.mode === 'worktree') ? 'worktree' : 'none',
108
+ requireWorktree: settings.some((layer) => layer.isolation.requireWorktree),
109
+ allowedConnectors: intersectRestrictions(settings.map((layer) => layer.isolation.allowedConnectors)),
110
+ networkAccess: strictestNetwork(settings.map((layer) => layer.isolation.networkAccess)),
111
+ },
112
+ observability: {
113
+ enabled: settings.every((layer) => layer.observability.enabled),
114
+ tracingRetentionDays: Math.min(...settings.map((layer) => layer.observability.tracingRetentionDays)),
115
+ captureInputs: settings.every((layer) => layer.observability.captureInputs),
116
+ captureOutputs: settings.every((layer) => layer.observability.captureOutputs),
117
+ },
118
+ };
119
+ }
120
+
121
+ export function decideTool(
122
+ harness: CompiledHarness,
123
+ toolName: string,
124
+ effect: ToolEffect = harness.tools.effects[toolName] || 'external',
125
+ ): ToolDecision {
126
+ if (harness.tools.deny.includes(toolName)) return 'deny';
127
+ if (harness.tools.ask.includes(toolName)) return 'ask';
128
+
129
+ const explicitlyAllowed = harness.tools.allow.includes(toolName);
130
+ if (!explicitlyAllowed) return 'ask';
131
+ if (effect !== 'read' && !harness.tools.trustedPreHandlerTools.includes(toolName)) return 'ask';
132
+ return 'allow';
133
+ }
@@ -0,0 +1,157 @@
1
+ import type { Database, Model, Transaction } from '@nocobase/database';
2
+ import { parseHarnessSettings, validateHarnessSettings } from './HarnessSchema';
3
+ import type { HarnessSettings } from './HarnessSchema';
4
+
5
+ type HarnessProfileVersion = {
6
+ id: number;
7
+ profileId: number;
8
+ version: number;
9
+ schemaVersion: number;
10
+ status: 'draft' | 'published';
11
+ settings: HarnessSettings;
12
+ publishedById?: number | null;
13
+ publishedAt?: Date | null;
14
+ };
15
+
16
+ function read(record: Model | Record<string, unknown>, key: string) {
17
+ const model = record as Model & { get?: (name: string) => unknown };
18
+ return typeof model.get === 'function' ? model.get(key) : (record as Record<string, unknown>)[key];
19
+ }
20
+
21
+ function positiveId(value: unknown, label: string) {
22
+ const parsed = typeof value === 'number' ? value : Number(value);
23
+ if (!Number.isSafeInteger(parsed) || parsed <= 0) {
24
+ throw new Error(`${label} must be a positive integer.`);
25
+ }
26
+ return parsed;
27
+ }
28
+
29
+ function versionRecord(record: Model | Record<string, unknown>): HarnessProfileVersion {
30
+ return {
31
+ id: positiveId(read(record, 'id'), 'Harness profile version id'),
32
+ profileId: positiveId(read(record, 'profileId'), 'Harness profile id'),
33
+ version: positiveId(read(record, 'version'), 'Harness profile version'),
34
+ schemaVersion: positiveId(read(record, 'schemaVersion'), 'Harness schema version'),
35
+ status: read(record, 'status') === 'published' ? 'published' : 'draft',
36
+ settings: parseHarnessSettings(read(record, 'settings')),
37
+ publishedById: (read(record, 'publishedById') as number | null | undefined) || null,
38
+ publishedAt: (read(record, 'publishedAt') as Date | null | undefined) || null,
39
+ };
40
+ }
41
+
42
+ export class HarnessProfileService {
43
+ constructor(private readonly database: Database) {}
44
+
45
+ validate(settings: unknown) {
46
+ return validateHarnessSettings(settings);
47
+ }
48
+
49
+ async createDraft(input: { profileId: number; settings: unknown; schemaVersion?: number }) {
50
+ const profileId = positiveId(input.profileId, 'Harness profile id');
51
+ const schemaVersion = positiveId(input.schemaVersion || 1, 'Harness schema version');
52
+ const settings = parseHarnessSettings(input.settings);
53
+
54
+ return this.database.sequelize.transaction(async (transaction) => {
55
+ await this.lockProfile(profileId, transaction);
56
+ const versions = this.database.getRepository('agentHarnessProfileVersions');
57
+ const latest = await versions.findOne({
58
+ filter: { profileId },
59
+ sort: ['-version'],
60
+ transaction,
61
+ });
62
+ const nextVersion = latest ? positiveId(read(latest, 'version'), 'Harness profile version') + 1 : 1;
63
+ const draft = await versions.create({
64
+ values: {
65
+ profileId,
66
+ version: nextVersion,
67
+ schemaVersion,
68
+ status: 'draft',
69
+ settings,
70
+ },
71
+ transaction,
72
+ });
73
+ return versionRecord(draft);
74
+ });
75
+ }
76
+
77
+ async updateDraft(versionId: number, settings: unknown) {
78
+ const id = positiveId(versionId, 'Harness profile version id');
79
+ const parsedSettings = parseHarnessSettings(settings);
80
+ const versions = this.database.getRepository('agentHarnessProfileVersions');
81
+ const version = await versions.findOne({ filterByTk: id });
82
+ if (!version) throw new Error(`Harness profile version ${id} was not found.`);
83
+ if (read(version, 'status') !== 'draft') {
84
+ throw new Error('Published Harness profile versions are immutable.');
85
+ }
86
+ await versions.update({ filterByTk: id, values: { settings: parsedSettings } });
87
+ const updated = await versions.findOne({ filterByTk: id });
88
+ if (!updated) throw new Error(`Harness profile version ${id} was not found after update.`);
89
+ return versionRecord(updated);
90
+ }
91
+
92
+ async publish(versionId: number, publishedById?: number) {
93
+ const id = positiveId(versionId, 'Harness profile version id');
94
+ return this.database.sequelize.transaction(async (transaction) => {
95
+ const versions = this.database.getRepository('agentHarnessProfileVersions');
96
+ const candidate = await versions.findOne({ filterByTk: id, transaction });
97
+ if (!candidate) throw new Error(`Harness profile version ${id} was not found.`);
98
+ const profileId = positiveId(read(candidate, 'profileId'), 'Harness profile id');
99
+ await this.lockProfile(profileId, transaction);
100
+
101
+ const current = await versions.findOne({ filterByTk: id, transaction });
102
+ if (!current) throw new Error(`Harness profile version ${id} was not found.`);
103
+ if (read(current, 'status') === 'published') {
104
+ return versionRecord(current);
105
+ }
106
+
107
+ const settings = parseHarnessSettings(read(current, 'settings'));
108
+ const now = new Date();
109
+ await versions.update({
110
+ filterByTk: id,
111
+ values: {
112
+ status: 'published',
113
+ settings,
114
+ publishedById: publishedById ? positiveId(publishedById, 'Publisher id') : null,
115
+ publishedAt: now,
116
+ },
117
+ transaction,
118
+ });
119
+ await this.database.getRepository('agentHarnessProfiles').update({
120
+ filterByTk: profileId,
121
+ values: {
122
+ currentVersionId: id,
123
+ schemaVersion: positiveId(read(current, 'schemaVersion'), 'Harness schema version'),
124
+ },
125
+ transaction,
126
+ });
127
+ const published = await versions.findOne({ filterByTk: id, transaction });
128
+ if (!published) throw new Error(`Harness profile version ${id} was not found after publish.`);
129
+ return versionRecord(published);
130
+ });
131
+ }
132
+
133
+ async getPublishedByTag(tag: string) {
134
+ const normalizedTag = tag.trim();
135
+ if (!normalizedTag) throw new Error('Harness profile tag is required.');
136
+ const profile = await this.database.getRepository('agentHarnessProfiles').findOne({
137
+ filter: { tag: normalizedTag, enabled: true },
138
+ });
139
+ if (!profile) return null;
140
+ const currentVersionId = Number(read(profile, 'currentVersionId'));
141
+ if (!Number.isSafeInteger(currentVersionId) || currentVersionId <= 0) return null;
142
+ const version = await this.database.getRepository('agentHarnessProfileVersions').findOne({
143
+ filter: { id: currentVersionId, status: 'published' },
144
+ });
145
+ return version ? versionRecord(version) : null;
146
+ }
147
+
148
+ private async lockProfile(profileId: number, transaction: Transaction) {
149
+ const profile = await this.database.getRepository('agentHarnessProfiles').findOne({
150
+ filterByTk: profileId,
151
+ transaction,
152
+ lock: transaction.LOCK.UPDATE,
153
+ });
154
+ if (!profile) throw new Error(`Harness profile ${profileId} was not found.`);
155
+ return profile;
156
+ }
157
+ }
@@ -0,0 +1,163 @@
1
+ import { z } from 'zod';
2
+
3
+ export const toolDecisionSchema = z.enum(['allow', 'ask', 'deny']);
4
+ export const toolEffectSchema = z.enum(['read', 'write', 'external']);
5
+
6
+ const nullableLimit = z.number().finite().nonnegative().nullable().default(null);
7
+ const nullablePositiveLimit = z.number().finite().positive().nullable().default(null);
8
+
9
+ export const harnessSettingsSchema = z
10
+ .object({
11
+ tools: z
12
+ .object({
13
+ allow: z.array(z.string().min(1)).default([]),
14
+ ask: z.array(z.string().min(1)).default([]),
15
+ deny: z.array(z.string().min(1)).default([]),
16
+ effects: z.record(toolEffectSchema).default({}),
17
+ trustedPreHandlerTools: z.array(z.string().min(1)).default([]),
18
+ })
19
+ .default({}),
20
+ memory: z
21
+ .object({
22
+ enabled: z.boolean().default(true),
23
+ scopes: z.array(z.enum(['public', 'user', 'agent_user'])).default(['public', 'user', 'agent_user']),
24
+ maxChars: z.number().int().min(500).max(20_000).default(6000),
25
+ })
26
+ .default({}),
27
+ delegation: z
28
+ .object({
29
+ allowedEmployees: z.array(z.string().min(1)).default([]),
30
+ maxDepth: z.number().int().nonnegative().nullable().default(null),
31
+ maxCount: z.number().int().nonnegative().nullable().default(null),
32
+ })
33
+ .default({}),
34
+ limits: z
35
+ .object({
36
+ timeoutMs: nullablePositiveLimit,
37
+ recursionLimit: z.number().int().positive().nullable().default(null),
38
+ maxInvocations: z.number().int().nonnegative().nullable().default(null),
39
+ maxToolCalls: z.number().int().nonnegative().nullable().default(null),
40
+ maxInputTokens: z.number().int().nonnegative().nullable().default(null),
41
+ maxOutputTokens: z.number().int().nonnegative().nullable().default(null),
42
+ maxTotalTokens: z.number().int().nonnegative().nullable().default(null),
43
+ maxCost: nullableLimit,
44
+ })
45
+ .default({}),
46
+ isolation: z
47
+ .object({
48
+ mode: z.enum(['none', 'worktree']).default('none'),
49
+ requireWorktree: z.boolean().default(false),
50
+ allowedConnectors: z.array(z.string().min(1)).default([]),
51
+ networkAccess: z.enum(['deny', 'restricted', 'allow']).default('restricted'),
52
+ })
53
+ .default({}),
54
+ observability: z
55
+ .object({
56
+ enabled: z.boolean().default(true),
57
+ tracingRetentionDays: z.number().int().positive().max(3650).default(30),
58
+ captureInputs: z.boolean().default(true),
59
+ captureOutputs: z.boolean().default(true),
60
+ })
61
+ .default({}),
62
+ })
63
+ .strict();
64
+
65
+ export type HarnessSettings = z.infer<typeof harnessSettingsSchema>;
66
+ export type ToolDecision = z.infer<typeof toolDecisionSchema>;
67
+ export type ToolEffect = z.infer<typeof toolEffectSchema>;
68
+
69
+ function isRecord(value: unknown): value is Record<string, unknown> {
70
+ return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
71
+ }
72
+
73
+ function stringArray(value: unknown) {
74
+ return Array.isArray(value)
75
+ ? value.filter((item): item is string => typeof item === 'string' && item.length > 0)
76
+ : [];
77
+ }
78
+
79
+ function optionalNumber(value: unknown) {
80
+ return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
81
+ }
82
+
83
+ export function normalizeHarnessSettings(value: unknown): unknown {
84
+ if (!isRecord(value)) return value;
85
+ const source = value;
86
+ const tools = isRecord(source.tools) ? source.tools : {};
87
+ const memory = isRecord(source.memory) ? source.memory : {};
88
+ const delegation = isRecord(source.delegation) ? source.delegation : {};
89
+ const limits = isRecord(source.limits) ? source.limits : {};
90
+ const isolation = isRecord(source.isolation) ? source.isolation : {};
91
+ const observability = isRecord(source.observability) ? source.observability : {};
92
+ const knownKeys = new Set([
93
+ 'tools',
94
+ 'memory',
95
+ 'delegation',
96
+ 'limits',
97
+ 'isolation',
98
+ 'observability',
99
+ 'nativeObserverEnabled',
100
+ 'memoryInjectionEnabled',
101
+ 'memoryScopes',
102
+ 'maxMemoryContextChars',
103
+ 'maxContextChars',
104
+ 'tracingRetentionDays',
105
+ 'knowledgeScopes',
106
+ 'preferFileTools',
107
+ 'requirePlanApproval',
108
+ 'allowSubAgents',
109
+ 'allowToolCalls',
110
+ 'maxParallelSubAgents',
111
+ 'maxControllerSteps',
112
+ 'requireVerification',
113
+ ]);
114
+ const unknownSettings = Object.fromEntries(Object.entries(source).filter(([key]) => !knownKeys.has(key)));
115
+
116
+ return {
117
+ ...unknownSettings,
118
+ tools: {
119
+ ...tools,
120
+ allow: stringArray(tools.allow),
121
+ ask: stringArray(tools.ask),
122
+ deny: stringArray(tools.deny),
123
+ effects: isRecord(tools.effects) ? tools.effects : {},
124
+ trustedPreHandlerTools: stringArray(tools.trustedPreHandlerTools),
125
+ },
126
+ memory: {
127
+ ...memory,
128
+ enabled:
129
+ typeof memory.enabled === 'boolean'
130
+ ? memory.enabled
131
+ : typeof source.memoryInjectionEnabled === 'boolean'
132
+ ? source.memoryInjectionEnabled
133
+ : undefined,
134
+ scopes: Array.isArray(memory.scopes) ? memory.scopes : source.memoryScopes,
135
+ maxChars: optionalNumber(memory.maxChars) ?? optionalNumber(source.maxMemoryContextChars),
136
+ },
137
+ delegation: {
138
+ ...delegation,
139
+ allowedEmployees: stringArray(delegation.allowedEmployees),
140
+ },
141
+ limits,
142
+ isolation,
143
+ observability: {
144
+ ...observability,
145
+ enabled:
146
+ typeof observability.enabled === 'boolean'
147
+ ? observability.enabled
148
+ : typeof source.nativeObserverEnabled === 'boolean'
149
+ ? source.nativeObserverEnabled
150
+ : undefined,
151
+ tracingRetentionDays:
152
+ optionalNumber(observability.tracingRetentionDays) ?? optionalNumber(source.tracingRetentionDays),
153
+ },
154
+ };
155
+ }
156
+
157
+ export function parseHarnessSettings(value: unknown): HarnessSettings {
158
+ return harnessSettingsSchema.parse(normalizeHarnessSettings(value));
159
+ }
160
+
161
+ export function validateHarnessSettings(value: unknown) {
162
+ return harnessSettingsSchema.safeParse(normalizeHarnessSettings(value));
163
+ }