@shapeshift-labs/frontier-swarm 0.5.22 → 0.5.24

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";
@@ -1764,6 +1765,19 @@ export interface FrontierSwarmRunProjectionOptions {
     goal?: string;
     metadata?: unknown;
 }
+export interface FrontierSwarmRunFromProjectionOptions {
+    plan: FrontierSwarmPlan;
+    id?: string;
+    startedAt?: number;
+    status?: FrontierSwarmJobStatus;
+    metadata?: unknown;
+}
+export interface FrontierSwarmQueueOverlayFromProjectionOptions {
+    plan: FrontierSwarmPlan;
+    id?: string;
+    generatedAt?: number;
+    metadata?: unknown;
+}
 export interface FrontierSwarmEventInput {
     id?: string;
     type: string;
@@ -3308,6 +3322,7 @@ export interface FrontierSwarmMergeQueueScope {
     changedRegions: string[];
     leaseKey: string;
     jobIds: string[];
+    semanticLeaseScope?: FrontierSemanticLeaseScope;
     metadata?: JsonObject;
 }
 export interface FrontierSwarmMergeQueueRetrySlice {
@@ -3318,6 +3333,8 @@ export interface FrontierSwarmMergeQueueRetrySlice {
     leaseKey: string;
     requiredLeaseScopeIds?: string[];
     requiredLeaseKeys?: string[];
+    semanticLeaseScope?: FrontierSemanticLeaseScope;
+    requiredSemanticLeaseScopes?: FrontierSemanticLeaseScope[];
     lane?: string;
     changedPaths: string[];
     changedRegions: string[];
@@ -3375,6 +3392,7 @@ export interface FrontierSwarmHierarchicalQueueLeaseRecord {
     lane?: string;
     title: string;
     leaseKey: string;
+    semanticLeaseScope?: FrontierSemanticLeaseScope;
     localLeader?: FrontierSwarmHierarchicalQueueLocalLeader;
     promotion: FrontierSwarmHierarchicalQueuePromotionState;
     conflictReasons: string[];
@@ -3426,6 +3444,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 +3479,7 @@ export interface FrontierSwarmMergeQueueAssignment {
     leaseKey: string;
     requiredLeaseScopeIds?: string[];
     requiredLeaseKeys?: string[];
+    requiredSemanticLeaseScopes?: FrontierSemanticLeaseScope[];
     promoteToScopeId?: string;
     terminalDecisionId?: string;
     terminalDecisionQueueItemIds?: string[];
@@ -3879,6 +3899,7 @@ export interface FrontierSwarmCoordinatorAgentDrainLease {
     title: string;
     leaseScope: string;
     leaseKey: string;
+    semanticLeaseScope?: FrontierSemanticLeaseScope;
     parentQueueId?: string;
     lane?: string;
     changedPaths: string[];
@@ -3921,6 +3942,7 @@ export interface FrontierSwarmCoordinatorAgentDrainAssignment {
     semanticSliceLeaseKeys?: string[];
     requiredLeaseScopeIds?: string[];
     requiredLeaseKeys?: string[];
+    requiredSemanticLeaseScopes?: FrontierSemanticLeaseScope[];
     parentDecisionRegions?: string[];
     unknownRegions?: string[];
     metadata?: JsonObject;
@@ -3942,10 +3964,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 +4024,7 @@ export interface FrontierSwarmCoordinatorAgentPromotedWork {
     reasons: string[];
     requiredLeaseScopeIds?: string[];
     requiredLeaseKeys?: string[];
+    requiredSemanticLeaseScopes?: FrontierSemanticLeaseScope[];
     metadata?: JsonObject;
 }
 export interface FrontierSwarmContinuousPoolWorkItemInput {
@@ -4192,6 +4254,8 @@ export declare function createRunEventsFromSwarmResult(resultInput: FrontierSwar
 export declare function createRunEventsFromMergeBundle(bundle: FrontierSwarmMergeBundle, options?: FrontierSwarmRunEventAdapterOptions): FrontierRunEvent[];
 export declare function createRunEventsFromCoordinatorDecision(decision: FrontierSwarmQueueOutcomeDecision | FrontierSwarmQueueOutcomeDecisionInput, options?: FrontierSwarmRunEventAdapterOptions): FrontierRunEvent[];
 export declare function createRunProjectionFromSwarmRunEvents(events: readonly FrontierRunEvent[], options?: FrontierSwarmRunProjectionOptions): FrontierRunProjection;
+export declare function createSwarmRunFromRunProjection(projection: FrontierRunProjection, options: FrontierSwarmRunFromProjectionOptions): FrontierSwarmRun;
+export declare function createSwarmQueueOverlayFromRunProjection(projection: FrontierRunProjection, options: FrontierSwarmQueueOverlayFromProjectionOptions): FrontierSwarmQueueOverlay;
 export declare function createRunDashboardFromSwarmRun(input: FrontierSwarmRun | readonly FrontierRunEvent[], options?: FrontierSwarmRunProjectionOptions): FrontierRunDashboardSnapshot;
 export declare function createRunEventsFromSwarmRun(run: FrontierSwarmRun, options?: FrontierSwarmRunEventAdapterOptions): FrontierRunEvent[];
 export declare function recordSwarmEvent(runInput: FrontierSwarmRun, eventInput: FrontierSwarmEventInput): FrontierSwarmRun;
@@ -4250,6 +4314,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;