@atolis-hq/wake 0.4.104 → 0.4.106

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 (161) hide show
  1. package/dist/src/activities/agent/agent-activity.js +10 -0
  2. package/dist/src/activities/contracts/activity.d.ts +28 -0
  3. package/dist/src/activities/contracts/event-schema.d.ts +314 -8
  4. package/dist/src/activities/contracts/event-schema.js +20 -2
  5. package/dist/src/activities/contracts/events.d.ts +10 -0
  6. package/dist/src/activities/contracts/vocabulary.d.ts +2 -0
  7. package/dist/src/activities/contracts/vocabulary.js +2 -0
  8. package/dist/src/activities/index.d.ts +2 -0
  9. package/dist/src/activities/index.js +2 -0
  10. package/dist/src/activities/pr/activity-support.d.ts +1 -1
  11. package/dist/src/activities/pr/activity-support.js +10 -0
  12. package/dist/src/activities/pr/application.js +8 -1
  13. package/dist/src/activities/pr/approve.d.ts +2 -1
  14. package/dist/src/activities/pr/approve.js +33 -11
  15. package/dist/src/activities/pr/check-evidence.d.ts +10 -0
  16. package/dist/src/activities/pr/check-evidence.js +16 -0
  17. package/dist/src/activities/pr/contracts.d.ts +14 -0
  18. package/dist/src/activities/pr/event-data.js +5 -1
  19. package/dist/src/activities/pr/merge.d.ts +2 -1
  20. package/dist/src/activities/pr/merge.js +54 -38
  21. package/dist/src/activities/pr/parent-scope.d.ts +65 -0
  22. package/dist/src/activities/pr/parent-scope.js +24 -0
  23. package/dist/src/activities/pr/parent-target.d.ts +45 -0
  24. package/dist/src/activities/pr/parent-target.js +59 -0
  25. package/dist/src/activities/pr/projection.js +10 -2
  26. package/dist/src/activities/pr/vocabulary.d.ts +8 -0
  27. package/dist/src/activities/pr/vocabulary.js +8 -0
  28. package/dist/src/bootstrap/activity-registry.d.ts +2 -2
  29. package/dist/src/bootstrap/activity-registry.js +3 -3
  30. package/dist/src/bootstrap/composition-root.js +11 -2
  31. package/dist/src/bootstrap/config/root-schema.d.ts +22 -0
  32. package/dist/src/bootstrap/delegation-authority.js +17 -0
  33. package/dist/src/bootstrap/delivery-integration.d.ts +9 -0
  34. package/dist/src/bootstrap/delivery-integration.js +46 -0
  35. package/dist/src/bootstrap/surface-api-delivery.js +52 -0
  36. package/dist/src/bootstrap/version.js +1 -1
  37. package/dist/src/control-plane/application/activation-scheduler-ports.d.ts +5 -1
  38. package/dist/src/control-plane/application/advance-once-dispatch.js +12 -6
  39. package/dist/src/execution/application/candidate-workspaces.d.ts +13 -0
  40. package/dist/src/execution/application/candidate-workspaces.js +75 -0
  41. package/dist/src/execution/application/execution-service.js +37 -11
  42. package/dist/src/execution/application/maintenance-workspaces.d.ts +17 -0
  43. package/dist/src/execution/application/maintenance-workspaces.js +84 -0
  44. package/dist/src/execution/application/run-lifecycle.js +2 -0
  45. package/dist/src/execution/contracts/candidate.d.ts +31 -0
  46. package/dist/src/execution/contracts/candidate.js +40 -0
  47. package/dist/src/execution/contracts/commands.d.ts +4 -0
  48. package/dist/src/execution/contracts/events.d.ts +24 -0
  49. package/dist/src/execution/contracts/events.js +4 -0
  50. package/dist/src/execution/contracts/maintenance.d.ts +36 -0
  51. package/dist/src/execution/contracts/maintenance.js +44 -0
  52. package/dist/src/execution/contracts/repository-assignment.d.ts +5 -0
  53. package/dist/src/execution/contracts/repository-assignment.js +8 -0
  54. package/dist/src/execution/contracts/views.d.ts +4 -0
  55. package/dist/src/execution/contracts/vocabulary.d.ts +5 -0
  56. package/dist/src/execution/contracts/vocabulary.js +4 -0
  57. package/dist/src/execution/contracts/workspace.d.ts +8 -0
  58. package/dist/src/execution/index.d.ts +2 -0
  59. package/dist/src/execution/index.js +2 -0
  60. package/dist/src/execution/infrastructure/workspace/git-source.d.ts +2 -2
  61. package/dist/src/execution/infrastructure/workspace/git-source.js +18 -1
  62. package/dist/src/execution/infrastructure/workspace/git-workspace.d.ts +2 -4
  63. package/dist/src/execution/infrastructure/workspace/git-workspace.js +12 -1
  64. package/dist/src/integrations/application/delegation-outputs.js +1 -1
  65. package/dist/src/integrations/application/delivery-integration-verification.d.ts +13 -0
  66. package/dist/src/integrations/application/delivery-integration-verification.js +68 -0
  67. package/dist/src/integrations/delivery/application/delivery-projector.js +3 -0
  68. package/dist/src/integrations/delivery/application/merged-delivery-evidence.js +9 -1
  69. package/dist/src/integrations/delivery/contracts/views.d.ts +2 -0
  70. package/dist/src/integrations/fake/external-source.d.ts +5 -2
  71. package/dist/src/integrations/fake/external-source.js +12 -2
  72. package/dist/src/integrations/fake/inbound-translator.js +7 -2
  73. package/dist/src/integrations/fake/provider.d.ts +17 -0
  74. package/dist/src/integrations/fake/provider.js +18 -2
  75. package/dist/src/integrations/github/application/pull-request-translation.js +2 -0
  76. package/dist/src/integrations/github/contracts/events.d.ts +3 -1
  77. package/dist/src/integrations/github/contracts/events.js +3 -1
  78. package/dist/src/integrations/github/contracts/payloads.d.ts +23 -0
  79. package/dist/src/integrations/github/infrastructure/check-execution.d.ts +9 -0
  80. package/dist/src/integrations/github/infrastructure/check-execution.js +68 -0
  81. package/dist/src/integrations/github/infrastructure/checkout-revision.d.ts +2 -0
  82. package/dist/src/integrations/github/infrastructure/checkout-revision.js +23 -0
  83. package/dist/src/integrations/github/infrastructure/client.d.ts +2 -0
  84. package/dist/src/integrations/github/infrastructure/client.js +4 -0
  85. package/dist/src/integrations/github/infrastructure/pr-check-subject.d.ts +7 -0
  86. package/dist/src/integrations/github/infrastructure/pr-check-subject.js +77 -0
  87. package/dist/src/integrations/github/infrastructure/pr-evidence.d.ts +6 -3
  88. package/dist/src/integrations/github/infrastructure/pr-evidence.js +1 -1
  89. package/dist/src/integrations/github/infrastructure/pr-source.d.ts +3 -5
  90. package/dist/src/integrations/github/infrastructure/pr-source.js +11 -1
  91. package/dist/src/integrations/github/infrastructure/workflow-run-evidence.d.ts +5 -0
  92. package/dist/src/integrations/github/infrastructure/workflow-run-evidence.js +22 -0
  93. package/dist/src/integrations/index.d.ts +1 -0
  94. package/dist/src/integrations/index.js +1 -0
  95. package/dist/src/orchestration/application/delegated-work.d.ts +5 -0
  96. package/dist/src/orchestration/application/delegated-work.js +10 -0
  97. package/dist/src/orchestration/application/delegation-commands.d.ts +16 -0
  98. package/dist/src/orchestration/application/delivery-coordinator.d.ts +348 -0
  99. package/dist/src/orchestration/application/delivery-coordinator.js +239 -0
  100. package/dist/src/orchestration/application/delivery-facts-reader.d.ts +9 -0
  101. package/dist/src/orchestration/application/delivery-facts-reader.js +47 -0
  102. package/dist/src/orchestration/application/delivery-integration-reader.d.ts +9 -0
  103. package/dist/src/orchestration/application/delivery-integration-reader.js +23 -0
  104. package/dist/src/orchestration/application/delivery-integration-service.d.ts +50 -0
  105. package/dist/src/orchestration/application/delivery-integration-service.js +228 -0
  106. package/dist/src/orchestration/application/delivery-preparation.d.ts +16 -0
  107. package/dist/src/orchestration/application/delivery-preparation.js +105 -0
  108. package/dist/src/orchestration/application/delivery-sources.d.ts +10 -0
  109. package/dist/src/orchestration/application/delivery-sources.js +41 -0
  110. package/dist/src/orchestration/application/orchestration-repository.d.ts +3 -1
  111. package/dist/src/orchestration/application/orchestration-repository.js +10 -1
  112. package/dist/src/orchestration/application/orchestration-service.d.ts +341 -2
  113. package/dist/src/orchestration/application/orchestration-service.js +86 -4
  114. package/dist/src/orchestration/contracts/config.d.ts +22 -0
  115. package/dist/src/orchestration/contracts/config.js +13 -1
  116. package/dist/src/orchestration/contracts/delegation-ports.d.ts +4 -0
  117. package/dist/src/orchestration/contracts/delegation.d.ts +13 -1
  118. package/dist/src/orchestration/contracts/delegation.js +5 -0
  119. package/dist/src/orchestration/contracts/delivery-ports.d.ts +53 -0
  120. package/dist/src/orchestration/contracts/delivery-ports.js +1 -0
  121. package/dist/src/orchestration/contracts/delivery.d.ts +310 -0
  122. package/dist/src/orchestration/contracts/delivery.js +186 -0
  123. package/dist/src/orchestration/contracts/event-decoder.js +14 -1
  124. package/dist/src/orchestration/contracts/event-factory.js +8 -0
  125. package/dist/src/orchestration/contracts/events.d.ts +10 -0
  126. package/dist/src/orchestration/contracts/events.js +4 -0
  127. package/dist/src/orchestration/contracts/views.d.ts +3 -0
  128. package/dist/src/orchestration/contracts/vocabulary.d.ts +90 -0
  129. package/dist/src/orchestration/contracts/vocabulary.js +82 -0
  130. package/dist/src/orchestration/domain/compile-diagnostics.d.ts +1 -1
  131. package/dist/src/orchestration/domain/compile-diagnostics.js +5 -0
  132. package/dist/src/orchestration/domain/compiler.js +2 -0
  133. package/dist/src/orchestration/domain/delivery-candidate.d.ts +9 -0
  134. package/dist/src/orchestration/domain/delivery-candidate.js +105 -0
  135. package/dist/src/orchestration/domain/delivery-facts.d.ts +89 -0
  136. package/dist/src/orchestration/domain/delivery-facts.js +66 -0
  137. package/dist/src/orchestration/domain/delivery-integration-policy.d.ts +7 -0
  138. package/dist/src/orchestration/domain/delivery-integration-policy.js +15 -0
  139. package/dist/src/orchestration/domain/delivery-integration.d.ts +54 -0
  140. package/dist/src/orchestration/domain/delivery-integration.js +144 -0
  141. package/dist/src/orchestration/domain/delivery-qa.d.ts +33 -0
  142. package/dist/src/orchestration/domain/delivery-qa.js +97 -0
  143. package/dist/src/orchestration/domain/delivery-replacement.d.ts +9 -0
  144. package/dist/src/orchestration/domain/delivery-replacement.js +54 -0
  145. package/dist/src/orchestration/domain/delivery-selection.d.ts +17 -0
  146. package/dist/src/orchestration/domain/delivery-selection.js +132 -0
  147. package/dist/src/orchestration/domain/delivery-workflow-policy.d.ts +6 -0
  148. package/dist/src/orchestration/domain/delivery-workflow-policy.js +32 -0
  149. package/dist/src/orchestration/domain/operator-retry-policy.js +24 -13
  150. package/dist/src/orchestration/domain/workflow-instance-events.d.ts +1 -0
  151. package/dist/src/orchestration/domain/workflow-instance-events.js +12 -0
  152. package/dist/src/orchestration/index.d.ts +3 -0
  153. package/dist/src/orchestration/index.js +1 -0
  154. package/dist/src/surfaces/api/contracts/transport-values.js +1 -0
  155. package/dist/src/surfaces/api/contracts/work.d.ts +42 -0
  156. package/dist/src/surfaces/api/presenters/execution.js +1 -0
  157. package/dist/src/surfaces/mcp/delegation.js +36 -1
  158. package/dist/src/surfaces/web-assets/assets/index-ih1h3dxC.js +1192 -0
  159. package/dist/src/surfaces/web-assets/index.html +1 -1
  160. package/package.json +1 -1
  161. package/dist/src/surfaces/web-assets/assets/index-C5R-aWzH.js +0 -1192
@@ -1,4 +1,5 @@
1
- /* eslint-disable max-lines */
1
+ import { acquireCandidateWorkspaces } from './candidate-workspaces.js';
2
+ import { acquireMaintenanceWorkspaces } from './maintenance-workspaces.js';
2
3
  import { ActivityExecutionKind, } from '../../activities/index.js';
3
4
  import { runId } from '../contracts/identifiers.js';
4
5
  import { ExecutionStreamKind } from '../contracts/streams.js';
@@ -313,16 +314,7 @@ async function completeRun(runtime, currentRunId, activation, context, startedAt
313
314
  ...(resumeSessionId === undefined ? {} : { resumeSessionId }),
314
315
  ...(resumeStartedAt === undefined ? {} : { resumeStartedAt }),
315
316
  ...(usageBaseline === undefined ? {} : { usageBaseline }),
316
- ...(lease === undefined
317
- ? {}
318
- : {
319
- workspace: {
320
- path: lease.path,
321
- mode: lease.mode,
322
- checkoutRevision: lease.checkoutRevision,
323
- repository: context.repositoryAssignment,
324
- },
325
- }),
317
+ ...activityWorkspace(lease, context),
326
318
  reportRunnerStarted,
327
319
  });
328
320
  await stopRenewal();
@@ -609,6 +601,22 @@ async function claimActivationForAttempt(runtime, activation, currentRunId, owne
609
601
  });
610
602
  }
611
603
  async function acquireAttemptWorkspace(runtime, activation, context, currentRunId, signal) {
604
+ if (context.maintenance !== undefined)
605
+ return acquireMaintenanceWorkspaces({
606
+ runId: currentRunId,
607
+ resources: context.resources,
608
+ maintenance: context.maintenance,
609
+ runs: await runtime.repository.list(),
610
+ signal: signal ?? new AbortController().signal,
611
+ }, runtime.dependencies.workspaces);
612
+ if (context.candidate !== undefined)
613
+ return acquireCandidateWorkspaces({
614
+ runId: currentRunId,
615
+ workItemId: context.workItemId,
616
+ candidate: context.candidate,
617
+ resources: context.resources,
618
+ signal: signal ?? new AbortController().signal,
619
+ }, runtime.dependencies.workspaces);
612
620
  const previous = context.repositoryAssignment === undefined
613
621
  ? undefined
614
622
  : (await runtime.repository.list())
@@ -641,3 +649,21 @@ function existingRun(runs, clock, owner) {
641
649
  function validateResources(requirements, resources) {
642
650
  validateResourceRequirements(requirements, resources);
643
651
  }
652
+ function activityWorkspace(lease, context) {
653
+ return {
654
+ ...(lease === undefined
655
+ ? {}
656
+ : {
657
+ workspace: {
658
+ path: lease.path,
659
+ mode: lease.mode,
660
+ checkoutRevision: lease.checkoutRevision,
661
+ repository: context.repositoryAssignment,
662
+ candidate: lease.candidate === undefined
663
+ ? undefined
664
+ : { ...context.candidate, ...lease.candidate },
665
+ maintenance: lease.maintenance,
666
+ },
667
+ }),
668
+ };
669
+ }
@@ -0,0 +1,17 @@
1
+ import { type ResourceView } from '../../resources/index.js';
2
+ import type { RunId } from '../contracts/identifiers.js';
3
+ import { type ExecutionMaintenance } from '../contracts/maintenance.js';
4
+ import type { RunView } from '../contracts/views.js';
5
+ import type { WorkspaceLease, WorkspaceProvider } from '../contracts/workspace.js';
6
+ /**
7
+ * Leases the recorded branch workspace of every maintenance target as a unit, in a fixed order so
8
+ * concurrent parents cannot deadlock. An unresolved earlier writer of any target stops the whole
9
+ * preparation: it must be reconciled before another writer is allowed to act.
10
+ */
11
+ export declare function acquireMaintenanceWorkspaces(request: {
12
+ readonly runId: RunId;
13
+ readonly resources: readonly ResourceView[];
14
+ readonly maintenance: ExecutionMaintenance;
15
+ readonly runs: readonly RunView[];
16
+ readonly signal: AbortSignal;
17
+ }, provider: WorkspaceProvider | undefined): Promise<WorkspaceLease>;
@@ -0,0 +1,84 @@
1
+ import { BuiltInResourceKind } from '../../resources/index.js';
2
+ import { executionMaintenanceSchema } from '../contracts/maintenance.js';
3
+ import { RunStatus, WorkspaceMode } from '../contracts/vocabulary.js';
4
+ /**
5
+ * Leases the recorded branch workspace of every maintenance target as a unit, in a fixed order so
6
+ * concurrent parents cannot deadlock. An unresolved earlier writer of any target stops the whole
7
+ * preparation: it must be reconciled before another writer is allowed to act.
8
+ */
9
+ export async function acquireMaintenanceWorkspaces(request, provider) {
10
+ if (provider === undefined)
11
+ throw new Error('Maintenance needs a workspace provider');
12
+ const maintenance = executionMaintenanceSchema.parse(request.maintenance);
13
+ const targets = [...maintenance.targets].sort((a, b) => a.childWorkItemId < b.childWorkItemId ? -1 : a.childWorkItemId === b.childWorkItemId ? 0 : 1);
14
+ if (new Set(targets.map((entry) => entry.childWorkItemId)).size !== targets.length)
15
+ throw new Error('Duplicate maintenance target');
16
+ for (const target of targets) {
17
+ const unresolved = request.runs.find((run) => run.runId !== request.runId &&
18
+ run.status === RunStatus.Ambiguous &&
19
+ ((run.workspace?.branch === target.childWorkItemId &&
20
+ run.workspace?.mode === WorkspaceMode.Branch) ||
21
+ run.workspace?.maintenance?.targets.some((entry) => entry.childWorkItemId === target.childWorkItemId) === true));
22
+ if (unresolved !== undefined)
23
+ throw new Error(`Maintenance target ${target.childWorkItemId} has an unresolved earlier writer: Run ${unresolved.runId}`);
24
+ }
25
+ const leases = [];
26
+ try {
27
+ for (const target of targets) {
28
+ request.signal.throwIfAborted();
29
+ const resource = request.resources.find((entry) => entry.resourceId === target.repository.resourceId &&
30
+ entry.kind === BuiltInResourceKind.Repository);
31
+ if (resource === undefined)
32
+ throw new Error('Maintenance repository is unavailable');
33
+ const lease = await provider.acquire({
34
+ runId: request.runId,
35
+ workItemId: target.childWorkItemId,
36
+ signal: request.signal,
37
+ mode: WorkspaceMode.Branch,
38
+ repositoryResource: resource,
39
+ assignment: target.repository,
40
+ checkoutRevision: target.revision,
41
+ });
42
+ leases.push(lease);
43
+ }
44
+ return {
45
+ ...leases[0],
46
+ maintenance: {
47
+ targets: targets.map((target, index) => ({
48
+ childWorkItemId: target.childWorkItemId,
49
+ outputName: target.outputName,
50
+ resourceId: target.resourceId,
51
+ branch: target.branch,
52
+ revision: target.revision,
53
+ path: leases[index].path,
54
+ ...(target.reason === undefined ? {} : { reason: target.reason }),
55
+ })),
56
+ },
57
+ release: () => releaseAll(leases),
58
+ };
59
+ }
60
+ catch (error) {
61
+ try {
62
+ await releaseAll(leases);
63
+ }
64
+ catch (cleanup) {
65
+ throw new AggregateError([error, cleanup], 'Maintenance preparation and cleanup failed', {
66
+ cause: cleanup,
67
+ });
68
+ }
69
+ throw error;
70
+ }
71
+ }
72
+ async function releaseAll(leases) {
73
+ const failures = [];
74
+ for (const lease of [...leases].reverse()) {
75
+ try {
76
+ await lease.release();
77
+ }
78
+ catch (error) {
79
+ failures.push(error);
80
+ }
81
+ }
82
+ if (failures.length > 0)
83
+ throw new AggregateError(failures, 'Maintenance lease cleanup failed');
84
+ }
@@ -196,6 +196,8 @@ function workspacePayload(lease) {
196
196
  ? {}
197
197
  : { checkoutRevision: lease.checkoutRevision }),
198
198
  path: lease.path,
199
+ ...(lease.candidate === undefined ? {} : { candidate: lease.candidate }),
200
+ ...(lease.maintenance === undefined ? {} : { maintenance: lease.maintenance }),
199
201
  ...(lease.branch === undefined ? {} : { branch: lease.branch }),
200
202
  },
201
203
  }),
@@ -0,0 +1,31 @@
1
+ import { z } from 'zod';
2
+ /** Authorized, exact inputs selected by Orchestration for a QA activation. */
3
+ export declare const executionCandidateSchema: z.ZodObject<{
4
+ candidateId: z.ZodString;
5
+ selectionRevision: z.ZodNumber;
6
+ criteria: z.ZodArray<z.ZodString>;
7
+ inputs: z.ZodArray<z.ZodObject<{
8
+ workItemId: z.ZodString;
9
+ outputName: z.ZodString;
10
+ revision: z.ZodString;
11
+ }, z.core.$strict>>;
12
+ recipe: z.ZodOptional<z.ZodString>;
13
+ repositories: z.ZodArray<z.ZodObject<{
14
+ resourceId: z.ZodString;
15
+ sourceRef: z.ZodString;
16
+ sourceRevision: z.ZodString;
17
+ pullRequestBase: z.ZodString;
18
+ requiredSourceRef: z.ZodOptional<z.ZodString>;
19
+ }, z.core.$strict>>;
20
+ }, z.core.$strict>;
21
+ export type ExecutionCandidate = z.infer<typeof executionCandidateSchema>;
22
+ export declare const preparedCandidateSchema: z.ZodObject<{
23
+ candidateId: z.ZodString;
24
+ selectionRevision: z.ZodNumber;
25
+ repositories: z.ZodArray<z.ZodObject<{
26
+ resourceId: z.ZodString;
27
+ revision: z.ZodString;
28
+ path: z.ZodString;
29
+ }, z.core.$strict>>;
30
+ }, z.core.$strict>;
31
+ export type PreparedCandidate = z.infer<typeof preparedCandidateSchema>;
@@ -0,0 +1,40 @@
1
+ import { z } from 'zod';
2
+ import { repositoryAssignmentSchema } from './repository-assignment.js';
3
+ /** Authorized, exact inputs selected by Orchestration for a QA activation. */
4
+ export const executionCandidateSchema = z
5
+ .object({
6
+ candidateId: z.string().min(1),
7
+ selectionRevision: z.number().int().positive(),
8
+ criteria: z.array(z.string()),
9
+ inputs: z.array(z
10
+ .object({
11
+ workItemId: z.string().min(1),
12
+ outputName: z.string().min(1),
13
+ revision: z.string().min(1),
14
+ })
15
+ .strict()),
16
+ recipe: z.string().optional(),
17
+ repositories: z
18
+ .array(repositoryAssignmentSchema
19
+ .extend({
20
+ requiredSourceRef: z.string().optional(),
21
+ })
22
+ .strict())
23
+ .min(1),
24
+ })
25
+ .strict();
26
+ export const preparedCandidateSchema = z
27
+ .object({
28
+ candidateId: z.string().min(1),
29
+ selectionRevision: z.number().int().positive(),
30
+ repositories: z
31
+ .array(z
32
+ .object({
33
+ resourceId: z.string().min(1),
34
+ revision: z.string().min(1),
35
+ path: z.string().min(1),
36
+ })
37
+ .strict())
38
+ .min(1),
39
+ })
40
+ .strict();
@@ -1,6 +1,8 @@
1
1
  import type { ActivationId, ActivityName, ActivityOrchestrationGroupId, ActivityWorkflowInstanceId } from '../../activities/index.js';
2
2
  import type { ResourceView } from '../../resources/index.js';
3
3
  import type { WorkItemId } from '../../work/index.js';
4
+ import type { ExecutionCandidate } from './candidate.js';
5
+ import type { ExecutionMaintenance } from './maintenance.js';
4
6
  import type { RepositoryAssignment } from './repository-assignment.js';
5
7
  import type { WorkspaceMode } from './vocabulary.js';
6
8
  export interface ExecutionActivation {
@@ -17,6 +19,8 @@ export interface ExecutionActivation {
17
19
  readonly sessionPolicy?: 'fresh' | undefined;
18
20
  }
19
21
  export interface ExecutionAttemptContext {
22
+ readonly candidate?: ExecutionCandidate;
23
+ readonly maintenance?: ExecutionMaintenance;
20
24
  readonly workItemId: WorkItemId;
21
25
  readonly workflowInstanceId: ActivityWorkflowInstanceId;
22
26
  readonly orchestrationGroupId: ActivityOrchestrationGroupId;
@@ -1,8 +1,10 @@
1
1
  import { type EventDataUnion, type EventEnvelope, type EventUnion } from '@atolis-hq/eventing';
2
2
  import { z } from 'zod';
3
3
  import { type ActivationId, type ActivityName, type ActivityOrchestrationGroupId, type ActivityOutcome, type ActivityWorkflowInstanceId } from '../../activities/index.js';
4
+ import { type PreparedCandidate } from './candidate.js';
4
5
  import { runId } from './identifiers.js';
5
6
  import type { Cancellation, ExternalExecutionReference, Lease } from './liveness.js';
7
+ import { type PreparedMaintenance } from './maintenance.js';
6
8
  import { type RepositoryAssignment } from './repository-assignment.js';
7
9
  import type { ExecutionFailure, RecordedRunnerResult, RecoveredRunResult } from './results.js';
8
10
  import { type ActivationStreamRef, type RunStreamRef } from './streams.js';
@@ -37,6 +39,26 @@ export declare const runStartedPayloadSchema: z.ZodObject<{
37
39
  branch: z.ZodOptional<z.ZodString>;
38
40
  repositoryResourceId: z.ZodOptional<z.ZodString>;
39
41
  checkoutRevision: z.ZodOptional<z.ZodString>;
42
+ candidate: z.ZodOptional<z.ZodObject<{
43
+ candidateId: z.ZodString;
44
+ selectionRevision: z.ZodNumber;
45
+ repositories: z.ZodArray<z.ZodObject<{
46
+ resourceId: z.ZodString;
47
+ revision: z.ZodString;
48
+ path: z.ZodString;
49
+ }, z.core.$strict>>;
50
+ }, z.core.$strict>>;
51
+ maintenance: z.ZodOptional<z.ZodObject<{
52
+ targets: z.ZodArray<z.ZodObject<{
53
+ childWorkItemId: z.ZodString;
54
+ outputName: z.ZodString;
55
+ resourceId: z.ZodString;
56
+ branch: z.ZodString;
57
+ revision: z.ZodString;
58
+ path: z.ZodString;
59
+ reason: z.ZodOptional<z.ZodString>;
60
+ }, z.core.$strict>>;
61
+ }, z.core.$strict>>;
40
62
  }, z.core.$strict>>;
41
63
  }, z.core.$strict>;
42
64
  export declare const runPreparationStartedPayloadSchema: z.ZodObject<{
@@ -137,6 +159,8 @@ export interface RunStartedPayload {
137
159
  readonly branch?: string | undefined;
138
160
  readonly repositoryResourceId?: string | undefined;
139
161
  readonly checkoutRevision?: string | undefined;
162
+ readonly candidate?: PreparedCandidate | undefined;
163
+ readonly maintenance?: PreparedMaintenance | undefined;
140
164
  } | undefined;
141
165
  }
142
166
  export interface RunPreparationStartedPayload {
@@ -2,7 +2,9 @@ import { eventDataSchema, eventEnvelopeSchema, } from '@atolis-hq/eventing';
2
2
  import { z } from 'zod';
3
3
  import { activationId, activityName, activityOrchestrationGroupId, activityWorkflowInstanceId, ExternalExecutionKind, } from '../../activities/index.js';
4
4
  import { brandedStringSchema, offsetIsoTimestampSchema } from '../../kernel/index.js';
5
+ import { preparedCandidateSchema } from './candidate.js';
5
6
  import { runId } from './identifiers.js';
7
+ import { preparedMaintenanceSchema } from './maintenance.js';
6
8
  import { repositoryAssignmentSchema } from './repository-assignment.js';
7
9
  import { ExecutionStreamKind } from './streams.js';
8
10
  import { ExecutionCancellationReason, ExecutionFailureCode, RunStatus, WorkspaceMode, } from './vocabulary.js';
@@ -33,6 +35,8 @@ export const runStartedPayloadSchema = z
33
35
  branch: z.string().min(1).optional(),
34
36
  repositoryResourceId: z.string().min(1).optional(),
35
37
  checkoutRevision: z.string().min(1).optional(),
38
+ candidate: preparedCandidateSchema.optional(),
39
+ maintenance: preparedMaintenanceSchema.optional(),
36
40
  })
37
41
  .strict()
38
42
  .optional(),
@@ -0,0 +1,36 @@
1
+ import { z } from 'zod';
2
+ /**
3
+ * Selected pull requests an agent may maintain, chosen by Orchestration for one activation.
4
+ * Each target is leased through the child's own recorded branch workspace; the PR keeps its
5
+ * original owner and the maintaining Run is recorded as the actual producer.
6
+ */
7
+ export declare const executionMaintenanceSchema: z.ZodObject<{
8
+ targets: z.ZodArray<z.ZodObject<{
9
+ childWorkItemId: z.ZodString;
10
+ outputName: z.ZodString;
11
+ resourceId: z.ZodString;
12
+ repository: z.ZodObject<{
13
+ resourceId: z.ZodString;
14
+ sourceRef: z.ZodString;
15
+ sourceRevision: z.ZodString;
16
+ pullRequestBase: z.ZodString;
17
+ }, z.core.$strict>;
18
+ branch: z.ZodString;
19
+ revision: z.ZodString;
20
+ pullRequestBase: z.ZodString;
21
+ reason: z.ZodOptional<z.ZodString>;
22
+ }, z.core.$strict>>;
23
+ }, z.core.$strict>;
24
+ export type ExecutionMaintenance = z.infer<typeof executionMaintenanceSchema>;
25
+ export declare const preparedMaintenanceSchema: z.ZodObject<{
26
+ targets: z.ZodArray<z.ZodObject<{
27
+ childWorkItemId: z.ZodString;
28
+ outputName: z.ZodString;
29
+ resourceId: z.ZodString;
30
+ branch: z.ZodString;
31
+ revision: z.ZodString;
32
+ path: z.ZodString;
33
+ reason: z.ZodOptional<z.ZodString>;
34
+ }, z.core.$strict>>;
35
+ }, z.core.$strict>;
36
+ export type PreparedMaintenance = z.infer<typeof preparedMaintenanceSchema>;
@@ -0,0 +1,44 @@
1
+ import { z } from 'zod';
2
+ import { repositoryAssignmentSchema } from './repository-assignment.js';
3
+ /**
4
+ * Selected pull requests an agent may maintain, chosen by Orchestration for one activation.
5
+ * Each target is leased through the child's own recorded branch workspace; the PR keeps its
6
+ * original owner and the maintaining Run is recorded as the actual producer.
7
+ */
8
+ export const executionMaintenanceSchema = z
9
+ .object({
10
+ targets: z
11
+ .array(z
12
+ .object({
13
+ childWorkItemId: z.string().min(1),
14
+ outputName: z.string().min(1),
15
+ resourceId: z.string().min(1),
16
+ /** The repository assignment the child's workspace was created from. */
17
+ repository: repositoryAssignmentSchema,
18
+ branch: z.string().min(1),
19
+ revision: z.string().min(1),
20
+ pullRequestBase: z.string().min(1),
21
+ /** Why integration cannot proceed yet, when it cannot. */
22
+ reason: z.string().min(1).optional(),
23
+ })
24
+ .strict())
25
+ .min(1),
26
+ })
27
+ .strict();
28
+ export const preparedMaintenanceSchema = z
29
+ .object({
30
+ targets: z
31
+ .array(z
32
+ .object({
33
+ childWorkItemId: z.string().min(1),
34
+ outputName: z.string().min(1),
35
+ resourceId: z.string().min(1),
36
+ branch: z.string().min(1),
37
+ revision: z.string().min(1),
38
+ path: z.string().min(1),
39
+ reason: z.string().min(1).optional(),
40
+ })
41
+ .strict())
42
+ .min(1),
43
+ })
44
+ .strict();
@@ -1,4 +1,5 @@
1
1
  import { z } from 'zod';
2
+ import type { RepositorySourceFailure } from './vocabulary.js';
2
3
  export declare const repositoryAssignmentSchema: z.ZodObject<{
3
4
  resourceId: z.ZodString;
4
5
  sourceRef: z.ZodString;
@@ -15,3 +16,7 @@ export interface RepositoryAssignment {
15
16
  export type RepositoryAssignmentRequest = Omit<RepositoryAssignment, 'sourceRevision'> & {
16
17
  readonly sourceRevision?: string | undefined;
17
18
  };
19
+ export declare class RepositorySourceError extends Error {
20
+ readonly kind: RepositorySourceFailure;
21
+ constructor(kind: RepositorySourceFailure, message: string, options?: ErrorOptions);
22
+ }
@@ -7,3 +7,11 @@ export const repositoryAssignmentSchema = z
7
7
  pullRequestBase: z.string().min(1),
8
8
  })
9
9
  .strict();
10
+ export class RepositorySourceError extends Error {
11
+ kind;
12
+ constructor(kind, message, options) {
13
+ super(message, options);
14
+ this.kind = kind;
15
+ this.name = 'RepositorySourceError';
16
+ }
17
+ }
@@ -1,6 +1,8 @@
1
1
  import type { ActivationId, ActivityName, ActivityOrchestrationGroupId, ActivityOutcome, ActivityWorkflowInstanceId } from '../../activities/index.js';
2
+ import type { PreparedCandidate } from './candidate.js';
2
3
  import type { RunId } from './identifiers.js';
3
4
  import type { Cancellation, ExternalExecutionReference, Lease } from './liveness.js';
5
+ import type { PreparedMaintenance } from './maintenance.js';
4
6
  import type { RepositoryAssignment } from './repository-assignment.js';
5
7
  import type { ExecutionFailure } from './results.js';
6
8
  import type { AgentRunResponse } from './runner.js';
@@ -43,6 +45,8 @@ export interface RunView {
43
45
  readonly branch?: string | undefined;
44
46
  readonly repositoryResourceId?: string | undefined;
45
47
  readonly checkoutRevision?: string | undefined;
48
+ readonly candidate?: PreparedCandidate | undefined;
49
+ readonly maintenance?: PreparedMaintenance | undefined;
46
50
  };
47
51
  readonly lease?: Lease;
48
52
  readonly externalExecution?: ExternalExecutionReference;
@@ -60,3 +60,8 @@ export type RunnerKind = ValueOf<typeof RunnerKind>;
60
60
  export declare const RecoveryBlockReasonPrefix = "execution-recovery-ambiguous:";
61
61
  export declare function isRecoveryBlockReason(reason: string | undefined): boolean;
62
62
  export declare function isAmbiguityResolutionBlockReason(reason: string | undefined): boolean;
63
+ export declare const RepositorySourceFailure: {
64
+ readonly FetchFailed: "fetch-failed";
65
+ readonly RefUnavailable: "ref-unavailable";
66
+ };
67
+ export type RepositorySourceFailure = ValueOf<typeof RepositorySourceFailure>;
@@ -64,3 +64,7 @@ export function isAmbiguityResolutionBlockReason(reason) {
64
64
  return (isRecoveryBlockReason(reason) ||
65
65
  (reason !== undefined && legacyAmbiguityBlockReason.test(reason)));
66
66
  }
67
+ export const RepositorySourceFailure = defineClosedVocabulary({
68
+ FetchFailed: 'fetch-failed',
69
+ RefUnavailable: 'ref-unavailable',
70
+ });
@@ -1,6 +1,8 @@
1
1
  import type { ResourceView } from '../../resources/index.js';
2
2
  import type { WorkItemId } from '../../work/index.js';
3
+ import type { PreparedCandidate } from './candidate.js';
3
4
  import type { RunId } from './identifiers.js';
5
+ import type { PreparedMaintenance } from './maintenance.js';
4
6
  import type { RepositoryAssignment } from './repository-assignment.js';
5
7
  import type { RunView } from './views.js';
6
8
  import type { WorkspaceMode } from './vocabulary.js';
@@ -12,9 +14,12 @@ export interface WorkspaceRequest {
12
14
  readonly repositoryResource: ResourceView;
13
15
  /** Git checkout target, independent of the resource observation revision. */
14
16
  readonly checkoutRevision?: string;
17
+ readonly requiredSourceRef?: string;
15
18
  readonly assignment?: RepositoryAssignment;
16
19
  }
17
20
  export interface WorkspaceLease {
21
+ readonly candidate?: PreparedCandidate;
22
+ readonly maintenance?: PreparedMaintenance;
18
23
  readonly workspaceId: string;
19
24
  readonly path: string;
20
25
  /** Branch actually checked out for this lease, when the provider can attest it. */
@@ -62,3 +67,6 @@ export interface WorkspaceLock {
62
67
  readonly acquired: boolean;
63
68
  release(): Promise<void>;
64
69
  }
70
+ export interface RepositoryCloneResolver {
71
+ cloneLocator(resourceId: string, signal: AbortSignal): Promise<string>;
72
+ }
@@ -37,3 +37,5 @@ export { createLocalProcessInspector } from './infrastructure/local-process-insp
37
37
  export { resolveGitSource } from './infrastructure/workspace/git-source.js';
38
38
  export * from './contracts/repository-assignment.js';
39
39
  export { createRepositoryAssignments } from './application/repository-assignments.js';
40
+ export * from './contracts/candidate.js';
41
+ export * from './contracts/maintenance.js';
@@ -37,3 +37,5 @@ export { createLocalProcessInspector } from './infrastructure/local-process-insp
37
37
  export { resolveGitSource } from './infrastructure/workspace/git-source.js';
38
38
  export * from './contracts/repository-assignment.js';
39
39
  export { createRepositoryAssignments } from './application/repository-assignments.js';
40
+ export * from './contracts/candidate.js';
41
+ export * from './contracts/maintenance.js';
@@ -1,5 +1,5 @@
1
- import type { RepositoryAssignment } from '../../contracts/repository-assignment.js';
2
- import type { RepositoryCloneResolver } from './git-workspace.js';
1
+ import { type RepositoryAssignment } from '../../contracts/repository-assignment.js';
2
+ import type { RepositoryCloneResolver } from '../../contracts/workspace.js';
3
3
  /** Fetching into an empty repository proves availability in the selected source. */
4
4
  export declare function resolveGitSource(resolver: RepositoryCloneResolver, request: Omit<RepositoryAssignment, 'sourceRevision'> & {
5
5
  readonly sourceRevision?: string | undefined;
@@ -3,6 +3,8 @@ import { mkdtemp, rm } from 'node:fs/promises';
3
3
  import { tmpdir } from 'node:os';
4
4
  import { join } from 'node:path';
5
5
  import { promisify } from 'node:util';
6
+ import { RepositorySourceError, } from '../../contracts/repository-assignment.js';
7
+ import { RepositorySourceFailure } from '../../contracts/vocabulary.js';
6
8
  const exec = promisify(execFile);
7
9
  /** Fetching into an empty repository proves availability in the selected source. */
8
10
  export async function resolveGitSource(resolver, request) {
@@ -10,6 +12,9 @@ export async function resolveGitSource(resolver, request) {
10
12
  const locator = await resolver.cloneLocator(request.resourceId, signal);
11
13
  const path = await mkdtemp(join(tmpdir(), 'wake-source-'));
12
14
  try {
15
+ if (request.sourceRevision === undefined &&
16
+ !/^(?:[a-f0-9]{40}|[a-f0-9]{64})$/i.test(request.sourceRef))
17
+ await assertRemoteRef(locator, request, signal);
13
18
  await exec('git', ['init', '--bare', path], { signal });
14
19
  await exec('git', [
15
20
  '-C',
@@ -27,9 +32,21 @@ export async function resolveGitSource(resolver, request) {
27
32
  return { ...request, sourceRevision: revision };
28
33
  }
29
34
  catch (error) {
30
- throw new Error(`Repository ${request.resourceId} source ${request.sourceRevision ?? request.sourceRef} is unavailable; publish the source to the selected repository`, { cause: error });
35
+ if (error instanceof RepositorySourceError)
36
+ throw error;
37
+ throw new RepositorySourceError(RepositorySourceFailure.FetchFailed, `Repository ${request.resourceId} source ${request.sourceRevision ?? request.sourceRef} is unavailable: fetch failed; verify connectivity and permissions, and publish the source to the selected repository if missing`, { cause: error });
31
38
  }
32
39
  finally {
33
40
  await rm(path, { recursive: true, force: true });
34
41
  }
35
42
  }
43
+ async function assertRemoteRef(locator, request, signal) {
44
+ try {
45
+ await exec('git', ['ls-remote', '--exit-code', '--', locator, request.sourceRef], { signal });
46
+ }
47
+ catch (error) {
48
+ if (error instanceof Error && 'code' in error && error.code === 2)
49
+ throw new RepositorySourceError(RepositorySourceFailure.RefUnavailable, `Repository ${request.resourceId} source ${request.sourceRef} is unavailable; remote ref is missing`, { cause: error });
50
+ throw error;
51
+ }
52
+ }
@@ -1,10 +1,8 @@
1
1
  import { type RepositoryAssignment } from '../../contracts/repository-assignment.js';
2
2
  import type { RunView } from '../../contracts/views.js';
3
- import type { WorkspaceLockProvider, WorkspaceProvider, WorkspaceRecovery, WorkspaceRecoveryOptions, WorkspaceRecoveryResult, WorkspaceRequest } from '../../contracts/workspace.js';
3
+ import type { RepositoryCloneResolver, WorkspaceLockProvider, WorkspaceProvider, WorkspaceRecovery, WorkspaceRecoveryOptions, WorkspaceRecoveryResult, WorkspaceRequest } from '../../contracts/workspace.js';
4
4
  import { type WorkspacePrepareHook } from './prepare-workspace.js';
5
- export interface RepositoryCloneResolver {
6
- cloneLocator(resourceId: string, signal: AbortSignal): Promise<string>;
7
- }
5
+ export type { RepositoryCloneResolver } from '../../contracts/workspace.js';
8
6
  export type GitRunner = (arguments_: readonly string[], signal: AbortSignal) => Promise<string | void>;
9
7
  export interface WorkspaceRecoveryFileSystem {
10
8
  remove(path: string): Promise<void>;
@@ -5,6 +5,7 @@ import { basename, dirname, isAbsolute, join, relative, resolve } from 'node:pat
5
5
  import { isDeepStrictEqual, promisify } from 'node:util';
6
6
  import { repositoryAssignmentSchema, } from '../../contracts/repository-assignment.js';
7
7
  import { isActiveRunStatus, RunStatus, WorkspaceMode } from '../../contracts/vocabulary.js';
8
+ import { resolveGitSource } from './git-source.js';
8
9
  import { prepareWorkspace } from './prepare-workspace.js';
9
10
  const exec = promisify(execFile);
10
11
  export class GitWorkspaceProvider {
@@ -33,6 +34,15 @@ export class GitWorkspaceProvider {
33
34
  async acquire(request) {
34
35
  const { signal } = request;
35
36
  signal.throwIfAborted();
37
+ if (request.requiredSourceRef !== undefined) {
38
+ const source = await resolveGitSource(this.resolver, {
39
+ resourceId: request.repositoryResource.resourceId,
40
+ sourceRef: request.requiredSourceRef,
41
+ pullRequestBase: request.assignment?.pullRequestBase ?? request.requiredSourceRef,
42
+ });
43
+ if (source.sourceRevision !== request.checkoutRevision)
44
+ throw new Error('Candidate source moved from its exact revision');
45
+ }
36
46
  const locator = await this.resolver.cloneLocator(request.repositoryResource.resourceId, signal);
37
47
  signal.throwIfAborted();
38
48
  const name = `${request.workItemId}-${request.mode}-${slug(locator)}`;
@@ -509,7 +519,8 @@ function assertAssignment(previousMarker, request) {
509
519
  (previousMarker.assignment !== undefined || request.assignment !== undefined) &&
510
520
  previousMarker.repositoryResourceId !== request.repositoryResource.resourceId)
511
521
  throw new Error('Workspace belongs to a different Repository Resource');
512
- if (previousMarker?.assignment !== undefined &&
522
+ if (request.mode === WorkspaceMode.Branch &&
523
+ previousMarker?.assignment !== undefined &&
513
524
  !isDeepStrictEqual(previousMarker.assignment, request.assignment))
514
525
  throw new Error('Workspace repository assignment changed; reconcile the existing branch before retrying');
515
526
  }
@@ -101,7 +101,7 @@ async function qualifyingChange(input, child, output, condition) {
101
101
  branch,
102
102
  pullRequestBase: assignment.pullRequestBase,
103
103
  runId: run.runId,
104
- ...(condition === undefined ? {} : { baseRevision: observed.baseRevision }),
104
+ baseRevision: observed.baseRevision,
105
105
  ...(observed.state === PullRequestState.Merged ? { merged: true } : {}),
106
106
  },
107
107
  };