Scale computer-use 2.0 with open-source drivers, cross-OS sandboxes, and benchmarks for training, evaluation, and data generation.
Rust agentai-agentapplecomputer-usecomputer-use-agentcontainerizationcuadesktop-automationhacktoberfestlumemacosmanusoperatorswiftvirtualizationvirtualization-frameworkwindowswindows-sandbox
added cua CLI
Dillon DuPontbe98606cb558
diff --git a/libs/typescript/cua-cli/.gitignore b/libs/typescript/cua-cli/.gitignorenew file mode 100644index 0000000000..a14702c409--- /dev/null+++ b/libs/typescript/cua-cli/.gitignore@@ -0,0 +1,34 @@+# dependencies (bun install)+node_modules++# output+out+dist+*.tgz++# code coverage+coverage+*.lcov++# logs+logs+_.log+report.[0-9]_.[0-9]_.[0-9]_.[0-9]_.json++# dotenv environment variable files+.env+.env.development.local+.env.test.local+.env.production.local+.env.local++# caches+.eslintcache+.cache+*.tsbuildinfo++# IntelliJ based IDEs+.idea++# Finder (MacOS) folder config+.DS_Storediff --git a/libs/typescript/cua-cli/CLAUDE.md b/libs/typescript/cua-cli/CLAUDE.mdnew file mode 100644index 0000000000..1ee689044f--- /dev/null+++ b/libs/typescript/cua-cli/CLAUDE.md@@ -0,0 +1,106 @@++Default to using Bun instead of Node.js.++- Use `bun <file>` instead of `node <file>` or `ts-node <file>`+- Use `bun test` instead of `jest` or `vitest`+- Use `bun build <file.html|file.ts|file.css>` instead of `webpack` or `esbuild`+- Use `bun install` instead of `npm install` or `yarn install` or `pnpm install`+- Use `bun run <script>` instead of `npm run <script>` or `yarn run <script>` or `pnpm run <script>`+- Bun automatically loads .env, so don't use dotenv.++## APIs++- `Bun.serve()` supports WebSockets, HTTPS, and routes. Don't use `express`.+- `bun:sqlite` for SQLite. Don't use `better-sqlite3`.+- `Bun.redis` for Redis. Don't use `ioredis`.+- `Bun.sql` for Postgres. Don't use `pg` or `postgres.js`.+- `WebSocket` is built-in. Don't use `ws`.+- Prefer `Bun.file` over `node:fs`'s readFile/writeFile+- Bun.$`ls` instead of execa.++## Testing++Use `bun test` to run tests.++```ts#index.test.ts+import { test, expect } from "bun:test";++test("hello world", () => {+ expect(1).toBe(1);+});+```++## Frontend++Use HTML imports with `Bun.serve()`. Don't use `vite`. HTML imports fully support React, CSS, Tailwind.++Server:++```ts#index.ts+import index from "./index.html"++Bun.serve({+ routes: {+ "/": index,+ "/api/users/:id": {+ GET: (req) => {+ return new Response(JSON.stringify({ id: req.params.id }));+ },+ },+ },+ // optional websocket support+ websocket: {+ open: (ws) => {+ ws.send("Hello, world!");+ },+ message: (ws, message) => {+ ws.send(message);+ },+ close: (ws) => {+ // handle close+ }+ },+ development: {+ hmr: true,+ console: true,+ }+})+```++HTML files can import .tsx, .jsx or .js files directly and Bun's bundler will transpile & bundle automatically. `<link>` tags can point to stylesheets and Bun's CSS bundler will bundle.++```html#index.html+<html>+ <body>+ <h1>Hello, world!</h1>+ <script type="module" src="./frontend.tsx"></script>+ </body>+</html>+```++With the following `frontend.tsx`:++```tsx#frontend.tsx+import React from "react";++// import .css files directly and it works+import './index.css';++import { createRoot } from "react-dom/client";++const root = createRoot(document.body);++export default function Frontend() {+ return <h1>Hello, world!</h1>;+}++root.render(<Frontend />);+```++Then, run index.ts++```sh+bun --hot ./index.ts+```++For more information, read the Bun API docs in `node_modules/bun-types/docs/**.md`.diff --git a/libs/typescript/cua-cli/README.md b/libs/typescript/cua-cli/README.mdnew file mode 100644index 0000000000..54d58f5e09--- /dev/null+++ b/libs/typescript/cua-cli/README.md@@ -0,0 +1,56 @@+# CUA CLI (Bun)++## Install++```bash+bun install+bun link # register package globally+bun link cua-cli # install the global binary `cua`+```++If you want to run without linking:++```bash+bun run ./index.ts -- --help+```++## Commands++- **Auth**+ - `cua auth login` – opens browser to authorize; stores API key locally+ - `cua auth login --api-key sk-...` – stores provided key directly+ - `cua auth pull` – writes/updates `.env` with `CUA_API_KEY`+ - `cua auth logout` – clears stored API key++- **VMs**+ - `cua vm list`+ - `cua vm start NAME`+ - `cua vm stop NAME`+ - `cua vm restart NAME`++## Auth Flow (Dynamic Callback Port)++- CLI starts a small local HTTP server using `Bun.serve({ port: 0 })` which picks an available port.+- Browser is opened to `https://cua.ai/cli-auth?callback_url=http://127.0.0.1:<port>/callback`.+- After you click "Authorize CLI", the browser redirects to the local server with `?token=...`.+- The CLI saves the API key in `~/.config/cua/cli.sqlite`.++> Note: If the browser cannot be opened automatically, copy/paste the printed URL.++## Project Structure++- `index.ts` – entry point (shebang + start CLI)+- `src/cli.ts` – yargs bootstrapping+- `src/commands/auth.ts` – auth/login/pull/logout commands+- `src/commands/vm.ts` – vm list/start/stop/restart commands+- `src/auth.ts` – browser flow + local callback server (dynamic port)+- `src/http.ts` – HTTP helper+- `src/storage.ts` – SQLite-backed key-value storage+- `src/config.ts` – constants and paths+- `src/util.ts` – table printing, .env writer++## Notes++- Stored API key lives at `~/.config/cua/cli.sqlite` under `kv(api_key)`.+- Public API base: `https://api.cua.ai`.+- Authorization header: `Authorization: Bearer <api_key>`.diff --git a/libs/typescript/cua-cli/bun.lock b/libs/typescript/cua-cli/bun.locknew file mode 100644index 0000000000..4de964c1c6--- /dev/null+++ b/libs/typescript/cua-cli/bun.lock@@ -0,0 +1,63 @@+{+ "lockfileVersion": 1,+ "workspaces": {+ "": {+ "name": "cua-cli",+ "dependencies": {+ "yargs": "^18.0.0",+ },+ "devDependencies": {+ "@types/bun": "latest",+ "@types/yargs": "^17.0.33",+ },+ "peerDependencies": {+ "typescript": "^5",+ },+ },+ },+ "packages": {+ "@types/bun": ["@types/[email protected]", "", { "dependencies": { "bun-types": "1.3.0" } }, "sha512-+lAGCYjXjip2qY375xX/scJeVRmZ5cY0wyHYyCYxNcdEXrQ4AOe3gACgd4iQ8ksOslJtW4VNxBJ8llUwc3a6AA=="],++ "@types/node": ["@types/[email protected]", "", { "dependencies": { "undici-types": "~7.16.0" } }, "sha512-MKNwXh3seSK8WurXF7erHPJ2AONmMwkI7zAMrXZDPIru8jRqkk6rGDBVbw4mLwfqA+ZZliiDPg05JQ3uW66tKQ=="],++ "@types/react": ["@types/[email protected]", "", { "dependencies": { "csstype": "^3.0.2" } }, "sha512-6mDvHUFSjyT2B2yeNx2nUgMxh9LtOWvkhIU3uePn2I2oyNymUAX1NIsdgviM4CH+JSrp2D2hsMvJOkxY+0wNRA=="],++ "@types/yargs": ["@types/[email protected]", "", { "dependencies": { "@types/yargs-parser": "*" } }, "sha512-WpxBCKWPLr4xSsHgz511rFJAM+wS28w2zEO1QDNY5zM/S8ok70NNfztH0xwhqKyaK0OHCbN98LDAZuy1ctxDkA=="],++ "@types/yargs-parser": ["@types/[email protected]", "", {}, "sha512-I4q9QU9MQv4oEOz4tAHJtNz1cwuLxn2F3xcc2iV5WdqLPpUnj30aUuxt1mAxYTG+oe8CZMV/+6rU4S4gRDzqtQ=="],++ "ansi-regex": ["[email protected]", "", {}, "sha512-Bq3SmSpyFHaWjPk8If9yc6svM8c56dB5BAtW4Qbw5jHTwwXXcTLoRMkpDJp6VL0XzlWaCHTXrkFURMYmD0sLqg=="],++ "ansi-styles": ["[email protected]", "", {}, "sha512-4Dj6M28JB+oAH8kFkTLUo+a2jwOFkuqb3yucU0CANcRRUbxS0cP0nZYCGjcc3BNXwRIsUVmDGgzawme7zvJHvg=="],++ "bun-types": ["[email protected]", "", { "dependencies": { "@types/node": "*" }, "peerDependencies": { "@types/react": "^19" } }, "sha512-u8X0thhx+yJ0KmkxuEo9HAtdfgCBaM/aI9K90VQcQioAmkVp3SG3FkwWGibUFz3WdXAdcsqOcbU40lK7tbHdkQ=="],++ "cliui": ["[email protected]", "", { "dependencies": { "string-width": "^7.2.0", "strip-ansi": "^7.1.0", "wrap-ansi": "^9.0.0" } }, "sha512-k7ndgKhwoQveBL+/1tqGJYNz097I7WOvwbmmU2AR5+magtbjPWQTS1C5vzGkBC8Ym8UWRzfKUzUUqFLypY4Q+w=="],++ "csstype": ["[email protected]", "", {}, "sha512-M1uQkMl8rQK/szD0LNhtqxIPLpimGm8sOBwU7lLnCpSbTyY3yeU1Vc7l4KT5zT4s/yOxHH5O7tIuuLOCnLADRw=="],++ "emoji-regex": ["[email protected]", "", {}, "sha512-toUI84YS5YmxW219erniWD0CIVOo46xGKColeNQRgOzDorgBi1v4D71/OFzgD9GO2UGKIv1C3Sp8DAn0+j5w7A=="],++ "escalade": ["[email protected]", "", {}, "sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA=="],++ "get-caller-file": ["[email protected]", "", {}, "sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg=="],++ "get-east-asian-width": ["[email protected]", "", {}, "sha512-QZjmEOC+IT1uk6Rx0sX22V6uHWVwbdbxf1faPqJ1QhLdGgsRGCZoyaQBm/piRdJy/D2um6hM1UP7ZEeQ4EkP+Q=="],++ "string-width": ["[email protected]", "", { "dependencies": { "emoji-regex": "^10.3.0", "get-east-asian-width": "^1.0.0", "strip-ansi": "^7.1.0" } }, "sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ=="],++ "strip-ansi": ["[email protected]", "", { "dependencies": { "ansi-regex": "^6.0.1" } }, "sha512-gmBGslpoQJtgnMAvOVqGZpEz9dyoKTCzy2nfz/n8aIFhN/jCE/rCmcxabB6jOOHV+0WNnylOxaxBQPSvcWklhA=="],++ "typescript": ["[email protected]", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw=="],++ "undici-types": ["[email protected]", "", {}, "sha512-Zz+aZWSj8LE6zoxD+xrjh4VfkIG8Ya6LvYkZqtUQGJPZjYl53ypCaUwWqo7eI0x66KBGeRo+mlBEkMSeSZ38Nw=="],++ "wrap-ansi": ["[email protected]", "", { "dependencies": { "ansi-styles": "^6.2.1", "string-width": "^7.0.0", "strip-ansi": "^7.1.0" } }, "sha512-42AtmgqjV+X1VpdOfyTGOYRi0/zsoLqtXQckTmqTeybT+BDIbM/Guxo7x3pE2vtpr1ok6xRqM9OpBe+Jyoqyww=="],++ "y18n": ["[email protected]", "", {}, "sha512-0pfFzegeDWJHJIAmTLRP2DwHjdF5s7jo9tuztdQxAhINCdvS+3nGINqPd00AphqJR/0LhANUS6/+7SCb98YOfA=="],++ "yargs": ["[email protected]", "", { "dependencies": { "cliui": "^9.0.1", "escalade": "^3.1.1", "get-caller-file": "^2.0.5", "string-width": "^7.2.0", "y18n": "^5.0.5", "yargs-parser": "^22.0.0" } }, "sha512-4UEqdc2RYGHZc7Doyqkrqiln3p9X2DZVxaGbwhn2pi7MrRagKaOcIKe8L3OxYcbhXLgLFUS3zAYuQjKBQgmuNg=="],++ "yargs-parser": ["[email protected]", "", {}, "sha512-rwu/ClNdSMpkSrUb+d6BRsSkLUq1fmfsY6TOpYzTwvwkg1/NRG85KBy3kq++A8LKQwX6lsu+aWad+2khvuXrqw=="],+ }+}diff --git a/libs/typescript/cua-cli/index.ts b/libs/typescript/cua-cli/index.tsnew file mode 100755index 0000000000..b48c5715a9--- /dev/null+++ b/libs/typescript/cua-cli/index.ts@@ -0,0 +1,7 @@+#! /usr/bin/env bun+import { runCli } from "./src/cli";++runCli().catch((err) => {+ console.error(err);+ process.exit(1);+});diff --git a/libs/typescript/cua-cli/package.json b/libs/typescript/cua-cli/package.jsonnew file mode 100644index 0000000000..0651e521cc--- /dev/null+++ b/libs/typescript/cua-cli/package.json@@ -0,0 +1,19 @@+{+ "name": "cua-cli",+ "module": "index.ts",+ "type": "module",+ "private": true,+ "devDependencies": {+ "@types/bun": "latest",+ "@types/yargs": "^17.0.33"+ },+ "peerDependencies": {+ "typescript": "^5"+ },+ "bin": {+ "cua": "./index.ts"+ },+ "dependencies": {+ "yargs": "^18.0.0"+ }+}diff --git a/libs/typescript/cua-cli/src/auth.ts b/libs/typescript/cua-cli/src/auth.tsnew file mode 100644index 0000000000..b3659b895a--- /dev/null+++ b/libs/typescript/cua-cli/src/auth.ts@@ -0,0 +1,54 @@+import { AUTH_PAGE, CALLBACK_HOST } from "./config";+import { setApiKey, getApiKey } from "./storage";+import { openInBrowser } from "./util";++const c = {+ reset: "\x1b[0m",+ bold: "\x1b[1m",+ dim: "\x1b[2m",+ underline: "\x1b[4m",+ cyan: "\x1b[36m",+ green: "\x1b[32m",+ yellow: "\x1b[33m",+};++// openInBrowser is imported from util++export async function loginViaBrowser(): Promise<string> {+ let resolveToken!: (v: string) => void;+ const tokenPromise = new Promise<string>((resolve) => { resolveToken = resolve; });++ // dynamic port (0) -> OS chooses available port+ const server = Bun.serve({+ hostname: CALLBACK_HOST,+ port: 0,+ fetch(req) {+ const u = new URL(req.url);+ if (u.pathname !== "/callback") return new Response("Not found", { status: 404 });+ const token = u.searchParams.get("token");+ if (!token) return new Response("Missing token", { status: 400 });+ resolveToken(token);+ queueMicrotask(() => server.stop());+ return new Response("CLI authorized. You can close this window.", { status: 200, headers: { "content-type": "text/plain" } });+ },+ });++ const callbackURL = `http://${CALLBACK_HOST}:${server.port}/callback`;+ const url = `${AUTH_PAGE}?callback_url=${encodeURIComponent(callbackURL)}`;+ console.log(`${c.cyan}${c.bold}Opening your default browser to authorize the CLI...${c.reset}`);+ console.log(`${c.dim}If the browser does not open automatically, copy/paste this URL:${c.reset}`);+ console.log(`${c.yellow}${c.underline}${url}${c.reset}`);+ await openInBrowser(url);++ const timeout = new Promise<string>((_, reject) => setTimeout(() => reject(new Error("Timed out waiting for authorization")), 2 * 60 * 1000));+ try { return await Promise.race([tokenPromise, timeout]); }+ finally { try { server.stop(); } catch {} }+}++export async function ensureApiKeyInteractive(): Promise<string> {+ const existing = getApiKey();+ if (existing) return existing;+ const token = await loginViaBrowser();+ setApiKey(token);+ return token;+}diff --git a/libs/typescript/cua-cli/src/cli.ts b/libs/typescript/cua-cli/src/cli.tsnew file mode 100644index 0000000000..2cfa759d13--- /dev/null+++ b/libs/typescript/cua-cli/src/cli.ts@@ -0,0 +1,11 @@+import yargs from "yargs";+import { hideBin } from "yargs/helpers";+import { registerAuthCommands } from "./commands/auth";+import { registerVmCommands } from "./commands/vm";++export async function runCli() {+ let argv = yargs(hideBin(process.argv)).scriptName("cua");+ argv = registerAuthCommands(argv);+ argv = registerVmCommands(argv);+ await argv.demandCommand(1).strict().help().parseAsync();+}diff --git a/libs/typescript/cua-cli/src/commands/auth.ts b/libs/typescript/cua-cli/src/commands/auth.tsnew file mode 100644index 0000000000..e09beb0330--- /dev/null+++ b/libs/typescript/cua-cli/src/commands/auth.ts@@ -0,0 +1,49 @@+import { setApiKey, clearApiKey } from "../storage";+import { ensureApiKeyInteractive, loginViaBrowser } from "../auth";+import { writeEnvFile } from "../util";+import type { Argv } from "yargs";++export function registerAuthCommands(y: Argv) {+ return y.command(+ "auth",+ "Auth commands",+ (ya) =>+ ya+ .command(+ "login",+ "Open browser to authorize and store API key",+ (y) => y.option("api-key", { type: "string", describe: "API key to store directly" }),+ async (argv: Record<string, unknown>) => {+ if (argv["api-key"]) {+ setApiKey(String(argv["api-key"]));+ console.log("API key saved");+ return;+ }+ console.log("Opening browser for CLI auth...");+ const token = await loginViaBrowser();+ setApiKey(token);+ console.log("API key saved");+ }+ )+ .command(+ "pull",+ "Create or update .env with CUA_API_KEY (login if needed)",+ () => {},+ async (_argv: Record<string, unknown>) => {+ const token = await ensureApiKeyInteractive();+ const out = await writeEnvFile(process.cwd(), token);+ console.log(`Wrote ${out}`);+ }+ )+ .command(+ "logout",+ "Remove stored API key",+ () => {},+ async (_argv: Record<string, unknown>) => {+ clearApiKey();+ console.log("Logged out");+ }+ )+ .demandCommand(1, "Specify an auth subcommand")+ );+}diff --git a/libs/typescript/cua-cli/src/commands/vm.ts b/libs/typescript/cua-cli/src/commands/vm.tsnew file mode 100644index 0000000000..0fcb73be56--- /dev/null+++ b/libs/typescript/cua-cli/src/commands/vm.ts@@ -0,0 +1,96 @@+import type { Argv } from "yargs";+import { ensureApiKeyInteractive } from "../auth";+import { http } from "../http";+import { printVmList, openInBrowser } from "../util";+import type { VmItem } from "../util";+import { clearApiKey } from "../storage";++export function registerVmCommands(y: Argv) {+ return y.command(+ "vm",+ "VM commands",+ (yv) =>+ yv+ .command(+ "list",+ "List VMs",+ () => {},+ async (_argv: Record<string, unknown>) => {+ const token = await ensureApiKeyInteractive();+ const res = await http("/v1/vms", { token });+ if (res.status === 401) {+ clearApiKey();+ console.error("Unauthorized. Try 'cua auth login' again.");+ process.exit(1);+ }+ if (!res.ok) {+ console.error(`Request failed: ${res.status}`);+ process.exit(1);+ }+ const data = (await res.json()) as VmItem[];+ printVmList(data);+ }+ )+ .command(+ "start <name>",+ "Start a VM",+ (y) => y.positional("name", { type: "string", describe: "VM name" }),+ async (argv: Record<string, unknown>) => {+ const token = await ensureApiKeyInteractive();+ const name = String((argv as any).name);+ const res = await http(`/v1/vms/${encodeURIComponent(name)}/start`, { token, method: "POST" });+ if (res.status === 204) { console.log("Start accepted"); return; }+ if (res.status === 404) { console.error("VM not found"); process.exit(1); }+ if (res.status === 401) { clearApiKey(); console.error("Unauthorized. Try 'cua auth login' again."); process.exit(1); }+ console.error(`Unexpected status: ${res.status}`); process.exit(1);+ }+ )+ .command(+ "stop <name>",+ "Stop a VM",+ (y) => y.positional("name", { type: "string", describe: "VM name" }),+ async (argv: Record<string, unknown>) => {+ const token = await ensureApiKeyInteractive();+ const name = String((argv as any).name);+ const res = await http(`/v1/vms/${encodeURIComponent(name)}/stop`, { token, method: "POST" });+ if (res.status === 202) { const body = (await res.json().catch(() => ({}))) as { status?: string }; console.log(body.status ?? "stopping"); return; }+ if (res.status === 404) { console.error("VM not found"); process.exit(1); }+ if (res.status === 401) { clearApiKey(); console.error("Unauthorized. Try 'cua auth login' again."); process.exit(1); }+ console.error(`Unexpected status: ${res.status}`); process.exit(1);+ }+ )+ .command(+ "restart <name>",+ "Restart a VM",+ (y) => y.positional("name", { type: "string", describe: "VM name" }),+ async (argv: Record<string, unknown>) => {+ const token = await ensureApiKeyInteractive();+ const name = String((argv as any).name);+ const res = await http(`/v1/vms/${encodeURIComponent(name)}/restart`, { token, method: "POST" });+ if (res.status === 202) { const body = (await res.json().catch(() => ({}))) as { status?: string }; console.log(body.status ?? "restarting"); return; }+ if (res.status === 404) { console.error("VM not found"); process.exit(1); }+ if (res.status === 401) { clearApiKey(); console.error("Unauthorized. Try 'cua auth login' again."); process.exit(1); }+ console.error(`Unexpected status: ${res.status}`); process.exit(1);+ }+ )+ .command(+ "vnc <name>",+ "Open NoVNC for a VM in your browser",+ (y) => y.positional("name", { type: "string", describe: "VM name" }),+ async (argv: Record<string, unknown>) => {+ const token = await ensureApiKeyInteractive();+ const name = String((argv as any).name);+ const listRes = await http("/v1/vms", { token });+ if (listRes.status === 401) { clearApiKey(); console.error("Unauthorized. Try 'cua auth login' again."); process.exit(1); }+ if (!listRes.ok) { console.error(`Request failed: ${listRes.status}`); process.exit(1); }+ const vms = (await listRes.json()) as VmItem[];+ const vm = vms.find(v => v.name === name);+ if (!vm) { console.error("VM not found"); process.exit(1); }+ const url = `https://${vm.name}.containers.cloud.trycua.com/vnc.html?autoconnect=true&password=${encodeURIComponent(vm.password)}`;+ console.log(`Opening NoVNC: ${url}`);+ await openInBrowser(url);+ }+ )+ .demandCommand(1, "Specify a vm subcommand")+ );+}diff --git a/libs/typescript/cua-cli/src/config.ts b/libs/typescript/cua-cli/src/config.tsnew file mode 100644index 0000000000..3ef686c215--- /dev/null+++ b/libs/typescript/cua-cli/src/config.ts@@ -0,0 +1,16 @@+export const API_BASE = "https://api.cua.ai";+export const AUTH_PAGE = "https://cua.ai/cli-auth";+export const CALLBACK_HOST = "127.0.0.1";++export function getConfigDir(): string {+ const home = Bun.env.HOME || Bun.env.USERPROFILE || ".";+ const dir = `${home}/.cua/config`;+ try {+ Bun.spawnSync(["mkdir", "-p", dir]);+ } catch {}+ return dir;+}++export function getDbPath(): string {+ return `${getConfigDir()}/cli.sqlite`;+}diff --git a/libs/typescript/cua-cli/src/http.ts b/libs/typescript/cua-cli/src/http.tsnew file mode 100644index 0000000000..95ff39ea0b--- /dev/null+++ b/libs/typescript/cua-cli/src/http.ts@@ -0,0 +1,12 @@+import { API_BASE } from "./config";++export async function http(path: string, opts: { method?: string; token: string; body?: any }): Promise<Response> {+ const url = `${API_BASE}${path}`;+ const headers: Record<string, string> = { Authorization: `Bearer ${opts.token}` };+ if (opts.body) headers["content-type"] = "application/json";+ return fetch(url, {+ method: opts.method || "GET",+ headers,+ body: opts.body ? JSON.stringify(opts.body) : undefined,+ });+}diff --git a/libs/typescript/cua-cli/src/storage.ts b/libs/typescript/cua-cli/src/storage.tsnew file mode 100644index 0000000000..d2c4fa5695--- /dev/null+++ b/libs/typescript/cua-cli/src/storage.ts@@ -0,0 +1,26 @@+import { Database } from "bun:sqlite";+import { getDbPath } from "./config";++function getDb(): Database {+ const db = new Database(getDbPath());+ db.exec("PRAGMA journal_mode = WAL;");+ db.exec("CREATE TABLE IF NOT EXISTS kv (k TEXT PRIMARY KEY, v TEXT NOT NULL);");+ return db;+}++export function setApiKey(token: string) {+ const db = getDb();+ const stmt = db.query("INSERT INTO kv (k, v) VALUES ('api_key', ?) ON CONFLICT(k) DO UPDATE SET v=excluded.v");+ stmt.run(token);+}++export function getApiKey(): string | null {+ const db = getDb();+ const row = db.query("SELECT v FROM kv WHERE k='api_key'").get() as { v: string } | undefined;+ return row?.v ?? null;+}++export function clearApiKey() {+ const db = getDb();+ db.query("DELETE FROM kv WHERE k='api_key'").run();+}diff --git a/libs/typescript/cua-cli/src/util.ts b/libs/typescript/cua-cli/src/util.tsnew file mode 100644index 0000000000..503378b8b0--- /dev/null+++ b/libs/typescript/cua-cli/src/util.ts@@ -0,0 +1,32 @@+export async function writeEnvFile(cwd: string, key: string) {+ const path = `${cwd}/.env`;+ let content = "";+ try { content = await Bun.file(path).text(); } catch {}+ const lines = content.split(/\r?\n/).filter(Boolean);+ const idx = lines.findIndex((l) => l.startsWith("CUA_API_KEY="));+ if (idx >= 0) lines[idx] = `CUA_API_KEY=${key}`; else lines.push(`CUA_API_KEY=${key}`);+ await Bun.write(path, lines.join("\n") + "\n");+ return path;+}++export type VmStatus = "pending" | "running" | "stopped" | "terminated" | "failed";+export type VmItem = { name: string; password: string; status: VmStatus };++export function printVmList(items: VmItem[]) {+ const rows: string[][] = [["NAME", "STATUS", "PASSWORD"], ...items.map(v => [v.name, String(v.status), v.password])];+ const widths: number[] = [0, 0, 0];+ for (const r of rows) for (let i = 0; i < 3; i++) widths[i] = Math.max(widths[i] ?? 0, (r[i] ?? "").length);+ for (const r of rows) console.log(r.map((c, i) => (c ?? "").padEnd(widths[i] ?? 0)).join(" "));+ if (items.length === 0) console.log("No VMs found");+}++export async function openInBrowser(url: string) {+ const platform = process.platform;+ let cmd: string;+ let args: string[] = [];+ if (platform === "darwin") { cmd = "open"; args = [url]; }+ else if (platform === "win32") { cmd = "cmd"; args = ["/c", "start", "", url]; }+ else { cmd = "xdg-open"; args = [url]; }+ try { await Bun.spawn({ cmd: [cmd, ...args] }).exited; }+ catch { console.error(`Failed to open browser. Please visit: ${url}`); }+}diff --git a/libs/typescript/cua-cli/tsconfig.json b/libs/typescript/cua-cli/tsconfig.jsonnew file mode 100644index 0000000000..bfa0fead54--- /dev/null+++ b/libs/typescript/cua-cli/tsconfig.json@@ -0,0 +1,29 @@+{+ "compilerOptions": {+ // Environment setup & latest features+ "lib": ["ESNext"],+ "target": "ESNext",+ "module": "Preserve",+ "moduleDetection": "force",+ "jsx": "react-jsx",+ "allowJs": true,++ // Bundler mode+ "moduleResolution": "bundler",+ "allowImportingTsExtensions": true,+ "verbatimModuleSyntax": true,+ "noEmit": true,++ // Best practices+ "strict": true,+ "skipLibCheck": true,+ "noFallthroughCasesInSwitch": true,+ "noUncheckedIndexedAccess": true,+ "noImplicitOverride": true,++ // Some stricter flags (disabled by default)+ "noUnusedLocals": false,+ "noUnusedParameters": false,+ "noPropertyAccessFromIndexSignature": false+ }+}