interface SynapEvent {
  id: string;                // UUID
  version: 'v1';             // Schema version
  type: string;              // Event type (e.g., 'entity.created')
  subjectId?: string;      // Entity ID (optional)
  data: Record<string, unknown>;  // Event payload
  metadata?: Record<string, unknown>;  // Context (AI, import, sync)
  userId: string;            // Owner
  source: 'api' | 'automation' | 'sync' | 'migration' | 'system' | 'intelligence';
  timestamp: Date;
  correlationId?: string;    // Related events
  causationId?: string;      // Event that caused this
}

POST /trpc/events.log
{
  "type": "note.creation.requested",
  "data": {
    "content": "My note",
    "title": "Meeting Notes"
  }
}

POST /trpc/events.log
{
  "type": "entity.created",
  "subjectId": "entity-456",
  "source": "intelligence",
  "data": {
    "type": "task",
    "title": "Call John"
  },
  "metadata": {
    "ai": {
      "agent": "orchestrator",
      "confidence": { "score": 0.92 },
      "extraction": {
        "extractedFrom": {
          "messageId": "msg-123",
          "threadId": "thread-456"
        },
        "method": "explicit"
      }
    }
  }
}

GET /trpc/events.list
{
  "limit": 100,
  "offset": 0,
  "type": "entity.created"  // Optional filter
}

GET /trpc/events.list
{
  "limit": 100,
  "hasMetadata": true,  // Only events with metadata
  "source": "intelligence"  // Only AI-created
}

GET /trpc/events.get
{
  "eventId": "event-123"
}

{
  "id": "event-123",
  "type": "entity.created",
  "data": { "type": "task", "title": "Call John" },
  "metadata": {
    "ai": {
      "agent": "orchestrator",
      "confidence": { "score": 0.92 }
    }
  },
  "source": "intelligence",
  "timestamp": "2024-12-09T01:00:00Z"
}