@vellumai/cli 0.4.25 → 0.4.29

package/src/index.ts

@@ -97,10 +97,10 @@ async function main() {
     );
     console.log("  recover  Restore a previously retired local assistant");
     console.log("  retire   Delete an assistant instance");
-    console.log("  sleep    Stop the daemon process");
+    console.log("  sleep    Stop the assistant process");
     console.log("  ssh      SSH into a remote assistant instance");
     console.log("  tunnel   Create a tunnel for a locally hosted assistant");
-    console.log("  wake     Start the daemon and gateway");
+    console.log("  wake     Start the assistant and gateway");
     console.log("  whoami   Show current logged-in user");
     process.exit(0);
   }

package/src/lib/assistant-config.ts

@@ -61,7 +61,8 @@ function readAssistants(): AssistantEntry[] {
     return [];
   }
   return entries.filter(
-    (e) => typeof e.assistantId === "string" && typeof e.runtimeUrl === "string",
+    (e) =>
+      typeof e.assistantId === "string" && typeof e.runtimeUrl === "string",
   );
 }
 
@@ -99,7 +100,9 @@ export function loadAllAssistants(): AssistantEntry[] {
 }
 
 export function saveAssistantEntry(entry: AssistantEntry): void {
-  const entries = readAssistants().filter((e) => e.assistantId !== entry.assistantId);
+  const entries = readAssistants().filter(
+    (e) => e.assistantId !== entry.assistantId,
+  );
   entries.unshift(entry);
   writeAssistants(entries);
 }
@@ -114,7 +117,10 @@ export function syncConfigToLockfile(): void {
   if (!existsSync(configPath)) return;
 
   try {
-    const raw = JSON.parse(readFileSync(configPath, "utf-8")) as Record<string, unknown>;
+    const raw = JSON.parse(readFileSync(configPath, "utf-8")) as Record<
+      string,
+      unknown
+    >;
     const platform = raw.platform as Record<string, unknown> | undefined;
     const data = readLockfile();
     data.platformBaseUrl = (platform?.baseUrl as string) || undefined;

package/src/lib/aws.ts

@@ -43,7 +43,9 @@ export async function getDefaultVpcId(region: string): Promise<string> {
   ]);
   const vpcId = output.trim();
   if (!vpcId || vpcId === "None") {
-    throw new Error("No default VPC found. Please create a default VPC or specify one.");
+    throw new Error(
+      "No default VPC found. Please create a default VPC or specify one.",
+    );
   }
   return vpcId;
 }
@@ -342,15 +344,25 @@ async function pollAwsInstance(
     const output = await awsSshExec(ip, keyPath, remoteCmd);
     const sepIdx = output.indexOf("===HATCH_SEP===");
     if (sepIdx === -1) {
-      return { lastLine: output.trim() || null, done: false, failed: false, errorContent: "" };
+      return {
+        lastLine: output.trim() || null,
+        done: false,
+        failed: false,
+        errorContent: "",
+      };
     }
     const errIdx = output.indexOf("===HATCH_ERR===");
     const lastLine = output.substring(0, sepIdx).trim() || null;
     const statusEnd = errIdx === -1 ? undefined : errIdx;
-    const status = output.substring(sepIdx + "===HATCH_SEP===".length, statusEnd).trim();
+    const status = output
+      .substring(sepIdx + "===HATCH_SEP===".length, statusEnd)
+      .trim();
     const errorContent =
-      errIdx === -1 ? "" : output.substring(errIdx + "===HATCH_ERR===".length).trim();
-    const done = lastLine !== null && status !== "running" && status !== "pending";
+      errIdx === -1
+        ? ""
+        : output.substring(errIdx + "===HATCH_ERR===".length).trim();
+    const done =
+      lastLine !== null && status !== "running" && status !== "pending";
     const failed = errorContent.length > 0 || status === "error";
     return { lastLine, done, failed, errorContent };
   } catch {
@@ -394,7 +406,9 @@ export async function hatchAws(
       }
     } else {
       while (await instanceExistsByName(instanceName, region)) {
-        console.log(`\u26a0\ufe0f  Instance name ${instanceName} already exists, generating a new name...`);
+        console.log(
+          `\u26a0\ufe0f  Instance name ${instanceName} already exists, generating a new name...`,
+        );
         const suffix = generateRandomSuffix();
         instanceName = `${species}-${suffix}`;
       }
@@ -405,7 +419,9 @@ export async function hatchAws(
     const hatchedBy = process.env.VELLUM_HATCHED_BY;
     const anthropicApiKey = process.env.ANTHROPIC_API_KEY;
     if (!anthropicApiKey) {
-      console.error("Error: ANTHROPIC_API_KEY environment variable is not set.");
+      console.error(
+        "Error: ANTHROPIC_API_KEY environment variable is not set.",
+      );
       process.exit(1);
     }
 
@@ -464,7 +480,9 @@ export async function hatchAws(
     try {
       externalIp = await getInstancePublicIp(instanceId, region);
     } catch {
-      console.log("\u26a0\ufe0f  Could not retrieve external IP yet (instance may still be starting)");
+      console.log(
+        "\u26a0\ufe0f  Could not retrieve external IP yet (instance may still be starting)",
+      );
     }
 
     const runtimeUrl = externalIp
@@ -518,7 +536,9 @@ export async function hatchAws(
           process.exit(1);
         }
       } else {
-        console.log("\u26a0\ufe0f  No external IP available for monitoring. Instance is still running.");
+        console.log(
+          "\u26a0\ufe0f  No external IP available for monitoring. Instance is still running.",
+        );
         console.log(`   Monitor with: vel logs ${instanceName}`);
         console.log("");
       }
@@ -532,7 +552,10 @@ export async function hatchAws(
       }
     }
   } catch (error) {
-    console.error("\u274c Error:", error instanceof Error ? error.message : error);
+    console.error(
+      "\u274c Error:",
+      error instanceof Error ? error.message : error,
+    );
     process.exit(1);
   }
 }
@@ -610,7 +633,9 @@ export async function retireInstance(
     }
   }
 
-  console.log(`\u{1F5D1}\ufe0f  Terminating AWS instance ${name} (${instanceId})\n`);
+  console.log(
+    `\u{1F5D1}\ufe0f  Terminating AWS instance ${name} (${instanceId})\n`,
+  );
 
   await exec("aws", [
     "ec2",

package/src/lib/constants.ts

@@ -1,5 +1,7 @@
 export const FIREWALL_TAG = "vellum-assistant";
-export const GATEWAY_PORT = process.env.GATEWAY_PORT ? Number(process.env.GATEWAY_PORT) : 7830;
+export const GATEWAY_PORT = process.env.GATEWAY_PORT
+  ? Number(process.env.GATEWAY_PORT)
+  : 7830;
 export const VALID_REMOTE_HOSTS = ["local", "gcp", "aws", "custom"] as const;
 export type RemoteHost = (typeof VALID_REMOTE_HOSTS)[number];
 export const VALID_SPECIES = ["openclaw", "vellum"] as const;

package/src/lib/doctor-client.ts

@@ -1,6 +1,9 @@
 const DOCTOR_URL = process.env.DOCTOR_URL || "https://doctor.vellum.ai";
 
-export type ProgressPhase= "invoking_prompt" | "calling_tool" | "processing_tool_result";
+export type ProgressPhase =
+  | "invoking_prompt"
+  | "calling_tool"
+  | "processing_tool_result";
 
 export interface ProgressEvent {
   phase: ProgressPhase;
@@ -48,7 +51,10 @@ async function streamDoctorResponse(
 
       for (const line of lines) {
         if (!line.trim()) continue;
-        const parsed = JSON.parse(line) as { type: string } & Record<string, unknown>;
+        const parsed = JSON.parse(line) as { type: string } & Record<
+          string,
+          unknown
+        >;
         receivedEventTypes.push(parsed.type);
         if (parsed.type === "progress") {
           onProgress?.(parsed as unknown as ProgressEvent);
@@ -60,7 +66,8 @@ async function streamDoctorResponse(
       }
     }
   } catch (streamErr) {
-    const detail = streamErr instanceof Error ? streamErr.message : String(streamErr);
+    const detail =
+      streamErr instanceof Error ? streamErr.message : String(streamErr);
     throw new Error(
       `Doctor stream interrupted after ${chunkCount} chunks ` +
         `(received events: [${receivedEventTypes.join(", ")}]): ${detail}`,
@@ -68,7 +75,10 @@ async function streamDoctorResponse(
   }
 
   if (buffer.trim()) {
-    const parsed = JSON.parse(buffer) as { type: string } & Record<string, unknown>;
+    const parsed = JSON.parse(buffer) as { type: string } & Record<
+      string,
+      unknown
+    >;
     receivedEventTypes.push(parsed.type);
     if (parsed.type === "result") {
       result = parsed as unknown as DoctorResult;
@@ -105,14 +115,20 @@ async function callDoctorDaemon(
       const response = await fetch(`${DOCTOR_URL}/doctor`, {
         method: "POST",
         headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({ assistantId, project, zone, userPrompt, sessionId, chatContext }),
+        body: JSON.stringify({
+          assistantId,
+          project,
+          zone,
+          userPrompt,
+          sessionId,
+          chatContext,
+        }),
       });
       return await streamDoctorResponse(response, onProgress, onLog);
     } catch (err) {
       lastError = err;
       const errMsg = err instanceof Error ? err.message : String(err);
-      const logMsg =
-        `[doctor-client] Attempt ${attempt + 1}/${MAX_RETRIES} failed: ${errMsg}`;
+      const logMsg = `[doctor-client] Attempt ${attempt + 1}/${MAX_RETRIES} failed: ${errMsg}`;
       onLog?.(logMsg);
       if (attempt < MAX_RETRIES - 1) {
         await new Promise((resolve) => setTimeout(resolve, 500));

package/src/lib/gcp.ts

@@ -11,11 +11,7 @@ import { generateRandomSuffix } from "./random-name";
 import { exec, execOutput } from "./step-runner";
 
 export async function getActiveProject(): Promise<string> {
-  const output = await execOutput("gcloud", [
-    "config",
-    "get-value",
-    "project",
-  ]);
+  const output = await execOutput("gcloud", ["config", "get-value", "project"]);
   const project = output.trim();
   if (!project || project === "(unset)") {
     throw new Error(
@@ -87,7 +83,10 @@ async function describeFirewallRule(
   }
 }
 
-function ruleNeedsUpdate(spec: FirewallRuleSpec, state: FirewallRuleState): boolean {
+function ruleNeedsUpdate(
+  spec: FirewallRuleSpec,
+  state: FirewallRuleState,
+): boolean {
   return (
     spec.direction !== state.direction ||
     spec.rules !== state.allowed ||
@@ -98,7 +97,11 @@ function ruleNeedsUpdate(spec: FirewallRuleSpec, state: FirewallRuleState): bool
   );
 }
 
-async function createFirewallRule(spec: FirewallRuleSpec, project: string, account?: string): Promise<void> {
+async function createFirewallRule(
+  spec: FirewallRuleSpec,
+  project: string,
+  account?: string,
+): Promise<void> {
   const args = [
     "compute",
     "firewall-rules",
@@ -121,7 +124,11 @@ async function createFirewallRule(spec: FirewallRuleSpec, project: string, accou
   await exec("gcloud", args);
 }
 
-async function deleteFirewallRule(ruleName: string, project: string, account?: string): Promise<void> {
+async function deleteFirewallRule(
+  ruleName: string,
+  project: string,
+  account?: string,
+): Promise<void> {
   const args = [
     "compute",
     "firewall-rules",
@@ -151,7 +158,10 @@ export async function syncFirewallRules(
     ];
     if (account) listArgs.push(`--account=${account}`);
     const output = await execOutput("gcloud", listArgs);
-    const allRules = JSON.parse(output) as Array<{ name: string; targetTags?: string[] }>;
+    const allRules = JSON.parse(output) as Array<{
+      name: string;
+      targetTags?: string[];
+    }>;
     existingNames = allRules
       .filter((r) => r.targetTags?.includes(tag))
       .map((r) => r.name);
@@ -211,7 +221,9 @@ export interface GcpInstance {
   species: string | null;
 }
 
-export async function listAssistantInstances(project: string): Promise<GcpInstance[]> {
+export async function listAssistantInstances(
+  project: string,
+): Promise<GcpInstance[]> {
   const output = await execOutput("gcloud", [
     "compute",
     "instances",
@@ -231,7 +243,8 @@ export async function listAssistantInstances(project: string): Promise<GcpInstan
     return {
       name: inst.name,
       zone: zoneParts[zoneParts.length - 1] || "",
-      externalIp: inst.networkInterfaces?.[0]?.accessConfigs?.[0]?.natIP ?? null,
+      externalIp:
+        inst.networkInterfaces?.[0]?.accessConfigs?.[0]?.natIP ?? null,
       species: inst.labels?.species ?? null,
     };
   });
@@ -258,7 +271,10 @@ export async function instanceExists(
     return true;
   } catch (error) {
     const msg = error instanceof Error ? error.message.toLowerCase() : "";
-    if (msg.includes("was not found") || msg.includes("could not fetch resource")) {
+    if (
+      msg.includes("was not found") ||
+      msg.includes("could not fetch resource")
+    ) {
       return false;
     }
     throw error;
@@ -407,15 +423,25 @@ async function pollInstance(
     const output = await execOutput("gcloud", args);
     const sepIdx = output.indexOf("===HATCH_SEP===");
     if (sepIdx === -1) {
-      return { lastLine: output.trim() || null, done: false, failed: false, errorContent: "" };
+      return {
+        lastLine: output.trim() || null,
+        done: false,
+        failed: false,
+        errorContent: "",
+      };
     }
     const errIdx = output.indexOf("===HATCH_ERR===");
     const lastLine = output.substring(0, sepIdx).trim() || null;
     const statusEnd = errIdx === -1 ? undefined : errIdx;
-    const status = output.substring(sepIdx + "===HATCH_SEP===".length, statusEnd).trim();
+    const status = output
+      .substring(sepIdx + "===HATCH_SEP===".length, statusEnd)
+      .trim();
     const errorContent =
-      errIdx === -1 ? "" : output.substring(errIdx + "===HATCH_ERR===".length).trim();
-    const done = lastLine !== null && status !== "active" && status !== "activating";
+      errIdx === -1
+        ? ""
+        : output.substring(errIdx + "===HATCH_ERR===".length).trim();
+    const done =
+      lastLine !== null && status !== "active" && status !== "activating";
     const failed = errorContent.length > 0 || status === "failed";
     return { lastLine, done, failed, errorContent };
   } catch {
@@ -483,7 +509,9 @@ async function recoverFromCurlFailure(
   if (account) sshArgs.push(`--account=${account}`);
   console.log("\ud83d\udd27 Running install script on instance...");
   await exec("gcloud", sshArgs);
-  try { unlinkSync(installScriptPath); } catch {}
+  try {
+    unlinkSync(installScriptPath);
+  } catch {}
 }
 
 export async function hatchGcp(
@@ -542,7 +570,9 @@ export async function hatchGcp(
       }
     } else {
       while (await instanceExists(instanceName, project, zone, account)) {
-        console.log(`\u26a0\ufe0f  Instance name ${instanceName} already exists, generating a new name...`);
+        console.log(
+          `\u26a0\ufe0f  Instance name ${instanceName} already exists, generating a new name...`,
+        );
         const suffix = generateRandomSuffix();
         instanceName = `${species}-${suffix}`;
       }
@@ -553,7 +583,9 @@ export async function hatchGcp(
     const hatchedBy = process.env.VELLUM_HATCHED_BY;
     const anthropicApiKey = process.env.ANTHROPIC_API_KEY;
     if (!anthropicApiKey) {
-      console.error("Error: ANTHROPIC_API_KEY environment variable is not set.");
+      console.error(
+        "Error: ANTHROPIC_API_KEY environment variable is not set.",
+      );
       process.exit(1);
     }
     const startupScript = await buildStartupScript(
@@ -596,7 +628,12 @@ export async function hatchGcp(
     }
 
     console.log("\ud83d\udd12 Syncing firewall rules...");
-    await syncFirewallRules(DESIRED_FIREWALL_RULES, project, FIREWALL_TAG, account);
+    await syncFirewallRules(
+      DESIRED_FIREWALL_RULES,
+      project,
+      FIREWALL_TAG,
+      account,
+    );
 
     console.log(`\u2705 Instance ${instanceName} created successfully\n`);
 
@@ -615,7 +652,9 @@ export async function hatchGcp(
       const ipOutput = await execOutput("gcloud", describeArgs);
       externalIp = ipOutput.trim() || null;
     } catch {
-      console.log("\u26a0\ufe0f  Could not retrieve external IP yet (instance may still be starting)");
+      console.log(
+        "\u26a0\ufe0f  Could not retrieve external IP yet (instance may still be starting)",
+      );
     }
 
     const runtimeUrl = externalIp
@@ -672,8 +711,16 @@ export async function hatchGcp(
           (await checkCurlFailure(instanceName, project, zone, account))
         ) {
           const installScriptUrl = `${process.env.VELLUM_ASSISTANT_PLATFORM_URL ?? "https://assistant.vellum.ai"}/install.sh`;
-          console.log(`\ud83d\udd04 Detected install script curl failure for ${installScriptUrl}, attempting recovery...`);
-          await recoverFromCurlFailure(instanceName, project, zone, sshUser, account);
+          console.log(
+            `\ud83d\udd04 Detected install script curl failure for ${installScriptUrl}, attempting recovery...`,
+          );
+          await recoverFromCurlFailure(
+            instanceName,
+            project,
+            zone,
+            sshUser,
+            account,
+          );
           console.log("\u2705 Recovery successful!");
         } else {
           process.exit(1);
@@ -689,7 +736,10 @@ export async function hatchGcp(
       }
     }
   } catch (error) {
-    console.error("\u274c Error:", error instanceof Error ? error.message : error);
+    console.error(
+      "\u274c Error:",
+      error instanceof Error ? error.message : error,
+    );
     process.exit(1);
   }
 }

package/src/lib/health-check.ts

@@ -10,11 +10,16 @@ export interface HealthCheckResult {
   detail: string | null;
 }
 
-export async function checkHealth(runtimeUrl: string): Promise<HealthCheckResult> {
+export async function checkHealth(
+  runtimeUrl: string,
+): Promise<HealthCheckResult> {
   try {
     const url = `${runtimeUrl}/healthz`;
     const controller = new AbortController();
-    const timeoutId = setTimeout(() => controller.abort(), HEALTH_CHECK_TIMEOUT_MS);
+    const timeoutId = setTimeout(
+      () => controller.abort(),
+      HEALTH_CHECK_TIMEOUT_MS,
+    );
 
     const response = await fetch(url, {
       signal: controller.signal,
@@ -29,10 +34,15 @@ export async function checkHealth(runtimeUrl: string): Promise<HealthCheckResult
 
     const data = (await response.json()) as HealthResponse;
     const status = data.status || "unknown";
-    return { status, detail: status !== "healthy" ? (data.message ?? null) : null };
+    return {
+      status,
+      detail: status !== "healthy" ? (data.message ?? null) : null,
+    };
   } catch (error) {
     const status =
-      error instanceof Error && error.name === "AbortError" ? "timeout" : "unreachable";
+      error instanceof Error && error.name === "AbortError"
+        ? "timeout"
+        : "unreachable";
     return { status, detail: null };
   }
 }