# Computer Control API
SUMMARY: Controllo remoto di computer registrati — accoda comandi, cattura schermate, esegue script su macchine remote.

KEY CONTEXT:
Two sides: user-facing (Mind Key/JWT) and agent-facing (Computer Token)
Register agent: POST /computers/register { install_code } → returns computer_token
List: GET /computers/list (Mind Key or JWT)
Queue command: POST /computers/:id/commands { type, payload }
Command types: screenshot, click, move, type, key, scroll, drag
Agent poll: GET /computers/me/poll?wait=5 (Computer Token)
Agent result: POST /computers/me/commands/:cid/result (Computer Token)
One-shot screenshot: GET /computers/:id/screenshot (waits 30s for result)
Pattern: register agent on remote machine → user queues commands → agent polls and executes

Computer Control API
La Computer Control API permette di controllare da remoto computer registrati.
Un piccolo agente () viene eseguito sulla macchina di
destinazione, esegue il polling dei comandi, li esegue e pubblica i risultati.
Questo abilita l'automazione GUI guidata da LLM.
Architettura
[CODE BLOCK]
Endpoint lato utente (Mind Key o JWT)
GET /computers/list
Elenca tutti i computer registrati.
[CODE BLOCK]
GET /computers/:id
Ottiene i dettagli di un singolo computer.
[CODE BLOCK]
POST /computers/install-code
Genera un codice di installazione per registrare un nuovo computer.
[CODE BLOCK]
Risposta: 
POST /computers/:id/commands
Accoda un comando che l'agente remoto eseguirà.
[CODE BLOCK]
Risposta: 
GET /computers/:id/command (via query)
Accoda un comando tramite GET (per casi semplici).
[CODE BLOCK]
GET /computers/:id/commands
Elenca i comandi recenti di un computer.
[CODE BLOCK]
GET /computers/:id/commands/:cid
Ottiene stato + risultato di uno specifico comando.
[CODE BLOCK]
GET /computers/:id/screenshot
One-shot: accoda un comando screenshot e attende fino a 30s per il risultato.
[CODE BLOCK]
POST /computers/:id/disable
Disabilita un computer (revoca il token, mantiene il record per audit).
[CODE BLOCK]
DELETE /computers/:id
Elimina definitivamente un computer.
[CODE BLOCK]
Endpoint lato agente (Computer Token)
Questi endpoint sono utilizzati dal  in esecuzione sulla
macchina di destinazione. Usano un Computer Token (restituito da
), non una Mind Key.
POST /computers/register
Riscatta un codice di installazione e ottiene un Computer Token.
[CODE BLOCK]
Risposta: 
> [!CRITICAL]
> Salvi il  — viene mostrato una sola volta ed è richiesto per
> tutti gli endpoint lato agente.
GET /computers/me/poll
Long-polling per nuovi comandi. L'agente lo chiama in un ciclo.
[CODE BLOCK]
Ritorna immediatamente se ci sono comandi in attesa, o dopo  secondi in caso contrario.
POST /computers/me/commands/:cid/result
Pubblica il risultato dell'esecuzione di un comando.
[CODE BLOCK]
Tipi di comando
| Tipo | Payload | Descrizione |
|------|---------|-------------|
|  |  | Cattura schermo come PNG (base64) |
|  |  | Clic alle coordinate |
|  |  | Sposta il mouse alle coordinate |
|  |  | Digita testo al cursore |
|  |  | Preme una combinazione di tasti |
|  |  | Rotella di scorrimento |
|  |  | Trascina e rilascia |
Modello comune: automazione GUI guidata da LLM
[CODE BLOCK]
Prossimi passi
- Browser Proxy — servizio separato per automazione browser
- Guida Self-Hosted Agents