@exedev/sdk 0.1.0 → 0.3.0

package/dist/commands.gen.js

@@ -1,10 +1,26 @@
 // Code generated by "go run ./cmd/gensdkjs" in the exe.dev repository. DO NOT EDIT.
-//
-// Every public exe.dev command that runs over the HTTPS API (POST /exec), as a
-// method of Commands, documented with the command's own help text. Positional
-// arguments are parameters; flags are keys of the options object, spelled as
-// on the command line.
-export class Commands {
+import { Transport, ExeAPIError, ExeProtocolError, SSHStreamError, abortable, delay, isErrorDocument } 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) {
+        return new VM(this.#transport, { name: vmName(name), tags: [] });
+    }
+    /**
+     * Delete VMs in one request; the server deletes several at a time. Unlike
+     * vm.rm(), VMs that were missing or could not be deleted do not throw: they
+     * are listed in failed, with reasons in errors. Requires rm permission.
+     */
+    async rm(vms, options) {
+        // A string is iterable: rm("abc") must not delete a, b, and c.
+        if (!Array.isArray(vms))
+            throw new TypeError("exedev: rm takes an array of VMs or VM names");
+        const names = [...new Set(vms.map(vmName))];
+        if (names.length === 0)
+            return { deleted: [], failed: [], not_found: [], errors: {} };
+        return rmResult(await this.#transport.documents("rm", [names], options, {}));
+    }
     /**
      * Browse documentation
      *
@@ -12,8 +28,9 @@ export class Commands {
      *
      * Tag-scoped API keys may run this command.
      */
-    doc(slugOrQueries, options) {
-        return this.run("doc", [slugOrQueries], options, {});
+    async doc(slugOrQueries, options) {
+        const result = await this.#transport.call("doc", [slugOrQueries], options, {}, false);
+        return result;
     }
     /**
      * List your VMs
@@ -22,11 +39,12 @@ export class Commands {
      *
      * Tag-scoped API keys may run this command.
      */
-    ls(nameOrPattern, options) {
-        return this.run("ls", [nameOrPattern], options, {
+    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
@@ -45,8 +63,10 @@ export class Commands {
      *
      * Tag-scoped API keys may run this command.
      */
-    new(options) {
-        return this.run("new", [], options, {
+    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",
@@ -64,297 +84,22 @@ export class Commands {
             "setup-script": "string",
             standalone: "bool",
             tag: "repeated",
-        });
-    }
-    /**
-     * Delete a VM
-     *
-     * Usage: `rm <vmname>...`
-     *
-     * Tag-scoped API keys may run this command.
-     */
-    rm(vmnames, options) {
-        return this.run("rm", [vmnames], options, {});
-    }
-    /**
-     * Restart a VM
-     *
-     * Usage: `restart <vmname>`
-     *
-     * Tag-scoped API keys may run this command.
-     */
-    restart(vmname, options) {
-        return this.run("restart", [vmname], options, {});
-    }
-    /**
-     * 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.
-     */
-    pause(vmname, options) {
-        return this.run("pause", [vmname], options, {});
-    }
-    /**
-     * Resume a paused VM (restore RAM from disk)
-     *
-     * Usage: `resume <vmname>`
-     *
-     * Tag-scoped API keys may run this command.
-     */
-    resume(vmname, options) {
-        return this.run("resume", [vmname], options, {});
-    }
-    /**
-     * rename a vm
-     *
-     * Usage: `rename <oldname> <newname>`
-     *
-     * Tag-scoped API keys may run this command.
-     */
-    rename(oldname, newname, options) {
-        return this.run("rename", [oldname, newname], options, {});
-    }
-    /**
-     * 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.
-     */
-    tag(vm, tagNames, options) {
-        return this.run("tag", [vm, tagNames], options, {
-            d: "bool",
-        });
-    }
-    /**
-     * 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.
-     */
-    cp(sourceVm, newName, options) {
-        return this.run("cp", [sourceVm, newName], options, {
-            "copy-tags": "bool",
-            cpu: "number",
-            disk: "string",
-            memory: "string",
-            pool: "string",
-            sandbox: "bool",
-            standalone: "bool",
-        });
-    }
-    /**
-     * 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.
-     */
-    resize(vmname, options) {
-        return this.run("resize", [vmname], options, {
-            cpu: "number",
-            disk: "string",
-            memory: "string",
-        });
-    }
-    /**
-     * 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.
-     */
-    comment(hostname, text, options) {
-        return this.run("comment", [hostname, text], options, {});
-    }
-    /**
-     * Link a custom domain to a VM
-     *
-     * Usage: `domain add [--wildcard] <vm> <domain>`
-     */
-    domainAdd(vm, domain, options) {
-        return this.run("domain add", [vm, domain], options, {
-            wildcard: "bool",
-        });
-    }
-    /**
-     * Remove a custom domain from a VM
-     *
-     * Usage: `domain rm <vm> <domain>`
-     */
-    domainRm(vm, domain, options) {
-        return this.run("domain rm", [vm, domain], options, {});
+        }, 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`
      */
-    domainLs(args, options) {
-        return this.run("domain ls", [args], options, {
+    async domainLs(args, options) {
+        const result = await this.#transport.call("domain ls", [args], options, {
             a: "bool",
-        });
-    }
-    /**
-     * Show current shares for a VM
-     *
-     * Usage: `share show <vm>`
-     *
-     * Tag-scoped API keys may run this command.
-     */
-    shareShow(vm, options) {
-        return this.run("share show", [vm], options, {
-            qr: "bool",
-        });
-    }
-    /**
-     * 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.
-     */
-    sharePort(vm, port, options) {
-        return this.run("share port", [vm, port], options, {});
-    }
-    /**
-     * Make the HTTP proxy publicly accessible
-     *
-     * Usage: `share set-public <vm>`
-     *
-     * Tag-scoped API keys may run this command.
-     */
-    shareSetPublic(vm, options) {
-        return this.run("share set-public", [vm], options, {});
-    }
-    /**
-     * Restrict the HTTP proxy to authenticated users
-     *
-     * Usage: `share set-private <vm>`
-     *
-     * Tag-scoped API keys may run this command.
-     */
-    shareSetPrivate(vm, options) {
-        return this.run("share set-private", [vm], options, {});
-    }
-    /**
-     * 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.
-     */
-    shareAdd(vm, emailOrTeam, options) {
-        return this.run("share add", [vm, emailOrTeam], options, {
-            message: "string",
-            qr: "bool",
-            root: "bool",
-        });
-    }
-    /**
-     * 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.
-     */
-    shareRemove(vm, emailOrTeam, options) {
-        return this.run("share remove", [vm, emailOrTeam], options, {
-            root: "bool",
-        });
-    }
-    /**
-     * Create a shareable link for a VM
-     *
-     * Usage: `share add-link <vm>`
-     *
-     * Tag-scoped API keys may run this command.
-     */
-    shareAddLink(vm, options) {
-        return this.run("share add-link", [vm], options, {
-            qr: "bool",
-        });
-    }
-    /**
-     * Revoke a shareable link
-     *
-     * Usage: `share remove-link <vm> <token>`
-     *
-     * Tag-scoped API keys may run this command.
-     */
-    shareRemoveLink(vm, token, options) {
-        return this.run("share remove-link", [vm, token], options, {});
-    }
-    /**
-     * 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.
-     */
-    shareReceiveEmail(vm, onOrOff, options) {
-        return this.run("share receive-email", [vm, onOrOff], options, {
-            "reply-policy": "string",
-        });
+        }, false);
+        return result;
     }
     /**
      * Show user information (email, keys, etc)
@@ -363,8 +108,9 @@ export class Commands {
      *
      * Tag-scoped API keys may run this command.
      */
-    whoami(options) {
-        return this.run("whoami", [], options, {});
+    async whoami(options) {
+        const result = await this.#transport.call("whoami", [], options, {}, true);
+        return result;
     }
     /**
      * List all SSH keys associated with your account
@@ -373,8 +119,9 @@ export class Commands {
      *
      * Tag-scoped API keys may run this command.
      */
-    sshKeyList(options) {
-        return this.run("ssh-key list", [], options, {});
+    async sshKeyList(options) {
+        const result = await this.#transport.call("ssh-key list", [], options, {}, false);
+        return result;
     }
     /**
      * Add a new SSH key to your account
@@ -399,10 +146,11 @@ export class Commands {
      *
      * Tag-scoped API keys may run this command.
      */
-    sshKeyAdd(publicKey, options) {
-        return this.run("ssh-key add", [publicKey], options, {
+    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
@@ -411,8 +159,9 @@ export class Commands {
      *
      * Tag-scoped API keys may run this command.
      */
-    sshKeyRemove(nameOrFingerprintOrPublicKey, options) {
-        return this.run("ssh-key remove", [nameOrFingerprintOrPublicKey], options, {});
+    async sshKeyRemove(nameOrFingerprintOrPublicKey, options) {
+        const result = await this.#transport.call("ssh-key remove", [nameOrFingerprintOrPublicKey], options, {}, false);
+        return result;
     }
     /**
      * Rename an SSH key
@@ -421,8 +170,9 @@ export class Commands {
      *
      * Tag-scoped API keys may run this command.
      */
-    sshKeyRename(oldName, newName, options) {
-        return this.run("ssh-key rename", [oldName, newName], options, {});
+    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
@@ -440,21 +190,23 @@ export class Commands {
      *
      * Tag-scoped API keys may run this command.
      */
-    sshKeyGenerateApiKey(options) {
-        return this.run("ssh-key generate-api-key", [], options, {
+    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>`
      */
-    setRegion(regionCode, options) {
-        return this.run("set-region", [regionCode], options, {});
+    async setRegion(regionCode, options) {
+        const result = await this.#transport.call("set-region", [regionCode], options, {}, false);
+        return result;
     }
     /**
      * List your integrations
@@ -463,37 +215,40 @@ export class Commands {
      *
      * Tag-scoped API keys may run this command.
      */
-    integrationsList(options) {
-        return this.run("integrations list", [], options, {
+    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]`
      */
-    integrationsSetupGithub(options) {
-        return this.run("integrations setup github", [], options, {
+    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]`
      */
-    integrationsSetupChatgpt(options) {
-        return this.run("integrations setup chatgpt", [], options, {
+    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
@@ -502,8 +257,8 @@ export class Commands {
      *
      * Usage: `integrations add <type> [--default | --name=<name> [--team] [args...]]`
      */
-    integrationsAdd(type, options) {
-        return this.run("integrations add", [type], options, {
+    async integrationsAdd(type, options) {
+        const result = await this.#transport.call("integrations add", [type], options, {
             "act-as-user": "bool",
             attach: "repeated",
             bearer: "string",
@@ -521,27 +276,30 @@ export class Commands {
             "strip-prefix": "string",
             target: "string",
             team: "bool",
-        });
+        }, false);
+        return result;
     }
     /**
      * Remove an integration
      *
      * Usage: `integrations remove <name> [--team]`
      */
-    integrationsRemove(name, options) {
-        return this.run("integrations remove", [name], options, {
+    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]`
      */
-    integrationsTest(name, options) {
-        return this.run("integrations test", [name], options, {
+    async integrationsTest(name, options) {
+        const result = await this.#transport.call("integrations test", [name], options, {
             team: "bool",
-        });
+        }, false);
+        return result;
     }
     /**
      * Edit an integration
@@ -550,8 +308,8 @@ export class Commands {
      *
      * Usage: `integrations edit <name> [--team] [args...]`
      */
-    integrationsEdit(name, args, options) {
-        return this.run("integrations edit", [name, args], options, {
+    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",
@@ -566,7 +324,8 @@ export class Commands {
             target: "string",
             team: "bool",
             "webhook-url": "string",
-        });
+        }, false);
+        return result;
     }
     /**
      * Attach an integration to a VM, tag, or all VMs
@@ -594,32 +353,35 @@ export class Commands {
      * int attach gmail vm:dev1 --for 2h
      * ```
      */
-    integrationsAttach(name, spec, options) {
-        return this.run("integrations attach", [name, spec], options, {
+    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]`
      */
-    integrationsDetach(name, spec, options) {
-        return this.run("integrations detach", [name, spec], options, {
+    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]`
      */
-    integrationsRename(name, newName, options) {
-        return this.run("integrations rename", [name, newName], options, {
+    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
@@ -632,74 +394,83 @@ export class Commands {
      * int catalog stripe
      * ```
      */
-    integrationsCatalog(serviceOrSearchTerm, options) {
-        return this.run("integrations catalog", [serviceOrSearchTerm], options, {});
+    async integrationsCatalog(serviceOrSearchTerm, options) {
+        const result = await this.#transport.call("integrations catalog", [serviceOrSearchTerm], options, {}, false);
+        return result;
     }
     /**
      * View and manage your team
      */
-    team(options) {
-        return this.run("team", [], options, {});
+    async team(options) {
+        const result = await this.#transport.call("team", [], options, {}, false);
+        return result;
     }
     /**
      * Disband your team
      *
      * Usage: `team disable`
      */
-    teamDisable(options) {
-        return this.run("team disable", [], options, {
+    async teamDisable(options) {
+        const result = await this.#transport.call("team disable", [], options, {
             yes: "bool",
-        });
+        }, false);
+        return result;
     }
     /**
      * List team members
      *
      * Usage: `team members`
      */
-    teamMembers(options) {
-        return this.run("team members", [], options, {});
+    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`
      */
-    teamUsage(options) {
-        return this.run("team usage", [], options, {});
+    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>]`
      */
-    teamAdd(email, userOrAdminOrBillingOwner, options) {
-        return this.run("team add", [email, userOrAdminOrBillingOwner], options, {});
+    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>]`
      */
-    teamRemove(email, options) {
-        return this.run("team remove", [email], options, {
+    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>`
      */
-    teamRole(email, userOrAdminOrBillingOwner, options) {
-        return this.run("team role", [email, userOrAdminOrBillingOwner], options, {});
+    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>`
      */
-    teamRename(name, options) {
-        return this.run("team rename", [name], options, {});
+    async teamRename(name, options) {
+        const result = await this.#transport.call("team rename", [name], options, {}, false);
+        return result;
     }
     /**
      * Show your team's plan
@@ -712,18 +483,19 @@ export class Commands {
      * team billing plan --all   # plans your team can switch to
      * ```
      */
-    teamBillingPlan(options) {
-        return this.run("team billing plan", [], options, {
+    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>]`
      */
-    teamBillingUpdate(options) {
-        return this.run("team billing update", [], options, {
+    async teamBillingUpdate(options) {
+        const result = await this.#transport.call("team billing update", [], options, {
             "address-city": "string",
             "address-country": "string",
             "address-line1": "string",
@@ -736,127 +508,142 @@ export class Commands {
             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>`
      */
-    teamTransfer(vmName, targetEmail, options) {
-        return this.run("team transfer", [vmName, targetEmail], options, {});
+    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`
      */
-    teamAuth(options) {
-        return this.run("team auth", [], options, {});
+    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>`
      */
-    teamAuthRequireOidc(webOrOff, options) {
-        return this.run("team auth require-oidc", [webOrOff], options, {});
+    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>]`
      */
-    teamAuthSet(defaultOrGoogleOrOidc, options) {
-        return this.run("team auth set", [defaultOrGoogleOrOidc], options, {
+    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`
      */
-    teamSettings(options) {
-        return this.run("team settings", [], options, {});
+    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`
      */
-    teamSettingsVmPlacement(options) {
-        return this.run("team settings vm-placement", [], options, {});
+    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`
      */
-    teamSettingsVmPlacementDefault(options) {
-        return this.run("team settings vm-placement default", [], options, {});
+    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>`
      */
-    teamSettingsVmPlacementPool(name, options) {
-        return this.run("team settings vm-placement pool", [name], options, {});
+    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]`
      */
-    teamSettingsVmPlacementMemberPool(options) {
-        return this.run("team settings vm-placement member-pool", [], options, {
+    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`
      */
-    teamSettingsVmPlacementPoolless(options) {
-        return this.run("team settings vm-placement poolless", [], options, {});
+    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>`
      */
-    teamSettingsStandalone(offOrAdminsOnlyOrAllUsers, options) {
-        return this.run("team settings standalone", [offOrAdminsOnlyOrAllUsers], options, {});
+    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>`
      */
-    teamSettingsLlmGateway(onOrOff, options) {
-        return this.run("team settings llm-gateway", [onOrOff], options, {});
+    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>`
      */
-    teamSettingsCoreSharing(onOrOff, options) {
-        return this.run("team settings core-sharing", [onOrOff], options, {});
+    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>`
      */
-    teamSettingsVmSharing(adminsOnlyOrAllMembers, options) {
-        return this.run("team settings vm-sharing", [adminsOnlyOrAllMembers], options, {});
+    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
@@ -869,16 +656,18 @@ export class Commands {
      * team settings session-length default
      * ```
      */
-    teamSettingsSessionLength(length, options) {
-        return this.run("team settings session-length", [length], options, {});
+    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>`
      */
-    teamSettingsAutoJoin(onOrOff, options) {
-        return this.run("team settings auto-join", [onOrOff], options, {});
+    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
@@ -887,42 +676,46 @@ export class Commands {
      *
      * Tag-scoped API keys may run this command.
      */
-    teamVmLs(nameOrPattern, options) {
-        return this.run("team vm ls", [nameOrPattern], options, {
+    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]`
      */
-    poolNew(name, options) {
-        return this.run("pool new", [name], options, {
+    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`
      */
-    poolHosts(options) {
-        return this.run("pool hosts", [], options, {});
+    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]]`
      */
-    poolList(poolName, options) {
-        return this.run("pool list", [poolName], options, {
+    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
@@ -934,11 +727,12 @@ export class Commands {
      * pool adopt --vm=builder --pool=compile
      * ```
      */
-    poolAdopt(options) {
-        return this.run("pool adopt", [], options, {
+    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)
@@ -951,39 +745,43 @@ export class Commands {
      * pool detach --vm=builder --poolless
      * ```
      */
-    poolDetach(options) {
-        return this.run("pool detach", [], options, {
+    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]`
      */
-    poolResize(args, options) {
-        return this.run("pool resize", [args], options, {
+    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>`
      */
-    poolRename(oldName, newName, options) {
-        return this.run("pool rename", [oldName, newName], options, {});
+    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]`
      */
-    poolDelete(name, options) {
-        return this.run("pool delete", [name], options, {});
+    async poolDelete(name, options) {
+        const result = await this.#transport.call("pool delete", [name], options, {}, false);
+        return result;
     }
     /**
      * Show your current plan and resource limits
@@ -996,10 +794,11 @@ export class Commands {
      * billing plan --all   # plans you can switch to
      * ```
      */
-    billingPlan(options) {
-        return this.run("billing plan", [], options, {
+    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
@@ -1012,19 +811,21 @@ export class Commands {
      * billing credits usage   # Shelley/LLM credit spend instead
      * ```
      */
-    billingUsage(options) {
-        return this.run("billing usage", [], options, {
+    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]`
      */
-    billingCredits(options) {
-        return this.run("billing credits", [], options, {});
+    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
@@ -1038,22 +839,24 @@ export class Commands {
      * billing credits usage --month=2026-05 --group=box
      * ```
      */
-    billingCreditsUsage(options) {
-        return this.run("billing credits usage", [], options, {
+    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]`
      */
-    billingCreditsTransactions(options) {
-        return this.run("billing credits transactions", [], options, {
+    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
@@ -1066,19 +869,21 @@ export class Commands {
      * billing credits buy 100 --yes
      * ```
      */
-    billingCreditsBuy(dollars, options) {
-        return this.run("billing credits buy", [dollars], options, {
+    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`
      */
-    billingRewards(options) {
-        return this.run("billing rewards", [], options, {});
+    async billingRewards(options) {
+        const result = await this.#transport.call("billing rewards", [], options, {}, false);
+        return result;
     }
     /**
      * Change your subscription capacity
@@ -1091,27 +896,30 @@ export class Commands {
      * billing capacity --cpu=4 --yes
      * ```
      */
-    billingCapacity(options) {
-        return this.run("billing capacity", [], options, {
+    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]`
      */
-    billingPayment(options) {
-        return this.run("billing payment", [], options, {});
+    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`
      */
-    billingPaymentList(options) {
-        return this.run("billing payment list", [], options, {});
+    async billingPaymentList(options) {
+        const result = await this.#transport.call("billing payment list", [], options, {}, false);
+        return result;
     }
     /**
      * Remove a saved payment method
@@ -1123,8 +931,9 @@ export class Commands {
      * billing payment remove 4f1c2a9b8d3e
      * ```
      */
-    billingPaymentRemove(ref, options) {
-        return this.run("billing payment remove", [ref], options, {});
+    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
@@ -1136,32 +945,35 @@ export class Commands {
      * billing payment default 4f1c2a9b8d3e
      * ```
      */
-    billingPaymentDefault(ref, options) {
-        return this.run("billing payment default", [ref], options, {});
+    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`
      */
-    billingManage(options) {
-        return this.run("billing manage", [], options, {});
+    async billingManage(options) {
+        const result = await this.#transport.call("billing manage", [], options, {}, false);
+        return result;
     }
     /**
      * Open the personal plan activation page
      *
      * Usage: `billing activate`
      */
-    billingActivate(options) {
-        return this.run("billing activate", [], options, {});
+    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>]`
      */
-    billingUpdate(options) {
-        return this.run("billing update", [], options, {
+    async billingUpdate(options) {
+        const result = await this.#transport.call("billing update", [], options, {
             "address-city": "string",
             "address-country": "string",
             "address-line1": "string",
@@ -1174,15 +986,17 @@ export class Commands {
             phone: "string",
             "tax-id-type": "string",
             "tax-id-value": "string",
-        });
+        }, false);
+        return result;
     }
     /**
      * Show recent invoices
      *
      * Usage: `billing invoices`
      */
-    billingInvoices(options) {
-        return this.run("billing invoices", [], options, {});
+    async billingInvoices(options) {
+        const result = await this.#transport.call("billing invoices", [], options, {}, false);
+        return result;
     }
     /**
      * List invoices for your personal or team account
@@ -1194,10 +1008,11 @@ export class Commands {
      * billing invoices list --account=team
      * ```
      */
-    billingInvoicesList(options) {
-        return this.run("billing invoices list", [], options, {
+    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
@@ -1209,10 +1024,11 @@ export class Commands {
      * billing invoices show in_1Abc --vms
      * ```
      */
-    billingInvoicesShow(id, options) {
-        return this.run("billing invoices show", [id], options, {
+    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)
@@ -1224,11 +1040,12 @@ export class Commands {
      * billing receipts --from=2026-01-01 --to=2026-06-30
      * ```
      */
-    billingReceipts(options) {
-        return this.run("billing receipts", [], options, {
+    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
@@ -1240,105 +1057,528 @@ export class Commands {
      * billing statement --from=2026-01-01 --to=2026-06-30
      * ```
      */
-    billingStatement(options) {
-        return this.run("billing statement", [], options, {
+    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>]`
      */
-    billingProviderLink(awsOrAzure, options) {
-        return this.run("billing provider link", [awsOrAzure], options, {
+    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
      */
-    invite(options) {
-        return this.run("invite", [], options, {});
+    async invite(options) {
+        const result = await this.#transport.call("invite", [], options, {}, false);
+        return result;
     }
     /**
      * Show your active invite link and reward
      *
      * Usage: `invite show`
      */
-    inviteShow(options) {
-        return this.run("invite show", [], options, {});
+    async inviteShow(options) {
+        const result = await this.#transport.call("invite show", [], options, {}, false);
+        return result;
     }
     /**
      * Print only your active invite link
      *
      * Usage: `invite link`
      */
-    inviteLink(options) {
-        return this.run("invite link", [], options, {});
+    async inviteLink(options) {
+        const result = await this.#transport.call("invite link", [], options, {}, false);
+        return result;
     }
     /**
      * List invite rewards you can use
      *
      * Usage: `invite rewards`
      */
-    inviteRewards(options) {
-        return this.run("invite rewards", [], options, {});
+    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`
      */
-    inviteSetReward(standardOrBonusCreditsOrExtraMemoryOrExtraDisk, options) {
-        return this.run("invite set-reward", [standardOrBonusCreditsOrExtraMemoryOrExtraDisk], options, {});
+    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`
      */
-    inviteActivity(options) {
-        return this.run("invite activity", [], options, {});
+    async inviteActivity(options) {
+        const result = await this.#transport.call("invite activity", [], options, {}, false);
+        return result;
     }
     /**
      * Request more trial invites
      *
      * Usage: `invite request`
      */
-    inviteRequest(options) {
-        return this.run("invite request", [], options, {});
+    async inviteRequest(options) {
+        const result = await this.#transport.call("invite request", [], options, {}, false);
+        return result;
     }
     /**
      * Open the invites page
      *
      * Usage: `invite manage`
      */
-    inviteManage(options) {
-        return this.run("invite manage", [], options, {});
+    async inviteManage(options) {
+        const result = await this.#transport.call("invite manage", [], options, {}, false);
+        return result;
     }
     /**
-     * Install or upgrade Shelley to the current version
+     * Generate a magic link to log in to the website
      *
-     * Usage: `shelley install <vm>`
+     * 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.
+     * With waitUntil: "setup", then poll exe-setup.service until the setup script
+     * has finished, throwing VMSetupError (as VMReadyError's cause) if it failed.
+     * Images without that unit (anything but exeuntu) have no setup to wait for.
+     * This does not wait for application servers. Requires ssh permission.
+     */
+    async waitUntilReady(options = {}) {
+        const { waitUntil = "ssh" } = options;
+        if (waitUntil !== "ssh" && waitUntil !== "setup")
+            throw new TypeError("exedev: waitUntil must be ssh or setup");
+        const timeoutMs = readyTimeout(options.timeoutMs, waitUntil);
+        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(waitUntil === "setup" ? "setup did not finish in time" : "SSH readiness timed out", "TimeoutError")), timeoutMs);
+        let backoff = 100;
+        try {
+            while (true) {
+                try {
+                    const probe = waitUntil === "setup" ? setupProbe : "true";
+                    const result = await abortable(this.ssh(probe, {
+                        signal: controller.signal, capture: waitUntil === "setup", maxOutputBytes: 1 << 20,
+                    }), controller.signal);
+                    controller.signal.throwIfAborted();
+                    if (result.exitCode !== 0)
+                        throw new ExeProtocolError("ssh readiness probe");
+                    if (waitUntil === "ssh")
+                        return this;
+                    const state = setupState(result.stdout);
+                    if (state === "done")
+                        return this;
+                    if (state instanceof VMSetupError)
+                        throw state;
+                    backoff = Math.max(backoff, 1000);
+                }
+                catch (err) {
+                    controller.signal.throwIfAborted();
+                    // /exec reports these failures before a remote command starts, and
+                    // probes are safe to rerun after a lost connection. Other rejections
+                    // (not found, permissions, no SSH configured) fail fast.
+                    const retry = err instanceof SSHStreamError && err.code === "interrupted" ||
+                        err instanceof ExeAPIError && err.status === 422 &&
+                            /failed to (?:connect|dial|create session|run command on VM)/i.test(err.details().body);
+                    if (!retry)
+                        throw err;
+                }
+                await delay(backoff, controller.signal);
+                backoff = Math.min(backoff * 2, 2000);
+            }
+        }
+        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.
      */
-    shelleyInstall(vm, options) {
-        return this.run("shelley install", [vm], options, {});
+    async rm(options) {
+        const result = await this.#transport.documents("rm", [this.name], options, {});
+        const summary = rmResult(result);
+        if (summary.failed.length === 0 && summary.deleted.length === 1)
+            return summary;
+        throw new ExeAPIError("rm", summary.not_found?.length ? 404 : 422, result.body);
     }
     /**
-     * Generate a magic link to log in to the website
+     * Restart a VM
      *
-     * Usage: `browser`
+     * 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, {}, true);
+        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, {}, true);
+        if (ready)
+            await this.waitUntilReady(ready);
+        return this;
+    }
+    /**
+     * rename a vm
+     *
+     * Usage: `rename <oldname> <newname>`
+     *
+     * Tag-scoped API keys may run this command.
      */
-    browser(options) {
-        return this.run("browser", [], options, {
+    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",
+        }, true);
+        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",
+        }, true);
+        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, {}, true);
+        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",
+        }, true);
+        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, {}, true);
+        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",
-        });
+        }, true);
+        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, {}, true);
+        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, {}, true);
+        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, {}, true);
+        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",
+        }, true);
+        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",
+        }, true);
+        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",
+        }, true);
+        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, {}, true);
+        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",
+        }, true);
+        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, {}, true);
+        return result;
     }
     /**
      * Allow exe.dev support to log in to a VM
@@ -1347,8 +1587,9 @@ export class Commands {
      *
      * Tag-scoped API keys may run this command.
      */
-    grantSupportRoot(vmname, onOrOff, options) {
-        return this.run("grant-support-root", [vmname, onOrOff], options, {});
+    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
@@ -1364,10 +1605,163 @@ export class Commands {
      *
      * Tag-scoped API keys may run this command.
      */
-    stat(vmName, options) {
-        return this.run("stat", [vmName], options, {
+    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} ${readyFailure(cause)}`, { cause });
+        this.vm = vm;
+        this.name = "VMReadyError";
+    }
+}
+function readyFailure(cause) {
+    if (cause instanceof VMSetupError)
+        return cause.message.replace(/^exedev: /, "");
+    if (cause instanceof ExeAPIError && cause.status === 403 && cause.operation === "ssh") {
+        return `is not known to be ready: this token may not run ssh, which readiness needs (use waitUntil: "created")`;
+    }
+    if (cause instanceof DOMException && cause.name === "TimeoutError")
+        return `is not ready: ${cause.message}`;
+    return "is not SSH-ready";
+}
+/** The VM's setup script failed. details() has the end of its journal. */
+export class VMSetupError extends Error {
+    result;
+    exitCode;
+    signal;
+    #output;
+    constructor(
+    /** systemd's Result for exe-setup.service, e.g. "exit-code", "signal", or "timeout". */
+    result, exitCode, signal, output) {
+        super(`exedev: setup script failed (${exitCode !== undefined ? `exit code ${exitCode}` : signal !== undefined ? `signal ${signal}` : result})`);
+        this.result = result;
+        this.exitCode = exitCode;
+        this.signal = signal;
+        this.name = "VMSetupError";
+        this.#output = output;
+    }
+    /** The script's last journal lines; may contain secrets. */
+    details() { return { output: this.#output }; }
+}
+function readyTimeout(value, waitUntil) {
+    value ??= waitUntil === "setup" ? 600_000 : 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;
+    if (waitUntil !== "ssh" && waitUntil !== "setup" && waitUntil !== "created") {
+        throw new TypeError("exedev: waitUntil must be ssh, setup, or created");
+    }
+    readyTimeout(timeoutMs, waitUntil); // Validate before creating/copying/restarting a VM.
+    return waitUntil === "created" ? undefined : { waitUntil, timeoutMs, signal };
+}
+// Report exe-setup.service's state, and on failure the end of its journal.
+// exessh can answer before exe-init hands PID 1 to systemd, and then before
+// systemd's bus is up ("Failed to connect to bus"): both are "booting".
+const setupProbe = `if [ ! -d /run/systemd/system ]; then
+  if [ -e /etc/systemd/system/exe-setup.service ]; then echo State=booting; else echo State=unsupported; fi
+  exit 0
+fi
+props=$(systemctl show exe-setup.service -p LoadState -p ActiveState -p Job -p Result -p ExecMainCode -p ExecMainStatus -p ExecMainExitTimestampMonotonic -p ConditionResult -p ConditionTimestampMonotonic 2>/dev/null) || { echo State=booting; exit 0; }
+echo "$props"
+echo "SystemState=$(systemctl is-system-running 2>/dev/null)"
+if [ "$(systemctl show exe-setup.service -p ActiveState --value)" = failed ]; then
+  echo ---
+  journalctl -b -u exe-setup.service -o cat --no-pager -n 50 2>&1
+fi`;
+/** "done" covers success and having no setup script, or no setup runner, to wait for. */
+function setupState(output) {
+    const [head, ...journal] = output.split("\n---\n");
+    const p = {};
+    for (const line of head.split("\n")) {
+        const at = line.indexOf("=");
+        if (at > 0)
+            p[line.slice(0, at)] = line.slice(at + 1).trim();
+    }
+    const number = (key) => /^\d+$/.test(p[key] ?? "") ? Number(p[key]) : undefined;
+    if (p.State === "booting")
+        return "pending";
+    if (p.State === "unsupported" || p.LoadState === "not-found")
+        return "done";
+    if (!p.LoadState || !p.ActiveState)
+        throw new ExeProtocolError("ssh setup probe");
+    if (p.Job && p.Job !== "0" || ["activating", "deactivating", "reloading"].includes(p.ActiveState))
+        return "pending";
+    if (p.ActiveState === "failed" || number("ExecMainExitTimestampMonotonic") && p.Result !== "success") {
+        // ExecMainCode: 1 exited, 2 killed, 3 dumped core. ExecMainStatus is the code or signal.
+        const code = number("ExecMainCode"), status = number("ExecMainStatus");
+        return new VMSetupError(p.Result || "failed", code === 1 ? status : undefined, code === 2 || code === 3 ? status : undefined, journal.join("\n---\n"));
+    }
+    if (number("ExecMainExitTimestampMonotonic"))
+        return "done";
+    if (number("ConditionTimestampMonotonic") && p.ConditionResult === "no")
+        return "done";
+    // Not reached yet while the system boots; otherwise it is not going to run.
+    return ["initializing", "starting"].includes(p.SystemState) ? "pending" : "done";
+}
+function rmResult(value) {
+    const summary = value.docs?.filter((doc) => !isErrorDocument(doc));
+    const strings = (v) => Array.isArray(v) && v.every((s) => typeof s === "string");
+    const obj = summary?.length === 1 ? summary[0] : undefined;
+    if (!obj || typeof obj !== "object" || !strings(obj.deleted) || !strings(obj.failed) ||
+        obj.not_found !== undefined && !strings(obj.not_found) ||
+        obj.errors !== undefined && (typeof obj.errors !== "object" || obj.errors === null || Array.isArray(obj.errors) ||
+            !Object.values(obj.errors).every((s) => typeof s === "string"))) {
+        throw new ExeProtocolError("rm");
+    }
+    return obj;
+}
+function vmName(name) {
+    if (name instanceof VM)
+        return name.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 name;
+}
+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"),
+        promptError: 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