@elaraai/e3-api-server 1.0.79 → 1.0.80

package/dist/src/handlers/repository.d.ts

@@ -2,23 +2,72 @@
  * Copyright (c) 2025 Elara AI Pty Ltd
  * Licensed under BSL 1.1. See LICENSE for details.
  */
-import type { StorageBackend } from '@elaraai/e3-core';
+import { type GcRequest } from '@elaraai/e3-types';
+import type { RepoGcStore, StorageBackend } from '@elaraai/e3-core';
+/**
+ * The repositories a host keeps, by name.
+ *
+ * @param storage - Storage backend, whose `RepoStore` keeps the repositories
+ * @returns The response: the names, or the error
+ */
+export declare function listRepositories(storage: StorageBackend): Promise<Response>;
+/**
+ * Creates a repository, with its record naming this release and every
+ * upgrade this e3 knows, since a new repository is in their forms.
+ *
+ * @param storage - Storage backend, whose `RepoStore` keeps the repositories
+ * @param repo - The new repository's name
+ * @returns The response: 201 with its name; or the error, as for one that
+ *   exists, or whose removal is still being cleaned up
+ */
+export declare function createRepository(storage: StorageBackend, repo: string): Promise<Response>;
+/**
+ * Removes a repository, resumably: it is marked `deleting` first, so the
+ * repository gate treats it as gone from then on, and a removal asked again
+ * answers at once; then its refs and its objects are deleted a batch at a
+ * time, and last the repository itself.
+ *
+ * @param storage - Storage backend, whose `RepoStore` keeps the repositories
+ * @param repo - The repository's name
+ * @returns The response: null once it is removed, or the error
+ */
+export declare function removeRepository(storage: StorageBackend, repo: string): Promise<Response>;
 /**
  * Get repository status.
  */
 export declare function getStatus(storage: StorageBackend, repoPath: string): Promise<Response>;
 /**
- * Start garbage collection (async).
+ * The repository's record: the release of e3 that last wrote it, and the store
+ * upgrades it has had.
  *
- * Returns immediately with an executionId. GC runs in background.
- * Poll getGcStatus() for progress.
+ * @param storage - Storage backend
+ * @param repoPath - Repository identifier
+ * @returns The response: the record, or the error
  */
-export declare function startGc(storage: StorageBackend, repoPath: string, options: {
-    dryRun: boolean;
-    minAge?: number;
-}): Response;
+export declare function getRecord(storage: StorageBackend, repoPath: string): Promise<Response>;
 /**
- * Get garbage collection status.
+ * Start garbage collection, as a job the client polls.
+ *
+ * @remarks
+ * gc takes as long as the repository is large, which outlasts a request. So it
+ * runs as a job, in the compute the store dispatches it to: a local server's
+ * own process, or a cloud's. A poll reads the job's status from the store,
+ * whichever instance answers it.
+ *
+ * @param repo - The repository's name, which the job is filed under
+ * @param request - What gc keeps, and whether it deletes
+ * @param gcStore - Where the job is filed, and dispatched from
+ * @returns The response: 202 with the job's id, or the error
+ */
+export declare function startGc(repo: string, request: GcRequest, gcStore: RepoGcStore): Promise<Response>;
+/**
+ * A gc job's status: still running, what gc did, or why it failed.
+ *
+ * @param gcStore - Where the job is filed
+ * @param repo - The repository's name
+ * @param executionId - The job's id
+ * @returns The response: the status, or the error when this repository started
+ *   no such job
  */
-export declare function getGcStatus(executionId: string): Response;
+export declare function getGcStatus(gcStore: RepoGcStore, repo: string, executionId: string): Promise<Response>;
 //# sourceMappingURL=repository.d.ts.map

package/dist/src/handlers/repository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../../../src/handlers/repository.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAgBvD;;GAEG;AACH,wBAAsB,SAAS,CAC7B,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,QAAQ,CAAC,CAmBnB;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CACrB,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5C,QAAQ,CAuBV;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,CAezD"}
+{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../../../src/handlers/repository.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAwB,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEzE,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AASpE;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC,CAMjF;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAkB/F;AAED;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAmC/F;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC7B,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,QAAQ,CAAC,CAmBnB;AAED;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAC7B,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,QAAQ,CAAC,CAMnB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,OAAO,CAC3B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,SAAS,EAClB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,QAAQ,CAAC,CAcnB;AAED;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,WAAW,EACpB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,QAAQ,CAAC,CAYnB"}

package/dist/src/handlers/repository.js

@@ -2,12 +2,96 @@
  * Copyright (c) 2025 Elara AI Pty Ltd
  * Licensed under BSL 1.1. See LICENSE for details.
  */
-import { variant } from '@elaraai/east';
-import { repoGc, packageList, workspaceList } from '@elaraai/e3-core';
+import { randomUUID } from 'node:crypto';
+import { ArrayType, NullType, StringType, none, variant } from '@elaraai/east';
+import { RepositoryRecordType } from '@elaraai/e3-types';
+import { RepoAlreadyExistsError, RepoNotFoundError, packageList, repositoryOpen, workspaceList } from '@elaraai/e3-core';
 import { sendSuccess, sendSuccessWithStatus, sendError } from '../beast2.js';
 import { errorToVariant } from '../errors.js';
 import { RepositoryStatusType, GcStartResultType, GcStatusResultType, } from '../types.js';
-import { createGcOperation, completeGcOperation, failGcOperation, getGcOperationStatus, hasGcOperation, } from '../async-operation-state.js';
+/**
+ * The repositories a host keeps, by name.
+ *
+ * @param storage - Storage backend, whose `RepoStore` keeps the repositories
+ * @returns The response: the names, or the error
+ */
+export async function listRepositories(storage) {
+    try {
+        return sendSuccess(ArrayType(StringType), await storage.repos.list());
+    }
+    catch (err) {
+        return sendError(ArrayType(StringType), errorToVariant(err));
+    }
+}
+/**
+ * Creates a repository, with its record naming this release and every
+ * upgrade this e3 knows, since a new repository is in their forms.
+ *
+ * @param storage - Storage backend, whose `RepoStore` keeps the repositories
+ * @param repo - The new repository's name
+ * @returns The response: 201 with its name; or the error, as for one that
+ *   exists, or whose removal is still being cleaned up
+ */
+export async function createRepository(storage, repo) {
+    try {
+        const existing = await storage.repos.getMetadata(repo);
+        if (existing) {
+            if (existing.status.type === 'deleting') {
+                return sendError(StringType, variant('internal', { message: `Repository '${repo}' cleanup in progress, try later` }));
+            }
+            return sendError(StringType, variant('internal', { message: `Repository '${repo}' already exists` }));
+        }
+        await storage.repos.create(repo);
+        return sendSuccessWithStatus(StringType, repo, 201);
+    }
+    catch (err) {
+        if (err instanceof RepoAlreadyExistsError) {
+            return sendError(StringType, variant('internal', { message: `Repository '${repo}' already exists` }));
+        }
+        return sendError(StringType, errorToVariant(err));
+    }
+}
+/**
+ * Removes a repository, resumably: it is marked `deleting` first, so the
+ * repository gate treats it as gone from then on, and a removal asked again
+ * answers at once; then its refs and its objects are deleted a batch at a
+ * time, and last the repository itself.
+ *
+ * @param storage - Storage backend, whose `RepoStore` keeps the repositories
+ * @param repo - The repository's name
+ * @returns The response: null once it is removed, or the error
+ */
+export async function removeRepository(storage, repo) {
+    try {
+        const existing = await storage.repos.getMetadata(repo);
+        if (!existing) {
+            return sendError(NullType, variant('repository_not_found', { repo }));
+        }
+        // Being removed already: the removal that marked it finishes it.
+        if (existing.status.type === 'deleting') {
+            return sendSuccess(NullType, null);
+        }
+        await storage.repos.setStatus(repo, 'deleting', 'active');
+        let cursor;
+        do {
+            const result = await storage.repos.deleteRefsBatch(repo, cursor);
+            cursor = result.status === 'continue' ? result.cursor : undefined;
+        } while (cursor);
+        cursor = undefined;
+        do {
+            const result = await storage.repos.deleteObjectsBatch(repo, cursor);
+            cursor = result.status === 'continue' ? result.cursor : undefined;
+        } while (cursor);
+        await storage.repos.remove(repo);
+        return sendSuccess(NullType, null);
+    }
+    catch (err) {
+        if (err instanceof RepoNotFoundError) {
+            return sendError(NullType, variant('repository_not_found', { repo }));
+        }
+        return sendError(NullType, errorToVariant(err));
+    }
+}
 /**
  * Get repository status.
  */
@@ -31,49 +115,72 @@ export async function getStatus(storage, repoPath) {
     }
 }
 /**
- * Start garbage collection (async).
+ * The repository's record: the release of e3 that last wrote it, and the store
+ * upgrades it has had.
  *
- * Returns immediately with an executionId. GC runs in background.
- * Poll getGcStatus() for progress.
+ * @param storage - Storage backend
+ * @param repoPath - Repository identifier
+ * @returns The response: the record, or the error
  */
-export function startGc(storage, repoPath, options) {
-    // Create operation and get executionId
-    const executionId = createGcOperation();
-    // Run GC in background (don't await)
-    void (async () => {
-        try {
-            const result = await repoGc(storage, repoPath, options);
-            completeGcOperation(executionId, {
-                deletedObjects: BigInt(result.deletedObjects),
-                deletedPartials: BigInt(result.deletedPartials),
-                retainedObjects: BigInt(result.retainedObjects),
-                skippedYoung: BigInt(result.skippedYoung),
-                bytesFreed: BigInt(result.bytesFreed),
-            });
-        }
-        catch (err) {
-            const message = err instanceof Error ? err.message : String(err);
-            failGcOperation(executionId, message);
-        }
-    })();
-    // Return 202 Accepted with executionId
-    return sendSuccessWithStatus(GcStartResultType, { executionId }, 202);
+export async function getRecord(storage, repoPath) {
+    try {
+        return sendSuccess(RepositoryRecordType, await repositoryOpen(storage, repoPath));
+    }
+    catch (err) {
+        return sendError(RepositoryRecordType, errorToVariant(err));
+    }
+}
+/**
+ * Start garbage collection, as a job the client polls.
+ *
+ * @remarks
+ * gc takes as long as the repository is large, which outlasts a request. So it
+ * runs as a job, in the compute the store dispatches it to: a local server's
+ * own process, or a cloud's. A poll reads the job's status from the store,
+ * whichever instance answers it.
+ *
+ * @param repo - The repository's name, which the job is filed under
+ * @param request - What gc keeps, and whether it deletes
+ * @param gcStore - Where the job is filed, and dispatched from
+ * @returns The response: 202 with the job's id, or the error
+ */
+export async function startGc(repo, request, gcStore) {
+    try {
+        const executionId = randomUUID();
+        await gcStore.create(executionId, {
+            repo,
+            request,
+            status: { status: variant('running', null), stats: none, error: none },
+            createdAt: new Date(),
+        });
+        await gcStore.execute(executionId, repo);
+        return sendSuccessWithStatus(GcStartResultType, { executionId }, 202);
+    }
+    catch (err) {
+        return sendError(GcStartResultType, errorToVariant(err));
+    }
 }
 /**
- * Get garbage collection status.
+ * A gc job's status: still running, what gc did, or why it failed.
+ *
+ * @param gcStore - Where the job is filed
+ * @param repo - The repository's name
+ * @param executionId - The job's id
+ * @returns The response: the status, or the error when this repository started
+ *   no such job
  */
-export function getGcStatus(executionId) {
-    if (!hasGcOperation(executionId)) {
-        return sendError(GcStatusResultType, variant('internal', {
-            message: `GC operation not found: ${executionId}`,
-        }));
+export async function getGcStatus(gcStore, repo, executionId) {
+    try {
+        const job = await gcStore.get(executionId);
+        if (job === null || job.repo !== repo) {
+            return sendError(GcStatusResultType, variant('internal', {
+                message: `repository '${repo}' has no gc job '${executionId}'`,
+            }));
+        }
+        return sendSuccess(GcStatusResultType, job.status);
     }
-    const status = getGcOperationStatus(executionId);
-    if (!status) {
-        return sendError(GcStatusResultType, variant('internal', {
-            message: `GC operation not found: ${executionId}`,
-        }));
+    catch (err) {
+        return sendError(GcStatusResultType, errorToVariant(err));
     }
-    return sendSuccess(GcStatusResultType, status);
 }
 //# sourceMappingURL=repository.js.map

package/dist/src/handlers/repository.js.map

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

package/dist/src/handlers/tasks.d.ts

@@ -14,7 +14,8 @@ export declare function getTask(storage: StorageBackend, repoPath: string, works
 /**
  * List execution history for a task: the latest attempt per distinct
  * inputs hash, or — with `all` — every attempt (a forced re-run or a retry
- * after a failure adds one under the same inputs hash).
+ * after a failure adds one under the same inputs hash). A split task's units
+ * are recorded under its hash too, and are left out: they are not its runs.
  */
 export declare function listExecutions(storage: StorageBackend, repoPath: string, workspace: string, taskName: string, all?: boolean): Promise<Response>;
 //# sourceMappingURL=tasks.d.ts.map

package/dist/src/handlers/tasks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../../src/handlers/tasks.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAKvD;;GAEG;AACH,wBAAsB,SAAS,CAC7B,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,QAAQ,CAAC,CAiBnB;AAED;;GAEG;AACH,wBAAsB,OAAO,CAC3B,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,QAAQ,CAAC,CAiBnB;AA0ED;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,GAAG,UAAQ,GACV,OAAO,CAAC,QAAQ,CAAC,CAqBnB"}
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../../src/handlers/tasks.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAKvD;;GAEG;AACH,wBAAsB,SAAS,CAC7B,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,QAAQ,CAAC,CAiBnB;AAED;;GAEG;AACH,wBAAsB,OAAO,CAC3B,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,QAAQ,CAAC,CAiBnB;AAgGD;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,GAAG,UAAQ,GACV,OAAO,CAAC,QAAQ,CAAC,CAqBnB"}

package/dist/src/handlers/tasks.js

@@ -13,11 +13,11 @@ import { TaskListItemType, TaskDetailsType, ExecutionListItemType } from '../typ
 export async function listTasks(storage, repoPath, workspace) {
     try {
         const taskNames = await workspaceListTasks(storage, repoPath, workspace);
-        // Get hash + kind for each task (the object read is content-addressed and cheap)
+        // Get hash + role for each task (the object read is content-addressed and cheap)
         const result = await Promise.all(taskNames.map(async (name) => {
             const hash = await workspaceGetTaskHash(storage, repoPath, workspace, name);
             const task = await workspaceGetTask(storage, repoPath, workspace, name);
-            return { name, hash, kind: task.kind };
+            return { name, hash, role: task.role };
         }));
         return sendSuccess(ArrayType(TaskListItemType), result);
     }
@@ -35,11 +35,11 @@ export async function getTask(storage, repoPath, workspace, taskName) {
         return sendSuccess(TaskDetailsType, {
             name: taskName,
             hash,
-            commandIr: task.commandIr,
+            body: task.body,
+            runner: task.runner,
             inputs: task.inputs,
             output: task.output,
-            kind: task.kind,
-            metadata: task.metadata,
+            role: task.role,
         });
     }
     catch (err) {
@@ -59,6 +59,10 @@ function statusToApiStatus(status) {
             return variant('failed', null);
         case 'error':
             return variant('error', null);
+        case 'cancelled':
+            return variant('cancelled', null);
+        case 'interrupted':
+            return variant('interrupted', null);
     }
 }
 /**
@@ -80,6 +84,7 @@ function toExecutionListItem(inputsHash, status) {
             completedAt: some(status.value.completedAt.toISOString()),
             duration: some(calculateDuration(status.value.startedAt, status.value.completedAt)),
             exitCode: none,
+            peakBytes: status.value.peakBytes,
         };
     }
     if (status.type === 'failed') {
@@ -91,9 +96,24 @@ function toExecutionListItem(inputsHash, status) {
             completedAt: some(status.value.completedAt.toISOString()),
             duration: some(calculateDuration(status.value.startedAt, status.value.completedAt)),
             exitCode: some(status.value.exitCode),
+            peakBytes: status.value.peakBytes,
         };
     }
-    if (status.type === 'error') {
+    if (status.type === 'cancelled') {
+        return {
+            inputsHash,
+            inputHashes: status.value.inputHashes,
+            status: statusToApiStatus(status),
+            startedAt: status.value.startedAt.toISOString(),
+            completedAt: some(status.value.completedAt.toISOString()),
+            duration: some(calculateDuration(status.value.startedAt, status.value.completedAt)),
+            exitCode: none,
+            peakBytes: none,
+        };
+    }
+    // An interruption's completedAt is when it was found, not when the runner
+    // stopped, so it has no duration.
+    if (status.type === 'error' || status.type === 'interrupted') {
         return {
             inputsHash,
             inputHashes: status.value.inputHashes,
@@ -102,6 +122,7 @@ function toExecutionListItem(inputsHash, status) {
             completedAt: some(status.value.completedAt.toISOString()),
             duration: none,
             exitCode: none,
+            peakBytes: none,
         };
     }
     // running
@@ -113,12 +134,14 @@ function toExecutionListItem(inputsHash, status) {
         completedAt: none,
         duration: none,
         exitCode: none,
+        peakBytes: none,
     };
 }
 /**
  * List execution history for a task: the latest attempt per distinct
  * inputs hash, or — with `all` — every attempt (a forced re-run or a retry
- * after a failure adds one under the same inputs hash).
+ * after a failure adds one under the same inputs hash). A split task's units
+ * are recorded under its hash too, and are left out: they are not its runs.
  */
 export async function listExecutions(storage, repoPath, workspace, taskName, all = false) {
     try {
@@ -131,7 +154,7 @@ export async function listExecutions(storage, repoPath, workspace, taskName, all
                     .map(executionId => executionGet(storage, repoPath, taskHash, inputsHash, executionId)))
                 : [await executionGetLatest(storage, repoPath, taskHash, inputsHash)];
             for (const status of statuses) {
-                if (status)
+                if (status && !status.value.unit)
                     result.push(toExecutionListItem(inputsHash, status));
             }
         }

package/dist/src/handlers/tasks.js.map

@@ -1 +1 @@
-{"version":3,"file":"tasks.js","sourceRoot":"","sources":["../../../src/handlers/tasks.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tasks.js","sourceRoot":"","sources":["../../../src/handlers/tasks.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE/D,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,GACb,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,qBAAqB,EAA0B,MAAM,aAAa,CAAC;AAE/G;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,OAAuB,EACvB,QAAgB,EAChB,SAAiB;IAEjB,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,MAAM,kBAAkB,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;QAEzE,iFAAiF;QACjF,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAC9B,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;YAC3B,MAAM,IAAI,GAAG,MAAM,oBAAoB,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;YAC5E,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;YACxE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;QACzC,CAAC,CAAC,CACH,CAAC;QAEF,OAAO,WAAW,CAAC,SAAS,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC,CAAC;IAC1D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,SAAS,CAAC,SAAS,CAAC,gBAAgB,CAAC,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC;IACrE,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,OAAuB,EACvB,QAAgB,EAChB,SAAiB,EACjB,QAAgB;IAEhB,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,oBAAoB,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;QAChF,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;QAE5E,OAAO,WAAW,CAAC,eAAe,EAAE;YAClC,IAAI,EAAE,QAAQ;YACd,IAAI;YACJ,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,IAAI,EAAE,IAAI,CAAC,IAAI;SAChB,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,SAAS,CAAC,eAAe,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC;IACzD,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,MAAuB;IAChD,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,SAAS;YACZ,OAAO,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAClC,KAAK,SAAS;YACZ,OAAO,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAClC,KAAK,QAAQ;YACX,OAAO,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACjC,KAAK,OAAO;YACV,OAAO,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAChC,KAAK,WAAW;YACd,OAAO,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QACpC,KAAK,aAAa;YAChB,OAAO,OAAO,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;IACxC,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,SAAe,EAAE,WAAiB;IAC3D,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,EAAE,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;AACzE,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,UAAkB,EAAE,MAAuB;IACtE,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO;YACL,UAAU;YACV,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,WAAW;YACrC,MAAM,EAAE,iBAAiB,CAAC,MAAM,CAAC;YACjC,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,WAAW,EAAE;YAC/C,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC;YACzD,QAAQ,EAAE,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YACnF,QAAQ,EAAE,IAAI;YACd,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS;SAClC,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,OAAO;YACL,UAAU;YACV,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,WAAW;YACrC,MAAM,EAAE,iBAAiB,CAAC,MAAM,CAAC;YACjC,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,WAAW,EAAE;YAC/C,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC;YACzD,QAAQ,EAAE,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YACnF,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC;YACrC,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS;SAClC,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QAChC,OAAO;YACL,UAAU;YACV,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,WAAW;YACrC,MAAM,EAAE,iBAAiB,CAAC,MAAM,CAAC;YACjC,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,WAAW,EAAE;YAC/C,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC;YACzD,QAAQ,EAAE,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YACnF,QAAQ,EAAE,IAAI;YACd,SAAS,EAAE,IAAI;SAChB,CAAC;IACJ,CAAC;IACD,0EAA0E;IAC1E,kCAAkC;IAClC,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,IAAI,MAAM,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;QAC7D,OAAO;YACL,UAAU;YACV,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,WAAW;YACrC,MAAM,EAAE,iBAAiB,CAAC,MAAM,CAAC;YACjC,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,WAAW,EAAE;YAC/C,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC;YACzD,QAAQ,EAAE,IAAI;YACd,QAAQ,EAAE,IAAI;YACd,SAAS,EAAE,IAAI;SAChB,CAAC;IACJ,CAAC;IACD,UAAU;IACV,OAAO;QACL,UAAU;QACV,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,WAAW;QACrC,MAAM,EAAE,iBAAiB,CAAC,MAAM,CAAC;QACjC,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,WAAW,EAAE;QAC/C,WAAW,EAAE,IAAI;QACjB,QAAQ,EAAE,IAAI;QACd,QAAQ,EAAE,IAAI;QACd,SAAS,EAAE,IAAI;KAChB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAAuB,EACvB,QAAgB,EAChB,SAAiB,EACjB,QAAgB,EAChB,GAAG,GAAG,KAAK;IAEX,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;QACpF,MAAM,YAAY,GAAG,MAAM,oBAAoB,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAE7E,MAAM,MAAM,GAAwB,EAAE,CAAC;QAEvC,KAAK,MAAM,UAAU,IAAI,YAAY,EAAE,CAAC;YACtC,MAAM,QAAQ,GAA+B,GAAG;gBAC9C,CAAC,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,gBAAgB,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;qBAClF,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC;gBAC1F,CAAC,CAAC,CAAC,MAAM,kBAAkB,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC;YACxE,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;gBAC9B,IAAI,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI;oBAAE,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;YACzF,CAAC;QACH,CAAC;QAED,OAAO,WAAW,CAAC,SAAS,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC,CAAC;IAC/D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,SAAS,CAAC,SAAS,CAAC,qBAAqB,CAAC,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1E,CAAC;AACH,CAAC"}

package/dist/src/handlers/tasks.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=tasks.spec.d.ts.map

package/dist/src/handlers/tasks.spec.d.ts.map

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

package/dist/src/handlers/tasks.spec.js

@@ -0,0 +1,64 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * Task route tests: a task's execution history lists its runs, and leaves out
+ * the units a split task runs under its hash, which are not runs of it.
+ */
+import { describe, it, beforeEach } from 'node:test';
+import assert from 'node:assert/strict';
+import { Hono } from 'hono';
+import { ArrayType, decodeBeast2For, encodeBeast2For, none, some, variant } from '@elaraai/east';
+import { InMemoryStorage } from '@elaraai/e3-core/test';
+import { PackageObjectType, WorkspaceRecordType } from '@elaraai/e3-types';
+import { createTaskRoutes } from '../routes/tasks.js';
+import { ExecutionListItemType, ResponseType } from '../types.js';
+const REPO = 'test-repo';
+const WS = 'main';
+const TASK = 'a'.repeat(64);
+const decodeHistory = decodeBeast2For(ResponseType(ArrayType(ExecutionListItemType)));
+describe('task routes', () => {
+    let storage;
+    let app;
+    beforeEach(async () => {
+        storage = new InMemoryStorage();
+        await storage.repos.create(REPO);
+        const pkg = await storage.objects.write(REPO, encodeBeast2For(PackageObjectType)({
+            tasks: new Map([['count', TASK]]),
+            data: { structure: variant('struct', new Map()), refs: new Map() },
+            functions: new Map(),
+            records: new Map(),
+            sources: new Map(),
+        }));
+        await storage.refs.workspaceWrite(REPO, WS, encodeBeast2For(WorkspaceRecordType)(some({
+            packageName: 'counts', packageVersion: '1.0.0', packageHash: pkg, deployedAt: new Date(0), currentRunId: none,
+        })));
+        app = new Hono();
+        app.route('/api/repos/:repo/workspaces/:ws/tasks', createTaskRoutes(storage, () => REPO));
+    });
+    /** The inputs hash of each execution the task's history lists. */
+    async function history(query = '') {
+        const response = await app.request(`/api/repos/r/workspaces/${WS}/tasks/count/executions${query}`);
+        const answer = decodeHistory(new Uint8Array(await response.arrayBuffer()));
+        if (answer.type !== 'success')
+            assert.fail(`the history was refused: ${answer.value.type}`);
+        return answer.value.map((item) => item.inputsHash);
+    }
+    it('lists a split task\'s runs, and none of the units it ran under its hash', async () => {
+        // Two runs of the task over the same inputs, and a piece and a merge of
+        // the second, each under inputs of its own.
+        const own = 'b'.repeat(64);
+        const executions = [[own, false], [own, false], ['c'.repeat(64), true], ['d'.repeat(64), true]];
+        for (const [i, [inputs, unit]] of executions.entries()) {
+            const executionId = `01900000-0000-7000-8000-00000000000${i + 1}`;
+            await storage.refs.executionWrite(REPO, TASK, inputs, executionId, variant('success', {
+                executionId, inputHashes: [], outputHash: 'f'.repeat(64),
+                startedAt: new Date(0), completedAt: new Date(1_000), peakBytes: none, plan: none, unit,
+            }));
+        }
+        assert.deepEqual(await history(), [own]);
+        assert.deepEqual(await history('?all=true'), [own, own]);
+    });
+});
+//# sourceMappingURL=tasks.spec.js.map

package/dist/src/handlers/tasks.spec.js.map

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

package/dist/src/handlers/workspaces.d.ts

@@ -2,7 +2,8 @@
  * Copyright (c) 2025 Elara AI Pty Ltd
  * Licensed under BSL 1.1. See LICENSE for details.
  */
-import type { StorageBackend } from '@elaraai/e3-core';
+import { type WorkspaceDeployRequest } from '@elaraai/e3-types';
+import type { StorageBackend, TaskRunner, WorkspaceDeployStore } from '@elaraai/e3-core';
 /**
  * List all workspaces in the repository.
  */
@@ -17,18 +18,55 @@ export declare function createWorkspace(storage: StorageBackend, repoPath: strin
 export declare function getWorkspace(storage: StorageBackend, repoPath: string, name: string): Promise<Response>;
 /**
  * Get comprehensive workspace status.
+ *
+ * @param storage - Storage backend
+ * @param runner - The runner the repository's tasks run on, which says
+ *   whether an execution recorded running can still finish
+ * @param repoPath - Repository identifier
+ * @param name - Workspace name
+ * @returns The response: the status, or the error
  */
-export declare function getWorkspaceStatus(storage: StorageBackend, repoPath: string, name: string): Promise<Response>;
+export declare function getWorkspaceStatus(storage: StorageBackend, runner: TaskRunner, repoPath: string, name: string): Promise<Response>;
 /**
  * Delete a workspace.
  */
 export declare function deleteWorkspace(storage: StorageBackend, repoPath: string, name: string): Promise<Response>;
 /**
- * Deploy a package to a workspace.
+ * Start deploying a package to a workspace, as a job the client polls.
+ *
+ * @remarks
+ * A deploy that migrates a record, or builds an index over one, takes as long
+ * as the record is large, which outlasts a request. So the deploy runs as a
+ * job, in the compute the store dispatches it to: a local server's own
+ * process, or a cloud's. The package is resolved first, so a deploy of one the
+ * repository does not hold is refused at once, as `package_not_found`, and the
+ * job deploys exactly the version resolved.
+ *
+ * The job never opens a path-initialised input's file: its path is on the
+ * machine that exported the package. Each such input is left unassigned, and
+ * `e3 workspace deploy <url>` completes it over the dataset transfer protocol
+ * once the job has finished.
+ *
+ * @param storage - Storage backend
+ * @param repoPath - Repository identifier
+ * @param repo - The repository's name, which the job is filed under
+ * @param workspace - Workspace name
+ * @param request - The package, and what the deploy does with a record it
+ *   cannot keep as it is
+ * @param deployStore - Where the job is filed, and dispatched from
+ * @returns The response: the job's id, or the error
  */
-export declare function deployWorkspace(storage: StorageBackend, repoPath: string, workspace: string, packageRef: string): Promise<Response>;
+export declare function startWorkspaceDeploy(storage: StorageBackend, repoPath: string, repo: string, workspace: string, request: WorkspaceDeployRequest, deployStore: WorkspaceDeployStore): Promise<Response>;
 /**
- * Export a workspace as a zip archive.
+ * A deploy job's status: still running, what the deploy did, or why it did
+ * not.
+ *
+ * @param deployStore - Where the job is filed
+ * @param repo - The repository's name
+ * @param workspace - Workspace name
+ * @param id - The job's id
+ * @returns The response: the status, or the error when this workspace started
+ *   no such job
  */
-export declare function exportWorkspace(storage: StorageBackend, repoPath: string, workspace: string): Promise<Response>;
+export declare function getWorkspaceDeployStatus(deployStore: WorkspaceDeployStore, repo: string, workspace: string, id: string): Promise<Response>;
 //# sourceMappingURL=workspaces.d.ts.map