{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "GCOS Hybrid Cyber Copilot API Payload Schemas",
  "version": "1.2.0",
  "creator": "Dr. Dr David King Boison",
  "schemas": {
    "DiagnosticRequest": {
      "type": "object",
      "required": [
        "tenant_id",
        "organization",
        "authorization",
        "evaluation_level",
        "data_classification",
        "jurisdictions",
        "inputs"
      ],
      "properties": {
        "tenant_id": {
          "type": "string"
        },
        "organization": {
          "type": "object",
          "required": [
            "name",
            "type",
            "size"
          ],
          "properties": {
            "name": {
              "type": "string"
            },
            "type": {
              "enum": [
                "Government",
                "Bank",
                "Telecom",
                "Energy",
                "Port",
                "Health",
                "Education",
                "Other"
              ]
            },
            "size": {
              "enum": [
                "Small",
                "Medium",
                "Large",
                "National-scale"
              ]
            }
          }
        },
        "authorization": {
          "type": "object",
          "required": [
            "confirmed",
            "authorized_by"
          ],
          "properties": {
            "confirmed": {
              "type": "boolean"
            },
            "authorized_by": {
              "type": "string"
            },
            "scope_note": {
              "type": "string"
            }
          }
        },
        "evaluation_level": {
          "enum": [
            "Level A",
            "Level B",
            "Level C"
          ]
        },
        "data_classification": {
          "enum": [
            "PUBLIC",
            "INTERNAL",
            "CONFIDENTIAL",
            "RESTRICTED"
          ]
        },
        "jurisdictions": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "inputs": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "content": {
                "type": "string"
              },
              "evidence_id": {
                "type": "string"
              }
            }
          }
        },
        "prior_baseline_id": {
          "type": "string"
        },
        "reasoning_context": {
          "type": "object",
          "description": "Server-injected VPF Planetary Version runtime. Clients may view this metadata but cannot downgrade, bypass, or remove it.",
          "properties": {
            "framework": {
              "const": "Visionary Prompt Framework (VPF)"
            },
            "version_layer": {
              "const": "Planetary Version"
            },
            "execution_level": {
              "const": 1000000
            },
            "components_active": {
              "type": "array",
              "items": {
                "enum": [
                  "chambers",
                  "lenses",
                  "bolts",
                  "cognitive_validation_matrix",
                  "modes_sub_modes",
                  "agents",
                  "execution_levels"
                ]
              }
            },
            "chambers_used": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "lenses_used": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "bolts_enforced": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "cvm_status": {
              "enum": [
                "passed",
                "blocked",
                "partial"
              ]
            },
            "mode": {
              "enum": [
                "diagnostic",
                "learning",
                "exam",
                "governance",
                "integration",
                "monitoring"
              ]
            },
            "downgrade_allowed": {
              "const": false
            }
          },
          "required": [
            "framework",
            "version_layer",
            "execution_level",
            "components_active",
            "cvm_status",
            "mode",
            "downgrade_allowed"
          ]
        }
      }
    },
    "LearningRequest": {
      "type": "object",
      "required": [
        "learner_id",
        "message"
      ],
      "properties": {
        "learner_id": {
          "type": "string"
        },
        "message": {
          "type": "string"
        },
        "current_level": {
          "enum": [
            "UNKNOWN",
            "LEVEL_0",
            "LEVEL_1",
            "LEVEL_2",
            "LEVEL_3"
          ]
        },
        "learning_goal": {
          "type": "string"
        },
        "session_context": {
          "type": "object"
        },
        "reasoning_context": {
          "type": "object",
          "description": "Server-injected VPF Planetary Version runtime. Clients may view this metadata but cannot downgrade, bypass, or remove it.",
          "properties": {
            "framework": {
              "const": "Visionary Prompt Framework (VPF)"
            },
            "version_layer": {
              "const": "Planetary Version"
            },
            "execution_level": {
              "const": 1000000
            },
            "components_active": {
              "type": "array",
              "items": {
                "enum": [
                  "chambers",
                  "lenses",
                  "bolts",
                  "cognitive_validation_matrix",
                  "modes_sub_modes",
                  "agents",
                  "execution_levels"
                ]
              }
            },
            "chambers_used": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "lenses_used": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "bolts_enforced": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "cvm_status": {
              "enum": [
                "passed",
                "blocked",
                "partial"
              ]
            },
            "mode": {
              "enum": [
                "diagnostic",
                "learning",
                "exam",
                "governance",
                "integration",
                "monitoring"
              ]
            },
            "downgrade_allowed": {
              "const": false
            }
          },
          "required": [
            "framework",
            "version_layer",
            "execution_level",
            "components_active",
            "cvm_status",
            "mode",
            "downgrade_allowed"
          ]
        }
      }
    },
    "ExamRequest": {
      "type": "object",
      "required": [
        "learner_id",
        "level",
        "answer"
      ],
      "properties": {
        "learner_id": {
          "type": "string"
        },
        "level": {
          "enum": [
            "LEVEL_0",
            "LEVEL_1",
            "LEVEL_2",
            "LEVEL_3"
          ]
        },
        "question_id": {
          "type": "string"
        },
        "answer": {
          "type": "string"
        },
        "reasoning": {
          "type": "string"
        },
        "reasoning_context": {
          "type": "object",
          "description": "Server-injected VPF Planetary Version runtime. Clients may view this metadata but cannot downgrade, bypass, or remove it.",
          "properties": {
            "framework": {
              "const": "Visionary Prompt Framework (VPF)"
            },
            "version_layer": {
              "const": "Planetary Version"
            },
            "execution_level": {
              "const": 1000000
            },
            "components_active": {
              "type": "array",
              "items": {
                "enum": [
                  "chambers",
                  "lenses",
                  "bolts",
                  "cognitive_validation_matrix",
                  "modes_sub_modes",
                  "agents",
                  "execution_levels"
                ]
              }
            },
            "chambers_used": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "lenses_used": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "bolts_enforced": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "cvm_status": {
              "enum": [
                "passed",
                "blocked",
                "partial"
              ]
            },
            "mode": {
              "enum": [
                "diagnostic",
                "learning",
                "exam",
                "governance",
                "integration",
                "monitoring"
              ]
            },
            "downgrade_allowed": {
              "const": false
            }
          },
          "required": [
            "framework",
            "version_layer",
            "execution_level",
            "components_active",
            "cvm_status",
            "mode",
            "downgrade_allowed"
          ]
        }
      }
    },
    "CopilotResponse": {
      "type": "object",
      "properties": {
        "mode": {
          "enum": [
            "diagnostic",
            "learning",
            "exam",
            "scorecard",
            "recommendations"
          ]
        },
        "response_id": {
          "type": "string"
        },
        "confidence": {
          "enum": [
            "Low",
            "Medium",
            "High"
          ]
        },
        "content": {
          "type": "object"
        },
        "assumptions": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "limitations": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "audit": {
          "type": "object"
        },
        "reasoning_context": {
          "type": "object",
          "description": "VPF runtime declaration. If omitted by client, server must inject default VPF Execution Level 1,000,000.",
          "properties": {
            "framework": {
              "const": "Visionary Prompt Framework (VPF)"
            },
            "execution_level": {
              "const": 1000000
            },
            "governance_mode": {
              "enum": [
                "evidence_first",
                "learning_progression",
                "diagnostic_scoring",
                "exam_validation"
              ]
            }
          }
        },
        "reasoning_architecture": {
          "type": "object",
          "description": "Server-injected VPF Planetary Version runtime. Clients may view this metadata but cannot downgrade, bypass, or remove it.",
          "properties": {
            "framework": {
              "const": "Visionary Prompt Framework (VPF)"
            },
            "version_layer": {
              "const": "Planetary Version"
            },
            "execution_level": {
              "const": 1000000
            },
            "components_active": {
              "type": "array",
              "items": {
                "enum": [
                  "chambers",
                  "lenses",
                  "bolts",
                  "cognitive_validation_matrix",
                  "modes_sub_modes",
                  "agents",
                  "execution_levels"
                ]
              }
            },
            "chambers_used": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "lenses_used": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "bolts_enforced": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "cvm_status": {
              "enum": [
                "passed",
                "blocked",
                "partial"
              ]
            },
            "mode": {
              "enum": [
                "diagnostic",
                "learning",
                "exam",
                "governance",
                "integration",
                "monitoring"
              ]
            },
            "downgrade_allowed": {
              "const": false
            }
          },
          "required": [
            "framework",
            "version_layer",
            "execution_level",
            "components_active",
            "cvm_status",
            "mode",
            "downgrade_allowed"
          ]
        }
      },
      "required": [
        "mode",
        "response_id",
        "confidence",
        "content",
        "reasoning_architecture"
      ]
    }
  },
  "reasoning_architecture": {
    "framework": "Visionary Prompt Framework (VPF)",
    "version_layer": "Planetary Version",
    "execution_level": 1000000,
    "runtime_status": "mandatory_server_injected_governance_and_reasoning_kernel",
    "components": [
      "chambers",
      "lenses",
      "bolts",
      "cognitive_validation_matrix",
      "modes_sub_modes",
      "agents",
      "execution_levels"
    ],
    "downgrade_allowed": false,
    "applies_to": [
      "diagnostic",
      "learning",
      "exam",
      "scorecard",
      "recommendations",
      "health",
      "integration"
    ],
    "minimum_response_metadata": [
      "framework",
      "version_layer",
      "execution_level",
      "components_active",
      "chambers_used",
      "lenses_used",
      "bolts_enforced",
      "cvm_status",
      "guardrail_status"
    ]
  }
}