corp-messenger

name	corp-messenger
description	Отправить сообщение другому корпоративному ассистенту или проверить входящие через общий inbox service-agent. Используй когда нужно передать информацию другому помощнику в команде.

corp-messenger — Межинстансный мессенджер

Все сообщения проходят через service-agent как доверенный прокси. Service-agent отправляет и читает inbox от имени caller'а — получатель видит реального отправителя.

Вызов через service-agent

Все действия выполняются через HTTP API service-agent. Endpoint: POST http://corp-service:8090/v1/run

Авторизация: заголовок Authorization: Bearer $SERVICE_API_KEY (переменная окружения SERVICE_API_KEY).

Отправить сообщение

{
  "skill": "corp-messenger",
  "caller": "user-1",
  "params": {
    "action": "send",
    "to": "user-4",
    "message": "Привет, можешь помочь с задачей X?"
  }
}

Ответ:

{
  "status": "ok",
  "message": "Sent to user-4",
  "detail": {"ok": true, "from": "user-1", "to": "user-4"}
}

Прочитать входящие

{
  "skill": "corp-messenger",
  "caller": "user-1",
  "params": {
    "action": "inbox"
  }
}

Ответ:

{
  "status": "ok",
  "count": 1,
  "inbox": [
    {"from": "user-4", "to": "user-1", "message": "Готово!", "ts": 1709312400.0}
  ]
}

Очистить inbox

{
  "skill": "corp-messenger",
  "caller": "user-1",
  "params": {
    "action": "clear"
  }
}

Список доступных инстансов

{
  "skill": "corp-messenger",
  "caller": "user-1",
  "params": {
    "action": "list"
  }
}

Ответ:

{
  "status": "ok",
  "instances": ["admin", "user-1", "user-4", "user-3"],
  "count": 4
}

Как это работает

• caller в запросе определяет, от чьего имени действует skill
• Service-agent выступает доверенным прокси: broker принимает on_behalf_of от service
• Отправитель в broker = caller, не service
• Inbox читается для caller, не для service

Безопасность

• Прокси-доступ разрешён только service и admin (PROXY_INSTANCES в broker)
• Sender определяется по caller в запросе к service-agent, подтверждённому через SERVICE_API_KEY
• Ключи хранятся в переменных окружения, не в коде
• Брокер доступен только внутри Docker-сети, снаружи не открыт
• Rate limit: 10 сообщений в минуту
• Максимальный размер сообщения: 10KB