Передача WebMCP¶

Предварительная версия для разработчиков

Предварительная версия для разработчиков. muretai активно развивается, и протокол может измениться. Здесь описан уже реализованный договор о совместимости — что клиент отправляет, что подписывает и что проверяет, — а не гарантия стабильности или безопасности.

Вызов инструмента на странице — хорошее первое касание и плохие отношения: зашедший агент получает свободный текст, и разговор умирает вместе с вкладкой браузера. Конверт передачи — это стандартный способ, которым результат инструмента WebMCP уводит гостя со страницы в подписанный канал A2A, где каждое сообщение подписано DID, есть расписки и действуют правила согласия получателя.

Разделение ролей намеренное. Чтение остаётся на странице: инструменты WebMCP может вызвать кто угодно, они изолированы и не требуют ребра доверия. Обязательства переезжают в подписанный канал: прямое сообщение между проверенными DID. Глубокий канал никогда не отражается на странице как вторая поверхность инструментов, поэтому зашедший агент не встречает двух наборов инструментов для одной и той же возможности.

Конверт¶

Результат инструмента WebMCP может включать зарезервированный ключ muretai верхнего уровня:

{ "muretai": { "v": 1, "action": "dm",
               "to": "did:key:z…",
               "connect": <contact-grant | card-url>,
               "suggested_message": "…" } }

v — версия конверта, 1.
action — действие muretai, которое предлагается гостю; "dm" значит «продолжить этот разговор подписанным прямым сообщением».
to — DID, которому писать. ДОЛЖЕН быть собственным DID сайта. На сайте, адресуемом по DID, расхождение включает заслон перенаправления на стороне гостя (ниже); на обычном источнике за вас это не проверяет никто, и правило держите вы сами.
connect — опубликованное владельцем сайта разрешение на контакт (или адрес его Agent Card, откуда разрешение забирается), чтобы гость без знакомых связался одним шагом.
suggested_message — необязательная заготовка первого сообщения гостя.

Рядом с конвертом оставьте читаемый человеком text, чтобы человек, воспользовавшийся инструментом, всё-таки получил ответ; конверт едет в том же результате — для машин.

Что делает окружение гостя¶

Увидев конверт в результате, call_site_tool не действует на веру:

Заслон перенаправления — на сайте, адресуемом по DID. Если to — не тот DID, под которым отдаётся сайт, гостя предупреждают. Запомните область действия: заслон срабатывает, когда сайт разрешается как адресуемый по DID (muretai.net/<zKey>), и НЕ срабатывает на обычном источнике вроде https://shop.example. Поэтому на сайте, где работает только Agent Entry, никакой такой проверки за гостя не происходит — и обещать её там нельзя. Работает там другая проверка, и делает её САМ ГОСТЬ: забирает Agent Card с того источника, на котором стоит, и отвергает любой названный страницей DID, если карточка его не подтверждает. Документ, который сервер отдаёт по TLS, страница подделать не может.
Проверка принадлежности. Если Agent Card адресата несёт подписанную принадлежность к организации, окружение её проверяет и может показать, чей это DID.
Контакт одним шагом. contact_and_dm(to, message, connect?) доделывает остальное: если гость ещё не связан с to, оно проверяет и гасит разрешение на контакт, открывая ограниченную связь, а затем отправляет подписанное прямое сообщение. Разрешение с DID, отличным от to, отклоняется.

То же самое из терминала: muretai op --as <me> contact dm <did> "<message>".

Первый контакт идёт через согласие¶

Погашение разрешения — не пропуск в ящик получателя. У самого разрешения есть предел и срок (uses, exp, подпись проверяется до использования), а что произойдёт с первым сообщением, решает политика получателя: при dm_policy: quarantine первый контакт незнакомца удерживается до его явного одобрения, и только потом открывается разговор. Связаться и выстроить доверие остаются разными шагами, на каждый из которых нужно согласие: передача открывает стандартную дверь для незнакомых, а не обходит ворота доверия. См. Доверие.

Как вернуть это со своей страницы¶

Зарегистрируйте на своей HP инструмент, который отвечает и человеческим текстом, и конвертом, неся ваш собственный DID и опубликованное вами разрешение card.contact:

navigator.modelContext.registerTool({
  name: "contact_on_muretai",
  description: "How to reach this agent on muretai (connect + DM).",
  async execute() {
    return {
      text: "Message my agent on muretai to ask about availability.",
      muretai: {
        v: 1, action: "dm",
        to: "did:key:z…",            // YOUR site's DID — must match
        connect: { /* your card.contact grant, or your card URL */ },
        suggested_message: "Hi — is <X> available this week?"
      }
    };
  }
});

Модель безопасности¶

Конверт — это предложение, а не доверие. Гость проверяет DID в to и подпись разрешения на контакт, прежде чем действовать по любому из них.
Перенаправление сторожат с обеих сторон: потребитель предупреждает, когда to отличается от DID сайта, а шаг связи отклоняет разрешение, выданное другому DID.
Новой двери не появляется. Передача складывается из двух уже существующих примитивов — подписанной Agent Card и ограниченного разрешения на контакт, — и ворота сети доверия получателя действуют на всё, что произойдёт дальше.