@shapeshift-labs/frontier-swarm 0.5.22 → 0.5.23

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 import type { JsonObject, JsonValue } from '@shapeshift-labs/frontier';
 import { type FrontierRunActorId, type FrontierRunDashboardSnapshot, type FrontierRunEvent, type FrontierRunEventId, type FrontierRunProjection } from '@shapeshift-labs/frontier-run';
+import { validateSemanticLeaseFence, type FrontierSemanticLeaseMutation, type FrontierSemanticLeaseRecord, type FrontierSemanticLeaseScope, type FrontierSemanticLeaseState } from '@shapeshift-labs/frontier-lease';
 export declare const FRONTIER_SWARM_MANIFEST_KIND = "frontier.swarm.manifest";
 export declare const FRONTIER_SWARM_MANIFEST_VERSION = 1;
 export declare const FRONTIER_SWARM_TASK_KIND = "frontier.swarm.task";
@@ -3308,6 +3309,7 @@ export interface FrontierSwarmMergeQueueScope {
     changedRegions: string[];
     leaseKey: string;
     jobIds: string[];
+    semanticLeaseScope?: FrontierSemanticLeaseScope;
     metadata?: JsonObject;
 }
 export interface FrontierSwarmMergeQueueRetrySlice {
@@ -3318,6 +3320,8 @@ export interface FrontierSwarmMergeQueueRetrySlice {
     leaseKey: string;
     requiredLeaseScopeIds?: string[];
     requiredLeaseKeys?: string[];
+    semanticLeaseScope?: FrontierSemanticLeaseScope;
+    requiredSemanticLeaseScopes?: FrontierSemanticLeaseScope[];
     lane?: string;
     changedPaths: string[];
     changedRegions: string[];
@@ -3375,6 +3379,7 @@ export interface FrontierSwarmHierarchicalQueueLeaseRecord {
     lane?: string;
     title: string;
     leaseKey: string;
+    semanticLeaseScope?: FrontierSemanticLeaseScope;
     localLeader?: FrontierSwarmHierarchicalQueueLocalLeader;
     promotion: FrontierSwarmHierarchicalQueuePromotionState;
     conflictReasons: string[];
@@ -3426,6 +3431,7 @@ export interface FrontierSwarmHierarchicalMergeQueue {
     byScope: Record<string, string[]>;
     byLeaseKey: Record<string, string[]>;
     byAction: Record<string, string[]>;
+    semanticLeaseScopes: FrontierSemanticLeaseScope[];
     summary: {
         scopeCount: number;
         assignmentCount: number;
@@ -3460,6 +3466,7 @@ export interface FrontierSwarmMergeQueueAssignment {
     leaseKey: string;
     requiredLeaseScopeIds?: string[];
     requiredLeaseKeys?: string[];
+    requiredSemanticLeaseScopes?: FrontierSemanticLeaseScope[];
     promoteToScopeId?: string;
     terminalDecisionId?: string;
     terminalDecisionQueueItemIds?: string[];
@@ -3879,6 +3886,7 @@ export interface FrontierSwarmCoordinatorAgentDrainLease {
     title: string;
     leaseScope: string;
     leaseKey: string;
+    semanticLeaseScope?: FrontierSemanticLeaseScope;
     parentQueueId?: string;
     lane?: string;
     changedPaths: string[];
@@ -3921,6 +3929,7 @@ export interface FrontierSwarmCoordinatorAgentDrainAssignment {
     semanticSliceLeaseKeys?: string[];
     requiredLeaseScopeIds?: string[];
     requiredLeaseKeys?: string[];
+    requiredSemanticLeaseScopes?: FrontierSemanticLeaseScope[];
     parentDecisionRegions?: string[];
     unknownRegions?: string[];
     metadata?: JsonObject;
@@ -3942,10 +3951,49 @@ export interface FrontierSwarmCoordinatorAgentDrainTerminalDecision {
     semanticSliceLeaseKeys?: string[];
     requiredLeaseScopeIds?: string[];
     requiredLeaseKeys?: string[];
+    requiredSemanticLeaseScopes?: FrontierSemanticLeaseScope[];
     parentDecisionRegions?: string[];
     unknownRegions?: string[];
     metadata?: JsonObject;
 }
+export interface FrontierSwarmSemanticLeaseScopeOptions {
+    repository?: string;
+    packageId?: string;
+    rootScopeId?: string;
+    metadata?: unknown;
+}
+export interface FrontierSwarmCoordinatorSemanticLeaseAcquireInput {
+    queue: FrontierSwarmHierarchicalMergeQueue;
+    assignment: FrontierSwarmMergeQueueAssignment | FrontierSwarmCoordinatorAgentDrainAssignment;
+    state?: FrontierSemanticLeaseState;
+    ownerId: string;
+    holderId?: string;
+    now?: number;
+    ttlMs?: number;
+    purpose?: string;
+    reason?: string;
+    repository?: string;
+    packageId?: string;
+    metadata?: unknown;
+}
+export interface FrontierSwarmCoordinatorSemanticLeaseAcquireResult {
+    state: FrontierSemanticLeaseState;
+    mutation: FrontierSemanticLeaseMutation;
+    scopes: FrontierSemanticLeaseScope[];
+    requiredLeaseScopeIds: string[];
+    requiredLeaseKeys: string[];
+    lease?: FrontierSemanticLeaseRecord;
+}
+export interface FrontierSwarmCoordinatorSemanticLeaseFenceInput {
+    assignment: FrontierSwarmMergeQueueAssignment | FrontierSwarmCoordinatorAgentDrainAssignment;
+    state: FrontierSemanticLeaseState;
+    lease?: FrontierSemanticLeaseRecord;
+    leaseId?: string;
+    token: string;
+    fencingToken: number;
+    now?: number;
+    requiredSemanticLeaseScopes?: readonly FrontierSemanticLeaseScope[];
+}
 export interface FrontierSwarmCoordinatorAgentPromotedWork {
     id: string;
     jobId: string;
@@ -3963,6 +4011,7 @@ export interface FrontierSwarmCoordinatorAgentPromotedWork {
     reasons: string[];
     requiredLeaseScopeIds?: string[];
     requiredLeaseKeys?: string[];
+    requiredSemanticLeaseScopes?: FrontierSemanticLeaseScope[];
     metadata?: JsonObject;
 }
 export interface FrontierSwarmContinuousPoolWorkItemInput {
@@ -4250,6 +4299,18 @@ export declare function createSwarmLanePlaybook(input: FrontierSwarmLanePlaybook
 export declare function createSwarmPatchStackPlan(input: FrontierSwarmPatchStackPlanInput): FrontierSwarmPatchStackPlan;
 export declare function createSwarmHierarchicalMergeQueue(input: FrontierSwarmHierarchicalMergeQueueInput): FrontierSwarmHierarchicalMergeQueue;
 export declare function createSwarmCoordinatorAgentDrainWork(input: FrontierSwarmCoordinatorAgentDrainWorkInput): FrontierSwarmCoordinatorAgentDrainWork;
+export declare function createSwarmSemanticLeaseScopeForMergeQueueScope(scope: FrontierSwarmMergeQueueScope, input?: FrontierSwarmSemanticLeaseScopeOptions & {
+    scopes?: readonly FrontierSwarmMergeQueueScope[];
+}): FrontierSemanticLeaseScope;
+export declare function createSwarmSemanticLeaseScopesForMergeQueue(queue: FrontierSwarmHierarchicalMergeQueue, input?: FrontierSwarmSemanticLeaseScopeOptions): FrontierSemanticLeaseScope[];
+export declare function createSwarmSemanticLeaseStateForMergeQueue(queue: FrontierSwarmHierarchicalMergeQueue, input?: FrontierSwarmSemanticLeaseScopeOptions & {
+    id?: string;
+    defaultTtlMs?: number;
+    now?: number;
+    metadata?: unknown;
+}): FrontierSemanticLeaseState;
+export declare function acquireSwarmCoordinatorSemanticLease(input: FrontierSwarmCoordinatorSemanticLeaseAcquireInput): FrontierSwarmCoordinatorSemanticLeaseAcquireResult;
+export declare function validateSwarmCoordinatorSemanticLeaseFence(input: FrontierSwarmCoordinatorSemanticLeaseFenceInput): ReturnType<typeof validateSemanticLeaseFence>;
 export declare function summarizeSwarmCoordinatorAgentDrainWork(work: Pick<FrontierSwarmCoordinatorAgentDrainWork, 'leases' | 'assignments' | 'terminalDecisions' | 'promotedWork'>): FrontierSwarmCoordinatorAgentDrainWorkConsumerSummary;
 export declare function createSwarmContinuousPoolState(input?: FrontierSwarmContinuousPoolStateInput): FrontierSwarmContinuousPoolState;
 export declare function classifySwarmQueueOutcome(input: FrontierSwarmQueueOutcomeDecisionInput): FrontierSwarmQueueOutcomeClassification;