Interoperabilidade
QZX Result Contract v1: resultados que software pode validar
Um agente não deveria precisar adivinhar se uma frase significa sucesso parcial, erro ou dado útil. O Result Contract v1 define uma estrutura JSON pequena e verificável para resultados QZX e consumidores compatíveis.
O problema
Saída de terminal feita apenas para humanos costuma misturar dados, explicações e erros. Isso funciona visualmente, mas obriga automações a interpretar texto. Um contrato estruturado separa essas responsabilidades.
- Estado de sucesso explícito.
- Mensagem humana sem depender dela para a lógica.
- Dados estruturados para consumo programático.
- Erros e metadados representados de forma previsível.
Verificável por design
A especificação pública inclui JSON Schema e materiais de conformidade. Os perfis MCP mostram como structuredContent e outputSchema podem se relacionar com o mesmo objetivo sem afirmar que QZX seja um padrão industrial.
Adote o contrato sem adotar toda a CLI
O contrato é útil justamente se implementações independentes conseguirem validá-lo. Use a especificação, rode os validadores e reporte diferenças reproduzíveis.