SeenRelay

Ganancia de información reutilizable para agentes de IA.

Analogía de trabajo: Waze no envía un coche especial para inspeccionar cada carretera. Los conductores ya viajan, sus observaciones actualizan el estado compartido del tráfico, y el siguiente conductor evita redescubrir las mismas condiciones. SeenRelay aplica ese patrón a hechos respaldados por fuentes utilizados por agentes de IA.

Antes de volver a comprobar un hecho, pregúntate si otro agente lo ha observado recientemente. Si de todos modos compruebas la fuente de forma independiente, deja la observación para el siguiente agente.

Comienza aquí

• Guía de integración humana: docs/QUICKSTART.md

• Integraciones de clientes MCP verificadas: docs/CLIENTS.md

• Piloto para tomadores de decisiones y criterios de cancelación: docs/PILOT.md

• Inicio rápido web: https://seenrelay.com/quickstart

• Integraciones de clientes web: https://seenrelay.com/clients

• Endpoint remoto MCP: https://seenrelay.com/mcp

• Identificador del Registro MCP: io.github.ovladon/seenrelay

• Contrato REST/OpenAPI: https://seenrelay.com/openapi.json

• Descriptor de máquina: https://seenrelay.com/service.json

• Índice orientado a máquinas: https://seenrelay.com/llms.txt

El primer despliegue recomendado es el modo sombra: CHECK antes de la revalidación existente, pero inicialmente no omitas nada. Mide lo que SeenRelay habría ahorrado antes de permitir la reutilización acotada.

Related MCP server: Memory MCP

Solo dos operaciones

• CHECK — compara un valor que un agente ya conoce con observaciones recientes del mismo hecho determinista respaldado por una fuente.

• OBSERVE — contribuye con un valor que el llamante observó de forma independiente mientras hacía su propio trabajo.

Estados: SAME_OBSERVED, CHANGED_OBSERVED, CONTESTED, STALE, UNKNOWN.

SeenRelay informa observaciones, no la verdad universal.

Identidad de hechos v3

SeenRelay utiliza el contrato de identidad versionado seenrelay-fact-v3 y nunca utiliza un LLM/emparejador difuso para decidir que dos hechos son idénticos.

La precedencia de identidad es:

1. localizador estable nativo de la fuente (json_pointer, element_id, source_key);

2. predicado canónico de máquina cuando no existe localizador.

El texto subject legible por humanos nunca entra en la clave del hecho. El contenido mutable observado nunca entra en la clave del hecho. Las URL de las fuentes se canonizan sin navegación: se eliminan los fragmentos, se normalizan los puertos de host/predeterminados, se rechazan las URL con credenciales/firmas, se eliminan los parámetros de seguimiento conocidos y los parámetros de consulta restantes se ordenan de forma determinista.

Consulta docs/PROTOCOL.md para el contrato exacto.

Procedencia del observador

OBSERVE admite una prueba de posesión opcional e independiente del transporte ed25519-v1.

Una prueba válida establece la posesión de la clave, la continuidad y la integridad de la carga útil. No demuestra que una clave equivalga a una persona/organización/dispositivo/agente independiente y no resuelve la identidad Sybil global. Por lo tanto, SeenRelay separa los recuentos de claves de observador criptográficas y no verificadas.

Hive Lease: sin cuenta, recompensa diferida

Cada llamante puede recibir un Hive Lease efímero firmado sin creación de cuenta, inicio de sesión, correo electrónico ni OAuth.

Durante el arranque:

• CHECK es gratuito con un generoso depósito de tokens;

• OBSERVE es gratuito;

• OBSERVE en bruto no genera puntuación;

• la puntuación de contribución solo aumenta cuando un CHECK útil posterior se apoya en esa observación y el consumidor pertenece a un depósito diferente de independencia de red con sal de privacidad conservadora;

• cambiar solo una etiqueta de cliente autodeclarada no crea independencia de recompensa;

• se suprime la recompensa repetida para la misma tupla hecho/valor/contribuyente/consumidor;

• los contribuyentes útiles reciben más capacidad/recarga de CHECK.

Las clases de Hive (new, established, contributor) describen solo la contribución operativa, no la identidad o la verdad del mundo real.

Superficie pública

El dominio canónico es seenrelay.com.

• El navegador con Accept: text/html en / obtiene una página de aterrizaje para tomadores de decisiones/agentes con métricas agregadas en vivo.

• /quickstart ofrece a los tomadores de decisiones e implementadores la ruta de adopción segura más corta.

• /clients ofrece configuración de cliente MCP lista para copiar.

• /robots.txt, /sitemap.xml y /llms.txt exponen metadatos de descubrimiento público acotados.

• Las solicitudes genéricas/API a / conservan el descriptor de servicio legible por máquina.

• /service.json expone explícitamente el descriptor de máquina estable.

• /public-stats.json expone métricas agregadas de red seguras para la privacidad.

• /openapi.json expone el contrato REST.

• /mcp expone MCP 2026-07-28.

El sitio está diseñado para mostrar la utilidad medida de la red, no afirmaciones de crecimiento sintético.

Deliberadamente no

• navegar ni buscar en la web;

• verificar hechos bajo demanda;

• ejecutar un LLM para decidir la verdad;

• convertirse en un grafo de conocimiento general;

• actuar como memoria compartida de agentes;

• llamar a servicios de investigación externos;

• afirmar que una observación es verdad certificada.

Si SeenRelay devuelve UNKNOWN, el llamante continúa exactamente como lo habría hecho sin SeenRelay. Si el llamante observa entonces la fuente de forma independiente, puede llamar a OBSERVE.

Arquitectura

• Vercel + Fluid Compute — despliegue gestionado, TLS, escalado, registros, controles de firewall/gasto y reversión.

• Neon Postgres — hechos, observaciones recientes, estado de Hive Lease, eventos de reutilización útil y telemetría agregada.

• Hono + TypeScript / Node 22 — API compacta de estándares web.

• REST/OpenAPI — superficie del protocolo central.

• MCP 2026-07-28 — acceso a herramientas sin estado con la misma semántica CHECK/OBSERVE.

• Control Room — administración humana autenticada, Hive Radar en vivo, manuales de incidentes, postura de estándares, preparación operativa y soporte de transferencia de custodia.

A2A 1.0.0 se monitorea pero intencionalmente no se expone. SeenRelay es actualmente un servicio de herramienta/infraestructura, no un agente autónomo orientado a tareas; publicar una Agent Card sin semántica genuina de tareas A2A sería engañoso.

Descubrimiento y distribución

registry/server.json es el manifiesto canónico del Registro MCP para io.github.ovladon/seenrelay y apunta a los clientes remotos a https://seenrelay.com/mcp.

El repositorio incluye un flujo de trabajo de publicación OIDC de GitHub para el Registro MCP Oficial. Fija el binario del publicador y verifica su SHA-256 antes de la ejecución; no se almacena ninguna credencial persistente del Registro en el repositorio.

Puertas de verificación

npm run check realiza:

• verificación de tipos TypeScript central y completa bajo reglas de Node ESM;

• salvaguardas del producto, incluida la ausencia de fetch de investigación de hechos saliente y el comportamiento de fallo cerrado con facturación deshabilitada;

• auditoría de dependencias de producción en severidad alta/crítica;

• pruebas estructurales;

• pruebas de identidad/seguridad/economía en tiempo de ejecución.

La E2E de GitHub Preview además ejercita:

• ciclo de vida REST CHECK/OBSERVE;

• economía de reutilización útil calificada y comportamiento conservador anti-granja;

• aislamiento de idempotencia;

• semántica de CONTESTED y STALE;

• convergencia de localizadores fact-v3;

• rechazo de fuentes con credenciales antes de la admisión en Hive;

• límites de administración/facturación;

• MCP server/discover, tools/list, check_fact y observe_fact en la revisión 2026-07-28;

• semántica de KPI: múltiples premios de contribuyentes de un solo CHECK cuentan como un CHECK de reutilización calificada.

Las compilaciones son reproducibles con package-lock.json confirmado y npm ci.

Piloto automático de mantenimiento

SeenRelay está diseñado para detectar cambios en el ecosistema sin permitir mutaciones de producción desatendidas.

• Dependabot prepara PRs aislados de actualización de dependencias/acciones de GitHub.

• Standards Watch se ejecuta diariamente contra fuentes oficiales de MCP, A2A y OpenTelemetry.

• La deriva de estándares crea/actualiza un issue de GitHub.

• Los cambios semánticos de protocolo requieren un candidato de compatibilidad aislado y las puertas de verificación completas.

• main nunca se fusiona automáticamente sin aprobación explícita.

Consulta docs/MAINTENANCE_AUTOPILOT.md.

Estado de facturación

La facturación no está disponible en este despliegue:

PAYMENTS_ENABLED=false
PAYMENT_PROVIDER=none

Cualquier intento de habilitar la facturación falla de forma cerrada antes del manejo normal de solicitudes.

Contexto del proyecto

Antes de modificar el alcance del producto, lee:

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

Arranque

Una vez que la base de datos gestionada esté vinculada:

npm ci
npm run check
npm run db:migrate

Los detalles de despliegue están en docs/DEPLOYMENT.md.