@shapeshift-labs/frontier-swarm 0.5.24 → 0.5.26

package/dist/index.d.ts

@@ -1,6 +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';
+import { validateSemanticLeaseFence, type FrontierSemanticLeaseFenceTicket, 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";
@@ -4007,6 +4007,74 @@ export interface FrontierSwarmCoordinatorSemanticLeaseFenceInput {
     now?: number;
     requiredSemanticLeaseScopes?: readonly FrontierSemanticLeaseScope[];
 }
+export interface FrontierSwarmCoordinatorQueueItemClaimInput {
+    queue: FrontierSwarmHierarchicalMergeQueue;
+    assignment?: FrontierSwarmMergeQueueAssignment;
+    jobId?: string;
+    queueItemId?: string;
+    coordinatorId?: string;
+    now?: number;
+    metadata?: unknown;
+}
+export interface FrontierSwarmCoordinatorQueueItemClaim {
+    id: string;
+    queueId: string;
+    mergeIndexId: string;
+    generatedAt: number;
+    coordinatorId: string;
+    claimed: boolean;
+    jobId?: string;
+    taskId?: string;
+    lane?: string;
+    queueItemIds: string[];
+    queueIdForAssignment?: string;
+    assignedAction?: FrontierSwarmMergeQueueAssignmentAction;
+    requiredLeaseScopeIds: string[];
+    requiredLeaseKeys: string[];
+    requiredSemanticLeaseScopes: FrontierSemanticLeaseScope[];
+    reasons: string[];
+    assignment?: FrontierSwarmMergeQueueAssignment;
+    metadata?: JsonObject;
+}
+export interface FrontierSwarmCoordinatorQueueLeaseClaimInput extends Omit<FrontierSwarmCoordinatorSemanticLeaseAcquireInput, 'queue' | 'assignment'> {
+    queue: FrontierSwarmHierarchicalMergeQueue;
+    claim: FrontierSwarmCoordinatorQueueItemClaim;
+    state?: FrontierSemanticLeaseState;
+}
+export interface FrontierSwarmCoordinatorQueueLeaseClaim {
+    id: string;
+    queueId: string;
+    claimId: string;
+    generatedAt: number;
+    granted: boolean;
+    state: FrontierSemanticLeaseState;
+    mutation: FrontierSemanticLeaseMutation;
+    scopes: FrontierSemanticLeaseScope[];
+    requiredLeaseScopeIds: string[];
+    requiredLeaseKeys: string[];
+    lease?: FrontierSemanticLeaseRecord;
+    fence?: FrontierSemanticLeaseFenceTicket;
+    reasons: string[];
+}
+export interface FrontierSwarmCoordinatorClaimDecisionInput {
+    claim: FrontierSwarmCoordinatorQueueItemClaim;
+    leaseClaim?: FrontierSwarmCoordinatorQueueLeaseClaim;
+    decision?: FrontierSwarmCoordinatorAgentDrainDecision | string;
+    outcome?: FrontierSwarmQueueOutcome;
+    category?: FrontierSwarmQueueOutcomeCategory;
+    terminal?: boolean;
+    status?: string;
+    reasons?: readonly string[];
+    conflictingJobIds?: readonly string[];
+    generatedAt?: number;
+    metadata?: unknown;
+}
+export interface FrontierSwarmCoordinatorClaimDecision {
+    claim: FrontierSwarmCoordinatorQueueItemClaim;
+    leaseClaim?: FrontierSwarmCoordinatorQueueLeaseClaim;
+    decision: FrontierSwarmQueueOutcomeDecision;
+    runEvents: FrontierRunEvent[];
+}
 export interface FrontierSwarmCoordinatorAgentPromotedWork {
     id: string;
     jobId: string;
@@ -4326,6 +4394,10 @@ export declare function createSwarmSemanticLeaseStateForMergeQueue(queue: Fronti
 }): FrontierSemanticLeaseState;
 export declare function acquireSwarmCoordinatorSemanticLease(input: FrontierSwarmCoordinatorSemanticLeaseAcquireInput): FrontierSwarmCoordinatorSemanticLeaseAcquireResult;
 export declare function validateSwarmCoordinatorSemanticLeaseFence(input: FrontierSwarmCoordinatorSemanticLeaseFenceInput): ReturnType<typeof validateSemanticLeaseFence>;
+export declare function claimSwarmCoordinatorQueueItem(input: FrontierSwarmCoordinatorQueueItemClaimInput): FrontierSwarmCoordinatorQueueItemClaim;
+export declare function claimSwarmCoordinatorQueueLease(input: FrontierSwarmCoordinatorQueueLeaseClaimInput): FrontierSwarmCoordinatorQueueLeaseClaim;
+export declare function decideSwarmCoordinatorClaim(input: FrontierSwarmCoordinatorClaimDecisionInput): FrontierSwarmCoordinatorClaimDecision;
+export declare function createRunEventsFromCoordinatorClaimDecision(decision: FrontierSwarmQueueOutcomeDecision | FrontierSwarmQueueOutcomeDecisionInput, options?: FrontierSwarmRunEventAdapterOptions): FrontierRunEvent[];
 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;