agentlab 0.2.2 → 0.2.4

package/README.md

@@ -15,7 +15,8 @@ agentlab
 
 Run `agentlab` from any directory. The app opens to the project picker and waits for you to choose a
 folder. On first launch, the npm package downloads the matching AgentLab executable from GitHub and
-caches it. Later launches use the cached executable.
+caches it. The installer shows the percentage, downloaded size, and download speed while it works.
+Later launches use the cached executable.
 
 ## Requirements
 

package/dist/cache.js

@@ -32,6 +32,7 @@ export async function ensureCachedBinary(manifest, key, options = {}) {
     const fetchImplementation = options.fetch ?? globalThis.fetch;
     const downloadUrl = releaseDownloadUrl(manifest, key);
     try {
+        options.onDownloadProgress?.({ downloadedBytes: 0, totalBytes: target.size });
         const response = await fetchImplementation(downloadUrl, {
             redirect: "follow",
             signal: AbortSignal.timeout(DOWNLOAD_TIMEOUT_MILLISECONDS)
@@ -62,6 +63,7 @@ export async function ensureCachedBinary(manifest, key, options = {}) {
                 }
                 hash.update(chunk);
                 await writeAll(file, chunk);
+                options.onDownloadProgress?.({ downloadedBytes: size, totalBytes: target.size });
             }
             await file.sync();
         }

package/dist/cli.js

@@ -4,6 +4,7 @@ import { readFile } from "node:fs/promises";
 import { dirname, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { ensureCachedBinary, resolveCacheRoot } from "./cache.js";
+import { InstallProgressReporter } from "./install-progress.js";
 import { currentRuntimePlatform, parseReleaseManifest, resolveRuntimeTarget } from "./manifest.js";
 const REGISTRY_LATEST_URL = "https://registry.npmjs.org/agentlab/latest";
 const STABLE_VERSION_PATTERN = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$/u;
@@ -32,10 +33,28 @@ export async function runLauncher(args, options = {}) {
     }
     const runtime = options.runtime ?? currentRuntimePlatform();
     const target = resolveRuntimeTarget(runtime);
-    const binary = await ensureCachedBinary(manifest, target, {
-        cacheRoot: options.cacheRoot ?? resolveCacheRoot(environment),
-        fetch: options.fetch
+    const stderr = options.stderr ?? ((message) => process.stderr.write(message));
+    const progress = new InstallProgressReporter({
+        isTTY: options.stderrIsTTY ?? (options.stderr === undefined && process.stderr.isTTY),
+        target,
+        version: packageVersion,
+        write: stderr
     });
+    let binary;
+    try {
+        binary = await ensureCachedBinary(manifest, target, {
+            cacheRoot: options.cacheRoot ?? resolveCacheRoot(environment),
+            fetch: options.fetch,
+            onDownloadProgress: (downloadProgress) => {
+                progress.report(downloadProgress);
+            }
+        });
+    }
+    catch (error) {
+        progress.clear();
+        throw error;
+    }
+    progress.complete();
     return execute(binary, args, {
         ...environment,
         AGENTLAB_INSTALL_METHOD: "npm",

package/dist/install-progress.js

@@ -0,0 +1,82 @@
+import { performance } from "node:perf_hooks";
+const BAR_WIDTH = 16;
+const BYTES_PER_MEGABYTE = 1_000_000;
+const MINIMUM_RENDER_INTERVAL_MILLISECONDS = 100;
+const CLEAR_LINE = "\r\u001B[2K";
+const targetLabels = {
+    "linux-x64": "Linux x64",
+    "mac-arm64": "macOS arm64"
+};
+export class InstallProgressReporter {
+    isTTY;
+    now;
+    targetLabel;
+    version;
+    write;
+    active = false;
+    finished = false;
+    lastRenderAt;
+    startedAt;
+    constructor(options) {
+        this.isTTY = options.isTTY;
+        this.now = options.now ?? (() => performance.now());
+        this.targetLabel = targetLabels[options.target];
+        this.version = options.version;
+        this.write = options.write;
+    }
+    report(progress) {
+        if (this.finished)
+            return;
+        const now = this.now();
+        if (!this.active) {
+            this.active = true;
+            this.startedAt = now;
+            if (!this.isTTY) {
+                this.write(`Downloading AgentLab ${this.version} for ${this.targetLabel} (${formatMegabytes(progress.totalBytes)} MB)...\n`);
+                return;
+            }
+        }
+        if (!this.isTTY)
+            return;
+        const complete = progress.downloadedBytes >= progress.totalBytes;
+        if (!complete &&
+            this.lastRenderAt !== undefined &&
+            now - this.lastRenderAt < MINIMUM_RENDER_INTERVAL_MILLISECONDS) {
+            return;
+        }
+        this.lastRenderAt = now;
+        this.write(`${CLEAR_LINE}${renderProgress(progress, now - (this.startedAt ?? now), this.version)}`);
+    }
+    complete() {
+        if (!this.active || this.finished)
+            return;
+        this.finished = true;
+        if (this.isTTY)
+            this.write(CLEAR_LINE);
+        const marker = this.isTTY ? "✓ " : "";
+        this.write(`${marker}AgentLab ${this.version} installed for ${this.targetLabel}.\n`);
+        this.write("Starting AgentLab...\n");
+    }
+    clear() {
+        if (!this.active || this.finished)
+            return;
+        this.finished = true;
+        if (this.isTTY)
+            this.write(CLEAR_LINE);
+    }
+}
+function renderProgress(progress, elapsedMilliseconds, version) {
+    const ratio = clamp(progress.downloadedBytes / progress.totalBytes, 0, 1);
+    const filled = ratio === 1 ? BAR_WIDTH : Math.floor(ratio * BAR_WIDTH);
+    const bar = `${"█".repeat(filled)}${"░".repeat(BAR_WIDTH - filled)}`;
+    const percent = Math.floor(ratio * 100);
+    const elapsedSeconds = Math.max(elapsedMilliseconds / 1_000, 0.001);
+    const megabytesPerSecond = progress.downloadedBytes / BYTES_PER_MEGABYTE / elapsedSeconds;
+    return `Downloading AgentLab ${version} [${bar}] ${String(percent).padStart(3)}% ${formatMegabytes(progress.downloadedBytes)}/${formatMegabytes(progress.totalBytes)} MB ${megabytesPerSecond.toFixed(1)} MB/s`;
+}
+function formatMegabytes(bytes) {
+    return (bytes / BYTES_PER_MEGABYTE).toFixed(1);
+}
+function clamp(value, minimum, maximum) {
+    return Math.min(Math.max(value, minimum), maximum);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentlab",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "Run Codex, Claude Code, and OpenCode in one local terminal, with one captain per project.",
   "keywords": [
     "ai",

package/release-manifest.json

@@ -2,15 +2,15 @@
   "repository": "RiadMefti/agentlab",
   "targets": {
     "linux-x64": {
-      "asset": "agentlab-v0.2.2-linux-x64",
-      "sha256": "1a0188a0bd416244dbc771d0ad6fff37ec5555c99977cd1607a541c1061708af",
+      "asset": "agentlab-v0.2.4-linux-x64",
+      "sha256": "bd3a71fb616f3dee3d4209264e4b7318bad0dda89559a51c4f0631d1563a082e",
       "size": 116298952
     },
     "mac-arm64": {
-      "asset": "agentlab-v0.2.2-mac-arm64",
-      "sha256": "0568c53801d701f016006eb89877fd7b1ad7355415bc38928faa3c15bd718aea",
+      "asset": "agentlab-v0.2.4-mac-arm64",
+      "sha256": "2ed9413662f1441ebe69c6fb4101e4e179446605186f650e180624e9e369089f",
       "size": 77351282
     }
   },
-  "version": "0.2.2"
+  "version": "0.2.4"
 }