@atolis-hq/wake 0.4.99 → 0.4.101

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 (62) hide show
  1. package/dist/src/activities/agent/agent-activity.js +17 -2
  2. package/dist/src/bootstrap/artifact-mcp.d.ts +1 -0
  3. package/dist/src/bootstrap/artifact-mcp.js +27 -1
  4. package/dist/src/bootstrap/composition-root.js +6 -1
  5. package/dist/src/bootstrap/config/root-schema.d.ts +14 -0
  6. package/dist/src/bootstrap/delegation-authority.d.ts +10 -0
  7. package/dist/src/bootstrap/delegation-authority.js +52 -0
  8. package/dist/src/bootstrap/integration-runtime.js +4 -2
  9. package/dist/src/bootstrap/surface-api-delivery.d.ts +4 -0
  10. package/dist/src/bootstrap/surface-api-delivery.js +35 -0
  11. package/dist/src/bootstrap/surface-api-work-applications.js +2 -0
  12. package/dist/src/bootstrap/version.js +1 -1
  13. package/dist/src/control-plane/application/activation-scheduler-ports.d.ts +3 -1
  14. package/dist/src/control-plane/application/advance-once-dispatch.d.ts +2 -11
  15. package/dist/src/control-plane/application/advance-once-dispatch.js +11 -24
  16. package/dist/src/control-plane/application/trigger-recovery.js +2 -1
  17. package/dist/src/control-plane/application/trigger-workflow.d.ts +2 -1
  18. package/dist/src/control-plane/application/work-cancellation-policy.d.ts +1 -0
  19. package/dist/src/control-plane/application/work-cancellation-policy.js +6 -1
  20. package/dist/src/control-plane/domain/delivery-capacity.d.ts +12 -0
  21. package/dist/src/control-plane/domain/delivery-capacity.js +41 -0
  22. package/dist/src/control-plane/domain/dispatch-policy.d.ts +1 -0
  23. package/dist/src/control-plane/domain/dispatch-policy.js +6 -0
  24. package/dist/src/control-plane/domain/open-work-policy.d.ts +3 -0
  25. package/dist/src/control-plane/domain/open-work-policy.js +12 -8
  26. package/dist/src/execution/application/repository-assignments.d.ts +1 -1
  27. package/dist/src/execution/application/repository-assignments.js +7 -4
  28. package/dist/src/execution/application/run-repository.d.ts +2 -2
  29. package/dist/src/execution/application/run-repository.js +3 -3
  30. package/dist/src/orchestration/application/delegated-work.d.ts +52 -0
  31. package/dist/src/orchestration/application/delegated-work.js +61 -2
  32. package/dist/src/orchestration/application/delegation-commands.d.ts +119 -0
  33. package/dist/src/orchestration/application/delegation-commands.js +100 -0
  34. package/dist/src/orchestration/application/delegation-gate.d.ts +4 -1
  35. package/dist/src/orchestration/application/delegation-gate.js +17 -3
  36. package/dist/src/orchestration/application/orchestration-service.d.ts +150 -2
  37. package/dist/src/orchestration/application/orchestration-service.js +45 -4
  38. package/dist/src/orchestration/contracts/config.d.ts +16 -0
  39. package/dist/src/orchestration/contracts/config.js +10 -0
  40. package/dist/src/orchestration/contracts/delegation-ports.d.ts +10 -1
  41. package/dist/src/orchestration/contracts/delegation.d.ts +34 -0
  42. package/dist/src/orchestration/contracts/delegation.js +8 -0
  43. package/dist/src/orchestration/domain/compiler.js +7 -0
  44. package/dist/src/orchestration/index.d.ts +3 -0
  45. package/dist/src/orchestration/index.js +1 -0
  46. package/dist/src/surfaces/api/contracts/work.d.ts +14 -0
  47. package/dist/src/surfaces/index.d.ts +1 -0
  48. package/dist/src/surfaces/index.js +1 -0
  49. package/dist/src/surfaces/mcp/delegation.d.ts +9 -0
  50. package/dist/src/surfaces/mcp/delegation.js +25 -0
  51. package/dist/src/surfaces/web-assets/assets/index-C5R-aWzH.js +1192 -0
  52. package/dist/src/surfaces/web-assets/index.html +1 -1
  53. package/dist/src/work/application/delivery-availability.d.ts +17 -0
  54. package/dist/src/work/application/delivery-availability.js +20 -0
  55. package/dist/src/work/application/work-repository.d.ts +2 -2
  56. package/dist/src/work/application/work-repository.js +2 -2
  57. package/dist/src/work/application/work-service.d.ts +2 -2
  58. package/dist/src/work/application/work-service.js +2 -2
  59. package/dist/src/work/index.d.ts +1 -0
  60. package/dist/src/work/index.js +1 -0
  61. package/package.json +1 -1
  62. package/dist/src/surfaces/web-assets/assets/index-s9CWgq-s.js +0 -1192
@@ -1,9 +1,10 @@
1
- import type { DelegationArtifacts, DelegationRepositories } from '../contracts/delegation-ports.js';
1
+ import type { DelegationArtifacts, DelegationAuthority, DelegationRepositories } from '../contracts/delegation-ports.js';
2
+ import type { DelegationCaller, DelegationSubmission } from '../contracts/delegation.js';
2
3
  import type { ResourceTransitionEvidence } from './resource-transition-evidence.js';
3
4
  import type { CommandContext, EventJournal, ProjectionStore } from '@atolis-hq/eventing';
4
5
  import { type ActivationId, type ActivityOutcome } from '../../activities/index.js';
5
6
  import type { ExecutionFailureCode } from '../../execution/index.js';
6
- import { type WorkItemId, type WorkService } from '../../work/index.js';
7
+ import { type WorkItemId, type WorkItemView, type WorkService } from '../../work/index.js';
7
8
  import type { StartWorkflowInstance } from '../contracts/commands.js';
8
9
  import type { CompiledWorkflow, TransitionTarget } from '../contracts/config.js';
9
10
  import type { ChildWorkflowRequest, OrchestrationSignal, SignalExpectation, SupplementalActivityRequest } from '../contracts/events.js';
@@ -13,6 +14,7 @@ import { AdvanceWorkflow } from './advance-workflow.js';
13
14
  import { type ConversationCommandInput, type ConversationCommandResult } from './conversation-command.js';
14
15
  import type { AgentActivityClassifier } from './pending-activations.js';
15
16
  export declare class OrchestrationService {
17
+ private readonly delegationCommands;
16
18
  private readonly delegationGate;
17
19
  private readonly delegatedWork;
18
20
  private readonly repository;
@@ -30,6 +32,7 @@ export declare class OrchestrationService {
30
32
  private readonly definitions;
31
33
  private readonly work;
32
34
  constructor(journal: EventJournal, work: WorkService, definitions: Readonly<Record<string, CompiledWorkflow>>, projections?: ProjectionStore, isAgentActivity?: AgentActivityClassifier, delegation?: DelegationDependenciesFactory);
35
+ repositoryAuthority(workItemId: string): Promise<string[] | undefined>;
33
36
  repositoryAssignment(workItemId: string): Promise<{
34
37
  resourceId: string;
35
38
  sourceRef: string;
@@ -37,6 +40,150 @@ export declare class OrchestrationService {
37
40
  sourceRevision: string;
38
41
  } | undefined>;
39
42
  isActivationAccepted(id: string, item?: string): Promise<boolean>;
43
+ submitDelegation(caller: DelegationCaller, input: DelegationSubmission, context: CommandContext): Promise<{
44
+ cohortId: string;
45
+ parentWorkflowInstanceId: WorkflowInstanceId;
46
+ parentWorkItemId: WorkItemId;
47
+ rootWorkItemId: WorkItemId;
48
+ activationId: ActivationId;
49
+ runId: string;
50
+ ancestors: WorkItemId[];
51
+ maxDepth: number;
52
+ maxDescendants: number;
53
+ children: {
54
+ assignmentId: string;
55
+ objective: string;
56
+ criteria: string[];
57
+ workflowName: import("../contracts/identifiers.js").WorkflowName;
58
+ workflowFingerprint: string;
59
+ context: {
60
+ workItemId: WorkItemId;
61
+ revisionId: string;
62
+ }[];
63
+ outputs: ({
64
+ name: string;
65
+ path: string;
66
+ } | {
67
+ name: string;
68
+ kind: "change";
69
+ requireReview?: boolean | undefined;
70
+ requireChecks?: boolean | undefined;
71
+ })[];
72
+ workItemId: WorkItemId;
73
+ workflowInstanceId: WorkflowInstanceId;
74
+ grantId: string;
75
+ repositoryResourceIds?: string[] | undefined;
76
+ repository?: {
77
+ resourceId: string;
78
+ sourceRef: string;
79
+ pullRequestBase: string;
80
+ sourceRevision: string;
81
+ } | undefined;
82
+ }[];
83
+ maxConcurrentRuns?: number | undefined;
84
+ }>;
85
+ inspectDelegation(caller: DelegationCaller, context: CommandContext): Promise<{
86
+ policy: {
87
+ workflows: string[];
88
+ maxDepth: number;
89
+ maxDescendants: number;
90
+ maxConcurrentRuns: number;
91
+ repositories?: string[] | undefined;
92
+ } | null;
93
+ repositories: string[];
94
+ tree: {
95
+ settled: boolean;
96
+ children: {
97
+ work: WorkItemView | null;
98
+ workflow: WorkflowInstanceView | null;
99
+ assignmentId: string;
100
+ objective: string;
101
+ criteria: string[];
102
+ workflowName: import("../contracts/identifiers.js").WorkflowName;
103
+ workflowFingerprint: string;
104
+ context: {
105
+ workItemId: WorkItemId;
106
+ revisionId: string;
107
+ }[];
108
+ outputs: ({
109
+ name: string;
110
+ path: string;
111
+ } | {
112
+ name: string;
113
+ kind: "change";
114
+ requireReview?: boolean | undefined;
115
+ requireChecks?: boolean | undefined;
116
+ })[];
117
+ workItemId: WorkItemId;
118
+ workflowInstanceId: WorkflowInstanceId;
119
+ grantId: string;
120
+ repositoryResourceIds?: string[] | undefined;
121
+ repository?: {
122
+ resourceId: string;
123
+ sourceRef: string;
124
+ pullRequestBase: string;
125
+ sourceRevision: string;
126
+ } | undefined;
127
+ }[];
128
+ cohortId: string;
129
+ parentWorkflowInstanceId: WorkflowInstanceId;
130
+ parentWorkItemId: WorkItemId;
131
+ rootWorkItemId: WorkItemId;
132
+ activationId: ActivationId;
133
+ runId: string;
134
+ ancestors: WorkItemId[];
135
+ maxDepth: number;
136
+ maxDescendants: number;
137
+ maxConcurrentRuns?: number | undefined;
138
+ }[];
139
+ }>;
140
+ deliveryTree(id: WorkItemId): Promise<{
141
+ settled: boolean;
142
+ children: {
143
+ work: WorkItemView | null;
144
+ workflow: WorkflowInstanceView | null;
145
+ assignmentId: string;
146
+ objective: string;
147
+ criteria: string[];
148
+ workflowName: import("../contracts/identifiers.js").WorkflowName;
149
+ workflowFingerprint: string;
150
+ context: {
151
+ workItemId: WorkItemId;
152
+ revisionId: string;
153
+ }[];
154
+ outputs: ({
155
+ name: string;
156
+ path: string;
157
+ } | {
158
+ name: string;
159
+ kind: "change";
160
+ requireReview?: boolean | undefined;
161
+ requireChecks?: boolean | undefined;
162
+ })[];
163
+ workItemId: WorkItemId;
164
+ workflowInstanceId: WorkflowInstanceId;
165
+ grantId: string;
166
+ repositoryResourceIds?: string[] | undefined;
167
+ repository?: {
168
+ resourceId: string;
169
+ sourceRef: string;
170
+ pullRequestBase: string;
171
+ sourceRevision: string;
172
+ } | undefined;
173
+ }[];
174
+ cohortId: string;
175
+ parentWorkflowInstanceId: WorkflowInstanceId;
176
+ parentWorkItemId: WorkItemId;
177
+ rootWorkItemId: WorkItemId;
178
+ activationId: ActivationId;
179
+ runId: string;
180
+ ancestors: WorkItemId[];
181
+ maxDepth: number;
182
+ maxDescendants: number;
183
+ maxConcurrentRuns?: number | undefined;
184
+ }[]>;
185
+ deliveryRunLimit(id: WorkItemId): Promise<number | undefined>;
186
+ hasLiveDelegatedWork(id: WorkItemId): Promise<boolean>;
40
187
  joinedDelegationResults(id: WorkflowInstanceId, cohortId: string): Promise<readonly {
41
188
  cohortId: string;
42
189
  childWorkItemId: WorkItemId;
@@ -138,6 +285,7 @@ type DelegationDependenciesFactory = (queries: {
138
285
  isActivationAccepted: (activationId: string, workItemId?: string) => Promise<boolean>;
139
286
  }) => {
140
287
  artifacts: DelegationArtifacts;
288
+ authority?: DelegationAuthority;
141
289
  repositories?: DelegationRepositories;
142
290
  runHasEnded: (runId: string) => Promise<boolean>;
143
291
  };
@@ -1,5 +1,6 @@
1
1
  import { DeferredSignals } from './deferred-signals.js';
2
2
  import { DelegatedWork } from './delegated-work.js';
3
+ import { DelegationCommands } from './delegation-commands.js';
3
4
  import { DelegationGate } from './delegation-gate.js';
4
5
  import { expireTimedOutWaits } from './expire-timed-out-waits.js';
5
6
  import { recoverPolicyBlockedMerges } from './policy-blocked-merge-recovery.js';
@@ -8,7 +9,7 @@ import { selectOrchestrationEvent } from '../contracts/event-decoder.js';
8
9
  import { OrchestrationEventType } from '../contracts/events.js';
9
10
  import { commandName, workflowInstanceId as toWorkflowInstanceId, } from '../contracts/identifiers.js';
10
11
  import { childOrchestrationGroupStream, workflowInstanceStream } from '../contracts/streams.js';
11
- import { ApprovalAuthorityKind, ConversationBuiltInCommand } from '../contracts/vocabulary.js';
12
+ import { ApprovalAuthorityKind, ConversationBuiltInCommand, WorkflowStatus, } from '../contracts/vocabulary.js';
12
13
  import { isGroupBudgetExtensionEligible, isNeedsClarificationResumeEligible, isPlainReplyResumeEligible, selectChangesResumeTargets, } from '../domain/operator-retry-policy.js';
13
14
  import { AcceptActivityOutcome } from './accept-activity-outcome.js';
14
15
  import { AcceptSignal } from './accept-signal.js';
@@ -23,6 +24,7 @@ import { StartWorkflow } from './start-workflow.js';
23
24
  import { continuesWaitingForSameWatchGate } from './watch-child-transitions.js';
24
25
  import { WorkflowDefinitionRegistry } from './workflow-definition-registry.js';
25
26
  export class OrchestrationService {
27
+ delegationCommands;
26
28
  delegationGate;
27
29
  delegatedWork;
28
30
  repository;
@@ -45,7 +47,7 @@ export class OrchestrationService {
45
47
  this.work = work;
46
48
  const repository = new OrchestrationRepository(journal);
47
49
  this.repository = repository;
48
- this.delegationGate = new DelegationGate(repository);
50
+ this.delegationGate = new DelegationGate(repository, work);
49
51
  const dependencies = delegation?.({
50
52
  isActivationAccepted: (id, item) => this.isActivationAccepted(id, item),
51
53
  });
@@ -53,10 +55,12 @@ export class OrchestrationService {
53
55
  this.definitions = new WorkflowDefinitionRegistry(journal, projections, definitions);
54
56
  this.startWorkflow = new StartWorkflow(repository, this.claims, work, this.definitions);
55
57
  this.delegatedWork = new DelegatedWork(repository, work, this.claims, this.definitions, this.startWorkflow, {
58
+ authority: dependencies?.authority,
56
59
  artifacts: dependencies?.artifacts ?? unavailableArtifacts,
57
60
  repositories: dependencies?.repositories,
58
61
  runHasEnded: dependencies?.runHasEnded ?? unavailableRunCompletion,
59
62
  });
63
+ this.delegationCommands = new DelegationCommands(repository, work, this.startWorkflow, this.definitions, this.delegatedWork, dependencies?.authority ?? unavailableDelegationAuthority);
60
64
  this.advanceWorkflow = new AdvanceWorkflow(repository, this.startWorkflow, (command, context) => this.acceptOutcome(command, context), isAgentActivity);
61
65
  this.acceptWorkflowSignal = new AcceptSignal(repository, this.startWorkflow, work);
62
66
  this.deferredSignals = new DeferredSignals(repository, (id, signal, context) => this.delegationGate.run(id, () => this.acceptWorkflowSignal.execute(id, signal, context)), (id, target, evidenceId, context) => this.delegationGate.run(id, () => this.advanceWorkflow.applyResourceTransition(id, target, evidenceId, context)), (id) => this.delegationGate.fenced(id));
@@ -67,6 +71,9 @@ export class OrchestrationService {
67
71
  await this.deferredSignals.reconcile(context);
68
72
  });
69
73
  }
74
+ repositoryAuthority(workItemId) {
75
+ return this.delegatedWork.repositoryScope(workItemId);
76
+ }
70
77
  repositoryAssignment(workItemId) {
71
78
  return this.delegatedWork.repositoryFor(workItemId);
72
79
  }
@@ -75,6 +82,31 @@ export class OrchestrationService {
75
82
  (item === undefined || view.workItemId === item) &&
76
83
  view.acceptedOutcomes.some((accepted) => accepted === id));
77
84
  }
85
+ submitDelegation(caller, input, context) {
86
+ return this.delegationCommands.submit(caller, input, context);
87
+ }
88
+ inspectDelegation(caller, context) {
89
+ return this.delegationCommands.inspect(caller, context);
90
+ }
91
+ deliveryTree(id) {
92
+ return this.delegatedWork.inspect(id);
93
+ }
94
+ deliveryRunLimit(id) {
95
+ return this.delegatedWork.runLimit(id);
96
+ }
97
+ async hasLiveDelegatedWork(id) {
98
+ // A concluded root can never join its cohorts, so nothing remains to wait for.
99
+ const root = await this.work.get(id);
100
+ if (root === null || root.deleted === true || root.state !== WorkStatus.Open)
101
+ return false;
102
+ return (await this.deliveryTree(id)).some((cohort) => !cohort.settled &&
103
+ cohort.children.some(({ work, workflow }) => work !== null &&
104
+ work.deleted !== true &&
105
+ work.state === WorkStatus.Open &&
106
+ (workflow === null ||
107
+ (workflow.status !== WorkflowStatus.Completed &&
108
+ workflow.status !== WorkflowStatus.Superseded))));
109
+ }
78
110
  joinedDelegationResults(id, cohortId) {
79
111
  return this.delegatedWork.results(id, cohortId);
80
112
  }
@@ -186,7 +218,10 @@ export class OrchestrationService {
186
218
  markActivationStarted(workflowInstanceId, activationId, context) {
187
219
  return this.advanceWorkflow.markActivationStarted(workflowInstanceId, activationId, context);
188
220
  }
189
- validateActivationDispatch(workflowInstanceId, context) {
221
+ async validateActivationDispatch(workflowInstanceId, context) {
222
+ const view = (await this.repository.load(workflowInstanceId)).view;
223
+ if (view !== null && (await this.delegationGate.unavailable(view)))
224
+ return false;
190
225
  return this.childWorkflows.validateChildDispatch(workflowInstanceId, context);
191
226
  }
192
227
  block(workflowInstanceId, reason, context) {
@@ -264,7 +299,9 @@ export class OrchestrationService {
264
299
  }
265
300
  async listPendingActivations(workItemId) {
266
301
  const entries = await this.advanceWorkflow.listPendingActivations(workItemId);
267
- return entries.filter((entry) => this.delegationGate.allows(entry.workflow));
302
+ const available = await Promise.all(entries.map(async (entry) => this.delegationGate.allows(entry.workflow) &&
303
+ !(await this.delegationGate.unavailable(entry.workflow))));
304
+ return entries.filter((_, index) => available[index]);
268
305
  }
269
306
  listWaiting(signalKind) {
270
307
  return this.advanceWorkflow.listWaiting(signalKind);
@@ -369,3 +406,7 @@ const unavailableArtifacts = {
369
406
  registerChild: unavailableRunCompletion,
370
407
  qualifyingOutputs: unavailableRunCompletion,
371
408
  };
409
+ const unavailableDelegationAuthority = {
410
+ assertCaller: unavailableRunCompletion,
411
+ repositories: unavailableRunCompletion,
412
+ };
@@ -214,8 +214,23 @@ export declare const supplementalCommandConfigSchema: z.ZodObject<{
214
214
  watch: "watch";
215
215
  }>>>;
216
216
  }, z.core.$strict>;
217
+ export declare const delegationPolicySchema: z.ZodObject<{
218
+ workflows: z.ZodArray<z.ZodString>;
219
+ repositories: z.ZodOptional<z.ZodArray<z.ZodString>>;
220
+ maxDepth: z.ZodNumber;
221
+ maxDescendants: z.ZodNumber;
222
+ maxConcurrentRuns: z.ZodNumber;
223
+ }, z.core.$strict>;
224
+ export type DelegationPolicy = z.infer<typeof delegationPolicySchema>;
217
225
  export declare const workflowDefinitionConfigSchema: z.ZodObject<{
218
226
  entry: z.ZodOptional<z.ZodString>;
227
+ delegation: z.ZodOptional<z.ZodObject<{
228
+ workflows: z.ZodArray<z.ZodString>;
229
+ repositories: z.ZodOptional<z.ZodArray<z.ZodString>>;
230
+ maxDepth: z.ZodNumber;
231
+ maxDescendants: z.ZodNumber;
232
+ maxConcurrentRuns: z.ZodNumber;
233
+ }, z.core.$strict>>;
219
234
  commands: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
220
235
  activity: z.ZodString;
221
236
  with: z.ZodOptional<z.ZodUnknown>;
@@ -414,6 +429,7 @@ export interface CompiledWatch extends Omit<WatchConfig, 'workflow' | 'while' |
414
429
  };
415
430
  }
416
431
  export interface CompiledWorkflow {
432
+ readonly delegation?: DelegationPolicy;
417
433
  readonly remainingAgentSteps?: Readonly<Record<StageName, number>>;
418
434
  readonly name: WorkflowName;
419
435
  readonly entry: StageName;
@@ -151,9 +151,19 @@ export const supplementalCommandConfigSchema = z
151
151
  allowedActors: z.array(approvalAuthorityKind).min(1).readonly(),
152
152
  })
153
153
  .strict();
154
+ export const delegationPolicySchema = z
155
+ .object({
156
+ workflows: z.array(identifier).min(1),
157
+ repositories: z.array(identifier).min(1).optional(),
158
+ maxDepth: z.number().int().positive(),
159
+ maxDescendants: z.number().int().positive(),
160
+ maxConcurrentRuns: z.number().int().positive(),
161
+ })
162
+ .strict();
154
163
  export const workflowDefinitionConfigSchema = z
155
164
  .object({
156
165
  entry: identifier.optional(),
166
+ delegation: delegationPolicySchema.optional(),
157
167
  commands: z.record(commandName, supplementalCommandConfigSchema).optional(),
158
168
  watches: z.array(watchConfigSchema).readonly().optional(),
159
169
  stages: z
@@ -1,6 +1,6 @@
1
1
  import type { CommandContext } from '@atolis-hq/eventing';
2
2
  import type { RepositoryAssignment } from '../../execution/index.js';
3
- import type { DelegatedAssignment, DelegationReservation, DelegationResult, DelegationRevisionReference, RepositoryAssignmentRequest } from './delegation.js';
3
+ import type { DelegatedAssignment, DelegationCaller, DelegationReservation, DelegationResult, DelegationRevisionReference, RepositoryAssignmentRequest } from './delegation.js';
4
4
  import type { WorkflowInstanceView } from './views.js';
5
5
  /** Trusted Bootstrap adapters; no provider, Run or session authority is supplied by assignments. */
6
6
  export interface DelegationArtifacts {
@@ -13,6 +13,15 @@ export interface DelegationArtifacts {
13
13
  }, context: CommandContext): Promise<void>;
14
14
  qualifyingOutputs(child: WorkflowInstanceView, outputs: DelegatedAssignment['outputs']): Promise<DelegationResult['outputs'] | null>;
15
15
  }
16
+ export interface DelegationAuthority {
17
+ assertCaller(caller: DelegationCaller, parent: WorkflowInstanceView): Promise<void>;
18
+ repositories(parent: WorkflowInstanceView): Promise<readonly string[]>;
19
+ /**
20
+ * Records the root's default repository scope from trusted provider identity when no
21
+ * Repository Resource is yet correlated. Agent input never reaches this binding.
22
+ */
23
+ bindRepositoryScope?(root: WorkflowInstanceView, context: CommandContext): Promise<void>;
24
+ }
16
25
  /** Resolves only repositories already authorized by the parent's resource scope. */
17
26
  export interface DelegationRepositories {
18
27
  resolve(parent: WorkflowInstanceView, request: RepositoryAssignmentRequest): Promise<RepositoryAssignment>;
@@ -18,6 +18,7 @@ export declare const delegatedAssignmentSchema: z.ZodObject<{
18
18
  objective: z.ZodString;
19
19
  criteria: z.ZodArray<z.ZodString>;
20
20
  workflowName: z.ZodPipe<z.ZodString, z.ZodTransform<import("./identifiers.js").WorkflowName, string>>;
21
+ repositoryResourceIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
21
22
  workflowFingerprint: z.ZodString;
22
23
  context: z.ZodArray<z.ZodObject<{
23
24
  workItemId: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../work/index.js").WorkItemId, string>>;
@@ -39,6 +40,36 @@ export declare const delegatedAssignmentSchema: z.ZodObject<{
39
40
  requireChecks: z.ZodOptional<z.ZodBoolean>;
40
41
  }, z.core.$strict>]>>;
41
42
  }, z.core.$strict>;
43
+ export declare const delegationSubmissionSchema: z.ZodObject<{
44
+ cohortId: z.ZodString;
45
+ assignments: z.ZodArray<z.ZodObject<{
46
+ objective: z.ZodString;
47
+ repository: z.ZodOptional<z.ZodObject<{
48
+ resourceId: z.ZodString;
49
+ sourceRef: z.ZodString;
50
+ sourceRevision: z.ZodOptional<z.ZodString>;
51
+ pullRequestBase: z.ZodString;
52
+ }, z.core.$strict>>;
53
+ context: z.ZodArray<z.ZodObject<{
54
+ workItemId: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../work/index.js").WorkItemId, string>>;
55
+ revisionId: z.ZodString;
56
+ }, z.core.$strict>>;
57
+ assignmentId: z.ZodString;
58
+ criteria: z.ZodArray<z.ZodString>;
59
+ workflowName: z.ZodPipe<z.ZodString, z.ZodTransform<import("./identifiers.js").WorkflowName, string>>;
60
+ repositoryResourceIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
61
+ outputs: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
62
+ name: z.ZodString;
63
+ path: z.ZodString;
64
+ }, z.core.$strict>, z.ZodObject<{
65
+ name: z.ZodString;
66
+ kind: z.ZodLiteral<"change">;
67
+ requireReview: z.ZodOptional<z.ZodBoolean>;
68
+ requireChecks: z.ZodOptional<z.ZodBoolean>;
69
+ }, z.core.$strict>]>>;
70
+ }, z.core.$strict>>;
71
+ }, z.core.$strict>;
72
+ export type DelegationSubmission = z.infer<typeof delegationSubmissionSchema>;
42
73
  export type DelegatedAssignment = z.infer<typeof delegatedAssignmentSchema>;
43
74
  export declare const delegationReservationSchema: z.ZodObject<{
44
75
  cohortId: z.ZodString;
@@ -48,6 +79,7 @@ export declare const delegationReservationSchema: z.ZodObject<{
48
79
  activationId: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../activities/index.js").ActivationId, string>>;
49
80
  runId: z.ZodString;
50
81
  ancestors: z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<import("../../work/index.js").WorkItemId, string>>>;
82
+ maxConcurrentRuns: z.ZodOptional<z.ZodNumber>;
51
83
  maxDepth: z.ZodNumber;
52
84
  maxDescendants: z.ZodNumber;
53
85
  children: z.ZodArray<z.ZodObject<{
@@ -55,6 +87,7 @@ export declare const delegationReservationSchema: z.ZodObject<{
55
87
  objective: z.ZodString;
56
88
  criteria: z.ZodArray<z.ZodString>;
57
89
  workflowName: z.ZodPipe<z.ZodString, z.ZodTransform<import("./identifiers.js").WorkflowName, string>>;
90
+ repositoryResourceIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
58
91
  workflowFingerprint: z.ZodString;
59
92
  context: z.ZodArray<z.ZodObject<{
60
93
  workItemId: z.ZodPipe<z.ZodString, z.ZodTransform<import("../../work/index.js").WorkItemId, string>>;
@@ -128,6 +161,7 @@ export declare const delegationJoinSchema: z.ZodObject<{
128
161
  }, z.core.$strict>>;
129
162
  }, z.core.$strict>;
130
163
  export interface DelegationLimits {
164
+ readonly maxConcurrentRuns?: number;
131
165
  readonly maxDepth: number;
132
166
  readonly maxDescendants: number;
133
167
  }
@@ -27,6 +27,7 @@ export const delegatedAssignmentSchema = z
27
27
  objective: z.string().trim().min(1),
28
28
  criteria: z.array(z.string().trim().min(1)).min(1),
29
29
  workflowName: brandedStringSchema(workflowName),
30
+ repositoryResourceIds: z.array(z.string().min(1)).optional(),
30
31
  workflowFingerprint: z.string().min(1),
31
32
  context: z.array(delegationRevisionReferenceSchema),
32
33
  repository: repositoryAssignmentRequestSchema.optional(),
@@ -45,6 +46,12 @@ export const delegatedAssignmentSchema = z
45
46
  .min(1),
46
47
  })
47
48
  .strict();
49
+ export const delegationSubmissionSchema = z
50
+ .object({
51
+ cohortId: z.string().min(1),
52
+ assignments: z.array(delegatedAssignmentSchema.omit({ workflowFingerprint: true })).min(1),
53
+ })
54
+ .strict();
48
55
  export const delegationReservationSchema = z
49
56
  .object({
50
57
  cohortId: z.string().min(1),
@@ -54,6 +61,7 @@ export const delegationReservationSchema = z
54
61
  activationId: brandedStringSchema(activationId),
55
62
  runId: z.string().min(1),
56
63
  ancestors: z.array(brandedStringSchema(workItemId)),
64
+ maxConcurrentRuns: z.number().int().positive().optional(),
57
65
  maxDepth: z.number().int().positive(),
58
66
  maxDescendants: z.number().int().positive(),
59
67
  children: z
@@ -11,6 +11,7 @@ import { assertCyclesBounded, assertReachable, remainingAgentSteps } from './wor
11
11
  export function compileWorkflow(name, input, activities, knownWorkflowNames = [name], reportDiagnostic = () => { }) {
12
12
  const compiledName = workflowName(name);
13
13
  const config = workflowDefinitionConfigSchema.parse(input);
14
+ assertDelegationWorkflows(config, knownWorkflowNames);
14
15
  const rawStageNames = Object.keys(config.stages);
15
16
  for (const candidate of rawStageNames) {
16
17
  if (isReservedRouteTarget(candidate))
@@ -30,6 +31,7 @@ export function compileWorkflow(name, input, activities, knownWorkflowNames = [n
30
31
  reportUnroutedOutcomes(name, stages, activities, reportDiagnostic);
31
32
  return Object.freeze({
32
33
  remainingAgentSteps: Object.freeze(remainingAgentSteps(stages, (activity) => activities.describe(activity).executionKind === ActivityExecutionKind.Agent)),
34
+ ...(config.delegation === undefined ? {} : { delegation: config.delegation }),
33
35
  name: compiledName,
34
36
  entry: compiledEntry,
35
37
  commands: Object.freeze(commands),
@@ -176,3 +178,8 @@ function compileAuthority(workflow, rawStageName, entry, declaredWatchIds) {
176
178
  throw new Error(`Unknown watch reference in workflow "${workflow}" stage "${rawStageName}": "${entry.id}"`);
177
179
  return { kind: ApprovalAuthorityKind.Watch, watch: watchId(entry.id) };
178
180
  }
181
+ function assertDelegationWorkflows(config, known) {
182
+ for (const child of config.delegation?.workflows ?? [])
183
+ if (!known.includes(child))
184
+ throw new Error('Unknown delegation workflow: ' + child);
185
+ }
@@ -34,3 +34,6 @@ export * from './application/work-completion-summary.js';
34
34
  export type { WorkflowCompileDiagnostic } from './domain/compile-diagnostics.js';
35
35
  export type { DelegationArtifacts, DelegationRepositories } from './contracts/delegation-ports.js';
36
36
  export { DelegationPendingError } from './contracts/delegation.js';
37
+ export type { DelegationAuthority } from './contracts/delegation-ports.js';
38
+ export { delegationSubmissionSchema } from './contracts/delegation.js';
39
+ export type { DelegationCaller, DelegationReservation, DelegationSubmission, } from './contracts/delegation.js';
@@ -32,3 +32,4 @@ export * from './domain/workflow-instance.js';
32
32
  export * from './domain/workflow-selector.js';
33
33
  export * from './application/work-completion-summary.js';
34
34
  export { DelegationPendingError } from './contracts/delegation.js';
35
+ export { delegationSubmissionSchema } from './contracts/delegation.js';
@@ -19,6 +19,20 @@ export interface WorkItemResponse {
19
19
  readonly lastRunOutcome?: string;
20
20
  }
21
21
  export interface WorkDetailResponse {
22
+ readonly delegation?: {
23
+ readonly rootWorkItemKey: WorkItemKey;
24
+ readonly parentWorkItemKey?: WorkItemKey;
25
+ readonly children: readonly {
26
+ readonly workItemKey: WorkItemKey;
27
+ readonly parentWorkItemKey: WorkItemKey;
28
+ readonly objective: string;
29
+ readonly workflowName: string;
30
+ readonly status: string;
31
+ readonly cohortId: string;
32
+ readonly blockReason?: string;
33
+ readonly resources: readonly ResourceItemResponse[];
34
+ }[];
35
+ };
22
36
  readonly triggerOrigin?: string;
23
37
  readonly work: WorkItemResponse;
24
38
  readonly resources: readonly ResourceItemResponse[];
@@ -50,3 +50,4 @@ export * from './contracts/config.js';
50
50
  export * from './web-host/asset-source.js';
51
51
  export * from './web-host/packaged-assets.js';
52
52
  export * from './api/presenters/merge-policy-block.js';
53
+ export { registerDelegationTools } from './mcp/delegation.js';
@@ -50,3 +50,4 @@ export * from './contracts/config.js';
50
50
  export * from './web-host/asset-source.js';
51
51
  export * from './web-host/packaged-assets.js';
52
52
  export * from './api/presenters/merge-policy-block.js';
53
+ export { registerDelegationTools } from './mcp/delegation.js';
@@ -0,0 +1,9 @@
1
+ import type { CommandContext } from '@atolis-hq/eventing';
2
+ import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
3
+ import { type DelegationCaller, type OrchestrationService } from '../../orchestration/index.js';
4
+ /** The bound caller is never accepted as a tool argument. */
5
+ export declare function registerDelegationTools(server: McpServer, input: {
6
+ readonly orchestration: OrchestrationService;
7
+ readonly caller: () => Promise<DelegationCaller>;
8
+ readonly commandContext: () => CommandContext;
9
+ }): void;
@@ -0,0 +1,25 @@
1
+ import { delegationSubmissionSchema, } from '../../orchestration/index.js';
2
+ /** The bound caller is never accepted as a tool argument. */
3
+ export function registerDelegationTools(server, input) {
4
+ server.registerTool('wake_delegation_submit', {
5
+ description: 'Submit independent child work under this workflow delegation policy. End the current activity normally after submission; Wake waits and resumes it with joined results.',
6
+ inputSchema: delegationSubmissionSchema,
7
+ }, async (command) => ({
8
+ content: [
9
+ {
10
+ type: 'text',
11
+ text: JSON.stringify(await input.orchestration.submitDelegation(await input.caller(), command, input.commandContext())),
12
+ },
13
+ ],
14
+ }));
15
+ server.registerTool('wake_delegation_inspect', {
16
+ description: 'Inspect this delivery tree, child workflows, results and blockers, and the Repository Resource IDs an explicit repository selection may name.',
17
+ }, async () => ({
18
+ content: [
19
+ {
20
+ type: 'text',
21
+ text: JSON.stringify(await input.orchestration.inspectDelegation(await input.caller(), input.commandContext())),
22
+ },
23
+ ],
24
+ }));
25
+ }