Contrato de decisión de autoridad v0.1

El contrato con el que un agente de IA pregunta qué tiene permitido hacer, y la forma de la respuesta que recibe: ALLOW, DENY, APPROVE o ESCALATE, con los marcos aplicables y un registro de prueba verificable.

El contrato de decisión es abierto. Impleméntelo, critíquelo, extiéndalo.

Publicado bajo licencia MIT. La licencia cubre solo los documentos de especificación: el servicio que los implementa no es de código abierto.

Documentos

• /spec/authority-decision-v0.1.schema.jsonJSON Schema (2020-12) de la solicitud y de la respuesta, incluido el registro de prueba.
• /spec/openapi.jsonOpenAPI 3.1 que cubre decide, verify y las claves publicadas.
• /spec/LICENSEMIT, limitada a los artefactos de especificación.

Inicio rápido

Sin clave de API, sin cuenta. Una sola solicitud:

curl -s https://structureclerk.ca/api/v1/authority/decide \
  -H "Content-Type: application/json" \
  -d '{
    "agent":   { "id": "financebot-01", "autonomy_level": 3 },
    "action":  { "type": "payment.execute", "amount": 12500,
                 "currency": "AED", "data_categories": ["personal","health"] },
    "context": { "jurisdictions": ["AE"], "sector": "health" }
  }'

La respuesta lleva un objeto evidence. Para comprobarlo por su cuenta, recalcule el hash, verifique la firma Ed25519 contra la clave publicada y confirme su posición en el registro:

curl -s https://structureclerk.ca/api/v1/authority/verify/EVD-<uuid>

Compromisos de diseño

• Las decisiones son consultivas. StructureClerk decide, su infraestructura aplica. Nada aquí bloquea a un agente.
• Los marcos se citan a nivel de marco, nunca con números de artículo inventados.
• Un tipo de acción desconocido escala en vez de adivinarse, y toda confianza por debajo de 0,90 pasa a revisión humana.
• Un perfil de organización solo puede aumentar la supervisión humana, nunca reducirla.
• Cada decisión se firma y se añade a un registro encadenado que un tercero puede reproducir.

Versiones

Esta es la v0.1: la forma aún puede cambiar. Los campos añadidos no romperán a los consumidores existentes, y todo cambio incompatible saldrá bajo una nueva ruta de versión. El motor indica qué conjunto de reglas produjo una decisión en rules_version.

Comentarios, desacuerdos e implementaciones competidoras son bienvenidos: info@structureclerk.ca