@elaraai/e3-core 0.0.2-beta.12 → 0.0.2-beta.14

package/dist/src/storage/local/LocalBackend.js

@@ -0,0 +1,73 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { LocalObjectStore } from './LocalObjectStore.js';
+import { LocalRefStore } from './LocalRefStore.js';
+import { LocalLockService } from './LocalLockService.js';
+import { LocalLogStore } from './LocalLogStore.js';
+import { RepositoryNotFoundError } from '../../errors.js';
+/**
+ * Local filesystem implementation of StorageBackend.
+ *
+ * This combines the local implementations of all storage interfaces,
+ * providing a complete backend for local e3 repositories.
+ *
+ * The `repo` parameter passed to each method is the path to the e3 repository directory.
+ * This allows a single LocalStorage instance to be used for multiple repositories.
+ *
+ * @example
+ * ```typescript
+ * import { LocalStorage } from '@elaraai/e3-core';
+ *
+ * const storage = new LocalStorage();
+ * const repo = '/path/to/repo';
+ *
+ * // Use the backend with storage-agnostic functions
+ * const hash = await storage.objects.write(repo, data);
+ * const packages = await storage.refs.packageList(repo);
+ * ```
+ */
+export class LocalStorage {
+    /** Content-addressed object storage */
+    objects;
+    /** Mutable reference storage */
+    refs;
+    /** Distributed locking service */
+    locks;
+    /** Execution log storage */
+    logs;
+    /**
+     * Create a new LocalStorage instance.
+     *
+     * No configuration needed - the `repo` parameter (path to e3 repository directory)
+     * is passed to each method call instead.
+     */
+    constructor() {
+        this.objects = new LocalObjectStore();
+        this.refs = new LocalRefStore();
+        this.locks = new LocalLockService();
+        this.logs = new LocalLogStore();
+    }
+    /**
+     * Validate that a repository exists and is properly structured.
+     * @param repo - Path to the e3 repository directory
+     * @throws {RepositoryNotFoundError} If repository doesn't exist or is invalid
+     */
+    async validateRepository(repo) {
+        const requiredDirs = ['objects', 'packages', 'workspaces', 'executions'];
+        for (const dir of requiredDirs) {
+            try {
+                await fs.access(path.join(repo, dir));
+            }
+            catch {
+                throw new RepositoryNotFoundError(repo);
+            }
+        }
+    }
+}
+// Re-export as LocalBackend for backwards compatibility during migration
+export { LocalStorage as LocalBackend };
+//# sourceMappingURL=LocalBackend.js.map

package/dist/src/storage/local/LocalBackend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalBackend.js","sourceRoot":"","sources":["../../../../src/storage/local/LocalBackend.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,OAAO,YAAY;IACvB,uCAAuC;IACvB,OAAO,CAAc;IAErC,gCAAgC;IAChB,IAAI,CAAW;IAE/B,kCAAkC;IAClB,KAAK,CAAc;IAEnC,4BAA4B;IACZ,IAAI,CAAW;IAE/B;;;;;OAKG;IACH;QACE,IAAI,CAAC,OAAO,GAAG,IAAI,gBAAgB,EAAE,CAAC;QACtC,IAAI,CAAC,IAAI,GAAG,IAAI,aAAa,EAAE,CAAC;QAChC,IAAI,CAAC,KAAK,GAAG,IAAI,gBAAgB,EAAE,CAAC;QACpC,IAAI,CAAC,IAAI,GAAG,IAAI,aAAa,EAAE,CAAC;IAClC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,kBAAkB,CAAC,IAAY;QACnC,MAAM,YAAY,GAAG,CAAC,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC;QACzE,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;YAC/B,IAAI,CAAC;gBACH,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;YACxC,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,IAAI,uBAAuB,CAAC,IAAI,CAAC,CAAC;YAC1C,CAAC;QACH,CAAC;IACH,CAAC;CACF;AAED,yEAAyE;AACzE,OAAO,EAAE,YAAY,IAAI,YAAY,EAAE,CAAC"}

package/dist/src/storage/local/LocalLockService.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import type { LockState, LockOperation } from '@elaraai/e3-types';
+import type { LockHandle, LockService } from '../interfaces.js';
+/**
+ * Local filesystem implementation of LockService.
+ *
+ * Uses flock() for kernel-managed locking with lock state
+ * stored in beast2 format using LockStateType.
+ * The `repo` parameter is the path to the e3 repository directory.
+ */
+export declare class LocalLockService implements LockService {
+    acquire(repo: string, resource: string, operation: LockOperation, options?: {
+        wait?: boolean;
+        timeout?: number;
+    }): Promise<LockHandle | null>;
+    getState(repo: string, resource: string): Promise<LockState | null>;
+    isHolderAlive(holder: string): Promise<boolean>;
+}
+//# sourceMappingURL=LocalLockService.d.ts.map

package/dist/src/storage/local/LocalLockService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalLockService.d.ts","sourceRoot":"","sources":["../../../../src/storage/local/LocalLockService.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAQhE;;;;;;GAMG;AACH,qBAAa,gBAAiB,YAAW,WAAW;IAC5C,OAAO,CACX,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,aAAa,EACxB,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAC7C,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAkB7B,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAInE,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAGhD"}

package/dist/src/storage/local/LocalLockService.js

@@ -0,0 +1,38 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import { acquireWorkspaceLock, getWorkspaceLockState, isLockHolderAlive, } from '../../workspaceLock.js';
+/**
+ * Local filesystem implementation of LockService.
+ *
+ * Uses flock() for kernel-managed locking with lock state
+ * stored in beast2 format using LockStateType.
+ * The `repo` parameter is the path to the e3 repository directory.
+ */
+export class LocalLockService {
+    async acquire(repo, resource, operation, options) {
+        const acquireOptions = {
+            wait: options?.wait ?? false,
+            timeout: options?.timeout,
+        };
+        try {
+            const handle = await acquireWorkspaceLock(repo, resource, operation, acquireOptions);
+            return {
+                resource,
+                release: () => handle.release(),
+            };
+        }
+        catch {
+            // Lock couldn't be acquired
+            return null;
+        }
+    }
+    getState(repo, resource) {
+        return getWorkspaceLockState(repo, resource);
+    }
+    isHolderAlive(holder) {
+        return isLockHolderAlive(holder);
+    }
+}
+//# sourceMappingURL=LocalLockService.js.map

package/dist/src/storage/local/LocalLockService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalLockService.js","sourceRoot":"","sources":["../../../../src/storage/local/LocalLockService.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,GAElB,MAAM,wBAAwB,CAAC;AAEhC;;;;;;GAMG;AACH,MAAM,OAAO,gBAAgB;IAC3B,KAAK,CAAC,OAAO,CACX,IAAY,EACZ,QAAgB,EAChB,SAAwB,EACxB,OAA8C;QAE9C,MAAM,cAAc,GAAuB;YACzC,IAAI,EAAE,OAAO,EAAE,IAAI,IAAI,KAAK;YAC5B,OAAO,EAAE,OAAO,EAAE,OAAO;SAC1B,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC;YACrF,OAAO;gBACL,QAAQ;gBACR,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE;aAChC,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,4BAA4B;YAC5B,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,QAAQ,CAAC,IAAY,EAAE,QAAgB;QACrC,OAAO,qBAAqB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAED,aAAa,CAAC,MAAc;QAC1B,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;CACF"}

package/dist/src/storage/local/LocalLogStore.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import type { LogChunk, LogStore } from '../interfaces.js';
+/**
+ * Local filesystem implementation of LogStore.
+ *
+ * Logs are stored as text files in the execution directory:
+ *   executions/<taskHash>/<inputsHash>/stdout.txt
+ *   executions/<taskHash>/<inputsHash>/stderr.txt
+ *
+ * The `repo` parameter is the path to the e3 repository directory.
+ */
+export declare class LocalLogStore implements LogStore {
+    private logPath;
+    append(repo: string, taskHash: string, inputsHash: string, stream: 'stdout' | 'stderr', data: string): Promise<void>;
+    read(repo: string, taskHash: string, inputsHash: string, stream: 'stdout' | 'stderr', options?: {
+        offset?: number;
+        limit?: number;
+    }): Promise<LogChunk>;
+}
+//# sourceMappingURL=LocalLogStore.d.ts.map

package/dist/src/storage/local/LocalLogStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalLogStore.d.ts","sourceRoot":"","sources":["../../../../src/storage/local/LocalLogStore.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAG3D;;;;;;;;GAQG;AACH,qBAAa,aAAc,YAAW,QAAQ;IAC5C,OAAO,CAAC,OAAO;IAUT,MAAM,CACV,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,QAAQ,GAAG,QAAQ,EAC3B,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC;IAQV,IAAI,CACR,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,QAAQ,GAAG,QAAQ,EAC3B,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAC5C,OAAO,CAAC,QAAQ,CAAC;CAwCrB"}

package/dist/src/storage/local/LocalLogStore.js

@@ -0,0 +1,66 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { isNotFoundError } from '../../errors.js';
+/**
+ * Local filesystem implementation of LogStore.
+ *
+ * Logs are stored as text files in the execution directory:
+ *   executions/<taskHash>/<inputsHash>/stdout.txt
+ *   executions/<taskHash>/<inputsHash>/stderr.txt
+ *
+ * The `repo` parameter is the path to the e3 repository directory.
+ */
+export class LocalLogStore {
+    logPath(repo, taskHash, inputsHash, stream) {
+        return path.join(repo, 'executions', taskHash, inputsHash, `${stream}.txt`);
+    }
+    async append(repo, taskHash, inputsHash, stream, data) {
+        const logFile = this.logPath(repo, taskHash, inputsHash, stream);
+        const dir = path.dirname(logFile);
+        await fs.mkdir(dir, { recursive: true });
+        await fs.appendFile(logFile, data);
+    }
+    async read(repo, taskHash, inputsHash, stream, options) {
+        const logFile = this.logPath(repo, taskHash, inputsHash, stream);
+        const offset = options?.offset ?? 0;
+        const limit = options?.limit ?? 65536; // 64KB default
+        try {
+            const stat = await fs.stat(logFile);
+            const totalSize = stat.size;
+            // Open file and read chunk
+            const fd = await fs.open(logFile, 'r');
+            try {
+                const buffer = Buffer.alloc(Math.min(limit, Math.max(0, totalSize - offset)));
+                const { bytesRead } = await fd.read(buffer, 0, buffer.length, offset);
+                return {
+                    data: buffer.slice(0, bytesRead).toString('utf-8'),
+                    offset,
+                    size: bytesRead,
+                    totalSize,
+                    complete: offset + bytesRead >= totalSize,
+                };
+            }
+            finally {
+                await fd.close();
+            }
+        }
+        catch (err) {
+            if (isNotFoundError(err)) {
+                // Log file doesn't exist yet
+                return {
+                    data: '',
+                    offset: 0,
+                    size: 0,
+                    totalSize: 0,
+                    complete: true,
+                };
+            }
+            throw err;
+        }
+    }
+}
+//# sourceMappingURL=LocalLogStore.js.map

package/dist/src/storage/local/LocalLogStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalLogStore.js","sourceRoot":"","sources":["../../../../src/storage/local/LocalLogStore.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD;;;;;;;;GAQG;AACH,MAAM,OAAO,aAAa;IAChB,OAAO,CAAC,IAAY,EAAE,QAAgB,EAAE,UAAkB,EAAE,MAA2B;QAC7F,OAAO,IAAI,CAAC,IAAI,CACd,IAAI,EACJ,YAAY,EACZ,QAAQ,EACR,UAAU,EACV,GAAG,MAAM,MAAM,CAChB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,MAAM,CACV,IAAY,EACZ,QAAgB,EAChB,UAAkB,EAClB,MAA2B,EAC3B,IAAY;QAEZ,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;QACjE,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAElC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,MAAM,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,IAAI,CACR,IAAY,EACZ,QAAgB,EAChB,UAAkB,EAClB,MAA2B,EAC3B,OAA6C;QAE7C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;QAEjE,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,CAAC,CAAC;QACpC,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,KAAK,CAAC,CAAC,eAAe;QAEtD,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACpC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC;YAE5B,2BAA2B;YAC3B,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YACvC,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;gBAC9E,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBAEtE,OAAO;oBACL,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;oBAClD,MAAM;oBACN,IAAI,EAAE,SAAS;oBACf,SAAS;oBACT,QAAQ,EAAE,MAAM,GAAG,SAAS,IAAI,SAAS;iBAC1C,CAAC;YACJ,CAAC;oBAAS,CAAC;gBACT,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC;YACnB,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;gBACzB,6BAA6B;gBAC7B,OAAO;oBACL,IAAI,EAAE,EAAE;oBACR,MAAM,EAAE,CAAC;oBACT,IAAI,EAAE,CAAC;oBACP,SAAS,EAAE,CAAC;oBACZ,QAAQ,EAAE,IAAI;iBACf,CAAC;YACJ,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;CACF"}

package/dist/src/storage/local/LocalObjectStore.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import type { ObjectStore } from '../interfaces.js';
+/**
+ * Local filesystem implementation of ObjectStore.
+ *
+ * Wraps the existing objects.ts functions.
+ * The `repo` parameter is the path to the e3 repository directory.
+ */
+export declare class LocalObjectStore implements ObjectStore {
+    write(repo: string, data: Uint8Array): Promise<string>;
+    writeStream(repo: string, stream: AsyncIterable<Uint8Array>): Promise<string>;
+    read(repo: string, hash: string): Promise<Uint8Array>;
+    exists(repo: string, hash: string): Promise<boolean>;
+    list(repo: string): Promise<string[]>;
+}
+//# sourceMappingURL=LocalObjectStore.d.ts.map

package/dist/src/storage/local/LocalObjectStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalObjectStore.d.ts","sourceRoot":"","sources":["../../../../src/storage/local/LocalObjectStore.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AASpD;;;;;GAKG;AACH,qBAAa,gBAAiB,YAAW,WAAW;IAC5C,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAItD,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAa7E,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAIrD,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIpD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAgC5C"}

package/dist/src/storage/local/LocalObjectStore.js

@@ -0,0 +1,68 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { objectWrite, objectWriteStream, objectRead, objectExists, } from '../../objects.js';
+import { isNotFoundError } from '../../errors.js';
+/**
+ * Local filesystem implementation of ObjectStore.
+ *
+ * Wraps the existing objects.ts functions.
+ * The `repo` parameter is the path to the e3 repository directory.
+ */
+export class LocalObjectStore {
+    async write(repo, data) {
+        return objectWrite(repo, data);
+    }
+    async writeStream(repo, stream) {
+        // Convert AsyncIterable to ReadableStream for objectWriteStream
+        const readableStream = new ReadableStream({
+            async start(controller) {
+                for await (const chunk of stream) {
+                    controller.enqueue(chunk);
+                }
+                controller.close();
+            },
+        });
+        return objectWriteStream(repo, readableStream);
+    }
+    async read(repo, hash) {
+        return objectRead(repo, hash);
+    }
+    async exists(repo, hash) {
+        return objectExists(repo, hash);
+    }
+    async list(repo) {
+        const objectsDir = path.join(repo, 'objects');
+        const hashes = [];
+        try {
+            const prefixDirs = await fs.readdir(objectsDir);
+            for (const prefix of prefixDirs) {
+                if (!/^[a-f0-9]{2}$/.test(prefix))
+                    continue;
+                const prefixPath = path.join(objectsDir, prefix);
+                const stat = await fs.stat(prefixPath);
+                if (!stat.isDirectory())
+                    continue;
+                const files = await fs.readdir(prefixPath);
+                for (const file of files) {
+                    if (file.endsWith('.beast2') && !file.includes('.partial')) {
+                        // Reconstruct full hash: prefix + filename without extension
+                        const hash = prefix + file.slice(0, -7);
+                        hashes.push(hash);
+                    }
+                }
+            }
+        }
+        catch (err) {
+            // Only suppress ENOENT - directory may not exist yet
+            if (!isNotFoundError(err)) {
+                throw err;
+            }
+        }
+        return hashes;
+    }
+}
+//# sourceMappingURL=LocalObjectStore.js.map

package/dist/src/storage/local/LocalObjectStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalObjectStore.js","sourceRoot":"","sources":["../../../../src/storage/local/LocalObjectStore.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,UAAU,EACV,YAAY,GACb,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD;;;;;GAKG;AACH,MAAM,OAAO,gBAAgB;IAC3B,KAAK,CAAC,KAAK,CAAC,IAAY,EAAE,IAAgB;QACxC,OAAO,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,IAAY,EAAE,MAAiC;QAC/D,gEAAgE;QAChE,MAAM,cAAc,GAAG,IAAI,cAAc,CAAa;YACpD,KAAK,CAAC,KAAK,CAAC,UAAU;gBACpB,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;oBACjC,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;gBAC5B,CAAC;gBACD,UAAU,CAAC,KAAK,EAAE,CAAC;YACrB,CAAC;SACF,CAAC,CAAC;QACH,OAAO,iBAAiB,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,IAAY,EAAE,IAAY;QACnC,OAAO,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAY,EAAE,IAAY;QACrC,OAAO,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,IAAY;QACrB,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YAEhD,KAAK,MAAM,MAAM,IAAI,UAAU,EAAE,CAAC;gBAChC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC;oBAAE,SAAS;gBAE5C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;gBACjD,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBACvC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE;oBAAE,SAAS;gBAElC,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;gBAC3C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBACzB,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;wBAC3D,6DAA6D;wBAC7D,MAAM,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;wBACxC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBACpB,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,qDAAqD;YACrD,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC1B,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/src/storage/local/LocalRefStore.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import type { ExecutionStatus } from '@elaraai/e3-types';
+import type { RefStore } from '../interfaces.js';
+/**
+ * Local filesystem implementation of RefStore.
+ *
+ * The `repo` parameter is the path to the e3 repository directory.
+ */
+export declare class LocalRefStore implements RefStore {
+    packageList(repo: string): Promise<{
+        name: string;
+        version: string;
+    }[]>;
+    packageResolve(repo: string, name: string, version: string): Promise<string | null>;
+    packageWrite(repo: string, name: string, version: string, hash: string): Promise<void>;
+    packageRemove(repo: string, name: string, version: string): Promise<void>;
+    workspaceList(repo: string): Promise<string[]>;
+    workspaceRead(repo: string, name: string): Promise<Uint8Array | null>;
+    workspaceWrite(repo: string, name: string, state: Uint8Array): Promise<void>;
+    workspaceRemove(repo: string, name: string): Promise<void>;
+    private executionDir;
+    executionGet(repo: string, taskHash: string, inputsHash: string): Promise<ExecutionStatus | null>;
+    executionWrite(repo: string, taskHash: string, inputsHash: string, status: ExecutionStatus): Promise<void>;
+    executionGetOutput(repo: string, taskHash: string, inputsHash: string): Promise<string | null>;
+    executionWriteOutput(repo: string, taskHash: string, inputsHash: string, outputHash: string): Promise<void>;
+    executionList(repo: string): Promise<{
+        taskHash: string;
+        inputsHash: string;
+    }[]>;
+    executionListForTask(repo: string, taskHash: string): Promise<string[]>;
+}
+//# sourceMappingURL=LocalRefStore.d.ts.map

package/dist/src/storage/local/LocalRefStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalRefStore.d.ts","sourceRoot":"","sources":["../../../../src/storage/local/LocalRefStore.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAGjD;;;;GAIG;AACH,qBAAa,aAAc,YAAW,QAAQ;IAKtC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IA0BvE,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAanF,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOtF,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBzE,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAqB9C,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAarE,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAa5E,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBhE,OAAO,CAAC,YAAY;IAId,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IA0BjG,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ1G,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAe9F,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM3G,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IA+BhF,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAc9E"}

package/dist/src/storage/local/LocalRefStore.js

@@ -0,0 +1,233 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { decodeBeast2For, encodeBeast2For } from '@elaraai/east';
+import { ExecutionStatusType } from '@elaraai/e3-types';
+import { isNotFoundError, ExecutionCorruptError } from '../../errors.js';
+/**
+ * Local filesystem implementation of RefStore.
+ *
+ * The `repo` parameter is the path to the e3 repository directory.
+ */
+export class LocalRefStore {
+    // -------------------------------------------------------------------------
+    // Package References
+    // -------------------------------------------------------------------------
+    async packageList(repo) {
+        const packagesDir = path.join(repo, 'packages');
+        const packages = [];
+        try {
+            const names = await fs.readdir(packagesDir);
+            for (const name of names) {
+                const nameDir = path.join(packagesDir, name);
+                const stat = await fs.stat(nameDir);
+                if (stat.isDirectory()) {
+                    const versions = await fs.readdir(nameDir);
+                    for (const version of versions) {
+                        packages.push({ name, version });
+                    }
+                }
+            }
+        }
+        catch (err) {
+            // Only suppress ENOENT - directory may not exist yet
+            if (!isNotFoundError(err)) {
+                throw err;
+            }
+        }
+        return packages;
+    }
+    async packageResolve(repo, name, version) {
+        const refPath = path.join(repo, 'packages', name, version);
+        try {
+            const content = await fs.readFile(refPath, 'utf-8');
+            return content.trim();
+        }
+        catch (err) {
+            if (isNotFoundError(err)) {
+                return null;
+            }
+            throw err;
+        }
+    }
+    async packageWrite(repo, name, version, hash) {
+        const refDir = path.join(repo, 'packages', name);
+        await fs.mkdir(refDir, { recursive: true });
+        const refPath = path.join(refDir, version);
+        await fs.writeFile(refPath, hash + '\n');
+    }
+    async packageRemove(repo, name, version) {
+        const refPath = path.join(repo, 'packages', name, version);
+        try {
+            await fs.unlink(refPath);
+        }
+        catch (err) {
+            if (isNotFoundError(err)) {
+                return; // Already removed, idempotent
+            }
+            throw err;
+        }
+        // Try to remove the package name directory if empty
+        const packageDir = path.join(repo, 'packages', name);
+        try {
+            await fs.rmdir(packageDir);
+        }
+        catch {
+            // Directory not empty, that's fine
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Workspace State
+    // -------------------------------------------------------------------------
+    async workspaceList(repo) {
+        const workspacesDir = path.join(repo, 'workspaces');
+        const names = [];
+        try {
+            const entries = await fs.readdir(workspacesDir);
+            for (const entry of entries) {
+                if (entry.endsWith('.beast2')) {
+                    names.push(entry.slice(0, -7)); // Remove .beast2 extension
+                }
+            }
+        }
+        catch (err) {
+            // Only suppress ENOENT - directory may not exist yet
+            if (!isNotFoundError(err)) {
+                throw err;
+            }
+        }
+        return names;
+    }
+    async workspaceRead(repo, name) {
+        const stateFile = path.join(repo, 'workspaces', `${name}.beast2`);
+        try {
+            return await fs.readFile(stateFile);
+        }
+        catch (err) {
+            if (isNotFoundError(err)) {
+                return null;
+            }
+            throw err;
+        }
+    }
+    async workspaceWrite(repo, name, state) {
+        const wsDir = path.join(repo, 'workspaces');
+        const stateFile = path.join(wsDir, `${name}.beast2`);
+        await fs.mkdir(wsDir, { recursive: true });
+        // Write atomically: write to temp file, then rename
+        const randomSuffix = Math.random().toString(36).slice(2, 10);
+        const tempPath = path.join(wsDir, `.${name}.${Date.now()}.${randomSuffix}.tmp`);
+        await fs.writeFile(tempPath, state);
+        await fs.rename(tempPath, stateFile);
+    }
+    async workspaceRemove(repo, name) {
+        const stateFile = path.join(repo, 'workspaces', `${name}.beast2`);
+        try {
+            await fs.unlink(stateFile);
+        }
+        catch (err) {
+            if (isNotFoundError(err)) {
+                return; // Already removed, idempotent
+            }
+            throw err;
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Execution Cache
+    // -------------------------------------------------------------------------
+    executionDir(repo, taskHash, inputsHash) {
+        return path.join(repo, 'executions', taskHash, inputsHash);
+    }
+    async executionGet(repo, taskHash, inputsHash) {
+        const execDir = this.executionDir(repo, taskHash, inputsHash);
+        const statusPath = path.join(execDir, 'status.beast2');
+        let data;
+        try {
+            data = await fs.readFile(statusPath);
+        }
+        catch (err) {
+            if (isNotFoundError(err)) {
+                return null;
+            }
+            throw err;
+        }
+        try {
+            const decoder = decodeBeast2For(ExecutionStatusType);
+            return decoder(data);
+        }
+        catch (err) {
+            throw new ExecutionCorruptError(taskHash, inputsHash, err instanceof Error ? err : new Error(String(err)));
+        }
+    }
+    async executionWrite(repo, taskHash, inputsHash, status) {
+        const execDir = this.executionDir(repo, taskHash, inputsHash);
+        await fs.mkdir(execDir, { recursive: true });
+        const encoder = encodeBeast2For(ExecutionStatusType);
+        await fs.writeFile(path.join(execDir, 'status.beast2'), encoder(status));
+    }
+    async executionGetOutput(repo, taskHash, inputsHash) {
+        const execDir = this.executionDir(repo, taskHash, inputsHash);
+        const outputPath = path.join(execDir, 'output');
+        try {
+            const content = await fs.readFile(outputPath, 'utf-8');
+            return content.trim();
+        }
+        catch (err) {
+            if (isNotFoundError(err)) {
+                return null;
+            }
+            throw err;
+        }
+    }
+    async executionWriteOutput(repo, taskHash, inputsHash, outputHash) {
+        const execDir = this.executionDir(repo, taskHash, inputsHash);
+        await fs.mkdir(execDir, { recursive: true });
+        await fs.writeFile(path.join(execDir, 'output'), outputHash + '\n');
+    }
+    async executionList(repo) {
+        const executionsDir = path.join(repo, 'executions');
+        const result = [];
+        try {
+            const taskDirs = await fs.readdir(executionsDir);
+            for (const taskHash of taskDirs) {
+                if (!/^[a-f0-9]{64}$/.test(taskHash))
+                    continue;
+                const taskDir = path.join(executionsDir, taskHash);
+                const stat = await fs.stat(taskDir);
+                if (!stat.isDirectory())
+                    continue;
+                const inputsDirs = await fs.readdir(taskDir);
+                for (const inputsHash of inputsDirs) {
+                    if (/^[a-f0-9]{64}$/.test(inputsHash)) {
+                        result.push({ taskHash, inputsHash });
+                    }
+                }
+            }
+        }
+        catch (err) {
+            // Only suppress ENOENT - directory may not exist yet
+            if (!isNotFoundError(err)) {
+                throw err;
+            }
+        }
+        return result;
+    }
+    async executionListForTask(repo, taskHash) {
+        const taskDir = path.join(repo, 'executions', taskHash);
+        try {
+            const entries = await fs.readdir(taskDir);
+            return entries.filter((e) => /^[a-f0-9]{64}$/.test(e));
+        }
+        catch (err) {
+            // Only suppress ENOENT - task may not have any executions yet
+            if (!isNotFoundError(err)) {
+                throw err;
+            }
+            return [];
+        }
+    }
+}
+//# sourceMappingURL=LocalRefStore.js.map

package/dist/src/storage/local/LocalRefStore.js.map

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

package/dist/src/storage/local/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * Local filesystem implementation of StorageBackend.
+ *
+ * This wraps the existing e3-core filesystem functions to provide a
+ * StorageBackend that works with local repositories.
+ */
+export { LocalStorage, LocalBackend } from './LocalBackend.js';
+export { LocalObjectStore } from './LocalObjectStore.js';
+export { LocalRefStore } from './LocalRefStore.js';
+export { LocalLockService } from './LocalLockService.js';
+export { LocalLogStore } from './LocalLogStore.js';
+//# sourceMappingURL=index.d.ts.map