FRESH

Sepa si un agente de IA debe REUSE o REFETCH una URL antes de volver a recuperarla.

GitHubPrueba este MCPPatrocinado

Documentación

FRESH

Sepa si debe volver a obtener.

FRESH es inteligencia compartida de frescura de URL para agentes de IA. Antes de volver a obtener, re-extraer, re-renderizar o re-insertar una URL, pregunte si la versión vista anteriormente probablemente sigue siendo lo suficientemente fresca para reutilizarla.

URL base de producción: https://fresh-api-production-c783.up.railway.app

Endpoint MCP: https://fresh-api-production-c783.up.railway.app/mcp

FRESH devuelve una de tres decisiones:

  • REUSE — el conocimiento en caché probablemente sigue siendo lo suficientemente fresco
  • REFETCH — la URL probablemente esté lo suficientemente desactualizada como para justificar otra recuperación
  • UNKNOWN — la evidencia es insuficiente; FRESH prefiere la incertidumbre sobre la falsa confianza

Por qué existe FRESH

Una caché local sabe cuándo tú obtuviste algo por última vez. No sabe si el recurso externo cambió desde entonces, ni lo que otros llamadores observaron recientemente. FRESH construye un historial compartido y seguro para la privacidad de cambios de URL a partir de marcas de tiempo, ETags, valores Last-Modified y hashes de contenido.

REST

POST /v1/check

{"url":"https://example.com/docs/api","lastSeenAt":"2026-08-13T12:00:00Z","toleranceSeconds":3600}

POST /v1/observe

{"url":"https://example.com/docs/api","observedAt":"2026-08-13T13:00:00Z","etag":"abc123","lastModified":"Wed, 13 Aug 2026 12:45:00 GMT","contentHash":"sha256:..."}

No se requiere el contenido bruto de la página.

MCP

  • fresh_check — decide si recuperar una URL nuevamente
  • fresh_observe — reporta evidencia de frescura segura para la privacidad después de la recuperación

Privacidad

FRESH no necesita contenidos brutos de página, cookies, credenciales del sitio objetivo ni cargas útiles del cliente. Las claves de URL se almacenan como hashes unidireccionales con metadatos de observación agregados.

Verificación de extraños

Una invocación de herramienta central es evidencia de uso, no prueba automática de un extraño genuino. FRESH clasifica la actividad candidata como KNOWN_VALIDATOR, LIKELY_VALIDATOR, CONTROLLED_TEST, UNKNOWN_MACHINE, o CREDIBLE_REAL_USE. Solo CREDIBLE_REAL_USE avanza los hitos de extraños. Nuestro tráfico de aceptación/prueba de humo usa X-Tollbooth-Internal: 1 o X-Fresh-Internal: 1 para que no pueda ganar crédito de extraño.

Puerta de aceptación de producción

Cada despliegue de Railway ahora realiza comprobaciones internas en vivo contra el servicio en ejecución antes de que /health pueda devolver 200. La puerta ejercita REST, UNKNOWN, REUSE, REFETCH, recarga de observación persistente, inicialización de MCP, descubrimiento de herramientas MCP, MCP fresh_check, y verifica que la autoprueba controlada no aumente el recuento de extraños verificados.

Estado

v0.1.2 infraestructura de producción experimental. Prioridades: decisiones conservadoras, baja latencia, economía de menos de un centavo, aprendizaje compartido seguro para la privacidad, REST + MCP, observaciones duraderas y analíticas auditables de uso real.