@vellumai/cli 0.1.10 → 0.1.12

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.10",
+  "version": "0.1.12",
   "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 },
+  );
+}