Appearance
HTTP contract — @zeus/http-contract
Fuente de verdad de rutas REST: manifiestos RouteEntry →
- OpenAPI (Redoc / Swagger)
- Proyección automática a resource / resource-template MCP (WP-U40)
- Middleware Express de validación + cobertura de rutas
js
import {
defineRoutes,
buildOpenApiDoc,
projectRoutesToMcp,
bindProjectedHttpReaders
} from '@zeus/http-contract';
const routes = defineRoutes([
{
id: 'corpora.get',
method: 'GET',
path: '/api/corpora/:corpusId',
summary: 'Corpus by id',
xMcpResource: 'firehose://corpus/{corpusId}'
}
]);
const { resources, templates } = projectRoutesToMcp(routes);- URI MCP:
xMcpResourcesi existe; si no,rest://…derivado del path OpenAPI. - Solo GET se proyecta como resource (mutations → tools quedan fuera de esta proyección).
- Catálogo legacy de payloads:
@zeus/http-contract/mcp-resources/spec/mcp-resources.md(schemas curados linea/firehose/solar).
Detalle: Resources MCP · OpenAPI. README: packages/engine/http-contract/README.md.