# Spacebot — Sofiia Telegram Agent

Spacebot — це Rust-based multi-agent framework від Spacedrive. Використовується як Telegram-фронтенд для агента Sofiia в екосистемі DAARION.

- GitHub: https://github.com/spacedriveapp/spacebot
- Версія: v0.1.15
- Telegram bot: @SofiiaDaarionbot

## Архітектура

```
[Telegram] ←→ [Spacebot (Rust)] ←→ [GLM-5 / Grok 4.1]
                     ↕
               LanceDB (vector memory)
               SOUL.md / IDENTITY.md / USER.md
```

## Встановлення (перший раз)

### Залежності

```bash
brew install rust protobuf cmake
curl -fsSL https://bun.sh/install | bash
```

### Збірка з вихідного коду

```bash
git clone --depth=1 https://github.com/spacedriveapp/spacebot.git ~/github-projects/spacebot
cd ~/github-projects/spacebot
cargo build --release   # ~7-20 хвилин
```

### Конфіг

```bash
mkdir -p ~/.spacebot
cp docs/spacebot/config.toml.example ~/.spacebot/config.toml
# Відредагуй ~/.spacebot/config.toml — виправ модель і ключі якщо потрібно
```

Ключі зберігаються в `.env` проекту:
- `SOFIIA_TELEGRAM_BOT_TOKEN` — токен бота @SofiiaDaarionbot
- `ZHIPU_API_KEY` / `GLM5_API_KEY` — GLM-5 (Zhipu AI)
- `XAI_API_KEY` — Grok (xAI), fallback

### Ідентичність агента

Файли в `~/.spacebot/agents/sofiia/workspace/`:
- `IDENTITY.md` — хто такий агент, контекст DAARION, засновник
- `SOUL.md` — стиль спілкування, мова, межі
- `USER.md` — інформація про Повелителя Хаосу / Іван Титар

## Управління

```bash
# Запуск
./ops/scripts/start_spacebot.sh start

# Статус
./ops/scripts/start_spacebot.sh status

# Live логи
./ops/scripts/start_spacebot.sh logs

# Перезапуск (після змін конфігу або identity файлів)
./ops/scripts/start_spacebot.sh restart

# Зупинка
./ops/scripts/start_spacebot.sh stop
```

## Важливо перед запуском

Якщо бот раніше використовував webhook (наприклад через gateway.daarion.city), треба видалити його:

```bash
source .env
curl "https://api.telegram.org/bot${SOFIIA_TELEGRAM_BOT_TOKEN}/deleteWebhook?drop_pending_updates=true"
```

## Моделі (поточні)

| Призначення | Модель | Provider |
|-------------|--------|----------|
| channel (чат) | glm-5 | Zhipu AI |
| branch (задачі) | glm-5 | Zhipu AI |
| worker (фон) | glm-4.5-air | Zhipu AI |
| cortex (память) | glm-4.7 | Zhipu AI |
| fallback | grok-4-1 / grok-4-1-mini | xAI |

## Де логи

```
~/.spacebot/logs/spacebot.log.YYYY-MM-DD
~/.spacebot/agents/sofiia/    — workspace, memory, lancedb
```