@pablozaiden/devbox 0.1.6 → 0.1.7

package/README.md

@@ -99,6 +99,15 @@ cd examples/smoke-workspace
 ../../dist/devbox.js up <port> --allow-missing-ssh
 ```
 
+For a more realistic feature-heavy example, this repository also includes `examples/complex-workspace/.devcontainer/devcontainer.json`:
+
+```bash
+cd examples/complex-workspace
+../../dist/devbox.js up <port>
+```
+
+The complex example uses several devcontainer features, so the first `up` or `rebuild` can take a while. `devbox` prints periodic elapsed-time progress lines while the devcontainer image/features are still being prepared and while the SSH runner is being installed.
+
 ## Notes
 
 - The generated config is written next to the original devcontainer config, using the alternate accepted devcontainer filename so relative Dockerfile paths keep working.

package/dist/devbox.js

@@ -1932,6 +1932,11 @@ async function handleUpLike(command, workspacePath, state, explicitPort, allowMi
   if (environment.warning) {
     console.warn(`Warning: ${environment.warning}`);
   }
+  if (environment.sshAuthSock === DOCKER_DESKTOP_SSH_AUTH_SOCK_SOURCE) {
+    console.log("Using Docker Desktop SSH agent sharing.");
+  } else if (environment.sshAuthSock) {
+    console.log(`Using host SSH agent socket from ${environment.sshAuthSock}.`);
+  }
   await ensureGeneratedConfigIgnored(workspacePath, generatedConfigPath);
   await removeGeneratedConfig(legacyGeneratedConfigPath);
   await writeManagedConfig(generatedConfigPath, managedConfig);
@@ -1955,11 +1960,16 @@ async function handleUpLike(command, workspacePath, state, explicitPort, allowMi
   const allowCurrentPort = existingInspects.some((container) => container.State?.Running && getPublishedHostPorts(container).includes(port));
   await assertPortAvailable(port, allowCurrentPort);
   console.log(`Starting workspace on port ${port}...`);
-  const upResult = await devcontainerUp({
-    workspacePath,
-    generatedConfigPath,
-    userDataDir,
-    labels
+  const upResult = await runStepWithHeartbeat({
+    startMessage: "Preparing devcontainer. First builds with features may take several minutes...",
+    heartbeatMessage: "Still preparing devcontainer",
+    successMessage: "Devcontainer is ready",
+    action: () => devcontainerUp({
+      workspacePath,
+      generatedConfigPath,
+      userDataDir,
+      labels
+    })
   });
   const remoteWorkspaceFolder = upResult.remoteWorkspaceFolder ?? getDefaultRemoteWorkspaceFolder(workspacePath);
   console.log("Configuring SSH access inside the devcontainer...");
@@ -1978,8 +1988,12 @@ async function handleUpLike(command, workspacePath, state, explicitPort, allowMi
   }
   await stopManagedSshd(upResult.containerId);
   await restoreRunnerHostKeys(upResult.containerId, remoteWorkspaceFolder);
-  console.log("Installing and starting the SSH server inside the container (first run can take a bit)...");
-  await startRunner(upResult.containerId, port, remoteWorkspaceFolder);
+  await runStepWithHeartbeat({
+    startMessage: "Installing and starting the SSH server inside the container (first run can take a bit)...",
+    heartbeatMessage: "Still installing and starting the SSH server",
+    successMessage: "SSH server is ready",
+    action: () => startRunner(upResult.containerId, port, remoteWorkspaceFolder)
+  });
   console.log("Saving SSH server state for future runs...");
   await persistRunnerHostKeys(upResult.containerId, remoteWorkspaceFolder);
   await saveWorkspaceState(createWorkspaceState({
@@ -2060,6 +2074,32 @@ function getPublishedHostPorts(container) {
   }
   return [...values];
 }
+async function runStepWithHeartbeat(input) {
+  const startedAt = Date.now();
+  const intervalMs = input.intervalMs ?? 20000;
+  console.log(input.startMessage);
+  const intervalId = setInterval(() => {
+    console.log(`${input.heartbeatMessage} (${formatElapsed(Date.now() - startedAt)} elapsed)...`);
+  }, intervalMs);
+  try {
+    const result = await input.action();
+    if (input.successMessage) {
+      console.log(`${input.successMessage} (${formatElapsed(Date.now() - startedAt)}).`);
+    }
+    return result;
+  } finally {
+    clearInterval(intervalId);
+  }
+}
+function formatElapsed(milliseconds) {
+  const totalSeconds = Math.max(0, Math.round(milliseconds / 1000));
+  const minutes = Math.floor(totalSeconds / 60);
+  const seconds = totalSeconds % 60;
+  if (minutes === 0) {
+    return `${seconds}s`;
+  }
+  return `${minutes}m ${seconds}s`;
+}
 main().catch((error) => {
   if (error instanceof UserError) {
     console.error(`Error: ${error.message}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pablozaiden/devbox",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "type": "module",
   "description": "CLI to run and expose a devcontainer with SSH agent sharing and a forwarded ssh-server-runner port.",
   "repository": {