@vellumai/cli 0.4.30 → 0.4.32

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vellumai/cli",
-  "version": "0.4.30",
+  "version": "0.4.32",
   "description": "CLI tools for vellum-assistant",
   "type": "module",
   "exports": {

package/src/commands/contacts.ts

@@ -82,10 +82,7 @@ interface ContactChannel {
 interface Contact {
   id: string;
   displayName: string;
-  relationship: string | null;
-  importance: number;
-  responseExpectation: string | null;
-  preferredTone: string | null;
+  notes: string | null;
   lastInteraction: number | null;
   interactionCount: number;
   channels: ContactChannel[];
@@ -109,10 +106,7 @@ function formatContact(c: Contact): string {
   const lines = [
     `  ID:           ${c.id}`,
     `  Name:         ${c.displayName}`,
-    `  Relationship: ${c.relationship ?? "(none)"}`,
-    `  Importance:   ${c.importance.toFixed(2)}`,
-    `  Response:     ${c.responseExpectation ?? "(none)"}`,
-    `  Tone:         ${c.preferredTone ?? "(none)"}`,
+    `  Notes:        ${c.notes ?? "(none)"}`,
     `  Interactions: ${c.interactionCount}`,
   ];
   if (c.lastInteraction) {

package/src/commands/hatch.ts

@@ -39,7 +39,6 @@ import type { PollResult, WatchHatchingResult } from "../lib/gcp";
 import {
   startLocalDaemon,
   startGateway,
-  startOutboundProxy,
   stopLocalProcesses,
 } from "../lib/local";
 import { probePort } from "../lib/port-probe";
@@ -757,8 +756,6 @@ async function hatchLocal(
     throw error;
   }
 
-  await startOutboundProxy(watch);
-
   // Read the bearer token written by the daemon so the client can authenticate
   // with the gateway (which requires auth by default).
   let bearerToken: string | undefined;

package/src/commands/ps.ts

@@ -220,8 +220,6 @@ function formatDetectionInfo(proc: DetectedProcess): string {
 async function getLocalProcesses(entry: AssistantEntry): Promise<TableRow[]> {
   const vellumDir = entry.baseDataDir ?? join(homedir(), ".vellum");
 
-  const PROXY_PORT = Number(process.env.PROXY_PORT) || 7829;
-
   const specs: ProcessSpec[] = [
     {
       name: "assistant",
@@ -241,12 +239,6 @@ async function getLocalProcesses(entry: AssistantEntry): Promise<TableRow[]> {
       port: GATEWAY_PORT,
       pidFile: join(vellumDir, "gateway.pid"),
     },
-    {
-      name: "outbound-proxy",
-      pgrepName: "outbound-proxy",
-      port: PROXY_PORT,
-      pidFile: join(vellumDir, "outbound-proxy.pid"),
-    },
     {
       name: "embed-worker",
       pgrepName: "embed-worker",

package/src/commands/retire.ts

@@ -56,13 +56,10 @@ async function retireLocal(name: string, entry: AssistantEntry): Promise<void> {
     socketFile,
   ]);
 
-  // Stop gateway via PID file
+  // Stop gateway via PID file — use a longer timeout because the gateway has a
+  // configurable drain window (GATEWAY_SHUTDOWN_DRAIN_MS, default 5s) before it exits.
   const gatewayPidFile = join(vellumDir, "gateway.pid");
-  await stopProcessByPidFile(gatewayPidFile, "gateway");
-
-  // Stop outbound proxy via PID file
-  const outboundProxyPidFile = join(vellumDir, "outbound-proxy.pid");
-  await stopProcessByPidFile(outboundProxyPidFile, "outbound-proxy");
+  await stopProcessByPidFile(gatewayPidFile, "gateway", undefined, 7000);
 
   // If the PID file didn't track a running daemon, scan for orphaned
   // daemon processes that may have been started without writing a PID.

package/src/commands/sleep.ts

@@ -8,7 +8,7 @@ export async function sleep(): Promise<void> {
   if (args.includes("--help") || args.includes("-h")) {
     console.log("Usage: vellum sleep");
     console.log("");
-    console.log("Stop the assistant, gateway, and outbound-proxy processes.");
+    console.log("Stop the assistant and gateway processes.");
     process.exit(0);
   }
 
@@ -16,7 +16,6 @@ export async function sleep(): Promise<void> {
   const daemonPidFile = join(vellumDir, "vellum.pid");
   const socketFile = join(vellumDir, "vellum.sock");
   const gatewayPidFile = join(vellumDir, "gateway.pid");
-  const outboundProxyPidFile = join(vellumDir, "outbound-proxy.pid");
 
   // Stop daemon
   const daemonStopped = await stopProcessByPidFile(daemonPidFile, "daemon", [
@@ -28,22 +27,18 @@ export async function sleep(): Promise<void> {
     console.log("Assistant stopped.");
   }
 
-  // Stop gateway
-  const gatewayStopped = await stopProcessByPidFile(gatewayPidFile, "gateway");
+  // Stop gateway — use a longer timeout because the gateway has a configurable
+  // drain window (GATEWAY_SHUTDOWN_DRAIN_MS, default 5s) before it exits.
+  const gatewayStopped = await stopProcessByPidFile(
+    gatewayPidFile,
+    "gateway",
+    undefined,
+    7000,
+  );
   if (!gatewayStopped) {
     console.log("Gateway is not running.");
   } else {
     console.log("Gateway stopped.");
   }
 
-  // Stop outbound proxy
-  const outboundProxyStopped = await stopProcessByPidFile(
-    outboundProxyPidFile,
-    "outbound-proxy",
-  );
-  if (!outboundProxyStopped) {
-    console.log("Outbound proxy is not running.");
-  } else {
-    console.log("Outbound proxy stopped.");
-  }
 }

package/src/commands/wake.ts

@@ -4,11 +4,7 @@ import { join } from "path";
 
 import { loadAllAssistants } from "../lib/assistant-config";
 import { isProcessAlive, stopProcessByPidFile } from "../lib/process";
-import {
-  startLocalDaemon,
-  startGateway,
-  startOutboundProxy,
-} from "../lib/local";
+import { startLocalDaemon, startGateway } from "../lib/local";
 
 export async function wake(): Promise<void> {
   const args = process.argv.slice(3);
@@ -88,17 +84,5 @@ export async function wake(): Promise<void> {
     }
   }
 
-  // Start outbound proxy
-  const outboundProxyPidFile = join(vellumDir, "outbound-proxy.pid");
-  const outboundProxyStatus = isProcessAlive(outboundProxyPidFile);
-  if (outboundProxyStatus.alive && watch) {
-    // Restart in watch mode
-    console.log(
-      `Outbound proxy running (pid ${outboundProxyStatus.pid}) — restarting in watch mode...`,
-    );
-    await stopProcessByPidFile(outboundProxyPidFile, "outbound-proxy");
-  }
-  await startOutboundProxy(watch);
-
   console.log("✅ Wake complete.");
 }

package/src/lib/gcp.ts

@@ -198,58 +198,6 @@ export async function syncFirewallRules(
   }
 }
 
-export async function fetchFirewallRules(
-  project: string,
-  tag: string,
-): Promise<string> {
-  const output = await execOutput("gcloud", [
-    "compute",
-    "firewall-rules",
-    "list",
-    `--project=${project}`,
-    "--format=json",
-  ]);
-  const rules = JSON.parse(output) as Array<{ targetTags?: string[] }>;
-  const filtered = rules.filter((r) => r.targetTags?.includes(tag));
-  return JSON.stringify(filtered, null, 2);
-}
-
-export interface GcpInstance {
-  name: string;
-  zone: string;
-  externalIp: string | null;
-  species: string | null;
-}
-
-export async function listAssistantInstances(
-  project: string,
-): Promise<GcpInstance[]> {
-  const output = await execOutput("gcloud", [
-    "compute",
-    "instances",
-    "list",
-    `--project=${project}`,
-    "--filter=labels.vellum-assistant=true",
-    "--format=json(name,zone,networkInterfaces[0].accessConfigs[0].natIP,labels)",
-  ]);
-  const parsed = JSON.parse(output) as Array<{
-    name: string;
-    zone: string;
-    networkInterfaces?: Array<{ accessConfigs?: Array<{ natIP?: string }> }>;
-    labels?: Record<string, string>;
-  }>;
-  return parsed.map((inst) => {
-    const zoneParts = (inst.zone ?? "").split("/");
-    return {
-      name: inst.name,
-      zone: zoneParts[zoneParts.length - 1] || "",
-      externalIp:
-        inst.networkInterfaces?.[0]?.accessConfigs?.[0]?.natIP ?? null,
-      species: inst.labels?.species ?? null,
-    };
-  });
-}
-
 export async function instanceExists(
   instanceName: string,
   project: string,
@@ -281,27 +229,6 @@ export async function instanceExists(
   }
 }
 
-export async function sshCommand(
-  instanceName: string,
-  project: string,
-  zone: string,
-  command: string,
-): Promise<string> {
-  return execOutput("gcloud", [
-    "compute",
-    "ssh",
-    instanceName,
-    `--project=${project}`,
-    `--zone=${zone}`,
-    "--quiet",
-    "--ssh-flag=-o StrictHostKeyChecking=no",
-    "--ssh-flag=-o UserKnownHostsFile=/dev/null",
-    "--ssh-flag=-o ConnectTimeout=5",
-    "--ssh-flag=-o LogLevel=ERROR",
-    `--command=${command}`,
-  ]);
-}
-
 export async function fetchAndDisplayStartupLogs(
   instanceName: string,
   project: string,

package/src/lib/local.ts

@@ -1,4 +1,4 @@
-import { execFileSync, spawn } from "child_process";
+import { execFileSync, execSync, spawn } from "child_process";
 import {
   closeSync,
   existsSync,
@@ -79,18 +79,6 @@ function findGatewaySourceFromCwd(): string | undefined {
   }
 }
 
-function isOutboundProxySourceDir(dir: string): boolean {
-  const pkgPath = join(dir, "package.json");
-  if (!existsSync(pkgPath) || !existsSync(join(dir, "src", "main.ts")))
-    return false;
-  try {
-    const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
-    return pkg.name === "@vellumai/outbound-proxy";
-  } catch {
-    return false;
-  }
-}
-
 function resolveAssistantIndexPath(): string | undefined {
   // Source tree layout: cli/src/lib/ -> ../../.. -> repo root -> assistant/src/index.ts
   const sourceTreeIndex = join(
@@ -161,6 +149,63 @@ async function waitForSocketFile(
   return existsSync(socketPath);
 }
 
+function ensureBunInstalled(): void {
+  const bunBinDir = join(homedir(), ".bun", "bin");
+  const pathWithBun = [
+    bunBinDir,
+    process.env.PATH || "/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin",
+  ].join(":");
+
+  try {
+    execFileSync("bun", ["--version"], {
+      stdio: "pipe",
+      env: { ...process.env, PATH: pathWithBun },
+    });
+    return;
+  } catch {
+    // bun not found, try to install
+  }
+
+  console.log("   Installing bun...");
+  try {
+    const installEnv: Record<string, string> = {
+      HOME: process.env.HOME || homedir(),
+      PATH: process.env.PATH || "/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin",
+      TMPDIR: process.env.TMPDIR || "/tmp",
+      USER: process.env.USER || "",
+      LANG: process.env.LANG || "",
+    };
+    // Preserve proxy/TLS env vars so curl works in proxied/corporate environments
+    for (const key of [
+      "HTTP_PROXY",
+      "http_proxy",
+      "HTTPS_PROXY",
+      "https_proxy",
+      "ALL_PROXY",
+      "all_proxy",
+      "NO_PROXY",
+      "no_proxy",
+      "SSL_CERT_FILE",
+      "SSL_CERT_DIR",
+      "CURL_CA_BUNDLE",
+    ]) {
+      if (process.env[key]) {
+        installEnv[key] = process.env[key]!;
+      }
+    }
+    execSync("curl -fsSL https://bun.sh/install | bash", {
+      stdio: "pipe",
+      timeout: 60_000,
+      env: installEnv,
+    });
+    console.log("   Bun installed successfully");
+  } catch {
+    console.log(
+      "   ⚠️  Failed to install bun — some features may be unavailable",
+    );
+  }
+}
+
 function resolveDaemonMainPath(assistantIndex: string): string {
   return join(dirname(assistantIndex), "daemon", "main.ts");
 }
@@ -354,21 +399,6 @@ function resolveGatewayDir(): string {
   }
 }
 
-function resolveOutboundProxyDir(): string | undefined {
-  // Compiled binary: outbound-proxy/ bundled adjacent to the CLI executable.
-  const binProxy = join(dirname(process.execPath), "outbound-proxy");
-  if (isOutboundProxySourceDir(binProxy)) {
-    return binProxy;
-  }
-
-  try {
-    const pkgPath = _require.resolve("@vellumai/outbound-proxy/package.json");
-    return dirname(pkgPath);
-  } catch {
-    return undefined;
-  }
-}
-
 function normalizeIngressUrl(value: unknown): string | undefined {
   if (typeof value !== "string") return undefined;
   const normalized = value.trim().replace(/\/+$/, "");
@@ -632,6 +662,9 @@ export async function startLocalDaemon(watch: boolean = false): Promise<void> {
         } else {
           console.log("   Assistant socket is responsive — skipping restart\n");
         }
+        // Ensure bun is available for runtime features (browser, skills install)
+        // even when reusing an existing daemon.
+        ensureBunInstalled();
         return;
       }
 
@@ -642,6 +675,9 @@ export async function startLocalDaemon(watch: boolean = false): Promise<void> {
 
       console.log("🔨 Starting assistant...");
 
+      // Ensure bun is available for runtime features (browser, skills install)
+      ensureBunInstalled();
+
       // Ensure ~/.vellum/ exists for PID/socket files
       mkdirSync(vellumDir, { recursive: true });
 
@@ -649,10 +685,12 @@ export async function startLocalDaemon(watch: boolean = false): Promise<void> {
       // macOS app the CLI inherits a huge environment (XPC_SERVICE_NAME,
       // __CFBundleIdentifier, CLAUDE_CODE_ENTRYPOINT, etc.) that can cause
       // the daemon to take 50+ seconds to start instead of ~1s.
+      const bunBinDir = join(homedir(), ".bun", "bin");
+      const basePath =
+        process.env.PATH || "/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin";
       const daemonEnv: Record<string, string> = {
         HOME: process.env.HOME || homedir(),
-        PATH:
-          process.env.PATH || "/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin",
+        PATH: `${bunBinDir}:${basePath}`,
         VELLUM_DAEMON_TCP_ENABLED: "1",
       };
       // Forward optional config env vars the daemon may need
@@ -674,14 +712,18 @@ export async function startLocalDaemon(watch: boolean = false): Promise<void> {
         }
       }
 
+      // Use fd inheritance instead of pipes so the daemon's stdout/stderr
+      // survive after the parent (hatch) exits. Bun does not ignore SIGPIPE,
+      // so piped stdio would kill the daemon on its first write after the
+      // parent closes.
       const daemonLogFd = openLogFile("hatch.log");
       const child = spawn(daemonBinary, [], {
         cwd: dirname(daemonBinary),
         detached: true,
-        stdio: ["ignore", "pipe", "pipe"],
+        stdio: ["ignore", daemonLogFd, daemonLogFd],
         env: daemonEnv,
       });
-      pipeToLogFile(child, daemonLogFd, "daemon");
+      if (typeof daemonLogFd === "number") closeSync(daemonLogFd);
       child.unref();
       const daemonPid = child.pid;
 
@@ -692,6 +734,13 @@ export async function startLocalDaemon(watch: boolean = false): Promise<void> {
       }
     }
 
+    // Ensure bun is available for runtime features (browser, skills install)
+    // Runs after daemon-reuse checks so the fast attach path is not blocked
+    // by a potentially slow bun install when the daemon is already alive.
+    if (daemonAlive) {
+      ensureBunInstalled();
+    }
+
     // Wait for socket at ~/.vellum/vellum.sock (up to 60s — fresh installs
     // may need 30-60s for Qdrant download, migrations, and first-time init)
     let socketReady = await waitForSocketFile(socketFile, 60000);
@@ -848,6 +897,11 @@ export async function startGateway(
     GATEWAY_RUNTIME_PROXY_REQUIRE_AUTH: "true",
     RUNTIME_PROXY_BEARER_TOKEN: runtimeProxyBearerToken,
     RUNTIME_HTTP_PORT: process.env.RUNTIME_HTTP_PORT || "7821",
+    // Skip the drain window for locally-launched gateways — there is no load
+    // balancer draining connections, so waiting serves no purpose and causes
+    // `vellum sleep` to SIGKILL the gateway when the CLI timeout is shorter
+    // than the drain window.  Respect an explicit env override.
+    GATEWAY_SHUTDOWN_DRAIN_MS: process.env.GATEWAY_SHUTDOWN_DRAIN_MS || "0",
   };
 
   if (process.env.GATEWAY_UNMAPPED_POLICY) {
@@ -883,13 +937,15 @@ export async function startGateway(
       );
     }
 
+    // Use fd inheritance (not pipes) so the gateway survives after the
+    // hatch CLI exits — Bun does not ignore SIGPIPE.
     const gatewayLogFd = openLogFile("hatch.log");
     gateway = spawn(gatewayBinary, [], {
       detached: true,
-      stdio: ["ignore", "pipe", "pipe"],
+      stdio: ["ignore", gatewayLogFd, gatewayLogFd],
       env: gatewayEnv,
     });
-    pipeToLogFile(gateway, gatewayLogFd, "gateway");
+    if (typeof gatewayLogFd === "number") closeSync(gatewayLogFd);
   } else {
     // Source tree / bunx: resolve the gateway source directory and run via bun.
     const gatewayDir = resolveGatewayDir();
@@ -900,10 +956,10 @@ export async function startGateway(
     gateway = spawn("bun", bunArgs, {
       cwd: gatewayDir,
       detached: true,
-      stdio: ["ignore", "pipe", "pipe"],
+      stdio: ["ignore", gwLogFd, gwLogFd],
       env: gatewayEnv,
     });
-    pipeToLogFile(gateway, gwLogFd, "gateway");
+    if (typeof gwLogFd === "number") closeSync(gwLogFd);
     if (watch) {
       console.log("   Gateway started in watch mode (bun --watch)");
     }
@@ -949,130 +1005,10 @@ export async function startGateway(
   return gatewayUrl;
 }
 
-export async function startOutboundProxy(
-  watch: boolean = false,
-): Promise<void> {
-  const proxyDir = resolveOutboundProxyDir();
-  if (!proxyDir) {
-    console.log("   ⚠️  Outbound proxy not found — skipping");
-    return;
-  }
-
-  console.log("🔒 Starting outbound proxy...");
-
-  const vellumDir = join(homedir(), ".vellum");
-  mkdirSync(vellumDir, { recursive: true });
-
-  const pidFile = join(vellumDir, "outbound-proxy.pid");
-
-  // Check if already running
-  if (existsSync(pidFile)) {
-    try {
-      const pid = parseInt(readFileSync(pidFile, "utf-8").trim(), 10);
-      if (!isNaN(pid)) {
-        try {
-          process.kill(pid, 0);
-          console.log(`   Outbound proxy already running (pid ${pid})\n`);
-          return;
-        } catch {
-          try {
-            unlinkSync(pidFile);
-          } catch {}
-        }
-      }
-    } catch {}
-  }
-
-  const proxyEnv: Record<string, string> = {
-    ...(process.env as Record<string, string>),
-    PROXY_PORT: process.env.PROXY_PORT || "7829",
-    PROXY_HEALTH_PORT: process.env.PROXY_HEALTH_PORT || "7828",
-  };
-
-  const proxyLogFd = openLogFile("hatch.log");
-
-  let proxy;
-  if (process.env.VELLUM_DESKTOP_APP && !watch) {
-    const proxyBinary = join(
-      dirname(process.execPath),
-      "vellum-outbound-proxy",
-    );
-    if (!existsSync(proxyBinary)) {
-      console.log(
-        "   ⚠️  Outbound proxy binary not found — falling back to source",
-      );
-      const bunArgs = watch
-        ? ["--watch", "run", "src/main.ts"]
-        : ["run", "src/main.ts"];
-      proxy = spawn("bun", bunArgs, {
-        cwd: proxyDir,
-        detached: true,
-        stdio: ["ignore", "pipe", "pipe"],
-        env: proxyEnv,
-      });
-    } else {
-      proxy = spawn(proxyBinary, [], {
-        detached: true,
-        stdio: ["ignore", "pipe", "pipe"],
-        env: proxyEnv,
-      });
-    }
-  } else {
-    const bunArgs = watch
-      ? ["--watch", "run", "src/main.ts"]
-      : ["run", "src/main.ts"];
-    proxy = spawn("bun", bunArgs, {
-      cwd: proxyDir,
-      detached: true,
-      stdio: ["ignore", "pipe", "pipe"],
-      env: proxyEnv,
-    });
-  }
-
-  pipeToLogFile(proxy, proxyLogFd, "outbound-proxy");
-  proxy.unref();
-
-  if (proxy.pid) {
-    writeFileSync(pidFile, String(proxy.pid), "utf-8");
-  }
-
-  if (watch) {
-    console.log("   Outbound proxy started in watch mode (bun --watch)");
-  }
-
-  // Wait for the health endpoint to respond
-  const healthPort = Number(process.env.PROXY_HEALTH_PORT) || 7828;
-  const start = Date.now();
-  const timeoutMs = 15000;
-  let ready = false;
-  while (Date.now() - start < timeoutMs) {
-    try {
-      const res = await fetch(`http://localhost:${healthPort}/healthz`, {
-        signal: AbortSignal.timeout(2000),
-      });
-      if (res.ok) {
-        ready = true;
-        break;
-      }
-    } catch {
-      // Not ready yet
-    }
-    await new Promise((r) => setTimeout(r, 250));
-  }
-
-  if (!ready) {
-    console.warn(
-      "   ⚠️  Outbound proxy started but health check did not respond within 15s",
-    );
-  }
-
-  console.log("✅ Outbound proxy started\n");
-}
-
 /**
- * Stop any locally-running daemon, gateway, and outbound-proxy processes
- * and clean up PID/socket files. Called when hatch fails partway through
- * so we don't leave orphaned processes with no lock file entry.
+ * Stop any locally-running daemon and gateway processes and clean up
+ * PID/socket files. Called when hatch fails partway through so we don't
+ * leave orphaned processes with no lock file entry.
  */
 export async function stopLocalProcesses(): Promise<void> {
   const vellumDir = join(homedir(), ".vellum");
@@ -1081,8 +1017,5 @@ export async function stopLocalProcesses(): Promise<void> {
   await stopProcessByPidFile(daemonPidFile, "daemon", [socketFile]);
 
   const gatewayPidFile = join(vellumDir, "gateway.pid");
-  await stopProcessByPidFile(gatewayPidFile, "gateway");
-
-  const outboundProxyPidFile = join(vellumDir, "outbound-proxy.pid");
-  await stopProcessByPidFile(outboundProxyPidFile, "outbound-proxy");
+  await stopProcessByPidFile(gatewayPidFile, "gateway", undefined, 7000);
 }

package/src/lib/process.ts

@@ -45,12 +45,13 @@ export function isProcessAlive(pidFile: string): {
 }
 
 /**
- * Stop a process by PID: SIGTERM, wait up to 2s, then SIGKILL if still alive.
+ * Stop a process by PID: SIGTERM, wait up to `timeoutMs`, then SIGKILL if still alive.
  * Returns true if the process was stopped, false if it wasn't alive.
  */
 export async function stopProcess(
   pid: number,
   label: string,
+  timeoutMs: number = 2000,
 ): Promise<boolean> {
   try {
     process.kill(pid, 0);
@@ -61,7 +62,7 @@ export async function stopProcess(
   console.log(`Stopping ${label} (pid ${pid})...`);
   process.kill(pid, "SIGTERM");
 
-  const deadline = Date.now() + 2000;
+  const deadline = Date.now() + timeoutMs;
   while (Date.now() < deadline) {
     try {
       process.kill(pid, 0);
@@ -90,6 +91,7 @@ export async function stopProcessByPidFile(
   pidFile: string,
   label: string,
   cleanupFiles?: string[],
+  timeoutMs?: number,
 ): Promise<boolean> {
   const { alive, pid } = isProcessAlive(pidFile);
 
@@ -129,7 +131,7 @@ export async function stopProcessByPidFile(
     return false;
   }
 
-  const stopped = await stopProcess(pid, label);
+  const stopped = await stopProcess(pid, label, timeoutMs);
 
   try {
     unlinkSync(pidFile);

package/src/lib/step-runner.ts

@@ -1,46 +1,5 @@
 import { spawn } from "child_process";
 
-const SPINNER_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
-
-interface Step {
-  name: string;
-  run: () => Promise<void>;
-}
-
-export function clearLine(): void {
-  process.stdout.write("\r\x1b[K");
-}
-
-export function showSpinner(name: string): NodeJS.Timeout {
-  let frameIndex = 0;
-  return setInterval(() => {
-    clearLine();
-    process.stdout.write(`  ${SPINNER_FRAMES[frameIndex]} ${name}...`);
-    frameIndex = (frameIndex + 1) % SPINNER_FRAMES.length;
-  }, 80);
-}
-
-export async function runSteps(steps: Step[]): Promise<void> {
-  for (let i = 0; i < steps.length; i++) {
-    const step = steps[i];
-    const label = `[${i + 1}/${steps.length}] ${step.name}`;
-
-    const spinner = showSpinner(label);
-
-    try {
-      await step.run();
-      clearInterval(spinner);
-      clearLine();
-      console.log(`  ✔ ${label}`);
-    } catch (error) {
-      clearInterval(spinner);
-      clearLine();
-      console.log(`  ✖ ${label}`);
-      throw error;
-    }
-  }
-}
-
 export function exec(
   command: string,
   args: string[],