@exedev/sdk 0.0.6 → 0.2.0

package/dist/commands.gen.d.ts

@@ -0,0 +1,1468 @@
+import { Transport } from "./client.js";
+import type { ExedevOptions, SSHOptions, SSHResult } from "./client.js";
+import type { CommandResults } from "./types.js";
+export interface CallOptions {
+    signal?: AbortSignal;
+}
+export interface WaitOptions extends CallOptions {
+    /** SSH readiness deadline, in milliseconds. Default 60,000. */
+    timeoutMs?: number;
+}
+export interface ReadyOptions extends WaitOptions {
+    /** Default ssh. Use created to return without probing (and without ssh permission). */
+    waitUntil?: "ssh" | "created";
+}
+export interface VMInfo {
+    readonly name: string;
+    readonly tags: readonly string[];
+    readonly sshDest?: string;
+    readonly httpsUrl?: string;
+    readonly status?: string;
+    readonly region?: string;
+    readonly comment?: string;
+    readonly createdAt?: string;
+    readonly setupError?: string;
+}
+export type CommandResult<P extends string> = P extends keyof CommandResults ? CommandResults[P] : unknown;
+export type FlagKind = "bool" | "number" | "string" | "repeated";
+export type Arg = string | readonly string[] | undefined;
+/** Options for {@link ExedevClient.ls}. */
+export interface LsOptions extends CallOptions {
+    /** group VMs by none|tag|region|type (default: none) */
+    group?: "none" | "tag" | "region";
+    /** show detailed information */
+    l?: boolean;
+}
+/** Options for {@link ExedevClient.new}. */
+export interface NewOptions extends ReadyOptions {
+    /** short note about the VM (max 200 bytes) */
+    comment?: string;
+    /** number of CPUs (default 2; run 'billing plan' for plan limits) */
+    cpu?: number;
+    /** disk size (e.g., 20, 20GB, 50G) */
+    disk?: string;
+    /** environment variable in KEY=VALUE format (can be specified multiple times) */
+    env?: string | readonly string[];
+    /** container image (default: exeuntu) */
+    image?: string;
+    /** integration name to attach (can be specified multiple times or comma-separated) */
+    integration?: string | readonly string[];
+    /** memory allocation (e.g., 4, 4GB, 8G) */
+    memory?: string;
+    /** VM name (auto-generated if not specified) */
+    name?: string;
+    /** do not send email notification */
+    "no-email"?: boolean;
+    /** use ordinary placement (not available on plans that place new VMs in pools) */
+    "no-pool"?: boolean;
+    /** create the VM in one of your team's pools (see 'pool list') */
+    pool?: string;
+    /** initial prompt to send to Shelley after VM creation (requires an image with Shelley, like exeuntu); use /dev/stdin to read from stdin */
+    prompt?: string;
+    /** private container registry credentials as USERNAME:PASSWORD (e.g. octocat:ghp_xxx) for the registry hosting --image */
+    "registry-auth"?: string;
+    /** alias for --standalone */
+    sandbox?: boolean;
+    /** setup script to run on first boot (max 10KiB); supports \n for newlines; use /dev/stdin to pipe from stdin */
+    "setup-script"?: string;
+    /** create a standalone VM with its own reserved capacity (requires a plan with standalone VMs and team approval) */
+    standalone?: boolean;
+    /** tag to add to the VM (can be specified multiple times or comma-separated) */
+    tag?: string | readonly string[];
+}
+/** Options for {@link VM.tag}. */
+export interface TagOptions extends CallOptions {
+    /** delete tag */
+    d?: boolean;
+}
+/** Options for {@link VM.cp}. */
+export interface CpOptions extends ReadyOptions {
+    /** Name of the copy; omitted to generate one. */
+    name?: string;
+    /** copy tags from source VM (use --copy-tags=false to disable) (default: true) */
+    "copy-tags"?: boolean;
+    /** number of CPUs */
+    cpu?: number;
+    /** disk size (e.g., 20, 20GB, 50G) */
+    disk?: string;
+    /** memory allocation (e.g., 4, 4GB, 8G) */
+    memory?: string;
+    /** create the copy in one of your team's pools (see 'pool list') */
+    pool?: string;
+    /** alias for --standalone */
+    sandbox?: boolean;
+    /** create the copy as a standalone VM with its own reserved capacity (requires a plan with standalone VMs and team approval) */
+    standalone?: boolean;
+}
+/** Options for {@link VM.resize}. */
+export interface ResizeOptions extends CallOptions {
+    /** number of CPUs */
+    cpu?: number;
+    /** new total disk size (e.g., 25, 25GB) - disk size can only increase; billed by usage above your plan's included disk, not by size */
+    disk?: string;
+    /** memory allocation (e.g., 4, 4GB, 8G) */
+    memory?: string;
+}
+/** Options for {@link VM.domainAdd}. */
+export interface DomainAddOptions extends CallOptions {
+    /** issue a wildcard (*.<parent>) certificate via DNS-01 delegation */
+    wildcard?: boolean;
+}
+/** Options for {@link ExedevClient.domainLs}. */
+export interface DomainLsOptions extends CallOptions {
+    /** list domains across all your VMs */
+    a?: boolean;
+}
+/** Options for {@link VM.shareShow}. */
+export interface ShareShowOptions extends CallOptions {
+    /** show QR code for the URL */
+    qr?: boolean;
+}
+/** Options for {@link VM.shareAdd}. */
+export interface ShareAddOptions extends CallOptions {
+    /** message to include in share invitation */
+    message?: string;
+    /** show QR code for the URL */
+    qr?: boolean;
+    /** grant/revoke shell (SSH, Terminal, Shelley) access instead of web-only */
+    root?: boolean;
+}
+/** Options for {@link VM.shareRemove}. */
+export interface ShareRemoveOptions extends CallOptions {
+    /** grant/revoke shell (SSH, Terminal, Shelley) access instead of web-only */
+    root?: boolean;
+}
+/** Options for {@link VM.shareAddLink}. */
+export interface ShareAddLinkOptions extends CallOptions {
+    /** show QR code for the URL */
+    qr?: boolean;
+}
+/** Options for {@link VM.shareReceiveEmail}. */
+export interface ShareReceiveEmailOptions extends CallOptions {
+    /** restrict who the VM may email: all|known|owner|none */
+    "reply-policy"?: string;
+}
+/** Options for {@link ExedevClient.sshKeyAdd}. */
+export interface SshKeyAddOptions extends CallOptions {
+    /** scope key to VMs with this tag */
+    tag?: string;
+}
+/** Options for {@link ExedevClient.sshKeyGenerateApiKey}. */
+export interface SshKeyGenerateApiKeyOptions extends CallOptions {
+    /** comma-separated list of allowed commands (empty = defaults) */
+    cmds?: string;
+    /** expiry duration (e.g. 30d, 1y) or 'never' */
+    exp?: string;
+    /** label for this token's SSH key */
+    label?: string;
+    /** scope key to a VM (authenticates to its HTTPS endpoints instead of exe.dev commands) */
+    vm?: string;
+}
+/** Options for {@link ExedevClient.integrationsList}. */
+export interface IntegrationsListOptions extends CallOptions {
+    /** include per-VM usage (lastUsedAt, usedByVMs); JSON only */
+    usage?: boolean;
+}
+/** Options for {@link ExedevClient.integrationsSetupGithub}. */
+export interface IntegrationsSetupGithubOptions extends CallOptions {
+    /** disconnect GitHub account */
+    d?: boolean;
+    /** disconnect GitHub account */
+    delete?: boolean;
+    /** list connected GitHub accounts */
+    list?: boolean;
+    /** verify GitHub connections are working */
+    verify?: boolean;
+}
+/** Options for {@link ExedevClient.integrationsSetupChatgpt}. */
+export interface IntegrationsSetupChatgptOptions extends CallOptions {
+    /** disconnect ChatGPT account */
+    d?: boolean;
+    /** disconnect ChatGPT account */
+    delete?: boolean;
+    /** list connected ChatGPT accounts */
+    list?: boolean;
+    /** local ChatGPT account name (default chatgpt) */
+    name?: string;
+    /** verify ChatGPT connections are working */
+    verify?: boolean;
+}
+/** Options for {@link ExedevClient.integrationsAdd}. */
+export interface IntegrationsAddOptions extends CallOptions {
+    /** authenticate as your GitHub user instead of the exe.dev app (github only); pushes and API calls are attributed to your GitHub account */
+    "act-as-user"?: boolean;
+    /** attach to a spec (vm:<name>, tag:<name>, or auto:all); can be repeated */
+    attach?: string | readonly string[];
+    /** bearer token (shorthand for --header="Authorization:Bearer TOKEN"; combines with --header) */
+    bearer?: string;
+    /** optional free-form comment stored with the integration */
+    comment?: string;
+    /** install the canonical reflection integration with all fields; attaches to auto:all unless --attach=vm:<name> is supplied; no other customization */
+    default?: boolean;
+    /** comma-separated reflection fields to expose (email, integrations, tags, comment, default_port); 'all' exposes every field including ones added in the future; 'none' disables every field (default: all) */
+    fields?: string;
+    /** time-box every --attach to a duration from now (e.g. 2h, 45m); access lapses automatically */
+    for?: string;
+    /** header to inject (e.g. X-Auth:secret); can be repeated */
+    header?: string | readonly string[];
+    /** host keys for ssh-key: authorized_keys or known_hosts lines (hostnames are ignored), or '*' for any; can be repeated; one - reads them piped in, e.g. from ssh-keyscan */
+    "host-key"?: string | readonly string[];
+    /** integration name (required unless --default) */
+    name?: string;
+    /** create an endpoint integration with no injected authentication */
+    "no-auth"?: boolean;
+    /** authenticate with a generated API key scoped to the target VM; combines with --header/--bearer */
+    peer?: boolean;
+    /** restrict the integration to read access (github only); git push and write API calls are rejected */
+    readonly?: boolean;
+    /** GitHub repository in owner/repo format (required for github) */
+    repository?: string;
+    /** path prefix to strip from each request before forwarding (http-proxy only; e.g. /api/v3 makes /api/v3/users reach the target as /users) */
+    "strip-prefix"?: string;
+    /** target URL (required for http-proxy) */
+    target?: string;
+    /** create as a team integration */
+    team?: boolean;
+}
+/** Options for {@link ExedevClient.integrationsRemove}. */
+export interface IntegrationsRemoveOptions extends CallOptions {
+    /** operate on a team integration */
+    team?: boolean;
+}
+/** Options for {@link ExedevClient.integrationsTest}. */
+export interface IntegrationsTestOptions extends CallOptions {
+    /** operate on a team integration */
+    team?: boolean;
+}
+/** Options for {@link ExedevClient.integrationsEdit}. */
+export interface IntegrationsEditOptions extends CallOptions {
+    /** authenticate as your GitHub user instead of the exe.dev app (github only) */
+    "act-as-user"?: boolean;
+    /** bearer token (shorthand for --header="Authorization:Bearer TOKEN"; combines with --header) */
+    bearer?: string;
+    /** remove injected headers for http-proxy */
+    "clear-header"?: boolean;
+    /** free-form comment stored with the integration */
+    comment?: string;
+    /** comma-separated reflection fields to expose (email, integrations, tags, comment, default_port); 'all' exposes every field including ones added in the future; 'none' disables every field */
+    fields?: string;
+    /** header to inject for http-proxy; can be repeated; replaces all existing headers */
+    header?: string | readonly string[];
+    /** replacement host keys for ssh-key; replaces the whole list; can be repeated; one - reads them piped in */
+    "host-key"?: string | readonly string[];
+    /** remove injected authentication for http-proxy */
+    "no-auth"?: boolean;
+    /** restrict the integration to read access (github only) */
+    readonly?: boolean;
+    /** GitHub repository in owner/repo format */
+    repository?: string;
+    /** path prefix to strip from each request before forwarding (http-proxy only; e.g. /api/v3; empty clears it) */
+    "strip-prefix"?: string;
+    /** target URL for http-proxy */
+    target?: string;
+    /** edit a team integration */
+    team?: boolean;
+    /** replacement Slack or Discord webhook URL */
+    "webhook-url"?: string;
+}
+/** Options for {@link ExedevClient.integrationsAttach}. */
+export interface IntegrationsAttachOptions extends CallOptions {
+    /** time-box the attachment to a duration from now (e.g. 2h, 45m); access lapses automatically */
+    for?: string;
+    /** operate on a team integration */
+    team?: boolean;
+    /** time-box the attachment until an RFC3339 instant (e.g. 2026-08-03T20:00:00Z) */
+    until?: string;
+}
+/** Options for {@link ExedevClient.integrationsDetach}. */
+export interface IntegrationsDetachOptions extends CallOptions {
+    /** operate on a team integration */
+    team?: boolean;
+}
+/** Options for {@link ExedevClient.integrationsRename}. */
+export interface IntegrationsRenameOptions extends CallOptions {
+    /** operate on a team integration */
+    team?: boolean;
+}
+/** Options for {@link ExedevClient.teamDisable}. */
+export interface TeamDisableOptions extends CallOptions {
+    /** skip the confirmation prompt (required for non-interactive use, e.g. the web UI) */
+    yes?: boolean;
+}
+/** Options for {@link ExedevClient.teamRemove}. */
+export interface TeamRemoveOptions extends CallOptions {
+    /** transfer the member's VMs to this team member before removing them */
+    "transfer-vms-to"?: string;
+}
+/** Options for {@link ExedevClient.teamBillingPlan}. */
+export interface TeamBillingPlanOptions extends CallOptions {
+    /** list the plans you can switch to */
+    all?: boolean;
+}
+/** Options for {@link ExedevClient.teamBillingUpdate}. */
+export interface TeamBillingUpdateOptions extends CallOptions {
+    /** billing address city */
+    "address-city"?: string;
+    /** billing address country code */
+    "address-country"?: string;
+    /** billing address line 1 */
+    "address-line1"?: string;
+    /** billing address line 2 */
+    "address-line2"?: string;
+    /** billing address postal code */
+    "address-postal-code"?: string;
+    /** billing address state or province */
+    "address-state"?: string;
+    /** business name shown on invoices */
+    "business-name"?: string;
+    /** billing email shown on invoices */
+    email?: string;
+    /** customer name shown on invoices */
+    name?: string;
+    /** phone number shown on invoices */
+    phone?: string;
+    /** tax ID type shown on invoices (e.g. eu_vat, pl_nip, us_ein) */
+    "tax-id-type"?: string;
+    /** tax ID value shown on invoices */
+    "tax-id-value"?: string;
+}
+/** Options for {@link ExedevClient.teamAuthSet}. */
+export interface TeamAuthSetOptions extends CallOptions {
+    /** OIDC client ID */
+    "client-id"?: string;
+    /** OIDC client secret */
+    "client-secret"?: string;
+    /** display name for the SSO provider */
+    "display-name"?: string;
+    /** OIDC issuer URL (e.g. https://accounts.google.com) */
+    "issuer-url"?: string;
+}
+/** Options for {@link ExedevClient.teamSettingsVmPlacementMemberPool}. */
+export interface TeamSettingsVmPlacementMemberPoolOptions extends CallOptions {
+    /** CPUs to reserve for each member pool (required) */
+    cpus?: number;
+    /** maximum VMs in each member pool (Work defaults to 25 per vCPU, up to 1000) (default: 100) */
+    "max-vms"?: number;
+}
+/** Options for {@link ExedevClient.teamVmLs}. */
+export interface TeamVmLsOptions extends CallOptions {
+    /** group VMs by none|tag|region|type|user|access (default: none) */
+    group?: "none" | "tag" | "region" | "user" | "access";
+    /** show detailed information */
+    l?: boolean;
+}
+/** Options for {@link ExedevClient.poolNew}. */
+export interface PoolNewOptions extends CallOptions {
+    /** number of CPUs reserved for the pool (required; an even number of vCPUs from 2 through 512 (2, 4, 6, and so on; memory is 2 GiB per vCPU)) */
+    cpus?: number;
+    /** maximum VMs in the pool (Work defaults to the size limit of up to 25 VMs per vCPU, capped at 1000 VMs) (default: 100) */
+    "max-vms"?: number;
+    /** region code for the pool (required unless your team has dedicated hosts, which decide the region) */
+    region?: string;
+}
+/** Options for {@link ExedevClient.poolList}. */
+export interface PoolListOptions extends CallOptions {
+    /** statistics range: live, 24h, 7d, or 30d (requires --usage) (default: live) */
+    range?: string;
+    /** show live or historical CPU and starvation statistics */
+    usage?: boolean;
+}
+/** Options for {@link ExedevClient.poolAdopt}. */
+export interface PoolAdoptOptions extends CallOptions {
+    /** pool to adopt into (required) */
+    pool?: string;
+    /** VM to adopt (required) */
+    vm?: string;
+}
+/** Options for {@link ExedevClient.poolDetach}. */
+export interface PoolDetachOptions extends CallOptions {
+    /** leave the VM outside any pool instead of making it standalone (only while your team has poolless VMs) */
+    poolless?: boolean;
+    /** VM to detach from its pool (required) */
+    vm?: string;
+}
+/** Options for {@link ExedevClient.poolResize}. */
+export interface PoolResizeOptions extends CallOptions {
+    /** new pool size in vCPUs (required unless --max-vms is set; even, from 2 up to the placement limit) */
+    cpus?: number;
+    /** allow --max-vms below the current VM count (does not stop or evict VMs) */
+    force?: boolean;
+    /** maximum VMs in the pool (Work: at most 25 per vCPU, up to 1000) */
+    "max-vms"?: string;
+}
+/** Options for {@link ExedevClient.billingPlan}. */
+export interface BillingPlanOptions extends CallOptions {
+    /** list the plans you can switch to */
+    all?: boolean;
+}
+/** Options for {@link ExedevClient.billingUsage}. */
+export interface BillingUsageOptions extends CallOptions {
+    /** group usage by: vm */
+    group?: string;
+    /** time range: cycle (current billing cycle), 24h, 7d, or 30d (default: cycle) */
+    range?: string;
+}
+/** Options for {@link ExedevClient.billingCreditsUsage}. */
+export interface BillingCreditsUsageOptions extends CallOptions {
+    /** break each group down: models under a day or VM, VMs under a model */
+    detail?: boolean;
+    /** group spend by model, day, or box (default: model) */
+    group?: string;
+    /** calendar month to report, as YYYY-MM (default: this month, UTC) */
+    month?: string;
+}
+/** Options for {@link ExedevClient.billingCreditsTransactions}. */
+export interface BillingCreditsTransactionsOptions extends CallOptions {
+    /** how many transactions to show, 1-100 (default 20) */
+    limit?: string;
+}
+/** Options for {@link ExedevClient.billingCreditsBuy}. */
+export interface BillingCreditsBuyOptions extends CallOptions {
+    /** retry key so a repeated purchase of the same amount charges once */
+    "idempotency-key"?: string;
+    /** skip the confirmation prompt (required when not running interactively) */
+    yes?: boolean;
+}
+/** Options for {@link ExedevClient.billingCapacity}. */
+export interface BillingCapacityOptions extends CallOptions {
+    /** Personal capacity in vCPUs: 2, 4, 8, or 16 */
+    cpu?: number;
+    /** skip interactive confirmation (required for non-interactive changes) */
+    yes?: boolean;
+}
+/** Options for {@link ExedevClient.billingUpdate}. */
+export interface BillingUpdateOptions extends CallOptions {
+    /** billing address city */
+    "address-city"?: string;
+    /** billing address country code */
+    "address-country"?: string;
+    /** billing address line 1 */
+    "address-line1"?: string;
+    /** billing address line 2 */
+    "address-line2"?: string;
+    /** billing address postal code */
+    "address-postal-code"?: string;
+    /** billing address state or province */
+    "address-state"?: string;
+    /** business name shown on invoices */
+    "business-name"?: string;
+    /** billing email shown on invoices */
+    email?: string;
+    /** customer name shown on invoices */
+    name?: string;
+    /** phone number shown on invoices */
+    phone?: string;
+    /** tax ID type shown on invoices (e.g. eu_vat, pl_nip, us_ein) */
+    "tax-id-type"?: string;
+    /** tax ID value shown on invoices */
+    "tax-id-value"?: string;
+}
+/** Options for {@link ExedevClient.billingInvoicesList}. */
+export interface BillingInvoicesListOptions extends CallOptions {
+    /** account whose invoices to list: personal or team (default: personal) */
+    account?: string;
+}
+/** Options for {@link ExedevClient.billingInvoicesShow}. */
+export interface BillingInvoicesShowOptions extends CallOptions {
+    /** list VMs without a pool individually */
+    vms?: boolean;
+}
+/** Options for {@link ExedevClient.billingReceipts}. */
+export interface BillingReceiptsOptions extends CallOptions {
+    /** start of the period, YYYY-MM-DD */
+    from?: string;
+    /** end of the period, YYYY-MM-DD */
+    to?: string;
+}
+/** Options for {@link ExedevClient.billingStatement}. */
+export interface BillingStatementOptions extends CallOptions {
+    /** start of the period, YYYY-MM-DD */
+    from?: string;
+    /** end of the period, YYYY-MM-DD */
+    to?: string;
+}
+/** Options for {@link ExedevClient.billingProviderLink}. */
+export interface BillingProviderLinkOptions extends CallOptions {
+    /** team size: no marketplace team plans are available */
+    size?: string;
+    /** name for the team to create (only when you have no team yet) */
+    "team-name"?: string;
+    /** marketplace link token from the exe.dev link page */
+    token?: string;
+}
+/** Options for {@link ExedevClient.browser}. */
+export interface BrowserOptions extends CallOptions {
+    /** show QR code for the URL */
+    qr?: boolean;
+}
+/** Options for {@link VM.stat}. */
+export interface StatOptions extends CallOptions {
+    /** time range: 24h, 7d, or 30d (default: 24h) */
+    range?: string;
+}
+export declare class ExedevClient {
+    #private;
+    constructor(options: ExedevOptions);
+    /** Reference an existing VM without a request. Use refresh() to fetch its metadata. */
+    vm(name: string): VM;
+    /**
+     * Browse documentation
+     *
+     * Usage: `doc [slug-or-query...]`
+     *
+     * Tag-scoped API keys may run this command.
+     */
+    doc(slugOrQueries?: string | readonly string[], options?: CallOptions): Promise<CommandResult<"doc">>;
+    /**
+     * List your VMs
+     *
+     * Usage: `ls [-l] [--group=tag|region|type] [name|pattern]`
+     *
+     * Tag-scoped API keys may run this command.
+     */
+    ls(nameOrPattern?: string, options?: LsOptions): Promise<VM[]>;
+    /**
+     * 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.
+     */
+    new(options?: NewOptions): Promise<VM>;
+    /**
+     * List custom domains for a VM (or -a for all your VMs)
+     *
+     * Usage: `domain ls <vm> | domain ls -a`
+     */
+    domainLs(args?: readonly string[], options?: DomainLsOptions): Promise<CommandResult<"domain ls">>;
+    /**
+     * Show user information (email, keys, etc)
+     *
+     * Usage: `whoami`
+     *
+     * Tag-scoped API keys may run this command.
+     */
+    whoami(options?: CallOptions): Promise<CommandResult<"whoami">>;
+    /**
+     * List all SSH keys associated with your account
+     *
+     * Usage: `ssh-key list`
+     *
+     * Tag-scoped API keys may run this command.
+     */
+    sshKeyList(options?: CallOptions): Promise<CommandResult<"ssh-key list">>;
+    /**
+     * 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.
+     */
+    sshKeyAdd(publicKey: string, options?: SshKeyAddOptions): Promise<CommandResult<"ssh-key add">>;
+    /**
+     * Remove an SSH key from your account
+     *
+     * Usage: `ssh-key remove <name|fingerprint|public-key>`
+     *
+     * Tag-scoped API keys may run this command.
+     */
+    sshKeyRemove(nameOrFingerprintOrPublicKey: string, options?: CallOptions): Promise<CommandResult<"ssh-key remove">>;
+    /**
+     * Rename an SSH key
+     *
+     * Usage: `ssh-key rename <old-name> <new-name>`
+     *
+     * Tag-scoped API keys may run this command.
+     */
+    sshKeyRename(oldName: string, newName: string, options?: CallOptions): Promise<CommandResult<"ssh-key rename">>;
+    /**
+     * 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.
+     */
+    sshKeyGenerateApiKey(options?: SshKeyGenerateApiKeyOptions): Promise<CommandResult<"ssh-key generate-api-key">>;
+    /**
+     * Set your preferred region for new VMs.
+     *
+     * Usage: `set-region <region-code>`
+     */
+    setRegion(regionCode: string, options?: CallOptions): Promise<CommandResult<"set-region">>;
+    /**
+     * List your integrations
+     *
+     * Usage: `integrations list [--json [--usage]]`
+     *
+     * Tag-scoped API keys may run this command.
+     */
+    integrationsList(options?: IntegrationsListOptions): Promise<CommandResult<"integrations list">>;
+    /**
+     * Set up GitHub integration
+     *
+     * Usage: `integrations setup github [--list|--verify|-d]`
+     */
+    integrationsSetupGithub(options?: IntegrationsSetupGithubOptions): Promise<CommandResult<"integrations setup github">>;
+    /**
+     * Set up ChatGPT account access for LLM integrations
+     *
+     * Usage: `integrations setup chatgpt [--name=<account-name>|--list|--verify|-d]`
+     */
+    integrationsSetupChatgpt(options?: IntegrationsSetupChatgptOptions): Promise<CommandResult<"integrations setup chatgpt">>;
+    /**
+     * 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...]]`
+     */
+    integrationsAdd(type: string, options?: IntegrationsAddOptions): Promise<CommandResult<"integrations add">>;
+    /**
+     * Remove an integration
+     *
+     * Usage: `integrations remove <name> [--team]`
+     */
+    integrationsRemove(name: string, options?: IntegrationsRemoveOptions): Promise<CommandResult<"integrations remove">>;
+    /**
+     * Test an integration's credential (connection check)
+     *
+     * Usage: `integrations test <name> [--team]`
+     */
+    integrationsTest(name: string, options?: IntegrationsTestOptions): Promise<CommandResult<"integrations test">>;
+    /**
+     * 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...]`
+     */
+    integrationsEdit(name: string, args?: string | readonly string[], options?: IntegrationsEditOptions): Promise<CommandResult<"integrations edit">>;
+    /**
+     * 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
+     * ```
+     */
+    integrationsAttach(name: string, spec: string, options?: IntegrationsAttachOptions): Promise<CommandResult<"integrations attach">>;
+    /**
+     * Detach an integration from a VM, tag, or all VMs
+     *
+     * Usage: `integrations detach <name> <spec> [--team]`
+     */
+    integrationsDetach(name: string, spec: string, options?: IntegrationsDetachOptions): Promise<CommandResult<"integrations detach">>;
+    /**
+     * Rename an integration
+     *
+     * Usage: `integrations rename <name> <new-name> [--team]`
+     */
+    integrationsRename(name: string, newName: string, options?: IntegrationsRenameOptions): Promise<CommandResult<"integrations rename">>;
+    /**
+     * Browse the catalog of ready-made service integrations
+     *
+     * Usage: `integrations catalog [service-or-search-term]`
+     *
+     * CLI examples:
+     * ```
+     * int catalog
+     * int catalog stripe
+     * ```
+     */
+    integrationsCatalog(serviceOrSearchTerm?: string, options?: CallOptions): Promise<CommandResult<"integrations catalog">>;
+    /**
+     * View and manage your team
+     */
+    team(options?: CallOptions): Promise<CommandResult<"team">>;
+    /**
+     * Disband your team
+     *
+     * Usage: `team disable`
+     */
+    teamDisable(options?: TeamDisableOptions): Promise<CommandResult<"team disable">>;
+    /**
+     * List team members
+     *
+     * Usage: `team members`
+     */
+    teamMembers(options?: CallOptions): Promise<CommandResult<"team members">>;
+    /**
+     * Show team pool, disk, and bandwidth usage for the billing period
+     *
+     * Usage: `team usage`
+     */
+    teamUsage(options?: CallOptions): Promise<CommandResult<"team usage">>;
+    /**
+     * Add a user to the team
+     *
+     * Usage: `team add <email> [<user|admin|billing_owner>]`
+     */
+    teamAdd(email: string, userOrAdminOrBillingOwner?: "user" | "admin" | "billing_owner", options?: CallOptions): Promise<CommandResult<"team add">>;
+    /**
+     * Remove a user from the team
+     *
+     * Usage: `team remove <email> [--transfer-vms-to <email>]`
+     */
+    teamRemove(email: string, options?: TeamRemoveOptions): Promise<CommandResult<"team remove">>;
+    /**
+     * Change a team member's role
+     *
+     * Usage: `team role <email> <user|admin|billing_owner>`
+     */
+    teamRole(email: string, userOrAdminOrBillingOwner: "user" | "admin" | "billing_owner", options?: CallOptions): Promise<CommandResult<"team role">>;
+    /**
+     * Rename your team
+     *
+     * Usage: `team rename <name>`
+     */
+    teamRename(name: string, options?: CallOptions): Promise<CommandResult<"team rename">>;
+    /**
+     * 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
+     * ```
+     */
+    teamBillingPlan(options?: TeamBillingPlanOptions): Promise<CommandResult<"team billing plan">>;
+    /**
+     * 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?: TeamBillingUpdateOptions): Promise<CommandResult<"team billing update">>;
+    /**
+     * Transfer a VM to another team member
+     *
+     * Usage: `team transfer <vm_name> <target_email>`
+     */
+    teamTransfer(vmName: string, targetEmail: string, options?: CallOptions): Promise<CommandResult<"team transfer">>;
+    /**
+     * View and manage team auth settings
+     *
+     * Usage: `team auth`
+     */
+    teamAuth(options?: CallOptions): Promise<CommandResult<"team auth">>;
+    /**
+     * Require OIDC for web login (web|off)
+     *
+     * Usage: `team auth require-oidc <web|off>`
+     */
+    teamAuthRequireOidc(webOrOff: "web" | "off", options?: CallOptions): Promise<CommandResult<"team auth require-oidc">>;
+    /**
+     * 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: "default" | "google" | "oidc", options?: TeamAuthSetOptions): Promise<CommandResult<"team auth set">>;
+    /**
+     * View and manage team settings
+     *
+     * Usage: `team settings`
+     */
+    teamSettings(options?: CallOptions): Promise<CommandResult<"team settings">>;
+    /**
+     * View and manage automatic VM placement
+     *
+     * Usage: `team settings vm-placement`
+     */
+    teamSettingsVmPlacement(options?: CallOptions): Promise<CommandResult<"team settings vm-placement">>;
+    /**
+     * Use ordinary VM placement
+     *
+     * Usage: `team settings vm-placement default`
+     */
+    teamSettingsVmPlacementDefault(options?: CallOptions): Promise<CommandResult<"team settings vm-placement default">>;
+    /**
+     * Send bare new commands to a shared team pool
+     *
+     * Usage: `team settings vm-placement pool <name>`
+     */
+    teamSettingsVmPlacementPool(name: string, options?: CallOptions): Promise<CommandResult<"team settings vm-placement pool">>;
+    /**
+     * 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?: TeamSettingsVmPlacementMemberPoolOptions): Promise<CommandResult<"team settings vm-placement member-pool">>;
+    /**
+     * Keep bare new commands outside pools while migrating (legacy)
+     *
+     * Usage: `team settings vm-placement poolless`
+     */
+    teamSettingsVmPlacementPoolless(options?: CallOptions): Promise<CommandResult<"team settings vm-placement poolless">>;
+    /**
+     * Set who can create standalone VMs
+     *
+     * Usage: `team settings standalone <off|admins-only|all-users>`
+     */
+    teamSettingsStandalone(offOrAdminsOnlyOrAllUsers: "off" | "admins-only" | "all-users", options?: CallOptions): Promise<CommandResult<"team settings standalone">>;
+    /**
+     * Allow or block the exe.dev LLM gateway (your own API keys are unaffected)
+     *
+     * Usage: `team settings llm-gateway <on|off>`
+     */
+    teamSettingsLlmGateway(onOrOff: "on" | "off", options?: CallOptions): Promise<CommandResult<"team settings llm-gateway">>;
+    /**
+     * Allow team VMs to share CPU cores with each other
+     *
+     * Usage: `team settings core-sharing <on|off>`
+     */
+    teamSettingsCoreSharing(onOrOff: "on" | "off", options?: CallOptions): Promise<CommandResult<"team settings core-sharing">>;
+    /**
+     * Set who can share team VMs
+     *
+     * Usage: `team settings vm-sharing <admins-only|all-members>`
+     */
+    teamSettingsVmSharing(adminsOnlyOrAllMembers: "admins-only" | "all-members", options?: CallOptions): Promise<CommandResult<"team settings vm-sharing">>;
+    /**
+     * 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
+     * ```
+     */
+    teamSettingsSessionLength(length: string, options?: CallOptions): Promise<CommandResult<"team settings session-length">>;
+    /**
+     * Allow users from your email domain to join this team on signup
+     *
+     * Usage: `team settings auto-join <on|off>`
+     */
+    teamSettingsAutoJoin(onOrOff: "on" | "off", options?: CallOptions): Promise<CommandResult<"team settings auto-join">>;
+    /**
+     * 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.
+     */
+    teamVmLs(nameOrPattern?: string, options?: TeamVmLsOptions): Promise<CommandResult<"team vm ls">>;
+    /**
+     * Create a pool: reserved capacity for your team's VMs
+     *
+     * Usage: `pool new <name> --cpus=N [--region=<region>] [--max-vms=M]`
+     */
+    poolNew(name: string, options?: PoolNewOptions): Promise<CommandResult<"pool new">>;
+    /**
+     * Show your team's dedicated hosts, where its new pools are placed
+     *
+     * Usage: `pool hosts`
+     */
+    poolHosts(options?: CallOptions): Promise<CommandResult<"pool hosts">>;
+    /**
+     * 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?: string, options?: PoolListOptions): Promise<CommandResult<"pool list">>;
+    /**
+     * 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
+     * ```
+     */
+    poolAdopt(options?: PoolAdoptOptions): Promise<CommandResult<"pool adopt">>;
+    /**
+     * 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
+     * ```
+     */
+    poolDetach(options?: PoolDetachOptions): Promise<CommandResult<"pool detach">>;
+    /**
+     * Change a pool's CPU capacity or VM cap
+     *
+     * Usage: `pool resize <name> --cpus=N | pool resize <name> --max-vms=N [--force]`
+     */
+    poolResize(args?: readonly string[], options?: PoolResizeOptions): Promise<CommandResult<"pool resize">>;
+    /**
+     * Rename a pool without changing its capacity or VMs
+     *
+     * Usage: `pool rename <old-name> <new-name>`
+     */
+    poolRename(oldName: string, newName: string, options?: CallOptions): Promise<CommandResult<"pool rename">>;
+    /**
+     * Delete a pool (refused while it has VMs; --force detaches them)
+     *
+     * Usage: `pool delete <name> [--force]`
+     */
+    poolDelete(name: string, options?: CallOptions): Promise<CommandResult<"pool delete">>;
+    /**
+     * Show your current plan and resource limits
+     *
+     * Usage: `billing plan [--all]`
+     *
+     * CLI examples:
+     * ```
+     * billing plan
+     * billing plan --all   # plans you can switch to
+     * ```
+     */
+    billingPlan(options?: BillingPlanOptions): Promise<CommandResult<"billing plan">>;
+    /**
+     * 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
+     * ```
+     */
+    billingUsage(options?: BillingUsageOptions): Promise<CommandResult<"billing usage">>;
+    /**
+     * Show Shelley credit balances
+     *
+     * Usage: `billing credits [usage|transactions|buy]`
+     */
+    billingCredits(options?: CallOptions): Promise<CommandResult<"billing credits">>;
+    /**
+     * 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
+     * ```
+     */
+    billingCreditsUsage(options?: BillingCreditsUsageOptions): Promise<CommandResult<"billing credits usage">>;
+    /**
+     * Show your credit purchases and gifts
+     *
+     * Usage: `billing credits transactions [--limit=N]`
+     */
+    billingCreditsTransactions(options?: BillingCreditsTransactionsOptions): Promise<CommandResult<"billing credits transactions">>;
+    /**
+     * 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
+     * ```
+     */
+    billingCreditsBuy(dollars: string, options?: BillingCreditsBuyOptions): Promise<CommandResult<"billing credits buy">>;
+    /**
+     * Show invite rewards you've earned
+     *
+     * Usage: `billing rewards`
+     */
+    billingRewards(options?: CallOptions): Promise<CommandResult<"billing rewards">>;
+    /**
+     * Change your subscription capacity
+     *
+     * Usage: `billing capacity [--cpu=N] [--yes]`
+     *
+     * CLI examples:
+     * ```
+     * billing capacity
+     * billing capacity --cpu=4 --yes
+     * ```
+     */
+    billingCapacity(options?: BillingCapacityOptions): Promise<CommandResult<"billing capacity">>;
+    /**
+     * Show your payment methods
+     *
+     * Usage: `billing payment [list]`
+     */
+    billingPayment(options?: CallOptions): Promise<CommandResult<"billing payment">>;
+    /**
+     * List all payment methods on file
+     *
+     * Usage: `billing payment list`
+     */
+    billingPaymentList(options?: CallOptions): Promise<CommandResult<"billing payment list">>;
+    /**
+     * Remove a saved payment method
+     *
+     * Usage: `billing payment remove <ref>`
+     *
+     * CLI examples:
+     * ```
+     * billing payment remove 4f1c2a9b8d3e
+     * ```
+     */
+    billingPaymentRemove(ref: string, options?: CallOptions): Promise<CommandResult<"billing payment remove">>;
+    /**
+     * Make a saved payment method the default
+     *
+     * Usage: `billing payment default <ref>`
+     *
+     * CLI examples:
+     * ```
+     * billing payment default 4f1c2a9b8d3e
+     * ```
+     */
+    billingPaymentDefault(ref: string, options?: CallOptions): Promise<CommandResult<"billing payment default">>;
+    /**
+     * Open the billing management page
+     *
+     * Usage: `billing manage`
+     */
+    billingManage(options?: CallOptions): Promise<CommandResult<"billing manage">>;
+    /**
+     * Open the personal plan activation page
+     *
+     * Usage: `billing activate`
+     */
+    billingActivate(options?: CallOptions): Promise<CommandResult<"billing activate">>;
+    /**
+     * 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?: BillingUpdateOptions): Promise<CommandResult<"billing update">>;
+    /**
+     * Show recent invoices
+     *
+     * Usage: `billing invoices`
+     */
+    billingInvoices(options?: CallOptions): Promise<CommandResult<"billing invoices">>;
+    /**
+     * List invoices for your personal or team account
+     *
+     * Usage: `billing invoices list [--account=personal|team]`
+     *
+     * CLI examples:
+     * ```
+     * billing invoices list --account=team
+     * ```
+     */
+    billingInvoicesList(options?: BillingInvoicesListOptions): Promise<CommandResult<"billing invoices list">>;
+    /**
+     * Show one invoice with its usage breakdown
+     *
+     * Usage: `billing invoices show <id> [--vms]`
+     *
+     * CLI examples:
+     * ```
+     * billing invoices show in_1Abc --vms
+     * ```
+     */
+    billingInvoicesShow(id: string, options?: BillingInvoicesShowOptions): Promise<CommandResult<"billing invoices show">>;
+    /**
+     * 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
+     * ```
+     */
+    billingReceipts(options?: BillingReceiptsOptions): Promise<CommandResult<"billing receipts">>;
+    /**
+     * 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
+     * ```
+     */
+    billingStatement(options?: BillingStatementOptions): Promise<CommandResult<"billing statement">>;
+    /**
+     * Connect a marketplace subscription to your team
+     *
+     * Usage: `billing provider link <aws|azure> --token=<link-token> [--size=<team-size>] [--team-name=<name>]`
+     */
+    billingProviderLink(awsOrAzure: "aws" | "azure", options?: BillingProviderLinkOptions): Promise<CommandResult<"billing provider link">>;
+    /**
+     * Manage your invite link and rewards
+     */
+    invite(options?: CallOptions): Promise<CommandResult<"invite">>;
+    /**
+     * Show your active invite link and reward
+     *
+     * Usage: `invite show`
+     */
+    inviteShow(options?: CallOptions): Promise<CommandResult<"invite show">>;
+    /**
+     * Print only your active invite link
+     *
+     * Usage: `invite link`
+     */
+    inviteLink(options?: CallOptions): Promise<CommandResult<"invite link">>;
+    /**
+     * List invite rewards you can use
+     *
+     * Usage: `invite rewards`
+     */
+    inviteRewards(options?: CallOptions): Promise<CommandResult<"invite rewards">>;
+    /**
+     * Choose the reward for your invite link
+     *
+     * Usage: `invite set-reward standard|bonus-credits|extra-memory|extra-disk`
+     */
+    inviteSetReward(standardOrBonusCreditsOrExtraMemoryOrExtraDisk: "standard" | "bonus-credits" | "extra-memory" | "extra-disk", options?: CallOptions): Promise<CommandResult<"invite set-reward">>;
+    /**
+     * Show signups, upgrades, and reward status
+     *
+     * Usage: `invite activity`
+     */
+    inviteActivity(options?: CallOptions): Promise<CommandResult<"invite activity">>;
+    /**
+     * Request more trial invites
+     *
+     * Usage: `invite request`
+     */
+    inviteRequest(options?: CallOptions): Promise<CommandResult<"invite request">>;
+    /**
+     * Open the invites page
+     *
+     * Usage: `invite manage`
+     */
+    inviteManage(options?: CallOptions): Promise<CommandResult<"invite manage">>;
+    /**
+     * Generate a magic link to log in to the website
+     *
+     * Usage: `browser`
+     */
+    browser(options?: BrowserOptions): Promise<CommandResult<"browser">>;
+}
+/** A VM reference. info is a snapshot; refresh() fetches current metadata. */
+export declare class VM {
+    #private;
+    /** @internal Obtain VMs through exe.new(), exe.ls(), exe.vm(), or vm.cp(). */
+    constructor(transport: Transport, info: VMInfo);
+    get info(): Readonly<VMInfo>;
+    get name(): string;
+    get httpsUrl(): string | undefined;
+    get sshDest(): string | undefined;
+    get tags(): readonly string[];
+    /** Run a shell command once. Nonzero exit codes are results, not exceptions. */
+    ssh(command: string, options?: SSHOptions): Promise<SSHResult>;
+    /** Refresh metadata without changing this reference's identity. Requires ls permission. */
+    refresh(options?: CallOptions): Promise<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.
+     */
+    waitUntilReady(options?: WaitOptions): Promise<this>;
+    /**
+     * Delete a VM
+     *
+     * Usage: `rm <vmname>...`
+     *
+     * Tag-scoped API keys may run this command.
+     */
+    rm(options?: CallOptions): Promise<CommandResult<"rm">>;
+    /**
+     * Restart a VM
+     *
+     * Usage: `restart <vmname>`
+     *
+     * Tag-scoped API keys may run this command.
+     */
+    restart(options?: ReadyOptions): Promise<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.
+     */
+    pause(options?: CallOptions): Promise<CommandResult<"pause">>;
+    /**
+     * Resume a paused VM (restore RAM from disk)
+     *
+     * Usage: `resume <vmname>`
+     *
+     * Tag-scoped API keys may run this command.
+     */
+    resume(options?: ReadyOptions): Promise<this>;
+    /**
+     * rename a vm
+     *
+     * Usage: `rename <oldname> <newname>`
+     *
+     * Tag-scoped API keys may run this command.
+     */
+    rename(newname: string, options?: CallOptions): Promise<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.
+     */
+    tag(tagNames: string | readonly string[], options?: TagOptions): Promise<CommandResult<"tag">>;
+    /**
+     * 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(options?: CpOptions): Promise<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.
+     */
+    resize(options?: ResizeOptions): Promise<CommandResult<"resize">>;
+    /**
+     * 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(text: string, options?: CallOptions): Promise<CommandResult<"comment">>;
+    /**
+     * Link a custom domain to a VM
+     *
+     * Usage: `domain add [--wildcard] <vm> <domain>`
+     */
+    domainAdd(domain: string, options?: DomainAddOptions): Promise<CommandResult<"domain add">>;
+    /**
+     * Remove a custom domain from a VM
+     *
+     * Usage: `domain rm <vm> <domain>`
+     */
+    domainRm(domain: string, options?: CallOptions): Promise<CommandResult<"domain rm">>;
+    /**
+     * Show current shares for a VM
+     *
+     * Usage: `share show <vm>`
+     *
+     * Tag-scoped API keys may run this command.
+     */
+    shareShow(options?: ShareShowOptions): Promise<CommandResult<"share show">>;
+    /**
+     * 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(port?: string, options?: CallOptions): Promise<CommandResult<"share port">>;
+    /**
+     * Make the HTTP proxy publicly accessible
+     *
+     * Usage: `share set-public <vm>`
+     *
+     * Tag-scoped API keys may run this command.
+     */
+    shareSetPublic(options?: CallOptions): Promise<CommandResult<"share set-public">>;
+    /**
+     * Restrict the HTTP proxy to authenticated users
+     *
+     * Usage: `share set-private <vm>`
+     *
+     * Tag-scoped API keys may run this command.
+     */
+    shareSetPrivate(options?: CallOptions): Promise<CommandResult<"share set-private">>;
+    /**
+     * 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(emailOrTeam: string, options?: ShareAddOptions): Promise<CommandResult<"share add">>;
+    /**
+     * 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(emailOrTeam: string, options?: ShareRemoveOptions): Promise<CommandResult<"share remove">>;
+    /**
+     * Create a shareable link for a VM
+     *
+     * Usage: `share add-link <vm>`
+     *
+     * Tag-scoped API keys may run this command.
+     */
+    shareAddLink(options?: ShareAddLinkOptions): Promise<CommandResult<"share add-link">>;
+    /**
+     * Revoke a shareable link
+     *
+     * Usage: `share remove-link <vm> <token>`
+     *
+     * Tag-scoped API keys may run this command.
+     */
+    shareRemoveLink(token: string, options?: CallOptions): Promise<CommandResult<"share remove-link">>;
+    /**
+     * 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(onOrOff?: "on" | "off", options?: ShareReceiveEmailOptions): Promise<CommandResult<"share receive-email">>;
+    /**
+     * Install or upgrade Shelley to the current version
+     *
+     * Usage: `shelley install <vm>`
+     *
+     * Tag-scoped API keys may run this command.
+     */
+    shelleyInstall(options?: CallOptions): Promise<CommandResult<"shelley install">>;
+    /**
+     * 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.
+     */
+    grantSupportRoot(onOrOff: "on" | "off", options?: CallOptions): Promise<CommandResult<"grant-support-root">>;
+    /**
+     * 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.
+     */
+    stat(options?: StatOptions): Promise<CommandResult<"stat">>;
+}
+/** Readiness failed after a VM was obtained/created. The VM is not deleted. */
+export declare class VMReadyError extends Error {
+    readonly vm: VM;
+    constructor(vm: VM, cause: unknown);
+}
+//# sourceMappingURL=commands.gen.d.ts.map