# Portability: SYSTEM
# Last validated: 2026-05-17
# Next review: 2027-05-17
# Ресурсы: [таблица сообщений,hub/messages.py,hub/partner.py]

COMMUNICATE — партнерская система связи
==========================================

ДАТА: 2026-02-08

Система связи (уровень 4) управляет обменом информацией
между всеми экземплярами (людьми и ИИ).

ОСНОВНЫЕ ПОНЯТИЯ
------------
1. СООБЩЕНИЯ: Постоянная маршрутизация сообщений в БД.
2. ПРОТОКОЛЫ: Стандартизированные процессы (рукопожатие, запрос, передача).
3. РАБОЧИЕ ПРОСТРАНСТВА: Физические каталоги для обмена файлами (система/партнеры/).
4. ПРИСУТСТВИЕ: Активный онлайн-статус и механизмы наблюдения.

ЗАРЕГИСТРИРОВАННЫЕ ПАРТНЕРЫ (10)
-------------------------
Внутренняя система:
  пользователь Пользователь [✓ Активен]
  Клод Клод (Опус 4.6) [✓ Активен]
  bach      BACH Core System       [✓ Активен]

Локальный ИИ:
  оллама Мистраль 7Б [✓ Активен]
  лама Лама 3 8B [✓ Активный]

Внешний AI:
  Близнецы Google Близнецы [✓ Активен]
  gpt OpenAI GPT [○ Неактивно]

API:
  опубликован PubMed MCP [✓ Активно]

Услуги:
  диск Google Диск [✓ Активен]

Инструменты:
  canva Canva MCP [✓ Активно]

ОПРЕДЕЛЕНИЕ ПАРТНЕРА
-----------------
Ключевые слова автоматически запускают выбор партнера:

  ollama: массовая рассылка, встраивание, без токенов, черновик письма
  опубликовано: гены, белки, болезни, клинические, биомедицинские.
  google_drive: Google диск, найти документ, найти диск
  канва: дизайн, презентация, постер, инфографика
  Близнецы: глубокое исследование, длинный документ, концептуальный анализ 

 МАРШРУТИЗАЦИЯ КАНАЛОВ 
---------------
| Партнер | Каналы | Статус |
|---------|---------|--------|
| оллама | Прямой API, очередь | ✓ |
| пользователь | Окно сообщения | ✓ |
| опубликовано | MCP-сервер | ✓ |
| холст | MCP-сервер | ✓ |
| гугл_диск | API | ✓ |
| близнецы | партнеры/Близнецы/ | ✓ 

|ПРОВЕРКИ ЗДОРОВЬЯ
-------------
Оллама: завиток http://127.0.0.1:11434/api/tags
Google Диск: проверка токена API
PubMed: Тест подключения MCP
Canva: Тест подключения MCP

ЗОНЫ ТОКЕНОВ (Делегирование)
------------------------
Зона 1 (0–30%): доступны все партнеры
Зона 2 (30-60%): дешевые партнеры (предпочтительнее Оллама)
Зона 3 (60–80%): только местные партнеры.
Зона 4 (80–100%): только экстренная ситуация (человек + Оллама)

КОМАНДЫ CLI (сообщение баха)
----------------------
  list [--inbox/--outbox] [--limit N] Показать все сообщения.
  непрочитанные Только непрочитанные сообщения.
  send <ИМЯ> <ТЕКСТ> [--от ОТПРАВИТЕЛЯ] Отправить сообщение.
  read <ID> [--ack] Прочитать сообщение и при необходимости подтвердить.
  ping [--from NAME] Показать непрочитанных партнеров TO.
  смотрите опрос [--from NAME] в реальном времени (проверяйте каждые 10 секунд).
  count Показать количество сообщений.
  delete <ID> [ID2...] Удалить сообщение(я).
  архив <ID> [ID2...] Архивировать сообщения.

ТИПЫ СООБЩЕНИЙ
-----------------
- ЗАДАЧА: Заказы партнерам (через `_TASKS.md` + `msg send`).
- ИНФОРМАЦИЯ: обновления статуса и отчеты («исходящие/»).
- ПРЕДУПРЕЖДЕНИЕ: сообщения об ошибках и эскалация (монитор проблем).

ПРОТОКОЛЫ ВЗАИМОДЕЙСТВИЯ
----------------------
1. РУКОПОЖАЕНИЕ: Взаимное признание и проверка функций (здоровья).
2. ЗАПРОС: Официальный запрос данных или услуги.
3. ПЕРЕДАЧА: Физическая передача через Workspace или DB.
4. ПОДТВЕРЖДЕНИЕ: Подтверждение получения и обработки (Receipt).

ТАБЛИЦЫ БАЗЫ ДАННЫХ
------------------
подключения к конечным точкам и инструментам партнеров.
Partner_recognition Возможности и зоны партнеров
Delegation_rules Делегирование на основе токена
messages Протокол сообщений (используетсяhub/messages.py)
comm_messages Альтернативная таблица сообщений (активно не используется)

PARTNER-WORKSPACES
------------------
Каждый партнер имеет стандартизированную структуру папок в `system/partners/`:
  - Входящие/Входящие данные/запросы.
  - исходящие/результаты/отчеты.
  - рабочее пространство/ Временное рабочее пространство.

DAEMON И АВТОМАТИЗАЦИЯ
-------------------
Задание демона `msg-cleanup` архивирует сообщения, считывающие сообщения через 30 дней.
Такие партнеры, как Gemini, используют `bach msg watch`, чтобы отвечать Клоду в режиме реального времени.

ОБРАБОТЧИК И ИНСТРУМЕНТЫ
---------------
hub/messages.py Интерфейс командной строки системы обмена сообщениями (542 строки)
Hub/partner.py управление партнерами (514 строк)
инструменты/partner_communication/ Инструменты для взаимодействия с партнерами:
  - связь с экземпляром interaction_protocol.py
  - обнаружение программного обеспечения system_explorer.py
  - ai_совместимый.py уровень совместимости с ИИ
  - communication.py Коммуникационные утилиты

СМОТРИТЕ ТАКЖЕ
----------
  bach partner --help    Управление партнерами и делегирование
  bach msg --help        Команды системы сообщений
  docs/help/maintain.txt Проверка работоспособности партнеров
