SeenRelay

Многократно используемый прирост информации для ИИ-агентов.

Рабочая аналогия: Waze не отправляет специальный автомобиль для осмотра каждой дороги. Водители уже ездят, их наблюдения обновляют общее состояние трафика, и следующий водитель избегает повторного обнаружения тех же условий. SeenRelay применяет этот паттерн к фактам, подтверждённым источниками, которые используют ИИ-агенты.

Прежде чем перепроверять факт, спросите, не наблюдал ли его недавно другой агент. Если вы всё равно независимо проверяете источник, оставьте наблюдение для следующего агента.

Начните здесь

• Руководство по интеграции для людей: docs/QUICKSTART.md

• Проверенные интеграции с MCP-клиентами: docs/CLIENTS.md

• Пилот для лиц, принимающих решения, и критерии прекращения: docs/PILOT.md

• Веб-быстрый старт: https://seenrelay.com/quickstart

• Интеграции с веб-клиентами: https://seenrelay.com/clients

• Удалённая конечная точка MCP: https://seenrelay.com/mcp

• Идентификатор в реестре MCP: io.github.ovladon/seenrelay

• Контракт REST/OpenAPI: https://seenrelay.com/openapi.json

• Машинный дескриптор: https://seenrelay.com/service.json

• Машиноориентированный индекс: https://seenrelay.com/llms.txt

Рекомендуемое первое развёртывание — теневой режим: выполняйте CHECK перед существующей повторной проверкой, но изначально ничего не пропускайте. Измерьте, что SeenRelay сэкономил бы, прежде чем разрешать ограниченное повторное использование.

Related MCP server: agent-memory

Только две операции

• CHECK — сравнить значение, которое агент уже знает, с недавними наблюдениями того же детерминированного факта, подтверждённого источником.

• OBSERVE — внести значение, которое вызывающий агент независимо наблюдал в ходе своей собственной работы.

Статусы: SAME_OBSERVED, CHANGED_OBSERVED, CONTESTED, STALE, UNKNOWN.

SeenRelay сообщает наблюдения, а не универсальную истину.

Идентичность факта v3

SeenRelay использует версионированный контракт идентичности seenrelay-fact-v3 и никогда не использует LLM/нечёткий сопоставитель для определения того, что два факта идентичны.

Приоритет идентичности:

1. стабильный локатор, специфичный для источника (json_pointer, element_id, source_key);

2. канонический машинный предикат, когда локатор отсутствует.

Человекочитаемый текст subject никогда не входит в ключ факта. Изменяемое наблюдаемое содержимое никогда не входит в ключ факта. URL-адреса источников канонизируются без просмотра: удаляются фрагменты, нормализуются хосты/порты по умолчанию, отклоняются URL-адреса с учётными данными/подписями, удаляются известные параметры отслеживания, а остальные параметры запроса сортируются детерминированно.

См. docs/PROTOCOL.md для точного контракта.

Происхождение наблюдателя

OBSERVE поддерживает необязательное доказательство владения ed25519-v1, не зависящее от транспорта.

Действительное доказательство устанавливает владение ключом, непрерывность и целостность полезной нагрузки. Оно не доказывает, что один ключ равен одному независимому человеку/организации/устройству/агенту, и не решает проблему глобальной Sybil-идентичности. Поэтому SeenRelay разделяет криптографические и непроверенные счётчики ключей наблюдателей.

Hive Lease: без аккаунта, отложенное вознаграждение

Каждый вызывающий может получить подписанную эфемерную Hive Lease без создания аккаунта, входа, электронной почты или OAuth.

Во время начальной загрузки:

• CHECK бесплатен с щедрым ведром токенов;

• OBSERVE бесплатен;

• сырой OBSERVE не приносит баллов;

• балл вклада растёт только тогда, когда более поздний полезный CHECK поддерживается этим наблюдением, а потребитель принадлежит к другому консервативному сегменту сетевой независимости с солевой приватностью;

• изменение только самообъявленной метки клиента не создаёт независимости вознаграждения;

• повторное вознаграждение за один и тот же кортеж факт/значение/вкладчик/потребитель подавляется;

• полезные вкладчики получают больше ёмкости/пополнения CHECK.

Классы Hive (new, established, contributor) описывают только операционный вклад, а не реальную идентичность или истину.

Публичная поверхность

Канонический домен — seenrelay.com.

• Браузерный Accept: text/html на / получает целевую страницу для лиц, принимающих решения, и агентов с живыми агрегированными метриками.

• /quickstart даёт лицам, принимающим решения, и разработчикам самый короткий безопасный путь внедрения.

• /clients даёт готовую к копированию конфигурацию MCP-клиента.

• /robots.txt, /sitemap.xml и /llms.txt предоставляют ограниченные публичные метаданные для обнаружения.

• Общие/API-запросы к / сохраняют машиночитаемый дескриптор сервиса.

• /service.json явно предоставляет стабильный машинный дескриптор.

• /public-stats.json предоставляет безопасные для приватности агрегированные метрики сети.

• /openapi.json предоставляет REST-контракт.

• /mcp предоставляет MCP 2026-07-28.

Сайт предназначен для демонстрации измеренной полезности сети, а не синтетических заявлений о росте.

Он намеренно не

• просматривает и не ищет в вебе;

• проверяет факты по запросу;

• запускает LLM для определения истины;

• становится общей графом знаний;

• действует как общая память агентов;

• вызывает внешние исследовательские сервисы;

• утверждает, что наблюдение является сертифицированной истиной.

Если SeenRelay возвращает UNKNOWN, вызывающий продолжает ровно так, как он действовал бы без SeenRelay. Если вызывающий затем независимо наблюдает источник, он может вызвать OBSERVE.

Архитектура

• Vercel + Fluid Compute — управляемое развёртывание, TLS, масштабирование, журналы, контроль брандмауэра/расходов и откат.

• Neon Postgres — факты, недавние наблюдения, состояние Hive Lease, события полезного повторного использования и агрегированная телеметрия.

• Hono + TypeScript / Node 22 — компактный API на веб-стандартах.

• REST/OpenAPI — основная поверхность протокола.

• MCP 2026-07-28 — безсостоятельный доступ к инструментам с той же семантикой CHECK/OBSERVE.

• Control Room — аутентифицированное человеческое администрирование, живой Hive Radar, плейбуки инцидентов, позиция по стандартам, операционная готовность и поддержка передачи custody.

A2A 1.0.0 отслеживается, но намеренно не предоставляется. SeenRelay в настоящее время является сервисом инструментов/инфраструктуры, а не целеориентированным автономным агентом; публикация Agent Card без подлинной семантики задач A2A была бы вводящей в заблуждение.

Обнаружение и распространение

registry/server.json — канонический манифест реестра MCP для io.github.ovladon/seenrelay и указывает удалённым клиентам на https://seenrelay.com/mcp.

Репозиторий включает рабочий процесс публикации GitHub OIDC для официального реестра MCP. Он закрепляет бинарный файл издателя и проверяет его SHA-256 перед выполнением; в репозитории не хранится постоянных учётных данных реестра.

Ворота проверки

npm run check выполняет:

• базовую и полную проверку типов TypeScript в соответствии с правилами Node ESM;

• защитные ограничения продукта, включая отсутствие исходящего fetch для исследования фактов и поведение fail-closed при отключённом биллинге;

• аудит производственных зависимостей на уровне высокого/критического риска;

• структурные тесты;

• тесты идентичности/безопасности/экономики во время выполнения.

GitHub Preview E2E дополнительно проверяет:

• жизненный цикл REST CHECK/OBSERVE;

• квалифицированную экономику полезного повторного использования и консервативное анти-фермерское поведение;

• изоляцию идемпотентности;

• семантику CONTESTED и STALE;

• конвергенцию локаторов fact-v3;

• отклонение источников с учётными данными до допуска в Hive;

• границы администрирования/биллинга;

• MCP server/discover, tools/list, check_fact и observe_fact на ревизии 2026-07-28;

• семантику KPI: несколько наград вкладчикам от одного CHECK считаются как один квалифицированный CHECK повторного использования.

Сборки воспроизводимы с зафиксированным package-lock.json и npm ci.

Автопилот обслуживания

SeenRelay спроектирован так, чтобы замечать изменения экосистемы, не допуская несанкционированных изменений в производстве.

• Dependabot готовит изолированные PR на обновление зависимостей/действий GitHub.

• Standards Watch ежедневно проверяет официальные источники MCP, A2A и OpenTelemetry.

• Отклонение от стандартов создаёт/обновляет issue на GitHub.

• Семантические изменения протокола требуют изолированного кандидата на совместимость и полных ворот проверки.

• main никогда не автоматически сливается без явного одобрения.

См. docs/MAINTENANCE_AUTOPILOT.md.

Состояние биллинга

Биллинг недоступен в этом развёртывании:

PAYMENTS_ENABLED=false
PAYMENT_PROVIDER=none

Любая попытка включить биллинг завершается сбоем в закрытом режиме до обычной обработки запросов.

Контекст проекта

Перед изменением объёма продукта прочтите:

1. docs/PROJECT_CONTEXT.md

2. docs/DECISIONS.md

3. docs/WHY_NOT.md

4. docs/PROTOCOL.md

5. docs/MAINTENANCE_AUTOPILOT.md

6. docs/HANDOFF.md

Начальная загрузка

После подключения управляемой базы данных:

npm ci
npm run check
npm run db:migrate

Детали развёртывания находятся в docs/DEPLOYMENT.md.