simbiot-harness/README.md
Simbiot Harness 76aa204f2b feat(tg-cmd): без-LLM команды бота /лестница /статус /задачи /помощь — мгновенные ответы сек-рефлексом + setMyCommands (t-260929210755-9bf6a6)
- harness/tg_commands.py: реестр команд, парсер (кириллица/транслит/@бот/без слэша),
  хендлеры из read model, answer_pending (идемпотентно, cooldown 60с при лежащем TG),
  setMyCommands с фолбэком кириллица→транслит (Bot API латиницу только)
- scheduler.py: сек-тик отвечает на команды без LLM (payload.commands),
  build_context НЕ показывает команды мин-уровню (гонки/лежащий TG не тратят LLM)
- tg_inbox.py: send_message/send_reply принимают короткий timeout для рефлекса;
  поллер при старте авторегистрирует команды бота
- cli.py: tg-commands --register/--list
2026-09-30 02:30:27 +00:00

7.9 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, TaskAwaitDelivery, DeliverySent, 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
  • harness/tg_commands.py — без-LLM команды бота (сек-рефлекс)
  • cli.py — init/task/task-await/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 task "…" -a              # автодоставка результата в TG при готовности
./venv/bin/python cli.py task-await <task-id>     # пометить существующую: доставить в TG
./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

Автодоставка артефактов (t-260929205927)

Задача, заказанная из TG (cli.py task -a / task-await), помечается TaskAwaitDelivery. При завершении (TaskCompleted) результат (answer) уходит в чат сам — DeliverySent, без повторного запроса. Push в тике (сразу после завершения) + pull-страховка (delivery-демон каждые 15с: досылает недоставленное, если тик умер между завершением и отправкой). Идемпотентно: один раз доставлено — повторно не шлётся; после requeue доработка доставляется снова. Формат: «✅ Готово: