@spec create(
  ArchAstro.Client.t(),
  String.t(),
  ArchAstro.Types.Operations.PostApiV1AgentsAgentAgentComputers.Input.t()
) ::
  {:ok, ArchAstro.Types.AgentComputer.t()} | {:error, ArchAstro.Error.reason()}

Provision a computer for an agent

Creates and provisions a new computer resource associated with the specified agent. The computer is allocated in the requested region (defaulting to iad) and its status transitions from provisioning to running once it is ready.

Requires an app-scoped API key. The agent identified by agent must belong to the same app. Supplying a lookup_key lets you retrieve this computer later without storing its ID — the key must be unique within the app.

The newly provisioned computer.

@spec list(ArchAstro.Client.t(), String.t()) ::
  {:ok, ArchAstro.Types.AgentComputerListResponse.t()}
  | {:error, ArchAstro.Error.reason()}

List computers

Returns all computers belonging to the authenticated app, ordered by creation time descending. Pass agent to scope the results to a single agent's computers. When agent is omitted, computers for all agents in the app are returned.

Requires an app-scoped API key. If the specified agent does not exist or does not belong to the app, the endpoint returns 404.

Object containing a data array of computer records.