# Scripts API

تُوفّر Scripts API تخزينًا دائمًا للسكربتات القابلة لإعادة الاستخدام. تُسمّى
السكربتات وتُنسب إصداراتها داخل عقل، ويمكن جلبها كنص عادي — مثالية لأنماط
`curl | bash`.

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

### POST /script

تخزين سكربت أو تحديثه.

```bash
curl -X POST https://synapse.schaefer.zone/script \
  -H "Authorization: Bearer YOUR_MIND_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "deploy-synapse",
    "content": "#!/bin/bash\nset -euo pipefail\ngit pull\nnpm ci\nnpm run build\ndocker compose up -d",
    "description": "Deploy Synapse to production",
    "language": "bash"
  }'
```

### GET /script/:name

جلب محتوى السكربت كـ `text/plain`. مثالي للتمرير إلى bash.

```bash
curl -H "Authorization: Bearer YOUR_MIND_KEY" \
     https://synapse.schaefer.zone/script/deploy-synapse | bash
```

### GET /script/:name/info

الحصول على بيانات السكربت الوصفية دون المحتوى.

```bash
curl -H "Authorization: Bearer YOUR_MIND_KEY" \
     https://synapse.schaefer.zone/script/deploy-synapse/info
```

الاستجابة:

```json
{
  "name": "deploy-synapse",
  "description": "Deploy Synapse to production",
  "language": "bash",
  "size_bytes": 142,
  "created_at": "2026-06-27T...",
  "updated_at": "2026-06-27T..."
}
```

### GET /scripts

قائمة بجميع السكربتات في العقل الحالي.

```bash
curl -H "Authorization: Bearer YOUR_MIND_KEY" \
     https://synapse.schaefer.zone/scripts
```

### DELETE /script/:name

حذف سكربت.

```bash
curl -X DELETE -H "Authorization: Bearer YOUR_MIND_KEY" \
     https://synapse.schaefer.zone/script/deploy-synapse
```

## حالات الاستخدام الشائعة

### سكربتات النشر

خزّن إجراءات النشر القياسية حتى يتمكن LLM من تشغيلها دون إعادة اشتقاق
الخطوات في كل مرة:

```bash
# يخزّن LLM هذا مرة واحدة
curl -X POST .../script -d '{
  "name": "deploy-vps1",
  "content": "#!/bin/bash\nssh vps1 \"cd /opt/synapse && git pull && docker compose up -d --build\"",
  "language": "bash"
}'

# الجلسات اللاحقة تشغّله فقط
curl -H "Authorization: ..." .../script/deploy-vps1 | bash
```

### مقتطفات استكشاف الأخطاء

خزّن أوامر التشخيص للمشكلات الشائعة:

```bash
curl -X POST .../script -d '{
  "name": "check-docker",
  "content": "#!/bin/bash\ndocker ps\ndocker stats --no-stream\ndocker system df",
  "description": "Quick Docker health check",
  "language": "bash"
}'
```

### مولّدات الإعدادات

خزّن سكربتات تُولّد الإعدادات:

```bash
curl -X POST .../script -d '{
  "name": "gen-nginx-conf",
  "content": "#!/usr/bin/env python3\nimport sys\n# ... generate nginx config from template ...",
  "language": "python"
}'
```

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

- [Variables API](/docs/api/variables)
- [Cron والمجدول](/docs/api/cron)