Miosa.Computer.Agent (Miosa v1.0.0)

Copy Markdown View Source

Computer-Use Agent (CUA) session management for a computer.

Wraps:

  • POST /computers/:id/cua/sessions — run/4
  • GET /computers/:id/cua/sessions — list/2
  • GET /computers/:id/cua/sessions/:sid — get/3
  • DELETE /computers/:id/cua/sessions/:sid — cancel/3

Summary

Functions

Cancel a running CUA session (DELETE /computers/:computer_id/cua/sessions/:session_id).

Retrieve a single CUA session by ID (GET /computers/:computer_id/cua/sessions/:session_id).

List all CUA sessions for a computer (GET /computers/:computer_id/cua/sessions).

Create and start a CUA session for a computer (POST /computers/:computer_id/cua/sessions).

Functions

cancel(client, computer_id, session_id)

@spec cancel(Miosa.Client.t(), String.t(), String.t()) ::
  :ok | {:error, Miosa.Error.t()}

Cancel a running CUA session (DELETE /computers/:computer_id/cua/sessions/:session_id).

get(client, computer_id, session_id)

Retrieve a single CUA session by ID (GET /computers/:computer_id/cua/sessions/:session_id).

list(client, computer_id)

List all CUA sessions for a computer (GET /computers/:computer_id/cua/sessions).

run(client, computer_id, goal, opts \\ %{})

Create and start a CUA session for a computer (POST /computers/:computer_id/cua/sessions).

Options map keys

  • "model" — Override the AI model (e.g. "claude-3-5-sonnet-latest").
  • "max_steps" — Maximum number of agent steps before stopping.
  • "tools" — List of additional tool names to enable.
  • "timeout" — Session timeout in seconds.