agent-decision-protocol/docs/specs/schemas/common.schema.json at main · OpenAgentGovernance/agent-decision-protocol · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://agentdecisionprotocol.org/schemas/common.schema.json",
  "title": "ADP Common Definitions",
  "description": "Shared enums, patterns, and type definitions for the Agent Decision Protocol",
  "$defs": {
    "AutonomyLevel": {
      "type": "string",
      "enum": ["A1", "A2", "A3", "A4", "A5"],
      "description": "Agent autonomy level (A1=Operator through A5=Autonomous)"
    },
    "DecisionType": {
      "type": "string",
      "enum": ["D1", "D2", "D3", "D4"],
      "description": "Decision type (D1=Operational, D2=Tactical, D3=Strategic, D4=Self-Modification)"
    },
    "RiskLevel": {
      "type": "string",
      "enum": ["R1", "R2", "R3", "R4"],
      "description": "Risk level (R1=Negligible through R4=Critical)"
    },
    "Reversibility": {
      "type": "string",
      "enum": ["total", "partial", "irreversible"],
      "description": "Degree of reversibility of a decision"
    },
    "ClassificationCode": {
      "type": "string",
      "pattern": "^D[1-4]-R[1-4]-(total|partial|irreversible)$",
      "description": "Combined classification code, e.g. D2-R2-partial"
    },
    "EventType": {
      "type": "string",
      "enum": ["decision", "interaction", "self_modification", "escalation", "approval", "policy_violation", "anomaly"],
      "description": "Type of trace event"
    },
    "OutcomeStatus": {
      "type": "string",
      "enum": ["executed", "pending_approval", "rejected", "failed", "rolled_back", "blocked_pending_approval"],
      "description": "Status of a decision outcome"
    },
    "AgentStatus": {
      "type": "string",
      "enum": ["draft", "testing", "active", "suspended", "decommissioned"],
      "description": "Lifecycle status of an agent"
    },
    "MatrixResult": {
      "type": "string",
      "enum": ["authorized", "authorized_post_review", "authorized_monitoring", "approval_required", "prohibited"],
      "description": "Result from the authorization matrix lookup"
    },
    "PolicyCategory": {
      "type": "string",
      "enum": ["data_access", "communication", "financial", "self_modification", "inter_agent", "escalation", "compliance", "operational"],
      "description": "Category of a governance policy"
    },
    "Severity": {
      "type": "string",
      "enum": ["low", "medium", "high", "critical"],
      "description": "Severity level"
    },
    "Requirement": {
      "type": "string",
      "enum": ["human_approval", "log_with_reasoning", "notify_owner", "block", "rate_limit", "enhanced_monitoring", "dual_approval"],
      "description": "Required action when a policy matches"
    },
    "DataAccessLevel": {
      "type": "string",
      "enum": ["read", "write", "admin"],
      "description": "Level of data access granted"
    },
    "DataClassification": {
      "type": "string",
      "enum": ["public", "internal", "confidential", "restricted"],
      "description": "Sensitivity classification of data"
    },
    "EuAiActRiskClass": {
      "type": "string",
      "enum": ["minimal", "limited", "high", "unacceptable"],
      "description": "EU AI Act risk classification"
    },
    "TimeoutAction": {
      "type": "string",
      "enum": ["reject", "escalate", "escalate_and_alert"],
      "description": "Action to take when approval times out"
    },
    "TraceId": {
      "type": "string",
      "pattern": "^tr_[0-9]{8}_[0-9]{6}_[a-f0-9]{4}$",
      "description": "Unique trace event identifier, e.g. tr_20260220_143052_a7b3"
    },
    "PolicyId": {
      "type": "string",
      "pattern": "^POL-[A-Z]{2,5}-[0-9]{3}$",
      "description": "Unique policy identifier, e.g. POL-COM-001"
    },
    "AgentId": {
      "type": "string",
      "pattern": "^agent-[a-z0-9-]+$",
      "description": "Unique agent identifier, e.g. agent-billing-001"
    }
  }
}