simbiot-harness/README.md
simbiot-min ed502650f4 feat: эскалации (min→hour→day) + фикс хвоста событий в CLI
Часть 1 (часовой уровень, задача t-260929155421-9f7bff):
- EscalationRaised/Acknowledged в ES-спину, проекция escalations
- CLI: escalate / escalations / escalation-ack
- уровни видят открытые эскалации в контексте; scheduler перезапускает
  критическую эскалацию сразу (не дожидаясь границы такта)

Часть 2 (минутный, этот тик):
- fix(cli): 'events -n N' показывал первые N событий вместо хвоста стора
  (README обещает хвост) — теперь хвост; --after N — от id N вперёд
- + es.count_events()
2026-09-29 16:13:23 +00:00

4.6 KiB
Raw Blame History

Simbiot Harness

Ритмичный агент: живёт тактами, как человек. CQRS + Event Sourcing на спине, Strands Harness SDK как исполнительное ядро, модели через 9router.

Лестница (v0.1)

Уровень Интервал Контекст Модель Задачи
sec 1 с 0 (без LLM) — рефлекс: телеметрия, алерты
min 1 мин ~4K auto→flash S-триаж: входящие, быстрые фиксы
hour 1 ч ~32K auto S/M-задачи
day 1 д ~128K auto M/L-задачи, манифест дня

Принципы: тик идемпотентен (UNIQUE(level, seq)); занятый уровень поглощает тик (TickAbsorbed + детерминированная заглушка дайджеста, без LLM); запущенная задача не прерывается; наверх идут только дайджесты.

События (ES-спина)

CycleTicked, TickAbsorbed, ReflexObserved, DigestWritten, TaskSubmitted, TaskClaimed, TaskCompleted, TaskFailed, TaskPromoted, EscalationRaised, EscalationAcknowledged, BudgetSpent, CycleError, HarnessInit, PolicySet — append-only, проекции пересобираются replay'ем, стейт = производное от событий.

Структура

  • harness/es.py — event store + проекции (checkpoint + replay)
  • harness/levels.py — конфигурация уровней
  • harness/scheduler.py — демон лестницы
  • harness/isolated_runner.py + _llm_worker.py — LLM-тик в сабпроцессе (глобальный asyncio-рантайм Strands не переживает 2+ create_harness)
  • harness/commands.py — command side
  • cli.py — init/task/tasks/status/events/requeue

CLI

./venv/bin/python cli.py init --identity "…"
./venv/bin/python cli.py task "…" -m 240          # -m minutes-to-live estimate: S/M/L
./venv/bin/python cli.py tasks
./venv/bin/python cli.py status
./venv/bin/python cli.py events -n 50
./venv/bin/python cli.py requeue <task-id> -r "причина"
./venv/bin/python cli.py promote <task-id> -r "вне класса уровня"   # S→M→L
./venv/bin/python cli.py escalate "причина" -f min -c "контекст" -s critical
./venv/bin/python cli.py escalations --open        # открытые эскалации
./venv/bin/python cli.py escalation-ack <esc-id> -n "что сделал"   # закрыть
./venv/bin/python cli.py tg-reply <msg-id> "текст"   # ответ на входящее TG

Эскалации

Важное с нижних уровней поднимается наверх событием EscalationRaised (min→hour→day; day — вершина, эскалировать некуда). Открытые эскалации инжектятся в контекст верхних уровней (build_context) в приоритетной секции — нижний уровень не тонет в чужих проблемах, верхний видит выжимку, а не сырь. Уровень-адресат закрывает эскалацию escalation-ack (событие EscalationAcknowledged). Падение LLM-тика (CycleError) эскалируется автоматически — scheduler поднимает warn-эскалацию на уровень выше.

Запуск

systemctl enable --now simbiot-harness
journalctl -u simbiot-harness -f

Telegram-инбокс

Бот @juno42bot → long polling (simbiot-harness-tg.service) → MessageReceived в стор → минутный уровень видит входящие в контексте → отвечает cli.py tg-reply (Telegram-отправка + ReplySent закрывает входящее). Белый список чатов в .env (SIMBIOT_TG_ALLOWED), чужие → MessageIgnored.

Модели

9router (router.cil.by), отдельный ключ sk-simbiot в .env, комбо auto: glm-5.3 → kimi-k3 → deepseek-v4-pro → v4.1-flash → flash. Бюджет виден в событиях BudgetSpent (по уровням) и в дашборде 9router по ключу.

v0.2 (roadmap)

  • прерывание срочной реакцией / пауза (сейчас absorbed детерминирован)
  • уровни week/month/quarter/year
  • инбокс из Telegram/портала