# 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 التحكم عن بُعد بالأجهزة المسجّلة. يعمل وكيل
صغير () على الجهاز الهدف، يستطلع للأوامر، ينفّذها،
ويُعيد نشر النتائج. هذا يُمكّن أتمتة الواجهة الرسومية المدفوعة بنماذج LLM.
البنية
[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 (عبر الاستعلام)
إدراج أمر عبر 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)
تُستخدم هذه النقاط من قبل  الذي يعمل على الجهاز الهدف.
تستخدم Computer Token (يُرجعها )، وليس Mind Key.
POST /computers/register
استرداد رمز تثبيت والحصول على Computer Token.
[CODE BLOCK]
الاستجابة: 
> [!CRITICAL]
> احفظ  — يُعرض مرة واحدة فقط ومطلوب لجميع نقاط نهاية
> الوكيل.
GET /computers/me/poll
استطلاع طويل للأوامر الجديدة. يستدعي الوكيل هذا في حلقة.
[CODE BLOCK]
يُرجع فورًا إذا كانت هناك أوامر معلّقة، أو بعد  ثانية إن لم تكن.
POST /computers/me/commands/:cid/result
نشر نتيجة تنفيذ أمر.
[CODE BLOCK]
أنواع الأوامر
| النوع | الحمولة | الوصف |
|------|---------|-------------|
|  |  | التقاط الشاشة كـ PNG (base64) |
|  |  | النقر عند الإحداثيات |
|  |  | تحريك الماوس إلى الإحداثيات |
|  |  | كتابة نص عند المؤشر |
|  |  | ضغط مجموعة مفاتيح |
|  |  | تمرير العجلة |
|  |  | سحب وإفلات |
النمط الشائع: أتمتة الواجهة الرسومية المدفوعة بـ LLM
[CODE BLOCK]
الخطوات التالية
- وكيل المتصفح — خدمة منفصلة لأتمتة المتصفح
- دليل الوكلاء المستضافين ذاتيًا