BASIS/Schemas

JSON Schemas

Wire protocol schemas (JSON Schema Draft 2020-12)

Overview

BASIS defines JSON Schemas for all wire protocol messages. These schemas enable interoperability between different implementations and provide validation for API requests and responses.

Schema Version: JSON Schema Draft 2020-12

Available Schemas

intent-record.json

Structured action intent from INTENT layer

enforce-request.json

Request to ENFORCE layer for decision

enforce-response.json

Governance decision from ENFORCE layer

proof-record.json

Immutable audit record from PROOF layer

entity.json

Agent or user entity definition

trust-score-update.json

Trust score change event

error-response.json

Standardized error format

escalation.json

Human escalation request

IntentRecord Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://vorion.org/basis/schemas/v1/intent-record.json",
  "title": "IntentRecord",
  "description": "A structured representation of an agent's intended action",
  "type": "object",
  "required": ["intent_id", "entity_id", "timestamp", "raw_input",
               "capabilities_required", "risk_level"],
  "properties": {
    "intent_id": {
      "type": "string",
      "pattern": "^int_[a-zA-Z0-9]{12,}$",
      "description": "Unique identifier for this intent"
    },
    "entity_id": {
      "type": "string",
      "pattern": "^ent_[a-zA-Z0-9]{12,}$",
      "description": "Entity requesting the action"
    },
    "timestamp": {
      "type": "string",
      "format": "date-time",
      "description": "ISO 8601 timestamp"
    },
    "raw_input": {
      "type": "string",
      "maxLength": 10000,
      "description": "Original action request"
    },
    "capabilities_required": {
      "type": "array",
      "items": { "type": "string" },
      "minItems": 1,
      "description": "Capabilities needed for this action"
    },
    "risk_level": {
      "type": "string",
      "enum": ["LOW", "MEDIUM", "HIGH", "CRITICAL"]
    }
  }
}

EnforceResponse Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://vorion.org/basis/schemas/v1/enforce-response.json",
  "title": "EnforceResponse",
  "description": "Governance decision from the ENFORCE layer",
  "type": "object",
  "required": ["decision", "intent_id", "entity_id", "timestamp",
               "trust_score_at_decision", "trust_tier_at_decision"],
  "properties": {
    "decision": {
      "type": "string",
      "enum": ["ALLOW", "DENY", "ESCALATE", "DEGRADE"],
      "description": "The governance decision"
    },
    "intent_id": { "type": "string" },
    "entity_id": { "type": "string" },
    "timestamp": { "type": "string", "format": "date-time" },
    "trust_score_at_decision": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000
    },
    "trust_tier_at_decision": {
      "type": "string",
      "enum": ["sandbox", "provisional", "standard",
               "trusted", "certified", "autonomous"]
    },
    "denial_reason": {
      "type": ["string", "null"],
      "description": "Required if decision is DENY"
    },
    "escalation_target": {
      "type": ["object", "null"],
      "description": "Required if decision is ESCALATE"
    }
  }
}

ProofRecord Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://vorion.org/basis/schemas/v1/proof-record.json",
  "title": "ProofRecord",
  "description": "Immutable audit record from the PROOF layer",
  "type": "object",
  "required": ["proof_id", "timestamp", "intent_id", "entity_id",
               "decision", "payload_hash", "chain_hash"],
  "properties": {
    "proof_id": {
      "type": "string",
      "pattern": "^prf_[a-zA-Z0-9]{12,}$"
    },
    "previous_proof_id": {
      "type": ["string", "null"],
      "description": "Null only for genesis proof"
    },
    "timestamp": { "type": "string", "format": "date-time" },
    "payload_hash": {
      "type": "string",
      "pattern": "^sha256:[a-f0-9]{64}$"
    },
    "chain_hash": {
      "type": "string",
      "pattern": "^sha256:[a-f0-9]{64}$"
    },
    "signature": {
      "type": "object",
      "properties": {
        "algorithm": { "type": "string" },
        "value": { "type": "string" }
      }
    }
  }
}

For all schemas including validation rules and examples, see the complete JSON Schemas document on GitHub.

View All Schemas on GitHub