Machine

What a machine can be, smallest first.

Start an always-on machine called name (unique to its user; a taken name raises noclick.Conflict with existing_id). size is one of Machine.sizes(); region (noclick.regions()) is where it runs, for good, else your account's default region, else us-east. volumes attaches Volumes (or their ids or names) at absolute paths: each conversation sees a volume as it was when its turn started and saves its writes when the turn ends. network is what the machine's own commands may reach: True (the default: anywhere the machines usage policy allows, so no mail ports, mining pools or private addresses) or a list of hosts (HTTPS to them, "*.github.com" for subdomains, and name lookups). It's charged to your account from the day it first runs, a thirtieth of its monthly price a day while it exists, running or stopped, and refused (noclick.PriceExceeded, nothing started) if its size costs more than max_monthly_usd. An account's first machine needs its company vetted by NoClick (noclick.ActionRequired until it's approved).

A lazy reference to the machine called name in the current (or given) user. With create_if_missing=True it's started on first use with the fields create takes (max_monthly_usd is required then), and an existing machine whose size, volumes or network differ is changed to match (a new size restarts it). Its region is fixed: one in another region raises noclick.Conflict naming its region.

A lazy reference to a machine by id.

Load a machine by id now; an unknown id raises noclick.NotFound.

The current user's machines (the account's own outside as_user, or those user_filter covers).

One page of machines; pass next_cursor back as cursor.

Run a shell command on the machine itself (not in a conversation's container) and wait for it: timeout_s is 60 by default, at most 90. background=True runs it as an operation, up to an hour.

Serve port at an HTTPS URL on NoClick's domain: a dashboard or a webhook receiver your agents run. A private port asks for an API key with the machines scope, which the app never sees; public=True answers anyone.

Stop serving port; its URL stops answering.

The agents that run on it.

Rename it, change its size, volumes, network or price ceiling. New volumes and network apply without a restart (each conversation's from its next turn). A larger size restarts it once running turns finish (updating); the new price applies from the next day. A smaller size moves a running machine to a new host, since no host shrinks a disk in place: its user's home is copied over and each conversation loads its files from where they're saved, a longer restart (what's on its disk must fit the smaller one; a move that fails leaves it on its old host).

Restart it now, without waiting for running turns (they fail as interrupted). Its disk and volumes are kept; a machine.restarted event follows.

Stop it: its agents take no turns (a message raises noclick.NotAvailable) until start(). It's still charged, since it stays yours.

Start a stopped machine. One stopped because the balance couldn't pay it is charged what it owes first (noclick.PaymentRequired while it can't).

Delete it, with its disk; attached volumes stay. Refused (noclick.Conflict) while agents run on it: move them first (agent.update(machine=None)). The charge stops that day.