@exedev/sdk 0.0.6 → 0.2.0

package/dist/commands.gen.js

@@ -0,0 +1,1640 @@
+// Code generated by "go run ./cmd/gensdkjs" in the exe.dev repository. DO NOT EDIT.
+import { Transport, ExeAPIError, ExeProtocolError, abortable, delay } from "./client.js";
+export class ExedevClient {
+    #transport;
+    constructor(options) { this.#transport = new Transport(options); }
+    /** Reference an existing VM without a request. Use refresh() to fetch its metadata. */
+    vm(name) {
+        if (typeof name !== "string" || !/^[a-zA-Z0-9][a-zA-Z0-9-]*$/.test(name)) {
+            throw new TypeError("exedev: expected a VM name, not a command or SSH destination");
+        }
+        return new VM(this.#transport, { name, tags: [] });
+    }
+    /**
+     * Browse documentation
+     *
+     * Usage: `doc [slug-or-query...]`
+     *
+     * Tag-scoped API keys may run this command.
+     */
+    async doc(slugOrQueries, options) {
+        const result = await this.#transport.call("doc", [slugOrQueries], options, {}, false);
+        return result;
+    }
+    /**
+     * List your VMs
+     *
+     * Usage: `ls [-l] [--group=tag|region|type] [name|pattern]`
+     *
+     * Tag-scoped API keys may run this command.
+     */
+    async ls(nameOrPattern, options) {
+        const result = await this.#transport.call("ls", [nameOrPattern], options, {
+            group: "string",
+            l: "bool",
+        }, true);
+        return listVMs(this.#transport, result);
+    }
+    /**
+     * Create a new VM
+     *
+     * CLI examples:
+     * ```
+     * new                                     # just give me a computer
+     * new --name=b --image=ubuntu:22.04       # custom image and name
+     * new --cpu=4 --memory=16GB               # 4 CPUs, 16GB RAM
+     * new --disk=50GB                         # 50GB disk
+     * new --tag=prod,staging                  # create with tags
+     * new --env FOO=bar --env BAZ=qux         # with environment variables
+     * new --integration=myproxy               # attach an integration
+     * echo 'build me a web app' | ssh exe.dev new --prompt=/dev/stdin
+     * ```
+     *
+     * Tag-scoped API keys may run this command.
+     */
+    async new(options) {
+        const ready = readiness(options ?? {});
+        const { waitUntil, timeoutMs, ...flags } = options ?? {};
+        const result = await this.#transport.call("new", [], flags, {
+            comment: "string",
+            cpu: "number",
+            disk: "string",
+            env: "repeated",
+            image: "string",
+            integration: "repeated",
+            memory: "string",
+            name: "string",
+            "no-email": "bool",
+            "no-pool": "bool",
+            pool: "string",
+            prompt: "string",
+            "registry-auth": "string",
+            sandbox: "bool",
+            "setup-script": "string",
+            standalone: "bool",
+            tag: "repeated",
+        }, true);
+        const vm = new VM(this.#transport, vmInfo(result, "new"));
+        if (ready)
+            await vm.waitUntilReady(ready);
+        return vm;
+    }
+    /**
+     * List custom domains for a VM (or -a for all your VMs)
+     *
+     * Usage: `domain ls <vm> | domain ls -a`
+     */
+    async domainLs(args, options) {
+        const result = await this.#transport.call("domain ls", [args], options, {
+            a: "bool",
+        }, false);
+        return result;
+    }
+    /**
+     * Show user information (email, keys, etc)
+     *
+     * Usage: `whoami`
+     *
+     * Tag-scoped API keys may run this command.
+     */
+    async whoami(options) {
+        const result = await this.#transport.call("whoami", [], options, {}, true);
+        return result;
+    }
+    /**
+     * List all SSH keys associated with your account
+     *
+     * Usage: `ssh-key list`
+     *
+     * Tag-scoped API keys may run this command.
+     */
+    async sshKeyList(options) {
+        const result = await this.#transport.call("ssh-key list", [], options, {}, false);
+        return result;
+    }
+    /**
+     * Add a new SSH key to your account
+     *
+     * Usage: `ssh-key add [--tag=TAG] <public-key>`
+     *
+     * CLI examples:
+     * ```
+     * ssh-key add 'ssh-ed25519 AAAA... my-laptop'
+     *
+     * To generate a new key locally:
+     *   ssh-keygen -t ed25519 -C "mnemonic-for-this-key" -f ~/.ssh/id_exe
+     *
+     * The -C flag sets a name for the key.
+     *
+     * Then add the public key from your local shell:
+     *   cat ~/.ssh/id_exe.pub | ssh exe.dev ssh-key add
+     *
+     * Or from the exe.dev shell:
+     *   ssh-key add 'ssh-ed25519 AAAA... my-laptop'
+     * ```
+     *
+     * Tag-scoped API keys may run this command.
+     */
+    async sshKeyAdd(publicKey, options) {
+        const result = await this.#transport.call("ssh-key add", [publicKey], options, {
+            tag: "string",
+        }, false);
+        return result;
+    }
+    /**
+     * Remove an SSH key from your account
+     *
+     * Usage: `ssh-key remove <name|fingerprint|public-key>`
+     *
+     * Tag-scoped API keys may run this command.
+     */
+    async sshKeyRemove(nameOrFingerprintOrPublicKey, options) {
+        const result = await this.#transport.call("ssh-key remove", [nameOrFingerprintOrPublicKey], options, {}, false);
+        return result;
+    }
+    /**
+     * Rename an SSH key
+     *
+     * Usage: `ssh-key rename <old-name> <new-name>`
+     *
+     * Tag-scoped API keys may run this command.
+     */
+    async sshKeyRename(oldName, newName, options) {
+        const result = await this.#transport.call("ssh-key rename", [oldName, newName], options, {}, false);
+        return result;
+    }
+    /**
+     * Generate an API key for the exe.dev HTTPS API or for a specific VM
+     *
+     * Usage: `ssh-key generate-api-key [--label=NAME] [--vm=VMNAME] [--cmds=CMD1,CMD2] [--exp=30d]`
+     *
+     * CLI examples:
+     * ```
+     * # Generate a key for the exe.dev API (lobby commands like ls, new, whoami):
+     * ssh-key generate-api-key --label=ci --cmds=ls,new --exp=90d
+     *
+     * # Generate a key scoped to a VM (authenticates to its HTTPS proxy):
+     * ssh-key generate-api-key --vm=my-vm --label=deploy
+     * ```
+     *
+     * Tag-scoped API keys may run this command.
+     */
+    async sshKeyGenerateApiKey(options) {
+        const result = await this.#transport.call("ssh-key generate-api-key", [], options, {
+            cmds: "string",
+            exp: "string",
+            label: "string",
+            vm: "string",
+        }, false);
+        return result;
+    }
+    /**
+     * Set your preferred region for new VMs.
+     *
+     * Usage: `set-region <region-code>`
+     */
+    async setRegion(regionCode, options) {
+        const result = await this.#transport.call("set-region", [regionCode], options, {}, false);
+        return result;
+    }
+    /**
+     * List your integrations
+     *
+     * Usage: `integrations list [--json [--usage]]`
+     *
+     * Tag-scoped API keys may run this command.
+     */
+    async integrationsList(options) {
+        const result = await this.#transport.call("integrations list", [], options, {
+            usage: "bool",
+        }, false);
+        return result;
+    }
+    /**
+     * Set up GitHub integration
+     *
+     * Usage: `integrations setup github [--list|--verify|-d]`
+     */
+    async integrationsSetupGithub(options) {
+        const result = await this.#transport.call("integrations setup github", [], options, {
+            d: "bool",
+            delete: "bool",
+            list: "bool",
+            verify: "bool",
+        }, false);
+        return result;
+    }
+    /**
+     * Set up ChatGPT account access for LLM integrations
+     *
+     * Usage: `integrations setup chatgpt [--name=<account-name>|--list|--verify|-d]`
+     */
+    async integrationsSetupChatgpt(options) {
+        const result = await this.#transport.call("integrations setup chatgpt", [], options, {
+            d: "bool",
+            delete: "bool",
+            list: "bool",
+            name: "string",
+            verify: "bool",
+        }, false);
+        return result;
+    }
+    /**
+     * Add a new integration
+     *
+     * Credential value flags (keys, tokens, passwords, bearer tokens, and webhook URLs) accept - to read from stdin.
+     *
+     * Usage: `integrations add <type> [--default | --name=<name> [--team] [args...]]`
+     */
+    async integrationsAdd(type, options) {
+        const result = await this.#transport.call("integrations add", [type], options, {
+            "act-as-user": "bool",
+            attach: "repeated",
+            bearer: "string",
+            comment: "string",
+            default: "bool",
+            fields: "string",
+            for: "string",
+            header: "repeated",
+            "host-key": "repeated",
+            name: "string",
+            "no-auth": "bool",
+            peer: "bool",
+            readonly: "bool",
+            repository: "string",
+            "strip-prefix": "string",
+            target: "string",
+            team: "bool",
+        }, false);
+        return result;
+    }
+    /**
+     * Remove an integration
+     *
+     * Usage: `integrations remove <name> [--team]`
+     */
+    async integrationsRemove(name, options) {
+        const result = await this.#transport.call("integrations remove", [name], options, {
+            team: "bool",
+        }, false);
+        return result;
+    }
+    /**
+     * Test an integration's credential (connection check)
+     *
+     * Usage: `integrations test <name> [--team]`
+     */
+    async integrationsTest(name, options) {
+        const result = await this.#transport.call("integrations test", [name], options, {
+            team: "bool",
+        }, false);
+        return result;
+    }
+    /**
+     * Edit an integration
+     *
+     * Credential value flags (keys, tokens, passwords, bearer tokens, and webhook URLs) accept - to read from stdin.
+     *
+     * Usage: `integrations edit <name> [--team] [args...]`
+     */
+    async integrationsEdit(name, args, options) {
+        const result = await this.#transport.call("integrations edit", [name, args], options, {
+            "act-as-user": "bool",
+            bearer: "string",
+            "clear-header": "bool",
+            comment: "string",
+            fields: "string",
+            header: "repeated",
+            "host-key": "repeated",
+            "no-auth": "bool",
+            readonly: "bool",
+            repository: "string",
+            "strip-prefix": "string",
+            target: "string",
+            team: "bool",
+            "webhook-url": "string",
+        }, false);
+        return result;
+    }
+    /**
+     * Attach an integration to a VM, tag, or all VMs
+     *
+     * A <spec> controls where the integration is mounted:
+     *   vm:<vm-name>   attach to a specific VM (personal only)
+     *   tag:<tag-name> attach to every VM with the given tag
+     *   auto:all       attach to all current and future VMs (personal only)
+     *
+     * You can attach the same integration multiple times with different specs.
+     * Team integrations only support tag:<tag-name>.
+     *
+     * A grant can be time-boxed with --for <duration> or --until <RFC3339>;
+     * when it lapses, access stops immediately, with nothing to revoke.
+     * Re-attaching the same spec with a new --for/--until extends or shortens it.
+     *
+     * Usage: `integrations attach <name> <spec> [--team] [--for <duration> | --until <time>]`
+     *
+     * CLI examples:
+     * ```
+     * int attach my-mcp vm:dev1
+     * int attach my-mcp tag:production
+     * int attach my-mcp auto:all
+     * int attach shared-mcp tag:production
+     * int attach gmail vm:dev1 --for 2h
+     * ```
+     */
+    async integrationsAttach(name, spec, options) {
+        const result = await this.#transport.call("integrations attach", [name, spec], options, {
+            for: "string",
+            team: "bool",
+            until: "string",
+        }, false);
+        return result;
+    }
+    /**
+     * Detach an integration from a VM, tag, or all VMs
+     *
+     * Usage: `integrations detach <name> <spec> [--team]`
+     */
+    async integrationsDetach(name, spec, options) {
+        const result = await this.#transport.call("integrations detach", [name, spec], options, {
+            team: "bool",
+        }, false);
+        return result;
+    }
+    /**
+     * Rename an integration
+     *
+     * Usage: `integrations rename <name> <new-name> [--team]`
+     */
+    async integrationsRename(name, newName, options) {
+        const result = await this.#transport.call("integrations rename", [name, newName], options, {
+            team: "bool",
+        }, false);
+        return result;
+    }
+    /**
+     * Browse the catalog of ready-made service integrations
+     *
+     * Usage: `integrations catalog [service-or-search-term]`
+     *
+     * CLI examples:
+     * ```
+     * int catalog
+     * int catalog stripe
+     * ```
+     */
+    async integrationsCatalog(serviceOrSearchTerm, options) {
+        const result = await this.#transport.call("integrations catalog", [serviceOrSearchTerm], options, {}, false);
+        return result;
+    }
+    /**
+     * View and manage your team
+     */
+    async team(options) {
+        const result = await this.#transport.call("team", [], options, {}, false);
+        return result;
+    }
+    /**
+     * Disband your team
+     *
+     * Usage: `team disable`
+     */
+    async teamDisable(options) {
+        const result = await this.#transport.call("team disable", [], options, {
+            yes: "bool",
+        }, false);
+        return result;
+    }
+    /**
+     * List team members
+     *
+     * Usage: `team members`
+     */
+    async teamMembers(options) {
+        const result = await this.#transport.call("team members", [], options, {}, false);
+        return result;
+    }
+    /**
+     * Show team pool, disk, and bandwidth usage for the billing period
+     *
+     * Usage: `team usage`
+     */
+    async teamUsage(options) {
+        const result = await this.#transport.call("team usage", [], options, {}, false);
+        return result;
+    }
+    /**
+     * Add a user to the team
+     *
+     * Usage: `team add <email> [<user|admin|billing_owner>]`
+     */
+    async teamAdd(email, userOrAdminOrBillingOwner, options) {
+        const result = await this.#transport.call("team add", [email, userOrAdminOrBillingOwner], options, {}, false);
+        return result;
+    }
+    /**
+     * Remove a user from the team
+     *
+     * Usage: `team remove <email> [--transfer-vms-to <email>]`
+     */
+    async teamRemove(email, options) {
+        const result = await this.#transport.call("team remove", [email], options, {
+            "transfer-vms-to": "string",
+        }, false);
+        return result;
+    }
+    /**
+     * Change a team member's role
+     *
+     * Usage: `team role <email> <user|admin|billing_owner>`
+     */
+    async teamRole(email, userOrAdminOrBillingOwner, options) {
+        const result = await this.#transport.call("team role", [email, userOrAdminOrBillingOwner], options, {}, false);
+        return result;
+    }
+    /**
+     * Rename your team
+     *
+     * Usage: `team rename <name>`
+     */
+    async teamRename(name, options) {
+        const result = await this.#transport.call("team rename", [name], options, {}, false);
+        return result;
+    }
+    /**
+     * Show your team's plan
+     *
+     * Usage: `team billing plan [--all]`
+     *
+     * CLI examples:
+     * ```
+     * team billing plan
+     * team billing plan --all   # plans your team can switch to
+     * ```
+     */
+    async teamBillingPlan(options) {
+        const result = await this.#transport.call("team billing plan", [], options, {
+            all: "bool",
+        }, false);
+        return result;
+    }
+    /**
+     * Update team billing information
+     *
+     * Usage: `team billing update [--email=<email>] [--name=<name>] [--business-name=<name>] [--phone=<phone>] [--address-line1=<line>] [--address-line2=<line>] [--address-city=<city>] [--address-state=<state>] [--address-postal-code=<code>] [--address-country=<country>] [--tax-id-type=<type>] [--tax-id-value=<value>]`
+     */
+    async teamBillingUpdate(options) {
+        const result = await this.#transport.call("team billing update", [], options, {
+            "address-city": "string",
+            "address-country": "string",
+            "address-line1": "string",
+            "address-line2": "string",
+            "address-postal-code": "string",
+            "address-state": "string",
+            "business-name": "string",
+            email: "string",
+            name: "string",
+            phone: "string",
+            "tax-id-type": "string",
+            "tax-id-value": "string",
+        }, false);
+        return result;
+    }
+    /**
+     * Transfer a VM to another team member
+     *
+     * Usage: `team transfer <vm_name> <target_email>`
+     */
+    async teamTransfer(vmName, targetEmail, options) {
+        const result = await this.#transport.call("team transfer", [vmName, targetEmail], options, {}, false);
+        return result;
+    }
+    /**
+     * View and manage team auth settings
+     *
+     * Usage: `team auth`
+     */
+    async teamAuth(options) {
+        const result = await this.#transport.call("team auth", [], options, {}, false);
+        return result;
+    }
+    /**
+     * Require OIDC for web login (web|off)
+     *
+     * Usage: `team auth require-oidc <web|off>`
+     */
+    async teamAuthRequireOidc(webOrOff, options) {
+        const result = await this.#transport.call("team auth require-oidc", [webOrOff], options, {}, false);
+        return result;
+    }
+    /**
+     * Set the team auth provider (default, google, oidc)
+     *
+     * Usage: `team auth set <default|google|oidc> [--issuer-url=<url> --client-id=<id> --client-secret=<secret>]`
+     */
+    async teamAuthSet(defaultOrGoogleOrOidc, options) {
+        const result = await this.#transport.call("team auth set", [defaultOrGoogleOrOidc], options, {
+            "client-id": "string",
+            "client-secret": "string",
+            "display-name": "string",
+            "issuer-url": "string",
+        }, false);
+        return result;
+    }
+    /**
+     * View and manage team settings
+     *
+     * Usage: `team settings`
+     */
+    async teamSettings(options) {
+        const result = await this.#transport.call("team settings", [], options, {}, false);
+        return result;
+    }
+    /**
+     * View and manage automatic VM placement
+     *
+     * Usage: `team settings vm-placement`
+     */
+    async teamSettingsVmPlacement(options) {
+        const result = await this.#transport.call("team settings vm-placement", [], options, {}, false);
+        return result;
+    }
+    /**
+     * Use ordinary VM placement
+     *
+     * Usage: `team settings vm-placement default`
+     */
+    async teamSettingsVmPlacementDefault(options) {
+        const result = await this.#transport.call("team settings vm-placement default", [], options, {}, false);
+        return result;
+    }
+    /**
+     * Send bare new commands to a shared team pool
+     *
+     * Usage: `team settings vm-placement pool <name>`
+     */
+    async teamSettingsVmPlacementPool(name, options) {
+        const result = await this.#transport.call("team settings vm-placement pool", [name], options, {}, false);
+        return result;
+    }
+    /**
+     * Create or reuse one team pool per member for bare new commands
+     *
+     * Usage: `team settings vm-placement member-pool --cpus=N [--max-vms=N]`
+     */
+    async teamSettingsVmPlacementMemberPool(options) {
+        const result = await this.#transport.call("team settings vm-placement member-pool", [], options, {
+            cpus: "number",
+            "max-vms": "number",
+        }, false);
+        return result;
+    }
+    /**
+     * Keep bare new commands outside pools while migrating (legacy)
+     *
+     * Usage: `team settings vm-placement poolless`
+     */
+    async teamSettingsVmPlacementPoolless(options) {
+        const result = await this.#transport.call("team settings vm-placement poolless", [], options, {}, false);
+        return result;
+    }
+    /**
+     * Set who can create standalone VMs
+     *
+     * Usage: `team settings standalone <off|admins-only|all-users>`
+     */
+    async teamSettingsStandalone(offOrAdminsOnlyOrAllUsers, options) {
+        const result = await this.#transport.call("team settings standalone", [offOrAdminsOnlyOrAllUsers], options, {}, false);
+        return result;
+    }
+    /**
+     * Allow or block the exe.dev LLM gateway (your own API keys are unaffected)
+     *
+     * Usage: `team settings llm-gateway <on|off>`
+     */
+    async teamSettingsLlmGateway(onOrOff, options) {
+        const result = await this.#transport.call("team settings llm-gateway", [onOrOff], options, {}, false);
+        return result;
+    }
+    /**
+     * Allow team VMs to share CPU cores with each other
+     *
+     * Usage: `team settings core-sharing <on|off>`
+     */
+    async teamSettingsCoreSharing(onOrOff, options) {
+        const result = await this.#transport.call("team settings core-sharing", [onOrOff], options, {}, false);
+        return result;
+    }
+    /**
+     * Set who can share team VMs
+     *
+     * Usage: `team settings vm-sharing <admins-only|all-members>`
+     */
+    async teamSettingsVmSharing(adminsOnlyOrAllMembers, options) {
+        const result = await this.#transport.call("team settings vm-sharing", [adminsOnlyOrAllMembers], options, {}, false);
+        return result;
+    }
+    /**
+     * Set how long members stay signed in on the web and mobile apps
+     *
+     * Usage: `team settings session-length <length>`
+     *
+     * CLI examples:
+     * ```
+     * team settings session-length 1d
+     * team settings session-length default
+     * ```
+     */
+    async teamSettingsSessionLength(length, options) {
+        const result = await this.#transport.call("team settings session-length", [length], options, {}, false);
+        return result;
+    }
+    /**
+     * Allow users from your email domain to join this team on signup
+     *
+     * Usage: `team settings auto-join <on|off>`
+     */
+    async teamSettingsAutoJoin(onOrOff, options) {
+        const result = await this.#transport.call("team settings auto-join", [onOrOff], options, {}, false);
+        return result;
+    }
+    /**
+     * List all VMs across your team
+     *
+     * Usage: `team vm ls [-l] [--group=tag|region|type|user|access] [name|pattern]`
+     *
+     * Tag-scoped API keys may run this command.
+     */
+    async teamVmLs(nameOrPattern, options) {
+        const result = await this.#transport.call("team vm ls", [nameOrPattern], options, {
+            group: "string",
+            l: "bool",
+        }, false);
+        return result;
+    }
+    /**
+     * Create a pool: reserved capacity for your team's VMs
+     *
+     * Usage: `pool new <name> --cpus=N [--region=<region>] [--max-vms=M]`
+     */
+    async poolNew(name, options) {
+        const result = await this.#transport.call("pool new", [name], options, {
+            cpus: "number",
+            "max-vms": "number",
+            region: "string",
+        }, false);
+        return result;
+    }
+    /**
+     * Show your team's dedicated hosts, where its new pools are placed
+     *
+     * Usage: `pool hosts`
+     */
+    async poolHosts(options) {
+        const result = await this.#transport.call("pool hosts", [], options, {}, false);
+        return result;
+    }
+    /**
+     * List your team's pools, or show live or historical usage with --usage
+     *
+     * Usage: `pool list [pool-name] [--usage [--range=live|24h|7d|30d]]`
+     */
+    async poolList(poolName, options) {
+        const result = await this.#transport.call("pool list", [poolName], options, {
+            range: "string",
+            usage: "bool",
+        }, false);
+        return result;
+    }
+    /**
+     * Adopt a VM into a pool; this can take several minutes
+     *
+     * Usage: `pool adopt --vm=<vm-name> --pool=<pool-name>`
+     *
+     * CLI examples:
+     * ```
+     * pool adopt --vm=builder --pool=compile
+     * ```
+     */
+    async poolAdopt(options) {
+        const result = await this.#transport.call("pool adopt", [], options, {
+            pool: "string",
+            vm: "string",
+        }, false);
+        return result;
+    }
+    /**
+     * Detach a VM from its pool into its own standalone capacity (--poolless leaves it outside any pool)
+     *
+     * Usage: `pool detach --vm=<vm-name> [--poolless]`
+     *
+     * CLI examples:
+     * ```
+     * pool detach --vm=builder
+     * pool detach --vm=builder --poolless
+     * ```
+     */
+    async poolDetach(options) {
+        const result = await this.#transport.call("pool detach", [], options, {
+            poolless: "bool",
+            vm: "string",
+        }, false);
+        return result;
+    }
+    /**
+     * Change a pool's CPU capacity or VM cap
+     *
+     * Usage: `pool resize <name> --cpus=N | pool resize <name> --max-vms=N [--force]`
+     */
+    async poolResize(args, options) {
+        const result = await this.#transport.call("pool resize", [args], options, {
+            cpus: "number",
+            force: "bool",
+            "max-vms": "string",
+        }, false);
+        return result;
+    }
+    /**
+     * Rename a pool without changing its capacity or VMs
+     *
+     * Usage: `pool rename <old-name> <new-name>`
+     */
+    async poolRename(oldName, newName, options) {
+        const result = await this.#transport.call("pool rename", [oldName, newName], options, {}, false);
+        return result;
+    }
+    /**
+     * Delete a pool (refused while it has VMs; --force detaches them)
+     *
+     * Usage: `pool delete <name> [--force]`
+     */
+    async poolDelete(name, options) {
+        const result = await this.#transport.call("pool delete", [name], options, {}, false);
+        return result;
+    }
+    /**
+     * Show your current plan and resource limits
+     *
+     * Usage: `billing plan [--all]`
+     *
+     * CLI examples:
+     * ```
+     * billing plan
+     * billing plan --all   # plans you can switch to
+     * ```
+     */
+    async billingPlan(options) {
+        const result = await this.#transport.call("billing plan", [], options, {
+            all: "bool",
+        }, false);
+        return result;
+    }
+    /**
+     * Show VM resource usage against your plan quotas
+     *
+     * Usage: `billing usage [--range=cycle|24h|7d|30d] [--group=vm]`
+     *
+     * CLI examples:
+     * ```
+     * billing usage --range=7d
+     * billing credits usage   # Shelley/LLM credit spend instead
+     * ```
+     */
+    async billingUsage(options) {
+        const result = await this.#transport.call("billing usage", [], options, {
+            group: "string",
+            range: "string",
+        }, false);
+        return result;
+    }
+    /**
+     * Show Shelley credit balances
+     *
+     * Usage: `billing credits [usage|transactions|buy]`
+     */
+    async billingCredits(options) {
+        const result = await this.#transport.call("billing credits", [], options, {}, false);
+        return result;
+    }
+    /**
+     * Show Shelley (LLM) credit spend by model, day, or VM
+     *
+     * Usage: `billing credits usage [--month=YYYY-MM] [--group=model|day|box] [--detail]`
+     *
+     * CLI examples:
+     * ```
+     * billing credits usage --group=day
+     * billing credits usage --group=box --detail
+     * billing credits usage --month=2026-05 --group=box
+     * ```
+     */
+    async billingCreditsUsage(options) {
+        const result = await this.#transport.call("billing credits usage", [], options, {
+            detail: "bool",
+            group: "string",
+            month: "string",
+        }, false);
+        return result;
+    }
+    /**
+     * Show your credit purchases and gifts
+     *
+     * Usage: `billing credits transactions [--limit=N]`
+     */
+    async billingCreditsTransactions(options) {
+        const result = await this.#transport.call("billing credits transactions", [], options, {
+            limit: "string",
+        }, false);
+        return result;
+    }
+    /**
+     * Buy Shelley credits with your personal payment method
+     *
+     * Usage: `billing credits buy <dollars> [--yes]`
+     *
+     * CLI examples:
+     * ```
+     * billing credits buy 25
+     * billing credits buy 100 --yes
+     * ```
+     */
+    async billingCreditsBuy(dollars, options) {
+        const result = await this.#transport.call("billing credits buy", [dollars], options, {
+            "idempotency-key": "string",
+            yes: "bool",
+        }, false);
+        return result;
+    }
+    /**
+     * Show invite rewards you've earned
+     *
+     * Usage: `billing rewards`
+     */
+    async billingRewards(options) {
+        const result = await this.#transport.call("billing rewards", [], options, {}, false);
+        return result;
+    }
+    /**
+     * Change your subscription capacity
+     *
+     * Usage: `billing capacity [--cpu=N] [--yes]`
+     *
+     * CLI examples:
+     * ```
+     * billing capacity
+     * billing capacity --cpu=4 --yes
+     * ```
+     */
+    async billingCapacity(options) {
+        const result = await this.#transport.call("billing capacity", [], options, {
+            cpu: "number",
+            yes: "bool",
+        }, false);
+        return result;
+    }
+    /**
+     * Show your payment methods
+     *
+     * Usage: `billing payment [list]`
+     */
+    async billingPayment(options) {
+        const result = await this.#transport.call("billing payment", [], options, {}, false);
+        return result;
+    }
+    /**
+     * List all payment methods on file
+     *
+     * Usage: `billing payment list`
+     */
+    async billingPaymentList(options) {
+        const result = await this.#transport.call("billing payment list", [], options, {}, false);
+        return result;
+    }
+    /**
+     * Remove a saved payment method
+     *
+     * Usage: `billing payment remove <ref>`
+     *
+     * CLI examples:
+     * ```
+     * billing payment remove 4f1c2a9b8d3e
+     * ```
+     */
+    async billingPaymentRemove(ref, options) {
+        const result = await this.#transport.call("billing payment remove", [ref], options, {}, false);
+        return result;
+    }
+    /**
+     * Make a saved payment method the default
+     *
+     * Usage: `billing payment default <ref>`
+     *
+     * CLI examples:
+     * ```
+     * billing payment default 4f1c2a9b8d3e
+     * ```
+     */
+    async billingPaymentDefault(ref, options) {
+        const result = await this.#transport.call("billing payment default", [ref], options, {}, false);
+        return result;
+    }
+    /**
+     * Open the billing management page
+     *
+     * Usage: `billing manage`
+     */
+    async billingManage(options) {
+        const result = await this.#transport.call("billing manage", [], options, {}, false);
+        return result;
+    }
+    /**
+     * Open the personal plan activation page
+     *
+     * Usage: `billing activate`
+     */
+    async billingActivate(options) {
+        const result = await this.#transport.call("billing activate", [], options, {}, false);
+        return result;
+    }
+    /**
+     * Update your billing contact information
+     *
+     * Usage: `billing update [--email=<email>] [--name=<name>] [--business-name=<name>] [--phone=<phone>] [--address-line1=<line>] [--address-line2=<line>] [--address-city=<city>] [--address-state=<state>] [--address-postal-code=<code>] [--address-country=<country>] [--tax-id-type=<type>] [--tax-id-value=<value>]`
+     */
+    async billingUpdate(options) {
+        const result = await this.#transport.call("billing update", [], options, {
+            "address-city": "string",
+            "address-country": "string",
+            "address-line1": "string",
+            "address-line2": "string",
+            "address-postal-code": "string",
+            "address-state": "string",
+            "business-name": "string",
+            email: "string",
+            name: "string",
+            phone: "string",
+            "tax-id-type": "string",
+            "tax-id-value": "string",
+        }, false);
+        return result;
+    }
+    /**
+     * Show recent invoices
+     *
+     * Usage: `billing invoices`
+     */
+    async billingInvoices(options) {
+        const result = await this.#transport.call("billing invoices", [], options, {}, false);
+        return result;
+    }
+    /**
+     * List invoices for your personal or team account
+     *
+     * Usage: `billing invoices list [--account=personal|team]`
+     *
+     * CLI examples:
+     * ```
+     * billing invoices list --account=team
+     * ```
+     */
+    async billingInvoicesList(options) {
+        const result = await this.#transport.call("billing invoices list", [], options, {
+            account: "string",
+        }, false);
+        return result;
+    }
+    /**
+     * Show one invoice with its usage breakdown
+     *
+     * Usage: `billing invoices show <id> [--vms]`
+     *
+     * CLI examples:
+     * ```
+     * billing invoices show in_1Abc --vms
+     * ```
+     */
+    async billingInvoicesShow(id, options) {
+        const result = await this.#transport.call("billing invoices show", [id], options, {
+            vms: "bool",
+        }, false);
+        return result;
+    }
+    /**
+     * Show credit purchase receipts and purchases (this billing account only)
+     *
+     * Usage: `billing receipts [--from=<YYYY-MM-DD>] [--to=<YYYY-MM-DD>]`
+     *
+     * CLI examples:
+     * ```
+     * billing receipts --from=2026-01-01 --to=2026-06-30
+     * ```
+     */
+    async billingReceipts(options) {
+        const result = await this.#transport.call("billing receipts", [], options, {
+            from: "string",
+            to: "string",
+        }, false);
+        return result;
+    }
+    /**
+     * Open a consolidated credit purchase statement
+     *
+     * Usage: `billing statement [--from=<YYYY-MM-DD>] [--to=<YYYY-MM-DD>]`
+     *
+     * CLI examples:
+     * ```
+     * billing statement --from=2026-01-01 --to=2026-06-30
+     * ```
+     */
+    async billingStatement(options) {
+        const result = await this.#transport.call("billing statement", [], options, {
+            from: "string",
+            to: "string",
+        }, false);
+        return result;
+    }
+    /**
+     * Connect a marketplace subscription to your team
+     *
+     * Usage: `billing provider link <aws|azure> --token=<link-token> [--size=<team-size>] [--team-name=<name>]`
+     */
+    async billingProviderLink(awsOrAzure, options) {
+        const result = await this.#transport.call("billing provider link", [awsOrAzure], options, {
+            size: "string",
+            "team-name": "string",
+            token: "string",
+        }, false);
+        return result;
+    }
+    /**
+     * Manage your invite link and rewards
+     */
+    async invite(options) {
+        const result = await this.#transport.call("invite", [], options, {}, false);
+        return result;
+    }
+    /**
+     * Show your active invite link and reward
+     *
+     * Usage: `invite show`
+     */
+    async inviteShow(options) {
+        const result = await this.#transport.call("invite show", [], options, {}, false);
+        return result;
+    }
+    /**
+     * Print only your active invite link
+     *
+     * Usage: `invite link`
+     */
+    async inviteLink(options) {
+        const result = await this.#transport.call("invite link", [], options, {}, false);
+        return result;
+    }
+    /**
+     * List invite rewards you can use
+     *
+     * Usage: `invite rewards`
+     */
+    async inviteRewards(options) {
+        const result = await this.#transport.call("invite rewards", [], options, {}, false);
+        return result;
+    }
+    /**
+     * Choose the reward for your invite link
+     *
+     * Usage: `invite set-reward standard|bonus-credits|extra-memory|extra-disk`
+     */
+    async inviteSetReward(standardOrBonusCreditsOrExtraMemoryOrExtraDisk, options) {
+        const result = await this.#transport.call("invite set-reward", [standardOrBonusCreditsOrExtraMemoryOrExtraDisk], options, {}, false);
+        return result;
+    }
+    /**
+     * Show signups, upgrades, and reward status
+     *
+     * Usage: `invite activity`
+     */
+    async inviteActivity(options) {
+        const result = await this.#transport.call("invite activity", [], options, {}, false);
+        return result;
+    }
+    /**
+     * Request more trial invites
+     *
+     * Usage: `invite request`
+     */
+    async inviteRequest(options) {
+        const result = await this.#transport.call("invite request", [], options, {}, false);
+        return result;
+    }
+    /**
+     * Open the invites page
+     *
+     * Usage: `invite manage`
+     */
+    async inviteManage(options) {
+        const result = await this.#transport.call("invite manage", [], options, {}, false);
+        return result;
+    }
+    /**
+     * Generate a magic link to log in to the website
+     *
+     * Usage: `browser`
+     */
+    async browser(options) {
+        const result = await this.#transport.call("browser", [], options, {
+            qr: "bool",
+        }, false);
+        return result;
+    }
+}
+/** A VM reference. info is a snapshot; refresh() fetches current metadata. */
+export class VM {
+    #transport;
+    #info;
+    /** @internal Obtain VMs through exe.new(), exe.ls(), exe.vm(), or vm.cp(). */
+    constructor(transport, info) {
+        this.#transport = transport;
+        this.#info = Object.freeze({ ...info, tags: Object.freeze([...info.tags]) });
+    }
+    get info() { return this.#info; }
+    get name() { return this.#info.name; }
+    get httpsUrl() { return this.#info.httpsUrl; }
+    get sshDest() { return this.#info.sshDest; }
+    get tags() { return this.#info.tags; }
+    /** Run a shell command once. Nonzero exit codes are results, not exceptions. */
+    ssh(command, options) {
+        return this.#transport.ssh(this.name, command, options);
+    }
+    /** Refresh metadata without changing this reference's identity. Requires ls permission. */
+    async refresh(options) {
+        const result = await this.#transport.call("ls", [this.name], options, {}, true);
+        const vm = listVMs(this.#transport, result).find((vm) => vm.name === this.name);
+        if (!vm)
+            throw new ExeAPIError("ls", 404, "VM not found");
+        this.#info = vm.info;
+        return this;
+    }
+    /**
+     * Probe SSH with `true` until it exits successfully. Never reruns a user command.
+     * The default deadline is 60 seconds, including requests and backoff. This does
+     * not wait for application servers or setup scripts. Requires ssh permission.
+     */
+    async waitUntilReady(options = {}) {
+        const timeoutMs = readyTimeout(options.timeoutMs);
+        options.signal?.throwIfAborted();
+        const controller = new AbortController();
+        const abort = () => controller.abort(options.signal.reason);
+        options.signal?.addEventListener("abort", abort, { once: true });
+        const timer = setTimeout(() => controller.abort(new DOMException("SSH readiness timed out", "TimeoutError")), timeoutMs);
+        let backoff = 100;
+        try {
+            while (true) {
+                try {
+                    const result = await abortable(this.ssh("true", { signal: controller.signal, capture: false }), controller.signal);
+                    controller.signal.throwIfAborted();
+                    if (result.exitCode !== 0)
+                        throw new ExeProtocolError("ssh readiness probe");
+                    return this;
+                }
+                catch (err) {
+                    controller.signal.throwIfAborted();
+                    // /exec reports these failures before a remote command starts. Other
+                    // rejections (not found, permissions, no SSH configured) fail fast.
+                    if (!(err instanceof ExeAPIError) || err.status !== 422 ||
+                        !/failed to (?:connect|dial|create session|run command on VM)/i.test(err.details().body))
+                        throw err;
+                }
+                await delay(backoff, controller.signal);
+                backoff = Math.min(backoff * 2, 1000);
+            }
+        }
+        catch (err) {
+            options.signal?.throwIfAborted();
+            throw new VMReadyError(this, err);
+        }
+        finally {
+            clearTimeout(timer);
+            options.signal?.removeEventListener("abort", abort);
+        }
+    }
+    /**
+     * Delete a VM
+     *
+     * Usage: `rm <vmname>...`
+     *
+     * Tag-scoped API keys may run this command.
+     */
+    async rm(options) {
+        const result = await this.#transport.call("rm", [this.name], options, {}, true);
+        return result;
+    }
+    /**
+     * Restart a VM
+     *
+     * Usage: `restart <vmname>`
+     *
+     * Tag-scoped API keys may run this command.
+     */
+    async restart(options) {
+        const ready = readiness(options ?? {});
+        const { waitUntil, timeoutMs, ...flags } = options ?? {};
+        const result = await this.#transport.call("restart", [this.name], flags, {}, true);
+        if (ready)
+            await this.waitUntilReady(ready);
+        return this;
+    }
+    /**
+     * Pause a VM (snapshot RAM to disk, free its CPU and memory)
+     *
+     * Usage: `pause <vmname>`
+     *
+     * CLI examples:
+     * ```
+     * pause my-vm     # snapshot RAM to disk; resume later with 'resume my-vm'
+     * ```
+     *
+     * Tag-scoped API keys may run this command.
+     */
+    async pause(options) {
+        const result = await this.#transport.call("pause", [this.name], options, {}, false);
+        return result;
+    }
+    /**
+     * Resume a paused VM (restore RAM from disk)
+     *
+     * Usage: `resume <vmname>`
+     *
+     * Tag-scoped API keys may run this command.
+     */
+    async resume(options) {
+        const ready = readiness(options ?? {});
+        const { waitUntil, timeoutMs, ...flags } = options ?? {};
+        const result = await this.#transport.call("resume", [this.name], flags, {}, false);
+        if (ready)
+            await this.waitUntilReady(ready);
+        return this;
+    }
+    /**
+     * rename a vm
+     *
+     * Usage: `rename <oldname> <newname>`
+     *
+     * Tag-scoped API keys may run this command.
+     */
+    async rename(newname, options) {
+        if (newname === this.name)
+            return this;
+        const result = await this.#transport.call("rename", [this.name, newname], options, {}, true);
+        if (result?.new_name !== newname || result?.old_name !== this.name)
+            throw new ExeProtocolError("rename");
+        // Destinations and other metadata may have changed. Do not invent URLs.
+        this.#info = Object.freeze({ name: newname, tags: this.tags });
+        return this;
+    }
+    /**
+     * Add or remove tags on a VM
+     *
+     * Usage: `tag [-d] <vm> <tag-name> [tag-name...]`
+     *
+     * CLI examples:
+     * ```
+     * tag my-vm prod web        # add tags
+     * tag -d my-vm prod web     # remove tags
+     * ```
+     *
+     * Tag-scoped API keys may run this command.
+     */
+    async tag(tagNames, options) {
+        const result = await this.#transport.call("tag", [this.name, tagNames], options, {
+            d: "bool",
+        }, false);
+        return result;
+    }
+    /**
+     * Copy an existing VM
+     *
+     * Usage: `cp <source-vm> [new-name] [--pool=<name>] [--memory=<size>] [--cpu=<count>] [--disk=<size>]`
+     *
+     * CLI examples:
+     * ```
+     * cp my-vm                          # copy with auto-generated name
+     * cp my-vm my-vm-copy               # copy with specific name
+     * cp my-vm --cpu=4 --memory=16GB    # copy with different resources
+     * cp my-vm my-pool-copy --pool=build # copy into a team pool
+     * cp my-vm --copy-tags=false        # copy without tags
+     * ```
+     *
+     * Tag-scoped API keys may run this command.
+     */
+    async cp(options) {
+        const ready = readiness(options ?? {});
+        const { waitUntil, timeoutMs, name, ...flags } = options ?? {};
+        const result = await this.#transport.call("cp", [this.name, name], flags, {
+            "copy-tags": "bool",
+            cpu: "number",
+            disk: "string",
+            memory: "string",
+            pool: "string",
+            sandbox: "bool",
+            standalone: "bool",
+        }, true);
+        const vm = new VM(this.#transport, vmInfo(result, "cp"));
+        if (ready)
+            await vm.waitUntilReady(ready);
+        return vm;
+    }
+    /**
+     * Resize a VM's resources (memory, CPU, disk)
+     *
+     * Usage: `resize <vmname> [--memory=<size>] [--cpu=<count>] [--disk=<size>]`
+     *
+     * Tag-scoped API keys may run this command.
+     */
+    async resize(options) {
+        const result = await this.#transport.call("resize", [this.name], options, {
+            cpu: "number",
+            disk: "string",
+            memory: "string",
+        }, false);
+        return result;
+    }
+    /**
+     * Set or clear a short comment on a VM
+     *
+     * Usage: `comment <hostname> <text>`
+     *
+     * CLI examples:
+     * ```
+     * comment my-vm staging copy
+     * comment my-vm "" # clear the comment
+     * ```
+     *
+     * Tag-scoped API keys may run this command.
+     */
+    async comment(text, options) {
+        const result = await this.#transport.call("comment", [this.name, text], options, {}, false);
+        return result;
+    }
+    /**
+     * Link a custom domain to a VM
+     *
+     * Usage: `domain add [--wildcard] <vm> <domain>`
+     */
+    async domainAdd(domain, options) {
+        const result = await this.#transport.call("domain add", [this.name, domain], options, {
+            wildcard: "bool",
+        }, false);
+        return result;
+    }
+    /**
+     * Remove a custom domain from a VM
+     *
+     * Usage: `domain rm <vm> <domain>`
+     */
+    async domainRm(domain, options) {
+        const result = await this.#transport.call("domain rm", [this.name, domain], options, {}, false);
+        return result;
+    }
+    /**
+     * Show current shares for a VM
+     *
+     * Usage: `share show <vm>`
+     *
+     * Tag-scoped API keys may run this command.
+     */
+    async shareShow(options) {
+        const result = await this.#transport.call("share show", [this.name], options, {
+            qr: "bool",
+        }, false);
+        return result;
+    }
+    /**
+     * Set the HTTP proxy port for a VM
+     *
+     * Usage: `share port <vm> [port]`
+     *
+     * CLI examples:
+     * ```
+     * share port mybox 8080
+     * ```
+     *
+     * Tag-scoped API keys may run this command.
+     */
+    async sharePort(port, options) {
+        const result = await this.#transport.call("share port", [this.name, port], options, {}, false);
+        return result;
+    }
+    /**
+     * Make the HTTP proxy publicly accessible
+     *
+     * Usage: `share set-public <vm>`
+     *
+     * Tag-scoped API keys may run this command.
+     */
+    async shareSetPublic(options) {
+        const result = await this.#transport.call("share set-public", [this.name], options, {}, false);
+        return result;
+    }
+    /**
+     * Restrict the HTTP proxy to authenticated users
+     *
+     * Usage: `share set-private <vm>`
+     *
+     * Tag-scoped API keys may run this command.
+     */
+    async shareSetPrivate(options) {
+        const result = await this.#transport.call("share set-private", [this.name], options, {}, false);
+        return result;
+    }
+    /**
+     * Share VM with a user via email, or grant shell access with --root
+     *
+     * Usage: `share add <vm> <email|team> [--root] [--message='...']`
+     *
+     * CLI examples:
+     * ```
+     * share add mybox user@example.com
+     * share add mybox user@example.com --message='Check this out'
+     * share add mybox team
+     * share add mybox teammate@example.com --root
+     * share add mybox team --root
+     * ```
+     *
+     * Tag-scoped API keys may run this command.
+     */
+    async shareAdd(emailOrTeam, options) {
+        const result = await this.#transport.call("share add", [this.name, emailOrTeam], options, {
+            message: "string",
+            qr: "bool",
+            root: "bool",
+        }, false);
+        return result;
+    }
+    /**
+     * Revoke a user's access to a VM, or downgrade shell access to web with --root
+     *
+     * Usage: `share remove <vm> <email|team> [--root]`
+     *
+     * CLI examples:
+     * ```
+     * share remove mybox user@example.com
+     * share remove mybox team
+     * share remove mybox teammate@example.com --root
+     * share remove mybox team --root
+     * ```
+     *
+     * Tag-scoped API keys may run this command.
+     */
+    async shareRemove(emailOrTeam, options) {
+        const result = await this.#transport.call("share remove", [this.name, emailOrTeam], options, {
+            root: "bool",
+        }, false);
+        return result;
+    }
+    /**
+     * Create a shareable link for a VM
+     *
+     * Usage: `share add-link <vm>`
+     *
+     * Tag-scoped API keys may run this command.
+     */
+    async shareAddLink(options) {
+        const result = await this.#transport.call("share add-link", [this.name], options, {
+            qr: "bool",
+        }, false);
+        return result;
+    }
+    /**
+     * Revoke a shareable link
+     *
+     * Usage: `share remove-link <vm> <token>`
+     *
+     * Tag-scoped API keys may run this command.
+     */
+    async shareRemoveLink(token, options) {
+        const result = await this.#transport.call("share remove-link", [this.name, token], options, {}, false);
+        return result;
+    }
+    /**
+     * Enable or disable inbound email for a VM
+     *
+     * Usage: `share receive-email <vm> [on|off] [--reply-policy=all|known|owner|none]`
+     *
+     * CLI examples:
+     * ```
+     * share receive-email mybox on
+     * share receive-email mybox off
+     * share receive-email mybox --reply-policy=known
+     * share receive-email mybox
+     * ```
+     *
+     * Tag-scoped API keys may run this command.
+     */
+    async shareReceiveEmail(onOrOff, options) {
+        const result = await this.#transport.call("share receive-email", [this.name, onOrOff], options, {
+            "reply-policy": "string",
+        }, false);
+        return result;
+    }
+    /**
+     * Install or upgrade Shelley to the current version
+     *
+     * Usage: `shelley install <vm>`
+     *
+     * Tag-scoped API keys may run this command.
+     */
+    async shelleyInstall(options) {
+        const result = await this.#transport.call("shelley install", [this.name], options, {}, false);
+        return result;
+    }
+    /**
+     * Allow exe.dev support to log in to a VM
+     *
+     * Usage: `grant-support-root <vmname> on|off`
+     *
+     * Tag-scoped API keys may run this command.
+     */
+    async grantSupportRoot(onOrOff, options) {
+        const result = await this.#transport.call("grant-support-root", [this.name, onOrOff], options, {}, false);
+        return result;
+    }
+    /**
+     * Show vCPU, disk, IO, and network (RX/TX) metrics for a VM
+     *
+     * Usage: `stat <vm-name> [--range=24h|7d|30d]`
+     *
+     * CLI examples:
+     * ```
+     * stat my-vm             # last 24 hours (default)
+     * stat my-vm --range=7d  # last 7 days
+     * stat my-vm --range=30d # last 30 days
+     * ```
+     *
+     * Tag-scoped API keys may run this command.
+     */
+    async stat(options) {
+        const result = await this.#transport.call("stat", [this.name], options, {
+            range: "string",
+        }, true);
+        return result;
+    }
+}
+/** Readiness failed after a VM was obtained/created. The VM is not deleted. */
+export class VMReadyError extends Error {
+    vm;
+    constructor(vm, cause) {
+        super(`exedev: VM ${vm.name} is not SSH-ready`, { cause });
+        this.vm = vm;
+        this.name = "VMReadyError";
+    }
+}
+function readyTimeout(value = 60_000) {
+    if (!Number.isSafeInteger(value) || value <= 0 || value > 2_147_483_647) {
+        throw new TypeError("exedev: timeoutMs must be a positive integer no greater than 2147483647");
+    }
+    return value;
+}
+function readiness(options) {
+    const { waitUntil = "ssh", timeoutMs, signal } = options;
+    readyTimeout(timeoutMs); // Validate before creating/copying/restarting a VM.
+    if (waitUntil !== "ssh" && waitUntil !== "created")
+        throw new TypeError("exedev: waitUntil must be ssh or created");
+    return waitUntil === "ssh" ? { timeoutMs, signal } : undefined;
+}
+function vmInfo(value, operation) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        throw new ExeProtocolError(operation);
+    const obj = value;
+    const string = (key, required = false) => {
+        const value = obj[key];
+        if (value === undefined && !required)
+            return undefined;
+        if (typeof value !== "string" || required && !value)
+            throw new ExeProtocolError(operation);
+        return value;
+    };
+    const name = string(operation === "cp" ? "name" : "vm_name", true);
+    if (!/^[a-zA-Z0-9][a-zA-Z0-9-]*$/.test(name))
+        throw new ExeProtocolError(operation);
+    const tags = obj.tags ?? [];
+    if (!Array.isArray(tags) || !tags.every((tag) => typeof tag === "string"))
+        throw new ExeProtocolError(operation);
+    return {
+        name, tags,
+        sshDest: string(operation === "cp" ? "ssh" : "ssh_dest", true),
+        httpsUrl: string("https_url", operation !== "cp"),
+        status: string(operation === "cp" ? "state" : "status"),
+        region: string("region"),
+        comment: string("comment"),
+        createdAt: string("created_at"),
+        setupError: string("error"),
+    };
+}
+function listVMs(transport, value) {
+    if (!value || typeof value !== "object" || !("vms" in value) || !Array.isArray(value.vms)) {
+        throw new ExeProtocolError("ls");
+    }
+    return value.vms.map((row) => new VM(transport, vmInfo(row, "ls")));
+}
+//# sourceMappingURL=commands.gen.js.map