network-terminal-mcp 0.1.0__tar.gz

network_terminal_mcp-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,32 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  checks:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.12", "3.13", "3.14"]
+    steps:
+      - uses: actions/checkout@v7
+      - uses: astral-sh/setup-uv@v10.2.0
+        with:
+          python-version: ${{ matrix.python-version }}
+          enable-cache: true
+      - name: Sync environment
+        run: uv sync --locked
+      - name: Ruff
+        run: uv run ruff check .
+      - name: Mypy
+        run: uv run mypy src
+      - name: Pytest
+        run: uv run pytest

network_terminal_mcp-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,55 @@
+name: Release
+
+on:
+  push:
+    tags: ["v*"]
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+      - uses: astral-sh/setup-uv@v10.2.0
+        with:
+          enable-cache: true
+      - name: Build sdist and wheel
+        run: uv build
+      - uses: actions/upload-artifact@v7
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v8
+        with:
+          name: dist
+          path: dist/
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/
+
+  github-release:
+    needs: [build, publish]
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v7
+      - uses: actions/download-artifact@v8
+        with:
+          name: dist
+          path: dist/
+      - name: Create GitHub Release
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: gh release create "${GITHUB_REF_NAME}" dist/* --generate-notes --verify-tag

network_terminal_mcp-0.1.0/.gitignore

@@ -0,0 +1,17 @@
+.venv/
+__pycache__/
+*.py[cod]
+*.egg-info/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+dist/
+build/
+
+# Local and secret-bearing runtime configuration
+.env
+*.log
+transcripts/
+outputs/

network_terminal_mcp-0.1.0/AGENTS.md

@@ -0,0 +1,60 @@
+# Repository Guide
+
+## Read First
+
+- `README.md` defines the project scope.
+- `docs/architecture.md` is the technical source of truth.
+- `docs/development-plan.md` lists ordered milestones and exit criteria.
+- `docs/security.md` contains mandatory safety requirements.
+- `src/network_terminal_mcp/usage.md` is the model-facing manual shipped as MCP
+  `instructions` + the `network-terminal://usage` resource; keep it in sync with
+  `usage.py` and the OpenCode skill.
+- There are no example config files: connections are model-described inline. Never commit real
+  addresses, hostnames, or secrets anywhere in the repository.
+
+## Safety Rules
+
+- Never add plaintext passwords, TACACS secrets, enable secrets, API tokens, or real production
+  addresses to this repository.
+- Never run integration tests against real network devices without explicit user approval for the
+  exact targets and commands.
+- Sessions are raw interactive terminals: the model may type any command, including configuration
+  entry. The safety boundary is the client permission gate on `open_session` (and optionally on
+  `terminal_write`), the audited input, and the operator's AAA policy — not command allowlists.
+- Secrets typed at a live prompt must go through `terminal_write_secret` (a `pass` entry reference);
+  its value must never appear in tool arguments, results, or audit. Plain `terminal_write` is
+  logged verbatim and must not be used for secrets.
+- Keep legacy SSH algorithms scoped to explicit per-call host allowlists. Never weaken global
+  SSH settings.
+- Telnet, TCP console, and local serial must be explicitly enabled per call (`allow_telnet=true`,
+  `allow_serial=true`) and clearly marked insecure; policy can hard-deny them.
+- Audit failures are fail-closed: if an action cannot be recorded, it must not be executed.
+- Secret retrieval is internal to the server. MCP tool arguments and results must not contain
+  passwords, except an explicit plaintext opt-in behind `allow_plaintext_password`, which is never
+  stored, never audited, and always marked insecure. References (`pass` entry, key file) are the
+  default.
+
+## Engineering Rules
+
+- Use Python 3.12+ and `uv`.
+- Terminal transport is implemented directly on Paramiko (SSH), telnetlib3
+  (Telnet/TCP console), and pyserial (local serial) in
+  `src/network_terminal_mcp/terminal.py`. Do not reintroduce a vendor-driver
+  abstraction or nested connection routes; the model identifies the device type
+  from output and performs further ssh/telnet hops itself with `terminal_write`.
+- Keep command knowledge out of the transport layer. The transport handles
+  writes, reads, prompt detection, and timeouts only.
+- Validate the connection spec and policy with Pydantic before opening any
+  network connection.
+- Use structured errors and redact secrets before logging or returning failures.
+
+## Planned Verification
+
+```bash
+uv run ruff check .
+uv run mypy src
+uv run pytest
+```
+
+Add these checks as the corresponding implementation appears. Do not add placeholder tests that
+assert no behavior.

network_terminal_mcp-0.1.0/CHANGELOG.md

@@ -0,0 +1,49 @@
+# Changelog
+
+Все значимые изменения проекта фиксируются в этом файле. Формат основан на
+[Keep a Changelog](https://keepachangelog.com/ru/1.1.0/), версии следуют
+[Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.0] - 2026-10-05
+
+Первый публичный релиз. Сессия — один постоянный терминальный stream; модель
+пишет в него точный ввод, включая переходы `ssh`/`telnet`, и читает вывод без
+требования определённой формы prompt.
+
+### Added
+
+- Сырые терминальные инструменты: `open_session`, `terminal_write`,
+  `terminal_read`, `terminal_write_secret`, `read_output`, `session_status`,
+  `close_session`.
+- `terminal_write_secret` вводит значение `pass` в живой prompt, не раскрывая
+  его в аргументах, результатах и audit (логируются только entry и размер).
+- Транспорты SSH (Paramiko), Telnet/TCP console (telnetlib3) и локальный
+  serial `/dev/tty*` (pyserial); Telnet/console/serial включаются явными
+  per-call флагами `allow_telnet` / `allow_serial`.
+- Маршруты первого подключения: direct, локальный SOCKS5 (`socks`) и SSH
+  ProxyJump (`proxyjump`).
+- Модель-ориентированная инструкция внутри MCP: `instructions` в initialize и
+  ресурс `network-terminal://usage` (исходник
+  `src/network_terminal_mcp/usage.md`).
+- Необязательный `policy.yml` (posture и лимиты), per-call allowlist legacy
+  SSH-алгоритмов, JSONL-audit и mutable redaction.
+- Лимиты runtime: idle/lifetime сессий, размеры чтения/записи/буфера вывода,
+  максимальное число одновременных сессий.
+
+### Changed
+
+- Сессии: несколько независимых сессий в одном процессе, вывод отдаётся без
+  требования prompt, prompt detection — best-effort.
+- Секреты: ссылки `pass`/key file по умолчанию; plaintext-пароль — только за
+  явным `allow_plaintext_password` и помечается как insecure.
+- Документация переписана под raw terminal; история этапов 0-8 вынесена в
+  `docs/history.md`.
+
+### Removed
+
+- Командно-ориентированные инструменты `run_command`, `run_commands`,
+  `cli_help`, `send_control`, `respond`, `run_change` и command policy.
+- `nested`-маршрут: вложенные переходы выполняются вводом в сессии.
+- Инвентарь и файлы `connections.yml`, `credentials.yml`, `inventory.yml`.

network_terminal_mcp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Evgeny Zhuravlev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

network_terminal_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,169 @@
+Metadata-Version: 2.5
+Name: network-terminal-mcp
+Version: 0.1.0
+Summary: Session-oriented MCP server for interactive network device terminals
+Project-URL: Homepage, https://github.com/evgenyzh/network-terminal-mcp
+Project-URL: Repository, https://github.com/evgenyzh/network-terminal-mcp
+Project-URL: Issues, https://github.com/evgenyzh/network-terminal-mcp/issues
+Project-URL: Changelog, https://github.com/evgenyzh/network-terminal-mcp/blob/main/CHANGELOG.md
+Author: Evgeny Zhuravlev
+License-Expression: MIT
+License-File: LICENSE
+Keywords: mcp,network,serial,ssh,telnet,terminal
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: System Administrators
+Classifier: Intended Audience :: Telecommunications Industry
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: System :: Networking
+Classifier: Topic :: System :: Systems Administration
+Requires-Python: >=3.12
+Requires-Dist: mcp<3,>=2.1.1
+Requires-Dist: paramiko<5,>=4.0
+Requires-Dist: pydantic-settings>=2.10
+Requires-Dist: pydantic>=2.12
+Requires-Dist: pyserial>=3.5
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: telnetlib3<6,>=5.0
+Description-Content-Type: text/markdown
+
+# network-terminal-mcp
+
+[![PyPI](https://img.shields.io/pypi/v/network-terminal-mcp)](https://pypi.org/project/network-terminal-mcp/)
+[![CI](https://github.com/evgenyzh/network-terminal-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/evgenyzh/network-terminal-mcp/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+Локальный MCP-сервер для постоянных интерактивных сессий с сетевым
+оборудованием. Проект даёт OpenCode сырой терминал: подключиться к устройству,
+использовать контекстную подсказку `?`, выполнить несколько команд, при
+необходимости зайти вторым `ssh`/`telnet` внутрь той же сессии и получить полный
+вывод без временных `sshpass`-команд и одноразовых скриптов.
+
+Статус: v0.1.0 — этапы 1-9 реализованы. Сессия — это один постоянный терминальный stream
+(SSH, Telnet, TCP console или локальный serial `/dev/tty*`); модель пишет в него
+точно то, что нужно, включая вложенные переходы, и читает вывод без требования
+определённой формы prompt. Для первого подключения поддерживаются direct, один
+локальный SOCKS5 hop и один SSH ProxyJump hop; `nested`-маршрутов и
+командно-ориентированных инструментов больше нет. Секреты, запрашиваемые уже
+внутри сессии, вводятся через `terminal_write_secret` со ссылкой на `pass` и не
+попадают в audit. Один процесс держит несколько независимых сессий.
+
+Подключение описывает модель в самом вызове `open_session`: host, protocol,
+credentials (ссылки `pass`/key file или plaintext за флагом), route
+(direct/socks/proxyjump), host key policy, serial-параметры и legacy-алгоритмы.
+Инвентаря и profile-конфигов больше нет — после установки достаточно открыть
+сессию. Единственный необязательный локальный файл — `policy.yml` (posture и
+лимиты). Проверено на живом оборудовании: direct SSH на Cisco IOS, SNR
+old/eNOS, D-Link, Huawei VRP и Junos; ProxyJump через реальные bastion.
+Подробности в [результатах проверок](docs/validation.md).
+
+Текущие ограничения: raw input выполняется без per-команды подтверждения —
+после одобренного `open_session` модель работает в устройстве свободно; оператор
+может добавить permission `ask` для `terminal_write` в OpenCode. Автоматического
+распознавания sensitive-команд (`conf t`, `system-view`, `commit`) пока нет.
+Telnet, console и serial требуют явных per-call флагов и могут быть hard-deny
+политикой. `transcripts_enabled` остаётся зарезервированной настройкой.
+
+## Основные цели
+
+- Прямой SSH, SOCKS5, ProxyJump, Telnet, TCP console и локальный serial.
+- Современное и устаревшее оборудование: legacy SSH алгоритмы включаются явно
+  для конкретного host в вызове.
+- Постоянная сессия: авторизация выполняется один раз, затем модель пишет
+  команды, `ssh`/`telnet` и одиночные клавиши в тот же stream.
+- Несколько параллельных сессий в одном процессе: переключение между
+  устройствами без переподключения.
+- Zero-config: модель описывает соединение сама, локально нужен только
+  необязательный `policy.yml`.
+- Точные команды выбирает модель. MCP не переводит абстрактные операции в
+  vendor CLI и не хранит полный каталог команд.
+- Собственный терминальный слой на Paramiko, telnetlib3 и pyserial; тип
+  устройства модель определяет сама по баннеру и выводу.
+- Пароли загружаются из `pass` или явного key file; секреты вводятся в живой
+  prompt через `terminal_write_secret` и не попадают в MCP arguments, results и
+  audit. Plaintext-пароль — только за явным insecure-флагом.
+- Все подключения, ввод и события терминала журналируются без секретов.
+
+
+## Первая область поддержки
+
+- Cisco IOS/IOS-XE, включая старые 29xx/35xx.
+- Huawei VRP и Huawei OLT.
+- Juniper Junos.
+- SNR 29xx и 52xx на базе механики Cisco IOS, но как разные CLI-диалекты.
+- D-Link DGS/DES.
+- Eltex MES/ESR.
+- MikroTik RouterOS через обычный SSH.
+- BDCOM, EcoSGE и PON-платформы через generic transport.
+
+## Не входит в первую версию
+
+- Отдельный RouterOS API MCP.
+- Полноценная система управления конфигурациями или Source of Truth.
+- Автоматическая запись в production.
+- Обход TACACS/RADIUS command authorization.
+- Автоматическое включение слабых SSH-алгоритмов для всех устройств.
+
+## Документы
+
+- [Инструкция для модели](src/network_terminal_mcp/usage.md) — она же MCP-ресурс
+  `network-terminal://usage`; краткий контракт едет в MCP `instructions`
+- [Архитектура](docs/architecture.md)
+- [План разработки](docs/development-plan.md)
+- [Модель безопасности](docs/security.md)
+- [Конфигурация](docs/configuration.md)
+- [Эксплуатация](docs/operations.md)
+- [Результаты проверок](docs/validation.md)
+- [История этапов 0-8](docs/history.md)
+- [Разработка адаптеров](docs/adapters.md)
+- [Стратегия тестирования](docs/testing.md)
+- [Открытые вопросы](docs/open-questions.md)
+
+## Установка
+
+```bash
+uvx network-terminal-mcp
+# или как постоянный инструмент:
+uv tool install network-terminal-mcp
+# или:
+pip install network-terminal-mcp
+```
+
+## Запуск
+
+Локальный MCP запускается OpenCode через `stdio`, без прослушивания TCP-порта:
+
+```json
+{
+  "mcp": {
+    "network-terminal": {
+      "type": "local",
+      "command": ["uvx", "network-terminal-mcp"],
+      "enabled": true
+    }
+  },
+  "permission": {
+    "network-terminal_open_session": "ask"
+  }
+}
+```
+
+Конфигурационные файлы не обязательны. Для строгих ограничений (например,
+hard-deny Telnet, serial, legacy-алгоритмов, plaintext) можно положить
+`policy.yml` в `~/.config/network-terminal-mcp/`. Ввод в живой сессии по
+умолчанию не подтверждается: после одобренного `open_session` модель работает в
+терминале свободно.
+
+Проверка локальной политики до запуска:
+
+```bash
+uv sync
+uv run python -m network_terminal_mcp check
+```
+
+Подробный порядок регистрации SSH host key и запуска через OpenCode описан в
+[руководстве эксплуатации](docs/operations.md).

network_terminal_mcp-0.1.0/README.md

@@ -0,0 +1,136 @@
+# network-terminal-mcp
+
+[![PyPI](https://img.shields.io/pypi/v/network-terminal-mcp)](https://pypi.org/project/network-terminal-mcp/)
+[![CI](https://github.com/evgenyzh/network-terminal-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/evgenyzh/network-terminal-mcp/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+Локальный MCP-сервер для постоянных интерактивных сессий с сетевым
+оборудованием. Проект даёт OpenCode сырой терминал: подключиться к устройству,
+использовать контекстную подсказку `?`, выполнить несколько команд, при
+необходимости зайти вторым `ssh`/`telnet` внутрь той же сессии и получить полный
+вывод без временных `sshpass`-команд и одноразовых скриптов.
+
+Статус: v0.1.0 — этапы 1-9 реализованы. Сессия — это один постоянный терминальный stream
+(SSH, Telnet, TCP console или локальный serial `/dev/tty*`); модель пишет в него
+точно то, что нужно, включая вложенные переходы, и читает вывод без требования
+определённой формы prompt. Для первого подключения поддерживаются direct, один
+локальный SOCKS5 hop и один SSH ProxyJump hop; `nested`-маршрутов и
+командно-ориентированных инструментов больше нет. Секреты, запрашиваемые уже
+внутри сессии, вводятся через `terminal_write_secret` со ссылкой на `pass` и не
+попадают в audit. Один процесс держит несколько независимых сессий.
+
+Подключение описывает модель в самом вызове `open_session`: host, protocol,
+credentials (ссылки `pass`/key file или plaintext за флагом), route
+(direct/socks/proxyjump), host key policy, serial-параметры и legacy-алгоритмы.
+Инвентаря и profile-конфигов больше нет — после установки достаточно открыть
+сессию. Единственный необязательный локальный файл — `policy.yml` (posture и
+лимиты). Проверено на живом оборудовании: direct SSH на Cisco IOS, SNR
+old/eNOS, D-Link, Huawei VRP и Junos; ProxyJump через реальные bastion.
+Подробности в [результатах проверок](docs/validation.md).
+
+Текущие ограничения: raw input выполняется без per-команды подтверждения —
+после одобренного `open_session` модель работает в устройстве свободно; оператор
+может добавить permission `ask` для `terminal_write` в OpenCode. Автоматического
+распознавания sensitive-команд (`conf t`, `system-view`, `commit`) пока нет.
+Telnet, console и serial требуют явных per-call флагов и могут быть hard-deny
+политикой. `transcripts_enabled` остаётся зарезервированной настройкой.
+
+## Основные цели
+
+- Прямой SSH, SOCKS5, ProxyJump, Telnet, TCP console и локальный serial.
+- Современное и устаревшее оборудование: legacy SSH алгоритмы включаются явно
+  для конкретного host в вызове.
+- Постоянная сессия: авторизация выполняется один раз, затем модель пишет
+  команды, `ssh`/`telnet` и одиночные клавиши в тот же stream.
+- Несколько параллельных сессий в одном процессе: переключение между
+  устройствами без переподключения.
+- Zero-config: модель описывает соединение сама, локально нужен только
+  необязательный `policy.yml`.
+- Точные команды выбирает модель. MCP не переводит абстрактные операции в
+  vendor CLI и не хранит полный каталог команд.
+- Собственный терминальный слой на Paramiko, telnetlib3 и pyserial; тип
+  устройства модель определяет сама по баннеру и выводу.
+- Пароли загружаются из `pass` или явного key file; секреты вводятся в живой
+  prompt через `terminal_write_secret` и не попадают в MCP arguments, results и
+  audit. Plaintext-пароль — только за явным insecure-флагом.
+- Все подключения, ввод и события терминала журналируются без секретов.
+
+
+## Первая область поддержки
+
+- Cisco IOS/IOS-XE, включая старые 29xx/35xx.
+- Huawei VRP и Huawei OLT.
+- Juniper Junos.
+- SNR 29xx и 52xx на базе механики Cisco IOS, но как разные CLI-диалекты.
+- D-Link DGS/DES.
+- Eltex MES/ESR.
+- MikroTik RouterOS через обычный SSH.
+- BDCOM, EcoSGE и PON-платформы через generic transport.
+
+## Не входит в первую версию
+
+- Отдельный RouterOS API MCP.
+- Полноценная система управления конфигурациями или Source of Truth.
+- Автоматическая запись в production.
+- Обход TACACS/RADIUS command authorization.
+- Автоматическое включение слабых SSH-алгоритмов для всех устройств.
+
+## Документы
+
+- [Инструкция для модели](src/network_terminal_mcp/usage.md) — она же MCP-ресурс
+  `network-terminal://usage`; краткий контракт едет в MCP `instructions`
+- [Архитектура](docs/architecture.md)
+- [План разработки](docs/development-plan.md)
+- [Модель безопасности](docs/security.md)
+- [Конфигурация](docs/configuration.md)
+- [Эксплуатация](docs/operations.md)
+- [Результаты проверок](docs/validation.md)
+- [История этапов 0-8](docs/history.md)
+- [Разработка адаптеров](docs/adapters.md)
+- [Стратегия тестирования](docs/testing.md)
+- [Открытые вопросы](docs/open-questions.md)
+
+## Установка
+
+```bash
+uvx network-terminal-mcp
+# или как постоянный инструмент:
+uv tool install network-terminal-mcp
+# или:
+pip install network-terminal-mcp
+```
+
+## Запуск
+
+Локальный MCP запускается OpenCode через `stdio`, без прослушивания TCP-порта:
+
+```json
+{
+  "mcp": {
+    "network-terminal": {
+      "type": "local",
+      "command": ["uvx", "network-terminal-mcp"],
+      "enabled": true
+    }
+  },
+  "permission": {
+    "network-terminal_open_session": "ask"
+  }
+}
+```
+
+Конфигурационные файлы не обязательны. Для строгих ограничений (например,
+hard-deny Telnet, serial, legacy-алгоритмов, plaintext) можно положить
+`policy.yml` в `~/.config/network-terminal-mcp/`. Ввод в живой сессии по
+умолчанию не подтверждается: после одобренного `open_session` модель работает в
+терминале свободно.
+
+Проверка локальной политики до запуска:
+
+```bash
+uv sync
+uv run python -m network_terminal_mcp check
+```
+
+Подробный порядок регистрации SSH host key и запуска через OpenCode описан в
+[руководстве эксплуатации](docs/operations.md).

network_terminal_mcp-0.1.0/docs/adapters.md

@@ -0,0 +1,41 @@
+# Транспорт и определение типа устройства
+
+## Нет слоя адаптеров
+
+Проект не имеет адаптерного или драйверного слоя. Транспорт унифицирован для
+любых ssh/telnet/console/serial-устройств и реализован в
+`src/network_terminal_mcp/terminal.py`:
+
+- SSH — Paramiko;
+- Telnet и TCP console — telnetlib3;
+- локальный serial — pyserial.
+
+Понятия `platform`, `dialect`, `driver`, `generic_termserver` и `redispatch`
+отсутствуют. Нет ни поля `platform`, ни инструмента `set_platform`.
+
+## Как определяется тип устройства
+
+`open_session` не принимает аргумент `platform` (и вообще не имеет дела с
+конфигурационными профилями: соединение описывается inline). Модель определяет
+семейство устройства по баннеру и первичному выводу, а затем взаимодействует
+через сырой терминал:
+
+- `terminal_write` — команды, `?`-подсказки, одиночные клавиши, `ssh`/`telnet`;
+- `terminal_read` — чтение вывода без требования prompt;
+- `terminal_write_secret` — секрет из `pass` на живой prompt.
+
+## Механика терминала
+
+Различия между устройствами (paging, help, очистка строки, confirmation
+prompts, login prompts следующего hop) — это просто вывод и ввод в одном
+stream. Сервер не классифицирует его и не переводит сессию в особые состояния:
+модель читает то, что пришло, и отвечает тем, что нужно. Vendor-специфичного
+кода нет: `terminal_write`/`terminal_read` работают одинаково для любого
+устройства.
+
+## Специфичное поведение
+
+Если позже потребуется специфичное для устройства поведение, его место — в
+универсальном терминальном слое (`terminal.py`) или в skill, а не в
+vendor-драйвере. Такое поведение должно проверяться на transcript'ах и не
+дублироваться для каждого вендора.