activity-core/schemas/event-envelope.json

{
  "description": "Standard internal event envelope. All inbound events (NATS, webhook, cron)\nare normalised into this shape before processing.",
  "properties": {
    "id": {
      "description": "UUID v4 \u2014 stable unique ID for deduplication.",
      "title": "Id",
      "type": "string"
    },
    "type": {
      "description": "Dot-namespaced event type, e.g. 'org.repo.registered'.",
      "title": "Type",
      "type": "string"
    },
    "version": {
      "default": "1.0",
      "description": "Schema version string.",
      "title": "Version",
      "type": "string"
    },
    "timestamp": {
      "description": "When the event occurred (UTC).",
      "format": "date-time",
      "title": "Timestamp",
      "type": "string"
    },
    "publisher": {
      "description": "Originating service, e.g. 'the-custodian/state-hub'.",
      "title": "Publisher",
      "type": "string"
    },
    "attributes": {
      "additionalProperties": true,
      "description": "Event-specific attributes; structure varies by event type.",
      "title": "Attributes",
      "type": "object"
    }
  },
  "required": [
    "id",
    "type",
    "timestamp",
    "publisher"
  ],
  "title": "EventEnvelope",
  "type": "object"
}