@shapeshift-labs/frontier-swarm 0.5.25 → 0.5.27

package/README.md

@@ -97,6 +97,7 @@ The published Frontier package family is generated from one shared package catal
 - [`@shapeshift-labs/frontier-migrations`](https://www.npmjs.com/package/@shapeshift-labs/frontier-migrations): Boundary-first data migrations, import normalization, plugin/API version mapping, versioned envelopes, graph diagnostics, patch path rewrites, dry-run reports, and current-shape rehydration.
 - [`@shapeshift-labs/frontier-event-log`](https://www.npmjs.com/package/@shapeshift-labs/frontier-event-log): Bounded event logs, replay cursors, consumer acknowledgements, keyed compaction, checkpoints, and Frontier patch event records.
 - [`@shapeshift-labs/frontier-run`](https://www.npmjs.com/package/@shapeshift-labs/frontier-run): Append-only distributed run graphs, causal event DAGs, evidence nodes, lanes, leases, refs, segments, dashboard projections, and admission decision records for Frontier agent work.
+- [`@shapeshift-labs/frontier-lease`](https://www.npmjs.com/package/@shapeshift-labs/frontier-lease): Runtime-neutral semantic, file, package, and repository lease claims with fencing tokens, expiry, conflict checks, apply validation, and replayable evidence for Frontier collaboration.
 - [`@shapeshift-labs/frontier-inspect`](https://www.npmjs.com/package/@shapeshift-labs/frontier-inspect): Cross-package inspection/evidence bundles, registry graph snapshots, feature/resource impact reports, timeline/event normalization, redaction, JSONL import/export, and AI-readable app feature maps.
 - [`@shapeshift-labs/frontier-scheduler`](https://www.npmjs.com/package/@shapeshift-labs/frontier-scheduler): Deterministic work scheduling, lanes, cancellation, backpressure, frame policies, replay snapshots, and work graphs.
 - [`@shapeshift-labs/frontier-logging`](https://www.npmjs.com/package/@shapeshift-labs/frontier-logging): Opt-in structured logging, browser telemetry, scheduled sinks, file sinks, exporters, benchmark traces, and Frontier patch/update summaries.
@@ -111,7 +112,9 @@ The published Frontier package family is generated from one shared package catal
 - [`@shapeshift-labs/frontier-workflow`](https://www.npmjs.com/package/@shapeshift-labs/frontier-workflow): Serializable durable workflow/process manifests for Frontier apps, including steps, waits, approvals, timers, retries, expected patches, compensation, records, timelines, and registry graph output.
 - [`@shapeshift-labs/frontier-worker`](https://www.npmjs.com/package/@shapeshift-labs/frontier-worker): Serializable worker and edge task descriptors for Frontier apps, including queues, idempotency keys, retry and timeout policy, declared reads/writes/effects, snapshots, patch outputs, produced assets, execution records, logs, trace links, proof hashes, dedupe indexes, and registry graph output.
 - [`@shapeshift-labs/frontier-queue`](https://www.npmjs.com/package/@shapeshift-labs/frontier-queue): Serializable durable queue state, leases, retries, dedupe keys, patch-carrying jobs, dead-letter records, replay evidence, and queue inspection for Frontier apps.
+- [`@shapeshift-labs/frontier-swarm-git`](https://www.npmjs.com/package/@shapeshift-labs/frontier-swarm-git): Node Git, workspace, patch, changed-path, write-fence, package-link repair, patch check, HEAD read, blob hash, and apply-ledger adapter for Frontier swarm runners.
 - [`@shapeshift-labs/frontier-swarm-codex`](https://www.npmjs.com/package/@shapeshift-labs/frontier-swarm-codex): Node Codex CLI adapter for Frontier swarm plans, including prompt rendering, worktree and snapshot workspaces, Codex argument compatibility, browser resource allocation, JSONL capture, verification commands, pid-backed stop, collect/apply workflows, merge indexes, queue overlays, merge bundles, normalized job evidence, coordinator query artifacts, and result artifacts.
+- [`@shapeshift-labs/frontier-loom-ui`](https://www.npmjs.com/package/@shapeshift-labs/frontier-loom-ui): Read-only Loom and Frontier operator dashboard for workspace-lifetime progress, active agents, queue state, evidence/admission status, run events, semantic leases, gate executions, git apply/workspace evidence, and coordinator steering intent files.
 - [`@shapeshift-labs/frontier-lang-kernel`](https://www.npmjs.com/package/@shapeshift-labs/frontier-lang-kernel): Runtime-neutral semantic source graph, type/lattice/extern declarations, patch bundles, replay, hashing, evidence records, and merge-admission kernel for Frontier Lang.
 - [`@shapeshift-labs/frontier-lang-parser`](https://www.npmjs.com/package/@shapeshift-labs/frontier-lang-parser): Dependency-light Frontier Lang parser for modules, entities, state, actions, effects, types, externs, targets, and lattice declarations.
 - [`@shapeshift-labs/frontier-lang-checker`](https://www.npmjs.com/package/@shapeshift-labs/frontier-lang-checker): Checker and diagnostics for Frontier Lang semantic documents, including type symbols, effects, regions, lattice laws, CRDT metadata, and patch evidence.
@@ -191,6 +194,7 @@ Package source repositories:
 - [`siliconjungle/-shapeshift-labs-frontier-migrations`](https://github.com/siliconjungle/-shapeshift-labs-frontier-migrations)
 - [`siliconjungle/-shapeshift-labs-frontier-event-log`](https://github.com/siliconjungle/-shapeshift-labs-frontier-event-log)
 - [`siliconjungle/-shapeshift-labs-frontier-run`](https://github.com/siliconjungle/-shapeshift-labs-frontier-run)
+- [`siliconjungle/-shapeshift-labs-frontier-lease`](https://github.com/siliconjungle/-shapeshift-labs-frontier-lease)
 - [`siliconjungle/-shapeshift-labs-frontier-inspect`](https://github.com/siliconjungle/-shapeshift-labs-frontier-inspect)
 - [`siliconjungle/-shapeshift-labs-frontier-scheduler`](https://github.com/siliconjungle/-shapeshift-labs-frontier-scheduler)
 - [`siliconjungle/-shapeshift-labs-frontier-logging`](https://github.com/siliconjungle/-shapeshift-labs-frontier-logging)
@@ -206,7 +210,9 @@ Package source repositories:
 - [`siliconjungle/-shapeshift-labs-frontier-worker`](https://github.com/siliconjungle/-shapeshift-labs-frontier-worker)
 - [`siliconjungle/-shapeshift-labs-frontier-queue`](https://github.com/siliconjungle/-shapeshift-labs-frontier-queue)
 - [`siliconjungle/-shapeshift-labs-frontier-swarm`](https://github.com/siliconjungle/-shapeshift-labs-frontier-swarm)
+- [`siliconjungle/-shapeshift-labs-frontier-swarm-git`](https://github.com/siliconjungle/-shapeshift-labs-frontier-swarm-git)
 - [`siliconjungle/-shapeshift-labs-frontier-swarm-codex`](https://github.com/siliconjungle/-shapeshift-labs-frontier-swarm-codex)
+- [`siliconjungle/frontier-loom-ui`](https://github.com/siliconjungle/frontier-loom-ui)
 - [`siliconjungle/-shapeshift-labs-frontier-lang-kernel`](https://github.com/siliconjungle/-shapeshift-labs-frontier-lang-kernel)
 - [`siliconjungle/-shapeshift-labs-frontier-lang-parser`](https://github.com/siliconjungle/-shapeshift-labs-frontier-lang-parser)
 - [`siliconjungle/-shapeshift-labs-frontier-lang-checker`](https://github.com/siliconjungle/-shapeshift-labs-frontier-lang-checker)

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;