@vellumai/cli 0.4.25 → 0.4.29

package/README.md

@@ -16,13 +16,13 @@ bun run ./src/index.ts <command> [options]
 
 ### Lifecycle: `ps`, `sleep`, `wake`
 
-Day-to-day process management for the daemon and gateway.
+Day-to-day process management for the assistant and gateway.
 
-| Command | Description |
-|---------|-------------|
-| `vellum ps` | List assistants and per-assistant process status (daemon, gateway PIDs and health). |
-| `vellum sleep` | Stop daemon and gateway processes. Directory-agnostic — works from anywhere. |
-| `vellum wake` | Start the daemon and gateway from the current checkout. |
+| Command        | Description                                                                            |
+| -------------- | -------------------------------------------------------------------------------------- |
+| `vellum ps`    | List assistants and per-assistant process status (assistant, gateway PIDs and health). |
+| `vellum sleep` | Stop assistant and gateway processes. Directory-agnostic — works from anywhere.        |
+| `vellum wake`  | Start the assistant and gateway from the current checkout.                             |
 
 ```bash
 # Start everything
@@ -47,36 +47,36 @@ vellum hatch [species] [options]
 
 #### Species
 
-| Species    | Description                                 |
-| ---------- | ------------------------------------------- |
+| Species    | Description                                       |
+| ---------- | ------------------------------------------------- |
 | `vellum`   | Default. Provisions the Vellum assistant runtime. |
-| `openclaw` | Provisions the OpenClaw runtime with gateway. |
+| `openclaw` | Provisions the OpenClaw runtime with gateway.     |
 
 #### Options
 
-| Option              | Description |
-| ------------------- | ----------- |
-| `-d`                | Detached mode. Start the instance in the background without watching startup progress. |
-| `--name <name>`     | Use a specific instance name instead of an auto-generated one. |
+| Option              | Description                                                                                    |
+| ------------------- | ---------------------------------------------------------------------------------------------- |
+| `-d`                | Detached mode. Start the instance in the background without watching startup progress.         |
+| `--name <name>`     | Use a specific instance name instead of an auto-generated one.                                 |
 | `--remote <target>` | Where to provision the instance. One of: `local`, `gcp`, `aws`, `custom`. Defaults to `local`. |
 
 #### Remote Targets
 
-- **`local`** -- Starts the local daemon and local gateway. Gateway source resolution order is: `VELLUM_GATEWAY_DIR` override, repo source tree, then installed `@vellumai/vellum-gateway` package.
+- **`local`** -- Starts the local assistant and local gateway. Gateway source resolution order is: `VELLUM_GATEWAY_DIR` override, repo source tree, then installed `@vellumai/vellum-gateway` package.
 - **`gcp`** -- Creates a GCP Compute Engine VM (`e2-standard-4`: 4 vCPUs, 16 GB) with a startup script that bootstraps the assistant. Requires `gcloud` authentication and `GCP_PROJECT` / `GCP_DEFAULT_ZONE` environment variables.
 - **`aws`** -- Provisions an AWS instance.
 - **`custom`** -- Provisions on an arbitrary SSH host. Set `VELLUM_CUSTOM_HOST` (e.g. `user@hostname`) to specify the target.
 
 #### Environment Variables
 
-| Variable              | Required For | Description |
-| --------------------- | ------------ | ----------- |
-| `ANTHROPIC_API_KEY`   | All             | Anthropic API key passed to the assistant runtime. |
-| `GCP_PROJECT`         | `gcp`        | GCP project ID. Falls back to the active `gcloud` project. |
-| `GCP_DEFAULT_ZONE`    | `gcp`        | GCP zone for the compute instance. |
-| `VELLUM_CUSTOM_HOST`  | `custom`     | SSH host in `user@hostname` format. |
-| `VELLUM_GATEWAY_DIR`  | `local`      | Optional absolute path to a local gateway source directory to run instead of the packaged gateway. |
-| `INGRESS_PUBLIC_BASE_URL` | `local` | Optional fallback public ingress URL when `ingress.publicBaseUrl` is not set in workspace config. |
+| Variable                  | Required For | Description                                                                                        |
+| ------------------------- | ------------ | -------------------------------------------------------------------------------------------------- |
+| `ANTHROPIC_API_KEY`       | All          | Anthropic API key passed to the assistant runtime.                                                 |
+| `GCP_PROJECT`             | `gcp`        | GCP project ID. Falls back to the active `gcloud` project.                                         |
+| `GCP_DEFAULT_ZONE`        | `gcp`        | GCP zone for the compute instance.                                                                 |
+| `VELLUM_CUSTOM_HOST`      | `custom`     | SSH host in `user@hostname` format.                                                                |
+| `VELLUM_GATEWAY_DIR`      | `local`      | Optional absolute path to a local gateway source directory to run instead of the packaged gateway. |
+| `INGRESS_PUBLIC_BASE_URL` | `local`      | Optional fallback public ingress URL when `ingress.publicBaseUrl` is not set in workspace config.  |
 
 #### Examples
 
@@ -111,8 +111,8 @@ The CLI looks up the instance by name in `~/.vellum.lock.json` and determines ho
 
 - **`gcp`** -- Deletes the GCP Compute Engine instance via `gcloud compute instances delete`.
 - **`aws`** -- Terminates the AWS EC2 instance by looking up the instance ID from its Name tag.
-- **`local`** -- Stops the local daemon (`bunx vellum daemon stop`) and removes the `~/.vellum` directory.
-- **`custom`** -- SSHs to the remote host to stop the daemon/gateway and remove the `~/.vellum` directory.
+- **`local`** -- Stops the local assistant (`vellum sleep`) and removes the `~/.vellum` directory.
+- **`custom`** -- SSHs to the remote host to stop the assistant/gateway and remove the `~/.vellum` directory.
 
 #### Examples
 

package/package.json

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

package/src/__tests__/assistant-config.test.ts

@@ -28,7 +28,11 @@ function writeLockfile(data: unknown): void {
   );
 }
 
-const makeEntry = (id: string, runtimeUrl = "http://localhost:7821", extra?: Partial<AssistantEntry>): AssistantEntry => ({
+const makeEntry = (
+  id: string,
+  runtimeUrl = "http://localhost:7821",
+  extra?: Partial<AssistantEntry>,
+): AssistantEntry => ({
   assistantId: id,
   runtimeUrl,
   cloud: "local",
@@ -103,9 +107,15 @@ describe("assistant-config", () => {
   test("loadLatestAssistant returns most recently hatched entry", () => {
     writeLockfile({
       assistants: [
-        makeEntry("old", "http://localhost:7821", { hatchedAt: "2024-01-01T00:00:00Z" }),
-        makeEntry("new", "http://localhost:7822", { hatchedAt: "2025-06-15T00:00:00Z" }),
-        makeEntry("mid", "http://localhost:7823", { hatchedAt: "2024-06-15T00:00:00Z" }),
+        makeEntry("old", "http://localhost:7821", {
+          hatchedAt: "2024-01-01T00:00:00Z",
+        }),
+        makeEntry("new", "http://localhost:7822", {
+          hatchedAt: "2025-06-15T00:00:00Z",
+        }),
+        makeEntry("mid", "http://localhost:7823", {
+          hatchedAt: "2024-06-15T00:00:00Z",
+        }),
       ],
     });
     const latest = loadLatestAssistant();
@@ -117,7 +127,9 @@ describe("assistant-config", () => {
     writeLockfile({
       assistants: [
         makeEntry("no-date"),
-        makeEntry("with-date", "http://localhost:7822", { hatchedAt: "2025-01-01T00:00:00Z" }),
+        makeEntry("with-date", "http://localhost:7822", {
+          hatchedAt: "2025-01-01T00:00:00Z",
+        }),
       ],
     });
     const latest = loadLatestAssistant();

package/src/__tests__/retire-archive.test.ts

@@ -13,11 +13,15 @@ describe("validateAssistantName", () => {
   });
 
   test("rejects names with forward slashes", () => {
-    expect(() => validateAssistantName("foo/bar")).toThrow("Invalid assistant name");
+    expect(() => validateAssistantName("foo/bar")).toThrow(
+      "Invalid assistant name",
+    );
   });
 
   test("rejects names with backslashes", () => {
-    expect(() => validateAssistantName("foo\\bar")).toThrow("Invalid assistant name");
+    expect(() => validateAssistantName("foo\\bar")).toThrow(
+      "Invalid assistant name",
+    );
   });
 
   test("rejects dot-dot traversal", () => {

package/src/adapters/openclaw-http-server.ts

@@ -13,7 +13,9 @@ interface StoredMessage {
 
 const messages: Record<string, StoredMessage[]> = {};
 
-function parseBody(req: http.IncomingMessage): Promise<Record<string, unknown>> {
+function parseBody(
+  req: http.IncomingMessage,
+): Promise<Record<string, unknown>> {
   return new Promise((resolve, reject) => {
     let body = "";
     req.on("data", (chunk: Buffer) => (body += chunk.toString()));
@@ -58,7 +60,8 @@ const server = http.createServer(async (req, res) => {
       child.unref();
       const responseBody = JSON.stringify({
         status: "success",
-        message: "HTTPS adapter installed and started. HTTP adapter shutting down.",
+        message:
+          "HTTPS adapter installed and started. HTTP adapter shutting down.",
       });
       res.writeHead(200);
       res.end(responseBody, () => {
@@ -96,7 +99,10 @@ const server = http.createServer(async (req, res) => {
       };
 
       const healthStr = JSON.stringify(health);
-      if (healthStr.includes("1006") || healthStr.includes("abnormal closure")) {
+      if (
+        healthStr.includes("1006") ||
+        healthStr.includes("abnormal closure")
+      ) {
         try {
           const gatewayOutput = execSync("openclaw gateway status", {
             encoding: "utf-8",
@@ -106,7 +112,9 @@ const server = http.createServer(async (req, res) => {
           result.message = `${result.message}\n\nGateway Status:\n${gatewayOutput.trim()}`;
         } catch (gatewayErr) {
           const gatewayErrMsg =
-            gatewayErr instanceof Error ? gatewayErr.message : String(gatewayErr);
+            gatewayErr instanceof Error
+              ? gatewayErr.message
+              : String(gatewayErr);
           result.message = `${result.message}\n\nGateway Status Error:\n${gatewayErrMsg}`;
         }
       }
@@ -121,7 +129,10 @@ const server = http.createServer(async (req, res) => {
         message: errorMessage,
       };
 
-      if (errorMessage.includes("1006") || errorMessage.includes("abnormal closure")) {
+      if (
+        errorMessage.includes("1006") ||
+        errorMessage.includes("abnormal closure")
+      ) {
         try {
           const gatewayOutput = execSync("openclaw gateway status", {
             encoding: "utf-8",
@@ -131,7 +142,9 @@ const server = http.createServer(async (req, res) => {
           result.message = `${result.message}\n\nGateway Status:\n${gatewayOutput.trim()}`;
         } catch (gatewayErr) {
           const gatewayErrMsg =
-            gatewayErr instanceof Error ? gatewayErr.message : String(gatewayErr);
+            gatewayErr instanceof Error
+              ? gatewayErr.message
+              : String(gatewayErr);
           result.message = `${result.message}\n\nGateway Status Error:\n${gatewayErrMsg}`;
         }
       }
@@ -144,7 +157,9 @@ const server = http.createServer(async (req, res) => {
     return;
   }
 
-  const messagesMatch = url.pathname.match(/^\/v1\/assistants\/([^/]+)\/messages$/);
+  const messagesMatch = url.pathname.match(
+    /^\/v1\/assistants\/([^/]+)\/messages$/,
+  );
   if (messagesMatch) {
     const assistantId = messagesMatch[1];
 

package/src/commands/autonomy.ts

@@ -29,26 +29,20 @@ const DEFAULT_AUTONOMY_CONFIG: AutonomyConfig = {
 // ---------------------------------------------------------------------------
 
 function getConfigPath(): string {
-  const root = join(
-    process.env.BASE_DATA_DIR?.trim() || homedir(),
-    ".vellum",
-  );
+  const root = join(process.env.BASE_DATA_DIR?.trim() || homedir(), ".vellum");
   return join(root, "workspace", "autonomy.json");
 }
 
 function isValidTier(value: unknown): value is AutonomyTier {
   return (
-    typeof value === "string" &&
-    AUTONOMY_TIERS.includes(value as AutonomyTier)
+    typeof value === "string" && AUTONOMY_TIERS.includes(value as AutonomyTier)
   );
 }
 
 function validateTierRecord(raw: unknown): Record<string, AutonomyTier> {
   if (!raw || typeof raw !== "object" || Array.isArray(raw)) return {};
   const result: Record<string, AutonomyTier> = {};
-  for (const [key, value] of Object.entries(
-    raw as Record<string, unknown>,
-  )) {
+  for (const [key, value] of Object.entries(raw as Record<string, unknown>)) {
     if (isValidTier(value)) {
       result[key] = value;
     }
@@ -186,7 +180,9 @@ function printUsage(): void {
   console.log("Usage: vellum autonomy <subcommand> [options]");
   console.log("");
   console.log("Subcommands:");
-  console.log("  get                              Show current autonomy configuration");
+  console.log(
+    "  get                              Show current autonomy configuration",
+  );
   console.log("  set --default <tier>             Set the global default tier");
   console.log("  set --channel <ch> --tier <t>    Set tier for a channel");
   console.log("  set --category <cat> --tier <t>  Set tier for a category");
@@ -254,7 +250,10 @@ export function autonomy(): void {
 
       if (!tier) {
         output(
-          { ok: false, error: "Missing --tier. Use --tier <auto|draft|notify>." },
+          {
+            ok: false,
+            error: "Missing --tier. Use --tier <auto|draft|notify>.",
+          },
           true,
         );
         process.exitCode = 1;

package/src/commands/client.ts

@@ -1,7 +1,10 @@
 import { readFileSync } from "fs";
 import { join } from "path";
 
-import { findAssistantByName, loadLatestAssistant } from "../lib/assistant-config";
+import {
+  findAssistantByName,
+  loadLatestAssistant,
+} from "../lib/assistant-config";
 import { GATEWAY_PORT, type Species } from "../lib/constants";
 
 const ANSI = {
@@ -33,7 +36,10 @@ function parseArgs(): ParsedArgs {
       printUsage();
       process.exit(0);
     } else if (
-      (arg === "--url" || arg === "-u" || arg === "--assistant-id" || arg === "-a") &&
+      (arg === "--url" ||
+        arg === "-u" ||
+        arg === "--assistant-id" ||
+        arg === "-a") &&
       args[i + 1]
     ) {
       flagArgs.push(arg, args[++i]);
@@ -42,20 +48,26 @@ function parseArgs(): ParsedArgs {
     }
   }
 
-  const entry = positionalName ? findAssistantByName(positionalName) : loadLatestAssistant();
+  const entry = positionalName
+    ? findAssistantByName(positionalName)
+    : loadLatestAssistant();
   if (positionalName && !entry) {
     console.error(`No assistant instance found with name '${positionalName}'.`);
     process.exit(1);
   }
 
-  let runtimeUrl = process.env.RUNTIME_URL || entry?.runtimeUrl || FALLBACK_RUNTIME_URL;
-  let assistantId = process.env.ASSISTANT_ID || entry?.assistantId || FALLBACK_ASSISTANT_ID;
-  let bearerToken = process.env.RUNTIME_PROXY_BEARER_TOKEN || entry?.bearerToken || undefined;
+  let runtimeUrl =
+    process.env.RUNTIME_URL || entry?.runtimeUrl || FALLBACK_RUNTIME_URL;
+  let assistantId =
+    process.env.ASSISTANT_ID || entry?.assistantId || FALLBACK_ASSISTANT_ID;
+  let bearerToken =
+    process.env.RUNTIME_PROXY_BEARER_TOKEN || entry?.bearerToken || undefined;
 
   // For local assistants, read the daemon's http-token file as a fallback
   // when the lockfile doesn't include a bearer token.
   if (!bearerToken && entry?.cloud === "local") {
-    const tokenDir = entry.baseDataDir ?? join(process.env.HOME ?? "", ".vellum");
+    const tokenDir =
+      entry.baseDataDir ?? join(process.env.HOME ?? "", ".vellum");
     try {
       const token = readFileSync(join(tokenDir, "http-token"), "utf-8").trim();
       if (token) bearerToken = token;
@@ -69,7 +81,10 @@ function parseArgs(): ParsedArgs {
     const flag = flagArgs[i];
     if ((flag === "--url" || flag === "-u") && flagArgs[i + 1]) {
       runtimeUrl = flagArgs[++i];
-    } else if ((flag === "--assistant-id" || flag === "-a") && flagArgs[i + 1]) {
+    } else if (
+      (flag === "--assistant-id" || flag === "-a") &&
+      flagArgs[i + 1]
+    ) {
       assistantId = flagArgs[++i];
     }
   }
@@ -111,7 +126,8 @@ ${ANSI.bold}EXAMPLES:${ANSI.reset}
 }
 
 export async function client(): Promise<void> {
-  const { runtimeUrl, assistantId, species, bearerToken, project, zone } = parseArgs();
+  const { runtimeUrl, assistantId, species, bearerToken, project, zone } =
+    parseArgs();
 
   const { renderChatApp } = await import("../components/DefaultMainScreen");
 

package/src/commands/config.ts

@@ -63,9 +63,7 @@ function validateAllowlistFile(): AllowlistValidationError[] | null {
   if (!existsSync(filePath)) return null;
 
   const raw = readFileSync(filePath, "utf-8");
-  const allowlistConfig: AllowlistConfig = JSON.parse(
-    raw,
-  ) as AllowlistConfig;
+  const allowlistConfig: AllowlistConfig = JSON.parse(raw) as AllowlistConfig;
   return validateAllowlist(allowlistConfig);
 }
 
@@ -79,9 +77,7 @@ function printUsage(): void {
   console.log(
     "  set <key> <value>      Set a config value (supports dotted paths like apiKeys.anthropic)",
   );
-  console.log(
-    "  list                   List all config values",
-  );
+  console.log("  list                   List all config values");
   console.log(
     "  validate-allowlist     Validate regex patterns in secret-allowlist.json",
   );

package/src/commands/contacts.ts

@@ -55,10 +55,7 @@ async function apiGet(path: string): Promise<unknown> {
   return response.json();
 }
 
-async function apiPost(
-  path: string,
-  body: unknown,
-): Promise<unknown> {
+async function apiPost(path: string, body: unknown): Promise<unknown> {
   const url = `${getGatewayUrl()}/v1/${path}`;
   const response = await fetch(url, {
     method: "POST",