# Computer Control API
SUMMARY: Kontrol jarak jauh komputer terdaftar — antri perintah, ambil tangkapan layar, jalankan skrip pada mesin 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
Computer Control API memungkinkan Anda mengendalikan komputer terdaftar dari
jarak jauh. Sebuah agen kecil () berjalan di mesin target,
melakukan polling untuk perintah, mengeksekusinya, dan mengirimkan hasil
kembali. Ini memungkinkan otomasi GUI berbasis LLM.
Arsitektur
[CODE BLOCK]
Endpoint Sisi Pengguna (Mind Key atau JWT)
GET /computers/list
Mendaftar semua komputer terdaftar.
[CODE BLOCK]
GET /computers/:id
Mengambil detail satu komputer.
[CODE BLOCK]
POST /computers/install-code
Membuat kode instalasi untuk mendaftarkan komputer baru.
[CODE BLOCK]
Respons: 
POST /computers/:id/commands
Mengantri perintah untuk dijalankan oleh agen remote.
[CODE BLOCK]
Respons: 
GET /computers/:id/command (via query)
Mengantri perintah melalui GET (untuk kasus sederhana).
[CODE BLOCK]
GET /computers/:id/commands
Mendaftar perintah terbaru untuk sebuah komputer.
[CODE BLOCK]
GET /computers/:id/commands/:cid
Mengambil status + hasil perintah tertentu.
[CODE BLOCK]
GET /computers/:id/screenshot
One-shot: mengantri perintah tangkapan layar dan menunggu hingga 30 detik untuk hasilnya.
[CODE BLOCK]
POST /computers/:id/disable
Menonaktifkan komputer (mencabut tokennya, menyimpan catatan untuk audit).
[CODE BLOCK]
DELETE /computers/:id
Menghapus komputer secara permanen.
[CODE BLOCK]
Endpoint Sisi Agen (Computer Token)
Endpoint ini digunakan oleh  yang berjalan di mesin target.
Endpoint menggunakan Computer Token (dikembalikan oleh ),
bukan Mind Key.
POST /computers/register
Menukar kode instalasi dan mendapatkan Computer Token.
[CODE BLOCK]
Respons: 
> [!CRITICAL]
> Simpan  — token ini hanya ditampilkan sekali dan diperlukan
> untuk semua endpoint sisi agen.
GET /computers/me/poll
Long-poll untuk perintah baru. Agen memanggil ini dalam loop.
[CODE BLOCK]
Mengembalikan langsung jika ada perintah tertunda, atau setelah  detik jika tidak ada.
POST /computers/me/commands/:cid/result
Mengirim hasil eksekusi perintah.
[CODE BLOCK]
Tipe Perintah
| Tipe | Payload | Deskripsi |
|------|---------|-------------|
|  |  | Menangkap layar sebagai PNG (base64) |
|  |  | Mengklik pada koordinat |
|  |  | Memindahkan mouse ke koordinat |
|  |  | Mengetik teks pada kursor |
|  |  | Menekan kombinasi tombol |
|  |  | Scroll wheel |
|  |  | Drag and drop |
Pola Umum: Otomasi GUI Berbasis LLM
[CODE BLOCK]
Langkah Berikutnya
- Browser Proxy — layanan terpisah untuk otomasi browser
- Panduan Self-Hosted Agents