{"$id":"https://KATA.org/schemas/decision.json","$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":true,"description":"Conceptual schema for a KATA trust decision returned by POST /kata/evaluate. Reason codes include price-integrity labels. Status: Concept / Open Design \u2014 not production ready.","examples":[{"component_risks":{"action_risk":88,"behavior_risk":35,"delegation_risk":10,"identity_risk":12,"intent_risk":96,"transaction_risk":70},"decided_at":"2026-10-04T14:02:12Z","decision":"BLOCK","evaluation_id":"eval_8812","policy_violations":["MAX_AMOUNT_EXCEEDED"],"reasons":["ACTION_EXCEEDS_INTENT","DELEGATION_SCOPE_MISMATCH"],"required_action":"HUMAN_APPROVAL","risk_score":94}],"properties":{"component_risks":{"additionalProperties":{"maximum":100,"minimum":0,"type":"number"},"description":"Per-component risk contributions (0\u2013100).","properties":{"action_risk":{"type":"number"},"behavior_risk":{"type":"number"},"delegation_risk":{"type":"number"},"identity_risk":{"type":"number"},"intent_risk":{"type":"number"},"transaction_risk":{"type":"number"}},"type":"object"},"decided_at":{"description":"When the decision was made.","format":"date-time","type":"string"},"decision":{"description":"The KATA decision outcome.","enum":["ALLOW","ALLOW_WITH_MONITORING","STEP_UP","HUMAN_APPROVAL","BLOCK","REVOKE","QUARANTINE"],"type":"string"},"evaluation_id":{"description":"Unique identifier for this evaluation.","type":"string"},"policy_violations":{"description":"Which specific policies were triggered.","items":{"type":"string"},"type":"array"},"reasons":{"description":"Machine-readable reason codes explaining the decision. Draft codes include ACTION_EXCEEDS_INTENT, DELEGATION_SCOPE_MISMATCH, AMOUNT_ABOVE_INTENT_CEILING, NEW_PAYEE, UNUSUAL_AGENT_BEHAVIOR, CHARGE_EXCEEDS_QUOTE, CHARGE_EXCEEDS_LISTED, UNDISCLOSED_FEE, SERVICE_DOWNGRADE, RETRY_FARMING, and PRICE_DISCRIMINATION. The list is open. Codes are explainability labels for the seven-level decision, not a calibrated detector. See docs/risk-model.md.","items":{"type":"string"},"type":"array"},"remediation":{"additionalProperties":true,"description":"Steps required to remediate or proceed.","type":"object"},"required_action":{"description":"What must happen next for the action to proceed or be resolved.","enum":["NONE","RE_VERIFY","STEP_UP","HUMAN_APPROVAL","REVOKE_DELEGATION","QUARANTINE_AGENT"],"type":"string"},"risk_score":{"description":"Composed KATA risk score (0\u2013100). Never the sole basis of the decision \u2014 composition matters.","maximum":100,"minimum":0,"type":"number"}},"required":["evaluation_id","decision","risk_score","reasons","required_action","decided_at"],"title":"KATA Decision","type":"object"}