@vellumai/cli 0.1.11 → 0.1.13

package/bun.lock

@@ -7,6 +7,7 @@
       "dependencies": {
         "ink": "^6.7.0",
         "react": "^19.2.4",
+        "react-devtools-core": "^6.1.2",
       },
       "devDependencies": {
         "@types/bun": "^1.2.4",
@@ -218,6 +219,8 @@
 
     "react": ["react@19.2.4", "", {}, "sha512-9nfp2hYpCwOjAN+8TZFGhtWEwgvWHXqESH8qT89AT/lWklpLON22Lc8pEtnpsZz7VmawabSU0gCjnj8aC0euHQ=="],
 
+    "react-devtools-core": ["react-devtools-core@6.1.5", "", { "dependencies": { "shell-quote": "^1.6.1", "ws": "^7" } }, "sha512-ePrwPfxAnB+7hgnEr8vpKxL9cmnp7F322t8oqcPshbIQQhDKgFDW4tjhF2wjVbdXF9O/nyuy3sQWd9JGpiLPvA=="],
+
     "react-reconciler": ["react-reconciler@0.33.0", "", { "dependencies": { "scheduler": "^0.27.0" }, "peerDependencies": { "react": "^19.2.0" } }, "sha512-KetWRytFv1epdpJc3J4G75I4WrplZE5jOL7Yq0p34+OVOKF4Se7WrdIdVC45XsSSmUTlht2FM/fM1FZb1mfQeA=="],
 
     "restore-cursor": ["restore-cursor@4.0.0", "", { "dependencies": { "onetime": "^5.1.0", "signal-exit": "^3.0.2" } }, "sha512-I9fPXU9geO9bHOt9pHHOhOkYerIMsmVaWB0rA2AI9ERh/+x/i7MV5HKBNrg+ljO5eoPVgCcnFuRjJ9uH6I/3eg=="],
@@ -230,6 +233,8 @@
 
     "shebang-regex": ["shebang-regex@3.0.0", "", {}, "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A=="],
 
+    "shell-quote": ["shell-quote@1.8.3", "", {}, "sha512-ObmnIF4hXNg1BqhnHmgbDETF8dLPCggZWBjkQfhZpbszZnYur5DUljTcCHii5LC3J5E0yeO/1LIMyH+UvHQgyw=="],
+
     "signal-exit": ["signal-exit@3.0.7", "", {}, "sha512-wnD2ZE+l+SPC/uoS0vXeE9L1+0wuaMqKlfz9AMUo38JsyLSBWSFcHR1Rri62LZc12vLr1gb3jl7iwQhgwpAbGQ=="],
 
     "slice-ansi": ["slice-ansi@7.1.2", "", { "dependencies": { "ansi-styles": "^6.2.1", "is-fullwidth-code-point": "^5.0.0" } }, "sha512-iOBWFgUX7caIZiuutICxVgX1SdxwAVFFKwt1EvMYYec/NWO5meOJ6K5uQxhrYBdQJne4KxiqZc+KptFOWFSI9w=="],
@@ -280,6 +285,8 @@
 
     "@typescript-eslint/typescript-estree/minimatch": ["minimatch@9.0.5", "", { "dependencies": { "brace-expansion": "^2.0.1" } }, "sha512-G6T0ZX48xgozx7587koeX9Ys2NYy6Gmv//P89sEte9V9whIapMNF4idKxnW2QtCcLiTWlb/wfCabAtAFWhhBow=="],
 
+    "react-devtools-core/ws": ["ws@7.5.10", "", { "peerDependencies": { "bufferutil": "^4.0.1", "utf-8-validate": "^5.0.2" }, "optionalPeers": ["bufferutil", "utf-8-validate"] }, "sha512-+dbF1tHwZpXcbOJdVOkzLDxZP1ailvSxM6ZweXTegylPny803bFhA+vqBYw4s31NSAk4S2Qz+AKXK9a4wkdjcQ=="],
+
     "stack-utils/escape-string-regexp": ["escape-string-regexp@2.0.0", "", {}, "sha512-UpzcLCXolUWcNu5HtVMHYdXJjArjsF9C0aNnquZYY4uW/Vu0miy5YoWvbV345HauVvcAUnpRuhMMcqTcGOY2+w=="],
 
     "wrap-ansi/string-width": ["string-width@7.2.0", "", { "dependencies": { "emoji-regex": "^10.3.0", "get-east-asian-width": "^1.0.0", "strip-ansi": "^7.1.0" } }, "sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ=="],

package/package.json

@@ -1,8 +1,14 @@
 {
   "name": "@vellumai/cli",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "description": "CLI tools for vellum-assistant",
   "type": "module",
+  "exports": {
+    ".": "./src/index.ts",
+    "./package.json": "./package.json",
+    "./src/components/DefaultMainScreen": "./src/components/DefaultMainScreen.tsx",
+    "./src/lib/constants": "./src/lib/constants.ts"
+  },
   "bin": {
     "vellum-cli": "./src/index.ts"
   },
@@ -14,7 +20,8 @@
   "license": "MIT",
   "dependencies": {
     "ink": "^6.7.0",
-    "react": "^19.2.4"
+    "react": "^19.2.4",
+    "react-devtools-core": "^6.1.2"
   },
   "devDependencies": {
     "@types/bun": "^1.2.4",

package/src/commands/client.ts

@@ -0,0 +1,110 @@
+import { ANSI, renderChatApp } from "../components/DefaultMainScreen";
+import { findAssistantByName, loadLatestAssistant } from "../lib/assistant-config";
+import { GATEWAY_PORT, type Species } from "../lib/constants";
+
+const FALLBACK_RUNTIME_URL = `http://127.0.0.1:${GATEWAY_PORT}`;
+const FALLBACK_ASSISTANT_ID = "default";
+
+interface ParsedArgs {
+  runtimeUrl: string;
+  assistantId: string;
+  species: Species;
+  bearerToken?: string;
+  project?: string;
+  zone?: string;
+}
+
+function parseArgs(): ParsedArgs {
+  const args = process.argv.slice(3);
+
+  let positionalName: string | undefined;
+  const flagArgs: string[] = [];
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (arg === "--help" || arg === "-h") {
+      printUsage();
+      process.exit(0);
+    } else if (
+      (arg === "--url" || arg === "-u" || arg === "--assistant-id" || arg === "-a") &&
+      args[i + 1]
+    ) {
+      flagArgs.push(arg, args[++i]);
+    } else if (!arg.startsWith("-") && positionalName === undefined) {
+      positionalName = arg;
+    }
+  }
+
+  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;
+  const bearerToken = process.env.RUNTIME_PROXY_BEARER_TOKEN || entry?.bearerToken || undefined;
+  const species: Species = (entry?.species as Species) ?? "vellum";
+
+  for (let i = 0; i < flagArgs.length; i++) {
+    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]) {
+      assistantId = flagArgs[++i];
+    }
+  }
+
+  return {
+    runtimeUrl: runtimeUrl.replace(/\/+$/, ""),
+    assistantId,
+    species,
+    bearerToken,
+    project: entry?.project,
+    zone: entry?.zone,
+  };
+}
+
+function printUsage(): void {
+  console.log(`${ANSI.bold}vellum-cli client${ANSI.reset} - Connect to a hatched assistant
+
+${ANSI.bold}USAGE:${ANSI.reset}
+    vellum-cli client [name] [options]
+
+${ANSI.bold}ARGUMENTS:${ANSI.reset}
+    [name]                     Instance name (default: latest)
+
+${ANSI.bold}OPTIONS:${ANSI.reset}
+    -u, --url <url>            Runtime URL
+    -a, --assistant-id <id>    Assistant ID
+    -h, --help                 Show this help message
+
+${ANSI.bold}DEFAULTS:${ANSI.reset}
+    Reads from ~/.vellum.lock.json (created by vellum-cli hatch).
+    Override with flags above or env vars RUNTIME_URL / ASSISTANT_ID.
+
+${ANSI.bold}EXAMPLES:${ANSI.reset}
+    vellum-cli client
+    vellum-cli client vellum-assistant-foo
+    vellum-cli client --url http://34.56.78.90:${GATEWAY_PORT}
+    vellum-cli client vellum-assistant-foo --url http://localhost:${GATEWAY_PORT}
+`);
+}
+
+export async function client(): Promise<void> {
+  const { runtimeUrl, assistantId, species, bearerToken, project, zone } = parseArgs();
+
+  process.stdout.write("\x1b[2J\x1b[H");
+
+  const app = renderChatApp(
+    runtimeUrl,
+    assistantId,
+    species,
+    () => {
+      app.unmount();
+      process.stdout.write("\x1b[2J\x1b[H");
+      console.log(`${ANSI.dim}Disconnected.${ANSI.reset}`);
+      process.exit(0);
+    },
+    { bearerToken, project, zone },
+  );
+}

package/src/commands/hatch.ts

@@ -17,7 +17,6 @@ import {
 import type { RemoteHost, Species } from "../lib/constants";
 import { hatchGcp } from "../lib/gcp";
 import type { PollResult, WatchHatchingResult } from "../lib/gcp";
-import { buildInterfacesSeed } from "../lib/interfaces-seed";
 import { startLocalDaemon, startGateway } from "../lib/local";
 import { generateRandomSuffix } from "../lib/random-name";
 import { exec } from "../lib/step-runner";
@@ -42,6 +41,12 @@ const DEFAULT_SPECIES: Species = "vellum";
 
 const SPINNER_FRAMES= ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
 
+const IS_DESKTOP = !!process.env.VELLUM_DESKTOP_APP;
+
+function desktopLog(msg: string): void {
+  process.stdout.write(msg + "\n");
+}
+
 function buildTimestampRedirect(): string {
   return `exec > >(while IFS= read -r line; do printf '[%s] %s\\n' "$(date -u '+%Y-%m-%dT%H:%M:%SZ')" "$line"; done > /var/log/startup-script.log) 2>&1`;
 }
@@ -88,8 +93,6 @@ export async function buildStartupScript(
     );
   }
 
-  const interfacesSeed = await buildInterfacesSeed();
-
   return `#!/bin/bash
 set -e
 
@@ -102,13 +105,11 @@ GATEWAY_RUNTIME_PROXY_ENABLED=true
 RUNTIME_PROXY_BEARER_TOKEN=${bearerToken}
 VELLUM_ASSISTANT_NAME=${instanceName}
 VELLUM_CLOUD=${cloud}
-${interfacesSeed}
 mkdir -p "\$HOME/.vellum"
 cat > "\$HOME/.vellum/.env" << DOTENV_EOF
 ANTHROPIC_API_KEY=\$ANTHROPIC_API_KEY
 GATEWAY_RUNTIME_PROXY_ENABLED=\$GATEWAY_RUNTIME_PROXY_ENABLED
 RUNTIME_PROXY_BEARER_TOKEN=\$RUNTIME_PROXY_BEARER_TOKEN
-INTERFACES_SEED_DIR=\$INTERFACES_SEED_DIR
 RUNTIME_HTTP_PORT=7821
 VELLUM_CLOUD=\$VELLUM_CLOUD
 DOTENV_EOF
@@ -215,6 +216,10 @@ export async function watchHatching(
   startTime: number,
   species: Species,
 ): Promise<WatchHatchingResult> {
+  if (IS_DESKTOP) {
+    return watchHatchingDesktop(pollFn, instanceName, startTime, species);
+  }
+
   let spinnerIdx = 0;
   let lastLogLine: string | null = null;
   let linesDrawn = 0;
@@ -321,6 +326,70 @@ export async function watchHatching(
   });
 }
 
+function watchHatchingDesktop(
+  pollFn: () => Promise<PollResult>,
+  instanceName: string,
+  startTime: number,
+  species: Species,
+): Promise<WatchHatchingResult> {
+  return new Promise<WatchHatchingResult>((resolve) => {
+    let prevLogLine: string | null = null;
+    let lastErrorContent = "";
+    let pollInFlight = false;
+    let nextPollAt = Date.now() + 15000;
+
+    desktopLog("Waiting for instance to start...");
+
+    const interval = setInterval(async () => {
+      const elapsed = Date.now() - startTime;
+
+      if (elapsed >= HATCH_TIMEOUT_MS[species]) {
+        clearInterval(interval);
+        desktopLog(`Timed out after ${formatElapsed(elapsed)}. Instance is still running.`);
+        desktopLog(`Monitor with: vel logs ${instanceName}`);
+        resolve({ success: true, errorContent: lastErrorContent });
+        return;
+      }
+
+      if (Date.now() < nextPollAt || pollInFlight) return;
+
+      pollInFlight = true;
+      try {
+        const result = await pollFn();
+
+        if (result.lastLine && result.lastLine !== prevLogLine) {
+          prevLogLine = result.lastLine;
+          desktopLog(result.lastLine);
+        }
+
+        if (result.errorContent) {
+          lastErrorContent = result.errorContent;
+        }
+
+        if (result.done) {
+          clearInterval(interval);
+          if (result.failed) {
+            desktopLog("Startup script failed");
+          } else {
+            desktopLog("Your assistant has hatched!");
+          }
+          resolve({ success: !result.failed, errorContent: lastErrorContent });
+        }
+      } finally {
+        pollInFlight = false;
+        nextPollAt = Date.now() + 5000;
+      }
+    }, 5000);
+
+    process.on("SIGINT", () => {
+      clearInterval(interval);
+      desktopLog("Detaching. Instance is still running.");
+      desktopLog(`Monitor with: vel logs ${instanceName}`);
+      process.exit(0);
+    });
+  });
+}
+
 function buildSshArgs(host: string): string[] {
   return [
     host,