console v0.4.1 [extra]


Интерактивный PTY-терминал: веб (/ws/terminal) и Telegram (промпт-цикл, секреты, hostkey).

README

# console

Интерактивный терминал хоста: в веб-панели и в Telegram.

Тип: Модуль. Категория: `extra`. Зависимости: pip-пакеты `pexpect`, `ptyprocess` (TG-сессии).
## Описание
Веб — настоящий терминал в браузере поверх живого канала (`/ws/terminal`): командная строка хоста бота, ввод и вывод в реальном времени. На каждого пользователя держится одна сессия — новая закрывает старую.

Telegram — покадровая консоль (`tg_session.ConsoleManager`, сессии держит console, admin только делегирует): каждое сообщение — итерация промпт-ориентированного цикла. Понимает интерактив: запрос секрета (ssh/sudo — следующим сообщением, оно удаляется и не попадает в лог), fingerprint нового SSH-хоста («да»/«нет», вслепую не подтверждает). Вывод чистится от ANSI и режется под лимит TG (полный — в `console_sessions.log`).

Команды сессии: `#quitconsole` — закрыть, `#killconsole` — убить зависший процесс (например, повисший ssh). Простой 30 минут — авто-закрытие.

Это полный доступ к машине, поэтому право на терминал выдаётся только себе и никогда — кому попало.

## Связь с ai_chat и opencode
`tg_session.ConsoleManager.attach()` при старте делает две вещи: назначает себя делегатом admin-меню (`menu.console_delegate`) и подменяет пустые заглушки `admin_menu.console_sessions` в шимах движков `ai_chat.engine` и `opencode.chat` живым множеством `LiveConsoleUsers` (активные TG-сессии консоли).

Зачем: движки в 6 местах проверяют `user_id in self.admin_menu.console_sessions` и молчат, пока пользователь ведёт PTY-сессию в TG-консоли, — иначе на одно сообщение приходили бы и вывод консоли, и ответ AI (дубль). По умолчанию шим `core.legacy.AdminRightsShim` держит пустое множество («никто не в консоли»).

Связь мягкая: в манифесте console `requires` нет, имена API собираются конкатенацией `"%s.%s"`, поэтому grep по `opencode.chat` в модуле console ничего не находит. Проверка идёт через `api.has()`: если `ai_chat`/`opencode` не загружены (выключены или пропущены лоадером), attach пишет INFO «модуль X не загружен — дедупликация ответов не требуется» и не считает это ошибкой — движок не запущен, дублировать нечего. WARNING остаётся только для настоящих проблем (нет `admin.menu`, шим не подменён).

Публичная альтернатива подмене (pull-модель): API `console.session_user_ids` — живое множество uid. Метод зарегистрирован, но ни одного потребителя в репозитории пока нет.

## Права
- `console_session` — Интерактивный терминал (WS + Telegram)
## Telegram
- кнопка «💻 Консоль» → терминальная сессия
## Web
- WebSocket `/ws/terminal` — интерактивная shell-сессия
- карточка «Терминал» в кабинете

Манифест

{
  "name": "console",
  "version": "0.4.1",
  "category": "extra",
  "description": "Интерактивный PTY-терминал: веб (/ws/terminal) и Telegram (промпт-цикл, секреты, hostkey).",
  "requires": [],
  "rights": [],
  "api_methods": [],
  "web_routes": [],
  "commit": "e80353ae43116df15a2c85f06e8d371c27281c55",
  "updated": "2026-10-13 14:35:27 +0300",
  "history": [
    {
      "version": "0.1.0",
      "date": "2026-09-08 17:27:33 +0300",
      "commit": "28de83498e1031bd4dbb88a47a422a2ecb54ec92"
    },
    {
      "version": "0.2.0",
      "date": "2026-09-11 10:17:26 +0300",
      "commit": "c86c8b6fe14b77d3a6c763be84f1c247a2caaa2a"
    },
    {
      "version": "0.3.0",
      "date": "2026-09-20 02:30:00 +0300",
      "commit": "fb19c7e0358ca9bda57f889eaac61e64689a88d4"
    },
    {
      "version": "0.4.0",
      "date": "2026-09-25 20:53:16 +0300",
      "commit": "89855bed75b067cbfee0db1cdd95ec9d75a8d384"
    },
    {
      "version": "0.4.1",
      "date": "2026-10-13 14:35:27 +0300",
      "commit": "e80353ae43116df15a2c85f06e8d371c27281c55"
    }
  ],
  "integrity": "sha256:9710f9969bca05c6be88f7fea90492f9b877fcf5caf4f168d6710865e4aca8ba",
  "files": "[10 файлов — см. вкладки ниже]",
  "note": "",
  "wdesc": "",
  "wbody": "",
  "_extra": {
    "api": "",
    "events_emitted": "[]",
    "events_subscribed": "[]",
    "audit_allow": "",
    "ws_routes": ""
  }
}

Файлы и исходники

Дерево файлов

  • · корень
    • 4.0 КБ
    • 1.0 КБ
    • 1.8 КБ
    • 0.2 КБ
    • 28.8 КБ
    • 0.4 КБ
    • 0.5 КБ
    • 6.3 КБ
  • web/
    • 0.5 КБ
    • 2.6 КБ

Предпросмотр

Выберите файл в дереве выше — код откроется здесь.

История версий

versiondatecommit
0.4.12026-10-13e80353ae4311
0.4.02026-09-2589855bed75b0
0.3.02026-09-20fb19c7e0358c
0.2.02026-09-11c86c8b6fe14b
0.1.02026-09-0828de83498e10