@elaraai/e3-rack 0.0.0-bootstrap.0 → 1.0.94

package/dist/src/lease/closure.js

@@ -0,0 +1,192 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * A lease's closure (#214): every object its guest's execution reads, which
+ * the cloud computes when it grants the lease. The agent fetches exactly
+ * these into its cache and links them into the guest's scratch, and
+ * `/rack/storage` admits exactly these: a rack reaches no other object of the
+ * repository.
+ *
+ * What e3-core's execution reads over a staged store:
+ * - a task or a unit: its task object; its program, or its command IR; what
+ *   its output kind folds with (a dict's merge, a fold's zero and combine);
+ *   its environment's spec and the files that names; and each object it
+ *   stages (a task's inputs, a piece's inputs, a merge's range and parts);
+ * - a function call: its program, its environment, and each stored dataset
+ *   argument;
+ * - a staged dataset: the object, and, for a record state, its primary; for a
+ *   manifest, its header and its segments.
+ *
+ * A closure larger than {@link INLINE_CLOSURE_MAX} hashes is recorded as an
+ * object in the repository's store, whose hash the lease carries.
+ */
+import { ArrayType, StringType, decodeBeast2For, encodeBeast2For } from '@elaraai/east';
+import { openDatasetObject } from '@elaraai/e3-core';
+import { EnvironmentSpecType, environmentSpecObjectHashes } from '@elaraai/e3-types';
+/** The most hashes a lease's event carries inline: past it, the closure is an object. */
+export const INLINE_CLOSURE_MAX = 512;
+/** A closure object: the hashes, as a beast2 `Array<String>`. */
+const ClosureListType = ArrayType(StringType);
+const encodeList = encodeBeast2For(ClosureListType);
+const decodeList = decodeBeast2For(ClosureListType);
+const decodeEnvironmentSpec = decodeBeast2For(EnvironmentSpecType);
+/**
+ * A closure object's bytes.
+ *
+ * @param hashes - The closure's hashes
+ * @returns The object's bytes
+ */
+export function encodeClosure(hashes) {
+    return encodeList([...hashes]);
+}
+/**
+ * The hashes a closure object lists.
+ *
+ * @param bytes - The object's bytes
+ * @returns The hashes
+ * @throws {Error} When the bytes are not a closure object
+ */
+export function decodeClosure(bytes) {
+    return decodeList(bytes);
+}
+/**
+ * What a unit's execution stages: a piece's inputs, or a merge's key range
+ * and its parts (e3-core's `taskExecuteBody`).
+ *
+ * @param inputs - The unit's inputs, as its record names them
+ * @param merge - What a merge unit merges, or null for a piece
+ * @returns The staged objects' hashes
+ */
+export function stagedObjects(inputs, merge) {
+    return merge === null ? [...inputs] : [...(merge.range === null ? [] : [merge.range]), ...merge.parts];
+}
+/**
+ * The closure of a task's or a unit's execution.
+ *
+ * @param storage - The repository's storage
+ * @param repo - Repository identifier
+ * @param taskHash - The task object's hash
+ * @param task - The task object
+ * @param staged - What the execution stages ({@link stagedObjects})
+ * @param parts - Collects the closure's collection parts (each staged
+ *   manifest's entries): what a unit fetches only as it reads them
+ * @returns The objects it reads, sorted
+ * @throws {Error} When an object it names cannot be read
+ */
+export async function taskClosure(storage, repo, taskHash, task, staged, parts) {
+    const into = new Set([taskHash]);
+    into.add(task.body.type === 'east' ? task.body.value.program : task.body.value.commandIr);
+    const kind = task.output.kind;
+    if (kind.type === 'dict' && kind.value.merge.type === 'some')
+        into.add(kind.value.merge.value);
+    if (kind.type === 'fold') {
+        into.add(kind.value.zero);
+        into.add(kind.value.combine);
+    }
+    if (task.environment.type === 'some')
+        await addEnvironment(storage, repo, task.environment.value, into);
+    for (const hash of new Set(staged))
+        await addValue(storage, repo, hash, into, parts);
+    return [...into].sort();
+}
+/**
+ * The closure of a function call's execution.
+ *
+ * @param storage - The repository's storage
+ * @param repo - Repository identifier
+ * @param program - The program's object hash
+ * @param args - The call's arguments: a stored dataset's objects are staged
+ * @param environment - The environment the call declares
+ * @returns The objects it reads, sorted
+ * @throws {Error} When an object it names cannot be read
+ */
+export async function detachedClosure(storage, repo, program, args, environment) {
+    return [...new Set([program, ...await callClosure(storage, repo, args, environment)])].sort();
+}
+/**
+ * The closure of a function call whose program travels with it, not as an
+ * object: its environment, and each stored dataset argument (#225, a
+ * sandbox's call).
+ *
+ * @param storage - The repository's storage
+ * @param repo - Repository identifier
+ * @param args - The call's arguments: a stored dataset's objects are staged
+ * @param environment - The environment the call declares
+ * @param parts - Collects the closure's collection parts, as {@link taskClosure}'s
+ * @returns The objects it reads, sorted
+ * @throws {Error} When an object it names cannot be read
+ */
+export async function callClosure(storage, repo, args, environment, parts) {
+    const into = new Set();
+    if (environment !== undefined)
+        await addEnvironment(storage, repo, environment, into);
+    for (const arg of args) {
+        if (!(arg instanceof Uint8Array))
+            await addValue(storage, repo, arg.dataset, into, parts);
+    }
+    return [...into].sort();
+}
+/**
+ * Records a closure on a lease: its hashes inline, or, when there are more
+ * than {@link INLINE_CLOSURE_MAX}, an object in the repository's store that
+ * lists them.
+ *
+ * @param storage - The repository's storage
+ * @param repo - Repository identifier
+ * @param hashes - The closure
+ * @returns What the lease's event carries
+ */
+export async function recordClosure(storage, repo, hashes) {
+    if (hashes.length <= INLINE_CLOSURE_MAX)
+        return { hashes: [...hashes] };
+    const object = await storage.objects.write(repo, encodeClosure(hashes));
+    return { object, count: hashes.length };
+}
+/**
+ * Every object a lease may read, as its closure names them: the hashes, and,
+ * for a closure recorded as an object, that object too.
+ *
+ * @param closure - The lease's closure
+ * @param read - Reads the closure object, for one recorded as an object
+ * @returns The hashes
+ * @throws {Error} When the closure object cannot be read, or lists another
+ *   number of hashes than the lease says
+ */
+export async function closureHashes(closure, read) {
+    if ('hashes' in closure)
+        return [...closure.hashes];
+    const hashes = decodeClosure(await read(closure.object));
+    if (hashes.length !== closure.count) {
+        throw new Error(`closure object ${closure.object} lists ${hashes.length} hashes, and its lease ${closure.count}`);
+    }
+    return [closure.object, ...hashes];
+}
+/** A staged dataset's objects: the object, a record state's primary, a manifest's header and segments (its parts). */
+async function addValue(storage, repo, hash, into, parts) {
+    if (into.has(hash))
+        return;
+    into.add(hash);
+    const opened = await openDatasetObject(storage, repo, hash);
+    into.add(opened.hash);
+    if (opened.manifest === null)
+        return;
+    into.add(opened.manifest.header);
+    for (const entry of opened.manifest.entries) {
+        if (opened.manifest.level === 0n) {
+            into.add(entry.hash);
+            parts?.add(entry.hash);
+        }
+        else
+            await addValue(storage, repo, entry.hash, into, parts);
+    }
+}
+/** An environment's spec and the files it names. */
+async function addEnvironment(storage, repo, hash, into) {
+    into.add(hash);
+    const spec = decodeEnvironmentSpec(await storage.objects.read(repo, hash));
+    for (const file of environmentSpecObjectHashes(spec))
+        into.add(file);
+}
+//# sourceMappingURL=closure.js.map

package/dist/src/lease/closure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"closure.js","sourceRoot":"","sources":["../../../src/lease/closure.ts"],"names":[],"mappings":"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"}

package/dist/src/lease/closure.spec.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+export {};
+//# sourceMappingURL=closure.spec.d.ts.map

package/dist/src/lease/closure.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"closure.spec.d.ts","sourceRoot":"","sources":["../../../src/lease/closure.spec.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/src/lease/closure.spec.js

@@ -0,0 +1,35 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import { afterEach, it } from 'node:test';
+import assert from 'node:assert/strict';
+import { mkdtemp, rm } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { ArrayType, IntegerType, encodeCollectionManifest } from '@elaraai/east';
+import { LocalStorage, datasetWrite, openDatasetObject, repoInit } from '@elaraai/e3-core';
+import { callClosure, closureHashes, recordClosure } from './closure.js';
+const homes = [];
+afterEach(async () => { for (const home of homes.splice(0))
+    await rm(home, { recursive: true, force: true }); });
+it('includes every descendant of a nested collection manifest and records large closures', async () => {
+    const repo = await mkdtemp(join(tmpdir(), 'e3-closure-'));
+    homes.push(repo);
+    assert(repoInit(repo).success);
+    const storage = new LocalStorage();
+    const leaf = await datasetWrite(storage, repo, [1n, 2n], ArrayType(IntegerType));
+    const opened = await openDatasetObject(storage, repo, leaf);
+    assert(opened.manifest);
+    const root = await storage.objects.write(repo, encodeCollectionManifest({ ...opened.manifest, level: 1n,
+        entries: [{ hash: leaf, count: 2n, bytes: BigInt((await storage.objects.stat(repo, leaf)).size), fence: new Uint8Array() }] }));
+    const parts = new Set();
+    const hashes = await callClosure(storage, repo, [{ dataset: root }], undefined, parts);
+    assert.deepEqual(hashes, [...new Set([root, leaf, opened.manifest.header, ...opened.manifest.entries.map((entry) => entry.hash)])].sort());
+    assert.deepEqual([...parts], opened.manifest.entries.map((entry) => entry.hash));
+    const large = Array.from({ length: 513 }, (_, n) => n.toString(16).padStart(64, '0'));
+    const closure = await recordClosure(storage, repo, large);
+    assert('object' in closure);
+    assert.deepEqual(await closureHashes(closure, (hash) => storage.objects.read(repo, hash)), [closure.object, ...large]);
+});
+//# sourceMappingURL=closure.spec.js.map

package/dist/src/lease/closure.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"closure.spec.js","sourceRoot":"","sources":["../../../src/lease/closure.spec.ts"],"names":[],"mappings":"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"}

package/dist/src/lease/coordinator.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * Serializes a lease transition together with its repository side effects.
+ * A host shares one coordinator between its routes and dispatcher. A
+ * distributed host supplies the equivalent fencing at its storage boundary.
+ */
+export interface LeaseCoordinator {
+    /** Runs a transition exclusively for one repository and lease. */
+    run<T>(repo: string, leaseId: string, operation: () => Promise<T>): Promise<T>;
+}
+/**
+ * Serializes transitions in a single hub without blocking unrelated leases.
+ * Operations must not recursively acquire the same lease.
+ * @example
+ * const coordinator = new InMemoryLeaseCoordinator();
+ * await coordinator.run(repo, leaseId, () => completeAttempt());
+ */
+export declare class InMemoryLeaseCoordinator implements LeaseCoordinator {
+    private readonly tails;
+    /**
+     * Runs after prior transitions, even if a prior transition rejected.
+     * @param repo - Repository alias
+     * @param leaseId - Lease identity
+     * @param operation - Transition and its side effects
+     * @returns The operation's result
+     */
+    run<T>(repo: string, leaseId: string, operation: () => Promise<T>): Promise<T>;
+}
+/** Runs unfenced operations for hosts whose backend supplies fencing. */
+export declare const backendLeaseCoordinator: LeaseCoordinator;
+//# sourceMappingURL=coordinator.d.ts.map

package/dist/src/lease/coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinator.d.ts","sourceRoot":"","sources":["../../../src/lease/coordinator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kEAAkE;IAClE,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAChF;AAED;;;;;;GAMG;AACH,qBAAa,wBAAyB,YAAW,gBAAgB;IAC/D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoC;IAE1D;;;;;;OAMG;IACG,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAcrF;AAED,yEAAyE;AACzE,eAAO,MAAM,uBAAuB,EAAE,gBAErC,CAAC"}

package/dist/src/lease/coordinator.js

@@ -0,0 +1,42 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * Serializes transitions in a single hub without blocking unrelated leases.
+ * Operations must not recursively acquire the same lease.
+ * @example
+ * const coordinator = new InMemoryLeaseCoordinator();
+ * await coordinator.run(repo, leaseId, () => completeAttempt());
+ */
+export class InMemoryLeaseCoordinator {
+    tails = new Map();
+    /**
+     * Runs after prior transitions, even if a prior transition rejected.
+     * @param repo - Repository alias
+     * @param leaseId - Lease identity
+     * @param operation - Transition and its side effects
+     * @returns The operation's result
+     */
+    async run(repo, leaseId, operation) {
+        const key = JSON.stringify([repo, leaseId]);
+        const before = this.tails.get(key) ?? Promise.resolve();
+        let release;
+        const after = new Promise((resolve) => { release = resolve; });
+        this.tails.set(key, after);
+        await before;
+        try {
+            return await operation();
+        }
+        finally {
+            release();
+            if (this.tails.get(key) === after)
+                this.tails.delete(key);
+        }
+    }
+}
+/** Runs unfenced operations for hosts whose backend supplies fencing. */
+export const backendLeaseCoordinator = {
+    run: (_repo, _leaseId, operation) => operation(),
+};
+//# sourceMappingURL=coordinator.js.map

package/dist/src/lease/coordinator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinator.js","sourceRoot":"","sources":["../../../src/lease/coordinator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAYH;;;;;;GAMG;AACH,MAAM,OAAO,wBAAwB;IAClB,KAAK,GAAG,IAAI,GAAG,EAAyB,CAAC;IAE1D;;;;;;OAMG;IACH,KAAK,CAAC,GAAG,CAAI,IAAY,EAAE,OAAe,EAAE,SAA2B;QACrE,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACxD,IAAI,OAAoB,CAAC;QACzB,MAAM,KAAK,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,GAAG,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QACrE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC3B,MAAM,MAAM,CAAC;QACb,IAAI,CAAC;YACH,OAAO,MAAM,SAAS,EAAE,CAAC;QAC3B,CAAC;gBAAS,CAAC;YACT,OAAO,EAAE,CAAC;YACV,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,KAAK;gBAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;CACF;AAED,yEAAyE;AACzE,MAAM,CAAC,MAAM,uBAAuB,GAAqB;IACvD,GAAG,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,CAAC,SAAS,EAAE;CACjD,CAAC"}

package/dist/src/lease/in-memory-lease-store.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import type { RackLeaseAttempt, RackLeaseResult } from '../protocol/task-envelope.js';
+import { type CompleteDisposition, type RackLeaseRecord, type RackLeaseStore } from './lease-store.js';
+/**
+ * Keeps leases in memory with the cloud store's conditional transitions.
+ * Each mutation completes synchronously before resolving its promise, so
+ * concurrent claims have one winner. Returned records are independent copies.
+ * @example
+ * const leases = new InMemoryRackLeaseStore();
+ * await leases.put(pending);
+ */
+export declare class InMemoryRackLeaseStore implements RackLeaseStore {
+    private readonly now;
+    private readonly records;
+    /** @param now - The clock for visibility and activity timestamps */
+    constructor(now?: () => number);
+    private key;
+    /** Forgets a terminal lease after its subscribers and retry window have ended. */
+    forget(repo: string, id: string): void;
+    put(record: RackLeaseRecord): Promise<void>;
+    get(repo: string, id: string): Promise<RackLeaseRecord | null>;
+    /**
+     * Reads a lease without copying it: for a count or a status check, never
+     * for a change, and not kept past the next transition. A copy per read is
+     * what {@link get} is for.
+     * @param repo - The lease's repository
+     * @param id - The lease
+     * @returns The store's own record, or null
+     * @example
+     * if (leases.peek(repo, id)?.status === 'claimed') busy++;
+     */
+    peek(repo: string, id: string): Readonly<RackLeaseRecord> | null;
+    /**
+     * The leases an agent with these tiers could claim now, oldest first,
+     * without copying them: the same caution as {@link peek}.
+     * @param tiers - The tiers the agent runs
+     * @param now - The time, in ms since the epoch
+     * @returns The store's own records
+     * @example
+     * const queued = leases.peekClaimable(['node'], Date.now()).length;
+     */
+    peekClaimable(tiers: readonly string[], now: number): ReadonlyArray<Readonly<RackLeaseRecord>>;
+    findByTask(repo: string, taskHash: string, inputsHash: string): Promise<RackLeaseRecord | null>;
+    listClaimable(tiers: string[], now: number, limit: number): Promise<RackLeaseRecord[]>;
+    claim(repo: string, id: string, rackId: string, deadline: number, attempt?: RackLeaseAttempt): Promise<RackLeaseRecord | null>;
+    recordTargets(repo: string, id: string, rackId: string, hashes: readonly string[]): Promise<boolean>;
+    extend(repo: string, id: string, rackId: string, deadline: number): Promise<boolean>;
+    complete(repo: string, id: string, rackId: string, result: RackLeaseResult): Promise<CompleteDisposition>;
+    listRecentByRack(rackId: string, limit: number): Promise<RackLeaseRecord[]>;
+    supersede(repo: string, id: string): Promise<RackLeaseRecord | null>;
+    cancel(repo: string, id: string): Promise<RackLeaseRecord | null>;
+    private terminal;
+    private held;
+}
+//# sourceMappingURL=in-memory-lease-store.d.ts.map

package/dist/src/lease/in-memory-lease-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-lease-store.d.ts","sourceRoot":"","sources":["../../../src/lease/in-memory-lease-store.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACtF,OAAO,EAA8B,KAAK,mBAAmB,EAAE,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEnI;;;;;;;GAOG;AACH,qBAAa,sBAAuB,YAAW,cAAc;IAI/C,OAAO,CAAC,QAAQ,CAAC,GAAG;IAHhC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsC;IAE9D,oEAAoE;gBACvC,GAAG,GAAE,MAAM,MAAiB;IAEzD,OAAO,CAAC,GAAG;IAEX,kFAAkF;IAClF,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IAMtC,GAAG,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAK3C,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAI9D;;;;;;;;;OASG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,QAAQ,CAAC,eAAe,CAAC,GAAG,IAAI;IAIhE;;;;;;;;OAQG;IACH,aAAa,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,aAAa,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;IAK9F,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAQ/F,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAItF,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAW9H,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAOpG,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAOpF,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAUzG,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAK3E,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAIpE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAIjE,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,IAAI;CAIb"}

package/dist/src/lease/in-memory-lease-store.js

@@ -0,0 +1,132 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import { isClaimable, leaseIdPrefix } from './lease-store.js';
+/**
+ * Keeps leases in memory with the cloud store's conditional transitions.
+ * Each mutation completes synchronously before resolving its promise, so
+ * concurrent claims have one winner. Returned records are independent copies.
+ * @example
+ * const leases = new InMemoryRackLeaseStore();
+ * await leases.put(pending);
+ */
+export class InMemoryRackLeaseStore {
+    now;
+    records = new Map();
+    /** @param now - The clock for visibility and activity timestamps */
+    constructor(now = Date.now) {
+        this.now = now;
+    }
+    key(repo, id) { return JSON.stringify([repo, id]); }
+    /** Forgets a terminal lease after its subscribers and retry window have ended. */
+    forget(repo, id) {
+        const key = this.key(repo, id);
+        const record = this.records.get(key);
+        if (record !== undefined && record.status !== 'pending' && record.status !== 'claimed')
+            this.records.delete(key);
+    }
+    put(record) {
+        this.records.set(this.key(record.repo, record.leaseId), structuredClone(record));
+        return Promise.resolve();
+    }
+    get(repo, id) {
+        return Promise.resolve(structuredClone(this.records.get(this.key(repo, id)) ?? null));
+    }
+    /**
+     * Reads a lease without copying it: for a count or a status check, never
+     * for a change, and not kept past the next transition. A copy per read is
+     * what {@link get} is for.
+     * @param repo - The lease's repository
+     * @param id - The lease
+     * @returns The store's own record, or null
+     * @example
+     * if (leases.peek(repo, id)?.status === 'claimed') busy++;
+     */
+    peek(repo, id) {
+        return this.records.get(this.key(repo, id)) ?? null;
+    }
+    /**
+     * The leases an agent with these tiers could claim now, oldest first,
+     * without copying them: the same caution as {@link peek}.
+     * @param tiers - The tiers the agent runs
+     * @param now - The time, in ms since the epoch
+     * @returns The store's own records
+     * @example
+     * const queued = leases.peekClaimable(['node'], Date.now()).length;
+     */
+    peekClaimable(tiers, now) {
+        return [...this.records.values()].filter((r) => tiers.includes(r.tier) && isClaimable(r, now))
+            .sort((a, b) => a.createdAtMs - b.createdAtMs || a.leaseId.localeCompare(b.leaseId));
+    }
+    findByTask(repo, taskHash, inputsHash) {
+        const prefix = leaseIdPrefix(taskHash, inputsHash);
+        const records = [...this.records.values()].filter((r) => r.repo === repo && r.leaseId.startsWith(prefix)
+            && r.status !== 'superseded' && r.status !== 'cancelled');
+        records.sort((a, b) => b.createdAtMs - a.createdAtMs || b.leaseId.localeCompare(a.leaseId));
+        return Promise.resolve(structuredClone(records[0] ?? null));
+    }
+    listClaimable(tiers, now, limit) {
+        return Promise.resolve(this.peekClaimable(tiers, now).slice(0, limit).map((r) => structuredClone(r)));
+    }
+    claim(repo, id, rackId, deadline, attempt) {
+        const record = this.records.get(this.key(repo, id));
+        if (record === undefined || !isClaimable(record, this.now()))
+            return Promise.resolve(null);
+        record.status = 'claimed';
+        record.claimedBy = rackId;
+        record.claimedAtMs = this.now();
+        record.visibilityDeadlineMs = deadline;
+        if (attempt !== undefined)
+            record.attempt = structuredClone(attempt);
+        return Promise.resolve(structuredClone(record));
+    }
+    recordTargets(repo, id, rackId, hashes) {
+        const record = this.held(repo, id, rackId);
+        if (record === null)
+            return Promise.resolve(false);
+        record.targets = [...new Set([...(record.targets ?? []), ...hashes])];
+        return Promise.resolve(true);
+    }
+    extend(repo, id, rackId, deadline) {
+        const record = this.held(repo, id, rackId);
+        if (record === null)
+            return Promise.resolve(false);
+        record.visibilityDeadlineMs = deadline;
+        return Promise.resolve(true);
+    }
+    complete(repo, id, rackId, result) {
+        const record = this.records.get(this.key(repo, id));
+        if (record?.status === 'completed')
+            return Promise.resolve('idempotent');
+        if (record === undefined || record.status !== 'claimed' || record.claimedBy !== rackId)
+            return Promise.resolve('discarded');
+        record.status = 'completed';
+        record.result = structuredClone(result);
+        record.completedAtMs = this.now();
+        return Promise.resolve('recorded');
+    }
+    listRecentByRack(rackId, limit) {
+        return Promise.resolve([...this.records.values()].filter((r) => r.claimedBy === rackId && r.claimedAtMs !== undefined)
+            .sort((a, b) => b.claimedAtMs - a.claimedAtMs).slice(0, limit).map((r) => structuredClone(r)));
+    }
+    supersede(repo, id) {
+        return this.terminal(repo, id, 'superseded');
+    }
+    cancel(repo, id) {
+        return this.terminal(repo, id, 'cancelled');
+    }
+    terminal(repo, id, status) {
+        const record = this.records.get(this.key(repo, id));
+        if (record === undefined)
+            return Promise.resolve(null);
+        if (record.status === 'pending' || record.status === 'claimed')
+            record.status = status;
+        return Promise.resolve(structuredClone(record));
+    }
+    held(repo, id, rackId) {
+        const record = this.records.get(this.key(repo, id));
+        return record?.status === 'claimed' && record.claimedBy === rackId ? record : null;
+    }
+}
+//# sourceMappingURL=in-memory-lease-store.js.map

package/dist/src/lease/in-memory-lease-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-lease-store.js","sourceRoot":"","sources":["../../../src/lease/in-memory-lease-store.ts"],"names":[],"mappings":"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"}