# Computer Control API
SUMMARY: पंजीकृत कंप्यूटरों का रिमोट नियंत्रण — कमांड कतारबद्ध करें, स्क्रीनशॉट लें, रिमोट मशीनों पर स्क्रिप्ट चलाएँ।

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 आपको पंजीकृत कंप्यूटरों को रिमोट-कंट्रोल करने की सुविधा देता है। एक छोटा एजेंट () लक्षित मशीन पर चलता है, कमांड के लिए poll करता है, उन्हें निष्पादित करता है, और परिणाम वापस पोस्ट करता है। यह LLM-चालित GUI ऑटोमेशन सक्षम बनाता है।
आर्किटेक्चर
[CODE BLOCK]
उपयोगकर्ता-सामने के एंडपॉइंट्स (Mind Key या JWT)
GET /computers/list
सभी पंजीकृत कंप्यूटरों की सूची बनाएँ।
[CODE BLOCK]
GET /computers/:id
एक कंप्यूटर का विवरण प्राप्त करें।
[CODE BLOCK]
POST /computers/install-code
नया कंप्यूटर पंजीकृत करने के लिए इंस्टॉल कोड जनरेट करें।
[CODE BLOCK]
प्रतिक्रिया: 
POST /computers/:id/commands
रिमोट एजेंट द्वारा निष्पादित करने के लिए कमांड कतारबद्ध करें।
[CODE BLOCK]
प्रतिक्रिया: 
GET /computers/:id/command (query के माध्यम से)
GET के माध्यम से कमांड कतारबद्ध करें (सरल मामलों के लिए)।
[CODE BLOCK]
GET /computers/:id/commands
किसी कंप्यूटर के हाल के कमांड्स की सूची बनाएँ।
[CODE BLOCK]
GET /computers/:id/commands/:cid
किसी विशिष्ट कमांड की स्थिति + परिणाम प्राप्त करें।
[CODE BLOCK]
GET /computers/:id/screenshot
वन-शॉट: स्क्रीनशॉट कमांड कतारबद्ध करें और परिणाम के लिए अधिकतम 30 सेकंड प्रतीक्षा करें।
[CODE BLOCK]
POST /computers/:id/disable
कंप्यूटर को अक्षम करें (इसका टोकन रद्द करता है, ऑडिट के लिए रिकॉर्ड रखता है)।
[CODE BLOCK]
DELETE /computers/:id
कंप्यूटर को स्थायी रूप से हटाएँ।
[CODE BLOCK]
एजेंट-सामने के एंडपॉइंट्स (Computer Token)
इन एंडपॉइंट्स का उपयोग लक्षित मशीन पर चलने वाले  द्वारा किया जाता है। ये Mind Key नहीं, बल्कि Computer Token ( से लौटाया गया) का उपयोग करते हैं।
POST /computers/register
इंस्टॉल कोड को रिडीम करें और Computer Token प्राप्त करें।
[CODE BLOCK]
प्रतिक्रिया: 
> [!CRITICAL]
>  को सहेजें — यह केवल एक बार दिखाया जाता है और सभी एजेंट-साइड एंडपॉइंट्स के लिए आवश्यक है।
GET /computers/me/poll
नए कमांड्स के लिए लॉन्ग-पोल। एजेंट इसे लूप में कॉल करता है।
[CODE BLOCK]
यदि कमांड्स लंबित हैं तो तुरंत लौटाता है, अन्यथा  सेकंड के बाद।
POST /computers/me/commands/:cid/result
कमांड निष्पादन का परिणाम पोस्ट करें।
[CODE BLOCK]
कमांड प्रकार
| प्रकार | Payload | विवरण |
|------|---------|-------------|
|  |  | स्क्रीन को PNG के रूप में कैप्चर करें (base64) |
|  |  | निर्देशांक पर क्लिक करें |
|  |  | माउस को निर्देशांक पर ले जाएँ |
|  |  | कर्सर पर टेक्स्ट टाइप करें |
|  |  | की कॉम्बो दबाएँ |
|  |  | स्क्रॉल व्हील |
|  |  | ड्रैग और ड्रॉप |
सामान्य पैटर्न: LLM-चालित GUI ऑटोमेशन
[CODE BLOCK]
अगले कदम
- Browser Proxy — ब्राउज़र ऑटोमेशन के लिए अलग सेवा
- Self-Hosted Agents Guide