# Tasks API

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

## نقاط النهاية

### GET /mind/tasks

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

```bash
# جميع المهام
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"
```

الاستجابة:

```json
{
  "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

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

```bash
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 فقط).

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

### PUT /mind/task/:id

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

```bash
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

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

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

### GET /mind/task/:id/delete

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

```bash
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` — متروكة

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

```python
# عند بدء الجلسة
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")
```

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

- [سير عمل مدفوع بالمهام](/docs/llm-cookbook/task-driven-workflow)
- [Cron والمجدول](/docs/api/cron)