{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "@context": [
    "https://schemas.meta-aiml.org/v3.0.0/context.jsonld"
  ],
  "@id": "https://schemas.meta-aiml.org/v3.0.0/entity/event.json",
  "$id": "https://schemas.meta-aiml.org/v3.0.0/entity/event.json",
  "@type": "Event",
  "schemaVersion": "3.0.0",
  "aimlVersion": "3.0.0",
  "title": "Event Entity Schema",
  "description": "v3 schema for time-bounded events delivered directly to participants, including registration, scheduling, venue coordination, and attendee engagement workflows.",
  "examples": [
    {
      "description": "Professional conference with ticketing, session agenda, and check-in",
      "reference": "event_example_conference"
    },
    {
      "description": "Hybrid workshop series with recurring sessions and digital materials",
      "reference": "event_example_hybrid_workshop"
    }
  ],
  "type": "object",
  "additionalProperties": false,
  "allOf": [
    {
      "$ref": "../ontology/event_entity.json"
    },
    {
      "$ref": "../archetypes/direct_service.json"
    }
  ],
  "properties": {
    "@type": {
      "const": "Event"
    },
    "ontologicalMode": {
      "const": "EventEntity"
    },
    "interactionArchetype": {
      "type": "array",
      "contains": {
        "const": "DirectService"
      },
      "items": {
        "type": "string",
        "enum": [
          "DirectService"
        ]
      }
    },
    "domain": {
      "const": "Events"
    },
    "businessModel": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "Ticketed",
          "Sponsorship",
          "Subscription",
          "Freemium"
        ]
      }
    },
    "deliveryFormat": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "InPersonAttendance",
          "VirtualStreaming",
          "HybridBoth"
        ]
      }
    },
    "name": {
      "$ref": "../components/multilingual_format.json#/$defs/LocalizedText"
    },
    "description": {
      "$ref": "../components/multilingual_format.json#/$defs/LocalizedText"
    },
    "shortDescription": {
      "$ref": "../components/multilingual_format.json#/$defs/LocalizedTextOrString"
    },
    "url": {
      "type": "string",
      "format": "uri"
    },
    "foundingDate": {
      "type": "string",
      "format": "date"
    },
    "eventDetails": {
      "type": "object",
      "required": [
        "startDate",
        "endDate",
        "eventType"
      ],
      "properties": {
        "startDate": {
          "type": "string",
          "format": "date-time"
        },
        "endDate": {
          "type": "string",
          "format": "date-time"
        },
        "eventType": {
          "type": "string",
          "enum": [
            "physical",
            "virtual",
            "hybrid"
          ]
        },
        "timezone": {
          "type": "string"
        },
        "recurrencePattern": {
          "type": "string",
          "enum": [
            "one_time",
            "recurring"
          ]
        }
      }
    },
    "properties": {
      "type": "object",
      "properties": {
        "eventCategory": {
          "type": "string",
          "enum": [
            "conference",
            "workshop",
            "webinar",
            "concert",
            "meetup",
            "sports"
          ]
        },
        "audienceScale": {
          "type": "string",
          "enum": [
            "small",
            "medium",
            "large",
            "very_large"
          ]
        },
        "requiresRegistration": {
          "type": "boolean"
        },
        "supportsWaitlist": {
          "type": "boolean"
        },
        "supportsTicketTransfer": {
          "type": "boolean"
        },
        "contactPoints": {
          "type": "array",
          "items": {
            "$ref": "../components/common_defs.json#/$defs/ContactPoint"
          }
        },
        "socialProfiles": {
          "type": "array",
          "items": {
            "$ref": "../components/common_defs.json#/$defs/SocialProfile"
          }
        },
        "identifiers": {
          "type": "array",
          "items": {
            "$ref": "../components/common_defs.json#/$defs/Identifier"
          }
        }
      }
    },
    "capabilities": {
      "type": "object",
      "required": [
        "interaction"
      ],
      "properties": {
        "interaction": {
          "$ref": "../components/capability_groups.json#/$defs/InteractionCapabilities"
        },
        "booking": {
          "$ref": "../components/capability_groups.json#/$defs/BookingCapabilities"
        },
        "content": {
          "$ref": "../components/capability_groups.json#/$defs/ContentCapabilities"
        },
        "financial": {
          "$ref": "../components/capability_groups.json#/$defs/FinancialCapabilities"
        },
        "community": {
          "$ref": "../components/capability_groups.json#/$defs/CommunityCapabilities"
        }
      }
    },
    "modules": {
      "type": "object",
      "properties": {
        "registration": {
          "type": "object",
          "properties": {
            "registrationOpenDate": {
              "type": "string",
              "format": "date-time"
            },
            "registrationCloseDate": {
              "type": "string",
              "format": "date-time"
            },
            "approvalWorkflowEnabled": {
              "type": "boolean"
            }
          }
        },
        "agenda": {
          "type": "object",
          "properties": {
            "multiTrackEnabled": {
              "type": "boolean"
            },
            "sessionCapacityControlEnabled": {
              "type": "boolean"
            },
            "speakerManagementEnabled": {
              "type": "boolean"
            }
          }
        },
        "venue": {
          "type": "object",
          "properties": {
            "physicalAddress": {
              "$ref": "../components/address_format.json#/$defs/PostalAddress"
            },
            "geoCoordinates": {
              "$ref": "../components/address_format.json#/$defs/GeoCoordinates"
            },
            "virtualVenueUrl": {
              "type": "string",
              "format": "uri"
            }
          }
        }
      }
    },
    "structuralMetadata": {
      "type": "object",
      "properties": {
        "topology": {
          "const": "binary"
        },
        "roles": {
          "const": [
            "user",
            "platform"
          ]
        },
        "valueSource": {
          "const": "platform_provided"
        },
        "transactionFlow": {
          "const": "direct"
        },
        "networkEffects": {
          "const": "none"
        },
        "temporalBounded": {
          "const": "yes"
        }
      }
    },
    "targetAudience": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "siteCapabilities": {
      "type": "object",
      "properties": {
        "supportedDevices": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "desktop",
              "mobile",
              "tablet"
            ]
          }
        },
        "languages": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "accessibilityFeatures": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      }
    }
  },
  "required": [
    "@type",
    "ontologicalMode",
    "interactionArchetype",
    "domain",
    "name",
    "description",
    "deliveryFormat",
    "eventDetails",
    "capabilities",
    "structuralMetadata",
    "modules"
  ],
  "validationMetadata": {
    "schemaVersion": "3.0.0",
    "phase": "entity",
    "status": "draft",
    "lastValidated": "2026-02-20T12:00:00Z",
    "validator": "META-AIML QA"
  },
  "semanticAnnotations": {
    "classificationRationale": "Event is modeled as EventEntity + DirectService because the platform directly delivers bounded temporal experiences to participants.",
    "disambiguationNotes": "Different from event listing aggregators that mediate discovery but do not deliver first-party event operations."
  },
  "governanceMetadata": {
    "entityVersion": "3.0.0",
    "introducedIn": "META-AIML v3.0.0",
    "stabilityLevel": "draft",
    "sdkValidationRules": [
      "RULE-EVNT-001: @type MUST equal \"Event\"",
      "RULE-EVNT-002: ontologicalMode MUST equal \"EventEntity\"",
      "RULE-EVNT-003: interactionArchetype MUST contain \"DirectService\"",
      "RULE-EVNT-004: eventDetails.startDate, eventDetails.endDate, eventDetails.eventType MUST be present",
      "RULE-EVNT-005: capabilities.interaction MUST be present",
      "RULE-EVNT-006: structuralMetadata.temporalBounded MUST equal \"yes\""
    ]
  }
}