@standardagents/code 0.14.100-canary.564e99 → 0.14.103-canary.806f0c

package/lib/install.mjs

@@ -55,7 +55,22 @@ function tar(run, args) {
   return result.stdout
 }
 
-export async function installNativeArtifact({ target, root = PACKAGE_ROOT, fetchImplementation = fetch, run = spawnSync, publicKey = undefined }) {
+// Reads a download to the end, reporting each chunk, and refuses a body larger
+// than the published size before it is buffered.
+async function readBody(response, size, onProgress) {
+  if (!response.body) return Buffer.from(await response.arrayBuffer())
+  const chunks = []
+  let received = 0
+  for await (const chunk of response.body) {
+    received += chunk.length
+    if (received > size) throw new Error('The downloaded native archive does not match its published size and digest')
+    chunks.push(chunk)
+    onProgress(received, size)
+  }
+  return Buffer.concat(chunks, received)
+}
+
+export async function installNativeArtifact({ target, root = PACKAGE_ROOT, fetchImplementation = fetch, run = spawnSync, publicKey = undefined, onProgress = () => {} }) {
   const installed = installedArtifact(target, root, publicKey)
   if (installed) return installed.directory
   const metadata = packageMetadata(root)
@@ -63,7 +78,7 @@ export async function installNativeArtifact({ target, root = PACKAGE_ROOT, fetch
   if (!pointer) throw new Error(`This package carries no native archive for ${target}`)
   const response = await fetchImplementation(pointer.url)
   if (!response.ok) throw new Error(`Downloading the native archive failed with HTTP ${response.status}`)
-  const bytes = Buffer.from(await response.arrayBuffer())
+  const bytes = await readBody(response, pointer.size, onProgress)
   if (bytes.length !== pointer.size || createHash('sha256').update(bytes).digest('hex') !== pointer.sha256) {
     throw new Error('The downloaded native archive does not match its published size and digest')
   }

package/lib/launcher.mjs

@@ -7,6 +7,7 @@ import process from 'node:process'
 import { platformPackage } from './platform.mjs'
 import { artifactBinaryPath, requireCompatibleGlibc, verifyNativeArtifact } from './artifact.mjs'
 import { artifactPointer, installNativeArtifact, installedArtifact, nativeDirectory, packageMetadata } from './install.mjs'
+import { createSteps, megabytes, progressBar } from './progress.mjs'
 
 const require = createRequire(import.meta.url)
 const COMMANDS = new Set(['standard', 'standardd'])
@@ -121,22 +122,33 @@ export async function ensureNativeBinaries(options = {}) {
   } catch {
     // No npm platform package: download the archive.
   }
-  const log = options.log ?? (message => console.error(message))
-  log(`standard: installing the native build for ${platform.rustTarget} (first launch)`)
+  const steps = createSteps({ stream: options.stream, environment: options.environment, version: packageMetadata(options.packageRoot).version })
+  steps.header()
+  const step = steps.start('Downloading Standard Code')
   try {
-    await installNativeArtifact({ target: platform.rustTarget, root: options.packageRoot, fetchImplementation: options.fetchImplementation })
+    await installNativeArtifact({
+      target: platform.rustTarget,
+      root: options.packageRoot,
+      fetchImplementation: options.fetchImplementation,
+      onProgress: (received, total) => step.update(`${progressBar(received, total)}  ${megabytes(received)} of ${megabytes(total)} MB`),
+    })
   } catch (error) {
     if (error?.code === 'EACCES' || error?.code === 'EPERM') {
-      throw new Error(
-        `cannot write the native build under ${nativeDirectory(platform.rustTarget, options.packageRoot)}. `
+      const message = `Cannot write the native build under ${nativeDirectory(platform.rustTarget, options.packageRoot)}. `
         + 'The package belongs to another user (for example an npm install run with sudo); '
-        + 'reinstall @standardagents/code with an npm prefix you own.',
-      )
+        + 'reinstall @standardagents/code with an npm prefix you own.'
+      step.fail('Download did not complete', message)
+      throw new ReportedError(message)
     }
-    throw error
+    step.fail('Download did not complete', error instanceof Error ? error.message : String(error))
+    throw new ReportedError(String(error))
   }
+  step.done(`Downloaded Standard Code (${megabytes(artifactPointer(packageMetadata(options.packageRoot), platform.rustTarget).size)} MB)`)
 }
 
+// An error the setup progress already showed.
+class ReportedError extends Error {}
+
 export async function main(command) {
   try {
     await ensureNativeBinaries()
@@ -149,8 +161,10 @@ export async function main(command) {
     }
     process.exitCode = result.status ?? 1
   } catch (error) {
-    const detail = error instanceof Error ? error.message : String(error)
-    console.error(`${command}: ${detail}`)
+    if (!(error instanceof ReportedError)) {
+      const detail = error instanceof Error ? error.message : String(error)
+      console.error(`${command}: ${detail}`)
+    }
     process.exitCode = 1
   }
 }

package/lib/progress.mjs

@@ -0,0 +1,62 @@
+import process from 'node:process'
+
+// First-launch progress on stderr, in the same layout the native client uses
+// for its sign-in and daemon steps. The launcher prints the header, so it
+// tells the native client not to print it again.
+export const HEADER_SHOWN = 'STANDARD_SETUP_HEADER_SHOWN'
+const FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏']
+const BAR = 24
+
+export function megabytes(bytes) {
+  return (bytes / 1_000_000).toFixed(1)
+}
+
+export function progressBar(received, total, width = BAR) {
+  const filled = total > 0 ? Math.min(width, Math.round((received / total) * width)) : 0
+  return '█'.repeat(filled) + '░'.repeat(width - filled)
+}
+
+export function createSteps({ stream = process.stderr, environment = process.env, version = '' } = {}) {
+  const live = Boolean(stream.isTTY)
+  const color = live && environment.NO_COLOR === undefined
+  const paint = (code, text) => (color ? `\x1b[${code}m${text}\x1b[0m` : text)
+  return {
+    header() {
+      stream.write(`\n  ${paint('1', 'Standard Code')} ${paint('2', version)}\n\n`)
+      environment[HEADER_SHOWN] = '1'
+    },
+    start(label) {
+      let frame = 0
+      let detail = ''
+      const draw = () => stream.write(`\r\x1b[2K  ${paint('33', FRAMES[frame])} ${label}${detail}`)
+      let timer = null
+      if (live) {
+        draw()
+        // The animation only redraws this line; it is not a status poll.
+        timer = setInterval(() => {
+          frame = (frame + 1) % FRAMES.length
+          draw()
+        }, 80)
+      } else {
+        stream.write(`  … ${label}\n`)
+      }
+      const halt = () => {
+        if (timer) clearInterval(timer)
+        if (live) stream.write('\r\x1b[2K')
+      }
+      return {
+        update(text) {
+          detail = text ? `  ${paint('2', text)}` : ''
+        },
+        done(text) {
+          halt()
+          stream.write(`  ${paint('32', '✓')} ${text}\n`)
+        },
+        fail(text, cause) {
+          halt()
+          stream.write(`  ${paint('31', '✗')} ${text}\n    ${paint('2', cause)}\n\n`)
+        },
+      }
+    },
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@standardagents/code",
-  "version": "0.14.100-canary.564e99",
+  "version": "0.14.103-canary.806f0c",
   "description": "Platform launcher for the Standard universal terminal network.",
   "type": "module",
   "license": "UNLICENSED",
@@ -27,14 +27,14 @@
     "schema": 1,
     "targets": {
       "aarch64-apple-darwin": {
-        "url": "https://builds.standardcode.ai/artifacts/0.14.100-canary.564e99/aarch64-apple-darwin.tar.gz",
-        "sha256": "e396de4733caa2bc3a7a83b4a16ae27885c2a4a4827bd29cb628decd9ef013bc",
-        "size": 30575920
+        "url": "https://builds.standardcode.ai/artifacts/0.14.103-canary.806f0c/aarch64-apple-darwin.tar.gz",
+        "sha256": "b2326590c98bab9f4ef881738ae3318b896a7d5cf9ad6934d8bc2e71ce7625c1",
+        "size": 30670441
       },
       "x86_64-unknown-linux-gnu": {
-        "url": "https://builds.standardcode.ai/artifacts/0.14.100-canary.564e99/x86_64-unknown-linux-gnu.tar.gz",
-        "sha256": "a75261aa25a5a49edf625e05cf93e647b0ef9416ee15f0757d71fbda9c3e339d",
-        "size": 29524726
+        "url": "https://builds.standardcode.ai/artifacts/0.14.103-canary.806f0c/x86_64-unknown-linux-gnu.tar.gz",
+        "sha256": "5772d3ee4fc434a3791e2a382213e466de1c3dfef465076a0cd45bd639c34527",
+        "size": 29655260
       }
     }
   },