Tasks API

تُعطي Tasks API لوكلاء LLM طريقة منظمة لتتبّع العمل متعدد الخطوات. تكون المهام محدودة بالعقل الحالي وتستمر عبر الجلسات، حتى يتمكن الوكيل من استئناف العمل من حيث توقف.

نقاط النهاية

GET /mind/tasks

قائمة بجميع المهام للعقل الحالي.

# جميع المهام
curl -H "Authorization: Bearer YOUR_MIND_KEY" \
     https://synapse.schaefer.zone/mind/tasks

# تصفية حسب الحالة
curl -H "Authorization: Bearer YOUR_MIND_KEY" \
     "https://synapse.schaefer.zone/mind/tasks?status=pending"

الاستجابة:

{
  "tasks": [
    {
      "id": "task_001",
      "title": "Deploy v1.5.0",
      "description": "Push to production after CI green",
      "priority": "high",
      "status": "in_progress",
      "due_at": "2026-06-28T...",
      "created_at": "2026-06-27T..."
    }
  ]
}

POST /mind/task

إنشاء مهمة جديدة.

curl -X POST https://synapse.schaefer.zone/mind/task \
  -H "Authorization: Bearer YOUR_MIND_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Update documentation",
    "description": "Add v1.5.0 changelog entries",
    "priority": "normal",
    "due_at": "2026-06-30T00:00:00Z"
  }'

GET /mind/task (معاملات الاستعلام)

إنشاء مهمة عبر GET (للأدوات التي تفتح عناوين URL فقط).

curl -H "Authorization: Bearer YOUR_MIND_KEY" \
     "https://synapse.schaefer.zone/mind/task?title=Test+task&priority=high"

PUT /mind/task/:id

تحديث مهمة موجودة.

curl -X PUT https://synapse.schaefer.zone/mind/task/task_001 \
  -H "Authorization: Bearer YOUR_MIND_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "in_progress",
    "description": "Currently deploying, CI is green"
  }'

GET /mind/task/:id/complete

تعليم مهمة كمنجزة.

curl -H "Authorization: Bearer YOUR_MIND_KEY" \
     https://synapse.schaefer.zone/mind/task/task_001/complete

GET /mind/task/:id/delete

حذف مهمة نهائيًا.

curl -H "Authorization: Bearer YOUR_MIND_KEY" \
     https://synapse.schaefer.zone/mind/task/task_001/delete

الأولويات

• low — غير عاجل
• normal — افتراضي
• high — مهم
• critical — يجب فعله فورًا

الحالات

• pending — أُنشئت، لم تبدأ
• in_progress — يجري العمل عليها حاليًا
• done — مكتملة
• cancelled — متروكة

النمط: سير عمل مدفوع بالمهام

# عند بدء الجلسة
tasks = list_tasks(status="in_progress")
if tasks:
    print(f"Resuming: {tasks[0].title}")

# تخطيط العمل متعدد الخطوات
for step in plan:
    task = create_task(title=step)

# التحديث أثناء التقدم
update_task(task.id, status="in_progress")
# ... تنفيذ العمل ...
update_task(task.id, status="done")

الخطوات التالية

• سير عمل مدفوع بالمهام
• Cron والمجدول